@a-dray/aglib 0.1.0

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"","sourcesContent":["/** Anything that survives a round-trip through storage or a provider wire. */\nexport type JsonValue =\n  | null\n  | boolean\n  | number\n  | string\n  | readonly JsonValue[]\n  | { readonly [key: string]: JsonValue };\n"]}

package/dist/model/adapters/anthropic/index.d.ts

@@ -0,0 +1,34 @@
+import type { Model } from "../../model.js";
+export interface AnthropicOptions {
+    apiKey: string;
+    model: string;
+    baseUrl?: string;
+    version?: string;
+    fetch?: typeof fetch;
+}
+/**
+ * The Anthropic Messages wire.
+ *
+ * A genuinely different shape from OpenAI's — the leading system prompt hoisted
+ * out of the message list, tool results carried as user content blocks, cache
+ * breakpoints marked inline — which is the point of it being here: a port
+ * proved against one wire format has not been proved.
+ *
+ * Three things this wire will refuse, and what we send instead:
+ *
+ * - **Thinking budgets.** `thinking: { type: "enabled", budget_tokens }` is
+ *   removed on the current models and returns 400. Depth is `output_config.effort`
+ *   over adaptive thinking, so `effort` maps there and nothing computes a budget.
+ * - **Sampling controls.** `temperature`, `top_p` and `top_k` are removed on the
+ *   same models. `ModelRequest.temperature` is therefore dropped here rather
+ *   than forwarded into a request the provider rejects.
+ * - **A system message in the middle of a turn.** Only the *leading* run of
+ *   system messages becomes the `system` field. One arriving after the
+ *   conversation has started is turn-scoped context, which the projection
+ *   deliberately places after the cache boundary, so it stays in `messages` as
+ *   a mid-conversation system message. Hoisting it would put the one thing that
+ *   changes every turn at the front of the prefix that must not change.
+ *   Supported on Opus 5, Opus 4.8 and Fable 5; a model without it fails the
+ *   request rather than silently having its cache invalidated every turn.
+ */
+export declare function createAnthropicModel(options: AnthropicOptions): Model;

package/dist/model/adapters/anthropic/index.js

