@contraagent/api 0.0.0-stage → 0.1.0

package/dist/feed.d.ts

@@ -0,0 +1,27 @@
+import type { RunFeedMessage, StreamPage } from './types.js';
+/** Every SSE event name of `/events` with a fixed meaning; panels add `panel:<name>`. */
+export declare const RUN_EVENT_NAMES: readonly ["journal", "procs", "plan", "outputs", "cursor", "ready"];
+export interface FeedHandlers<M> {
+    message(msg: M): void;
+    /** The connection opened, or re-opened after a drop (the server then starts over). */
+    open?(): void;
+    /** The connection dropped; the browser retries on its own. */
+    error?(): void;
+}
+export interface FeedOptions {
+    /** Where the monitor is served, as for the client; '' (the default) is the page's own origin. */
+    baseUrl?: string;
+    /** For tests and non-browser hosts. */
+    EventSource?: typeof globalThis.EventSource;
+}
+/** A feed to stop. */
+export type Unsubscribe = () => void;
+/**
+ * `/events?run=`: the run, live. The server replays the whole journal on every
+ * (re)connect and then sends `ready`; `panels` are the panel names from
+ * `/api/info` to listen for.
+ */
+export declare function openRunFeed(run: string, panels: readonly string[], on: FeedHandlers<RunFeedMessage>, opts?: FeedOptions): Unsubscribe;
+/** `/events/stream`: one transcript, tailed. The first page is the tail; each later one only what is new. */
+export declare function openStreamFeed(run: string, key: string, on: FeedHandlers<StreamPage>, opts?: FeedOptions): Unsubscribe;
+//# sourceMappingURL=feed.d.ts.map

package/dist/feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3E,yFAAyF;AACzF,eAAO,MAAM,eAAe,qEAOgB,CAAC;AAO7C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;IACtB,sFAAsF;IACtF,IAAI,CAAC,IAAI,IAAI,CAAC;IACd,8DAA8D;IAC9D,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,UAAU,CAAC,WAAW,CAAC;CAC7C;AAED,sBAAsB;AACtB,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAkBrC;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,EAAE,EAAE,YAAY,CAAC,cAAc,CAAC,EAChC,IAAI,GAAE,WAAgB,GACrB,WAAW,CAGb;AAED,6GAA6G;AAC7G,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,YAAY,CAAC,UAAU,CAAC,EAC5B,IAAI,GAAE,WAAgB,GACrB,WAAW,CAOb"}

package/dist/feed.js

@@ -0,0 +1,39 @@
+/** Every SSE event name of `/events` with a fixed meaning; panels add `panel:<name>`. */
+export const RUN_EVENT_NAMES = [
+    'journal',
+    'procs',
+    'plan',
+    'outputs',
+    'cursor',
+    'ready',
+];
+const _exhaustive = true;
+void _exhaustive;
+function connect(url, names, on, opts) {
+    const ES = opts.EventSource ?? globalThis.EventSource;
+    const es = new ES(url);
+    es.onopen = () => on.open?.();
+    es.onerror = () => on.error?.();
+    for (const name of names) {
+        es.addEventListener(name, (ev) => {
+            on.message({ event: name, data: JSON.parse(ev.data) });
+        });
+    }
+    return () => es.close();
+}
+const q = encodeURIComponent;
+const base = (opts) => (opts.baseUrl ?? '').replace(/\/$/, '');
+/**
+ * `/events?run=`: the run, live. The server replays the whole journal on every
+ * (re)connect and then sends `ready`; `panels` are the panel names from
+ * `/api/info` to listen for.
+ */
+export function openRunFeed(run, panels, on, opts = {}) {
+    const names = [...RUN_EVENT_NAMES, ...panels.map((p) => `panel:${p}`)];
+    return connect(`${base(opts)}/events?run=${q(run)}`, names, on, opts);
+}
+/** `/events/stream`: one transcript, tailed. The first page is the tail; each later one only what is new. */
+export function openStreamFeed(run, key, on, opts = {}) {
+    return connect(`${base(opts)}/events/stream?run=${q(run)}&key=${q(key)}`, ['stream'], { ...on, message: (m) => on.message(m.data) }, opts);
+}
+//# sourceMappingURL=feed.js.map

