@runfile-ai/schemas 0.1.1 → 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.
Files changed (17) hide show
  1. package/README.md +4 -4
  2. package/dist/event.d.ts +931 -105
  3. package/dist/event.d.ts.map +1 -1
  4. package/dist/event.js +252 -14
  5. package/dist/event.js.map +1 -1
  6. package/dist/evidence.d.ts +588 -115
  7. package/dist/evidence.d.ts.map +1 -1
  8. package/dist/ingest.d.ts +4981 -335
  9. package/dist/ingest.d.ts.map +1 -1
  10. package/dist/ingest.js +153 -24
  11. package/dist/ingest.js.map +1 -1
  12. package/dist/vault.d.ts +6 -6
  13. package/generated/json-schema/event.json +670 -41
  14. package/generated/json-schema/evidence.json +269 -11
  15. package/generated/json-schema/ingest.json +738 -93
  16. package/generated/json-schema/vault.json +17 -1
  17. package/package.json +1 -1
package/dist/event.d.ts CHANGED
@@ -36,39 +36,39 @@ export declare const ActorSchema: z.ZodEffects<z.ZodObject<{
36
36
  tool_version_hash?: string | undefined;
37
37
  }>;
38
38
  export type Actor = z.infer<typeof ActorSchema>;
39
- export declare const ActionKindEnum: 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"]>;
39
+ export declare const ActionKindEnum: 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"]>;
40
40
  export type ActionKind = z.infer<typeof ActionKindEnum>;
41
41
  export declare const ActionOutcomeEnum: z.ZodEnum<["success", "failure", "partial", "timeout", "cancelled"]>;
42
42
  export declare const ActionSchema: z.ZodObject<{
43
- 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"]>;
43
+ 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"]>;
44
44
  name: z.ZodString;
45
45
  outcome: z.ZodOptional<z.ZodEnum<["success", "failure", "partial", "timeout", "cancelled"]>>;
46
46
  duration_ms: z.ZodOptional<z.ZodNumber>;
47
47
  }, "strict", z.ZodTypeAny, {
48
- 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";
48
+ 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";
49
49
  name: string;
50
50
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
51
51
  duration_ms?: number | undefined;
52
52
  }, {
53
- 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";
53
+ 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";
54
54
  name: string;
55
55
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
56
56
  duration_ms?: number | undefined;
57
57
  }>;
58
58
  export type Action = z.infer<typeof ActionSchema>;
59
- export declare const DataClassificationEnum: z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci"]>;
59
+ export declare const DataClassificationEnum: z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci", "audit_of_audit"]>;
60
60
  export declare const SubjectSchema: z.ZodObject<{
61
61
  resource_urn: z.ZodOptional<z.ZodString>;
62
- data_classification: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci"]>>;
62
+ data_classification: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci", "audit_of_audit"]>>;
63
63
  regulatory_tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
64
64
  }, "strict", z.ZodTypeAny, {
65
65
  regulatory_tags?: string[] | undefined;
66
66
  resource_urn?: string | undefined;
67
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
67
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
68
68
  }, {
69
69
  regulatory_tags?: string[] | undefined;
70
70
  resource_urn?: string | undefined;
71
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
71
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
72
72
  }>;
73
73
  export type Subject = z.infer<typeof SubjectSchema>;
74
74
  export declare const ModelProviderEnum: z.ZodEnum<["anthropic", "openai", "google", "aws_bedrock", "azure_openai", "ollama", "self_hosted", "other"]>;
