@stringsync/splates 0.0.45 → 0.0.46

package/conversation.d.ts

@@ -1,209 +0,0 @@
-import type { Resource } from "webappwiz/disposable";
-import { type Eventful } from "webappwiz/events";
-import type { Agent, ProcessHandle } from "./agent-process.js";
-import { Artifacts } from "./artifacts.js";
-import type { ConversationDeps, ConversationEvents, ConversationHost } from "./conversation-host.js";
-import { ConversationLog } from "./conversation-log.js";
-import { type Answer, type Attached, type ConversationState, type Device, type Limit, type Upload } from "./conversation-state.js";
-import { type PromptOptions } from "./conversation-turns.js";
-/**
- * One conversation with one agent. Live, it holds the agent's process; read
- * back from its log, it is what was said, and resumes on the next prompt.
- */
-export declare class Conversation implements Eventful<ConversationEvents>, Resource, ConversationHost {
-    readonly state: ConversationState;
-    readonly log: ConversationLog;
-    private readonly deps;
-    /** What to run to resume it; null when its agent is no longer known. */
-    readonly agent: Agent | null;
-    /** Where it runs; null for a log too old to say. */
-    private dir;
-    private readonly dispatcher;
-    readonly events: import("webappwiz/events").Events<ConversationEvents>;
-    private readonly files;
-    /** The files its agent kept as its outputs, read and changed here. */
-    readonly artifacts: Artifacts;
-    private readonly connection;
-    private readonly turns;
-    private readonly background;
-    /** Under way while the agent starts or comes back, for a prompt to wait on. */
-    opening: Promise<void> | null;
-    /** Stops the agent once it has sat idle `IDLE_STOP`; null while it works. */
-    private resting;
-    /** Let go of its process for a restart: nothing here ends it now. */
-    private detached;
-    private constructor();
-    /**
-     * A conversation as its log at `path` left it: stopped, whatever it was
-     * doing, unless its agent still runs on a worker, which the launcher
-     * takes back, and the conversation carries on where the log leaves off.
-     */
-    static read(path: string, agents: Agent[], deps: ConversationDeps): Promise<Conversation | null>;
-    /** Starts `agent` in `cwd` and opens a session with it. */
-    static start({ settings, model, ...opening }: Opening & {
-        /** Values to set, by setting id, once the session offers them. */
-        settings?: Record<string, string>;
-        /**
-         * The model to pick, by its value or name in the session's model
-         * setting, over what `settings` says. An unavailable choice fails.
-         */
-        model?: string;
-    }, deps: ConversationDeps): Promise<Conversation>;
-    /**
-     * Brings in `session`, one `agent` holds outside splates, such as from its
-     * CLI: loads it in `cwd`, writing what the agent replays of it to a new
-     * log, from which it resumes like any other.
-     */
-    static bring({ session, title, ...opening }: Opening & {
-        session: string;
-        /** What the agent listed it as, until the replay says otherwise. */
-        title: string | null;
-    }, deps: ConversationDeps): Promise<Conversation>;
-    /** A new conversation with `agent` in `cwd`, its log begun, not yet opened. */
-    private static begin;
-    get id(): string;
-    /** The agent's pid while it runs, for the commands it left running. */
-    get pid(): number | null;
-    /**
-     * The handle for reattaching after a coordinator restart, or null when
-     * this process cannot survive a restart.
-     */
-    get handle(): ProcessHandle | null;
-    /** The agent's session, once it has opened one. */
-    get sessionId(): string | null;
-    /** Where it runs; null for a log too old to say. */
-    get cwd(): string | null;
-    /**
-     * When it was archived, or when it started for a log too old to say; null
-     * while it is not archived.
-     */
-    get archivedSince(): string | null;
-    /** Whether a checkpoint has ended and nothing has been said since. */
-    get stoppedByCheckpoint(): boolean;
-    now(): string;
-    /** Says `text` to the agent, with `files` (see `ConversationTurns`). */
-    prompt(text: string, files?: Upload[], from?: Device, opts?: PromptOptions): Promise<void>;
-    /** Takes back the `index`th queued message, answering with its words and files. */
-    unqueue(index: number): {
-        text: string;
-        files: Attached[];
-    };
-    /** Sends what is queued now, stopping the running turn first. */
-    sendNow(): Promise<void>;
-    /** Stops the agent's turn for the person, and stays open for the next. */
-    cancel(): Promise<void>;
-    /** Asks the agent to bring its `SPLATES.md` up to date and stop (see `ConversationTurns`). */
-    checkpoint(merging: boolean): Promise<void>;
-    /**
-     * Checkpoints the agent for the person, as `checkpoint` does, and leaves
-     * it stopped there: nothing resumes a pause, and Power leaves it alone.
-     */
-    pause(merging: boolean): Promise<void>;
-    /** Forgets the checkpoint, done or not, so the next starts afresh. */
-    dismissCheckpoint(): void;
-    /** Settles once the checkpoint asked is no longer under way. */
-    answered(): Promise<void>;
-    /** Settles the agent's pending ask, if `id` is still the one it is on. */
-    answer(id: string, answer: Answer): void;
-    /** The file `name` the person sent, or null when they sent none by that name. */
-    attachment(name: string): Promise<{
-        bytes: Uint8Array;
-        mimeType: string;
-    } | null>;
-    /** Keeps the plan's windows in `limits`, asked of the agent's maker. */
-    hear(limits: Limit[]): void;
-    /** Stops background command `id`, leaving the agent's turn as it is. */
-    stopBackground(id: string): Promise<void>;
-    /** What background command `id` has printed, then more as it prints it. */
-    backgroundOutput(id: string): ReadableStream<Uint8Array>;
-    /**
-     * Sets the session's setting `id` to `value`, one the agent offers: at once
-     * while the agent runs, or, while it is stopped, when it next resumes.
-     */
-    choose(id: string, value: string): Promise<void>;
-    /**
-     * Brings a stopped conversation back: a new process, the same session, or
-     * a new one when its agent died before opening one.
-     */
-    resume(): Promise<void>;
-    /**
-     * Follows the agent into a task's worktree, or back to the main tree: a
-     * running session keeps the directory it opened in, and the agent works by
-     * absolute path; a resumed one opens in the new.
-     */
-    move(task: string | null, cwd: string, base?: string | null, caller?: string | null): void;
-    /** Stops the agent; the next prompt resumes where it left off. */
-    stop(): Promise<void>;
-    /**
-     * Lets go of the agent's process without ending it, for a coordinator
-     * started again to take back from the worker: its log, flushed, says
-     * where it stopped. Answers whether there was one to let go of; a
-     * conversation with none, or one nothing could take back, stops as ever.
-     */
-    detach(): Promise<boolean>;
-    /**
-     * Stops it and puts it away, off the list of conversations; `with`, the
-     * conversation whose archiving takes it along, which brings it back.
-     * Its artifacts keep only what their panel shows.
-     */
-    archive(withConversation?: string): Promise<void>;
-    /** Names it `name` over the agent's title; blank goes back to the title. */
-    rename(name: string): Promise<void>;
-    /** Back on the list, stopped until the next prompt. */
-    unarchive(): Promise<void>;
-    /** Keeps it atop the list, or lets it go back among the rest. */
-    pin(pinned: boolean): Promise<void>;
-    /**
-     * Nests it in the list under the conversation `id`, or at the top for
-     * null, over where its task would, cutting it loose from the conversation
-     * that started it or added its task: that one no longer tells it, hears
-     * from it, or archives it along. Never for a subagent, which stays with
-     * the one it answers to.
-     */
-    reparent(id: string | null): Promise<void>;
-    /** Settles once everything said so far is in its log, for a reader of the file. */
-    saved(): Promise<void>;
-    /** Marks it seen, or unseen again for the person to come back to. */
-    markUnread(unread: boolean): Promise<void>;
-    /** Stops it and deletes its log and files, for good. */
-    delete(): Promise<void>;
-    dispose(): void;
-    /** Marks it `unread` or not, keeping how much was seen when it was read. */
-    flag(unread: boolean): void;
-    /** Back to idle once a turn ends, then on to what was queued meanwhile. */
-    ended(error: string | null): void;
-    /** Ends the agent's process, with `error` for one that failed, and keeps that it stopped. */
-    close(error: string | null): Promise<void>;
-    set(next: Partial<ConversationState>): void;
-    changed(): void;
-    /**
-     * Stops an agent left idle `IDLE_STOP`, with no command running in the background,
-     * no question open and no checkpoint, so its process exits and takes what
-     * it started along, MCP servers and browsers included. The next prompt
-     * resumes the same session.
-     */
-    private rest;
-    /** Opens the agent in `cwd`, clearing `opening` once it has or failed to. */
-    private wake;
-}
-/** What a conversation is opened with, started afresh or brought in. */
-interface Opening {
-    id: string;
-    agent: Agent;
-    task: string | null;
-    /** The branch `task` was cut from. */
-    base?: string | null;
-    /** The conversation whose agent added `task`. */
-    caller?: string | null;
-    cwd: string;
-    log: string;
-    /** Started on what a todo or `splates add --agent` assigned. */
-    assigned?: boolean;
-    /** The conversation that handed it its task, which it answers to. */
-    handedBy?: string | null;
-    /** The lane orchestrator that handed it its task, which hears when it stops. */
-    startedBy?: string | null;
-    /** The project's splates skill version as it starts; null when it has none. */
-    skill?: string | null;
-}
-export {};

