@loompad/cli 0.1.0

package/dist/cli/ui.js.map

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

package/dist/core/ades.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The ADEs Loom knows how to drive, in one list.
+ *
+ * This exists because "which agents are real" used to be answered in three
+ * places at once: a hardcoded probe pair in the daemon, a hardcoded pair in
+ * defaultAgentConfigs, and a set of logos in the web app that agreed with
+ * neither. The UI shipped Codex and Kiro marks for kinds `loom` would reject.
+ * One list, and the answer is the same everywhere.
+ *
+ * An entry here is a claim that Loom can actually drive the thing. If it can't
+ * yet, it doesn't get a row — a logo is not an integration.
+ */
+import type { AgentConfig } from "../types.js";
+export interface AdeSpec {
+    /** The agent kind, as written in .loom/config.json. */
+    kind: string;
+    /** Human name, for docs and UI. */
+    label: string;
+    /**
+     * adapter — can hold the baton and run a turn headless.
+     * bridge  — a GUI app Loom drives over the DevTools protocol; needs the app
+     *           running with a debugging port, so it is never auto-added.
+     */
+    tier: "adapter" | "bridge";
+    /** Is it usable on this machine right now? */
+    probe: () => Promise<boolean>;
+    /**
+     * Common model values this ADE's CLI accepts, as the model picker's
+     * suggestions. Not exhaustive and not the truth about what's installed —
+     * the picker always offers "Default" (no --model, the CLI's own choice) and
+     * a custom field, so a stale entry here is a convenience that went out of
+     * date, never a wall. Empty for bridges: a GUI app picks its own model in its
+     * own window, and Loom doesn't get a flag.
+     */
+    models?: string[];
+}
+/**
+ * Preference order matters: the first three adapters found get the canonical
+ * planner/executor/reviewer roles that the default "ship" route is built from.
+ */
+export declare const ADES: AdeSpec[];
+/** Which kinds can hold the baton. */
+export declare function adapterKinds(): string[];
+/**
+ * Probe every adapter on this machine, in parallel.
+ *
+ * Bridges are excluded on purpose: they need their GUI launched with a
+ * debugging port, so "installed" tells you nothing about "drivable", and a
+ * new project should not be born holding an agent that can't answer.
+ */
+export declare function detectAdes(): Promise<Record<string, boolean>>;
+/** Default "ship" pipeline over whichever of planner/executor/reviewer exist. */
+export declare function buildDefaultRoutes(agents: AgentConfig[]): Record<string, string[]> | undefined;
+/**
+ * The agents a new project starts with: the ADEs actually installed here, and
+ * nothing else.
+ *
+ * It used to fall back to an `echo` agent when it found none. echo is a test
+ * double — it replies with your own message and reports a made-up $0.001 — so
+ * a machine without claude or opencode got a project whose "agent" faked every
+ * turn, presented as a detected ADE. Better an empty roster and an honest "no
+ * ADEs found". (echo is still a registered kind; you can ask for it by name in
+ * .loom/config.json. It just isn't handed to anyone who didn't.)
+ *
+ * **Every agent's role is its own kind, and that isn't a placeholder.**
+ *
+ * This used to hand out planner / executor / reviewer by detection order, so
+ * Claude Code became "the planner" and OpenCode became "the executor" because
+ * of where they sat in a list in this file. Nobody decided that. It read like a
+ * recommendation Loom had earned, it was an accident of iteration order, and it
+ * quietly shaped how people used their own agents.
+ *
+ * A role is a job you define. Loom doesn't know which of your agents should
+ * plan, and pretending it does is worse than saying nothing — so the default
+ * describes rather than assigns ("codex" is codex), and you rename it to the
+ * job you actually have. The rail's agent picker does that; so does
+ * POST /api/projects/:id/agents/:agentId/role.
+ */
+export declare function defaultAgentConfigs(availability: Record<string, boolean>): AgentConfig[];

package/dist/core/ades.js

