@tepa/provider-anthropic 0.1.0

package/README.md

@@ -0,0 +1,106 @@
+# @tepa/provider-anthropic
+
+Anthropic Claude LLM provider for the Tepa agent pipeline.
+
+## Install
+
+```bash
+npm install @tepa/provider-anthropic
+```
+
+## Setup
+
+Set the `ANTHROPIC_API_KEY` environment variable. You can either export it directly:
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+Or use a `.env` file with [dotenv](https://www.npmjs.com/package/dotenv):
+
+```bash
+# .env
+ANTHROPIC_API_KEY=sk-ant-...
+```
+
+```typescript
+import "dotenv/config";
+```
+
+## Usage
+
+```typescript
+import { Tepa } from "tepa";
+import { AnthropicProvider } from "@tepa/provider-anthropic";
+
+const tepa = new Tepa({
+  tools: [/* ... */],
+  provider: new AnthropicProvider(),
+});
+```
+
+### Provider Options
+
+```typescript
+const provider = new AnthropicProvider({
+  apiKey: "sk-ant-...",        // defaults to ANTHROPIC_API_KEY env var
+  maxRetries: 3,               // retry attempts on transient failures (default: 3)
+  retryBaseDelayMs: 1000,      // base delay for exponential backoff (default: 1000)
+});
+```
+
+### Factory Function
+
+Use `createProvider` to create providers from a string identifier:
+
+```typescript
+import { createProvider } from "@tepa/provider-anthropic";
+
+const provider = createProvider("anthropic");
+```
+
+## Logging
+
+Every LLM call is automatically logged to a JSONL file in `.tepa/logs/`. You can disable the default file logger, add custom log listeners, or send logs to external services like Prometheus, NewRelic, or Datadog using the `onLog()` method:
+
+```typescript
+const provider = new AnthropicProvider({ defaultLog: false });
+
+provider.onLog((entry) => {
+  externalLogger.send(entry);
+});
+```
+
+See [`@tepa/provider-core`](../provider-core) for full logging documentation.
+
+## Other Providers
+
+Tepa ships with multiple LLM providers — all following the same `LLMProvider` interface:
+
+- [`@tepa/provider-gemini`](../provider-gemini) — Google Gemini
+- [`@tepa/provider-openai`](../provider-openai) — OpenAI
+
+## Implementing Custom Providers
+
+To support a different LLM, implement the `LLMProvider` interface from `@tepa/types`:
+
+```typescript
+import type { LLMProvider, LLMMessage, LLMRequestOptions, LLMResponse } from "@tepa/types";
+
+export class MyProvider implements LLMProvider {
+  async complete(messages: LLMMessage[], options: LLMRequestOptions): Promise<LLMResponse> {
+    // Call your LLM API, passing options.tools if provided
+    return {
+      text: "response text",
+      tokensUsed: { input: 100, output: 50 },
+      finishReason: "end_turn",
+    };
+  }
+}
+```
+
+The provider interface is intentionally minimal — one method, clear input/output types.
+
+## Native Tool Use
+
+All built-in providers support **native tool use**. When the executor passes tool schemas via `options.tools`, the provider forwards them to the LLM's native function-calling API. The LLM returns structured `toolUse` blocks with pre-parsed parameters — no manual JSON parsing needed. This eliminates escaping errors that occur when LLMs produce tool parameters as free-form text, especially with large content like file writes.

package/dist/index.cjs

@@ -0,0 +1,195 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AnthropicProvider: () => AnthropicProvider,
+  createProvider: () => createProvider,
+  extractText: () => extractText,
+  extractToolUse: () => extractToolUse,
+  toAnthropicMessages: () => toAnthropicMessages,
+  toAnthropicTools: () => toAnthropicTools,
+  toFinishReason: () => toFinishReason
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/anthropic.ts
+var import_sdk = __toESM(require("@anthropic-ai/sdk"), 1);
+var import_provider_core = require("@tepa/provider-core");
+
+// src/formatting.ts
+function toAnthropicMessages(messages) {
+  return messages.map((msg) => ({
+    role: msg.role,
+    content: msg.content
+  }));
+}
+function toFinishReason(stopReason) {
+  switch (stopReason) {
+    case "max_tokens":
+      return "max_tokens";
+    case "stop_sequence":
+      return "stop_sequence";
+    case "tool_use":
+      return "tool_use";
+    default:
+      return "end_turn";
+  }
+}
+function extractText(content) {
+  return content.filter((block) => block.type === "text").map((block) => block.text).join("");
+}
+function extractToolUse(content) {
+  return content.filter((block) => block.type === "tool_use").map((block) => ({
+    id: block.id,
+    name: block.name,
+    input: block.input
+  }));
+}
+function toAnthropicTools(tools) {
+  return tools.map((tool) => {
+    const properties = {};
+    const required = [];
+    for (const [name, param] of Object.entries(tool.parameters)) {
+      properties[name] = {
+        type: param.type,
+        description: param.description
+      };
+      if (param.required !== false) {
+        required.push(name);
+      }
+    }
+    return {
+      name: tool.name,
+      description: tool.description,
+      input_schema: {
+        type: "object",
+        properties,
+        required
+      }
+    };
+  });
+}
+
+// src/anthropic.ts
+var DEFAULT_MODEL = "claude-haiku-4-5";
+var DEFAULT_MAX_TOKENS = 64e3;
+var AnthropicProvider = class extends import_provider_core.BaseLLMProvider {
+  providerName = "anthropic";
+  client;
+  constructor(options = {}) {
+    super(options);
+    this.client = new import_sdk.default({
+      apiKey: options.apiKey,
+      timeout: 15 * 60 * 1e3
+      // 15 minutes – pipeline calls can be long
+    });
+  }
+  async doComplete(messages, options) {
+    const params = {
+      model: options.model ?? DEFAULT_MODEL,
+      max_tokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,
+      messages: toAnthropicMessages(messages)
+    };
+    if (options.temperature !== void 0) {
+      params.temperature = options.temperature;
+    }
+    if (options.systemPrompt) {
+      params.system = options.systemPrompt;
+    }
+    if (options.tools && options.tools.length > 0) {
+      params.tools = toAnthropicTools(options.tools);
+    }
+    const response = await this.client.messages.create(params);
+    const toolUse = extractToolUse(response.content);
+    return {
+      text: extractText(response.content),
+      tokensUsed: {
+        input: response.usage.input_tokens,
+        output: response.usage.output_tokens
+      },
+      finishReason: toFinishReason(response.stop_reason),
+      ...toolUse.length > 0 && { toolUse }
+    };
+  }
+  isRetryable(error) {
+    if (error instanceof import_sdk.default.RateLimitError) {
+      return true;
+    }
+    if (error instanceof import_sdk.default.InternalServerError) {
+      return true;
+    }
+    if (error instanceof import_sdk.default.APIConnectionError) {
+      return true;
+    }
+    if (error instanceof import_sdk.default.APIError && error.status === 529) {
+      return true;
+    }
+    return false;
+  }
+  getRetryAfterMs(error) {
+    if (error instanceof import_sdk.default.APIError) {
+      const retryAfter = error.headers?.["retry-after"];
+      if (retryAfter) {
+        const seconds = Number(retryAfter);
+        if (!Number.isNaN(seconds) && seconds > 0) {
+          return seconds * 1e3;
+        }
+      }
+    }
+    return null;
+  }
+  isRateLimitError(error) {
+    return error instanceof import_sdk.default.RateLimitError;
+  }
+};
+
+// src/factory.ts
+function createProvider(name, options) {
+  switch (name) {
+    case "anthropic":
+      return new AnthropicProvider(options);
+    default: {
+      const _exhaustive = name;
+      throw new Error(`Unknown provider: ${_exhaustive}`);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AnthropicProvider,
+  createProvider,
+  extractText,
+  extractToolUse,
+  toAnthropicMessages,
+  toAnthropicTools,
+  toFinishReason
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/anthropic.ts","../src/formatting.ts","../src/factory.ts"],"sourcesContent":["export { AnthropicProvider, type AnthropicProviderOptions } from \"./anthropic.js\";\nexport { createProvider, type ProviderName } from \"./factory.js\";\nexport { toAnthropicMessages, toAnthropicTools, toFinishReason, extractText, extractToolUse } from \"./formatting.js\";\n","import Anthropic from \"@anthropic-ai/sdk\";\nimport type { LLMMessage, LLMRequestOptions, LLMResponse } from \"@tepa/types\";\nimport { BaseLLMProvider, type BaseLLMProviderOptions } from \"@tepa/provider-core\";\nimport { toAnthropicMessages, toAnthropicTools, toFinishReason, extractText, extractToolUse } from \"./formatting.js\";\n\nconst DEFAULT_MODEL = \"claude-haiku-4-5\";\nconst DEFAULT_MAX_TOKENS = 64_000;\n\nexport interface AnthropicProviderOptions extends BaseLLMProviderOptions {\n  /** Anthropic API key. Falls back to ANTHROPIC_API_KEY env variable. */\n  apiKey?: string;\n}\n\n/** LLM provider implementation for Anthropic Claude models. */\nexport class AnthropicProvider extends BaseLLMProvider {\n  protected readonly providerName = \"anthropic\";\n  private readonly client: Anthropic;\n\n  constructor(options: AnthropicProviderOptions = {}) {\n    super(options);\n    this.client = new Anthropic({\n      apiKey: options.apiKey,\n      timeout: 15 * 60 * 1000, // 15 minutes – pipeline calls can be long\n    });\n  }\n\n  protected async doComplete(\n    messages: LLMMessage[],\n    options: LLMRequestOptions,\n  ): Promise<LLMResponse> {\n    const params: Anthropic.MessageCreateParamsNonStreaming = {\n      model: options.model ?? DEFAULT_MODEL,\n      max_tokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,\n      messages: toAnthropicMessages(messages),\n    };\n\n    if (options.temperature !== undefined) {\n      params.temperature = options.temperature;\n    }\n\n    if (options.systemPrompt) {\n      params.system = options.systemPrompt;\n    }\n\n    if (options.tools && options.tools.length > 0) {\n      params.tools = toAnthropicTools(options.tools);\n    }\n\n    const response = await this.client.messages.create(params);\n\n    const toolUse = extractToolUse(response.content);\n\n    return {\n      text: extractText(response.content),\n      tokensUsed: {\n        input: response.usage.input_tokens,\n        output: response.usage.output_tokens,\n      },\n      finishReason: toFinishReason(response.stop_reason),\n      ...(toolUse.length > 0 && { toolUse }),\n    };\n  }\n\n  protected isRetryable(error: unknown): boolean {\n    if (error instanceof Anthropic.RateLimitError) {\n      return true;\n    }\n    if (error instanceof Anthropic.InternalServerError) {\n      return true;\n    }\n    if (error instanceof Anthropic.APIConnectionError) {\n      return true;\n    }\n    if (error instanceof Anthropic.APIError && error.status === 529) {\n      return true;\n    }\n    return false;\n  }\n\n  protected getRetryAfterMs(error: unknown): number | null {\n    if (error instanceof Anthropic.APIError) {\n      const retryAfter = error.headers?.[\"retry-after\"];\n      if (retryAfter) {\n        const seconds = Number(retryAfter);\n        if (!Number.isNaN(seconds) && seconds > 0) {\n          return seconds * 1000;\n        }\n      }\n    }\n    return null;\n  }\n\n  protected isRateLimitError(error: unknown): boolean {\n    return error instanceof Anthropic.RateLimitError;\n  }\n}\n","import type { LLMMessage, LLMToolUseBlock, ToolSchema } from \"@tepa/types\";\nimport type Anthropic from \"@anthropic-ai/sdk\";\n\n/**\n * Convert Tepa LLMMessage array to Anthropic message format.\n */\nexport function toAnthropicMessages(\n  messages: LLMMessage[],\n): Anthropic.MessageParam[] {\n  return messages.map((msg) => ({\n    role: msg.role,\n    content: msg.content,\n  }));\n}\n\n/**\n * Map Anthropic stop_reason to Tepa finishReason.\n */\nexport function toFinishReason(\n  stopReason: string | null,\n): \"end_turn\" | \"max_tokens\" | \"stop_sequence\" | \"tool_use\" {\n  switch (stopReason) {\n    case \"max_tokens\":\n      return \"max_tokens\";\n    case \"stop_sequence\":\n      return \"stop_sequence\";\n    case \"tool_use\":\n      return \"tool_use\";\n    default:\n      return \"end_turn\";\n  }\n}\n\n/**\n * Extract text content from Anthropic response content blocks.\n */\nexport function extractText(content: Anthropic.ContentBlock[]): string {\n  return content\n    .filter((block): block is Anthropic.TextBlock => block.type === \"text\")\n    .map((block) => block.text)\n    .join(\"\");\n}\n\n/**\n * Extract tool use blocks from Anthropic response content blocks.\n */\nexport function extractToolUse(content: Anthropic.ContentBlock[]): LLMToolUseBlock[] {\n  return content\n    .filter((block): block is Anthropic.ToolUseBlock => block.type === \"tool_use\")\n    .map((block) => ({\n      id: block.id,\n      name: block.name,\n      input: block.input as Record<string, unknown>,\n    }));\n}\n\n/**\n * Convert Tepa ToolSchema to Anthropic tool format.\n */\nexport function toAnthropicTools(tools: ToolSchema[]): Anthropic.Tool[] {\n  return tools.map((tool) => {\n    const properties: Record<string, unknown> = {};\n    const required: string[] = [];\n\n    for (const [name, param] of Object.entries(tool.parameters)) {\n      properties[name] = {\n        type: param.type,\n        description: param.description,\n      };\n      if (param.required !== false) {\n        required.push(name);\n      }\n    }\n\n    return {\n      name: tool.name,\n      description: tool.description,\n      input_schema: {\n        type: \"object\" as const,\n        properties,\n        required,\n      },\n    };\n  });\n}\n","import type { LLMProvider } from \"@tepa/types\";\nimport { AnthropicProvider, type AnthropicProviderOptions } from \"./anthropic.js\";\n\nexport type ProviderName = \"anthropic\";\n\n/**\n * Create an LLM provider from a name string.\n * Currently supports \"anthropic\". Future providers (openai, gemini, etc.)\n * would be separate packages following the same pattern.\n */\nexport function createProvider(\n  name: ProviderName,\n  options?: AnthropicProviderOptions,\n): LLMProvider {\n  switch (name) {\n    case \"anthropic\":\n      return new AnthropicProvider(options);\n    default: {\n      const _exhaustive: never = name;\n      throw new Error(`Unknown provider: ${_exhaustive}`);\n    }\n  }\n}\n"],"mappings":"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","names":["Anthropic"]}

package/dist/index.d.cts

@@ -0,0 +1,49 @@
+import { LLMMessage, LLMRequestOptions, LLMResponse, LLMProvider, LLMToolUseBlock, ToolSchema } from '@tepa/types';
+import { BaseLLMProvider, BaseLLMProviderOptions } from '@tepa/provider-core';
+import Anthropic from '@anthropic-ai/sdk';
+
+interface AnthropicProviderOptions extends BaseLLMProviderOptions {
+    /** Anthropic API key. Falls back to ANTHROPIC_API_KEY env variable. */
+    apiKey?: string;
+}
+/** LLM provider implementation for Anthropic Claude models. */
+declare class AnthropicProvider extends BaseLLMProvider {
+    protected readonly providerName = "anthropic";
+    private readonly client;
+    constructor(options?: AnthropicProviderOptions);
+    protected doComplete(messages: LLMMessage[], options: LLMRequestOptions): Promise<LLMResponse>;
+    protected isRetryable(error: unknown): boolean;
+    protected getRetryAfterMs(error: unknown): number | null;
+    protected isRateLimitError(error: unknown): boolean;
+}
+
+type ProviderName = "anthropic";
+/**
+ * Create an LLM provider from a name string.
+ * Currently supports "anthropic". Future providers (openai, gemini, etc.)
+ * would be separate packages following the same pattern.
+ */
+declare function createProvider(name: ProviderName, options?: AnthropicProviderOptions): LLMProvider;
+
+/**
+ * Convert Tepa LLMMessage array to Anthropic message format.
+ */
+declare function toAnthropicMessages(messages: LLMMessage[]): Anthropic.MessageParam[];
+/**
+ * Map Anthropic stop_reason to Tepa finishReason.
+ */
+declare function toFinishReason(stopReason: string | null): "end_turn" | "max_tokens" | "stop_sequence" | "tool_use";
+/**
+ * Extract text content from Anthropic response content blocks.
+ */
+declare function extractText(content: Anthropic.ContentBlock[]): string;
+/**
+ * Extract tool use blocks from Anthropic response content blocks.
+ */
+declare function extractToolUse(content: Anthropic.ContentBlock[]): LLMToolUseBlock[];
+/**
+ * Convert Tepa ToolSchema to Anthropic tool format.
+ */
+declare function toAnthropicTools(tools: ToolSchema[]): Anthropic.Tool[];
+
+export { AnthropicProvider, type AnthropicProviderOptions, type ProviderName, createProvider, extractText, extractToolUse, toAnthropicMessages, toAnthropicTools, toFinishReason };

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+import { LLMMessage, LLMRequestOptions, LLMResponse, LLMProvider, LLMToolUseBlock, ToolSchema } from '@tepa/types';
+import { BaseLLMProvider, BaseLLMProviderOptions } from '@tepa/provider-core';
+import Anthropic from '@anthropic-ai/sdk';
+
+interface AnthropicProviderOptions extends BaseLLMProviderOptions {
+    /** Anthropic API key. Falls back to ANTHROPIC_API_KEY env variable. */
+    apiKey?: string;
+}
+/** LLM provider implementation for Anthropic Claude models. */
+declare class AnthropicProvider extends BaseLLMProvider {
+    protected readonly providerName = "anthropic";
+    private readonly client;
+    constructor(options?: AnthropicProviderOptions);
+    protected doComplete(messages: LLMMessage[], options: LLMRequestOptions): Promise<LLMResponse>;
+    protected isRetryable(error: unknown): boolean;
+    protected getRetryAfterMs(error: unknown): number | null;
+    protected isRateLimitError(error: unknown): boolean;
+}
+
+type ProviderName = "anthropic";
+/**
+ * Create an LLM provider from a name string.
+ * Currently supports "anthropic". Future providers (openai, gemini, etc.)
+ * would be separate packages following the same pattern.
+ */
+declare function createProvider(name: ProviderName, options?: AnthropicProviderOptions): LLMProvider;
+
+/**
+ * Convert Tepa LLMMessage array to Anthropic message format.
+ */
+declare function toAnthropicMessages(messages: LLMMessage[]): Anthropic.MessageParam[];
+/**
+ * Map Anthropic stop_reason to Tepa finishReason.
+ */
+declare function toFinishReason(stopReason: string | null): "end_turn" | "max_tokens" | "stop_sequence" | "tool_use";
+/**
+ * Extract text content from Anthropic response content blocks.
+ */
+declare function extractText(content: Anthropic.ContentBlock[]): string;
+/**
+ * Extract tool use blocks from Anthropic response content blocks.
+ */
+declare function extractToolUse(content: Anthropic.ContentBlock[]): LLMToolUseBlock[];
+/**
+ * Convert Tepa ToolSchema to Anthropic tool format.
+ */
+declare function toAnthropicTools(tools: ToolSchema[]): Anthropic.Tool[];
+
+export { AnthropicProvider, type AnthropicProviderOptions, type ProviderName, createProvider, extractText, extractToolUse, toAnthropicMessages, toAnthropicTools, toFinishReason };

package/dist/index.js

@@ -0,0 +1,152 @@
+// src/anthropic.ts
+import Anthropic from "@anthropic-ai/sdk";
+import { BaseLLMProvider } from "@tepa/provider-core";
+
+// src/formatting.ts
+function toAnthropicMessages(messages) {
+  return messages.map((msg) => ({
+    role: msg.role,
+    content: msg.content
+  }));
+}
+function toFinishReason(stopReason) {
+  switch (stopReason) {
+    case "max_tokens":
+      return "max_tokens";
+    case "stop_sequence":
+      return "stop_sequence";
+    case "tool_use":
+      return "tool_use";
+    default:
+      return "end_turn";
+  }
+}
+function extractText(content) {
+  return content.filter((block) => block.type === "text").map((block) => block.text).join("");
+}
+function extractToolUse(content) {
+  return content.filter((block) => block.type === "tool_use").map((block) => ({
+    id: block.id,
+    name: block.name,
+    input: block.input
+  }));
+}
+function toAnthropicTools(tools) {
+  return tools.map((tool) => {
+    const properties = {};
+    const required = [];
+    for (const [name, param] of Object.entries(tool.parameters)) {
+      properties[name] = {
+        type: param.type,
+        description: param.description
+      };
+      if (param.required !== false) {
+        required.push(name);
+      }
+    }
+    return {
+      name: tool.name,
+      description: tool.description,
+      input_schema: {
+        type: "object",
+        properties,
+        required
+      }
+    };
+  });
+}
+
+// src/anthropic.ts
+var DEFAULT_MODEL = "claude-haiku-4-5";
+var DEFAULT_MAX_TOKENS = 64e3;
+var AnthropicProvider = class extends BaseLLMProvider {
+  providerName = "anthropic";
+  client;
+  constructor(options = {}) {
+    super(options);
+    this.client = new Anthropic({
+      apiKey: options.apiKey,
+      timeout: 15 * 60 * 1e3
+      // 15 minutes – pipeline calls can be long
+    });
+  }
+  async doComplete(messages, options) {
+    const params = {
+      model: options.model ?? DEFAULT_MODEL,
+      max_tokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,
+      messages: toAnthropicMessages(messages)
+    };
+    if (options.temperature !== void 0) {
+      params.temperature = options.temperature;
+    }
+    if (options.systemPrompt) {
+      params.system = options.systemPrompt;
+    }
+    if (options.tools && options.tools.length > 0) {
+      params.tools = toAnthropicTools(options.tools);
+    }
+    const response = await this.client.messages.create(params);
+    const toolUse = extractToolUse(response.content);
+    return {
+      text: extractText(response.content),
+      tokensUsed: {
+        input: response.usage.input_tokens,
+        output: response.usage.output_tokens
+      },
+      finishReason: toFinishReason(response.stop_reason),
+      ...toolUse.length > 0 && { toolUse }
+    };
+  }
+  isRetryable(error) {
+    if (error instanceof Anthropic.RateLimitError) {
+      return true;
+    }
+    if (error instanceof Anthropic.InternalServerError) {
+      return true;
+    }
+    if (error instanceof Anthropic.APIConnectionError) {
+      return true;
+    }
+    if (error instanceof Anthropic.APIError && error.status === 529) {
+      return true;
+    }
+    return false;
+  }
+  getRetryAfterMs(error) {
+    if (error instanceof Anthropic.APIError) {
+      const retryAfter = error.headers?.["retry-after"];
+      if (retryAfter) {
+        const seconds = Number(retryAfter);
+        if (!Number.isNaN(seconds) && seconds > 0) {
+          return seconds * 1e3;
+        }
+      }
+    }
+    return null;
+  }
+  isRateLimitError(error) {
+    return error instanceof Anthropic.RateLimitError;
+  }
+};
+
+// src/factory.ts
+function createProvider(name, options) {
+  switch (name) {
+    case "anthropic":
+      return new AnthropicProvider(options);
+    default: {
+      const _exhaustive = name;
+      throw new Error(`Unknown provider: ${_exhaustive}`);
+    }
+  }
+}
+export {
+  AnthropicProvider,
+  createProvider,
+  extractText,
+  extractToolUse,
+  toAnthropicMessages,
+  toAnthropicTools,
+  toFinishReason
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/anthropic.ts","../src/formatting.ts","../src/factory.ts"],"sourcesContent":["import Anthropic from \"@anthropic-ai/sdk\";\nimport type { LLMMessage, LLMRequestOptions, LLMResponse } from \"@tepa/types\";\nimport { BaseLLMProvider, type BaseLLMProviderOptions } from \"@tepa/provider-core\";\nimport { toAnthropicMessages, toAnthropicTools, toFinishReason, extractText, extractToolUse } from \"./formatting.js\";\n\nconst DEFAULT_MODEL = \"claude-haiku-4-5\";\nconst DEFAULT_MAX_TOKENS = 64_000;\n\nexport interface AnthropicProviderOptions extends BaseLLMProviderOptions {\n  /** Anthropic API key. Falls back to ANTHROPIC_API_KEY env variable. */\n  apiKey?: string;\n}\n\n/** LLM provider implementation for Anthropic Claude models. */\nexport class AnthropicProvider extends BaseLLMProvider {\n  protected readonly providerName = \"anthropic\";\n  private readonly client: Anthropic;\n\n  constructor(options: AnthropicProviderOptions = {}) {\n    super(options);\n    this.client = new Anthropic({\n      apiKey: options.apiKey,\n      timeout: 15 * 60 * 1000, // 15 minutes – pipeline calls can be long\n    });\n  }\n\n  protected async doComplete(\n    messages: LLMMessage[],\n    options: LLMRequestOptions,\n  ): Promise<LLMResponse> {\n    const params: Anthropic.MessageCreateParamsNonStreaming = {\n      model: options.model ?? DEFAULT_MODEL,\n      max_tokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,\n      messages: toAnthropicMessages(messages),\n    };\n\n    if (options.temperature !== undefined) {\n      params.temperature = options.temperature;\n    }\n\n    if (options.systemPrompt) {\n      params.system = options.systemPrompt;\n    }\n\n    if (options.tools && options.tools.length > 0) {\n      params.tools = toAnthropicTools(options.tools);\n    }\n\n    const response = await this.client.messages.create(params);\n\n    const toolUse = extractToolUse(response.content);\n\n    return {\n      text: extractText(response.content),\n      tokensUsed: {\n        input: response.usage.input_tokens,\n        output: response.usage.output_tokens,\n      },\n      finishReason: toFinishReason(response.stop_reason),\n      ...(toolUse.length > 0 && { toolUse }),\n    };\n  }\n\n  protected isRetryable(error: unknown): boolean {\n    if (error instanceof Anthropic.RateLimitError) {\n      return true;\n    }\n    if (error instanceof Anthropic.InternalServerError) {\n      return true;\n    }\n    if (error instanceof Anthropic.APIConnectionError) {\n      return true;\n    }\n    if (error instanceof Anthropic.APIError && error.status === 529) {\n      return true;\n    }\n    return false;\n  }\n\n  protected getRetryAfterMs(error: unknown): number | null {\n    if (error instanceof Anthropic.APIError) {\n      const retryAfter = error.headers?.[\"retry-after\"];\n      if (retryAfter) {\n        const seconds = Number(retryAfter);\n        if (!Number.isNaN(seconds) && seconds > 0) {\n          return seconds * 1000;\n        }\n      }\n    }\n    return null;\n  }\n\n  protected isRateLimitError(error: unknown): boolean {\n    return error instanceof Anthropic.RateLimitError;\n  }\n}\n","import type { LLMMessage, LLMToolUseBlock, ToolSchema } from \"@tepa/types\";\nimport type Anthropic from \"@anthropic-ai/sdk\";\n\n/**\n * Convert Tepa LLMMessage array to Anthropic message format.\n */\nexport function toAnthropicMessages(\n  messages: LLMMessage[],\n): Anthropic.MessageParam[] {\n  return messages.map((msg) => ({\n    role: msg.role,\n    content: msg.content,\n  }));\n}\n\n/**\n * Map Anthropic stop_reason to Tepa finishReason.\n */\nexport function toFinishReason(\n  stopReason: string | null,\n): \"end_turn\" | \"max_tokens\" | \"stop_sequence\" | \"tool_use\" {\n  switch (stopReason) {\n    case \"max_tokens\":\n      return \"max_tokens\";\n    case \"stop_sequence\":\n      return \"stop_sequence\";\n    case \"tool_use\":\n      return \"tool_use\";\n    default:\n      return \"end_turn\";\n  }\n}\n\n/**\n * Extract text content from Anthropic response content blocks.\n */\nexport function extractText(content: Anthropic.ContentBlock[]): string {\n  return content\n    .filter((block): block is Anthropic.TextBlock => block.type === \"text\")\n    .map((block) => block.text)\n    .join(\"\");\n}\n\n/**\n * Extract tool use blocks from Anthropic response content blocks.\n */\nexport function extractToolUse(content: Anthropic.ContentBlock[]): LLMToolUseBlock[] {\n  return content\n    .filter((block): block is Anthropic.ToolUseBlock => block.type === \"tool_use\")\n    .map((block) => ({\n      id: block.id,\n      name: block.name,\n      input: block.input as Record<string, unknown>,\n    }));\n}\n\n/**\n * Convert Tepa ToolSchema to Anthropic tool format.\n */\nexport function toAnthropicTools(tools: ToolSchema[]): Anthropic.Tool[] {\n  return tools.map((tool) => {\n    const properties: Record<string, unknown> = {};\n    const required: string[] = [];\n\n    for (const [name, param] of Object.entries(tool.parameters)) {\n      properties[name] = {\n        type: param.type,\n        description: param.description,\n      };\n      if (param.required !== false) {\n        required.push(name);\n      }\n    }\n\n    return {\n      name: tool.name,\n      description: tool.description,\n      input_schema: {\n        type: \"object\" as const,\n        properties,\n        required,\n      },\n    };\n  });\n}\n","import type { LLMProvider } from \"@tepa/types\";\nimport { AnthropicProvider, type AnthropicProviderOptions } from \"./anthropic.js\";\n\nexport type ProviderName = \"anthropic\";\n\n/**\n * Create an LLM provider from a name string.\n * Currently supports \"anthropic\". Future providers (openai, gemini, etc.)\n * would be separate packages following the same pattern.\n */\nexport function createProvider(\n  name: ProviderName,\n  options?: AnthropicProviderOptions,\n): LLMProvider {\n  switch (name) {\n    case \"anthropic\":\n      return new AnthropicProvider(options);\n    default: {\n      const _exhaustive: never = name;\n      throw new Error(`Unknown provider: ${_exhaustive}`);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@tepa/provider-anthropic",
+  "version": "0.1.0",
+  "description": "Anthropic Claude LLM provider for the Tepa autonomous agent",
+  "license": "MIT",
+  "author": "Frandi <frandi.tech@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/frandi/tepa-ai.git",
+    "directory": "packages/provider-anthropic"
+  },
+  "homepage": "https://github.com/frandi/tepa-ai/tree/main/packages/provider-anthropic#readme",
+  "bugs": {
+    "url": "https://github.com/frandi/tepa-ai/issues"
+  },
+  "keywords": ["tepa", "ai", "llm", "agent", "anthropic", "claude", "provider"],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@tepa/types": "^0.1.0",
+    "@tepa/provider-core": "^0.1.0",
+    "@anthropic-ai/sdk": "^0.39.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  }
+}