@@ -81,6 +81,7 @@ export declare const ModelRefSchema: z.ZodObject<{
81
81
  input_tokens: z.ZodOptional<z.ZodNumber>;
82
82
  output_tokens: z.ZodOptional<z.ZodNumber>;
83
83
  temperature: z.ZodOptional<z.ZodNumber>;
84
+ streaming: z.ZodOptional<z.ZodBoolean>;
84
85
  }, "strict", z.ZodTypeAny, {
85
86
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
86
87
  model_id: string;
@@ -90,6 +91,7 @@ export declare const ModelRefSchema: z.ZodObject<{
90
91
  input_tokens?: number | undefined;
91
92
  output_tokens?: number | undefined;
92
93
  temperature?: number | undefined;
94
+ streaming?: boolean | undefined;
93
95
  }, {
94
96
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
95
97
  model_id: string;
@@ -99,6 +101,7 @@ export declare const ModelRefSchema: z.ZodObject<{
99
101
  input_tokens?: number | undefined;
100
102
  output_tokens?: number | undefined;
101
103
  temperature?: number | undefined;
104
+ streaming?: boolean | undefined;
102
105
  }>;
103
106
  export type ModelRef = z.infer<typeof ModelRefSchema>;
104
107
  export declare const DecisionOutcomeEnum: z.ZodEnum<["approved", "denied", "escalated", "deferred", "no_action", "custom"]>;
@@ -125,7 +128,118 @@ export declare const DecisionSchema: z.ZodObject<{
125
128
  reversed_by_event?: string | undefined;
126
129
  }>;
127
130
  export type Decision = z.infer<typeof DecisionSchema>;
128
- export declare const ContentTypeEnum: 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"]>;
131
+ export declare const SuspensionReasonEnum: z.ZodEnum<["awaiting_human_approval", "awaiting_human_input", "awaiting_webhook", "awaiting_schedule", "awaiting_external_system", "awaiting_subagent", "other"]>;
132
+ export declare const FrameworkEnum: z.ZodEnum<["langgraph", "openai_agents", "claude_agent_sdk", "vercel_ai_sdk", "mcp", "manual", "otel"]>;
133
+ export declare const FrameworkSignalSchema: z.ZodObject<{
134
+ framework: z.ZodOptional<z.ZodEnum<["langgraph", "openai_agents", "claude_agent_sdk", "vercel_ai_sdk", "mcp", "manual", "otel"]>>;
135
+ signal_name: z.ZodOptional<z.ZodString>;
136
+ signal_payload_hash: z.ZodOptional<z.ZodString>;
137
+ }, "strict", z.ZodTypeAny, {
138
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
139
+ signal_name?: string | undefined;
140
+ signal_payload_hash?: string | undefined;
141
+ }, {
142
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
143
+ signal_name?: string | undefined;
144
+ signal_payload_hash?: string | undefined;
145
+ }>;
146
+ export type FrameworkSignal = z.infer<typeof FrameworkSignalSchema>;
147
+ export declare const DetectionSourceEnum: z.ZodEnum<["framework_inferred", "customer_explicit", "derived"]>;
148
+ export declare const SuspensionDetailsSchema: z.ZodObject<{
149
+ reason: z.ZodEnum<["awaiting_human_approval", "awaiting_human_input", "awaiting_webhook", "awaiting_schedule", "awaiting_external_system", "awaiting_subagent", "other"]>;
150
+ expected_resumer: z.ZodOptional<z.ZodString>;
151
+ expected_resume_by: z.ZodOptional<z.ZodString>;
152
+ detection_source: z.ZodOptional<z.ZodEnum<["framework_inferred", "customer_explicit", "derived"]>>;
153
+ framework_signal: z.ZodOptional<z.ZodObject<{
154
+ framework: z.ZodOptional<z.ZodEnum<["langgraph", "openai_agents", "claude_agent_sdk", "vercel_ai_sdk", "mcp", "manual", "otel"]>>;
155
+ signal_name: z.ZodOptional<z.ZodString>;
156
+ signal_payload_hash: z.ZodOptional<z.ZodString>;
157
+ }, "strict", z.ZodTypeAny, {
158
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
159
+ signal_name?: string | undefined;
160
+ signal_payload_hash?: string | undefined;
161
+ }, {
162
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
163
+ signal_name?: string | undefined;
164
+ signal_payload_hash?: string | undefined;
165
+ }>>;
166
+ }, "strict", z.ZodTypeAny, {
167
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
168
+ expected_resumer?: string | undefined;
169
+ expected_resume_by?: string | undefined;
170
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
171
+ framework_signal?: {
172
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
173
+ signal_name?: string | undefined;
174
+ signal_payload_hash?: string | undefined;
175
+ } | undefined;
176
+ }, {
177
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
178
+ expected_resumer?: string | undefined;
179
+ expected_resume_by?: string | undefined;
180
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
181
+ framework_signal?: {
182
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
183
+ signal_name?: string | undefined;
184
+ signal_payload_hash?: string | undefined;
185
+ } | undefined;
186
+ }>;
187
+ export type SuspensionDetails = z.infer<typeof SuspensionDetailsSchema>;
188
+ export declare const ResumeTriggerEnum: z.ZodEnum<["human_approval_granted", "human_input_received", "webhook_received", "schedule_fired", "external_system_response", "subagent_completed", "manual_resume", "other"]>;
189
+ export declare const ResumeDetailsSchema: z.ZodObject<{
190
+ triggered_by: z.ZodEnum<["human_approval_granted", "human_input_received", "webhook_received", "schedule_fired", "external_system_response", "subagent_completed", "manual_resume", "other"]>;
191
+ resumer_principal: z.ZodOptional<z.ZodString>;
192
+ suspension_duration_seconds: z.ZodOptional<z.ZodNumber>;
193
+ suspension_started_event_id: z.ZodOptional<z.ZodString>;
194
+ }, "strict", z.ZodTypeAny, {
195
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
196
+ resumer_principal?: string | undefined;
197
+ suspension_duration_seconds?: number | undefined;
198
+ suspension_started_event_id?: string | undefined;
199
+ }, {
200
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
201
+ resumer_principal?: string | undefined;
202
+ suspension_duration_seconds?: number | undefined;
203
+ suspension_started_event_id?: string | undefined;
204
+ }>;
205
+ export type ResumeDetails = z.infer<typeof ResumeDetailsSchema>;
206
+ export declare const DelegationFrameworkSignalEnum: z.ZodEnum<["langgraph_subgraph", "openai_agents_as_tool", "claude_agent_sdk_subagent", "manual", "other"]>;
207
+ export declare const DelegationDetailsSchema: z.ZodObject<{
208
+ delegated_run_id: z.ZodString;
209
+ delegated_agent_identity: z.ZodString;
210
+ wait_for_completion: z.ZodOptional<z.ZodBoolean>;
211
+ framework_signal: z.ZodOptional<z.ZodEnum<["langgraph_subgraph", "openai_agents_as_tool", "claude_agent_sdk_subagent", "manual", "other"]>>;
212
+ }, "strict", z.ZodTypeAny, {
213
+ delegated_run_id: string;
214
+ delegated_agent_identity: string;
215
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
216
+ wait_for_completion?: boolean | undefined;
217
+ }, {
218
+ delegated_run_id: string;
219
+ delegated_agent_identity: string;
220
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
221
+ wait_for_completion?: boolean | undefined;
222
+ }>;
223
+ export type DelegationDetails = z.infer<typeof DelegationDetailsSchema>;
224
+ export declare const HandoffFrameworkSignalEnum: z.ZodEnum<["openai_agents_handoff", "langgraph_explicit", "manual", "other"]>;
225
+ export declare const HandoffDetailsSchema: z.ZodObject<{
226
+ target_run_id: z.ZodString;
227
+ target_agent_identity: z.ZodString;
228
+ handoff_reason: z.ZodOptional<z.ZodString>;
229
+ framework_signal: z.ZodOptional<z.ZodEnum<["openai_agents_handoff", "langgraph_explicit", "manual", "other"]>>;
230
+ }, "strict", z.ZodTypeAny, {
231
+ target_run_id: string;
232
+ target_agent_identity: string;
233
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
234
+ handoff_reason?: string | undefined;
235
+ }, {
236
+ target_run_id: string;
237
+ target_agent_identity: string;
238
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
239
+ handoff_reason?: string | undefined;
240
+ }>;
241
+ export type HandoffDetails = z.infer<typeof HandoffDetailsSchema>;
242
+ export declare const ContentTypeEnum: 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"]>;
129
243
  export declare const RedactionAppliedSchema: z.ZodObject<{
130
244
  redacted_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
131
245
  tokenized_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -171,7 +285,7 @@ export declare const PayloadRefSchema: z.ZodObject<{
171
285
  data_key_wrapped: string;
172
286
  kms_key_arn?: string | undefined;
173
287
  }>;
174
- 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"]>>;
288
+ 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"]>>;
175
289
  redaction_applied: z.ZodOptional<z.ZodObject<{
176
290
  redacted_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
177
291
  tokenized_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -194,7 +308,7 @@ export declare const PayloadRefSchema: z.ZodObject<{
194
308
  data_key_wrapped: string;
195
309
  kms_key_arn?: string | undefined;
196
310
  };
197
- 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;
311
+ 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;
198
312
  redaction_applied?: {
199
313
  redacted_classes?: string[] | undefined;
200
314
  tokenized_classes?: string[] | undefined;
@@ -209,7 +323,7 @@ export declare const PayloadRefSchema: z.ZodObject<{
209
323
  data_key_wrapped: string;
210
324
  kms_key_arn?: string | undefined;
211
325
  };
212
- 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;
326
+ 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;
213
327
  redaction_applied?: {
214
328
  redacted_classes?: string[] | undefined;
215
329
  tokenized_classes?: string[] | undefined;
@@ -217,42 +331,107 @@ export declare const PayloadRefSchema: z.ZodObject<{
217
331
  } | undefined;
218
332
  }>;
219
333
  export type PayloadRef = z.infer<typeof PayloadRefSchema>;
220
- export declare const AnomalyCodeEnum: 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"]>;
334
+ export declare const OtelAttributesSchema: z.ZodObject<{
335
+ gen_ai_system: z.ZodOptional<z.ZodString>;
336
+ gen_ai_operation_name: z.ZodOptional<z.ZodString>;
337
+ gen_ai_provider_name: z.ZodOptional<z.ZodString>;
338
+ gen_ai_request_model: z.ZodOptional<z.ZodString>;
339
+ gen_ai_response_model: z.ZodOptional<z.ZodString>;
340
+ gen_ai_request_temperature: z.ZodOptional<z.ZodNumber>;
341
+ gen_ai_request_top_p: z.ZodOptional<z.ZodNumber>;
342
+ gen_ai_request_max_tokens: z.ZodOptional<z.ZodNumber>;
343
+ gen_ai_response_id: z.ZodOptional<z.ZodString>;
344
+ gen_ai_response_finish_reasons: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
345
+ gen_ai_usage_input_tokens: z.ZodOptional<z.ZodNumber>;
346
+ gen_ai_usage_output_tokens: z.ZodOptional<z.ZodNumber>;
347
+ gen_ai_tool_name: z.ZodOptional<z.ZodString>;
348
+ gen_ai_tool_call_id: z.ZodOptional<z.ZodString>;
349
+ gen_ai_agent_id: z.ZodOptional<z.ZodString>;
350
+ gen_ai_agent_name: z.ZodOptional<z.ZodString>;
351
+ gen_ai_agent_description: z.ZodOptional<z.ZodString>;
352
+ gen_ai_conversation_id: z.ZodOptional<z.ZodString>;
353
+ extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
354
+ }, "strict", z.ZodTypeAny, {
355
+ gen_ai_system?: string | undefined;
356
+ gen_ai_operation_name?: string | undefined;
357
+ gen_ai_provider_name?: string | undefined;
358
+ gen_ai_request_model?: string | undefined;
359
+ gen_ai_response_model?: string | undefined;
360
+ gen_ai_request_temperature?: number | undefined;
361
+ gen_ai_request_top_p?: number | undefined;
362
+ gen_ai_request_max_tokens?: number | undefined;
363
+ gen_ai_response_id?: string | undefined;
364
+ gen_ai_response_finish_reasons?: string[] | undefined;
365
+ gen_ai_usage_input_tokens?: number | undefined;
366
+ gen_ai_usage_output_tokens?: number | undefined;
367
+ gen_ai_tool_name?: string | undefined;
368
+ gen_ai_tool_call_id?: string | undefined;
369
+ gen_ai_agent_id?: string | undefined;
370
+ gen_ai_agent_name?: string | undefined;
371
+ gen_ai_agent_description?: string | undefined;
372
+ gen_ai_conversation_id?: string | undefined;
373
+ extra?: Record<string, string | number | boolean> | undefined;
374
+ }, {
375
+ gen_ai_system?: string | undefined;
376
+ gen_ai_operation_name?: string | undefined;
377
+ gen_ai_provider_name?: string | undefined;
378
+ gen_ai_request_model?: string | undefined;
379
+ gen_ai_response_model?: string | undefined;
380
+ gen_ai_request_temperature?: number | undefined;
381
+ gen_ai_request_top_p?: number | undefined;
382
+ gen_ai_request_max_tokens?: number | undefined;
383
+ gen_ai_response_id?: string | undefined;
384
+ gen_ai_response_finish_reasons?: string[] | undefined;
385
+ gen_ai_usage_input_tokens?: number | undefined;
386
+ gen_ai_usage_output_tokens?: number | undefined;
387
+ gen_ai_tool_name?: string | undefined;
388
+ gen_ai_tool_call_id?: string | undefined;
389
+ gen_ai_agent_id?: string | undefined;
390
+ gen_ai_agent_name?: string | undefined;
391
+ gen_ai_agent_description?: string | undefined;
392
+ gen_ai_conversation_id?: string | undefined;
393
+ extra?: Record<string, string | number | boolean> | undefined;
394
+ }>;
395
+ export type OtelAttributes = z.infer<typeof OtelAttributesSchema>;
396
+ export declare const AnomalyCodeEnum: 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"]>;
221
397
  export declare const AnomalySeverityEnum: z.ZodEnum<["info", "warning", "error", "critical"]>;
222
398
  export declare const AnomalyFlagSchema: z.ZodObject<{
223
- 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"]>;
399
+ 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"]>;
224
400
  severity: z.ZodEnum<["info", "warning", "error", "critical"]>;
225
401
  detail: z.ZodOptional<z.ZodString>;
226
402
  }, "strict", z.ZodTypeAny, {
227
- 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" | "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";
228
404
  severity: "info" | "warning" | "error" | "critical";
229
405
  detail?: string | undefined;
230
406
  }, {
231
- 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";
407
+ 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";
232
408
  severity: "info" | "warning" | "error" | "critical";
233
409
  detail?: string | undefined;
234
410
  }>;
235
411
  export type AnomalyFlag = z.infer<typeof AnomalyFlagSchema>;
236
412
  export declare const WallClockSourceEnum: z.ZodEnum<["aws_time_sync", "ntp", "host_system", "unknown"]>;
237
413
  export declare const SdkNameEnum: z.ZodEnum<["runfile-py", "@runfile/sdk"]>;
238
- export declare const SdkFrameworkEnum: z.ZodEnum<["langgraph", "langgraph_js", "openai_agents", "openai_agents_js", "anthropic_claude", "anthropic_claude_js", "mastra", "vercel_ai_sdk", "mcp_client", "otel_generic", "manual"]>;
414
+ export declare const SdkFrameworkEnum: 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"]>;
239
415
  export declare const SdkMetadataSchema: z.ZodObject<{
240
416
  name: z.ZodEnum<["runfile-py", "@runfile/sdk"]>;
241
417
  version: z.ZodString;
242
- 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"]>;
418
+ 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"]>;
243
419
  framework_version: z.ZodOptional<z.ZodString>;
420
+ adapter: z.ZodOptional<z.ZodString>;
244
421
  host: z.ZodOptional<z.ZodString>;
245
422
  }, "strict", z.ZodTypeAny, {
246
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
423
+ 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";
247
424
  name: "runfile-py" | "@runfile/sdk";
248
425
  version: string;
249
426
  framework_version?: string | undefined;
427
+ adapter?: string | undefined;
250
428
  host?: string | undefined;
251
429
  }, {
252
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
430
+ 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";
253
431
  name: "runfile-py" | "@runfile/sdk";
254
432
  version: string;
255
433
  framework_version?: string | undefined;
434
+ adapter?: string | undefined;
256
435
  host?: string | undefined;
257
436
  }>;
258
437
  export type SdkMetadata = z.infer<typeof SdkMetadataSchema>;
@@ -273,13 +452,293 @@ export declare const MerkleInclusionSchema: z.ZodObject<{
273
452
  merkle_root: string;
274
453
  }>;
275
454
  export type MerkleInclusion = z.infer<typeof MerkleInclusionSchema>;
455
+ /** A typed pointer to a specific event in another run, used for inter-run links. */
456
+ export declare const RunReferenceSchema: z.ZodObject<{
457
+ run_id: z.ZodString;
458
+ event_id: z.ZodOptional<z.ZodString>;
459
+ }, "strict", z.ZodTypeAny, {
460
+ run_id: string;
461
+ event_id?: string | undefined;
462
+ }, {
463
+ run_id: string;
464
+ event_id?: string | undefined;
465
+ }>;
466
+ export type RunReference = z.infer<typeof RunReferenceSchema>;
467
+ export declare const RunLifecycleStateEnum: z.ZodEnum<["active", "awaiting_human", "awaiting_webhook", "awaiting_schedule", "ended"]>;
468
+ export type RunLifecycleState = z.infer<typeof RunLifecycleStateEnum>;
469
+ export declare const RunOutcomeEnum: z.ZodEnum<["success", "failure", "incomplete", "abandoned"]>;
470
+ export type RunOutcome = z.infer<typeof RunOutcomeEnum>;
471
+ export declare const SuspensionIntervalSchema: z.ZodObject<{
472
+ started: z.ZodString;
473
+ ended: z.ZodOptional<z.ZodNullable<z.ZodString>>;
474
+ reason: z.ZodEnum<["awaiting_human_approval", "awaiting_human_input", "awaiting_webhook", "awaiting_schedule", "awaiting_external_system", "awaiting_subagent", "other"]>;
475
+ trigger_event_id: z.ZodString;
476
+ resume_event_id: z.ZodOptional<z.ZodString>;
477
+ }, "strict", z.ZodTypeAny, {
478
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
479
+ started: string;
480
+ trigger_event_id: string;
481
+ ended?: string | null | undefined;
482
+ resume_event_id?: string | undefined;
483
+ }, {
484
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
485
+ started: string;
486
+ trigger_event_id: string;
487
+ ended?: string | null | undefined;
488
+ resume_event_id?: string | undefined;
489
+ }>;
490
+ export type SuspensionInterval = z.infer<typeof SuspensionIntervalSchema>;
276
491
  /**
277
- * RunfileEvent — the canonical event shape every service in the system reads, writes, or
278
- * reasons about. Hash-chained within `agent_run_id` and committed to a daily Merkle root.
492
+ * RunfileRun — a bounded operation owned by exactly one agent identity. Contains many
493
+ * events, may suspend/resume, and may be linked to other runs via delegation, handoff,
494
+ * scheduling, or conversation membership. The run record is a queryable materialisation
495
+ * built by the Event Processor from lifecycle events; it carries no hash fields and is
496
+ * not anchored in the Merkle tree (the run's *events* are).
497
+ */
498
+ export declare const RunfileRunSchema: z.ZodObject<{
499
+ schema_version: z.ZodString;
500
+ run_id: z.ZodString;
501
+ tenant_id: z.ZodString;
502
+ agent_identity: z.ZodString;
503
+ conversation_id: z.ZodOptional<z.ZodString>;
504
+ lifecycle_state: z.ZodEnum<["active", "awaiting_human", "awaiting_webhook", "awaiting_schedule", "ended"]>;
505
+ started_at: z.ZodString;
506
+ ended_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
507
+ outcome: z.ZodOptional<z.ZodNullable<z.ZodEnum<["success", "failure", "incomplete", "abandoned"]>>>;
508
+ delegated_from: z.ZodOptional<z.ZodObject<{
509
+ run_id: z.ZodString;
510
+ event_id: z.ZodOptional<z.ZodString>;
511
+ }, "strict", z.ZodTypeAny, {
512
+ run_id: string;
513
+ event_id?: string | undefined;
514
+ }, {
515
+ run_id: string;
516
+ event_id?: string | undefined;
517
+ }>>;
518
+ handed_off_from: z.ZodOptional<z.ZodObject<{
519
+ run_id: z.ZodString;
520
+ event_id: z.ZodOptional<z.ZodString>;
521
+ }, "strict", z.ZodTypeAny, {
522
+ run_id: string;
523
+ event_id?: string | undefined;
524
+ }, {
525
+ run_id: string;
526
+ event_id?: string | undefined;
527
+ }>>;
528
+ scheduled_from: z.ZodOptional<z.ZodObject<{
529
+ run_id: z.ZodString;
530
+ event_id: z.ZodOptional<z.ZodString>;
531
+ }, "strict", z.ZodTypeAny, {
532
+ run_id: string;
533
+ event_id?: string | undefined;
534
+ }, {
535
+ run_id: string;
536
+ event_id?: string | undefined;
537
+ }>>;
538
+ invoked_by: z.ZodOptional<z.ZodObject<{
539
+ run_id: z.ZodString;
540
+ event_id: z.ZodOptional<z.ZodString>;
541
+ }, "strict", z.ZodTypeAny, {
542
+ run_id: string;
543
+ event_id?: string | undefined;
544
+ }, {
545
+ run_id: string;
546
+ event_id?: string | undefined;
547
+ }>>;
548
+ continued_from: z.ZodOptional<z.ZodObject<{
549
+ run_id: z.ZodString;
550
+ event_id: z.ZodOptional<z.ZodString>;
551
+ }, "strict", z.ZodTypeAny, {
552
+ run_id: string;
553
+ event_id?: string | undefined;
554
+ }, {
555
+ run_id: string;
556
+ event_id?: string | undefined;
557
+ }>>;
558
+ active_duration_seconds: z.ZodOptional<z.ZodNumber>;
559
+ suspension_intervals: z.ZodOptional<z.ZodArray<z.ZodObject<{
560
+ started: z.ZodString;
561
+ ended: z.ZodOptional<z.ZodNullable<z.ZodString>>;
562
+ reason: z.ZodEnum<["awaiting_human_approval", "awaiting_human_input", "awaiting_webhook", "awaiting_schedule", "awaiting_external_system", "awaiting_subagent", "other"]>;
563
+ trigger_event_id: z.ZodString;
564
+ resume_event_id: z.ZodOptional<z.ZodString>;
565
+ }, "strict", z.ZodTypeAny, {
566
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
567
+ started: string;
568
+ trigger_event_id: string;
569
+ ended?: string | null | undefined;
570
+ resume_event_id?: string | undefined;
571
+ }, {
572
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
573
+ started: string;
574
+ trigger_event_id: string;
575
+ ended?: string | null | undefined;
576
+ resume_event_id?: string | undefined;
577
+ }>, "many">>;
578
+ environment: z.ZodOptional<z.ZodEnum<["production", "staging", "development"]>>;
579
+ labels: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>>;
580
+ redaction_policy_version: z.ZodString;
581
+ regulatory_scope_version: z.ZodOptional<z.ZodString>;
582
+ sdk_at_start: z.ZodOptional<z.ZodObject<{
583
+ name: z.ZodEnum<["runfile-py", "@runfile/sdk"]>;
584
+ version: z.ZodString;
585
+ 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"]>;
586
+ framework_version: z.ZodOptional<z.ZodString>;
587
+ adapter: z.ZodOptional<z.ZodString>;
588
+ host: z.ZodOptional<z.ZodString>;
589
+ }, "strict", z.ZodTypeAny, {
590
+ 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";
591
+ name: "runfile-py" | "@runfile/sdk";
592
+ version: string;
593
+ framework_version?: string | undefined;
594
+ adapter?: string | undefined;
595
+ host?: string | undefined;
596
+ }, {
597
+ 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";
598
+ name: "runfile-py" | "@runfile/sdk";
599
+ version: string;
600
+ framework_version?: string | undefined;
601
+ adapter?: string | undefined;
602
+ host?: string | undefined;
603
+ }>>;
604
+ merkle_inclusions: z.ZodOptional<z.ZodArray<z.ZodObject<{
605
+ manifest_uri: z.ZodString;
606
+ leaf_index: z.ZodNumber;
607
+ merkle_root: z.ZodString;
608
+ }, "strict", z.ZodTypeAny, {
609
+ manifest_uri: string;
610
+ leaf_index: number;
611
+ merkle_root: string;
612
+ }, {
613
+ manifest_uri: string;
614
+ leaf_index: number;
615
+ merkle_root: string;
616
+ }>, "many">>;
617
+ }, "strict", z.ZodTypeAny, {
618
+ agent_identity: string;
619
+ run_id: string;
620
+ schema_version: string;
621
+ tenant_id: string;
622
+ lifecycle_state: "awaiting_webhook" | "awaiting_schedule" | "active" | "awaiting_human" | "ended";
623
+ started_at: string;
624
+ redaction_policy_version: string;
625
+ outcome?: "success" | "failure" | "incomplete" | "abandoned" | null | undefined;
626
+ conversation_id?: string | undefined;
627
+ ended_at?: string | null | undefined;
628
+ delegated_from?: {
629
+ run_id: string;
630
+ event_id?: string | undefined;
631
+ } | undefined;
632
+ handed_off_from?: {
633
+ run_id: string;
634
+ event_id?: string | undefined;
635
+ } | undefined;
636
+ scheduled_from?: {
637
+ run_id: string;
638
+ event_id?: string | undefined;
639
+ } | undefined;
640
+ invoked_by?: {
641
+ run_id: string;
642
+ event_id?: string | undefined;
643
+ } | undefined;
644
+ continued_from?: {
645
+ run_id: string;
646
+ event_id?: string | undefined;
647
+ } | undefined;
648
+ active_duration_seconds?: number | undefined;
649
+ suspension_intervals?: {
650
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
651
+ started: string;
652
+ trigger_event_id: string;
653
+ ended?: string | null | undefined;
654
+ resume_event_id?: string | undefined;
655
+ }[] | undefined;
656
+ environment?: "production" | "staging" | "development" | undefined;
657
+ labels?: Record<string, string> | undefined;
658
+ regulatory_scope_version?: string | undefined;
659
+ sdk_at_start?: {
660
+ 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";
661
+ name: "runfile-py" | "@runfile/sdk";
662
+ version: string;
663
+ framework_version?: string | undefined;
664
+ adapter?: string | undefined;
665
+ host?: string | undefined;
666
+ } | undefined;
667
+ merkle_inclusions?: {
668
+ manifest_uri: string;
669
+ leaf_index: number;
670
+ merkle_root: string;
671
+ }[] | undefined;
672
+ }, {
673
+ agent_identity: string;
674
+ run_id: string;
675
+ schema_version: string;
676
+ tenant_id: string;
677
+ lifecycle_state: "awaiting_webhook" | "awaiting_schedule" | "active" | "awaiting_human" | "ended";
678
+ started_at: string;
679
+ redaction_policy_version: string;
680
+ outcome?: "success" | "failure" | "incomplete" | "abandoned" | null | undefined;
681
+ conversation_id?: string | undefined;
682
+ ended_at?: string | null | undefined;
683
+ delegated_from?: {
684
+ run_id: string;
685
+ event_id?: string | undefined;
686
+ } | undefined;
687
+ handed_off_from?: {
688
+ run_id: string;
689
+ event_id?: string | undefined;
690
+ } | undefined;
691
+ scheduled_from?: {
692
+ run_id: string;
693
+ event_id?: string | undefined;
694
+ } | undefined;
695
+ invoked_by?: {
696
+ run_id: string;
697
+ event_id?: string | undefined;
698
+ } | undefined;
699
+ continued_from?: {
700
+ run_id: string;
701
+ event_id?: string | undefined;
702
+ } | undefined;
703
+ active_duration_seconds?: number | undefined;
704
+ suspension_intervals?: {
705
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
706
+ started: string;
707
+ trigger_event_id: string;
708
+ ended?: string | null | undefined;
709
+ resume_event_id?: string | undefined;
710
+ }[] | undefined;
711
+ environment?: "production" | "staging" | "development" | undefined;
712
+ labels?: Record<string, string> | undefined;
713
+ regulatory_scope_version?: string | undefined;
714
+ sdk_at_start?: {
715
+ 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";
716
+ name: "runfile-py" | "@runfile/sdk";
717
+ version: string;
718
+ framework_version?: string | undefined;
719
+ adapter?: string | undefined;
720
+ host?: string | undefined;
721
+ } | undefined;
722
+ merkle_inclusions?: {
723
+ manifest_uri: string;
724
+ leaf_index: number;
725
+ merkle_root: string;
726
+ }[] | undefined;
727
+ }>;
728
+ export type RunfileRun = z.infer<typeof RunfileRunSchema>;
729
+ /**
730
+ * RunfileEvent — a single action captured within a Run. Hash-chained linearly within the
731
+ * run via `prev_event_hash` → `event_hash` (received_at order); causally linked via
732
+ * `parent_event_id` (the execution DAG); concurrent operations grouped via
733
+ * `parallel_group_id`. Committed to a daily Merkle root.
279
734
  *
280
735
  * Conditional-required fields (enforced via superRefine below):
281
736
  * - kind=llm_call → model_ref required
282
737
  * - kind=decision → decision required
738
+ * - kind=run_suspend → suspension_details required
739
+ * - kind=run_resume → resume_details required
740
+ * - kind=delegate → delegation_details required
741
+ * - kind=handoff → handoff_details required
283
742
  * - actor.type=agent → actor.agent_identity required (also enforced inside ActorSchema)
284
743
  * - actor.type=tool → actor.tool_id + actor.tool_version_hash required (also enforced inside ActorSchema)
285
744
  */
@@ -287,28 +746,32 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
287
746
  schema_version: z.ZodString;
288
747
  event_id: z.ZodString;
289
748
  tenant_id: z.ZodString;
290
- agent_run_id: z.ZodString;
749
+ run_id: z.ZodString;
291
750
  parent_event_id: z.ZodNullable<z.ZodString>;
751
+ parallel_group_id: z.ZodOptional<z.ZodString>;
292
752
  captured_at: z.ZodString;
293
753
  received_at: z.ZodString;
294
754
  wall_clock_source: z.ZodEnum<["aws_time_sync", "ntp", "host_system", "unknown"]>;
295
755
  sdk: z.ZodObject<{
296
756
  name: z.ZodEnum<["runfile-py", "@runfile/sdk"]>;
297
757
  version: z.ZodString;
298
- 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"]>;
758
+ 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"]>;
299
759
  framework_version: z.ZodOptional<z.ZodString>;
760
+ adapter: z.ZodOptional<z.ZodString>;
300
761
  host: z.ZodOptional<z.ZodString>;
301
762
  }, "strict", z.ZodTypeAny, {
302
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
763
+ 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";
303
764
  name: "runfile-py" | "@runfile/sdk";
304
765
  version: string;
305
766
  framework_version?: string | undefined;
767
+ adapter?: string | undefined;
306
768
  host?: string | undefined;
307
769
  }, {
308
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
770
+ 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";
309
771
  name: "runfile-py" | "@runfile/sdk";
310
772
  version: string;
311
773
  framework_version?: string | undefined;
774
+ adapter?: string | undefined;
312
775
  host?: string | undefined;
313
776
  }>;
314
777
  actor: z.ZodEffects<z.ZodObject<{
@@ -348,34 +811,34 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
348
811
  tool_version_hash?: string | undefined;
349
812
  }>;
350
813
  action: z.ZodObject<{
351
- 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"]>;
814
+ 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"]>;
352
815
  name: z.ZodString;
353
816
  outcome: z.ZodOptional<z.ZodEnum<["success", "failure", "partial", "timeout", "cancelled"]>>;
354
817
  duration_ms: z.ZodOptional<z.ZodNumber>;
355
818
  }, "strict", z.ZodTypeAny, {
356
- 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";
819
+ 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";
357
820
  name: string;
358
821
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
359
822
  duration_ms?: number | undefined;
360
823
  }, {
361
- 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";
824
+ 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";
362
825
  name: string;
363
826
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
364
827
  duration_ms?: number | undefined;
365
828
  }>;
366
- subject: z.ZodObject<{
829
+ subject: z.ZodOptional<z.ZodObject<{
367
830
  resource_urn: z.ZodOptional<z.ZodString>;
368
- data_classification: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci"]>>;
831
+ data_classification: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci", "audit_of_audit"]>>;
369
832
  regulatory_tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
370
833
  }, "strict", z.ZodTypeAny, {
371
834
  regulatory_tags?: string[] | undefined;
372
835
  resource_urn?: string | undefined;
373
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
836
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
374
837
  }, {
375
838
  regulatory_tags?: string[] | undefined;
376
839
  resource_urn?: string | undefined;
377
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
378
- }>;
840
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
841
+ }>>;
379
842
  model_ref: z.ZodOptional<z.ZodObject<{
380
843
  provider: z.ZodEnum<["anthropic", "openai", "google", "aws_bedrock", "azure_openai", "ollama", "self_hosted", "other"]>;
381
844
  model_id: z.ZodString;
@@ -385,6 +848,7 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
385
848
  input_tokens: z.ZodOptional<z.ZodNumber>;
386
849
  output_tokens: z.ZodOptional<z.ZodNumber>;
387
850
  temperature: z.ZodOptional<z.ZodNumber>;
851
+ streaming: z.ZodOptional<z.ZodBoolean>;
388
852
  }, "strict", z.ZodTypeAny, {
389
853
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
390
854
  model_id: string;
@@ -394,6 +858,7 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
394
858
  input_tokens?: number | undefined;
395
859
  output_tokens?: number | undefined;
396
860
  temperature?: number | undefined;
861
+ streaming?: boolean | undefined;
397
862
  }, {
398
863
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
399
864
  model_id: string;
@@ -403,6 +868,7 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
403
868
  input_tokens?: number | undefined;
404
869
  output_tokens?: number | undefined;
405
870
  temperature?: number | undefined;
871
+ streaming?: boolean | undefined;
406
872
  }>>;
407
873
  decision: z.ZodOptional<z.ZodObject<{
408
874
  outcome: z.ZodEnum<["approved", "denied", "escalated", "deferred", "no_action", "custom"]>;
@@ -426,6 +892,93 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
426
892
  policy_thresholds_crossed?: string[] | undefined;
427
893
  reversed_by_event?: string | undefined;
428
894
  }>>;
895
+ suspension_details: z.ZodOptional<z.ZodObject<{
896
+ reason: z.ZodEnum<["awaiting_human_approval", "awaiting_human_input", "awaiting_webhook", "awaiting_schedule", "awaiting_external_system", "awaiting_subagent", "other"]>;
897
+ expected_resumer: z.ZodOptional<z.ZodString>;
898
+ expected_resume_by: z.ZodOptional<z.ZodString>;
899
+ detection_source: z.ZodOptional<z.ZodEnum<["framework_inferred", "customer_explicit", "derived"]>>;
900
+ framework_signal: z.ZodOptional<z.ZodObject<{
901
+ framework: z.ZodOptional<z.ZodEnum<["langgraph", "openai_agents", "claude_agent_sdk", "vercel_ai_sdk", "mcp", "manual", "otel"]>>;
902
+ signal_name: z.ZodOptional<z.ZodString>;
903
+ signal_payload_hash: z.ZodOptional<z.ZodString>;
904
+ }, "strict", z.ZodTypeAny, {
905
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
906
+ signal_name?: string | undefined;
907
+ signal_payload_hash?: string | undefined;
908
+ }, {
909
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
910
+ signal_name?: string | undefined;
911
+ signal_payload_hash?: string | undefined;
912
+ }>>;
913
+ }, "strict", z.ZodTypeAny, {
914
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
915
+ expected_resumer?: string | undefined;
916
+ expected_resume_by?: string | undefined;
917
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
918
+ framework_signal?: {
919
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
920
+ signal_name?: string | undefined;
921
+ signal_payload_hash?: string | undefined;
922
+ } | undefined;
923
+ }, {
924
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
925
+ expected_resumer?: string | undefined;
926
+ expected_resume_by?: string | undefined;
927
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
928
+ framework_signal?: {
929
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
930
+ signal_name?: string | undefined;
931
+ signal_payload_hash?: string | undefined;
932
+ } | undefined;
933
+ }>>;
934
+ resume_details: z.ZodOptional<z.ZodObject<{
935
+ triggered_by: z.ZodEnum<["human_approval_granted", "human_input_received", "webhook_received", "schedule_fired", "external_system_response", "subagent_completed", "manual_resume", "other"]>;
936
+ resumer_principal: z.ZodOptional<z.ZodString>;
937
+ suspension_duration_seconds: z.ZodOptional<z.ZodNumber>;
938
+ suspension_started_event_id: z.ZodOptional<z.ZodString>;
939
+ }, "strict", z.ZodTypeAny, {
940
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
941
+ resumer_principal?: string | undefined;
942
+ suspension_duration_seconds?: number | undefined;
943
+ suspension_started_event_id?: string | undefined;
944
+ }, {
945
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
946
+ resumer_principal?: string | undefined;
947
+ suspension_duration_seconds?: number | undefined;
948
+ suspension_started_event_id?: string | undefined;
949
+ }>>;
950
+ delegation_details: z.ZodOptional<z.ZodObject<{
951
+ delegated_run_id: z.ZodString;
952
+ delegated_agent_identity: z.ZodString;
953
+ wait_for_completion: z.ZodOptional<z.ZodBoolean>;
954
+ framework_signal: z.ZodOptional<z.ZodEnum<["langgraph_subgraph", "openai_agents_as_tool", "claude_agent_sdk_subagent", "manual", "other"]>>;
955
+ }, "strict", z.ZodTypeAny, {
956
+ delegated_run_id: string;
957
+ delegated_agent_identity: string;
958
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
959
+ wait_for_completion?: boolean | undefined;
960
+ }, {
961
+ delegated_run_id: string;
962
+ delegated_agent_identity: string;
963
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
964
+ wait_for_completion?: boolean | undefined;
965
+ }>>;
966
+ handoff_details: z.ZodOptional<z.ZodObject<{
967
+ target_run_id: z.ZodString;
968
+ target_agent_identity: z.ZodString;
969
+ handoff_reason: z.ZodOptional<z.ZodString>;
970
+ framework_signal: z.ZodOptional<z.ZodEnum<["openai_agents_handoff", "langgraph_explicit", "manual", "other"]>>;
971
+ }, "strict", z.ZodTypeAny, {
972
+ target_run_id: string;
973
+ target_agent_identity: string;
974
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
975
+ handoff_reason?: string | undefined;
976
+ }, {
977
+ target_run_id: string;
978
+ target_agent_identity: string;
979
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
980
+ handoff_reason?: string | undefined;
981
+ }>>;
429
982
  payload_ref: z.ZodOptional<z.ZodObject<{
430
983
  s3_uri: z.ZodString;
431
984
  sha256: z.ZodString;
@@ -443,7 +996,7 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
443
996
  data_key_wrapped: string;
444
997
  kms_key_arn?: string | undefined;
445
998
  }>;
446
- 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"]>>;
999
+ 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"]>>;
447
1000
  redaction_applied: z.ZodOptional<z.ZodObject<{
448
1001
  redacted_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
449
1002
  tokenized_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -466,7 +1019,7 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
466
1019
  data_key_wrapped: string;
467
1020
  kms_key_arn?: string | undefined;
468
1021
  };
469
- 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;
1022
+ 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;
470
1023
  redaction_applied?: {
471
1024
  redacted_classes?: string[] | undefined;
472
1025
  tokenized_classes?: string[] | undefined;
@@ -481,31 +1034,92 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
481
1034
  data_key_wrapped: string;
482
1035
  kms_key_arn?: string | undefined;
483
1036
  };
484
- 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;
1037
+ 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;
485
1038
  redaction_applied?: {
486
1039
  redacted_classes?: string[] | undefined;
487
1040
  tokenized_classes?: string[] | undefined;
488
1041
  classifier_version?: string | undefined;
489
1042
  } | undefined;
490
1043
  }>>;
1044
+ otel_attributes: z.ZodOptional<z.ZodObject<{
1045
+ gen_ai_system: z.ZodOptional<z.ZodString>;
1046
+ gen_ai_operation_name: z.ZodOptional<z.ZodString>;
1047
+ gen_ai_provider_name: z.ZodOptional<z.ZodString>;
1048
+ gen_ai_request_model: z.ZodOptional<z.ZodString>;
1049
+ gen_ai_response_model: z.ZodOptional<z.ZodString>;
1050
+ gen_ai_request_temperature: z.ZodOptional<z.ZodNumber>;
1051
+ gen_ai_request_top_p: z.ZodOptional<z.ZodNumber>;
1052
+ gen_ai_request_max_tokens: z.ZodOptional<z.ZodNumber>;
1053
+ gen_ai_response_id: z.ZodOptional<z.ZodString>;
1054
+ gen_ai_response_finish_reasons: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1055
+ gen_ai_usage_input_tokens: z.ZodOptional<z.ZodNumber>;
1056
+ gen_ai_usage_output_tokens: z.ZodOptional<z.ZodNumber>;
1057
+ gen_ai_tool_name: z.ZodOptional<z.ZodString>;
1058
+ gen_ai_tool_call_id: z.ZodOptional<z.ZodString>;
1059
+ gen_ai_agent_id: z.ZodOptional<z.ZodString>;
1060
+ gen_ai_agent_name: z.ZodOptional<z.ZodString>;
1061
+ gen_ai_agent_description: z.ZodOptional<z.ZodString>;
1062
+ gen_ai_conversation_id: z.ZodOptional<z.ZodString>;
1063
+ extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
1064
+ }, "strict", z.ZodTypeAny, {
1065
+ gen_ai_system?: string | undefined;
1066
+ gen_ai_operation_name?: string | undefined;
1067
+ gen_ai_provider_name?: string | undefined;
1068
+ gen_ai_request_model?: string | undefined;
1069
+ gen_ai_response_model?: string | undefined;
1070
+ gen_ai_request_temperature?: number | undefined;
1071
+ gen_ai_request_top_p?: number | undefined;
1072
+ gen_ai_request_max_tokens?: number | undefined;
1073
+ gen_ai_response_id?: string | undefined;
1074
+ gen_ai_response_finish_reasons?: string[] | undefined;
1075
+ gen_ai_usage_input_tokens?: number | undefined;
1076
+ gen_ai_usage_output_tokens?: number | undefined;
1077
+ gen_ai_tool_name?: string | undefined;
1078
+ gen_ai_tool_call_id?: string | undefined;
1079
+ gen_ai_agent_id?: string | undefined;
1080
+ gen_ai_agent_name?: string | undefined;
1081
+ gen_ai_agent_description?: string | undefined;
1082
+ gen_ai_conversation_id?: string | undefined;
1083
+ extra?: Record<string, string | number | boolean> | undefined;
1084
+ }, {
1085
+ gen_ai_system?: string | undefined;
1086
+ gen_ai_operation_name?: string | undefined;
1087
+ gen_ai_provider_name?: string | undefined;
1088
+ gen_ai_request_model?: string | undefined;
1089
+ gen_ai_response_model?: string | undefined;
1090
+ gen_ai_request_temperature?: number | undefined;
1091
+ gen_ai_request_top_p?: number | undefined;
1092
+ gen_ai_request_max_tokens?: number | undefined;
1093
+ gen_ai_response_id?: string | undefined;
1094
+ gen_ai_response_finish_reasons?: string[] | undefined;
1095
+ gen_ai_usage_input_tokens?: number | undefined;
1096
+ gen_ai_usage_output_tokens?: number | undefined;
1097
+ gen_ai_tool_name?: string | undefined;
1098
+ gen_ai_tool_call_id?: string | undefined;
1099
+ gen_ai_agent_id?: string | undefined;
1100
+ gen_ai_agent_name?: string | undefined;
1101
+ gen_ai_agent_description?: string | undefined;
1102
+ gen_ai_conversation_id?: string | undefined;
1103
+ extra?: Record<string, string | number | boolean> | undefined;
1104
+ }>>;
491
1105
  redaction_policy_version: z.ZodString;
492
1106
  regulatory_scope_version: z.ZodOptional<z.ZodString>;
493
1107
  anomaly_flags: z.ZodOptional<z.ZodArray<z.ZodObject<{
494
- 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"]>;
1108
+ 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"]>;
495
1109
  severity: z.ZodEnum<["info", "warning", "error", "critical"]>;
496
1110
  detail: z.ZodOptional<z.ZodString>;
497
1111
  }, "strict", z.ZodTypeAny, {
498
- 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";
1112
+ 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";
499
1113
  severity: "info" | "warning" | "error" | "critical";
500
1114
  detail?: string | undefined;
501
1115
  }, {
502
- 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";
1116
+ 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";
503
1117
  severity: "info" | "warning" | "error" | "critical";
504
1118
  detail?: string | undefined;
505
1119
  }>, "many">>;
506
1120
  environment: z.ZodOptional<z.ZodEnum<["production", "staging", "development"]>>;
507
1121
  labels: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>>;
508
- prev_hash: z.ZodString;
1122
+ prev_event_hash: z.ZodString;
509
1123
  event_hash: z.ZodString;
510
1124
  merkle_inclusion: z.ZodOptional<z.ZodObject<{
511
1125
  manifest_uri: z.ZodString;
@@ -522,19 +1136,21 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
522
1136
  }>>;
523
1137
  }, "strict", z.ZodTypeAny, {
524
1138
  event_hash: string;
525
- schema_version: string;
1139
+ run_id: string;
526
1140
  event_id: string;
1141
+ schema_version: string;
527
1142
  tenant_id: string;
528
- agent_run_id: string;
1143
+ redaction_policy_version: string;
529
1144
  parent_event_id: string | null;
530
1145
  captured_at: string;
531
1146
  received_at: string;
532
1147
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
533
1148
  sdk: {
534
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
1149
+ 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";
535
1150
  name: "runfile-py" | "@runfile/sdk";
536
1151
  version: string;
537
1152
  framework_version?: string | undefined;
1153
+ adapter?: string | undefined;
538
1154
  host?: string | undefined;
539
1155
  };
540
1156
  actor: {
@@ -546,18 +1162,12 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
546
1162
  tool_version_hash?: string | undefined;
547
1163
  };
548
1164
  action: {
549
- 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";
1165
+ 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";
550
1166
  name: string;
551
1167
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
552
1168
  duration_ms?: number | undefined;
553
1169
  };
554
- subject: {
555
- regulatory_tags?: string[] | undefined;
556
- resource_urn?: string | undefined;
557
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
558
- };
559
- redaction_policy_version: string;
560
- prev_hash: string;
1170
+ prev_event_hash: string;
561
1171
  decision?: {
562
1172
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
563
1173
  outcome_label?: string | undefined;
@@ -566,6 +1176,15 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
566
1176
  policy_thresholds_crossed?: string[] | undefined;
567
1177
  reversed_by_event?: string | undefined;
568
1178
  } | undefined;
1179
+ environment?: "production" | "staging" | "development" | undefined;
1180
+ labels?: Record<string, string> | undefined;
1181
+ regulatory_scope_version?: string | undefined;
1182
+ parallel_group_id?: string | undefined;
1183
+ subject?: {
1184
+ regulatory_tags?: string[] | undefined;
1185
+ resource_urn?: string | undefined;
1186
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
1187
+ } | undefined;
569
1188
  model_ref?: {
570
1189
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
571
1190
  model_id: string;
@@ -575,6 +1194,36 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
575
1194
  input_tokens?: number | undefined;
576
1195
  output_tokens?: number | undefined;
577
1196
  temperature?: number | undefined;
1197
+ streaming?: boolean | undefined;
1198
+ } | undefined;
1199
+ suspension_details?: {
1200
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
1201
+ expected_resumer?: string | undefined;
1202
+ expected_resume_by?: string | undefined;
1203
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
1204
+ framework_signal?: {
1205
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
1206
+ signal_name?: string | undefined;
1207
+ signal_payload_hash?: string | undefined;
1208
+ } | undefined;
1209
+ } | undefined;
1210
+ resume_details?: {
1211
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
1212
+ resumer_principal?: string | undefined;
1213
+ suspension_duration_seconds?: number | undefined;
1214
+ suspension_started_event_id?: string | undefined;
1215
+ } | undefined;
1216
+ delegation_details?: {
1217
+ delegated_run_id: string;
1218
+ delegated_agent_identity: string;
1219
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
1220
+ wait_for_completion?: boolean | undefined;
1221
+ } | undefined;
1222
+ handoff_details?: {
1223
+ target_run_id: string;
1224
+ target_agent_identity: string;
1225
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
1226
+ handoff_reason?: string | undefined;
578
1227
  } | undefined;
579
1228
  payload_ref?: {
580
1229
  sha256: string;
@@ -585,21 +1234,39 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
585
1234
  data_key_wrapped: string;
586
1235
  kms_key_arn?: string | undefined;
587
1236
  };
588
- 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;
1237
+ 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;
589
1238
  redaction_applied?: {
590
1239
  redacted_classes?: string[] | undefined;
591
1240
  tokenized_classes?: string[] | undefined;
592
1241
  classifier_version?: string | undefined;
593
1242
  } | undefined;
594
1243
  } | undefined;
595
- regulatory_scope_version?: string | undefined;
1244
+ otel_attributes?: {
1245
+ gen_ai_system?: string | undefined;
1246
+ gen_ai_operation_name?: string | undefined;
1247
+ gen_ai_provider_name?: string | undefined;
1248
+ gen_ai_request_model?: string | undefined;
1249
+ gen_ai_response_model?: string | undefined;
1250
+ gen_ai_request_temperature?: number | undefined;
1251
+ gen_ai_request_top_p?: number | undefined;
1252
+ gen_ai_request_max_tokens?: number | undefined;
1253
+ gen_ai_response_id?: string | undefined;
1254
+ gen_ai_response_finish_reasons?: string[] | undefined;
1255
+ gen_ai_usage_input_tokens?: number | undefined;
1256
+ gen_ai_usage_output_tokens?: number | undefined;
1257
+ gen_ai_tool_name?: string | undefined;
1258
+ gen_ai_tool_call_id?: string | undefined;
1259
+ gen_ai_agent_id?: string | undefined;
1260
+ gen_ai_agent_name?: string | undefined;
1261
+ gen_ai_agent_description?: string | undefined;
1262
+ gen_ai_conversation_id?: string | undefined;
1263
+ extra?: Record<string, string | number | boolean> | undefined;
1264
+ } | undefined;
596
1265
  anomaly_flags?: {
597
- 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";
1266
+ 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";
598
1267
  severity: "info" | "warning" | "error" | "critical";
599
1268
  detail?: string | undefined;
600
1269
  }[] | undefined;
601
- environment?: "production" | "staging" | "development" | undefined;
602
- labels?: Record<string, string> | undefined;
603
1270
  merkle_inclusion?: {
604
1271
  manifest_uri: string;
605
1272
  leaf_index: number;
@@ -607,19 +1274,21 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
607
1274
  } | undefined;
608
1275
  }, {
609
1276
  event_hash: string;
610
- schema_version: string;
1277
+ run_id: string;
611
1278
  event_id: string;
1279
+ schema_version: string;
612
1280
  tenant_id: string;
613
- agent_run_id: string;
1281
+ redaction_policy_version: string;
614
1282
  parent_event_id: string | null;
615
1283
  captured_at: string;
616
1284
  received_at: string;
617
1285
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
618
1286
  sdk: {
619
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
1287
+ 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";
620
1288
  name: "runfile-py" | "@runfile/sdk";
621
1289
  version: string;
622
1290
  framework_version?: string | undefined;
1291
+ adapter?: string | undefined;
623
1292
  host?: string | undefined;
624
1293
  };
625
1294
  actor: {
@@ -631,18 +1300,12 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
631
1300
  tool_version_hash?: string | undefined;
632
1301
  };
633
1302
  action: {
634
- 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";
1303
+ 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";
635
1304
  name: string;
636
1305
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
637
1306
  duration_ms?: number | undefined;
638
1307
  };
639
- subject: {
640
- regulatory_tags?: string[] | undefined;
641
- resource_urn?: string | undefined;
642
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
643
- };
644
- redaction_policy_version: string;
645
- prev_hash: string;
1308
+ prev_event_hash: string;
646
1309
  decision?: {
647
1310
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
648
1311
  outcome_label?: string | undefined;
@@ -651,6 +1314,15 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
651
1314
  policy_thresholds_crossed?: string[] | undefined;
652
1315
  reversed_by_event?: string | undefined;
653
1316
  } | undefined;
1317
+ environment?: "production" | "staging" | "development" | undefined;
1318
+ labels?: Record<string, string> | undefined;
1319
+ regulatory_scope_version?: string | undefined;
1320
+ parallel_group_id?: string | undefined;
1321
+ subject?: {
1322
+ regulatory_tags?: string[] | undefined;
1323
+ resource_urn?: string | undefined;
1324
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
1325
+ } | undefined;
654
1326
  model_ref?: {
655
1327
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
656
1328
  model_id: string;
@@ -660,6 +1332,36 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
660
1332
  input_tokens?: number | undefined;
661
1333
  output_tokens?: number | undefined;
662
1334
  temperature?: number | undefined;
1335
+ streaming?: boolean | undefined;
1336
+ } | undefined;
1337
+ suspension_details?: {
1338
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
1339
+ expected_resumer?: string | undefined;
1340
+ expected_resume_by?: string | undefined;
1341
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
1342
+ framework_signal?: {
1343
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
1344
+ signal_name?: string | undefined;
1345
+ signal_payload_hash?: string | undefined;
1346
+ } | undefined;
1347
+ } | undefined;
1348
+ resume_details?: {
1349
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
1350
+ resumer_principal?: string | undefined;
1351
+ suspension_duration_seconds?: number | undefined;
1352
+ suspension_started_event_id?: string | undefined;
1353
+ } | undefined;
1354
+ delegation_details?: {
1355
+ delegated_run_id: string;
1356
+ delegated_agent_identity: string;
1357
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
1358
+ wait_for_completion?: boolean | undefined;
1359
+ } | undefined;
1360
+ handoff_details?: {
1361
+ target_run_id: string;
1362
+ target_agent_identity: string;
1363
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
1364
+ handoff_reason?: string | undefined;
663
1365
  } | undefined;
664
1366
  payload_ref?: {
665
1367
  sha256: string;
@@ -670,21 +1372,39 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
670
1372
  data_key_wrapped: string;
671
1373
  kms_key_arn?: string | undefined;
672
1374
  };
673
- 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;
1375
+ 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;
674
1376
  redaction_applied?: {
675
1377
  redacted_classes?: string[] | undefined;
676
1378
  tokenized_classes?: string[] | undefined;
677
1379
  classifier_version?: string | undefined;
678
1380
  } | undefined;
679
1381
  } | undefined;
680
- regulatory_scope_version?: string | undefined;
1382
+ otel_attributes?: {
1383
+ gen_ai_system?: string | undefined;
1384
+ gen_ai_operation_name?: string | undefined;
1385
+ gen_ai_provider_name?: string | undefined;
1386
+ gen_ai_request_model?: string | undefined;
1387
+ gen_ai_response_model?: string | undefined;
1388
+ gen_ai_request_temperature?: number | undefined;
1389
+ gen_ai_request_top_p?: number | undefined;
1390
+ gen_ai_request_max_tokens?: number | undefined;
1391
+ gen_ai_response_id?: string | undefined;
1392
+ gen_ai_response_finish_reasons?: string[] | undefined;
1393
+ gen_ai_usage_input_tokens?: number | undefined;
1394
+ gen_ai_usage_output_tokens?: number | undefined;
1395
+ gen_ai_tool_name?: string | undefined;
1396
+ gen_ai_tool_call_id?: string | undefined;
1397
+ gen_ai_agent_id?: string | undefined;
1398
+ gen_ai_agent_name?: string | undefined;
1399
+ gen_ai_agent_description?: string | undefined;
1400
+ gen_ai_conversation_id?: string | undefined;
1401
+ extra?: Record<string, string | number | boolean> | undefined;
1402
+ } | undefined;
681
1403
  anomaly_flags?: {
682
- 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";
1404
+ 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";
683
1405
  severity: "info" | "warning" | "error" | "critical";
684
1406
  detail?: string | undefined;
685
1407
  }[] | undefined;
686
- environment?: "production" | "staging" | "development" | undefined;
687
- labels?: Record<string, string> | undefined;
688
1408
  merkle_inclusion?: {
689
1409
  manifest_uri: string;
690
1410
  leaf_index: number;
@@ -692,19 +1412,21 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
692
1412
  } | undefined;
693
1413
  }>, {
694
1414
  event_hash: string;
695
- schema_version: string;
1415
+ run_id: string;
696
1416
  event_id: string;
1417
+ schema_version: string;
697
1418
  tenant_id: string;
698
- agent_run_id: string;
1419
+ redaction_policy_version: string;
699
1420
  parent_event_id: string | null;
700
1421
  captured_at: string;
701
1422
  received_at: string;
702
1423
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
703
1424
  sdk: {
704
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
1425
+ 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";
705
1426
  name: "runfile-py" | "@runfile/sdk";
706
1427
  version: string;
707
1428
  framework_version?: string | undefined;
1429
+ adapter?: string | undefined;
708
1430
  host?: string | undefined;
709
1431
  };
710
1432
  actor: {
@@ -716,18 +1438,12 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
716
1438
  tool_version_hash?: string | undefined;
717
1439
  };
718
1440
  action: {
719
- 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";
1441
+ 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";
720
1442
  name: string;
721
1443
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
722
1444
  duration_ms?: number | undefined;
723
1445
  };
724
- subject: {
725
- regulatory_tags?: string[] | undefined;
726
- resource_urn?: string | undefined;
727
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
728
- };
729
- redaction_policy_version: string;
730
- prev_hash: string;
1446
+ prev_event_hash: string;
731
1447
  decision?: {
732
1448
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
733
1449
  outcome_label?: string | undefined;
@@ -736,6 +1452,15 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
736
1452
  policy_thresholds_crossed?: string[] | undefined;
737
1453
  reversed_by_event?: string | undefined;
738
1454
  } | undefined;
1455
+ environment?: "production" | "staging" | "development" | undefined;
1456
+ labels?: Record<string, string> | undefined;
1457
+ regulatory_scope_version?: string | undefined;
1458
+ parallel_group_id?: string | undefined;
1459
+ subject?: {
1460
+ regulatory_tags?: string[] | undefined;
1461
+ resource_urn?: string | undefined;
1462
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
1463
+ } | undefined;
739
1464
  model_ref?: {
740
1465
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
741
1466
  model_id: string;
@@ -745,6 +1470,36 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
745
1470
  input_tokens?: number | undefined;
746
1471
  output_tokens?: number | undefined;
747
1472
  temperature?: number | undefined;
1473
+ streaming?: boolean | undefined;
1474
+ } | undefined;
1475
+ suspension_details?: {
1476
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
1477
+ expected_resumer?: string | undefined;
1478
+ expected_resume_by?: string | undefined;
1479
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
1480
+ framework_signal?: {
1481
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
1482
+ signal_name?: string | undefined;
1483
+ signal_payload_hash?: string | undefined;
1484
+ } | undefined;
1485
+ } | undefined;
1486
+ resume_details?: {
1487
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
1488
+ resumer_principal?: string | undefined;
1489
+ suspension_duration_seconds?: number | undefined;
1490
+ suspension_started_event_id?: string | undefined;
1491
+ } | undefined;
1492
+ delegation_details?: {
1493
+ delegated_run_id: string;
1494
+ delegated_agent_identity: string;
1495
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
1496
+ wait_for_completion?: boolean | undefined;
1497
+ } | undefined;
1498
+ handoff_details?: {
1499
+ target_run_id: string;
1500
+ target_agent_identity: string;
1501
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
1502
+ handoff_reason?: string | undefined;
748
1503
  } | undefined;
749
1504
  payload_ref?: {
750
1505
  sha256: string;
@@ -755,21 +1510,39 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
755
1510
  data_key_wrapped: string;
756
1511
  kms_key_arn?: string | undefined;
757
1512
  };
758
- 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;
1513
+ 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;
759
1514
  redaction_applied?: {
760
1515
  redacted_classes?: string[] | undefined;
761
1516
  tokenized_classes?: string[] | undefined;
762
1517
  classifier_version?: string | undefined;
763
1518
  } | undefined;
764
1519
  } | undefined;
765
- regulatory_scope_version?: string | undefined;
1520
+ otel_attributes?: {
1521
+ gen_ai_system?: string | undefined;
1522
+ gen_ai_operation_name?: string | undefined;
1523
+ gen_ai_provider_name?: string | undefined;
1524
+ gen_ai_request_model?: string | undefined;
1525
+ gen_ai_response_model?: string | undefined;
1526
+ gen_ai_request_temperature?: number | undefined;
1527
+ gen_ai_request_top_p?: number | undefined;
1528
+ gen_ai_request_max_tokens?: number | undefined;
1529
+ gen_ai_response_id?: string | undefined;
1530
+ gen_ai_response_finish_reasons?: string[] | undefined;
1531
+ gen_ai_usage_input_tokens?: number | undefined;
1532
+ gen_ai_usage_output_tokens?: number | undefined;
1533
+ gen_ai_tool_name?: string | undefined;
1534
+ gen_ai_tool_call_id?: string | undefined;
1535
+ gen_ai_agent_id?: string | undefined;
1536
+ gen_ai_agent_name?: string | undefined;
1537
+ gen_ai_agent_description?: string | undefined;
1538
+ gen_ai_conversation_id?: string | undefined;
1539
+ extra?: Record<string, string | number | boolean> | undefined;
1540
+ } | undefined;
766
1541
  anomaly_flags?: {
767
- 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";
1542
+ 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";
768
1543
  severity: "info" | "warning" | "error" | "critical";
769
1544
  detail?: string | undefined;
770
1545
  }[] | undefined;
771
- environment?: "production" | "staging" | "development" | undefined;
772
- labels?: Record<string, string> | undefined;
773
1546
  merkle_inclusion?: {
774
1547
  manifest_uri: string;
775
1548
  leaf_index: number;
@@ -777,19 +1550,21 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
777
1550
  } | undefined;
778
1551
  }, {
779
1552
  event_hash: string;
780
- schema_version: string;
1553
+ run_id: string;
781
1554
  event_id: string;
1555
+ schema_version: string;
782
1556
  tenant_id: string;
783
- agent_run_id: string;
1557
+ redaction_policy_version: string;
784
1558
  parent_event_id: string | null;
785
1559
  captured_at: string;
786
1560
  received_at: string;
787
1561
  wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
788
1562
  sdk: {
789
- framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
1563
+ 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";
790
1564
  name: "runfile-py" | "@runfile/sdk";
791
1565
  version: string;
792
1566
  framework_version?: string | undefined;
1567
+ adapter?: string | undefined;
793
1568
  host?: string | undefined;
794
1569
  };
795
1570
  actor: {
@@ -801,18 +1576,12 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
801
1576
  tool_version_hash?: string | undefined;
802
1577
  };
803
1578
  action: {
804
- 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";
1579
+ 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";
805
1580
  name: string;
806
1581
  outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
807
1582
  duration_ms?: number | undefined;
808
1583
  };
809
- subject: {
810
- regulatory_tags?: string[] | undefined;
811
- resource_urn?: string | undefined;
812
- data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
813
- };
814
- redaction_policy_version: string;
815
- prev_hash: string;
1584
+ prev_event_hash: string;
816
1585
  decision?: {
817
1586
  outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
818
1587
  outcome_label?: string | undefined;
@@ -821,6 +1590,15 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
821
1590
  policy_thresholds_crossed?: string[] | undefined;
822
1591
  reversed_by_event?: string | undefined;
823
1592
  } | undefined;
1593
+ environment?: "production" | "staging" | "development" | undefined;
1594
+ labels?: Record<string, string> | undefined;
1595
+ regulatory_scope_version?: string | undefined;
1596
+ parallel_group_id?: string | undefined;
1597
+ subject?: {
1598
+ regulatory_tags?: string[] | undefined;
1599
+ resource_urn?: string | undefined;
1600
+ data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | "audit_of_audit" | undefined;
1601
+ } | undefined;
824
1602
  model_ref?: {
825
1603
  provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
826
1604
  model_id: string;
@@ -830,6 +1608,36 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
830
1608
  input_tokens?: number | undefined;
831
1609
  output_tokens?: number | undefined;
832
1610
  temperature?: number | undefined;
1611
+ streaming?: boolean | undefined;
1612
+ } | undefined;
1613
+ suspension_details?: {
1614
+ reason: "other" | "awaiting_human_approval" | "awaiting_human_input" | "awaiting_webhook" | "awaiting_schedule" | "awaiting_external_system" | "awaiting_subagent";
1615
+ expected_resumer?: string | undefined;
1616
+ expected_resume_by?: string | undefined;
1617
+ detection_source?: "framework_inferred" | "customer_explicit" | "derived" | undefined;
1618
+ framework_signal?: {
1619
+ framework?: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "mcp" | "manual" | "otel" | undefined;
1620
+ signal_name?: string | undefined;
1621
+ signal_payload_hash?: string | undefined;
1622
+ } | undefined;
1623
+ } | undefined;
1624
+ resume_details?: {
1625
+ triggered_by: "other" | "human_approval_granted" | "human_input_received" | "webhook_received" | "schedule_fired" | "external_system_response" | "subagent_completed" | "manual_resume";
1626
+ resumer_principal?: string | undefined;
1627
+ suspension_duration_seconds?: number | undefined;
1628
+ suspension_started_event_id?: string | undefined;
1629
+ } | undefined;
1630
+ delegation_details?: {
1631
+ delegated_run_id: string;
1632
+ delegated_agent_identity: string;
1633
+ framework_signal?: "other" | "manual" | "langgraph_subgraph" | "openai_agents_as_tool" | "claude_agent_sdk_subagent" | undefined;
1634
+ wait_for_completion?: boolean | undefined;
1635
+ } | undefined;
1636
+ handoff_details?: {
1637
+ target_run_id: string;
1638
+ target_agent_identity: string;
1639
+ framework_signal?: "other" | "manual" | "openai_agents_handoff" | "langgraph_explicit" | undefined;
1640
+ handoff_reason?: string | undefined;
833
1641
  } | undefined;
834
1642
  payload_ref?: {
835
1643
  sha256: string;
@@ -840,21 +1648,39 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
840
1648
  data_key_wrapped: string;
841
1649
  kms_key_arn?: string | undefined;
842
1650
  };
843
- 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;
1651
+ 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;
844
1652
  redaction_applied?: {
845
1653
  redacted_classes?: string[] | undefined;
846
1654
  tokenized_classes?: string[] | undefined;
847
1655
  classifier_version?: string | undefined;
848
1656
  } | undefined;
849
1657
  } | undefined;