package/dist/feed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.js","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"AAGA,yFAAyF;AACzF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS;IACT,OAAO;IACP,MAAM;IACN,SAAS;IACT,QAAQ;IACR,OAAO;CACmC,CAAC;AAI7C,MAAM,WAAW,GAA6C,IAAI,CAAC;AACnE,KAAK,WAAW,CAAC;AAoBjB,SAAS,OAAO,CAAC,GAAW,EAAE,KAAwB,EAAE,EAAkD,EAAE,IAAiB;IAC3H,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC;IACtD,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IACvB,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;IAC9B,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;YAC/B,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAE,EAAsC,CAAC,IAAI,CAAY,EAAE,CAAC,CAAC;QACzG,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,GAAG,kBAAkB,CAAC;AAC7B,MAAM,IAAI,GAAG,CAAC,IAAiB,EAAU,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAEpF;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,MAAyB,EACzB,EAAgC,EAChC,OAAoB,EAAE;IAEtB,MAAM,KAAK,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,OAAO,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AACxE,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,GAAW,EACX,EAA4B,EAC5B,OAAoB,EAAE;IAEtB,OAAO,OAAO,CACZ,GAAG,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,EACzD,CAAC,QAAQ,CAAC,EACV,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAkB,CAAC,EAAE,EAC3D,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './types.js';
+export * from './client.js';
+export * from './feed.js';
+export * from './run-state.js';
+export * from './store.js';
+export * from './export.js';
+export * from './outcomes.js';
+export * from './derive.js';
+export * from './spend.js';
+export * from './quota.js';
+export * from './reasons.js';
+export * from './panels.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from './types.js';
+export * from './client.js';
+export * from './feed.js';
+export * from './run-state.js';
+export * from './store.js';
+export * from './export.js';
+export * from './outcomes.js';
+export * from './derive.js';
+export * from './spend.js';
+export * from './quota.js';
+export * from './reasons.js';
+export * from './panels.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/outcomes.d.ts

