@vorim/sdk 2.1.0 → 2.3.0

package/dist/index.cjs

@@ -44,6 +44,19 @@ var VorimSDK = class {
     this.baseUrl = (config.baseUrl || "https://api.vorim.ai").replace(/\/$/, "") + "/v1";
     this.timeout = config.timeout || 1e4;
   }
+  // ─── Health Check ────────────────────────────────────────────────
+  /**
+   * Ping the Vorim API to verify connectivity and API key validity.
+   * Returns { status, timestamp } on success, throws VorimError on failure.
+   */
+  async ping() {
+    const response = await fetch(`${this.baseUrl.replace("/v1", "")}/health`, {
+      headers: { "User-Agent": "vorim-sdk/2.1.0" },
+      signal: AbortSignal.timeout(this.timeout)
+    });
+    if (!response.ok) throw new VorimError(response.status, "UNREACHABLE", "Vorim API is not reachable");
+    return response.json();
+  }
   // ─── Agent Identity ────────────────────────────────────────────────
   /**
    * Register a new agent with Vorim AI.

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — TypeScript\n// Thin client wrapping the Vorim AI REST API\n// ============================================================================\n\nimport type {\n  Agent, AgentRegistrationInput, AgentRegistrationResult,\n  TrustRecord, AuditEventInput, PermissionScope, PermissionCheckResult,\n} from './types.js';\n\nexport interface VorimConfig {\n  apiKey: string;\n  baseUrl?: string;\n  timeout?: number;\n}\n\nexport class VorimSDK {\n  private apiKey: string;\n  private baseUrl: string;\n  private timeout: number;\n\n  constructor(config: VorimConfig) {\n    this.apiKey = config.apiKey;\n    this.baseUrl = (config.baseUrl || 'https://api.vorim.ai').replace(/\\/$/, '') + '/v1';\n    this.timeout = config.timeout || 10000;\n  }\n\n  // ─── Agent Identity ────────────────────────────────────────────────\n\n  /**\n   * Register a new agent with Vorim AI.\n   * Returns the agent identity and a private key (shown once).\n   */\n  async register(input: AgentRegistrationInput): Promise<AgentRegistrationResult> {\n    return this.post('/agents', input);\n  }\n\n  /**\n   * Verify an agent's identity via the public Trust API.\n   */\n  async verify(agentId: string): Promise<TrustRecord> {\n    return this.get(`/trust/verify/${agentId}`);\n  }\n\n  /**\n   * Get agent details.\n   */\n  async getAgent(agentId: string): Promise<Agent> {\n    return this.get(`/agents/${agentId}`);\n  }\n\n  /**\n   * List all agents in the organisation.\n   */\n  async listAgents(params?: { page?: number; per_page?: number; status?: string }): Promise<{ agents: Agent[]; meta: any }> {\n    const qs = new URLSearchParams(params as any).toString();\n    return this.get(`/agents${qs ? '?' + qs : ''}`);\n  }\n\n  /**\n   * Update an agent's metadata.\n   */\n  async updateAgent(agentId: string, updates: Partial<Pick<Agent, 'name' | 'description' | 'status' | 'capabilities'>>): Promise<Agent> {\n    return this.patch(`/agents/${agentId}`, updates);\n  }\n\n  /**\n   * Revoke an agent (permanent deactivation).\n   */\n  async revoke(agentId: string): Promise<void> {\n    await this.delete(`/agents/${agentId}`);\n  }\n\n  // ─── Permissions ──────────────────────────────────────────────────\n\n  /**\n   * Check if an agent has a specific permission scope.\n   * Target: < 5ms response via Redis cache.\n   */\n  async check(agentId: string, scope: PermissionScope): Promise<PermissionCheckResult> {\n    return this.post(`/agents/${agentId}/permissions/verify`, { scope });\n  }\n\n  /**\n   * Grant a permission scope to an agent.\n   */\n  async grant(agentId: string, scope: PermissionScope, options?: {\n    valid_until?: string;\n    rate_limit?: { max: number; window: string };\n  }): Promise<any> {\n    return this.post(`/agents/${agentId}/permissions`, { scope, ...options });\n  }\n\n  /**\n   * List all active permissions for an agent.\n   */\n  async listPermissions(agentId: string): Promise<any[]> {\n    return this.get(`/agents/${agentId}/permissions`);\n  }\n\n  /**\n   * Revoke a specific permission scope from an agent.\n   */\n  async revokePermission(agentId: string, scope: PermissionScope): Promise<any> {\n    return this.delete(`/agents/${agentId}/permissions/${scope}`);\n  }\n\n  // ─── Audit ────────────────────────────────────────────────────────\n\n  /**\n   * Emit an audit event for an agent action.\n   */\n  async emit(event: AuditEventInput): Promise<{ ingested: number }> {\n    return this.post('/audit/events', { events: [event] });\n  }\n\n  /**\n   * Emit a batch of audit events (up to 1,000).\n   */\n  async emitBatch(events: AuditEventInput[]): Promise<{ ingested: number }> {\n    return this.post('/audit/events', { events });\n  }\n\n  /**\n   * Export a signed audit bundle for a date range.\n   */\n  async exportAudit(from: string, to: string, format: string = 'json'): Promise<any> {\n    return this.post('/audit/export', { from, to, format });\n  }\n\n  // ─── API Keys ──────────────────────────────────────────────────────\n\n  /**\n   * List all API keys for the organisation.\n   */\n  async listApiKeys(): Promise<any[]> {\n    return this.get('/api-keys');\n  }\n\n  /**\n   * Create a new API key.\n   */\n  async createApiKey(name: string, options?: { scopes?: string[]; expires_at?: string }): Promise<any> {\n    return this.post('/api-keys', { name, ...options });\n  }\n\n  /**\n   * Revoke an API key.\n   */\n  async deleteApiKey(keyId: string): Promise<{ revoked: boolean }> {\n    return this.delete(`/api-keys/${keyId}`);\n  }\n\n  // ─── Signing ──────────────────────────────────────────────────────\n\n  /**\n   * Sign a payload with an Ed25519 private key (client-side).\n   * Uses the Web Crypto API or Node.js crypto.\n   */\n  async sign(payload: string, privateKeyPem: string): Promise<string> {\n    if (typeof globalThis.crypto?.subtle !== 'undefined') {\n      // Web Crypto API\n      const keyData = this.pemToArrayBuffer(privateKeyPem);\n      const key = await globalThis.crypto.subtle.importKey(\n        'pkcs8', keyData, { name: 'Ed25519' }, false, ['sign']\n      );\n      const signature = await globalThis.crypto.subtle.sign(\n        'Ed25519', key, new TextEncoder().encode(payload)\n      );\n      return `ed25519:${this.arrayBufferToBase64(signature)}`;\n    } else {\n      // Node.js crypto fallback\n      const crypto = await import('node:crypto');\n      const sign = crypto.sign(null, Buffer.from(payload), privateKeyPem);\n      return `ed25519:${sign.toString('base64')}`;\n    }\n  }\n\n  // ─── HTTP Client ──────────────────────────────────────────────────\n\n  private async get(path: string): Promise<any> {\n    return this.request('GET', path);\n  }\n\n  private async post(path: string, body: any): Promise<any> {\n    return this.request('POST', path, body);\n  }\n\n  private async patch(path: string, body: any): Promise<any> {\n    return this.request('PATCH', path, body);\n  }\n\n  private async delete(path: string): Promise<any> {\n    return this.request('DELETE', path);\n  }\n\n  private async request(method: string, path: string, body?: any): Promise<any> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(`${this.baseUrl}${path}`, {\n        method,\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n          'User-Agent': 'vorim-sdk/2.0.0',\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        const errBody = await response.json().catch(() => ({})) as Record<string, any>;\n        throw new VorimError(\n          response.status,\n          errBody.error?.code || 'UNKNOWN_ERROR',\n          errBody.error?.message || `HTTP ${response.status}`,\n          errBody.error?.details\n        );\n      }\n\n      const json = await response.json() as Record<string, any>;\n      return json.data;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private pemToArrayBuffer(pem: string): ArrayBuffer {\n    const b64 = pem.replace(/-----[^-]+-----/g, '').replace(/\\s/g, '');\n    const binary = atob(b64);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) {\n      bytes[i] = binary.charCodeAt(i);\n    }\n    return bytes.buffer;\n  }\n\n  private arrayBufferToBase64(buffer: ArrayBuffer): string {\n    const bytes = new Uint8Array(buffer);\n    let binary = '';\n    for (const byte of bytes) {\n      binary += String.fromCharCode(byte);\n    }\n    return btoa(binary);\n  }\n}\n\nexport class VorimError extends Error {\n  constructor(\n    public status: number,\n    public code: string,\n    message: string,\n    public details?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'VorimError';\n  }\n}\n\n// ─── Convenience export ──────────────────────────────────────────────\n\nexport default function createVorim(config: VorimConfig): VorimSDK {\n  return new VorimSDK(config);\n}\n\n// Re-export types for consumers\nexport type {\n  Agent, AgentRegistrationInput, AgentRegistrationResult,\n  TrustRecord, AuditEventInput, AuditEventType, AuditResult,\n  PermissionScope, PermissionCheckResult, AgentStatus,\n} from './types.js';\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — TypeScript\n// Thin client wrapping the Vorim AI REST API\n// ============================================================================\n\nimport type {\n  Agent, AgentRegistrationInput, AgentRegistrationResult,\n  TrustRecord, AuditEventInput, PermissionScope, PermissionCheckResult,\n} from './types.js';\n\nexport interface VorimConfig {\n  apiKey: string;\n  baseUrl?: string;\n  timeout?: number;\n}\n\nexport class VorimSDK {\n  private apiKey: string;\n  private baseUrl: string;\n  private timeout: number;\n\n  constructor(config: VorimConfig) {\n    this.apiKey = config.apiKey;\n    this.baseUrl = (config.baseUrl || 'https://api.vorim.ai').replace(/\\/$/, '') + '/v1';\n    this.timeout = config.timeout || 10000;\n  }\n\n  // ─── Health Check ────────────────────────────────────────────────\n\n  /**\n   * Ping the Vorim API to verify connectivity and API key validity.\n   * Returns { status, timestamp } on success, throws VorimError on failure.\n   */\n  async ping(): Promise<{ status: string; timestamp: string }> {\n    const response = await fetch(`${this.baseUrl.replace('/v1', '')}/health`, {\n      headers: { 'User-Agent': 'vorim-sdk/2.1.0' },\n      signal: AbortSignal.timeout(this.timeout),\n    });\n    if (!response.ok) throw new VorimError(response.status, 'UNREACHABLE', 'Vorim API is not reachable');\n    return response.json() as Promise<{ status: string; timestamp: string }>;\n  }\n\n  // ─── Agent Identity ────────────────────────────────────────────────\n\n  /**\n   * Register a new agent with Vorim AI.\n   * Returns the agent identity and a private key (shown once).\n   */\n  async register(input: AgentRegistrationInput): Promise<AgentRegistrationResult> {\n    return this.post('/agents', input);\n  }\n\n  /**\n   * Verify an agent's identity via the public Trust API.\n   */\n  async verify(agentId: string): Promise<TrustRecord> {\n    return this.get(`/trust/verify/${agentId}`);\n  }\n\n  /**\n   * Get agent details.\n   */\n  async getAgent(agentId: string): Promise<Agent> {\n    return this.get(`/agents/${agentId}`);\n  }\n\n  /**\n   * List all agents in the organisation.\n   */\n  async listAgents(params?: { page?: number; per_page?: number; status?: string }): Promise<{ agents: Agent[]; meta: any }> {\n    const qs = new URLSearchParams(params as any).toString();\n    return this.get(`/agents${qs ? '?' + qs : ''}`);\n  }\n\n  /**\n   * Update an agent's metadata.\n   */\n  async updateAgent(agentId: string, updates: Partial<Pick<Agent, 'name' | 'description' | 'status' | 'capabilities'>>): Promise<Agent> {\n    return this.patch(`/agents/${agentId}`, updates);\n  }\n\n  /**\n   * Revoke an agent (permanent deactivation).\n   */\n  async revoke(agentId: string): Promise<void> {\n    await this.delete(`/agents/${agentId}`);\n  }\n\n  // ─── Permissions ──────────────────────────────────────────────────\n\n  /**\n   * Check if an agent has a specific permission scope.\n   * Target: < 5ms response via Redis cache.\n   */\n  async check(agentId: string, scope: PermissionScope): Promise<PermissionCheckResult> {\n    return this.post(`/agents/${agentId}/permissions/verify`, { scope });\n  }\n\n  /**\n   * Grant a permission scope to an agent.\n   */\n  async grant(agentId: string, scope: PermissionScope, options?: {\n    valid_until?: string;\n    rate_limit?: { max: number; window: string };\n  }): Promise<any> {\n    return this.post(`/agents/${agentId}/permissions`, { scope, ...options });\n  }\n\n  /**\n   * List all active permissions for an agent.\n   */\n  async listPermissions(agentId: string): Promise<any[]> {\n    return this.get(`/agents/${agentId}/permissions`);\n  }\n\n  /**\n   * Revoke a specific permission scope from an agent.\n   */\n  async revokePermission(agentId: string, scope: PermissionScope): Promise<any> {\n    return this.delete(`/agents/${agentId}/permissions/${scope}`);\n  }\n\n  // ─── Audit ────────────────────────────────────────────────────────\n\n  /**\n   * Emit an audit event for an agent action.\n   */\n  async emit(event: AuditEventInput): Promise<{ ingested: number }> {\n    return this.post('/audit/events', { events: [event] });\n  }\n\n  /**\n   * Emit a batch of audit events (up to 1,000).\n   */\n  async emitBatch(events: AuditEventInput[]): Promise<{ ingested: number }> {\n    return this.post('/audit/events', { events });\n  }\n\n  /**\n   * Export a signed audit bundle for a date range.\n   */\n  async exportAudit(from: string, to: string, format: string = 'json'): Promise<any> {\n    return this.post('/audit/export', { from, to, format });\n  }\n\n  // ─── API Keys ──────────────────────────────────────────────────────\n\n  /**\n   * List all API keys for the organisation.\n   */\n  async listApiKeys(): Promise<any[]> {\n    return this.get('/api-keys');\n  }\n\n  /**\n   * Create a new API key.\n   */\n  async createApiKey(name: string, options?: { scopes?: string[]; expires_at?: string }): Promise<any> {\n    return this.post('/api-keys', { name, ...options });\n  }\n\n  /**\n   * Revoke an API key.\n   */\n  async deleteApiKey(keyId: string): Promise<{ revoked: boolean }> {\n    return this.delete(`/api-keys/${keyId}`);\n  }\n\n  // ─── Signing ──────────────────────────────────────────────────────\n\n  /**\n   * Sign a payload with an Ed25519 private key (client-side).\n   * Uses the Web Crypto API or Node.js crypto.\n   */\n  async sign(payload: string, privateKeyPem: string): Promise<string> {\n    if (typeof globalThis.crypto?.subtle !== 'undefined') {\n      // Web Crypto API\n      const keyData = this.pemToArrayBuffer(privateKeyPem);\n      const key = await globalThis.crypto.subtle.importKey(\n        'pkcs8', keyData, { name: 'Ed25519' }, false, ['sign']\n      );\n      const signature = await globalThis.crypto.subtle.sign(\n        'Ed25519', key, new TextEncoder().encode(payload)\n      );\n      return `ed25519:${this.arrayBufferToBase64(signature)}`;\n    } else {\n      // Node.js crypto fallback\n      const crypto = await import('node:crypto');\n      const sign = crypto.sign(null, Buffer.from(payload), privateKeyPem);\n      return `ed25519:${sign.toString('base64')}`;\n    }\n  }\n\n  // ─── HTTP Client ──────────────────────────────────────────────────\n\n  private async get(path: string): Promise<any> {\n    return this.request('GET', path);\n  }\n\n  private async post(path: string, body: any): Promise<any> {\n    return this.request('POST', path, body);\n  }\n\n  private async patch(path: string, body: any): Promise<any> {\n    return this.request('PATCH', path, body);\n  }\n\n  private async delete(path: string): Promise<any> {\n    return this.request('DELETE', path);\n  }\n\n  private async request(method: string, path: string, body?: any): Promise<any> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(`${this.baseUrl}${path}`, {\n        method,\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n          'User-Agent': 'vorim-sdk/2.0.0',\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        const errBody = await response.json().catch(() => ({})) as Record<string, any>;\n        throw new VorimError(\n          response.status,\n          errBody.error?.code || 'UNKNOWN_ERROR',\n          errBody.error?.message || `HTTP ${response.status}`,\n          errBody.error?.details\n        );\n      }\n\n      const json = await response.json() as Record<string, any>;\n      return json.data;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private pemToArrayBuffer(pem: string): ArrayBuffer {\n    const b64 = pem.replace(/-----[^-]+-----/g, '').replace(/\\s/g, '');\n    const binary = atob(b64);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) {\n      bytes[i] = binary.charCodeAt(i);\n    }\n    return bytes.buffer;\n  }\n\n  private arrayBufferToBase64(buffer: ArrayBuffer): string {\n    const bytes = new Uint8Array(buffer);\n    let binary = '';\n    for (const byte of bytes) {\n      binary += String.fromCharCode(byte);\n    }\n    return btoa(binary);\n  }\n}\n\nexport class VorimError extends Error {\n  constructor(\n    public status: number,\n    public code: string,\n    message: string,\n    public details?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'VorimError';\n  }\n}\n\n// ─── Convenience export ──────────────────────────────────────────────\n\nexport default function createVorim(config: VorimConfig): VorimSDK {\n  return new VorimSDK(config);\n}\n\n// Re-export types for consumers\nexport type {\n  Agent, AgentRegistrationInput, AgentRegistrationResult,\n  TrustRecord, AuditEventInput, AuditEventType, AuditResult,\n  PermissionScope, PermissionCheckResult, AgentStatus,\n} from './types.js';\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -78,6 +78,14 @@ declare class VorimSDK {
     private baseUrl;
     private timeout;
     constructor(config: VorimConfig);
