@kjerneverk/execution-anthropic 1.0.4-dev.0

package/.kodrdriv-test-cache.json

@@ -0,0 +1,6 @@
+{
+  "/Users/tobrien/gitw/kjerneverk/execution-anthropic": {
+    "lastTestRun": 1768074147459,
+    "lastCommitHash": "c99b06505aa201b8a5c9a3cea2a9e5fe1f59450b"
+  }
+}

package/LICENSE

@@ -0,0 +1,18 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2025 Tim O'Brien
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+

package/README.md

@@ -0,0 +1,83 @@
+# execution-anthropic
+
+Anthropic Claude provider implementation for LLM execution. Implements the `Provider` interface from the `execution` package.
+
+## Installation
+
+```bash
+npm install execution-anthropic @anthropic-ai/sdk
+```
+
+## Usage
+
+```typescript
+import { AnthropicProvider, createAnthropicProvider } from 'execution-anthropic';
+
+// Create provider
+const provider = createAnthropicProvider();
+
+// Execute a request
+const response = await provider.execute(
+  {
+    model: 'claude-3-opus-20240229',
+    messages: [
+      { role: 'system', content: 'You are helpful.' },
+      { role: 'user', content: 'Hello!' }
+    ],
+    addMessage: () => {},
+  },
+  {
+    apiKey: process.env.ANTHROPIC_API_KEY,
+    temperature: 0.7,
+    maxTokens: 4096,
+  }
+);
+
+console.log(response.content);
+console.log(response.usage); // { inputTokens: X, outputTokens: Y }
+```
+
+## Supported Models
+
+The provider supports all Claude models:
+- Claude 3 Opus
+- Claude 3 Sonnet
+- Claude 3 Haiku
+- Claude 3.5 family
+
+## API Key
+
+Set via:
+1. `options.apiKey` parameter
+2. `ANTHROPIC_API_KEY` environment variable
+
+## Features
+
+- Automatic system prompt extraction (Anthropic separates system from messages)
+- Structured output via tool use (JSON schema support)
+- Full token usage tracking
+
+## Response Format
+
+```typescript
+interface ProviderResponse {
+  content: string;
+  model: string;
+  usage?: {
+    inputTokens: number;
+    outputTokens: number;
+  };
+}
+```
+
+## Related Packages
+
+- `execution` - Core interfaces (no SDK dependencies)
+- `execution-openai` - OpenAI provider
+- `execution-gemini` - Google Gemini provider
+
+## License
+
+Apache-2.0
+
+<!-- v1.0.0 -->

