@fgv/ts-extras 5.1.0-5 → 5.1.0-50

package/lib/packlets/ai-assist/sseParser.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Server-Sent Events (SSE) parser primitives shared by the streaming format
+ * adapters in `streamingClient.ts`. Implements the subset of the SSE wire
+ * format that LLM providers actually emit: optional `event:` line, one or
+ * more `data:` lines per message, messages separated by a blank line.
+ *
+ * @packageDocumentation
+ */
+/**
+ * One parsed SSE message (the SSE spec calls each blank-line-terminated
+ * record an "event").
+ *
+ * @internal
+ */
+export interface ISseEvent {
+    /** The `event:` field, if present (some providers omit it). */
+    readonly event?: string;
+    /** Concatenated contents of the message's `data:` lines. */
+    readonly data: string;
+}
+/**
+ * Parses a single SSE message (the text between blank-line separators) into
+ * an {@link ISseEvent}. Returns undefined for messages with no `data:` lines
+ * (comments, heartbeats).
+ *
+ * @internal
+ */
+export declare function parseSseEvent(chunk: string): ISseEvent | undefined;
+/**
+ * Reads an SSE response body and yields parsed events. Buffers across read()
+ * boundaries so a message split mid-chunk still parses cleanly. Terminates
+ * when the stream closes (normal EOF or aborted fetch).
+ *
+ * @internal
+ */
+export declare function readSseEvents(body: ReadableStream<Uint8Array>): AsyncGenerator<ISseEvent>;
+/**
+ * Parses the `data` payload of an SSE event as JSON. Returns undefined for
+ * the OpenAI `[DONE]` sentinel and for any payload that fails to parse —
+ * adapters treat both as "skip this event."
+ *
+ * @internal
+ */
+export declare function parseSseEventJson(data: string): unknown | undefined;
+//# sourceMappingURL=sseParser.d.ts.map

package/lib/packlets/ai-assist/sseParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseParser.d.ts","sourceRoot":"","sources":["../../../src/packlets/ai-assist/sseParser.ts"],"names":[],"mappings":"AAoBA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAgBlE;AAED;;;;;;GAMG;AACH,wBAAuB,aAAa,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,CAmChG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CASnE"}

package/lib/packlets/ai-assist/sseParser.js

