@cosmovex/agentpager 0.1.3 → 0.1.5

package/dist/cli.js

@@ -21,7 +21,7 @@ import { staleBuildWarning } from './freshness.js';
 import { runRuleCommand, USAGE as GUARD_USAGE } from './guard/cli.js';
 import { install as guardInstall, runDeskHook, runHook, status as guardStatus, uninstall as guardUninstall } from './guard/index.js';
 import { Channel } from './relay.js';
-import { installService, uninstallService } from './service.js';
+import { installService, serviceInstalled, uninstallService } from './service.js';
 import { loadState, updateState } from './store.js';
 import { isNewer, latestVersion, UPDATE_COMMAND } from './update.js';
 const dim = (s) => `\x1b[2m${s}\x1b[0m`;
@@ -41,6 +41,29 @@ function printPhones(devices, indent = '  ') {
         console.log(`${indent}${bold(d.name)}  ${dim(`id ${d.id} · paired ${new Date(d.pairedAt).toLocaleDateString()}`)}`);
     }
 }
+const HELP = `
+${bold('AgentPager')} — your phone, one tap from your coding agents.
+
+${bold('Everyday')}
+  agentpager            start it (keep the window open)
+  agentpager stop       stop it
+  agentpager status     is it running, who is paired, is there an update
+
+${bold('Phones')}
+  agentpager pair       add a phone (or the same one after a reinstall)
+  agentpager devices    who is paired
+  agentpager unpair     remove a phone
+
+${bold('Always on')}
+  agentpager service install     start by itself at login
+  agentpager service uninstall   turn that off
+
+${bold('For scripts')}
+  agentpager notify "text"       page your phone
+  agentpager ask "question"      wait for your yes or no
+
+More: agentpager doctor · agentpager guard
+`;
 const UNPAIR_HINT = 'Remove a phone: `agentpager unpair <id>` (or `agentpager unpair --all`). List them: `agentpager devices`.';
 async function pair(state) {
     // Re-read: this snapshot may be as old as the terminal. "Paired" with no way to see what, or to
@@ -172,6 +195,7 @@ async function serve(state, keepAwake) {
             }
         }
     }, 2000);
