sensorium-mcp 3.0.75 → 3.0.77

package/dist/dashboard/log-parser.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Parser for Claude CLI stream-json thread logs (newline-delimited JSON).
+ *
+ * The agent's stdout is captured as one JSON event per line. This turns that
+ * raw event stream into readable, condensed "turns" for display over Telegram.
+ * A turn is one assistant message (its text + any tool calls) together with the
+ * tool results that immediately follow it.
+ *
+ * Assistant text is shown in full; tool inputs and tool results are previewed
+ * (collapsed to a single line and capped) because they are machine output, not
+ * the agent's reasoning, and would otherwise drown the useful signal.
+ */
+export interface LogTurn {
+    /** Rendered lines for this turn, in display order. */
+    lines: string[];
+}
+export declare const DEFAULT_PREVIEW_CHARS = 300;
+/**
+ * Parse a raw stream-json log into chronological turns. Malformed lines and
+ * noise events (system, rate_limit_event) are skipped.
+ */
+export declare function parseClaudeStreamLog(raw: string, previewChars?: number): LogTurn[];
+/**
+ * Render turns to a single string. With tailFirst (default) the most recent
+ * turn appears first, so a reader paging from the top sees latest activity.
+ */
+export declare function renderThreadLog(turns: LogTurn[], tailFirst?: boolean): string;
+/** Default character window per page — matches Telegram's ~4096-char message cap. */
+export declare const DEFAULT_LOG_PAGE_CHARS = 4000;
+export interface LogPage {
+    /** The character window for this page. */
+    text: string;
+    /** Start index of this page within the rendered log. */
+    offset: number;
+    /** Start index of the next page (feeds a "next chunk" button). */
+    nextOffset: number;
+    /** Whether more text remains after this page. */
+    hasMore: boolean;
+    /** Total length of the rendered log. */
+    totalLength: number;
+}
+/**
+ * Extract a single character window from a rendered log for paginated display.
+ *
+ * The digest uses astral emoji markers (🤖🔧✅…), so a naive .slice() could cut
+ * between the two UTF-16 code units of a surrogate pair and emit a lone
+ * surrogate that renders as �. When the window would end mid-pair we snap the
+ * end back one unit; that code unit becomes the start of the next page.
+ */
+export declare function sliceLogWindow(rendered: string, offsetRaw: number, limitRaw: number): LogPage;
+//# sourceMappingURL=log-parser.d.ts.map

package/dist/dashboard/log-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-parser.d.ts","sourceRoot":"","sources":["../../src/dashboard/log-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,MAAM,WAAW,OAAO;IACpB,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,qBAAqB,MAAM,CAAC;AA+BzC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,MAA8B,GAAG,OAAO,EAAE,CAoCzG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,SAAS,GAAE,OAAc,GAAG,MAAM,CAGnF;AAED,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,MAAM,WAAW,OAAO;IACpB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;CACvB;AAcD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAY7F"}

package/dist/dashboard/log-parser.js

