openai 7.25.0 → 7.27.0

package/lib/beta/agents/files.mjs

@@ -0,0 +1,86 @@
+import { OpenAIError } from "../../../core/error.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+/** Beta: uploaded file IDs remain available after partial preparation or staging failure. */
+export class AgentFileUploadError extends OpenAIError {
+    constructor(uploadedFiles, cause) {
+        super('Agent file preparation or staging failed; uploaded files remain caller-owned.');
+        this.name = 'AgentFileUploadError';
+        this.uploadedFiles = uploadedFiles;
+        Object.defineProperty(this, 'cause', { value: cause, configurable: true });
+    }
+}
+/** @internal */
+export function validateAgentFilePath(path) {
+    const parts = path.split('/');
+    const root = parts[2] ?? '';
+    if (!path.startsWith('/workspace/') ||
+        path.includes('\\') ||
+        path.includes('\0') ||
+        parts.slice(1).some((part) => part === '' || part === '.' || part === '..') ||
+        root === '.codex' ||
+        root === '.managed-agents' ||
+        root.startsWith('.managed-agents-') ||
+        path === '/workspace/outputs') {
+        throw new OpenAIError('Agent files require a non-reserved absolute file path inside /workspace');
+    }
+}
+function preflight(files, options) {
+    const entries = Object.entries(files);
+    const headers = buildHeaders([options.headers]);
+    if (entries.length > 1 &&
+        (headers.values.has('idempotency-key') ||
+            (!headers.nulls.has('idempotency-key') && options?.idempotencyKey !== undefined))) {
+        throw new OpenAIError('Do not reuse an Idempotency-Key across multiple file uploads');
+    }
+    const paths = new Set(entries.map(([path]) => path));
+    for (const [path] of entries) {
+        validateAgentFilePath(path);
+        for (let slash = path.lastIndexOf('/'); slash > 0; slash = path.lastIndexOf('/', slash - 1)) {
+            if (paths.has(path.slice(0, slash))) {
+                throw new OpenAIError('Agent file destinations conflict');
+            }
+        }
+    }
+    return entries;
+}
+/** @internal */
+export async function prepareAgentFiles(client, files, options) {
+    const requestOptions = { ...options };
+    // Internal SDK read: capture effective headers once, including defaults and explicit omissions.
+    const headers = buildHeaders([client['_options'].defaultHeaders, requestOptions.headers]);
+    requestOptions.headers = headers;
+    const entries = preflight(files, requestOptions);
+    if (entries.length > 1) {
+        // Keep a later mutation of client defaults from adding one key to this entire batch.
+        headers.nulls.add('idempotency-key');
+    }
+    const prepared = { files: [], uploadedFiles: [] };
+    try {
+        for (const [path, file] of entries) {
+            // oxlint-disable-next-line no-await-in-loop -- Stop on the first failure and expose precisely the uploads already created.
+            const uploaded = await client.files.create({ file, purpose: 'user_data' }, requestOptions);
+            prepared.uploadedFiles.push(uploaded);
+            prepared.files.push({ type: 'file_id', file_id: uploaded.id, path });
+        }
+        return prepared;
+    }
+    catch (error) {
+        throw new AgentFileUploadError(prepared.uploadedFiles, error);
+    }
+}
+/** @internal */
+export async function uploadAgentFile(client, resource, environmentID, params, options) {
+    const prepared = await prepareAgentFiles(client, { [params.path]: params.file }, options);
+    const [reference] = prepared.files;
+    const [uploadedFile] = prepared.uploadedFiles;
+    if (!reference || !uploadedFile) {
+        throw new OpenAIError('Missing prepared agent file');
+    }
+    try {
+        return { uploadedFile, environmentFile: await resource.create(environmentID, reference, options) };
+    }
+    catch (error) {
+        throw new AgentFileUploadError(prepared.uploadedFiles, error);
+    }
+}
+//# sourceMappingURL=files.mjs.map

