toolroll 0.9.103 → 0.9.105

package/dist/model-choices.d.ts

@@ -1,235 +0,0 @@
-import { type SeenModel } from "./model-catalog.js";
-import { type EarnedRule, type PhaseRoute } from "./phase-routing.js";
-import type { Store } from "./store.js";
-export type SlotPhase = "plan" | "build" | "repair" | "review";
-export type SlotTier = "routine" | "light" | "strong";
-export type Slot = {
-    phase: SlotPhase;
-    tier: SlotTier;
-};
-export type Pair = {
-    provider: string;
-    model: string | null;
-};
-/** One row to set (an exact pair) or clear (null). */
-/** A model is null only on the command line's `config set <phase> --provider p` (its harness default). */
-export type ModelChange = {
-    slot: Slot;
-    to: {
-        provider: string;
-        model: string | null;
-    } | null;
-};
-/** Every row the editor owns, in the order the page and the diff show them. Alternates (`--also`) and the strong
- * repair row stay CLI-only; presets clear the strong repair row so repairs follow the builder. */
-export declare const SLOTS: readonly Slot[];
-/** Every row the write path accepts: the editor's, plus the strong repair row the CLI also sets. */
-export declare const ALL_SLOTS: readonly Slot[];
-export declare const slotKey: (slot: Slot) => string;
-export declare function slotOf(key: string): Slot | null;
-/** The role in plain words. */
-export declare function slotWords(slot: Slot): string;
-export declare function rowAt(store: Store, scope: string, slot: Slot): Pair | null;
-/** Every value the editor shows for a scope: its own rows and, for a project, the installation rows it inherits, and
- * the alternates described in words. A change to any of them makes an open form stale. */
-export declare function stateDigest(store: Store, scope: string): string;
-/** The exact change a preview showed: its target and every set and clear, in slot order. */
-export declare function changeDigest(scope: string, change: readonly ModelChange[]): string;
-export type DiffRow = {
-    slot: Slot;
-    before: Pair | null;
-    after: Pair | null;
-};
-/** What a preview showed: the scope and every row's before → after. Bound into the apply, so a row that moved in
- * between, or a change the preview never showed, is refused. */
-export declare function diffDigest(scope: string, diff: readonly DiffRow[]): string;
-/** A preview read from ONE snapshot: the rows it moves, what a cleared project row would inherit, and both digests
- * the apply must match. */
-export declare function previewModelChange(store: Store, scope: string, change: readonly ModelChange[]): {
-    rows: (DiffRow & {
-        inherited: Pair | null;
-    })[];
-    state: string;
-    change: string;
-};
-/** The rows this change really moves (a set to the value already there is no change). */
-export declare function diffOf(store: Store, scope: string, change: readonly ModelChange[]): DiffRow[];
-export declare const OPUS = "claude-opus-5-5";
-export declare const SONNET = "claude-sonnet-5-5";
-export declare const HAIKU = "claude-haiku-5-5";
-export type PresetName = "sized" | "opus";
-export declare const PRESETS: Record<PresetName, {
-    label: string;
-    words: string;
-    rows: Record<string, string | null>;
-}>;
-export declare const DEFAULT_PRESET: PresetName;
-export declare const isPresetName: (value: string | null) => value is PresetName;
-/** A preset as a change: every slot, as exact Claude ids, never an alias. Repair rows are cleared so repairs follow
- * the builder of each size. */
-export declare function presetChange(name: PresetName): ModelChange[];
-/** The routes a task filed now would get at a scope, for every size and demand that picks a tier (inheritance,
- * review following the planner, and repair following each size's builder included), or the words for why none can. */
-export declare const ROUTE_CASES: readonly {
-    label: string;
-    size: "small" | "medium" | "large";
-    risky: boolean;
-    strict: boolean;
-}[];
-export declare function effectiveRoutes(store: Store, repo: string | null, options?: {
-    rules?: readonly EarnedRule[] | false;
-}): {
-    ok: true;
-    routes: {
-        label: string;
-        route: PhaseRoute;
-    }[];
-} | {
-    ok: false;
-    problem: string;
-};
-/** Which preset a scope's EFFECTIVE configuration matches (what each size would really run, inherited rows
- * included), or null ("a custom set"). */
-export declare function presetInUse(store: Store, scope: string): PresetName | null;
-/** "Switch to it": every row at this scope that names `from` names `to` instead. */
-export declare function switchChange(store: Store, scope: string, from: string, to: string): ModelChange[];
-/** For each exact Claude id this scope uses, the newest model of its family the watch has seen, when that is newer. */
-export declare function newerModels(store: Store, scope: string): {
-    from: string;
-    to: SeenModel;
-    slots: Slot[];
-}[];
-/** Who is acting, proved by the caller's own step-up, and re-proved here inside the transaction: the same account,
- * still active, still an unrestricted instance operator, at the credential generation the proof was made under, on a
- * session (or local CLI login) that is still live. */
-export type ModelAuthority = {
-    actor: string;
-    /** The credential generation the proof was checked against (read before the proof, never after). */
-    generation: number;
-    /** How the person proved it (scope.ts AuthMethod): a Passwordless session or remembered CLI login stands only while
-     * Passwordless is still on, and is re-checked here. */
-    method: string;
-    live: () => boolean;
-};
-export type ApplyInput = {
-    scope: string;
-    change: readonly ModelChange[];
-    /** The state a page showed, and (for a preview) the exact change it showed; null on the command line, which shows
-     * nothing before it writes. */
-    expected: {
-        state: string;
-        change?: string;
-    } | null;
-    /** The console: exact ids only. The CLI may also name a floating name, or a routine row with no model. The
-     * resulting configuration is checked the same way for both. */
-    strict: boolean;
-    knownProject: (repo: string) => boolean;
-    /** The command line's other rows, under the same proof, target and result checks: another provider's candidate on
-     * a tier (`--also`), and removing a light planner left from before light became build-only. */
-    extra?: readonly ExtraWrite[];
-};
-export type ExtraWrite = {
-    kind: "also-set";
-    phase: "plan" | "build";
-    tier: SlotTier;
-    provider: string;
-    model: string;
-} | {
-    kind: "also-clear";
-    phase: "plan" | "build";
-    tier: SlotTier;
-    provider: string | null;
-} | {
-    kind: "legacy-light-clear";
-    phase: SlotPhase;
-};
-export type ApplyRefusal = {
-    ok: false;
-    reason: "authority" | "unknown-project" | "stale" | "invalid";
-    problem: string;
-};
-export type ApplyResult = {
-    ok: true;
-    diff: DiffRow[];
-    unresolved: string | null;
-    extra: number;
-} | ApplyRefusal;
-export type ScopeCheck = {
-    kind: "ok";
-} | {
-    kind: "incomplete" | "invalid";
-    problem: string;
-};
-/**
- * Whether tasks can be filed at a scope with its resulting configuration. INCOMPLETE: a role has no exact model yet
- * (setup in progress; saved, and said). INVALID: something set can't run: an unknown provider, an ineligible reviewer,
- * or a route of any size or demand (small, routine, large, risky, strict) whose repair can't resume its builder,
- * inherited rows included. An invalid result is never saved.
- */
-export declare function checkScope(store: Store, repo: string | null, options?: {
-    rules?: readonly EarnedRule[];
-}): ScopeCheck;
-/** A resolver's words for a browser: what is wrong, never a terminal command to fix it. */
-export declare function browserWords(problem: string): string;
-/** The problem alone, or null when tasks can be filed. */
-export declare function scopeProblem(store: Store, repo: string | null): string | null;
-/**
- * Apply one change in ONE transaction: re-prove the actor, check the target and that nothing moved since the person
- * looked, check every row, write every set and clear, check the resulting configuration (no scope it reaches, the
- * target or a project inheriting from it, may stop resolving), and ledger before → after for each row. Any refusal
- * rolls everything back: a preset that fails on its last row writes nothing.
- */
-export declare function applyModelChoices(store: Store, input: ApplyInput, authority: ModelAuthority, now: Date): ApplyResult;
-export type RecentRun = {
-    runId: number;
-    taskId: string;
-    role: string;
-    chosen: string | null;
-    ranOn: string | null;
-    at: string;
-};
-/** The latest runs' floating or exact choice next to the model their provider reported: no verdict. */
-export declare function recentRuns(store: Store, limit?: number): RecentRun[];
-/** Codex's exact ids for its "Sized by job" preset: the frontier model plans, reviews and builds large or risky
- * work, the workhorse builds routine work, the small model builds small work (the ids Codex lists as of 2026-11). */
-export declare const CODEX_FRONTIER = "gpt-6-astra";
-export declare const CODEX_WORKHORSE = "gpt-6-sol";
-export declare const CODEX_SMALL = "gpt-6-luna";
-/** The agents a first choice can name ("Use this one", the lead chosen at a first start). */
-export type DefaultAgent = "claude" | "codex";
-/** Each agent's default preset: what a new installation runs on once that agent is chosen and nothing is set yet. */
-export declare const AGENT_PRESETS: Readonly<Record<DefaultAgent, {
-    label: string;
-    words: string;
-    rows: Record<string, string | null>;
-}>>;
-/** An agent's default preset as a change: every slot, exact ids, repairs following each size's builder. */
-export declare function agentPresetChange(agent: DefaultAgent): ModelChange[];
-/** The chat provider a lead runs on, as the agent whose preset it brings; null for a direct API. */
-export declare function defaultAgentOf(provider: string): DefaultAgent | null;
-/**
- * Who may fill: the local owner choosing its agent now (a browser's "Use this one", act `choose-default-agent`, still
- * standing, re-checked here), or a laptop install's own first start choosing the agent signed in on this computer
- * (local mode on). Nothing else: every other change of models is Settings → Models'
- * operator step-up (applyModelChoices).
- */
-export type DefaultRoutingDoor = {
-    kind: "local-owner";
-} | {
-    kind: "first-start";
-};
-export type DefaultRoutingResult = {
-    filled: true;
-    rows: number;
-} | {
-    filled: false;
-    reason: "authority" | "already-set" | "invalid";
-    problem: string;
-};
-/**
- * A new installation's first routing: the chosen agent's default preset, written only while NOTHING is set — no role
- * row, tier row or other-provider candidate at the installation or any project — so it never overwrites a choice.
- * Checked and written in one transaction (the caller's, when it has one: the lead's own write rides with it), each row
- * ledgered, the result checked like any apply; a refusal writes nothing.
- */
-export declare function fillDefaultRouting(store: Store, agent: DefaultAgent, actor: string, door: DefaultRoutingDoor, now: Date): DefaultRoutingResult;