@@ -0,0 +1,130 @@
+/**
+ * The ADEs Loom knows how to drive, in one list.
+ *
+ * This exists because "which agents are real" used to be answered in three
+ * places at once: a hardcoded probe pair in the daemon, a hardcoded pair in
+ * defaultAgentConfigs, and a set of logos in the web app that agreed with
+ * neither. The UI shipped Codex and Kiro marks for kinds `loom` would reject.
+ * One list, and the answer is the same everywhere.
+ *
+ * An entry here is a claim that Loom can actually drive the thing. If it can't
+ * yet, it doesn't get a row — a logo is not an integration.
+ */
+import { cliAvailable } from "../adapters/base.js";
+import { codexBin } from "../adapters/codex.js";
+import { grokBin } from "../adapters/grok.js";
+/**
+ * Preference order matters: the first three adapters found get the canonical
+ * planner/executor/reviewer roles that the default "ship" route is built from.
+ */
+export const ADES = [
+    {
+        kind: "claude-code",
+        label: "Claude Code",
+        tier: "adapter",
+        // The CLI takes short aliases as well as full ids; the aliases don't go
+        // stale when a new snapshot ships, which the full ids do.
+        models: ["opus", "sonnet", "haiku"],
+        probe: () => cliAvailable("claude"),
+    },
+    {
+        kind: "codex",
+        label: "Codex",
+        tier: "adapter",
+        models: ["gpt-5-codex", "gpt-5", "o4-mini"],
+        // The CLI ships inside Codex.app as well as on PATH; a Mac with the app and
+        // an empty PATH is the common case.
+        probe: async () => {
+            const bin = codexBin();
+            return bin ? cliAvailable(bin) : false;
+        },
+    },
+    {
+        kind: "opencode",
+        label: "OpenCode",
+        tier: "adapter",
+        // opencode wants provider/model, and which providers exist is that install's
+        // business — so these are examples, and the custom field is the real path.
+        models: ["anthropic/claude-sonnet-4", "openai/gpt-5", "google/gemini-2.5-pro"],
+        probe: () => cliAvailable("opencode"),
+    },
+    {
+        kind: "grok-code",
+        label: "Grok Code",
+        tier: "adapter",
+        models: ["grok-code-fast-1", "grok-4"],
+        probe: async () => {
+            const bin = grokBin();
+            return bin ? cliAvailable(bin) : false;
+        },
+    },
+    {
+        kind: "antigravity",
+        label: "Antigravity",
+        tier: "bridge",
+        // Presence is decided by the debugging port, not by a file on disk: an
+        // installed-but-closed Antigravity is not something Loom can drive.
+        probe: async () => false,
+    },
+    {
+        kind: "kiro",
+        label: "Kiro",
+        tier: "bridge",
+        probe: async () => false,
+    },
+];
+/** Which kinds can hold the baton. */
+export function adapterKinds() {
+    return ADES.filter((a) => a.tier === "adapter").map((a) => a.kind);
+}
+/**
+ * Probe every adapter on this machine, in parallel.
+ *
+ * Bridges are excluded on purpose: they need their GUI launched with a
+ * debugging port, so "installed" tells you nothing about "drivable", and a
+ * new project should not be born holding an agent that can't answer.
+ */
+export async function detectAdes() {
+    const adapters = ADES.filter((a) => a.tier === "adapter");
+    const results = await Promise.all(adapters.map((a) => a.probe().catch(() => false)));
+    const out = {};
+    adapters.forEach((a, i) => (out[a.kind] = results[i] ?? false));
+    return out;
+}
+/** Default "ship" pipeline over whichever of planner/executor/reviewer exist. */
+export function buildDefaultRoutes(agents) {
+    const order = ["planner", "executor", "reviewer"];
+    const steps = order.filter((role) => agents.some((a) => a.role === role));
+    return steps.length >= 2 ? { ship: steps } : undefined;
+}
+/**
+ * The agents a new project starts with: the ADEs actually installed here, and
+ * nothing else.
+ *
+ * It used to fall back to an `echo` agent when it found none. echo is a test
+ * double — it replies with your own message and reports a made-up $0.001 — so
+ * a machine without claude or opencode got a project whose "agent" faked every
+ * turn, presented as a detected ADE. Better an empty roster and an honest "no
+ * ADEs found". (echo is still a registered kind; you can ask for it by name in
+ * .loom/config.json. It just isn't handed to anyone who didn't.)
+ *
+ * **Every agent's role is its own kind, and that isn't a placeholder.**
+ *
+ * This used to hand out planner / executor / reviewer by detection order, so
+ * Claude Code became "the planner" and OpenCode became "the executor" because
+ * of where they sat in a list in this file. Nobody decided that. It read like a
+ * recommendation Loom had earned, it was an accident of iteration order, and it
+ * quietly shaped how people used their own agents.
+ *
+ * A role is a job you define. Loom doesn't know which of your agents should
+ * plan, and pretending it does is worse than saying nothing — so the default
+ * describes rather than assigns ("codex" is codex), and you rename it to the
+ * job you actually have. The rail's agent picker does that; so does
+ * POST /api/projects/:id/agents/:agentId/role.
+ */
+export function defaultAgentConfigs(availability) {
+    return adapterKinds()
+        .filter((kind) => availability[kind])
+        .map((kind) => ({ id: kind, kind, role: kind }));
+}
+//# sourceMappingURL=ades.js.map

