waterplane 0.0.1 → 0.1.6

package/packages/host/dist/shelllinks.js.map

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

package/packages/host/dist/shells.d.ts

@@ -0,0 +1,190 @@
+import type { SessionShell, SessionShellDetail } from "@waterplane/shared";
+/** `WATERPLANE_SHELLS=0` turns the whole reader off — the list stays absent, same
+ *  as a `ps` that failed to run. */
+export declare function shellsEnabled(): boolean;
+/** A pathological session must not turn a status poll into a wall of rows. */
+export declare const MAX_SHELLS = 12;
+export interface PsRow {
+    pid: number;
+    ppid: number;
+    pgid: number;
+    /** Elapsed wall-clock time, in seconds — `ps`'s own `etime`. */
+    etimeSec: number;
+    /** Cumulative CPU time, in ms — `ps`'s own `time`. */
+    cpuMs: number;
+    command: string;
+}
+/** `[[dd-]hh:]mm:ss` → seconds. Undefined on anything that doesn't parse —
+ *  never a guessed age. */
+export declare function parseEtimeSec(raw: string): number | undefined;
+/** `mm:ss.cc` (arbitrary-width minutes, macOS's usual shape) or `hh:mm:ss` →
+ *  milliseconds. Undefined on anything that doesn't parse. */
+export declare function parseCpuMs(raw: string): number | undefined;
+/** Pure: fixture text in, rows out — this is what `shells.test.mjs` pins
+ *  against real `ps` output captured on this desktop. */
+export declare function parsePsTable(text: string): PsRow[];
+/** `fresh: true` bypasses the 2s memo — `killShellGroup` must never act on a
+ *  stale reading of who is still alive. Blocking (~50 ms measured): that is
+ *  the point for a reading that must precede a kill, and wrong for a poll —
+ *  the pollers use `readPsTableAsync`. */
+export declare function readPsTable(fresh?: boolean): PsRow[];
+/**
+ * The same table without blocking the event loop that pumps every PTY — for the
+ * pollers (`checkAgents` runs per shell/busy session every `AGENT_POLL_MS`).
+ * Shares `readPsTable`'s memo and parse, so either reader warms the other.
+ * `fresh: true` is accepted for symmetry, but a reading that PRECEDES A KILL
+ * stays on the sync `readPsTable(true)` (`killShellGroup`, `stopShellsUnder`).
+ * `run` is the text source, injectable so a test needs no real `ps`.
+ */
+export declare function readPsTableAsync(fresh?: boolean, run?: () => Promise<string>): Promise<PsRow[]>;
+/** `ppid === cliPid && pgid !== cliPid && the CLI's own shell-wrapper shape`
+ *  — see the module doc for why `pgid !== cliPid` alone keeps out MCP
+ *  servers and `caffeinate`, which are CLI children too but share its pgid. */
+export declare function isShellWrapper(row: PsRow, cliPid: number): boolean;
+export interface ShellGroup {
+    wrapper: PsRow;
+    /** Every live descendant, transitively, staying inside the wrapper's own
+     *  pgid — a child that escaped into a pgid of its own is not followed. */
+    members: PsRow[];
+    /** `members` minus the sleep/pipeline utilities — the real workers. */
+    workers: PsRow[];
+}
+/** One group per wrapper shell found under `cliPid`. */
+export declare function shellsUnder(cliPid: number, rows: PsRow[]): ShellGroup[];
+/**
+ * The text between `&& eval '` and `' < /dev/null`, unescaped and capped at
+ * 240 characters — `SessionShell.command`. Undefined when the wrapper's own
+ * command line does not have that shape (a `ps` truncation, a CLI version
+ * that wraps differently), in which case the caller falls back to the raw
+ * command capped the same way.
+ */
+export declare function evalText(command: string): string | undefined;
+/** `evalText` uncapped — `readShellDetail`, the one reader asked for the
+ *  whole command by a person rather than shipped on every `SessionInfo`. */
+export declare function evalTextFull(command: string): string | undefined;
+interface CpuTrack {
+    cpuMs: number;
+    movedAt?: number;
+}
+/**
+ * Record this poll's aggregate `cpuMs` for `pid` (the wrapper's own pid — the
+ * stable identity across the whole group's churn of short-lived workers) and
+ * answer `movedAt`: `undefined` on the FIRST ever reading of this pid (there
+ * is nothing yet to compare against — the honest "can't tell yet"), the
+ * previous `movedAt` unchanged when the reading repeats, `now` when it moved.
+ */
+export declare function trackCpu(map: Map<number, CpuTrack>, pid: number, cpuMs: number, now: number): number | undefined;
+/** Drop tracked pids that are no longer wrapper shells anywhere — otherwise
+ *  the map grows for as long as the host runs. */
+export declare function pruneCpuTrack(map: Map<number, CpuTrack>, livePids: Set<number>): void;
+export interface ShellTranscriptFact {
+    command: string;
+    description?: string;
+    taskId: string;
+    launch: "background" | "timeout";
+}
+/**
+ * Every backgrounded Bash call this tail of the conversation log can prove,
+ * by matching each `tool_use`'s own `tool_use_id` to its `tool_result` — the
+ * CLI's own pairing, not a guess. A tool_result whose text names neither
+ * pattern is not a background command and is dropped.
+ */
+export declare function shellTranscriptFacts(tail: string): ShellTranscriptFact[];
+/** The fact whose (whitespace-normalised, 240-capped) command matches this
+ *  shell's own eval'd text — the join key, since nothing else ties a `ps` pid
+ *  to a transcript record. */
+export declare function joinShellFact(evalCommand: string, facts: ShellTranscriptFact[]): ShellTranscriptFact | undefined;
+/** Where the CLI writes a background task's output. Every part comes from the
+ *  host's own reads (cwd, the conversation id, the transcript join's taskId),
+ *  never from a client. */
+export declare function shellOutputPath(cwd: string, conversationId: string, taskId: string): string | undefined;
+/** `/private/tmp/claude-<uid>/<slug>/<conv>/tasks/<taskId>.output`, stat'd
+ *  only — never read. `undefined` on anything that doesn't resolve or isn't
+ *  there, and the size is only ever reported past 0 bytes: most of these
+ *  commands redirect their own output, so a 0-byte file is silence by
+ *  design, never "read and found empty". */
+export declare function shellOutputStat(cwd: string, conversationId: string, taskId: string): {
+    outputAt: number;
+    outputBytes: number;
+} | undefined;
+/**
+ * Every background shell running under `cliPid`, or `undefined` when the
+ * process table could not be read at all (`WATERPLANE_SHELLS=0`, or a throw) — kept
+ * apart from `[]`, which means the read succeeded and there are none.
+ *
+ * `cliStatus` is the CLI's own record status (`readCliRecord`'s `"shell"` or
+ * `"busy"` — the only two this is ever called under) and is what tells a
+ * background shell from the running turn's OWN foreground command: a live
+ * FOREGROUND Bash call has the exact same `ps` shape as a backgrounded one
+ * (`isShellWrapper` cannot tell them apart on its own), so a wrapper is only
+ * read as background when the conversation-log join PROVES it (a `launch`
+ * fact) or the main loop is idle (`"shell"` — nothing under an idle main loop
+ * can be the current turn, so every wrapper left is a survivor). An unjoined
+ * wrapper while the CLI still says `"busy"` is marked `foreground: true`
+ * instead.
+ */
+export declare function readShellList(cliPid: number, cwd: string, claudeSessionId: string | undefined, cliStatus: string | null, now?: number, 
+/** A table the caller already read (`readPsTableAsync`) — a poller hands it in
+ *  so this function does not block the loop on its own `ps`. */
+psRows?: PsRow[]): SessionShell[] | undefined;
+/** How much of a shell's output file one open reads — the tail, since what a
+ *  person opening a running shell wants is what it is printing NOW. */
+export declare const SHELL_OUTPUT_TAIL: number;
+/** A progress bar redraws its line with `\r`; keep what the line finally
+ *  said, the way a terminal would show it, then drop the escapes. */
+export declare function cleanShellOutput(raw: string): string;
+/**
+ * The whole command and the tail of the output for ONE background shell of
+ * this CLI — `GET /api/shell`. `null` when `pid` is not, right now, one of
+ * this CLI's wrapper shells: the pid is the client's, so it only ever selects
+ * among `shellsUnder(cliPid)`, never names an arbitrary process. The output
+ * file's path is built from the transcript join, never from the request.
+ */
+export declare function readShellDetail(cliPid: number, cwd: string, claudeSessionId: string | undefined, pid: number): SessionShellDetail | null;
+/**
+ * Which of `cliPid`'s wrapper shells are the running turn's OWN command
+ * (`foreground`), off an already-read `rows` table — the same discriminator
+ * `readShellList` applies per row, without the CPU tracking, output stat or
+ * `MAX_SHELLS` cap a KILL pass has no use for. Used by `drive.ts`'s
+ * `stopShellsUnder` so a session close never signals the turn's own command.
+ */
+export declare function foregroundWrapperPids(cliPid: number, rows: PsRow[], cwd: string, claudeSessionId: string | undefined, cliStatus: string | null): Set<number>;
+/** Injectable seams — real `ps`/`kill`/`sleep` by default, swapped out by
+ *  `shells.test.mjs` to drive the whole refusal ladder (ppid mismatch,
+ *  pgid !== pid, startedAt drift, already gone, a survivor) with no real OS
+ *  process tree, and by `stopShellsUnder` to share ONE fresh precondition
+ *  read across a whole close pass instead of one per group. */
+export interface KillShellDeps {
+    /** The precondition table — defaults to a fresh `readPsTable(true)` read.
+     *  The checks AFTER signalling always read fresh again on their own: they
+     *  happen at a different real moment than this one, and per group, so
+     *  sharing THIS table only removes the redundant read every group used to
+     *  take before it had even sent a signal. */
+    rows?: PsRow[];
+    readPs?: () => PsRow[];
+    kill?: (pid: number, signal: NodeJS.Signals) => void;
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Stop one shell's WHOLE process group — SIGTERM, then SIGKILL after 3s for
+ * whatever in the group is still alive (CLAUDE.md's decision: closing stops
+ * shells fully, and so does a per-row stop).
+ *
+ * The precondition read is a FRESH process table (never the 2s memo — acting
+ * on a stale "still there" is exactly the failure the memo exists to risk
+ * elsewhere) unless the caller already took one this pass (`deps.rows`), and
+ * every precondition is checked against it: the pid must still be a wrapper
+ * directly under THIS cli, still be its own group leader, and its start time
+ * must still be within 2s of the one the caller last saw — a pid the OS
+ * recycled onto an unrelated process is refused, not signalled. The SAME
+ * ppid check is repeated right before the SIGKILL, over a row read AFTER the
+ * SIGTERM, for the same reason — a recycled pid must not be signalled just
+ * because an unrelated new process happens to now share the old pgid. And the
+ * verdict is never a guess: a final fresh read says whether the group is
+ * actually gone, and a survivor comes back `ok: false`, never `true`.
+ */
+export declare function killShellGroup(cliPid: number, pid: number, startedAt: number, now?: number, deps?: KillShellDeps): Promise<{
+    ok: boolean;
+    reason?: string;
+}>;
+export {};