@stringsync/splates 0.0.45 → 0.0.46

package/show.d.ts

@@ -1,106 +0,0 @@
-import { type Logger } from "webappwiz/log";
-import { type Fs } from "webappwiz/system";
-import { type NamedSystem } from "./systems.js";
-import type { Worktree } from "./worktree.js";
-import type { WorktreeService } from "./worktree-service.js";
-/**
- * One task in full: what `list` shows for it, plus the `SPLATES.md` its agent
- * left at the worktree root. Reading a tree this way takes no lease, so it
- * cannot knock the agent driving it off its own work.
- */
-export declare function show({ service, fs, log }: {
-    service: WorktreeService;
-    fs: Fs;
-    log: Logger;
-}, task: string, opts?: ShowOptions): Promise<void>;
-export interface Details {
-    task: string;
-    status: string;
-    branch: string;
-    base: string;
-    /** The `splates server` conversation whose agent added it, or null. */
-    caller: string | null;
-    /**
-     * The `splates server` conversation whose agent last took it, or its caller's
-     * for a subagent; null for an agent outside the page.
-     */
-    takenBy: string | null;
-    worktree: string;
-    lease: "held" | "stale" | "none";
-    ahead: number | null;
-    added: number | null;
-    removed: number | null;
-    age: string | null;
-    /** When it was added, which `age` counts from. */
-    createdAt: string | null;
-    /**
-     * The last sign of an agent at work on it: a splates command writing its
-     * record, a commit on its branch, or an edit to its SPLATES.md or to a file
-     * not yet committed. Null when nothing says.
-     */
-    activeAt: string | null;
-    escalation: string | null;
-    /** The merges it has tried; at `mergeAttemptLimit`, only `splates retry` lets it try again. */
-    mergeAttempts: number;
-    mergeAttemptLimit: number;
-    /** While escalated, when it was; null otherwise. */
-    escalatedAt: string | null;
-    /**
-     * While escalated to be approved, what to look at before approving; null
-     * otherwise.
-     */
-    review: string | null;
-    /**
-     * Whether the plan leaves nothing unchecked under `## Blocked` or
-     * `## Next`, which `splates merge` and `splates escalate --review` require.
-     */
-    ready: boolean;
-    plan: string | null;
-    /** How the `SPLATES.md` departs from the shape the skill prescribes. */
-    planProblems: string[];
-    /**
-     * Whether `splates add --agent` handed it to an agent that `splates server` has
-     * yet to start a conversation with.
-     */
-    dispatched: boolean;
-    /**
-     * The conversation `splates server` started for the agent another conversation
-     * handed it to, which answers to that one, its caller, rather than to the
-     * user; null for any other task.
-     */
-    handedTo: string | null;
-    /**
-     * The systems its changed files fall in, committed or not, in the order
-     * its worktree's `splates.systems.ts` names them.
-     */
-    systems: NamedSystem[];
-}
-export interface ShowOptions {
-    /** Print the details as JSON instead of prose. */
-    json?: boolean;
-}
-/** Configures how {@link TaskDetails} gathers a task's info. */
-export interface TaskDetailsOptions {
-    /** What the worktree is read through; the real filesystem by default. */
-    fs?: Fs;
-}
-/**
- * Everything there is to say about one task. Split out so `dev` can render the
- * same fields this prints, rather than assembling its own and drifting.
- */
-export declare class TaskDetails {
-    private readonly fs;
-    constructor(opts?: TaskDetailsOptions);
-    get(worktree: Worktree): Promise<Details>;
-    /**
-     * The latest of its record's last write, its own latest commit, and the
-     * edits to its SPLATES.md and uncommitted files, as `Details.activeAt`.
-     */
-    private activeAt;
-    /**
-     * Read from its own worktree, so a system named during the task counts at
-     * once. Its changed files cost three git calls, spent only once there is a
-     * system to match them against.
-     */
-    private systems;
-}

package/skill-checks.d.ts

