sensorium-mcp 3.0.102 → 3.1.0-refactor.0

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

@@ -1 +1 @@
-{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/dashboard/routes/threads.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAuB5D,OAAO,EAA2B,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAoIxF,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,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA0ChF;AAID,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA2ChF;AAID,eAAO,MAAM,kBAAkB,EAAE,YAmEhC,CAAC;AAIF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAuC9B,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAwDhC,CAAC;AAcF,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;AAqBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAkB9E;AAED,mEAAmE;AACnE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAItF;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAyD7E;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAyC7E;AAYD,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA8B5E;AAID,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA6B9E;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CA+B1D"}
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/dashboard/routes/threads.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAmBrE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA4ChF;AAID,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiEhF;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAqE7E;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA0C7E;AAcD,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuC5E;AAID,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA+C9E"}

package/dist/dashboard/routes/threads.js

@@ -1,172 +1,20 @@
 /**
- * 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 { registerThread, getThread, getRootThreads, getKeepAliveThreads, getActiveThreads, getArchivedThreads, getDashboardThreads, getThreadsByRoot, updateThread, archiveThread, unarchiveThread, deleteThread, getExplicitTelegramTopicId, resolveTelegramTopicId, } from "../../data/memory/thread-registry.js";
-import { forkMemory } from "../../data/memory/synthesis.js";
-import { config, getAgentType, setKeepAliveEnabled, setKeepAliveThreadId, setKeepAliveClient, setKeepAliveMaxRetries, setKeepAliveCooldownMs, setThreadKeepAlive, removeThreadKeepAlive, isValidKeeperClient, setThreadMcpServers, deleteThreadMcpServers, getAllThreadMcpServers, maskThreadMcpServers, MASK_SENTINEL, } from "../../config.js";
+import { getThread, getThreadsByRoot, updateThread, archiveThread, unarchiveThread, deleteThread, getExplicitTelegramTopicId, resolveTelegramTopicId, } from "../../data/memory/thread-registry.js";
+import { config, setThreadMcpServers, deleteThreadMcpServers, } from "../../config/index.js";
 import { readBody, safeParseJSON } from "./types.js";
-import { errorMessage } from "../../utils.js";
-import { log } from "../../logger.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";
-import { createManagedTopic, deleteTelegramTopicByBotApi, remapThreadToNewTopic } from "../../services/topic.service.js";
+import { buildThreadUpdates, parseThreadMcpServersBody, withThreadMcpServers, } 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 { isThreadRunning } from "../../services/process.service.js";
+import { deleteTelegramTopicByBotApi, remapThreadToNewTopic, } from "../../services/topic.service.js";
 import { dispatchSpawn } from "../../services/agent-spawn.service.js";
-import { TelegramClient } from "../../telegram.js";
-// ─── Helpers ────────────────────────────────────────────────────────────────
-const VALID_STATUSES = ["active", "archived", "expired", "exited"];
-const VALID_CLIENTS = ["claude", "copilot", "codex", "openai_codex"];
-/** Extract valid update fields from a request body. Returns an error string on validation failure. */
-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").
- */
-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. */
-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.
- */
-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;
-}
-// ─── 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;
-};
+import { TelegramClient } from "../../services/telegram.js";
 // ─── POST /api/threads/:threadId/unarchive — restore an archived thread ────
 export function handleUnarchiveThread(args, threadId) {
     const { json, db, ctx } = args;
@@ -226,17 +74,31 @@ export function handleGenerateSummary(args, threadId) {
                 return;
             }
             // Gather recent episodes for context
-            const episodes = db.prepare(`SELECT content, type, modality, timestamp FROM episodes
-                 WHERE thread_id = ? ORDER BY timestamp DESC LIMIT 30`).all(threadId);
+            const episodes = db
+                .prepare(`SELECT content, type, modality, timestamp FROM episodes
+                 WHERE thread_id = ? ORDER BY timestamp DESC LIMIT 30`)
+                .all(threadId);
             if (episodes.length === 0) {
-                json({ ok: true, summary: `Thread "${thread.name}" (${thread.type}) — no episodes recorded.` });
+                json({
+                    ok: true,
+                    summary: `Thread "${thread.name}" (${thread.type}) — no episodes recorded.`,
+                });
                 return;
             }
-            const episodeText = episodes.reverse().map(e => `[${e.timestamp}] (${e.type}) ${e.content.slice(0, 200)}`).join("\n");
+            const episodeText = episodes
+                .reverse()
+                .map((e) => `[${e.timestamp}] (${e.type}) ${e.content.slice(0, 200)}`)
+                .join("\n");
             const { chatCompletion } = await import("../../integrations/openai/chat.js");
             const summary = await chatCompletion([
-                { role: "system", content: "You are a concise summarizer. Given a thread's conversation episodes, produce a 1-2 sentence summary of what was discussed/accomplished. Be specific about the topic and outcome. No filler." },
-                { role: "user", content: `Thread: "${thread.name}" (type: ${thread.type})\n\nEpisodes:\n${episodeText}` },
+                {
+                    role: "system",
+                    content: "You are a concise summarizer. Given a thread's conversation episodes, produce a 1-2 sentence summary of what was discussed/accomplished. Be specific about the topic and outcome. No filler.",
+                },
+                {
+                    role: "user",
+                    content: `Thread: "${thread.name}" (type: ${thread.type})\n\nEpisodes:\n${episodeText}`,
+                },
             ], apiKey, { maxTokens: 150, temperature: 0.3 });
             const trimmed = summary.trim();
             if (!trimmed) {
@@ -251,290 +113,6 @@ export function handleGenerateSummary(args, threadId) {
     })();
     return true;
 }
