@vorim/sdk 3.1.0 → 3.3.0

package/dist/integrations/crewai.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/integrations/crewai.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — CrewAI Integration\n// CrewAI is Python-only, so this module provides:\n//   1. A TypeScript helper for managing CrewAI agent identities via Vorim\n//   2. Audit utilities for logging crew task execution\n//   3. A \"crew manifest\" pattern for registering entire crews at once\n//\n// Use this from a TypeScript orchestration layer that triggers CrewAI\n// runs via REST, CLI, or subprocess. For native Python integration,\n// use the Vorim REST API directly (see docs).\n//\n// No peer dependencies required — uses @vorim/sdk only.\n// ============================================================================\n\nimport type { VorimSDK } from '../index.js';\nimport type {\n  PermissionScope, AuditEventInput, AgentRegistrationResult,\n} from '../types.js';\n\n// ─── Crew Configuration ──────────────────────────────────────────────────\n\nexport interface CrewMemberConfig {\n  /** Unique role name within the crew (e.g. \"researcher\", \"writer\"). */\n  role: string;\n  /** Display name for the Vorim agent. */\n  name: string;\n  /** Description of this crew member's responsibilities. */\n  description?: string;\n  /** Tools this agent can use (e.g. [\"web_search\", \"file_read\"]). */\n  capabilities: string[];\n  /** Permission scopes to grant. */\n  scopes: PermissionScope[];\n  /** Whether this agent can delegate to other crew members. */\n  allowDelegation?: boolean;\n}\n\nexport interface CrewManifest {\n  /** Name for the overall crew. */\n  crewName: string;\n  /** Members of the crew. */\n  members: CrewMemberConfig[];\n  /** Optional metadata for the crew. */\n  metadata?: Record<string, unknown>;\n}\n\nexport interface RegisteredCrewMember {\n  role: string;\n  agentId: string;\n  registration: AgentRegistrationResult;\n  privateKey: string;\n}\n\nexport interface RegisteredCrew {\n  crewName: string;\n  members: RegisteredCrewMember[];\n  /** Lookup a member by role. */\n  getMember(role: string): RegisteredCrewMember | undefined;\n  /** Get all agent IDs in the crew. */\n  agentIds(): string[];\n}\n\n// ─── Crew Registration ──────────────────────────────────────────────────\n\n/**\n * Registers an entire CrewAI crew with Vorim. Each crew member gets a\n * unique Vorim agent identity with Ed25519 keypair and scoped permissions.\n *\n * @example\n * ```ts\n * import createVorim from \"@vorim/sdk\";\n * import { registerCrew } from \"@vorim/sdk/integrations/crewai\";\n *\n * const vorim = createVorim({ apiKey: \"agid_sk_live_...\" });\n *\n * const crew = await registerCrew(vorim, {\n *   crewName: \"content-pipeline\",\n *   members: [\n *     {\n *       role: \"researcher\",\n *       name: \"crew-researcher\",\n *       capabilities: [\"web_search\", \"summarization\"],\n *       scopes: [\"agent:read\", \"agent:execute\"],\n *     },\n *     {\n *       role: \"writer\",\n *       name: \"crew-writer\",\n *       capabilities: [\"file_write\", \"formatting\"],\n *       scopes: [\"agent:read\", \"agent:write\"],\n *     },\n *     {\n *       role: \"editor\",\n *       name: \"crew-editor\",\n *       capabilities: [\"review\", \"approval\"],\n *       scopes: [\"agent:read\", \"agent:write\"],\n *       allowDelegation: true,\n *     },\n *   ],\n * });\n *\n * // Access individual members\n * const researcher = crew.getMember(\"researcher\");\n * console.log(researcher.agentId); // agid_acme_...\n *\n * // Grant delegation permission to editor\n * // (done automatically if allowDelegation is true)\n * ```\n */\nexport async function registerCrew(\n  vorim: VorimSDK,\n  manifest: CrewManifest,\n): Promise<RegisteredCrew> {\n  const members: RegisteredCrewMember[] = [];\n\n  for (const member of manifest.members) {\n    const scopes = [...member.scopes];\n\n    // Auto-add delegate scope if delegation is allowed\n    if (member.allowDelegation && !scopes.includes('agent:delegate')) {\n      scopes.push('agent:delegate');\n    }\n\n    const registration = await vorim.register({\n      name: member.name,\n      description: member.description ?? `CrewAI ${member.role} — ${manifest.crewName}`,\n      capabilities: member.capabilities,\n      scopes,\n    });\n\n    members.push({\n      role: member.role,\n      agentId: registration.agent.agent_id,\n      registration,\n      privateKey: registration.private_key,\n    });\n  }\n\n  return {\n    crewName: manifest.crewName,\n    members,\n    getMember(role: string) {\n      return members.find(m => m.role === role);\n    },\n    agentIds() {\n      return members.map(m => m.agentId);\n    },\n  };\n}\n\n// ─── Task Audit ──────────────────────────────────────────────────────────\n\nexport interface CrewTaskEvent {\n  /** The role of the crew member performing the task. */\n  role: string;\n  /** The Vorim agent_id (looked up from the crew). */\n  agentId: string;\n  /** Task description or name. */\n  task: string;\n  /** Tool used (if any). */\n  tool?: string;\n  /** Result of the action. */\n  result: 'success' | 'denied' | 'error';\n  /** Duration in milliseconds. */\n  latencyMs?: number;\n  /** Error details if result is 'error'. */\n  error?: string;\n  /** Whether this was a delegation to another crew member. */\n  delegatedTo?: string;\n  /** Additional context. */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Emits a Vorim audit event for a CrewAI task execution.\n * Call this from your orchestration layer after each CrewAI step completes.\n *\n * @example\n * ```ts\n * import { emitCrewTaskEvent } from \"@vorim/sdk/integrations/crewai\";\n *\n * // After a CrewAI task completes\n * await emitCrewTaskEvent(vorim, {\n *   role: \"researcher\",\n *   agentId: crew.getMember(\"researcher\").agentId,\n *   task: \"research_competitors\",\n *   tool: \"web_search\",\n *   result: \"success\",\n *   latencyMs: 3200,\n * });\n * ```\n */\nexport async function emitCrewTaskEvent(\n  vorim: VorimSDK,\n  event: CrewTaskEvent,\n): Promise<void> {\n  const auditEvent: AuditEventInput = {\n    agent_id: event.agentId,\n    event_type: event.tool ? 'tool_call' : 'api_request',\n    action: event.task,\n    resource: event.tool,\n    result: event.result,\n    latency_ms: event.latencyMs,\n    error_code: event.error ? 'CREW_TASK_ERROR' : undefined,\n    metadata: {\n      framework: 'crewai',\n      role: event.role,\n      ...(event.delegatedTo ? { delegated_to: event.delegatedTo } : {}),\n      ...(event.error ? { error: event.error } : {}),\n      ...event.metadata,\n    },\n  };\n\n  await vorim.emit(auditEvent);\n}\n\n/**\n * Emits audit events for an entire crew run (batch of task results).\n *\n * @example\n * ```ts\n * await emitCrewRunEvents(vorim, [\n *   { role: \"researcher\", agentId: \"...\", task: \"research\", result: \"success\" },\n *   { role: \"writer\", agentId: \"...\", task: \"draft_article\", result: \"success\" },\n *   { role: \"editor\", agentId: \"...\", task: \"review\", result: \"success\" },\n * ]);\n * ```\n */\nexport async function emitCrewRunEvents(\n  vorim: VorimSDK,\n  events: CrewTaskEvent[],\n): Promise<{ ingested: number }> {\n  const auditEvents: AuditEventInput[] = events.map(event => ({\n    agent_id: event.agentId,\n    event_type: event.tool ? 'tool_call' : 'api_request',\n    action: event.task,\n    resource: event.tool,\n    result: event.result,\n    latency_ms: event.latencyMs,\n    error_code: event.error ? 'CREW_TASK_ERROR' : undefined,\n    metadata: {\n      framework: 'crewai',\n      role: event.role,\n      ...(event.delegatedTo ? { delegated_to: event.delegatedTo } : {}),\n      ...(event.error ? { error: event.error } : {}),\n      ...event.metadata,\n    },\n  }));\n\n  return vorim.emitBatch(auditEvents);\n}\n\n// ─── Permission Helpers ──────────────────────────────────────────────────\n\n/**\n * Check if a crew member has permission before executing a task.\n * Returns the check result — does not throw.\n *\n * @example\n * ```ts\n * const { allowed } = await checkCrewPermission(vorim, crew, \"writer\", \"agent:write\");\n * if (!allowed) {\n *   console.log(\"Writer lacks write permission\");\n * }\n * ```\n */\nexport async function checkCrewPermission(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n  role: string,\n  scope: PermissionScope,\n): Promise<{ allowed: boolean; reason?: string }> {\n  const member = crew.getMember(role);\n  if (!member) {\n    return { allowed: false, reason: `Unknown crew member: ${role}` };\n  }\n  return vorim.check(member.agentId, scope);\n}\n\n/**\n * Check if delegation between two crew members is permitted.\n * The delegating agent must have the `agent:delegate` scope.\n */\nexport async function checkDelegationPermission(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n  fromRole: string,\n  toRole: string,\n): Promise<{ allowed: boolean; reason?: string }> {\n  const from = crew.getMember(fromRole);\n  const to = crew.getMember(toRole);\n  if (!from) return { allowed: false, reason: `Unknown crew member: ${fromRole}` };\n  if (!to) return { allowed: false, reason: `Unknown crew member: ${toRole}` };\n\n  const result = await vorim.check(from.agentId, 'agent:delegate');\n  if (!result.allowed) {\n    return { allowed: false, reason: `${fromRole} lacks agent:delegate permission` };\n  }\n  return { allowed: true };\n}\n\n// ─── Trust Verification ──────────────────────────────────────────────────\n\n/**\n * Verify trust scores for all members of a crew.\n * Useful before starting a crew run to ensure all agents are active and trusted.\n */\nexport async function verifyCrewTrust(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n): Promise<{ role: string; agentId: string; trustScore: number; status: string }[]> {\n  const results = await Promise.all(\n    crew.members.map(async (member) => {\n      const trust = await vorim.verify(member.agentId);\n      return {\n        role: member.role,\n        agentId: member.agentId,\n        trustScore: trust.trust_score,\n        status: trust.status,\n      };\n    }),\n  );\n  return results;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/integrations/crewai.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — CrewAI Integration\n// CrewAI is Python-only, so this module provides:\n//   1. A TypeScript helper for managing CrewAI agent identities via Vorim\n//   2. Audit utilities for logging crew task execution\n//   3. A \"crew manifest\" pattern for registering entire crews at once\n//\n// Use this from a TypeScript orchestration layer that triggers CrewAI\n// runs via REST, CLI, or subprocess. For native Python integration,\n// use the Vorim REST API directly (see docs).\n//\n// No peer dependencies required — uses @vorim/sdk only.\n// ============================================================================\n\nimport type { VorimSDK } from '../index.js';\nimport type {\n  PermissionScope, AuditEventInput, AgentRegistrationResult,\n} from '../types.js';\n\n// ─── Crew Configuration ──────────────────────────────────────────────────\n\nexport interface CrewMemberConfig {\n  /** Unique role name within the crew (e.g. \"researcher\", \"writer\"). */\n  role: string;\n  /** Display name for the Vorim agent. */\n  name: string;\n  /** Description of this crew member's responsibilities. */\n  description?: string;\n  /** Tools this agent can use (e.g. [\"web_search\", \"file_read\"]). */\n  capabilities: string[];\n  /** Permission scopes to grant. */\n  scopes: PermissionScope[];\n  /** Whether this agent can delegate to other crew members. */\n  allowDelegation?: boolean;\n}\n\nexport interface CrewManifest {\n  /** Name for the overall crew. */\n  crewName: string;\n  /** Members of the crew. */\n  members: CrewMemberConfig[];\n  /** Optional metadata for the crew. */\n  metadata?: Record<string, unknown>;\n}\n\nexport interface RegisteredCrewMember {\n  role: string;\n  agentId: string;\n  registration: AgentRegistrationResult;\n  privateKey: string;\n}\n\nexport interface RegisteredCrew {\n  crewName: string;\n  members: RegisteredCrewMember[];\n  /** Lookup a member by role. */\n  getMember(role: string): RegisteredCrewMember | undefined;\n  /** Get all agent IDs in the crew. */\n  agentIds(): string[];\n}\n\n// ─── Crew Registration ──────────────────────────────────────────────────\n\n/**\n * Registers an entire CrewAI crew with Vorim. Each crew member gets a\n * unique Vorim agent identity with Ed25519 keypair and scoped permissions.\n *\n * @example\n * ```ts\n * import createVorim from \"@vorim/sdk\";\n * import { registerCrew } from \"@vorim/sdk/integrations/crewai\";\n *\n * const vorim = createVorim({ apiKey: \"agid_sk_live_...\" });\n *\n * const crew = await registerCrew(vorim, {\n *   crewName: \"content-pipeline\",\n *   members: [\n *     {\n *       role: \"researcher\",\n *       name: \"crew-researcher\",\n *       capabilities: [\"web_search\", \"summarization\"],\n *       scopes: [\"agent:read\", \"agent:execute\"],\n *     },\n *     {\n *       role: \"writer\",\n *       name: \"crew-writer\",\n *       capabilities: [\"file_write\", \"formatting\"],\n *       scopes: [\"agent:read\", \"agent:write\"],\n *     },\n *     {\n *       role: \"editor\",\n *       name: \"crew-editor\",\n *       capabilities: [\"review\", \"approval\"],\n *       scopes: [\"agent:read\", \"agent:write\"],\n *       allowDelegation: true,\n *     },\n *   ],\n * });\n *\n * // Access individual members\n * const researcher = crew.getMember(\"researcher\");\n * console.log(researcher.agentId); // agid_acme_...\n *\n * // Grant delegation permission to editor\n * // (done automatically if allowDelegation is true)\n * ```\n */\nexport async function registerCrew(\n  vorim: VorimSDK,\n  manifest: CrewManifest,\n): Promise<RegisteredCrew> {\n  const members: RegisteredCrewMember[] = [];\n\n  for (const member of manifest.members) {\n    const scopes = [...member.scopes];\n\n    // Auto-add delegate scope if delegation is allowed\n    if (member.allowDelegation && !scopes.includes('agent:delegate')) {\n      scopes.push('agent:delegate');\n    }\n\n    const registration = await vorim.register({\n      name: member.name,\n      description: member.description ?? `CrewAI ${member.role} — ${manifest.crewName}`,\n      capabilities: member.capabilities,\n      scopes,\n    });\n\n    members.push({\n      role: member.role,\n      agentId: registration.agent.agent_id,\n      registration,\n      privateKey: registration.private_key,\n    });\n  }\n\n  return {\n    crewName: manifest.crewName,\n    members,\n    getMember(role: string) {\n      return members.find(m => m.role === role);\n    },\n    agentIds() {\n      return members.map(m => m.agentId);\n    },\n  };\n}\n\n// ─── Task Audit ──────────────────────────────────────────────────────────\n\nexport interface CrewTaskEvent {\n  /** The role of the crew member performing the task. */\n  role: string;\n  /** The Vorim agent_id (looked up from the crew). */\n  agentId: string;\n  /** Task description or name. */\n  task: string;\n  /** Tool used (if any). */\n  tool?: string;\n  /** Result of the action. */\n  result: 'success' | 'denied' | 'error';\n  /** Duration in milliseconds. */\n  latencyMs?: number;\n  /** Error details if result is 'error'. */\n  error?: string;\n  /** Whether this was a delegation to another crew member. */\n  delegatedTo?: string;\n  /** Additional context. */\n  metadata?: Record<string, unknown>;\n  /**\n   * Replayable agent decision evidence (VAIP -02).\n   *\n   * Stable identifier for the model that produced this task. Free-form\n   * but recommended convention is `provider:model-name-version`.\n   */\n  modelVersion?: string;\n  /**\n   * SHA-256 of the canonicalised tool catalogue available to the\n   * crew member at task time. Compute via {@link hashToolCatalogue}\n   * from `@vorim/sdk`.\n   */\n  toolCatalogueHash?: string;\n  /**\n   * SHA-256 of the system prompt active at task time. Compute via\n   * {@link hashSystemPrompt} from `@vorim/sdk`.\n   */\n  systemPromptHash?: string;\n}\n\n/**\n * Emits a Vorim audit event for a CrewAI task execution.\n * Call this from your orchestration layer after each CrewAI step completes.\n *\n * @example\n * ```ts\n * import { emitCrewTaskEvent } from \"@vorim/sdk/integrations/crewai\";\n *\n * // After a CrewAI task completes\n * await emitCrewTaskEvent(vorim, {\n *   role: \"researcher\",\n *   agentId: crew.getMember(\"researcher\").agentId,\n *   task: \"research_competitors\",\n *   tool: \"web_search\",\n *   result: \"success\",\n *   latencyMs: 3200,\n * });\n * ```\n */\nexport async function emitCrewTaskEvent(\n  vorim: VorimSDK,\n  event: CrewTaskEvent,\n): Promise<void> {\n  const auditEvent: AuditEventInput = {\n    agent_id: event.agentId,\n    event_type: event.tool ? 'tool_call' : 'api_request',\n    action: event.task,\n    resource: event.tool,\n    result: event.result,\n    latency_ms: event.latencyMs,\n    error_code: event.error ? 'CREW_TASK_ERROR' : undefined,\n    metadata: {\n      framework: 'crewai',\n      role: event.role,\n      ...(event.delegatedTo ? { delegated_to: event.delegatedTo } : {}),\n      ...(event.error ? { error: event.error } : {}),\n      ...event.metadata,\n    },\n    ...(event.modelVersion ? { model_version: event.modelVersion } : {}),\n    ...(event.toolCatalogueHash ? { tool_catalogue_hash: event.toolCatalogueHash } : {}),\n    ...(event.systemPromptHash ? { system_prompt_hash: event.systemPromptHash } : {}),\n  };\n\n  await vorim.emit(auditEvent);\n}\n\n/**\n * Emits audit events for an entire crew run (batch of task results).\n *\n * @example\n * ```ts\n * await emitCrewRunEvents(vorim, [\n *   { role: \"researcher\", agentId: \"...\", task: \"research\", result: \"success\" },\n *   { role: \"writer\", agentId: \"...\", task: \"draft_article\", result: \"success\" },\n *   { role: \"editor\", agentId: \"...\", task: \"review\", result: \"success\" },\n * ]);\n * ```\n */\nexport async function emitCrewRunEvents(\n  vorim: VorimSDK,\n  events: CrewTaskEvent[],\n): Promise<{ ingested: number }> {\n  const auditEvents: AuditEventInput[] = events.map(event => ({\n    agent_id: event.agentId,\n    event_type: event.tool ? 'tool_call' : 'api_request',\n    action: event.task,\n    resource: event.tool,\n    result: event.result,\n    latency_ms: event.latencyMs,\n    error_code: event.error ? 'CREW_TASK_ERROR' : undefined,\n    metadata: {\n      framework: 'crewai',\n      role: event.role,\n      ...(event.delegatedTo ? { delegated_to: event.delegatedTo } : {}),\n      ...(event.error ? { error: event.error } : {}),\n      ...event.metadata,\n    },\n    ...(event.modelVersion ? { model_version: event.modelVersion } : {}),\n    ...(event.toolCatalogueHash ? { tool_catalogue_hash: event.toolCatalogueHash } : {}),\n    ...(event.systemPromptHash ? { system_prompt_hash: event.systemPromptHash } : {}),\n  }));\n\n  return vorim.emitBatch(auditEvents);\n}\n\n// ─── Permission Helpers ──────────────────────────────────────────────────\n\n/**\n * Check if a crew member has permission before executing a task.\n * Returns the check result — does not throw.\n *\n * @example\n * ```ts\n * const { allowed } = await checkCrewPermission(vorim, crew, \"writer\", \"agent:write\");\n * if (!allowed) {\n *   console.log(\"Writer lacks write permission\");\n * }\n * ```\n */\nexport async function checkCrewPermission(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n  role: string,\n  scope: PermissionScope,\n): Promise<{ allowed: boolean; reason?: string }> {\n  const member = crew.getMember(role);\n  if (!member) {\n    return { allowed: false, reason: `Unknown crew member: ${role}` };\n  }\n  return vorim.check(member.agentId, scope);\n}\n\n/**\n * Check if delegation between two crew members is permitted.\n * The delegating agent must have the `agent:delegate` scope.\n */\nexport async function checkDelegationPermission(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n  fromRole: string,\n  toRole: string,\n): Promise<{ allowed: boolean; reason?: string }> {\n  const from = crew.getMember(fromRole);\n  const to = crew.getMember(toRole);\n  if (!from) return { allowed: false, reason: `Unknown crew member: ${fromRole}` };\n  if (!to) return { allowed: false, reason: `Unknown crew member: ${toRole}` };\n\n  const result = await vorim.check(from.agentId, 'agent:delegate');\n  if (!result.allowed) {\n    return { allowed: false, reason: `${fromRole} lacks agent:delegate permission` };\n  }\n  return { allowed: true };\n}\n\n// ─── Trust Verification ──────────────────────────────────────────────────\n\n/**\n * Verify trust scores for all members of a crew.\n * Useful before starting a crew run to ensure all agents are active and trusted.\n */\nexport async function verifyCrewTrust(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n): Promise<{ role: string; agentId: string; trustScore: number; status: string }[]> {\n  const results = await Promise.all(\n    crew.members.map(async (member) => {\n      const trust = await vorim.verify(member.agentId);\n      return {\n        role: member.role,\n        agentId: member.agentId,\n        trustScore: trust.trust_score,\n        status: trust.status,\n      };\n    }),\n  );\n  return results;\n}\n"],"mappings":"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","names":[]}

