@runfile-ai/schemas 0.1.2 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -26,28 +26,32 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
26
26
  schema_version: z.ZodString;
27
27
  event_id: z.ZodString;
28
28
  tenant_id: z.ZodString;
29
- agent_run_id: z.ZodString;
29
+ run_id: z.ZodString;
30
30
  parent_event_id: z.ZodNullable<z.ZodString>;
31
+ parallel_group_id: z.ZodOptional<z.ZodString>;
31
32
  captured_at: z.ZodString;
32
33
  received_at: z.ZodString;
33
34
  wall_clock_source: z.ZodEnum<["aws_time_sync", "ntp", "host_system", "unknown"]>;
34
35
  sdk: z.ZodObject<{
35
36
  name: z.ZodEnum<["runfile-py", "@runfile/sdk"]>;
36
37
  version: z.ZodString;
37
- framework: z.ZodEnum<["langgraph", "langgraph_js", "openai_agents", "openai_agents_js", "anthropic_claude", "anthropic_claude_js", "mastra", "vercel_ai_sdk", "mcp_client", "otel_generic", "manual"]>;
38
+ framework: z.ZodEnum<["langgraph", "langgraph_js", "openai_agents", "openai_agents_js", "anthropic_claude", "anthropic_claude_js", "claude_agent_sdk", "mastra", "vercel_ai_sdk", "pydantic_ai", "crewai", "mcp_client", "otel_generic", "manual"]>;
38
39
  framework_version: z.ZodOptional<z.ZodString>;
40
+ adapter: z.ZodOptional<z.ZodString>;
39
41
  host: z.ZodOptional<z.ZodString>;
40
42
  }, "strict", z.ZodTypeAny, {
41
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
43
+ framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
42
44
  name: "runfile-py" | "@runfile/sdk";
43
45
  version: string;
44
46
  framework_version?: string | undefined;
47
+ adapter?: string | undefined;
45
48
  host?: string | undefined;
46
49
  }, {
47
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
50
+ framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
48
51
  name: "runfile-py" | "@runfile/sdk";
49
52
  version: string;
50
53
  framework_version?: string | undefined;
54
+ adapter?: string | undefined;
51
55
  host?: string | undefined;
52
56
  }>;
53
57
  actor: z.ZodEffects<z.ZodObject<{
@@ -87,34 +91,34 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
87
91
  tool_version_hash?: string | undefined;
88
92
  }>;
89
93
  action: z.ZodObject<{
90
- kind: z.ZodEnum<["agent_run_start", "agent_run_end", "graph_node_enter", "graph_node_exit", "llm_call", "tool_call", "tool_result", "state_read", "state_write", "decision", "handoff", "human_approval", "human_input", "policy_check", "anomaly_flag", "sdk_diagnostic"]>;
94
+ kind: z.ZodEnum<["graph_node_enter", "graph_node_exit", "llm_call", "llm_call_chunk", "tool_call", "tool_result", "tool_approval_requested", "tool_approval_granted", "tool_approval_denied", "state_read", "state_write", "decision", "run_create", "run_end", "run_suspend", "run_resume", "run_abandon", "delegate", "handoff", "schedule_task", "parallel_group_open", "parallel_group_close", "human_approval", "human_input", "policy_check", "anomaly_flag", "sdk_diagnostic"]>;
91
95
  name: z.ZodString;
92
96
  outcome: z.ZodOptional<z.ZodEnum<["success", "failure", "partial", "timeout", "cancelled"]>>;
93
97
  duration_ms: z.ZodOptional<z.ZodNumber>;
94
98
  }, "strict", z.ZodTypeAny, {
95
- kind: "agent_run_start" | "agent_run_end" | "graph_node_enter" | "graph_node_exit" | "llm_call" | "tool_call" | "tool_result" | "state_read" | "state_write" | "decision" | "handoff" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
99
+ kind: "graph_node_enter" | "graph_node_exit" | "llm_call" | "llm_call_chunk" | "tool_call" | "tool_result" | "tool_approval_requested" | "tool_approval_granted" | "tool_approval_denied" | "state_read" | "state_write" | "decision" | "run_create" | "run_end" | "run_suspend" | "run_resume" | "run_abandon" | "delegate" | "handoff" | "schedule_task" | "parallel_group_open" | "parallel_group_close" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
96
100
  name: string;
97
101
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
98
102
  duration_ms?: number | undefined;
99
103
  }, {
100
- kind: "agent_run_start" | "agent_run_end" | "graph_node_enter" | "graph_node_exit" | "llm_call" | "tool_call" | "tool_result" | "state_read" | "state_write" | "decision" | "handoff" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
104
+ kind: "graph_node_enter" | "graph_node_exit" | "llm_call" | "llm_call_chunk" | "tool_call" | "tool_result" | "tool_approval_requested" | "tool_approval_granted" | "tool_approval_denied" | "state_read" | "state_write" | "decision" | "run_create" | "run_end" | "run_suspend" | "run_resume" | "run_abandon" | "delegate" | "handoff" | "schedule_task" | "parallel_group_open" | "parallel_group_close" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
101
105
  name: string;
102
106
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
103
107
  duration_ms?: number | undefined;
104
108
  }>;
105
- subject: z.ZodObject<{
109
+ subject: z.ZodOptional<z.ZodObject<{
106
110
  resource_urn: z.ZodOptional<z.ZodString>;
107
- data_classification: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci"]>>;
111
+ data_classification: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci", "audit_of_audit"]>>;
108
112
  regulatory_tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
109
113
  }, "strict", z.ZodTypeAny, {
110
114
  regulatory_tags?: string[] | undefined;
111
115
  resource_urn?: string | undefined;
112
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
116
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
113
117
  }, {
114
118
  regulatory_tags?: string[] | undefined;
115
119
  resource_urn?: string | undefined;
116
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
117
- }>;
120
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
121
+ }>>;
118
122
  model_ref: z.ZodOptional<z.ZodObject<{
119
123
  provider: z.ZodEnum<["anthropic", "openai", "google", "aws_bedrock", "azure_openai", "ollama", "self_hosted", "other"]>;
120
124
  model_id: z.ZodString;
@@ -124,6 +128,7 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
124
128
  input_tokens: z.ZodOptional<z.ZodNumber>;
125
129
  output_tokens: z.ZodOptional<z.ZodNumber>;
126
130
  temperature: z.ZodOptional<z.ZodNumber>;
131
+ streaming: z.ZodOptional<z.ZodBoolean>;
127
132
  }, "strict", z.ZodTypeAny, {
128
133
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
129
134
  model_id: string;
@@ -133,6 +138,7 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
133
138
  input_tokens?: number | undefined;
134
139
  output_tokens?: number | undefined;
135
140
  temperature?: number | undefined;
141
+ streaming?: boolean | undefined;
136
142
  }, {
137
143
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
138
144
  model_id: string;
@@ -142,6 +148,7 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
142
148
  input_tokens?: number | undefined;
143
149
  output_tokens?: number | undefined;
144
150
  temperature?: number | undefined;
151
+ streaming?: boolean | undefined;
145
152
  }>>;
