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

package/dist/chat-output-parser.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Output parser for `roy-agent act` subprocess stdout.
+ *
+ * `roy-agent act -s <sessionId> <message>` writes human-friendly text to
+ * stdout with a leading/trailing sentinel pair:
+ *
+ *     [TaskEventHandler] Started
+ *     ... LLM streaming text ...
+ *     [TaskEventHandler] Stopped
+ *
+ * We do not want the sentinel lines to leak into the chat UI, and we want
+ * to strip ANSI colour codes that the CLI uses to highlight text. This
+ * module is the single place that knows about that format — every other
+ * layer treats output as an opaque byte stream.
+ *
+ * v2.5.0: kept tiny so we can unit-test the contract in isolation.
+ */
+export declare const SENTINEL_START = "[TaskEventHandler] Started";
+export declare const SENTINEL_STOP = "[TaskEventHandler] Stopped";
+/** Strip CSI / SGR ANSI colour codes from a chunk of stdout. */
+export declare function stripAnsi(input: string): string;
+/** Strip the literal sentinel lines (start + stop). Case-sensitive. */
+export declare function stripSentinels(input: string): string;
+/** Convenience: strip ANSI + sentinels + trim trailing newline. */
+export declare function cleanStdout(raw: string): string;
+//# sourceMappingURL=chat-output-parser.d.ts.map