@@ -0,0 +1,140 @@
+/**
+ * Parser for Claude CLI stream-json thread logs (newline-delimited JSON).
+ *
+ * The agent's stdout is captured as one JSON event per line. This turns that
+ * raw event stream into readable, condensed "turns" for display over Telegram.
+ * A turn is one assistant message (its text + any tool calls) together with the
+ * tool results that immediately follow it.
+ *
+ * Assistant text is shown in full; tool inputs and tool results are previewed
+ * (collapsed to a single line and capped) because they are machine output, not
+ * the agent's reasoning, and would otherwise drown the useful signal.
+ */
+export const DEFAULT_PREVIEW_CHARS = 300;
+/** Collapse whitespace and cap length, appending an ellipsis when truncated. */
+function preview(s, max) {
+    const oneLine = s.replace(/\s+/g, " ").trim();
+    return oneLine.length > max ? oneLine.slice(0, max) + "…" : oneLine;
+}
+function compactArgs(input, max) {
+    let s;
+    try {
+        s = typeof input === "string" ? input : JSON.stringify(input ?? {});
+    }
+    catch {
+        s = String(input);
+    }
+    return preview(s, max);
+}
+/** Extract readable text from a tool_result's content (string, or array of text blocks). */
+function resultText(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((c) => {
+            if (c && typeof c === "object" && typeof c.text === "string") {
+                return c.text;
+            }
+            return JSON.stringify(c);
+        })
+            .join(" ");
+    }
+    return JSON.stringify(content ?? "");
+}
+/**
+ * Parse a raw stream-json log into chronological turns. Malformed lines and
+ * noise events (system, rate_limit_event) are skipped.
+ */
+export function parseClaudeStreamLog(raw, previewChars = DEFAULT_PREVIEW_CHARS) {
+    const turns = [];
+    let current = null;
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let ev;
+        try {
+            ev = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        if (ev.type === "assistant" && ev.message?.content) {
+            current = { lines: [] };
+            turns.push(current);
+            for (const c of ev.message.content) {
+                if (c.type === "text" && typeof c.text === "string") {
+                    const t = c.text.trim();
+                    if (t)
+                        current.lines.push(`🤖 ${t}`);
+                }
+                else if (c.type === "tool_use") {
+                    const name = typeof c.name === "string" ? c.name : "tool";
+                    current.lines.push(`🔧 ${name}(${compactArgs(c.input, previewChars)})`);
+                }
+            }
+        }
+        else if (ev.type === "user" && ev.message?.content) {
+            for (const c of ev.message.content) {
+                if (c.type !== "tool_result")
+                    continue;
+                if (!current) {
+                    current = { lines: [] };
+                    turns.push(current);
+                }
+                const marker = c.is_error ? "⚠️" : "↳";
+                current.lines.push(`   ${marker} ${preview(resultText(c.content), previewChars)}`);
+            }
+        }
+        else if (ev.type === "result") {
+            const marker = ev.is_error ? "❌" : "✅";
+            turns.push({ lines: [`${marker} ${preview(typeof ev.result === "string" ? ev.result : "", previewChars)}`] });
+            current = null;
+        }
+    }
+    return turns;
+}
+/**
+ * Render turns to a single string. With tailFirst (default) the most recent
+ * turn appears first, so a reader paging from the top sees latest activity.
+ */
+export function renderThreadLog(turns, tailFirst = true) {
+    const ordered = tailFirst ? [...turns].reverse() : turns;
+    return ordered.map((t) => t.lines.join("\n")).join("\n\n");
+}
+/** Default character window per page — matches Telegram's ~4096-char message cap. */
+export const DEFAULT_LOG_PAGE_CHARS = 4000;
+/** Clamp an offset to [0, max]; non-finite or non-positive values become 0. */
+function clampOffset(n, max) {
+    if (!Number.isFinite(n) || n <= 0)
+        return 0;
+    return Math.min(Math.floor(n), max);
+}
+/** Clamp a page size to (0, DEFAULT_LOG_PAGE_CHARS]; invalid values default to the cap. */
+function clampLimit(n) {
+    if (!Number.isFinite(n) || n <= 0)
+        return DEFAULT_LOG_PAGE_CHARS;
+    return Math.min(Math.floor(n), DEFAULT_LOG_PAGE_CHARS);
+}
+/**
+ * Extract a single character window from a rendered log for paginated display.
+ *
+ * The digest uses astral emoji markers (🤖🔧✅…), so a naive .slice() could cut
+ * between the two UTF-16 code units of a surrogate pair and emit a lone
+ * surrogate that renders as �. When the window would end mid-pair we snap the
+ * end back one unit; that code unit becomes the start of the next page.
+ */
+export function sliceLogWindow(rendered, offsetRaw, limitRaw) {
+    const totalLength = rendered.length;
+    const offset = clampOffset(offsetRaw, totalLength);
+    const limit = clampLimit(limitRaw);
+    let end = Math.min(offset + limit, totalLength);
+    if (end < totalLength && end - 1 > offset) {
+        const lastCode = rendered.charCodeAt(end - 1);
+        if (lastCode >= 0xd800 && lastCode <= 0xdbff)
+            end -= 1;
+    }
+    return { text: rendered.slice(offset, end), offset, nextOffset: end, hasMore: end < totalLength, totalLength };
+}
+//# sourceMappingURL=log-parser.js.map

