toolroll 0.9.85 → 0.9.87

package/dist/browser-crew.js

@@ -12,7 +12,7 @@ export function browserWorkActionHref(item) {
     if (action.code === 'inspect-decisions')
         return '/';
     if (action.code === 'sign-in')
-        return '/settings#providers';
+        return '/settings/agents#providers';
     if (action.code === 'answer-agent' && runId !== null)
         return `/agents?run=${runId}`;
     if (action.code === 'confirm-stopped')

package/dist/browser-workspace.d.ts

@@ -4,7 +4,6 @@
 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 { BrandIconId } from './brand-icons.js';
 import type { AssignmentSnapshot } from './assignment.js';
 export { browserCrewFromIndex, browserWorkActionHref } from './browser-crew.js';
 import type { Store } from './store.js';
@@ -166,11 +165,29 @@ export type BrowserLink = {
 };
 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;
     })[];
-    /** Tasks waiting on a person in this view's scope ("3 need you" beside the title). */
+    /** 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: {
@@ -178,27 +195,21 @@ export type BrowserTasksView = {
         label: string;
         count: number;
     }[] | null;
-    rows: {
-        id: string;
-        title: string;
+    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;
-        project: string | null;
-        age: string;
-        status: {
-            label: string;
-            tone: StatusTone;
-            token: string;
-        };
-        /** 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;
-        action: BrowserLink | null;
-        detail: string | null;
-        problem: string | null;
-        notes: 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;
@@ -209,6 +220,8 @@ export type BrowserTasksView = {
     };
     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. */
