@bernierllc/ai-provider-anthropic 1.0.0

package/src/models/model-registry.ts

@@ -0,0 +1,120 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code only within the scope of the project it was delivered for.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+import { ModelInfo } from '@bernierllc/ai-provider-core';
+
+/**
+ * Claude 3 Model Registry
+ * Contains information about all available Claude models
+ */
+export class ClaudeModelRegistry {
+  private static models: Map<string, ModelInfo> = new Map();
+
+  /**
+   * Initialize the model registry with Claude 3 models
+   */
+  static initialize(): void {
+    const models: ModelInfo[] = [
+      {
+        id: 'claude-3-opus-20240229',
+        name: 'Claude 3 Opus',
+        contextWindow: 200000,
+        maxOutputTokens: 4096,
+        pricing: {
+          inputPricePerToken: 15 / 1000000,
+          outputPricePerToken: 75 / 1000000,
+          currency: 'USD'
+        },
+        capabilities: ['chat', 'completion', 'vision', 'extended-context', 'analysis'],
+        description: 'Most capable Claude model for complex tasks with superior reasoning'
+      },
+      {
+        id: 'claude-3-sonnet-20240229',
+        name: 'Claude 3 Sonnet',
+        contextWindow: 200000,
+        maxOutputTokens: 4096,
+        pricing: {
+          inputPricePerToken: 3 / 1000000,
+          outputPricePerToken: 15 / 1000000,
+          currency: 'USD'
+        },
+        capabilities: ['chat', 'completion', 'vision', 'extended-context'],
+        description: 'Balanced performance and speed for most tasks'
+      },
+      {
+        id: 'claude-3-haiku-20240307',
+        name: 'Claude 3 Haiku',
+        contextWindow: 200000,
+        maxOutputTokens: 4096,
+        pricing: {
+          inputPricePerToken: 0.25 / 1000000,
+          outputPricePerToken: 1.25 / 1000000,
+          currency: 'USD'
+        },
+        capabilities: ['chat', 'completion', 'vision', 'extended-context'],
+        description: 'Fastest and most compact model for quick responses'
+      }
+    ];
+
+    models.forEach(model => {
+      this.models.set(model.id, model);
+    });
+  }
+
+  /**
+   * Get a specific model by ID
+   */
+  static getModel(modelId: string): ModelInfo | undefined {
+    if (this.models.size === 0) {
+      this.initialize();
+    }
+    return this.models.get(modelId);
+  }
+
+  /**
+   * Get all available models
+   */
+  static getAllModels(): ModelInfo[] {
+    if (this.models.size === 0) {
+      this.initialize();
+    }
+    return Array.from(this.models.values());
+  }
+
+  /**
+   * Check if a model ID is valid
+   */
+  static isValidModel(modelId: string): boolean {
+    if (this.models.size === 0) {
+      this.initialize();
+    }
+    return this.models.has(modelId);
+  }
+
+  /**
+   * Get pricing for a specific model
+   */
+  static getModelPricing(modelId: string): { inputPrice: number; outputPrice: number } {
+    const model = this.getModel(modelId);
+    if (model?.pricing) {
+      return {
+        inputPrice: model.pricing.inputPricePerToken * 1000000,
+        outputPrice: model.pricing.outputPricePerToken * 1000000
+      };
+    }
+
+    // Default to Sonnet pricing
+    return {
+      inputPrice: 3,
+      outputPrice: 15
+    };
+  }
+}
+
+// Initialize on module load
+ClaudeModelRegistry.initialize();

package/src/types/anthropic-types.ts

@@ -0,0 +1,60 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code only within the scope of the project it was delivered for.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+import { AIProviderConfig, CompletionRequest } from '@bernierllc/ai-provider-core';
+
+/**
+ * Anthropic Provider Configuration
+ */
+export interface AnthropicProviderConfig extends AIProviderConfig {
+  providerName: 'anthropic';
+}
+
+/**
+ * Anthropic Extended Context Request
+ */
+export interface AnthropicExtendedContextRequest extends CompletionRequest {
+  enableExtendedContext?: boolean;
+}
+
+/**
+ * Anthropic Vision Request
+ */
+export interface AnthropicVisionRequest {
+  imageData: string | Buffer;
+  prompt: string;
+  model?: string;
+  maxTokens?: number;
+  temperature?: number;
+}
+
+/**
+ * Anthropic Message Content Block
+ */
+export interface AnthropicMessageContent {
+  type: 'text' | 'image';
+  text?: string;
+  source?: {
+    type: 'base64';
+    media_type: string;
+    data: string;
+  };
+}
+
+/**
+ * Anthropic Message Format (Internal)
+ */
+export interface AnthropicMessage {
+  role: 'user' | 'assistant';
+  content: string | AnthropicMessageContent[];
+}
+
+/**
+ * Anthropic Stop Reason
+ */
+export type AnthropicStopReason = 'end_turn' | 'max_tokens' | 'stop_sequence' | null;

