@stringsync/splates 0.0.53 → 0.0.55

package/README.md

@@ -62,7 +62,7 @@ Keep sensitive information out of them.
 **Heavy jobs.** Hooks (`postCheckout`, `postRewrite`, `preMerge`) run in one
 of the machine's heavy-job slots, two by default (`SPLATES_HEAVY_JOBS` sets
 how many), so several agents testing at once queue rather than run the
-machine out of memory. `splates heavy -- <command>` runs anything else as
+machine out of memory. `splates run -- <command>` runs anything else as
 heavy, such as a test suite an agent runs mid-task, in a slot too.
 
 **Pushing.** With `remote: "origin"` in `splates.config.ts`, each task's
@@ -253,26 +253,9 @@ serving on this machine.
 
 ### Worker providers
 
-To have splates make workers when agents queue for want of a slot, name the
-cloud account to make them in as `splates.config.ts`'s `cloud`, in the repo
-`splates server` starts in:
-
-```ts
-import { AwsCloud } from "@stringsync/splates-server/cloud";
-import type { ConfigFile } from "@stringsync/splates-server/config";
-
-export default { cloud: new AwsCloud() } satisfies ConfigFile;
-```
-
-`AwsCloud` comes with splates, signed with the AWS CLI's sign-in or the
-instance role. Another is a class that implements
-`CloudProvider` from `@stringsync/splates-server/cloud`: making, listing and
-deleting tagged machines, snapshots, SSH keys and firewalls through the
-cloud's API, with its machine types and prices. splates makes both the
-workers and the coordinator's box (`splates server deploy`) over it.
-
-For machines that are not a cloud's, give it a `workerProvider` instead, any
-object that implements `WorkerProvider`:
+To have splates make workers when agents queue for want of a slot, give
+`splates.config.ts` a `workerProvider`, in the repo `splates server` starts in,
+any object that implements `WorkerProvider`:
 
 ```ts
 import type { ConfigFile } from "@stringsync/splates-server/config";
@@ -306,9 +289,9 @@ rate cap, and `splates worker remove` destroys its machine.
 
 The worker budget is in dollars, at each type's list price, so every figure is
 an estimate: a rate cap on what the made workers running at once cost an hour
-($0.25/h by default), and limits on what they cost in a day ($5) and a month
-($75), from the start of each in local time. Past the rate cap no worker is
-made, and the queue says which limit holds it, as `rate cap $0.25/h reached`.
+($1/h by default), and limits on what they cost in a day ($15) and a month
+($200), from the start of each in local time. Past the rate cap no worker is
+made, and the queue says which limit holds it, as `rate cap $1.00/h reached`.
 Once a day's or month's limit is spent, made workers take nothing new, their
 agents are asked to stop at a checkpoint, and each is destroyed once its last
 agent ends. Each limit warns at 80%, 90% and 100%, once in its window, by Web

package/artifact.d.ts

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

package/budget.d.ts

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

package/creds.d.ts

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

package/flags.d.ts

@@ -0,0 +1,37 @@
+import { type AgentPick, Offered, type RosterAgent } from "@stringsync/splates-server/models";
+import type { Repository } from "@stringsync/splates-server/records";
+import type { SplatesDeps } from "@stringsync/splates-server/server";
+import { SavedTunnel } from "@stringsync/splates-server/tunnel";
+import { z } from "zod";
+/** A place in the queue, 1 at the top; absent leaves it to the command. */
+export declare const position: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+/**
+ * The agent `--agent`, `--model` and `--effort` name off the roster:
+ * undefined when none is given, null for `--agent none`.
+ */
+export declare function assigneeIn(deps: SplatesDeps, agent: string, model: string, effort: string): Promise<AgentPick | null | undefined>;
+/**
+ * `agent` on `model` off `agents`, at the thinking level `effort` names
+ * among those it offers, each left out when empty.
+ */
+export declare function pickIn(deps: SplatesDeps, agents: RosterAgent[], agent: string, model: string, effort: string, data?: Record<string, unknown>): Promise<AgentPick>;
+/**
+ * `{ effort }` for the thinking level `effort` names among those `agent`
+ * offered when last started, or nothing when it is empty.
+ */
+export declare function effortIn(deps: SplatesDeps, agent: string, effort: string, data?: Record<string, unknown>): Promise<{
+    effort?: string;
+}>;
+/** The settings each agent offered when last started, from any project. */
+export declare function offeredOf({ ps, fs }: SplatesDeps): Offered;
+/** The tunnel each slot's home may have saved, for every word of the pool. */
+export declare function slotTunnelsOf({ ps, fs, secrets, }: SplatesDeps): SavedTunnel[];
+/** `--lane 3`, `new` or `none` as a lane; absent leaves it to the command. */
+export declare function laneIn(raw: string): number | "new" | null | undefined;
+/** `--task 3,5` as task numbers, refusing anything that is not one. */
+export declare function taskIds(raw: string): number[];
+/**
+ * Which task a command that takes no task name is about, so the journal can
+ * name it. `merge` reads it off the current branch.
+ */
+export declare function here({ service, git, ps, project, }: SplatesDeps & Repository): Promise<string | null>;

package/handoff.d.ts

@@ -0,0 +1,13 @@
+/** Set by `checkout.ts` once `splates dev` is mounted on this process. */
+export declare const devMounted: {
+    value: boolean;
+};
+/** The nearest directory at or above `cwd` that is a splates checkout. */
+export declare function checkoutAbove(cwd: string): string | null;
+/**
+ * The release has no `splates dev`, and would print help and exit 0, which
+ * reads as a passing `splates dev test`. Standing in a checkout, run the
+ * checkout's own `bin/splates` instead; anywhere else, fail saying so.
+ * Returns the exit code, or null when `argv` is no `dev` command.
+ */
+export declare function handOffDev(argv: string[], cwd: string): Promise<number | null>;

package/hook.d.ts

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

package/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};