@hwip/cli 0.1.3 → 0.1.5

package/dist/remote-agents.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.matchAgentByPaneCommand = exports.findAgentBySubcommand = exports.REMOTE_AGENTS = exports.opencodeTranscriptPath = exports.detectOpencodeSession = exports.geminiTranscriptPath = exports.codexTranscriptPath = exports.detectCodexSessionName = exports.newestVersionedDb = exports.detectHermesSessionName = exports.sqliteJson = exports.pickRowByProcStart = exports.piTranscriptPath = exports.claudeTranscriptPath = exports.detectClaudeSessionNameByPid = exports.detectClaudeSessionIdByPid = exports.detectClaudeSessionByPid = exports.pidSessionRecordsExist = exports.collectDescendantPids = exports.psStartTimes = exports.foregroundAgentFor = exports.readProcTable = exports.parseProcTable = exports.detectClaudeSessionId = exports.claudeProjectDirName = void 0;
+exports.matchAgentByPaneCommand = exports.findAgentBySubcommand = exports.REMOTE_AGENTS = exports.opencodeTranscriptPath = exports.detectOpencodeSession = exports.geminiTranscriptPath = exports.codexTranscriptPath = exports.detectCodexSessionName = exports.newestVersionedDb = exports.detectHermesResumeId = exports.detectHermesSessionName = exports.sqliteJson = exports.transcriptIdSince = exports.paneSince = exports.pickRowByProcStart = exports.detectPiSessionName = exports.piTranscriptPath = exports.claudeTranscriptPath = exports.detectClaudeProviderName = exports.detectClaudeSessionIdByPid = exports.detectClaudeSessionByPid = exports.pidSessionRecordsExist = exports.collectDescendantPids = exports.psStartTimes = exports.foregroundAgentFor = exports.readProcTable = exports.parseProcTable = exports.detectClaudeSessionId = exports.claudeProjectDirName = void 0;
 /**
  * Remote-control agent registry — the single table behind every
  * `hwip <agent>` subcommand, the listener's pane matching, and the
@@ -22,6 +22,7 @@ const path_1 = require("path");
 const child_process_1 = require("child_process");
 const transcript_tail_js_1 = require("./transcript-tail.js");
 const pi_transcript_js_1 = require("./pi-transcript.js");
+const session_title_js_1 = require("./session-title.js");
 const codex_transcript_js_1 = require("./codex-transcript.js");
 const gemini_transcript_js_1 = require("./gemini-transcript.js");
 const opencode_transcript_js_1 = require("./opencode-transcript.js");
@@ -158,6 +159,7 @@ const readPidSessionRecords = () => {
                         sessionId: raw.sessionId,
                         cwd: raw.cwd,
                         ...(typeof raw.name === 'string' ? { name: raw.name } : {}),
+                        ...(typeof raw.nameSource === 'string' ? { nameSource: raw.nameSource } : {}),
                     });
                 }
             }
@@ -395,14 +397,35 @@ const detectClaudeSessionByPid = (panePid, paneCwd, deps = {}) => {
 exports.detectClaudeSessionByPid = detectClaudeSessionByPid;
 const detectClaudeSessionIdByPid = (panePid, paneCwd, deps = {}) => (0, exports.detectClaudeSessionByPid)(panePid, paneCwd, deps)?.sessionId ?? null;
 exports.detectClaudeSessionIdByPid = detectClaudeSessionIdByPid;
+/** Claude transcripts whose latest `ai-title` the listener keeps, read incrementally. */
+const claudeTitles = (0, session_title_js_1.createTailWatch)(session_title_js_1.latestClaudeAiTitle);
 /**
- * The name of the session running in this pane. No mtime fallback exists here:
- * the transcript filenames the heuristic walks carry a UUID and nothing else,
- * so an older CC without `~/.claude/sessions` yields no name and the phone
- * keeps the computed label.
+ * What the phone should call the Claude Code session in this pane, and who
+ * chose it.
+ *
+ * A `/rename` (`nameSource: "user"`) wins. Otherwise the newest `ai-title` CC
+ * wrote into the transcript — its own summary of the work, which is what tells
+ * parallel sessions apart. A derived name (`hybrid-shell-8f`, from the cwd)
+ * is never sent: it says no more than the tmux name the phone falls back to.
+ * A record from an older CC carries a name but no `nameSource`; that one is
+ * sent as before, with no source, ahead of any ai-title, since it may be the
+ * user's rename. No mtime
+ * fallback: only the pid match says which session this pane is.
  */
