@mobrienv/autoloop 0.1.2

package/dist/registry/derive.d.ts

@@ -0,0 +1,8 @@
+import type { RegistryStatus, RunRecord } from "./types.js";
+/**
+ * Derive run records from raw journal lines.
+ * Each `loop.start` creates a new record; subsequent events update it.
+ * Returns one record per run_id, reflecting the final known state.
+ */
+export declare function deriveRunRecords(lines: string[]): RunRecord[];
+export declare function stopReasonToStatus(reason: string): RegistryStatus;

package/dist/registry/derive.js

@@ -0,0 +1,81 @@
+import { decodeEvent } from "../events/decode.js";
+import { normalizeBackendLabel } from "../backend/index.js";
+/**
+ * Derive run records from raw journal lines.
+ * Each `loop.start` creates a new record; subsequent events update it.
+ * Returns one record per run_id, reflecting the final known state.
+ */
+export function deriveRunRecords(lines) {
+    const runs = new Map();
+    for (const line of lines) {
+        const event = decodeEvent(line);
+        if (!event)
+            continue;
+        const runId = event.run;
+        if (!runId)
+            continue;
+        const topic = String(event.topic);
+        if (topic === "loop.start" && event.shape === "fields") {
+            const f = event.fields;
+            runs.set(runId, {
+                run_id: runId,
+                status: "running",
+                preset: f.preset ?? "",
+                objective: f.objective ?? "",
+                trigger: f.trigger ?? "",
+                project_dir: f.project_dir ?? "",
+                work_dir: f.work_dir ?? "",
+                state_dir: "",
+                journal_file: "",
+                parent_run_id: f.parent_run_id ?? "",
+                backend: normalizeBackendLabel(f.backend ?? ""),
+                created_at: f.created_at ?? "",
+                updated_at: f.created_at ?? "",
+                iteration: 0,
+                stop_reason: "",
+                latest_event: topic,
+            });
+            continue;
+        }
+        const record = runs.get(runId);
+        if (!record)
+            continue;
+        if (topic === "iteration.finish") {
+            const iter = event.iteration ? parseInt(event.iteration, 10) : record.iteration;
+            record.iteration = Number.isNaN(iter) ? record.iteration : iter;
+            record.updated_at = record.created_at;
+            record.latest_event = topic;
+            continue;
+        }
+        if (topic === "loop.complete") {
+            record.status = "completed";
+            record.stop_reason = fieldValue(event, "reason");
+            record.updated_at = record.created_at;
+            record.latest_event = topic;
+            continue;
+        }
+        if (topic === "loop.stop") {
+            record.status = stopReasonToStatus(fieldValue(event, "reason"));
+            record.stop_reason = fieldValue(event, "reason");
+            record.updated_at = record.created_at;
+            record.latest_event = topic;
+            continue;
+        }
+    }
+    return Array.from(runs.values());
+}
+function fieldValue(event, key) {
+    if (!event)
+        return "";
+    if (event.shape === "fields")
+        return event.fields[key] ?? "";
+    return "";
+}
+export function stopReasonToStatus(reason) {
+    if (reason === "backend_failed")
+        return "failed";
+    if (reason === "backend_timeout")
+        return "timed_out";
+    return "stopped";
+}
+//# sourceMappingURL=derive.js.map

package/dist/registry/derive.js.map

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

package/dist/registry/harness.d.ts

@@ -0,0 +1,7 @@
+import type { LoopContext } from "../harness/types.js";
+import type { RegistryStatus } from "./types.js";
+export declare function registryStart(loop: LoopContext): void;
+export declare function registryProgress(loop: LoopContext, iteration: number): void;
+export declare function registryTerminal(loop: LoopContext, iteration: number, status: RegistryStatus, stopReason: string, latestEvent: string): void;
+export declare function registryComplete(loop: LoopContext, iteration: number, reason: string): void;
+export declare function registryStop(loop: LoopContext, iteration: number, reason: string): void;

package/dist/registry/harness.js

