toolroll 0.9.103 → 0.9.105

package/dist/scout-browser-lock.d.ts

@@ -1,69 +0,0 @@
-/**
- * The scout browser helper's pinned install (scout-browser.ts ensureScoutBrowserHelper): its manifest and lockfile,
- * generated once with `npm install --package-lock-only --registry https://registry.npmjs.org/` for @playwright/mcp
- * 0.0.82. `npm ci` installs exactly this tree and refuses any tarball whose sha512 differs. Changing a version here is
- * a supply-chain change: regenerate both and review the diff.
- */
-export declare const SCOUT_BROWSER_MANIFEST: {
-    readonly name: "toolroll-scout-browser";
-    readonly private: true;
-    readonly dependencies: {
-        readonly "@playwright/mcp": "0.0.82";
-    };
-};
-export declare const SCOUT_BROWSER_LOCK: {
-    readonly name: "toolroll-scout-browser";
-    readonly lockfileVersion: 3;
-    readonly requires: true;
-    readonly packages: {
-        readonly "": {
-            readonly name: "toolroll-scout-browser";
-            readonly dependencies: {
-                readonly "@playwright/mcp": "0.0.82";
-            };
-        };
-        readonly "node_modules/@playwright/mcp": {
-            readonly version: "0.0.82";
-            readonly resolved: "https://registry.npmjs.org/@playwright/mcp/-/mcp-0.0.82.tgz";
-            readonly integrity: "sha512-OCqftfb8H4dnqm/njbTBRk3seUvUPttOlJUxCtEzXGETYOlRH5Qt3bbXIjmZIuWAxD9RF+yg1ASrPeXvm0y5cA==";
-            readonly license: "Apache-2.0";
-            readonly dependencies: {
-                readonly playwright: "1.64.0-alpha-1789764292000";
-                readonly "playwright-core": "1.64.0-alpha-1789764292000";
-            };
-            readonly bin: {
-                readonly "playwright-mcp": "cli.js";
-            };
-            readonly engines: {
-                readonly node: ">=18";
-            };
-        };
-        readonly "node_modules/playwright": {
-            readonly version: "1.64.0-alpha-1789764292000";
-            readonly resolved: "https://registry.npmjs.org/playwright/-/playwright-1.64.0-alpha-1789764292000.tgz";
-            readonly integrity: "sha512-3Ngs4ERGdC912uW3srEDtNVey4u1wSaQ/EFcKhxMpz0by0K6nidaJgM087pLpJc1osytiVnL7ack5gvgPArPNw==";
-            readonly license: "Apache-2.0";
-            readonly dependencies: {
-                readonly "playwright-core": "1.64.0-alpha-1789764292000";
-            };
-            readonly bin: {
-                readonly playwright: "cli.js";
-            };
-            readonly engines: {
-                readonly node: ">=20";
-            };
-        };
-        readonly "node_modules/playwright-core": {
-            readonly version: "1.64.0-alpha-1789764292000";
-            readonly resolved: "https://registry.npmjs.org/playwright-core/-/playwright-core-1.64.0-alpha-1789764292000.tgz";
-            readonly integrity: "sha512-ZgRaybFv4rRy7QMGnYprEGFdNJnvapNqcaER2w96bDQA+40BWIle1el1Yh9KHD3E6XYmieMB+r+UxFTCauTGGQ==";
-            readonly license: "Apache-2.0";
-            readonly bin: {
-                readonly "playwright-core": "cli.js";
-            };
-            readonly engines: {
-                readonly node: ">=20";
-            };
-        };
-    };
-};

package/dist/scout-browser.d.ts