+    /**
+     * Ping the Vorim API to verify connectivity and API key validity.
+     * Returns { status, timestamp } on success, throws VorimError on failure.
+     */
+    ping(): Promise<{
+        status: string;
+        timestamp: string;
+    }>;
     /**
      * Register a new agent with Vorim AI.
      * Returns the agent identity and a private key (shown once).

package/dist/index.d.ts

@@ -78,6 +78,14 @@ declare class VorimSDK {
     private baseUrl;
     private timeout;
     constructor(config: VorimConfig);
+    /**
+     * Ping the Vorim API to verify connectivity and API key validity.
+     * Returns { status, timestamp } on success, throws VorimError on failure.
+     */
+    ping(): Promise<{
+        status: string;
+        timestamp: string;
+    }>;
     /**
      * Register a new agent with Vorim AI.
      * Returns the agent identity and a private key (shown once).

package/dist/index.js

@@ -8,6 +8,19 @@ var VorimSDK = class {
     this.baseUrl = (config.baseUrl || "https://api.vorim.ai").replace(/\/$/, "") + "/v1";
     this.timeout = config.timeout || 1e4;
   }
+  // ─── Health Check ────────────────────────────────────────────────
+  /**
+   * Ping the Vorim API to verify connectivity and API key validity.
+   * Returns { status, timestamp } on success, throws VorimError on failure.
+   */
+  async ping() {
+    const response = await fetch(`${this.baseUrl.replace("/v1", "")}/health`, {
+      headers: { "User-Agent": "vorim-sdk/2.1.0" },
+      signal: AbortSignal.timeout(this.timeout)
+    });
+    if (!response.ok) throw new VorimError(response.status, "UNREACHABLE", "Vorim API is not reachable");
+    return response.json();
+  }
   // ─── Agent Identity ────────────────────────────────────────────────
   /**
    * Register a new agent with Vorim AI.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — TypeScript\n// Thin client wrapping the Vorim AI REST API\n// ============================================================================\n\nimport type {\n  Agent, AgentRegistrationInput, AgentRegistrationResult,\n  TrustRecord, AuditEventInput, PermissionScope, PermissionCheckResult,\n} from './types.js';\n\nexport interface VorimConfig {\n  apiKey: string;\n  baseUrl?: string;\n  timeout?: number;\n}\n\nexport class VorimSDK {\n  private apiKey: string;\n  private baseUrl: string;\n  private timeout: number;\n\n  constructor(config: VorimConfig) {\n    this.apiKey = config.apiKey;\n    this.baseUrl = (config.baseUrl || 'https://api.vorim.ai').replace(/\\/$/, '') + '/v1';\n    this.timeout = config.timeout || 10000;\n  }\n\n  // ─── Agent Identity ────────────────────────────────────────────────\n\n  /**\n   * Register a new agent with Vorim AI.\n   * Returns the agent identity and a private key (shown once).\n   */\n  async register(input: AgentRegistrationInput): Promise<AgentRegistrationResult> {\n    return this.post('/agents', input);\n  }\n\n  /**\n   * Verify an agent's identity via the public Trust API.\n   */\n  async verify(agentId: string): Promise<TrustRecord> {\n    return this.get(`/trust/verify/${agentId}`);\n  }\n\n  /**\n   * Get agent details.\n   */\n  async getAgent(agentId: string): Promise<Agent> {\n    return this.get(`/agents/${agentId}`);\n  }\n\n  /**\n   * List all agents in the organisation.\n   */\n  async listAgents(params?: { page?: number; per_page?: number; status?: string }): Promise<{ agents: Agent[]; meta: any }> {\n    const qs = new URLSearchParams(params as any).toString();\n    return this.get(`/agents${qs ? '?' + qs : ''}`);\n  }\n\n  /**\n   * Update an agent's metadata.\n   */\n  async updateAgent(agentId: string, updates: Partial<Pick<Agent, 'name' | 'description' | 'status' | 'capabilities'>>): Promise<Agent> {\n    return this.patch(`/agents/${agentId}`, updates);\n  }\n\n  /**\n   * Revoke an agent (permanent deactivation).\n   */\n  async revoke(agentId: string): Promise<void> {\n    await this.delete(`/agents/${agentId}`);\n  }\n\n  // ─── Permissions ──────────────────────────────────────────────────\n\n  /**\n   * Check if an agent has a specific permission scope.\n   * Target: < 5ms response via Redis cache.\n   */\n  async check(agentId: string, scope: PermissionScope): Promise<PermissionCheckResult> {\n    return this.post(`/agents/${agentId}/permissions/verify`, { scope });\n  }\n\n  /**\n   * Grant a permission scope to an agent.\n   */\n  async grant(agentId: string, scope: PermissionScope, options?: {\n    valid_until?: string;\n    rate_limit?: { max: number; window: string };\n  }): Promise<any> {\n    return this.post(`/agents/${agentId}/permissions`, { scope, ...options });\n  }\n\n  /**\n   * List all active permissions for an agent.\n   */\n  async listPermissions(agentId: string): Promise<any[]> {\n    return this.get(`/agents/${agentId}/permissions`);\n  }\n\n  /**\n   * Revoke a specific permission scope from an agent.\n   */\n  async revokePermission(agentId: string, scope: PermissionScope): Promise<any> {\n    return this.delete(`/agents/${agentId}/permissions/${scope}`);\n  }\n\n  // ─── Audit ────────────────────────────────────────────────────────\n\n  /**\n   * Emit an audit event for an agent action.\n   */\n  async emit(event: AuditEventInput): Promise<{ ingested: number }> {\n    return this.post('/audit/events', { events: [event] });\n  }\n\n  /**\n   * Emit a batch of audit events (up to 1,000).\n   */\n  async emitBatch(events: AuditEventInput[]): Promise<{ ingested: number }> {\n    return this.post('/audit/events', { events });\n  }\n\n  /**\n   * Export a signed audit bundle for a date range.\n   */\n  async exportAudit(from: string, to: string, format: string = 'json'): Promise<any> {\n    return this.post('/audit/export', { from, to, format });\n  }\n\n  // ─── API Keys ──────────────────────────────────────────────────────\n\n  /**\n   * List all API keys for the organisation.\n   */\n  async listApiKeys(): Promise<any[]> {\n    return this.get('/api-keys');\n  }\n\n  /**\n   * Create a new API key.\n   */\n  async createApiKey(name: string, options?: { scopes?: string[]; expires_at?: string }): Promise<any> {\n    return this.post('/api-keys', { name, ...options });\n  }\n\n  /**\n   * Revoke an API key.\n   */\n  async deleteApiKey(keyId: string): Promise<{ revoked: boolean }> {\n    return this.delete(`/api-keys/${keyId}`);\n  }\n\n  // ─── Signing ──────────────────────────────────────────────────────\n\n  /**\n   * Sign a payload with an Ed25519 private key (client-side).\n   * Uses the Web Crypto API or Node.js crypto.\n   */\n  async sign(payload: string, privateKeyPem: string): Promise<string> {\n    if (typeof globalThis.crypto?.subtle !== 'undefined') {\n      // Web Crypto API\n      const keyData = this.pemToArrayBuffer(privateKeyPem);\n      const key = await globalThis.crypto.subtle.importKey(\n        'pkcs8', keyData, { name: 'Ed25519' }, false, ['sign']\n      );\n      const signature = await globalThis.crypto.subtle.sign(\n        'Ed25519', key, new TextEncoder().encode(payload)\n      );\n      return `ed25519:${this.arrayBufferToBase64(signature)}`;\n    } else {\n      // Node.js crypto fallback\n      const crypto = await import('node:crypto');\n      const sign = crypto.sign(null, Buffer.from(payload), privateKeyPem);\n      return `ed25519:${sign.toString('base64')}`;\n    }\n  }\n\n  // ─── HTTP Client ──────────────────────────────────────────────────\n\n  private async get(path: string): Promise<any> {\n    return this.request('GET', path);\n  }\n\n  private async post(path: string, body: any): Promise<any> {\n    return this.request('POST', path, body);\n  }\n\n  private async patch(path: string, body: any): Promise<any> {\n    return this.request('PATCH', path, body);\n  }\n\n  private async delete(path: string): Promise<any> {\n    return this.request('DELETE', path);\n  }\n\n  private async request(method: string, path: string, body?: any): Promise<any> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(`${this.baseUrl}${path}`, {\n        method,\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n          'User-Agent': 'vorim-sdk/2.0.0',\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        const errBody = await response.json().catch(() => ({})) as Record<string, any>;\n        throw new VorimError(\n          response.status,\n          errBody.error?.code || 'UNKNOWN_ERROR',\n          errBody.error?.message || `HTTP ${response.status}`,\n          errBody.error?.details\n        );\n      }\n\n      const json = await response.json() as Record<string, any>;\n      return json.data;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private pemToArrayBuffer(pem: string): ArrayBuffer {\n    const b64 = pem.replace(/-----[^-]+-----/g, '').replace(/\\s/g, '');\n    const binary = atob(b64);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) {\n      bytes[i] = binary.charCodeAt(i);\n    }\n    return bytes.buffer;\n  }\n\n  private arrayBufferToBase64(buffer: ArrayBuffer): string {\n    const bytes = new Uint8Array(buffer);\n    let binary = '';\n    for (const byte of bytes) {\n      binary += String.fromCharCode(byte);\n    }\n    return btoa(binary);\n  }\n}\n\nexport class VorimError extends Error {\n  constructor(\n    public status: number,\n    public code: string,\n    message: string,\n    public details?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'VorimError';\n  }\n}\n\n// ─── Convenience export ──────────────────────────────────────────────\n\nexport default function createVorim(config: VorimConfig): VorimSDK {\n  return new VorimSDK(config);\n}\n\n// Re-export types for consumers\nexport type {\n  Agent, AgentRegistrationInput, AgentRegistrationResult,\n  TrustRecord, AuditEventInput, AuditEventType, AuditResult,\n  PermissionScope, PermissionCheckResult, AgentStatus,\n} from './types.js';\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — TypeScript\n// Thin client wrapping the Vorim AI REST API\n// ============================================================================\n\nimport type {\n  Agent, AgentRegistrationInput, AgentRegistrationResult,\n  TrustRecord, AuditEventInput, PermissionScope, PermissionCheckResult,\n} from './types.js';\n\nexport interface VorimConfig {\n  apiKey: string;\n  baseUrl?: string;\n  timeout?: number;\n}\n\nexport class VorimSDK {\n  private apiKey: string;\n  private baseUrl: string;\n  private timeout: number;\n\n  constructor(config: VorimConfig) {\n    this.apiKey = config.apiKey;\n    this.baseUrl = (config.baseUrl || 'https://api.vorim.ai').replace(/\\/$/, '') + '/v1';\n    this.timeout = config.timeout || 10000;\n  }\n\n  // ─── Health Check ────────────────────────────────────────────────\n\n  /**\n   * Ping the Vorim API to verify connectivity and API key validity.\n   * Returns { status, timestamp } on success, throws VorimError on failure.\n   */\n  async ping(): Promise<{ status: string; timestamp: string }> {\n    const response = await fetch(`${this.baseUrl.replace('/v1', '')}/health`, {\n      headers: { 'User-Agent': 'vorim-sdk/2.1.0' },\n      signal: AbortSignal.timeout(this.timeout),\n    });\n    if (!response.ok) throw new VorimError(response.status, 'UNREACHABLE', 'Vorim API is not reachable');\n    return response.json() as Promise<{ status: string; timestamp: string }>;\n  }\n\n  // ─── Agent Identity ────────────────────────────────────────────────\n\n  /**\n   * Register a new agent with Vorim AI.\n   * Returns the agent identity and a private key (shown once).\n   */\n  async register(input: AgentRegistrationInput): Promise<AgentRegistrationResult> {\n    return this.post('/agents', input);\n  }\n\n  /**\n   * Verify an agent's identity via the public Trust API.\n   */\n  async verify(agentId: string): Promise<TrustRecord> {\n    return this.get(`/trust/verify/${agentId}`);\n  }\n\n  /**\n   * Get agent details.\n   */\n  async getAgent(agentId: string): Promise<Agent> {\n    return this.get(`/agents/${agentId}`);\n  }\n\n  /**\n   * List all agents in the organisation.\n   */\n  async listAgents(params?: { page?: number; per_page?: number; status?: string }): Promise<{ agents: Agent[]; meta: any }> {\n    const qs = new URLSearchParams(params as any).toString();\n    return this.get(`/agents${qs ? '?' + qs : ''}`);\n  }\n\n  /**\n   * Update an agent's metadata.\n   */\n  async updateAgent(agentId: string, updates: Partial<Pick<Agent, 'name' | 'description' | 'status' | 'capabilities'>>): Promise<Agent> {\n    return this.patch(`/agents/${agentId}`, updates);\n  }\n\n  /**\n   * Revoke an agent (permanent deactivation).\n   */\n  async revoke(agentId: string): Promise<void> {\n    await this.delete(`/agents/${agentId}`);\n  }\n\n  // ─── Permissions ──────────────────────────────────────────────────\n\n  /**\n   * Check if an agent has a specific permission scope.\n   * Target: < 5ms response via Redis cache.\n   */\n  async check(agentId: string, scope: PermissionScope): Promise<PermissionCheckResult> {\n    return this.post(`/agents/${agentId}/permissions/verify`, { scope });\n  }\n\n  /**\n   * Grant a permission scope to an agent.\n   */\n  async grant(agentId: string, scope: PermissionScope, options?: {\n    valid_until?: string;\n    rate_limit?: { max: number; window: string };\n  }): Promise<any> {\n    return this.post(`/agents/${agentId}/permissions`, { scope, ...options });\n  }\n\n  /**\n   * List all active permissions for an agent.\n   */\n  async listPermissions(agentId: string): Promise<any[]> {\n    return this.get(`/agents/${agentId}/permissions`);\n  }\n\n  /**\n   * Revoke a specific permission scope from an agent.\n   */\n  async revokePermission(agentId: string, scope: PermissionScope): Promise<any> {\n    return this.delete(`/agents/${agentId}/permissions/${scope}`);\n  }\n\n  // ─── Audit ────────────────────────────────────────────────────────\n\n  /**\n   * Emit an audit event for an agent action.\n   */\n  async emit(event: AuditEventInput): Promise<{ ingested: number }> {\n    return this.post('/audit/events', { events: [event] });\n  }\n\n  /**\n   * Emit a batch of audit events (up to 1,000).\n   */\n  async emitBatch(events: AuditEventInput[]): Promise<{ ingested: number }> {\n    return this.post('/audit/events', { events });\n  }\n\n  /**\n   * Export a signed audit bundle for a date range.\n   */\n  async exportAudit(from: string, to: string, format: string = 'json'): Promise<any> {\n    return this.post('/audit/export', { from, to, format });\n  }\n\n  // ─── API Keys ──────────────────────────────────────────────────────\n\n  /**\n   * List all API keys for the organisation.\n   */\n  async listApiKeys(): Promise<any[]> {\n    return this.get('/api-keys');\n  }\n\n  /**\n   * Create a new API key.\n   */\n  async createApiKey(name: string, options?: { scopes?: string[]; expires_at?: string }): Promise<any> {\n    return this.post('/api-keys', { name, ...options });\n  }\n\n  /**\n   * Revoke an API key.\n   */\n  async deleteApiKey(keyId: string): Promise<{ revoked: boolean }> {\n    return this.delete(`/api-keys/${keyId}`);\n  }\n\n  // ─── Signing ──────────────────────────────────────────────────────\n\n  /**\n   * Sign a payload with an Ed25519 private key (client-side).\n   * Uses the Web Crypto API or Node.js crypto.\n   */\n  async sign(payload: string, privateKeyPem: string): Promise<string> {\n    if (typeof globalThis.crypto?.subtle !== 'undefined') {\n      // Web Crypto API\n      const keyData = this.pemToArrayBuffer(privateKeyPem);\n      const key = await globalThis.crypto.subtle.importKey(\n        'pkcs8', keyData, { name: 'Ed25519' }, false, ['sign']\n      );\n      const signature = await globalThis.crypto.subtle.sign(\n        'Ed25519', key, new TextEncoder().encode(payload)\n      );\n      return `ed25519:${this.arrayBufferToBase64(signature)}`;\n    } else {\n      // Node.js crypto fallback\n      const crypto = await import('node:crypto');\n      const sign = crypto.sign(null, Buffer.from(payload), privateKeyPem);\n      return `ed25519:${sign.toString('base64')}`;\n    }\n  }\n\n  // ─── HTTP Client ──────────────────────────────────────────────────\n\n  private async get(path: string): Promise<any> {\n    return this.request('GET', path);\n  }\n\n  private async post(path: string, body: any): Promise<any> {\n    return this.request('POST', path, body);\n  }\n\n  private async patch(path: string, body: any): Promise<any> {\n    return this.request('PATCH', path, body);\n  }\n\n  private async delete(path: string): Promise<any> {\n    return this.request('DELETE', path);\n  }\n\n  private async request(method: string, path: string, body?: any): Promise<any> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(`${this.baseUrl}${path}`, {\n        method,\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n          'User-Agent': 'vorim-sdk/2.0.0',\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        const errBody = await response.json().catch(() => ({})) as Record<string, any>;\n        throw new VorimError(\n          response.status,\n          errBody.error?.code || 'UNKNOWN_ERROR',\n          errBody.error?.message || `HTTP ${response.status}`,\n          errBody.error?.details\n        );\n      }\n\n      const json = await response.json() as Record<string, any>;\n      return json.data;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private pemToArrayBuffer(pem: string): ArrayBuffer {\n    const b64 = pem.replace(/-----[^-]+-----/g, '').replace(/\\s/g, '');\n    const binary = atob(b64);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) {\n      bytes[i] = binary.charCodeAt(i);\n    }\n    return bytes.buffer;\n  }\n\n  private arrayBufferToBase64(buffer: ArrayBuffer): string {\n    const bytes = new Uint8Array(buffer);\n    let binary = '';\n    for (const byte of bytes) {\n      binary += String.fromCharCode(byte);\n    }\n    return btoa(binary);\n  }\n}\n\nexport class VorimError extends Error {\n  constructor(\n    public status: number,\n    public code: string,\n    message: string,\n    public details?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'VorimError';\n  }\n}\n\n// ─── Convenience export ──────────────────────────────────────────────\n\nexport default function createVorim(config: VorimConfig): VorimSDK {\n  return new VorimSDK(config);\n}\n\n// Re-export types for consumers\nexport type {\n  Agent, AgentRegistrationInput, AgentRegistrationResult,\n  TrustRecord, AuditEventInput, AuditEventType, AuditResult,\n  PermissionScope, PermissionCheckResult, AgentStatus,\n} from './types.js';\n"],"mappings":"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","names":[]}

