@stringsync/splates 0.0.45 → 0.0.47

package/cloudflare-api.d.ts

@@ -1,25 +0,0 @@
-import { z } from "zod";
-/** Where Cloudflare's v4 API answers. */
-export declare const CLOUDFLARE_API = "https://api.cloudflare.com/client/v4";
-/**
- * The few calls `splates tunnel setup` makes of Cloudflare's v4 API, over plain
- * `fetch` rather than the `cloudflare` SDK, which every `bunx` of splates would
- * download for some ten endpoints. Each answer's result is checked against
- * the shape the caller names, so a field that moved fails here, saying where.
- */
-export declare class CloudflareApi {
-    private readonly token;
-    private readonly fetch;
-    constructor(token: string, opts?: {
-        fetch?: typeof fetch;
-    });
-    get<T>(path: string, shape: z.ZodType<T>): Promise<T>;
-    /** Every item of the list at `path`, page after page. */
-    list<T>(path: string, item: z.ZodType<T>): Promise<T[]>;
-    post<T>(path: string, body: unknown, shape: z.ZodType<T>): Promise<T>;
-    put<T>(path: string, body: unknown, shape: z.ZodType<T>): Promise<T>;
-    patch<T>(path: string, body: unknown, shape: z.ZodType<T>): Promise<T>;
-    /** Deletes what is at `path`, whatever Cloudflare answers with. */
-    delete(path: string): Promise<void>;
-    private call;
-}

package/cloudflare-error.d.ts

@@ -1,5 +0,0 @@
-/** A call Cloudflare refused, with the HTTP status it answered. */
-export declare class CloudflareError extends Error {
-    readonly status: number;
-    constructor(status: number, message: string);
-}

package/cloudflared-tunnel-provider.d.ts

@@ -1,27 +0,0 @@
-import type { AsyncResource } from "webappwiz/disposable";
-import type { Ps } from "webappwiz/system";
-import type { TunnelProvider, TunnelRoute } from "./tunnel-provider.js";
-/**
- * An `sh -c` script that runs the command after it, `sh -c GUARD sh <argv>`,
- * until the guard's stdin closes or a SIGTERM reaches it, and exits with the
- * command's status. Start it with stdin a pipe, so it dies with its parent.
- */
-export declare const GUARD: string;
-/**
- * A TunnelProvider over the `cloudflared` binary, running the named tunnel
- * the account already has, or the one its own config names, or, given a
- * token, the tunnel `splates tunnel setup` made, with no login or credentials
- * file. One that dies while running is logged, never fatal: the page still
- * answers on this machine.
- */
-export declare class CloudflaredTunnelProvider implements TunnelProvider {
-    private readonly ps;
-    private readonly name;
-    /** The tunnel's token, handed over in the environment, never the argv `ps` lists. */
-    private readonly token;
-    constructor(ps: Ps, name?: string | null, 
-    /** The tunnel's token, handed over in the environment, never the argv `ps` lists. */
-    token?: string | null);
-    ready(): Promise<void>;
-    run({ host, url, log }: TunnelRoute): AsyncResource;
-}

package/codex-limits.d.ts

@@ -1,19 +0,0 @@
-import { type Timer } from "webappwiz/time";
-import type { Agent, Launch, Limit } from "./conversations.js";
-/** Whether `agent` is Codex's ACP adapter, which says its limits only in `/status`. */
-export declare function isCodex(agent: Agent): boolean;
-/**
- * Asks Codex's app server, the one its ACP adapter runs, for the plan's
- * windows, since the adapter never sends them: a window Claude also has goes
- * by Claude's name, any other by its length, as `43200_minutes`. None when
- * Codex will not say.
- */
-export declare function codexLimits(deps: {
-    launch: Launch;
-    timer: Timer;
-    now: () => number;
-    /** Where it runs: anywhere does, since the plan is the account's. */
-    cwd: string;
-    /** Where `codex` is, as the adapter reads it; `codex` on the path otherwise. */
-    codex?: string;
-}): Promise<Limit[]>;

package/compaction.d.ts

@@ -1,17 +0,0 @@
-import type * as acp from "@agentclientprotocol/sdk";
-import type { Compaction, ConversationState } from "./conversation-state.js";
-/** Whether `update` reports a compaction rather than a tool call of the agent's. */
-export declare function isCompaction(update: acp.ToolCall | acp.ToolCallUpdate): boolean;
-/** Takes what an update says of the compaction into it. */
-export declare function fillCompaction(part: Compaction, update: acp.ToolCall | acp.ToolCallUpdate, at: string | null): void;
-/** The compaction `id`, wherever in the conversation it was; null for none. */
-export declare function compactionIn(state: ConversationState, id: string): Compaction | null;
-/** A compaction `id` just begun at `at`, with nothing said of it yet. */
-export declare function newCompaction(id: string, at: string | null): Compaction;
-/**
- * Takes ACP's `compaction_update` into `part`: its status, and its summary,
- * which replaces the one kept, or clears it when null or empty.
- */
-export declare function updateCompaction(part: Compaction, update: acp.CompactionUpdate, at: string | null): void;
-/** Appends a `compaction_summary_chunk`'s text to the summary `part` keeps. */
-export declare function appendSummary(part: Compaction, chunk: acp.CompactionSummaryChunk): void;

