toolroll 0.9.103 → 0.9.105

package/dist/models-ui.d.ts

@@ -1,161 +0,0 @@
-/** Settings → Models, in the kit's Settings frame (a sub-page of "Agents and models"): what is in use and the one
- * choice (a preset, previewed before it applies), then the model for each role behind a disclosure, the CLIs on
- * this computer and the models that just arrived. Saving is an instance operator's step-up. */
-import { type Html } from "./html.js";
-import { type ApprovalFacts } from "./design/kit.js";
-import type { ModelOption, RuntimeState, SeenModel, WatchState } from "./model-catalog.js";
-/** The page's own layout on the kit: one-column preset cards, the role pickers in the form rows' control column. */
-export declare const MODELS_CSS: string;
-/** One row of the editor: a role at the scope being edited. */
-export type RoleView = {
-    /** The slot's form field (model-choices.ts slotKey). */
-    key: string;
-    label: string;
-    /** "provider|model", or "" when this scope has no row of its own. */
-    current: string;
-    /** What runs now, in words, including what is inherited. */
-    words: string;
-    /** What "no row here" means for this role: "Same as the builder", "Same as the installation (…)", "Not set". */
-    unset: string;
-    groups: {
-        label: string;
-        provider: string;
-        options: ModelOption[];
-    }[];
-    /** Behind the tiers disclosure. */
-    tier: boolean;
-};
-export type DiffView = {
-    role: string;
-    before: string;
-    after: string;
-    notes: string[];
-};
-export type ModelsView = {
-    runtimes: RuntimeState[];
-    watch: WatchState;
-    roles: RoleView[];
-    chat: {
-        words: string;
-    } | null;
-    fresh: SeenModel[];
-    csrf: string;
-    canManage: boolean;
-    said: string | null;
-    problem: string | null;
-    /** The scope being edited, the scopes on offer, and the digest of what this page shows. */
-    scope: {
-        value: string;
-        label: string;
-        options: {
-            value: string;
-            label: string;
-        }[];
-        digest: string;
-    };
-    /** "Sized by job", "Opus for everything", or null for a custom set. */
-    inUse: string | null;
-    presets: {
-        name: string;
-        label: string;
-        words: string;
-        inUse: boolean;
-        recommended: boolean;
-    }[];
-    /** Newer models the watch has seen for exact ids in use here. */
-    newer: {
-        from: string;
-        to: string;
-        name: string;
-        roles: string;
-    }[];
-    /** A preset or switch's exact diff, shown before it applies. */
-    preview: {
-        title: string;
-        rows: DiffView[];
-        hidden: Record<string, string>;
-    } | null;
-    /** What still keeps tasks from being filed at this scope, or null. */
-    unresolved: string | null;
-    sizing: {
-        small: string;
-        routine: string;
-        large: string;
-        risky: string;
-        classifier: string;
-    };
-    routing: string;
-    recent: {
-        taskId: string;
-        runId: number;
-        role: string;
-        chosen: string;
-        ranOn: string;
-    }[];
-    waiting: {
-        taskId: string;
-        title: string;
-    }[];
-    /** What this request's approval shows (approvalFactsNow): a step-up asks for the password unless Passwordless is on. */
-    facts?: ApprovalFacts;
-    /** Results routing (slice 2): cheaper models this project's own results suggest, its earned rules, its switch. */
-    suggested?: SuggestedView;
-};
-/** The Suggested group: offers, a reviewed offer, the project's rules, and its "Suggest cheaper models" switch. */
-export type SuggestedView = {
-    /** The project shown, or null on the installation scope (offers from every project, each reviewed on its own). */
-    repo: string | null;
-    offers: {
-        id: string;
-        repo: string;
-        project: string;
-        title: string;
-        words: string;
-    }[];
-    /** "Review change": the evidence, the switch-back terms and the step-up save; `stale` when the offer reviewed is
-     * no longer the one on offer. */
-    review: {
-        id: string;
-        repo: string;
-        title: string;
-        evidence: string[];
-        prices: string;
-        terms: string[];
-        save: string;
-    } | {
-        stale: true;
-        repo: string;
-    } | null;
-    rules: {
-        id: number;
-        repo: string;
-        project: string;
-        title: string;
-        words: string;
-        state: "active" | "paused" | "ended";
-    }[];
-    /** The project's switch (null on the installation scope). */
-    suggest: {
-        on: boolean;
-    } | null;
-    /** Slice 3: cheaper models to try on the next few tasks (a step-up starts one), and the trials in use (Stop). */
-    trialOffers?: {
-        id: string;
-        repo: string;
-        project: string;
-        title: string;
-        words: string;
-        save: string;
-    }[];
-    trials?: {
-        id: number;
-        repo: string;
-        project: string;
-        title: string;
-        words: string;
-        live: boolean;
-    }[];
-};
-export declare function modelsHtml(view: ModelsView): Html;
-/** Filters one long picker as you type; the saved choice always stays listed. */
-export declare function modelsScript(): string;

