openai 7.24.0 → 7.26.0

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

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.functionTool = functionTool;
+const error_1 = require("../../../core/error.js");
+const tool_output_1 = require("./tool-output.js");
+/**
+ * Adapts a `zodResponsesFunction` or `standardResponsesFunction` to beta Agents.
+ * Pass `definition` to `agent.tools` and register `handler` under `name` in
+ * `sessions.stream()`'s `toolHandlers`. Creating a definition does not execute it.
+ * The existing dispatcher handles callback results, failures, and submission retries.
+ * Scalar results and business-data arrays become JSON text; `undefined` becomes
+ * the text `undefined`. Supported text/image content arrays retain their format.
+ *
+ * @throws {OpenAIError} If the tool has no callback or argument schema.
+ */
+function functionTool(tool) {
+    const execute = tool.$callback;
+    const parse = tool.$parseRaw;
+    if (!execute || !tool.parameters) {
+        throw new error_1.OpenAIError('Agents function tools require a callback and argument schema');
+    }
+    return {
+        name: tool.name,
+        definition: {
+            type: 'function',
+            name: tool.name,
+            description: tool.description ?? '',
+            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;
+        },
+    };
+}
+//# sourceMappingURL=function-tool.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,45 @@
+import { OpenAIError } from "../../../core/error.mjs";
+import { isInputContent } from "./tool-output.mjs";
+/**
+ * Adapts a `zodResponsesFunction` or `standardResponsesFunction` to beta Agents.
+ * Pass `definition` to `agent.tools` and register `handler` under `name` in
+ * `sessions.stream()`'s `toolHandlers`. Creating a definition does not execute it.
+ * The existing dispatcher handles callback results, failures, and submission retries.
+ * Scalar results and business-data arrays become JSON text; `undefined` becomes
+ * the text `undefined`. Supported text/image content arrays retain their format.
+ *
+ * @throws {OpenAIError} If the tool has no callback or argument schema.
+ */
+export function functionTool(tool) {
+    const execute = tool.$callback;
+    const parse = tool.$parseRaw;
+    if (!execute || !tool.parameters) {
+        throw new OpenAIError('Agents function tools require a callback and argument schema');
+    }
+    return {
+        name: tool.name,
+        definition: {
+            type: 'function',
+            name: tool.name,
+            description: tool.description ?? '',
+            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;
+        },
+    };
+}
+//# sourceMappingURL=function-tool.mjs.map

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

@@ -0,0 +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"}

package/lib/beta/agents/output-format-types.d.mts

@@ -0,0 +1,11 @@
+import type { TextFormatParam } from "../../../resources/beta/agents/agents.mjs";
+import type { AgentTurnResult } from "./agent-turn-result.mjs";
+import type { ParsedAgentTurnResult } from "./parsed-agent-turn-result.mjs";
+/** Beta: an Agents JSON Schema format with a local output validator. */
+export interface AgentOutputFormat<T> extends TextFormatParam.TextFormatParamJSONSchema {
+    /** SDK-only parser; omitted from serialized requests. */
+    $parseRaw: (text: string) => T;
+}
+/** Beta: raw results remain unchanged unless a typed format is supplied. */
+export type AgentResult<T> = [T] extends [never] ? AgentTurnResult : ParsedAgentTurnResult<T>;
+//# sourceMappingURL=output-format-types.d.mts.map

package/lib/beta/agents/output-format-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-types.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-format-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,kDAA8C;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,gCAA4B;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,uCAAmC;AAExE,wEAAwE;AACxE,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,yBAAyB;IACrF,yDAAyD;IACzD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC;CAChC;AAED,4EAA4E;AAC5E,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,eAAe,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC"}

package/lib/beta/agents/output-format-types.d.ts

