@runfile-ai/schemas 0.1.2 → 0.4.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.
Files changed (16) hide show
  1. package/dist/event.d.ts +978 -122
  2. package/dist/event.d.ts.map +1 -1
  3. package/dist/event.js +269 -18
  4. package/dist/event.js.map +1 -1
  5. package/dist/evidence.d.ts +624 -126
  6. package/dist/evidence.d.ts.map +1 -1
  7. package/dist/ingest.d.ts +5111 -360
  8. package/dist/ingest.d.ts.map +1 -1
  9. package/dist/ingest.js +155 -24
  10. package/dist/ingest.js.map +1 -1
  11. package/dist/vault.d.ts +6 -6
  12. package/generated/json-schema/event.json +692 -44
  13. package/generated/json-schema/evidence.json +291 -14
  14. package/generated/json-schema/ingest.json +758 -96
  15. package/generated/json-schema/vault.json +17 -1
  16. package/package.json +1 -1
package/dist/evidence.d.ts CHANGED
@@ -26,28 +26,34 @@ 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>;
32
+ segment_index: z.ZodNumber;
33
+ local_seq: z.ZodNumber;
31
34
  captured_at: z.ZodString;
32
35
  received_at: z.ZodString;
33
36
  wall_clock_source: z.ZodEnum<["aws_time_sync", "ntp", "host_system", "unknown"]>;
34
37
  sdk: z.ZodObject<{
35
38
  name: z.ZodEnum<["runfile-py", "@runfile/sdk"]>;
36
39
  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"]>;
40
+ 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
41
  framework_version: z.ZodOptional<z.ZodString>;
42
+ adapter: z.ZodOptional<z.ZodString>;
39
43
  host: z.ZodOptional<z.ZodString>;
40
44
  }, "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";
45
+ 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
46
  name: "runfile-py" | "@runfile/sdk";
43
47
  version: string;
44
48
  framework_version?: string | undefined;
49
+ adapter?: string | undefined;
45
50
  host?: string | undefined;
46
51
  }, {
47
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
52
+ 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
53
  name: "runfile-py" | "@runfile/sdk";
49
54
  version: string;
50
55
  framework_version?: string | undefined;
56
+ adapter?: string | undefined;
51
57
  host?: string | undefined;
52
58
  }>;
53
59
  actor: z.ZodEffects<z.ZodObject<{
@@ -87,34 +93,34 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
87
93
  tool_version_hash?: string | undefined;
88
94
  }>;
89
95
  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"]>;
96
+ 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
97
  name: z.ZodString;
92
98
  outcome: z.ZodOptional<z.ZodEnum<["success", "failure", "partial", "timeout", "cancelled"]>>;
93
99
  duration_ms: z.ZodOptional<z.ZodNumber>;
94
100
  }, "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";
101
+ 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
102
  name: string;
97
103
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
98
104
  duration_ms?: number | undefined;
99
105
  }, {
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";
106
+ 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
107
  name: string;
102
108
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
103
109
  duration_ms?: number | undefined;
104
110
  }>;
105
- subject: z.ZodObject<{
111
+ subject: z.ZodOptional<z.ZodObject<{
106
112
  resource_urn: z.ZodOptional<z.ZodString>;
107
- data_classification: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci"]>>;
113
+ data_classification: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci", "audit_of_audit"]>>;
108
114
  regulatory_tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
109
115
  }, "strict", z.ZodTypeAny, {
110
116
  regulatory_tags?: string[] | undefined;
111
117
  resource_urn?: string | undefined;
112
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
118
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
113
119
  }, {
114
120
  regulatory_tags?: string[] | undefined;
115
121
  resource_urn?: string | undefined;
116
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
117
- }>;
122
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
123
+ }>>;
118
124
  model_ref: z.ZodOptional<z.ZodObject<{
119
125
  provider: z.ZodEnum<["anthropic", "openai", "google", "aws_bedrock", "azure_openai", "ollama", "self_hosted", "other"]>;
120
126
  model_id: z.ZodString;
@@ -124,6 +130,7 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
124
130
  input_tokens: z.ZodOptional<z.ZodNumber>;
125
131
  output_tokens: z.ZodOptional<z.ZodNumber>;
126
132
  temperature: z.ZodOptional<z.ZodNumber>;
133
+ streaming: z.ZodOptional<z.ZodBoolean>;
127
134
  }, "strict", z.ZodTypeAny, {
128
135
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
129
136
  model_id: string;
@@ -133,6 +140,7 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
133
140
  input_tokens?: number | undefined;
134
141
  output_tokens?: number | undefined;
135
142
  temperature?: number | undefined;
143
+ streaming?: boolean | undefined;
136
144
  }, {
137
145
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
138
146
  model_id: string;
@@ -142,6 +150,7 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
142
150
  input_tokens?: number | undefined;
143
151
  output_tokens?: number | undefined;
144
152
  temperature?: number | undefined;
153
+ streaming?: boolean | undefined;
145
154
  }>>;
146
155
  decision: z.ZodOptional<z.ZodObject<{
147
156
  outcome: z.ZodEnum<["approved", "denied", "escalated", "deferred", "no_action", "custom"]>;
@@ -165,6 +174,93 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
165
174
  policy_thresholds_crossed?: string[] | undefined;
166
175
  reversed_by_event?: string | undefined;
167
176
  }>>;
