@strands-agents/sdk 1.0.0-rc.4 → 1.0.0

package/dist/src/models/openai/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * OpenAI model provider.
+ *
+ * Defaults to the Responses API. Pass `api: 'chat'` to use Chat Completions.
+ *
+ * @example
+ * ```typescript
+ * import { OpenAIModel } from '@strands-agents/sdk/models/openai'
+ *
+ * // Responses API (default)
+ * const model = new OpenAIModel({ modelId: 'gpt-5.4', apiKey: 'sk-...' })
+ *
+ * // Chat Completions
+ * const model = new OpenAIModel({ api: 'chat', modelId: 'gpt-5.4', apiKey: 'sk-...' })
+ * ```
+ */
+export { OpenAIModel } from './model.js';
+export type { OpenAIApi, OpenAIChatConfig, OpenAIModelConfig, OpenAIModelOptions, OpenAIResponsesConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/models/openai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/models/openai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,YAAY,CAAA"}

package/dist/src/models/openai/index.js

@@ -0,0 +1,18 @@
+/**
+ * OpenAI model provider.
+ *
+ * Defaults to the Responses API. Pass `api: 'chat'` to use Chat Completions.
+ *
+ * @example
+ * ```typescript
+ * import { OpenAIModel } from '@strands-agents/sdk/models/openai'
+ *
+ * // Responses API (default)
+ * const model = new OpenAIModel({ modelId: 'gpt-5.4', apiKey: 'sk-...' })
+ *
+ * // Chat Completions
+ * const model = new OpenAIModel({ api: 'chat', modelId: 'gpt-5.4', apiKey: 'sk-...' })
+ * ```
+ */
+export { OpenAIModel } from './model.js';
+//# sourceMappingURL=index.js.map

package/dist/src/models/openai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/models/openai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/dist/src/models/openai/model.d.ts

@@ -0,0 +1,77 @@
+/**
+ * OpenAI model provider implementation.
+ *
+ * Supports both the Responses API (default) and the Chat Completions API.
+ * Selected via the `api` option at construction time.
+ *
+ * @see https://platform.openai.com/docs/api-reference/responses
+ * @see https://platform.openai.com/docs/api-reference/chat
+ */
+import { Model } from '../model.js';
+import type { StreamOptions } from '../model.js';
+import type { Message } from '../../types/messages.js';
+import type { ModelStreamEvent } from '../streaming.js';
+import type { OpenAIApi, OpenAIModelConfig, OpenAIModelOptions } from './types.js';
+/**
+ * OpenAI model provider.
+ *
+ * Defaults to the Responses API. Pass `api: 'chat'` to use Chat Completions.
+ * The `api` field is construction-only — it cannot be changed via
+ * {@link OpenAIModel.updateConfig}.
+ *
+ * @example
+ * ```typescript
+ * // Responses API (default)
+ * const model = new OpenAIModel({ modelId: 'gpt-5.4', apiKey: 'sk-...' })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Chat Completions
+ * const model = new OpenAIModel({ api: 'chat', modelId: 'gpt-5.4', apiKey: 'sk-...' })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Responses API with built-in web search
+ * const model = new OpenAIModel({
+ *   modelId: 'gpt-5.4',
+ *   params: { tools: [{ type: 'web_search' }] },
+ * })
+ * ```
+ */
+export declare class OpenAIModel extends Model<OpenAIModelConfig> {
+    private readonly _api;
+    private _config;
+    private _client;
+    constructor(options: OpenAIModelOptions);
+    /**
+     * The OpenAI API mode this model operates in (`'chat'` or `'responses'`).
+     * Set at construction and immutable; exposed for debugging and serialization.
+     */
+    get api(): OpenAIApi;
+    /**
+     * Whether this model manages conversation state server-side.
+     *
+     * `true` only for `api: 'responses'` with `stateful === true`. Chat Completions
+     * is always stateless, and Responses defaults to stateless.
+     */
+    get stateful(): boolean;
+    /**
+     * Updates the model configuration.
+     *
+     * `api` and `stateful` are construction-only — if present in `modelConfig`,
+     * they are stripped with a warning. Changing either at runtime would
+     * invalidate the invariants the agent builds on top of `stateful` (message
+     * history management, `previous_response_id` chaining).
+     */
+    updateConfig(modelConfig: OpenAIModelConfig & {
+        api?: OpenAIApi;
+    }): void;
+    getConfig(): OpenAIModelConfig;
+    stream(messages: Message[], options?: StreamOptions): AsyncIterable<ModelStreamEvent>;
+    private _streamChat;
+    private _streamResponses;
+    private _rewrapError;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/src/models/openai/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../src/models/openai/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAcvD,OAAO,KAAK,EAEV,SAAS,EAET,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,WAAY,SAAQ,KAAK,CAAC,iBAAiB,CAAC;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAQ;gBAEX,OAAO,EAAE,kBAAkB;IAwCvC;;;OAGG;IACH,IAAI,GAAG,IAAI,SAAS,CAEnB;IAED;;;;;OAKG;IACH,IAAa,QAAQ,IAAI,OAAO,CAE/B;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,WAAW,EAAE,iBAAiB,GAAG;QAAE,GAAG,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI;IAoBxE,SAAS,IAAI,iBAAiB;IAIvB,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,aAAa,CAAC,gBAAgB,CAAC;YAY7E,WAAW;YAiDX,gBAAgB;IAqB/B,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/src/models/openai/model.js

@@ -0,0 +1,211 @@
+/**
+ * OpenAI model provider implementation.
+ *
+ * Supports both the Responses API (default) and the Chat Completions API.
+ * Selected via the `api` option at construction time.
+ *
+ * @see https://platform.openai.com/docs/api-reference/responses
+ * @see https://platform.openai.com/docs/api-reference/chat
+ */
+import OpenAI from 'openai';
+import { Model } from '../model.js';
+import { ContextWindowOverflowError, ModelThrottledError } from '../../errors.js';
+import { logger } from '../../logging/logger.js';
+import { warnOnce } from '../../logging/warn-once.js';
+import { MODEL_DEFAULTS, defaultModelWarningMessage } from '../defaults.js';
+import { classifyOpenAIError } from './errors.js';
+import { formatChatRequest, mapChatChunkToEvents, warnManagedParams as warnChatManagedParams } from './chat-adapter.js';
+import { createResponsesStreamState, finalizeResponsesStream, formatResponsesRequest, mapResponsesEventToSDK, warnManagedParams as warnResponsesManagedParams, } from './responses-adapter.js';
+/**
+ * OpenAI model provider.
+ *
+ * Defaults to the Responses API. Pass `api: 'chat'` to use Chat Completions.
+ * The `api` field is construction-only — it cannot be changed via
+ * {@link OpenAIModel.updateConfig}.
+ *
+ * @example
+ * ```typescript
+ * // Responses API (default)
+ * const model = new OpenAIModel({ modelId: 'gpt-5.4', apiKey: 'sk-...' })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Chat Completions
+ * const model = new OpenAIModel({ api: 'chat', modelId: 'gpt-5.4', apiKey: 'sk-...' })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Responses API with built-in web search
+ * const model = new OpenAIModel({
+ *   modelId: 'gpt-5.4',
+ *   params: { tools: [{ type: 'web_search' }] },
+ * })
+ * ```
+ */
+export class OpenAIModel extends Model {
+    _api;
+    _config;
+    _client;
+    constructor(options) {
+        super();
+        const { apiKey, client, clientConfig, api = 'responses', ...modelConfig } = options;
+        if (api !== 'chat' && api !== 'responses') {
+            throw new Error(`Unsupported OpenAI API: '${api}'. Supported values: 'chat', 'responses'`);
+        }
+        this._api = api;
+        // `stateful` only exists on the responses branch of the discriminated union.
+        // Storing as the merged OpenAIModelConfig matches what `getConfig` returns.
+        this._config = modelConfig;
+        if (modelConfig.modelId === undefined) {
+            warnOnce(logger, defaultModelWarningMessage(MODEL_DEFAULTS.openai.modelId));
+        }
+        if (api === 'responses') {
+            warnResponsesManagedParams(modelConfig.params);
+        }
+        else {
+            warnChatManagedParams(modelConfig.params);
+        }
+        if (client) {
+            this._client = client;
+        }
+        else {
+            const hasEnvKey = typeof process !== 'undefined' && typeof process.env !== 'undefined' && process.env.OPENAI_API_KEY;
+            if (!apiKey && !hasEnvKey) {
+                throw new Error("OpenAI API key is required. Provide it via the 'apiKey' option (string or function) or set the OPENAI_API_KEY environment variable.");
+            }
+            this._client = new OpenAI({
+                ...(apiKey ? { apiKey } : {}),
+                ...clientConfig,
+            });
+        }
+    }
+    /**
+     * The OpenAI API mode this model operates in (`'chat'` or `'responses'`).
+     * Set at construction and immutable; exposed for debugging and serialization.
+     */
+    get api() {
+        return this._api;
+    }
+    /**
+     * Whether this model manages conversation state server-side.
+     *
+     * `true` only for `api: 'responses'` with `stateful === true`. Chat Completions
+     * is always stateless, and Responses defaults to stateless.
+     */
+    get stateful() {
+        return this._api === 'responses' && this._config.stateful === true;
+    }
+    /**
+     * Updates the model configuration.
+     *
+     * `api` and `stateful` are construction-only — if present in `modelConfig`,
+     * they are stripped with a warning. Changing either at runtime would
+     * invalidate the invariants the agent builds on top of `stateful` (message
+     * history management, `previous_response_id` chaining).
+     */
+    updateConfig(modelConfig) {
+        const { api, stateful, ...rest } = modelConfig;
+        if (api !== undefined) {
+            logger.warn(`api=<${api}> | 'api' is construction-only and cannot be changed via updateConfig — ignoring`);
+        }
+        if (stateful !== undefined) {
+            logger.warn(`stateful=<${stateful}> | 'stateful' is construction-only and cannot be changed via updateConfig — ignoring`);
+        }
+        if (this._api === 'responses') {
+            warnResponsesManagedParams(rest.params);
+        }
+        else {
+            warnChatManagedParams(rest.params);
+        }
+        this._config = { ...this._config, ...rest };
+    }
+    getConfig() {
+        return this._config;
+    }
+    async *stream(messages, options) {
+        if (!messages || messages.length === 0) {
+            throw new Error('At least one message is required');
+        }
+        if (this._api === 'chat') {
+            yield* this._streamChat(messages, options);
+        }
+        else {
+            yield* this._streamResponses(messages, options);
+        }
+    }
+    async *_streamChat(messages, options) {
+        try {
+            const request = formatChatRequest(this._config, messages, options);
+            const stream = await this._client.chat.completions.create(request);
+            const streamState = {
+                messageStarted: false,
+                textContentBlockStarted: false,
+            };
+            const activeToolCalls = new Map();
+            let bufferedUsage = null;
+            for await (const chunk of stream) {
+                if (!chunk.choices || chunk.choices.length === 0) {
+                    if (chunk.usage) {
+                        bufferedUsage = {
+                            type: 'modelMetadataEvent',
+                            usage: {
+                                inputTokens: chunk.usage.prompt_tokens ?? 0,
+                                outputTokens: chunk.usage.completion_tokens ?? 0,
+                                totalTokens: chunk.usage.total_tokens ?? 0,
+                            },
+                        };
+                    }
+                    continue;
+                }
+                const events = mapChatChunkToEvents(chunk, streamState, activeToolCalls);
+                for (const event of events) {
+                    if (event.type === 'modelMessageStopEvent' && bufferedUsage) {
+                        yield bufferedUsage;
+                        bufferedUsage = null;
+                    }
+                    yield event;
+                }
+            }
+            if (bufferedUsage) {
+                yield bufferedUsage;
+            }
+        }
+        catch (error) {
+            throw this._rewrapError(error);
+        }
+    }
+    async *_streamResponses(messages, options) {
+        try {
+            const request = formatResponsesRequest(this._config, messages, options, this.stateful);
+            const stream = await this._client.responses.create(request);
+            const state = createResponsesStreamState();
+            for await (const event of stream) {
+                for (const sdkEvent of mapResponsesEventToSDK(event, state, this.stateful, options?.modelState)) {
+                    yield sdkEvent;
+                }
+            }
+            for (const sdkEvent of finalizeResponsesStream(state)) {
+                yield sdkEvent;
+            }
+        }
+        catch (error) {
+            throw this._rewrapError(error);
+        }
+    }
+    _rewrapError(error) {
+        const err = error;
+        const kind = classifyOpenAIError(err);
+        if (kind === 'throttling') {
+            const message = err.message ?? 'Request was throttled by the model provider';
+            logger.debug(`throttled | error_message=<${message}>`);
+            return new ModelThrottledError(message, { cause: err });
+        }
+        if (kind === 'contextOverflow') {
+            return new ContextWindowOverflowError(err.message);
+        }
+        return error;
+    }
+}
+//# sourceMappingURL=model.js.map

package/dist/src/models/openai/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../src/models/openai/model.ts"],"names":[],"mappings":"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"}

package/dist/src/models/openai/responses-adapter.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Responses API adapter for the OpenAI model provider.
+ *
+ * Built-in tool support status:
+ * | Tool              | Support                                                  |
+ * |-------------------|----------------------------------------------------------|
+ * | web_search        | Full: includes URL citations                             |
+ * | file_search       | Partial: works but file citation annotations not emitted |
+ * | code_interpreter  | Partial: works but executed code/stdout not surfaced     |
+ * | mcp               | Partial: works but approval flow not supported           |
+ * | shell             | Partial: container mode only                             |
+ * | image_generation  | Not supported                                            |
+ *
+ * @internal
+ */
+import type { ResponseStreamEvent, ResponseCreateParamsStreaming } from 'openai/resources/responses/responses';
+import type { Message, StopReason } from '../../types/messages.js';
+import type { StateStore } from '../../state-store.js';
+import type { ModelStreamEvent } from '../streaming.js';
+import type { StreamOptions } from '../model.js';
+import type { OpenAIResponsesConfig } from './types.js';
+export declare const DEFAULT_RESPONSES_MODEL_ID: "gpt-5.4";
+/**
+ * Logs a warning for each responses-managed key present in `params`.
+ *
+ * @internal
+ */
+export declare function warnManagedParams(params: Record<string, unknown> | undefined): void;
+/**
+ * Builds a Responses API streaming request body.
+ *
+ * @internal
+ */
+export declare function formatResponsesRequest(config: OpenAIResponsesConfig, messages: Message[], options: StreamOptions | undefined, stateful: boolean): ResponseCreateParamsStreaming;
+/**
+ * Internal stream state for the Responses adapter. Tracks the active content
+ * block kind so the adapter can emit stop/start events when content type
+ * switches (text ↔ reasoning ↔ citations).
+ *
+ * @internal
+ */
+export interface ResponsesStreamState {
+    dataType: string | null;
+    toolCalls: Map<string, {
+        name: string;
+        arguments: string;
+        callId: string;
+        itemId: string;
+    }>;
+    finalUsage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    } | null;
+    stopReason: StopReason;
+}
+/**
+ * Creates fresh stream state for a new Responses API stream.
+ *
+ * @internal
+ */
+export declare function createResponsesStreamState(): ResponsesStreamState;
+/**
+ * Maps a single Responses API stream event to zero or more SDK events. Mutates
+ * `state` and, when `stateful` is `true`, writes `responseId` into `modelState`.
+ *
+ * @internal
+ */
+export declare function mapResponsesEventToSDK(event: ResponseStreamEvent, state: ResponsesStreamState, stateful: boolean, modelState: StateStore | undefined): ModelStreamEvent[];
+/**
+ * Emits the terminal events for a Responses API stream: closes any open content
+ * block, flushes accumulated tool calls, emits usage metadata, and finishes
+ * with `modelMessageStopEvent`.
+ *
+ * @internal
+ */
+export declare function finalizeResponsesStream(state: ResponsesStreamState): ModelStreamEvent[];
+//# sourceMappingURL=responses-adapter.d.ts.map

package/dist/src/models/openai/responses-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses-adapter.d.ts","sourceRoot":"","sources":["../../../../src/models/openai/responses-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,mBAAmB,EAInB,6BAA6B,EAC9B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAmB,MAAM,yBAAyB,CAAA;AAInF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAIhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAEvD,eAAO,MAAM,0BAA0B,WAAgC,CAAA;AAIvE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,QAAQ,EAAE,OAAO,GAChB,6BAA6B,CAqE/B;AAoMD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3F,UAAU,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACrF,UAAU,EAAE,UAAU,CAAA;CACvB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,oBAAoB,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,gBAAgB,EAAE,CAqIpB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,CA+BvF"}