Reference

Current Limits

Honest reference for implemented behavior, caveats, and schema-supported features that need executors.

This page exists so docs do not overpromise. The local runtime is durable and useful, but it is a recorded/transform replay engine, not a live causal simulator.

Runtime And Replay

AreaCurrent state
Recorded replaySupported. Base events are copied, branch interventions patch recorded events, fixtures can substitute divergent tool results.
Branch checkpoint boundsSupported. Targets at or before the branch checkpoint are reported and not patched.
Live model replaypinned-live and compatible-live are schema-supported, but local replay errors without an explicit model executor.
Live tool replaylive-readonly and live-explicit are schema-supported, but local replay errors without an explicit tool executor.
Downstream recomputationNot claimed. Without an executor, isplay cannot prove how a model would respond after a patched event.
Native framework replayAdapters capture evidence; replaying through framework execution requires runtime-specific support.

Jobs

AreaCurrent state
Replay wait=falseEnqueues a Graphile Worker job and records durable job events.
Experiment wait=falseEnqueues a Graphile Worker job and records durable job events.
isplay startStarts the API and local worker.
Job SSEReads stored job events from /v1/jobs/{id}/events.
Diff/metric/export jobsNot separately scheduled yet; replay execution writes current diffs and metrics.

Experiment Limits

AreaCurrent state
trialPlan.concurrencyParsed, but the current experiment runner is serial.
trialPlan.maxReplaysPresent in schema; runner mainly uses repetitions.
trialPlan.stopRuleParsed, not fully enforced.
arm-comparisonReturns trial matrix shaped data today.

Redaction Limits

Capture policy actions are implemented as capture, drop, hash, and mask.

ActionCurrent state
hashEmits [HASHED], not a digest.
maskEmits [REDACTED].
dropReplaces the field or matched subtree with null and increments dropped-field reporting.
encrypt, artifact_only, metadata_onlyNot capture policy actions in v0.3. Use explicit artifact/context metadata instead.

Storage Caveats

  • Event append is transactional, sequence-contiguous, and conflict-detecting.
  • Terminal runs reject later event appends.
  • Artifact reads verify the stored SHA and throw explicit missing/corrupt errors.
  • Local filesystem artifact storage is not a distributed object store; back it up and mount it durably in production.

Adapter Caveats

AdapterCaveat
Adapter kitRequires an explicit client or projectId; strength depends on where you wire it.
AI SDKv6 middleware is built for wrapLanguageModel; streams are finalized when consumed.
MastraExplicit helper adapter, not transparent Agent.generate middleware.
LangGraphTool events without matching starts become observed events.
CodexBuilt-in tool injection is not universally pre-execution. JSONL ingestion maps known item types only.
Claude CodeModel replay is unsupported; model capture is observability-oriented.
OpenClawNative synthetic fixture replay only works when the runtime honors before-tool synthetic outputs.

When describing a feature that is schema-supported but not executor-supported, say "modeled" or "schema-supported", not "available".

On this page