sensorium-mcp 3.0.103 → 3.1.0-refactor.1

package/dist/dashboard/routes/threads-create.js

@@ -0,0 +1,225 @@
+/**
+ * Dashboard API — thread creation route handlers: raw registration, root
+ * creation (owns Telegram topic creation), and branch creation (with memory
+ * fork from the parent root).
+ */
+import { registerThread, getThread, } from "../../data/memory/thread-registry.js";
+import { forkMemory } from "../../data/memory/synthesis.js";
+import { config, getAgentType } from "../../config/index.js";
+import { readBody, safeParseJSON } from "./types.js";
+import { VALID_CLIENTS } from "./threads-helpers.js";
+import { syncKeepAliveToSettings } from "../../services/keep-alive-sync.service.js";
+import { errorMessage } from "../../lib/utils.js";
+import { log } from "../../lib/logger.js";
+import { createManagedTopic } from "../../services/topic.service.js";
+import { TelegramClient } from "../../services/telegram.js";
+// ─── POST /api/threads — create/register a thread ──────────────────────────
+export const handleCreateThread = ({ req, json, db }) => {
+    void (async () => {
+        try {
+            const raw = await readBody(req);
+            const body = safeParseJSON(raw);
+            if (!body || typeof body !== "object") {
+                json({ error: "Invalid request body" }, 400);
+                return;
+            }
+            const threadId = body.threadId;
+            if (typeof threadId !== "number" ||
+                !Number.isFinite(threadId) ||
+                !Number.isInteger(threadId) ||
+                threadId <= 0) {
+                json({ error: "threadId must be a positive integer" }, 400);
+                return;
+            }
+            const name = body.name;
+            if (typeof name !== "string" || !name.trim()) {
+                json({ error: "name is required" }, 400);
+                return;
+            }
+            const validTypes = ["root", "daily", "branch", "worker"];
+            const type = body.type;
+            if (typeof type !== "string" || !validTypes.includes(type)) {
+                json({ error: `type must be one of: ${validTypes.join(", ")}` }, 400);
+                return;
+            }
+            const client = typeof body.client === "string" &&
+                VALID_CLIENTS.includes(body.client)
+                ? body.client
+                : undefined;
+            const keepAlive = typeof body.keepAlive === "boolean" ? body.keepAlive : undefined;
+            const workingDirectory = typeof body.workingDirectory === "string" && body.workingDirectory.trim()
+                ? body.workingDirectory.trim()
+                : undefined;
+            // Check for duplicate
+            const existing = getThread(db, threadId);
+            if (existing) {
+                json({ error: `Thread ${threadId} already exists` }, 409);
+                return;
+            }
+            const entry = registerThread(db, {
+                threadId,
+                name: name.trim(),
+                type: type,
+                rootThreadId: typeof body.rootThreadId === "number" ? body.rootThreadId : undefined,
+                badge: typeof body.badge === "string" ? body.badge : undefined,
+                client,
+                keepAlive,
+                workingDirectory,
+            });
+            json(entry, 201);
+            // Sync keepAlive to settings.json for watcher backward compatibility
+            if (entry.keepAlive) {
+                syncKeepAliveToSettings(db);
+            }
+        }
+        catch (err) {
+            json({ error: errorMessage(err) }, 500);
+        }
+    })();
+    return true;
+};
+// ─── POST /api/threads/create-root — create a fresh topic + root thread ─────
+/**
+ * Create a brand-new root thread: opens a Telegram forum topic and registers
+ * the thread. Unlike POST /api/threads (which only registers a caller-supplied
+ * topic id), this owns topic creation so callers without Telegram access (e.g.
+ * the supervisor) can spin up threads. keepAlive + dailyRotation default on for
+ * root threads via registerThread.
+ */
+export const handleCreateRoot = ({ req, json, db, ctx }) => {
+    void (async () => {
+        try {
+            const raw = await readBody(req);
+            const body = safeParseJSON(raw);
+            if (!body || typeof body !== "object") {
+                json({ error: "Invalid request body" }, 400);
+                return;
+            }
+            const name = typeof body.name === "string" ? body.name.trim() : "";
+            if (!name) {
+                json({ error: "name is required" }, 400);
+                return;
+            }
+            const agentType = resolveAgentType(body.agentType);
+            if (agentType === INVALID_AGENT) {
+                json({ error: `agentType must be one of: ${VALID_CLIENTS.join(", ")}` }, 400);
+                return;
+            }
+            const workingDirectory = typeof body.workingDirectory === "string" ? body.workingDirectory.trim() : "";
+            if (!workingDirectory) {
+                json({ error: "workingDirectory is required" }, 400);
+                return;
+            }
+            const { TELEGRAM_TOKEN, TELEGRAM_CHAT_ID } = config;
+            if (!TELEGRAM_TOKEN || !TELEGRAM_CHAT_ID) {
+                json({ error: "Telegram is not configured" }, 500);
+                return;
+            }
+            const telegram = new TelegramClient(TELEGRAM_TOKEN);
+            const threadId = await createManagedTopic(telegram, TELEGRAM_CHAT_ID, name);
+            const thread = ctx.threadLifecycle.registerThread(db, {
+                threadId,
+                name,
+                type: "root",
+                client: agentType ?? getAgentType(),
+                workingDirectory,
+                chatId: TELEGRAM_CHAT_ID,
+                telegramTopicId: threadId,
+            });
+            json({ ok: true, threadId, thread }, 201);
+            syncKeepAliveToSettings(db);
+        }
+        catch (err) {
+            json({ error: errorMessage(err) }, 500);
+        }
+    })();
+    return true;
+};
+// ─── POST /api/threads/create-branch — create a fresh topic + branch thread ──
+/**
+ * Create a branch thread under an existing root: opens a Telegram forum topic
+ * and registers it with type=branch. Working directory and agent type are
+ * inherited from the parent root unless overridden.
+ */
+export const handleCreateBranch = ({ req, json, db, ctx }) => {
+    void (async () => {
+        try {
+            const raw = await readBody(req);
+            const body = safeParseJSON(raw);
+            if (!body || typeof body !== "object") {
+                json({ error: "Invalid request body" }, 400);
+                return;
+            }
+            const rootThreadId = body.rootThreadId;
+            if (typeof rootThreadId !== "number" ||
+                !Number.isInteger(rootThreadId) ||
+                rootThreadId <= 0) {
+                json({ error: "rootThreadId must be a positive integer" }, 400);
+                return;
+            }
+            const name = typeof body.name === "string" ? body.name.trim() : "";
+            if (!name) {
+                json({ error: "name is required" }, 400);
+                return;
+            }
+            const parent = getThread(db, rootThreadId);
+            if (!parent) {
+                json({ error: `Root thread ${rootThreadId} not found` }, 404);
+                return;
+            }
+            if (parent.type === "worker") {
+                json({ error: "Cannot branch from a worker thread" }, 400);
+                return;
+            }
+            const agentType = resolveAgentType(body.agentType);
+            if (agentType === INVALID_AGENT) {
+                json({ error: `agentType must be one of: ${VALID_CLIENTS.join(", ")}` }, 400);
+                return;
+            }
+            const workingDirectoryOverride = typeof body.workingDirectory === "string" && body.workingDirectory.trim()
+                ? body.workingDirectory.trim()
+                : undefined;
+            const { TELEGRAM_TOKEN, TELEGRAM_CHAT_ID } = config;
+            if (!TELEGRAM_TOKEN || !TELEGRAM_CHAT_ID) {
+                json({ error: "Telegram is not configured" }, 500);
+                return;
+            }
+            const telegram = new TelegramClient(TELEGRAM_TOKEN);
+            const threadId = await createManagedTopic(telegram, TELEGRAM_CHAT_ID, name);
+            const thread = ctx.threadLifecycle.registerThread(db, {
+                threadId,
+                name,
+                type: "branch",
+                rootThreadId,
+                client: agentType ?? parent.client ?? getAgentType(),
+                workingDirectory: workingDirectoryOverride ?? parent.workingDirectory ?? undefined,
+                chatId: TELEGRAM_CHAT_ID,
+                telegramTopicId: threadId,
+            });
+            try {
+                const fork = forkMemory(db, rootThreadId, threadId);
+                log.info(`[create-branch] Forked memory ${rootThreadId} → ${threadId}: ${fork.notesCopied} notes, ${fork.narrativesCopied} narratives, ${fork.episodesCopied} episodes`);
+            }
+            catch (err) {
+                log.warn(`[create-branch] Memory fork failed (non-fatal): ${errorMessage(err)}`);
+            }
+            json({ ok: true, threadId, thread }, 201);
+            syncKeepAliveToSettings(db);
+        }
+        catch (err) {
+            json({ error: errorMessage(err) }, 500);
+        }
+    })();
+    return true;
+};
+/** Sentinel returned by resolveAgentType when an explicit agentType is invalid. */
+const INVALID_AGENT = Symbol("invalid-agent");
+/** Validate an optional agentType field: undefined → undefined, valid → the value, invalid → INVALID_AGENT. */
+function resolveAgentType(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === "string" && VALID_CLIENTS.includes(value))
+        return value;
+    return INVALID_AGENT;
+}
+//# sourceMappingURL=threads-create.js.map

