@stringsync/splates 0.0.45 → 0.0.46

package/dev-workers.d.ts

@@ -1,55 +0,0 @@
-import type { AsyncResource } from "webappwiz/disposable";
-import type { Logger } from "webappwiz/log";
-import type { Fs } from "webappwiz/system";
-import type { Connection } from "./dev-sockets.js";
-import type { RemoteWorker } from "./remote-worker.js";
-import { WorkerRegistry } from "./worker-registry.js";
-/** What the worker the supervisor starts beside the server is known by. */
-export declare const LOCAL_WORKER = "local";
-/** What `DevWorkers` answers workers as. */
-export interface DevWorkersOptions {
-    /**
-     * The session id every worker hears in its welcome: the same across
-     * restarts, so a worker keeps what it runs for the next run to take
-     * back; new by default, which ends what the worker held.
-     */
-    session?: string;
-}
-/**
- * Where `splates server` takes its workers in, as their coordinator: the local
- * worker through a Unix socket only this user may open, and others through
- * `/api/workers`. Nothing places work on them yet; the registry keeps them
- * for what comes next.
- */
-export declare class DevWorkers implements AsyncResource {
-    private readonly log;
-    readonly registry: WorkerRegistry;
-    /** This machine's worker, which agents run on; work waits for it to join. */
-    readonly local: RemoteWorker;
-    private listener;
-    /** Whether a worker may join: not while what the last run let go of is being taken back. */
-    private ready;
-    constructor(log: Logger, { session }?: DevWorkersOptions);
-    /**
-     * Turns workers away until `serving`, while the conversations the last
-     * run let go of take their processes back, since a worker's hello
-     * settles which channels live on.
-     */
-    takingBack(): void;
-    /** Lets workers join again. */
-    serving(): void;
-    /** Hangs up on every worker for a restart, keeping what each runs (see `WorkerRegistry.detach`). */
-    detach(): Promise<void>;
-    /**
-     * Listens at `path`, logging rather than failing when it cannot, as when
-     * another `splates server` with the same home already does: the page works
-     * without workers.
-     */
-    listen(path: string, fs: Fs): Promise<void>;
-    readonly open: (request: Request, server: Bun.Server<Connection>) => Response | undefined;
-    /** `GET /api/workers`: each worker and each refusal, as `splates worker list` shows them. */
-    readonly list: () => Promise<Response>;
-    /** A worker upgrades; anyone else is asking who has joined, and `guard` decides who may. */
-    readonly route: (request: Request, server: Bun.Server<Connection>, guard: (handle: (request: Request) => Promise<Response>) => (request: Request) => Promise<Response>) => Response | undefined | Promise<Response>;
-    disposeAsync(): Promise<void>;
-}

package/dev.d.ts

@@ -1,24 +0,0 @@
-import { type AsyncResource } from "webappwiz/disposable";
-import type { DevOptions } from "./dev-options.js";
-import { type DevMachine } from "./dev-project.js";
-export type { DevOptions } from "./dev-options.js";
-export { DEFAULT_PORT, devPorts, PORT_SPAN } from "./dev-ports.js";
-/**
- * Serves what `todo list`, `list` and `show` print as one page that refetches
- * when the repo changes, where a person adds, edits, reorders and removes
- * todos. Anything that moves a task (merge, claim) stays in the CLI, and
- * removing one answers only to this machine's own names, so a page that
- * should not have been reachable can at worst change a todo.
- *
- * Given `conversations`, the page also talks to agents, which run commands on
- * this machine. Those routes answer only to this machine's own names, or,
- * given `access`, to a host `hosts` lets in once Cloudflare Access verified
- * who is asking; without it, a tunnel still reaches no further than the todos.
- */
-export declare function dev(deps: DevMachine, { ports, hosts, access, tunnel, conversations: converse, shell, transcriber, newest, running, checkEvery, // how often to ask npm for a newer splates
-source, sourceEvery, // how often to read a checkout's last commit
-unbuilt, slot, servers, exit, sensors, heavy, workerSocket, workers: givenWorkers, worker, coordinator, portsHost, pusher, open, }?: DevOptions): Promise<DevServer>;
-/** A running server, and the one thing a caller ever wants to do with it. */
-export interface DevServer extends AsyncResource {
-    port: number;
-}

