@continum/sdk 0.0.3 → 0.0.5

package/README.md

@@ -2,6 +2,8 @@
 
 > Governed Execution Framework for LLM Applications
 
+**Current Version**: 0.0.4
+
 ## Quick Start
 
 ### Installation
@@ -24,20 +26,77 @@ import { Continum } from '@continum/sdk';
 const continum = new Continum({
   continumKey: process.env.CONTINUM_KEY!,
   apiKeys: {
-    openai: process.env.OPENAI_API_KEY
+    openai: process.env.OPENAI_API_KEY,
+    anthropic: process.env.ANTHROPIC_API_KEY,
+    gemini: process.env.GEMINI_API_KEY
   },
   defaultSandbox: 'pii_protection'
 });
 
-// Make LLM calls with automatic compliance
+// OpenAI - use snake_case model names
 const response = await continum.llm.openai.gpt_4o.chat({
   messages: [{ role: 'user', content: 'Hello world' }]
 });
+
+// Anthropic - use model family names (opus, sonnet, haiku)
+const response2 = await continum.llm.anthropic.opus_4_6.chat({
+  messages: [{ role: 'user', content: 'Review this code' }]
+});
+// Also supports: sonnet_4_6, sonnet_4, haiku_4_5, haiku_3_5, sonnet_3_7
+// Legacy format also works: claude_3_5_sonnet
+
+// Gemini - use snake_case with underscores
+const response3 = await continum.llm.gemini.gemini_2_5_pro.chat({
+  messages: [{ role: 'user', content: 'Summarize this' }]
+});
+
 // ✅ Guardian checks for PII (pre-execution)
 // ✅ User gets response instantly
 // ✅ Shadow Audit runs in background (post-execution)
 ```
 
+## Model Name Format
+
+The SDK uses snake_case model names that get automatically transformed to the correct API format:
+
+### Anthropic Models
+
+```typescript
+// Recommended format - use model family names
+continum.llm.anthropic.opus_4_6.chat()      // → claude-opus-4-6
+continum.llm.anthropic.sonnet_4_6.chat()    // → claude-sonnet-4-6
+continum.llm.anthropic.sonnet_4.chat()      // → claude-sonnet-4-5
+continum.llm.anthropic.haiku_4_5.chat()     // → claude-haiku-4-5-20251001
+continum.llm.anthropic.haiku_3_5.chat()     // → claude-haiku-3-5-20241022
+continum.llm.anthropic.sonnet_3_7.chat()    // → claude-sonnet-3-7-20250219
+
+// Legacy format also supported (v0.0.4+)
+continum.llm.anthropic.claude_3_5_sonnet.chat()  // → claude-3-5-sonnet-20241022
+
+// Alias: claude and anthropic are interchangeable
+continum.llm.claude.opus_4_6.chat()  // Same as anthropic.opus_4_6
+```
+
+### OpenAI Models
+
+```typescript
+continum.llm.openai.gpt_5.chat()       // → gpt-5
+continum.llm.openai.gpt_4o.chat()      // → gpt-4o
+continum.llm.openai.gpt_4_turbo.chat() // → gpt-4-turbo
+continum.llm.openai.o3.chat()          // → o3
+continum.llm.openai.o3_mini.chat()     // → o3-mini
+continum.llm.openai.o1.chat()          // → o1
+```
+
+### Gemini Models
+
+```typescript
+continum.llm.gemini.gemini_2_5_pro.chat()   // → gemini-2.5-pro
+continum.llm.gemini.gemini_2_5_flash.chat() // → gemini-2.5-flash
+continum.llm.gemini.gemini_2_0_flash.chat() // → gemini-2.0-flash
+continum.llm.gemini.gemini_1_5_pro.chat()   // → gemini-1.5-pro
+```
+
 ## Architecture
 
 ### Two-Tier Protection System
@@ -85,8 +144,8 @@ const continum = new Continum({
   apiKeys: { openai: process.env.OPENAI_API_KEY },
   guardianConfig: {
     enabled: true,              // Enable pre-LLM protection
-    blockHighRisk: true,        // Block SSN, credit cards, etc.
-    redactMediumRisk: true,     // Redact emails, phones, etc.
+    action: 'REDACT_AND_CONTINUE', // Guardian action mode
+    // Options: 'BLOCK_ON_DETECT', 'REDACT_AND_CONTINUE', 'ALLOW_ALL'
     localOnly: false,           // Use remote ML for complex cases
     customPatterns: [
       {
@@ -99,6 +158,12 @@ const continum = new Continum({
 });
 ```
 