-// ─── 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;
-}
-// ─── 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;
-}
 /** PATCH /api/threads/:threadId — update a thread */
 export function handleUpdateThread(args, threadId) {
     const { req, json, db } = args;
@@ -587,7 +165,10 @@ export function handleUpdateThread(args, threadId) {
             }
             json(withThreadMcpServers([getThread(db, threadId)])[0]);
             // Sync keepAlive to settings.json for watcher backward compatibility
-            if ("keepAlive" in updates || "client" in updates || "maxRetries" in updates || "cooldownMs" in updates) {
+            if ("keepAlive" in updates ||
+                "client" in updates ||
+                "maxRetries" in updates ||
+                "cooldownMs" in updates) {
                 syncKeepAliveToSettings(db);
             }
         }
@@ -642,7 +223,9 @@ function deleteTelegramTopic(topicId) {
     const { TELEGRAM_TOKEN, TELEGRAM_CHAT_ID } = config;
     if (!TELEGRAM_TOKEN || !TELEGRAM_CHAT_ID)
         return;
-    void deleteTelegramTopicByBotApi(TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, topicId).catch(() => { });
+    void deleteTelegramTopicByBotApi(TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, topicId).catch(() => {
+        /* topic might not exist or already deleted */
+    });
 }
 // ─── POST /api/threads/:threadId/start — manually start a thread ────────────
 /** POST /api/threads/:threadId/start — spawn a thread process from the dashboard */
@@ -718,43 +301,4 @@ export function handleConvertToRoot(args, threadId) {
     })();
     return true;
 }
-// ─── Settings.json sync for watcher backward compatibility ──────────────────
-/**
- * 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 function syncKeepAliveToSettings(db) {
-    try {
-        const allThreads = getActiveThreads(db);
-        const activeKeepAlive = allThreads.find(r => r.keepAlive);
-        if (activeKeepAlive) {
-            setKeepAliveEnabled(true);
-            setKeepAliveThreadId(activeKeepAlive.threadId);
-            if (isValidKeeperClient(activeKeepAlive.client))
-                setKeepAliveClient(activeKeepAlive.client);
-            setKeepAliveMaxRetries(activeKeepAlive.maxRetries);
-            setKeepAliveCooldownMs(activeKeepAlive.cooldownMs);
-        }
-        else {
-            setKeepAliveEnabled(false);
-        }
-        // Sync per-thread overrides
-        for (const t of allThreads) {
-            if (t.keepAlive) {
-                setThreadKeepAlive(t.threadId, {
-                    enabled: true,
-                    client: t.client,
-                    maxRetries: t.maxRetries,
-                    cooldownMs: t.cooldownMs,
-                });
-            }
-            else {
-                removeThreadKeepAlive(t.threadId);
-            }
-        }
-    }
-    catch (err) {
-        log.warn(`[threads] Keep-alive sync failed: ${errorMessage(err)}`);
-    }
-}
 //# sourceMappingURL=threads.js.map