package/diff.d.ts

@@ -1,29 +0,0 @@
-/** A line of a diff, as assistant-ui's `CodeDiff` draws one. */
-export interface DiffLine {
-    kind: "context" | "added" | "removed";
-    text: string;
-}
-/** A run of changed lines and the context around them. */
-export interface Hunk {
-    /** Where it is, as git heads it: `@@ -10,6 +10,8 @@`. */
-    range: string;
-    lines: DiffLine[];
-}
-/** One file's changes. */
-export interface FileDiff {
-    path: string;
-    /** Where it was, for a file that moved; null otherwise. */
-    from: string | null;
-    status: "added" | "deleted" | "renamed" | "modified";
-    added: number;
-    removed: number;
-    /** Git says only that it differs, with no lines to show. */
-    binary: boolean;
-    /** Some of it is not committed yet. */
-    uncommitted: boolean;
-    hunks: Hunk[];
-}
-/** `git diff` output as files, hunks and lines. */
-export declare function parseDiff(text: string): FileDiff[];
-/** An edit as lines: what it took out, then what it put in. */
-export declare function editLines(old: string | null, now: string): DiffLine[];

package/dispatched.d.ts

@@ -1,16 +0,0 @@
-import type { Logger } from "webappwiz/log";
-import type { Conversations } from "./conversations.js";
-import type { WorktreeService } from "./worktree-service.js";
-/**
- * Starts the agent of each task `splates add --agent` or `splates handoff` handed
- * to one and that has none yet, in the task's tree, on the model asked for,
- * told to claim it, or to take it over for a handoff. The
- * conversation it starts goes on the record before the agent is told
- * anything, so a task is started once however often this runs, as long as
- * no two runs overlap. Answers once each is started, not told.
- */
-export declare function startDispatched({ service, conversations, log, }: {
-    service: WorktreeService;
-    conversations: Conversations;
-    log: Logger;
-}): Promise<void>;

package/editors.d.ts

@@ -1,22 +0,0 @@
-/**
- * The editors a file the page names opens in: the link the browser hands it,
- * and the command `dev` runs on this machine to open the file inside the
- * tree it belongs to, which a link cannot say.
- */
-export interface Editor {
-    id: string;
-    /** What the Settings dialog calls it. */
-    label: string;
-    /** The scheme of its `<scheme>://file/<path>:<line>` links. */
-    scheme: string;
-    /**
-     * The command that opens `tree` as its window and `file` in it, at `line`
-     * when there is one; the window alone when `file` is the tree.
-     */
-    argv(tree: string, file: string, line: number | null): string[];
-}
-export declare const ZED: Editor;
-/** Every editor, in the order the Settings dialog offers them. */
-export declare const EDITORS: readonly [Editor, Editor, Editor];
-/** The editor `id` names, or null for one this splates does not know. */
-export declare function editorOf(id: string): Editor | null;

package/escalate.d.ts

@@ -1,27 +0,0 @@
-import { type Logger } from "webappwiz/log";
-import type { Fs, Lock } from "webappwiz/system";
-import type { Facts } from "./events.js";
-import type { Git } from "./git.js";
-import type { WorktreeService } from "./worktree-service.js";
-export interface EscalateOptions {
-    /** Task to escalate. Defaults to the one `cwd` is a worktree for. */
-    task?: string;
-    /**
-     * Ask a person to approve merging, rather than to answer questions, with
-     * the reason as what to look at. Refused until the task is ready to merge:
-     * every question under `## Blocked` and step under `## Next` checked.
-     */
-    review?: boolean;
-}
-/**
- * The way out that is not "resolve the conflict badly to finish the task".
- * When both sides restructured the same logic there is no correct merge, only
- * a decision, and that belongs to a human.
- */
-export declare function escalate({ service, git, lock, log, fs, }: {
-    service: WorktreeService;
-    git: Git;
-    lock: Lock;
-    log: Logger;
-    fs: Fs;
-}, reason: string, cwd: string, { task, review }?: EscalateOptions): Promise<Facts["escalate"]>;

