@odla-ai/ai 0.1.0

package/README.md

@@ -0,0 +1,290 @@
+# @odla-ai/ai
+
+One general-purpose interface for AI inference across **Anthropic (Claude)**,
+**OpenAI (GPT)**, and **Google (Gemini)** — text, image, and audio — plus a
+tool-use **agent engine** and an **eval harness**. It's the place every odla app
+reaches for when it needs AI.
+
+- **Library-only.** Import it in-process and bring your own keys. No hosted
+  gateway, no network hop.
+- **One canonical shape.** Anthropic-flavored content blocks, forced tool calls
+  with object inputs, a normalized streaming event vocabulary, cache-aware usage,
+  and a closed error taxonomy — the same regardless of which provider answers.
+- **Capability-checked.** Every request is validated against the model before
+  dispatch, so "audio to Claude" fails fast with a clear error instead of an
+  opaque provider 400.
+- **Isomorphic.** Node 20+, Cloudflare Workers, the browser. Provider SDKs are
+  lazy-loaded — a Claude-only consumer never pulls in `openai` or `@google/genai`.
+
+```bash
+npm install @odla-ai/ai
+```
+
+## Quick start
+
+```ts
+import { init } from "@odla-ai/ai";
+
+const ai = init({
+  keys: {
+    anthropic: process.env.ANTHROPIC_API_KEY,
+    openai: process.env.OPENAI_API_KEY,
+    google: process.env.GOOGLE_API_KEY,
+  },
+  defaultModel: "claude-opus-4-8",
+});
+
+// One call, any provider — pick the model, the provider is resolved for you.
+const res = await ai.chat({
+  model: "gpt-5",
+  messages: [{ role: "user", content: "Say hello in one word." }],
+  maxTokens: 64,
+});
+console.log(res.content); // [{ type: "text", text: "Hello" }]
+```
+
+### Streaming
+
+```ts
+for await (const ev of ai.stream({ model: "gemini-2.5-flash", messages: [...], maxTokens: 512 })) {
+  if (ev.type === "content_block_delta" && ev.delta.type === "text_delta") {
+    process.stdout.write(ev.delta.text);
+  }
+}
+```
+
+The event union (`message_start → content_block_start → content_block_delta →
+content_block_stop → message_delta → message_stop`, plus `error`) is identical
+across providers.
+
+### Structured extraction (forced tool call)
+
+```ts
+const { value } = await ai.extract<{ sentiment: "positive" | "negative" | "neutral" }>({
+  model: "claude-haiku-4-5",
+  user: "Classify: 'I love this!'",
+  tool: {
+    name: "classify",
+    parameters: {
+      type: "object",
+      properties: { sentiment: { type: "string", enum: ["positive", "negative", "neutral"] } },
+      required: ["sentiment"],
+    },
+  },
+});
+// value.sentiment === "positive"  (already a parsed object — never a JSON string)
+```
+
+### Web search
+
+```ts
+const { text } = await ai.search({ model: "claude-sonnet-5", user: "Who won the 2026 World Cup?" });
+```
+
+## Multimodal: text, image, audio
+
+Content blocks carry the modality. Image is broadly supported; **audio is
+accepted by OpenAI and Google, but not Anthropic** — sending an `audio` block to
+a Claude model throws a `CapabilityError` before any network call.
+
+```ts
+// Image (works on Claude, GPT, Gemini)
+await ai.chat({
+  model: "gpt-4o",
+  messages: [{ role: "user", content: [
+    { type: "image", source: { type: "base64", mediaType: "image/png", data: pngB64 } },
+    { type: "text", text: "What's in this image?" },
+  ] }],
+  maxTokens: 128,
+});
+
+// Audio (OpenAI: gpt-audio; Google: gemini-2.5-*)
+await ai.chat({
+  model: "gpt-audio",
+  messages: [{ role: "user", content: [
+    { type: "audio", source: { type: "base64", mediaType: "audio/wav", data: wavB64 } },
+    { type: "text", text: "Transcribe this." },
+  ] }],
+  maxTokens: 256,
+});
+```
+
+## Agents: build, run, and test
+
+A **persona** is a role as config-as-data: a model, a system prompt, its tools,
+and reasoning knobs. `runAgent` drives the tool-use loop (model turn → run tool
+handlers → feed results back → repeat) until the model stops or a step limit hits.
+
+```ts
+import { init, runAgent, type Persona, type ToolDef } from "@odla-ai/ai";
+
+const ai = init({ keys: { anthropic: process.env.ANTHROPIC_API_KEY } });
+
+const add: ToolDef = {
+  name: "add",
+  description: "Add two integers.",
+  inputSchema: { type: "object", properties: { a: { type: "number" }, b: { type: "number" } }, required: ["a", "b"] },
+  handler: (input) => ({ content: String((input.a as number) + (input.b as number)) }),
+};
+
+const calculator: Persona = {
+  name: "calculator",
+  model: "claude-opus-4-8",
+  system: "Use the add tool for arithmetic, then state the result.",
+  tools: [add],
+  maxSteps: 4,
+};
+
+const run = await runAgent(ai, calculator, { input: "What is 21 + 21?" });
+console.log(run.finalText);   // "…42"
+console.log(run.toolCalls);   // [{ toolUse, output }]
+console.log(run.usage);       // accumulated across turns
+```
+
+Tools can declare taint constraints (`outputTaint` / `acceptsTaint`) for a
+lightweight CaMeL-style prompt-injection gate, and personas can carry a pluggable
+`MemoryScope`.
+
+### Skills
+
+A **skill** is a named bundle of tools + instructions. Attach skills to a persona
+and their tools are merged into the model's tool list and their instructions into
+the system prompt — the primitive for "add a skill and call it as tools."
+
+```ts
+import { entityCrudSkill, runAgent } from "@odla-ai/ai";
+import { init as odlaInit } from "@odla-ai/db";
+
+const db = odlaInit({ appId, adminToken: appKey, endpoint: ODLA_URL });
+
+// Turn an odla-db entity into list/create/update/delete tools that change data.
+const todos = entityCrudSkill({
+  db,
+  entity: "todos",
+  fields: { text: { type: "string" }, done: { type: "boolean" } },
+  required: ["text"],
+});
+
+const assistant = { name: "todo-bot", model: "claude-opus-4-8", skills: [todos] };
+const run = await runAgent(ai, assistant, { input: "Add 'buy milk' and show my open todos." });
+// the agent calls create_todo then list_todos, writing/reading via odla-db
+```
+
+`entityCrudSkill` generates `list_<plural>`, `create_<singular>`, `update_<singular>`
+(partial — pass only the fields that change, e.g. toggle `done`), and
+`delete_<singular>` tools whose handlers call `db.transact`/`db.query`. Or hand-roll
+a `Skill` = `{ name, instructions?, tools: ToolDef[] }` for anything else.
+
+### Evals
+
+```ts
+import { evaluate, exactMatch, llmJudge } from "@odla-ai/ai";
+
+const report = await evaluate({
+  inference: ai,
+  model: "claude-opus-4-8",
+  system: "Answer with only the number.",
+  grader: exactMatch(),
+  cases: [
+    { input: "What is 2+2?", expected: "4" },
+    { input: "What is 10-3?", expected: "7" },
+  ],
+});
+console.log(`${report.passed}/${report.total} passed`);
+```
+
+Graders: `exactMatch`, `includes`, `structuredMatch`, and `llmJudge` (which
+dogfoods the inference core to grade open-ended output against a rubric). Pass a
+`persona` instead of a `model` to evaluate a full agent.
+
+## Keys & roles
+
+Keys are **BYO** — a static per-provider map and/or a dynamic `resolveKey`
+(multi-tenant / per-call). A provider with no resolvable key is simply
+unavailable: requesting one of its models throws a `ConfigError`.
+
+```ts
+const ai = init({
+  resolveKey: (provider) => lookupTenantKey(currentTenant, provider),
+});
+```
+
+"Roles" are personas (above) — config-as-data, not RBAC.
+
+## Storage, memory & BYO keys via odla-db
+
+odla-ai follows odla-db's model: it's a self-contained npm package, ships an
+`llms.txt` for machine context, and integrates with `@odla-ai/db` for durable
+storage — **without taking a runtime dependency on it**. You install `@odla-ai/db`,
+build a client, and inject it; odla-ai talks to it through a structural interface.
+
+The agent handshake (an agent never takes a platform secret):
+
+```ts
+import { requestToken, init as odlaInit } from "@odla-ai/db";
+import { provisionAgentApp, odlaDbKeyResolver, OdlaDbMemory, persistRun, runAgent, init } from "@odla-ai/ai";
+
+// 1. Device-authorization handshake — the human supplies the endpoint and
+//    approves a short code in odla-db Studio; you get a scoped, revocable token.
+const { token } = await requestToken({ endpoint: ODLA_URL, onCode: ({ userCode }) => console.log(userCode) });
+
+// 2. Provision: create app, mint an app key, push the agent schema, and store the
+//    user's BYO provider keys as odla-db secrets (encrypted at rest).
+const { appId, appKey } = await provisionAgentApp({
+  endpoint: ODLA_URL,
+  token,                                   // operator/dev token — needed to WRITE secrets
+  providerKeys: { openai: OPENAI_KEY, anthropic: ANTHROPIC_KEY },
+});
+
+// 3. Runtime: read keys from secrets with the app key, persist memory + run traces.
+const db = odlaInit({ appId, adminToken: appKey, endpoint: ODLA_URL });
+const ai = init({ resolveKey: odlaDbKeyResolver(db) });   // keys come from odla-db secrets
+
+const persona = { name: "assistant", model: "gpt-5", memory: new OdlaDbMemory({ db, sessionId: "user-42" }) };
+const run = await runAgent(ai, persona, { input: "Pick up where we left off." });
+await persistRun(run, { db, sessionId: "user-42" });
+```
+
+**BYO keys as secrets** — the write/read split mirrors odla-db: storing a secret
+is a *privileged* action (operator or `odla_dev_` token, via `provisionAgentApp` /
+`putSecret`); reading it at request time uses the ordinary **read-only** app key
+(`odlaDbKeyResolver` → `db.secrets.get`). Keys are AES-GCM-encrypted at rest and
+never returned to browser clients. `OdlaDbMemory` persists conversation turns and
+`persistRun` writes run traces, both as natural-key upserts (idempotent on retry).
+
+## Models & capabilities
+
+The catalog maps a canonical model id → provider, native id, and capabilities.
+The built-in `DEFAULT_CATALOG` covers current Anthropic, OpenAI, and Google
+models; extend or override it via `buildCatalog` / `init({ catalog })`.
+
+| | image in | audio in | tools | thinking | effort | web search | structured |
+|---|---|---|---|---|---|---|---|
+| Claude (opus/sonnet/fable) | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Claude Haiku | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ |
+| GPT-5 line | ✅ | ❌ | ✅ | — | ✅ | — | ✅ |
+| GPT-4o | ✅ | ❌ | ✅ | — | ❌ | — | ✅ |
+| gpt-audio | ❌ | ✅ | ✅ | — | ❌ | — | ✅ |
+| Gemini 2.5 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+> **Model ids drift.** The catalog is data — verify ids against each provider's
+> current docs (the `claude-api` skill for Anthropic; `/v1/models` for OpenAI;
+> Google GenAI docs for Gemini) rather than trusting them from memory.
+
+## Errors
+
+Every error is an `OdlaAIError` subclass carrying a stable `code` — branch on
+`err.code`, not message text: `ConfigError`, `AuthError`, `RateLimitError`,
+`CapabilityError`, `ContextWindowError`, `InvalidRequestError`, `ProviderError`.
+
+## Develop
+
+```bash
+npm run typecheck   # tsc --noEmit (strict)
+npm test            # vitest — offline, mock-provider based
+npm run build       # tsup → dual ESM + CJS + d.ts
+npm run smoke       # live check against real providers (needs .dev.vars)
+```
+
+For the live smoke, copy `.dev.vars.example` → `.dev.vars` and fill in whatever
+keys you have; providers without a key are skipped.