@@ -1,73 +0,0 @@
-/**
- * The rules of the splates skill a program can decide, checked over one
- * conversation: what it said and ran, condensed, and what it left behind.
- * `splates server` runs them on its conversations, for the Stats page's pass rate
- * per skill version; the hand-run evals run them on theirs. Rules that take
- * judgment, such as whether a call should have been a question, are left to
- * a model grading the evals.
- */
-/** Each check's verdicts on one conversation, by its id. */
-export declare function judge(transcript: Transcript, end: EndState): Record<string, Verdict[]>;
-/** A conversation as the checks read it: its own words and acts, in order. */
-export interface Transcript {
-    beats: Beat[];
-    /**
-     * Whether another conversation handed it its task, a lane's orchestrator
-     * or an agent relaying for it, so it reports to that conversation, which
-     * proposes the next todo in its place.
-     */
-    handed: boolean;
-}
-/**
- * One thing said or done. A `user` beat starts a turn. What the agent's
- * subagents did is left out: the rules are the agent's own.
- */
-export type Beat = {
-    kind: "user";
-    text: string;
-}
-/** Words the agent said, one stretch of text between its tool calls. */
- | {
-    kind: "say";
-    text: string;
-}
-/** A shell command, with the end of what it printed and whether it succeeded. */
- | {
-    kind: "run";
-    command: string;
-    output: string;
-    ok: boolean;
-}
-/** Files a tool call wrote or edited. */
- | {
-    kind: "edit";
-    paths: string[];
-};
-/** What the conversation left behind, which its transcript does not say. */
-export interface EndState {
-    /** Each task it merged, with the message of each commit that landed. */
-    landed: {
-        task: string;
-        commits: string[];
-    }[];
-}
-/** How one place a rule applied went. */
-export interface Verdict {
-    ok: boolean;
-    /** What was checked, and what was found when it failed. */
-    why: string;
-}
-/** A rule a program can decide; `judge` returns no verdicts where it does not apply. */
-export interface Check {
-    id: string;
-    /** The rule, as the Stats page names it. */
-    rule: string;
-    judge(transcript: Transcript, end: EndState): Verdict[];
-}
-/** Every check, in the order the Stats page lists them. */
-export declare const CHECKS: readonly Check[];
-/** Each `splates` command `command` runs, by its verb and its words after. */
-export declare function splatesCalls(command: string): {
-    verb: string;
-    args: string[];
-}[];

package/skill-checks.js

@@ -1,10 +0,0 @@
-import {
-  judge2,
-  CHECKS2,
-  splatesCalls2
-} from "./index-0tfvy823.js";
-export {
-  CHECKS2 as CHECKS,
-  judge2 as judge,
-  splatesCalls2 as splatesCalls
-};

package/skills.d.ts

@@ -1,16 +0,0 @@
-import type { Logger } from "webappwiz/log";
-import { ProjectSkills } from "webappwiz/skills";
-import type { Fs, Ps } from "webappwiz/system";
-/**
- * The repository splates's skill comes from: each release is a tag in it, and
- * the skill its `skills/splates/SKILL.md`, which `bunx skills add` finds.
- */
-export declare const SOURCE = "stringsync/splates";
-/** The skills a project at `root` has, installing splates's from `SOURCE`. */
-export declare function projectSkills(root: string, deps: {
-    fs: Fs;
-    ps: Ps;
-    log: Logger;
-}): ProjectSkills;
-/** The installed splates skill's version, or null when absent or unreadable. */
-export declare function installedVersion(fs: Fs, root: string): Promise<string | null>;

package/slot-tunnel.d.ts

@@ -1,27 +0,0 @@
-import type { Logger } from "webappwiz/log";
-import type { Creds } from "./creds.js";
-import type { SavedTunnel, TunnelRecord } from "./saved-tunnel.js";
-import type { Slot } from "./slots.js";
-/** What the Access application in front of every slot is called. */
-export declare const SLOTS_APP = "splates-slots";
-/** The cred a slot's tunnel token is kept as, on the device. */
-export declare function slotToken({ word }: Slot): string;
-/**
- * Makes what carries `<word>.<zone>` to a slot's `splates server`, beside the
- * tunnel `splates tunnel setup` made, through the API with the same token: the
- * slot's tunnel, `splates-<word>`, the DNS record routing its host to it, and,
- * once for every slot, an Access application in front of `*.<zone>` letting
- * in whom the machine's own lets in. Saves them in the slot's home, so its
- * `splates server` runs them as a bare one runs the machine's. What already exists
- * by name is reused, so running it again is safe.
- */
-export declare function slotTunnelSetup({ slot, machine, creds, saved, log, fetch, }: {
-    slot: Slot;
-    /** What `splates tunnel setup` saved, whose zone, team and policy slots share. */
-    machine: TunnelRecord;
-    creds: Creds;
-    /** The slot home's tunnel, saved here. */
-    saved: SavedTunnel;
-    log: Logger;
-    fetch?: typeof globalThis.fetch;
-}): Promise<TunnelRecord>;