package/dist/core/ades.js.map

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

package/dist/core/baton.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The baton = the write lock. Exactly one adapter per project may hold it;
+ * holding it is what authorizes edits to the shared working tree.
+ *
+ * Handoffs are explicit (the user confirms in the surface). The active agent
+ * is interruptible: a confirmed handoff interrupts an in-flight turn.
+ */
+import type { EventLog } from "./eventlog.js";
+export declare class NotHolderError extends Error {
+    readonly agentId: string;
+    readonly holder: string | null;
+    constructor(agentId: string, holder: string | null);
+}
+export declare class BatonManager {
+    private projectDir;
+    private log;
+    constructor(projectDir: string, log: EventLog);
+    holder(): string | null;
+    holderSince(): number | undefined;
+    /** First acquisition (no current holder). Logged as a handoff from nobody. */
+    acquire(agentId: string): void;
+    /**
+     * Move the baton. Caller is responsible for interrupting the current
+     * holder and injecting the projection — see ProjectRuntime.handoff().
+     */
+    handoff(to: string, meta?: Record<string, unknown>): {
+        from: string | null;
+    };
+    release(agentId: string): void;
+    /** Throws NotHolderError unless agentId currently holds the baton. */
+    assertHolder(agentId: string): void;
+    /**
+     * Clear a holder unconditionally — used when the persisted holder no
+     * longer exists in the project config (agent removed/renamed).
+     */
+    forceClear(reason?: string): void;
+}

package/dist/core/baton.js

