@ai-setting/roy-plugin-task-show 2.4.2 → 2.5.1

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EACL,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACf,MAAM,uBAAuB,CAAC;AAkB/B,OAAO,EACL,gBAAgB,EAEjB,MAAM,yBAAyB,CAAC;AAcjC,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,wEAAwE;IACxE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,6EAA6E;AAC7E,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,0EAA0E;AAC1E,eAAO,MAAM,YAAY,OAAO,CAAC;AAIjC,4DAA4D;AAC5D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B,CAAC;AAEF,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,aAAa,EAAE,OAAO,CAAC;CACxB;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkI7B;AAkCD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuF;IAC9G;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmB;IACjD,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD;6EACyE;IACzE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;gBAE5C,IAAI,EAAE;QAChB,GAAG,EAAE,cAAc,CAAC;QACpB,SAAS,EAAE,iBAAiB,CAAC;QAC7B,0EAA0E;QAC1E,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,yEAAyE;QACzE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE;YAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;YAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;YAAC,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,CAAC;QAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,6FAA6F;QAC7F,eAAe,CAAC,EAAE,eAAe,CAAC;QAClC,kFAAkF;QAClF,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,gFAAgF;QAChF,YAAY,CAAC,EAAE,gBAAgB,CAAC;QAChC,uEAAuE;QACvE,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;;;;WAMG;QACH,WAAW,CAAC,EAAE;YACZ,OAAO,EAAE,MAAM,CAAC;YAChB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;YAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;KACH;IAwBD;;OAEG;IACH,WAAW,IAAI,QAAQ;IAIvB;;;;;;OAMG;IACH,YAAY,IAAI,iBAAiB;IAIjC;;;;;;;;;OASG;IACH,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IA8D5B;;;OAGG;IACH,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAW7D;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YA4BP,MAAM;IAsKpB;;;;;OAKG;IACH;;;;;;;;;;;OAWG;IAUH;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAqBvB;;;;;OAKG;YACW,iBAAiB;IA+E/B,2DAA2D;IAC3D,OAAO,CAAC,eAAe;IASvB;;;;;;;;;;;;;;OAcG;YACW,qBAAqB;IAgGnC;;;;;;OAMG;YACW,sBAAsB;IAyFpC,OAAO,CAAC,iBAAiB;IA+DzB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,SAAS;IA4BjB;;;;OAIG;YAEW,SAAS;IA2BvB;;;;OAIG;YACW,gBAAgB;IAqE9B;;;;;;;;;;;;OAYG;YACW,eAAe;IAoE7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,QAAQ;IAOhB;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY;CAmBrB;AAmOD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAkL3D"}

package/dist/server.js

@@ -36,6 +36,9 @@ import { TracedAs } from "./tracing/decorator.js";
 import { buildSessionFileTree, } from "./file-tree.js";
 import { renderToolCallDetail, } from "./tool-call-detail.js";
 import { renderSessionForestPage, } from "./task-session-store.js";
+import { ChatProcessManager } from "./chat-process-manager.js";
+import { renderChatPanel } from "./chat-panel-html.js";
+import { TaskChatContextBuilder } from "./task-chat-context-builder.js";
 /** Upper bound of the TCP user port range. Probing never wraps past this. */
 export const MAX_TCP_PORT = 65535;
 /** Smallest legal TCP user port (avoid binding to well-known 0..1023). */
@@ -177,6 +180,29 @@ function getDirname(metaUrl) {
         return path.dirname(fileURLToPath(metaUrl));
     return typeof __dirname !== "undefined" ? __dirname : process.cwd();
 }
+/**
+ * Read the request body and parse it as JSON. Returns an empty object
+ * when the body is empty or non-JSON. Used by the chat routes to
+ * gracefully handle curl probes that omit Content-Type.
+ */
+async function readJsonBody(req) {
+    return new Promise((resolve) => {
+        const chunks = [];
+        req.on("data", (c) => chunks.push(c));
+        req.on("end", () => {
+            const raw = Buffer.concat(chunks).toString("utf-8").trim();
+            if (!raw)
+                return resolve({});
+            try {
+                resolve(JSON.parse(raw));
+            }
+            catch {
+                resolve({});
+            }
+        });
+        req.on("error", () => resolve({}));
+    });
+}
 // ============================================================================
 // TaskShowServer
 // ============================================================================
