openai 7.28.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

@@ -53,6 +53,7 @@ export declare function captureAgentOutput(input: SessionCreateParams, options?:
             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;
@@ -79,6 +80,7 @@ export declare function captureAgentOutput(input: SessionCreateParams, options?:
             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

@@ -53,6 +53,7 @@ export declare function captureAgentOutput(input: SessionCreateParams, options?:
             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;
@@ -79,6 +80,7 @@ export declare function captureAgentOutput(input: SessionCreateParams, options?:
             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"}

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

@@ -0,0 +1,185 @@
+"use strict";
+var _AgentToolDispatcher_instances, _AgentToolDispatcher_handlers, _AgentToolDispatcher_options, _AgentToolDispatcher_sessions, _AgentToolDispatcher_controller, _AgentToolDispatcher_onToolError, _AgentToolDispatcher_result, _AgentToolDispatcher_checkAbort, _AgentToolDispatcher_abortError, _AgentToolDispatcher_wait, _AgentToolDispatcher_submit;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentToolDispatcher = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const error_1 = require("../../../core/error.js");
+const headers_1 = require("../../../internal/headers.js");
+const uuid_1 = require("../../../internal/utils/uuid.js");
+const values_1 = require("../../../internal/utils/values.js");
+const tool_output_1 = require("./tool-output.js");
+const tool_stages_1 = require("./tool-stages.js");
+function normalizedOutput(value) {
+    if (value === null) {
+        return null;
+    }
+    if (typeof value === 'string' || (Array.isArray(value) && value.every(tool_output_1.isInputContent))) {
+        return value;
+    }
+    throw new error_1.OpenAIError('Tool output must be text, content, a JSON object, or null');
+}
+// oxlint-disable-next-line anti-slop/no-object-parameters -- The public AgentToolOutput contract accepts arbitrary JSON-serializable object results.
+function toolResult(call, value) {
+    const output = (0, values_1.isObj)(value) ? JSON.stringify(value) : value;
+    // Detect unserializable callback results inside the redacted failure boundary.
+    const serialized = JSON.stringify(output);
+    if (serialized === undefined) {
+        throw new error_1.OpenAIError('Tool output must be JSON serializable');
+    }
+    return {
+        type: 'agent.session.input.tool_result',
+        turn_id: call.turn_id,
+        call_id: call.call_id,
+        success: true,
+        output: normalizedOutput(typeof output === 'string' ? output : JSON.parse(serialized)),
+    };
+}
+/** Shared local function dispatch for creation and follow-up streams. @internal */
+class AgentToolDispatcher {
+    constructor(sessions, handlers, controller, options, onToolError) {
+        _AgentToolDispatcher_instances.add(this);
+        _AgentToolDispatcher_handlers.set(this, void 0);
+        _AgentToolDispatcher_options.set(this, void 0);
+        _AgentToolDispatcher_sessions.set(this, void 0);
+        _AgentToolDispatcher_controller.set(this, void 0);
+        _AgentToolDispatcher_onToolError.set(this, void 0);
+        tslib_1.__classPrivateFieldSet(this, _AgentToolDispatcher_sessions, sessions, "f");
+        tslib_1.__classPrivateFieldSet(this, _AgentToolDispatcher_controller, controller, "f");
+        tslib_1.__classPrivateFieldSet(this, _AgentToolDispatcher_onToolError, onToolError, "f");
+        tslib_1.__classPrivateFieldSet(this, _AgentToolDispatcher_handlers, new Map(Object.entries(handlers)), "f");
+        const headers = (0, headers_1.buildHeaders)([options?.headers]);
+        headers.values.delete('idempotency-key');
+        headers.nulls.delete('idempotency-key');
+        const { idempotencyKey: _key, ...rest } = options ?? {};
+        tslib_1.__classPrivateFieldSet(this, _AgentToolDispatcher_options, { ...rest, headers, signal: controller.signal }, "f");
+    }
+    canHandle(name) {
+        return typeof tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_handlers, "f").get(name) === 'function';
+    }
+    /** Capture routing and arguments before the caller can mutate the yielded event. */
+    prepare(call, sessionID) {
+        const handler = call && tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_handlers, "f").get(call.name);
+        if (!call || typeof handler !== 'function') {
+            return;
+        }
+        if (!sessionID) {
+            throw new error_1.OpenAIError('Tool call received before the session creation event');
+        }
+        const snapshot = structuredClone(call);
+        return async () => {
+            tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+            const result = await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_result).call(this, snapshot, handler, sessionID);
+            tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+            await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_submit).call(this, sessionID, result);
+        };
+    }
+}
+exports.AgentToolDispatcher = AgentToolDispatcher;
+_AgentToolDispatcher_handlers = new WeakMap(), _AgentToolDispatcher_options = new WeakMap(), _AgentToolDispatcher_sessions = new WeakMap(), _AgentToolDispatcher_controller = new WeakMap(), _AgentToolDispatcher_onToolError = new WeakMap(), _AgentToolDispatcher_instances = new WeakSet(), _AgentToolDispatcher_result = async function _AgentToolDispatcher_result(call, handler, sessionID) {
+    let stage = 'arguments';
+    try {
+        const args = typeof call.arguments === 'string' ? JSON.parse(call.arguments) : call.arguments;
+        if (!(0, values_1.isObj)(args)) {
+            throw new error_1.OpenAIError('Function arguments must be a JSON object');
+        }
+        stage = 'execution';
+        // SAFETY: Arguments were parsed as JSON and checked to be a non-null non-array object before invoking the handler.
+        const arguments_ = args;
+        const output = await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_wait).call(this, () => tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_onToolError, "f") && handler[tool_stages_1.toolStages]
+            ? handler(arguments_, (value) => {
+                stage = value;
+            })
+            : handler(arguments_));
+        stage = 'output';
+        return toolResult(call, output);
+    }
+    catch (error) {
+        tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+        if (tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_onToolError, "f")) {
+            const failure = Object.freeze({
+                error,
+                stage,
+                tool_name: call.name,
+                session_id: sessionID,
+                turn_id: call.turn_id,
+                call_id: call.call_id,
+            });
+            try {
+                await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_wait).call(this, () => tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_onToolError, "f")?.call(this, failure));
+            }
+            catch {
+                // Observers must not prevent the original sanitized tool failure from being submitted.
+                tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+            }
+        }
+        return {
+            type: 'agent.session.input.tool_result',
+            turn_id: call.turn_id,
+            call_id: call.call_id,
+            success: false,
+            error: 'Tool handler failed.',
+        };
+    }
+}, _AgentToolDispatcher_checkAbort = function _AgentToolDispatcher_checkAbort() {
+    if (tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.aborted) {
+        throw tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_abortError).call(this);
+    }
+}, _AgentToolDispatcher_abortError = function _AgentToolDispatcher_abortError() {
+    const error = new error_1.APIUserAbortError();
+    Object.defineProperty(error, 'cause', {
+        value: tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.reason,
+        writable: true,
+        configurable: true,
+    });
+    return error;
+}, _AgentToolDispatcher_wait = async function _AgentToolDispatcher_wait(action) {
+    let onAbort;
+    // oxlint-disable-next-line promise/avoid-new -- Bridge the caller's AbortSignal while a handler or registration delay is pending.
+    const aborted = new Promise((_resolve, reject) => {
+        onAbort = () => reject(tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_abortError).call(this));
+        tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.addEventListener('abort', onAbort, { once: true });
+    });
+    try {
+        tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+        // Capture synchronous throws before racing cancellation, so both promises
+        // always have rejection handlers even if the callback aborts and throws.
+        const invoke = async () => await action();
+        return await Promise.race([invoke(), aborted]);
+    }
+    finally {
+        if (onAbort) {
+            tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_controller, "f").signal.removeEventListener('abort', onAbort);
+        }
+    }
+}, _AgentToolDispatcher_submit = async function _AgentToolDispatcher_submit(sessionID, result, key = (0, uuid_1.uuid4)(), attempt = 0) {
+    tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_checkAbort).call(this);
+    try {
+        await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_sessions, "f").events.create(sessionID, { events: [result], 'Idempotency-Key': key }, tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_options, "f"));
+    }
+    catch (error) {
+        const delay = [100, 300, 600][attempt];
+        if (delay === undefined ||
+            !(error instanceof error_1.BadRequestError) ||
+            error.code !== 'invalid_request_error' ||
+            !error.error ||
+            !('message' in error.error) ||
+            error.error.message !== `Unknown pending tool call: ${result.call_id}`) {
+            throw error;
+        }
+        let timer;
+        try {
+            await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_wait).call(this, () => 
+            // oxlint-disable-next-line promise/avoid-new -- Own the registration timer so cancellation clears it promptly.
+            new Promise((resolve) => {
+                timer = setTimeout(resolve, delay);
+            }));
+        }
+        finally {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+        }
+        await tslib_1.__classPrivateFieldGet(this, _AgentToolDispatcher_instances, "m", _AgentToolDispatcher_submit).call(this, sessionID, result, key, attempt + 1);
+    }
+};
+//# sourceMappingURL=tool-dispatcher.js.map