@rudra-js/anthropic 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clive Dsouza
+
+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.

package/README.md

@@ -0,0 +1,54 @@
+# @rudra-js/anthropic
+
+An Anthropic adapter for
+[`@rudra-js/core`](https://github.com/clivedsouza1010/rudra-js/tree/main/packages/core)'s
+`ComponentProvider`.
+
+## Install
+
+```sh
+npm install @rudra-js/anthropic @rudra-js/core zod
+```
+
+```ts
+import { createAnthropicProvider } from '@rudra-js/anthropic';
+import { createComponentGenerator } from '@rudra-js/core';
+
+const provider = createAnthropicProvider({ apiKey: process.env.ANTHROPIC_API_KEY! });
+const generator = createComponentGenerator({ provider });
+```
+
+`model` defaults to the current Claude model this package was written against;
+pass it to pin a different one. `maxTokens` and `baseUrl` are also optional.
+
+### An identity-linked key needs a workspace
+
+A key created against your identity rather than inside a workspace belongs to
+you across several of them, so the API cannot infer which one a request acts in
+and answers:
+
+```
+400 invalid_request_error — anthropic-workspace-id is required when
+authenticating with an identity-linked API key
+```
+
+Pass the workspace, or create the key from inside a workspace instead:
+
+```ts
+createAnthropicProvider({
+  apiKey: process.env.ANTHROPIC_API_KEY!,
+  workspaceId: process.env.ANTHROPIC_WORKSPACE_ID!,
+});
+```
+
+`fetch` is injectable, which is what the test suite uses in place of a network
+call.
+
+The tool schema sent to the model is derived from the `schema` on the
+`ProviderRequest` — the same schema `@rudra-js/core` defines — rather than a
+copy written out here. A second copy would be a second vocabulary: the
+reconciler would enforce one thing and the model would be told another.
+
+## Licence
+
+[MIT](./LICENSE)

package/dist/anthropic-provider.d.ts

@@ -0,0 +1,25 @@
+import type { ComponentProvider } from '@rudra-js/core';
+export interface AnthropicProviderOptions {
+    apiKey: string;
+    /** Defaults to the current Claude model this package was written against. */
+    model?: string;
+    maxTokens?: number;
+    baseUrl?: string;
+    /**
+     * Required when the key is identity-linked rather than workspace-scoped —
+     * such a key belongs to a person across several workspaces, so the API cannot
+     * infer which one a request acts in and rejects it with a 400.
+     */
+    workspaceId?: string;
+    /** Injected so the adapter is testable without a network or an SDK. */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * Adapts the Anthropic Messages API to `ComponentProvider`.
+ *
+ * The tool schema is derived from the schema core exports rather than restated
+ * here: a second copy is a second vocabulary, and the drift shows up as
+ * unexplained `invalid-generation` events.
+ */
+export declare function createAnthropicProvider(options: AnthropicProviderOptions): ComponentProvider;
+//# sourceMappingURL=anthropic-provider.d.ts.map

package/dist/anthropic-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../src/anthropic-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EAIlB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AA0CD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CA6H5F"}

package/dist/anthropic-provider.js

@@ -0,0 +1,198 @@
+import { z } from 'zod';
+const TOOL_NAME = 'emit_component_spec';
+/**
+ * This model runs adaptive thinking by default, and thinking draws on the
+ * same output budget as the tool call. A cap too close to what reasoning
+ * alone can spend leaves no room for the tool block, so the default is well
+ * above a typical spec's size rather than tuned to it.
+ */
+const DEFAULT_MAX_TOKENS = 8192;
+function describeShape(input) {
+    if (input === null)
+        return 'null';
+    if (Array.isArray(input))
+        return `an array of ${input.length}`;
+    if (typeof input !== 'object')
+        return String(typeof input);
+    const keys = Object.keys(input);
+    return keys.length === 0 ? 'an empty object' : `an object with keys ${keys.join(', ')}`;
+}
+function onlyValue(input) {
+    if (typeof input !== 'object' || input === null || Array.isArray(input))
+        return undefined;
+    const values = Object.values(input);
+    return values.length === 1 ? values[0] : undefined;
+}
+function isToolUseBlock(candidate) {
+    return (typeof candidate === 'object' &&
+        candidate !== null &&
+        candidate['type'] === 'tool_use' &&
+        candidate['name'] === TOOL_NAME);
+}
+/**
+ * Adapts the Anthropic Messages API to `ComponentProvider`.
+ *
+ * The tool schema is derived from the schema core exports rather than restated
+ * here: a second copy is a second vocabulary, and the drift shows up as
+ * unexplained `invalid-generation` events.
+ */
+export function createAnthropicProvider(options) {
+    const model = options.model ?? 'claude-opus-5';
+    const call = options.fetch ?? globalThis.fetch;
+    // Trimmed so a caller-supplied `baseUrl` ending in `/` cannot turn into
+    // `//v1/messages`. Done with a loop rather than `/\/+$/`: that pattern
+    // backtracks on a string of many trailing slashes, which is a denial of
+    // service in a published package even though the value comes from the caller
+    // rather than from a request.
+    let baseUrl = options.baseUrl ?? 'https://api.anthropic.com';
+    while (baseUrl.endsWith('/'))
+        baseUrl = baseUrl.slice(0, -1);
+    const maxTokens = options.maxTokens ?? DEFAULT_MAX_TOKENS;
+    return {
+        name: 'anthropic',
+        model,
+        async generate(request) {
+            // The half of obligation three that `fetch` does not cover. The real
+            // `fetch` rejects an already-aborted signal on its own, but `fetch` is an
+            // injected seam here, and a caller's own transport has no such duty — so
+            // without this, a call the caller has already given up on goes out.
+            request.signal.throwIfAborted();
+            const response = await send(call, `${baseUrl}/v1/messages`, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    'x-api-key': options.apiKey,
+                    'anthropic-version': '2023-06-01',
+                    ...(options.workspaceId ? { 'anthropic-workspace-id': options.workspaceId } : {}),
+                },
+                // The caller's deadline, handed straight to the transport: the contract
+                // asks an adapter to stop, not merely to stop caring about the answer.
+                signal: request.signal,
+                body: JSON.stringify({
+                    model,
+                    max_tokens: maxTokens,
+                    // Marked as the cached prefix. Anything per-shopper interpolated here
+                    // would destroy the prompt cache hit rate.
+                    system: [{ type: 'text', text: request.system, cache_control: { type: 'ephemeral' } }],
+                    messages: [{ role: 'user', content: request.user }],
+                    tools: [
+                        {
+                            name: TOOL_NAME,
+                            description: 'Return the component specification.',
+                            // "input" — a tool's input_schema describes what the model must
+                            // produce as the tool call's argument, not core's own output. The
+                            // two are not the same: "output" carries additionalProperties:
+                            // false on every block and "input" does not. Pinned in
+                            // tests/tool-schema.test.ts.
+                            input_schema: z.toJSONSchema(request.schema, { io: 'input' }),
+                        },
+                    ],
+                    tool_choice: { type: 'tool', name: TOOL_NAME },
+                }),
+            });
+            if (!response.ok) {
+                // Status and the vendor's error category only. Its message quotes the
+                // request back, and for this framework that can be a shopper's own search
+                // terms — which an adopter's `console.error(err)` would then capture.
+                const category = await errorCategory(response);
+                throw new Error(`anthropic responded ${response.status}${category}`);
+            }
+            const parsed = await response.json();
+            // `response.json()` yields whatever the body held, and `null` is valid
+            // JSON — reading `stop_reason` off it would throw a TypeError naming this
+            // adapter rather than the vendor that sent it.
+            if (typeof parsed !== 'object' || parsed === null) {
+                throw new Error(`anthropic returned ${parsed === null ? 'null' : typeof parsed}, not an object`);
+            }
+            const body = parsed;
+            // Before the tool-block lookup: both are ordinary 200s with no tool_use,
+            // and reporting them as "no tool use" blames the model for a budget or a
+            // policy this adapter controls.
+            if (body.stop_reason === 'max_tokens') {
+                throw new Error(`anthropic stopped at the max_tokens budget (${maxTokens}) before returning a tool use`);
+            }
+            if (body.stop_reason === 'refusal') {
+                throw new Error('anthropic refused to answer (stop_reason: refusal)');
+            }
+            // `content` and each of its entries are untrusted shapes from here on:
+            // a malformed response should name the vendor, not crash on the
+            // adapter's own `.find`/`.type` access.
+            const blocks = Array.isArray(body.content) ? body.content : [];
+            const block = blocks.find(isToolUseBlock);
+            if (!block) {
+                throw new Error(`anthropic returned no ${TOOL_NAME} tool use`);
+            }
+            // Parsed against the caller's own schema. generatedSpecSchema has no
+            // refinements, so this catches type and enum violations — a block kind
+            // outside the closed set, a non-string headline — not refinement logic.
+            const asSent = request.schema.safeParse(block.input);
+            const usable = asSent.success ? asSent : request.schema.safeParse(onlyValue(block.input));
+            if (!usable.success) {
+                throw new Error(`anthropic returned a ${TOOL_NAME} tool use that does not fit the schema. ` +
+                    `It sent ${describeShape(block.input)}.`, { cause: asSent.error });
+            }
+            const spec = usable.data;
+            const usage = toUsage(body.usage);
+            return { spec, ...(usage ? { usage } : {}) };
+        },
+    };
+}
+/**
+ * Calls the transport, and says what went wrong when it never answered.
+ *
+ * `fetch` reports every transport fault as the same `TypeError: fetch failed`
+ * and hides the reason in `cause` — so a refused connection, a DNS failure and
+ * a socket reset are indistinguishable in a log. An operator needs to tell
+ * those apart, and none of them carries request content.
+ */
+async function send(call, url, init) {
+    try {
+        return await call(url, init);
+    }
+    catch (error) {
+        // The caller's own deadline. It means something specific upstream, so it
+        // travels unchanged.
+        if (init.signal?.aborted)
+            throw error;
+        const cause = error instanceof Error ? (error.cause ?? error) : error;
+        const detail = cause && typeof cause === 'object' && 'code' in cause
+            ? String(cause.code)
+            : String(cause instanceof Error ? cause.message : cause);
+        throw new Error(`anthropic did not answer: ${detail}`, { cause: error });
+    }
+}
+/** The vendor's error category, never its message — the message quotes the request. */
+async function errorCategory(response) {
+    try {
+        const body = JSON.parse(await response.text());
+        const type = body?.error?.type;
+        return typeof type === 'string' ? ` (${type})` : '';
+    }
+    catch {
+        // A body that is unreadable or not JSON tells us nothing extra. The status
+        // is still in the message.
+        return '';
+    }
+}
+function toUsage(usage) {
+    if (!usage)
+        return undefined;
+    // A JSON body is untrusted: `"input_tokens": "11"` must not become part of
+    // a cost figure that downstream code adds instead of concatenates.
+    const numberAt = (key) => {
+        const value = usage[key];
+        return typeof value === 'number' ? value : undefined;
+    };
+    const inputTokens = numberAt('input_tokens');
+    const outputTokens = numberAt('output_tokens');
+    const cacheReadTokens = numberAt('cache_read_input_tokens');
+    const cacheWriteTokens = numberAt('cache_creation_input_tokens');
+    const mapped = {
+        ...(inputTokens === undefined ? {} : { inputTokens }),
+        ...(outputTokens === undefined ? {} : { outputTokens }),
+        ...(cacheReadTokens === undefined ? {} : { cacheReadTokens }),
+        ...(cacheWriteTokens === undefined ? {} : { cacheWriteTokens }),
+    };
+    return Object.keys(mapped).length > 0 ? mapped : undefined;
+}
+//# sourceMappingURL=anthropic-provider.js.map