177
+ suspension_details: z.ZodOptional<z.ZodObject<{
178
+ reason: z.ZodEnum<["awaiting_human_approval", "awaiting_human_input", "awaiting_webhook", "awaiting_schedule", "awaiting_external_system", "awaiting_subagent", "other"]>;
179
+ expected_resumer: z.ZodOptional<z.ZodString>;
180
+ expected_resume_by: z.ZodOptional<z.ZodString>;
181
+ detection_source: z.ZodOptional<z.ZodEnum<["framework_inferred", "customer_explicit", "derived"]>>;
182
+ framework_signal: z.ZodOptional<z.ZodObject<{
183
+ framework: z.ZodOptional<z.ZodEnum<["langgraph", "openai_agents", "claude_agent_sdk", "vercel_ai_sdk", "mcp", "manual", "otel"]>>;
184
+ signal_name: z.ZodOptional<z.ZodString>;
185
+ signal_payload_hash: z.ZodOptional<z.ZodString>;
186
+ }, "strict", z.ZodTypeAny, {
187
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
188
+ signal_name?: string | undefined;
189
+ signal_payload_hash?: string | undefined;
190
+ }, {
191
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
192
+ signal_name?: string | undefined;
193
+ signal_payload_hash?: string | undefined;
194
+ }>>;
195
+ }, "strict", z.ZodTypeAny, {
196
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
197
+ expected_resumer?: string | undefined;
198
+ expected_resume_by?: string | undefined;
199
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
200
+ framework_signal?: {
201
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
202
+ signal_name?: string | undefined;
203
+ signal_payload_hash?: string | undefined;
204
+ } | undefined;
205
+ }, {
206
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
207
+ expected_resumer?: string | undefined;
208
+ expected_resume_by?: string | undefined;
209
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
210
+ framework_signal?: {
211
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
212
+ signal_name?: string | undefined;
213
+ signal_payload_hash?: string | undefined;
214
+ } | undefined;
215
+ }>>;
216
+ resume_details: z.ZodOptional<z.ZodObject<{
217
+ triggered_by: z.ZodEnum<["human_approval_granted", "human_input_received", "webhook_received", "schedule_fired", "external_system_response", "subagent_completed", "manual_resume", "other"]>;
218
+ resumer_principal: z.ZodOptional<z.ZodString>;
219
+ suspension_duration_seconds: z.ZodOptional<z.ZodNumber>;
220
+ suspension_started_event_id: z.ZodOptional<z.ZodString>;
221
+ }, "strict", z.ZodTypeAny, {
222
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
223
+ resumer_principal?: string | undefined;
224
+ suspension_duration_seconds?: number | undefined;
225
+ suspension_started_event_id?: string | undefined;
226
+ }, {
227
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
228
+ resumer_principal?: string | undefined;
229
+ suspension_duration_seconds?: number | undefined;
230
+ suspension_started_event_id?: string | undefined;
231
+ }>>;
232
+ delegation_details: z.ZodOptional<z.ZodObject<{
233
+ delegated_run_id: z.ZodString;
234
+ delegated_agent_identity: z.ZodString;
235
+ wait_for_completion: z.ZodOptional<z.ZodBoolean>;
236
+ framework_signal: z.ZodOptional<z.ZodEnum<["langgraph_subgraph", "openai_agents_as_tool", "claude_agent_sdk_subagent", "manual", "other"]>>;
237
+ }, "strict", z.ZodTypeAny, {
238
+ delegated_run_id: string;
239
+ delegated_agent_identity: string;
240
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
241
+ wait_for_completion?: boolean | undefined;
242
+ }, {
243
+ delegated_run_id: string;
244
+ delegated_agent_identity: string;
245
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
246
+ wait_for_completion?: boolean | undefined;
247
+ }>>;
248
+ handoff_details: z.ZodOptional<z.ZodObject<{
249
+ target_run_id: z.ZodString;
250
+ target_agent_identity: z.ZodString;
251
+ handoff_reason: z.ZodOptional<z.ZodString>;
252
+ framework_signal: z.ZodOptional<z.ZodEnum<["openai_agents_handoff", "langgraph_explicit", "manual", "other"]>>;
253
+ }, "strict", z.ZodTypeAny, {
254
+ target_run_id: string;
255
+ target_agent_identity: string;
256
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
257
+ handoff_reason?: string | undefined;
258
+ }, {
259
+ target_run_id: string;
260
+ target_agent_identity: string;
261
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
262
+ handoff_reason?: string | undefined;
263
+ }>>;
168
264
  payload_ref: z.ZodOptional<z.ZodObject<{
169
265
  s3_uri: z.ZodString;
170
266
  sha256: z.ZodString;
@@ -172,17 +268,20 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
172
268
  encryption: z.ZodObject<{
173
269
  algorithm: z.ZodLiteral<"aes-256-gcm">;
174
270
  data_key_wrapped: z.ZodString;
175
- kms_key_arn: z.ZodOptional<z.ZodString>;
271
+ key_id: z.ZodOptional<z.ZodString>;
272
+ nonce: z.ZodString;
176
273
  }, "strict", z.ZodTypeAny, {
177
274
  algorithm: "aes-256-gcm";
178
275
  data_key_wrapped: string;
179
- kms_key_arn?: string | undefined;
276
+ nonce: string;
277
+ key_id?: string | undefined;
180
278
  }, {
181
279
  algorithm: "aes-256-gcm";
182
280
  data_key_wrapped: string;
183
- kms_key_arn?: string | undefined;
281
+ nonce: string;
282
+ key_id?: string | undefined;
184
283
  }>;
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"]>>;
284
+ 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
285
  redaction_applied: z.ZodOptional<z.ZodObject<{
187
286
  redacted_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
188
287
  tokenized_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -203,9 +302,10 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
203
302
  encryption: {
204
303
  algorithm: "aes-256-gcm";
205
304
  data_key_wrapped: string;
206
- kms_key_arn?: string | undefined;
305
+ nonce: string;
306
+ key_id?: string | undefined;
207
307
  };
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;
308
+ 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
309
  redaction_applied?: {
210
310
  redacted_classes?: string[] | undefined;
211
311
  tokenized_classes?: string[] | undefined;
@@ -218,33 +318,95 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
218
318
  encryption: {
219
319
  algorithm: "aes-256-gcm";
220
320
  data_key_wrapped: string;
221
- kms_key_arn?: string | undefined;
321
+ nonce: string;
322
+ key_id?: string | undefined;
222
323
  };
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;
324
+ 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
325
  redaction_applied?: {
225
326
  redacted_classes?: string[] | undefined;
226
327
  tokenized_classes?: string[] | undefined;
227
328
  classifier_version?: string | undefined;
228
329
  } | undefined;
229
330
  }>>;
331
+ otel_attributes: z.ZodOptional<z.ZodObject<{
332
+ gen_ai_system: z.ZodOptional<z.ZodString>;
333
+ gen_ai_operation_name: z.ZodOptional<z.ZodString>;
334
+ gen_ai_provider_name: z.ZodOptional<z.ZodString>;
335
+ gen_ai_request_model: z.ZodOptional<z.ZodString>;
336
+ gen_ai_response_model: z.ZodOptional<z.ZodString>;
337
+ gen_ai_request_temperature: z.ZodOptional<z.ZodNumber>;
338
+ gen_ai_request_top_p: z.ZodOptional<z.ZodNumber>;
339
+ gen_ai_request_max_tokens: z.ZodOptional<z.ZodNumber>;
340
+ gen_ai_response_id: z.ZodOptional<z.ZodString>;
341
+ gen_ai_response_finish_reasons: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
342
+ gen_ai_usage_input_tokens: z.ZodOptional<z.ZodNumber>;
343
+ gen_ai_usage_output_tokens: z.ZodOptional<z.ZodNumber>;
344
+ gen_ai_tool_name: z.ZodOptional<z.ZodString>;
345
+ gen_ai_tool_call_id: z.ZodOptional<z.ZodString>;
346
+ gen_ai_agent_id: z.ZodOptional<z.ZodString>;
347
+ gen_ai_agent_name: z.ZodOptional<z.ZodString>;
348
+ gen_ai_agent_description: z.ZodOptional<z.ZodString>;
349
+ gen_ai_conversation_id: z.ZodOptional<z.ZodString>;
350
+ extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
351
+ }, "strict", z.ZodTypeAny, {
352
+ gen_ai_system?: string | undefined;
353
+ gen_ai_operation_name?: string | undefined;
354
+ gen_ai_provider_name?: string | undefined;
355
+ gen_ai_request_model?: string | undefined;
356
+ gen_ai_response_model?: string | undefined;
357
+ gen_ai_request_temperature?: number | undefined;
358
+ gen_ai_request_top_p?: number | undefined;
359
+ gen_ai_request_max_tokens?: number | undefined;
360
+ gen_ai_response_id?: string | undefined;
361
+ gen_ai_response_finish_reasons?: string[] | undefined;
362
+ gen_ai_usage_input_tokens?: number | undefined;
363
+ gen_ai_usage_output_tokens?: number | undefined;
364
+ gen_ai_tool_name?: string | undefined;
365
+ gen_ai_tool_call_id?: string | undefined;
366
+ gen_ai_agent_id?: string | undefined;
367
+ gen_ai_agent_name?: string | undefined;
368
+ gen_ai_agent_description?: string | undefined;
369
+ gen_ai_conversation_id?: string | undefined;
370
+ extra?: Record<string, string | number | boolean> | undefined;
371
+ }, {
372
+ gen_ai_system?: string | undefined;
373
+ gen_ai_operation_name?: string | undefined;
374
+ gen_ai_provider_name?: string | undefined;
375
+ gen_ai_request_model?: string | undefined;
376
+ gen_ai_response_model?: string | undefined;
377
+ gen_ai_request_temperature?: number | undefined;
378
+ gen_ai_request_top_p?: number | undefined;
379
+ gen_ai_request_max_tokens?: number | undefined;
380
+ gen_ai_response_id?: string | undefined;
381
+ gen_ai_response_finish_reasons?: string[] | undefined;
382
+ gen_ai_usage_input_tokens?: number | undefined;
383
+ gen_ai_usage_output_tokens?: number | undefined;
384
+ gen_ai_tool_name?: string | undefined;
385
+ gen_ai_tool_call_id?: string | undefined;
386
+ gen_ai_agent_id?: string | undefined;
387
+ gen_ai_agent_name?: string | undefined;
388
+ gen_ai_agent_description?: string | undefined;
389
+ gen_ai_conversation_id?: string | undefined;
390
+ extra?: Record<string, string | number | boolean> | undefined;
391
+ }>>;
230
392
  redaction_policy_version: z.ZodString;
231
393
  regulatory_scope_version: z.ZodOptional<z.ZodString>;
232
394
  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"]>;
395
+ code: z.ZodEnum<["missing_ambient_context", "chain_break", "sequence_gap", "causality_violation", "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
396
  severity: z.ZodEnum<["info", "warning", "error", "critical"]>;
235
397
  detail: z.ZodOptional<z.ZodString>;
236
398
  }, "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";
399
+ code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "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
400
  severity: "info" | "warning" | "error" | "critical";
239
401
  detail?: string | undefined;
240
402
  }, {
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";
403
+ code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "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
404
  severity: "info" | "warning" | "error" | "critical";
243
405
  detail?: string | undefined;
244
406
  }>, "many">>;
245
407
  environment: z.ZodOptional<z.ZodEnum<["production", "staging", "development"]>>;
246
408
  labels: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>>;
247
- prev_hash: z.ZodString;
409
+ prev_event_hash: z.ZodString;
248
410
  event_hash: z.ZodString;
249
411
  merkle_inclusion: z.ZodOptional<z.ZodObject<{
250
412
  manifest_uri: z.ZodString;
@@ -261,19 +423,23 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
261
423
  }>>;
262
424
  }, "strict", z.ZodTypeAny, {
263
425
  event_hash: string;
264
- schema_version: string;
426
+ run_id: string;
265
427
  event_id: string;
428
+ schema_version: string;
266
429
  tenant_id: string;
267
- agent_run_id: string;
430
+ redaction_policy_version: string;
268
431
  parent_event_id: string | null;
432
+ segment_index: number;
433
+ local_seq: number;
269
434
  captured_at: string;
270
435
  received_at: string;
271
436
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
272
437
  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";
438
+ 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
439
  name: "runfile-py" | "@runfile/sdk";
275
440
  version: string;
276
441
  framework_version?: string | undefined;
442
+ adapter?: string | undefined;
277
443
  host?: string | undefined;
278
444
  };