package/dist/modes.d.ts

@@ -1,99 +0,0 @@
-/**
- * Operating modes (v29, the modes chain v1–v7): a per-repository,
- * password-signed, expiring envelope that pre-authorizes the SIGNER'S OWN
- * future acts. The absence of a mode is 'locked' — every act keeps its
- * own ceremony, today's world, the default forever.
- *
- * The doctrine (v4 ruling): RAISING authority is a password ceremony;
- * LOWERING it is one click for any approver; on revocation or expiry
- * every mode-derived flow falls back to the human ceremony at its next
- * gate, and running work is never fenced.
- *
- * This module owns the terms shape, the digest, and the words. The store
- * owns the transactions; the tick owns the rails; serve owns the
- * ceremony screens.
- */
-import { type ChatProvider } from "./contracts/chat-tables.js";
-export type ModeName = "standard" | "hands-off";
-export type ModeTerms = {
-    name: ModeName;
-    /** The filing default per provider (C7 matrix): "safe" = auto /
-     * auto_edit; "escalated" = bypassPermissions / yolo. Codex-shaped
-     * providers have one posture and the ceremony words say escalation
-     * changes nothing for them. */
-    permissionDefault: "safe" | "escalated";
-    /** Auto-approve the SIGNER'S OWN credentialed filings (C1's predicate
-     * and road table). */
-    autoApproveFiling: boolean;
-    /** Explicit opt-in: a verified planner may approve a plan that preserves
-     * the signer's pre-authorized filed contract and execution terms exactly. */
-    planAuto: boolean;
-    /** Historical signed field (watched sessions without a per-session
-     * password, removed in v115); new modes leave it false and nothing reads it. */
-    quickMint: boolean;
-    /** Historical signed field; new modes leave it false and no worker consumes
-     * it. Automatic review is the project's review switch (review-switch.ts),
-     * on by default while a hands-off mode is active. */
-    reviewAuto: boolean;
-    /** Historical signed retry term, retained for digest and audit compatibility. */
-    reviewRetryAuto: boolean;
-    /** Stamped into filings that name no budget of their own. */
-    perAttemptBudgetMicrousd: number | null;
-    /** SOFT rail: new admissions stop once the day's MEASURED spend has
-     * reached this; running work may finish past it (D4). */
-    dailyMeasuredCapMicrousd: number | null;
-    /** HARD rail: reservation-counted admissions per UTC day, covering
-     * unmeasured providers too (D4). */
-    dailyRunCap: number | null;
-    /** "notify" = merges wait for a human even under a merge grant;
-     * "automerge" = the mode's signature substitutes for the per-merge
-     * human authorization, through the grant machinery only (D1/E1). */
-    publication: "notify" | "automerge";
-    /** Historical signed term (v30-v114: a grant for automatic paid
-     * fallback; fallback chains were removed in v115). Always false on new
-     * modes; retained for digest and audit compatibility. */
-    allowPaidFallback: boolean;
-    /** Whether this mode AUTHORIZES repairing a failed check: drafting and
-     * auto-approving each attempt (check-repair.ts). Legacy modes default FALSE,
-     * a new authority is never inherited, only freshly signed. Without it a
-     * failed check waits for a person, whose repair takes the normal approval. */
-    repairAuto: boolean;
-    /** The signed cap on repair attempts per chain (0..3), counted over the
-     * chain rooted at the original task. Meaningless (read as 0) unless
-     * `repairAuto` is also true — a mode may sign a cap without signing the
-     * authority, but never the reverse. */
-    repairMaxAttempts: number;
-    /** Explicit opt-in: the signer's paired chat may approve this
-     * repository's plans and merge its ready pull requests with two taps,
-     * for the mode's lifetime. A plan that widens permissions, exceeds the
-     * per-attempt budget or touches protected paths still opens Toolroll.
-     * Legacy modes read FALSE — never inherited, only freshly signed. */
-    chatApprove: boolean;
-    /** The chat apps `chatApprove` names, signed with it. Absent on a mode signed before chat apps other than Telegram
-     * could approve: its words said "your paired Telegram chat", so it stays Telegram only (chatApproveChatsOf). A wider
-     * grant is only ever a fresh signature naming the apps. */
-    chatApproveChats?: readonly ChatProvider[];
-    absoluteExpiry: string;
-};
-export declare const MODE_MAX_DAYS = 7;
-/** Repairs of one failed check's chain: what a person can start, and what the console's choice signs. The CLI signs 1 to 3. */
-export declare const CHECK_REPAIR_LIMIT = 2;
-/** The presets are STARTING POINTS the ceremony renders in full — the
- * signature always covers the resolved terms, never a label. */
-export declare function presetTerms(name: ModeName, absoluteExpiry: string): ModeTerms;
-export declare function modeTermsJson(terms: ModeTerms): string;
-/** sha256 over a domain-separated canonical encoding, 32 hex like every
- * other safety digest here. */
-export declare function modeDigestOf(terms: ModeTerms): string;
-/** Strict rehydration — anything unexpected is null, never a guess. */
-export declare function modeTermsFromJson(json: string | null): ModeTerms | null;
-/** The chat apps a mode lets its signer approve from: none without chatApprove; Telegram alone for a grant signed
- * before it named its apps (that is what its words said); otherwise exactly the apps it names. */
-export declare function chatApproveChatsOf(terms: Pick<ModeTerms, "chatApprove" | "chatApproveChats">): readonly ChatProvider[];
-/** What a new chatApprove signature names: every chat app, said in its words. */
-export declare const CHAT_APPROVE_ALL: readonly ChatProvider[];
-/** "Telegram", "Telegram or Slack", "Telegram, Slack, Discord or Teams". */
-export declare const chatNames: (chats: readonly ChatProvider[]) => string;
-/** Every term in words — what the ceremony renders and the password
- * signs. The reversal sentence is verbatim from the chain (C1). */
-export declare function modeWords(terms: ModeTerms): string[];