146
153
  decision: z.ZodOptional<z.ZodObject<{
147
154
  outcome: z.ZodEnum<["approved", "denied", "escalated", "deferred", "no_action", "custom"]>;
@@ -165,6 +172,93 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
165
172
  policy_thresholds_crossed?: string[] | undefined;
166
173
  reversed_by_event?: string | undefined;
167
174
  }>>;
175
+ suspension_details: z.ZodOptional<z.ZodObject<{
176
+ reason: z.ZodEnum<["awaiting_human_approval", "awaiting_human_input", "awaiting_webhook", "awaiting_schedule", "awaiting_external_system", "awaiting_subagent", "other"]>;
177
+ expected_resumer: z.ZodOptional<z.ZodString>;
178
+ expected_resume_by: z.ZodOptional<z.ZodString>;
179
+ detection_source: z.ZodOptional<z.ZodEnum<["framework_inferred", "customer_explicit", "derived"]>>;
180
+ framework_signal: z.ZodOptional<z.ZodObject<{
181
+ framework: z.ZodOptional<z.ZodEnum<["langgraph", "openai_agents", "claude_agent_sdk", "vercel_ai_sdk", "mcp", "manual", "otel"]>>;
182
+ signal_name: z.ZodOptional<z.ZodString>;
183
+ signal_payload_hash: z.ZodOptional<z.ZodString>;
184
+ }, "strict", z.ZodTypeAny, {
185
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
186
+ signal_name?: string | undefined;
187
+ signal_payload_hash?: string | undefined;
188
+ }, {
189
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
190
+ signal_name?: string | undefined;
191
+ signal_payload_hash?: string | undefined;
192
+ }>>;
193
+ }, "strict", z.ZodTypeAny, {
194
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
195
+ expected_resumer?: string | undefined;
196
+ expected_resume_by?: string | undefined;
197
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
198
+ framework_signal?: {
199
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
200
+ signal_name?: string | undefined;
201
+ signal_payload_hash?: string | undefined;
202
+ } | undefined;
203
+ }, {
204
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
205
+ expected_resumer?: string | undefined;
206
+ expected_resume_by?: string | undefined;
207
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
208
+ framework_signal?: {
209
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
210
+ signal_name?: string | undefined;
211
+ signal_payload_hash?: string | undefined;
212
+ } | undefined;
213
+ }>>;
214
+ resume_details: z.ZodOptional<z.ZodObject<{
215
+ triggered_by: z.ZodEnum<["human_approval_granted", "human_input_received", "webhook_received", "schedule_fired", "external_system_response", "subagent_completed", "manual_resume", "other"]>;
216
+ resumer_principal: z.ZodOptional<z.ZodString>;
217
+ suspension_duration_seconds: z.ZodOptional<z.ZodNumber>;
218
+ suspension_started_event_id: z.ZodOptional<z.ZodString>;
219
+ }, "strict", z.ZodTypeAny, {
220
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
221
+ resumer_principal?: string | undefined;
222
+ suspension_duration_seconds?: number | undefined;
223
+ suspension_started_event_id?: string | undefined;
224
+ }, {
225
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
226
+ resumer_principal?: string | undefined;
227
+ suspension_duration_seconds?: number | undefined;
228
+ suspension_started_event_id?: string | undefined;
229
+ }>>;
230
+ delegation_details: z.ZodOptional<z.ZodObject<{
231
+ delegated_run_id: z.ZodString;
232
+ delegated_agent_identity: z.ZodString;
233
+ wait_for_completion: z.ZodOptional<z.ZodBoolean>;
234
+ framework_signal: z.ZodOptional<z.ZodEnum<["langgraph_subgraph", "openai_agents_as_tool", "claude_agent_sdk_subagent", "manual", "other"]>>;
235
+ }, "strict", z.ZodTypeAny, {
236
+ delegated_run_id: string;
237
+ delegated_agent_identity: string;
238
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
239
+ wait_for_completion?: boolean | undefined;
240
+ }, {
241
+ delegated_run_id: string;
242
+ delegated_agent_identity: string;
243
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
244
+ wait_for_completion?: boolean | undefined;
245
+ }>>;
246
+ handoff_details: z.ZodOptional<z.ZodObject<{
247
+ target_run_id: z.ZodString;
248
+ target_agent_identity: z.ZodString;
249
+ handoff_reason: z.ZodOptional<z.ZodString>;
250
+ framework_signal: z.ZodOptional<z.ZodEnum<["openai_agents_handoff", "langgraph_explicit", "manual", "other"]>>;
251
+ }, "strict", z.ZodTypeAny, {
252
+ target_run_id: string;
253
+ target_agent_identity: string;
254
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
255
+ handoff_reason?: string | undefined;
256
+ }, {
257
+ target_run_id: string;
258
+ target_agent_identity: string;
259
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
260
+ handoff_reason?: string | undefined;
261
+ }>>;
168
262
  payload_ref: z.ZodOptional<z.ZodObject<{
169
263
  s3_uri: z.ZodString;
170
264
  sha256: z.ZodString;
@@ -182,7 +276,7 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
182
276
  data_key_wrapped: string;
183
277
  kms_key_arn?: string | undefined;
184
278
  }>;
185
- content_type: z.ZodOptional<z.ZodEnum<["application/json", "text/plain", "application/vnd.runfile.llm-request+json", "application/vnd.runfile.llm-response+json", "application/vnd.runfile.tool-call+json", "application/vnd.runfile.tool-result+json", "application/vnd.runfile.state-snapshot+json"]>>;
279
+ content_type: z.ZodOptional<z.ZodEnum<["application/json", "text/plain", "application/vnd.runfile.llm-request+json", "application/vnd.runfile.llm-response+json", "application/vnd.runfile.tool-call+json", "application/vnd.runfile.tool-result+json", "application/vnd.runfile.state-snapshot+json", "application/vnd.runfile.framework-signal+json"]>>;
186
280
  redaction_applied: z.ZodOptional<z.ZodObject<{
187
281
  redacted_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
188
282
  tokenized_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -205,7 +299,7 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
205
299
  data_key_wrapped: string;
206
300
  kms_key_arn?: string | undefined;
207
301
  };
208
- content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | undefined;
302
+ content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
209
303
  redaction_applied?: {
210
304
  redacted_classes?: string[] | undefined;
211
305
  tokenized_classes?: string[] | undefined;
@@ -220,31 +314,92 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
220
314
  data_key_wrapped: string;
221
315
  kms_key_arn?: string | undefined;
222
316
  };
223
- content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | undefined;
317
+ content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
224
318
  redaction_applied?: {
225
319
  redacted_classes?: string[] | undefined;
226
320
  tokenized_classes?: string[] | undefined;
227
321
  classifier_version?: string | undefined;
228
322
  } | undefined;
229
323
  }>>;