279
445
  actor: {
@@ -285,18 +451,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
285
451
  tool_version_hash?: string | undefined;
286
452
  };
287
453
  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";
454
+ 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
455
  name: string;
290
456
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
291
457
  duration_ms?: number | undefined;
292
458
  };
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;
459
+ prev_event_hash: string;
300
460
  decision?: {
301
461
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
302
462
  outcome_label?: string | undefined;
@@ -305,6 +465,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
305
465
  policy_thresholds_crossed?: string[] | undefined;
306
466
  reversed_by_event?: string | undefined;
307
467
  } | undefined;
468
+ environment?: "production" | "staging" | "development" | undefined;
469
+ labels?: Record<string, string> | undefined;
470
+ regulatory_scope_version?: string | undefined;
471
+ parallel_group_id?: string | undefined;
472
+ subject?: {
473
+ regulatory_tags?: string[] | undefined;
474
+ resource_urn?: string | undefined;
475
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
476
+ } | undefined;
308
477
  model_ref?: {
309
478
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
310
479
  model_id: string;
@@ -314,6 +483,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
314
483
  input_tokens?: number | undefined;
315
484
  output_tokens?: number | undefined;
316
485
  temperature?: number | undefined;
486
+ streaming?: boolean | undefined;
487
+ } | undefined;
488
+ suspension_details?: {
489
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
490
+ expected_resumer?: string | undefined;
491
+ expected_resume_by?: string | undefined;
492
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
493
+ framework_signal?: {
494
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
495
+ signal_name?: string | undefined;
496
+ signal_payload_hash?: string | undefined;
497
+ } | undefined;
498
+ } | undefined;
499
+ resume_details?: {
500
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
501
+ resumer_principal?: string | undefined;
502
+ suspension_duration_seconds?: number | undefined;
503
+ suspension_started_event_id?: string | undefined;
504
+ } | undefined;
505
+ delegation_details?: {
506
+ delegated_run_id: string;
507
+ delegated_agent_identity: string;
508
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
509
+ wait_for_completion?: boolean | undefined;
510
+ } | undefined;
511
+ handoff_details?: {
512
+ target_run_id: string;
513
+ target_agent_identity: string;
514
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
515
+ handoff_reason?: string | undefined;
317
516
  } | undefined;