-const detectClaudeSessionNameByPid = (panePid, paneCwd, deps = {}) => nonBlank((0, exports.detectClaudeSessionByPid)(panePid, paneCwd, deps)?.name);
-exports.detectClaudeSessionNameByPid = detectClaudeSessionNameByPid;
+const detectClaudeProviderName = (panePid, paneCwd, deps = {}) => {
+    const record = (0, exports.detectClaudeSessionByPid)(panePid, paneCwd, deps);
+    if (!record)
+        return null;
+    const recordName = nonBlank(record.name);
+    if (recordName && record.nameSource === 'user')
+        return { name: recordName, source: 'user' };
+    if (recordName && record.nameSource === undefined)
+        return { name: recordName };
+    const transcript = (deps.transcriptOf ?? claudeConversationFile)(record.cwd, record.sessionId);
+    const title = transcript ? claudeTitles.read(transcript) : undefined;
+    return title ? { name: title, source: 'auto' } : null;
+};
+exports.detectClaudeProviderName = detectClaudeProviderName;
 /**
  * The transcript file for the Claude Code session running in a tmux pane.
  *
@@ -559,6 +582,23 @@ const piTranscriptPath = (paneCwd, panePid) => {
     return piSessionCache.set(key, doDetectPiTranscript(paneCwd));
 };
 exports.piTranscriptPath = piTranscriptPath;
+const piNames = (0, session_title_js_1.createTailWatch)(session_title_js_1.piNamesStep);
+/**
+ * The name a pi pane's session goes by, and who chose it: the newest
+ * `session_info` name, which is the agent's (`'auto'`) when the hwip
+ * extension's tool set it — the tool leaves a marker entry with the same name
+ * (`PI_TITLE_MARKER`) — and the user's (`/name`) otherwise. Read from the
+ * transcript tail, so a name written before the last 256 KB of a session the
+ * listener first meets late is not found until the next one is written.
+ */
+const detectPiSessionName = (paneCwd, panePid, transcriptOf = exports.piTranscriptPath) => {
+    const file = transcriptOf(paneCwd, panePid);
+    const names = file ? piNames.read(file) : undefined;
+    if (!names?.name)
+        return null;
+    return { name: names.name, source: names.marked === names.name ? 'auto' : 'user' };
+};
+exports.detectPiSessionName = detectPiSessionName;
 // ── Agents whose session store keeps no pid ──────────────────────
 //
 // Hermes and Codex both record a session per cwd with a creation timestamp and
@@ -596,6 +636,43 @@ const pickRowByProcStart = (rows, tsMsOf, startTimes, pids) => {
     return best?.row ?? null;
 };
 exports.pickRowByProcStart = pickRowByProcStart;
+/**
+ * How far before the pane's start a write may land and still be the pane's: `ps` `lstart` is whole seconds. Not
+ * {@link PROC_MATCH_TOLERANCE_MS} — the last sitting's final write lands seconds before an `exit` and a fresh
+ * start, and a margin that wide would read the fresh pane as carrying it on.
+ */
+const PANE_WRITE_MARGIN_MS = 2_000;
+/**
+ * From when a conversation written to is this pane's: its earliest process start, less {@link PANE_WRITE_MARGIN_MS}. A
+ * resume writes to the conversation it picked back up, so that one is written to after the start; a fresh start
+ * has not written yet, so the folder's older conversations are all before it. Null when no start is known.
+ */
+const paneSince = (panePid, deps = {}) => {
+    const startTimes = deps.startTimes ?? (0, exports.psStartTimes)();
+    const starts = [...(deps.descendants ?? (0, exports.collectDescendantPids)(panePid))]
+        .map((pid) => startTimes.get(pid))
+        .filter((t) => t !== undefined && Number.isFinite(t));
+    return starts.length === 0 ? null : Math.min(...starts) - PANE_WRITE_MARGIN_MS;
+};
+exports.paneSince = paneSince;
+/**
+ * The conversation a transcript file holds — its name without `.jsonl` — when it was written to since `since`.
+ * For the agents whose resume appends to the file it picks back up (pi `-c`, Codex `resume`, Gemini `--resume`,
+ * measured 2026-10-20): the file is the conversation.
+ */
+const transcriptIdSince = (path, since) => {
+    if (!path || since === null)
+        return null;
+    try {
+        return (0, fs_1.statSync)(path).mtimeMs >= since ? (0, path_1.basename)(path, '.jsonl') : null;
+    }
+    catch {
+        return null;
+    }
+};
+exports.transcriptIdSince = transcriptIdSince;
+/** {@link transcriptIdSince} for a pane: what `resolveResumeId` answers for an agent whose transcript is a file. */
+const paneTranscriptId = (path, panePid) => panePid === undefined ? null : (0, exports.transcriptIdSince)(path, (0, exports.paneSince)(panePid));
 /**
  * Read rows from a SQLite file as JSON. Null on every failure — no `sqlite3` on
  * PATH, a locked or corrupt database, a schema that moved — because a missing
@@ -652,10 +729,44 @@ const detectHermesSessionName = (paneCwd, panePid, deps = {}) => {
         return null;
     const row = (0, exports.pickRowByProcStart)(rows, (r) => (typeof r.started_at === 'number' ? r.started_at * 1_000 : null), deps.startTimes ?? (0, exports.psStartTimes)(), deps.descendants ?? (0, exports.collectDescendantPids)(panePid));
     // The auto-title is written asynchronously after the first response, so an
-    // untitled row is a young session, not a broken one.
-    return nonBlank(row?.title ?? undefined) ?? nonBlank(row?.display_name ?? undefined);
+    // untitled row is a young session, not a broken one. `title` is Hermes'
+    // own; `display_name` comes from outside its titler (a gateway fills it
+    // from the chat it serves), so it is never one to hide.
+    const title = nonBlank(row?.title ?? undefined);
+    if (title)
+        return { name: title, source: 'auto' };
+    const display = nonBlank(row?.display_name ?? undefined);
+    return display ? { name: display, source: 'user' } : null;
 };
 exports.detectHermesSessionName = detectHermesSessionName;
+const readHermesActive = ttlMemo(SNAPSHOT_TTL_MS, () => (0, exports.sqliteJson)(HERMES_STATE_DB, `SELECT s.id AS id, s.cwd AS cwd, (SELECT max(m.timestamp) FROM messages m WHERE m.session_id = s.id) AS active
+     FROM sessions s WHERE s.source = 'cli' ORDER BY s.started_at DESC LIMIT ${STORE_ROW_LIMIT}`));
+/**
+ * The Hermes session this pane carries on: in its directory, with a message since the pane started — the newest.
+ * A `-c` picks back up a session started long before the pane, which the start-time match above cannot see.
+ */
+const detectHermesResumeId = (paneCwd, panePid, deps = {}) => {
+    if (panePid === undefined)
+        return null;
+    const raw = deps.rows !== undefined ? deps.rows : readHermesActive();
+    if (raw === null)
+        return null;
+    const since = (0, exports.paneSince)(panePid, deps);
+    if (since === null)
+        return null;
+    let best = null;
+    // The query's own columns; each is checked with typeof below before it is used.
+    for (const row of raw) {
+        if (row.cwd !== paneCwd || typeof row.id !== 'string' || !row.id)
+            continue;
+        if (typeof row.active !== 'number' || row.active * 1_000 < since)
+            continue;
+        if (!best || row.active > (best.active ?? 0))
+            best = row;
+    }
+    return best?.id ?? null;
+};
+exports.detectHermesResumeId = detectHermesResumeId;
 // ── Codex ────────────────────────────────────────────────────────
 const CODEX_DIR = (0, path_1.join)((0, os_1.homedir)(), '.codex');
 const CODEX_STATE_DB = /^state_(\d+)\.sqlite$/;
