@truefoundry/trueforge-core 0.0.0 → 0.1.0-rc.0

package/dist/agent-session/schemas/events.d.ts

@@ -0,0 +1,1037 @@
+/**
+ * Turn/session event product schemas. Event payloads come from the harness; this
+ * module owns turn lifecycle events (turn.created / turn.done) and the persisted
+ * event unions the store writes. SSE streaming envelopes stay in server/schemas.
+ */
+import { z } from '@hono/zod-openapi';
+import type { WithRegisteredPassthrough } from '../../core/events/PassthroughEvents';
+/** Harness event types plus the turn lifecycle types owned by agentSession. */
+export declare const EventType: {
+    readonly AGENT_CONTEXT_OVERWRITE: 'agent.context.overwrite';
+    readonly MCP_AUTH_REQUIRED: 'mcp.auth_required';
+    readonly MCP_INITIALIZE: 'mcp.initialize';
+    readonly MODEL_MESSAGE: 'model.message';
+    readonly MODEL_MESSAGE_DELTA: 'model.message.delta';
+    readonly SANDBOX_CREATED: 'sandbox.created';
+    readonly THREAD_CREATED: 'thread.created';
+    readonly THREAD_DONE: 'thread.done';
+    readonly TOOL_RESPONSE: 'tool.response';
+    readonly TOOL_APPROVAL_REQUIRED: 'tool.approval_required';
+    readonly TOOL_RESPONSE_REQUIRED: 'tool.response_required';
+    readonly USER_TOOL_APPROVAL: 'user.tool_approval';
+    readonly USER_TOOL_RESPONSE: 'user.tool_response';
+    readonly USER_MESSAGE: 'user.message';
+    readonly TURN_CREATED: 'turn.created';
+    readonly TURN_DONE: 'turn.done';
+};
+export declare const TurnCreatedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"turn.created">;
+    id: z.ZodString;
+    turn_id: z.ZodString;
+    previous_turn_id: z.ZodNullable<z.ZodString>;
+    input: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"user.message">;
+        content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            name: z.ZodString;
+            data: z.ZodString;
+        }, z.core.$strip>], "type">>]>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"user.tool_approval">;
+        thread_id: z.ZodString;
+        tool_call_id: z.ZodString;
+        approval: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"allow">;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"deny">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "status">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"user.tool_response">;
+        thread_id: z.ZodString;
+        tool_call_id: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>], "type">>>;
+    state: z.ZodObject<{
+        status: z.ZodLiteral<"running">;
+    }, z.core.$strip>;
+    created_at: z.ZodString;
+    thread_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const TurnDoneEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"turn.done">;
+    id: z.ZodString;
+    state: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"done">;
+        output: z.ZodUnion<readonly [z.ZodObject<{
+            content: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"refusal">;
+                refusal: z.ZodString;
+            }, z.core.$strip>]>>]>>>;
+            name: z.ZodOptional<z.ZodString>;
+            refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            reasoning_content: z.ZodOptional<z.ZodString>;
+            tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodLiteral<"function">;
+                function: z.ZodObject<{
+                    name: z.ZodString;
+                    arguments: z.ZodString;
+                }, z.core.$strip>;
+                provider_specific_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                tool_info: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"truefoundry-system">;
+                    name: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"mcp">;
+                    server_id: z.ZodString;
+                    server_name: z.ZodString;
+                    name: z.ZodString;
+                }, z.core.$strip>], "type">;
+            }, z.core.$strip>>>;
+            type: z.ZodLiteral<"model.message">;
+            id: z.ZodString;
+            thread_id: z.ZodString;
+            finish_reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                content_filter: "content_filter";
+                function_call: "function_call";
+                length: "length";
+                stop: "stop";
+                tool_calls: "tool_calls";
+            }>, z.ZodNull]>>;
+            created_at: z.ZodString;
+            usage: z.ZodOptional<z.ZodObject<{
+                input_tokens: z.ZodNumber;
+                output_tokens: z.ZodNumber;
+                cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+                cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+                input_tokens_breakdown: z.ZodObject<{
+                    harness: z.ZodNumber;
+                    skills: z.ZodNumber;
+                    instructions: z.ZodNumber;
+                    tool_definitions: z.ZodNumber;
+                    messages: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodNull]>;
+        required_actions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"tool.approval_required">;
+            id: z.ZodString;
+            created_at: z.ZodString;
+            thread_id: z.ZodString;
+            tool_calls: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                source_event_id: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tool.response_required">;
+            id: z.ZodString;
+            created_at: z.ZodString;
+            thread_id: z.ZodString;
+            tool_calls: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                source_event_id: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            created_at: z.ZodString;
+            thread_id: z.ZodNullable<z.ZodString>;
+            type: z.ZodLiteral<"mcp.auth_required">;
+            mcp_servers: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                auth_url: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>], "type">>;
+        completed_at: z.ZodString;
+        metrics: z.ZodOptional<z.ZodObject<{
+            total_input_tokens: z.ZodOptional<z.ZodNumber>;
+            total_output_tokens: z.ZodOptional<z.ZodNumber>;
+            total_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+            total_reasoning_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cost_in_usd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"cancelled">;
+        reason: z.ZodEnum<typeof import("./turn").CancellationReason>;
+        completed_at: z.ZodString;
+        metrics: z.ZodOptional<z.ZodObject<{
+            total_input_tokens: z.ZodOptional<z.ZodNumber>;
+            total_output_tokens: z.ZodOptional<z.ZodNumber>;
+            total_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+            total_reasoning_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cost_in_usd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"error">;
+        message: z.ZodString;
+        completed_at: z.ZodString;
+        metrics: z.ZodOptional<z.ZodObject<{
+            total_input_tokens: z.ZodOptional<z.ZodNumber>;
+            total_output_tokens: z.ZodOptional<z.ZodNumber>;
+            total_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+            total_reasoning_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cost_in_usd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "status">;
+    created_at: z.ZodString;
+    thread_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** Built-in durable turn events — lifecycle + content; no deltas, no passthrough. */
+export declare const SessionEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"turn.created">;
+    id: z.ZodString;
+    turn_id: z.ZodString;
+    previous_turn_id: z.ZodNullable<z.ZodString>;
+    input: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"user.message">;
+        content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            name: z.ZodString;
+            data: z.ZodString;
+        }, z.core.$strip>], "type">>]>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"user.tool_approval">;
+        thread_id: z.ZodString;
+        tool_call_id: z.ZodString;
+        approval: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"allow">;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"deny">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "status">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"user.tool_response">;
+        thread_id: z.ZodString;
+        tool_call_id: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>], "type">>>;
+    state: z.ZodObject<{
+        status: z.ZodLiteral<"running">;
+    }, z.core.$strip>;
+    created_at: z.ZodString;
+    thread_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"turn.done">;
+    id: z.ZodString;
+    state: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"done">;
+        output: z.ZodUnion<readonly [z.ZodObject<{
+            content: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"refusal">;
+                refusal: z.ZodString;
+            }, z.core.$strip>]>>]>>>;
+            name: z.ZodOptional<z.ZodString>;
+            refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            reasoning_content: z.ZodOptional<z.ZodString>;
+            tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodLiteral<"function">;
+                function: z.ZodObject<{
+                    name: z.ZodString;
+                    arguments: z.ZodString;
+                }, z.core.$strip>;
+                provider_specific_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                tool_info: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"truefoundry-system">;
+                    name: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"mcp">;
+                    server_id: z.ZodString;
+                    server_name: z.ZodString;
+                    name: z.ZodString;
+                }, z.core.$strip>], "type">;
+            }, z.core.$strip>>>;
+            type: z.ZodLiteral<"model.message">;
+            id: z.ZodString;
+            thread_id: z.ZodString;
+            finish_reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                content_filter: "content_filter";
+                function_call: "function_call";
+                length: "length";
+                stop: "stop";
+                tool_calls: "tool_calls";
+            }>, z.ZodNull]>>;
+            created_at: z.ZodString;
+            usage: z.ZodOptional<z.ZodObject<{
+                input_tokens: z.ZodNumber;
+                output_tokens: z.ZodNumber;
+                cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+                cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+                input_tokens_breakdown: z.ZodObject<{
+                    harness: z.ZodNumber;
+                    skills: z.ZodNumber;
+                    instructions: z.ZodNumber;
+                    tool_definitions: z.ZodNumber;
+                    messages: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodNull]>;
+        required_actions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"tool.approval_required">;
+            id: z.ZodString;
+            created_at: z.ZodString;
+            thread_id: z.ZodString;
+            tool_calls: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                source_event_id: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tool.response_required">;
+            id: z.ZodString;
+            created_at: z.ZodString;
+            thread_id: z.ZodString;
+            tool_calls: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                source_event_id: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            created_at: z.ZodString;
+            thread_id: z.ZodNullable<z.ZodString>;
+            type: z.ZodLiteral<"mcp.auth_required">;
+            mcp_servers: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                auth_url: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>], "type">>;
+        completed_at: z.ZodString;
+        metrics: z.ZodOptional<z.ZodObject<{
+            total_input_tokens: z.ZodOptional<z.ZodNumber>;
+            total_output_tokens: z.ZodOptional<z.ZodNumber>;
+            total_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+            total_reasoning_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cost_in_usd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"cancelled">;
+        reason: z.ZodEnum<typeof import("./turn").CancellationReason>;
+        completed_at: z.ZodString;
+        metrics: z.ZodOptional<z.ZodObject<{
+            total_input_tokens: z.ZodOptional<z.ZodNumber>;
+            total_output_tokens: z.ZodOptional<z.ZodNumber>;
+            total_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+            total_reasoning_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cost_in_usd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"error">;
+        message: z.ZodString;
+        completed_at: z.ZodString;
+        metrics: z.ZodOptional<z.ZodObject<{
+            total_input_tokens: z.ZodOptional<z.ZodNumber>;
+            total_output_tokens: z.ZodOptional<z.ZodNumber>;
+            total_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+            total_reasoning_tokens: z.ZodOptional<z.ZodNumber>;
+            total_cost_in_usd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "status">;
+    created_at: z.ZodString;
+    thread_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    content: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"refusal">;
+        refusal: z.ZodString;
+    }, z.core.$strip>]>>]>>>;
+    name: z.ZodOptional<z.ZodString>;
+    refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reasoning_content: z.ZodOptional<z.ZodString>;
+    tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"function">;
+        function: z.ZodObject<{
+            name: z.ZodString;
+            arguments: z.ZodString;
+        }, z.core.$strip>;
+        provider_specific_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        tool_info: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"truefoundry-system">;
+            name: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"mcp">;
+            server_id: z.ZodString;
+            server_name: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>], "type">;
+    }, z.core.$strip>>>;
+    type: z.ZodLiteral<"model.message">;
+    id: z.ZodString;
+    thread_id: z.ZodString;
+    finish_reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        content_filter: "content_filter";
+        function_call: "function_call";
+        length: "length";
+        stop: "stop";
+        tool_calls: "tool_calls";
+    }>, z.ZodNull]>>;
+    created_at: z.ZodString;
+    usage: z.ZodOptional<z.ZodObject<{
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+        cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+        input_tokens_breakdown: z.ZodObject<{
+            harness: z.ZodNumber;
+            skills: z.ZodNumber;
+            instructions: z.ZodNumber;
+            tool_definitions: z.ZodNumber;
+            messages: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    tool_call_id: z.ZodString;
+    content: z.ZodString;
+    type: z.ZodLiteral<"tool.response">;
+    id: z.ZodString;
+    thread_id: z.ZodString;
+    created_at: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"thread.created">;
+    id: z.ZodString;
+    agent_info: z.ZodObject<{
+        type: z.ZodLiteral<"dynamic">;
+        name: z.ZodString;
+        input: z.ZodString;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    created_at: z.ZodString;
+    parent: z.ZodObject<{
+        thread_id: z.ZodString;
+        tool_call_id: z.ZodString;
+    }, z.core.$strip>;
+    thread_id: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    parent: z.ZodOptional<z.ZodObject<{
+        thread_id: z.ZodString;
+        tool_call_id: z.ZodString;
+    }, z.core.$strip>>;
+    thread_id: z.ZodString;
+    title: z.ZodString;
+    type: z.ZodLiteral<"thread.done">;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    state: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"done">;
+        output: z.ZodObject<{
+            content: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"refusal">;
+                refusal: z.ZodString;
+            }, z.core.$strip>]>>]>>>;
+            name: z.ZodOptional<z.ZodString>;
+            refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            reasoning_content: z.ZodOptional<z.ZodString>;
+            tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodLiteral<"function">;
+                function: z.ZodObject<{
+                    name: z.ZodString;
+                    arguments: z.ZodString;
+                }, z.core.$strip>;
+                provider_specific_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                tool_info: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"truefoundry-system">;
+                    name: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"mcp">;
+                    server_id: z.ZodString;
+                    server_name: z.ZodString;
+                    name: z.ZodString;
+                }, z.core.$strip>], "type">;
+            }, z.core.$strip>>>;
+            type: z.ZodLiteral<"model.message">;
+            id: z.ZodString;
+            thread_id: z.ZodString;
+            finish_reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                content_filter: "content_filter";
+                function_call: "function_call";
+                length: "length";
+                stop: "stop";
+                tool_calls: "tool_calls";
+            }>, z.ZodNull]>>;
+            created_at: z.ZodString;
+            usage: z.ZodOptional<z.ZodObject<{
+                input_tokens: z.ZodNumber;
+                output_tokens: z.ZodNumber;
+                cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+                cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+                input_tokens_breakdown: z.ZodObject<{
+                    harness: z.ZodNumber;
+                    skills: z.ZodNumber;
+                    instructions: z.ZodNumber;
+                    tool_definitions: z.ZodNumber;
+                    messages: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"error">;
+        error: z.ZodString;
+        output: z.ZodOptional<z.ZodObject<{
+            content: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"refusal">;
+                refusal: z.ZodString;
+            }, z.core.$strip>]>>]>>>;
+            name: z.ZodOptional<z.ZodString>;
+            refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            reasoning_content: z.ZodOptional<z.ZodString>;
+            tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodLiteral<"function">;
+                function: z.ZodObject<{
+                    name: z.ZodString;
+                    arguments: z.ZodString;
+                }, z.core.$strip>;
+                provider_specific_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                tool_info: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"truefoundry-system">;
+                    name: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"mcp">;
+                    server_id: z.ZodString;
+                    server_name: z.ZodString;
+                    name: z.ZodString;
+                }, z.core.$strip>], "type">;
+            }, z.core.$strip>>>;
+            type: z.ZodLiteral<"model.message">;
+            id: z.ZodString;
+            thread_id: z.ZodString;
+            finish_reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                content_filter: "content_filter";
+                function_call: "function_call";
+                length: "length";
+                stop: "stop";
+                tool_calls: "tool_calls";
+            }>, z.ZodNull]>>;
+            created_at: z.ZodString;
+            usage: z.ZodOptional<z.ZodObject<{
+                input_tokens: z.ZodNumber;
+                output_tokens: z.ZodNumber;
+                cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+                cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+                input_tokens_breakdown: z.ZodObject<{
+                    harness: z.ZodNumber;
+                    skills: z.ZodNumber;
+                    instructions: z.ZodNumber;
+                    tool_definitions: z.ZodNumber;
+                    messages: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "status">;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    created_at: z.ZodString;
+    thread_id: z.ZodNullable<z.ZodString>;
+    type: z.ZodLiteral<"mcp.auth_required">;
+    mcp_servers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        auth_url: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"mcp.initialize">;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    thread_id: z.ZodString;
+    mcp_servers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        session_id: z.ZodOptional<z.ZodString>;
+        transport_type: z.ZodOptional<z.ZodEnum<{
+            sse: "sse";
+            "streamable-http": "streamable-http";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"sandbox.created">;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    sandbox_id: z.ZodString;
+    thread_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool.approval_required">;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    thread_id: z.ZodString;
+    tool_calls: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source_event_id: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool.response_required">;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    thread_id: z.ZodString;
+    tool_calls: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source_event_id: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "type">;
+/** One row on the session timeline: which turn emitted the event plus the event payload. */
+export declare const SessionEventItemSchema: z.ZodObject<{
+    turn_id: z.ZodString;
+    event: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"turn.created">;
+        id: z.ZodString;
+        turn_id: z.ZodString;
+        previous_turn_id: z.ZodNullable<z.ZodString>;
+        input: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"user.message">;
+            content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"file">;
+                name: z.ZodString;
+                data: z.ZodString;
+            }, z.core.$strip>], "type">>]>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"user.tool_approval">;
+            thread_id: z.ZodString;
+            tool_call_id: z.ZodString;
+            approval: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                status: z.ZodLiteral<"allow">;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"deny">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "status">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"user.tool_response">;
+            thread_id: z.ZodString;
+            tool_call_id: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>], "type">>>;
+        state: z.ZodObject<{
+            status: z.ZodLiteral<"running">;
+        }, z.core.$strip>;
+        created_at: z.ZodString;
+        thread_id: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"turn.done">;
+        id: z.ZodString;
+        state: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"done">;
+            output: z.ZodUnion<readonly [z.ZodObject<{
+                content: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    text: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"refusal">;
+                    refusal: z.ZodString;
+                }, z.core.$strip>]>>]>>>;
+                name: z.ZodOptional<z.ZodString>;
+                refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                reasoning_content: z.ZodOptional<z.ZodString>;
+                tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    type: z.ZodLiteral<"function">;
+                    function: z.ZodObject<{
+                        name: z.ZodString;
+                        arguments: z.ZodString;
+                    }, z.core.$strip>;
+                    provider_specific_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    tool_info: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"truefoundry-system">;
+                        name: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"mcp">;
+                        server_id: z.ZodString;
+                        server_name: z.ZodString;
+                        name: z.ZodString;
+                    }, z.core.$strip>], "type">;
+                }, z.core.$strip>>>;
+                type: z.ZodLiteral<"model.message">;
+                id: z.ZodString;
+                thread_id: z.ZodString;
+                finish_reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                    content_filter: "content_filter";
+                    function_call: "function_call";
+                    length: "length";
+                    stop: "stop";
+                    tool_calls: "tool_calls";
+                }>, z.ZodNull]>>;
+                created_at: z.ZodString;
+                usage: z.ZodOptional<z.ZodObject<{
+                    input_tokens: z.ZodNumber;
+                    output_tokens: z.ZodNumber;
+                    cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+                    cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+                    input_tokens_breakdown: z.ZodObject<{
+                        harness: z.ZodNumber;
+                        skills: z.ZodNumber;
+                        instructions: z.ZodNumber;
+                        tool_definitions: z.ZodNumber;
+                        messages: z.ZodNumber;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodNull]>;
+            required_actions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"tool.approval_required">;
+                id: z.ZodString;
+                created_at: z.ZodString;
+                thread_id: z.ZodString;
+                tool_calls: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    source_event_id: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"tool.response_required">;
+                id: z.ZodString;
+                created_at: z.ZodString;
+                thread_id: z.ZodString;
+                tool_calls: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    source_event_id: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                id: z.ZodString;
+                created_at: z.ZodString;
+                thread_id: z.ZodNullable<z.ZodString>;
+                type: z.ZodLiteral<"mcp.auth_required">;
+                mcp_servers: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    name: z.ZodString;
+                    auth_url: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>], "type">>;
+            completed_at: z.ZodString;
+            metrics: z.ZodOptional<z.ZodObject<{
+                total_input_tokens: z.ZodOptional<z.ZodNumber>;
+                total_output_tokens: z.ZodOptional<z.ZodNumber>;
+                total_tokens: z.ZodOptional<z.ZodNumber>;
+                total_cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+                total_cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+                total_reasoning_tokens: z.ZodOptional<z.ZodNumber>;
+                total_cost_in_usd: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"cancelled">;
+            reason: z.ZodEnum<typeof import("./turn").CancellationReason>;
+            completed_at: z.ZodString;
+            metrics: z.ZodOptional<z.ZodObject<{
+                total_input_tokens: z.ZodOptional<z.ZodNumber>;
+                total_output_tokens: z.ZodOptional<z.ZodNumber>;
+                total_tokens: z.ZodOptional<z.ZodNumber>;
+                total_cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+                total_cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+                total_reasoning_tokens: z.ZodOptional<z.ZodNumber>;
+                total_cost_in_usd: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"error">;
+            message: z.ZodString;
+            completed_at: z.ZodString;
+            metrics: z.ZodOptional<z.ZodObject<{
+                total_input_tokens: z.ZodOptional<z.ZodNumber>;
+                total_output_tokens: z.ZodOptional<z.ZodNumber>;
+                total_tokens: z.ZodOptional<z.ZodNumber>;
+                total_cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+                total_cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+                total_reasoning_tokens: z.ZodOptional<z.ZodNumber>;
+                total_cost_in_usd: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>], "status">;
+        created_at: z.ZodString;
+        thread_id: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        content: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"refusal">;
+            refusal: z.ZodString;
+        }, z.core.$strip>]>>]>>>;
+        name: z.ZodOptional<z.ZodString>;
+        refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reasoning_content: z.ZodOptional<z.ZodString>;
+        tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodLiteral<"function">;
+            function: z.ZodObject<{
+                name: z.ZodString;
+                arguments: z.ZodString;
+            }, z.core.$strip>;
+            provider_specific_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            tool_info: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"truefoundry-system">;
+                name: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"mcp">;
+                server_id: z.ZodString;
+                server_name: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>>>;
+        type: z.ZodLiteral<"model.message">;
+        id: z.ZodString;
+        thread_id: z.ZodString;
+        finish_reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            content_filter: "content_filter";
+            function_call: "function_call";
+            length: "length";
+            stop: "stop";
+            tool_calls: "tool_calls";
+        }>, z.ZodNull]>>;
+        created_at: z.ZodString;
+        usage: z.ZodOptional<z.ZodObject<{
+            input_tokens: z.ZodNumber;
+            output_tokens: z.ZodNumber;
+            cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+            cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+            input_tokens_breakdown: z.ZodObject<{
+                harness: z.ZodNumber;
+                skills: z.ZodNumber;
+                instructions: z.ZodNumber;
+                tool_definitions: z.ZodNumber;
+                messages: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        tool_call_id: z.ZodString;
+        content: z.ZodString;
+        type: z.ZodLiteral<"tool.response">;
+        id: z.ZodString;
+        thread_id: z.ZodString;
+        created_at: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"thread.created">;
+        id: z.ZodString;
+        agent_info: z.ZodObject<{
+            type: z.ZodLiteral<"dynamic">;
+            name: z.ZodString;
+            input: z.ZodString;
+            model: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        created_at: z.ZodString;
+        parent: z.ZodObject<{
+            thread_id: z.ZodString;
+            tool_call_id: z.ZodString;
+        }, z.core.$strip>;
+        thread_id: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        parent: z.ZodOptional<z.ZodObject<{
+            thread_id: z.ZodString;
+            tool_call_id: z.ZodString;
+        }, z.core.$strip>>;
+        thread_id: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodLiteral<"thread.done">;
+        id: z.ZodString;
+        created_at: z.ZodString;
+        state: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"done">;
+            output: z.ZodObject<{
+                content: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    text: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"refusal">;
+                    refusal: z.ZodString;
+                }, z.core.$strip>]>>]>>>;
+                name: z.ZodOptional<z.ZodString>;
+                refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                reasoning_content: z.ZodOptional<z.ZodString>;
+                tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    type: z.ZodLiteral<"function">;
+                    function: z.ZodObject<{
+                        name: z.ZodString;
+                        arguments: z.ZodString;
+                    }, z.core.$strip>;
+                    provider_specific_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    tool_info: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"truefoundry-system">;
+                        name: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"mcp">;
+                        server_id: z.ZodString;
+                        server_name: z.ZodString;
+                        name: z.ZodString;
+                    }, z.core.$strip>], "type">;
+                }, z.core.$strip>>>;
+                type: z.ZodLiteral<"model.message">;
+                id: z.ZodString;
+                thread_id: z.ZodString;
+                finish_reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                    content_filter: "content_filter";
+                    function_call: "function_call";
+                    length: "length";
+                    stop: "stop";
+                    tool_calls: "tool_calls";
+                }>, z.ZodNull]>>;
+                created_at: z.ZodString;
+                usage: z.ZodOptional<z.ZodObject<{
+                    input_tokens: z.ZodNumber;
+                    output_tokens: z.ZodNumber;
+                    cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+                    cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+                    input_tokens_breakdown: z.ZodObject<{
+                        harness: z.ZodNumber;
+                        skills: z.ZodNumber;
+                        instructions: z.ZodNumber;
+                        tool_definitions: z.ZodNumber;
+                        messages: z.ZodNumber;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"error">;
+            error: z.ZodString;
+            output: z.ZodOptional<z.ZodObject<{
+                content: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    text: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"refusal">;
+                    refusal: z.ZodString;
+                }, z.core.$strip>]>>]>>>;
+                name: z.ZodOptional<z.ZodString>;
+                refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                reasoning_content: z.ZodOptional<z.ZodString>;
+                tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    type: z.ZodLiteral<"function">;
+                    function: z.ZodObject<{
+                        name: z.ZodString;
+                        arguments: z.ZodString;
+                    }, z.core.$strip>;
+                    provider_specific_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    tool_info: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"truefoundry-system">;
+                        name: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"mcp">;
+                        server_id: z.ZodString;
+                        server_name: z.ZodString;
+                        name: z.ZodString;
+                    }, z.core.$strip>], "type">;
+                }, z.core.$strip>>>;
+                type: z.ZodLiteral<"model.message">;
+                id: z.ZodString;
+                thread_id: z.ZodString;
+                finish_reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                    content_filter: "content_filter";
+                    function_call: "function_call";
+                    length: "length";
+                    stop: "stop";
+                    tool_calls: "tool_calls";
+                }>, z.ZodNull]>>;
+                created_at: z.ZodString;
+                usage: z.ZodOptional<z.ZodObject<{
+                    input_tokens: z.ZodNumber;
+                    output_tokens: z.ZodNumber;
+                    cache_read_tokens: z.ZodOptional<z.ZodNumber>;
+                    cache_write_tokens: z.ZodOptional<z.ZodNumber>;
+                    input_tokens_breakdown: z.ZodObject<{
+                        harness: z.ZodNumber;
+                        skills: z.ZodNumber;
+                        instructions: z.ZodNumber;
+                        tool_definitions: z.ZodNumber;
+                        messages: z.ZodNumber;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>], "status">;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        thread_id: z.ZodNullable<z.ZodString>;
+        type: z.ZodLiteral<"mcp.auth_required">;
+        mcp_servers: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            auth_url: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"mcp.initialize">;
+        id: z.ZodString;
+        created_at: z.ZodString;
+        thread_id: z.ZodString;
+        mcp_servers: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            session_id: z.ZodOptional<z.ZodString>;
+            transport_type: z.ZodOptional<z.ZodEnum<{
+                sse: "sse";
+                "streamable-http": "streamable-http";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"sandbox.created">;
+        id: z.ZodString;
+        created_at: z.ZodString;
+        sandbox_id: z.ZodString;
+        thread_id: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool.approval_required">;
+        id: z.ZodString;
+        created_at: z.ZodString;
+        thread_id: z.ZodString;
+        tool_calls: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            source_event_id: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool.response_required">;
+        id: z.ZodString;
+        created_at: z.ZodString;
+        thread_id: z.ZodString;
+        tool_calls: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            source_event_id: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>;
+export type TurnCreatedEvent = z.infer<typeof TurnCreatedEventSchema>;
+export type TurnDoneEvent = z.infer<typeof TurnDoneEventSchema>;
+export type SessionEvent = z.infer<typeof SessionEventSchema>;
+/**
+ * Durable turn event log entries: {@link SessionEvent} plus any registered
+ * passthrough events. Every merged event must carry its monotonic ULID and
+ * creation timestamp; shared by append and list operations.
+ */
+export type PersistedTurnEvent = WithRegisteredPassthrough<SessionEvent> & {
+    id: string;
+    created_at: string;
+};
+export interface SessionEventItem {
+    turn_id: string;
+    event: PersistedTurnEvent;
+}
+//# sourceMappingURL=events.d.ts.map