318
517
  payload_ref?: {
319
518
  sha256: string;
@@ -322,23 +521,42 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
322
521
  encryption: {
323
522
  algorithm: "aes-256-gcm";
324
523
  data_key_wrapped: string;
325
- kms_key_arn?: string | undefined;
524
+ nonce: string;
525
+ key_id?: string | undefined;
326
526
  };
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;
527
+ 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
528
  redaction_applied?: {
329
529
  redacted_classes?: string[] | undefined;
330
530
  tokenized_classes?: string[] | undefined;
331
531
  classifier_version?: string | undefined;
332
532
  } | undefined;
333
533
  } | undefined;
334
- regulatory_scope_version?: string | undefined;
534
+ otel_attributes?: {
535
+ gen_ai_system?: string | undefined;
536
+ gen_ai_operation_name?: string | undefined;
537
+ gen_ai_provider_name?: string | undefined;
538
+ gen_ai_request_model?: string | undefined;
539
+ gen_ai_response_model?: string | undefined;
540
+ gen_ai_request_temperature?: number | undefined;
541
+ gen_ai_request_top_p?: number | undefined;
542
+ gen_ai_request_max_tokens?: number | undefined;
543
+ gen_ai_response_id?: string | undefined;
544
+ gen_ai_response_finish_reasons?: string[] | undefined;
545
+ gen_ai_usage_input_tokens?: number | undefined;
546
+ gen_ai_usage_output_tokens?: number | undefined;
547
+ gen_ai_tool_name?: string | undefined;
548
+ gen_ai_tool_call_id?: string | undefined;
549
+ gen_ai_agent_id?: string | undefined;
550
+ gen_ai_agent_name?: string | undefined;
551
+ gen_ai_agent_description?: string | undefined;
552
+ gen_ai_conversation_id?: string | undefined;
553
+ extra?: Record<string, string | number | boolean> | undefined;
554
+ } | undefined;
335
555
  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";
556
+ code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "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
557
  severity: "info" | "warning" | "error" | "critical";
338
558
  detail?: string | undefined;
339
559
  }[] | undefined;
340
- environment?: "production" | "staging" | "development" | undefined;
341
- labels?: Record<string, string> | undefined;
342
560
  merkle_inclusion?: {
343
561
  manifest_uri: string;
344
562
  leaf_index: number;
@@ -346,19 +564,23 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
346
564
  } | undefined;
347
565
  }, {
348
566
  event_hash: string;
349
- schema_version: string;
567
+ run_id: string;
350
568
  event_id: string;
569
+ schema_version: string;
351
570
  tenant_id: string;
352
- agent_run_id: string;
571
+ redaction_policy_version: string;
353
572
  parent_event_id: string | null;
573
+ segment_index: number;
574
+ local_seq: number;
354
575
  captured_at: string;
355
576
  received_at: string;
356
577
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
357
578
  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";
579
+ 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
580
  name: "runfile-py" | "@runfile/sdk";
360
581
  version: string;
361
582
  framework_version?: string | undefined;
583
+ adapter?: string | undefined;
362
584
  host?: string | undefined;
363
585
  };
364
586
  actor: {
@@ -370,18 +592,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
370
592
  tool_version_hash?: string | undefined;
371
593
  };
372
594
  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";
595
+ 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
596
  name: string;
375
597
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
376
598
  duration_ms?: number | undefined;
377
599
  };
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;
600
+ prev_event_hash: string;
385
601
  decision?: {
386
602
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
387
603
  outcome_label?: string | undefined;
@@ -390,6 +606,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
390
606
  policy_thresholds_crossed?: string[] | undefined;
391
607
  reversed_by_event?: string | undefined;
392
608
  } | undefined;
609
+ environment?: "production" | "staging" | "development" | undefined;
610
+ labels?: Record<string, string> | undefined;
611
+ regulatory_scope_version?: string | undefined;
612
+ parallel_group_id?: string | undefined;
613
+ subject?: {
614
+ regulatory_tags?: string[] | undefined;
615
+ resource_urn?: string | undefined;
616
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
617
+ } | undefined;
393
618
  model_ref?: {
394
619
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
395
620
  model_id: string;
@@ -399,6 +624,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
399
624
  input_tokens?: number | undefined;
400
625
  output_tokens?: number | undefined;
401
626
  temperature?: number | undefined;
627
+ streaming?: boolean | undefined;
628
+ } | undefined;
629
+ suspension_details?: {
630
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
631
+ expected_resumer?: string | undefined;
632
+ expected_resume_by?: string | undefined;
633
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
634
+ framework_signal?: {
635
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
636
+ signal_name?: string | undefined;
637
+ signal_payload_hash?: string | undefined;
638
+ } | undefined;
639
+ } | undefined;
640
+ resume_details?: {
641
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
642
+ resumer_principal?: string | undefined;
643
+ suspension_duration_seconds?: number | undefined;
644
+ suspension_started_event_id?: string | undefined;
645
+ } | undefined;
646
+ delegation_details?: {
647
+ delegated_run_id: string;
648
+ delegated_agent_identity: string;
649
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
650
+ wait_for_completion?: boolean | undefined;
651
+ } | undefined;
652
+ handoff_details?: {
653
+ target_run_id: string;
654
+ target_agent_identity: string;
655
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
656
+ handoff_reason?: string | undefined;
402
657
  } | undefined;
