@ai-setting/roy-plugin-task-show 2.5.0 → 2.5.2

package/dist/chat-panel-html.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Chat panel HTML — extracted v2.5.1 for cross-page reuse.
+ *
+ * ## Why this module exists (v2.5.1 REQ-2 fix + v2.5 REQ-3 extension)
+ *
+ * v2.5.0 introduced the home-page chat panel via `renderChatPanel()`
+ * defined inside `src/server.ts`. Only `renderIndexPage` (the legacy
+ * home page, hit when no `TaskSessionStore` is configured) actually
+ * called it. The plugin always wires a `TaskSessionStore`, so the
+ * production home page (`renderSessionForestPage` in
+ * `src/task-session-store.ts`) shipped **without** the chat panel.
+ *
+ * The pre-existing `home-chat-v25.test.ts` constructed a server
+ * WITHOUT `sessionStore`, so the green test exercised the legacy
+ * path and the v2.5.0 bug slipped through.
+ *
+ * The v2.5.1 fix:
+ *   1. Extract `renderChatPanel()` into this shared module.
+ *   2. Have BOTH `renderIndexPage` (legacy) AND
+ *      `_renderSessionForestPageImpl` (production home) import it.
+ *   3. Both pages also need `<script src="/static/chat-panel.js"
+ *      defer></script>` for the JS to actually wire up the form.
+ *
+ * v2.5 REQ-3 extends `renderChatPanel()` to accept an `opts` bag
+ * with `scope` ("home" | "task") and `taskId` (when scope=task).
+ * The HTML carries `data-chat-scope` and `data-task-id` hooks that
+ * the chat-panel.js factory picks up to route to `/api/chat/...`
+ * vs `/api/task-chat/...` and to select the right localStorage key.
+ *
+ * Extracting to a dedicated module avoids a circular import between
+ * `server.ts` ↔ `task-session-store.ts` (server already imports from
+ * task-session-store, and task-session-store previously imported
+ * nothing from server, but future plugin evolution may want
+ * session-store to depend on other server-side types — keeping
+ * chat-panel-html a leaf module is a safer contract).
+ *
+ * The asset contract pinned by `test/home-chat-v25.test.ts`,
+ * `test/chat-panel-session-forest-v251.test.ts` and
+ * `test/task-chat-v25.test.ts`:
+ *   • `data-chat-shell` — the section root
+ *   • `data-chat-scope` — "home" | "task" (read by the JS factory)
+ *   • `data-task-id`   — task id when scope=task
+ *   • `data-chat-input` — the text input
+ *   • `data-chat-send`  — the submit button
+ *   • `data-chat-form`  — the `<form>` (used by the JS to bind Enter)
+ *   • `data-chat-messages` — the message log container
+ *   • `<script src="/static/chat-panel.js" defer></script>` — must
+ *     follow the markup on the same page (defer is fine because the
+ *     JS module polls for the DOM on load).
+ *
+ * Disabled gracefully: when the host didn't pass
+ * `chatOptions.enabled` we render the empty section so SSR layout
+ * stays predictable; the JS short-circuits and the `/api/chat/*`
+ * endpoints return 503.
+ */
+/**
+ * Render the home-page chat panel markup.
+ *
+ * Markup is intentionally minimal — the heavy lifting (EventSource
+ * handling, message rendering, sessionId persistence) lives in
+ * `public/chat-panel.js`. The HTML below carries `data-*` hooks that
+ * the JS module targets; the contracts are pinned by
+ * `test/home-chat-v25.test.ts`,
+ * `test/chat-panel-session-forest-v251.test.ts` and
+ * `test/task-chat-v25.test.ts`.
+ *
+ * @param opts.scope    "home" (default) | "task" — controls the
+ *                      API endpoint the JS targets and the UI badge.
+ * @param opts.taskId   Required when scope === "task". Used to label
+ *                      the panel and bind `data-task-id`.
+ */
+export declare function renderChatPanel(opts?: {
+    scope?: "home" | "task";
+    taskId?: number;
+}): string;
+//# sourceMappingURL=chat-panel-html.d.ts.map

package/dist/chat-panel-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-panel-html.d.ts","sourceRoot":"","sources":["../src/chat-panel-html.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CA6C/F"}

