@pushary/agent-hooks 0.32.1 → 0.33.0

package/dist/bin/pushary-claude.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin/pushary-claude.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+import {
+  getApiKey
+} from "../chunk-NKXSILEW.js";
+
+// src/wrapper/claudeBinary.ts
+import { statSync } from "fs";
+import { join, delimiter } from "path";
+var WRAPPER_ACTIVE_ENV = "PUSHARY_WRAPPER_ACTIVE";
+var isFile = (path) => {
+  try {
+    return statSync(path).isFile();
+  } catch {
+    return false;
+  }
+};
+var findClaudeBinary = () => {
+  const override = process.env.PUSHARY_CLAUDE_BIN?.trim();
+  if (override) return isFile(override) ? override : null;
+  const pathVar = process.env.PATH ?? "";
+  const exts = process.platform === "win32" ? [".cmd", ".exe", ".bat", ""] : [""];
+  for (const dir of pathVar.split(delimiter)) {
+    if (!dir) continue;
+    for (const ext of exts) {
+      const candidate = join(dir, `claude${ext}`);
+      if (isFile(candidate)) return candidate;
+    }
+  }
+  return null;
+};
+
+// src/wrapper/localPassthrough.ts
+import { spawn } from "child_process";
+var SIGNAL_NUMBERS = {
+  SIGHUP: 1,
+  SIGINT: 2,
+  SIGQUIT: 3,
+  SIGKILL: 9,
+  SIGTERM: 15
+};
+var FORWARDED_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
+var runLocalPassthrough = (binary, args2) => {
+  return new Promise((resolve) => {
+    let child;
+    try {
+      child = spawn(binary, args2, {
+        stdio: "inherit",
+        env: { ...process.env, [WRAPPER_ACTIVE_ENV]: "1" }
+      });
+    } catch {
+      resolve(127);
+      return;
+    }
+    const forward = (signal) => {
+      try {
+        child.kill(signal);
+      } catch {
+      }
+    };
+    for (const signal of FORWARDED_SIGNALS) process.on(signal, forward);
+    const cleanup = () => {
+      for (const signal of FORWARDED_SIGNALS) process.off(signal, forward);
+    };
+    child.on("error", () => {
+      cleanup();
+      resolve(127);
+    });
+    child.on("exit", (code, signal) => {
+      cleanup();
+      if (typeof code === "number") resolve(code);
+      else if (signal) resolve(128 + (SIGNAL_NUMBERS[signal] ?? 0));
+      else resolve(0);
+    });
+  });
+};
+
+// src/wrapper/commandPoller.ts
+var FAST_POLL_MS = 2e3;
+var SLOW_POLL_MS = 3e4;
+var isEnabled = () => {
+  const flag = process.env.PUSHARY_WRAPPER_POLL;
+  return flag === "1" || flag === "true";
+};
+var startCommandPoller = (opts) => {
+  let stopped = false;
+  let timer;
+  if (!isEnabled()) return { stop() {
+  } };
+  try {
+    getApiKey();
+  } catch {
+    return { stop() {
+    } };
+  }
+  const schedule = (delayMs) => {
+    if (stopped) return;
+    timer = setTimeout(tick, delayMs);
+  };
+  const tick = async () => {
+    if (stopped) return;
+    let next = SLOW_POLL_MS;
+    try {
+      const command = await drainPendingCommand(opts.sessionId);
+      if (command) {
+        next = FAST_POLL_MS;
+        opts.onCommand(command);
+      }
+    } catch {
+    }
+    schedule(next);
+  };
+  opts.log?.("[pushary] wrapper command poller enabled (experimental)");
+  schedule(SLOW_POLL_MS);
+  return {
+    stop() {
+      stopped = true;
+      if (timer) clearTimeout(timer);
+    }
+  };
+};
+var drainPendingCommand = async (_sessionId) => {
+  return null;
+};
+
+// src/wrapper/remoteMode.ts
+var runRemoteMode = async (_binary, _args) => {
+  return { implemented: false };
+};
+
+// src/wrapper/runClaudeWrapper.ts
+var runClaudeWrapper = async (args2) => {
+  const binary = findClaudeBinary();
+  if (!binary) {
+    process.stderr.write(
+      "[pushary] Could not find the `claude` binary on your PATH. Install Claude Code, or set PUSHARY_CLAUDE_BIN to its full path.\n"
+    );
+    return 127;
+  }
+  const nested = process.env[WRAPPER_ACTIVE_ENV] === "1";
+  if (!nested && process.env.PUSHARY_WRAPPER_REMOTE === "1") {
+    try {
+      const remote = await runRemoteMode(binary, args2);
+      if (remote.implemented) return remote.exitCode ?? 0;
+    } catch {
+    }
+  }
+  const poller = nested ? { stop() {
+  } } : startCommandPoller({
+    onCommand: () => {
+    },
+    log: (m) => process.stderr.write(`${m}
+`)
+  });
+  try {
+    return await runLocalPassthrough(binary, args2);
+  } finally {
+    poller.stop();
+  }
+};
+
+// src/wrapper/args.ts
+var resolveClaudeArgs = (argv) => {
+  const rest = argv.slice(2);
+  return rest[0] === "claude" ? rest.slice(1) : rest;
+};
+
+// bin/pushary-claude.ts
+var args = resolveClaudeArgs(process.argv);
+runClaudeWrapper(args).then((code) => process.exit(code)).catch((err) => {
+  process.stderr.write(
+    `[pushary] wrapper error: ${err instanceof Error ? err.message : String(err)}
+`
+  );
+  process.exit(1);
+});

