@pushary/agent-hooks 0.85.2 → 0.87.0

package/dist/{chunk-Q4URN3E7.js → chunk-HAUTLCMA.js}

@@ -1,6 +1,6 @@
 import {
   parseVersion
-} from "./chunk-XJDL3MUE.js";
+} from "./chunk-5646VKR4.js";
 
 // src/setup/agent-probe.ts
 import { execSync } from "child_process";

package/dist/{chunk-Y7E2MC3G.js → chunk-HJ44HIUW.js}

@@ -1,18 +1,16 @@
 import {
-  PRETOOLUSE_HANDLED_TOOLS
-} from "./chunk-XJDL3MUE.js";
+  PRETOOLUSE_HANDLED_TOOLS,
+  PRETOOLUSE_PHONE_ANSWERED_TOOLS
+} from "./chunk-ATBKJNWS.js";
 import {
   isGatingMoment,
   recordKeylessMoment
-} from "./chunk-PKUNB3SN.js";
+} from "./chunk-7MBDFNUC.js";
 import {
   denyReasonFrom,
   isDeferAnswer
 } from "./chunk-YHG74UFF.js";
 import {
-  DEFAULT_SESSION,
-  askUser,
-  cancelQuestion,
   deriveAction,
   deriveActionBody,
   deriveBlocker,
@@ -23,12 +21,17 @@ import {
   readLastPrompt,
   readLastUserPrompt,
   repoKeyFor,
-  savePendingQuestion,
   scopePathFor,
-  sendNotification,
-  throttlePass,
-  waitForAnswer
-} from "./chunk-DPDUB4XF.js";
+  throttlePass
+} from "./chunk-V2XPF77V.js";
+import {
+  DEFAULT_SESSION,
+  askUser,
+  cancelQuestion,
+  pollForAnswer,
+  savePendingQuestion,
+  sendNotification
+} from "./chunk-J3YDT4HM.js";
 import {
   getMachineId
 } from "./chunk-RN3NOEJF.js";
@@ -45,7 +48,7 @@ import {
   hookWaitDeadline,
   parseAgentQuestionAnswers,
   resolveGate
-} from "./chunk-K337LIBD.js";
+} from "./chunk-7YJS2VTG.js";
 
 // src/decision-episode.ts
 var EPISODE_PATH = "/api/agent/decision-episode";
