@pushary/agent-hooks 0.89.2 → 0.89.4

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.89.3
+
+### Doctor recognizes hooks installed by the macOS app
+
+Claude Code, Codex and Gemini hooks that point at the shared native
+`pushary-bridge` now pass the same presence, executable and timeout checks as
+their npm hook binaries. Doctor no longer tells a Mac-managed install to repair
+hooks that are already installed and running.
+
 ## 0.89.2
 
 ### Multi-question prompts keep their real answer shape

package/README.md

@@ -113,6 +113,46 @@ npx @pushary/agent-hooks@latest doctor
 
 Any other MCP client can use notify and ask by pointing at the Pushary MCP endpoint directly.
 
+## Control an agent from your phone
+
+The Pushary app can start an agent on a connected computer and send instructions
+to a running session. It is deliberately not a remote shell: the phone submits a
+task to the selected agent, and the agent still runs with its normal permissions,
+hooks, and approval policy on your computer.
+
+| Control | Claude Code | Codex | Gemini CLI | Other agents |
+|---------|:-----------:|:-----:|:----------:|:------------:|
+| Start a new session | yes | yes | yes | no |
+| Send an instruction to a live session | yes | yes | yes | wrapper-dependent |
+| Approve, deny, and answer | yes | yes | yes | yes via MCP |
+
+Requirements and limits:
+
+- Run setup once. It installs a per-user background service using LaunchAgent on
+  macOS, systemd on Linux, or Task Scheduler on Windows.
+- The computer must be awake, logged in, online, and have the selected agent CLI
+  installed. Pushary advertises only providers it finds on that machine.
+- Start and Send require Face ID, Touch ID, or the device passcode. Controls are
+  hidden when the machine or session has no recent live consumer.
+- An instruction may remain queued on Pushary's server for up to one hour while
+  delivery retries. It is delivered to the agent session, never executed as a
+  raw terminal command.
+- Agent control requires a paid plan after the trial. Current terms are on the
+  [pricing page](https://pushary.com/pricing).
+
+Service lifecycle is explicit and cross-platform:
+
+```bash
+pushary daemon status
+pushary daemon install
+pushary daemon stop
+pushary daemon restart
+pushary daemon uninstall
+```
+
+`pushary setup` installs and verifies the service. `pushary upgrade` refreshes it,
+and `pushary clean` stops and removes it.
+
 ## Hook events, gated by version
 
 Claude Code 2.1.239 names thirty-one hook events and the set grows release by release,

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

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   handleBell
-} from "../chunk-B7JE4XHD.js";
+} from "../chunk-7IJYOBHL.js";
 import {
   readHookInput
 } from "../chunk-6CUUA7HO.js";
-import "../chunk-LALHWDWL.js";
+import "../chunk-W6NPWHBJ.js";
 import "../chunk-BC3VCZ3E.js";
-import "../chunk-6MTNS63X.js";
 import "../chunk-OFRNZWC4.js";
+import "../chunk-6MTNS63X.js";
 import "../chunk-2UMNXADU.js";
 import "../chunk-L4C2JXJS.js";
 

package/dist/bin/pushary-bell.js

@@ -5,37 +5,36 @@ import {
   liveAgentCount,
   ring,
   upgradeThreshold
-} from "../chunk-B7JE4XHD.js";
+} from "../chunk-7IJYOBHL.js";
 import {
   guardBinary
 } from "../chunk-AIGDBRIJ.js";
 import "../chunk-PZA7G4CN.js";
 import {
   claudeSettings
-} from "../chunk-VKVHY5HD.js";
-import "../chunk-GIRT7677.js";
+} from "../chunk-V37ZXMH3.js";
 import {
   createIo
 } from "../chunk-5RUIFDTP.js";
-import "../chunk-LALHWDWL.js";
+import "../chunk-W6NPWHBJ.js";
 import {
   parseFlags
 } from "../chunk-GMXKITVA.js";
 import {
   exitOnHelpFlag
-} from "../chunk-SQOFGPNX.js";
-import "../chunk-GOEXZ5QJ.js";
+} from "../chunk-KJ57OPCC.js";
+import "../chunk-GPNOHKFO.js";
 import "../chunk-BC3VCZ3E.js";
 import "../chunk-DINDL2CF.js";
