toolroll 0.9.104 → 0.9.105

package/dist/flows-cli.d.ts

@@ -1,358 +0,0 @@
-import { type FetchLike } from './flow-share.js';
-import { type TriggerIo } from './flow-triggers.js';
-import type { Store } from './store.js';
-export declare const FLOWS_DESCRIPTORS: readonly [{
-    readonly action: 'list';
-    readonly synopsis: 'list flows: id, name, project, zones, triggers and cards waiting';
-    readonly mutation: 'none';
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }];
-}, {
-    readonly action: 'show';
-    readonly synopsis: 'one flow: zones with their next and failure paths, triggers and recent cards';
-    readonly mutation: 'none';
-    readonly positionals: readonly ['flow'];
-    readonly flags: {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[];
-}, {
-    readonly action: 'create';
-    readonly synopsis: 'create a flow from --template <id> (a template or starter flow) or --steps <file|->; previews until --yes';
-    readonly mutation: 'unkeyed';
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }, {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }, {
-        readonly name: 'name';
-        readonly takesValue: true;
-        readonly meaning: "the flow's name (a template's label when left out)";
-    }, {
-        readonly name: 'template';
-        readonly takesValue: true;
-        readonly meaning: `one of ${string}`;
-    }, {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }];
-}, {
-    readonly action: 'edit';
-    readonly synopsis: "replace a flow's steps (kept steps by id) and optionally rename it; previews until --yes";
-    readonly mutation: 'unkeyed';
-    readonly positionals: readonly ['flow'];
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }, {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }, {
-        readonly name: 'name';
-        readonly takesValue: true;
-        readonly meaning: 'a new name';
-    }];
-}, {
-    readonly action: 'trigger add';
-    readonly synopsis: 'add a trigger from JSON or a JSON file (any kind: button, schedule, github, linear, flow, webhook, email, chat); previews until --yes';
-    readonly mutation: 'unkeyed';
-    readonly positionals: readonly ['flow', 'trigger'];
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }];
-}, {
-    readonly action: 'trigger pause';
-    readonly synopsis: 'pause a trigger';
-    readonly mutation: 'identity-idempotent';
-    readonly positionals: readonly ['flow', 'trigger'];
-    readonly flags: {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[];
-}, {
-    readonly action: 'trigger resume';
-    readonly synopsis: 'turn a paused trigger on again';
-    readonly mutation: 'identity-idempotent';
-    readonly positionals: readonly ['flow', 'trigger'];
-    readonly flags: {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[];
-}, {
-    readonly action: 'trigger remove';
-    readonly synopsis: 'remove a trigger; cards it added stay';
-    readonly mutation: 'identity-idempotent';
-    readonly positionals: readonly ['flow', 'trigger'];
-    readonly flags: {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[];
-}, {
-    readonly action: 'trigger check';
-    readonly synopsis: 'run a checked trigger (or a schedule\'s script) now, like Check now';
-    readonly mutation: 'unkeyed';
-    readonly positionals: readonly ['flow', 'trigger'];
-    readonly flags: {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[];
-}, {
-    readonly action: 'script save';
-    readonly synopsis: "save a project script (a new version when it exists)";
-    readonly mutation: 'identity-idempotent';
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }, {
-        readonly name: 'name';
-        readonly takesValue: true;
-        readonly meaning: 'lowercase letters, numbers and dashes';
-    }, {
-        readonly name: 'file';
-        readonly takesValue: true;
-        readonly meaning: 'run this path in the project';
-    }, {
-        readonly name: 'body';
-        readonly takesValue: true;
-        readonly meaning: 'a local file holding the script itself';
-    }, {
-        readonly name: 'about';
-        readonly takesValue: true;
-        readonly meaning: 'one line: what it checks or does';
-    }, {
-        readonly name: 'language';
-        readonly takesValue: true;
-        readonly meaning: 'shell (default), python or node';
-    }, {
-        readonly name: 'timeout-minutes';
-        readonly takesValue: true;
-        readonly meaning: '1 to 60 (default 15)';
-    }];
-}, {
-    readonly action: 'card add';
-    readonly synopsis: 'add a card, in the first zone unless --zone names one';
-    readonly mutation: 'unkeyed';
-    readonly positionals: readonly ['flow'];
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        readonly name: 'title';
-        readonly takesValue: true;
-        readonly meaning: "the card's title";
-    }, {
-        readonly name: 'description';
-        readonly takesValue: true;
-        readonly meaning: 'its details';
-    }, {
-        readonly name: 'zone';
-        readonly takesValue: true;
-        readonly meaning: 'a zone id or name';
-    }];
-}, {
-    readonly action: 'card approve';
-    readonly synopsis: "approve a card waiting at a Person decides step (or pick --option at a Person chooses step), as the console's Approve does";
-    readonly mutation: 'identity-idempotent';
-    readonly positionals: readonly ['flow', 'card'];
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        readonly name: 'option';
-        readonly takesValue: true;
-        readonly meaning: "at a Person chooses step: the option's words or its number";
-    }];
-}, {
-    readonly action: 'card send-back';
-    readonly synopsis: "send a waiting card back with a note, as the console's Send back (or a reply at a Person chooses step) does";
-    readonly mutation: 'identity-idempotent';
-    readonly positionals: readonly ['flow', 'card'];
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        readonly name: 'note';
-        readonly takesValue: true;
-        readonly meaning: 'what should change';
-    }];
-}, {
-    readonly action: 'export';
-    readonly synopsis: 'write a flow as a *.toolroll-flow.json file: zones, paths, trigger settings and scripts; never secrets, webhook addresses, names or cards';
-    readonly mutation: 'none';
-    readonly positionals: readonly ['flow'];
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        readonly name: 'out';
-        readonly takesValue: true;
-        readonly meaning: 'write the file here (default: print it)';
-    }];
-}, {
-    readonly action: 'import';
-    readonly synopsis: 'make a flow from a flow file or a gist/GitHub https address; previews in plain words until --yes; triggers arrive off and scripts wait for approval';
-    readonly mutation: 'unkeyed';
-    readonly positionals: readonly ['file'];
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }, {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }, {
-        readonly name: 'param';
-        readonly takesValue: true;
-        readonly meaning: 'a value the file asks for, as name=value (repeat for more)';
-    }];
-}, {
-    readonly action: 'script approve';
-    readonly synopsis: 'approve a script an imported flow brought, so it runs';
-    readonly mutation: 'identity-idempotent';
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }, {
-        readonly name: 'name';
-        readonly takesValue: true;
-        readonly meaning: "the script's name";
-    }];
-}, {
-    readonly action: 'unattended';
-    readonly synopsis: "let a flow's own schedule run without approving each card (on: the owner signs, 1 to 7 days; off: any approver revokes)";
-    readonly mutation: 'identity-idempotent';
-    readonly audience: 'operator';
-    readonly positionals: readonly ['flow', 'on|off'];
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        readonly name: 'days';
-        readonly takesValue: true;
-        readonly meaning: "how long it lasts: 1 to 7 days (default 1)";
-    }, {
-        readonly name: 'budget';
-        readonly takesValue: true;
-        readonly meaning: 'optional dollar cap per attempt, like 5 or 2.50';
-    }, {
-        readonly name: 'runs';
-        readonly takesValue: true;
-        readonly meaning: "optional limit on runs a day (UTC), 1 to 50";
-    }, {
-        readonly name: 'include';
-        readonly takesValue: true;
-        readonly meaning: 'also cover these script or plane-review schedules (trigger ids, like 12,14); plain schedules are covered already';
-    }];
-}, {
-    readonly action: 'browser';
-    readonly synopsis: "let a flow's script zones marked browser: true start Chromium in their sandbox (on: a person approves with their own password, previews until --yes; off: any approver revokes)";
-    readonly mutation: 'identity-idempotent';
-    readonly audience: 'operator';
-    readonly positionals: readonly ['flow', 'on|off'];
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }, {
-        readonly name: 'digest';
-        readonly takesValue: true;
-        readonly meaning: "required with --yes: the approval digest the preview showed; refuses if the flow or its scripts changed since";
-    }];
-}, {
-    readonly action: 'archive';
-    readonly synopsis: 'archive a flow: its cards stop moving and its triggers stop; previews until --yes';
-    readonly mutation: 'identity-idempotent';
-    readonly positionals: readonly ['flow'];
-    readonly flags: readonly [...{
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }[], {
-        name: string;
-        takesValue: boolean;
-        meaning: string;
-    }];
-}];
-/** `--file` is a value here (a path in the project), where elsewhere it is a switch; so are unattended's `--budget`, `--runs` and `--include`. */
-export declare const FLOWS_VALUE_FLAGS: ReadonlySet<string>;
-export type FlowsCliContext = {
-    store: Store;
-    write: (line: string) => void;
-    json: boolean;
-    clock: () => Date;
-    /** --as/--token, or the remembered login; null when neither. */
-    credentials: {
-        name: string;
-        token: string;
-    } | null;
-    /** Every project the installation knows (enrolled, opened or worked on). */
-    projects: readonly string[];
-    /** Beside the database: webhook secrets, the hooks address. */
-    configDir: string;
-    evidenceRoot: string;
-    triggerIo: TriggerIo;
-    /** Reads a file, or stdin for "-". */
-    readInput?: (path: string) => string;
-    /** Fetches a flow file's address (tests stand in for the network). */
-    fetchFlow?: FetchLike;
-};
-type Flags = Map<string, string | true>;
-export declare function runFlowsCommand(positional: readonly string[], flags: Flags, context: FlowsCliContext): Promise<number>;
-export {};