package/src/types/index.ts

@@ -0,0 +1,9 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code only within the scope of the project it was delivered for.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+export * from './anthropic-types';

package/src/utils/error-handling.ts

@@ -0,0 +1,71 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code only within the scope of the project it was delivered for.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+import Anthropic from '@anthropic-ai/sdk';
+
+/**
+ * Handle Anthropic API errors and convert to provider error format
+ */
+export function handleAnthropicError(error: unknown): Error {
+  if (error instanceof Anthropic.APIError) {
+    const status = error.status || 'unknown';
+    const message = `Anthropic API Error (${status}): ${error.message}`;
+
+    const providerError = new Error(message);
+    providerError.name = 'AnthropicAPIError';
+    return providerError;
+  }
+
+  if (error instanceof Anthropic.AuthenticationError) {
+    const providerError = new Error('Anthropic authentication failed. Check your API key.');
+    providerError.name = 'AnthropicAuthError';
+    return providerError;
+  }
+
+  if (error instanceof Anthropic.RateLimitError) {
+    const providerError = new Error('Anthropic rate limit exceeded. Please retry after a delay.');
+    providerError.name = 'AnthropicRateLimitError';
+    return providerError;
+  }
+
+  if (error instanceof Error) {
+    return error;
+  }
+
+  return new Error(`Unknown Anthropic error: ${String(error)}`);
+}
+
+/**
+ * Check if error is retryable
+ */
+export function isRetryableError(error: unknown): boolean {
+  if (error instanceof Anthropic.APIError) {
+    // Retry on 5xx errors and rate limits
+    const status = error.status || 0;
+    return status >= 500 || status === 429;
+  }
+
+  if (error instanceof Anthropic.RateLimitError) {
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * Get retry delay from error (if available)
+ */
+export function getRetryDelay(error: unknown): number | undefined {
+  if (error instanceof Anthropic.RateLimitError) {
+    // Check for Retry-After header if available
+    // Default to 1 second if not specified
+    return 1000;
+  }
+
+  return undefined;
+}

package/src/utils/index.ts

@@ -0,0 +1,10 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code only within the scope of the project it was delivered for.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+export * from './message-conversion';
+export * from './error-handling';

package/src/utils/message-conversion.ts

@@ -0,0 +1,78 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code only within the scope of the project it was delivered for.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+import { Message } from '@bernierllc/ai-provider-core';
+import Anthropic from '@anthropic-ai/sdk';
+
+/**
+ * Convert messages from unified format to Anthropic format
+ * Extracts system messages separately (Anthropic uses system parameter, not messages array)
+ */
+export function convertMessagesToAnthropicFormat(messages: Message[]): {
+  system?: string;
+  messages: Anthropic.MessageParam[];
+} {
+  // Extract system messages
+  const systemMessages = messages.filter(m => m.role === 'system');
+  const system = systemMessages.length > 0
+    ? systemMessages.map(m => m.content).join('\n\n')
+    : undefined;
+
+  // Convert remaining messages to Anthropic format
+  const anthropicMessages: Anthropic.MessageParam[] = messages
+    .filter(m => m.role !== 'system')
+    .map(msg => ({
+      role: msg.role === 'assistant' ? ('assistant' as const) : ('user' as const),
+      content: msg.content
+    }));
+
+  return { system, messages: anthropicMessages };
+}
+
+/**
+ * Validate message format before conversion
+ */
+export function validateMessages(messages: Message[]): {
+  isValid: boolean;
+  error?: string;
+} {
+  if (!messages || messages.length === 0) {
+    return {
+      isValid: false,
+      error: 'Messages array cannot be empty'
+    };
+  }
+
+  // Check that all messages have required fields
+  for (const msg of messages) {
+    if (!msg.role || !msg.content) {
+      return {
+        isValid: false,
+        error: 'All messages must have role and content'
+      };
+    }
+
+    if (!['system', 'user', 'assistant'].includes(msg.role)) {
+      return {
+        isValid: false,
+        error: `Invalid message role: ${msg.role}`
+      };
+    }
+  }
+
+  // Ensure non-system messages exist
+  const nonSystemMessages = messages.filter(m => m.role !== 'system');
+  if (nonSystemMessages.length === 0) {
+    return {
+      isValid: false,
+      error: 'At least one non-system message is required'
+    };
+  }
+
+  return { isValid: true };
+}

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node",
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "strictBindCallApply": true,
+    "strictPropertyInitialization": true,
+    "noImplicitThis": true,
+    "alwaysStrict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "__tests__"]
+}