package/events.d.ts

@@ -1,311 +0,0 @@
-import type { Question } from "./plan.js";
-import type { FailedTest, RemoveReason } from "./worktree.js";
-/** An escalation that went through, which asks the person to act. */
-export type Escalated = Extract<Event, {
-    action: "escalate";
-    reason: null;
-}>;
-/** Whether `event` is an escalation that went through. */
-export declare function isEscalation(event: Event): event is Escalated;
-/**
- * What each action's event says beyond what every event does, keyed by the
- * action as `splates log` names it. An action with nothing of its own yet maps
- * to `None`: each slice of the Splates events lane fills in its command's.
- */
-export interface Facts {
-    add: {
-        /** The branch the task starts from and merges onto. */
-        base: string;
-        /** The todos it took, by id. */
-        todos: number[];
-        /** What `--goal` said done means, or null when the todos seed the Goal. */
-        goal: string | null;
-        /** The subjects of the todos it took, in order, which seed its Goal. */
-        subjects: string[];
-        /** The agent it was handed to, or null when this conversation keeps it. */
-        agent: string | null;
-        /** That agent's model, or null for its own default or no agent. */
-        model: string | null;
-    };
-    claim: {
-        /** Whether the task was escalated, so the claim ends a wait on the user. */
-        escalated: boolean;
-        /**
-         * Whether the agent claiming is the one the task was handed to with
-         * `splates handoff`, taking it over.
-         */
-        tookOver: boolean;
-        /** What its `SPLATES.md` says done means, as markdown, or "" for nothing yet. */
-        goal: string;
-    };
-    tell: {
-        /**
-         * The conversation it was said in, the agent the task was handed to. The
-         * sender is the event's own `conversation`. The page shows it as no line
-         * of its own: the receiving message says where it came from.
-         */
-        to: string;
-    };
-    /** A wait on a task, the event's own: see `Waiting`. */
-    wait: Waiting;
-    merge: {
-        /** The branch it landed on, or was refused landing on. */
-        base: string;
-        /** The commit the base reached, short. */
-        commit: string;
-        /**
-         * What it touched when it landed, or the files the rebase conflicted in
-         * when refused for a conflict. Empty when a refusal names none.
-         */
-        files: string[];
-        /** The merge attempts it has left. */
-        attemptsLeft: number;
-        /**
-         * The tests the gate named as failing when refused for `tests_failed`,
-         * with what each said, so the log shows which ones fail most and why.
-         * Empty when the runner named none.
-         */
-        failedTests: FailedTest[];
-    };
-    remove: {
-        /** The `--reason` it gave, or null when it gave none. */
-        why: RemoveReason | null;
-        /** The todos it put back on the list, by id and subject. */
-        released: {
-            id: number;
-            subject: string;
-        }[];
-    };
-    escalate: {
-        /** Why it needs the person, or for a review, what to look at. */
-        about: string;
-        /** Whether it asks the person to approve merging, not to answer. */
-        review: boolean;
-        /** Where it merges once done. */
-        base: string;
-        /**
-         * Its open questions under `## Blocked` as they stood, which the card
-         * asks: a report never follows the task afterwards.
-         */
-        questions: Question[];
-    };
-    handoff: {
-        /** The roster agent it went to, by its id. */
-        agent: string;
-        /** Its model, by the id the roster gives it, or null for the agent's own. */
-        model: string | null;
-        /** Whether the agent answers to the conversation that handed it on. */
-        relay: boolean;
-    };
-    attach: {
-        /** The paths it stored, in the order given. */
-        stored: string[];
-        /** What `--remove` named to drop, each by path or stored name. */
-        removed: string[];
-    };
-    "artifact add": {
-        /** The artifact, by name. */
-        name: string;
-        /** The version it made. */
-        version: number;
-        /** That version's size. */
-        bytes: number;
-    };
-    "artifact remove": {
-        /** The artifact, by name. */
-        name: string;
-        /** The version that was current. */
-        version: number;
-    };
-    retry: {
-        /** The merge attempts the task had spent, which the grant gives it more of. */
-        attempts: number;
-    };
-    "todo add": {
-        /** The todo it added, by id. */
-        todo: number;
-        /** Its line, as the page names it. */
-        subject: string;
-        /** The lane it went in, or null when it went in none. */
-        lane: number | null;
-        /** Where it went in the list, 1 at the top. */
-        position: number;
-    };
-    "todo update": {
-        /** The todo, by id. */
-        todo: number;
-        /** Its subject once updated, so a line names it though it was reworded. */
-        subject: string;
-        /** Only what moved: a key is absent when its part stayed as it was. */
-        changed: {
-            /** The new subject. */
-            subject?: string;
-            /** Whether its detail was rewritten. */
-            text?: true;
-            /** Where it moved to in the list, 1 at the top. */
-            position?: number;
-            /** The lane it moved to, null for none. */
-            lane?: number | null;
-            /** Todos it is now blocked by. */
-            blocked?: number[];
-            /** Todos that no longer block it. */
-            unblocked?: number[];
-            /** Names of the files attached. */
-            attached?: string[];
-            /** Names of the files dropped. */
-            detached?: string[];
-            /** The agent and model it now names, null once it names none. */
-            assignee?: {
-                agent: string;
-                model?: string;
-            } | null;
-        };
-    };
-    "todo take": TodosFacts;
-    "todo wait": Waiting & {
-        /** The todo, by id. */
-        todo: number;
-        /** Its subject as the wait began, or null for a todo there is no such thing as. */
-        subject: string | null;
-    };
-    "todo release": TodosFacts;
-    "todo remove": TodosFacts;
-    "lane add": {
-        /** The lane it started, by number. */
-        lane: number;
-        /** Its name. */
-        name: string;
-    };
-    "lane update": {
-        /** The lane, by number. */
-        lane: number;
-        /** Its name once updated, so a line names it though it was renamed. */
-        name: string;
-        /** Only what changed: a key is absent when it stayed as it was. */
-        changed: {
-            /** The new name. */
-            name?: string;
-            /** Where it moved to among the lanes, 1 the first column. */
-            position?: number;
-        };
-    };
-    "lane remove": {
-        /** The lane, by the number it had. */
-        lane: number;
-        /** Its name. */
-        name: string;
-        /** The todos it held, now in no lane. */
-        todos: number[];
-    };
-    "lane join": None;
-    "creds request": {
-        /** The cred asked for, as its environment variable. */
-        name: string;
-        /** Whether it asked, rather than finding the cred already kept. */
-        asked: boolean;
-    };
-    "creds save": None;
-    "creds remove": None;
-    "creds dismiss": None;
-    "creds wait": Waiting & {
-        /** The cred waited for, by name. */
-        name: string;
-    };
-    "tunnel setup": None;
-    "tunnel remove": None;
-}
-type None = Record<never, never>;
-/**
- * A wait the page counts down: its start shows a line that runs until `until`,
- * and its end says how the wait went, pointing back at its start with `began`.
- */
-export interface Waiting {
-    /** When it gives up, as an ISO time. */
-    until: string;
-    /** The id of the event it began with, on the one it ends with; null on that first. */
-    began: string | null;
-}
-/** The todos a command took, released or removed, as they were named then. */
-interface TodosFacts {
-    todos: {
-        id: number;
-        subject: string;
-    }[];
-}
-export type Action = keyof Facts;
-/**
- * Each action's facts by name, as its event records them now: the journal
- * reads an event only when it carries all of them, and none of an action
- * missing here.
- */
-export declare const FACTS: {
-    readonly add: readonly ["base", "todos", "goal", "subjects", "agent", "model"];
-    readonly claim: readonly ["escalated", "tookOver", "goal"];
-    readonly tell: readonly ["to"];
-    readonly wait: readonly ["until", "began"];
-    readonly merge: readonly ["base", "commit", "files", "attemptsLeft", "failedTests"];
-    readonly remove: readonly ["why", "released"];
-    readonly escalate: readonly ["about", "review", "base", "questions"];
-    readonly handoff: readonly ["agent", "model", "relay"];
-    readonly attach: readonly ["stored", "removed"];
-    readonly "artifact add": readonly ["name", "version", "bytes"];
-    readonly "artifact remove": readonly ["name", "version"];
-    readonly retry: readonly ["attempts"];
-    readonly "todo add": readonly ["todo", "subject", "lane", "position"];
-    readonly "todo update": readonly ["todo", "subject", "changed"];
-    readonly "todo take": readonly ["todos"];
-    readonly "todo wait": readonly ["until", "began", "todo", "subject"];
-    readonly "todo release": readonly ["todos"];
-    readonly "todo remove": readonly ["todos"];
-    readonly "lane add": readonly ["lane", "name"];
-    readonly "lane update": readonly ["lane", "name", "changed"];
-    readonly "lane remove": readonly ["lane", "name", "todos"];
-    readonly "lane join": readonly [];
-    readonly "creds request": readonly ["name", "asked"];
-    readonly "creds save": readonly [];
-    readonly "creds remove": readonly [];
-    readonly "creds dismiss": readonly [];
-    readonly "creds wait": readonly ["until", "began", "name"];
-    readonly "tunnel setup": readonly [];
-    readonly "tunnel remove": readonly [];
-};
-/**
- * Whether `event` carries every fact its action records now. One that went
- * through before its action recorded them all does not, and nor does one
- * logged by a newer splates for an action this one does not know.
- */
-export declare function isCurrent(event: Event): boolean;
-/** What every event carries, whatever its action. */
-interface Common<A extends Action> {
-    /** Its own, so a reader following the log takes each event once. */
-    id: string;
-    at: string;
-    action: A;
-    /** The task it was about, or null when the command names none. */
-    task: string | null;
-    /** The refusal reason, or null when the command succeeded. */
-    reason: string | null;
-    /**
-     * The `splates server` conversation that ran it, so the page can show it there,
-     * or null for an external agent or the page itself.
-     */
-    conversation: string | null;
-}
-/**
- * One thing that was done, and how it went. A refused command carries only
- * the facts it was asked with, since it never got to learn the rest.
- */
-export type Event = {
-    [A in Action]: (Common<A> & {
-        reason: null;
-    } & Facts[A]) | (Common<A> & {
-        reason: string;
-    } & Partial<Facts[A]>);
-}[Action];
-/**
- * What `ctx.journal.record` takes for an action's facts: a value, for what the
- * command was asked with, kept even when it is refused, or a function of what
- * it returned, kept only on success. An action with no facts takes none.
- */
-export type FactsOf<A extends Action, T> = keyof Facts[A] extends never ? [] : [facts: Facts[A] | ((out: T) => Facts[A])];
-export {};