package/dist/dashboard/routes/threads-create.js.map

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

package/dist/dashboard/routes/threads-helpers.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Dashboard API — shared helpers for the thread route handlers: update-body
+ * validation, thread-name enrichment, per-thread MCP server attachment/parsing.
+ */
+import type { ThreadRegistryEntry } from "../../data/memory/thread-registry.js";
+import type { Database } from "../../data/memory/schema.js";
+import { maskThreadMcpServers, type ThreadMcpServer } from "../../config/index.js";
+export declare const VALID_CLIENTS: readonly ["claude", "copilot", "codex", "openai_codex"];
+/** Extract valid update fields from a request body. Returns an error string on validation failure. */
+export declare function buildThreadUpdates(body: Record<string, unknown>): Partial<Pick<ThreadRegistryEntry, "name" | "status" | "keepAlive" | "dailyRotation" | "autonomousMode" | "client" | "maxRetries" | "cooldownMs" | "badge" | "identityPrompt" | "telegramTopicId" | "workingDirectory">> | string;
+/**
+ * Enrich thread entries with topic names from topic_registry
+ * when the thread name is generic (e.g. "Thread 1234").
+ */
+export declare function enrichThreadNames(db: Database, threads: ThreadRegistryEntry[]): ThreadRegistryEntry[];
+export type ThreadEntryOut = ThreadRegistryEntry & {
+    mcpServers: ReturnType<typeof maskThreadMcpServers> | null;
+};
+/** Attach each thread's custom MCP servers (settings.json, not the DB), header values masked. */
+export declare function withThreadMcpServers(threads: ThreadRegistryEntry[]): ThreadEntryOut[];
+/**
+ * Coerce a PATCH `mcpServers` body into a validated server map (or null to clear).
+ * Shape-checks http-only transport and rejects the header mask sentinel so a
+ * round-tripped masked value can never be persisted. Returns an error string on
+ * malformed input; deeper rules (reserved names) are enforced by setThreadMcpServers.
+ */
+export declare function parseThreadMcpServersBody(raw: unknown): Record<string, ThreadMcpServer> | null | string;
+//# sourceMappingURL=threads-helpers.d.ts.map