package/dist/flows-ui.d.ts

@@ -1,70 +0,0 @@
-import type { BrowserFlowView } from "./browser-workspace.js";
-import { type FlowStage } from "./flows.js";
-import type { FlowCardRow, FlowRow, Store, SubagentQuestionRow } from "./store.js";
-import { type FlowFile, type FlowImportPlan } from "./flow-share.js";
-import { type Html } from "./html.js";
-/** The flow page's fallback rules, plus the Flows list and the import preview (kit pieces; only layout here). */
-export declare const FLOWS_CSS: string;
-/**
- * Flows: the top bar (a project filter, More, New flow), then each flow as a quiet row under Needs you, Running,
- * Turned on and Paused. Words come only from what the store knows now: cards waiting on a decision, cards in
- * progress, and the triggers (on, paused, when they last looked and what they found).
- */
-export declare function flowsListHtml(store: Store, flows: readonly FlowRow[], projects: readonly string[], canCreate: boolean, problem: string | null, filter?: string | null, now?: Date): Html;
-/** Reads the chosen flow file into the form (the server reads it again, whole, before anything is made), and sends a
- * filter select's form when it changes. */
-export declare const FLOW_IMPORT_SCRIPT = "(function(){document.querySelectorAll('select[data-k-autosubmit]').forEach(function(s){s.addEventListener('change',function(){if(s.form)s.form.requestSubmit();});});var form=document.querySelector('[data-flow-import]');if(!form)return;var input=form.querySelector('[data-flow-file]'),text=form.querySelector('[data-flow-document]'),note=form.querySelector('[data-flow-file-note]'),named=form.querySelector('[data-flow-file-name]'),address=form.querySelector('[name=url]');function say(words){note.textContent=words;note.hidden=words==='';}var reading=null;input.addEventListener('change',function(){text.value='';say('');var file=input.files&&input.files[0];if(named)named.textContent=file?file.name:'No file chosen';if(!file){reading=null;return;}if(file.size>262144){say('That file is too big: a flow file is at most 256 KB.');input.value='';if(named)named.textContent='No file chosen';reading=null;return;}reading=file.text().then(function(value){text.value=value;});});form.addEventListener('submit',function(event){if(reading!==null&&text.value===''){event.preventDefault();reading.then(function(){form.requestSubmit();});return;}if(text.value===''&&address.value.trim()===''){event.preventDefault();say('Choose a flow file or give its address.');}});})();";
-/** An import's preview, a reading page: the plan in plain words, what it asks for, and one Import button after the terms. */
-export declare function flowImportHtml(input: {
-    plan: FlowImportPlan | null;
-    file: FlowFile;
-    document: string;
-    repo: string;
-    csrf: string;
-    values: Record<string, string>;
-    previewed: string;
-    problem: string | null;
-}): Html;
-/** Why a card waits on this person now (docs/plans/home-other-asks.md part 4, v2.3): the one rule the flow page's
- * Decide and Home's Flow decisions both read, so they never disagree. Each needs approver standing:
- * - `decide`: an approval zone it is theirs to decide (the zone's decider, the flow's owner for "to owner", any approver
- *   when none is named), and no subagent of the zone deciding it first;
- * - `choose`: a "Person chooses" zone waiting on them (flow-send.ts flowChoiceAt);
- * - `answer`: its subagent's open question or tool-call request asked of them;
- * - `browser`: a check zone waiting for browser use, which only an approver with every project may allow;
- * - `reply`: a reply wait that ran out with nowhere to go, asking the card's owner (else the flow's) to move it on.
- * `reads` passes what the caller already read (a missing key is read here). */
-export type FlowCardWait = {
-    decide: boolean;
-    choose: boolean;
-    answer: boolean;
-    browser: boolean;
-    reply: boolean;
-};
-export declare function flowCardWaitsOn(store: Store, flow: FlowRow, card: FlowCardRow, viewer: {
-    name: string;
-    approver: boolean;
-}, reads?: {
-    stage?: FlowStage | undefined;
-    asked?: SubagentQuestionRow | null;
-    choosing?: {
-        person: string;
-    } | null;
-    browser?: {
-        status: string;
-    } | null;
-}): FlowCardWait;
-/** One flow's canvas for one person. */
-export declare function flowView(store: Store, flow: FlowRow, viewer: {
-    name: string;
-    approver: boolean;
-}, selectedCard: number | null, setup?: {
-    dir: string | null;
-    repos: readonly string[];
-    startTrigger?: number | null;
-    sortReady?: boolean;
-    toolHome?: string | undefined;
-    now?: Date;
-}): BrowserFlowView;
-/** The page the canvas replaces when scripts can't run: each zone and its cards, in order. */
-export declare function flowFallbackHtml(view: BrowserFlowView): Html;

