@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/runs/background/top-level-async.d.ts

@@ -0,0 +1,8 @@
+interface AsyncOverrideParams {
+    async?: boolean;
+    clarify?: boolean;
+    foregroundOnly?: boolean;
+}
+export declare function applyForceTopLevelAsyncOverride<T extends AsyncOverrideParams>(params: T, depth: number, forceTopLevelAsync: boolean): T;
+export {};
+//# sourceMappingURL=top-level-async.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/top-level-async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"top-level-async.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/top-level-async.ts"],"names":[],"mappings":"AACA,UAAU,mBAAmB;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,+BAA+B,CAAC,CAAC,SAAS,mBAAmB,EAC5E,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,MAAM,EACb,kBAAkB,EAAE,OAAO,GACzB,CAAC,CAGH","sourcesContent":["// @ts-nocheck\ninterface AsyncOverrideParams {\n\tasync?: boolean;\n\tclarify?: boolean;\n\tforegroundOnly?: boolean;\n}\n\nexport function applyForceTopLevelAsyncOverride<T extends AsyncOverrideParams>(\n\tparams: T,\n\tdepth: number,\n\tforceTopLevelAsync: boolean,\n): T {\n\tif (params.foregroundOnly || !(depth === 0 && forceTopLevelAsync)) return params;\n\treturn { ...params, async: true, clarify: false };\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/background/top-level-async.js

@@ -0,0 +1,6 @@
+export function applyForceTopLevelAsyncOverride(params, depth, forceTopLevelAsync) {
+    if (params.foregroundOnly || !(depth === 0 && forceTopLevelAsync))
+        return params;
+    return { ...params, async: true, clarify: false };
+}
+//# sourceMappingURL=top-level-async.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/top-level-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"top-level-async.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/top-level-async.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,+BAA+B,CAC9C,MAAS,EACT,KAAa,EACb,kBAA2B,EACvB;IACJ,IAAI,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,kBAAkB,CAAC;QAAE,OAAO,MAAM,CAAC;IACjF,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAAA,CAClD","sourcesContent":["// @ts-nocheck\ninterface AsyncOverrideParams {\n\tasync?: boolean;\n\tclarify?: boolean;\n\tforegroundOnly?: boolean;\n}\n\nexport function applyForceTopLevelAsyncOverride<T extends AsyncOverrideParams>(\n\tparams: T,\n\tdepth: number,\n\tforceTopLevelAsync: boolean,\n): T {\n\tif (params.foregroundOnly || !(depth === 0 && forceTopLevelAsync)) return params;\n\treturn { ...params, async: true, clarify: false };\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/background/wait-config.d.ts

@@ -0,0 +1,7 @@
+import type { WaitToolConfig } from "../../shared/types.ts";
+export declare const WAIT_TOOL_ENABLED_ENV = "PI_SUBAGENT_WAIT_TOOL_ENABLED";
+export interface ResolvedWaitToolConfig {
+    enabled: boolean;
+}
+export declare function resolveWaitToolConfig(config?: WaitToolConfig, env?: Record<string, string | undefined>): ResolvedWaitToolConfig;
+//# sourceMappingURL=wait-config.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/wait-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-config.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/wait-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,eAAO,MAAM,qBAAqB,kCAAkC,CAAC;AAErE,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,OAAO,CAAC;CACjB;AAyBD,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,sBAAsB,CAI5I","sourcesContent":["// @ts-nocheck\nimport type { WaitToolConfig } from \"../../shared/types.ts\";\n\nexport const WAIT_TOOL_ENABLED_ENV = \"PI_SUBAGENT_WAIT_TOOL_ENABLED\";\n\nexport interface ResolvedWaitToolConfig {\n\tenabled: boolean;\n}\n\nconst TRUE_VALUES = new Set([\"1\", \"true\", \"yes\", \"on\", \"enabled\"]);\nconst FALSE_VALUES = new Set([\"0\", \"false\", \"no\", \"off\", \"disabled\"]);\n\nfunction environmentValue(value: string | undefined): boolean | undefined {\n\tif (value === undefined) return undefined;\n\tconst normalized = value.trim().toLowerCase();\n\tif (TRUE_VALUES.has(normalized)) return true;\n\tif (FALSE_VALUES.has(normalized)) return false;\n\tthrow new Error(`${WAIT_TOOL_ENABLED_ENV} must be one of true/false, 1/0, yes/no, on/off, or enabled/disabled.`);\n}\n\nfunction configuredValue(config: unknown): boolean | undefined {\n\tif (config === undefined) return undefined;\n\tif (typeof config === \"boolean\") return config;\n\tif (!config || typeof config !== \"object\" || Array.isArray(config)) {\n\t\tthrow new Error(\"config.waitTool must be a boolean or an object with optional enabled boolean.\");\n\t}\n\tconst enabled = (config as { enabled?: unknown }).enabled;\n\tif (enabled === undefined) return undefined;\n\tif (typeof enabled !== \"boolean\") throw new Error(\"config.waitTool.enabled must be a boolean.\");\n\treturn enabled;\n}\n\nexport function resolveWaitToolConfig(config?: WaitToolConfig, env: Record<string, string | undefined> = process.env): ResolvedWaitToolConfig {\n\treturn {\n\t\tenabled: environmentValue(env[WAIT_TOOL_ENABLED_ENV]) ?? configuredValue(config) ?? true,\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/background/wait-config.js