324
+ otel_attributes: z.ZodOptional<z.ZodObject<{
325
+ gen_ai_system: z.ZodOptional<z.ZodString>;
326
+ gen_ai_operation_name: z.ZodOptional<z.ZodString>;
327
+ gen_ai_provider_name: z.ZodOptional<z.ZodString>;
328
+ gen_ai_request_model: z.ZodOptional<z.ZodString>;
329
+ gen_ai_response_model: z.ZodOptional<z.ZodString>;
330
+ gen_ai_request_temperature: z.ZodOptional<z.ZodNumber>;
331
+ gen_ai_request_top_p: z.ZodOptional<z.ZodNumber>;
332
+ gen_ai_request_max_tokens: z.ZodOptional<z.ZodNumber>;
333
+ gen_ai_response_id: z.ZodOptional<z.ZodString>;
334
+ gen_ai_response_finish_reasons: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
335
+ gen_ai_usage_input_tokens: z.ZodOptional<z.ZodNumber>;
336
+ gen_ai_usage_output_tokens: z.ZodOptional<z.ZodNumber>;
337
+ gen_ai_tool_name: z.ZodOptional<z.ZodString>;
338
+ gen_ai_tool_call_id: z.ZodOptional<z.ZodString>;
339
+ gen_ai_agent_id: z.ZodOptional<z.ZodString>;
340
+ gen_ai_agent_name: z.ZodOptional<z.ZodString>;
341
+ gen_ai_agent_description: z.ZodOptional<z.ZodString>;
342
+ gen_ai_conversation_id: z.ZodOptional<z.ZodString>;
343
+ extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
344
+ }, "strict", z.ZodTypeAny, {
345
+ gen_ai_system?: string | undefined;
346
+ gen_ai_operation_name?: string | undefined;
347
+ gen_ai_provider_name?: string | undefined;
348
+ gen_ai_request_model?: string | undefined;
349
+ gen_ai_response_model?: string | undefined;
350
+ gen_ai_request_temperature?: number | undefined;
351
+ gen_ai_request_top_p?: number | undefined;
352
+ gen_ai_request_max_tokens?: number | undefined;
353
+ gen_ai_response_id?: string | undefined;
354
+ gen_ai_response_finish_reasons?: string[] | undefined;
355
+ gen_ai_usage_input_tokens?: number | undefined;
356
+ gen_ai_usage_output_tokens?: number | undefined;
357
+ gen_ai_tool_name?: string | undefined;
358
+ gen_ai_tool_call_id?: string | undefined;
359
+ gen_ai_agent_id?: string | undefined;
360
+ gen_ai_agent_name?: string | undefined;
361
+ gen_ai_agent_description?: string | undefined;
362
+ gen_ai_conversation_id?: string | undefined;
363
+ extra?: Record<string, string | number | boolean> | undefined;
364
+ }, {
365
+ gen_ai_system?: string | undefined;
366
+ gen_ai_operation_name?: string | undefined;
367
+ gen_ai_provider_name?: string | undefined;
368
+ gen_ai_request_model?: string | undefined;
369
+ gen_ai_response_model?: string | undefined;
370
+ gen_ai_request_temperature?: number | undefined;
371
+ gen_ai_request_top_p?: number | undefined;
372
+ gen_ai_request_max_tokens?: number | undefined;
373
+ gen_ai_response_id?: string | undefined;
374
+ gen_ai_response_finish_reasons?: string[] | undefined;
375
+ gen_ai_usage_input_tokens?: number | undefined;
376
+ gen_ai_usage_output_tokens?: number | undefined;
377
+ gen_ai_tool_name?: string | undefined;
378
+ gen_ai_tool_call_id?: string | undefined;
379
+ gen_ai_agent_id?: string | undefined;
380
+ gen_ai_agent_name?: string | undefined;
381
+ gen_ai_agent_description?: string | undefined;
382
+ gen_ai_conversation_id?: string | undefined;
383
+ extra?: Record<string, string | number | boolean> | undefined;
384
+ }>>;
230
385
  redaction_policy_version: z.ZodString;
231
386
  regulatory_scope_version: z.ZodOptional<z.ZodString>;
232
387
  anomaly_flags: z.ZodOptional<z.ZodArray<z.ZodObject<{
233
- code: z.ZodEnum<["missing_ambient_context", "chain_break", "out_of_order_arrival", "model_version_drift", "unknown_agent_identity", "data_classification_mismatch", "policy_threshold_without_hitl", "unauthorized_tool_invocation", "redaction_policy_mismatch", "schema_version_warning"]>;
388
+ code: z.ZodEnum<["missing_ambient_context", "chain_break", "out_of_order_arrival", "model_version_drift", "unknown_agent_identity", "data_classification_mismatch", "policy_threshold_without_hitl", "unauthorized_tool_invocation", "redaction_policy_mismatch", "schema_version_warning", "agent_identity_mismatch_with_run", "suspension_sla_exceeded", "apparent_crash_detected", "active_duration_exceeds_threshold", "framework_signal_unrecognised", "otel_attribute_missing", "delegation_loop_detected"]>;
234
389
  severity: z.ZodEnum<["info", "warning", "error", "critical"]>;
235
390
  detail: z.ZodOptional<z.ZodString>;
236
391
  }, "strict", z.ZodTypeAny, {
237
- code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning";
392
+ code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
238
393
  severity: "info" | "warning" | "error" | "critical";
239
394
  detail?: string | undefined;
240
395
  }, {
241
- code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning";
396
+ code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
242
397
  severity: "info" | "warning" | "error" | "critical";
243
398
  detail?: string | undefined;
244
399
  }>, "many">>;
245
400
  environment: z.ZodOptional<z.ZodEnum<["production", "staging", "development"]>>;
246
401
  labels: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>>;
247
- prev_hash: z.ZodString;
402
+ prev_event_hash: z.ZodString;
248
403
  event_hash: z.ZodString;
249
404
  merkle_inclusion: z.ZodOptional<z.ZodObject<{
250
405
  manifest_uri: z.ZodString;
@@ -261,19 +416,21 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
261
416
  }>>;
