paracosm 0.7.481 → 0.8.488

package/dist/cli/actors-resolver.d.ts

@@ -0,0 +1,26 @@
+import type { ActorConfig } from './types.js';
+export interface ResolvedActors {
+    actors: ActorConfig[];
+    /** Absolute path of the file the actors were read from. Surfaces
+     *  in CLI output so users know which file is actually in use. */
+    sourcePath: string;
+    /** Marker for whether the source was the shipped example (we
+     *  want to print a hint nudging users to create their own). */
+    isExample: boolean;
+}
+/**
+ * Walks the candidate paths and loads the first `actors.json` that
+ * exists. Throws only when nothing (not even the bundled example)
+ * is available — which would indicate a broken install.
+ */
+export declare function resolveActors(options?: {
+    explicitPath?: string;
+}): ResolvedActors;
+/**
+ * Pulls `--actors <path>` out of argv WITHOUT mutating the array.
+ * Returns undefined when the flag isn't present. Kept separate from
+ * the main CLI parser so run.ts / serve.ts can resolve actors the
+ * same way without duplicating flag logic.
+ */
+export declare function parseActorsFlag(args: readonly string[]): string | undefined;
+//# sourceMappingURL=actors-resolver.d.ts.map

package/dist/cli/actors-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actors-resolver.d.ts","sourceRoot":"","sources":["../../src/cli/actors-resolver.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB;qEACiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB;mEAC+D;IAC/D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,cAAc,CAwBrF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAM3E"}

package/dist/cli/actors-resolver.js

@@ -0,0 +1,66 @@
+/**
+ * Resolve the active `actors.json` for a paracosm CLI invocation.
+ *
+ * Search order (first match wins):
+ *   1. --actors <path> CLI flag (explicit path)
+ *   2. $CWD/actors.json          (user's project root)
+ *   3. $CWD/config/actors.json   (user's config dir)
+ *   4. <package>/config/actors.json        (paracosm-shipped fallback)
+ *   5. <package>/config/actors.example.json (last-resort default)
+ *
+ * Covers three consumer shapes:
+ *   - Repo clone: users edit config/actors.json at the repo root.
+ *   - npm install: users drop actors.json (or config/actors.json)
+ *     into their project CWD.
+ *   - npx one-off: falls back to the bundled example so `npx
+ *     paracosm` Just Works even before the user writes any config.
+ *
+ * @module paracosm/cli/actors-resolver
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Walks the candidate paths and loads the first `actors.json` that
+ * exists. Throws only when nothing (not even the bundled example)
+ * is available — which would indicate a broken install.
+ */
+export function resolveActors(options = {}) {
+    const cwd = process.cwd();
+    const packageRoot = resolve(__dirname, '..', '..');
+    const candidates = [];
+    if (options.explicitPath) {
+        candidates.push({ path: resolve(cwd, options.explicitPath), isExample: false });
+    }
+    candidates.push({ path: resolve(cwd, 'actors.json'), isExample: false });
+    candidates.push({ path: resolve(cwd, 'config', 'actors.json'), isExample: false });
+    candidates.push({ path: resolve(packageRoot, 'config', 'actors.json'), isExample: false });
+    candidates.push({ path: resolve(packageRoot, 'config', 'actors.example.json'), isExample: true });
+    for (const { path, isExample } of candidates) {
+        if (!existsSync(path))
+            continue;
+        const raw = JSON.parse(readFileSync(path, 'utf-8'));
+        const actors = Array.isArray(raw.actors) ? raw.actors : [];
+        return { actors, sourcePath: path, isExample };
+    }
+    throw new Error(`paracosm: no actors.json found. Create one at ${resolve(cwd, 'config', 'actors.json')} ` +
+        `or pass --actors <path>. A starter template lives at ${resolve(packageRoot, 'config', 'actors.example.json')}.`);
+}
+/**
+ * Pulls `--actors <path>` out of argv WITHOUT mutating the array.
+ * Returns undefined when the flag isn't present. Kept separate from
+ * the main CLI parser so run.ts / serve.ts can resolve actors the
+ * same way without duplicating flag logic.
+ */
+export function parseActorsFlag(args) {
+    const idx = args.indexOf('--actors');
+    if (idx < 0)
+        return undefined;
+    const next = args[idx + 1];
+    if (!next || next.startsWith('--'))
+        return undefined;
+    return next;
+}
+//# sourceMappingURL=actors-resolver.js.map