package/snapshot.d.ts

@@ -1,75 +0,0 @@
-import type { Fs } from "webappwiz/system";
-import type { CredRequest, Creds } from "./creds.js";
-import type { LaneRecord } from "./lanes.js";
-import type { Behind, Release } from "./release.js";
-import { type Details } from "./show.js";
-import type { Slot } from "./slots.js";
-import type { TodoState } from "./todo.js";
-import type { Todos } from "./todos.js";
-import type { WorktreeService } from "./worktree-service.js";
-/**
- * Everything one page shows: `todo list`, and `list` and `show` for each
- * task.
- */
-export interface Snapshot {
-    /** The repository's directory name, so a page among many says whose it is. */
-    repo: string;
-    /** Where the repository sits, with the home directory as `~`. */
-    path: string;
-    /** The main tree, absolute, which agents' file paths start from. */
-    root: string;
-    /** The directory that holds each task's worktree, absolute. */
-    worktreeRoot: string;
-    /** Past this age a todo is offered for removal rather than recommended. */
-    todoStalenessMs: number;
-    todos: TodoState[];
-    /** Every lane, in board order, empty ones too. */
-    lanes: LaneRecord[];
-    /**
-     * The name of every lane there has been, those on the board first, to
-     * name a lane's orchestrator after it once the lane is done.
-     */
-    laneNames: LaneRecord[];
-    tasks: Details[];
-    /** Every cred agents requested, open or not, the latest first; never a value. */
-    creds: CredRequest[];
-    /** The branch tasks land on, which the main tree has checked out. */
-    trunk: string;
-    /** A newer splates than the one serving, once `splates server` has seen one on npm. */
-    release: Release | null;
-    /** Commits to splates's own source since `splates server` started from it. */
-    behind: Behind | null;
-    /**
-     * Whether building the page failed as `splates server` started, so the page
-     * serving is the one built before, and may be out of date.
-     */
-    unbuilt: boolean;
-    /** The slot `splates server --slot` serves under, shown beside the project's name. */
-    slot: Slot | null;
-}
-/**
- * Reads the whole repo the way the CLI's read commands do. Takes no lease, so
- * the page can sit open on a live tree without disturbing the agent in it.
- */
-export declare function snapshot({ service, todos, creds, fs, home, release, behind, unbuilt, slot, }: {
-    service: WorktreeService;
-    todos: Todos;
-    creds: Creds;
-    fs: Fs;
-    /** The home directory to show as `~`, when there is one. */
-    home?: string;
-    release?: Release | null;
-    behind?: Behind | null;
-    unbuilt?: boolean;
-    slot?: Slot | null;
-}): Promise<Snapshot>;
-/** `list` and `show` for each task, as {@link snapshot} reads them. */
-export declare function tasksOf({ service, fs, }: {
-    service: WorktreeService;
-    fs: Fs;
-}): Promise<Details[]>;
-/**
- * A key that changes only when what the page shows does, to push a snapshot
- * to open pages only when it differs from the last one pushed.
- */
-export declare function fingerprint({ todos, lanes, laneNames, tasks, creds, release, behind, }: Snapshot): string;

package/splates-artifact.d.ts

@@ -1,3 +0,0 @@
-import type { SplatesDeps } from "./splates.js";
-/** `splates artifact`, which the root cli mounts after `splates attach`. */
-export declare const splatesArtifact: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/splates-creds.d.ts

@@ -1,3 +0,0 @@
-import type { SplatesDeps } from "./splates.js";
-/** `splates creds`, which the root cli mounts after `splates lane`. */
-export declare const splatesCreds: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/splates-dev.d.ts

@@ -1,22 +0,0 @@
-import { type DevServer } from "./dev.js";
-import type { SplatesDeps } from "./splates.js";
-/**
- * What `splates server` does with its flags: run itself as a supervised child, so
- * the page can restart it, which then serves the page, reached through the
- * tunnel and Access the flags name, or else the ones saved for this machine.
- * It serves every registered project wherever it is started; the page picks
- * which one it shows. The server, from the child; nothing from the
- * supervisor, which exits.
- */
-export declare function serveDev(ctx: SplatesDeps, opts: DevFlags): Promise<DevServer | undefined>;
-/** The flags `splates server` takes, as `serveDev` reads them. */
-export interface DevFlags {
-    port: number;
-    "allow-hosts": string;
-    "access-team": string;
-    "access-aud": string;
-    tunnel: string;
-    "tunnel-name": string;
-    "ports-host": string;
-    slot: boolean;
-}