package/dist/bin/pushary-clean.js

@@ -2,7 +2,7 @@
 import {
   removeClaudeMcpServers,
   removePusharySettings
-} from "../chunk-M6YUEVRV.js";
+} from "../chunk-AV2F2ZTZ.js";
 import {
   removeCodexHooks,
   removeGeminiSettings,

package/dist/bin/pushary-codex-hook.js

@@ -3,10 +3,6 @@ import {
   denyReasonFrom,
   isDeferAnswer
 } from "../chunk-KQYIHZ5E.js";
-import {
-  isGatingMoment,
-  recordKeylessMoment
-} from "../chunk-R5AJNXZS.js";
 import {
   CODEX_AGENT,
   DEFAULT_SESSION,
@@ -36,7 +32,11 @@ import {
   toCodexWire,
   toPolicyLookup,
   waitForAnswer
-} from "../chunk-USRIQPWI.js";
+} from "../chunk-OCPDWNG2.js";
+import {
+  isGatingMoment,
+  recordKeylessMoment
+} from "../chunk-R5AJNXZS.js";
 import "../chunk-DWED7BS3.js";
 import {
   DECISION_LINE_MAX,

package/dist/bin/pushary-codex.js

@@ -4,7 +4,7 @@ import {
   getMachineId,
   reportEvent,
   waitForAnswer
-} from "../chunk-USRIQPWI.js";
+} from "../chunk-OCPDWNG2.js";
 import "../chunk-DWED7BS3.js";
 import "../chunk-Z5PL3K7C.js";
 import {

package/dist/bin/pushary-gemini-hook.js

@@ -3,10 +3,6 @@ import {
   denyReasonFrom,
   isDeferAnswer
 } from "../chunk-KQYIHZ5E.js";
-import {
-  isGatingMoment,
-  recordKeylessMoment
-} from "../chunk-R5AJNXZS.js";
 import {
   DEFAULT_SESSION,
   askUser,
@@ -28,7 +24,11 @@ import {
   savePendingQuestion,
   sendNotification,
   waitForAnswer
-} from "../chunk-USRIQPWI.js";
+} from "../chunk-OCPDWNG2.js";
+import {
+  isGatingMoment,
+  recordKeylessMoment
+} from "../chunk-R5AJNXZS.js";
 import "../chunk-DWED7BS3.js";
 import {
   DECISION_LINE_MAX,

package/dist/bin/pushary-hook.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   handlePreToolUse
-} from "../chunk-FD4NV6BO.js";
+} from "../chunk-UU3ETDK4.js";
 import "../chunk-KQYIHZ5E.js";
+import "../chunk-OCPDWNG2.js";
 import "../chunk-R5AJNXZS.js";
-import "../chunk-USRIQPWI.js";
 import "../chunk-DWED7BS3.js";
 import "../chunk-Z5PL3K7C.js";
 import "../chunk-NKXSILEW.js";

package/dist/bin/pushary-notification-hook.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   handleNotification
-} from "../chunk-USRIQPWI.js";
+} from "../chunk-OCPDWNG2.js";
 import "../chunk-DWED7BS3.js";
 import "../chunk-Z5PL3K7C.js";
 import "../chunk-NKXSILEW.js";

