diff options
| author | Adam Malczewski <[email protected]> | 2026-06-06 23:43:43 +0900 |
|---|---|---|
| committer | Adam Malczewski <[email protected]> | 2026-06-06 23:43:43 +0900 |
| commit | fac44794432928d0341728642fd70eef87837da4 (patch) | |
| tree | 53445547f98bf5e798966efb339ce67cd8ebd20b /.dispatch/package-agent.md | |
| parent | f1409cd46d5a3cfb9002cbcdfd4ab947ac6846aa (diff) | |
| download | dispatch-web-fac44794432928d0341728642fd70eef87837da4.tar.gz dispatch-web-fac44794432928d0341728642fd70eef87837da4.zip | |
Slice 2 unblock: pin wire + transport-contract; mirror contracts
- pin @dispatch/wire + @dispatch/transport-contract (+ ui-contract) as file:
deps @0.1.0; overrides{} workaround for their workspace:* deps (bun can't
resolve workspace: from outside the monorepo)
- add fake-indexeddb (dev) for the upcoming IndexedDB adapter tests
- mirror wire + transport-contract into .dispatch/*.reference.md for headless
agents; point package-agent.md at all three references
- backend-handoff.md: convert to a living FE<->backend seam doc
Verified green: svelte-check 0/0, vitest 91, biome clean, build ok; contract
import smoke-test passes.
Diffstat (limited to '.dispatch/package-agent.md')
| -rw-r--r-- | .dispatch/package-agent.md | 17 |
1 files changed, 12 insertions, 5 deletions
diff --git a/.dispatch/package-agent.md b/.dispatch/package-agent.md index a5666e4..c98b326 100644 --- a/.dispatch/package-agent.md +++ b/.dispatch/package-agent.md @@ -23,11 +23,18 @@ it, test it, and write a report — nothing else. If no single unit is named, st ## What you may read (visibility) - **Your own unit:** every file, freely. -- **The contract you consume:** reproduced IN-REPO at - `.dispatch/ui-contract.reference.md` — read THAT. Your code imports - `@dispatch/ui-contract` normally, but **do NOT read `node_modules/@dispatch/*`** — it - symlinks to the backend repo (OUTSIDE this repo) and a headless permission prompt will - HANG the run (see "Headless read boundary"). +- **The contracts you consume:** reproduced IN-REPO under `.dispatch/*.reference.md` — read THOSE: + - `.dispatch/ui-contract.reference.md` — `@dispatch/ui-contract` (surfaces + surface WS protocol). + - `.dispatch/wire.reference.md` — `@dispatch/wire` (`Chunk`/`StoredChunk`+`seq`/`ChatMessage`/ + `AgentEvent`/`TurnSealedEvent`/`Usage` — the chat wire types). + - `.dispatch/transport-contract.reference.md` — `@dispatch/transport-contract` (HTTP endpoints + + `ChatRequest`/`ModelsResponse`/`ConversationHistoryResponse` + WS chat ops + the unified + `WsClientMessage`/`WsServerMessage` unions). + + Your code imports `@dispatch/ui-contract` / `@dispatch/wire` / `@dispatch/transport-contract` + normally, but **do NOT read `node_modules/@dispatch/*`** — they symlink to the backend repo + (OUTSIDE this repo) and a headless permission prompt will HANG the run (see "Headless read + boundary"). - **Sibling units — PUBLIC SURFACE only:** their `index.ts` exports. Don't read their internals (needing them ⇒ the contract is incomplete → report a CR). |