openai 7.27.0 → 7.30.0

package/lib/beta/agents/agent-session-create-stream.js

@@ -1,15 +1,46 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.withAgentTurnResult = withAgentTurnResult;
+exports.captureCreationTools = captureCreationTools;
+const error_1 = require("../../../core/error.js");
+const headers_1 = require("../../../internal/headers.js");
+const turn_state_1 = require("../../agents/turn-state.js");
+const tool_dispatcher_1 = require("./tool-dispatcher.js");
 const parse_result_1 = require("./parse-result.js");
 const result_collection_1 = require("./result-collection.js");
+async function* dispatchCreationTools(source, dispatcher, signal) {
+    const state = new turn_state_1.TurnState();
+    let sessionID;
+    for await (const event of { [Symbol.asyncIterator]: source }) {
+        if (event.type === 'agent.session.created') {
+            sessionID ?? (sessionID = event.session.id);
+        }
+        const dispatch = state.accept(event) ? dispatcher.prepare(state.call(event), sessionID) : undefined;
+        yield event;
+        if (signal.aborted) {
+            return;
+        }
+        try {
+            await dispatch?.();
+        }
+        catch (error) {
+            if (signal.aborted && error instanceof error_1.APIUserAbortError) {
+                return;
+            }
+            throw error;
+        }
+    }
+}
 /** Add beta result collection without replacing custom stream instances.
  * @internal
  */
-function withAgentTurnResult(stream, format) {
+function withAgentTurnResult(stream, format, tools) {
     let collection;
     stream.__betaTransformIterator((source) => {
-        collection = new result_collection_1.ResultCollection(source, undefined, undefined, stream.controller.signal);
+        // A tool result has its own POST endpoint, independent of creation overrides.
+        const { path: _path, method: _method, stream: _stream, ...options } = tools?.options ?? {};
+        const dispatcher = tools && new tool_dispatcher_1.AgentToolDispatcher(tools.sessions, tools.handlers, stream.controller, options);
+        collection = new result_collection_1.ResultCollection(dispatcher ? () => dispatchCreationTools(source, dispatcher, stream.controller.signal) : source, dispatcher ? (name) => dispatcher.canHandle(name) : undefined, undefined, stream.controller.signal);
         return () => collection.iterate();
     });
     let parsed;
@@ -22,4 +53,41 @@ function withAgentTurnResult(stream, format) {
     });
     return result;
 }
+/** Remove local callbacks without changing ordinary creation requests. @internal */
+function captureCreationTools(body, options) {
+    const descriptor = Object.getOwnPropertyDescriptor(body, 'toolHandlers');
+    if (!descriptor) {
+        return { body, options };
+    }
+    const handlers = body.toolHandlers;
+    if (handlers === undefined && 'value' in descriptor) {
+        return { body, options };
+    }
+    const descriptors = Object.getOwnPropertyDescriptors(body);
+    delete descriptors.toolHandlers;
+    const capturedOptions = { ...options };
+    if ('toJSON' in body || capturedOptions.body !== undefined) {
+        throw new error_1.OpenAIError('Creation tool handlers cannot customize request body serialization');
+    }
+    if (handlers === undefined) {
+        // SAFETY: Preserve request fields while removing the accessor so serialization cannot evaluate it again.
+        return {
+            body: Object.create(Object.getPrototypeOf(body), descriptors),
+            options: capturedOptions,
+        };
+    }
+    const { stream } = body;
+    if (stream !== true) {
+        throw new error_1.OpenAIError('toolHandlers requires stream: true');
+    }
+    capturedOptions.headers = (0, headers_1.buildHeaders)([capturedOptions.headers]);
+    descriptors.stream = { value: stream, enumerable: true, configurable: true, writable: true };
+    // SAFETY: Preserve request fields, omitting callbacks and fixing the validated streaming mode.
+    const request = Object.create(Object.getPrototypeOf(body), descriptors);
+    return {
+        body: request,
+        options: capturedOptions,
+        handlers: handlers && Object.fromEntries(Object.entries(handlers)),
+    };
+}
 //# sourceMappingURL=agent-session-create-stream.js.map

