@pushary/agent-hooks 1.7.1 → 1.7.2

package/dist/{chunk-QPR33SHS.js → chunk-OJRB5QKN.js}

@@ -1,21 +1,21 @@
 import {
   detectClaudeVersion
-} from "./chunk-Y6GKOZBT.js";
+} from "./chunk-U3MS6D5X.js";
 import {
   ensureCodexTrustsPusharyHooks
-} from "./chunk-6SJQ442W.js";
+} from "./chunk-5GIBNUBD.js";
 import {
   addClaudeMcpServer,
   addPusharyHooks,
   addPusharyToolPermissions
-} from "./chunk-WSC53O7I.js";
+} from "./chunk-KAJT6HPI.js";
 import {
   claudeUnprovenHolds,
   claudeWired,
   codexUnprovenHolds,
   codexWired,
   geminiWired
-} from "./chunk-XDASEYRS.js";
+} from "./chunk-L6IF4JOF.js";
 import {
   CLAUDE_HOOK_BINARY,
   CLAUDE_HOOK_EVENTS,
@@ -27,7 +27,7 @@ import {
   needsReregistration,
   registrationSignatures,
   supportedClaudeEvents
-} from "./chunk-WZWXBTRF.js";
+} from "./chunk-A6WQF7FQ.js";
 import {
   CODEX_HOOK_BINARY,
   addCodexHookTrust,
@@ -47,7 +47,7 @@ import {
   registrationHolderOf,
   resolveGlobalBinary,
   vscodePluginMcp
-} from "./chunk-454KMJHF.js";
+} from "./chunk-NYBZJ44G.js";
 import {
   readJsonSafe,
   writeFileAtomic,

package/dist/{chunk-3T35OE7C.js → chunk-OXEF6JHD.js}

@@ -1,10 +1,10 @@
+import {
+  createIo
+} from "./chunk-U4TMAANR.js";
 import {
   describeKeyCheck,
   keyCheckFromResponse
-} from "./chunk-43SSQCWO.js";
-import {
-  createIo
-} from "./chunk-O5PRIYFZ.js";
+} from "./chunk-VQDJ6KB3.js";
 import {
   EXIT
 } from "./chunk-KZERVKTD.js";

package/dist/{chunk-SNWNA3MQ.js → chunk-PWNQGITG.js}

@@ -1,6 +1,6 @@
 import {
   pusharyDir
-} from "./chunk-454KMJHF.js";
+} from "./chunk-NYBZJ44G.js";
 import {
   readJsonSafe
 } from "./chunk-T7E75EKA.js";

package/dist/{chunk-XPTCPU6V.js → chunk-Q7CDBJXU.js}

@@ -1,6 +1,6 @@
 import {
   readTranscriptPreference
-} from "./chunk-YZKS3ME3.js";
+} from "./chunk-VSGKQ3HI.js";
 
 // src/transcript-setting.ts
 var transcriptEnvironmentPreference = () => {

package/dist/{chunk-OTZHT34O.js → chunk-QSZ37ROP.js}

@@ -1,6 +1,6 @@
 import {
   getBaseUrl
-} from "./chunk-OAL44FM2.js";
+} from "./chunk-SJN64NJX.js";
 
 // src/transcript-api.ts
 var fetchTranscriptRecipients = async (apiKey, baseUrl = getBaseUrl()) => {

package/dist/{chunk-O5JD7UI5.js → chunk-R7ZETVNR.js}

@@ -1,6 +1,6 @@
 import {
   redactSecrets
-} from "./chunk-XFNVG3OV.js";
+} from "./chunk-WWTLAZQA.js";
 
 // src/crypto.ts
 import nacl from "tweetnacl";

package/dist/{chunk-4C4NRDIC.js → chunk-RLRDPZG4.js}

@@ -1,6 +1,6 @@
 import {
   PRETOOLUSE_GATED_TOOLS
-} from "./chunk-XFNVG3OV.js";
+} from "./chunk-WWTLAZQA.js";
 
 // src/claude-tools.ts
 var POSTTOOLUSE_MIRROR_ONLY_TOOLS = ["TodoWrite", "Task", "WebFetch", "WebSearch"];

package/dist/{chunk-IGBDOZUO.js → chunk-SEIZQZEE.js}

