@ashx-j/lunr-dev 0.2.19-dev.10.1 → 0.2.21-dev.12.1

package/dist/builtin-extensions/pi-subagents/src/intercom/supervisor-ask.d.ts

@@ -0,0 +1,29 @@
+import type { AgentToolResult } from "@ashx-j/lunr-agent";
+import type { AsyncStatus, SubagentState } from "../shared/types.ts";
+import { type SupervisorQuestion } from "./supervisor-questions.ts";
+export interface ParentAskParams {
+    id?: string;
+    index?: number;
+    childId?: string;
+    reason?: string;
+    message?: string;
+}
+export interface ParentAskRequestFile {
+    expectsReply?: boolean;
+    runId?: string;
+    childIndex?: number;
+    agent?: string;
+    childTarget?: string;
+}
+export declare function resolveAskChild(status: AsyncStatus, params: Pick<ParentAskParams, "index" | "childId">): {
+    index: number;
+    childId: string;
+    agent: string;
+};
+export declare function reconcileAsyncQuestion(channelDir: string, question: SupervisorQuestion, state: SubagentState): SupervisorQuestion;
+export declare function askRunningAsyncChild(input: {
+    params: ParentAskParams;
+    state: SubagentState;
+    childRequests?: Iterable<ParentAskRequestFile>;
+}): AgentToolResult<Record<string, unknown>>;
+//# sourceMappingURL=supervisor-ask.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/intercom/supervisor-ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-ask.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/intercom/supervisor-ask.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIrE,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAYN,KAAK,kBAAkB,EACvB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,eAAe;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAcD,wBAAgB,eAAe,CAC9B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC,GAChD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA+BnD;AAYD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,aAAa,GAAG,kBAAkB,CAmBjI;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC3C,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,CAAC,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;CAC/C,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8E3C","sourcesContent":["import type { AgentToolResult } from \"@ashx-j/lunr-agent\";\nimport { readSteerCapability, requestAsyncSteer } from \"../runs/background/control-channel.ts\";\nimport { resolveSubagentRunId } from \"../runs/background/run-id-resolver.ts\";\nimport { readStatus } from \"../shared/utils.ts\";\nimport type { AsyncStatus, SubagentState } from \"../shared/types.ts\";\nimport {\n\tcancelSupervisorQuestion,\n\tcreateSupervisorQuestion,\n\tformatParentQuestionForChild,\n\texpireSupervisorQuestion,\n\thasOutstandingQuestionForChild,\n\thasBlockingSupervisorRequest,\n\tincarnationMatches,\n\treadSupervisorQuestion,\n\tsupervisorQuestionIsTerminal,\n\tresolveSupervisorChannelDir,\n\ttype SupervisorChildIncarnation,\n\ttype SupervisorQuestion,\n} from \"./supervisor-questions.ts\";\n\nexport interface ParentAskParams {\n\tid?: string;\n\tindex?: number;\n\tchildId?: string;\n\treason?: string;\n\tmessage?: string;\n}\n\nexport interface ParentAskRequestFile {\n\texpectsReply?: boolean;\n\trunId?: string;\n\tchildIndex?: number;\n\tagent?: string;\n\tchildTarget?: string;\n}\n\nfunction runningSteps(status: AsyncStatus): Array<{ index: number; childId: string; agent: string }> {\n\treturn (status.steps ?? [])\n\t\t.map((step, index) => ({\n\t\t\tindex,\n\t\t\tchildId: step.childId ?? step.agent,\n\t\t\tagent: step.agent,\n\t\t\tstatus: step.status,\n\t\t}))\n\t\t.filter((step) => step.status === \"running\")\n\t\t.map((step) => ({ index: step.index, childId: step.childId, agent: step.agent }));\n}\n\nexport function resolveAskChild(\n\tstatus: AsyncStatus,\n\tparams: Pick<ParentAskParams, \"index\" | \"childId\">,\n): { index: number; childId: string; agent: string } {\n\tif (params.index !== undefined && (!Number.isInteger(params.index) || params.index < 0)) {\n\t\tthrow new Error(\"index must be a non-negative integer.\");\n\t}\n\tconst running = runningSteps(status);\n\tif (params.childId?.trim()) {\n\t\tconst childId = params.childId.trim();\n\t\tconst matches = (status.steps ?? [])\n\t\t\t.map((step, index) => ({ index, childId: step.childId ?? step.agent, agent: step.agent, status: step.status }))\n\t\t\t.filter((step) => step.childId === childId);\n\t\tif (matches.length === 0) throw new Error(`Async run '${status.runId}' has no child '${childId}'.`);\n\t\tif (matches.length > 1) throw new Error(`Async run '${status.runId}' has multiple children named '${childId}'. Pass index.`);\n\t\tconst match = matches[0]!;\n\t\tif (params.index !== undefined && params.index !== match.index) {\n\t\t\tthrow new Error(`Child '${childId}' is index ${match.index}, not ${params.index}.`);\n\t\t}\n\t\tif (match.status !== \"running\") throw new Error(`Async run '${status.runId}' child ${match.index} is ${match.status} and cannot be asked.`);\n\t\treturn { index: match.index, childId: match.childId, agent: match.agent };\n\t}\n\tif (params.index !== undefined) {\n\t\tconst steps = status.steps ?? [];\n\t\tif (params.index >= steps.length) {\n\t\t\tthrow new Error(`Async run '${status.runId}' has ${steps.length} children. Index ${params.index} is out of range.`);\n\t\t}\n\t\tconst step = steps[params.index]!;\n\t\tif (step.status !== \"running\") throw new Error(`Async run '${status.runId}' child ${params.index} is ${step.status} and cannot be asked.`);\n\t\treturn { index: params.index, childId: step.childId ?? step.agent, agent: step.agent };\n\t}\n\tif (running.length === 1) return running[0]!;\n\tif (running.length === 0) throw new Error(`Async run '${status.runId}' has no running child to ask.`);\n\tthrow new Error(`Async run '${status.runId}' has ${running.length} running children. Pass index or childId; broadcast asks are not supported.`);\n}\n\nfunction requestMatchesChild(request: ParentAskRequestFile, runId: string, child: { index: number; childId: string; agent: string }): boolean {\n\tif (!request.expectsReply) return false;\n\tif (typeof request.runId !== \"string\" || request.runId !== runId) return false;\n\tconst indexMatches = Number.isInteger(request.childIndex) && request.childIndex === child.index;\n\tconst idMatches = request.agent === child.childId\n\t\t|| request.agent === child.agent\n\t\t|| request.childTarget === child.childId;\n\treturn indexMatches && idMatches;\n}\n\nexport function reconcileAsyncQuestion(channelDir: string, question: SupervisorQuestion, state: SubagentState): SupervisorQuestion {\n\texpireSupervisorQuestion(channelDir, question.id);\n\tconst current = readSupervisorQuestion(channelDir, question.id) ?? question;\n\tif (supervisorQuestionIsTerminal(current)) return current;\n\tconst resolved = resolveSubagentRunId(current.runId, { state });\n\tif (resolved?.kind !== \"async\" || !resolved.location.asyncDir) return current;\n\tconst status = readStatus(resolved.location.asyncDir);\n\tif (!status) return current;\n\tconst step = status.steps?.[current.childIndex];\n\tconst capability = readSteerCapability(resolved.location.asyncDir, current.childIndex);\n\tlet reason: string | undefined;\n\tif (status.sessionId !== current.parentSessionId) reason = \"async run ownership changed\";\n\telse if (status.state !== \"running\" || !step || step.status !== \"running\") reason = \"target child is no longer running\";\n\telse if ((step.childId ?? step.agent) !== current.childId) reason = \"target child identity changed\";\n\telse if (capability && !incarnationMatches(current.childIncarnation, capability)) reason = \"target child process changed\";\n\telse if (capability && !capability.supported) reason = \"target child no longer accepts questions\";\n\tconst delivery = status.steering?.recent.find((request) => request.id === current.id)?.targets.find((target) => target.index === current.childIndex);\n\tif (delivery?.state === \"failed\" || delivery?.state === \"late\") reason = delivery.reason ?? \"question delivery failed\";\n\treturn reason ? cancelSupervisorQuestion(channelDir, current.id, reason) ?? current : current;\n}\n\nexport function askRunningAsyncChild(input: {\n\tparams: ParentAskParams;\n\tstate: SubagentState;\n\tchildRequests?: Iterable<ParentAskRequestFile>;\n}): AgentToolResult<Record<string, unknown>> {\n\tconst runId = input.params.id?.trim();\n\tif (!runId) throw new Error(\"action='ask' requires id for the async run.\");\n\tconst reason = input.params.reason?.trim();\n\tconst message = input.params.message?.trim();\n\tif (!reason) throw new Error(\"action='ask' requires reason naming the concrete decision the child's answer will change.\");\n\tif (!message) throw new Error(\"action='ask' requires message.\");\n\tconst sessionId = input.state.currentSessionId;\n\tif (!sessionId) throw new Error(\"action='ask' requires an active session identity.\");\n\n\tconst resolved = resolveSubagentRunId(runId, { state: input.state });\n\tif (!resolved) throw new Error(`No async run matched '${runId}'.`);\n\tif (resolved.kind !== \"async\") throw new Error(\"action='ask' targets a running async child only. It does not revive, reassign, or broadcast.\");\n\tif (!resolved.location.asyncDir) throw new Error(`Async run '${resolved.id}' has no live run directory.`);\n\n\tconst status = readStatus(resolved.location.asyncDir);\n\tif (!status) throw new Error(`Async run '${resolved.id}' has no status.`);\n\tif (!status.sessionId || status.sessionId !== sessionId) {\n\t\tthrow new Error(`Async run '${resolved.id}' was not found in the active session.`);\n\t}\n\tif (status.state !== \"running\") throw new Error(`Async run '${resolved.id}' is ${status.state} and cannot be asked.`);\n\n\tconst child = resolveAskChild(status, input.params);\n\tconst channelDir = resolveSupervisorChannelDir(status.runId, child.childId, child.index);\n\tif (hasOutstandingQuestionForChild(channelDir, child.index, child.childId)) {\n\t\tthrow new Error(`A question is already outstanding for async run '${status.runId}' child ${child.index}. Wait for that answer or expiry before asking again.`);\n\t}\n\tfor (const request of input.childRequests ?? []) {\n\t\tif (requestMatchesChild(request, status.runId, child)) {\n\t\t\tthrow new Error(`Child ${child.index} is waiting for a supervisor reply. Asking now would deadlock. Reply to the child request first.`);\n\t\t}\n\t}\n\n\tif (hasBlockingSupervisorRequest(channelDir, status.runId, child.index)) {\n\t\tthrow new Error(\"Child is waiting for a supervisor reply. Reply to its request before asking a question.\");\n\t}\n\tconst capability = readSteerCapability(resolved.location.asyncDir, child.index);\n\tif (!capability?.supported) {\n\t\tthrow new Error(\"This child is not ready to receive questions. Continue other work until it is ready; no question was queued.\");\n\t}\n\tconst incarnation: SupervisorChildIncarnation = { pid: capability.pid, readyAt: capability.readyAt };\n\tconst question: SupervisorQuestion = createSupervisorQuestion({\n\t\tchannelDir,\n\t\treason,\n\t\tmessage,\n\t\trunId: status.runId,\n\t\tchildIndex: child.index,\n\t\tchildId: child.childId,\n\t\tparentSessionId: sessionId,\n\t\tparentGeneration: input.state.sessionGeneration ?? 0,\n\t\tchildIncarnation: incarnation,\n\t});\n\ttry {\n\t\tif (hasBlockingSupervisorRequest(channelDir, status.runId, child.index)) {\n\t\t\tthrow new Error(\"Child is waiting for a supervisor reply. Reply to its request before asking a question.\");\n\t\t}\n\t\trequestAsyncSteer(resolved.location.asyncDir, {\n\t\t\tmessage: formatParentQuestionForChild(question),\n\t\t\ttargetIndex: child.index,\n\t\t\tsource: \"supervisor-question\",\n\t\t\tid: question.id,\n\t\t});\n\t} catch (error) {\n\t\tcancelSupervisorQuestion(channelDir, question.id, \"failed to queue delivery to child\");\n\t\tthrow error instanceof Error ? error : new Error(String(error));\n\t}\n\treturn {\n\t\tcontent: [{ type: \"text\", text: `Question ${question.id} queued for async run ${status.runId} child ${child.index}. The child's answer is delivered separately from the run result.` }],\n\t\tdetails: {\n\t\t\tquestionId: question.id,\n\t\t\tstate: \"pending\",\n\t\t\trunId: status.runId,\n\t\t\tchildIndex: child.index,\n\t\t\tchildId: child.childId,\n\t\t\tdelivered: false,\n\t\t\tanswered: false,\n\t\t},\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/intercom/supervisor-ask.js

