homaruscc 0.2.0

package/dist/agent-registry.js

@@ -0,0 +1,207 @@
+// CRC: crc-AgentRegistry.md | Seq: seq-agent-dispatch.md, seq-agent-poll.md
+import { randomUUID } from "node:crypto";
+import { statSync, openSync, readSync, closeSync } from "node:fs";
+// R156: Completion markers found in Task agent JSONL output
+const COMPLETION_MARKERS = ['"stop_reason":"end_turn"', '"type":"result"'];
+// R156: Stable mtime threshold (ms) — file unchanged for this long is considered complete
+const STABLE_THRESHOLD_MS = 10_000;
+// R156: Number of bytes to read from file tail for marker detection
+const TAIL_BYTES = 512;
+export class AgentRegistry {
+    agents = new Map();
+    maxConcurrent;
+    emitFn = null;
+    logger;
+    // R155: Configurable poll interval
+    pollIntervalMs;
+    // R159: Global poll timer handle
+    pollTimer = null;
+    constructor(logger, maxConcurrent = 3, pollIntervalMs = 5000) {
+        this.logger = logger;
+        this.maxConcurrent = maxConcurrent;
+        this.pollIntervalMs = pollIntervalMs;
+    }
+    setEmitter(fn) {
+        this.emitFn = fn;
+    }
+    register(id, description, outputFile) {
+        const active = this.getActiveCount();
+        if (active >= this.maxConcurrent) {
+            this.logger.warn("Agent registry at capacity", { active, max: this.maxConcurrent });
+            return false;
+        }
+        this.agents.set(id, {
+            id,
+            description,
+            status: "running",
+            startTime: Date.now(),
+            outputFile,
+        });
+        this.logger.info("Agent registered", { id, description });
+        return true;
+    }
+    getAll() {
+        return Array.from(this.agents.values());
+    }
+    get(id) {
+        return this.agents.get(id) ?? null;
+    }
+    // R157, R162: Complete only if still running (prevents duplicate events)
+    complete(id, result) {
+        const agent = this.resolve(id);
+        if (!agent)
+            return;
+        if (agent.status !== "running")
+            return;
+        agent.status = "completed";
+        agent.result = result;
+        this.emit("agent_completed", id, agent.description, { result });
+        this.logger.info("Agent completed", { id, description: agent.description });
+    }
+    fail(id, error) {
+        const agent = this.resolve(id);
+        if (!agent)
+            return;
+        agent.status = "failed";
+        agent.error = error;
+        this.emit("agent_failed", id, agent.description, { error });
+        this.logger.warn("Agent failed", { id, error });
+    }
+    // R160: Cleanup removes agent and any associated polling state
+    cleanup(id) {
+        this.agents.delete(id);
+    }
+    getAvailableSlots() {
+        return Math.max(0, this.maxConcurrent - this.getActiveCount());
+    }
+    getActiveCount() {
+        let count = 0;
+        for (const agent of this.agents.values()) {
+            if (agent.status === "running")
+                count++;
+        }
+        return count;
+    }
+    // R159: Start global polling interval
+    startPolling() {
+        if (this.pollTimer)
+            return;
+        this.pollTimer = setInterval(() => this.pollAgents(), this.pollIntervalMs);
+        // Unref so the timer does not keep the process alive during shutdown
+        if (this.pollTimer && typeof this.pollTimer === "object" && "unref" in this.pollTimer) {
+            this.pollTimer.unref();
+        }
+        this.logger.info("Agent completion polling started", { intervalMs: this.pollIntervalMs });
+    }
+    // R159: Stop global polling interval
+    stopPolling() {
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+            this.logger.info("Agent completion polling stopped");
+        }
+    }
+    // R154, R158: Poll all running agents with outputFiles for completion
+    pollAgents() {
+        for (const agent of this.agents.values()) {
+            // R158: Only poll running agents with an outputFile
+            if (agent.status !== "running" || !agent.outputFile)
+                continue;
+            try {
+                this.checkAgentFile(agent);
+            }
+            catch (err) {
+                // R161: Log and skip on errors
+                this.logger.debug("Poll check error for agent", {
+                    id: agent.id,
+                    error: String(err),
+                });
+            }
+        }
+    }
+    checkAgentFile(agent) {
+        // R161: statSync may throw ENOENT if file does not exist yet
+        let stat;
+        try {
+            stat = statSync(agent.outputFile);
+        }
+        catch {
+            return; // File does not exist yet — skip
+        }
+        // Skip empty files
+        if (stat.size === 0)
+            return;
+        // R156: Read the tail of the file
+        const tail = this.readTail(agent.outputFile, stat.size);
+        if (!tail)
+            return;
+        // R156: Check for completion markers in the tail
+        const hasMarker = COMPLETION_MARKERS.some((m) => tail.includes(m));
+        if (hasMarker) {
+            this.logger.info("Detected completion marker in agent output", { id: agent.id });
+            this.complete(agent.id, this.extractSummary(tail));
+            return;
+        }
+        // R156: Check for stable mtime (no writes in STABLE_THRESHOLD_MS)
+        const age = Date.now() - stat.mtimeMs;
+        if (age >= STABLE_THRESHOLD_MS) {
+            this.logger.info("Detected stable output file for agent", {
+                id: agent.id,
+                stableForMs: Math.round(age),
+            });
+            this.complete(agent.id, this.extractSummary(tail));
+        }
+    }
+    // Read the last `count` bytes of a file as a UTF-8 string
+    readTail(filePath, fileSize) {
+        const readSize = Math.min(TAIL_BYTES, fileSize);
+        const offset = fileSize - readSize;
+        const buf = Buffer.alloc(readSize);
+        let fd = null;
+        try {
+            fd = openSync(filePath, "r");
+            readSync(fd, buf, 0, readSize, offset);
+            return buf.toString("utf-8");
+        }
+        catch {
+            return null;
+        }
+        finally {
+            if (fd !== null) {
+                try {
+                    closeSync(fd);
+                }
+                catch { /* ignore */ }
+            }
+        }
+    }
+    // Extract a brief summary from the file tail for the completion result
+    extractSummary(tail) {
+        // Try to find the last JSON line that looks like a result
+        const lines = tail.split("\n").filter((l) => l.trim().length > 0);
+        const lastLine = lines[lines.length - 1] ?? "";
+        // Truncate to a reasonable length for the event payload
+        if (lastLine.length > 200) {
+            return lastLine.slice(0, 200) + "...";
+        }
+        return lastLine || "(output file completed)";
+    }
+    resolve(id) {
+        const agent = this.agents.get(id);
+        if (!agent) {
+            this.logger.warn("Unknown agent", { id });
+            return null;
+        }
+        return agent;
+    }
+    emit(type, agentId, description, extra) {
+        this.emitFn?.({
+            id: randomUUID(),
+            type,
+            source: `agent:${agentId}`,
+            timestamp: Date.now(),
+            payload: { agentId, description, ...extra },
+        });
+    }
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/agent-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.js","sourceRoot":"","sources":["../src/agent-registry.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAelE,4DAA4D;AAC5D,MAAM,kBAAkB,GAAG,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,CAAC;AAE3E,0FAA0F;AAC1F,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC,oEAAoE;AACpE,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,MAAM,OAAO,aAAa;IAChB,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IACvC,aAAa,CAAS;IACtB,MAAM,GAAoC,IAAI,CAAC;IAC/C,MAAM,CAAS;IACvB,mCAAmC;IAC3B,cAAc,CAAS;IAC/B,iCAAiC;IACzB,SAAS,GAA0C,IAAI,CAAC;IAEhE,YAAY,MAAc,EAAE,aAAa,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI;QAClE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,UAAU,CAAC,EAA0B;QACnC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,EAAU,EAAE,WAAmB,EAAE,UAAmB;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACrC,IAAI,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;YACpF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE;YAClB,EAAE;YACF,WAAW;YACX,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,UAAU;SACX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,yEAAyE;IACzE,QAAQ,CAAC,EAAU,EAAE,MAAc;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO;QAEvC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;QAC3B,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QAEtB,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,CAAC,EAAU,EAAE,KAAa;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;QACxB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAEpB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,+DAA+D;IAC/D,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,cAAc;QACZ,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;gBAAE,KAAK,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sCAAsC;IACtC,YAAY;QACV,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3E,qEAAqE;QACrE,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtF,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,qCAAqC;IACrC,WAAW;QACT,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,UAAU;QACR,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,oDAAoD;YACpD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,UAAU;gBAAE,SAAS;YAE9D,IAAI,CAAC;gBACH,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,+BAA+B;gBAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE;oBAC9C,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,KAAiB;QACtC,6DAA6D;QAC7D,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAW,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,iCAAiC;QAC3C,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE5B,kCAAkC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,iDAAiD;QACjD,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnE,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACjF,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,kEAAkE;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACtC,IAAI,GAAG,IAAI,mBAAmB,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE;gBACxD,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;aAC7B,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,0DAA0D;IAClD,QAAQ,CAAC,QAAgB,EAAE,QAAgB;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEnC,IAAI,EAAE,GAAkB,IAAI,CAAC;QAC7B,IAAI,CAAC;YACH,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC7B,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACvC,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChB,IAAI,CAAC;oBAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IAED,uEAAuE;IAC/D,cAAc,CAAC,IAAY;QACjC,0DAA0D;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,wDAAwD;QACxD,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;QACxC,CAAC;QACD,OAAO,QAAQ,IAAI,yBAAyB,CAAC;IAC/C,CAAC;IAEO,OAAO,CAAC,EAAU;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,IAAI,CACV,IAAY,EACZ,OAAe,EACf,WAAmB,EACnB,KAA6B;QAE7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,EAAE,EAAE,UAAU,EAAE;YAChB,IAAI;YACJ,MAAM,EAAE,SAAS,OAAO,EAAE;YAC1B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/backend.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

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