package/dist/index.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Execution Anthropic Package
+ *
+ * Anthropic provider implementation for LLM execution.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Anthropic Provider implementation
+ */
+declare class AnthropicProvider implements Provider {
+    readonly name = "anthropic";
+    /**
+     * Check if this provider supports a given model
+     */
+    supportsModel(model: Model): boolean;
+    /**
+     * Execute a request against Anthropic
+     */
+    execute(request: Request_2, options?: ExecutionOptions): Promise<ProviderResponse>;
+}
+export { AnthropicProvider }
+export default AnthropicProvider;
+
+/**
+ * Create a new Anthropic provider instance
+ */
+export declare function createAnthropicProvider(): AnthropicProvider;
+
+export declare interface ExecutionOptions {
+    apiKey?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    timeout?: number;
+    retries?: number;
+}
+
+export declare interface Message {
+    role: 'user' | 'assistant' | 'system' | 'developer' | 'tool';
+    content: string | string[] | null;
+    name?: string;
+}
+
+export declare type Model = string;
+
+export declare interface Provider {
+    readonly name: string;
+    execute(request: Request_2, options?: ExecutionOptions): Promise<ProviderResponse>;
+    supportsModel?(model: Model): boolean;
+}
+
+export declare interface ProviderResponse {
+    content: string;
+    model: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    toolCalls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+
+declare interface Request_2 {
+    messages: Message[];
+    model: Model;
+    responseFormat?: any;
+    validator?: any;
+    addMessage(message: Message): void;
+}
+export { Request_2 as Request }
+
+/**
+ * Package version
+ */
+export declare const VERSION = "0.0.1";
+
+export { }

package/dist/index.js

@@ -0,0 +1,123 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { getRedactor } from "@utilarium/offrecord";
+import { configureErrorSanitizer, configureSecretGuard, createSafeError } from "@utilarium/spotclean";
+const redactor = getRedactor();
+redactor.register({
+  name: "anthropic",
+  patterns: [
+    /sk-ant-[a-zA-Z0-9_-]+/g,
+    /sk-ant-api\d+-[a-zA-Z0-9_-]+/g
+  ],
+  validator: (key) => /^sk-ant(-api\d+)?-[a-zA-Z0-9_-]+$/.test(key),
+  envVar: "ANTHROPIC_API_KEY",
+  description: "Anthropic API keys"
+});
+configureErrorSanitizer({
+  enabled: true,
+  environment: process.env.NODE_ENV === "production" ? "production" : "development",
+  includeCorrelationId: true,
+  sanitizeStackTraces: process.env.NODE_ENV === "production",
+  maxMessageLength: 500
+});
+configureSecretGuard({
+  enabled: true,
+  redactionText: "[REDACTED]",
+  preservePartial: false,
+  preserveLength: 0,
+  customPatterns: [
+    { name: "anthropic", pattern: /sk-ant-[a-zA-Z0-9_-]+/g, description: "Anthropic API key" },
+    { name: "anthropic-api", pattern: /sk-ant-api\d+-[a-zA-Z0-9_-]+/g, description: "Anthropic API key" }
+  ]
+});
+class AnthropicProvider {
+  name = "anthropic";
+  /**
+   * Check if this provider supports a given model
+   */
+  supportsModel(model) {
+    if (!model) return false;
+    return model.startsWith("claude");
+  }
+  /**
+   * Execute a request against Anthropic
+   */
+  async execute(request, options = {}) {
+    const apiKey = options.apiKey || process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+      throw new Error("Anthropic API key is required. Set ANTHROPIC_API_KEY environment variable.");
+    }
+    const validation = redactor.validateKey(apiKey, "anthropic");
+    if (!validation.valid) {
+      throw new Error("Invalid Anthropic API key format");
+    }
+    try {
+      const client = new Anthropic({ apiKey });
+      const model = options.model || request.model || "claude-3-opus-20240229";
+      let systemPrompt = "";
+      const messages = [];
+      for (const msg of request.messages) {
+        if (msg.role === "system" || msg.role === "developer") {
+          systemPrompt += (typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content)) + "\n\n";
+        } else {
+          messages.push({
+            role: msg.role,
+            content: typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content)
+          });
+        }
+      }
+      const response = await client.messages.create({
+        model,
+        system: systemPrompt.trim() || void 0,
+        messages,
+        max_tokens: options.maxTokens || 4096,
+        temperature: options.temperature,
+        ...request.responseFormat?.type === "json_schema" ? {
+          tools: [
+            {
+              name: request.responseFormat.json_schema.name,
+              description: request.responseFormat.json_schema.description || "Output data in this structured format",
+              input_schema: request.responseFormat.json_schema.schema
+            }
+          ],
+          tool_choice: {
+            type: "tool",
+            name: request.responseFormat.json_schema.name
+          }
+        } : {}
+      });
+      let text = "";
+      if (request.responseFormat?.type === "json_schema") {
+        const toolUseBlock = response.content.find(
+          (block) => block.type === "tool_use"
+        );
+        if (toolUseBlock && toolUseBlock.type === "tool_use") {
+          text = JSON.stringify(toolUseBlock.input, null, 2);
+        }
+      } else {
+        const contentBlock = response.content[0];
+        text = contentBlock.type === "text" ? contentBlock.text : "";
+      }
+      return {
+        content: text,
+        model: response.model,
+        usage: {
+          inputTokens: response.usage.input_tokens,
+          outputTokens: response.usage.output_tokens
+        }
+      };
+    } catch (error) {
+      throw createSafeError(error, { provider: "anthropic" });
+    }
+  }
+}
+function createAnthropicProvider() {
+  return new AnthropicProvider();
+}
+const VERSION = "0.0.1";
+export {
+  AnthropicProvider,
+  VERSION,
+  createAnthropicProvider,
+  AnthropicProvider as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * Execution Anthropic Package\n *\n * Anthropic provider implementation for LLM execution.\n *\n * @packageDocumentation\n */\n\nimport Anthropic from '@anthropic-ai/sdk';\nimport { getRedactor } from '@utilarium/offrecord';\nimport { \n    createSafeError, \n    configureErrorSanitizer,\n    configureSecretGuard,\n} from '@utilarium/spotclean';\n\n// Register Anthropic API key patterns on module load\nconst redactor = getRedactor();\nredactor.register({\n    name: 'anthropic',\n    patterns: [\n        /sk-ant-[a-zA-Z0-9_-]+/g,\n        /sk-ant-api\\d+-[a-zA-Z0-9_-]+/g,\n    ],\n    validator: (key: string) => /^sk-ant(-api\\d+)?-[a-zA-Z0-9_-]+$/.test(key),\n    envVar: 'ANTHROPIC_API_KEY',\n    description: 'Anthropic API keys',\n});\n\n// Configure spotclean for error sanitization\nconfigureErrorSanitizer({\n    enabled: true,\n    environment: process.env.NODE_ENV === 'production' ? 'production' : 'development',\n    includeCorrelationId: true,\n    sanitizeStackTraces: process.env.NODE_ENV === 'production',\n    maxMessageLength: 500,\n});\n\nconfigureSecretGuard({\n    enabled: true,\n    redactionText: '[REDACTED]',\n    preservePartial: false,\n    preserveLength: 0,\n    customPatterns: [\n        { name: 'anthropic', pattern: /sk-ant-[a-zA-Z0-9_-]+/g, description: 'Anthropic API key' },\n        { name: 'anthropic-api', pattern: /sk-ant-api\\d+-[a-zA-Z0-9_-]+/g, description: 'Anthropic API key' },\n    ],\n});\n\n// ===== INLINE TYPES (from 'execution' package) =====\n\nexport type Model = string;\n\nexport interface Message {\n    role: 'user' | 'assistant' | 'system' | 'developer' | 'tool';\n    content: string | string[] | null;\n    name?: string;\n}\n\nexport interface Request {\n    messages: Message[];\n    model: Model;\n    responseFormat?: any;\n    validator?: any;\n    addMessage(message: Message): void;\n}\n\nexport interface ProviderResponse {\n    content: string;\n    model: string;\n    usage?: {\n        inputTokens: number;\n        outputTokens: number;\n    };\n    toolCalls?: Array<{\n        id: string;\n        type: 'function';\n        function: {\n            name: string;\n            arguments: string;\n        };\n    }>;\n}\n\nexport interface ExecutionOptions {\n    apiKey?: string;\n    model?: string;\n    temperature?: number;\n    maxTokens?: number;\n    timeout?: number;\n    retries?: number;\n}\n\nexport interface Provider {\n    readonly name: string;\n    execute(request: Request, options?: ExecutionOptions): Promise<ProviderResponse>;\n    supportsModel?(model: Model): boolean;\n}\n\n/**\n * Anthropic Provider implementation\n */\nexport class AnthropicProvider implements Provider {\n    readonly name = 'anthropic';\n\n    /**\n     * Check if this provider supports a given model\n     */\n    supportsModel(model: Model): boolean {\n        if (!model) return false;\n        return model.startsWith('claude');\n    }\n\n    /**\n     * Execute a request against Anthropic\n     */\n    async execute(\n        request: Request,\n        options: ExecutionOptions = {}\n    ): Promise<ProviderResponse> {\n        const apiKey = options.apiKey || process.env.ANTHROPIC_API_KEY;\n        \n        if (!apiKey) {\n            throw new Error('Anthropic API key is required. Set ANTHROPIC_API_KEY environment variable.');\n        }\n\n        // Validate key format\n        const validation = redactor.validateKey(apiKey, 'anthropic');\n        if (!validation.valid) {\n            throw new Error('Invalid Anthropic API key format');\n        }\n\n        try {\n            const client = new Anthropic({ apiKey });\n\n            const model = options.model || request.model || 'claude-3-opus-20240229';\n\n            // Anthropic separates system prompt from messages\n            let systemPrompt = '';\n            const messages: Anthropic.MessageParam[] = [];\n\n            for (const msg of request.messages) {\n                if (msg.role === 'system' || msg.role === 'developer') {\n                    systemPrompt +=\n                        (typeof msg.content === 'string'\n                            ? msg.content\n                            : JSON.stringify(msg.content)) + '\\n\\n';\n                } else {\n                    messages.push({\n                        role: msg.role as 'user' | 'assistant',\n                        content:\n                            typeof msg.content === 'string'\n                                ? msg.content\n                                : JSON.stringify(msg.content),\n                    });\n                }\n            }\n\n            const response = await client.messages.create({\n                model: model,\n                system: systemPrompt.trim() || undefined,\n                messages: messages,\n                max_tokens: options.maxTokens || 4096,\n                temperature: options.temperature,\n                ...(request.responseFormat?.type === 'json_schema'\n                    ? {\n                        tools: [\n                            {\n                                name: request.responseFormat.json_schema.name,\n                                description:\n                                      request.responseFormat.json_schema.description ||\n                                      'Output data in this structured format',\n                                input_schema:\n                                      request.responseFormat.json_schema.schema,\n                            },\n                        ],\n                        tool_choice: {\n                            type: 'tool' as const,\n                            name: request.responseFormat.json_schema.name,\n                        },\n                    }\n                    : {}),\n            });\n\n            // Handle ContentBlock\n            let text = '';\n\n            if (request.responseFormat?.type === 'json_schema') {\n                const toolUseBlock = response.content.find(\n                    (block) => block.type === 'tool_use'\n                );\n                if (toolUseBlock && toolUseBlock.type === 'tool_use') {\n                    text = JSON.stringify(toolUseBlock.input, null, 2);\n                }\n            } else {\n                const contentBlock = response.content[0];\n                text = contentBlock.type === 'text' ? contentBlock.text : '';\n            }\n\n            return {\n                content: text,\n                model: response.model,\n                usage: {\n                    inputTokens: response.usage.input_tokens,\n                    outputTokens: response.usage.output_tokens,\n                },\n            };\n        } catch (error) {\n            // Sanitize error to remove any API keys from error messages\n            // Use spotclean for comprehensive error sanitization\n            throw createSafeError(error as Error, { provider: 'anthropic' });\n        }\n    }\n}\n\n/**\n * Create a new Anthropic provider instance\n */\nexport function createAnthropicProvider(): AnthropicProvider {\n    return new AnthropicProvider();\n}\n\n/**\n * Package version\n */\nexport const VERSION = '0.0.1';\n\nexport default AnthropicProvider;\n"],"names":[],"mappings":"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"}