@@ -1,107 +0,0 @@
-export type BrowserLaunch = {
-    command: string;
-    args: readonly string[];
-};
-export type ScoutBrowserServer = {
-    url: string;
-    close: () => Promise<void>;
-};
-export type BrowserStart = {
-    ok: true;
-    server: ScoutBrowserServer;
-} | {
-    ok: false;
-    reason: string;
-};
-export type BrowserStarter = (launch: BrowserLaunch, options: BrowserOptions) => Promise<BrowserStart>;
-export type BrowserOptions = {
-    /** The browser tool's environment: the scout's own, its proxy settings included. */
-    env: Record<string, string | undefined>;
-    /** Toolroll's helpers folder (in its state folder) the pinned browser is installed in, and the scout's proxy: the
-     * launch contract's trusted inputs, from the plane, never from the launch. */
-    contract?: {
-        helpers: string;
-        proxy: string;
-    };
-    /** Where it saves screenshots (its `--output-dir`), also its working folder. */
-    folder: string;
-    /** The whole start and check, from spawn to screenshot (review 828: at most 60 seconds). */
-    timeoutMs?: number;
-};
-/** The public page the check opens through the scout's proxy. */
-export declare const PREFLIGHT_PAGE = "https://example.com/";
-/** How a scout gets its browser: started for real under its launch contract, or, for a test's stub agent, a placeholder
- * that starts nothing. */
-export declare function starterFor(agentInjected: boolean): BrowserStarter;
-/** Start the browser tool outside the fence and check it opens a public page and saves a screenshot. */
-export declare function startScoutBrowser(launch: BrowserLaunch, options: BrowserOptions): Promise<BrowserStart>;
-export type McpSession = {
-    start: () => Promise<{
-        ok: true;
-    } | {
-        ok: false;
-        reason: string;
-    }>;
-    call: (tool: string, input: Record<string, unknown>) => Promise<{
-        ok: true;
-        result: Record<string, unknown>;
-    } | {
-        ok: false;
-        reason: string;
-    }>;
-    close: () => Promise<void>;
-};
-/** A client of the browser's HTTP transport, as the scout's own is: every step answers by `deadline`, or says why not. */
-export declare function openSession(url: string, deadline: number, late: string): McpSession;
-/** The pinned browser tool, installed once into Toolroll's helpers folder. */
-export declare const SCOUT_BROWSER_PACKAGE = "@playwright/mcp@0.0.82";
-/** The names of the worker's environment the browser tool gets: an allowlist, never a denylist. */
-export declare const SCOUT_BROWSER_ENV: readonly string[];
-/** What the run records of the exception it ran under. */
-export declare const SCOUT_BROWSER_CONTAINMENT = "Chrome's sandbox";
-/** Where the pinned browser lives under `helpers`. */
-export declare function scoutBrowserHelper(helpers: string): {
-    folder: string;
-    cli: string;
-    browsers: string;
-};
-/** The scout's browser tool: the pinned helper, run by Toolroll's own Node, headless, on its bundled Chrome. */
-export declare function scoutBrowserTool(helpers: string): BrowserLaunch;
-/**
- * Why a browser launch breaks its contract, or null when it holds. Every input it trusts is the plane's: the helpers
- * folder and the proxy come from `options.contract`, never from the launch. The executable must be Toolroll's own
- * Node; the script the pinned helper's, inside a private helpers folder; the arguments exactly the expected ones (no
- * way to switch Chrome's sandbox off, point at another browser or executable, or drop the proxy); the working folder
- * the image folder; the environment only allowlisted names.
- */
-export declare function browserContractProblem(launch: BrowserLaunch, options: BrowserOptions): string | null;
-/** The pinned lockfile's digest, recorded when the helper is installed and checked before every use. */
-export declare const SCOUT_BROWSER_LOCK_DIGEST: string;
-/** The npm of the Node running Toolroll (`lib/node_modules/npm/bin/npm-cli.js` beside it), run by that Node by path:
- * never an `npm` found on PATH. Null where this Node has none beside it (a bundled runtime). */
-export declare function ownNpm(execPath?: string): string | null;
-/**
- * Install the pinned browser into the helpers folder once. The worker runs this outside every fence, so nothing a build
- * could have written may steer it: npm is Toolroll's own Node's, run by path; HOME is the staging folder and the user
- * and global npm configurations are an empty file there (no ~/.npmrc, no global npmrc, no registry, script or Node
- * option from either); the registry is pinned; install scripts never run; `npm ci` installs exactly the pinned lockfile
- * (scout-browser-lock.ts) and refuses a tarball whose integrity differs; the installed versions are checked against it
- * before ready.json is written. The npm cache and Chrome for Testing stay in the folder, never in the user's caches.
- * Residual: Chrome for Testing comes from Playwright's own download over HTTPS, without a pinned hash.
- */
-export declare function ensureScoutBrowserHelper(helpers: string, timeoutMs?: number): Promise<{
-    ok: true;
-} | {
-    ok: false;
-    reason: string;
-}>;
-/** How the helper's npm runs in `staging`: Toolroll's own npm by path, with its home, user and global configuration
- * the staging folder's own empty ones, the registry and cache pinned; the environment only these names. */
-export declare function helperNpm(staging: string, npm: string): {
-    env: Record<string, string>;
-    args: string[];
-};
-/** What of an installed tree differs from the pinned lockfile (a package missing or at another version), or null. */
-export declare function lockDrift(folder: string): string | null;
-/** The production starter: the pinned helper in place, then the launch held to its contract, then started. */
-export declare function startContractedBrowser(launch: BrowserLaunch, options: BrowserOptions): Promise<BrowserStart>;

