@loompad/cli 0.1.0 → 1.1.1

package/dist/observability/otlp.js.map

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

package/dist/observability/snapshots.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Time-Travel Replay — reconstruct the fleet's exact state at any point by
+ * folding the event log up to that moment. Snapshots aren't stored; they're
+ * rebuilt on demand (a fold, like the brain). Scrub to a frame and you see who
+ * held the baton, each agent's turns/cost, the decisions made so far, the brain's
+ * top facts, and the thread — all as of that instant.
+ */
+import type { LoomEvent } from "../types.js";
+export type AgentSnapState = {
+    turnsCompleted: number;
+    tokensUsed: number;
+    costUsd: number;
+    lastAction: string;
+    status: "idle" | "active" | "waiting" | "errored";
+};
+export interface TimeSnapshot {
+    timestampMs: number;
+    turnIndex: number;
+    eventIndex: number;
+    batonHolder: string;
+    decisionsAtPoint: string[];
+    agentStates: Record<string, AgentSnapState>;
+    memorySnapshot: {
+        decisionsCount: number;
+        keyFacts: string[];
+    };
+    threadLength: number;
+    lastMessage: {
+        agentId: string;
+        text: string;
+        timestamp: number;
+    } | null;
+    /** Files that were untracked ("??") when a turn touched them — i.e. new. */
+    filesCreatedSoFar: number;
+    filesModifiedSoFar: number;
+    triggerEvent: {
+        type: string;
+        agentId: string;
+        description: string;
+    };
+}
+/** Fold the event log into a list of scrubatble snapshots. Pure. */
+export declare function buildSnapshots(events: LoomEvent[]): TimeSnapshot[];

package/dist/observability/snapshots.js