@@ -216,6 +229,40 @@ export type BrowserTasksView = {
         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: 'Put away' | '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 = {
@@ -242,135 +289,6 @@ export type BrowserUsageChip = {
     href: string;
     title: string;
 };
-export type BrowserSettingsView = {
-    kind: 'settings';
-    said: string | null;
-    /** Using it from a phone, under Chat apps (approvers only). */
-    phone?: BrowserPhoneCard;
-    /** The settings destinations under short headings; a chat app's tile says whether it is connected and gets alerts. */
-    groups: BrowserSettingsGroup[];
-    theme: 'system' | 'light' | 'dark';
-    /** The signal colour chosen for this browser (Settings → Appearance), "#rrggbb"; chart magenta by default. */
-    accent: string;
-    accentPresets: {
-        id: string;
-        name: string;
-        year: number | null;
-        hex: string;
-    }[];
-    permission: {
-        mode: string;
-        canManage: boolean;
-        changed: string | null;
-    } | null;
-    quality: {
-        mode: string;
-        canManage: boolean;
-        changed: string | null;
-    } | null;
-    providers: {
-        provider: string;
-        name: string;
-        tone: 'ok' | 'warn' | 'off' | 'neutral';
-        words: string;
-        connection: {
-            words: string;
-            facts: string;
-            checkAction: string;
-        } | null;
-        usage: string;
-        envName: string;
-        subscriptionCapable: boolean;
-        mode: 'subscription' | 'api-key';
-        set: boolean;
-    }[] | null;
-    legacyWebhookWarning?: string;
-    services: {
-        configured: string[];
-        channel: string | null;
-        implicit: boolean;
-    } | null;
-    push: {
-        available: boolean;
-        devices: {
-            id: number;
-            words: string;
-            state: string;
-            removable: boolean;
-        }[];
-    } | null;
-    /** Quiet chat: how chats reach this person, and their evening digest time (null: off). */
-    chat?: {
-        mode: 'quiet' | 'all';
-        digestAt: string | null;
-        /** Whether a result's saved screenshots follow its chat message: off, the first one, or up to 4. */
-        screenshots?: 'off' | 'first' | 'all';
-        /** Each project this person can see; a muted one sends no pings but stays in Tasks and the digest. */
-        projects?: {
-            repo: string;
-            name: string;
-            muted: boolean;
-        }[];
-    } | null;
-    digest: {
-        every: string;
-        held: string | null;
-    } | null;
-    telegram: {
-        state: string;
-        current: string;
-        /** v98: how the bot's messages reach Toolroll (pushed, or asked for), in words. */
-        delivery?: string | null;
-    };
-    /** Each worker: how many tasks it runs at once, and what it is running now. */
-    workers?: {
-        name: string;
-        tone: 'ok' | 'warn' | 'off';
-        state: string;
-        capacity: number;
-        busy: number;
-        running: {
-            taskId: string;
-            title: string;
-            href: string;
-            project: string | null;
-        }[];
-    }[] | null;
-    /** v87: the mail server Send email steps use (approvers only); the password is never shown back. */
-    email?: {
-        set: boolean;
-        host: string;
-        port: number;
-        secure: boolean;
-        user: string;
-        from: string;
-        /** v89: where Email inbox triggers read (IMAP), and a Google account connected instead of a mail server (`redirect`: the address to register with Google, when this page's address can take one). */
-        imapHost: string;
-        imapPort: number;
-        google: {
-            connected: string | null;
-            clientId: string;
-            redirect: string | null;
-        };
-    } | null;
-    /** The installation's first Ready result, in words ("first result in 7 min"); null before it arrives. */
-    firstResult?: string | null;
-    /** Settings → Updates: this version, the latest known one and its notes, how to update, the daily-check switch, and each worker's version. */
-    updates?: BrowserUpdates | null;
-};
-/** A tile's `brand` is a chat app's logo (brand-mark.ts), drawn in place of its icon. */
-export type BrowserSettingsGroup = {
-    title: string;
-    tiles: {
-        href: string;
-        label: string;
-        brand?: BrandIconId;
-        status?: {
-            tone: 'ok' | 'warn' | 'off';
-            words: string;
-        };
-    }[];
-};
 export type BrowserUpdates = {
     current: string;
     /** The latest release the last check found; null before any check has worked. */
@@ -449,6 +367,15 @@ export type BrowserTaskView = {
         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;
@@ -573,10 +500,61 @@ export type BrowserTaskView = {
     } | 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;
+    } | 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;
+    /** 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;
+    } | 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[];
 };
-export type BrowserTaskTab = "activity" | "result" | "plan";
+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 = {
@@ -601,44 +579,34 @@ 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;
-    knowledgeHref: string;
-    /** Settings → Projects → Pull requests for this project, and whether they are on. */
-    pullRequests?: {
-        href: string;
-        on: boolean;
-    };
-    /** Settings → Projects → Checks for this project, and its level in words. */
-    checks?: {
-        href: string;
-        level: string;
-    };
-    /** What waits, runs, queues or finished today; null when not scanned. */
-    peek: {
-        label: string;
-        href: string;
-        tone: 'attention' | 'info' | 'neutral' | 'success';
-    }[] | 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';
-    activity?: {
-        project: string;
-        report: import('./project-outcomes.js').ProjectOutcomes | null;
-    };
     /** 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 roads; `html` carries the server's GitHub-link and exact-path forms. */
+    /** 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: {
-        browse: string | null;
-        github: string | null;
         html: string;
+        review: string | null;
+        openOnLoad: boolean;
     };
 };
 export type BrowserResultTab = 'summary' | 'changes' | 'checks';
@@ -977,6 +945,8 @@ export type BrowserFlowStage = {
     }[] | 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;
 };
@@ -1000,6 +970,8 @@ export type BrowserFlowCard = {
     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;
@@ -1251,6 +1223,8 @@ export type BrowserFlowView = {
         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[];
@@ -1293,7 +1267,31 @@ export type BrowserFlowView = {
             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?: {
@@ -1458,9 +1456,107 @@ export type BrowserAgentsView = {
     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;
 };
-export type BrowserView = BrowserTasksView | BrowserSettingsView | BrowserTaskView | BrowserProjectsView | BrowserResultView | BrowserFlowView | BrowserAgentsView;
+/** 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;
@@ -1533,6 +1629,96 @@ export type BrowserWorkspace = {
     /** The Chat landing's live view: who is working now, four counts, and Catch up in tabs. */
     home?: BrowserHome | null;
 };
+/** Home ("/"): one sentence that answers "what needs me?", four counts that agree with the Tasks filters they open,
+ * what waits on this person grouped by what it asks, what is running, and the selected item answered in place. */
+export type BrowserHomeView = {
+    kind: 'home';
+    /** "7 need you across 2 projects.", derived from the same counts as the figures. */
+    say: string;
+    /** The project in view (a path) or every project (null), and the scope links (null with one project). */
+    project: string | null;
+    scopes: {
+        key: string;
+        label: string;
+        href: string;
+        active: boolean;
+    }[] | null;
+    counts: {
+        key: 'needs' | 'running' | 'queued' | 'finished';
+        label: string;
+        value: number;
+        href: string;
+    }[];
+    groups: {
+        key: 'decide' | 'review' | 'unblock' | 'running';
+        label: string;
+        rows: BrowserHomeRow[];
+    }[];
+    /** More waits than the list shows: open them all in Tasks. */
+    more: {
+        count: number;
+        href: string;
+    } | null;
+    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;
+    empty: {
+        title: string;
+        text: string;
+    } | null;
+};
+export type BrowserHomeRow = {
+    id: string;
+    title: string;
+    href: string;
+    project: string | null;
+    age: string;
+    chip: {
+        word: string;
+        tone: '' | 'needs' | 'ask' | 'live' | 'done' | 'failed';
+    };
+    /** 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. */
+    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;