@@ -0,0 +1,271 @@
+import { err, ok } from "../../../result.js";
+import { textOf } from "../../../content.js";
+/**
+ * The Anthropic Messages wire.
+ *
+ * A genuinely different shape from OpenAI's — the leading system prompt hoisted
+ * out of the message list, tool results carried as user content blocks, cache
+ * breakpoints marked inline — which is the point of it being here: a port
+ * proved against one wire format has not been proved.
+ *
+ * Three things this wire will refuse, and what we send instead:
+ *
+ * - **Thinking budgets.** `thinking: { type: "enabled", budget_tokens }` is
+ *   removed on the current models and returns 400. Depth is `output_config.effort`
+ *   over adaptive thinking, so `effort` maps there and nothing computes a budget.
+ * - **Sampling controls.** `temperature`, `top_p` and `top_k` are removed on the
+ *   same models. `ModelRequest.temperature` is therefore dropped here rather
+ *   than forwarded into a request the provider rejects.
+ * - **A system message in the middle of a turn.** Only the *leading* run of
+ *   system messages becomes the `system` field. One arriving after the
+ *   conversation has started is turn-scoped context, which the projection
+ *   deliberately places after the cache boundary, so it stays in `messages` as
+ *   a mid-conversation system message. Hoisting it would put the one thing that
+ *   changes every turn at the front of the prefix that must not change.
+ *   Supported on Opus 5, Opus 4.8 and Fable 5; a model without it fails the
+ *   request rather than silently having its cache invalidated every turn.
+ */
+export function createAnthropicModel(options) {
+    const call = options.fetch ?? fetch;
+    const baseUrl = options.baseUrl ?? "https://api.anthropic.com/v1";
+    return {
+        id: `anthropic:${options.model}`,
+        async *generate(request) {
+            // Only the leading run of system messages is the system prompt. Anything
+            // after it belongs where the projection put it — see the header.
+            let lead = 0;
+            while (lead < request.messages.length && request.messages[lead].role === "system")
+                lead += 1;
+            const system = request.messages.slice(0, lead).map((message) => textOf(message.content));
+            const conversation = request.messages.slice(lead);
+            // The prefix ends where the caller says it does. In practice that is the
+            // end of the system prompt, which is the one span fixed for the whole
+            // run; a mark past it is honoured too rather than quietly ignored.
+            const boundary = request.cacheAfter;
+            const cacheSystem = boundary !== undefined && boundary >= lead && system.length > 0;
+            const cacheAt = boundary !== undefined && boundary > lead ? boundary - lead - 1 : -1;
+            const maxOutputTokens = request.maxOutputTokens ?? 32_000;
+            let response;
+            try {
+                response = await call(`${baseUrl}/messages`, {
+                    method: "POST",
+                    headers: {
+                        "content-type": "application/json",
+                        "x-api-key": options.apiKey,
+                        "anthropic-version": options.version ?? "2023-06-01",
+                    },
+                    body: JSON.stringify({
+                        model: options.model,
+                        max_tokens: maxOutputTokens,
+                        ...(system.length ? { system: encodeSystem(system, cacheSystem) } : {}),
+                        messages: encodeConversation(conversation, cacheAt),
+                        ...(request.tools?.length ? { tools: request.tools.map(encodeTool) } : {}),
+                        ...(request.effort
+                            ? { thinking: { type: "adaptive" }, output_config: { effort: request.effort } }
+                            : {}),
+                        stream: true,
+                    }),
+                    ...(request.signal ? { signal: request.signal } : {}),
+                });
+            }
+            catch (error) {
+                return err(transportError(error, request.signal));
+            }
+            if (!response.ok)
+                return err(await httpError(response));
+            if (!response.body)
+                return err({ code: "provider", message: "No response body", retryable: true });
+            const text = [];
+            const calls = [];
+            let partial = "";
+            let stop;
+            let usage = {};
+            let model;
+            // A stream that dies mid-body — cancelled, dropped, truncated — must come
+            // back as a typed failure like any other. Without this the generator throws,
+            // `run.result` rejects instead of resolving `cancelled`, no `run.finished`
+            // is ever committed, and the activation stays open until its claim expires.
+            try {
+                for await (const event of sseData(response.body)) {
+                    let frame;
+                    try {
+                        frame = JSON.parse(event);
+                    }
+                    catch {
+                        continue;
+                    }
+                    if (frame.type === "message_start" && frame.message) {
+                        model = frame.message.model;
+                        usage = { ...usage, ...decodeUsage(frame.message.usage) };
+                    }
+                    if (frame.type === "content_block_start" && frame.content_block?.type === "tool_use") {
+                        calls.push({ callId: frame.content_block.id, name: frame.content_block.name, arguments: "" });
+                        partial = "";
+                    }
+                    if (frame.type === "content_block_delta") {
+                        const delta = frame.delta;
+                        if (delta.type === "text_delta" && delta.text) {
+                            text.push(delta.text);
+                            yield { type: "text.delta", text: delta.text };
+                        }
+                        if (delta.type === "thinking_delta" && delta.thinking)
+                            yield { type: "reasoning.delta", text: delta.thinking };
+                        if (delta.type === "input_json_delta" && delta.partial_json !== undefined) {
+                            partial += delta.partial_json;
+                            const current = calls.at(-1);
+                            if (current)
+                                yield { type: "tool-call.delta", callId: current.callId, arguments: delta.partial_json };
+                        }
+                    }
+                    if (frame.type === "content_block_stop" && calls.length) {
+                        const current = calls.at(-1);
+                        if (!current.arguments)
+                            current.arguments = partial || "{}";
+                    }
+                    if (frame.type === "message_delta") {
+                        stop = frame.delta?.stop_reason ?? stop;
+                        usage = { ...usage, ...decodeUsage(frame.usage) };
+                    }
+                    if (frame.type === "error") {
+                        return err({ code: "provider", message: frame.error?.message ?? "Provider error", retryable: true });
+                    }
+                }
+            }
+            catch (error) {
+                return err(transportError(error, request.signal));
+            }
+            return ok({
+                message: { content: text.join(""), ...(calls.length ? { calls } : {}) },
+                finishReason: stop === "max_tokens" ? "length" : stop === "refusal" ? "refusal" : calls.length ? "tool-calls" : "stop",
+                usage,
+                ...(model ? { model } : {}),
+            });
+        },
+    };
+}
+/**
+ * Text blocks rather than one joined string, so the end of the prefix can carry
+ * a breakpoint. Only the last block is marked: a breakpoint caches everything
+ * before it, so marking each one would buy nothing and spend the budget of four.
+ */
+function encodeSystem(blocks, cache) {
+    return blocks.map((text, index) => ({
+        type: "text",
+        text,
+        ...(cache && index === blocks.length - 1 ? { cache_control: { type: "ephemeral" } } : {}),
+    }));
+}
+/**
+ * Tool results are user-role content blocks here, not a role of their own.
+ *
+ * `cacheAt` is an index into `messages`; the breakpoint lands on the last
+ * content block that message produced. Tool results merge into a preceding user
+ * block, so the mapping from message to block is not one to one and the mark is
+ * placed as each message is encoded rather than computed afterwards.
+ */
+function encodeConversation(messages, cacheAt = -1) {
+    const out = [];
+    let mark;
+    messages.forEach((message, index) => {
+        if (message.role === "tool") {
+            const block = {
+                type: "tool_result", tool_use_id: message.callId, content: textOf(message.content),
+                ...(message.isError ? { is_error: true } : {}),
+            };
+            const last = out.at(-1);
+            if (last?.role === "user")
+                last.content.push(block);
+            else
+                out.push({ role: "user", content: [block] });
+        }
+        else if (message.role === "assistant") {
+            const content = [];
+            const spoken = textOf(message.content);
+            if (spoken)
+                content.push({ type: "text", text: spoken });
+            for (const call of message.calls ?? []) {
+                content.push({ type: "tool_use", id: call.callId, name: call.name, input: safeJson(call.arguments) });
+            }
+            out.push({ role: "assistant", content });
+        }
+        else if (message.role === "system") {
+            // Turn-scoped context, kept where the projection put it: an operator
+            // instruction inside the conversation leaves the cached prefix intact,
+            // where rewriting the front of it would invalidate every following turn.
+            out.push({ role: "system", content: encodeContent(message.content) });
+        }
+        else {
+            out.push({ role: "user", content: encodeContent(message.content) });
+        }
+        if (index === cacheAt)
+            mark = out.at(-1)?.content;
+    });
+    const block = mark?.at(-1);
+    if (block)
+        block["cache_control"] = { type: "ephemeral" };
+    return out;
+}
+function encodeContent(content) {
+    if (typeof content === "string")
+        return [{ type: "text", text: content }];
+    const parts = [];
+    for (const part of content) {
+        if (part.type === "text")
+            parts.push({ type: "text", text: part.text });
+        if (part.type === "image") {
+            parts.push(part.source.kind === "url"
+                ? { type: "image", source: { type: "url", url: part.source.url } }
+                : { type: "image", source: { type: "base64", media_type: part.mediaType, data: part.source.data } });
+        }
+    }
+    return parts;
+}
+const encodeTool = (tool) => ({
+    name: tool.name, description: tool.description, input_schema: tool.parameters,
+});
+const safeJson = (raw) => { try {
+    return JSON.parse(raw);
+}
+catch {
+    return {};
+} };
+const decodeUsage = (usage) => usage ? {
+    ...(usage.input_tokens !== undefined ? { inputTokens: usage.input_tokens } : {}),
+    ...(usage.output_tokens !== undefined ? { outputTokens: usage.output_tokens } : {}),
+    ...(usage.cache_read_input_tokens !== undefined ? { cacheReadTokens: usage.cache_read_input_tokens } : {}),
+    ...(usage.cache_creation_input_tokens !== undefined ? { cacheWriteTokens: usage.cache_creation_input_tokens } : {}),
+} : {};
+async function httpError(response) {
+    const body = await response.text().catch(() => "");
+    const code = response.status === 401 || response.status === 403 ? "auth"
+        : response.status === 429 ? "rate-limit"
+            : response.status === 400 && /prompt is too long|context/i.test(body) ? "context-length"
+                : response.status >= 500 ? "provider"
+                    : "failed";
+    return {
+        code,
+        message: `${response.status} ${response.statusText}${body ? `: ${body.slice(0, 400)}` : ""}`,
+        retryable: code === "rate-limit" || code === "provider",
+    };
+}
+function transportError(error, signal) {
+    if (signal?.aborted)
+        return { code: "cancelled", message: "Generation cancelled", retryable: false };
+    return { code: "provider", message: error instanceof Error ? error.message : String(error), retryable: true };
+}
+async function* sseData(body) {
+    const decoder = new TextDecoder();
+    let buffer = "";
+    for await (const chunk of body) {
+        buffer += decoder.decode(chunk, { stream: true });
+        let newline = buffer.indexOf("\n");
+        while (newline >= 0) {
+            const line = buffer.slice(0, newline).trim();
+            buffer = buffer.slice(newline + 1);
+            if (line.startsWith("data:"))
+                yield line.slice(5).trim();
+            newline = buffer.indexOf("\n");
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/model/adapters/anthropic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/model/adapters/anthropic/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ContentPart, Message, Model, ModelDelta, ModelError, ModelRequest, ModelResponse, ToolCall, ToolSpec, Usage,\n} from \"../../model.js\";\nimport { err, ok, type Result } from \"../../../result.js\";\nimport { textOf } from \"../../../content.js\";\n\nexport interface AnthropicOptions {\n  apiKey: string;\n  model: string;\n  baseUrl?: string;\n  version?: string;\n  fetch?: typeof fetch;\n}\n\n/**\n * The Anthropic Messages wire.\n *\n * A genuinely different shape from OpenAI's — the leading system prompt hoisted\n * out of the message list, tool results carried as user content blocks, cache\n * breakpoints marked inline — which is the point of it being here: a port\n * proved against one wire format has not been proved.\n *\n * Three things this wire will refuse, and what we send instead:\n *\n * - **Thinking budgets.** `thinking: { type: \"enabled\", budget_tokens }` is\n *   removed on the current models and returns 400. Depth is `output_config.effort`\n *   over adaptive thinking, so `effort` maps there and nothing computes a budget.\n * - **Sampling controls.** `temperature`, `top_p` and `top_k` are removed on the\n *   same models. `ModelRequest.temperature` is therefore dropped here rather\n *   than forwarded into a request the provider rejects.\n * - **A system message in the middle of a turn.** Only the *leading* run of\n *   system messages becomes the `system` field. One arriving after the\n *   conversation has started is turn-scoped context, which the projection\n *   deliberately places after the cache boundary, so it stays in `messages` as\n *   a mid-conversation system message. Hoisting it would put the one thing that\n *   changes every turn at the front of the prefix that must not change.\n *   Supported on Opus 5, Opus 4.8 and Fable 5; a model without it fails the\n *   request rather than silently having its cache invalidated every turn.\n */\nexport function createAnthropicModel(options: AnthropicOptions): Model {\n  const call = options.fetch ?? fetch;\n  const baseUrl = options.baseUrl ?? \"https://api.anthropic.com/v1\";\n\n  return {\n    id: `anthropic:${options.model}`,\n\n    async *generate(request: ModelRequest): AsyncGenerator<ModelDelta, Result<ModelResponse, ModelError>> {\n      // Only the leading run of system messages is the system prompt. Anything\n      // after it belongs where the projection put it — see the header.\n      let lead = 0;\n      while (lead < request.messages.length && request.messages[lead]!.role === \"system\") lead += 1;\n      const system = request.messages.slice(0, lead).map((message) => textOf(message.content));\n      const conversation = request.messages.slice(lead);\n\n      // The prefix ends where the caller says it does. In practice that is the\n      // end of the system prompt, which is the one span fixed for the whole\n      // run; a mark past it is honoured too rather than quietly ignored.\n      const boundary = request.cacheAfter;\n      const cacheSystem = boundary !== undefined && boundary >= lead && system.length > 0;\n      const cacheAt = boundary !== undefined && boundary > lead ? boundary - lead - 1 : -1;\n\n      const maxOutputTokens = request.maxOutputTokens ?? 32_000;\n\n      let response: Response;\n      try {\n        response = await call(`${baseUrl}/messages`, {\n          method: \"POST\",\n          headers: {\n            \"content-type\": \"application/json\",\n            \"x-api-key\": options.apiKey,\n            \"anthropic-version\": options.version ?? \"2023-06-01\",\n          },\n          body: JSON.stringify({\n            model: options.model,\n            max_tokens: maxOutputTokens,\n            ...(system.length ? { system: encodeSystem(system, cacheSystem) } : {}),\n            messages: encodeConversation(conversation, cacheAt),\n            ...(request.tools?.length ? { tools: request.tools.map(encodeTool) } : {}),\n            ...(request.effort\n              ? { thinking: { type: \"adaptive\" }, output_config: { effort: request.effort } }\n              : {}),\n            stream: true,\n          }),\n          ...(request.signal ? { signal: request.signal } : {}),\n        });\n      } catch (error) {\n        return err(transportError(error, request.signal));\n      }\n      if (!response.ok) return err(await httpError(response));\n      if (!response.body) return err({ code: \"provider\", message: \"No response body\", retryable: true });\n\n      const text: string[] = [];\n      const calls: ToolCall[] = [];\n      let partial = \"\";\n      let stop: string | undefined;\n      let usage: Usage = {};\n      let model: string | undefined;\n\n      // A stream that dies mid-body — cancelled, dropped, truncated — must come\n      // back as a typed failure like any other. Without this the generator throws,\n      // `run.result` rejects instead of resolving `cancelled`, no `run.finished`\n      // is ever committed, and the activation stays open until its claim expires.\n      try {\n        for await (const event of sseData(response.body)) {\n          let frame: AnthropicFrame;\n          try { frame = JSON.parse(event) as AnthropicFrame; } catch { continue; }\n\n          if (frame.type === \"message_start\" && frame.message) {\n            model = frame.message.model;\n            usage = { ...usage, ...decodeUsage(frame.message.usage) };\n          }\n          if (frame.type === \"content_block_start\" && frame.content_block?.type === \"tool_use\") {\n            calls.push({ callId: frame.content_block.id!, name: frame.content_block.name!, arguments: \"\" });\n            partial = \"\";\n          }\n          if (frame.type === \"content_block_delta\") {\n            const delta = frame.delta!;\n            if (delta.type === \"text_delta\" && delta.text) { text.push(delta.text); yield { type: \"text.delta\", text: delta.text }; }\n            if (delta.type === \"thinking_delta\" && delta.thinking) yield { type: \"reasoning.delta\", text: delta.thinking };\n            if (delta.type === \"input_json_delta\" && delta.partial_json !== undefined) {\n              partial += delta.partial_json;\n              const current = calls.at(-1);\n              if (current) yield { type: \"tool-call.delta\", callId: current.callId, arguments: delta.partial_json };\n            }\n          }\n          if (frame.type === \"content_block_stop\" && calls.length) {\n            const current = calls.at(-1)!;\n            if (!current.arguments) current.arguments = partial || \"{}\";\n          }\n          if (frame.type === \"message_delta\") {\n            stop = frame.delta?.stop_reason ?? stop;\n            usage = { ...usage, ...decodeUsage(frame.usage) };\n          }\n          if (frame.type === \"error\") {\n            return err({ code: \"provider\", message: frame.error?.message ?? \"Provider error\", retryable: true });\n          }\n        }\n      } catch (error) {\n        return err(transportError(error, request.signal));\n      }\n\n      return ok({\n        message: { content: text.join(\"\"), ...(calls.length ? { calls } : {}) },\n        finishReason: stop === \"max_tokens\" ? \"length\" : stop === \"refusal\" ? \"refusal\" : calls.length ? \"tool-calls\" : \"stop\",\n        usage,\n        ...(model ? { model } : {}),\n      });\n    },\n  };\n}\n\n/**\n * Text blocks rather than one joined string, so the end of the prefix can carry\n * a breakpoint. Only the last block is marked: a breakpoint caches everything\n * before it, so marking each one would buy nothing and spend the budget of four.\n */\nfunction encodeSystem(blocks: readonly string[], cache: boolean): unknown[] {\n  return blocks.map((text, index) => ({\n    type: \"text\",\n    text,\n    ...(cache && index === blocks.length - 1 ? { cache_control: { type: \"ephemeral\" } } : {}),\n  }));\n}\n\n/**\n * Tool results are user-role content blocks here, not a role of their own.\n *\n * `cacheAt` is an index into `messages`; the breakpoint lands on the last\n * content block that message produced. Tool results merge into a preceding user\n * block, so the mapping from message to block is not one to one and the mark is\n * placed as each message is encoded rather than computed afterwards.\n */\nfunction encodeConversation(messages: readonly Message[], cacheAt = -1): unknown[] {\n  const out: { role: string; content: unknown[] }[] = [];\n  let mark: unknown[] | undefined;\n\n  messages.forEach((message, index) => {\n    if (message.role === \"tool\") {\n      const block = {\n        type: \"tool_result\", tool_use_id: message.callId, content: textOf(message.content),\n        ...(message.isError ? { is_error: true } : {}),\n      };\n      const last = out.at(-1);\n      if (last?.role === \"user\") last.content.push(block);\n      else out.push({ role: \"user\", content: [block] });\n    } else if (message.role === \"assistant\") {\n      const content: unknown[] = [];\n      const spoken = textOf(message.content);\n      if (spoken) content.push({ type: \"text\", text: spoken });\n      for (const call of message.calls ?? []) {\n        content.push({ type: \"tool_use\", id: call.callId, name: call.name, input: safeJson(call.arguments) });\n      }\n      out.push({ role: \"assistant\", content });\n    } else if (message.role === \"system\") {\n      // Turn-scoped context, kept where the projection put it: an operator\n      // instruction inside the conversation leaves the cached prefix intact,\n      // where rewriting the front of it would invalidate every following turn.\n      out.push({ role: \"system\", content: encodeContent(message.content) });\n    } else {\n      out.push({ role: \"user\", content: encodeContent(message.content) });\n    }\n    if (index === cacheAt) mark = out.at(-1)?.content;\n  });\n\n  const block = mark?.at(-1) as Record<string, unknown> | undefined;\n  if (block) block[\"cache_control\"] = { type: \"ephemeral\" };\n  return out;\n}\n\nfunction encodeContent(content: Message[\"content\"]): unknown[] {\n  if (typeof content === \"string\") return [{ type: \"text\", text: content }];\n  const parts: unknown[] = [];\n  for (const part of content as readonly ContentPart[]) {\n    if (part.type === \"text\") parts.push({ type: \"text\", text: part.text });\n    if (part.type === \"image\") {\n      parts.push(part.source.kind === \"url\"\n        ? { type: \"image\", source: { type: \"url\", url: part.source.url } }\n        : { type: \"image\", source: { type: \"base64\", media_type: part.mediaType, data: part.source.data } });\n    }\n  }\n  return parts;\n}\n\nconst encodeTool = (tool: ToolSpec) => ({\n  name: tool.name, description: tool.description, input_schema: tool.parameters,\n});\n\nconst safeJson = (raw: string): unknown => { try { return JSON.parse(raw); } catch { return {}; } };\n\nconst decodeUsage = (usage: AnthropicUsage | undefined): Usage => usage ? {\n  ...(usage.input_tokens !== undefined ? { inputTokens: usage.input_tokens } : {}),\n  ...(usage.output_tokens !== undefined ? { outputTokens: usage.output_tokens } : {}),\n  ...(usage.cache_read_input_tokens !== undefined ? { cacheReadTokens: usage.cache_read_input_tokens } : {}),\n  ...(usage.cache_creation_input_tokens !== undefined ? { cacheWriteTokens: usage.cache_creation_input_tokens } : {}),\n} : {};\n\nasync function httpError(response: Response): Promise<ModelError> {\n  const body = await response.text().catch(() => \"\");\n  const code: ModelError[\"code\"] =\n    response.status === 401 || response.status === 403 ? \"auth\"\n    : response.status === 429 ? \"rate-limit\"\n    : response.status === 400 && /prompt is too long|context/i.test(body) ? \"context-length\"\n    : response.status >= 500 ? \"provider\"\n    : \"failed\";\n  return {\n    code,\n    message: `${response.status} ${response.statusText}${body ? `: ${body.slice(0, 400)}` : \"\"}`,\n    retryable: code === \"rate-limit\" || code === \"provider\",\n  };\n}\n\nfunction transportError(error: unknown, signal?: AbortSignal): ModelError {\n  if (signal?.aborted) return { code: \"cancelled\", message: \"Generation cancelled\", retryable: false };\n  return { code: \"provider\", message: error instanceof Error ? error.message : String(error), retryable: true };\n}\n\nasync function* sseData(body: ReadableStream<Uint8Array>): AsyncGenerator<string> {\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  for await (const chunk of body as unknown as AsyncIterable<Uint8Array>) {\n    buffer += decoder.decode(chunk, { stream: true });\n    let newline = buffer.indexOf(\"\\n\");\n    while (newline >= 0) {\n      const line = buffer.slice(0, newline).trim();\n      buffer = buffer.slice(newline + 1);\n      if (line.startsWith(\"data:\")) yield line.slice(5).trim();\n      newline = buffer.indexOf(\"\\n\");\n    }\n  }\n}\n\ninterface AnthropicUsage {\n  input_tokens?: number; output_tokens?: number;\n  cache_read_input_tokens?: number; cache_creation_input_tokens?: number;\n}\ninterface AnthropicFrame {\n  type: string;\n  message?: { model?: string; usage?: AnthropicUsage };\n  content_block?: { type: string; id?: string; name?: string };\n  delta?: { type?: string; text?: string; thinking?: string; partial_json?: string; stop_reason?: string };\n  usage?: AnthropicUsage;\n  error?: { message?: string };\n}\n"]}

