@pushary/agent-hooks 0.92.1 → 0.93.0

package/dist/chunk-QQSQWLFR.js

@@ -0,0 +1,53 @@
+import {
+  ASKED_IN_EVERY_MODE_TOOLS
+} from "./chunk-VNMKIJZB.js";
+
+// src/claude-tools.ts
+var PRETOOLUSE_GATED_TOOLS = [
+  "Bash",
+  "Write",
+  "Edit",
+  "MultiEdit",
+  "NotebookEdit",
+  "PowerShell",
+  "Monitor"
+];
+var PRETOOLUSE_PHONE_ANSWERED_TOOLS = ASKED_IN_EVERY_MODE_TOOLS;
+var POSTTOOLUSE_MIRROR_ONLY_TOOLS = ["TodoWrite", "Task", "WebFetch", "WebSearch"];
+var POSTTOOLUSE_MIRRORED_TOOLS = [...PRETOOLUSE_GATED_TOOLS, ...POSTTOOLUSE_MIRROR_ONLY_TOOLS];
+var PRETOOLUSE_HANDLED_TOOLS = /* @__PURE__ */ new Set([...PRETOOLUSE_GATED_TOOLS, ...PRETOOLUSE_PHONE_ANSWERED_TOOLS]);
+
+// src/claude-notifications.ts
+var NOTIFICATION_MATCHED_TYPES = [
+  // Blocks. The agent, or one of its workers, is waiting on a person.
+  "permission_prompt",
+  "idle_prompt",
+  "agent_needs_input",
+  "worker_permission_prompt",
+  // An MCP server asking the person for a value. The Elicitation hook answers it;
+  // this is the feed row saying one is open.
+  "elicitation_dialog",
+  "elicitation_url_dialog",
+  // Turn boundary.
+  "agent_completed",
+  // Quota. The island already reads plan usage, and these say when a limit hit,
+  // went stale, or was turned off, which no polling of the usage endpoint reveals.
+  "quota_auto_resume_fired",
+  "quota_auto_resume_stale",
+  "quota_auto_resume_disabled"
+];
+var NOTIFICATION_PUSH_TYPES = /* @__PURE__ */ new Set([
+  "idle_prompt",
+  "agent_needs_input",
+  "worker_permission_prompt"
+]);
+
+export {
+  PRETOOLUSE_GATED_TOOLS,
+  PRETOOLUSE_PHONE_ANSWERED_TOOLS,
+  POSTTOOLUSE_MIRROR_ONLY_TOOLS,
+  POSTTOOLUSE_MIRRORED_TOOLS,
+  PRETOOLUSE_HANDLED_TOOLS,
+  NOTIFICATION_MATCHED_TYPES,
+  NOTIFICATION_PUSH_TYPES
+};

package/dist/{chunk-F7OURW3C.js → chunk-RER3FRTD.js}

@@ -1,6 +1,6 @@
 import {
   callMcpTool
-} from "./chunk-BSZYIAZL.js";
+} from "./chunk-EYRGBYZG.js";
 import {
   installProxyDispatcher
 } from "./chunk-SAF6HGAA.js";
@@ -33,11 +33,11 @@ var askUser = async (apiKey, params, timeoutMs = 15e3) => {
   if (!isAskUserResponse(result)) throw new Error("Invalid ask_user response");
   return result;
 };
-var waitForAnswer = async (apiKey, correlationId, timeoutMs = 3e4) => {
+var waitForAnswer = async (apiKey, correlationId, timeoutMs = 3e4, signal) => {
   const result = await callMcpTool(apiKey, "wait_for_answer", {
     correlationId,
     timeoutMs
-  }, { timeoutMs: timeoutMs + 1e4 });
+  }, { timeoutMs: timeoutMs + 1e4, signal });
   if (!isWaitForAnswerResponse(result)) throw new Error("Invalid wait_for_answer response");
   return result;
 };
@@ -59,11 +59,11 @@ var pollForAnswer = async (apiKey, correlationId, deadlineMs, pollInterval = 2e3
   }
   return { answered: false };
 };