package/dist/dashboard/log-parser.js.map

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

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

@@ -9,9 +9,12 @@ import { type RouteHandler } from "./types.js";
 export declare const handleGetCopilot: RouteHandler;
 export declare const handlePostCopilot: RouteHandler;
 /**
- * Verify the BYOK connection by listing models from the configured provider's
- * OpenAI-compatible `{baseUrl}/models` endpoint using the stored API key.
- * Returns model ids on success, a descriptive error otherwise.
+ * Verify the BYOK connection by listing models from the provider, using the
+ * values POSTed from the form (baseUrl, providerType, apiKey) so the user can
+ * test BEFORE saving. Any field omitted or blank falls back to the stored
+ * config — an empty apiKey keeps the previously saved key so it isn't echoed to
+ * the browser. Request shape and headers are provider-aware (openai/azure/
+ * anthropic). Returns model ids on success, a descriptive error otherwise.
  */
-export declare const handleGetCopilotModels: RouteHandler;
+export declare const handlePostCopilotModels: RouteHandler;
 //# sourceMappingURL=copilot.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../../src/dashboard/routes/copilot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAuBxE,eAAO,MAAM,gBAAgB,EAAE,YAG9B,CAAC;AAIF,eAAO,MAAM,iBAAiB,EAAE,YAiF/B,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAgCpC,CAAC"}