-import {
-  readJsonSafe,
-  writeJsonAtomic
-} from "../chunk-6MTNS63X.js";
 import "../chunk-OFRNZWC4.js";
 import "../chunk-7QLSKOSU.js";
 import {
   EXIT
 } from "../chunk-KZERVKTD.js";
+import {
+  readJsonSafe,
+  writeJsonAtomic
+} from "../chunk-6MTNS63X.js";
 import "../chunk-2UMNXADU.js";
 import "../chunk-L4C2JXJS.js";
 

package/dist/bin/pushary-claude.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ensureDaemonRunning
-} from "../chunk-K42SZKYF.js";
+} from "../chunk-NLMSSKES.js";
 import {
   buildTranscriptRecords,
   decodePublicKey,
@@ -13,43 +13,48 @@ import {
 import {
   startProcessOwnership,
   withSpawnProcessOwnership
-} from "../chunk-ZYPS2XMT.js";
+} from "../chunk-4ZHQNBDP.js";
 import {
   needsShell,
   spawnClaude
 } from "../chunk-XHKBHWLX.js";
 import "../chunk-PZA7G4CN.js";
-import "../chunk-VKVHY5HD.js";
 import {
   isDeferAnswer
 } from "../chunk-YHG74UFF.js";
-import "../chunk-GIRT7677.js";
 import {
   fetchModeState,
   getPolicy,
   repoKeyFor,
   reportEvent
-} from "../chunk-6XSC6Z2K.js";
+} from "../chunk-NFI2K2ZQ.js";
 import {
+  DEFAULT_SESSION,
   askUser,
   cancelQuestion,
+  markPendingCommandDelivered,
+  markPendingCommandFailed,
+  readPendingCommand,
+  removePendingCommand,
+  savePendingCommand,
   waitForAnswer
-} from "../chunk-J3YDT4HM.js";
+} from "../chunk-GKAKAOKC.js";
 import {
   deriveToolTarget,
   describeToolCall,
   scopePathFor
-} from "../chunk-LGXTBUT4.js";
+} from "../chunk-KOPUTJQC.js";
 import {
   getMachineId
-} from "../chunk-RN3NOEJF.js";
+} from "../chunk-2HYPZLYY.js";
+import "../chunk-V37ZXMH3.js";
 import "../chunk-DINDL2CF.js";
-import "../chunk-6MTNS63X.js";
 import "../chunk-BSZYIAZL.js";
 import "../chunk-SAF6HGAA.js";
 import "../chunk-OFRNZWC4.js";
 import "../chunk-7QLSKOSU.js";
 import "../chunk-KZERVKTD.js";