@@ -0,0 +1,92 @@
+/**
+ * The baton = the write lock. Exactly one adapter per project may hold it;
+ * holding it is what authorizes edits to the shared working tree.
+ *
+ * Handoffs are explicit (the user confirms in the surface). The active agent
+ * is interruptible: a confirmed handoff interrupts an in-flight turn.
+ */
+import { readProjectState, writeProjectState } from "./registry.js";
+export class NotHolderError extends Error {
+    agentId;
+    holder;
+    constructor(agentId, holder) {
+        super(holder
+            ? `agent "${agentId}" does not hold the baton (holder: "${holder}")`
+            : `no agent holds the baton`);
+        this.agentId = agentId;
+        this.holder = holder;
+        this.name = "NotHolderError";
+    }
+}
+export class BatonManager {
+    projectDir;
+    log;
+    constructor(projectDir, log) {
+        this.projectDir = projectDir;
+        this.log = log;
+    }
+    holder() {
+        return readProjectState(this.projectDir).holder;
+    }
+    holderSince() {
+        return readProjectState(this.projectDir).holderSince;
+    }
+    /** First acquisition (no current holder). Logged as a handoff from nobody. */
+    acquire(agentId) {
+        const state = readProjectState(this.projectDir);
+        if (state.holder === agentId)
+            return;
+        if (state.holder && state.holder !== agentId) {
+            throw new NotHolderError(agentId, state.holder);
+        }
+        state.holder = agentId;
+        state.holderSince = Date.now();
+        writeProjectState(this.projectDir, state);
+        this.log.append({ kind: "handoff", payload: { from: null, to: agentId } });
+    }
+    /**
+     * Move the baton. Caller is responsible for interrupting the current
+     * holder and injecting the projection — see ProjectRuntime.handoff().
+     */
+    handoff(to, meta = {}) {
+        const state = readProjectState(this.projectDir);
+        const from = state.holder;
+        if (from === to)
+            return { from };
+        state.holder = to;
+        state.holderSince = Date.now();
+        writeProjectState(this.projectDir, state);
+        this.log.append({ kind: "handoff", payload: { from, to, ...meta } });
+        return { from };
+    }
+    release(agentId) {
+        const state = readProjectState(this.projectDir);
+        if (state.holder !== agentId)
+            return;
+        state.holder = null;
+        delete state.holderSince;
+        writeProjectState(this.projectDir, state);
+        this.log.append({ kind: "handoff", payload: { from: agentId, to: null } });
+    }
+    /** Throws NotHolderError unless agentId currently holds the baton. */
+    assertHolder(agentId) {
+        const holder = this.holder();
+        if (holder !== agentId)
+            throw new NotHolderError(agentId, holder);
+    }
+    /**
+     * Clear a holder unconditionally — used when the persisted holder no
+     * longer exists in the project config (agent removed/renamed).
+     */
+    forceClear(reason = "holder removed") {
+        const state = readProjectState(this.projectDir);
+        if (!state.holder)
+            return;
+        const from = state.holder;
+        state.holder = null;
+        delete state.holderSince;
+        writeProjectState(this.projectDir, state);
+        this.log.append({ kind: "handoff", payload: { from, to: null, reason } });
+    }
+}
+//# sourceMappingURL=baton.js.map

package/dist/core/baton.js.map

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