package/dist/bin/pushary-post-hook.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   handlePostToolUse
-} from "../chunk-USRIQPWI.js";
+} from "../chunk-OCPDWNG2.js";
 import "../chunk-DWED7BS3.js";
 import "../chunk-Z5PL3K7C.js";
 import "../chunk-NKXSILEW.js";

package/dist/bin/pushary-prompt-hook.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   handleUserPrompt
-} from "../chunk-USRIQPWI.js";
+} from "../chunk-OCPDWNG2.js";
 import "../chunk-DWED7BS3.js";
 import "../chunk-Z5PL3K7C.js";
 import "../chunk-NKXSILEW.js";

package/dist/bin/pushary-session-start-hook.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin/pushary-session-start-hook.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import {
+  handleSessionStart
+} from "../chunk-OCPDWNG2.js";
+import "../chunk-DWED7BS3.js";
+import "../chunk-Z5PL3K7C.js";
+import "../chunk-NKXSILEW.js";
+
+// bin/pushary-session-start-hook.ts
+var main = async () => {
+  let rawInput = "";
+  for await (const chunk of process.stdin) {
+    rawInput += chunk;
+  }
+  try {
+    const input = rawInput.trim() ? JSON.parse(rawInput) : {};
+    await handleSessionStart(input);
+  } catch {
+  }
+};
+main();

package/dist/bin/pushary-setup.js

@@ -3,7 +3,7 @@ import {
   addClaudeMcpServer,
   addPusharyHooks,
   addPusharyToolPermissions
-} from "../chunk-M6YUEVRV.js";
+} from "../chunk-AV2F2ZTZ.js";
 import {
   GEMINI_HOOK_BINARY,
   addCodexHookTrust,
@@ -24,7 +24,7 @@ import {
 } from "../chunk-J7JWI3KU.js";
 import {
   reportEvent
-} from "../chunk-USRIQPWI.js";
+} from "../chunk-OCPDWNG2.js";
 import "../chunk-DWED7BS3.js";
 import {
   isValidApiKey

package/dist/bin/pushary-stop-hook.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   handleStop
-} from "../chunk-USRIQPWI.js";
+} from "../chunk-OCPDWNG2.js";
 import "../chunk-DWED7BS3.js";
 import "../chunk-Z5PL3K7C.js";
 import "../chunk-NKXSILEW.js";

package/dist/bin/pushary.js