package/dist/anthropic-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.js","sourceRoot":"","sources":["../src/anthropic-provider.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+/** @rudra-js/anthropic — an Anthropic adapter for `@rudra-js/core`. */
+export { createAnthropicProvider, type AnthropicProviderOptions } from './anthropic-provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,OAAO,EAAE,uBAAuB,EAAE,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+/** @rudra-js/anthropic — an Anthropic adapter for `@rudra-js/core`. */
+export { createAnthropicProvider } from './anthropic-provider.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,OAAO,EAAE,uBAAuB,EAAiC,MAAM,yBAAyB,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@rudra-js/anthropic",
+  "version": "0.1.0",
+  "description": "An Anthropic adapter for @rudra-js/core, with no vendor SDK and no dependencies",
+  "keywords": [
+    "anthropic",
+    "claude",
+    "llm",
+    "rudra",
+    "server-components"
+  ],
+  "license": "MIT",
+  "author": "Clive Dsouza",
+  "homepage": "https://github.com/clivedsouza1010/rudra-js/tree/main/packages/anthropic#readme",
+  "bugs": {
+    "url": "https://github.com/clivedsouza1010/rudra-js/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/clivedsouza1010/rudra-js.git",
+    "directory": "packages/anthropic"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src/**/*.ts",
+    "!src/**/*.test.ts"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@rudra-js/core": "^0.1.0",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@rudra-js/core": "0.1.0",
+    "zod": "^4.5.4"
+  }
+}