package/dist/monitoring-settings.d.ts

@@ -1,44 +0,0 @@
-/** Where an address points, without its path or query (a webhook may carry a key in either). */
-export declare const origin: (address: string) => string;
-export type MonitoringSettings = {
-    webhook: {
-        url: string;
-        secret: string;
-    } | null;
-    folder: {
-        path: string;
-    } | null;
-    traces: {
-        endpoint: string;
-        header: {
-            name: string;
-            value: string;
-        } | null;
-    } | null;
-};
-export declare const NO_MONITORING: MonitoringSettings;
-/** An address Toolroll may send to: https anywhere, http only to this machine (a collector beside it). */
-export declare function sendableAddress(value: string): string | null;
-export declare function readMonitoring(dir: string | null | undefined): MonitoringSettings;
-/** A fresh signing secret for the webhook (shown once; the receiver keeps it to check each request). */
-export declare function newSigningSecret(): string;
-export type MonitoringForm = {
-    webhook: string;
-    folder: string;
-    tracesEndpoint: string;
-    headerName: string;
-    headerValue: string;
-    rotate: boolean;
-};
-export declare function saveMonitoring(dir: string, form: MonitoringForm, previous: MonitoringSettings, forbidden?: readonly string[]): {
-    ok: true;
-    settings: MonitoringSettings;
-    secret: string | null;
-} | {
-    ok: false;
-    said: string;
-};
-/** The change in words for the ledger: where things go and header names, never a secret or a full address. */
-export declare function monitoringWords(settings: MonitoringSettings): string;
-/** A change for the ledger: before → after, and what changed that the words alone don't show (never the values). */
-export declare function monitoringChange(before: MonitoringSettings, after: MonitoringSettings, newSecret: boolean): string | null;

package/dist/monitoring-ui.d.ts