@@ -0,0 +1,179 @@
+import { readSteerCapability, requestAsyncSteer } from "../runs/background/control-channel.js";
+import { resolveSubagentRunId } from "../runs/background/run-id-resolver.js";
+import { readStatus } from "../shared/utils.js";
+import { cancelSupervisorQuestion, createSupervisorQuestion, formatParentQuestionForChild, expireSupervisorQuestion, hasOutstandingQuestionForChild, hasBlockingSupervisorRequest, incarnationMatches, readSupervisorQuestion, supervisorQuestionIsTerminal, resolveSupervisorChannelDir, } from "./supervisor-questions.js";
+function runningSteps(status) {
+    return (status.steps ?? [])
+        .map((step, index) => ({
+        index,
+        childId: step.childId ?? step.agent,
+        agent: step.agent,
+        status: step.status,
+    }))
+        .filter((step) => step.status === "running")
+        .map((step) => ({ index: step.index, childId: step.childId, agent: step.agent }));
+}
+export function resolveAskChild(status, params) {
+    if (params.index !== undefined && (!Number.isInteger(params.index) || params.index < 0)) {
+        throw new Error("index must be a non-negative integer.");
+    }
+    const running = runningSteps(status);
+    if (params.childId?.trim()) {
+        const childId = params.childId.trim();
+        const matches = (status.steps ?? [])
+            .map((step, index) => ({ index, childId: step.childId ?? step.agent, agent: step.agent, status: step.status }))
+            .filter((step) => step.childId === childId);
+        if (matches.length === 0)
+            throw new Error(`Async run '${status.runId}' has no child '${childId}'.`);
+        if (matches.length > 1)
+            throw new Error(`Async run '${status.runId}' has multiple children named '${childId}'. Pass index.`);
+        const match = matches[0];
+        if (params.index !== undefined && params.index !== match.index) {
+            throw new Error(`Child '${childId}' is index ${match.index}, not ${params.index}.`);
+        }
+        if (match.status !== "running")
+            throw new Error(`Async run '${status.runId}' child ${match.index} is ${match.status} and cannot be asked.`);
+        return { index: match.index, childId: match.childId, agent: match.agent };
+    }
+    if (params.index !== undefined) {
+        const steps = status.steps ?? [];
+        if (params.index >= steps.length) {
+            throw new Error(`Async run '${status.runId}' has ${steps.length} children. Index ${params.index} is out of range.`);
+        }
+        const step = steps[params.index];
+        if (step.status !== "running")
+            throw new Error(`Async run '${status.runId}' child ${params.index} is ${step.status} and cannot be asked.`);
+        return { index: params.index, childId: step.childId ?? step.agent, agent: step.agent };
+    }
+    if (running.length === 1)
+        return running[0];
+    if (running.length === 0)
+        throw new Error(`Async run '${status.runId}' has no running child to ask.`);
+    throw new Error(`Async run '${status.runId}' has ${running.length} running children. Pass index or childId; broadcast asks are not supported.`);
+}
+function requestMatchesChild(request, runId, child) {
+    if (!request.expectsReply)
+        return false;
+    if (typeof request.runId !== "string" || request.runId !== runId)
+        return false;
+    const indexMatches = Number.isInteger(request.childIndex) && request.childIndex === child.index;
+    const idMatches = request.agent === child.childId
+        || request.agent === child.agent
+        || request.childTarget === child.childId;
+    return indexMatches && idMatches;
+}
+export function reconcileAsyncQuestion(channelDir, question, state) {
+    expireSupervisorQuestion(channelDir, question.id);
+    const current = readSupervisorQuestion(channelDir, question.id) ?? question;
+    if (supervisorQuestionIsTerminal(current))
+        return current;
+    const resolved = resolveSubagentRunId(current.runId, { state });
+    if (resolved?.kind !== "async" || !resolved.location.asyncDir)
+        return current;
+    const status = readStatus(resolved.location.asyncDir);
+    if (!status)
+        return current;
+    const step = status.steps?.[current.childIndex];
+    const capability = readSteerCapability(resolved.location.asyncDir, current.childIndex);
+    let reason;
+    if (status.sessionId !== current.parentSessionId)
+        reason = "async run ownership changed";
+    else if (status.state !== "running" || !step || step.status !== "running")
+        reason = "target child is no longer running";
+    else if ((step.childId ?? step.agent) !== current.childId)
+        reason = "target child identity changed";
+    else if (capability && !incarnationMatches(current.childIncarnation, capability))
+        reason = "target child process changed";
+    else if (capability && !capability.supported)
+        reason = "target child no longer accepts questions";
+    const delivery = status.steering?.recent.find((request) => request.id === current.id)?.targets.find((target) => target.index === current.childIndex);
+    if (delivery?.state === "failed" || delivery?.state === "late")
+        reason = delivery.reason ?? "question delivery failed";
+    return reason ? cancelSupervisorQuestion(channelDir, current.id, reason) ?? current : current;
+}
+export function askRunningAsyncChild(input) {
+    const runId = input.params.id?.trim();
+    if (!runId)
+        throw new Error("action='ask' requires id for the async run.");
+    const reason = input.params.reason?.trim();
+    const message = input.params.message?.trim();
+    if (!reason)
+        throw new Error("action='ask' requires reason naming the concrete decision the child's answer will change.");
+    if (!message)
+        throw new Error("action='ask' requires message.");
+    const sessionId = input.state.currentSessionId;
+    if (!sessionId)
+        throw new Error("action='ask' requires an active session identity.");
+    const resolved = resolveSubagentRunId(runId, { state: input.state });
+    if (!resolved)
+        throw new Error(`No async run matched '${runId}'.`);
+    if (resolved.kind !== "async")
+        throw new Error("action='ask' targets a running async child only. It does not revive, reassign, or broadcast.");
+    if (!resolved.location.asyncDir)
+        throw new Error(`Async run '${resolved.id}' has no live run directory.`);
+    const status = readStatus(resolved.location.asyncDir);
+    if (!status)
+        throw new Error(`Async run '${resolved.id}' has no status.`);
+    if (!status.sessionId || status.sessionId !== sessionId) {
+        throw new Error(`Async run '${resolved.id}' was not found in the active session.`);
+    }
+    if (status.state !== "running")
+        throw new Error(`Async run '${resolved.id}' is ${status.state} and cannot be asked.`);
+    const child = resolveAskChild(status, input.params);
+    const channelDir = resolveSupervisorChannelDir(status.runId, child.childId, child.index);
+    if (hasOutstandingQuestionForChild(channelDir, child.index, child.childId)) {
+        throw new Error(`A question is already outstanding for async run '${status.runId}' child ${child.index}. Wait for that answer or expiry before asking again.`);
+    }
+    for (const request of input.childRequests ?? []) {
+        if (requestMatchesChild(request, status.runId, child)) {
+            throw new Error(`Child ${child.index} is waiting for a supervisor reply. Asking now would deadlock. Reply to the child request first.`);
+        }
+    }
+    if (hasBlockingSupervisorRequest(channelDir, status.runId, child.index)) {
+        throw new Error("Child is waiting for a supervisor reply. Reply to its request before asking a question.");
+    }
+    const capability = readSteerCapability(resolved.location.asyncDir, child.index);
+    if (!capability?.supported) {
+        throw new Error("This child is not ready to receive questions. Continue other work until it is ready; no question was queued.");
+    }
+    const incarnation = { pid: capability.pid, readyAt: capability.readyAt };
+    const question = createSupervisorQuestion({
+        channelDir,
+        reason,
+        message,
+        runId: status.runId,
+        childIndex: child.index,
+        childId: child.childId,
+        parentSessionId: sessionId,
+        parentGeneration: input.state.sessionGeneration ?? 0,
+        childIncarnation: incarnation,
+    });
+    try {
+        if (hasBlockingSupervisorRequest(channelDir, status.runId, child.index)) {
+            throw new Error("Child is waiting for a supervisor reply. Reply to its request before asking a question.");
+        }
+        requestAsyncSteer(resolved.location.asyncDir, {
+            message: formatParentQuestionForChild(question),
+            targetIndex: child.index,
+            source: "supervisor-question",
+            id: question.id,
+        });
+    }
+    catch (error) {
+        cancelSupervisorQuestion(channelDir, question.id, "failed to queue delivery to child");
+        throw error instanceof Error ? error : new Error(String(error));
+    }
+    return {
+        content: [{ type: "text", text: `Question ${question.id} queued for async run ${status.runId} child ${child.index}. The child's answer is delivered separately from the run result.` }],
+        details: {
+            questionId: question.id,
+            state: "pending",
+            runId: status.runId,
+            childIndex: child.index,
+            childId: child.childId,
+            delivered: false,
+            answered: false,
+        },
+    };
+}
+//# sourceMappingURL=supervisor-ask.js.map