package/dist/model/adapters/fake/index.d.ts

@@ -0,0 +1,27 @@
+import type { Model, ToolCall, Usage } from "../../model.js";
+export interface FakeResponse {
+    text?: string;
+    calls?: readonly ToolCall[];
+    usage?: Usage;
+    /** Which model the provider says answered. Absent, like a provider that does not say. */
+    model?: string;
+    /**
+     * Why the turn ended, where the response's own shape cannot say.
+     *
+     * Only these two: `stop` and `tool-calls` are already determined by whether
+     * there are calls, and a second way to say them would be a second answer to
+     * one question. Being cut off at the ceiling or declined by the provider is a
+     * fact nothing else here expresses — and without it the loop's two branches
+     * for exactly those endings are unreachable from any test.
+     */
+    finishReason?: "length" | "refusal";
+}
+/**
+ * Returns the given responses in order.
+ *
+ * Deliberately dumb. It is a real implementation of the port — so it runs the
+ * same conformance the providers do — and it has exactly one way to express
+ * each fact. Running out of responses is an error, never a repeat: a fake more
+ * forgiving than reality quietly makes tests pass that should not.
+ */
+export declare function createFakeModel(responses: readonly FakeResponse[]): Model;

package/dist/model/adapters/fake/index.js

@@ -0,0 +1,37 @@
+import { err, ok } from "../../../result.js";
+/**
+ * Returns the given responses in order.
+ *
+ * Deliberately dumb. It is a real implementation of the port — so it runs the
+ * same conformance the providers do — and it has exactly one way to express
+ * each fact. Running out of responses is an error, never a repeat: a fake more
+ * forgiving than reality quietly makes tests pass that should not.
+ */
+export function createFakeModel(responses) {
+    let cursor = 0;
+    return {
+        id: "fake",
+        async *generate({ signal }) {
+            if (signal?.aborted)
+                return err({ code: "cancelled", message: "Generation cancelled", retryable: false });
+            const response = responses[cursor];
+            cursor += 1;
+            if (!response) {
+                return err({
+                    code: "provider",
+                    message: `Fake model has no response for call ${cursor}; it was given ${responses.length}`,
+                    retryable: false,
+                });
+            }
+            if (response.text)
+                yield { type: "text.delta", text: response.text };
+            return ok({
+                message: { content: response.text ?? "", ...(response.calls?.length ? { calls: response.calls } : {}) },
+                finishReason: response.finishReason ?? (response.calls?.length ? "tool-calls" : "stop"),
+                usage: response.usage ?? {},
+                ...(response.model ? { model: response.model } : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/model/adapters/fake/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/model/adapters/fake/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,oBAAoB,CAAC;AAoB1D;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,SAAkC;IAChE,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO;QACL,EAAE,EAAE,MAAM;QACV,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE;YACxB,IAAI,MAAM,EAAE,OAAO;gBAAE,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1G,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,CAAC;YACZ,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,GAAG,CAAC;oBACT,IAAI,EAAE,UAAU;oBAChB,OAAO,EAAE,uCAAuC,MAAM,kBAAkB,SAAS,CAAC,MAAM,EAAE;oBAC1F,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,QAAQ,CAAC,IAAI;gBAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrE,OAAO,EAAE,CAAC;gBACR,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;gBACvG,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;gBACvF,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE;gBAC3B,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrD,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { Model, ModelDelta, ModelError, ModelResponse, ToolCall, Usage } from \"../../model.js\";\nimport { err, ok, type Result } from \"../../../result.js\";\n\nexport interface FakeResponse {\n  text?: string;\n  calls?: readonly ToolCall[];\n  usage?: Usage;\n  /** Which model the provider says answered. Absent, like a provider that does not say. */\n  model?: string;\n  /**\n   * Why the turn ended, where the response's own shape cannot say.\n   *\n   * Only these two: `stop` and `tool-calls` are already determined by whether\n   * there are calls, and a second way to say them would be a second answer to\n   * one question. Being cut off at the ceiling or declined by the provider is a\n   * fact nothing else here expresses — and without it the loop's two branches\n   * for exactly those endings are unreachable from any test.\n   */\n  finishReason?: \"length\" | \"refusal\";\n}\n\n/**\n * Returns the given responses in order.\n *\n * Deliberately dumb. It is a real implementation of the port — so it runs the\n * same conformance the providers do — and it has exactly one way to express\n * each fact. Running out of responses is an error, never a repeat: a fake more\n * forgiving than reality quietly makes tests pass that should not.\n */\nexport function createFakeModel(responses: readonly FakeResponse[]): Model {\n  let cursor = 0;\n  return {\n    id: \"fake\",\n    async *generate({ signal }): AsyncGenerator<ModelDelta, Result<ModelResponse, ModelError>> {\n      if (signal?.aborted) return err({ code: \"cancelled\", message: \"Generation cancelled\", retryable: false });\n      const response = responses[cursor];\n      cursor += 1;\n      if (!response) {\n        return err({\n          code: \"provider\",\n          message: `Fake model has no response for call ${cursor}; it was given ${responses.length}`,\n          retryable: false,\n        });\n      }\n      if (response.text) yield { type: \"text.delta\", text: response.text };\n      return ok({\n        message: { content: response.text ?? \"\", ...(response.calls?.length ? { calls: response.calls } : {}) },\n        finishReason: response.finishReason ?? (response.calls?.length ? \"tool-calls\" : \"stop\"),\n        usage: response.usage ?? {},\n        ...(response.model ? { model: response.model } : {}),\n      });\n    },\n  };\n}\n"]}

package/dist/model/adapters/openai-compatible/index.d.ts

@@ -0,0 +1,29 @@
+import type { Model } from "../../model.js";
+export interface OpenAiCompatibleOptions {
+    apiKey: string;
+    baseUrl: string;
+    model: string;
+    headers?: Readonly<Record<string, string>>;
+    /**
+     * How this endpoint spells reasoning effort. OpenAI takes `reasoning_effort`;
+     * OpenRouter takes `reasoning: { effort }` and forwards it to whoever is
+     * serving the model. Sending both is not compatibility — OpenAI rejects the
+     * request outright — so the dialect is declared rather than guessed.
+     */
+    effortParameter?: "reasoning_effort" | "reasoning" | "none";
+    /** Injectable for tests; defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+/**
+ * The OpenAI chat-completions wire, which almost every provider now speaks —
+ * OpenRouter, Together, Groq, vLLM, Ollama. One adapter, one base URL.
+ */
+export declare function createOpenAiCompatibleModel(options: OpenAiCompatibleOptions): Model;
+/** OpenRouter is this wire with a fixed base URL and attribution headers. */
+export declare function createOpenRouterModel(input: {
+    apiKey: string;
+    model: string;
+    appUrl?: string;
+    appName?: string;
+    fetch?: typeof fetch;
+}): Model;