apunkt/rowboat
1
0
Fork 0
mirror of https://github.com/rowboatlabs/rowboat.git synced 2026-07-12 21:02:17 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs(x): design docs and prompt catalogs follow the runtime/ move

Browse source 
Path pass over turn-runtime-design.md, session-design.md,
VIDEO_MODE.md, and LIVE_NOTE.md: every source pointer updated to the
runtime/ layout, the turn doc's suggested-module-layout section (§28)
refreshed to the real tree (it predated the event hub, bridges, and
composer), and the session doc's §14 layout fixed including its old
§11/§14 contradiction about where the headless runner lives.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Ramnique Singh 2026-07-10 11:52:40 +05:30
parent 5f4788cf56
commit a3d2ddf34c
4 changed files with 34 additions and 30 deletions
Download patch file Download diff file Expand all files Collapse all files

13
apps/x/packages/core/docs/session-design.md
View file

@ -520,16 +520,21 @@ All tests use the in-memory/mocked turn runtime and repo fakes.
## 14. Suggested module layout
```text
apps/x/packages/shared/src/sessions.ts # event schemas, reducer, index types
apps/x/packages/shared/src/sessions.ts # event schemas, reducer, index types
apps/x/packages/core/src/sessions/
apps/x/packages/core/src/runtime/sessions/
sessions.ts # ISessions implementation
api.ts # public contract
repo.ts # ISessionRepo contract
fs-repo.ts # filesystem implementation
index.ts # in-memory index + startup scan
headless.ts # runHeadlessTurn
session-index.ts # in-memory index
bus.ts # index-changed fan-out
```
The headless helper of §11 is implemented as `HeadlessAgentRunner` in
`runtime/assembly/headless.ts` (not under `sessions/`).
Awilix registration mirrors the turn runtime: singleton scope, PROXY
constructor injection, no container resolution from inside the classes.

27
apps/x/packages/core/docs/turn-runtime-design.md
View file

@ -1888,21 +1888,20 @@ tests for:
This is a suggested organization, not a locked implementation requirement:
```text
apps/x/packages/shared/src/turns.ts
apps/x/packages/shared/src/turns.ts # durable schemas + reducer (unchanged home)
apps/x/packages/core/src/turns/
runtime.ts
reducer.ts # if implementation is re-exported through shared,
# locate pure code to avoid dependency cycles
repo.ts
fs-repo.ts
stream.ts
agent-resolver.ts
context-resolver.ts
model-registry.ts
tool-registry.ts
permission.ts
index.ts
apps/x/packages/core/src/runtime/
turns/ # the engine: runtime.ts, stream, event-hub, context
# resolution/elision, request composer, repos, inspect-cli
bridges/ # real implementations of the engine's seams (agent/tool/
# model resolvers, permission checker/classifier)
sessions/ # session layer (session-design.md)
assembly/ # what an agent is: registry, compose-instructions,
# workspace-context, message-encoding, permission-metadata,
# headless runners, spawn-agent, copilot/, capabilities/,
# skills/
tools/ # builtin-tool catalog + domain modules + exec plumbing
legacy/ # the dying runs engine (engine.ts + runs.ts + repos)
```
The final reducer location must permit both core and renderer to use exactly the