@@ -0,0 +1,11 @@
+import type { TextFormatParam } from "../../../resources/beta/agents/agents.js";
+import type { AgentTurnResult } from "./agent-turn-result.js";
+import type { ParsedAgentTurnResult } from "./parsed-agent-turn-result.js";
+/** Beta: an Agents JSON Schema format with a local output validator. */
+export interface AgentOutputFormat<T> extends TextFormatParam.TextFormatParamJSONSchema {
+    /** SDK-only parser; omitted from serialized requests. */
+    $parseRaw: (text: string) => T;
+}
+/** Beta: raw results remain unchanged unless a typed format is supplied. */
+export type AgentResult<T> = [T] extends [never] ? AgentTurnResult : ParsedAgentTurnResult<T>;
+//# sourceMappingURL=output-format-types.d.ts.map

package/lib/beta/agents/output-format-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-types.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-format-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iDAA8C;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,+BAA4B;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,sCAAmC;AAExE,wEAAwE;AACxE,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,yBAAyB;IACrF,yDAAyD;IACzD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC;CAChC;AAED,4EAA4E;AAC5E,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,eAAe,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC"}

package/lib/beta/agents/output-format-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=output-format-types.js.map

package/lib/beta/agents/output-format-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-types.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-format-types.ts"],"names":[],"mappings":""}

package/lib/beta/agents/output-format-types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=output-format-types.mjs.map

package/lib/beta/agents/output-format-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-types.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-format-types.ts"],"names":[],"mappings":""}

package/lib/beta/agents/output-format.d.mts

@@ -0,0 +1,8 @@
+import type { AgentOutputFormat } from "./output-format-types.mjs";
+import type { JSONSchema } from "../../jsonschema.mjs";
+export type { AgentOutputFormat, AgentResult } from "./output-format-types.mjs";
+export { ParsedAgentTurnResult } from "./parsed-agent-turn-result.mjs";
+export { AgentOutputParseError } from "./output-parse-error.mjs";
+/** Beta: bind a JSON schema to its local output parser; the API validates schema support. */
+export declare function agentOutputFormat<T>(schema: JSONSchema, parse: (text: string) => T): AgentOutputFormat<T>;
+//# sourceMappingURL=output-format.d.mts.map

package/lib/beta/agents/output-format.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kCAA8B;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,6BAAyB;AAEnD,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,kCAA8B;AAE5E,OAAO,EAAE,qBAAqB,EAAE,uCAAmC;AACnE,OAAO,EAAE,qBAAqB,EAAE,iCAA6B;AAE7D,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CASzG"}

package/lib/beta/agents/output-format.d.ts

@@ -0,0 +1,8 @@
+import type { AgentOutputFormat } from "./output-format-types.js";
+import type { JSONSchema } from "../../jsonschema.js";
+export type { AgentOutputFormat, AgentResult } from "./output-format-types.js";
+export { ParsedAgentTurnResult } from "./parsed-agent-turn-result.js";
+export { AgentOutputParseError } from "./output-parse-error.js";
+/** Beta: bind a JSON schema to its local output parser; the API validates schema support. */
+export declare function agentOutputFormat<T>(schema: JSONSchema, parse: (text: string) => T): AgentOutputFormat<T>;
+//# sourceMappingURL=output-format.d.ts.map

package/lib/beta/agents/output-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iCAA8B;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,4BAAyB;AAEnD,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,iCAA8B;AAE5E,OAAO,EAAE,qBAAqB,EAAE,sCAAmC;AACnE,OAAO,EAAE,qBAAqB,EAAE,gCAA6B;AAE7D,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CASzG"}

package/lib/beta/agents/output-format.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentOutputParseError = exports.ParsedAgentTurnResult = void 0;
+exports.agentOutputFormat = agentOutputFormat;
+var parsed_agent_turn_result_1 = require("./parsed-agent-turn-result.js");
+Object.defineProperty(exports, "ParsedAgentTurnResult", { enumerable: true, get: function () { return parsed_agent_turn_result_1.ParsedAgentTurnResult; } });
+var output_parse_error_1 = require("./output-parse-error.js");
+Object.defineProperty(exports, "AgentOutputParseError", { enumerable: true, get: function () { return output_parse_error_1.AgentOutputParseError; } });
+/** Beta: bind a JSON schema to its local output parser; the API validates schema support. */
+function agentOutputFormat(schema, parse) {
+    // Keep spread-compatible parsing without exposing caller-owned serialization hooks.
+    const parser = Object.defineProperty((text) => parse(text), 'toJSON', {
+        value: () => {
+            /* Parser metadata is omitted from JSON requests. */
+        },
+    });
+    // SAFETY: The API schema type exposes JSON Schema keywords as a record; preserve the supplied schema unchanged.
+    return { type: 'json_schema', schema: schema, $parseRaw: parser };
+}
+//# sourceMappingURL=output-format.js.map

