@fgv/ts-extras 5.1.0-33 → 5.1.0-34

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

@@ -0,0 +1,517 @@
+"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.buildAnthropicContinuation = buildAnthropicContinuation;
+exports.buildOpenAiContinuation = buildOpenAiContinuation;
+exports.buildGeminiContinuation = buildGeminiContinuation;
+exports.executeClientToolTurn = executeClientToolTurn;
+/**
+ * Per-provider continuation message builders and the `executeClientToolTurn`
+ * helper for orchestrating a single client-tool round-trip.
+ *
+ * Each provider requires a different wire format for the follow-up request:
+ * - **Anthropic**: assistant turn reconstructed from the ordered accumulation
+ *   buffer (thinking / redacted_thinking / text / tool_use in original stream
+ *   order) + user turn with `tool_result` blocks. When thinking is active, the
+ *   follow-up request must NOT set `tool_choice: { type: 'any' }` or
+ *   `tool_choice: { type: 'tool', ... }` (E3 / §5.4 of b4-spike-findings).
+ * - **OpenAI / xAI Responses API**: `function_call` input items +
+ *   `function_call_output` input items.
+ * - **Gemini**: model turn with `functionCall` parts + user turn with
+ *   `functionResponse` parts (correlation by tool name).
+ *
+ * @packageDocumentation
+ */
+const ts_utils_1 = require("@fgv/ts-utils");
+const model_1 = require("../model");
+const anthropic_1 = require("./anthropic");
+const openaiResponses_1 = require("./openaiResponses");
+const gemini_1 = require("./gemini");
+// ============================================================================
+// Anthropic continuation builder
+// ============================================================================
+/**
+ * Builds the Anthropic follow-up messages for a client-tool round-trip.
+ *
+ * Reconstructs the assistant turn from the ordered accumulation buffer
+ * (all block types in original stream order) and appends a user turn
+ * with `tool_result` blocks for each executed tool call.
+ *
+ * **Constraint (E3):** The returned continuation does NOT include a forced
+ * `tool_choice` field. When thinking is active, Anthropic rejects
+ * `tool_choice: { type: 'any' }` and `tool_choice: { type: 'tool', ... }`
+ * with an HTTP 400 error. Only `tool_choice: { type: 'auto' }` (the default,
+ * i.e. omitted) is compatible with extended thinking.
+ *
+ * @internal
+ */
+function buildAnthropicContinuation(accBuffer, toolResults) {
+    // Reconstruct the assistant turn from the ordered accumulation buffer.
+    // Sort by buffer key (SSE index) to restore original stream order.
+    const sortedKeys = Array.from(accBuffer.keys()).sort((a, b) => a - b);
+    const assistantContent = [];
+    for (const key of sortedKeys) {
+        const block = accBuffer.get(key);
+        /* c8 ignore next 1 - defensive: key always exists in map since we iterate its keys */
+        if (!block)
+            continue;
+        if (block.type === 'thinking') {
+            assistantContent.push({
+                type: 'thinking',
+                thinking: block.thinking,
+                signature: block.signature
+            });
+        }
+        else if (block.type === 'redacted_thinking') {
+            assistantContent.push({
+                type: 'redacted_thinking',
+                data: block.data
+            });
+        }
+        else if (block.type === 'text') {
+            if (block.text.length > 0) {
+                assistantContent.push({ type: 'text', text: block.text });
+            }
+        }
+        else if (block.type === 'tool_use') {
+            let parsedInput;
+            try {
+                /* c8 ignore next 1 - defensive: argsBuffer is JSON-parsed in the adapter before emitting client-tool-call-done */
+                parsedInput = JSON.parse(block.argsBuffer || '{}');
+                /* c8 ignore start - defensive: malformed argsBuffer defaults to empty object */
+            }
+            catch (_a) {
+                parsedInput = {};
+            }
+            /* c8 ignore stop */
+            assistantContent.push({
+                type: 'tool_use',
+                id: block.id,
+                name: block.name,
+                input: parsedInput
+            });
+        }
+    }
+    // Build user turn with tool_result blocks for each tool call.
+    const userContent = toolResults.map((r) => {
+        var _a;
+        const block = {
+            type: 'tool_result',
+            // eslint-disable-next-line @typescript-eslint/naming-convention
+            tool_use_id: (_a = r.callId) !== null && _a !== void 0 ? _a : r.toolName,
+            content: r.result
+        };
+        if (r.isError) {
+            return Object.assign(Object.assign({}, block), { is_error: true });
+        }
+        return block;
+    });
+    const assistantMessage = {
+        role: 'assistant',
+        content: assistantContent
+    };
+    const userMessage = {
+        role: 'user',
+        content: userContent
+    };
+    return {
+        messages: [assistantMessage, userMessage],
+        toolCallsSummary: toolResults.map((r) => ({
+            toolName: r.toolName,
+            callId: r.callId,
+            args: r.args,
+            result: r.result,
+            isError: r.isError
+        }))
+    };
+}
+// ============================================================================
+// OpenAI / xAI Responses API continuation builder
+// ============================================================================
+/**
+ * Builds the OpenAI / xAI Responses API follow-up input items for a
+ * client-tool round-trip.
+ *
+ * Emits `function_call` items (the model's call) followed by
+ * `function_call_output` items (the harness execution result), one pair
+ * per executed tool call.
+ *
+ * @internal
+ */
+function buildOpenAiContinuation(calls, toolResults) {
+    var _a;
+    const items = [];
+    // Emit function_call items for each call (model's side). Per the Responses API spec
+    // (ResponseFunctionToolCall), `call_id` is the required correlation field — it must
+    // match the matching function_call_output's `call_id` below. The optional `id` field
+    // is the output-item id (`fc_*`) used to reference the streamed item; we omit it
+    // because it is not load-bearing for input items.
+    for (const [callId, call] of calls) {
+        items.push({
+            type: 'function_call',
+            call_id: callId,
+            name: call.name,
+            arguments: call.argsBuffer
+        });
+    }
+    // Emit function_call_output items (harness execution results).
+    for (const r of toolResults) {
+        items.push({
+            type: 'function_call_output',
+            call_id: (_a = r.callId) !== null && _a !== void 0 ? _a : r.toolName,
+            output: r.result
+        });
+    }
+    return {
+        messages: items,
+        toolCallsSummary: toolResults.map((r) => ({
+            toolName: r.toolName,
+            callId: r.callId,
+            args: r.args,
+            result: r.result,
+            isError: r.isError
+        }))
+    };
+}
+// ============================================================================
+// Gemini continuation builder
+// ============================================================================
+/**
+ * Builds the Gemini follow-up contents for a client-tool round-trip.
+ *
+ * Emits a model turn with `functionCall` parts (one per tool call) and a
+ * user turn with `functionResponse` parts (correlation by tool name, since
+ * Gemini does not assign call IDs).
+ *
+ * @internal
+ */
+function buildGeminiContinuation(calls, toolResults) {
+    // Model turn: functionCall parts for each call.
+    const modelParts = calls.map((call) => ({
+        functionCall: {
+            name: call.name,
+            args: call.args
+        }
+    }));
+    // User turn: functionResponse parts for each executed result.
+    // Correlation is by name since Gemini has no call IDs.
+    const userParts = toolResults.map((r) => ({
+        functionResponse: {
+            name: r.toolName,
+            response: Object.assign({ content: r.result }, (r.isError ? { error: true } : {}))
+        }
+    }));
+    const modelMessage = {
+        role: 'model',
+        parts: modelParts
+    };
+    const userMessage = {
+        role: 'user',
+        parts: userParts
+    };
+    return {
+        messages: [modelMessage, userMessage],
+        toolCallsSummary: toolResults.map((r) => ({
+            toolName: r.toolName,
+            callId: r.callId,
+            args: r.args,
+            result: r.result,
+            isError: r.isError
+        }))
+    };
+}
+// ============================================================================
+// executeClientToolTurn
+// ============================================================================
+/**
+ * Orchestrates a single client-tool streaming turn for any supported provider.
+ *
+ * Starts a streaming request, iterates the underlying provider stream, and:
+ * - Forwards `text-delta`, `tool-event`, `client-tool-call-start`, and
+ *   `client-tool-call-done` events through to the consumer.
+ * - For each `client-tool-call-done` event: validates the raw args against the
+ *   tool's `parametersSchema`, invokes `execute(typedArgs)`, and emits a
+ *   `client-tool-result` event.
+ * - After stream completion: builds the per-provider continuation (or
+ *   `{ continuation: undefined }` when no tool calls occurred) and resolves
+ *   `nextTurn`.
+ *
+ * **Anthropic constraint (E3):** The continuation for Anthropic does not set
+ * a forced `tool_choice`. Only `tool_choice: 'auto'` (the default, i.e.
+ * omitted) is compatible with extended thinking.
+ *
+ * @param params - Turn parameters
+ * @returns `{ events, nextTurn }` — stream iterable + completion promise
+ * @public
+ */
+function executeClientToolTurn(params) {
+    const { descriptor, apiKey, prompt, messagesBefore, continuationMessages, temperature, tools, clientTools, signal, logger, resolvedThinking, model } = params;
+    // Build a lookup map of client tools by name for fast access.
+    // Fail fast on duplicate names — silently overwriting would cause one tool
+    // to shadow another with no observable signal.
+    const toolsByName = new Map();
+    for (const tool of clientTools) {
+        if (toolsByName.has(tool.config.name)) {
+            return (0, ts_utils_1.fail)(`executeClientToolTurn: duplicate client tool name '${tool.config.name}'`);
+        }
+        toolsByName.set(tool.config.name, tool);
+    }
+    // Merge server tools and client tool configs into a single array for the provider.
+    // This is the fix for P1-1: client tools were never sent to the provider because
+    // the adapters only received `tools` (server tools). Both must coexist per design §2.5.
+    const effectiveTools = clientTools.length > 0 ? [...(tools !== null && tools !== void 0 ? tools : []), ...clientTools.map((t) => t.config)] : tools;
+    const effectiveTemperature = temperature !== null && temperature !== void 0 ? temperature : 0.7;
+    const resolvedModel = model !== null && model !== void 0 ? model : (0, model_1.resolveModel)(descriptor.defaultModel);
+    const config = {
+        baseUrl: descriptor.baseUrl,
+        apiKey,
+        model: resolvedModel
+    };
+    // Accumulation buffers — populated by the adapter, read by the builder.
+    const anthropicBuffer = new Map();
+    const openAiCallMap = new Map();
+    const geminiCalls = [];
+    // Collected tool results, populated as each client-tool-call-done is processed.
+    const toolResults = [];
+    // Stream start: open the underlying adapter stream.
+    const streamPromise = (() => {
+        switch (descriptor.apiFormat) {
+            case 'anthropic':
+                return (0, anthropic_1.callAnthropicStream)(config, prompt, messagesBefore, effectiveTemperature, effectiveTools, logger, signal, resolvedThinking, anthropicBuffer, continuationMessages);
+            case 'openai':
+                return (0, openaiResponses_1.callOpenAiResponsesStream)(config, prompt, 
+                /* c8 ignore next 1 - defensive: openai path requires tools; empty array fallback unreachable in practice */
+                effectiveTools !== null && effectiveTools !== void 0 ? effectiveTools : [], messagesBefore, effectiveTemperature, logger, signal, resolvedThinking, openAiCallMap, continuationMessages);
+            case 'gemini':
+                return (0, gemini_1.callGeminiStream)(config, prompt, messagesBefore, effectiveTemperature, effectiveTools, logger, signal, resolvedThinking, geminiCalls, continuationMessages);
+            /* c8 ignore next 4 - defensive coding: exhaustive switch guaranteed by TypeScript */
+            default: {
+                const _exhaustive = descriptor.apiFormat;
+                return Promise.resolve((0, ts_utils_1.fail)(`unsupported API format: ${String(_exhaustive)}`));
+            }
+        }
+    })();
+    // Resolve controls for `nextTurn`.
+    let resolveNextTurn;
+    const nextTurn = new Promise((resolve) => {
+        resolveNextTurn = resolve;
+    });
+    // The unified-event generator: opens the stream, proxies events, executes tools.
+    function eventGenerator() {
+        return __asyncGenerator(this, arguments, function* eventGenerator_1() {
+            var _a, e_1, _b, _c;
+            const streamResult = yield __await(streamPromise);
+            if (streamResult.isFailure()) {
+                resolveNextTurn((0, ts_utils_1.fail)(streamResult.message));
+                yield yield __await({ type: 'error', message: streamResult.message });
+                return yield __await(void 0);
+            }
+            let truncated = false;
+            let fullText = '';
+            let streamError;
+            try {
+                for (var _d = true, _e = __asyncValues(streamResult.value), _f; _f = yield __await(_e.next()), _a = _f.done, !_a; _d = true) {
+                    _c = _f.value;
+                    _d = false;
+                    const event = _c;
+                    if (event.type === 'done') {
+                        truncated = event.truncated;
+                        fullText = event.fullText;
+                        yield yield __await(event);
+                        continue;
+                    }
+                    if (event.type === 'error') {
+                        streamError = event.message;
+                        yield yield __await(event);
+                        continue;
+                    }
+                    if (event.type === 'text-delta') {
+                        yield yield __await(event);
+                        continue;
+                    }
+                    if (event.type === 'tool-event') {
+                        yield yield __await(event);
+                        continue;
+                    }
+                    if (event.type === 'client-tool-call-start') {
+                        yield yield __await(event);
+                        continue;
+                    }
+                    if (event.type === 'client-tool-call-done') {
+                        yield yield __await(event);
+                        const { toolName, callId, args } = event;
+                        const tool = toolsByName.get(toolName);
+                        if (!tool) {
+                            const errMsg = `model called unknown tool: ${toolName}`;
+                            const resultEvent = {
+                                type: 'client-tool-result',
+                                toolName,
+                                callId,
+                                result: errMsg,
+                                isError: true
+                            };
+                            yield yield __await(resultEvent);
+                            toolResults.push({ toolName, callId, args, result: errMsg, isError: true });
+                            resolveNextTurn((0, ts_utils_1.fail)(errMsg));
+                            return yield __await(void 0);
+                        }
+                        const validationResult = tool.config.parametersSchema.validate(args);
+                        if (validationResult.isFailure()) {
+                            const errMsg = `${toolName} (callId=${callId}): ${validationResult.message}`;
+                            const resultEvent = {
+                                type: 'client-tool-result',
+                                toolName,
+                                callId,
+                                result: errMsg,
+                                isError: true
+                            };
+                            yield yield __await(resultEvent);
+                            toolResults.push({ toolName, callId, args, result: errMsg, isError: true });
+                            continue;
+                        }
+                        const executeResult = yield __await((0, ts_utils_1.captureAsyncResult)(async () => tool.execute(validationResult.value)));
+                        const executionResult = executeResult.isSuccess()
+                            ? executeResult.value
+                            : executeResult;
+                        if (executionResult.isFailure()) {
+                            const errMsg = `${toolName} (callId=${callId}): ${executionResult.message}`;
+                            const resultEvent = {
+                                type: 'client-tool-result',
+                                toolName,
+                                callId,
+                                result: errMsg,
+                                isError: true
+                            };
+                            yield yield __await(resultEvent);
+                            toolResults.push({ toolName, callId, args, result: errMsg, isError: true });
+                            continue;
+                        }
+                        // JSON.stringify can throw (circular references) or return undefined
+                        // (e.g. for a bare `undefined` value, or a value of type `function`).
+                        // Either outcome violates the client-tool-result event contract, so
+                        // emit an isError result with diagnostic context instead.
+                        let resultStr;
+                        try {
+                            const stringified = JSON.stringify(executionResult.value);
+                            if (stringified === undefined) {
+                                const errMsg = `${toolName} (callId=${callId}): tool returned a non-serializable value (JSON.stringify produced undefined)`;
+                                const resultEvent = {
+                                    type: 'client-tool-result',
+                                    toolName,
+                                    callId,
+                                    result: errMsg,
+                                    isError: true
+                                };
+                                yield yield __await(resultEvent);
+                                toolResults.push({ toolName, callId, args, result: errMsg, isError: true });
+                                continue;
+                            }
+                            resultStr = stringified;
+                        }
+                        catch (e) {
+                            const errMsg = `${toolName} (callId=${callId}): failed to serialize tool result: ${e.message}`;
+                            const resultEvent = {
+                                type: 'client-tool-result',
+                                toolName,
+                                callId,
+                                result: errMsg,
+                                isError: true
+                            };
+                            yield yield __await(resultEvent);
+                            toolResults.push({ toolName, callId, args, result: errMsg, isError: true });
+                            continue;
+                        }
+                        const resultEvent = {
+                            type: 'client-tool-result',
+                            toolName,
+                            callId,
+                            result: resultStr,
+                            isError: false
+                        };
+                        yield yield __await(resultEvent);
+                        toolResults.push({ toolName, callId, args, result: resultStr, isError: false });
+                        continue;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = _e.return)) yield __await(_b.call(_e));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            // Stream has ended. Build the continuation.
+            if (streamError !== undefined) {
+                resolveNextTurn((0, ts_utils_1.fail)(streamError));
+                return yield __await(void 0);
+            }
+            if (toolResults.length === 0) {
+                resolveNextTurn((0, ts_utils_1.succeed)({ continuation: undefined, truncated, fullText }));
+                return yield __await(void 0);
+            }
+            let continuation;
+            switch (descriptor.apiFormat) {
+                case 'anthropic':
+                    continuation = buildAnthropicContinuation(anthropicBuffer, toolResults);
+                    break;
+                case 'openai':
+                    continuation = buildOpenAiContinuation(openAiCallMap, toolResults);
+                    break;
+                case 'gemini':
+                    continuation = buildGeminiContinuation(geminiCalls, toolResults);
+                    break;
+                /* c8 ignore next 5 - defensive coding: exhaustive switch guaranteed by TypeScript */
+                default: {
+                    const _exhaustive = descriptor.apiFormat;
+                    resolveNextTurn((0, ts_utils_1.fail)(`unsupported API format: ${String(_exhaustive)}`));
+                    return yield __await(void 0);
+                }
+            }
+            resolveNextTurn((0, ts_utils_1.succeed)({ continuation, truncated, fullText }));
+        });
+    }
+    return (0, ts_utils_1.succeed)({
+        events: { [Symbol.asyncIterator]: () => eventGenerator() },
+        nextTurn
+    });
+}
+//# sourceMappingURL=clientToolContinuationBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clientToolContinuationBuilder.js","sourceRoot":"","sources":["../../../../src/packlets/ai-assist/streamingAdapters/clientToolContinuationBuilder.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 * Per-provider continuation message builders and the `executeClientToolTurn`\n * helper for orchestrating a single client-tool round-trip.\n *\n * Each provider requires a different wire format for the follow-up request:\n * - **Anthropic**: assistant turn reconstructed from the ordered accumulation\n *   buffer (thinking / redacted_thinking / text / tool_use in original stream\n *   order) + user turn with `tool_result` blocks. When thinking is active, the\n *   follow-up request must NOT set `tool_choice: { type: 'any' }` or\n *   `tool_choice: { type: 'tool', ... }` (E3 / §5.4 of b4-spike-findings).\n * - **OpenAI / xAI Responses API**: `function_call` input items +\n *   `function_call_output` input items.\n * - **Gemini**: model turn with `functionCall` parts + user turn with\n *   `functionResponse` parts (correlation by tool name).\n *\n * @packageDocumentation\n */\n\nimport { captureAsyncResult, fail, type Logging, Result, succeed } from '@fgv/ts-utils';\nimport { type JsonArray, type JsonObject } from '@fgv/ts-json-base';\n\nimport {\n  type AiPrompt,\n  type AiServerToolConfig,\n  type AiToolConfig,\n  type IAiClientTool,\n  type IAiClientToolContinuation,\n  type IAiClientToolTurnResult,\n  type IAiStreamEvent,\n  type IChatMessage,\n  type IAiProviderDescriptor,\n  resolveModel\n} from '../model';\nimport { type IResolvedThinkingConfig } from '../thinkingOptionsResolver';\nimport { type IAccumulatedBlock } from './anthropic';\nimport { type IAccumulatedFunctionCall } from './openaiResponses';\nimport { type IAccumulatedGeminiFunctionCall } from './gemini';\nimport { callAnthropicStream } from './anthropic';\nimport { callOpenAiResponsesStream } from './openaiResponses';\nimport { callGeminiStream } from './gemini';\nimport { type IStreamApiConfig } from './common';\n\n// ============================================================================\n// Tool-result accumulation (internal)\n// ============================================================================\n\n/**\n * Accumulated result for a single tool call, collected during stream iteration.\n * @internal\n */\ninterface IToolCallResult {\n  readonly toolName: string;\n  readonly callId?: string;\n  readonly args: JsonObject;\n  readonly result: string;\n  readonly isError: boolean;\n}\n\n// ============================================================================\n// Anthropic continuation builder\n// ============================================================================\n\n/**\n * Builds the Anthropic follow-up messages for a client-tool round-trip.\n *\n * Reconstructs the assistant turn from the ordered accumulation buffer\n * (all block types in original stream order) and appends a user turn\n * with `tool_result` blocks for each executed tool call.\n *\n * **Constraint (E3):** The returned continuation does NOT include a forced\n * `tool_choice` field. When thinking is active, Anthropic rejects\n * `tool_choice: { type: 'any' }` and `tool_choice: { type: 'tool', ... }`\n * with an HTTP 400 error. Only `tool_choice: { type: 'auto' }` (the default,\n * i.e. omitted) is compatible with extended thinking.\n *\n * @internal\n */\nexport function buildAnthropicContinuation(\n  accBuffer: Map<number, IAccumulatedBlock>,\n  toolResults: IToolCallResult[]\n): IAiClientToolContinuation {\n  // Reconstruct the assistant turn from the ordered accumulation buffer.\n  // Sort by buffer key (SSE index) to restore original stream order.\n  const sortedKeys = Array.from(accBuffer.keys()).sort((a, b) => a - b);\n  const assistantContent: JsonArray = [];\n\n  for (const key of sortedKeys) {\n    const block = accBuffer.get(key);\n    /* c8 ignore next 1 - defensive: key always exists in map since we iterate its keys */\n    if (!block) continue;\n    if (block.type === 'thinking') {\n      assistantContent.push({\n        type: 'thinking',\n        thinking: block.thinking,\n        signature: block.signature\n      });\n    } else if (block.type === 'redacted_thinking') {\n      assistantContent.push({\n        type: 'redacted_thinking',\n        data: block.data\n      });\n    } else if (block.type === 'text') {\n      if (block.text.length > 0) {\n        assistantContent.push({ type: 'text', text: block.text });\n      }\n    } else if (block.type === 'tool_use') {\n      let parsedInput: JsonObject;\n      try {\n        /* c8 ignore next 1 - defensive: argsBuffer is JSON-parsed in the adapter before emitting client-tool-call-done */\n        parsedInput = JSON.parse(block.argsBuffer || '{}') as JsonObject;\n        /* c8 ignore start - defensive: malformed argsBuffer defaults to empty object */\n      } catch {\n        parsedInput = {};\n      }\n      /* c8 ignore stop */\n      assistantContent.push({\n        type: 'tool_use',\n        id: block.id,\n        name: block.name,\n        input: parsedInput\n      });\n    }\n  }\n\n  // Build user turn with tool_result blocks for each tool call.\n  const userContent: JsonArray = toolResults.map((r): JsonObject => {\n    const block: JsonObject = {\n      type: 'tool_result',\n      // eslint-disable-next-line @typescript-eslint/naming-convention\n      tool_use_id: r.callId ?? r.toolName,\n      content: r.result\n    };\n    if (r.isError) {\n      return { ...block, is_error: true };\n    }\n    return block;\n  });\n\n  const assistantMessage: JsonObject = {\n    role: 'assistant',\n    content: assistantContent\n  };\n  const userMessage: JsonObject = {\n    role: 'user',\n    content: userContent\n  };\n\n  return {\n    messages: [assistantMessage, userMessage],\n    toolCallsSummary: toolResults.map((r) => ({\n      toolName: r.toolName,\n      callId: r.callId,\n      args: r.args,\n      result: r.result,\n      isError: r.isError\n    }))\n  };\n}\n\n// ============================================================================\n// OpenAI / xAI Responses API continuation builder\n// ============================================================================\n\n/**\n * Builds the OpenAI / xAI Responses API follow-up input items for a\n * client-tool round-trip.\n *\n * Emits `function_call` items (the model's call) followed by\n * `function_call_output` items (the harness execution result), one pair\n * per executed tool call.\n *\n * @internal\n */\nexport function buildOpenAiContinuation(\n  calls: Map<string, IAccumulatedFunctionCall>,\n  toolResults: IToolCallResult[]\n): IAiClientToolContinuation {\n  const items: JsonObject[] = [];\n\n  // Emit function_call items for each call (model's side). Per the Responses API spec\n  // (ResponseFunctionToolCall), `call_id` is the required correlation field — it must\n  // match the matching function_call_output's `call_id` below. The optional `id` field\n  // is the output-item id (`fc_*`) used to reference the streamed item; we omit it\n  // because it is not load-bearing for input items.\n  for (const [callId, call] of calls) {\n    items.push({\n      type: 'function_call',\n      call_id: callId,\n      name: call.name,\n      arguments: call.argsBuffer\n    });\n  }\n\n  // Emit function_call_output items (harness execution results).\n  for (const r of toolResults) {\n    items.push({\n      type: 'function_call_output',\n      call_id: r.callId ?? r.toolName,\n      output: r.result\n    });\n  }\n\n  return {\n    messages: items,\n    toolCallsSummary: toolResults.map((r) => ({\n      toolName: r.toolName,\n      callId: r.callId,\n      args: r.args,\n      result: r.result,\n      isError: r.isError\n    }))\n  };\n}\n\n// ============================================================================\n// Gemini continuation builder\n// ============================================================================\n\n/**\n * Builds the Gemini follow-up contents for a client-tool round-trip.\n *\n * Emits a model turn with `functionCall` parts (one per tool call) and a\n * user turn with `functionResponse` parts (correlation by tool name, since\n * Gemini does not assign call IDs).\n *\n * @internal\n */\nexport function buildGeminiContinuation(\n  calls: IAccumulatedGeminiFunctionCall[],\n  toolResults: IToolCallResult[]\n): IAiClientToolContinuation {\n  // Model turn: functionCall parts for each call.\n  const modelParts: JsonArray = calls.map(\n    (call): JsonObject => ({\n      functionCall: {\n        name: call.name,\n        args: call.args\n      }\n    })\n  );\n\n  // User turn: functionResponse parts for each executed result.\n  // Correlation is by name since Gemini has no call IDs.\n  const userParts: JsonArray = toolResults.map(\n    (r): JsonObject => ({\n      functionResponse: {\n        name: r.toolName,\n        response: {\n          content: r.result,\n          ...(r.isError ? { error: true } : {})\n        }\n      }\n    })\n  );\n\n  const modelMessage: JsonObject = {\n    role: 'model',\n    parts: modelParts\n  };\n  const userMessage: JsonObject = {\n    role: 'user',\n    parts: userParts\n  };\n\n  return {\n    messages: [modelMessage, userMessage],\n    toolCallsSummary: toolResults.map((r) => ({\n      toolName: r.toolName,\n      callId: r.callId,\n      args: r.args,\n      result: r.result,\n      isError: r.isError\n    }))\n  };\n}\n\n// ============================================================================\n// executeClientToolTurn parameters\n// ============================================================================\n\n/**\n * Parameters for {@link AiAssist.executeClientToolTurn}.\n * @public\n */\nexport interface IExecuteClientToolTurnParams {\n  /** The provider descriptor for routing (Anthropic / OpenAI / Gemini). */\n  readonly descriptor: IAiProviderDescriptor;\n  /** API key for authentication. */\n  readonly apiKey: string;\n  /** The structured prompt. */\n  readonly prompt: AiPrompt;\n  /** Prior conversation history (excluding the current turn). */\n  readonly messagesBefore?: ReadonlyArray<IChatMessage>;\n  /**\n   * Provider-specific continuation messages to append after the prompt's user\n   * message. Used to supply the output of {@link AiAssist.IAiClientToolContinuation}'s\n   * `messages` field from a prior turn back to the provider in the follow-up request.\n   *\n   * Each provider applies its own shape guard to the supplied wire objects:\n   * - Anthropic: projects each entry to `{ role, content }` (sufficient for\n   *   thinking blocks and `tool_result` arrays).\n   * - OpenAI / xAI Responses: passes each item verbatim (`function_call` /\n   *   `function_call_output` items carry distinct fields per `type`); only guards\n   *   that each entry is a JSON object.\n   * - Gemini: projects each entry to `{ role, parts }`.\n   *\n   * Entries that fail their provider's shape check are silently skipped.\n   */\n  readonly continuationMessages?: ReadonlyArray<JsonObject>;\n  /** Temperature (default: 0.7). */\n  readonly temperature?: number;\n  /** Server-side tools to include. */\n  readonly tools?: ReadonlyArray<AiServerToolConfig>;\n  /** Client-defined tools available for the model to call. */\n  readonly clientTools: ReadonlyArray<IAiClientTool>;\n  /** Optional abort signal. */\n  readonly signal?: AbortSignal;\n  /** Optional logger for diagnostics. */\n  readonly logger?: Logging.ILogger;\n  /** Optional resolved thinking config (pre-resolved by the caller). */\n  readonly resolvedThinking?: IResolvedThinkingConfig;\n  /** Resolved model string (pre-resolved by the caller). When omitted, uses the descriptor's default model. */\n  readonly model?: string;\n}\n\n/**\n * Return value of {@link AiAssist.executeClientToolTurn}.\n * @public\n */\nexport interface IExecuteClientToolTurnResult {\n  /**\n   * The unified-event iterable. Callers iterate this to drive the streaming UI.\n   * The iterable forwards `text-delta`, `tool-event`, `client-tool-call-start`,\n   * `client-tool-call-done`, and `client-tool-result` events through.\n   */\n  readonly events: AsyncIterable<IAiStreamEvent>;\n  /**\n   * Resolves when the stream terminates. On success, carries the\n   * {@link AiAssist.IAiClientToolTurnResult} with the optional continuation for the\n   * next round. On failure, carries the error message.\n   */\n  readonly nextTurn: Promise<Result<IAiClientToolTurnResult>>;\n}\n\n// ============================================================================\n// executeClientToolTurn\n// ============================================================================\n\n/**\n * Orchestrates a single client-tool streaming turn for any supported provider.\n *\n * Starts a streaming request, iterates the underlying provider stream, and:\n * - Forwards `text-delta`, `tool-event`, `client-tool-call-start`, and\n *   `client-tool-call-done` events through to the consumer.\n * - For each `client-tool-call-done` event: validates the raw args against the\n *   tool's `parametersSchema`, invokes `execute(typedArgs)`, and emits a\n *   `client-tool-result` event.\n * - After stream completion: builds the per-provider continuation (or\n *   `{ continuation: undefined }` when no tool calls occurred) and resolves\n *   `nextTurn`.\n *\n * **Anthropic constraint (E3):** The continuation for Anthropic does not set\n * a forced `tool_choice`. Only `tool_choice: 'auto'` (the default, i.e.\n * omitted) is compatible with extended thinking.\n *\n * @param params - Turn parameters\n * @returns `{ events, nextTurn }` — stream iterable + completion promise\n * @public\n */\nexport function executeClientToolTurn(\n  params: IExecuteClientToolTurnParams\n): Result<IExecuteClientToolTurnResult> {\n  const {\n    descriptor,\n    apiKey,\n    prompt,\n    messagesBefore,\n    continuationMessages,\n    temperature,\n    tools,\n    clientTools,\n    signal,\n    logger,\n    resolvedThinking,\n    model\n  } = params;\n\n  // Build a lookup map of client tools by name for fast access.\n  // Fail fast on duplicate names — silently overwriting would cause one tool\n  // to shadow another with no observable signal.\n  const toolsByName = new Map<string, IAiClientTool>();\n  for (const tool of clientTools) {\n    if (toolsByName.has(tool.config.name)) {\n      return fail(`executeClientToolTurn: duplicate client tool name '${tool.config.name}'`);\n    }\n    toolsByName.set(tool.config.name, tool);\n  }\n\n  // Merge server tools and client tool configs into a single array for the provider.\n  // This is the fix for P1-1: client tools were never sent to the provider because\n  // the adapters only received `tools` (server tools). Both must coexist per design §2.5.\n  const effectiveTools: ReadonlyArray<AiToolConfig> | undefined =\n    clientTools.length > 0 ? [...(tools ?? []), ...clientTools.map((t) => t.config)] : tools;\n\n  const effectiveTemperature = temperature ?? 0.7;\n  const resolvedModel = model ?? resolveModel(descriptor.defaultModel);\n  const config: IStreamApiConfig = {\n    baseUrl: descriptor.baseUrl,\n    apiKey,\n    model: resolvedModel\n  };\n\n  // Accumulation buffers — populated by the adapter, read by the builder.\n  const anthropicBuffer = new Map<number, IAccumulatedBlock>();\n  const openAiCallMap = new Map<string, IAccumulatedFunctionCall>();\n  const geminiCalls: IAccumulatedGeminiFunctionCall[] = [];\n\n  // Collected tool results, populated as each client-tool-call-done is processed.\n  const toolResults: IToolCallResult[] = [];\n\n  // Stream start: open the underlying adapter stream.\n  const streamPromise: Promise<Result<AsyncIterable<IAiStreamEvent>>> = (() => {\n    switch (descriptor.apiFormat) {\n      case 'anthropic':\n        return callAnthropicStream(\n          config,\n          prompt,\n          messagesBefore,\n          effectiveTemperature,\n          effectiveTools,\n          logger,\n          signal,\n          resolvedThinking,\n          anthropicBuffer,\n          continuationMessages\n        );\n      case 'openai':\n        return callOpenAiResponsesStream(\n          config,\n          prompt,\n          /* c8 ignore next 1 - defensive: openai path requires tools; empty array fallback unreachable in practice */\n          effectiveTools ?? [],\n          messagesBefore,\n          effectiveTemperature,\n          logger,\n          signal,\n          resolvedThinking,\n          openAiCallMap,\n          continuationMessages\n        );\n      case 'gemini':\n        return callGeminiStream(\n          config,\n          prompt,\n          messagesBefore,\n          effectiveTemperature,\n          effectiveTools,\n          logger,\n          signal,\n          resolvedThinking,\n          geminiCalls,\n          continuationMessages\n        );\n      /* c8 ignore next 4 - defensive coding: exhaustive switch guaranteed by TypeScript */\n      default: {\n        const _exhaustive: never = descriptor.apiFormat;\n        return Promise.resolve(fail(`unsupported API format: ${String(_exhaustive)}`));\n      }\n    }\n  })();\n\n  // Resolve controls for `nextTurn`.\n  let resolveNextTurn!: (result: Result<IAiClientToolTurnResult>) => void;\n  const nextTurn = new Promise<Result<IAiClientToolTurnResult>>((resolve) => {\n    resolveNextTurn = resolve;\n  });\n\n  // The unified-event generator: opens the stream, proxies events, executes tools.\n  async function* eventGenerator(): AsyncGenerator<IAiStreamEvent> {\n    const streamResult = await streamPromise;\n    if (streamResult.isFailure()) {\n      resolveNextTurn(fail(streamResult.message));\n      yield { type: 'error', message: streamResult.message };\n      return;\n    }\n\n    let truncated = false;\n    let fullText = '';\n    let streamError: string | undefined;\n\n    for await (const event of streamResult.value) {\n      if (event.type === 'done') {\n        truncated = event.truncated;\n        fullText = event.fullText;\n        yield event;\n        continue;\n      }\n\n      if (event.type === 'error') {\n        streamError = event.message;\n        yield event;\n        continue;\n      }\n\n      if (event.type === 'text-delta') {\n        yield event;\n        continue;\n      }\n\n      if (event.type === 'tool-event') {\n        yield event;\n        continue;\n      }\n\n      if (event.type === 'client-tool-call-start') {\n        yield event;\n        continue;\n      }\n\n      if (event.type === 'client-tool-call-done') {\n        yield event;\n\n        const { toolName, callId, args } = event;\n        const tool = toolsByName.get(toolName);\n\n        if (!tool) {\n          const errMsg = `model called unknown tool: ${toolName}`;\n          const resultEvent: IAiStreamEvent = {\n            type: 'client-tool-result',\n            toolName,\n            callId,\n            result: errMsg,\n            isError: true\n          };\n          yield resultEvent;\n          toolResults.push({ toolName, callId, args, result: errMsg, isError: true });\n          resolveNextTurn(fail(errMsg));\n          return;\n        }\n\n        const validationResult = tool.config.parametersSchema.validate(args);\n        if (validationResult.isFailure()) {\n          const errMsg = `${toolName} (callId=${callId}): ${validationResult.message}`;\n          const resultEvent: IAiStreamEvent = {\n            type: 'client-tool-result',\n            toolName,\n            callId,\n            result: errMsg,\n            isError: true\n          };\n          yield resultEvent;\n          toolResults.push({ toolName, callId, args, result: errMsg, isError: true });\n          continue;\n        }\n\n        const executeResult = await captureAsyncResult(async () => tool.execute(validationResult.value));\n        const executionResult: Result<unknown> = executeResult.isSuccess()\n          ? executeResult.value\n          : executeResult;\n\n        if (executionResult.isFailure()) {\n          const errMsg = `${toolName} (callId=${callId}): ${executionResult.message}`;\n          const resultEvent: IAiStreamEvent = {\n            type: 'client-tool-result',\n            toolName,\n            callId,\n            result: errMsg,\n            isError: true\n          };\n          yield resultEvent;\n          toolResults.push({ toolName, callId, args, result: errMsg, isError: true });\n          continue;\n        }\n\n        // JSON.stringify can throw (circular references) or return undefined\n        // (e.g. for a bare `undefined` value, or a value of type `function`).\n        // Either outcome violates the client-tool-result event contract, so\n        // emit an isError result with diagnostic context instead.\n        let resultStr: string;\n        try {\n          const stringified = JSON.stringify(executionResult.value);\n          if (stringified === undefined) {\n            const errMsg = `${toolName} (callId=${callId}): tool returned a non-serializable value (JSON.stringify produced undefined)`;\n            const resultEvent: IAiStreamEvent = {\n              type: 'client-tool-result',\n              toolName,\n              callId,\n              result: errMsg,\n              isError: true\n            };\n            yield resultEvent;\n            toolResults.push({ toolName, callId, args, result: errMsg, isError: true });\n            continue;\n          }\n          resultStr = stringified;\n        } catch (e) {\n          const errMsg = `${toolName} (callId=${callId}): failed to serialize tool result: ${\n            (e as Error).message\n          }`;\n          const resultEvent: IAiStreamEvent = {\n            type: 'client-tool-result',\n            toolName,\n            callId,\n            result: errMsg,\n            isError: true\n          };\n          yield resultEvent;\n          toolResults.push({ toolName, callId, args, result: errMsg, isError: true });\n          continue;\n        }\n        const resultEvent: IAiStreamEvent = {\n          type: 'client-tool-result',\n          toolName,\n          callId,\n          result: resultStr,\n          isError: false\n        };\n        yield resultEvent;\n        toolResults.push({ toolName, callId, args, result: resultStr, isError: false });\n        continue;\n      }\n\n      // client-tool-result events are emitted by this layer, not the adapters — no passthrough needed.\n    }\n\n    // Stream has ended. Build the continuation.\n    if (streamError !== undefined) {\n      resolveNextTurn(fail(streamError));\n      return;\n    }\n\n    if (toolResults.length === 0) {\n      resolveNextTurn(succeed({ continuation: undefined, truncated, fullText }));\n      return;\n    }\n\n    let continuation: IAiClientToolContinuation;\n    switch (descriptor.apiFormat) {\n      case 'anthropic':\n        continuation = buildAnthropicContinuation(anthropicBuffer, toolResults);\n        break;\n      case 'openai':\n        continuation = buildOpenAiContinuation(openAiCallMap, toolResults);\n        break;\n      case 'gemini':\n        continuation = buildGeminiContinuation(geminiCalls, toolResults);\n        break;\n      /* c8 ignore next 5 - defensive coding: exhaustive switch guaranteed by TypeScript */\n      default: {\n        const _exhaustive: never = descriptor.apiFormat;\n        resolveNextTurn(fail(`unsupported API format: ${String(_exhaustive)}`));\n        return;\n      }\n    }\n\n    resolveNextTurn(succeed({ continuation, truncated, fullText }));\n  }\n\n  return succeed({\n    events: { [Symbol.asyncIterator]: () => eventGenerator() },\n    nextTurn\n  });\n}\n"]}

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

@@ -62,6 +62,57 @@ export interface IStreamApiConfig {
     readonly apiKey: string;
     readonly model: string;
 }
+/**
+ * Stable log-line prefix that every streaming adapter's "unrecognized SSE event"
+ * warning starts with. Production deployments can filter / alert on this exact
+ * substring without coupling to the per-adapter detail message. Surfacing this
+ * as a shared constant ensures all adapters emit the same prefix; loosening or
+ * renaming the prefix is a coordinated, intentional change rather than a per-file
+ * accident.
+ *
+ * @internal
+ */
+export declare const UNRECOGNIZED_EVENT_WARN_TAG: string;
+/**
+ * Environment variable that opts in to **raw payload preview** in the
+ * {@link UNRECOGNIZED_EVENT_WARN_TAG} warning. Any non-empty, non-`'0'` value
+ * activates the raw preview. **Default behavior** (env var absent / empty /
+ * `'0'`) is **structural-only** preview — top-level JSON keys + payload byte
+ * length, never the values.
+ *
+ * The default-safe posture exists because unrecognized SSE event payloads can
+ * carry tool arguments, tool results, user-conversation text, or other
+ * potentially sensitive content. Emitting them verbatim at `warn` level — which
+ * is the level explicitly designed to surface in production logs / alerting —
+ * is a PII leak waiting to happen.
+ *
+ * Ops triaging an active drift signal (`ai-assist:unrecognized-event` warnings
+ * appearing in production logs after a provider API evolution) can set this
+ * env var to widen the preview and see the actual payload shape during
+ * investigation, then unset it once the new event family is handled.
+ *
+ * @internal
+ */
+export declare const UNRECOGNIZED_EVENT_FULL_PAYLOAD_ENV_VAR: string;
+/**
+ * Renders an SSE `data:` payload for inclusion in an unrecognized-event
+ * warning.
+ *
+ * - Empty payload: returns `<no payload>`.
+ * - Default (env var unset): returns structural-only preview (e.g.
+ *   `{ keys: [type, data], length: 1234 }` for a JSON object payload;
+ *   `<array payload, length=N>` / `<{type} payload, length=N>` /
+ *   `<non-JSON payload, length=N>` for other shapes). Never includes
+ *   field values.
+ * - With {@link UNRECOGNIZED_EVENT_FULL_PAYLOAD_ENV_VAR} set to a truthy
+ *   value: returns the raw payload, newlines collapsed to spaces, capped
+ *   at {@link UNRECOGNIZED_EVENT_PAYLOAD_PREVIEW_MAX} chars with a trailing
+ *   ellipsis on truncation. **Use this mode only for active drift triage**
+ *   — it leaks payload content into warn logs.
+ *
+ * @internal
+ */
+export declare function formatUnrecognizedEventPayloadPreview(data: string): string;
 /**
  * Opens an SSE-style POST connection. Returns the underlying Response on a
  * 2xx; failures (network, non-2xx, missing body) surface as Result.fail