waterplane 0.0.1 → 0.1.11

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

@@ -0,0 +1,114 @@
+/**
+ * The week-end burn: spending what is left of a subscription week on small
+ * repo improvements, in the repos the person picked FOR THIS WEEK.
+ *
+ * Pure, no clock (callers pass `now`), shared by the host's observer and the
+ * phone's sheet so both print the same sentence. Every reading that cannot be
+ * made is null or a refusal in words — never a guessed number, and never a
+ * mutation: the pick is the approval, these functions only say when, whether
+ * and what to tell the person.
+ */
+import type { UsageSample } from "./wire/telemetry.js";
+export declare const WEEKBURN_DEFAULT_STOP_PCT = 95;
+/** One 5-hour session window. */
+export declare const WEEKBURN_WINDOW_MS: number;
+/** A full window is a session stretch that reached this percent. */
+export declare const WEEKBURN_FULL_WINDOW_PCT = 80;
+/** How far back a measured window may be. */
+export declare const WEEKBURN_MEASURE_MS: number;
+/** Nothing new is posted this close to the weekly reset. */
+export declare const WEEKBURN_STOP_BEFORE_RESET_MS: number;
+/** Margin before the computed windows, and the fallback lead when none is measured. */
+export declare const WEEKBURN_MARGIN_MS = 3600000;
+export declare const WEEKBURN_FALLBACK_LEAD_MS: number;
+/** The nudge goes out this long before the planned start. */
+export declare const WEEKBURN_NUDGE_LEAD_MS: number;
+/** On pace to leave at least this many points under the stop line ⇒ offer the burn. */
+export declare const WEEKBURN_NUDGE_GAP_PCT = 20;
+export interface WeekBurnPrefs {
+    /** Repos picked for the week `weekOf` names. */
+    repos: string[];
+    /** The weekly reset instant the pick was made for; null = no pick. */
+    weekOf: number | null;
+    /** "Ask me again each week" — never runs last week's repos by itself. */
+    recurring: boolean;
+    /** Last week's pick, for the one-tap "same as last week". */
+    lastRepos: string[];
+    stopPct: number;
+}
+export interface WeekBurnPlan {
+    startAt: number;
+    windows: number | null;
+    ptsPerWindow: number | null;
+    /** One sentence; host and phone print the same one. */
+    reasonText: string;
+    /** Weekly percent at the reset if the week keeps its pace; null = cannot say. */
+    projectedPct: number | null;
+}
+export interface WeekBurnStatus {
+    prefs: WeekBurnPrefs;
+    available: boolean;
+    unavailableText?: string;
+    weeklyPct: number | null;
+    weeklyResetAt: number | null;
+    plan: WeekBurnPlan | null;
+    pickedThisWeek: boolean;
+    running: {
+        repoDir: string;
+        posted: number;
+        live: string | null;
+        stoppedText?: string;
+    }[];
+    stoppedText?: string;
+}
+/** Hand-editable file: anything that is not the right shape falls back to the default for that field. */
+export declare function cleanWeekBurnPrefs(x: unknown): WeekBurnPrefs;
+/**
+ * Weekly points one 5-hour session window can burn, measured: per session
+ * stretch that reached `WEEKBURN_FULL_WINDOW_PCT` inside the last 14 days, the
+ * weekly figure's climb during it; the MAX. Null when no stretch qualifies.
+ */
+export declare function ptsPerWindow(samples: readonly UsageSample[], now: number): number | null;
+export declare function weekBurnPlan(a: {
+    samples: readonly UsageSample[];
+    weeklyPct: number | null;
+    weeklyResetAt: number | null;
+    stopPct: number;
+    now: number;
+}): WeekBurnPlan | null;
+/** Whether the pick on file is for the week that resets at `weeklyResetAt` (RESET_MATCH_MS tolerance). */
+export declare function pickedFor(prefs: WeekBurnPrefs, weeklyResetAt: number | null): boolean;
+/**
+ * Null = a new row may be posted. Otherwise the sentence for why not. A
+ * missing or stale weekly reading never posts: `readingAt` is when the
+ * reading was taken (null = nobody read it).
+ */
+export declare function weekBurnStopText(a: {
+    weeklyPct: number | null;
+    weeklyResetAt: number | null;
+    stopPct: number;
+    now: number;
+    readingAt?: number | null;
+}): string | null;
+/**
+ * The once-a-week push, or null. Words only: it asks, it starts nothing.
+ * `nudgedWeekOf` is the reset the last nudge was sent for (once per week).
+ */
+export declare function weekBurnNudge(a: {
+    samples: readonly UsageSample[];
+    prefs: WeekBurnPrefs;
+    weeklyPct: number | null;
+    weeklyResetAt: number | null;
+    readingAt: number | null;
+    subscription: boolean;
+    nudgedWeekOf: number | null;
+    now: number;
+}): {
+    title: string;
+    body: string;
+} | null;
+/** What an unattended burn package is told. One improvement, one commit, nothing pushed. */
+export declare function weekBurnItemPrompt(a: {
+    repoName: string;
+    healthSummary?: string | null;
+}): string;

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

