@openai/agents-openai 0.13.0 → 0.13.2

package/dist/experimental/hostedMultiAgent/config.d.ts

@@ -0,0 +1,7 @@
+export type HostedMultiAgentConfig = Readonly<{
+    /**
+     * Maximum number of hosted subagents that may be active at once.
+     * Omit this value to use the service default.
+     */
+    maxConcurrentSubagents?: number;
+}>;

package/dist/experimental/hostedMultiAgent/config.js

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

package/dist/experimental/hostedMultiAgent/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/experimental/hostedMultiAgent/config.ts"],"names":[],"mappings":""}

package/dist/experimental/hostedMultiAgent/config.mjs

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

package/dist/experimental/hostedMultiAgent/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","sourceRoot":"","sources":["../../../src/experimental/hostedMultiAgent/config.ts"],"names":[],"mappings":""}

package/dist/experimental/hostedMultiAgent/index.d.ts

@@ -0,0 +1,3 @@
+export type { HostedMultiAgentConfig } from './config';
+export { getHostedAgentMetadata, type HostedAgentMetadata } from './metadata';
+export { OpenAIHostedMultiAgentModel } from './model';

package/dist/experimental/hostedMultiAgent/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIHostedMultiAgentModel = exports.getHostedAgentMetadata = void 0;
+var metadata_1 = require("./metadata.js");
+Object.defineProperty(exports, "getHostedAgentMetadata", { enumerable: true, get: function () { return metadata_1.getHostedAgentMetadata; } });
+var model_1 = require("./model.js");
+Object.defineProperty(exports, "OpenAIHostedMultiAgentModel", { enumerable: true, get: function () { return model_1.OpenAIHostedMultiAgentModel; } });
+//# sourceMappingURL=index.js.map

package/dist/experimental/hostedMultiAgent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/experimental/hostedMultiAgent/index.ts"],"names":[],"mappings":";;;AACA,0CAA8E;AAArE,kHAAA,sBAAsB,OAAA;AAC/B,oCAAsD;AAA7C,oHAAA,2BAA2B,OAAA"}

package/dist/experimental/hostedMultiAgent/index.mjs

@@ -0,0 +1,3 @@
+export { getHostedAgentMetadata } from "./metadata.mjs";
+export { OpenAIHostedMultiAgentModel } from "./model.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/experimental/hostedMultiAgent/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/experimental/hostedMultiAgent/index.ts"],"names":[],"mappings":"OACO,EAAE,sBAAsB,EAA4B;OACpD,EAAE,2BAA2B,EAAE"}

package/dist/experimental/hostedMultiAgent/metadata.d.ts

@@ -0,0 +1,8 @@
+export type HostedAgentMetadata = Readonly<{
+    agentName: string;
+    phase?: string;
+}>;
+/**
+ * Reads hosted-agent attribution without affecting local tool routing.
+ */
+export declare function getHostedAgentMetadata(value: unknown): HostedAgentMetadata | undefined;