@@ -1,7 +1,7 @@
 import {
   HOOK_HOLD_BUDGET_ENV,
   hookHoldBudgetProof
-} from "./chunk-XFNVG3OV.js";
+} from "./chunk-WWTLAZQA.js";
 
 // src/hold-budget.ts
 var takeHookHoldBudget = (args = process.argv.slice(2), env = process.env) => {

package/dist/{chunk-OAL44FM2.js → chunk-SJN64NJX.js}

@@ -1,6 +1,6 @@
 import {
   NPX_LATEST_COMMAND
-} from "./chunk-EIZW73P5.js";
+} from "./chunk-65RN6ZCO.js";
 
 // src/config.ts
 import { readFileSync } from "fs";

package/dist/{chunk-NID4UZDN.js → chunk-SKEW3TQX.js}

@@ -1,7 +1,7 @@
 import {
   HOOK_BUDGETS,
   OPENCODE_APPROVAL_EVENT
-} from "./chunk-XFNVG3OV.js";
+} from "./chunk-WWTLAZQA.js";
 
 // src/opencode-plugin.ts
 var OPENCODE_PLUGIN_MARKER = "pushary-opencode-plugin w1";

package/dist/{chunk-NAAZCNKI.js → chunk-SKMWPXGV.js}

@@ -1,15 +1,322 @@
 import {
   MCP_BRIDGE_BINARY
-} from "./chunk-2FU43B5Q.js";
+} from "./chunk-TVJYGZXB.js";
 import {
   openCodeConfigDirFrom
-} from "./chunk-NID4UZDN.js";
+} from "./chunk-SKEW3TQX.js";
 import {
-  codexHomeFrom
-} from "./chunk-454KMJHF.js";
+  codexHomeFrom,
+  resolvePathBinary
+} from "./chunk-NYBZJ44G.js";
 import {
   HOOK_COMPATIBLE_PROFILES
-} from "./chunk-XFNVG3OV.js";
+} from "./chunk-WWTLAZQA.js";
+
+// src/hermes-config.ts
+import { execFileSync } from "child_process";
+import { existsSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { homedir, tmpdir } from "os";
+import { join } from "path";
+var isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+var isSnapshot = (value) => isRecord(value) && typeof value.present === "boolean" && Object.hasOwn(value, "value");
+var isHermesConfigReceipt = (value) => {
+  if (!isRecord(value)) return false;
+  return ["security", "approval", "transport", "fallback", "plugins", "enabled", "agent", "disabled"].every((key) => isSnapshot(value[key])) && typeof value.pushary_enabled === "boolean" && typeof value.clarify_disabled === "boolean";
+};
+var HERMES_PIP_PACKAGE = "hermes-plugin-pushary";
+var HERMES_PLUGIN_NAME = "pushary";
+var HERMES_CONFIG_SCRIPT = String.raw`
+import copy, importlib.util, json, os, sys
+from hermes_cli.config import load_config, save_config
+
+PUSHARY_TRANSPORT = "pushary"
+PUSHARY_FALLBACK = "builtin"
+PUSHARY_PLUGIN = "pushary"
+PUSHARY_PLUGIN_MODULE = "pushary_plugin"
+QUESTION_TOOLSET = "clarify"
+
+mode = sys.argv[1]
+receipt_path = sys.argv[2] if len(sys.argv) > 2 else None
+c = load_config()
+original = copy.deepcopy(c)
+
+def section(obj, key):
+    value = obj.get(key)
+    return value if isinstance(value, dict) else {}
+
+def members(obj, key):
+    value = obj.get(key)
+    return value if isinstance(value, list) else []
+
+if mode == "status":
+    print(json.dumps({
+        "plugin_installed": importlib.util.find_spec(PUSHARY_PLUGIN_MODULE) is not None,
+        "plugin_enabled": PUSHARY_PLUGIN in members(section(c, "plugins"), "enabled"),
+        "approvals_routed": section(section(c, "security"), "approval").get("transport") == PUSHARY_TRANSPORT,
+        "questions_routed": QUESTION_TOOLSET in members(section(c, "agent"), "disabled_toolsets"),
+    }))
+    sys.exit(0)
+
+def recorded(snapshot, value):
+    return bool(snapshot.get("present")) and snapshot.get("value") == value
+
+def pop_if(obj, key, value):
+    if obj.get(key) == value:
+        obj.pop(key, None)
+
+def snap(obj, key):
+    return {"present": key in obj, "value": obj.get(key)}
+
+restore_conflicts = []
+
+def restore(obj, key, before, ours):
+    if before.get("present") and before.get("value") == ours:
+        return
+    if before.get("present"):
+        if key in obj and obj.get(key) == before.get("value"):
+            return
+    elif key not in obj:
+        return
+    if obj.get(key) != ours:
+        restore_conflicts.append(key)
+        return
+    if before.get("present"):
+        obj[key] = before.get("value")
+    else:
+        obj.pop(key, None)
+
+def restore_container(obj, key, before, current, changed):
+    raw = obj.get(key)
+    if isinstance(before.get("value"), dict):
+        if not isinstance(raw, dict):
+            if changed:
+                restore_conflicts.append(key)
+            return
+        if current or before.get("present"):
+            obj[key] = current
+        else:
+            obj.pop(key, None)
+    elif isinstance(raw, dict) and current:
+        restore_conflicts.append(key)
+    else:
+        restore(obj, key, before, {})
+
+def restore_list_member(obj, key, before, ours, ours_before):
+    raw = obj.get(key)
+    if isinstance(before.get("value"), list):
+        if ours_before:
+            return
+        if not isinstance(raw, list):
+            restore_conflicts.append(key)
+            return
+        remaining = [item for item in raw if item != ours]
+        if remaining or before.get("present"):
+            obj[key] = remaining
+        else:
+            obj.pop(key, None)
+        return
+    if before.get("present") and raw == before.get("value"):
+        return
+    if not before.get("present") and key not in obj:
+        return
+    if not isinstance(raw, list):
+        restore_conflicts.append(key)
+        return
+    remaining = [item for item in raw if item != ours]
+    if remaining:
+        restore_conflicts.append(key)
+    else:
+        restore(obj, key, before, raw)
+
+def valid_snapshot(value):
+    return isinstance(value, dict) and isinstance(value.get("present"), bool) and "value" in value
+
+def valid_receipt(value):
+    snapshots = ["security", "approval", "transport", "fallback", "plugins", "enabled", "agent", "disabled"]
+    return (isinstance(value, dict)
+        and all(valid_snapshot(value.get(key)) for key in snapshots)
+        and isinstance(value.get("pushary_enabled"), bool)
+        and isinstance(value.get("clarify_disabled"), bool))
+
+if mode == "setup":
+    security_before = snap(c, "security")
+    s = section(c, "security")
+    approval_before = snap(s, "approval")
+    ap = section(s, "approval")
+    plugins_before = snap(c, "plugins")
+    p = section(c, "plugins")
+    agent_before = snap(c, "agent")
+    a = section(c, "agent")
+    enabled = members(p, "enabled")
+    disabled = members(a, "disabled_toolsets")
+    receipt = {
+        "security": security_before,
+        "approval": approval_before,
+        "transport": snap(ap, "transport"),
+        "fallback": snap(ap, "transport_fallback"),
+        "plugins": plugins_before,
+        "enabled": snap(p, "enabled"),
+        "pushary_enabled": PUSHARY_PLUGIN in enabled,
+        "agent": agent_before,
+        "disabled": snap(a, "disabled_toolsets"),
+        "clarify_disabled": QUESTION_TOOLSET in disabled,
+    }
+    if os.path.exists(receipt_path):
+        with open(receipt_path, encoding="utf-8") as handle:
+            existing_receipt = json.load(handle)
+        if not valid_receipt(existing_receipt):
+            raise ValueError("invalid Pushary Hermes setup receipt")
+    else:
+        os.makedirs(os.path.dirname(receipt_path), exist_ok=True)
+        temp = receipt_path + ".tmp"
+        with open(temp, "x", encoding="utf-8") as handle:
+            json.dump(receipt, handle)
+        os.chmod(temp, 0o600)
+        os.replace(temp, receipt_path)
+    ap["transport"] = PUSHARY_TRANSPORT
+    ap["transport_fallback"] = PUSHARY_FALLBACK
+    s["approval"] = ap
+    c["security"] = s
+    p["enabled"] = enabled if PUSHARY_PLUGIN in enabled else enabled + [PUSHARY_PLUGIN]
+    c["plugins"] = p
+    a["disabled_toolsets"] = disabled if QUESTION_TOOLSET in disabled else disabled + [QUESTION_TOOLSET]
+    c["agent"] = a
+else:
+    receipt_exists = os.path.exists(receipt_path)
+    try:
+        with open(receipt_path, encoding="utf-8") as handle:
+            receipt = json.load(handle)
+    except (OSError, ValueError):
+        if receipt_exists:
+            raise
+        receipt = None
+    s = section(c, "security")
+    ap = section(s, "approval")
+    if receipt:
+        if not valid_receipt(receipt):
+            raise ValueError("invalid Pushary Hermes setup receipt")
+        approval_changed = (not receipt["transport"].get("present")
+            or receipt["transport"].get("value") != PUSHARY_TRANSPORT
+            or not receipt["fallback"].get("present")
+            or receipt["fallback"].get("value") != PUSHARY_FALLBACK)
+        plugins_changed = not (isinstance(receipt["enabled"].get("value"), list)
+            and receipt["pushary_enabled"])
+        agent_changed = not (isinstance(receipt["disabled"].get("value"), list)
+            and receipt["clarify_disabled"])
+        transport_left_over = recorded(receipt["transport"], PUSHARY_TRANSPORT)
+        if transport_left_over:
+            pop_if(ap, "transport", PUSHARY_TRANSPORT)
+        else:
+            restore(ap, "transport", receipt["transport"], PUSHARY_TRANSPORT)
+        if transport_left_over and recorded(receipt["fallback"], PUSHARY_FALLBACK):
+            pop_if(ap, "transport_fallback", PUSHARY_FALLBACK)
+        else:
+            restore(ap, "transport_fallback", receipt["fallback"], PUSHARY_FALLBACK)
+    else:
+        pop_if(ap, "transport", PUSHARY_TRANSPORT)
+        pop_if(ap, "transport_fallback", PUSHARY_FALLBACK)
+    if receipt:
+        restore_container(s, "approval", receipt["approval"], ap, approval_changed)
+        restore_container(c, "security", receipt["security"], s, approval_changed)
+    else:
+        if ap: s["approval"] = ap
+        else: s.pop("approval", None)
+        if s: c["security"] = s
+        else: c.pop("security", None)
+
+    p = section(c, "plugins")
+    if receipt:
+        restore_list_member(p, "enabled", receipt["enabled"], PUSHARY_PLUGIN, False)
+        restore_container(c, "plugins", receipt["plugins"], p, plugins_changed)
+    else:
+        enabled = [item for item in members(p, "enabled") if item != PUSHARY_PLUGIN]
+        if enabled: p["enabled"] = enabled
+        else: p.pop("enabled", None)
+        if p: c["plugins"] = p
+        else: c.pop("plugins", None)
+
+    a = section(c, "agent")
+    if receipt:
+        clarify_was_users = receipt["clarify_disabled"] and not recorded(receipt["transport"], PUSHARY_TRANSPORT)
+        restore_list_member(a, "disabled_toolsets", receipt["disabled"], QUESTION_TOOLSET, clarify_was_users)
+        restore_container(c, "agent", receipt["agent"], a, agent_changed)
+    else:
+        disabled = [item for item in members(a, "disabled_toolsets") if item != QUESTION_TOOLSET]
+        if disabled: a["disabled_toolsets"] = disabled
+        else: a.pop("disabled_toolsets", None)
+        if a: c["agent"] = a
+        else: c.pop("agent", None)
+
+    if receipt and restore_conflicts:
+        raise ValueError("Hermes config changed after Pushary setup")
+
+changed = c != original
+if changed and mode != "clean-preview":
+    save_config(c)
+print(json.dumps({"changed": changed}))
+`;
+var resolveHermesPython = () => {
+  const launcher = resolvePathBinary("hermes");
+  if (launcher && process.platform !== "win32") {
+    try {
+      const shebang = readFileSync(launcher, "utf-8").split("\n", 1)[0];
+      const interpreter = shebang?.startsWith("#!") ? shebang.slice(2).trim().split(/\s+/)[0] : void 0;
+      if (interpreter && /python/i.test(interpreter) && existsSync(interpreter)) return interpreter;
+    } catch {
+    }
+  }
+  const root = join(homedir(), ".hermes", "hermes-agent", "venv");
+  const candidates = process.platform === "win32" ? [join(root, "Scripts", "python.exe"), join(root, "Scripts", "python3.exe")] : [join(root, "bin", "python3"), join(root, "bin", "python")];
+  return candidates.find(existsSync) ?? null;
+};
+var HERMES_SCRIPT_TIMEOUT_MS = 15e3;
+var runPythonScript = (python, script, args) => {
+  const path = join(tmpdir(), `pushary-hermes-${process.pid}-${Date.now()}.py`);
+  try {
+    writeFileSync(path, script, { encoding: "utf-8", mode: 384 });
+    return execFileSync(python, [path, ...args], {
+      env: { ...process.env },
+      encoding: "utf-8",
+      stdio: "pipe",
+      timeout: HERMES_SCRIPT_TIMEOUT_MS
+    });
+  } catch {
+    return null;
+  } finally {
+    try {
+      rmSync(path, { force: true });
+    } catch {
+    }
+  }
+};
+var lastReport = (stdout) => {
+  const line = stdout.trim().split("\n").at(-1) ?? "";
+  try {
+    return JSON.parse(line);
+  } catch {
+    return void 0;
+  }
+};
+var configRunFrom = (stdout) => {
+  const report = stdout === null ? void 0 : lastReport(stdout);
+  if (!isRecord(report) || typeof report.changed !== "boolean") return "failed";
+  return report.changed ? "changed" : "unchanged";
+};
+var runHermesConfigScript = (python, mode, receiptPath) => configRunFrom(runPythonScript(python, HERMES_CONFIG_SCRIPT, [mode, receiptPath]));
+var HERMES_STATUS_FIELDS = ["plugin_installed", "plugin_enabled", "approvals_routed", "questions_routed"];
+var isHermesStatusReport = (value) => isRecord(value) && HERMES_STATUS_FIELDS.every((field) => typeof value[field] === "boolean");
+var hermesWiredByPushary = (status, setupRecorded) => setupRecorded || status.pluginEnabled || status.approvalsRouted;
+var readHermesStatus = (python) => {
+  const stdout = runPythonScript(python, HERMES_CONFIG_SCRIPT, ["status"]);
+  const report = stdout === null ? void 0 : lastReport(stdout);
+  if (!isHermesStatusReport(report)) return null;
+  return {
+    pluginInstalled: report.plugin_installed,
+    pluginEnabled: report.plugin_enabled,
+    approvalsRouted: report.approvals_routed,
+    questionsRouted: report.questions_routed
+  };
+};
 
 // src/fx-config.ts
 var FX_SERVER_NAME = "pushary";
@@ -347,13 +654,13 @@ var workspaceShowsQuestionTool = (workspace) => {
 var workspacesShowingQuestionTool = (settings) => Object.entries(asRecord(settings[WORKSPACES_KEY]) ?? {}).filter(([, workspace]) => workspaceShowsQuestionTool(workspace)).map(([path]) => path);
 
 // src/fx-files.ts
-import { existsSync, lstatSync, readFileSync, realpathSync } from "fs";
+import { existsSync as existsSync2, lstatSync, readFileSync as readFileSync2, realpathSync } from "fs";
 import { relative, isAbsolute } from "path";
 var readFxFile = (path, read) => {
-  if (!existsSync(path)) return { kind: "missing" };
+  if (!existsSync2(path)) return { kind: "missing" };
   let text;
   try {
-    text = readFileSync(path, "utf-8");
+    text = readFileSync2(path, "utf-8");
   } catch {
     return { kind: "unreadable" };
   }
@@ -374,8 +681,8 @@ var fxIgnoresInstructionsFile = (path, fxDir) => {
 };
 
 // src/vscode-config.ts
-import { homedir } from "os";
-import { join } from "path";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
 var PLUGIN_LOCATIONS_KEY = "chat.pluginLocations";
 var blankJsonComments = (text) => {
   let out = "";
@@ -505,13 +812,13 @@ var pluginLocationSnippet = (pluginDir) => `"${PLUGIN_LOCATIONS_KEY}": {
 }`;
 var VSCODE_PRODUCTS = ["Code", "Code - Insiders"];
 var settingsRoot = (home, platform) => {
-  if (platform === "darwin") return join(home, "Library", "Application Support");
-  if (platform === "win32") return process.env.APPDATA?.trim() || join(home, "AppData", "Roaming");
-  return process.env.XDG_CONFIG_HOME?.trim() || join(home, ".config");
+  if (platform === "darwin") return join2(home, "Library", "Application Support");
+  if (platform === "win32") return process.env.APPDATA?.trim() || join2(home, "AppData", "Roaming");
+  return process.env.XDG_CONFIG_HOME?.trim() || join2(home, ".config");
 };
-var vscodeSettingsCandidates = (home = homedir(), platform = process.platform) => {
+var vscodeSettingsCandidates = (home = homedir2(), platform = process.platform) => {
   const root = settingsRoot(home, platform);
-  return VSCODE_PRODUCTS.map((product) => join(root, product, "User", "settings.json"));
+  return VSCODE_PRODUCTS.map((product) => join2(root, product, "User", "settings.json"));
 };
 var vscodeSettingsTargets = (exists, home, platform) => {
   const candidates = vscodeSettingsCandidates(home, platform);
@@ -521,9 +828,9 @@ var vscodeSettingsTargets = (exists, home, platform) => {
 
 // src/setup/detect.ts
 import { execSync } from "child_process";
-import { existsSync as existsSync2 } from "fs";
-import { homedir as homedir2 } from "os";
-import { dirname, join as join2 } from "path";
+import { existsSync as existsSync3 } from "fs";
+import { homedir as homedir3 } from "os";
+import { dirname, join as join3 } from "path";
 var whichCommand = () => process.platform === "win32" ? "where" : "which";
 var binaryOnPath = (binary) => {
   try {
@@ -533,7 +840,7 @@ var binaryOnPath = (binary) => {
     return false;
   }
 };
-var defaultDeps = { onPath: binaryOnPath, exists: existsSync2 };
+var defaultDeps = { onPath: binaryOnPath, exists: existsSync3 };
 var detectAgent = (probe, deps = defaultDeps) => {
   const checked = [];
   if (probe.binary) {
@@ -555,12 +862,12 @@ var detectAgent = (probe, deps = defaultDeps) => {
   }
   return { kind: "not-found", checked };
 };
-var agentProbes = (home = homedir2()) => ({
+var agentProbes = (home = homedir3()) => ({
   claude_code: {
     binary: "claude",
     // The native installer puts it here, outside a default non-login PATH.
-    paths: [join2(home, ".local", "bin", "claude")],
-    configMarkers: [join2(home, ".claude")]
+    paths: [join3(home, ".local", "bin", "claude")],
+    configMarkers: [join3(home, ".claude")]
   },
   codex: {
     binary: "codex",
@@ -570,25 +877,25 @@ var agentProbes = (home = homedir2()) => ({
   gemini_cli: {
     binary: "gemini",
     paths: [],
-    configMarkers: [join2(home, ".gemini")]
+    configMarkers: [join3(home, ".gemini")]
   },
   hermes: {
     binary: "hermes",
     paths: [],
-    configMarkers: [join2(home, ".hermes")]
+    configMarkers: [join3(home, ".hermes")]
   },
   cursor: {
     // GUI editor. `cursor` on PATH only exists if the user ran "Install 'cursor'
     // command in PATH" from the command palette, which most never do.
     binary: "cursor",
-    paths: process.platform === "darwin" ? ["/Applications/Cursor.app"] : process.platform === "win32" ? [join2(process.env.LOCALAPPDATA ?? join2(home, "AppData", "Local"), "Programs", "cursor")] : ["/usr/share/cursor", join2(home, ".local", "share", "cursor")],
-    configMarkers: [join2(home, ".cursor")]
+    paths: process.platform === "darwin" ? ["/Applications/Cursor.app"] : process.platform === "win32" ? [join3(process.env.LOCALAPPDATA ?? join3(home, "AppData", "Local"), "Programs", "cursor")] : ["/usr/share/cursor", join3(home, ".local", "share", "cursor")],
+    configMarkers: [join3(home, ".cursor")]
   },
   vscode: {
     // Like Cursor, a GUI editor: `code` on PATH only exists if the user ran
     // "Shell Command: Install 'code' command in PATH", which on macOS is opt-in.
     binary: "code",
-    paths: process.platform === "darwin" ? ["/Applications/Visual Studio Code.app"] : process.platform === "win32" ? [join2(process.env.LOCALAPPDATA ?? join2(home, "AppData", "Local"), "Programs", "Microsoft VS Code")] : ["/usr/share/code", join2(home, ".local", "share", "code")],
+    paths: process.platform === "darwin" ? ["/Applications/Visual Studio Code.app"] : process.platform === "win32" ? [join3(process.env.LOCALAPPDATA ?? join3(home, "AppData", "Local"), "Programs", "Microsoft VS Code")] : ["/usr/share/code", join3(home, ".local", "share", "code")],
     // The settings directory rather than ~/.vscode, because the settings
     // directory is what this installer actually writes to. Insiders counts:
     // someone running only Insiders still has VS Code.
@@ -604,7 +911,7 @@ var agentProbes = (home = homedir2()) => ({
   },
   fx: {
     binary: null,
-    paths: [join2(home, ".fx", "settings.json"), join2(home, ".fx", "sessions"), join2(home, ".fx", "history.jsonl")],
+    paths: [join3(home, ".fx", "settings.json"), join3(home, ".fx", "sessions"), join3(home, ".fx", "history.jsonl")],
     configMarkers: []
   },
   ...compatibleProbes(),
@@ -628,7 +935,7 @@ var detectAllAgents = (deps = defaultDeps, home) => {
   }));
 };
 var isDetected = (result) => result.kind === "installed";
-var shortenHome = (path, home = homedir2()) => home && path.startsWith(home) ? `~${path.slice(home.length)}` : path;
+var shortenHome = (path, home = homedir3()) => home && path.startsWith(home) ? `~${path.slice(home.length)}` : path;
 var describeDetection = (result, home) => {
   if (result.kind !== "installed") return null;
   const evidence = shortenHome(result.evidence, home);
@@ -636,7 +943,7 @@ var describeDetection = (result, home) => {
 };
 
 // src/instruction-file.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync, mkdirSync, rmSync } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync, rmSync as rmSync2 } from "fs";
 import { dirname as dirname2 } from "path";
 var PUSHARY_BEGIN = "<!-- BEGIN PUSHARY (managed by @pushary/agent-hooks; do not edit this block) -->";
 var PUSHARY_END = "<!-- END PUSHARY -->";
@@ -666,10 +973,10 @@ ${body}
 ${PUSHARY_END}`;
 var writeInstructionBlock = (filePath, body) => {
   const dir = dirname2(filePath);
-  if (!existsSync3(dir)) mkdirSync(dir, { recursive: true });
+  if (!existsSync4(dir)) mkdirSync(dir, { recursive: true });
   let existing = "";
   try {
-    existing = readFileSync2(filePath, "utf-8");
+    existing = readFileSync3(filePath, "utf-8");
   } catch {
   }
   const block = wrap(body);
@@ -682,12 +989,12 @@ var writeInstructionBlock = (filePath, body) => {
     const prefix = existing.trim() ? existing.replace(/\s*$/, "") + "\n\n" : "";
     next = prefix + block + "\n";
   }
-  writeFileSync(filePath, next, "utf-8");
+  writeFileSync2(filePath, next, "utf-8");
 };
 var removeInstructionBlock = (filePath) => {
   let existing = "";
   try {
-    existing = readFileSync2(filePath, "utf-8");
+    existing = readFileSync3(filePath, "utf-8");
   } catch {
     return false;
   }
@@ -696,21 +1003,28 @@ var removeInstructionBlock = (filePath) => {
   if (start === -1 || end === -1 || end < start) return false;
   const remaining = (existing.slice(0, start) + existing.slice(end + PUSHARY_END.length)).trim();
   if (remaining === "") {
-    rmSync(filePath, { force: true });
+    rmSync2(filePath, { force: true });
   } else {
-    writeFileSync(filePath, remaining + "\n", "utf-8");
+    writeFileSync2(filePath, remaining + "\n", "utf-8");
   }
   return true;
 };
 var hasInstructionBlock = (filePath) => {
   try {
-    return readFileSync2(filePath, "utf-8").includes(PUSHARY_BEGIN);
+    return readFileSync3(filePath, "utf-8").includes(PUSHARY_BEGIN);
   } catch {
     return false;
   }
 };
 
 export {
+  isHermesConfigReceipt,
+  HERMES_PIP_PACKAGE,
+  HERMES_PLUGIN_NAME,
+  resolveHermesPython,
+  runHermesConfigScript,
+  hermesWiredByPushary,
+  readHermesStatus,
   FX_PUSHARY_TOOLS_RULE,
   FX_TOOL_DISCOVERY_NOTE,
   FX_PROFILE_REFUSALS,