@@ -0,0 +1,205 @@
+import { usageStretches } from "./burn.js";
+import { BUDGET_STALE_MS } from "./budget.js";
+import { RESET_MATCH_MS } from "./intent.js";
+const HOUR = 3_600_000;
+const MIN = 60_000;
+export const WEEKBURN_DEFAULT_STOP_PCT = 95;
+/** One 5-hour session window. */
+export const WEEKBURN_WINDOW_MS = 5 * HOUR;
+/** A full window is a session stretch that reached this percent. */
+export const WEEKBURN_FULL_WINDOW_PCT = 80;
+/** How far back a measured window may be. */
+export const WEEKBURN_MEASURE_MS = 14 * 24 * HOUR;
+/** Nothing new is posted this close to the weekly reset. */
+export const WEEKBURN_STOP_BEFORE_RESET_MS = 20 * MIN;
+/** Margin before the computed windows, and the fallback lead when none is measured. */
+export const WEEKBURN_MARGIN_MS = HOUR;
+export const WEEKBURN_FALLBACK_LEAD_MS = 24 * HOUR;
+/** The nudge goes out this long before the planned start. */
+export const WEEKBURN_NUDGE_LEAD_MS = 24 * HOUR;
+/** On pace to leave at least this many points under the stop line ⇒ offer the burn. */
+export const WEEKBURN_NUDGE_GAP_PCT = 20;
+const MAX_REPOS = 50;
+const MIN_RATE_SPAN_MS = 6 * HOUR;
+function cleanRepos(x) {
+    if (!Array.isArray(x))
+        return [];
+    const out = [];
+    for (const r of x) {
+        if (typeof r === "string" && r.trim() && !out.includes(r))
+            out.push(r);
+        if (out.length >= MAX_REPOS)
+            break;
+    }
+    return out;
+}
+/** Hand-editable file: anything that is not the right shape falls back to the default for that field. */
+export function cleanWeekBurnPrefs(x) {
+    const o = x && typeof x === "object" && !Array.isArray(x) ? x : {};
+    const stop = typeof o.stopPct === "number" && Number.isFinite(o.stopPct) ? Math.min(100, Math.max(50, Math.round(o.stopPct))) : WEEKBURN_DEFAULT_STOP_PCT;
+    const weekOf = typeof o.weekOf === "number" && Number.isFinite(o.weekOf) && o.weekOf > 0 ? o.weekOf : null;
+    return { repos: cleanRepos(o.repos), weekOf, recurring: o.recurring === true, lastRepos: cleanRepos(o.lastRepos), stopPct: stop };
+}
+/**
+ * Weekly points one 5-hour session window can burn, measured: per session
+ * stretch that reached `WEEKBURN_FULL_WINDOW_PCT` inside the last 14 days, the
+ * weekly figure's climb during it; the MAX. Null when no stretch qualifies.
+ */
+export function ptsPerWindow(samples, now) {
+    let best = null;
+    for (const seg of usageStretches(samples, "session")) {
+        if (seg.pts.length < 2)
+            continue;
+        const from = seg.pts[0].t;
+        const to = seg.pts[seg.pts.length - 1].t;
+        if (to < now - WEEKBURN_MEASURE_MS || to > now)
+            continue;
+        if (!seg.pts.some((p) => p.v >= WEEKBURN_FULL_WINDOW_PCT))
+            continue;
+        let first = null;
+        let last = null;
+        let fell = false;
+        for (const r of samples) {
+            if (r.w == null || r.t < from || r.t > to)
+                continue;
+            if (first == null)
+                first = r.w;
+            else if (last != null && r.w < last - 2)
+                fell = true; // the week reset inside: not a measurement
+            last = r.w;
+        }
+        if (first == null || last == null || fell)
+            continue;
+        const d = last - first;
+        if (d > 0 && (best == null || d > best))
+            best = d;
+    }
+    return best;
+}
+/** `3 days`, `5 h`, `40 min`, rounded; the only clock wording here (relative, so no zone is needed). */
+function inText(ms) {
+    const min = Math.max(0, Math.round(ms / MIN));
+    if (min < 90)
+        return `${min} min`;
+    const h = Math.round(min / 60);
+    if (h < 48)
+        return `${h} h`;
+    return `${Math.round(h / 24)} days`;
+}
+/** The week's pace carried to the reset, linear over this week's readings; null under six hours of them. */
+function projectedAtReset(samples, weeklyPct, weeklyResetAt, now) {
+    const segs = usageStretches(samples, "week");
+    const last = segs[segs.length - 1];
+    if (!last)
+        return null;
+    const pts = last.pts.filter((p) => p.t <= now);
+    if (pts.length < 2)
+        return null;
+    const a = pts[0];
+    const b = pts[pts.length - 1];
+    const span = b.t - a.t;
+    if (span < MIN_RATE_SPAN_MS)
+        return null;
+    const rate = Math.max(0, b.v - a.v) / span; // points per ms
+    const left = Math.max(0, weeklyResetAt - now);
+    return Math.min(100, Math.round((weeklyPct + rate * left) * 10) / 10);
+}
+export function weekBurnPlan(a) {
+    const { samples, weeklyPct, weeklyResetAt, stopPct, now } = a;
+    if (weeklyPct == null || weeklyResetAt == null || !Number.isFinite(weeklyPct) || !Number.isFinite(weeklyResetAt))
+        return null;
+    if (weeklyResetAt <= now)
+        return null;
+    const pts = ptsPerWindow(samples, now);
+    const projectedPct = projectedAtReset(samples, weeklyPct, weeklyResetAt, now);
+    const remaining = stopPct - weeklyPct;
+    let windows = null;
+    let raw;
+    let basis;
+    if (remaining <= 0) {
+        windows = 0;
+        raw = now;
+        basis = `The week is already at ${Math.round(weeklyPct)}%`;
+    }
+    else if (pts != null) {
+        windows = Math.ceil(remaining / pts);
+        raw = weeklyResetAt - windows * WEEKBURN_WINDOW_MS - WEEKBURN_MARGIN_MS;
+        basis = `${windows === 1 ? "One full 5 h window" : `${windows} full 5 h windows`} burn about ${Math.round(remaining)} points at the pace you measured (${Math.round(pts * 10) / 10} a window)`;
+    }
+    else {
+        raw = weeklyResetAt - WEEKBURN_FALLBACK_LEAD_MS;
+        basis = "No measured full window yet, so starting a day before reset";
+    }
+    const startAt = Math.max(now, Math.round(raw));
+    const reasonText = startAt <= now
+        ? `${basis}. Starting now.`
+        : `${basis}. Starting in ${inText(startAt - now)}.`;
+    return { startAt, windows, ptsPerWindow: pts, reasonText, projectedPct };
+}
+/** Whether the pick on file is for the week that resets at `weeklyResetAt` (RESET_MATCH_MS tolerance). */
+export function pickedFor(prefs, weeklyResetAt) {
+    if (prefs.weekOf == null || weeklyResetAt == null || prefs.repos.length === 0)
+        return false;
+    return Math.abs(prefs.weekOf - weeklyResetAt) <= RESET_MATCH_MS;
+}
+/**
+ * Null = a new row may be posted. Otherwise the sentence for why not. A
+ * missing or stale weekly reading never posts: `readingAt` is when the
+ * reading was taken (null = nobody read it).
+ */
+export function weekBurnStopText(a) {
+    const { weeklyPct, weeklyResetAt, stopPct, now } = a;
+    if (weeklyPct == null || weeklyResetAt == null)
+        return "Paused: no weekly reading yet.";
+    if (a.readingAt == null || now - a.readingAt > BUDGET_STALE_MS)
+        return "Paused: the weekly reading is out of date.";
+    if (weeklyPct >= stopPct)
+        return `Stopped: week at ${Math.round(weeklyPct)}%.`;
+    if (now >= weeklyResetAt - WEEKBURN_STOP_BEFORE_RESET_MS)
+        return "Stopped: the week resets within 20 min.";
+    return null;
+}
+/**
+ * The once-a-week push, or null. Words only: it asks, it starts nothing.
+ * `nudgedWeekOf` is the reset the last nudge was sent for (once per week).
+ */
+export function weekBurnNudge(a) {
+    const { prefs, weeklyPct, weeklyResetAt, now } = a;
+    if (!a.subscription || weeklyPct == null || weeklyResetAt == null)
+        return null;
+    if (a.readingAt == null || now - a.readingAt > BUDGET_STALE_MS)
+        return null;
+    if (pickedFor(prefs, weeklyResetAt))
+        return null;
+    if (a.nudgedWeekOf != null && Math.abs(a.nudgedWeekOf - weeklyResetAt) <= RESET_MATCH_MS)
+        return null;
+    if (weeklyPct >= prefs.stopPct || weeklyResetAt <= now)
+        return null;
+    const plan = weekBurnPlan({ samples: a.samples, weeklyPct, weeklyResetAt, stopPct: prefs.stopPct, now });
+    if (!plan || now < plan.startAt - WEEKBURN_NUDGE_LEAD_MS)
+        return null;
+    if (prefs.recurring) {
+        return { title: "Pick this week's repos", body: `The week-end burn is on repeat, but each week needs its own pick. The week resets in ${inText(weeklyResetAt - now)}.` };
+    }
+    const p = plan.projectedPct;
+    if (p == null || p >= prefs.stopPct - WEEKBURN_NUDGE_GAP_PCT)
+        return null;
+    const unused = Math.round(100 - p);
+    return {
+        title: "Budget left over this week",
+        body: `On pace to leave ~${unused}% of this week unused (resets in ${inText(weeklyResetAt - now)}). Pick repos for the week-end burn?`,
+    };
+}
+/** What an unattended burn package is told. One improvement, one commit, nothing pushed. */
+export function weekBurnItemPrompt(a) {
+    const health = a.healthSummary && a.healthSummary.trim()
+        ? `Latest repo readings:\n${a.healthSummary.trim()}\n\nPick the weakest reading.`
+        : "Look for the repo's own checks, tests and lint, and pick the weakest area.";
+    return [
+        `This is an unattended week-end burn package for ${a.repoName}. Nobody is watching, so keep it small.`,
+        health,
+        "Make ONE focused improvement. Run the repo's tests. Commit on the current branch only if they pass: stage explicit paths, never `git add -A`, never push, never stash or reset.",
+        "If nothing worth doing is left, change nothing and say so in one line.",
+    ].join("\n\n");
+}
+//# sourceMappingURL=weekburn.js.map

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

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

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

