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

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

@@ -0,0 +1,207 @@
+"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.callGeminiStream = callGeminiStream;
+/**
+ * Streaming adapter for Gemini's `streamGenerateContent` endpoint. Gemini
+ * emits no explicit tool-progress events even when `google_search` is
+ * enabled — grounding metadata arrives attached to text chunks — so this
+ * adapter never yields `tool-event`s.
+ *
+ * Client-defined tools (`functionCall` parts) are emitted as
+ * `client-tool-call-done` immediately (no delta accumulation needed for Gemini).
+ *
+ * @packageDocumentation
+ */
+const ts_utils_1 = require("@fgv/ts-utils");
+const ts_json_base_1 = require("@fgv/ts-json-base");
+const chatRequestBuilders_1 = require("../chatRequestBuilders");
+const sseParser_1 = require("../sseParser");
+const toolFormats_1 = require("../toolFormats");
+const common_1 = require("./common");
+const jsonObjectValidator = ts_utils_1.Validators.isA('JsonObject', (v) => (0, ts_json_base_1.isJsonObject)(v));
+const geminiFunctionCallInner = ts_utils_1.Validators.object({
+    name: ts_utils_1.Validators.string.optional(),
+    args: jsonObjectValidator.optional()
+}, { options: { optionalFields: ['name', 'args'] } });
+const geminiStreamPart = ts_utils_1.Validators.object({
+    text: ts_utils_1.Validators.string.optional(),
+    functionCall: geminiFunctionCallInner.optional(),
+    thoughtSignature: ts_utils_1.Validators.string.optional()
+}, { options: { optionalFields: ['text', 'functionCall', 'thoughtSignature'] } });
+const geminiStreamContent = ts_utils_1.Validators.object({ parts: ts_utils_1.Validators.arrayOf(geminiStreamPart).optional() }, { options: { optionalFields: ['parts'] } });
+const geminiStreamCandidate = ts_utils_1.Validators.object({
+    content: geminiStreamContent.optional(),
+    finishReason: ts_utils_1.Validators.string.optional()
+}, { options: { optionalFields: ['content', 'finishReason'] } });
+const geminiStreamChunk = ts_utils_1.Validators.object({
+    candidates: ts_utils_1.Validators.arrayOf(geminiStreamCandidate)
+});
+// ============================================================================
+// Stream translator
+// ============================================================================
+/**
+ * Translates a Gemini streamGenerateContent SSE stream into unified events.
+ *
+ * @internal
+ */
+function translateGeminiStream(response, functionCalls) {
+    return __asyncGenerator(this, arguments, function* translateGeminiStream_1() {
+        var _a, e_1, _b, _c;
+        var _d, _e;
+        let fullText = '';
+        let truncated = false;
+        let receivedFinishReason = false;
+        try {
+            /* c8 ignore next - body is non-null at this point per openSseConnection */
+            if (!response.body)
+                return yield __await(void 0);
+            try {
+                for (var _f = true, _g = __asyncValues((0, sseParser_1.readSseEvents)(response.body)), _h; _h = yield __await(_g.next()), _a = _h.done, !_a; _f = true) {
+                    _c = _h.value;
+                    _f = false;
+                    const message = _c;
+                    const json = (0, sseParser_1.parseSseEventJson)(message.data);
+                    /* c8 ignore next 3 - defensive: malformed SSE events skipped */
+                    if (json === undefined) {
+                        continue;
+                    }
+                    const chunk = (0, common_1.validateEventPayload)(json, geminiStreamChunk);
+                    /* c8 ignore next 1 - defensive: chunk?.candidates optional chain unreachable after validation */
+                    const candidate = chunk === null || chunk === void 0 ? void 0 : chunk.candidates[0];
+                    /* c8 ignore next 3 - defensive: SSE events without candidates skipped */
+                    if (!candidate) {
+                        continue;
+                    }
+                    /* c8 ignore next 1 - defensive: candidate.content?.parts null branch unreachable after validation */
+                    const parts = (_d = candidate.content) === null || _d === void 0 ? void 0 : _d.parts;
+                    if (parts) {
+                        for (const part of parts) {
+                            if (typeof part.text === 'string' && part.text.length > 0) {
+                                fullText += part.text;
+                                yield yield __await({ type: 'text-delta', delta: part.text });
+                                /* c8 ignore next 1 - defensive: functionCall parts without a `name` are silently dropped (cannot construct a continuation builder entry without one) */
+                            }
+                            else if ((_e = part.functionCall) === null || _e === void 0 ? void 0 : _e.name) {
+                                const { name, args } = part.functionCall;
+                                /* c8 ignore next 1 - defensive: Gemini always sends args; {} fallback unreachable in practice */
+                                const callArgs = args !== null && args !== void 0 ? args : {};
+                                // Capture the part-level thoughtSignature (sibling of functionCall) so the
+                                // continuation builder can replay it on the model turn. Reads as undefined
+                                // when thinking is disabled; the builder omits the key in that case.
+                                functionCalls.push({ name, args: callArgs, thoughtSignature: part.thoughtSignature });
+                                yield yield __await({ type: 'client-tool-call-done', toolName: name, args: callArgs });
+                            }
+                        }
+                    }
+                    const finishReason = candidate.finishReason;
+                    if (typeof finishReason === 'string' && finishReason.length > 0) {
+                        truncated = finishReason === 'MAX_TOKENS';
+                        receivedFinishReason = true;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_f && !_a && (_b = _g.return)) yield __await(_b.call(_g));
+                }
+                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 (receivedFinishReason) {
+            yield yield __await({ type: 'done', truncated, fullText });
+        }
+        else {
+            yield yield __await({ type: 'error', message: 'Gemini stream ended without a finishReason' });
+        }
+    });
+}
+// ============================================================================
+// Per-format request caller
+// ============================================================================
+/**
+ * Issues a streaming Gemini request and returns the unified-event iterable
+ * on success.
+ *
+ * @internal
+ */
+async function callGeminiStream(config, prompt, messagesBefore, temperature, tools, logger, signal, resolvedThinking, functionCalls, continuationMessages) {
+    const url = `${config.baseUrl}/models/${config.model}:streamGenerateContent?alt=sse`;
+    const contents = (0, chatRequestBuilders_1.buildGeminiContents)(prompt, {
+        head: messagesBefore,
+        rawTail: continuationMessages
+    });
+    // Temperature is sent only when explicitly provided; otherwise Gemini's default applies.
+    const generationConfig = {};
+    if (temperature !== undefined) {
+        generationConfig.temperature = temperature;
+    }
+    if ((resolvedThinking === null || resolvedThinking === void 0 ? void 0 : resolvedThinking.geminiThinkingBudget) !== undefined) {
+        generationConfig.thinkingConfig = { thinkingBudget: resolvedThinking.geminiThinkingBudget };
+    }
+    if ((resolvedThinking === null || resolvedThinking === void 0 ? void 0 : resolvedThinking.otherParams) !== undefined) {
+        Object.assign(generationConfig, resolvedThinking.otherParams);
+    }
+    const body = {
+        systemInstruction: { parts: [{ text: prompt.system }] },
+        contents,
+        generationConfig
+    };
+    /* c8 ignore next 3 - tools branch not exercised in streaming tests */
+    if (tools && tools.length > 0) {
+        body.tools = (0, toolFormats_1.toGeminiTools)(tools);
+    }
+    const headers = { 'x-goog-api-key': config.apiKey };
+    /* c8 ignore next 4 - optional logger diagnostic output */
+    if (logger) {
+        const toolTypes = tools && tools.length > 0 ? tools.map((t) => t.type).join(',') : 'none';
+        logger.info(`Gemini streaming: model=${config.model}, tools=${toolTypes}`);
+    }
+    const calls = functionCalls !== null && functionCalls !== void 0 ? functionCalls : [];
+    const conn = await (0, common_1.openSseConnection)(url, headers, body, logger, signal);
+    return conn.onSuccess((response) => (0, ts_utils_1.succeed)(translateGeminiStream(response, calls)));
+}
+//# sourceMappingURL=gemini.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../../../src/packlets/ai-assist/streamingAdapters/gemini.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 Gemini's `streamGenerateContent` endpoint. Gemini\n * emits no explicit tool-progress events even when `google_search` is\n * enabled — grounding metadata arrives attached to text chunks — so this\n * adapter never yields `tool-event`s.\n *\n * Client-defined tools (`functionCall` parts) are emitted as\n * `client-tool-call-done` immediately (no delta accumulation needed for Gemini).\n *\n * @packageDocumentation\n */\n\nimport { type Logging, Result, succeed, type Validator, Validators } from '@fgv/ts-utils';\nimport { isJsonObject, type JsonObject } from '@fgv/ts-json-base';\n\nimport { buildGeminiContents } from '../chatRequestBuilders';\nimport { AiPrompt, type AiToolConfig, type IAiStreamEvent, type IChatMessage } from '../model';\nimport { parseSseEventJson, readSseEvents } from '../sseParser';\nimport { toGeminiTools } from '../toolFormats';\nimport { type IResolvedThinkingConfig } from '../thinkingOptionsResolver';\nimport { IStreamApiConfig, openSseConnection, validateEventPayload } from './common';\n\n// ============================================================================\n// Accumulated call state (internal — used by C3 continuation builder)\n// ============================================================================\n\n/**\n * An accumulated function call from a Gemini stream. Gemini does not assign\n * call IDs; correlation is by tool name. Arguments arrive complete in the\n * `functionCall` part (no delta accumulation).\n * @internal\n */\nexport interface IAccumulatedGeminiFunctionCall {\n  readonly name: string;\n  readonly args: JsonObject;\n  /**\n   * The opaque thought signature Gemini stamps on a `functionCall` part when\n   * thinking is enabled. It must be echoed back, verbatim, on the continuation's\n   * model turn alongside the `functionCall`, or Gemini rejects the follow-up with\n   * \"Function call is missing a thought_signature in functionCall parts\".\n   * Absent when thinking is disabled. See\n   * https://ai.google.dev/gemini-api/docs/thought-signatures.\n   */\n  readonly thoughtSignature?: string;\n}\n\n// ============================================================================\n// Event payload shapes\n// ============================================================================\n\n/**\n * One `parts[]` element in a Gemini streaming chunk. Text parts and\n * functionCall parts are both surfaced.\n * @internal\n */\ninterface IGeminiStreamPart {\n  readonly text?: string;\n  readonly functionCall?: { readonly name?: string; readonly args?: JsonObject };\n  /**\n   * The opaque thought signature attached to a `functionCall` part when thinking\n   * is enabled. A sibling of `functionCall`/`text` at the part level (base64\n   * string). Captured for replay on the continuation's model turn.\n   */\n  readonly thoughtSignature?: string;\n}\n\n/**\n * One `candidates[]` element in a Gemini streaming chunk.\n * @internal\n */\ninterface IGeminiStreamCandidate {\n  readonly content?: { readonly parts?: ReadonlyArray<IGeminiStreamPart> };\n  readonly finishReason?: string;\n}\n\n/**\n * One streaming chunk from `streamGenerateContent?alt=sse`.\n * @internal\n */\ninterface IGeminiStreamChunk {\n  readonly candidates: ReadonlyArray<IGeminiStreamCandidate>;\n}\n\nconst jsonObjectValidator: Validator<JsonObject> = Validators.isA<JsonObject>(\n  'JsonObject',\n  (v): v is JsonObject => isJsonObject(v)\n);\n\nconst geminiFunctionCallInner: Validator<{ name?: string; args?: JsonObject }> = Validators.object<{\n  name?: string;\n  args?: JsonObject;\n}>(\n  {\n    name: Validators.string.optional(),\n    args: jsonObjectValidator.optional()\n  },\n  { options: { optionalFields: ['name', 'args'] } }\n);\n\nconst geminiStreamPart: Validator<IGeminiStreamPart> = Validators.object<IGeminiStreamPart>(\n  {\n    text: Validators.string.optional(),\n    functionCall: geminiFunctionCallInner.optional(),\n    thoughtSignature: Validators.string.optional()\n  },\n  { options: { optionalFields: ['text', 'functionCall', 'thoughtSignature'] } }\n);\n\nconst geminiStreamContent: Validator<{ parts?: ReadonlyArray<IGeminiStreamPart> }> = Validators.object<{\n  parts?: ReadonlyArray<IGeminiStreamPart>;\n}>({ parts: Validators.arrayOf(geminiStreamPart).optional() }, { options: { optionalFields: ['parts'] } });\n\nconst geminiStreamCandidate: Validator<IGeminiStreamCandidate> = Validators.object<IGeminiStreamCandidate>(\n  {\n    content: geminiStreamContent.optional(),\n    finishReason: Validators.string.optional()\n  },\n  { options: { optionalFields: ['content', 'finishReason'] } }\n);\n\nconst geminiStreamChunk: Validator<IGeminiStreamChunk> = Validators.object<IGeminiStreamChunk>({\n  candidates: Validators.arrayOf(geminiStreamCandidate)\n});\n\n// ============================================================================\n// Stream translator\n// ============================================================================\n\n/**\n * Translates a Gemini streamGenerateContent SSE stream into unified events.\n *\n * @internal\n */\nasync function* translateGeminiStream(\n  response: Response,\n  functionCalls: IAccumulatedGeminiFunctionCall[]\n): AsyncGenerator<IAiStreamEvent> {\n  let fullText = '';\n  let truncated = false;\n  let receivedFinishReason = false;\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 json = parseSseEventJson(message.data);\n      /* c8 ignore next 3 - defensive: malformed SSE events skipped */\n      if (json === undefined) {\n        continue;\n      }\n      const chunk = validateEventPayload(json, geminiStreamChunk);\n      /* c8 ignore next 1 - defensive: chunk?.candidates optional chain unreachable after validation */\n      const candidate = chunk?.candidates[0];\n      /* c8 ignore next 3 - defensive: SSE events without candidates skipped */\n      if (!candidate) {\n        continue;\n      }\n      /* c8 ignore next 1 - defensive: candidate.content?.parts null branch unreachable after validation */\n      const parts = candidate.content?.parts;\n      if (parts) {\n        for (const part of parts) {\n          if (typeof part.text === 'string' && part.text.length > 0) {\n            fullText += part.text;\n            yield { type: 'text-delta', delta: part.text };\n            /* c8 ignore next 1 - defensive: functionCall parts without a `name` are silently dropped (cannot construct a continuation builder entry without one) */\n          } else if (part.functionCall?.name) {\n            const { name, args } = part.functionCall;\n            /* c8 ignore next 1 - defensive: Gemini always sends args; {} fallback unreachable in practice */\n            const callArgs = args ?? {};\n            // Capture the part-level thoughtSignature (sibling of functionCall) so the\n            // continuation builder can replay it on the model turn. Reads as undefined\n            // when thinking is disabled; the builder omits the key in that case.\n            functionCalls.push({ name, args: callArgs, thoughtSignature: part.thoughtSignature });\n            yield { type: 'client-tool-call-done', toolName: name, args: callArgs };\n          }\n        }\n      }\n      const finishReason = candidate.finishReason;\n      if (typeof finishReason === 'string' && finishReason.length > 0) {\n        truncated = finishReason === 'MAX_TOKENS';\n        receivedFinishReason = true;\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 (receivedFinishReason) {\n    yield { type: 'done', truncated, fullText };\n  } else {\n    yield { type: 'error', message: 'Gemini stream ended without a finishReason' };\n  }\n}\n\n// ============================================================================\n// Per-format request caller\n// ============================================================================\n\n/**\n * Issues a streaming Gemini request and returns the unified-event iterable\n * on success.\n *\n * @internal\n */\nexport async function callGeminiStream(\n  config: IStreamApiConfig,\n  prompt: AiPrompt,\n  messagesBefore: ReadonlyArray<IChatMessage> | undefined,\n  temperature: number | undefined,\n  tools: ReadonlyArray<AiToolConfig> | undefined,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal,\n  resolvedThinking?: IResolvedThinkingConfig,\n  functionCalls?: IAccumulatedGeminiFunctionCall[],\n  continuationMessages?: ReadonlyArray<JsonObject>\n): Promise<Result<AsyncIterable<IAiStreamEvent>>> {\n  const url = `${config.baseUrl}/models/${config.model}:streamGenerateContent?alt=sse`;\n  const contents = buildGeminiContents(prompt, {\n    head: messagesBefore,\n    rawTail: continuationMessages\n  });\n  // Temperature is sent only when explicitly provided; otherwise Gemini's default applies.\n  const generationConfig: Record<string, unknown> = {};\n  if (temperature !== undefined) {\n    generationConfig.temperature = temperature;\n  }\n  if (resolvedThinking?.geminiThinkingBudget !== undefined) {\n    generationConfig.thinkingConfig = { thinkingBudget: resolvedThinking.geminiThinkingBudget };\n  }\n  if (resolvedThinking?.otherParams !== undefined) {\n    Object.assign(generationConfig, resolvedThinking.otherParams);\n  }\n  const body: Record<string, unknown> = {\n    systemInstruction: { parts: [{ text: prompt.system }] },\n    contents,\n    generationConfig\n  };\n  /* c8 ignore next 3 - tools branch not exercised in streaming tests */\n  if (tools && tools.length > 0) {\n    body.tools = toGeminiTools(tools);\n  }\n  const headers: Record<string, string> = { 'x-goog-api-key': config.apiKey };\n  /* c8 ignore next 4 - optional logger diagnostic output */\n  if (logger) {\n    const toolTypes = tools && tools.length > 0 ? tools.map((t) => t.type).join(',') : 'none';\n    logger.info(`Gemini streaming: model=${config.model}, tools=${toolTypes}`);\n  }\n  const calls = functionCalls ?? [];\n  const conn = await openSseConnection(url, headers, body, logger, signal);\n  return conn.onSuccess((response) => succeed(translateGeminiStream(response, calls)));\n}\n"]}

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

@@ -0,0 +1,19 @@
+/**
+ * Streaming adapter for OpenAI Chat Completions (also used for Groq, Mistral,
+ * and other Chat-Completions-compatible providers when no tools are
+ * requested).
+ *
+ * @packageDocumentation
+ */
+import { type Logging, Result } from '@fgv/ts-utils';
+import { AiPrompt, type IAiStreamEvent, type IChatMessage } from '../model';
+import { type IResolvedThinkingConfig } from '../thinkingOptionsResolver';
+import { IStreamApiConfig } from './common';
+/**
+ * Issues a streaming Chat Completions request and returns the unified-event
+ * iterable on success.
+ *
+ * @internal
+ */
+export declare function callOpenAiChatStream(config: IStreamApiConfig, prompt: AiPrompt, messagesBefore: ReadonlyArray<IChatMessage> | undefined, temperature: number | undefined, logger?: Logging.ILogger, signal?: AbortSignal, resolvedThinking?: IResolvedThinkingConfig): Promise<Result<AsyncIterable<IAiStreamEvent>>>;
+//# sourceMappingURL=openaiChat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openaiChat.d.ts","sourceRoot":"","sources":["../../../../src/packlets/ai-assist/streamingAdapters/openaiChat.ts"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,EAAuC,MAAM,eAAe,CAAC;AAI1F,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE5E,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAA2C,MAAM,UAAU,CAAC;AA+GrF;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,QAAQ,EAChB,cAAc,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,SAAS,EACvD,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,EACxB,MAAM,CAAC,EAAE,WAAW,EACpB,gBAAgB,CAAC,EAAE,uBAAuB,GACzC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CA2BhD"}

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

@@ -0,0 +1,173 @@
+"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.callOpenAiChatStream = callOpenAiChatStream;
+/**
+ * Streaming adapter for OpenAI Chat Completions (also used for Groq, Mistral,
+ * and other Chat-Completions-compatible providers when no tools are
+ * requested).
+ *
+ * @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 common_1 = require("./common");
+// eslint-disable-next-line @rushstack/no-new-null
+const stringOrNull = ts_utils_1.Validators.isA('string-or-null', 
+// eslint-disable-next-line @rushstack/no-new-null
+(v) => typeof v === 'string' || v === null);
+const openAiChatStreamChoice = ts_utils_1.Validators.object({
+    delta: ts_utils_1.Validators.object({ content: ts_utils_1.Validators.string }, { options: { optionalFields: ['content'] } }).optional(),
+    finish_reason: stringOrNull.optional()
+}, { options: { optionalFields: ['delta', 'finish_reason'] } });
+const openAiChatStreamChunk = ts_utils_1.Validators.object({
+    choices: ts_utils_1.Validators.arrayOf(openAiChatStreamChoice)
+});
+// ============================================================================
+// Stream translator
+// ============================================================================
+/**
+ * Translates an OpenAI Chat Completions SSE stream into unified events.
+ *
+ * @internal
+ */
+function translateOpenAiChatStream(response) {
+    return __asyncGenerator(this, arguments, function* translateOpenAiChatStream_1() {
+        var _a, e_1, _b, _c;
+        var _d;
+        let fullText = '';
+        let truncated = false;
+        let receivedDone = false;
+        try {
+            /* c8 ignore next - body is non-null at this point per openSseConnection */
+            if (!response.body)
+                return yield __await(void 0);
+            try {
+                for (var _e = true, _f = __asyncValues((0, sseParser_1.readSseEvents)(response.body)), _g; _g = yield __await(_f.next()), _a = _g.done, !_a; _e = true) {
+                    _c = _g.value;
+                    _e = false;
+                    const message = _c;
+                    const json = (0, sseParser_1.parseSseEventJson)(message.data);
+                    if (json === undefined) {
+                        // [DONE] sentinel or unparseable; skip
+                        continue;
+                    }
+                    const chunk = (0, common_1.validateEventPayload)(json, openAiChatStreamChunk);
+                    /* c8 ignore next 1 - defensive: chunk?.choices optional chain unreachable after validation */
+                    const choice = chunk === null || chunk === void 0 ? void 0 : chunk.choices[0];
+                    /* c8 ignore next 3 - defensive: SSE events without choices are skipped */
+                    if (!choice) {
+                        continue;
+                    }
+                    /* c8 ignore next 1 - defensive: choice.delta?.content optional chain unreachable after validation */
+                    const delta = (_d = choice.delta) === null || _d === void 0 ? void 0 : _d.content;
+                    if (typeof delta === 'string' && delta.length > 0) {
+                        fullText += delta;
+                        yield yield __await({ type: 'text-delta', delta });
+                    }
+                    const finish = choice.finish_reason;
+                    if (typeof finish === 'string' && finish.length > 0) {
+                        truncated = finish === 'length';
+                        receivedDone = true;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_e && !_a && (_b = _f.return)) yield __await(_b.call(_f));
+                }
+                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 (receivedDone) {
+            yield yield __await({ type: 'done', truncated, fullText });
+        }
+        else {
+            yield yield __await({ type: 'error', message: 'OpenAI stream ended without a finish_reason' });
+        }
+    });
+}
+// ============================================================================
+// Per-format request caller
+// ============================================================================
+/**
+ * Issues a streaming Chat Completions request and returns the unified-event
+ * iterable on success.
+ *
+ * @internal
+ */
+async function callOpenAiChatStream(config, prompt, messagesBefore, temperature, logger, signal, resolvedThinking) {
+    var _a;
+    const url = `${config.baseUrl}/chat/completions`;
+    const messages = (0, chatRequestBuilders_1.buildMessages)(prompt.system, (0, chatRequestBuilders_1.buildOpenAiChatUserContent)(prompt), {
+        head: messagesBefore
+    });
+    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, messages, stream: true };
+    if (effort !== undefined && supportsReasoning) {
+        body.reasoning_effort = effort;
+    }
+    // Temperature is sent only when the caller explicitly provided one; omitting it lets the
+    // provider apply its own default (current-gen models reject a caller-supplied default). This
+    // adapter is reached only via the conflict-guarded streaming entry point — the client-tool path
+    // routes OpenAI through the Responses adapter, not chat — so, like callOpenAiCompletion, no
+    // effort gate is needed: temperature is present here only when the effort is undefined/'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 1 - optional logger */
+    logger === null || logger === void 0 ? void 0 : logger.info(`OpenAI streaming completion: model=${config.model}`);
+    const conn = await (0, common_1.openSseConnection)(url, headers, body, logger, signal);
+    return conn.onSuccess((response) => (0, ts_utils_1.succeed)(translateOpenAiChatStream(response)));
+}
+//# sourceMappingURL=openaiChat.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openaiChat.js","sourceRoot":"","sources":["../../../../src/packlets/ai-assist/streamingAdapters/openaiChat.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 OpenAI Chat Completions (also used for Groq, Mistral,\n * and other Chat-Completions-compatible providers when no tools are\n * requested).\n *\n * @packageDocumentation\n */\n\nimport { type Logging, Result, succeed, type Validator, Validators } from '@fgv/ts-utils';\n\nimport { buildMessages, buildOpenAiChatUserContent } from '../chatRequestBuilders';\nimport { bearerAuthHeader } from '../endpoint';\nimport { AiPrompt, type IAiStreamEvent, type IChatMessage } from '../model';\nimport { parseSseEventJson, readSseEvents } from '../sseParser';\nimport { type IResolvedThinkingConfig } from '../thinkingOptionsResolver';\nimport { IStreamApiConfig, openSseConnection, validateEventPayload } from './common';\n\n// ============================================================================\n// Event payload shapes\n// ============================================================================\n\n/**\n * The shape of `choices[0]` in an OpenAI Chat Completions streaming chunk.\n * Both `delta.content` and `finish_reason` are optional — content arrives in\n * intermediate chunks, finish_reason in the terminal chunk. The wire sends\n * `finish_reason: null` (literal null, not absent) on intermediate chunks,\n * so the validator must accept null alongside string.\n *\n * @internal\n */\ninterface IOpenAiChatStreamChoice {\n  readonly delta?: { readonly content?: string };\n  // eslint-disable-next-line @rushstack/no-new-null\n  readonly finish_reason?: string | null;\n}\n\n/**\n * One streaming chunk from the OpenAI Chat Completions endpoint. Always has\n * a `choices` array with one element in the streaming mode.\n *\n * @internal\n */\ninterface IOpenAiChatStreamChunk {\n  readonly choices: ReadonlyArray<IOpenAiChatStreamChoice>;\n}\n\n// eslint-disable-next-line @rushstack/no-new-null\nconst stringOrNull: Validator<string | null> = Validators.isA<string | null>(\n  'string-or-null',\n  // eslint-disable-next-line @rushstack/no-new-null\n  (v: unknown): v is string | null => typeof v === 'string' || v === null\n);\n\nconst openAiChatStreamChoice: Validator<IOpenAiChatStreamChoice> = Validators.object<IOpenAiChatStreamChoice>(\n  {\n    delta: Validators.object<{ content?: string }>(\n      { content: Validators.string },\n      { options: { optionalFields: ['content'] } }\n    ).optional(),\n    finish_reason: stringOrNull.optional()\n  },\n  { options: { optionalFields: ['delta', 'finish_reason'] } }\n);\n\nconst openAiChatStreamChunk: Validator<IOpenAiChatStreamChunk> = Validators.object<IOpenAiChatStreamChunk>({\n  choices: Validators.arrayOf(openAiChatStreamChoice)\n});\n\n// ============================================================================\n// Stream translator\n// ============================================================================\n\n/**\n * Translates an OpenAI Chat Completions SSE stream into unified events.\n *\n * @internal\n */\nasync function* translateOpenAiChatStream(response: Response): AsyncGenerator<IAiStreamEvent> {\n  let fullText = '';\n  let truncated = false;\n  let receivedDone = false;\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 json = parseSseEventJson(message.data);\n      if (json === undefined) {\n        // [DONE] sentinel or unparseable; skip\n        continue;\n      }\n      const chunk = validateEventPayload(json, openAiChatStreamChunk);\n      /* c8 ignore next 1 - defensive: chunk?.choices optional chain unreachable after validation */\n      const choice = chunk?.choices[0];\n      /* c8 ignore next 3 - defensive: SSE events without choices are skipped */\n      if (!choice) {\n        continue;\n      }\n      /* c8 ignore next 1 - defensive: choice.delta?.content optional chain unreachable after validation */\n      const delta = choice.delta?.content;\n      if (typeof delta === 'string' && delta.length > 0) {\n        fullText += delta;\n        yield { type: 'text-delta', delta };\n      }\n      const finish = choice.finish_reason;\n      if (typeof finish === 'string' && finish.length > 0) {\n        truncated = finish === 'length';\n        receivedDone = true;\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 (receivedDone) {\n    yield { type: 'done', truncated, fullText };\n  } else {\n    yield { type: 'error', message: 'OpenAI stream ended without a finish_reason' };\n  }\n}\n\n// ============================================================================\n// Per-format request caller\n// ============================================================================\n\n/**\n * Issues a streaming Chat Completions request and returns the unified-event\n * iterable on success.\n *\n * @internal\n */\nexport async function callOpenAiChatStream(\n  config: IStreamApiConfig,\n  prompt: AiPrompt,\n  messagesBefore: ReadonlyArray<IChatMessage> | undefined,\n  temperature: number | undefined,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal,\n  resolvedThinking?: IResolvedThinkingConfig\n): Promise<Result<AsyncIterable<IAiStreamEvent>>> {\n  const url = `${config.baseUrl}/chat/completions`;\n  const messages = buildMessages(prompt.system, buildOpenAiChatUserContent(prompt), {\n    head: messagesBefore\n  });\n  const effort = resolvedThinking?.openAiEffort ?? resolvedThinking?.xaiEffort;\n  const supportsReasoning = config.model !== 'grok-4';\n  const body: Record<string, unknown> = { model: config.model, messages, stream: true };\n  if (effort !== undefined && supportsReasoning) {\n    body.reasoning_effort = effort;\n  }\n  // Temperature is sent only when the caller explicitly provided one; omitting it lets the\n  // provider apply its own default (current-gen models reject a caller-supplied default). This\n  // adapter is reached only via the conflict-guarded streaming entry point — the client-tool path\n  // routes OpenAI through the Responses adapter, not chat — so, like callOpenAiCompletion, no\n  // effort gate is needed: temperature is present here only when the effort is undefined/'none'.\n  if (temperature !== undefined) {\n    body.temperature = temperature;\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 1 - optional logger */\n  logger?.info(`OpenAI streaming completion: model=${config.model}`);\n  const conn = await openSseConnection(url, headers, body, logger, signal);\n  return conn.onSuccess((response) => succeed(translateOpenAiChatStream(response)));\n}\n"]}

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

@@ -0,0 +1,33 @@
+/**
+ * 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
+ */
+import { type Logging, Result } from '@fgv/ts-utils';
+import { type JsonObject } from '@fgv/ts-json-base';
+import { AiPrompt, type AiToolConfig, type IAiStreamEvent, type IChatMessage } from '../model';
+import { type IResolvedThinkingConfig } from '../thinkingOptionsResolver';
+import { IStreamApiConfig } from './common';
+/**
+ * Accumulated state for a single function_call in the OpenAI Responses API stream.
+ * @internal
+ */
+export interface IAccumulatedFunctionCall {
+    readonly id: string;
+    readonly name: string;
+    argsBuffer: string;
+}
+/**
+ * Issues a streaming Responses API request (with tools) and returns the
+ * unified-event iterable on success.
+ *
+ * @internal
+ */
+export declare function callOpenAiResponsesStream(config: IStreamApiConfig, prompt: AiPrompt, tools: ReadonlyArray<AiToolConfig> | undefined, messagesBefore: ReadonlyArray<IChatMessage> | undefined, temperature: number | undefined, logger?: Logging.ILogger, signal?: AbortSignal, resolvedThinking?: IResolvedThinkingConfig, functionCallMap?: Map<string, IAccumulatedFunctionCall>, continuationMessages?: ReadonlyArray<JsonObject>): Promise<Result<AsyncIterable<IAiStreamEvent>>>;
+//# sourceMappingURL=openaiResponses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openaiResponses.d.ts","sourceRoot":"","sources":["../../../../src/packlets/ai-assist/streamingAdapters/openaiResponses.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,EAAuC,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAG/F,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAKjB,MAAM,UAAU,CAAC;AAMlB;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmYD;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,YAAK,EACvC,cAAc,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,SAAS,EACvD,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,EACxB,MAAM,CAAC,EAAE,WAAW,EACpB,gBAAgB,CAAC,EAAE,uBAAuB,EAC1C,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,EACvD,oBAAoB,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,GAC/C,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAsChD"}