waterplane 0.1.25 → 0.1.26

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

@@ -0,0 +1,176 @@
+/**
+ * Skills and plugins switch — the pure logic both ends agree on: which level wins, what a write
+ * to a settings file may touch, and what a change set saves. Degrades to refusal-in-words, never
+ * to a rewrite of a file it could not read.
+ */
+import { CHARS_PER_TOKEN } from "./contextweight.js";
+import { SKILL_STATES, } from "./wire/skills.js";
+const RANK = { "on": 0, "name-only": 1, "user-invocable-only": 2, "off": 3 };
+const isState = (v) => typeof v === "string" && SKILL_STATES.includes(v);
+const own = (o, k) => !!o && Object.prototype.hasOwnProperty.call(o, k);
+export function resolveSkillState(id, layers, locks = {}) {
+    let locked = null;
+    for (const l of [locks.policy, locks.flag]) {
+        const v = own(l, id) ? l[id] : undefined;
+        if (isState(v) && (locked === null || RANK[v] > RANK[locked]))
+            locked = v;
+    }
+    if (locked)
+        return { state: locked, from: "locked" };
+    const order = [["local", "repo-local"], ["project", "repo-shared"], ["user", "global"]];
+    for (const [k, level] of order) {
+        const m = layers[k];
+        const v = own(m, id) ? m[id] : undefined;
+        if (isState(v))
+            return { state: v, from: level };
+    }
+    return { state: "on", from: "default" };
+}
+export function resolvePluginEnabled(id, layers, locks = {}, cliDefault = true) {
+    const bools = [locks.policy, locks.flag].map((l) => (own(l, id) ? l[id] : undefined)).filter((v) => typeof v === "boolean");
+    if (bools.length)
+        return { enabled: !bools.includes(false), from: "locked" };
+    const order = [["local", "repo-local"], ["project", "repo-shared"], ["user", "global"]];
+    for (const [k, level] of order) {
+        const m = layers[k];
+        const v = own(m, id) ? m[id] : undefined;
+        if (typeof v === "boolean")
+            return { enabled: v, from: level };
+    }
+    return { enabled: cliDefault, from: "default" };
+}
+const KEY_RE = /^[A-Za-z0-9._:@-]{1,255}$/;
+const FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+const PLUGIN_RE = /^[A-Za-z0-9._-]{1,127}@[A-Za-z0-9._-]{1,127}$/;
+/** null = fine, else a sentence. */
+export function validateChange(c) {
+    if (!c || (c.kind !== "skill" && c.kind !== "plugin") || typeof c.id !== "string")
+        return "A change needs a kind and an id.";
+    if (FORBIDDEN_KEYS.has(c.id) || !KEY_RE.test(c.id))
+        return `"${c.id.slice(0, 60)}" is not a name this screen can write.`;
+    if (c.kind === "plugin") {
+        if (!PLUGIN_RE.test(c.id))
+            return `"${c.id}" is not a plugin id (name@marketplace).`;
+        if (c.to !== true && c.to !== false && c.to !== "inherit")
+            return `A plugin is switched on, off or back to inherit, not "${String(c.to)}".`;
+        return null;
+    }
+    if (c.to !== "inherit" && !isState(c.to))
+        return `"${String(c.to)}" is not one of the four skill states.`;
+    return null;
+}
+function indentOf(text) {
+    const m = /^[ \t]+(?=")/m.exec(text);
+    if (!m)
+        return 2;
+    return m[0].includes("\t") ? "\t" : m[0].length;
+}
+const show = (v) => (v === undefined ? "inherit" : String(v));
+/**
+ * Apply `changes` to a settings file's text. Touches only `skillOverrides` and `enabledPlugins`;
+ * a new key appends, an existing key keeps its place, `inherit` deletes the key (and the object
+ * only if this call emptied it). `text: null` = no file yet. Refuses an unparseable file.
+ */
+export function withSkillSettings(text, changes) {
+    for (const c of changes) {
+        const bad = validateChange(c);
+        if (bad)
+            return { ok: false, error: bad };
+    }
+    let obj = {};
+    let indent = 2;
+    let trailingNl = true;
+    if (text != null && text.trim() !== "") {
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch (e) {
+            return { ok: false, error: `not valid JSON, left as it is (${e.message})` };
+        }
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return { ok: false, error: "not a JSON object, left as it is" };
+        obj = parsed;
+        indent = indentOf(text);
+        trailingNl = text.endsWith("\n");
+    }
+    for (const k of ["skillOverrides", "enabledPlugins"]) {
+        const v = obj[k];
+        if (v !== undefined && (!v || typeof v !== "object" || Array.isArray(v)))
+            return { ok: false, error: `"${k}" is not an object, left as it is` };
+    }
+    const changed = [];
+    for (const c of changes) {
+        const field = c.kind === "skill" ? "skillOverrides" : "enabledPlugins";
+        const had = Object.prototype.hasOwnProperty.call(obj, field);
+        const map = (had ? obj[field] : {});
+        const before = own(map, c.id) ? map[c.id] : undefined;
+        if (c.to === "inherit") {
+            if (before === undefined)
+                continue;
+            delete map[c.id];
+            if (had && Object.keys(map).length === 0)
+                delete obj[field];
+        }
+        else {
+            if (before === c.to)
+                continue;
+            map[c.id] = c.to;
+            if (!had)
+                obj[field] = map;
+        }
+        changed.push({ id: c.id, from: show(before), to: show(c.to === "inherit" ? undefined : c.to) });
+    }
+    if (changed.length === 0 && text != null)
+        return { ok: true, text, changed };
+    return { ok: true, text: JSON.stringify(obj, null, indent) + (trailingNl ? "\n" : ""), changed };
+}
+/** The listing line a skill costs in a given state: name-only keeps "- name", the others drop it or keep all of it. */
+const NAME_LINE = 2;
+export function lineCost(row, state) {
+    if (row.listingChars === undefined)
+        return null;
+    if (state === "on")
+        return row.listingChars;
+    if (state === "name-only")
+        return Math.min(row.listingChars, row.id.length + NAME_LINE);
+    return 0;
+}
+/**
+ * Chars a change set would remove from the skill listing (negative = adds). Unmeasured rows and
+ * `inherit` (whose result depends on the other levels) contribute nothing and are counted.
+ */
+export function savingsOf(rows, changes) {
+    const byId = new Map(rows.map((r) => [`${r.kind}:${r.id}`, r]));
+    let chars = 0;
+    let unmeasured = 0;
+    for (const c of changes) {
+        const r = byId.get(`${c.kind}:${c.id}`);
+        if (!r || c.to === "inherit") {
+            unmeasured++;
+            continue;
+        }
+        if (r.kind === "skill" && c.kind === "skill") {
+            if (!isState(c.to))
+                continue;
+            const a = lineCost(r, r.effective);
+            const b = lineCost(r, c.to);
+            if (a === null || b === null) {
+                unmeasured++;
+                continue;
+            }
+            chars += a - b;
+        }
+        else if (r.kind === "plugin" && c.kind === "plugin" && typeof c.to === "boolean") {
+            if (c.to === r.enabled)
+                continue;
+            if (r.listingChars === undefined) {
+                unmeasured++;
+                continue;
+            }
+            chars += c.to ? -r.listingChars : r.listingChars;
+        }
+    }
+    return { chars, tokens: Math.round(chars / CHARS_PER_TOKEN), unmeasured };
+}
+//# sourceMappingURL=skillstate.js.map

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

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

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

@@ -0,0 +1,10 @@
+/** The sentences of the skills and plugins switch, worded once for phone, host and VS Code. */
+import type { SwitchLevel } from "./wire/skills.js";
+export declare const SKILL_NEW_SESSIONS_ONLY = "Changes reach new sessions only \u2014 a session that is already running keeps what it was started with.";
+export declare function skillFileLine(level: SwitchLevel, path: string): string;
+export declare const skillPluginSkillLine: (plugin: string) => string;
+export declare const skillPluginNotSwitchable: (plugin: string) => string;
+export declare const SKILL_UNMEASURED = "size not measured";
+export declare const skillLayerUnreadable: (path: string, why: string) => string;
+export declare const skillRevConflict: (path: string) => string;
+export declare const skillSavingsLine: (tokens: number, unmeasured: number) => string;

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

@@ -0,0 +1,18 @@
+export const SKILL_NEW_SESSIONS_ONLY = "Changes reach new sessions only — a session that is already running keeps what it was started with.";
+export function skillFileLine(level, path) {
+    const who = level === "global" ? "every repo on this desktop" : level === "repo-shared" ? "this repo, shared with everyone who clones it" : "this repo, on this desktop only";
+    return `Writes ${path} (${who}).`;
+}
+export const skillPluginSkillLine = (plugin) => `follows ${plugin}`;
+export const skillPluginNotSwitchable = (plugin) => `This skill comes with ${plugin}; the CLI only switches it with the whole plugin.`;
+export const SKILL_UNMEASURED = "size not measured";
+export const skillLayerUnreadable = (path, why) => `${path} was not changed: ${why}`;
+export const skillRevConflict = (path) => `${path} changed since this screen read it. Nothing was written; reload and choose again.`;
+export const skillSavingsLine = (tokens, unmeasured) => {
+    const more = unmeasured > 0 ? `, plus ${unmeasured} unmeasured` : "";
+    if (tokens === 0)
+        return `No change in the skill listing${more}.`;
+    const n = Math.abs(tokens);
+    return tokens > 0 ? `Up to about ${n} tokens fewer per turn${more}.` : `Up to about ${n} tokens more per turn${more}.`;
+};
+//# sourceMappingURL=skillwords.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skillwords.js","sourceRoot":"","sources":["../src/skillwords.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,uBAAuB,GAClC,qGAAqG,CAAC;AAExG,MAAM,UAAU,aAAa,CAAC,KAAkB,EAAE,IAAY;IAC5D,MAAM,GAAG,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,+CAA+C,CAAC,CAAC,CAAC,iCAAiC,CAAC;IAC9K,OAAO,UAAU,IAAI,KAAK,GAAG,IAAI,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,WAAW,MAAM,EAAE,CAAC;AACpF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAU,EAAE,CACjE,yBAAyB,MAAM,mDAAmD,CAAC;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAE,GAAW,EAAU,EAAE,CACxE,GAAG,IAAI,qBAAqB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAU,EAAE,CACvD,GAAG,IAAI,mFAAmF,CAAC;AAC7F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAE,UAAkB,EAAU,EAAE;IAC7E,MAAM,IAAI,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,UAAU,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,iCAAiC,IAAI,GAAG,CAAC;IAClE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,yBAAyB,IAAI,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,wBAAwB,IAAI,GAAG,CAAC;AACzH,CAAC,CAAC"}

package/node_modules/@waterplane/shared/dist/wire/agentreadings.d.ts

@@ -4,8 +4,12 @@
  * host `agentreadings.ts`). Four readings, one row per ISO week (Monday, the
  * host's local day), oldest first:
  *
- *  - `explore` — how many input-side tokens a FRESH session spends before its
- *    first file edit: how navigable the repo is for an agent. Lower is better.
+ *  - `start`   — what a fresh session's first request carried: median tokens,
+ *    median chars per part, and the subagents' own start. MEASURED off the logs
+ *    (never the skills screen's estimated weights; the two are never summed).
+ *  - `explore` — "Before the first edit": input-side tokens AND look calls a
+ *    fresh session spends before its first file edit, over one population.
+ *  - `requests` — median requests of a fresh session that committed.
  *  - `rework`  — the share of the week's tokens spent in sessions whose work
  *    was repairing earlier work, beside feature and UNKNOWN (never folded into
  *    feature).
@@ -19,6 +23,8 @@
  * `{ absent }`. A total always travels with its split (`TokenTotals`).
  */
 import type { TokenTotals } from "./telemetry.js";
+import type { SeriesValue } from "../agentseries/types.js";
+import type { AgentMarker } from "../agentseries/types.js";
 /** A reading that could not be taken this week, and why — never a zero. */
 export interface AgentReadingAbsent {
     absent: string;
@@ -35,8 +41,26 @@ export interface AgentExploreReading {
     medianTok: number;
     /** That same session's split: output is zero by construction (input-side only). */
     split: TokenTotals;
-    /** Requests that session made before its first edit. */
+    /** Requests that session made before its first edit. Kept on the wire for older phones; not drawn
+     *  (the look-call median says what it said, more tightly). */
     medianRequests: number;
+    /** Median look calls before the first edit over the same sessions (`LOOK_RULE_TEXT`), the agent
+     *  series' `look` reading. Absent FIELD on an older host. */
+    looks?: SeriesValue;
+}
+/** What a fresh session's first request carried this week (agent series `start`, `parts`, `subStart`). */
+export interface AgentStartReading {
+    /** Fresh, non-subagent sessions that started this week (headless included). */
+    fresh: number;
+    /** Median first-request tokens (input + cache read + cache write), fresh interactive sessions. */
+    tok: SeriesValue;
+    /** Median chars per part over the same sessions, in `START_PARTS` order; a part no session measured is not listed. */
+    parts: {
+        id: StartPart;
+        chars: SeriesValue;
+    }[];
+    /** Median first-request tokens of the subagent logs that started this week. */
+    sub: SeriesValue;
 }
 /** Which bucket a session's tokens were filed under. */
 export type ReworkClass = "rework" | "feature" | "unknown";
@@ -65,10 +89,44 @@ export interface AgentEscapedReading {
     /** Backlog items with category `bug` created this week that are still on the backlog. */
     bugItems: number | AgentReadingAbsent;
 }
+/**
+ * What the week cost, off the token ledger's per-repo day rows (the same rows
+ * the token-stats screen's *By repo* and the health score's context line read):
+ * every request the repo's conversations made, subagents included.
+ */
+export interface AgentSpendReading {
+    requests: number;
+    /** Requests on a model with a list price: the denominator of a price per request. */
+    pricedRequests: number;
+    /** List-price dollars — a counterfactual off one dated table, never a bill. */
+    usd: number;
+    /** Input + cache read + cache write over `requests`: the context they sent. Absent on an older ledger. */
+    ctxTok?: number;
+}
+/** Who did the week's work: the conversations and their subagents, off the same logs as `rework`. */
+export interface AgentActivityReading {
+    /** Conversations that spent tokens this week (a conversation over two weeks counts in both). */
+    sessions: number;
+    /** Of those, the ones that started this week. */
+    started: number;
+    /** Subagent logs that spent tokens this week. */
+    agents: number;
+    /** Tokens (all four kinds) in the conversations' own logs, and in their subagents' — the split of `rework.totalTok`. */
+    mainTok: number;
+    agentTok: number;
+}
 export interface AgentReadingsWeek {
     /** ISO week, its Monday as `YYYY-MM-DD` (host local day). */
     week: string;
+    /** Absent FIELD on an older host; absent READING when the ledger has no row for the repo that week. */
+    spend?: AgentSpendReading | AgentReadingAbsent;
+    /** Absent FIELD on an older host. */
+    activity?: AgentActivityReading | AgentReadingAbsent;
+    /** Absent FIELD on an older host. */
+    start?: AgentStartReading | AgentReadingAbsent;
     explore: AgentExploreReading | AgentReadingAbsent;
+    /** Median requests of fresh sessions that committed, in the week they started. Absent FIELD on an older host. */
+    requests?: SeriesValue;
     rework: AgentReworkReading | AgentReadingAbsent;
     compact: AgentCompactReading | AgentReadingAbsent;
     escaped: AgentEscapedReading;
@@ -79,6 +137,11 @@ export interface AgentReadingRules {
     rework: string;
     compact: string;
     escaped: string;
+    /** Absent on an older host. */
+    spend?: string;
+    activity?: string;
+    start?: string;
+    requests?: string;
 }
 export interface AgentReadingsDoc {
     ok: true;
@@ -102,3 +165,84 @@ export type AgentReadingsResponse = AgentReadingsDoc | {
 export declare const AGENT_READING_WEEKS = 12;
 /** True when the reading is the absent sentence rather than a value. */
 export declare function isAgentAbsent(x: unknown): x is AgentReadingAbsent;
+/** What the first request carried, by part, in display order. Closed: a part not listed is `other`. */
+export type StartPart = "system" | "tools" | "claudeMd" | "memory" | "skills" | "deferredTools" | "agents" | "hooks" | "session" | "other";
+/**
+ * The parts in display order, with the label a person reads — the SAME names the per-session
+ * "what every turn carries" list uses (`alwaysonwords.ts` `carriedLabel`), so one part has one
+ * name app-wide; `claudeMd` and `memory` are that list's "instruction files" cut by file type.
+ */
+export declare const START_PARTS: readonly {
+    id: StartPart;
+    label: string;
+}[];
+/** What counts as a look before the first edit, in a sentence the region's `?` quotes. */
+export declare const LOOK_RULE_TEXT = "A look is a call that only reads: Read, Grep, Glob, LS or NotebookRead, or a shell command that starts with grep, rg, find, ls, cat, head, tail, sed -n, wc, jq, tree or git log, show, diff, grep, blame or status (a leading cd \u2026 && is ignored). Looks are counted up to the session's first file edit; a session that never edits has no count.";
+export interface AgentPoint {
+    /** The log's own id: the conversation's session id, or a subagent's path under it. */
+    id: string;
+    /** First record's time (ms). */
+    t0: number;
+    /** The repo the session ran in (worktrees folded in). */
+    repo: string;
+    /** Began as a new conversation: not a fork, a continuation or a headless run. */
+    fresh: boolean;
+    headless: boolean;
+    /** A subagent's log. */
+    sub?: boolean;
+    /** Model of the first counted request, as logged. */
+    model?: string;
+    /** The CLI version that wrote the log. */
+    cli?: string;
+    /** Tokens the first request carried: input + cache read + cache write. */
+    start?: number;
+    /** Characters per part of that start context; a part never observed is absent. */
+    parts?: Partial<Record<StartPart, number>>;
+    /** Read-only calls before the first edit; absent when the session never edited. */
+    look?: number;
+    /** Counted requests (a streamed reply counted once). */
+    req: number;
+    /** A `git commit` succeeded in the session. Absent on a subagent (not read there). */
+    commit?: boolean;
+}
+export interface AgentPointsDoc {
+    ok: true;
+    /** Newest first: at most `AGENT_POINTS_CAP` fresh conversations (a fork, a continuation or a headless run is no reading's session, so it is left off) and `AGENT_SUB_POINTS_CAP` subagent logs. */
+    points: AgentPoint[];
+    /** Points left off by the caps (the oldest of each kind), 0 when none. */
+    cut: number;
+    /** The repos asked about: one for a repo's route, every known one otherwise. */
+    repos: string[];
+    rules: {
+        look: string;
+    };
+    scannedAt: number;
+    logs: number;
+    reread: number;
+}
+export type AgentPointsResponse = AgentPointsDoc | {
+    ok: false;
+    error: string;
+    pending?: true;
+};
+/** The window the points cover: the same weeks the readings do. */
+export declare const AGENT_POINT_WEEKS = 12;
+/**
+ * Caps, per kind. A point is ~300 bytes of JSON, so these keep a response near 1.5 MB, which a phone
+ * parses without a stall. Subagent logs outnumber conversations ~5:1 on a busy repo (measured: 20,000
+ * of 24,000 points in twelve weeks), so one shared cap would be all subagents of the last few days
+ * and no conversation at all; each kind keeps its own newest.
+ */
+export declare const AGENT_POINTS_CAP = 3000;
+export declare const AGENT_SUB_POINTS_CAP = 2000;
+/** What changed, drawn beside the readings (`GET /api/repos/:id/agentmarkers`). Markers say what changed, never whether it helped. */
+export interface AgentMarkersDoc {
+    ok: true;
+    markers: AgentMarker[];
+    /** One sentence per source that could not be read: a source missing here is unknown, not unchanged. */
+    absent: string[];
+}
+export type AgentMarkersResponse = AgentMarkersDoc | {
+    ok: false;
+    error: string;
+};

package/node_modules/@waterplane/shared/dist/wire/agentreadings.js

@@ -4,4 +4,33 @@ export const AGENT_READING_WEEKS = 12;
 export function isAgentAbsent(x) {
     return typeof x === "object" && x !== null && typeof x.absent === "string";
 }
+/**
+ * The parts in display order, with the label a person reads — the SAME names the per-session
+ * "what every turn carries" list uses (`alwaysonwords.ts` `carriedLabel`), so one part has one
+ * name app-wide; `claudeMd` and `memory` are that list's "instruction files" cut by file type.
+ */
+export const START_PARTS = [
+    { id: "system", label: "system prompt" },
+    { id: "tools", label: "tool schemas" },
+    { id: "claudeMd", label: "instruction files: CLAUDE.md" },
+    { id: "memory", label: "instruction files: auto-memory" },
+    { id: "skills", label: "skill listing" },
+    { id: "deferredTools", label: "deferred tool names" },
+    { id: "agents", label: "subagent listing" },
+    { id: "hooks", label: "hook context" },
+    { id: "session", label: "session context" },
+    { id: "other", label: "MCP instructions and other" },
+];
+/** What counts as a look before the first edit, in a sentence the region's `?` quotes. */
+export const LOOK_RULE_TEXT = "A look is a call that only reads: Read, Grep, Glob, LS or NotebookRead, or a shell command that starts with grep, rg, find, ls, cat, head, tail, sed -n, wc, jq, tree or git log, show, diff, grep, blame or status (a leading cd … && is ignored). Looks are counted up to the session's first file edit; a session that never edits has no count.";
+/** The window the points cover: the same weeks the readings do. */
+export const AGENT_POINT_WEEKS = AGENT_READING_WEEKS;
+/**
+ * Caps, per kind. A point is ~300 bytes of JSON, so these keep a response near 1.5 MB, which a phone
+ * parses without a stall. Subagent logs outnumber conversations ~5:1 on a busy repo (measured: 20,000
+ * of 24,000 points in twelve weeks), so one shared cap would be all subagents of the last few days
+ * and no conversation at all; each kind keeps its own newest.
+ */
+export const AGENT_POINTS_CAP = 3000;
+export const AGENT_SUB_POINTS_CAP = 2000;
 //# sourceMappingURL=agentreadings.js.map

package/node_modules/@waterplane/shared/dist/wire/agentreadings.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentreadings.js","sourceRoot":"","sources":["../../src/wire/agentreadings.ts"],"names":[],"mappings":"AA2GA,wCAAwC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,OAAQ,CAAwB,CAAC,MAAM,KAAK,QAAQ,CAAC;AACrG,CAAC"}
+{"version":3,"file":"agentreadings.js","sourceRoot":"","sources":["../../src/wire/agentreadings.ts"],"names":[],"mappings":"AA0KA,wCAAwC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,OAAQ,CAAwB,CAAC,MAAM,KAAK,QAAQ,CAAC;AACrG,CAAC;AAUD;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgD;IACtE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE;IACxC,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE;IACtC,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,8BAA8B,EAAE;IACzD,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,gCAAgC,EAAE;IACzD,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE;IACxC,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,qBAAqB,EAAE;IACrD,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE;IAC3C,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE;IACtC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE;IAC3C,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,4BAA4B,EAAE;CACrD,CAAC;AAEF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,cAAc,GACzB,qVAAqV,CAAC;AA8CxV,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AACrD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC"}

package/node_modules/@waterplane/shared/dist/wire/backend.d.ts

@@ -123,6 +123,8 @@ export interface BackendInfo {
         modes?: true;
         /** The phone's slash sheet lists the backend's OWN commands (`slash` keeps meaning claude's set and header chips). */
         commands?: true;
+        /** The skills and plugins switch (settings files of the claude family) is offered; absent = not offered, never `false`. */
+        skillSwitch?: true;
         /** How the core's repo instructions reach this backend by default (the session's actual: `SessionInfo.told`). */
         told?: "plugin-dir" | "env-file" | "config" | "flag" | "none";
         /**

package/node_modules/@waterplane/shared/dist/wire/costwindow.d.ts

@@ -139,6 +139,10 @@ export interface CostWindowDoc {
     /** Tokens no list price covered — counted, never charged zero. */
     unpriced: TokenTotals;
     pricesAsOf: string;
+    /** `list`: the rates were read off Anthropic's price page on `pricesAsOf`.
+     *  `builtin`: the table shipped with this version, dated `pricesAsOf`.
+     *  Absent on an older host — which always meant the built-in table. */
+    pricesFrom?: "list" | "builtin";
     scannedAt: number;
     /** Records in `totals` that are in NO hour (no readable timestamp) and that COULD fall in this
      *  window — only logs last written at or after `fromHour` count (a record is never later than

package/node_modules/@waterplane/shared/dist/wire/dictatesetup.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Setting up local dictation from the phone, on the wire.
+ *
+ * The desktop installs whisper.cpp (macOS brew) and downloads ONE chosen ggml
+ * model from upstream on a person's tap — never bundled, never automatic. The
+ * model table itself is `dictatemodels.ts`; these are the shapes that cross.
+ */
+/** A model the person may choose, as the phone draws it (the table's row less
+ *  the url and hash: the host holds those). */
+export interface DictateModelChoice {
+    id: string;
+    file: string;
+    bytes: number;
+    note: string;
+    recommended: boolean;
+    /** This model's file is already in the model directory at the right size. */
+    installed: boolean;
+}
+/** What `POST /api/host/dictate/setup` takes. */
+export interface DictateSetupRequest {
+    model: string;
+}
+export type DictateSetupStep = "engine" | "disk" | "download" | "verify";
+/** `GET /api/host/dictate/setup`. A failure is a SENTENCE a person can act on;
+ *  there is no auto-retry — the next attempt is another POST. */
+export type DictateSetupState = {
+    state: "idle";
+} | {
+    state: "running";
+    model: string;
+    step: DictateSetupStep;
+    bytesDone: number;
+    bytesTotal: number;
+} | {
+    state: "done";
+    model: string;
+} | {
+    state: "failed";
+    model: string;
+    step: DictateSetupStep;
+    reason: string;
+};

package/node_modules/@waterplane/shared/dist/wire/dictatesetup.js

@@ -0,0 +1,9 @@
+/**
+ * Setting up local dictation from the phone, on the wire.
+ *
+ * The desktop installs whisper.cpp (macOS brew) and downloads ONE chosen ggml
+ * model from upstream on a person's tap — never bundled, never automatic. The
+ * model table itself is `dictatemodels.ts`; these are the shapes that cross.
+ */
+export {};
+//# sourceMappingURL=dictatesetup.js.map

package/node_modules/@waterplane/shared/dist/wire/dictatesetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictatesetup.js","sourceRoot":"","sources":["../../src/wire/dictatesetup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/node_modules/@waterplane/shared/dist/wire/messages/hostcore.d.ts

@@ -42,6 +42,23 @@ export type HostCoreMsg = HostUpdatesMsg | {
     updateKey?: string;
     tlsPort?: number;
     tlsSpki?: string;
+    /** The rates this host read off Anthropic's price page, so the phone's own cost hints match the
+     *  host's. Absent = the host prices from its built-in table (or is older): the phone uses its own. */
+    prices?: {
+        rates: Record<string, {
+            input: number;
+            output: number;
+            cacheRead?: number;
+        }>;
+        /** Long-prompt cards (Haiku 5.5 past 100K tokens); absent from an older host. */
+        longPrompt?: Record<string, {
+            input: number;
+            output: number;
+            cacheRead?: number;
+            overTokens: number;
+        }>;
+        fetchedAt: number;
+    };
 }
 /**
  * The daemon is going down (SIGTERM/SIGINT — `npm run restart` is one),
@@ -298,7 +315,10 @@ export type HostCoreMsg = HostUpdatesMsg | {
  *  session's worktree, plus its background shells (the same `shellList` a
  *  status poll would publish) — a close sheet asking "what's at stake here"
  *  needs both facts in the one reply, not a second round trip. Absent means
- *  the same as `SessionInfo.shellList` absent: could not read, not "none". */
+ *  the same as `SessionInfo.shellList` absent: could not read, not "none".
+ *  `unmergedUnknown: true` = the host could not measure `unmerged` (no base
+ *  branch found, or git failed); `unmerged` is then 0 and means nothing.
+ *  Absent = measured (an older host). */
  | {
     t: "session.closecheck";
     id: string;
@@ -306,6 +326,7 @@ export type HostCoreMsg = HostUpdatesMsg | {
     branch: string;
     dirty: boolean;
     unmerged: number;
+    unmergedUnknown?: boolean;
     isMain: boolean;
     mainBranch: string;
     shells?: SessionShell[];