package/dist/builtin-extensions/pi-subagents/src/intercom/supervisor-ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-ask.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/intercom/supervisor-ask.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentToolResult } from \"@ashx-j/lunr-agent\";\nimport { readSteerCapability, requestAsyncSteer } from \"../runs/background/control-channel.ts\";\nimport { resolveSubagentRunId } from \"../runs/background/run-id-resolver.ts\";\nimport { readStatus } from \"../shared/utils.ts\";\nimport type { AsyncStatus, SubagentState } from \"../shared/types.ts\";\nimport {\n\tcancelSupervisorQuestion,\n\tcreateSupervisorQuestion,\n\tformatParentQuestionForChild,\n\texpireSupervisorQuestion,\n\thasOutstandingQuestionForChild,\n\thasBlockingSupervisorRequest,\n\tincarnationMatches,\n\treadSupervisorQuestion,\n\tsupervisorQuestionIsTerminal,\n\tresolveSupervisorChannelDir,\n\ttype SupervisorChildIncarnation,\n\ttype SupervisorQuestion,\n} from \"./supervisor-questions.ts\";\n\nexport interface ParentAskParams {\n\tid?: string;\n\tindex?: number;\n\tchildId?: string;\n\treason?: string;\n\tmessage?: string;\n}\n\nexport interface ParentAskRequestFile {\n\texpectsReply?: boolean;\n\trunId?: string;\n\tchildIndex?: number;\n\tagent?: string;\n\tchildTarget?: string;\n}\n\nfunction runningSteps(status: AsyncStatus): Array<{ index: number; childId: string; agent: string }> {\n\treturn (status.steps ?? [])\n\t\t.map((step, index) => ({\n\t\t\tindex,\n\t\t\tchildId: step.childId ?? step.agent,\n\t\t\tagent: step.agent,\n\t\t\tstatus: step.status,\n\t\t}))\n\t\t.filter((step) => step.status === \"running\")\n\t\t.map((step) => ({ index: step.index, childId: step.childId, agent: step.agent }));\n}\n\nexport function resolveAskChild(\n\tstatus: AsyncStatus,\n\tparams: Pick<ParentAskParams, \"index\" | \"childId\">,\n): { index: number; childId: string; agent: string } {\n\tif (params.index !== undefined && (!Number.isInteger(params.index) || params.index < 0)) {\n\t\tthrow new Error(\"index must be a non-negative integer.\");\n\t}\n\tconst running = runningSteps(status);\n\tif (params.childId?.trim()) {\n\t\tconst childId = params.childId.trim();\n\t\tconst matches = (status.steps ?? [])\n\t\t\t.map((step, index) => ({ index, childId: step.childId ?? step.agent, agent: step.agent, status: step.status }))\n\t\t\t.filter((step) => step.childId === childId);\n\t\tif (matches.length === 0) throw new Error(`Async run '${status.runId}' has no child '${childId}'.`);\n\t\tif (matches.length > 1) throw new Error(`Async run '${status.runId}' has multiple children named '${childId}'. Pass index.`);\n\t\tconst match = matches[0]!;\n\t\tif (params.index !== undefined && params.index !== match.index) {\n\t\t\tthrow new Error(`Child '${childId}' is index ${match.index}, not ${params.index}.`);\n\t\t}\n\t\tif (match.status !== \"running\") throw new Error(`Async run '${status.runId}' child ${match.index} is ${match.status} and cannot be asked.`);\n\t\treturn { index: match.index, childId: match.childId, agent: match.agent };\n\t}\n\tif (params.index !== undefined) {\n\t\tconst steps = status.steps ?? [];\n\t\tif (params.index >= steps.length) {\n\t\t\tthrow new Error(`Async run '${status.runId}' has ${steps.length} children. Index ${params.index} is out of range.`);\n\t\t}\n\t\tconst step = steps[params.index]!;\n\t\tif (step.status !== \"running\") throw new Error(`Async run '${status.runId}' child ${params.index} is ${step.status} and cannot be asked.`);\n\t\treturn { index: params.index, childId: step.childId ?? step.agent, agent: step.agent };\n\t}\n\tif (running.length === 1) return running[0]!;\n\tif (running.length === 0) throw new Error(`Async run '${status.runId}' has no running child to ask.`);\n\tthrow new Error(`Async run '${status.runId}' has ${running.length} running children. Pass index or childId; broadcast asks are not supported.`);\n}\n\nfunction requestMatchesChild(request: ParentAskRequestFile, runId: string, child: { index: number; childId: string; agent: string }): boolean {\n\tif (!request.expectsReply) return false;\n\tif (typeof request.runId !== \"string\" || request.runId !== runId) return false;\n\tconst indexMatches = Number.isInteger(request.childIndex) && request.childIndex === child.index;\n\tconst idMatches = request.agent === child.childId\n\t\t|| request.agent === child.agent\n\t\t|| request.childTarget === child.childId;\n\treturn indexMatches && idMatches;\n}\n\nexport function reconcileAsyncQuestion(channelDir: string, question: SupervisorQuestion, state: SubagentState): SupervisorQuestion {\n\texpireSupervisorQuestion(channelDir, question.id);\n\tconst current = readSupervisorQuestion(channelDir, question.id) ?? question;\n\tif (supervisorQuestionIsTerminal(current)) return current;\n\tconst resolved = resolveSubagentRunId(current.runId, { state });\n\tif (resolved?.kind !== \"async\" || !resolved.location.asyncDir) return current;\n\tconst status = readStatus(resolved.location.asyncDir);\n\tif (!status) return current;\n\tconst step = status.steps?.[current.childIndex];\n\tconst capability = readSteerCapability(resolved.location.asyncDir, current.childIndex);\n\tlet reason: string | undefined;\n\tif (status.sessionId !== current.parentSessionId) reason = \"async run ownership changed\";\n\telse if (status.state !== \"running\" || !step || step.status !== \"running\") reason = \"target child is no longer running\";\n\telse if ((step.childId ?? step.agent) !== current.childId) reason = \"target child identity changed\";\n\telse if (capability && !incarnationMatches(current.childIncarnation, capability)) reason = \"target child process changed\";\n\telse if (capability && !capability.supported) reason = \"target child no longer accepts questions\";\n\tconst delivery = status.steering?.recent.find((request) => request.id === current.id)?.targets.find((target) => target.index === current.childIndex);\n\tif (delivery?.state === \"failed\" || delivery?.state === \"late\") reason = delivery.reason ?? \"question delivery failed\";\n\treturn reason ? cancelSupervisorQuestion(channelDir, current.id, reason) ?? current : current;\n}\n\nexport function askRunningAsyncChild(input: {\n\tparams: ParentAskParams;\n\tstate: SubagentState;\n\tchildRequests?: Iterable<ParentAskRequestFile>;\n}): AgentToolResult<Record<string, unknown>> {\n\tconst runId = input.params.id?.trim();\n\tif (!runId) throw new Error(\"action='ask' requires id for the async run.\");\n\tconst reason = input.params.reason?.trim();\n\tconst message = input.params.message?.trim();\n\tif (!reason) throw new Error(\"action='ask' requires reason naming the concrete decision the child's answer will change.\");\n\tif (!message) throw new Error(\"action='ask' requires message.\");\n\tconst sessionId = input.state.currentSessionId;\n\tif (!sessionId) throw new Error(\"action='ask' requires an active session identity.\");\n\n\tconst resolved = resolveSubagentRunId(runId, { state: input.state });\n\tif (!resolved) throw new Error(`No async run matched '${runId}'.`);\n\tif (resolved.kind !== \"async\") throw new Error(\"action='ask' targets a running async child only. It does not revive, reassign, or broadcast.\");\n\tif (!resolved.location.asyncDir) throw new Error(`Async run '${resolved.id}' has no live run directory.`);\n\n\tconst status = readStatus(resolved.location.asyncDir);\n\tif (!status) throw new Error(`Async run '${resolved.id}' has no status.`);\n\tif (!status.sessionId || status.sessionId !== sessionId) {\n\t\tthrow new Error(`Async run '${resolved.id}' was not found in the active session.`);\n\t}\n\tif (status.state !== \"running\") throw new Error(`Async run '${resolved.id}' is ${status.state} and cannot be asked.`);\n\n\tconst child = resolveAskChild(status, input.params);\n\tconst channelDir = resolveSupervisorChannelDir(status.runId, child.childId, child.index);\n\tif (hasOutstandingQuestionForChild(channelDir, child.index, child.childId)) {\n\t\tthrow new Error(`A question is already outstanding for async run '${status.runId}' child ${child.index}. Wait for that answer or expiry before asking again.`);\n\t}\n\tfor (const request of input.childRequests ?? []) {\n\t\tif (requestMatchesChild(request, status.runId, child)) {\n\t\t\tthrow new Error(`Child ${child.index} is waiting for a supervisor reply. Asking now would deadlock. Reply to the child request first.`);\n\t\t}\n\t}\n\n\tif (hasBlockingSupervisorRequest(channelDir, status.runId, child.index)) {\n\t\tthrow new Error(\"Child is waiting for a supervisor reply. Reply to its request before asking a question.\");\n\t}\n\tconst capability = readSteerCapability(resolved.location.asyncDir, child.index);\n\tif (!capability?.supported) {\n\t\tthrow new Error(\"This child is not ready to receive questions. Continue other work until it is ready; no question was queued.\");\n\t}\n\tconst incarnation: SupervisorChildIncarnation = { pid: capability.pid, readyAt: capability.readyAt };\n\tconst question: SupervisorQuestion = createSupervisorQuestion({\n\t\tchannelDir,\n\t\treason,\n\t\tmessage,\n\t\trunId: status.runId,\n\t\tchildIndex: child.index,\n\t\tchildId: child.childId,\n\t\tparentSessionId: sessionId,\n\t\tparentGeneration: input.state.sessionGeneration ?? 0,\n\t\tchildIncarnation: incarnation,\n\t});\n\ttry {\n\t\tif (hasBlockingSupervisorRequest(channelDir, status.runId, child.index)) {\n\t\t\tthrow new Error(\"Child is waiting for a supervisor reply. Reply to its request before asking a question.\");\n\t\t}\n\t\trequestAsyncSteer(resolved.location.asyncDir, {\n\t\t\tmessage: formatParentQuestionForChild(question),\n\t\t\ttargetIndex: child.index,\n\t\t\tsource: \"supervisor-question\",\n\t\t\tid: question.id,\n\t\t});\n\t} catch (error) {\n\t\tcancelSupervisorQuestion(channelDir, question.id, \"failed to queue delivery to child\");\n\t\tthrow error instanceof Error ? error : new Error(String(error));\n\t}\n\treturn {\n\t\tcontent: [{ type: \"text\", text: `Question ${question.id} queued for async run ${status.runId} child ${child.index}. The child's answer is delivered separately from the run result.` }],\n\t\tdetails: {\n\t\t\tquestionId: question.id,\n\t\t\tstate: \"pending\",\n\t\t\trunId: status.runId,\n\t\t\tchildIndex: child.index,\n\t\t\tchildId: child.childId,\n\t\t\tdelivered: false,\n\t\t\tanswered: false,\n\t\t},\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/intercom/supervisor-questions.d.ts