@@ -0,0 +1,129 @@
+/**
+ * Time-Travel Replay — reconstruct the fleet's exact state at any point by
+ * folding the event log up to that moment. Snapshots aren't stored; they're
+ * rebuilt on demand (a fold, like the brain). Scrub to a frame and you see who
+ * held the baton, each agent's turns/cost, the decisions made so far, the brain's
+ * top facts, and the thread — all as of that instant.
+ */
+const SNAPSHOT_KINDS = new Set(["run_complete", "handoff", "error", "route_completed", "route_failed", "route_started"]);
+const isDecisionStatus = (e) => e.kind === "status" && e.payload.state === "agent_decision";
+const isHealStatus = (e) => e.kind === "status" && ["alert_intervention", "alert_recovery"].includes(String(e.payload.state));
+function describeEvent(e) {
+    const p = e.payload;
+    const agent = e.agentId ?? String(p.agentId ?? "system");
+    switch (e.kind) {
+        case "run_complete": return `${agent} completed turn`;
+        case "handoff": return p.from ? `baton · ${String(p.from)} → ${String(p.to ?? "—")}` : `baton · ${String(p.to ?? "agent")} takes it first`;
+        case "error": return `${agent} errored: ${String(p.message ?? "").slice(0, 60)}`;
+        case "route_started": return "route started";
+        case "route_completed": return "route completed";
+        case "route_failed": return `route failed: ${String(p.error ?? p.reason ?? "")}`;
+        case "status":
+            if (isDecisionStatus(e))
+                return `${agent} decided: ${String(p.title ?? "")}`;
+            if (p.state === "alert_intervention")
+                return `⚡ Alert → baton off ${agent}`;
+            if (p.state === "alert_recovery")
+                return `✓ Recovery → ${agent}`;
+            return String(p.state ?? "status");
+        default: return e.kind;
+    }
+}
+/** Fold the event log into a list of scrubatble snapshots. Pure. */
+export function buildSnapshots(events) {
+    const snapshots = [];
+    let batonHolder = null;
+    const agentStates = {};
+    const decisionIds = [];
+    let threadLength = 0;
+    let lastMessage = null;
+    let filesCreated = 0;
+    let filesModified = 0;
+    let memoryFacts = [];
+    const ensure = (id) => (agentStates[id] ??= { turnsCompleted: 0, tokensUsed: 0, costUsd: 0, lastAction: "", status: "idle" });
+    for (let i = 0; i < events.length; i++) {
+        const e = events[i];
+        const p = e.payload;
+        switch (e.kind) {
+            case "handoff": {
+                const to = String(p.to ?? p.agent ?? "");
+                if (to) {
+                    batonHolder = to;
+                    ensure(to).status = "active";
+                }
+                break;
+            }
+            case "run_complete": {
+                const id = e.agentId ?? String(p.agentId ?? "");
+                if (id) {
+                    const a = ensure(id);
+                    a.turnsCompleted += 1;
+                    a.tokensUsed += Number(p.inputTokens ?? 0) + Number(p.outputTokens ?? 0);
+                    a.costUsd += Number(p.costUsd ?? 0);
+                    a.lastAction = `Completed turn ${a.turnsCompleted}`;
+                    a.status = "idle";
+                }
+                break;
+            }
+            case "turn_diff": {
+                // A turn_diff carries ChangedFile[] — a porcelain XY status and a path.
+                // "??" is git's code for a file that wasn't tracked before this turn,
+                // which is the only thing in the log that means "created". Counting it
+                // is what makes `filesCreatedSoFar` a real number: it was initialised to
+                // 0, never incremented, and shipped through the API as a count of
+                // created files that was structurally always zero.
+                const files = Array.isArray(p.files) ? p.files : [];
+                filesModified += files.length; // Loom attributes tree changes per turn
+                for (const f of files) {
+                    if (typeof f !== "string" && String(f?.status ?? "").trim() === "??")
+                        filesCreated += 1;
+                }
+                break;
+            }
+            case "message": {
+                threadLength += 1;
+                lastMessage = { agentId: e.agentId ?? "user", text: String(p.text ?? "").slice(0, 200), timestamp: e.ts };
+                break;
+            }
+            case "memory_add":
+            case "memory_import": {
+                const fact = String(p.text ?? p.file ?? p.kind ?? "").slice(0, 80);
+                if (fact)
+                    memoryFacts = [fact, ...memoryFacts].slice(0, 3);
+                break;
+            }
+            case "error": {
+                if (e.agentId) {
+                    const a = ensure(e.agentId);
+                    a.status = "errored";
+                    a.lastAction = `Error: ${String(p.message ?? "unknown").slice(0, 50)}`;
+                }
+                break;
+            }
+            case "status": {
+                if (isDecisionStatus(e) && p.decisionId)
+                    decisionIds.push(String(p.decisionId));
+                break;
+            }
+        }
+        const snapWorthy = SNAPSHOT_KINDS.has(e.kind) || isDecisionStatus(e) || isHealStatus(e);
+        if (!snapWorthy)
+            continue;
+        snapshots.push({
+            timestampMs: e.ts,
+            turnIndex: Object.values(agentStates).reduce((s, a) => s + a.turnsCompleted, 0),
+            eventIndex: i,
+            batonHolder: batonHolder ?? "none",
+            decisionsAtPoint: [...decisionIds],
+            agentStates: JSON.parse(JSON.stringify(agentStates)),
+            memorySnapshot: { decisionsCount: decisionIds.length, keyFacts: [...memoryFacts] },
+            threadLength,
+            lastMessage,
+            filesCreatedSoFar: filesCreated,
+            filesModifiedSoFar: filesModified,
+            triggerEvent: { type: isDecisionStatus(e) ? "decision" : e.kind, agentId: e.agentId ?? String(p.agentId ?? "system"), description: describeEvent(e) },
+        });
+    }
+    return snapshots;
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/observability/snapshots.js.map

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

package/dist/observability/triage.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Agent self-triage — "why did I fail?"
+ *
+ * Agent-native observability: an agent (or you, on its behalf) reads its OWN
+ * OpenTelemetry traces back out of the telemetry backend and gets a root cause.
+ * We query the agent's recent spans from ClickHouse (the backend's store),
+ * derive a deterministic root cause + fix from them, and — when Claude is
+ * reachable (an Anthropic key, or the `claude` CLI you're already signed into) —
+ * have Claude phrase it. The local event log is a fallback source so triage
+ * still works if the backend is down.
+ */
+import type { LoomEvent } from "../types.js";
+/**
+ * The `claude` CLI in print mode emits either JSON (`--output-format json`,
+ * whose `.result` is the text) or, on older CLIs, the raw text itself. Pull the
+ * completion out of whichever we got; return null for an empty/again-parseable
+ * result so triage falls back to the deterministic root cause.
+ */
+export declare function parseCliOutput(raw: string): string | null;
+export type TriageSpan = {
+    ts: number;
+    name: string;
+    ms: number;
+    code: number;
+    msg: string;
+    kind: string;
+    cost: number;
+    tin: number;
+    tout: number;
+};
+export type TriageResult = {
+    agent: string;
+    spanCount: number;
+    errorCount: number;
+    evidence: TriageSpan[];
+    rootCause: string;
+    suggestedFix: string;
+    source: "llm" | "heuristic" | "no-data";
+    from: "backend" | "local-log" | "none";
+};
+/** Concatenate the text blocks of an Anthropic /v1/messages response. */
+export declare function parseAnthropicText(json: unknown): string | null;
+/** The triage prompt — the agent's spans, newest first, and what to answer. */
+export declare function triagePrompt(agent: string, spans: TriageSpan[]): string;
+/**
+ * Triage one agent. `fallbackEvents` (the local log) is used only when the
+ * backend has nothing, so triage always returns something useful.
+ */
+export declare function triageAgent(agent: string, fallbackEvents?: LoomEvent[]): Promise<TriageResult>;

package/dist/observability/triage.js

@@ -0,0 +1,284 @@
+/**
+ * Agent self-triage — "why did I fail?"
+ *
+ * Agent-native observability: an agent (or you, on its behalf) reads its OWN
+ * OpenTelemetry traces back out of the telemetry backend and gets a root cause.
+ * We query the agent's recent spans from ClickHouse (the backend's store),
+ * derive a deterministic root cause + fix from them, and — when Claude is
+ * reachable (an Anthropic key, or the `claude` CLI you're already signed into) —
+ * have Claude phrase it. The local event log is a fallback source so triage
+ * still works if the backend is down.
+ */
+import { spawn } from "../core/process.js";
+import os from "node:os";
+import { SERVICE_NAME, SPAN_TABLE, chLiteral, chQuery } from "./clickhouse.js";
+/**
+ * The `claude` CLI in print mode emits either JSON (`--output-format json`,
+ * whose `.result` is the text) or, on older CLIs, the raw text itself. Pull the
+ * completion out of whichever we got; return null for an empty/again-parseable
+ * result so triage falls back to the deterministic root cause.
+ */
+export function parseCliOutput(raw) {
+    const text = (raw || "").trim();
+    if (!text)
+        return null;
+    try {
+        const j = JSON.parse(text);
+        if (j.is_error)
+            return null;
+        const r = typeof j.result === "string" ? j.result.trim() : "";
+        return r || null;
+    }
+    catch {
+        return text; // not JSON — treat as plain text
+    }
+}
+/**
+ * A copy of the environment with Claude Code's nesting markers removed. When the
+ * daemon is launched from inside a Claude Code session (or CI), the child
+ * `claude` would otherwise inherit a child-session OAuth token that returns
+ * empty completions. Stripping these is a no-op in a normal terminal.
+ */
+function cliEnv() {
+    const env = {};
+    for (const [k, v] of Object.entries(process.env)) {
+        if (k === "CLAUDECODE" || /^CLAUDE_CODE/i.test(k))
+            continue;
+        env[k] = v;
+    }
+    return env;
+}
+function safeId(id) {
+    return id.replace(/[^\w.\-:]/g, "");
+}
+/**
+ * Pull the agent's own spans (its turns + the handoffs it's part of) from the
+ * telemetry backend.
+ */
+async function fetchAgentSpans(agent, limit = 40) {
+    const a = safeId(agent);
+    const sql = `
+    SELECT toUnixTimestamp64Milli(timestamp) AS ts, name,
+           round(duration_nano / 1e6) AS ms, status_code AS code, status_message AS msg,
+           attributes_string['loom.event.kind'] AS kind,
+           attributes_number['gen_ai.usage.cost_usd'] AS cost,
+           toUInt32(attributes_number['gen_ai.usage.input_tokens']) AS tin,
+           toUInt32(attributes_number['gen_ai.usage.output_tokens']) AS tout
+    FROM ${SPAN_TABLE}
+    WHERE \`resource_string_service$$name\` = '${chLiteral(SERVICE_NAME)}'
+      AND (attributes_string['gen_ai.agent.id'] = '${a}'
+           OR attributes_string['loom.handoff.to'] = '${a}'
+           OR attributes_string['loom.handoff.from'] = '${a}')
+    ORDER BY timestamp DESC
+    LIMIT ${Math.min(120, limit)}`;
+    const rows = await chQuery(sql);
+    return rows.map((r) => ({
+        ts: Number(r.ts),
+        name: String(r.name),
+        ms: Number(r.ms),
+        code: Number(r.code),
+        msg: String(r.msg ?? ""),
+        kind: String(r.kind ?? ""),
+        cost: Number(r.cost ?? 0),
+        tin: Number(r.tin ?? 0),
+        tout: Number(r.tout ?? 0),
+    }));
+}
+/**
+ * Fallback: derive trace-shaped rows from the local event log (same data the
+ * backend gets).
+ */
+function spansFromLog(agent, events) {
+    const out = [];
+    for (const e of events) {
+        const p = e.payload ?? {};
+        const mine = e.agentId === agent || p.to === agent || p.from === agent || p.agent === agent;
+        if (!mine)
+            continue;
+        if (e.kind === "run_complete") {
+            // The turn's real cost, the same field the backend path reads into `cost`
+            // and the same one insightSpansFromLog takes. This was a literal 0: every
+            // fallback turn came back free, which is a number nobody measured sitting
+            // in the column where a measured one goes. Nothing renders triage evidence
+            // costs today — but a fabricated zero is only ever one render away from
+            // being believed, and the log has the answer right here.
+            out.push({ ts: e.ts, name: "gen_ai.agent.turn", ms: Number(p.durationMs ?? 0), code: p.error ? 2 : 1,
+                msg: String(p.error ?? ""), kind: e.kind, cost: Number(p.costUsd ?? 0), tin: Number(p.inputTokens ?? 0), tout: Number(p.outputTokens ?? 0) });
+        }
+        else if (e.kind === "error") {
+            out.push({ ts: e.ts, name: "loom.error", ms: 0, code: 2, msg: String(p.message ?? "error"), kind: e.kind, cost: 0, tin: 0, tout: 0 });
+        }
+        else if (e.kind === "route_failed") {
+            out.push({ ts: e.ts, name: "loom.route.failed", ms: 0, code: 2, msg: String(p.error ?? p.reason ?? "route failed"), kind: e.kind, cost: 0, tin: 0, tout: 0 });
+        }
+        else if (e.kind === "handoff") {
+            out.push({ ts: e.ts, name: "loom.baton.handoff", ms: 0, code: 1, msg: `${p.from ?? "?"} -> ${p.to ?? "?"}`, kind: e.kind, cost: 0, tin: 0, tout: 0 });
+        }
+        else if (e.kind === "needs_input") {
+            out.push({ ts: e.ts, name: "loom.needs_input", ms: 0, code: 1, msg: String(p.question ?? "needs input"), kind: e.kind, cost: 0, tin: 0, tout: 0 });
+        }
+    }
+    return out.sort((a, b) => b.ts - a.ts).slice(0, 40);
+}
+const isError = (s) => s.code === 2 || s.name === "loom.error" || s.name === "loom.route.failed";
+function humanAgo(ms) {
+    const s = Math.max(0, Math.round((Date.now() - ms) / 1000));
+    if (s < 60)
+        return `${s}s ago`;
+    if (s < 3600)
+        return `${Math.round(s / 60)}m ago`;
+    if (s < 86400)
+        return `${Math.round(s / 3600)}h ago`;
+    return `${Math.round(s / 86400)}d ago`;
+}
+/** Deterministic root cause from the spans — reliable, no model required. */
+function heuristic(agent, spans) {
+    const errors = spans.filter(isError);
+    const turns = spans.filter((s) => s.name === "gen_ai.agent.turn");
+    if (!spans.length) {
+        return { rootCause: `No traces for ${agent} yet.`, suggestedFix: "Run a turn so it emits telemetry, then triage again." };
+    }
+    if (!errors.length) {
+        const slow = [...turns].sort((a, b) => b.ms - a.ms)[0];
+        return {
+            rootCause: `${agent} looks healthy — ${turns.length} turn(s), no error spans in its last ${spans.length} events${slow ? `, slowest turn ${slow.ms}ms` : ""}.`,
+            suggestedFix: "Nothing to fix; the agent completed its turns cleanly.",
+        };
+    }
+    const last = errors[0];
+    const ago = humanAgo(last.ts);
+    const where = last.name === "loom.route.failed" ? "a route step" : last.name === "loom.error" ? "the agent itself" : `a ${last.name}`;
+    // upstream: the handoff that last passed the baton INTO this agent
+    const upstream = spans.find((s) => s.name === "loom.baton.handoff" && s.msg.endsWith(`-> ${agent}`));
+    const upTxt = upstream ? ` Upstream: the baton reached it via ${upstream.msg.replace(" -> ", " → ")}.` : "";
+    const rootCause = `${agent} hit ${errors.length} error(s); the most recent (${ago}) was on ${where}: "${(last.msg || "unknown").slice(0, 220)}".${upTxt}`;
+    const m = last.msg.toLowerCase();
+    let fix = "Open the failing span in the telemetry backend for the full context, then retry the turn.";
+    if (/exited|crash|serve exited|killed|sigterm|sigkill|process/.test(m))
+        fix = "The agent process crashed — restart the agent (or its CLI/daemon) and re-hand the baton.";
+    else if (/timeout|timed out|deadline/.test(m))
+        fix = "A call timed out — raise the tool/turn timeout or check the upstream service, then re-hand the baton.";
+    else if (/permission|denied|unauthor|not signed|401|403/.test(m))
+        fix = "Auth/permission failure — re-sign-in the agent's CLI (or refresh its API key) and retry.";
+    else if (/json|parse|malformed|unexpected token|bad request/.test(m))
+        fix = "Malformed input, likely from the upstream handoff — validate the briefing/JSON before passing the baton.";
+    else if (/rate|429|quota|limit/.test(m))
+        fix = "Rate-limited — back off and retry, or route the turn to a fallback agent.";
+    else if (/model .* (not )?support|no public api/.test(m))
+        fix = "The model/endpoint isn't supported — switch the agent's model in .loom/config.json.";
+    return { rootCause, suggestedFix: fix };
+}
+/** The triage model, overridable so an operator isn't pinned to one release. */
+const TRIAGE_MODEL = process.env.LOOM_TRIAGE_MODEL || "claude-haiku-4-5-20251001";
+/** Concatenate the text blocks of an Anthropic /v1/messages response. */
+export function parseAnthropicText(json) {
+    const j = json;
+    const text = (j?.content ?? []).map((c) => (typeof c.text === "string" ? c.text : "")).join("").trim();
+    return text || null;
+}
+/** The triage prompt — the agent's spans, newest first, and what to answer. */
+export function triagePrompt(agent, spans) {
+    const lines = spans
+        .slice(0, 30)
+        .map((s) => `${new Date(s.ts).toISOString()} ${s.name} ${s.ms}ms status=${s.code}${s.msg ? ` "${s.msg.slice(0, 160)}"` : ""}`)
+        .join("\n");
+    return (`You are triaging a coding agent named "${agent}" from its OpenTelemetry traces (newest first):\n\n${lines}\n\n` +
+        `In 2-3 sentences: the root cause of any failure, the specific span/turn, any upstream handoff, and one concrete fix. If healthy, say so plainly.`);
+}
+/**
+ * Ask Claude to phrase the root cause. Two independent paths so LLM prose works
+ * in ANY environment: the Anthropic API (an ANTHROPIC_API_KEY, works headless /
+ * in CI / behind a server) first, then the signed-in `claude` CLI. Either one
+ * returning text wins; null (→ deterministic heuristic) only if both are absent.
+ */
+async function llmPhrase(agent, spans) {
+    // Deterministic escape hatch (tests, or an operator who wants heuristic only).
+    if (process.env.LOOM_TRIAGE_NO_LLM === "1")
+        return null;
+    const prompt = triagePrompt(agent, spans);
+    const key = process.env.ANTHROPIC_API_KEY;
+    if (key && typeof globalThis.fetch === "function") {
+        try {
+            const res = await fetch("https://api.anthropic.com/v1/messages", {
+                method: "POST",
+                headers: { "content-type": "application/json", "x-api-key": key, "anthropic-version": "2023-06-01" },
+                body: JSON.stringify({ model: TRIAGE_MODEL, max_tokens: 320, messages: [{ role: "user", content: prompt }] }),
+            });
+            if (res.ok) {
+                const text = parseAnthropicText(await res.json());
+                if (text)
+                    return text;
+            }
+        }
+        catch {
+            /* fall through to CLI */
+        }
+    }
+    return await claudeCli(prompt);
+}
+/**
+ * Best-effort: run the prompt through the signed-in `claude` CLI in print mode.
+ * We ask for JSON so we can read `.result` reliably, run in a neutral cwd (no
+ * project trust dialog, no giant CLAUDE.md pulled into context), and strip the
+ * Claude Code nesting vars so a daemon started from inside a session still gets
+ * a real completion. Falls back to null (→ heuristic) on timeout/empty.
+ */
+function claudeCli(prompt) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn("claude", ["-p", prompt, "--output-format", "json"], {
+                stdio: ["ignore", "pipe", "ignore"],
+                cwd: os.tmpdir(),
+                env: cliEnv(),
+            });
+        }
+        catch {
+            resolve(null);
+            return;
+        }
+        let out = "";
+        const kill = setTimeout(() => { try {
+            child.kill();
+        }
+        catch { /* ignore */ } resolve(null); }, 30_000);
+        child.stdout?.on("data", (d) => (out += d.toString()));
+        child.on("error", () => { clearTimeout(kill); resolve(null); });
+        child.on("close", () => { clearTimeout(kill); resolve(parseCliOutput(out)); });
+    });
+}
+/**
+ * Triage one agent. `fallbackEvents` (the local log) is used only when the
+ * backend has nothing, so triage always returns something useful.
+ */
+export async function triageAgent(agent, fallbackEvents = []) {
+    let spans = [];
+    let from = "none";
+    try {
+        spans = await fetchAgentSpans(agent);
+        if (spans.length)
+            from = "backend";
+    }
+    catch {
+        /* the backend's ClickHouse unreachable — fall back to the local log */
+    }
+    if (!spans.length && fallbackEvents.length) {
+        spans = spansFromLog(agent, fallbackEvents);
+        if (spans.length)
+            from = "local-log";
+    }
+    const errorCount = spans.filter(isError).length;
+    const base = heuristic(agent, spans);
+    const llm = spans.length ? await llmPhrase(agent, spans) : null;
+    return {
+        agent,
+        spanCount: spans.length,
+        errorCount,
+        evidence: spans.slice(0, 12),
+        rootCause: llm ?? base.rootCause,
+        suggestedFix: base.suggestedFix,
+        source: llm ? "llm" : spans.length ? "heuristic" : "no-data",
+        from,
+    };
+}
+//# sourceMappingURL=triage.js.map

