waterplane 0.0.1 → 0.1.6

package/node_modules/@waterplane/shared/dist/dictateterms.js

@@ -0,0 +1,180 @@
+/**
+ * Dictation vocabulary: words the person uses a lot that the transcriber does
+ * not know — an app called `BA3`, a repo name, a product name.
+ *
+ * ── Two levers, both on the person's own list ───────────────────────────────
+ *
+ * 1. **The prompt.** whisper.cpp takes an initial prompt (`--prompt`) and
+ *    conditions its decoding on it, so a term that appears there is far more
+ *    likely to be SPELLED the way it appears there. That is the lever that
+ *    moves recognition itself, and it is the reason the list lives on the phone
+ *    and travels with every clip: the host has no other way to know it.
+ * 2. **The corrections.** A prompt biases, it does not guarantee. So each term
+ *    may also say what it keeps coming back as (`BA3: bee a three, be a 3`),
+ *    and those are replaced after the fact. Without any, a term is still
+ *    rejoined when it arrives SPLIT (`BA 3`, `B.A.3`, `B-A-3`) and re-cased
+ *    when it is an identifier (`ba3` → `BA3`) — the two shapes a short
+ *    identifier reliably comes back in.
+ *
+ * The re-casing is the one rule that could touch an ordinary word, so it is
+ * limited to terms that cannot be one: three characters or more, with a digit
+ * or a capital past the first letter. `Go` or `Tiptoi` is never forced onto a
+ * sentence that happened to say "go"; `NASA`, `BA3` and `iPhone` are.
+ *
+ * Nothing here decides anything: the words land in the box the person is
+ * editing, same as before, and they read them before anything is sent.
+ *
+ * ── The list, as written ────────────────────────────────────────────────────
+ *
+ * One term per line, optionally followed by a colon and what it is misheard
+ * as, comma-separated. `#` starts a comment line. Parsed by ONE function on
+ * both ends — the phone to say how many terms it has, the host to use them —
+ * so the two can never count a line differently.
+ */
+import { BRAND } from "./brand.js";
+/** Terms kept. whisper's prompt is capped at half its text context (~224
+ *  tokens), so a longer list would be cut by the transcriber, not by us —
+ *  silently. Cut here, where the Settings row can say so. */
+export const DICTATE_TERMS_MAX = 60;
+/** One term or one alias, in characters. A "term" longer than this is a
+ *  sentence, and a sentence in the prompt steers style, not spelling. */
+export const DICTATE_TERM_MAX_CHARS = 40;
+/** Aliases per term. */
+export const DICTATE_HEARD_MAX = 8;
+/** The prompt handed to whisper, in characters — well inside its token cap. */
+export const DICTATE_PROMPT_MAX_CHARS = 600;
+const clean = (s) => s.replace(/\s+/g, " ").trim().slice(0, DICTATE_TERM_MAX_CHARS).trim();
+/** The product's own names, which every list starts out knowing. */
+export function brandDictateTerms() {
+    return BRAND.dictationTerms.map((term) => ({ term, heard: [] }));
+}
+/** The list as written in Settings → the entries, deduplicated by term
+ *  (case-insensitive, the later line's aliases added to the first) and capped. */
+export function parseDictateTerms(text) {
+    const out = [];
+    const byKey = new Map();
+    for (const raw of String(text || "").split(/\r?\n/)) {
+        const line = raw.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const colon = line.indexOf(":");
+        const term = clean(colon < 0 ? line : line.slice(0, colon));
+        if (!term)
+            continue;
+        const heard = colon < 0 ? [] : line.slice(colon + 1).split(",").map(clean).filter(Boolean);
+        const key = term.toLowerCase();
+        let entry = byKey.get(key);
+        if (!entry) {
+            if (out.length >= DICTATE_TERMS_MAX)
+                continue;
+            entry = { term, heard: [] };
+            byKey.set(key, entry);
+            out.push(entry);
+        }
+        for (const h of heard) {
+            if (entry.heard.length >= DICTATE_HEARD_MAX)
+                break;
+            if (h.toLowerCase() === key)
+                continue;
+            if (!entry.heard.some((x) => x.toLowerCase() === h.toLowerCase()))
+                entry.heard.push(h);
+        }
+    }
+    return out;
+}
+/** How many non-comment lines the list has, against what `parseDictateTerms`
+ *  kept — so the Settings row can say "60 of 64 kept" instead of dropping four
+ *  in silence. */
+export function dictateTermsDropped(text) {
+    const lines = String(text || "").split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
+    const distinct = new Set(lines.map((l) => clean(l.split(":")[0]).toLowerCase()).filter(Boolean));
+    return Math.max(0, distinct.size - parseDictateTerms(text).length);
+}
+/** The canonical text of a parsed list — what the phone SENDS, so the query
+ *  string carries no comments and no blank lines. Round-trips through
+ *  `parseDictateTerms` unchanged. */
+export function serializeDictateTerms(terms) {
+    return terms.map((t) => (t.heard.length ? `${t.term}: ${t.heard.join(", ")}` : t.term)).join("\n");
+}
+/**
+ * The initial prompt for whisper: the terms, comma-separated, and nothing
+ * else. Deliberately no lead-in like "Glossary:" — a prompt is also read as
+ * the text that came BEFORE the clip, and an English word there nudges the
+ * language detection and the style of a German dictation.
+ *
+ * A list of ONE is said twice. Measured (large-v3-turbo, a clip saying
+ * "kwixel"): a prompt of `Kwixel.` alone changed nothing — "Quixel" both
+ * times — while `Kwixel, Kwixel.` and `BA3, Kwixel.` both spelled it the
+ * person's way, and neither changed a German clip in the same run.
+ */
+export function dictatePrompt(terms) {
+    if (terms.length === 1 && terms[0].term.length * 2 + 3 <= DICTATE_PROMPT_MAX_CHARS) {
+        return `${terms[0].term}, ${terms[0].term}.`;
+    }
+    let out = "";
+    for (const t of terms) {
+        const next = out ? `${out}, ${t.term}` : t.term;
+        if (next.length + 1 > DICTATE_PROMPT_MAX_CHARS)
+            break;
+        out = next;
+    }
+    return out ? `${out}.` : "";
+}
+const LETTERS = "\\p{L}\\p{N}";
+const escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/** A term whose casing is part of its identity: never an ordinary word. */
+function isIdentifier(term) {
+    return term.length >= 3 && /^\S+$/.test(term) && (/\p{N}/u.test(term) || /\p{Lu}/u.test(term.slice(1)));
+}
+/**
+ * The transcript with the person's terms put back.
+ *
+ * Longest pattern first, so `bee a three` wins over a shorter alias inside it.
+ * Matched on whole words only (letters and digits either side end a match), so
+ * a term is never rewritten out of the middle of a longer word.
+ */
+export function applyDictateTerms(text, terms) {
+    if (!text || !terms.length)
+        return text;
+    const rules = [];
+    for (const t of terms) {
+        for (const h of t.heard) {
+            const src = h.split(" ").map(escape).join("[\\s\\-]+");
+            rules.push({ re: new RegExp(`(?<![${LETTERS}])${src}(?![${LETTERS}])`, "giu"), term: t.term, keep: () => false, len: h.length });
+        }
+        // The term itself, arriving split or re-cased. Only single words: a
+        // multi-word term split on its own spaces is simply the term.
+        if (/^\S+$/.test(t.term) && t.term.length >= 2 && t.term.length <= 16) {
+            const chars = Array.from(t.term).map(escape);
+            const src = chars.join("[\\s.\\-]?");
+            const ident = isIdentifier(t.term);
+            rules.push({
+                re: new RegExp(`(?<![${LETTERS}])${src}(?![${LETTERS}])`, "giu"),
+                term: t.term,
+                // Unchanged, or only re-cased on a term that is an ordinary word: left.
+                keep: (m) => m === t.term || (!/[\s.\-]/.test(m) && !ident),
+                len: t.term.length,
+            });
+        }
+    }
+    rules.sort((a, b) => b.len - a.len);
+    let out = text;
+    for (const r of rules) {
+        out = out.replace(r.re, (m) => (r.keep(m) ? m : r.term));
+    }
+    return out;
+}
+const bare = (s) => s.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
+/**
+ * Whether a transcript is the prompt handed back.
+ *
+ * whisper, given a prompt and a clip with no speech in it, sometimes answers
+ * with the prompt — the same family of artifact as its subtitle boilerplate,
+ * and just as plausible-looking: a list of the person's own words. Refused as
+ * "no speech" rather than pasted into the box as if it had been said.
+ */
+export function isPromptEcho(text, terms) {
+    const prompt = bare(dictatePrompt(terms));
+    return !!prompt && bare(text) === prompt;
+}
+//# sourceMappingURL=dictateterms.js.map

