Operator Snapshot
POST /v1/operator/snapshot
Create an operator snapshot for a run.
Snapshots combine guide context, decision trace, feedback, measurement, and execution state into a compact operator-facing view.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
tenant_id | string | No | Tenant boundary. |
scope | string | No | Project or workspace boundary. |
run_id | string | Recommended | Execution run identifier. |
task_signature | string | No | Stable task identity. |
agent_context | object | No | Agent context returned by guide. |
guide_packet | object | No | Guide packet returned by Runtime. |
memory_decision_trace | object | No | Decision trace from guide or measure. |
memory_decision_audit | object | No | Compact decision audit. |
effect_report | object | No | Report returned by /v1/measure. |
execution_context | object | No | Execution state or workflow projection. |
guide_trace_id | string | No | Guide trace connected to the snapshot. |
include_markdown | boolean | No | Include a markdown snapshot body. |
Example
curl -s http://127.0.0.1:3001/v1/operator/snapshot \
-H 'content-type: application/json' \
-d '{
"tenant_id": "default",
"scope": "checkout-migration",
"run_id": "run-001",
"task_signature": "checkout-migration",
"guide_trace_id": "guide_trace:abc",
"agent_context": {},
"memory_decision_trace": {},
"effect_report": {},
"include_markdown": true
}'SDK
const snapshot = await aionis.operatorSnapshot({
run_id: "run-001",
task_signature: "checkout-migration",
guide_trace_id: guide.guide_trace_id,
agent_context: guide.agent_context,
effect_report: measure.effect_report,
include_markdown: true,
});Response
Important fields:
| Field | Meaning |
|---|---|
contract_version | aionis_operator_snapshot_result_v1. |
operator_snapshot | Structured snapshot for the run. |
markdown | Markdown body when include_markdown is true. |
source_map | Inputs and Runtime surfaces used to assemble the snapshot. |