package/dist/integrations/crewai.d.cts

@@ -100,6 +100,24 @@ interface CrewTaskEvent {
     delegatedTo?: string;
     /** Additional context. */
     metadata?: Record<string, unknown>;
+    /**
+     * Replayable agent decision evidence (VAIP -02).
+     *
+     * Stable identifier for the model that produced this task. Free-form
+     * but recommended convention is `provider:model-name-version`.
+     */
+    modelVersion?: string;
+    /**
+     * SHA-256 of the canonicalised tool catalogue available to the
+     * crew member at task time. Compute via {@link hashToolCatalogue}
+     * from `@vorim/sdk`.
+     */
+    toolCatalogueHash?: string;
+    /**
+     * SHA-256 of the system prompt active at task time. Compute via
+     * {@link hashSystemPrompt} from `@vorim/sdk`.
+     */
+    systemPromptHash?: string;
 }
 /**
  * Emits a Vorim audit event for a CrewAI task execution.

package/dist/integrations/crewai.d.ts

@@ -100,6 +100,24 @@ interface CrewTaskEvent {
     delegatedTo?: string;
     /** Additional context. */
     metadata?: Record<string, unknown>;
+    /**
+     * Replayable agent decision evidence (VAIP -02).
+     *
+     * Stable identifier for the model that produced this task. Free-form
+     * but recommended convention is `provider:model-name-version`.
+     */
+    modelVersion?: string;
+    /**
+     * SHA-256 of the canonicalised tool catalogue available to the
+     * crew member at task time. Compute via {@link hashToolCatalogue}
+     * from `@vorim/sdk`.
+     */
+    toolCatalogueHash?: string;
+    /**
+     * SHA-256 of the system prompt active at task time. Compute via
+     * {@link hashSystemPrompt} from `@vorim/sdk`.
+     */
+    systemPromptHash?: string;
 }
 /**
  * Emits a Vorim audit event for a CrewAI task execution.

package/dist/integrations/crewai.js

@@ -45,7 +45,10 @@ async function emitCrewTaskEvent(vorim, event) {
       ...event.delegatedTo ? { delegated_to: event.delegatedTo } : {},
       ...event.error ? { error: event.error } : {},
       ...event.metadata
-    }
+    },
+    ...event.modelVersion ? { model_version: event.modelVersion } : {},
+    ...event.toolCatalogueHash ? { tool_catalogue_hash: event.toolCatalogueHash } : {},
+    ...event.systemPromptHash ? { system_prompt_hash: event.systemPromptHash } : {}
   };
   await vorim.emit(auditEvent);
 }
@@ -64,7 +67,10 @@ async function emitCrewRunEvents(vorim, events) {
       ...event.delegatedTo ? { delegated_to: event.delegatedTo } : {},
       ...event.error ? { error: event.error } : {},
       ...event.metadata
-    }
+    },
+    ...event.modelVersion ? { model_version: event.modelVersion } : {},
+    ...event.toolCatalogueHash ? { tool_catalogue_hash: event.toolCatalogueHash } : {},
+    ...event.systemPromptHash ? { system_prompt_hash: event.systemPromptHash } : {}
   }));
   return vorim.emitBatch(auditEvents);
 }

package/dist/integrations/crewai.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/integrations/crewai.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — CrewAI Integration\n// CrewAI is Python-only, so this module provides:\n//   1. A TypeScript helper for managing CrewAI agent identities via Vorim\n//   2. Audit utilities for logging crew task execution\n//   3. A \"crew manifest\" pattern for registering entire crews at once\n//\n// Use this from a TypeScript orchestration layer that triggers CrewAI\n// runs via REST, CLI, or subprocess. For native Python integration,\n// use the Vorim REST API directly (see docs).\n//\n// No peer dependencies required — uses @vorim/sdk only.\n// ============================================================================\n\nimport type { VorimSDK } from '../index.js';\nimport type {\n  PermissionScope, AuditEventInput, AgentRegistrationResult,\n} from '../types.js';\n\n// ─── Crew Configuration ──────────────────────────────────────────────────\n\nexport interface CrewMemberConfig {\n  /** Unique role name within the crew (e.g. \"researcher\", \"writer\"). */\n  role: string;\n  /** Display name for the Vorim agent. */\n  name: string;\n  /** Description of this crew member's responsibilities. */\n  description?: string;\n  /** Tools this agent can use (e.g. [\"web_search\", \"file_read\"]). */\n  capabilities: string[];\n  /** Permission scopes to grant. */\n  scopes: PermissionScope[];\n  /** Whether this agent can delegate to other crew members. */\n  allowDelegation?: boolean;\n}\n\nexport interface CrewManifest {\n  /** Name for the overall crew. */\n  crewName: string;\n  /** Members of the crew. */\n  members: CrewMemberConfig[];\n  /** Optional metadata for the crew. */\n  metadata?: Record<string, unknown>;\n}\n\nexport interface RegisteredCrewMember {\n  role: string;\n  agentId: string;\n  registration: AgentRegistrationResult;\n  privateKey: string;\n}\n\nexport interface RegisteredCrew {\n  crewName: string;\n  members: RegisteredCrewMember[];\n  /** Lookup a member by role. */\n  getMember(role: string): RegisteredCrewMember | undefined;\n  /** Get all agent IDs in the crew. */\n  agentIds(): string[];\n}\n\n// ─── Crew Registration ──────────────────────────────────────────────────\n\n/**\n * Registers an entire CrewAI crew with Vorim. Each crew member gets a\n * unique Vorim agent identity with Ed25519 keypair and scoped permissions.\n *\n * @example\n * ```ts\n * import createVorim from \"@vorim/sdk\";\n * import { registerCrew } from \"@vorim/sdk/integrations/crewai\";\n *\n * const vorim = createVorim({ apiKey: \"agid_sk_live_...\" });\n *\n * const crew = await registerCrew(vorim, {\n *   crewName: \"content-pipeline\",\n *   members: [\n *     {\n *       role: \"researcher\",\n *       name: \"crew-researcher\",\n *       capabilities: [\"web_search\", \"summarization\"],\n *       scopes: [\"agent:read\", \"agent:execute\"],\n *     },\n *     {\n *       role: \"writer\",\n *       name: \"crew-writer\",\n *       capabilities: [\"file_write\", \"formatting\"],\n *       scopes: [\"agent:read\", \"agent:write\"],\n *     },\n *     {\n *       role: \"editor\",\n *       name: \"crew-editor\",\n *       capabilities: [\"review\", \"approval\"],\n *       scopes: [\"agent:read\", \"agent:write\"],\n *       allowDelegation: true,\n *     },\n *   ],\n * });\n *\n * // Access individual members\n * const researcher = crew.getMember(\"researcher\");\n * console.log(researcher.agentId); // agid_acme_...\n *\n * // Grant delegation permission to editor\n * // (done automatically if allowDelegation is true)\n * ```\n */\nexport async function registerCrew(\n  vorim: VorimSDK,\n  manifest: CrewManifest,\n): Promise<RegisteredCrew> {\n  const members: RegisteredCrewMember[] = [];\n\n  for (const member of manifest.members) {\n    const scopes = [...member.scopes];\n\n    // Auto-add delegate scope if delegation is allowed\n    if (member.allowDelegation && !scopes.includes('agent:delegate')) {\n      scopes.push('agent:delegate');\n    }\n\n    const registration = await vorim.register({\n      name: member.name,\n      description: member.description ?? `CrewAI ${member.role} — ${manifest.crewName}`,\n      capabilities: member.capabilities,\n      scopes,\n    });\n\n    members.push({\n      role: member.role,\n      agentId: registration.agent.agent_id,\n      registration,\n      privateKey: registration.private_key,\n    });\n  }\n\n  return {\n    crewName: manifest.crewName,\n    members,\n    getMember(role: string) {\n      return members.find(m => m.role === role);\n    },\n    agentIds() {\n      return members.map(m => m.agentId);\n    },\n  };\n}\n\n// ─── Task Audit ──────────────────────────────────────────────────────────\n\nexport interface CrewTaskEvent {\n  /** The role of the crew member performing the task. */\n  role: string;\n  /** The Vorim agent_id (looked up from the crew). */\n  agentId: string;\n  /** Task description or name. */\n  task: string;\n  /** Tool used (if any). */\n  tool?: string;\n  /** Result of the action. */\n  result: 'success' | 'denied' | 'error';\n  /** Duration in milliseconds. */\n  latencyMs?: number;\n  /** Error details if result is 'error'. */\n  error?: string;\n  /** Whether this was a delegation to another crew member. */\n  delegatedTo?: string;\n  /** Additional context. */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Emits a Vorim audit event for a CrewAI task execution.\n * Call this from your orchestration layer after each CrewAI step completes.\n *\n * @example\n * ```ts\n * import { emitCrewTaskEvent } from \"@vorim/sdk/integrations/crewai\";\n *\n * // After a CrewAI task completes\n * await emitCrewTaskEvent(vorim, {\n *   role: \"researcher\",\n *   agentId: crew.getMember(\"researcher\").agentId,\n *   task: \"research_competitors\",\n *   tool: \"web_search\",\n *   result: \"success\",\n *   latencyMs: 3200,\n * });\n * ```\n */\nexport async function emitCrewTaskEvent(\n  vorim: VorimSDK,\n  event: CrewTaskEvent,\n): Promise<void> {\n  const auditEvent: AuditEventInput = {\n    agent_id: event.agentId,\n    event_type: event.tool ? 'tool_call' : 'api_request',\n    action: event.task,\n    resource: event.tool,\n    result: event.result,\n    latency_ms: event.latencyMs,\n    error_code: event.error ? 'CREW_TASK_ERROR' : undefined,\n    metadata: {\n      framework: 'crewai',\n      role: event.role,\n      ...(event.delegatedTo ? { delegated_to: event.delegatedTo } : {}),\n      ...(event.error ? { error: event.error } : {}),\n      ...event.metadata,\n    },\n  };\n\n  await vorim.emit(auditEvent);\n}\n\n/**\n * Emits audit events for an entire crew run (batch of task results).\n *\n * @example\n * ```ts\n * await emitCrewRunEvents(vorim, [\n *   { role: \"researcher\", agentId: \"...\", task: \"research\", result: \"success\" },\n *   { role: \"writer\", agentId: \"...\", task: \"draft_article\", result: \"success\" },\n *   { role: \"editor\", agentId: \"...\", task: \"review\", result: \"success\" },\n * ]);\n * ```\n */\nexport async function emitCrewRunEvents(\n  vorim: VorimSDK,\n  events: CrewTaskEvent[],\n): Promise<{ ingested: number }> {\n  const auditEvents: AuditEventInput[] = events.map(event => ({\n    agent_id: event.agentId,\n    event_type: event.tool ? 'tool_call' : 'api_request',\n    action: event.task,\n    resource: event.tool,\n    result: event.result,\n    latency_ms: event.latencyMs,\n    error_code: event.error ? 'CREW_TASK_ERROR' : undefined,\n    metadata: {\n      framework: 'crewai',\n      role: event.role,\n      ...(event.delegatedTo ? { delegated_to: event.delegatedTo } : {}),\n      ...(event.error ? { error: event.error } : {}),\n      ...event.metadata,\n    },\n  }));\n\n  return vorim.emitBatch(auditEvents);\n}\n\n// ─── Permission Helpers ──────────────────────────────────────────────────\n\n/**\n * Check if a crew member has permission before executing a task.\n * Returns the check result — does not throw.\n *\n * @example\n * ```ts\n * const { allowed } = await checkCrewPermission(vorim, crew, \"writer\", \"agent:write\");\n * if (!allowed) {\n *   console.log(\"Writer lacks write permission\");\n * }\n * ```\n */\nexport async function checkCrewPermission(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n  role: string,\n  scope: PermissionScope,\n): Promise<{ allowed: boolean; reason?: string }> {\n  const member = crew.getMember(role);\n  if (!member) {\n    return { allowed: false, reason: `Unknown crew member: ${role}` };\n  }\n  return vorim.check(member.agentId, scope);\n}\n\n/**\n * Check if delegation between two crew members is permitted.\n * The delegating agent must have the `agent:delegate` scope.\n */\nexport async function checkDelegationPermission(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n  fromRole: string,\n  toRole: string,\n): Promise<{ allowed: boolean; reason?: string }> {\n  const from = crew.getMember(fromRole);\n  const to = crew.getMember(toRole);\n  if (!from) return { allowed: false, reason: `Unknown crew member: ${fromRole}` };\n  if (!to) return { allowed: false, reason: `Unknown crew member: ${toRole}` };\n\n  const result = await vorim.check(from.agentId, 'agent:delegate');\n  if (!result.allowed) {\n    return { allowed: false, reason: `${fromRole} lacks agent:delegate permission` };\n  }\n  return { allowed: true };\n}\n\n// ─── Trust Verification ──────────────────────────────────────────────────\n\n/**\n * Verify trust scores for all members of a crew.\n * Useful before starting a crew run to ensure all agents are active and trusted.\n */\nexport async function verifyCrewTrust(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n): Promise<{ role: string; agentId: string; trustScore: number; status: string }[]> {\n  const results = await Promise.all(\n    crew.members.map(async (member) => {\n      const trust = await vorim.verify(member.agentId);\n      return {\n        role: member.role,\n        agentId: member.agentId,\n        trustScore: trust.trust_score,\n        status: trust.status,\n      };\n    }),\n  );\n  return results;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/integrations/crewai.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — CrewAI Integration\n// CrewAI is Python-only, so this module provides:\n//   1. A TypeScript helper for managing CrewAI agent identities via Vorim\n//   2. Audit utilities for logging crew task execution\n//   3. A \"crew manifest\" pattern for registering entire crews at once\n//\n// Use this from a TypeScript orchestration layer that triggers CrewAI\n// runs via REST, CLI, or subprocess. For native Python integration,\n// use the Vorim REST API directly (see docs).\n//\n// No peer dependencies required — uses @vorim/sdk only.\n// ============================================================================\n\nimport type { VorimSDK } from '../index.js';\nimport type {\n  PermissionScope, AuditEventInput, AgentRegistrationResult,\n} from '../types.js';\n\n// ─── Crew Configuration ──────────────────────────────────────────────────\n\nexport interface CrewMemberConfig {\n  /** Unique role name within the crew (e.g. \"researcher\", \"writer\"). */\n  role: string;\n  /** Display name for the Vorim agent. */\n  name: string;\n  /** Description of this crew member's responsibilities. */\n  description?: string;\n  /** Tools this agent can use (e.g. [\"web_search\", \"file_read\"]). */\n  capabilities: string[];\n  /** Permission scopes to grant. */\n  scopes: PermissionScope[];\n  /** Whether this agent can delegate to other crew members. */\n  allowDelegation?: boolean;\n}\n\nexport interface CrewManifest {\n  /** Name for the overall crew. */\n  crewName: string;\n  /** Members of the crew. */\n  members: CrewMemberConfig[];\n  /** Optional metadata for the crew. */\n  metadata?: Record<string, unknown>;\n}\n\nexport interface RegisteredCrewMember {\n  role: string;\n  agentId: string;\n  registration: AgentRegistrationResult;\n  privateKey: string;\n}\n\nexport interface RegisteredCrew {\n  crewName: string;\n  members: RegisteredCrewMember[];\n  /** Lookup a member by role. */\n  getMember(role: string): RegisteredCrewMember | undefined;\n  /** Get all agent IDs in the crew. */\n  agentIds(): string[];\n}\n\n// ─── Crew Registration ──────────────────────────────────────────────────\n\n/**\n * Registers an entire CrewAI crew with Vorim. Each crew member gets a\n * unique Vorim agent identity with Ed25519 keypair and scoped permissions.\n *\n * @example\n * ```ts\n * import createVorim from \"@vorim/sdk\";\n * import { registerCrew } from \"@vorim/sdk/integrations/crewai\";\n *\n * const vorim = createVorim({ apiKey: \"agid_sk_live_...\" });\n *\n * const crew = await registerCrew(vorim, {\n *   crewName: \"content-pipeline\",\n *   members: [\n *     {\n *       role: \"researcher\",\n *       name: \"crew-researcher\",\n *       capabilities: [\"web_search\", \"summarization\"],\n *       scopes: [\"agent:read\", \"agent:execute\"],\n *     },\n *     {\n *       role: \"writer\",\n *       name: \"crew-writer\",\n *       capabilities: [\"file_write\", \"formatting\"],\n *       scopes: [\"agent:read\", \"agent:write\"],\n *     },\n *     {\n *       role: \"editor\",\n *       name: \"crew-editor\",\n *       capabilities: [\"review\", \"approval\"],\n *       scopes: [\"agent:read\", \"agent:write\"],\n *       allowDelegation: true,\n *     },\n *   ],\n * });\n *\n * // Access individual members\n * const researcher = crew.getMember(\"researcher\");\n * console.log(researcher.agentId); // agid_acme_...\n *\n * // Grant delegation permission to editor\n * // (done automatically if allowDelegation is true)\n * ```\n */\nexport async function registerCrew(\n  vorim: VorimSDK,\n  manifest: CrewManifest,\n): Promise<RegisteredCrew> {\n  const members: RegisteredCrewMember[] = [];\n\n  for (const member of manifest.members) {\n    const scopes = [...member.scopes];\n\n    // Auto-add delegate scope if delegation is allowed\n    if (member.allowDelegation && !scopes.includes('agent:delegate')) {\n      scopes.push('agent:delegate');\n    }\n\n    const registration = await vorim.register({\n      name: member.name,\n      description: member.description ?? `CrewAI ${member.role} — ${manifest.crewName}`,\n      capabilities: member.capabilities,\n      scopes,\n    });\n\n    members.push({\n      role: member.role,\n      agentId: registration.agent.agent_id,\n      registration,\n      privateKey: registration.private_key,\n    });\n  }\n\n  return {\n    crewName: manifest.crewName,\n    members,\n    getMember(role: string) {\n      return members.find(m => m.role === role);\n    },\n    agentIds() {\n      return members.map(m => m.agentId);\n    },\n  };\n}\n\n// ─── Task Audit ──────────────────────────────────────────────────────────\n\nexport interface CrewTaskEvent {\n  /** The role of the crew member performing the task. */\n  role: string;\n  /** The Vorim agent_id (looked up from the crew). */\n  agentId: string;\n  /** Task description or name. */\n  task: string;\n  /** Tool used (if any). */\n  tool?: string;\n  /** Result of the action. */\n  result: 'success' | 'denied' | 'error';\n  /** Duration in milliseconds. */\n  latencyMs?: number;\n  /** Error details if result is 'error'. */\n  error?: string;\n  /** Whether this was a delegation to another crew member. */\n  delegatedTo?: string;\n  /** Additional context. */\n  metadata?: Record<string, unknown>;\n  /**\n   * Replayable agent decision evidence (VAIP -02).\n   *\n   * Stable identifier for the model that produced this task. Free-form\n   * but recommended convention is `provider:model-name-version`.\n   */\n  modelVersion?: string;\n  /**\n   * SHA-256 of the canonicalised tool catalogue available to the\n   * crew member at task time. Compute via {@link hashToolCatalogue}\n   * from `@vorim/sdk`.\n   */\n  toolCatalogueHash?: string;\n  /**\n   * SHA-256 of the system prompt active at task time. Compute via\n   * {@link hashSystemPrompt} from `@vorim/sdk`.\n   */\n  systemPromptHash?: string;\n}\n\n/**\n * Emits a Vorim audit event for a CrewAI task execution.\n * Call this from your orchestration layer after each CrewAI step completes.\n *\n * @example\n * ```ts\n * import { emitCrewTaskEvent } from \"@vorim/sdk/integrations/crewai\";\n *\n * // After a CrewAI task completes\n * await emitCrewTaskEvent(vorim, {\n *   role: \"researcher\",\n *   agentId: crew.getMember(\"researcher\").agentId,\n *   task: \"research_competitors\",\n *   tool: \"web_search\",\n *   result: \"success\",\n *   latencyMs: 3200,\n * });\n * ```\n */\nexport async function emitCrewTaskEvent(\n  vorim: VorimSDK,\n  event: CrewTaskEvent,\n): Promise<void> {\n  const auditEvent: AuditEventInput = {\n    agent_id: event.agentId,\n    event_type: event.tool ? 'tool_call' : 'api_request',\n    action: event.task,\n    resource: event.tool,\n    result: event.result,\n    latency_ms: event.latencyMs,\n    error_code: event.error ? 'CREW_TASK_ERROR' : undefined,\n    metadata: {\n      framework: 'crewai',\n      role: event.role,\n      ...(event.delegatedTo ? { delegated_to: event.delegatedTo } : {}),\n      ...(event.error ? { error: event.error } : {}),\n      ...event.metadata,\n    },\n    ...(event.modelVersion ? { model_version: event.modelVersion } : {}),\n    ...(event.toolCatalogueHash ? { tool_catalogue_hash: event.toolCatalogueHash } : {}),\n    ...(event.systemPromptHash ? { system_prompt_hash: event.systemPromptHash } : {}),\n  };\n\n  await vorim.emit(auditEvent);\n}\n\n/**\n * Emits audit events for an entire crew run (batch of task results).\n *\n * @example\n * ```ts\n * await emitCrewRunEvents(vorim, [\n *   { role: \"researcher\", agentId: \"...\", task: \"research\", result: \"success\" },\n *   { role: \"writer\", agentId: \"...\", task: \"draft_article\", result: \"success\" },\n *   { role: \"editor\", agentId: \"...\", task: \"review\", result: \"success\" },\n * ]);\n * ```\n */\nexport async function emitCrewRunEvents(\n  vorim: VorimSDK,\n  events: CrewTaskEvent[],\n): Promise<{ ingested: number }> {\n  const auditEvents: AuditEventInput[] = events.map(event => ({\n    agent_id: event.agentId,\n    event_type: event.tool ? 'tool_call' : 'api_request',\n    action: event.task,\n    resource: event.tool,\n    result: event.result,\n    latency_ms: event.latencyMs,\n    error_code: event.error ? 'CREW_TASK_ERROR' : undefined,\n    metadata: {\n      framework: 'crewai',\n      role: event.role,\n      ...(event.delegatedTo ? { delegated_to: event.delegatedTo } : {}),\n      ...(event.error ? { error: event.error } : {}),\n      ...event.metadata,\n    },\n    ...(event.modelVersion ? { model_version: event.modelVersion } : {}),\n    ...(event.toolCatalogueHash ? { tool_catalogue_hash: event.toolCatalogueHash } : {}),\n    ...(event.systemPromptHash ? { system_prompt_hash: event.systemPromptHash } : {}),\n  }));\n\n  return vorim.emitBatch(auditEvents);\n}\n\n// ─── Permission Helpers ──────────────────────────────────────────────────\n\n/**\n * Check if a crew member has permission before executing a task.\n * Returns the check result — does not throw.\n *\n * @example\n * ```ts\n * const { allowed } = await checkCrewPermission(vorim, crew, \"writer\", \"agent:write\");\n * if (!allowed) {\n *   console.log(\"Writer lacks write permission\");\n * }\n * ```\n */\nexport async function checkCrewPermission(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n  role: string,\n  scope: PermissionScope,\n): Promise<{ allowed: boolean; reason?: string }> {\n  const member = crew.getMember(role);\n  if (!member) {\n    return { allowed: false, reason: `Unknown crew member: ${role}` };\n  }\n  return vorim.check(member.agentId, scope);\n}\n\n/**\n * Check if delegation between two crew members is permitted.\n * The delegating agent must have the `agent:delegate` scope.\n */\nexport async function checkDelegationPermission(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n  fromRole: string,\n  toRole: string,\n): Promise<{ allowed: boolean; reason?: string }> {\n  const from = crew.getMember(fromRole);\n  const to = crew.getMember(toRole);\n  if (!from) return { allowed: false, reason: `Unknown crew member: ${fromRole}` };\n  if (!to) return { allowed: false, reason: `Unknown crew member: ${toRole}` };\n\n  const result = await vorim.check(from.agentId, 'agent:delegate');\n  if (!result.allowed) {\n    return { allowed: false, reason: `${fromRole} lacks agent:delegate permission` };\n  }\n  return { allowed: true };\n}\n\n// ─── Trust Verification ──────────────────────────────────────────────────\n\n/**\n * Verify trust scores for all members of a crew.\n * Useful before starting a crew run to ensure all agents are active and trusted.\n */\nexport async function verifyCrewTrust(\n  vorim: VorimSDK,\n  crew: RegisteredCrew,\n): Promise<{ role: string; agentId: string; trustScore: number; status: string }[]> {\n  const results = await Promise.all(\n    crew.members.map(async (member) => {\n      const trust = await vorim.verify(member.agentId);\n      return {\n        role: member.role,\n        agentId: member.agentId,\n        trustScore: trust.trust_score,\n        status: trust.status,\n      };\n    }),\n  );\n  return results;\n}\n"],"mappings":"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","names":[]}

