@contraagent/ui 0.0.0-stage → 0.1.0

package/dist/lib/labels.d.ts

@@ -0,0 +1,103 @@
+import { type Hop, type Outcome, type PlanNode, type TaskOutcome } from '@contraagent/api';
+/** What happened to a task. */
+export declare function outcomeLabel(o: Outcome): string;
+/** What happened to a task, in a run that is `live` or over: a task still waiting when the run ended is "not run". */
+export declare const taskStatusLabel: (o: Outcome, live: boolean) => string;
+/**
+ * Why a waiting task has not run, as a phrase that starts in lower case: the
+ * earlier task it waits for (`waits for output of review · zeta`), or how many
+ * (`waits for output of 3 earlier tasks`); '' for none.
+ */
+export declare function waitCause(waits: readonly {
+    kind?: string | null;
+    unit?: string | null;
+}[]): string;
+/** A plan node's state (the task matrix, progress by kind). */
+export declare const planStateLabel: (s: PlanNode["state"]) => string;
+/**
+ * How many tasks are in a state, number first: "3 failed", "2 not started".
+ * A count only: a cause ("review · zeta failed") has its own message.
+ * `not_run`: waiting when the run ended.
+ */
+export declare function stateCount(s: Outcome | 'not_run', n: number): string;
+/**
+ * How one attempt ended (a journal row's `stop`), in words. A value contraagent does not write is shown as it is.
+ * With the row's `reason`, a refused input names its problem (missing, or failed checks).
+ */
+export declare function stopLabel(stop: string | null | undefined, reason?: string | null): string;
+/** The attempt as the reader counts it: "Attempt 1", "Attempt 2" ... (`JournalRow.attempt` is 0-based). */
+export declare const attemptLabel: (attempt: number | null | undefined) => string;
+/**
+ * The names of one task's attempts that ran (its journal rows in order): "Attempt 1",
+ * and "Attempt 1 | resumed run" for an attempt of a later start of the run (`runStarts`).
+ * Where two names are still the same (a run resumed more than once), each also gets
+ * the time its attempt ended.
+ */
+export declare function attemptNames(rows: readonly {
+    attempt?: number | null | undefined;
+    ts: string;
+}[]): string[];
+/** A loop's pass (`flow[].loops[].pass`), as the reader counts it: "Pass 1", "Pass 2" ... (never an attempt). */
+export declare const passLabel: (pass: number) => string;
+/** A loop box's pass count: "1 pass", "up to 3 passes" (its loop's last pass). */
+export declare const passCount: (n: number) => string;
+/** How many passes a unit ran: "1 pass", "3 passes". */
+export declare const passesRan: (n: number) => string;
+/** How many units ran each number of passes of a loop: "1 pass: 4 | 2 passes: 1". */
+export declare const passSpread: (spread: readonly (readonly [number, number])[]) => string;
+/** A loop of the flow (a loop box, a breadcrumb level). */
+export declare const loopLabel: () => string;
+/** `1 correction`, `3 corrections`; '' for none. */
+export declare function correctionsText(n: number): string;
+/** A credential as the reader knows it: the built-in `ambient` shows as "default". */
+export declare const credentialLabel: (c: string | null | undefined) => string;
+/** What a credential's label leaves out, for its tooltip: the built-in `ambient` is the local credentials. */
+export declare const credentialTip: (c: string | null | undefined) => string;
+/**
+ * A model switch in words, the one form every view uses:
+ * `primary-model (rate limited) → fallback-model`; '' for a single hop.
+ * With `time`, the attempt's time follows: `... → fallback-model | 0.2s`.
+ */
+export declare function modelSwitch(hops: readonly Hop[] | null | undefined, time?: number | null): string;
+/** One input a task was refused for, read from its `invalid input: ...` reason. */
+export interface InputProblem {
+    /** The file, as the reason gives it (absolute). */
+    path: string;
+    /** The key of the task that writes it, when the reason names one. */
+    producer: string;
+    /** `missing`: the file is not there; `checks`: it is there and failed its checks. */
+    problem: 'missing' | 'checks';
+}
+/**
+ * The inputs a refused task's reason names (`invalid input: input from <key> is
+ * missing: <path>`, `invalid input: <path>: required input is missing`,
+ * `invalid input: <path>: <check error>`), in order; [] for any other reason.
+ */
+export declare function inputProblems(reason: string | null | undefined): InputProblem[];
+/** The task that writes an input, as far as the run knows it. */
+export interface InputSource {
+    /** `kind · unit`. */
+    name: string;
+    /** What happened to it, when known. */
+    outcome?: Outcome | undefined;
+}
+/**
+ * Why an input stopped a task, in one phrase that starts in lower case:
+ * `input out/review/zeta.json is missing because review · zeta failed`,
+ * `input out/a.json failed checks`. `path` is already shown run-relative.
+ */
+export declare function inputCause(path: string, problem: InputProblem['problem'], from?: InputSource): string;
+/**
+ * Why a task did not start, as a phrase after "Not started: ": the input its
+ * refusal names and why that input is not ready (`input out/review/zeta.json is
+ * missing because review · zeta failed`), or the earlier task that failed and
+ * stopped it (`earlier task review · zeta failed`); '' when the run does not tell.
+ * `writerOf` names the task that writes a path, for a reason that names none.
+ */
+export declare function notStartedCause(t: Pick<TaskOutcome, 'attempts' | 'cause'>, outcomes: ReadonlyMap<string, TaskOutcome>, run: string, writerOf?: (path: string) => string | undefined): string;
+/**
+ * A text from the run (a failure reason) with absolute paths inside the run
+ * directory cut to the part after `runs/<run>/`: `out/summarize/zeta.json`.
+ */
+export declare function runRelative(text: string | null | undefined, run: string): string;
+//# sourceMappingURL=labels.d.ts.map