+    hub.onStop = () => void quit();
     hub.onUnpair = (ch) => {
         // The phone forgot us in the app: drop it from disk first, then close the channel.
         updateState((s) => {
@@ -199,12 +223,17 @@ async function serve(state, keepAwake) {
         console.log(`  ${s.available ? '●' : '○'} ${s.name}${s.version ? ` ${dim(s.version)}` : ''}${s.available ? '' : dim(`  ${s.reason}`)}`);
     console.log(`  ${state.devices.length} phone${state.devices.length === 1 ? '' : 's'} paired:`);
     printPhones(state.devices, '    ');
-    console.log(dim('\nKeep this running (or run `agentpager service install` to start it at login).'));
+    if (process.argv[1]?.includes('_npx')) {
+        // Started with npx: this window IS AgentPager. Say so before someone closes it.
+        console.log(`\n${bold('Keep this window open.')} Closing it (or Ctrl+C) disconnects your phone until you start it again.`);
+        console.log(dim('Always on, even after a restart: npm install -g @cosmovex/agentpager, then agentpager service install'));
+    }
+    else {
+        console.log(dim('\nKeep this running (or run `agentpager service install` to start it at login).'));
+    }
     // Someone who reinstalls the app, or picks up a second phone, reasonably runs `agentpager` again
     // and waits for a code that never comes — this is the only place they will look for why.
-    console.log(dim('Pairing another phone (or the same one after a reinstall)? Run `agentpager pair`.'));
-    console.log(dim(UNPAIR_HINT));
-    console.log(dim('Your sessions stay on this computer; the relay only sees encrypted bytes.\n'));
+    console.log(dim('Need anything else? Run `agentpager help`.\n'));
     // Tell the terminal AND the phone when a newer AgentPager is out.
     const checkUpdate = async () => {
         const latest = await latestVersion();
@@ -217,6 +246,9 @@ async function serve(state, keepAwake) {
     const updateTimer = setInterval(() => void checkUpdate(), 12 * 3600_000);
     const quit = async () => {
         console.log(dim('\nDisconnecting…'));
+        for (const c of channels.values())
+            c.send({ type: 'bye' });
+        await new Promise((r) => setTimeout(r, 800)); // let it leave before the socket closes
         hub.shutdown();
         stopControl();
         codex.shutdown();
@@ -303,6 +335,32 @@ async function main() {
             console.log(dim(running ? 'The running AgentPager drops it within a couple of seconds and tells the phone.' : 'Nothing is running here, so it is gone for good.'));
             process.exit(0);
         }
+        case 'help':
+        case '--help':
+        case '-h':
+            console.log(HELP);
+            process.exit(0);
+        case 'status': {
+            const up = await callControl({ kind: 'ping', title: '', text: '' }, 1500).catch(() => null);
+            console.log(up ? `● Running on ${bold(state.machineName)}` : `○ Not running. Start it: ${bold('agentpager')} (keep the window open)`);
+            console.log(`  ${state.devices.length} phone${state.devices.length === 1 ? '' : 's'} paired${state.devices.length ? ':' : ''}`);
+            printPhones(state.devices, '    ');
+            console.log(`  Starts by itself at login: ${serviceInstalled() ? 'yes' : 'no'}`);
+            const latest = await latestVersion();
+            console.log(latest && isNewer(latest, BRIDGE_VERSION) ? `  ⬆️  ${latest} is available (you have ${BRIDGE_VERSION}): ${bold(UPDATE_COMMAND)}` : `  Version ${BRIDGE_VERSION}, up to date`);
+            process.exit(0);
+        }
+        case 'stop': {
+            const up = await callControl({ kind: 'stop', title: '', text: '' }, 3000).catch(() => null);
+            if (!up)
+                console.log('AgentPager is not running.');
+            else {
+                console.log('Stopped. Your phone will say so.');
+                if (serviceInstalled())
+                    console.log(dim('It is set to start at login and may restart by itself. To turn that off: agentpager service uninstall'));
+            }
+            process.exit(0);
+        }
         case 'notify':
         case 'ask': {
             // Parse flags properly: a flag's VALUE must not leak into the message body.
@@ -433,7 +491,7 @@ async function main() {
             process.exit(0);
         }
         default:
-            console.log('Usage: agentpager [start | pair | devices | unpair <id> | doctor | guard install|status|rules|test | notify <text> | ask <text> | service install|uninstall]');
+            console.log(HELP);
             process.exit(1);
     }
 }

package/dist/hub.js

@@ -60,6 +60,8 @@ export class Hub {
     detach(channel) {
         this.channels = this.channels.filter((c) => c !== channel);
     }
+    /** `agentpager stop` from another terminal. */
+    onStop;
     /** Called with the phone that asked to be unpaired; the CLI owns the state file. */
     onUnpair;
     /** Newest version on npm, once known. Sent with every hello so the phone can say "update". */
@@ -343,6 +345,10 @@ export class Hub {
         };
         if (req.kind === 'ping')
             return { decision: 'allow', ...reach };
+        if (req.kind === 'stop') {
+            setTimeout(() => this.onStop?.(), 150); // answer first, then go
+            return { decision: 'allow', ...reach };
+        }
         // Nobody to ask is not a denial and not a wait — it's a setup problem, and the script must
         // learn that in milliseconds, not after an hour of blocking a deploy.
         if (!reach.phones)

package/dist/service.js

@@ -115,3 +115,21 @@ export function uninstallService() {
     }
     return 'Nothing to remove.';
 }
+/** Is the start-at-login service set up? Cheap and offline: it only looks for the file we wrote. */
+export function serviceInstalled() {
+    const os = platform();
+    if (os === 'darwin')
+        return existsSync(join(homedir(), 'Library', 'LaunchAgents', `${LABEL}.plist`));
+    if (os === 'linux')
+        return existsSync(join(homedir(), '.config', 'systemd', 'user', 'agentpager.service'));
+    if (os === 'win32') {
+        try {
+            execFileSync('schtasks', ['/Query', '/TN', 'AgentPager'], { stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmovex/agentpager",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Pager for your AI coding agents — approve, reply and hear results on your phone. End-to-end encrypted.",
   "main": "dist/cli.js",
   "scripts": {