feat: replace OpenCodeClient with @opencode-ai/sdk

.gitignore

@@ -14,3 +14,4 @@ media/_debug/
 media/_test_output/
 
 /test-output.log
+/.conduit

.opencode-version

@@ -1 +1 @@
-1.3.0
+1.3.13

AGENTS.md

@@ -5,26 +5,28 @@ NEVER stash changes, you are interrupting other sessions and work.
 
 ## Purpose
 
-`conduit` is a web UI relay for OpenCode. It lets one long-lived relay daemon expose OpenCode sessions to browser clients across multiple projects.
+`conduit` is a web UI orchestrator for AI coding assistants. It lets one long-lived daemon expose sessions to browser clients across multiple projects. Provider adapters (OpenCode, Claude Agent SDK) are stateless execution engines that stream events into conduit's SQLite event store.
 
 ## Architecture At A Glance
 
 - `src/bin/cli.ts` is the thin CLI entrypoint; `src/bin/cli-core.ts` routes commands.
 - The CLI either runs a relay in-process with `foreground` or manages a long-lived `Daemon` over Unix socket IPC.
 - `src/lib/daemon/daemon.ts` owns process lifecycle, persisted config, the shared HTTP and IPC servers, project registration, and the OpenCode instance registry.
 - One daemon can host many projects. Each project gets its own relay stack mounted under `/p/<slug>`.
-- `src/lib/relay/relay-stack.ts` builds the per-project relay around `OpenCodeClient`, `SessionManager`, `SSEConsumer`, `WebSocketHandler`, caches, pollers, and PTY wiring.
+- `src/lib/relay/relay-stack.ts` builds the per-project relay around `OpenCodeClient`, `SessionManager`, `SSEConsumer`, `WebSocketHandler`, pollers, and PTY wiring.
 - `src/lib/server/*` handles the shared HTTP and WebSocket edge; `src/lib/handlers/*` dispatch browser messages into focused domain handlers.
-- OpenCode is the source of truth for sessions and messages. Relay-side caches are for responsiveness and recovery.
+- The SQLite event store is the source of truth for sessions and messages. Provider adapters are stateless execution engines that stream events into the store.
 
-Read `docs/agent-guide/architecture.md` before changing daemon behavior, routing, relay wiring, SSE flow, session flow, instance management, or PTY behavior.
+Read `docs/agent-guide/architecture.md` before changing daemon behavior, project routing, relay wiring, event store, projectors, provider adapters, session flow, instance management, or PTY behavior.
 
 ## Source Map
 
 - `src/bin/`: CLI entrypoints.
 - `src/lib/daemon/`: daemon lifecycle, IPC,  config persistence, projects.
 - `src/lib/server/`: HTTP and WebSocket server, router, static files, push.
-- `src/lib/relay/`: OpenCode event pipeline, caches, pollers, PTY upstream wiring.
+- `src/lib/relay/`: OpenCode event pipeline, pollers, PTY upstream wiring.
+- `src/lib/persistence/`: SQLite event store, projectors, migrations.
+- `src/lib/provider/`: Provider adapters (OpenCode, Claude SDK).
 - `src/lib/session/`: session orchestration and status polling.
 - `src/lib/instance/`: OpenCode instance management and client access.
 - `src/lib/handlers/`: browser message handlers.

biome.json

@@ -10,7 +10,8 @@
 			"!docs/**/*.html",
 			"!.opencode",
 			"!.conduit",