package/dist/lib/labels.d.ts.map

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

package/dist/lib/labels.js

@@ -0,0 +1,249 @@
+// The words the UI shows for run data, in the reader's terms. The code's own
+// terms (stop values, plan states, round, hop, attempt ...) stay in the data and
+// in tooltips; what the reader sees comes from here, so every screen says the
+// same thing for the same state. The mapping is documented in AGENTS.md
+// ("Words the UI shows").
+import { isFinished, planOutcome, runStarts } from '@contraagent/api';
+import { msg, str } from '@lit/localize';
+import { facts, fmtDur, kindUnit, localTime } from './format.js';
+import { isStop } from './tone.js';
+/** What happened to a task. */
+export function outcomeLabel(o) {
+    switch (o) {
+        case 'done':
+            return msg('done');
+        case 'recovered':
+            return msg('done after retrying');
+        case 'failed':
+            return msg('failed');
+        case 'not_started':
+            return msg('not started');
+        case 'running':
+            return msg('running');
+        case 'waiting':
+            return msg('waiting');
+        case 'skipped':
+            return msg('skipped');
+    }
+}
+/** What happened to a task, in a run that is `live` or over: a task still waiting when the run ended is "not run". */
+export const taskStatusLabel = (o, live) => (o === 'waiting' && !live ? msg('not run') : outcomeLabel(o));
+/**
+ * Why a waiting task has not run, as a phrase that starts in lower case: the
+ * earlier task it waits for (`waits for output of review · zeta`), or how many
+ * (`waits for output of 3 earlier tasks`); '' for none.
+ */
+export function waitCause(waits) {
+    const first = waits[0];
+    if (!first)
+        return '';
+    return waits.length === 1 ? msg(str `waits for output of ${kindUnit(first)}`) : msg(str `waits for output of ${waits.length} earlier tasks`);
+}
+/** A plan node's state (the task matrix, progress by kind). */
+export const planStateLabel = (s) => outcomeLabel(planOutcome(s));
+/**
+ * How many tasks are in a state, number first: "3 failed", "2 not started".
+ * A count only: a cause ("review · zeta failed") has its own message.
+ * `not_run`: waiting when the run ended.
+ */
+export function stateCount(s, n) {
+    switch (s) {
+        case 'done':
+            return msg(str `${n} done`);
+        case 'recovered':
+            return msg(str `${n} done after retrying`);
+        case 'failed':
+            return msg(str `${n} failed`);
+        case 'not_started':
+            return msg(str `${n} not started`);
+        case 'running':
+            return msg(str `${n} running`);
+        case 'waiting':
+            return msg(str `${n} waiting`);
+        case 'skipped':
+            return msg(str `${n} skipped`);
+        case 'not_run':
+            return msg(str `${n} not run`);
+    }
+}
+/**
+ * How one attempt ended (a journal row's `stop`), in words. A value contraagent does not write is shown as it is.
+ * With the row's `reason`, a refused input names its problem (missing, or failed checks).
+ */
+export function stopLabel(stop, reason) {
+    if (!stop)
+        return '—';
+    return isStop(stop) ? knownStopLabel(stop, reason) : msg(str `unknown (${stop})`);
+}
+/** A stop contraagent writes, in words: every `Stop` has a case, or this fails type-checking. */
+function knownStopLabel(stop, reason) {
+    switch (stop) {
+        case 'completed':
+            return msg('done');
+        case 'skipped':
+            return msg('skipped');
+        case 'invalid_input': {
+            const kinds = new Set(inputProblems(reason).map((p) => p.problem));
+            if (kinds.size === 1 && kinds.has('missing'))
+                return msg('not started (input missing)');
+            if (kinds.size === 1 && kinds.has('checks'))
+                return msg('not started (input failed checks)');
+            return msg('not started (input missing or failed checks)');
+        }
+        case 'invalid_output':
+            return msg('failed checks');
+        case 'timeout':
+            return msg('timed out');
+        case 'max_turns':
+            return msg('turn limit reached');
+        case 'budget':
+            return msg('cost limit reached');
+        case 'context_budget':
+            return msg('context limit reached');
+        case 'stalled':
+            return msg('stalled (no output)');
+        case 'auth_failed':
+            return msg('authentication failed');
+        case 'api_error':
+            return msg('API error');
+        case 'rate_limited':
+            return msg('rate limited');
+        case 'refused':
+            return msg('refused by the model');
+        case 'aborted':
+            return msg('aborted');
+        case 'denied':
+            return msg('permission denied');
+        case 'error':
+            return msg('error');
+        case 'no_output':
+            return msg('ended without a result');
+        case 'launch_failed':
+            return msg('could not start the agent');
+        case 'credential_mismatch':
+            return msg('wrong identity used');
+    }
+}
+/** The attempt as the reader counts it: "Attempt 1", "Attempt 2" ... (`JournalRow.attempt` is 0-based). */
+export const attemptLabel = (attempt) => msg(str `Attempt ${(attempt ?? 0) + 1}`);
+/**
+ * The names of one task's attempts that ran (its journal rows in order): "Attempt 1",
+ * and "Attempt 1 | resumed run" for an attempt of a later start of the run (`runStarts`).
+ * Where two names are still the same (a run resumed more than once), each also gets
+ * the time its attempt ended.
+ */
+export function attemptNames(rows) {
+    const starts = runStarts(rows);
+    const names = rows.map((r, i) => (starts[i] ? facts(attemptLabel(r.attempt), msg('resumed run')) : attemptLabel(r.attempt)));
+    return names.map((n, i) => (names.indexOf(n) === names.lastIndexOf(n) ? n : facts(n, localTime(rows[i]?.ts))));
+}
+/** A loop's pass (`flow[].loops[].pass`), as the reader counts it: "Pass 1", "Pass 2" ... (never an attempt). */
+export const passLabel = (pass) => msg(str `Pass ${pass}`);
+/** A loop box's pass count: "1 pass", "up to 3 passes" (its loop's last pass). */
+export const passCount = (n) => (n <= 1 ? msg('1 pass') : msg(str `up to ${n} passes`));
+/** How many passes a unit ran: "1 pass", "3 passes". */
+export const passesRan = (n) => (n <= 1 ? msg('1 pass') : msg(str `${n} passes`));
+/** How many units ran each number of passes of a loop: "1 pass: 4 | 2 passes: 1". */
+export const passSpread = (spread) => spread.map(([n, units]) => (n <= 1 ? msg(str `1 pass: ${units}`) : msg(str `${n} passes: ${units}`))).join(' | ');
+/** A loop of the flow (a loop box, a breadcrumb level). */
+export const loopLabel = () => msg('loop');
+/** `1 correction`, `3 corrections`; '' for none. */
+export function correctionsText(n) {
+    if (n <= 0)
+        return '';
+    return n === 1 ? msg('1 correction') : msg(str `${n} corrections`);
+}
+/** A credential as the reader knows it: the built-in `ambient` shows as "default". */
+export const credentialLabel = (c) => (!c ? '' : c === 'ambient' ? msg('default') : c);
+/** What a credential's label leaves out, for its tooltip: the built-in `ambient` is the local credentials. */
+export const credentialTip = (c) => (c === 'ambient' ? msg('local credentials (ambient)') : '');
+/** One hop's model, or its route when the journal names no model. */
+const hopModel = (h) => h.model || h.route || '—';
+/**
+ * A model switch in words, the one form every view uses:
+ * `primary-model (rate limited) → fallback-model`; '' for a single hop.
+ * With `time`, the attempt's time follows: `... → fallback-model | 0.2s`.
+ */
+export function modelSwitch(hops, time) {
+    if (!hops || hops.length < 2)
+        return '';
+    const steps = hops.map((h, i) => (i < hops.length - 1 ? msg(str `${hopModel(h)} (${stopLabel(h.stop)})`) : hopModel(h)));
+    const chain = steps.join(' → ');
+    return time === undefined || time === null ? chain : `${chain} | ${fmtDur(time)}`;
+}
+/**
+ * The inputs a refused task's reason names (`invalid input: input from <key> is
+ * missing: <path>`, `invalid input: <path>: required input is missing`,
+ * `invalid input: <path>: <check error>`), in order; [] for any other reason.
+ */
+export function inputProblems(reason) {
+    const m = /^invalid input:\s*(.*)$/s.exec(reason || '');
+    if (!m)
+        return [];
+    const out = [];
+    for (const part of (m[1] ?? '').split('; ')) {
+        let x = /^input from (\S+) is missing: (\S+)/.exec(part);
+        if (x) {
+            out.push({ path: x[2] ?? '', producer: x[1] ?? '', problem: 'missing' });
+            continue;
+        }
+        x = /^(\S+?): required input is missing/.exec(part);
+        if (x) {
+            out.push({ path: x[1] ?? '', producer: '', problem: 'missing' });
+            continue;
+        }
+        x = /^(\S+?): /.exec(part);
+        if (x && !out.some((o) => o.path === x?.[1]))
+            out.push({ path: x[1] ?? '', producer: '', problem: 'checks' });
+    }
+    return out;
+}
+/**
+ * Why an input stopped a task, in one phrase that starts in lower case:
+ * `input out/review/zeta.json is missing because review · zeta failed`,
+ * `input out/a.json failed checks`. `path` is already shown run-relative.
+ */
+export function inputCause(path, problem, from) {
+    if (problem === 'checks')
+        return from ? msg(str `input ${path} from ${from.name} failed checks`) : msg(str `input ${path} failed checks`);
+    if (!from)
+        return msg(str `input ${path} is missing`);
+    if (from.outcome === 'failed')
+        return msg(str `input ${path} is missing because ${from.name} failed`);
+    if (from.outcome === 'not_started')
+        return msg(str `input ${path} is missing because ${from.name} did not start`);
+    if (from.outcome && isFinished(from.outcome))
+        return msg(str `input ${path} from ${from.name} is missing`);
+    return msg(str `input ${path} is missing because ${from.name} did not finish`);
+}
+/**
+ * Why a task did not start, as a phrase after "Not started: ": the input its
+ * refusal names and why that input is not ready (`input out/review/zeta.json is
+ * missing because review · zeta failed`), or the earlier task that failed and
+ * stopped it (`earlier task review · zeta failed`); '' when the run does not tell.
+ * `writerOf` names the task that writes a path, for a reason that names none.
+ */
+export function notStartedCause(t, outcomes, run, writerOf) {
+    const last = t.attempts[t.attempts.length - 1];
+    if (last?.stop === 'invalid_input') {
+        const p = inputProblems(last.reason)[0];
+        if (!p)
+            return runRelative(last.reason, run);
+        const key = p.producer || writerOf?.(p.path) || '';
+        const w = key ? outcomes.get(key) : undefined;
+        return inputCause(runRelative(p.path, run), p.problem, w ? { name: kindUnit(w), outcome: w.outcome } : undefined);
+    }
+    const c = t.cause ? outcomes.get(t.cause) : undefined;
+    return c ? msg(str `earlier task ${kindUnit(c)} failed`) : '';
+}
+/**
+ * A text from the run (a failure reason) with absolute paths inside the run
+ * directory cut to the part after `runs/<run>/`: `out/summarize/zeta.json`.
+ */
+export function runRelative(text, run) {
+    if (!text || !run)
+        return text ?? '';
+    const esc = run.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return text.replace(new RegExp(`(?:/[^\\s:'"]*)?/${esc}/`, 'g'), '');
+}
+//# sourceMappingURL=labels.js.map