package/dist/flows.d.ts

@@ -1,136 +0,0 @@
-import { type SourceLike } from "./task-source.js";
-import { type ContractIssue, type ContractResult } from "./contracts/contract.js";
-import { CHOICES_MAX, CHOICES_MIN, FLOW_COLORS, FLOW_END, FLOW_MERGE_METHODS, FLOW_STAGE_KINDS, LONGEST_WAIT_MINUTES, SCRIPT_LANGUAGES, SCRIPT_NAME, sortKeyOf, type FlowDefinition, type FlowStage, type FlowStageKind, type FlowStepFields, type FlowWait, type ScriptLanguage, type TriggerInput } from "./contracts/flow.js";
-export { CHOICES_MAX, CHOICES_MIN, FLOW_COLORS, FLOW_END, FLOW_MERGE_METHODS, FLOW_STAGE_KINDS, LONGEST_WAIT_MINUTES, SCRIPT_LANGUAGES, SCRIPT_NAME, sortKeyOf };
-export type { FlowChoice, FlowColor, FlowDefinition, FlowEmail, FlowLimit, FlowMergeMethod, FlowRequest, FlowSort, FlowSortAnswer, FlowSortNote, FlowStage, FlowStageKind, FlowStepInput, FlowTool, FlowWait, FlowZone, ScriptLanguage, } from "./contracts/flow.js";
-/** What each kind is called and does, in the words the canvas uses. */
-export declare const FLOW_KIND_WORDS: Record<FlowStageKind, {
-    label: string;
-    about: string;
-}>;
-export declare const LANGUAGE_WORDS: Record<ScriptLanguage, string>;
-/** The default for "sure enough to act alone". */
-export declare const SORT_SURE_AT = 0.8;
-/** "3 days", "4 hours", "90 minutes", "1 week" (or a number of minutes) as minutes; null when it isn't one. */
-export declare function durationMinutes(value: unknown): number | null;
-/** Minutes in the words people use: "3 days", "1 day 4 hours", "45 minutes". */
-export declare function durationWords(minutes: number): string;
-/** "22:00", "9:30" as "HH:MM"; null when it isn't a time of day. */
-export declare function clockTime(value: unknown): string | null;
-export declare function knownTimeZone(zone: string): boolean;
-/** Whether a time falls inside an "hours" wait (22:00–06:00 runs past midnight), in its time zone or this computer's. */
-export declare function withinHours(wait: Pick<FlowWait, "from" | "to" | "timeZone">, now: Date): boolean;
-/** Who decides at an approval zone: its named person, the flow's owner, or null for anyone who approves on the project. */
-export declare function deciderOf(stage: Pick<FlowStage, "approver" | "toOwner">, flow: {
-    owner: string;
-}): string | null;
-/** A flow refused by its contract: every problem, each naming its path (`stages[2].instructions: required`). */
-export declare class FlowContractError extends Error {
-    readonly lines: readonly string[];
-    constructor(lines: readonly string[]);
-}
-/** What JSON Schema can't say about a drawing, each named by its path: paths lead to zones that exist and never back into
- * their own zone, answers and options have names of their own, a web address's host is written out, tool arguments are a
- * JSON object, an hours wait's times differ in a real time zone, and a merge comes after a person's decision. */
-export declare function drawingProblems(definition: FlowDefinition): ContractIssue[];
-/**
- * Read a flow's drawing: the canvas's, a step list's once built, or one saved earlier (`stored`, which keeps working under
- * rules added since: its instructions keep the length they were saved with). A version 1 drawing is read as every release
- * has read it (canonicalStage), then the schema checks it, then drawingProblems; a newer version is refused plainly.
- */
-export declare function readFlowDefinition(input: unknown, options?: {
-    stored?: boolean;
-}): ContractResult<FlowDefinition>;
-/** A refusal of the drawing a step list or flow file became, in its words: `stages[2].sort.answers[0].to` is
- * `steps[2].answers[0].goesTo` (each zone is the step at its index), and a zone's failure path is the step's own name for it. */
-export declare function inStepWords(line: string, list: "steps" | "zones", kinds: readonly (string | undefined)[]): string;
-/** A flow as drawn on the canvas, checked whole (readFlowDefinition). Throws FlowContractError, naming every path. */
-export declare function validateFlowDefinition(input: unknown, options?: {
-    stored?: boolean;
-}): FlowDefinition;
-/** A drawing's refusal as the canvas shows it: each line as it is, after the name of the zone it is about, so a person
- * finds it on the canvas (`Build · stages[1].instructions: required`). */
-export declare function withZoneNames(lines: readonly string[], input: unknown): string;
-/** The instructions 0.9.26 and earlier read from a saved zone: they re-check this length on every read, and a flow with a
- * longer one won't load. A saved zone keeps its first part under it, and the rest in `instructionsMore`, which they ignore. */
-export declare const FLOW_INSTRUCTIONS_STORED = 4000;
-/** A flow's definition as the store saves it: any zone's instructions over FLOW_INSTRUCTIONS_STORED are split, so a
- * person who goes back a version still opens the flow (with its instructions' first part). Unchanged otherwise. */
-export declare function flowDefinitionForStore(json: string): string;
-/** A saved flow's definition with every zone's instructions whole again (flowDefinitionForStore). */
-export declare function flowDefinitionFromStore(json: string): string;
-/** The zones a card can reach from `start` without passing through a zone `stop` picks (those zones aren't included). */
-export declare function reachableWithout(stages: readonly FlowStage[], start: string, stop: (stage: FlowStage) => boolean): Set<string>;
-/** The zones a choose zone's options lead to (an option that ends the card leads to none). */
-export declare function choiceTargets(stage: Pick<FlowStage, "options">): string[];
-/** Where a reply to a choice goes, as its {{note}}: the zone's reply path, else its first option that leads somewhere; null when none does. */
-export declare function replyTarget(stage: Pick<FlowStage, "options" | "onFail">): string | null;
-/** What a card's work is held to: the zones' steps and paths, never where they sit on the canvas. */
-export declare function flowDigest(definition: FlowDefinition): string;
-/** `source` (v126): where the card came from, when an outside event's delivery made it ({{card.source}}). */
-type FlowFillCard = {
-    title: string;
-    description: string | null;
-    note: string | null;
-    outputs: Record<string, string>;
-    source?: SourceLike | null;
-};
-/** Fill a zone's text from the card: title, description, the latest note and earlier zones' reports. */
-export declare function fillFlowText(template: string, card: FlowFillCard, encode?: (value: string) => string): string;
-/** The task door's goal limit (task-text.ts). A work zone's goal is kept within it. */
-export declare const FLOW_GOAL_LIMIT: 8000;
-/** What stands in a goal for a filled-in value too long to hold whole: the agent is given it whole, attached (flowGoalCuts). */
-export declare const flowAttachedMark: (label: string) => string;
-/** A work zone's words, plus the card and any send-back note when the words leave them out. "Fix the bug on the card"
- * says nothing on its own (found in the real e2e: the builder saw only the branch name). */
-export declare function flowWorkTemplate(instructions: string, card: {
-    description: string | null;
-    note: string | null;
-    source?: SourceLike | null;
-}): string;
-/** How a filled-in value is named where it is attached: the same words flowGoalCuts labels it with. */
-export declare function flowValueLabel(key: string, stageTitle?: (id: string) => string): string;
-/** A work zone's goal, filled from the card and kept within `limit`: the zone's own words stay whole, and every filled-in
- * value goes in whole. When they don't all fit, the longest values are attached instead (each named in the goal by
- * flowAttachedMark, and given to the agent whole by flowGoalCuts) until the rest fits: nothing is cut. Words that fill
- * the limit to the last character leave attached values a shorter mark, then none (they are still attached). Null only
- * when the template's own words are over the limit: the caller then files the zone's words alone (flowGoal). */
-export declare function fitFlowText(template: string, card: FlowFillCard, limit?: 8000, stageTitle?: (id: string) => string): string | null;
-/** A work zone's goal for a card: its words, the card and any note, fitted (fitFlowText); when the zone's words leave no
- * room for the card's own lines, its words alone, with the card attached. Null only for words over the limit. */
-export declare function flowGoal(instructions: string, card: FlowFillCard, stageTitle?: (id: string) => string): string | null;
-/** The first email address a card mentions, or "" — what {{card.email}} holds. */
-export declare function cardEmailOf(card: {
-    title: string;
-    description: string | null;
-}): string;
-/** What a draft zone asks for when the steps leave it out. */
-export declare const DRAFT_DEFAULT = "Write a short, friendly reply to the person who sent this card, in plain words.";
-/** Steps as the lead's flow tool and `toolroll flows` take them: "me" as a decider is the person asking, stored by name. */
-export declare function stepsFor(steps: unknown, name: string): unknown;
-/** An edit's steps with what a kept step leaves out of its kind and name filled from the zone it keeps (by id), so each
- * reads as the one schema its kind has. Anything else it leaves out carries over when the flow is drawn (flowFromSteps). */
-export declare function withKeptSteps(steps: unknown, previous: FlowDefinition | null): unknown;
-/** A flow's steps, read by their one schema: `steps[0].routes[0]: unknown key 'to' (did you mean goesTo?)`. */
-export declare function readFlowSteps(input: unknown, previous?: FlowDefinition | null): ContractResult<FlowStepFields[]>;
-/**
- * A flow from an ordered list of steps: ids from names, each step leading
- * to the next, a Done zone at the end when none is listed, and a decision
- * sending work back to the nearest earlier step that does work. New zones
- * are laid out in rows; zones kept from `previous` keep their place. Throws
- * FlowContractError, each line naming the step's path (`steps[2].next: ...`).
- */
-export declare function flowFromSteps(input: unknown, previous?: FlowDefinition | null): FlowDefinition;
-/** What confirming a new or changed flow means, in the canvas's words: each step's job and path, what changed, and that the usual approvals still apply. */
-export declare function flowTerms(definition: FlowDefinition, previous: FlowDefinition | null): string[];
-/** The label an issue gets to become work: what the Issues to PRs template and the issue starter flow watch for. */
-export declare const ISSUE_LABEL = "toolroll";
-/** Ready-made flows: the coding flow is the whole business process around a change. A template's `trigger`
- * (a trigger's settings, as flow-triggers.ts reads them) is added with it. */
-export declare const FLOW_TEMPLATES: readonly {
-    id: string;
-    label: string;
-    about: string;
-    definition: FlowDefinition;
-    trigger?: TriggerInput;
-}[];

