@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/runs/shared/subagent-control.js

@@ -0,0 +1,187 @@
+const CONTROL_EVENT_TYPES = ["active_long_running", "needs_attention"];
+const CONTROL_NOTIFICATION_CHANNELS = ["event", "async", "intercom"];
+const DEFAULT_NOTIFY_ON = ["active_long_running", "needs_attention"];
+export const DEFAULT_CONTROL_CONFIG = {
+    enabled: true,
+    needsAttentionAfterMs: 60_000,
+    activeNoticeAfterMs: 240_000,
+    failedToolAttemptsBeforeAttention: 3,
+    notifyOn: DEFAULT_NOTIFY_ON,
+    notifyChannels: CONTROL_NOTIFICATION_CHANNELS,
+};
+function parsePositiveInt(value) {
+    if (typeof value !== "number")
+        return undefined;
+    if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1)
+        return undefined;
+    return value;
+}
+function parseControlList(value, allowed) {
+    if (!Array.isArray(value))
+        return undefined;
+    if (value.length === 0)
+        return [];
+    const allowedSet = new Set(allowed);
+    const parsed = value.filter((entry) => typeof entry === "string" && allowedSet.has(entry));
+    return parsed.length > 0 ? Array.from(new Set(parsed)) : undefined;
+}
+export function resolveControlConfig(globalConfig, override) {
+    const enabled = override?.enabled ?? globalConfig?.enabled ?? DEFAULT_CONTROL_CONFIG.enabled;
+    const needsAttentionAfterMs = parsePositiveInt(override?.needsAttentionAfterMs)
+        ?? parsePositiveInt(globalConfig?.needsAttentionAfterMs)
+        ?? DEFAULT_CONTROL_CONFIG.needsAttentionAfterMs;
+    const activeNoticeAfterMs = parsePositiveInt(override?.activeNoticeAfterMs)
+        ?? parsePositiveInt(globalConfig?.activeNoticeAfterMs)
+        ?? DEFAULT_CONTROL_CONFIG.activeNoticeAfterMs;
+    const activeNoticeAfterTurns = parsePositiveInt(override?.activeNoticeAfterTurns)
+        ?? parsePositiveInt(globalConfig?.activeNoticeAfterTurns);
+    const activeNoticeAfterTokens = parsePositiveInt(override?.activeNoticeAfterTokens)
+        ?? parsePositiveInt(globalConfig?.activeNoticeAfterTokens);
+    const failedToolAttemptsBeforeAttention = parsePositiveInt(override?.failedToolAttemptsBeforeAttention)
+        ?? parsePositiveInt(globalConfig?.failedToolAttemptsBeforeAttention)
+        ?? DEFAULT_CONTROL_CONFIG.failedToolAttemptsBeforeAttention;
+    const notifyOn = parseControlList(override?.notifyOn, CONTROL_EVENT_TYPES)
+        ?? parseControlList(globalConfig?.notifyOn, CONTROL_EVENT_TYPES)
+        ?? DEFAULT_CONTROL_CONFIG.notifyOn;
+    const notifyChannels = parseControlList(override?.notifyChannels, CONTROL_NOTIFICATION_CHANNELS)
+        ?? parseControlList(globalConfig?.notifyChannels, CONTROL_NOTIFICATION_CHANNELS)
+        ?? DEFAULT_CONTROL_CONFIG.notifyChannels;
+    return {
+        enabled,
+        needsAttentionAfterMs,
+        activeNoticeAfterMs,
+        activeNoticeAfterTurns,
+        activeNoticeAfterTokens,
+        failedToolAttemptsBeforeAttention,
+        notifyOn: [...notifyOn],
+        notifyChannels: [...notifyChannels],
+    };
+}
+export function deriveActivityState(input) {
+    if (!input.config.enabled)
+        return undefined;
+    const now = input.now ?? Date.now();
+    const lastActivity = input.lastActivityAt ?? input.startedAt;
+    const ageMs = Math.max(0, now - lastActivity);
+    return ageMs > input.config.needsAttentionAfterMs ? "needs_attention" : undefined;
+}
+export function buildControlEvent(input) {
+    const ts = input.ts ?? Date.now();
+    const type = input.type ?? (input.to === "active_long_running" ? "active_long_running" : "needs_attention");
+    const elapsedMs = input.elapsedMs ?? (input.lastActivityAt ? Math.max(0, ts - input.lastActivityAt) : undefined);
+    const elapsedSeconds = elapsedMs !== undefined ? Math.floor(elapsedMs / 1000) : undefined;
+    const message = input.message ?? (type === "active_long_running"
+        ? `${input.agent} is still active but long-running`
+        : elapsedSeconds !== undefined
+            ? `${input.agent} needs attention (no observed activity for ${elapsedSeconds}s)`
+            : `${input.agent} needs attention`);
+    return {
+        type,
+        ...(input.from ? { from: input.from } : {}),
+        to: input.to,
+        ts,
+        runId: input.runId,
+        agent: input.agent,
+        ...(input.index !== undefined ? { index: input.index } : {}),
+        message,
+        reason: input.reason ?? (type === "active_long_running" ? "active_long_running" : "idle"),
+        ...(input.turns !== undefined ? { turns: input.turns } : {}),
+        ...(input.tokens !== undefined ? { tokens: input.tokens } : {}),
+        ...(input.toolCount !== undefined ? { toolCount: input.toolCount } : {}),
+        ...(input.currentTool ? { currentTool: input.currentTool } : {}),
+        ...(input.currentToolDurationMs !== undefined ? { currentToolDurationMs: input.currentToolDurationMs } : {}),
+        ...(input.currentPath ? { currentPath: input.currentPath } : {}),
+        ...(elapsedMs !== undefined ? { elapsedMs } : {}),
+        ...(input.recentFailureSummary ? { recentFailureSummary: input.recentFailureSummary } : {}),
+    };
+}
+export function shouldNotifyControlEvent(config, event) {
+    return config.enabled && config.notifyOn.includes(event.type);
+}
+export function controlNotificationKey(event, childIntercomTarget) {
+    const childKey = childIntercomTarget ?? (event.index !== undefined ? `${event.runId}:${event.index}` : event.runId);
+    return `${childKey}:${event.type}:${event.reason ?? "idle"}`;
+}
+export function claimControlNotification(config, event, seenKeys, childIntercomTarget) {
+    if (!shouldNotifyControlEvent(config, event))
+        return false;
+    const key = controlNotificationKey(event, childIntercomTarget);
+    if (seenKeys.has(key))
+        return false;
+    seenKeys.add(key);
+    return true;
+}
+function formatLongRunningFacts(event) {
+    const facts = [];
+    if (event.elapsedMs !== undefined)
+        facts.push(`elapsed ${Math.floor(Math.max(0, event.elapsedMs) / 1000)}s`);
+    if (event.turns !== undefined)
+        facts.push(`${event.turns} turns`);
+    if (event.tokens !== undefined)
+        facts.push(`${event.tokens} tokens`);
+    if (event.toolCount !== undefined)
+        facts.push(`${event.toolCount} tools`);
+    if (event.currentTool)
+        facts.push(`tool ${event.currentTool}${event.currentToolDurationMs !== undefined ? ` ${Math.floor(Math.max(0, event.currentToolDurationMs) / 1000)}s` : ""}`);
+    if (event.currentPath)
+        facts.push(`path ${event.currentPath}`);
+    return facts.length > 0 ? facts.join(" | ") : undefined;
+}
+export function formatControlNoticeMessage(event, childIntercomTarget) {
+    const runTarget = event.runId;
+    if (event.reason === "completion_guard") {
+        return [
+            `Subagent failed: ${event.agent}`,
+            `Run: ${runTarget}${event.index !== undefined ? ` step ${event.index + 1}` : ""}`,
+            `Signal: ${event.message}`,
+            "Next: read the output artifact or session from the subagent result, then retry with a more explicit implementation prompt or handle the fix directly.",
+            childIntercomTarget ? `Run intercom target (may be inactive): ${childIntercomTarget}` : undefined,
+        ].filter((line) => Boolean(line)).join("\n");
+    }
+    const nudgeMessage = "What are you blocked on? Reply with the smallest next step or ask for a decision.";
+    const nudgeCommand = `subagent({ action: "resume", id: "${runTarget}", ${event.index !== undefined ? `index: ${event.index}, ` : ""}message: "${nudgeMessage}" })`;
+    if (event.type === "active_long_running") {
+        const facts = formatLongRunningFacts(event);
+        return [
+            `Subagent active but long-running: ${event.agent}`,
+            `Run: ${runTarget}${event.index !== undefined ? ` step ${event.index + 1}` : ""}`,
+            `Signal: ${event.message}`,
+            facts ? `Facts: ${facts}` : undefined,
+            "Hint: Inspect status, then nudge if the work seems stuck. Live async nudges interrupt the child before sending the follow-up.",
+            `Nudge: ${nudgeCommand}`,
+            childIntercomTarget ? `Direct intercom target: ${childIntercomTarget}` : undefined,
+            `Status: subagent({ action: "status", id: "${runTarget}" })`,
+            `Interrupt: subagent({ action: "interrupt", id: "${runTarget}" })`,
+        ].filter((line) => Boolean(line)).join("\n");
+    }
+    return [
+        `Subagent needs attention: ${event.agent}`,
+        `Run: ${runTarget}${event.index !== undefined ? ` step ${event.index + 1}` : ""}`,
+        `Signal: ${event.message}`,
+        event.recentFailureSummary ? `Recent failures: ${event.recentFailureSummary}` : undefined,
+        "Hint: Inspect status first unless the run is clearly blocked. Live async nudges interrupt the child before sending the follow-up.",
+        `Nudge: ${nudgeCommand}`,
+        childIntercomTarget ? `Direct intercom target: ${childIntercomTarget}` : undefined,
+        `Status: subagent({ action: "status", id: "${runTarget}" })`,
+        `Interrupt: subagent({ action: "interrupt", id: "${runTarget}" })`,
+    ].filter((line) => Boolean(line)).join("\n");
+}
+export function formatControlIntercomMessage(event, childIntercomTarget) {
+    const statusLabel = event.reason === "completion_guard"
+        ? "subagent failed"
+        : event.type === "active_long_running"
+            ? "subagent active but long-running"
+            : "subagent needs attention";
+    return [
+        statusLabel,
+        "",
+        event.reason === "completion_guard"
+            ? `${event.agent} failed in run ${event.runId}.`
+            : event.type === "active_long_running"
+                ? `${event.agent} is still active but long-running in run ${event.runId}.`
+                : `${event.agent} needs attention in run ${event.runId}.`,
+        "",
+        formatControlNoticeMessage(event, childIntercomTarget),
+    ].join("\n");
+}
+//# sourceMappingURL=subagent-control.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/subagent-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-control.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/subagent-control.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport {\n\ttype ActivityState,\n\ttype ControlConfig,\n\ttype ControlEvent,\n\ttype ControlEventType,\n\ttype ControlNotificationChannel,\n\ttype ResolvedControlConfig,\n} from \"../../shared/types.ts\";\n\nconst CONTROL_EVENT_TYPES: ControlEventType[] = [\"active_long_running\", \"needs_attention\"];\nconst CONTROL_NOTIFICATION_CHANNELS: ControlNotificationChannel[] = [\"event\", \"async\", \"intercom\"];\nconst DEFAULT_NOTIFY_ON: ControlEventType[] = [\"active_long_running\", \"needs_attention\"];\n\nexport const DEFAULT_CONTROL_CONFIG: ResolvedControlConfig = {\n\tenabled: true,\n\tneedsAttentionAfterMs: 60_000,\n\tactiveNoticeAfterMs: 240_000,\n\tfailedToolAttemptsBeforeAttention: 3,\n\tnotifyOn: DEFAULT_NOTIFY_ON,\n\tnotifyChannels: CONTROL_NOTIFICATION_CHANNELS,\n};\n\nfunction parsePositiveInt(value: unknown): number | undefined {\n\tif (typeof value !== \"number\") return undefined;\n\tif (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) return undefined;\n\treturn value;\n}\n\nfunction parseControlList<T extends string>(value: unknown, allowed: readonly T[]): T[] | undefined {\n\tif (!Array.isArray(value)) return undefined;\n\tif (value.length === 0) return [];\n\tconst allowedSet = new Set(allowed);\n\tconst parsed = value.filter((entry): entry is T => typeof entry === \"string\" && allowedSet.has(entry as T));\n\treturn parsed.length > 0 ? Array.from(new Set(parsed)) : undefined;\n}\n\nexport function resolveControlConfig(\n\tglobalConfig?: ControlConfig,\n\toverride?: ControlConfig,\n): ResolvedControlConfig {\n\tconst enabled = override?.enabled ?? globalConfig?.enabled ?? DEFAULT_CONTROL_CONFIG.enabled;\n\tconst needsAttentionAfterMs = parsePositiveInt(override?.needsAttentionAfterMs)\n\t\t?? parsePositiveInt(globalConfig?.needsAttentionAfterMs)\n\t\t?? DEFAULT_CONTROL_CONFIG.needsAttentionAfterMs;\n\tconst activeNoticeAfterMs = parsePositiveInt(override?.activeNoticeAfterMs)\n\t\t?? parsePositiveInt(globalConfig?.activeNoticeAfterMs)\n\t\t?? DEFAULT_CONTROL_CONFIG.activeNoticeAfterMs;\n\tconst activeNoticeAfterTurns = parsePositiveInt(override?.activeNoticeAfterTurns)\n\t\t?? parsePositiveInt(globalConfig?.activeNoticeAfterTurns);\n\tconst activeNoticeAfterTokens = parsePositiveInt(override?.activeNoticeAfterTokens)\n\t\t?? parsePositiveInt(globalConfig?.activeNoticeAfterTokens);\n\tconst failedToolAttemptsBeforeAttention = parsePositiveInt(override?.failedToolAttemptsBeforeAttention)\n\t\t?? parsePositiveInt(globalConfig?.failedToolAttemptsBeforeAttention)\n\t\t?? DEFAULT_CONTROL_CONFIG.failedToolAttemptsBeforeAttention;\n\tconst notifyOn = parseControlList(override?.notifyOn, CONTROL_EVENT_TYPES)\n\t\t?? parseControlList(globalConfig?.notifyOn, CONTROL_EVENT_TYPES)\n\t\t?? DEFAULT_CONTROL_CONFIG.notifyOn;\n\tconst notifyChannels = parseControlList(override?.notifyChannels, CONTROL_NOTIFICATION_CHANNELS)\n\t\t?? parseControlList(globalConfig?.notifyChannels, CONTROL_NOTIFICATION_CHANNELS)\n\t\t?? DEFAULT_CONTROL_CONFIG.notifyChannels;\n\treturn {\n\t\tenabled,\n\t\tneedsAttentionAfterMs,\n\t\tactiveNoticeAfterMs,\n\t\tactiveNoticeAfterTurns,\n\t\tactiveNoticeAfterTokens,\n\t\tfailedToolAttemptsBeforeAttention,\n\t\tnotifyOn: [...notifyOn],\n\t\tnotifyChannels: [...notifyChannels],\n\t};\n}\n\nexport function deriveActivityState(input: {\n\tconfig: ResolvedControlConfig;\n\tstartedAt: number;\n\tlastActivityAt?: number;\n\tnow?: number;\n}): ActivityState | undefined {\n\tif (!input.config.enabled) return undefined;\n\tconst now = input.now ?? Date.now();\n\tconst lastActivity = input.lastActivityAt ?? input.startedAt;\n\tconst ageMs = Math.max(0, now - lastActivity);\n\treturn ageMs > input.config.needsAttentionAfterMs ? \"needs_attention\" : undefined;\n}\n\nexport function buildControlEvent(input: {\n\ttype?: ControlEventType;\n\tfrom?: ActivityState;\n\tto: ActivityState;\n\trunId: string;\n\tagent: string;\n\tindex?: number;\n\tts?: number;\n\tlastActivityAt?: number;\n\tmessage?: string;\n\treason?: ControlEvent[\"reason\"];\n\tturns?: number;\n\ttokens?: number;\n\ttoolCount?: number;\n\tcurrentTool?: string;\n\tcurrentToolDurationMs?: number;\n\tcurrentPath?: string;\n\telapsedMs?: number;\n\trecentFailureSummary?: string;\n}): ControlEvent {\n\tconst ts = input.ts ?? Date.now();\n\tconst type = input.type ?? (input.to === \"active_long_running\" ? \"active_long_running\" : \"needs_attention\");\n\tconst elapsedMs = input.elapsedMs ?? (input.lastActivityAt ? Math.max(0, ts - input.lastActivityAt) : undefined);\n\tconst elapsedSeconds = elapsedMs !== undefined ? Math.floor(elapsedMs / 1000) : undefined;\n\tconst message = input.message ?? (type === \"active_long_running\"\n\t\t? `${input.agent} is still active but long-running`\n\t\t: elapsedSeconds !== undefined\n\t\t\t? `${input.agent} needs attention (no observed activity for ${elapsedSeconds}s)`\n\t\t\t: `${input.agent} needs attention`);\n\treturn {\n\t\ttype,\n\t\t...(input.from ? { from: input.from } : {}),\n\t\tto: input.to,\n\t\tts,\n\t\trunId: input.runId,\n\t\tagent: input.agent,\n\t\t...(input.index !== undefined ? { index: input.index } : {}),\n\t\tmessage,\n\t\treason: input.reason ?? (type === \"active_long_running\" ? \"active_long_running\" : \"idle\"),\n\t\t...(input.turns !== undefined ? { turns: input.turns } : {}),\n\t\t...(input.tokens !== undefined ? { tokens: input.tokens } : {}),\n\t\t...(input.toolCount !== undefined ? { toolCount: input.toolCount } : {}),\n\t\t...(input.currentTool ? { currentTool: input.currentTool } : {}),\n\t\t...(input.currentToolDurationMs !== undefined ? { currentToolDurationMs: input.currentToolDurationMs } : {}),\n\t\t...(input.currentPath ? { currentPath: input.currentPath } : {}),\n\t\t...(elapsedMs !== undefined ? { elapsedMs } : {}),\n\t\t...(input.recentFailureSummary ? { recentFailureSummary: input.recentFailureSummary } : {}),\n\t};\n}\n\nexport function shouldNotifyControlEvent(config: ResolvedControlConfig, event: ControlEvent): boolean {\n\treturn config.enabled && config.notifyOn.includes(event.type);\n}\n\nexport function controlNotificationKey(event: ControlEvent, childIntercomTarget?: string): string {\n\tconst childKey = childIntercomTarget ?? (event.index !== undefined ? `${event.runId}:${event.index}` : event.runId);\n\treturn `${childKey}:${event.type}:${event.reason ?? \"idle\"}`;\n}\n\nexport function claimControlNotification(config: ResolvedControlConfig, event: ControlEvent, seenKeys: Set<string>, childIntercomTarget?: string): boolean {\n\tif (!shouldNotifyControlEvent(config, event)) return false;\n\tconst key = controlNotificationKey(event, childIntercomTarget);\n\tif (seenKeys.has(key)) return false;\n\tseenKeys.add(key);\n\treturn true;\n}\n\nfunction formatLongRunningFacts(event: ControlEvent): string | undefined {\n\tconst facts: string[] = [];\n\tif (event.elapsedMs !== undefined) facts.push(`elapsed ${Math.floor(Math.max(0, event.elapsedMs) / 1000)}s`);\n\tif (event.turns !== undefined) facts.push(`${event.turns} turns`);\n\tif (event.tokens !== undefined) facts.push(`${event.tokens} tokens`);\n\tif (event.toolCount !== undefined) facts.push(`${event.toolCount} tools`);\n\tif (event.currentTool) facts.push(`tool ${event.currentTool}${event.currentToolDurationMs !== undefined ? ` ${Math.floor(Math.max(0, event.currentToolDurationMs) / 1000)}s` : \"\"}`);\n\tif (event.currentPath) facts.push(`path ${event.currentPath}`);\n\treturn facts.length > 0 ? facts.join(\" | \") : undefined;\n}\n\nexport function formatControlNoticeMessage(event: ControlEvent, childIntercomTarget?: string): string {\n\tconst runTarget = event.runId;\n\tif (event.reason === \"completion_guard\") {\n\t\treturn [\n\t\t\t`Subagent failed: ${event.agent}`,\n\t\t\t`Run: ${runTarget}${event.index !== undefined ? ` step ${event.index + 1}` : \"\"}`,\n\t\t\t`Signal: ${event.message}`,\n\t\t\t\"Next: read the output artifact or session from the subagent result, then retry with a more explicit implementation prompt or handle the fix directly.\",\n\t\t\tchildIntercomTarget ? `Run intercom target (may be inactive): ${childIntercomTarget}` : undefined,\n\t\t].filter((line): line is string => Boolean(line)).join(\"\\n\");\n\t}\n\n\tconst nudgeMessage = \"What are you blocked on? Reply with the smallest next step or ask for a decision.\";\n\tconst nudgeCommand = `subagent({ action: \"resume\", id: \"${runTarget}\", ${event.index !== undefined ? `index: ${event.index}, ` : \"\"}message: \"${nudgeMessage}\" })`;\n\tif (event.type === \"active_long_running\") {\n\t\tconst facts = formatLongRunningFacts(event);\n\t\treturn [\n\t\t\t`Subagent active but long-running: ${event.agent}`,\n\t\t\t`Run: ${runTarget}${event.index !== undefined ? ` step ${event.index + 1}` : \"\"}`,\n\t\t\t`Signal: ${event.message}`,\n\t\t\tfacts ? `Facts: ${facts}` : undefined,\n\t\t\t\"Hint: Inspect status, then nudge if the work seems stuck. Live async nudges interrupt the child before sending the follow-up.\",\n\t\t\t`Nudge: ${nudgeCommand}`,\n\t\t\tchildIntercomTarget ? `Direct intercom target: ${childIntercomTarget}` : undefined,\n\t\t\t`Status: subagent({ action: \"status\", id: \"${runTarget}\" })`,\n\t\t\t`Interrupt: subagent({ action: \"interrupt\", id: \"${runTarget}\" })`,\n\t\t].filter((line): line is string => Boolean(line)).join(\"\\n\");\n\t}\n\n\treturn [\n\t\t`Subagent needs attention: ${event.agent}`,\n\t\t`Run: ${runTarget}${event.index !== undefined ? ` step ${event.index + 1}` : \"\"}`,\n\t\t`Signal: ${event.message}`,\n\t\tevent.recentFailureSummary ? `Recent failures: ${event.recentFailureSummary}` : undefined,\n\t\t\"Hint: Inspect status first unless the run is clearly blocked. Live async nudges interrupt the child before sending the follow-up.\",\n\t\t`Nudge: ${nudgeCommand}`,\n\t\tchildIntercomTarget ? `Direct intercom target: ${childIntercomTarget}` : undefined,\n\t\t`Status: subagent({ action: \"status\", id: \"${runTarget}\" })`,\n\t\t`Interrupt: subagent({ action: \"interrupt\", id: \"${runTarget}\" })`,\n\t].filter((line): line is string => Boolean(line)).join(\"\\n\");\n}\n\nexport function formatControlIntercomMessage(event: ControlEvent, childIntercomTarget?: string): string {\n\tconst statusLabel = event.reason === \"completion_guard\"\n\t\t? \"subagent failed\"\n\t\t: event.type === \"active_long_running\"\n\t\t\t? \"subagent active but long-running\"\n\t\t\t: \"subagent needs attention\";\n\treturn [\n\t\tstatusLabel,\n\t\t\"\",\n\t\tevent.reason === \"completion_guard\"\n\t\t\t? `${event.agent} failed in run ${event.runId}.`\n\t\t\t: event.type === \"active_long_running\"\n\t\t\t\t? `${event.agent} is still active but long-running in run ${event.runId}.`\n\t\t\t\t: `${event.agent} needs attention in run ${event.runId}.`,\n\t\t\"\",\n\t\tformatControlNoticeMessage(event, childIntercomTarget),\n\t].join(\"\\n\");\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/subagent-prompt-runtime.d.ts