package/lib/beta/agents/agent-session-create-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-create-stream.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/agent-session-create-stream.ts"],"names":[],"mappings":";;AAiBA,kDAkBC;AAhCD,oDAAyD;AACzD,8DAAuD;AAUvD;;GAEG;AACH,SAAgB,mBAAmB,CACjC,MAAiC,EACjC,MAA6B;IAE7B,IAAI,UAA4B,CAAC;IACjC,MAAM,CAAC,uBAAuB,CAAC,CAAC,MAAM,EAAE,EAAE;QACxC,UAAU,GAAG,IAAI,oCAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1F,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IACH,IAAI,MAA2C,CAAC;IAChD,MAAM,MAAM,GAAgC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QAChE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,KAAN,MAAM,GAAK,IAAA,sCAAuB,EAAC,UAAU,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,EAAC;QACzF,oBAAoB,EAAE,GAAgC,EAAE;YACtD,UAAU,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"agent-session-create-stream.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/agent-session-create-stream.ts"],"names":[],"mappings":"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"}

package/lib/beta/agents/agent-session-create-stream.mjs

@@ -1,12 +1,42 @@
+import { APIUserAbortError, OpenAIError } from "../../../core/error.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { TurnState } from "../../agents/turn-state.mjs";
+import { AgentToolDispatcher } from "./tool-dispatcher.mjs";
 import { parseAgentResultPromise } from "./parse-result.mjs";
 import { ResultCollection } from "./result-collection.mjs";
+async function* dispatchCreationTools(source, dispatcher, signal) {
+    const state = new TurnState();
+    let sessionID;
+    for await (const event of { [Symbol.asyncIterator]: source }) {
+        if (event.type === 'agent.session.created') {
+            sessionID ?? (sessionID = event.session.id);
+        }
+        const dispatch = state.accept(event) ? dispatcher.prepare(state.call(event), sessionID) : undefined;
+        yield event;
+        if (signal.aborted) {
+            return;
+        }
+        try {
+            await dispatch?.();
+        }
+        catch (error) {
+            if (signal.aborted && error instanceof APIUserAbortError) {
+                return;
+            }
+            throw error;
+        }
+    }
+}
 /** Add beta result collection without replacing custom stream instances.
  * @internal
  */
-export function withAgentTurnResult(stream, format) {
+export function withAgentTurnResult(stream, format, tools) {
     let collection;
     stream.__betaTransformIterator((source) => {
-        collection = new ResultCollection(source, undefined, undefined, stream.controller.signal);
+        // A tool result has its own POST endpoint, independent of creation overrides.
+        const { path: _path, method: _method, stream: _stream, ...options } = tools?.options ?? {};
+        const dispatcher = tools && new AgentToolDispatcher(tools.sessions, tools.handlers, stream.controller, options);
+        collection = new ResultCollection(dispatcher ? () => dispatchCreationTools(source, dispatcher, stream.controller.signal) : source, dispatcher ? (name) => dispatcher.canHandle(name) : undefined, undefined, stream.controller.signal);
         return () => collection.iterate();
     });
     let parsed;
@@ -19,4 +49,41 @@ export function withAgentTurnResult(stream, format) {
     });
     return result;
 }
