@pushary/agent-hooks 0.89.3 → 0.89.5

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-WQGMUIDW.js";
 import {
   readHookInput
 } from "../chunk-6CUUA7HO.js";
-import "../chunk-LALHWDWL.js";
+import "../chunk-L3YUHEB6.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-WQGMUIDW.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-L3YUHEB6.js";
 import {
   parseFlags
 } from "../chunk-GMXKITVA.js";
 import {
   exitOnHelpFlag
-} from "../chunk-SQOFGPNX.js";
-import "../chunk-GOEXZ5QJ.js";
+} from "../chunk-LURY4WNF.js";
+import "../chunk-3XTFX4CL.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-TRQ46MXR.js";
 import {
   buildTranscriptRecords,
   decodePublicKey,
@@ -13,48 +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-3UBYTSCY.js";
+} from "../chunk-NFI2K2ZQ.js";
 import {
   DEFAULT_SESSION,
   askUser,
   cancelQuestion,
   markPendingCommandDelivered,
+  markPendingCommandFailed,
   readPendingCommand,
   removePendingCommand,
   savePendingCommand,
   waitForAnswer
-} from "../chunk-HUJAAWNL.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
@@ -299,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) {
@@ -314,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.
@@ -620,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++;
       }
@@ -667,27 +678,40 @@ var pollAgent = async (apiKey, sessionId, wantCommand, signal, baseUrl = getBase
     });
     if (!response.ok) return { command: null, mode: null };
     const data = await response.json();
-    const acknowledge = async (id) => {
+    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: "delivered" }),
+          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) {
-      const acknowledged = await acknowledge(storedCommand.id);
-      if (acknowledged && storedCommand.delivered) removePendingCommand(sessionKey, storedCommand.id, receiptNamespace);
-      if (acknowledged && !storedCommand.delivered && markPendingCommandDelivered(sessionKey, storedCommand.id, receiptNamespace)) {
-        command = storedCommand.text;
-      } else {
+      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;
@@ -698,7 +722,7 @@ var pollAgent = async (apiKey, sessionId, wantCommand, signal, baseUrl = getBase
           expiresAtMs: typeof claimed.expiresAtMs === "number" ? claimed.expiresAtMs : Date.now() + 36e5,
           delivered: false
         }, receiptNamespace);
-        command = saved && await acknowledge(claimed.id) && markPendingCommandDelivered(sessionKey, claimed.id, receiptNamespace) ? claimed.text : null;
+        command = saved ? claimedCommand(claimed.id, claimed.text) : null;
       }
     }
     const m = data.override?.mode;
@@ -843,15 +867,26 @@ var createRelayClient = (options) => {
         break;
       case "command":
         if (seenSet.has(frame.id)) {
-          sendFrame({ v: PROTOCOL_VERSION, t: "ack", id: frame.id });
+          sendFrame({ v: PROTOCOL_VERSION, t: "ack", id: frame.id, state: "delivered" });
           break;
         }
+        let accepted = false;
         try {
-          options.onCommand(frame.text);
-          rememberCommand(frame.id);
-          sendFrame({ v: PROTOCOL_VERSION, t: "ack", id: frame.id });
+          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":
         sendFrame({ v: PROTOCOL_VERSION, t: "pong" });
@@ -1402,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") {

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,15 @@ import {
 } from "../chunk-7TS2G4QG.js";
 import "../chunk-ATBKJNWS.js";
 import "../chunk-AIGDBRIJ.js";
+import {
+  disableDaemonService
+} from "../chunk-TRQ46MXR.js";
+import "../chunk-XHKBHWLX.js";
 import {
   execNpm
 } from "../chunk-PZA7G4CN.js";
+import "../chunk-KOPUTJQC.js";
+import "../chunk-2HYPZLYY.js";
 import {
   claudeJson,
   claudeSettings,
@@ -35,16 +41,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-LURY4WNF.js";
+import "../chunk-3XTFX4CL.js";
 import {
   removeClaudeAlias
 } from "../chunk-BC3VCZ3E.js";
@@ -53,6 +57,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 +142,13 @@ 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;
+  }
+  return (await disableDaemonService()).kind === "ok";
+};
 var guardedInstructionBlockRemoval = (path) => {
   if (!dryRun) return removeInstructionBlock(path);
   if (!existsSync(path)) return false;
@@ -421,6 +434,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 +483,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-NKHEHEUM.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,

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-3UBYTSCY.js";
+} from "../chunk-NFI2K2ZQ.js";
 import {
   DEFAULT_SESSION,
   askUser,
@@ -42,22 +39,26 @@ import {
   pollForAnswer,
   savePendingQuestion,
   sendNotification
-} from "../chunk-HUJAAWNL.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-3UBYTSCY.js";
+} from "../chunk-NFI2K2ZQ.js";
 import {
   askUser,
   waitForAnswer
-} from "../chunk-HUJAAWNL.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-L3YUHEB6.js";
 import {
   parseFlags
 } from "../chunk-GMXKITVA.js";
 import {
   exitOnHelpFlag
-} from "../chunk-SQOFGPNX.js";
-import "../chunk-GOEXZ5QJ.js";
+} from "../chunk-LURY4WNF.js";
+import "../chunk-3XTFX4CL.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";