@@ -202,6 +228,8 @@ export class TaskShowServer {
     /** v0.9.0+: optional session-scoped task store. When set, GET / renders the
      *  session forest; otherwise the legacy cross-host tree view is used. */
     sessionStore;
+    /** v2.5.0+: ChatProcessManager singleton (null when chat is disabled). */
+    chatManager;
     constructor(opts) {
         this.cfg = opts.cfg;
         this.collector = opts.collector;
@@ -212,6 +240,18 @@ export class TaskShowServer {
         this.tasksTreeCache = opts.tasksTreeCache ?? null;
         this.sessionStore = opts.sessionStore ?? null;
         this.pluginVersion = opts.pluginVersion ?? "1.1.0";
+        // v2.5.0+: ChatProcessManager is a per-server singleton. It owns the
+        // subprocess lifecycle and is shared across all /api/chat/* routes.
+        if (opts.chatOptions && opts.chatOptions.enabled !== false && opts.chatOptions.cliPath) {
+            this.chatManager = new ChatProcessManager({
+                cliPath: opts.chatOptions.cliPath,
+                maxConcurrent: opts.chatOptions.maxConcurrent ?? 4,
+                defaultTimeoutMs: opts.chatOptions.defaultTimeoutMs ?? 300_000,
+            });
+        }
+        else {
+            this.chatManager = null;
+        }
     }
     /**
      * Get the SSE event bus (for tests / health checks).
@@ -342,16 +382,57 @@ export class TaskShowServer {
     async handle(req, res) {
         const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
         const method = (req.method ?? "GET").toUpperCase();
-        if (method !== "GET" && method !== "HEAD") {
-            this.text(res, 405, "Method Not Allowed");
-            return;
-        }
         const pathname = url.pathname;
         // /api/events — SSE stream
         if (pathname === "/api/events") {
+            if (method !== "GET") {
+                this.text(res, 405, "Method Not Allowed");
+                return;
+            }
             this.handleSSE(req, res);
             return;
         }
+        // v2.5.0+: /api/chat/* — home-page chat. The /start endpoint also
+        // accepts GET so plain curl/EventSource probes work without a body.
+        if (pathname === "/api/chat/start") {
+            await this.handleChatStart(req, res);
+            return;
+        }
+        const chatMsgMatch = pathname.match(/^\/api\/chat\/([^/]+)\/message$/);
+        if (chatMsgMatch) {
+            const sid = decodeURIComponent(chatMsgMatch[1]);
+            await this.handleChatMessage(sid, req, res);
+            return;
+        }
+        const chatAbortMatch = pathname.match(/^\/api\/chat\/([^/]+)\/abort$/);
+        if (chatAbortMatch) {
+            const sid = decodeURIComponent(chatAbortMatch[1]);
+            this.handleChatAbort(sid, res);
+            return;
+        }
+        // v2.5.0+ REQ-3: /api/task-chat/:taskId/message — task-aware chat.
+        // Same SSE protocol as /api/chat/:id/message but the subprocess
+        // sees a `task-${taskId}` sessionId (deterministic, long-lived)
+        // and the user message is wrapped with an additionInfo block
+        // describing the task context. The taskId itself must exist in
+        // either the collector OR the operations cache — otherwise we
+        // 404 instead of silently answering off-topic.
+        const taskChatMatch = pathname.match(/^\/api\/task-chat\/([^/]+)\/message$/);
+        if (taskChatMatch) {
+            const rawId = decodeURIComponent(taskChatMatch[1]);
+            const numericId = Number(rawId);
+            if (!Number.isFinite(numericId)) {
+                this.text(res, 400, `Invalid task id: ${rawId}`);
+                return;
+            }
+            await this.handleTaskChatMessage(numericId, req, res);
+            return;
+        }
+        // All remaining routes are GET/HEAD only.
+        if (method !== "GET" && method !== "HEAD") {
+            this.text(res, 405, "Method Not Allowed");
+            return;
+        }
         // /api/sessions
         if (pathname === "/api/sessions") {
             this.json(res, 200, this.collector.listSessions());
@@ -461,6 +542,301 @@ export class TaskShowServer {
      *    directories (defaults to cwd + $HOME; configurable via
      *    `ts.config.fileSandboxPaths`).
      */
+    // -------------------------------------------------------------------------
+    // v2.5.0+ chat handlers — POST/GET /api/chat/start,
+    // POST /api/chat/:id/message (SSE), POST /api/chat/:id/abort.
+    //
+    // The actual subprocess orchestration lives in `ChatProcessManager`
+    // (src/chat-process-manager.ts). These handlers translate HTTP + SSE
+    // concerns into chunk callbacks.
+    // -------------------------------------------------------------------------
+    /**
+     * Allocate a fresh chat sessionId. The id is just a string — the
+     * underlying SQLite store lives inside the `roy-agent act` subprocess
+     * (we never persist anything ourselves; on the next `act -s <id>` call
+     * the CLI resurrects the session from disk if it still exists).
+     */
+    handleChatStart(req, res) {
+        if (!this.chatManager) {
+            this.json(res, 503, { error: "chat_disabled", message: "Chat feature is not enabled on this server." });
+            return;
+        }
+        const method = (req.method ?? "GET").toUpperCase();
+        if (method !== "POST" && method !== "GET" && method !== "HEAD") {
+            this.text(res, 405, "Method Not Allowed");
+            return;
+        }
+        // Use crypto.randomUUID when available; fall back to time + random.
+        const id = typeof globalThis.crypto?.randomUUID === "function"
+            ? globalThis.crypto.randomUUID()
+            : `sess_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+        const sessionId = `session_${id}`;
+        this.json(res, 200, {
+            sessionId,
+            createdAt: new Date().toISOString(),
+        });
+    }
+    /**
+     * SSE endpoint. Accepts `application/json` POST body and emits a series
+     * of SSE frames: `event: chunk` for every ChatChunk, then
+     * `event: done` once the subprocess exits (or `event: error` on
+     * failure).
+     */
+    async handleChatMessage(sessionId, req, res) {
+        if (!this.chatManager) {
+            this.json(res, 503, { error: "chat_disabled" });
+            return;
+        }
+        const method = (req.method ?? "GET").toUpperCase();
+        if (method !== "POST" && method !== "GET") {
+            this.text(res, 405, "Method Not Allowed");
+            return;
+        }
+        let message = "";
+        if (method === "POST") {
+            const body = await readJsonBody(req);
+            if (body && typeof body === "object" && typeof body.message === "string") {
+                message = body.message;
+            }
+        }
+        if (!message && method === "GET") {
+            message = "";
+        }
+        if (typeof message !== "string" || message.length === 0) {
+            this.json(res, 400, { error: "bad_request", message: "Missing `message` field in JSON body." });
+            return;
+        }
+        // SSE headers.
+        res.statusCode = 200;
+        res.setHeader("Content-Type", "text/event-stream; charset=utf-8");
+        res.setHeader("Cache-Control", "no-cache, no-transform");
+        res.setHeader("Connection", "keep-alive");
+        res.setHeader("X-Accel-Buffering", "no");
+        res.flushHeaders?.();
+        let chunkIndex = 0;
+        const sendFrame = (event, payload) => {
+            if (res.writableEnded || res.destroyed)
+                return;
+            const id = ++chunkIndex;
+            try {
+                res.write(`id: ${id}\nevent: ${event}\ndata: ${JSON.stringify(payload)}\n\n`);
+            }
+            catch {
+                /* socket closed mid-write */
+            }
+        };
+        // Initial heartbeat so the client knows the connection is live before
+        // the subprocess warms up.
+        sendFrame("ready", { sessionId });
+        try {
+            const result = await this.chatManager.sendStream(sessionId, message, (chunk) => {
+                sendFrame("chunk", chunk);
+                if (chunk.type === "done" || chunk.type === "error") {
+                    // Mirror the terminal event on its own line so EventSource
+                    // listeners can register `addEventListener("done", ...)`.
+                    sendFrame(chunk.type, chunk);
+                }
+            });
+            sendFrame("done", { sessionId, exitCode: result.exitCode, durationMs: result.durationMs });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            sendFrame("error", { sessionId, error: { message: msg } });
+        }
+        try {
+            res.end();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    /** Abort an in-flight chat query for the given session. */
+    handleChatAbort(sessionId, res) {
+        if (!this.chatManager) {
+            this.json(res, 503, { error: "chat_disabled" });
+            return;
+        }
+        this.chatManager.abort(sessionId);
+        this.json(res, 200, { sessionId, aborted: true });
+    }
+    /**
+     * v2.5.0+ REQ-3: task-aware chat endpoint.
+     *
+     * Resolves the task by id (from the collector session OR the
+     * operations cache), builds an additionInfo block from the task
+     * context, wraps the user's message, and forwards it to the same
+     * ChatProcessManager REQ-2 already plumbs. The sessionId is the
+     * deterministic `task-${taskId}` so reloads land on the same
+     * SQLite-backed conversation.
+     *
+     * Returns 404 when the task is unknown — we deliberately do NOT
+     * answer off-topic questions for tasks that don't exist (which is
+     * the same behaviour REQ-2 already shows for unknown chat
+     * sessions, just gated by a task id instead of a random uuid).
+     */
+    async handleTaskChatMessage(taskId, req, res) {
+        if (!this.chatManager) {
+            this.json(res, 503, { error: "chat_disabled" });
+            return;
+        }
+        const method = (req.method ?? "GET").toUpperCase();
+        if (method !== "POST" && method !== "GET") {
+            this.text(res, 405, "Method Not Allowed");
+            return;
+        }
+        let message = "";
+        if (method === "POST") {
+            const body = await readJsonBody(req);
+            if (body && typeof body === "object" && typeof body.message === "string") {
+                message = body.message;
+            }
+        }
+        if (typeof message !== "string" || message.length === 0) {
+            this.json(res, 400, { error: "bad_request", message: "Missing `message` field in JSON body." });
+            return;
+        }
+        // Resolve the task context. Collector sessions are the primary
+        // source for in-progress tasks (live `title` / `status` /
+        // `context.worktree`); the operations cache is the fallback for
+        // tasks the user is asking about retroactively (session is gone
+        // but the CLI still has the description / operations). If neither
+        // knows the task, return 404 — answering without context would
+        // produce a misleading answer.
+        const ctx = await this.resolveTaskChatContext(taskId);
+        if (!ctx) {
+            this.json(res, 404, { error: "not_found", id: taskId });
+            return;
+        }
+        const builder = new TaskChatContextBuilder(ctx);
+        const sessionId = builder.sessionId();
+        const wrapped = builder.wrapMessage(message);
+        // SSE headers (mirror /api/chat/:id/message so the frontend SSE
+        // parser can stay identical).
+        res.statusCode = 200;
+        res.setHeader("Content-Type", "text/event-stream; charset=utf-8");
+        res.setHeader("Cache-Control", "no-cache, no-transform");
+        res.setHeader("Connection", "keep-alive");
+        res.setHeader("X-Accel-Buffering", "no");
+        res.flushHeaders?.();
+        let chunkIndex = 0;
+        const sendFrame = (event, payload) => {
+            if (res.writableEnded || res.destroyed)
+                return;
+            const id = ++chunkIndex;
+            try {
+                res.write(`id: ${id}\nevent: ${event}\ndata: ${JSON.stringify(payload)}\n\n`);
+            }
+            catch {
+                /* socket closed mid-write */
+            }
+        };
+        // Heartbeat so the client knows the connection is live.
+        sendFrame("ready", { sessionId, taskId, truncated: builder.truncated });
+        try {
+            const result = await this.chatManager.sendStream(sessionId, wrapped, (chunk) => {
+                sendFrame("chunk", chunk);
+                if (chunk.type === "done" || chunk.type === "error") {
+                    sendFrame(chunk.type, chunk);
+                }
+            });
+            sendFrame("done", {
+                sessionId,
+                taskId,
+                exitCode: result.exitCode,
+                durationMs: result.durationMs,
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            sendFrame("error", { sessionId, taskId, error: { message: msg } });
+        }
+        try {
+            res.end();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    /**
+     * Resolve the task context for a chat turn. Returns the
+     * TaskChatContextBuilder input or null when the task is unknown.
+     * Prefers the live collector session (rich `context.worktree` +
+     * current status); falls back to the operations cache envelope
+     * for tasks that have already been finalized.
+     */
+    async resolveTaskChatContext(taskId) {
+        const live = this.collector.getSession(taskId);
+        if (live) {
+            // Best-effort: pull description / priority / operations from
+            // the operations cache if available (the CLI is the canonical
+            // source for those — collector only tracks tool calls).
+            let description;
+            let priority = live.status; // sensible fallback
+            let recentOperations = [];
+            if (this.operationsCache) {
+                try {
+                    const cached = await this.operationsCache.get(taskId, { allowStale: true });
+                    description = cached.task.context && typeof cached.task.context === "object"
+                        ? JSON.stringify(cached.task.context)
+                        : undefined;
+                    if (cached.task.goals_and_expected_deliverables && !description) {
+                        description = cached.task.goals_and_expected_deliverables;
+                    }
+                    priority = cached.task.priority ?? priority;
+                    recentOperations = cached.operations.slice(0, 10).map((op) => ({
+                        id: op.id,
+                        sequence: op.sequence,
+                        milestoneType: op.milestoneType,
+                        title: op.title,
+                        description: op.description,
+                        processDescription: op.processDescription,
+                        timestamp: op.timestamp,
+                        sessionShort: op.sessionShort,
+                    }));
+                }
+                catch {
+                    /* fall through with defaults — we still answer */
+                }
+            }
+            return {
+                taskId: live.taskId,
+                title: live.title,
+                description,
+                status: live.status,
+                priority,
+                worktree: live.context?.worktree,
+                recentOperations,
+            };
+        }
+        if (this.operationsCache) {
+            try {
+                const cached = await this.operationsCache.get(taskId, { allowStale: true });
+                const ctx = cached.task.context;
+                return {
+                    taskId: cached.task.id,
+                    title: cached.task.title,
+                    description: ctx && typeof ctx === "object" ? JSON.stringify(ctx) : cached.task.goals_and_expected_deliverables,
+                    status: cached.task.status,
+                    priority: cached.task.priority,
+                    worktree: cached.task.projectPath,
+                    recentOperations: cached.operations.slice(0, 10).map((op) => ({
+                        id: op.id,
+                        sequence: op.sequence,
+                        milestoneType: op.milestoneType,
+                        title: op.title,
+                        description: op.description,
+                        processDescription: op.processDescription,
+                        timestamp: op.timestamp,
+                        sessionShort: op.sessionShort,
+                    })),
+                };
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
     handleFileContent(url, req, res) {
         const wantsHtml = prefersHtml(req);
         const raw = url.searchParams.get("path") ?? "";
@@ -1190,6 +1566,8 @@ export function renderTaskPage(session) {
           <pre class="json">${htmlEscape(JSON.stringify(session, null, 2))}</pre>
         </details>
       </section>
+
+      ${renderChatPanel({ scope: "task", taskId: session.taskId })}
     </div>
   </div>
 
@@ -1198,6 +1576,7 @@ export function renderTaskPage(session) {
   <script src="/static/task-operations.js"></script>
   <script src="/static/file-tree.js"></script>
   <script src="/static/tool-call-detail.js"></script>
+  <script src="/static/chat-panel.js" defer></script>
   <script>
     if (window.mermaid) {
       window.mermaid.initialize({
@@ -1337,6 +1716,18 @@ function walkTreeFlat(node, depth, out, affectedSet) {
         walkTreeFlat(child, depth + 1, out, affectedSet);
     }
 }
+// v2.5.1+ REQ-2 fix: `renderChatPanel` now lives in `./chat-panel-html.ts`
+// so BOTH `renderIndexPage` (legacy home, server.ts) and
+// `_renderSessionForestPageImpl` (production home, task-session-store.ts)
+// can embed the same markup. See chat-panel-html.ts for the asset
+// contract that home-chat-v25.test.ts and
+// chat-panel-session-forest-v251.test.ts pin.
+//
+// v2.5 REQ-3: `renderChatPanel()` accepts `{scope, taskId}` so the
+// task-detail page can embed a task-aware panel (with
+// `data-chat-scope="task" data-task-id="N"` hooks the JS factory reads
+// to route to /api/task-chat/<N>/message). The contract is pinned by
+// test/task-chat-v25.test.ts.
 function renderIndexPage(sessions) {
     // SSR hint — the tree container is always rendered; if /api/tasks/tree
     // returns 503 the JS shows a graceful empty state with a hint to
@@ -1361,6 +1752,8 @@ function renderIndexPage(sessions) {
     </p>
   </header>
 
+  ${renderChatPanel()}
+
   <section class="panel tree-controls">
     <div class="tree-controls-row">
       <label class="tree-search">
@@ -1449,6 +1842,17 @@ function renderIndexPage(sessions) {
   <script src="/static/app.js"></script>
   <script src="/static/mermaid-renderer.js"></script>
   <script src="/static/tasks-tree.js"></script>
+  <!--
+    v2.5.x REQ-4: vendor markdown rendering for the home chat panel.
+    Load order matters - marked must register globals before DOMPurify
+    is constructed, and both must register before markdown-renderer.js
+    resolves them at import time. chat-panel.js only depends on
+    window.markdownRenderer, which is set by markdown-renderer.js.
+  -->
+  <script src="/static/marked.min.js" defer></script>
+  <script src="/static/dompurify.min.js" defer></script>
+  <script src="/static/markdown-renderer.js" defer></script>
+  <script src="/static/chat-panel.js" defer></script>
 </body>
 </html>`;
 }