package/dist/cli/actors-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actors-resolver.js","sourceRoot":"","sources":["../../src/cli/actors-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAYtC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,UAAqC,EAAE;IACnE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,UAAU,GAAgD,EAAE,CAAC;IAEnE,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3F,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,qBAAqB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElG,KAAK,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,UAAU,EAAE,CAAC;QAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAA+B,CAAC;QAClF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,KAAK,CACb,iDAAiD,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,GAAG;QACzF,wDAAwD,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,qBAAqB,CAAC,GAAG,CACjH,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAuB;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/bundle-routes.d.ts

@@ -0,0 +1,32 @@
+/**
+ * HTTP handlers for the Compare-runs UI's bundle endpoints. A bundle is
+ * a set of RunRecords sharing a `bundleId`, produced by one Quickstart
+ * submission. The dashboard's CompareModal fetches:
+ *
+ *   - GET /api/v1/bundles/:id            -> bundle metadata + member runs
+ *   - GET /api/v1/bundles/:id/aggregate  -> server-side rollup (counts, cost)
+ *
+ * Lazy-loading: members in the listBundle response carry only the
+ * RunRecord summary (cost, duration, actorName, summaryTrajectory).
+ * Full RunArtifact JSON is fetched per-cell via the existing
+ * /api/v1/runs/:id endpoint when a cell is pinned or opened.
+ *
+ * @module paracosm/cli/bundle-routes
+ */
+import type { ServerResponse } from 'node:http';
+import type { RunHistoryStore } from './server/run-history-store.js';
+import type { RunRecord } from './server/run-record.js';
+export interface BundleRoutesDeps {
+    runHistoryStore: RunHistoryStore;
+}
+export declare function handleListBundle(bundleId: string, res: ServerResponse, deps: BundleRoutesDeps): Promise<void>;
+export interface BundleAggregate {
+    bundleId: string;
+    count: number;
+    costTotalUSD: number;
+    meanDurationMs: number;
+    outcomeBuckets: Record<string, number>;
+}
+export declare function handleBundleAggregate(bundleId: string, res: ServerResponse, deps: BundleRoutesDeps): Promise<void>;
+export declare function computeAggregate(bundleId: string, members: RunRecord[]): BundleAggregate;
+//# sourceMappingURL=bundle-routes.d.ts.map

package/dist/cli/bundle-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-routes.d.ts","sourceRoot":"","sources":["../../src/cli/bundle-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,eAAe,CAYxF"}

package/dist/cli/bundle-routes.js

@@ -0,0 +1,53 @@
+export async function handleListBundle(bundleId, res, deps) {
+    if (!deps.runHistoryStore.listRunsByBundleId) {
+        res.writeHead(501, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'bundle queries not supported by this store' }));
+        return;
+    }
+    const members = await deps.runHistoryStore.listRunsByBundleId(bundleId);
+    if (members.length === 0) {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: `Bundle ${bundleId} has no members` }));
+        return;
+    }
+    const scenarioId = members[0].scenarioId;
+    const createdAt = members[0].createdAt;
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({
+        bundleId,
+        scenarioId,
+        createdAt,
+        memberCount: members.length,
+        members,
+    }));
+}
+export async function handleBundleAggregate(bundleId, res, deps) {
+    if (!deps.runHistoryStore.listRunsByBundleId) {
+        res.writeHead(501, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'bundle queries not supported' }));
+        return;
+    }
+    const members = await deps.runHistoryStore.listRunsByBundleId(bundleId);
+    if (members.length === 0) {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: `Bundle ${bundleId} has no members` }));
+        return;
+    }
+    const aggregate = computeAggregate(bundleId, members);
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(aggregate));
+}
+export function computeAggregate(bundleId, members) {
+    const costTotalUSD = members.reduce((sum, m) => sum + (m.costUSD ?? 0), 0);
+    const durations = members.map(m => m.durationMs ?? 0).filter(d => d > 0);
+    const meanDurationMs = durations.length > 0
+        ? Math.round(durations.reduce((a, b) => a + b, 0) / durations.length)
+        : 0;
+    // Outcome buckets are populated when the artifact's fingerprint or a
+    // dedicated column carries the outcome class. RunRecord alone does
+    // not, so v1 returns an empty bucket map -- the AggregateStrip's
+    // outcome chart treats empty buckets as "data unavailable" gracefully.
+    const outcomeBuckets = {};
+    return { bundleId, count: members.length, costTotalUSD, meanDurationMs, outcomeBuckets };
+}
+//# sourceMappingURL=bundle-routes.js.map