package/dist/observability/triage.js.map

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

package/dist/providers/adapter.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The provider adapter contract. An adapter owns one provider's protocol and
+ * its live sessions; everything above it (ProviderService, ingestion, Brain,
+ * clients) sees only these operations and the canonical runtime events.
+ *
+ * Ported from t3code's provider/Services/ProviderAdapter.ts (MIT, © T3 Tools
+ * Inc.) as a plain async interface. One difference: t3code keys sessions by
+ * thread alone, because a thread never changes driver. Loom switches provider
+ * within a chat, so each adapter instance serves one Loom agent and keys its
+ * sessions by chat; the service routes (chat, agent) to the right adapter.
+ */
+import type { AdapterCapabilities, ApprovalDecision, InstanceId, ProviderKind, ProviderRuntimeEvent, ProviderSession, RequestId, SendTurnInput, SessionStartInput, ThreadId, ThreadSnapshot, TurnId, TurnStartResult, UserInputAnswers } from "./contracts.js";
+export type RuntimeEventListener = (event: ProviderRuntimeEvent) => void;
+export interface ProviderAdapter {
+    readonly provider: ProviderKind;
+    /** The Loom agent this adapter serves. */
+    readonly instanceId: InstanceId;
+    readonly capabilities: AdapterCapabilities;
+    /** Start a session, or resume one from `resumeCursor`. Resolves once the session is ready. */
+    startSession(input: SessionStartInput): Promise<ProviderSession>;
+    /** Start a turn on a live session. Resolves once the provider has accepted it. */
+    sendTurn(input: SendTurnInput): Promise<TurnStartResult>;
+    /** Interrupt the active turn (or `turnId`). Resolves once the provider has acknowledged. */
+    interruptTurn(threadId: ThreadId, turnId?: TurnId): Promise<void>;
+    respondToRequest(threadId: ThreadId, requestId: RequestId, decision: ApprovalDecision): Promise<void>;
+    respondToUserInput(threadId: ThreadId, requestId: RequestId, answers: UserInputAnswers): Promise<void>;
+    /** Start a compaction; completion arrives as `thread.state.changed: compacted`. */
+    compact?(threadId: ThreadId): Promise<void>;
+    readThread?(threadId: ThreadId): Promise<ThreadSnapshot>;
+    rollbackThread?(threadId: ThreadId, numTurns: number): Promise<ThreadSnapshot>;
+    /** Stop one session and wait for its process to be gone. */
+    stopSession(threadId: ThreadId): Promise<void>;
+    stopAll(): Promise<void>;
+    listSessions(): ProviderSession[];
+    hasSession(threadId: ThreadId): boolean;
+    /** Subscribe to this adapter's canonical events. Returns an unsubscribe. */
+    onEvent(listener: RuntimeEventListener): () => void;
+}
+/**
+ * A synchronous fan-out for runtime events. A throwing listener is isolated so
+ * one bad subscriber cannot stop the others from seeing the stream.
+ */
+export declare class EventHub<T> {
+    private readonly onListenerError;
+    private readonly listeners;
+    constructor(onListenerError?: (error: unknown) => void);
+    subscribe(listener: (event: T) => void): () => void;
+    publish(event: T): void;
+    get size(): number;
+}