package/node_modules/@waterplane/shared/dist/dictateterms.js.map

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

package/node_modules/@waterplane/shared/dist/envresolve.d.ts

@@ -0,0 +1,30 @@
+export type EnvSource = Readonly<Record<string, string | undefined>>;
+export interface EnvHit {
+    /** The value, or undefined when no name for the knob is set. */
+    value: string | undefined;
+    /** The name it was read from — the current name when nothing is set. */
+    name: string;
+    /** True when the value came from a legacy name. */
+    legacy: boolean;
+}
+/** Resolve `key` (no prefix: `"PORT"`) against `env`. An empty string counts as
+ *  set, exactly as `process.env.X` would read it. */
+export declare function resolveEnv(env: EnvSource, key: string): EnvHit;
+/** The sentence a legacy hit is reported with. `where` names the file that set
+ *  it, when anybody knows. */
+export declare function legacyEnvText(legacyName: string, key: string, where?: string): string;
+export interface EnvReader {
+    env(key: string): string | undefined;
+    envStr(key: string, dflt: string): string;
+    envBool(key: string, dflt: boolean): boolean;
+    envInt(key: string, dflt: number): number;
+}
+/**
+ * A reader over `source` that calls `warn` ONCE per legacy name it reads from.
+ * `where(name)` may say which file set a name, for the warning.
+ *
+ * `envBool`: an unset or empty knob, or one that is neither a true nor a false
+ * spelling, is the default. `envInt`: an unset, empty or non-integer value is
+ * the default — a typo in a knob degrades to the default, never to NaN.
+ */
+export declare function makeEnvReader(source: EnvSource, warn: (text: string) => void, where?: (name: string) => string | undefined): EnvReader;

