@fgv/ts-extras 5.1.0-4 → 5.1.0-40

package/lib/packlets/ai-assist/streamingAdapters/openaiResponses.js

@@ -0,0 +1,389 @@
+"use strict";
+// Copyright (c) 2026 Erik Fortune
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callOpenAiResponsesStream = callOpenAiResponsesStream;
+/**
+ * Streaming adapter for the OpenAI / xAI Responses API. This is the format
+ * used when server-side tools (e.g. web_search) are requested — Chat
+ * Completions doesn't support tool progress events, but the Responses API
+ * does.
+ *
+ * Client-defined tools (`function_call` type) are accumulated per call ID
+ * and emitted as `client-tool-call-done` events when complete.
+ *
+ * @packageDocumentation
+ */
+const ts_utils_1 = require("@fgv/ts-utils");
+const chatRequestBuilders_1 = require("../chatRequestBuilders");
+const endpoint_1 = require("../endpoint");
+const sseParser_1 = require("../sseParser");
+const toolFormats_1 = require("../toolFormats");
+const common_1 = require("./common");
+const responsesDeltaPayload = ts_utils_1.Validators.object({
+    delta: ts_utils_1.Validators.string
+});
+const responsesOutputItemInner = ts_utils_1.Validators.object({
+    type: ts_utils_1.Validators.string.optional(),
+    id: ts_utils_1.Validators.string.optional(),
+    name: ts_utils_1.Validators.string.optional(),
+    call_id: ts_utils_1.Validators.string.optional()
+}, { options: { optionalFields: ['type', 'id', 'name', 'call_id'] } });
+const responsesOutputItemAddedPayload = ts_utils_1.Validators.object({ item: responsesOutputItemInner });
+const responsesFunctionCallArgsDeltaPayload = ts_utils_1.Validators.object({
+    item_id: ts_utils_1.Validators.string,
+    delta: ts_utils_1.Validators.string
+});
+const responsesFunctionCallArgsDonePayload = ts_utils_1.Validators.object({
+    item_id: ts_utils_1.Validators.string,
+    arguments: ts_utils_1.Validators.string
+});
+const responsesIncompleteDetails = ts_utils_1.Validators.object({ reason: ts_utils_1.Validators.string.optional() }, { options: { optionalFields: ['reason'] } });
+const responsesCompletedPayload = ts_utils_1.Validators.object({
+    response: ts_utils_1.Validators.object({
+        status: ts_utils_1.Validators.string.optional(),
+        incomplete_details: responsesIncompleteDetails.optional()
+    }, { options: { optionalFields: ['status', 'incomplete_details'] } })
+});
+const responsesErrorInner = ts_utils_1.Validators.object({ message: ts_utils_1.Validators.string.optional() }, { options: { optionalFields: ['message'] } });
+const responsesErrorPayload = ts_utils_1.Validators.object({
+    error: responsesErrorInner.optional(),
+    message: ts_utils_1.Validators.string.optional()
+}, { options: { optionalFields: ['error', 'message'] } });
+// ============================================================================
+// Stream translator
+// ============================================================================
+/**
+ * Recognized OpenAI / xAI Responses API SSE event names. An event in this set is either
+ * handled below or intentionally ignored (lifecycle / reasoning content discarded by design /
+ * server-tool channels not yet surfaced). Any event whose name is NOT in this set surfaces
+ * a one-time `logger.warn` per stream — making provider drift (new event types from a model
+ * update) visible empirically instead of silently no-op'd.
+ *
+ * Source: official `openai-node` SDK source (`src/resources/responses/responses.ts`)
+ * event-type literal-string sweep, plus the xAI Responses superset. Add to this set when a
+ * new event type is observed and confirmed safe to ignore.
+ *
+ * @internal
+ */
+const RECOGNIZED_OPENAI_RESPONSES_EVENTS = new Set([
+    // ---- handled by the translator ----
+    'response.output_text.delta',
+    'response.web_search_call.in_progress',
+    'response.web_search_call.completed',
+    'response.output_item.added',
+    'response.function_call_arguments.delta',
+    'response.function_call_arguments.done',
+    'response.completed',
+    'response.failed',
+    'error',
+    // ---- lifecycle events: intentionally silent ----
+    'response.created',
+    'response.in_progress',
+    'response.queued',
+    'response.incomplete',
+    // ---- text content lifecycle: handled implicitly via delta accumulation ----
+    'response.output_text.done',
+    'response.output_text.annotation.added',
+    'response.content_part.added',
+    'response.content_part.done',
+    'response.output_item.done',
+    // ---- reasoning content: discarded by design (see ai-assist-thinking-events follow-on) ----
+    'response.reasoning_summary_part.added',
+    'response.reasoning_summary_part.done',
+    'response.reasoning_summary_text.delta',
+    'response.reasoning_summary_text.done',
+    'response.reasoning_text.delta',
+    'response.reasoning_text.done',
+    // ---- refusals: caller currently sees these via the model's final text ----
+    'response.refusal.delta',
+    'response.refusal.done',
+    // ---- server-tool channels not surfaced as tool-event yet ----
+    'response.web_search_call.searching',
+    'response.file_search_call.in_progress',
+    'response.file_search_call.searching',
+    'response.file_search_call.completed',
+    'response.code_interpreter_call.in_progress',
+    'response.code_interpreter_call.interpreting',
+    'response.code_interpreter_call.completed',
+    'response.code_interpreter_call_code.delta',
+    'response.code_interpreter_call_code.done',
+    'response.image_generation_call.in_progress',
+    'response.image_generation_call.generating',
+    'response.image_generation_call.completed',
+    'response.image_generation_call.partial_image',
+    'response.mcp_call.in_progress',
+    'response.mcp_call.completed',
+    'response.mcp_call.failed',
+    'response.mcp_call_arguments.delta',
+    'response.mcp_call_arguments.done',
+    'response.mcp_list_tools.in_progress',
+    'response.mcp_list_tools.completed',
+    'response.mcp_list_tools.failed',
+    'response.custom_tool_call_input.delta',
+    'response.custom_tool_call_input.done',
+    // ---- audio (not used in chat/tool flows here) ----
+    'response.audio.delta',
+    'response.audio.done',
+    'response.audio.transcript.delta',
+    'response.audio.transcript.done'
+]);
+/**
+ * Translates an OpenAI Responses API SSE stream into unified events.
+ *
+ * Maintains a per-call-ID accumulation map for client-defined function calls.
+ * The map is exposed via the passed-in `functionCallMap` parameter for the
+ * C3 continuation builder to read after the stream completes.
+ *
+ * Unrecognized event names are reported once per stream via `logger?.warn` —
+ * see {@link RECOGNIZED_OPENAI_RESPONSES_EVENTS}.
+ *
+ * @internal
+ */
+function translateOpenAiResponsesStream(response, functionCallMap, logger) {
+    return __asyncGenerator(this, arguments, function* translateOpenAiResponsesStream_1() {
+        var _a, e_1, _b, _c;
+        var _d, _e, _f, _g, _h;
+        let fullText = '';
+        let truncated = false;
+        let completed = false;
+        let incompleteReason;
+        // OpenAI / xAI Responses API emits function_call_arguments.{delta,done} events keyed by
+        // `item_id` (the fc_* output-item id). The harness and continuation builder key by
+        // `call_id` (the call_* id). This map correlates the two — populated when the
+        // function_call item is announced in `response.output_item.added`.
+        const itemIdToCallId = new Map();
+        // Track unrecognized event names we have already warned about, so a hot stream of
+        // an unknown event type produces exactly one log line per name per stream.
+        const warnedEvents = new Set();
+        try {
+            /* c8 ignore next - body is non-null at this point per openSseConnection */
+            if (!response.body)
+                return yield __await(void 0);
+            try {
+                for (var _j = true, _k = __asyncValues((0, sseParser_1.readSseEvents)(response.body)), _l; _l = yield __await(_k.next()), _a = _l.done, !_a; _j = true) {
+                    _c = _l.value;
+                    _j = false;
+                    const message = _c;
+                    const eventName = message.event;
+                    if (eventName === 'response.output_text.delta') {
+                        const payload = (0, common_1.validateEventPayload)((0, sseParser_1.parseSseEventJson)(message.data), responsesDeltaPayload);
+                        /* c8 ignore next 1 - defensive: payload?.delta null branch unreachable after validation */
+                        const delta = payload === null || payload === void 0 ? void 0 : payload.delta;
+                        if (typeof delta === 'string' && delta.length > 0) {
+                            fullText += delta;
+                            yield yield __await({ type: 'text-delta', delta });
+                        }
+                    }
+                    else if (eventName === 'response.web_search_call.in_progress') {
+                        yield yield __await({ type: 'tool-event', toolType: 'web_search', phase: 'started' });
+                    }
+                    else if (eventName === 'response.web_search_call.completed') {
+                        yield yield __await({ type: 'tool-event', toolType: 'web_search', phase: 'completed' });
+                    }
+                    else if (eventName === 'response.output_item.added') {
+                        const payload = (0, common_1.validateEventPayload)((0, sseParser_1.parseSseEventJson)(message.data), responsesOutputItemAddedPayload);
+                        /* c8 ignore next 1 - defensive: payload null branch unreachable after validation */
+                        const item = payload === null || payload === void 0 ? void 0 : payload.item;
+                        /* c8 ignore next 1 - defensive: falsy call_id/name branches are protocol violations */
+                        if ((item === null || item === void 0 ? void 0 : item.type) === 'function_call' && item.call_id && item.name) {
+                            functionCallMap.set(item.call_id, { id: item.call_id, name: item.name, argsBuffer: '' });
+                            // Reasoning models (and the standard flow) reference this function_call in subsequent
+                            // arguments.{delta,done} events by `item_id`, never by `call_id`. Record the mapping
+                            // so the arg-accumulation handlers can resolve the call.
+                            if (item.id) {
+                                itemIdToCallId.set(item.id, item.call_id);
+                            }
+                            yield yield __await({ type: 'client-tool-call-start', toolName: item.name, callId: item.call_id });
+                        }
+                    }
+                    else if (eventName === 'response.function_call_arguments.delta') {
+                        const payload = (0, common_1.validateEventPayload)((0, sseParser_1.parseSseEventJson)(message.data), responsesFunctionCallArgsDeltaPayload);
+                        /* c8 ignore next 1 - defensive: payload null branch unreachable after validation */
+                        const itemId = payload === null || payload === void 0 ? void 0 : payload.item_id;
+                        if (itemId !== undefined) {
+                            const callId = itemIdToCallId.get(itemId);
+                            /* c8 ignore next 1 - defensive: orphan delta (no preceding output_item.added) is a protocol violation */
+                            const call = callId !== undefined ? functionCallMap.get(callId) : undefined;
+                            /* c8 ignore next 1 - defensive: call always present and delta always string in valid stream */
+                            if (call && typeof (payload === null || payload === void 0 ? void 0 : payload.delta) === 'string') {
+                                call.argsBuffer += payload.delta;
+                            }
+                        }
+                    }
+                    else if (eventName === 'response.function_call_arguments.done') {
+                        const payload = (0, common_1.validateEventPayload)((0, sseParser_1.parseSseEventJson)(message.data), responsesFunctionCallArgsDonePayload);
+                        /* c8 ignore next 1 - defensive: payload null branch unreachable after validation */
+                        const itemId = payload === null || payload === void 0 ? void 0 : payload.item_id;
+                        if (itemId !== undefined) {
+                            const callId = itemIdToCallId.get(itemId);
+                            /* c8 ignore next 1 - defensive: orphan done (no preceding output_item.added) is a protocol violation */
+                            const call = callId !== undefined ? functionCallMap.get(callId) : undefined;
+                            if (call && callId !== undefined) {
+                                /* c8 ignore next 1 - defensive: payload?.arguments null branch unreachable after validation */
+                                const canonicalArgs = (_d = payload === null || payload === void 0 ? void 0 : payload.arguments) !== null && _d !== void 0 ? _d : '{}';
+                                // Sync the accumulation entry with the canonical arguments from the .done event.
+                                // Delta events may carry partial/empty payloads; the .done event carries the
+                                // authoritative final arguments string used by the continuation builder.
+                                call.argsBuffer = canonicalArgs;
+                                let args;
+                                try {
+                                    const parsed = JSON.parse(canonicalArgs);
+                                    /* c8 ignore start - defensive: non-object/malformed parse defaults to empty object */
+                                    args =
+                                        parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)
+                                            ? parsed
+                                            : {};
+                                }
+                                catch (_m) {
+                                    args = {};
+                                }
+                                /* c8 ignore stop */
+                                yield yield __await({ type: 'client-tool-call-done', toolName: call.name, callId, args });
+                            }
+                        }
+                    }
+                    else if (eventName === 'response.completed') {
+                        const payload = (0, common_1.validateEventPayload)((0, sseParser_1.parseSseEventJson)(message.data), responsesCompletedPayload);
+                        /* c8 ignore next 1 - defensive: payload null branch unreachable after validation */
+                        if (payload) {
+                            truncated = payload.response.status === 'incomplete';
+                            // Per IAiStreamDone.incompleteReason's contract, the reason is meaningful only
+                            // when the response was truncated. Move both fields together on every completed
+                            // event so a stray incomplete_details on a non-incomplete payload never leaks
+                            // through, and a later (defensive) completed event can't leave a stale reason.
+                            incompleteReason = truncated ? (_e = payload.response.incomplete_details) === null || _e === void 0 ? void 0 : _e.reason : undefined;
+                        }
+                        completed = true;
+                        /* c8 ignore next 1 - defensive: eventName === 'error' alternative not exercised in tests */
+                    }
+                    else if (eventName === 'response.failed' || eventName === 'error') {
+                        const payload = (0, common_1.validateEventPayload)((0, sseParser_1.parseSseEventJson)(message.data), responsesErrorPayload);
+                        /* c8 ignore next 1 - defensive: payload?.error and payload?.message null branches unreachable */
+                        const errMsg = (_h = (_g = (_f = payload === null || payload === void 0 ? void 0 : payload.error) === null || _f === void 0 ? void 0 : _f.message) !== null && _g !== void 0 ? _g : payload === null || payload === void 0 ? void 0 : payload.message) !== null && _h !== void 0 ? _h : 'Responses API stream failed';
+                        yield yield __await({ type: 'error', message: errMsg });
+                        return yield __await(void 0);
+                    }
+                    else if (typeof eventName === 'string' &&
+                        !RECOGNIZED_OPENAI_RESPONSES_EVENTS.has(eventName) &&
+                        !warnedEvents.has(eventName)) {
+                        // Empirical drift instrument: an unrecognized SSE event from the Responses API
+                        // surfaces as a one-time warning per stream. If a provider adds a new event type
+                        // (or changes an existing event's name), the warning fires the first time the
+                        // event arrives. Update RECOGNIZED_OPENAI_RESPONSES_EVENTS once the new event is
+                        // either handled or confirmed safe to ignore.
+                        warnedEvents.add(eventName);
+                        logger === null || logger === void 0 ? void 0 : logger.warn(`${common_1.UNRECOGNIZED_EVENT_WARN_TAG} OpenAI Responses adapter: unrecognized SSE event ` +
+                            `'${eventName}'. ` +
+                            `payload preview: ${(0, common_1.formatUnrecognizedEventPayloadPreview)(message.data)}. ` +
+                            `This may indicate provider drift — if the new event carries data the adapter ` +
+                            `should surface, add a handler; otherwise add the name to ` +
+                            `RECOGNIZED_OPENAI_RESPONSES_EVENTS.`);
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_j && !_a && (_b = _k.return)) yield __await(_b.call(_k));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        }
+        catch (err) /* c8 ignore start - defensive: stream errors are always Error instances */ {
+            yield yield __await({ type: 'error', message: err instanceof Error ? err.message : String(err) });
+            return yield __await(void 0);
+        } /* c8 ignore stop */
+        if (completed) {
+            yield yield __await({ type: 'done', truncated, fullText, incompleteReason });
+        }
+        else {
+            yield yield __await({ type: 'error', message: 'Responses API stream ended without a completed event' });
+        }
+    });
+}
+// ============================================================================
+// Per-format request caller
+// ============================================================================
+/**
+ * Issues a streaming Responses API request (with tools) and returns the
+ * unified-event iterable on success.
+ *
+ * @internal
+ */
+async function callOpenAiResponsesStream(config, prompt, tools = [], messagesBefore, temperature, logger, signal, resolvedThinking, functionCallMap, continuationMessages) {
+    var _a;
+    const url = `${config.baseUrl}/responses`;
+    const input = (0, chatRequestBuilders_1.buildMessages)(prompt.system, (0, chatRequestBuilders_1.buildOpenAiResponsesUserContent)(prompt), {
+        head: messagesBefore,
+        rawTail: continuationMessages
+    });
+    const effort = (_a = resolvedThinking === null || resolvedThinking === void 0 ? void 0 : resolvedThinking.openAiEffort) !== null && _a !== void 0 ? _a : resolvedThinking === null || resolvedThinking === void 0 ? void 0 : resolvedThinking.xaiEffort;
+    const supportsReasoning = config.model !== 'grok-4';
+    const body = {
+        model: config.model,
+        input,
+        stream: true
+    };
+    // `tools` is omitted entirely when none are requested — a Responses-only model routed
+    // here for tier/model reasons (not tools) must not send an empty tools array.
+    if (tools.length > 0) {
+        body.tools = (0, toolFormats_1.toResponsesApiTools)(tools);
+    }
+    if (effort !== undefined && supportsReasoning) {
+        body.reasoning = { effort };
+    }
+    // Temperature is sent only when the caller explicitly provided one (see callOpenAiChatStream).
+    if (effort === undefined || effort === 'none') {
+        if (temperature !== undefined) {
+            body.temperature = temperature;
+        }
+    }
+    if ((resolvedThinking === null || resolvedThinking === void 0 ? void 0 : resolvedThinking.otherParams) !== undefined) {
+        Object.assign(body, resolvedThinking.otherParams);
+    }
+    const headers = (0, endpoint_1.bearerAuthHeader)(config.apiKey);
+    /* c8 ignore next 3 - optional logger */
+    logger === null || logger === void 0 ? void 0 : logger.info(`OpenAI Responses streaming: model=${config.model}, tools=${tools.map((t) => t.type).join(',')}`);
+    const callMap = functionCallMap !== null && functionCallMap !== void 0 ? functionCallMap : new Map();
+    const conn = await (0, common_1.openSseConnection)(url, headers, body, logger, signal);
+    return conn.onSuccess((response) => (0, ts_utils_1.succeed)(translateOpenAiResponsesStream(response, callMap, logger)));
+}
+//# sourceMappingURL=openaiResponses.js.map

package/lib/packlets/ai-assist/streamingAdapters/openaiResponses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openaiResponses.js","sourceRoot":"","sources":["../../../../src/packlets/ai-assist/streamingAdapters/openaiResponses.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Erik Fortune\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in all\n// copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n// SOFTWARE.\n\n/**\n * Streaming adapter for the OpenAI / xAI Responses API. This is the format\n * used when server-side tools (e.g. web_search) are requested — Chat\n * Completions doesn't support tool progress events, but the Responses API\n * does.\n *\n * Client-defined tools (`function_call` type) are accumulated per call ID\n * and emitted as `client-tool-call-done` events when complete.\n *\n * @packageDocumentation\n */\n\nimport { type Logging, Result, succeed, type Validator, Validators } from '@fgv/ts-utils';\nimport { type JsonObject } from '@fgv/ts-json-base';\n\nimport { buildMessages, buildOpenAiResponsesUserContent } from '../chatRequestBuilders';\nimport { bearerAuthHeader } from '../endpoint';\nimport { AiPrompt, type AiToolConfig, type IAiStreamEvent, type IChatMessage } from '../model';\nimport { parseSseEventJson, readSseEvents } from '../sseParser';\nimport { toResponsesApiTools } from '../toolFormats';\nimport { type IResolvedThinkingConfig } from '../thinkingOptionsResolver';\nimport {\n  IStreamApiConfig,\n  UNRECOGNIZED_EVENT_WARN_TAG,\n  formatUnrecognizedEventPayloadPreview,\n  openSseConnection,\n  validateEventPayload\n} from './common';\n\n// ============================================================================\n// Accumulated call state (internal — used by C3 continuation builder)\n// ============================================================================\n\n/**\n * Accumulated state for a single function_call in the OpenAI Responses API stream.\n * @internal\n */\nexport interface IAccumulatedFunctionCall {\n  readonly id: string;\n  readonly name: string;\n  argsBuffer: string;\n}\n\n// ============================================================================\n// Event payload shapes\n// ============================================================================\n\n/**\n * Payload of a `response.output_text.delta` SSE event.\n * @internal\n */\ninterface IResponsesDeltaPayload {\n  readonly delta: string;\n}\n\n/**\n * Payload of a `response.output_item.added` SSE event.\n * @internal\n */\ninterface IResponsesOutputItemAddedPayload {\n  readonly item: {\n    readonly type?: string;\n    readonly id?: string;\n    readonly name?: string;\n    readonly call_id?: string;\n  };\n}\n\n/**\n * Payload of a `response.function_call_arguments.delta` SSE event.\n *\n * The live OpenAI / xAI Responses API emits these events keyed by `item_id` (the\n * `fc_*` output-item id), NOT by `call_id` (the `call_*` id used in continuation\n * input items). The adapter correlates `item_id` → `call_id` via the\n * `response.output_item.added` event that introduced the function_call item.\n *\n * @internal\n */\ninterface IResponsesFunctionCallArgsDeltaPayload {\n  readonly item_id: string;\n  readonly delta: string;\n}\n\n/**\n * Payload of a `response.function_call_arguments.done` SSE event.\n *\n * Keyed by `item_id` like the delta event — see {@link IResponsesFunctionCallArgsDeltaPayload}.\n *\n * @internal\n */\ninterface IResponsesFunctionCallArgsDonePayload {\n  readonly item_id: string;\n  readonly arguments: string;\n}\n\n/**\n * Payload of a `response.completed` SSE event.\n * @internal\n */\ninterface IResponsesCompletedPayload {\n  readonly response: {\n    readonly status?: string;\n    readonly incomplete_details?: { readonly reason?: string };\n  };\n}\n\n/**\n * Payload of a `response.failed` or `error` SSE event.\n * @internal\n */\ninterface IResponsesErrorPayload {\n  readonly error?: { readonly message?: string };\n  readonly message?: string;\n}\n\nconst responsesDeltaPayload: Validator<IResponsesDeltaPayload> = Validators.object<IResponsesDeltaPayload>({\n  delta: Validators.string\n});\n\nconst responsesOutputItemInner: Validator<{\n  type?: string;\n  id?: string;\n  name?: string;\n  call_id?: string;\n}> = Validators.object<{ type?: string; id?: string; name?: string; call_id?: string }>(\n  {\n    type: Validators.string.optional(),\n    id: Validators.string.optional(),\n    name: Validators.string.optional(),\n    call_id: Validators.string.optional()\n  },\n  { options: { optionalFields: ['type', 'id', 'name', 'call_id'] } }\n);\n\nconst responsesOutputItemAddedPayload: Validator<IResponsesOutputItemAddedPayload> =\n  Validators.object<IResponsesOutputItemAddedPayload>({ item: responsesOutputItemInner });\n\nconst responsesFunctionCallArgsDeltaPayload: Validator<IResponsesFunctionCallArgsDeltaPayload> =\n  Validators.object<IResponsesFunctionCallArgsDeltaPayload>({\n    item_id: Validators.string,\n    delta: Validators.string\n  });\n\nconst responsesFunctionCallArgsDonePayload: Validator<IResponsesFunctionCallArgsDonePayload> =\n  Validators.object<IResponsesFunctionCallArgsDonePayload>({\n    item_id: Validators.string,\n    arguments: Validators.string\n  });\n\nconst responsesIncompleteDetails: Validator<{ reason?: string }> = Validators.object<{ reason?: string }>(\n  { reason: Validators.string.optional() },\n  { options: { optionalFields: ['reason'] } }\n);\n\nconst responsesCompletedPayload: Validator<IResponsesCompletedPayload> =\n  Validators.object<IResponsesCompletedPayload>({\n    response: Validators.object<{ status?: string; incomplete_details?: { reason?: string } }>(\n      {\n        status: Validators.string.optional(),\n        incomplete_details: responsesIncompleteDetails.optional()\n      },\n      { options: { optionalFields: ['status', 'incomplete_details'] } }\n    )\n  });\n\nconst responsesErrorInner: Validator<{ message?: string }> = Validators.object<{ message?: string }>(\n  { message: Validators.string.optional() },\n  { options: { optionalFields: ['message'] } }\n);\n\nconst responsesErrorPayload: Validator<IResponsesErrorPayload> = Validators.object<IResponsesErrorPayload>(\n  {\n    error: responsesErrorInner.optional(),\n    message: Validators.string.optional()\n  },\n  { options: { optionalFields: ['error', 'message'] } }\n);\n\n// ============================================================================\n// Stream translator\n// ============================================================================\n\n/**\n * Recognized OpenAI / xAI Responses API SSE event names. An event in this set is either\n * handled below or intentionally ignored (lifecycle / reasoning content discarded by design /\n * server-tool channels not yet surfaced). Any event whose name is NOT in this set surfaces\n * a one-time `logger.warn` per stream — making provider drift (new event types from a model\n * update) visible empirically instead of silently no-op'd.\n *\n * Source: official `openai-node` SDK source (`src/resources/responses/responses.ts`)\n * event-type literal-string sweep, plus the xAI Responses superset. Add to this set when a\n * new event type is observed and confirmed safe to ignore.\n *\n * @internal\n */\nconst RECOGNIZED_OPENAI_RESPONSES_EVENTS: ReadonlySet<string> = new Set<string>([\n  // ---- handled by the translator ----\n  'response.output_text.delta',\n  'response.web_search_call.in_progress',\n  'response.web_search_call.completed',\n  'response.output_item.added',\n  'response.function_call_arguments.delta',\n  'response.function_call_arguments.done',\n  'response.completed',\n  'response.failed',\n  'error',\n  // ---- lifecycle events: intentionally silent ----\n  'response.created',\n  'response.in_progress',\n  'response.queued',\n  'response.incomplete',\n  // ---- text content lifecycle: handled implicitly via delta accumulation ----\n  'response.output_text.done',\n  'response.output_text.annotation.added',\n  'response.content_part.added',\n  'response.content_part.done',\n  'response.output_item.done',\n  // ---- reasoning content: discarded by design (see ai-assist-thinking-events follow-on) ----\n  'response.reasoning_summary_part.added',\n  'response.reasoning_summary_part.done',\n  'response.reasoning_summary_text.delta',\n  'response.reasoning_summary_text.done',\n  'response.reasoning_text.delta',\n  'response.reasoning_text.done',\n  // ---- refusals: caller currently sees these via the model's final text ----\n  'response.refusal.delta',\n  'response.refusal.done',\n  // ---- server-tool channels not surfaced as tool-event yet ----\n  'response.web_search_call.searching',\n  'response.file_search_call.in_progress',\n  'response.file_search_call.searching',\n  'response.file_search_call.completed',\n  'response.code_interpreter_call.in_progress',\n  'response.code_interpreter_call.interpreting',\n  'response.code_interpreter_call.completed',\n  'response.code_interpreter_call_code.delta',\n  'response.code_interpreter_call_code.done',\n  'response.image_generation_call.in_progress',\n  'response.image_generation_call.generating',\n  'response.image_generation_call.completed',\n  'response.image_generation_call.partial_image',\n  'response.mcp_call.in_progress',\n  'response.mcp_call.completed',\n  'response.mcp_call.failed',\n  'response.mcp_call_arguments.delta',\n  'response.mcp_call_arguments.done',\n  'response.mcp_list_tools.in_progress',\n  'response.mcp_list_tools.completed',\n  'response.mcp_list_tools.failed',\n  'response.custom_tool_call_input.delta',\n  'response.custom_tool_call_input.done',\n  // ---- audio (not used in chat/tool flows here) ----\n  'response.audio.delta',\n  'response.audio.done',\n  'response.audio.transcript.delta',\n  'response.audio.transcript.done'\n]);\n\n/**\n * Translates an OpenAI Responses API SSE stream into unified events.\n *\n * Maintains a per-call-ID accumulation map for client-defined function calls.\n * The map is exposed via the passed-in `functionCallMap` parameter for the\n * C3 continuation builder to read after the stream completes.\n *\n * Unrecognized event names are reported once per stream via `logger?.warn` —\n * see {@link RECOGNIZED_OPENAI_RESPONSES_EVENTS}.\n *\n * @internal\n */\nasync function* translateOpenAiResponsesStream(\n  response: Response,\n  functionCallMap: Map<string, IAccumulatedFunctionCall>,\n  logger?: Logging.ILogger\n): AsyncGenerator<IAiStreamEvent> {\n  let fullText = '';\n  let truncated = false;\n  let completed = false;\n  let incompleteReason: string | undefined;\n  // OpenAI / xAI Responses API emits function_call_arguments.{delta,done} events keyed by\n  // `item_id` (the fc_* output-item id). The harness and continuation builder key by\n  // `call_id` (the call_* id). This map correlates the two — populated when the\n  // function_call item is announced in `response.output_item.added`.\n  const itemIdToCallId = new Map<string, string>();\n  // Track unrecognized event names we have already warned about, so a hot stream of\n  // an unknown event type produces exactly one log line per name per stream.\n  const warnedEvents = new Set<string>();\n\n  try {\n    /* c8 ignore next - body is non-null at this point per openSseConnection */\n    if (!response.body) return;\n    for await (const message of readSseEvents(response.body)) {\n      const eventName = message.event;\n      if (eventName === 'response.output_text.delta') {\n        const payload = validateEventPayload(parseSseEventJson(message.data), responsesDeltaPayload);\n        /* c8 ignore next 1 - defensive: payload?.delta null branch unreachable after validation */\n        const delta = payload?.delta;\n        if (typeof delta === 'string' && delta.length > 0) {\n          fullText += delta;\n          yield { type: 'text-delta', delta };\n        }\n      } else if (eventName === 'response.web_search_call.in_progress') {\n        yield { type: 'tool-event', toolType: 'web_search', phase: 'started' };\n      } else if (eventName === 'response.web_search_call.completed') {\n        yield { type: 'tool-event', toolType: 'web_search', phase: 'completed' };\n      } else if (eventName === 'response.output_item.added') {\n        const payload = validateEventPayload(\n          parseSseEventJson(message.data),\n          responsesOutputItemAddedPayload\n        );\n        /* c8 ignore next 1 - defensive: payload null branch unreachable after validation */\n        const item = payload?.item;\n        /* c8 ignore next 1 - defensive: falsy call_id/name branches are protocol violations */\n        if (item?.type === 'function_call' && item.call_id && item.name) {\n          functionCallMap.set(item.call_id, { id: item.call_id, name: item.name, argsBuffer: '' });\n          // Reasoning models (and the standard flow) reference this function_call in subsequent\n          // arguments.{delta,done} events by `item_id`, never by `call_id`. Record the mapping\n          // so the arg-accumulation handlers can resolve the call.\n          if (item.id) {\n            itemIdToCallId.set(item.id, item.call_id);\n          }\n          yield { type: 'client-tool-call-start', toolName: item.name, callId: item.call_id };\n        }\n      } else if (eventName === 'response.function_call_arguments.delta') {\n        const payload = validateEventPayload(\n          parseSseEventJson(message.data),\n          responsesFunctionCallArgsDeltaPayload\n        );\n        /* c8 ignore next 1 - defensive: payload null branch unreachable after validation */\n        const itemId = payload?.item_id;\n        if (itemId !== undefined) {\n          const callId = itemIdToCallId.get(itemId);\n          /* c8 ignore next 1 - defensive: orphan delta (no preceding output_item.added) is a protocol violation */\n          const call = callId !== undefined ? functionCallMap.get(callId) : undefined;\n          /* c8 ignore next 1 - defensive: call always present and delta always string in valid stream */\n          if (call && typeof payload?.delta === 'string') {\n            call.argsBuffer += payload.delta;\n          }\n        }\n      } else if (eventName === 'response.function_call_arguments.done') {\n        const payload = validateEventPayload(\n          parseSseEventJson(message.data),\n          responsesFunctionCallArgsDonePayload\n        );\n        /* c8 ignore next 1 - defensive: payload null branch unreachable after validation */\n        const itemId = payload?.item_id;\n        if (itemId !== undefined) {\n          const callId = itemIdToCallId.get(itemId);\n          /* c8 ignore next 1 - defensive: orphan done (no preceding output_item.added) is a protocol violation */\n          const call = callId !== undefined ? functionCallMap.get(callId) : undefined;\n          if (call && callId !== undefined) {\n            /* c8 ignore next 1 - defensive: payload?.arguments null branch unreachable after validation */\n            const canonicalArgs = payload?.arguments ?? '{}';\n            // Sync the accumulation entry with the canonical arguments from the .done event.\n            // Delta events may carry partial/empty payloads; the .done event carries the\n            // authoritative final arguments string used by the continuation builder.\n            call.argsBuffer = canonicalArgs;\n            let args: JsonObject;\n            try {\n              const parsed = JSON.parse(canonicalArgs) as unknown;\n              /* c8 ignore start - defensive: non-object/malformed parse defaults to empty object */\n              args =\n                parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)\n                  ? (parsed as JsonObject)\n                  : {};\n            } catch {\n              args = {};\n            }\n            /* c8 ignore stop */\n            yield { type: 'client-tool-call-done', toolName: call.name, callId, args };\n          }\n        }\n      } else if (eventName === 'response.completed') {\n        const payload = validateEventPayload(parseSseEventJson(message.data), responsesCompletedPayload);\n        /* c8 ignore next 1 - defensive: payload null branch unreachable after validation */\n        if (payload) {\n          truncated = payload.response.status === 'incomplete';\n          // Per IAiStreamDone.incompleteReason's contract, the reason is meaningful only\n          // when the response was truncated. Move both fields together on every completed\n          // event so a stray incomplete_details on a non-incomplete payload never leaks\n          // through, and a later (defensive) completed event can't leave a stale reason.\n          incompleteReason = truncated ? payload.response.incomplete_details?.reason : undefined;\n        }\n        completed = true;\n        /* c8 ignore next 1 - defensive: eventName === 'error' alternative not exercised in tests */\n      } else if (eventName === 'response.failed' || eventName === 'error') {\n        const payload = validateEventPayload(parseSseEventJson(message.data), responsesErrorPayload);\n        /* c8 ignore next 1 - defensive: payload?.error and payload?.message null branches unreachable */\n        const errMsg = payload?.error?.message ?? payload?.message ?? 'Responses API stream failed';\n        yield { type: 'error', message: errMsg };\n        return;\n      } else if (\n        typeof eventName === 'string' &&\n        !RECOGNIZED_OPENAI_RESPONSES_EVENTS.has(eventName) &&\n        !warnedEvents.has(eventName)\n      ) {\n        // Empirical drift instrument: an unrecognized SSE event from the Responses API\n        // surfaces as a one-time warning per stream. If a provider adds a new event type\n        // (or changes an existing event's name), the warning fires the first time the\n        // event arrives. Update RECOGNIZED_OPENAI_RESPONSES_EVENTS once the new event is\n        // either handled or confirmed safe to ignore.\n        warnedEvents.add(eventName);\n        logger?.warn(\n          `${UNRECOGNIZED_EVENT_WARN_TAG} OpenAI Responses adapter: unrecognized SSE event ` +\n            `'${eventName}'. ` +\n            `payload preview: ${formatUnrecognizedEventPayloadPreview(message.data)}. ` +\n            `This may indicate provider drift — if the new event carries data the adapter ` +\n            `should surface, add a handler; otherwise add the name to ` +\n            `RECOGNIZED_OPENAI_RESPONSES_EVENTS.`\n        );\n      }\n    }\n  } catch (err: unknown) /* c8 ignore start - defensive: stream errors are always Error instances */ {\n    yield { type: 'error', message: err instanceof Error ? err.message : String(err) };\n    return;\n  } /* c8 ignore stop */\n\n  if (completed) {\n    yield { type: 'done', truncated, fullText, incompleteReason };\n  } else {\n    yield { type: 'error', message: 'Responses API stream ended without a completed event' };\n  }\n}\n\n// ============================================================================\n// Per-format request caller\n// ============================================================================\n\n/**\n * Issues a streaming Responses API request (with tools) and returns the\n * unified-event iterable on success.\n *\n * @internal\n */\nexport async function callOpenAiResponsesStream(\n  config: IStreamApiConfig,\n  prompt: AiPrompt,\n  tools: ReadonlyArray<AiToolConfig> = [],\n  messagesBefore: ReadonlyArray<IChatMessage> | undefined,\n  temperature: number | undefined,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal,\n  resolvedThinking?: IResolvedThinkingConfig,\n  functionCallMap?: Map<string, IAccumulatedFunctionCall>,\n  continuationMessages?: ReadonlyArray<JsonObject>\n): Promise<Result<AsyncIterable<IAiStreamEvent>>> {\n  const url = `${config.baseUrl}/responses`;\n  const input = buildMessages(prompt.system, buildOpenAiResponsesUserContent(prompt), {\n    head: messagesBefore,\n    rawTail: continuationMessages\n  });\n  const effort = resolvedThinking?.openAiEffort ?? resolvedThinking?.xaiEffort;\n  const supportsReasoning = config.model !== 'grok-4';\n  const body: Record<string, unknown> = {\n    model: config.model,\n    input,\n    stream: true\n  };\n  // `tools` is omitted entirely when none are requested — a Responses-only model routed\n  // here for tier/model reasons (not tools) must not send an empty tools array.\n  if (tools.length > 0) {\n    body.tools = toResponsesApiTools(tools);\n  }\n  if (effort !== undefined && supportsReasoning) {\n    body.reasoning = { effort };\n  }\n  // Temperature is sent only when the caller explicitly provided one (see callOpenAiChatStream).\n  if (effort === undefined || effort === 'none') {\n    if (temperature !== undefined) {\n      body.temperature = temperature;\n    }\n  }\n  if (resolvedThinking?.otherParams !== undefined) {\n    Object.assign(body, resolvedThinking.otherParams);\n  }\n  const headers: Record<string, string> = bearerAuthHeader(config.apiKey);\n  /* c8 ignore next 3 - optional logger */\n  logger?.info(\n    `OpenAI Responses streaming: model=${config.model}, tools=${tools.map((t) => t.type).join(',')}`\n  );\n  const callMap = functionCallMap ?? new Map<string, IAccumulatedFunctionCall>();\n  const conn = await openSseConnection(url, headers, body, logger, signal);\n  return conn.onSuccess((response) => succeed(translateOpenAiResponsesStream(response, callMap, logger)));\n}\n"]}

package/lib/packlets/ai-assist/streamingAdapters/proxy.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Streaming adapter for a caller-provided proxy server. Unlike the
+ * provider-specific adapters, the proxy speaks our own unified vocabulary
+ * directly: each `data:` line is a JSON-serialized {@link AiAssist.IAiStreamEvent},
+ * so this adapter only validates the event-type discriminator and forwards.
+ *
+ * @packageDocumentation
+ */
+import { Result } from '@fgv/ts-utils';
+import { type IAiStreamEvent } from '../model';
+import { IProviderCompletionStreamParams } from './common';
+/**
+ * Calls the streaming chat endpoint on a proxy server instead of calling
+ * the provider directly from the browser.
+ *
+ * @remarks
+ * Proxy contract:
+ * - Endpoint: `POST ${proxyUrl}/api/ai/completion-stream`
+ * - Request body: same JSON as `/api/ai/completion` plus `"stream": true`
+ * - Response: `Content-Type: text/event-stream`; body is the unified
+ *   {@link AiAssist.IAiStreamEvent} JSON-serialized one event per SSE `data:` line
+ *   (no `event:` line needed since the type discriminator is in the JSON).
+ * - Error response (when the proxy can't even start): JSON `{error: string}`
+ *   with a non-2xx status, surfaced as `proxy: ${error}`.
+ *
+ * The proxy server is responsible for opening the upstream SSE connection,
+ * translating provider-native events to the unified vocabulary, and
+ * forwarding events as they arrive (no buffering). The library does not
+ * ship a proxy implementation.
+ *
+ * @public
+ */
+export declare function callProxiedCompletionStream(proxyUrl: string, params: IProviderCompletionStreamParams): Promise<Result<AsyncIterable<IAiStreamEvent>>>;
+//# sourceMappingURL=proxy.d.ts.map

package/lib/packlets/ai-assist/streamingAdapters/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../../../src/packlets/ai-assist/streamingAdapters/proxy.ts"],"names":[],"mappings":"AAoBA;;;;;;;GAOG;AAEH,OAAO,EAAQ,MAAM,EAAuC,MAAM,eAAe,CAAC;AAGlF,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAAE,+BAA+B,EAA2C,MAAM,UAAU,CAAC;AAkEpG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAuDhD"}