package/conversations.d.ts

@@ -1,140 +0,0 @@
-import type { ConversationsOptions } from "./conversation-options.js";
-export type { ConversationsOptions } from "./conversation-options.js";
-import type { Resource } from "webappwiz/disposable";
-import { type Eventful } from "webappwiz/events";
-import { type Agent, type Session } from "./agent-process.js";
-import { Conversation } from "./conversation.js";
-import type { ConversationsEvents } from "./conversation-host.js";
-import type { Limit, Setting } from "./conversation-state.js";
-/** How many archived conversations are kept; older archived ones are deleted. */
-export declare const ARCHIVED_KEPT = 200;
-/**
- * Every conversation in the repo: the live ones this process started, and
- * the stopped ones read back from their logs, one JSON-lines file each under
- * `.git/splates/conversations`.
- */
-export declare class Conversations implements Eventful<ConversationsEvents>, Resource {
-    readonly dir: string;
-    readonly agents: Agent[];
-    private readonly dispatcher;
-    readonly events: import("webappwiz/events").Events<ConversationsEvents>;
-    private readonly known;
-    private readonly fs;
-    private readonly ids;
-    private readonly launcher;
-    private readonly machine;
-    private readonly starting;
-    private readonly timer;
-    private readonly clock;
-    private readonly watch;
-    private readonly offered;
-    private readonly limited;
-    private readonly adherence;
-    private readonly outcomes;
-    private readonly readLimits;
-    private readonly root;
-    private readonly projects;
-    private readonly servers;
-    private readonly artifacts;
-    /** What every conversation's artifacts make room through, across the project. */
-    private readonly room;
-    /** The read of the records on disk, shared by every caller until it settles. */
-    private loaded;
-    /** The last deletion of archived conversations past `ARCHIVED_KEPT`, so they run one at a time. */
-    private pruning;
-    /** When each agent's limits were last asked for, by its id, in epoch ms. */
-    private readonly asked;
-    /** Where `splates server` answers, once it does, for the agents' CLI. */
-    url: string | null;
-    /** New starts use the refreshed roster; existing conversations retain their snapshot. */
-    refreshRoster(agents: Agent[]): void;
-    constructor(dir: string, agents: Agent[], opts?: ConversationsOptions);
-    /** What each conversation is made with. */
-    private get deps();
-    /**
-     * What each agent's sessions last offered, from any project, by its id:
-     * what a first conversation with one shows before it starts.
-     */
-    settings(): Promise<Record<string, Setting[]>>;
-    /**
-     * Each agent's plan limits as it last said, from any project, by its id:
-     * what a new conversation shows before one here says.
-     */
-    limits(): Promise<Record<string, Limit[]>>;
-    /**
-     * Asks each agent that does not send its limits for them, unless it was
-     * asked within `LIMITS_FRESH`, and keeps what it says for every project.
-     */
-    refreshLimits(): Promise<void>;
-    /** Every conversation, newest first. */
-    list(): Promise<Conversation[]>;
-    find(id: string): Promise<Conversation>;
-    /**
-     * Starts a conversation with `agent` in `cwd`, for `task` if it is one's,
-     * with `settings` set once the session offers them.
-     */
-    start(agent: string, { task, base, caller, cwd, settings, model, assigned, handedBy, startedBy, }: {
-        task: string | null;
-        /** The branch `task` was cut from. */
-        base?: string | null;
-        /** The conversation whose agent added `task`. */
-        caller?: string | null;
-        cwd: string;
-        settings?: Record<string, string>;
-        /** The model to start on, by its value or name in the model setting. */
-        model?: string;
-        /** Whether a todo or `splates add --agent` assigned the agent and model. */
-        assigned?: boolean;
-        /** The conversation that handed it its task, which it answers to. */
-        handedBy?: string | null;
-        /** The lane orchestrator that handed it its task, which hears when it stops. */
-        startedBy?: string | null;
-    }): Promise<Conversation>;
-    /**
-     * The sessions each agent holds in `cwd` that splates does not, such as ones
-     * started in its CLI, to bring in: newest first, from every agent that
-     * lists and loads sessions.
-     */
-    sessions(cwd: string): Promise<Session[]>;
-    /**
-     * Brings in `session`, one `agent` holds outside splates, as a conversation
-     * in `cwd`, for `task` if it is one's.
-     */
-    bring(agent: string, session: string, { task, base, caller, cwd, title, }: {
-        task: string | null;
-        /** The branch `task` was cut from. */
-        base?: string | null;
-        /** The conversation whose agent added `task`. */
-        caller?: string | null;
-        cwd: string;
-        title?: string | null;
-    }): Promise<Conversation>;
-    /**
-     * Deletes the archived conversations past the `ARCHIVED_KEPT` archived
-     * most recently, so their logs do not pile up, their artifacts and
-     * attached files going with them.
-     */
-    prune(): Promise<void>;
-    /** Stops every live conversation, so no agent outlives the server. */
-    disposeAsync(): Promise<void>;
-    /**
-     * Lets go of every agent a worker runs, for a coordinator started again
-     * to take back, and says whether there was any: the rest stop as ever.
-     */
-    detachAsync(): Promise<boolean>;
-    dispose(): void;
-    private track;
-    /** Asks for `conversation`'s agent's limits, when it does not send them. */
-    private askLimits;
-    private load;
-    private trim;
-    private read;
-}
-export type { Agent, AgentProcess, Launch, Launcher, Session, } from "./agent-process.js";
-export { launch } from "./agent-process.js";
-export type { Artifact, ArtifactGone, ArtifactVersion, } from "./artifacts.js";
-export { Conversation } from "./conversation.js";
-export type { ConversationEvents, ConversationsEvents, } from "./conversation-host.js";
-export type { After, Answer, Ask, Attached, Background, BackgroundState, Checkpoint, Command, Compaction, ConversationState, Decision, Device, Edit, Field, Image, Limit, Message, Part, Setting, Status, Step, Taking, Tool, Upload, Usage, } from "./conversation-state.js";
-export { DEVICES, FROM_HEADER, unused } from "./conversation-state.js";
-export { fold, heard } from "./fold.js";

