@openai/agents-core 0.3.7 → 0.3.8

package/dist/runState.d.ts

@@ -3,19 +3,27 @@ import { Agent } from './agent';
 import { RunItem, RunToolApprovalItem } from './items';
 import type { ModelResponse } from './model';
 import { RunContext } from './runContext';
-import { AgentToolUseTracker, NextStep, ProcessedResponse } from './runImplementation';
-import type { AgentSpanData } from './tracing/spans';
-import type { Span } from './tracing/spans';
+import { AgentToolUseTracker } from './runner/toolUseTracker';
+import { NextStep } from './runner/steps';
+import type { ProcessedResponse } from './runner/types';
+import type { AgentSpanData, Span } from './tracing/spans';
 import { Usage } from './usage';
 import { Trace } from './tracing/traces';
 import { AgentInputItem } from './types';
 import type { InputGuardrailResult, OutputGuardrailResult } from './guardrail';
+import type { ToolInputGuardrailResult, ToolOutputGuardrailResult } from './toolGuardrail';
 /**
  * The schema version of the serialized run state. This is used to ensure that the serialized
  * run state is compatible with the current version of the SDK.
  * If anything in this schema changes, the version will have to be incremented.
+ *
+ * Version history.
+ * - 1.0: Initial serialized RunState schema.
+ * - 1.1: Adds optional currentTurnInProgress, conversationId, and previousResponseId fields,
+ *   plus broader tool_call_output_item rawItem variants for non-function tools. Older 1.0
+ *   payloads remain readable but resumes may lack mid-turn or server-managed context precision.
  */
-export declare const CURRENT_SCHEMA_VERSION: "1.0";
+export declare const CURRENT_SCHEMA_VERSION: "1.1";
 declare const serializedSpanBase: z.ZodObject<{
     object: z.ZodLiteral<"trace.span">;
     id: z.ZodString;
@@ -41,11 +49,11 @@ declare const serializedSpanBase: z.ZodObject<{
     parent_id: string | null;
     started_at: string | null;
     ended_at: string | null;
+    span_data: Record<string, any>;
     error: {
         message: string;
         data?: Record<string, any> | undefined;
     } | null;
-    span_data: Record<string, any>;
 }, {
     object: "trace.span";
     id: string;
@@ -53,17 +61,17 @@ declare const serializedSpanBase: z.ZodObject<{
     parent_id: string | null;
     started_at: string | null;
     ended_at: string | null;
+    span_data: Record<string, any>;
     error: {
         message: string;
         data?: Record<string, any> | undefined;
     } | null;
-    span_data: Record<string, any>;
 }>;
 type SerializedSpanType = z.infer<typeof serializedSpanBase> & {
     previous_span?: SerializedSpanType;
 };
 export declare const SerializedRunState: z.ZodObject<{
-    $schemaVersion: z.ZodLiteral<"1.0">;
+    $schemaVersion: z.ZodEnum<["1.0", "1.1"]>;
     currentTurn: z.ZodNumber;
     currentAgent: z.ZodObject<{
         name: z.ZodString;
@@ -3218,28 +3226,209 @@ export declare const SerializedRunState: z.ZodObject<{
             tripwireTriggered: boolean;
             outputInfo?: any;
         };
+        agent: {
+            name: string;
+        };
         guardrail: {
             type: "output";
             name: string;
         };
+        agentOutput?: any;
+    }, {
+        output: {
+            tripwireTriggered: boolean;
+            outputInfo?: any;
+        };
         agent: {
             name: string;
         };
+        guardrail: {
+            type: "output";
+            name: string;
+        };
         agentOutput?: any;
+    }>, "many">;
+    toolInputGuardrailResults: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        guardrail: z.ZodObject<{
+            name: z.ZodString;
+        } & {
+            type: z.ZodLiteral<"tool_input">;
+        }, "strip", z.ZodTypeAny, {
+            type: "tool_input";
+            name: string;
+        }, {
+            type: "tool_input";
+            name: string;
+        }>;
+        output: z.ZodObject<{
+            outputInfo: z.ZodOptional<z.ZodAny>;
+            behavior: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                type: z.ZodLiteral<"allow">;
+            }, "strip", z.ZodTypeAny, {
+                type: "allow";
+            }, {
+                type: "allow";
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"rejectContent">;
+                message: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                type: "rejectContent";
+            }, {
+                message: string;
+                type: "rejectContent";
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"throwException">;
+            }, "strip", z.ZodTypeAny, {
+                type: "throwException";
+            }, {
+                type: "throwException";
+            }>]>;
+        }, "strip", z.ZodTypeAny, {
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
+            outputInfo?: any;
+        }, {
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
+            outputInfo?: any;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        output: {
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
+            outputInfo?: any;
+        };
+        guardrail: {
+            type: "tool_input";
+            name: string;
+        };
     }, {
         output: {
-            tripwireTriggered: boolean;
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
             outputInfo?: any;
         };
         guardrail: {
-            type: "output";
+            type: "tool_input";
             name: string;
         };
-        agent: {
+    }>, "many">>>;
+    toolOutputGuardrailResults: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        guardrail: z.ZodObject<{
+            name: z.ZodString;
+        } & {
+            type: z.ZodLiteral<"tool_output">;
+        }, "strip", z.ZodTypeAny, {
+            type: "tool_output";
+            name: string;
+        }, {
+            type: "tool_output";
+            name: string;
+        }>;
+        output: z.ZodObject<{
+            outputInfo: z.ZodOptional<z.ZodAny>;
+            behavior: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                type: z.ZodLiteral<"allow">;
+            }, "strip", z.ZodTypeAny, {
+                type: "allow";
+            }, {
+                type: "allow";
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"rejectContent">;
+                message: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                type: "rejectContent";
+            }, {
+                message: string;
+                type: "rejectContent";
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"throwException">;
+            }, "strip", z.ZodTypeAny, {
+                type: "throwException";
+            }, {
+                type: "throwException";
+            }>]>;
+        }, "strip", z.ZodTypeAny, {
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
+            outputInfo?: any;
+        }, {
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
+            outputInfo?: any;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        output: {
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
+            outputInfo?: any;
+        };
+        guardrail: {
+            type: "tool_output";
             name: string;
         };
-        agentOutput?: any;
-    }>, "many">;
+    }, {
+        output: {
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
+            outputInfo?: any;
+        };
+        guardrail: {
+            type: "tool_output";
+            name: string;
+        };
+    }>, "many">>>;
+    currentTurnInProgress: z.ZodOptional<z.ZodBoolean>;
     currentStep: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: z.ZodLiteral<"next_step_handoff">;
         newAgent: z.ZodAny;