package/dist/scout-net.d.ts

@@ -1,25 +0,0 @@
-import { type Socket } from "node:net";
-/**
- * Whether an IP literal is a public internet address. IPv4 inside IPv6 (mapped, translated, compatible or NAT64) is
- * judged as IPv4, read from the address's groups so every way of writing it is caught (an expanded NAT64 form too).
- */
-export declare function isPublicAddress(address: string): boolean;
-export type Lookup = (host: string) => Promise<readonly string[]>;
-/**
- * A connection to the first of the checked addresses that answers, tried in turn (review 827): a host whose IPv6
- * address is unreachable from here is still reached over IPv4. Null when none answers.
- */
-export declare function connectFirst(addresses: readonly string[], port: number, timeoutMs?: number): Promise<Socket | null>;
-export type ScoutProxy = {
-    url: string;
-    close: () => Promise<void>;
-};
-/**
- * Start the scout browser's proxy on loopback. `refused` hears every request it turned away (for the live log and
- * tests). `lookup` resolves a host name to its addresses (the system resolver unless a test supplies one).
- */
-export declare function startScoutProxy(options?: {
-    demoUrl?: string | null;
-    lookup?: Lookup;
-    refused?: (target: string, why: string) => void;
-}): Promise<ScoutProxy>;

package/dist/scout-report.d.ts

@@ -1,23 +0,0 @@
-/**
- * The scout's terminal handoff (mate arc §10), read against the report contract (src/contracts/scout-report.ts) with
- * the 422 rule: fail closed, every problem reported at once, each naming its path (`items[0].url: must be an http or
- * https address`), stable reasons, caps and control-character rejection on every string. A report reaches the task
- * page, the ledger, the terminal, and — through leadView — the lead; and each follow-up becomes a filing's title and
- * goal at one tap, so it gets the park discipline exactly as the plan does.
- */
-import { type ContractProblem } from "./contracts/contract.js";
-import { type ParsedReport } from "./contracts/scout-report.js";
-export { REPORT_IMAGE_FILE, REPORT_LIMITS, REPORT_VERSION, SCOUT_OUTPUT_JSON_SCHEMA, type ParsedReport, type ReportImage, type ReportItem, } from "./contracts/scout-report.js";
-export type ReportProblem = ContractProblem;
-export type ReportParseResult = {
-    ok: true;
-    report: ParsedReport;
-} | {
-    ok: false;
-    problems: ReportProblem[];
-};
-/** A report, checked. `stored`: one already kept as evidence, read without the length caps (a report written under
- * higher limits stays readable); every other check still holds. */
-export declare function parseReport(raw: string, options?: {
-    stored?: boolean;
-}): ReportParseResult;

package/dist/scout.d.ts