package/coordinator-state.d.ts

@@ -1,28 +0,0 @@
-import type { Fs } from "webappwiz/system";
-import type { KeptShell } from "./dev-shell.js";
-/**
- * What one `splates server` keeps across its own restarts, in
- * `~/.splates/coordinator.json`: the session id its workers know it by, so a
- * worker finds the next run unchanged and keeps every agent it runs for it,
- * and the roots of the projects whose agents it let go of at its last
- * restart, for the next run to serve before the worker joins and take them
- * back, and the shells it let go of, for the next run to take back too.
- */
-export declare class CoordinatorState {
-    readonly path: string;
-    private readonly fs;
-    /** What this coordinator's worker sessions answer as, the same across restarts. */
-    readonly session: string;
-    /** The projects with agents on the worker at the last restart; none after a fresh start. */
-    readonly roots: string[];
-    /** The pages' shells on the worker at the last restart, by key. */
-    readonly terminals: KeptShell[];
-    private constructor();
-    /**
-     * Reads what the last run kept at `path`, or starts afresh with a session
-     * of its own, written there so the next run answers as the same.
-     */
-    static open(path: string, fs: Fs): Promise<CoordinatorState>;
-    /** Keeps `roots` as the projects whose agents, and `terminals` as the shells, the next run takes back. */
-    write(roots: string[], terminals: KeptShell[]): Promise<void>;
-}

