@zeph-to/cli 2.6.0 → 2.8.0

package/dist/session-registry.js

@@ -14,7 +14,7 @@
  * another program.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sessionDirectoryExists = exports.knownSessionsPath = exports.isKnownSession = exports.rememberSessions = exports.recallSession = exports.knownSessions = exports.KNOWN_SESSION_TTL_MS = exports.MAX_KNOWN_SESSIONS = void 0;
+exports.sessionDirectoryExists = exports.knownSessionsPath = exports.isKnownSession = exports.forgetSession = exports.rememberSessions = exports.recallSession = exports.knownSessions = exports.KNOWN_SESSION_TTL_MS = exports.MAX_KNOWN_SESSIONS = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const gate_js_1 = require("./gate.js");
@@ -100,6 +100,27 @@ const rememberSessions = (live, now = Date.now()) => {
     writeAll(entries);
 };
 exports.rememberSessions = rememberSessions;
+/**
+ * Forget one session, by name. Returns false when this machine never knew it.
+ *
+ * This is what deleting a past session means on the machine that ran it: the
+ * entry leaves the file, so the phone stops being offered the session AND —
+ * since this file is the resume whitelist — stops being able to start it.
+ * That is the intended pair, not a side effect.
+ *
+ * It stays forgotten: `rememberSessions` only writes down sessions that are
+ * running, so nothing re-adds an entry for a session that has ended. Running
+ * that name again is what brings it back, which is also the only way back.
+ */
+const forgetSession = (name) => {
+    const entries = readAll();
+    const kept = entries.filter((e) => e.name !== name);
+    if (kept.length === entries.length)
+        return false;
+    writeAll(kept);
+    return true;
+};
+exports.forgetSession = forgetSession;
 /** Whether the registry knows this name — the resume whitelist check. */
 const isKnownSession = (name, now = Date.now()) => (0, exports.recallSession)(name, now) !== null;
 exports.isKnownSession = isKnownSession;

package/dist/uninstall.d.ts

@@ -7,5 +7,13 @@ export declare const rmGeminiHook: (filePath: string, dry: boolean) => string |
  *  but events the user added since install survive. Exported for tests
  *  (codex is PATH-detected, same as gemini). */
 export declare const rmCodexHook: (filePath: string, dry: boolean) => string | null;
+/**
+ * Remove the login-time LaunchAgent, if one is installed.
+ *
+ * Async, so it does not fit the sync `Step` shape the per-agent uninstallers
+ * use — launchctl has to be waited on. Returns the same "one line or null"
+ * contract those steps do.
+ */
+export declare const removeServiceStep: (dry: boolean) => Promise<string | null>;
 export declare const handleUninstall: (args: Record<string, string | boolean>) => Promise<number>;
 //# sourceMappingURL=uninstall.d.ts.map

package/dist/uninstall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../src/uninstall.ts"],"names":[],"mappings":"AAuGA;;iDAEiD;AACjD,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,EAAE,KAAK,OAAO,KAAG,MAAM,GAAG,IAWtE,CAAC;AAEF;;;gDAGgD;AAChD,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,EAAE,KAAK,OAAO,KAAG,MAAM,GAAG,IAerE,CAAC;AAuEF,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CA8B5F,CAAC"}
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../src/uninstall.ts"],"names":[],"mappings":"AAwGA;;iDAEiD;AACjD,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,EAAE,KAAK,OAAO,KAAG,MAAM,GAAG,IAWtE,CAAC;AAEF;;;gDAGgD;AAChD,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,EAAE,KAAK,OAAO,KAAG,MAAM,GAAG,IAerE,CAAC;AAqEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAU,KAAK,OAAO,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAM3E,CAAC;AAIF,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAoC5F,CAAC"}

package/dist/uninstall.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleUninstall = exports.rmCodexHook = exports.rmGeminiHook = void 0;
+exports.handleUninstall = exports.removeServiceStep = exports.rmCodexHook = exports.rmGeminiHook = void 0;
 const child_process_1 = require("child_process");
 const fs_1 = require("fs");
 const os_1 = require("os");
 const path_1 = require("path");
 const agents_js_1 = require("./agents.js");