package/node_modules/@waterplane/shared/dist/envresolve.js

@@ -0,0 +1,76 @@
+/**
+ * Which environment variable a knob is read from, across renames. Pure — the
+ * environment is a parameter, so a test hands it a plain object and the host
+ * hands it `process.env` (`host/src/env.ts`).
+ *
+ * The current name wins; then each legacy name, newest first. A legacy hit is
+ * REPORTED (once per name, by the reader) rather than refused: an old `.env`
+ * keeps working across a rename, and the person is told what to change.
+ */
+import { BRAND, LEGACY } from "./brand.js";
+/** Resolve `key` (no prefix: `"PORT"`) against `env`. An empty string counts as
+ *  set, exactly as `process.env.X` would read it. */
+export function resolveEnv(env, key) {
+    const current = `${BRAND.envPrefix}${key}`;
+    if (env[current] !== undefined)
+        return { value: env[current], name: current, legacy: false };
+    for (const l of LEGACY) {
+        const name = `${l.envPrefix}${key}`;
+        if (env[name] !== undefined)
+            return { value: env[name], name, legacy: true };
+    }
+    return { value: undefined, name: current, legacy: false };
+}
+/** The sentence a legacy hit is reported with. `where` names the file that set
+ *  it, when anybody knows. */
+export function legacyEnvText(legacyName, key, where) {
+    const from = where ? ` (set in ${where})` : "";
+    return `[${BRAND.slug}] ${legacyName} is a legacy name — rename it to ${BRAND.envPrefix}${key}${from}. It still works.`;
+}
+/** Truthy spellings, matching what the knobs have always accepted. */
+const TRUE = new Set(["1", "true", "yes", "on"]);
+const FALSE = new Set(["0", "false", "no", "off"]);
+/**
+ * A reader over `source` that calls `warn` ONCE per legacy name it reads from.
+ * `where(name)` may say which file set a name, for the warning.
+ *
+ * `envBool`: an unset or empty knob, or one that is neither a true nor a false
+ * spelling, is the default. `envInt`: an unset, empty or non-integer value is
+ * the default — a typo in a knob degrades to the default, never to NaN.
+ */
+export function makeEnvReader(source, warn, where) {
+    const warned = new Set();
+    const env = (key) => {
+        const hit = resolveEnv(source, key);
+        if (hit.legacy && !warned.has(hit.name)) {
+            warned.add(hit.name);
+            warn(legacyEnvText(hit.name, key, where?.(hit.name)));
+        }
+        return hit.value;
+    };
+    return {
+        env,
+        envStr: (key, dflt) => {
+            const v = env(key);
+            return v === undefined || v === "" ? dflt : v;
+        },
+        envBool: (key, dflt) => {
+            const v = env(key)?.trim().toLowerCase();
+            if (!v)
+                return dflt;
+            if (TRUE.has(v))
+                return true;
+            if (FALSE.has(v))
+                return false;
+            return dflt;
+        },
+        envInt: (key, dflt) => {
+            const v = env(key)?.trim();
+            if (!v || !/^[-+]?\d+$/.test(v))
+                return dflt;
+            const n = Number(v);
+            return Number.isSafeInteger(n) ? n : dflt;
+        },
+    };
+}
+//# sourceMappingURL=envresolve.js.map

