@stringsync/splates 0.0.53 → 0.0.55

package/lane.d.ts

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

package/notes.d.ts

@@ -0,0 +1,4 @@
+import type { Repository } from "@stringsync/splates-server/records";
+import type { SplatesDeps } from "@stringsync/splates-server/server";
+/** Prints the descriptions in this checkout, or the project explicitly named. */
+export declare function notes(ctx: SplatesDeps & Repository): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@stringsync/splates",
-	"version": "0.0.53",
+	"version": "0.0.55",
 	"description": "Runs several AI coding agents on one repository at once, each in its own git worktree",
 	"license": "MIT",
 	"author": "stringsync LLC",
@@ -10,14 +10,6 @@
 		"directory": "packages/splates"
 	},
 	"type": "module",
-	"module": "index.ts",
-	"bin": {
-		"splates": "./index.ts",
-		"arbor": "./index.ts"
-	},
-	"exports": {
-		".": "./index.ts"
-	},
 	"engines": {
 		"bun": ">=1.3"
 	},
@@ -25,14 +17,20 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@stringsync/splates-server": "workspace:*",
+		"@stringsync/splates-server": "^0.0.55",
 		"webappwiz": "0.0.47",
 		"zod": "^4.4.3"
 	},
-	"devDependencies": {
-		"@types/bun": "1.3.14"
+	"main": "./index.js",
+	"types": "./index.d.ts",
+	"exports": {
+		".": {
+			"types": "./index.d.ts",
+			"default": "./index.js"
+		}
 	},
-	"scripts": {
-		"build": "bun run --cwd ../web build"
+	"bin": {
+		"splates": "./index.js",
+		"arbor": "./index.js"
 	}
 }

package/projects.d.ts

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

package/queue.d.ts

@@ -0,0 +1,3 @@
+import type { SplatesDeps } from "@stringsync/splates-server/server";
+/** `splates queue`, which the root cli mounts beside `splates task`. */
+export declare const splatesQueue: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/replica.d.ts

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

package/runners.d.ts

@@ -0,0 +1,3 @@
+import { type SplatesDeps } from "@stringsync/splates-server/server";
+/** `splates runners`, which the root cli mounts beside `splates worker`. */
+export declare const splatesRunners: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/server.d.ts

@@ -0,0 +1,6 @@
+import { type SplatesDeps } from "@stringsync/splates-server/server";
+/**
+ * `splates server`, which the root cli mounts after `splates log`: bare, it
+ * runs the server here.
+ */
+export declare const splatesServer: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/setup.d.ts

@@ -0,0 +1,22 @@
+import type { SplatesDeps } from "@stringsync/splates-server/server";
+import { Setup } from "@stringsync/splates-server/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;
+    /** Print what undoing the area `step` names would do. */
+    undo: 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>;
+/**
+ * This machine's setup, read through `deps`, for the project `--project`
+ * names or the repository the working directory is in, if either.
+ */
+export declare function setupOf(deps: SplatesDeps): Promise<Setup>;

package/slots.d.ts

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

package/splates.d.ts

@@ -0,0 +1,10 @@
+import type { SplatesDeps } from "@stringsync/splates-server/server";
+/**
+ * Splits a leading `--project <slug>`, or `--project=<slug>`, off the
+ * arguments, for `run` to be handed as `project`.
+ */
+export declare function projectArgs(argv: string[]): {
+    project?: string;
+    argv: string[];
+};
+export declare const splates: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/task.d.ts

@@ -0,0 +1,3 @@
+import type { SplatesDeps } from "@stringsync/splates-server/server";
+/** `splates task`, the queue, which the root cli mounts after the commands for the task you work on. */
+export declare const splatesTask: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/tunnel.d.ts

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

package/waiting.d.ts

@@ -0,0 +1,3 @@
+import type { SplatesDeps } from "@stringsync/splates-server/server";
+/** `splates worker queue`, which `splates worker` mounts. */
+export declare const splatesWaiting: import("webappwiz/cmd").Cli<SplatesDeps, SplatesDeps>;

package/worker.d.ts

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

package/artifact.ts

@@ -1,120 +0,0 @@
-import { basename, resolve } from "node:path";
-import {
-	addArtifact,
-	listArtifacts,
-	removeArtifact,
-} from "@stringsync/splates-server/artifacts";
-import { commaList } from "@stringsync/splates-server/comma-list";
-import { conversationOf } from "@stringsync/splates-server/conversations";
-import { fail } from "@stringsync/splates-server/exit";
-import { repository } from "@stringsync/splates-server/records";
-import type { SplatesDeps } from "@stringsync/splates-server/server";
-import { cli } from "webappwiz/cmd";
-import { z } from "zod";
-import { here } from "./flags";
-
-/** `splates artifact`, which the root cli mounts after `splates attach`. */
-export const splatesArtifact = cli<SplatesDeps>("artifact").description(
-	"files your conversation made as its outputs, such as a screenshot, a recording or an HTML page: kept by name for the life of the conversation, whatever task it was made in, and listed on the `splates server` page beside its thread. A file that shows a question or a demo step is no artifact: `splates attach` it. The conversation is $SPLATES_CONVERSATION, or --conversation <id> from an agent outside `splates server`",
-);
-
-const conversation = [
-	"conversation",
-	z.string(),
-	{
-		default: "",
-		description:
-			"conversation id, when not run by an agent `splates server` started",
-	},
-] as const;
-
-splatesArtifact
-	.command("add")
-	.use(repository({ needs: "own" }))
-	.description(
-		"keep files as artifacts of this conversation, each named for its basename, or by --name when there is one; adding a name the conversation holds makes its next version, earlier ones kept until cleanup takes them. Past the project's limit (artifactProjectCapacity), `splates server` first evicts the oldest bytes the project keeps: removed and replaced versions, then what archived conversations show, then what live ones do. Past the file or conversation limit (artifactFileCapacity, artifactConversationCapacity), or the project's when even that would not make room, it stops with `too_large`, changing nothing for that file",
-	)
-	.arg("files", z.string(), { description: "files to keep, comma separated" })
-	.option("name", z.string(), {
-		default: "",
-		description: "the artifact's name; for one file only",
-	})
-	.option(...conversation)
-	.action(async (opts, ctx) => {
-		const paths = commaList(opts.files);
-		if (paths.length === 0) {
-			fail("usage", "name the files to keep: nothing was changed");
-		}
-		if (opts.name !== "" && paths.length > 1) {
-			fail("usage", "--name names one file: nothing was changed");
-		}
-		const id = await conversationOf(ctx.service, opts.conversation);
-		const files = await Promise.all(
-			paths.map(async (given) => {
-				const path = resolve(ctx.ps.cwd(), given);
-				const bytes = await ctx.fs.readBytes(path).catch(() => null);
-				if (bytes === null) {
-					fail("usage", `cannot read ${path}: nothing was changed`, {
-						file: path,
-					});
-				}
-				return { name: opts.name || basename(path), bytes };
-			}),
-		);
-		const task = await here(ctx);
-		for (const file of files) {
-			await ctx.journal.record(
-				"artifact add",
-				task,
-				() => addArtifact(ctx, id, file),
-				(added) => ({
-					name: file.name,
-					version: added.version,
-					bytes: added.bytes,
-				}),
-			);
-		}
-	});
-
-splatesArtifact
-	.command("remove")
-	.use(repository({ needs: "own" }))
-	.description(
-		"stop listing the artifact of that name, every version kept until cleanup takes them; adding the name again lists it again",
-	)
-	.arg("name", z.string(), { description: "the artifact's name" })
-	.option(...conversation)
-	.action(async (opts, ctx) => {
-		const id = await conversationOf(ctx.service, opts.conversation);
-		await ctx.journal.record(
-			"artifact remove",
-			await here(ctx),
-			() => removeArtifact(ctx, id, opts.name),
-			(version) => ({ name: opts.name, version }),
-		);
-	});
-
-splatesArtifact
-	.command("list")
-	.use(repository({ needs: "own" }))
-	.description(
-		"the artifacts this conversation lists, and their current version",
-	)
-	.option(...conversation)
-	.action(async (opts, ctx) =>
-		listArtifacts(ctx, await conversationOf(ctx.service, opts.conversation)),
-	);
-
-splatesArtifact
-	.command("show")
-	.use(repository({ needs: "own" }))
-	.description("every version of an artifact, and which is current")
-	.arg("name", z.string(), { description: "the artifact's name" })
-	.option(...conversation)
-	.action(async (opts, ctx) =>
-		listArtifacts(
-			ctx,
-			await conversationOf(ctx.service, opts.conversation),
-			opts.name,
-		),
-	);

package/budget.ts

@@ -1,117 +0,0 @@
-import type { SplatesDeps } from "@stringsync/splates-server/server";
-import {
-	endBudgetRaise,
-	raiseBudget,
-	setBudget,
-	showBudget,
-} from "@stringsync/splates-server/workers";
-import { cli } from "webappwiz/cmd";
-import { z } from "zod";
-
-const DEV = {
-	default: "",
-	description:
-		"the `splates server` to ask, a URL such as http://localhost:4310; by default the one an agent runs under, from SPLATES_DEV",
-};
-
-const JSON_OPTION = { default: false, description: "emit JSON" };
-
-const LIMIT = z.enum(["hour", "day", "month"]);
-
-const LIMIT_ARG = {
-	description:
-		"hour, the rate cap on what made workers running at once cost an hour; day; or month",
-};
-
-/** `splates budget`, which the root cli mounts beside `splates worker`. */
-export const splatesBudget = cli<SplatesDeps>("budget").description(
-	"what the workers a `workerProvider` makes may cost, in dollars: a rate cap per hour on those running at once ($0.25/h by default), and limits on a day ($5) and a month ($75). Past the rate cap, or once a day's or month's limit is spent, no worker is made and the queue says why; reaching the day's or month's stops made workers, whose agents stop at their checkpoint. Each warns at 80%, 90% and 100% by Web Push and on the page's header. Spend is an estimate at each type's list price. Agents' own API spend is not counted here",
-);
-
-splatesBudget
-	.command("show")
-	.description(
-		"show each limit: what made workers spent in its window, of how much, and what is left",
-	)
-	.option("dev", z.string(), DEV)
-	.option("json", z.boolean(), JSON_OPTION)
-	.action((opts, ctx) =>
-		showBudget({
-			dev: opts.dev,
-			json: opts.json,
-			log: ctx.log,
-			fs: ctx.fs,
-			ps: ctx.ps,
-			send: ctx.fetch,
-		}),
-	);
-
-splatesBudget
-	.command("set")
-	.description(
-		"set a limit, in dollars (dollars an hour for hour), then show the budget",
-	)
-	.arg("limit", LIMIT, LIMIT_ARG)
-	.arg("dollars", z.string(), {
-		description: "like 5 or 0.25, or `default` to give it back to its default",
-	})
-	.option("dev", z.string(), DEV)
-	.option("json", z.boolean(), JSON_OPTION)
-	.action((opts, ctx) =>
-		setBudget({
-			limit: opts.limit,
-			dollars: opts.dollars,
-			dev: opts.dev,
-			json: opts.json,
-			log: ctx.log,
-			fs: ctx.fs,
-			ps: ctx.ps,
-			send: ctx.fetch,
-		}),
-	);
-
-splatesBudget
-	.command("raise")
-	.description(
-		"add dollars to a limit for a while, on top of what it is set to, then show the budget",
-	)
-	.arg("limit", LIMIT, LIMIT_ARG)
-	.arg("dollars", z.string(), { description: "how much to add, like 2 or 0.1" })
-	.option("for", z.string(), {
-		default: "1d",
-		description:
-			"how long it lasts, in hours, days or weeks, like 24h, 1d or 2w",
-	})
-	.option("dev", z.string(), DEV)
-	.option("json", z.boolean(), JSON_OPTION)
-	.action((opts, ctx) =>
-		raiseBudget({
-			limit: opts.limit,
-			dollars: opts.dollars,
-			for: opts.for,
-			dev: opts.dev,
-			json: opts.json,
-			log: ctx.log,
-			fs: ctx.fs,
-			ps: ctx.ps,
-			send: ctx.fetch,
-		}),
-	);
-
-splatesBudget
-	.command("end")
-	.description("end a raise now, by the number `show` gives it")
-	.arg("id", z.coerce.number().int(), { description: "the raise's number" })
-	.option("dev", z.string(), DEV)
-	.option("json", z.boolean(), JSON_OPTION)
-	.action((opts, ctx) =>
-		endBudgetRaise({
-			id: opts.id,
-			dev: opts.dev,
-			json: opts.json,
-			log: ctx.log,
-			fs: ctx.fs,
-			ps: ctx.ps,
-			send: ctx.fetch,
-		}),
-	);

package/checkout.ts

@@ -1,8 +0,0 @@
-// What `bin/splates` runs from a checkout: the published program with `dev`
-// mounted, the commands for working on this repository. No `bin` or `exports`
-// entry names this file, so a release bundles none of it.
-import { mountDev } from "./dev";
-import { splates } from "./splates";
-
-mountDev(splates);
-await import("./index");