@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/driver-names.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The driver vocabulary (#542), node-free so every surface shares one copy: the registry's
+ * preference sanitizer and the dashboard bundle. The names are agent-driver's own, the ones a
+ * run's card carries, so the pick handed to a project's start hook as `DRIVER` and the record
+ * that comes back say the same word. The dashboard's per-driver UI table is keyed by
+ * {@link DriverName}, so a missing entry there is a compile error, not a silent gap.
+ */
+/** The coding agents a person can pick for a run, in the order surfaces list them. */
+export declare const DRIVERS: readonly ['claude-code', 'codex'];
+/** A driver the user can pick. */
+export type DriverName = (typeof DRIVERS)[number];
+/** Whether `value` names a driver we can run. */
+export declare function isDriverName(value: string | undefined): value is DriverName;
+/** How each driver reads in a sentence or on a button. */
+export declare const DRIVER_LABELS: Record<DriverName, string>;
+/**
+ * The pick behind the driver a run's record names (#831). Every surface Claude ran on is still
+ * Claude (#1263): older records name its cloud session and its Actions runner. `undefined` for a
+ * driver no pick claims (a fake one, or a record from a newer version).
+ */
+export declare function driverFromImpl(impl: string | undefined): DriverName | undefined;
+//# sourceMappingURL=driver-names.d.ts.map

package/dist/driver-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-names.d.ts","sourceRoot":"","sources":["../src/driver-names.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sFAAsF;AACtF,eAAO,MAAM,OAAO,YAAI,aAAa,EAAE,OAAO,CAAU,CAAA;AAExD,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjD,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,UAAU,CAE3E;AAED,0DAA0D;AAC1D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAGpD,CAAA;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAG/E"}

package/dist/driver-names.js

@@ -0,0 +1,29 @@
+/**
+ * The driver vocabulary (#542), node-free so every surface shares one copy: the registry's
+ * preference sanitizer and the dashboard bundle. The names are agent-driver's own, the ones a
+ * run's card carries, so the pick handed to a project's start hook as `DRIVER` and the record
+ * that comes back say the same word. The dashboard's per-driver UI table is keyed by
+ * {@link DriverName}, so a missing entry there is a compile error, not a silent gap.
+ */
+/** The coding agents a person can pick for a run, in the order surfaces list them. */
+export const DRIVERS = ['claude-code', 'codex'];
+/** Whether `value` names a driver we can run. */
+export function isDriverName(value) {
+    return value !== undefined && DRIVERS.includes(value);
+}
+/** How each driver reads in a sentence or on a button. */
+export const DRIVER_LABELS = {
+    'claude-code': 'Claude Code',
+    codex: 'Codex',
+};
+/**
+ * The pick behind the driver a run's record names (#831). Every surface Claude ran on is still
+ * Claude (#1263): older records name its cloud session and its Actions runner. `undefined` for a
+ * driver no pick claims (a fake one, or a record from a newer version).
+ */
+export function driverFromImpl(impl) {
+    if (impl === 'claude-web' || impl === 'github-actions')
+        return 'claude-code';
+    return isDriverName(impl) ? impl : undefined;
+}
+//# sourceMappingURL=driver-names.js.map

package/dist/driver-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-names.js","sourceRoot":"","sources":["../src/driver-names.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sFAAsF;AACtF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,aAAa,EAAE,OAAO,CAAU,CAAA;AAKxD,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,OAAO,KAAK,KAAK,SAAS,IAAK,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC9E,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,aAAa,GAA+B;IACvD,aAAa,EAAE,aAAa;IAC5B,KAAK,EAAE,OAAO;CACf,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAwB;IACrD,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,gBAAgB;QAAE,OAAO,aAAa,CAAA;IAC5E,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9C,CAAC"}

package/dist/error-message.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The message of an unknown caught value. `catch` hands back `unknown`, and this ternary was
+ * spelled out at over twenty call sites; the next variation in one of them would be a bug (a
+ * dropped `String()` turns a thrown string into `[object Object]`'s sibling problems), so the
+ * idiom gets one home. Node-free, exported through /client for the dashboard's use too.
+ */
+export declare function errorMessage(err: unknown): string;
+//# sourceMappingURL=error-message.d.ts.map

package/dist/error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message.d.ts","sourceRoot":"","sources":["../src/error-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEjD"}

package/dist/error-message.js

@@ -0,0 +1,10 @@
+/**
+ * The message of an unknown caught value. `catch` hands back `unknown`, and this ternary was
+ * spelled out at over twenty call sites; the next variation in one of them would be a bug (a
+ * dropped `String()` turns a thrown string into `[object Object]`'s sibling problems), so the
+ * idiom gets one home. Node-free, exported through /client for the dashboard's use too.
+ */
+export function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=error-message.js.map

package/dist/error-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message.js","sourceRoot":"","sources":["../src/error-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;AACzD,CAAC"}

package/dist/event-stream.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A replayable, multi-consumer stream of events: buffer every event, hand out live async
+ * iterators, and replay history from an offset (tail=N replay).
+ *
+ * Absorbed from `@gemstack/ai-autopilot` when that package was deleted (A2). Its element type
+ * used to default to the supervisor's event; the only caller here passes `FrameworkEvent`, so
+ * the parameter is now required.
+ */
+export declare class EventStream<E> {
+    private readonly buffer;
+    private readonly waiters;
+    private closed;
+    /** Append an event. Wire this in as an `onEvent` sink. Ignored once closed. */
+    readonly push: (event: E) => void;
+    /** Alias for {@link push}, reads well at the `onEvent:` call site. */
+    get sink(): (event: E) => void;
+    /** Events buffered so far, from `fromOffset` (default 0) — Flue-style tail replay. */
+    history(fromOffset?: number): E[];
+    /** Number of events buffered. */
+    get length(): number;
+    /** True once {@link close} has run. */
+    get isClosed(): boolean;
+    /** End the stream: live iterators drain their backlog, then finish. Idempotent. */
+    close(): void;
+    /**
+     * A fresh async iterator that replays every buffered event, then yields new
+     * ones as they arrive, and finishes once the stream is closed and drained.
+     * Independent iterators each keep their own cursor, so late consumers still
+     * see the full history.
+     */
+    [Symbol.asyncIterator](): AsyncIterableIterator<E>;
+}
+//# sourceMappingURL=event-stream.d.ts.map

package/dist/event-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-stream.d.ts","sourceRoot":"","sources":["../src/event-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,WAAW,CAAC,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,MAAM,CAAQ;IAEtB,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,UAAW,CAAC,KAAG,IAAI,CAI/B;IAED,sEAAsE;IACtE,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAE7B;IAED,sFAAsF;IACtF,OAAO,CAAC,UAAU,SAAI,GAAG,CAAC,EAAE,CAE3B;IAED,iCAAiC;IACjC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,uCAAuC;IACvC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,mFAAmF;IACnF,KAAK,IAAI,IAAI,CAIZ;IAED;;;;;OAKG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,CA6CjD;CACF"}

package/dist/event-stream.js

@@ -0,0 +1,104 @@
+/**
+ * A replayable, multi-consumer stream of events: buffer every event, hand out live async
+ * iterators, and replay history from an offset (tail=N replay).
+ *
+ * Absorbed from `@gemstack/ai-autopilot` when that package was deleted (A2). Its element type
+ * used to default to the supervisor's event; the only caller here passes `FrameworkEvent`, so
+ * the parameter is now required.
+ */
+export class EventStream {
+    buffer = [];
+    waiters = [];
+    closed = false;
+    /** Append an event. Wire this in as an `onEvent` sink. Ignored once closed. */
+    push = (event) => {
+        if (this.closed)
+            return;
+        this.buffer.push(event);
+        for (const wake of this.waiters.splice(0))
+            wake();
+    };
+    /** Alias for {@link push}, reads well at the `onEvent:` call site. */
+    get sink() {
+        return this.push;
+    }
+    /** Events buffered so far, from `fromOffset` (default 0) — Flue-style tail replay. */
+    history(fromOffset = 0) {
+        return this.buffer.slice(fromOffset);
+    }
+    /** Number of events buffered. */
+    get length() {
+        return this.buffer.length;
+    }
+    /** True once {@link close} has run. */
+    get isClosed() {
+        return this.closed;
+    }
+    /** End the stream: live iterators drain their backlog, then finish. Idempotent. */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const wake of this.waiters.splice(0))
+            wake();
+    }
+    /**
+     * A fresh async iterator that replays every buffered event, then yields new
+     * ones as they arrive, and finishes once the stream is closed and drained.
+     * Independent iterators each keep their own cursor, so late consumers still
+     * see the full history.
+     */
+    [Symbol.asyncIterator]() {
+        let index = 0;
+        let done = false;
+        let pending;
+        const stream = this;
+        return {
+            [Symbol.asyncIterator]() {
+                return this;
+            },
+            next() {
+                if (done)
+                    return Promise.resolve({ value: undefined, done: true });
+                if (index < stream.buffer.length) {
+                    return Promise.resolve({ value: stream.buffer[index++], done: false });
+                }
+                if (stream.closed)
+                    return Promise.resolve({ value: undefined, done: true });
+                return new Promise(resolve => {
+                    const wake = () => {
+                        pending = undefined;
+                        if (done)
+                            return resolve({ value: undefined, done: true });
+                        if (index < stream.buffer.length)
+                            return resolve({ value: stream.buffer[index++], done: false });
+                        if (stream.closed)
+                            return resolve({ value: undefined, done: true });
+                        // Woken with nothing left for us (a concurrent next() on this iterator took the
+                        // event): the stream is still open, so wait again rather than resolve a false done.
+                        pending = wake;
+                        stream.waiters.push(wake);
+                    };
+                    pending = wake;
+                    stream.waiters.push(wake);
+                });
+            },
+            // Cancel this iterator (e.g. an SSE client disconnected): drop its waiter so
+            // it does not linger in `waiters` until the next push, and settle any pending
+            // `next()`. Without this, a disconnected consumer leaks until the stream ends.
+            return() {
+                done = true;
+                if (pending) {
+                    const i = stream.waiters.indexOf(pending);
+                    if (i >= 0)
+                        stream.waiters.splice(i, 1);
+                    const wake = pending;
+                    pending = undefined;
+                    wake();
+                }
+                return Promise.resolve({ value: undefined, done: true });
+            },
+        };
+    }
+}
+//# sourceMappingURL=event-stream.js.map