403
658
  payload_ref?: {
404
659
  sha256: string;
@@ -407,23 +662,42 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
407
662
  encryption: {
408
663
  algorithm: "aes-256-gcm";
409
664
  data_key_wrapped: string;
410
- kms_key_arn?: string | undefined;
665
+ nonce: string;
666
+ key_id?: string | undefined;
411
667
  };
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;
668
+ 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
669
  redaction_applied?: {
414
670
  redacted_classes?: string[] | undefined;
415
671
  tokenized_classes?: string[] | undefined;
416
672
  classifier_version?: string | undefined;
417
673
  } | undefined;
418
674
  } | undefined;
419
- regulatory_scope_version?: string | undefined;
675
+ otel_attributes?: {
676
+ gen_ai_system?: string | undefined;
677
+ gen_ai_operation_name?: string | undefined;
678
+ gen_ai_provider_name?: string | undefined;
679
+ gen_ai_request_model?: string | undefined;
680
+ gen_ai_response_model?: string | undefined;
681
+ gen_ai_request_temperature?: number | undefined;
682
+ gen_ai_request_top_p?: number | undefined;
683
+ gen_ai_request_max_tokens?: number | undefined;
684
+ gen_ai_response_id?: string | undefined;
685
+ gen_ai_response_finish_reasons?: string[] | undefined;
686
+ gen_ai_usage_input_tokens?: number | undefined;
687
+ gen_ai_usage_output_tokens?: number | undefined;
688
+ gen_ai_tool_name?: string | undefined;
689
+ gen_ai_tool_call_id?: string | undefined;
690
+ gen_ai_agent_id?: string | undefined;
691
+ gen_ai_agent_name?: string | undefined;
692
+ gen_ai_agent_description?: string | undefined;
693
+ gen_ai_conversation_id?: string | undefined;
694
+ extra?: Record<string, string | number | boolean> | undefined;
695
+ } | undefined;
420
696
  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";
697
+ code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "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
698
  severity: "info" | "warning" | "error" | "critical";
423
699
  detail?: string | undefined;
424
700
  }[] | undefined;
425
- environment?: "production" | "staging" | "development" | undefined;
426
- labels?: Record<string, string> | undefined;
427
701
  merkle_inclusion?: {
428
702
  manifest_uri: string;
429
703
  leaf_index: number;
@@ -431,19 +705,23 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
431
705
  } | undefined;
432
706
  }>, {
433
707
  event_hash: string;
434
- schema_version: string;
708
+ run_id: string;
435
709
  event_id: string;
710
+ schema_version: string;
436
711
  tenant_id: string;
437
- agent_run_id: string;
712
+ redaction_policy_version: string;
438
713
  parent_event_id: string | null;
714
+ segment_index: number;
715
+ local_seq: number;
439
716
  captured_at: string;
440
717
  received_at: string;
441
718
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
442
719
  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";
720
+ 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
721
  name: "runfile-py" | "@runfile/sdk";
445
722
  version: string;
446
723
  framework_version?: string | undefined;
724
+ adapter?: string | undefined;
447
725
  host?: string | undefined;
448
726
  };
449
727
  actor: {
@@ -455,18 +733,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
455
733
  tool_version_hash?: string | undefined;
456
734
  };
457
735
  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";
736
+ 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
737
  name: string;
460
738
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
461
739
  duration_ms?: number | undefined;
462
740
  };
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;
741
+ prev_event_hash: string;
470
742
  decision?: {
471
743
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
472
744
  outcome_label?: string | undefined;
@@ -475,6 +747,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
475
747
  policy_thresholds_crossed?: string[] | undefined;
476
748
  reversed_by_event?: string | undefined;
477
749
  } | undefined;
750
+ environment?: "production" | "staging" | "development" | undefined;
751
+ labels?: Record<string, string> | undefined;
752
+ regulatory_scope_version?: string | undefined;
753
+ parallel_group_id?: string | undefined;
754
+ subject?: {
755
+ regulatory_tags?: string[] | undefined;
756
+ resource_urn?: string | undefined;
757
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
758
+ } | undefined;
478
759
  model_ref?: {
479
760
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
480
761
  model_id: string;
@@ -484,6 +765,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
484
765
  input_tokens?: number | undefined;
485
766
  output_tokens?: number | undefined;
486
767
  temperature?: number | undefined;
768
+ streaming?: boolean | undefined;
769
+ } | undefined;
770
+ suspension_details?: {
771
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
772
+ expected_resumer?: string | undefined;
773
+ expected_resume_by?: string | undefined;
774
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
775
+ framework_signal?: {
776
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
777
+ signal_name?: string | undefined;
778
+ signal_payload_hash?: string | undefined;
779
+ } | undefined;
780
+ } | undefined;
781
+ resume_details?: {
782
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
783
+ resumer_principal?: string | undefined;
784
+ suspension_duration_seconds?: number | undefined;
785
+ suspension_started_event_id?: string | undefined;
786
+ } | undefined;
787
+ delegation_details?: {
788
+ delegated_run_id: string;
789
+ delegated_agent_identity: string;
790
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
791
+ wait_for_completion?: boolean | undefined;
792
+ } | undefined;
793
+ handoff_details?: {
794
+ target_run_id: string;
795
+ target_agent_identity: string;
796
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
797
+ handoff_reason?: string | undefined;
487
798
  } | undefined;