262
417
  }, "strict", z.ZodTypeAny, {
263
418
  event_hash: string;
264
- schema_version: string;
419
+ run_id: string;
265
420
  event_id: string;
421
+ schema_version: string;
266
422
  tenant_id: string;
267
- agent_run_id: string;
423
+ redaction_policy_version: string;
268
424
  parent_event_id: string | null;
269
425
  captured_at: string;
270
426
  received_at: string;
271
427
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
272
428
  sdk: {
273
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
429
+ framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
274
430
  name: "runfile-py" | "@runfile/sdk";
275
431
  version: string;
276
432
  framework_version?: string | undefined;
433
+ adapter?: string | undefined;
277
434
  host?: string | undefined;
278
435
  };
279
436
  actor: {
@@ -285,18 +442,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
285
442
  tool_version_hash?: string | undefined;
286
443
  };
287
444
  action: {
288
- kind: "agent_run_start" | "agent_run_end" | "graph_node_enter" | "graph_node_exit" | "llm_call" | "tool_call" | "tool_result" | "state_read" | "state_write" | "decision" | "handoff" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
445
+ kind: "graph_node_enter" | "graph_node_exit" | "llm_call" | "llm_call_chunk" | "tool_call" | "tool_result" | "tool_approval_requested" | "tool_approval_granted" | "tool_approval_denied" | "state_read" | "state_write" | "decision" | "run_create" | "run_end" | "run_suspend" | "run_resume" | "run_abandon" | "delegate" | "handoff" | "schedule_task" | "parallel_group_open" | "parallel_group_close" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
289
446
  name: string;
290
447
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
291
448
  duration_ms?: number | undefined;
292
449
  };
293
- subject: {
294
- regulatory_tags?: string[] | undefined;
295
- resource_urn?: string | undefined;
296
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
297
- };
298
- redaction_policy_version: string;
299
- prev_hash: string;
450
+ prev_event_hash: string;
300
451
  decision?: {
301
452
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
302
453
  outcome_label?: string | undefined;
@@ -305,6 +456,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
305
456
  policy_thresholds_crossed?: string[] | undefined;
306
457
  reversed_by_event?: string | undefined;
307
458
  } | undefined;
459
+ environment?: "production" | "staging" | "development" | undefined;
460
+ labels?: Record<string, string> | undefined;
461
+ regulatory_scope_version?: string | undefined;
462
+ parallel_group_id?: string | undefined;
463
+ subject?: {
464
+ regulatory_tags?: string[] | undefined;
465
+ resource_urn?: string | undefined;
466
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
467
+ } | undefined;
308
468
  model_ref?: {
309
469
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
310
470
  model_id: string;
@@ -314,6 +474,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
314
474
  input_tokens?: number | undefined;
315
475
  output_tokens?: number | undefined;
316
476
  temperature?: number | undefined;
477
+ streaming?: boolean | undefined;
478
+ } | undefined;
479
+ suspension_details?: {
480
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
481
+ expected_resumer?: string | undefined;
482
+ expected_resume_by?: string | undefined;
483
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
484
+ framework_signal?: {
485
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
486
+ signal_name?: string | undefined;
487
+ signal_payload_hash?: string | undefined;
488
+ } | undefined;
489
+ } | undefined;
490
+ resume_details?: {
491
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
492
+ resumer_principal?: string | undefined;
493
+ suspension_duration_seconds?: number | undefined;
494
+ suspension_started_event_id?: string | undefined;
495
+ } | undefined;
496
+ delegation_details?: {
497
+ delegated_run_id: string;
498
+ delegated_agent_identity: string;
499
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
500
+ wait_for_completion?: boolean | undefined;
501
+ } | undefined;
502
+ handoff_details?: {
503
+ target_run_id: string;
504
+ target_agent_identity: string;
505
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
506
+ handoff_reason?: string | undefined;
317
507
  } | undefined;
318
508
  payload_ref?: {
319
509
  sha256: string;
@@ -324,21 +514,39 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
324
514
  data_key_wrapped: string;
325
515
  kms_key_arn?: string | undefined;
326
516
  };
327
- content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | undefined;
517
+ content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
328
518
  redaction_applied?: {
329
519
  redacted_classes?: string[] | undefined;
330
520
  tokenized_classes?: string[] | undefined;
331
521
  classifier_version?: string | undefined;
332
522
  } | undefined;
333
523
  } | undefined;
334
- regulatory_scope_version?: string | undefined;
524
+ otel_attributes?: {
525
+ gen_ai_system?: string | undefined;
526
+ gen_ai_operation_name?: string | undefined;
527
+ gen_ai_provider_name?: string | undefined;
528
+ gen_ai_request_model?: string | undefined;
529
+ gen_ai_response_model?: string | undefined;
530
+ gen_ai_request_temperature?: number | undefined;
531
+ gen_ai_request_top_p?: number | undefined;
532
+ gen_ai_request_max_tokens?: number | undefined;
533
+ gen_ai_response_id?: string | undefined;
534
+ gen_ai_response_finish_reasons?: string[] | undefined;
535
+ gen_ai_usage_input_tokens?: number | undefined;
536
+ gen_ai_usage_output_tokens?: number | undefined;
537
+ gen_ai_tool_name?: string | undefined;
538
+ gen_ai_tool_call_id?: string | undefined;
539
+ gen_ai_agent_id?: string | undefined;
540
+ gen_ai_agent_name?: string | undefined;
541
+ gen_ai_agent_description?: string | undefined;
542
+ gen_ai_conversation_id?: string | undefined;
543
+ extra?: Record<string, string | number | boolean> | undefined;
544
+ } | undefined;
335
545
  anomaly_flags?: {
336
- code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning";
546
+ code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
337
547
  severity: "info" | "warning" | "error" | "critical";
338
548
  detail?: string | undefined;
339
549
  }[] | undefined;
340
- environment?: "production" | "staging" | "development" | undefined;
341
- labels?: Record<string, string> | undefined;
342
550
  merkle_inclusion?: {
343
551
  manifest_uri: string;
344
552
  leaf_index: number;
@@ -346,19 +554,21 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
346
554
  } | undefined;
347
555
  }, {
348
556
  event_hash: string;
349
- schema_version: string;
557
+ run_id: string;
350
558
  event_id: string;
559
+ schema_version: string;
351
560
  tenant_id: string;
352
- agent_run_id: string;
561
+ redaction_policy_version: string;
353
562
  parent_event_id: string | null;
354
563
  captured_at: string;
355
564
  received_at: string;
356
565
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
357
566
  sdk: {
358
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
567
+ framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
359
568
  name: "runfile-py" | "@runfile/sdk";
360
569
  version: string;
361
570
  framework_version?: string | undefined;
571
+ adapter?: string | undefined;
362
572
  host?: string | undefined;
363
573
  };
364
574
  actor: {
@@ -370,18 +580,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
370
580
  tool_version_hash?: string | undefined;
371
581
  };
372
582
  action: {
373
- kind: "agent_run_start" | "agent_run_end" | "graph_node_enter" | "graph_node_exit" | "llm_call" | "tool_call" | "tool_result" | "state_read" | "state_write" | "decision" | "handoff" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
583
+ kind: "graph_node_enter" | "graph_node_exit" | "llm_call" | "llm_call_chunk" | "tool_call" | "tool_result" | "tool_approval_requested" | "tool_approval_granted" | "tool_approval_denied" | "state_read" | "state_write" | "decision" | "run_create" | "run_end" | "run_suspend" | "run_resume" | "run_abandon" | "delegate" | "handoff" | "schedule_task" | "parallel_group_open" | "parallel_group_close" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
374
584
  name: string;
375
585
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
376
586
  duration_ms?: number | undefined;
377
587
  };
378
- subject: {
379
- regulatory_tags?: string[] | undefined;
380
- resource_urn?: string | undefined;
381
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
382
- };
383
- redaction_policy_version: string;
384
- prev_hash: string;
588
+ prev_event_hash: string;
385
589
  decision?: {
386
590
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
387
591
  outcome_label?: string | undefined;
@@ -390,6 +594,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
390
594
  policy_thresholds_crossed?: string[] | undefined;
391
595
  reversed_by_event?: string | undefined;
392
596
  } | undefined;
597
+ environment?: "production" | "staging" | "development" | undefined;
598
+ labels?: Record<string, string> | undefined;
599
+ regulatory_scope_version?: string | undefined;
600
+ parallel_group_id?: string | undefined;
601
+ subject?: {
602
+ regulatory_tags?: string[] | undefined;
603
+ resource_urn?: string | undefined;
604
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
605
+ } | undefined;
393
606
  model_ref?: {
394
607
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
395
608
  model_id: string;
@@ -399,6 +612,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
399
612
  input_tokens?: number | undefined;
400
613
  output_tokens?: number | undefined;
401
614
  temperature?: number | undefined;
615
+ streaming?: boolean | undefined;
616
+ } | undefined;
617
+ suspension_details?: {
618
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
619
+ expected_resumer?: string | undefined;
620
+ expected_resume_by?: string | undefined;
621
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
622
+ framework_signal?: {
623
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
624
+ signal_name?: string | undefined;
625
+ signal_payload_hash?: string | undefined;
626
+ } | undefined;
627
+ } | undefined;
628
+ resume_details?: {
629
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
630
+ resumer_principal?: string | undefined;
631
+ suspension_duration_seconds?: number | undefined;
632
+ suspension_started_event_id?: string | undefined;
633
+ } | undefined;
634
+ delegation_details?: {
635
+ delegated_run_id: string;
636
+ delegated_agent_identity: string;
637
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
638
+ wait_for_completion?: boolean | undefined;
639
+ } | undefined;
640
+ handoff_details?: {
641
+ target_run_id: string;
642
+ target_agent_identity: string;
643
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
644
+ handoff_reason?: string | undefined;
402
645
  } | undefined;
403
646
  payload_ref?: {
404
647
  sha256: string;
@@ -409,21 +652,39 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
409
652
  data_key_wrapped: string;
410
653
  kms_key_arn?: string | undefined;
411
654
  };
412
- content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | undefined;
655
+ content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
413
656
  redaction_applied?: {
414
657
  redacted_classes?: string[] | undefined;
415
658
  tokenized_classes?: string[] | undefined;
416
659
  classifier_version?: string | undefined;
417
660
  } | undefined;
418
661
  } | undefined;