@@ -0,0 +1,117 @@
+import type { DeferralCause, JournalRow, Plan, PlanNode, TaskState } from './types.js';
+/**
+ * - `done`: its last attempt completed, first time.
+ * - `recovered`: a try that ran failed at least once, then its last attempt completed.
+ * - `partial`: its last attempt was partial (stop `partial`): ok, its output a placeholder; not done, not failed.
+ * - `failed`: it ran and its last attempt failed.
+ * - `not_started`: it never ran: an input was missing or off-contract, or it waits behind a task that failed.
+ * - `running`, `waiting` (queued, not started yet), `skipped`.
+ */
+export type Outcome = 'done' | 'recovered' | 'partial' | 'failed' | 'not_started' | 'running' | 'waiting' | 'skipped';
+export interface TaskOutcome {
+    key: string;
+    kind: string;
+    unit: string;
+    executor: 'agent' | 'python';
+    outcome: Outcome;
+    /** Its journal rows, oldest first (a refusal included). */
+    attempts: JournalRow[];
+    /** The rows of tries that actually ran (`isLaunched`), oldest first. */
+    tries: JournalRow[];
+    /** For a task that did not start: the failed task upstream that stopped it, if one is known. */
+    cause: string | null;
+    /** For a task the queue deferred (never launched): why, as the run recorded it; '' when it was not. */
+    deferred: string;
+    /** The same as data, for words of a reader's language; null when it was not deferred, or the run recorded no cause. */
+    deferredCause: DeferralCause | null;
+    /** For a task deferred by a flow call's own deadline (`time_box`): that flow call's function (`module.qualname`); '' otherwise. */
+    deferredIn: string;
+}
+/** The function of the flow call whose own deadline (`time_box`) deferred a task (`cause.flow_call`); '' for the run's deadline or another cause. */
+export declare function deferredIn(plan: Pick<Plan, 'flow_calls'> | null | undefined, cause: DeferralCause | null | undefined): string;
+/**
+ * The row is a real try: the task ran. A task refused before launch
+ * (`invalid_input`) or skipped also gets a journal row, but never ran: it is
+ * not a try, not an agent session, and not a failed attempt.
+ */
+export declare const isLaunched: (r: JournalRow) => boolean;
+/**
+ * A task's outcome from its plan node (if any) and its journal rows, oldest
+ * first. `recovered` needs a try that ran and failed: a refusal before launch
+ * (`invalid_input`) is not a failed attempt, so "not started, then done" is `done`.
+ */
+export declare function outcomeOf(node: Pick<PlanNode, 'state'> | undefined, attempts: readonly JournalRow[]): Outcome;
+/**
+ * The retries in `journal`, oldest first: the tries that ran (`isLaunched`)
+ * after an earlier try of the same task ran and failed, as in `recovered`. A
+ * try after a refusal (`invalid_input`) is not a retry.
+ */
+export declare function retries(journal: readonly JournalRow[]): JournalRow[];
+/**
+ * A plan node's state as an outcome: `blocked` is `not_started` and `pending`
+ * is `waiting`. Plan state `done` covers both `done` and `recovered`.
+ */
+export declare function planOutcome(state: TaskState): Outcome;
+/** Nothing is left to do for the task in this run: done, done after retrying, partial (its later tasks run on its output), or skipped. */
+export declare const isFinished: (o: Outcome) => boolean;
+/** Every task of the run (from the plan, and from the journal for tasks the plan does not list), by key. */
+export declare function taskOutcomes(journal: readonly JournalRow[], plan: Plan): Map<string, TaskOutcome>;
+export interface Problem {
+    /** The task that failed. */
+    task: TaskOutcome;
+    /** The tasks that did not start because of it. */
+    stopped: TaskOutcome[];
+}
+export interface Problems {
+    /** Failed tasks, the latest first, each with the tasks it stopped. */
+    failed: Problem[];
+    /** Tasks that did not start for a reason of their own. */
+    notStarted: TaskOutcome[];
+    /** Partial tasks: ok, their output a placeholder. */
+    partial: TaskOutcome[];
+    /** Tasks done after retrying. */
+    recovered: TaskOutcome[];
+}
+/**
+ * What is wrong with the run, causes first: each failed task with the tasks
+ * it stopped, then tasks that did not start for a reason of their own (an
+ * input that was never produced by a task). Tasks that recovered are not
+ * problems: they are listed apart, after them.
+ */
+export declare function problems(outcomes: ReadonlyMap<string, TaskOutcome>): Problems;
+/** How many tasks the run has, and how they ended. */
+export declare function outcomeCounts(outcomes: ReadonlyMap<string, TaskOutcome>): Record<Outcome, number> & {
+    total: number;
+};
+/**
+ * One task of the run as a list shows it: what happened to it (`TaskOutcome`)
+ * and what its tries add up to. A task that never ran has no tries: `wall_s` 0,
+ * `last_ts` and `last_stop` ''.
+ */
+export interface TaskRow extends TaskOutcome {
+    /** Its loop pass (the innermost loop of its flow path), from 1; null outside a loop. */
+    pass: number | null;
+    /** Time of its tries, summed, in seconds. */
+    wall_s: number;
+    /** When its last journal row was written; '' for none. */
+    last_ts: string;
+    /** The stop of its last journal row; '' for none. */
+    last_stop: string;
+    /** A waiting task: the keys of the earlier tasks it waits for that have not finished, in plan order. */
+    waits_for: string[];
+    /** The names it holds while it runs (`claims`); empty for none. */
+    claims: string[];
+    /** Its task call's `priority`: a tie-breaker in the queue's order; 0 by default. */
+    priority: number;
+}
+/** The innermost loop pass of a plan node's flow path; null outside a loop (a pass not counted reads as the first). */
+export declare function loopPass(node: Pick<PlanNode, 'flow'> | undefined): number | null;
+/**
+ * Every task of the run, one row each, from its outcomes (`taskOutcomes`): the
+ * plan joined with the journal, so a task that never ran (waiting, not started)
+ * is a row too. In plan order. Views read them from `deriveRun(...).rows`.
+ */
+export declare function taskRows(outcomes: ReadonlyMap<string, TaskOutcome>, plan: Plan): TaskRow[];
+/** The task to open by default: a running agent task, else the agent task that ran last (it has a transcript); never a Python task. Its key, or null. */
+export declare function latestTask(rows: readonly TaskRow[]): string | null;
+//# sourceMappingURL=outcomes.d.ts.map

package/dist/outcomes.d.ts.map

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

package/dist/outcomes.js