488
799
  payload_ref?: {
489
800
  sha256: string;
@@ -492,23 +803,42 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
492
803
  encryption: {
493
804
  algorithm: "aes-256-gcm";
494
805
  data_key_wrapped: string;
495
- kms_key_arn?: string | undefined;
806
+ nonce: string;
807
+ key_id?: string | undefined;
496
808
  };
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;
809
+ 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
810
  redaction_applied?: {
499
811
  redacted_classes?: string[] | undefined;
500
812
  tokenized_classes?: string[] | undefined;
501
813
  classifier_version?: string | undefined;
502
814
  } | undefined;
503
815
  } | undefined;
504
- regulatory_scope_version?: string | undefined;
816
+ otel_attributes?: {
817
+ gen_ai_system?: string | undefined;
818
+ gen_ai_operation_name?: string | undefined;
819
+ gen_ai_provider_name?: string | undefined;
820
+ gen_ai_request_model?: string | undefined;
821
+ gen_ai_response_model?: string | undefined;
822
+ gen_ai_request_temperature?: number | undefined;
823
+ gen_ai_request_top_p?: number | undefined;
824
+ gen_ai_request_max_tokens?: number | undefined;
825
+ gen_ai_response_id?: string | undefined;
826
+ gen_ai_response_finish_reasons?: string[] | undefined;
827
+ gen_ai_usage_input_tokens?: number | undefined;
828
+ gen_ai_usage_output_tokens?: number | undefined;
829
+ gen_ai_tool_name?: string | undefined;
830
+ gen_ai_tool_call_id?: string | undefined;
831
+ gen_ai_agent_id?: string | undefined;
832
+ gen_ai_agent_name?: string | undefined;
833
+ gen_ai_agent_description?: string | undefined;
834
+ gen_ai_conversation_id?: string | undefined;
835
+ extra?: Record<string, string | number | boolean> | undefined;
836
+ } | undefined;
505
837
  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";
838
+ code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "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
839
  severity: "info" | "warning" | "error" | "critical";
508
840
  detail?: string | undefined;
509
841
  }[] | undefined;
510
- environment?: "production" | "staging" | "development" | undefined;
511
- labels?: Record<string, string> | undefined;
512
842
  merkle_inclusion?: {
513
843
  manifest_uri: string;
514
844
  leaf_index: number;
@@ -516,19 +846,23 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
516
846
  } | undefined;
517
847
  }, {
518
848
  event_hash: string;
519
- schema_version: string;
849
+ run_id: string;
520
850
  event_id: string;
851
+ schema_version: string;
521
852
  tenant_id: string;
522
- agent_run_id: string;
853
+ redaction_policy_version: string;
523
854
  parent_event_id: string | null;
855
+ segment_index: number;
856
+ local_seq: number;
524
857
  captured_at: string;
525
858
  received_at: string;
526
859
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
527
860
  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";
861
+ 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
862
  name: "runfile-py" | "@runfile/sdk";
530
863
  version: string;
531
864
  framework_version?: string | undefined;
865
+ adapter?: string | undefined;
532
866
  host?: string | undefined;
533
867
  };
534
868
  actor: {
@@ -540,18 +874,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
540
874
  tool_version_hash?: string | undefined;
541
875
  };
542
876
  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";
877
+ 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
878
  name: string;
545
879
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
546
880
  duration_ms?: number | undefined;
547
881
  };
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;
882
+ prev_event_hash: string;
555
883
  decision?: {
556
884
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
557
885
  outcome_label?: string | undefined;
@@ -560,6 +888,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
560
888
  policy_thresholds_crossed?: string[] | undefined;
561
889
  reversed_by_event?: string | undefined;
562
890
  } | undefined;
891
+ environment?: "production" | "staging" | "development" | undefined;
892
+ labels?: Record<string, string> | undefined;
893
+ regulatory_scope_version?: string | undefined;
894
+ parallel_group_id?: string | undefined;
895
+ subject?: {
896
+ regulatory_tags?: string[] | undefined;
897
+ resource_urn?: string | undefined;
898
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
899
+ } | undefined;
563
900
  model_ref?: {
564
901
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
565
902
  model_id: string;
@@ -569,6 +906,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
569
906
  input_tokens?: number | undefined;
570
907
  output_tokens?: number | undefined;
571
908
  temperature?: number | undefined;
909
+ streaming?: boolean | undefined;
910
+ } | undefined;
911
+ suspension_details?: {
912
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
913
+ expected_resumer?: string | undefined;
914
+ expected_resume_by?: string | undefined;
915
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
916
+ framework_signal?: {
917
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
918
+ signal_name?: string | undefined;
919
+ signal_payload_hash?: string | undefined;
920
+ } | undefined;
921
+ } | undefined;
922
+ resume_details?: {
923
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
924
+ resumer_principal?: string | undefined;
925
+ suspension_duration_seconds?: number | undefined;
926
+ suspension_started_event_id?: string | undefined;
927
+ } | undefined;
928
+ delegation_details?: {
929
+ delegated_run_id: string;
930
+ delegated_agent_identity: string;
931
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
932
+ wait_for_completion?: boolean | undefined;
933
+ } | undefined;
934
+ handoff_details?: {
935
+ target_run_id: string;
936
+ target_agent_identity: string;
937
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
938
+ handoff_reason?: string | undefined;
572
939
  } | undefined;
573
940
  payload_ref?: {
574
941
  sha256: string;
@@ -577,23 +944,42 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
577
944
  encryption: {
578
945
  algorithm: "aes-256-gcm";
579
946
  data_key_wrapped: string;
580
- kms_key_arn?: string | undefined;
947
+ nonce: string;
948
+ key_id?: string | undefined;
581
949
  };
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;
950
+ 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
951
  redaction_applied?: {
584
952
  redacted_classes?: string[] | undefined;
585
953
  tokenized_classes?: string[] | undefined;
586
954
  classifier_version?: string | undefined;
587
955
  } | undefined;
588
956
  } | undefined;
