toolroll 0.9.104 → 0.9.105

package/dist/browser-workspace.d.ts

@@ -1,1985 +0,0 @@
-/** The browser consumes this contract with a type-only import. All HTML is
- * produced by the existing trusted server renderers, never by a model-supplied
- * fragment. These projections do not authenticate, mutate or grant authority. */
-import { type DisplayState, type StateCounts } from './agent-state-words.js';
-import type { TeamSnapshot } from './team-contract.js';
-import type { RunActivity } from './activity-line.js';
-import type { AssignmentSnapshot } from './assignment.js';
-export { browserCrewFromIndex, browserWorkActionHref } from './browser-crew.js';
-import type { Store } from './store.js';
-import type { WorkSummaryAccess } from './work-summary.js';
-import type { StatusTone, StepRow } from './workspace-ui.js';
-import type { PageWork } from './page-work-contract.js';
-import type { Ask, AskChip } from './needs-you.js';
-import type { WorkIndexGroup } from './work-index.js';
-import type { AssignmentCard } from './assignment-ui.js';
-import type { TaskStatus } from './task-status.js';
-import type { AcceptLabel, ResultActFacts, ResultActs } from './result-acts.js';
-import type { FirstRunStep, FirstTaskSuggestion, JourneyStep } from './first-run.js';
-export type BrowserProject = {
-    name: string;
-    path: string;
-    href: string;
-    knowledgeHref: string;
-};
-/** A project's state for one person (agent-state.ts): the strongest of its counts, the counts, and its tasks with
- * something live, asking, failed or unread (strongest first, `more` beyond those shown). `path` null: work with no
- * project yet. */
-export type BrowserProjectState = {
-    path: string | null;
-    name: string;
-    href: string;
-    state: DisplayState;
-    counts: StateCounts;
-    tasks: BrowserRailTask[];
-    more: number;
-    /** Everything here that needs this person, as opaque keys (one per obligation and version: the chime's subjects),
-     * with the task and agent each is about so a tab already showing one stays quiet. */
-    asks: BrowserAsk[];
-    /** The projects folded together to keep a snapshot inside one live frame: their counts summed, `more` of them. */
-    others?: true;
-};
-/** The most a summary snapshot may take in UTF-8 bytes, as the summary room sends it (JSON inside JSON, plus the
- * frame's envelope), well inside one live frame (live-bus.ts STREAM_LIMIT_BYTES). */
-export declare const SUMMARY_BUDGET = 24000;
-/** A snapshot's size on the wire: UTF-8 bytes of the JSON string the frame carries, plus its envelope. */
-export declare function summaryFrameBytes(value: unknown): number;
-/**
- * A summary snapshot that fits one live frame, with every count kept: long words are clipped, then rail tasks become
- * `more` (from the project listing most), then the quietest projects fold into one `others` entry with their counts
- * summed. Nothing is dropped silently: whatever is not listed is counted.
- */
-export declare function boundProjectSummary(rows: readonly BrowserProjectState[], budget?: number): BrowserProjectState[];
-/** One thing that needs this person, as the chime knows it: an opaque key (never words), and what it is about. */
-export type BrowserAsk = {
-    key: string;
-    task: string | null;
-    run: number | null;
-    /** When it last changed (ISO): one older than the chime's memory reaches back is never news. */
-    at: string;
-};
-/** One task on the rail: its state, and its agent's last act when one is at work (else the state's words). */
-export type BrowserRailTask = {
-    id: string;
-    title: string;
-    href: string;
-    state: DisplayState;
-    line: string;
-};
-/** count: tasks waiting on a person, shown beside Tasks when above zero. */
-export type BrowserNavigationItem = {
-    label: string;
-    href: string;
-    active: boolean;
-    count?: number;
-    /** What the count covers, said aloud and on hover: "3 need you in shop". */
-    countLabel?: string;
-};
-/** The Tasks badge's words: the count and the projects it covers
- * ("3 need you in shop", "1 needs you across all your projects"). */
-export declare function needsYouLabelOf(count: number, projectName: string | null, saturated?: boolean): string;
-export type BrowserChatLink = {
-    kind: 'project' | 'task';
-    title: string;
-    href: string;
-    at: string | null;
-    active: boolean;
-};
-export type BrowserCrewItem = {
-    id: string;
-    title: string;
-    project: string | null;
-    state: AssignmentSnapshot['state'];
-    label: string;
-    tone: StatusTone;
-    href: string;
-    resultHref: string | null;
-    action: {
-        label: string;
-        href: string;
-    } | null;
-    /** When the task family last changed (the index's own sort time), shown as the row's age. */
-    updatedAt: string;
-    /** The server's status detail, when Waiting, Failed or Needs you adds to its badge. */
-    detail?: string;
-    /** "<name> is on it.": the person's own lead took it on, by the name they gave it. */
-    lead?: string;
-    /** A running task: what its agent did last, and when. */
-    activity?: RunActivity;
-};
-export type BrowserMessage = {
-    id: number;
-    role: 'operator' | 'assistant';
-    text: string;
-    html: string;
-    activity: string | null;
-    createdAt: string;
-    cardsHtml: string;
-    /** The same cards as data, confirmed in place (chat cards). */
-    cards?: BrowserActionCard[];
-};
-/** A card the lead proposed: what it would do (the server's own body) and
- * the one act it offers. Confirming posts to the card's own door. */
-export type BrowserActionCard = {
-    id: number;
-    kind: string;
-    label: string;
-    state: 'drafting' | 'pending' | 'confirming' | 'confirmed' | 'refused' | 'dismissed' | 'expired';
-    body: string;
-    said: string | null;
-    links: BrowserLink[];
-    primary: {
-        kind: 'confirm';
-        label: string;
-        irreversible: boolean;
-        native: boolean;
-    } | {
-        kind: 'link';
-        label: string;
-        href: string;
-    } | null;
-    dismissable: boolean;
-    note: string | null;
-    /** A Toolroll card: `body` is its data, and it confirms nothing. */
-    data?: true;
-};
-export type BrowserConversation = {
-    sessionId: number;
-    user: string;
-    version: string;
-    messages: BrowserMessage[];
-    pendingTurnId: number | null;
-    requestId: string;
-    maxChars: number;
-    taskId: string | null;
-    resultRunId: number | null;
-    /** A project's own thread (v77); absent or null for the lead conversation or a task. */
-    project?: string | null;
-    /** The lead thread a change in reachable projects replaced (mate arc ruling 9): shown above a divider, read only. */
-    previous?: {
-        messages: BrowserMessage[];
-    } | null;
-    /** How the last reply failed, from its saved turn (docs/plans/responsive-chat.md §3.4); absent or null otherwise. */
-    failure?: string | null;
-};
-/** A page rebuilt as React components (shadcn/ui). The server still renders
- * its HTML as the no-JavaScript fallback; forms post to the same routes. */
-export type BrowserLink = {
-    label: string;
-    href: string;
-};
-export type BrowserTasksView = {
-    kind: 'tasks';
-    /** List (rows under group headings) or Board (the same index as columns). */
-    layout: 'list' | 'board';
-    /** The status filters (All, Needs you, Running, Queued, Finished), as addresses with their counts. */
-    tabs: (BrowserLink & {
-        key?: string;
-        count: number;
-        active: boolean;
-    })[];
-    /** The project filter: All and each project in view (null with one project). */
-    projects?: {
-        key: string;
-        label: string;
-        href: string;
-        active: boolean;
-    }[] | null;
-    /** The List and Board addresses for this same filter. */
-    layouts: {
-        list: string;
-        board: string;
-    };
-    /** The scope the counts cover, in words ("in payments-api", "across all your projects"). */
-    scope?: string;
-    /** Tasks waiting on a person in this view's scope. */
-    needsYou: number;
-    /** All and Needs you list their rows in these groups, in this order (empty ones left out); null: one plain list. */
-    groups: {
-        key: BrowserTaskGroup;
-        label: string;
-        count: number;
-    }[] | null;
-    rows: BrowserTaskRow[];
-    /** The Board view's columns (Needs you, Queued, Running, Finished); null in the List view. */
-    board?: {
-        key: 'needs' | 'queued' | 'running' | 'finished';
-        label: string;
-        count: number;
-        href: string;
-        empty: string;
-        rows: BrowserTaskRow[];
-    }[] | null;
-    /** Archived tasks, offered at the foot of Finished (and current in Archived). */
-    archived?: (BrowserLink & {
-        count: number;
-        active: boolean;
-    }) | null;
-    empty: {
-        text: string;
-        action: BrowserLink | null;
-    } | null;
-    pages: {
-        first: string | null;
-        next: string | null;
-    };
-    tools: BrowserLink[];
-    newTask: BrowserLink;
-    /** Put away old tasks (an approver's): the preview page. */
-    putAway?: BrowserLink | null;
-    /** v105: subscription windows and monthly budgets, one tile each (an instance operator's; null when there are none). */
-    limits: BrowserLimits | null;
-    /** The stored-state filter (Any state, Queued, Running, Done, Failed, Cancelled), each a real link starting on page one. */
-    states?: (BrowserLink & {
-        active: boolean;
-    })[];
-};
-export type BrowserTaskRow = {
-    id: string;
-    title: string;
-    href: string;
-    project: string | null;
-    age: string;
-    status: {
-        label: string;
-        tone: StatusTone;
-        token: string;
-    };
-    /** The row's chip word and tone (src/design/KIT.md): the ask under Needs you, else the headline. */
-    word: {
-        word: string;
-        tone: '' | 'needs' | 'ask' | 'live' | 'done' | 'failed';
-    };
-    /** What a Needs you row asks: its group. */
-    ask: Ask | null;
-    /** The row's chip under its group: the specific ask (Plan, Result, Mismatch, Plan changed, Failed, Builder offline), or none. */
-    chip: AskChip | null;
-    group: BrowserTaskGroup;
-    /** The status rank: 0 waits on a person, 1 runs, 2 queued or waiting, 3 finished, 4 stopped or put away. */
-    rank: number;
-    action: BrowserLink | null;
-    detail: string | null;
-    problem: string | null;
-    notes: string[];
-    /** Put away, or Restore in Archived (task-tidy.md): a POST to the task's own route; null for a viewer or live work. */
-    tidy?: {
-        action: string;
-        label: 'Archive' | 'Restore';
-        returnTo: string;
-    } | null;
-};
-/** One limit: a plan's usage window ("Claude · 5-hour, 48%") or a monthly budget ("shop · Budget, $4.20 of $10"). */
-export type BrowserTaskGroup = WorkIndexGroup;
-export type BrowserLimitTile = {
-    key: string;
-    name: string;
-    window: string;
-    value: string;
-    unit: string;
-    percent: number;
-    detail: string;
-    tone: 'neutral' | 'warning' | 'danger';
-    marks: number[];
-    title: string | null;
-    href: string | null;
-};
-export type BrowserLimits = {
-    tiles: BrowserLimitTile[];
-};
-/** The sidebar's usage chip (limits-ui.ts usageChipOf): the most-used subscription window, stale when its reading is old. */
-export type BrowserUsageChip = {
-    text: string;
-    tone: BrowserLimitTile['tone'];
-    stale: boolean;
-    href: string;
-    title: string;
-};
-export type BrowserUpdates = {
-    current: string;
-    /** The latest release the last check found; null before any check has worked. */
-    latest: {
-        version: string;
-        newer: boolean;
-        security: boolean;
-        notes: string;
-        url: string;
-    } | null;
-    updateCommand: string;
-    /** The daily check: off by TOOLROLL_NO_UPDATE_CHECK (byEnv) or by this switch; only an operator may flip it. */
-    check: {
-        on: boolean;
-        byEnv: boolean;
-        canManage: boolean;
-    };
-    workers: {
-        name: string;
-        version: string | null;
-        older: boolean;
-    }[];
-};
-/** A fold on the task page. Its HTML is the server's own section body, so
- * forms, ids and page scripts are unchanged. */
-export type BrowserTaskSection = {
-    id: string;
-    title: string;
-    html: string;
-    open: boolean;
-    count: number | null;
-};
-/** `at`: a moment, shown in the reader's own time ("16:39", "Yesterday 16:39", "Sep 28"). */
-export type BrowserTaskFact = {
-    label: string;
-    parts: (string | BrowserLink | {
-        seal: string;
-    } | {
-        at: string;
-    })[];
-};
-/** One entry in a task's thread, in time order beside the task's own
- * conversation: the plan, the agent's progress notes and results, its
- * questions, and the person's replies. `html` is the server's own card (same
- * forms and ids) when the entry carries one. */
-export type BrowserTaskThreadItem = {
-    key: string;
-    at: string;
-    kind: 'filed' | 'plan' | 'progress' | 'result' | 'question' | 'reply';
-    who: 'agent' | 'person';
-    author: string;
-    title: string;
-    text: string | null;
-    link: BrowserLink | null;
-    html: string;
-    more: {
-        summary: string;
-        html: string;
-    } | null;
-};
-/** The task's metadata, grouped for the Details panel (desk) or sheet (phone). */
-export type BrowserTaskDetailGroup = {
-    title: 'Work' | 'Links' | 'Review' | 'About';
-    facts: BrowserTaskFact[];
-};
-export type BrowserTaskView = {
-    kind: 'task';
-    id: string;
-    title: string;
-    project: string | null;
-    scout: boolean;
-    tabs: (BrowserLink & {
-        active: boolean;
-    })[];
-    version: {
-        label: string;
-        current: BrowserLink;
-    } | null;
-    /** Put away (task-tidy.md): "Archived by tidy: <why>", when, and Restore for an approver. */
-    archived?: {
-        words: string;
-        at: string;
-        restore: {
-            action: string;
-            returnTo: string;
-        } | null;
-    } | null;
-    /** The status card; `statusHtml` stands in when no assignment projection exists. */
-    status: AssignmentCard | null;
-    statusHtml: string;
-    /** The approval ceremony or its updated terms, exactly as signed. */
-    approval: string;
-    /** Check again (a build Toolroll could not prove stopped from this computer), when the status asks for it. */
-    recheckStopped?: {
-        action: string;
-        run: number;
-    } | null;
-    /** Build again, in place, when the status asks for it (a result built to an earlier plan). */
-    /** `pins`: the build and approved plan the page read, which a local owner's Retry binds to (local-owner slice 3). */
-    rebuild?: {
-        action: string;
-        pins?: {
-            run: number;
-            digest: string;
-        } | null;
-    } | null;
-    /** What a failed task missed, in one line (the requirement it missed, the failing check's error line, or the stop
-     * reason), the evidence line behind it, one suggestion of what to change, and where to see it (its build's result
-     * page, or that exact check-log line); and Retry itself, its note starting with the suggestion. */
-    failure?: BrowserFailure | null;
-    retry?: {
-        action: string;
-        note?: string;
-        pins?: {
-            run: number;
-            digest: string;
-        } | null;
-    } | null;
-    /** Run checks in place, on a status row that offers it: posts and comes back to this page. */
-    runChecks?: BrowserRunChecks | null;
-    /** A live build: the step it is on (or stuck on, with the act that helps), and the earlier attempts that stopped
-     * before it, folded into one quiet line. */
-    progress?: {
-        line: string;
-        stuck: {
-            step: number;
-            why: string | null;
-            line: string;
-            action: BrowserLink | null;
-        } | null;
-        /** The plan's steps and where each stands, from the latest checkpoint (all pending before the first). */
-        steps?: {
-            title: string;
-            state: "pending" | "current" | "completed" | "blocked";
-        }[];
-    } | null;
-    /** The Plan row: the plan's lead sentence, who wrote it and when, and its body (the plan sheet and the plan's editor;
-     * only the editor while the approval shows the sheet). `planning`: a planner is writing it now. Null: no plan yet.
-     * `key` names what the body holds (the editor alone, or the sheet of one exact plan): the page installs the body once
-     * and again when the key changes. */
-    plan?: {
-        lead: string | null;
-        by: string | null;
-        at: string | null;
-        html: string;
-        planning: boolean;
-        updating?: boolean;
-        key: string;
-    } | null;
-    /** What the agent did last on the live run, and when; the page words it against its own clock (activity-line.ts). */
-    activity?: RunActivity | null;
-    /** The task's live room (GET /live?room=task:<root>): change nudges and who else has it open. */
-    live?: {
-        room: string;
-        at: string | null;
-    } | null;
-    /** The work panel's run (docs/plans/task-page-steps.md "Watch the work"): the live build, else the latest one, who ran it,
-     * and its records window on the run page (null on a page that asks for a password). Null: no build yet. */
-    work?: {
-        run: number;
-        live: boolean;
-        agent: string;
-        transcript: string | null;
-    } | null;
-    /** Stop, on the Building card: the exact live build's stop form (posts its run id). */
-    stop?: {
-        action: string;
-        run: number;
-    } | null;
-    /** The running attempt's composer (steer-controls.ts): what it takes, said plainly, and its note box when it takes
-     * notes. Pause and Stop stay as `pause` and `stop`. */
-    steering?: {
-        controls: BrowserAgentControls;
-        steer: {
-            action: string;
-            run: number;
-        } | null;
-    } | null;
-    /** This task's latest attempts, newest first: a draft this tab wrote for one that has since ended shows with a way
-     * to send it to the next attempt. */
-    steerRecent?: number[];
-    /** Pause and Pause and steer, beside Stop: the same exact live Claude build, one request id per form (Pause, the note,
-     * Resume), where its latest pause stands (null: running), and until when a paused build can wait before it ends. */
-    pause?: {
-        action: string;
-        run: number;
-        state: "pausing" | "paused" | null;
-        requests: [string, string, string];
-        until?: string | null;
-        limitMs?: number | null;
-    } | null;
-    /** The Building card's link to the live build's own record ("Build #N record", /r/<id>). */
-    record?: BrowserLink | null;
-    earlier?: {
-        summary: string;
-        attempts: {
-            label: string;
-            href: string;
-            text: string | null;
-        }[];
-    } | null;
-    /** Server cards that may need a person now (stop/resume, scope prompt, plan, live attempt). */
-    /** `instance`: what the block is about now (the attempt card: its build). The page installs a block's HTML once;
-     * another instance replaces it. */
-    lead: {
-        key: string;
-        html: string;
-        instance?: string;
-    }[];
-    questions: string;
-    facts: BrowserTaskFact[];
-    sections: BrowserTaskSection[];
-    manage: BrowserTaskSection[];
-    /** The armed cancel form; null once the task cannot be cancelled. */
-    cancel: {
-        html: string;
-        open: boolean;
-    } | null;
-    /** "Do this every time…": Settings → Flows with the matching starter flow marked. */
-    everyTime?: {
-        href: string;
-        starter: string;
-    } | null;
-    /** The task's road, Plan → Approval → Build → Checks → Ready (four for a report), from recorded facts. */
-    journey?: JourneyStep[] | null;
-    /** The page's step rows (workspace-ui.ts stepRowsOf over this view, after every change the server made to it): the
-     * steps are the page. Null: no road (cancelled, or no status), so the page keeps its status block. */
-    steps?: StepRow[] | null;
-    /** The thread's server-side entries; the conversation's messages join them in time order. */
-    thread?: BrowserTaskThreadItem[];
-    details?: BrowserTaskDetailGroup[];
-    /** Where to message the agent when this page carries no conversation (null: messaging isn't available here). */
-    chatHref?: string | null;
-    /** One page per task (docs/plans/one-page-task-and-agent.md): the tab the address names (Activity when none). */
-    tab?: BrowserTaskTab;
-    /** The Result tab: the selected attempt's result exactly as its result page shows it, whether it is the task's
-     * current one (the header then owns its status and ceremonies), and every result attempt to pick from. Null: none yet. */
-    result?: {
-        selected: NonNullable<BrowserResultView["selected"]>;
-        current: boolean;
-        attempts: {
-            label: string;
-            href: string;
-            current: boolean;
-        }[];
-        /** What the result shows, as one stamp (every check, note and control in it; never a form's fresh request token): the
-         * page holds the result it loaded and says when a newer one is ready, so its evidence and decision always agree. */
-        revision: string;
-    } | null;
-    /** Where the approval sits: under the header when it is the thing to do now, else at the top of the Plan tab. */
-    approvalPlacement?: "lead" | "plan";
-    /** The kit approval box (src/design/KIT.md): the act's form and the facts that decide password, one click or none;
-     * `planHtml` is what it signs, for the Plan tab. Null when nothing waits on this person's approval here. */
-    approve?: {
-        action: string;
-        fields: Record<string, string>;
-        label: string;
-        heading: string;
-        text: string;
-        kind: import("./design/kit.js").ApprovalKind;
-        facts: {
-            passwordless: boolean;
-            remembered: boolean;
-            automatic?: boolean;
-        };
-        /** When a remembered password stops counting (ISO); the page words it in the viewer's zone. */
-        rememberedUntil: string | null;
-        planHtml: string;
-        /** The plan sheet alone (no editor, no form): what Home shows beside its Approve (live-pages-and-home.md B2.1). */
-        sheetHtml?: string;
-        /** The terms line in words, when the rule isn't one of the kit's (easy-start C5: a laptop's own owner). */
-        termsWords?: string;
-    } | null;
-    /** Ship: the pull request's checks, each on one time axis (task ship's twin). Null: no checks read yet. */
-    ship?: {
-        pr: number;
-        head: string;
-        state: "running" | "passed" | "failed" | "none";
-        rows: import("./design/kit.js").TimingRow[];
-        summary: string;
-        observedAt: string;
-    } | null;
-    /** "Can I merge?" (merge-checklist.ts; `toolroll task ready` is its twin): each row and its blocker's form. Null: no result yet. */
-    mergeReady?: MergeReadyView | null;
-    /** A release's own steps (release status's twin). Null: this task is no release, or nothing recorded. */
-    release?: {
-        tag: string;
-        version: string;
-        pr: number | null;
-        state: "running" | "waiting" | "failed" | "done";
-        rows: import("./design/kit.js").TimingRow[];
-        headline: string;
-        stopped: {
-            step: string;
-            message: string;
-            at: string;
-        } | null;
-        startedAt: string;
-        /** The step it is on now, and where that is in its steps. */
-        at?: {
-            step: string;
-            name: string;
-            index: number;
-            of: number;
-        } | null;
-    } | null;
-    /** How the plan was approved: by whom and how, or the rule that approved it automatically. */
-    approved?: {
-        by: string;
-        at: string;
-        automatic: boolean;
-        rule: string | null;
-        how: string;
-        version: string;
-    } | null;
-    /** ⋯ More actions: the task's secondary acts, the same order on the task and agent pages, destructive last. */
-    more?: BrowserTaskMore[];
-    /** The task's full audit record (its link in the header); it moved out of More (docs/plans/plain-toolroll.md P1.3). */
-    audit?: {
-        label: string;
-        href: string;
-    } | null;
-};
-export type BrowserTaskTab = "activity" | "result" | "plan" | "attempts";
-/** One ⋯ item: a plain link, a copy of this page's address, a one-click POST (never a ceremony), or a go-to that switches
- * to the tab holding the item's own form, opens it and focuses it (`target`: that element's id). */
-export type BrowserTaskMore = {
-    group: "work" | "share" | "danger";
-    label: string;
-} & ({
-    kind: "link";
-    href: string;
-} | {
-    kind: "copy";
-} | {
-    kind: "post";
-    action: string;
-    fields: Record<string, string>;
-} | {
-    kind: "goto";
-    tab: BrowserTaskTab;
-    target: string;
-});
-/** One project on the Projects page; opening it is a POST to /projects/open. */
-export type BrowserProjectRow = {
-    name: string;
-    path: string;
-    shortPath: string;
-    /** The project's own page (/projects/<name>). */
-    href: string;
-    /** The session's open project. */
-    open: boolean;
-    /** When it was last opened here; null for a project only seen in the queue. */
-    openedAt: string | null;
-    /** The row's chip: something waits on this person, or runs; null for neither. */
-    status: 'needs' | 'running' | null;
-    /** Its counts in words ("2 need you · 1 running"); null when not scanned. */
-    summary: string | null;
-};
-export type BrowserProjectsView = {
-    kind: 'projects';
-    /** Arrived from New task: choosing where the task belongs. */
-    choosing: boolean;
-    /** A refusal that belongs to the page, not to one form (already says what didn't change). */
-    problem: string | null;
-    /** A neutral line (a finished clone). */
-    said: string | null;
-    returnTo: string;
-    recent: BrowserProjectRow[];
-    available: BrowserProjectRow[];
-    /** The add ways (the server's forms), the clone review a preview minted, and whether the drawer opens at once
-     * (a refused GitHub link, shown next to its field). */
-    add: {
-        html: string;
-        review: string | null;
-        openOnLoad: boolean;
-    };
-};
-export type BrowserResultTab = 'summary' | 'changes' | 'checks';
-/** The shared result panel in parts. Each tab's content, the feedback
- * section and the learning card are the server's own HTML; the page script
- * binds to the same data attributes and ids (tabs, drafts, line notes). */
-export type BrowserResultPanel = {
-    attributes: Record<string, string>;
-    heading: string;
-    outcome: string;
-    /** The shared task status (task-status.ts): headline, sentence and detail rows. */
-    status: TaskStatus | null;
-    reviewHistory: string | null;
-    attention: string[];
-    /** Requirements only a person can confirm, in plain words, and the one
-     * Accept that records the decision (null when it is not offered here). */
-    youCheck: {
-        lines: string[];
-        items: BrowserCheckItem[];
-        accept: {
-            action: string;
-            run: number;
-            returnTo: string;
-        } | null;
-    } | null;
-    /** The Requirements row's counts, so it updates as the person answers their checks (null when it doesn't count them). */
-    requirements?: {
-        met: number;
-        total: number;
-        yours: number;
-    } | null;
-    /** Storage limits on saved output (shortened logs or diffs): shown on request. */
-    limits: string[];
-    tabs: {
-        key: BrowserResultTab;
-        label: string;
-        count: string;
-        href: string;
-        active: boolean;
-    }[];
-    views: {
-        key: BrowserResultTab;
-        html: string;
-    }[];
-    history: string;
-    learning: string;
-    request: string | null;
-    /** A browser session may attach feedback to this result's sealed diff. */
-    canRequest: boolean;
-    /** Needs you: the one action that resolves it, first and filled; `confirm` posts behind the password. */
-    need: BrowserNeedAction | null;
-    /** The feedback section holds only the closed form (no notes, revisions or history). */
-    requestQuiet: boolean;
-};
-/** One "You check this one" item and the evidence to judge it by: the
- * changed lines it cites (or, citing none, the change's own first lines),
- * its screenshots, and the agent's note. Wrapped text, never sideways. */
-export type BrowserCheckItem = {
-    id: string;
-    statement: string;
-    words: string;
-    note: string | null;
-    excerpts: {
-        path: string;
-        cited: boolean;
-        lines: {
-            kind: "addition" | "deletion" | "context";
-            line: number | null;
-            text: string;
-        }[];
-        more: number;
-    }[];
-    shots: {
-        src: string;
-        href: string;
-        caption: string;
-        image?: import("./result-review.js").FeedbackImage;
-    }[];
-};
-/** The result's one decision: what Accept is called, why it isn't plain
- * Accept and finish, and what pressing it does. `base`: the same words before
- * the person's own checks, which the page adds as they answer them. */
-export type BrowserResultDecision = {
-    label: AcceptLabel;
-    ready: boolean;
-    why: string | null;
-    effect: string;
-    sentence: string;
-    base?: {
-        label: AcceptLabel;
-        ready: boolean;
-        why: string | null;
-    };
-};
-/** A Needs you action: a link, (Check again, Build again) one
- * button, or (on the result itself) Accept, which records the person's acceptance; `note` asks why
- * when the evidence disagrees. */
-export type BrowserNeedAction = {
-    label: string;
-    href: string | null;
-    confirm: {
-        action: string;
-        run: number;
-        returnTo: string;
-    } | null;
-    accept?: {
-        action: string;
-        run: number;
-        returnTo: string;
-        note: string | null;
-    } | null;
-    /** Build again (a result built to an earlier plan): one button, the task page's requeue. */
-    rebuild?: {
-        action: string;
-    } | null;
-};
-export type BrowserResultView = {
-    kind: 'result';
-    results: {
-        title: string;
-        href: string;
-        at: string;
-        status: {
-            label: string;
-            tone: StatusTone;
-        } | null;
-        notes: string[];
-        current: boolean;
-        needsYou: boolean;
-    }[];
-    /** How many results need a person; the list's cap when it is full. */
-    attention: number;
-    capped: number | null;
-    missing: string | null;
-    beyond: boolean;
-    selected: {
-        taskId: string;
-        title: string;
-        project: string | null;
-        build: number | null;
-        taskHref: string;
-        chatHref: string;
-        status: {
-            label: string;
-            tone: StatusTone;
-            token: string;
-        };
-        problem: string | null;
-        next: {
-            kind: string;
-            title: string;
-            detail: string;
-            control: string;
-        } | null;
-        /** Accept and finish: the exact receipt read; `accept` when the one request also records the person's acceptance
-         * (`note`: the words over the reason field it asks for, or null for none). */
-        complete: {
-            action: string;
-            receipt: string;
-            run: number;
-            accept?: {
-                note: string | null;
-            } | null;
-            returnTo?: string;
-        } | null;
-        /** How its run went (docs/plans/run-efficiency.md): recorded numbers only, unknowns null. */
-        efficiency?: import("./run-efficiency.js").RunEfficiency | null;
-        /** What its network was and what its proxy saw (egress.ts): display only. */
-        network?: import("./egress.js").RunNetworkRecord | null;
-        /** Where the time went: its release check's parts and the task's deploys (latency-timeline.ts), display only. */
-        timing?: import("./latency-timeline.js").TimingView | null;
-        /** Words for the result's Accept: Accept and finish when offered, else the Needs you acceptance. */
-        decision: BrowserResultDecision | null;
-        checks: {
-            detail: string;
-            problem: boolean;
-            logHref: string | null;
-        } | null;
-        /** A refuted result's recorded disagreements: the headline when the report doesn't match the changes (null when a
-         * failed check is the blocker, so the status keeps its own), each disagreement in plain words with the changed lines
-         * it concerns (`absent`: a file the changes don't have), and the recorded words they already say, so no caveat
-         * repeats them. Null otherwise. */
-        mismatch: {
-            headline: string | null;
-            rows: {
-                text: string;
-                path: string | null;
-                lines: string | null;
-                href: string | null;
-                absent: boolean;
-                noteLabel: string | null;
-            }[];
-            said: string[];
-        } | null;
-        /** The one ink act that resolves the result, the one outline act beside it, and why it can't be accepted yet (result-acts.ts). */
-        acts: ResultActs;
-        /** The facts the acts were chosen from, so the page chooses again as the person answers their checks. */
-        actFacts?: ResultActFacts;
-        /** Run checks on this result's commit: the project's check, when it didn't run. */
-        runChecks: BrowserRunChecks | null;
-        /** A failed build's result: what it missed and the suggestion Retry's note starts with; Retry itself when the task
-         * can be retried from here. Null for every other result. */
-        failure?: (BrowserFailure & {
-            retry: {
-                action: string;
-                note: string;
-                pins?: {
-                    run: number;
-                    digest: string;
-                } | null;
-            } | null;
-            /** A failed task's delivered result, accepted only in outline with a reason (the task's accept-proof). */
-            acceptAnyway?: {
-                action: string;
-                run: number;
-                returnTo: string;
-            } | null;
-        }) | null;
-        /** The raw run record, under Details: its facts and the full record. */
-        record: {
-            build: number;
-            href: string;
-            facts: {
-                label: string;
-                value: string;
-            }[];
-        } | null;
-        /** The signed scope; null when none was filed. */
-        intent: {
-            approval: string;
-            approvedAt: string | null;
-            html: string;
-        } | null;
-        noRun: string | null;
-        panel: BrowserResultPanel | null;
-        notes: {
-            author: string;
-            at: string;
-            note: string;
-        }[];
-    } | null;
-};
-export type BrowserFailure = {
-    line: string;
-    evidence: string | null;
-    suggestion: string;
-    link: {
-        label: string;
-        href: string;
-    } | null;
-};
-export type BrowserRunChecks = {
-    action: string;
-    level: "quick" | "full";
-    returnTo: string;
-};
-/** One zone on a flow's canvas: its step, where it leads, and where it sits. */
-export type BrowserFlowStage = {
-    id: string;
-    title: string;
-    kind: "inbox" | "task" | "report" | "approval" | "check" | "pull-request" | "update" | "notify" | "sort" | "draft" | "request" | "email" | "tool" | "wait" | "subagent" | "send" | "choose" | "done";
-    zone: {
-        x: number;
-        y: number;
-        w: number;
-        h: number;
-        color: string;
-    };
-    instructions: string | null;
-    planning: "auto" | "required" | "skip" | null;
-    approver: string | null;
-    message: string | null;
-    /** An approval zone the flow's owner decides. */
-    toOwner?: boolean;
-    /** v87: a web request, an email, a project tool call. */
-    request?: {
-        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-        url: string;
-        headers: Record<string, string>;
-        body: string | null;
-    };
-    email?: {
-        to: string;
-        subject: string;
-        body: string;
-    };
-    tool?: {
-        server: string;
-        name: string;
-        args: string;
-    };
-    close: boolean | null;
-    script: string | null;
-    /** v90: a script zone runs in an empty folder or a copy of the card's work; the answers its "goto:" line picks; the saved secrets it gets. */
-    runIn?: "folder" | "copy";
-    routes?: {
-        answer: string;
-        to: string;
-    }[];
-    secrets?: string[];
-    /** A sort zone: Jev's question, its answers and where each goes, how sure it must be to act alone, and what else it notes. */
-    sort: {
-        question: string;
-        answers: {
-            answer: string;
-            means: string;
-            to: string;
-        }[];
-        sureAt: number;
-        notes: {
-            id: string;
-            kind: "score" | "yes-no";
-            question: string;
-            levels: string[] | null;
-        }[];
-    } | null;
-    /** v91: a Wait zone waits for a reply to the card's email (onFail: no reply in time) or a set time; any other zone may have a time limit. */
-    wait?: {
-        for: "reply" | "time" | "hours";
-        minutes: number;
-        from?: string | undefined;
-        to?: string | undefined;
-        timeZone?: string | undefined;
-    };
-    /** A Pull request zone merges once checks pass (after a person approved), this way. */
-    merge?: "squash" | "merge" | "rebase" | undefined;
-    limit?: {
-        minutes: number;
-        to: string | null;
-    } | undefined;
-    /** v92: the subagent who decides (an approval zone) or handles (a subagent zone) it. */
-    subagent?: string | undefined;
-    /** v96: a subagent zone sends what the subagent writes back to whoever asked. */
-    reply?: boolean | undefined;
-    /** A "Person chooses" zone's buttons: each one's words and the zone it leads to ("end" ignores the card). */
-    options?: {
-        label: string;
-        to: string;
-    }[] | undefined;
-    /** A Build zone in another project: its path. */
-    repo?: string | undefined;
-    /** v144: a script zone that starts a browser (Playwright's Chromium); it runs only once a person allows browser use for the flow. */
-    browser?: true | undefined;
-    next: string | null;
-    onFail: string | null;
-};
-/** One card: a piece of work, where it is, what it waits on, what zones said. */
-/** After research, one of the report's items as the message numbered it, with its screenshot when it has one. */
-export type BrowserFlowSentItem = {
-    number: number;
-    title: string;
-    lines: string[];
-    source: string;
-    url: string;
-    image: {
-        src: string;
-        caption: string;
-    } | null;
-};
-export type BrowserFlowCard = {
-    id: number;
-    title: string;
-    description: string | null;
-    stage: string;
-    state: "active" | "done" | "cancelled";
-    waiting: string | null;
-    /** It waits because browser use isn't allowed for the flow (flow-browser.ts): the card offers Allow browser. */
-    browserWait?: true;
-    task: {
-        id: string;
-        href: string;
-        /** Its running attempt's composer (steer-controls.ts), for an approver: what it takes, its controls, its note box. */
-        composer?: {
-            controls: BrowserAgentControls;
-            steer: {
-                action: string;
-                run: number;
-            } | null;
-        };
-    } | null;
-    createdBy: string;
-    updatedAt: string;
-    canDecide: boolean;
-    outputs: {
-        stage: string;
-        title: string;
-        text: string;
-    }[];
-    history: {
-        text: string;
-        at: string;
-    }[];
-    /** Where a trigger found it: a GitHub or Linear issue, another flow's card, a button, a schedule. */
-    /** `proved` and `host` (v126): how an outside event's delivery was proved ("signed by Sentry", "unsigned") and its
-     * link's host, always shown beside the link. */
-    source: {
-        kind: string;
-        label: string;
-        url: string | null;
-        proved?: string;
-        host?: string | null;
-        shown?: string | null;
-    } | null;
-    /** Who is responsible for it, who follows it, and whether the viewer does. */
-    owner: string | null;
-    watchers: string[];
-    watching: boolean;
-    /** Owned by the viewer, followed by them, or waiting on their decision. */
-    mine: boolean;
-    /** What people said on it, oldest first; ownership changes read as history instead. */
-    comments: {
-        id: number;
-        author: string;
-        body: string;
-        mentions: string[];
-        at: string;
-    }[];
-    /** The latest sort: its short chip ("Bug · 94% · Now") and whether Jev was sure enough to act alone. */
-    sorted: {
-        chip: string;
-        confident: boolean;
-    } | null;
-    /** Waiting at a decision after a draft: the draft, which the person can edit before approving. */
-    draft: {
-        zone: string;
-        title: string;
-        text: string;
-    } | null;
-    /** v91: when its Wait zone gives up or moves on, or its zone's time limit comes (shown in the viewer's own time). */
-    deadline?: {
-        at: string;
-        label: string;
-    } | null;
-    /** v92: a subagent's open question about this visit, and whether the viewer is the one asked. */
-    question?: {
-        id: number;
-        from: string;
-        question: string;
-        options: {
-            id: string;
-            label: string;
-        }[];
-        askedOf: string;
-        mine: boolean;
-        /** v94: a tool call waiting for approval — why the subagent wants it, and why it needs approval. */
-        call?: {
-            why: string;
-            rule: string;
-        } | null;
-    } | null;
-    /** v92: what the subagent said when it handed this decision to a person. */
-    handoff?: {
-        from: string;
-        note: string;
-    } | null;
-    /** Waiting at a "Person chooses" zone: what was sent, its options and whether the viewer is the one who chooses. */
-    choose?: {
-        entry: number;
-        title: string;
-        summary: string;
-        links: {
-            label: string;
-            href: string;
-        }[];
-        items?: BrowserFlowSentItem[];
-        person: string;
-        mine: boolean;
-        options: {
-            choice: number;
-            label: string;
-        }[];
-        reply: boolean;
-    } | null;
-    /** What a "Send to me" (or an earlier choice) last sent the card's person. */
-    sent?: {
-        title: string;
-        summary: string;
-        links: {
-            label: string;
-            href: string;
-        }[];
-        items?: BrowserFlowSentItem[];
-        person: string;
-        at: string;
-        cardHtml?: string;
-    } | null;
-    /** A finished card's steps as a Toolroll card (flow-result-card.ts), when no "Send to me" already showed them. */
-    resultHtml?: string;
-    /** v94: every tool call subagents made or asked to make on this card, oldest first: the receipts. */
-    calls?: {
-        id: number;
-        who: string;
-        words: string;
-        state: string;
-        outcome: string;
-        why: string;
-        result: string | null;
-        at: string;
-        /** v97: the subagent's id and the action that undoes this call, when a person can press Undo. */
-        subagent?: number;
-        undo?: string | null;
-    }[];
-};
-/** What starts cards in a flow on its own. */
-export type BrowserFlowTrigger = {
-    id: number;
-    kind: string;
-    words: string;
-    name: string;
-    detail: string;
-    zone: string;
-    zoneId: string;
-    state: "active" | "paused" | "removed";
-    status: string | null;
-    statusAt: string | null;
-    failing: boolean;
-    /** Where the status points a person (a plane review's long waits: Needs you). */
-    statusLink: BrowserLink | null;
-    button: {
-        label: string;
-        questions: string[];
-    } | null;
-    /** A webhook trigger: whether it can prove deliveries yet (Linear, Sentry and Vercel need their signing secret pasted).
-     * v126: a webhook's sender (who signs it; "none" is the address alone), whether Toolroll makes its secret, and a
-     * warning in words when anyone could add cards (unsigned) or any project could (a Sentry or Vercel webhook unscoped). */
-    hook: {
-        ready: boolean;
-        needsSecret: boolean;
-        sender: string | null;
-        makesSecret: boolean;
-        warning: string | null;
-        readerNote: string | null;
-        /** v126: deliveries turned away because too many were already held, until a person clears it, and how to resend them. */
-        dropped: {
-            count: number;
-            since: string;
-            resend: string;
-        } | null;
-        /** v126: the Sentry or Vercel project (and Vercel team) it takes deliveries from; null: any the secret covers. */
-        scope: {
-            project: string | null;
-            team: string | null;
-        } | null;
-    } | null;
-    checkable: boolean;
-    /** A button shared as a public form (its link works). */
-    shared: boolean;
-    /** A schedule's standing order (v115): the terms each run files, in words — shown on demand. */
-    order?: string[];
-};
-/** A flow's canvas: zones, cards, and what this person may change. */
-export type BrowserFlowView = {
-    kind: "flow";
-    /** v100: signed in with the identity provider, a step-up is that sign-in (confirmed, or a link to confirm), not a password. */
-    stepUp?: {
-        label: string;
-        fresh: boolean;
-        confirmHref: string;
-    };
-    flow: {
-        id: number;
-        name: string;
-        project: string;
-        revision: number;
-        href: string;
-        owner: string;
-    };
-    /** Opens the lead's chat with a message about this flow started for the person to finish. */
-    chatHref: string;
-    triggers: BrowserFlowTrigger[];
-    /** What adding a trigger needs to know: this project's GitHub repository, whether a Linear key is saved, the public webhook address, other flows to follow. */
-    triggerSetup: {
-        kinds: {
-            kind: string;
-            label: string;
-        }[];
-        githubRepo: string | null;
-        linearKey: boolean;
-        hooksBase: string | null;
-        hooksPath: string;
-        /** v89: whether Email inbox triggers can read mail (Settings → Email), and whose mailbox it is. */
-        mailbox: string | null;
-        otherFlows: {
-            id: number;
-            name: string;
-            zones: {
-                id: string;
-                title: string;
-            }[];
-        }[];
-    };
-    /** A button trigger to open straight away (?start=). */
-    startTrigger: number | null;
-    /** Who is looking: their name, for "mine", owning and @mentions. */
-    me: string;
-    /** Whether sort zones can run: an OpenRouter key is saved in Settings → AI providers. */
-    sortReady: boolean;
-    /** v92: the project's subagents, to staff zones with. */
-    subagents?: {
-        handle: string;
-        label: string;
-        name: string;
-        working: boolean;
-        href: string;
-    }[];
-    /** v87: whether email is set up (Settings → Email), the names of this project's request secrets, and its tools with what each can do. */
-    emailReady: boolean;
-    requestSecrets: string[];
-    tools: {
-        name: string;
-        about: string;
-        functions: string[];
-        ready: boolean;
-    }[];
-    /** The project's scripts: reusable steps a "Run a script" zone runs with no AI. */
-    /** v90: each script's language, and the project file it runs instead of a body. */
-    scripts: {
-        name: string;
-        about: string;
-        body: string;
-        timeoutMinutes: number;
-        version: number;
-        /** The content digest the panel showed: an approval of a held script carries it back. */
-        digest: string;
-        savedBy: string;
-        savedAt: string;
-        usedHere: string[];
-        language: "shell" | "python" | "node";
-        file: string | null;
-        /** It came with an imported flow and waits for a person's approval before it runs. */
-        held: boolean;
-    }[];
-    start: string;
-    stages: BrowserFlowStage[];
-    cards: BrowserFlowCard[];
-    selectedCard: number | null;
-    /** Where the flow stands (v88): the live stream's nudge names it, and a page that already shows it doesn't read again. */
-    live: string | null;
-    canEdit: boolean;
-    /** "Runs on its own" (flow-unattended.ts): the live grant, and whether this person can sign one (why not, when not). */
-    unattended: {
-        active: {
-            until: string;
-            untilWords: string;
-            signedBy: string;
-            budgetMicrousd: number | null;
-            dailyRunCap: number | null;
-            runsToday: number;
-            words: string[];
-            covers: string[];
-        } | null;
-        canSign: boolean;
-        problem: string | null;
-        maxDays: number;
-        scheduled: boolean;
-        terms: {
-            head: string[];
-            rules: string[];
-        };
-        /** The schedules a signature could cover: plain ones always, `optional` ones (outside content, said why) only when picked. */
-        schedules: {
-            id: number;
-            words: string;
-            optional: string | null;
-        }[];
-        schedulesDigest: string;
-        /** The latest grant a change ended early (flow-unattended.ts unattendedViewOf): why and when. */
-        ended?: {
-            why: string;
-            at: string;
-        } | null;
-    };
-    /** Browser use (flow-browser.ts browserViewOf): null when no zone says it starts a browser. */
-    browser: {
-        status: "allowed" | "ended" | "none";
-        words: string;
-        signedBy: string | null;
-        signedAt: string | null;
-        zones: {
-            zone: string;
-            title: string;
-            script: string;
-            version: number;
-            digest: string;
-        }[];
-        terms: string[];
-        digest: string | null;
-        problem: string | null;
-        /** Whether this person may allow it here: an approver whose account reaches every project (as the route requires). */
-        canApprove: boolean;
-    } | null;
-    approvers: string[];
-    /** The projects a Build zone may work in: the flow's own first, then others the viewer can reach. */
-    projects?: {
-        path: string;
-        name: string;
-    }[];
-    kinds: {
-        kind: BrowserFlowStage["kind"];
-        label: string;
-        about: string;
-    }[];
-    colors: string[];
-};
-/** The Agents board's groups, in order (agents-board.ts). */
-export type AgentGroupKey = 'needs-you' | 'working' | 'stuck' | 'done' | 'idle';
-/** One agent: its task, project, last activity line, elapsed time and diff size. */
-export type BrowserAgentRow = {
-    runId: number;
-    taskId: string;
-    title: string;
-    project: string | null;
-    href: string;
-    /** Its one line: what it is doing, its question, or why it ended; null when there is nothing the state chip doesn't say. */
-    group: AgentGroupKey;
-    label: string;
-    line: string | null;
-    quiet: boolean;
-    /** When it started, and when it ended (null: still running): the row counts the time between. */
-    startedAt: string;
-    endedAt: string | null;
-    /** "3 files", "+12 −4 · 3 files"; null when nothing could be measured. */
-    diff: string | null;
-    agent: string;
-};
-export type BrowserAgentQuestion = {
-    id: number;
-    key: string;
-    text: string;
-    action: string;
-};
-export type BrowserAgentControls = {
-    send: "live" | "mailbox" | null;
-    words: string;
-    pause: {
-        action: string;
-        run: number;
-        state: "pausing" | "paused" | null;
-        requests: [string, string, string];
-        until: string | null;
-    } | null;
-    stop: {
-        action: string;
-        run: number;
-        label: string;
-    } | null;
-};
-export type BrowserAgentDetail = BrowserAgentRow & {
-    live: boolean;
-    question: BrowserAgentQuestion | null;
-    /** The live transcript's JSON window (/r/<run>?fragment=transcript); null when this console can't read it. */
-    transcript: string | null;
-    /** The live changes fragment (/r/<run>?fragment=peek) while it runs; the saved changes once it has finished. */
-    peek: string | null;
-    files: {
-        path: string;
-        added: number | null;
-        removed: number | null;
-    }[];
-    filesMore: number;
-    /** Steer the running agent (POST /t/<task>/steer): null once it has finished. */
-    steer: {
-        action: string;
-        run: number;
-    } | null;
-    /** What this running attempt takes (steer-capabilities.ts): how a note reaches it (or why none does), Pause and
-     * Stop for the exact run each names. Null when it is not running or this person may not act. */
-    controls?: BrowserAgentControls | null;
-    /** Cockpit E: this running attempt's checkout, proved to be on this machine — the cd command to copy, and where Show
-     * in Finder posts. Absent off this machine, for a viewer, or once it ends. Nothing is ever launched in it. */
-    /** `reveal` is null where Finder can't be asked (not a Mac): the path and the command stand alone. */
-    checkout?: {
-        path: string;
-        cd: string;
-        reveal: string | null;
-    } | null;
-    /** Whether this person may reply or steer (an approver, outside the demo); a viewer sees the question but no composer. */
-    canAct: boolean;
-    /** The task, and once finished the run's own page (its result page when it built one). */
-    taskHref: string;
-    resultHref: string | null;
-    /** The task this agent works on, as its page heads it: the status words, and its one action as a way to the task page's
-     * tab that holds it (never a form here: the task page's own form is the one that acts). Null when it can't be read. */
-    task?: {
-        headline: string;
-        sentence: string;
-        tone: string;
-        action: {
-            label: string;
-            href: string;
-        };
-    } | null;
-    /** Where this run opens on its task's page: a result → its Result tab at this run, a plan → the Plan tab, anything
-     * else (a review, an attempt that isn't a result) → its own record. Null while it runs. */
-    open?: {
-        label: string;
-        href: string;
-    } | null;
-    /** The exact-run live room: updates, and a watch that keeps this person's pings quiet. */
-    room: string;
-    said: {
-        tone: 'info' | 'error';
-        text: string;
-    } | null;
-};
-/** One run on the timeline: its role, and when it started and ended (null: still running). */
-export type BrowserLaneSegment = {
-    runId: number;
-    role: 'planner' | 'builder' | 'reviewer' | 'scout';
-    agent: string;
-    startedAt: string;
-    endedAt: string | null;
-    outcome: string | null;
-    href: string;
-};
-/** One task's row on the timeline: its runs in order, and the board's word for where it stands ('planning' before a build). */
-export type BrowserAgentLane = {
-    taskId: string;
-    title: string;
-    project: string | null;
-    href: string;
-    group: AgentGroupKey | 'planning';
-    segments: BrowserLaneSegment[];
-};
-/** The agent timeline (after the "Agent lanes" pattern): one row per task over a window ending now. */
-export type BrowserAgentLanes = {
-    since: string;
-    now: string;
-    windows: {
-        key: AgentLaneWindow;
-        label: string;
-        href: string;
-        active: boolean;
-    }[];
-    lanes: BrowserAgentLane[];
-    /** Tasks in the window past the rows shown. */
-    more: number;
-    /** Every task in the window with a live run, not just the rows shown. */
-    running: number;
-};
-export type AgentLaneWindow = '30m' | '2h' | '24h';
-export type BrowserAgentsView = {
-    kind: 'agents';
-    groups: {
-        key: AgentGroupKey;
-        label: string;
-        rows: BrowserAgentRow[];
-    }[];
-    /** The timeline above the board; empty lanes when nothing ran in the window but something did today; null when nothing ran in a day. */
-    lanes?: BrowserAgentLanes | null;
-    selected: BrowserAgentDetail | null;
-    /** Shown when nothing is on the board. */
-    empty: string | null;
-    /** The Live grid (?view=live): every running agent's live output, watching only. */
-    live?: boolean;
-    /** The Finished group's window (?window=), 24 hours unless the address says otherwise. */
-    window?: AgentLaneWindow;
-    /** The computers that build (what /fleet showed), for a person with access to the whole installation; null otherwise. */
-    computers?: BrowserComputers | null;
-    /** Which model runs each phase (what /system showed), for a person with access to the whole installation. */
-    phases?: BrowserAgentPhase[] | null;
-    /** The rest of what /system showed: workspaces, the background service, notifications and external work. */
-    system?: BrowserAgentsSystem | null;
-    /** This person may open terminals (an installation-wide operator in a browser). */
-    terminals?: boolean;
-    /** What a computer act said, in fixed words (a retired computer, by the name the store knows). */
-    computerSaid?: {
-        tone: 'info' | 'error';
-        text: string;
-    } | null;
-};
-/** One computer that builds (a registered runner): what it is doing and what waits for it. */
-export type BrowserComputer = {
-    name: string;
-    host: string;
-    state: 'building' | 'idle' | 'offline';
-    capacity: number;
-    /** Retired, listed only while tasks are still reserved for it. */
-    retired: boolean;
-    /** Its live builds this person may see; `hidden` counts the ones in projects they can't. */
-    building: {
-        taskId: string;
-        title: string;
-        href: string;
-        project: string | null;
-    }[];
-    hidden: number;
-    heardAt: string;
-    registeredAt: string;
-    /** The projects it takes work from, that this person may see. */
-    projects: string[];
-    /** The operator's note on its queue (display only). */
-    note: string | null;
-    /** Queued tasks reserved for it, that this person may see. */
-    reserved: {
-        id: string;
-        title: string;
-        href: string;
-        project: string | null;
-        taken: boolean;
-    }[];
-};
-export type BrowserComputers = {
-    list: BrowserComputer[];
-    /** Register, retire, move reserved work and notes: an approver in a browser session. */
-    manage: boolean;
-    /** The queue's revision, for a move (POST /queue/move). */
-    queueRevision: number;
-    /** Queued tasks no computer is reserved for. */
-    shared: number;
-};
-export type BrowserAgentPhase = {
-    phase: 'plan' | 'build' | 'repair' | 'review';
-    /** The provider and model in words; null when it can't be worked out (`problem` says why). */
-    model: string | null;
-    problem: string | null;
-    /** Where the choice comes from, in words ("Set for the whole installation by alex"). */
-    source: string;
-    /** This provider reports tokens, not dollars. */
-    noDollars: boolean;
-};
-export type BrowserAgentsSystem = {
-    workspaces: {
-        name: string;
-        branch: string;
-        state: 'building' | 'free' | 'needs review';
-    }[];
-    /** The background service's latest run on the open project: running since `at`, or ended at `at`. */
-    service: {
-        running: boolean;
-        at: string;
-        built: number;
-        broke: number;
-    } | null;
-    outbox: number;
-    external: {
-        repo: string;
-        state: string;
-    }[];
-};
-export type BrowserView = BrowserTasksView | BrowserTaskView | BrowserProjectsView | BrowserResultView | BrowserFlowView | BrowserAgentsView | BrowserHomeView | BrowserSearchView;
-export type BrowserWorkspace = {
-    /** The one Needs-you count (tasks only) with its scope: the Tasks list's own count for the project in view (`scope`,
-     * a project path) or every project (null), its words ("5 need you in payments-api") and the list it opens. */
-    needsYou?: {
-        count: number;
-        saturated: boolean;
-        scope: string | null;
-        label: string;
-        href: string;
-    };
-    /** The same Needs-you count for each project (`path` null: work with no project), from the same work index totals. */
-    needsYouByProject?: {
-        path: string | null;
-        count: number;
-    }[];
-    version: 1;
-    path: string;
-    title: string;
-    user: string;
-    csrf: string;
-    sensitive: boolean;
-    /** True when this page may replace another without a document load (docs/plans/live-pages-and-home.md A1.1): the server
-     * sets it on every workspace it sends; absent (an older server, a fixture) is false. */
-    inPlace?: boolean;
-    /** What the app runs for this page in place of a page script (docs/plans/task-page-in-app.md): data, a closed list.
-     * Present only when the app covers the page's whole script; the document then ships no page script string. */
-    work?: readonly PageWork[];
-    /** This document ships a page script string (set on a document load only). Its listeners live as long as the
-     * document, so the app never changes pages in place from it, and never runs `work` in it. */
-    scripted?: boolean;
-    /** Passwordless is on for this signed-in browser: ceremony password fields are left out (docs/plans/passwordless.md). */
-    passwordless?: boolean;
-    /** The session's open project (its path), or null: the sidebar's project picker names it. */
-    openProject?: string | null;
-    /** The settings frame's breadcrumb ("Settings / <page>"; settings-kit.ts): the header shows it as links. */
-    crumbs?: {
-        label: string;
-        href: string | null;
-    }[];
-    /** What this person named their lead (Settings → Lead): the chat header and every lead message say it. */
-    leadName?: string;
-    refreshUrl: string;
-    receipt: {
-        request: string;
-        received: boolean;
-    } | null;
-    projects: BrowserProject[];
-    crew: BrowserCrewItem[];
-    crewTruncated: boolean;
-    /** The sidebar's project states; absent on a sensitive page. The summary room keeps them current. */
-    projectStates?: BrowserProjectState[];
-    /** Cockpit B2: this session's remembered password — minutes left, and where Forget posts. Absent unless it is
-     * live on a direct local request; never on a sensitive page. */
-    fresh?: {
-        minutes: number;
-        forget: string;
-    };
-    /** The most-used subscription window, for an operator; absent for everyone else and on a sensitive page. */
-    usage?: BrowserUsageChip;
-    conversation: BrowserConversation | null;
-    team?: TeamSnapshot;
-    focus: {
-        id: string;
-        title: string;
-        html: string;
-    } | null;
-    result: {
-        runId: number;
-        html: string;
-    } | null;
-    catchUpHtml: string;
-    controlsHtml: string;
-    notices: string[];
-    pageHtml: string | null;
-    navigation: BrowserNavigationItem[];
-    /** This person's recent project and task conversations (v77), newest first. */
-    chats?: BrowserChatLink[];
-    view?: BrowserView | null;
-    /** A live page (Inbox, System…) reads itself again this often; forms being edited are kept. */
-    refreshSeconds?: number;
-    /** Providers whose sign-in stopped working: their work waits (one per provider). */
-    signIn?: BrowserSignIn[];
-    /** A demo database: the notice that says so, scrolling with the page (`short`: its one line on a phone). */
-    demo?: {
-        text: string;
-        short: string;
-    };
-    /** A newer Toolroll exists: a quiet notice for an operator, until they dismiss this version. */
-    update?: BrowserUpdateNotice;
-    /** Chat's first run, until the first Ready result: the three steps and first tasks to try. */
-    firstRun?: BrowserFirstRun;
-    /** Chat, after the first Ready result until put away: use it from the phone. */
-    phone?: BrowserPhoneCard;
-    /** The Chat landing's live view: who is working now, four counts, and Catch up in tabs. */
-    home?: BrowserHome | null;
-    /** Easy-start C2: this tab's mutation key is from an earlier Toolroll start (or it has none): it reads, but needs to
-     * reconnect before it can change anything (the password again, or `toolroll open` for a local owner). */
-    reconnect?: {
-        kind: 'password';
-        href: string;
-    } | {
-        kind: 'command';
-        command: string;
-    };
-};
-/** Home ("/", docs/plans/live-pages-and-home.md B1): the heading said once, one quiet line for what runs and waits, what
- * needs this person grouped by what is asked (each group with its exact count), the selected one open beside the list,
- * and the lead's last message above the message box. With nothing waiting: what runs and what finished today. */
-export type BrowserHomeView = {
-    kind: 'home';
-    /** "19 tasks need you", "Nothing needs you", read from the same total as the rail's count. */
-    say: string;
-    /** The project in view (a path) or every project (null), and the project filter's choices (null with one project). */
-    project: string | null;
-    scopes: {
-        key: string;
-        label: string;
-        href: string;
-        active: boolean;
-    }[] | null;
-    /** The work index totals, each with the Tasks list it opens. */
-    counts: {
-        key: 'needs' | 'running' | 'queued' | 'finished';
-        label: string;
-        value: number;
-        href: string;
-    }[];
-    /** What needs you, by what is asked, in this order: release, approve, answer, flow, wrong, review, setup, other
-     * (anything none of the others fits; docs/plans/home-other-asks.md). `count` is the exact total for that ask, past the
-     * rows listed. */
-    groups: {
-        key: BrowserHomeAsk;
-        label: string;
-        count: number;
-        rows: BrowserHomeRow[];
-    }[];
-    /** What runs, then what waits its turn. */
-    working: BrowserHomeRow[];
-    /** What was completed today: the exact figure, the newest rows, and the list that has them all. */
-    finishedToday: {
-        count: number;
-        rows: BrowserHomeRow[];
-        href: string;
-    };
-    newTask: string;
-    /** The lead's message box, where chat is allowed for this person: a POST to /chat in this scope. */
-    ask: {
-        project: string | null;
-        placeholder: string;
-    } | null;
-    /** The lead's last message in this person's main thread, as one plain line that opens the chat; null when there is
-     * none or this person may not read that thread. */
-    lastLead: {
-        text: string;
-        age: string;
-        href: string;
-    } | null;
-    empty: {
-        title: string;
-        text: string;
-    } | null;
-    /** While the first run is open (no first result yet): the welcome's address, linked as Finish setup. */
-    setup?: string | null;
-};
-/** What a waiting row asks (work-index.ts WorkAskGroup), plus a flow card waiting on you and a first-run step. */
-export type BrowserHomeAsk = 'release' | 'approve' | 'answer' | 'flow' | 'wrong' | 'review' | 'setup' | 'other';
-export type BrowserHomeRow = {
-    /** A task row's family id; a row that isn't a task is namespaced (`release:<task>`, `flow:<card>`, `setup:<step>`). */
-    id: string;
-    title: string;
-    href: string;
-    project: string | null;
-    age: string;
-    /** Which list it is in: it needs you, it runs, it waits its turn, or it finished. */
-    state: 'needs' | 'running' | 'queued' | 'done';
-    /** What it asks of you (its group), or null when it doesn't wait on you. */
-    ask: BrowserHomeAsk | null;
-    /** Why, in one short line: only a row where something went wrong. */
-    reason: string | null;
-    /** One line: what it asks, or what the agent is doing now. */
-    line: string | null;
-    /** The one act that resolves it (a link), or null. A release, a flow card or a setup step is never acted on at
-     * Home: its one link opens its own page. */
-    action: {
-        label: string;
-        href: string;
-    } | null;
-    /** An agent's question, answered in place (POST /d/<id>/answer, one click); null when it must be answered on its page. */
-    question: {
-        id: number;
-        text: string;
-        recap: string;
-        options: {
-            id: string;
-            label: string;
-            consequence: string;
-            recommended: boolean;
-        }[];
-    } | null;
-};
-/** Search ("/search"): the places and the tasks in view that match the words; the ⌘K menu's "See all results". */
-export type BrowserSearchView = {
-    kind: 'search';
-    q: string;
-    tasks: {
-        id: string;
-        title: string;
-        href: string;
-        project: string | null;
-        age: string;
-        chip: {
-            word: string;
-            tone: '' | 'needs' | 'ask' | 'live' | 'done' | 'failed';
-        };
-        archived: boolean;
-    }[];
-    /** More tasks exist than were read: the Tasks list has them all. */
-    truncated: boolean;
-};
-/** One agent at work now: its task and the machine's own phase, in words. */
-export type BrowserHomeAgent = {
-    runId: number;
-    taskId: string;
-    title: string;
-    href: string;
-    agent: string;
-    phase: string;
-    project: string | null;
-    since: string;
-    /** What the agent did last, and when. */
-    activity?: RunActivity;
-};
-export type BrowserHomeCount = {
-    key: 'working' | 'waiting' | 'ready' | 'done';
-    label: string;
-    value: number;
-    href: string;
-};
-export type BrowserCatchUpTab = 'needs-you' | 'ready' | 'running' | 'all';
-export type BrowserCatchUpItem = {
-    id: string;
-    title: string;
-    href: string;
-    project: string | null;
-    tab: Exclude<BrowserCatchUpTab, 'all'> | 'finished';
-    label: string;
-    tone: StatusTone;
-    detail: string;
-    at: string;
-    /** Needs you: the one action that resolves it. */
-    action?: {
-        label: string;
-        href: string;
-    } | null;
-};
-/** Plan-window use stands in for spend: subscriptions don't bill per run. */
-export type BrowserHome = {
-    agents: BrowserHomeAgent[];
-    counts: BrowserHomeCount[];
-    planUse: {
-        name: string;
-        window: string;
-        percent: number;
-        detail: string;
-        tone: 'neutral' | 'warning' | 'danger';
-    }[];
-    catchUp: BrowserCatchUpItem[];
-    allHref: string;
-    /** What this person's lead is doing now and when it last acted (lead-voice.ts); its task when it named one. */
-    lead?: {
-        name?: string;
-        doing: string;
-        at: string;
-        href: string | null;
-    } | null;
-};
-/** `sandbox`: the demo command, offered beside the sign-in command while no agent is signed in. `intro`: how it works,
- * once, above the composer with the suggestions. `lead`: the one line saying what runs the lead, and where to change it.
- * `recheck`: while no agent is signed in, where the page asks again on its own. */
-export type BrowserFirstRun = {
-    steps: FirstRunStep[];
-    suggestions: FirstTaskSuggestion[];
-    sandbox: string | null;
-    intro?: string;
-    lead?: {
-        words: string;
-        href: string;
-    } | null;
-    recheck?: string | null;
-};
-/** After the first Ready result: the phone, through a chat app or the console over Tailscale. `tailnet.restart`: the
- * command that makes the console listen beyond this computer, when it doesn't yet. */
-export type BrowserPhoneCard = {
-    chatApps: {
-        label: string;
-        href: string;
-    }[];
-    tailnet: {
-        address: string;
-        restart: string | null;
-    } | null;
-    dismissHref: string;
-};
-/** The console's update notice: neutral, never the accent — an update does not need a person. */
-export type BrowserUpdateNotice = {
-    version: string;
-    security: boolean;
-    href: string;
-    dismissHref: string;
-};
-/** A provider's sign-in pause, as the console shows it: the plain reason,
- * what to run, and the one action that resumes its work. */
-export type BrowserSignIn = {
-    provider: string;
-    title: string;
-    command: string;
-    detail: string;
-    resumeLabel: string;
-    resumeHref: string;
-};
-/** Safe inside a script[type=application/json] element. JSON escaping alone
- * does not stop the HTML parser from closing that element at </script>. */
-export declare const BROWSER_CREW_LIMIT = 40;
-export type BrowserCrewOptions = {
-    evidenceRoot?: string;
-    limit?: number;
-    project?: string | null;
-};
-/** A bounded recent family list. The caller supplies its already admitted
- * access; an optional project can only narrow it. Admission and family grouping
- * happen before the SQL limit and before reading questions or saved evidence. */
-export declare function browserCrewOf(store: Store, now: Date, access: WorkSummaryAccess, options?: BrowserCrewOptions): {
-    crew: BrowserCrewItem[];
-    crewTruncated: boolean;
-};
-/** Navigation input must already be admitted by the caller. No extra project
- * discovery belongs in a browser projection. Keep exact paths in every link. */
-export declare function browserProjectsOf(projects: readonly {
-    name: string;
-    path: string;
-}[]): BrowserProject[];
-export declare function browserNavigationOf(path: string, project?: string | null, needsYou?: number, tasksProject?: string | null, needsYouLabel?: string): BrowserNavigationItem[];
-/** One "Can I merge?" act, as the task page's form for it (server/merge-ready-view.ts builds it). */
-export type MergeReadyAct = {
-    kind: "run-checks";
-    action: string;
-    level: "quick" | "full";
-    returnTo: string;
-} | {
-    kind: "retry";
-} | {
-    kind: "fix";
-    action: string;
-    note: string;
-    batch: string;
-    source: string;
-    request: string;
-    returnTo: string;
-};
-/** The task page's "Can I merge?" panel. */
-export type MergeReadyView = {
-    answer: "yes" | "no" | "not-yet" | "merged";
-    sentence: string;
-    rows: {
-        key: string;
-        label: string;
-        mark: "yes" | "no" | "waiting" | "unknown" | "skip";
-        say: string;
-        act: MergeReadyAct | null;
-    }[];
-};
-export type { PageWork } from './page-work-contract.js';