package/dist/core/brain-extract.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Phase 2 — learning from a turn.
+ *
+ * Phases 0 and 1 gave the brain units and retrieval, both deterministic. This is
+ * where memories start arriving on their own: when an agent finishes a turn, an
+ * ADE reads the transcript and proposes what to remember, reconciled against
+ * what's already known.
+ *
+ * The shape is mem0's, adapted (see docs/proposals/brain.md):
+ *   - retrieve the candidates a new fact might collide with (phase 1);
+ *   - show them to the extractor INTEGER-MAPPED, never by real id — a
+ *     hallucinated "7" is detectable and droppable; a hallucinated uuid is
+ *     silent corruption (mem0 main.py:889);
+ *   - the extractor returns ADD / UPDATE / FORGET / NONE;
+ *   - every ADD/UPDATE must quote the span it came from, and that span is
+ *     verified IN CODE to appear in the turn — the cheapest hallucination guard
+ *     there is, and the one mem0 doesn't have.
+ *
+ * The LLM is injected as an `engine` (a prompt → text function), so all of the
+ * logic here — mapping, parsing, evidence-checking, applying — is pure and
+ * tested without a model. The default engine is the logged-in Claude CLI, the
+ * same no-API-key path distill.ts already uses.
+ */
+import type { Brain, Memory, MemoryKind } from "./brain.js";
+/** One thing the extractor decided to do. Ids here are the INTEGER map keys. */
+export type ExtractOp = {
+    op: "ADD";
+    text: string;
+    kind: MemoryKind;
+    entities?: string[];
+    confidence?: number;
+    evidence: string;
+} | {
+    op: "UPDATE";
+    id: string;
+    text: string;
+    confidence?: number;
+    evidence: string;
+} | {
+    op: "FORGET";
+    id: string;
+    reason: string;
+} | {
+    op: "NONE";
+};
+/** A retrieved memory, presented to the extractor under a throwaway integer id. */
+export interface Candidate {
+    intId: string;
+    memory: Memory;
+}
+export interface ExtractResult {
+    added: Memory[];
+    updated: Memory[];
+    forgotten: string[];
+    /** Ops thrown out, with why — surfaced so a bad extractor is visible, not silent. */
+    dropped: Array<{
+        op: ExtractOp;
+        reason: string;
+    }>;
+}
+/**
+ * Does the quoted span actually appear in the turn?
+ *
+ * The whole anti-hallucination guarantee rests on this one check. Whitespace is
+ * normalised (the model reflows), but the words have to be there. A short quote
+ * is too easy to satisfy by accident, so anything under a few characters is
+ * rejected outright.
+ */
+export declare function evidenceInTurn(evidence: string, turn: string): boolean;
+export declare const EXTRACT_SYSTEM = "You extract durable engineering memory from one agent turn in a software project.\n\nReturn ONLY facts that will still matter next week: constraints reality imposes, decisions and why, conventions this repo follows, plain facts about how things are, and \u2014 most valuable \u2014 failures (what was tried and did not work, so nobody burns the time again). Skip chit-chat, restated instructions, and anything true only for this minute.\n\nYou are given EXISTING memories, each under an integer id. Use them ONLY to avoid duplicates and to correct what's now wrong:\n- ADD a new memory when the turn reveals something not already known.\n- UPDATE an existing memory (by its integer id) when the turn shows it was incomplete or has changed. Keep the id.\n- FORGET an existing memory (by its integer id) when the turn shows it is now false.\n- Otherwise NONE.\n\nRules, strictly:\n- Every ADD and UPDATE MUST include \"evidence\": a short verbatim quote FROM THE TURN that the memory is based on. If you can't quote it from the turn, don't write it.\n- Each memory is ONE self-contained sentence that reads true with no surrounding context.\n- Use ONLY the integer ids shown for UPDATE/FORGET. Never invent an id.\n- kind is one of: constraint, decision, convention, fact, failure.\n\nRespond with JSON only, no prose:\n{\"ops\":[{\"op\":\"ADD\",\"text\":\"...\",\"kind\":\"failure\",\"evidence\":\"...\",\"confidence\":0.9},{\"op\":\"UPDATE\",\"id\":\"2\",\"text\":\"...\",\"evidence\":\"...\"},{\"op\":\"FORGET\",\"id\":\"5\",\"reason\":\"...\"},{\"op\":\"NONE\"}]}";
+export declare function buildExtractionPrompt(turn: string, candidates: Candidate[]): string;
+/** Pull the ops array out of the engine's reply, tolerantly. */
+export declare function parseExtraction(response: string): ExtractOp[];
+export interface ApplyOpts {
+    /** Who's learning this — an agent id, or "brain" for the extractor itself. */
+    by: string;
+    eventId: number;
+    chat?: string;
+}
+/**
+ * Apply the extractor's ops to the brain, dropping anything that fails a guard.
+ *
+ * The guards, in order: an ADD/UPDATE with no verifiable evidence span is a
+ * hallucination and is dropped; an UPDATE/FORGET whose integer id isn't in the
+ * candidate set is a hallucinated reference and is dropped; a real id maps back
+ * to its uuid before touching the store.
+ */
+export declare function applyExtraction(brain: Brain, ops: ExtractOp[], turn: string, candidates: Candidate[], opts: ApplyOpts): ExtractResult;
+export type ExtractEngine = (prompt: {
+    system: string;
+    user: string;
+}) => Promise<string>;
+export interface ExtractFromTurnOpts {
+    engine: ExtractEngine;
+    /** Who ran the turn — the memories are attributed to them. */
+    agentId: string;
+    chat?: string;
+    /** Files the turn touched — sharpens candidate retrieval. */
+    files?: string[];
+    /** How many existing memories to show the extractor as collision candidates. */
+    candidateLimit?: number;
+    eventId?: number;
+}
+/**
+ * Learn from one turn: retrieve candidates, ask the engine, apply the ops.
+ *
+ * Non-throwing by contract — a broken or slow extractor must never be able to
+ * take down the turn that triggered it (the same rule distill.ts follows). Any
+ * failure returns an empty result.
+ */
+export declare function extractFromTurn(brain: Brain, turn: string, opts: ExtractFromTurnOpts): Promise<ExtractResult>;