package/src/anthropic-provider.ts

@@ -0,0 +1,261 @@
+import { z } from 'zod';
+import type {
+  ComponentProvider,
+  ProviderRequest,
+  ProviderResult,
+  TokenUsage,
+} from '@rudra-js/core';
+
+export interface AnthropicProviderOptions {
+  apiKey: string;
+  /** Defaults to the current Claude model this package was written against. */
+  model?: string;
+  maxTokens?: number;
+  baseUrl?: string;
+  /**
+   * Required when the key is identity-linked rather than workspace-scoped —
+   * such a key belongs to a person across several workspaces, so the API cannot
+   * infer which one a request acts in and rejects it with a 400.
+   */
+  workspaceId?: string;
+  /** Injected so the adapter is testable without a network or an SDK. */
+  fetch?: typeof globalThis.fetch;
+}
+
+const TOOL_NAME = 'emit_component_spec';
+
+/**
+ * This model runs adaptive thinking by default, and thinking draws on the
+ * same output budget as the tool call. A cap too close to what reasoning
+ * alone can spend leaves no room for the tool block, so the default is well
+ * above a typical spec's size rather than tuned to it.
+ */
+const DEFAULT_MAX_TOKENS = 8192;
+
+interface ToolUseBlock {
+  type: 'tool_use';
+  name: string;
+  input: unknown;
+}
+
+function describeShape(input: unknown): string {
+  if (input === null) return 'null';
+  if (Array.isArray(input)) return `an array of ${input.length}`;
+  if (typeof input !== 'object') return String(typeof input);
+
+  const keys = Object.keys(input);
+  return keys.length === 0 ? 'an empty object' : `an object with keys ${keys.join(', ')}`;
+}
+
+function onlyValue(input: unknown): unknown {
+  if (typeof input !== 'object' || input === null || Array.isArray(input)) return undefined;
+  const values = Object.values(input);
+  return values.length === 1 ? values[0] : undefined;
+}
+
+function isToolUseBlock(candidate: unknown): candidate is ToolUseBlock {
+  return (
+    typeof candidate === 'object' &&
+    candidate !== null &&
+    (candidate as Record<string, unknown>)['type'] === 'tool_use' &&
+    (candidate as Record<string, unknown>)['name'] === TOOL_NAME
+  );
+}
+
+/**
+ * Adapts the Anthropic Messages API to `ComponentProvider`.
+ *
+ * The tool schema is derived from the schema core exports rather than restated
+ * here: a second copy is a second vocabulary, and the drift shows up as
+ * unexplained `invalid-generation` events.
+ */
+export function createAnthropicProvider(options: AnthropicProviderOptions): ComponentProvider {
+  const model = options.model ?? 'claude-opus-5';
+  const call = options.fetch ?? globalThis.fetch;
+  // Trimmed so a caller-supplied `baseUrl` ending in `/` cannot turn into
+  // `//v1/messages`. Done with a loop rather than `/\/+$/`: that pattern
+  // backtracks on a string of many trailing slashes, which is a denial of
+  // service in a published package even though the value comes from the caller
+  // rather than from a request.
+  let baseUrl = options.baseUrl ?? 'https://api.anthropic.com';
+  while (baseUrl.endsWith('/')) baseUrl = baseUrl.slice(0, -1);
+  const maxTokens = options.maxTokens ?? DEFAULT_MAX_TOKENS;
+
+  return {
+    name: 'anthropic',
+    model,
+
+    async generate(request: ProviderRequest): Promise<ProviderResult> {
+      // The half of obligation three that `fetch` does not cover. The real
+      // `fetch` rejects an already-aborted signal on its own, but `fetch` is an
+      // injected seam here, and a caller's own transport has no such duty — so
+      // without this, a call the caller has already given up on goes out.
+      request.signal.throwIfAborted();
+
+      const response = await send(call, `${baseUrl}/v1/messages`, {
+        method: 'POST',
+        headers: {
+          'content-type': 'application/json',
+          'x-api-key': options.apiKey,
+          'anthropic-version': '2023-06-01',
+          ...(options.workspaceId ? { 'anthropic-workspace-id': options.workspaceId } : {}),
+        },
+        // The caller's deadline, handed straight to the transport: the contract
+        // asks an adapter to stop, not merely to stop caring about the answer.
+        signal: request.signal,
+        body: JSON.stringify({
+          model,
+          max_tokens: maxTokens,
+          // Marked as the cached prefix. Anything per-shopper interpolated here
+          // would destroy the prompt cache hit rate.
+          system: [{ type: 'text', text: request.system, cache_control: { type: 'ephemeral' } }],
+          messages: [{ role: 'user', content: request.user }],
+          tools: [
+            {
+              name: TOOL_NAME,
+              description: 'Return the component specification.',
+              // "input" — a tool's input_schema describes what the model must
+              // produce as the tool call's argument, not core's own output. The
+              // two are not the same: "output" carries additionalProperties:
+              // false on every block and "input" does not. Pinned in
+              // tests/tool-schema.test.ts.
+              input_schema: z.toJSONSchema(request.schema, { io: 'input' }),
+            },
+          ],
+          tool_choice: { type: 'tool', name: TOOL_NAME },
+        }),
+      });
+
+      if (!response.ok) {
+        // Status and the vendor's error category only. Its message quotes the
+        // request back, and for this framework that can be a shopper's own search
+        // terms — which an adopter's `console.error(err)` would then capture.
+        const category = await errorCategory(response);
+
+        throw new Error(`anthropic responded ${response.status}${category}`);
+      }
+
+      const parsed: unknown = await response.json();
+
+      // `response.json()` yields whatever the body held, and `null` is valid
+      // JSON — reading `stop_reason` off it would throw a TypeError naming this
+      // adapter rather than the vendor that sent it.
+      if (typeof parsed !== 'object' || parsed === null) {
+        throw new Error(
+          `anthropic returned ${parsed === null ? 'null' : typeof parsed}, not an object`,
+        );
+      }
+
+      const body = parsed as {
+        content?: unknown;
+        usage?: Record<string, unknown>;
+        stop_reason?: string;
+      };
+
+      // Before the tool-block lookup: both are ordinary 200s with no tool_use,
+      // and reporting them as "no tool use" blames the model for a budget or a
+      // policy this adapter controls.
+      if (body.stop_reason === 'max_tokens') {
+        throw new Error(
+          `anthropic stopped at the max_tokens budget (${maxTokens}) before returning a tool use`,
+        );
+      }
+      if (body.stop_reason === 'refusal') {
+        throw new Error('anthropic refused to answer (stop_reason: refusal)');
+      }
+
+      // `content` and each of its entries are untrusted shapes from here on:
+      // a malformed response should name the vendor, not crash on the
+      // adapter's own `.find`/`.type` access.
+      const blocks = Array.isArray(body.content) ? body.content : [];
+      const block = blocks.find(isToolUseBlock);
+
+      if (!block) {
+        throw new Error(`anthropic returned no ${TOOL_NAME} tool use`);
+      }
+
+      // Parsed against the caller's own schema. generatedSpecSchema has no
+      // refinements, so this catches type and enum violations — a block kind
+      // outside the closed set, a non-string headline — not refinement logic.
+      const asSent = request.schema.safeParse(block.input);
+      const usable = asSent.success ? asSent : request.schema.safeParse(onlyValue(block.input));
+
+      if (!usable.success) {
+        throw new Error(
+          `anthropic returned a ${TOOL_NAME} tool use that does not fit the schema. ` +
+            `It sent ${describeShape(block.input)}.`,
+          { cause: asSent.error },
+        );
+      }
+
+      const spec = usable.data;
+      const usage = toUsage(body.usage);
+
+      return { spec, ...(usage ? { usage } : {}) };
+    },
+  };
+}
+
+/**
+ * Calls the transport, and says what went wrong when it never answered.
+ *
+ * `fetch` reports every transport fault as the same `TypeError: fetch failed`
+ * and hides the reason in `cause` — so a refused connection, a DNS failure and
+ * a socket reset are indistinguishable in a log. An operator needs to tell
+ * those apart, and none of them carries request content.
+ */
+async function send(call: typeof globalThis.fetch, url: string, init: RequestInit) {
+  try {
+    return await call(url, init);
+  } catch (error) {
+    // The caller's own deadline. It means something specific upstream, so it
+    // travels unchanged.
+    if (init.signal?.aborted) throw error;
+
+    const cause = error instanceof Error ? (error.cause ?? error) : error;
+    const detail =
+      cause && typeof cause === 'object' && 'code' in cause
+        ? String((cause as { code: unknown }).code)
+        : String(cause instanceof Error ? cause.message : cause);
+
+    throw new Error(`anthropic did not answer: ${detail}`, { cause: error });
+  }
+}
+
+/** The vendor's error category, never its message — the message quotes the request. */
+async function errorCategory(response: Response): Promise<string> {
+  try {
+    const body: unknown = JSON.parse(await response.text());
+    const type = (body as { error?: { type?: unknown } })?.error?.type;
+    return typeof type === 'string' ? ` (${type})` : '';
+  } catch {
+    // A body that is unreadable or not JSON tells us nothing extra. The status
+    // is still in the message.
+    return '';
+  }
+}
+
+function toUsage(usage: Record<string, unknown> | undefined): TokenUsage | undefined {
+  if (!usage) return undefined;
+
+  // A JSON body is untrusted: `"input_tokens": "11"` must not become part of
+  // a cost figure that downstream code adds instead of concatenates.
+  const numberAt = (key: string): number | undefined => {
+    const value = usage[key];
+    return typeof value === 'number' ? value : undefined;
+  };
+
+  const inputTokens = numberAt('input_tokens');
+  const outputTokens = numberAt('output_tokens');
+  const cacheReadTokens = numberAt('cache_read_input_tokens');
+  const cacheWriteTokens = numberAt('cache_creation_input_tokens');
+
+  const mapped = {
+    ...(inputTokens === undefined ? {} : { inputTokens }),
+    ...(outputTokens === undefined ? {} : { outputTokens }),
+    ...(cacheReadTokens === undefined ? {} : { cacheReadTokens }),
+    ...(cacheWriteTokens === undefined ? {} : { cacheWriteTokens }),
+  };
+
+  return Object.keys(mapped).length > 0 ? mapped : undefined;
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+/** @rudra-js/anthropic — an Anthropic adapter for `@rudra-js/core`. */
+
+export { createAnthropicProvider, type AnthropicProviderOptions } from './anthropic-provider.js';