@runfile-ai/schemas 0.1.0

package/dist/event.d.ts

@@ -0,0 +1,866 @@
+import { z } from 'zod';
+export declare const ActorSchema: z.ZodEffects<z.ZodObject<{
+    type: z.ZodEnum<["agent", "human", "tool", "system"]>;
+    agent_identity: z.ZodOptional<z.ZodString>;
+    human_principal: z.ZodOptional<z.ZodString>;
+    delegation_chain: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    tool_id: z.ZodOptional<z.ZodString>;
+    tool_version_hash: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "agent" | "human" | "tool" | "system";
+    delegation_chain: string[];
+    agent_identity?: string | undefined;
+    human_principal?: string | undefined;
+    tool_id?: string | undefined;
+    tool_version_hash?: string | undefined;
+}, {
+    type: "agent" | "human" | "tool" | "system";
+    agent_identity?: string | undefined;
+    human_principal?: string | undefined;
+    delegation_chain?: string[] | undefined;
+    tool_id?: string | undefined;
+    tool_version_hash?: string | undefined;
+}>, {
+    type: "agent" | "human" | "tool" | "system";
+    delegation_chain: string[];
+    agent_identity?: string | undefined;
+    human_principal?: string | undefined;
+    tool_id?: string | undefined;
+    tool_version_hash?: string | undefined;
+}, {
+    type: "agent" | "human" | "tool" | "system";
+    agent_identity?: string | undefined;
+    human_principal?: string | undefined;
+    delegation_chain?: string[] | undefined;
+    tool_id?: string | undefined;
+    tool_version_hash?: string | undefined;
+}>;
+export type Actor = z.infer<typeof ActorSchema>;
+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"]>;
+export type ActionKind = z.infer<typeof ActionKindEnum>;
+export declare const ActionOutcomeEnum: z.ZodEnum<["success", "failure", "partial", "timeout", "cancelled"]>;
+export declare const ActionSchema: z.ZodObject<{
+    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"]>;
+    name: z.ZodString;
+    outcome: z.ZodOptional<z.ZodEnum<["success", "failure", "partial", "timeout", "cancelled"]>>;
+    duration_ms: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    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";
+    name: string;
+    outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
+    duration_ms?: number | undefined;
+}, {
+    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";
+    name: string;
+    outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
+    duration_ms?: number | undefined;
+}>;
+export type Action = z.infer<typeof ActionSchema>;
+export declare const DataClassificationEnum: z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci"]>;
+export declare const SubjectSchema: z.ZodObject<{
+    resource_urn: z.ZodOptional<z.ZodString>;
+    data_classification: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci"]>>;
+    regulatory_tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    regulatory_tags?: string[] | undefined;
+    resource_urn?: string | undefined;
+    data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
+}, {
+    regulatory_tags?: string[] | undefined;
+    resource_urn?: string | undefined;
+    data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
+}>;
+export type Subject = z.infer<typeof SubjectSchema>;
+export declare const ModelProviderEnum: z.ZodEnum<["anthropic", "openai", "google", "aws_bedrock", "azure_openai", "ollama", "self_hosted", "other"]>;
+export declare const ModelRefSchema: z.ZodObject<{
+    provider: z.ZodEnum<["anthropic", "openai", "google", "aws_bedrock", "azure_openai", "ollama", "self_hosted", "other"]>;
+    model_id: z.ZodString;
+    model_version_hash: z.ZodOptional<z.ZodString>;
+    system_prompt_hash: z.ZodOptional<z.ZodString>;
+    tools_hash: z.ZodOptional<z.ZodString>;
+    input_tokens: z.ZodOptional<z.ZodNumber>;
+    output_tokens: z.ZodOptional<z.ZodNumber>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
+    model_id: string;
+    model_version_hash?: string | undefined;
+    system_prompt_hash?: string | undefined;
+    tools_hash?: string | undefined;
+    input_tokens?: number | undefined;
+    output_tokens?: number | undefined;
+    temperature?: number | undefined;
+}, {
+    provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
+    model_id: string;
+    model_version_hash?: string | undefined;
+    system_prompt_hash?: string | undefined;
+    tools_hash?: string | undefined;
+    input_tokens?: number | undefined;
+    output_tokens?: number | undefined;
+    temperature?: number | undefined;
+}>;
+export type ModelRef = z.infer<typeof ModelRefSchema>;
+export declare const DecisionOutcomeEnum: z.ZodEnum<["approved", "denied", "escalated", "deferred", "no_action", "custom"]>;
+export declare const DecisionSchema: z.ZodObject<{
+    outcome: z.ZodEnum<["approved", "denied", "escalated", "deferred", "no_action", "custom"]>;
+    outcome_label: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    human_in_the_loop: z.ZodOptional<z.ZodBoolean>;
+    policy_thresholds_crossed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    reversed_by_event: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
+    outcome_label?: string | undefined;
+    confidence?: number | undefined;
+    human_in_the_loop?: boolean | undefined;
+    policy_thresholds_crossed?: string[] | undefined;
+    reversed_by_event?: string | undefined;
+}, {
+    outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
+    outcome_label?: string | undefined;
+    confidence?: number | undefined;
+    human_in_the_loop?: boolean | undefined;
+    policy_thresholds_crossed?: string[] | undefined;
+    reversed_by_event?: string | undefined;
+}>;
+export type Decision = z.infer<typeof DecisionSchema>;
+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"]>;
+export declare const RedactionAppliedSchema: z.ZodObject<{
+    redacted_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tokenized_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    classifier_version: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    redacted_classes?: string[] | undefined;
+    tokenized_classes?: string[] | undefined;
+    classifier_version?: string | undefined;
+}, {
+    redacted_classes?: string[] | undefined;
+    tokenized_classes?: string[] | undefined;
+    classifier_version?: string | undefined;
+}>;
+export type RedactionApplied = z.infer<typeof RedactionAppliedSchema>;
+export declare const PayloadEncryptionSchema: z.ZodObject<{
+    algorithm: z.ZodLiteral<"aes-256-gcm">;
+    data_key_wrapped: z.ZodString;
+    kms_key_arn: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    algorithm: "aes-256-gcm";
+    data_key_wrapped: string;
+    kms_key_arn?: string | undefined;
+}, {
+    algorithm: "aes-256-gcm";
+    data_key_wrapped: string;
+    kms_key_arn?: string | undefined;
+}>;
+export type PayloadEncryption = z.infer<typeof PayloadEncryptionSchema>;
+export declare const PayloadRefSchema: z.ZodObject<{
+    s3_uri: z.ZodString;
+    sha256: z.ZodString;
+    size_bytes: z.ZodNumber;
+    encryption: z.ZodObject<{
+        algorithm: z.ZodLiteral<"aes-256-gcm">;
+        data_key_wrapped: z.ZodString;
+        kms_key_arn: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        algorithm: "aes-256-gcm";
+        data_key_wrapped: string;
+        kms_key_arn?: string | undefined;
+    }, {
+        algorithm: "aes-256-gcm";
+        data_key_wrapped: string;
+        kms_key_arn?: string | undefined;
+    }>;
+    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"]>>;
+    redaction_applied: z.ZodOptional<z.ZodObject<{
+        redacted_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        tokenized_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        classifier_version: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        redacted_classes?: string[] | undefined;
+        tokenized_classes?: string[] | undefined;
+        classifier_version?: string | undefined;
+    }, {
+        redacted_classes?: string[] | undefined;
+        tokenized_classes?: string[] | undefined;
+        classifier_version?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    sha256: string;
+    s3_uri: string;
+    size_bytes: number;
+    encryption: {
+        algorithm: "aes-256-gcm";
+        data_key_wrapped: string;
+        kms_key_arn?: string | undefined;
+    };
+    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;
+    redaction_applied?: {
+        redacted_classes?: string[] | undefined;
+        tokenized_classes?: string[] | undefined;
+        classifier_version?: string | undefined;
+    } | undefined;
+}, {
+    sha256: string;
+    s3_uri: string;
+    size_bytes: number;
+    encryption: {
+        algorithm: "aes-256-gcm";
+        data_key_wrapped: string;
+        kms_key_arn?: string | undefined;
+    };
+    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;
+    redaction_applied?: {
+        redacted_classes?: string[] | undefined;
+        tokenized_classes?: string[] | undefined;
+        classifier_version?: string | undefined;
+    } | undefined;
+}>;
+export type PayloadRef = z.infer<typeof PayloadRefSchema>;
+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"]>;
+export declare const AnomalySeverityEnum: z.ZodEnum<["info", "warning", "error", "critical"]>;
+export declare const AnomalyFlagSchema: z.ZodObject<{
+    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"]>;
+    severity: z.ZodEnum<["info", "warning", "error", "critical"]>;
+    detail: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    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";
+    severity: "info" | "warning" | "error" | "critical";
+    detail?: string | undefined;
+}, {
+    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";
+    severity: "info" | "warning" | "error" | "critical";
+    detail?: string | undefined;
+}>;
+export type AnomalyFlag = z.infer<typeof AnomalyFlagSchema>;
+export declare const WallClockSourceEnum: z.ZodEnum<["aws_time_sync", "ntp", "host_system", "unknown"]>;
+export declare const SdkNameEnum: z.ZodEnum<["runfile-py", "@runfile/sdk"]>;
+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"]>;
+export declare const SdkMetadataSchema: z.ZodObject<{
+    name: z.ZodEnum<["runfile-py", "@runfile/sdk"]>;
+    version: z.ZodString;
+    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"]>;
+    framework_version: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
+    name: "runfile-py" | "@runfile/sdk";
+    version: string;
+    framework_version?: string | undefined;
+    host?: string | undefined;
+}, {
+    framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
+    name: "runfile-py" | "@runfile/sdk";
+    version: string;
+    framework_version?: string | undefined;
+    host?: string | undefined;
+}>;
+export type SdkMetadata = z.infer<typeof SdkMetadataSchema>;
+export declare const EnvironmentEnum: z.ZodEnum<["production", "staging", "development"]>;
+export declare const LabelsSchema: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>;
+export type Labels = z.infer<typeof LabelsSchema>;
+export declare const MerkleInclusionSchema: z.ZodObject<{
+    manifest_uri: z.ZodString;
+    leaf_index: z.ZodNumber;
+    merkle_root: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    manifest_uri: string;
+    leaf_index: number;
+    merkle_root: string;
+}, {
+    manifest_uri: string;
+    leaf_index: number;
+    merkle_root: string;
+}>;
+export type MerkleInclusion = z.infer<typeof MerkleInclusionSchema>;
+/**
+ * RunfileEvent — the canonical event shape every service in the system reads, writes, or
+ * reasons about. Hash-chained within `agent_run_id` and committed to a daily Merkle root.
+ *
+ * Conditional-required fields (enforced via superRefine below):
+ *   - kind=llm_call    → model_ref required
+ *   - kind=decision    → decision required
+ *   - actor.type=agent → actor.agent_identity required (also enforced inside ActorSchema)
+ *   - actor.type=tool  → actor.tool_id + actor.tool_version_hash required (also enforced inside ActorSchema)
+ */
+export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
+    schema_version: z.ZodString;
+    event_id: z.ZodString;
+    tenant_id: z.ZodString;
+    agent_run_id: z.ZodString;
+    parent_event_id: z.ZodNullable<z.ZodString>;
+    captured_at: z.ZodString;
+    received_at: z.ZodString;
+    wall_clock_source: z.ZodEnum<["aws_time_sync", "ntp", "host_system", "unknown"]>;
+    sdk: z.ZodObject<{
+        name: z.ZodEnum<["runfile-py", "@runfile/sdk"]>;
+        version: z.ZodString;
+        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"]>;
+        framework_version: z.ZodOptional<z.ZodString>;
+        host: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
+        name: "runfile-py" | "@runfile/sdk";
+        version: string;
+        framework_version?: string | undefined;
+        host?: string | undefined;
+    }, {
+        framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
+        name: "runfile-py" | "@runfile/sdk";
+        version: string;
+        framework_version?: string | undefined;
+        host?: string | undefined;
+    }>;
+    actor: z.ZodEffects<z.ZodObject<{
+        type: z.ZodEnum<["agent", "human", "tool", "system"]>;
+        agent_identity: z.ZodOptional<z.ZodString>;
+        human_principal: z.ZodOptional<z.ZodString>;
+        delegation_chain: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        tool_id: z.ZodOptional<z.ZodString>;
+        tool_version_hash: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        type: "agent" | "human" | "tool" | "system";
+        delegation_chain: string[];
+        agent_identity?: string | undefined;
+        human_principal?: string | undefined;
+        tool_id?: string | undefined;
+        tool_version_hash?: string | undefined;
+    }, {
+        type: "agent" | "human" | "tool" | "system";
+        agent_identity?: string | undefined;
+        human_principal?: string | undefined;
+        delegation_chain?: string[] | undefined;
+        tool_id?: string | undefined;
+        tool_version_hash?: string | undefined;
+    }>, {
+        type: "agent" | "human" | "tool" | "system";
+        delegation_chain: string[];
+        agent_identity?: string | undefined;
+        human_principal?: string | undefined;
+        tool_id?: string | undefined;
+        tool_version_hash?: string | undefined;
+    }, {
+        type: "agent" | "human" | "tool" | "system";
+        agent_identity?: string | undefined;
+        human_principal?: string | undefined;
+        delegation_chain?: string[] | undefined;
+        tool_id?: string | undefined;
+        tool_version_hash?: string | undefined;
+    }>;
+    action: z.ZodObject<{
+        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"]>;
+        name: z.ZodString;
+        outcome: z.ZodOptional<z.ZodEnum<["success", "failure", "partial", "timeout", "cancelled"]>>;
+        duration_ms: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        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";
+        name: string;
+        outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
+        duration_ms?: number | undefined;
+    }, {
+        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";
+        name: string;
+        outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
+        duration_ms?: number | undefined;
+    }>;
+    subject: z.ZodObject<{
+        resource_urn: z.ZodOptional<z.ZodString>;
+        data_classification: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "pii", "phi", "pci", "fci"]>>;
+        regulatory_tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        regulatory_tags?: string[] | undefined;
+        resource_urn?: string | undefined;
+        data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
+    }, {
+        regulatory_tags?: string[] | undefined;
+        resource_urn?: string | undefined;
+        data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
+    }>;
+    model_ref: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodEnum<["anthropic", "openai", "google", "aws_bedrock", "azure_openai", "ollama", "self_hosted", "other"]>;
+        model_id: z.ZodString;
+        model_version_hash: z.ZodOptional<z.ZodString>;
+        system_prompt_hash: z.ZodOptional<z.ZodString>;
+        tools_hash: z.ZodOptional<z.ZodString>;
+        input_tokens: z.ZodOptional<z.ZodNumber>;
+        output_tokens: z.ZodOptional<z.ZodNumber>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
+        model_id: string;
+        model_version_hash?: string | undefined;
+        system_prompt_hash?: string | undefined;
+        tools_hash?: string | undefined;
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+        temperature?: number | undefined;
+    }, {
+        provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
+        model_id: string;
+        model_version_hash?: string | undefined;
+        system_prompt_hash?: string | undefined;
+        tools_hash?: string | undefined;
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+        temperature?: number | undefined;
+    }>>;
+    decision: z.ZodOptional<z.ZodObject<{
+        outcome: z.ZodEnum<["approved", "denied", "escalated", "deferred", "no_action", "custom"]>;
+        outcome_label: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        human_in_the_loop: z.ZodOptional<z.ZodBoolean>;
+        policy_thresholds_crossed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reversed_by_event: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
+        outcome_label?: string | undefined;
+        confidence?: number | undefined;
+        human_in_the_loop?: boolean | undefined;
+        policy_thresholds_crossed?: string[] | undefined;
+        reversed_by_event?: string | undefined;
+    }, {
+        outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
+        outcome_label?: string | undefined;
+        confidence?: number | undefined;
+        human_in_the_loop?: boolean | undefined;
+        policy_thresholds_crossed?: string[] | undefined;
+        reversed_by_event?: string | undefined;
+    }>>;
+    payload_ref: z.ZodOptional<z.ZodObject<{
+        s3_uri: z.ZodString;
+        sha256: z.ZodString;
+        size_bytes: z.ZodNumber;
+        encryption: z.ZodObject<{
+            algorithm: z.ZodLiteral<"aes-256-gcm">;
+            data_key_wrapped: z.ZodString;
+            kms_key_arn: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            algorithm: "aes-256-gcm";
+            data_key_wrapped: string;
+            kms_key_arn?: string | undefined;
+        }, {
+            algorithm: "aes-256-gcm";
+            data_key_wrapped: string;
+            kms_key_arn?: string | undefined;
+        }>;
+        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"]>>;
+        redaction_applied: z.ZodOptional<z.ZodObject<{
+            redacted_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            tokenized_classes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            classifier_version: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            redacted_classes?: string[] | undefined;
+            tokenized_classes?: string[] | undefined;
+            classifier_version?: string | undefined;
+        }, {
+            redacted_classes?: string[] | undefined;
+            tokenized_classes?: string[] | undefined;
+            classifier_version?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        sha256: string;
+        s3_uri: string;
+        size_bytes: number;
+        encryption: {
+            algorithm: "aes-256-gcm";
+            data_key_wrapped: string;
+            kms_key_arn?: string | undefined;
+        };
+        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;
+        redaction_applied?: {
+            redacted_classes?: string[] | undefined;
+            tokenized_classes?: string[] | undefined;
+            classifier_version?: string | undefined;
+        } | undefined;
+    }, {
+        sha256: string;
+        s3_uri: string;
+        size_bytes: number;
+        encryption: {
+            algorithm: "aes-256-gcm";
+            data_key_wrapped: string;
+            kms_key_arn?: string | undefined;
+        };
+        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;
+        redaction_applied?: {
+            redacted_classes?: string[] | undefined;
+            tokenized_classes?: string[] | undefined;
+            classifier_version?: string | undefined;
+        } | undefined;
+    }>>;
+    redaction_policy_version: z.ZodString;
+    regulatory_scope_version: z.ZodOptional<z.ZodString>;
+    anomaly_flags: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        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"]>;
+        severity: z.ZodEnum<["info", "warning", "error", "critical"]>;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        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";
+        severity: "info" | "warning" | "error" | "critical";
+        detail?: string | undefined;
+    }, {
+        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";
+        severity: "info" | "warning" | "error" | "critical";
+        detail?: string | undefined;
+    }>, "many">>;
+    environment: z.ZodOptional<z.ZodEnum<["production", "staging", "development"]>>;
+    labels: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>>;
+    prev_hash: z.ZodString;
+    event_hash: z.ZodString;
+    merkle_inclusion: z.ZodOptional<z.ZodObject<{
+        manifest_uri: z.ZodString;
+        leaf_index: z.ZodNumber;
+        merkle_root: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        manifest_uri: string;
+        leaf_index: number;
+        merkle_root: string;
+    }, {
+        manifest_uri: string;
+        leaf_index: number;
+        merkle_root: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    event_hash: string;
+    schema_version: string;
+    event_id: string;
+    tenant_id: string;
+    agent_run_id: string;
+    parent_event_id: string | null;
+    captured_at: string;
+    received_at: string;
+    wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
+    sdk: {
+        framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
+        name: "runfile-py" | "@runfile/sdk";
+        version: string;
+        framework_version?: string | undefined;
+        host?: string | undefined;
+    };
+    actor: {
+        type: "agent" | "human" | "tool" | "system";
+        delegation_chain: string[];
+        agent_identity?: string | undefined;
+        human_principal?: string | undefined;
+        tool_id?: string | undefined;
+        tool_version_hash?: string | undefined;
+    };
+    action: {
+        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";
+        name: string;
+        outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
+        duration_ms?: number | undefined;
+    };
+    subject: {
+        regulatory_tags?: string[] | undefined;
+        resource_urn?: string | undefined;
+        data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
+    };
+    redaction_policy_version: string;
+    prev_hash: string;
+    decision?: {
+        outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
+        outcome_label?: string | undefined;
+        confidence?: number | undefined;
+        human_in_the_loop?: boolean | undefined;
+        policy_thresholds_crossed?: string[] | undefined;
+        reversed_by_event?: string | undefined;
+    } | undefined;
+    model_ref?: {
+        provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
+        model_id: string;
+        model_version_hash?: string | undefined;
+        system_prompt_hash?: string | undefined;
+        tools_hash?: string | undefined;
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+        temperature?: number | undefined;
+    } | undefined;
+    payload_ref?: {
+        sha256: string;
+        s3_uri: string;
+        size_bytes: number;
+        encryption: {
+            algorithm: "aes-256-gcm";
+            data_key_wrapped: string;
+            kms_key_arn?: string | undefined;
+        };
+        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;
+        redaction_applied?: {
+            redacted_classes?: string[] | undefined;
+            tokenized_classes?: string[] | undefined;
+            classifier_version?: string | undefined;
+        } | undefined;
+    } | undefined;
+    regulatory_scope_version?: string | undefined;
+    anomaly_flags?: {
+        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";
+        severity: "info" | "warning" | "error" | "critical";
+        detail?: string | undefined;
+    }[] | undefined;
+    environment?: "production" | "staging" | "development" | undefined;
+    labels?: Record<string, string> | undefined;
+    merkle_inclusion?: {
+        manifest_uri: string;
+        leaf_index: number;
+        merkle_root: string;
+    } | undefined;
+}, {
+    event_hash: string;
+    schema_version: string;
+    event_id: string;
+    tenant_id: string;
+    agent_run_id: string;
+    parent_event_id: string | null;
+    captured_at: string;
+    received_at: string;
+    wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
+    sdk: {
+        framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
+        name: "runfile-py" | "@runfile/sdk";
+        version: string;
+        framework_version?: string | undefined;
+        host?: string | undefined;
+    };
+    actor: {
+        type: "agent" | "human" | "tool" | "system";
+        agent_identity?: string | undefined;
+        human_principal?: string | undefined;
+        delegation_chain?: string[] | undefined;
+        tool_id?: string | undefined;
+        tool_version_hash?: string | undefined;
+    };
+    action: {
+        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";
+        name: string;
+        outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
+        duration_ms?: number | undefined;
+    };
+    subject: {
+        regulatory_tags?: string[] | undefined;
+        resource_urn?: string | undefined;
+        data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
+    };
+    redaction_policy_version: string;
+    prev_hash: string;
+    decision?: {
+        outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
+        outcome_label?: string | undefined;
+        confidence?: number | undefined;
+        human_in_the_loop?: boolean | undefined;
+        policy_thresholds_crossed?: string[] | undefined;
+        reversed_by_event?: string | undefined;
+    } | undefined;
+    model_ref?: {
+        provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
+        model_id: string;
+        model_version_hash?: string | undefined;
+        system_prompt_hash?: string | undefined;
+        tools_hash?: string | undefined;
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+        temperature?: number | undefined;
+    } | undefined;
+    payload_ref?: {
+        sha256: string;
+        s3_uri: string;
+        size_bytes: number;
+        encryption: {
+            algorithm: "aes-256-gcm";
+            data_key_wrapped: string;
+            kms_key_arn?: string | undefined;
+        };
+        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;
+        redaction_applied?: {
+            redacted_classes?: string[] | undefined;
+            tokenized_classes?: string[] | undefined;
+            classifier_version?: string | undefined;
+        } | undefined;
+    } | undefined;
+    regulatory_scope_version?: string | undefined;
+    anomaly_flags?: {
+        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";
+        severity: "info" | "warning" | "error" | "critical";
+        detail?: string | undefined;
+    }[] | undefined;
+    environment?: "production" | "staging" | "development" | undefined;
+    labels?: Record<string, string> | undefined;
+    merkle_inclusion?: {
+        manifest_uri: string;
+        leaf_index: number;
+        merkle_root: string;
+    } | undefined;
+}>, {
+    event_hash: string;
+    schema_version: string;
+    event_id: string;
+    tenant_id: string;
+    agent_run_id: string;
+    parent_event_id: string | null;
+    captured_at: string;
+    received_at: string;
+    wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
+    sdk: {
+        framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
+        name: "runfile-py" | "@runfile/sdk";
+        version: string;
+        framework_version?: string | undefined;
+        host?: string | undefined;
+    };
+    actor: {
+        type: "agent" | "human" | "tool" | "system";
+        delegation_chain: string[];
+        agent_identity?: string | undefined;
+        human_principal?: string | undefined;
+        tool_id?: string | undefined;
+        tool_version_hash?: string | undefined;
+    };
+    action: {
+        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";
+        name: string;
+        outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
+        duration_ms?: number | undefined;
+    };
+    subject: {
+        regulatory_tags?: string[] | undefined;
+        resource_urn?: string | undefined;
+        data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
+    };
+    redaction_policy_version: string;
+    prev_hash: string;
+    decision?: {
+        outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
+        outcome_label?: string | undefined;
+        confidence?: number | undefined;
+        human_in_the_loop?: boolean | undefined;
+        policy_thresholds_crossed?: string[] | undefined;
+        reversed_by_event?: string | undefined;
+    } | undefined;
+    model_ref?: {
+        provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
+        model_id: string;
+        model_version_hash?: string | undefined;
+        system_prompt_hash?: string | undefined;
+        tools_hash?: string | undefined;
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+        temperature?: number | undefined;
+    } | undefined;
+    payload_ref?: {
+        sha256: string;
+        s3_uri: string;
+        size_bytes: number;
+        encryption: {
+            algorithm: "aes-256-gcm";
+            data_key_wrapped: string;
+            kms_key_arn?: string | undefined;
+        };
+        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;
+        redaction_applied?: {
+            redacted_classes?: string[] | undefined;
+            tokenized_classes?: string[] | undefined;
+            classifier_version?: string | undefined;
+        } | undefined;
+    } | undefined;
+    regulatory_scope_version?: string | undefined;
+    anomaly_flags?: {
+        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";
+        severity: "info" | "warning" | "error" | "critical";
+        detail?: string | undefined;
+    }[] | undefined;
+    environment?: "production" | "staging" | "development" | undefined;
+    labels?: Record<string, string> | undefined;
+    merkle_inclusion?: {
+        manifest_uri: string;
+        leaf_index: number;
+        merkle_root: string;
+    } | undefined;
+}, {
+    event_hash: string;
+    schema_version: string;
+    event_id: string;
+    tenant_id: string;
+    agent_run_id: string;
+    parent_event_id: string | null;
+    captured_at: string;
+    received_at: string;
+    wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
+    sdk: {
+        framework: "langgraph" | "langgraph_js" | "openai_agents" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "vercel_ai_sdk" | "mcp_client" | "otel_generic" | "manual";
+        name: "runfile-py" | "@runfile/sdk";
+        version: string;
+        framework_version?: string | undefined;
+        host?: string | undefined;
+    };
+    actor: {
+        type: "agent" | "human" | "tool" | "system";
+        agent_identity?: string | undefined;
+        human_principal?: string | undefined;
+        delegation_chain?: string[] | undefined;
+        tool_id?: string | undefined;
+        tool_version_hash?: string | undefined;
+    };
+    action: {
+        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";
+        name: string;
+        outcome?: "success" | "failure" | "partial" | "timeout" | "cancelled" | undefined;
+        duration_ms?: number | undefined;
+    };
+    subject: {
+        regulatory_tags?: string[] | undefined;
+        resource_urn?: string | undefined;
+        data_classification?: "public" | "internal" | "confidential" | "pii" | "phi" | "pci" | "fci" | undefined;
+    };
+    redaction_policy_version: string;
+    prev_hash: string;
+    decision?: {
+        outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
+        outcome_label?: string | undefined;
+        confidence?: number | undefined;
+        human_in_the_loop?: boolean | undefined;
+        policy_thresholds_crossed?: string[] | undefined;
+        reversed_by_event?: string | undefined;
+    } | undefined;
+    model_ref?: {
+        provider: "anthropic" | "openai" | "google" | "aws_bedrock" | "azure_openai" | "ollama" | "self_hosted" | "other";
+        model_id: string;
+        model_version_hash?: string | undefined;
+        system_prompt_hash?: string | undefined;
+        tools_hash?: string | undefined;
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+        temperature?: number | undefined;
+    } | undefined;
+    payload_ref?: {
+        sha256: string;
+        s3_uri: string;
+        size_bytes: number;
+        encryption: {
+            algorithm: "aes-256-gcm";
+            data_key_wrapped: string;
+            kms_key_arn?: string | undefined;
+        };
+        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;
+        redaction_applied?: {
+            redacted_classes?: string[] | undefined;
+            tokenized_classes?: string[] | undefined;
+            classifier_version?: string | undefined;
+        } | undefined;
+    } | undefined;
+    regulatory_scope_version?: string | undefined;
+    anomaly_flags?: {
+        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";
+        severity: "info" | "warning" | "error" | "critical";
+        detail?: string | undefined;
+    }[] | undefined;
+    environment?: "production" | "staging" | "development" | undefined;
+    labels?: Record<string, string> | undefined;
+    merkle_inclusion?: {
+        manifest_uri: string;
+        leaf_index: number;
+        merkle_root: string;
+    } | undefined;
+}>;
+export type RunfileEvent = z.infer<typeof RunfileEventSchema>;
+export declare const ZERO_PREV_HASH: `sha256:${string}`;
+//# sourceMappingURL=event.d.ts.map