package/dist/integrations/anthropic.cjs

@@ -0,0 +1,199 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/integrations/anthropic.ts
+var anthropic_exports = {};
+__export(anthropic_exports, {
+  VorimToolRegistry: () => VorimToolRegistry,
+  createVorimClaudeAgent: () => createVorimClaudeAgent,
+  runAgentLoop: () => runAgentLoop
+});
+module.exports = __toCommonJS(anthropic_exports);
+var VorimToolRegistry = class {
+  vorim;
+  agentId;
+  defaultPermission;
+  asyncAudit;
+  tools = /* @__PURE__ */ new Map();
+  constructor(config) {
+    this.vorim = config.vorim;
+    this.agentId = config.agentId;
+    this.defaultPermission = config.defaultPermission ?? "agent:execute";
+    this.asyncAudit = config.asyncAudit ?? true;
+  }
+  /** Register a tool. */
+  add(definition) {
+    this.tools.set(definition.name, definition);
+    return this;
+  }
+  /** Register multiple tools. */
+  addAll(definitions) {
+    for (const def of definitions) this.add(def);
+    return this;
+  }
+  /** Convert registered tools to Anthropic's tool format. */
+  toAnthropicTools() {
+    return [...this.tools.values()].map((t) => ({
+      name: t.name,
+      description: t.description,
+      input_schema: t.input_schema
+    }));
+  }
+  /**
+   * Execute tool_use blocks from a Claude message response.
+   * Each call is checked against Vorim permissions and audited.
+   * Returns an array of tool_result blocks ready to send back to Claude.
+   */
+  async executeToolUseBlocks(toolUseBlocks) {
+    return Promise.all(
+      toolUseBlocks.map((block) => this.executeSingleBlock(block))
+    );
+  }
+  async executeSingleBlock(block) {
+    const definition = this.tools.get(block.name);
+    if (!definition) {
+      return {
+        type: "tool_result",
+        tool_use_id: block.id,
+        content: JSON.stringify({ error: `Unknown tool: ${block.name}` }),
+        is_error: true
+      };
+    }
+    const scope = definition.permission ?? this.defaultPermission;
+    const { allowed, reason } = await this.vorim.check(this.agentId, scope);
+    if (!allowed) {
+      const event = {
+        agent_id: this.agentId,
+        event_type: "tool_call",
+        action: block.name,
+        resource: truncate(JSON.stringify(block.input), 500),
+        permission: scope,
+        result: "denied",
+        metadata: { reason, framework: "anthropic" }
+      };
+      this.emitAudit(event);
+      return {
+        type: "tool_result",
+        tool_use_id: block.id,
+        content: JSON.stringify({ error: `Permission denied: ${scope}${reason ? ` \u2014 ${reason}` : ""}` }),
+        is_error: true
+      };
+    }
+    const start = Date.now();
+    try {
+      const result = await definition.execute(block.input);
+      const content = typeof result === "string" ? result : JSON.stringify(result);
+      const event = {
+        agent_id: this.agentId,
+        event_type: "tool_call",
+        action: block.name,
+        resource: truncate(JSON.stringify(block.input), 500),
+        permission: scope,
+        result: "success",
+        latency_ms: Date.now() - start,
+        metadata: { framework: "anthropic" }
+      };
+      this.emitAudit(event);
+      return { type: "tool_result", tool_use_id: block.id, content };
+    } catch (err) {
+      const errMsg = err instanceof Error ? err.message : String(err);
+      const event = {
+        agent_id: this.agentId,
+        event_type: "tool_call",
+        action: block.name,
+        resource: truncate(JSON.stringify(block.input), 500),
+        permission: scope,
+        result: "error",
+        latency_ms: Date.now() - start,
+        error_code: err instanceof Error ? err.name : "UNKNOWN",
+        metadata: { error: errMsg, framework: "anthropic" }
+      };
+      this.emitAudit(event);
+      return {
+        type: "tool_result",
+        tool_use_id: block.id,
+        content: JSON.stringify({ error: errMsg }),
+        is_error: true
+      };
+    }
+  }
+  emitAudit(event) {
+    this.vorim.emit(event).catch(() => {
+    });
+  }
+};
+async function runAgentLoop(config) {
+  const {
+    anthropic,
+    model = "claude-sonnet-4-20250514",
+    systemPrompt,
+    maxIterations = 10,
+    maxTokens = 1024,
+    registry,
+    userMessage
+  } = config;
+  const tools = registry.toAnthropicTools();
+  const messages = [{ role: "user", content: userMessage }];
+  for (let i = 0; i < maxIterations; i++) {
+    const response = await anthropic.messages.create({
+      model,
+      max_tokens: maxTokens,
+      ...systemPrompt ? { system: systemPrompt } : {},
+      messages,
+      ...tools.length > 0 ? { tools } : {}
+    });
+    if (response.stop_reason === "end_turn" || response.stop_reason !== "tool_use") {
+      const textBlocks = response.content.filter((b) => b.type === "text");
+      return textBlocks.map((b) => b.text).join("") || "";
+    }
+    const toolUseBlocks = response.content.filter((b) => b.type === "tool_use");
+    const toolResults = await registry.executeToolUseBlocks(toolUseBlocks);
+    messages.push({ role: "assistant", content: response.content });
+    messages.push({ role: "user", content: toolResults });
+  }
+  return "";
+}
+async function createVorimClaudeAgent(config) {
+  const { vorim, name, description, capabilities, scopes, tools } = config;
+  const registration = await vorim.register({
+    name,
+    description,
+    capabilities,
+    scopes
+  });
+  const agentId = registration.agent.agent_id;
+  const registry = new VorimToolRegistry({ vorim, agentId });
+  registry.addAll(tools);
+  return {
+    agentId,
+    registration,
+    registry,
+    privateKey: registration.private_key
+  };
+}
+function truncate(str, max) {
+  return str.length > max ? str.slice(0, max) + "\u2026" : str;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VorimToolRegistry,
+  createVorimClaudeAgent,
+  runAgentLoop
+});
+//# sourceMappingURL=anthropic.cjs.map

