@agentdeck/bridge 0.2.3 → 1.0.0

package/dist/claude-permission-rules.js

@@ -0,0 +1,197 @@
+/**
+ * Conservative predictor for "would Claude Code actually prompt the user for
+ * this tool call?" — the precision guard for the observed-session PreToolUse
+ * device-approval gate.
+ *
+ * HISTORY (why precision-first): the first PreToolUse gate held EVERY gated
+ * tool call, so tools Claude auto-approves (allowlist rules, acceptEdits,
+ * session "always allow") still popped Allow/Deny on devices — the reported
+ * false-attention bug that got the gate removed (DEVELOPMENT_LOG 2026-05).
+ * This module exists so the reinstated gate only ever holds calls we are
+ * CONFIDENT Claude will prompt for. Every uncertainty resolves to "don't
+ * hold": a missed hold just means the user answers in the terminal (the
+ * pre-gate status quo), while a false hold nags the user with a popup Claude
+ * never asked for.
+ *
+ * Rule semantics mirror Claude Code `permissions.allow/deny/ask` entries:
+ *   "Bash"                → every Bash call
+ *   "Bash(git status)"    → exact command
+ *   "Bash(git status:*)"  → command prefix
+ *   "Read(...)"/"WebFetch(domain:x)"/"mcp__srv__tool" → tool + spec
+ * Matching is deliberately asymmetric:
+ *   - allow/deny rules match LOOSELY (tool-name match with any spec counts)
+ *     because a loose match only suppresses a hold (safe direction).
+ *   - ask rules match STRICTLY (tool-only, or exact/prefix Bash) because an
+ *     ask match *causes* a hold and must not fire on a spec we can't parse.
+ */
+import { readFileSync, statSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { debug } from './logger.js';
+/** Tools that never trigger a permission prompt — holding them can only ever
+ *  be a false positive. Kept intentionally tight (unknown tools are excluded
+ *  by the prompt-prone check below, not this list). */
+const NEVER_PROMPT_TOOLS = new Set([
+    'Read', 'Glob', 'Grep', 'LS',
+    'TodoWrite', 'TodoRead', 'NotebookRead',
+    'Task', 'TaskOutput', 'BashOutput',
+]);
+/** Tools that DO prompt in default/auto permission mode unless allowlisted.
+ *  Anything outside this set (including every mcp__* tool, whose per-server
+ *  trust state we cannot see) is never held. */
+const PROMPT_PRONE_TOOLS = new Set([
+    'Bash', 'Write', 'Edit', 'MultiEdit', 'NotebookEdit', 'WebFetch', 'WebSearch',
+]);
+export function isNeverPromptTool(tool) {
+    return NEVER_PROMPT_TOOLS.has(tool);
+}
+export function isPromptProneTool(tool) {
+    return PROMPT_PRONE_TOOLS.has(tool);
+}
+const RULES_CACHE_TTL_MS = 10_000;
+const rulesCache = new Map();
+/** Test seam: isolates rule loading from the developer's real ~/.claude. */
+let homeOverride = null;
+export function _setHomeOverrideForTests(path) {
+    homeOverride = path;
+    rulesCache.clear();
+}
+function settingsCandidates(cwd) {
+    const home = homeOverride ?? homedir();
+    const files = [
+        // Enterprise managed policy (rare; parse failure here must also disable holds)
+        '/Library/Application Support/ClaudeCode/managed-settings.json',
+        join(home, '.claude', 'settings.json'),
+        join(home, '.claude', 'settings.local.json'),
+    ];
+    if (cwd) {
+        files.push(join(cwd, '.claude', 'settings.json'));
+        files.push(join(cwd, '.claude', 'settings.local.json'));
+    }
+    return files;
+}
+/**
+ * Load and merge permission rules from every settings file Claude Code reads
+ * for this cwd. Returns null ("unknown") when any EXISTING file fails to
+ * parse — we can no longer trust our picture of the allowlist, so the caller
+ * must not hold anything.
+ */
+export function loadMergedPermissionRules(cwd) {
+    const key = cwd ?? '';
+    const cached = rulesCache.get(key);
+    if (cached && Date.now() - cached.loadedAt < RULES_CACHE_TTL_MS)
+        return cached.rules;
+    const merged = { allow: [], deny: [], ask: [] };
+    let unknown = false;
+    for (const file of settingsCandidates(cwd)) {
+        let exists = false;
+        try {
+            exists = statSync(file).isFile();
+        }
+        catch {
+            exists = false;
+        }
+        if (!exists)
+            continue;
+        try {
+            const parsed = JSON.parse(readFileSync(file, 'utf-8'));
+            const perms = parsed?.permissions;
+            if (perms && typeof perms === 'object') {
+                for (const bucket of ['allow', 'deny', 'ask']) {
+                    const arr = perms[bucket];
+                    if (Array.isArray(arr)) {
+                        for (const r of arr)
+                            if (typeof r === 'string')
+                                merged[bucket].push(r);
+                    }
+                }
+            }
+        }
+        catch {
+            debug('permission', `settings parse failed: ${file} — disabling holds for cwd=${cwd ?? '?'}`);
+            unknown = true;
+            break;
+        }
+    }
+    const rules = unknown ? null : merged;
+    rulesCache.set(key, { rules, loadedAt: Date.now() });
+    return rules;
+}
+/** Test helper. */
+export function _clearRulesCache() {
+    rulesCache.clear();
+}
+function parseRule(rule) {
+    const m = /^([A-Za-z][A-Za-z0-9_]*)(?:\((.*)\))?$/.exec(rule.trim());
+    if (!m)
+        return null;
+    return { tool: m[1], spec: m[2] };
+}
+function bashSpecMatches(spec, command) {
+    if (spec === '*')
+        return true;
+    if (spec.endsWith(':*'))
+        return command.startsWith(spec.slice(0, -2));
+    return command === spec;
+}
+/** Loose match (allow/deny direction): a tool-name match with ANY spec counts,
+ *  except Bash specs which we can compare precisely. */
+function matchesLoose(rule, tool, command) {
+    if (rule.tool !== tool)
+        return false;
+    if (rule.spec === undefined)
+        return true;
+    if (tool === 'Bash') {
+        if (command === undefined)
+            return true; // malformed input — assume covered
+        return bashSpecMatches(rule.spec, command)
+            // Compound commands: Claude prompts unless every segment is allowed; we
+            // only need "might be auto-approved", so a prefix match on the first
+            // segment is enough to suppress the hold.
+            || bashSpecMatches(rule.spec, command.split(/&&|\|\||;|\|/)[0]?.trim() ?? command);
+    }
+    // Non-Bash specs (paths, domains, globs): we don't replicate the matcher —
+    // any spec on the right tool MIGHT match, so treat it as covered.
+    return true;
+}
+/** Strict match (ask direction): only patterns we can evaluate exactly. */
+function matchesStrict(rule, tool, command) {
+    if (rule.tool !== tool)
+        return false;
+    if (rule.spec === undefined)
+        return true;
+    if (tool === 'Bash' && command !== undefined)
+        return bashSpecMatches(rule.spec, command);
+    return false;
+}
+/**
+ * Predict Claude's permission-rule verdict for a tool call.
+ *   'deny'    → a deny rule may match: Claude auto-denies (or prompts) — don't hold
+ *   'allow'   → an allow rule may match: Claude may auto-approve — don't hold
+ *   'ask'     → an ask rule definitely matches: Claude will prompt — hold-eligible
+ *   'none'    → no rule matches: default behavior for the tool applies
+ *   'unknown' → settings unreadable: don't hold
+ */
+export function evaluatePermissionRules(tool, toolInput, cwd) {
+    const rules = loadMergedPermissionRules(cwd);
+    if (rules === null)
+        return 'unknown';
+    const command = typeof toolInput?.command === 'string' ? toolInput.command : undefined;
+    for (const r of rules.deny) {
+        const parsed = parseRule(r);
+        if (parsed && matchesLoose(parsed, tool, command))
+            return 'deny';
+    }
+    for (const r of rules.allow) {
+        const parsed = parseRule(r);
+        if (parsed && matchesLoose(parsed, tool, command))
+            return 'allow';
+    }
+    for (const r of rules.ask) {
+        const parsed = parseRule(r);
+        if (parsed && matchesStrict(parsed, tool, command))
+            return 'ask';
+    }
+    return 'none';
+}
+//# sourceMappingURL=claude-permission-rules.js.map

package/dist/claude-permission-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-permission-rules.js","sourceRoot":"","sources":["../src/claude-permission-rules.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyLpC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAM,CAAC;AAOtF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AAoBD,QAAA,MAAM,OAAO,SAAgB,CAAC;AAm5D9B,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyLpC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAM,CAAC;AAOtF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AAoBD,QAAA,MAAM,OAAO,SAAgB,CAAC;AAg6D9B,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli.js

@@ -908,7 +908,16 @@ program
     const daemonTarget = resolveEsp32OtaDaemonTarget(target);
     const firmwarePath = resolveEsp32FirmwarePath(target, opts.env, opts.firmware);
     log(`Uploading ${firmwarePath} to ${daemonTarget} via daemon :${port}...`);
-    const { statusCode, body } = await postJsonWithTimeout(`http://127.0.0.1:${port}/esp32/ota`, { target: daemonTarget, firmwarePath }, 15 * 60_000);
+    let { statusCode, body } = await postJsonWithTimeout(`http://127.0.0.1:${port}/esp32/ota`, { target: daemonTarget, firmwarePath }, 15 * 60_000);
+    if (body.ok === false && String(body.error ?? '').startsWith('firmware_unreadable')) {
+        // Sandboxed Swift daemon can't read files outside its container —
+        // resend with the image inlined instead of failing over to a manual
+        // daemon swap.
+        log('Daemon cannot read the firmware path (sandbox) — resending inline...');
+        const { readFileSync } = await import('fs');
+        const firmwareB64 = readFileSync(firmwarePath).toString('base64');
+        ({ statusCode, body } = await postJsonWithTimeout(`http://127.0.0.1:${port}/esp32/ota`, { target: daemonTarget, firmwareB64 }, 15 * 60_000));
+    }
     if (statusCode < 200 || statusCode >= 300 || body.ok === false) {
         throw new Error(String(body.error ?? `HTTP ${statusCode}`));
     }