@@ -0,0 +1,201 @@
+/** The function of the flow call whose own deadline (`time_box`) deferred a task (`cause.flow_call`); '' for the run's deadline or another cause. */
+export function deferredIn(plan, cause) {
+    const id = cause?.flow_call;
+    return id ? (plan?.flow_calls?.find((c) => c.id === id)?.function ?? '') : '';
+}
+const isOk = (r) => r.ok;
+/**
+ * The row is a real try: the task ran. A task refused before launch
+ * (`invalid_input`) or skipped also gets a journal row, but never ran: it is
+ * not a try, not an agent session, and not a failed attempt.
+ */
+export const isLaunched = (r) => r.stop !== 'invalid_input' && r.stop !== 'skipped';
+/**
+ * A task's outcome from its plan node (if any) and its journal rows, oldest
+ * first. `recovered` needs a try that ran and failed: a refusal before launch
+ * (`invalid_input`) is not a failed attempt, so "not started, then done" is `done`.
+ */
+export function outcomeOf(node, attempts) {
+    if (node?.state === 'running')
+        return 'running';
+    const last = attempts[attempts.length - 1];
+    if (!last)
+        return node?.state === 'blocked' ? 'not_started' : 'waiting';
+    if (last.stop === 'skipped')
+        return 'skipped';
+    if (last.stop === 'invalid_input')
+        return 'not_started';
+    if (last.stop === 'partial')
+        return 'partial';
+    if (isOk(last))
+        return attempts.some((a) => isLaunched(a) && !isOk(a)) ? 'recovered' : 'done';
+    return 'failed';
+}
+/**
+ * The retries in `journal`, oldest first: the tries that ran (`isLaunched`)
+ * after an earlier try of the same task ran and failed, as in `recovered`. A
+ * try after a refusal (`invalid_input`) is not a retry.
+ */
+export function retries(journal) {
+    const failed = new Set();
+    const out = [];
+    for (const r of journal) {
+        if (!isLaunched(r))
+            continue;
+        if (failed.has(r.key))
+            out.push(r);
+        if (!isOk(r))
+            failed.add(r.key);
+    }
+    return out;
+}
+/**
+ * A plan node's state as an outcome: `blocked` is `not_started` and `pending`
+ * is `waiting`. Plan state `done` covers both `done` and `recovered`.
+ */
+export function planOutcome(state) {
+    switch (state) {
+        case 'blocked':
+            return 'not_started';
+        case 'pending':
+            return 'waiting';
+        default:
+            return state;
+    }
+}
+/** Nothing is left to do for the task in this run: done, done after retrying, partial (its later tasks run on its output), or skipped. */
+export const isFinished = (o) => o === 'done' || o === 'recovered' || o === 'partial' || o === 'skipped';
+/** Every task of the run (from the plan, and from the journal for tasks the plan does not list), by key. */
+export function taskOutcomes(journal, plan) {
+    const rows = new Map();
+    for (const r of journal) {
+        let list = rows.get(r.key);
+        if (!list)
+            rows.set(r.key, (list = []));
+        list.push(r);
+    }
+    const nodes = new Map(plan.nodes.map((n) => [n.key, n]));
+    const keys = [...new Set([...plan.nodes.map((n) => n.key), ...rows.keys()])];
+    const out = new Map();
+    for (const key of keys) {
+        const node = nodes.get(key);
+        const attempts = rows.get(key) ?? [];
+        const first = attempts[0];
+        out.set(key, {
+            key,
+            kind: node?.kind ?? first?.kind ?? '',
+            unit: node?.unit ?? first?.unit ?? '',
+            executor: node?.executor ?? first?.executor ?? 'agent',
+            outcome: outcomeOf(node, attempts),
+            attempts,
+            tries: attempts.filter(isLaunched),
+            cause: null,
+            deferred: node?.deferred ?? '',
+            deferredCause: node?.deferred_cause ?? null,
+            deferredIn: deferredIn(plan, node?.deferred_cause),
+        });
+    }
+    // A task that did not start: follow what it waits for to the task that actually failed.
+    const rootOf = (key, seen) => {
+        for (const dep of nodes.get(key)?.after ?? []) {
+            if (seen.has(dep))
+                continue;
+            seen.add(dep);
+            const d = out.get(dep);
+            if (d?.outcome === 'failed')
+                return dep;
+            if (d?.outcome === 'not_started') {
+                const r = rootOf(dep, seen);
+                if (r)
+                    return r;
+            }
+        }
+        return null;
+    };
+    for (const t of out.values())
+        if (t.outcome === 'not_started')
+            t.cause = rootOf(t.key, new Set());
+    return out;
+}
+/**
+ * What is wrong with the run, causes first: each failed task with the tasks
+ * it stopped, then tasks that did not start for a reason of their own (an
+ * input that was never produced by a task). Tasks that recovered are not
+ * problems: they are listed apart, after them.
+ */
+export function problems(outcomes) {
+    const failed = new Map();
+    for (const t of outcomes.values())
+        if (t.outcome === 'failed')
+            failed.set(t.key, { task: t, stopped: [] });
+    const notStarted = [];
+    for (const t of outcomes.values()) {
+        if (t.outcome !== 'not_started')
+            continue;
+        const p = t.cause ? failed.get(t.cause) : undefined;
+        if (p)
+            p.stopped.push(t);
+        else
+            notStarted.push(t);
+    }
+    const lastTs = (t) => t.attempts[t.attempts.length - 1]?.ts ?? '';
+    return {
+        failed: [...failed.values()].sort((a, b) => lastTs(b.task).localeCompare(lastTs(a.task))),
+        notStarted,
+        partial: [...outcomes.values()].filter((t) => t.outcome === 'partial'),
+        recovered: [...outcomes.values()].filter((t) => t.outcome === 'recovered'),
+    };
+}
+/** How many tasks the run has, and how they ended. */
+export function outcomeCounts(outcomes) {
+    const c = { done: 0, recovered: 0, partial: 0, failed: 0, not_started: 0, running: 0, waiting: 0, skipped: 0, total: 0 };
+    for (const t of outcomes.values()) {
+        c[t.outcome]++;
+        c.total++;
+    }
+    return c;
+}
+/** The innermost loop pass of a plan node's flow path; null outside a loop (a pass not counted reads as the first). */
+export function loopPass(node) {
+    const frames = Array.isArray(node?.flow) ? node.flow : [];
+    for (let i = frames.length - 1; i >= 0; i--) {
+        const loops = frames[i]?.loops ?? [];
+        const inner = loops[loops.length - 1];
+        if (inner)
+            return typeof inner.pass === 'number' && inner.pass >= 1 ? inner.pass : 1;
+    }
+    return null;
+}
+/**
+ * Every task of the run, one row each, from its outcomes (`taskOutcomes`): the
+ * plan joined with the journal, so a task that never ran (waiting, not started)
+ * is a row too. In plan order. Views read them from `deriveRun(...).rows`.
+ */
+export function taskRows(outcomes, plan) {
+    const nodes = new Map(plan.nodes.map((n) => [n.key, n]));
+    return [...outcomes.values()].map((t) => {
+        const last = t.attempts[t.attempts.length - 1];
+        const node = nodes.get(t.key);
+        return {
+            ...t,
+            pass: loopPass(node),
+            wall_s: t.tries.reduce((s, r) => s + (r.wall_s || 0), 0),
+            last_ts: last?.ts ?? '',
+            last_stop: last?.stop ?? '',
+            waits_for: t.outcome === 'waiting' ? (node?.after ?? []).filter((d) => !isFinished(outcomes.get(d)?.outcome ?? 'waiting')) : [],
+            claims: node?.claims ?? [],
+            priority: node?.priority ?? 0,
+        };
+    });
+}
+/** The task to open by default: a running agent task, else the agent task that ran last (it has a transcript); never a Python task. Its key, or null. */
+export function latestTask(rows) {
+    const agent = rows.filter((t) => t.executor !== 'python');
+    const running = agent.find((t) => t.outcome === 'running');
+    if (running)
+        return running.key;
+    const ran = (t) => t.tries[t.tries.length - 1]?.ts ?? '';
+    const last = agent.filter(ran).sort((a, b) => ran(b).localeCompare(ran(a)))[0];
+    return last?.key ?? null;
+}
+//# sourceMappingURL=outcomes.js.map