@@ -0,0 +1,7 @@
+/** The share of the window the first request must take before it is worth a sentence. */
+export declare const ADVICE_SHARE = 0.25;
+/**
+ * The sentence, or null when either number is unmeasured or the share is too
+ * small to matter. Pure; both ends word it through here.
+ */
+export declare function windowAdviceText(windowTok: unknown, overheadTok: unknown): string | null;

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

@@ -0,0 +1,50 @@
+/**
+ * **How much of a small model's window Claude Code itself takes, said in words.**
+ *
+ * Measured 2026-10-01 (`docs/analysis/spikes/2026-10-01-claude-local.md`): the
+ * real `claude` CLI pointed at a local runner sends ~34k tokens of its own
+ * system prompt, tool schemas and instructions with the very first message —
+ * over half of a 64k Ollama window — before the person has typed a word worth
+ * the name. Nobody choosing that model in the picker could have known.
+ *
+ * Both numbers are MEASUREMENTS and both must be present, or there is no
+ * sentence at all:
+ *
+ *  - `windowTok` — what the runner is configured to hold (`num_ctx`, or the
+ *    endpoint's configured window), never claude's 200k table;
+ *  - `overheadTok` — the input of the FIRST request of the most recent
+ *    conversation that ran this model, read off the CLI's own log. It includes
+ *    that first message, which is why the sentence says "the first request" and
+ *    never claims a number for the instructions alone.
+ *
+ * Silent below `ADVICE_SHARE`: a 200k window giving 34k to the CLI is the
+ * normal shape of every claude session and saying so under every model would
+ * be furniture. Absent beats borrowed — an unmeasured overhead is never
+ * guessed from another model's.
+ */
+import { fmtCount } from "./tokens.js";
+/** The share of the window the first request must take before it is worth a sentence. */
+export const ADVICE_SHARE = 0.25;
+/** A positive, finite whole number of tokens, or null. */
+function tok(n) {
+    return typeof n === "number" && Number.isFinite(n) && n > 0 ? Math.floor(n) : null;
+}
+/**
+ * The sentence, or null when either number is unmeasured or the share is too
+ * small to matter. Pure; both ends word it through here.
+ */
+export function windowAdviceText(windowTok, overheadTok) {
+    const w = tok(windowTok);
+    const o = tok(overheadTok);
+    if (w === null || o === null)
+        return null;
+    const share = o / w;
+    if (share < ADVICE_SHARE)
+        return null;
+    const left = w - o;
+    const whole = `${fmtCount(w)} window, ~${fmtCount(o)} of it used by the first request of the last session on this model (mostly Claude Code's own instructions and tools)`;
+    if (left <= 0)
+        return `${whole} — that is the whole window, so the runner will cut the prompt. Pick a model with a larger window.`;
+    return `${whole} — ~${fmtCount(left)} is left for the conversation.`;
+}
+//# sourceMappingURL=windowadvice.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"windowadvice.js","sourceRoot":"","sources":["../src/windowadvice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,yFAAyF;AACzF,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AAEjC,0DAA0D;AAC1D,SAAS,GAAG,CAAC,CAAU;IACrB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAkB,EAAE,WAAoB;IACvE,MAAM,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IACzB,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,IAAI,KAAK,GAAG,YAAY;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,MAAM,KAAK,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,CAAC,CAAC,CAAC,sHAAsH,CAAC;IAC3K,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,GAAG,KAAK,oGAAoG,CAAC;IACnI,OAAO,GAAG,KAAK,OAAO,QAAQ,CAAC,IAAI,CAAC,gCAAgC,CAAC;AACvE,CAAC"}

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

