@astrasyncai/verification-gateway 3.5.0 → 3.7.0

package/dist/claude-code/claude-code-adapter.mjs

@@ -0,0 +1,249 @@
+// src/adapter-interface/interface.ts
+var ADAPTER_INTERFACE_VERSION = 1;
+
+// src/adapter-interface/purpose-mapping.ts
+var TOOL_PURPOSE_MAP = {
+  // Shell
+  shell_exec: "shell.exec",
+  run_command: "shell.exec",
+  execute: "shell.exec",
+  terminal_exec: "shell.exec",
+  run_terminal_command: "shell.exec",
+  // File read
+  file_read: "file.read",
+  read_file: "file.read",
+  // File write
+  file_write: "file.write",
+  write_file: "file.write",
+  create_file: "file.write",
+  edit_file: "file.write",
+  // File delete
+  file_delete: "file.delete",
+  delete_file: "file.delete",
+  // Network
+  http_request: "network.request",
+  fetch: "network.request",
+  web_request: "network.request",
+  // Email
+  send_email: "email.send",
+  read_email: "email.read",
+  // Calendar
+  create_event: "calendar.create",
+  // Database
+  query_database: "database.query",
+  write_database: "database.write",
+  // Payment
+  payment_execute: "payment.execute"
+};
+function mapToolToPurpose(toolName) {
+  return TOOL_PURPOSE_MAP[toolName] || `tool.${toolName}`;
+}
+function registerToolMappings(mappings) {
+  for (const [tool, purpose] of Object.entries(mappings)) {
+    if (!(tool in TOOL_PURPOSE_MAP)) {
+      TOOL_PURPOSE_MAP[tool] = purpose;
+    }
+  }
+}
+function extractTarget(toolName, args) {
+  const purpose = mapToolToPurpose(toolName);
+  if (purpose.startsWith("shell.")) {
+    return String(args.command || args.cmd || args.script || "");
+  }
+  if (purpose.startsWith("file.")) {
+    return String(args.path || args.file || args.filename || args.file_path || "");
+  }
+  if (purpose.startsWith("network.")) {
+    return String(args.url || args.endpoint || args.uri || "");
+  }
+  if (purpose.startsWith("email.")) {
+    return String(args.to || args.recipient || args.address || "");
+  }
+  if (purpose.startsWith("database.")) {
+    return String(args.query || args.table || "");
+  }
+  if (purpose.startsWith("payment.")) {
+    return String(args.description || args.merchant || args.amount || "");
+  }
+  if (args.command) return String(args.command);
+  if (args.path) return String(args.path);
+  if (args.url) return String(args.url);
+  for (const val of Object.values(args)) {
+    if (typeof val === "string" && val.length > 0) return val;
+  }
+  return toolName;
+}
+function extractNetworkDomains(target) {
+  try {
+    if (target.startsWith("http://") || target.startsWith("https://")) {
+      const url = new URL(target);
+      return [url.hostname];
+    }
+  } catch {
+  }
+  return void 0;
+}
+
+// src/claude-code/tool-mapping.ts
+var CLAUDE_CODE_TOOL_MAP = {
+  Bash: "shell.exec",
+  Write: "file.write",
+  Edit: "file.write",
+  MultiEdit: "file.write",
+  NotebookEdit: "file.write",
+  Read: "file.read",
+  Glob: "file.read",
+  Grep: "file.read",
+  WebFetch: "network.request",
+  WebSearch: "network.request",
+  Task: "sub_agent.spawn",
+  Agent: "sub_agent.spawn"
+};
+var registered = false;
+function registerClaudeCodeMappings() {
+  if (registered) return;
+  registerToolMappings(CLAUDE_CODE_TOOL_MAP);
+  registered = true;
+}
+function mapMcpTool(toolName) {
+  const match = /^mcp__(.+?)__(.+)$/.exec(toolName);
+  if (!match) return null;
+  return `${match[1]}.${match[2]}`;
+}
+
+// src/claude-code/claude-code-adapter.ts
+var DEFAULT_SKIP_TOOLS = [
+  "TodoWrite",
+  "TaskCreate",
+  "TaskUpdate",
+  "TaskList",
+  "TaskGet",
+  "ExitPlanMode",
+  "EnterPlanMode",
+  "AskUserQuestion",
+  "BashOutput",
+  "KillShell",
+  "TaskStop",
+  "TaskOutput",
+  "ListMcpResourcesTool"
+];
+var ClaudeCodeAdapter = class {
+  constructor(options) {
+    this.interfaceVersion = ADAPTER_INTERFACE_VERSION;
+    this._isRunning = false;
+    this.skipTools = new Set(options?.skipTools ?? DEFAULT_SKIP_TOOLS);
+    this.strictUnmapped = options?.strictUnmapped ?? false;
+    this.governMcp = options?.governMcp ?? true;
+    registerClaudeCodeMappings();
+  }
+  get isRunning() {
+    return this._isRunning;
+  }
+  async initialize(config) {
+    this.gateway = config.gateway;
+    if (Array.isArray(config.adapterOptions.skipTools)) {
+      this.skipTools = new Set(config.adapterOptions.skipTools);
+    }
+    if (typeof config.adapterOptions.strictUnmapped === "boolean") {
+      this.strictUnmapped = config.adapterOptions.strictUnmapped;
+    }
+    this._isRunning = true;
+  }
+  async shutdown() {
+    this._isRunning = false;
+  }
+  async interceptAction(action) {
+    const raw = action.raw;
+    if (!raw || typeof raw.tool_name !== "string" || raw.tool_name.length === 0) {
+      return { intercepted: false, skipReason: "No tool_name in payload" };
+    }
+    if (this.skipTools.has(raw.tool_name)) {
+      return { intercepted: false, skipReason: `Tool ${raw.tool_name} is not governed` };
+    }
+    const isMcp = mapMcpTool(raw.tool_name) !== null;
+    if (isMcp && !this.governMcp) {
+      return { intercepted: false, skipReason: `MCP tools not governed (governMcp off)` };
+    }
+    const isMapped = raw.tool_name in CLAUDE_CODE_TOOL_MAP || isMcp;
+    if (!isMapped && !this.strictUnmapped) {
+      return {
+        intercepted: false,
+        skipReason: `Unmapped tool ${raw.tool_name} (strictUnmapped off)`
+      };
+    }
+    const context = this.extractContext(action);
+    return { intercepted: true, context };
+  }
+  extractContext(action) {
+    const raw = action.raw;
+    const toolName = raw.tool_name;
+    const args = raw.tool_input ?? {};
+    const mcpPurpose = mapMcpTool(toolName);
+    const purpose = mcpPurpose ?? mapToolToPurpose(toolName);
+    const target = extractTarget(toolName, args);
+    const networkAccess = extractNetworkDomains(target);
+    return {
+      purpose,
+      action: toolName,
+      target,
+      ...networkAccess && { networkAccess },
+      metadata: {
+        ...raw.session_id && { sessionId: raw.session_id },
+        ...raw.cwd && { cwd: raw.cwd },
+        platform: "claude-code"
+      }
+    };
+  }
+  /**
+   * Translate a gateway decision into hook stdout JSON.
+   * Returns null on ALLOW — the hook stays silent and Claude Code's own
+   * permission system remains in charge (strictly-tightening invariant).
+   */
+  decisionToHookOutput(decision) {
+    switch (decision.recommendation) {
+      case "DENY":
+        return {
+          hookSpecificOutput: {
+            hookEventName: "PreToolUse",
+            permissionDecision: "deny",
+            permissionDecisionReason: `AstraSync Local Guard: ${decision.reason}`
+          }
+        };
+      case "MANUAL_REVIEW":
+        return {
+          hookSpecificOutput: {
+            hookEventName: "PreToolUse",
+            permissionDecision: "ask",
+            permissionDecisionReason: `AstraSync Local Guard requires approval: ${decision.reason}`
+          }
+        };
+      case "ALLOW":
+        return null;
+    }
+  }
+  /**
+   * Convenience for the hook entry: full payload → hook output (or null).
+   */
+  async evaluatePayload(payload) {
+    const action = {
+      raw: payload,
+      platform: "claude-code",
+      timestamp: /* @__PURE__ */ new Date()
+    };
+    const interception = await this.interceptAction(action);
+    if (!interception.intercepted || !interception.context) return null;
+    const decision = await this.gateway.evaluate(interception.context);
+    return this.decisionToHookOutput(decision);
+  }
+  /**
+   * Enforcement happens via the stdout JSON the hook prints (see
+   * decisionToHookOutput); there is no in-process side to enforce on.
+   */
+  async enforceDecision(_decision) {
+  }
+};
+export {
+  ClaudeCodeAdapter,
+  DEFAULT_SKIP_TOOLS
+};
+//# sourceMappingURL=claude-code-adapter.mjs.map

