How a5c-ai/babysitter works
Babysitter is a code-defined orchestration platform: a process is invoked through a CLI or harness, the SDK executes its tasks under policy and quality gates, pauses for human approval where required, and journals decisions for replay. The repository also contains related operator interfaces and the Kradle inference platform. The README documents the product workflow; source-index references and excerpts establish only the internal links shown. Several broader capabilities are documented but their implementation was not sampled, so those links are documented rather than inferred from filenames.
Main entry points: processContext.ts Process context · library Process definitions · createReplayEngine.ts Replay engine · main.ts Babysitter CLI
Components 20
Entry points
- Babysitter CLI
packages/babysitter-sdk/src/cli/main.ts - Harness adapters
packages/adapters - Genty runtime CLI
packages/genty/platform
Orchestration runtime
- Process context
packages/babysitter-sdk/src/runtime/processContext.ts - Task intrinsics
packages/babysitter-sdk/src/runtime/intrinsics/task.ts - Policy engine
packages/babysitter-sdk/src/runtime/policy/engine.ts - Runtime errors
packages/babysitter-sdk/src/runtime/exceptions.ts - Replay engine
packages/babysitter-sdk/src/runtime/replay/createReplayEngine.ts - Effect index
packages/babysitter-sdk/src/runtime/replay/effectIndex.ts - Run journal
packages/babysitter-sdk/src/storage/journal.ts
Process library
- Process definitions
library
Operator products
- Kanban backlog
packages/adapters/gateway/src/kanban/lib/services/backlog-query-service.ts - Run queries
packages/adapters/gateway/src/kanban/lib/services/run-query-service.ts - Kanban storage
packages/adapters/gateway/src/kanban/lib/services/kanban-storage.ts - Commander UI
apps/commander/src/App.tsx - Inference manager
packages/kradle/web/app/components/inference/inference-service-manager.jsx - Service cards
packages/kradle/web/app/components/inference/inference-service-list.jsx - Kradle resources
apps/commander/src/contracts/kradle-resources.ts
Other components
- Engineer
- AI harnesses
Connections 16
- Engineer → Babysitter CLI: invokes
- Engineer → AI harnesses: starts session
- Babysitter CLI → Process context: runs process
- AI harnesses → Harness adapters: uses adapter
- Harness adapters → Process definitions: runs same processes
- Genty runtime CLI → Process definitions: invokes process
- Process definitions → Process context: defines workflow
- Process context → Task intrinsics: dispatches effects
packages/babysitter-sdk/src/runtime/processContext.ts - Process context → Policy engine: checks policy
- Process context → Runtime errors: raises runtime errors
packages/babysitter-sdk/src/runtime/processContext.ts - Replay engine → Effect index: builds index
packages/babysitter-sdk/src/runtime/replay/createReplayEngine.ts - Replay engine → Run journal: loads events
packages/babysitter-sdk/src/runtime/replay/createReplayEngine.ts - Effect index → Run journal: loads journal
packages/babysitter-sdk/src/runtime/replay/effectIndex.ts - Kanban backlog → Kanban storage: reads and writes
packages/adapters/gateway/src/kanban/lib/services/backlog-query-service.ts - Run queries → Kanban backlog: queries backlog
packages/adapters/gateway/src/kanban/lib/services/backlog-query-service.ts - Inference manager → Service cards: renders cards
packages/kradle/web/app/components/inference/inference-service-manager.jsx