419
- regulatory_scope_version?: string | undefined;
662
+ otel_attributes?: {
663
+ gen_ai_system?: string | undefined;
664
+ gen_ai_operation_name?: string | undefined;
665
+ gen_ai_provider_name?: string | undefined;
666
+ gen_ai_request_model?: string | undefined;
667
+ gen_ai_response_model?: string | undefined;
668
+ gen_ai_request_temperature?: number | undefined;
669
+ gen_ai_request_top_p?: number | undefined;
670
+ gen_ai_request_max_tokens?: number | undefined;
671
+ gen_ai_response_id?: string | undefined;
672
+ gen_ai_response_finish_reasons?: string[] | undefined;
673
+ gen_ai_usage_input_tokens?: number | undefined;
674
+ gen_ai_usage_output_tokens?: number | undefined;
675
+ gen_ai_tool_name?: string | undefined;
676
+ gen_ai_tool_call_id?: string | undefined;
677
+ gen_ai_agent_id?: string | undefined;
678
+ gen_ai_agent_name?: string | undefined;
679
+ gen_ai_agent_description?: string | undefined;
680
+ gen_ai_conversation_id?: string | undefined;
681
+ extra?: Record<string, string | number | boolean> | undefined;
682
+ } | undefined;
420
683
  anomaly_flags?: {
421
- code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning";
684
+ code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
422
685
  severity: "info" | "warning" | "error" | "critical";
423
686
  detail?: string | undefined;
424
687
  }[] | undefined;
425
- environment?: "production" | "staging" | "development" | undefined;
426
- labels?: Record<string, string> | undefined;
427
688
  merkle_inclusion?: {
428
689
  manifest_uri: string;
429
690
  leaf_index: number;
@@ -431,19 +692,21 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
431
692
  } | undefined;
432
693
  }>, {
433
694
  event_hash: string;
434
- schema_version: string;
695
+ run_id: string;
435
696
  event_id: string;
697
+ schema_version: string;
436
698
  tenant_id: string;
437
- agent_run_id: string;
699
+ redaction_policy_version: string;
438
700
  parent_event_id: string | null;
439
701
  captured_at: string;
440
702
  received_at: string;
441
703
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
442
704
  sdk: {
443
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
705
+ framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
444
706
  name: "runfile-py" | "@runfile/sdk";
445
707
  version: string;
446
708
  framework_version?: string | undefined;
709
+ adapter?: string | undefined;
447
710
  host?: string | undefined;
448
711
  };
449
712
  actor: {
@@ -455,18 +718,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
455
718
  tool_version_hash?: string | undefined;
456
719
  };
457
720
  action: {
458
- kind: "agent_run_start" | "agent_run_end" | "graph_node_enter" | "graph_node_exit" | "llm_call" | "tool_call" | "tool_result" | "state_read" | "state_write" | "decision" | "handoff" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
721
+ kind: "graph_node_enter" | "graph_node_exit" | "llm_call" | "llm_call_chunk" | "tool_call" | "tool_result" | "tool_approval_requested" | "tool_approval_granted" | "tool_approval_denied" | "state_read" | "state_write" | "decision" | "run_create" | "run_end" | "run_suspend" | "run_resume" | "run_abandon" | "delegate" | "handoff" | "schedule_task" | "parallel_group_open" | "parallel_group_close" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
459
722
  name: string;
460
723
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
461
724
  duration_ms?: number | undefined;
462
725
  };
463
- subject: {
464
- regulatory_tags?: string[] | undefined;
465
- resource_urn?: string | undefined;
466
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
467
- };
468
- redaction_policy_version: string;
469
- prev_hash: string;
726
+ prev_event_hash: string;
470
727
  decision?: {
471
728
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
472
729
  outcome_label?: string | undefined;
@@ -475,6 +732,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
475
732
  policy_thresholds_crossed?: string[] | undefined;
476
733
  reversed_by_event?: string | undefined;
477
734
  } | undefined;
735
+ environment?: "production" | "staging" | "development" | undefined;
736
+ labels?: Record<string, string> | undefined;
737
+ regulatory_scope_version?: string | undefined;
738
+ parallel_group_id?: string | undefined;
739
+ subject?: {
740
+ regulatory_tags?: string[] | undefined;
741
+ resource_urn?: string | undefined;
742
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
743
+ } | undefined;
478
744
  model_ref?: {
479
745
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
480
746
  model_id: string;
@@ -484,6 +750,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
484
750
  input_tokens?: number | undefined;
485
751
  output_tokens?: number | undefined;
486
752
  temperature?: number | undefined;
753
+ streaming?: boolean | undefined;
754
+ } | undefined;
755
+ suspension_details?: {
756
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
757
+ expected_resumer?: string | undefined;
758
+ expected_resume_by?: string | undefined;
759
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
760
+ framework_signal?: {
761
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
762
+ signal_name?: string | undefined;
763
+ signal_payload_hash?: string | undefined;
764
+ } | undefined;
765
+ } | undefined;
766
+ resume_details?: {
767
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
768
+ resumer_principal?: string | undefined;
769
+ suspension_duration_seconds?: number | undefined;
770
+ suspension_started_event_id?: string | undefined;
771
+ } | undefined;
772
+ delegation_details?: {
773
+ delegated_run_id: string;
774
+ delegated_agent_identity: string;
775
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
776
+ wait_for_completion?: boolean | undefined;
777
+ } | undefined;
778
+ handoff_details?: {
779
+ target_run_id: string;
780
+ target_agent_identity: string;
781
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
782
+ handoff_reason?: string | undefined;
487
783
  } | undefined;
488
784
  payload_ref?: {
489
785
  sha256: string;
@@ -494,21 +790,39 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
494
790
  data_key_wrapped: string;
495
791
  kms_key_arn?: string | undefined;
496
792
  };
497
- content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | undefined;
793
+ content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
498
794
  redaction_applied?: {
499
795
  redacted_classes?: string[] | undefined;
500
796
  tokenized_classes?: string[] | undefined;
501
797
  classifier_version?: string | undefined;
502
798
  } | undefined;
503
799
  } | undefined;