package/dist/claude-code/claude-code-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapter-interface/interface.ts","../../src/adapter-interface/purpose-mapping.ts","../../src/claude-code/tool-mapping.ts","../../src/claude-code/claude-code-adapter.ts"],"sourcesContent":["/**\n * PlatformAdapter Interface\n *\n * The contract that Layer 4 platform adapters implement.\n * Agent-side interception: governs what agents are allowed to do before they do it.\n *\n * Each adapter is 200-500 lines of platform-specific code.\n * All verification logic lives in the gateway — adapters just translate\n * between the platform's world and AstraSync's world.\n */\n\nimport type { AstraSyncGateway } from '../gateway/gateway';\nimport type { PDLSSContext, VerificationDecision, AgentAction, InterceptResult } from '../gateway/types';\n\nexport interface AdapterConfig {\n  /** The AstraSyncGateway instance (handles mode routing) */\n  gateway: AstraSyncGateway;\n  /** Platform-specific configuration */\n  adapterOptions: Record<string, unknown>;\n}\n\nexport interface PlatformAdapter {\n  /**\n   * Interface version for compatibility checking.\n   * Current version: 1.\n   */\n  readonly interfaceVersion: number;\n\n  /**\n   * Platform-specific initialization.\n   * Load config, register hooks, establish connections.\n   */\n  initialize(config: AdapterConfig): Promise<void>;\n\n  /**\n   * Graceful shutdown.\n   * Drain in-flight verifications, deregister hooks, close connections.\n   */\n  shutdown(): Promise<void>;\n\n  /**\n   * Intercept an agent action before execution.\n   *\n   * How this works depends on the platform:\n   * - CLI adapter: proxy server captures outbound request\n   * - Browser adapter: content script intercepts DOM interaction\n   * - Express: middleware captures inbound request\n   */\n  interceptAction(action: AgentAction): Promise<InterceptResult>;\n\n  /**\n   * Extract PDLSS-compatible context from a platform-specific action.\n   * Maps platform-native action format to the universal PDLSSContext.\n   */\n  extractContext(action: AgentAction): PDLSSContext;\n\n  /**\n   * Enforce the verification decision in a platform-specific way.\n   *\n   * How this works depends on the platform:\n   * - CLI: block command / allow command / prompt for approval\n   * - Browser: block navigation / show confirmation dialog\n   * - Express: return 403 / pass through / inject headers\n   */\n  enforceDecision(decision: VerificationDecision): Promise<void>;\n}\n\n/**\n * Current adapter interface version.\n */\nexport const ADAPTER_INTERFACE_VERSION = 1;\n\n/**\n * Check if an adapter is compatible with the current interface version.\n */\nexport function isCompatibleAdapter(adapter: PlatformAdapter): boolean {\n  return adapter.interfaceVersion === ADAPTER_INTERFACE_VERSION;\n}\n","/**\n * Shared purpose mapping utilities for Layer 4 platform adapters.\n *\n * Maps platform-native action names to PDLSS purpose categories.\n * Used by OpenClaw CLI, Cursor, browser, and future adapters.\n */\n\n// -----------------------------------------------------------------------\n// Tool → Purpose mapping\n// -----------------------------------------------------------------------\n\n/** Standard tool name → PDLSS purpose mapping used by all adapters */\nconst TOOL_PURPOSE_MAP: Record<string, string> = {\n  // Shell\n  shell_exec: 'shell.exec',\n  run_command: 'shell.exec',\n  execute: 'shell.exec',\n  terminal_exec: 'shell.exec',\n  run_terminal_command: 'shell.exec',\n\n  // File read\n  file_read: 'file.read',\n  read_file: 'file.read',\n\n  // File write\n  file_write: 'file.write',\n  write_file: 'file.write',\n  create_file: 'file.write',\n  edit_file: 'file.write',\n\n  // File delete\n  file_delete: 'file.delete',\n  delete_file: 'file.delete',\n\n  // Network\n  http_request: 'network.request',\n  fetch: 'network.request',\n  web_request: 'network.request',\n\n  // Email\n  send_email: 'email.send',\n  read_email: 'email.read',\n\n  // Calendar\n  create_event: 'calendar.create',\n\n  // Database\n  query_database: 'database.query',\n  write_database: 'database.write',\n\n  // Payment\n  payment_execute: 'payment.execute',\n};\n\n/**\n * Map a tool/action name to a PDLSS purpose category.\n * Returns `tool.<name>` for unmapped tools (denied by default).\n */\nexport function mapToolToPurpose(toolName: string): string {\n  return TOOL_PURPOSE_MAP[toolName] || `tool.${toolName}`;\n}\n\n/**\n * Register additional tool → purpose mappings (e.g. from a platform adapter).\n * Does not overwrite existing mappings.\n */\nexport function registerToolMappings(mappings: Record<string, string>): void {\n  for (const [tool, purpose] of Object.entries(mappings)) {\n    if (!(tool in TOOL_PURPOSE_MAP)) {\n      TOOL_PURPOSE_MAP[tool] = purpose;\n    }\n  }\n}\n\n// -----------------------------------------------------------------------\n// Target extraction\n// -----------------------------------------------------------------------\n\n/**\n * Extract the meaningful target string from tool arguments.\n * Uses the purpose category to determine which argument field is relevant.\n */\nexport function extractTarget(toolName: string, args: Record<string, unknown>): string {\n  const purpose = mapToolToPurpose(toolName);\n\n  if (purpose.startsWith('shell.')) {\n    return String(args.command || args.cmd || args.script || '');\n  }\n\n  if (purpose.startsWith('file.')) {\n    return String(args.path || args.file || args.filename || args.file_path || '');\n  }\n\n  if (purpose.startsWith('network.')) {\n    return String(args.url || args.endpoint || args.uri || '');\n  }\n\n  if (purpose.startsWith('email.')) {\n    return String(args.to || args.recipient || args.address || '');\n  }\n\n  if (purpose.startsWith('database.')) {\n    return String(args.query || args.table || '');\n  }\n\n  if (purpose.startsWith('payment.')) {\n    return String(args.description || args.merchant || args.amount || '');\n  }\n\n  // Fallback: try common field names\n  if (args.command) return String(args.command);\n  if (args.path) return String(args.path);\n  if (args.url) return String(args.url);\n\n  // Default: use first non-empty string argument or tool name\n  for (const val of Object.values(args)) {\n    if (typeof val === 'string' && val.length > 0) return val;\n  }\n  return toolName;\n}\n\n// -----------------------------------------------------------------------\n// Network domain extraction\n// -----------------------------------------------------------------------\n\n/**\n * Extract network domains from a URL target.\n * Returns undefined if the target is not a URL.\n */\nexport function extractNetworkDomains(target: string): string[] | undefined {\n  try {\n    if (target.startsWith('http://') || target.startsWith('https://')) {\n      const url = new URL(target);\n      return [url.hostname];\n    }\n  } catch {\n    // Not a URL\n  }\n  return undefined;\n}\n","/**\n * @astrasyncai/adapter-claude-code — tool → purpose mapping\n *\n * Maps Claude Code's built-in tool names (as delivered in PreToolUse hook\n * payloads) to PDLSS purpose categories, and parses MCP tool names\n * (mcp__{server}__{tool}) into app-connector style purposes.\n */\n\nimport { registerToolMappings } from '../adapter-interface/purpose-mapping';\n\n/** Claude Code built-in tool name → PDLSS purpose */\nexport const CLAUDE_CODE_TOOL_MAP: Record<string, string> = {\n  Bash: 'shell.exec',\n  Write: 'file.write',\n  Edit: 'file.write',\n  MultiEdit: 'file.write',\n  NotebookEdit: 'file.write',\n  Read: 'file.read',\n  Glob: 'file.read',\n  Grep: 'file.read',\n  WebFetch: 'network.request',\n  WebSearch: 'network.request',\n  Task: 'sub_agent.spawn',\n  Agent: 'sub_agent.spawn',\n};\n\nlet registered = false;\n\n/**\n * Register the Claude Code mappings into the shared adapter purpose map.\n * Idempotent; safe to call from both the adapter and the hook entry.\n */\nexport function registerClaudeCodeMappings(): void {\n  if (registered) return;\n  registerToolMappings(CLAUDE_CODE_TOOL_MAP);\n  registered = true;\n}\n\n/**\n * Parse an MCP tool name (mcp__{server}__{tool}) into an app-connector\n * style purpose `{server}.{tool}`. Returns null for non-MCP tool names.\n */\nexport function mapMcpTool(toolName: string): string | null {\n  const match = /^mcp__(.+?)__(.+)$/.exec(toolName);\n  if (!match) return null;\n  return `${match[1]}.${match[2]}`;\n}\n","/**\n * @astrasyncai/adapter-claude-code\n *\n * Layer 4 adapter for Claude Code (Anthropic's CLI coding agent).\n * Intercepts tool calls via Claude Code's native PreToolUse hook:\n * the hook binary receives {tool_name, tool_input, ...} on stdin and\n * answers with a permissionDecision on stdout.\n *\n * Decision mapping is strictly tightening:\n * - DENY          → permissionDecision \"deny\"\n * - MANUAL_REVIEW → permissionDecision \"ask\" (Claude Code's own permission\n *                   prompt is the human-in-the-loop)\n * - ALLOW         → no output at all — the guard NEVER emits \"allow\",\n *                   because \"allow\" would bypass Claude Code's native\n *                   permission system rather than defer to it.\n *\n * ~250 lines — thin, disposable, platform-specific.\n */\n\nimport type { PlatformAdapter, AdapterConfig } from '../adapter-interface/interface';\nimport type {\n  PDLSSContext,\n  VerificationDecision,\n  AgentAction,\n  InterceptResult,\n} from '../gateway/types';\nimport type { AstraSyncGateway } from '../gateway/gateway';\nimport { ADAPTER_INTERFACE_VERSION } from '../adapter-interface/interface';\nimport {\n  mapToolToPurpose,\n  extractTarget,\n  extractNetworkDomains,\n} from '../adapter-interface/purpose-mapping';\nimport { registerClaudeCodeMappings, mapMcpTool, CLAUDE_CODE_TOOL_MAP } from './tool-mapping';\n\n// -----------------------------------------------------------------------\n// Claude Code hook payload / output shapes\n// (contract: https://code.claude.com/docs/en/hooks.md)\n// -----------------------------------------------------------------------\n\n/** The PreToolUse payload Claude Code writes to the hook's stdin. */\nexport interface ClaudeCodePreToolUsePayload {\n  hook_event_name?: string;\n  tool_name: string;\n  tool_input: Record<string, unknown>;\n  session_id?: string;\n  cwd?: string;\n  transcript_path?: string;\n  permission_mode?: string;\n}\n\n/** The JSON the hook prints to stdout when it wants to tighten a decision. */\nexport interface ClaudeHookOutput {\n  hookSpecificOutput: {\n    hookEventName: 'PreToolUse';\n    permissionDecision: 'deny' | 'ask';\n    permissionDecisionReason: string;\n  };\n}\n\n// -----------------------------------------------------------------------\n// Configuration\n// -----------------------------------------------------------------------\n\n/**\n * Tools that are never governed: session bookkeeping and UI-only tools\n * with no side effects outside the conversation.\n */\nexport const DEFAULT_SKIP_TOOLS = [\n  'TodoWrite',\n  'TaskCreate',\n  'TaskUpdate',\n  'TaskList',\n  'TaskGet',\n  'ExitPlanMode',\n  'EnterPlanMode',\n  'AskUserQuestion',\n  'BashOutput',\n  'KillShell',\n  'TaskStop',\n  'TaskOutput',\n  'ListMcpResourcesTool',\n];\n\nexport interface ClaudeCodeAdapterOptions {\n  /** Tool names to never intercept (replaces DEFAULT_SKIP_TOOLS if given) */\n  skipTools?: string[];\n  /**\n   * When true, unmapped non-MCP tools are still intercepted (purpose\n   * `tool.<name>`, denied by default policy). When false (default),\n   * unmapped tools are skipped — Claude Code's own permission system\n   * remains their only gate.\n   */\n  strictUnmapped?: boolean;\n  /**\n   * Govern MCP tools (mcp__{server}__{tool} → purpose {server}.{tool}).\n   * Defaults to true. Note the evaluator denies purposes missing from the\n   * policy, so with governMcp on, every MCP server in use needs purpose\n   * rules; installers may default this off until the policy lists them.\n   */\n  governMcp?: boolean;\n}\n\n// -----------------------------------------------------------------------\n// Adapter implementation\n// -----------------------------------------------------------------------\n\nexport class ClaudeCodeAdapter implements PlatformAdapter {\n  readonly interfaceVersion = ADAPTER_INTERFACE_VERSION;\n\n  private gateway!: AstraSyncGateway;\n  private skipTools: Set<string>;\n  private strictUnmapped: boolean;\n  private governMcp: boolean;\n  private _isRunning = false;\n\n  constructor(options?: ClaudeCodeAdapterOptions) {\n    this.skipTools = new Set(options?.skipTools ?? DEFAULT_SKIP_TOOLS);\n    this.strictUnmapped = options?.strictUnmapped ?? false;\n    this.governMcp = options?.governMcp ?? true;\n    registerClaudeCodeMappings();\n  }\n\n  get isRunning(): boolean {\n    return this._isRunning;\n  }\n\n  async initialize(config: AdapterConfig): Promise<void> {\n    this.gateway = config.gateway as AstraSyncGateway;\n\n    if (Array.isArray(config.adapterOptions.skipTools)) {\n      this.skipTools = new Set(config.adapterOptions.skipTools as string[]);\n    }\n    if (typeof config.adapterOptions.strictUnmapped === 'boolean') {\n      this.strictUnmapped = config.adapterOptions.strictUnmapped;\n    }\n\n    this._isRunning = true;\n  }\n\n  async shutdown(): Promise<void> {\n    this._isRunning = false;\n  }\n\n  async interceptAction(action: AgentAction): Promise<InterceptResult> {\n    const raw = action.raw as Partial<ClaudeCodePreToolUsePayload> | null;\n\n    if (!raw || typeof raw.tool_name !== 'string' || raw.tool_name.length === 0) {\n      return { intercepted: false, skipReason: 'No tool_name in payload' };\n    }\n\n    if (this.skipTools.has(raw.tool_name)) {\n      return { intercepted: false, skipReason: `Tool ${raw.tool_name} is not governed` };\n    }\n\n    const isMcp = mapMcpTool(raw.tool_name) !== null;\n    if (isMcp && !this.governMcp) {\n      return { intercepted: false, skipReason: `MCP tools not governed (governMcp off)` };\n    }\n\n    const isMapped = raw.tool_name in CLAUDE_CODE_TOOL_MAP || isMcp;\n    if (!isMapped && !this.strictUnmapped) {\n      return {\n        intercepted: false,\n        skipReason: `Unmapped tool ${raw.tool_name} (strictUnmapped off)`,\n      };\n    }\n\n    const context = this.extractContext(action);\n    return { intercepted: true, context };\n  }\n\n  extractContext(action: AgentAction): PDLSSContext {\n    const raw = action.raw as ClaudeCodePreToolUsePayload;\n    const toolName = raw.tool_name;\n    const args = (raw.tool_input ?? {}) as Record<string, unknown>;\n\n    const mcpPurpose = mapMcpTool(toolName);\n    const purpose = mcpPurpose ?? mapToolToPurpose(toolName);\n    const target = extractTarget(toolName, args);\n    const networkAccess = extractNetworkDomains(target);\n\n    return {\n      purpose,\n      action: toolName,\n      target,\n      ...(networkAccess && { networkAccess }),\n      metadata: {\n        ...(raw.session_id && { sessionId: raw.session_id }),\n        ...(raw.cwd && { cwd: raw.cwd }),\n        platform: 'claude-code',\n      },\n    };\n  }\n\n  /**\n   * Translate a gateway decision into hook stdout JSON.\n   * Returns null on ALLOW — the hook stays silent and Claude Code's own\n   * permission system remains in charge (strictly-tightening invariant).\n   */\n  decisionToHookOutput(decision: VerificationDecision): ClaudeHookOutput | null {\n    switch (decision.recommendation) {\n      case 'DENY':\n        return {\n          hookSpecificOutput: {\n            hookEventName: 'PreToolUse',\n            permissionDecision: 'deny',\n            permissionDecisionReason: `AstraSync Local Guard: ${decision.reason}`,\n          },\n        };\n      case 'MANUAL_REVIEW':\n        return {\n          hookSpecificOutput: {\n            hookEventName: 'PreToolUse',\n            permissionDecision: 'ask',\n            permissionDecisionReason: `AstraSync Local Guard requires approval: ${decision.reason}`,\n          },\n        };\n      case 'ALLOW':\n        return null;\n    }\n  }\n\n  /**\n   * Convenience for the hook entry: full payload → hook output (or null).\n   */\n  async evaluatePayload(payload: ClaudeCodePreToolUsePayload): Promise<ClaudeHookOutput | null> {\n    const action: AgentAction = {\n      raw: payload,\n      platform: 'claude-code',\n      timestamp: new Date(),\n    };\n\n    const interception = await this.interceptAction(action);\n    if (!interception.intercepted || !interception.context) return null;\n\n    const decision = await this.gateway.evaluate(interception.context);\n    return this.decisionToHookOutput(decision);\n  }\n\n  /**\n   * Enforcement happens via the stdout JSON the hook prints (see\n   * decisionToHookOutput); there is no in-process side to enforce on.\n   */\n  async enforceDecision(_decision: VerificationDecision): Promise<void> {\n    // Contract no-op: Claude Code enforces based on the hook's stdout.\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli/index.d.mts