@@ -0,0 +1,57 @@
+import { normalizeBackendLabel } from "../backend/index.js";
+import { appendRegistryEntry } from "./update.js";
+import { getRun } from "./read.js";
+import { stopReasonToStatus } from "./derive.js";
+function registryPath(loop) {
+    return loop.paths.registryFile;
+}
+function baseRecord(loop) {
+    return {
+        run_id: loop.runtime.runId,
+        status: "running",
+        preset: loop.launch.preset,
+        objective: loop.objective,
+        trigger: loop.launch.trigger,
+        project_dir: loop.paths.projectDir,
+        work_dir: loop.paths.workDir,
+        state_dir: loop.paths.stateDir,
+        journal_file: loop.paths.journalFile,
+        parent_run_id: loop.launch.parentRunId,
+        backend: normalizeBackendLabel(loop.backend.command),
+        created_at: loop.launch.createdAt,
+        updated_at: new Date().toISOString(),
+        iteration: 0,
+        stop_reason: "",
+        latest_event: "loop.start",
+    };
+}
+export function registryStart(loop) {
+    appendRegistryEntry(registryPath(loop), baseRecord(loop));
+}
+export function registryProgress(loop, iteration) {
+    const path = registryPath(loop);
+    const existing = getRun(path, loop.runtime.runId);
+    const record = existing ? { ...existing } : baseRecord(loop);
+    record.iteration = iteration;
+    record.updated_at = new Date().toISOString();
+    record.latest_event = "iteration.finish";
+    appendRegistryEntry(path, record);
+}
+export function registryTerminal(loop, iteration, status, stopReason, latestEvent) {
+    const path = registryPath(loop);
+    const existing = getRun(path, loop.runtime.runId);
+    const record = existing ? { ...existing } : baseRecord(loop);
+    record.status = status;
+    record.iteration = iteration;
+    record.stop_reason = stopReason;
+    record.updated_at = new Date().toISOString();
+    record.latest_event = latestEvent;
+    appendRegistryEntry(path, record);
+}
+export function registryComplete(loop, iteration, reason) {
+    registryTerminal(loop, iteration, "completed", reason, "loop.complete");
+}
+export function registryStop(loop, iteration, reason) {
+    registryTerminal(loop, iteration, stopReasonToStatus(reason), reason, "loop.stop");
+}
+//# sourceMappingURL=harness.js.map

package/dist/registry/harness.js.map

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

package/dist/registry/index.d.ts

@@ -0,0 +1,5 @@
+export type { RegistryStatus, RunRecord } from "./types.js";
+export { deriveRunRecords, stopReasonToStatus } from "./derive.js";
+export { readRegistry, getRun, activeRuns, recentRuns, findRunByPrefix } from "./read.js";
+export { appendRegistryEntry } from "./update.js";
+export { rebuildRegistry } from "./rebuild.js";

package/dist/registry/index.js

@@ -0,0 +1,5 @@
+export { deriveRunRecords, stopReasonToStatus } from "./derive.js";
+export { readRegistry, getRun, activeRuns, recentRuns, findRunByPrefix } from "./read.js";
+export { appendRegistryEntry } from "./update.js";
+export { rebuildRegistry } from "./rebuild.js";
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/registry/read.d.ts

@@ -0,0 +1,11 @@
+import type { RunRecord } from "./types.js";
+export declare function readRegistry(path: string): RunRecord[];
+export declare function getRun(path: string, runId: string): RunRecord | undefined;
+export declare function activeRuns(path: string): RunRecord[];
+export declare function recentRuns(path: string, limit: number): RunRecord[];
+/**
+ * Find a run by exact or prefix match.
+ * Returns the matched record, or an array of candidates if ambiguous.
+ * Returns undefined if no match.
+ */
+export declare function findRunByPrefix(path: string, partial: string): RunRecord | RunRecord[] | undefined;

package/dist/registry/read.js

@@ -0,0 +1,50 @@
+import { existsSync, readFileSync } from "node:fs";
+export function readRegistry(path) {
+    if (!existsSync(path))
+        return [];
+    const text = readFileSync(path, "utf-8");
+    const entries = new Map();
+    for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const record = JSON.parse(trimmed);
+            if (record.run_id)
+                entries.set(record.run_id, record);
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return Array.from(entries.values());
+}
+export function getRun(path, runId) {
+    return readRegistry(path).find((r) => r.run_id === runId);
+}
+export function activeRuns(path) {
+    return readRegistry(path).filter((r) => r.status === "running");
+}
+export function recentRuns(path, limit) {
+    const all = readRegistry(path);
+    all.sort((a, b) => b.updated_at.localeCompare(a.updated_at));
+    return all.slice(0, limit);
+}
+/**
+ * Find a run by exact or prefix match.
+ * Returns the matched record, or an array of candidates if ambiguous.
+ * Returns undefined if no match.
+ */
+export function findRunByPrefix(path, partial) {
+    const all = readRegistry(path);
+    const exact = all.find((r) => r.run_id === partial);
+    if (exact)
+        return exact;
+    const matches = all.filter((r) => r.run_id.startsWith(partial));
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length > 1)
+        return matches;
+    return undefined;
+}
+//# sourceMappingURL=read.js.map

