openai 7.25.0 → 7.27.0

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

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

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

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

@@ -0,0 +1,110 @@
+import { OpenAIError } from "../../../core/error.mjs";
+import { ParsedAgentTurnResult } from "./parsed-agent-turn-result.mjs";
+import { AgentOutputParseError } from "./output-parse-error.mjs";
+/** @internal */
+export 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 AgentOutputParseError(result);
+        }
+        // SAFETY: Callers preserve the format's inferred T.
+        return new ParsedAgentTurnResult(result, first.value);
+    }
+    catch {
+        throw new 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 */
+export 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 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 */
+export 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 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 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 */
+export async function parseAgentResultPromise(result, format) {
+    return parseAgentResult(await result, format);
+}
+//# sourceMappingURL=parse-result.mjs.map

package/lib/beta/agents/parse-result.mjs.map

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

package/lib/beta/agents/parsed-agent-turn-result.d.mts

@@ -0,0 +1,8 @@
+import { AgentTurnResult } from "./agent-turn-result.mjs";
+/** Beta: a completed hosted turn whose output passed the local parser. */
+export declare class ParsedAgentTurnResult<T> extends AgentTurnResult {
+    readonly output_parsed: T;
+    readonly raw_result: AgentTurnResult;
+    constructor(result: AgentTurnResult, parsed: T);
+}
+//# sourceMappingURL=parsed-agent-turn-result.d.mts.map

package/lib/beta/agents/parsed-agent-turn-result.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsed-agent-turn-result.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/parsed-agent-turn-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gCAA4B;AAEtD,0EAA0E;AAC1E,qBAAa,qBAAqB,CAAC,CAAC,CAAE,SAAQ,eAAe;IAC3D,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;gBACzB,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;CAK/C"}

package/lib/beta/agents/parsed-agent-turn-result.d.ts

@@ -0,0 +1,8 @@
+import { AgentTurnResult } from "./agent-turn-result.js";
+/** Beta: a completed hosted turn whose output passed the local parser. */
+export declare class ParsedAgentTurnResult<T> extends AgentTurnResult {
+    readonly output_parsed: T;
+    readonly raw_result: AgentTurnResult;
+    constructor(result: AgentTurnResult, parsed: T);
+}
+//# sourceMappingURL=parsed-agent-turn-result.d.ts.map

package/lib/beta/agents/parsed-agent-turn-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsed-agent-turn-result.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/parsed-agent-turn-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,+BAA4B;AAEtD,0EAA0E;AAC1E,qBAAa,qBAAqB,CAAC,CAAC,CAAE,SAAQ,eAAe;IAC3D,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;gBACzB,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;CAK/C"}

package/lib/beta/agents/parsed-agent-turn-result.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParsedAgentTurnResult = void 0;
+const agent_turn_result_1 = require("./agent-turn-result.js");
+/** Beta: a completed hosted turn whose output passed the local parser. */
+class ParsedAgentTurnResult extends agent_turn_result_1.AgentTurnResult {
+    constructor(result, parsed) {
+        super(result.turn, result.messages);
+        this.raw_result = result;
+        this.output_parsed = parsed;
+    }
+}
+exports.ParsedAgentTurnResult = ParsedAgentTurnResult;
+//# sourceMappingURL=parsed-agent-turn-result.js.map

package/lib/beta/agents/parsed-agent-turn-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsed-agent-turn-result.js","sourceRoot":"","sources":["../../../src/lib/beta/agents/parsed-agent-turn-result.ts"],"names":[],"mappings":";;;AAAA,8DAAsD;AAEtD,0EAA0E;AAC1E,MAAa,qBAAyB,SAAQ,mCAAe;IAG3D,YAAY,MAAuB,EAAE,MAAS;QAC5C,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;IAC9B,CAAC;CACF;AARD,sDAQC"}

package/lib/beta/agents/parsed-agent-turn-result.mjs

@@ -0,0 +1,10 @@
+import { AgentTurnResult } from "./agent-turn-result.mjs";
+/** Beta: a completed hosted turn whose output passed the local parser. */
+export class ParsedAgentTurnResult extends AgentTurnResult {
+    constructor(result, parsed) {
+        super(result.turn, result.messages);
+        this.raw_result = result;
+        this.output_parsed = parsed;
+    }
+}
+//# sourceMappingURL=parsed-agent-turn-result.mjs.map

package/lib/beta/agents/parsed-agent-turn-result.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsed-agent-turn-result.mjs","sourceRoot":"","sources":["../../../src/lib/beta/agents/parsed-agent-turn-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gCAA4B;AAEtD,0EAA0E;AAC1E,MAAM,OAAO,qBAAyB,SAAQ,eAAe;IAG3D,YAAY,MAAuB,EAAE,MAAS;QAC5C,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;IAC9B,CAAC;CACF"}

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

@@ -0,0 +1,19 @@
+import type { WritableStream } from "../../../internal/shim-types.mjs";
+import type { RequestOptions } from "../../../internal/request-options.mjs";
+import type { Artifacts, SessionArtifact } from "../../../resources/beta/agents/sessions/artifacts.mjs";
+import type { AgentTurnResult } from "./agent-turn-result.mjs";
+/** Beta: artifacts from the exact session and turn represented by a result. */
+export declare class AgentResultArtifacts {
+    #private;
+    constructor(resource: Artifacts, result: AgentTurnResult);
+    /** Find one immutable artifact by its exact hosted path, across all pages. */
+    retrieve(path: string, options?: RequestOptions): Promise<SessionArtifact>;
+    /** Return the native binary response for this result's exact artifact path. */
+    content(path: string, options?: RequestOptions): Promise<Response>;
+    /** Stream bytes to a caller-chosen destination; the hosted path never selects a local path. */
+    download(params: {
+        path: string;
+        to: WritableStream<Uint8Array>;
+    }, options?: RequestOptions): Promise<SessionArtifact>;
+}
+//# sourceMappingURL=result-artifacts.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result-artifacts.d.mts","sourceRoot":"","sources":["../../../src/lib/beta/agents/result-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,yCAAqC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,8CAA0C;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,8DAA0D;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,gCAA4B;AAE3D,+EAA+E;AAC/E,qBAAa,oBAAoB;;gBAInB,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe;IAMxD,8EAA8E;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BhF,+EAA+E;IACzE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKxE,+FAA+F;IACzF,QAAQ,CACZ,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;KAAE,EACxD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,eAAe,CAAC;CAoB5B"}

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

@@ -0,0 +1,19 @@
+import type { WritableStream } from "../../../internal/shim-types.js";
+import type { RequestOptions } from "../../../internal/request-options.js";
+import type { Artifacts, SessionArtifact } from "../../../resources/beta/agents/sessions/artifacts.js";
+import type { AgentTurnResult } from "./agent-turn-result.js";
+/** Beta: artifacts from the exact session and turn represented by a result. */
+export declare class AgentResultArtifacts {
+    #private;
+    constructor(resource: Artifacts, result: AgentTurnResult);
+    /** Find one immutable artifact by its exact hosted path, across all pages. */
+    retrieve(path: string, options?: RequestOptions): Promise<SessionArtifact>;
+    /** Return the native binary response for this result's exact artifact path. */
+    content(path: string, options?: RequestOptions): Promise<Response>;
+    /** Stream bytes to a caller-chosen destination; the hosted path never selects a local path. */
+    download(params: {
+        path: string;
+        to: WritableStream<Uint8Array>;
+    }, options?: RequestOptions): Promise<SessionArtifact>;
+}
+//# sourceMappingURL=result-artifacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result-artifacts.d.ts","sourceRoot":"","sources":["../../../src/lib/beta/agents/result-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,wCAAqC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,6CAA0C;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,6DAA0D;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,+BAA4B;AAE3D,+EAA+E;AAC/E,qBAAa,oBAAoB;;gBAInB,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe;IAMxD,8EAA8E;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BhF,+EAA+E;IACzE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKxE,+FAA+F;IACzF,QAAQ,CACZ,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;KAAE,EACxD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,eAAe,CAAC;CAoB5B"}

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

@@ -0,0 +1,67 @@
+"use strict";
+var _AgentResultArtifacts_resource, _AgentResultArtifacts_sessionID, _AgentResultArtifacts_turnID;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentResultArtifacts = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const pages_1 = require("./pages.js");
+const error_1 = require("../../../core/error.js");
+/** Beta: artifacts from the exact session and turn represented by a result. */
+class AgentResultArtifacts {
+    constructor(resource, result) {
+        _AgentResultArtifacts_resource.set(this, void 0);
+        _AgentResultArtifacts_sessionID.set(this, void 0);
+        _AgentResultArtifacts_turnID.set(this, void 0);
+        tslib_1.__classPrivateFieldSet(this, _AgentResultArtifacts_resource, resource, "f");
+        tslib_1.__classPrivateFieldSet(this, _AgentResultArtifacts_sessionID, result.session_id, "f");
+        tslib_1.__classPrivateFieldSet(this, _AgentResultArtifacts_turnID, result.turn_id, "f");
+    }
+    /** Find one immutable artifact by its exact hosted path, across all pages. */
+    async retrieve(path, options) {
+        let selected;
+        for await (const artifact of (0, pages_1.agentItems)((after) => tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_resource, "f").list(tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f"), {}, { ...options, query: { ...options?.query, after, environment_id: undefined } }))) {
+            if (artifact.session_id === tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f") &&
+                artifact.turn_id === tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_turnID, "f") &&
+                artifact.path === path) {
+                if (selected) {
+                    throw new error_1.OpenAIError('Multiple artifacts match this result and path');
+                }
+                selected = artifact;
+            }
+        }
+        if (!selected) {
+            throw new error_1.OpenAIError('No artifact matches this result and path');
+        }
+        return selected;
+    }
+    /** Return the native binary response for this result's exact artifact path. */
+    async content(path, options) {
+        const artifact = await this.retrieve(path, options);
+        return tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_resource, "f").content(artifact.id, { session_id: tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f") }, options);
+    }
+    /** Stream bytes to a caller-chosen destination; the hosted path never selects a local path. */
+    async download(params, options) {
+        const { path, to } = params;
+        const artifact = await this.retrieve(path, options);
+        const response = await tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_resource, "f").content(artifact.id, { session_id: tslib_1.__classPrivateFieldGet(this, _AgentResultArtifacts_sessionID, "f") }, options);
+        if (!response.body) {
+            throw new error_1.OpenAIError('Artifact response has no content stream');
+        }
+        try {
+            await response.body.pipeTo(to, options?.signal ? { signal: options.signal } : {});
+        }
+        catch (error) {
+            // pipeTo can reject before acquiring a reader, for example when the destination is locked.
+            try {
+                await response.body.cancel();
+            }
+            catch {
+                /* already cancelled or owned by pipeTo */
+            }
+            throw error;
+        }
+        return artifact;
+    }
+}
+exports.AgentResultArtifacts = AgentResultArtifacts;
+_AgentResultArtifacts_resource = new WeakMap(), _AgentResultArtifacts_sessionID = new WeakMap(), _AgentResultArtifacts_turnID = new WeakMap();
+//# sourceMappingURL=result-artifacts.js.map

package/lib/beta/agents/result-artifacts.js.map

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