@zeph-to/cli 2.12.1 → 2.13.0

package/README.md

@@ -200,8 +200,11 @@ block here.
 ### Setup
 
 1. **Install tmux.** The listener uses `send-keys`; the wrapper spawns
-   named sessions. `brew install tmux` on macOS, `apt install tmux` on
-   Debian/Ubuntu.
+   named sessions. `zeph install` checks for it and, on macOS with Homebrew,
+   offers to run `brew install tmux` for you. Elsewhere it prints the line to
+   run — `sudo apt install tmux` on Debian/Ubuntu, and so on — because
+   installing with `sudo` is not something an installer should do on your
+   behalf. tmux has no Windows build, so `zeph cc` needs WSL there.
 
 2. **Add `wsUrl` to `~/.zeph/config.json`** (the WebSocket endpoint of
    your Zeph backend — CDK output `WsApiUrl`):

package/dist/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AA+BzC;;;GAGG;AACH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,GAAG,SAAS,EAAE,SAAS,OAAO,KAAG,OACxD,CAAC;AAoBzB;6EAC6E;AAC7E,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAqBhF,CAAC;AAsCF;mEACmE;AACnE,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,KAAK,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAQ9F,CAAC;AAmPF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,KAAK,EAAE,EAAE,MAAM,MAAM,KAAG,KAAK,EAKxE,CAAC;AA8EF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EACtC,gBAAgB,OAAO,KACtB,KAAK,GAAG,IAAI,GAAG,KAKjB,CAAC;AAgCF,eAAO,MAAM,aAAa,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAuH1F,CAAC"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AA+BzC;;;GAGG;AACH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,GAAG,SAAS,EAAE,SAAS,OAAO,KAAG,OACxD,CAAC;AAoBzB;6EAC6E;AAC7E,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAqBhF,CAAC;AAsCF;mEACmE;AACnE,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,KAAK,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAQ9F,CAAC;AAmPF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,KAAK,EAAE,EAAE,MAAM,MAAM,KAAG,KAAK,EAKxE,CAAC;AA8EF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EACtC,gBAAgB,OAAO,KACtB,KAAK,GAAG,IAAI,GAAG,KAKjB,CAAC;AAgCF,eAAO,MAAM,aAAa,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CA0I1F,CAAC"}

package/dist/installer.js

@@ -10,6 +10,7 @@ const zeph_hook_js_1 = require("./zeph-hook.js");
 const config_js_1 = require("./config.js");
 const login_js_1 = require("./login.js");
 const agents_js_1 = require("./agents.js");
+const tmux_install_js_1 = require("./tmux-install.js");
 const mcp_command_js_1 = require("./mcp-command.js");
 const listener_service_js_1 = require("./listener-service.js");
 const templates_js_1 = require("./templates.js");
