@openai/agents-core 0.5.3 → 0.6.0

package/dist/runState.d.ts

@@ -10,9 +10,11 @@ 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 * as protocol from './types/protocol';
+import { AgentInputItem, UnknownContext } from './types';
 import type { InputGuardrailResult, OutputGuardrailResult } from './guardrail';
 import type { ToolInputGuardrailResult, ToolOutputGuardrailResult } from './toolGuardrail';
+import { Tool } from './tool';
 import type { AgentToolInvocation } from './agentToolInvocation';
 /**
  * The schema version of the serialized run state. This is used to ensure that the serialized
@@ -29,8 +31,11 @@ import type { AgentToolInvocation } from './agentToolInvocation';
  * - 1.4: Adds optional toolInput to serialized run context.
  * - 1.5: Adds optional reasoningItemIdPolicy to preserve reasoning input policy across resume.
  * - 1.6: Adds optional requestId to serialized model responses.
+ * - 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.
  */
-export declare const CURRENT_SCHEMA_VERSION: "1.6";
+export declare const CURRENT_SCHEMA_VERSION: "1.8";
 type ContextOverrideStrategy = 'merge' | 'replace';
 declare const serializedSpanBase: z.ZodObject<{
     object: z.ZodLiteral<"trace.span">;
@@ -57,6 +62,8 @@ export declare const SerializedRunState: z.ZodObject<{
         1.4: "1.4";
         1.5: "1.5";
         1.6: "1.6";
+        1.7: "1.7";
+        1.8: "1.8";
     }>;
     currentTurn: z.ZodNumber;
     currentAgent: z.ZodObject<{
@@ -133,6 +140,30 @@ export declare const SerializedRunState: z.ZodObject<{
         type: z.ZodOptional<z.ZodLiteral<"message">>;
         role: z.ZodLiteral<"system">;
         content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        id: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"tool_search_call">;
+        call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        callId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        execution: z.ZodOptional<z.ZodEnum<{
+            client: "client";
+            server: "server";
+        }>>;
+        arguments: z.ZodUnknown;
+        status: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        id: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"tool_search_output">;
+        call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        callId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        execution: z.ZodOptional<z.ZodEnum<{
+            client: "client";
+            server: "server";
+        }>>;
+        status: z.ZodOptional<z.ZodString>;
+        tools: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
     }, z.core.$strip>, z.ZodObject<{
         providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
         id: z.ZodOptional<z.ZodString>;
@@ -147,6 +178,7 @@ export declare const SerializedRunState: z.ZodObject<{
         type: z.ZodLiteral<"function_call">;
         callId: z.ZodString;
         name: z.ZodString;
+        namespace: z.ZodOptional<z.ZodString>;
         status: z.ZodOptional<z.ZodEnum<{
             in_progress: "in_progress";
             completed: "completed";
@@ -163,7 +195,7 @@ export declare const SerializedRunState: z.ZodObject<{
             completed: "completed";
             incomplete: "incomplete";
         }>;
-        action: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodLiteral<"screenshot">;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"click">;
@@ -204,7 +236,49 @@ export declare const SerializedRunState: z.ZodObject<{
                 x: z.ZodNumber;
                 y: z.ZodNumber;
             }, z.core.$strip>>;
-        }, z.core.$strip>], "type">;
+        }, z.core.$strip>], "type">>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"screenshot">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"click">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            button: z.ZodEnum<{
+                left: "left";
+                right: "right";
+                wheel: "wheel";
+                back: "back";
+                forward: "forward";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"double_click">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"scroll">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            scroll_x: z.ZodNumber;
+            scroll_y: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"type">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"wait">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"move">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"keypress">;
+            keys: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"drag">;
+            path: z.ZodArray<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>], "type">>>;
     }, z.core.$strip>, z.ZodObject<{
         providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
         id: z.ZodOptional<z.ZodString>;
@@ -246,6 +320,7 @@ export declare const SerializedRunState: z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         type: z.ZodLiteral<"function_call_result">;
         name: z.ZodString;
+        namespace: z.ZodOptional<z.ZodString>;
         callId: z.ZodString;
         status: z.ZodEnum<{
             in_progress: "in_progress";
@@ -412,6 +487,30 @@ export declare const SerializedRunState: z.ZodObject<{
                 type: z.ZodLiteral<"image">;
                 image: z.ZodString;
             }, z.core.$strip>], "type">>;
+        }, z.core.$strip>, z.ZodObject<{
+            providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            id: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"tool_search_call">;
+            call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            callId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            execution: z.ZodOptional<z.ZodEnum<{
+                client: "client";
+                server: "server";
+            }>>;
+            arguments: z.ZodUnknown;
+            status: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            id: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"tool_search_output">;
+            call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            callId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            execution: z.ZodOptional<z.ZodEnum<{
+                client: "client";
+                server: "server";
+            }>>;
+            status: z.ZodOptional<z.ZodString>;
+            tools: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
         }, z.core.$strip>, z.ZodObject<{
             providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
             id: z.ZodOptional<z.ZodString>;
@@ -426,6 +525,7 @@ export declare const SerializedRunState: z.ZodObject<{
             type: z.ZodLiteral<"function_call">;
             callId: z.ZodString;
             name: z.ZodString;
+            namespace: z.ZodOptional<z.ZodString>;
             status: z.ZodOptional<z.ZodEnum<{
                 in_progress: "in_progress";
                 completed: "completed";
@@ -442,7 +542,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 completed: "completed";
                 incomplete: "incomplete";
             }>;
-            action: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            action: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"screenshot">;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"click">;
@@ -483,7 +583,49 @@ export declare const SerializedRunState: z.ZodObject<{
                     x: z.ZodNumber;
                     y: z.ZodNumber;
                 }, z.core.$strip>>;
-            }, z.core.$strip>], "type">;
+            }, z.core.$strip>], "type">>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"screenshot">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"click">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                button: z.ZodEnum<{
+                    left: "left";
+                    right: "right";
+                    wheel: "wheel";
+                    back: "back";
+                    forward: "forward";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"double_click">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"scroll">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                scroll_x: z.ZodNumber;
+                scroll_y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"type">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"wait">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"move">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"keypress">;
+                keys: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"drag">;
+                path: z.ZodArray<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>], "type">>>;
         }, z.core.$strip>, z.ZodObject<{
             providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
             id: z.ZodOptional<z.ZodString>;
@@ -525,6 +667,7 @@ export declare const SerializedRunState: z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             type: z.ZodLiteral<"function_call_result">;
             name: z.ZodString;
+            namespace: z.ZodOptional<z.ZodString>;
             callId: z.ZodString;
             status: z.ZodEnum<{
                 in_progress: "in_progress";
@@ -657,6 +800,8 @@ export declare const SerializedRunState: z.ZodObject<{
         approvals: z.ZodRecord<z.ZodString, z.ZodObject<{
             approved: z.ZodUnion<[z.ZodArray<z.ZodString>, z.ZodBoolean]>;
             rejected: z.ZodUnion<[z.ZodArray<z.ZodString>, z.ZodBoolean]>;
+            messages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            stickyRejectMessage: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         context: z.ZodRecord<z.ZodString, z.ZodAny>;
         toolInput: z.ZodOptional<z.ZodAny>;
@@ -784,6 +929,30 @@ export declare const SerializedRunState: z.ZodObject<{
                 type: z.ZodLiteral<"image">;
                 image: z.ZodString;
             }, z.core.$strip>], "type">>;
+        }, z.core.$strip>, z.ZodObject<{
+            providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            id: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"tool_search_call">;
+            call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            callId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            execution: z.ZodOptional<z.ZodEnum<{
+                client: "client";
+                server: "server";
+            }>>;
+            arguments: z.ZodUnknown;
+            status: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            id: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"tool_search_output">;
+            call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            callId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            execution: z.ZodOptional<z.ZodEnum<{
+                client: "client";
+                server: "server";
+            }>>;
+            status: z.ZodOptional<z.ZodString>;
+            tools: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
         }, z.core.$strip>, z.ZodObject<{
             providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
             id: z.ZodOptional<z.ZodString>;
@@ -798,6 +967,7 @@ export declare const SerializedRunState: z.ZodObject<{
             type: z.ZodLiteral<"function_call">;
             callId: z.ZodString;
             name: z.ZodString;
+            namespace: z.ZodOptional<z.ZodString>;
             status: z.ZodOptional<z.ZodEnum<{
                 in_progress: "in_progress";
                 completed: "completed";
@@ -814,7 +984,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 completed: "completed";
                 incomplete: "incomplete";
             }>;
-            action: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            action: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"screenshot">;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"click">;
@@ -855,7 +1025,49 @@ export declare const SerializedRunState: z.ZodObject<{
                     x: z.ZodNumber;
                     y: z.ZodNumber;
                 }, z.core.$strip>>;
-            }, z.core.$strip>], "type">;
+            }, z.core.$strip>], "type">>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"screenshot">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"click">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                button: z.ZodEnum<{
+                    left: "left";
+                    right: "right";
+                    wheel: "wheel";
+                    back: "back";
+                    forward: "forward";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"double_click">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"scroll">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                scroll_x: z.ZodNumber;
+                scroll_y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"type">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"wait">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"move">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"keypress">;
+                keys: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"drag">;
+                path: z.ZodArray<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>], "type">>>;
         }, z.core.$strip>, z.ZodObject<{
             providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
             id: z.ZodOptional<z.ZodString>;
@@ -897,6 +1109,7 @@ export declare const SerializedRunState: z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             type: z.ZodLiteral<"function_call_result">;
             name: z.ZodString;
+            namespace: z.ZodOptional<z.ZodString>;
             callId: z.ZodString;
             status: z.ZodEnum<{
                 in_progress: "in_progress";
@@ -1046,6 +1259,42 @@ export declare const SerializedRunState: z.ZodObject<{
         agent: z.ZodObject<{
             name: z.ZodString;
         }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_search_call_item">;
+        rawItem: z.ZodObject<{
+            providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            id: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"tool_search_call">;
+            call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            callId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            execution: z.ZodOptional<z.ZodEnum<{
+                client: "client";
+                server: "server";
+            }>>;
+            arguments: z.ZodUnknown;
+            status: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        agent: z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_search_output_item">;
+        rawItem: z.ZodObject<{
+            providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            id: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"tool_search_output">;
+            call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            callId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            execution: z.ZodOptional<z.ZodEnum<{
+                client: "client";
+                server: "server";
+            }>>;
+            status: z.ZodOptional<z.ZodString>;
+            tools: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strip>;
+        agent: z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"tool_call_item">;
         rawItem: z.ZodUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1058,7 +1307,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 completed: "completed";
                 incomplete: "incomplete";
             }>;
-            action: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            action: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"screenshot">;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"click">;
@@ -1099,7 +1348,49 @@ export declare const SerializedRunState: z.ZodObject<{
                     x: z.ZodNumber;
                     y: z.ZodNumber;
                 }, z.core.$strip>>;
-            }, z.core.$strip>], "type">;
+            }, z.core.$strip>], "type">>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"screenshot">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"click">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                button: z.ZodEnum<{
+                    left: "left";
+                    right: "right";
+                    wheel: "wheel";
+                    back: "back";
+                    forward: "forward";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"double_click">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"scroll">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                scroll_x: z.ZodNumber;
+                scroll_y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"type">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"wait">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"move">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"keypress">;
+                keys: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"drag">;
+                path: z.ZodArray<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>], "type">>>;
         }, z.core.$strip>, z.ZodObject<{
             providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
             id: z.ZodOptional<z.ZodString>;
@@ -1142,6 +1433,7 @@ export declare const SerializedRunState: z.ZodObject<{
             type: z.ZodLiteral<"function_call">;
             callId: z.ZodString;
             name: z.ZodString;
+            namespace: z.ZodOptional<z.ZodString>;
             status: z.ZodOptional<z.ZodEnum<{
                 in_progress: "in_progress";
                 completed: "completed";
@@ -1175,6 +1467,7 @@ export declare const SerializedRunState: z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             type: z.ZodLiteral<"function_call_result">;
             name: z.ZodString;
+            namespace: z.ZodOptional<z.ZodString>;
             callId: z.ZodString;
             status: z.ZodEnum<{
                 in_progress: "in_progress";
@@ -1301,6 +1594,7 @@ export declare const SerializedRunState: z.ZodObject<{
             type: z.ZodLiteral<"function_call">;
             callId: z.ZodString;
             name: z.ZodString;
+            namespace: z.ZodOptional<z.ZodString>;
             status: z.ZodOptional<z.ZodEnum<{
                 in_progress: "in_progress";
                 completed: "completed";
@@ -1318,6 +1612,7 @@ export declare const SerializedRunState: z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             type: z.ZodLiteral<"function_call_result">;
             name: z.ZodString;
+            namespace: z.ZodOptional<z.ZodString>;
             callId: z.ZodString;
             status: z.ZodEnum<{
                 in_progress: "in_progress";
@@ -1390,6 +1685,7 @@ export declare const SerializedRunState: z.ZodObject<{
             type: z.ZodLiteral<"function_call">;
             callId: z.ZodString;
             name: z.ZodString;
+            namespace: z.ZodOptional<z.ZodString>;
             status: z.ZodOptional<z.ZodEnum<{
                 in_progress: "in_progress";
                 completed: "completed";
@@ -1414,7 +1710,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 completed: "completed";
                 incomplete: "incomplete";
             }>;
-            action: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            action: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"screenshot">;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"click">;
@@ -1455,7 +1751,49 @@ export declare const SerializedRunState: z.ZodObject<{
                     x: z.ZodNumber;
                     y: z.ZodNumber;
                 }, z.core.$strip>>;
-            }, z.core.$strip>], "type">;
+            }, z.core.$strip>], "type">>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"screenshot">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"click">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                button: z.ZodEnum<{
+                    left: "left";
+                    right: "right";
+                    wheel: "wheel";
+                    back: "back";
+                    forward: "forward";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"double_click">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"scroll">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                scroll_x: z.ZodNumber;
+                scroll_y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"type">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"wait">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"move">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"keypress">;
+                keys: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"drag">;
+                path: z.ZodArray<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>], "type">>>;
         }, z.core.$strip>]>, z.ZodObject<{
             providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
             id: z.ZodOptional<z.ZodString>;
@@ -1537,6 +1875,42 @@ export declare const SerializedRunState: z.ZodObject<{
             agent: z.ZodObject<{
                 name: z.ZodString;
             }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tool_search_call_item">;
+            rawItem: z.ZodObject<{
+                providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                id: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"tool_search_call">;
+                call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                callId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                execution: z.ZodOptional<z.ZodEnum<{
+                    client: "client";
+                    server: "server";
+                }>>;
+                arguments: z.ZodUnknown;
+                status: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            agent: z.ZodObject<{
+                name: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tool_search_output_item">;
+            rawItem: z.ZodObject<{
+                providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                id: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"tool_search_output">;
+                call_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                callId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                execution: z.ZodOptional<z.ZodEnum<{
+                    client: "client";
+                    server: "server";
+                }>>;
+                status: z.ZodOptional<z.ZodString>;
+                tools: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            }, z.core.$strip>;
+            agent: z.ZodObject<{
+                name: z.ZodString;
+            }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"tool_call_item">;
             rawItem: z.ZodUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1549,7 +1923,7 @@ export declare const SerializedRunState: z.ZodObject<{
                     completed: "completed";
                     incomplete: "incomplete";
                 }>;
-                action: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                action: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     type: z.ZodLiteral<"screenshot">;
                 }, z.core.$strip>, z.ZodObject<{
                     type: z.ZodLiteral<"click">;
@@ -1590,7 +1964,49 @@ export declare const SerializedRunState: z.ZodObject<{
                         x: z.ZodNumber;
                         y: z.ZodNumber;
                     }, z.core.$strip>>;
-                }, z.core.$strip>], "type">;
+                }, z.core.$strip>], "type">>;
+                actions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"screenshot">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"click">;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    button: z.ZodEnum<{
+                        left: "left";
+                        right: "right";
+                        wheel: "wheel";
+                        back: "back";
+                        forward: "forward";
+                    }>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"double_click">;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"scroll">;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    scroll_x: z.ZodNumber;
+                    scroll_y: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"type">;
+                    text: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"wait">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"move">;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"keypress">;
+                    keys: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"drag">;
+                    path: z.ZodArray<z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>], "type">>>;
             }, z.core.$strip>, z.ZodObject<{
                 providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
                 id: z.ZodOptional<z.ZodString>;
@@ -1633,6 +2049,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 type: z.ZodLiteral<"function_call">;
                 callId: z.ZodString;
                 name: z.ZodString;
+                namespace: z.ZodOptional<z.ZodString>;
                 status: z.ZodOptional<z.ZodEnum<{
                     in_progress: "in_progress";
                     completed: "completed";
@@ -1666,6 +2083,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 id: z.ZodOptional<z.ZodString>;
                 type: z.ZodLiteral<"function_call_result">;
                 name: z.ZodString;
+                namespace: z.ZodOptional<z.ZodString>;
                 callId: z.ZodString;
                 status: z.ZodEnum<{
                     in_progress: "in_progress";
@@ -1792,6 +2210,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 type: z.ZodLiteral<"function_call">;
                 callId: z.ZodString;
                 name: z.ZodString;
+                namespace: z.ZodOptional<z.ZodString>;
                 status: z.ZodOptional<z.ZodEnum<{
                     in_progress: "in_progress";
                     completed: "completed";
@@ -1809,6 +2228,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 id: z.ZodOptional<z.ZodString>;
                 type: z.ZodLiteral<"function_call_result">;
                 name: z.ZodString;
+                namespace: z.ZodOptional<z.ZodString>;
                 callId: z.ZodString;
                 status: z.ZodEnum<{
                     in_progress: "in_progress";
@@ -1881,6 +2301,7 @@ export declare const SerializedRunState: z.ZodObject<{
                 type: z.ZodLiteral<"function_call">;
                 callId: z.ZodString;
                 name: z.ZodString;
+                namespace: z.ZodOptional<z.ZodString>;
                 status: z.ZodOptional<z.ZodEnum<{
                     in_progress: "in_progress";
                     completed: "completed";
@@ -1905,7 +2326,7 @@ export declare const SerializedRunState: z.ZodObject<{
                     completed: "completed";
                     incomplete: "incomplete";
                 }>;
-                action: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                action: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     type: z.ZodLiteral<"screenshot">;
                 }, z.core.$strip>, z.ZodObject<{
                     type: z.ZodLiteral<"click">;
@@ -1946,7 +2367,49 @@ export declare const SerializedRunState: z.ZodObject<{
                         x: z.ZodNumber;
                         y: z.ZodNumber;
                     }, z.core.$strip>>;
-                }, z.core.$strip>], "type">;
+                }, z.core.$strip>], "type">>;
+                actions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"screenshot">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"click">;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    button: z.ZodEnum<{
+                        left: "left";
+                        right: "right";
+                        wheel: "wheel";
+                        back: "back";
+                        forward: "forward";
+                    }>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"double_click">;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"scroll">;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    scroll_x: z.ZodNumber;
+                    scroll_y: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"type">;
+                    text: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"wait">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"move">;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"keypress">;
+                    keys: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"drag">;
+                    path: z.ZodArray<z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>], "type">>>;
             }, z.core.$strip>]>, z.ZodObject<{
                 providerData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
                 id: z.ZodOptional<z.ZodString>;
@@ -2045,6 +2508,15 @@ export declare const SerializedRunState: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type FinalOutputSource = 'error_handler' | 'turn_resolution';
+type ToolSearchRuntimeToolEntry<TContext = UnknownContext> = {
+    order: number;
+    tools: Tool<TContext>[];
+};
+type ToolSearchRuntimeToolState<TContext = UnknownContext> = {
+    anonymousEntries: ToolSearchRuntimeToolEntry<TContext>[];
+    keyedEntries: Map<string, ToolSearchRuntimeToolEntry<TContext>>;
+    nextOrder: number;
+};
 /**
  * Serializable snapshot of an agent's run, including context, usage and trace.
  * While this class has publicly writable properties (prefixed with `_`), they are not meant to be
@@ -2175,6 +2647,11 @@ export declare class RunState<TContext, TAgent extends Agent<any, any>> {
      * Trace associated with this run if tracing is enabled.
      */
     _trace: Trace | null;
+    /**
+     * Runtime-only tool_search-loaded tools, scoped by agent name and preserved across turns for
+     * the lifetime of this in-memory run.
+     */
+    _toolSearchRuntimeToolsByAgentName: Map<string, ToolSearchRuntimeToolState<TContext>>;
     constructor(context: RunContext<TContext>, originalInput: string | AgentInputItem[], startingAgent: TAgent, maxTurns: number);
     /**
      * Updates server-managed conversation identifiers as a single operation.
@@ -2188,6 +2665,9 @@ export declare class RunState<TContext, TAgent extends Agent<any, any>> {
      * Updates the agent span associated with the current run.
      */
     setCurrentAgentSpan(span?: Span<AgentSpanData>): void;
+    private getOrCreateToolSearchRuntimeToolState;
+    recordToolSearchRuntimeTools(agent: Agent<any, any>, toolSearchOutput: protocol.ToolSearchOutputItem, tools: Tool<TContext>[]): void;
+    getToolSearchRuntimeTools(agent: Agent<any, any>): Tool<TContext>[];
     /**
      * Switches the active agent handling the run.
      */
@@ -2230,6 +2710,7 @@ export declare class RunState<TContext, TAgent extends Agent<any, any>> {
      *
      * @param approvalItem - The tool call approval item to approve.
      * @param options - Options for the approval.
+     * @param options.alwaysApprove - Approve this tool for all future calls in this run.
      */
     approve(approvalItem: RunToolApprovalItem, options?: {
         alwaysApprove?: boolean;
@@ -2240,14 +2721,21 @@ export declare class RunState<TContext, TAgent extends Agent<any, any>> {
      * To reject the request use this method and then run the agent again with the same state object
      * to continue the execution.
      *
-     * By default it will only reject the current tool call. To allow the tool to be used multiple
-     * times throughout the run, set the `alwaysReject` option to `true`.
+     * By default it will only reject the current tool call. To reject the tool for all future
+     * calls throughout the run, set the `alwaysReject` option to `true`.
+     *
+     * When `message` is provided, it is used as the rejection text sent to the model.
+     * Otherwise, `toolErrorFormatter` (if configured) or the SDK default is used.
      *
      * @param approvalItem - The tool call approval item to reject.
      * @param options - Options for the rejection.
+     * @param options.alwaysReject - Reject this tool for all future calls in this run.
+     * @param options.message - The rejection text sent to the model.
+     *   If not provided, `toolErrorFormatter` (if configured) or the SDK default is used.
      */
     reject(approvalItem: RunToolApprovalItem, options?: {
         alwaysReject?: boolean;
+        message?: string;
     }): void;
     /**
      * Serializes the run state to a JSON object.