@@ -0,0 +1,128 @@
+"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 __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.parseSseEvent = parseSseEvent;
+exports.readSseEvents = readSseEvents;
+exports.parseSseEventJson = parseSseEventJson;
+/**
+ * Parses a single SSE message (the text between blank-line separators) into
+ * an {@link ISseEvent}. Returns undefined for messages with no `data:` lines
+ * (comments, heartbeats).
+ *
+ * @internal
+ */
+function parseSseEvent(chunk) {
+    let event;
+    const dataLines = [];
+    for (const line of chunk.split('\n')) {
+        if (line.startsWith('event:')) {
+            event = line.slice(6).trim();
+        }
+        else if (line.startsWith('data:')) {
+            // Per the SSE spec the value starts after the colon, with one optional leading space stripped.
+            const value = line.slice(5);
+            dataLines.push(value.startsWith(' ') ? value.slice(1) : value);
+        }
+    }
+    if (dataLines.length === 0) {
+        return undefined;
+    }
+    return event !== undefined ? { event, data: dataLines.join('\n') } : { data: dataLines.join('\n') };
+}
+/**
+ * Reads an SSE response body and yields parsed events. Buffers across read()
+ * boundaries so a message split mid-chunk still parses cleanly. Terminates
+ * when the stream closes (normal EOF or aborted fetch).
+ *
+ * @internal
+ */
+function readSseEvents(body) {
+    return __asyncGenerator(this, arguments, function* readSseEvents_1() {
+        var _a;
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            let streaming = true;
+            while (streaming) {
+                const { value, done } = yield __await(reader.read());
+                if (done) {
+                    streaming = false;
+                    if (buffer.length > 0) {
+                        const tail = parseSseEvent(buffer.replace(/\r\n/g, '\n'));
+                        if (tail) {
+                            yield yield __await(tail);
+                        }
+                    }
+                    break;
+                }
+                buffer += decoder.decode(value, { stream: true });
+                // SSE messages are separated by a blank line; some servers use \r\n.
+                const normalized = buffer.replace(/\r\n/g, '\n');
+                const parts = normalized.split('\n\n');
+                // Last element is the partial chunk (no terminating blank line yet); buffer it.
+                /* c8 ignore next 1 - defensive: parts.pop() returning undefined is unreachable after split */
+                buffer = (_a = parts.pop()) !== null && _a !== void 0 ? _a : '';
+                for (const chunk of parts) {
+                    const event = parseSseEvent(chunk);
+                    if (event) {
+                        yield yield __await(event);
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    });
+}
+/**
+ * Parses the `data` payload of an SSE event as JSON. Returns undefined for
+ * the OpenAI `[DONE]` sentinel and for any payload that fails to parse —
+ * adapters treat both as "skip this event."
+ *
+ * @internal
+ */
+function parseSseEventJson(data) {
+    if (data === '[DONE]') {
+        return undefined;
+    }
+    try {
+        return JSON.parse(data);
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+//# sourceMappingURL=sseParser.js.map

package/lib/packlets/ai-assist/sseParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseParser.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/sseParser.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 * Server-Sent Events (SSE) parser primitives shared by the streaming format\n * adapters in `streamingClient.ts`. Implements the subset of the SSE wire\n * format that LLM providers actually emit: optional `event:` line, one or\n * more `data:` lines per message, messages separated by a blank line.\n *\n * @packageDocumentation\n */\n\n/**\n * One parsed SSE message (the SSE spec calls each blank-line-terminated\n * record an \"event\").\n *\n * @internal\n */\nexport interface ISseEvent {\n  /** The `event:` field, if present (some providers omit it). */\n  readonly event?: string;\n  /** Concatenated contents of the message's `data:` lines. */\n  readonly data: string;\n}\n\n/**\n * Parses a single SSE message (the text between blank-line separators) into\n * an {@link ISseEvent}. Returns undefined for messages with no `data:` lines\n * (comments, heartbeats).\n *\n * @internal\n */\nexport function parseSseEvent(chunk: string): ISseEvent | undefined {\n  let event: string | undefined;\n  const dataLines: string[] = [];\n  for (const line of chunk.split('\\n')) {\n    if (line.startsWith('event:')) {\n      event = line.slice(6).trim();\n    } else if (line.startsWith('data:')) {\n      // Per the SSE spec the value starts after the colon, with one optional leading space stripped.\n      const value = line.slice(5);\n      dataLines.push(value.startsWith(' ') ? value.slice(1) : value);\n    }\n  }\n  if (dataLines.length === 0) {\n    return undefined;\n  }\n  return event !== undefined ? { event, data: dataLines.join('\\n') } : { data: dataLines.join('\\n') };\n}\n\n/**\n * Reads an SSE response body and yields parsed events. Buffers across read()\n * boundaries so a message split mid-chunk still parses cleanly. Terminates\n * when the stream closes (normal EOF or aborted fetch).\n *\n * @internal\n */\nexport async function* readSseEvents(body: ReadableStream<Uint8Array>): AsyncGenerator<ISseEvent> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = '';\n  try {\n    let streaming = true;\n    while (streaming) {\n      const { value, done } = await reader.read();\n      if (done) {\n        streaming = false;\n        if (buffer.length > 0) {\n          const tail = parseSseEvent(buffer.replace(/\\r\\n/g, '\\n'));\n          if (tail) {\n            yield tail;\n          }\n        }\n        break;\n      }\n      buffer += decoder.decode(value, { stream: true });\n      // SSE messages are separated by a blank line; some servers use \\r\\n.\n      const normalized = buffer.replace(/\\r\\n/g, '\\n');\n      const parts = normalized.split('\\n\\n');\n      // Last element is the partial chunk (no terminating blank line yet); buffer it.\n      /* c8 ignore next 1 - defensive: parts.pop() returning undefined is unreachable after split */\n      buffer = parts.pop() ?? '';\n      for (const chunk of parts) {\n        const event = parseSseEvent(chunk);\n        if (event) {\n          yield event;\n        }\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\n/**\n * Parses the `data` payload of an SSE event as JSON. Returns undefined for\n * the OpenAI `[DONE]` sentinel and for any payload that fails to parse —\n * adapters treat both as \"skip this event.\"\n *\n * @internal\n */\nexport function parseSseEventJson(data: string): unknown | undefined {\n  if (data === '[DONE]') {\n    return undefined;\n  }\n  try {\n    return JSON.parse(data);\n  } catch {\n    return undefined;\n  }\n}\n"]}

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

@@ -0,0 +1,72 @@
+/**
+ * Streaming adapter for the Anthropic Messages API. Handles server tool
+ * use (e.g. `web_search`) as unified `tool-event` markers and client-defined
+ * tool calls (type `tool_use`) with B4 thinking-block accumulation.
+ *
+ * The ordered accumulation buffer preserves all content blocks from the
+ * assistant turn in their original stream positions. The C3 continuation
+ * builder reads this buffer to reconstruct the assistant turn for the
+ * follow-up request.
+ *
+ * @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';
+/**
+ * An accumulated `thinking` block from the assistant turn. The `thinking` text
+ * and `signature` are both concatenated across their respective delta events.
+ * The full block is passed to the C3 continuation builder for round-trip preservation.
+ * @internal
+ */
+export interface IAccumulatedThinkingBlock {
+    readonly type: 'thinking';
+    thinking: string;
+    signature: string;
+}
+/**
+ * An accumulated `redacted_thinking` block from the assistant turn. The `data`
+ * field is opaque and arrives complete in the `content_block_start` event — no
+ * delta events follow. Passed through unmodified to the C3 continuation builder.
+ * @internal
+ */
+export interface IAccumulatedRedactedThinkingBlock {
+    readonly type: 'redacted_thinking';
+    readonly data: string;
+}
+/**
+ * An accumulated `text` block from the assistant turn.
+ * @internal
+ */
+export interface IAccumulatedTextBlock {
+    readonly type: 'text';
+    text: string;
+}
+/**
+ * An accumulated `tool_use` block from the assistant turn (client-defined tool call).
+ * The `argsBuffer` is the concatenation of all `input_json_delta` chunks.
+ * @internal
+ */
+export interface IAccumulatedToolUseBlock {
+    readonly type: 'tool_use';
+    readonly id: string;
+    readonly name: string;
+    argsBuffer: string;
+}
+/**
+ * Discriminated union of all accumulated Anthropic content block types.
+ * The ordered accumulation buffer is a `Map<number, IAccumulatedBlock>` keyed
+ * by the SSE `index` field from `content_block_start` events.
+ * @internal
+ */
+export type IAccumulatedBlock = IAccumulatedThinkingBlock | IAccumulatedRedactedThinkingBlock | IAccumulatedTextBlock | IAccumulatedToolUseBlock;
+/**
+ * Issues a streaming Anthropic Messages request and returns the
+ * unified-event iterable on success.
+ *
+ * @internal
+ */
+export declare function callAnthropicStream(config: IStreamApiConfig, prompt: AiPrompt, messagesBefore: ReadonlyArray<IChatMessage> | undefined, temperature: number | undefined, tools: ReadonlyArray<AiToolConfig> | undefined, logger?: Logging.ILogger, signal?: AbortSignal, resolvedThinking?: IResolvedThinkingConfig, accumulationBuffer?: Map<number, IAccumulatedBlock>, continuationMessages?: ReadonlyArray<JsonObject>, useAdaptiveThinking?: boolean, maxTokens?: number): Promise<Result<AsyncIterable<IAiStreamEvent>>>;
+//# sourceMappingURL=anthropic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../../src/packlets/ai-assist/streamingAdapters/anthropic.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,EAAuC,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,OAAO,EACL,QAAQ,EAER,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAiC,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACzG,OAAO,EACL,gBAAgB,EAMjB,MAAM,UAAU,CAAC;AAMlB;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACrB,wBAAwB,CAAC;AAiX7B;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,QAAQ,EAChB,cAAc,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,SAAS,EACvD,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,SAAS,EAC9C,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,EACxB,MAAM,CAAC,EAAE,WAAW,EACpB,gBAAgB,CAAC,EAAE,uBAAuB,EAC1C,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACnD,oBAAoB,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,EAChD,mBAAmB,GAAE,OAAe,EACpC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAmDhD"}

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

@@ -0,0 +1,379 @@
+"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.callAnthropicStream = callAnthropicStream;
+/**
+ * Streaming adapter for the Anthropic Messages API. Handles server tool
+ * use (e.g. `web_search`) as unified `tool-event` markers and client-defined
+ * tool calls (type `tool_use`) with B4 thinking-block accumulation.
+ *
+ * The ordered accumulation buffer preserves all content blocks from the
+ * assistant turn in their original stream positions. The C3 continuation
+ * builder reads this buffer to reconstruct the assistant turn for the
+ * follow-up request.
+ *
+ * @packageDocumentation
+ */
+const ts_utils_1 = require("@fgv/ts-utils");
+const chatRequestBuilders_1 = require("../chatRequestBuilders");
+const endpoint_1 = require("../endpoint");
+const model_1 = require("../model");
+const sseParser_1 = require("../sseParser");
+const toolFormats_1 = require("../toolFormats");
+const thinkingOptionsResolver_1 = require("../thinkingOptionsResolver");
+const common_1 = require("./common");
+const anthropicContentBlockInner = ts_utils_1.Validators.object({
+    type: ts_utils_1.Validators.string.optional(),
+    name: ts_utils_1.Validators.string.optional(),
+    id: ts_utils_1.Validators.string.optional(),
+    data: ts_utils_1.Validators.string.optional()
+}, { options: { optionalFields: ['type', 'name', 'id', 'data'] } });
+const anthropicContentBlockStartPayload = ts_utils_1.Validators.object({
+    index: ts_utils_1.Validators.number.optional(),
+    content_block: anthropicContentBlockInner
+}, { options: { optionalFields: ['index'] } });
+const anthropicContentBlockDeltaInner = ts_utils_1.Validators.object({
+    type: ts_utils_1.Validators.string.optional(),
+    text: ts_utils_1.Validators.string.optional(),
+    partial_json: ts_utils_1.Validators.string.optional(),
+    thinking: ts_utils_1.Validators.string.optional(),
+    signature: ts_utils_1.Validators.string.optional()
+}, { options: { optionalFields: ['type', 'text', 'partial_json', 'thinking', 'signature'] } });
+const anthropicContentBlockDeltaPayload = ts_utils_1.Validators.object({
+    index: ts_utils_1.Validators.number.optional(),
+    delta: anthropicContentBlockDeltaInner
+}, { options: { optionalFields: ['index'] } });
+const anthropicContentBlockStopPayload = ts_utils_1.Validators.object({ index: ts_utils_1.Validators.number.optional() }, { options: { optionalFields: ['index'] } });
+const anthropicMessageDeltaInner = ts_utils_1.Validators.object({ stop_reason: ts_utils_1.Validators.string.optional() }, { options: { optionalFields: ['stop_reason'] } });
+const anthropicMessageDeltaPayload = ts_utils_1.Validators.object({
+    delta: anthropicMessageDeltaInner
+});
+const anthropicErrorInner = ts_utils_1.Validators.object({ message: ts_utils_1.Validators.string.optional() }, { options: { optionalFields: ['message'] } });
+const anthropicErrorPayload = ts_utils_1.Validators.object({ error: anthropicErrorInner.optional() }, { options: { optionalFields: ['error'] } });
+// ============================================================================
+// Stream translator
+// ============================================================================
+/**
+ * Recognized Anthropic Messages API SSE event names. Anything not in this set surfaces a
+ * one-time `logger.warn` per stream — same rationale as the OpenAI Responses adapter's
+ * `RECOGNIZED_OPENAI_RESPONSES_EVENTS` allowlist in `openaiResponses.ts`. Add to this set
+ * when a new event type is observed and confirmed safe to ignore.
+ *
+ * @internal
+ */
+const RECOGNIZED_ANTHROPIC_EVENTS = new Set([
+    // ---- handled by the translator ----
+    'content_block_start',
+    'content_block_delta',
+    'content_block_stop',
+    'message_delta',
+    'message_stop',
+    'error',
+    // ---- lifecycle / heartbeats: intentionally silent ----
+    'message_start',
+    'ping'
+]);
+/**
+ * Translates an Anthropic Messages API SSE stream into unified events.
+ *
+ * Maintains an ordered accumulation buffer (keyed by SSE `index`) for all
+ * content blocks: `thinking`, `redacted_thinking`, `text`, and `tool_use`.
+ * The buffer is available on the returned generator via `.accumulationBuffer`.
+ *
+ * Unrecognized event names are reported once per stream via `logger?.warn` —
+ * see {@link RECOGNIZED_ANTHROPIC_EVENTS}.
+ *
+ * @internal
+ */
+function translateAnthropicStream(response, accumulationBuffer, logger) {
+    return __asyncGenerator(this, arguments, function* translateAnthropicStream_1() {
+        var _a, e_1, _b, _c;
+        var _d, _e, _f, _g;
+        let fullText = '';
+        let truncated = false;
+        let stopped = false;
+        // Track unrecognized event names we have already warned about, so a hot stream of
+        // an unknown event type produces exactly one log line per name per stream.
+        const warnedEvents = new Set();
+        try {
+            /* c8 ignore next - body is non-null at this point per openSseConnection */
+            if (!response.body)
+                return yield __await(void 0);
+            try {
+                for (var _h = true, _j = __asyncValues((0, sseParser_1.readSseEvents)(response.body)), _k; _k = yield __await(_j.next()), _a = _k.done, !_a; _h = true) {
+                    _c = _k.value;
+                    _h = false;
+                    const message = _c;
+                    const eventName = message.event;
+                    if (eventName === 'content_block_start') {
+                        const payload = (0, common_1.validateEventPayload)((0, sseParser_1.parseSseEventJson)(message.data), anthropicContentBlockStartPayload);
+                        /* c8 ignore next 1 - defensive: payload null branch unreachable after validation */
+                        if (!payload)
+                            continue;
+                        const { index: rawIndex, content_block: block } = payload;
+                        const index = rawIndex !== null && rawIndex !== void 0 ? rawIndex : 0;
+                        if (block.type === 'thinking') {
+                            accumulationBuffer.set(index, { type: 'thinking', thinking: '', signature: '' });
+                        }
+                        else if (block.type === 'redacted_thinking') {
+                            accumulationBuffer.set(index, {
+                                type: 'redacted_thinking',
+                                /* c8 ignore next 1 - defensive: Anthropic always provides data for redacted_thinking */
+                                data: (_d = block.data) !== null && _d !== void 0 ? _d : ''
+                            });
+                        }
+                        else if (block.type === 'text') {
+                            accumulationBuffer.set(index, { type: 'text', text: '' });
+                        }
+                        else if (block.type === 'tool_use') {
+                            // A tool_use block_start MUST carry a non-empty id and name: the id is the
+                            // sole correlation key for the follow-up tool_result, and dropping the block
+                            // silently (then ignoring its input_json_delta chunks at the delta handler
+                            // below) is exactly how an orphaned block leaves the harness without a clean
+                            // id and corrupts the continuation. Surface it loudly instead of dropping it.
+                            if (block.id && block.name) {
+                                accumulationBuffer.set(index, {
+                                    type: 'tool_use',
+                                    id: block.id,
+                                    name: block.name,
+                                    argsBuffer: ''
+                                });
+                                yield yield __await({ type: 'client-tool-call-start', toolName: block.name, callId: block.id });
+                            }
+                            else {
+                                logger === null || logger === void 0 ? void 0 : logger.warn(`${common_1.MALFORMED_TOOL_USE_WARN_TAG} Anthropic streaming adapter: tool_use content_block_start ` +
+                                    `at index ${index} is missing a usable id and/or name ` +
+                                    `(id=${JSON.stringify(block.id)}, name=${JSON.stringify(block.name)}). ` +
+                                    `No client tool call will be issued for this block; its argument deltas are dropped. ` +
+                                    `This usually indicates provider drift or a truncated stream.`);
+                            }
+                        }
+                        else if (block.type === 'server_tool_use' && block.name === 'web_search') {
+                            yield yield __await({ type: 'tool-event', toolType: 'web_search', phase: 'started' });
+                        }
+                        else if (block.type === 'web_search_tool_result') {
+                            yield yield __await({ type: 'tool-event', toolType: 'web_search', phase: 'completed' });
+                        }
+                    }
+                    else if (eventName === 'content_block_delta') {
+                        const payload = (0, common_1.validateEventPayload)((0, sseParser_1.parseSseEventJson)(message.data), anthropicContentBlockDeltaPayload);
+                        /* c8 ignore next 1 - defensive: payload null branch unreachable after validation */
+                        if (!payload)
+                            continue;
+                        const { index: rawDeltaIndex, delta } = payload;
+                        const index = rawDeltaIndex !== null && rawDeltaIndex !== void 0 ? rawDeltaIndex : 0;
+                        const block = accumulationBuffer.get(index);
+                        if (delta.type === 'text_delta' && typeof delta.text === 'string') {
+                            /* c8 ignore next 1 - defensive: delta arrives only after block_start sets buffer entry */
+                            if ((block === null || block === void 0 ? void 0 : block.type) === 'text') {
+                                block.text += delta.text;
+                            }
+                            if (delta.text.length > 0) {
+                                fullText += delta.text;
+                                yield yield __await({ type: 'text-delta', delta: delta.text });
+                            }
+                        }
+                        else if (delta.type === 'input_json_delta' && typeof delta.partial_json === 'string') {
+                            /* c8 ignore next 1 - defensive: delta arrives only after block_start sets buffer entry */
+                            if ((block === null || block === void 0 ? void 0 : block.type) === 'tool_use') {
+                                block.argsBuffer += delta.partial_json;
+                            }
+                        }
+                        else if (delta.type === 'thinking_delta' && typeof delta.thinking === 'string') {
+                            /* c8 ignore next 1 - defensive: delta arrives only after block_start sets buffer entry */
+                            if ((block === null || block === void 0 ? void 0 : block.type) === 'thinking') {
+                                block.thinking += delta.thinking;
+                            }
+                        }
+                        else if (delta.type === 'signature_delta' && typeof delta.signature === 'string') {
+                            // CRITICAL (E5): signature must be APPENDED, not overwritten.
+                            // The signature is base64 arriving in multiple chunks.
+                            // Overwriting produces a truncated signature that Anthropic rejects with HTTP 400.
+                            /* c8 ignore next 1 - defensive: delta arrives only after block_start sets buffer entry */
+                            if ((block === null || block === void 0 ? void 0 : block.type) === 'thinking') {
+                                block.signature += delta.signature;
+                            }
+                        }
+                    }
+                    else if (eventName === 'content_block_stop') {
+                        const payload = (0, common_1.validateEventPayload)((0, sseParser_1.parseSseEventJson)(message.data), anthropicContentBlockStopPayload);
+                        /* c8 ignore next 1 - defensive: payload null branch unreachable after validation */
+                        if (!payload)
+                            continue;
+                        /* c8 ignore next 1 - defensive: payload.index ?? 0 null branch is unreachable */
+                        const block = accumulationBuffer.get((_e = payload.index) !== null && _e !== void 0 ? _e : 0);
+                        /* c8 ignore next 1 - defensive: block always exists when block_stop follows block_start */
+                        if ((block === null || block === void 0 ? void 0 : block.type) === 'tool_use') {
+                            let args;
+                            try {
+                                /* c8 ignore next 1 - defensive: argsBuffer || '{}' empty-string branch unreachable in tests */
+                                const parsed = JSON.parse(block.argsBuffer || '{}');
+                                /* c8 ignore start - defensive: non-object/malformed parse defaults to empty object */
+                                args =
+                                    parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)
+                                        ? parsed
+                                        : {};
+                            }
+                            catch (_l) {
+                                args = {};
+                            }
+                            /* c8 ignore stop */
+                            yield yield __await({ type: 'client-tool-call-done', toolName: block.name, callId: block.id, args });
+                        }
+                    }
+                    else if (eventName === 'message_delta') {
+                        const payload = (0, common_1.validateEventPayload)((0, sseParser_1.parseSseEventJson)(message.data), anthropicMessageDeltaPayload);
+                        /* c8 ignore next 1 - defensive: payload?.delta null branch unreachable after validation */
+                        if ((payload === null || payload === void 0 ? void 0 : payload.delta.stop_reason) === 'max_tokens') {
+                            truncated = true;
+                        }
+                    }
+                    else if (eventName === 'message_stop') {
+                        stopped = true;
+                    }
+                    else if (eventName === 'error') {
+                        const payload = (0, common_1.validateEventPayload)((0, sseParser_1.parseSseEventJson)(message.data), anthropicErrorPayload);
+                        yield yield __await({
+                            type: 'error',
+                            /* c8 ignore next 1 - defensive: payload?.error null branch unreachable after validation */
+                            message: (_g = (_f = payload === null || payload === void 0 ? void 0 : payload.error) === null || _f === void 0 ? void 0 : _f.message) !== null && _g !== void 0 ? _g : 'Anthropic stream returned an error event'
+                        });
+                        return yield __await(void 0);
+                    }
+                    else if (typeof eventName === 'string' &&
+                        !RECOGNIZED_ANTHROPIC_EVENTS.has(eventName) &&
+                        !warnedEvents.has(eventName)) {
+                        // Empirical drift instrument: an unrecognized Anthropic event surfaces as a one-time
+                        // warning per stream. Update RECOGNIZED_ANTHROPIC_EVENTS once the new event is either
+                        // handled or confirmed safe to ignore.
+                        warnedEvents.add(eventName);
+                        logger === null || logger === void 0 ? void 0 : logger.warn(`${common_1.UNRECOGNIZED_EVENT_WARN_TAG} Anthropic streaming adapter: unrecognized SSE event ` +
+                            `'${eventName}'. ` +
+                            `payload preview: ${(0, common_1.formatUnrecognizedEventPayloadPreview)(message.data)}. ` +
+                            `This may indicate provider drift — if the new event carries data the adapter ` +
+                            `should surface, add a handler; otherwise add the name to ` +
+                            `RECOGNIZED_ANTHROPIC_EVENTS.`);
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_h && !_a && (_b = _j.return)) yield __await(_b.call(_j));
+                }
+                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 (stopped) {
+            yield yield __await({ type: 'done', truncated, fullText });
+        }
+        else {
+            yield yield __await({ type: 'error', message: 'Anthropic stream ended without a message_stop event' });
+        }
+    });
+}
+// ============================================================================
+// Per-format request caller
+// ============================================================================
+/**
+ * Issues a streaming Anthropic Messages request and returns the
+ * unified-event iterable on success.
+ *
+ * @internal
+ */
+async function callAnthropicStream(config, prompt, messagesBefore, temperature, tools, logger, signal, resolvedThinking, accumulationBuffer, continuationMessages, useAdaptiveThinking = false, maxTokens) {
+    const url = `${config.baseUrl}/messages`;
+    const messages = (0, chatRequestBuilders_1.buildAnthropicMessages)(prompt, {
+        head: messagesBefore,
+        rawTail: continuationMessages
+    });
+    const body = {
+        model: config.model,
+        system: prompt.system,
+        messages,
+        // Anthropic's Messages API requires max_tokens on every request — see
+        // AiAssist.DEFAULT_ANTHROPIC_MAX_TOKENS for why only this provider defaults it.
+        max_tokens: maxTokens !== null && maxTokens !== void 0 ? maxTokens : model_1.DEFAULT_ANTHROPIC_MAX_TOKENS,
+        stream: true
+    };
+    // Temperature is sent only when explicitly provided (Claude-5 rejects any temperature). When
+    // thinking is active it is also rejected — the completion/streaming paths validate this upstream,
+    // and the effort gate here is the safety net for the (unguarded) client-tool path.
+    if ((resolvedThinking === null || resolvedThinking === void 0 ? void 0 : resolvedThinking.anthropicEffort) === undefined) {
+        if (temperature !== undefined) {
+            body.temperature = temperature;
+        }
+    }
+    if ((resolvedThinking === null || resolvedThinking === void 0 ? void 0 : resolvedThinking.anthropicEffort) !== undefined) {
+        if (useAdaptiveThinking) {
+            // Claude 5 family: adaptive thinking — no budget_tokens; effort moves to the
+            // top-level output_config block. See AiAssist.isAdaptiveThinkingModel.
+            body.thinking = { type: 'adaptive' };
+            body.output_config = { effort: resolvedThinking.anthropicEffort };
+        }
+        else {
+            body.thinking = {
+                type: 'enabled',
+                budget_tokens: (0, thinkingOptionsResolver_1.anthropicEffortToBudgetTokens)(resolvedThinking.anthropicEffort)
+            };
+        }
+    }
+    if ((resolvedThinking === null || resolvedThinking === void 0 ? void 0 : resolvedThinking.otherParams) !== undefined) {
+        Object.assign(body, resolvedThinking.otherParams);
+    }
+    if (tools && tools.length > 0) {
+        body.tools = (0, toolFormats_1.toAnthropicTools)(tools);
+    }
+    const headers = (0, endpoint_1.anthropicAuthHeaders)(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(`Anthropic streaming: model=${config.model}, tools=${toolTypes}`);
+    }
+    const buffer = accumulationBuffer !== null && accumulationBuffer !== void 0 ? accumulationBuffer : new Map();
+    const conn = await (0, common_1.openSseConnection)(url, headers, body, logger, signal);
+    return conn.onSuccess((response) => (0, ts_utils_1.succeed)(translateAnthropicStream(response, buffer, logger)));
+}
+//# sourceMappingURL=anthropic.js.map