850
- regulatory_scope_version?: string | undefined;
1658
+ otel_attributes?: {
1659
+ gen_ai_system?: string | undefined;
1660
+ gen_ai_operation_name?: string | undefined;
1661
+ gen_ai_provider_name?: string | undefined;
1662
+ gen_ai_request_model?: string | undefined;
1663
+ gen_ai_response_model?: string | undefined;
1664
+ gen_ai_request_temperature?: number | undefined;
1665
+ gen_ai_request_top_p?: number | undefined;
1666
+ gen_ai_request_max_tokens?: number | undefined;
1667
+ gen_ai_response_id?: string | undefined;
1668
+ gen_ai_response_finish_reasons?: string[] | undefined;
1669
+ gen_ai_usage_input_tokens?: number | undefined;
1670
+ gen_ai_usage_output_tokens?: number | undefined;
1671
+ gen_ai_tool_name?: string | undefined;
1672
+ gen_ai_tool_call_id?: string | undefined;
1673
+ gen_ai_agent_id?: string | undefined;
1674
+ gen_ai_agent_name?: string | undefined;
1675
+ gen_ai_agent_description?: string | undefined;
1676
+ gen_ai_conversation_id?: string | undefined;
1677
+ extra?: Record<string, string | number | boolean> | undefined;
1678
+ } | undefined;
851
1679
  anomaly_flags?: {
852
- 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";
1680
+ 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";
853
1681
  severity: "info" | "warning" | "error" | "critical";
854
1682
  detail?: string | undefined;
855
1683
  }[] | undefined;
856
- environment?: "production" | "staging" | "development" | undefined;
857
- labels?: Record<string, string> | undefined;
858
1684
  merkle_inclusion?: {
859
1685
  manifest_uri: string;
860
1686
  leaf_index: number;