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

package/dist/src/models/openai/responses-adapter.js

@@ -0,0 +1,467 @@
+/**
+ * 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 { encodeBase64 } from '../../types/media.js';
+import { toMimeType } from '../../mime.js';
+import { logger } from '../../logging/logger.js';
+import { MODEL_DEFAULTS } from '../defaults.js';
+import { formatImageDataUrl, warnManagedParams as warnManagedParamsShared } from './formatting.js';
+export const DEFAULT_RESPONSES_MODEL_ID = MODEL_DEFAULTS.openai.modelId;
+const MANAGED_PARAMS = new Set(['model', 'input', 'stream', 'store']);
+/**
+ * Logs a warning for each responses-managed key present in `params`.
+ *
+ * @internal
+ */
+export function warnManagedParams(params) {
+    warnManagedParamsShared(params, MANAGED_PARAMS);
+}
+/**
+ * Builds a Responses API streaming request body.
+ *
+ * @internal
+ */
+export function formatResponsesRequest(config, messages, options, stateful) {
+    const input = formatResponsesMessages(messages);
+    // User `params` are spread first so provider-managed fields (asserted
+    // required by `ResponseCreateParamsStreaming` below) always win. The
+    // managed-params warning fires at config time to surface the collision.
+    const request = {
+        ...(config.params ?? {}),
+        model: config.modelId ?? DEFAULT_RESPONSES_MODEL_ID,
+        input,
+        stream: true,
+        store: stateful,
+    };
+    if (stateful) {
+        const responseId = options?.modelState?.get('responseId');
+        if (responseId) {
+            request.previous_response_id = responseId;
+        }
+    }
+    if (options?.systemPrompt !== undefined) {
+        if (typeof options.systemPrompt === 'string') {
+            request.instructions = options.systemPrompt;
+        }
+        else if (Array.isArray(options.systemPrompt)) {
+            const texts = [];
+            for (const block of options.systemPrompt) {
+                if (block.type === 'textBlock') {
+                    texts.push(block.text);
+                }
+            }
+            if (texts.length > 0) {
+                request.instructions = texts.join('');
+            }
+        }
+    }
+    if (options?.toolSpecs && options.toolSpecs.length > 0) {
+        const existingTools = request.tools ?? [];
+        request.tools = [
+            ...existingTools,
+            ...options.toolSpecs.map((spec) => ({
+                type: 'function',
+                name: spec.name,
+                description: spec.description ?? '',
+                parameters: (spec.inputSchema ?? {}),
+                // `null` defers to the OpenAI server default. The SDK's typed
+                // contract requires a value; omitting it (as the Python SDK does)
+                // is not an option here.
+                strict: null,
+            })),
+        ];
+        if (options.toolChoice) {
+            if ('auto' in options.toolChoice) {
+                request.tool_choice = 'auto';
+            }
+            else if ('any' in options.toolChoice) {
+                request.tool_choice = 'required';
+            }
+            else if ('tool' in options.toolChoice) {
+                request.tool_choice = { type: 'function', name: options.toolChoice.tool.name };
+            }
+        }
+    }
+    if (config.temperature !== undefined)
+        request.temperature = config.temperature;
+    if (config.maxTokens !== undefined)
+        request.max_output_tokens = config.maxTokens;
+    if (config.topP !== undefined)
+        request.top_p = config.topP;
+    return request;
+}
+/**
+ * Formats SDK messages into Responses API input items.
+ *
+ * Per message, content blocks are split into three buckets:
+ * - Text/media → grouped in `{ role, content: [...] }`
+ * - Tool calls → separate `{ type: 'function_call', ... }` items
+ * - Tool results → separate `{ type: 'function_call_output', ... }` items
+ */
+function formatResponsesMessages(messages) {
+    const input = [];
+    for (const message of messages) {
+        const role = message.role === 'assistant' ? 'assistant' : 'user';
+        const contentItems = [];
+        const toolCallItems = [];
+        const toolResultItems = [];
+        for (const block of message.content) {
+            switch (block.type) {
+                case 'textBlock': {
+                    if (role === 'user') {
+                        contentItems.push({ type: 'input_text', text: block.text });
+                    }
+                    else {
+                        contentItems.push({ type: 'output_text', text: block.text });
+                    }
+                    break;
+                }
+                case 'imageBlock': {
+                    const formatted = formatImageInput(block);
+                    if (formatted)
+                        contentItems.push(formatted);
+                    break;
+                }
+                case 'documentBlock': {
+                    const formatted = formatDocumentInput(block);
+                    if (formatted)
+                        contentItems.push(formatted);
+                    break;
+                }
+                case 'citationsBlock': {
+                    const citBlock = block;
+                    for (const c of citBlock.content) {
+                        contentItems.push({ type: 'output_text', text: c.text });
+                    }
+                    break;
+                }
+                case 'toolUseBlock': {
+                    const toolBlock = block;
+                    const call = {
+                        type: 'function_call',
+                        call_id: toolBlock.toolUseId,
+                        name: toolBlock.name,
+                        arguments: JSON.stringify(toolBlock.input),
+                    };
+                    toolCallItems.push(call);
+                    break;
+                }
+                case 'toolResultBlock': {
+                    const resultBlock = block;
+                    const result = {
+                        type: 'function_call_output',
+                        call_id: resultBlock.toolUseId,
+                        output: formatToolResultOutput(resultBlock),
+                    };
+                    toolResultItems.push(result);
+                    break;
+                }
+                case 'reasoningBlock': {
+                    logger.warn('block_type=<reasoningBlock> | reasoning content is not yet supported in multi-turn conversations with the responses api');
+                    break;
+                }
+                default: {
+                    logger.warn(`block_type=<${block.type}> | unsupported content type in responses api message formatting | skipping`);
+                }
+            }
+        }
+        // Cast is needed because assistant messages here use `output_text` content
+        // blocks, which the SDK's input types model as `ResponseOutputMessage` —
+        // a response-shaped type that requires `id`/`status`/`annotations`. The API
+        // accepts these fields as omitted on input, but the SDK types don't reflect that.
+        if (contentItems.length > 0) {
+            input.push({
+                role,
+                content: contentItems,
+            });
+        }
+        input.push(...toolCallItems);
+        input.push(...toolResultItems);
+    }
+    return input;
+}
+/**
+ * Builds a Responses API `function_call_output.output` value from a SDK
+ * `toolResultBlock`. Returns a plain string for text-only results (joined with
+ * newlines) or the content-item array shape when the result carries image or
+ * document data.
+ */
+function formatToolResultOutput(resultBlock) {
+    const parts = [];
+    const texts = [];
+    let hasMedia = false;
+    for (const c of resultBlock.content) {
+        switch (c.type) {
+            case 'textBlock':
+                texts.push(c.text);
+                parts.push({ type: 'input_text', text: c.text });
+                break;
+            case 'jsonBlock': {
+                const jsonBlock = c;
+                let text;
+                try {
+                    text = JSON.stringify(jsonBlock.json);
+                }
+                catch {
+                    text = '[JSON serialization error]';
+                }
+                texts.push(text);
+                parts.push({ type: 'input_text', text });
+                break;
+            }
+            case 'imageBlock': {
+                const url = formatImageDataUrl(c);
+                if (url) {
+                    hasMedia = true;
+                    parts.push({ type: 'input_image', image_url: url });
+                }
+                break;
+            }
+            case 'documentBlock': {
+                const docBlock = c;
+                if (docBlock.source.type === 'documentSourceBytes') {
+                    const base64 = encodeBase64(docBlock.source.bytes);
+                    const mimeType = toMimeType(docBlock.format) || `application/${docBlock.format}`;
+                    hasMedia = true;
+                    parts.push({
+                        type: 'input_file',
+                        file_data: `data:${mimeType};base64,${base64}`,
+                        filename: docBlock.name,
+                    });
+                }
+                else {
+                    logger.warn(`source_type=<${docBlock.source.type}> | only byte source documents supported in responses api tool results`);
+                }
+                break;
+            }
+            default:
+                logger.warn(`block_type=<${c.type}> | unsupported tool result content type for responses api`);
+        }
+    }
+    if (hasMedia)
+        return parts;
+    // Text-only: collapse to a single string to match the API's simpler shape.
+    const text = texts.join('\n');
+    if (resultBlock.status === 'error') {
+        return `[ERROR] ${text}`;
+    }
+    return text;
+}
+function formatImageInput(imageBlock) {
+    const url = formatImageDataUrl(imageBlock);
+    if (!url)
+        return undefined;
+    return { type: 'input_image', image_url: url };
+}
+function formatDocumentInput(docBlock) {
+    if (docBlock.source.type === 'documentSourceBytes') {
+        const base64 = encodeBase64(docBlock.source.bytes);
+        const mimeType = toMimeType(docBlock.format) || `application/${docBlock.format}`;
+        return {
+            type: 'input_file',
+            file_data: `data:${mimeType};base64,${base64}`,
+            filename: docBlock.name,
+        };
+    }
+    logger.warn(`source_type=<${docBlock.source.type}> | only byte source documents supported in responses api`);
+    return undefined;
+}
+/**
+ * Creates fresh stream state for a new Responses API stream.
+ *
+ * @internal
+ */
+export function createResponsesStreamState() {
+    return {
+        dataType: null,
+        toolCalls: new Map(),
+        finalUsage: null,
+        stopReason: 'endTurn',
+    };
+}
+/**
+ * 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 function mapResponsesEventToSDK(event, state, stateful, modelState) {
+    const events = [];
+    switch (event.type) {
+        case 'response.created': {
+            if (stateful && modelState) {
+                modelState.set('responseId', event.response.id);
+            }
+            events.push({ type: 'modelMessageStartEvent', role: 'assistant' });
+            break;
+        }
+        case 'response.output_text.delta': {
+            events.push(...switchContent('text', state.dataType));
+            state.dataType = 'text';
+            events.push({
+                type: 'modelContentBlockDeltaEvent',
+                delta: { type: 'textDelta', text: event.delta },
+            });
+            break;
+        }
+        case 'response.reasoning_text.delta':
+        case 'response.reasoning_summary_text.delta': {
+            events.push(...switchContent('reasoning', state.dataType));
+            state.dataType = 'reasoning';
+            events.push({
+                type: 'modelContentBlockDeltaEvent',
+                delta: { type: 'reasoningContentDelta', text: event.delta },
+            });
+            break;
+        }
+        case 'response.output_text.annotation.added': {
+            // The SDK types `event.annotation` as `unknown` and doesn't export a
+            // named annotation union, so we narrow structurally on the fields we use.
+            const annotation = event.annotation;
+            if (annotation.type === 'url_citation') {
+                // Close the in-flight text block before the citation delta.
+                // model.ts finalization picks ONE block kind per open block
+                // (citations wins over text), so text + citation in the same
+                // block drops the text on stop. Switching here forces a
+                // separate CitationsBlock, and the next text delta will open
+                // a fresh TextBlock.
+                events.push(...switchContent('citations', state.dataType));
+                state.dataType = 'citations';
+                events.push({
+                    type: 'modelContentBlockDeltaEvent',
+                    delta: {
+                        type: 'citationsDelta',
+                        citations: [
+                            {
+                                location: {
+                                    type: 'web',
+                                    url: annotation.url ?? '',
+                                },
+                                source: annotation.url ?? '',
+                                sourceContent: [],
+                                title: annotation.title ?? '',
+                            },
+                        ],
+                        content: [{ text: annotation.cited_text ?? '' }],
+                    },
+                });
+            }
+            else {
+                logger.warn(`annotation_type=<${annotation.type}> | unsupported annotation type in responses api`);
+            }
+            break;
+        }
+        case 'response.output_item.added': {
+            if (event.item.type === 'function_call') {
+                // `id` is optional in the SDK type but load-bearing here: it keys
+                // subsequent argument delta/done events. Skip rather than collapse
+                // to an empty string, which would let distinct calls share a key.
+                const { id: itemId, call_id: callId, name } = event.item;
+                if (!itemId) {
+                    logger.warn(`call_id=<${callId}> name=<${name}> | function_call event missing item id — skipping`);
+                    break;
+                }
+                state.toolCalls.set(itemId, { name, arguments: '', callId, itemId });
+            }
+            break;
+        }
+        case 'response.function_call_arguments.delta': {
+            const tc = state.toolCalls.get(event.item_id);
+            if (tc) {
+                tc.arguments += event.delta;
+            }
+            break;
+        }
+        case 'response.function_call_arguments.done': {
+            const tc = state.toolCalls.get(event.item_id);
+            if (tc) {
+                tc.arguments = event.arguments;
+            }
+            break;
+        }
+        case 'response.incomplete': {
+            const resp = event.response;
+            if (resp.usage) {
+                state.finalUsage = {
+                    inputTokens: resp.usage.input_tokens,
+                    outputTokens: resp.usage.output_tokens,
+                    totalTokens: resp.usage.total_tokens,
+                };
+            }
+            if (resp.incomplete_details?.reason === 'max_output_tokens') {
+                state.stopReason = 'maxTokens';
+            }
+            break;
+        }
+        case 'response.completed': {
+            const resp = event.response;
+            if (resp.usage) {
+                state.finalUsage = {
+                    inputTokens: resp.usage.input_tokens,
+                    outputTokens: resp.usage.output_tokens,
+                    totalTokens: resp.usage.total_tokens,
+                };
+            }
+            break;
+        }
+        default:
+            break;
+    }
+    return events;
+}
+/**
+ * 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 function finalizeResponsesStream(state) {
+    const events = [];
+    if (state.dataType !== null) {
+        events.push({ type: 'modelContentBlockStopEvent' });
+    }
+    for (const [, tc] of state.toolCalls) {
+        events.push({
+            type: 'modelContentBlockStartEvent',
+            start: { type: 'toolUseStart', name: tc.name, toolUseId: tc.callId },
+        });
+        events.push({
+            type: 'modelContentBlockDeltaEvent',
+            delta: { type: 'toolUseInputDelta', input: tc.arguments },
+        });
+        events.push({ type: 'modelContentBlockStopEvent' });
+    }
+    let stopReason = state.stopReason;
+    if (state.toolCalls.size > 0) {
+        stopReason = 'toolUse';
+    }
+    if (state.finalUsage) {
+        events.push({ type: 'modelMetadataEvent', usage: state.finalUsage });
+    }
+    events.push({ type: 'modelMessageStopEvent', stopReason });
+    return events;
+}
+function switchContent(newType, prevType) {
+    const events = [];
+    if (newType !== prevType) {
+        if (prevType !== null) {
+            events.push({ type: 'modelContentBlockStopEvent' });
+        }
+        events.push({ type: 'modelContentBlockStartEvent' });
+    }
+    return events;
+}
+//# sourceMappingURL=responses-adapter.js.map

package/dist/src/models/openai/responses-adapter.js.map

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

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

@@ -0,0 +1,131 @@
+/**
+ * Type definitions for the OpenAI model provider.
+ */
+import type OpenAI from 'openai';
+import type { ApiKeySetter } from 'openai/client';
+import type { ClientOptions } from 'openai';
+import type { BaseModelConfig } from '../model.js';
+/**
+ * Supported OpenAI API modes.
+ * - `'chat'`: Chat Completions API (stateless)
+ * - `'responses'`: Responses API (optional server-managed conversation state via `stateful: true`)
+ *
+ * @see https://platform.openai.com/docs/api-reference/chat
+ * @see https://platform.openai.com/docs/api-reference/responses
+ */
+export type OpenAIApi = 'chat' | 'responses';
+/**
+ * Fields shared by both Chat Completions and Responses API configurations.
+ */
+interface OpenAIBaseConfig extends BaseModelConfig {
+    /**
+     * OpenAI model identifier (e.g., `gpt-5.4`, `gpt-5.4-mini`, `gpt-4o`).
+     * Defaults depend on the selected `api`.
+     */
+    modelId?: string;
+    /**
+     * Controls randomness in generation.
+     */
+    temperature?: number;
+    /**
+     * Maximum number of tokens to generate in the response.
+     */
+    maxTokens?: number;
+    /**
+     * Controls diversity via nucleus sampling.
+     */
+    topP?: number;
+    /**
+     * Additional parameters passed through to the OpenAI API for forward compatibility.
+     *
+     * Provider-managed fields cannot be overridden via `params` — use the dedicated
+     * config properties instead. A warning is logged at config time if any are present:
+     * - Chat Completions: `model`, `messages`, `stream`, `stream_options`
+     * - Responses API: `model`, `input`, `stream`, `store`
+     */
+    params?: Record<string, unknown>;
+}
+/**
+ * Configuration fields specific to the Chat Completions API.
+ */
+export interface OpenAIChatConfig extends OpenAIBaseConfig {
+    /**
+     * Reduces repetition of token sequences (-2.0 to 2.0).
+     * Chat Completions only.
+     */
+    frequencyPenalty?: number;
+    /**
+     * Encourages the model to talk about new topics (-2.0 to 2.0).
+     * Chat Completions only.
+     */
+    presencePenalty?: number;
+}
+/**
+ * Configuration fields specific to the Responses API.
+ */
+export interface OpenAIResponsesConfig extends OpenAIBaseConfig {
+    /**
+     * When `true`, the server manages conversation state: the request sets
+     * `store: true` and chains turns via `previous_response_id`, the Agent
+     * clears its local message history after each invocation, and a
+     * `conversationManager` cannot be supplied. Defaults to `false` — the
+     * Responses API is used in stateless mode, where the full message history
+     * is sent on every turn.
+     */
+    stateful?: boolean;
+}
+/**
+ * Runtime configuration shape returned by {@link OpenAIModel.getConfig}.
+ *
+ * Shared fields are required-shaped (still optional as per `BaseModelConfig`), and
+ * api-specific fields are optional because this is a merged view — callers cannot
+ * narrow on `api` from the returned config.
+ */
+export interface OpenAIModelConfig extends OpenAIBaseConfig {
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+    stateful?: boolean;
+}
+interface OpenAIClientOptions {
+    /**
+     * OpenAI API key (falls back to `OPENAI_API_KEY` environment variable).
+     *
+     * Accepts either a static string or an async function that resolves to a string.
+     * When a function is provided, it is invoked before each request.
+     */
+    apiKey?: string | ApiKeySetter;
+    /**
+     * Pre-configured OpenAI client instance. If provided, this client will be used
+     * instead of creating a new one.
+     */
+    client?: OpenAI;
+    /**
+     * Additional OpenAI client configuration. Only used if `client` is not provided.
+     */
+    clientConfig?: ClientOptions;
+}
+/**
+ * Options for constructing an {@link OpenAIModel}.
+ *
+ * Discriminated on `api` so that selecting `'chat'` type-narrows to expose
+ * `frequencyPenalty` / `presencePenalty`, and selecting `'responses'` (or
+ * omitting `api`) narrows to expose `stateful`.
+ *
+ * `api` is construction-only: it cannot be changed via {@link OpenAIModel.updateConfig}.
+ */
+export type OpenAIModelOptions = ({
+    api?: 'responses';
+} & OpenAIResponsesConfig & OpenAIClientOptions) | ({
+    api: 'chat';
+} & OpenAIChatConfig & OpenAIClientOptions);
+/**
+ * Internal stream state for the Chat Completions adapter.
+ *
+ * @internal
+ */
+export interface ChatStreamState {
+    messageStarted: boolean;
+    textContentBlockStarted: boolean;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/models/openai/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAChC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,CAAA;AAE5C;;GAEG;AACH,UAAU,gBAAiB,SAAQ,eAAe;IAChD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,UAAU,mBAAmB;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAAA;IAE9B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,aAAa,CAAA;CAC7B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAC1B,CAAC;IAAE,GAAG,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,qBAAqB,GAAG,mBAAmB,CAAC,GACrE,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,GAAG,mBAAmB,CAAC,CAAA;AAE9D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,OAAO,CAAA;IACvB,uBAAuB,EAAE,OAAO,CAAA;CACjC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the OpenAI model provider.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/models/openai/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}