package/lib/beta/agents/files.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/files.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,27 @@
+import type { AgentToolHandler } from "../../agents/agent-session-stream.mjs";
+import type { AutoParseableResponseTool } from "../../ResponsesParser.mjs";
+import type { AgentToolParam } from "../../../resources/beta/agents/agents.mjs";
+/** A beta Agents function definition paired with its local, validating handler. */
+export interface AgentFunctionTool {
+    /** Model-visible function name, also used as the key in `toolHandlers`. */
+    readonly name: string;
+    /** Hosted configuration for `agent.tools`; contains no local callback or parser. */
+    readonly definition: AgentToolParam.AgentToolConfigParamFunction;
+    /** Validates arguments before invoking the callback through the existing stream dispatcher. */
+    readonly handler: AgentToolHandler;
+}
+/**
+ * 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 declare function functionTool<Arguments>(tool: AutoParseableResponseTool<{
+    name: string;
+    arguments: Arguments;
+}>): AgentFunctionTool;
+//# sourceMappingURL=function-tool.d.mts.map

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

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

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

@@ -0,0 +1,27 @@
+import type { AgentToolHandler } from "../../agents/agent-session-stream.js";
+import type { AutoParseableResponseTool } from "../../ResponsesParser.js";
+import type { AgentToolParam } from "../../../resources/beta/agents/agents.js";
+/** A beta Agents function definition paired with its local, validating handler. */
+export interface AgentFunctionTool {
+    /** Model-visible function name, also used as the key in `toolHandlers`. */
+    readonly name: string;
+    /** Hosted configuration for `agent.tools`; contains no local callback or parser. */
+    readonly definition: AgentToolParam.AgentToolConfigParamFunction;
+    /** Validates arguments before invoking the callback through the existing stream dispatcher. */
+    readonly handler: AgentToolHandler;
+}
+/**
+ * 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 declare function functionTool<Arguments>(tool: AutoParseableResponseTool<{
+    name: string;
+    arguments: Arguments;
+}>): AgentFunctionTool;
+//# sourceMappingURL=function-tool.d.ts.map

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

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

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/pages.d.mts

@@ -0,0 +1,9 @@
+import type { CursorPage } from "../../../core/pagination.mjs";
+/** Retain server cursor metadata for legacy Agents items with nullable IDs.
+ * @internal
+ * @yields {T} Each item in server order, failing if pagination cannot advance.
+ */
+export declare function agentItems<T extends {
+    id?: string | null;
+}>(load: (after: string | undefined) => PromiseLike<CursorPage<T>>): AsyncGenerator<T, void, undefined>;
+//# sourceMappingURL=pages.d.mts.map

package/lib/beta/agents/pages.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/pages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,qCAAiC;AAG3D;;;GAGG;AACH,wBAAuB,UAAU,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAChE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAC9D,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAqBpC"}

package/lib/beta/agents/pages.d.ts

@@ -0,0 +1,9 @@
+import type { CursorPage } from "../../../core/pagination.js";
+/** Retain server cursor metadata for legacy Agents items with nullable IDs.
+ * @internal
+ * @yields {T} Each item in server order, failing if pagination cannot advance.
+ */
+export declare function agentItems<T extends {
+    id?: string | null;
+}>(load: (after: string | undefined) => PromiseLike<CursorPage<T>>): AsyncGenerator<T, void, undefined>;
+//# sourceMappingURL=pages.d.ts.map

package/lib/beta/agents/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/pages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,oCAAiC;AAG3D;;;GAGG;AACH,wBAAuB,UAAU,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAChE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAC9D,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAqBpC"}