@@ -1,6 +1,6 @@
-import { b as LocalPurposeRule, d as LocalScope, c as LocalRiskThresholds, L as LocalPolicy, P as PDLSSContext, V as VerificationDecision, A as AgentAction, I as InterceptResult } from '../types-C8HyQEaz.mjs';
+import { b as LocalPurposeRule, d as LocalScope, c as LocalRiskThresholds, L as LocalPolicy, P as PDLSSContext, V as VerificationDecision, A as AgentAction, I as InterceptResult } from '../types-B-ubjHER.mjs';
 import { PlatformAdapter, AdapterConfig } from '../adapter-interface/interface.mjs';
-import '../types-DrDIouvO.mjs';
+import '../types-CKe8O0lR.mjs';
 import '../gateway/gateway.mjs';
 
 /**

package/dist/cli/index.d.ts

@@ -1,6 +1,6 @@
-import { b as LocalPurposeRule, d as LocalScope, c as LocalRiskThresholds, L as LocalPolicy, P as PDLSSContext, V as VerificationDecision, A as AgentAction, I as InterceptResult } from '../types-xofemo0G.js';
+import { b as LocalPurposeRule, d as LocalScope, c as LocalRiskThresholds, L as LocalPolicy, P as PDLSSContext, V as VerificationDecision, A as AgentAction, I as InterceptResult } from '../types-Bgn5gxHQ.js';
 import { PlatformAdapter, AdapterConfig } from '../adapter-interface/interface.js';
-import '../types-DrDIouvO.js';
+import '../types-CKe8O0lR.js';
 import '../gateway/gateway.js';
 
 /**

package/dist/cursor/cursor-adapter.d.mts

@@ -1,7 +1,7 @@
 import { PlatformAdapter, AdapterConfig } from '../adapter-interface/interface.mjs';
-import { P as PDLSSContext, V as VerificationDecision, A as AgentAction, I as InterceptResult } from '../types-C8HyQEaz.mjs';
+import { P as PDLSSContext, V as VerificationDecision, A as AgentAction, I as InterceptResult } from '../types-B-ubjHER.mjs';
 import '../gateway/gateway.mjs';
-import '../types-DrDIouvO.mjs';
+import '../types-CKe8O0lR.mjs';
 
 /**
  * @astrasyncai/adapter-cursor

package/dist/cursor/cursor-adapter.d.ts

@@ -1,7 +1,7 @@
 import { PlatformAdapter, AdapterConfig } from '../adapter-interface/interface.js';
-import { P as PDLSSContext, V as VerificationDecision, A as AgentAction, I as InterceptResult } from '../types-xofemo0G.js';
+import { P as PDLSSContext, V as VerificationDecision, A as AgentAction, I as InterceptResult } from '../types-Bgn5gxHQ.js';
 import '../gateway/gateway.js';
-import '../types-DrDIouvO.js';
+import '../types-CKe8O0lR.js';
 
 /**
  * @astrasyncai/adapter-cursor

package/dist/cursor/extension.d.mts

@@ -1,8 +1,8 @@
 import { VSCodeAPI } from './cursor-adapter.mjs';
 import '../adapter-interface/interface.mjs';
 import '../gateway/gateway.mjs';
-import '../types-C8HyQEaz.mjs';
-import '../types-DrDIouvO.mjs';
+import '../types-B-ubjHER.mjs';
+import '../types-CKe8O0lR.mjs';
 
 /**
  * VS Code Extension entry point for AstraSync Local Guard (Cursor/VS Code).

package/dist/cursor/extension.d.ts

@@ -1,8 +1,8 @@
 import { VSCodeAPI } from './cursor-adapter.js';
 import '../adapter-interface/interface.js';
 import '../gateway/gateway.js';
-import '../types-xofemo0G.js';
-import '../types-DrDIouvO.js';
+import '../types-Bgn5gxHQ.js';
+import '../types-CKe8O0lR.js';
 
 /**
  * VS Code Extension entry point for AstraSync Local Guard (Cursor/VS Code).

package/dist/cursor/extension.js

@@ -3773,7 +3773,7 @@ function getTrustLevel(score) {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.5.0";
+var SDK_VERSION = "3.7.0";
 
 // src/well-known.ts
 var CACHE_TTL_MS = 60 * 60 * 1e3;
@@ -3791,10 +3791,10 @@ var DEFAULT_CONFIG = {
   // through (`hasMinimumAccess('guidance', 'guidance') === true`).
   defaultAccessLevel: "none",
   // minTrustScore + minTrustScoreForFull deprecated in v2.3.0 — server decides.
-  // Round-18.5 F4: cacheTtl deliberately unset. When undefined, cacheResult
-  // applies the split default (60s autonomous / 300s step-up). When the
-  // caller sets cacheTtl explicitly, that value is honoured uniformly.
-  // Set cacheTtl: 0 to disable caching entirely.
+  // cacheTtl deliberately unset. When undefined, cacheResult applies the 60s
+  // default; the caller's explicit value is honoured for cacheable results.
+  // Denials and step-up escalations are NEVER cached (3.6.0) regardless of
+  // cacheTtl. Set cacheTtl: 0 to disable caching entirely.
   debug: false
 };
 var initCheckPerformed = false;
@@ -3881,10 +3881,9 @@ function getCachedResult(request, counterpartyId) {
   }
   return null;
 }
-var DEFAULT_AUTONOMOUS_TTL_SECONDS = 60;
-var DEFAULT_STEP_UP_TTL_SECONDS = 300;
+var DEFAULT_CACHE_TTL_SECONDS = 60;
 function cacheResult(request, result, configuredTtl, counterpartyId) {
-  const ttlSeconds = configuredTtl && configuredTtl > 0 ? configuredTtl : result.requiresStepUp ? DEFAULT_STEP_UP_TTL_SECONDS : DEFAULT_AUTONOMOUS_TTL_SECONDS;
+  const ttlSeconds = configuredTtl && configuredTtl > 0 ? configuredTtl : DEFAULT_CACHE_TTL_SECONDS;
   const key = getCacheKey(request, counterpartyId);
   verificationCache.set(key, {
     result,
@@ -4026,7 +4025,7 @@ async function callVerifyAccessAPI(config, request) {
     };
   }
 }
-async function verify(config, request) {
+async function verify(config, request, options) {
   const mergedConfig = { ...DEFAULT_CONFIG, ...config };
   const urls = mergedConfig.apiBaseUrl ? getCachedWellKnownUrls(mergedConfig.apiBaseUrl) : void 0;
   if (!initCheckPerformed && !mergedConfig.disableInitChecks && mergedConfig.apiBaseUrl) {
@@ -4042,7 +4041,7 @@ async function verify(config, request) {
       "[VerificationGateway] minTrustScore / minTrustScoreForFull are deprecated in v2.3.0 and have no effect. Server is now the single source of truth for access-level decisions (the SDK reads access.accessLevel from the verify-access response). To gate access to an endpoint, configure the endpoint's trust_score_requirement server-side."
     );
   }
-  if (mergedConfig.cacheTtl !== 0) {
+  if (mergedConfig.cacheTtl !== 0 && !options?.bypassCache) {
     const cached = getCachedResult(request, mergedConfig.counterpartyId);
     if (cached) {
       if (mergedConfig.debug) {
@@ -4062,6 +4061,8 @@ async function verify(config, request) {
     console.log("[VerificationGateway] Calling verify-access API");
   }
   const apiResponse = await callVerifyAccessAPI(mergedConfig, enrichedRequest);
+  const rawServerDenialReasons = apiResponse.denialReasons;
+  const serverDenialReasons = Array.isArray(rawServerDenialReasons) && rawServerDenialReasons.length > 0 ? rawServerDenialReasons : void 0;
   if (!apiResponse.success) {
     return createGuidanceResponse(mergedConfig, apiResponse.error, {
       source: "api_error",
@@ -4083,7 +4084,10 @@ async function verify(config, request) {
       // ALSO short-circuit on `!identityVerified || !policyAllowed` before
       // the gate check — belt-and-braces.
       accessLevel: "none",
-      denialReasons: aggregatedFailures && aggregatedFailures.length > 0 ? aggregatedFailures.map((f) => f.message) : apiResponse.access?.reason ? [apiResponse.access.reason] : ["Access denied"],
+      // 3.6.0: the server now emits top-level denialReasons on every deny
+      // path — prefer it verbatim; the failure-message reconstruction remains
+      // as the fallback for older backends.
+      denialReasons: serverDenialReasons ?? (aggregatedFailures && aggregatedFailures.length > 0 ? aggregatedFailures.map((f) => f.message) : apiResponse.access?.reason ? [apiResponse.access.reason] : ["Access denied"]),
       failures: aggregatedFailures,
       requiresStepUp: apiResponse.access?.requiresStepUp,
       requiresApproval: apiResponse.access?.requiresApproval,
@@ -4160,9 +4164,7 @@ async function verify(config, request) {
   if (result.recommendation === "deny") {
     result.policyAllowed = false;
     result.accessLevel = "none";
-    result.denialReasons = result.recommendationReasons || [
-      "Access denied by AstraSync recommendation"
-    ];
+    result.denialReasons = serverDenialReasons ?? result.recommendationReasons ?? ["Access denied by AstraSync recommendation"];
     result.guidance = result.runtimeChallenge ? {
       message: `Verification failed: ${result.runtimeChallenge.reason || "runtime challenge failed"}`,
       registrationUrl: urls?.registrationUrl ?? "",
@@ -4174,14 +4176,18 @@ async function verify(config, request) {
     };
   } else if (result.recommendation === "step_up_required") {
     result.requiresStepUp = true;
-    result.denialReasons = result.recommendationReasons || ["Step-up verification required"];
+    result.denialReasons = serverDenialReasons ?? result.recommendationReasons ?? ["Step-up verification required"];
   }
-  if (mergedConfig.cacheTtl !== 0 && result.recommendation !== "deny") {
+  const escalates = result.requiresStepUp === true || result.requiresApproval === true || result.recommendation === "step_up_required";
+  if (mergedConfig.cacheTtl !== 0 && result.recommendation !== "deny" && !escalates) {
     cacheResult(request, result, mergedConfig.cacheTtl, mergedConfig.counterpartyId);
   }
   return result;
 }
 
+// src/adapters/stepup-poll.ts
+var FALLBACK_MAX_WAIT_MS = 5 * 60 * 1e3;
+
 // src/adapters/express.ts
 var DEFAULT_ROUTES_REFRESH_MS = 5 * 60 * 1e3;