package/lib/beta/agents/output-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-format.ts"],"names":[],"mappings":";;;AAUA,8CASC;AAbD,0EAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,8DAA6D;AAApD,2HAAA,qBAAqB,OAAA;AAE9B,6FAA6F;AAC7F,SAAgB,iBAAiB,CAAI,MAAkB,EAAE,KAA0B;IACjF,oFAAoF;IACpF,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE;QAC5E,KAAK,EAAE,GAAG,EAAE;YACV,oDAAoD;QACtD,CAAC;KACF,CAAC,CAAC;IACH,gHAAgH;IAChH,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAwC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACtG,CAAC"}

package/lib/beta/agents/output-format.mjs

@@ -0,0 +1,14 @@
+export { ParsedAgentTurnResult } from "./parsed-agent-turn-result.mjs";
+export { AgentOutputParseError } from "./output-parse-error.mjs";
+/** Beta: bind a JSON schema to its local output parser; the API validates schema support. */
+export function agentOutputFormat(schema, parse) {
+    // Keep spread-compatible parsing without exposing caller-owned serialization hooks.
+    const parser = Object.defineProperty((text) => parse(text), 'toJSON', {
+        value: () => {
+            /* Parser metadata is omitted from JSON requests. */
+        },
+    });
+    // SAFETY: The API schema type exposes JSON Schema keywords as a record; preserve the supplied schema unchanged.
+    return { type: 'json_schema', schema: schema, $parseRaw: parser };
+}
+//# sourceMappingURL=output-format.mjs.map

package/lib/beta/agents/output-format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-format.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAE,uCAAmC;AACnE,OAAO,EAAE,qBAAqB,EAAE,iCAA6B;AAE7D,6FAA6F;AAC7F,MAAM,UAAU,iBAAiB,CAAI,MAAkB,EAAE,KAA0B;IACjF,oFAAoF;IACpF,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE;QAC5E,KAAK,EAAE,GAAG,EAAE;YACV,oDAAoD;QACtD,CAAC;KACF,CAAC,CAAC;IACH,gHAAgH;IAChH,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAwC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACtG,CAAC"}

package/lib/beta/agents/output-parse-error.d.mts

@@ -0,0 +1,11 @@
+import { OpenAIError } from "../../../core/error.mjs";
+import type { AgentTurnResult } from "./agent-turn-result.mjs";
+/** Beta: hosted execution completed, but local output parsing failed. */
+export declare class AgentOutputParseError extends OpenAIError {
+    #private;
+    name: string;
+    constructor(result: AgentTurnResult);
+    /** Inspect the completed output explicitly; ordinary error logging omits it. */
+    get raw_result(): AgentTurnResult;
+}
+//# sourceMappingURL=output-parse-error.d.mts.map

package/lib/beta/agents/output-parse-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-parse-error.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-parse-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,gCAA4B;AAE3D,yEAAyE;AACzE,qBAAa,qBAAsB,SAAQ,WAAW;;IAC3C,IAAI,SAA2B;gBAE5B,MAAM,EAAE,eAAe;IAInC,gFAAgF;IAChF,IAAI,UAAU,IAAI,eAAe,CAEhC;CACF"}

package/lib/beta/agents/output-parse-error.d.ts

@@ -0,0 +1,11 @@
+import { OpenAIError } from "../../../core/error.js";
+import type { AgentTurnResult } from "./agent-turn-result.js";
+/** Beta: hosted execution completed, but local output parsing failed. */
+export declare class AgentOutputParseError extends OpenAIError {
+    #private;
+    name: string;
+    constructor(result: AgentTurnResult);
+    /** Inspect the completed output explicitly; ordinary error logging omits it. */
+    get raw_result(): AgentTurnResult;
+}
+//# sourceMappingURL=output-parse-error.d.ts.map