@@ -73,29 +76,11 @@ var reportDecisionEpisode = async (apiKey, input) => {
 import { basename, join } from "path";
 import { tmpdir } from "os";
 import { existsSync, writeFileSync } from "fs";
-var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var START_MS = Date.now();
 var allow = () => claudePreToolUseOutput("allow");
 var deny = (reason) => claudePreToolUseOutput("deny", reason);
 var allowWithInput = (updatedInput) => claudePreToolUseOutput("allow", void 0, updatedInput);
 var ask = (reason) => claudePreToolUseOutput("ask", reason);
-var pollForAnswer = async (apiKey, correlationId, deadlineMs, pollInterval = 2e3) => {
-  while (Date.now() < deadlineMs) {
-    const remaining = Math.min(Math.max(deadlineMs - Date.now(), 1e3), 3e4);
-    let answer;
-    try {
-      answer = await waitForAnswer(apiKey, correlationId, remaining);
-    } catch {
-      if (Date.now() + pollInterval >= deadlineMs) break;
-      await sleep(pollInterval);
-      continue;
-    }
-    if (answer.answered) return answer;
-    if (Date.now() + pollInterval >= deadlineMs) break;
-    await sleep(pollInterval);
-  }
-  return { answered: false };
-};
 var handlePushOnly = async (apiKey, description, projectName, timeoutSeconds, timeoutAction, sessionId, machineId, toolName, toolTarget, decision, signals) => {
   let result;
   try {
@@ -448,6 +433,47 @@ var handleAskUserQuestion = async (apiKey, input) => {
   if (!answers) return void 0;
   return allowWithInput({ ...input.tool_input ?? {}, answers });
 };
+var PLAN_APPROVE = "Approve, start coding";
+var PLAN_KEEP_PLANNING = "Keep planning";
+var handleExitPlanMode = async (apiKey, input) => {
+  const toolInput = input.tool_input ?? {};
+  const projectName = basename(input.cwd ?? process.cwd());
+  let result;
+  try {
+    result = await askUser(apiKey, {
+      question: `Approve the plan and start coding in ${projectName}?`,
+      type: "select",
+      options: [PLAN_APPROVE, PLAN_KEEP_PLANNING],
+      context: `Your agent finished planning in ${projectName} and is waiting to start.`,
+      agentName: `Claude Code - ${projectName}`,
+      sessionId: input.session_id,
+      machineId: getMachineId(),
+      toolName: "ExitPlanMode",
+      action: deriveAction("ExitPlanMode", toolInput),
+      // The plan markdown itself, through the same redaction and cap as any diff,
+      // so approving from a lock screen is a real decision and not a blind yes.
+      actionBody: deriveActionBody("ExitPlanMode", toolInput),
+      intent: readLastPrompt(input.session_id ?? DEFAULT_SESSION) ?? (input.transcript_path ? readLastUserPrompt(input.transcript_path) : void 0),
+      blocker: "Waiting for you to approve the plan"
+    });
+  } catch {
+    return void 0;
+  }
+  if (result.suppressed || result.noDevices) {
+    await cancelQuestion(apiKey, result.correlationId).catch(() => {
+    });
+    return void 0;
+  }
+  const deadline = hookWaitDeadline(START_MS, effectiveWaitSeconds("wait", 0, "claude"), "claude", Date.now());
+  const answer = await pollForAnswer(apiKey, result.correlationId, deadline);
+  const value = answer.answered ? (answer.value ?? "").trim() : "";
+  if (!value || isDeferAnswer(answer.value)) {
+    savePendingQuestion(input.session_id || DEFAULT_SESSION, result.correlationId);
+    return void 0;
+  }
+  if (value === PLAN_APPROVE) return allow();
+  return deny("Plan declined from the phone. Ask what to change before coding.");
+};
 var handleKeyless = (input) => {
   try {
     if (isGatingMoment(input.tool_name, input.tool_input ?? {})) {
@@ -493,6 +519,9 @@ var handlePreToolUse = async (input) => {
       return handleAskUserQuestion(apiKey, input);
     }
     if (verdict.kind === "deny") return deny(verdict.reason);
+    if (input.tool_name === "ExitPlanMode") {
+      return handleExitPlanMode(apiKey, input);
+    }
     if (shouldDeferToNativeMode(input.permission_mode, input.tool_name)) {
       return void 0;
     }
@@ -524,7 +553,7 @@ var toPermissionRequestOutput = (hookOutput) => {
 };
 var handlePermissionRequest = async (input) => {
   if (PRETOOLUSE_HANDLED_TOOLS.has(input.tool_name)) {
-    const reclaimDeferredExec = input.tool_name !== "AskUserQuestion" && shouldDeferToNativeMode(input.permission_mode, input.tool_name);
+    const reclaimDeferredExec = !PRETOOLUSE_PHONE_ANSWERED_TOOLS.includes(input.tool_name) && shouldDeferToNativeMode(input.permission_mode, input.tool_name);
     if (!reclaimDeferredExec) return void 0;
   }
   if (input.tool_name.startsWith("mcp__pushary__")) return void 0;

package/dist/{chunk-4U2YRHNF.js → chunk-IWL5LWIE.js}

@@ -1,6 +1,6 @@
 import {
   codexHomeFrom
-} from "./chunk-KJW6NKF7.js";
+} from "./chunk-B3V2H6SA.js";
 
 // src/vscode-config.ts
 import { homedir } from "os";
@@ -253,7 +253,7 @@ You have Pushary MCP tools that reach the user on their phone. Use them proactiv
 
 - When you need the user to make a decision or answer a clarifying question, call \`ask_user\` instead of guessing or stalling. Use type "confirm" for yes/no, "select" for a fixed set of options, and "input" for free text. \`ask_user\` blocks until the user replies or it times out, so you do not need a separate wait step.
 - Before any risky or irreversible step (deleting files, force pushing, spending money, sending external messages), call \`ask_user\` with type "confirm" and wait for approval.
-- Before starting a multi-step run that will change several files, call \`propose_scope\` once with the paths you expect to change, anything you promise not to touch, and what done means. The user agrees to the boundary in one tap, and after that only work outside it needs approving. Skip it for a single quick edit, and do not propose a new scope mid-run just to widen one: if you need to go outside the agreed scope, do the work and let the approval that follows widen it.
+- Before starting a multi-step run that will change several files, call \`propose_scope\` once with the paths you expect to change, anything you promise not to touch, and what done means. The user agrees to the boundary in one tap. A ratified boundary NARROWS what may proceed without asking, it does not pre-approve work inside it, so an action that would normally need approval still needs it. Skip it for a single quick edit, and do not propose a new scope mid-run just to widen one: if you need to go outside the agreed scope, do the work and let the approval that follows widen it.
 - When you are blocked, stuck, or hit an error you cannot resolve on your own, call \`send_notification\` so the user knows, and call \`ask_user\` if you need a decision to continue.
 - When a task that took several steps finishes, call \`send_notification\` so the user knows it is done. Always pass \`context\` with a \`type\` of "task_complete", "error" or "info": it is what tells Pushary this is a task update, so the user's own setting for where updates land can route it.
 - Use \`cancel_question\` to retract a pending question once it is no longer needed.

package/dist/chunk-J3YDT4HM.js

@@ -0,0 +1,128 @@
+import {
+  callMcpTool
+} from "./chunk-BSZYIAZL.js";
+import {
+  installProxyDispatcher
+} from "./chunk-SAF6HGAA.js";
+
+// src/api.ts
+import { randomUUID } from "crypto";
+
+// src/validate.ts
+var isPolicyConfig = (data) => {
+  if (!data || typeof data !== "object") return false;
+  const d = data;
+  return Array.isArray(d.policies) && typeof d.defaultTimeoutSeconds === "number" && typeof d.defaultTimeoutAction === "string";
+};
+var isAskUserResponse = (data) => {
+  if (!data || typeof data !== "object") return false;
+  const d = data;
+  return typeof d.correlationId === "string" && typeof d.status === "string";
+};
+var isWaitForAnswerResponse = (data) => {
+  if (!data || typeof data !== "object") return false;
+  const d = data;
+  return typeof d.answered === "boolean";
+};
+
+// src/api.ts
+installProxyDispatcher();
+var askUser = async (apiKey, params, timeoutMs = 15e3) => {
+  const identified = params.toolUseId || params.requestId ? params : { ...params, requestId: randomUUID() };
+  const result = await callMcpTool(apiKey, "ask_user", { ...identified, wait: false }, { maxRetries: 3, timeoutMs });
+  if (!isAskUserResponse(result)) throw new Error("Invalid ask_user response");
+  return result;
+};
+var waitForAnswer = async (apiKey, correlationId, timeoutMs = 3e4) => {
+  const result = await callMcpTool(apiKey, "wait_for_answer", {
+    correlationId,
+    timeoutMs
+  }, { timeoutMs: timeoutMs + 1e4 });
+  if (!isWaitForAnswerResponse(result)) throw new Error("Invalid wait_for_answer response");
+  return result;
+};
+var pollForAnswer = async (apiKey, correlationId, deadlineMs, pollInterval = 2e3) => {
+  const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+  while (Date.now() < deadlineMs) {
+    const remaining = Math.min(Math.max(deadlineMs - Date.now(), 1e3), 3e4);
+    let answer;
+    try {
+      answer = await waitForAnswer(apiKey, correlationId, remaining);
+    } catch {
+      if (Date.now() + pollInterval >= deadlineMs) break;
+      await sleep(pollInterval);
+      continue;
+    }
+    if (answer.answered) return answer;
+    if (Date.now() + pollInterval >= deadlineMs) break;
+    await sleep(pollInterval);
+  }
+  return { answered: false };
+};
+var cancelQuestion = async (apiKey, correlationId) => {
+  await callMcpTool(apiKey, "cancel_question", { correlationId });
+};
+var sendNotification = async (apiKey, params, timeoutMs = 15e3) => {
+  await callMcpTool(apiKey, "send_notification", { ...params }, { maxRetries: 3, timeoutMs });
+};
+
+// src/pending.ts
+import { join } from "path";
+import { tmpdir } from "os";
+import { existsSync, mkdirSync, writeFileSync, readdirSync, unlinkSync, rmSync, statSync } from "fs";
+var PENDING_DIR = join(tmpdir(), "pushary-pending");
+var DEFAULT_SESSION = "_no_session";
+var GRACE_MS = 10 * 60 * 1e3;
+var sanitize = (sessionId) => sessionId.replace(/[^A-Za-z0-9_-]/g, "_").slice(0, 128) || DEFAULT_SESSION;
+var dirFor = (sessionId) => join(PENDING_DIR, sanitize(sessionId));
+var isDefaultSession = (sessionId) => sanitize(sessionId) === DEFAULT_SESSION;
+var savePendingQuestion = (sessionId, correlationId) => {
+  const dir = dirFor(sessionId);
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  writeFileSync(join(dir, correlationId), "", "utf-8");
+};
+var listPendingQuestions = (sessionId) => {
+  const dir = dirFor(sessionId);
+  let files;
+  try {
+    files = readdirSync(dir);
+  } catch {
+    return [];
+  }
+  if (!isDefaultSession(sessionId)) return files;
+  const cutoff = Date.now() - GRACE_MS;
+  return files.filter((name) => {
+    try {
+      return statSync(join(dir, name)).mtimeMs < cutoff;
+    } catch {
+      return false;
+    }
+  });
+};
+var removePendingQuestion = (sessionId, correlationId) => {
+  try {
+    unlinkSync(join(dirFor(sessionId), correlationId));
+  } catch {
+  }
+};
+var removePendingSession = (sessionId) => {
+  try {
+    rmSync(dirFor(sessionId), { recursive: true, force: true });
+  } catch {
+  }
+};
+
+export {
+  isPolicyConfig,
+  askUser,
+  waitForAnswer,
+  pollForAnswer,
+  cancelQuestion,
+  sendNotification,
+  DEFAULT_SESSION,
+  isDefaultSession,
+  savePendingQuestion,
+  listPendingQuestions,
+  removePendingQuestion,
+  removePendingSession
+};

package/dist/{chunk-NTIUQB3E.js → chunk-JAICP7BA.js}

@@ -1,7 +1,7 @@
 import {
   describeKeyCheck,
   keyCheckFromResponse
-} from "./chunk-LSB6PFLN.js";
+} from "./chunk-A4I5JGCW.js";
 import {
   createIo
 } from "./chunk-5RUIFDTP.js";

package/dist/{chunk-HSGEEBBL.js → chunk-M7RYIZX6.js}

@@ -7,9 +7,9 @@ var HOOK_SHELL = "/bin/sh -c";
 var LOCATE = 'B=$(command -v "$0") || exit 0; [ -f "$B" ] || exit 0; [ -x "$B" ] || exit 0';
 var NODE_PRESENT = "command -v node >/dev/null 2>&1 || exit 0";
 var HOOK_GUARD_SCRIPTS = {
-  native_binary: `${LOCATE}; exec "$B"`,
-  node_binary: `${LOCATE}; ${NODE_PRESENT}; exec "$B"`,
-  node_script: `[ -f "$0" ] || exit 0; ${NODE_PRESENT}; exec node "$0"`
+  native_binary: `${LOCATE}; exec "$B" "$@"`,
+  node_binary: `${LOCATE}; ${NODE_PRESENT}; exec "$B" "$@"`,
+  node_script: `[ -f "$0" ] || exit 0; ${NODE_PRESENT}; exec node "$0" "$@"`
 };
 var BINARY_GUARDS = {
   native: "native_binary",

package/dist/{chunk-KZIGJLOX.js → chunk-OT4YD54Q.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-6MTNS63X.js";
 import {
   resolveInstallSourceFor
-} from "./chunk-CWV4CMB6.js";
+} from "./chunk-Y3UTTFTZ.js";
 import {
   configFilePath
 } from "./chunk-2UMNXADU.js";

package/dist/{chunk-LXWISFF3.js → chunk-QBWYNVKY.js}

@@ -1,6 +1,6 @@
 import {
   pusharyDir
-} from "./chunk-KJW6NKF7.js";
+} from "./chunk-B3V2H6SA.js";
 import {
   readJsonSafe
 } from "./chunk-6MTNS63X.js";

package/dist/{chunk-4YMWLMAP.js → chunk-SJVLFIYP.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-VT4IVERX.js";
 import {
   pusharyDir
-} from "./chunk-KJW6NKF7.js";
+} from "./chunk-B3V2H6SA.js";
 import {
   getMachineId
 } from "./chunk-RN3NOEJF.js";