@openai/agents-core 0.8.5 → 0.9.1

package/dist/runState.d.ts

@@ -34,8 +34,12 @@ import type { AgentToolInvocation } from './agentToolInvocation';
  * - 1.7: Adds optional approval rejection messages.
  * - 1.8: Adds tool search item variants, batched computer actions, and GA computer tool
  *   aliasing to serialized run state payloads.
+ * - 1.9: Adds optional sandbox session persistence with a versioned session-state
+ *   envelope for sandbox-agent resume.
+ * - 1.10: Adds optional stable agent identity keys so duplicate-name agent graphs can
+ *   serialize and resume without ambiguous name resolution.
  */
-export declare const CURRENT_SCHEMA_VERSION: "1.8";
+export declare const CURRENT_SCHEMA_VERSION: "1.10";
 type ContextOverrideStrategy = 'merge' | 'replace';
 declare const serializedSpanBase: z.ZodObject<{
     object: z.ZodLiteral<"trace.span">;
@@ -53,6 +57,40 @@ declare const serializedSpanBase: z.ZodObject<{
 type SerializedSpanType = z.infer<typeof serializedSpanBase> & {
     previous_span?: SerializedSpanType;
 };
+declare const sandboxStateSchema: z.ZodObject<{
+    backendId: z.ZodString;
+    currentAgentKey: z.ZodString;
+    currentAgentName: z.ZodString;
+    sessionState: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        backendId: z.ZodString;
+        manifest: z.ZodRecord<z.ZodString, z.ZodAny>;
+        snapshot: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+        snapshotFingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        snapshotFingerprintVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        workspaceReady: z.ZodBoolean;
+        exposedPorts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        providerState: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, z.core.$strip>;
+    sessionsByAgent: z.ZodRecord<z.ZodString, z.ZodObject<{
+        backendId: z.ZodString;
+        currentAgentKey: z.ZodString;
+        currentAgentName: z.ZodString;
+        sessionState: z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            backendId: z.ZodString;
+            manifest: z.ZodRecord<z.ZodString, z.ZodAny>;
+            snapshot: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+            snapshotFingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            snapshotFingerprintVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            workspaceReady: z.ZodBoolean;
+            exposedPorts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            providerState: z.ZodRecord<z.ZodString, z.ZodAny>;
+        }, z.core.$strip>;
+        preservedOwnedSession: z.ZodOptional<z.ZodBoolean>;
+        reuseLiveSession: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const SerializedRunState: z.ZodObject<{
     $schemaVersion: z.ZodEnum<{
         "1.0": "1.0";
@@ -64,10 +102,13 @@ export declare const SerializedRunState: z.ZodObject<{
         1.6: "1.6";
         1.7: "1.7";
         1.8: "1.8";
+        1.9: "1.9";
+        "1.10": "1.10";
     }>;
     currentTurn: z.ZodNumber;
     currentAgent: z.ZodObject<{
         name: z.ZodString;
+        identity: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     originalInput: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -311,6 +352,7 @@ export declare const SerializedRunState: z.ZodObject<{
             type: z.ZodLiteral<"update_file">;
             path: z.ZodString;
             diff: z.ZodString;
+            moveTo: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"delete_file">;
             path: z.ZodString;
@@ -658,6 +700,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 type: z.ZodLiteral<"update_file">;
                 path: z.ZodString;
                 diff: z.ZodString;
+                moveTo: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"delete_file">;
                 path: z.ZodString;
@@ -828,6 +871,7 @@ export declare const SerializedRunState: z.ZodObject<{
         agentOutput: z.ZodAny;
         agent: z.ZodObject<{
             name: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         output: z.ZodObject<{
             tripwireTriggered: z.ZodBoolean;
@@ -1100,6 +1144,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 type: z.ZodLiteral<"update_file">;
                 path: z.ZodString;
                 diff: z.ZodString;
+                moveTo: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"delete_file">;
                 path: z.ZodString;
@@ -1258,6 +1303,7 @@ export declare const SerializedRunState: z.ZodObject<{
         }, z.core.$strip>;
         agent: z.ZodObject<{
             name: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"tool_search_call_item">;
@@ -1276,6 +1322,7 @@ export declare const SerializedRunState: z.ZodObject<{
         }, z.core.$strip>;
         agent: z.ZodObject<{
             name: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"tool_search_output_item">;
@@ -1294,6 +1341,7 @@ export declare const SerializedRunState: z.ZodObject<{
         }, z.core.$strip>;
         agent: z.ZodObject<{
             name: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"tool_call_item">;
@@ -1423,6 +1471,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 type: z.ZodLiteral<"update_file">;
                 path: z.ZodString;
                 diff: z.ZodString;
+                moveTo: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"delete_file">;
                 path: z.ZodString;
@@ -1459,6 +1508,7 @@ export declare const SerializedRunState: z.ZodObject<{
         }, z.core.$strip>]>;
         agent: z.ZodObject<{
             name: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"tool_call_output_item">;
@@ -1564,6 +1614,7 @@ export declare const SerializedRunState: z.ZodObject<{
         }, z.core.$strip>]>;
         agent: z.ZodObject<{
             name: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         output: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
@@ -1585,6 +1636,7 @@ export declare const SerializedRunState: z.ZodObject<{
         }, z.core.$strip>;
         agent: z.ZodObject<{
             name: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"handoff_call_item">;
@@ -1604,6 +1656,7 @@ export declare const SerializedRunState: z.ZodObject<{
         }, z.core.$strip>;
         agent: z.ZodObject<{
             name: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"handoff_output_item">;
@@ -1673,9 +1726,11 @@ export declare const SerializedRunState: z.ZodObject<{
         }, z.core.$strip>;
         sourceAgent: z.ZodObject<{
             name: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         targetAgent: z.ZodObject<{
             name: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"tool_approval_item">;
@@ -1826,6 +1881,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 type: z.ZodLiteral<"update_file">;
                 path: z.ZodString;
                 diff: z.ZodString;
+                moveTo: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"delete_file">;
                 path: z.ZodString;
@@ -1833,6 +1889,7 @@ export declare const SerializedRunState: z.ZodObject<{
         }, z.core.$strip>]>;
         agent: z.ZodObject<{
             name: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         toolName: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>], "type">>;
@@ -1874,6 +1931,7 @@ export declare const SerializedRunState: z.ZodObject<{
             }, z.core.$strip>;
             agent: z.ZodObject<{
                 name: z.ZodString;
+                identity: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"tool_search_call_item">;
@@ -1892,6 +1950,7 @@ export declare const SerializedRunState: z.ZodObject<{
             }, z.core.$strip>;
             agent: z.ZodObject<{
                 name: z.ZodString;
+                identity: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"tool_search_output_item">;
@@ -1910,6 +1969,7 @@ export declare const SerializedRunState: z.ZodObject<{
             }, z.core.$strip>;
             agent: z.ZodObject<{
                 name: z.ZodString;
+                identity: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"tool_call_item">;
@@ -2039,6 +2099,7 @@ export declare const SerializedRunState: z.ZodObject<{
                     type: z.ZodLiteral<"update_file">;
                     path: z.ZodString;
                     diff: z.ZodString;
+                    moveTo: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>, z.ZodObject<{
                     type: z.ZodLiteral<"delete_file">;
                     path: z.ZodString;
@@ -2075,6 +2136,7 @@ export declare const SerializedRunState: z.ZodObject<{
             }, z.core.$strip>]>;
             agent: z.ZodObject<{
                 name: z.ZodString;
+                identity: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"tool_call_output_item">;
@@ -2180,6 +2242,7 @@ export declare const SerializedRunState: z.ZodObject<{
             }, z.core.$strip>]>;
             agent: z.ZodObject<{
                 name: z.ZodString;
+                identity: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
             output: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
@@ -2201,6 +2264,7 @@ export declare const SerializedRunState: z.ZodObject<{
             }, z.core.$strip>;
             agent: z.ZodObject<{
                 name: z.ZodString;
+                identity: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"handoff_call_item">;
@@ -2220,6 +2284,7 @@ export declare const SerializedRunState: z.ZodObject<{
             }, z.core.$strip>;
             agent: z.ZodObject<{
                 name: z.ZodString;
+                identity: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"handoff_output_item">;
@@ -2289,9 +2354,11 @@ export declare const SerializedRunState: z.ZodObject<{
             }, z.core.$strip>;
             sourceAgent: z.ZodObject<{
                 name: z.ZodString;
+                identity: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
             targetAgent: z.ZodObject<{
                 name: z.ZodString;
+                identity: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"tool_approval_item">;
@@ -2442,6 +2509,7 @@ export declare const SerializedRunState: z.ZodObject<{
                     type: z.ZodLiteral<"update_file">;
                     path: z.ZodString;
                     diff: z.ZodString;
+                    moveTo: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>, z.ZodObject<{
                     type: z.ZodLiteral<"delete_file">;
                     path: z.ZodString;
@@ -2449,6 +2517,7 @@ export declare const SerializedRunState: z.ZodObject<{
             }, z.core.$strip>]>;
             agent: z.ZodObject<{
                 name: z.ZodString;
+                identity: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
             toolName: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>], "type">>;
@@ -2506,6 +2575,40 @@ export declare const SerializedRunState: z.ZodObject<{
         metadata: z.ZodRecord<z.ZodString, z.ZodAny>;
         tracing_api_key: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     }, z.core.$strip>>;
+    sandbox: z.ZodOptional<z.ZodObject<{
+        backendId: z.ZodString;
+        currentAgentKey: z.ZodString;
+        currentAgentName: z.ZodString;
+        sessionState: z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            backendId: z.ZodString;
+            manifest: z.ZodRecord<z.ZodString, z.ZodAny>;
+            snapshot: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+            snapshotFingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            snapshotFingerprintVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            workspaceReady: z.ZodBoolean;
+            exposedPorts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            providerState: z.ZodRecord<z.ZodString, z.ZodAny>;
+        }, z.core.$strip>;
+        sessionsByAgent: z.ZodRecord<z.ZodString, z.ZodObject<{
+            backendId: z.ZodString;
+            currentAgentKey: z.ZodString;
+            currentAgentName: z.ZodString;
+            sessionState: z.ZodObject<{
+                version: z.ZodLiteral<1>;
+                backendId: z.ZodString;
+                manifest: z.ZodRecord<z.ZodString, z.ZodAny>;
+                snapshot: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+                snapshotFingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                snapshotFingerprintVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                workspaceReady: z.ZodBoolean;
+                exposedPorts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                providerState: z.ZodRecord<z.ZodString, z.ZodAny>;
+            }, z.core.$strip>;
+            preservedOwnedSession: z.ZodOptional<z.ZodBoolean>;
+            reuseLiveSession: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type FinalOutputSource = 'error_handler' | 'turn_resolution';
 type ToolSearchRuntimeToolEntry<TContext = UnknownContext> = {
@@ -2649,10 +2752,14 @@ export declare class RunState<TContext, TAgent extends Agent<any, any>> {
      */
     _trace: Trace | null;
     /**
-     * Runtime-only tool_search-loaded tools, scoped by agent name and preserved across turns for
+     * Runtime-only tool_search-loaded tools, scoped by agent object and preserved across turns for
      * the lifetime of this in-memory run.
      */
-    _toolSearchRuntimeToolsByAgentName: Map<string, ToolSearchRuntimeToolState<TContext>>;
+    _toolSearchRuntimeToolsByAgent: Map<Agent<any, any>, ToolSearchRuntimeToolState<TContext>>;
+    /**
+     * Persisted sandbox session metadata for sandbox-agent resume.
+     */
+    _sandbox: z.infer<typeof sandboxStateSchema> | undefined;
     constructor(context: RunContext<TContext>, originalInput: string | AgentInputItem[], startingAgent: TAgent, maxTurns: number);
     /**
      * Updates server-managed conversation identifiers as a single operation.