waterplane 0.0.1 → 0.1.6

package/packages/host/dist/transcript/transcriptlog.js

@@ -0,0 +1,300 @@
+/** The CLI log's location, freshness and record predicates. Moved from transcript.ts. */
+import { closeSync, openSync, readSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { LABEL_CAP, isConversationId } from "@waterplane/shared";
+import { claudeProjectDir } from "../claudeconfig.js";
+/** Parse at most this much of the log (tail-read beyond it). Transcripts of a
+ *  long day reach tens of MB; this keeps a fetch bounded. */
+export const MAX_READ = 24 * 1024 * 1024;
+export function transcriptPath(cwd, claudeSessionId) {
+    // A non-id (`../../x`) never becomes a path: the join would leave the project
+    // dir. The returned path simply does not exist, so every reader (stat, read,
+    // tail) degrades to "no log" instead of throwing.
+    if (!isConversationId(claudeSessionId))
+        return join(claudeProjectDir(cwd), "invalid-conversation-id.jsonl");
+    return join(claudeProjectDir(cwd), claudeSessionId + ".jsonl");
+}
+/** Last-modified time of a conversation log, or null if it isn't there. Lets a
+ *  polling client be answered from a stat instead of re-parsing tens of MB. */
+export function logMtime(path) {
+    try {
+        return statSync(path).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * When this conversation last carried a real TURN — the newest `user` or
+ * `assistant` record in the log's tail.
+ *
+ * Deliberately not the file's mtime. The CLI rewrites its own bookkeeping rows
+ * (`mode`, `permission-mode`, `last-prompt`, `atis-latch`, `bridge-session`)
+ * whenever a client attaches, and a `npm run restart` re-attaches every tmux
+ * session at once — so mtime moves on a hundred conversations that did no work.
+ * Measured on this host: of 97 live sessions, 92 had an mtime under an hour old
+ * and a last real turn 87 to 143 HOURS old. The whole point of this field is to
+ * answer "has anything happened here since yesterday", and mtime answers "did
+ * anything open the file", which after a restart is always yes.
+ *
+ * Bounded tail read, memoized on the file's own identity, so the common case is
+ * a `stat`: this is asked once per session per settle, with a hundred sessions
+ * live. Null when the tail holds no message record at all — absent, never a
+ * guess, and callers fall back to what they had before.
+ */
+export const turnAtCache = new Map();
+export const TURN_TAIL = 256 * 1024;
+/**
+ * Cap on the memo, because nothing else ever emptied it: an entry was added per
+ * PATH this process asked about and none was ever dropped, so a long-lived
+ * daemon accumulated one per conversation it had ever touched — sessions closed
+ * weeks ago included. 512 is several boots' worth against the 107 live sessions
+ * measured on this host, i.e. it never evicts anything the steady state is
+ * actually re-asking for. Delete-and-reinsert on a hit makes Map insertion order
+ * an approximate LRU, which is all that is wanted here: the entries are tiny and
+ * a miss costs one bounded tail read.
+ */
+export const TURN_CACHE_MAX = 512;
+export function lastTurnAt(path) {
+    let st;
+    try {
+        st = statSync(path);
+    }
+    catch {
+        return null;
+    }
+    const key = `${st.size}:${st.mtimeMs}`;
+    const hit = turnAtCache.get(path);
+    if (hit && hit.key === key) {
+        turnAtCache.delete(path);
+        turnAtCache.set(path, hit);
+        return hit.at;
+    }
+    let at = null;
+    try {
+        const len = Math.min(TURN_TAIL, st.size);
+        const buf = Buffer.alloc(len);
+        const fd = openSync(path, "r");
+        try {
+            readSync(fd, buf, 0, len, st.size - len);
+        }
+        finally {
+            closeSync(fd);
+        }
+        for (const line of buf.toString("utf8").split("\n")) {
+            if (!line.trim())
+                continue;
+            let r;
+            try {
+                r = JSON.parse(line);
+            }
+            catch {
+                continue;
+            } // a half-written head line
+            if (r.type !== "assistant" && r.type !== "user")
+                continue;
+            if (!r.timestamp)
+                continue;
+            const t = Date.parse(r.timestamp);
+            if (Number.isFinite(t) && (at === null || t > at))
+                at = t;
+        }
+    }
+    catch {
+        at = null;
+    }
+    turnAtCache.delete(path);
+    turnAtCache.set(path, { key, at });
+    if (turnAtCache.size > TURN_CACHE_MAX) {
+        const oldest = turnAtCache.keys().next().value;
+        if (oldest !== undefined)
+            turnAtCache.delete(oldest);
+    }
+    return at;
+}
+/** Read the (tail of the) log. Returns null when it isn't there yet. */
+export function readLog(path) {
+    let st;
+    try {
+        st = statSync(path);
+    }
+    catch {
+        return null;
+    }
+    const start = Math.max(0, st.size - MAX_READ);
+    const len = st.size - start;
+    const buf = Buffer.allocUnsafe(len);
+    const fd = openSync(path, "r");
+    try {
+        readSync(fd, buf, 0, len, start);
+    }
+    finally {
+        closeSync(fd);
+    }
+    const lines = buf.toString("utf8").split("\n");
+    if (start > 0)
+        lines.shift(); // first line of a tail-read is usually half a record
+    return { lines, bytes: st.size, partial: start > 0, mtime: st.mtimeMs };
+}
+/** Text of a content part, whatever shape it takes. */
+function partText(p) {
+    if (typeof p === "string")
+        return p;
+    if (!p || typeof p !== "object")
+        return "";
+    if (typeof p.text === "string")
+        return p.text;
+    if (typeof p.thinking === "string")
+        return p.thinking;
+    if (p.type === "image")
+        return "[image]";
+    return "";
+}
+/** Flatten a tool_result's `content` (string, or an array of text parts). */
+export function resultText(c) {
+    if (typeof c === "string")
+        return c;
+    if (Array.isArray(c))
+        return c.map(partText).filter(Boolean).join("\n");
+    if (c && typeof c === "object")
+        return partText(c);
+    return "";
+}
+/**
+ * Prompt records the user never typed: hook output, slash-command plumbing,
+ * task notifications, the CLI's own caveats. They'd each open a bogus turn.
+ */
+function isSyntheticPrompt(text) {
+    const t = text.trimStart();
+    if (!t)
+        return true;
+    return /^<(command-name|command-message|command-args|local-command-stdout|local-command-stderr|task-notification|agent-message|system-reminder|user-prompt-submit-hook|bash-input|bash-stdout|bash-stderr)[\s>]/.test(t)
+        || t.startsWith("Caveat: The messages below were generated");
+}
+/**
+ * The LOCAL COMMAND a raw user record carries — `/goal`, `/context`, `/help`.
+ *
+ * The CLI writes these as an envelope of plumbing tags rather than as a prompt,
+ * which is exactly why `isSyntheticPrompt` drops them: they must not open a
+ * model turn and they must not title an archive row. But dropping them also
+ * deleted them from the reader, and a command somebody typed — with its answer
+ * printed under it — is a thing that happened in the conversation. So they are
+ * recognised here and given a turn of their own (`local: "log"`), which is a
+ * different claim from a prompt and is labelled as one.
+ *
+ * Returns the command as a person typed it. Null for anything else, including
+ * a record whose args are missing — a bare `<command-name>` is still a command.
+ */
+export function localCommandOf(rec) {
+    if (rec?.type !== "user" || rec?.isSidechain || rec?.isMeta)
+        return null;
+    const content = rec?.message?.content;
+    const parts = Array.isArray(content) ? content : content == null ? [] : [{ type: "text", text: String(content) }];
+    if (parts.some((p) => p?.type === "tool_result"))
+        return null;
+    const text = parts.map(partText).filter(Boolean).join("\n");
+    const name = /^\s*<command-name>([^<]*)<\/command-name>/.exec(text)?.[1]?.trim();
+    if (!name)
+        return null;
+    const args = /<command-args>([\s\S]*?)<\/command-args>/.exec(text)?.[1]?.trim() ?? "";
+    const slashed = name.startsWith("/") ? name : `/${name}`;
+    return (args ? `${slashed} ${args}` : slashed).slice(0, LABEL_CAP * 8);
+}
+/**
+ * The OUTPUT a local command printed, out of the record that follows its
+ * envelope. `stderr` counts: a command that failed said so there, and hiding it
+ * would leave a turn that reads as if the command did nothing.
+ */
+export function localOutputOf(rec) {
+    if (rec?.type !== "user" || rec?.isSidechain)
+        return null;
+    const content = rec?.message?.content;
+    const parts = Array.isArray(content) ? content : content == null ? [] : [{ type: "text", text: String(content) }];
+    const text = parts.map(partText).filter(Boolean).join("\n");
+    const m = /^\s*<local-command-(?:stdout|stderr)>([\s\S]*?)<\/local-command-(?:stdout|stderr)>/.exec(text);
+    if (!m)
+        return null;
+    return m[1].trim();
+}
+/**
+ * The user PROMPT a raw log record carries, or null when it is not one — a tool
+ * result, a hook echo, a slash-command envelope, the resume caveat. Exported
+ * because `archive.ts` titles a conversation by its first prompt and the reader
+ * opens a turn on the same records: two copies of this rule would drift, and the
+ * visible symptom would be an archive row labelled `<command-name>`.
+ */
+export function promptOf(rec) {
+    if (rec?.type !== "user" || rec?.isSidechain || rec?.isMeta)
+        return null;
+    const content = rec?.message?.content;
+    const parts = Array.isArray(content) ? content : content == null ? [] : [{ type: "text", text: String(content) }];
+    if (parts.some((p) => p?.type === "tool_result"))
+        return null;
+    const text = parts.map(partText).filter(Boolean).join("\n");
+    return isSyntheticPrompt(text) ? null : text;
+}
+/**
+ * **A prompt the CLI took mid-turn, out of the `attachment` record that is the
+ * only trace of it.**
+ *
+ * The TUI holds a prompt typed into a busy session. When the turn ends it
+ * normally starts it properly and the log gets a `user` record — which is what
+ * `promptOf` reads and what every turn in this parser is built on. But it may
+ * instead absorb the prompt into the turn already running, and then there is no
+ * `user` record ever: the words appear once, as
+ * `{"type":"attachment","attachment":{"type":"queued_command","prompt":…}}`,
+ * alongside `queue-operation` bookkeeping rows this parser has no use for.
+ *
+ * Measured across seven days of logs on this desktop: 48 of 62 real queued
+ * prompts (77%) were written that way and no other. Every one of them was
+ * invisible to the reader, its answer was folded into the previous prompt's
+ * turn, and `queuedTurns` — which retires a row by finding the log's own copy of
+ * the prompt — never found one, so waterplane's own "sent · the CLI has not started
+ * it yet" row stayed on screen for ever, sorted below the answer.
+ *
+ * The record's `timestamp` is when the person sent it, not when it was absorbed,
+ * which is what the row should say and what keeps it in time order against the
+ * prompt above it.
+ *
+ * Synthetic prompts are dropped here for `isSyntheticPrompt`'s reasons — 261 of
+ * the 348 queued rows in that sample were `<task-notification>` plumbing, which
+ * must no more open a turn from an attachment than it does from a `user` record.
+ */
+export function queuedPromptOf(rec) {
+    if (rec?.type !== "attachment" || rec?.isSidechain)
+        return null;
+    const a = rec?.attachment;
+    if (a?.type !== "queued_command")
+        return null;
+    const text = typeof a.prompt === "string" ? a.prompt : "";
+    return isSyntheticPrompt(text) ? null : text;
+}
+/**
+ * Does this raw record OPEN a turn?
+ *
+ * The same question `parseTranscript` asks record by record, exported so a
+ * COUNT of turns and the LIST of them cannot disagree — which is exactly what
+ * happened when the count was taken off the context series instead: that series
+ * has one reading per REQUEST, so a turn that ran thirteen tools contributed
+ * fourteen, and a four-turn conversation was labelled twenty-four.
+ *
+ * It is the two openers the parser has: a prompt somebody typed, and a local
+ * command (`/model`), which gets a turn of its own and is listed as one. A
+ * tool result, a hook echo and a command's own stdout open nothing.
+ *
+ * Two things the parser counts that this cannot see, both of which make a count
+ * built on it a FLOOR and are worded as one at the call site: the synthetic
+ * "(continued)" turn a resumed log's pre-prompt tail opens, and the screen-only
+ * turns `screenCommandTurns` splices in from what this host typed.
+ *
+ * `queuedPromptOf` is deliberately NOT a third opener here, though the parser
+ * opens a turn on it. Whether one of those attachments is a turn depends on
+ * whether the SAME words also reached the log as a `user` record — a question
+ * about the whole file, which a per-record predicate cannot ask. Counting it
+ * here would double-count every prompt the CLI did start properly, and this
+ * count's contract is that it is a floor.
+ */
+export function opensTurn(rec) {
+    return localCommandOf(rec) != null || promptOf(rec) != null;
+}
+//# sourceMappingURL=transcriptlog.js.map

package/packages/host/dist/transcript/transcriptlog.js.map

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

package/packages/host/dist/transcript/transcriptparse.d.ts

@@ -0,0 +1,28 @@
+import type { TranscriptDoc, TranscriptToolDetail } from "@waterplane/shared";
+export declare const ts: (v: unknown) => number | undefined;
+/**
+ * Parse a conversation log into turns. Returns null when the file is missing.
+ * `cwd` only makes paths relative in labels.
+ *
+ * `detail` decides whether tool inputs/results travel. They are the bulk of the
+ * document by a wide margin — a day's work is a handful of KB of prose and many
+ * MB of `git diff` output — and the phone is the one client that pays for every
+ * one of those bytes twice (once over a flaky tunnel, once in IndexedDB). So the
+ * default is `"lite"`: names, labels and ok/error stay, the two big strings are
+ * replaced by `omitted: true`, and the reader fetches a turn's pair on demand
+ * via `toolDetails()`. `"full"` is the old shape, unchanged.
+ */
+export declare function parseTranscript(path: string, cwd: string, detail?: "lite" | "full"): Omit<TranscriptDoc, "sessionId" | "source"> | null;
+/**
+ * The inputs/results a `lite` parse left out, for ONE turn, keyed by tool_use id.
+ *
+ * Keyed by turn id (the prompt record's uuid) rather than turn number because a
+ * number is a position in the read window: the log grows, the tail-read slides,
+ * and turn 7 is a different turn than it was a minute ago. The uuid is whatever
+ * the CLI wrote and never moves.
+ *
+ * Returns null when the log or the turn is gone — the reader says so rather than
+ * showing an empty box. Costs a full re-parse, which is why it is on demand:
+ * nobody expands every tool call in a conversation.
+ */
+export declare function toolDetails(path: string, cwd: string, turnId: string): Record<string, TranscriptToolDetail> | null;