package/dist/anthropic-JXDXR7O7.js

@@ -0,0 +1,219 @@
+import {
+  addUsage,
+  emptyUsage,
+  mapProviderError,
+  normalizeError
+} from "./chunk-LANGYP65.js";
+
+// src/providers/anthropic.ts
+import Anthropic from "@anthropic-ai/sdk";
+var AnthropicProvider = class {
+  id = "anthropic";
+  client;
+  /** `client` may be injected (tests, custom transport); otherwise built from key. */
+  constructor(apiKey, client) {
+    this.client = client ?? new Anthropic({ apiKey });
+  }
+  async create(spec, req) {
+    try {
+      let messages = toAnthropicMessages(req);
+      const content = [];
+      const usage = emptyUsage();
+      let stopReason = "end_turn";
+      let id = "";
+      for (let i = 0; i < 8; i++) {
+        const res = await this.client.messages.create(
+          buildParams(spec, req, messages)
+        );
+        id = res.id;
+        addUsage(usage, mapUsage(res.usage));
+        content.push(...mapContent(res.content));
+        stopReason = mapStop(res.stop_reason);
+        if (res.stop_reason === "pause_turn") {
+          messages = [...messages, { role: "assistant", content: res.content }];
+          continue;
+        }
+        break;
+      }
+      return { id, model: req.model, provider: "anthropic", role: "assistant", content, stopReason, usage };
+    } catch (err) {
+      mapProviderError(err, "anthropic");
+    }
+  }
+  async *stream(spec, req) {
+    try {
+      const events = this.client.messages.stream(
+        buildParams(spec, req, toAnthropicMessages(req))
+      );
+      for await (const raw of events) {
+        const ev = mapStreamEvent(raw, req);
+        if (ev) yield ev;
+      }
+    } catch (err) {
+      yield { type: "error", error: normalizeError(err, "anthropic").toShape() };
+    }
+  }
+};
+function buildParams(spec, req, messages) {
+  const params = {
+    model: spec.nativeId,
+    max_tokens: req.maxTokens,
+    messages
+  };
+  const system = toAnthropicSystem(req.system);
+  if (system !== void 0) params.system = system;
+  const tools = buildTools(req);
+  if (tools) params.tools = tools;
+  const toolChoice = mapToolChoice(req.toolChoice);
+  if (toolChoice) params.tool_choice = toolChoice;
+  if (req.stopSequences && req.stopSequences.length > 0) params.stop_sequences = req.stopSequences;
+  if (req.temperature !== void 0 && !spec.capabilities.effort) params.temperature = req.temperature;
+  if (req.thinking === "adaptive" && spec.capabilities.thinking) params.thinking = { type: "adaptive" };
+  const outputConfig = {};
+  if (req.effort && spec.capabilities.effort) outputConfig.effort = req.effort;
+  if (req.responseFormat && spec.capabilities.structuredOutput) {
+    outputConfig.format = { type: "json_schema", schema: req.responseFormat.schema };
+  }
+  if (Object.keys(outputConfig).length > 0) params.output_config = outputConfig;
+  if (req.providerExtras) Object.assign(params, req.providerExtras);
+  return params;
+}
+function toAnthropicSystem(system) {
+  if (system === void 0) return void 0;
+  if (typeof system === "string") return system;
+  return system.map((b) => ({
+    type: "text",
+    text: b.text,
+    ...b.cacheControl ? { cache_control: { type: "ephemeral" } } : {}
+  }));
+}
+function toAnthropicMessages(req) {
+  return req.messages.map((m) => ({
+    role: m.role,
+    content: typeof m.content === "string" ? m.content : m.content.map(anthropicBlock)
+  }));
+}
+function anthropicBlock(b) {
+  switch (b.type) {
+    case "text":
+      return {
+        type: "text",
+        text: b.text,
+        ...b.cacheControl ? { cache_control: { type: "ephemeral" } } : {}
+      };
+    case "image":
+      return {
+        type: "image",
+        source: b.source.type === "base64" ? { type: "base64", media_type: b.source.mediaType, data: b.source.data } : { type: "url", url: b.source.url }
+      };
+    case "document":
+      return {
+        type: "document",
+        source: b.source.type === "base64" ? { type: "base64", media_type: "application/pdf", data: b.source.data } : { type: "url", url: b.source.url }
+      };
+    case "tool_use":
+      return { type: "tool_use", id: b.id, name: b.name, input: b.input };
+    case "tool_result":
+      return {
+        type: "tool_result",
+        tool_use_id: b.toolUseId,
+        content: typeof b.content === "string" ? b.content : b.content.map(anthropicBlock),
+        ...b.isError ? { is_error: true } : {}
+      };
+    case "thinking":
+      return { type: "thinking", thinking: b.thinking, signature: b.signature ?? "" };
+    case "audio":
+      throw new Error("Anthropic does not support audio input");
+  }
+}
+function buildTools(req) {
+  const tools = [];
+  for (const t of req.tools ?? []) {
+    tools.push({ name: t.name, description: t.description, input_schema: t.inputSchema });
+  }
+  if (req.webSearch) tools.push({ type: "web_search_20260209", name: "web_search" });
+  return tools.length > 0 ? tools : void 0;
+}
+function mapToolChoice(tc) {
+  if (tc === void 0) return void 0;
+  if (tc === "auto") return { type: "auto" };
+  if (tc === "any") return { type: "any" };
+  if (tc === "none") return { type: "none" };
+  return { type: "tool", name: tc.name };
+}
+function mapContent(blocks) {
+  const out = [];
+  for (const b of blocks) {
+    if (b.type === "text") out.push({ type: "text", text: b.text });
+    else if (b.type === "tool_use") {
+      out.push({ type: "tool_use", id: b.id, name: b.name, input: b.input ?? {} });
+    } else if (b.type === "thinking") {
+      out.push({ type: "thinking", thinking: b.thinking, signature: b.signature });
+    }
+  }
+  return out;
+}
+function mapUsage(u) {
+  const usage = { inputTokens: u.input_tokens ?? 0, outputTokens: u.output_tokens ?? 0 };
+  if (u.cache_creation_input_tokens != null) usage.cacheCreationTokens = u.cache_creation_input_tokens;
+  if (u.cache_read_input_tokens != null) usage.cacheReadTokens = u.cache_read_input_tokens;
+  return usage;
+}
+function mapStop(reason) {
+  switch (reason) {
+    case "end_turn":
+    case "max_tokens":
+    case "stop_sequence":
+    case "tool_use":
+    case "pause_turn":
+    case "refusal":
+      return reason;
+    default:
+      return "end_turn";
+  }
+}
+function mapStreamEvent(raw, req) {
+  switch (raw.type) {
+    case "message_start":
+      return {
+        type: "message_start",
+        message: {
+          id: raw.message.id,
+          model: req.model,
+          provider: "anthropic",
+          role: "assistant",
+          content: [],
+          usage: mapUsage(raw.message.usage)
+        }
+      };
+    case "content_block_start": {
+      const block = mapStartBlock(raw.content_block);
+      return block ? { type: "content_block_start", index: raw.index, contentBlock: block } : void 0;
+    }
+    case "content_block_delta": {
+      const d = raw.delta;
+      if (d.type === "text_delta") return { type: "content_block_delta", index: raw.index, delta: { type: "text_delta", text: d.text } };
+      if (d.type === "thinking_delta") return { type: "content_block_delta", index: raw.index, delta: { type: "thinking_delta", thinking: d.thinking } };
+      if (d.type === "input_json_delta") return { type: "content_block_delta", index: raw.index, delta: { type: "input_json_delta", partialJson: d.partial_json } };
+      return void 0;
+    }
+    case "content_block_stop":
+      return { type: "content_block_stop", index: raw.index };
+    case "message_delta":
+      return { type: "message_delta", delta: { stopReason: mapStop(raw.delta.stop_reason) }, usage: mapUsage(raw.usage) };
+    case "message_stop":
+      return { type: "message_stop" };
+    default:
+      return void 0;
+  }
+}
+function mapStartBlock(cb) {
+  if (cb.type === "text") return { type: "text", text: cb.text };
+  if (cb.type === "tool_use") return { type: "tool_use", id: cb.id, name: cb.name, input: {} };
+  if (cb.type === "thinking") return { type: "thinking", thinking: cb.thinking, signature: cb.signature };
+  return void 0;
+}
+export {
+  AnthropicProvider
+};
+//# sourceMappingURL=anthropic-JXDXR7O7.js.map