@@ -1,23 +0,0 @@
-/**
- * Settings → Monitoring (v104): an instance operator points Toolroll at
- * the company's tools. One form, the status of each destination beside it,
- * and how Prometheus reads `/metrics`. The signing secret is shown once.
- * Built from the revamp kit; the Settings frame adds the title.
- */
-import { type Html } from "./html.js";
-import type { MonitoringStatus } from "./store.js";
-import type { MonitoringSettings } from "./monitoring-settings.js";
-/** The page is kit pieces now; nothing of the old look is left. Kept as an export for the shared stylesheet. */
-export declare const MONITORING_CSS = "";
-export type MonitoringView = {
-    settings: MonitoringSettings;
-    status: MonitoringStatus[];
-    head: number;
-    origin: string | null;
-};
-export declare function monitoringHtml(view: MonitoringView, said: {
-    said?: string | null;
-    problem?: string | null;
-}): Html;
-/** The webhook's signing secret, once: a focused page with no script. */
-export declare function signingSecretHtml(url: string, secret: string): Html;

package/dist/monitoring.d.ts

@@ -1,34 +0,0 @@
-import type { SealedLedgerEntry, Store } from "./store.js";
-import type { MonitoringSettings } from "./monitoring-settings.js";
-export type Sink = "webhook" | "folder" | "traces";
-export declare const SIGNATURE_HEADER = "x-standing-orders-signature";
-/** An audit event: the ledger entry and its seal, as the stream sends it. */
-export declare function auditEvent(entry: SealedLedgerEntry, instance: string): Record<string, unknown>;
-/** The signature a receiver recomputes: HMAC-SHA256(secret, "<t>.<body>"), hex. */
-export declare function signature(secret: string, timestamp: number, body: string): string;
-export type MonitoringDeps = {
-    fetch?: typeof fetch;
-    now?: () => Date;
-    holder: string;
-    instance: string;
-    version: string;
-};
-/** One pass over every destination that's set up. Returns what it sent, per destination. */
-export declare function monitoringPass(store: Store, settings: MonitoringSettings, deps: MonitoringDeps): Promise<Partial<Record<Sink, number>>>;
-/** A destination's name in its status row: a digest of its address (the address itself may carry a key). */
-export declare const targetOf: (address: string) => string;
-/** Spans for the batch's finished runs and completed tasks (the rest of the ledger isn't traced; the cursor passes it). */
-export declare function spansFor(store: Store, entries: SealedLedgerEntry[]): Record<string, unknown>[];
-/** This build's version, from its package.json ("unknown" when it can't be read). */
-export declare function packageVersion(): string;
-/** Who this process is, for the lease: host, pid and a random part (a restarted pid is a new holder). */
-export declare function monitoringHolder(): string;
-/** The loop `up` runs: a pass every `everyMs`, settings read afresh each time (a change applies at the next pass). */
-export declare function startMonitoring(options: {
-    store: Store;
-    settings: () => MonitoringSettings;
-    instance: string;
-    version: string;
-    everyMs?: number;
-    progress?: (line: string) => void;
-}): () => void;

package/dist/names.d.ts