@@ -1,142 +0,0 @@
-import type { ProviderId } from "./contracts/provider.js";
-import type { Store } from "./store.js";
-import { type ParsedDecision, type Problem } from "./decision.js";
-import { type ParsedReport, type ReportProblem } from "./scout-report.js";
-import { type Runner } from "./builder.js";
-import * as browserCheck from "./scout-browser.js";
-/** The scout's own headless browser: the pinned Playwright tool, saving its
- * screenshots straight into the run's image folder. */
-export declare const SCOUT_BROWSER = "toolroll-browser";
-/**
- * What a Claude scout may use without asking (`dontAsk` denies the rest):
- * reading the checkout (always allowed), web search and fetch for research,
- * and its browser for screenshots. Nothing that edits a file or runs a
- * command, so the read-only posture holds by permission as well as by the
- * clean-tree proof.
- */
-export declare const SCOUT_ALLOWED_TOOLS: readonly string[];
-export declare function scoutBrowserLaunch(tool: {
-    command: string | null;
-    args: readonly string[];
-} | null, imageFolder: string, proxy: string): browserCheck.BrowserLaunch | null;
-/** What the fenced scout gets: the running browser's loopback address, nothing it could launch itself. */
-export declare function scoutBrowser(url: string): Record<string, unknown>;
-/** The scout's environment while its proxy runs (review 827): web fetch and the provider's own traffic go through
- * the same public-web-only proxy as its browser, so only public addresses (and the project's demo) are reachable.
- * The direct addresses are its own browser's port, when it has one (review 828), and an app on this computer it
- * reads (`local`: Figma's desktop server): the proxy refuses loopback. */
-export declare function scoutProxyEnv(proxy: string, browserUrl?: string | null, local?: readonly string[]): Record<string, string>;
-export type ScoutRequest = {
-    /** v105: what's left of a monthly budget this API-key work counts toward (the CLI's own cap), when one does. */
-    maxBudgetUsd?: number;
-    taskId: string;
-    taskTitle: string;
-    /** The approved scope's goal — the question the scout answers. */
-    goal: string;
-    outOfScope: string | null;
-    taskRef: number;
-    runner: string;
-    leaseId: string;
-    runnerToken?: string;
-    runId: number;
-    worktree: string;
-    branch: string;
-    now: Date;
-    clock?: () => Date;
-    model?: string;
-    provider?: ProviderId;
-    maxTurns?: number;
-    timeoutMs?: number;
-    pulseMs?: number;
-    onProviderSpawn?: (pid: number) => void;
-    permissionMode?: string;
-    evidenceRoot?: string;
-    agent?: Runner;
-    git?: Runner;
-    /** Answered questions from earlier scouting rounds, for the brief. */
-    answers?: readonly {
-        question: string;
-        choice: string;
-        note: string | null;
-    }[];
-    /** Where the scout may save screenshots: outside the checkout, so the clean-tree proof still holds. Left out, a
-     * fresh temporary folder is made for this run and removed after it. */
-    outputDir?: string;
-    /** The project's own demo or dev server, the one non-public address the scout's browser may open. */
-    demoUrl?: string | null;
-    /** The browser to launch; left out, the pinned helper in Toolroll's helpers folder. Null runs the scout without one. */
-    browserTool?: {
-        command: string | null;
-        args: readonly string[];
-    } | null;
-};
-export type ReportArtifact = {
-    key: string;
-    bytesOriginal: number;
-    bytesStored: number;
-    truncated: boolean;
-    sha256: string;
-    capture: string;
-    /** True when credential-shaped lines were redacted before storage (v4 review, finding 8). */
-    redacted: boolean;
-};
-export type ScoutOutcome = {
-    ok: true;
-    parked: {
-        decision: ParsedDecision;
-        artifactIds: number[];
-    };
-} | {
-    ok: true;
-    reported: {
-        report: ParsedReport;
-        artifact: ReportArtifact;
-    };
-} | {
-    ok: false;
-    /** malformed → straight incident; everything else → a strike. */
-    kind: "malformed" | "failure";
-    reason: string;
-    message: string;
-    problems?: (Problem | ReportProblem)[];
-};
-/** v126: the outside event a task started from, in its kept words, or null. */
-export declare function outsideReferenceOf(store: Store, taskId: string): string | null;
-/** The scout's brief: read, ask, report — never change. */
-export declare function scoutBrief(title: string, goal: string, outOfScope: string | null, mailbox: string, reportFile: string, answers: readonly {
-    question: string;
-    choice: string;
-    note: string | null;
-}[], structured: boolean, browser: {
-    folder: string;
-    demoUrl: string | null;
-} | {
-    problem: string;
-} | null, web?: boolean, services?: readonly {
-    id: string;
-    label: string;
-}[], 
-/** v126: the outside event the work started from (task-source.ts), quoted as data; null for every other task. */
-outsideReference?: string | null): string;
-export declare function scout(store: Store, request: ScoutRequest): Promise<ScoutOutcome>;
-/** One screenshot from the scout's output folder: a plain file name (never a path), a regular file (never a link),
- * at most SCREENSHOT_BYTE_CAP, and a PNG or JPEG by its signature. */
-export declare function readReportImage(folder: string, file: string): {
-    ok: true;
-    bytes: Buffer;
-    kind: "png" | "jpeg";
-} | {
-    ok: false;
-    problem: string;
-};
-/** The shorten turn's ask: the fields over their limits, and the same report again within them. */
-export declare function shortenReportBrief(over: readonly ReportProblem[], reportFile: string, structured: boolean): string;
-/** Whether a stream event shows the session writing its plan-mode plan
- * file (~/.claude/plans/…) or handing a plan to ExitPlanMode. */
-export declare function touchesPlanFile(event: Record<string, unknown>): boolean;
-/** A cited link without its secrets: credential-shaped query values and path parts become REDACTED, a fragment
- * that carries one is dropped, and a link still showing one keeps only its origin. Unchanged when it has none. */
-export declare function scrubUrl(text: string): {
-    url: string;
-    scrubbed: boolean;
-};