+/** Remove local callbacks without changing ordinary creation requests. @internal */
+export function captureCreationTools(body, options) {
+    const descriptor = Object.getOwnPropertyDescriptor(body, 'toolHandlers');
+    if (!descriptor) {
+        return { body, options };
+    }
+    const handlers = body.toolHandlers;
+    if (handlers === undefined && 'value' in descriptor) {
+        return { body, options };
+    }
+    const descriptors = Object.getOwnPropertyDescriptors(body);
+    delete descriptors.toolHandlers;
+    const capturedOptions = { ...options };
+    if ('toJSON' in body || capturedOptions.body !== undefined) {
+        throw new OpenAIError('Creation tool handlers cannot customize request body serialization');
+    }
+    if (handlers === undefined) {
+        // SAFETY: Preserve request fields while removing the accessor so serialization cannot evaluate it again.
+        return {
+            body: Object.create(Object.getPrototypeOf(body), descriptors),
+            options: capturedOptions,
+        };
+    }
+    const { stream } = body;
+    if (stream !== true) {
+        throw new OpenAIError('toolHandlers requires stream: true');
+    }
+    capturedOptions.headers = buildHeaders([capturedOptions.headers]);
+    descriptors.stream = { value: stream, enumerable: true, configurable: true, writable: true };
+    // SAFETY: Preserve request fields, omitting callbacks and fixing the validated streaming mode.
+    const request = Object.create(Object.getPrototypeOf(body), descriptors);
+    return {
+        body: request,
+        options: capturedOptions,
+        handlers: handlers && Object.fromEntries(Object.entries(handlers)),
+    };
+}
 //# sourceMappingURL=agent-session-create-stream.mjs.map

package/lib/beta/agents/agent-session-create-stream.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-create-stream.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/agent-session-create-stream.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,2BAAuB;AACzD,OAAO,EAAE,gBAAgB,EAAE,gCAA4B;AAUvD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAiC,EACjC,MAA6B;IAE7B,IAAI,UAA4B,CAAC;IACjC,MAAM,CAAC,uBAAuB,CAAC,CAAC,MAAM,EAAE,EAAE;QACxC,UAAU,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1F,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IACH,IAAI,MAA2C,CAAC;IAChD,MAAM,MAAM,GAAgC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QAChE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,KAAN,MAAM,GAAK,uBAAuB,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,EAAC;QACzF,oBAAoB,EAAE,GAAgC,EAAE;YACtD,UAAU,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"agent-session-create-stream.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/agent-session-create-stream.ts"],"names":[],"mappings":"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"}

package/lib/beta/agents/function-tool.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"function-tool.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/function-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,8CAA0C;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,kCAA8B;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,kDAA8C;AAG5E,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,4BAA4B,CAAC;IACjE,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,SAAS,EACpC,IAAI,EAAE,yBAAyB,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC,GACtE,iBAAiB,CA+BnB"}
+{"version":3,"file":"function-tool.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/function-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,8CAA0C;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,kCAA8B;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,kDAA8C;AAK5E,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,4BAA4B,CAAC;IACjE,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,SAAS,EACpC,IAAI,EAAE,yBAAyB,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC,GACtE,iBAAiB,CAqCnB"}

package/lib/beta/agents/function-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"function-tool.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/function-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,6CAA0C;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,iCAA8B;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,iDAA8C;AAG5E,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,4BAA4B,CAAC;IACjE,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,SAAS,EACpC,IAAI,EAAE,yBAAyB,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC,GACtE,iBAAiB,CA+BnB"}
+{"version":3,"file":"function-tool.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/function-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,6CAA0C;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,iCAA8B;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,iDAA8C;AAK5E,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,4BAA4B,CAAC;IACjE,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,SAAS,EACpC,IAAI,EAAE,yBAAyB,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC,GACtE,iBAAiB,CAqCnB"}

package/lib/beta/agents/function-tool.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.functionTool = functionTool;
 const error_1 = require("../../../core/error.js");
 const tool_output_1 = require("./tool-output.js");