package/splates-flags.d.ts

@@ -1,34 +0,0 @@
-import { z } from "zod";
-import type { Repository } from "./repository.js";
-import { type AgentPick, Roster, type RosterAgent } from "./roster.js";
-import { SavedPortsHost } from "./saved-ports-host.js";
-import { SavedTunnel } from "./saved-tunnel.js";
-import type { SplatesDeps } from "./splates.js";
-/** A place in the todo list, 1 at the top; absent leaves it to the command. */
-export declare const position: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-/**
- * The agent `--agent` and `--model` name off the roster: undefined when
- * neither is given, null for `--agent none`.
- */
-export declare function assigneeIn(deps: SplatesDeps, agent: string, model: string): Promise<AgentPick | null | undefined>;
-/** The user's roster, beside the project registry. */
-export declare function rosterOf({ ps, fs }: SplatesDeps): Roster;
-/** The tunnel `splates tunnel setup` saved for this machine. */
-/** The base host `splates server --ports-host` saved for this machine. */
-export declare function savedPortsHostOf({ ps, fs }: SplatesDeps): SavedPortsHost;
-export declare function savedTunnelOf({ ps, fs, secrets, }: SplatesDeps): SavedTunnel;
-/** The tunnel each slot's home may have saved, for every word of the pool. */
-export declare function slotTunnelsOf({ ps, fs, secrets, }: SplatesDeps): SavedTunnel[];
-/** The roster's agents, written out as the defaults first when there is none. */
-export declare function seeded(roster: Roster): Promise<RosterAgent[]>;
-/** `--lane 3`, `new` or `none` as a lane; absent leaves it to the command. */
-export declare function laneIn(raw: string): number | "new" | null | undefined;
-/** `--todo 3,5` as ids, refusing anything that is not one. */
-export declare function todoIds(raw: string): number[];
-/** A comma-separated flag's values, with no empty ones. */
-export declare function commaList(raw: string): string[];
-/**
- * Which task a command that takes no task name is about, so the journal can
- * name it. `merge` and `escalate` read it off the current branch.
- */
-export declare function here({ service, git, ps, project, }: SplatesDeps & Repository): Promise<string | null>;

package/splates-lane.d.ts

@@ -1,3 +0,0 @@
-import type { SplatesDeps } from "./splates.js";
-/** `splates lane`, which the root cli mounts after `splates todo`. */
-export declare const splatesLane: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/splates-projects.d.ts

@@ -1,3 +0,0 @@
-import type { SplatesDeps } from "./splates.js";
-/** `splates projects`, which the root cli mounts after `splates lane`. */
-export declare const splatesProjects: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/splates-setup.d.ts

@@ -1,17 +0,0 @@
-import { Setup } from "./setup.js";
-import type { SplatesDeps } from "./splates.js";
-/** This machine's setup, read through `deps`. */
-export declare function setupOf({ fs, ps, secrets, fetch, }: SplatesDeps): Setup;
-/** What `splates setup` was asked for. */
-export interface SetupOptions {
-    /** A step's id, or empty for every area's progress. */
-    step: string;
-    json: boolean;
-    skip: boolean;
-    unskip: boolean;
-}
-/**
- * `splates setup [step]`: progress by area and the one next step, or one step's
- * why and instructions, after skipping or unskipping it when asked.
- */
-export declare function setup(deps: SplatesDeps, opts: SetupOptions): Promise<void>;

package/splates-slots.d.ts

@@ -1,3 +0,0 @@
-import type { SplatesDeps } from "./splates.js";
-/** `splates slots`, which the root cli mounts after `splates tunnel`. */
-export declare const splatesSlots: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/splates-todo.d.ts

@@ -1,3 +0,0 @@
-import type { SplatesDeps } from "./splates.js";
-/** `splates todo`, which the root cli mounts after the task commands. */
-export declare const splatesTodo: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/stats.d.ts