package/dist/secret-mint.d.ts

@@ -1 +0,0 @@
-export declare function mintSecret(bytes: number, draw?: (size: number) => Buffer): string;

package/dist/serve.d.ts

@@ -1,11 +0,0 @@
-import { type ServeOptions } from "./server/http.js";
-import { type DecisionServer } from "./server/session.js";
-export declare function createDecisionServer(options: ServeOptions): DecisionServer;
-export { PAGE_CSS, pinnedTheme, SENSITIVE_INPUT } from "./server/chrome.js";
-export { redactedPath, SHUTDOWN_WAIT_MS, type ServeOptions } from "./server/http.js";
-export { TASK_COMPOSER_MODES, type TaskComposerMode } from "./server/render-chat.js";
-export { queueScript } from "./server/render-pages.js";
-export { ssoStepUps, wrongHostPage } from "./server/render-people.js";
-export { diffFileAnchor, editorFileHref, needActionOf, orderChangedFiles, plainConclusionOf, rankReviewQueue, reviewFilePriority, reviewPriorityOf, runFactsFragment, withinSignedTouches, type ReviewFileRow, type ReviewPriority, type ReviewQueueFacts } from "./server/render-results.js";
-export { decisionAnswerScript, earlierVersionsWords, revisionLineageWords, type RouteView } from "./server/render-tasks.js";
-export { SIGN_IN_LINK_MS, SIGN_IN_LINK_PATH, type DecisionServer } from "./server/session.js";

package/dist/server/agents-computers.d.ts

@@ -1,9 +0,0 @@
-import type { BrowserAgentPhase, BrowserAgentsSystem, BrowserComputers } from "../browser-workspace.js";
-import type { Store, WorktreeRow } from "../store.js";
-/** Every registered computer that isn't retired, plus a retired one still holding reserved work, as Agents lists it. */
-export declare function computersOf(store: Store, now: Date, visible: (repo: string | null) => boolean, manage: boolean): BrowserComputers;
-/** Which provider and model runs each phase for the open project (or the installation), and where that choice comes from. */
-export declare function phasesOf(store: Store, project: string | null): BrowserAgentPhase[];
-/** The rest of what /system showed: its workspaces, the background service on the open project, notifications waiting
- * to go out and external work. */
-export declare function systemOf(store: Store, project: string | null, worktreeShown: (tree: WorktreeRow) => boolean, visible: (repo: string | null) => boolean): BrowserAgentsSystem;