589
- regulatory_scope_version?: string | undefined;
957
+ otel_attributes?: {
958
+ gen_ai_system?: string | undefined;
959
+ gen_ai_operation_name?: string | undefined;
960
+ gen_ai_provider_name?: string | undefined;
961
+ gen_ai_request_model?: string | undefined;
962
+ gen_ai_response_model?: string | undefined;
963
+ gen_ai_request_temperature?: number | undefined;
964
+ gen_ai_request_top_p?: number | undefined;
965
+ gen_ai_request_max_tokens?: number | undefined;
966
+ gen_ai_response_id?: string | undefined;
967
+ gen_ai_response_finish_reasons?: string[] | undefined;
968
+ gen_ai_usage_input_tokens?: number | undefined;
969
+ gen_ai_usage_output_tokens?: number | undefined;
970
+ gen_ai_tool_name?: string | undefined;
971
+ gen_ai_tool_call_id?: string | undefined;
972
+ gen_ai_agent_id?: string | undefined;
973
+ gen_ai_agent_name?: string | undefined;
974
+ gen_ai_agent_description?: string | undefined;
975
+ gen_ai_conversation_id?: string | undefined;
976
+ extra?: Record<string, string | number | boolean> | undefined;
977
+ } | undefined;
590
978
  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";
979
+ code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "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
980
  severity: "info" | "warning" | "error" | "critical";
593
981
  detail?: string | undefined;
594
982
  }[] | undefined;
595
- environment?: "production" | "staging" | "development" | undefined;
596
- labels?: Record<string, string> | undefined;
597
983
  merkle_inclusion?: {
598
984
  manifest_uri: string;
599
985
  leaf_index: number;
@@ -713,19 +1099,23 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
713
1099
  };
714
1100
  events: {
715
1101
  event_hash: string;
716
- schema_version: string;
1102
+ run_id: string;
717
1103
  event_id: string;
1104
+ schema_version: string;
718
1105
  tenant_id: string;
719
- agent_run_id: string;
1106
+ redaction_policy_version: string;
720
1107
  parent_event_id: string | null;
1108
+ segment_index: number;
1109
+ local_seq: number;
721
1110
  captured_at: string;
722
1111
  received_at: string;
723
1112
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
724
1113
  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";
1114
+ 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
1115
  name: "runfile-py" | "@runfile/sdk";
727
1116
  version: string;
728
1117
  framework_version?: string | undefined;
1118
+ adapter?: string | undefined;
729
1119
  host?: string | undefined;
730
1120
  };
731
1121
  actor: {
@@ -737,18 +1127,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
737
1127
  tool_version_hash?: string | undefined;
738
1128
  };
739
1129
  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";
1130
+ 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
1131
  name: string;
742
1132
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
743
1133
  duration_ms?: number | undefined;
744
1134
  };
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;
1135
+ prev_event_hash: string;
752
1136
  decision?: {
753
1137
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
754
1138
  outcome_label?: string | undefined;
@@ -757,6 +1141,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
757
1141
  policy_thresholds_crossed?: string[] | undefined;
758
1142
  reversed_by_event?: string | undefined;
759
1143
  } | undefined;
1144
+ environment?: "production" | "staging" | "development" | undefined;
1145
+ labels?: Record<string, string> | undefined;
1146
+ regulatory_scope_version?: string | undefined;
1147
+ parallel_group_id?: string | undefined;
1148
+ subject?: {
1149
+ regulatory_tags?: string[] | undefined;
1150
+ resource_urn?: string | undefined;
1151
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
1152
+ } | undefined;
760
1153
  model_ref?: {
761
1154
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
762
1155
  model_id: string;
@@ -766,6 +1159,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
766
1159
  input_tokens?: number | undefined;
767
1160
  output_tokens?: number | undefined;
768
1161
  temperature?: number | undefined;
1162
+ streaming?: boolean | undefined;
1163
+ } | undefined;
1164
+ suspension_details?: {
1165
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
1166
+ expected_resumer?: string | undefined;
1167
+ expected_resume_by?: string | undefined;
1168
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
1169
+ framework_signal?: {
1170
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
1171
+ signal_name?: string | undefined;
1172
+ signal_payload_hash?: string | undefined;
1173
+ } | undefined;
1174
+ } | undefined;
1175
+ resume_details?: {
1176
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
1177
+ resumer_principal?: string | undefined;
1178
+ suspension_duration_seconds?: number | undefined;
1179
+ suspension_started_event_id?: string | undefined;
1180
+ } | undefined;
1181
+ delegation_details?: {
1182
+ delegated_run_id: string;
1183
+ delegated_agent_identity: string;
1184
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
1185
+ wait_for_completion?: boolean | undefined;
1186
+ } | undefined;
1187
+ handoff_details?: {
1188
+ target_run_id: string;
1189
+ target_agent_identity: string;
1190
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
1191
+ handoff_reason?: string | undefined;
769
1192
  } | undefined;
770
1193
  payload_ref?: {
771
1194
  sha256: string;
@@ -774,23 +1197,42 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
774
1197
  encryption: {
775
1198
  algorithm: "aes-256-gcm";
776
1199
  data_key_wrapped: string;
777
- kms_key_arn?: string | undefined;
1200
+ nonce: string;
1201
+ key_id?: string | undefined;
778
1202
  };
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;
1203
+ 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
1204
  redaction_applied?: {
781
1205
  redacted_classes?: string[] | undefined;
782
1206
  tokenized_classes?: string[] | undefined;
783
1207
  classifier_version?: string | undefined;
784
1208
  } | undefined;
785
1209
  } | undefined;
786
- regulatory_scope_version?: string | undefined;
1210
+ otel_attributes?: {
1211
+ gen_ai_system?: string | undefined;
1212
+ gen_ai_operation_name?: string | undefined;
1213
+ gen_ai_provider_name?: string | undefined;
1214
+ gen_ai_request_model?: string | undefined;
1215
+ gen_ai_response_model?: string | undefined;
1216
+ gen_ai_request_temperature?: number | undefined;
1217
+ gen_ai_request_top_p?: number | undefined;
1218
+ gen_ai_request_max_tokens?: number | undefined;
1219
+ gen_ai_response_id?: string | undefined;
1220
+ gen_ai_response_finish_reasons?: string[] | undefined;
1221
+ gen_ai_usage_input_tokens?: number | undefined;
1222
+ gen_ai_usage_output_tokens?: number | undefined;
1223
+ gen_ai_tool_name?: string | undefined;
1224
+ gen_ai_tool_call_id?: string | undefined;
1225
+ gen_ai_agent_id?: string | undefined;
1226
+ gen_ai_agent_name?: string | undefined;
1227
+ gen_ai_agent_description?: string | undefined;
1228
+ gen_ai_conversation_id?: string | undefined;
1229
+ extra?: Record<string, string | number | boolean> | undefined;
1230
+ } | undefined;
787
1231
  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";