@@ -1,186 +0,0 @@
-import type { Judged } from "./adherence.js";
-import { type Baseline } from "./baselines.js";
-import type { Outcome } from "./outcomes.js";
-import { type MergeFailure, type RemoveReason } from "./worktree.js";
-/** What the Stats page shows: how tasks ended, bar by bar and by who did them. */
-export interface Stats {
-    /**
-     * Each bar of the period, oldest first, those with nothing ended among
-     * them: `start` is when it starts, as an ISO time.
-     */
-    buckets: ({
-        start: string;
-    } & Tally)[];
-    /**
-     * The as long a span before the period, summed, to compare it with; null
-     * for all time, which has nothing before it.
-     */
-    previous: Tally | null;
-    /** By the model that ended each task in the period, the most first; null for unknown. */
-    models: ({
-        model: string | null;
-    } & Tally)[];
-    /**
-     * By where the person worked each task in the period from, the most
-     * first: null for none, as for an external agent, or one that ended
-     * before it was kept.
-     */
-    devices: ({
-        device: WorkedFrom | null;
-    } & Tally)[];
-    /** By the main tree each task in the period was in, the most first. */
-    projects: ({
-        project: string;
-    } & Tally)[];
-    /**
-     * By each system a task in the period touched, the most first: a task
-     * counts in each of its systems, and in `null` when it touched none or
-     * ended before systems were kept.
-     */
-    systems: ({
-        system: string | null;
-    } & Tally)[];
-    /**
-     * Who made the calls tasks in the period made, by size: `SIZES` in order, then any
-     * other word an older scheme used, then null for those with none, which
-     * holds every call from before sizes were kept.
-     */
-    sizes: SizeTally[];
-    /** When the first outcome was written, the start of what there is to show. */
-    since: string | null;
-    /**
-     * How conversations followed the splates skill, by the version each started
-     * on, newest first: over all time, since a version is its own span.
-     */
-    skill: SkillVersion[];
-    /** Each project's recent merged tasks, to hold one against: over the week before now, whatever the period. */
-    baselines: Baseline[];
-}
-/** How a group of ended tasks went, summed. */
-export interface Tally {
-    merged: number;
-    removed: number;
-    /** Of `merged`, those that landed without a person answering a question. */
-    clean: number;
-    /** Over every task in the group, merged and removed alike. */
-    questionRounds: number;
-    reviewRounds: number;
-    failedMerges: number;
-    /** Questions that offered the agent's pick and were answered with a choice. */
-    picksAsked: number;
-    /** Of `picksAsked`, those answered with another choice. */
-    picksOverturned: number;
-    /** Of `picksAsked`, those answered with the agent's choice and words added. */
-    picksAmended: number;
-    /** Calls made without asking. */
-    assumptionsMade: number;
-    /** Of `assumptionsMade`, those challenged. */
-    assumptionsChallenged: number;
-    /** Calls the person made: questions put to them, assumptions challenged. */
-    decidedByYou: number;
-    /** Calls agents made that stood without the person: assumptions left alone. */
-    decidedByAgents: number;
-    /** Tasks whose time waiting on a person was kept; older ones were not. */
-    timed: number;
-    /** Of the `timed` tasks, how long they waited on a person, in milliseconds. */
-    waitedMs: number;
-    /** Of the `timed` tasks, how long they took from add to end, in milliseconds. */
-    spentMs: number;
-    /** Tasks whose own usage was kept; older ones and external agents' were not. */
-    used: number;
-    /** Of the `used` tasks, tokens read, those from cache among them, and written. */
-    inputTokens: number;
-    outputTokens: number;
-    /** Of the `used` tasks, those whose agent said what they cost; Codex does not. */
-    costed: number;
-    /** Of the `costed` tasks, what they cost, summed. */
-    cost: number;
-    /** Of the `used` tasks, how long their agents worked, in milliseconds. */
-    workedMs: number;
-    /** Tasks whose diff size was kept. */
-    sized: number;
-    /** Of the `sized` tasks, the files and lines they changed. */
-    filesChanged: number;
-    linesAdded: number;
-    linesRemoved: number;
-    /** Failed merges by why, where it was kept. */
-    failedBy: Record<MergeFailure, number>;
-    /** Removed tasks by why; `unsaid` for one removed without `--reason`, or before it was kept. */
-    removedFor: Record<RemoveReason | "unsaid", number>;
-}
-/** Who made the calls of one size: the person, or agents without asking. */
-export interface SizeTally extends Decided {
-    size: string | null;
-    /** The same, bar by bar, in the order of `Stats.buckets`. */
-    buckets: Decided[];
-    /** The same over the as long a span before, as `Stats.previous`; null for all time. */
-    previous: Decided | null;
-}
-/** How many calls the person made, and how many agents made without them. */
-export interface Decided {
-    decidedByYou: number;
-    decidedByAgents: number;
-}
-/** Where the person spoke to a task's conversation from: a phone, a desktop, or both. */
-export type WorkedFrom = "phone" | "desktop" | "both";
-/** Where `outcome`'s prompts came from, or null when none was said from the page. */
-export declare function workedFrom(outcome: Outcome): WorkedFrom | null;
-/**
- * The spans the page can look at, as `?period=` names them: how long each
- * runs back from now, and how long each of its bars is.
- */
-export declare const PERIODS: {
-    readonly "6h": {
-        readonly span: number;
-        readonly bucket: number;
-    };
-    readonly "1d": {
-        readonly span: number;
-        readonly bucket: number;
-    };
-    readonly "3d": {
-        readonly span: number;
-        readonly bucket: number;
-    };
-    readonly "7d": {
-        readonly span: number;
-        readonly bucket: number;
-    };
-};
-/** A span in `PERIODS`, or `all` for all time, a bar a week. */
-export type PeriodId = keyof typeof PERIODS | "all";
-export declare function isPeriodId(value: string): value is PeriodId;
-/** How long each bar of `period` is, in milliseconds: a week for all time. */
-export declare function bucketOf(period: PeriodId): number;
-export interface SummarizeOptions {
-    period?: PeriodId;
-    now?: Date;
-    /** Each conversation's skill checks as last judged. */
-    judged?: Judged[];
-}
-/**
- * Sums the outcomes written so far for the page, over `period`. A part,
- * which lands on its caller's branch rather than trunk, is left out: it is a
- * piece of a task that is counted when its caller ends.
- */
-export declare function summarize(outcomes: Outcome[], { period, now, judged }?: SummarizeOptions): Stats;
-/** Tallies added up, as for the bars of a period. */
-export declare function combine(tallies: Tally[]): Tally;
-/** How one check went over the conversations on one skill version. */
-export interface CheckRate {
-    id: string;
-    rule: string;
-    /** The conversations it applied in. */
-    applied: number;
-    /** Of `applied`, those where it passed every time. */
-    passed: number;
-}
-/** How the conversations on one splates skill version followed it. */
-export interface SkillVersion {
-    /** Null for conversations whose version is unknown. */
-    skill: string | null;
-    conversations: number;
-    checks: CheckRate[];
-}
-/** Each skill version's pass rates, the newest version first and unknown last. */
-export declare function rates(judged: Judged[]): SkillVersion[];

