Memory
## Project: DocuClear Clearspace (docuclear_clearspace) ### What It Is A multi-workspace agentic assistant built from scratch, using patterns from IntelligentRAG, Spectron, kaig, surrealfs, and surrealql-language-server — but designed cleanly for the specific use case. ### Key Decisions (So Far) - Build from scratch (new repo) — not forking agentic-workspace or IntelligentRAG - Use IntelligentRAG patterns as inspiration, not as a dependency - Frontend: assistant-ui React components (evaluating) - Database: SurrealDB (graph + vector + document + KV in one) - Platform: Cloudflare Workers + Containers - Agent: Custom thread-level agent (not Think framework) - Knowledge: Graph-based with supersession, traces, hybrid search - Multi-workspace: namespace-per-workspace in SurrealDB ### Open Questions - How does assistant-ui connect to Cloudflare Workers backend? - Does assistant-ui support custom backends or only Vercel AI SDK? - What authentication model does assistant-ui use? - How to handle real-time updates (LIVE queries) in assistant-ui? - WebSocket vs HTTP streaming for assistant-ui? ### Status: Researching assistant-ui compatibility [Update 7/19/2026]: ## Updated: Open Questions Answered (July 19, 2026) ### Q: How does assistant-ui connect to Cloudflare Workers backend? **A:** Via `useAgent` from `agents/react` + `useAgentChat` from `@cloudflare/ai-chat/react` + `useAISDKRuntime` from `@assistant-ui/react-ai-sdk`. Two-process architecture: Worker (agent) + separate frontend app. ### Q: Does assistant-ui support custom backends or only Vercel AI SDK? **A:** Both. Uses `useAISDKRuntime` which wraps AI SDK's `useChat`. Also supports custom adapters via `ChatModelAdapter` or `RemoteThreadListRuntime`. ### Q: What authentication model does assistant-ui use? **A:** Via Worker's fetch handler. Add JWT/header check before `routeAgentRequest`. Pass credentials via `useAgent`'s `headers` or `query` options. ### Q: How to handle real-time updates (LIVE queries) in assistant-ui? **A:** WebSocket via CF Agents SDK. `useAgentChat` handles streaming and state sync automatically. ### Q: WebSocket vs HTTP streaming for assistant-ui? **A:** WebSocket (via CF Agents SDK). `useAgentChat` wraps WebSocket and exposes same API as `useChat`. ### Current Architecture - **Phase 0:** CF Agents SDK + DO SQLite + Workers AI + assistant-ui Base template - **Phase 1:** Add SurrealDB, MCP, SurrealQL tools, knowledge graph, workflows - **Phase 2:** Document ingestion (Xberg/Kreuzberg), graph construction - **Phase 3:** Multi-data canvas (graph view, table view, workflow view) ### Status: All open questions answered, ready to implement Phase 0
Tags: design, architecture, project-start, project:docuclear_clearspace, kind:semantic — Source: claude — 2026-07-18 19:29:07 UTC