package/dist/server/agents-live-filed.d.ts

@@ -1,17 +0,0 @@
-/**
- * Work a lead filed, nested under it on the Live grid (docs/plans/lead-dispatched-tiles.md): which of the viewer's
- * tiles were filed through the viewer's OWN lead chat, and which chat. Proved from the store only, at request time: the
- * task's family root was filed through the lead (`filed_via = 'mate'`) by the viewer as a person, and exactly one record
- * links that root to one of the viewer's own personal lead threads — a confirmed task card the viewer confirmed (its
- * door-written outcome, never the model's payload) or a sweep the viewer started from a card still kept. Attribution is
- * to the chat that filed the family's ORIGINAL task: a revision asked for in another chat stays with the family. Anything
- * short of that is no link:
- * the tile stays a top-level tile, as it is today. A link only groups tiles the viewer already gets; it never adds one.
- */
-import type { Store } from "../store.js";
-export type FiledBy = {
-    thread: number;
-    chat: "lead" | "project" | "task";
-};
-/** For each run id given (the tiles already in this viewer's answer), the viewer's lead chat that filed its task. */
-export declare function leadFiledLinks(store: Store, viewer: string, runIds: readonly number[]): Map<number, FiledBy>;

package/dist/server/agents-live-lead.d.ts

@@ -1,47 +0,0 @@
-/**
- * Lead tiles on the Live grid (docs/plans/agents-view.md slice 8): the viewer's OWN lead chat turns, and only through
- * the chat room's own admission — an approver with a lead standing, the thread theirs, open, the newest for its scope,
- * never a team conversation, under the ceiling it opened with, and its project or task still theirs to see. Team
- * threads wait for their own admission. The words go through one stateful redactor per turn (one key state carried
- * across every step and every line of the turn's current snapshot), then controls out, then a cap. Memory only: the
- * tile is the live turn's, and leaves with it (60 s after the turn ends).
- */
-import type { LeadLiveStep } from "../lead-progress.js";
-import type { ServerRuntime } from "./runtime.js";
-import type { Who } from "./session.js";
-/** A lead tile keeps at most this many lines, and this many bytes of them (the newest). */
-export declare const LEAD_LINES = 200, LEAD_BYTES: number;
-export type LeadTile = {
-    thread: number;
-    /** The turn being answered (lead.ts's turn id), once the turn has said it. */
-    turn: number | null;
-    scope: "lead" | "project" | "task";
-    title: string;
-    project: string | null;
-    state: "working" | "done" | "failed";
-    startedAt: string;
-    endedAt: string | null;
-    /** When each step began. */
-    stepAt: string[];
-    /** What it is doing now, in fixed words; null once it ended. */
-    doing: string | null;
-    lines: string[];
-    /** Whether older lines were cut to fit. */
-    earlier: boolean;
-    chatHref: string;
-    taskHref: string | null;
-};
-/** One turn's lines, redacted as one stream: every step's tools and words in order through ONE key state (a key block
- * opened in one step stays hidden into the next), each line cleaned and cut, then the newest kept within the caps.
- * `confirmed[i]`: step i's text is its finished answer, secret-checked whole. */
-export declare function leadLines(steps: readonly LeadLiveStep[], confirmed?: readonly boolean[]): {
-    lines: string[];
-    earlier: boolean;
-};
-type LeadDeps = Pick<ServerRuntime, "store" | "liveTurns" | "leadPrincipal" | "familyOf" | "visible" | "managedRepos">;
-/** The viewer's own live lead turns, admitted as the chat room admits them, proved now. */
-export declare function leadTilesFor(deps: LeadDeps, who: Who): LeadTile[];
-/** The tiles projected earlier that are still this viewer's right now (the whole admission proved again, with the
- * session as it is saved now): what is delivered is never more than what is admitted at the moment of delivery. */
-export declare function leadsStillAdmitted(deps: LeadDeps, who: Who, tiles: readonly LeadTile[]): LeadTile[];
-export {};