package/config-source.d.ts

@@ -1,13 +0,0 @@
-/**
- * `source` typed by a type-only import of `ConfigFile` and `satisfies` rather
- * than by calling `defineConfig`, so a reader can import it without splates
- * installed; or null unless it imports `defineConfig` alone and calls it
- * once.
- */
-export declare function typedConfig(source: string): string | null;
-/**
- * `source` with the `systems` property of its outermost object taken out,
- * with its line when it has one to itself, or null unless there is exactly
- * one such property.
- */
-export declare function withoutSystems(source: string): string | null;

package/config.d.ts

@@ -1,98 +0,0 @@
-import type { TunnelProvider } from "./tunnel-provider.js";
-export interface Config {
-    /**
-     * The integration branch name. `merge` rebases a task onto this branch and
-     * then fast-forwards it to the result; new worktrees start from it.
-     */
-    trunk: string;
-    /** Directory holding one worktree per task, a sibling of the repo. */
-    worktreeRoot: string;
-    /** Command run by `add` in the new worktree, via `sh -c`. */
-    postCheckout: string | null;
-    /**
-     * Command run by `merge` after the rebase, before `preMerge`, via `sh -c`.
-     * A rebase can bring in a dependency the worktree has never installed, and
-     * whatever `preMerge` runs needs it.
-     */
-    postRewrite: string | null;
-    /**
-     * Command run by `merge` after the rebase, via `sh -c`. The last gate before
-     * the branch lands: a nonzero exit rolls the branch back and leaves the base
-     * untouched. Tests are the obvious thing to put here, but splates has no
-     * opinion; a repo with nothing to run leaves it null and merges on a green
-     * rebase alone.
-     */
-    preMerge: string | null;
-    /** How long since its last heartbeat before a task's lease is up for grabs. */
-    leaseStalenessMs: number;
-    /**
-     * How many agents one agent may have started at once: the tasks it
-     * handed out with `splates add --agent` and that are still out. A lane
-     * orchestrator hands out every todo that can go, each to an agent of
-     * its own. Past it, `add --agent` refuses, unless the person asked for
-     * more and it passes `--over-capacity`.
-     */
-    agentsPerAgent: number;
-    /** Failed `merge` attempts a task gets before it must escalate or be removed. */
-    mergeRetryCount: number;
-    /**
-     * How many removed task names to keep, so `remove` can say "already removed"
-     * rather than "never existed". A flat cap with no age policy: losing the
-     * oldest costs a nicer message and nothing else.
-     */
-    removedCapacity: number;
-    /**
-     * How many events the log holds before it is moved aside and a fresh one
-     * starts; moved files are kept for `LOG_KEPT_MS` (`journal.ts`).
-     */
-    logCapacity: number;
-    /**
-     * How long a todo can wait before `merge` stops recommending it and offers
-     * it for removal instead: work deferred that long has usually been done
-     * some other way, or stopped mattering.
-     */
-    todoStalenessMs: number;
-    /**
-     * How many bytes of files `splates attach` lets one task hold, all of them
-     * together: a screen recording is the one thing here that grows fast.
-     */
-    attachmentCapacity: number;
-    /** How many bytes one artifact a conversation keeps may be (`artifacts.ts`). */
-    artifactFileCapacity: number;
-    /**
-     * How many bytes of artifacts one conversation may keep, every version
-     * whose bytes have not been deleted.
-     */
-    artifactConversationCapacity: number;
-    /** How many bytes of artifacts every conversation in the project may keep together. */
-    artifactProjectCapacity: number;
-    /**
-     * The command the `splates server` Budget page runs `scry budgets` with, from
-     * the repo's root. Leave it unset when the repo installs `@webappwiz/cli`;
-     * name a wrapper of the repo's own otherwise, like `"./bin/splates dev"`.
-     */
-    wiz: string;
-    /**
-     * What carries `splates server --tunnel` to its public host, a TunnelProvider
-     * of your own for any tunnel; null runs `cloudflared`.
-     */
-    tunnel: TunnelProvider | null;
-}
-/**
- * What `splates.config.ts` exports as its default, typed by a type-only import
- * so a reader can import the file without splates installed:
- *
- * ```ts
- * import type { ConfigFile } from "@stringsync/splates/config";
- *
- * export default { preMerge: "bun test" } satisfies ConfigFile;
- * ```
- */
-export type ConfigFile = Partial<Config>;
-/**
- * Types a config written before `ConfigFile`, which wraps its default in
- * `defineConfig(...)`, so it still loads until `splates update` rewrites it.
- *
- * @deprecated `satisfies ConfigFile` instead.
- */
-export declare function defineConfig(config: Partial<Config>): Partial<Config>;