package/dist/model-names.d.ts

@@ -1,6 +0,0 @@
-/** The display name for a model id: "claude-opus-5-5" → "Claude Opus 5.5", "opus" → "Claude Opus"; an id it doesn't
- * know stays the id. `null`, empty or "default": the provider's own default. */
-export declare function modelName(provider: string | null, id: string | null): string;
-/** The agent and its model in one phrase: "Claude Opus 5.5", "Codex · gpt-5.5", or the agent alone when no model is
- * pinned. A model name that already says its agent isn't said twice. */
-export declare function agentModelName(provider: string, id: string | null): string;

package/dist/models-cli.d.ts

@@ -1,307 +0,0 @@
-import { type CatalogSeams } from "./model-catalog.js";
-import type { Store } from "./store.js";
-export declare const MODELS_DESCRIPTORS: readonly [{
-    readonly action: "status";
-    readonly synopsis: "installed CLI versions, available updates, new models and the automatic check";
-    readonly mutation: "none";
-    readonly takesQuery: false;
-    readonly flags: readonly [{
-        readonly name: "provider";
-        readonly takesValue: true;
-        readonly meaning: "claude, codex, gemini or openrouter, for models list";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "list";
-    readonly synopsis: "models a provider can run, newest first, with prices (--provider claude|codex|gemini|openrouter)";
-    readonly mutation: "none";
-    readonly takesQuery: false;
-    readonly flags: readonly [{
-        readonly name: "provider";
-        readonly takesValue: true;
-        readonly meaning: "claude, codex, gemini or openrouter, for models list";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "check";
-    readonly synopsis: "fetch the public model lists and check CLI versions now";
-    readonly mutation: "unkeyed";
-    readonly takesQuery: false;
-    readonly flags: readonly [{
-        readonly name: "provider";
-        readonly takesValue: true;
-        readonly meaning: "claude, codex, gemini or openrouter, for models list";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "update";
-    readonly synopsis: "update one CLI while no work is running: models update claude|codex|gemini";
-    readonly mutation: "unkeyed";
-    readonly takesQuery: true;
-    readonly flags: readonly [{
-        readonly name: "provider";
-        readonly takesValue: true;
-        readonly meaning: "claude, codex, gemini or openrouter, for models list";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "watch";
-    readonly synopsis: "turn the 6-hourly check and its messages on or off: models watch on|off";
-    readonly mutation: "unkeyed";
-    readonly takesQuery: true;
-    readonly flags: readonly [{
-        readonly name: "provider";
-        readonly takesValue: true;
-        readonly meaning: "claude, codex, gemini or openrouter, for models list";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "results";
-    readonly synopsis: "each finished task's result record: which model built it, and whether it counts";
-    readonly mutation: "none";
-    readonly takesQuery: false;
-    readonly flags: readonly [{
-        readonly name: "repo";
-        readonly takesValue: true;
-        readonly meaning: "one project's records (default: every project you can open)";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "suggestions";
-    readonly synopsis: "cheaper models a project's own results suggest, and its earned rules";
-    readonly mutation: "none";
-    readonly takesQuery: false;
-    readonly flags: readonly [{
-        readonly name: "repo";
-        readonly takesValue: true;
-        readonly meaning: "one project's records (default: every project you can open)";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "accept";
-    readonly synopsis: "accept a suggestion as an earned rule, with its switch-back terms: models accept <id> --repo <p>";
-    readonly mutation: "unkeyed";
-    readonly takesQuery: true;
-    readonly positional: "the suggestion's id, as models suggestions lists it";
-    readonly flags: readonly [{
-        readonly name: "repo";
-        readonly takesValue: true;
-        readonly meaning: "the project (default: the one project you can open)";
-    }, {
-        readonly name: "as";
-        readonly takesValue: true;
-        readonly meaning: "your approver name";
-    }, {
-        readonly name: "token";
-        readonly takesValue: true;
-        readonly meaning: "your password (accepting and keeping take one typed now)";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "dismiss";
-    readonly synopsis: "Not now: keep a suggestion quiet for 30 days: models dismiss <id> --repo <p>";
-    readonly mutation: "unkeyed";
-    readonly takesQuery: true;
-    readonly positional: "the suggestion's id, as models suggestions lists it";
-    readonly flags: readonly [{
-        readonly name: "repo";
-        readonly takesValue: true;
-        readonly meaning: "the project (default: the one project you can open)";
-    }, {
-        readonly name: "as";
-        readonly takesValue: true;
-        readonly meaning: "your approver name";
-    }, {
-        readonly name: "token";
-        readonly takesValue: true;
-        readonly meaning: "your password (accepting and keeping take one typed now)";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "turn-off";
-    readonly synopsis: "turn an earned rule off, or drop a paused one: models turn-off <rule>";
-    readonly mutation: "unkeyed";
-    readonly takesQuery: true;
-    readonly positional: "the rule's number, as models suggestions lists it";
-    readonly flags: readonly [{
-        readonly name: "repo";
-        readonly takesValue: true;
-        readonly meaning: "the project (default: the one project you can open)";
-    }, {
-        readonly name: "as";
-        readonly takesValue: true;
-        readonly meaning: "your approver name";
-    }, {
-        readonly name: "token";
-        readonly takesValue: true;
-        readonly meaning: "your password (accepting and keeping take one typed now)";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "keep";
-    readonly synopsis: "keep a paused earned rule: models keep <rule>";
-    readonly mutation: "unkeyed";
-    readonly takesQuery: true;
-    readonly positional: "the rule's number, as models suggestions lists it";
-    readonly flags: readonly [{
-        readonly name: "repo";
-        readonly takesValue: true;
-        readonly meaning: "the project (default: the one project you can open)";
-    }, {
-        readonly name: "as";
-        readonly takesValue: true;
-        readonly meaning: "your approver name";
-    }, {
-        readonly name: "token";
-        readonly takesValue: true;
-        readonly meaning: "your password (accepting and keeping take one typed now)";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "try";
-    readonly synopsis: "try a cheaper model on the next 10 small or routine tasks, each approved by a person: models try <id> --repo <p>";
-    readonly mutation: "unkeyed";
-    readonly takesQuery: true;
-    readonly positional: "the trial offer's id, as models suggestions lists it";
-    readonly flags: readonly [{
-        readonly name: "repo";
-        readonly takesValue: true;
-        readonly meaning: "the project (default: the one project you can open)";
-    }, {
-        readonly name: "as";
-        readonly takesValue: true;
-        readonly meaning: "your approver name";
-    }, {
-        readonly name: "token";
-        readonly takesValue: true;
-        readonly meaning: "your password (accepting and keeping take one typed now)";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}, {
-    readonly action: "stop";
-    readonly synopsis: "stop a trial; tasks already approved on it keep their model: models stop <trial>";
-    readonly mutation: "unkeyed";
-    readonly takesQuery: true;
-    readonly positional: "the trial's number, as models suggestions lists it";
-    readonly flags: readonly [{
-        readonly name: "repo";
-        readonly takesValue: true;
-        readonly meaning: "the project (default: the one project you can open)";
-    }, {
-        readonly name: "as";
-        readonly takesValue: true;
-        readonly meaning: "your approver name";
-    }, {
-        readonly name: "token";
-        readonly takesValue: true;
-        readonly meaning: "your password (accepting and keeping take one typed now)";
-    }, {
-        readonly name: "json";
-        readonly takesValue: false;
-        readonly meaning: "versioned structured response";
-    }, {
-        readonly name: "db";
-        readonly takesValue: true;
-        readonly meaning: "local Toolroll database";
-    }];
-}];
-/** `proof`: the person who proved themselves for this command — at the credential generation read before the proof,
- * and how — or null. The rule doors re-prove it inside their own transaction. */
-export type ModelsCliContext = {
-    store: Store;
-    write: (line: string) => void;
-    json: boolean;
-    now: Date;
-    actor: string | null;
-    seams?: CatalogSeams;
-    proof?: {
-        actor: string;
-        generation: number;
-        method: string;
-    } | null;
-};
-export declare function runModelsCommand(positional: readonly string[], options: Map<string, string | true>, context: ModelsCliContext): Promise<number>;