package/dist/cli/bundle-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-routes.js","sourceRoot":"","sources":["../../src/cli/bundle-routes.ts"],"names":[],"mappings":"AAuBA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB,EAChB,GAAmB,EACnB,IAAsB;IAEtB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,kBAAkB,EAAE,CAAC;QAC7C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC,CAAC,CAAC;QACjF,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,QAAQ,iBAAiB,EAAE,CAAC,CAAC,CAAC;QACxE,OAAO;IACT,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;QACrB,QAAQ;QACR,UAAU;QACV,SAAS;QACT,WAAW,EAAE,OAAO,CAAC,MAAM;QAC3B,OAAO;KACR,CAAC,CAAC,CAAC;AACN,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAgB,EAChB,GAAmB,EACnB,IAAsB;IAEtB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,kBAAkB,EAAE,CAAC;QAC7C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,QAAQ,iBAAiB,EAAE,CAAC,CAAC,CAAC;QACxE,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,OAAoB;IACrE,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;QACzC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;QACrE,CAAC,CAAC,CAAC,CAAC;IACN,qEAAqE;IACrE,mEAAmE;IACnE,iEAAiE;IACjE,uEAAuE;IACvE,MAAM,cAAc,GAA2B,EAAE,CAAC;IAClD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC3F,CAAC"}

package/dist/cli/help.js

@@ -10,11 +10,11 @@ import { fileURLToPath } from 'node:url';
 const TOP_LEVEL_HELP = `paracosm <command> [options]
 
 A structured world model for AI agents. Compile prompts, briefs, URLs, or
-JSON contracts into typed scenarios. Run HEXACO-personality leaders against
+JSON contracts into typed scenarios. Run HEXACO-personality actors against
 a deterministic kernel.
 
 Commands:
-  run                   Run a simulation against leaders.json
+  run                   Run a simulation against actors.json
   dashboard             Start the SSE web dashboard at http://localhost:3456
   compile <scenario>    Compile a scenario draft into runnable hooks (cached)
   init <dir>            Scaffold a starter project from a free-text brief
@@ -26,8 +26,8 @@ Global flags:
   --version, -v         Print version
 
 Examples:
-  paracosm run                                            # default leader, full turns
-  paracosm run --leader 1 --turns 5                       # leader index 1, 5 turns
+  paracosm run                                            # default actor, full turns
+  paracosm run --actor 1 --turns 5                        # actor index 1, 5 turns
   paracosm run --name "Reyes" --openness 0.85 6           # inline HEXACO override
   paracosm dashboard --turns 6                            # opens browser dashboard
   paracosm compile scenarios/lunar.json --seed-url <url>  # compile + cache
@@ -38,23 +38,23 @@ GitHub: https://github.com/framersai/paracosm
 `;
 const RUN_HELP = `paracosm run [options]
 
-Run a simulation against leaders.json (or --leaders <path>) and print
+Run a simulation against actors.json (or --actors <path>) and print
 turn-by-turn narrative to stdout. Saves the full RunArtifact JSON to
 ./output/v3-<archetype>-<timestamp>.json (override with PARACOSM_OUTPUT_DIR).
 
 Options:
-  --leader <n>            Leader index in leaders.json (default: 0)
-  --leaders <path>        Custom leaders.json path
+  --actor <n>             Actor index in actors.json (default: 0)
+  --actors <path>         Custom actors.json path
   --turns <n>             Override turn count
   --seed <n>              Override seed
   --start-time <n>        Override start time / year
   --provider <p>          openai | anthropic (defaults to whichever key is set)
   --cost <p>              quality | economy (default: quality)
   --live                  Enable live web search during department analysis
-  --name <s>              Override leader name
-  --archetype <s>         Override leader archetype
-  --unit <s>              Override leader unit
-  --instructions <s>      Override leader instructions
+  --name <s>              Override actor name
+  --archetype <s>         Override actor archetype
+  --unit <s>              Override actor unit
+  --instructions <s>      Override actor instructions
   --openness <0-1>        HEXACO openness override
   --conscientiousness <0-1>
   --extraversion <0-1>
@@ -74,7 +74,7 @@ tabs over a streaming connection. Without [turns], waits for setup at
 
 Options:
   [turns]               Auto-launch with N turns. Omit to wait for setup.
-  --leaders <path>      Custom leaders.json path
+  --actors <path>       Custom actors.json path
   --seed <n>            Override seed
   --start-time <n>      Override start time
   --provider <p>        openai | anthropic
@@ -104,14 +104,14 @@ Options:
 const INIT_HELP = `paracosm init <dir> --domain <text|url> [options]
 
 Scaffold a runnable paracosm project from a free-text brief or a URL.