package/dist/chat-output-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-output-parser.d.ts","sourceRoot":"","sources":["../src/chat-output-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,eAAO,MAAM,cAAc,+BAA+B,CAAC;AAC3D,eAAO,MAAM,aAAa,+BAA+B,CAAC;AAE1D,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/chat-output-parser.js

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Output parser for `roy-agent act` subprocess stdout.
+ *
+ * `roy-agent act -s <sessionId> <message>` writes human-friendly text to
+ * stdout with a leading/trailing sentinel pair:
+ *
+ *     [TaskEventHandler] Started
+ *     ... LLM streaming text ...
+ *     [TaskEventHandler] Stopped
+ *
+ * We do not want the sentinel lines to leak into the chat UI, and we want
+ * to strip ANSI colour codes that the CLI uses to highlight text. This
+ * module is the single place that knows about that format — every other
+ * layer treats output as an opaque byte stream.
+ *
+ * v2.5.0: kept tiny so we can unit-test the contract in isolation.
+ */
+const ANSI_RE = /\x1B\[[0-9;?]*[A-Za-z]/g;
+export const SENTINEL_START = "[TaskEventHandler] Started";
+export const SENTINEL_STOP = "[TaskEventHandler] Stopped";
+/** Strip CSI / SGR ANSI colour codes from a chunk of stdout. */
+export function stripAnsi(input) {
+    return input.replace(ANSI_RE, "");
+}
+/** Strip the literal sentinel lines (start + stop). Case-sensitive. */
+export function stripSentinels(input) {
+    return input
+        .split(/\r?\n/)
+        .filter((line) => line.trim() !== SENTINEL_START && line.trim() !== SENTINEL_STOP)
+        .join("\n");
+}
+/** Convenience: strip ANSI + sentinels + trim trailing newline. */
+export function cleanStdout(raw) {
+    return stripSentinels(stripAnsi(raw)).replace(/\n+$/, "");
+}
+//# sourceMappingURL=chat-output-parser.js.map

package/dist/chat-output-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-output-parser.js","sourceRoot":"","sources":["../src/chat-output-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,OAAO,GAAG,yBAAyB,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAG,4BAA4B,CAAC;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,4BAA4B,CAAC;AAE1D,gEAAgE;AAChE,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK;SACT,KAAK,CAAC,OAAO,CAAC;SACd,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,aAAa,CAAC;SACjF,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC5D,CAAC"}

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/chat-process-manager.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview ChatProcessManager — spawn wrapper for `roy-agent act`.
+ *
+ * v2.5.0: encapsulates the user-decided integration strategy documented in
+ * /tmp/task-show-v2.5-spawn-plan.md. We do NOT depend on the roy-agent
+ * SDK; instead we shell out to `node <roy-agent.js> act -s <sessionId>
+ <message>` per query and stream the subprocess stdout back to the
+ * consumer.
+ *
+ * Concurrency: a FIFO queue caps the number of in-flight subprocesses at
+ * `maxConcurrent`. Excess calls `await` until a slot frees up.
+ *
+ * Lifecycle: every `sendStream` call spawns exactly ONE short-lived
+ * subprocess. The subprocess is SIGTERM'd (then SIGKILL after 5s) on
+ * `abort()`. The slot is released in the `exit` handler so a failure
+ * cannot leak concurrency.
+ *
+ * Output parsing: each line written by the subprocess is classified into
+ * a `ChatChunk` (see type below). Sentinels and ANSI codes are stripped
+ * before classification — see `chat-output-parser.ts`.
+ */
+/** One unit of output emitted by `roy-agent act`. */
+export type ChatChunkType = "start" | "text" | "reasoning" | "done" | "error";
+export interface ChatChunk {
+    type: ChatChunkType;
+    /** Plain text payload (already ANSI-stripped). */
+    text?: string;
+    /** Final metadata attached to start/done chunks. */
+    meta?: {
+        sessionId: string;
+        latencyMs?: number;
+        exitCode?: number;
+    };
+    /** Error info attached to error chunks. */
+    error?: {
+        message: string;
+        code?: string;
+    };
+}
+export interface SendOptions {
+    /** Hard timeout (default = constructor `defaultTimeoutMs`). */
+    timeoutMs?: number;
+    /** Working dir for the subprocess (default = process.cwd()). */
+    cwd?: string;
+    /** Extra args appended AFTER `--tool-calls=false`. Used by tests. */
+    extraArgs?: string[];
+}
+export interface ChatProcessManagerOptions {
+    /** Absolute path to the roy-agent CLI entry. */
+    cliPath: string;
+    /** Maximum concurrent subprocesses (default 4). */
+    maxConcurrent?: number;
+    /** Default timeout per query (default 300_000 ms). */
+    defaultTimeoutMs?: number;
+}
+export interface SendResult {
+    exitCode: number;
+    durationMs: number;
+}
+/**
+ * Manager — single instance per task-show process. Stateless beyond the
+ * concurrency queue + abort map.
+ */
+export declare class ChatProcessManager {
+    private readonly cliPath;
+    private readonly maxConcurrent;
+    private readonly defaultTimeoutMs;
+    private active;
+    private queue;
+    private abortFlags;
+    private totalCompleted;
+    constructor(opts: ChatProcessManagerOptions);
+    /** Block until a concurrency slot is available. */
+    private acquire;
+    /** Release a slot; wake the next waiter if any. */
+    private release;
+    /**
+     * Stream a chat turn. The callback receives ChatChunk objects in the
+     * order they are classified; the returned promise resolves with the
+     * subprocess exit metadata.
+     */
+    sendStream(sessionId: string, message: string, onChunk: (chunk: ChatChunk) => void, opts?: SendOptions): Promise<SendResult>;
+    private emitLine;
+    /** Abort an in-flight query (best-effort SIGTERM). */
+    abort(sessionId: string): void;
+    /** Stats for monitoring / health endpoints. */
+    stats(): {
+        active: number;
+        queued: number;
+        totalCompleted: number;
+    };
+}
+//# sourceMappingURL=chat-process-manager.d.ts.map

package/dist/chat-process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-process-manager.d.ts","sourceRoot":"","sources":["../src/chat-process-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,qDAAqD;AACrD,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,MAAM,GACN,WAAW,GACX,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,2CAA2C;IAC3C,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,cAAc,CAAK;gBAEf,IAAI,EAAE,yBAAyB;IAS3C,mDAAmD;YACrC,OAAO;IASrB,mDAAmD;IACnD,OAAO,CAAC,OAAO;IAMf;;;;OAIG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,EACnC,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,UAAU,CAAC;IAiHtB,OAAO,CAAC,QAAQ;IAoBhB,sDAAsD;IACtD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK9B,+CAA+C;IAC/C,KAAK,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;CAOpE"}

package/dist/chat-process-manager.js

@@ -0,0 +1,197 @@
+/**
+ * @fileoverview ChatProcessManager — spawn wrapper for `roy-agent act`.
+ *
+ * v2.5.0: encapsulates the user-decided integration strategy documented in
+ * /tmp/task-show-v2.5-spawn-plan.md. We do NOT depend on the roy-agent
+ * SDK; instead we shell out to `node <roy-agent.js> act -s <sessionId>
+ <message>` per query and stream the subprocess stdout back to the
+ * consumer.
+ *
+ * Concurrency: a FIFO queue caps the number of in-flight subprocesses at
+ * `maxConcurrent`. Excess calls `await` until a slot frees up.
+ *
+ * Lifecycle: every `sendStream` call spawns exactly ONE short-lived
+ * subprocess. The subprocess is SIGTERM'd (then SIGKILL after 5s) on
+ * `abort()`. The slot is released in the `exit` handler so a failure
+ * cannot leak concurrency.
+ *
+ * Output parsing: each line written by the subprocess is classified into
+ * a `ChatChunk` (see type below). Sentinels and ANSI codes are stripped
+ * before classification — see `chat-output-parser.ts`.
+ */
+import { spawn } from "node:child_process";
+import { stripAnsi } from "./chat-output-parser.js";
+const REASONING_OPEN = "<think>";
+/**
+ * Manager — single instance per task-show process. Stateless beyond the
+ * concurrency queue + abort map.
+ */
+export class ChatProcessManager {
+    cliPath;
+    maxConcurrent;
+    defaultTimeoutMs;
+    active = 0;
+    queue = [];
+    abortFlags = new Map();
+    totalCompleted = 0;
+    constructor(opts) {
+        if (!opts || typeof opts.cliPath !== "string" || opts.cliPath.length === 0) {
+            throw new Error("ChatProcessManager: cliPath is required");
+        }
+        this.cliPath = opts.cliPath;
+        this.maxConcurrent = Math.max(1, opts.maxConcurrent ?? 4);
+        this.defaultTimeoutMs = opts.defaultTimeoutMs ?? 300_000;
+    }
+    /** Block until a concurrency slot is available. */
+    async acquire() {
+        if (this.active < this.maxConcurrent) {
+            this.active++;
+            return;
+        }
+        await new Promise((resolve) => this.queue.push(resolve));
+        this.active++;
+    }
+    /** Release a slot; wake the next waiter if any. */
+    release() {
+        this.active = Math.max(0, this.active - 1);
+        const next = this.queue.shift();
+        if (next)
+            next();
+    }
+    /**
+     * Stream a chat turn. The callback receives ChatChunk objects in the
+     * order they are classified; the returned promise resolves with the
+     * subprocess exit metadata.
+     */
+    async sendStream(sessionId, message, onChunk, opts = {}) {
+        if (typeof sessionId !== "string" || sessionId.length === 0) {
+            throw new Error("ChatProcessManager: sessionId is required");
+        }
+        if (typeof message !== "string") {
+            throw new Error("ChatProcessManager: message must be a string");
+        }
+        await this.acquire();
+        const ctrl = new AbortController();
+        this.abortFlags.set(sessionId, ctrl);
+        const args = [
+            this.cliPath,
+            "act",
+            "-s",
+            sessionId,
+            message,
+            "--reasoning=false",
+            "--tool-calls=false",
+            ...(opts.extraArgs ?? []),
+        ];
+        const startedAt = Date.now();
+        const timeoutMs = opts.timeoutMs ?? this.defaultTimeoutMs;
+        let proc;
+        try {
+            proc = spawn("node", args, {
+                cwd: opts.cwd ?? process.cwd(),
+                stdio: ["ignore", "pipe", "pipe"],
+                signal: ctrl.signal,
+            });
+        }
+        catch (err) {
+            this.abortFlags.delete(sessionId);
+            this.release();
+            const msg = err instanceof Error ? err.message : String(err);
+            onChunk({ type: "error", error: { message: msg, code: "spawn_failed" } });
+            onChunk({
+                type: "done",
+                meta: { sessionId, exitCode: -1, latencyMs: Date.now() - startedAt },
+            });
+            return { exitCode: -1, durationMs: Date.now() - startedAt };
+        }
+        onChunk({ type: "start", meta: { sessionId } });
+        // Force-kill watchdog so a stuck subprocess cannot pin a slot.
+        const killTimer = setTimeout(() => {
+            try {
+                proc.kill("SIGKILL");
+            }
+            catch {
+                /* ignore */
+            }
+        }, timeoutMs);
+        killTimer.unref?.();
+        let stdoutBuf = "";
+        proc.stdout.setEncoding("utf-8");
+        proc.stdout.on("data", (raw) => {
+            stdoutBuf += typeof raw === "string" ? raw : raw.toString("utf-8");
+            let nlIdx = stdoutBuf.indexOf("\n");
+            while (nlIdx >= 0) {
+                const lineRaw = stdoutBuf.slice(0, nlIdx);
+                stdoutBuf = stdoutBuf.slice(nlIdx + 1);
+                this.emitLine(lineRaw, sessionId, onChunk);
+                nlIdx = stdoutBuf.indexOf("\n");
+            }
+        });
+        proc.stdout.on("end", () => {
+            if (stdoutBuf.length > 0) {
+                this.emitLine(stdoutBuf, sessionId, onChunk);
+                stdoutBuf = "";
+            }
+        });
+        // stderr is best-effort diagnostics; we surface it as a single error
+        // chunk only if the process exits non-zero.
+        let stderrBuf = "";
+        proc.stderr.setEncoding("utf-8");
+        proc.stderr.on("data", (raw) => {
+            stderrBuf += typeof raw === "string" ? raw : raw.toString("utf-8");
+        });
+        const exitCode = await new Promise((resolve) => {
+            proc.on("exit", (code) => resolve(typeof code === "number" ? code : -1));
+            proc.on("error", () => resolve(-1));
+        });
+        clearTimeout(killTimer);
+        const durationMs = Date.now() - startedAt;
+        this.abortFlags.delete(sessionId);
+        this.release();
+        this.totalCompleted++;
+        if (exitCode === 0) {
+            onChunk({ type: "done", meta: { sessionId, exitCode, latencyMs: durationMs } });
+        }
+        else {
+            const tail = stderrBuf.trim().split(/\r?\n/).slice(-3).join(" | ");
+            onChunk({
+                type: "error",
+                error: {
+                    message: tail || `roy-agent act exited with code ${exitCode}`,
+                    code: `exit_${exitCode}`,
+                },
+            });
+            onChunk({ type: "done", meta: { sessionId, exitCode, latencyMs: durationMs } });
+        }
+        return { exitCode, durationMs };
+    }
+    emitLine(line, _sessionId, onChunk) {
+        const trimmed = stripAnsi(line).replace(/\s+$/, "");
+        if (trimmed.length === 0)
+            return;
+        if (trimmed === "[TaskEventHandler] Started" ||
+            trimmed === "[TaskEventHandler] Stopped") {
+            return;
+        }
+        if (trimmed.startsWith(REASONING_OPEN)) {
+            onChunk({ type: "reasoning", text: trimmed });
+            return;
+        }
+        onChunk({ type: "text", text: trimmed });
+    }
+    /** Abort an in-flight query (best-effort SIGTERM). */
+    abort(sessionId) {
+        const ctrl = this.abortFlags.get(sessionId);
+        if (ctrl)
+            ctrl.abort();
+    }
+    /** Stats for monitoring / health endpoints. */
+    stats() {
+        return {
+            active: this.active,
+            queued: this.queue.length,
+            totalCompleted: this.totalCompleted,
+        };
+    }
+}
+//# sourceMappingURL=chat-process-manager.js.map

package/dist/chat-process-manager.js.map

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

package/dist/server.d.ts

@@ -94,6 +94,8 @@ export declare 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. */
     private readonly sessionStore;
+    /** v2.5.0+: ChatProcessManager singleton (null when chat is disabled). */
+    private readonly chatManager;
     constructor(opts: {
         cfg: TaskShowConfig;
         collector: ToolCallCollector;
@@ -115,6 +117,19 @@ export declare class TaskShowServer {
         sessionStore?: TaskSessionStore;
         /** v1.1.0+: plugin version stamped on every SSE event we broadcast. */
         pluginVersion?: string;
+        /**
+         * v2.5.0+: chat feature config. When `chatOptions.enabled` is true
+         * (default), the server mounts `/api/chat/*` routes and renders the
+         * home chat panel. When false, the chat UI is hidden and the API
+         * endpoints return 503 — useful for environments without a built
+         * `roy-agent` CLI on disk.
+         */
+        chatOptions?: {
+            cliPath: string;
+            maxConcurrent?: number;
+            defaultTimeoutMs?: number;
+            enabled?: boolean;
+        };
     });
     /**
      * Get the SSE event bus (for tests / health checks).
@@ -171,6 +186,46 @@ export declare class TaskShowServer {
      *    directories (defaults to cwd + $HOME; configurable via
      *    `ts.config.fileSandboxPaths`).
      */
+    /**
+     * 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).
+     */
+    private handleChatStart;
+    /**
+     * 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).
+     */
+    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