@@ -0,0 +1,22 @@
+import * as fs from "node:fs";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { type SteerRequest } from "../background/control-channel.ts";
+export declare const SUBAGENT_INTERCOM_SESSION_NAME_ENV = "PI_SUBAGENT_INTERCOM_SESSION_NAME";
+export declare const CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS: string;
+export declare const CHILD_FANOUT_BOUNDARY_INSTRUCTIONS: string;
+export declare function stripProjectContext(prompt: string): string;
+export declare function stripInheritedSkills(prompt: string): string;
+export declare function stripSubagentOrchestrationSkill(prompt: string): string;
+export declare function rewriteSubagentPrompt(prompt: string, options: {
+    inheritProjectContext: boolean;
+    inheritSkills: boolean;
+    fanoutChild?: boolean;
+}): string;
+export declare function stripParentOnlySubagentMessages(messages: unknown[]): unknown[];
+export declare function formatSteerMessage(request: SteerRequest): string;
+export declare function registerSteeringInbox(pi: ExtensionAPI, deps?: {
+    watch?: typeof fs.watch;
+    nativeRealpath?: (filePath: string) => string;
+}): void;
+export default function registerSubagentPromptRuntime(pi: ExtensionAPI): void;
+//# sourceMappingURL=subagent-prompt-runtime.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/subagent-prompt-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-prompt-runtime.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/subagent-prompt-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,EAAqH,KAAK,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAsBxL,eAAO,MAAM,kCAAkC,sCAAsC,CAAC;AAQtF,eAAO,MAAM,oCAAoC,QAMrC,CAAC;AAEb,eAAO,MAAM,kCAAkC,QAOnC,CAAC;AA6Cb,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAItE;AAUD,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,qBAAqB,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACxF,MAAM,CAaR;AA4BD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAkB9E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAQhE;AAwBD,wBAAgB,qBAAqB,CACpC,EAAE,EAAE,YAAY,EAChB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC;IAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;CAAO,GACnF,IAAI,CA0GN;AAED,MAAM,CAAC,OAAO,UAAU,6BAA6B,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAiH5E","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { ExtensionAPI } from \"@earendil-works/pi-coding-agent\";\nimport { registerNativeSupervisorClient } from \"../../intercom/native-supervisor-channel.ts\";\nimport { consumeSteerRequestsFromDir, steerAckPathFromDir, writeSteerAckAt, writeSteerCapabilityAt, writeSteerRequestToDir, type SteerRequest } from \"../background/control-channel.ts\";\nimport { SUBAGENT_CHILD_AGENT_ENV, SUBAGENT_CHILD_INDEX_ENV, SUBAGENT_FANOUT_CHILD_ENV, SUBAGENT_STEER_ACK_DIR_ENV, SUBAGENT_STEER_CAPABILITY_ENV, SUBAGENT_STEER_INBOX_ENV } from \"./pi-args.ts\";\nimport { STRUCTURED_OUTPUT_CAPTURE_ENV, STRUCTURED_OUTPUT_SCHEMA_ENV, validateStructuredOutputValue } from \"./structured-output.ts\";\nimport {\n\tCHILD_TOOL_DIAGNOSTIC_PATH_ENV,\n\tformatChildToolDiagnostic,\n\tREQUIRED_CHILD_TOOLS_ENV,\n\twriteChildToolDiagnostic,\n\ttype ChildToolDiagnostic,\n} from \"./tool-availability.ts\";\nimport { TOOL_BUDGET_ENV, decodeToolBudgetEnv, shouldBlockToolForBudget, toolBudgetBlockedMessage, toolBudgetSoftNudge } from \"./tool-budget.ts\";\nimport type { JsonSchemaObject, ResolvedToolBudget, SubagentState } from \"../../shared/types.ts\";\nimport { resolveCurrentSessionId } from \"../../shared/session-identity.ts\";\nimport { resolveWatchPath } from \"../../shared/utils.ts\";\nimport { registerChildWatchdog } from \"../../watchdog/register-child.ts\";\nimport { SUBAGENT_WATCHDOG_WARNING_TYPE } from \"../../watchdog/types.ts\";\nimport { resolveWaitToolConfig } from \"../background/wait-config.ts\";\nimport { registerWaitTool } from \"../background/wait-tool.ts\";\nimport { drainOutstandingWork } from \"../background/auto-drain.ts\";\n\nconst SUBAGENT_INHERIT_PROJECT_CONTEXT_ENV = \"PI_SUBAGENT_INHERIT_PROJECT_CONTEXT\";\nconst SUBAGENT_INHERIT_SKILLS_ENV = \"PI_SUBAGENT_INHERIT_SKILLS\";\nexport const SUBAGENT_INTERCOM_SESSION_NAME_ENV = \"PI_SUBAGENT_INTERCOM_SESSION_NAME\";\n\nconst STRUCTURED_OUTPUT_INSTRUCTIONS = [\n\t\"This subagent step has a strict structured output contract.\",\n\t\"Your final action must be to call the `structured_output` tool with JSON matching the provided schema.\",\n\t\"Do not rely on prose-only completion; if you do not call `structured_output`, the parent will fail this step.\",\n].join(\"\\n\");\n\nexport const CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS = [\n\t\"You are a child subagent, not the parent orchestrator.\",\n\t\"The parent session owns delegation, orchestration, review fanout, and follow-up worker launches.\",\n\t\"Ignore prior parent-only orchestration instructions in inherited conversation history.\",\n\t\"Do not propose or run subagents. Complete only your assigned role-specific task with the tools available to you.\",\n\t\"If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.\",\n].join(\"\\n\");\n\nexport const CHILD_FANOUT_BOUNDARY_INSTRUCTIONS = [\n\t\"You are a child subagent with explicit fanout responsibility for this assigned task.\",\n\t\"The parent session owns final orchestration, acceptance, and follow-up implementation launches.\",\n\t\"You may use the `subagent` tool only for the fanout work explicitly requested in this task.\",\n\t\"Do not broaden yourself into general parent orchestration. Do not launch follow-up workers unless the task explicitly asks for that.\",\n\t\"The maxSubagentDepth cap still applies and may block further fanout.\",\n\t\"If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.\",\n].join(\"\\n\");\n\nconst PARENT_ONLY_CUSTOM_MESSAGE_TYPES = new Set([\n\t\"subagent-orchestration-instructions\",\n\t\"subagent-slash-result\",\n\t\"subagent-slash-text-result\",\n\t\"subagent-notify\",\n\t\"subagent_control_notice\",\n\t\"subagent-control\",\n\t\"subagent-control-notice\",\n]);\nconst SUBAGENT_ORCHESTRATION_SKILL_NAME_PATTERN = /<name>\\s*pi-subagents\\s*<\\/name>/;\nconst PROJECT_CONTEXT_HEADER = \"\\n\\n# Project Context\\n\\nProject-specific instructions and guidelines:\\n\\n\";\nconst SKILLS_HEADER = \"\\n\\nThe following skills provide specialized instructions for specific tasks.\";\nconst DATE_HEADER = \"\\nCurrent date:\";\n\nfunction readBooleanEnv(name: string): boolean | undefined {\n\tconst value = process.env[name];\n\tif (value === undefined) return undefined;\n\treturn value !== \"0\";\n}\n\nfunction refreshChildToolDiagnostic(pi: ExtensionAPI): ChildToolDiagnostic | undefined {\n\tconst filePath = process.env[CHILD_TOOL_DIAGNOSTIC_PATH_ENV]?.trim();\n\tconst encoded = process.env[REQUIRED_CHILD_TOOLS_ENV]?.trim();\n\tif (!filePath || !encoded) return undefined;\n\tconst required = JSON.parse(encoded) as unknown;\n\tif (!Array.isArray(required) || required.some((name) => typeof name !== \"string\" || !name)) {\n\t\tthrow new Error(`Invalid ${REQUIRED_CHILD_TOOLS_ENV} payload.`);\n\t}\n\tconst available = pi.getAllTools().map((tool) => tool.name);\n\treturn writeChildToolDiagnostic(filePath, required, available, process.env[SUBAGENT_CHILD_AGENT_ENV]?.trim());\n}\n\nfunction findSectionEnd(prompt: string, startIndex: number, nextHeaders: string[]): number {\n\tlet endIndex = prompt.length;\n\tfor (const header of nextHeaders) {\n\t\tconst index = prompt.indexOf(header, startIndex);\n\t\tif (index !== -1 && index < endIndex) {\n\t\t\tendIndex = index;\n\t\t}\n\t}\n\treturn endIndex;\n}\n\nexport function stripProjectContext(prompt: string): string {\n\tconst startIndex = prompt.indexOf(PROJECT_CONTEXT_HEADER);\n\tif (startIndex === -1) return prompt;\n\tconst endIndex = findSectionEnd(prompt, startIndex + PROJECT_CONTEXT_HEADER.length, [SKILLS_HEADER, DATE_HEADER]);\n\treturn `${prompt.slice(0, startIndex)}${prompt.slice(endIndex)}`;\n}\n\nexport function stripInheritedSkills(prompt: string): string {\n\tconst startIndex = prompt.indexOf(SKILLS_HEADER);\n\tif (startIndex === -1) return prompt;\n\tconst endIndex = findSectionEnd(prompt, startIndex + SKILLS_HEADER.length, [DATE_HEADER]);\n\treturn `${prompt.slice(0, startIndex)}${prompt.slice(endIndex)}`;\n}\n\nexport function stripSubagentOrchestrationSkill(prompt: string): string {\n\treturn prompt\n\t\t.replace(/\\n{0,2}<skill\\s+name=[\"']pi-subagents[\"'][^>]*>[\\s\\S]*?<\\/skill>\\n{0,2}/g, \"\\n\\n\")\n\t\t.replace(/[ \\t]*<skill>\\s*[\\s\\S]*?<\\/skill>\\s*/g, (block) => SUBAGENT_ORCHESTRATION_SKILL_NAME_PATTERN.test(block) ? \"\" : block);\n}\n\nfunction stripChildBoundaryInstructions(prompt: string): string {\n\tlet rewritten = prompt;\n\tfor (const boundary of [CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS, CHILD_FANOUT_BOUNDARY_INSTRUCTIONS]) {\n\t\trewritten = rewritten.split(boundary).join(\"\");\n\t}\n\treturn rewritten.replace(/^(?:[ \\t]*\\r?\\n)+/, \"\");\n}\n\nexport function rewriteSubagentPrompt(\n\tprompt: string,\n\toptions: { inheritProjectContext: boolean; inheritSkills: boolean; fanoutChild?: boolean },\n): string {\n\tlet rewritten = prompt;\n\tif (!options.inheritProjectContext) {\n\t\trewritten = stripProjectContext(rewritten);\n\t}\n\tif (!options.inheritSkills) {\n\t\trewritten = stripInheritedSkills(rewritten);\n\t}\n\trewritten = stripSubagentOrchestrationSkill(rewritten);\n\trewritten = stripChildBoundaryInstructions(rewritten);\n\tconst boundary = options.fanoutChild ? CHILD_FANOUT_BOUNDARY_INSTRUCTIONS : CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS;\n\tconst structured = process.env[STRUCTURED_OUTPUT_CAPTURE_ENV] ? `\\n\\n${STRUCTURED_OUTPUT_INSTRUCTIONS}` : \"\";\n\treturn `${boundary}${structured}\\n\\n${rewritten}`;\n}\n\nfunction isParentOnlySubagentMessage(message: unknown): boolean {\n\tconst m = message as { role?: string; customType?: string };\n\tif (m?.role !== \"custom\" || typeof m.customType !== \"string\") return false;\n\tif (m.customType === SUBAGENT_WATCHDOG_WARNING_TYPE) return true;\n\treturn PARENT_ONLY_CUSTOM_MESSAGE_TYPES.has(m.customType);\n}\n\nfunction isSubagentToolResultMessage(message: unknown): boolean {\n\tconst m = message as { role?: string; toolName?: string };\n\treturn m?.role === \"toolResult\" && m.toolName === \"subagent\";\n}\n\nfunction isSubagentToolCallBlock(block: unknown): boolean {\n\tconst b = block as { type?: string; name?: string };\n\treturn b?.type === \"toolCall\" && b.name === \"subagent\";\n}\n\nfunction stripAssistantSubagentToolCallBlocks(message: unknown): unknown | undefined {\n\tconst m = message as { role?: string; content?: unknown };\n\tif (m?.role !== \"assistant\" || !Array.isArray(m.content)) return message;\n\tconst filteredContent = m.content.filter((block) => !isSubagentToolCallBlock(block));\n\tif (filteredContent.length === m.content.length) return message;\n\tif (filteredContent.length === 0) return undefined;\n\treturn { ...m, content: filteredContent };\n}\n\nexport function stripParentOnlySubagentMessages(messages: unknown[]): unknown[] {\n\tconst preserveCurrentFanoutToolHistory = process.env[SUBAGENT_FANOUT_CHILD_ENV] === \"1\";\n\tlet changed = false;\n\tconst filtered: unknown[] = [];\n\tfor (const message of messages) {\n\t\tif (isParentOnlySubagentMessage(message) || (!preserveCurrentFanoutToolHistory && isSubagentToolResultMessage(message))) {\n\t\t\tchanged = true;\n\t\t\tcontinue;\n\t\t}\n\t\tconst stripped = preserveCurrentFanoutToolHistory ? message : stripAssistantSubagentToolCallBlocks(message);\n\t\tif (stripped === undefined) {\n\t\t\tchanged = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (stripped !== message) changed = true;\n\t\tfiltered.push(stripped);\n\t}\n\treturn changed ? filtered : messages;\n}\n\nexport function formatSteerMessage(request: SteerRequest): string {\n\treturn [\n\t\t\"Mid-run steering from the parent orchestrator:\",\n\t\t\"\",\n\t\trequest.message,\n\t\t\"\",\n\t\t\"Incorporate this guidance at the next safe point. Do not restart the task unless the guidance explicitly asks you to.\",\n\t].join(\"\\n\");\n}\n\nfunction registerToolBudget(pi: ExtensionAPI, budget: ResolvedToolBudget | undefined): void {\n\tif (!budget) return;\n\tlet toolCount = 0;\n\tlet softNudged = false;\n\tconst sendUserMessage = (pi as { sendUserMessage?: (content: string, options: { deliverAs: \"steer\" }) => unknown }).sendUserMessage;\n\tconst onRuntimeEvent = pi.on as unknown as (event: string, handler: (event: { toolName?: string }) => unknown) => void;\n\tonRuntimeEvent(\"tool_call\", (event) => {\n\t\tconst toolName = typeof event.toolName === \"string\" ? event.toolName : \"tool\";\n\t\ttoolCount++;\n\t\tif (budget.soft !== undefined && toolCount >= budget.soft && !softNudged) {\n\t\t\tsoftNudged = true;\n\t\t\ttry {\n\t\t\t\tsendUserMessage?.(toolBudgetSoftNudge(budget, toolCount), { deliverAs: \"steer\" });\n\t\t\t} catch {\n\t\t\t\t// Budget nudges are advisory; blocking below remains authoritative.\n\t\t\t}\n\t\t}\n\t\tif (!shouldBlockToolForBudget(budget, toolName, toolCount)) return undefined;\n\t\treturn { block: true, reason: toolBudgetBlockedMessage(budget, toolName, toolCount) };\n\t});\n}\n\nexport function registerSteeringInbox(\n\tpi: ExtensionAPI,\n\tdeps: { watch?: typeof fs.watch; nativeRealpath?: (filePath: string) => string } = {},\n): void {\n\tconst steerInbox = process.env[SUBAGENT_STEER_INBOX_ENV]?.trim();\n\tif (!steerInbox) return;\n\tconst capabilityPath = process.env[SUBAGENT_STEER_CAPABILITY_ENV]?.trim();\n\tconst ackDir = process.env[SUBAGENT_STEER_ACK_DIR_ENV]?.trim();\n\tconst sendUserMessage = (pi as { sendUserMessage?: (content: string, options: { deliverAs: \"steer\" }) => unknown }).sendUserMessage;\n\tconst childIndex = Number(process.env[SUBAGENT_CHILD_INDEX_ENV]);\n\tconst pending = new Map<string, string[]>();\n\tlet disposed = false;\n\tlet flushing = false;\n\tlet started = false;\n\tlet canSteer = typeof sendUserMessage === \"function\";\n\tlet watcher: fs.FSWatcher | undefined;\n\tlet interval: NodeJS.Timeout | undefined;\n\tconst acknowledge = (request: SteerRequest, state: \"delivered\" | \"failed\", message: string): void => {\n\t\tif (!ackDir || !Number.isInteger(childIndex) || childIndex < 0) return;\n\t\twriteSteerAckAt(steerAckPathFromDir(ackDir, request.id), {\n\t\t\trequestId: request.id,\n\t\t\tindex: childIndex,\n\t\t\tts: Date.now(),\n\t\t\tstate,\n\t\t\tmessage,\n\t\t});\n\t};\n\tconst publishCapability = (): void => {\n\t\tif (!capabilityPath || !Number.isInteger(childIndex) || childIndex < 0) return;\n\t\twriteSteerCapabilityAt(capabilityPath, { index: childIndex, pid: process.pid, readyAt: Date.now(), supported: canSteer });\n\t};\n\tconst flush = (): void => {\n\t\tif (disposed || flushing) return;\n\t\tflushing = true;\n\t\ttry {\n\t\t\tconst requests = consumeSteerRequestsFromDir(steerInbox);\n\t\t\tfor (let index = 0; index < requests.length; index++) {\n\t\t\t\tconst request = requests[index]!;\n\t\t\t\tif (!canSteer || typeof sendUserMessage !== \"function\") {\n\t\t\t\t\tacknowledge(request, \"failed\", \"Child Pi session does not support sendUserMessage steering.\");\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tconst formatted = formatSteerMessage(request);\n\t\t\t\tconst ids = pending.get(formatted) ?? [];\n\t\t\t\tids.push(request.id);\n\t\t\t\tpending.set(formatted, ids);\n\t\t\t\ttry {\n\t\t\t\t\tsendUserMessage(formatted, { deliverAs: \"steer\" });\n\t\t\t\t} catch (error) {\n\t\t\t\t\tids.pop();\n\t\t\t\t\tif (ids.length === 0) pending.delete(formatted);\n\t\t\t\t\tacknowledge(request, \"failed\", error instanceof Error ? error.message : String(error));\n\t\t\t\t\tfor (const retry of requests.slice(index + 1)) writeSteerRequestToDir(steerInbox, retry);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t} finally {\n\t\t\tflushing = false;\n\t\t}\n\t};\n\tconst onInput = (event: unknown): undefined => {\n\t\tif (disposed || !event || typeof event !== \"object\") return undefined;\n\t\tconst input = event as { source?: unknown; streamingBehavior?: unknown; text?: unknown; content?: unknown };\n\t\tif (input.source !== \"extension\" || input.streamingBehavior !== \"steer\") return undefined;\n\t\tconst text = typeof input.text === \"string\" ? input.text : typeof input.content === \"string\" ? input.content : undefined;\n\t\tif (!text) return undefined;\n\t\tconst ids = pending.get(text);\n\t\tconst requestId = ids?.shift();\n\t\tif (!requestId) return undefined;\n\t\tif (ids?.length === 0) pending.delete(text);\n\t\tacknowledge({ type: \"steer\", id: requestId, ts: Date.now(), message: text }, \"delivered\", \"Pi accepted the correlated steering input.\");\n\t\treturn undefined;\n\t};\n\tconst start = (): void => {\n\t\tif (started || disposed) return;\n\t\ttry {\n\t\t\tfs.mkdirSync(steerInbox, { recursive: true });\n\t\t\tpublishCapability();\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\t\tstarted = true;\n\t\ttry {\n\t\t\twatcher = (deps.watch ?? fs.watch)(resolveWatchPath(steerInbox, deps.nativeRealpath), () => flush());\n\t\t\twatcher.on(\"error\", () => {});\n\t\t} catch {\n\t\t\twatcher = undefined;\n\t\t}\n\t\tinterval = setInterval(flush, 250);\n\t\tinterval.unref?.();\n\t};\n\tconst activate = (): undefined => {\n\t\tstart();\n\t\tflush();\n\t\treturn undefined;\n\t};\n\n\tconst onRuntimeEvent = pi.on as unknown as (event: string, handler: (event: unknown) => unknown) => void;\n\t// Register input before the watcher so an accepted extension input cannot race request dispatch.\n\tonRuntimeEvent(\"input\", onInput);\n\tonRuntimeEvent(\"session_start\", () => start());\n\tfor (const eventName of [\"message_start\", \"message_update\", \"message_end\", \"tool_execution_start\", \"tool_execution_end\", \"turn_end\"] as const) {\n\t\tonRuntimeEvent(eventName, activate);\n\t}\n\tonRuntimeEvent(\"session_shutdown\", () => {\n\t\tdisposed = true;\n\t\ttry { watcher?.close(); } catch {}\n\t\tif (interval) clearInterval(interval);\n\t});\n}\n\nexport default function registerSubagentPromptRuntime(pi: ExtensionAPI): void {\n\tregisterSteeringInbox(pi);\n\tregisterToolBudget(pi, decodeToolBudgetEnv(process.env[TOOL_BUDGET_ENV]));\n\tregisterChildWatchdog(pi);\n\tconst waitToolEnabled = resolveWaitToolConfig().enabled;\n\tconst waitState = {\n\t\tbaseCwd: \"\",\n\t\tcurrentSessionId: null,\n\t\tasyncJobs: new Map(),\n\t\tforegroundControls: new Map(),\n\t\tlastForegroundControlId: null,\n\t\tcleanupTimers: new Map(),\n\t\tlastUiContext: null,\n\t\tpoller: null,\n\t\tcompletionSeen: new Map(),\n\t\twatcher: null,\n\t\twatcherRestartTimer: null,\n\t\tresultFileCoalescer: { schedule: () => false, clear: () => {} },\n\t} as unknown as SubagentState;\n\tif (typeof pi.registerTool === \"function\") registerWaitTool(pi, waitState, waitToolEnabled);\n\tlet nativeSupervisorClientRegistered = false;\n\tlet nativeSupervisorFallbackRegistered = false;\n\tconst registerNativeSupervisorClientOnce = (): void => {\n\t\tif (nativeSupervisorClientRegistered) return;\n\t\tnativeSupervisorClientRegistered = true;\n\t\tregisterNativeSupervisorClient(pi, { includeIntercomFallback: false });\n\t};\n\tconst registerNativeSupervisorFallbackOnce = (): void => {\n\t\tregisterNativeSupervisorClientOnce();\n\t\tif (nativeSupervisorFallbackRegistered) return;\n\t\tnativeSupervisorFallbackRegistered = true;\n\t\tregisterNativeSupervisorClient(pi);\n\t};\n\tconst onRuntimeEvent = pi.on as unknown as (event: string, handler: (event: unknown) => unknown) => void;\n\tonRuntimeEvent(\"session_start\", (_event: unknown, ctx: unknown) => {\n\t\tconst sessionManager = (ctx as { sessionManager?: Parameters<typeof resolveCurrentSessionId>[0] } | undefined)?.sessionManager;\n\t\twaitState.currentSessionId = sessionManager ? resolveCurrentSessionId(sessionManager) : null;\n\t\tregisterNativeSupervisorClientOnce();\n\t\trefreshChildToolDiagnostic(pi);\n\t});\n\tonRuntimeEvent(\"agent_end\", async (_event: unknown, ctx: unknown) => {\n\t\tif ((ctx as { hasUI?: boolean } | undefined)?.hasUI === true) return;\n\t\tawait drainOutstandingWork({ state: waitState, events: pi.events });\n\t});\n\tconst structuredOutputPath = process.env[STRUCTURED_OUTPUT_CAPTURE_ENV];\n\tconst structuredSchemaPath = process.env[STRUCTURED_OUTPUT_SCHEMA_ENV];\n\tif (structuredOutputPath && structuredSchemaPath) {\n\t\tconst schema = JSON.parse(fs.readFileSync(structuredSchemaPath, \"utf-8\")) as JsonSchemaObject;\n\t\tconst parameters = {\n\t\t\ttype: \"object\",\n\t\t\tproperties: { value: schema },\n\t\t\trequired: [\"value\"],\n\t\t\tadditionalProperties: false,\n\t\t};\n\t\tconst registerTool = pi.registerTool as unknown as (tool: {\n\t\t\tname: string;\n\t\t\tlabel: string;\n\t\t\tdescription: string;\n\t\t\tparameters: unknown;\n\t\t\texecute: (_id: string, params: { value: unknown }) => Promise<unknown>;\n\t\t}) => void;\n\t\tregisterTool({\n\t\t\tname: \"structured_output\",\n\t\t\tlabel: \"Structured Output\",\n\t\t\tdescription: \"Submit the required final structured output for this subagent step. This terminates the step.\",\n\t\t\tparameters: parameters as never,\n\t\t\tasync execute(_id: string, params: { value: unknown }) {\n\t\t\t\tconst validation = validateStructuredOutputValue(schema, params.value);\n\t\t\t\tif (validation.status === \"invalid\") {\n\t\t\t\t\tthrow new Error(`Structured output validation failed: ${validation.message}`);\n\t\t\t\t}\n\t\t\t\tfs.mkdirSync(path.dirname(structuredOutputPath), { recursive: true });\n\t\t\t\tfs.writeFileSync(structuredOutputPath, JSON.stringify(params.value), { mode: 0o600 });\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Structured output captured.\" }],\n\t\t\t\t\tdetails: { path: structuredOutputPath },\n\t\t\t\t\tterminate: true,\n\t\t\t\t};\n\t\t\t},\n\t\t});\n\t}\n\n\tonRuntimeEvent(\"context\", (event: { messages: unknown[] }) => {\n\t\tconst messages = stripParentOnlySubagentMessages(event.messages);\n\t\tif (messages === event.messages) return undefined;\n\t\treturn { messages };\n\t});\n\n\tonRuntimeEvent(\"before_agent_start\", async (event: { systemPrompt: string }) => {\n\t\tregisterNativeSupervisorFallbackOnce();\n\t\tconst toolDiagnostic = refreshChildToolDiagnostic(pi);\n\t\tconst intercomSessionName = process.env[SUBAGENT_INTERCOM_SESSION_NAME_ENV]?.trim();\n\t\tif (intercomSessionName && typeof pi.setSessionName === \"function\") {\n\t\t\tpi.setSessionName(intercomSessionName);\n\t\t}\n\n\t\tconst inheritProjectContext = readBooleanEnv(SUBAGENT_INHERIT_PROJECT_CONTEXT_ENV);\n\t\tconst inheritSkills = readBooleanEnv(SUBAGENT_INHERIT_SKILLS_ENV);\n\t\tconst fanoutChild = readBooleanEnv(SUBAGENT_FANOUT_CHILD_ENV);\n\t\tlet rewritten = event.systemPrompt;\n\t\tif (inheritProjectContext !== undefined || inheritSkills !== undefined || fanoutChild !== undefined) {\n\t\t\trewritten = rewriteSubagentPrompt(event.systemPrompt, {\n\t\t\t\tinheritProjectContext: inheritProjectContext ?? true,\n\t\t\t\tinheritSkills: inheritSkills ?? true,\n\t\t\t\tfanoutChild: fanoutChild === true,\n\t\t\t});\n\t\t}\n\t\tif (toolDiagnostic) {\n\t\t\trewritten = `${formatChildToolDiagnostic(toolDiagnostic)}\\nDo not claim tool-dependent work succeeded; report this configuration error to the parent.\\n\\n${rewritten}`;\n\t\t}\n\t\tif (rewritten === event.systemPrompt) return;\n\t\treturn { systemPrompt: rewritten };\n\t});\n}\n"]}