package/dist/outcomes.js.map

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

package/dist/panels.d.ts

@@ -0,0 +1,31 @@
+import type { components } from './schema.js';
+import type { JsonObject, PanelInfo } from './types.js';
+type S = components['schemas'];
+export type TilesBody = S['TilesBody'];
+export type PanelTile = S['PanelTile'];
+export type TableBody = S['TableBody'];
+export type TableColumn = S['TableColumn'];
+export type ColumnsBody = S['ColumnsBody'];
+export type LinesBody = S['LinesBody'];
+export type HeatmapBody = S['HeatmapBody'];
+export type HBarsBody = S['HBarsBody'];
+export type HBar = S['HBar'];
+export type StatusGridBody = S['StatusGridBody'];
+export type GridCell = S['GridCell'];
+export type NoteBody = S['NoteBody'];
+export type BlocksBody = S['BlocksBody'];
+export type ChartSeries = S['ChartSeries'];
+/** How a number of a body is written: `pct` is a fraction (0.97 is 97%), `duration` seconds, `datetime` an ISO time. */
+export type ValueFormat = NonNullable<TableColumn['format']>;
+/** A body with a `type`: drawn with the monitor's own elements. */
+export type TypedPanelBody = TilesBody | TableBody | ColumnsBody | LinesBody | HeatmapBody | HBarsBody | StatusGridBody | NoteBody | BlocksBody;
+/** What a panel returns: a typed body, or any JSON object. */
+export type PanelBody = TypedPanelBody | JsonObject;
+/** The `type` of each typed body. */
+export declare const PANEL_TYPES: readonly ["tiles", "table", "columns", "lines", "heatmap", "hbars", "status_grid", "note", "blocks"];
+/** `body` as a typed body, or null when it is any other JSON object (a JSON tree). */
+export declare function typedBody(body: unknown): TypedPanelBody | null;
+/** A panel computed per run: a tab of each run, sent on its live feed (a trends panel is not). */
+export declare const isRunPanel: (p: Pick<PanelInfo, "scope">) => boolean;
+export {};
+//# sourceMappingURL=panels.d.ts.map