@@ -715,7 +826,13 @@ const detectCodexSessionName = (paneCwd, panePid, deps = {}) => {
     if (rows.length === 0)
         return null;
     const row = (0, exports.pickRowByProcStart)(rows, (r) => r.created_at_ms ?? (typeof r.created_at === 'number' ? r.created_at * 1_000 : null), deps.startTimes ?? (0, exports.psStartTimes)(), deps.descendants ?? (0, exports.collectDescendantPids)(panePid));
-    return nonBlank(row?.name ?? undefined) ?? nonBlank(row?.title ?? undefined);
+    // `name` is what the user typed (`/rename`); `title` is Codex's own —
+    // the first prompt, verbatim.
+    const name = nonBlank(row?.name ?? undefined);
+    if (name)
+        return { name, source: 'user' };
+    const title = nonBlank(row?.title ?? undefined);
+    return title ? { name: title, source: 'auto' } : null;
 };
 exports.detectCodexSessionName = detectCodexSessionName;
 /**
@@ -1031,13 +1148,9 @@ const detectOpencodeSession = (paneCwd, panePid, deps = {}) => {
     const raw = deps.rows !== undefined ? deps.rows : readOpencodeSessions();
     if (raw === null)
         return null;
-    const startTimes = deps.startTimes ?? (0, exports.psStartTimes)();
-    const starts = [...(deps.descendants ?? (0, exports.collectDescendantPids)(panePid))]
-        .map((pid) => startTimes.get(pid))
-        .filter((t) => t !== undefined && Number.isFinite(t));
-    if (starts.length === 0)
+    const since = (0, exports.paneSince)(panePid, deps);
+    if (since === null)
         return null;
-    const since = Math.min(...starts) - PROC_MATCH_TOLERANCE_MS;
     const dir = realDir(paneCwd);
     let best = null;
     for (const row of raw) {
@@ -1079,7 +1192,7 @@ const REMOTE_AGENT_TABLE = [
         // (older CC without ~/.claude/sessions, or ps failure).
         resolveSessionId: (paneCwd, panePid) => (panePid !== undefined ? (0, exports.detectClaudeSessionIdByPid)(panePid, paneCwd) : null)
             ?? (0, exports.detectClaudeSessionId)(paneCwd),
-        resolveSessionName: (paneCwd, panePid) => panePid !== undefined ? (0, exports.detectClaudeSessionNameByPid)(panePid, paneCwd) : null,
+        resolveSessionName: (paneCwd, panePid) => panePid !== undefined ? (0, exports.detectClaudeProviderName)(panePid, paneCwd) : null,
         resolveTranscript: (paneCwd, panePid) => (0, exports.claudeTranscriptPath)(paneCwd, panePid),
         projectTranscript: transcript_tail_js_1.projectTranscriptEntries,
         // The pid match alone: the mtime fallback above can name another
@@ -1098,6 +1211,8 @@ const REMOTE_AGENT_TABLE = [
         resolveSessionName: exports.detectCodexSessionName,
         resolveTranscript: (paneCwd, panePid) => (0, exports.codexTranscriptPath)(paneCwd, panePid),
         projectTranscript: codex_transcript_js_1.projectCodexEntries,
+        // Read only to tell a resumed conversation's run (no `resumeArgs`): the rollout a resume appends to.
+        resolveResumeId: (paneCwd, panePid) => paneTranscriptId((0, exports.codexTranscriptPath)(paneCwd, panePid), panePid),
     },
     {
         // The pane binary is `cursor-agent`, Cursor's terminal TUI — NOT the
@@ -1118,6 +1233,7 @@ const REMOTE_AGENT_TABLE = [
         // limit pi has (newest file wins).
         resolveTranscript: (paneCwd, panePid) => (0, exports.geminiTranscriptPath)(paneCwd, panePid),
         projectTranscript: gemini_transcript_js_1.projectGeminiEntries,
+        resolveResumeId: (paneCwd, panePid) => paneTranscriptId((0, exports.geminiTranscriptPath)(paneCwd, panePid), panePid),
     },
     {
         // `hermes` on PATH is a bash script that execs a venv Python, so the
@@ -1133,6 +1249,7 @@ const REMOTE_AGENT_TABLE = [
         // No `resolveSessionId` counterpart: the store's own id is a
         // `<timestamp>_<hash>` string, and nothing on the wire consumes it yet.
         resolveSessionName: exports.detectHermesSessionName,
+        resolveResumeId: exports.detectHermesResumeId,
     },
     {
         kind: 'pi',
@@ -1141,6 +1258,8 @@ const REMOTE_AGENT_TABLE = [
         subcommands: ['pi'],
         resolveTranscript: (paneCwd, panePid) => (0, exports.piTranscriptPath)(paneCwd, panePid),
         projectTranscript: pi_transcript_js_1.projectPiEntries,
+        resolveResumeId: (paneCwd, panePid) => paneTranscriptId((0, exports.piTranscriptPath)(paneCwd, panePid), panePid),
+        resolveSessionName: (paneCwd, panePid) => (0, exports.detectPiSessionName)(paneCwd, panePid),
     },
     {
         kind: 'opencode',
@@ -1150,7 +1269,11 @@ const REMOTE_AGENT_TABLE = [
         // Typed into a 2.0.24 TUI pane: `/exit` + Enter closed it.
         quitCommand: '/exit',
         resolveSessionId: (paneCwd, panePid) => (0, exports.detectOpencodeSession)(paneCwd, panePid)?.id ?? null,
-        resolveSessionName: (paneCwd, panePid) => (0, exports.detectOpencodeSession)(paneCwd, panePid)?.title ?? null,
+        // opencode titles a session itself after the first exchange.
+        resolveSessionName: (paneCwd, panePid) => {
+            const title = (0, exports.detectOpencodeSession)(paneCwd, panePid)?.title;
+            return title ? { name: title, source: 'auto' } : null;
+        },
         resolveTranscript: (paneCwd, panePid) => (0, exports.opencodeTranscriptPath)(paneCwd, panePid),
         projectTranscript: opencode_transcript_js_1.projectOpencodeEntries,
         readTranscript: (path, prev) => (0, opencode_transcript_js_1.readOpencodeTranscript)(path, prev, { query: queryOpencodeTranscript }),

package/dist/schedule-command.d.ts

@@ -1,5 +1,5 @@
 /**
- * `hwip schedule` — add, list and remove scheduled sessions (F8).
+ * `hwip schedule` — add, list, edit and remove scheduled sessions (F8).
  *
  * This only writes and reads the files in `schedule.ts`. The listener starts the sessions
  * (`schedule-runner.ts`), so nothing here needs a running listener except the sessions firing.
@@ -16,6 +16,11 @@ export interface ScheduleCommandDeps {
     listenerRunning: () => boolean;
     /** The agent kinds a prompt can be scheduled for: those whose detection rules can say `idle` (`schedule-ready.ts`). */
     promptKinds: () => readonly string[];