package/lib/beta/agents/output-parse-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-parse-error.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-parse-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,+BAA4B;AAE3D,yEAAyE;AACzE,qBAAa,qBAAsB,SAAQ,WAAW;;IAC3C,IAAI,SAA2B;gBAE5B,MAAM,EAAE,eAAe;IAInC,gFAAgF;IAChF,IAAI,UAAU,IAAI,eAAe,CAEhC;CACF"}

package/lib/beta/agents/output-parse-error.js

@@ -0,0 +1,22 @@
+"use strict";
+var _AgentOutputParseError_rawResult;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentOutputParseError = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const error_1 = require("../../../core/error.js");
+/** Beta: hosted execution completed, but local output parsing failed. */
+class AgentOutputParseError extends error_1.OpenAIError {
+    constructor(result) {
+        super('The completed agent output could not be parsed');
+        this.name = 'AgentOutputParseError';
+        _AgentOutputParseError_rawResult.set(this, void 0);
+        tslib_1.__classPrivateFieldSet(this, _AgentOutputParseError_rawResult, result, "f");
+    }
+    /** Inspect the completed output explicitly; ordinary error logging omits it. */
+    get raw_result() {
+        return tslib_1.__classPrivateFieldGet(this, _AgentOutputParseError_rawResult, "f");
+    }
+}
+exports.AgentOutputParseError = AgentOutputParseError;
+_AgentOutputParseError_rawResult = new WeakMap();
+//# sourceMappingURL=output-parse-error.js.map

package/lib/beta/agents/output-parse-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-parse-error.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-parse-error.ts"],"names":[],"mappings":";;;;;AAAA,kDAAkD;AAGlD,yEAAyE;AACzE,MAAa,qBAAsB,SAAQ,mBAAW;IAGpD,YAAY,MAAuB;QACjC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAHjD,SAAI,GAAG,uBAAuB,CAAC;QAC/B,mDAA4B;QAGnC,+BAAA,IAAI,oCAAc,MAAM,MAAA,CAAC;IAC3B,CAAC;IACD,gFAAgF;IAChF,IAAI,UAAU;QACZ,OAAO,+BAAA,IAAI,wCAAW,CAAC;IACzB,CAAC;CACF;AAXD,sDAWC"}

package/lib/beta/agents/output-parse-error.mjs

@@ -0,0 +1,18 @@
+var _AgentOutputParseError_rawResult;
+import { __classPrivateFieldGet, __classPrivateFieldSet } from "../../../internal/tslib.mjs";
+import { OpenAIError } from "../../../core/error.mjs";
+/** Beta: hosted execution completed, but local output parsing failed. */
+export class AgentOutputParseError extends OpenAIError {
+    constructor(result) {
+        super('The completed agent output could not be parsed');
+        this.name = 'AgentOutputParseError';
+        _AgentOutputParseError_rawResult.set(this, void 0);
+        __classPrivateFieldSet(this, _AgentOutputParseError_rawResult, result, "f");
+    }
+    /** Inspect the completed output explicitly; ordinary error logging omits it. */
+    get raw_result() {
+        return __classPrivateFieldGet(this, _AgentOutputParseError_rawResult, "f");
+    }
+}
+_AgentOutputParseError_rawResult = new WeakMap();
+//# sourceMappingURL=output-parse-error.mjs.map

package/lib/beta/agents/output-parse-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-parse-error.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/output-parse-error.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAGlD,yEAAyE;AACzE,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IAGpD,YAAY,MAAuB;QACjC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAHjD,SAAI,GAAG,uBAAuB,CAAC;QAC/B,mDAA4B;QAGnC,uBAAA,IAAI,oCAAc,MAAM,MAAA,CAAC;IAC3B,CAAC;IACD,gFAAgF;IAChF,IAAI,UAAU;QACZ,OAAO,uBAAA,IAAI,wCAAW,CAAC;IACzB,CAAC;CACF"}

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