package/everywhere.d.ts

@@ -1,41 +0,0 @@
-import type { Conversation, Conversations } from "./conversations.js";
-import type { Served } from "./dev-project.js";
-import type { Projects } from "./projects.js";
-/**
- * The conversations of every project `splates server` serves, so a conversation
- * that handed out a task in another project than its own hears of, and
- * answers for, the agent it handed it to, as it would one in its own.
- */
-export declare class Everywhere {
-    private readonly placing;
-    /** Only the conversations of the project at `root`, as a server of one has them. */
-    static onlyHere(root: string, conversations: Conversations): Everywhere;
-    /**
-     * The conversations of each project in `served`, by its root, those that
-     * failed to open left out, each named as `projects` names it.
-     */
-    static served(served: Map<string, Promise<Served>>, projects: Projects): Everywhere;
-    constructor(placing: Placing);
-    /** Every conversation of every project served so far, with its project's main tree. */
-    list(): Promise<Placed[]>;
-    /** The conversation `id`, of whichever project holds it, or undefined for none. */
-    find(id: string): Promise<Placed | undefined>;
-    /**
-     * How a directive names `task`, of the project at `root`, to a
-     * conversation of the project at `to`: bare in its own, else
-     * `<slug>/<task>`, which `splates --project <slug>` reaches.
-     */
-    taskNamed(task: string, root: string, to: string): Promise<string>;
-}
-/** A conversation, and the main tree of the project it is in. */
-export interface Placed {
-    conversation: Conversation;
-    root: string;
-}
-/** Where `Everywhere` finds the conversations, and the projects' names. */
-export interface Placing {
-    /** Every conversation of every project served so far. */
-    list(): Promise<Placed[]>;
-    /** What the registry names the project at `root` by. */
-    slug(root: string): Promise<string>;
-}