-var cancelQuestion = async (apiKey, correlationId) => {
-  await callMcpTool(apiKey, "cancel_question", { correlationId });
+var cancelQuestion = async (apiKey, correlationId, signal) => {
+  await callMcpTool(apiKey, "cancel_question", { correlationId }, { signal });
 };
-var sendNotification = async (apiKey, params, timeoutMs = 15e3) => {
-  await callMcpTool(apiKey, "send_notification", { ...params }, { maxRetries: 3, timeoutMs });
+var sendNotification = async (apiKey, params, timeoutMs = 15e3, signal) => {
+  await callMcpTool(apiKey, "send_notification", { ...params }, { maxRetries: signal ? 1 : 3, timeoutMs, signal });
 };
 
 // src/pending.ts

package/dist/{chunk-2XQSN66Q.js → chunk-T2PKGGDM.js}

@@ -1,6 +1,6 @@
 import {
   getMachineId
-} from "./chunk-2ACC5M7F.js";
+} from "./chunk-72FWXLW2.js";
 import {
   getPackageVersion
 } from "./chunk-DINDL2CF.js";

package/dist/{chunk-I3ORVBTP.js → chunk-TFN7ZCTI.js}

@@ -1,11 +1,11 @@
 import {
   detectClaudeVersion
-} from "./chunk-HDORB7WD.js";
+} from "./chunk-WEDYCMHU.js";
 import {
   claudeWired,
   codexWired,
   geminiWired
-} from "./chunk-ZMKKK6DC.js";
+} from "./chunk-6Y4IKMQT.js";
 import {
   CLAUDE_HOOK_EVENTS,
   GEMINI_HOOK_BINARY,
@@ -19,7 +19,7 @@ import {
   needsReregistration,
   registrationSignatures,
   supportedClaudeEvents
-} from "./chunk-I7W3UTDK.js";
+} from "./chunk-YUZYMAL7.js";
 import {
   guardBinary
 } from "./chunk-EZIEXHYM.js";
@@ -38,7 +38,7 @@ import {
   codexHooksJson,
   hasCodexHooks,
   vscodePluginMcp
-} from "./chunk-CV2YD2JR.js";
+} from "./chunk-N3TF3RQ2.js";
 import {
   readJsonSafe,
   writeJsonAtomic

package/dist/{chunk-SQYBP3QQ.js → chunk-TWVZHZM3.js}

@@ -7,10 +7,10 @@ import {
 } from "./chunk-L4ZCFMWW.js";
 import {
   getMachineId
-} from "./chunk-2ACC5M7F.js";
+} from "./chunk-72FWXLW2.js";
 import {
   pusharyDir
-} from "./chunk-CV2YD2JR.js";
+} from "./chunk-N3TF3RQ2.js";
 import {
   getPackageVersion
 } from "./chunk-DINDL2CF.js";

package/dist/{chunk-L4E2BIJ2.js → chunk-UAFQC35P.js}