package/dist/dashboard/routes/threads-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads-helpers.d.ts","sourceRoot":"","sources":["../../../src/dashboard/routes/threads-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAEL,oBAAoB,EAEpB,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAG/B,eAAO,MAAM,aAAa,yDAA0D,CAAC;AAErF,sGAAsG;AACtG,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAE3B,OAAO,CACL,IAAI,CACF,mBAAmB,EACjB,MAAM,GACN,QAAQ,GACR,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,QAAQ,GACR,YAAY,GACZ,YAAY,GACZ,OAAO,GACP,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,CACrB,CACF,GACD,MAAM,CAgET;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,mBAAmB,EAAE,GAC7B,mBAAmB,EAAE,CAwBvB;AAED,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG;IACjD,UAAU,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,GAAG,IAAI,CAAC;CAC5D,CAAC;AAEF,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,cAAc,EAAE,CAMrF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,GACX,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI,GAAG,MAAM,CA0BjD"}

package/dist/dashboard/routes/threads-helpers.js

@@ -0,0 +1,138 @@
+/**
+ * Dashboard API — shared helpers for the thread route handlers: update-body
+ * validation, thread-name enrichment, per-thread MCP server attachment/parsing.
+ */
+import { getAllThreadMcpServers, maskThreadMcpServers, MASK_SENTINEL, } from "../../config/index.js";
+const VALID_STATUSES = ["active", "archived", "expired", "exited"];
+export const VALID_CLIENTS = ["claude", "copilot", "codex", "openai_codex"];
+/** Extract valid update fields from a request body. Returns an error string on validation failure. */
+export function buildThreadUpdates(body) {
+    const updates = {};
+    if (typeof body.name === "string" && body.name.trim())
+        updates.name = body.name.trim();
+    if (typeof body.status === "string") {
+        if (!VALID_STATUSES.includes(body.status)) {
+            return `status must be one of: ${VALID_STATUSES.join(", ")}`;
+        }
+        updates.status = body.status;
+    }
+    if (typeof body.keepAlive === "boolean")
+        updates.keepAlive = body.keepAlive;
+    if (typeof body.dailyRotation === "boolean")
+        updates.dailyRotation = body.dailyRotation;
+    if (typeof body.autonomousMode === "boolean")
+        updates.autonomousMode = body.autonomousMode;
+    if (typeof body.client === "string") {
+        if (!VALID_CLIENTS.includes(body.client)) {
+            return `client must be one of: ${VALID_CLIENTS.join(", ")}`;
+        }
+        updates.client = body.client;
+    }
+    if (typeof body.maxRetries === "number") {
+        if (!Number.isFinite(body.maxRetries) ||
+            !Number.isInteger(body.maxRetries) ||
+            body.maxRetries < 0) {
+            return "maxRetries must be a non-negative integer";
+        }
+        updates.maxRetries = body.maxRetries;
+    }
+    if (typeof body.cooldownMs === "number") {
+        if (!Number.isFinite(body.cooldownMs) ||
+            !Number.isInteger(body.cooldownMs) ||
+            body.cooldownMs < 0) {
+            return "cooldownMs must be a non-negative integer";
+        }
+        updates.cooldownMs = body.cooldownMs;
+    }
+    if (typeof body.badge === "string")
+        updates.badge = body.badge;
+    if (typeof body.identityPrompt === "string")
+        updates.identityPrompt = body.identityPrompt;
+    if (body.identityPrompt === null)
+        updates.identityPrompt = null;
+    if (typeof body.telegramTopicId === "number" && Number.isFinite(body.telegramTopicId))
+        updates.telegramTopicId = body.telegramTopicId;
+    if (body.telegramTopicId === null)
+        updates.telegramTopicId = null;
+    if (typeof body.workingDirectory === "string" && body.workingDirectory.trim())
+        updates.workingDirectory = body.workingDirectory.trim();
+    if (body.workingDirectory === null)
+        updates.workingDirectory = null;
+    return updates;
+}
+/**
+ * Enrich thread entries with topic names from topic_registry
+ * when the thread name is generic (e.g. "Thread 1234").
+ */
+export function enrichThreadNames(db, threads) {
+    const genericPattern = /^Thread \d+$/i;
+    const needsEnrichment = threads.filter((t) => genericPattern.test(t.name));
+    if (needsEnrichment.length === 0)
+        return threads;
+    try {
+        const topicNames = new Map();
+        const rows = db.prepare(`SELECT thread_id, name FROM topic_registry`).all();
+        for (const r of rows)
+            topicNames.set(r.thread_id, r.name);
+        return threads.map((t) => {
+            if (!genericPattern.test(t.name))
+                return t;
+            // Check topic_registry by thread_id or telegramTopicId
+            const topicName = topicNames.get(t.telegramTopicId ?? t.threadId) ?? topicNames.get(t.threadId);
+            if (topicName)
+                return { ...t, name: topicName };
+            return t;
+        });
+    }
+    catch {
+        return threads; // topic_registry might not exist
+    }
+}
+/** Attach each thread's custom MCP servers (settings.json, not the DB), header values masked. */
+export function withThreadMcpServers(threads) {
+    const all = getAllThreadMcpServers();
+    return threads.map((t) => {
+        const s = all[String(t.threadId)];
+        return { ...t, mcpServers: s ? maskThreadMcpServers(s) : null };
+    });
+}
+/**
+ * Coerce a PATCH `mcpServers` body into a validated server map (or null to clear).
+ * Shape-checks http-only transport and rejects the header mask sentinel so a
+ * round-tripped masked value can never be persisted. Returns an error string on
+ * malformed input; deeper rules (reserved names) are enforced by setThreadMcpServers.
+ */
+export function parseThreadMcpServersBody(raw) {
+    if (raw === null || raw === undefined)
+        return null;
+    if (typeof raw !== "object" || Array.isArray(raw))
+        return "mcpServers must be an object or null";
+    const out = {};
+    for (const [name, val] of Object.entries(raw)) {
+        if (!val || typeof val !== "object" || Array.isArray(val))
+            return `mcpServers["${name}"] must be an object`;
+        const o = val;
+        if (o.type !== "http")
+            return `mcpServers["${name}"] must have type "http"`;
+        if (typeof o.url !== "string" || !o.url.trim())
+            return `mcpServers["${name}"] requires a url`;
+        const entry = { type: "http", url: o.url.trim() };
+        if (o.headers !== undefined && o.headers !== null) {
+            if (typeof o.headers !== "object" || Array.isArray(o.headers))
+                return `mcpServers["${name}"].headers must be an object`;
+            const headers = {};
+            for (const [k, v] of Object.entries(o.headers)) {
+                if (typeof v !== "string")
+                    return `mcpServers["${name}"].headers["${k}"] must be a string`;
+                if (v.includes(MASK_SENTINEL))
+                    return `mcpServers["${name}"].headers["${k}"] still masked — re-enter the value`;
+                headers[k] = v;
+            }
+            if (Object.keys(headers).length > 0)
+                entry.headers = headers;
+        }
+        out[name] = entry;
+    }
+    return out;
+}
+//# sourceMappingURL=threads-helpers.js.map