package/dist/anthropic-JXDXR7O7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/anthropic.ts"],"sourcesContent":["// Anthropic (Claude) adapter. The canonical shape is Anthropic-flavored, so this\n// is the lowest-translation adapter. Ported from odla-kg's claude.ts patterns:\n// forced tool-call via tool_choice, web_search_20260209 with pause_turn\n// continuation, adaptive thinking + output_config.effort (never budget_tokens).\n//\n// The installed @anthropic-ai/sdk (0.70.x) doesn't yet type adaptive thinking,\n// output_config, or web_search_20260209 — those newer request fields are built\n// into a loose params object and cast at the call site (the wire accepts them),\n// exactly as odla-kg does for the web-search tool literal.\n\nimport Anthropic from \"@anthropic-ai/sdk\";\nimport type { ModelSpec } from \"../shape/capabilities\";\nimport type { Provider } from \"./types\";\nimport { mapProviderError, normalizeError } from \"./errors\";\nimport {\n  addUsage,\n  emptyUsage,\n  type OracleContentBlock,\n  type OracleEvent,\n  type OracleRequest,\n  type OracleResponse,\n  type OracleStopReason,\n  type OracleUsage,\n  type TextBlock,\n  type ToolChoice,\n} from \"../shape/index\";\n\nexport class AnthropicProvider implements Provider {\n  readonly id = \"anthropic\" as const;\n  private client: Anthropic;\n\n  /** `client` may be injected (tests, custom transport); otherwise built from key. */\n  constructor(apiKey: string, client?: Anthropic) {\n    this.client = client ?? new Anthropic({ apiKey });\n  }\n\n  async create(spec: ModelSpec, req: OracleRequest): Promise<OracleResponse> {\n    try {\n      let messages = toAnthropicMessages(req);\n      const content: OracleContentBlock[] = [];\n      const usage = emptyUsage();\n      let stopReason: OracleStopReason = \"end_turn\";\n      let id = \"\";\n\n      // Loop only to resolve server-side tools (pause_turn), max 8 hops. Client\n      // tool_use / end_turn / etc. return immediately.\n      for (let i = 0; i < 8; i++) {\n        const res = await this.client.messages.create(\n          buildParams(spec, req, messages) as unknown as Anthropic.MessageCreateParamsNonStreaming,\n        );\n        id = res.id;\n        addUsage(usage, mapUsage(res.usage));\n        content.push(...mapContent(res.content));\n        stopReason = mapStop(res.stop_reason);\n        if (res.stop_reason === \"pause_turn\") {\n          messages = [...messages, { role: \"assistant\", content: res.content }];\n          continue;\n        }\n        break;\n      }\n\n      return { id, model: req.model, provider: \"anthropic\", role: \"assistant\", content, stopReason, usage };\n    } catch (err) {\n      mapProviderError(err, \"anthropic\");\n    }\n  }\n\n  async *stream(spec: ModelSpec, req: OracleRequest): AsyncIterable<OracleEvent> {\n    try {\n      const events = this.client.messages.stream(\n        buildParams(spec, req, toAnthropicMessages(req)) as unknown as Anthropic.MessageStreamParams,\n      );\n      for await (const raw of events) {\n        const ev = mapStreamEvent(raw, req);\n        if (ev) yield ev;\n      }\n    } catch (err) {\n      yield { type: \"error\", error: normalizeError(err, \"anthropic\").toShape() };\n    }\n  }\n}\n\n// ----- request mapping -----\n\nfunction buildParams(\n  spec: ModelSpec,\n  req: OracleRequest,\n  messages: Anthropic.MessageParam[],\n): Record<string, unknown> {\n  const params: Record<string, unknown> = {\n    model: spec.nativeId,\n    max_tokens: req.maxTokens,\n    messages,\n  };\n\n  const system = toAnthropicSystem(req.system);\n  if (system !== undefined) params.system = system;\n\n  const tools = buildTools(req);\n  if (tools) params.tools = tools;\n\n  const toolChoice = mapToolChoice(req.toolChoice);\n  if (toolChoice) params.tool_choice = toolChoice;\n\n  if (req.stopSequences && req.stopSequences.length > 0) params.stop_sequences = req.stopSequences;\n\n  // Sampling params are rejected on the frontier models (they carry effort);\n  // only the non-effort tier (Haiku) accepts temperature.\n  if (req.temperature !== undefined && !spec.capabilities.effort) params.temperature = req.temperature;\n\n  if (req.thinking === \"adaptive\" && spec.capabilities.thinking) params.thinking = { type: \"adaptive\" };\n\n  const outputConfig: Record<string, unknown> = {};\n  if (req.effort && spec.capabilities.effort) outputConfig.effort = req.effort;\n  if (req.responseFormat && spec.capabilities.structuredOutput) {\n    outputConfig.format = { type: \"json_schema\", schema: req.responseFormat.schema };\n  }\n  if (Object.keys(outputConfig).length > 0) params.output_config = outputConfig;\n\n  if (req.providerExtras) Object.assign(params, req.providerExtras);\n  return params;\n}\n\nfunction toAnthropicSystem(system: OracleRequest[\"system\"]): string | Anthropic.TextBlockParam[] | undefined {\n  if (system === undefined) return undefined;\n  if (typeof system === \"string\") return system;\n  return system.map((b: TextBlock) => ({\n    type: \"text\" as const,\n    text: b.text,\n    ...(b.cacheControl ? { cache_control: { type: \"ephemeral\" as const } } : {}),\n  }));\n}\n\nfunction toAnthropicMessages(req: OracleRequest): Anthropic.MessageParam[] {\n  return req.messages.map((m) => ({\n    role: m.role,\n    content: typeof m.content === \"string\" ? m.content : m.content.map(anthropicBlock),\n  }));\n}\n\nfunction anthropicBlock(b: OracleContentBlock): Anthropic.ContentBlockParam {\n  switch (b.type) {\n    case \"text\":\n      return {\n        type: \"text\",\n        text: b.text,\n        ...(b.cacheControl ? { cache_control: { type: \"ephemeral\" } } : {}),\n      };\n    case \"image\":\n      return {\n        type: \"image\",\n        source:\n          b.source.type === \"base64\"\n            ? { type: \"base64\", media_type: b.source.mediaType, data: b.source.data }\n            : { type: \"url\", url: b.source.url },\n      } as Anthropic.ContentBlockParam;\n    case \"document\":\n      return {\n        type: \"document\",\n        source:\n          b.source.type === \"base64\"\n            ? { type: \"base64\", media_type: \"application/pdf\", data: b.source.data }\n            : { type: \"url\", url: b.source.url },\n      } as Anthropic.ContentBlockParam;\n    case \"tool_use\":\n      return { type: \"tool_use\", id: b.id, name: b.name, input: b.input };\n    case \"tool_result\":\n      return {\n        type: \"tool_result\",\n        tool_use_id: b.toolUseId,\n        content:\n          typeof b.content === \"string\"\n            ? b.content\n            : (b.content.map(anthropicBlock) as Anthropic.ToolResultBlockParam[\"content\"]),\n        ...(b.isError ? { is_error: true } : {}),\n      };\n    case \"thinking\":\n      return { type: \"thinking\", thinking: b.thinking, signature: b.signature ?? \"\" };\n    case \"audio\":\n      // Guarded by validateRequest; defensive in case validation is bypassed.\n      throw new Error(\"Anthropic does not support audio input\");\n  }\n}\n\nfunction buildTools(req: OracleRequest): unknown[] | undefined {\n  const tools: unknown[] = [];\n  for (const t of req.tools ?? []) {\n    tools.push({ name: t.name, description: t.description, input_schema: t.inputSchema });\n  }\n  if (req.webSearch) tools.push({ type: \"web_search_20260209\", name: \"web_search\" });\n  return tools.length > 0 ? tools : undefined;\n}\n\nfunction mapToolChoice(tc: ToolChoice | undefined): unknown | undefined {\n  if (tc === undefined) return undefined;\n  if (tc === \"auto\") return { type: \"auto\" };\n  if (tc === \"any\") return { type: \"any\" };\n  if (tc === \"none\") return { type: \"none\" };\n  return { type: \"tool\", name: tc.name };\n}\n\n// ----- response mapping -----\n\nfunction mapContent(blocks: Anthropic.ContentBlock[]): OracleContentBlock[] {\n  const out: OracleContentBlock[] = [];\n  for (const b of blocks) {\n    if (b.type === \"text\") out.push({ type: \"text\", text: b.text });\n    else if (b.type === \"tool_use\") {\n      out.push({ type: \"tool_use\", id: b.id, name: b.name, input: (b.input ?? {}) as Record<string, unknown> });\n    } else if (b.type === \"thinking\") {\n      out.push({ type: \"thinking\", thinking: b.thinking, signature: b.signature });\n    }\n    // server_tool_use / web_search_tool_result blocks are dropped — the answer\n    // text lives in text blocks.\n  }\n  return out;\n}\n\nfunction mapUsage(u: Anthropic.Usage): OracleUsage {\n  const usage: OracleUsage = { inputTokens: u.input_tokens ?? 0, outputTokens: u.output_tokens ?? 0 };\n  if (u.cache_creation_input_tokens != null) usage.cacheCreationTokens = u.cache_creation_input_tokens;\n  if (u.cache_read_input_tokens != null) usage.cacheReadTokens = u.cache_read_input_tokens;\n  return usage;\n}\n\nfunction mapStop(reason: string | null | undefined): OracleStopReason {\n  switch (reason) {\n    case \"end_turn\":\n    case \"max_tokens\":\n    case \"stop_sequence\":\n    case \"tool_use\":\n    case \"pause_turn\":\n    case \"refusal\":\n      return reason;\n    default:\n      return \"end_turn\";\n  }\n}\n\n// ----- stream mapping -----\n\nfunction mapStreamEvent(raw: Anthropic.RawMessageStreamEvent, req: OracleRequest): OracleEvent | undefined {\n  switch (raw.type) {\n    case \"message_start\":\n      return {\n        type: \"message_start\",\n        message: {\n          id: raw.message.id,\n          model: req.model,\n          provider: \"anthropic\",\n          role: \"assistant\",\n          content: [],\n          usage: mapUsage(raw.message.usage),\n        },\n      };\n    case \"content_block_start\": {\n      const block = mapStartBlock(raw.content_block);\n      return block ? { type: \"content_block_start\", index: raw.index, contentBlock: block } : undefined;\n    }\n    case \"content_block_delta\": {\n      const d = raw.delta;\n      if (d.type === \"text_delta\") return { type: \"content_block_delta\", index: raw.index, delta: { type: \"text_delta\", text: d.text } };\n      if (d.type === \"thinking_delta\") return { type: \"content_block_delta\", index: raw.index, delta: { type: \"thinking_delta\", thinking: d.thinking } };\n      if (d.type === \"input_json_delta\") return { type: \"content_block_delta\", index: raw.index, delta: { type: \"input_json_delta\", partialJson: d.partial_json } };\n      return undefined;\n    }\n    case \"content_block_stop\":\n      return { type: \"content_block_stop\", index: raw.index };\n    case \"message_delta\":\n      return { type: \"message_delta\", delta: { stopReason: mapStop(raw.delta.stop_reason) }, usage: mapUsage(raw.usage as Anthropic.Usage) };\n    case \"message_stop\":\n      return { type: \"message_stop\" };\n    default:\n      return undefined;\n  }\n}\n\nfunction mapStartBlock(cb: Anthropic.ContentBlock): OracleContentBlock | undefined {\n  if (cb.type === \"text\") return { type: \"text\", text: cb.text };\n  if (cb.type === \"tool_use\") return { type: \"tool_use\", id: cb.id, name: cb.name, input: {} };\n  if (cb.type === \"thinking\") return { type: \"thinking\", thinking: cb.thinking, signature: cb.signature };\n  return undefined;\n}\n"],"mappings":"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","names":[]}