@@ -464,7 +465,7 @@ const applyServiceChoice = async (choice) => {
         try {
             const { confirm } = await import('@inquirer/prompts');
             wanted = await confirm({
-                message: 'Start the listener at every login? (so the phone sees this machine after a reboot)',
+                message: 'Start the listener at every login, so the phone sees this machine after a reboot? (enter to confirm)',
                 default: true,
             });
         }
@@ -551,6 +552,7 @@ const handleInstall = async (args) => {
         if (selected.length === 0) {
             console.log('    (no agents selected — only the config file will be saved)');
         }
+        console.log('    - Check tmux (`zeph cc` runs agents inside it)');
         if ((0, exports.serviceInstallChoice)(args, nonInteractive) !== 'no') {
             console.log('    - Offer to start the listener at every login');
         }
@@ -577,10 +579,28 @@ const handleInstall = async (args) => {
         if (installer)
             installer();
     }
-    // 7. Login-time service — the only thing that makes the phone see this
+    // 7. tmux — `zeph cc` is tmux or nothing, so check before claiming success.
+    console.log('\n  Checking tmux...');
+    await (0, tmux_install_js_1.ensureTmux)({
+        plan: (0, tmux_install_js_1.planTmuxInstall)({ resolve: agents_js_1.resolveCommand, platform: process.platform }),
+        nonInteractive,
+        askConfirm: async (message) => {
+            try {
+                const { confirm } = await import('@inquirer/prompts');
+                return await confirm({ message, default: true });
+            }
+            catch {
+                // Ctrl-C or no TTY — an unanswered question is not a yes.
+                return false;
+            }
+        },
+        run: (argv) => { (0, child_process_1.execFileSync)(argv[0], argv.slice(1), { stdio: 'inherit' }); },
+        report: { ok, fail, note: skipNote },
+    });
+    // 8. Login-time service — the only thing that makes the phone see this
     //    machine after a reboot without a terminal being opened first.
     await applyServiceChoice((0, exports.serviceInstallChoice)(args, nonInteractive));
-    // 8. Test connection
+    // 9. Test connection
     console.log('\n  Testing connection...');
     await testConnection(apiKey, baseUrl);
     console.log('\n  Done! Restart your agents.\n');

package/dist/tmux-install.d.ts

@@ -0,0 +1,44 @@
+/**
+ * tmux is not optional for `zeph cc` — every remote-agent subcommand runs the
+ * agent inside a named tmux session so the listener (and the phone picker) can
+ * reach it. Nothing in the install flow used to mention that, so a machine
+ * without tmux looked fully set up until the first `zeph cc` failed with an
+ * error from a program the user was never told they needed.
+ */
+/** What this machine can do about a missing tmux. */
+export type TmuxInstallPlan = {
+    readonly kind: 'present';
+    readonly path: string;
+}
+/** Safe to run unattended — no root, user-writable prefix. */
+ | {
+    readonly kind: 'command';
+    readonly run: readonly string[];
+    readonly label: string;
+}
+/** Needs root, or there is no package manager we recognise. Tell, don't do. */
+ | {
+    readonly kind: 'manual';
+    readonly hint: string;
+};
+export declare const planTmuxInstall: (deps: {
+    resolve: (cmd: string) => string | null;
+    platform: NodeJS.Platform;
+}) => TmuxInstallPlan;
+/**
+ * Act on the plan. Everything the outside world touches is injected, because
+ * the interesting branch — "offer, then run a package manager" — is otherwise
+ * only reachable through an interactive install that no test can drive.
+ */
+export declare const ensureTmux: (deps: {
+    plan: TmuxInstallPlan;
+    nonInteractive: boolean;
+    askConfirm: (message: string) => Promise<boolean>;
+    run: (argv: readonly string[]) => void;
+    report: {
+        ok: (m: string) => void;
+        fail: (m: string) => void;
+        note: (m: string) => void;
+    };
+}) => Promise<void>;
+//# sourceMappingURL=tmux-install.d.ts.map

package/dist/tmux-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux-install.d.ts","sourceRoot":"","sources":["../src/tmux-install.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qDAAqD;AACrD,MAAM,MAAM,eAAe,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACrD,8DAA8D;GAC5D;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACvF,+EAA+E;GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAWzD,eAAO,MAAM,eAAe,GAAI,MAAM;IAClC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC7B,KAAG,eAoBH,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAU,MAAM;IACnC,IAAI,EAAE,eAAe,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,GAAG,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE;QAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CAC7F,KAAG,OAAO,CAAC,IAAI,CAsBf,CAAC"}

package/dist/tmux-install.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * tmux is not optional for `zeph cc` — every remote-agent subcommand runs the
+ * agent inside a named tmux session so the listener (and the phone picker) can
+ * reach it. Nothing in the install flow used to mention that, so a machine
+ * without tmux looked fully set up until the first `zeph cc` failed with an
+ * error from a program the user was never told they needed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureTmux = exports.planTmuxInstall = void 0;
+/** Package managers that need root, and the line to hand the user for each. */
+const ROOT_PACKAGE_MANAGERS = [
+    { bin: 'apt-get', hint: 'sudo apt install tmux' },
+    { bin: 'dnf', hint: 'sudo dnf install tmux' },
+    { bin: 'pacman', hint: 'sudo pacman -S tmux' },
+    { bin: 'zypper', hint: 'sudo zypper install tmux' },
+    { bin: 'apk', hint: 'sudo apk add tmux' },
+];
+const planTmuxInstall = (deps) => {
+    const path = deps.resolve('tmux');
+    if (path)
+        return { kind: 'present', path };
+    // tmux has no native Windows build. `zeph cc` is POSIX-only by way of tmux,
+    // so point at WSL rather than at a package that cannot be installed.
+    if (deps.platform === 'win32') {
+        return { kind: 'manual', hint: '`zeph cc` needs tmux, which has no Windows build — run it under WSL' };
+    }
+    if (deps.platform === 'darwin') {
+        return deps.resolve('brew')
+            ? { kind: 'command', run: ['brew', 'install', 'tmux'], label: 'brew install tmux' }
+            : { kind: 'manual', hint: 'install Homebrew (brew.sh), then: brew install tmux' };
+    }
+    const rootManager = ROOT_PACKAGE_MANAGERS.find((pm) => deps.resolve(pm.bin));
+    if (rootManager)
+        return { kind: 'manual', hint: rootManager.hint };
+    return { kind: 'manual', hint: 'install tmux with this system\'s package manager' };
+};
+exports.planTmuxInstall = planTmuxInstall;
+/**
+ * Act on the plan. Everything the outside world touches is injected, because
+ * the interesting branch — "offer, then run a package manager" — is otherwise
+ * only reachable through an interactive install that no test can drive.
+ */
+const ensureTmux = async (deps) => {
+    const { plan, report } = deps;
+    if (plan.kind === 'present')
+        return report.ok(`tmux found (${plan.path})`);
+    if (plan.kind === 'manual')
+        return report.fail(`tmux not found — \`zeph cc\` needs it. ${plan.hint}`);
+    if (deps.nonInteractive) {
+        return report.note(`tmux not found — \`zeph cc\` needs it. Run: ${plan.label}`);
+    }
+    const wanted = await deps.askConfirm(`tmux is missing and \`zeph cc\` needs it — run \`${plan.label}\`? (enter to confirm)`);
+    if (!wanted) {
+        return report.note(`tmux not installed — \`zeph cc\` will not work until you run: ${plan.label}`);
+    }
+    try {
+        deps.run(plan.run);
+        report.ok('tmux installed');
+    }
+    catch {
+        report.fail(`\`${plan.label}\` failed — run it by hand`);
+    }
+};
+exports.ensureTmux = ensureTmux;

package/package.json

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