pi-forge 1.2.3 → 1.2.5

package/dist/server/processes/tool.js

@@ -0,0 +1,273 @@
+import { Type } from "typebox";
+import { config } from "../config.js";
+import { buildListMessage, buildStartMessage, err, ok } from "./envelope.js";
+import { processManager } from "./manager.js";
+import { PROMPT_GUIDELINES, PROMPT_SNIPPET, TOOL_DESCRIPTION } from "./prompt-strings.js";
+import { TOOL_LABEL, TOOL_NAME, } from "./types.js";
+/**
+ * JSON Schema for `process` tool params. Mirrors `@aliou/pi-processes`'s
+ * TypeBox schema field-for-field so an agent prompt authored
+ * against the plugin sees the same input surface.
+ */
+const inputSchema = {
+    type: "object",
+    required: ["action"],
+    properties: {
+        action: {
+            type: "string",
+            enum: ["start", "list", "output", "logs", "kill", "clear", "write"],
+        },
+        command: { type: "string", description: "Command to run (required for start)" },
+        name: {
+            type: "string",
+            description: "Friendly name for the process (required for start, e.g. 'backend-dev', 'test-runner')",
+        },
+        id: {
+            type: "string",
+            description: "Process ID, returned by start and list actions (required for output/kill/logs/write)",
+        },
+        input: {
+            type: "string",
+            description: "Data to write to process stdin (required for write action)",
+        },
+        end: {
+            type: "boolean",
+            description: "Close stdin after writing (optional for write action, use for programs reading until EOF)",
+        },
+        alertOnSuccess: {
+            type: "boolean",
+            description: "Get a turn to react when process completes successfully (default: false). Use for builds/tests where you need confirmation.",
+        },
+        alertOnFailure: {
+            type: "boolean",
+            description: "Get a turn to react when process fails/crashes (default: true). Use to be alerted of unexpected failures.",
+        },
+        alertOnKill: {
+            type: "boolean",
+            description: "Get a turn to react when process is killed by external signal (default: false). Note: killing via tool never triggers a turn.",
+        },
+        logWatches: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["pattern"],
+                additionalProperties: false,
+                properties: {
+                    pattern: {
+                        type: "string",
+                        description: "Regular expression pattern to match against process output lines",
+                    },
+                    stream: {
+                        type: "string",
+                        enum: ["stdout", "stderr", "both"],
+                        description: "Which stream to watch (default: both). Use stdout/stderr to reduce noise.",
+                    },
+                    repeat: {
+                        type: "boolean",
+                        description: "Trigger every time this pattern matches (default: false, one-time)",
+                    },
+                },
+            },
+        },
+    },
+};
+function validateLogWatches(watches) {
+    if (watches === undefined)
+        return null;
+    if (!Array.isArray(watches))
+        return "Invalid parameter: logWatches must be an array";
+    for (const [i, w] of watches.entries()) {
+        if (typeof w.pattern !== "string" || w.pattern.trim().length === 0) {
+            return `Invalid logWatches[${i}].pattern: expected non-empty string`;
+        }
+        try {
+            new RegExp(w.pattern);
+        }
+        catch (e) {
+            return `Invalid logWatches[${i}].pattern: ${e instanceof Error ? e.message : "invalid regex"}`;
+        }
+        if (w.stream !== undefined && !["stdout", "stderr", "both"].includes(w.stream)) {
+            return `Invalid logWatches[${i}].stream: expected stdout, stderr, or both`;
+        }
+        if (w.repeat !== undefined && typeof w.repeat !== "boolean") {
+            return `Invalid logWatches[${i}].repeat: expected boolean`;
+        }
+    }
+    return null;
+}
+/**
+ * Build the `process` tool for one session. Bound to the
+ * sessionId + workspace path so `start` knows the right cwd and
+ * the manager keys state correctly.
+ *
+ * Contract-compatible with `@aliou/pi-processes`. Implementation
+ * is independent; see `manager.ts` for the spawn/lifecycle code
+ * and `docs/processes.md` for the cross-reference.
+ */
+export function createProcessTool(sessionId, workspacePath) {
+    return {
+        name: TOOL_NAME,
+        label: TOOL_LABEL,
+        description: TOOL_DESCRIPTION,
+        promptSnippet: PROMPT_SNIPPET,
+        promptGuidelines: PROMPT_GUIDELINES,
+        parameters: Type.Unsafe(inputSchema),
+        async execute(_toolCallId, params) {
+            const p = params;
+            switch (p.action) {
+                case "start":
+                    return executeStart(sessionId, workspacePath, p);
+                case "list":
+                    return executeList(sessionId);
+                case "output":
+                    return executeOutput(sessionId, p);
+                case "logs":
+                    return executeLogs(sessionId, p);
+                case "kill":
+                    return executeKill(sessionId, p);
+                case "clear":
+                    return executeClear(sessionId);
+                case "write":
+                    return executeWrite(sessionId, p);
+                default:
+                    return err(p.action, `Unknown action: ${String(p.action)}`);
+            }
+        },
+    };
+}
+function executeStart(sessionId, workspacePath, p) {
+    // Defense in depth — the client also hides the tool under
+    // MINIMAL_UI, but a stale tab or scripted caller could still
+    // invoke it. Refuse at the tool boundary.
+    if (config.minimalUi) {
+        return err("start", "process.start is disabled under MINIMAL_UI");
+    }
+    if (p.name === undefined || p.name.length === 0) {
+        return err("start", "Missing required parameter: name");
+    }
+    if (p.command === undefined || p.command.length === 0) {
+        return err("start", "Missing required parameter: command");
+    }
+    const watchErr = validateLogWatches(p.logWatches);
+    if (watchErr !== null)
+        return err("start", watchErr);
+    let info;
+    try {
+        const startOpts = {};
+        if (p.alertOnSuccess !== undefined)
+            startOpts.alertOnSuccess = p.alertOnSuccess;
+        if (p.alertOnFailure !== undefined)
+            startOpts.alertOnFailure = p.alertOnFailure;
+        if (p.alertOnKill !== undefined)
+            startOpts.alertOnKill = p.alertOnKill;
+        if (p.logWatches !== undefined)
+            startOpts.logWatches = p.logWatches;
+        info = processManager.start(sessionId, p.name, p.command, workspacePath, startOpts);
+    }
+    catch (e) {
+        return err("start", `Failed to start: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    return ok({
+        action: "start",
+        success: true,
+        message: buildStartMessage(info),
+        process: info,
+    });
+}
+function executeList(sessionId) {
+    const processes = processManager.list(sessionId);
+    return ok({
+        action: "list",
+        success: true,
+        message: buildListMessage(processes),
+        processes,
+    });
+}
+function executeOutput(sessionId, p) {
+    if (p.id === undefined || p.id.length === 0) {
+        return err("output", "Missing required parameter: id");
+    }
+    const out = processManager.output(sessionId, p.id);
+    if (out === undefined)
+        return err("output", `Process not found: ${p.id}`);
+    const stdoutTail = out.stdout.slice(Math.max(0, out.stdout.length - 50)).join("\n");
+    const stderrTail = out.stderr.slice(Math.max(0, out.stderr.length - 50)).join("\n");
+    const parts = [`Status: ${out.status}`];
+    if (stdoutTail.length > 0)
+        parts.push("--- stdout ---", stdoutTail);
+    if (stderrTail.length > 0)
+        parts.push("--- stderr ---", stderrTail);
+    return ok({
+        action: "output",
+        success: true,
+        message: parts.join("\n"),
+        output: out,
+    });
+}
+function executeLogs(sessionId, p) {
+    if (p.id === undefined || p.id.length === 0) {
+        return err("logs", "Missing required parameter: id");
+    }
+    const files = processManager.logFiles(sessionId, p.id);
+    if (files === undefined)
+        return err("logs", `Process not found: ${p.id}`);
+    return ok({
+        action: "logs",
+        success: true,
+        message: `Log files for ${p.id}:\n  stdout: ${files.stdoutFile}\n  stderr: ${files.stderrFile}\n\nUse the read tool to inspect them.`,
+        logFiles: files,
+    });
+}
+async function executeKill(sessionId, p) {
+    if (p.id === undefined || p.id.length === 0) {
+        return err("kill", "Missing required parameter: id");
+    }
+    const result = await processManager.kill(sessionId, p.id);
+    if (!result.ok) {
+        if (result.reason === "not_found") {
+            return err("kill", `Process not found: ${p.id}`);
+        }
+        return err("kill", `Failed to kill ${p.id}: ${result.reason}`);
+    }
+    return ok({
+        action: "kill",
+        success: true,
+        message: `Killed "${result.info.name}" (${result.info.id})`,
+        process: result.info,
+    });
+}
+function executeClear(sessionId) {
+    const cleared = processManager.clear(sessionId);
+    return ok({
+        action: "clear",
+        success: true,
+        message: `Cleared ${cleared} finished process(es)`,
+        cleared,
+    });
+}
+async function executeWrite(sessionId, p) {
+    if (p.id === undefined || p.id.length === 0) {
+        return err("write", "Missing required parameter: id");
+    }
+    if (p.input === undefined) {
+        return err("write", "Missing required parameter: input");
+    }
+    const result = await processManager.write(sessionId, p.id, p.input, p.end === true);
+    if (!result.ok) {
+        const reason = result.reason;
+        const message = reason === "not_found"
+            ? `Process not found: ${p.id}`
+            : reason === "process_exited"
+                ? `Process ${p.id} has already exited`
+                : reason === "stdin_closed"
+                    ? `stdin for ${p.id} is already closed`
+                    : `Failed to write to ${p.id}`;
+        return err("write", message);
+    }
+    return ok({
+        action: "write",
+        success: true,
+        message: p.end === true ? `Wrote to ${p.id} and closed stdin` : `Wrote to ${p.id}`,
+    });
+}
+//# sourceMappingURL=tool.js.map

package/dist/server/processes/tool.js.map

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

package/dist/server/processes/types.js

@@ -0,0 +1,21 @@
+/**
+ * Shape definitions for the `process` tool. The wire contract —
+ * tool name (`process`), action enum (`start | list | output |
+ * logs | kill | clear | write`), per-process `ProcessInfo`
+ * fields, status state machine, log-watch shape, and
+ * `ProcessesDetails` envelope — is contract-compatible with
+ * `@aliou/pi-processes`. An agent prompt authored against the
+ * plugin works against this implementation unchanged.
+ *
+ * Implementation is independent; types and validation rules were
+ * derived from the plugin's published schema and tests. See
+ * `docs/processes.md` for the cross-reference.
+ */
+export const TOOL_NAME = "process";
+export const TOOL_LABEL = "Process";
+export const LIVE_STATUSES = new Set([
+    "running",
+    "terminating",
+    "terminate_timeout",
+]);
+//# sourceMappingURL=types.js.map

package/dist/server/processes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/processes/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC;AACnC,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AAYpC,MAAM,CAAC,MAAM,aAAa,GAA+B,IAAI,GAAG,CAAC;IAC/D,SAAS;IACT,aAAa;IACb,mBAAmB;CACpB,CAAC,CAAC"}

package/dist/server/processes/watches.js

@@ -0,0 +1,59 @@
+/**
+ * Compile the agent-supplied watches. Validation lives at the
+ * tool boundary (see tool.ts); this function trusts shape +
+ * regex validity and just normalises defaults.
+ */
+export function compileWatches(input) {
+    if (input === undefined)
+        return [];
+    return input.map((w, i) => ({
+        index: i,
+        pattern: w.pattern,
+        stream: w.stream ?? "both",
+        repeat: w.repeat === true,
+        regex: new RegExp(w.pattern),
+        fired: false,
+    }));
+}
+/**
+ * Run a freshly-emitted line against the compiled set. Returns
+ * the watches that matched AND are eligible to fire (skipping
+ * single-fire watches that already fired). Mutates `fired` for
+ * matched single-fire watches so the same line stream of repeats
+ * doesn't keep alerting.
+ */
+export function evaluateWatches(watches, source, line) {
+    const hits = [];
+    for (const w of watches) {
+        if (w.stream !== "both" && w.stream !== source)
+            continue;
+        if (!w.repeat && w.fired)
+            continue;
+        if (!w.regex.test(line))
+            continue;
+        if (!w.repeat)
+            w.fired = true;
+        hits.push(w);
+    }
+    return hits;
+}
+/**
+ * Build the wire shape for a single match. Used by the manager
+ * when it fans out a `process_watch_matched` event.
+ */
+export function buildMatchEvent(watch, processId, processName, processCommand, source, line) {
+    return {
+        processId,
+        processName,
+        processCommand,
+        source,
+        line,
+        watch: {
+            index: watch.index,
+            pattern: watch.pattern,
+            stream: watch.stream,
+            repeat: watch.repeat,
+        },
+    };
+}
+//# sourceMappingURL=watches.js.map

package/dist/server/processes/watches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watches.js","sourceRoot":"","sources":["../../src/processes/watches.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAsC;IACnE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,MAAM;QAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI;QACzB,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5B,KAAK,EAAE,KAAK;KACb,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAwB,EACxB,MAA2B,EAC3B,IAAY;IAEZ,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS;QACzD,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK;YAAE,SAAS;QACnC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,CAAC,CAAC,MAAM;YAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAoB,EACpB,SAAiB,EACjB,WAAmB,EACnB,cAAsB,EACtB,MAA2B,EAC3B,IAAY;IAEZ,OAAO;QACL,SAAS;QACT,WAAW;QACX,cAAc;QACd,MAAM;QACN,IAAI;QACJ,KAAK,EAAE;YACL,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB;KACF,CAAC;AACJ,CAAC"}

package/dist/server/quick-actions.js

@@ -0,0 +1,141 @@
+import { mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { randomUUID } from "node:crypto";
+import { config } from "./config.js";
+export class QuickActionNotFoundError extends Error {
+    constructor(id) {
+        super(`quick action not found: ${id}`);
+        this.name = "QuickActionNotFoundError";
+    }
+}
+/** Hard cap on a single command string. Mirrors the system-prompt
+ * addendum cap — large enough for a multi-line shell snippet, small
+ * enough to keep the wire surface bounded. */
+export const MAX_COMMAND_BYTES = 20_000;
+/** Hard cap on a single prompt template. Pi compaction lives further
+ * down the stack, but bounding here keeps an accidental megabyte paste
+ * from silently landing in the composer. */
+export const MAX_PROMPT_BYTES = 50_000;
+/** Default command timeout (30 s) and absolute ceiling (5 min). A
+ * five-minute build is the upper end of "still feels like a chip";
+ * past that, the user should be using the terminal. */
+export const DEFAULT_TIMEOUT_MS = 30_000;
+export const MAX_TIMEOUT_MS = 300_000;
+export function isCommandAction(a) {
+    return typeof a.command === "string" && a.command.length > 0;
+}
+export function isPromptAction(a) {
+    return typeof a.text === "string" && a.text.length > 0;
+}
+async function ensureDir() {
+    await mkdir(dirname(config.quickActionsFile), { recursive: true });
+}
+async function atomicWrite(actions) {
+    await ensureDir();
+    const target = config.quickActionsFile;
+    const tmp = `${target}.${randomUUID()}.tmp`;
+    await writeFile(tmp, JSON.stringify(actions, null, 2), { mode: 0o600 });
+    try {
+        await rename(tmp, target);
+    }
+    catch (err) {
+        await unlink(tmp).catch(() => undefined);
+        throw err;
+    }
+}
+function isAction(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const r = v;
+    if (typeof r.id !== "string" || typeof r.name !== "string")
+        return false;
+    const hasCmd = typeof r.command === "string" && r.command.length > 0;
+    const hasText = typeof r.text === "string" && r.text.length > 0;
+    // Drop entries that look corrupted (neither kind, or both) rather
+    // than surfacing them to the route layer, which would have to
+    // re-validate. Strict-on-read keeps the in-memory shape clean.
+    return hasCmd !== hasText;
+}
+/**
+ * Serialise all read-modify-write sequences over quick-actions.json
+ * — same pattern as projects.json. Without it, concurrent
+ * POST /quick-actions calls can race the rename().
+ */
+let lock = Promise.resolve();
+function withLock(fn) {
+    const next = lock.then(fn, fn);
+    lock = next.catch(() => undefined);
+    return next;
+}
+export async function readQuickActions() {
+    try {
+        const raw = await readFile(config.quickActionsFile, "utf8");
+        if (raw.trim().length === 0)
+            return [];
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter(isAction);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+}
+export async function getQuickAction(id) {
+    const list = await readQuickActions();
+    return list.find((a) => a.id === id);
+}
+/**
+ * Create a new action. The caller (route layer) is responsible for
+ * shape validation (one-of command/text, byte caps, etc.) — this
+ * function only assigns the id and persists.
+ */
+export async function createQuickAction(input) {
+    return withLock(async () => {
+        const list = await readQuickActions();
+        const action = { ...input, id: randomUUID() };
+        list.push(action);
+        await atomicWrite(list);
+        return action;
+    });
+}
+export async function updateQuickAction(id, patch) {
+    return withLock(async () => {
+        const list = await readQuickActions();
+        const idx = list.findIndex((a) => a.id === id);
+        if (idx === -1)
+            throw new QuickActionNotFoundError(id);
+        const existing = list[idx];
+        if (existing === undefined)
+            throw new QuickActionNotFoundError(id);
+        // Build the merged record explicitly so a switch from command to
+        // prompt (or vice-versa) drops the now-unused fields rather than
+        // carrying them as dead weight. The caller passes the FULL desired
+        // shape on every update; the patch arg is union-typed for ergonomic
+        // partial calls but the route layer always sends the complete form.
+        const merged = { ...existing, ...patch, id };
+        if (typeof patch.command === "string" && patch.command.length > 0) {
+            delete merged.text;
+            delete merged.mode;
+        }
+        else if (typeof patch.text === "string" && patch.text.length > 0) {
+            delete merged.command;
+            delete merged.timeoutMs;
+        }
+        list[idx] = merged;
+        await atomicWrite(list);
+        return merged;
+    });
+}
+export async function deleteQuickAction(id) {
+    await withLock(async () => {
+        const list = await readQuickActions();
+        const next = list.filter((a) => a.id !== id);
+        if (next.length === list.length)
+            throw new QuickActionNotFoundError(id);
+        await atomicWrite(next);
+    });
+}
+//# sourceMappingURL=quick-actions.js.map

package/dist/server/quick-actions.js.map

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

package/dist/server/routes/ask-user-question.js

@@ -0,0 +1,129 @@
+import { getSession } from "../session-registry.js";
+import { answerPending, getPendingForSession } from "../ask-user-question/registry.js";
+import { buildResult } from "../ask-user-question/envelope.js";
+import { errorSchema } from "./_schemas.js";
+/**
+ * POST /sessions/:id/ask-user-question/answer
+ *
+ * The browser modal calls this with the user's answers (or with
+ * `cancelled: true` when they pick "Chat about this" / close the
+ * modal). Resolves the pending entry in the registry, which
+ * propagates back to the tool's awaiting `execute()` — the agent
+ * gets a clean tool result and continues.
+ *
+ * Per-call ownership is enforced by matching `requestId` against
+ * this session's pending list. A spoofed requestId from a session
+ * the caller doesn't own returns 404.
+ */
+const answerBodySchema = {
+    type: "object",
+    required: ["requestId"],
+    additionalProperties: false,
+    properties: {
+        requestId: { type: "string", minLength: 1 },
+        cancelled: { type: "boolean" },
+        answers: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["questionIndex", "question", "kind"],
+                properties: {
+                    questionIndex: { type: "integer", minimum: 0 },
+                    question: { type: "string" },
+                    kind: { type: "string", enum: ["option", "custom", "chat", "multi"] },
+                    answer: { type: ["string", "null"] },
+                    selected: { type: "array", items: { type: "string" } },
+                    notes: { type: "string" },
+                    preview: { type: "string" },
+                },
+            },
+        },
+    },
+};
+export const askUserQuestionRoutes = async (fastify) => {
+    fastify.get("/sessions/:id/ask-user-question/pending", {
+        schema: {
+            description: "List ask_user_question requests currently waiting on an answer " +
+                "for this session. The browser modal uses this on initial mount " +
+                "as a fallback to the SSE snapshot re-delivery path.",
+            tags: ["sessions"],
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+            response: {
+                200: {
+                    type: "object",
+                    required: ["pending"],
+                    properties: {
+                        pending: {
+                            type: "array",
+                            items: {
+                                type: "object",
+                                required: ["requestId", "questions"],
+                                properties: {
+                                    requestId: { type: "string" },
+                                    questions: { type: "array" },
+                                },
+                            },
+                        },
+                    },
+                },
+                404: errorSchema,
+            },
+        },
+    }, async (req, reply) => {
+        const live = getSession(req.params.id);
+        if (live === undefined) {
+            return reply.code(404).send({ error: "session_not_found" });
+        }
+        const pending = getPendingForSession(req.params.id).map((p) => ({
+            requestId: p.requestId,
+            questions: p.questions,
+        }));
+        return { pending };
+    });
+    fastify.post("/sessions/:id/ask-user-question/answer", {
+        schema: {
+            description: "Submit a user's answers to an in-flight ask_user_question " +
+                "tool call. Pass `cancelled: true` (with or without partial " +
+                "answers) when the user dismissed the modal or picked the " +
+                "'Chat about this' escape. The tool's execute() resolves " +
+                "with the constructed envelope; the agent then continues.",
+            tags: ["sessions"],
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+            body: answerBodySchema,
+            response: {
+                204: { type: "null" },
+                404: errorSchema,
+            },
+        },
+    }, async (req, reply) => {
+        const live = getSession(req.params.id);
+        if (live === undefined) {
+            return reply.code(404).send({ error: "session_not_found" });
+        }
+        const cancelled = req.body.cancelled === true;
+        const answers = Array.isArray(req.body.answers) ? req.body.answers : [];
+        // Total question count is whatever the registry has on file —
+        // the envelope's "partial cancel" summary line reads it from
+        // here to phrase correctly. Look it up before answering since
+        // the registry entry vanishes on resolve.
+        const pending = getPendingForSession(req.params.id).find((p) => p.requestId === req.body.requestId);
+        const questionCount = pending?.questions.length ?? answers.length;
+        const envelope = buildResult(answers, { cancelled, questionCount });
+        const ok = answerPending(req.body.requestId, req.params.id, envelope);
+        if (!ok) {
+            // Either unknown requestId or one that belongs to another
+            // session (defense against cross-session spoofing).
+            return reply.code(404).send({ error: "request_not_found" });
+        }
+        return reply.code(204).send();
+    });
+};
+//# sourceMappingURL=ask-user-question.js.map