package/dist/server/agents-live-room.d.ts

@@ -1,23 +0,0 @@
-import { type LiveBus, type LiveViewer } from "../live-bus.js";
-import type { Store } from "../store.js";
-/** How often a viewer's runs and files are looked at again. */
-export declare const LIVE_POLL_MS = 2000;
-/** At most this many of a viewer's runs have their files looked at (the grid streams at most this many). */
-export declare const LIVE_WATCHED_RUNS = 24;
-export declare function createAgentsLiveRooms<V extends LiveViewer>(input: {
-    store: Store;
-    bus: LiveBus;
-    evidenceRoot: string;
-    localRunner: string | undefined;
-    clock: () => Date;
-    /** Whether the console shows this project at all (its ceiling). */
-    visible: (repo: string | null) => boolean;
-    /** The keyed viewer's own lead tiles as they stand now (agents-live-lead.ts), proved from their saved session. */
-    leads?: (key: string) => unknown;
-    /** Told when a page's room is gone. */
-    forget?: (key: string) => void;
-}): {
-    rooms: import("../live-bus.js").LiveRooms<string, V>;
-    keyOf: (account: string, scope: string, page?: string) => string;
-    looked: () => number;
-};

package/dist/server/chat.d.ts

@@ -1,39 +0,0 @@
-import { type BrowserFirstRun, type BrowserHome, type BrowserPhoneCard } from '../browser-workspace.js';
-import { type DemoResultView } from "../demo-chat.js";
-import type { DemoExchange } from "../demo.js";
-import { type FirstTaskSuggestion } from "../first-run.js";
-import type { LeadProgress } from "../lead-progress.js";
-import type { ShapeOptions } from "../reply-shape.js";
-import type { DirectChatProviderId } from "../store.js";
-import type { ServerRuntime } from './runtime.js';
-import { type ChatEnablement } from "./render-chat.js";
-import { type Session, type Who } from "./session.js";
-export declare function createChatHandlers(runtime: ServerRuntime): {
-    registrations: import("./handler-registry.js").Registration[];
-    chatFirstRun: (now: Date, project: string | null) => BrowserFirstRun | undefined;
-    phoneCard: (who: Who & {
-        via: "cookie";
-    }, now: Date) => BrowserPhoneCard | undefined;
-    chatProjectOf: (values: string[]) => string | null | undefined;
-    beginLiveTurn: (thread: number, shape?: ShapeOptions) => (event: LeadProgress) => void;
-    endLiveTurn: (thread: number, ok: boolean, progress?: (event: LeadProgress) => void) => void;
-    noteLead: (csrf: string, turn: number | null, message: string) => void;
-    takeLeadNote: (csrf: string, liveSession: number | null) => string | null;
-    demoResultView: (exchange: DemoExchange) => DemoResultView | null;
-    storeChatKey: (provider: DirectChatProviderId, key: string) => {
-        ok: true;
-    } | {
-        ok: false;
-        message: string;
-    };
-    forgetChatKey: (provider: DirectChatProviderId) => void;
-    sweepChatDrafts: (nowMs: number) => void;
-    runChatTurn: (turnId: number, session: Session, enabled: Extract<ChatEnablement, {
-        ok: true;
-        billing: "metered";
-    }>, userMessage: string, dataDocument: string, turnRepos: readonly string[]) => Promise<void>;
-    chatHomeOf: (who: Who, repos: readonly string[], now: Date) => BrowserHome;
-    firstTasksFor: (repo: string) => FirstTaskSuggestion[];
-    approverCandidateCount: (approver: string) => number;
-    evictOldestCandidate: (approver: string) => void;
-};