@@ -0,0 +1,34 @@
+export const WAIT_TOOL_ENABLED_ENV = "PI_SUBAGENT_WAIT_TOOL_ENABLED";
+const TRUE_VALUES = new Set(["1", "true", "yes", "on", "enabled"]);
+const FALSE_VALUES = new Set(["0", "false", "no", "off", "disabled"]);
+function environmentValue(value) {
+    if (value === undefined)
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    if (TRUE_VALUES.has(normalized))
+        return true;
+    if (FALSE_VALUES.has(normalized))
+        return false;
+    throw new Error(`${WAIT_TOOL_ENABLED_ENV} must be one of true/false, 1/0, yes/no, on/off, or enabled/disabled.`);
+}
+function configuredValue(config) {
+    if (config === undefined)
+        return undefined;
+    if (typeof config === "boolean")
+        return config;
+    if (!config || typeof config !== "object" || Array.isArray(config)) {
+        throw new Error("config.waitTool must be a boolean or an object with optional enabled boolean.");
+    }
+    const enabled = config.enabled;
+    if (enabled === undefined)
+        return undefined;
+    if (typeof enabled !== "boolean")
+        throw new Error("config.waitTool.enabled must be a boolean.");
+    return enabled;
+}
+export function resolveWaitToolConfig(config, env = process.env) {
+    return {
+        enabled: environmentValue(env[WAIT_TOOL_ENABLED_ENV]) ?? configuredValue(config) ?? true,
+    };
+}
+//# sourceMappingURL=wait-config.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/wait-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-config.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/wait-config.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,qBAAqB,GAAG,+BAA+B,CAAC;AAMrE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;AACnE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;AAEtE,SAAS,gBAAgB,CAAC,KAAyB,EAAuB;IACzE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,IAAI,KAAK,CAAC,GAAG,qBAAqB,uEAAuE,CAAC,CAAC;AAAA,CACjH;AAED,SAAS,eAAe,CAAC,MAAe,EAAuB;IAC9D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,OAAO,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC/C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,OAAO,GAAI,MAAgC,CAAC,OAAO,CAAC;IAC1D,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,OAAO,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChG,OAAO,OAAO,CAAC;AAAA,CACf;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAuB,EAAE,GAAG,GAAuC,OAAO,CAAC,GAAG,EAA0B;IAC7I,OAAO;QACN,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,IAAI,IAAI;KACxF,CAAC;AAAA,CACF","sourcesContent":["// @ts-nocheck\nimport type { WaitToolConfig } from \"../../shared/types.ts\";\n\nexport const WAIT_TOOL_ENABLED_ENV = \"PI_SUBAGENT_WAIT_TOOL_ENABLED\";\n\nexport interface ResolvedWaitToolConfig {\n\tenabled: boolean;\n}\n\nconst TRUE_VALUES = new Set([\"1\", \"true\", \"yes\", \"on\", \"enabled\"]);\nconst FALSE_VALUES = new Set([\"0\", \"false\", \"no\", \"off\", \"disabled\"]);\n\nfunction environmentValue(value: string | undefined): boolean | undefined {\n\tif (value === undefined) return undefined;\n\tconst normalized = value.trim().toLowerCase();\n\tif (TRUE_VALUES.has(normalized)) return true;\n\tif (FALSE_VALUES.has(normalized)) return false;\n\tthrow new Error(`${WAIT_TOOL_ENABLED_ENV} must be one of true/false, 1/0, yes/no, on/off, or enabled/disabled.`);\n}\n\nfunction configuredValue(config: unknown): boolean | undefined {\n\tif (config === undefined) return undefined;\n\tif (typeof config === \"boolean\") return config;\n\tif (!config || typeof config !== \"object\" || Array.isArray(config)) {\n\t\tthrow new Error(\"config.waitTool must be a boolean or an object with optional enabled boolean.\");\n\t}\n\tconst enabled = (config as { enabled?: unknown }).enabled;\n\tif (enabled === undefined) return undefined;\n\tif (typeof enabled !== \"boolean\") throw new Error(\"config.waitTool.enabled must be a boolean.\");\n\treturn enabled;\n}\n\nexport function resolveWaitToolConfig(config?: WaitToolConfig, env: Record<string, string | undefined> = process.env): ResolvedWaitToolConfig {\n\treturn {\n\t\tenabled: environmentValue(env[WAIT_TOOL_ENABLED_ENV]) ?? configuredValue(config) ?? true,\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/background/wait-tool.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { SubagentState } from "../../shared/types.ts";
+export declare function registerWaitTool(pi: ExtensionAPI, state: SubagentState, enabled?: boolean): void;
+//# sourceMappingURL=wait-tool.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/wait-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-tool.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/wait-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,iCAAiC,CAAC;AAEpF,OAAO,KAAK,EAAW,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGpE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,UAAkC,GAAG,IAAI,CAoBxH","sourcesContent":["// @ts-nocheck\nimport type { ExtensionAPI, ToolDefinition } from \"@earendil-works/pi-coding-agent\";\nimport { SubagentWaitParams } from \"../../extension/schemas.ts\";\nimport type { Details, SubagentState } from \"../../shared/types.ts\";\nimport { resolveWaitToolConfig, waitForSubagents } from \"./subagent-wait.ts\";\n\nexport function registerWaitTool(pi: ExtensionAPI, state: SubagentState, enabled = resolveWaitToolConfig().enabled): void {\n\tconst tool: ToolDefinition<typeof SubagentWaitParams, Details> = {\n\t\tname: \"subagent_wait\",\n\t\tlabel: \"Subagent Wait\",\n\t\tdescription: `Block until background work owned by this session changes, then return.\n\nIn an interactive chat, do not call this merely to wait: return control to the user and let Pi wake the session on completion. Call it when the current request must run to completion in this turn, when a skill cannot return before its work finishes, or in a non-interactive run where there is no next turn.\n\n• { } — return when the first initially active async run or registered provider item finishes, or when a subagent needs attention.\n• { all: true } — wait for every async run and provider item that was active when the call began.\n• { id: \"...\" } — wait for one async or remembered detached foreground subagent run (id or prefix).\n• { timeoutMs: 600000 } — stop waiting after N ms; active work keeps running.\n\nProvider jobs are session-scoped and identified exactly, so replacing one job with another cannot hide a completion. Provider extensions must be explicitly loaded in this process. In a child agent, keep \\`subagent_wait\\` in the child tool allowlist and load each provider through the agent's extensions or subagentOnlyExtensions; this tool never loads providers or grants tools itself.${enabled ? \"\" : \"\\n\\nConfigured behavior: subagent_wait is disabled by config.waitTool or PI_SUBAGENT_WAIT_TOOL_ENABLED and returns immediately without blocking.\"}`,\n\t\tparameters: SubagentWaitParams,\n\t\texecute(_id, params, signal) {\n\t\t\treturn waitForSubagents(params, signal, { state, events: pi.events, enabled });\n\t\t},\n\t};\n\tpi.registerTool(tool);\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/background/wait-tool.js

@@ -0,0 +1,24 @@
+import { SubagentWaitParams } from "../../extension/schemas.js";
+import { resolveWaitToolConfig, waitForSubagents } from "./subagent-wait.js";
+export function registerWaitTool(pi, state, enabled = resolveWaitToolConfig().enabled) {
+    const tool = {
+        name: "subagent_wait",
+        label: "Subagent Wait",
+        description: `Block until background work owned by this session changes, then return.
+
+In an interactive chat, do not call this merely to wait: return control to the user and let Pi wake the session on completion. Call it when the current request must run to completion in this turn, when a skill cannot return before its work finishes, or in a non-interactive run where there is no next turn.
+
+• { } — return when the first initially active async run or registered provider item finishes, or when a subagent needs attention.
+• { all: true } — wait for every async run and provider item that was active when the call began.
+• { id: "..." } — wait for one async or remembered detached foreground subagent run (id or prefix).
+• { timeoutMs: 600000 } — stop waiting after N ms; active work keeps running.
+
+Provider jobs are session-scoped and identified exactly, so replacing one job with another cannot hide a completion. Provider extensions must be explicitly loaded in this process. In a child agent, keep \`subagent_wait\` in the child tool allowlist and load each provider through the agent's extensions or subagentOnlyExtensions; this tool never loads providers or grants tools itself.${enabled ? "" : "\n\nConfigured behavior: subagent_wait is disabled by config.waitTool or PI_SUBAGENT_WAIT_TOOL_ENABLED and returns immediately without blocking."}`,
+        parameters: SubagentWaitParams,
+        execute(_id, params, signal) {
+            return waitForSubagents(params, signal, { state, events: pi.events, enabled });
+        },
+    };
+    pi.registerTool(tool);
+}
+//# sourceMappingURL=wait-tool.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/wait-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-tool.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/wait-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,MAAM,UAAU,gBAAgB,CAAC,EAAgB,EAAE,KAAoB,EAAE,OAAO,GAAG,qBAAqB,EAAE,CAAC,OAAO,EAAQ;IACzH,MAAM,IAAI,GAAuD;QAChE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE;;;;;;;;;mYASoX,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kJAAkJ,EAAE;QACpiB,UAAU,EAAE,kBAAkB;QAC9B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE;YAC5B,OAAO,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAAA,CAC/E;KACD,CAAC;IACF,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AAAA,CACtB","sourcesContent":["// @ts-nocheck\nimport type { ExtensionAPI, ToolDefinition } from \"@earendil-works/pi-coding-agent\";\nimport { SubagentWaitParams } from \"../../extension/schemas.ts\";\nimport type { Details, SubagentState } from \"../../shared/types.ts\";\nimport { resolveWaitToolConfig, waitForSubagents } from \"./subagent-wait.ts\";\n\nexport function registerWaitTool(pi: ExtensionAPI, state: SubagentState, enabled = resolveWaitToolConfig().enabled): void {\n\tconst tool: ToolDefinition<typeof SubagentWaitParams, Details> = {\n\t\tname: \"subagent_wait\",\n\t\tlabel: \"Subagent Wait\",\n\t\tdescription: `Block until background work owned by this session changes, then return.\n\nIn an interactive chat, do not call this merely to wait: return control to the user and let Pi wake the session on completion. Call it when the current request must run to completion in this turn, when a skill cannot return before its work finishes, or in a non-interactive run where there is no next turn.\n\n• { } — return when the first initially active async run or registered provider item finishes, or when a subagent needs attention.\n• { all: true } — wait for every async run and provider item that was active when the call began.\n• { id: \"...\" } — wait for one async or remembered detached foreground subagent run (id or prefix).\n• { timeoutMs: 600000 } — stop waiting after N ms; active work keeps running.\n\nProvider jobs are session-scoped and identified exactly, so replacing one job with another cannot hide a completion. Provider extensions must be explicitly loaded in this process. In a child agent, keep \\`subagent_wait\\` in the child tool allowlist and load each provider through the agent's extensions or subagentOnlyExtensions; this tool never loads providers or grants tools itself.${enabled ? \"\" : \"\\n\\nConfigured behavior: subagent_wait is disabled by config.waitTool or PI_SUBAGENT_WAIT_TOOL_ENABLED and returns immediately without blocking.\"}`,\n\t\tparameters: SubagentWaitParams,\n\t\texecute(_id, params, signal) {\n\t\t\treturn waitForSubagents(params, signal, { state, events: pi.events, enabled });\n\t\t},\n\t};\n\tpi.registerTool(tool);\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/foreground/async-steering-action.d.ts

