@zeph-to/cli 1.13.2 → 1.15.0

package/dist/cli.js

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = require("fs");
 const child_process_1 = require("child_process");
 const zeph_hook_js_1 = require("./zeph-hook.js");
 const errors_js_1 = require("./errors.js");
@@ -13,21 +12,10 @@ const check_update_js_1 = require("./check-update.js");
 const wrapper_js_1 = require("./wrapper.js");
 const listener_js_1 = require("./listener.js");
 const config_js_1 = require("./config.js");
-const PROJECT_DIR_VARS = ['CLAUDE_PROJECT_DIR', 'CURSOR_PROJECT_DIR', 'WINDSURF_PROJECT_DIR'];
-const detectProjectDir = () => PROJECT_DIR_VARS.reduce((found, key) => found || process.env[key], undefined) ?? process.cwd();
-const isMuted = () => {
-    try {
-        const dir = detectProjectDir();
-        const raw = (0, child_process_1.execFileSync)('cksum', { input: dir, encoding: 'utf-8' });
-        const hash = raw.split(' ')[0];
-        return (0, fs_1.existsSync)(`/tmp/zeph-muted-${hash}`);
-    }
-    catch {
-        return false;
-    }
-};
+const gate_js_1 = require("./gate.js");
+const remote_agents_js_1 = require("./remote-agents.js");
 const detectBranchAndProject = () => {
-    const dir = detectProjectDir();
+    const dir = (0, config_js_1.detectProjectDir)();
     const project = dir.split('/').filter(Boolean).pop() ?? 'project';
     let branch;
     try {
@@ -67,6 +55,8 @@ const parseArgs = (argv) => {
     return result;
 };
 // ── Output ──────────────────────────────────────────────────────
+/** One usage line per registered remote agent — generated so help text can't drift from the table. */
+const usageAgentLines = () => remote_agents_js_1.REMOTE_AGENTS.map((a) => `  ${`${a.subcommands[0]} [args…]`.padEnd(15)} Run '${a.binary}' in a named tmux session ('zeph-<project>')`).join('\n');
 const printUsage = () => {
     console.log(`Usage: zeph <command> [options]
 
@@ -80,9 +70,7 @@ Commands:
   list            List recent push notifications
   dismiss <id>    Dismiss a push notification (or --all)
   test            Send a test notification to verify setup
-  cc [args…]      Run 'claude' in a named tmux session ('zeph-<project>')
-  codex [args…]   Run 'codex' in a named tmux session
-  gemini [args…]  Run 'gemini' in a named tmux session
+${usageAgentLines()}
                   (auto-suffixed -2/-3/… when another zeph cc is already
                    attached to the default name; any args after the
                    subcommand are forwarded verbatim, e.g.
@@ -99,6 +87,11 @@ Notify options:
   --priority <p>     Priority (low|normal|high|urgent) [default: normal]
   --device <id>      Target device ID
   --session <id>     AI session ID (or set ZEPH_SESSION_ID env)
+  --auto             Apply the push gate before sending (honors the
+                     /zeph-quiet | /zeph-loud dial; silent exit when gated)
+  --marker <m>       Push Signal marker for --auto (skip|push|high)
+  --tools <n>        Turn tool count for --auto [default: assume real work]
+  --nonreadonly <n>  Non-read-only tool count for --auto
 
 List options:
   --limit <n>        Number of pushes (1-20, default 5)
@@ -166,10 +159,33 @@ const createHook = (args) => {
         ...(baseUrl && { baseUrl }),
     });
 };
+/** Parse a gate count flag; garbage input falls back to the default (never accidentally silences). */
+const gateCount = (raw, fallback) => {
+    const n = typeof raw === 'string' ? Number(raw) : NaN;
+    return Number.isFinite(n) && n >= 0 ? n : fallback;
+};
 const handleNotify = async (args) => {
     const isJson = args.json === true;
-    if (isMuted())
+    const projectDir = (0, config_js_1.detectProjectDir)();
+    if ((0, gate_js_1.isMuted)(projectDir))
         return 0;
+    // --auto: apply the shared push-gate before sending. Inputs default to
+    // GATE_DEFAULTS ("assume real work") so dumb hooks keep their historical
+    // always-push behavior in normal mode, while the /zeph-quiet | /zeph-loud
+    // dial now works for every hook-driven agent. Gated-out → silent success.
+    if (args.auto === true) {
+        const verdict = (0, gate_js_1.decidePush)({
+            toolCount: gateCount(args.tools, gate_js_1.GATE_DEFAULTS.toolCount),
+            nonReadonlyCount: gateCount(args.nonreadonly, gate_js_1.GATE_DEFAULTS.nonReadonlyCount),
+            alreadyAsked: gate_js_1.GATE_DEFAULTS.alreadyAsked,
+            marker: (0, gate_js_1.normalizeMarker)(typeof args.marker === 'string' ? args.marker : undefined),
+            pushMode: (0, gate_js_1.readPushMode)(projectDir),
+        });
+        if (!verdict.push)
+            return 0;
+        if (verdict.priority === 'high' && !args.priority)
+            args.priority = 'high';
+    }
     const hook = createHook(args);
     if (!hook)
         return 3;
@@ -337,6 +353,12 @@ const main = async () => {
         printUsage();
         return 0;
     }
+    // Remote-control subcommands (`zeph cc` / `zeph codex` / …) come from the
+    // registry — one table row per agent, no hardcoded cases. Pass the typed
+    // command token to collectPassthrough (aliases map to the same agent).
+    const remote = (0, remote_agents_js_1.findAgentBySubcommand)(command);
+    if (remote)
+        return (0, wrapper_js_1.handleAgentSession)(remote, collectPassthrough(process.argv, command));
     switch (command) {
         case 'install':
         case 'setup':
@@ -357,12 +379,6 @@ const main = async () => {
             return handleDismiss(args);
         case 'test':
             return handleTest(args);
-        case 'cc':
-            return (0, wrapper_js_1.handleAgentSession)('claude', collectPassthrough(process.argv, 'cc'));
-        case 'codex':
-            return (0, wrapper_js_1.handleAgentSession)('codex', collectPassthrough(process.argv, 'codex'));
-        case 'gemini':
-            return (0, wrapper_js_1.handleAgentSession)('gemini', collectPassthrough(process.argv, 'gemini'));
         case 'listener':
             return (0, listener_js_1.handleListener)(args);
         default:

package/dist/config.d.ts

@@ -8,6 +8,9 @@ export interface ZephConfig {
     deviceId?: string;
 }
 export declare const resolvedEnv: (key: string) => string | undefined;
+export declare const PROJECT_DIR_ENV_VARS: readonly ["CLAUDE_PROJECT_DIR", "CURSOR_PROJECT_DIR", "WINDSURF_PROJECT_DIR"];
+/** First set project-dir env (unresolved `${VAR}` placeholders ignored), else cwd. */
+export declare const detectProjectDir: () => string;
 export declare const loadConfig: () => ZephConfig;
 export declare const saveConfig: (config: ZephConfig) => void;
 export declare const VERSION: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,QAA2B,CAAC;AACnD,eAAO,MAAM,WAAW,QAAkC,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAGlD,CAAC;AAEF,eAAO,MAAM,UAAU,QAAO,UAM7B,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,QAAQ,UAAU,KAAG,IAG/C,CAAC;AAEF,eAAO,MAAM,OAAO,QAOhB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,QAA2B,CAAC;AACnD,eAAO,MAAM,WAAW,QAAkC,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAGlD,CAAC;AAMF,eAAO,MAAM,oBAAoB,+EAAgF,CAAC;AAElH,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,QAAO,MAMnC,CAAC;AAEF,eAAO,MAAM,UAAU,QAAO,UAM7B,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,QAAQ,UAAU,KAAG,IAG/C,CAAC;AAEF,eAAO,MAAM,OAAO,QAOhB,CAAC"}

package/dist/config.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION = exports.saveConfig = exports.loadConfig = exports.resolvedEnv = exports.CONFIG_FILE = exports.CONFIG_DIR = void 0;
+exports.VERSION = exports.saveConfig = exports.loadConfig = exports.detectProjectDir = exports.PROJECT_DIR_ENV_VARS = exports.resolvedEnv = exports.CONFIG_FILE = exports.CONFIG_DIR = void 0;
 const fs_1 = require("fs");
 const os_1 = require("os");
 const path_1 = require("path");
@@ -11,6 +11,21 @@ const resolvedEnv = (key) => {
     return val && !val.startsWith('${') ? val : undefined;
 };
 exports.resolvedEnv = resolvedEnv;
+// Per-agent project-dir env vars, in precedence order. Deliberately NOT part
+// of the remote-agent registry: Cursor/Windsurf carry project-dir envs but
+// are not remote-controllable via tmux — the two tables have different
+// membership.
+exports.PROJECT_DIR_ENV_VARS = ['CLAUDE_PROJECT_DIR', 'CURSOR_PROJECT_DIR', 'WINDSURF_PROJECT_DIR'];
+/** First set project-dir env (unresolved `${VAR}` placeholders ignored), else cwd. */
+const detectProjectDir = () => {
+    for (const key of exports.PROJECT_DIR_ENV_VARS) {
+        const val = (0, exports.resolvedEnv)(key);
+        if (val)
+            return val;
+    }
+    return process.cwd();
+};
+exports.detectProjectDir = detectProjectDir;
 const loadConfig = () => {
     try {
         return JSON.parse((0, fs_1.readFileSync)(exports.CONFIG_FILE, 'utf-8'));

package/dist/gate.d.ts

@@ -0,0 +1,36 @@
+export type GateMarker = 'skip' | 'push' | 'high' | 'none';
+export type GatePushMode = 'quiet' | 'loud' | 'normal';
+export interface GateInput {
+    /** Total tool_use blocks this turn. */
+    toolCount: number;
+    /** Tools that are NOT read-only (Read/Grep/Glob). */
+    nonReadonlyCount: number;
+    /** A zeph_ask/zeph_prompt already notified this turn. */
+    alreadyAsked: boolean;
+    marker: GateMarker;
+    pushMode: GatePushMode;
+}
+export interface GateVerdict {
+    push: boolean;
+    priority: 'high' | 'normal';
+}
+/**
+ * "Assume real work" defaults for hooks that can't supply turn facts
+ * (most non-Claude agents pass no counts): in normal mode the push still
+ * fires — preserving the historical always-push behavior of the dumb
+ * hooks — while quiet/loud now work everywhere.
+ */
+export declare const GATE_DEFAULTS: {
+    readonly toolCount: 2;
+    readonly nonReadonlyCount: 1;
+    readonly alreadyAsked: false;
+};
+export declare const normalizeMarker: (raw: string | undefined) => GateMarker;
+export declare const normalizePushMode: (raw: string | undefined) => GatePushMode;
+export declare const decidePush: (input: GateInput) => GateVerdict;
+export declare const projectHash: (dir: string) => string | null;
+/** True when the user ran /zeph-mute for this project. */
+export declare const isMuted: (dir: string) => boolean;
+/** The user's session push-mode dial (/zeph-quiet | /zeph-loud), default normal. */
+export declare const readPushMode: (dir: string) => GatePushMode;
+//# sourceMappingURL=gate.d.ts.map

package/dist/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,GAAG,SAAS,KAAG,UACS,CAAC;AAEpE,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,GAAG,SAAS,KAAG,YACR,CAAC;AAErD,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,KAAG,WAW7C,CAAC;AAQF,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAOlD,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,OAGrC,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,YAQ1C,CAAC"}

package/dist/gate.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readPushMode = exports.isMuted = exports.projectHash = exports.decidePush = exports.normalizePushMode = exports.normalizeMarker = exports.GATE_DEFAULTS = void 0;
+/**
+ * Push-gate decision — the portable half of the Zeph Stop-hook logic.
+ *
+ * `decidePush` is the TS twin of `plugin/hooks/gate.sh` (zeph-to/plugin).
+ * Both implementations are locked to the same semantics by the shared
+ * vector file `src/fixtures/gate-vectors.json` (vendored from the plugin
+ * repo's canonical copy via `npm run sync:plugin`): the bash side and this
+ * side run the exact same cases in their CIs, so a semantic change to one
+ * that isn't mirrored in the other fails a build. Edit them together.
+ *
+ * Ordering is contractual (encoded as named vectors):
+ *   1. alreadyAsked wins over EVERYTHING — even loud (dedup beats the dial).
+ *   2. priority is high iff marker === 'high', decided BEFORE the mode
+ *      switch, so quiet+high and loud+high both push at high priority.
+ *   3. quiet → only a high marker pushes; loud → always push; normal →
+ *      marker overrides the heuristic (skip → silent, push/high → push),
+ *      no marker → push iff toolCount ≥ 2 AND nonReadonlyCount > 0
+ *      (the B1 read-only floor).
+ */
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+/**
+ * "Assume real work" defaults for hooks that can't supply turn facts
+ * (most non-Claude agents pass no counts): in normal mode the push still
+ * fires — preserving the historical always-push behavior of the dumb
+ * hooks — while quiet/loud now work everywhere.
+ */
+exports.GATE_DEFAULTS = {
+    toolCount: 2,
+    nonReadonlyCount: 1,
+    alreadyAsked: false,
+};
+const normalizeMarker = (raw) => raw === 'skip' || raw === 'push' || raw === 'high' ? raw : 'none';
+exports.normalizeMarker = normalizeMarker;
+const normalizePushMode = (raw) => raw === 'quiet' || raw === 'loud' ? raw : 'normal';
+exports.normalizePushMode = normalizePushMode;
+const decidePush = (input) => {
+    if (input.alreadyAsked)
+        return { push: false, priority: 'normal' };
+    const priority = input.marker === 'high' ? 'high' : 'normal';
+    if (input.pushMode === 'quiet')
+        return { push: input.marker === 'high', priority };
+    if (input.pushMode === 'loud')
+        return { push: true, priority };
+    if (input.marker === 'skip')
+        return { push: false, priority };
+    if (input.marker === 'push' || input.marker === 'high')
+        return { push: true, priority };
+    return { push: input.toolCount >= 2 && input.nonReadonlyCount > 0, priority };
+};
+exports.decidePush = decidePush;
+// ── Per-project gate state (mute + push-mode dial) ───────────────
+//
+// The plugin's bash hooks key these tmp files off `cksum` of the project
+// dir; shelling out to the same `cksum` here (instead of a pure-TS CRC)
+// guarantees hash parity with every already-written file.
+const projectHash = (dir) => {
+    try {
+        const raw = (0, child_process_1.execFileSync)('cksum', { input: dir, encoding: 'utf-8' });
+        return raw.split(' ')[0] || null;
+    }
+    catch {
+        return null;
+    }
+};
+exports.projectHash = projectHash;
+/** True when the user ran /zeph-mute for this project. */
+const isMuted = (dir) => {
+    const hash = (0, exports.projectHash)(dir);
+    return hash !== null && (0, fs_1.existsSync)(`/tmp/zeph-muted-${hash}`);
+};
+exports.isMuted = isMuted;
+/** The user's session push-mode dial (/zeph-quiet | /zeph-loud), default normal. */
+const readPushMode = (dir) => {
+    const hash = (0, exports.projectHash)(dir);
+    if (!hash)
+        return 'normal';
+    try {
+        return (0, exports.normalizePushMode)((0, fs_1.readFileSync)(`/tmp/zeph-pushmode-${hash}`, 'utf-8').replace(/\s+/g, ''));
+    }
+    catch {
+        return 'normal';
+    }
+};
+exports.readPushMode = readPushMode;

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { ZephHook } from './zeph-hook.js';
 export { ZephError, AuthenticationError, QuotaExceededError } from './errors.js';
 export type { ZephOptions, NotifyPayload, NotifyResult, ListParams, ListResult, DismissOneResult, DismissAllResult, PushItem } from './types.js';
+export { decidePush, GATE_DEFAULTS, normalizeMarker, normalizePushMode } from './gate.js';
+export type { GateInput, GateVerdict, GateMarker, GatePushMode } from './gate.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjF,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjF,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjJ,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC1F,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QuotaExceededError = exports.AuthenticationError = exports.ZephError = exports.ZephHook = void 0;
+exports.normalizePushMode = exports.normalizeMarker = exports.GATE_DEFAULTS = exports.decidePush = exports.QuotaExceededError = exports.AuthenticationError = exports.ZephError = exports.ZephHook = void 0;
 var zeph_hook_js_1 = require("./zeph-hook.js");
 Object.defineProperty(exports, "ZephHook", { enumerable: true, get: function () { return zeph_hook_js_1.ZephHook; } });
 var errors_js_1 = require("./errors.js");
 Object.defineProperty(exports, "ZephError", { enumerable: true, get: function () { return errors_js_1.ZephError; } });
 Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_js_1.AuthenticationError; } });
 Object.defineProperty(exports, "QuotaExceededError", { enumerable: true, get: function () { return errors_js_1.QuotaExceededError; } });
+var gate_js_1 = require("./gate.js");
+Object.defineProperty(exports, "decidePush", { enumerable: true, get: function () { return gate_js_1.decidePush; } });
+Object.defineProperty(exports, "GATE_DEFAULTS", { enumerable: true, get: function () { return gate_js_1.GATE_DEFAULTS; } });
+Object.defineProperty(exports, "normalizeMarker", { enumerable: true, get: function () { return gate_js_1.normalizeMarker; } });
+Object.defineProperty(exports, "normalizePushMode", { enumerable: true, get: function () { return gate_js_1.normalizePushMode; } });

package/dist/listener.d.ts

@@ -20,7 +20,8 @@
  * messages as new pushes are created. Reconnects with exponential
  * backoff on transient failures; gives up on auth failures (4001/4002/4003).
  */
-type AgentKind = 'claude' | 'codex' | 'gemini';
+import { type AgentKind, type RegisteredRemoteAgent } from './remote-agents.js';
+import { type AgentState } from './agent-state.js';
 interface AgentSession {
     name: string;
     attached: boolean;
@@ -30,6 +31,15 @@ interface AgentSession {
     label?: string | null;
     createdAt?: string;
     lastActivityAt?: string;
+    /**
+     * Detected agent state (wire contract — flows to the server and the
+     * phone's Agents tab). Absent when the pane can't be captured or
+     * detection is unavailable. `done` never appears here: it's derived
+     * client-side (SPEC-AGENT-AWARENESS §S1/§S6).
+     */
+    state?: AgentState;
+    stateChangedAt?: string;
+    stateRuleId?: string;
 }
 export declare const AUTH_FAILURE_CODES: ReadonlySet<number>;
 export declare const checkRateLimit: (session: string, now?: number) => boolean;
@@ -55,15 +65,78 @@ export declare const parseSessionName: (name: string) => {
     project: string;
     label: string | null;
 } | null;
+interface PaneInfo {
+    currentCommand: string | null;
+    startCommand: string | null;
+    currentPath: string | null;
+}
+/**
+ * Identify the agent from the tmux pane. Prefer `pane_start_command`
+ * because the foreground process is usually `node`/`python3` (the
+ * interpreter), which doesn't tell us *what* was launched. Fall back to
+ * `pane_current_command` when start_command is empty — tmux clears
+ * start_command in some re-attach cases, especially when a pre-existing
+ * session was joined via `tmux new -A` instead of being created fresh.
+ * That fallback is safe because only the literal binaries registered in
+ * remote-agents.ts are accepted as a match.
+ */
+export declare const detectRemoteAgent: (info: PaneInfo) => RegisteredRemoteAgent | null;
+/** Test hook. */
+export declare const resetSessionStates: () => void;
 /**
- * Locate the most recent Claude Code session UUID for the working
- * directory of a tmux pane. Mirrors `mcp-server/config.ts`'s
- * detectClaudeSessionId: CC writes per-session jsonl files at
- * `~/.claude/projects/<projectHash>/<UUID>.jsonl` where the hash is
- * the cwd with `/` replaced by `-`. Cached for 60s — see
- * claudeSessionCache.
+ * Fold one pane capture into the per-session state machine and return
+ * the wire fields for this report cycle. Exported (with `paneText`
+ * injected) so tests can drive it without tmux.
+ *
+ * Hash short-circuit: an unchanged screen skips rule evaluation but
+ * still replays the previous observation through the debounce — cheap
+ * cycles stay cheap without wedging candidate promotion.
+ */
+export declare const deriveSessionState: (name: string, agentKind: AgentKind, paneText: string | null, now?: number) => Pick<AgentSession, "state" | "stateChangedAt" | "stateRuleId">;
+export interface PatternWatch {
+    sessionName: string;
+    pattern: string;
+}
+/** Ack payload → active watch list. Prunes fired-markers for dead watches. */
+export declare const setPatternWatches: (raw: unknown) => void;
+/** Test hook. */
+export declare const resetPatternWatches: () => void;
+export interface WatchHit {
+    sessionName: string;
+    pattern: string;
+    matchedLine: string;
+}
+/**
+ * Probe every un-fired watch whose session is live. `capture` is
+ * injectable for tests; production passes capturePaneText.
+ */
+export declare const collectWatchHits: (liveNames: ReadonlySet<string>, capture?: (session: string) => string | null) => WatchHit[];
+export interface ScreenRequest {
+    subtype?: string;
+    targetDeviceId?: string;
+    sessionName?: string;
+    requestId?: string;
+}
+export interface ScreenSnapshot {
+    subtype: 'agent.screen.snapshot';
+    requestId: string;
+    sessionName: string;
+    content?: string;
+    truncated?: boolean;
+    error?: string;
+    capturedAt: string;
+}
+/**
+ * Answer a phone's screen-peek request for one of OUR sessions.
+ * Returns null when the message isn't addressed to this machine (other
+ * ephemeral traffic — clipboard, mirrors — flows through constantly).
+ *
+ * Security posture: only sessions the inventory already exposes are
+ * readable — the phone can see exactly the panes it can already send
+ * commands into, nothing else. Rate-limited with the same per-session
+ * token bucket as command injection.
  */
-export declare const detectClaudeSessionId: (cwd: string) => string | null;
+export declare const handleScreenRequest: (req: ScreenRequest) => ScreenSnapshot | null;
 export interface CollectResult {
     sessions: AgentSession[];
     /** Diagnostic notes per rejected session — surfaced under `--verbose`. */
@@ -81,11 +154,12 @@ export interface CollectResult {
 export declare const collectSessionsVerbose: () => CollectResult;
 /**
  * Snapshot the live `zeph-*` tmux sessions on this machine, enriched
- * with the running agent kind, CC session UUID (claude only), project,
- * and tmux activity timestamps. Returns [] when tmux is unreachable
- * or no agent sessions exist. Sessions whose pane is at a shell or
- * running something other than claude/codex/gemini are filtered out
- * — the phone can't usefully address them.
+ * with the running agent kind, the agent's own session id (when the
+ * registry has a resolver — currently Claude Code only), project, and
+ * tmux activity timestamps. Returns [] when tmux is unreachable or no
+ * agent sessions exist. Sessions whose pane is at a shell or running
+ * something not registered in remote-agents.ts are filtered out — the
+ * phone can't usefully address them.
  */
 export declare const collectSessions: () => AgentSession[];
 /**

package/dist/listener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../src/listener.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../src/listener.ts"],"names":[],"mappings":"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"}