package/lib/beta/agents/pages.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentItems = agentItems;
+const error_1 = require("../../../core/error.js");
+const values_1 = require("../../../internal/utils/values.js");
+/** Retain server cursor metadata for legacy Agents items with nullable IDs.
+ * @internal
+ * @yields {T} Each item in server order, failing if pagination cannot advance.
+ */
+async function* agentItems(load) {
+    let after;
+    while (true) {
+        // oxlint-disable-next-line no-await-in-loop -- Each page determines the next cursor.
+        const page = await load(after);
+        yield* page.data;
+        if (!page.has_more) {
+            return;
+        }
+        // Internal SDK read: CursorPage keeps raw metadata but does not expose last_id.
+        // oxlint-disable-next-line prefer-destructuring -- Bracket access intentionally reads a protected internal field.
+        const body = page['body'];
+        // oxlint-disable-next-line unicorn/prefer-at -- Keep published source compatible with ES2020 declarations.
+        const last = page.data[page.data.length - 1];
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Validate only the opaque cursor from response metadata.
+        const cursor = (0, values_1.isObj)(body) && typeof body['last_id'] === 'string' ? body['last_id'] : last?.id;
+        if (!cursor || cursor === after) {
+            throw new error_1.OpenAIError('Agent pagination cannot advance to the next page');
+        }
+        after = cursor;
+    }
+}
+//# sourceMappingURL=pages.js.map

package/lib/beta/agents/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/pages.ts"],"names":[],"mappings":";;AAQA,gCAuBC;AA/BD,kDAAkD;AAElD,8DAAuD;AAEvD;;;GAGG;AACI,KAAK,SAAS,CAAC,CAAC,UAAU,CAC/B,IAA+D;IAE/D,IAAI,KAAyB,CAAC;IAC9B,OAAO,IAAI,EAAE,CAAC;QACZ,qFAAqF;QACrF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,gFAAgF;QAChF,kHAAkH;QAClH,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,2GAA2G;QAC3G,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,kHAAkH;QAClH,MAAM,MAAM,GAAG,IAAA,cAAK,EAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/F,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,mBAAW,CAAC,kDAAkD,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;AACH,CAAC"}

package/lib/beta/agents/pages.mjs

@@ -0,0 +1,29 @@
+import { OpenAIError } from "../../../core/error.mjs";
+import { isObj } from "../../../internal/utils/values.mjs";
+/** Retain server cursor metadata for legacy Agents items with nullable IDs.
+ * @internal
+ * @yields {T} Each item in server order, failing if pagination cannot advance.
+ */
+export async function* agentItems(load) {
+    let after;
+    while (true) {
+        // oxlint-disable-next-line no-await-in-loop -- Each page determines the next cursor.
+        const page = await load(after);
+        yield* page.data;
+        if (!page.has_more) {
+            return;
+        }
+        // Internal SDK read: CursorPage keeps raw metadata but does not expose last_id.
+        // oxlint-disable-next-line prefer-destructuring -- Bracket access intentionally reads a protected internal field.
+        const body = page['body'];
+        // oxlint-disable-next-line unicorn/prefer-at -- Keep published source compatible with ES2020 declarations.
+        const last = page.data[page.data.length - 1];
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Validate only the opaque cursor from response metadata.
+        const cursor = isObj(body) && typeof body['last_id'] === 'string' ? body['last_id'] : last?.id;
+        if (!cursor || cursor === after) {
+            throw new OpenAIError('Agent pagination cannot advance to the next page');
+        }
+        after = cursor;
+    }
+}
+//# sourceMappingURL=pages.mjs.map

package/lib/beta/agents/pages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/pages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,EAAE,KAAK,EAAE,2CAAuC;AAEvD;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,UAAU,CAC/B,IAA+D;IAE/D,IAAI,KAAyB,CAAC;IAC9B,OAAO,IAAI,EAAE,CAAC;QACZ,qFAAqF;QACrF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,gFAAgF;QAChF,kHAAkH;QAClH,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,2GAA2G;QAC3G,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,kHAAkH;QAClH,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/F,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,WAAW,CAAC,kDAAkD,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;AACH,CAAC"}