package/dist/integrations/langchain.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/integrations/langchain.ts
@@ -26,12 +36,82 @@ __export(langchain_exports, {
   wrapTools: () => wrapTools
 });
 module.exports = __toCommonJS(langchain_exports);
+
+// src/replay.ts
+function jcsCanonicalise(value) {
+  if (value === null) return "null";
+  if (value === true) return "true";
+  if (value === false) return "false";
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) {
+      throw new Error("jcsCanonicalise: NaN and Infinity are not JCS-valid");
+    }
+    return value.toString();
+  }
+  if (typeof value === "string") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return "[" + value.map(jcsCanonicalise).join(",") + "]";
+  }
+  if (typeof value === "object") {
+    const keys = Object.keys(value).sort();
+    const parts = keys.map((k) => {
+      return JSON.stringify(k) + ":" + jcsCanonicalise(value[k]);
+    });
+    return "{" + parts.join(",") + "}";
+  }
+  throw new Error(`jcsCanonicalise: unsupported value type: ${typeof value}`);
+}
+async function sha256Hex(input) {
+  const bytes = typeof input === "string" ? new TextEncoder().encode(input) : input;
+  const subtle = globalThis.crypto?.subtle;
+  if (subtle) {
+    const buf = await subtle.digest("SHA-256", bytes);
+    return Array.from(new Uint8Array(buf)).map((b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  const nodeCrypto = await import("crypto");
+  return nodeCrypto.createHash("sha256").update(bytes).digest("hex");
+}
+async function hashTool(tool) {
+  const normalised = {
+    name: tool.name,
+    description: tool.description ?? "",
+    schema: tool.schema ?? {}
+  };
+  const hex = await sha256Hex(jcsCanonicalise(normalised));
+  return `sha256:${hex}`;
+}
+async function hashToolCatalogue(tools) {
+  if (tools.length === 0) {
+    return `sha256:${await sha256Hex("[]")}`;
+  }
+  const perTool = await Promise.all(tools.map(hashTool));
+  perTool.sort();
+  const hex = await sha256Hex(perTool.join(""));
+  return `sha256:${hex}`;
+}
+async function hashSystemPrompt(prompt) {
+  const hex = await sha256Hex(prompt);
+  return `sha256:${hex}`;
+}
+async function prepareReplayContext(inputs) {
+  const ctx = {};
+  if (inputs.modelVersion) ctx.model_version = inputs.modelVersion;
+  if (inputs.tools) ctx.tool_catalogue_hash = await hashToolCatalogue(inputs.tools);
+  if (inputs.systemPrompt) ctx.system_prompt_hash = await hashSystemPrompt(inputs.systemPrompt);
+  return ctx;
+}
+
+// src/integrations/langchain.ts
 function wrapTool(tool, config) {
-  const { vorim, agentId, permissionMap = {}, defaultPermission = "agent:execute", asyncAudit = true } = config;
+  const { vorim, agentId, permissionMap = {}, defaultPermission = "agent:execute", asyncAudit = true, replay } = config;
   const originalCall = tool._call.bind(tool);
+  const getReplayCtx = makeReplayContextGetter(replay);
   tool._call = async function vorimGuardedCall(arg, runManager, parentConfig) {
     const scope = permissionMap[tool.name] ?? defaultPermission;
     const { allowed, reason } = await vorim.check(agentId, scope);
+    const replayCtx = await getReplayCtx();
     if (!allowed) {
       const event2 = {
         agent_id: agentId,
@@ -40,7 +120,8 @@ function wrapTool(tool, config) {
         resource: truncate(JSON.stringify(arg), 500),
         permission: scope,
         result: "denied",
-        metadata: { reason, framework: "langchain" }
+        metadata: { reason, framework: "langchain" },
+        ...replayCtx
       };
       emitAudit(vorim, event2, asyncAudit);
       throw new Error(`Vorim: permission denied for "${tool.name}" \u2014 scope "${scope}"${reason ? `: ${reason}` : ""}`);
@@ -59,7 +140,8 @@ function wrapTool(tool, config) {
         result: "error",
         latency_ms: Date.now() - start,
         error_code: err instanceof Error ? err.name : "UNKNOWN",
-        metadata: { error: err instanceof Error ? err.message : String(err), framework: "langchain" }
+        metadata: { error: err instanceof Error ? err.message : String(err), framework: "langchain" },
+        ...replayCtx
       };
       emitAudit(vorim, event2, asyncAudit);
       throw err;
@@ -72,13 +154,22 @@ function wrapTool(tool, config) {
       permission: scope,
       result: "success",
       latency_ms: Date.now() - start,
-      metadata: { framework: "langchain" }
+      metadata: { framework: "langchain" },
+      ...replayCtx
     };
     emitAudit(vorim, event, asyncAudit);
     return result;
   };
   return tool;
 }
+function makeReplayContextGetter(replay) {
+  if (!replay) return async () => ({});
+  let cached = null;
+  return () => {
+    if (!cached) cached = prepareReplayContext(replay);
+    return cached;
+  };
+}
 function wrapTools(tools, config) {
   return tools.map((t) => wrapTool(t, config));
 }
@@ -87,6 +178,7 @@ var VorimCallbackHandler = class _VorimCallbackHandler {
   vorim;
   agentId;
   runMap = /* @__PURE__ */ new Map();
+  getReplayCtx;
   // Flags to satisfy BaseCallbackHandler interface
   ignoreLLM = true;
   ignoreChain = true;
@@ -100,9 +192,17 @@ var VorimCallbackHandler = class _VorimCallbackHandler {
   get lc_namespace() {
     return ["vorim", "callbacks"];
   }
-  constructor(vorim, agentId) {
+  /**
+   * @param vorim Vorim SDK instance.
+   * @param agentId The Vorim agent_id whose actions this callback audits.
+   * @param replay Optional replayable-evidence inputs. Same shape as
+   *               {@link VorimLangChainConfig.replay}; hashes are
+   *               computed once and attached to every audit event.
+   */
+  constructor(vorim, agentId, replay) {
     this.vorim = vorim;
     this.agentId = agentId;
+    this.getReplayCtx = makeReplayContextGetter(replay);
   }
   async handleToolStart(tool, input, runId, _parentRunId, _tags, _metadata, runName) {
     const toolName = runName ?? tool.id?.[tool.id.length - 1] ?? "unknown";
@@ -112,6 +212,7 @@ var VorimCallbackHandler = class _VorimCallbackHandler {
     const run = this.runMap.get(runId);
     if (!run) return;
     this.runMap.delete(runId);
+    const replayCtx = await this.getReplayCtx();
     await this.vorim.emit({
       agent_id: this.agentId,
       event_type: "tool_call",
@@ -119,7 +220,8 @@ var VorimCallbackHandler = class _VorimCallbackHandler {
       resource: truncate(run.input, 500),
       result: "success",
       latency_ms: Date.now() - run.startTime,
-      metadata: { framework: "langchain" }
+      metadata: { framework: "langchain" },
+      ...replayCtx
     }).catch(() => {
     });
   }
@@ -127,6 +229,7 @@ var VorimCallbackHandler = class _VorimCallbackHandler {
     const run = this.runMap.get(runId);
     if (!run) return;
     this.runMap.delete(runId);
+    const replayCtx = await this.getReplayCtx();
     await this.vorim.emit({
       agent_id: this.agentId,
       event_type: "tool_call",
@@ -135,7 +238,8 @@ var VorimCallbackHandler = class _VorimCallbackHandler {
       result: "error",
       latency_ms: Date.now() - run.startTime,
       error_code: err.name,
-      metadata: { error: err.message, framework: "langchain" }
+      metadata: { error: err.message, framework: "langchain" },
+      ...replayCtx
     }).catch(() => {
     });
   }
@@ -151,7 +255,7 @@ var VorimCallbackHandler = class _VorimCallbackHandler {
   }
 };
 async function createVorimAgent(config) {
-  const { vorim, name, capabilities, scopes, description, tools: rawTools, permissionMap, defaultPermission, asyncAudit } = config;
+  const { vorim, name, capabilities, scopes, description, tools: rawTools, permissionMap, defaultPermission, asyncAudit, replay } = config;
   const registration = await vorim.register({
     name,
     description,
@@ -159,9 +263,17 @@ async function createVorimAgent(config) {
     scopes
   });
   const agentId = registration.agent.agent_id;
-  const agentConfig = { vorim, agentId, permissionMap, defaultPermission, asyncAudit };
+  const derivedReplay = replay ? { ...replay, tools: replay.tools ?? deriveCatalogueFromLangChainTools(rawTools) } : { tools: deriveCatalogueFromLangChainTools(rawTools) };
+  const agentConfig = {
+    vorim,
+    agentId,
+    permissionMap,
+    defaultPermission,
+    asyncAudit,
+    replay: derivedReplay
+  };
   const tools = wrapTools(rawTools, agentConfig);
-  const callbackHandler = new VorimCallbackHandler(vorim, agentId);
+  const callbackHandler = new VorimCallbackHandler(vorim, agentId, derivedReplay);
   return {
     /** The Vorim agent_id. */
     agentId,
@@ -187,6 +299,24 @@ function emitAudit(vorim, event, async) {
     });
   }
 }
+function deriveCatalogueFromLangChainTools(tools) {
+  return tools.map((t) => {
+    let schema = null;
+    const raw = t.schema;
+    if (raw && typeof raw === "object") {
+      try {
+        schema = JSON.parse(JSON.stringify(raw));
+      } catch {
+        schema = null;
+      }
+    }
+    return {
+      name: t.name,
+      description: t.description ?? "",
+      schema
+    };
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   VorimCallbackHandler,

package/dist/integrations/langchain.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/integrations/langchain.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — LangChain / LangGraph JS Integration\n// Provides tool wrapping with permission checks + audit trail,\n// a callback handler for observability, and a factory for creating\n// Vorim-secured LangGraph ReAct agents.\n//\n// Peer dependencies:\n//   @langchain/core >=0.3.0\n//   @langchain/langgraph >=0.2.0\n// ============================================================================\n\nimport type { VorimSDK } from '../index.js';\nimport type { PermissionScope, AuditEventInput } from '../types.js';\n\n// ─── Re-declared LangChain types (peer dependency — not bundled) ──────────\n// These mirror the actual types from @langchain/core so consumers don't\n// need to import them separately for basic usage.\n\n/** Minimal subset of @langchain/core Serialized */\ninterface Serialized {\n  lc: number;\n  type: string;\n  id: string[];\n  kwargs?: Record<string, unknown>;\n}\n\n// ─── Configuration ────────────────────────────────────────────────────────\n\nexport interface VorimLangChainConfig {\n  /** Vorim SDK instance. */\n  vorim: VorimSDK;\n  /** The Vorim agent_id to associate with this LangChain agent. */\n  agentId: string;\n  /** Map tool names → Vorim permission scopes. Unmapped tools default to 'agent:execute'. */\n  permissionMap?: Record<string, PermissionScope>;\n  /** Default permission scope for tools not in permissionMap. @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 Wrapper ─────────────────────────────────────────────────────────\n\n/**\n * Wraps a LangChain `StructuredTool` (or `DynamicStructuredTool`) with\n * Vorim permission checks before execution and audit event emission after.\n *\n * Works with any tool that has `name`, `description`, `schema`, and `_call`.\n *\n * @example\n * ```ts\n * import { DynamicStructuredTool } from \"@langchain/core/tools\";\n * import { wrapTool } from \"@vorim/sdk/integrations/langchain\";\n *\n * const guarded = wrapTool(myTool, {\n *   vorim, agentId: \"agid_acme_a1b2c3d4\",\n *   permissionMap: { search_docs: \"agent:read\" },\n * });\n * ```\n */\nexport function wrapTool<T extends LangChainTool>(\n  tool: T,\n  config: VorimLangChainConfig,\n): T {\n  const { vorim, agentId, permissionMap = {}, defaultPermission = 'agent:execute', asyncAudit = true } = config;\n\n  const originalCall = tool._call.bind(tool);\n\n  // Override _call to inject permission check + audit\n  (tool as any)._call = async function vorimGuardedCall(\n    arg: unknown,\n    runManager?: unknown,\n    parentConfig?: unknown,\n  ): Promise<unknown> {\n    const scope = permissionMap[tool.name] ?? defaultPermission;\n\n    // 1. Permission check\n    const { allowed, reason } = await vorim.check(agentId, scope);\n\n    if (!allowed) {\n      const event: AuditEventInput = {\n        agent_id: agentId,\n        event_type: 'tool_call',\n        action: tool.name,\n        resource: truncate(JSON.stringify(arg), 500),\n        permission: scope,\n        result: 'denied',\n        metadata: { reason, framework: 'langchain' },\n      };\n      emitAudit(vorim, event, asyncAudit);\n      throw new Error(`Vorim: permission denied for \"${tool.name}\" — scope \"${scope}\"${reason ? `: ${reason}` : ''}`);\n    }\n\n    // 2. Execute the original tool\n    const start = Date.now();\n    let result: unknown;\n    try {\n      result = await originalCall(arg, runManager, parentConfig);\n    } catch (err) {\n      const event: AuditEventInput = {\n        agent_id: agentId,\n        event_type: 'tool_call',\n        action: tool.name,\n        resource: truncate(JSON.stringify(arg), 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: err instanceof Error ? err.message : String(err), framework: 'langchain' },\n      };\n      emitAudit(vorim, event, asyncAudit);\n      throw err;\n    }\n\n    // 3. Audit success\n    const event: AuditEventInput = {\n      agent_id: agentId,\n      event_type: 'tool_call',\n      action: tool.name,\n      resource: truncate(JSON.stringify(arg), 500),\n      permission: scope,\n      result: 'success',\n      latency_ms: Date.now() - start,\n      metadata: { framework: 'langchain' },\n    };\n    emitAudit(vorim, event, asyncAudit);\n\n    return result;\n  };\n\n  return tool;\n}\n\n/**\n * Wraps an array of LangChain tools with Vorim permission + audit.\n */\nexport function wrapTools<T extends LangChainTool>(\n  tools: T[],\n  config: VorimLangChainConfig,\n): T[] {\n  return tools.map(t => wrapTool(t, config));\n}\n\n// ─── Callback Handler ─────────────────────────────────────────────────────\n\n/**\n * LangChain callback handler that emits Vorim audit events for every\n * tool invocation. This is a **non-intrusive** observability layer —\n * it does not block or modify tool execution.\n *\n * Attach it to any LangChain invoke/stream call:\n * ```ts\n * const handler = new VorimCallbackHandler(vorim, \"agid_acme_a1b2c3d4\");\n * await agent.invoke({ messages }, { callbacks: [handler] });\n * ```\n */\nexport class VorimCallbackHandler {\n  name = 'VorimCallbackHandler';\n  private vorim: VorimSDK;\n  private agentId: string;\n  private runMap = new Map<string, { tool: string; input: string; startTime: number }>();\n\n  // Flags to satisfy BaseCallbackHandler interface\n  ignoreLLM = true;\n  ignoreChain = true;\n  ignoreAgent = true;\n  ignoreRetriever = true;\n  ignoreCustomEvent = true;\n  lc_serializable = false;\n\n  get lc_id(): string[] { return ['vorim', 'callbacks', 'VorimCallbackHandler']; }\n  get lc_namespace(): string[] { return ['vorim', 'callbacks']; }\n\n  constructor(vorim: VorimSDK, agentId: string) {\n    this.vorim = vorim;\n    this.agentId = agentId;\n  }\n\n  async handleToolStart(\n    tool: Serialized,\n    input: string,\n    runId: string,\n    _parentRunId?: string,\n    _tags?: string[],\n    _metadata?: Record<string, unknown>,\n    runName?: string,\n  ): Promise<void> {\n    const toolName = runName ?? tool.id?.[tool.id.length - 1] ?? 'unknown';\n    this.runMap.set(runId, { tool: toolName, input, startTime: Date.now() });\n  }\n\n  async handleToolEnd(\n    _output: unknown,\n    runId: string,\n  ): Promise<void> {\n    const run = this.runMap.get(runId);\n    if (!run) return;\n    this.runMap.delete(runId);\n\n    await this.vorim.emit({\n      agent_id: this.agentId,\n      event_type: 'tool_call',\n      action: run.tool,\n      resource: truncate(run.input, 500),\n      result: 'success',\n      latency_ms: Date.now() - run.startTime,\n      metadata: { framework: 'langchain' },\n    }).catch(() => {}); // never throw from callback\n  }\n\n  async handleToolError(\n    err: Error,\n    runId: string,\n  ): Promise<void> {\n    const run = this.runMap.get(runId);\n    if (!run) return;\n    this.runMap.delete(runId);\n\n    await this.vorim.emit({\n      agent_id: this.agentId,\n      event_type: 'tool_call',\n      action: run.tool,\n      resource: truncate(run.input, 500),\n      result: 'error',\n      latency_ms: Date.now() - run.startTime,\n      error_code: err.name,\n      metadata: { error: err.message, framework: 'langchain' },\n    }).catch(() => {});\n  }\n\n  // Required by BaseCallbackHandler — no-op for events we don't need\n  copy(): VorimCallbackHandler {\n    return new VorimCallbackHandler(this.vorim, this.agentId);\n  }\n\n  toJSON() {\n    return { lc: 1, type: 'not_implemented', id: this.lc_id };\n  }\n\n  toJSONNotImplemented() {\n    return this.toJSON();\n  }\n}\n\n// ─── Agent Factory ────────────────────────────────────────────────────────\n\nexport interface CreateVorimAgentConfig extends VorimLangChainConfig {\n  /** Display name for the agent when registering with Vorim. */\n  name: string;\n  /** Agent capabilities (e.g. [\"web_search\", \"code_execution\"]). */\n  capabilities: string[];\n  /** Initial permission scopes to grant. */\n  scopes: PermissionScope[];\n  /** Optional description. */\n  description?: string;\n}\n\n/**\n * Registers a new agent with Vorim and returns wrapped tools + callback handler\n * ready to use with `createReactAgent` or any LangChain agent.\n *\n * @example\n * ```ts\n * import { createReactAgent } from \"@langchain/langgraph/prebuilt\";\n * import { ChatOpenAI } from \"@langchain/openai\";\n * import { createVorimAgent } from \"@vorim/sdk/integrations/langchain\";\n *\n * const { agentId, tools, callbackHandler } = await createVorimAgent({\n *   vorim,\n *   name: \"research-agent\",\n *   capabilities: [\"web_search\"],\n *   scopes: [\"agent:read\", \"agent:execute\"],\n *   tools: [searchTool, analysisTool],\n * });\n *\n * const agent = createReactAgent({\n *   llm: new ChatOpenAI({ model: \"gpt-4o\" }),\n *   tools,\n * });\n *\n * const result = await agent.invoke(\n *   { messages: [{ role: \"user\", content: \"Research AI trends\" }] },\n *   { callbacks: [callbackHandler] },\n * );\n * ```\n */\nexport async function createVorimAgent<T extends LangChainTool>(config: CreateVorimAgentConfig & { tools: T[] }) {\n  const { vorim, name, capabilities, scopes, description, tools: rawTools, permissionMap, defaultPermission, asyncAudit } = config;\n\n  // Register agent with Vorim\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 agentConfig: VorimLangChainConfig = { vorim, agentId, permissionMap, defaultPermission, asyncAudit };\n\n  // Wrap tools with permission checks\n  const tools = wrapTools(rawTools, agentConfig);\n\n  // Create callback handler for audit trail\n  const callbackHandler = new VorimCallbackHandler(vorim, agentId);\n\n  return {\n    /** The Vorim agent_id. */\n    agentId,\n    /** The full agent registration result. */\n    registration,\n    /** Tools wrapped with Vorim permission checks + audit. */\n    tools,\n    /** Callback handler for audit trail observability. */\n    callbackHandler,\n    /** The private key (store securely — shown once). */\n    privateKey: registration.private_key,\n  };\n}\n\n// ─── Internal helpers ─────────────────────────────────────────────────────\n\n/** Minimal interface matching any LangChain StructuredTool / DynamicStructuredTool. */\ninterface LangChainTool {\n  name: string;\n  description: string;\n  schema: unknown;\n  _call(arg: any, runManager?: any, parentConfig?: any): Promise<any>;\n}\n\nfunction truncate(str: string, max: number): string {\n  return str.length > max ? str.slice(0, max) + '…' : str;\n}\n\nfunction emitAudit(vorim: VorimSDK, event: AuditEventInput, async: boolean): void {\n  if (async) {\n    vorim.emit(event).catch(() => {});\n  } else {\n    vorim.emit(event).catch(() => {});\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4DO,SAAS,SACd,MACA,QACG;AACH,QAAM,EAAE,OAAO,SAAS,gBAAgB,CAAC,GAAG,oBAAoB,iBAAiB,aAAa,KAAK,IAAI;AAEvG,QAAM,eAAe,KAAK,MAAM,KAAK,IAAI;AAGzC,EAAC,KAAa,QAAQ,eAAe,iBACnC,KACA,YACA,cACkB;AAClB,UAAM,QAAQ,cAAc,KAAK,IAAI,KAAK;AAG1C,UAAM,EAAE,SAAS,OAAO,IAAI,MAAM,MAAM,MAAM,SAAS,KAAK;AAE5D,QAAI,CAAC,SAAS;AACZ,YAAMA,SAAyB;AAAA,QAC7B,UAAU;AAAA,QACV,YAAY;AAAA,QACZ,QAAQ,KAAK;AAAA,QACb,UAAU,SAAS,KAAK,UAAU,GAAG,GAAG,GAAG;AAAA,QAC3C,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,UAAU,EAAE,QAAQ,WAAW,YAAY;AAAA,MAC7C;AACA,gBAAU,OAAOA,QAAO,UAAU;AAClC,YAAM,IAAI,MAAM,iCAAiC,KAAK,IAAI,mBAAc,KAAK,IAAI,SAAS,KAAK,MAAM,KAAK,EAAE,EAAE;AAAA,IAChH;AAGA,UAAM,QAAQ,KAAK,IAAI;AACvB,QAAI;AACJ,QAAI;AACF,eAAS,MAAM,aAAa,KAAK,YAAY,YAAY;AAAA,IAC3D,SAAS,KAAK;AACZ,YAAMA,SAAyB;AAAA,QAC7B,UAAU;AAAA,QACV,YAAY;AAAA,QACZ,QAAQ,KAAK;AAAA,QACb,UAAU,SAAS,KAAK,UAAU,GAAG,GAAG,GAAG;AAAA,QAC3C,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,YAAY,KAAK,IAAI,IAAI;AAAA,QACzB,YAAY,eAAe,QAAQ,IAAI,OAAO;AAAA,QAC9C,UAAU,EAAE,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,GAAG,WAAW,YAAY;AAAA,MAC9F;AACA,gBAAU,OAAOA,QAAO,UAAU;AAClC,YAAM;AAAA,IACR;AAGA,UAAM,QAAyB;AAAA,MAC7B,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,QAAQ,KAAK;AAAA,MACb,UAAU,SAAS,KAAK,UAAU,GAAG,GAAG,GAAG;AAAA,MAC3C,YAAY;AAAA,MACZ,QAAQ;AAAA,MACR,YAAY,KAAK,IAAI,IAAI;AAAA,MACzB,UAAU,EAAE,WAAW,YAAY;AAAA,IACrC;AACA,cAAU,OAAO,OAAO,UAAU;AAElC,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAKO,SAAS,UACd,OACA,QACK;AACL,SAAO,MAAM,IAAI,OAAK,SAAS,GAAG,MAAM,CAAC;AAC3C;AAeO,IAAM,uBAAN,MAAM,sBAAqB;AAAA,EAChC,OAAO;AAAA,EACC;AAAA,EACA;AAAA,EACA,SAAS,oBAAI,IAAgE;AAAA;AAAA,EAGrF,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,cAAc;AAAA,EACd,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,kBAAkB;AAAA,EAElB,IAAI,QAAkB;AAAE,WAAO,CAAC,SAAS,aAAa,sBAAsB;AAAA,EAAG;AAAA,EAC/E,IAAI,eAAyB;AAAE,WAAO,CAAC,SAAS,WAAW;AAAA,EAAG;AAAA,EAE9D,YAAY,OAAiB,SAAiB;AAC5C,SAAK,QAAQ;AACb,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,MAAM,gBACJ,MACA,OACA,OACA,cACA,OACA,WACA,SACe;AACf,UAAM,WAAW,WAAW,KAAK,KAAK,KAAK,GAAG,SAAS,CAAC,KAAK;AAC7D,SAAK,OAAO,IAAI,OAAO,EAAE,MAAM,UAAU,OAAO,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EACzE;AAAA,EAEA,MAAM,cACJ,SACA,OACe;AACf,UAAM,MAAM,KAAK,OAAO,IAAI,KAAK;AACjC,QAAI,CAAC,IAAK;AACV,SAAK,OAAO,OAAO,KAAK;AAExB,UAAM,KAAK,MAAM,KAAK;AAAA,MACpB,UAAU,KAAK;AAAA,MACf,YAAY;AAAA,MACZ,QAAQ,IAAI;AAAA,MACZ,UAAU,SAAS,IAAI,OAAO,GAAG;AAAA,MACjC,QAAQ;AAAA,MACR,YAAY,KAAK,IAAI,IAAI,IAAI;AAAA,MAC7B,UAAU,EAAE,WAAW,YAAY;AAAA,IACrC,CAAC,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EACnB;AAAA,EAEA,MAAM,gBACJ,KACA,OACe;AACf,UAAM,MAAM,KAAK,OAAO,IAAI,KAAK;AACjC,QAAI,CAAC,IAAK;AACV,SAAK,OAAO,OAAO,KAAK;AAExB,UAAM,KAAK,MAAM,KAAK;AAAA,MACpB,UAAU,KAAK;AAAA,MACf,YAAY;AAAA,MACZ,QAAQ,IAAI;AAAA,MACZ,UAAU,SAAS,IAAI,OAAO,GAAG;AAAA,MACjC,QAAQ;AAAA,MACR,YAAY,KAAK,IAAI,IAAI,IAAI;AAAA,MAC7B,YAAY,IAAI;AAAA,MAChB,UAAU,EAAE,OAAO,IAAI,SAAS,WAAW,YAAY;AAAA,IACzD,CAAC,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EACnB;AAAA;AAAA,EAGA,OAA6B;AAC3B,WAAO,IAAI,sBAAqB,KAAK,OAAO,KAAK,OAAO;AAAA,EAC1D;AAAA,EAEA,SAAS;AACP,WAAO,EAAE,IAAI,GAAG,MAAM,mBAAmB,IAAI,KAAK,MAAM;AAAA,EAC1D;AAAA,EAEA,uBAAuB;AACrB,WAAO,KAAK,OAAO;AAAA,EACrB;AACF;AA4CA,eAAsB,iBAA0C,QAAiD;AAC/G,QAAM,EAAE,OAAO,MAAM,cAAc,QAAQ,aAAa,OAAO,UAAU,eAAe,mBAAmB,WAAW,IAAI;AAG1H,QAAM,eAAe,MAAM,MAAM,SAAS;AAAA,IACxC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,UAAU,aAAa,MAAM;AACnC,QAAM,cAAoC,EAAE,OAAO,SAAS,eAAe,mBAAmB,WAAW;AAGzG,QAAM,QAAQ,UAAU,UAAU,WAAW;AAG7C,QAAM,kBAAkB,IAAI,qBAAqB,OAAO,OAAO;AAE/D,SAAO;AAAA;AAAA,IAEL;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA,YAAY,aAAa;AAAA,EAC3B;AACF;AAYA,SAAS,SAAS,KAAa,KAAqB;AAClD,SAAO,IAAI,SAAS,MAAM,IAAI,MAAM,GAAG,GAAG,IAAI,WAAM;AACtD;AAEA,SAAS,UAAU,OAAiB,OAAwB,OAAsB;AAChF,MAAI,OAAO;AACT,UAAM,KAAK,KAAK,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EAClC,OAAO;AACL,UAAM,KAAK,KAAK,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EAClC;AACF;","names":["event"]}
+{"version":3,"sources":["../../src/integrations/langchain.ts","../../src/replay.ts"],"sourcesContent":["// ============================================================================\n// VORIM SDK — LangChain / LangGraph JS Integration\n// Provides tool wrapping with permission checks + audit trail,\n// a callback handler for observability, and a factory for creating\n// Vorim-secured LangGraph ReAct agents.\n//\n// Peer dependencies:\n//   @langchain/core >=0.3.0\n//   @langchain/langgraph >=0.2.0\n// ============================================================================\n\nimport type { VorimSDK } from '../index.js';\nimport type { PermissionScope, AuditEventInput } from '../types.js';\nimport {\n  prepareReplayContext,\n  type ReplayInputs,\n  type ReplayContext,\n  type CatalogueTool,\n} from '../replay.js';\n\n// ─── Re-declared LangChain types (peer dependency — not bundled) ──────────\n// These mirror the actual types from @langchain/core so consumers don't\n// need to import them separately for basic usage.\n\n/** Minimal subset of @langchain/core Serialized */\ninterface Serialized {\n  lc: number;\n  type: string;\n  id: string[];\n  kwargs?: Record<string, unknown>;\n}\n\n// ─── Configuration ────────────────────────────────────────────────────────\n\nexport interface VorimLangChainConfig {\n  /** Vorim SDK instance. */\n  vorim: VorimSDK;\n  /** The Vorim agent_id to associate with this LangChain agent. */\n  agentId: string;\n  /** Map tool names → Vorim permission scopes. Unmapped tools default to 'agent:execute'. */\n  permissionMap?: Record<string, PermissionScope>;\n  /** Default permission scope for tools not in permissionMap. @default 'agent:execute' */\n  defaultPermission?: PermissionScope;\n  /** Whether to emit audit events asynchronously (fire-and-forget). @default true */\n  asyncAudit?: boolean;\n  /**\n   * Replayable agent decision evidence (VAIP -02). When provided, the\n   * hashes of the model version, tool catalogue, and system prompt are\n   * attached to every emitted audit event so an auditor can later\n   * reproduce the agent's decision context.\n   *\n   * Hashes are computed once on first emit and cached for subsequent\n   * emits in this config's lifetime.\n   *\n   * These fields are NOT covered by the v0 canonical signature form;\n   * advisory only until v1 (RFC 8785 JCS) lands.\n   */\n  replay?: ReplayInputs;\n}\n\n// ─── Tool Wrapper ─────────────────────────────────────────────────────────\n\n/**\n * Wraps a LangChain `StructuredTool` (or `DynamicStructuredTool`) with\n * Vorim permission checks before execution and audit event emission after.\n *\n * Works with any tool that has `name`, `description`, `schema`, and `_call`.\n *\n * @example\n * ```ts\n * import { DynamicStructuredTool } from \"@langchain/core/tools\";\n * import { wrapTool } from \"@vorim/sdk/integrations/langchain\";\n *\n * const guarded = wrapTool(myTool, {\n *   vorim, agentId: \"agid_acme_a1b2c3d4\",\n *   permissionMap: { search_docs: \"agent:read\" },\n * });\n * ```\n */\nexport function wrapTool<T extends LangChainTool>(\n  tool: T,\n  config: VorimLangChainConfig,\n): T {\n  const { vorim, agentId, permissionMap = {}, defaultPermission = 'agent:execute', asyncAudit = true, replay } = config;\n\n  const originalCall = tool._call.bind(tool);\n  const getReplayCtx = makeReplayContextGetter(replay);\n\n  // Override _call to inject permission check + audit\n  (tool as any)._call = async function vorimGuardedCall(\n    arg: unknown,\n    runManager?: unknown,\n    parentConfig?: unknown,\n  ): Promise<unknown> {\n    const scope = permissionMap[tool.name] ?? defaultPermission;\n\n    // 1. Permission check\n    const { allowed, reason } = await vorim.check(agentId, scope);\n    const replayCtx = await getReplayCtx();\n\n    if (!allowed) {\n      const event: AuditEventInput = {\n        agent_id: agentId,\n        event_type: 'tool_call',\n        action: tool.name,\n        resource: truncate(JSON.stringify(arg), 500),\n        permission: scope,\n        result: 'denied',\n        metadata: { reason, framework: 'langchain' },\n        ...replayCtx,\n      };\n      emitAudit(vorim, event, asyncAudit);\n      throw new Error(`Vorim: permission denied for \"${tool.name}\" — scope \"${scope}\"${reason ? `: ${reason}` : ''}`);\n    }\n\n    // 2. Execute the original tool\n    const start = Date.now();\n    let result: unknown;\n    try {\n      result = await originalCall(arg, runManager, parentConfig);\n    } catch (err) {\n      const event: AuditEventInput = {\n        agent_id: agentId,\n        event_type: 'tool_call',\n        action: tool.name,\n        resource: truncate(JSON.stringify(arg), 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: err instanceof Error ? err.message : String(err), framework: 'langchain' },\n        ...replayCtx,\n      };\n      emitAudit(vorim, event, asyncAudit);\n      throw err;\n    }\n\n    // 3. Audit success\n    const event: AuditEventInput = {\n      agent_id: agentId,\n      event_type: 'tool_call',\n      action: tool.name,\n      resource: truncate(JSON.stringify(arg), 500),\n      permission: scope,\n      result: 'success',\n      latency_ms: Date.now() - start,\n      metadata: { framework: 'langchain' },\n      ...replayCtx,\n    };\n    emitAudit(vorim, event, asyncAudit);\n\n    return result;\n  };\n\n  return tool;\n}\n\n/**\n * Lazy-cached replay context getter. The hashes are computed once on\n * first call and reused for subsequent calls in this closure's lifetime.\n * Returns an empty object when no `replay` config was provided so the\n * spread is a no-op.\n */\nfunction makeReplayContextGetter(replay: ReplayInputs | undefined): () => Promise<ReplayContext> {\n  if (!replay) return async () => ({});\n  let cached: Promise<ReplayContext> | null = null;\n  return () => {\n    if (!cached) cached = prepareReplayContext(replay);\n    return cached;\n  };\n}\n\n/**\n * Wraps an array of LangChain tools with Vorim permission + audit.\n */\nexport function wrapTools<T extends LangChainTool>(\n  tools: T[],\n  config: VorimLangChainConfig,\n): T[] {\n  return tools.map(t => wrapTool(t, config));\n}\n\n// ─── Callback Handler ─────────────────────────────────────────────────────\n\n/**\n * LangChain callback handler that emits Vorim audit events for every\n * tool invocation. This is a **non-intrusive** observability layer —\n * it does not block or modify tool execution.\n *\n * Attach it to any LangChain invoke/stream call:\n * ```ts\n * const handler = new VorimCallbackHandler(vorim, \"agid_acme_a1b2c3d4\");\n * await agent.invoke({ messages }, { callbacks: [handler] });\n * ```\n */\nexport class VorimCallbackHandler {\n  name = 'VorimCallbackHandler';\n  private vorim: VorimSDK;\n  private agentId: string;\n  private runMap = new Map<string, { tool: string; input: string; startTime: number }>();\n  private getReplayCtx: () => Promise<ReplayContext>;\n\n  // Flags to satisfy BaseCallbackHandler interface\n  ignoreLLM = true;\n  ignoreChain = true;\n  ignoreAgent = true;\n  ignoreRetriever = true;\n  ignoreCustomEvent = true;\n  lc_serializable = false;\n\n  get lc_id(): string[] { return ['vorim', 'callbacks', 'VorimCallbackHandler']; }\n  get lc_namespace(): string[] { return ['vorim', 'callbacks']; }\n\n  /**\n   * @param vorim Vorim SDK instance.\n   * @param agentId The Vorim agent_id whose actions this callback audits.\n   * @param replay Optional replayable-evidence inputs. Same shape as\n   *               {@link VorimLangChainConfig.replay}; hashes are\n   *               computed once and attached to every audit event.\n   */\n  constructor(vorim: VorimSDK, agentId: string, replay?: ReplayInputs) {\n    this.vorim = vorim;\n    this.agentId = agentId;\n    this.getReplayCtx = makeReplayContextGetter(replay);\n  }\n\n  async handleToolStart(\n    tool: Serialized,\n    input: string,\n    runId: string,\n    _parentRunId?: string,\n    _tags?: string[],\n    _metadata?: Record<string, unknown>,\n    runName?: string,\n  ): Promise<void> {\n    const toolName = runName ?? tool.id?.[tool.id.length - 1] ?? 'unknown';\n    this.runMap.set(runId, { tool: toolName, input, startTime: Date.now() });\n  }\n\n  async handleToolEnd(\n    _output: unknown,\n    runId: string,\n  ): Promise<void> {\n    const run = this.runMap.get(runId);\n    if (!run) return;\n    this.runMap.delete(runId);\n    const replayCtx = await this.getReplayCtx();\n\n    await this.vorim.emit({\n      agent_id: this.agentId,\n      event_type: 'tool_call',\n      action: run.tool,\n      resource: truncate(run.input, 500),\n      result: 'success',\n      latency_ms: Date.now() - run.startTime,\n      metadata: { framework: 'langchain' },\n      ...replayCtx,\n    }).catch(() => {}); // never throw from callback\n  }\n\n  async handleToolError(\n    err: Error,\n    runId: string,\n  ): Promise<void> {\n    const run = this.runMap.get(runId);\n    if (!run) return;\n    this.runMap.delete(runId);\n    const replayCtx = await this.getReplayCtx();\n\n    await this.vorim.emit({\n      agent_id: this.agentId,\n      event_type: 'tool_call',\n      action: run.tool,\n      resource: truncate(run.input, 500),\n      result: 'error',\n      latency_ms: Date.now() - run.startTime,\n      error_code: err.name,\n      metadata: { error: err.message, framework: 'langchain' },\n      ...replayCtx,\n    }).catch(() => {});\n  }\n\n  // Required by BaseCallbackHandler — no-op for events we don't need\n  copy(): VorimCallbackHandler {\n    return new VorimCallbackHandler(this.vorim, this.agentId);\n  }\n\n  toJSON() {\n    return { lc: 1, type: 'not_implemented', id: this.lc_id };\n  }\n\n  toJSONNotImplemented() {\n    return this.toJSON();\n  }\n}\n\n// ─── Agent Factory ────────────────────────────────────────────────────────\n\nexport interface CreateVorimAgentConfig extends VorimLangChainConfig {\n  /** Display name for the agent when registering with Vorim. */\n  name: string;\n  /** Agent capabilities (e.g. [\"web_search\", \"code_execution\"]). */\n  capabilities: string[];\n  /** Initial permission scopes to grant. */\n  scopes: PermissionScope[];\n  /** Optional description. */\n  description?: string;\n}\n\n/**\n * Registers a new agent with Vorim and returns wrapped tools + callback handler\n * ready to use with `createReactAgent` or any LangChain agent.\n *\n * @example\n * ```ts\n * import { createReactAgent } from \"@langchain/langgraph/prebuilt\";\n * import { ChatOpenAI } from \"@langchain/openai\";\n * import { createVorimAgent } from \"@vorim/sdk/integrations/langchain\";\n *\n * const { agentId, tools, callbackHandler } = await createVorimAgent({\n *   vorim,\n *   name: \"research-agent\",\n *   capabilities: [\"web_search\"],\n *   scopes: [\"agent:read\", \"agent:execute\"],\n *   tools: [searchTool, analysisTool],\n * });\n *\n * const agent = createReactAgent({\n *   llm: new ChatOpenAI({ model: \"gpt-4o\" }),\n *   tools,\n * });\n *\n * const result = await agent.invoke(\n *   { messages: [{ role: \"user\", content: \"Research AI trends\" }] },\n *   { callbacks: [callbackHandler] },\n * );\n * ```\n */\nexport async function createVorimAgent<T extends LangChainTool>(config: CreateVorimAgentConfig & { tools: T[] }) {\n  const { vorim, name, capabilities, scopes, description, tools: rawTools, permissionMap, defaultPermission, asyncAudit, replay } = config;\n\n  // Register agent with Vorim\n  const registration = await vorim.register({\n    name,\n    description,\n    capabilities,\n    scopes,\n  });\n\n  const agentId = registration.agent.agent_id;\n\n  // If the caller passed `replay.tools`, use those. Otherwise derive a\n  // tool catalogue from the rawTools we're about to wrap so the\n  // replayable-evidence story works automatically.\n  const derivedReplay: ReplayInputs | undefined = replay\n    ? { ...replay, tools: replay.tools ?? deriveCatalogueFromLangChainTools(rawTools) }\n    : { tools: deriveCatalogueFromLangChainTools(rawTools) };\n\n  const agentConfig: VorimLangChainConfig = {\n    vorim, agentId, permissionMap, defaultPermission, asyncAudit, replay: derivedReplay,\n  };\n\n  // Wrap tools with permission checks\n  const tools = wrapTools(rawTools, agentConfig);\n\n  // Create callback handler for audit trail\n  const callbackHandler = new VorimCallbackHandler(vorim, agentId, derivedReplay);\n\n  return {\n    /** The Vorim agent_id. */\n    agentId,\n    /** The full agent registration result. */\n    registration,\n    /** Tools wrapped with Vorim permission checks + audit. */\n    tools,\n    /** Callback handler for audit trail observability. */\n    callbackHandler,\n    /** The private key (store securely — shown once). */\n    privateKey: registration.private_key,\n  };\n}\n\n// ─── Internal helpers ─────────────────────────────────────────────────────\n\n/** Minimal interface matching any LangChain StructuredTool / DynamicStructuredTool. */\ninterface LangChainTool {\n  name: string;\n  description: string;\n  schema: unknown;\n  _call(arg: any, runManager?: any, parentConfig?: any): Promise<any>;\n}\n\nfunction truncate(str: string, max: number): string {\n  return str.length > max ? str.slice(0, max) + '…' : str;\n}\n\nfunction emitAudit(vorim: VorimSDK, event: AuditEventInput, async: boolean): void {\n  if (async) {\n    vorim.emit(event).catch(() => {});\n  } else {\n    vorim.emit(event).catch(() => {});\n  }\n}\n\n/**\n * Convert LangChain tools to the catalogue shape used by hashToolCatalogue.\n * Best-effort: LangChain tool schemas can be Zod or plain JSON Schema.\n * If we can't get a serialisable shape, we fall back to `null` schema\n * which the hashing treats as `{}`.\n */\nfunction deriveCatalogueFromLangChainTools(tools: LangChainTool[]): CatalogueTool[] {\n  return tools.map(t => {\n    let schema: Record<string, unknown> | null = null;\n    const raw = t.schema as unknown;\n    if (raw && typeof raw === 'object') {\n      // If it's already plain JSON-serialisable, use it. Otherwise null.\n      try {\n        schema = JSON.parse(JSON.stringify(raw));\n      } catch {\n        schema = null;\n      }\n    }\n    return {\n      name: t.name,\n      description: t.description ?? '',\n      schema,\n    };\n  });\n}\n","/**\n * Replayable agent decision evidence helpers.\n *\n * Canonical-form hashing for the VAIP -02 schema fields that the SDK\n * attaches to audit events. The hashes recorded in audit_events.tool_catalogue_hash\n * and audit_events.system_prompt_hash use these functions, so the bytes\n * an auditor or counterparty reconstructs must match what the SDK produced.\n *\n * These helpers are intentionally separate from the signing path. The\n * v0 canonical signature form (event_type|action|resource|input_hash|\n * output_hash|result) does NOT cover model_version, tool_catalogue_hash,\n * or system_prompt_hash. They will enter the canonical bytes in v1\n * (RFC 8785 JCS) in a follow-up release.\n *\n * Stable across SDK versions: the canonical-form version is documented\n * in CANONICAL_TOOL_CATALOGUE_VERSION. Future changes get a v2 etc;\n * never edit the existing v1 logic, or already-recorded hashes lose\n * their meaning.\n */\n\n// ─── Versioning ───────────────────────────────────────────────────────────\n\n/**\n * Canonical-form version for tool catalogue hashes produced by this SDK.\n * Recorded in tool_catalogue_canon_version on the event metadata (when\n * the metadata field is used) so verifiers know which hash recipe to\n * reproduce. Increment ONLY if the algorithm changes in a way that\n * would change the hash for the same logical catalogue.\n */\nexport const CANONICAL_TOOL_CATALOGUE_VERSION = 'v1' as const;\n\n// ─── Types ────────────────────────────────────────────────────────────────\n\n/**\n * Minimum shape a tool needs for catalogue hashing. The framework\n * integrations adapt their native tool objects to this shape before\n * calling hashToolCatalogue.\n */\nexport interface CatalogueTool {\n  /** The name the model sees and calls. Required. */\n  name: string;\n  /** Human-readable description shown to the model. Optional; absent ↔ empty string. */\n  description?: string;\n  /**\n   * JSON Schema describing the tool's input parameters. Optional;\n   * absent ↔ empty object `{}`. The schema gets RFC 8785 JCS-canonicalised\n   * before hashing so semantically-equivalent variations (key order,\n   * whitespace) produce the same hash.\n   */\n  schema?: Record<string, unknown> | null;\n}\n\n// ─── RFC 8785 JCS subset ──────────────────────────────────────────────────\n\n/**\n * RFC 8785 JSON Canonicalization Scheme, sufficient subset for tool\n * catalogue values.\n *\n * Rules:\n *  - Object keys sorted lexicographically by UTF-16 code units (which\n *    is what JS string comparison does naturally).\n *  - No whitespace between tokens.\n *  - Numbers: integers as integers, finite floats per ECMAScript\n *    Number.prototype.toString. JCS forbids NaN and Infinity.\n *  - Strings: JSON-escape using minimal set per RFC 8259 § 7.\n *  - null, true, false, arrays: as JSON.stringify produces them, since\n *    JSON.stringify already produces the canonical form for these.\n *\n * Not vendoring a full library because tool schemas don't carry\n * non-integer numbers in practice and the JS spec for Number.toString\n * happens to coincide with JCS § 3.2.2.2 for the integer case.\n */\nexport function jcsCanonicalise(value: unknown): string {\n  if (value === null) return 'null';\n  if (value === true) return 'true';\n  if (value === false) return 'false';\n\n  if (typeof value === 'number') {\n    if (!Number.isFinite(value)) {\n      throw new Error('jcsCanonicalise: NaN and Infinity are not JCS-valid');\n    }\n    // For integers in safe range, .toString() matches JCS. For\n    // non-integer floats, .toString() also matches in modern JS\n    // engines (V8, JavaScriptCore, SpiderMonkey all use the shortest\n    // round-trip representation, which is what JCS § 3.2.2.2 requires).\n    return value.toString();\n  }\n\n  if (typeof value === 'string') {\n    return JSON.stringify(value);\n  }\n\n  if (Array.isArray(value)) {\n    return '[' + value.map(jcsCanonicalise).join(',') + ']';\n  }\n\n  if (typeof value === 'object') {\n    const keys = Object.keys(value as Record<string, unknown>).sort();\n    const parts = keys.map(k => {\n      return JSON.stringify(k) + ':' + jcsCanonicalise((value as Record<string, unknown>)[k]);\n    });\n    return '{' + parts.join(',') + '}';\n  }\n\n  // undefined, function, symbol, bigint — not JSON-representable\n  throw new Error(`jcsCanonicalise: unsupported value type: ${typeof value}`);\n}\n\n// ─── SHA-256 ──────────────────────────────────────────────────────────────\n\nasync function sha256Hex(input: string | Uint8Array): Promise<string> {\n  const bytes = typeof input === 'string' ? new TextEncoder().encode(input) : input;\n\n  // Node.js Web Crypto (Node 18+) supports digest. Browser Web Crypto does too.\n  // Fall back to node:crypto if Web Crypto is unavailable.\n  const subtle = (globalThis as any).crypto?.subtle;\n  if (subtle) {\n    const buf = await subtle.digest('SHA-256', bytes);\n    return Array.from(new Uint8Array(buf))\n      .map(b => b.toString(16).padStart(2, '0'))\n      .join('');\n  }\n\n  // Node fallback\n  const nodeCrypto = await import('node:crypto');\n  return nodeCrypto.createHash('sha256').update(bytes).digest('hex');\n}\n\n// ─── Public API ───────────────────────────────────────────────────────────\n\n/**\n * Hash a single tool definition. Returns `sha256:<hex>`.\n *\n * Canonical form (v1):\n *   JCS-canonicalised JSON of `{name, description, schema}` where\n *   absent fields substitute `description: \"\"` and `schema: {}`.\n */\nexport async function hashTool(tool: CatalogueTool): Promise<string> {\n  const normalised = {\n    name: tool.name,\n    description: tool.description ?? '',\n    schema: tool.schema ?? {},\n  };\n  const hex = await sha256Hex(jcsCanonicalise(normalised));\n  return `sha256:${hex}`;\n}\n\n/**\n * Hash an entire tool catalogue. Returns `sha256:<hex>`.\n *\n * Reordering tools does NOT change the hash (tool hashes sorted\n * lexicographically before concatenation). Adding, removing, or\n * modifying a tool DOES change the hash.\n *\n * Per-tool hashing first means a verifier comparing two catalogue\n * hashes that differ can also be given the per-tool hashes to\n * identify which specific tool changed.\n */\nexport async function hashToolCatalogue(tools: CatalogueTool[]): Promise<string> {\n  if (tools.length === 0) {\n    // Empty catalogue has a deterministic, stable hash distinct from \"no field\"\n    return `sha256:${await sha256Hex('[]')}`;\n  }\n  const perTool = await Promise.all(tools.map(hashTool));\n  perTool.sort();\n  const hex = await sha256Hex(perTool.join(''));\n  return `sha256:${hex}`;\n}\n\n/**\n * Hash a system prompt. Returns `sha256:<hex>`.\n *\n * The prompt is UTF-8 encoded and hashed verbatim — no normalisation.\n * If a caller wants to ignore whitespace or comment differences, they\n * should normalise before calling. The intent here is deterministic\n * reproducibility, not semantic equivalence.\n */\nexport async function hashSystemPrompt(prompt: string): Promise<string> {\n  const hex = await sha256Hex(prompt);\n  return `sha256:${hex}`;\n}\n\n/**\n * Convenience: hash the previous event's canonical bytes for use in\n * the prev_event_hash field of hash-chained ingest. Caller provides\n * the canonical bytes (use canonicalPayloadV0 from the main module).\n */\nexport async function hashPreviousEvent(canonicalBytes: string): Promise<string> {\n  const hex = await sha256Hex(canonicalBytes);\n  return `sha256:${hex}`;\n}\n\n// ─── Replay context — framework integration helper ────────────────────────\n\n/**\n * Raw inputs the integration captures from the framework. Set by the\n * integration's config; turned into hashes by {@link prepareReplayContext}.\n */\nexport interface ReplayInputs {\n  /** Stable identifier for the model. E.g. `\"anthropic:claude-opus-4-8\"`. */\n  modelVersion?: string;\n  /** Tools available to the agent at call time. Hashed via {@link hashToolCatalogue}. */\n  tools?: CatalogueTool[];\n  /** System prompt active at call time. Hashed via {@link hashSystemPrompt}. */\n  systemPrompt?: string;\n}\n\n/**\n * Pre-computed hashes ready to attach to audit events. The three keys\n * match the audit_events column names.\n */\nexport interface ReplayContext {\n  model_version?: string;\n  tool_catalogue_hash?: string;\n  system_prompt_hash?: string;\n}\n\n/**\n * Compute replay context once from raw inputs. Use at integration\n * setup time so each emit can attach the hashes without re-hashing.\n *\n * Returns an object suitable for spreading into an AuditEventInput:\n *   `await vorim.emit({ ...event, ...replayContext })`\n *\n * If a field is absent in the inputs, it is absent in the result\n * (not the empty string). That keeps the event lean.\n */\nexport async function prepareReplayContext(\n  inputs: ReplayInputs,\n): Promise<ReplayContext> {\n  const ctx: ReplayContext = {};\n  if (inputs.modelVersion) ctx.model_version = inputs.modelVersion;\n  if (inputs.tools) ctx.tool_catalogue_hash = await hashToolCatalogue(inputs.tools);\n  if (inputs.systemPrompt) ctx.system_prompt_hash = await hashSystemPrompt(inputs.systemPrompt);\n  return ctx;\n}\n"],"mappings":"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","names":["event"]}