+const listener_service_js_1 = require("./listener-service.js");
 const templates_js_1 = require("./templates.js");
 const config_js_1 = require("./config.js");
 const HOME = (0, os_1.homedir)();
@@ -235,6 +236,24 @@ const AGENT_UNINSTALLERS = {
         () => rmAiderReadDirective((0, path_1.join)(HOME, '.aider.conf.yml'), dry),
     ]),
 };
+/**
+ * Remove the login-time LaunchAgent, if one is installed.
+ *
+ * Async, so it does not fit the sync `Step` shape the per-agent uninstallers
+ * use — launchctl has to be waited on. Returns the same "one line or null"
+ * contract those steps do.
+ */
+const removeServiceStep = async (dry) => {
+    if (!(0, listener_service_js_1.serviceInstalled)())
+        return null;
+    if (dry)
+        return `would remove the login-time service (${listener_service_js_1.SERVICE_LABEL})`;
+    const result = await (0, listener_service_js_1.uninstallService)();
+    if (!result.ok)
+        return `could not remove the login-time service: ${result.reason}`;
+    return `removed the login-time service (${listener_service_js_1.SERVICE_LABEL})`;
+};
+exports.removeServiceStep = removeServiceStep;
 // ── Entry point ──────────────────────────────────────────────────
 const handleUninstall = async (args) => {
     const dry = args['dry-run'] === true;
@@ -248,6 +267,14 @@ const handleUninstall = async (args) => {
         console.log(`  ${agent.name}:`);
         AGENT_UNINSTALLERS[agent.id]?.(dry);
     }
+    // The LaunchAgent outlives every agent's rules, so removing it is part of
+    // uninstall and not of any one agent's teardown.
+    console.log('\n  Login-time service:');
+    const serviceLine = await (0, exports.removeServiceStep)(dry);
+    if (serviceLine)
+        ok(serviceLine);
+    else
+        skip('not installed');
     // ~/.zeph/config.json holds the API key — kept by default so a
     // re-install doesn't need the key re-entered. --purge removes it.
     console.log('\n  Config:');

package/dist/verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,YAAY,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAwEzF,CAAC"}
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,YAAY,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAiFzF,CAAC"}

package/dist/verify.js

@@ -6,6 +6,7 @@ const os_1 = require("os");
 const path_1 = require("path");
 const agents_js_1 = require("./agents.js");
 const config_js_1 = require("./config.js");
+const listener_service_js_1 = require("./listener-service.js");
 const zeph_hook_js_1 = require("./zeph-hook.js");
 const HOME = (0, os_1.homedir)();
 const pass = (msg) => console.log(`    ✓ ${msg}`);
@@ -55,7 +56,7 @@ const handleVerify = async (args) => {
     console.log('  Credentials:');
     const config = (0, config_js_1.loadConfig)();
     const apiKey = (0, config_js_1.resolvedEnv)('ZEPH_API_KEY') || config.apiKey;
-    const hookId = (0, config_js_1.resolvedEnv)('ZEPH_HOOK_ID') || config.hookId;
+    const hookId = (0, config_js_1.resolveHookId)();
     record(apiKey ? 'ZEPH_API_KEY is set' : 'ZEPH_API_KEY not set (env or ~/.zeph/config.json)', apiKey ? 'pass' : 'fail');
     record(hookId
         ? 'ZEPH_HOOK_ID is set (two-way zeph_ask/prompt/input enabled)'
@@ -67,6 +68,15 @@ const handleVerify = async (args) => {
     record((0, agents_js_1.hasCommand)('zeph')
         ? 'zeph CLI on PATH'
         : 'zeph CLI not on PATH (hooks fall back to npx — slower first call)', (0, agents_js_1.hasCommand)('zeph') ? 'pass' : 'warn');
+    // ── Login-time service ───────────────────────────────────────
+    // Optional, so a missing one is a warning. A broken one is not: every way
+    // it breaks still looks installed from the outside.
+    const serviceRows = (0, listener_service_js_1.serviceHealthChecks)((0, listener_service_js_1.serviceStatus)());
+    if (serviceRows.length > 0) {
+        console.log('\n  Login-time service:');
+        for (const row of serviceRows)
+            record(row.label, row.state);
+    }
     // ── Per-agent config ─────────────────────────────────────────
     console.log('\n  Agents:');
     const detected = (0, agents_js_1.detectAgents)().filter((a) => a.detected);

package/dist/wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOtD,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAO,MAapC,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,KAAG,MAA2B,CAAC;AAI9E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,MAenD,CAAC;AAmCF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,GAAG,IAAI,EAAE,WAAW,MAAM,KAAG,OAChC,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAa,OAAO,CAAC,IAAI,CAa1D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAU,OAAO,WAAW,EAAE,QAAO,MAAM,EAAO,KAAG,OAAO,CAAC,MAAM,CAmCjG,CAAC"}
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOtD,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAO,MAapC,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,KAAG,MAA2B,CAAC;AAI9E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,MAenD,CAAC;AAmCF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,GAAG,IAAI,EAAE,WAAW,MAAM,KAAG,OAChC,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAa,OAAO,CAAC,IAAI,CAgC1D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAU,OAAO,WAAW,EAAE,QAAO,MAAM,EAAO,KAAG,OAAO,CAAC,MAAM,CAmCjG,CAAC"}

package/dist/wrapper.js

@@ -17,6 +17,7 @@ const path_1 = require("path");
 const check_update_js_1 = require("./check-update.js");
 const config_js_1 = require("./config.js");
 const listener_process_js_1 = require("./listener-process.js");
+const listener_service_js_1 = require("./listener-service.js");
 const FALLBACK_NAME = 'project';
 /** basename(), with a stable fallback for edge paths like `/`. */
 const safeBasename = (path) => (0, path_1.basename)(path) || FALLBACK_NAME;
@@ -126,10 +127,29 @@ exports.listenerVersionDrifted = listenerVersionDrifted;
  */
 const ensureListenerRunning = async () => {
     const pid = (0, listener_process_js_1.runningListenerPid)();
-    if (pid !== null) {
-        const running = (0, listener_process_js_1.runningListenerVersion)();
-        if (!(0, exports.listenerVersionDrifted)(running, config_js_1.VERSION))
+    const running = pid === null ? null : (0, listener_process_js_1.runningListenerVersion)();
+    if (pid !== null && !(0, exports.listenerVersionDrifted)(running, config_js_1.VERSION))
+        return;
+    // When the login-time service is installed, launchd owns this process.
+    // Stopping its child makes launchd start a replacement while we spawn our
+    // own, and the two race through the singleton guard in handleListener —
+    // whichever loses exits 0, and if that is launchd's child, KeepAlive
+    // either flaps it every ThrottleInterval or reads the clean exit as
+    // deliberate and gives up for the rest of the login session. Ask launchd
+    // to do it instead; `kickstart -k` replaces a drifted daemon in one step.
+    if ((0, listener_service_js_1.serviceInstalled)()) {
+        const result = (0, listener_service_js_1.restartService)();
+        if (!result.ok) {
+            console.error(`zeph: could not start the listener service — ${result.reason}`);
             return;
+        }
+        if (pid === null)
+            console.log(`zeph: listener started by launchd (log: ${listener_process_js_1.LISTENER_LOG_FILE})`);
+        else
+            console.log(`zeph: listener ${running ?? '(pre-1.26)'} is stale — launchd restarting on ${config_js_1.VERSION}`);
+        return;
+    }
+    if (pid !== null) {
         console.log(`zeph: listener ${running ?? '(pre-1.26)'} is stale — restarting on ${config_js_1.VERSION}`);
         await (0, listener_process_js_1.stopListener)(pid);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeph-to/cli",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "Zeph CLI + push notification SDK for AI agents",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",