package/node_modules/@waterplane/shared/dist/envresolve.js.map

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

package/node_modules/@waterplane/shared/dist/fanoutruns.d.ts

@@ -0,0 +1,25 @@
+/**
+ * **A sweep, rebuilt from the rows that make it up.**
+ *
+ * A fan-out used to be an in-memory ring host-side that died with the daemon —
+ * the run record, not the sessions, which is why a restart mid-sweep left twelve
+ * sessions and no account of what they were for. It is now N intents sharing a
+ * `groupId`, so the run is exactly as durable as everything else in the store
+ * and `finishedAt` is DERIVED: a run is over when nothing in its group is still
+ * going, which is also what makes a follow-up correctly reopen it.
+ *
+ * ── Why it is HERE and not in `host/intents/adapters.ts` ────────────────────
+ *
+ * It was there, and that was right while the host was the only reader of an
+ * `Intent`. The phone is one now, and the alternative to moving this was for
+ * the phone to keep taking the aggregate over the wire as a `FanoutRun` DTO —
+ * which is the pattern this whole change exists to stop: a lossy per-vocabulary
+ * projection, sent alongside the rows it was projected FROM, in the same frame
+ * burst, over the one link this app spends its life apologising for.
+ *
+ * The function did not become shared code by being duplicated. It moved. The
+ * host imports it from here and its own call sites are unchanged.
+ */
+import { type FanoutRun } from "./wire/work.js";
+import { type Intent } from "./intent.js";
+export declare function fanoutRuns(all: readonly Intent[], cap?: number): FanoutRun[];

package/node_modules/@waterplane/shared/dist/fanoutruns.js

