@keeperhub/wallet 0.1.7 → 0.1.9

package/dist/index.cjs

@@ -43,8 +43,10 @@ __export(index_exports, {
   paymentSigner: () => paymentSigner,
   readWalletConfig: () => readWalletConfig,
   registerClaudeCodeHook: () => registerClaudeCodeHook,
+  resolveHookCommand: () => resolveHookCommand,
   runCli: () => runCli,
   runHookCli: () => runHookCli,
+  selectProtocol: () => selectProtocol,
   tempo: () => tempo,
   validateAndMerge: () => validateAndMerge,
   writeWalletConfig: () => writeWalletConfig
@@ -195,15 +197,69 @@ function fund(walletAddress) {
 }
 
 // src/skill-install.ts
+var import_node_child_process = require("child_process");
 var import_promises = require("fs/promises");
+var import_node_fs2 = require("fs");
 var import_node_path2 = require("path");
 var import_node_url = require("url");
-var HOOK_COMMAND = "keeperhub-wallet-hook";
-var KEEPERHUB_HOOK_MARKER = "keeperhub-wallet-hook";
-function buildKeeperhubEntry() {
+var HOOK_BIN = "keeperhub-wallet-hook";
+var HOOK_COMMAND_BARE = HOOK_BIN;
+var PACKAGE_NAME = "@keeperhub/wallet";
+function readPackageVersion() {
+  try {
+    const here = (0, import_node_path2.dirname)((0, import_node_url.fileURLToPath)(__filename));
+    const pkgPath = (0, import_node_path2.join)(here, "..", "package.json");
+    const raw = (0, import_node_fs2.readFileSync)(pkgPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.version === "string" && parsed.version.length > 0) {
+      return parsed.version;
+    }
+  } catch {
+  }
+  return "latest";
+}
+function buildNpxCommand(version) {
+  return `npx -y -p ${PACKAGE_NAME}@${version} ${HOOK_BIN}`;
+}
+var KEEPERHUB_HOOK_MARKER = HOOK_BIN;
+function filterKeeperhubHooksFromEntry(entry) {
+  if (typeof entry !== "object" || entry === null) {
+    return entry;
+  }
+  const candidate = entry;
+  if (!Array.isArray(candidate.hooks)) {
+    return entry;
+  }
+  const survivors = candidate.hooks.filter((h) => {
+    const cmd = h?.command;
+    return !(typeof cmd === "string" && cmd.includes(KEEPERHUB_HOOK_MARKER));
+  });
+  if (survivors.length === candidate.hooks.length) {
+    return entry;
+  }
+  if (survivors.length === 0) {
+    return null;
+  }
+  return { ...candidate, hooks: survivors };
+}
+function resolveHookCommand() {
+  const envOverride = process.env.KEEPERHUB_WALLET_HOOK_COMMAND;
+  if (envOverride && envOverride.length > 0) {
+    return envOverride;
+  }
+  try {
+    (0, import_node_child_process.execFileSync)("/bin/sh", ["-c", `command -v ${HOOK_BIN}`], {
+      stdio: "ignore"
+    });
+    return HOOK_COMMAND_BARE;
+  } catch {
+    return buildNpxCommand(readPackageVersion());
+  }
+}
+function buildKeeperhubEntry(command) {
   return {
     matcher: "*",
-    hooks: [{ type: "command", command: HOOK_COMMAND }]
+    hooks: [{ type: "command", command }]
   };
 }
 function resolveDefaultSkillSource() {
@@ -214,7 +270,8 @@ function defaultNotice(msg) {
   process.stderr.write(`${msg}
 `);
 }
-async function registerClaudeCodeHook(settingsPath) {
+async function registerClaudeCodeHook(settingsPath, options = {}) {
+  const command = options.hookCommand ?? resolveHookCommand();
   let raw = null;
   try {
     raw = await (0, import_promises.readFile)(settingsPath, "utf-8");
@@ -237,12 +294,12 @@ async function registerClaudeCodeHook(settingsPath) {
   const existingPreToolUse = Array.isArray(hooks.PreToolUse) ? hooks.PreToolUse : [];
   const filtered = [];
   for (const entry of existingPreToolUse) {
-    const serialised = JSON.stringify(entry);
-    if (!serialised.includes(KEEPERHUB_HOOK_MARKER)) {
-      filtered.push(entry);
+    const survivor = filterKeeperhubHooksFromEntry(entry);
+    if (survivor !== null) {
+      filtered.push(survivor);
     }
   }
-  filtered.push(buildKeeperhubEntry());
+  filtered.push(buildKeeperhubEntry(command));
   hooks.PreToolUse = filtered;
   config.hooks = hooks;
   await (0, import_promises.mkdir)((0, import_node_path2.dirname)(settingsPath), { recursive: true, mode: 448 });
@@ -258,26 +315,27 @@ async function writeSkillToAgent(agent, skillSource) {
   await (0, import_promises.chmod)(target, 420);
   return { agent: agent.agent, path: target, status: "written" };
 }
-function buildNoticeMessage(agent) {
-  return `${agent.agent} does not support auto-registered PreToolUse hooks; run \`${HOOK_COMMAND}\` on every tool use via ${agent.agent}'s settings file at ${agent.settingsFile}`;
+function buildNoticeMessage(agent, command) {
+  return `${agent.agent} does not support auto-registered PreToolUse hooks; run \`${command}\` on every tool use via ${agent.agent}'s settings file at ${agent.settingsFile}`;
 }
 async function installSkill(options = {}) {
   const agents = detectAgents(options.homeOverride);
   const skillSource = options.skillSourcePath ?? resolveDefaultSkillSource();
   const onNotice = options.onNotice ?? defaultNotice;
+  const hookCommand = options.hookCommand ?? resolveHookCommand();
   const skillWrites = [];
   const hookRegistrations = [];
   for (const agent of agents) {
     const write = await writeSkillToAgent(agent, skillSource);
     skillWrites.push(write);
     if (agent.hookSupport === "claude-code") {
-      await registerClaudeCodeHook(agent.settingsFile);
+      await registerClaudeCodeHook(agent.settingsFile, { hookCommand });
       hookRegistrations.push({
         agent: agent.agent,
         status: "registered"
       });
     } else {
-      const message = buildNoticeMessage(agent);
+      const message = buildNoticeMessage(agent, hookCommand);
       hookRegistrations.push({
         agent: agent.agent,
         status: "notice",
@@ -685,6 +743,26 @@ var DEFAULT_TOOL_RE = /keeperhub|wallet|sign/i;
 function defaultToolMatcher(name) {
   return DEFAULT_TOOL_RE.test(name);
 }
+function hasPaymentShape(input) {
+  const ti = input.tool_input ?? {};
+  const challenge = ti.paymentChallenge;
+  if (challenge !== void 0 && challenge !== null) {
+    return true;
+  }
+  if (ti.amount !== void 0 && ti.amount !== null) {
+    return true;
+  }
+  if (ti.unit !== void 0 && ti.unit !== null) {
+    return true;
+  }
+  for (const field of ["to", "contract", "assetAddress"]) {
+    const v = ti[field];
+    if (typeof v === "string" && ADDRESS_RE.test(v)) {
+      return true;
+    }
+  }
+  return false;
+}
 function extractAmountMicroUsdc(input) {
   const ti = input.tool_input ?? {};
   const challenge = ti.paymentChallenge ?? {};
@@ -734,6 +812,9 @@ async function createPreToolUseHook(options = {}) {
     if (!(typeof hookInput.tool_name === "string" && toolMatcher(hookInput.tool_name))) {
       return { decision: "allow" };
     }
+    if (!hasPaymentShape(hookInput)) {
+      return { decision: "allow" };
+    }
     const contractAddr = extractContractAddress(hookInput);
     const amountMicro = extractAmountMicroUsdc(hookInput);
     if (contractAddr && !safety.allowlisted_contracts.includes(contractAddr)) {
@@ -866,6 +947,30 @@ var NONCE_BYTES = 32;
 async function sleep(ms) {
   await new Promise((resolve) => setTimeout(resolve, ms));
 }
+function selectProtocol(x402, mpp, hint) {
+  const h = hint ?? "auto";
+  if (h === "x402") {
+    if (!x402) {
+      throw new KeeperHubError(
+        "X402_NOT_OFFERED",
+        "x402 is not offered by this endpoint"
+      );
+    }
+    return "x402";
+  }
+  if (h === "mpp") {
+    if (!mpp) {
+      throw new KeeperHubError(
+        "MPP_NOT_OFFERED",
+        "mpp is not offered by this endpoint"
+      );
+    }
+    return "mpp";
+  }
+  if (x402) return "x402";
+  if (mpp) return "mpp";
+  return null;
+}
 function createPaymentSigner(opts = {}) {
   const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
   const walletLoader = opts.walletLoader ?? readWalletConfig;
@@ -1008,12 +1113,13 @@ function createPaymentSigner(opts = {}) {
       return response;
     }
     const wallet = await walletLoader();
-    if (mpp) {
-      return payViaMpp(response, mpp, wallet, options);
-    }
-    if (x402) {
+    const protocol = selectProtocol(x402, mpp, options?.paymentHint);
+    if (protocol === "x402") {
       return payViaX402(response, x402, wallet, options);
     }
+    if (protocol === "mpp") {
+      return payViaMpp(response, mpp, wallet, options);
+    }
     return response;
   }
   return {
@@ -1026,7 +1132,8 @@ function createPaymentSigner(opts = {}) {
       return pay(first, {
         body: init?.body ?? void 0,
         headers: init?.headers,
-        method: init?.method
+        method: init?.method,
+        paymentHint: init?.paymentHint
       });
     }
   };
@@ -1057,8 +1164,10 @@ var paymentSigner = createPaymentSigner();
   paymentSigner,
   readWalletConfig,
   registerClaudeCodeHook,
+  resolveHookCommand,
   runCli,
   runHookCli,
+  selectProtocol,
   tempo,
   validateAndMerge,
   writeWalletConfig