@loompad/cli 0.1.0

package/dist/core/logbook.js.map

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

package/dist/core/memory.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Unified memory — "multiple memory in one".
+ *
+ * Every AI dev environment (ADE) keeps its own memory: Claude Code has
+ * CLAUDE.md, OpenCode has AGENTS.md, others have their own files. Loom's job
+ * is to make those ONE brain: it imports each connected ADE's native memory
+ * into the shared event log, merges it with the project's decisions and
+ * recent context, and projects the union back out on every handoff.
+ *
+ * Connect a new ADE → its existing knowledge joins the shared brain, and
+ * everything the other agents learned flows into it. That's the seam an
+ * isolation-first tool (separate worktrees) structurally can't own.
+ */
+import type { AgentConfig, LoomEvent, ProjectConfig, UnifiedMemory } from "../types.js";
+export declare function nativeMemoryFiles(agent: AgentConfig): string[];
+export interface ImportedBlock {
+    agentId: string;
+    kind: string;
+    file: string;
+    content: string;
+}
+/**
+ * Read every configured ADE's native memory from disk. Deduplicates by file
+ * path (agents commonly share AGENTS.md) — the first agent to claim a file
+ * owns it in the brain.
+ */
+export declare function readNativeMemory(projectDir: string, config: ProjectConfig): ImportedBlock[];
+export declare function hashContent(content: string): string;
+/**
+ * Build the unified brain document from the log + freshly-read native memory.
+ * This is what "multiple memory in one" produces, and what enriches every
+ * handoff projection.
+ */
+export declare function buildUnifiedMemory(projectName: string, events: LoomEvent[], imported: ImportedBlock[]): UnifiedMemory;

package/dist/core/memory.js

