@shumkov/orchestra

The transport-agnostic agent session engine for Claude Code and the native Codex app-server. It spawns provider sessions, injects or steers messages, observes turns, supervises lifecycle, and recovers independently of which chat network the messages came from.

Extracted from polygram after water proved the copy works end-to-end against a real Claude. Shared by polygram (Telegram) and water (WhatsApp); each keeps its own transport, persistence, gate, and delivery.

See docs/EXTRACTION.md for the API and the extraction design.

Use

const {
  CodexAppServerClient,
  CodexProcess,
  ProcessManager,
  createProcessFactory,
  createTmuxRunner,
  claudeBin,
} = require('@shumkov/orchestra');
// inject your transport delivery (toolDispatcher), surface hint (displayHint),
// and file cap (maxOutboundFileBytes); the engine stays chat-network-agnostic.

Licence

MIT.