@@ -0,0 +1,95 @@
+import type { RequestOptions } from "../../../internal/request-options.mjs";
+import type { SessionCreateParams } from "../../../resources/beta/agents/sessions/sessions.mjs";
+import type { AgentTurnResult } from "./agent-turn-result.mjs";
+import type { TextFormatParam } from "../../../resources/beta/agents/agents.mjs";
+import type { AgentOutputFormat, AgentResult } from "./output-format-types.mjs";
+/** @internal */
+export declare function parseAgentResult<T>(result: AgentTurnResult, format?: AgentOutputFormat<T>): AgentResult<T>;
+/** @internal */
+export declare function agentFormatParser<T = unknown>(format: TextFormatParam | null | undefined): AgentOutputFormat<T> | undefined;
+/** @internal */
+export declare function captureAgentOutput(input: SessionCreateParams, options?: RequestOptions): {
+    body: SessionCreateParams;
+    options: RequestOptions | undefined;
+    format?: never;
+} | {
+    options: {
+        method?: import("../../../internal/types.mjs").HTTPMethod;
+        path?: string;
+        query?: object | undefined | null;
+        body?: unknown;
+        headers?: import("../../../internal/headers.mjs").HeadersLike;
+        maxRetries?: number;
+        stream?: boolean | undefined;
+        timeout?: number;
+        fetchOptions?: import("../../../internal/types.mjs").MergedRequestInit;
+        signal?: AbortSignal | undefined | null;
+        idempotencyKey?: string;
+        defaultBaseURL?: string | undefined;
+        __metadata?: Record<string, unknown>;
+        __security?: {
+            bearerAuth?: boolean;
+            adminAPIKeyAuth?: boolean;
+        };
+        __binaryResponse?: boolean | undefined;
+        __streamClass?: typeof import("../../../streaming.mjs").Stream;
+        __synthesizeEventData?: boolean;
+    };
+    body: {
+        agent: {
+            text: {
+                format: {
+                    type: string;
+                    schema: {
+                        [key: string]: unknown;
+                    };
+                };
+                verbosity?: "low" | "medium" | "high" | null;
+            };
+            instructions?: string | null;
+            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;
+            tools?: Array<import("../../../resources/beta.mjs").AgentToolParam> | null;
+        };
+        stream?: false;
+        environment: import("../../../resources/beta.mjs").EnvironmentParam;
+        agent_id?: string;
+        input?: string | Array<import("../../../resources/beta.mjs").AgentSessionInputMessageParam> | null;
+        metadata?: {
+            [key: string]: string;
+        } | null;
+        vault_ids?: Array<string> | null;
+    } | {
+        agent: {
+            text: {
+                format: {
+                    type: string;
+                    schema: {
+                        [key: string]: unknown;
+                    };
+                };
+                verbosity?: "low" | "medium" | "high" | null;
+            };
+            instructions?: string | null;
+            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;
+            tools?: Array<import("../../../resources/beta.mjs").AgentToolParam> | null;
+        };
+        stream: true;
+        environment: import("../../../resources/beta.mjs").EnvironmentParam;
+        agent_id?: string;
+        input?: string | Array<import("../../../resources/beta.mjs").AgentSessionInputMessageParam> | null;
+        metadata?: {
+            [key: string]: string;
+        } | null;
+        vault_ids?: Array<string> | null;
+    };
+    format: AgentOutputFormat<unknown>;
+};
+/** @internal */
+export declare function parseAgentResultPromise<T>(result: Promise<AgentTurnResult>, format?: AgentOutputFormat<T>): Promise<AgentResult<T>>;
+//# sourceMappingURL=parse-result.d.mts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,95 @@
+import type { RequestOptions } from "../../../internal/request-options.js";
+import type { SessionCreateParams } from "../../../resources/beta/agents/sessions/sessions.js";
+import type { AgentTurnResult } from "./agent-turn-result.js";
+import type { TextFormatParam } from "../../../resources/beta/agents/agents.js";
+import type { AgentOutputFormat, AgentResult } from "./output-format-types.js";
+/** @internal */
+export declare function parseAgentResult<T>(result: AgentTurnResult, format?: AgentOutputFormat<T>): AgentResult<T>;
+/** @internal */
+export declare function agentFormatParser<T = unknown>(format: TextFormatParam | null | undefined): AgentOutputFormat<T> | undefined;
+/** @internal */
+export declare function captureAgentOutput(input: SessionCreateParams, options?: RequestOptions): {
+    body: SessionCreateParams;
+    options: RequestOptions | undefined;
+    format?: never;
+} | {
+    options: {
+        method?: import("../../../internal/types.js").HTTPMethod;
+        path?: string;
+        query?: object | undefined | null;
+        body?: unknown;
+        headers?: import("../../../internal/headers.js").HeadersLike;
+        maxRetries?: number;
+        stream?: boolean | undefined;
+        timeout?: number;
+        fetchOptions?: import("../../../internal/types.js").MergedRequestInit;
+        signal?: AbortSignal | undefined | null;
+        idempotencyKey?: string;
+        defaultBaseURL?: string | undefined;
+        __metadata?: Record<string, unknown>;
+        __security?: {
+            bearerAuth?: boolean;
+            adminAPIKeyAuth?: boolean;
+        };
+        __binaryResponse?: boolean | undefined;
+        __streamClass?: typeof import("../../../streaming.js").Stream;
+        __synthesizeEventData?: boolean;
+    };
+    body: {
+        agent: {
+            text: {
+                format: {
+                    type: string;
+                    schema: {
+                        [key: string]: unknown;
+                    };
+                };
+                verbosity?: "low" | "medium" | "high" | null;
+            };
+            instructions?: string | null;
+            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;
+            tools?: Array<import("../../../resources/beta.js").AgentToolParam> | null;
+        };
+        stream?: false;
+        environment: import("../../../resources/beta.js").EnvironmentParam;
+        agent_id?: string;
+        input?: string | Array<import("../../../resources/beta.js").AgentSessionInputMessageParam> | null;
+        metadata?: {
+            [key: string]: string;
+        } | null;
+        vault_ids?: Array<string> | null;
+    } | {
+        agent: {
+            text: {
+                format: {
+                    type: string;
+                    schema: {
+                        [key: string]: unknown;
+                    };
+                };
+                verbosity?: "low" | "medium" | "high" | null;
+            };
+            instructions?: string | null;
+            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;
+            tools?: Array<import("../../../resources/beta.js").AgentToolParam> | null;
+        };
+        stream: true;
+        environment: import("../../../resources/beta.js").EnvironmentParam;
+        agent_id?: string;
+        input?: string | Array<import("../../../resources/beta.js").AgentSessionInputMessageParam> | null;
+        metadata?: {
+            [key: string]: string;
+        } | null;
+        vault_ids?: Array<string> | null;
+    };
+    format: AgentOutputFormat<unknown>;
+};
+/** @internal */
+export declare function parseAgentResultPromise<T>(result: Promise<AgentTurnResult>, format?: AgentOutputFormat<T>): Promise<AgentResult<T>>;
+//# sourceMappingURL=parse-result.d.ts.map

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