504
- regulatory_scope_version?: string | undefined;
800
+ otel_attributes?: {
801
+ gen_ai_system?: string | undefined;
802
+ gen_ai_operation_name?: string | undefined;
803
+ gen_ai_provider_name?: string | undefined;
804
+ gen_ai_request_model?: string | undefined;
805
+ gen_ai_response_model?: string | undefined;
806
+ gen_ai_request_temperature?: number | undefined;
807
+ gen_ai_request_top_p?: number | undefined;
808
+ gen_ai_request_max_tokens?: number | undefined;
809
+ gen_ai_response_id?: string | undefined;
810
+ gen_ai_response_finish_reasons?: string[] | undefined;
811
+ gen_ai_usage_input_tokens?: number | undefined;
812
+ gen_ai_usage_output_tokens?: number | undefined;
813
+ gen_ai_tool_name?: string | undefined;
814
+ gen_ai_tool_call_id?: string | undefined;
815
+ gen_ai_agent_id?: string | undefined;
816
+ gen_ai_agent_name?: string | undefined;
817
+ gen_ai_agent_description?: string | undefined;
818
+ gen_ai_conversation_id?: string | undefined;
819
+ extra?: Record<string, string | number | boolean> | undefined;
820
+ } | undefined;
505
821
  anomaly_flags?: {
506
- code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning";
822
+ code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
507
823
  severity: "info" | "warning" | "error" | "critical";
508
824
  detail?: string | undefined;
509
825
  }[] | undefined;
510
- environment?: "production" | "staging" | "development" | undefined;
511
- labels?: Record<string, string> | undefined;
512
826
  merkle_inclusion?: {
513
827
  manifest_uri: string;
514
828
  leaf_index: number;
@@ -516,19 +830,21 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
516
830
  } | undefined;
517
831
  }, {
518
832
  event_hash: string;
519
- schema_version: string;
833
+ run_id: string;
520
834
  event_id: string;
835
+ schema_version: string;
521
836
  tenant_id: string;
522
- agent_run_id: string;
837
+ redaction_policy_version: string;
523
838
  parent_event_id: string | null;
524
839
  captured_at: string;
525
840
  received_at: string;
526
841
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
527
842
  sdk: {
528
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
843
+ framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
529
844
  name: "runfile-py" | "@runfile/sdk";
530
845
  version: string;
531
846
  framework_version?: string | undefined;
847
+ adapter?: string | undefined;
532
848
  host?: string | undefined;
533
849
  };
534
850
  actor: {
@@ -540,18 +856,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
540
856
  tool_version_hash?: string | undefined;
541
857
  };
542
858
  action: {
543
- kind: "agent_run_start" | "agent_run_end" | "graph_node_enter" | "graph_node_exit" | "llm_call" | "tool_call" | "tool_result" | "state_read" | "state_write" | "decision" | "handoff" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
859
+ kind: "graph_node_enter" | "graph_node_exit" | "llm_call" | "llm_call_chunk" | "tool_call" | "tool_result" | "tool_approval_requested" | "tool_approval_granted" | "tool_approval_denied" | "state_read" | "state_write" | "decision" | "run_create" | "run_end" | "run_suspend" | "run_resume" | "run_abandon" | "delegate" | "handoff" | "schedule_task" | "parallel_group_open" | "parallel_group_close" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
544
860
  name: string;
545
861
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
546
862
  duration_ms?: number | undefined;
547
863
  };
548
- subject: {
549
- regulatory_tags?: string[] | undefined;
550
- resource_urn?: string | undefined;
551
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
552
- };
553
- redaction_policy_version: string;
554
- prev_hash: string;
864
+ prev_event_hash: string;
555
865
  decision?: {
556
866
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
557
867
  outcome_label?: string | undefined;
@@ -560,6 +870,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
560
870
  policy_thresholds_crossed?: string[] | undefined;
561
871
  reversed_by_event?: string | undefined;
562
872
  } | undefined;
873
+ environment?: "production" | "staging" | "development" | undefined;
874
+ labels?: Record<string, string> | undefined;
875
+ regulatory_scope_version?: string | undefined;
876
+ parallel_group_id?: string | undefined;
877
+ subject?: {
878
+ regulatory_tags?: string[] | undefined;
879
+ resource_urn?: string | undefined;
880
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
881
+ } | undefined;
563
882
  model_ref?: {
564
883
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
565
884
  model_id: string;
@@ -569,6 +888,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
569
888
  input_tokens?: number | undefined;
570
889
  output_tokens?: number | undefined;
571
890
  temperature?: number | undefined;
891
+ streaming?: boolean | undefined;
892
+ } | undefined;
893
+ suspension_details?: {
894
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
895
+ expected_resumer?: string | undefined;
896
+ expected_resume_by?: string | undefined;
897
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
898
+ framework_signal?: {
899
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
900
+ signal_name?: string | undefined;
901
+ signal_payload_hash?: string | undefined;
902
+ } | undefined;
903
+ } | undefined;
904
+ resume_details?: {
905
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
906
+ resumer_principal?: string | undefined;
907
+ suspension_duration_seconds?: number | undefined;
908
+ suspension_started_event_id?: string | undefined;
909
+ } | undefined;
910
+ delegation_details?: {
911
+ delegated_run_id: string;
912
+ delegated_agent_identity: string;
913
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
914
+ wait_for_completion?: boolean | undefined;
915
+ } | undefined;
916
+ handoff_details?: {
917
+ target_run_id: string;
918
+ target_agent_identity: string;
919
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
920
+ handoff_reason?: string | undefined;
572
921
  } | undefined;
573
922
  payload_ref?: {
574
923
  sha256: string;
@@ -579,21 +928,39 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
579
928
  data_key_wrapped: string;
580
929
  kms_key_arn?: string | undefined;
581
930
  };
582
- content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | undefined;
931
+ content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
583
932
  redaction_applied?: {
584
933
  redacted_classes?: string[] | undefined;
585
934
  tokenized_classes?: string[] | undefined;
586
935
  classifier_version?: string | undefined;
587
936
  } | undefined;
588
937
  } | undefined;