package/dist/registry/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/registry/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGnD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;YAChD,IAAI,MAAM,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,KAAa;IAChD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAa;IACpD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7D,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe;IAC3D,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;IACpD,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACvC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/registry/rebuild.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Rebuild the registry JSONL from the canonical journal.
+ * Overwrites the registry file with derived state.
+ */
+export declare function rebuildRegistry(journalPath: string, registryPath: string): void;

package/dist/registry/rebuild.js

@@ -0,0 +1,19 @@
+import { readFileSync, existsSync, writeFileSync } from "node:fs";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { deriveRunRecords } from "./derive.js";
+/**
+ * Rebuild the registry JSONL from the canonical journal.
+ * Overwrites the registry file with derived state.
+ */
+export function rebuildRegistry(journalPath, registryPath) {
+    if (!existsSync(journalPath))
+        return;
+    const text = readFileSync(journalPath, "utf-8");
+    const lines = text.split("\n").map((l) => l.trim()).filter((l) => l !== "");
+    const records = deriveRunRecords(lines);
+    mkdirSync(dirname(registryPath), { recursive: true });
+    const content = records.map((r) => JSON.stringify(r)).join("\n") + (records.length > 0 ? "\n" : "");
+    writeFileSync(registryPath, content, "utf-8");
+}
+//# sourceMappingURL=rebuild.js.map

package/dist/registry/rebuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild.js","sourceRoot":"","sources":["../../src/registry/rebuild.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,YAAoB;IACvE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO;IACrC,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpG,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/dist/registry/types.d.ts

@@ -0,0 +1,19 @@
+export type RegistryStatus = "running" | "completed" | "failed" | "timed_out" | "stopped";
+export interface RunRecord {
+    run_id: string;
+    status: RegistryStatus;
+    preset: string;
+    objective: string;
+    trigger: string;
+    project_dir: string;
+    work_dir: string;
+    state_dir: string;
+    journal_file: string;
+    parent_run_id: string;
+    backend: string;
+    created_at: string;
+    updated_at: string;
+    iteration: number;
+    stop_reason: string;
+    latest_event: string;
+}

package/dist/registry/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/registry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":""}

package/dist/registry/update.d.ts

@@ -0,0 +1,2 @@
+import type { RunRecord } from "./types.js";
+export declare function appendRegistryEntry(path: string, record: RunRecord): void;

package/dist/registry/update.js

@@ -0,0 +1,7 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+export function appendRegistryEntry(path, record) {
+    mkdirSync(dirname(path), { recursive: true });
+    appendFileSync(path, JSON.stringify(record) + "\n", "utf-8");
+}
+//# sourceMappingURL=update.js.map

package/dist/registry/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/registry/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,MAAiB;IACjE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/D,CAAC"}

package/dist/testing/mock-backend.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Deterministic mock backend for autoloop integration tests.
+ *
+ * Usage:
+ *   node dist/testing/mock-backend.js [fixture-path] [prompt]
+ *
+ * Reads MOCK_FIXTURE_PATH to find a JSON fixture describing the output,
+ * or accepts a fixture path as the first positional argument.
+ */
+export {};