package/darwin-temperature.d.ts

@@ -1,7 +0,0 @@
-/**
- * The hottest CPU die sensor on an Apple Silicon Mac, in °C, or null when
- * none answers. macOS has no public API for these, and `powermetrics` needs
- * sudo, so this asks IOKit's private HID event system the way macmon and
- * Stats do, which any user may.
- */
-export declare function darwinTemperature(): number | null;

package/decided.d.ts

@@ -1,18 +0,0 @@
-import type { Outcome } from "./outcomes.js";
-import type { Decision } from "./plan.js";
-/**
- * Who made `decision`: the person, for one put to them or an assumption
- * they challenged, which took their attention either way; otherwise the
- * agent, whose assumption stood without them.
- */
-export declare function whose(decision: Pick<Decision, "how" | "ended">): "decidedByYou" | "decidedByAgents";
-/** How many calls in `outcome` `who` made. */
-export declare function madeBy(outcome: Outcome, who: ReturnType<typeof whose>): number;
-/**
- * The calls `outcome` made, each with how many it stands for: its own
- * decisions one each, or for a line from before they were kept, its counts
- * read back as unsized calls.
- */
-export declare function decided(outcome: Outcome): [Pick<Decision, "size" | "how" | "ended">, number][];
-/** Whether `outcome` kept its calls at all: lines from before any were kept say nothing of them. */
-export declare function keptDecisions(outcome: Outcome): boolean;