package/exhibit.d.ts

@@ -1,21 +0,0 @@
-/**
- * Something to look at that the skill captions with the one or two calls it
- * shows, as a reply writes it under `### 🖼️ <title>`: a screenshot, a
- * diagram or a snippet.
- */
-export interface Exhibit {
-    /** What it shows, from its heading. */
-    title: string;
-    /** The screenshot, diagram or snippet, as markdown. */
-    body: string;
-}
-/** What the exhibit titled by `line` shows; null for any other line. */
-export declare function exhibitTitle(line: string): string | null;
-/**
- * An assumption's `body` parted into what is to look at, its images and code
- * blocks, as markdown, null when it holds neither, and the words around them.
- */
-export declare function shownIn(body: string): {
-    shown: string | null;
-    said: string;
-};

package/exit.d.ts

@@ -1,54 +0,0 @@
-import type { Deps, Middleware } from "webappwiz/cmd";
-/** Exit codes are the API: an agent branches on these, not on prose. */
-export declare const EXIT: {
-    readonly usage: 1;
-    readonly conflict: 2;
-    readonly tests_failed: 3;
-    readonly lease_lost: 4;
-    readonly budget_exhausted: 5;
-    readonly lease_held: 6;
-    readonly dirty: 7;
-    readonly not_found: 8;
-    readonly hook_failed: 9;
-    readonly exists: 10;
-    readonly orphaned: 11;
-    readonly merge_failed: 12;
-    readonly already_removed: 13;
-    readonly timeout: 14;
-    readonly blocked: 16;
-    readonly cycle: 18;
-    readonly outdated: 19;
-    readonly uninitialized: 20;
-    readonly too_large: 21;
-    readonly dismissed: 22;
-    readonly no_secret_store: 23;
-    readonly cloudflare: 24;
-    readonly requested: 25;
-    readonly slots_full: 26;
-    readonly slot_running: 27;
-    readonly not_granted: 28;
-    readonly agents_full: 29;
-};
-export type Reason = keyof typeof EXIT;
-/**
- * A refusal, carrying the reason to branch on, a message to show, and any
- * data worth reporting with it. `exits` turns one into output and a status
- * code.
- */
-export declare class Exit extends Error {
-    readonly reason: Reason;
-    readonly data: Record<string, unknown>;
-    constructor(reason: Reason, message: string, data?: Record<string, unknown>);
-}
-/**
- * How a command refuses. Every call site means "and go no further", which is
- * what the `never` return buys: the code below a `fail` is unreachable, and
- * TypeScript narrows accordingly.
- */
-export declare function fail(reason: Reason, message: string, data?: Record<string, unknown>): never;
-/**
- * Decides what a refusal looks like (a machine-readable reason on stdout, a
- * human explanation on stderr) and is the only place that ends the process.
- * An agent branches on the first and reads the second.
- */
-export declare function exits<C extends Deps>(): Middleware<C>;

package/fact-todos.d.ts

@@ -1,18 +0,0 @@
-import { type Logger } from "webappwiz/log";
-import type { Git } from "./git.js";
-import type { Journal } from "./journal.js";
-import type { Outcomes } from "./outcomes.js";
-import type { Todos } from "./todos.js";
-/**
- * Adds a todo, untriaged, for each thing that went worse in `task`'s merge,
- * as its merged card lists them, journaled so the conversation that merged
- * it shows each as an "Added" line the person can remove it from. One whose
- * line is on the list already is not added again.
- */
-export declare function addFactTodos({ git, outcomes, todos, journal, log, }: {
-    git: Git;
-    outcomes: Outcomes;
-    todos: Todos;
-    journal: Journal;
-    log: Logger;
-}, task: string): Promise<void>;