1232
+ code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "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
1233
  severity: "info" | "warning" | "error" | "critical";
790
1234
  detail?: string | undefined;
791
1235
  }[] | undefined;
792
- environment?: "production" | "staging" | "development" | undefined;
793
- labels?: Record<string, string> | undefined;
794
1236
  merkle_inclusion?: {
795
1237
  manifest_uri: string;
796
1238
  leaf_index: number;
@@ -837,19 +1279,23 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
837
1279
  };
838
1280
  events: {
839
1281
  event_hash: string;
840
- schema_version: string;
1282
+ run_id: string;
841
1283
  event_id: string;
1284
+ schema_version: string;
842
1285
  tenant_id: string;
843
- agent_run_id: string;
1286
+ redaction_policy_version: string;
844
1287
  parent_event_id: string | null;
1288
+ segment_index: number;
1289
+ local_seq: number;
845
1290
  captured_at: string;
846
1291
  received_at: string;
847
1292
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
848
1293
  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";
1294
+ 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
1295
  name: "runfile-py" | "@runfile/sdk";
851
1296
  version: string;
852
1297
  framework_version?: string | undefined;
1298
+ adapter?: string | undefined;
853
1299
  host?: string | undefined;
854
1300
  };
855
1301
  actor: {
@@ -861,18 +1307,12 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
861
1307
  tool_version_hash?: string | undefined;
862
1308
  };
863
1309
  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";
1310
+ 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
1311
  name: string;
866
1312
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
867
1313
  duration_ms?: number | undefined;
868
1314
  };
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;
1315
+ prev_event_hash: string;
876
1316
  decision?: {
877
1317
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
878
1318
  outcome_label?: string | undefined;
@@ -881,6 +1321,15 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
881
1321
  policy_thresholds_crossed?: string[] | undefined;
882
1322
  reversed_by_event?: string | undefined;
883
1323
  } | undefined;
1324
+ environment?: "production" | "staging" | "development" | undefined;
1325
+ labels?: Record<string, string> | undefined;
1326
+ regulatory_scope_version?: string | undefined;
1327
+ parallel_group_id?: string | undefined;
1328
+ subject?: {
1329
+ regulatory_tags?: string[] | undefined;
1330
+ resource_urn?: string | undefined;
1331
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
1332
+ } | undefined;
884
1333
  model_ref?: {
885
1334
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
886
1335
  model_id: string;
@@ -890,6 +1339,36 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
890
1339
  input_tokens?: number | undefined;
891
1340
  output_tokens?: number | undefined;
892
1341
  temperature?: number | undefined;
1342
+ streaming?: boolean | undefined;
1343
+ } | undefined;
1344
+ suspension_details?: {
1345
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
1346
+ expected_resumer?: string | undefined;
1347
+ expected_resume_by?: string | undefined;
1348
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
1349
+ framework_signal?: {
1350
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
1351
+ signal_name?: string | undefined;
1352
+ signal_payload_hash?: string | undefined;
1353
+ } | undefined;
1354
+ } | undefined;
1355
+ resume_details?: {
1356
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
1357
+ resumer_principal?: string | undefined;
1358
+ suspension_duration_seconds?: number | undefined;
1359
+ suspension_started_event_id?: string | undefined;
1360
+ } | undefined;
1361
+ delegation_details?: {
1362
+ delegated_run_id: string;
1363
+ delegated_agent_identity: string;
1364
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
1365
+ wait_for_completion?: boolean | undefined;
1366
+ } | undefined;
1367
+ handoff_details?: {
1368
+ target_run_id: string;
1369
+ target_agent_identity: string;
1370
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
1371
+ handoff_reason?: string | undefined;
893
1372
  } | undefined;
894
1373
  payload_ref?: {
895
1374
  sha256: string;
@@ -898,23 +1377,42 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
898
1377
  encryption: {
899
1378
  algorithm: "aes-256-gcm";
900
1379
  data_key_wrapped: string;
901
- kms_key_arn?: string | undefined;
1380
+ nonce: string;
1381
+ key_id?: string | undefined;
902
1382
  };
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;
1383
+ 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
1384
  redaction_applied?: {
905
1385
  redacted_classes?: string[] | undefined;
906
1386
  tokenized_classes?: string[] | undefined;
907
1387
  classifier_version?: string | undefined;
908
1388
  } | undefined;
909
1389
  } | undefined;
910
- regulatory_scope_version?: string | undefined;
1390
+ otel_attributes?: {
1391
+ gen_ai_system?: string | undefined;
1392
+ gen_ai_operation_name?: string | undefined;
1393
+ gen_ai_provider_name?: string | undefined;
1394
+ gen_ai_request_model?: string | undefined;
1395
+ gen_ai_response_model?: string | undefined;
1396
+ gen_ai_request_temperature?: number | undefined;
1397
+ gen_ai_request_top_p?: number | undefined;
1398
+ gen_ai_request_max_tokens?: number | undefined;
1399
+ gen_ai_response_id?: string | undefined;
1400
+ gen_ai_response_finish_reasons?: string[] | undefined;
1401
+ gen_ai_usage_input_tokens?: number | undefined;
1402
+ gen_ai_usage_output_tokens?: number | undefined;
1403
+ gen_ai_tool_name?: string | undefined;
1404
+ gen_ai_tool_call_id?: string | undefined;
1405
+ gen_ai_agent_id?: string | undefined;
1406
+ gen_ai_agent_name?: string | undefined;
1407
+ gen_ai_agent_description?: string | undefined;
1408
+ gen_ai_conversation_id?: string | undefined;
1409
+ extra?: Record<string, string | number | boolean> | undefined;
1410
+ } | undefined;
911
1411
  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";
1412
+ code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "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
1413
  severity: "info" | "warning" | "error" | "critical";
914
1414
  detail?: string | undefined;
915
1415
  }[] | undefined;
916
- environment?: "production" | "staging" | "development" | undefined;
917
- labels?: Record<string, string> | undefined;
918
1416
  merkle_inclusion?: {
919
1417
  manifest_uri: string;
920
1418
  leaf_index: number;