-			"!test/e2e/fixtures/recorded/*.json"
+			"!test/e2e/fixtures/recorded/*.json",
+			"!test/e2e/fixtures/subagent-snapshot.json"
 		]
 	},
 	"css": {

docs/agent-guide/architecture.md

@@ -1,6 +1,6 @@
 # Architecture Guide
 
-Use this guide before changing daemon behavior, project routing, relay wiring, SSE flow, session flow, instance management, or PTY behavior.
+Use this guide before changing daemon behavior, project routing, relay wiring, event store, projectors, provider adapters, session flow, instance management, or PTY behavior.
 
 ## Runtime Shape
 
@@ -22,7 +22,9 @@ Mermaid Diagram: docs/agent-guide/system-context-diagram.mermaid
 | CLI / control | `src/bin/*`, `src/lib/cli/*` | Operator-facing commands, setup, watcher, TLS helpers |
 | Daemon | `src/lib/daemon/*` | Process lifecycle, persisted state, IPC, project and instance registration |
 | HTTP / WS edge | `src/lib/server/*` | Shared HTTP server, auth gate, static assets, project route dispatch, WebSocket upgrades |
-| Project relay | `src/lib/relay/*` | OpenCode SSE consumption, event translation, message cache, pollers, PTY upstreams |
+| Project relay | `src/lib/relay/*` | OpenCode SSE consumption, event translation, pollers, PTY upstreams |
+| Persistence | `src/lib/persistence/*` | SQLite event store, projectors (sessions, messages, turns, providers, approvals, activities), migrations |
+| Provider adapters | `src/lib/provider/*` | Stateless execution engines (OpenCode, Claude Agent SDK) that stream events into the event store |
 | Session domain | `src/lib/session/*` | Active session tracking, history paging, status polling, client-to-session registry |
 | OpenCode instances | `src/lib/instance/*` | Managed and unmanaged OpenCode instances, health checks, URL resolution, spawn/stop |
 | Browser handlers | `src/lib/handlers/*` | Message-type dispatch into session, prompt, model, file, terminal, and instance actions |
@@ -38,16 +40,16 @@ Mermaid diagram: docs/agent-guide/per-project-relay-flow-diagram.mermaid
 
 | Boundary | Meaning |
 |---|---|
-| Relay composition | Each relay combines `OpenCodeClient`, `SessionManager`, `SSEConsumer`, event pipeline modules, `WebSocketHandler`, caches, pollers, PTY wiring, and permission/question bridges. |
-| Source of truth | Durable conversation state lives in OpenCode, not relay-owned storage. |
-| Relay-owned state | Per-project caches exist for responsiveness and recovery, not as the primary record. |
-| Daemon-owned state | The config directory holds socket and PID files, daemon config, recent projects, push settings, and caches. |
+| Relay composition | Each relay combines `OpenCodeClient`, `SessionManager`, `SSEConsumer`, event pipeline modules, `WebSocketHandler`, pollers, PTY wiring, and permission/question bridges. |
+| Source of truth | Durable conversation state lives in conduit's SQLite event store. Provider adapters are stateless execution engines that stream events into the store. |
+| Relay-owned state | The event store and its projections (sessions, messages, turns, providers, approvals, activities) are the primary record. Projectors maintain materialized views from the append-only event log. |
+| Daemon-owned state | The config directory holds socket and PID files, daemon config, recent projects, and push settings. |
 | Frontend delivery | Frontend assets are built separately with Vite and served as static files by the relay server. |
 
 ## Communication Flow
 
 | Flow | Path |
 |---|---|
 | Browser to relay | Browser loads the SPA over HTTP, `RequestRouter` serves auth/setup/health/info/themes/project routes, project WebSocket upgrades go to `WebSocketHandler`, and `src/lib/handlers/index.ts` dispatches incoming message types to session, instance, file, terminal, and bridge services. |
-| OpenCode to relay to browser | Each project relay connects upstream through `SSEConsumer`, pipeline modules translate events, caches and pollers update relay-side view state, and `WebSocketHandler` broadcasts normalized events to relevant clients or session viewers. |
-| CLI to daemon | Commands such as `status`, `stop`, `add_project`, and `set_pin` go over IPC; the daemon updates config and registries, mounts new relays on the shared HTTP and WebSocket surface, and rebroadcasts instance status changes. |
+| Provider to event store to browser | Provider adapters stream events into the SQLite event store. Projectors update materialized views (sessions, messages, turns). Pollers reconcile provider-side status. `WebSocketHandler` broadcasts normalized events to relevant clients or session viewers. |
+| CLI to daemon | Commands such as `status`, `stop`, `add_project`, and `set_pin` go over IPC; the daemon updates config and registries, mounts new relays on the shared HTTP and WebSocket surface, and rebroadcasts instance status changes. |

docs/agent-guide/per-project-relay-flow-diagram.mermaid

@@ -10,10 +10,12 @@ flowchart LR
     question bridges]
     relayCore[Event pipeline
     SSEConsumer
-    cache, pollers, PTY wiring]
-    client[OpenCodeClient]
-    opencode[OpenCode server
-    source of truth]
+    pollers, PTY wiring]
+    eventStore[SQLite event store
+    projectors]
+    provider[Provider adapter
+    stateless execution engine]
+    opencode[OpenCode server]
 
     browser <-->|WebSocket messages| ws
     ws --> handlers
@@ -22,5 +24,7 @@ flowchart LR
     sessions --> relayCore
     bridges --> relayCore
     relayCore --> ws
-    relayCore --> client
-    client <-->|REST, SSE, PTY upstream| opencode
+    relayCore --> provider
+    provider -->|stream events| eventStore
+    provider <-->|REST, SSE, PTY upstream| opencode
+    eventStore --> ws

docs/agent-guide/system-context-diagram.mermaid

@@ -10,6 +10,10 @@ flowchart LR
         src/lib/daemon/daemon.ts]
         server[Shared HTTP and WS edge
         src/lib/server/*]
+        persistence[SQLite event store
+        src/lib/persistence/*]
+        providers[Provider adapters
+        src/lib/provider/*]
 
         subgraph projects[Per-project mounts under /p/<slug>]
             relayA[Project Relay A]
@@ -19,14 +23,17 @@ flowchart LR
 
     opencode[OpenCode server]
     state[Daemon config dir
-    PID, socket, config, caches]
+    PID, socket, config, push settings]
 
     cli -->|foreground or IPC control| daemon
     browser -->|HTTP for SPA and APIs| server
     browser <-->|WebSocket messages| server
     daemon --> server
     server --> relayA
     server --> relayB
-    relayA <-->|REST, SSE, PTY upstream| opencode
-    relayB <-->|REST, SSE, PTY upstream| opencode
+    relayA --> providers
+    relayB --> providers
+    providers <-->|REST, SSE, PTY upstream| opencode
+    providers -->|stream events| persistence
+    persistence --> server
     daemon <--> state