+{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../../src/dashboard/routes/copilot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAkDxE,eAAO,MAAM,gBAAgB,EAAE,YAG9B,CAAC;AAIF,eAAO,MAAM,iBAAiB,EAAE,YAiF/B,CAAC;AAIF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,YA2CrC,CAAC"}

package/dist/dashboard/routes/copilot.js

@@ -9,6 +9,28 @@ import { getCopilotModel, setCopilotModel, getCopilotByokConfig, setCopilotByokC
 import { readBody, safeParseJSON } from "./types.js";
 import { errorMessage } from "../../utils.js";
 const MODELS_FETCH_TIMEOUT_MS = 10_000;
+/**
+ * Build the provider-specific "list models" request. Each provider type speaks a
+ * different wire protocol, so the models endpoint path and auth header differ:
+ *   - openai:    GET {base}/models          Authorization: Bearer <key>
+ *   - anthropic: GET {base}/v1/models       x-api-key + anthropic-version
+ *   - azure:     GET {base}/models?api-version=…   api-key: <key>
+ * All three return an OpenAI-style { data: [{ id }] } body.
+ */
+function buildModelsRequest(providerType, baseUrl, apiKey) {
+    const base = baseUrl.replace(/\/+$/, "");
+    switch (providerType) {
+        case "anthropic": {
+            const url = /\/v1$/.test(base) ? `${base}/models` : `${base}/v1/models`;
+            return { url, headers: { "x-api-key": apiKey, "anthropic-version": "2023-06-01" } };
+        }
+        case "azure":
+            return { url: `${base}/models?api-version=2024-10-21`, headers: { "api-key": apiKey } };
+        case "openai":
+        default:
+            return { url: `${base}/models`, headers: { Authorization: `Bearer ${apiKey}` } };
+    }
+}
 /** Public (key-masked) view of the Copilot settings for the dashboard. */
 function publicCopilotSettings() {
     const byok = getCopilotByokConfig();
@@ -109,27 +131,39 @@ export const handlePostCopilot = ({ req, json }) => {
     })();
     return true;
 };
-// ─── GET /api/settings/copilot/models ───────────────────────────────────────
+// ─── POST /api/settings/copilot/models ──────────────────────────────────────
 /**
- * Verify the BYOK connection by listing models from the configured provider's
- * OpenAI-compatible `{baseUrl}/models` endpoint using the stored API key.
- * Returns model ids on success, a descriptive error otherwise.
+ * Verify the BYOK connection by listing models from the provider, using the
+ * values POSTed from the form (baseUrl, providerType, apiKey) so the user can
+ * test BEFORE saving. Any field omitted or blank falls back to the stored
+ * config — an empty apiKey keeps the previously saved key so it isn't echoed to
+ * the browser. Request shape and headers are provider-aware (openai/azure/
+ * anthropic). Returns model ids on success, a descriptive error otherwise.
  */
-export const handleGetCopilotModels = ({ json }) => {
+export const handlePostCopilotModels = ({ req, json }) => {
     void (async () => {
-        const byok = getCopilotByokConfig();
-        if (!byok.baseUrl || !byok.apiKey) {
-            json({ ok: false, error: "Set a provider baseUrl and API key first" }, 400);
+        const stored = getCopilotByokConfig();
+        let body = {};
+        try {
+            const raw = await readBody(req);
+            const parsed = raw ? safeParseJSON(raw) : null;
+            if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+                body = parsed;
+            }
+        }
+        catch { /* no/invalid body — fall back entirely to stored config */ }
+        const baseUrl = (typeof body.baseUrl === "string" && body.baseUrl.trim() ? body.baseUrl.trim() : stored.baseUrl);
+        const apiKey = (typeof body.apiKey === "string" && body.apiKey.length > 0 ? body.apiKey : stored.apiKey);
+        const providerType = isValidCopilotProviderType(body.providerType) ? body.providerType : stored.providerType;
+        if (!baseUrl || !apiKey) {
+            json({ ok: false, error: "Enter a base URL and API key first (or save them)." }, 400);
             return;
         }
-        const url = `${byok.baseUrl.replace(/\/+$/, "")}/models`;
+        const { url, headers } = buildModelsRequest(providerType, baseUrl, apiKey);
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), MODELS_FETCH_TIMEOUT_MS);
         try {
-            const resp = await fetch(url, {
-                headers: { Authorization: `Bearer ${byok.apiKey}` },
-                signal: controller.signal,
-            });
+            const resp = await fetch(url, { headers, signal: controller.signal });
             if (!resp.ok) {
                 json({ ok: false, error: `Provider returned HTTP ${resp.status} ${resp.statusText}` }, 502);
                 return;

package/dist/dashboard/routes/copilot.js.map

@@ -1 +1 @@
-{"version":3,"file":"copilot.js","sourceRoot":"","sources":["../../../src/dashboard/routes/copilot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACH,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,GAE7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAqB,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC,0EAA0E;AAC1E,SAAS,qBAAqB;IAC1B,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;IACpC,OAAO;QACH,KAAK,EAAE,eAAe,EAAE;QACxB,IAAI,EAAE;YACF,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;SACpC;KACJ,CAAC;AACN,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAAiB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;IACvD,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC9B,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAiB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;IAC7D,KAAK,CAAC,KAAK,IAAI,EAAE;QACb,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3D,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,GAAG,CAAC,CAAC;gBAC7C,OAAO;YACX,CAAC;YACD,MAAM,CAAC,GAAG,IAA+B,CAAC;YAE1C,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;gBACf,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;oBACjD,IAAI,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,EAAE,GAAG,CAAC,CAAC;oBACzD,OAAO;gBACX,CAAC;gBACD,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACpC,CAAC;YAED,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBACd,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oBACjE,IAAI,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,EAAE,GAAG,CAAC,CAAC;oBAC/C,OAAO;gBACX,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,CAAC,IAA+B,CAAC;gBAC5C,MAAM,KAAK,GAA+B,EAAE,CAAC;gBAE7C,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;oBACjB,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;wBACjC,IAAI,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,EAAE,GAAG,CAAC,CAAC;wBACvD,OAAO;oBACX,CAAC;oBACD,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;gBAC9B,CAAC;gBACD,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;oBACtB,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;wBAC9C,IAAI,CAAC,EAAE,KAAK,EAAE,6DAA6D,EAAE,EAAE,GAAG,CAAC,CAAC;wBACpF,OAAO;oBACX,CAAC;oBACD,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;gBACxC,CAAC;gBACD,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;oBACjB,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;wBAChC,IAAI,CAAC,EAAE,KAAK,EAAE,+BAA+B,EAAE,EAAE,GAAG,CAAC,CAAC;wBACtD,OAAO;oBACX,CAAC;oBACD,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACrC,CAAC;gBACD,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;oBACjB,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;wBAChC,IAAI,CAAC,EAAE,KAAK,EAAE,+BAA+B,EAAE,EAAE,GAAG,CAAC,CAAC;wBACtD,OAAO;oBACX,CAAC;oBACD,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACrC,CAAC;gBACD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;oBACnB,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;wBAClC,IAAI,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,EAAE,GAAG,CAAC,CAAC;wBACxD,OAAO;oBACX,CAAC;oBACD,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBACzC,CAAC;gBACD,gEAAgE;gBAChE,2DAA2D;gBAC3D,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;oBAChB,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;wBAC/B,IAAI,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,EAAE,GAAG,CAAC,CAAC;wBACrD,OAAO;oBACX,CAAC;oBACD,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;wBAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;gBACrD,CAAC;gBAED,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;YAED,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,qBAAqB,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC;IACL,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;IAC7D,KAAK,CAAC,KAAK,IAAI,EAAE;QACb,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,0CAA0C,EAAE,EAAE,GAAG,CAAC,CAAC;YAC5E,OAAO;QACX,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC;QACzD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,uBAAuB,CAAC,CAAC;QAC5E,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC1B,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE;gBACnD,MAAM,EAAE,UAAU,CAAC,MAAM;aAC5B,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACX,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;gBAC5F,OAAO;YACX,CAAC;YACD,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAuC,CAAC;YAC1E,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;gBACtC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC;gBACpF,CAAC,CAAC,EAAE,CAAC;YACT,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YACnF,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3E,CAAC;gBAAS,CAAC;YACP,YAAY,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACL,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"copilot.js","sourceRoot":"","sources":["../../../src/dashboard/routes/copilot.ts"],"names":[],"mappings":"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"}

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

@@ -10,12 +10,34 @@ export declare const handleGetArchivedThreads: RouteHandler;
 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 */

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;AAkCH,OAAO,EAA2B,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAsFxF,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,CAchF;AAID,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA2ChF;AAID,eAAO,MAAM,kBAAkB,EAAE,YAmEhC,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;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,CAwC7E;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAsC7E;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"}
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/dashboard/routes/threads.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmCH,OAAO,EAA2B,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AA0FxF,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,CAchF;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,YAiDhC,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,CAwC7E;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAsC7E;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"}

package/dist/dashboard/routes/threads.js

@@ -3,14 +3,18 @@
  * Covers: listing, creating, updating, archiving, and deleting threads.
  */
 import { registerThread, getThread, getRootThreads, getKeepAliveThreads, getActiveThreads, getArchivedThreads, getDashboardThreads, getThreadsByRoot, updateThread, archiveThread, unarchiveThread, deleteThread, getExplicitTelegramTopicId, resolveTelegramTopicId, } from "../../data/memory/thread-registry.js";
-import { config, setKeepAliveEnabled, setKeepAliveThreadId, setKeepAliveClient, setKeepAliveMaxRetries, setKeepAliveCooldownMs, setThreadKeepAlive, removeThreadKeepAlive, isValidKeeperClient, } from "../../config.js";
+import { config, getAgentType, setKeepAliveEnabled, setKeepAliveThreadId, setKeepAliveClient, setKeepAliveMaxRetries, setKeepAliveCooldownMs, setThreadKeepAlive, removeThreadKeepAlive, isValidKeeperClient, } from "../../config.js";
 import { readBody, safeParseJSON } from "./types.js";
 import { errorMessage } from "../../utils.js";
 import { log } from "../../logger.js";
-import { isThreadRunning } from "../../services/process.service.js";
+import { isThreadRunning, THREAD_LOGS_DIR } from "../../services/process.service.js";
 import { readThreadHeartbeat } from "../../data/file-storage.js";
-import { deleteTelegramTopicByBotApi } from "../../services/topic.service.js";
+import { parseClaudeStreamLog, renderThreadLog, sliceLogWindow } from "../log-parser.js";
+import { readdirSync, statSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { createManagedTopic, deleteTelegramTopicByBotApi } 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"];
@@ -233,6 +237,141 @@ export const handleCreateThread = ({ req, json, db }) => {
     })();
     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,
+            });
+            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) {
@@ -257,6 +396,57 @@ export function handleGetThreadHeartbeat(args, 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 = getThreadsByRoot(args.db, rootThreadId);