authorgravatar for julius0216@outlook.comJulius Marminge <julius0216@outlook.com> 2026-03-02 11:05:33-08:00
committergravatar for jmarminge@gmail.comJulius Marminge <jmarminge@gmail.com> 2026-03-02 20:46:05-08:00
logc2aaa89b57ae07095bc337cb5d0a7837eee31f99
treed5ce8558bed346fbd35b71092bbd04d7cb45bc63
parentdde48e94141370c38166e20dde0cec3c347164d5

Document contracts and shared package responsibilities

- Clarify that `packages/contracts` is schema-only with no runtime logic - Add `packages/shared` as the home for shared runtime utilities and subpath exports

1 files changed, 2 insertions(+), 1 deletions(-)

AGENTS.md+2-1
...@@ -26,7 +26,8 @@ Long term maintainability is a core priority. If you add new functionality, firs...@@ -26,7 +26,8 @@ Long term maintainability is a core priority. If you add new functionality, firs
2626
27- `apps/server`: Node.js WebSocket server. Wraps Codex app-server (JSON-RPC over stdio), serves the React web app, and manages provider sessions.27- `apps/server`: Node.js WebSocket server. Wraps Codex app-server (JSON-RPC over stdio), serves the React web app, and manages provider sessions.
28- `apps/web`: React/Vite UI. Owns session UX, conversation/event rendering, and client-side state. Connects to the server via WebSocket.28- `apps/web`: React/Vite UI. Owns session UX, conversation/event rendering, and client-side state. Connects to the server via WebSocket.
29- `packages/contracts`: Shared effect/Schema schemas and TypeScript contracts for provider events, WebSocket protocol, and model/session types.29- `packages/contracts`: Shared effect/Schema schemas and TypeScript contracts for provider events, WebSocket protocol, and model/session types. Keep this package schema-only — no runtime logic.
30- `packages/shared`: Shared runtime utilities consumed by both server and web. Uses explicit subpath exports (e.g. `@t3tools/shared/git`) — no barrel index.
3031
31## Codex App Server (Important)32## Codex App Server (Important)
3233