@@ -1,67 +0,0 @@
-/**
- * The product's internal name, and every older one it still answers to.
- *
- * Toolroll was Standing Orders, which was nightorders. A rename must never
- * orphan an installation: new things use the new name, while a folder,
- * variable, branch, launchd job or skill that already exists under an older
- * name keeps being found. Nothing is moved; the old one is used until one
- * exists under the new name. Strings that feed a hash, a digest or a stored
- * format id are not names in this sense and stay byte-identical.
- */
-export declare const NAME = "toolroll";
-/** Older names, newest first. */
-export declare const LEGACY_NAMES: readonly ["standing-orders", "nightorders"];
-export declare const NAMES: readonly string[];
-/**
- * A file inside the product's folder under `base` (~/.config, ~/.cache, or a
- * home dotfolder when `dot` is set). The first name that already holds the
- * file wins; otherwise the file goes into the folder that holds the database,
- * else the first folder that exists, else a new-name folder — so one install
- * keeps one folder, and a fresh one gets ~/.config/toolroll.
- */
-export declare function namedPath(base: string, rest: readonly string[], options?: {
-    dot?: boolean;
-    names?: readonly string[];
-}): string;
-/** The product's folder under `base`: see namedPath. */
-export declare function namedFolder(base: string, options?: {
-    dot?: boolean;
-    names?: readonly string[];
-}): string;
-/** Every folder under `base` that any name has made, for fencing and cleanup. */
-export declare function existingFolders(base: string, options?: {
-    dot?: boolean;
-}): string[];
-/** ~/.config (or $XDG_CONFIG_HOME). */
-export declare function configBase(env: Record<string, string | undefined>, home: string): string;
-export declare const ENV_PREFIX = "TOOLROLL_";
-export declare const LEGACY_ENV_PREFIX = "STANDING_ORDERS_";
-/**
- * An environment setting by its suffix ("DB" → TOOLROLL_DB). The new name
- * wins whenever it is set; the old STANDING_ORDERS_ one is the fallback.
- */
-export declare function envValue(env: Record<string, string | undefined>, suffix: string): string | undefined;
-/** The Telegram bot token's variable, and the name it had before the rename: agents never see either.
- * Kept here, in a module with no imports of its own, so builder.ts can read it at load time. */
-export declare const TELEGRAM_TOKEN_ENV = "TOOLROLL_TELEGRAM_TOKEN";
-export declare const TELEGRAM_TOKEN_ENVS: readonly string[];
-/** Both names of a setting, for a child the plane starts: older tools read the old one. */
-export declare function envTwins(suffix: string, value: string): Record<string, string>;
-/** True for a variable of either name ("TOOLROLL_DB", "STANDING_ORDERS_DB"). */
-export declare function isOwnEnv(key: string): boolean;
-/** New task branches are toolroll/<id>; the plane's older ones stay its own. */
-export declare const BRANCH_PREFIX = "toolroll/";
-export declare const BRANCH_PREFIXES: readonly string[];
-export declare function taskBranch(id: string): string;
-/** A branch the plane made, under either name. */
-export declare function isOwnBranch(branch: string): boolean;
-/**
- * Whether a head branch is inside a publication grant's prefix. A grant made
- * for the plane's own branches under one name covers the same branches under
- * the other: a standing-orders/ grant still publishes toolroll/<id> work.
- */
-export declare function headWithin(head: string, prefix: string): boolean;
-/** Every name a task's own branch may have, newest first. */
-export declare function taskBranches(id: string): string[];
-/** The first candidate branch that already exists (a retry reuses its branch), else the first — the new name. */
-export declare function existingOrFirst(candidates: readonly string[], exists: (branch: string) => Promise<boolean>): Promise<string>;

package/dist/needs-you.d.ts