-Calls compileFromSeed + generateQuickstartLeaders, then writes
+Calls compileFromSeed + generateQuickstartActors, then writes
 package.json, run.mjs, README.md, .env.example, .gitignore to <dir>.
 
 Options:
   <dir>                 Output directory (default: ./paracosm-app)
   --domain <text|url>   Required: seed text or URL describing the scenario
   --mode <m>            turn-loop | batch-trajectory | batch-point (default: turn-loop)
-  --leaders <n>         Number of HEXACO leaders, 2-6 (default: 3)
+  --actors <n>          Number of HEXACO actors, 2-6 (default: 3)
   --name <s>            Project name (default: derived from --domain)
   --force               Overwrite a non-empty target directory
 

package/dist/cli/init-templates.d.ts

@@ -17,7 +17,7 @@ export type SimulationMode = 'turn-loop' | 'batch-trajectory' | 'batch-point';
  * Render the entry script for a paracosm-init scaffolded project.
  *
  * The script imports `runSimulation` from `paracosm/runtime` and runs the
- * leader at index 0 against a turn-loop simulation. Mode is intentionally
+ * actor at index 0 against a turn-loop simulation. Mode is intentionally
  * NOT a runtime input: it is a property of the produced
  * `RunArtifact.metadata`, surfaced after the run completes. Batch-trajectory
  * and batch-point modes are produced by `runBatch` (different entry point,
@@ -29,7 +29,7 @@ export interface ReadmeInput {
     name: string;
     domain: string;
     mode: SimulationMode;
-    leaders: number;
+    actors: number;
 }
 export declare function renderReadme(input: ReadmeInput): string;
 export declare function renderEnvExample(): string;

package/dist/cli/init-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../../src/cli/init-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAcjE;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAqCrC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA8BvD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAWzC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAQxC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS/C"}
+{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../../src/cli/init-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAcjE;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAqCrC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA8BvD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAWzC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAQxC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS/C"}

package/dist/cli/init-templates.js

@@ -26,7 +26,7 @@ export function renderPackageJson(input) {
  * Render the entry script for a paracosm-init scaffolded project.
  *
  * The script imports `runSimulation` from `paracosm/runtime` and runs the
- * leader at index 0 against a turn-loop simulation. Mode is intentionally
+ * actor at index 0 against a turn-loop simulation. Mode is intentionally
  * NOT a runtime input: it is a property of the produced
  * `RunArtifact.metadata`, surfaced after the run completes. Batch-trajectory
  * and batch-point modes are produced by `runBatch` (different entry point,
@@ -38,9 +38,9 @@ export function renderRunMjs() {
 /**
  * Entry script for a paracosm-init scaffolded project.
  *
- * Reads scenario.json + leaders.json from this directory, runs the
- * configured leader at index 0, and prints the resulting RunArtifact JSON.
- * Edit the leader index, maxTurns, or seed below to explore.
+ * Reads scenario.json + actors.json from this directory, runs the
+ * configured actor at index 0, and prints the resulting RunArtifact JSON.
+ * Edit the actor index, maxTurns, or seed below to explore.
  *
  * The "mode" of the resulting run lives on artifact.metadata.mode and is
  * always "turn-loop" for runs produced by runSimulation. For
@@ -53,16 +53,16 @@ import { runSimulation } from 'paracosm/runtime';
 
 const here = dirname(fileURLToPath(import.meta.url));
 const scenario = JSON.parse(readFileSync(resolve(here, 'scenario.json'), 'utf-8'));
-const leaders = JSON.parse(readFileSync(resolve(here, 'leaders.json'), 'utf-8'));
+const actors = JSON.parse(readFileSync(resolve(here, 'actors.json'), 'utf-8'));
 
-if (!Array.isArray(leaders) || leaders.length === 0) {
-  console.error('leaders.json is empty. Re-run \\\`paracosm init\\\` to regenerate.');
+if (!Array.isArray(actors) || actors.length === 0) {
+  console.error('actors.json is empty. Re-run \\\`paracosm init\\\` to regenerate.');
   process.exit(1);
 }
 
-const leader = leaders[0];
+const actor = actors[0];
 
-const result = await runSimulation(leader, [], {
+const result = await runSimulation(actor, [], {
   scenario,
   maxTurns: 6,
   seed: 42,
@@ -81,8 +81,8 @@ Scaffolded by \`paracosm init\` from the seed:
 This project contains:
 
 - \`scenario.json\`: compiled \`ScenarioPackage\` (LLM-generated at init time)
-- \`leaders.json\`: ${input.leaders} HEXACO leader configs (LLM-generated)
-- \`run.mjs\`: minimal entry script that runs leader 0 in \`${input.mode}\` mode
+- \`actors.json\`: ${input.actors} HEXACO actor configs (LLM-generated)
+- \`run.mjs\`: minimal entry script that runs actor 0 in \`${input.mode}\` mode
 
 ## Quickstart
 
@@ -96,8 +96,8 @@ node run.mjs
 ## Customizing
 
 - Edit \`scenario.json\` to tweak departments, world state, events.
-- Edit \`leaders.json\` to swap HEXACO traits or instructions.
-- Edit \`run.mjs\` to change the leader index, mode, turn count, or seed.
+- Edit \`actors.json\` to swap HEXACO traits or instructions.
+- Edit \`run.mjs\` to change the actor index, mode, turn count, or seed.
 
 See https://github.com/framersai/paracosm for the full API reference.
 `;

package/dist/cli/init-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-templates.js","sourceRoot":"","sources":["../../src/cli/init-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,UAAU,iBAAiB,CAAC,KAAuB;IACvD,MAAM,GAAG,GAAG;QACV,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP,KAAK,EAAE,cAAc;SACtB;QACD,YAAY,EAAE;YACZ,QAAQ,EAAE,IAAI,KAAK,CAAC,eAAe,EAAE;SACtC;KACF,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAC7C,CAAC;AAID;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCR,CAAC;AACF,CAAC;AASD,MAAM,UAAU,YAAY,CAAC,KAAkB;IAC7C,OAAO,KAAK,KAAK,CAAC,IAAI;;;;IAIpB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;;;;;sBAKjD,KAAK,CAAC,OAAO;8DAC2B,KAAK,CAAC,IAAI;;;;;;;;;;;;;;;;;;CAkBvE,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;CASR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;CAMR,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,IAAI,GAAG,GAAG;SACb,WAAW,EAAE;SACb,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,IAAI,IAAI,cAAc,CAAC;AAChC,CAAC"}
+{"version":3,"file":"init-templates.js","sourceRoot":"","sources":["../../src/cli/init-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,UAAU,iBAAiB,CAAC,KAAuB;IACvD,MAAM,GAAG,GAAG;QACV,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP,KAAK,EAAE,cAAc;SACtB;QACD,YAAY,EAAE;YACZ,QAAQ,EAAE,IAAI,KAAK,CAAC,eAAe,EAAE;SACtC;KACF,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAC7C,CAAC;AAID;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCR,CAAC;AACF,CAAC;AASD,MAAM,UAAU,YAAY,CAAC,KAAkB;IAC7C,OAAO,KAAK,KAAK,CAAC,IAAI;;;;IAIpB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;;;;;qBAKlD,KAAK,CAAC,MAAM;6DAC4B,KAAK,CAAC,IAAI;;;;;;;;;;;;;;;;;;CAkBtE,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;CASR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;CAMR,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,IAAI,GAAG,GAAG;SACb,WAAW,EAAE;SACb,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,IAAI,IAAI,cAAc,CAAC;AAChC,CAAC"}

package/dist/cli/init.d.ts

@@ -1,11 +1,11 @@
 import { compileFromSeed } from '../engine/compiler/compile-from-seed.js';
-import { generateQuickstartLeaders } from '../runtime/world-model/index.js';
+import { generateQuickstartActors } from '../runtime/world-model/index.js';
 import { type SimulationMode } from './init-templates.js';
 export interface InitOptions {
     outputDir: string;
     domain: string;
     mode: SimulationMode;
-    leaders: number;
+    actors: number;
     name: string;
     force: boolean;
 }
@@ -25,7 +25,7 @@ export type InitArgResult = {
 export declare function parseInitArgs(argv: readonly string[]): InitArgResult;
 /**
  * Hook seam for tests. Real implementation calls compileFromSeed +
- * generateQuickstartLeaders + URL fetch directly. Tests pass mocks.
+ * generateQuickstartActors + URL fetch directly. Tests pass mocks.
  */
 export interface RunInitDeps {
     fetchSeedFromUrl?: (url: string) => Promise<{
@@ -33,7 +33,7 @@ export interface RunInitDeps {
         title: string;
     }>;
     compileFromSeed?: typeof compileFromSeed;
-    generateQuickstartLeaders?: typeof generateQuickstartLeaders;
+    generateQuickstartActors?: typeof generateQuickstartActors;
     readEnv?: () => NodeJS.ProcessEnv;
     paracosmVersion?: string;
     log?: (msg: string) => void;

package/dist/cli/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,YAAY,CAAC;AAqB9E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CA0DpE;AA6BD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,eAAe,CAAC,EAAE,OAAO,eAAe,CAAC;IACzC,yBAAyB,CAAC,EAAE,OAAO,yBAAyB,CAAC;IAC7D,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,UAAU,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgF9F"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,YAAY,CAAC;AAqB9E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CA0DpE;AA6BD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,eAAe,CAAC,EAAE,OAAO,eAAe,CAAC;IACzC,wBAAwB,CAAC,EAAE,OAAO,wBAAwB,CAAC;IAC3D,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,UAAU,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgF9F"}

package/dist/cli/init.js

@@ -1,7 +1,7 @@
 /**
  * `paracosm init` subcommand. Scaffolds a runnable paracosm project
  * from a seed text or URL via the existing compileFromSeed +
- * generateQuickstartLeaders infrastructure.
+ * generateQuickstartActors infrastructure.
  *
  * Flag-driven only (no interactive prompts) so it composes with shell
  * scripts and CI. URL handling mirrors the server-app.ts pattern that
@@ -13,7 +13,7 @@ import { mkdirSync, readdirSync, writeFileSync, existsSync, readFileSync } from
 import { resolve, basename, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { compileFromSeed } from '../engine/compiler/compile-from-seed.js';
-import { generateQuickstartLeaders } from '../runtime/world-model/index.js';
+import { generateQuickstartActors } from '../runtime/world-model/index.js';
 import { fetchSeedFromUrl as fetchSeedFromUrlViaAgentOS } from './fetch-seed-url.js';
 import { renderPackageJson, renderRunMjs, renderReadme, renderEnvExample, renderGitignore, slugifyName, } from './init-templates.js';
 const VALID_MODES = new Set([
@@ -21,17 +21,17 @@ const VALID_MODES = new Set([
     'batch-trajectory',
     'batch-point',
 ]);
-const USAGE = `paracosm init [dir] --domain <text|url> [--mode <m>] [--leaders <n>] [--name <name>] [--force]
+const USAGE = `paracosm init [dir] --domain <text|url> [--mode <m>] [--actors <n>] [--name <name>] [--force]
 
   dir         output directory (default: ./paracosm-app)
   --domain    required: seed text describing the scenario, OR a URL
   --mode      turn-loop | batch-trajectory | batch-point (default: turn-loop)
-  --leaders   number of HEXACO leaders, 2-6 (default: 3)
+  --actors   number of HEXACO leaders, 2-6 (default: 3)
   --name      project name, default: derived from --domain
   --force     overwrite non-empty target dir
 
 example:
-  paracosm init my-app --domain "Submarine crew of 8 in deep ocean for 30 days" --leaders 3
+  paracosm init my-app --domain "Submarine crew of 8 in deep ocean for 30 days" --actors 3
 `;
 /**
  * Parse the argv slice that follows `paracosm init`. Returns either a
@@ -42,7 +42,7 @@ export function parseInitArgs(argv) {
     let outputDir;
     let domain;
     let mode = 'turn-loop';
-    let leaders = 3;
+    let actors = 3;
     let name;
     let force = false;
     for (let i = 0; i < argv.length; i++) {
@@ -57,12 +57,12 @@ export function parseInitArgs(argv) {
             }
             mode = candidate;
         }
-        else if (arg === '--leaders') {
+        else if (arg === '--actors') {
             const n = Number(argv[++i]);
             if (!Number.isFinite(n) || n < 2 || n > 6 || !Number.isInteger(n)) {
-                return { ok: false, message: `Invalid --leaders "${argv[i]}". Must be an integer in [2, 6].\n\n${USAGE}` };
+                return { ok: false, message: `Invalid --actors "${argv[i]}". Must be an integer in [2, 6].\n\n${USAGE}` };
             }
-            leaders = n;
+            actors = n;
         }
         else if (arg === '--name') {
             name = argv[++i];
@@ -94,7 +94,7 @@ export function parseInitArgs(argv) {
             outputDir: resolvedDir,
             domain,
             mode,
-            leaders,
+            actors,
             name: resolvedName,
             force,
         },
@@ -177,14 +177,14 @@ export async function runInit(argv, deps = {}) {
         process.stderr.write(`Scenario compile failed: ${String(err)}\n`);
         return 2;
     }
-    log(`[paracosm init] Generating ${opts.leaders} HEXACO leaders...`);
-    let leaders;
+    log(`[paracosm init] Generating ${opts.actors} HEXACO actors...`);
+    let actors;
     try {
-        const gen = deps.generateQuickstartLeaders ?? generateQuickstartLeaders;
-        leaders = await gen(scenario, opts.leaders, {});
+        const gen = deps.generateQuickstartActors ?? generateQuickstartActors;
+        actors = await gen(scenario, opts.actors, {});
     }
     catch (err) {
-        process.stderr.write(`Leader generation failed: ${String(err)}\n`);
+        process.stderr.write(`Actor generation failed: ${String(err)}\n`);
         return 2;
     }
     log(`[paracosm init] Writing files to ${opts.outputDir}/...`);
@@ -192,9 +192,9 @@ export async function runInit(argv, deps = {}) {
     const paracosmVersion = deps.paracosmVersion ?? readOwnVersion();
     writeFileSync(`${opts.outputDir}/package.json`, renderPackageJson({ name: opts.name, paracosmVersion }));
     writeFileSync(`${opts.outputDir}/scenario.json`, JSON.stringify(scenario, null, 2) + '\n');
-    writeFileSync(`${opts.outputDir}/leaders.json`, JSON.stringify(leaders, null, 2) + '\n');
+    writeFileSync(`${opts.outputDir}/actors.json`, JSON.stringify(actors, null, 2) + '\n');
     writeFileSync(`${opts.outputDir}/run.mjs`, renderRunMjs());
-    writeFileSync(`${opts.outputDir}/README.md`, renderReadme({ name: opts.name, domain: opts.domain, mode: opts.mode, leaders: opts.leaders }));
+    writeFileSync(`${opts.outputDir}/README.md`, renderReadme({ name: opts.name, domain: opts.domain, mode: opts.mode, actors: opts.actors }));
     writeFileSync(`${opts.outputDir}/.env.example`, renderEnvExample());
     writeFileSync(`${opts.outputDir}/.gitignore`, renderGitignore());
     log(`[paracosm init] Done. Run:`);

package/dist/cli/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/pair-runner.d.ts

@@ -26,7 +26,7 @@ scenario?: ScenarioPackage,
  * the SQLite run-history store. Failures inside the callback are
  * caught and logged so a failing handler does not break the run.
  */
-onArtifact?: (artifact: import('../engine/schema/index.js').RunArtifact, leader: import('../runtime/orchestrator.js').LeaderConfig) => void | Promise<void>): Promise<void>;
+onArtifact?: (artifact: import('../engine/schema/index.js').RunArtifact, leader: import('../runtime/orchestrator.js').ActorConfig) => void | Promise<void>): Promise<void>;
 /**
  * Single-leader fork dispatch (Spec 2B). When `/setup` receives a
  * config with `forkFrom` set, the server branches here instead of
@@ -45,7 +45,7 @@ onArtifact?: (artifact: import('../engine/schema/index.js').RunArtifact, leader:
  */
 export declare function runForkSimulation(simConfig: NormalizedSimulationConfig, broadcast: BroadcastFn, signal?: AbortSignal, scenario?: ScenarioPackage, 
 /** Optional callback fired after the forked artifact completes. */
-onArtifact?: (artifact: import('../engine/schema/index.js').RunArtifact, leader: import('../runtime/orchestrator.js').LeaderConfig) => void | Promise<void>): Promise<void>;
+onArtifact?: (artifact: import('../engine/schema/index.js').RunArtifact, leader: import('../runtime/orchestrator.js').ActorConfig) => void | Promise<void>): Promise<void>;
 /**
  * Generalized N-leader batch runner (Tier 5 Quickstart). Three or more
  * leaders run against the same scenario + seed in parallel, each
@@ -59,5 +59,5 @@ onArtifact?: (artifact: import('../engine/schema/index.js').RunArtifact, leader:
  */
 export declare function runBatchSimulations(simConfig: NormalizedSimulationConfig, broadcast: BroadcastFn, signal?: AbortSignal, scenario?: ScenarioPackage, 
 /** Optional callback fired after each leader's artifact completes. */
-onArtifact?: (artifact: import('../engine/schema/index.js').RunArtifact, leader: import('../runtime/orchestrator.js').LeaderConfig) => void | Promise<void>): Promise<void>;
+onArtifact?: (artifact: import('../engine/schema/index.js').RunArtifact, leader: import('../runtime/orchestrator.js').ActorConfig) => void | Promise<void>): Promise<void>;
 //# sourceMappingURL=pair-runner.d.ts.map

package/dist/cli/pair-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pair-runner.d.ts","sourceRoot":"","sources":["../../src/cli/pair-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAIzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAyBjE,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,0BAA0B,EACrC,SAAS,EAAE,WAAW;AACtB;;;;;;;GAOG;AACH,MAAM,CAAC,EAAE,WAAW;AACpB;;;;;;;GAOG;AACH,QAAQ,GAAE,eAA8B;AACxC;;;;;GAKG;AACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,2BAA2B,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,4BAA4B,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC1J,OAAO,CAAC,IAAI,CAAC,CAuMf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,0BAA0B,EACrC,SAAS,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,GAAE,eAA8B;AACxC,mEAAmE;AACnE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,2BAA2B,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,4BAA4B,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC1J,OAAO,CAAC,IAAI,CAAC,CAwFf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,0BAA0B,EACrC,SAAS,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,GAAE,eAA8B;AACxC,sEAAsE;AACtE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,2BAA2B,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,4BAA4B,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC1J,OAAO,CAAC,IAAI,CAAC,CAuFf"}
+{"version":3,"file":"pair-runner.d.ts","sourceRoot":"","sources":["../../src/cli/pair-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAKzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAyBjE,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,0BAA0B,EACrC,SAAS,EAAE,WAAW;AACtB;;;;;;;GAOG;AACH,MAAM,CAAC,EAAE,WAAW;AACpB;;;;;;;GAOG;AACH,QAAQ,GAAE,eAA8B;AACxC;;;;;GAKG;AACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,2BAA2B,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,4BAA4B,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACzJ,OAAO,CAAC,IAAI,CAAC,CA8Mf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,0BAA0B,EACrC,SAAS,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,GAAE,eAA8B;AACxC,mEAAmE;AACnE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,2BAA2B,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,4BAA4B,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACzJ,OAAO,CAAC,IAAI,CAAC,CA8Ff;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,0BAA0B,EACrC,SAAS,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,GAAE,eAA8B;AACxC,sEAAsE;AACtE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,2BAA2B,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,4BAA4B,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACzJ,OAAO,CAAC,IAAI,CAAC,CA6Ff"}