babavoss 0.12.6 → 0.13.0

package/src/runtime/harness.ts

@@ -6,7 +6,7 @@ import { manifestOf, type Baba } from "../ecs/baba.ts";
 import { Runtime, ContractError } from "../ecs/runtime.ts";
 import { StateError, type Snapshot } from "../ecs/state.ts";
 import { makeBridge, portOver } from "./bridge.ts";
-import { withPromptware } from "../promptware/system.ts";
+import { withInstructions } from "../agents/system.ts";
 
 /** How long a `state` read waits for the round past `since` before answering the state as it is. */
 export const STATE_WAIT_MS = 25_000;
@@ -23,7 +23,7 @@ export class Harness {
   /** Loads the baba over the snapshot given; answers `loaded`, or throws for `failed`. */
   load(own: Baba, project: { name: string; dir: string; baba: string }, env: Record<string, string>, snapshot: Snapshot | null, prepare = false): void {
     // Voss's own systems join every baba after its own.
-    const v = withPromptware(own);
+    const v = withInstructions(own);
     const manifest = manifestOf(v);
     const make = (snapshot: Snapshot | null, auto: boolean) => new Runtime(v, {
       auto,

package/src/shell/run.ts

@@ -9,7 +9,7 @@
 //   voss baba follow ENTITY | COMPONENT KEY [--until C | C.field=value] [--for 30s] [--changes]
 //   voss baba follow QUERY [args…] --changed [--for 30s]
 //   voss baba run [FILE | LINE …] | raw spawn JSON | add E COMPONENT [JSON] | remove E COMPONENT … | despawn E | set RESOURCE JSON
-//   voss baba check | install | add-system NAME | promptware … | serve [HOST:PORT]
+//   voss baba check | install | add-system NAME | agents … | serve [HOST:PORT]
 //   voss init [DIR] | babas … | gui [HOST:PORT] | service …
 //
 // Stdout is one line of JSON per answer (`--pretty` indents it); stderr is
@@ -30,8 +30,8 @@ import { serve } from "../http/server.ts";
 import { words, callArgs, usage, describeArgs, UsageError } from "./args.ts";
 import { init, install, addSystem } from "../baba/init.ts";
 import { check } from "../baba/check.ts";
-import { planProject, syncProject, outputOf, sources } from "../promptware/disk.ts";
-import { report } from "../promptware/sync.ts";
+import { planProject, syncProject, outputOf, sources } from "../agents/disk.ts";
+import { report } from "../agents/sync.ts";
 import * as service from "./service.ts";
 import { connect, daemon, type Client, type Daemon } from "./client.ts";
 import { runMcp } from "../mcp/main.ts";
@@ -131,7 +131,7 @@ const builtinHelp: Record<string, string> = {
   "add-system": "a system under .baba/systems/NAME: add-system NAME",
   serve: "the GUI for this baba alone: serve [HOST:PORT]",
   mcp: "an MCP server over stdio for agents, a client of the running voss",
-  promptware: "the harness files: promptware compile | sync | output PATH",
+  agents: "the agentic instructions compiled: agents compile | sync | output PATH",
 };
 
 /**
@@ -177,7 +177,7 @@ function globals(argv: string[]): { ws: string[]; pretty: boolean; max: number }
 
 export async function run(argv: string[], sh: Shell): Promise<number> {
   const reg = new Registry(sh.rootDir);
-  // Every answer is JSON; the promptware block below still reads this.
+  // Every answer is JSON; the agentic instructions block below still reads this.
   const json = true;
   let callUsage: string | undefined;
   let outDir: string | undefined;
@@ -304,7 +304,7 @@ export async function run(argv: string[], sh: Shell): Promise<number> {
     }
     if (name === "manifest") {
       // The baba loaded once, in this process, and let go: what every load writes, .baba/.voss/manifest.json, is there
-      // for the index, --schema and the promptware before the baba ever runs under the daemon, as in a fresh worktree.
+      // for the index, --schema and the agentic instructions before the baba ever runs under the daemon, as in a fresh worktree.
       const lines: string[] = [];
       const n = new Node(project, (l) => lines.push(l));
       try { await n.start(); } finally { await n.stop(); }
@@ -345,36 +345,36 @@ export async function run(argv: string[], sh: Shell): Promise<number> {
     const c = await connect(project, sh.rootDir, prog).catch(downOnly);
     const down = c instanceof NodeError ? c : null;
     const d = c instanceof NodeError ? null : await c.describe();
-    // Down, the promptware compiles from a manifest of the code as it is now: the baba is loaded once in this process and let
-    // go, as \`manifest\` does, so a fresh worktree has one and an edit to the promptware is in it. Busy or broken, the last one stands.
+    // Down, the agentic instructions compiles from a manifest of the code as it is now: the baba is loaded once in this process and let
+    // go, as \`manifest\` does, so a fresh worktree has one and an edit to the agentic instructions is in it. Busy or broken, the last one stands.
     let loadError: string | null = null;
-    if (down && name === "promptware") {
+    if (down && name === "agents") {
       const n = new Node(project, () => {});
       try { await n.start(); } catch (err) { loadError = err instanceof Error ? err.message : String(err); } finally { await n.stop().catch(() => {}); }
     }
     const m = d ? d.manifest : await readManifest(project);
     if (!m && loadError) throw new ShellError("failed", `${project.name} did not load: ${loadError}`);
     if (!m) { if (down) throw down; throw new ShellError("down", `${project.name} is not running${d?.error ? `: ${d.error}` : ""}`); }
-    if (name === "promptware") {
-      // Running, the baba's promptware system syncs, and the answer waits for it; down, the same compiler runs here over the files.
+    if (name === "agents") {
+      // Running, the baba's agents system syncs, and the answer waits for it; down, the same compiler runs here over the files.
       const [cmd, path] = args;
-      if (cmd === "sync" && d && !d.error && "promptware-sync" in m.actions) {
+      if (cmd === "sync" && d && !d.error && "agents-sync" in m.actions) {
         const live = c as Client;
-        const syncs = async () => await live.read("promptware-plan", {}) as { syncs: number; error: string | null };
+        const syncs = async () => await live.read("agents-plan", {}) as { syncs: number; error: string | null };
         const before = (await syncs()).syncs;
-        await live.fire("promptware-sync", {});
+        await live.fire("agents-sync", {});
         for (let i = 0; i < 200; i++) {
           const p = await syncs();
-          if (p.syncs > before) { if (p.error) return fail(`promptware sync: ${p.error}`); out(p); return 0; }
+          if (p.syncs > before) { if (p.error) return fail(`agents sync: ${p.error}`); out(p); return 0; }
           await new Promise((r) => setTimeout(r, 50));
         }
-        return fail("promptware sync: asked, not finished within 10s; promptware-plan says how it went");
+        return fail("agents sync: asked, not finished within 10s; agents-plan says how it went");
       }
       const input = sources(project.dir, m, project.title);
       if (cmd === "compile") { out(report(await planProject(project.dir, input))); return 0; }
       if (cmd === "sync") { out(await syncProject(project.dir, input)); return 0; }
       if (cmd === "output" && path) { const o = await outputOf(project.dir, input, path); out(json ? o : { path: o.path, status: o.status }); if (!json) sh.stdout(o.text); return 0; }
-      sh.stdout(`Usage: ${prog} promptware compile | sync | output PATH\n`);
+      sh.stdout(`Usage: ${prog} agents compile | sync | output PATH\n`);
       return help ? 0 : 2;
     }
     if (!name) {
@@ -462,7 +462,7 @@ function contract(prog: string, title: string, m: Manifest, error: string | null
   section("Resources", Object.entries(m.resources).map(([n, r]) => [n, r.owner]));
   section("Effects", Object.entries(m.effects).map(([n, e]) => [n, `${e.owner}${e.every ? ` · every ${e.every} ms` : ""}${e.retry ? ` · retry ${e.retry} ms` : ""}${e.summary ? ` · ${e.summary}` : ""}`]));
   section("The state", Object.entries(builtinHelp).filter(([k]) => ["state", "follow", "run", "raw"].includes(k)).map(([k, h]) => [k, h]));
-  section("Voss", Object.entries(builtinHelp).filter(([k]) => ["start", "stop", "status", "mcp", "check", "manifest", "install", "add-system", "serve", "promptware"].includes(k)).map(([k, h]) => [k, h]));
+  section("Voss", Object.entries(builtinHelp).filter(([k]) => ["start", "stop", "status", "mcp", "check", "manifest", "install", "add-system", "serve", "agents"].includes(k)).map(([k, h]) => [k, h]));
   lines.push(`State: ${where}${error ? ` · the last load failed: ${error}` : ""}`);
   return lines.join("\n") + "\n";
 }

package/src/spec/index.ts

@@ -91,7 +91,7 @@ export function spec(target: System | Baba, def: SpecDef<any, any> = {}): Spec<a
   if (!NAME.test(name)) throw new Error(`spec ${JSON.stringify(name)}: lowercase words joined by single dashes`);
   const base = whole ? (target as Baba) : baba({ systems: closureOf([target as System]) });
   const tick = def.tick === undefined ? base.tick : def.tick;
-  const v = tick === base.tick ? base : baba({ systems: base.systems, ...(tick !== null ? { tick } : {}), promptware: base.promptware, apps: base.apps });
+  const v = tick === base.tick ? base : baba({ systems: base.systems, ...(tick !== null ? { tick } : {}), instructions: base.instructions, apps: base.apps });
   const names = new Set<string>();
   for (const sc of def.scenarios ?? []) { if (names.has(sc.name)) throw new Error(`spec ${name}: two scenarios are named ${JSON.stringify(sc.name)}`); names.add(sc.name); }
   const also = def.also ?? [];

package/src/web/core.tsx

@@ -47,7 +47,7 @@ function routed(key: string, table: RouteTable): ComponentType<AppProps> {
  * the baba declares in `baba({ apps })`, and none other; the keys are checked against them. An app that
  * declares routes may be given a component per route instead, `{ "/": Prs, "/pr/:n": Pr }`, checked
  * against its routes: every route, none other. One of voss's own apps, `maker`, `state`, `contract`,
- * `promptware`, `settings`, may be given a component of the baba's to replace voss's.
+ * `agentic instructions`, `settings`, may be given a component of the baba's to replace voss's.
  * The old form, `compose({ shell })`, still loads.
  */
 export function compose<V extends { $app: string }>(def: { apps: { [K in V["$app"]]: EntryFor<RoutesFor<V, K>> } & { [K in VossApp]?: ComponentType<AppProps> } }): AppsDef;
@@ -111,7 +111,7 @@ export async function api(kind: "fire" | "read" | "state" | "raw", scope: string
  * The baba's manifest, as the server describes it: null until it arrives.
  * Asked once, then asked again "since the generation I have", so the answer
  * comes when the baba reloads: a page that draws the manifest, the Maker's
- * objects or the promptware, follows a change to the code as the state
+ * objects or the agentic instructions, follows a change to the code as the state
  * follows a round. A baba that is down is asked again in a moment.
  */
 export function useManifest(): Manifest | null {