@@ -1,164 +0,0 @@
-/** Every reason a task, result or flow card can wait on a person, in one
- * place: the plain sentence it shows and the one action that resolves it
- * (task-status.ts reads it for every surface). A reason no person can act
- * on is not Needs you: it is a Waiting reason, worded as what it waits for.
- *
- * The words never name the machine's internals; `plainSentence` keeps a
- * recorded reason only when it is free of them. */
-/** What a person is asked for. */
-export type NeedKey = "approval" | "card" | "answer" | "questions" | "sign-in" | "stop-unproven" | "hold" | "storage" | "choose-project" | "define-task" | "fix-request" | "choose-agent" | "fix-dependency" | "add-requirement" | "connect-builder" | "start-builder" | "vanished" | "review-result" | "rebuild" | "replan" | "earlier-version" | "history" | "finding" | "other";
-/** What the work waits for when no person can act. */
-export type WaitKey = "build-stopping" | "build-finishing" | "build-checking" | "other-computer" | "card-reply" | "card-time" | "card-ci" | "plan-next" | "research-next" | "builders-busy" | "retry-later" | "app-update" | "other-task";
-/** The action's code: the WorkAction that owns the act, or one of the acts a surface renders itself. */
-/** The reason a storage hold carries before the check's own words (dispose.ts holdForStorage; dispatch.ts and
- * work-index.ts read it back). */
-export declare const STORAGE_HOLD_PREFIX = "protected-storage \u2014 ";
-export type NeedActionCode = "approve-scope" | "approve-card" | "answer-decision" | "inspect-decisions" | "sign-in" | "recheck-stopped" | "inspect-hold" | "place-task" | "write-scope" | "select-agent" | "repair-dependency" | "repair-capability" | "start-worker" | "reconcile-run" | "open-result" | "retry-task" | "inspect-task" | "inspect-findings" | "unhold";
-export type NeedAction = {
-    code: NeedActionCode;
-    label: string;
-};
-/** Where "Connect a builder" and "Start the builder" lead (code `start-worker`): the Start a builder page, which shows
- * the one command to run and the open project's builder state. Every signed-in person can open it, a project-limited
- * one included (System is instance-only). Never the task's own page, which only repeats that nothing is connected. */
-export declare const START_BUILDER_HREF = "/start-builder";
-/** Start a builder for one task: the page reports that task's own project, whatever project is open. */
-export declare const startBuilderHref: (taskId: string | null) => string;
-/** What starts a builder: run on the machine where the project lives, in the project's folder. */
-export declare const START_BUILDER_COMMAND = "toolroll up";
-/** `build`: the run a sentence names; `provider`: the agent that signed out; `task`: another task it names (an
- * earlier version); `retry`: when Toolroll tries again, in words ("in 4 minutes"). */
-export type NeedContext = {
-    build?: number | null;
-    provider?: string | null;
-    task?: string | null;
-    retry?: string | null;
-};
-/** `useReason`: which recorded reasons say what is needed better than the default words. */
-type Need = {
-    sentence: (context: NeedContext) => string;
-    action: NeedAction;
-    useReason?: (reason: string) => boolean;
-    /** How a kept reason reads: by default the reason alone. */
-    withReason?: (reason: string) => string;
-};
-export declare const NEEDS: Readonly<Record<NeedKey, Need>>;
-/** What a waiting task asks of a person, in three kinds the Tasks list groups
- * by: a choice to make, a result to accept or send back, or something in the
- * way to clear. Decide comes first. */
-export type Ask = "decide" | "review" | "unblock";
-export declare const ASKS: readonly Ask[];
-export declare const ASK_LABEL: Readonly<Record<Ask, string>>;
-/** A waiting row's chip: the specific thing asked, never its group's own word (no "Decide" chip under Decide).
- * Null: the group heading and the row's sentence already say it, so the row wears no chip. */
-export type AskChip = "Plan" | "Result" | "Mismatch" | "Plan changed" | "Failed" | "Builder offline" | "Question" | "On hold" | "Stopped" | "Sign in";
-/** `mismatch`: the saved report doesn't match its changes; `planChanged`: the plan changed after it was built. */
-export declare function askChipOf(read: {
-    headline: string;
-    need?: NeedKey | null;
-    mismatch?: boolean;
-    planChanged?: boolean;
-    ask?: Ask | null;
-}): AskChip | null;
-/** Why a saved result can't simply be accepted yet, in its own words (each Review row says its own reason,
- * never a boilerplate line). The facts are the ones the Tasks list and the task page both read. */
-export type ResultHoldUp = {
-    hold: string | null;
-    planChanged: boolean;
-    unapproved: boolean;
-    running: boolean;
-    unfinished: boolean;
-    noCommit: boolean;
-    question: boolean;
-    report: boolean;
-};
-export declare function resultHoldUpSentence(facts: Partial<ResultHoldUp>): string;
-export declare const NEED_ASK: Readonly<Record<NeedKey, Ask>>;
-export declare const WAITS: Readonly<Record<WaitKey, (context: NeedContext) => string>>;
-/** Words that name the machine's internals (plain-words.ts, the one table); no Needs you or Waiting sentence carries
- * them, and a recorded reason that does is replaced by the need's own words. */
-export { BANNED_WORDS, PLAIN_WORDS, bannedWordsIn, hasInternalWords } from "./plain-words.js";
-/** The sentence for a need: its recorded reason when the need keeps one and
- * it reads plainly, otherwise the need's own words. */
-export declare function needSentence(key: NeedKey, reason: string | null, context?: NeedContext): string;
-export declare function waitSentence(key: WaitKey | undefined, reason: string | null, context?: NeedContext): string;
-/** A finished run Toolroll can't yet prove stopped (store.stopQuiescenceFact). Nobody is asked to confirm it:
- * `unprovable` is Toolroll's own check still to run (stop-proof.ts), which settles by itself; `unknown` is that this
- * computer can't look, or something Toolroll didn't start is in the build's folder — held, with nothing to vouch for. */
-export declare function processNeedOf(fact: {
-    run: number;
-    kind: "open" | "alive" | "elsewhere" | "unprovable" | "unknown" | "settling";
-} | null): {
-    need: "stop-unproven";
-    build: number;
-} | {
-    wait: WaitKey;
-    build: number;
-} | null;
-/** The stages a code reads as (task-status.ts TaskStage). */
-export type CodeStage = "queued" | "planning" | "needs-you" | "waiting" | "building" | "checking" | "reviewing" | "finished" | "complete" | "failed" | "stopped";
-/** Every dispatch and work-index code, as what it means for a person (docs/plans/plain-toolroll.md P1.2): a need with
- * the act that resolves it, a wait (worded as what it waits for), or a plain state. A code is exactly one of these.
- * `act` is the work-index row's own act for the code, the same act it had before this table: a need keeps its act, a
- * wait offers none. `stopped` and `failed` keep their own act too (Resume, Retry). */
-export type CodeReading = {
-    stage: CodeStage;
-    need?: NeedKey;
-    wait?: WaitKey;
-    act?: NeedActionCode | "inspect-stop" | "resume-run" | "unhold" | "answer-agent" | "inspect-run" | null;
-};
-export declare const CODE_READING: Readonly<Record<string, CodeReading>>;
-/** A code that waits on Toolroll or another task: no person is asked. */
-export declare const isWaitCode: (code: string) => boolean;
-/** Notification kinds that need nothing from a person: they stay in the activity log and never ping a phone. */
-export declare const ACTIVITY_ONLY_KINDS: ReadonlySet<string>;
-/** Dispatch and work-index codes that wait on a person, as their need (read from CODE_READING). */
-export declare const CODE_NEED: Readonly<Record<string, NeedKey>>;
-/** A stopped run's recorded reason code, in words (the run record, the thread, a failed task's status). */
-export declare const RUN_REASON_WORDS: Readonly<Record<string, string>>;
-/** A run's recorded reason in words. A recorded code is never shown as it is
- * stored: one with no words of its own reads as an unexpected stop; a reason
- * already written as words (it has a space) is said as written. */
-export declare function runReasonWords(reason: string): string;
-/** The latest finished build attempt among a task's runs (any order), whatever its outcome: planning and reviewing
- * are not attempts, and an older failure never stands in for a newer attempt. */
-export declare function latestFinishedAttempt<T extends {
-    id: number;
-    role: string;
-    finishedAt: string | null;
-    outcome?: string | null;
-}>(runs: readonly T[]): T | null;
-export declare const NO_REASON_RECORDED = "No reason was recorded for this attempt.";
-export declare const INTERNAL_ERROR = "The attempt stopped with an internal error.";
-/** About as long as one plain line reads. */
-export declare const REASON_LINE_LIMIT = 140;
-/** A recorded reason that is machine output, not words: a stack trace, a file path or "Error:" text. Its detail
- * belongs behind a link, never in the line itself. */
-export declare function isInternalErrorReason(reason: string | null | undefined): boolean;
-/** A failed attempt in one plain line: its recorded reason in words (first line only, about 140 characters at most),
- * that it stopped with an internal error when the reason is machine output, or that none was recorded. */
-export declare function failedAttemptSentence(reason: string | null | undefined): string;
-export declare const GENERAL_SUGGESTION = "Say what to do differently this time.";
-export declare function stopSuggestionOf(reason: string | null | undefined): string;
-/** The suggestion for a requirement the result missed: make sure of it before handing off. */
-export declare function missedRequirementSuggestion(statement: string): string;
-/** The suggestion for a check that failed on the result: make it pass, starting with the line it ended on. */
-export declare function failingCheckSuggestion(line: string): string;
-/** What a failed attempt missed, in plain words: what failed (the missed requirement, the failing check's line or the
- * stop reason), the evidence line behind it, and one suggestion of what to change (Retry's note starts with it). */
-export type FailureExplanation = {
-    kind: "requirement" | "check" | "reason";
-    line: string;
-    evidence: string | null;
-    suggestion: string;
-    link: {
-        label: string;
-        href: string;
-    } | null;
-};
-/** The line for a missed requirement: “Missed: <statement>”, cut to one line. */
-export declare function missedRequirementLine(statement: string): string;
-/** The longest note Retry's field takes. */
-export declare const RETRY_NOTE_LIMIT = 500;
-/** Retry's note, prefilled with the suggestion: cut to what the field takes, at a word, so the form always posts. */
-export declare function retryNoteOf(suggestion: string): string;

package/dist/never-index.d.ts

@@ -1,3 +0,0 @@
-export declare const NEVER_INDEX = ".metadata_never_index";
-/** Put the marker in `dir` (an existing folder). False when it couldn't be written. */
-export declare function markNeverIndex(dir: string): boolean;