package/dist/panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../src/panels.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;AAE/B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACrC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACrC,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;AACzC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,wHAAwH;AACxH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE7D,mEAAmE;AACnE,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,WAAW,GACX,SAAS,GACT,cAAc,GACd,QAAQ,GACR,UAAU,CAAC;AACf,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,UAAU,CAAC;AAEpD,qCAAqC;AACrC,eAAO,MAAM,WAAW,sGAAuG,CAAC;AAEhI,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAI9D;AAED,kGAAkG;AAClG,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAG,OAAuC,CAAC"}

package/dist/panels.js

@@ -0,0 +1,12 @@
+/** The `type` of each typed body. */
+export const PANEL_TYPES = ['tiles', 'table', 'columns', 'lines', 'heatmap', 'hbars', 'status_grid', 'note', 'blocks'];
+/** `body` as a typed body, or null when it is any other JSON object (a JSON tree). */
+export function typedBody(body) {
+    if (!body || typeof body !== 'object' || Array.isArray(body))
+        return null;
+    const type = body.type;
+    return typeof type === 'string' && PANEL_TYPES.includes(type) ? body : null;
+}
+/** A panel computed per run: a tab of each run, sent on its live feed (a trends panel is not). */
+export const isRunPanel = (p) => (p.scope ?? 'run') === 'run';
+//# sourceMappingURL=panels.js.map

package/dist/panels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panels.js","sourceRoot":"","sources":["../src/panels.ts"],"names":[],"mappings":"AAuCA,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAEhI,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;IAC/C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAK,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAuB,CAAC,CAAC,CAAC,IAAI,CAAC;AACzH,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAA2B,EAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC"}

package/dist/quota.d.ts

