paracosm 0.7.409 → 0.7.431

package/dist/cli/init-templates.js

@@ -0,0 +1,141 @@
+/**
+ * Pure renderer functions for the files emitted by `paracosm init`.
+ * Each function takes a small input record and returns the file contents
+ * as a string. No I/O, no dependencies on the caller's environment.
+ *
+ * Kept separate from init.ts so the renderers snapshot-test trivially.
+ *
+ * @module paracosm/cli/init-templates
+ */
+export function renderPackageJson(input) {
+    const pkg = {
+        name: input.name,
+        version: '0.1.0',
+        private: true,
+        type: 'module',
+        scripts: {
+            start: 'node run.mjs',
+        },
+        dependencies: {
+            paracosm: `^${input.paracosmVersion}`,
+        },
+    };
+    return JSON.stringify(pkg, null, 2) + '\n';
+}
+/**
+ * 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
+ * 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,
+ * different config shape); a future spec adds a separate `renderRunMjsBatch`
+ * for those modes.
+ */
+export function renderRunMjs() {
+    return `#!/usr/bin/env node
+/**
+ * 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.
+ *
+ * The "mode" of the resulting run lives on artifact.metadata.mode and is
+ * always "turn-loop" for runs produced by runSimulation. For
+ * batch-trajectory or batch-point modes, use runBatch directly.
+ */
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+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'));
+
+if (!Array.isArray(leaders) || leaders.length === 0) {
+  console.error('leaders.json is empty. Re-run \\\`paracosm init\\\` to regenerate.');
+  process.exit(1);
+}
+
+const leader = leaders[0];
+
+const result = await runSimulation(leader, [], {
+  scenario,
+  maxTurns: 6,
+  seed: 42,
+});
+
+console.log(JSON.stringify(result, null, 2));
+`;
+}
+export function renderReadme(input) {
+    return `# ${input.name}
+
+Scaffolded by \`paracosm init\` from the seed:
+
+> ${input.domain.slice(0, 200)}${input.domain.length > 200 ? '...' : ''}
+
+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
+
+## Quickstart
+
+\`\`\`bash
+npm install
+cp .env.example .env
+# Set OPENAI_API_KEY (and any other provider keys you need) in .env
+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.
+
+See https://github.com/framersai/paracosm for the full API reference.
+`;
+}
+export function renderEnvExample() {
+    return `# Required for compileScenario / generateText / generateObject calls.
+OPENAI_API_KEY=
+
+# Optional alternate providers paracosm can route to.
+ANTHROPIC_API_KEY=
+GOOGLE_API_KEY=
+
+# Optional Cohere rerank for higher-accuracy retrieval.
+COHERE_API_KEY=
+`;
+}
+export function renderGitignore() {
+    return `node_modules/
+.env
+.paracosm/
+dist/
+*.log
+.DS_Store
+`;
+}
+/**
+ * Slug-normalize a project name. Lowercase ASCII, dashes between words,
+ * strips everything else, max 50 chars. If empty after stripping,
+ * returns 'paracosm-app'.
+ */
+export function slugifyName(raw) {
+    const slug = raw
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 50);
+    return slug || 'paracosm-app';
+}
+//# sourceMappingURL=init-templates.js.map

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

@@ -0,0 +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"}

package/dist/cli/init.d.ts

@@ -0,0 +1,46 @@
+import { compileFromSeed } from '../engine/compiler/compile-from-seed.js';
+import { generateQuickstartLeaders } from '../runtime/world-model/index.js';
+import { type SimulationMode } from './init-templates.js';
+export interface InitOptions {
+    outputDir: string;
+    domain: string;
+    mode: SimulationMode;
+    leaders: number;
+    name: string;
+    force: boolean;
+}
+export interface InitArgError {
+    ok: false;
+    message: string;
+}
+export type InitArgResult = {
+    ok: true;
+    options: InitOptions;
+} | InitArgError;
+/**
+ * Parse the argv slice that follows `paracosm init`. Returns either a
+ * fully-resolved InitOptions or an InitArgError with a user-facing
+ * message that includes USAGE.
+ */
+export declare function parseInitArgs(argv: readonly string[]): InitArgResult;
+/**
+ * Hook seam for tests. Real implementation calls compileFromSeed +
+ * generateQuickstartLeaders + URL fetch directly. Tests pass mocks.
+ */
+export interface RunInitDeps {
+    fetchSeedFromUrl?: (url: string) => Promise<{
+        text: string;
+        title: string;
+    }>;
+    compileFromSeed?: typeof compileFromSeed;
+    generateQuickstartLeaders?: typeof generateQuickstartLeaders;
+    readEnv?: () => NodeJS.ProcessEnv;
+    paracosmVersion?: string;
+    log?: (msg: string) => void;
+}
+/**
+ * Main flow. Returns 0 on success, non-zero on user-facing error
+ * (also prints a message to stderr in the error case).
+ */
+export declare function runInit(argv: readonly string[], deps?: RunInitDeps): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +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"}