@@ -5718,7 +5907,7 @@ export declare const SerializedRunState: z.ZodObject<{
         };
     }>, z.ZodObject<{
         type: z.ZodLiteral<"tool_call_output_item">;
-        rawItem: z.ZodObject<{
+        rawItem: z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
             providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
         } & {
             id: z.ZodOptional<z.ZodString>;
@@ -6046,144 +6235,412 @@ export declare const SerializedRunState: z.ZodObject<{
             callId: string;
             providerData?: Record<string, any> | undefined;
             id?: string | undefined;
-        }>;
-        agent: z.ZodObject<{
-            name: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-        }, {
-            name: string;
-        }>;
-        output: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        type: "tool_call_output_item";
-        output: string;
-        agent: {
-            name: string;
-        };
-        rawItem: {
-            type: "function_call_result";
-            status: "in_progress" | "completed" | "incomplete";
-            name: string;
-            output: string | {
-                type: "text";
-                text: string;
-                providerData?: Record<string, any> | undefined;
-            } | {
-                type: "image";
-                providerData?: Record<string, any> | undefined;
-                image?: string | {
-                    data: string | Uint8Array<ArrayBuffer>;
-                    mediaType?: string | undefined;
-                } | {
-                    url: string;
-                } | {
-                    fileId: string;
-                } | undefined;
-                detail?: "low" | "high" | "auto" | (string & {}) | undefined;
-            } | {
-                type: "file";
-                file: string | {
-                    filename: string;
-                    data: string | Uint8Array<ArrayBuffer>;
-                    mediaType: string;
-                } | {
-                    url: string;
-                    filename?: string | undefined;
-                } | {
-                    id: string;
-                    filename?: string | undefined;
-                };
-                providerData?: Record<string, any> | undefined;
-            } | ({
-                type: "input_text";
-                text: string;
+        }>, z.ZodObject<{
+            providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        } & {
+            id: z.ZodOptional<z.ZodString>;
+        } & {
+            type: z.ZodLiteral<"computer_call_result">;
+            callId: z.ZodString;
+            output: z.ZodObject<{
+                providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            } & {
+                type: z.ZodLiteral<"computer_screenshot">;
+                data: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "computer_screenshot";
+                data: string;
                 providerData?: Record<string, any> | undefined;
-            } | {
-                type: "input_image";
+            }, {
+                type: "computer_screenshot";
+                data: string;
                 providerData?: Record<string, any> | undefined;
-                image?: string | {
-                    id: string;
-                } | undefined;
-                detail?: string | undefined;
-            } | {
-                type: "input_file";
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            type: "computer_call_result";
+            output: {
+                type: "computer_screenshot";
+                data: string;
                 providerData?: Record<string, any> | undefined;
-                file?: string | {
-                    id: string;
-                } | {
-                    url: string;
-                } | undefined;
-                filename?: string | undefined;
-            })[];
+            };
             callId: string;
             providerData?: Record<string, any> | undefined;
             id?: string | undefined;
-        };
-    }, {
-        type: "tool_call_output_item";
-        output: string;
-        agent: {
-            name: string;
-        };
-        rawItem: {
-            type: "function_call_result";
-            status: "in_progress" | "completed" | "incomplete";
-            name: string;
-            output: string | {
-                type: "text";
-                text: string;
-                providerData?: Record<string, any> | undefined;
-            } | {
-                type: "image";
-                providerData?: Record<string, any> | undefined;
-                image?: string | {
-                    data: string | Uint8Array<ArrayBuffer>;
-                    mediaType?: string | undefined;
-                } | {
-                    url: string;
-                } | {
-                    fileId: string;
-                } | undefined;
-                detail?: "low" | "high" | "auto" | (string & {}) | undefined;
-            } | {
-                type: "file";
-                file: string | {
-                    filename: string;
-                    data: string | Uint8Array<ArrayBuffer>;
-                    mediaType: string;
-                } | {
-                    url: string;
-                    filename?: string | undefined;
-                } | {
-                    id: string;
-                    filename?: string | undefined;
-                };
-                providerData?: Record<string, any> | undefined;
-            } | ({
-                type: "input_text";
-                text: string;
-                providerData?: Record<string, any> | undefined;
-            } | {
-                type: "input_image";
-                providerData?: Record<string, any> | undefined;
-                image?: string | {
-                    id: string;
-                } | undefined;
-                detail?: string | undefined;
-            } | {
-                type: "input_file";
+        }, {
+            type: "computer_call_result";
+            output: {
+                type: "computer_screenshot";
+                data: string;
                 providerData?: Record<string, any> | undefined;
-                file?: string | {
-                    id: string;
-                } | {
-                    url: string;
-                } | undefined;
-                filename?: string | undefined;
+            };
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+        }>]>, z.ZodObject<{
+            providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        } & {
+            id: z.ZodOptional<z.ZodString>;
+        } & {
+            type: z.ZodLiteral<"shell_call_output">;
+            callId: z.ZodString;
+            maxOutputLength: z.ZodOptional<z.ZodNumber>;
+            output: z.ZodArray<z.ZodObject<{
+                stdout: z.ZodString;
+                stderr: z.ZodString;
+                outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                    type: z.ZodLiteral<"timeout">;
+                }, "strip", z.ZodTypeAny, {
+                    type: "timeout";
+                }, {
+                    type: "timeout";
+                }>, z.ZodObject<{
+                    type: z.ZodLiteral<"exit">;
+                    exitCode: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "exit";
+                    exitCode: number | null;
+                }, {
+                    type: "exit";
+                    exitCode: number | null;
+                }>]>;
+            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                stdout: z.ZodString;
+                stderr: z.ZodString;
+                outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                    type: z.ZodLiteral<"timeout">;
+                }, "strip", z.ZodTypeAny, {
+                    type: "timeout";
+                }, {
+                    type: "timeout";
+                }>, z.ZodObject<{
+                    type: z.ZodLiteral<"exit">;
+                    exitCode: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "exit";
+                    exitCode: number | null;
+                }, {
+                    type: "exit";
+                    exitCode: number | null;
+                }>]>;
+            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                stdout: z.ZodString;
+                stderr: z.ZodString;
+                outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                    type: z.ZodLiteral<"timeout">;
+                }, "strip", z.ZodTypeAny, {
+                    type: "timeout";
+                }, {
+                    type: "timeout";
+                }>, z.ZodObject<{
+                    type: z.ZodLiteral<"exit">;
+                    exitCode: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "exit";
+                    exitCode: number | null;
+                }, {
+                    type: "exit";
+                    exitCode: number | null;
+                }>]>;
+            }, z.ZodTypeAny, "passthrough">>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "shell_call_output";
+            output: z.objectOutputType<{
+                stdout: z.ZodString;
+                stderr: z.ZodString;
+                outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                    type: z.ZodLiteral<"timeout">;
+                }, "strip", z.ZodTypeAny, {
+                    type: "timeout";
+                }, {
+                    type: "timeout";
+                }>, z.ZodObject<{
+                    type: z.ZodLiteral<"exit">;
+                    exitCode: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "exit";
+                    exitCode: number | null;
+                }, {
+                    type: "exit";
+                    exitCode: number | null;
+                }>]>;
+            }, z.ZodTypeAny, "passthrough">[];
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            maxOutputLength?: number | undefined;
+        }, {
+            type: "shell_call_output";
+            output: z.objectInputType<{
+                stdout: z.ZodString;
+                stderr: z.ZodString;
+                outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                    type: z.ZodLiteral<"timeout">;
+                }, "strip", z.ZodTypeAny, {
+                    type: "timeout";
+                }, {
+                    type: "timeout";
+                }>, z.ZodObject<{
+                    type: z.ZodLiteral<"exit">;
+                    exitCode: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "exit";
+                    exitCode: number | null;
+                }, {
+                    type: "exit";
+                    exitCode: number | null;
+                }>]>;
+            }, z.ZodTypeAny, "passthrough">[];
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            maxOutputLength?: number | undefined;
+        }>]>, z.ZodObject<{
+            providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        } & {
+            id: z.ZodOptional<z.ZodString>;
+        } & {
+            type: z.ZodLiteral<"apply_patch_call_output">;
+            callId: z.ZodString;
+            status: z.ZodEnum<["completed", "failed"]>;
+            output: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "apply_patch_call_output";
+            status: "completed" | "failed";
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            output?: string | undefined;
+        }, {
+            type: "apply_patch_call_output";
+            status: "completed" | "failed";
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            output?: string | undefined;
+        }>]>;
+        agent: z.ZodObject<{
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+        }, {
+            name: string;
+        }>;
+        output: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "tool_call_output_item";
+        output: string;
+        agent: {
+            name: string;
+        };
+        rawItem: {
+            type: "function_call_result";
+            status: "in_progress" | "completed" | "incomplete";
+            name: string;
+            output: string | {
+                type: "text";
+                text: string;
+                providerData?: Record<string, any> | undefined;
+            } | {
+                type: "image";
+                providerData?: Record<string, any> | undefined;
+                image?: string | {
+                    data: string | Uint8Array<ArrayBuffer>;
+                    mediaType?: string | undefined;
+                } | {
+                    url: string;
+                } | {
+                    fileId: string;
+                } | undefined;
+                detail?: "low" | "high" | "auto" | (string & {}) | undefined;
+            } | {
+                type: "file";
+                file: string | {
+                    filename: string;
+                    data: string | Uint8Array<ArrayBuffer>;
+                    mediaType: string;
+                } | {
+                    url: string;
+                    filename?: string | undefined;
+                } | {
+                    id: string;
+                    filename?: string | undefined;
+                };
+                providerData?: Record<string, any> | undefined;
+            } | ({
+                type: "input_text";
+                text: string;
+                providerData?: Record<string, any> | undefined;
+            } | {
+                type: "input_image";
+                providerData?: Record<string, any> | undefined;
+                image?: string | {
+                    id: string;
+                } | undefined;
+                detail?: string | undefined;
+            } | {
+                type: "input_file";
+                providerData?: Record<string, any> | undefined;
+                file?: string | {
+                    id: string;
+                } | {
+                    url: string;
+                } | undefined;
+                filename?: string | undefined;
+            })[];
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+        } | {
+            type: "computer_call_result";
+            output: {
+                type: "computer_screenshot";
+                data: string;
+                providerData?: Record<string, any> | undefined;
+            };
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+        } | {
+            type: "shell_call_output";
+            output: z.objectOutputType<{
+                stdout: z.ZodString;
+                stderr: z.ZodString;
+                outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                    type: z.ZodLiteral<"timeout">;
+                }, "strip", z.ZodTypeAny, {
+                    type: "timeout";
+                }, {
+                    type: "timeout";
+                }>, z.ZodObject<{
+                    type: z.ZodLiteral<"exit">;
+                    exitCode: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "exit";
+                    exitCode: number | null;
+                }, {
+                    type: "exit";
+                    exitCode: number | null;
+                }>]>;
+            }, z.ZodTypeAny, "passthrough">[];
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            maxOutputLength?: number | undefined;
+        } | {
+            type: "apply_patch_call_output";
+            status: "completed" | "failed";
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            output?: string | undefined;
+        };
+    }, {
+        type: "tool_call_output_item";
+        output: string;
+        agent: {
+            name: string;
+        };
+        rawItem: {
+            type: "function_call_result";
+            status: "in_progress" | "completed" | "incomplete";
+            name: string;
+            output: string | {
+                type: "text";
+                text: string;
+                providerData?: Record<string, any> | undefined;
+            } | {
+                type: "image";
+                providerData?: Record<string, any> | undefined;
+                image?: string | {
+                    data: string | Uint8Array<ArrayBuffer>;
+                    mediaType?: string | undefined;
+                } | {
+                    url: string;
+                } | {
+                    fileId: string;
+                } | undefined;
+                detail?: "low" | "high" | "auto" | (string & {}) | undefined;
+            } | {
+                type: "file";
+                file: string | {
+                    filename: string;
+                    data: string | Uint8Array<ArrayBuffer>;
+                    mediaType: string;
+                } | {
+                    url: string;
+                    filename?: string | undefined;
+                } | {
+                    id: string;
+                    filename?: string | undefined;
+                };
+                providerData?: Record<string, any> | undefined;
+            } | ({
+                type: "input_text";
+                text: string;
+                providerData?: Record<string, any> | undefined;
+            } | {
+                type: "input_image";
+                providerData?: Record<string, any> | undefined;
+                image?: string | {
+                    id: string;
+                } | undefined;
+                detail?: string | undefined;
+            } | {
+                type: "input_file";
+                providerData?: Record<string, any> | undefined;
+                file?: string | {
+                    id: string;
+                } | {
+                    url: string;
+                } | undefined;
+                filename?: string | undefined;
             })[];
             callId: string;
             providerData?: Record<string, any> | undefined;
             id?: string | undefined;
+        } | {
+            type: "computer_call_result";
+            output: {
+                type: "computer_screenshot";
+                data: string;
+                providerData?: Record<string, any> | undefined;
+            };
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+        } | {
+            type: "shell_call_output";
+            output: z.objectInputType<{
+                stdout: z.ZodString;
+                stderr: z.ZodString;
+                outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                    type: z.ZodLiteral<"timeout">;
+                }, "strip", z.ZodTypeAny, {
+                    type: "timeout";
+                }, {
+                    type: "timeout";
+                }>, z.ZodObject<{
+                    type: z.ZodLiteral<"exit">;
+                    exitCode: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "exit";
+                    exitCode: number | null;
+                }, {
+                    type: "exit";
+                    exitCode: number | null;
+                }>]>;
+            }, z.ZodTypeAny, "passthrough">[];
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            maxOutputLength?: number | undefined;
+        } | {
+            type: "apply_patch_call_output";
+            status: "completed" | "failed";
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            output?: string | undefined;
         };
     }>, z.ZodObject<{
         type: z.ZodLiteral<"reasoning_item">;
@@ -7938,7 +8395,7 @@ export declare const SerializedRunState: z.ZodObject<{
             };
         }>, z.ZodObject<{
             type: z.ZodLiteral<"tool_call_output_item">;
-            rawItem: z.ZodObject<{
+            rawItem: z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
                 providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
             } & {
                 id: z.ZodOptional<z.ZodString>;
@@ -8266,7 +8723,189 @@ export declare const SerializedRunState: z.ZodObject<{
                 callId: string;
                 providerData?: Record<string, any> | undefined;
                 id?: string | undefined;
-            }>;
+            }>, z.ZodObject<{
+                providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            } & {
+                id: z.ZodOptional<z.ZodString>;
+            } & {
+                type: z.ZodLiteral<"computer_call_result">;
+                callId: z.ZodString;
+                output: z.ZodObject<{
+                    providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                } & {
+                    type: z.ZodLiteral<"computer_screenshot">;
+                    data: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    type: "computer_screenshot";
+                    data: string;
+                    providerData?: Record<string, any> | undefined;
+                }, {
+                    type: "computer_screenshot";
+                    data: string;
+                    providerData?: Record<string, any> | undefined;
+                }>;
+            }, "strip", z.ZodTypeAny, {
+                type: "computer_call_result";
+                output: {
+                    type: "computer_screenshot";
+                    data: string;
+                    providerData?: Record<string, any> | undefined;
+                };
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+            }, {
+                type: "computer_call_result";
+                output: {
+                    type: "computer_screenshot";
+                    data: string;
+                    providerData?: Record<string, any> | undefined;
+                };
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+            }>]>, z.ZodObject<{
+                providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            } & {
+                id: z.ZodOptional<z.ZodString>;
+            } & {
+                type: z.ZodLiteral<"shell_call_output">;
+                callId: z.ZodString;
+                maxOutputLength: z.ZodOptional<z.ZodNumber>;
+                output: z.ZodArray<z.ZodObject<{
+                    stdout: z.ZodString;
+                    stderr: z.ZodString;
+                    outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                        type: z.ZodLiteral<"timeout">;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "timeout";
+                    }, {
+                        type: "timeout";
+                    }>, z.ZodObject<{
+                        type: z.ZodLiteral<"exit">;
+                        exitCode: z.ZodNullable<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }>]>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    stdout: z.ZodString;
+                    stderr: z.ZodString;
+                    outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                        type: z.ZodLiteral<"timeout">;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "timeout";
+                    }, {
+                        type: "timeout";
+                    }>, z.ZodObject<{
+                        type: z.ZodLiteral<"exit">;
+                        exitCode: z.ZodNullable<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }>]>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    stdout: z.ZodString;
+                    stderr: z.ZodString;
+                    outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                        type: z.ZodLiteral<"timeout">;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "timeout";
+                    }, {
+                        type: "timeout";
+                    }>, z.ZodObject<{
+                        type: z.ZodLiteral<"exit">;
+                        exitCode: z.ZodNullable<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }>]>;
+                }, z.ZodTypeAny, "passthrough">>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                type: "shell_call_output";
+                output: z.objectOutputType<{
+                    stdout: z.ZodString;
+                    stderr: z.ZodString;
+                    outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                        type: z.ZodLiteral<"timeout">;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "timeout";
+                    }, {
+                        type: "timeout";
+                    }>, z.ZodObject<{
+                        type: z.ZodLiteral<"exit">;
+                        exitCode: z.ZodNullable<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }>]>;
+                }, z.ZodTypeAny, "passthrough">[];
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                maxOutputLength?: number | undefined;
+            }, {
+                type: "shell_call_output";
+                output: z.objectInputType<{
+                    stdout: z.ZodString;
+                    stderr: z.ZodString;
+                    outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                        type: z.ZodLiteral<"timeout">;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "timeout";
+                    }, {
+                        type: "timeout";
+                    }>, z.ZodObject<{
+                        type: z.ZodLiteral<"exit">;
+                        exitCode: z.ZodNullable<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }>]>;
+                }, z.ZodTypeAny, "passthrough">[];
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                maxOutputLength?: number | undefined;
+            }>]>, z.ZodObject<{
+                providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            } & {
+                id: z.ZodOptional<z.ZodString>;
+            } & {
+                type: z.ZodLiteral<"apply_patch_call_output">;
+                callId: z.ZodString;
+                status: z.ZodEnum<["completed", "failed"]>;
+                output: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "apply_patch_call_output";
+                status: "completed" | "failed";
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                output?: string | undefined;
+            }, {
+                type: "apply_patch_call_output";
+                status: "completed" | "failed";
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                output?: string | undefined;
+            }>]>;
             agent: z.ZodObject<{
                 name: z.ZodString;
             }, "strip", z.ZodTypeAny, {
@@ -8339,6 +8978,49 @@ export declare const SerializedRunState: z.ZodObject<{
                 callId: string;
                 providerData?: Record<string, any> | undefined;
                 id?: string | undefined;
+            } | {
+                type: "computer_call_result";
+                output: {
+                    type: "computer_screenshot";
+                    data: string;
+                    providerData?: Record<string, any> | undefined;
+                };
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+            } | {
+                type: "shell_call_output";
+                output: z.objectOutputType<{
+                    stdout: z.ZodString;
+                    stderr: z.ZodString;
+                    outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                        type: z.ZodLiteral<"timeout">;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "timeout";
+                    }, {
+                        type: "timeout";
+                    }>, z.ZodObject<{
+                        type: z.ZodLiteral<"exit">;
+                        exitCode: z.ZodNullable<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }>]>;
+                }, z.ZodTypeAny, "passthrough">[];
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                maxOutputLength?: number | undefined;
+            } | {
+                type: "apply_patch_call_output";
+                status: "completed" | "failed";
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                output?: string | undefined;
             };
         }, {
             type: "tool_call_output_item";
@@ -8404,6 +9086,49 @@ export declare const SerializedRunState: z.ZodObject<{
                 callId: string;
                 providerData?: Record<string, any> | undefined;
                 id?: string | undefined;
+            } | {
+                type: "computer_call_result";
+                output: {
+                    type: "computer_screenshot";
+                    data: string;
+                    providerData?: Record<string, any> | undefined;
+                };
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+            } | {
+                type: "shell_call_output";
+                output: z.objectInputType<{
+                    stdout: z.ZodString;
+                    stderr: z.ZodString;
+                    outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                        type: z.ZodLiteral<"timeout">;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "timeout";
+                    }, {
+                        type: "timeout";
+                    }>, z.ZodObject<{
+                        type: z.ZodLiteral<"exit">;
+                        exitCode: z.ZodNullable<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }>]>;
+                }, z.ZodTypeAny, "passthrough">[];
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                maxOutputLength?: number | undefined;
+            } | {
+                type: "apply_patch_call_output";
+                status: "completed" | "failed";
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                output?: string | undefined;
             };
         }>, z.ZodObject<{
             type: z.ZodLiteral<"reasoning_item">;
@@ -9353,11 +10078,11 @@ export declare const SerializedRunState: z.ZodObject<{
             toolCall: z.ZodAny;
             handoff: z.ZodAny;
         }, "strip", z.ZodTypeAny, {
-            toolCall?: any;
             handoff?: any;
-        }, {
             toolCall?: any;
+        }, {
             handoff?: any;
+            toolCall?: any;
         }>, "many">;
         functions: z.ZodArray<z.ZodObject<{
             toolCall: z.ZodAny;
@@ -9490,8 +10215,8 @@ export declare const SerializedRunState: z.ZodObject<{
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         handoffs: {
-            toolCall?: any;
             handoff?: any;
+            toolCall?: any;
         }[];
         newItems: ({
             type: "message_output_item";
@@ -9683,6 +10408,49 @@ export declare const SerializedRunState: z.ZodObject<{
                 callId: string;
                 providerData?: Record<string, any> | undefined;
                 id?: string | undefined;
+            } | {
+                type: "computer_call_result";
+                output: {
+                    type: "computer_screenshot";
+                    data: string;
+                    providerData?: Record<string, any> | undefined;
+                };
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+            } | {
+                type: "shell_call_output";
+                output: z.objectOutputType<{
+                    stdout: z.ZodString;
+                    stderr: z.ZodString;
+                    outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                        type: z.ZodLiteral<"timeout">;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "timeout";
+                    }, {
+                        type: "timeout";
+                    }>, z.ZodObject<{
+                        type: z.ZodLiteral<"exit">;
+                        exitCode: z.ZodNullable<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }>]>;
+                }, z.ZodTypeAny, "passthrough">[];
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                maxOutputLength?: number | undefined;
+            } | {
+                type: "apply_patch_call_output";
+                status: "completed" | "failed";
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                output?: string | undefined;
             };
         } | {
             type: "reasoning_item";
@@ -9874,8 +10642,8 @@ export declare const SerializedRunState: z.ZodObject<{
         }[] | undefined;
     }, {
         handoffs: {
-            toolCall?: any;
             handoff?: any;
+            toolCall?: any;
         }[];
         newItems: ({
             type: "message_output_item";
@@ -10067,6 +10835,49 @@ export declare const SerializedRunState: z.ZodObject<{
                 callId: string;
                 providerData?: Record<string, any> | undefined;
                 id?: string | undefined;
+            } | {
+                type: "computer_call_result";
+                output: {
+                    type: "computer_screenshot";
+                    data: string;
+                    providerData?: Record<string, any> | undefined;
+                };
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+            } | {
+                type: "shell_call_output";
+                output: z.objectInputType<{
+                    stdout: z.ZodString;
+                    stderr: z.ZodString;
+                    outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                        type: z.ZodLiteral<"timeout">;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "timeout";
+                    }, {
+                        type: "timeout";
+                    }>, z.ZodObject<{
+                        type: z.ZodLiteral<"exit">;
+                        exitCode: z.ZodNullable<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }>]>;
+                }, z.ZodTypeAny, "passthrough">[];
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                maxOutputLength?: number | undefined;
+            } | {
+                type: "apply_patch_call_output";
+                status: "completed" | "failed";
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                output?: string | undefined;
             };
         } | {
             type: "reasoning_item";
@@ -10258,27 +11069,40 @@ export declare const SerializedRunState: z.ZodObject<{
         }[] | undefined;
     }>>;
     currentTurnPersistedItemCount: z.ZodOptional<z.ZodNumber>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    previousResponseId: z.ZodOptional<z.ZodString>;
     trace: z.ZodNullable<z.ZodObject<{
         object: z.ZodLiteral<"trace">;
         id: z.ZodString;
         workflow_name: z.ZodString;
         group_id: z.ZodNullable<z.ZodString>;
         metadata: z.ZodRecord<z.ZodString, z.ZodAny>;
+        tracing_api_key: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
         object: "trace";
         id: string;
         workflow_name: string;
         group_id: string | null;
         metadata: Record<string, any>;
+        tracing_api_key?: string | null | undefined;
     }, {
         object: "trace";
         id: string;
         workflow_name: string;
         group_id: string | null;
         metadata: Record<string, any>;
+        tracing_api_key?: string | null | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    $schemaVersion: "1.0";
+    trace: {
+        object: "trace";
+        id: string;
+        workflow_name: string;
+        group_id: string | null;
+        metadata: Record<string, any>;
+        tracing_api_key?: string | null | undefined;
+    } | null;
+    $schemaVersion: "1.0" | "1.1";
     currentTurn: number;
     currentAgent: {
         name: string;
@@ -10854,14 +11678,48 @@ export declare const SerializedRunState: z.ZodObject<{
             tripwireTriggered: boolean;
             outputInfo?: any;
         };
+        agent: {
+            name: string;
+        };
         guardrail: {
             type: "output";
             name: string;
         };
-        agent: {
+        agentOutput?: any;
+    }[];
+    toolInputGuardrailResults: {
+        output: {
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
+            outputInfo?: any;
+        };
+        guardrail: {
+            type: "tool_input";
+            name: string;
+        };
+    }[];
+    toolOutputGuardrailResults: {
+        output: {
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
+            outputInfo?: any;
+        };
+        guardrail: {
+            type: "tool_output";
             name: string;
         };
-        agentOutput?: any;
     }[];
     generatedItems: ({
         type: "message_output_item";
@@ -11053,6 +11911,49 @@ export declare const SerializedRunState: z.ZodObject<{
             callId: string;
             providerData?: Record<string, any> | undefined;
             id?: string | undefined;
+        } | {
+            type: "computer_call_result";
+            output: {
+                type: "computer_screenshot";
+                data: string;
+                providerData?: Record<string, any> | undefined;
+            };
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+        } | {
+            type: "shell_call_output";
+            output: z.objectOutputType<{
+                stdout: z.ZodString;
+                stderr: z.ZodString;
+                outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                    type: z.ZodLiteral<"timeout">;
+                }, "strip", z.ZodTypeAny, {
+                    type: "timeout";
+                }, {
+                    type: "timeout";
+                }>, z.ZodObject<{
+                    type: z.ZodLiteral<"exit">;
+                    exitCode: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "exit";
+                    exitCode: number | null;
+                }, {
+                    type: "exit";
+                    exitCode: number | null;
+                }>]>;
+            }, z.ZodTypeAny, "passthrough">[];
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            maxOutputLength?: number | undefined;
+        } | {
+            type: "apply_patch_call_output";
+            status: "completed" | "failed";
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            output?: string | undefined;
         };
     } | {
         type: "reasoning_item";
@@ -11208,14 +12109,8 @@ export declare const SerializedRunState: z.ZodObject<{
         };
         toolName?: string | undefined;
     })[];
-    trace: {
-        object: "trace";
-        id: string;
-        workflow_name: string;
-        group_id: string | null;
-        metadata: Record<string, any>;
-    } | null;
     currentAgentSpan?: SerializedSpanType | null | undefined;
+    currentTurnInProgress?: boolean | undefined;
     currentStep?: {
         type: "next_step_handoff";
         newAgent?: any;
@@ -11480,8 +12375,8 @@ export declare const SerializedRunState: z.ZodObject<{
     } | undefined;
     lastProcessedResponse?: {
         handoffs: {
-            toolCall?: any;
             handoff?: any;
+            toolCall?: any;
         }[];
         newItems: ({
             type: "message_output_item";
@@ -11673,6 +12568,49 @@ export declare const SerializedRunState: z.ZodObject<{
                 callId: string;
                 providerData?: Record<string, any> | undefined;
                 id?: string | undefined;
+            } | {
+                type: "computer_call_result";
+                output: {
+                    type: "computer_screenshot";
+                    data: string;
+                    providerData?: Record<string, any> | undefined;
+                };
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+            } | {
+                type: "shell_call_output";
+                output: z.objectOutputType<{
+                    stdout: z.ZodString;
+                    stderr: z.ZodString;
+                    outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                        type: z.ZodLiteral<"timeout">;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "timeout";
+                    }, {
+                        type: "timeout";
+                    }>, z.ZodObject<{
+                        type: z.ZodLiteral<"exit">;
+                        exitCode: z.ZodNullable<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }>]>;
+                }, z.ZodTypeAny, "passthrough">[];
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                maxOutputLength?: number | undefined;
+            } | {
+                type: "apply_patch_call_output";
+                status: "completed" | "failed";
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                output?: string | undefined;
             };
         } | {
             type: "reasoning_item";
@@ -11864,8 +12802,18 @@ export declare const SerializedRunState: z.ZodObject<{
         }[] | undefined;
     } | undefined;
     currentTurnPersistedItemCount?: number | undefined;
+    conversationId?: string | undefined;
+    previousResponseId?: string | undefined;
 }, {
-    $schemaVersion: "1.0";
+    trace: {
+        object: "trace";
+        id: string;
+        workflow_name: string;
+        group_id: string | null;
+        metadata: Record<string, any>;
+        tracing_api_key?: string | null | undefined;
+    } | null;
+    $schemaVersion: "1.0" | "1.1";
     currentTurn: number;
     currentAgent: {
         name: string;
@@ -12441,11 +13389,11 @@ export declare const SerializedRunState: z.ZodObject<{
             tripwireTriggered: boolean;
             outputInfo?: any;
         };
-        guardrail: {
-            type: "output";
+        agent: {
             name: string;
         };
-        agent: {
+        guardrail: {
+            type: "output";
             name: string;
         };
         agentOutput?: any;
@@ -12640,6 +13588,49 @@ export declare const SerializedRunState: z.ZodObject<{
             callId: string;
             providerData?: Record<string, any> | undefined;
             id?: string | undefined;
+        } | {
+            type: "computer_call_result";
+            output: {
+                type: "computer_screenshot";
+                data: string;
+                providerData?: Record<string, any> | undefined;
+            };
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+        } | {
+            type: "shell_call_output";
+            output: z.objectInputType<{
+                stdout: z.ZodString;
+                stderr: z.ZodString;
+                outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                    type: z.ZodLiteral<"timeout">;
+                }, "strip", z.ZodTypeAny, {
+                    type: "timeout";
+                }, {
+                    type: "timeout";
+                }>, z.ZodObject<{
+                    type: z.ZodLiteral<"exit">;
+                    exitCode: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "exit";
+                    exitCode: number | null;
+                }, {
+                    type: "exit";
+                    exitCode: number | null;
+                }>]>;
+            }, z.ZodTypeAny, "passthrough">[];
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            maxOutputLength?: number | undefined;
+        } | {
+            type: "apply_patch_call_output";
+            status: "completed" | "failed";
+            callId: string;
+            providerData?: Record<string, any> | undefined;
+            id?: string | undefined;
+            output?: string | undefined;
         };
     } | {
         type: "reasoning_item";
@@ -12795,14 +13786,42 @@ export declare const SerializedRunState: z.ZodObject<{
         };
         toolName?: string | undefined;
     })[];
-    trace: {
-        object: "trace";
-        id: string;
-        workflow_name: string;
-        group_id: string | null;
-        metadata: Record<string, any>;
-    } | null;
     currentAgentSpan?: SerializedSpanType | null | undefined;
+    toolInputGuardrailResults?: {
+        output: {
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
+            outputInfo?: any;
+        };
+        guardrail: {
+            type: "tool_input";
+            name: string;
+        };
+    }[] | undefined;
+    toolOutputGuardrailResults?: {
+        output: {
+            behavior: {
+                type: "allow";
+            } | {
+                message: string;
+                type: "rejectContent";
+            } | {
+                type: "throwException";
+            };
+            outputInfo?: any;
+        };
+        guardrail: {
+            type: "tool_output";
+            name: string;
+        };
+    }[] | undefined;
+    currentTurnInProgress?: boolean | undefined;
     currentStep?: {
         type: "next_step_handoff";
         newAgent?: any;
@@ -13067,8 +14086,8 @@ export declare const SerializedRunState: z.ZodObject<{
     } | undefined;
     lastProcessedResponse?: {
         handoffs: {
-            toolCall?: any;
             handoff?: any;
+            toolCall?: any;
         }[];
         newItems: ({
             type: "message_output_item";
@@ -13260,6 +14279,49 @@ export declare const SerializedRunState: z.ZodObject<{
                 callId: string;
                 providerData?: Record<string, any> | undefined;
                 id?: string | undefined;
+            } | {
+                type: "computer_call_result";
+                output: {
+                    type: "computer_screenshot";
+                    data: string;
+                    providerData?: Record<string, any> | undefined;
+                };
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+            } | {
+                type: "shell_call_output";
+                output: z.objectInputType<{
+                    stdout: z.ZodString;
+                    stderr: z.ZodString;
+                    outcome: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                        type: z.ZodLiteral<"timeout">;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "timeout";
+                    }, {
+                        type: "timeout";
+                    }>, z.ZodObject<{
+                        type: z.ZodLiteral<"exit">;
+                        exitCode: z.ZodNullable<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }, {
+                        type: "exit";
+                        exitCode: number | null;
+                    }>]>;
+                }, z.ZodTypeAny, "passthrough">[];
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                maxOutputLength?: number | undefined;
+            } | {
+                type: "apply_patch_call_output";
+                status: "completed" | "failed";
+                callId: string;
+                providerData?: Record<string, any> | undefined;
+                id?: string | undefined;
+                output?: string | undefined;
             };
         } | {
             type: "reasoning_item";
@@ -13451,6 +14513,8 @@ export declare const SerializedRunState: z.ZodObject<{
         }[] | undefined;
     } | undefined;
     currentTurnPersistedItemCount?: number | undefined;
+    conversationId?: string | undefined;
+    previousResponseId?: string | undefined;
 }>;
 /**
  * Serializable snapshot of an agent's run, including context, usage and trace.
@@ -13465,6 +14529,10 @@ export declare class RunState<TContext, TAgent extends Agent<any, any>> {
      * Current turn number in the conversation.
      */
     _currentTurn: number;
+    /**
+     * Whether the current turn has already been counted (useful when resuming mid-turn).
+     */
+    _currentTurnInProgress: boolean;
     /**
      * The agent currently handling the conversation.
      */
@@ -13477,6 +14545,14 @@ export declare class RunState<TContext, TAgent extends Agent<any, any>> {
      * Responses from the model so far.
      */
     _modelResponses: ModelResponse[];
+    /**
+     * Conversation identifier when the server manages conversation history.
+     */
+    _conversationId: string | undefined;
+    /**
+     * Latest response identifier returned by the server for server-managed conversations.
+     */
+    _previousResponseId: string | undefined;
     /**
      * Active tracing span for the current agent if tracing is enabled.
      */
@@ -13527,7 +14603,15 @@ export declare class RunState<TContext, TAgent extends Agent<any, any>> {
     /**
      * Results from output guardrails applied to the run.
      */
-    _outputGuardrailResults: OutputGuardrailResult[];
+    _outputGuardrailResults: OutputGuardrailResult<any, any>[];
+    /**
+     * Results from tool input guardrails applied during tool execution.
+     */
+    _toolInputGuardrailResults: ToolInputGuardrailResult[];
+    /**
+     * Results from tool output guardrails applied during tool execution.
+     */
+    _toolOutputGuardrailResults: ToolOutputGuardrailResult[];
     /**
      * Next step computed for the agent to take.
      */
@@ -13541,6 +14625,26 @@ export declare class RunState<TContext, TAgent extends Agent<any, any>> {
      */
     _trace: Trace | null;
     constructor(context: RunContext<TContext>, originalInput: string | AgentInputItem[], startingAgent: TAgent, maxTurns: number);
+    /**
+     * Updates server-managed conversation identifiers as a single operation.
+     */
+    setConversationContext(conversationId?: string, previousResponseId?: string): void;
+    /**
+     * Updates the agent span associated with the current run.
+     */
+    setCurrentAgentSpan(span?: Span<AgentSpanData>): void;
+    /**
+     * Switches the active agent handling the run.
+     */
+    setCurrentAgent(agent: TAgent): void;
+    /**
+     * Resets the counter that tracks how many items were persisted for the current turn.
+     */
+    resetTurnPersistence(): void;
+    /**
+     * Rewinds the persisted item counter when pending approvals require re-writing outputs.
+     */
+    rewindTurnPersistence(count: number): void;
     /**
      * The history of the agent run. This includes the input items and the new items generated during the run.
      *
@@ -13589,7 +14693,15 @@ export declare class RunState<TContext, TAgent extends Agent<any, any>> {
      *
      * @returns The serialized run state.
      */
-    toJSON(): z.infer<typeof SerializedRunState>;
+    /**
+     * Serializes the run state. By default, tracing API keys are omitted to prevent
+     * accidental persistence of secrets. Pass `includeTracingApiKey: true` only when you
+     * intentionally need to migrate a run along with its tracing credentials (e.g., to
+     * rehydrate in a separate process that lacks the original environment variables).
+     */
+    toJSON(options?: {
+        includeTracingApiKey?: boolean;
+    }): z.infer<typeof SerializedRunState>;
     /**
      * Serializes the run state to a string.
      *
@@ -13598,7 +14710,9 @@ export declare class RunState<TContext, TAgent extends Agent<any, any>> {
      *
      * @returns The serialized run state.
      */
-    toString(): string;
+    toString(options?: {
+        includeTracingApiKey?: boolean;
+    }): string;
     /**
      * Deserializes a run state from a string.
      *