package/dist/experimental/hostedMultiAgent/metadata.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHostedAgentMetadata = getHostedAgentMetadata;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function unwrapHostedValue(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    if (isRecord(value.toolCall)) {
+        return unwrapHostedValue(value.toolCall);
+    }
+    if (isRecord(value.providerData) && isRecord(value.providerData.agent)) {
+        return value.providerData;
+    }
+    return value;
+}
+/**
+ * Reads hosted-agent attribution without affecting local tool routing.
+ */
+function getHostedAgentMetadata(value) {
+    const item = unwrapHostedValue(value);
+    if (!item || !isRecord(item.agent)) {
+        return undefined;
+    }
+    const agentName = item.agent.agent_name;
+    if (typeof agentName !== 'string' || agentName.length === 0) {
+        return undefined;
+    }
+    return {
+        agentName,
+        ...(typeof item.phase === 'string' ? { phase: item.phase } : {}),
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/experimental/hostedMultiAgent/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/experimental/hostedMultiAgent/metadata.ts"],"names":[],"mappings":";;AA8BA,wDAiBC;AA1CD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO,KAAK,CAAC,YAAY,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CACpC,KAAc;IAEd,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;IACxC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,SAAS;QACT,GAAG,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC"}

package/dist/experimental/hostedMultiAgent/metadata.mjs

@@ -0,0 +1,33 @@
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function unwrapHostedValue(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    if (isRecord(value.toolCall)) {
+        return unwrapHostedValue(value.toolCall);
+    }
+    if (isRecord(value.providerData) && isRecord(value.providerData.agent)) {
+        return value.providerData;
+    }
+    return value;
+}
+/**
+ * Reads hosted-agent attribution without affecting local tool routing.
+ */
+export function getHostedAgentMetadata(value) {
+    const item = unwrapHostedValue(value);
+    if (!item || !isRecord(item.agent)) {
+        return undefined;
+    }
+    const agentName = item.agent.agent_name;
+    if (typeof agentName !== 'string' || agentName.length === 0) {
+        return undefined;
+    }
+    return {
+        agentName,
+        ...(typeof item.phase === 'string' ? { phase: item.phase } : {}),
+    };
+}
+//# sourceMappingURL=metadata.mjs.map

package/dist/experimental/hostedMultiAgent/metadata.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.mjs","sourceRoot":"","sources":["../../../src/experimental/hostedMultiAgent/metadata.ts"],"names":[],"mappings":"AAKA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO,KAAK,CAAC,YAAY,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAc;IAEd,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;IACxC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,SAAS;QACT,GAAG,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC"}

package/dist/experimental/hostedMultiAgent/model.d.ts

@@ -0,0 +1,28 @@
+import { Usage, protocol, type ModelRetryAdvice, type ModelRetryAdviceRequest, type ModelRequest } from '@openai/agents-core';
+import OpenAI from 'openai';
+import type { OpenAIClient } from '../../openaiClient';
+import { OpenAIResponsesModel } from '../../openaiResponsesModel';
+import type { HostedMultiAgentConfig } from './config';
+/**
+ * Experimental OpenAI Responses model that opts into service-hosted Multi-agent orchestration.
+ *
+ * The hosted beta requires a persistent Responses WebSocket because local tool outputs must be
+ * injected into the active response. Call {@link close} when the model is no longer needed.
+ */
+export declare class OpenAIHostedMultiAgentModel extends OpenAIResponsesModel {
+    #private;
+    readonly config: HostedMultiAgentConfig;
+    constructor(client: OpenAIClient, model: string, config?: HostedMultiAgentConfig);
+    getRetryAdvice(args: ModelRetryAdviceRequest): ModelRetryAdvice | undefined;
+    /** Close the persistent Responses WebSocket owned by this model. */
+    close(): Promise<void>;
+    protected _getResponsesCreateRequestOverrides(request: ModelRequest, requestData: Record<string, any>): Record<string, any>;
+    protected _convertResponseOutputItems(items: Array<Record<string, any>>): protocol.OutputModelItem[];
+    protected _getResponseForSDKOutput(response: OpenAI.Responses.Response): OpenAI.Responses.Response;
+    protected _getResponseUsage(response: OpenAI.Responses.Response): Usage;
+    protected _getStreamedResponseUsage(response: OpenAI.Responses.Response): protocol.UsageData;
+    protected _shouldEmitOutputTextDelta(event: Record<string, any>, outputItem: Record<string, any> | undefined): boolean;
+    protected _shouldEmitRawModelEvent(event: Record<string, any>): boolean;
+    protected _fetchResponse(request: ModelRequest, stream: true): Promise<AsyncIterable<OpenAI.Responses.ResponseStreamEvent>>;
+    protected _fetchResponse(request: ModelRequest, stream: false): Promise<OpenAI.Responses.Response>;
+}