package/dist/cli/init.js

@@ -0,0 +1,207 @@
+/**
+ * `paracosm init` subcommand. Scaffolds a runnable paracosm project
+ * from a seed text or URL via the existing compileFromSeed +
+ * generateQuickstartLeaders infrastructure.
+ *
+ * Flag-driven only (no interactive prompts) so it composes with shell
+ * scripts and CI. URL handling mirrors the server-app.ts pattern that
+ * dynamically imports AgentOS WebSearchService from the web-search subpath.
+ *
+ * @module paracosm/cli/init
+ */
+import { mkdirSync, readdirSync, writeFileSync, existsSync, readFileSync } from 'node:fs';
+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 { fetchSeedFromUrl as fetchSeedFromUrlViaAgentOS } from './fetch-seed-url.js';
+import { renderPackageJson, renderRunMjs, renderReadme, renderEnvExample, renderGitignore, slugifyName, } from './init-templates.js';
+const VALID_MODES = new Set([
+    'turn-loop',
+    'batch-trajectory',
+    'batch-point',
+]);
+const USAGE = `paracosm init [dir] --domain <text|url> [--mode <m>] [--leaders <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)
+  --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
+`;
+/**
+ * Parse the argv slice that follows `paracosm init`. Returns either a
+ * fully-resolved InitOptions or an InitArgError with a user-facing
+ * message that includes USAGE.
+ */
+export function parseInitArgs(argv) {
+    let outputDir;
+    let domain;
+    let mode = 'turn-loop';
+    let leaders = 3;
+    let name;
+    let force = false;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--domain') {
+            domain = argv[++i];
+        }
+        else if (arg === '--mode') {
+            const candidate = argv[++i];
+            if (!VALID_MODES.has(candidate)) {
+                return { ok: false, message: `Invalid --mode "${candidate}". Must be one of: turn-loop, batch-trajectory, batch-point.\n\n${USAGE}` };
+            }
+            mode = candidate;
+        }
+        else if (arg === '--leaders') {
+            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}` };
+            }
+            leaders = n;
+        }
+        else if (arg === '--name') {
+            name = argv[++i];
+        }
+        else if (arg === '--force') {
+            force = true;
+        }
+        else if (arg.startsWith('--')) {
+            return { ok: false, message: `Unknown flag: ${arg}\n\n${USAGE}` };
+        }
+        else if (outputDir === undefined) {
+            outputDir = arg;
+        }
+        else {
+            return { ok: false, message: `Unexpected positional argument: ${arg}\n\n${USAGE}` };
+        }
+    }
+    if (!domain) {
+        return { ok: false, message: `--domain is required.\n\n${USAGE}` };
+    }
+    if (domain.length > 50_000) {
+        return { ok: false, message: `--domain too long (${domain.length} chars; max 50000).\n\n${USAGE}` };
+    }
+    const resolvedDir = resolve(outputDir ?? './paracosm-app');
+    const resolvedName = name ?? slugifyName(basename(resolvedDir));
+    return {
+        ok: true,
+        options: {
+            outputDir: resolvedDir,
+            domain,
+            mode,
+            leaders,
+            name: resolvedName,
+            force,
+        },
+    };
+}
+function isUrl(s) {
+    return /^https?:\/\//.test(s);
+}
+function isDirEmpty(dir) {
+    if (!existsSync(dir))
+        return true;
+    return readdirSync(dir).length === 0;
+}
+/**
+ * Read the paracosm package.json sitting two directories up from this
+ * module file. Works from both the tsx (src/cli/init.ts) and built
+ * (dist/cli/init.js) layouts because both mirror src/.
+ *
+ * @returns The semver version string from paracosm's package.json.
+ * @throws Error when the package.json is unreadable or missing a version.
+ */
+function readOwnVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = resolve(here, '../../package.json');
+    const raw = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    if (typeof raw.version !== 'string' || raw.version.length === 0) {
+        throw new Error('paracosm package.json is missing a version field');
+    }
+    return raw.version;
+}
+/**
+ * Main flow. Returns 0 on success, non-zero on user-facing error
+ * (also prints a message to stderr in the error case).
+ */
+export async function runInit(argv, deps = {}) {
+    const log = deps.log ?? ((m) => console.log(m));
+    const env = (deps.readEnv ?? (() => process.env))();
+    const parsed = parseInitArgs(argv);
+    if (!parsed.ok) {
+        process.stderr.write(parsed.message + '\n');
+        return 2;
+    }
+    const opts = parsed.options;
+    if (!env.OPENAI_API_KEY) {
+        process.stderr.write('Set OPENAI_API_KEY in your environment before running paracosm init.\n');
+        return 2;
+    }
+    if (!isDirEmpty(opts.outputDir) && !opts.force) {
+        process.stderr.write(`Target directory ${opts.outputDir} is not empty. Pass --force to overwrite.\n`);
+        return 2;
+    }
+    // Resolve seed text: URL fetch or pass-through.
+    let seedText = opts.domain;
+    if (isUrl(opts.domain)) {
+        log(`[paracosm init] Resolving URL: ${opts.domain}`);
+        try {
+            const fetcher = deps.fetchSeedFromUrl ?? fetchSeedFromUrlViaAgentOS;
+            const fetched = await fetcher(opts.domain);
+            seedText = fetched.text;
+        }
+        catch (err) {
+            process.stderr.write(`Failed to fetch URL ${opts.domain}: ${String(err)}\n`);
+            return 2;
+        }
+    }
+    if (seedText.length < 200) {
+        process.stderr.write(`Seed text too short (${seedText.length} chars; minimum 200). For URLs, the fetched body must contain enough content.\n`);
+        return 2;
+    }
+    if (seedText.length > 50_000) {
+        seedText = seedText.slice(0, 50_000);
+    }
+    log(`[paracosm init] Compiling scenario...`);
+    let scenario;
+    try {
+        const compile = deps.compileFromSeed ?? compileFromSeed;
+        scenario = await compile({ seedText });
+    }
+    catch (err) {
+        process.stderr.write(`Scenario compile failed: ${String(err)}\n`);
+        return 2;
+    }
+    log(`[paracosm init] Generating ${opts.leaders} HEXACO leaders...`);
+    let leaders;
+    try {
+        const gen = deps.generateQuickstartLeaders ?? generateQuickstartLeaders;
+        leaders = await gen(scenario, opts.leaders, {});
+    }
+    catch (err) {
+        process.stderr.write(`Leader generation failed: ${String(err)}\n`);
+        return 2;
+    }
+    log(`[paracosm init] Writing files to ${opts.outputDir}/...`);
+    mkdirSync(opts.outputDir, { recursive: true });
+    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}/run.mjs`, renderRunMjs());
+    writeFileSync(`${opts.outputDir}/README.md`, renderReadme({ name: opts.name, domain: opts.domain, mode: opts.mode, leaders: opts.leaders }));
+    writeFileSync(`${opts.outputDir}/.env.example`, renderEnvExample());
+    writeFileSync(`${opts.outputDir}/.gitignore`, renderGitignore());
+    log(`[paracosm init] Done. Run:`);
+    log(`                  cd ${basename(opts.outputDir)}`);
+    log(`                  npm install`);
+    log(`                  cp .env.example .env  # edit to add your API key`);
+    log(`                  node run.mjs`);
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,IAAI,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,GAEZ,MAAM,qBAAqB,CAAC;AAkB7B,MAAM,WAAW,GAAgC,IAAI,GAAG,CAAC;IACvD,WAAW;IACX,kBAAkB;IAClB,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,KAAK,GAAG;;;;;;;;;;;CAWb,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,IAAI,SAA6B,CAAC;IAClC,IAAI,MAA0B,CAAC;IAC/B,IAAI,IAAI,GAAmB,WAAW,CAAC;IACvC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,IAAwB,CAAC;IAC7B,IAAI,KAAK,GAAG,KAAK,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAA2B,CAAC,EAAE,CAAC;gBAClD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,SAAS,mEAAmE,KAAK,EAAE,EAAE,CAAC;YACxI,CAAC;YACD,IAAI,GAAG,SAA2B,CAAC;QACrC,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,sBAAsB,IAAI,CAAC,CAAC,CAAC,uCAAuC,KAAK,EAAE,EAAE,CAAC;YAC7G,CAAC;YACD,OAAO,GAAG,CAAC,CAAC;QACd,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACnB,CAAC;aAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,KAAK,EAAE,EAAE,CAAC;QACpE,CAAC;aAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,SAAS,GAAG,GAAG,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mCAAmC,GAAG,OAAO,KAAK,EAAE,EAAE,CAAC;QACtF,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,4BAA4B,KAAK,EAAE,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QAC3B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,sBAAsB,MAAM,CAAC,MAAM,0BAA0B,KAAK,EAAE,EAAE,CAAC;IACtG,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,IAAI,IAAI,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAEhE,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE;YACP,SAAS,EAAE,WAAW;YACtB,MAAM;YACN,IAAI;YACJ,OAAO;YACP,IAAI,EAAE,YAAY;YAClB,KAAK;SACN;KACF,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAwB,CAAC;IAC9E,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAeD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAuB,EAAE,OAAoB,EAAE;IAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IAEpD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QAC5C,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAE5B,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,SAAS,6CAA6C,CAAC,CAAC;QACtG,OAAO,CAAC,CAAC;IACX,CAAC;IAED,gDAAgD;IAChD,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,kCAAkC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;YACpE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7E,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,iFAAiF,CAAC,CAAC;QAC/I,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QAC7B,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,uCAAuC,CAAC,CAAC;IAC7C,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC;QACxD,QAAQ,GAAG,MAAM,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,GAAG,CAAC,8BAA8B,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,yBAAyB,IAAI,yBAAyB,CAAC;QACxE,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,GAAG,CAAC,oCAAoC,IAAI,CAAC,SAAS,MAAM,CAAC,CAAC;IAC9D,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,cAAc,EAAE,CAAC;IACjE,aAAa,CAAC,GAAG,IAAI,CAAC,SAAS,eAAe,EAAE,iBAAiB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;IACzG,aAAa,CAAC,GAAG,IAAI,CAAC,SAAS,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3F,aAAa,CAAC,GAAG,IAAI,CAAC,SAAS,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzF,aAAa,CAAC,GAAG,IAAI,CAAC,SAAS,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3D,aAAa,CAAC,GAAG,IAAI,CAAC,SAAS,YAAY,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7I,aAAa,CAAC,GAAG,IAAI,CAAC,SAAS,eAAe,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACpE,aAAa,CAAC,GAAG,IAAI,CAAC,SAAS,aAAa,EAAE,eAAe,EAAE,CAAC,CAAC;IAEjE,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAClC,GAAG,CAAC,wBAAwB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACxD,GAAG,CAAC,+BAA+B,CAAC,CAAC;IACrC,GAAG,CAAC,oEAAoE,CAAC,CAAC;IAC1E,GAAG,CAAC,gCAAgC,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -19,7 +19,14 @@ signal?: AbortSignal,
  * actually get their own hooks + labels run instead of silently
  * falling back to Mars while the page title shows the custom name.
  */