package/dist/lib/labels.js.map

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

package/dist/lib/markdown.d.ts

@@ -0,0 +1,13 @@
+export declare function md(text: string | null | undefined): string;
+/** A markdown file as a person reads it: its `---` front matter as a small table, then the body. */
+export declare function mdFile(text: string | null | undefined, mark?: (html: string) => string): string;
+/** `$unit` and `{{contract}}` picked out of an instructions template (escaped source). */
+export declare function instructionsHtml(text: string): string;
+/** The same, on already-rendered HTML. */
+export declare const markInstructions: (html: string) => string;
+/** A prompt's leading `TELEMETRY ...` line (which run and task it belongs to), apart from its prose. */
+export declare function splitTelemetry(text: string): {
+    telemetry: string;
+    body: string;
+};
+//# sourceMappingURL=markdown.d.ts.map

package/dist/lib/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/lib/markdown.ts"],"names":[],"mappings":"AA8CA,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CA2C1D;AAED,oGAAoG;AACpG,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAiB/F;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAG4B,CAAC;AAE7E,wGAAwG;AACxG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAGhF"}

package/dist/lib/markdown.js

@@ -0,0 +1,118 @@
+// Markdown: what agents and plugin files actually use. Everything is escaped
+// first, so nothing the model or a file wrote can inject markup; links keep
+// only http(s) targets. Returns HTML for `unsafeHTML`.
+import { esc } from '../words/format.js';
+import { highlight } from './highlight.js';
+function mdInline(t) {
+    return t
+        .replace(/`([^`\n]+)`/g, '<code>$1</code>')
+        .replace(/\*\*([^*\n]+)\*\*/g, '<b>$1</b>')
+        .replace(/(^|[^*\w])\*([^*\n]+)\*(?!\w)/g, '$1<i>$2</i>')
+        .replace(/\[([^\]\n]+)\]\((https?:\/\/[^)\s]+)\)/g, '<a class="lnk" href="$2" target="_blank" rel="noopener">$1</a>');
+}
+/** Text and fenced code; an unclosed fence (a live stream) runs to the end. */
+function mdSplit(text) {
+    const out = [];
+    let pos = 0;
+    for (;;) {
+        const open = text.indexOf('```', pos);
+        if (open < 0) {
+            out.push({ t: 'text', s: text.slice(pos) });
+            return out;
+        }
+        out.push({ t: 'text', s: text.slice(pos, open) });
+        const nl = text.indexOf('\n', open + 3);
+        const lang = text.slice(open + 3, nl < 0 ? text.length : nl).trim();
+        const start = nl < 0 ? text.length : nl + 1;
+        const close = text.indexOf('```', start);
+        if (close < 0) {
+            out.push({ t: 'code', s: text.slice(start), lang });
+            return out;
+        }
+        out.push({ t: 'code', s: text.slice(start, close), lang });
+        pos = close + 3;
+    }
+}
+const TABLE_ROW = /^\s*\|.*\|\s*$/;
+export function md(text) {
+    return mdSplit(String(text || ''))
+        .map((seg) => {
+        if (seg.t === 'code')
+            return `<pre><code class="hl">${highlight(seg.s, seg.lang)}</code></pre>`;
+        const lines = esc(seg.s).split('\n');
+        const out = [];
+        for (let k = 0; k < lines.length; k++) {
+            const line = lines[k] ?? '';
+            let m;
+            if ((m = line.match(/^(#{1,6})\s+(.*)$/))) {
+                out.push(`<div class="md-h md-h${Math.min(m[1].length, 4)}">${mdInline(m[2])}</div>`);
+            }
+            else if (/^\s*(-{3,}|\*{3,})\s*$/.test(line)) {
+                out.push('<hr class="md-hr">');
+            }
+            else if ((m = line.match(/^\s*&gt;\s?(.*)$/))) {
+                out.push(`<div class="md-q">${mdInline(m[1])}</div>`);
+            }
+            else if ((m = line.match(/^\s*[-*]\s+(.*)$/))) {
+                out.push(`<div class="md-li">${mdInline(m[1])}</div>`);
+            }
+            else if ((m = line.match(/^\s*(\d+)[.)]\s+(.*)$/))) {
+                out.push(`<div class="md-li md-ol"><span class="md-n">${m[1]}.</span>${mdInline(m[2])}</div>`);
+            }
+            else if (TABLE_ROW.test(line) && /^\s*\|[\s:|-]+\|\s*$/.test(lines[k + 1] ?? '')) {
+                const cells = (l) => l
+                    .trim()
+                    .replace(/^\||\|$/g, '')
+                    .split('|')
+                    .map((c) => mdInline(c.trim()));
+                const head = cells(line);
+                k += 2;
+                const rows = [];
+                while (k < lines.length && TABLE_ROW.test(lines[k] ?? ''))
+                    rows.push(cells(lines[k++] ?? ''));
+                k--;
+                out.push(`<table class="md-t"><tr>${head.map((c) => `<th>${c}</th>`).join('')}</tr>` +
+                    rows.map((r) => `<tr>${r.map((c) => `<td>${c}</td>`).join('')}</tr>`).join('') +
+                    '</table>');
+            }
+            else {
+                out.push(line.trim() === '' ? '<div class="md-gap"></div>' : `<div class="md-p">${mdInline(line)}</div>`);
+            }
+        }
+        return out.join('');
+    })
+        .join('');
+}
+/** A markdown file as a person reads it: its `---` front matter as a small table, then the body. */
+export function mdFile(text, mark) {
+    const src = String(text || '');
+    const m = src.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    let front = '';
+    let body = src;
+    if (m) {
+        body = m[2] ?? '';
+        const rows = (m[1] ?? '')
+            .split('\n')
+            .map((l) => l.match(/^([\w-]+):\s*(.*)$/))
+            .filter((x) => !!x)
+            .map(([, k, v]) => `<tr><td class="jmono">${esc(k)}</td><td>${esc(v)}</td></tr>`)
+            .join('');
+        front = rows ? `<table class="md-front">${rows}</table>` : '';
+    }
+    const html = md(body);
+    return `<div class="md-doc">${front}${mark ? mark(html) : html}</div>`;
+}
+/** `$unit` and `{{contract}}` picked out of an instructions template (escaped source). */
+export function instructionsHtml(text) {
+    return markInstructions(esc(text));
+}
+/** The same, on already-rendered HTML. */
+export const markInstructions = (html) => html
+    .replace(/\$\{?([A-Za-z_]\w*)\}?/g, '<span class="pv">$&</span>')
+    .replace(/\{\{contract\}\}/g, '<span class="pv pc">{{contract}}</span>');
+/** A prompt's leading `TELEMETRY ...` line (which run and task it belongs to), apart from its prose. */
+export function splitTelemetry(text) {
+    const m = text.match(/^(TELEMETRY [^\n]*)\n+([\s\S]*)$/);
+    return m ? { telemetry: m[1] ?? '', body: m[2] ?? '' } : { telemetry: '', body: text };
+}
+//# sourceMappingURL=markdown.js.map

package/dist/lib/markdown.js.map

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

package/dist/lib/memory.d.ts

@@ -0,0 +1,27 @@
+/** The value remembered under `id` in the current history entry. */
+export declare function recall<T>(id: string): T | undefined;
+/** Remember `value` under `id` in the current history entry (written shortly after, batched). */
+export declare function remember(id: string, value: unknown): void;
+/** Write what is pending now: before the page pushes a new entry, so it lands on the old one. */
+export declare function flushMemory(): void;
+/** A set of ids remembered under `id` (open cards, folds). */
+export declare class RememberedSet {
+    private readonly id;
+    private readonly items;
+    constructor(id: string);
+    has(x: string): boolean;
+    set(x: string, on: boolean): void;
+}
+/**
+ * A set of ids kept for this browser tab (sessionStorage) rather than one
+ * history entry: state that belongs to a thing shown on several entries, such
+ * as the tool cards open in a transcript. A reload keeps it.
+ */
+export declare class SessionSet {
+    private readonly id;
+    private readonly items;
+    constructor(id: string);
+    has(x: string): boolean;
+    set(x: string, on: boolean): void;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/lib/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/lib/memory.ts"],"names":[],"mappings":"AA6CA,oEAAoE;AACpE,wBAAgB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAInD;AAED,iGAAiG;AACjG,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAOzD;AAED,iGAAiG;AACjG,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAID,8DAA8D;AAC9D,qBAAa,aAAa;IAEZ,OAAO,CAAC,QAAQ,CAAC,EAAE;IAD/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBACP,EAAE,EAAE,MAAM;IAGvC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAGvB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI;CAMlC;AAED;;;;GAIG;AACH,qBAAa,UAAU;IAET,OAAO,CAAC,QAAQ,CAAC,EAAE;IAD/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBACP,EAAE,EAAE,MAAM;IASvC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAGvB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI;CAUlC"}