package/dist/providers/adapter.js

@@ -0,0 +1,38 @@
+/**
+ * The provider adapter contract. An adapter owns one provider's protocol and
+ * its live sessions; everything above it (ProviderService, ingestion, Brain,
+ * clients) sees only these operations and the canonical runtime events.
+ *
+ * Ported from t3code's provider/Services/ProviderAdapter.ts (MIT, © T3 Tools
+ * Inc.) as a plain async interface. One difference: t3code keys sessions by
+ * thread alone, because a thread never changes driver. Loom switches provider
+ * within a chat, so each adapter instance serves one Loom agent and keys its
+ * sessions by chat; the service routes (chat, agent) to the right adapter.
+ */
+/**
+ * A synchronous fan-out for runtime events. A throwing listener is isolated so
+ * one bad subscriber cannot stop the others from seeing the stream.
+ */
+export class EventHub {
+    onListenerError;
+    listeners = new Set();
+    constructor(onListenerError = () => { }) {
+        this.onListenerError = onListenerError;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+    publish(event) {
+        for (const listener of [...this.listeners]) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                this.onListenerError(error);
+            }
+        }
+    }
+    get size() { return this.listeners.size; }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/providers/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/providers/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoCH;;;GAGG;AACH,MAAM,OAAO,QAAQ;IAEU;IADZ,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC3D,YAA6B,kBAA4C,GAAG,EAAE,GAAE,CAAC;QAApD,oBAAe,GAAf,eAAe,CAAqC;IAAG,CAAC;IAErF,SAAS,CAAC,QAA4B;QACpC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,CAAC,KAAQ;QACd,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC;gBAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;CACnD"}