@@ -0,0 +1,89 @@
+export declare const QUESTIONS_DIR = "questions";
+export declare const SUPERVISOR_CHANNEL_ROOT: string;
+export declare const SUBAGENT_SUPERVISOR_ANSWER_TYPE = "subagent_supervisor_answer";
+export declare const SUBAGENT_QUESTION_EVENT = "subagent:supervisor-question";
+export type SupervisorQuestionPublicState = "pending" | "answered" | "expired" | "cancelled";
+export interface SupervisorChildIncarnation {
+    pid: number;
+    readyAt: number;
+}
+export interface SupervisorQuestion {
+    type: "subagent.supervisor.question";
+    id: string;
+    createdAt: number;
+    expiresAt: number;
+    reason: string;
+    message: string;
+    runId: string;
+    childIndex: number;
+    childId: string;
+    parentSessionId: string;
+    parentGeneration: number;
+    childIncarnation?: SupervisorChildIncarnation;
+    deliveredAt?: number;
+    answeredAt?: number;
+    expiredAt?: number;
+    cancelledAt?: number;
+    cancelReason?: string;
+    notifiedAt?: number;
+    lateAnswerAt?: number;
+    answer?: string;
+}
+export interface SupervisorQuestionOwner {
+    runId: string;
+    childIndex: number;
+    childId: string;
+    pid: number;
+    readyAt: number;
+}
+export declare function resolveSupervisorChannelDir(runId: string, agent: string, childIndex: number): string;
+export declare function questionsDir(channelDir: string): string;
+export declare function ensureQuestionsDir(channelDir: string): void;
+export declare function supervisorQuestionPublicState(question: SupervisorQuestion): SupervisorQuestionPublicState;
+export declare function supervisorQuestionIsTerminal(question: SupervisorQuestion): boolean;
+export declare function readSupervisorQuestion(channelDir: string, questionId: string): SupervisorQuestion | undefined;
+export declare function listSupervisorQuestions(channelDir: string): SupervisorQuestion[];
+export declare function createSupervisorQuestion(input: {
+    channelDir: string;
+    reason: string;
+    message: string;
+    runId: string;
+    childIndex: number;
+    childId: string;
+    parentSessionId: string;
+    parentGeneration: number;
+    childIncarnation?: SupervisorChildIncarnation;
+    now?: number;
+    timeoutMs?: number;
+    id?: string;
+}): SupervisorQuestion;
+export declare function outstandingQuestionsForChild(channelDir: string, childIndex: number, childId?: string): SupervisorQuestion[];
+export declare function hasBlockingSupervisorRequest(channelDir: string, runId: string, childIndex: number): boolean;
+export declare function hasOutstandingQuestionForChild(channelDir: string, childIndex: number, childId?: string): boolean;
+export declare function incarnationMatches(expected: SupervisorChildIncarnation | undefined, actual: SupervisorChildIncarnation): boolean;
+export declare function markSupervisorQuestionDelivered(channelDir: string, questionId: string, owner: SupervisorQuestionOwner, now?: number): SupervisorQuestion | undefined;
+export declare function answerSupervisorQuestion(channelDir: string, questionId: string, answer: string, owner: SupervisorQuestionOwner, now?: number): SupervisorQuestion;
+export declare function expireSupervisorQuestion(channelDir: string, questionId: string, now?: number): SupervisorQuestion | undefined;
+export declare function cancelSupervisorQuestion(channelDir: string, questionId: string, reason: string, now?: number): SupervisorQuestion | undefined;
+export declare function refreshSupervisorQuestionLifecycle(channelDir: string, now?: number): SupervisorQuestion[];
+export declare function formatParentQuestionForChild(question: SupervisorQuestion): string;
+export declare function formatSupervisorQuestionAnswer(question: SupervisorQuestion): string;
+export declare function registerQuestionWait(questionIds: Iterable<string>): () => void;
+export declare function isQuestionWaitActive(questionId: string): boolean;
+export declare function claimQuestionNotification(channelDir: string, questionId: string, now?: number): boolean;
+export declare function markSupervisorQuestionNotified(channelDir: string, questionId: string, now?: number): SupervisorQuestion | undefined;
+export declare function resetSupervisorQuestionTestState(): void;
+export declare function listSupervisorChannelDirs(): string[];
+export declare function findSupervisorQuestion(questionId: string): {
+    channelDir: string;
+    question: SupervisorQuestion;
+} | undefined;
+export declare function cancelPendingSupervisorQuestionsForOwner(input: {
+    parentSessionId: string;
+    parentGeneration?: number;
+    runId?: string;
+    reason: string;
+    now?: number;
+}): SupervisorQuestion[];
+export declare function pendingSupervisorQuestionsForDelivery(channelDir: string, owner: SupervisorQuestionOwner, now?: number): SupervisorQuestion[];
+//# sourceMappingURL=supervisor-questions.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/intercom/supervisor-questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-questions.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/intercom/supervisor-questions.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { TEMP_ROOT_DIR } from \"../shared/types.ts\";\n\nexport const QUESTIONS_DIR = \"questions\";\nexport const SUPERVISOR_CHANNEL_ROOT = path.join(TEMP_ROOT_DIR, \"supervisor-channels\");\nexport const SUBAGENT_SUPERVISOR_ANSWER_TYPE = \"subagent_supervisor_answer\";\nexport const SUBAGENT_QUESTION_EVENT = \"subagent:supervisor-question\";\n\nexport type SupervisorQuestionPublicState = \"pending\" | \"answered\" | \"expired\" | \"cancelled\";\n\nexport interface SupervisorChildIncarnation {\n\tpid: number;\n\treadyAt: number;\n}\n\nexport interface SupervisorQuestion {\n\ttype: \"subagent.supervisor.question\";\n\tid: string;\n\tcreatedAt: number;\n\texpiresAt: number;\n\treason: string;\n\tmessage: string;\n\trunId: string;\n\tchildIndex: number;\n\tchildId: string;\n\tparentSessionId: string;\n\tparentGeneration: number;\n\tchildIncarnation?: SupervisorChildIncarnation;\n\tdeliveredAt?: number;\n\tansweredAt?: number;\n\texpiredAt?: number;\n\tcancelledAt?: number;\n\tcancelReason?: string;\n\tnotifiedAt?: number;\n\tlateAnswerAt?: number;\n\tanswer?: string;\n}\n\nexport interface SupervisorQuestionOwner {\n\trunId: string;\n\tchildIndex: number;\n\tchildId: string;\n\tpid: number;\n\treadyAt: number;\n}\n\ninterface QuestionRecord {\n\ttype: \"subagent.supervisor.question\";\n\tid: string;\n\tcreatedAt: number;\n\texpiresAt: number;\n\treason: string;\n\tmessage: string;\n\trunId: string;\n\tchildIndex: number;\n\tchildId: string;\n\tparentSessionId: string;\n\tparentGeneration: number;\n\tchildIncarnation?: SupervisorChildIncarnation;\n}\n\ninterface DeliveredRecord {\n\ttype: \"subagent.supervisor.delivered\";\n\tid: string;\n\tat: number;\n\tpid: number;\n\treadyAt: number;\n}\n\ntype TerminalRecord =\n\t| { type: \"subagent.supervisor.terminal\"; id: string; state: \"answered\"; at: number; message: string }\n\t| { type: \"subagent.supervisor.terminal\"; id: string; state: \"expired\"; at: number }\n\t| { type: \"subagent.supervisor.terminal\"; id: string; state: \"cancelled\"; at: number; reason: string };\n\ninterface NotifiedRecord {\n\ttype: \"subagent.supervisor.notified\";\n\tid: string;\n\tat: number;\n}\n\ninterface LateAnswerRecord {\n\ttype: \"subagent.supervisor.late-answer\";\n\tid: string;\n\tat: number;\n\tmessage: string;\n}\n\nconst MAX_MESSAGE_BYTES = 64 * 1024;\nconst DEFAULT_ASK_TIMEOUT_MS = 10 * 60 * 1000;\nconst activeQuestionWaits = new Set<string>();\n\nfunction askTimeoutMs(): number {\n\tconst parsed = Number(process.env.PI_INTERCOM_ASK_TIMEOUT_MS);\n\treturn Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_ASK_TIMEOUT_MS;\n}\n\nfunction safeSegment(value: string): string {\n\treturn value.trim().replace(/[^A-Za-z0-9._-]+/g, \"-\").replace(/^-+|-+$/g, \"\") || \"unknown\";\n}\n\nexport function resolveSupervisorChannelDir(runId: string, agent: string, childIndex: number): string {\n\treturn path.join(SUPERVISOR_CHANNEL_ROOT, `${safeSegment(runId)}-${safeSegment(agent)}-${childIndex}`);\n}\n\nexport function questionsDir(channelDir: string): string {\n\treturn path.join(channelDir, QUESTIONS_DIR);\n}\n\nfunction questionFile(channelDir: string, questionId: string): string {\n\treturn path.join(questionsDir(channelDir), `${safeSegment(questionId)}.json`);\n}\n\nfunction deliveredFile(channelDir: string, questionId: string): string {\n\treturn path.join(questionsDir(channelDir), `${safeSegment(questionId)}.delivered.json`);\n}\n\nfunction terminalFile(channelDir: string, questionId: string): string {\n\treturn path.join(questionsDir(channelDir), `${safeSegment(questionId)}.terminal.json`);\n}\n\nfunction notifiedFile(channelDir: string, questionId: string): string {\n\treturn path.join(questionsDir(channelDir), `${safeSegment(questionId)}.notified.json`);\n}\n\nfunction lateFile(channelDir: string, questionId: string): string {\n\treturn path.join(questionsDir(channelDir), `${safeSegment(questionId)}.late.json`);\n}\n\nfunction writeExclusiveJson(filePath: string, payload: object): boolean {\n\tfs.mkdirSync(path.dirname(filePath), { recursive: true, mode: 0o700 });\n\tconst temporary = `${filePath}.${randomUUID()}.tmp`;\n\ttry {\n\t\tfs.writeFileSync(temporary, JSON.stringify(payload), { encoding: \"utf-8\", flag: \"wx\", mode: 0o600 });\n\t\t// Publish a complete record without overwriting a competing terminal outcome.\n\t\tfs.linkSync(temporary, filePath);\n\t\treturn true;\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"EEXIST\") return false;\n\t\tthrow error;\n\t} finally {\n\t\tfs.rmSync(temporary, { force: true });\n\t}\n}\n\nfunction readJsonFile(filePath: string): unknown {\n\treturn JSON.parse(fs.readFileSync(filePath, \"utf-8\"));\n}\n\nfunction tryReadJson(filePath: string): unknown | undefined {\n\ttry {\n\t\treturn readJsonFile(filePath);\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n\t\treturn undefined;\n\t}\n}\n\nfunction parseIncarnation(raw: unknown): SupervisorChildIncarnation | undefined {\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return undefined;\n\tconst input = raw as Partial<SupervisorChildIncarnation>;\n\tconst pid = input.pid;\n\tconst readyAt = input.readyAt;\n\tif (!Number.isInteger(pid) || pid === undefined || pid <= 0) return undefined;\n\tif (typeof readyAt !== \"number\" || !Number.isFinite(readyAt) || readyAt <= 0) return undefined;\n\treturn { pid, readyAt };\n}\n\nfunction parseQuestionRecord(raw: unknown): QuestionRecord | undefined {\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return undefined;\n\tconst input = raw as Partial<QuestionRecord>;\n\tif (input.type !== \"subagent.supervisor.question\") return undefined;\n\tif (typeof input.id !== \"string\" || !input.id.trim()) return undefined;\n\tif (typeof input.createdAt !== \"number\" || !Number.isFinite(input.createdAt)) return undefined;\n\tif (typeof input.expiresAt !== \"number\" || !Number.isFinite(input.expiresAt)) return undefined;\n\tif (typeof input.reason !== \"string\" || !input.reason.trim()) return undefined;\n\tif (typeof input.message !== \"string\" || !input.message.trim()) return undefined;\n\tif (typeof input.runId !== \"string\" || !input.runId.trim()) return undefined;\n\tconst childIndex = input.childIndex;\n\tif (!Number.isInteger(childIndex) || childIndex === undefined || childIndex < 0) return undefined;\n\tif (typeof input.childId !== \"string\" || !input.childId.trim()) return undefined;\n\tif (typeof input.parentSessionId !== \"string\" || !input.parentSessionId.trim()) return undefined;\n\tconst parentGeneration = input.parentGeneration;\n\tif (!Number.isInteger(parentGeneration) || parentGeneration === undefined || parentGeneration < 0) return undefined;\n\tconst incarnation = parseIncarnation(input.childIncarnation);\n\treturn {\n\t\ttype: \"subagent.supervisor.question\",\n\t\tid: input.id.trim(),\n\t\tcreatedAt: input.createdAt,\n\t\texpiresAt: input.expiresAt,\n\t\treason: input.reason.trim(),\n\t\tmessage: input.message.trim(),\n\t\trunId: input.runId.trim(),\n\t\tchildIndex,\n\t\tchildId: input.childId.trim(),\n\t\tparentSessionId: input.parentSessionId.trim(),\n\t\tparentGeneration,\n\t\t...(incarnation ? { childIncarnation: incarnation } : {}),\n\t};\n}\n\nfunction parseDeliveredRecord(raw: unknown): DeliveredRecord | undefined {\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return undefined;\n\tconst input = raw as Partial<DeliveredRecord>;\n\tif (input.type !== \"subagent.supervisor.delivered\" || typeof input.id !== \"string\" || !input.id.trim()) return undefined;\n\tif (typeof input.at !== \"number\" || !Number.isFinite(input.at)) return undefined;\n\tconst incarnation = parseIncarnation(input);\n\tif (!incarnation) return undefined;\n\treturn { type: \"subagent.supervisor.delivered\", id: input.id.trim(), at: input.at, pid: incarnation.pid, readyAt: incarnation.readyAt };\n}\n\nfunction parseTerminalRecord(raw: unknown): TerminalRecord | undefined {\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return undefined;\n\tconst input = raw as Partial<TerminalRecord> & { message?: unknown; reason?: unknown };\n\tif (input.type !== \"subagent.supervisor.terminal\" || typeof input.id !== \"string\" || !input.id.trim()) return undefined;\n\tif (typeof input.at !== \"number\" || !Number.isFinite(input.at)) return undefined;\n\tif (input.state === \"answered\") {\n\t\tif (typeof input.message !== \"string\" || !input.message.trim()) return undefined;\n\t\treturn { type: \"subagent.supervisor.terminal\", id: input.id.trim(), state: \"answered\", at: input.at, message: input.message };\n\t}\n\tif (input.state === \"expired\") {\n\t\treturn { type: \"subagent.supervisor.terminal\", id: input.id.trim(), state: \"expired\", at: input.at };\n\t}\n\tif (input.state === \"cancelled\") {\n\t\tif (typeof input.reason !== \"string\" || !input.reason.trim()) return undefined;\n\t\treturn { type: \"subagent.supervisor.terminal\", id: input.id.trim(), state: \"cancelled\", at: input.at, reason: input.reason.trim() };\n\t}\n\treturn undefined;\n}\n\nfunction parseNotifiedRecord(raw: unknown): NotifiedRecord | undefined {\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return undefined;\n\tconst input = raw as Partial<NotifiedRecord>;\n\tif (input.type !== \"subagent.supervisor.notified\" || typeof input.id !== \"string\" || !input.id.trim()) return undefined;\n\tif (typeof input.at !== \"number\" || !Number.isFinite(input.at)) return undefined;\n\treturn { type: \"subagent.supervisor.notified\", id: input.id.trim(), at: input.at };\n}\n\nfunction parseLateRecord(raw: unknown): LateAnswerRecord | undefined {\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return undefined;\n\tconst input = raw as Partial<LateAnswerRecord>;\n\tif (input.type !== \"subagent.supervisor.late-answer\" || typeof input.id !== \"string\" || !input.id.trim()) return undefined;\n\tif (typeof input.at !== \"number\" || !Number.isFinite(input.at) || typeof input.message !== \"string\") return undefined;\n\treturn { type: \"subagent.supervisor.late-answer\", id: input.id.trim(), at: input.at, message: input.message };\n}\n\nfunction composeQuestion(record: QuestionRecord, channelDir: string): SupervisorQuestion {\n\tconst delivered = parseDeliveredRecord(tryReadJson(deliveredFile(channelDir, record.id)));\n\tconst terminal = parseTerminalRecord(tryReadJson(terminalFile(channelDir, record.id)));\n\tconst notified = parseNotifiedRecord(tryReadJson(notifiedFile(channelDir, record.id)));\n\tconst late = parseLateRecord(tryReadJson(lateFile(channelDir, record.id)));\n\treturn {\n\t\t...record,\n\t\t...(delivered ? { deliveredAt: delivered.at, childIncarnation: record.childIncarnation ?? { pid: delivered.pid, readyAt: delivered.readyAt } } : {}),\n\t\t...(terminal?.state === \"answered\" ? { answeredAt: terminal.at, answer: terminal.message } : {}),\n\t\t...(terminal?.state === \"expired\" ? { expiredAt: terminal.at } : {}),\n\t\t...(terminal?.state === \"cancelled\" ? { cancelledAt: terminal.at, cancelReason: terminal.reason } : {}),\n\t\t...(notified ? { notifiedAt: notified.at } : {}),\n\t\t...(late ? { lateAnswerAt: late.at, ...(terminal?.state === \"answered\" ? {} : { answer: late.message }) } : {}),\n\t};\n}\n\nfunction assertMessageSize(value: string, label: string): void {\n\tif (Buffer.byteLength(value, \"utf-8\") > MAX_MESSAGE_BYTES) throw new Error(`${label} is too large.`);\n}\n\nexport function ensureQuestionsDir(channelDir: string): void {\n\tfs.mkdirSync(questionsDir(channelDir), { recursive: true, mode: 0o700 });\n}\n\nexport function supervisorQuestionPublicState(question: SupervisorQuestion): SupervisorQuestionPublicState {\n\tif (question.answeredAt) return \"answered\";\n\tif (question.expiredAt) return \"expired\";\n\tif (question.cancelledAt) return \"cancelled\";\n\treturn \"pending\";\n}\n\nexport function supervisorQuestionIsTerminal(question: SupervisorQuestion): boolean {\n\treturn supervisorQuestionPublicState(question) !== \"pending\";\n}\n\nexport function readSupervisorQuestion(channelDir: string, questionId: string): SupervisorQuestion | undefined {\n\tconst record = parseQuestionRecord(tryReadJson(questionFile(channelDir, questionId)));\n\tif (!record || record.id !== questionId) return undefined;\n\treturn composeQuestion(record, channelDir);\n}\n\nexport function listSupervisorQuestions(channelDir: string): SupervisorQuestion[] {\n\tconst dir = questionsDir(channelDir);\n\tlet entries: string[];\n\ttry {\n\t\tentries = fs.readdirSync(dir).filter((name) => name.endsWith(\".json\") && !name.endsWith(\".delivered.json\") && !name.endsWith(\".terminal.json\") && !name.endsWith(\".notified.json\") && !name.endsWith(\".late.json\"));\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n\t\tthrow error;\n\t}\n\tconst questions: SupervisorQuestion[] = [];\n\tfor (const entry of entries.sort()) {\n\t\tconst record = parseQuestionRecord(tryReadJson(path.join(dir, entry)));\n\t\tif (record) questions.push(composeQuestion(record, channelDir));\n\t}\n\treturn questions;\n}\n\nfunction writeTerminal(channelDir: string, record: TerminalRecord): boolean {\n\treturn writeExclusiveJson(terminalFile(channelDir, record.id), record);\n}\n\nfunction readTerminal(channelDir: string, questionId: string): TerminalRecord | undefined {\n\treturn parseTerminalRecord(tryReadJson(terminalFile(channelDir, questionId)));\n}\n\nexport function createSupervisorQuestion(input: {\n\tchannelDir: string;\n\treason: string;\n\tmessage: string;\n\trunId: string;\n\tchildIndex: number;\n\tchildId: string;\n\tparentSessionId: string;\n\tparentGeneration: number;\n\tchildIncarnation?: SupervisorChildIncarnation;\n\tnow?: number;\n\ttimeoutMs?: number;\n\tid?: string;\n}): SupervisorQuestion {\n\tconst reason = input.reason.trim();\n\tconst message = input.message.trim();\n\tif (!reason) throw new Error(\"reason is required and must name the concrete decision the child's answer will change.\");\n\tif (!message) throw new Error(\"message is required for supervisor questions.\");\n\tassertMessageSize(reason, \"reason\");\n\tassertMessageSize(message, \"message\");\n\tconst createdAt = input.now ?? Date.now();\n\tconst timeoutMs = input.timeoutMs && input.timeoutMs > 0 ? input.timeoutMs : askTimeoutMs();\n\tconst record: QuestionRecord = {\n\t\ttype: \"subagent.supervisor.question\",\n\t\tid: input.id ?? randomUUID(),\n\t\tcreatedAt,\n\t\texpiresAt: createdAt + timeoutMs,\n\t\treason,\n\t\tmessage,\n\t\trunId: input.runId,\n\t\tchildIndex: input.childIndex,\n\t\tchildId: input.childId,\n\t\tparentSessionId: input.parentSessionId,\n\t\tparentGeneration: input.parentGeneration,\n\t\t...(input.childIncarnation ? { childIncarnation: input.childIncarnation } : {}),\n\t};\n\tassertMessageSize(JSON.stringify(record), \"Supervisor question\");\n\tensureQuestionsDir(input.channelDir);\n\tif (!writeExclusiveJson(questionFile(input.channelDir, record.id), record)) {\n\t\tthrow new Error(`Supervisor question '${record.id}' already exists.`);\n\t}\n\treturn composeQuestion(record, input.channelDir);\n}\n\nexport function outstandingQuestionsForChild(channelDir: string, childIndex: number, childId?: string): SupervisorQuestion[] {\n\trefreshSupervisorQuestionLifecycle(channelDir);\n\treturn listSupervisorQuestions(channelDir).filter((question) => {\n\t\tif (supervisorQuestionIsTerminal(question)) return false;\n\t\tif (question.childIndex !== childIndex) return false;\n\t\tif (childId && question.childId !== childId) return false;\n\t\treturn true;\n\t});\n}\n\nexport function hasBlockingSupervisorRequest(channelDir: string, runId: string, childIndex: number): boolean {\n\tconst directory = path.join(channelDir, \"requests\");\n\tif (!fs.existsSync(directory)) return false;\n\tfor (const name of fs.readdirSync(directory)) {\n\t\tif (!name.endsWith(\".json\")) continue;\n\t\tconst raw = tryReadJson(path.join(directory, name));\n\t\tif (!raw || typeof raw !== \"object\") continue;\n\t\tconst request = raw as { type?: unknown; id?: unknown; expectsReply?: unknown; runId?: unknown; childIndex?: unknown; expiresAt?: unknown };\n\t\tif (request.type !== \"subagent.supervisor.request\" || request.expectsReply !== true) continue;\n\t\tif (request.runId !== runId || request.childIndex !== childIndex || typeof request.id !== \"string\") continue;\n\t\tif (typeof request.expiresAt === \"number\" && request.expiresAt <= Date.now()) continue;\n\t\tif (!fs.existsSync(path.join(channelDir, \"replies\", `${safeSegment(request.id)}.json`))) return true;\n\t}\n\treturn false;\n}\n\nexport function hasOutstandingQuestionForChild(channelDir: string, childIndex: number, childId?: string): boolean {\n\treturn outstandingQuestionsForChild(channelDir, childIndex, childId).length > 0;\n}\n\nexport function incarnationMatches(expected: SupervisorChildIncarnation | undefined, actual: SupervisorChildIncarnation): boolean {\n\tif (!expected) return true;\n\treturn expected.pid === actual.pid && expected.readyAt === actual.readyAt;\n}\n\nfunction assertOwner(question: SupervisorQuestion, owner: SupervisorQuestionOwner): void {\n\tif (owner.runId !== question.runId || owner.childIndex !== question.childIndex || owner.childId !== question.childId) {\n\t\tthrow new Error(`Supervisor question '${question.id}' is not owned by this child.`);\n\t}\n\tif (!incarnationMatches(question.childIncarnation, { pid: owner.pid, readyAt: owner.readyAt })) {\n\t\tthrow new Error(`Supervisor question '${question.id}' was bound to a different child incarnation.`);\n\t}\n}\n\nfunction ownerMatchesDelivered(channelDir: string, questionId: string, owner: SupervisorQuestionOwner): boolean {\n\tconst delivered = parseDeliveredRecord(tryReadJson(deliveredFile(channelDir, questionId)));\n\tif (!delivered) return true;\n\treturn delivered.pid === owner.pid && delivered.readyAt === owner.readyAt;\n}\n\nexport function markSupervisorQuestionDelivered(\n\tchannelDir: string,\n\tquestionId: string,\n\towner: SupervisorQuestionOwner,\n\tnow = Date.now(),\n): SupervisorQuestion | undefined {\n\tconst current = readSupervisorQuestion(channelDir, questionId);\n\tif (!current || supervisorQuestionIsTerminal(current)) return current;\n\tassertOwner(current, owner);\n\twriteExclusiveJson(deliveredFile(channelDir, questionId), {\n\t\ttype: \"subagent.supervisor.delivered\",\n\t\tid: questionId,\n\t\tat: now,\n\t\tpid: owner.pid,\n\t\treadyAt: owner.readyAt,\n\t} satisfies DeliveredRecord);\n\treturn readSupervisorQuestion(channelDir, questionId);\n}\n\nfunction rejectLateOrDuplicate(channelDir: string, questionId: string, answer: string, now: number, terminal: TerminalRecord): never {\n\twriteExclusiveJson(lateFile(channelDir, questionId), {\n\t\ttype: \"subagent.supervisor.late-answer\",\n\t\tid: questionId,\n\t\tat: now,\n\t\tmessage: answer,\n\t} satisfies LateAnswerRecord);\n\tif (terminal.state === \"answered\") throw new Error(`Supervisor question '${questionId}' was already answered.`);\n\tthrow new Error(`Supervisor question '${questionId}' is ${terminal.state} and no longer accepts an answer.`);\n}\n\nexport function answerSupervisorQuestion(\n\tchannelDir: string,\n\tquestionId: string,\n\tanswer: string,\n\towner: SupervisorQuestionOwner,\n\tnow = Date.now(),\n): SupervisorQuestion {\n\tconst trimmed = answer.trim();\n\tif (!trimmed) throw new Error(\"message is required for supervisor question replies.\");\n\tassertMessageSize(trimmed, \"answer\");\n\tconst current = readSupervisorQuestion(channelDir, questionId);\n\tif (!current) throw new Error(`No supervisor question found for replyTo '${questionId}'.`);\n\tassertOwner(current, owner);\n\tif (!ownerMatchesDelivered(channelDir, questionId, owner)) {\n\t\tthrow new Error(`Supervisor question '${questionId}' was bound to a different child incarnation.`);\n\t}\n\tif (now > current.expiresAt) {\n\t\twriteTerminal(channelDir, { type: \"subagent.supervisor.terminal\", id: questionId, state: \"expired\", at: now });\n\t\tconst terminal = readTerminal(channelDir, questionId);\n\t\tif (terminal && terminal.state !== \"answered\") {\n\t\t\trejectLateOrDuplicate(channelDir, questionId, trimmed, now, terminal);\n\t\t}\n\t\tif (terminal?.state === \"answered\") throw new Error(`Supervisor question '${questionId}' was already answered.`);\n\t}\n\tconst existing = readTerminal(channelDir, questionId);\n\tif (existing) rejectLateOrDuplicate(channelDir, questionId, trimmed, now, existing);\n\tif (!writeTerminal(channelDir, { type: \"subagent.supervisor.terminal\", id: questionId, state: \"answered\", at: now, message: trimmed })) {\n\t\tconst terminal = readTerminal(channelDir, questionId);\n\t\tif (terminal) rejectLateOrDuplicate(channelDir, questionId, trimmed, now, terminal);\n\t\tthrow new Error(`Supervisor question '${questionId}' is no longer pending.`);\n\t}\n\tconst answered = readSupervisorQuestion(channelDir, questionId);\n\tif (!answered) throw new Error(`Supervisor question '${questionId}' is no longer pending.`);\n\treturn answered;\n}\n\nexport function expireSupervisorQuestion(channelDir: string, questionId: string, now = Date.now()): SupervisorQuestion | undefined {\n\tconst current = readSupervisorQuestion(channelDir, questionId);\n\tif (!current || supervisorQuestionIsTerminal(current) || now <= current.expiresAt) return current && supervisorQuestionIsTerminal(current) ? current : undefined;\n\tif (!writeTerminal(channelDir, { type: \"subagent.supervisor.terminal\", id: questionId, state: \"expired\", at: now })) return readSupervisorQuestion(channelDir, questionId);\n\treturn readSupervisorQuestion(channelDir, questionId);\n}\n\nexport function cancelSupervisorQuestion(\n\tchannelDir: string,\n\tquestionId: string,\n\treason: string,\n\tnow = Date.now(),\n): SupervisorQuestion | undefined {\n\tconst current = readSupervisorQuestion(channelDir, questionId);\n\tif (!current || supervisorQuestionIsTerminal(current)) return current;\n\tif (!writeTerminal(channelDir, { type: \"subagent.supervisor.terminal\", id: questionId, state: \"cancelled\", at: now, reason: reason.trim() || \"cancelled\" })) {\n\t\treturn readSupervisorQuestion(channelDir, questionId);\n\t}\n\treturn readSupervisorQuestion(channelDir, questionId);\n}\n\nexport function refreshSupervisorQuestionLifecycle(channelDir: string, now = Date.now()): SupervisorQuestion[] {\n\tconst changed: SupervisorQuestion[] = [];\n\tfor (const question of listSupervisorQuestions(channelDir)) {\n\t\tif (supervisorQuestionIsTerminal(question)) continue;\n\t\tif (now > question.expiresAt) {\n\t\t\tconst expired = expireSupervisorQuestion(channelDir, question.id, now);\n\t\t\tif (expired && expired.expiredAt) changed.push(expired);\n\t\t}\n\t}\n\treturn changed;\n}\n\nexport function formatParentQuestionForChild(question: SupervisorQuestion): string {\n\treturn [\n\t\t`Parent question (${question.id})`,\n\t\t`Decision needed: ${question.reason}`,\n\t\t\"\",\n\t\tquestion.message,\n\t\t\"\",\n\t\t`Reply with: contact_supervisor({ action: \"reply\", replyTo: \"${question.id}\", message: \"...\" })`,\n\t\t\"Answer from current findings and uncertainty. Do not silently start extra investigation. Continue the assigned task after replying.\",\n\t].join(\"\\n\");\n}\n\nexport function formatSupervisorQuestionAnswer(question: SupervisorQuestion): string {\n\tconst state = supervisorQuestionPublicState(question);\n\tconst header = state === \"answered\"\n\t\t? `Subagent answer (${question.id})`\n\t\t: `Subagent question ${state} (${question.id})`;\n\tconst lines = [\n\t\theader,\n\t\t`Run: ${question.runId}`,\n\t\t`Child: ${question.childId} [#${question.childIndex}]`,\n\t\t`Decision: ${question.reason}`,\n\t];\n\tif (state === \"answered\" && question.answer?.trim()) {\n\t\tlines.push(\"\", question.answer.trim());\n\t} else if (question.cancelReason) {\n\t\tlines.push(\"\", question.cancelReason);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\nexport function registerQuestionWait(questionIds: Iterable<string>): () => void {\n\tconst ids = [...questionIds];\n\tfor (const id of ids) activeQuestionWaits.add(id);\n\treturn () => {\n\t\tfor (const id of ids) activeQuestionWaits.delete(id);\n\t};\n}\n\nexport function isQuestionWaitActive(questionId: string): boolean {\n\treturn activeQuestionWaits.has(questionId);\n}\n\nexport function claimQuestionNotification(channelDir: string, questionId: string, now = Date.now()): boolean {\n\treturn writeExclusiveJson(notifiedFile(channelDir, questionId), {\n\t\ttype: \"subagent.supervisor.notified\",\n\t\tid: questionId,\n\t\tat: now,\n\t} satisfies NotifiedRecord);\n}\n\nexport function markSupervisorQuestionNotified(channelDir: string, questionId: string, now = Date.now()): SupervisorQuestion | undefined {\n\tclaimQuestionNotification(channelDir, questionId, now);\n\treturn readSupervisorQuestion(channelDir, questionId);\n}\n\nexport function resetSupervisorQuestionTestState(): void {\n\tactiveQuestionWaits.clear();\n}\n\nexport function listSupervisorChannelDirs(): string[] {\n\tlet entries: fs.Dirent[];\n\ttry {\n\t\tentries = fs.readdirSync(SUPERVISOR_CHANNEL_ROOT, { withFileTypes: true });\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n\t\tthrow error;\n\t}\n\treturn entries.filter((entry) => entry.isDirectory()).map((entry) => path.join(SUPERVISOR_CHANNEL_ROOT, entry.name));\n}\n\nexport function findSupervisorQuestion(questionId: string): { channelDir: string; question: SupervisorQuestion } | undefined {\n\tconst id = questionId.trim();\n\tif (!id) return undefined;\n\tfor (const channelDir of listSupervisorChannelDirs()) {\n\t\tconst question = readSupervisorQuestion(channelDir, id);\n\t\tif (question) return { channelDir, question };\n\t}\n\treturn undefined;\n}\n\nexport function cancelPendingSupervisorQuestionsForOwner(input: {\n\tparentSessionId: string;\n\tparentGeneration?: number;\n\trunId?: string;\n\treason: string;\n\tnow?: number;\n}): SupervisorQuestion[] {\n\tif (!input.parentSessionId?.trim()) return [];\n\tconst now = input.now ?? Date.now();\n\tconst cancelled: SupervisorQuestion[] = [];\n\tfor (const channelDir of listSupervisorChannelDirs()) {\n\t\tfor (const question of listSupervisorQuestions(channelDir)) {\n\t\t\tif (supervisorQuestionIsTerminal(question)) continue;\n\t\t\tif (question.parentSessionId !== input.parentSessionId) continue;\n\t\t\tif (input.parentGeneration !== undefined && question.parentGeneration !== input.parentGeneration) continue;\n\t\t\tif (input.runId && question.runId !== input.runId) continue;\n\t\t\tconst next = cancelSupervisorQuestion(channelDir, question.id, input.reason, now);\n\t\t\tif (next?.cancelledAt) cancelled.push(next);\n\t\t}\n\t}\n\treturn cancelled;\n}\n\nexport function pendingSupervisorQuestionsForDelivery(channelDir: string, owner: SupervisorQuestionOwner, now = Date.now()): SupervisorQuestion[] {\n\trefreshSupervisorQuestionLifecycle(channelDir, now);\n\treturn listSupervisorQuestions(channelDir).filter((question) => {\n\t\tif (supervisorQuestionIsTerminal(question)) return false;\n\t\tif (question.deliveredAt) return false;\n\t\tif (question.runId !== owner.runId || question.childIndex !== owner.childIndex || question.childId !== owner.childId) return false;\n\t\tif (!incarnationMatches(question.childIncarnation, { pid: owner.pid, readyAt: owner.readyAt })) return false;\n\t\treturn now <= question.expiresAt;\n\t});\n}\n"]}