@@ -18,12 +18,15 @@ if (command === "setup") {
   await import("./pushary-stats.js");
 } else if (command === "upgrade") {
   await import("./pushary-upgrade.js");
+} else if (command === "claude") {
+  await import("./pushary-claude.js");
 } else {
   console.log(`
 Pushary Agent Hooks
 
 Commands:
   setup    Configure Claude Code, Codex, Gemini CLI, Hermes, or Cursor with Pushary
+  claude   Run Claude Code through Pushary (experimental wrapper; today a transparent passthrough)
   doctor   Verify your Pushary installation is working
   clean    Remove all Pushary configuration (--yes for non-interactive)
   mode     Switch approval mode (push_only, push_first, terminal_only)

package/dist/{chunk-M6YUEVRV.js → chunk-AV2F2ZTZ.js}

@@ -20,7 +20,7 @@ var isPusharyHook = (entry) => {
   if (!Array.isArray(hooks)) return false;
   return hooks.some((hook) => {
     const command = String(asRecord(hook)?.command ?? "");
-    return command.includes("pushary-hook") || command.includes("pushary-post-hook") || command.includes("pushary-stop-hook") || command.includes("pushary-prompt-hook") || command.includes("pushary-notification-hook");
+    return command.includes("pushary-hook") || command.includes("pushary-post-hook") || command.includes("pushary-stop-hook") || command.includes("pushary-prompt-hook") || command.includes("pushary-notification-hook") || command.includes("pushary-session-start-hook");
   });
 };
 var addClaudeMcpServer = (config, apiKey) => {
@@ -77,7 +77,7 @@ var addPusharyHooks = (settings, binDir) => {
   hooks.PreToolUse = preToolUse;
   const postToolUse = (Array.isArray(hooks.PostToolUse) ? hooks.PostToolUse : []).filter((entry) => !isPusharyHook(entry));
   postToolUse.push({
-    matcher: "Bash|Write|Edit|NotebookEdit",
+    matcher: "Bash|Write|Edit|NotebookEdit|TodoWrite",
     hooks: [{
       type: "command",
       command: resolve("pushary-post-hook"),
@@ -113,6 +113,16 @@ var addPusharyHooks = (settings, binDir) => {
     }]
   });
   hooks.Notification = notification;
+  const sessionStart = (Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []).filter((entry) => !isPusharyHook(entry));
+  sessionStart.push({
+    matcher: "startup|resume|clear",
+    hooks: [{
+      type: "command",
+      command: resolve("pushary-session-start-hook"),
+      timeout: 10
+    }]
+  });
+  hooks.SessionStart = sessionStart;
 };
 var removePusharySettings = (settings) => {
   let changed = removeClaudeMcpServers(settings);
@@ -131,7 +141,7 @@ var removePusharySettings = (settings) => {
   }
   const hooks = asRecord(settings.hooks);
   if (hooks) {
-    for (const key of ["PreToolUse", "PostToolUse", "Stop", "UserPromptSubmit", "Notification"]) {
+    for (const key of ["PreToolUse", "PostToolUse", "Stop", "UserPromptSubmit", "Notification", "SessionStart"]) {
       const entries = hooks[key];
       if (!Array.isArray(entries)) continue;
       const filtered = entries.filter((entry) => !isPusharyHook(entry));

package/dist/{chunk-USRIQPWI.js → chunk-OCPDWNG2.js}

@@ -194,11 +194,24 @@ var hookPrefixes = {
   Edit: (input) => `edit file: ${input.file_path ?? "(unknown path)"}`,
   Read: (input) => `read file: ${input.file_path ?? "(unknown path)"}`
 };
+var describeTodoProgress = (todos) => {
+  if (!Array.isArray(todos)) return "updated the plan";
+  const items = todos.filter((t) => !!t && typeof t === "object");
+  const total = items.length;
+  if (total === 0) return "updated the plan";
+  const done = items.filter((t) => t.status === "completed").length;
+  const current = items.find((t) => t.status === "in_progress");
+  const label = current ? [current.activeForm, current.content].find((v) => typeof v === "string" && v.trim().length > 0) : void 0;
+  if (done >= total) return `finished all ${total} tasks`;
+  if (label) return `${label.trim()} (${done}/${total} done)`;
+  return `${done}/${total} tasks done`;
+};
 var eventPrefixes = {
   Bash: (input) => `ran: ${String(input.command ?? "")}`,
   Write: (input) => `wrote: ${input.file_path ?? "unknown"}`,
   Edit: (input) => `edited: ${input.file_path ?? "unknown"}`,
-  Read: (input) => `read: ${input.file_path ?? "unknown"}`
+  Read: (input) => `read: ${input.file_path ?? "unknown"}`,
+  TodoWrite: (input) => describeTodoProgress(input.todos)
 };
 var EVENT_ACTION_MAX = 120;
 var HOOK_FALLBACK_MAX = 200;
@@ -876,6 +889,13 @@ var handleUserPrompt = async (input, agent = CLAUDE_CODE_AGENT) => {
     return void 0;
   }
 };
+var STOP_SUMMARY_MAX_LENGTH = 200;
+var summarizeFinalMessage = (message) => {
+  if (typeof message !== "string") return "Session ended";
+  const collapsed = message.replace(/\s+/g, " ").trim();
+  if (!collapsed) return "Session ended";
+  return collapsed.slice(0, STOP_SUMMARY_MAX_LENGTH);
+};
 var handleStop = async (input, agent = CLAUDE_CODE_AGENT) => {
   try {
     const projectName = basename(input.cwd ?? process.cwd());
@@ -889,7 +909,7 @@ var handleStop = async (input, agent = CLAUDE_CODE_AGENT) => {
         event: "session_end",
         agentType: agent.type,
         agentName: `${agent.label} - ${projectName}`,
-        action: "Session ended",
+        action: summarizeFinalMessage(input.last_assistant_message),
         sessionId: input.session_id,
         usage: deriveUsage(input.transcript_path, input.session_id)
       }, { maxAttempts: 1 })
@@ -912,6 +932,20 @@ var handleStop = async (input, agent = CLAUDE_CODE_AGENT) => {
     return void 0;
   }
 };
+var handleSessionStart = async (input, agent = CLAUDE_CODE_AGENT) => {
+  try {
+    const projectName = basename(input.cwd ?? process.cwd());
+    const action = input.source === "resume" ? "Session resumed" : "Session started";
+    await reportEvent({
+      event: "session_start",
+      agentType: agent.type,
+      agentName: `${agent.label} - ${projectName}`,
+      action,
+      sessionId: input.session_id
+    }, { maxAttempts: 1, timeoutMs: 800 });
+  } catch {
+  }
+};
 var NOTIFICATION_PUSH_TYPES = /* @__PURE__ */ new Set(["idle_prompt", "agent_needs_input"]);
 var NOTIFICATION_THROTTLE_MS = 60 * 1e3;
 var handleNotification = async (input, agent = CLAUDE_CODE_AGENT) => {
@@ -983,5 +1017,6 @@ export {
   handlePostToolUse,
   handleUserPrompt,
   handleStop,
+  handleSessionStart,
   handleNotification
 };

package/dist/{chunk-FD4NV6BO.js → chunk-UU3ETDK4.js}

@@ -2,10 +2,6 @@ import {
   denyReasonFrom,
   isDeferAnswer
 } from "./chunk-KQYIHZ5E.js";
-import {
-  isGatingMoment,
-  recordKeylessMoment
-} from "./chunk-R5AJNXZS.js";
 import {
   DEFAULT_SESSION,
   askUser,
@@ -24,7 +20,11 @@ import {
   savePendingQuestion,
   sendNotification,
   waitForAnswer
-} from "./chunk-USRIQPWI.js";
+} from "./chunk-OCPDWNG2.js";
+import {
+  isGatingMoment,
+  recordKeylessMoment
+} from "./chunk-R5AJNXZS.js";
 import {
   effectiveWaitSeconds,
   hookWaitClamped,

package/dist/src/index.d.ts

@@ -91,6 +91,7 @@ declare const handleStop: (input: {
     session_id?: string;
     stop_hook_active?: boolean;
     transcript_path?: string;
+    last_assistant_message?: string;
 }, agent?: AgentIdentity) => Promise<StopHookOutput | undefined>;
 declare const handleNotification: (input: {
     message?: string;

package/dist/src/index.js

@@ -1,8 +1,7 @@
 import {
   handlePreToolUse
-} from "../chunk-FD4NV6BO.js";
+} from "../chunk-UU3ETDK4.js";
 import "../chunk-KQYIHZ5E.js";
-import "../chunk-R5AJNXZS.js";
 import {
   askUser,
   cancelQuestion,
@@ -15,7 +14,8 @@ import {
   reportEvent,
   resolvePolicy,
   waitForAnswer
-} from "../chunk-USRIQPWI.js";
+} from "../chunk-OCPDWNG2.js";
+import "../chunk-R5AJNXZS.js";
 import "../chunk-DWED7BS3.js";
 import "../chunk-Z5PL3K7C.js";
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushary/agent-hooks",
-  "version": "0.32.1",
+  "version": "0.33.0",
   "description": "Permission hooks for AI coding agents: route tool approvals through Pushary push notifications",
   "keywords": [
     "pushary",
@@ -48,6 +48,8 @@
     "pushary-stop-hook": "./dist/bin/pushary-stop-hook.js",
     "pushary-prompt-hook": "./dist/bin/pushary-prompt-hook.js",
     "pushary-notification-hook": "./dist/bin/pushary-notification-hook.js",
+    "pushary-session-start-hook": "./dist/bin/pushary-session-start-hook.js",
+    "pushary-claude": "./dist/bin/pushary-claude.js",
     "pushary-codex": "./dist/bin/pushary-codex.js",
     "pushary-codex-hook": "./dist/bin/pushary-codex-hook.js",
     "pushary-gemini-hook": "./dist/bin/pushary-gemini-hook.js",
@@ -66,7 +68,7 @@
   "scripts": {
     "build": "node scripts/bundle-plugin.mjs && tsup",
     "dev": "tsup --watch",
-    "test": "bun test src/api.test.ts && bun test src/claude-config.test.ts && bun test src/config.test.ts && bun test src/mcp-http.test.ts && bun test src/retry.test.ts && bun test src/usage.test.ts && bun test src/validate.test.ts && bun test src/policy.test.ts && bun test src/npm.test.ts && bun test src/identity.test.ts && bun test src/pending.test.ts && bun test src/events.test.ts && bun test src/describe.test.ts && bun test src/suggestions.test.ts && bun test src/safe-commands.test.ts && bun test src/hook.test.ts && bun test src/codex-adapter.test.ts && bun test src/codex-config.test.ts && bun test src/gemini-adapter.test.ts && bun test src/gemini-config.test.ts && bun test src/instruction-file.test.ts && bun test src/pairing.test.ts && bun test src/wait-ladder.test.ts && bun test src/ledger.test.ts"
+    "test": "bun test src/api.test.ts && bun test src/claude-config.test.ts && bun test src/config.test.ts && bun test src/mcp-http.test.ts && bun test src/retry.test.ts && bun test src/usage.test.ts && bun test src/validate.test.ts && bun test src/policy.test.ts && bun test src/npm.test.ts && bun test src/identity.test.ts && bun test src/pending.test.ts && bun test src/events.test.ts && bun test src/describe.test.ts && bun test src/suggestions.test.ts && bun test src/safe-commands.test.ts && bun test src/hook.test.ts && bun test src/codex-adapter.test.ts && bun test src/codex-config.test.ts && bun test src/gemini-adapter.test.ts && bun test src/gemini-config.test.ts && bun test src/instruction-file.test.ts && bun test src/pairing.test.ts && bun test src/wait-ladder.test.ts && bun test src/ledger.test.ts && bun test src/wrapper/wrapper.test.ts"
   },
   "dependencies": {
     "@inquirer/prompts": "^8.4.2",