package/dist/backend.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+// CRC: crc-Backend.md | Seq: seq-startup.md
+// HomarUScc backend — standalone process (no MCP stdio)
+// Used by mcp-proxy.ts or as a standalone server.
+import { HomarUScc } from "./homaruscc.js";
+import { DashboardServer } from "./dashboard-server.js";
+import { DashboardAdapter } from "./dashboard-adapter.js";
+const logger = {
+    debug(msg, meta) {
+        if (process.env.HOMARUSCC_DEBUG) {
+            process.stderr.write(`[DEBUG] ${msg} ${meta ? JSON.stringify(meta) : ""}\n`);
+        }
+    },
+    info(msg, meta) {
+        process.stderr.write(`[INFO] ${msg} ${meta ? JSON.stringify(meta) : ""}\n`);
+    },
+    warn(msg, meta) {
+        process.stderr.write(`[WARN] ${msg} ${meta ? JSON.stringify(meta) : ""}\n`);
+    },
+    error(msg, meta) {
+        process.stderr.write(`[ERROR] ${msg} ${meta ? JSON.stringify(meta) : ""}\n`);
+    },
+};
+async function main() {
+    const configPath = process.env.HOMARUSCC_CONFIG ?? undefined;
+    const loop = new HomarUScc(logger, configPath);
+    await loop.start();
+    // Dashboard adapter (channel)
+    const dashboardConfig = loop.getConfig().getAll().dashboard;
+    let dashboardServer = null;
+    if (dashboardConfig?.enabled !== false) {
+        const dashboardAdapter = new DashboardAdapter(logger);
+        loop.getChannelManager().registerAdapter(dashboardAdapter);
+        await dashboardAdapter.connect();
+        dashboardAdapter.onMessage((event) => loop.emit(event));
+        dashboardServer = new DashboardServer(logger, dashboardConfig?.port ?? 3120, loop, dashboardAdapter);
+        await dashboardServer.start();
+        // Forward event loop notifications to dashboard WebSocket clients
+        loop.setNotifyFn((event) => {
+            dashboardServer?.broadcastEvent(event);
+        });
+    }
+    logger.info("HomarUScc backend running (no MCP stdio)");
+    // Graceful shutdown
+    const shutdown = async () => {
+        logger.info("Backend shutting down...");
+        if (dashboardServer)
+            await dashboardServer.stop();
+        await loop.stop();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+main().catch((err) => {
+    process.stderr.write(`[FATAL] ${String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

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

package/dist/browser-service.d.ts

@@ -0,0 +1,19 @@
+import type { BrowserConfig, Logger } from "./types.js";
+export declare class BrowserService {
+    private browser;
+    private persistentContext;
+    private page;
+    private config;
+    private logger;
+    constructor(logger: Logger, config: BrowserConfig);
+    private ensureBrowser;
+    navigate(url: string): Promise<string>;
+    snapshot(): Promise<string>;
+    screenshot(): Promise<string>;
+    click(selector: string): Promise<string>;
+    type(selector: string, text: string): Promise<string>;
+    evaluate(script: string): Promise<string>;
+    getContent(): Promise<string>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=browser-service.d.ts.map

package/dist/browser-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-service.d.ts","sourceRoot":"","sources":["../src/browser-service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAExD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa;YAKnC,aAAa;IAkDrB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOtC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAM3B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAM7B,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMrD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMzC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAW5B"}

package/dist/browser-service.js

@@ -0,0 +1,101 @@
+export class BrowserService {
+    browser = null;
+    persistentContext = null;
+    page = null;
+    config;
+    logger;
+    constructor(logger, config) {
+        this.logger = logger;
+        this.config = config;
+    }
+    async ensureBrowser() {
+        if (this.page)
+            return this.page;
+        const { chromium } = await import("playwright");
+        const headless = this.config.headless ?? true;
+        const viewport = this.config.viewport ?? { width: 1280, height: 720 };
+        if (this.config.userDataDir) {
+            // Persistent context — reuses cookies, localStorage, sessions across launches
+            this.logger.info("Launching persistent browser", {
+                headless,
+                userDataDir: this.config.userDataDir,
+            });
+            const context = await chromium.launchPersistentContext(this.config.userDataDir, {
+                headless,
+                viewport,
+                ...(this.config.executablePath && {
+                    executablePath: this.config.executablePath,
+                }),
+                ...(this.config.proxy && { proxy: { server: this.config.proxy } }),
+            });
+            // launchPersistentContext returns a BrowserContext, not a Browser
+            this.persistentContext = context;
+            this.page = context.pages()[0] ?? (await context.newPage());
+        }
+        else {
+            // Ephemeral context — clean session each time
+            const launchOptions = { headless };
+            if (this.config.executablePath) {
+                launchOptions.executablePath = this.config.executablePath;
+            }
+            if (this.config.proxy) {
+                launchOptions.proxy = { server: this.config.proxy };
+            }
+            this.logger.info("Launching browser", { headless });
+            this.browser = await chromium.launch(launchOptions);
+            const context = await this.browser.newContext({ viewport });
+            this.page = await context.newPage();
+        }
+        this.page.setDefaultTimeout(this.config.timeout ?? 30000);
+        this.logger.info("Browser ready");
+        return this.page;
+    }
+    async navigate(url) {
+        const page = await this.ensureBrowser();
+        await page.goto(url, { waitUntil: "domcontentloaded" });
+        const title = await page.title();
+        return `Navigated to: ${page.url()}\nTitle: ${title}`;
+    }
+    async snapshot() {
+        const page = await this.ensureBrowser();
+        const snap = await page.locator("body").ariaSnapshot();
+        return snap || "Empty accessibility snapshot";
+    }
+    async screenshot() {
+        const page = await this.ensureBrowser();
+        const buffer = await page.screenshot({ type: "png" });
+        return buffer.toString("base64");
+    }
+    async click(selector) {
+        const page = await this.ensureBrowser();
+        await page.click(selector);
+        return `Clicked: ${selector}`;
+    }
+    async type(selector, text) {
+        const page = await this.ensureBrowser();
+        await page.fill(selector, text);
+        return `Typed into: ${selector}`;
+    }
+    async evaluate(script) {
+        const page = await this.ensureBrowser();
+        const result = await page.evaluate(script);
+        return typeof result === "string" ? result : JSON.stringify(result, null, 2);
+    }
+    async getContent() {
+        const page = await this.ensureBrowser();
+        return await page.evaluate(() => document.body.innerText);
+    }
+    async stop() {
+        this.logger.info("Closing browser");
+        if (this.persistentContext) {
+            await this.persistentContext.close();
+            this.persistentContext = null;
+        }
+        else if (this.browser) {
+            await this.browser.close();
+            this.browser = null;
+        }
+        this.page = null;
+    }
+}
+//# sourceMappingURL=browser-service.js.map

package/dist/browser-service.js.map

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

package/dist/channel-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { Event, MessagePayload, OutboundMessage, DmPolicy, GroupPolicy, HealthStatus, Logger } from "./types.js";
+export type AdapterState = "disconnected" | "connecting" | "connected" | "error";
+export declare abstract class ChannelAdapter {
+    readonly name: string;
+    protected state: AdapterState;
+    protected dmPolicy: DmPolicy;
+    protected groupPolicy: GroupPolicy;
+    protected logger: Logger;
+    private messageHandler;
+    constructor(name: string, logger: Logger, dmPolicy?: DmPolicy, groupPolicy?: GroupPolicy);
+    getState(): AdapterState;
+    abstract connect(): Promise<void>;
+    abstract disconnect(): Promise<void>;
+    abstract send(target: string, message: OutboundMessage): Promise<void>;
+    abstract health(): HealthStatus;
+    onMessage(handler: (event: Event) => void): void;
+    protected normalizeInbound(payload: MessagePayload, target?: string): Event;
+    protected checkAccess(payload: MessagePayload): boolean;
+    protected deliver(payload: MessagePayload): void;
+    protected deliverWithTarget(payload: MessagePayload, target: string): void;
+}
+//# sourceMappingURL=channel-adapter.d.ts.map

package/dist/channel-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-adapter.d.ts","sourceRoot":"","sources":["../src/channel-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EACpF,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;AAEjF,8BAAsB,cAAc;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,KAAK,EAAE,YAAY,CAAkB;IAC/C,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC7B,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;IACnC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,cAAc,CAAyC;gBAEnD,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAiB,EAAE,WAAW,GAAE,WAAgC;IAOpH,QAAQ,IAAI,YAAY;IAIxB,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,MAAM,IAAI,YAAY;IAE/B,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAIhD,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK;IAW3E,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAUvD,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAShD,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAQ3E"}

package/dist/channel-adapter.js

@@ -0,0 +1,62 @@
+// CRC: crc-ChannelAdapter.md | Seq: seq-event-flow.md
+// Channel adapter base — from HomarUS (removed CLIChannelAdapter, not needed for MCP)
+import { v4 as uuid } from "uuid";
+export class ChannelAdapter {
+    name;
+    state = "disconnected";
+    dmPolicy;
+    groupPolicy;
+    logger;
+    messageHandler = null;
+    constructor(name, logger, dmPolicy = "open", groupPolicy = "mention_required") {
+        this.name = name;
+        this.logger = logger;
+        this.dmPolicy = dmPolicy;
+        this.groupPolicy = groupPolicy;
+    }
+    getState() {
+        return this.state;
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    normalizeInbound(payload, target) {
+        const source = target ? `channel:${this.name}:${target}` : `channel:${this.name}`;
+        return {
+            id: uuid(),
+            type: "message",
+            source,
+            timestamp: Date.now(),
+            payload,
+        };
+    }
+    checkAccess(payload) {
+        if (payload.isGroup) {
+            if (this.groupPolicy === "disabled")
+                return false;
+            if (this.groupPolicy === "mention_required" && !payload.isMention)
+                return false;
+            return true;
+        }
+        if (this.dmPolicy === "disabled")
+            return false;
+        return true;
+    }
+    deliver(payload) {
+        if (!this.checkAccess(payload)) {
+            this.logger.debug("Message rejected by policy", { channel: this.name, from: payload.from });
+            return;
+        }
+        const event = this.normalizeInbound(payload);
+        this.messageHandler?.(event);
+    }
+    deliverWithTarget(payload, target) {
+        if (!this.checkAccess(payload)) {
+            this.logger.debug("Message rejected by policy", { channel: this.name, from: payload.from });
+            return;
+        }
+        const event = this.normalizeInbound(payload, target);
+        this.messageHandler?.(event);
+    }
+}
+//# sourceMappingURL=channel-adapter.js.map

package/dist/channel-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-adapter.js","sourceRoot":"","sources":["../src/channel-adapter.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,sFAAsF;AACtF,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAOlC,MAAM,OAAgB,cAAc;IACzB,IAAI,CAAS;IACZ,KAAK,GAAiB,cAAc,CAAC;IACrC,QAAQ,CAAW;IACnB,WAAW,CAAc;IACzB,MAAM,CAAS;IACjB,cAAc,GAAoC,IAAI,CAAC;IAE/D,YAAY,IAAY,EAAE,MAAc,EAAE,WAAqB,MAAM,EAAE,cAA2B,kBAAkB;QAClH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAOD,SAAS,CAAC,OAA+B;QACvC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAES,gBAAgB,CAAC,OAAuB,EAAE,MAAe;QACjE,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC;QAClF,OAAO;YACL,EAAE,EAAE,IAAI,EAAE;YACV,IAAI,EAAE,SAAS;YACf,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO;SACR,CAAC;IACJ,CAAC;IAES,WAAW,CAAC,OAAuB;QAC3C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,IAAI,CAAC,WAAW,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YAClD,IAAI,IAAI,CAAC,WAAW,KAAK,kBAAkB,IAAI,CAAC,OAAO,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAC;YAChF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAES,OAAO,CAAC,OAAuB;QACvC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5F,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAES,iBAAiB,CAAC,OAAuB,EAAE,MAAc;QACjE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5F,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/channel-manager.d.ts

@@ -0,0 +1,18 @@
+import type { Event, OutboundMessage, ChannelConfig, HealthStatus, Logger } from "./types.js";
+import { ChannelAdapter } from "./channel-adapter.js";
+export declare class ChannelManager {
+    private adapters;
+    private logger;
+    private eventHandler;
+    constructor(logger: Logger);
+    setEventHandler(fn: (event: Event) => void): void;
+    loadAdapters(channels: Record<string, ChannelConfig>): void;
+    registerAdapter(adapter: ChannelAdapter): void;
+    connectAll(): Promise<void>;
+    disconnectAll(): Promise<void>;
+    send(channel: string, target: string, message: OutboundMessage): Promise<void>;
+    getAdapter(name: string): ChannelAdapter | undefined;
+    getConnected(): ChannelAdapter[];
+    healthCheck(): Record<string, HealthStatus>;
+}
+//# sourceMappingURL=channel-manager.d.ts.map

package/dist/channel-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-manager.d.ts","sourceRoot":"","sources":["../src/channel-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAyC;gBAEjD,MAAM,EAAE,MAAM;IAI1B,eAAe,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAIjD,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI;IAkB3D,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIxC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIpD,YAAY,IAAI,cAAc,EAAE;IAIhC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;CAO5C"}

package/dist/channel-manager.js

@@ -0,0 +1,73 @@
+import { TelegramChannelAdapter } from "./telegram-adapter.js";
+export class ChannelManager {
+    adapters = new Map();
+    logger;
+    eventHandler = null;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    setEventHandler(fn) {
+        this.eventHandler = fn;
+    }
+    loadAdapters(channels) {
+        for (const [name, config] of Object.entries(channels)) {
+            let adapter;
+            switch (name) {
+                case "telegram":
+                    adapter = TelegramChannelAdapter.fromChannelConfig(config, this.logger);
+                    break;
+                default:
+                    this.logger.warn("Unknown channel type, skipping", { name });
+                    continue;
+            }
+            this.adapters.set(name, adapter);
+        }
+    }
+    // Register an externally-created adapter (e.g., dashboard adapter)
+    registerAdapter(adapter) {
+        this.adapters.set(adapter.name, adapter);
+    }
+    async connectAll() {
+        for (const [name, adapter] of this.adapters) {
+            try {
+                adapter.onMessage((event) => this.eventHandler?.(event));
+                await adapter.connect();
+            }
+            catch (err) {
+                this.logger.error("Failed to connect channel", { name, error: String(err) });
+            }
+        }
+        this.logger.info("Channels connected", { count: this.adapters.size });
+    }
+    async disconnectAll() {
+        for (const [name, adapter] of this.adapters) {
+            try {
+                await adapter.disconnect();
+            }
+            catch (err) {
+                this.logger.warn("Error disconnecting channel", { name, error: String(err) });
+            }
+        }
+    }
+    async send(channel, target, message) {
+        const adapter = this.adapters.get(channel);
+        if (!adapter) {
+            throw new Error(`Unknown channel: ${channel}`);
+        }
+        await adapter.send(target, message);
+    }
+    getAdapter(name) {
+        return this.adapters.get(name);
+    }
+    getConnected() {
+        return [...this.adapters.values()].filter((a) => a.getState() === "connected");
+    }
+    healthCheck() {
+        const results = {};
+        for (const [name, adapter] of this.adapters) {
+            results[name] = adapter.health();
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=channel-manager.js.map

package/dist/channel-manager.js.map

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

package/dist/compaction-manager.d.ts

@@ -0,0 +1,23 @@
+import type { Logger } from "./types.js";
+import type { HomarUScc } from "./homaruscc.js";
+export declare class CompactionManager {
+    private flushedThisCycle;
+    private lastFlushTimestamp;
+    private compactedSinceLastWake;
+    private logger;
+    private loop;
+    constructor(loop: HomarUScc, logger: Logger);
+    handlePreCompact(): string;
+    handlePostCompact(): string;
+    /**
+     * Returns true if compaction occurred since the last /api/wait delivery.
+     * Consuming this resets the flag — the next call returns false until
+     * another compaction happens.
+     */
+    consumeCompactionFlag(): boolean;
+    getFlushState(): {
+        flushedThisCycle: boolean;
+        lastFlushTimestamp: number;
+    };
+}
+//# sourceMappingURL=compaction-manager.d.ts.map