package/supervise.d.ts

@@ -1,50 +0,0 @@
-import type { Ps } from "webappwiz/system";
-import { type Timer } from "webappwiz/time";
-/** What a server exits with to be started again as it was. */
-export declare const RESTART = 75;
-/** What a server exits with to be started again on the newest splates. */
-export declare const UPDATE = 76;
-/**
- * Set in the server's environment, so the `splates server` it runs serves rather
- * than supervising another.
- */
-export declare const SERVING = "SPLATES_DEV_SERVING";
-/**
- * Set in the server's environment to tell it its page failed to build, so
- * the page says it may be out of date.
- */
-export declare const UNBUILT = "SPLATES_DEV_UNBUILT";
-/** What `supervise` starts the server with, beyond the process it runs in. */
-export interface SuperviseOptions {
-    /**
-     * Builds the page, run before each start of the same splates, as from a
-     * checkout, whose page `bun install` built last and the commits since may
-     * have changed, packages they added included; null for one installed from
-     * npm, whose page shipped built.
-     */
-    build?: {
-        argv: string[];
-        cwd: string;
-    } | null;
-    /** Added to the server's environment, as a slot's home is. */
-    env?: Record<string, string>;
-    /** Where the server runs, the working directory by default. */
-    cwd?: string;
-    /**
-     * The arguments of a worker to run beside the server, as `["worker",
-     * "run"]`: started again whenever it ends, on the newest splates once the
-     * server updates, and stopped with this. Null for none.
-     */
-    worker?: string[] | null;
-    timer?: Timer;
-}
-/**
- * Runs `splates server` as a child of this process, sharing its terminal, and
- * starts another each time the child exits to restart: as this one was
- * started, or on the newest splates when it asks to update. Ctrl-C reaches the
- * child too, and its exit ends this. A SIGTERM or SIGHUP to this one stops the
- * child with a SIGTERM and ends this, since the child would otherwise outlive
- * it, listening on its port. A `worker` runs beside it as a second child.
- * Answers with the exit code to end on.
- */
-export declare function supervise(ps: Ps, { build, env, cwd, worker, timer, }?: SuperviseOptions): Promise<number>;