package/dist/chat-panel-html.js

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Chat panel HTML — extracted v2.5.1 for cross-page reuse.
+ *
+ * ## Why this module exists (v2.5.1 REQ-2 fix + v2.5 REQ-3 extension)
+ *
+ * v2.5.0 introduced the home-page chat panel via `renderChatPanel()`
+ * defined inside `src/server.ts`. Only `renderIndexPage` (the legacy
+ * home page, hit when no `TaskSessionStore` is configured) actually
+ * called it. The plugin always wires a `TaskSessionStore`, so the
+ * production home page (`renderSessionForestPage` in
+ * `src/task-session-store.ts`) shipped **without** the chat panel.
+ *
+ * The pre-existing `home-chat-v25.test.ts` constructed a server
+ * WITHOUT `sessionStore`, so the green test exercised the legacy
+ * path and the v2.5.0 bug slipped through.
+ *
+ * The v2.5.1 fix:
+ *   1. Extract `renderChatPanel()` into this shared module.
+ *   2. Have BOTH `renderIndexPage` (legacy) AND
+ *      `_renderSessionForestPageImpl` (production home) import it.
+ *   3. Both pages also need `<script src="/static/chat-panel.js"
+ *      defer></script>` for the JS to actually wire up the form.
+ *
+ * v2.5 REQ-3 extends `renderChatPanel()` to accept an `opts` bag
+ * with `scope` ("home" | "task") and `taskId` (when scope=task).
+ * The HTML carries `data-chat-scope` and `data-task-id` hooks that
+ * the chat-panel.js factory picks up to route to `/api/chat/...`
+ * vs `/api/task-chat/...` and to select the right localStorage key.
+ *
+ * Extracting to a dedicated module avoids a circular import between
+ * `server.ts` ↔ `task-session-store.ts` (server already imports from
+ * task-session-store, and task-session-store previously imported
+ * nothing from server, but future plugin evolution may want
+ * session-store to depend on other server-side types — keeping
+ * chat-panel-html a leaf module is a safer contract).
+ *
+ * The asset contract pinned by `test/home-chat-v25.test.ts`,
+ * `test/chat-panel-session-forest-v251.test.ts` and
+ * `test/task-chat-v25.test.ts`:
+ *   • `data-chat-shell` — the section root
+ *   • `data-chat-scope` — "home" | "task" (read by the JS factory)
+ *   • `data-task-id`   — task id when scope=task
+ *   • `data-chat-input` — the text input
+ *   • `data-chat-send`  — the submit button
+ *   • `data-chat-form`  — the `<form>` (used by the JS to bind Enter)
+ *   • `data-chat-messages` — the message log container
+ *   • `<script src="/static/chat-panel.js" defer></script>` — must
+ *     follow the markup on the same page (defer is fine because the
+ *     JS module polls for the DOM on load).
+ *
+ * Disabled gracefully: when the host didn't pass
+ * `chatOptions.enabled` we render the empty section so SSR layout
+ * stays predictable; the JS short-circuits and the `/api/chat/*`
+ * endpoints return 503.
+ */
+/**
+ * Render the home-page chat panel markup.
+ *
+ * Markup is intentionally minimal — the heavy lifting (EventSource
+ * handling, message rendering, sessionId persistence) lives in
+ * `public/chat-panel.js`. The HTML below carries `data-*` hooks that
+ * the JS module targets; the contracts are pinned by
+ * `test/home-chat-v25.test.ts`,
+ * `test/chat-panel-session-forest-v251.test.ts` and
+ * `test/task-chat-v25.test.ts`.
+ *
+ * @param opts.scope    "home" (default) | "task" — controls the
+ *                      API endpoint the JS targets and the UI badge.
+ * @param opts.taskId   Required when scope === "task". Used to label
+ *                      the panel and bind `data-task-id`.
+ */
+export function renderChatPanel(opts = {}) {
+    const scope = opts.scope ?? "home";
+    const taskId = opts.taskId;
+    const isTask = scope === "task" && typeof taskId === "number";
+    const ariaLabel = isTask ? `Task #${taskId} chat panel` : "Home chat panel";
+    const heading = isTask ? "💬 Task chat" : "💬 roy-agent chat";
+    const badge = isTask
+        ? `<span class="chat-scope-badge" data-chat-scope-badge>Connected to task #${taskId}</span>`
+        : "";
+    const subline = isTask
+        ? `Multi-turn conversation powered by <code>roy-agent act -s task-${taskId}</code>. The task context (title, status, recent operations) is auto-injected into every message.`
+        : `Multi-turn conversation powered by <code>roy-agent act -s &lt;sessionId&gt;</code>.`;
+    const placeholder = isTask ? `Ask anything about task #${taskId}…` : "Type a message and press Enter…";
+    // Scope + taskId hooks the JS factory reads to pick the right
+    // endpoint and the right localStorage key.
+    const scopeAttrs = isTask
+        ? ` data-chat-scope="task" data-task-id="${taskId}"`
+        : ` data-chat-scope="home"`;
+    const extraClass = isTask ? " chat-panel--task" : "";
+    return `
+  <section class="panel chat-panel${extraClass}"${scopeAttrs} data-chat-shell aria-label="${ariaLabel}">
+    <header class="chat-panel-header">
+      <h2>${heading} ${badge}</h2>
+      <p class="meta chat-panel-meta">${subline}</p>
+    </header>
+    <div class="chat-messages" data-chat-messages role="log" aria-live="polite" aria-relevant="additions">
+      <p class="chat-empty">No messages yet — ask away!</p>
+    </div>
+    <form class="chat-form" data-chat-form autocomplete="off">
+      <label class="visually-hidden" for="chat-input">Message</label>
+      <input
+        id="chat-input"
+        type="text"
+        class="chat-input"
+        data-chat-input
+        placeholder="${placeholder}"
+        autocomplete="off"
+      />
+      <button type="submit" class="chat-send" data-chat-send aria-label="Send message">
+        Send
+      </button>
+    </form>
+  </section>
+`;
+}
+//# sourceMappingURL=chat-panel-html.js.map