package/dist/testing/mock-backend.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * Deterministic mock backend for autoloop integration tests.
+ *
+ * Usage:
+ *   node dist/testing/mock-backend.js [fixture-path] [prompt]
+ *
+ * Reads MOCK_FIXTURE_PATH to find a JSON fixture describing the output,
+ * or accepts a fixture path as the first positional argument.
+ */
+import { readFileSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+function fixturePathFromArgs() {
+    return process.argv[2] ?? "";
+}
+function loadFixture() {
+    const fixturePath = process.env["MOCK_FIXTURE_PATH"] || fixturePathFromArgs();
+    if (!fixturePath) {
+        process.stderr.write("mock-backend: fixture path missing (set MOCK_FIXTURE_PATH or pass a fixture path argument)\n");
+        process.exit(2);
+    }
+    try {
+        const raw = readFileSync(fixturePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return {
+            output: parsed.output ?? "",
+            exit_code: parsed.exit_code ?? 0,
+            delay_ms: parsed.delay_ms ?? 0,
+            emit_event: parsed.emit_event,
+            emit_payload: parsed.emit_payload,
+        };
+    }
+    catch (err) {
+        process.stderr.write(`mock-backend: failed to load fixture: ${err}\n`);
+        process.exit(2);
+    }
+}
+function emitEvent(event, payload) {
+    const currentFile = fileURLToPath(import.meta.url);
+    const distDir = dirname(dirname(currentFile));
+    const mainEntry = resolve(distDir, "main.js");
+    try {
+        execFileSync(process.execPath, [mainEntry, "emit", event, payload], {
+            encoding: "utf-8",
+            timeout: 5_000,
+            stdio: ["pipe", "pipe", "inherit"],
+            env: process.env,
+        });
+    }
+    catch (err) {
+        process.stderr.write(`mock-backend: emit failed: ${err}\n`);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function main() {
+    const fixture = loadFixture();
+    if (fixture.delay_ms > 0) {
+        await sleep(fixture.delay_ms);
+    }
+    if (fixture.emit_event) {
+        emitEvent(fixture.emit_event, fixture.emit_payload ?? "");
+    }
+    if (fixture.output) {
+        process.stdout.write(fixture.output);
+    }
+    process.exitCode = fixture.exit_code;
+}
+main().catch((err) => {
+    process.stderr.write(`mock-backend: unexpected error: ${err}\n`);
+    process.exitCode = 2;
+});
+//# sourceMappingURL=mock-backend.js.map

package/dist/testing/mock-backend.js.map

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

package/dist/topology.d.ts

@@ -0,0 +1,25 @@
+export interface Role {
+    id: string;
+    prompt: string;
+    promptFile: string;
+    emits: string[];
+}
+export interface Topology {
+    name: string;
+    completion: string;
+    roles: Role[];
+    handoff: Record<string, string[]>;
+    handoffKeys: string[];
+}
+export declare function eventMatchesAny(topic: string, patterns: string[]): boolean;
+export declare function getRoleIds(topology: Topology): string[];
+export declare function allEmittedEvents(topology: Topology): string[];
+export declare function handoffKeys(topology: Topology): string[];
+export declare function handoffTargetIds(topology: Topology): string[];
+export declare function loadTopology(projectDir: string): Topology;
+export declare function completionEvent(topology: Topology, fallback: string): string;
+export declare function suggestedRoles(topology: Topology, recentEvent: string): string[];
+export declare function allowedEvents(topology: Topology, recentEvent: string): string[];
+export declare function roleCount(topology: Topology): number;
+export declare function render(topology: Topology, recentEvent: string): string;
+export declare function renderWithContext(topology: Topology, recentEvent: string, suggested: string[], allowed: string[]): string;

package/dist/topology.js

@@ -0,0 +1,188 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import TOML from "@iarna/toml";
+import { listContains, listText, lineSep } from "./utils.js";
+export function eventMatchesAny(topic, patterns) {
+    for (const pattern of patterns) {
+        if (eventMatchesPattern(topic, pattern))
+            return true;
+    }
+    return false;
+}
+export function getRoleIds(topology) {
+    return topology.roles.map((r) => r.id);
+}
+export function allEmittedEvents(topology) {
+    const all = [];
+    for (const role of topology.roles) {
+        for (const e of role.emits) {
+            if (!all.includes(e))
+                all.push(e);
+        }
+    }
+    return all;
+}
+export function handoffKeys(topology) {
+    return topology.handoffKeys;
+}
+export function handoffTargetIds(topology) {
+    const all = [];
+    for (const key of topology.handoffKeys) {
+        for (const target of topology.handoff[key] ?? []) {
+            if (!all.includes(target))
+                all.push(target);
+        }
+    }
+    return all;
+}
+export function loadTopology(projectDir) {
+    const path = join(projectDir, "topology.toml");
+    if (!existsSync(path))
+        return defaultTopology();
+    return loadExisting(path, projectDir);
+}
+export function completionEvent(topology, fallback) {
+    return topology.completion || fallback;
+}
+export function suggestedRoles(topology, recentEvent) {
+    const roles = collectMatchingRoles(topology, recentEvent);
+    if (roles.length === 0)
+        return getRoleIds(topology);
+    return roles;
+}
+export function allowedEvents(topology, recentEvent) {
+    const roleIds = suggestedRoles(topology, recentEvent);
+    return collectEventsForRoles(topology.roles, roleIds);
+}
+export function roleCount(topology) {
+    return topology.roles.length;
+}
+export function render(topology, recentEvent) {
+    if (topology.roles.length === 0)
+        return "";
+    const suggested = suggestedRoles(topology, recentEvent);
+    const allowed = allowedEvents(topology, recentEvent);
+    return renderWithContext(topology, recentEvent, suggested, allowed);
+}
+export function renderWithContext(topology, recentEvent, suggested, allowed) {
+    if (topology.roles.length === 0)
+        return "";
+    return ("Topology (advisory):\n" +
+        "Recent routing event: " + recentEvent + "\n" +
+        "Suggested next roles: " + listText(suggested) + "\n" +
+        "Allowed next events: " + listText(allowed) + "\n\n" +
+        "Role deck:\n" +
+        renderRoles(topology.roles));
+}
+function defaultTopology() {
+    return { name: "", completion: "", roles: [], handoff: {}, handoffKeys: [] };
+}
+function loadExisting(path, projectDir) {
+    const text = readFileSync(path, "utf-8");
+    const parsed = TOML.parse(text);
+    return buildTopology(parsed, projectDir);
+}
+function buildTopology(parsed, projectDir) {
+    const name = typeof parsed.name === "string" ? parsed.name : "";
+    const completion = typeof parsed.completion === "string" ? parsed.completion : "";
+    const rawRoles = (parsed.role ?? []);
+    const roles = rawRoles
+        .filter((r) => typeof r.id === "string" && r.id !== "")
+        .map((r) => {
+        const role = {
+            id: r.id,
+            prompt: typeof r.prompt === "string" ? r.prompt : "",
+            promptFile: typeof r.prompt_file === "string" ? r.prompt_file : "",
+            emits: Array.isArray(r.emits) ? r.emits.map(String) : [],
+        };
+        return { ...role, prompt: rolePrompt(role, projectDir) };
+    });
+    const rawHandoff = (parsed.handoff ?? {});
+    const handoff = {};
+    const handoffKeys = [];
+    for (const [key, value] of Object.entries(rawHandoff)) {
+        handoff[key] = Array.isArray(value) ? value.map(String) : [String(value)];
+        handoffKeys.push(key);
+    }
+    return { name, completion, roles, handoff, handoffKeys };
+}
+function rolePrompt(role, projectDir) {
+    if (role.prompt)
+        return role.prompt;
+    if (!role.promptFile)
+        return "";
+    return readPromptFile(projectDir, role.promptFile);
+}
+function readPromptFile(projectDir, promptFile) {
+    const fullPath = join(projectDir, promptFile);
+    if (!existsSync(fullPath))
+        return "";
+    return readFileSync(fullPath, "utf-8");
+}
+function collectMatchingRoles(topology, event) {
+    const acc = [];
+    for (const key of topology.handoffKeys) {
+        if (eventMatchesPattern(event, key)) {
+            for (const roleId of topology.handoff[key] ?? []) {
+                if (!acc.includes(roleId))
+                    acc.push(roleId);
+            }
+        }
+    }
+    return acc;
+}
+function collectEventsForRoles(roles, roleIds) {
+    const acc = [];
+    for (const role of roles) {
+        if (listContains(roleIds, role.id)) {
+            for (const e of role.emits) {
+                if (!acc.includes(e))
+                    acc.push(e);
+            }
+        }
+    }
+    return acc;
+}
+function eventMatchesPattern(topic, pattern) {
+    if (isRegexPattern(pattern)) {
+        return regexMatch(topic, stripRegexDelimiters(pattern));
+    }
+    return topic === pattern;
+}
+function isRegexPattern(value) {
+    return value.length >= 3 && value.startsWith("/") && value.endsWith("/");
+}
+function stripRegexDelimiters(value) {
+    return value.slice(1, -1);
+}
+function regexMatch(topic, pattern) {
+    try {
+        const re = new RegExp("^" + pattern + "$");
+        return re.test(topic);
+    }
+    catch {
+        return false;
+    }
+}
+function renderRoles(roles) {
+    let result = "";
+    for (const role of roles) {
+        result +=
+            "- role `" + role.id + "`\n" +
+                "  emits: " + listText(role.emits) + "\n" +
+                "  prompt: " + promptSummary(role.prompt) + "\n";
+    }
+    return result;
+}
+function promptSummary(prompt) {
+    if (!prompt)
+        return "(none)";
+    const lines = prompt.split(lineSep());
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed !== "")
+            return trimmed;
+    }
+    return "(none)";
+}
+//# sourceMappingURL=topology.js.map