package/dist/folder-gate.d.ts

@@ -1,32 +0,0 @@
-/**
- * Whether the console may read a folder synchronously right now.
- *
- * The console answers every page on one thread, so one synchronous read of a folder that has stopped answering (a
- * drive that hangs, a folder macOS holds in iCloud) freezes the console with it: it listens and answers nothing, not
- * even /healthz (the 0.9.82 and 0.9.87 deploys). So the console's own work (its request handling and its background
- * pass, serve.ts) runs inside a folder scope: there, a synchronous read of a person's folder goes ahead only when that
- * folder answered an off-thread look lately (project-identity.ts `answering`), or it lies in the console's own data.
- * Otherwise the read isn't made and its caller refuses, says the folder is unavailable, or throws FolderUnavailable.
- *
- * Availability never decides authorization: a held-back canonicalization throws FolderUnavailable (project.ts), never
- * answers null, so no caller falls back to a path's spelling because a folder didn't answer.
- *
- * Work outside a console scope (the worker, even in the same process as the console; `up`; the CLI) reads as it
- * always did.
- */
-/** One console's answer for a resolved path. `pointer`: the path came from a file a build can write (a checkout's
- * `.git` or `commondir`), so the console's own folders (build checkouts among them) don't vouch for it by spelling. */
-export type FolderGate = (path: string, pointer: boolean) => boolean;
-/** What a caller says, and throws, when the gate holds a read back. */
-export declare const FOLDER_DIDNT_ANSWER = "the folder didn't answer";
-/** A synchronous read the console's folder gate held back: the folder is unavailable now, which is never a "no". */
-export declare class FolderUnavailable extends Error {
-    readonly path: string;
-    constructor(path: string);
-}
-/** Runs `work` (and everything it starts) inside the console's folder scope. */
-export declare function inFolderScope<T>(gate: FolderGate, work: () => T): T;
-/** Whether a synchronous read of `path` may happen now. Outside a console's folder scope: always. */
-export declare function folderAnswers(path: string, pointer?: boolean): boolean;
-/** `path` is `folder` or inside it (both resolved). */
-export declare function insideFolder(path: string, folder: string): boolean;