@@ -0,0 +1,64 @@
+/**
+ * Always-on context on the wire: what the first request of ONE conversation carried, as the CLI
+ * logged it (`SessionCarried`, on `ContextSeriesDoc.carried`), and what a repo plus this desktop
+ * will put in every turn (`RepoInstructionsDoc`, on `ComplianceReport.instructions`).
+ *
+ * Chars are the fact; tokens per part are an estimate (`~chars / CHARS_PER_TOKEN`) and only ever
+ * worded as one. Everything here degrades to ABSENT, never to a wrong number: a log whose head held
+ * no attachment record and no answered request has no `carried` (a log capped past `MAX_READ` still
+ * has it — the log is read from byte 0), an unsized row (an MCP server) has no chars.
+ */
+import type { InstructionFile } from "../agentfiles.js";
+/**
+ * One always-on source the first request of a conversation carried, as the CLI logged it.
+ * The order of this union is the display order (`CARRIED_KINDS`).
+ */
+export type CarriedKind = "instructions" | "skill_listing" | "mcp_instructions" | "deferred_tools" | "agent_listing" | "hook_context" | "system_prompt" | "tool_schemas";
+/** `CarriedKind` in display order. */
+export declare const CARRIED_KINDS: readonly CarriedKind[];
+export interface CarriedPart {
+    kind: CarriedKind;
+    /** Characters of the text the CLI attached — the FACT. Tokens are an estimate (~chars/4) and only ever worded as one. */
+    chars: number;
+    /** How many items (files, skills, servers, tool names, agent types). Absent where the record has none. */
+    count?: number;
+    /** Names, capped at CARRIED_NAMES_CAP (64) — the skill listing's names, the MCP servers, the agent types. */
+    names?: string[];
+    /** `instructions` only: the files and the CLI's own type word (User | Project | AutoMem | …). */
+    files?: {
+        path: string;
+        type: string;
+        chars: number;
+    }[];
+    /** True for the two parts read off `prompt_snapshot`, an UNDOCUMENTED record: present on this CLI, maybe not on the next. */
+    undocumented?: true;
+}
+export interface SessionCarried {
+    /** The whole first request in tokens: usage.input + cache_creation + cache_read of the first assistant record. Null before the first answer. */
+    firstRequestTok: number | null;
+    firstRequestAt: number | null;
+    parts: CarriedPart[];
+    /**
+     * How many KINDS (never records) changed AFTER the first request (an MCP connecting late, a skill
+     * listing refresh) — noted, never folded in. Not a change: per-turn hook context, or a record
+     * identical to one of the initial set (a `--resume` re-attaching it).
+     */
+    laterDeltas: number;
+    /** Those kinds, in `CARRIED_KINDS` order. Absent from an older host, or when none changed. */
+    laterKinds?: CarriedKind[];
+}
+export declare const CARRIED_NAMES_CAP = 64;
+/** What the Setup sheet / Always-on view list for one repo: the widened inventory plus this desktop's rows. */
+export interface RepoInstructionsDoc {
+    /** Repo rows (`scope` absent). */
+    files: InstructionFile[];
+    /** This desktop's rows (`scope: "desktop"`); null = could not be read, `desktopWhy` says why. */
+    desktop: InstructionFile[] | null;
+    desktopWhy?: string;
+    /** The memory file this repo's sessions get (its slug), for the sentence. */
+    memoryPath?: string;
+    /** The CLI config dir desktop paths are relative to, as words (`~/.claude`, or `CLAUDE_CONFIG_DIR`). Absent from an older host: `desktopPathWords` assumes `~/.claude`. */
+    configDir?: string;
+    /** Set when building this list threw on the host: `files` is then empty and `desktop` null — a failed read, not an older host. */
+    why?: string;
+}

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

@@ -0,0 +1,7 @@
+/** `CarriedKind` in display order. */
+export const CARRIED_KINDS = [
+    "instructions", "skill_listing", "mcp_instructions", "deferred_tools",
+    "agent_listing", "hook_context", "system_prompt", "tool_schemas",
+];
+export const CARRIED_NAMES_CAP = 64;
+//# sourceMappingURL=alwayson.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alwayson.js","sourceRoot":"","sources":["../../src/wire/alwayson.ts"],"names":[],"mappings":"AAmBA,sCAAsC;AACtC,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB;IACrE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc;CACjE,CAAC;AA+BF,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC"}