@@ -0,0 +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"}

package/lib/beta/agents/parse-result.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAgentResult = parseAgentResult;
+exports.agentFormatParser = agentFormatParser;
+exports.captureAgentOutput = captureAgentOutput;
+exports.parseAgentResultPromise = parseAgentResultPromise;
+const error_1 = require("../../../core/error.js");
+const parsed_agent_turn_result_1 = require("./parsed-agent-turn-result.js");
+const output_parse_error_1 = require("./output-parse-error.js");
+/** @internal */
+function parseAgentResult(result, format) {
+    try {
+        if (!format) {
+            // SAFETY: Absent formats use the default never/raw overload.
+            return result;
+        }
+        let first;
+        for (const message of result.messages) {
+            for (const content of message.content) {
+                if (content.type === 'output_text') {
+                    const value = format.$parseRaw(content.text);
+                    first ?? (first = { value });
+                }
+            }
+        }
+        if (!first) {
+            throw new output_parse_error_1.AgentOutputParseError(result);
+        }
+        // SAFETY: Callers preserve the format's inferred T.
+        return new parsed_agent_turn_result_1.ParsedAgentTurnResult(result, first.value);
+    }
+    catch {
+        throw new output_parse_error_1.AgentOutputParseError(result);
+    }
+}
+// Inspect only JSON-visible data fields; leave getters and inherited values to normal serialization.
+function ownJSONValue(object, key) {
+    const descriptor = object && Object.getOwnPropertyDescriptor(object, key);
+    // SAFETY: The own data descriptor corresponds to the requested property in T.
+    return descriptor?.enumerable && 'value' in descriptor ? descriptor.value : undefined;
+}
+/** @internal */
+function agentFormatParser(format) {
+    if (!format) {
+        return undefined;
+    }
+    const descriptor = Object.getOwnPropertyDescriptor(format, '$parseRaw');
+    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- An own parser data property is the explicit opt-in marker.
+    if (!descriptor || !('value' in descriptor) || typeof descriptor.value !== 'function') {
+        return undefined;
+    }
+    // SAFETY: Inspect the schema data descriptor without evaluating a caller getter; validate its discriminator below.
+    const schema = ownJSONValue(format, 'schema');
+    if (ownJSONValue(format, 'type') !== 'json_schema' || !schema) {
+        throw new error_1.OpenAIError('Typed agent formats require own enumerable type and schema data properties');
+    }
+    // SAFETY: The own descriptor was checked for a callable parser; retain its receiver and never reread the property.
+    const parse = descriptor.value;
+    return { type: 'json_schema', schema, $parseRaw: (text) => parse.call(format, text) };
+}
+// Materialize JSON-visible envelope getters once without evaluating unrelated properties.
+function snapshotJSONProperty(object, key, capture = (value) => value) {
+    const descriptor = Object.getOwnPropertyDescriptor(object, key);
+    if (!descriptor?.enumerable) {
+        return object;
+    }
+    const value = capture(object[key]);
+    if ('value' in descriptor && value === descriptor.value) {
+        return object;
+    }
+    // SAFETY: Preserve the original properties/prototype, replacing only this captured property's value.
+    return Object.create(Object.getPrototypeOf(object), {
+        ...Object.getOwnPropertyDescriptors(object),
+        [key]: { value, enumerable: true, configurable: descriptor.configurable, writable: true },
+    });
+}
+/** @internal */
+function captureAgentOutput(input, options) {
+    const body = snapshotJSONProperty(input, 'agent', (agent) => agent
+        ? snapshotJSONProperty(agent, 'text', (text) => (text ? snapshotJSONProperty(text, 'format') : text))
+        : agent);
+    const agent = ownJSONValue(body, 'agent');
+    const text = ownJSONValue(agent, 'text');
+    const format = agentFormatParser(ownJSONValue(text, 'format'));
+    if (!format) {
+        return { body, options };
+    }
+    const schema = structuredClone(format.schema);
+    for (const envelope of [body, agent, text]) {
+        if (envelope && 'toJSON' in envelope) {
+            throw new error_1.OpenAIError('Typed agent requests cannot customize body, agent, or text serialization');
+        }
+    }
+    // Snapshot options once, matching the own enumerable fields native request spreading uses.
+    const capturedOptions = { ...options };
+    if (ownJSONValue(capturedOptions, 'body') !== undefined) {
+        throw new error_1.OpenAIError('Typed agent requests cannot override the body in request options');
+    }
+    delete capturedOptions.body;
+    return {
+        options: capturedOptions,
+        body: {
+            ...body,
+            agent: {
+                ...agent,
+                text: { ...text, format: { type: 'json_schema', schema } },
+            },
+        },
+        format,
+    };
+}
+/** @internal */
+async function parseAgentResultPromise(result, format) {
+    return parseAgentResult(await result, format);
+}
+//# sourceMappingURL=parse-result.js.map