package/dist/dashboard/routes/threads-helpers.js.map

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

package/dist/dashboard/routes/threads-read.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Dashboard API — read-only thread route handlers: listing endpoints, single
+ * thread lookup, running/heartbeat probes, log digests, and children.
+ */
+import { type RouteHandler, type RouteArgs } from "./types.js";
+export declare const handleGetThreads: RouteHandler;
+export declare const handleGetRootThreads: RouteHandler;
+export declare const handleGetKeepAliveThreads: RouteHandler;
+export declare const handleGetArchivedThreads: RouteHandler;
+/** GET /api/threads/:threadId — get single thread */
+export declare function handleGetThread(args: RouteArgs, threadId: number): boolean;
+/** GET /api/threads/:threadId/running — check if an agent process is alive for this thread */
+export declare function handleGetThreadRunning(args: RouteArgs, threadId: number): boolean;
+/** GET /api/threads/:threadId/heartbeat — last MCP activity timestamp for stuck-process detection */
+export declare function handleGetThreadHeartbeat(args: RouteArgs, threadId: number): boolean;
+/**
+ * GET /api/threads/:threadId/logs — a readable digest of the agent's raw stdout.
+ *
+ * Parses the newest stream-json log file into tail-first turns, then returns a
+ * single character window (default 4000, Telegram-sized). Callers page deeper
+ * into history with ?offset=; nextOffset/hasMore drive a "next chunk" button.
+ */
+export declare function handleGetThreadLogs(args: RouteArgs, threadId: number): boolean;
+/** GET /api/threads/:threadId/children — get children of a root */
+export declare function handleGetThreadChildren(args: RouteArgs, rootThreadId: number): boolean;
+//# sourceMappingURL=threads-read.d.ts.map

