FEATURES

Sessions & adapters.

Instrument an entire agent run — steps, state, forks, resume — and plug Actae into the frameworks you already use.

AgentSession

AgentSession is the high-level wrapper around Actae's primitives for multi-step agent runs. It owns the lifecycle — created → started → stepping → completed/crashed — and makes steps, state, forks, and resume one coherent API.

  • step(type, payload) records the step event and snapshots state (optionally every N steps via snapshot_interval, from a sync or async state_fn).
  • Steps carry deterministic operation IDs (UUIDv5 over scope/type/channel/step number/canonical content). A crash-recovery re-drive of the same step replays; changed content records anew. No duplicate events, no lost steps.
  • fork(fork_at_step=N) creates a branch that continues at step N+1 with steps 1..N's state inherited — the fork event log starts with branch.started and the steps after N.
  • resume() does crash recovery (re-attach, continue from the last step) or fork-from-existing; resuming a completed run raises SessionCompletedError.

Fork at step N, don't re-run 1..N

The flagship workflow: fork at the failing step, refine only that step, and measure the savings. The SDK's fork-resume primes inherited state and the step count so the continuation is byte-identical to a full re-run — verified by the LLM-judged fidelity suite.

StateManager

Framework-agnostic versioned state with the cursor handling hidden: save, load, resume, fork, list, get, delete. The thin layer between raw save_state and full AgentSession.

Framework adapters

Adapters plug Actae into the frameworks your agents already use. In the TypeScript SDK they live behind subpath exports and import their frameworks lazily — the core SDK carries no framework dependency.

FrameworkAdapterWhat it does
LangGraphActaeCheckpointSaverImplements the checkpoint-saver protocol (put/getTuple/list/deleteThread/forkThread) backed by Actae state; verified against real StateGraphs
LangChainActaeContextSaver + ChainResumerSaves full chain context every N callbacks; restarts chains with inherited context
Claude Agent SDKActaeClaudeSessionStore + ActaeClaudeHookFull SessionStore protocol (append/load/list/cascade delete) + event forwarding
OpenAI AgentsActaeTracingProcessorReal TracingProcessor capturing spans, PII-stripped; fork_trace copies a run's snapshot for comparison
CrewAIActaeCrewStateHook + CrewAIResumerState hook + resumer that inherits completed tasks verbatim (no crewai import needed)
GitHub Copilotactae/copilot (Go), CopilotManager (TS)Records every Copilot session event with dedup, backfill, and fork-at-event
Codex CLICodexOTLPReceiver (TS)Mirrors Codex codex.* events into per-conversation channels with token/tool snapshots

All adapters are tested against their real SDKs, not mocks. See the Python, Go, and TypeScript SDK pages for adapter imports per language.