@loompad/cli 0.1.0 → 1.1.2

package/dist/daemon/relay.js

@@ -0,0 +1,351 @@
+/**
+ * Loom Cloud — the daemon end of the relay.
+ *
+ * Tailscale reaches your machine when the phone is on your tailnet. Loom Cloud
+ * reaches it from anywhere: the daemon joins a Supabase Realtime channel and
+ * answers encrypted requests that arrive there. See core/relay-protocol.ts for
+ * the wire format and why Supabase never sees plaintext.
+ *
+ * The bridge is deliberately dumb. It does not re-implement the API — each
+ * relayed request becomes a real HTTP call against this daemon on loopback,
+ * carrying the phone's own bearer token, and each live stream is a real /ws
+ * connection opened with that token. So pairing, scopes, admin-only routes and
+ * every future endpoint behave identically over the relay and over the LAN.
+ */
+import { hostedTarget } from "../core/hosted.js";
+import fs from "node:fs";
+import path from "node:path";
+import WebSocket from "ws";
+import { loomHome } from "../core/registry.js";
+import { logbook } from "../core/logbook.js";
+import { encodeMessage, fromB64, newRelayCredentials, RelayDecoder, relayTopic, } from "../core/relay-protocol.js";
+function cloudFile() {
+    return path.join(loomHome(), "cloud.json");
+}
+export function readCloudSettings() {
+    try {
+        return JSON.parse(fs.readFileSync(cloudFile(), "utf8"));
+    }
+    catch {
+        return { enabled: false };
+    }
+}
+export function writeCloudSettings(s) {
+    fs.mkdirSync(loomHome(), { recursive: true });
+    fs.writeFileSync(cloudFile(), JSON.stringify(s, null, 2), { mode: 0o600 });
+}
+/** The Supabase project in effect: env first, then saved settings. */
+export function supabaseTarget(s = readCloudSettings()) {
+    // Your own project when you've named one; otherwise Loom's hosted project —
+    // the same one the Team Hub uses. Asking every user to paste a Supabase URL
+    // and key before "reach this computer from your phone" works made the one
+    // switch a setup chore. The relay only ever carries ciphertext either way.
+    const hosted = hostedTarget();
+    const url = process.env.LOOM_SUPABASE_URL || s.supabaseUrl || hosted.supabaseUrl || "";
+    const anonKey = process.env.LOOM_SUPABASE_ANON_KEY || s.anonKey || (url === hosted.supabaseUrl ? hosted.publishableKey : "") || "";
+    return url && anonKey ? { url, anonKey } : null;
+}
+export function ensureCredentials(s) {
+    if (s.channel && s.key)
+        return { channel: s.channel, key: s.key };
+    const c = newRelayCredentials();
+    s.channel = c.channel;
+    s.key = c.key;
+    return c;
+}
+// ---------------------------------------------------------------------------
+// Transports
+// ---------------------------------------------------------------------------
+/** Supabase Realtime broadcast — the production transport. */
+export async function supabaseTransport(url, anonKey, channel) {
+    const { createClient } = await import("@supabase/supabase-js");
+    const client = createClient(url, anonKey, {
+        auth: { persistSession: false, autoRefreshToken: false },
+        realtime: { params: { eventsPerSecond: 40 } },
+    });
+    const ch = client.channel(relayTopic(channel), { config: { broadcast: { self: false, ack: false } } });
+    const listeners = [];
+    ch.on("broadcast", { event: "e" }, (msg) => {
+        for (const l of listeners)
+            l(msg.payload);
+    });
+    let resolveReady;
+    let rejectReady;
+    const ready = new Promise((res, rej) => {
+        resolveReady = res;
+        rejectReady = rej;
+    });
+    ch.subscribe((status, err) => {
+        if (status === "SUBSCRIBED")
+            resolveReady();
+        else if (status === "CHANNEL_ERROR" || status === "TIMED_OUT") {
+            rejectReady(err ?? new Error(`realtime ${status.toLowerCase()}`));
+            logbook.warn("cloud", `relay channel ${status.toLowerCase()} — retrying`, err?.message);
+        }
+    });
+    return {
+        async send(env) {
+            await ch.send({ type: "broadcast", event: "e", payload: env });
+        },
+        onEnvelope(cb) {
+            listeners.push(cb);
+        },
+        ready: () => ready,
+        async close() {
+            await client.removeChannel(ch).catch(() => { });
+            client.realtime.disconnect();
+        },
+    };
+}
+/**
+ * An in-process broadcast bus with Supabase's semantics (everyone but the
+ * sender receives, asynchronously, JSON round-tripped). For tests and demos.
+ */
+export class MemoryRelayBus {
+    members = new Set();
+    /** Every envelope that crossed the bus, as the relay operator would see it. */
+    wire = [];
+    connect() {
+        const listeners = [];
+        const self = (env) => listeners.forEach((l) => l(env));
+        this.members.add(self);
+        return {
+            send: async (env) => {
+                const copy = JSON.parse(JSON.stringify(env));
+                this.wire.push(copy);
+                for (const m of this.members)
+                    if (m !== self)
+                        setTimeout(() => m(copy), 0);
+            },
+            onEnvelope: (cb) => void listeners.push(cb),
+            ready: async () => { },
+            close: async () => void this.members.delete(self),
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// The bridge
+// ---------------------------------------------------------------------------
+const DENY = [/^\/api\/bootstrap/, /^\/api\/webhooks\//];
+const METHODS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE"]);
+const MAX_CLIENTS = 32;
+const MAX_INFLIGHT = 16;
+const CLIENT_IDLE_MS = 5 * 60_000;
+/** How far a request's own timestamp may sit from the daemon's clock. */
+const REQ_SKEW_MS = 10 * 60_000;
+/** Ids are remembered for longer than any stamp could pass, so a copy is always caught one way or the other. */
+const SEEN_TTL_MS = 2 * REQ_SKEW_MS + 60_000;
+const SEEN_MAX = 20_000;
+const FLUSH_MS = 60;
+const FLUSH_BYTES = 48 * 1024;
+export class RelayBridge {
+    opts;
+    key;
+    decoder;
+    clients = new Map();
+    sweeper;
+    closed = false;
+    /** "<client>:<request id>" → when it was first run (see RelayRequest.ts). */
+    seen = new Map();
+    stats = { requests: 0, rejected: 0, frames: 0, replayed: 0 };
+    constructor(opts) {
+        this.opts = opts;
+        this.key = fromB64(opts.key);
+        this.decoder = new RelayDecoder(this.key, "c");
+        opts.transport.onEnvelope((env) => {
+            const msg = this.decoder.push(env);
+            if (msg)
+                void this.handle(msg).catch((err) => logbook.warn("cloud", "relay message failed", String(err)));
+        });
+        this.sweeper = setInterval(() => this.sweep(), 30_000);
+        this.sweeper.unref?.();
+    }
+    clientCount() {
+        return this.clients.size;
+    }
+    client(id) {
+        let c = this.clients.get(id);
+        if (!c) {
+            if (this.clients.size >= MAX_CLIENTS)
+                return null;
+            c = { lastSeen: Date.now(), inflight: 0, buffer: [], bufferBytes: 0 };
+            this.clients.set(id, c);
+        }
+        c.lastSeen = Date.now();
+        return c;
+    }
+    async send(msg) {
+        if (this.closed)
+            return;
+        for (const env of encodeMessage(this.key, "d", msg))
+            await this.opts.transport.send(env);
+    }
+    async handle(msg) {
+        if (msg.t === "ping") {
+            if (!this.client(String(msg.from)))
+                return;
+            return this.send({ t: "pong", to: String(msg.from), ts: Number(msg.ts) || 0, daemon: this.opts.identity() });
+        }
+        if (msg.t === "req")
+            return this.request(msg);
+        if (msg.t === "sub")
+            return this.subscribe(String(msg.from), String(msg.auth ?? ""), msg.project);
+        if (msg.t === "unsub")
+            return this.unsubscribe(String(msg.from));
+    }
+    async request(msg) {
+        const from = String(msg.from);
+        const c = this.client(from);
+        const reply = (status, body) => this.send({ t: "res", id: String(msg.id), to: from, status, body });
+        if (!c)
+            return reply(503, { error: "too many relay clients" });
+        // A request seen before is a copy, not a retry (a retry gets a fresh id):
+        // drop it without an answer, which the real client already had.
+        const now = Date.now();
+        const key = `${from}:${String(msg.id)}`;
+        if (this.seen.has(key)) {
+            this.stats.replayed++;
+            return;
+        }
+        if (typeof msg.ts === "number" && Math.abs(now - msg.ts) > REQ_SKEW_MS) {
+            this.stats.rejected++;
+            const mins = Math.round((now - msg.ts) / 60_000);
+            return reply(408, { error: `this request is stamped ${Math.abs(mins)} min ${mins > 0 ? "ago" : "ahead"} — check the phone's clock` });
+        }
+        this.seen.set(key, now);
+        if (this.seen.size > SEEN_MAX)
+            this.forgetSeen(now, true);
+        const method = String(msg.method || "GET").toUpperCase();
+        const p = String(msg.path || "");
+        if (!p.startsWith("/api/") || p.includes("..") || DENY.some((re) => re.test(p)) || !METHODS.has(method)) {
+            this.stats.rejected++;
+            return reply(403, { error: "not relayable" });
+        }
+        if (c.inflight >= MAX_INFLIGHT)
+            return reply(429, { error: "too many requests in flight" });
+        c.inflight++;
+        this.stats.requests++;
+        try {
+            const res = await fetch(this.opts.localBase() + p, {
+                method,
+                headers: {
+                    ...(msg.auth ? { authorization: String(msg.auth) } : {}),
+                    ...(msg.body !== undefined ? { "content-type": "application/json" } : {}),
+                    "x-loom-via": "relay",
+                },
+                ...(msg.body !== undefined && method !== "GET" ? { body: JSON.stringify(msg.body) } : {}),
+            });
+            const text = await res.text();
+            let body = text;
+            try {
+                body = text ? JSON.parse(text) : null;
+            }
+            catch {
+                /* non-JSON bodies ride as text */
+            }
+            await reply(res.status, body);
+        }
+        catch (err) {
+            await reply(502, { error: `daemon unreachable: ${err.message}` });
+        }
+        finally {
+            c.inflight--;
+        }
+    }
+    forgetSeen(now, force = false) {
+        for (const [k, at] of this.seen) {
+            if (now - at > SEEN_TTL_MS)
+                this.seen.delete(k);
+        }
+        // still full of fresh ids (a flood): drop the oldest half rather than grow
+        if (force && this.seen.size > SEEN_MAX) {
+            let n = Math.floor(this.seen.size / 2);
+            for (const k of this.seen.keys()) {
+                if (n-- <= 0)
+                    break;
+                this.seen.delete(k);
+            }
+        }
+    }
+    subscribe(from, auth, project) {
+        const c = this.client(from);
+        if (!c)
+            return;
+        this.unsubscribe(from, false);
+        const token = auth.replace(/^Bearer\s+/i, "");
+        const url = this.opts.localBase().replace(/^http/, "ws") + "/ws" + (project ? `?project=${encodeURIComponent(project)}` : "");
+        const ws = new WebSocket(url, [`loom.bearer.${token}`], { headers: { "x-loom-via": "relay" } });
+        c.ws = ws;
+        ws.on("open", () => void this.send({ t: "stream", to: from, open: true }));
+        ws.on("message", (data) => {
+            let frame;
+            try {
+                frame = JSON.parse(String(data));
+            }
+            catch {
+                return;
+            }
+            // Terminal output is a firehose; it stays on direct connections.
+            if (frame.type === "term")
+                return;
+            this.stats.frames++;
+            c.buffer.push(frame);
+            c.bufferBytes += data.length ?? 0;
+            if (c.bufferBytes >= FLUSH_BYTES)
+                this.flush(from);
+            else
+                c.timer ??= setTimeout(() => this.flush(from), FLUSH_MS);
+        });
+        ws.on("close", (code) => {
+            if (c.ws !== ws)
+                return;
+            this.flush(from);
+            c.ws = undefined;
+            void this.send({ t: "stream", to: from, open: false, code });
+        });
+        ws.on("error", () => { });
+    }
+    flush(from) {
+        const c = this.clients.get(from);
+        if (!c)
+            return;
+        if (c.timer)
+            clearTimeout(c.timer);
+        c.timer = undefined;
+        if (!c.buffer.length)
+            return;
+        const frames = c.buffer;
+        c.buffer = [];
+        c.bufferBytes = 0;
+        void this.send({ t: "evs", to: from, frames });
+    }
+    unsubscribe(from, forget = true) {
+        const c = this.clients.get(from);
+        if (!c)
+            return;
+        const ws = c.ws;
+        c.ws = undefined;
+        ws?.close();
+        if (forget && !c.inflight) {
+            if (c.timer)
+                clearTimeout(c.timer);
+            this.clients.delete(from);
+        }
+    }
+    /** A phone that stopped pinging is gone; don't hold a socket open for it. */
+    sweep() {
+        const cutoff = Date.now() - CLIENT_IDLE_MS;
+        for (const [id, c] of this.clients)
+            if (c.lastSeen < cutoff)
+                this.unsubscribe(id);
+        this.forgetSeen(Date.now());
+    }
+    async close() {
+        this.closed = true;
+        clearInterval(this.sweeper);
+        for (const id of [...this.clients.keys()])
+            this.unsubscribe(id);
+        await this.opts.transport.close();
+    }
+}
+//# sourceMappingURL=relay.js.map

package/dist/daemon/relay.js.map

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

package/dist/daemon/routes/agent-discovery.d.ts

@@ -0,0 +1,4 @@
+import type { Express } from 'express';
+import type { WithRuntime } from './context.js';
+/** Register agent-discovery routes in the order established by LoomDaemon.routes(). */
+export declare function registerAgentDiscoveryRoutes(app: Express, withRuntime: WithRuntime): void;

package/dist/daemon/routes/agent-discovery.js

@@ -0,0 +1,29 @@
+import { ADES, detectAdes } from "../../core/ades.js";
+/** Register agent-discovery routes in the order established by LoomDaemon.routes(). */
+export function registerAgentDiscoveryRoutes(app, withRuntime) {
+    // Which agents Loom can drive on this machine, and which are already in
+    // this project. The UI needs both to offer you the difference.
+    app.get("/api/projects/:id/agents/available", withRuntime(async (rt, _req, res) => {
+        const availability = await detectAdes();
+        const counts = rt.instanceCounts();
+        res.json({
+            ades: ADES.map((a) => ({
+                kind: a.kind,
+                label: a.label,
+                tier: a.tier,
+                // Bridges are never "installed" — they're an app you launch with a
+                // debug port, so presence is a live question, not a lookup.
+                installed: a.tier === "adapter" ? Boolean(availability[a.kind]) : null,
+                inProject: (counts[a.kind] ?? 0) > 0,
+                // How many sessions of this kind are already here. `inProject` used
+                // to be the whole answer and the rail hid anything already present,
+                // which made a second Claude Code session unreachable from the UI
+                // even though the roster could hold one. Adapters can be added
+                // again; bridges are read-mostly and one is enough.
+                instances: counts[a.kind] ?? 0,
+                canAddAnother: a.tier === "adapter",
+            })),
+        });
+    }));
+}
+//# sourceMappingURL=agent-discovery.js.map

package/dist/daemon/routes/agent-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-discovery.js","sourceRoot":"","sources":["../../../src/daemon/routes/agent-discovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEtD,uFAAuF;AACvF,MAAM,UAAU,4BAA4B,CAAC,GAAY,EAAE,WAAwB;IAEjF,wEAAwE;IACxE,+DAA+D;IAC/D,GAAG,CAAC,GAAG,CACL,oCAAoC,EACpC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAClC,MAAM,YAAY,GAAG,MAAM,UAAU,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC;QACnC,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,mEAAmE;gBACnE,4DAA4D;gBAC5D,SAAS,EAAE,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBACtE,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;gBACpC,oEAAoE;gBACpE,oEAAoE;gBACpE,kEAAkE;gBAClE,+DAA+D;gBAC/D,oDAAoD;gBACpD,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC9B,aAAa,EAAE,CAAC,CAAC,IAAI,KAAK,SAAS;aACpC,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/daemon/routes/agent-settings.d.ts

@@ -0,0 +1,4 @@
+import type { Express } from 'express';
+import type { WithRuntime } from './context.js';
+/** Register agent-settings routes in the order established by LoomDaemon.routes(). */
+export declare function registerAgentSettingsRoutes(app: Express, withRuntime: WithRuntime): void;

package/dist/daemon/routes/agent-settings.js

@@ -0,0 +1,94 @@
+/** Register agent-settings routes in the order established by LoomDaemon.routes(). */
+export function registerAgentSettingsRoutes(app, withRuntime) {
+    // Rename an agent's role. It's free text — your project decides what jobs
+    // exist, not us. Writes .loom/config.json, which is the source of truth.
+    app.post("/api/projects/:id/agents/:agentId/role", withRuntime(async (rt, req, res) => {
+        const { role } = (req.body ?? {});
+        if (typeof role !== "string")
+            return void res.status(400).json({ error: "missing role" });
+        const clean = role.trim().slice(0, 40);
+        if (!clean)
+            return void res.status(400).json({ error: "role cannot be empty" });
+        const updated = rt.setAgentRole(String(req.params.agentId), clean);
+        if (!updated)
+            return void res.status(404).json({ error: "unknown agent" });
+        res.json(updated);
+    }));
+    // An agent's picture ({ avatar: data URL | null }).
+    app.put("/api/projects/:id/agents/:agentId/avatar", withRuntime(async (rt, req, res) => {
+        const { avatar } = (req.body ?? {});
+        try {
+            const out = rt.setAgentAvatar(String(req.params.agentId), avatar === null || avatar === undefined ? null : String(avatar));
+            if (!out)
+                return void res.status(404).json({ error: "unknown agent" });
+            res.json(out);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    }));
+    // A model agent's sampling: temperature and max tokens (null clears).
+    app.put("/api/projects/:id/agents/:agentId/sampling", withRuntime(async (rt, req, res) => {
+        const b = (req.body ?? {});
+        const num = (v) => (v === undefined ? undefined : v === null || v === "" ? null : Number(v));
+        try {
+            const cfg = rt.setAgentSampling(String(req.params.agentId), { temperature: num(b.temperature), maxTokens: num(b.maxTokens) });
+            res.json({ id: cfg.id, options: cfg.options });
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    }));
+    // Is this agent ready? Installed, signed in, model listed — no prompt sent.
+    app.post("/api/projects/:id/agents/:agentId/check", withRuntime(async (rt, req, res) => {
+        const out = await rt.checkAgent(String(req.params.agentId));
+        if (!out)
+            return void res.status(404).json({ error: "no such agent" });
+        res.json(out);
+    }));
+    // Standing instructions for one agent, sent ahead of every turn it takes.
+    app.put("/api/projects/:id/agents/:agentId/instructions", withRuntime(async (rt, req, res) => {
+        const { instructions } = (req.body ?? {});
+        if (typeof instructions !== "string")
+            return void res.status(400).json({ error: "instructions must be text (empty clears them)" });
+        const updated = rt.setAgentInstructions(String(req.params.agentId), instructions);
+        if (!updated)
+            return void res.status(404).json({ error: "unknown agent" });
+        res.json(updated);
+    }));
+    // Switch an agent off (or back on) without removing it from the roster.
+    // 409 rather than 400 for the refusals — holding the baton and being
+    // mid-turn are both states that pass on their own, so the message names
+    // what to do rather than calling the request malformed.
+    app.put("/api/projects/:id/agents/:agentId/enabled", withRuntime(async (rt, req, res) => {
+        const { enabled } = (req.body ?? {});
+        try {
+            res.json(rt.setAgentEnabled(String(req.params.agentId), enabled !== false));
+        }
+        catch (e) {
+            res.status(409).json({ error: e instanceof Error ? e.message : String(e) });
+        }
+    }));
+    /**
+     * Lift an alert pause by hand.
+     *
+     * The loop lifts itself when the alert resolves or the recheck sees the
+     * agent healthy again, and that is the normal path. This is the override
+     * for when you know better than the alert — a flapping rule, a threshold
+     * set too tight — because otherwise the only way out is editing state on
+     * disk, and an operator with no button will go and do exactly that.
+     */
+    app.delete("/api/projects/:id/quarantine/:agentId", withRuntime(async (rt, req, res) => {
+        const agentId = String(req.params.agentId);
+        const lifted = rt.unquarantine(agentId);
+        if (!lifted)
+            return void res.status(404).json({ error: `"${agentId}" is not paused` });
+        rt.log.append({
+            kind: "status",
+            agentId,
+            payload: { state: "alert_recovery", alert: lifted.reason, retried: false, via: "manual" },
+        });
+        res.json({ lifted: true, agentId, was: lifted, quarantine: rt.quarantined() });
+    }));
+}
+//# sourceMappingURL=agent-settings.js.map

package/dist/daemon/routes/agent-settings.js.map

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

package/dist/daemon/routes/agents.d.ts

@@ -0,0 +1,4 @@
+import type { Express } from 'express';
+import type { WithRuntime } from './context.js';
+/** Register agents routes in the order established by LoomDaemon.routes(). */
+export declare function registerAgentsRoutes(app: Express, withRuntime: WithRuntime): void;

package/dist/daemon/routes/agents.js

@@ -0,0 +1,105 @@
+import { listModelsForKind } from '../system.js';
+import { MAIN_CHAT } from '../../types.js';
+/** Register agents routes in the order established by LoomDaemon.routes(). */
+export function registerAgentsRoutes(app, withRuntime) {
+    // Add an agent to a project. A roster used to be frozen at creation: install
+    // a new ADE and your existing projects never heard of it.
+    app.post("/api/projects/:id/agents", withRuntime(async (rt, req, res) => {
+        const { kind, id, role, options } = (req.body ?? {});
+        if (!kind?.trim())
+            return void res.status(400).json({ error: "missing kind" });
+        try {
+            res.json(rt.addAgent(kind.trim(), { id, role, ...(options ? { options } : {}) }));
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    }));
+    app.delete("/api/projects/:id/agents/:agentId", withRuntime(async (rt, req, res) => {
+        try {
+            res.json(rt.removeAgent(String(req.params.agentId)));
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    }));
+    // Point an agent at a different model. Empty string clears the override.
+    app.post("/api/projects/:id/agents/:agentId/model", withRuntime(async (rt, req, res) => {
+        const { model, provider } = (req.body ?? {});
+        try {
+            const cfg = rt.setAgentModel(String(req.params.agentId), model ?? "", provider);
+            res.json({ agent: cfg });
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    }));
+    // Answer a structured question an agent is waiting on (needs_input with a requestId).
+    // answers: { [questionId]: string | string[] }.
+    app.post("/api/projects/:id/agents/:agentId/answers", withRuntime(async (rt, req, res) => {
+        const b = (req.body ?? {});
+        if (!b.requestId || typeof b.requestId !== "string")
+            return void res.status(400).json({ error: "requestId is required" });
+        if (!b.answers || typeof b.answers !== "object" || Array.isArray(b.answers))
+            return void res.status(400).json({ error: "answers must be an object" });
+        try {
+            await rt.answerQuestion(String(req.params.agentId), typeof b.chat === "string" ? b.chat : "main", b.requestId, b.answers);
+            res.json({ ok: true });
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    }));
+    // Compact the agent's native context for a chat now.
+    app.post("/api/projects/:id/agents/:agentId/compact", withRuntime(async (rt, req, res) => {
+        const { chat } = (req.body ?? {});
+        try {
+            await rt.compactAgent(String(req.params.agentId), typeof chat === "string" ? chat : "main");
+            res.json({ ok: true });
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    }));
+    // The models this agent can run, and where the list came from.
+    //
+    // This comment used to promise "every real model this agent can run, asked
+    // of the underlying tool — not a hardcoded list", and for two of the five
+    // kinds that was a hardcoded list. Four are now genuinely asked (`opencode
+    // models` alone reports ~500 across every provider it has, `codex debug
+    // models` a JSON catalog); Claude Code has no way to answer and is served
+    // from a remembered set. `source` says which, per response, so a caller can
+    // report what actually happened instead of what we'd like to have happened.
+    app.get("/api/projects/:id/agents/:agentId/models", withRuntime(async (rt, req, res) => {
+        const agent = rt.config.agents.find((a) => a.id === String(req.params.agentId));
+        if (!agent)
+            return void res.status(404).json({ error: "unknown agent" });
+        const { models, source } = await listModelsForKind(agent.kind);
+        res.json({ kind: agent.kind, count: models.length, models, source });
+    }));
+    app.post("/api/projects/:id/interrupt", withRuntime(async (rt, req, res) => {
+        const chat = typeof req.body?.chat === "string" && req.body.chat ? String(req.body.chat) : undefined;
+        res.json(await rt.interrupt(chat ? { chat } : {}));
+    }));
+    // The loop card's buttons: an agent going in circles is stopped, nudged, or handed off.
+    app.post("/api/projects/:id/loop", withRuntime(async (rt, req, res) => {
+        const b = req.body ?? {};
+        const chat = typeof b.chat === "string" && b.chat ? b.chat : MAIN_CHAT;
+        const agent = String(b.agent ?? "");
+        const action = b.action === "stop" || b.action === "nudge" || b.action === "handoff" ? b.action : null;
+        if (!action)
+            return void res.status(400).json({ error: "action is stop, nudge or handoff" });
+        if (!rt.config.agents.some((a) => a.id === agent))
+            return void res.status(404).json({ error: "unknown agent" });
+        const to = typeof b.to === "string" && b.to ? b.to : undefined;
+        if (to && !rt.config.agents.some((a) => a.id === to))
+            return void res.status(404).json({ error: `unknown agent "${to}"` });
+        try {
+            res.json(await rt.actOnLoop(chat, agent, action, to));
+        }
+        catch (err) {
+            res.status(409).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    }));
+}
+//# sourceMappingURL=agents.js.map