@@ -0,0 +1,88 @@
+/**
+ * **A sweep, rebuilt from the rows that make it up.**
+ *
+ * A fan-out used to be an in-memory ring host-side that died with the daemon —
+ * the run record, not the sessions, which is why a restart mid-sweep left twelve
+ * sessions and no account of what they were for. It is now N intents sharing a
+ * `groupId`, so the run is exactly as durable as everything else in the store
+ * and `finishedAt` is DERIVED: a run is over when nothing in its group is still
+ * going, which is also what makes a follow-up correctly reopen it.
+ *
+ * ── Why it is HERE and not in `host/intents/adapters.ts` ────────────────────
+ *
+ * It was there, and that was right while the host was the only reader of an
+ * `Intent`. The phone is one now, and the alternative to moving this was for
+ * the phone to keep taking the aggregate over the wire as a `FanoutRun` DTO —
+ * which is the pattern this whole change exists to stop: a lossy per-vocabulary
+ * projection, sent alongside the rows it was projected FROM, in the same frame
+ * burst, over the one link this app spends its life apologising for.
+ *
+ * The function did not become shared code by being duplicated. It moved. The
+ * host imports it from here and its own call sites are unchanged.
+ */
+import { FANOUT_MAX_RUNS } from "./wire/work.js";
+import { ORIGIN_FANOUT_FOLLOWUP, ORIGIN_FANOUT_TARGET, isFanoutRow } from "./intent.js";
+/** The one place an intent's lifecycle becomes a sweep target's status. */
+const fanoutStatus = (i) => i.state === "done" ? "done"
+    : i.state === "failed" || i.state === "canceled" ? "failed"
+        : i.state === "running" ? "running"
+            : i.state === "starting" ? "starting"
+                : "pending";
+/** Last path segment. `node:path`'s `basename` is not available on the phone,
+ *  and a sweep target's label is the only thing this needed it for. */
+const lastSegment = (p) => p.split("/").filter(Boolean).pop() || p;
+export function fanoutRuns(all, cap = FANOUT_MAX_RUNS) {
+    const groups = new Map();
+    for (const i of all) {
+        if (!isFanoutRow(i))
+            continue;
+        const g = groups.get(i.groupId) ?? [];
+        g.push(i);
+        groups.set(i.groupId, g);
+    }
+    const runs = [];
+    for (const [runId, rows] of groups) {
+        const parent = all.find((r) => r.id === runId);
+        const targets = rows.filter((r) => r.origin === ORIGIN_FANOUT_TARGET)
+            .sort((a, b) => (a.order ?? a.createdAt) - (b.order ?? b.createdAt));
+        if (!targets.length && !parent)
+            continue;
+        const text = (parent?.payload.kind === "prompt" ? parent.payload.steps[0] : undefined)
+            ?? (targets[0]?.payload.kind === "prompt" ? targets[0].payload.steps[0] : "");
+        const startedAt = parent?.createdAt ?? Math.min(...targets.map((t) => t.createdAt));
+        const settled = (r) => r.state === "done" || r.state === "failed" || r.state === "canceled";
+        const open = rows.some((r) => !settled(r));
+        // Follow-ups are grouped by their batch: one tap addressed one subset, and
+        // the run records that subset, not N separate sends.
+        const batches = new Map();
+        for (const r of rows) {
+            if (!r.origin?.startsWith(ORIGIN_FANOUT_FOLLOWUP))
+                continue;
+            const key = r.origin.slice(ORIGIN_FANOUT_FOLLOWUP.length);
+            batches.set(key, [...(batches.get(key) ?? []), r]);
+        }
+        const followUps = [...batches.values()]
+            .map((b) => ({
+            text: b[0].payload.kind === "prompt" ? b[0].payload.steps[0] : "",
+            at: Math.min(...b.map((r) => r.createdAt)),
+            dirs: b.map((r) => r.cwd),
+        }))
+            .sort((a, b) => a.at - b.at);
+        runs.push({
+            id: runId,
+            text,
+            startedAt,
+            finishedAt: open ? undefined : Math.max(...rows.map((r) => r.settledAt ?? r.createdAt)),
+            targets: targets.map((t) => ({
+                dir: t.cwd,
+                title: t.title || lastSegment(t.cwd),
+                sessionId: t.sessionId,
+                status: fanoutStatus(t),
+                error: t.state === "failed" || t.state === "canceled" ? t.result?.detail : undefined,
+            })),
+            followUps: followUps.length ? followUps : undefined,
+        });
+    }
+    return runs.sort((a, b) => b.startedAt - a.startedAt).slice(0, cap);
+}
+//# sourceMappingURL=fanoutruns.js.map

package/node_modules/@waterplane/shared/dist/fanoutruns.js.map

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

package/node_modules/@waterplane/shared/dist/followup.d.ts

@@ -0,0 +1,38 @@
+/**
+ * "Flag for follow up" — what the flag may say, and the one wording of it
+ * (R-sessions-041…045). The host keeps the flags per conversation and stamps
+ * them onto `SessionInfo.followUp` / `ClosedSession.followUp`; both ends read
+ * a flag through `cleanFollowUp` and word it through `followUpText`, so the
+ * row, the header and the notification cannot describe one flag three ways.
+ *
+ * It is a reading list, not a status: setting one never changes what a
+ * session does, and only a person's tap clears it — opening the session does
+ * not (that is `newActivity`'s job, and the reason this is a second field).
+ */
+import type { FollowUp, FollowUpBy } from "./wire/session.js";
+/** An agent's reason, and a launch flag's item label, are one line of at most this. */
+export declare const FOLLOWUP_REASON_CAP = 160;
+/** One line, collapsed whitespace, clipped with an ellipsis; empty ⇒ undefined. */
+export declare function clipFollowUpText(v: unknown): string | undefined;
+/**
+ * A flag read off disk or the wire. An unknown `by` or a missing `at` drops the
+ * WHOLE flag (`null`) — a flag that cannot say who set it cannot be coloured,
+ * and rounding it to `hand` would claim the person did. `reason` is kept only
+ * on an `agent` flag, `item` only on a `launch` one.
+ */
+export declare function cleanFollowUp(raw: unknown): FollowUp | null;
+/** Who set it, in the words a row and a hint use. */
+export declare function followUpByText(by: FollowUpBy): string;
+/**
+ * The flag as one sentence: who, and — where there is one — what to read.
+ * `flagged by the session: migration needs your call`.
+ */
+export declare function followUpText(f: FollowUp): string;
+/**
+ * The push a flag set WITHOUT a tap sends (a `hand` flag sends none — the
+ * person is holding the phone). Title names the session; body is the reason.
+ */
+export declare function followUpPushText(f: FollowUp, title: string): {
+    title: string;
+    body: string;
+} | null;