package/dist/integrations/anthropic.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/integrations/anthropic.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — Anthropic/Claude Integration\n// Wraps Anthropic tool use with Vorim permission checks, audit trails,\n// and agent identity. Works with the Anthropic Node.js SDK (messages API\n// with tool use).\n//\n// Peer dependency: @anthropic-ai/sdk >=0.30.0\n// ============================================================================\n\nimport type { VorimSDK } from '../index.js';\nimport type { PermissionScope, AuditEventInput } from '../types.js';\n\n// ─── Re-declared Anthropic types (peer dependency — not bundled) ──────────\n\ninterface AnthropicTool {\n  name: string;\n  description: string;\n  input_schema: Record<string, unknown>;\n}\n\ninterface ToolUseBlock {\n  type: 'tool_use';\n  id: string;\n  name: string;\n  input: Record<string, unknown>;\n}\n\ninterface ToolResultBlock {\n  type: 'tool_result';\n  tool_use_id: string;\n  content: string;\n  is_error?: boolean;\n}\n\n// ─── Configuration ────────────────────────────────────────────────────────\n\nexport interface VorimToolDefinition<TArgs = Record<string, unknown>, TResult = unknown> {\n  /** Tool name (must match the tool name sent to Claude). */\n  name: string;\n  /** Description shown to Claude. */\n  description: string;\n  /** JSON Schema for the tool's input. */\n  input_schema: Record<string, unknown>;\n  /** The function to execute when the tool is called. */\n  execute: (args: TArgs) => Promise<TResult>;\n  /** Vorim permission scope required. @default 'agent:execute' */\n  permission?: PermissionScope;\n}\n\nexport interface VorimAnthropicConfig {\n  /** Vorim SDK instance. */\n  vorim: VorimSDK;\n  /** The Vorim agent_id. */\n  agentId: string;\n  /** Default permission scope for tools without an explicit one. @default 'agent:execute' */\n  defaultPermission?: PermissionScope;\n  /** Whether to emit audit events asynchronously (fire-and-forget). @default true */\n  asyncAudit?: boolean;\n}\n\n// ─── Tool Registry ────────────────────────────────────────────────────────\n\n/**\n * Manages a set of tools with Vorim permission checks and audit logging.\n * Converts tools to Anthropic's tool format and handles execution of\n * tool_use blocks from Claude's response.\n *\n * @example\n * ```ts\n * import Anthropic from \"@anthropic-ai/sdk\";\n * import createVorim from \"@vorim/sdk\";\n * import { VorimToolRegistry } from \"@vorim/sdk/integrations/anthropic\";\n *\n * const vorim = createVorim({ apiKey: \"agid_sk_live_...\" });\n * const anthropic = new Anthropic();\n *\n * const registry = new VorimToolRegistry({\n *   vorim,\n *   agentId: \"agid_acme_a1b2c3d4\",\n * });\n *\n * registry.add({\n *   name: \"search_docs\",\n *   description: \"Search internal documents\",\n *   input_schema: {\n *     type: \"object\",\n *     properties: { query: { type: \"string\" } },\n *     required: [\"query\"],\n *   },\n *   execute: async ({ query }) => searchDocs(query),\n *   permission: \"agent:read\",\n * });\n *\n * const response = await anthropic.messages.create({\n *   model: \"claude-sonnet-4-20250514\",\n *   max_tokens: 1024,\n *   messages,\n *   tools: registry.toAnthropicTools(),\n * });\n *\n * // Execute tool_use blocks from response\n * const toolResults = await registry.executeToolUseBlocks(\n *   response.content.filter(b => b.type === \"tool_use\")\n * );\n * ```\n */\nexport class VorimToolRegistry {\n  private vorim: VorimSDK;\n  private agentId: string;\n  private defaultPermission: PermissionScope;\n  private asyncAudit: boolean;\n  private tools = new Map<string, VorimToolDefinition>();\n\n  constructor(config: VorimAnthropicConfig) {\n    this.vorim = config.vorim;\n    this.agentId = config.agentId;\n    this.defaultPermission = config.defaultPermission ?? 'agent:execute';\n    this.asyncAudit = config.asyncAudit ?? true;\n  }\n\n  /** Register a tool. */\n  add<TArgs, TResult>(definition: VorimToolDefinition<TArgs, TResult>): this {\n    this.tools.set(definition.name, definition as VorimToolDefinition);\n    return this;\n  }\n\n  /** Register multiple tools. */\n  addAll(definitions: VorimToolDefinition[]): this {\n    for (const def of definitions) this.add(def);\n    return this;\n  }\n\n  /** Convert registered tools to Anthropic's tool format. */\n  toAnthropicTools(): AnthropicTool[] {\n    return [...this.tools.values()].map(t => ({\n      name: t.name,\n      description: t.description,\n      input_schema: t.input_schema,\n    }));\n  }\n\n  /**\n   * Execute tool_use blocks from a Claude message response.\n   * Each call is checked against Vorim permissions and audited.\n   * Returns an array of tool_result blocks ready to send back to Claude.\n   */\n  async executeToolUseBlocks(toolUseBlocks: ToolUseBlock[]): Promise<ToolResultBlock[]> {\n    return Promise.all(\n      toolUseBlocks.map(block => this.executeSingleBlock(block)),\n    );\n  }\n\n  private async executeSingleBlock(block: ToolUseBlock): Promise<ToolResultBlock> {\n    const definition = this.tools.get(block.name);\n\n    if (!definition) {\n      return {\n        type: 'tool_result',\n        tool_use_id: block.id,\n        content: JSON.stringify({ error: `Unknown tool: ${block.name}` }),\n        is_error: true,\n      };\n    }\n\n    const scope = definition.permission ?? this.defaultPermission;\n\n    // 1. Permission check\n    const { allowed, reason } = await this.vorim.check(this.agentId, scope);\n\n    if (!allowed) {\n      const event: AuditEventInput = {\n        agent_id: this.agentId,\n        event_type: 'tool_call',\n        action: block.name,\n        resource: truncate(JSON.stringify(block.input), 500),\n        permission: scope,\n        result: 'denied',\n        metadata: { reason, framework: 'anthropic' },\n      };\n      this.emitAudit(event);\n\n      return {\n        type: 'tool_result',\n        tool_use_id: block.id,\n        content: JSON.stringify({ error: `Permission denied: ${scope}${reason ? ` — ${reason}` : ''}` }),\n        is_error: true,\n      };\n    }\n\n    // 2. Execute\n    const start = Date.now();\n    try {\n      const result = await definition.execute(block.input as any);\n      const content = typeof result === 'string' ? result : JSON.stringify(result);\n\n      const event: AuditEventInput = {\n        agent_id: this.agentId,\n        event_type: 'tool_call',\n        action: block.name,\n        resource: truncate(JSON.stringify(block.input), 500),\n        permission: scope,\n        result: 'success',\n        latency_ms: Date.now() - start,\n        metadata: { framework: 'anthropic' },\n      };\n      this.emitAudit(event);\n\n      return { type: 'tool_result', tool_use_id: block.id, content };\n    } catch (err) {\n      const errMsg = err instanceof Error ? err.message : String(err);\n\n      const event: AuditEventInput = {\n        agent_id: this.agentId,\n        event_type: 'tool_call',\n        action: block.name,\n        resource: truncate(JSON.stringify(block.input), 500),\n        permission: scope,\n        result: 'error',\n        latency_ms: Date.now() - start,\n        error_code: err instanceof Error ? err.name : 'UNKNOWN',\n        metadata: { error: errMsg, framework: 'anthropic' },\n      };\n      this.emitAudit(event);\n\n      return {\n        type: 'tool_result',\n        tool_use_id: block.id,\n        content: JSON.stringify({ error: errMsg }),\n        is_error: true,\n      };\n    }\n  }\n\n  private emitAudit(event: AuditEventInput): void {\n    this.vorim.emit(event).catch(() => {});\n  }\n}\n\n// ─── Agent Loop ───────────────────────────────────────────────────────────\n\n/** Minimal Anthropic client interface (avoids importing the full SDK). */\ninterface AnthropicClient {\n  messages: {\n    create(params: any): Promise<any>;\n  };\n}\n\nexport interface VorimAgentLoopConfig extends VorimAnthropicConfig {\n  /** Anthropic client instance. */\n  anthropic: AnthropicClient;\n  /** Model to use. @default 'claude-sonnet-4-20250514' */\n  model?: string;\n  /** System prompt for the agent. */\n  systemPrompt?: string;\n  /** Maximum tool-use iterations before stopping. @default 10 */\n  maxIterations?: number;\n  /** Max tokens per response. @default 1024 */\n  maxTokens?: number;\n}\n\n/**\n * Runs a complete agent loop with Claude tool use, Vorim\n * permission enforcement, and audit logging.\n *\n * @example\n * ```ts\n * import Anthropic from \"@anthropic-ai/sdk\";\n * import createVorim from \"@vorim/sdk\";\n * import { runAgentLoop, VorimToolRegistry } from \"@vorim/sdk/integrations/anthropic\";\n *\n * const registry = new VorimToolRegistry({ vorim, agentId });\n * registry.add({ name: \"search\", ... });\n *\n * const response = await runAgentLoop({\n *   vorim,\n *   agentId,\n *   anthropic: new Anthropic(),\n *   model: \"claude-sonnet-4-20250514\",\n *   systemPrompt: \"You are a helpful assistant.\",\n *   registry,\n *   userMessage: \"Find docs about onboarding\",\n * });\n * ```\n */\nexport async function runAgentLoop(\n  config: VorimAgentLoopConfig & {\n    registry: VorimToolRegistry;\n    userMessage: string;\n  },\n): Promise<string> {\n  const {\n    anthropic,\n    model = 'claude-sonnet-4-20250514',\n    systemPrompt,\n    maxIterations = 10,\n    maxTokens = 1024,\n    registry,\n    userMessage,\n  } = config;\n\n  const tools = registry.toAnthropicTools();\n  const messages: any[] = [{ role: 'user', content: userMessage }];\n\n  for (let i = 0; i < maxIterations; i++) {\n    const response = await anthropic.messages.create({\n      model,\n      max_tokens: maxTokens,\n      ...(systemPrompt ? { system: systemPrompt } : {}),\n      messages,\n      ...(tools.length > 0 ? { tools } : {}),\n    });\n\n    // If stop_reason is \"end_turn\" — Claude is done\n    if (response.stop_reason === 'end_turn' || response.stop_reason !== 'tool_use') {\n      const textBlocks = response.content.filter((b: any) => b.type === 'text');\n      return textBlocks.map((b: any) => b.text).join('') || '';\n    }\n\n    // Extract tool_use blocks and execute\n    const toolUseBlocks = response.content.filter((b: any) => b.type === 'tool_use');\n    const toolResults = await registry.executeToolUseBlocks(toolUseBlocks);\n\n    // Append assistant response and tool results to conversation\n    messages.push({ role: 'assistant', content: response.content });\n    messages.push({ role: 'user', content: toolResults });\n  }\n\n  return '';\n}\n\n// ─── Agent Registration Helper ───────────────────────────────────────────\n\n/**\n * Registers a new agent with Vorim and returns a ready-to-use tool registry\n * configured for Anthropic/Claude.\n *\n * @example\n * ```ts\n * const { agentId, registry } = await createVorimClaudeAgent({\n *   vorim,\n *   name: \"claude-assistant\",\n *   capabilities: [\"search\", \"calculate\"],\n *   scopes: [\"agent:read\", \"agent:execute\"],\n *   tools: [searchTool, calcTool],\n * });\n * ```\n */\nexport async function createVorimClaudeAgent(config: {\n  vorim: VorimSDK;\n  name: string;\n  description?: string;\n  capabilities: string[];\n  scopes: PermissionScope[];\n  tools: VorimToolDefinition[];\n}) {\n  const { vorim, name, description, capabilities, scopes, tools } = config;\n\n  const registration = await vorim.register({\n    name,\n    description,\n    capabilities,\n    scopes,\n  });\n\n  const agentId = registration.agent.agent_id;\n  const registry = new VorimToolRegistry({ vorim, agentId });\n  registry.addAll(tools);\n\n  return {\n    agentId,\n    registration,\n    registry,\n    privateKey: registration.private_key,\n  };\n}\n\n// ─── Helpers ──────────────────────────────────────────────────────────────\n\nfunction truncate(str: string, max: number): string {\n  return str.length > max ? str.slice(0, max) + '…' : str;\n}\n"],"mappings":"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","names":[]}