package/dist/chat-panel-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-panel-html.js","sourceRoot":"","sources":["../src/chat-panel-html.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,OAAqD,EAAE;IACrF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,MAAM,MAAM,GAAG,KAAK,KAAK,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC;IAC9D,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,MAAM,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM;QAClB,CAAC,CAAC,2EAA2E,MAAM,SAAS;QAC5F,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,OAAO,GAAG,MAAM;QACpB,CAAC,CAAC,kEAAkE,MAAM,mGAAmG;QAC7K,CAAC,CAAC,qFAAqF,CAAC;IAC1F,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,4BAA4B,MAAM,GAAG,CAAC,CAAC,CAAC,iCAAiC,CAAC;IACvG,8DAA8D;IAC9D,2CAA2C;IAC3C,MAAM,UAAU,GAAG,MAAM;QACvB,CAAC,CAAC,yCAAyC,MAAM,GAAG;QACpD,CAAC,CAAC,yBAAyB,CAAC;IAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAErD,OAAO;oCAC2B,UAAU,IAAI,UAAU,gCAAgC,SAAS;;YAEzF,OAAO,IAAI,KAAK;wCACY,OAAO;;;;;;;;;;;;uBAYxB,WAAW;;;;;;;;CAQjC,CAAC;AACF,CAAC"}

package/dist/server.d.ts

@@ -202,6 +202,30 @@ export declare class TaskShowServer {
     private handleChatMessage;
     /** Abort an in-flight chat query for the given session. */
     private handleChatAbort;
+    /**
+     * 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).
+     */
+    private handleTaskChatMessage;
+    /**
+     * 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.
+     */
+    private resolveTaskChatContext;
     private handleFileContent;
     /**
      * v2.0.0: GET /api/task/:id/file-tree — returns the git-tracked

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":"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"}

package/dist/server.js

@@ -37,6 +37,8 @@ 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). */
@@ -408,6 +410,24 @@ export class TaskShowServer {
             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");
@@ -639,6 +659,184 @@ export class TaskShowServer {
         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") ?? "";
@@ -1368,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>
 
@@ -1376,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({
@@ -1515,49 +1716,18 @@ function walkTreeFlat(node, depth, out, affectedSet) {
         walkTreeFlat(child, depth + 1, out, affectedSet);
     }
 }
-/**
- * v2.5.0+: render the home-page chat panel.
- *
- * Markup is intentionally minimal — the heavy lifting (EventSource
- * handling, message rendering, sessionId persistence) lives in
- * `public/chat-panel.js`. The HTML below carries `data-*` hooks that
- * the JS module targets; the contracts are pinned by
- * `test/home-chat-v25.test.ts`.
- *
- * Disabled gracefully: when `chatEnabled` is false (the host didn't
- * pass `chatOptions.enabled`) we render an empty section so SSR layout
- * stays predictable, but the JS module short-circuits and the API
- * endpoints return 503.
- */
-function renderChatPanel() {
-    return `
-  <section class="panel chat-panel" data-chat-shell aria-label="Home chat panel">
-    <header class="chat-panel-header">
-      <h2>💬 roy-agent chat</h2>
-      <p class="meta chat-panel-meta">
-        Multi-turn conversation powered by <code>roy-agent act -s &lt;sessionId&gt;</code>.
-      </p>
-    </header>
-    <div class="chat-messages" data-chat-messages role="log" aria-live="polite" aria-relevant="additions">
-      <p class="chat-empty">No messages yet — ask away!</p>
-    </div>
-    <form class="chat-form" data-chat-form autocomplete="off">
-      <label class="visually-hidden" for="chat-input">Message</label>
-      <input
-        id="chat-input"
-        type="text"
-        class="chat-input"
-        data-chat-input
-        placeholder="Type a message and press Enter…"
-        autocomplete="off"
-      />
-      <button type="submit" class="chat-send" data-chat-send aria-label="Send message">
-        Send
-      </button>
-    </form>
-  </section>
-`;
-}
+// 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
@@ -1672,6 +1842,16 @@ 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>`;