-scenario?: ScenarioPackage): Promise<void>;
+scenario?: ScenarioPackage, 
+/**
+ * Optional callback fired after each leader's artifact completes.
+ * server-app uses this to insert a RunRecord per artifact into
+ * 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>;
 /**
  * Single-leader fork dispatch (Spec 2B). When `/setup` receives a
  * config with `forkFrom` set, the server branches here instead of
@@ -36,5 +43,21 @@ scenario?: ScenarioPackage): Promise<void>;
  * snapshots, single-leader guard) happened in the `/setup` handler
  * before this function is reached.
  */
-export declare function runForkSimulation(simConfig: NormalizedSimulationConfig, broadcast: BroadcastFn, signal?: AbortSignal, scenario?: ScenarioPackage): Promise<void>;
+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>;
+/**
+ * Generalized N-leader batch runner (Tier 5 Quickstart). Three or more
+ * leaders run against the same scenario + seed in parallel, each
+ * emitting per-leader SSE events identical to the pair path. No
+ * verdict generation: verdicts compare exactly two leaders and would
+ * be ambiguous across N >= 3. The dashboard's Quickstart tab surfaces
+ * group-median deltas instead.
+ *
+ * Per-leader tags are derived from archetype (lowercased, kebab-cased).
+ * Duplicate archetype strings get trailing indices for disambiguation.
+ */
+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>;
 //# 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,GACvC,OAAO,CAAC,IAAI,CAAC,CA2Lf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,0BAA0B,EACrC,SAAS,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,GAAE,eAA8B,GACvC,OAAO,CAAC,IAAI,CAAC,CA8Ef"}