+#### Guardian Action Modes
+
+- **BLOCK_ON_DETECT**: Block request immediately if any PII is detected
+- **REDACT_AND_CONTINUE**: Redact PII and continue with LLM call (default)
+- **ALLOW_ALL**: Disable Guardian protection (allow everything)
+
 ### Shadow Audit Configuration
 
 ```typescript

package/dist/guardian/guardian.client.js

@@ -54,8 +54,9 @@ class GuardianClient {
             // Tier 1: Fast local pattern matching
             const localResult = this.scanLocalPatterns(request.userInput);
             if (localResult.detectedEntities.length > 0) {
-                // Found PII locally - apply redaction
-                return this.buildGuardianResult(localResult, request);
+                // Found PII locally - apply action based on sandbox config
+                // Note: guardianAction should come from sandbox config in production
+                return this.buildGuardianResult(localResult, request, 'REDACT_AND_CONTINUE');
             }
             // Tier 2: Remote ML scan for complex cases (optional)
             // Only if local scan found nothing but we want deeper analysis
@@ -133,7 +134,7 @@ class GuardianClient {
                 return '****';
         }
     }
-    buildGuardianResult(localResult, request) {
+    buildGuardianResult(localResult, request, guardianAction = 'REDACT_AND_CONTINUE') {
         let cleanPrompt = request.userInput;
         const violations = [];
         const reasoningParts = [];
@@ -143,10 +144,22 @@ class GuardianClient {
             violations.push(`${entity.type}_DETECTED`);
             reasoningParts.push(`${entity.type.toLowerCase()} ${entity.redactedValue} detected`);
         }
-        // Determine action based on entity types
-        const hasHighRiskPII = localResult.detectedEntities.some(e => ['SSN', 'CREDIT_CARD', 'PASSPORT', 'HEALTH_ID'].includes(e.type));
+        // Determine action based on guardianAction configuration
+        let action = 'ALLOW';
+        if (guardianAction === 'ALLOW_ALL') {
+            // Guardian disabled - allow everything
+            action = 'ALLOW';
+        }
+        else if (guardianAction === 'BLOCK_ON_DETECT') {
+            // Block if any PII detected
+            action = 'BLOCK';
+        }
+        else if (guardianAction === 'REDACT_AND_CONTINUE') {
+            // Redact PII and continue with LLM call
+            action = 'REDACT';
+        }
         return {
-            action: hasHighRiskPII ? 'BLOCK' : 'REDACT',
+            action,
             violations,
             reasoning: reasoningParts.join(', '),
             cleanPrompt,

package/dist/proxy/provider.proxy.js

@@ -29,6 +29,7 @@ function resolveModelId(provider, snakeKey) {
             'sonnet-4': 'claude-sonnet-4-5',
             'haiku-3-5': 'claude-haiku-3-5-20241022',
             'sonnet-3-7': 'claude-sonnet-3-7-20250219',
+            'claude-3-5-sonnet': 'claude-3-5-sonnet-20241022',
         };
         return anthropicMap[hyphenated] ?? `claude-${hyphenated}`;
     }

package/dist/types/index.d.ts

@@ -51,6 +51,7 @@ export interface ContinumConfig {
     defaultSandbox?: string;
     guardianConfig?: {
         enabled?: boolean;
+        action?: 'BLOCK_ON_DETECT' | 'REDACT_AND_CONTINUE' | 'ALLOW_ALL';
         blockHighRisk?: boolean;
         redactMediumRisk?: boolean;
         localOnly?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@continum/sdk",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Zero-latency compliance auditing for every LLM call in your application",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",