package/dist/dashboard/routes/threads-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads-read.d.ts","sourceRoot":"","sources":["../../../src/dashboard/routes/threads-read.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAW/D,eAAO,MAAM,gBAAgB,EAAE,YAI9B,CAAC;AAIF,eAAO,MAAM,oBAAoB,EAAE,YAGlC,CAAC;AAIF,eAAO,MAAM,yBAAyB,EAAE,YAGvC,CAAC;AAIF,eAAO,MAAM,wBAAwB,EAAE,YAItC,CAAC;AAIF,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQ1E;AAED,8FAA8F;AAC9F,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIjF;AAED,qGAAqG;AACrG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAInF;AA0BD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA0B9E;AAED,mEAAmE;AACnE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAItF"}

package/dist/dashboard/routes/threads-read.js

@@ -0,0 +1,118 @@
+/**
+ * Dashboard API — read-only thread route handlers: listing endpoints, single
+ * thread lookup, running/heartbeat probes, log digests, and children.
+ */
+import { getThread, getRootThreads, getKeepAliveThreads, getArchivedThreads, getDashboardThreads, getThreadsByRoot, } from "../../data/memory/thread-registry.js";
+import { enrichThreadNames, withThreadMcpServers } from "./threads-helpers.js";
+import { errorMessage } from "../../lib/utils.js";
+import { isThreadRunning, THREAD_LOGS_DIR } from "../../services/process.service.js";
+import { readThreadHeartbeat } from "../../data/file-storage.js";
+import { parseClaudeStreamLog, renderThreadLog, sliceLogWindow } from "../log-parser.js";
+import { readdirSync, statSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+// ─── GET /api/threads — list all active threads grouped ─────────────────────
+export const handleGetThreads = ({ json, db }) => {
+    const threads = withThreadMcpServers(enrichThreadNames(db, getDashboardThreads(db)));
+    json({ threads });
+    return true;
+};
+// ─── GET /api/threads/roots — list root threads only ────────────────────────
+export const handleGetRootThreads = ({ json, db }) => {
+    json({ threads: withThreadMcpServers(enrichThreadNames(db, getRootThreads(db))) });
+    return true;
+};
+// ─── GET /api/threads/keepalive — list all threads with keepAlive=true (excl. workers) ─
+export const handleGetKeepAliveThreads = ({ json, db }) => {
+    json({ threads: withThreadMcpServers(enrichThreadNames(db, getKeepAliveThreads(db))) });
+    return true;
+};
+// ─── GET /api/threads/archived — list archived threads ──────────────────────
+export const handleGetArchivedThreads = ({ json, db }) => {
+    const threads = withThreadMcpServers(enrichThreadNames(db, getArchivedThreads(db)));
+    json({ threads });
+    return true;
+};
+// ─── Dynamic handlers (threadId extracted by caller) ────────────────────────
+/** GET /api/threads/:threadId — get single thread */
+export function handleGetThread(args, threadId) {
+    const thread = getThread(args.db, threadId);
+    if (thread) {
+        args.json(thread);
+    }
+    else {
+        args.json({ error: `Thread ${threadId} not found` }, 404);
+    }
+    return true;
+}
+/** GET /api/threads/:threadId/running — check if an agent process is alive for this thread */
+export function handleGetThreadRunning(args, threadId) {
+    const running = isThreadRunning(threadId);
+    args.json({ threadId, running });
+    return true;
+}
+/** GET /api/threads/:threadId/heartbeat — last MCP activity timestamp for stuck-process detection */
+export function handleGetThreadHeartbeat(args, threadId) {
+    const lastActivityMs = readThreadHeartbeat(threadId);
+    args.json({ threadId, lastActivityMs });
+    return true;
+}
+/** Locate the most-recently-modified log file for a thread, or null if none exist. */
+function findLatestThreadLogFile(threadId) {
+    let files;
+    try {
+        files = readdirSync(THREAD_LOGS_DIR);
+    }
+    catch {
+        return null;
+    }
+    const suffixRe = new RegExp(`_${threadId}_\\d{4}-\\d{2}-\\d{2}\\.jsonl?$`);
+    let best = null;
+    for (const file of files) {
+        if (!suffixRe.test(file))
+            continue;
+        const full = join(THREAD_LOGS_DIR, file);
+        try {
+            const mtimeMs = statSync(full).mtimeMs;
+            if (!best || mtimeMs > best.mtimeMs)
+                best = { path: full, mtimeMs };
+        }
+        catch {
+            /* file vanished between readdir and stat */
+        }
+    }
+    return best?.path ?? null;
+}
+/**
+ * GET /api/threads/:threadId/logs — a readable digest of the agent's raw stdout.
+ *
+ * Parses the newest stream-json log file into tail-first turns, then returns a
+ * single character window (default 4000, Telegram-sized). Callers page deeper
+ * into history with ?offset=; nextOffset/hasMore drive a "next chunk" button.
+ */
+export function handleGetThreadLogs(args, threadId) {
+    const { json, url } = args;
+    const logFile = findLatestThreadLogFile(threadId);
+    if (!logFile) {
+        json({ threadId, text: "", offset: 0, nextOffset: 0, hasMore: false, totalLength: 0 });
+        return true;
+    }
+    let raw;
+    try {
+        raw = readFileSync(logFile, "utf-8");
+    }
+    catch (err) {
+        json({ error: errorMessage(err) }, 500);
+        return true;
+    }
+    const rendered = renderThreadLog(parseClaudeStreamLog(raw), true);
+    const page = sliceLogWindow(rendered, Number(url.searchParams.get("offset")), Number(url.searchParams.get("limit")));
+    json({ threadId, ...page });
+    return true;
+}
+/** GET /api/threads/:threadId/children — get children of a root */
+export function handleGetThreadChildren(args, rootThreadId) {
+    const children = withThreadMcpServers(getThreadsByRoot(args.db, rootThreadId));
+    args.json({ threads: children });
+    return true;
+}
+//# sourceMappingURL=threads-read.js.map

package/dist/dashboard/routes/threads-read.js.map

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

package/dist/dashboard/routes/threads.d.ts

@@ -1,46 +1,12 @@
 /**
- * Dashboard API — thread registry route handlers.
- * Covers: listing, creating, updating, archiving, and deleting threads.
+ * Dashboard API — thread lifecycle route handlers: unarchive, summary
+ * generation, update, delete/archive, start, and branch→root conversion.
+ * Read handlers live in threads-read.ts, creation in threads-create.ts,
+ * shared validation/enrichment in threads-helpers.ts.
  */
-import type { Database } from "../../data/memory/schema.js";
-import { type RouteHandler, type RouteArgs } from "./types.js";
-export declare const handleGetThreads: RouteHandler;
-export declare const handleGetRootThreads: RouteHandler;
-export declare const handleGetKeepAliveThreads: RouteHandler;
-export declare const handleGetArchivedThreads: RouteHandler;
+import { type RouteArgs } from "./types.js";
 export declare function handleUnarchiveThread(args: RouteArgs, threadId: number): boolean;
 export declare function handleGenerateSummary(args: RouteArgs, threadId: number): boolean;
-export declare const handleCreateThread: RouteHandler;
-/**
- * Create a brand-new root thread: opens a Telegram forum topic and registers
- * the thread. Unlike POST /api/threads (which only registers a caller-supplied
- * topic id), this owns topic creation so callers without Telegram access (e.g.
- * the supervisor) can spin up threads. keepAlive + dailyRotation default on for
- * root threads via registerThread.
- */
-export declare const handleCreateRoot: RouteHandler;
-/**
- * Create a branch thread under an existing root: opens a Telegram forum topic
- * and registers it with type=branch. Working directory and agent type are
- * inherited from the parent root unless overridden.
- */
-export declare const handleCreateBranch: RouteHandler;
-/** GET /api/threads/:threadId — get single thread */
-export declare function handleGetThread(args: RouteArgs, threadId: number): boolean;
-/** GET /api/threads/:threadId/running — check if an agent process is alive for this thread */
-export declare function handleGetThreadRunning(args: RouteArgs, threadId: number): boolean;
-/** GET /api/threads/:threadId/heartbeat — last MCP activity timestamp for stuck-process detection */
-export declare function handleGetThreadHeartbeat(args: RouteArgs, threadId: number): boolean;
-/**
- * GET /api/threads/:threadId/logs — a readable digest of the agent's raw stdout.
- *
- * Parses the newest stream-json log file into tail-first turns, then returns a
- * single character window (default 4000, Telegram-sized). Callers page deeper
- * into history with ?offset=; nextOffset/hasMore drive a "next chunk" button.
- */
-export declare function handleGetThreadLogs(args: RouteArgs, threadId: number): boolean;
-/** GET /api/threads/:threadId/children — get children of a root */
-export declare function handleGetThreadChildren(args: RouteArgs, rootThreadId: number): boolean;
 /** PATCH /api/threads/:threadId — update a thread */
 export declare function handleUpdateThread(args: RouteArgs, threadId: number): boolean;
 /** DELETE /api/threads/:threadId — archive or delete a thread */
@@ -49,9 +15,4 @@ export declare function handleDeleteThread(args: RouteArgs, threadId: number): b
 export declare function handleStartThread(args: RouteArgs, threadId: number): boolean;
 /** POST /api/threads/:threadId/convert-to-root — convert a branch thread to a root thread */
 export declare function handleConvertToRoot(args: RouteArgs, threadId: number): boolean;
-/**
- * Sync thread_registry keepAlive settings to settings.json for watcher backward compatibility.
- * The watcher's readKeeperSettingsFromFile() reads settings.json during startup before the MCP server is ready.
- */
-export declare function syncKeepAliveToSettings(db: Database): void;
 //# sourceMappingURL=threads.d.ts.map