package/config.js

@@ -1,7 +0,0 @@
-// config.ts
-function defineConfig(config) {
-  return config;
-}
-export {
-  defineConfig
-};

package/conversation-archive.d.ts

@@ -1,6 +0,0 @@
-import type { ConversationHost } from "./conversation-host.js";
-/** Records archive membership and its timestamp together. */
-export declare function put(host: ConversationHost, { archived, with: withConversation, }: {
-    archived: boolean;
-    with?: string | undefined;
-}): Promise<void>;

package/conversation-background.d.ts

@@ -1,21 +0,0 @@
-import type { AgentConnection } from "./agent-connection.js";
-import type { ConversationDeps, ConversationHost } from "./conversation-host.js";
-/**
- * The commands the agent left running in the background, as the
- * conversation's state lists them: what each has printed, and stopping one.
- */
-export declare class ConversationBackground {
-    private readonly host;
-    private readonly deps;
-    private readonly connection;
-    constructor(host: ConversationHost, deps: ConversationDeps, connection: AgentConnection);
-    /** Stops background command `id`, leaving the agent's turn as it is. */
-    stop(id: string): Promise<void>;
-    /**
-     * What background command `id` has printed, then more as it prints it,
-     * ending once the command has and all of it is read.
-     */
-    output(id: string): ReadableStream<Uint8Array>;
-    /** Background command `id`, refusing one the agent never left. */
-    private command;
-}

package/conversation-choice.d.ts

@@ -1,4 +0,0 @@
-import type { AgentConnection } from "./agent-connection.js";
-import type { ConversationHost } from "./conversation-host.js";
-/** Applies a validated user choice to the session and its log. */
-export declare function choose(host: ConversationHost, connection: AgentConnection, id: string, value: string): Promise<void>;

package/conversation-files.d.ts

@@ -1,51 +0,0 @@
-import type * as acp from "@agentclientprotocol/sdk";
-import type { Fs } from "webappwiz/system";
-import type { ProjectRoster } from "./conversation-host.js";
-import type { Message, Sent, Upload } from "./conversation-state.js";
-/**
- * The files the person sent in a conversation, kept beside its log in a
- * directory named for it, and how what they said goes to the agent.
- */
-export declare class ConversationFiles {
-    private readonly fs;
-    /** Where the files are kept. */
-    private readonly dir;
-    private readonly projects;
-    private readonly home;
-    constructor(log: string, fs: Fs, { projects, home, }?: {
-        /** The splates projects on this machine, for `#slug`; null for none. */
-        projects?: ProjectRoster | null;
-        /** The main tree of the project the conversation is in; null for none. */
-        home?: string | null;
-    });
-    /**
-     * Saves each file beside the log, named for what is in it, so the page
-     * reads it by name rather than with every change to the conversation.
-     * An image goes to the agent as itself when it `sees` images; anything
-     * else, as a link to where it is kept, which every agent takes.
-     */
-    keep(files: Upload[], sees: boolean): Promise<Sent[]>;
-    /** The file `name` the person sent in `messages`, or null when they sent none by that name. */
-    attachment(name: string, messages: Message[]): Promise<{
-        bytes: Uint8Array;
-        mimeType: string;
-    } | null>;
-    /**
-     * What `messages` say, as one prompt: their images, links to their other
-     * files, then their words, with a line on each system they name in
-     * `tree`, the one the agent runs in (none for a log too old to say), one
-     * on where each project they name sits, and one on reading them as speech
-     * when any was dictated.
-     */
-    content(messages: Message[], tree: string | null, sees?: boolean): Promise<acp.ContentBlock[]>;
-    /** Deletes every file kept, for good. */
-    remove(): Promise<void>;
-    /**
-     * A line on each system, conversation UUID and project `text` mentions with `#`,
-     * then one on each `#word` that names neither, for the agent alone: the
-     * thread keeps the words as typed. Read from `tree` and the projects as
-     * it goes, so a system named there a moment ago counts. A system wins
-     * over a project of the same name.
-     */
-    private namedIn;
-}

package/conversation-given.d.ts

@@ -1,8 +0,0 @@
-import type { WorktreeService } from "./worktree-service.js";
-/**
- * The conversation a command is about: `given` from `--conversation`, for an
- * agent outside `splates server`, else the one `splates server` started this agent in
- * ($SPLATES_CONVERSATION). Refuses `usage` when neither names one of this
- * repository's.
- */
-export declare function conversationOf(service: WorktreeService, given: string): Promise<string>;