package/node_modules/@waterplane/shared/dist/followup.js

@@ -0,0 +1,68 @@
+/** An agent's reason, and a launch flag's item label, are one line of at most this. */
+export const FOLLOWUP_REASON_CAP = 160;
+const BY = new Set(["hand", "launch", "agent"]);
+/** One line, collapsed whitespace, clipped with an ellipsis; empty ⇒ undefined. */
+export function clipFollowUpText(v) {
+    if (typeof v !== "string")
+        return undefined;
+    const t = v.replace(/\s+/g, " ").trim();
+    if (!t)
+        return undefined;
+    return t.length > FOLLOWUP_REASON_CAP ? `${t.slice(0, FOLLOWUP_REASON_CAP - 1).trimEnd()}…` : t;
+}
+/**
+ * A flag read off disk or the wire. An unknown `by` or a missing `at` drops the
+ * WHOLE flag (`null`) — a flag that cannot say who set it cannot be coloured,
+ * and rounding it to `hand` would claim the person did. `reason` is kept only
+ * on an `agent` flag, `item` only on a `launch` one.
+ */
+export function cleanFollowUp(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const r = raw;
+    if (typeof r.by !== "string" || !BY.has(r.by))
+        return null;
+    if (typeof r.at !== "number" || !Number.isFinite(r.at) || r.at <= 0)
+        return null;
+    const by = r.by;
+    const out = { by, at: r.at };
+    const reason = by === "agent" ? clipFollowUpText(r.reason) : undefined;
+    const item = by === "launch" ? clipFollowUpText(r.item) : undefined;
+    if (reason)
+        out.reason = reason;
+    if (item)
+        out.item = item;
+    return out;
+}
+/** Who set it, in the words a row and a hint use. */
+export function followUpByText(by) {
+    return by === "hand" ? "flagged by you"
+        : by === "launch" ? "flagged when done, as you asked"
+            : "flagged by the session";
+}
+/**
+ * The flag as one sentence: who, and — where there is one — what to read.
+ * `flagged by the session: migration needs your call`.
+ */
+export function followUpText(f) {
+    const head = followUpByText(f.by);
+    if (f.by === "agent" && f.reason)
+        return `${head}: ${f.reason}`;
+    if (f.by === "launch" && f.item)
+        return `${head} (${f.item})`;
+    return head;
+}
+/**
+ * The push a flag set WITHOUT a tap sends (a `hand` flag sends none — the
+ * person is holding the phone). Title names the session; body is the reason.
+ */
+export function followUpPushText(f, title) {
+    if (f.by === "hand")
+        return null;
+    return {
+        title: `Follow up: ${title}`,
+        body: f.by === "agent" ? (f.reason ?? "The session says there is something for you to read.")
+            : `Finished${f.item ? ` — ${f.item}` : ""}. Flagged for follow up, as you asked.`,
+    };
+}
+//# sourceMappingURL=followup.js.map

package/node_modules/@waterplane/shared/dist/followup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"followup.js","sourceRoot":"","sources":["../src/followup.ts"],"names":[],"mappings":"AAaA,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,MAAM,EAAE,GAAwB,IAAI,GAAG,CAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjF,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,CAAU;IACzC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,CAAC,CAAC,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAClG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjF,MAAM,EAAE,GAAG,CAAC,CAAC,EAAgB,CAAC;IAC9B,MAAM,GAAG,GAAa,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,MAAM,IAAI,GAAG,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,IAAI,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IAChC,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAC1B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,cAAc,CAAC,EAAc;IAC3C,OAAO,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB;QACrC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,iCAAiC;YACrD,CAAC,CAAC,wBAAwB,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,CAAW;IACtC,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,EAAE,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IAChE,IAAI,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI;QAAE,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC;IAC9D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,KAAa;IACzD,IAAI,CAAC,CAAC,EAAE,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO;QACL,KAAK,EAAE,cAAc,KAAK,EAAE;QAC5B,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,sDAAsD,CAAC;YAC3F,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,wCAAwC;KACpF,CAAC;AACJ,CAAC"}