+const tool_stages_1 = require("./tool-stages.js");
 /**
  * Adapts a `zodResponsesFunction` or `standardResponsesFunction` to beta Agents.
  * Pass `definition` to `agent.tools` and register `handler` under `name` in
@@ -19,6 +20,26 @@ function functionTool(tool) {
     if (!execute || !tool.parameters) {
         throw new error_1.OpenAIError('Agents function tools require a callback and argument schema');
     }
+    const handler = async (arguments_, setStage) => {
+        setStage?.('arguments');
+        const parsed = parse(JSON.stringify(arguments_));
+        setStage?.('execution');
+        const result = await execute(parsed);
+        setStage?.('output');
+        if (Array.isArray(result)) {
+            return result.length > 0 && result.every(tool_output_1.isInputContent) ? result : JSON.stringify(result);
+        }
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Existing schema-tool callbacks return arbitrary application values; adapt them to the Agents dispatcher's output contract.
+        if (typeof result === 'object' || typeof result === 'string') {
+            return result;
+        }
+        const text = result === undefined ? 'undefined' : JSON.stringify(result);
+        if (text === undefined) {
+            throw new error_1.OpenAIError('Tool output must be JSON serializable');
+        }
+        return text;
+    };
+    Object.defineProperty(handler, tool_stages_1.toolStages, { value: true });
     return {
         name: tool.name,
         definition: {
@@ -28,21 +49,7 @@ function functionTool(tool) {
             parameters: tool.parameters,
             ...(tool.defer_loading === undefined ? {} : { defer_loading: tool.defer_loading }),
         },
-        handler: async (arguments_) => {
-            const result = await execute(parse(JSON.stringify(arguments_)));
-            if (Array.isArray(result)) {
-                return result.length > 0 && result.every(tool_output_1.isInputContent) ? result : JSON.stringify(result);
-            }
-            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Existing schema-tool callbacks return arbitrary application values; adapt them to the Agents dispatcher's output contract.
-            if (typeof result === 'object' || typeof result === 'string') {
-                return result;
-            }
-            const text = result === undefined ? 'undefined' : JSON.stringify(result);
-            if (text === undefined) {
-                throw new error_1.OpenAIError('Tool output must be JSON serializable');
-            }
-            return text;
-        },
+        handler,
     };
 }
 //# sourceMappingURL=function-tool.js.map

package/lib/beta/agents/function-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"function-tool.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/function-tool.ts"],"names":[],"mappings":";;AA0BA,oCAiCC;AA3DD,kDAAkD;AAIlD,kDAA+C;AAY/C;;;;;;;;;GASG;AACH,SAAgB,YAAY,CAC1B,IAAuE;IAEvE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7B,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,mBAAW,CAAC,8DAA8D,CAAC,CAAC;IACxF,CAAC;IACD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE;YACV,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;SACnF;QACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAY,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACzE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,4BAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC7F,CAAC;YACD,qLAAqL;YACrL,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC7D,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACzE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,mBAAW,CAAC,uCAAuC,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"function-tool.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/function-tool.ts"],"names":[],"mappings":";;AA4BA,oCAuCC;AAnED,kDAAkD;AAIlD,kDAA+C;AAC/C,kDAA2C;AAa3C;;;;;;;;;GASG;AACH,SAAgB,YAAY,CAC1B,IAAuE;IAEvE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7B,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,mBAAW,CAAC,8DAA8D,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,OAAO,GAAsB,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE;QAChE,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACjD,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC;QACxB,MAAM,MAAM,GAAY,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9C,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC;QACrB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,4BAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7F,CAAC;QACD,qLAAqL;QACrL,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7D,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACzE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,mBAAW,CAAC,uCAAuC,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,wBAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE;YACV,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;SACnF;QACD,OAAO;KACR,CAAC;AACJ,CAAC"}

package/lib/beta/agents/function-tool.mjs

@@ -1,5 +1,6 @@
 import { OpenAIError } from "../../../core/error.mjs";
 import { isInputContent } from "./tool-output.mjs";
+import { toolStages } from "./tool-stages.mjs";
 /**
  * Adapts a `zodResponsesFunction` or `standardResponsesFunction` to beta Agents.
  * Pass `definition` to `agent.tools` and register `handler` under `name` in
@@ -16,6 +17,26 @@ export function functionTool(tool) {
     if (!execute || !tool.parameters) {
         throw new OpenAIError('Agents function tools require a callback and argument schema');
     }
+    const handler = async (arguments_, setStage) => {
+        setStage?.('arguments');
+        const parsed = parse(JSON.stringify(arguments_));
+        setStage?.('execution');
+        const result = await execute(parsed);
+        setStage?.('output');
+        if (Array.isArray(result)) {
+            return result.length > 0 && result.every(isInputContent) ? result : JSON.stringify(result);
+        }
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Existing schema-tool callbacks return arbitrary application values; adapt them to the Agents dispatcher's output contract.
+        if (typeof result === 'object' || typeof result === 'string') {
+            return result;
+        }
+        const text = result === undefined ? 'undefined' : JSON.stringify(result);
+        if (text === undefined) {
+            throw new OpenAIError('Tool output must be JSON serializable');
+        }
+        return text;
+    };
+    Object.defineProperty(handler, toolStages, { value: true });
     return {
         name: tool.name,
         definition: {
@@ -25,21 +46,7 @@ export function functionTool(tool) {
             parameters: tool.parameters,
             ...(tool.defer_loading === undefined ? {} : { defer_loading: tool.defer_loading }),
         },
-        handler: async (arguments_) => {
-            const result = await execute(parse(JSON.stringify(arguments_)));
-            if (Array.isArray(result)) {
-                return result.length > 0 && result.every(isInputContent) ? result : JSON.stringify(result);
-            }
-            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Existing schema-tool callbacks return arbitrary application values; adapt them to the Agents dispatcher's output contract.
-            if (typeof result === 'object' || typeof result === 'string') {
-                return result;
-            }
-            const text = result === undefined ? 'undefined' : JSON.stringify(result);
-            if (text === undefined) {
-                throw new OpenAIError('Tool output must be JSON serializable');
-            }
-            return text;
-        },
+        handler,
     };
 }
 //# sourceMappingURL=function-tool.mjs.map

package/lib/beta/agents/function-tool.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"function-tool.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/function-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAIlD,OAAO,EAAE,cAAc,EAAE,0BAAsB;AAY/C;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAuE;IAEvE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7B,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,WAAW,CAAC,8DAA8D,CAAC,CAAC;IACxF,CAAC;IACD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE;YACV,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;SACnF;QACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAY,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACzE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC7F,CAAC;YACD,qLAAqL;YACrL,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC7D,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACzE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,WAAW,CAAC,uCAAuC,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"function-tool.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/function-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAIlD,OAAO,EAAE,cAAc,EAAE,0BAAsB;AAC/C,OAAO,EAAE,UAAU,EAAE,0BAAsB;AAa3C;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAuE;IAEvE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7B,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,WAAW,CAAC,8DAA8D,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,OAAO,GAAsB,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE;QAChE,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACjD,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC;QACxB,MAAM,MAAM,GAAY,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9C,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC;QACrB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7F,CAAC;QACD,qLAAqL;QACrL,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7D,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACzE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,WAAW,CAAC,uCAAuC,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE;YACV,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;SACnF;QACD,OAAO;KACR,CAAC;AACJ,CAAC"}

package/lib/beta/agents/parse-result.d.mts

@@ -50,9 +50,10 @@ export declare function captureAgentOutput(input: SessionCreateParams, options?:
             model?: string;
             multi_agent?: import("../../../resources/beta.mjs").MultiAgentConfigParam | null;
             reasoning?: import("../../../resources/beta.mjs").AgentReasoningParam | null;
-            service_tier?: "auto" | "default" | "flex" | "priority" | "fast" | "ultrafast" | null;
+            service_tier?: "auto" | "default" | "flex" | "priority" | "fast" | null;
             tools?: Array<import("../../../resources/beta.mjs").AgentToolParam> | null;
         };
+        toolHandlers?: never;
         stream?: false;
         environment: import("../../../resources/beta.mjs").EnvironmentParam;
         agent_id?: string;
@@ -76,9 +77,10 @@ export declare function captureAgentOutput(input: SessionCreateParams, options?:
             model?: string;
             multi_agent?: import("../../../resources/beta.mjs").MultiAgentConfigParam | null;
             reasoning?: import("../../../resources/beta.mjs").AgentReasoningParam | null;
-            service_tier?: "auto" | "default" | "flex" | "priority" | "fast" | "ultrafast" | null;
+            service_tier?: "auto" | "default" | "flex" | "priority" | "fast" | null;
             tools?: Array<import("../../../resources/beta.mjs").AgentToolParam> | null;
         };
+        toolHandlers?: Record<string, import("../../agents/agent-session-stream.mjs").AgentToolHandler>;
         stream: true;
         environment: import("../../../resources/beta.mjs").EnvironmentParam;
         agent_id?: string;

package/lib/beta/agents/parse-result.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-result.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/parse-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8CAA0C;AAExE,OAAO,KAAK,EAAE,mBAAmB,EAAE,6DAAyD;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,gCAA4B;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,kDAA8C;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,kCAA8B;AAI5E,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAuB1G;AAYD,gBAAgB;AAChB,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACzC,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAiBlC;AAuBD,gBAAgB;AAChB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;sBAzClE,CAAC;2BACZ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2EV;AAED,gBAAgB;AAChB,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB"}
+{"version":3,"file":"parse-result.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/parse-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8CAA0C;AAExE,OAAO,KAAK,EAAE,mBAAmB,EAAE,6DAAyD;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,gCAA4B;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,kDAA8C;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,kCAA8B;AAI5E,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAuB1G;AAYD,gBAAgB;AAChB,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACzC,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAiBlC;AAuBD,gBAAgB;AAChB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;sBAzClE,CAAC;2BACZ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2EV;AAED,gBAAgB;AAChB,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB"}

package/lib/beta/agents/parse-result.d.ts

@@ -50,9 +50,10 @@ export declare function captureAgentOutput(input: SessionCreateParams, options?:
             model?: string;
             multi_agent?: import("../../../resources/beta.js").MultiAgentConfigParam | null;
             reasoning?: import("../../../resources/beta.js").AgentReasoningParam | null;
-            service_tier?: "auto" | "default" | "flex" | "priority" | "fast" | "ultrafast" | null;
+            service_tier?: "auto" | "default" | "flex" | "priority" | "fast" | null;
             tools?: Array<import("../../../resources/beta.js").AgentToolParam> | null;
         };
+        toolHandlers?: never;
         stream?: false;
         environment: import("../../../resources/beta.js").EnvironmentParam;
         agent_id?: string;
@@ -76,9 +77,10 @@ export declare function captureAgentOutput(input: SessionCreateParams, options?:
             model?: string;
             multi_agent?: import("../../../resources/beta.js").MultiAgentConfigParam | null;
             reasoning?: import("../../../resources/beta.js").AgentReasoningParam | null;
-            service_tier?: "auto" | "default" | "flex" | "priority" | "fast" | "ultrafast" | null;
+            service_tier?: "auto" | "default" | "flex" | "priority" | "fast" | null;
             tools?: Array<import("../../../resources/beta.js").AgentToolParam> | null;
         };
+        toolHandlers?: Record<string, import("../../agents/agent-session-stream.js").AgentToolHandler>;
         stream: true;
         environment: import("../../../resources/beta.js").EnvironmentParam;
         agent_id?: string;

package/lib/beta/agents/parse-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-result.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/parse-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,6CAA0C;AAExE,OAAO,KAAK,EAAE,mBAAmB,EAAE,4DAAyD;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,+BAA4B;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,iDAA8C;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,iCAA8B;AAI5E,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAuB1G;AAYD,gBAAgB;AAChB,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACzC,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAiBlC;AAuBD,gBAAgB;AAChB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;sBAzClE,CAAC;2BACZ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2EV;AAED,gBAAgB;AAChB,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB"}
+{"version":3,"file":"parse-result.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/parse-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,6CAA0C;AAExE,OAAO,KAAK,EAAE,mBAAmB,EAAE,4DAAyD;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,+BAA4B;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,iDAA8C;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,iCAA8B;AAI5E,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAuB1G;AAYD,gBAAgB;AAChB,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACzC,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAiBlC;AAuBD,gBAAgB;AAChB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;sBAzClE,CAAC;2BACZ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2EV;AAED,gBAAgB;AAChB,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB"}

package/lib/beta/agents/tool-dispatcher.d.mts

@@ -0,0 +1,13 @@
+import type { RequestOptions } from "../../../internal/request-options.mjs";
+import type { AgentToolHandler, AgentSessionStreamParams } from "../../agents/agent-session-stream.mjs";
+import type { AgentFunctionCallItem } from "../../../resources/beta/agents/agents.mjs";
+import type { Sessions } from "../../../resources/beta/agents/sessions/sessions.mjs";
+/** Shared local function dispatch for creation and follow-up streams. @internal */
+export declare class AgentToolDispatcher {
+    #private;
+    constructor(sessions: Sessions, handlers: Record<string, AgentToolHandler>, controller: AbortController, options?: RequestOptions, onToolError?: AgentSessionStreamParams['onToolError']);
+    canHandle(name: string): boolean;
+    /** Capture routing and arguments before the caller can mutate the yielded event. */
+    prepare(call: AgentFunctionCallItem | undefined, sessionID: string | undefined): (() => Promise<void>) | undefined;
+}
+//# sourceMappingURL=tool-dispatcher.d.mts.map