package/dist/event-stream.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,236 @@
+import type { DriverEvent } from '@openagt/agent-driver';
+/** One selectable option in an interactive {@link ChoiceRequest} (#304). */
+export interface ChoiceOption {
+    /** Stable id posted back when this option is picked. */
+    id: string;
+    /** The option shown to the user. */
+    label: string;
+    /** Optional one-line detail under the label (e.g. why an alternative lost). */
+    detail?: string;
+    /** In a multi-select ({@link ChoiceRequest.multi}), whether this option starts checked. Ignored for single-select. */
+    default?: boolean;
+}
+/**
+ * An interactive choice the agent pauses on until a pick arrives (#304). Emitted as
+ * a `choice` {@link FrameworkEvent}; the dashboard renders it in a panel and posts
+ * the pick back. The recommended option is what an agent nobody is watching takes.
+ */
+export interface ChoiceRequest {
+    /** Unique id for this pending choice; the pick is posted back against it. */
+    id: string;
+    /** The question shown above the options (e.g. "Approve this plan?"). */
+    title: string;
+    /** The options to choose between (at least one). */
+    options: readonly ChoiceOption[];
+    /**
+     * The option id pre-selected as the default (taken when nobody is watching). Required
+     * for a single-select; omitted for a {@link multi} select, where each option's own
+     * {@link ChoiceOption.default} drives the pre-checked set instead.
+     */
+    recommended?: string;
+    /**
+     * Render as a multi-select checklist (#332): each option is a checkbox pre-checked
+     * per its {@link ChoiceOption.default}, and the pick resolves to the selected
+     * *subset* of ids rather than one. Absent = the single-select gate (#304).
+     */
+    multi?: boolean;
+    /** The markdown file under approval (e.g. `PLAN_<slug>.agent.md`); the doc sidebar renders it. */
+    file?: string;
+}
+/** Who resolved a {@link ChoiceRequest}: a human, or a headless auto-accept. */
+export type ChoiceBy = 'user' | 'auto';
+/** What a {@link import('./agent.js').RunFrameworkOptions.requestChoice} handler resolves with. */
+export interface ChoicePick {
+    /** The picked option id, or (for a {@link ChoiceRequest.multi} select) the selected subset of ids. */
+    picked: string | readonly string[];
+    /** Who picked it. Default `'user'`. */
+    by?: ChoiceBy;
+}
+/** Normalize a {@link ChoicePick} (single id or subset) to a list of picked ids. */
+export declare function pickedIds(picked: string | readonly string[]): string[];
+/**
+ * The single type a run's timeline is read as. The framework emits none of these itself (#1774):
+ * a run's tool writes the run's diary, and every line of it is read as one of these so the
+ * dashboard and the terminal render one timeline whatever wrote it.
+ *
+ * What a diary yields today is the agent's own progress (`driver`), the session id it reports
+ * (`session-update`), the question a turn ended on (`choice`), what it cost (`usage`) and how it
+ * ended (`end`). **The rest of this union is a reading vocabulary for runs recorded before the
+ * daemon stopped running agents** — the framework's own narration back then. They are kept
+ * because that history is still on the data branch and still has to render.
+ *
+ * Every event read from a diary line that says when it was written carries that time as `at`
+ * (ISO 8601), so the timeline shows the same times live, after a reload, and once the run has
+ * ended. Lines written before the diary kept times have none, and show none.
+ */
+export type FrameworkEvent = {
+    at?: string;
+} & (
+/**
+ * Emitted once at start: which agent is wrapped, the workspace, and a link. `model` is the
+ * model id the driver was started with (#1438), recorded per leg — a continuation (#762) emits
+ * its own `session` event and may run a different model, so readers fold the latest rather
+ * than pinning the first. Absent when the agent left the agent on its own default.
+ */
+{
+    kind: 'session';
+    driver: string;
+    workspace: string;
+    fake: boolean;
+    sessionLink?: string;
+    model?: string;
+}
+/**
+ * Emitted once the wrapped agent reports its real session id (not known at
+ * start). Carries the live id and, when a link template was supplied, the
+ * resolved URL to jump into that session (#165). Re-emitted if the id changes
+ * (each Claude Code prompt is a fresh session), keeping the link current.
+ */
+ | {
+    kind: 'session-update';
+    sessionId: string;
+    sessionLink?: string;
+}
+/** What this session was asked for, emitted once as it opens (#211). */
+ | {
+    kind: 'intent';
+    text: string;
+}
+/** The wrapped agent's own progress, forwarded verbatim (never gated on). */
+ | {
+    kind: 'driver';
+    event: DriverEvent;
+}
+/**
+ * A live screen something the agent ran is showing: a page on this machine's loopback, shown in
+ * the chat where the line is, while it is the newest open screen at that address and the run
+ * has not ended. `label` names what it showed then. The same address with `ended` says the
+ * screen has gone. A diary line a command appends itself (agent-driver's `DIARY_ENV`); the
+ * framework knows nothing of what the page is.
+ */
+ | {
+    kind: 'screen';
+    url: string;
+    label: string;
+    ended?: true;
+}
+/** A framework-level log line. */
+ | {
+    kind: 'log';
+    message: string;
+}
+/**
+ * Something went wrong that only the user can fix (#1500), reported by the agent itself
+ * through an `error` block rather than left in prose the reader has to notice. The headline
+ * is the first line, the detail is the rest.
+ *
+ * An event, not a status: it says what happened at this point in the run and stays in the log
+ * as history — nothing clears it, because nothing can un-happen it. The project-level errors a
+ * background job finds between runs are the other half (project-errors.ts): those are
+ * conditions that are true *now*, and clear themselves when the condition is gone.
+ */
+ | {
+    kind: 'error';
+    headline: string;
+    detail?: string;
+}
+/**
+ * An ad-hoc markdown view the agent pushed to show the user (#441), e.g. a plan,
+ * a summary, or a diff writeup. Non-blocking (unlike a `choice`): the dashboard
+ * renders it as a view in the right rail. `id` is stable per title, so re-showing
+ * the same view updates it in place rather than stacking a duplicate.
+ */
+ | {
+    kind: 'view';
+    id: string;
+    title: string;
+    markdown: string;
+}
+/**
+ * The pull request this session's work is on (E6), the moment one is opened for it.
+ *
+ * An event for the same reason `branch` is: only an event reaches the agent's meta,
+ * and the meta is what every later surface reads. Before this, each of them re-resolved the PR
+ * live from the branch — trying the recorded branch, then the session-name branch, then the
+ * run-id branch, and filtering the results by whether the PR predated the session — which is a
+ * three-way guess plus a timestamp heuristic standing in for one integer nobody had written down.
+ */
+ | {
+    kind: 'pull-request';
+    number: number;
+    url: string;
+}
+/**
+ * The branch the agent's work is on (#1277), observed off the checkout rather than guessed:
+ * emitted at start with the branch the agent actually begins on, and again whenever a later
+ * read finds it changed — the agent renames its branch itself, through `branches name`
+ * (#1725). Folded to `AgentMeta.branch`, which every surface resolves first — before this event the
+ * branch was stamped only at teardown (#799), so any read before that guessed between three
+ * naming schemes.
+ */
+ | {
+    kind: 'branch';
+    branch: string;
+}
+/**
+ * The hand-off anchor a cloud run pushed for its session to clone at (#1601): an empty commit
+ * unique to this run, so the branch the session actually works on — a `claude/*` name of the
+ * cloud's own choosing, never the designated run branch — is recognizable later by plain
+ * ancestry. Folded to `AgentMeta.cloudAnchor`, which the daemon's adoption pass matches
+ * against origin's `claude/*` heads once the session has pushed its work.
+ */
+ | {
+    kind: 'cloud-anchor';
+    sha: string;
+}
+/**
+ * The work has settled and the agent is parked on the user (#785): it stays open as a
+ * conversation (#714), so its process is still alive and it still takes messages, but
+ * the agent is not doing anything until you say something.
+ *
+ * Emitted each time the agent parks, and undone by the next `driver` `start` — so "is it
+ * working or waiting for me" is answerable from the event log rather than inferred from
+ * a status that only changes when the agent ends.
+ */
+ | {
+    kind: 'settled';
+}
+/**
+ * The price of one turn in USD (#322): the run's record keeps a cost line per turn the
+ * coding agent priced, and no token counts, so a turn without a price has no usage event
+ * (#540). The dashboard adds them up into its spend readout. Nothing gates on it: an
+ * agent already running is never cut short over spending, and the account's quota
+ * decides what may *start* instead.
+ */
+ | {
+    kind: 'usage';
+    costUsd: number;
+}
+/**
+ * The agent paused on an interactive choice (#304) and is awaiting a pick. The
+ * dashboard renders the options with the recommended default pre-selected and
+ * posts the pick back; a headless agent auto-accepts the recommended option.
+ */
+ | ({
+    kind: 'choice';
+} & ChoiceRequest)
+/** A pending {@link ChoiceRequest} was resolved — the agent continues on `picked` (one id, or the selected subset). */
+ | {
+    kind: 'choice-resolved';
+    id: string;
+    picked: string | readonly string[];
+    by: ChoiceBy;
+}
+/**
+ * The agent finished. `ok` is false when it threw. `stopped` marks the common,
+ * non-error case where the user interrupted it (the dashboard Stop button /
+ * Ctrl+C), so a surface can show "stopped" rather than "failed".
+ */
+ | {
+    kind: 'end';
+    ok: boolean;
+    stopped?: boolean;
+    waiting?: boolean;
+    detail?: string;
+});
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,5 @@
+/** Normalize a {@link ChoicePick} (single id or subset) to a list of picked ids. */
+export function pickedIds(picked) {
+    return Array.isArray(picked) ? [...picked] : picked ? [picked] : [];
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAqDA,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,MAAkC;IAC1D,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC/E,CAAC"}

package/dist/fake-script.d.ts

@@ -0,0 +1,15 @@
+import { FakeDriver, type FakeTurn } from 'agent-driver';
+/**
+ * The deterministic fake scenario: a small Vike + Prisma orders app.
+ * It wires a {@link FakeDriver} whose scripted turns walk the exact prompt order
+ * the flow issues — one build turn (#1372: with no preset and no serve config
+ * nothing reviews the build, so the build is the whole loop) — so the flow runs
+ * offline with no CLI and no model, driven entirely *through* the driver seam.
+ */
+/** The default intent the fake demo builds. */
+export declare const FAKE_INTENT = "A paginated orders page backed by an orders table, with sign-in.";
+/** Scripted turns for the demo, optionally routed through a turn-boundary gate. */
+export declare function demoTurns(awaitMode: string | undefined): FakeTurn[];
+/** Build the scripted {@link FakeDriver} for the demo. */
+export declare function fakeDriver(): FakeDriver;
+//# sourceMappingURL=fake-script.d.ts.map

package/dist/fake-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-script.d.ts","sourceRoot":"","sources":["../src/fake-script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAExD;;;;;;GAMG;AAEH,+CAA+C;AAC/C,eAAO,MAAM,WAAW,qEAAqE,CAAA;AAwC7F,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,EAAE,CASnE;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,IAAI,UAAU,CAEvC"}

package/dist/fake-script.js

@@ -0,0 +1,58 @@
+import { FakeDriver } from 'agent-driver';
+/**
+ * The deterministic fake scenario: a small Vike + Prisma orders app.
+ * It wires a {@link FakeDriver} whose scripted turns walk the exact prompt order
+ * the flow issues — one build turn (#1372: with no preset and no serve config
+ * nothing reviews the build, so the build is the whole loop) — so the flow runs
+ * offline with no CLI and no model, driven entirely *through* the driver seam.
+ */
+/** The default intent the fake demo builds. */
+export const FAKE_INTENT = 'A paginated orders page backed by an orders table, with sign-in.';
+// A small, plausible per-turn usage so the demo shows spend accumulating (#322).
+const FAKE_USAGE = { costUsd: 0.02, inputTokens: 1800, outputTokens: 600, cacheReadTokens: 12000, cacheCreationTokens: 800 };
+const BUILD_TURN = {
+    text: 'Built the orders app: an orders schema and migration, a paginated /orders page, and a sign-in stub.',
+    actions: ['Write', 'Write', 'Bash'],
+    usage: FAKE_USAGE,
+};
+const TURNS = [BUILD_TURN];
+// Demo variants that make the build stop to ask, so the turn-boundary gates (#337
+// single-select / #339 multi-select checklist) can be seen offline. The build turn ends
+// with an await block; the framework shows the gate, waits, then re-prompts (RESUME_TURN),
+// and the agent continues as usual. Needs the dashboard on (so requestChoice is
+// wired); selected via FRAMEWORK_FAKE_AWAIT=choices|multiselect|confirmation.
+const AWAIT_CHOICES_TURN = {
+    text: 'I need one decision before wiring auth.\n```await-choices\n' +
+        '{ "title": "Which auth approach for the orders page?", "options": [{ "label": "Session cookies", "detail": "simple, server-side" }, { "label": "JWT", "detail": "stateless, more moving parts" }], "recommended": "Session cookies" }\n```',
+    actions: ['Read'],
+    usage: FAKE_USAGE,
+};
+const AWAIT_MULTISELECT_TURN = {
+    text: 'Rated the problems by how clear the optimal solution is.\n```await-choices\n' +
+        '{ "title": "Which problems should I deep-dive for alternatives?", "multi": true, "options": [{ "label": "auth model", "detail": "rated 3/10", "default": true }, { "label": "pagination", "detail": "rated 7/10" }, { "label": "orders schema", "detail": "rated 2/10", "default": true }] }\n```',
+    actions: ['Read', 'Grep'],
+    usage: FAKE_USAGE,
+};
+const AWAIT_CONFIRMATION_TURN = {
+    text: 'The scope is large, so I wrote a plan first.\n```await-choices\n' +
+        '{ "title": "Approve the plan for the orders app?", "file": "PLAN_fake-orders-app.agent.md", "options": [{ "label": "Approve" }, { "label": "Decline", "stop": true }], "recommended": "Approve" }\n```',
+    actions: ['Write'],
+    usage: FAKE_USAGE,
+};
+const RESUME_TURN = { text: 'Applied your answer and finished building the orders app.', actions: ['Write', 'Bash'], usage: FAKE_USAGE };
+/** Scripted turns for the demo, optionally routed through a turn-boundary gate. */
+export function demoTurns(awaitMode) {
+    const askTurn = awaitMode === 'choices' ? AWAIT_CHOICES_TURN
+        : awaitMode === 'multiselect' ? AWAIT_MULTISELECT_TURN
+            : awaitMode === 'confirmation' ? AWAIT_CONFIRMATION_TURN
+                : undefined;
+    if (!askTurn)
+        return TURNS;
+    // The build asks (askTurn), the gate resolves, the framework re-prompts (RESUME_TURN).
+    return [askTurn, RESUME_TURN];
+}
+/** Build the scripted {@link FakeDriver} for the demo. */
+export function fakeDriver() {
+    return new FakeDriver({ turns: demoTurns(process.env.FRAMEWORK_FAKE_AWAIT), sessionId: 'fake-orders-app' });
+}
+//# sourceMappingURL=fake-script.js.map

package/dist/fake-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-script.js","sourceRoot":"","sources":["../src/fake-script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,cAAc,CAAA;AAExD;;;;;;GAMG;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAG,kEAAkE,CAAA;AAE7F,iFAAiF;AACjF,MAAM,UAAU,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAA;AAE5H,MAAM,UAAU,GAAa;IAC3B,IAAI,EAAE,qGAAqG;IAC3G,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;IACnC,KAAK,EAAE,UAAU;CAClB,CAAA;AACD,MAAM,KAAK,GAAe,CAAC,UAAU,CAAC,CAAA;AAEtC,kFAAkF;AAClF,wFAAwF;AACxF,2FAA2F;AAC3F,gFAAgF;AAChF,8EAA8E;AAC9E,MAAM,kBAAkB,GAAa;IACnC,IAAI,EACF,6DAA6D;QAC7D,4OAA4O;IAC9O,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU;CAClB,CAAA;AACD,MAAM,sBAAsB,GAAa;IACvC,IAAI,EACF,8EAA8E;QAC9E,mSAAmS;IACrS,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,UAAU;CAClB,CAAA;AACD,MAAM,uBAAuB,GAAa;IACxC,IAAI,EACF,kEAAkE;QAClE,wMAAwM;IAC1M,OAAO,EAAE,CAAC,OAAO,CAAC;IAClB,KAAK,EAAE,UAAU;CAClB,CAAA;AACD,MAAM,WAAW,GAAa,EAAE,IAAI,EAAE,2DAA2D,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;AAElJ,mFAAmF;AACnF,MAAM,UAAU,SAAS,CAAC,SAA6B;IACrD,MAAM,OAAO,GACX,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB;QAC5C,CAAC,CAAC,SAAS,KAAK,aAAa,CAAC,CAAC,CAAC,sBAAsB;YACtD,CAAC,CAAC,SAAS,KAAK,cAAc,CAAC,CAAC,CAAC,uBAAuB;gBACxD,CAAC,CAAC,SAAS,CAAA;IACb,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAA;IAC1B,uFAAuF;IACvF,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;AAC/B,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,UAAU,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAA;AAC7G,CAAC"}

package/dist/format-bytes.d.ts

@@ -0,0 +1,3 @@
+/** `1536` → `1.5 KB`. Absent, negative, or unparseable reads as an en dash, like a missing date. */
+export declare function formatBytes(bytes: number | undefined, fallback?: string): string;
+//# sourceMappingURL=format-bytes.d.ts.map

package/dist/format-bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-bytes.d.ts","sourceRoot":"","sources":["../src/format-bytes.ts"],"names":[],"mappings":"AAKA,oGAAoG;AACpG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAM,GAAG,MAAM,CAW7E"}

package/dist/format-bytes.js

@@ -0,0 +1,18 @@
+// A size for a label, not a report: two significant-ish digits and a unit, so "how much would
+// removing this give me back" is answerable at a glance (#798).
+const UNITS = ['B', 'KB', 'MB', 'GB', 'TB'];
+/** `1536` → `1.5 KB`. Absent, negative, or unparseable reads as an en dash, like a missing date. */
+export function formatBytes(bytes, fallback = '–') {
+    if (typeof bytes !== 'number' || !Number.isFinite(bytes) || bytes < 0)
+        return fallback;
+    let value = bytes;
+    let unit = 0;
+    while (value >= 1024 && unit < UNITS.length - 1) {
+        value /= 1024;
+        unit++;
+    }
+    // Whole numbers above 10 read better without a decimal: `512 MB`, not `512.0 MB`.
+    const rounded = value < 10 && unit > 0 ? Math.round(value * 10) / 10 : Math.round(value);
+    return `${rounded} ${UNITS[unit]}`;
+}
+//# sourceMappingURL=format-bytes.js.map

package/dist/format-bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-bytes.js","sourceRoot":"","sources":["../src/format-bytes.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,gEAAgE;AAEhE,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAA;AAEpD,oGAAoG;AACpG,MAAM,UAAU,WAAW,CAAC,KAAyB,EAAE,QAAQ,GAAG,GAAG;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAA;IACtF,IAAI,KAAK,GAAG,KAAK,CAAA;IACjB,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,OAAO,KAAK,IAAI,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,KAAK,IAAI,IAAI,CAAA;QACb,IAAI,EAAE,CAAA;IACR,CAAC;IACD,kFAAkF;IAClF,MAAM,OAAO,GAAG,KAAK,GAAG,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACxF,OAAO,GAAG,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAA;AACpC,CAAC"}

package/dist/framework-dir.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The directory, under a project root, that holds The Framework's own files.
+ *
+ * Its own module so every reader and writer of the directory (the hooks file, the project's saved
+ * prompts, the activation's `.gitignore`, a run's card, diary and inbox) spells it the same way.
+ *
+ * Nothing of the product's rides on a branch of its own any more: the agent archives are the
+ * `logs` skill's runs, on the shared `agent-data` branch that `@openagt/agent-data` names (#1769).
+ */
+export declare const THE_FRAMEWORK_DIR = ".the-framework";
+//# sourceMappingURL=framework-dir.d.ts.map

package/dist/framework-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-dir.d.ts","sourceRoot":"","sources":["../src/framework-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,mBAAmB,CAAA"}

package/dist/framework-dir.js

@@ -0,0 +1,11 @@
+/**
+ * The directory, under a project root, that holds The Framework's own files.
+ *
+ * Its own module so every reader and writer of the directory (the hooks file, the project's saved
+ * prompts, the activation's `.gitignore`, a run's card, diary and inbox) spells it the same way.
+ *
+ * Nothing of the product's rides on a branch of its own any more: the agent archives are the
+ * `logs` skill's runs, on the shared `agent-data` branch that `@openagt/agent-data` names (#1769).
+ */
+export const THE_FRAMEWORK_DIR = '.the-framework';
+//# sourceMappingURL=framework-dir.js.map

package/dist/framework-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-dir.js","sourceRoot":"","sources":["../src/framework-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAA"}