589
- regulatory_scope_version?: string | undefined;
938
+ otel_attributes?: {
939
+ gen_ai_system?: string | undefined;
940
+ gen_ai_operation_name?: string | undefined;
941
+ gen_ai_provider_name?: string | undefined;
942
+ gen_ai_request_model?: string | undefined;
943
+ gen_ai_response_model?: string | undefined;
944
+ gen_ai_request_temperature?: number | undefined;
945
+ gen_ai_request_top_p?: number | undefined;
946
+ gen_ai_request_max_tokens?: number | undefined;
947
+ gen_ai_response_id?: string | undefined;
948
+ gen_ai_response_finish_reasons?: string[] | undefined;
949
+ gen_ai_usage_input_tokens?: number | undefined;
950
+ gen_ai_usage_output_tokens?: number | undefined;
951
+ gen_ai_tool_name?: string | undefined;
952
+ gen_ai_tool_call_id?: string | undefined;
953
+ gen_ai_agent_id?: string | undefined;
954
+ gen_ai_agent_name?: string | undefined;
955
+ gen_ai_agent_description?: string | undefined;
956
+ gen_ai_conversation_id?: string | undefined;
957
+ extra?: Record<string, string | number | boolean> | undefined;
958
+ } | undefined;
590
959
  anomaly_flags?: {
591
- code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning";
960
+ code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
592
961
  severity: "info" | "warning" | "error" | "critical";
593
962
  detail?: string | undefined;
594
963
  }[] | undefined;
595
- environment?: "production" | "staging" | "development" | undefined;
596
- labels?: Record<string, string> | undefined;
597
964
  merkle_inclusion?: {
598
965
  manifest_uri: string;
599
966
  leaf_index: number;
@@ -713,19 +1080,21 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
713
1080
  };
714
1081
  events: {
715
1082
  event_hash: string;
716
- schema_version: string;
1083
+ run_id: string;
717
1084
  event_id: string;
1085
+ schema_version: string;
718
1086
  tenant_id: string;
719
- agent_run_id: string;
1087
+ redaction_policy_version: string;
720
1088
  parent_event_id: string | null;
721
1089
  captured_at: string;
722
1090
  received_at: string;
723
1091
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
724
1092
  sdk: {
725
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
1093
+ framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
726
1094
  name: "runfile-py" | "@runfile/sdk";
727
1095
  version: string;
728
1096
  framework_version?: string | undefined;
1097
+ adapter?: string | undefined;
729
1098
  host?: string | undefined;
730
1099
  };
731
1100
  actor: {
@@ -737,18 +1106,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
737
1106
  tool_version_hash?: string | undefined;
738
1107
  };
739
1108
  action: {
740
- kind: "agent_run_start" | "agent_run_end" | "graph_node_enter" | "graph_node_exit" | "llm_call" | "tool_call" | "tool_result" | "state_read" | "state_write" | "decision" | "handoff" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
1109
+ kind: "graph_node_enter" | "graph_node_exit" | "llm_call" | "llm_call_chunk" | "tool_call" | "tool_result" | "tool_approval_requested" | "tool_approval_granted" | "tool_approval_denied" | "state_read" | "state_write" | "decision" | "run_create" | "run_end" | "run_suspend" | "run_resume" | "run_abandon" | "delegate" | "handoff" | "schedule_task" | "parallel_group_open" | "parallel_group_close" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
741
1110
  name: string;
742
1111
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
743
1112
  duration_ms?: number | undefined;
744
1113
  };
745
- subject: {
746
- regulatory_tags?: string[] | undefined;
747
- resource_urn?: string | undefined;
748
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
749
- };
750
- redaction_policy_version: string;
751
- prev_hash: string;
1114
+ prev_event_hash: string;
752
1115
  decision?: {
753
1116
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
754
1117
  outcome_label?: string | undefined;
@@ -757,6 +1120,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
757
1120
  policy_thresholds_crossed?: string[] | undefined;
758
1121
  reversed_by_event?: string | undefined;
759
1122
  } | undefined;
1123
+ environment?: "production" | "staging" | "development" | undefined;
1124
+ labels?: Record<string, string> | undefined;
1125
+ regulatory_scope_version?: string | undefined;
1126
+ parallel_group_id?: string | undefined;
1127
+ subject?: {
1128
+ regulatory_tags?: string[] | undefined;
1129
+ resource_urn?: string | undefined;
1130
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
1131
+ } | undefined;
760
1132
  model_ref?: {
761
1133
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
762
1134
  model_id: string;
@@ -766,6 +1138,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
766
1138
  input_tokens?: number | undefined;
767
1139
  output_tokens?: number | undefined;
768
1140
  temperature?: number | undefined;
1141
+ streaming?: boolean | undefined;
1142
+ } | undefined;
1143
+ suspension_details?: {
1144
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
1145
+ expected_resumer?: string | undefined;
1146
+ expected_resume_by?: string | undefined;
1147
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
1148
+ framework_signal?: {
1149
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
1150
+ signal_name?: string | undefined;
1151
+ signal_payload_hash?: string | undefined;
1152
+ } | undefined;
1153
+ } | undefined;
1154
+ resume_details?: {
1155
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
1156
+ resumer_principal?: string | undefined;
1157
+ suspension_duration_seconds?: number | undefined;
1158
+ suspension_started_event_id?: string | undefined;
1159
+ } | undefined;
1160
+ delegation_details?: {
1161
+ delegated_run_id: string;
1162
+ delegated_agent_identity: string;
1163
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
1164
+ wait_for_completion?: boolean | undefined;
1165
+ } | undefined;
1166
+ handoff_details?: {
1167
+ target_run_id: string;
1168
+ target_agent_identity: string;
1169
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
1170
+ handoff_reason?: string | undefined;
769
1171
  } | undefined;
770
1172
  payload_ref?: {
771
1173
  sha256: string;
@@ -776,21 +1178,39 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
776
1178
  data_key_wrapped: string;
777
1179
  kms_key_arn?: string | undefined;
778
1180
  };
779
- content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | undefined;
1181
+ content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
780
1182
  redaction_applied?: {
781
1183
  redacted_classes?: string[] | undefined;
782
1184
  tokenized_classes?: string[] | undefined;
783
1185
  classifier_version?: string | undefined;
784
1186
  } | undefined;
785
1187
  } | undefined;
786
- regulatory_scope_version?: string | undefined;
1188
+ otel_attributes?: {
1189
+ gen_ai_system?: string | undefined;
1190
+ gen_ai_operation_name?: string | undefined;
1191
+ gen_ai_provider_name?: string | undefined;
1192
+ gen_ai_request_model?: string | undefined;
1193
+ gen_ai_response_model?: string | undefined;
1194
+ gen_ai_request_temperature?: number | undefined;
1195
+ gen_ai_request_top_p?: number | undefined;
1196
+ gen_ai_request_max_tokens?: number | undefined;
1197
+ gen_ai_response_id?: string | undefined;
1198
+ gen_ai_response_finish_reasons?: string[] | undefined;
1199
+ gen_ai_usage_input_tokens?: number | undefined;
1200
+ gen_ai_usage_output_tokens?: number | undefined;
1201
+ gen_ai_tool_name?: string | undefined;
1202
+ gen_ai_tool_call_id?: string | undefined;
1203
+ gen_ai_agent_id?: string | undefined;
1204
+ gen_ai_agent_name?: string | undefined;
1205
+ gen_ai_agent_description?: string | undefined;
1206
+ gen_ai_conversation_id?: string | undefined;
1207
+ extra?: Record<string, string | number | boolean> | undefined;
1208
+ } | undefined;
787
1209
  anomaly_flags?: {
788
- code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning";
1210
+ code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
789
1211
  severity: "info" | "warning" | "error" | "critical";
790
1212
  detail?: string | undefined;
791
1213
  }[] | undefined;
