@codeam/shared

v2.60.53

Published

CodeAgent Mobile wire-protocol contract: chunk-protocol renderer, RemoteCommand envelope, SSE event names, model pricing tables, and cross-repo wire types shared by codeam-cli, the VS Code extension, and the backend.

Readme

@codeam/shared

The wire-protocol contract for CodeAgent Mobile — the shapes, constants, and pure renderers every surface that crosses a process boundary (CLI ⇄ backend ⇄ mobile/web) must agree on byte-for-byte.

What's inside

  • protocol/renderToLines — virtual terminal that turns raw PTY bytes into clean screen lines (CSI cursor moves, erase, alternate-screen, CR/LF quirks).
  • protocol/remote-command — the RemoteCommand envelope (zod schema + toRemoteCommand() validator) used by the SSE commands stream and the /api/commands/pending polling fallback.
  • protocol/constants — wire constants (PROTOCOL_VERSION, SSE timeouts, ports, heartbeat intervals).
  • protocol/chrome-types — protocol-level shapes for TUI chrome steps and interactive selectors.
  • models/pricing — Anthropic model pricing and context-window tables with lookup helpers.
  • agents/ — agent id types and registry shared by the clients.
  • types/ — cross-repo wire types (preview, beads, headroom, streaming, file-change) and types/events (USER_EVENTS, the canonical map of per-user SSE event names).

Consumers

  • codeam-cli and the VS Code / Cursor / Windsurf extension bundle this package's source at build time (workspace dep).
  • The CodeAgent Mobile backend and apps consume the published package from npm.

Dual CJS + ESM with bundled type declarations. zod is the only runtime dependency.

Versioning

Versions in lockstep with the unified client release line: a vX.Y.Z tag in codeagent-mobile-clients publishes @codeam/[email protected] alongside the CLI and IDE plugins.

License

MIT