@@ -0,0 +1,124 @@
+/**
+ * Unified memory — "multiple memory in one".
+ *
+ * Every AI dev environment (ADE) keeps its own memory: Claude Code has
+ * CLAUDE.md, OpenCode has AGENTS.md, others have their own files. Loom's job
+ * is to make those ONE brain: it imports each connected ADE's native memory
+ * into the shared event log, merges it with the project's decisions and
+ * recent context, and projects the union back out on every handoff.
+ *
+ * Connect a new ADE → its existing knowledge joins the shared brain, and
+ * everything the other agents learned flows into it. That's the seam an
+ * isolation-first tool (separate worktrees) structurally can't own.
+ */
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+const MAX_IMPORT_CHARS = 8_000; // per source, keeps the brain bounded
+const RECENT_DECISIONS = 40;
+/**
+ * Where each ADE keeps its native, project-local memory. Project-scoped only
+ * by default — global files (e.g. ~/.claude/CLAUDE.md) are intentionally NOT
+ * imported so the shared brain stays about THIS project. Override per agent
+ * with `memoryFiles` in config.
+ */
+const NATIVE_MEMORY = {
+    "claude-code": ["CLAUDE.md", ".claude/CLAUDE.md", "AGENTS.md"],
+    // Codex reads AGENTS.md — that convention is OpenAI's, and it's the one most
+    // widely shared. `.codex/` is its own directory when a repo keeps them apart.
+    codex: ["AGENTS.md", ".codex/AGENTS.md", "codex.md"],
+    opencode: ["AGENTS.md", ".opencode/AGENTS.md", "opencode.md"],
+    "grok-code": ["AGENTS.md", ".grok/AGENTS.md", "GROK.md"],
+    antigravity: [".antigravity/memory.md", "AGENTS.md", ".windsurfrules"],
+    // Kiro keeps steering documents rather than one memory file; they're the
+    // closest thing it has to "what this agent knows about this repo".
+    kiro: [".kiro/steering/product.md", ".kiro/steering/tech.md", ".kiro/steering/structure.md", "AGENTS.md"],
+    echo: [],
+};
+export function nativeMemoryFiles(agent) {
+    if (agent.memoryFiles)
+        return agent.memoryFiles;
+    return NATIVE_MEMORY[agent.kind] ?? ["AGENTS.md"];
+}
+/**
+ * Read every configured ADE's native memory from disk. Deduplicates by file
+ * path (agents commonly share AGENTS.md) — the first agent to claim a file
+ * owns it in the brain.
+ */
+export function readNativeMemory(projectDir, config) {
+    const blocks = [];
+    const seenFiles = new Set();
+    for (const agent of config.agents) {
+        for (const rel of nativeMemoryFiles(agent)) {
+            const norm = rel.replace(/^\.\//, "");
+            if (seenFiles.has(norm))
+                continue;
+            const abs = path.join(projectDir, norm);
+            if (!fs.existsSync(abs))
+                continue;
+            try {
+                const raw = fs.readFileSync(abs, "utf8").trim();
+                if (!raw)
+                    continue;
+                seenFiles.add(norm);
+                blocks.push({
+                    agentId: agent.id,
+                    kind: agent.kind,
+                    file: norm,
+                    content: raw.length > MAX_IMPORT_CHARS ? raw.slice(0, MAX_IMPORT_CHARS) + "\n… (truncated)" : raw,
+                });
+            }
+            catch {
+                // Unreadable file — skip, never fatal.
+            }
+        }
+    }
+    return blocks;
+}
+export function hashContent(content) {
+    return crypto.createHash("sha1").update(content).digest("hex").slice(0, 12);
+}
+/**
+ * Build the unified brain document from the log + freshly-read native memory.
+ * This is what "multiple memory in one" produces, and what enriches every
+ * handoff projection.
+ */
+export function buildUnifiedMemory(projectName, events, imported) {
+    const decisions = events
+        .filter((e) => e.kind === "decision")
+        .map((e) => String(e.payload.text ?? ""))
+        .filter(Boolean)
+        .slice(-RECENT_DECISIONS);
+    const sources = imported.map((b) => ({
+        agentId: b.agentId,
+        kind: b.kind,
+        file: b.file,
+        chars: b.content.length,
+    }));
+    const lines = [];
+    lines.push(`# Loom unified memory — ${projectName}`);
+    lines.push("");
+    lines.push("> One brain across every connected agent. Merged from each ADE's native memory,", "> the project's decisions, and the shared thread. Regenerated on demand.");
+    lines.push("");
+    if (decisions.length) {
+        lines.push("## Decisions (shared across all agents)");
+        for (const d of decisions)
+            lines.push(`- ${d}`);
+        lines.push("");
+    }
+    if (imported.length) {
+        lines.push("## Imported from connected ADEs");
+        for (const b of imported) {
+            lines.push(`### ${b.agentId} · \`${b.file}\` (${b.kind})`);
+            lines.push("");
+            lines.push(b.content);
+            lines.push("");
+        }
+    }
+    if (!decisions.length && !imported.length) {
+        lines.push("_No decisions recorded yet and no ADE memory files found._");
+        lines.push("");
+    }
+    return { projectName, decisions, sources, document: lines.join("\n") };
+}
+//# sourceMappingURL=memory.js.map

package/dist/core/memory.js.map

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

package/dist/core/notify.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fire-and-notify — when a background agent needs input or finishes, tell
+ * the human. This is the local half: a desktop notification (macOS osascript /
+ * linux notify-send). The phone half rides the same event feed through Expo
+ * push — see daemon/push.ts.
+ */
+export interface Notification {
+    title: string;
+    body: string;
+}
+export declare function notify(n: Notification): void;

package/dist/core/notify.js

@@ -0,0 +1,30 @@
+/**
+ * Fire-and-notify — when a background agent needs input or finishes, tell
+ * the human. This is the local half: a desktop notification (macOS osascript /
+ * linux notify-send). The phone half rides the same event feed through Expo
+ * push — see daemon/push.ts.
+ */
+import { spawn } from "node:child_process";
+function run(cmd, args) {
+    try {
+        const child = spawn(cmd, args, { stdio: "ignore", detached: true });
+        child.unref();
+        child.on("error", () => { });
+    }
+    catch {
+        // Notifications are best-effort by design.
+    }
+}
+export function notify(n) {
+    if (process.env.LOOM_NO_NOTIFY)
+        return;
+    const body = n.body.replace(/"/g, "'").slice(0, 200);
+    const title = n.title.replace(/"/g, "'").slice(0, 60);
+    if (process.platform === "darwin") {
+        run("osascript", ["-e", `display notification "${body}" with title "${title}"`]);
+    }
+    else if (process.platform === "linux") {
+        run("notify-send", [title, body]);
+    }
+}
+//# sourceMappingURL=notify.js.map

package/dist/core/notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../src/core/notify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAO3C,SAAS,GAAG,CAAC,GAAW,EAAE,IAAc;IACtC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,CAAe;IACpC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO;IACvC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,yBAAyB,IAAI,iBAAiB,KAAK,GAAG,CAAC,CAAC,CAAC;IACnF,CAAC;SAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACxC,GAAG,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/core/projection.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Projections — rendering the event log into (a) a persistent, namespaced
+ * memory document for an agent, and (b) a short one-shot handoff briefing.
+ *
+ * v1 is deterministic (no LLM in the loop): a distillation template over the
+ * recent log. An LLM-synthesized variant can slot in behind the same
+ * signatures later.
+ */
+import type { LoomEvent, ProjectConfig } from "../types.js";
+export interface ProjectionInput {
+    projectName: string;
+    config: ProjectConfig;
+    events: LoomEvent[];
+    targetAgentId: string;
+    fromAgentId?: string | null;
+}
+/** Persistent memory document written to .loom/memory/<agent>.md. */
+export declare function buildProjection(input: ProjectionInput): string;
+/** Short one-shot briefing injected with the first turn after a handoff. */
+export declare function buildBriefing(input: ProjectionInput): string;

package/dist/core/projection.js

@@ -0,0 +1,96 @@
+/**
+ * Projections — rendering the event log into (a) a persistent, namespaced
+ * memory document for an agent, and (b) a short one-shot handoff briefing.
+ *
+ * v1 is deterministic (no LLM in the loop): a distillation template over the
+ * recent log. An LLM-synthesized variant can slot in behind the same
+ * signatures later.
+ */
+const MAX_MSG_CHARS = 300;
+const RECENT_MESSAGES = 30;
+const RECENT_FILES = 20;
+function truncate(text, max = MAX_MSG_CHARS) {
+    const oneLine = text.replace(/\s+/g, " ").trim();
+    return oneLine.length > max ? oneLine.slice(0, max - 1) + "…" : oneLine;
+}
+function author(e) {
+    return e.agentId ?? e.payload.author ?? "user";
+}
+/** Persistent memory document written to .loom/memory/<agent>.md. */
+export function buildProjection(input) {
+    const { projectName, config, events, targetAgentId } = input;
+    const messages = events.filter((e) => e.kind === "message").slice(-RECENT_MESSAGES);
+    const decisions = events.filter((e) => e.kind === "decision");
+    const handoffs = events.filter((e) => e.kind === "handoff").slice(-5);
+    const files = [
+        ...new Set(events
+            .filter((e) => e.kind === "file_edit")
+            .map((e) => String(e.payload.path ?? ""))
+            .filter(Boolean)),
+    ].slice(-RECENT_FILES);
+    const lines = [];
+    lines.push(`# Loom shared context — ${projectName}`);
+    lines.push("");
+    lines.push("> Managed by Loom. Do not edit — regenerated on every baton handoff.", `> You are \`${targetAgentId}\`. This is the shared state of the project across all agents.`);
+    lines.push("");
+    lines.push("## Agents & roles");
+    for (const a of config.agents) {
+        const marker = a.id === targetAgentId ? " ← you" : "";
+        lines.push(`- \`${a.id}\` (${a.kind}) — ${a.role}${marker}`);
+    }
+    lines.push("");
+    if (handoffs.length) {
+        lines.push("## Recent baton handoffs");
+        for (const h of handoffs) {
+            const from = h.payload.from ?? "—";
+            const to = h.payload.to ?? "—";
+            lines.push(`- ${new Date(h.ts).toISOString()}: ${from} → ${to}`);
+        }
+        lines.push("");
+    }
+    if (decisions.length) {
+        lines.push("## Decisions");
+        for (const d of decisions) {
+            lines.push(`- ${truncate(String(d.payload.text ?? ""))}`);
+        }
+        lines.push("");
+    }
+    if (messages.length) {
+        lines.push("## Recent conversation (condensed)");
+        for (const m of messages) {
+            lines.push(`- **${author(m)}**: ${truncate(String(m.payload.text ?? ""))}`);
+        }
+        lines.push("");
+    }
+    if (files.length) {
+        lines.push("## Files recently touched");
+        for (const f of files)
+            lines.push(`- \`${f}\``);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/** Short one-shot briefing injected with the first turn after a handoff. */
+export function buildBriefing(input) {
+    const { projectName, events, targetAgentId, fromAgentId } = input;
+    const messages = events.filter((e) => e.kind === "message").slice(-8);
+    const decisions = events.filter((e) => e.kind === "decision").slice(-6);
+    const lines = [];
+    lines.push(`[Loom handoff] You are "${targetAgentId}" picking up the baton for project "${projectName}"` +
+        (fromAgentId ? ` from "${fromAgentId}".` : "."));
+    lines.push(`A fuller shared-context document is at .loom/memory/${targetAgentId}.md — read it if you need more history.`);
+    if (decisions.length) {
+        lines.push("Key decisions so far:");
+        for (const d of decisions)
+            lines.push(`- ${truncate(String(d.payload.text ?? ""), 200)}`);
+    }
+    if (messages.length) {
+        lines.push("Most recent exchanges:");
+        for (const m of messages) {
+            lines.push(`- ${author(m)}: ${truncate(String(m.payload.text ?? ""), 200)}`);
+        }
+    }
+    lines.push("Continue the work seamlessly; do not re-ask for context the log already answers.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=projection.js.map

package/dist/core/projection.js.map

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

package/dist/core/registry.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Loom home (~/.loom) — project registry, daemon config, and per-project
+ * .loom/ config/state files.
+ *
+ * LOOM_HOME env var overrides the home directory (used heavily by tests).
+ */
+import type { ChatInfo, ProjectConfig, ProjectInfo, RouteState } from "../types.js";
+export declare function loomHome(): string;
+export declare function ensureLoomHome(): string;
+export declare function newId(bytes?: number): string;
+export declare function listProjects(): ProjectInfo[];
+export declare function findProject(idOrDirOrName: string): ProjectInfo | undefined;
+export declare function registerProject(dir: string, name: string): ProjectInfo;
+export declare function unregisterProject(id: string): void;
+export declare function projectLoomDir(projectDir: string): string;
+export declare function readProjectConfig(projectDir: string): ProjectConfig | null;
+export declare function writeProjectConfig(projectDir: string, cfg: ProjectConfig): void;
+/** Mutable per-project state: baton holder + adapter session state. */
+export interface ProjectState {
+    holder: string | null;
+    holderSince?: number;
+    agents: Record<string, Record<string, unknown>>;
+    /** Active (or last) multi-hop route. */
+    route?: RouteState;
+    /**
+     * Named conversations. The main chat is implicit — every project has it and
+     * it holds everything written before chats existed, so it isn't stored here.
+     * Kept in state rather than derived from the log so a chat you just made,
+     * and haven't said anything in yet, still exists.
+     */
+    chats?: ChatInfo[];
+    /** Task cards you wrote yourself. See BoardTask. */
+    tasks?: BoardTask[];
+}
+/**
+ * A card you made, as opposed to the ones the board derives from live agents
+ * and pull requests. Yours, so its column IS its state — dragging one really
+ * moves it, unlike a PR card whose truth belongs to GitHub.
+ */
+export interface BoardTask {
+    id: string;
+    title: string;
+    /** working | needs-you | in-review | ready — the column it lives in. */
+    column: string;
+    /** Optional agent this is meant for. */
+    agent?: string;
+    createdAt: number;
+}
+export declare function readProjectState(projectDir: string): ProjectState;
+export declare function writeProjectState(projectDir: string, state: ProjectState): void;
+/** Namespaced memory file Loom manages for an agent. Never a user file. */
+export declare function memoryFile(projectDir: string, agentId: string): string;
+export declare function writeMemoryFile(projectDir: string, agentId: string, content: string): string;
+export interface PairedClient {
+    id: string;
+    name: string;
+    token: string;
+    createdAt: number;
+    /** Expo push token, when the device registered for notifications. */
+    pushToken?: string;
+    platform?: string;
+}
+export interface DaemonConfig {
+    host: string;
+    port: number;
+    adminToken: string;
+    clients: PairedClient[];
+    pid?: number;
+}
+export declare function daemonConfigFile(): string;
+export declare function readDaemonConfig(): DaemonConfig | null;
+export declare function writeDaemonConfig(cfg: DaemonConfig): void;
+export declare function ensureDaemonConfig(defaults: {
+    host: string;
+    port: number;
+}): DaemonConfig;

package/dist/core/registry.js

@@ -0,0 +1,147 @@
+/**
+ * Loom home (~/.loom) — project registry, daemon config, and per-project
+ * .loom/ config/state files.
+ *
+ * LOOM_HOME env var overrides the home directory (used heavily by tests).
+ */
+import crypto from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { logbook } from "./logbook.js";
+export function loomHome() {
+    return process.env.LOOM_HOME ?? path.join(os.homedir(), ".loom");
+}
+export function ensureLoomHome() {
+    const home = loomHome();
+    fs.mkdirSync(home, { recursive: true });
+    return home;
+}
+/**
+ * Read a JSON file, or fall back.
+ *
+ * The fallback is right for a file that isn't there — a project with no
+ * state.json has no state, which is a fact rather than a fault. It is very
+ * wrong for a file that IS there and is corrupt: `.loom/config.json` with a
+ * trailing comma silently became an empty roster, which looks exactly like
+ * "my agents disappeared" and gives you nothing to search for.
+ *
+ * So: missing is quiet, unreadable is loud. Both still return the fallback —
+ * refusing to start because one file is damaged helps nobody — but the second
+ * one says so in the Console.
+ */
+function readJson(file, fallback) {
+    let raw;
+    try {
+        raw = fs.readFileSync(file, "utf8");
+    }
+    catch {
+        return fallback; // not there: nothing to report
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        logbook.warn("config", `${path.basename(file)} is unreadable — using defaults, so this will look like data went missing`, `${file}\n${err instanceof Error ? err.message : String(err)}`);
+        return fallback;
+    }
+}
+function writeJson(file, value, mode) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(value, null, 2) + "\n", mode ? { mode } : {});
+}
+export function newId(bytes = 6) {
+    return crypto.randomBytes(bytes).toString("hex");
+}
+function registryFile() {
+    return path.join(loomHome(), "registry.json");
+}
+export function listProjects() {
+    return readJson(registryFile(), { projects: [] }).projects;
+}
+export function findProject(idOrDirOrName) {
+    const projects = listProjects();
+    const dir = path.resolve(idOrDirOrName);
+    return projects.find((p) => p.id === idOrDirOrName || p.name === idOrDirOrName || path.resolve(p.dir) === dir);
+}
+export function registerProject(dir, name) {
+    ensureLoomHome();
+    const reg = readJson(registryFile(), { projects: [] });
+    const resolved = path.resolve(dir);
+    const existing = reg.projects.find((p) => path.resolve(p.dir) === resolved);
+    if (existing)
+        return existing;
+    const info = { id: newId(), name, dir: resolved };
+    reg.projects.push(info);
+    writeJson(registryFile(), reg);
+    return info;
+}
+export function unregisterProject(id) {
+    const reg = readJson(registryFile(), { projects: [] });
+    reg.projects = reg.projects.filter((p) => p.id !== id);
+    writeJson(registryFile(), reg);
+}
+// ---------------------------------------------------------------------------
+// Per-project files (<dir>/.loom/…)
+// ---------------------------------------------------------------------------
+export function projectLoomDir(projectDir) {
+    return path.join(projectDir, ".loom");
+}
+export function readProjectConfig(projectDir) {
+    const file = path.join(projectLoomDir(projectDir), "config.json");
+    if (!fs.existsSync(file))
+        return null;
+    return readJson(file, { name: path.basename(projectDir), agents: [] });
+}
+export function writeProjectConfig(projectDir, cfg) {
+    writeJson(path.join(projectLoomDir(projectDir), "config.json"), cfg);
+}
+export function readProjectState(projectDir) {
+    return readJson(path.join(projectLoomDir(projectDir), "state.json"), {
+        holder: null,
+        agents: {},
+    });
+}
+export function writeProjectState(projectDir, state) {
+    writeJson(path.join(projectLoomDir(projectDir), "state.json"), state);
+}
+/** Namespaced memory file Loom manages for an agent. Never a user file. */
+export function memoryFile(projectDir, agentId) {
+    return path.join(projectLoomDir(projectDir), "memory", `${agentId}.md`);
+}
+export function writeMemoryFile(projectDir, agentId, content) {
+    const file = memoryFile(projectDir, agentId);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, content);
+    return file;
+}
+export function daemonConfigFile() {
+    return path.join(loomHome(), "daemon.json");
+}
+export function readDaemonConfig() {
+    const file = daemonConfigFile();
+    if (!fs.existsSync(file))
+        return null;
+    return readJson(file, null);
+}
+export function writeDaemonConfig(cfg) {
+    ensureLoomHome();
+    writeJson(daemonConfigFile(), cfg, 0o600);
+}
+export function ensureDaemonConfig(defaults) {
+    const existing = readDaemonConfig();
+    if (existing)
+        return existing;
+    const cfg = {
+        host: defaults.host,
+        port: defaults.port,
+        adminToken: crypto.randomBytes(32).toString("hex"),
+        clients: [],
+    };
+    writeDaemonConfig(cfg);
+    return cfg;
+}
+// buildDefaultRoutes and defaultAgentConfigs live in core/ades.ts now: they are
+// answers about ADEs, and asking them here meant registry → ades → an adapter →
+// base → registry, a cycle whose module-init order is nobody's friend.
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

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

package/dist/core/router.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Hop routers for dynamic routes — after each step, decide who works next.
+ *
+ * Two brains, one interface:
+ *  - rulesRouter: deterministic role rules (free, offline, always available)
+ *  - llmRouter:   asks Claude (headless, JSON out) to pick the next hop,
+ *                 falling back to the rules on any failure
+ *
+ * Loom never lets a router run away: dynamic routes carry a hop budget and
+ * every decision lands in the event log with its reason.
+ */
+import type { AgentRole } from "../types.js";
+export interface RouterAgent {
+    id: string;
+    role: AgentRole;
+}
+export interface RouterContext {
+    task: string;
+    /** Agent ids of hops taken so far, in order. */
+    hops: string[];
+    /** Adapter-tier agents eligible for the next hop. */
+    agents: RouterAgent[];
+    /** Recent conversation: author (agent id or "user"/"loom") + text. */
+    recent: Array<{
+        author: string;
+        text: string;
+    }>;
+}
+export interface HopDecision {
+    next: string | "done";
+    reason: string;
+    /** Which brain produced this decision. */
+    by: "rules" | "llm";
+}
+/** Deterministic plan → execute → review → (fix loop) → done. */
+export declare function rulesRouter(ctx: RouterContext): HopDecision;
+export interface LlmRouterOptions {
+    /** Model for routing decisions; small+fast is right. */
+    model?: string;
+    timeoutMs?: number;
+}
+export declare function llmRouter(ctx: RouterContext, opts?: LlmRouterOptions): Promise<HopDecision>;