+    /**
+     * Has a running listener of an older build replaced (`ensureListenerRunning`): an old one would skip a file it cannot read.
+     * False when one still runs after it.
+     */
+    refreshListener: () => Promise<boolean>;
     out: (line: string) => void;
     err: (line: string) => void;
 }
@@ -27,6 +32,11 @@ interface Built {
 }
 /** The schedule `hwip schedule add <words>` asks for, before it has an id. */
 export declare const buildSchedule: (words: string[], deps: ScheduleCommandDeps) => Promise<Checked<Built>>;
+/**
+ * Runs `work` with what it prints going to stderr: the listener refresh reports on stdout (`ensureListenerRunning`),
+ * and `hwip schedule edit --json` promises one JSON line there.
+ */
+export declare const onStderr: (work: () => Promise<void>) => Promise<void>;
 /** `words`: argv after `schedule`. Returns the exit code. */
 export declare const runSchedule: (words: string[], deps: ScheduleCommandDeps) => Promise<number>;
 export declare const liveScheduleDeps: () => ScheduleCommandDeps;

package/dist/schedule-command.js

@@ -1,12 +1,12 @@
 "use strict";
 /**
- * `hwip schedule` — add, list and remove scheduled sessions (F8).
+ * `hwip schedule` — add, list, edit and remove scheduled sessions (F8).
  *
  * This only writes and reads the files in `schedule.ts`. The listener starts the sessions
  * (`schedule-runner.ts`), so nothing here needs a running listener except the sessions firing.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleSchedule = exports.liveScheduleDeps = exports.runSchedule = exports.buildSchedule = exports.describeWhen = void 0;
+exports.handleSchedule = exports.liveScheduleDeps = exports.runSchedule = exports.onStderr = exports.buildSchedule = exports.describeWhen = void 0;
 const args_js_1 = require("./args.js");
 const schedule_js_1 = require("./schedule.js");
 const config_js_1 = require("./config.js");
@@ -16,6 +16,7 @@ const schedule_ready_js_1 = require("./schedule-ready.js");
 const wrapper_js_1 = require("./wrapper.js");
 const worktree_js_1 = require("./worktree.js");
 const USAGE = "usage: hwip schedule add <agent> (--at HH:MM [--days daily|weekdays|mon,wed,…] | --every <N>m|<N>h) [--prompt <text>] [--label <x>] [--wt <branch>] [--max-runtime <N>m|<N>h] [-- <agent args…>]\n"
+    + '       hwip schedule edit <id> [--at HH:MM] [--days …] [--every <N>m|<N>h] [--prompt <text>] [--max-runtime <N>m|<N>h]\n'
     + '       hwip schedule [list] [--json]\n'
     + '       hwip schedule rm <id>';
 const LISTENER_NOTE = "hwip: schedules start only while the listener runs ('hwip listener --install-service' keeps it running at login)";
@@ -142,7 +143,7 @@ const handleAdd = async (words, json, deps) => {
         return 2;
     }
     const { schedule } = added;
-    const next = (0, schedule_js_1.nextOccurrence)(schedule.when, deps.now(), Date.parse(schedule.createdAt));
+    const next = (0, schedule_js_1.nextOccurrence)(schedule.when, deps.now(), (0, schedule_js_1.scheduleAnchor)(schedule));
     if (json) {
         deps.out(JSON.stringify({ ...schedule, nextAt: isoOrNull(next) }));
     }
@@ -159,7 +160,7 @@ const handleList = (json, deps) => {
     const state = (0, schedule_js_1.readScheduleState)().schedules;
     const now = deps.now();
     const rows = schedules.map((schedule) => {
-        const next = (0, schedule_js_1.nextOccurrence)(schedule.when, now, Date.parse(schedule.createdAt));
+        const next = (0, schedule_js_1.nextOccurrence)(schedule.when, now, (0, schedule_js_1.scheduleAnchor)(schedule));
         const last = state[schedule.id]?.last;
         return { schedule, next, last, running: state[schedule.id]?.running !== undefined };
     });
@@ -216,6 +217,108 @@ const handleRemove = (id, deps) => {
     deps.out(`removed ${id}. A session it already started keeps running; end it yourself if you want it gone.`);
     return 0;
 };
+/**
+ * Runs `work` with what it prints going to stderr: the listener refresh reports on stdout (`ensureListenerRunning`),
+ * and `hwip schedule edit --json` promises one JSON line there.
+ */
+const onStderr = async (work) => {
+    const log = console.log;
+    console.log = console.error;
+    try {
+        await work();
+    }
+    finally {
+        console.log = log;
+    }
+};
+exports.onStderr = onStderr;
+/** The schedule's new `when` from the flags given: what is not given is kept, so `--at` keeps the days and `--days` the time. */
+const editedWhen = (current, at, days, every) => {
+    if (at === undefined && days === undefined && every === undefined)
+        return { ok: true, value: undefined };
+    if (every !== undefined || at !== undefined) {
+        const keptDays = current.kind === 'daily' ? current.days.map((day) => schedule_js_1.DAY_NAMES[day]).join(',') : undefined;
+        return (0, schedule_js_1.parseWhen)({ at, every, days: days ?? (every === undefined ? keptDays : undefined) });
+    }
+    if (current.kind !== 'daily')
+        return { ok: false, error: '--days needs --at HH:MM for a schedule that runs --every' };
+    return (0, schedule_js_1.parseWhen)({ at: current.at, days });
+};
+const buildChange = (current, flags, deps) => {
+    if (flags._arg1)
+        return { ok: false, error: `unexpected word '${String(flags._arg1)}'` };
+    const fixed = ['label', 'wt'].find((name) => flags[name] !== undefined);
+    if (fixed)
+        return { ok: false, error: `--${fixed} cannot be edited: the session is named for it; remove the schedule and add it again` };
+    const read = (name) => flagText(flags, name);
+    const [at, days, every, prompt, maxRuntime] = ['at', 'days', 'every', 'prompt', 'max-runtime'].map(read);
+    const bad = [at, days, every, prompt, maxRuntime].find((r) => !r.ok);
+    if (bad && !bad.ok)
+        return bad;
+    const value = (r) => (r.ok ? r.value : undefined);
+    const when = editedWhen(current.when, value(at), value(days), value(every));
+    if (!when.ok)
+        return when;
+    const change = when.value === undefined ? {} : { when: when.value };
+    const text = value(prompt);
+    if (text !== undefined) {
+        if (text.trim() === '')
+            return { ok: false, error: '--prompt must not be empty' };
+        if (!deps.promptKinds().includes(current.agentKind)) {
+            return { ok: false, error: `${current.agentKind} cannot take a scheduled --prompt: hwip has no rule that tells when it is idle` };
+        }
+        change.prompt = text;
+    }
+    if (value(maxRuntime) !== undefined) {
+        const parsed = (0, schedule_js_1.parseDuration)(value(maxRuntime), '--max-runtime', '90m or 2h');
+        if (!parsed.ok)
+            return parsed;
+        change.maxRuntimeMin = parsed.value;
+    }
+    if (Object.keys(change).length === 0)
+        return { ok: false, error: 'edit needs --at, --days, --every, --prompt or --max-runtime' };
+    return { ok: true, value: change };
+};
+const handleEdit = async (words, json, deps) => {
+    // `parseArgs` reads the words after the program name and script; the first word is the id.
+    const flags = (0, args_js_1.parseArgs)(['node', 'hwip', ...words]);
+    const id = flags._command === undefined ? '' : String(flags._command);
+    if (!(0, schedule_js_1.isScheduleId)(id)) {
+        deps.err(id ? `hwip schedule: '${id}' is not a schedule id` : 'hwip schedule: edit needs a schedule id');
+        return 2;
+    }
+    const current = (0, schedule_js_1.listSchedules)().schedules.find((schedule) => schedule.id === id);
+    if (!current) {
+        deps.err(`hwip schedule: no schedule ${id}`);
+        return 1;
+    }
+    const change = buildChange(current, flags, deps);
+    if (!change.ok) {
+        deps.err(`hwip schedule: ${change.error}`);
+        return 2;
+    }
+    // A new time writes `updatedAt`, which an older listener does not know: it would skip the file and the schedule would stop.
+    if (deps.listenerRunning() && !(await deps.refreshListener()) && change.value.when !== undefined) {
+        deps.err('hwip schedule: the listener running is an older hwip that could not be replaced, and it would stop running this schedule: restart it, then edit again');
+        return 1;
+    }
+    const updated = (0, schedule_js_1.updateSchedule)(id, change.value, deps.now());
+    if (!updated.ok) {
+        deps.err(`hwip schedule: ${updated.error}`);
+        return updated.failure === 'missing' ? 1 : 2;
+    }
+    const { schedule } = updated;
+    const next = (0, schedule_js_1.nextOccurrence)(schedule.when, deps.now(), (0, schedule_js_1.scheduleAnchor)(schedule));
+    if (json) {
+        deps.out(JSON.stringify({ ...schedule, nextAt: isoOrNull(next) }));
+    }
+    else {
+        deps.out(`updated ${schedule.id}: ${(0, exports.describeWhen)(schedule.when)}${next === null ? '' : `, next ${formatTime(next)}`} (ends after ${schedule.maxRuntimeMin}m)`);
+    }
+    if (!deps.listenerRunning())
+        deps.err(LISTENER_NOTE);
+    return 0;
+};
 const JSON_ON = new Set(['--json', '--json=true', '--json=1', '--json=yes']);
 /** `words`: argv after `schedule`. Returns the exit code. */
 const runSchedule = async (words, deps) => {
@@ -229,6 +332,8 @@ const runSchedule = async (words, deps) => {
     switch (sub) {
         case 'add':
             return handleAdd(rest, json, deps);
+        case 'edit':
+            return handleEdit(rest, json, deps);
         case 'list':
             if (rest.length > 0)
                 break;
@@ -252,6 +357,10 @@ const liveScheduleDeps = () => ({
     validBranch: (root, name) => (0, worktree_js_1.isValidBranchName)(root, name),
     listenerRunning: () => (0, listener_process_js_1.runningListenerPid)() !== null,
     promptKinds: () => (0, schedule_ready_js_1.promptableScheduleKinds)(remote_agents_js_1.REMOTE_AGENTS.map((a) => a.kind)),
+    refreshListener: async () => {
+        await (0, exports.onStderr)(() => (0, wrapper_js_1.ensureListenerRunning)(false));
+        return (0, listener_process_js_1.runningListenerPid)() === null || !(0, wrapper_js_1.listenerVersionDrifted)((0, listener_process_js_1.runningListenerVersion)(), config_js_1.VERSION);
+    },
     out: (line) => console.log(line),
     err: (line) => console.error(line),
 });

package/dist/schedule-launch.d.ts

@@ -2,7 +2,8 @@
  * Runs `hwip <agent> --detach …` for a scheduled session, as a child of the listener (F8). The child gets the schedule's
  * directory as its cwd and none of the project-dir env vars, so it resolves its project from that directory and not from
  * whatever shell once started the listener; and it is told it is the listener's own, so it does not "repair" the listener
- * that is running it (see `LISTENER_LAUNCH_ENV`).
+ * that is running it (see `LISTENER_LAUNCH_ENV`). Its PATH also gets the directories the person's shell found agents in
+ * (agent-dirs.ts): the service's own PATH has none of them.
  */
 import { execFile as nodeExecFile } from 'child_process';
 import type { LaunchResult } from './schedule-runner.js';
@@ -10,6 +11,7 @@ export interface LaunchDeps {
     execFile?: typeof nodeExecFile;
     cliPath?: () => string | null;
     env?: NodeJS.ProcessEnv;
+    agentPath?: (path: string | undefined) => string;
 }
 export declare const launchHwip: (argv: string[], cwd: string, timeoutMs: number, deps?: LaunchDeps) => Promise<LaunchResult>;
 //# sourceMappingURL=schedule-launch.d.ts.map

package/dist/schedule-launch.js

@@ -3,11 +3,13 @@
  * Runs `hwip <agent> --detach …` for a scheduled session, as a child of the listener (F8). The child gets the schedule's
  * directory as its cwd and none of the project-dir env vars, so it resolves its project from that directory and not from
  * whatever shell once started the listener; and it is told it is the listener's own, so it does not "repair" the listener
- * that is running it (see `LISTENER_LAUNCH_ENV`).
+ * that is running it (see `LISTENER_LAUNCH_ENV`). Its PATH also gets the directories the person's shell found agents in
+ * (agent-dirs.ts): the service's own PATH has none of them.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.launchHwip = void 0;
 const child_process_1 = require("child_process");
+const agent_dirs_js_1 = require("./agent-dirs.js");
 const config_js_1 = require("./config.js");
 const listener_process_js_1 = require("./listener-process.js");
 const launchHwip = (argv, cwd, timeoutMs, deps = {}) => new Promise((resolve) => {
@@ -17,6 +19,7 @@ const launchHwip = (argv, cwd, timeoutMs, deps = {}) => new Promise((resolve) =>
     const env = { ...(deps.env ?? process.env), [listener_process_js_1.LISTENER_LAUNCH_ENV]: '1' };
     for (const key of config_js_1.PROJECT_DIR_ENV_VARS)
         delete env[key];
+    env.PATH = (deps.agentPath ?? agent_dirs_js_1.withAgentDirs)(env.PATH);
     (deps.execFile ?? child_process_1.execFile)(process.execPath, [cliPath, ...argv], { cwd, env, encoding: 'utf-8', timeout: timeoutMs }, (err, _stdout, stderr) => {
         resolve(err ? { ok: false, error: stderr || err.message } : { ok: true });
     });

package/dist/schedule-remote.d.ts

@@ -15,6 +15,11 @@ export interface PhoneScheduleItem {
     session: string;
     when: ScheduleWhen;
     prompt?: string;
+    /**
+     * The phone cannot change the prompt: what is here is not all of it (cut, or left out for room), or the schedule has
+     * agent arguments the computer gave. The app shows it and leaves it to `hwip schedule edit`.
+     */
+    promptLocked?: true;
     maxRuntimeMin: number;
     /** ISO time of the next run; null when there is none. */
     nextAt: string | null;
@@ -70,7 +75,8 @@ export interface PhoneScheduleDeps {
 export declare const livePhoneScheduleDeps: PhoneScheduleDeps;
 /**
  * Carry out one change the phone asked for: `{ op: 'create', when, prompt, agentKind?, maxRuntimeMin? }` for the
- * recorded session `session`, or `{ op: 'remove', id }` for the schedule whose session that is. Nothing here
+ * recorded session `session`, `{ op: 'update', id, when?, prompt?, maxRuntimeMin? }` or `{ op: 'remove', id }` for the
+ * schedule whose session that is. Nothing here
  * types into a session. `request` is whatever the phone sealed, so every field is checked as it is used.
  */
 export declare const applyPhoneSchedule: (request: unknown, session: string, deps?: PhoneScheduleDeps) => PhoneScheduleResult;

package/dist/schedule-remote.js

@@ -25,6 +25,12 @@ const clip = (text, max) => {
     const last = cut.charCodeAt(cut.length - 1);
     return `${last >= 0xd800 && last <= 0xdbff ? cut.slice(0, -1) : cut}…`;
 };
+const listedPrompt = (schedule, max) => {
+    const { prompt } = schedule;
+    const listed = prompt !== undefined && max > 0 ? clip(prompt, max) : undefined;
+    const locked = listed !== prompt || schedule.agentArgs !== undefined;
+    return { ...(listed === undefined ? {} : { prompt: listed }), ...(locked ? { promptLocked: true } : {}) };
+};
 const isoOrNull = (ms) => {
     if (ms === null)
         return null;
@@ -47,9 +53,9 @@ const phoneScheduleList = (now, promptChars = exports.LIST_PROMPT_CHARS) => {
             project: (0, node_path_1.basename)(schedule.cwd),
             session: schedule.session,
             when: schedule.when,
-            ...(schedule.prompt !== undefined && promptChars > 0 ? { prompt: clip(schedule.prompt, promptChars) } : {}),
+            ...listedPrompt(schedule, promptChars),
             maxRuntimeMin: schedule.maxRuntimeMin,
-            nextAt: isoOrNull((0, schedule_js_1.nextOccurrence)(schedule.when, now, Date.parse(schedule.createdAt))),
+            nextAt: isoOrNull((0, schedule_js_1.nextOccurrence)(schedule.when, now, (0, schedule_js_1.scheduleAnchor)(schedule))),
             ...(last && lastAt ? { last: { outcome: last.outcome, at: lastAt } } : {}),
         };
     });
@@ -144,9 +150,48 @@ const remove = (request, session) => {
     const removed = (0, schedule_js_1.removeSchedule)(id);
     return removed === 'invalid' ? refuse('schedule_invalid', 'not a schedule id') : { ok: true };
 };
+const UPDATE_KEYS = new Set(['op', 'id', 'when', 'prompt', 'maxRuntimeMin']);
+const update = (request, session, deps) => {
+    const extra = Object.keys(request).find((k) => !UPDATE_KEYS.has(k));
+    if (extra !== undefined)
+        return refuse('schedule_invalid', `an update carries ${extra}`);
+    const { id, when, prompt, maxRuntimeMin } = request;
+    if (typeof id !== 'string')
+        return refuse('schedule_invalid', 'an update needs an id');
+    const read = (0, schedule_js_1.listSchedules)();
+    if (read.incomplete)
+        return refuse('schedule_failed', 'the schedules could not be listed');
+    // As for a remove: the push names the schedule's own session, so it cannot change another one.
+    const target = read.schedules.find((schedule) => schedule.id === id);
+    if (!target || target.session !== session)
+        return refuse('schedule_invalid', 'no such schedule for that session');
+    // A prompt the list cut is left out by the app, so a missing one keeps the file's whole text.
+    // Arguments the computer gave (a permissions bypass, say) were chosen for its own prompt: the phone cannot put another under them.
+    if (prompt !== undefined && target.agentArgs !== undefined)
+        return refuse('schedule_invalid', 'a schedule with agent arguments takes its prompt from hwip schedule edit');
+    // As `hwip schedule edit`: a prompt of spaces would be typed as nothing.
+    if (typeof prompt === 'string' && prompt.trim() === '')
+        return refuse('schedule_invalid', 'the prompt is empty');
+    if (prompt !== undefined && !deps.canPrompt(target.agentKind))
+        return refuse('schedule_invalid', 'that agent cannot take a scheduled prompt');
+    // Unchecked here: `updateSchedule` validates the whole schedule they make before it writes.
+    const change = {};
+    if (when !== undefined)
+        change.when = when;
+    if (prompt !== undefined)
+        change.prompt = prompt;
+    if (maxRuntimeMin !== undefined)
+        change.maxRuntimeMin = maxRuntimeMin;
+    const updated = (0, schedule_js_1.updateSchedule)(id, change, deps.now());
+    if (updated.ok)
+        return { ok: true };
+    // Gone between the list and the write is the same as never there for this session.
+    return refuse(updated.failure === 'io' ? 'schedule_failed' : 'schedule_invalid', updated.error);
+};
 /**
  * Carry out one change the phone asked for: `{ op: 'create', when, prompt, agentKind?, maxRuntimeMin? }` for the
- * recorded session `session`, or `{ op: 'remove', id }` for the schedule whose session that is. Nothing here
+ * recorded session `session`, `{ op: 'update', id, when?, prompt?, maxRuntimeMin? }` or `{ op: 'remove', id }` for the
+ * schedule whose session that is. Nothing here
  * types into a session. `request` is whatever the phone sealed, so every field is checked as it is used.
  */
 const applyPhoneSchedule = (request, session, deps = exports.livePhoneScheduleDeps) => {
@@ -155,6 +200,8 @@ const applyPhoneSchedule = (request, session, deps = exports.livePhoneScheduleDe
     try {
         if (request.op === 'create')
             return create(request, session, deps);
+        if (request.op === 'update')
+            return update(request, session, deps);
         if (request.op === 'remove')
             return remove(request, session);
     }
@@ -162,6 +209,6 @@ const applyPhoneSchedule = (request, session, deps = exports.livePhoneScheduleDe
         // A file that would not read or write is this machine's trouble, not a mistake in the request.
         return refuse('schedule_failed', err instanceof Error ? err.message : String(err));
     }
-    return refuse('schedule_invalid', 'op is neither create nor remove');
+    return refuse('schedule_invalid', 'op is not create, update or remove');
 };
 exports.applyPhoneSchedule = applyPhoneSchedule;

package/dist/schedule-runner.js

@@ -142,7 +142,10 @@ const createScheduleRunner = (deps) => {
         for (const schedule of schedules) {
             // No record of a schedule in a damaged file may mean "nothing ran" or "the record was lost": start from now, so
             // neither a pile of old runs is counted as missed nor a run that already happened is started again.
-            state[schedule.id] = previous[schedule.id] ?? { cursor: file.damaged ? tickNow : Date.parse(schedule.createdAt) };
+            // An edit restarts the count: the times before it belong to the schedule as it was.
+            const prior = previous[schedule.id];
+            const anchor = (0, schedule_js_1.scheduleAnchor)(schedule);
+            state[schedule.id] = { ...prior, cursor: Math.max(prior?.cursor ?? (file.damaged ? tickNow : anchor), anchor) };
         }
         // A state entry whose schedule file is gone is dropped — but only when the list is whole: a file that could not be
         // read this time is still there, and losing its cursor would repeat or miscount runs. A session that ended on its own is no longer running.
@@ -206,7 +209,7 @@ const createScheduleRunner = (deps) => {
         for (const schedule of schedules) {
             const st = state[schedule.id];
             const now = tickNow + (clock() - tickStart);
-            const due = (0, schedule_js_1.occurrencesBetween)(schedule.when, st.cursor, now, Date.parse(schedule.createdAt));
+            const due = (0, schedule_js_1.occurrencesBetween)(schedule.when, st.cursor, now, (0, schedule_js_1.scheduleAnchor)(schedule));
             if (due.count === 0 || due.latest === null)
                 continue;
             const runs = now - due.latest <= exports.GRACE_MS;