package/dist/integrations/anthropic.d.cts

@@ -0,0 +1,183 @@
+import { VorimSDK, PermissionScope, AgentRegistrationResult } from '../index.cjs';
+
+interface AnthropicTool {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+interface ToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+interface ToolResultBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+interface VorimToolDefinition<TArgs = Record<string, unknown>, TResult = unknown> {
+    /** Tool name (must match the tool name sent to Claude). */
+    name: string;
+    /** Description shown to Claude. */
+    description: string;
+    /** JSON Schema for the tool's input. */
+    input_schema: Record<string, unknown>;
+    /** The function to execute when the tool is called. */
+    execute: (args: TArgs) => Promise<TResult>;
+    /** Vorim permission scope required. @default 'agent:execute' */
+    permission?: PermissionScope;
+}
+interface VorimAnthropicConfig {
+    /** Vorim SDK instance. */
+    vorim: VorimSDK;
+    /** The Vorim agent_id. */
+    agentId: string;
+    /** Default permission scope for tools without an explicit one. @default 'agent:execute' */
+    defaultPermission?: PermissionScope;
+    /** Whether to emit audit events asynchronously (fire-and-forget). @default true */
+    asyncAudit?: boolean;
+}
+/**
+ * Manages a set of tools with Vorim permission checks and audit logging.
+ * Converts tools to Anthropic's tool format and handles execution of
+ * tool_use blocks from Claude's response.
+ *
+ * @example
+ * ```ts
+ * import Anthropic from "@anthropic-ai/sdk";
+ * import createVorim from "@vorim/sdk";
+ * import { VorimToolRegistry } from "@vorim/sdk/integrations/anthropic";
+ *
+ * const vorim = createVorim({ apiKey: "agid_sk_live_..." });
+ * const anthropic = new Anthropic();
+ *
+ * const registry = new VorimToolRegistry({
+ *   vorim,
+ *   agentId: "agid_acme_a1b2c3d4",
+ * });
+ *
+ * registry.add({
+ *   name: "search_docs",
+ *   description: "Search internal documents",
+ *   input_schema: {
+ *     type: "object",
+ *     properties: { query: { type: "string" } },
+ *     required: ["query"],
+ *   },
+ *   execute: async ({ query }) => searchDocs(query),
+ *   permission: "agent:read",
+ * });
+ *
+ * const response = await anthropic.messages.create({
+ *   model: "claude-sonnet-4-20250514",
+ *   max_tokens: 1024,
+ *   messages,
+ *   tools: registry.toAnthropicTools(),
+ * });
+ *
+ * // Execute tool_use blocks from response
+ * const toolResults = await registry.executeToolUseBlocks(
+ *   response.content.filter(b => b.type === "tool_use")
+ * );
+ * ```
+ */
+declare class VorimToolRegistry {
+    private vorim;
+    private agentId;
+    private defaultPermission;
+    private asyncAudit;
+    private tools;
+    constructor(config: VorimAnthropicConfig);
+    /** Register a tool. */
+    add<TArgs, TResult>(definition: VorimToolDefinition<TArgs, TResult>): this;
+    /** Register multiple tools. */
+    addAll(definitions: VorimToolDefinition[]): this;
+    /** Convert registered tools to Anthropic's tool format. */
+    toAnthropicTools(): AnthropicTool[];
+    /**
+     * Execute tool_use blocks from a Claude message response.
+     * Each call is checked against Vorim permissions and audited.
+     * Returns an array of tool_result blocks ready to send back to Claude.
+     */
+    executeToolUseBlocks(toolUseBlocks: ToolUseBlock[]): Promise<ToolResultBlock[]>;
+    private executeSingleBlock;
+    private emitAudit;
+}
+/** Minimal Anthropic client interface (avoids importing the full SDK). */
+interface AnthropicClient {
+    messages: {
+        create(params: any): Promise<any>;
+    };
+}
+interface VorimAgentLoopConfig extends VorimAnthropicConfig {
+    /** Anthropic client instance. */
+    anthropic: AnthropicClient;
+    /** Model to use. @default 'claude-sonnet-4-20250514' */
+    model?: string;
+    /** System prompt for the agent. */
+    systemPrompt?: string;
+    /** Maximum tool-use iterations before stopping. @default 10 */
+    maxIterations?: number;
+    /** Max tokens per response. @default 1024 */
+    maxTokens?: number;
+}
+/**
+ * Runs a complete agent loop with Claude tool use, Vorim
+ * permission enforcement, and audit logging.
+ *
+ * @example
+ * ```ts
+ * import Anthropic from "@anthropic-ai/sdk";
+ * import createVorim from "@vorim/sdk";
+ * import { runAgentLoop, VorimToolRegistry } from "@vorim/sdk/integrations/anthropic";
+ *
+ * const registry = new VorimToolRegistry({ vorim, agentId });
+ * registry.add({ name: "search", ... });
+ *
+ * const response = await runAgentLoop({
+ *   vorim,
+ *   agentId,
+ *   anthropic: new Anthropic(),
+ *   model: "claude-sonnet-4-20250514",
+ *   systemPrompt: "You are a helpful assistant.",
+ *   registry,
+ *   userMessage: "Find docs about onboarding",
+ * });
+ * ```
+ */
+declare function runAgentLoop(config: VorimAgentLoopConfig & {
+    registry: VorimToolRegistry;
+    userMessage: string;
+}): Promise<string>;
+/**
+ * Registers a new agent with Vorim and returns a ready-to-use tool registry
+ * configured for Anthropic/Claude.
+ *
+ * @example
+ * ```ts
+ * const { agentId, registry } = await createVorimClaudeAgent({
+ *   vorim,
+ *   name: "claude-assistant",
+ *   capabilities: ["search", "calculate"],
+ *   scopes: ["agent:read", "agent:execute"],
+ *   tools: [searchTool, calcTool],
+ * });
+ * ```
+ */
+declare function createVorimClaudeAgent(config: {
+    vorim: VorimSDK;
+    name: string;
+    description?: string;
+    capabilities: string[];
+    scopes: PermissionScope[];
+    tools: VorimToolDefinition[];
+}): Promise<{
+    agentId: string;
+    registration: AgentRegistrationResult;
+    registry: VorimToolRegistry;
+    privateKey: string;
+}>;
+
+export { type VorimAgentLoopConfig, type VorimAnthropicConfig, type VorimToolDefinition, VorimToolRegistry, createVorimClaudeAgent, runAgentLoop };

package/dist/integrations/anthropic.d.ts

@@ -0,0 +1,183 @@
+import { VorimSDK, PermissionScope, AgentRegistrationResult } from '../index.js';
+
+interface AnthropicTool {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+interface ToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+interface ToolResultBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+interface VorimToolDefinition<TArgs = Record<string, unknown>, TResult = unknown> {
+    /** Tool name (must match the tool name sent to Claude). */
+    name: string;
+    /** Description shown to Claude. */
+    description: string;
+    /** JSON Schema for the tool's input. */
+    input_schema: Record<string, unknown>;
+    /** The function to execute when the tool is called. */
+    execute: (args: TArgs) => Promise<TResult>;
+    /** Vorim permission scope required. @default 'agent:execute' */
+    permission?: PermissionScope;
+}
+interface VorimAnthropicConfig {
+    /** Vorim SDK instance. */
+    vorim: VorimSDK;
+    /** The Vorim agent_id. */
+    agentId: string;
+    /** Default permission scope for tools without an explicit one. @default 'agent:execute' */
+    defaultPermission?: PermissionScope;
+    /** Whether to emit audit events asynchronously (fire-and-forget). @default true */
+    asyncAudit?: boolean;
+}
+/**
+ * Manages a set of tools with Vorim permission checks and audit logging.
+ * Converts tools to Anthropic's tool format and handles execution of
+ * tool_use blocks from Claude's response.
+ *
+ * @example
+ * ```ts
+ * import Anthropic from "@anthropic-ai/sdk";
+ * import createVorim from "@vorim/sdk";
+ * import { VorimToolRegistry } from "@vorim/sdk/integrations/anthropic";
+ *
+ * const vorim = createVorim({ apiKey: "agid_sk_live_..." });
+ * const anthropic = new Anthropic();
+ *
+ * const registry = new VorimToolRegistry({
+ *   vorim,
+ *   agentId: "agid_acme_a1b2c3d4",
+ * });
+ *
+ * registry.add({
+ *   name: "search_docs",
+ *   description: "Search internal documents",
+ *   input_schema: {
+ *     type: "object",
+ *     properties: { query: { type: "string" } },
+ *     required: ["query"],
+ *   },
+ *   execute: async ({ query }) => searchDocs(query),
+ *   permission: "agent:read",
+ * });
+ *
+ * const response = await anthropic.messages.create({
+ *   model: "claude-sonnet-4-20250514",
+ *   max_tokens: 1024,
+ *   messages,
+ *   tools: registry.toAnthropicTools(),
+ * });
+ *
+ * // Execute tool_use blocks from response
+ * const toolResults = await registry.executeToolUseBlocks(
+ *   response.content.filter(b => b.type === "tool_use")
+ * );
+ * ```
+ */
+declare class VorimToolRegistry {
+    private vorim;
+    private agentId;
+    private defaultPermission;
+    private asyncAudit;
+    private tools;
+    constructor(config: VorimAnthropicConfig);
+    /** Register a tool. */
+    add<TArgs, TResult>(definition: VorimToolDefinition<TArgs, TResult>): this;
+    /** Register multiple tools. */
+    addAll(definitions: VorimToolDefinition[]): this;
+    /** Convert registered tools to Anthropic's tool format. */
+    toAnthropicTools(): AnthropicTool[];
+    /**
+     * Execute tool_use blocks from a Claude message response.
+     * Each call is checked against Vorim permissions and audited.
+     * Returns an array of tool_result blocks ready to send back to Claude.
+     */
+    executeToolUseBlocks(toolUseBlocks: ToolUseBlock[]): Promise<ToolResultBlock[]>;
+    private executeSingleBlock;
+    private emitAudit;
+}
+/** Minimal Anthropic client interface (avoids importing the full SDK). */
+interface AnthropicClient {
+    messages: {
+        create(params: any): Promise<any>;
+    };
+}
+interface VorimAgentLoopConfig extends VorimAnthropicConfig {
+    /** Anthropic client instance. */
+    anthropic: AnthropicClient;
+    /** Model to use. @default 'claude-sonnet-4-20250514' */
+    model?: string;
+    /** System prompt for the agent. */
+    systemPrompt?: string;
+    /** Maximum tool-use iterations before stopping. @default 10 */
+    maxIterations?: number;
+    /** Max tokens per response. @default 1024 */
+    maxTokens?: number;
+}
+/**
+ * Runs a complete agent loop with Claude tool use, Vorim
+ * permission enforcement, and audit logging.
+ *
+ * @example
+ * ```ts
+ * import Anthropic from "@anthropic-ai/sdk";
+ * import createVorim from "@vorim/sdk";
+ * import { runAgentLoop, VorimToolRegistry } from "@vorim/sdk/integrations/anthropic";
+ *
+ * const registry = new VorimToolRegistry({ vorim, agentId });
+ * registry.add({ name: "search", ... });
+ *
+ * const response = await runAgentLoop({
+ *   vorim,
+ *   agentId,
+ *   anthropic: new Anthropic(),
+ *   model: "claude-sonnet-4-20250514",
+ *   systemPrompt: "You are a helpful assistant.",
+ *   registry,
+ *   userMessage: "Find docs about onboarding",
+ * });
+ * ```
+ */
+declare function runAgentLoop(config: VorimAgentLoopConfig & {
+    registry: VorimToolRegistry;
+    userMessage: string;
+}): Promise<string>;
+/**
+ * Registers a new agent with Vorim and returns a ready-to-use tool registry
+ * configured for Anthropic/Claude.
+ *
+ * @example
+ * ```ts
+ * const { agentId, registry } = await createVorimClaudeAgent({
+ *   vorim,
+ *   name: "claude-assistant",
+ *   capabilities: ["search", "calculate"],
+ *   scopes: ["agent:read", "agent:execute"],
+ *   tools: [searchTool, calcTool],
+ * });
+ * ```
+ */
+declare function createVorimClaudeAgent(config: {
+    vorim: VorimSDK;
+    name: string;
+    description?: string;
+    capabilities: string[];
+    scopes: PermissionScope[];
+    tools: VorimToolDefinition[];
+}): Promise<{
+    agentId: string;
+    registration: AgentRegistrationResult;
+    registry: VorimToolRegistry;
+    privateKey: string;
+}>;
+
+export { type VorimAgentLoopConfig, type VorimAnthropicConfig, type VorimToolDefinition, VorimToolRegistry, createVorimClaudeAgent, runAgentLoop };

package/dist/integrations/anthropic.js

@@ -0,0 +1,172 @@
+// src/integrations/anthropic.ts
+var VorimToolRegistry = class {
+  vorim;
+  agentId;
+  defaultPermission;
+  asyncAudit;
+  tools = /* @__PURE__ */ new Map();
+  constructor(config) {
+    this.vorim = config.vorim;
+    this.agentId = config.agentId;
+    this.defaultPermission = config.defaultPermission ?? "agent:execute";
+    this.asyncAudit = config.asyncAudit ?? true;
+  }
+  /** Register a tool. */
+  add(definition) {
+    this.tools.set(definition.name, definition);
+    return this;
+  }
+  /** Register multiple tools. */
+  addAll(definitions) {
+    for (const def of definitions) this.add(def);
+    return this;
+  }
+  /** Convert registered tools to Anthropic's tool format. */
+  toAnthropicTools() {
+    return [...this.tools.values()].map((t) => ({
+      name: t.name,
+      description: t.description,
+      input_schema: t.input_schema
+    }));
+  }
+  /**
+   * Execute tool_use blocks from a Claude message response.
+   * Each call is checked against Vorim permissions and audited.
+   * Returns an array of tool_result blocks ready to send back to Claude.
+   */
+  async executeToolUseBlocks(toolUseBlocks) {
+    return Promise.all(
+      toolUseBlocks.map((block) => this.executeSingleBlock(block))
+    );
+  }
+  async executeSingleBlock(block) {
+    const definition = this.tools.get(block.name);
+    if (!definition) {
+      return {
+        type: "tool_result",
+        tool_use_id: block.id,
+        content: JSON.stringify({ error: `Unknown tool: ${block.name}` }),
+        is_error: true
+      };
+    }
+    const scope = definition.permission ?? this.defaultPermission;
+    const { allowed, reason } = await this.vorim.check(this.agentId, scope);
+    if (!allowed) {
+      const event = {
+        agent_id: this.agentId,
+        event_type: "tool_call",
+        action: block.name,
+        resource: truncate(JSON.stringify(block.input), 500),
+        permission: scope,
+        result: "denied",
+        metadata: { reason, framework: "anthropic" }
+      };
+      this.emitAudit(event);
+      return {
+        type: "tool_result",
+        tool_use_id: block.id,
+        content: JSON.stringify({ error: `Permission denied: ${scope}${reason ? ` \u2014 ${reason}` : ""}` }),
+        is_error: true
+      };
+    }
+    const start = Date.now();
+    try {
+      const result = await definition.execute(block.input);
+      const content = typeof result === "string" ? result : JSON.stringify(result);
+      const event = {
+        agent_id: this.agentId,
+        event_type: "tool_call",
+        action: block.name,
+        resource: truncate(JSON.stringify(block.input), 500),
+        permission: scope,
+        result: "success",
+        latency_ms: Date.now() - start,
+        metadata: { framework: "anthropic" }
+      };
+      this.emitAudit(event);
+      return { type: "tool_result", tool_use_id: block.id, content };
+    } catch (err) {
+      const errMsg = err instanceof Error ? err.message : String(err);
+      const event = {
+        agent_id: this.agentId,
+        event_type: "tool_call",
+        action: block.name,
+        resource: truncate(JSON.stringify(block.input), 500),
+        permission: scope,
+        result: "error",
+        latency_ms: Date.now() - start,
+        error_code: err instanceof Error ? err.name : "UNKNOWN",
+        metadata: { error: errMsg, framework: "anthropic" }
+      };
+      this.emitAudit(event);
+      return {
+        type: "tool_result",
+        tool_use_id: block.id,
+        content: JSON.stringify({ error: errMsg }),
+        is_error: true
+      };
+    }
+  }
+  emitAudit(event) {
+    this.vorim.emit(event).catch(() => {
+    });
+  }
+};
+async function runAgentLoop(config) {
+  const {
+    anthropic,
+    model = "claude-sonnet-4-20250514",
+    systemPrompt,
+    maxIterations = 10,
+    maxTokens = 1024,
+    registry,
+    userMessage
+  } = config;
+  const tools = registry.toAnthropicTools();
+  const messages = [{ role: "user", content: userMessage }];
+  for (let i = 0; i < maxIterations; i++) {
+    const response = await anthropic.messages.create({
+      model,
+      max_tokens: maxTokens,
+      ...systemPrompt ? { system: systemPrompt } : {},
+      messages,
+      ...tools.length > 0 ? { tools } : {}
+    });
+    if (response.stop_reason === "end_turn" || response.stop_reason !== "tool_use") {
+      const textBlocks = response.content.filter((b) => b.type === "text");
+      return textBlocks.map((b) => b.text).join("") || "";
+    }
+    const toolUseBlocks = response.content.filter((b) => b.type === "tool_use");
+    const toolResults = await registry.executeToolUseBlocks(toolUseBlocks);
+    messages.push({ role: "assistant", content: response.content });
+    messages.push({ role: "user", content: toolResults });
+  }
+  return "";
+}
+async function createVorimClaudeAgent(config) {
+  const { vorim, name, description, capabilities, scopes, tools } = config;
+  const registration = await vorim.register({
+    name,
+    description,
+    capabilities,
+    scopes
+  });
+  const agentId = registration.agent.agent_id;
+  const registry = new VorimToolRegistry({ vorim, agentId });
+  registry.addAll(tools);
+  return {
+    agentId,
+    registration,
+    registry,
+    privateKey: registration.private_key
+  };
+}
+function truncate(str, max) {
+  return str.length > max ? str.slice(0, max) + "\u2026" : str;
+}
+export {
+  VorimToolRegistry,
+  createVorimClaudeAgent,
+  runAgentLoop
+};
+//# sourceMappingURL=anthropic.js.map

package/dist/integrations/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/integrations/anthropic.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — Anthropic/Claude Integration\n// Wraps Anthropic tool use with Vorim permission checks, audit trails,\n// and agent identity. Works with the Anthropic Node.js SDK (messages API\n// with tool use).\n//\n// Peer dependency: @anthropic-ai/sdk >=0.30.0\n// ============================================================================\n\nimport type { VorimSDK } from '../index.js';\nimport type { PermissionScope, AuditEventInput } from '../types.js';\n\n// ─── Re-declared Anthropic types (peer dependency — not bundled) ──────────\n\ninterface AnthropicTool {\n  name: string;\n  description: string;\n  input_schema: Record<string, unknown>;\n}\n\ninterface ToolUseBlock {\n  type: 'tool_use';\n  id: string;\n  name: string;\n  input: Record<string, unknown>;\n}\n\ninterface ToolResultBlock {\n  type: 'tool_result';\n  tool_use_id: string;\n  content: string;\n  is_error?: boolean;\n}\n\n// ─── Configuration ────────────────────────────────────────────────────────\n\nexport interface VorimToolDefinition<TArgs = Record<string, unknown>, TResult = unknown> {\n  /** Tool name (must match the tool name sent to Claude). */\n  name: string;\n  /** Description shown to Claude. */\n  description: string;\n  /** JSON Schema for the tool's input. */\n  input_schema: Record<string, unknown>;\n  /** The function to execute when the tool is called. */\n  execute: (args: TArgs) => Promise<TResult>;\n  /** Vorim permission scope required. @default 'agent:execute' */\n  permission?: PermissionScope;\n}\n\nexport interface VorimAnthropicConfig {\n  /** Vorim SDK instance. */\n  vorim: VorimSDK;\n  /** The Vorim agent_id. */\n  agentId: string;\n  /** Default permission scope for tools without an explicit one. @default 'agent:execute' */\n  defaultPermission?: PermissionScope;\n  /** Whether to emit audit events asynchronously (fire-and-forget). @default true */\n  asyncAudit?: boolean;\n}\n\n// ─── Tool Registry ────────────────────────────────────────────────────────\n\n/**\n * Manages a set of tools with Vorim permission checks and audit logging.\n * Converts tools to Anthropic's tool format and handles execution of\n * tool_use blocks from Claude's response.\n *\n * @example\n * ```ts\n * import Anthropic from \"@anthropic-ai/sdk\";\n * import createVorim from \"@vorim/sdk\";\n * import { VorimToolRegistry } from \"@vorim/sdk/integrations/anthropic\";\n *\n * const vorim = createVorim({ apiKey: \"agid_sk_live_...\" });\n * const anthropic = new Anthropic();\n *\n * const registry = new VorimToolRegistry({\n *   vorim,\n *   agentId: \"agid_acme_a1b2c3d4\",\n * });\n *\n * registry.add({\n *   name: \"search_docs\",\n *   description: \"Search internal documents\",\n *   input_schema: {\n *     type: \"object\",\n *     properties: { query: { type: \"string\" } },\n *     required: [\"query\"],\n *   },\n *   execute: async ({ query }) => searchDocs(query),\n *   permission: \"agent:read\",\n * });\n *\n * const response = await anthropic.messages.create({\n *   model: \"claude-sonnet-4-20250514\",\n *   max_tokens: 1024,\n *   messages,\n *   tools: registry.toAnthropicTools(),\n * });\n *\n * // Execute tool_use blocks from response\n * const toolResults = await registry.executeToolUseBlocks(\n *   response.content.filter(b => b.type === \"tool_use\")\n * );\n * ```\n */\nexport class VorimToolRegistry {\n  private vorim: VorimSDK;\n  private agentId: string;\n  private defaultPermission: PermissionScope;\n  private asyncAudit: boolean;\n  private tools = new Map<string, VorimToolDefinition>();\n\n  constructor(config: VorimAnthropicConfig) {\n    this.vorim = config.vorim;\n    this.agentId = config.agentId;\n    this.defaultPermission = config.defaultPermission ?? 'agent:execute';\n    this.asyncAudit = config.asyncAudit ?? true;\n  }\n\n  /** Register a tool. */\n  add<TArgs, TResult>(definition: VorimToolDefinition<TArgs, TResult>): this {\n    this.tools.set(definition.name, definition as VorimToolDefinition);\n    return this;\n  }\n\n  /** Register multiple tools. */\n  addAll(definitions: VorimToolDefinition[]): this {\n    for (const def of definitions) this.add(def);\n    return this;\n  }\n\n  /** Convert registered tools to Anthropic's tool format. */\n  toAnthropicTools(): AnthropicTool[] {\n    return [...this.tools.values()].map(t => ({\n      name: t.name,\n      description: t.description,\n      input_schema: t.input_schema,\n    }));\n  }\n\n  /**\n   * Execute tool_use blocks from a Claude message response.\n   * Each call is checked against Vorim permissions and audited.\n   * Returns an array of tool_result blocks ready to send back to Claude.\n   */\n  async executeToolUseBlocks(toolUseBlocks: ToolUseBlock[]): Promise<ToolResultBlock[]> {\n    return Promise.all(\n      toolUseBlocks.map(block => this.executeSingleBlock(block)),\n    );\n  }\n\n  private async executeSingleBlock(block: ToolUseBlock): Promise<ToolResultBlock> {\n    const definition = this.tools.get(block.name);\n\n    if (!definition) {\n      return {\n        type: 'tool_result',\n        tool_use_id: block.id,\n        content: JSON.stringify({ error: `Unknown tool: ${block.name}` }),\n        is_error: true,\n      };\n    }\n\n    const scope = definition.permission ?? this.defaultPermission;\n\n    // 1. Permission check\n    const { allowed, reason } = await this.vorim.check(this.agentId, scope);\n\n    if (!allowed) {\n      const event: AuditEventInput = {\n        agent_id: this.agentId,\n        event_type: 'tool_call',\n        action: block.name,\n        resource: truncate(JSON.stringify(block.input), 500),\n        permission: scope,\n        result: 'denied',\n        metadata: { reason, framework: 'anthropic' },\n      };\n      this.emitAudit(event);\n\n      return {\n        type: 'tool_result',\n        tool_use_id: block.id,\n        content: JSON.stringify({ error: `Permission denied: ${scope}${reason ? ` — ${reason}` : ''}` }),\n        is_error: true,\n      };\n    }\n\n    // 2. Execute\n    const start = Date.now();\n    try {\n      const result = await definition.execute(block.input as any);\n      const content = typeof result === 'string' ? result : JSON.stringify(result);\n\n      const event: AuditEventInput = {\n        agent_id: this.agentId,\n        event_type: 'tool_call',\n        action: block.name,\n        resource: truncate(JSON.stringify(block.input), 500),\n        permission: scope,\n        result: 'success',\n        latency_ms: Date.now() - start,\n        metadata: { framework: 'anthropic' },\n      };\n      this.emitAudit(event);\n\n      return { type: 'tool_result', tool_use_id: block.id, content };\n    } catch (err) {\n      const errMsg = err instanceof Error ? err.message : String(err);\n\n      const event: AuditEventInput = {\n        agent_id: this.agentId,\n        event_type: 'tool_call',\n        action: block.name,\n        resource: truncate(JSON.stringify(block.input), 500),\n        permission: scope,\n        result: 'error',\n        latency_ms: Date.now() - start,\n        error_code: err instanceof Error ? err.name : 'UNKNOWN',\n        metadata: { error: errMsg, framework: 'anthropic' },\n      };\n      this.emitAudit(event);\n\n      return {\n        type: 'tool_result',\n        tool_use_id: block.id,\n        content: JSON.stringify({ error: errMsg }),\n        is_error: true,\n      };\n    }\n  }\n\n  private emitAudit(event: AuditEventInput): void {\n    this.vorim.emit(event).catch(() => {});\n  }\n}\n\n// ─── Agent Loop ───────────────────────────────────────────────────────────\n\n/** Minimal Anthropic client interface (avoids importing the full SDK). */\ninterface AnthropicClient {\n  messages: {\n    create(params: any): Promise<any>;\n  };\n}\n\nexport interface VorimAgentLoopConfig extends VorimAnthropicConfig {\n  /** Anthropic client instance. */\n  anthropic: AnthropicClient;\n  /** Model to use. @default 'claude-sonnet-4-20250514' */\n  model?: string;\n  /** System prompt for the agent. */\n  systemPrompt?: string;\n  /** Maximum tool-use iterations before stopping. @default 10 */\n  maxIterations?: number;\n  /** Max tokens per response. @default 1024 */\n  maxTokens?: number;\n}\n\n/**\n * Runs a complete agent loop with Claude tool use, Vorim\n * permission enforcement, and audit logging.\n *\n * @example\n * ```ts\n * import Anthropic from \"@anthropic-ai/sdk\";\n * import createVorim from \"@vorim/sdk\";\n * import { runAgentLoop, VorimToolRegistry } from \"@vorim/sdk/integrations/anthropic\";\n *\n * const registry = new VorimToolRegistry({ vorim, agentId });\n * registry.add({ name: \"search\", ... });\n *\n * const response = await runAgentLoop({\n *   vorim,\n *   agentId,\n *   anthropic: new Anthropic(),\n *   model: \"claude-sonnet-4-20250514\",\n *   systemPrompt: \"You are a helpful assistant.\",\n *   registry,\n *   userMessage: \"Find docs about onboarding\",\n * });\n * ```\n */\nexport async function runAgentLoop(\n  config: VorimAgentLoopConfig & {\n    registry: VorimToolRegistry;\n    userMessage: string;\n  },\n): Promise<string> {\n  const {\n    anthropic,\n    model = 'claude-sonnet-4-20250514',\n    systemPrompt,\n    maxIterations = 10,\n    maxTokens = 1024,\n    registry,\n    userMessage,\n  } = config;\n\n  const tools = registry.toAnthropicTools();\n  const messages: any[] = [{ role: 'user', content: userMessage }];\n\n  for (let i = 0; i < maxIterations; i++) {\n    const response = await anthropic.messages.create({\n      model,\n      max_tokens: maxTokens,\n      ...(systemPrompt ? { system: systemPrompt } : {}),\n      messages,\n      ...(tools.length > 0 ? { tools } : {}),\n    });\n\n    // If stop_reason is \"end_turn\" — Claude is done\n    if (response.stop_reason === 'end_turn' || response.stop_reason !== 'tool_use') {\n      const textBlocks = response.content.filter((b: any) => b.type === 'text');\n      return textBlocks.map((b: any) => b.text).join('') || '';\n    }\n\n    // Extract tool_use blocks and execute\n    const toolUseBlocks = response.content.filter((b: any) => b.type === 'tool_use');\n    const toolResults = await registry.executeToolUseBlocks(toolUseBlocks);\n\n    // Append assistant response and tool results to conversation\n    messages.push({ role: 'assistant', content: response.content });\n    messages.push({ role: 'user', content: toolResults });\n  }\n\n  return '';\n}\n\n// ─── Agent Registration Helper ───────────────────────────────────────────\n\n/**\n * Registers a new agent with Vorim and returns a ready-to-use tool registry\n * configured for Anthropic/Claude.\n *\n * @example\n * ```ts\n * const { agentId, registry } = await createVorimClaudeAgent({\n *   vorim,\n *   name: \"claude-assistant\",\n *   capabilities: [\"search\", \"calculate\"],\n *   scopes: [\"agent:read\", \"agent:execute\"],\n *   tools: [searchTool, calcTool],\n * });\n * ```\n */\nexport async function createVorimClaudeAgent(config: {\n  vorim: VorimSDK;\n  name: string;\n  description?: string;\n  capabilities: string[];\n  scopes: PermissionScope[];\n  tools: VorimToolDefinition[];\n}) {\n  const { vorim, name, description, capabilities, scopes, tools } = config;\n\n  const registration = await vorim.register({\n    name,\n    description,\n    capabilities,\n    scopes,\n  });\n\n  const agentId = registration.agent.agent_id;\n  const registry = new VorimToolRegistry({ vorim, agentId });\n  registry.addAll(tools);\n\n  return {\n    agentId,\n    registration,\n    registry,\n    privateKey: registration.private_key,\n  };\n}\n\n// ─── Helpers ──────────────────────────────────────────────────────────────\n\nfunction truncate(str: string, max: number): string {\n  return str.length > max ? str.slice(0, max) + '…' : str;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vorim/sdk",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Official TypeScript SDK for Vorim AI — AI Agent Identity, Permissions & Audit",
   "type": "module",
   "main": "dist/index.cjs",
@@ -56,6 +56,16 @@
         "types": "./dist/integrations/llamaindex.d.cts",
         "default": "./dist/integrations/llamaindex.cjs"
       }
+    },
+    "./integrations/anthropic": {
+      "import": {
+        "types": "./dist/integrations/anthropic.d.ts",
+        "default": "./dist/integrations/anthropic.js"
+      },
+      "require": {
+        "types": "./dist/integrations/anthropic.d.cts",
+        "default": "./dist/integrations/anthropic.cjs"
+      }
     }
   },
   "files": [