package/node_modules/@waterplane/shared/dist/gallery.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Gallery listings, offline.
+ *
+ * The grid ("Images & documents") is a pure HTTP view: every tab, kind chip and
+ * time window is a request to the host, and with the tunnel down all four of
+ * them answer with a spinner that never lands. That is the wrong answer twice
+ * over — the phone HAS seen this listing (it painted it minutes ago, and the
+ * thumbnails are still in the service worker's cache), and the files it lists
+ * are the ones an agent left for you to read on a train.
+ *
+ * So a listing is cached, and a cached listing is re-filtered locally. Which
+ * makes the rules below load-bearing, because a cache that answers the WRONG
+ * question is worse than no cache: it shows files that were filtered out on
+ * purpose and hides files that exist.
+ *
+ *  - `coversQuery` — a stored listing may only answer a question it is a
+ *    superset of. An all-time listing can answer "last 4h" (filter by mtime);
+ *    a 4h listing can NOT answer "all time", and an image-only listing can
+ *    never answer "docs" no matter how wide its window.
+ *  - `filterGalleryRows` — mirrors what the host does server-side
+ *    (`files.ts discoverArtifacts`): the time window is cut on **mtime**, and
+ *    the `image` kind includes VIDEO (that is the host's `kindExt`, not an
+ *    oversight). The image/doc split is passed IN rather than duplicated here,
+ *    so there is one extension list per side and no third one in `shared`.
+ *
+ * Nothing here is a source of truth: every value is last-known-good and is
+ * replaced by the next live listing. Callers must LABEL rows that came from
+ * here — "the newest files as of 20 minutes ago" is useful, "the newest files"
+ * is a lie.
+ */
+export type GalleryKind = "all" | "image" | "doc";
+/** What a listing (or a question) covers: a kind filter and a time window. */
+export interface GalleryCoverage {
+    /** Window in seconds; `undefined` = all time, the broadest there is. */
+    since?: number;
+    kind: GalleryKind;
+}
+/** The minimum of a file row the rules here need. Both `FileEntry` (web) and
+ *  the host's artifact rows are structurally this. */
+export interface GalleryRow {
+    name: string;
+    relPath: string;
+    mtime: number;
+}
+export interface GalleryQuery extends GalleryCoverage {
+    /** Name substring, matched case-insensitively — same as the host's `q`. */
+    query?: string;
+}
+/**
+ * Can `entry`'s rows answer `want` by filtering alone?
+ *
+ * Kind is a strict containment (`all` ⊇ image/doc, and image ⊉ doc), the window
+ * is a numeric one with `undefined` as infinity. Deliberately NOT a single
+ * "broadness" score: image/all-time and all-kinds/4h are incomparable, and a
+ * scalar rank would happily serve one for the other.
+ */
+export declare function coversQuery(entry: GalleryCoverage, want: GalleryCoverage): boolean;
+/**
+ * The cached listing to answer `want` with, or null.
+ *
+ * An exact coverage match wins over a wider one (fewer rows discarded, and its
+ * `truncated` flag still means what it said), and among equals the freshest
+ * wins — with the link down, "saved 3 minutes ago" beats "saved yesterday" even
+ * when the older one is broader.
+ */
+export declare function pickCoveringListing<T extends GalleryCoverage & {
+    savedAt: number;
+}>(entries: T[], want: GalleryCoverage): T | null;
+/**
+ * Apply a gallery question to rows the host already returned.
+ *
+ * `isImageKind` decides the image/doc split (pass the caller's own predicate —
+ * on the web that is image OR video, matching the host's `kind=image`), and
+ * `now` is injected so the window is testable without a clock.
+ */
+export declare function filterGalleryRows<T extends GalleryRow>(rows: T[], want: GalleryQuery, isImageKind: (relPath: string) => boolean, now: number): T[];
+/** Cache identity of one TAB: the box being listed, not what is filtered out of
+ *  it. Repo-scoped tabs key on the repo; the all-repos tab keys on the repo SET,
+ *  because adding a repo genuinely changes the listing. */
+export declare function galleryScopeKey(scope: string, repoId?: string, repoKey?: string): string;
+/** Cache identity of one listing within a tab. A few coverages per tab is the
+ *  point: incomparable ones (images-all-time, everything-4h) both earn a slot. */
+export declare function galleryCacheKey(scopeKey: string, c: GalleryCoverage): string;