792
- environment?: "production" | "staging" | "development" | undefined;
793
- labels?: Record<string, string> | undefined;
794
1214
  merkle_inclusion?: {
795
1215
  manifest_uri: string;
796
1216
  leaf_index: number;
@@ -837,19 +1257,21 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
837
1257
  };
838
1258
  events: {
839
1259
  event_hash: string;
840
- schema_version: string;
1260
+ run_id: string;
841
1261
  event_id: string;
1262
+ schema_version: string;
842
1263
  tenant_id: string;
843
- agent_run_id: string;
1264
+ redaction_policy_version: string;
844
1265
  parent_event_id: string | null;
845
1266
  captured_at: string;
846
1267
  received_at: string;
847
1268
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
848
1269
  sdk: {
849
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
1270
+ framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
850
1271
  name: "runfile-py" | "@runfile/sdk";
851
1272
  version: string;
852
1273
  framework_version?: string | undefined;
1274
+ adapter?: string | undefined;
853
1275
  host?: string | undefined;
854
1276
  };
855
1277
  actor: {
@@ -861,18 +1283,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
861
1283
  tool_version_hash?: string | undefined;
862
1284
  };
863
1285
  action: {
864
- kind: "agent_run_start" | "agent_run_end" | "graph_node_enter" | "graph_node_exit" | "llm_call" | "tool_call" | "tool_result" | "state_read" | "state_write" | "decision" | "handoff" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
1286
+ kind: "graph_node_enter" | "graph_node_exit" | "llm_call" | "llm_call_chunk" | "tool_call" | "tool_result" | "tool_approval_requested" | "tool_approval_granted" | "tool_approval_denied" | "state_read" | "state_write" | "decision" | "run_create" | "run_end" | "run_suspend" | "run_resume" | "run_abandon" | "delegate" | "handoff" | "schedule_task" | "parallel_group_open" | "parallel_group_close" | "human_approval" | "human_input" | "policy_check" | "anomaly_flag" | "sdk_diagnostic";
865
1287
  name: string;
866
1288
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
867
1289
  duration_ms?: number | undefined;
868
1290
  };
869
- subject: {
870
- regulatory_tags?: string[] | undefined;
871
- resource_urn?: string | undefined;
872
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
873
- };
874
- redaction_policy_version: string;
875
- prev_hash: string;
1291
+ prev_event_hash: string;
876
1292
  decision?: {
877
1293
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
878
1294
  outcome_label?: string | undefined;
@@ -881,6 +1297,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
881
1297
  policy_thresholds_crossed?: string[] | undefined;
882
1298
  reversed_by_event?: string | undefined;
883
1299
  } | undefined;
1300
+ environment?: "production" | "staging" | "development" | undefined;
1301
+ labels?: Record<string, string> | undefined;
1302
+ regulatory_scope_version?: string | undefined;
1303
+ parallel_group_id?: string | undefined;
1304
+ subject?: {
1305
+ regulatory_tags?: string[] | undefined;
1306
+ resource_urn?: string | undefined;
1307
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
1308
+ } | undefined;
884
1309
  model_ref?: {
885
1310
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
886
1311
  model_id: string;
@@ -890,6 +1315,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
890
1315
  input_tokens?: number | undefined;
891
1316
  output_tokens?: number | undefined;
892
1317
  temperature?: number | undefined;
1318
+ streaming?: boolean | undefined;
1319
+ } | undefined;
1320
+ suspension_details?: {
1321
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
1322
+ expected_resumer?: string | undefined;
1323
+ expected_resume_by?: string | undefined;
1324
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
1325
+ framework_signal?: {
1326
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
1327
+ signal_name?: string | undefined;
1328
+ signal_payload_hash?: string | undefined;
1329
+ } | undefined;
1330
+ } | undefined;
1331
+ resume_details?: {
1332
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
1333
+ resumer_principal?: string | undefined;
1334
+ suspension_duration_seconds?: number | undefined;
1335
+ suspension_started_event_id?: string | undefined;
1336
+ } | undefined;
1337
+ delegation_details?: {
1338
+ delegated_run_id: string;
1339
+ delegated_agent_identity: string;
1340
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
1341
+ wait_for_completion?: boolean | undefined;
1342
+ } | undefined;
1343
+ handoff_details?: {
1344
+ target_run_id: string;
1345
+ target_agent_identity: string;
1346
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
1347
+ handoff_reason?: string | undefined;
893
1348
  } | undefined;
894
1349
  payload_ref?: {
895
1350
  sha256: string;
@@ -900,21 +1355,39 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
900
1355
  data_key_wrapped: string;
901
1356
  kms_key_arn?: string | undefined;
902
1357
  };
903
- content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | undefined;
1358
+ content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
904
1359
  redaction_applied?: {
905
1360
  redacted_classes?: string[] | undefined;
906
1361
  tokenized_classes?: string[] | undefined;
907
1362
  classifier_version?: string | undefined;
908
1363
  } | undefined;
909
1364
  } | undefined;
910
- regulatory_scope_version?: string | undefined;
1365
+ otel_attributes?: {
1366
+ gen_ai_system?: string | undefined;
1367
+ gen_ai_operation_name?: string | undefined;
1368
+ gen_ai_provider_name?: string | undefined;
1369
+ gen_ai_request_model?: string | undefined;
1370
+ gen_ai_response_model?: string | undefined;
1371
+ gen_ai_request_temperature?: number | undefined;
1372
+ gen_ai_request_top_p?: number | undefined;
1373
+ gen_ai_request_max_tokens?: number | undefined;
1374
+ gen_ai_response_id?: string | undefined;
1375
+ gen_ai_response_finish_reasons?: string[] | undefined;
1376
+ gen_ai_usage_input_tokens?: number | undefined;
1377
+ gen_ai_usage_output_tokens?: number | undefined;
1378
+ gen_ai_tool_name?: string | undefined;
1379
+ gen_ai_tool_call_id?: string | undefined;
1380
+ gen_ai_agent_id?: string | undefined;
1381
+ gen_ai_agent_name?: string | undefined;
1382
+ gen_ai_agent_description?: string | undefined;
1383
+ gen_ai_conversation_id?: string | undefined;
1384
+ extra?: Record<string, string | number | boolean> | undefined;
1385
+ } | undefined;
911
1386
  anomaly_flags?: {
912
- code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning";
1387
+ code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
913
1388
  severity: "info" | "warning" | "error" | "critical";
914
1389
  detail?: string | undefined;
915
1390
  }[] | undefined;
916
- environment?: "production" | "staging" | "development" | undefined;
917
- labels?: Record<string, string> | undefined;
918
1391
  merkle_inclusion?: {
919
1392
  manifest_uri: string;
920
1393
  leaf_index: number;