+{"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"}

package/dist/cli/pair-runner.js

@@ -39,7 +39,14 @@ signal,
  * actually get their own hooks + labels run instead of silently
  * falling back to Mars while the page title shows the custom name.
  */
-scenario = marsScenario) {
+scenario = marsScenario, 
+/**
+ * Optional callback fired after each leader's artifact completes.
+ * server-app uses this to insert a RunRecord per artifact into
+ * the SQLite run-history store. Failures inside the callback are
+ * caught and logged so a failing handler does not break the run.
+ */
+onArtifact) {
     const { leaders, turns, seed, startTime, liveSearch, customEvents } = simConfig;
     broadcast('status', { phase: 'starting', maxTurns: turns, customEvents });
     const { runSimulation } = await import('../runtime/orchestrator.js');
@@ -74,7 +81,8 @@ scenario = marsScenario) {
             execution: simConfig.execution,
             scenario,
             signal,
-        }).then(result => {
+            captureSnapshots: simConfig.captureSnapshots ?? false,
+        }).then(async (result) => {
             broadcast('result', {
                 leader: tag,
                 summary: {
@@ -84,7 +92,21 @@ scenario = marsScenario) {
                     citations: result.citations?.length ?? 0,
                 },
                 fingerprint: result.fingerprint ?? null,
+                // Spec 2B bridge: emit the full artifact on result when
+                // snapshot capture was on so the dashboard can fork from it
+                // without reconstructing from the event stream. Skipped when
+                // captureSnapshots is off to keep the SSE payload lean on
+                // hosted-demo runs that don't need fork capability.
+                artifact: simConfig.captureSnapshots ? result : undefined,
             });
+            if (onArtifact) {
+                try {
+                    await onArtifact(result, leader);
+                }
+                catch (err) {
+                    console.warn('[pair-runner] onArtifact handler failed:', err);
+                }
+            }
             return { tag, leader, result };
         }, error => {
             broadcast('sim_error', { leader: tag, error: String(error) });
@@ -107,8 +129,8 @@ scenario = marsScenario) {
     if (settled.length === 2) {
         try {
             const [a, b] = settled;
-            const colA = a.result.finalState?.systems;
-            const colB = b.result.finalState?.systems;
+            const colA = a.result.finalState?.metrics;
+            const colB = b.result.finalState?.metrics;
             const verdictModel = resolveVerdictModel(simConfig.provider || 'openai', simConfig.economics);
             if (!verdictModel) {
                 broadcast('complete', {
@@ -238,7 +260,9 @@ Then fill out:
  * snapshots, single-leader guard) happened in the `/setup` handler
  * before this function is reached.
  */
-export async function runForkSimulation(simConfig, broadcast, signal, scenario = marsScenario) {
+export async function runForkSimulation(simConfig, broadcast, signal, scenario = marsScenario, 
+/** Optional callback fired after the forked artifact completes. */
+onArtifact) {
     if (!simConfig.forkFrom) {
         throw new Error('runForkSimulation called without simConfig.forkFrom set');
     }
@@ -295,7 +319,20 @@ export async function runForkSimulation(simConfig, broadcast, signal, scenario =
             },
             fingerprint: result.fingerprint ?? null,
             forkedFrom: result.metadata.forkedFrom,
+            // Fork runs always have captureSnapshots forced on (see
+            // simulate call above); emit the full artifact so the dashboard
+            // can keep forking recursively without the event-stream
+            // reconstruction the spec originally assumed.
+            artifact: result,
         });
+        if (onArtifact) {
+            try {
+                await onArtifact(result, leader);
+            }
+            catch (err) {
+                console.warn('[fork-runner] onArtifact handler failed:', err);
+            }
+        }
     }
     catch (err) {
         broadcast('sim_error', { leader: leader.archetype, error: String(err) });
@@ -303,4 +340,103 @@ export async function runForkSimulation(simConfig, broadcast, signal, scenario =
     }
     broadcast('complete', { timestamp: new Date().toISOString(), fork: true });
 }
+/**
+ * Generalized N-leader batch runner (Tier 5 Quickstart). Three or more
+ * leaders run against the same scenario + seed in parallel, each
+ * emitting per-leader SSE events identical to the pair path. No
+ * verdict generation: verdicts compare exactly two leaders and would
+ * be ambiguous across N >= 3. The dashboard's Quickstart tab surfaces
+ * group-median deltas instead.
+ *
+ * Per-leader tags are derived from archetype (lowercased, kebab-cased).
+ * Duplicate archetype strings get trailing indices for disambiguation.
+ */
+export async function runBatchSimulations(simConfig, broadcast, signal, scenario = marsScenario, 
+/** Optional callback fired after each leader's artifact completes. */
+onArtifact) {
+    const { leaders, turns, seed, startTime, liveSearch, customEvents } = simConfig;
+    broadcast('status', { phase: 'starting', maxTurns: turns, customEvents, batch: true, leaderCount: leaders.length });
+    const { runSimulation } = await import('../runtime/orchestrator.js');
+    const onEvent = (event) => broadcast('sim', event);
+    broadcast('status', {
+        phase: 'parallel',
+        batch: true,
+        leaders: leaders.map(leader => ({
+            name: leader.name,
+            archetype: leader.archetype,
+            unit: leader.unit,
+            hexaco: leader.hexaco,
+        })),
+    });
+    console.log(`  Running batch: ${leaders.map(l => l.name).join(' vs ')} | ${turns} turns | seed ${seed}
+`);
+    const usedTags = new Map();
+    const leadersWithTags = leaders.map((leader, index) => {
+        const base = leader.archetype.toLowerCase().replace(/^the\s+/, '').replace(/\s+/g, '-') || `leader-${index}`;
+        const count = usedTags.get(base) ?? 0;
+        usedTags.set(base, count + 1);
+        const tag = count === 0 ? base : `${base}-${count + 1}`;
+        return { leader, index, tag };
+    });
+    const settled = await Promise.allSettled(leadersWithTags.map(({ leader, index, tag }) => {
+        return runSimulation(leader, simConfig.keyPersonnel ?? DEFAULT_KEY_PERSONNEL, {
+            maxTurns: turns,
+            seed,
+            startTime,
+            timePerTurn: simConfig.timePerTurn,
+            liveSearch,
+            activeDepartments: simConfig.activeDepartments,
+            onEvent,
+            customEvents,
+            provider: simConfig.provider,
+            models: simConfig.models,
+            economics: simConfig.economics,
+            initialPopulation: simConfig.initialPopulation,
+            startingResources: simConfig.startingResources,
+            startingPolitics: simConfig.startingPolitics,
+            execution: simConfig.execution,
+            scenario,
+            signal,
+            captureSnapshots: simConfig.captureSnapshots ?? false,
+        }).then(async (result) => {
+            broadcast('result', {
+                leader: tag,
+                leaderIndex: index,
+                summary: {
+                    population: result.finalState?.metrics?.population,
+                    morale: result.finalState?.metrics?.morale,
+                    toolsForged: result.forgedTools?.length ?? 0,
+                    citations: result.citations?.length ?? 0,
+                },
+                fingerprint: result.fingerprint ?? null,
+                artifact: simConfig.captureSnapshots ? result : undefined,
+            });
+            if (onArtifact) {
+                try {
+                    await onArtifact(result, leader);
+                }
+                catch (err) {
+                    console.warn('[batch-runner] onArtifact handler failed:', err);
+                }
+            }
+            return result;
+        }, error => {
+            broadcast('sim_error', { leader: tag, leaderIndex: index, error: String(error) });
+            throw error;
+        });
+    }));
+    // Mirror runPairSimulations: surface aborted/provider-error at the
+    // terminal event so the dashboard can badge the session as
+    // interrupted. We consider the batch aborted when every leader
+    // failed or reported abortion; a single success still counts as
+    // a successful batch run.
+    const fulfilled = settled.filter(s => s.status === 'fulfilled')
+        .map(s => s.value);
+    const allAborted = fulfilled.length === 0 || fulfilled.every(v => v?.aborted === true || !!v?.providerError);
+    broadcast('complete', {
+        timestamp: new Date().toISOString(),
+        batch: true,
+        ...(allAborted ? { aborted: true } : {}),
+    });
+}
 //# sourceMappingURL=pair-runner.js.map