+import "../chunk-6MTNS63X.js";
 import {
   getApiKey,
   getBaseUrl
@@ -294,14 +299,14 @@ var BoundedInputQueue = class {
     this.coalesce = options.coalesce;
   }
   push(item) {
-    if (this.closed) return;
+    if (this.closed) return false;
     this.pushedCount++;
     if (this.waiter) {
       const resolve2 = this.waiter;
       this.waiter = void 0;
       this.deliveredCount++;
       resolve2({ value: item, done: false });
-      return;
+      return true;
     }
     this.buffer.push(item);
     while (this.buffer.length > this.cap) {
@@ -309,6 +314,7 @@ var BoundedInputQueue = class {
       this.droppedCount++;
       this.onDrop?.(dropped, this.droppedCount);
     }
+    return true;
   }
   // Mark done. Any parked consumer completes; further push() is ignored. The
   // buffer is cleared so nothing is retained after shutdown.
@@ -615,10 +621,20 @@ var startCommandPoller = (opts) => {
       errorStreak = 0;
       if (command) {
         idleTicks = 0;
+        const text = typeof command === "string" ? command : command.text;
+        let accepted = false;
         try {
-          opts.onCommand(command);
+          accepted = opts.onCommand(text) !== false;
         } catch {
         }
+        if (typeof command !== "string") {
+          const state = accepted ? "delivered" : "failed";
+          if (command.acknowledge) {
+            await command.acknowledge(state).catch(() => false);
+          } else if (opts.ackCommand) {
+            await opts.ackCommand(opts.apiKey, command.id, state).catch(() => false);
+          }
+        }
       } else {
         idleTicks++;
       }
@@ -644,20 +660,71 @@ var startCommandPoller = (opts) => {
 
 // src/wrapper/pollClient.ts
 var APPROVAL_MODES = /* @__PURE__ */ new Set(["push_only", "terminal_only", "push_first", "notify_only"]);
-var pollAgent = async (apiKey, sessionId, wantCommand, signal, baseUrl = getBaseUrl()) => {
+var pollAgent = async (apiKey, sessionId, wantCommand, signal, baseUrl = getBaseUrl(), machineId) => {
   try {
+    const sessionKey = sessionId || DEFAULT_SESSION;
+    const receiptNamespace = `${apiKey}:${machineId}:claude_code`;
+    const storedCommand = wantCommand && machineId ? readPendingCommand(sessionKey, receiptNamespace) : null;
     const response = await fetch(`${baseUrl}/api/agent/poll`, {
       method: "POST",
       headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
       body: JSON.stringify({
         ...sessionId ? { sessionId } : {},
-        ...wantCommand ? {} : { drain: false }
+        ...machineId ? { machineId } : {},
+        ...wantCommand && !storedCommand ? {} : { drain: false },
+        ...wantCommand && !storedCommand && machineId ? { ackMode: true } : {}
       }),
       signal
     });
     if (!response.ok) return { command: null, mode: null };
     const data = await response.json();
-    const command = typeof data.command === "string" && data.command.length > 0 ? data.command : null;
+    const acknowledge = async (id, state) => {
+      const persisted = state === "delivered" ? markPendingCommandDelivered(sessionKey, id, receiptNamespace) : markPendingCommandFailed(sessionKey, id, receiptNamespace);
+      if (!persisted) return false;
+      try {
+        const acknowledged = await fetch(`${baseUrl}/api/agent/command/ack`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
+          body: JSON.stringify({
+            commandId: id,
+            sessionId: sessionId ?? null,
+            machineId,
+            state,
+            ...state === "failed" ? { failureCode: "consumer_rejected" } : {}
+          }),
+          signal
+        });
+        if (acknowledged.ok) removePendingCommand(sessionKey, id, receiptNamespace);
+        return acknowledged.ok;
+      } catch {
+        return false;
+      }
+    };
+    const claimedCommand = (id, text) => ({
+      id,
+      text,
+      acknowledge: (state) => acknowledge(id, state)
+    });
+    let command = typeof data.command === "string" && data.command.length > 0 ? data.command : null;
+    if (storedCommand) {
+      if (storedCommand.delivered || storedCommand.failed) {
+        await acknowledge(storedCommand.id, storedCommand.failed ? "failed" : "delivered");
+        command = null;
+      } else {
+        command = claimedCommand(storedCommand.id, storedCommand.text);
+      }
+    } else if (data.command && typeof data.command === "object") {
+      const claimed = data.command;
+      if (typeof claimed.id === "string" && typeof claimed.text === "string") {
+        const saved = savePendingCommand(sessionKey, {
+          id: claimed.id,
+          text: claimed.text,
+          expiresAtMs: typeof claimed.expiresAtMs === "number" ? claimed.expiresAtMs : Date.now() + 36e5,
+          delivered: false
+        }, receiptNamespace);
+        command = saved ? claimedCommand(claimed.id, claimed.text) : null;
+      }
+    }
     const m = data.override?.mode;
     const mode = {
       mode: typeof m === "string" && APPROVAL_MODES.has(m) ? m : null,
@@ -799,12 +866,26 @@ var createRelayClient = (options) => {
         log("[pushary] relay connected");
         break;
       case "command":
-        sendFrame({ v: PROTOCOL_VERSION, t: "ack", id: frame.id });
-        if (rememberCommand(frame.id)) {
-          try {
-            options.onCommand(frame.text);
-          } catch {
-          }
+        if (seenSet.has(frame.id)) {
+          sendFrame({ v: PROTOCOL_VERSION, t: "ack", id: frame.id, state: "delivered" });
+          break;
+        }
+        let accepted = false;
+        try {
+          accepted = options.onCommand(frame.text) !== false;
+        } catch {
+        }
+        if (accepted) {
+          rememberCommand(frame.id);
+          sendFrame({ v: PROTOCOL_VERSION, t: "ack", id: frame.id, state: "delivered" });
+        } else {
+          sendFrame({
+            v: PROTOCOL_VERSION,
+            t: "ack",
+            id: frame.id,
+            state: "failed",
+            failureCode: "consumer_rejected"
+          });
         }
         break;
       case "ping":
@@ -1356,10 +1437,11 @@ var runDualMode = async (binary, args2, startingMode) => {
         noticedUnavailable = true;
         process.stderr.write("[pushary] phone control is unavailable this run; the instruction was not delivered.\n");
       }
-      return;
+      return false;
     }
-    input.push(userMessage(command));
+    if (!input.push(userMessage(command))) return false;
     activeLeg?.onPhoneCommand();
+    return true;
   };
   const streamMessage = (message) => {
     if (message.type === "assistant") {
@@ -1378,7 +1460,7 @@ var runDualMode = async (binary, args2, startingMode) => {
     shouldDrainCommands: () => !(relay?.connected() ?? false),
     // Unified poll: one request per tick for both command + mode/kill (half the
     // requests and the per-poll DB write of the old drain + mode pair).
-    poll: pollAgent,
+    poll: (key, id, wantCommand, signal) => pollAgent(key, id, wantCommand, signal, void 0, machineId),
     fetchModeState,
     // Relay-primary: idle the safety-net poll at 60s (see RELAY_FALLBACK_POLL_MS).
     // No relay advertised -> the poller IS the command path, so keep the default.

package/dist/bin/pushary-clean.js

@@ -4,7 +4,7 @@ import {
   shortenHome,
   unregisterPluginLocation,
   vscodeSettingsTargets
-} from "../chunk-LUCFN47K.js";
+} from "../chunk-QH4AA7QV.js";
 import "../chunk-O5B7EK5U.js";
 import {
   removeClaudeMcpServers,
@@ -13,9 +13,16 @@ import {
 } from "../chunk-7TS2G4QG.js";
 import "../chunk-ATBKJNWS.js";
 import "../chunk-AIGDBRIJ.js";
+import {
+  manageDaemonService,
+  stopDaemonRunning
+} from "../chunk-NLMSSKES.js";
+import "../chunk-XHKBHWLX.js";
 import {
   execNpm
 } from "../chunk-PZA7G4CN.js";
+import "../chunk-KOPUTJQC.js";
+import "../chunk-2HYPZLYY.js";
 import {
   claudeJson,
   claudeSettings,
@@ -35,16 +42,14 @@ import {
   removeCodexHookTrust,
   removeCodexHooks,
   vscodePluginDir
-} from "../chunk-VKVHY5HD.js";
-import "../chunk-GIRT7677.js";
-import "../chunk-LGXTBUT4.js";
+} from "../chunk-V37ZXMH3.js";
 import {
   rejectUnknownFlags
 } from "../chunk-GMXKITVA.js";
 import {
   exitOnHelpFlag
-} from "../chunk-SQOFGPNX.js";
-import "../chunk-GOEXZ5QJ.js";
+} from "../chunk-KJ57OPCC.js";
+import "../chunk-GPNOHKFO.js";
 import {
   removeClaudeAlias
 } from "../chunk-BC3VCZ3E.js";
@@ -53,6 +58,8 @@ import "../chunk-7QLSKOSU.js";
 import {
   EXIT
 } from "../chunk-KZERVKTD.js";
+import "../chunk-6MTNS63X.js";
+import "../chunk-2UMNXADU.js";
 import {
   CURSOR_GATE_EVENTS
 } from "../chunk-L4C2JXJS.js";
@@ -136,6 +143,15 @@ var guards = createGuards(() => dryRun, wouldNote);
 var guardedWrite = (path, contents) => guards.write(path, contents);
 var guardedRemove = (path, options) => guards.remove(path, options);
 var guardedExec = (command, options, describe) => guards.exec(command, options ?? {}, describe);
+var guardedDaemonRemoval = async () => {
+  if (dryRun) {
+    wouldNote("stop and uninstall", "Pushary background service");
+    return true;
+  }
+  const service = manageDaemonService("uninstall");
+  const detached = await stopDaemonRunning();
+  return service.kind === "ok" && detached.kind !== "unavailable";
+};
 var guardedInstructionBlockRemoval = (path) => {
   if (!dryRun) return removeInstructionBlock(path);
   if (!existsSync(path)) return false;
@@ -421,6 +437,12 @@ var main = async () => {
   } else {
     console.log(`  ${skip} claude alias ${dim("(not set)")}`);
   }
+  if (await guardedDaemonRemoval()) {
+    console.log(`  ${check} Background service ${dim(did("uninstalled"))}`);
+  } else {
+    incompleteClean = true;
+    console.log(`  ${cross} Background service ${dim("(could not stop or uninstall)")}`);
+  }
   if (existsSync(PUSHARY_DIR)) {
     guardedRemove(PUSHARY_DIR);
     console.log(`  ${check} Local state ${dim("(~/.pushary removed: stored API key, ledger)")}`);
@@ -464,7 +486,6 @@ var main = async () => {
     console.log(`  ${dim("It still has the")} ${bold("claude")} ${dim("alias loaded from before. Run")} ${bold("unalias claude")}`);
     console.log(`  ${dim("(or open a new terminal) so")} ${bold("claude")} ${dim("runs Claude Code again.")}`);
   }
-  console.log(`  ${dim("If a")} ${bold("pushary claude")} ${dim("or")} ${bold("pushary daemon")} ${dim("is still running anywhere, stop it (Ctrl-C).")}`);
   console.log();
   if (incompleteClean) process.exit(EXIT.FAILED);
 };

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import "../chunk-NRGRUOAR.js";
+import "../chunk-FWUEYXSD.js";
 import {
   LiveTranscriptRelay,
   liveSessionSleep,
@@ -11,18 +11,17 @@ import "../chunk-PMHTCDEO.js";
 import {
   startProcessOwnership,
   withSpawnProcessOwnership
-} from "../chunk-ZYPS2XMT.js";
+} from "../chunk-4ZHQNBDP.js";
 import {
   spawnClaude
 } from "../chunk-XHKBHWLX.js";
 import {
   resolveBinary
 } from "../chunk-PZA7G4CN.js";
-import "../chunk-VKVHY5HD.js";
-import "../chunk-GIRT7677.js";
 import {
   getMachineId
-} from "../chunk-RN3NOEJF.js";
+} from "../chunk-2HYPZLYY.js";
+import "../chunk-V37ZXMH3.js";
 import "../chunk-6MTNS63X.js";
 import {
   getApiKey,
@@ -276,7 +275,11 @@ var runCodexBridge = async (options) => {
           await liveSessionSleep(options.pollIntervalMs ?? 2e3, options.signal);
           continue;
         }
-        const response = await postLiveSession(options, "/api/agent/command/drain", { sessionId: threadId, ackMode: true });
+        const response = await postLiveSession(options, "/api/agent/command/drain", {
+          sessionId: threadId,
+          machineId: options.machineId,
+          ackMode: true
+        });
         if (response.ok) {
           const command = object((await response.json()).command);
           const commandId = string(command?.id);
@@ -284,10 +287,17 @@ var runCodexBridge = async (options) => {
           if (commandId && text) {
             try {
               await startTurn(text, commandId);
-              pendingAck = { commandId, state: "delivered" };
+              pendingAck = {
+                commandId,
+                sessionId: threadId,
+                machineId: options.machineId,
+                state: "delivered"
+              };
             } catch {
               pendingAck = {
                 commandId,
+                sessionId: threadId,
+                machineId: options.machineId,
                 state: "failed",
                 failureCode: "codex_rejected"
               };

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

@@ -10,9 +10,6 @@ import {
   denyReasonFrom,
   isDeferAnswer
 } from "../chunk-YHG74UFF.js";
-import {
-  canonicalJson
-} from "../chunk-GIRT7677.js";
 import {
   CODEX_AGENT,
   codexAllow,
@@ -34,7 +31,7 @@ import {
   toCodexWire,
   toPolicyLookup,
   toPolicyLookups
-} from "../chunk-6XSC6Z2K.js";
+} from "../chunk-NFI2K2ZQ.js";
 import {
   DEFAULT_SESSION,
   askUser,
@@ -42,22 +39,26 @@ import {
   pollForAnswer,
   savePendingQuestion,
   sendNotification
-} from "../chunk-J3YDT4HM.js";
+} from "../chunk-GKAKAOKC.js";
 import {
   deriveActionBody,
   deriveBlocker,
   deriveToolTarget,
   describeToolCall,
   scopePathFor
-} from "../chunk-LGXTBUT4.js";
+} from "../chunk-KOPUTJQC.js";
 import {
   getMachineId
-} from "../chunk-RN3NOEJF.js";
+} from "../chunk-2HYPZLYY.js";
+import {
+  canonicalJson
+} from "../chunk-V37ZXMH3.js";
 import "../chunk-BSZYIAZL.js";
 import "../chunk-SAF6HGAA.js";
 import "../chunk-OFRNZWC4.js";
 import "../chunk-7QLSKOSU.js";
 import "../chunk-KZERVKTD.js";
+import "../chunk-6MTNS63X.js";
 import {
   getApiKey
 } from "../chunk-2UMNXADU.js";

package/dist/bin/pushary-codex.js

@@ -1,20 +1,22 @@
 #!/usr/bin/env node
 import {
   reportEvent
-} from "../chunk-6XSC6Z2K.js";
+} from "../chunk-NFI2K2ZQ.js";
 import {
   askUser,
   waitForAnswer
-} from "../chunk-J3YDT4HM.js";
-import "../chunk-LGXTBUT4.js";
+} from "../chunk-GKAKAOKC.js";
+import "../chunk-KOPUTJQC.js";
 import {
   getMachineId
-} from "../chunk-RN3NOEJF.js";
+} from "../chunk-2HYPZLYY.js";
+import "../chunk-V37ZXMH3.js";
 import "../chunk-BSZYIAZL.js";
 import "../chunk-SAF6HGAA.js";
 import "../chunk-OFRNZWC4.js";
 import "../chunk-7QLSKOSU.js";
 import "../chunk-KZERVKTD.js";
+import "../chunk-6MTNS63X.js";
 import {
   getApiKey
 } from "../chunk-2UMNXADU.js";

package/dist/bin/pushary-connect.js

@@ -16,17 +16,16 @@ import {
 } from "../chunk-5RUIFDTP.js";
 import {
   readKeySource
-} from "../chunk-LALHWDWL.js";
+} from "../chunk-W6NPWHBJ.js";
 import {
   parseFlags
 } from "../chunk-GMXKITVA.js";
 import {
   exitOnHelpFlag
-} from "../chunk-SQOFGPNX.js";
-import "../chunk-GOEXZ5QJ.js";
+} from "../chunk-KJ57OPCC.js";
+import "../chunk-GPNOHKFO.js";
 import "../chunk-BC3VCZ3E.js";
 import "../chunk-DINDL2CF.js";
-import "../chunk-6MTNS63X.js";
 import "../chunk-BSZYIAZL.js";
 import "../chunk-SAF6HGAA.js";
 import "../chunk-OFRNZWC4.js";
@@ -36,6 +35,7 @@ import {
 import {
   EXIT
 } from "../chunk-KZERVKTD.js";
+import "../chunk-6MTNS63X.js";
 import "../chunk-2UMNXADU.js";
 import "../chunk-L4C2JXJS.js";