package/conversation-host.d.ts

@@ -1,102 +0,0 @@
-import type { Events } from "webappwiz/events";
-import type { IdProvider } from "webappwiz/id";
-import type { Fs, Lock } from "webappwiz/system";
-import type { Timer, WallClock } from "webappwiz/time";
-import type { Agent, Launcher } from "./agent-process.js";
-import type { ArtifactRoom } from "./artifact-room.js";
-import type { ArtifactLimits } from "./artifacts.js";
-import type { ConversationLog } from "./conversation-log.js";
-import type { ConversationState } from "./conversation-state.js";
-import type { Reach } from "./projects.js";
-import type { SessionServers } from "./shared-browser.js";
-import type { Watch } from "./watch.js";
-import type { WorkerMachine } from "./worker-machine.js";
-/**
- * What a conversation's parts, its connection, its turns and its background
- * commands, share of it: its state and log, and the few things they do to
- * the whole. `Conversation` implements it.
- */
-export interface ConversationHost {
-    readonly state: ConversationState;
-    readonly log: ConversationLog;
-    readonly events: Events<ConversationEvents>;
-    /** What runs it; null when its agent is no longer known. */
-    readonly agent: Agent | null;
-    /** Where it runs; null for a log too old to say. */
-    readonly cwd: string | null;
-    /** Under way while the agent starts or comes back, for a prompt to wait on. */
-    readonly opening: Promise<void> | null;
-    now(): string;
-    set(next: Partial<ConversationState>): void;
-    changed(): void;
-    /** A turn ended, with `error` for one that failed. */
-    ended(error: string | null): void;
-    /** Ends the agent's process, with `error` for one that failed. */
-    close(error: string | null): Promise<void>;
-    /** Brings a stopped conversation back: a new process, the same session or a new one. */
-    resume(): Promise<void>;
-    /** Back on the list, stopped until the next prompt. */
-    unarchive(): Promise<void>;
-    /** Marks it `unread` or not. */
-    flag(unread: boolean): void;
-}
-export type ConversationEvents = {
-    changed: undefined;
-    chosen: string;
-};
-/** What every conversation in a repo is made with. */
-export interface ConversationDeps {
-    fs: Fs;
-    /** What names the files artifacts are kept in. */
-    ids: IdProvider;
-    /** How many bytes of artifacts it may keep (`artifacts.ts`). */
-    artifacts: ArtifactLimits;
-    /** What makes room for an add across the project; none refuses one past it. */
-    room?: ArtifactRoom;
-    timer: Timer;
-    clock: WallClock;
-    /** What starts each agent, and takes one back after a restart. */
-    launcher: Launcher;
-    /** Where the agent runs, which its background commands' output is read from. */
-    machine: WorkerMachine;
-    /**
-     * Hold it while an agent's process starts, until it answers
-     * `initialize`, so agents start one at a time.
-     */
-    starting: Lock;
-    /** Where `splates server` answers, for the agent's CLI to tell it things. */
-    url: string | null;
-    /** What watches the agent's commands; null to leave them be. */
-    watch: Watch | null;
-    /** The main tree, where a conversation carries on once its worktree is gone. */
-    root: string | null;
-    /** The splates projects on this machine, for `#slug`; null for none. */
-    projects: ProjectRoster | null;
-    /** The MCP servers each session is offered, beyond the agent's own; null for none. */
-    servers: SessionServers | null;
-}
-/** The splates projects on this machine, as `Projects` lists them. */
-export interface ProjectRoster {
-    /** Each project, flagged `gone` when its repository is no longer there. */
-    list(): Promise<(ProjectRef & {
-        gone: boolean;
-    })[]>;
-    /** What the project at `from` may do in the one at `to`. */
-    reach(from: string, to: string): Promise<Reach>;
-}
-/** A splates project a prompt can name as `#slug`. */
-export interface ProjectRef {
-    slug: string;
-    /** Its main tree's root. */
-    root: string;
-}
-/**
- * `changed`, `ended` (a turn ended, however it did, or the agent failed to
- * start) and `removed` each carry a conversation's id.
- */
-export type ConversationsEvents = {
-    settings: undefined;
-    changed: string;
-    ended: string;
-    removed: string;
-};

package/conversation-listing.d.ts

@@ -1,15 +0,0 @@
-import type { Conversations } from "./conversations.js";
-/** The conversations and saved agent defaults offered to the page. */
-export declare function listing(all: Conversations): Promise<{
-    agents: {
-        id: string;
-        name: string;
-        models: {
-            id: string;
-            name: string;
-        }[];
-        settings: import("./conversation-state.js").Setting[];
-        limits: import("./conversation-state.js").Limit[];
-    }[];
-    conversations: import("./conversation-state.js").ConversationState[];
-}>;