@@ -0,0 +1,23 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import type { Details, SubagentState, ToolBudgetConfig, TurnBudgetConfig } from "../../shared/types.ts";
+export declare function steerAsyncRun(input: {
+    state: SubagentState;
+    runId: string;
+    message: string;
+    index?: number;
+    kill?: (pid: number, signal?: NodeJS.Signals | 0) => boolean;
+    location: {
+        asyncDir: string | null;
+    };
+    signal?: AbortSignal;
+    ackTimeoutMs?: number;
+    recoveryTimeoutMs?: number;
+    onRecoveryCommitted?: (requestId: string, committedAt: number) => void;
+    recover?: (limits: {
+        timeoutMs?: number;
+        absoluteDeadlineAt?: number;
+        turnBudget?: TurnBudgetConfig;
+        toolBudget?: ToolBudgetConfig;
+    }) => Promise<AgentToolResult<Details>>;
+}): Promise<AgentToolResult<Details>>;
+//# sourceMappingURL=async-steering-action.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/foreground/async-steering-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-steering-action.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/foreground/async-steering-action.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,KAAK,EAAe,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOrH,wBAAsB,aAAa,CAAC,KAAK,EAAE;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,OAAO,CAAC;IAC7D,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACvE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;KAAE,KAAK,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;CAC3K,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAoMpC","sourcesContent":["// @ts-nocheck\nimport { randomUUID } from \"node:crypto\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { AgentToolResult } from \"@earendil-works/pi-agent-core\";\nimport { writeAtomicJson } from \"../../shared/atomic-json.ts\";\nimport type { AsyncStatus, Details, SubagentState, ToolBudgetConfig, TurnBudgetConfig } from \"../../shared/types.ts\";\nimport { readStatus } from \"../../shared/utils.ts\";\nimport { consumeSteerAcks, deliverInterruptRequest, requestAsyncSteer } from \"../background/control-channel.ts\";\nimport { resolveAsyncResumeTarget } from \"../background/async-resume.ts\";\nimport { reconcileAsyncRun } from \"../background/stale-run-reconciler.ts\";\nimport { actionResultFromSteeringStatus, claimSteeringRecovery, remainingSteeringRecoveryLimits, updateSteeringTarget, waitForSteeringAction } from \"../background/steering.ts\";\n\nexport async function steerAsyncRun(input: {\n\tstate: SubagentState;\n\trunId: string;\n\tmessage: string;\n\tindex?: number;\n\tkill?: (pid: number, signal?: NodeJS.Signals | 0) => boolean;\n\tlocation: { asyncDir: string | null };\n\tsignal?: AbortSignal;\n\tackTimeoutMs?: number;\n\trecoveryTimeoutMs?: number;\n\tonRecoveryCommitted?: (requestId: string, committedAt: number) => void;\n\trecover?: (limits: { timeoutMs?: number; absoluteDeadlineAt?: number; turnBudget?: TurnBudgetConfig; toolBudget?: ToolBudgetConfig }) => Promise<AgentToolResult<Details>>;\n}): Promise<AgentToolResult<Details>> {\n\tif (!input.location.asyncDir) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Async run '${input.runId}' has no live run directory to steer.` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\tconst asyncDir = input.location.asyncDir;\n\tconst status = reconcileAsyncRun(asyncDir, { kill: input.kill }).status;\n\tif (input.state.currentSessionId && status?.sessionId !== input.state.currentSessionId) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Async run '${input.runId}' was not found in the active session.` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\tif (!status || (status.state !== \"running\" && status.state !== \"queued\")) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Async run '${input.runId}' is not running or queued and cannot be steered.` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\tconst steps = status.steps ?? [];\n\tif (input.index !== undefined) {\n\t\tif (input.index < 0 || input.index >= steps.length) {\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: `Async run '${status.runId}' has ${steps.length} children. Index ${input.index} is out of range.` }],\n\t\t\t\tisError: true,\n\t\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t\t};\n\t\t}\n\t\tconst targetStep = steps[input.index];\n\t\tif (targetStep && targetStep.status !== \"running\" && targetStep.status !== \"pending\") {\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: `Async run '${status.runId}' child ${input.index} is ${targetStep.status} and cannot be steered.` }],\n\t\t\t\tisError: true,\n\t\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t\t};\n\t\t}\n\t} else {\n\t\tconst running = steps.filter((step) => step.status === \"running\");\n\t\tif (running.length === 0 && steps.length > 1) {\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: `Async run '${status.runId}' has no running child yet. Provide index to steer a queued child.` }],\n\t\t\t\tisError: true,\n\t\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t\t};\n\t\t}\n\t}\n\tconst runningIndexes = steps\n\t\t.map((step, index) => step.status === \"running\" ? index : undefined)\n\t\t.filter((index): index is number => index !== undefined);\n\tconst effectiveTargetIndex = input.index ?? (status.mode === \"single\" && runningIndexes.length === 0 && steps[0]?.status === \"pending\" ? 0 : undefined);\n\tconst targetIndexes = effectiveTargetIndex !== undefined ? [effectiveTargetIndex] : runningIndexes;\n\tif (targetIndexes.length === 0) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Async run '${status.runId}' has no running child to steer.` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\tconst requestId = randomUUID();\n\ttry {\n\t\trequestAsyncSteer(asyncDir, {\n\t\t\tmessage: input.message,\n\t\t\t...(effectiveTargetIndex !== undefined ? { targetIndex: effectiveTargetIndex } : { targetIndexes }),\n\t\t\tsource: \"steer-action\",\n\t\t\tid: requestId,\n\t\t});\n\t} catch (error) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Failed to queue steering for async run ${status.runId}: ${error instanceof Error ? error.message : String(error)}` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\tconst tracked = input.state.asyncJobs.get(status.runId);\n\tif (tracked) tracked.updatedAt = Date.now();\n\tconst targets = targetIndexes.map((index) => ({ index, state: status.steps?.[index]?.status === \"pending\" ? \"scheduled\" as const : \"pending\" as const }));\n\tif (targets.every((target) => target.state === \"scheduled\")) {\n\t\tconst scheduled = { requestId, state: \"scheduled\" as const, sourceRunId: status.runId, targets };\n\t\treturn { content: [{ type: \"text\", text: `Steering scheduled for async run ${status.runId} (request ${requestId}).` }], details: { mode: \"management\", results: [], steering: scheduled } };\n\t}\n\tconst waited = await waitForSteeringAction({ asyncDir, sourceRunId: status.runId, requestId, timeoutMs: input.ackTimeoutMs ?? 3_000, signal: input.signal });\n\tconst result = waited ?? { requestId, state: \"pending\" as const, sourceRunId: status.runId, targets };\n\tif (input.signal?.aborted) {\n\t\treturn { content: [{ type: \"text\", text: `Steering pending for async run ${status.runId} (request ${requestId}); caller aborted before recovery.` }], details: { mode: \"management\", results: [], steering: result } };\n\t}\n\tconst finalStatus = readStatus(asyncDir);\n\tconst finalResult = finalStatus?.steering ? actionResultFromSteeringStatus(finalStatus.steering, status.runId, requestId) : undefined;\n\tif (finalResult?.state === \"delivered\") {\n\t\treturn { content: [{ type: \"text\", text: `Steering delivered for async run ${status.runId} (request ${requestId}).` }], details: { mode: \"management\", results: [], steering: finalResult } };\n\t}\n\tconst running = (finalStatus?.steps ?? status.steps).filter((step) => step.status === \"running\");\n\tconst recoveryAllowed = status.mode === \"single\" && status.isNested !== true && running.length === 1 && Boolean(finalStatus?.steering) && (input.index === undefined || input.index === 0);\n\tif (recoveryAllowed && finalResult?.state !== \"scheduled\" && input.recover) {\n\t\tconst appendSteeringNotice = (state: \"failed\" | \"recovered\", message: string): void => {\n\t\t\ttry {\n\t\t\t\tfs.appendFileSync(path.join(asyncDir, \"events.jsonl\"), `${JSON.stringify({ type: \"subagent.steering.notice\", ts: Date.now(), runId: status.runId, requestId, state, message, ...(status.sessionId ? { currentSessionId: status.sessionId } : {}) })}\\n`);\n\t\t\t} catch {\n\t\t\t\t// The action result and status remain authoritative if diagnostic notification persistence fails.\n\t\t\t}\n\t\t};\n\t\ttry {\n\t\t\tconst latest = readStatus(asyncDir);\n\t\t\tconst latestResult = latest?.steering ? actionResultFromSteeringStatus(latest.steering, status.runId, requestId) : undefined;\n\t\t\tif (latestResult?.state === \"delivered\") return { content: [{ type: \"text\", text: `Steering delivered for async run ${status.runId} (request ${requestId}).` }], details: { mode: \"management\", results: [], steering: latestResult } };\n\t\t\tconst committedAt = Date.now();\n\t\t\tconst { claimPath, markerPath } = claimSteeringRecovery(asyncDir, { requestId, sourceRunId: status.runId, committedAt });\n\t\t\tinput.onRecoveryCommitted?.(requestId, committedAt);\n\t\t\tconst preCommitStatus = readStatus(asyncDir);\n\t\t\tconst preCommitResult = preCommitStatus?.steering ? actionResultFromSteeringStatus(preCommitStatus.steering, status.runId, requestId) : undefined;\n\t\t\tif (preCommitResult?.state === \"delivered\" && preCommitResult.targets.every((target) => target.deliveredAt !== undefined && target.deliveredAt <= committedAt)) {\n\t\t\t\tfs.rmSync(markerPath, { force: true });\n\t\t\t\tfs.rmSync(claimPath, { force: true });\n\t\t\t\treturn { content: [{ type: \"text\", text: `Steering delivered for async run ${status.runId} (request ${requestId}).` }], details: { mode: \"management\", results: [], steering: preCommitResult } };\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tdeliverInterruptRequest({ asyncDir, pid: latest?.pid ?? status.pid, kill: input.kill, source: \"steering-recovery\" });\n\t\t\t} catch (error) {\n\t\t\t\tfs.rmSync(markerPath, { force: true });\n\t\t\t\tfs.rmSync(claimPath, { force: true });\n\t\t\t\tthrow new Error(`Failed to commit steering recovery interrupt: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t}\n\t\t\tconst pauseDeadline = Date.now() + (input.recoveryTimeoutMs ?? 15_000);\n\t\t\tlet paused: AsyncStatus | null = null;\n\t\t\twhile (Date.now() <= pauseDeadline) {\n\t\t\t\tif (input.signal?.aborted) break;\n\t\t\t\tconst candidate = readStatus(asyncDir);\n\t\t\t\tif (candidate?.state === \"paused\" && candidate.endedAt !== undefined) { paused = candidate; break; }\n\t\t\t\tawait new Promise<void>((resolve) => setTimeout(resolve, 50));\n\t\t\t}\n\t\t\tif (!paused) throw new Error(\"Source run did not reach confirmed paused state within 15 seconds; no replacement was launched and the recovery claim remains committed to prevent a delayed duplicate.\");\n\t\t\tlet lateAckRecorded = false;\n\t\t\tfor (const ack of consumeSteerAcks(asyncDir)) {\n\t\t\t\tif (!paused.steering?.recent.some((request) => request.id === ack.requestId && request.targets.some((target) => target.index === ack.index))) continue;\n\t\t\t\tconst state = ack.state === \"delivered\" ? \"late\" : \"failed\";\n\t\t\t\tconst reason = ack.state === \"delivered\" ? \"acknowledged after recovery commit\" : ack.message;\n\t\t\t\tupdateSteeringTarget(paused.steering, ack.requestId, ack.index, state, ack.ts, { reason });\n\t\t\t\tconst stepSteering = paused.steps?.[ack.index]?.steering;\n\t\t\t\tif (stepSteering) updateSteeringTarget(stepSteering, ack.requestId, ack.index, state, ack.ts, { reason });\n\t\t\t\tlateAckRecorded = true;\n\t\t\t\ttry {\n\t\t\t\t\tfs.appendFileSync(path.join(asyncDir, \"events.jsonl\"), `${JSON.stringify({ type: ack.state === \"delivered\" ? \"subagent.steer.delivered\" : \"subagent.steer.failed\", ts: ack.ts, runId: status.runId, requestId: ack.requestId, index: ack.index, late: true, message: ack.message })}\\n`);\n\t\t\t\t} catch {\n\t\t\t\t\t// Status remains authoritative when diagnostic event persistence fails.\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (lateAckRecorded) writeAtomicJson(path.join(asyncDir, \"status.json\"), paused);\n\t\t\tlet recoveryTarget;\n\t\t\ttry {\n\t\t\t\trecoveryTarget = resolveAsyncResumeTarget({ id: status.runId }, { kill: input.kill });\n\t\t\t} catch (error) {\n\t\t\t\tthrow new Error(`Source run remains paused and cannot be revived safely: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t}\n\t\t\tif (recoveryTarget.kind !== \"revive\" || !recoveryTarget.sessionFile) throw new Error(\"Source run has no valid persisted child session; it remains paused and requires a new run.\");\n\t\t\tif (!recoveryTarget.recoveryDescriptor) throw new Error(\"Source run has no private recovery descriptor; it remains paused and is not safely resumable.\");\n\t\t\tconst limits = remainingSteeringRecoveryLimits(recoveryTarget.recoveryDescriptor, paused);\n\t\t\tconst revived = await input.recover(limits);\n\t\t\tif (revived.isError || !revived.details.asyncId) throw new Error(revived.content[0]?.type === \"text\" ? revived.content[0].text : \"Replacement launch failed; source run remains paused.\");\n\t\t\tconst sourceStatus = readStatus(asyncDir);\n\t\t\tconst targetIndex = input.index ?? status.steps.findIndex((step) => step.status === \"running\");\n\t\t\tif (sourceStatus?.state === \"paused\" && sourceStatus.steering && targetIndex >= 0) {\n\t\t\t\tupdateSteeringTarget(sourceStatus.steering, requestId, targetIndex, \"recovered\", Date.now(), { replacementRunId: revived.details.asyncId });\n\t\t\t\tconst stepSteering = sourceStatus.steps?.[targetIndex]?.steering;\n\t\t\t\tif (stepSteering) updateSteeringTarget(stepSteering, requestId, targetIndex, \"recovered\", Date.now(), { replacementRunId: revived.details.asyncId });\n\t\t\t\twriteAtomicJson(path.join(asyncDir, \"status.json\"), sourceStatus);\n\t\t\t}\n\t\t\tconst recovered = sourceStatus?.steering ? actionResultFromSteeringStatus(sourceStatus.steering, status.runId, requestId, revived.details.asyncId) : undefined;\n\t\t\tappendSteeringNotice(\"recovered\", `Steering recovered for run ${status.runId}; replacement ${revived.details.asyncId} launched.`);\n\t\t\treturn { content: [{ type: \"text\", text: `Steering recovered for async run ${status.runId}; replacement ${revived.details.asyncId} launched after the source paused.` }], details: { mode: \"management\", results: [], steering: recovered ?? { requestId, state: \"recovered\", sourceRunId: status.runId, replacementRunId: revived.details.asyncId, targets: [{ index: input.index ?? 0, state: \"recovered\" }] } } };\n\t\t} catch (error) {\n\t\t\tconst reason = error instanceof Error ? error.message : String(error);\n\t\t\tconst failedStatus = readStatus(asyncDir);\n\t\t\tconst targetIndex = input.index ?? status.steps.findIndex((step) => step.status === \"running\");\n\t\t\tif (failedStatus && failedStatus.state !== \"running\" && failedStatus.state !== \"queued\" && failedStatus.steering && targetIndex >= 0) {\n\t\t\t\tupdateSteeringTarget(failedStatus.steering, requestId, targetIndex, \"failed\", Date.now(), { reason });\n\t\t\t\tconst stepSteering = failedStatus.steps?.[targetIndex]?.steering;\n\t\t\t\tif (stepSteering) updateSteeringTarget(stepSteering, requestId, targetIndex, \"failed\", Date.now(), { reason });\n\t\t\t\tfailedStatus.activityState = \"needs_attention\";\n\t\t\t\twriteAtomicJson(path.join(asyncDir, \"status.json\"), failedStatus);\n\t\t\t}\n\t\t\tconst failed = failedStatus?.steering ? actionResultFromSteeringStatus(failedStatus.steering, status.runId, requestId) : undefined;\n\t\t\tappendSteeringNotice(\"failed\", `Steering failed for run ${status.runId}: ${reason}`);\n\t\t\treturn { content: [{ type: \"text\", text: `Steering failed for async run ${status.runId} (request ${requestId}): ${reason}` }], isError: true, details: { mode: \"management\", results: [], steering: failed ?? { requestId, state: \"failed\", sourceRunId: status.runId, targets: [{ index: input.index ?? 0, state: \"failed\", reason }] } } };\n\t\t}\n\t}\n\tconst stateText = result.state === \"delivered\" ? \"delivered\" : result.state === \"scheduled\" ? \"scheduled\" : result.state === \"recovered\" ? \"recovered\" : result.state === \"failed\" ? \"failed\" : result.state === \"partial\" ? \"partial\" : \"pending\";\n\tconst isError = result.state === \"failed\" || result.state === \"partial\";\n\treturn {\n\t\tcontent: [{ type: \"text\", text: `Steering ${stateText} for async run ${status.runId} (request ${requestId}).` }],\n\t\t...(isError ? { isError: true } : {}),\n\t\tdetails: { mode: \"management\", results: [], steering: result },\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/foreground/async-steering-action.js