@@ -20,8 +20,14 @@ var hookPrefixes = {
   // Without an entry here the fallback stringifies the whole tool input, and for
   // ExitPlanMode that input IS the plan: the action line became a truncated dump of
   // the plan markdown. The plan belongs in the body, not the one-line summary.
-  ExitPlanMode: () => "finished planning and wants to start coding"
-};
+  ExitPlanMode: () => "finished planning and wants to start coding",
+  // Mirrored on PostToolUse since the matcher was widened. Without entries the
+  // fallback prints `Task: done` and `WebSearch: done`, which name the tool and
+  // drop the only part a person reads: which subagent, and what it looked for.
+  Task: (input) => `subagent: ${describeTaskCall(input)}`,
+  WebSearch: (input) => `web search: ${firstString(input.query) ?? "(no query)"}`
+};
+var describeTaskCall = (input) => firstString(input.description) ?? firstString(input.subagent_type) ?? "(unnamed)";
 var describeTodoProgress = (todos) => {
   if (!Array.isArray(todos)) return "updated the plan";
   const items = todos.filter((t) => !!t && typeof t === "object");
@@ -42,7 +48,9 @@ var eventPrefixes = {
   Edit: (input) => `edited: ${input.file_path ?? "unknown"}`,
   MultiEdit: (input) => `edited: ${input.file_path ?? "unknown"}`,
   Read: (input) => `read: ${input.file_path ?? "unknown"}`,
-  TodoWrite: (input) => describeTodoProgress(input.todos)
+  TodoWrite: (input) => describeTodoProgress(input.todos),
+  Task: (input) => `ran subagent: ${describeTaskCall(input)}`,
+  WebSearch: (input) => `searched: ${firstString(input.query) ?? "the web"}`
 };
 var MCP_TOOL_PREFIX = "mcp__";
 var parseMcpToolName = (toolName) => {
@@ -287,6 +295,7 @@ var AGENT_IDENTITIES = {
   vscode: { type: "vscode", label: AGENT_LABELS_BY_TYPE.vscode },
   opencode: { type: "opencode", label: AGENT_LABELS_BY_TYPE.opencode }
 };
+var TEAMMATE_IDLE_ACTION = "A teammate went idle";
 var TASK_TITLE_MAX_LENGTH = 120;
 var STOP_SUMMARY_MAX_LENGTH = 200;
 var SESSION_END_ACTIONS = {
@@ -333,6 +342,45 @@ var sessionStartAction = (source) => source === "resume" ? "Session resumed" : "
 var sessionEndAction = (reason) => typeof reason === "string" && SESSION_END_ACTIONS[reason] || "Session ended";
 var taskTitleFrom = (prompt) => typeof prompt === "string" ? prompt.replace(/\s+/g, " ").trim().slice(0, TASK_TITLE_MAX_LENGTH) || void 0 : void 0;
 var asString = (value) => typeof value === "string" && value.length > 0 ? value : void 0;
+var NOTIFICATION_ACTION_MAX_LENGTH = 200;
+var STOP_FAILURE_REASON_MAX_LENGTH = 300;
+var notificationTypeOf = (payload) => asString(payload.notification_type) ?? asString(payload.type);
+var notificationAction = (payload) => {
+  const text = asString(payload.message) ?? asString(payload.title);
+  const collapsed = redactSecrets(text ?? "").replace(/\s+/g, " ").trim();
+  return collapsed ? collapsed.slice(0, NOTIFICATION_ACTION_MAX_LENGTH) : "Notification";
+};
+var STOP_FAILURE_REASONS = {
+  rate_limit: "Rate limited by the API",
+  overloaded: "The API is overloaded right now",
+  authentication_failed: "Authentication failed",
+  billing_error: "A billing error stopped the turn"
+};
+var STOP_FAILURE_FALLBACK = "The turn ended on an API error (rate limit, billing, or auth).";
+var describeStopFailure = (error) => {
+  const fromString = (value) => {
+    const trimmed = value.trim();
+    if (!trimmed) return void 0;
+    return STOP_FAILURE_REASONS[trimmed] ?? redactSecrets(trimmed).slice(0, STOP_FAILURE_REASON_MAX_LENGTH);
+  };
+  if (typeof error === "string") {
+    const described = fromString(error);
+    if (described) return described;
+  } else if (error && typeof error === "object") {
+    for (const key of ["type", "message", "error", "code"]) {
+      const value = error[key];
+      if (typeof value === "string") {
+        const described = fromString(value);
+        if (described) return described;
+      }
+    }
+  }
+  return STOP_FAILURE_FALLBACK;
+};
+var permissionDeniedAction = (toolName) => {
+  const tool = asString(toolName);
+  return tool ? `Auto-mode blocked ${tool}` : "Auto-mode blocked a tool call";
+};
 var sessionIdentityOf = (payload) => {
   const sessionId = asString(payload.session_id);
   const agentId = asString(payload.agent_id);
@@ -356,11 +404,16 @@ export {
   deriveAction,
   deriveBlocker,
   AGENT_IDENTITIES,
+  TEAMMATE_IDLE_ACTION,
   summarizeStop,
   subagentStopSummary,
   compactionAction,
   sessionStartAction,
   sessionEndAction,
   taskTitleFrom,
+  notificationTypeOf,
+  notificationAction,
+  describeStopFailure,
+  permissionDeniedAction,
   sessionIdentityOf
 };

package/dist/{chunk-PYA4FLKI.js → chunk-UPCPR7QW.js}

@@ -12,7 +12,7 @@ import {
 } from "./chunk-5RUIFDTP.js";
 import {
   callMcpTool
-} from "./chunk-BSZYIAZL.js";
+} from "./chunk-EYRGBYZG.js";
 import {
   reportedInstallSource
 } from "./chunk-JW4KO5AF.js";

package/dist/{chunk-HDORB7WD.js → chunk-WEDYCMHU.js}

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

package/dist/{chunk-I7W3UTDK.js → chunk-YUZYMAL7.js}

@@ -1,13 +1,15 @@
-import {
-  PRETOOLUSE_GATED_TOOLS,
-  PRETOOLUSE_PHONE_ANSWERED_TOOLS
-} from "./chunk-2LAHXHBR.js";
 import {
   guardBinary
 } from "./chunk-EZIEXHYM.js";
+import {
+  NOTIFICATION_MATCHED_TYPES,
+  POSTTOOLUSE_MIRRORED_TOOLS,
+  PRETOOLUSE_GATED_TOOLS,
+  PRETOOLUSE_PHONE_ANSWERED_TOOLS
+} from "./chunk-QQSQWLFR.js";
 import {
   isProtectedByScope
-} from "./chunk-CV2YD2JR.js";
+} from "./chunk-N3TF3RQ2.js";
 import {
   HOOK_BUDGETS,
   HOOK_LOCATOR_BINARY
@@ -32,7 +34,7 @@ var formatVersion = (version) => version.join(".");
 
 // src/claude-events.ts
 var GATED_TOOLS = [...PRETOOLUSE_GATED_TOOLS, ...PRETOOLUSE_PHONE_ANSWERED_TOOLS].join("|");
-var MIRRORED_TOOLS = [...PRETOOLUSE_GATED_TOOLS, "TodoWrite"].join("|");
+var MIRRORED_TOOLS = POSTTOOLUSE_MIRRORED_TOOLS.join("|");
 var ESTABLISHED = [1, 0, 0];
 var OBSERVED = [2, 0, 0];
 var CLAUDE_HOOK_EVENTS = [
@@ -40,7 +42,7 @@ var CLAUDE_HOOK_EVENTS = [
   { event: "PostToolUse", binary: "pushary-post-hook", matcher: MIRRORED_TOOLS, timeout: 10, delivery: "telemetry", since: ESTABLISHED },
   { event: "Stop", binary: "pushary-stop-hook", timeout: 10, delivery: "telemetry", since: ESTABLISHED },
   { event: "UserPromptSubmit", binary: "pushary-prompt-hook", timeout: 10, delivery: "telemetry", since: ESTABLISHED },
-  { event: "Notification", binary: "pushary-notification-hook", matcher: "permission_prompt|idle_prompt|agent_needs_input|agent_completed", timeout: 10, delivery: "telemetry", since: ESTABLISHED },
+  { event: "Notification", binary: "pushary-notification-hook", matcher: NOTIFICATION_MATCHED_TYPES.join("|"), timeout: 10, delivery: "telemetry", since: ESTABLISHED },
   { event: "SessionStart", binary: "pushary-session-start-hook", matcher: "startup|resume|clear", timeout: 10, delivery: "telemetry", since: ESTABLISHED },
   { event: "SessionEnd", binary: "pushary-session-end-hook", timeout: 10, delivery: "telemetry", since: ESTABLISHED },
   { event: "StopFailure", binary: "pushary-stopfailure-hook", timeout: 10, delivery: "telemetry", since: ESTABLISHED },

package/dist/src/index.d.ts

@@ -16,7 +16,7 @@ declare const handlePreToolUse: (input: ToolInput) => Promise<HookOutput | undef
 
 declare const getPolicy: (apiKey: string, expectedVersion?: string | null, agent?: string, repoAware?: boolean, sessionId?: string) => Promise<PolicyConfig>;
 
-declare const fetchModeState: (apiKey: string, sessionId?: string, reuseWithinMs?: number) => Promise<ModeState>;
+declare const fetchModeState: (apiKey: string, sessionId?: string, reuseWithinMs?: number, signal?: AbortSignal) => Promise<ModeState>;
 declare const fetchModeOverride: (apiKey: string) => Promise<ApprovalMode | null>;
 
 interface UsageReport {
@@ -52,8 +52,35 @@ interface AgentEvent {
     pid?: number;
 }
 interface ReportEventOptions {
+    signal?: AbortSignal;
     maxAttempts?: number;
     timeoutMs?: number;
+    /**
+     * Total wall clock this call may spend, acknowledge round trip included.
+     *
+     * Deliberately not `timeoutMs`. That option doubles as the "I am a side report"
+     * signal (`clientCanDrain` below is keyed on its absence), so a drain-carrying
+     * caller that set it to bound its time would silently stop delivering the
+     * instructions a person sent from their phone. This bounds the clock and says
+     * nothing about draining.
+     *
+     * Without it, a single report could spend `timeoutMs ?? 10_000` on the event
+     * POST and then a further `timeoutMs ?? 10_000` acknowledging a pending command,
+     * which is twice the ceiling the hook was given and, on Codex, twice what the
+     * agent will wait before killing the process mid-flight.
+     */
+    budgetMs?: number;
+    /**
+     * Tells the server not to pop a queued instruction for this report.
+     *
+     * `canDrainCommand: false` is not enough. The route's first disjunct is
+     * `event === "session_end" && consumesDrainedCommand(agentType)`, which never
+     * reads that flag, so any `session_end` from an agent whose Stop carries text
+     * back pops the queue destructively. A subagent's stop is a `session_end` and
+     * its caller throws the response away, which is a queued instruction destroyed
+     * rather than delivered. `skipCommandDrain` is the route's own first check.
+     */
+    skipDrain?: boolean;
     requireOk?: boolean;
     /**
      * Authenticate with this key instead of the ambient one.
@@ -102,6 +129,7 @@ declare const handleNotification: (input: {
     title?: string;
     type?: string;
     notification_type?: string;
+    hook_event_name?: string;
     cwd?: string;
     session_id?: string;
 }, agent?: AgentIdentity) => Promise<void>;
@@ -148,8 +176,8 @@ interface AnswerResult {
     note?: string;
 }
 declare const askUser: (apiKey: string, params: AskUserParams, timeoutMs?: number) => Promise<AskUserResponse>;
-declare const waitForAnswer: (apiKey: string, correlationId: string, timeoutMs?: number) => Promise<AnswerResult>;
-declare const cancelQuestion: (apiKey: string, correlationId: string) => Promise<void>;
+declare const waitForAnswer: (apiKey: string, correlationId: string, timeoutMs?: number, signal?: AbortSignal) => Promise<AnswerResult>;
+declare const cancelQuestion: (apiKey: string, correlationId: string, signal?: AbortSignal) => Promise<void>;
 
 declare const getApiKey: () => string;
 declare const getBaseUrl: () => string;

package/dist/src/index.js

@@ -1,10 +1,9 @@
 import {
   handlePreToolUse
-} from "../chunk-RQPQSJJH.js";
-import "../chunk-2LAHXHBR.js";
+} from "../chunk-HCLSTQ3N.js";
 import {
   fetchAccountPublicKey
-} from "../chunk-QZCFVWA7.js";
+} from "../chunk-EQRS3SGM.js";
 import "../chunk-I463AEG3.js";
 import "../chunk-VHWCVD42.js";
 import "../chunk-YHG74UFF.js";
@@ -16,16 +15,17 @@ import {
   handlePostToolUse,
   handleStop,
   reportEvent
-} from "../chunk-YXDYKECP.js";
+} from "../chunk-G5L3WVFV.js";
 import {
   askUser,
   cancelQuestion,
   waitForAnswer
-} from "../chunk-F7OURW3C.js";
-import "../chunk-L4E2BIJ2.js";
-import "../chunk-2ACC5M7F.js";
-import "../chunk-CV2YD2JR.js";
-import "../chunk-BSZYIAZL.js";
+} from "../chunk-RER3FRTD.js";
+import "../chunk-UAFQC35P.js";
+import "../chunk-QQSQWLFR.js";
+import "../chunk-72FWXLW2.js";
+import "../chunk-N3TF3RQ2.js";
+import "../chunk-EYRGBYZG.js";
 import "../chunk-SAF6HGAA.js";
 import "../chunk-7QLSKOSU.js";
 import "../chunk-KZERVKTD.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushary/agent-hooks",
-  "version": "0.92.1",
+  "version": "0.93.0",
   "description": "Permission hooks for AI coding agents: route tool approvals through Pushary push notifications",
   "keywords": [
     "pushary",
@@ -31,7 +31,7 @@
   "license": "MIT",
   "type": "module",
   "engines": {
-    "node": ">=20"
+    "node": ">=20.3.0"
   },
   "main": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",

package/dist/chunk-2LAHXHBR.js

@@ -1,23 +0,0 @@
-import {
-  ASKED_IN_EVERY_MODE_TOOLS
-} from "./chunk-VNMKIJZB.js";
-
-// src/claude-tools.ts
-var PRETOOLUSE_GATED_TOOLS = [
-  "Bash",
-  "Write",
-  "Edit",
-  "MultiEdit",
-  "NotebookEdit",
-  "PowerShell",
-  "Monitor"
-];
-var PRETOOLUSE_PHONE_ANSWERED_TOOLS = ASKED_IN_EVERY_MODE_TOOLS;
-var POSTTOOLUSE_MIRRORED_TOOLS = [...PRETOOLUSE_GATED_TOOLS, "TodoWrite"];
-var PRETOOLUSE_HANDLED_TOOLS = /* @__PURE__ */ new Set([...PRETOOLUSE_GATED_TOOLS, ...PRETOOLUSE_PHONE_ANSWERED_TOOLS]);
-
-export {
-  PRETOOLUSE_GATED_TOOLS,
-  PRETOOLUSE_PHONE_ANSWERED_TOOLS,
-  PRETOOLUSE_HANDLED_TOOLS
-};