@@ -0,0 +1,32 @@
+import type { JournalRow, QuotaReading } from './types.js';
+/** A reading, and the row (try) it came with. */
+export interface SourcedReading {
+    reading: QuotaReading;
+    key: string;
+    attempt: number;
+}
+/** Every reading of the run, oldest first. */
+export declare function runReadings(journal: readonly JournalRow[]): SourcedReading[];
+/** One account's utilization over the run: the credential that reported it, and the account (`account`, a digest; '' when not known). */
+export interface AccountUsage {
+    credential: string;
+    account?: string;
+    first: QuotaReading;
+    last: QuotaReading;
+}
+/** The account a reading is of: its credential and its account digest. `ambient` on two coding agents is two accounts. */
+export declare const accountKey: (r: {
+    credential?: string | null;
+    account?: string | null;
+}) => string;
+/** Per account, the run's first and last reading; the account with the highest weekly use first. */
+export declare function runAccounts(journal: readonly JournalRow[]): AccountUsage[];
+export interface TryQuota {
+    /** The try's first reading: usage when its (first) session started. */
+    start: QuotaReading | null;
+    /** The first reading of the same account received after the try ended (`row.ts`), if any. */
+    next: QuotaReading | null;
+}
+/** One try's readings: at its start, and the next one observed after it ended. */
+export declare function tryQuota(row: JournalRow, readings: readonly SourcedReading[]): TryQuota;
+//# sourceMappingURL=quota.d.ts.map

package/dist/quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../src/quota.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3D,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,cAAc,EAAE,CAQ5E;AAED,yIAAyI;AACzI,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,0HAA0H;AAC1H,eAAO,MAAM,UAAU,GAAI,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,KAAG,MAAyD,CAAC;AAElJ,oGAAoG;AACpG,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,YAAY,EAAE,CAe1E;AAED,MAAM,WAAW,QAAQ;IACvB,uEAAuE;IACvE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,6FAA6F;IAC7F,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CAC3B;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,QAAQ,CAUvF"}

package/dist/quota.js

@@ -0,0 +1,46 @@
+const at = (r) => Date.parse(r.observed_at ?? '');
+const usable = (r) => !Number.isNaN(at(r)) && (r.five_hour_pct != null || r.seven_day_pct != null);
+/** Every reading of the run, oldest first. */
+export function runReadings(journal) {
+    const out = [];
+    for (const row of journal) {
+        for (const reading of row.quota ?? []) {
+            if (usable(reading))
+                out.push({ reading, key: row.key, attempt: row.attempt ?? 0 });
+        }
+    }
+    return out.sort((a, b) => at(a.reading) - at(b.reading));
+}
+/** The account a reading is of: its credential and its account digest. `ambient` on two coding agents is two accounts. */
+export const accountKey = (r) => `${r.credential ?? ''}\u0000${r.account ?? ''}`;
+/** Per account, the run's first and last reading; the account with the highest weekly use first. */
+export function runAccounts(journal) {
+    const by = new Map();
+    for (const { reading } of runReadings(journal)) {
+        const k = accountKey(reading);
+        let list = by.get(k);
+        if (!list)
+            by.set(k, (list = []));
+        list.push(reading);
+    }
+    const out = [];
+    for (const list of by.values()) {
+        const first = list[0];
+        const last = list[list.length - 1];
+        if (first && last)
+            out.push({ credential: last.credential ?? '', account: last.account ?? '', first, last });
+    }
+    return out.sort((a, b) => (b.last.seven_day_pct ?? 0) - (a.last.seven_day_pct ?? 0));
+}
+/** One try's readings: at its start, and the next one observed after it ended. */
+export function tryQuota(row, readings) {
+    const own = (row.quota ?? []).filter(usable).sort((a, b) => at(a) - at(b));
+    const ended = Date.parse(row.ts);
+    const start = own[0] ?? null;
+    const account = start === null ? '' : accountKey(start);
+    const next = start === null || Number.isNaN(ended)
+        ? undefined
+        : readings.find((r) => at(r.reading) > ended && accountKey(r.reading) === account);
+    return { start, next: next?.reading ?? null };
+}
+//# sourceMappingURL=quota.js.map

package/dist/quota.js.map

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

package/dist/reasons.d.ts

@@ -0,0 +1,25 @@
+/** 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;
+     * `failed`: it is there, written by a task that did not succeed (`producer`).
+     */
+    problem: 'missing' | 'checks' | 'failed';
+}
+/**
+ * The inputs a refused task's reason names (`invalid input: input from <key> is
+ * missing: <path>`, `invalid input: input from <key> ended <stop>: <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[];
+/**
+ * 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=reasons.d.ts.map

package/dist/reasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasons.d.ts","sourceRoot":"","sources":["../src/reasons.ts"],"names":[],"mappings":"AAGA,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,EAAE,CAwB/E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhF"}