@@ -0,0 +1,230 @@
+// @ts-nocheck
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { writeAtomicJson } from "../../shared/atomic-json.js";
+import { readStatus } from "../../shared/utils.js";
+import { consumeSteerAcks, deliverInterruptRequest, requestAsyncSteer } from "../background/control-channel.js";
+import { resolveAsyncResumeTarget } from "../background/async-resume.js";
+import { reconcileAsyncRun } from "../background/stale-run-reconciler.js";
+import { actionResultFromSteeringStatus, claimSteeringRecovery, remainingSteeringRecoveryLimits, updateSteeringTarget, waitForSteeringAction } from "../background/steering.js";
+export async function steerAsyncRun(input) {
+    if (!input.location.asyncDir) {
+        return {
+            content: [{ type: "text", text: `Async run '${input.runId}' has no live run directory to steer.` }],
+            isError: true,
+            details: { mode: "management", results: [] },
+        };
+    }
+    const asyncDir = input.location.asyncDir;
+    const status = reconcileAsyncRun(asyncDir, { kill: input.kill }).status;
+    if (input.state.currentSessionId && status?.sessionId !== input.state.currentSessionId) {
+        return {
+            content: [{ type: "text", text: `Async run '${input.runId}' was not found in the active session.` }],
+            isError: true,
+            details: { mode: "management", results: [] },
+        };
+    }
+    if (!status || (status.state !== "running" && status.state !== "queued")) {
+        return {
+            content: [{ type: "text", text: `Async run '${input.runId}' is not running or queued and cannot be steered.` }],
+            isError: true,
+            details: { mode: "management", results: [] },
+        };
+    }
+    const steps = status.steps ?? [];
+    if (input.index !== undefined) {
+        if (input.index < 0 || input.index >= steps.length) {
+            return {
+                content: [{ type: "text", text: `Async run '${status.runId}' has ${steps.length} children. Index ${input.index} is out of range.` }],
+                isError: true,
+                details: { mode: "management", results: [] },
+            };
+        }
+        const targetStep = steps[input.index];
+        if (targetStep && targetStep.status !== "running" && targetStep.status !== "pending") {
+            return {
+                content: [{ type: "text", text: `Async run '${status.runId}' child ${input.index} is ${targetStep.status} and cannot be steered.` }],
+                isError: true,
+                details: { mode: "management", results: [] },
+            };
+        }
+    }
+    else {
+        const running = steps.filter((step) => step.status === "running");
+        if (running.length === 0 && steps.length > 1) {
+            return {
+                content: [{ type: "text", text: `Async run '${status.runId}' has no running child yet. Provide index to steer a queued child.` }],
+                isError: true,
+                details: { mode: "management", results: [] },
+            };
+        }
+    }
+    const runningIndexes = steps
+        .map((step, index) => step.status === "running" ? index : undefined)
+        .filter((index) => index !== undefined);
+    const effectiveTargetIndex = input.index ?? (status.mode === "single" && runningIndexes.length === 0 && steps[0]?.status === "pending" ? 0 : undefined);
+    const targetIndexes = effectiveTargetIndex !== undefined ? [effectiveTargetIndex] : runningIndexes;
+    if (targetIndexes.length === 0) {
+        return {
+            content: [{ type: "text", text: `Async run '${status.runId}' has no running child to steer.` }],
+            isError: true,
+            details: { mode: "management", results: [] },
+        };
+    }
+    const requestId = randomUUID();
+    try {
+        requestAsyncSteer(asyncDir, {
+            message: input.message,
+            ...(effectiveTargetIndex !== undefined ? { targetIndex: effectiveTargetIndex } : { targetIndexes }),
+            source: "steer-action",
+            id: requestId,
+        });
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Failed to queue steering for async run ${status.runId}: ${error instanceof Error ? error.message : String(error)}` }],
+            isError: true,
+            details: { mode: "management", results: [] },
+        };
+    }
+    const tracked = input.state.asyncJobs.get(status.runId);
+    if (tracked)
+        tracked.updatedAt = Date.now();
+    const targets = targetIndexes.map((index) => ({ index, state: status.steps?.[index]?.status === "pending" ? "scheduled" : "pending" }));
+    if (targets.every((target) => target.state === "scheduled")) {
+        const scheduled = { requestId, state: "scheduled", sourceRunId: status.runId, targets };
+        return { content: [{ type: "text", text: `Steering scheduled for async run ${status.runId} (request ${requestId}).` }], details: { mode: "management", results: [], steering: scheduled } };
+    }
+    const waited = await waitForSteeringAction({ asyncDir, sourceRunId: status.runId, requestId, timeoutMs: input.ackTimeoutMs ?? 3_000, signal: input.signal });
+    const result = waited ?? { requestId, state: "pending", sourceRunId: status.runId, targets };
+    if (input.signal?.aborted) {
+        return { content: [{ type: "text", text: `Steering pending for async run ${status.runId} (request ${requestId}); caller aborted before recovery.` }], details: { mode: "management", results: [], steering: result } };
+    }
+    const finalStatus = readStatus(asyncDir);
+    const finalResult = finalStatus?.steering ? actionResultFromSteeringStatus(finalStatus.steering, status.runId, requestId) : undefined;
+    if (finalResult?.state === "delivered") {
+        return { content: [{ type: "text", text: `Steering delivered for async run ${status.runId} (request ${requestId}).` }], details: { mode: "management", results: [], steering: finalResult } };
+    }
+    const running = (finalStatus?.steps ?? status.steps).filter((step) => step.status === "running");
+    const recoveryAllowed = status.mode === "single" && status.isNested !== true && running.length === 1 && Boolean(finalStatus?.steering) && (input.index === undefined || input.index === 0);
+    if (recoveryAllowed && finalResult?.state !== "scheduled" && input.recover) {
+        const appendSteeringNotice = (state, message) => {
+            try {
+                fs.appendFileSync(path.join(asyncDir, "events.jsonl"), `${JSON.stringify({ type: "subagent.steering.notice", ts: Date.now(), runId: status.runId, requestId, state, message, ...(status.sessionId ? { currentSessionId: status.sessionId } : {}) })}\n`);
+            }
+            catch {
+                // The action result and status remain authoritative if diagnostic notification persistence fails.
+            }
+        };
+        try {
+            const latest = readStatus(asyncDir);
+            const latestResult = latest?.steering ? actionResultFromSteeringStatus(latest.steering, status.runId, requestId) : undefined;
+            if (latestResult?.state === "delivered")
+                return { content: [{ type: "text", text: `Steering delivered for async run ${status.runId} (request ${requestId}).` }], details: { mode: "management", results: [], steering: latestResult } };
+            const committedAt = Date.now();
+            const { claimPath, markerPath } = claimSteeringRecovery(asyncDir, { requestId, sourceRunId: status.runId, committedAt });
+            input.onRecoveryCommitted?.(requestId, committedAt);
+            const preCommitStatus = readStatus(asyncDir);
+            const preCommitResult = preCommitStatus?.steering ? actionResultFromSteeringStatus(preCommitStatus.steering, status.runId, requestId) : undefined;
+            if (preCommitResult?.state === "delivered" && preCommitResult.targets.every((target) => target.deliveredAt !== undefined && target.deliveredAt <= committedAt)) {
+                fs.rmSync(markerPath, { force: true });
+                fs.rmSync(claimPath, { force: true });
+                return { content: [{ type: "text", text: `Steering delivered for async run ${status.runId} (request ${requestId}).` }], details: { mode: "management", results: [], steering: preCommitResult } };
+            }
+            try {
+                deliverInterruptRequest({ asyncDir, pid: latest?.pid ?? status.pid, kill: input.kill, source: "steering-recovery" });
+            }
+            catch (error) {
+                fs.rmSync(markerPath, { force: true });
+                fs.rmSync(claimPath, { force: true });
+                throw new Error(`Failed to commit steering recovery interrupt: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            const pauseDeadline = Date.now() + (input.recoveryTimeoutMs ?? 15_000);
+            let paused = null;
+            while (Date.now() <= pauseDeadline) {
+                if (input.signal?.aborted)
+                    break;
+                const candidate = readStatus(asyncDir);
+                if (candidate?.state === "paused" && candidate.endedAt !== undefined) {
+                    paused = candidate;
+                    break;
+                }
+                await new Promise((resolve) => setTimeout(resolve, 50));
+            }
+            if (!paused)
+                throw new Error("Source run did not reach confirmed paused state within 15 seconds; no replacement was launched and the recovery claim remains committed to prevent a delayed duplicate.");
+            let lateAckRecorded = false;
+            for (const ack of consumeSteerAcks(asyncDir)) {
+                if (!paused.steering?.recent.some((request) => request.id === ack.requestId && request.targets.some((target) => target.index === ack.index)))
+                    continue;
+                const state = ack.state === "delivered" ? "late" : "failed";
+                const reason = ack.state === "delivered" ? "acknowledged after recovery commit" : ack.message;
+                updateSteeringTarget(paused.steering, ack.requestId, ack.index, state, ack.ts, { reason });
+                const stepSteering = paused.steps?.[ack.index]?.steering;
+                if (stepSteering)
+                    updateSteeringTarget(stepSteering, ack.requestId, ack.index, state, ack.ts, { reason });
+                lateAckRecorded = true;
+                try {
+                    fs.appendFileSync(path.join(asyncDir, "events.jsonl"), `${JSON.stringify({ type: ack.state === "delivered" ? "subagent.steer.delivered" : "subagent.steer.failed", ts: ack.ts, runId: status.runId, requestId: ack.requestId, index: ack.index, late: true, message: ack.message })}\n`);
+                }
+                catch {
+                    // Status remains authoritative when diagnostic event persistence fails.
+                }
+            }
+            if (lateAckRecorded)
+                writeAtomicJson(path.join(asyncDir, "status.json"), paused);
+            let recoveryTarget;
+            try {
+                recoveryTarget = resolveAsyncResumeTarget({ id: status.runId }, { kill: input.kill });
+            }
+            catch (error) {
+                throw new Error(`Source run remains paused and cannot be revived safely: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            if (recoveryTarget.kind !== "revive" || !recoveryTarget.sessionFile)
+                throw new Error("Source run has no valid persisted child session; it remains paused and requires a new run.");
+            if (!recoveryTarget.recoveryDescriptor)
+                throw new Error("Source run has no private recovery descriptor; it remains paused and is not safely resumable.");
+            const limits = remainingSteeringRecoveryLimits(recoveryTarget.recoveryDescriptor, paused);
+            const revived = await input.recover(limits);
+            if (revived.isError || !revived.details.asyncId)
+                throw new Error(revived.content[0]?.type === "text" ? revived.content[0].text : "Replacement launch failed; source run remains paused.");
+            const sourceStatus = readStatus(asyncDir);
+            const targetIndex = input.index ?? status.steps.findIndex((step) => step.status === "running");
+            if (sourceStatus?.state === "paused" && sourceStatus.steering && targetIndex >= 0) {
+                updateSteeringTarget(sourceStatus.steering, requestId, targetIndex, "recovered", Date.now(), { replacementRunId: revived.details.asyncId });
+                const stepSteering = sourceStatus.steps?.[targetIndex]?.steering;
+                if (stepSteering)
+                    updateSteeringTarget(stepSteering, requestId, targetIndex, "recovered", Date.now(), { replacementRunId: revived.details.asyncId });
+                writeAtomicJson(path.join(asyncDir, "status.json"), sourceStatus);
+            }
+            const recovered = sourceStatus?.steering ? actionResultFromSteeringStatus(sourceStatus.steering, status.runId, requestId, revived.details.asyncId) : undefined;
+            appendSteeringNotice("recovered", `Steering recovered for run ${status.runId}; replacement ${revived.details.asyncId} launched.`);
+            return { content: [{ type: "text", text: `Steering recovered for async run ${status.runId}; replacement ${revived.details.asyncId} launched after the source paused.` }], details: { mode: "management", results: [], steering: recovered ?? { requestId, state: "recovered", sourceRunId: status.runId, replacementRunId: revived.details.asyncId, targets: [{ index: input.index ?? 0, state: "recovered" }] } } };
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            const failedStatus = readStatus(asyncDir);
+            const targetIndex = input.index ?? status.steps.findIndex((step) => step.status === "running");
+            if (failedStatus && failedStatus.state !== "running" && failedStatus.state !== "queued" && failedStatus.steering && targetIndex >= 0) {
+                updateSteeringTarget(failedStatus.steering, requestId, targetIndex, "failed", Date.now(), { reason });
+                const stepSteering = failedStatus.steps?.[targetIndex]?.steering;
+                if (stepSteering)
+                    updateSteeringTarget(stepSteering, requestId, targetIndex, "failed", Date.now(), { reason });
+                failedStatus.activityState = "needs_attention";
+                writeAtomicJson(path.join(asyncDir, "status.json"), failedStatus);
+            }
+            const failed = failedStatus?.steering ? actionResultFromSteeringStatus(failedStatus.steering, status.runId, requestId) : undefined;
+            appendSteeringNotice("failed", `Steering failed for run ${status.runId}: ${reason}`);
+            return { content: [{ type: "text", text: `Steering failed for async run ${status.runId} (request ${requestId}): ${reason}` }], isError: true, details: { mode: "management", results: [], steering: failed ?? { requestId, state: "failed", sourceRunId: status.runId, targets: [{ index: input.index ?? 0, state: "failed", reason }] } } };
+        }
+    }
+    const stateText = result.state === "delivered" ? "delivered" : result.state === "scheduled" ? "scheduled" : result.state === "recovered" ? "recovered" : result.state === "failed" ? "failed" : result.state === "partial" ? "partial" : "pending";
+    const isError = result.state === "failed" || result.state === "partial";
+    return {
+        content: [{ type: "text", text: `Steering ${stateText} for async run ${status.runId} (request ${requestId}).` }],
+        ...(isError ? { isError: true } : {}),
+        details: { mode: "management", results: [], steering: result },
+    };
+}
+//# sourceMappingURL=async-steering-action.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/foreground/async-steering-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-steering-action.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/foreground/async-steering-action.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport { randomUUID } from \"node:crypto\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { AgentToolResult } from \"@earendil-works/pi-agent-core\";\nimport { writeAtomicJson } from \"../../shared/atomic-json.ts\";\nimport type { AsyncStatus, Details, SubagentState, ToolBudgetConfig, TurnBudgetConfig } from \"../../shared/types.ts\";\nimport { readStatus } from \"../../shared/utils.ts\";\nimport { consumeSteerAcks, deliverInterruptRequest, requestAsyncSteer } from \"../background/control-channel.ts\";\nimport { resolveAsyncResumeTarget } from \"../background/async-resume.ts\";\nimport { reconcileAsyncRun } from \"../background/stale-run-reconciler.ts\";\nimport { actionResultFromSteeringStatus, claimSteeringRecovery, remainingSteeringRecoveryLimits, updateSteeringTarget, waitForSteeringAction } from \"../background/steering.ts\";\n\nexport async function steerAsyncRun(input: {\n\tstate: SubagentState;\n\trunId: string;\n\tmessage: string;\n\tindex?: number;\n\tkill?: (pid: number, signal?: NodeJS.Signals | 0) => boolean;\n\tlocation: { asyncDir: string | null };\n\tsignal?: AbortSignal;\n\tackTimeoutMs?: number;\n\trecoveryTimeoutMs?: number;\n\tonRecoveryCommitted?: (requestId: string, committedAt: number) => void;\n\trecover?: (limits: { timeoutMs?: number; absoluteDeadlineAt?: number; turnBudget?: TurnBudgetConfig; toolBudget?: ToolBudgetConfig }) => Promise<AgentToolResult<Details>>;\n}): Promise<AgentToolResult<Details>> {\n\tif (!input.location.asyncDir) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Async run '${input.runId}' has no live run directory to steer.` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\tconst asyncDir = input.location.asyncDir;\n\tconst status = reconcileAsyncRun(asyncDir, { kill: input.kill }).status;\n\tif (input.state.currentSessionId && status?.sessionId !== input.state.currentSessionId) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Async run '${input.runId}' was not found in the active session.` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\tif (!status || (status.state !== \"running\" && status.state !== \"queued\")) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Async run '${input.runId}' is not running or queued and cannot be steered.` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\tconst steps = status.steps ?? [];\n\tif (input.index !== undefined) {\n\t\tif (input.index < 0 || input.index >= steps.length) {\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: `Async run '${status.runId}' has ${steps.length} children. Index ${input.index} is out of range.` }],\n\t\t\t\tisError: true,\n\t\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t\t};\n\t\t}\n\t\tconst targetStep = steps[input.index];\n\t\tif (targetStep && targetStep.status !== \"running\" && targetStep.status !== \"pending\") {\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: `Async run '${status.runId}' child ${input.index} is ${targetStep.status} and cannot be steered.` }],\n\t\t\t\tisError: true,\n\t\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t\t};\n\t\t}\n\t} else {\n\t\tconst running = steps.filter((step) => step.status === \"running\");\n\t\tif (running.length === 0 && steps.length > 1) {\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: `Async run '${status.runId}' has no running child yet. Provide index to steer a queued child.` }],\n\t\t\t\tisError: true,\n\t\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t\t};\n\t\t}\n\t}\n\tconst runningIndexes = steps\n\t\t.map((step, index) => step.status === \"running\" ? index : undefined)\n\t\t.filter((index): index is number => index !== undefined);\n\tconst effectiveTargetIndex = input.index ?? (status.mode === \"single\" && runningIndexes.length === 0 && steps[0]?.status === \"pending\" ? 0 : undefined);\n\tconst targetIndexes = effectiveTargetIndex !== undefined ? [effectiveTargetIndex] : runningIndexes;\n\tif (targetIndexes.length === 0) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Async run '${status.runId}' has no running child to steer.` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\tconst requestId = randomUUID();\n\ttry {\n\t\trequestAsyncSteer(asyncDir, {\n\t\t\tmessage: input.message,\n\t\t\t...(effectiveTargetIndex !== undefined ? { targetIndex: effectiveTargetIndex } : { targetIndexes }),\n\t\t\tsource: \"steer-action\",\n\t\t\tid: requestId,\n\t\t});\n\t} catch (error) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Failed to queue steering for async run ${status.runId}: ${error instanceof Error ? error.message : String(error)}` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"management\", results: [] },\n\t\t};\n\t}\n\tconst tracked = input.state.asyncJobs.get(status.runId);\n\tif (tracked) tracked.updatedAt = Date.now();\n\tconst targets = targetIndexes.map((index) => ({ index, state: status.steps?.[index]?.status === \"pending\" ? \"scheduled\" as const : \"pending\" as const }));\n\tif (targets.every((target) => target.state === \"scheduled\")) {\n\t\tconst scheduled = { requestId, state: \"scheduled\" as const, sourceRunId: status.runId, targets };\n\t\treturn { content: [{ type: \"text\", text: `Steering scheduled for async run ${status.runId} (request ${requestId}).` }], details: { mode: \"management\", results: [], steering: scheduled } };\n\t}\n\tconst waited = await waitForSteeringAction({ asyncDir, sourceRunId: status.runId, requestId, timeoutMs: input.ackTimeoutMs ?? 3_000, signal: input.signal });\n\tconst result = waited ?? { requestId, state: \"pending\" as const, sourceRunId: status.runId, targets };\n\tif (input.signal?.aborted) {\n\t\treturn { content: [{ type: \"text\", text: `Steering pending for async run ${status.runId} (request ${requestId}); caller aborted before recovery.` }], details: { mode: \"management\", results: [], steering: result } };\n\t}\n\tconst finalStatus = readStatus(asyncDir);\n\tconst finalResult = finalStatus?.steering ? actionResultFromSteeringStatus(finalStatus.steering, status.runId, requestId) : undefined;\n\tif (finalResult?.state === \"delivered\") {\n\t\treturn { content: [{ type: \"text\", text: `Steering delivered for async run ${status.runId} (request ${requestId}).` }], details: { mode: \"management\", results: [], steering: finalResult } };\n\t}\n\tconst running = (finalStatus?.steps ?? status.steps).filter((step) => step.status === \"running\");\n\tconst recoveryAllowed = status.mode === \"single\" && status.isNested !== true && running.length === 1 && Boolean(finalStatus?.steering) && (input.index === undefined || input.index === 0);\n\tif (recoveryAllowed && finalResult?.state !== \"scheduled\" && input.recover) {\n\t\tconst appendSteeringNotice = (state: \"failed\" | \"recovered\", message: string): void => {\n\t\t\ttry {\n\t\t\t\tfs.appendFileSync(path.join(asyncDir, \"events.jsonl\"), `${JSON.stringify({ type: \"subagent.steering.notice\", ts: Date.now(), runId: status.runId, requestId, state, message, ...(status.sessionId ? { currentSessionId: status.sessionId } : {}) })}\\n`);\n\t\t\t} catch {\n\t\t\t\t// The action result and status remain authoritative if diagnostic notification persistence fails.\n\t\t\t}\n\t\t};\n\t\ttry {\n\t\t\tconst latest = readStatus(asyncDir);\n\t\t\tconst latestResult = latest?.steering ? actionResultFromSteeringStatus(latest.steering, status.runId, requestId) : undefined;\n\t\t\tif (latestResult?.state === \"delivered\") return { content: [{ type: \"text\", text: `Steering delivered for async run ${status.runId} (request ${requestId}).` }], details: { mode: \"management\", results: [], steering: latestResult } };\n\t\t\tconst committedAt = Date.now();\n\t\t\tconst { claimPath, markerPath } = claimSteeringRecovery(asyncDir, { requestId, sourceRunId: status.runId, committedAt });\n\t\t\tinput.onRecoveryCommitted?.(requestId, committedAt);\n\t\t\tconst preCommitStatus = readStatus(asyncDir);\n\t\t\tconst preCommitResult = preCommitStatus?.steering ? actionResultFromSteeringStatus(preCommitStatus.steering, status.runId, requestId) : undefined;\n\t\t\tif (preCommitResult?.state === \"delivered\" && preCommitResult.targets.every((target) => target.deliveredAt !== undefined && target.deliveredAt <= committedAt)) {\n\t\t\t\tfs.rmSync(markerPath, { force: true });\n\t\t\t\tfs.rmSync(claimPath, { force: true });\n\t\t\t\treturn { content: [{ type: \"text\", text: `Steering delivered for async run ${status.runId} (request ${requestId}).` }], details: { mode: \"management\", results: [], steering: preCommitResult } };\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tdeliverInterruptRequest({ asyncDir, pid: latest?.pid ?? status.pid, kill: input.kill, source: \"steering-recovery\" });\n\t\t\t} catch (error) {\n\t\t\t\tfs.rmSync(markerPath, { force: true });\n\t\t\t\tfs.rmSync(claimPath, { force: true });\n\t\t\t\tthrow new Error(`Failed to commit steering recovery interrupt: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t}\n\t\t\tconst pauseDeadline = Date.now() + (input.recoveryTimeoutMs ?? 15_000);\n\t\t\tlet paused: AsyncStatus | null = null;\n\t\t\twhile (Date.now() <= pauseDeadline) {\n\t\t\t\tif (input.signal?.aborted) break;\n\t\t\t\tconst candidate = readStatus(asyncDir);\n\t\t\t\tif (candidate?.state === \"paused\" && candidate.endedAt !== undefined) { paused = candidate; break; }\n\t\t\t\tawait new Promise<void>((resolve) => setTimeout(resolve, 50));\n\t\t\t}\n\t\t\tif (!paused) throw new Error(\"Source run did not reach confirmed paused state within 15 seconds; no replacement was launched and the recovery claim remains committed to prevent a delayed duplicate.\");\n\t\t\tlet lateAckRecorded = false;\n\t\t\tfor (const ack of consumeSteerAcks(asyncDir)) {\n\t\t\t\tif (!paused.steering?.recent.some((request) => request.id === ack.requestId && request.targets.some((target) => target.index === ack.index))) continue;\n\t\t\t\tconst state = ack.state === \"delivered\" ? \"late\" : \"failed\";\n\t\t\t\tconst reason = ack.state === \"delivered\" ? \"acknowledged after recovery commit\" : ack.message;\n\t\t\t\tupdateSteeringTarget(paused.steering, ack.requestId, ack.index, state, ack.ts, { reason });\n\t\t\t\tconst stepSteering = paused.steps?.[ack.index]?.steering;\n\t\t\t\tif (stepSteering) updateSteeringTarget(stepSteering, ack.requestId, ack.index, state, ack.ts, { reason });\n\t\t\t\tlateAckRecorded = true;\n\t\t\t\ttry {\n\t\t\t\t\tfs.appendFileSync(path.join(asyncDir, \"events.jsonl\"), `${JSON.stringify({ type: ack.state === \"delivered\" ? \"subagent.steer.delivered\" : \"subagent.steer.failed\", ts: ack.ts, runId: status.runId, requestId: ack.requestId, index: ack.index, late: true, message: ack.message })}\\n`);\n\t\t\t\t} catch {\n\t\t\t\t\t// Status remains authoritative when diagnostic event persistence fails.\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (lateAckRecorded) writeAtomicJson(path.join(asyncDir, \"status.json\"), paused);\n\t\t\tlet recoveryTarget;\n\t\t\ttry {\n\t\t\t\trecoveryTarget = resolveAsyncResumeTarget({ id: status.runId }, { kill: input.kill });\n\t\t\t} catch (error) {\n\t\t\t\tthrow new Error(`Source run remains paused and cannot be revived safely: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t}\n\t\t\tif (recoveryTarget.kind !== \"revive\" || !recoveryTarget.sessionFile) throw new Error(\"Source run has no valid persisted child session; it remains paused and requires a new run.\");\n\t\t\tif (!recoveryTarget.recoveryDescriptor) throw new Error(\"Source run has no private recovery descriptor; it remains paused and is not safely resumable.\");\n\t\t\tconst limits = remainingSteeringRecoveryLimits(recoveryTarget.recoveryDescriptor, paused);\n\t\t\tconst revived = await input.recover(limits);\n\t\t\tif (revived.isError || !revived.details.asyncId) throw new Error(revived.content[0]?.type === \"text\" ? revived.content[0].text : \"Replacement launch failed; source run remains paused.\");\n\t\t\tconst sourceStatus = readStatus(asyncDir);\n\t\t\tconst targetIndex = input.index ?? status.steps.findIndex((step) => step.status === \"running\");\n\t\t\tif (sourceStatus?.state === \"paused\" && sourceStatus.steering && targetIndex >= 0) {\n\t\t\t\tupdateSteeringTarget(sourceStatus.steering, requestId, targetIndex, \"recovered\", Date.now(), { replacementRunId: revived.details.asyncId });\n\t\t\t\tconst stepSteering = sourceStatus.steps?.[targetIndex]?.steering;\n\t\t\t\tif (stepSteering) updateSteeringTarget(stepSteering, requestId, targetIndex, \"recovered\", Date.now(), { replacementRunId: revived.details.asyncId });\n\t\t\t\twriteAtomicJson(path.join(asyncDir, \"status.json\"), sourceStatus);\n\t\t\t}\n\t\t\tconst recovered = sourceStatus?.steering ? actionResultFromSteeringStatus(sourceStatus.steering, status.runId, requestId, revived.details.asyncId) : undefined;\n\t\t\tappendSteeringNotice(\"recovered\", `Steering recovered for run ${status.runId}; replacement ${revived.details.asyncId} launched.`);\n\t\t\treturn { content: [{ type: \"text\", text: `Steering recovered for async run ${status.runId}; replacement ${revived.details.asyncId} launched after the source paused.` }], details: { mode: \"management\", results: [], steering: recovered ?? { requestId, state: \"recovered\", sourceRunId: status.runId, replacementRunId: revived.details.asyncId, targets: [{ index: input.index ?? 0, state: \"recovered\" }] } } };\n\t\t} catch (error) {\n\t\t\tconst reason = error instanceof Error ? error.message : String(error);\n\t\t\tconst failedStatus = readStatus(asyncDir);\n\t\t\tconst targetIndex = input.index ?? status.steps.findIndex((step) => step.status === \"running\");\n\t\t\tif (failedStatus && failedStatus.state !== \"running\" && failedStatus.state !== \"queued\" && failedStatus.steering && targetIndex >= 0) {\n\t\t\t\tupdateSteeringTarget(failedStatus.steering, requestId, targetIndex, \"failed\", Date.now(), { reason });\n\t\t\t\tconst stepSteering = failedStatus.steps?.[targetIndex]?.steering;\n\t\t\t\tif (stepSteering) updateSteeringTarget(stepSteering, requestId, targetIndex, \"failed\", Date.now(), { reason });\n\t\t\t\tfailedStatus.activityState = \"needs_attention\";\n\t\t\t\twriteAtomicJson(path.join(asyncDir, \"status.json\"), failedStatus);\n\t\t\t}\n\t\t\tconst failed = failedStatus?.steering ? actionResultFromSteeringStatus(failedStatus.steering, status.runId, requestId) : undefined;\n\t\t\tappendSteeringNotice(\"failed\", `Steering failed for run ${status.runId}: ${reason}`);\n\t\t\treturn { content: [{ type: \"text\", text: `Steering failed for async run ${status.runId} (request ${requestId}): ${reason}` }], isError: true, details: { mode: \"management\", results: [], steering: failed ?? { requestId, state: \"failed\", sourceRunId: status.runId, targets: [{ index: input.index ?? 0, state: \"failed\", reason }] } } };\n\t\t}\n\t}\n\tconst stateText = result.state === \"delivered\" ? \"delivered\" : result.state === \"scheduled\" ? \"scheduled\" : result.state === \"recovered\" ? \"recovered\" : result.state === \"failed\" ? \"failed\" : result.state === \"partial\" ? \"partial\" : \"pending\";\n\tconst isError = result.state === \"failed\" || result.state === \"partial\";\n\treturn {\n\t\tcontent: [{ type: \"text\", text: `Steering ${stateText} for async run ${status.runId} (request ${requestId}).` }],\n\t\t...(isError ? { isError: true } : {}),\n\t\tdetails: { mode: \"management\", results: [], steering: result },\n\t};\n}\n"]}