package/lib/beta/agents/tool-dispatcher.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-dispatcher.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/tool-dispatcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,8CAA0C;AAOxE,OAAO,KAAK,EACV,gBAAgB,EAEhB,wBAAwB,EACzB,8CAA0C;AAC3C,OAAO,KAAK,EACV,qBAAqB,EAGtB,kDAA8C;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,6DAAyD;AA+BjF,mFAAmF;AACnF,qBAAa,mBAAmB;;gBAQ5B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC1C,UAAU,EAAE,eAAe,EAC3B,OAAO,CAAC,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,wBAAwB,CAAC,aAAa,CAAC;IAavD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,oFAAoF;IACpF,OAAO,CACL,IAAI,EAAE,qBAAqB,GAAG,SAAS,EACvC,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS;CA6IrC"}

package/lib/beta/agents/tool-dispatcher.d.ts

@@ -0,0 +1,13 @@
+import type { RequestOptions } from "../../../internal/request-options.js";
+import type { AgentToolHandler, AgentSessionStreamParams } from "../../agents/agent-session-stream.js";
+import type { AgentFunctionCallItem } from "../../../resources/beta/agents/agents.js";
+import type { Sessions } from "../../../resources/beta/agents/sessions/sessions.js";
+/** Shared local function dispatch for creation and follow-up streams. @internal */
+export declare class AgentToolDispatcher {
+    #private;
+    constructor(sessions: Sessions, handlers: Record<string, AgentToolHandler>, controller: AbortController, options?: RequestOptions, onToolError?: AgentSessionStreamParams['onToolError']);
+    canHandle(name: string): boolean;
+    /** Capture routing and arguments before the caller can mutate the yielded event. */
+    prepare(call: AgentFunctionCallItem | undefined, sessionID: string | undefined): (() => Promise<void>) | undefined;
+}
+//# sourceMappingURL=tool-dispatcher.d.ts.map

package/lib/beta/agents/tool-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/tool-dispatcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,6CAA0C;AAOxE,OAAO,KAAK,EACV,gBAAgB,EAEhB,wBAAwB,EACzB,6CAA0C;AAC3C,OAAO,KAAK,EACV,qBAAqB,EAGtB,iDAA8C;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,4DAAyD;AA+BjF,mFAAmF;AACnF,qBAAa,mBAAmB;;gBAQ5B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC1C,UAAU,EAAE,eAAe,EAC3B,OAAO,CAAC,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,wBAAwB,CAAC,aAAa,CAAC;IAavD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,oFAAoF;IACpF,OAAO,CACL,IAAI,EAAE,qBAAqB,GAAG,SAAS,EACvC,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS;CA6IrC"}