package/demo.d.ts

@@ -1,29 +0,0 @@
-/**
- * Something to try, as the skill writes it under `### 🎬 Demo: <title>`:
- * where, then numbered steps.
- */
-export interface Demo {
-    /** What it shows, from its heading; null when the heading says none. */
-    title: string | null;
-    /** Where to try it and anything said before the steps, as markdown. */
-    intro: string;
-    steps: Step[];
-}
-/** A step of a demo: what to do, on its line, and what to see, under it. */
-export interface Step {
-    number: string;
-    action: string;
-    /** What should happen, screenshots included, as markdown. */
-    expect: string;
-}
-/**
- * The demo titled at `start`: what it says up to its steps, or to `until`,
- * where something else begins, then its steps, and the line after them; null
- * for any other line.
- */
-export declare function demoAt(lines: string[], start: number, until: number): {
-    demo: Demo;
-    end: number;
-} | null;
-/** Whether `line` titles a demo. */
-export declare function isDemoTitle(line: string): boolean;

package/dev/api.d.ts

@@ -1,209 +0,0 @@
-/**
- * The page's writes: the same core functions as `splates todo add`, `update`
- * and `remove`, and the lanes' own.
- * A refusal comes back as the CLI's own reason and message, thrown so the
- * caller can show it.
- */
-import type { HeavyJobsReading } from "webappwiz/system";
-import type { KeptCred, Scope } from "../creds.js";
-import type { PortLink } from "../dev-task-ports.js";
-import type { FileDiff } from "../diff.js";
-import type { Landed } from "../landed.js";
-import type { MachineReading } from "../machine.js";
-import type { Wants } from "../notices.js";
-import type { AgentPick } from "../roster.js";
-import type { SetupProgress } from "../setup.js";
-import type { PeriodId, Stats } from "../stats.js";
-import type { SystemsReport } from "../system-changes.js";
-import type { NamedSystem } from "../systems.js";
-export declare class ApiError extends Error {
-    readonly reason: string;
-    constructor(reason: string, message: string);
-}
-/**
- * `path` for the project this page shows: the one `?project=` names, or none
- * for the one `splates server` started in, unless `path` names one itself. Every
- * request the page makes goes through here.
- */
-export declare function scoped(path: string): string;
-/**
- * POSTs to `path` for this project, or as `init` says, answering with the
- * body, or throwing the refusal as an `ApiError`.
- */
-export declare function send(path: string, init: RequestInit): Promise<unknown>;
-/** A todo's files: new ones to add, and the stored ones to keep. */
-export interface FilesForm {
-    files: File[];
-    /** Paths of files already stored to keep; the rest are dropped. */
-    keep: string[];
-}
-/** What a todo says: a line, and whatever more there is to say. */
-export interface TodoForm {
-    subject: string;
-    text: string;
-    /** Where it goes in the list, 1 at the top; absent leaves it be. */
-    position?: number;
-}
-/** Adds a todo at the bottom of `lane`, or of the untriaged ones for null. */
-export declare function addTodo({ subject, text, position }: TodoForm, files: File[], lane?: number | null): Promise<void>;
-export declare function updateTodo(id: number, { subject, text, position, files, keep }: FilesForm & TodoForm): Promise<void>;
-/** Puts a todo at `position`, 1 at the top, moving the rest around it. */
-export declare function moveTodo(id: number, position: number): Promise<void>;
-/** `send` with `body` as JSON, by `method`. */
-export declare function sendJson(path: string, method: string, body: unknown): Promise<unknown>;
-/** Says `id` is blocked by exactly the todos in `blockedBy`, no more and no fewer. */
-export declare function linkTodo(id: number, blockedBy: number[]): Promise<void>;
-/**
- * Puts a todo in `lane` (`"new"` for one of its own, null for none), just
- * above the todo `before`, or at the bottom of the lane without one.
- */
-export declare function arrangeTodo(id: number, lane: number | "new" | null, before?: number, 
-/** What to call a new lane; named after the todo without one. */
-name?: string): Promise<void>;
-/** Has `assignee` work todo `id`, or nobody in particular for null. */
-export declare function assignTodo(id: number, assignee: AgentPick | null): Promise<void>;
-/** Moves lane `from`'s todos to the bottom of lane `into`. */
-export declare function joinLanes(from: number, into: number): Promise<void>;
-/** Starts an empty lane called `name`, after the others. */
-export declare function addLane(name: string): Promise<void>;
-/** Calls lane `id` by another name. */
-export declare function renameLane(id: number, name: string): Promise<void>;
-/** Puts lane `id` at `position` among the lanes, 1 the first column. */
-export declare function moveLane(id: number, position: number): Promise<void>;
-/** Removes lane `id`, putting its todos back with the untriaged ones. */
-export declare function dropLane(id: number): Promise<void>;
-/** Removes a todo, kept for `restoreTodo` to put back. */
-export declare function removeTodo(id: number): Promise<void>;
-/** Puts back a todo `removeTodo` removed, under its id, where it stood. */
-export declare function restoreTodo(id: number): Promise<void>;
-/** Where the page loads a file a todo holds. */
-export declare function fileUrl(path: string): string;
-/**
- * The files and directories (ending in `/`) a task's tree holds, or the main
- * tree's for none: what `@` offers.
- */
-export declare function paths(task?: string): Promise<string[]>;
-/** Every system `task`'s worktree names, or the main tree's for none. */
-export declare function systems(task?: string): Promise<NamedSystem[]>;
-/** What each system holds on trunk, and the commits that lately changed it. */
-export declare function systemChanges(): Promise<SystemsReport>;
-/** What `task` changed against its base, uncommitted edits included. */
-export declare function taskDiff(task: string): Promise<FileDiff[]>;
-/**
- * How `task` went once it merged, beside its project's week before; null
- * when it never merged here.
- */
-export declare function taskOutcome(task: string): Promise<Landed | null>;
-/**
- * Gives `task`, escalated once it spent its merge attempts, another round of
- * them, as `splates retry` does.
- */
-export declare function retryTask(task: string): Promise<void>;
-/**
- * `splates remove` for `task`, past any lease, stopping each conversation in
- * its tree and moving it to the main tree.
- */
-export declare function removeTask(task: string): Promise<void>;
-/**
- * How tasks ended across every project, summed for the Stats page over
- * `period`.
- */
-export declare function stats(period: PeriodId): Promise<Stats>;
-/**
- * The email Cloudflare Access signed this page's visitor in with, or null
- * when the page is opened on this machine or Access is off.
- */
-export declare function identity(): Promise<string | null>;
-/**
- * Each port a task serves now, with its link through the ports host, if one
- * is saved, and on the machine `splates server` runs on.
- */
-export declare function taskPorts(): Promise<PortLink[]>;
-/** What the page shows of the machine: its reading, and its heavy jobs. */
-export type MachineStatus = MachineReading & {
-    heavy: HeavyJobsReading;
-};
-/** How hard the machine `splates server` runs on is working right now. */
-export declare function machine(): Promise<MachineStatus>;
-/** This machine's setup: every step checked, by area, and the one to do next. */
-export declare function setup(): Promise<SetupProgress>;
-/** Skips setup step `step`, or asks for it again, answering the fresh progress. */
-export declare function skipSetupStep(step: string, skipped: boolean): Promise<SetupProgress>;
-/** Marks setup seen on this machine, so the page stops nudging towards it. */
-export declare function seeSetup(): Promise<SetupProgress>;
-/** The public key this device subscribes to the server's pushes with. */
-export declare function pushKey(): Promise<string>;
-/** Has the server push this device the notices `wants` asks for, at `subscription`. */
-export declare function subscribePush(subscription: PushSubscriptionJSON, wants: Wants & {
-    inFront: boolean;
-}): Promise<void>;
-/** Has the server stop pushing to the subscription `endpoint` names. */
-export declare function unsubscribePush(endpoint: string): Promise<void>;
-/** What the project's store and the device's keep, by name, and what each store is called. */
-export interface KeptCreds {
-    kept: KeptCred[];
-    labels: Record<Scope, string>;
-}
-/** The creds kept for this project and this device; never a value. */
-export declare function keptCreds(): Promise<KeptCreds>;
-/**
- * Keeps `value` as `name`: in the scope its open request asked for, else in
- * `scope`. The value goes to the store and never comes back.
- */
-export declare function saveCred(name: string, value: string, scope?: Scope): Promise<void>;
-export declare function removeCred(name: string, scope: Scope): Promise<void>;
-/** Turns down the open request for `name`, so the agent waiting on it stops. */
-export declare function dismissCred(name: string): Promise<void>;
-/**
- * Where a project's scry budgets stand, as `splates dev scry budgets --format json`
- * prints it; splates only passes it on, so this mirrors the CLI's type.
- */
-export interface Budgets {
-    /** Whether any config or change declares budgets. */
-    declared: boolean;
-    roles: RoleBudget[];
-}
-/** Where one model's budget stands. */
-export interface RoleBudget {
-    role: "som" | "llm";
-    /** Like `5m/day`, `nothing` or `unlimited`; none when undeclared. */
-    spend: string | null;
-    /** The config or file that declared it. */
-    from: string | null;
-    /** Whether it was set here, over the configs. */
-    set: boolean;
-    standing: {
-        /** Like `today` or `the last 7d`. */
-        window: string;
-        tokens: number;
-        raised: number;
-        spent: number;
-        left: number;
-    }[];
-    raises: {
-        id: number;
-        tokens: number;
-        from: number;
-        until: number;
-    }[];
-    /** The pause stopping it asking anything; none when it asks as it may. */
-    paused: {
-        from: number;
-        until: number;
-    } | null;
-}
-export declare function budgets(): Promise<Budgets>;
-/** Sets what `role` may spend here, like `5m/day`; null gives it back to the configs. */
-export declare function setBudget(role: RoleBudget["role"], spend: string | null): Promise<Budgets>;
-/** Adds `tokens`, like `2m`, to each of `role`'s limits `span`, like `1d`. */
-export declare function raiseBudget(role: RoleBudget["role"], tokens: string, span: string): Promise<Budgets>;
-/** Stops `role` asking anything for `span`, like `1d`. */
-export declare function pauseBudget(role: RoleBudget["role"], span: string): Promise<Budgets>;
-/** Lets a paused `role` ask again before its pause ends. */
-export declare function resumeBudget(role: RoleBudget["role"]): Promise<Budgets>;
-export declare function endRaise(id: number): Promise<Budgets>;
-/**
- * Opens `path` in `editor` on this machine, inside the tree it belongs to,
- * at `line` when there is one.
- */
-export declare function openFile(editor: string, path: string, line: number | null): Promise<void>;

package/dev/assets.d.ts

@@ -1,24 +0,0 @@
-/** The files the browser asks for, as the server hands them over. */
-export interface Assets {
-    /** The page, which asks for the rest. */
-    shell: string;
-    /** The React app, bundled for the browser. */
-    script: string;
-    /** The React app's source map, which DevTools asks for while open. */
-    scriptMap: string;
-    /** The stylesheet, with Tailwind already compiled. */
-    styles: string;
-    /** The service worker, through which a phone shows notifications. */
-    worker: string;
-    /** The service worker's source map. */
-    workerMap: string;
-    /** The web app manifest, which makes the page installable as an app. */
-    manifest: string;
-    /** The app icon as PNG, at 192px and 512px square. */
-    icons: {
-        192: Uint8Array<ArrayBuffer>;
-        512: Uint8Array<ArrayBuffer>;
-    };
-}
-/** The page this package ships. Serve each field's contents as-is. */
-export declare const assets: Assets;