@ashx-j/lunr 0.2.26 → 0.2.28

package/dist/builtin-extensions/pi-prompt-template-model/tool-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-manager.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-prompt-template-model/tool-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAK/G,MAAM,WAAW,eAAe;IAC/B,QAAQ,IAAI,OAAO,CAAC;IACpB,YAAY,IAAI,uBAAuB,GAAG,IAAI,CAAC;IAC/C,YAAY,CAAC,GAAG,EAAE,uBAAuB,GAAG,IAAI,GAAG,IAAI,CAAC;IACxD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe;;;;;;;;EA+MxE","sourcesContent":["// @ts-nocheck\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from \"@ashx-j/lunr\";\nimport { getAgentDir } from \"../../config.ts\";\nimport { Type } from \"typebox\";\nimport { notify } from \"./notifications.ts\";\n\nexport interface ToolManagerDeps {\n\tisActive(): boolean;\n\tgetStoredCtx(): ExtensionCommandContext | null;\n\tsetStoredCtx(ctx: ExtensionCommandContext | null): void;\n\texecuteCommand(command: string, ctx: ExtensionCommandContext): Promise<void>;\n}\n\nexport function createToolManager(pi: ExtensionAPI, deps: ToolManagerDeps) {\n\tlet toolEnabled = false;\n\tlet toolGuidance: string | null = null;\n\tlet toolRegistered = false;\n\tlet toolQueuedCommand: string | null = null;\n\tconst configPath = join(getAgentDir(), \"prompt-template-model.json\");\n\n\ttry {\n\t\tconst rawConfig = JSON.parse(readFileSync(configPath, \"utf-8\"));\n\t\tif (rawConfig && typeof rawConfig === \"object\") {\n\t\t\tconst config = rawConfig as { toolEnabled?: unknown; toolGuidance?: unknown };\n\t\t\tif (typeof config.toolEnabled === \"boolean\") {\n\t\t\t\ttoolEnabled = config.toolEnabled;\n\t\t\t}\n\t\t\tif (typeof config.toolGuidance === \"string\") {\n\t\t\t\ttoolGuidance = config.toolGuidance;\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\tconst err = error as NodeJS.ErrnoException;\n\t\tif (err.code !== \"ENOENT\") {\n\t\t\tprocess.stderr.write(\n\t\t\t\t`[pi-prompt-template-model] Failed to read ${configPath}: ${error instanceof Error ? error.message : String(error)}\\n`,\n\t\t\t);\n\t\t}\n\t}\n\n\tfunction saveToolConfig() {\n\t\ttry {\n\t\t\tmkdirSync(getAgentDir(), { recursive: true });\n\t\t\twriteFileSync(configPath, JSON.stringify({ toolEnabled, toolGuidance }, null, 2));\n\t\t} catch (error) {\n\t\t\tprocess.stderr.write(\n\t\t\t\t`[pi-prompt-template-model] Failed to write ${configPath}: ${error instanceof Error ? error.message : String(error)}\\n`,\n\t\t\t);\n\t\t}\n\t}\n\n\tfunction ensureRegistered() {\n\t\tif (toolRegistered) return;\n\t\ttoolRegistered = true;\n\t\tpi.registerTool({\n\t\t\tname: \"run-prompt\",\n\t\t\tlabel: \"Run Prompt\",\n\t\t\tdescription:\n\t\t\t\t\"Run a prompt template command. Pass the template name and any arguments. \" +\n\t\t\t\t\"Supports --loop for loops (e.g. 'deslop --loop 5', 'deslop --loop=5', 'deslop --loop' for unlimited until convergence with a 999-iteration cap), \" +\n\t\t\t\t\"--fresh for context collapse between iterations, and --no-converge to disable early stopping for bounded loops. \" +\n\t\t\t\t\"Supports runtime delegation override via --subagent, --subagent=<name>, or --subagent:<name>. \" +\n\t\t\t\t\"Use 'chain-prompts template1 -> template2' for chaining and add --chain-context to pass previous step summaries into delegated steps.\",\n\t\t\tpromptSnippet:\n\t\t\t\t\"Use this to run slash/prompt templates by name with args (including --loop/--fresh and chain-prompts flows) when the user asks to execute a prompt template.\",\n\t\t\tparameters: Type.Object({\n\t\t\t\tcommand: Type.String({\n\t\t\t\t\tdescription: \"Template name and arguments (e.g. 'deslop --loop 5 --fresh', 'deslop --subagent:worker', 'deslop --subagent', 'chain-prompts analyze -> fix --chain-context', 'chain-prompts analyze -> fix --loop=3')\",\n\t\t\t\t}),\n\t\t\t}),\n\t\t\texecute: async (_id, params) => {\n\t\t\t\tif (!toolEnabled) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"run-prompt tool is disabled. User must run `/prompt-tool on` to enable.\" }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tif (deps.isActive()) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"A prompt command is already running. Wait for it to complete.\" }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tif (!deps.getStoredCtx()) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No command context. Run any prompt command first to initialize.\" }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t\tisError: true,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst commandParam = (params as { command?: unknown }).command;\n\t\t\t\tconst command = typeof commandParam === \"string\" ? commandParam.trim() : \"\";\n\t\t\t\tif (!command) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No command specified.\" }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t\tisError: true,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tif (toolQueuedCommand) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"A prompt command is already queued. Wait for it to execute.\" }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t\tisError: true,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\ttoolQueuedCommand = command;\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Prompt command queued: \"${command}\". Will execute when this turn ends.` }],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t},\n\t\t});\n\t}\n\n\tfunction registerCommand() {\n\t\tpi.registerCommand(\"prompt-tool\", {\n\t\t\tdescription: \"Manage the run-prompt tool (agent-accessible prompt execution)\",\n\t\t\thandler: async (args, ctx) => {\n\t\t\t\tdeps.setStoredCtx(ctx);\n\t\t\t\tconst trimmed = args.trim();\n\n\t\t\t\tif (trimmed === \"on\" || trimmed.startsWith(\"on \")) {\n\t\t\t\t\ttoolEnabled = true;\n\t\t\t\t\tensureRegistered();\n\t\t\t\t\tconst guidanceRaw = trimmed.slice(\"on\".length).trim();\n\t\t\t\t\tif (guidanceRaw) {\n\t\t\t\t\t\ttoolGuidance = guidanceRaw.replace(/^[\"']|[\"']$/g, \"\");\n\t\t\t\t\t\tnotify(ctx, `run-prompt tool enabled with guidance: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tnotify(ctx, \"run-prompt tool enabled.\", \"info\");\n\t\t\t\t\t}\n\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (trimmed === \"off\") {\n\t\t\t\t\ttoolEnabled = false;\n\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\tnotify(ctx, \"run-prompt tool disabled.\", \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (trimmed === \"guidance\" || trimmed.startsWith(\"guidance \")) {\n\t\t\t\t\tif (trimmed === \"guidance\" || trimmed === \"guidance show\") {\n\t\t\t\t\t\tif (toolGuidance) {\n\t\t\t\t\t\t\tnotify(ctx, `Current guidance: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tnotify(ctx, \"No guidance set. Use `/prompt-tool guidance <text>` to set.\", \"info\");\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (trimmed === \"guidance clear\") {\n\t\t\t\t\t\ttoolGuidance = null;\n\t\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\t\tnotify(ctx, \"Guidance cleared.\", \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tconst guidanceRaw = trimmed.slice(\"guidance\".length).trim();\n\t\t\t\t\t\ttoolGuidance = guidanceRaw.replace(/^[\"']|[\"']$/g, \"\");\n\t\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\t\tnotify(ctx, `Guidance set: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t}\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (!trimmed) {\n\t\t\t\t\tif (toolEnabled) {\n\t\t\t\t\t\tconst guidanceInfo = toolGuidance ? ` | Guidance: \"${toolGuidance}\"` : \"\";\n\t\t\t\t\t\tnotify(ctx, `run-prompt tool is enabled${guidanceInfo}`, \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tnotify(ctx, \"run-prompt tool is disabled\", \"info\");\n\t\t\t\t\t}\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tnotify(ctx, \"Usage: /prompt-tool [on [guidance] | off | guidance [text|clear]]\", \"error\");\n\t\t\t},\n\t\t});\n\t}\n\n\tasync function processQueue(ctx: ExtensionContext, restoreFn: () => Promise<void>) {\n\t\tif (!toolQueuedCommand) return false;\n\t\tconst storedCtx = deps.getStoredCtx();\n\t\tif (!storedCtx) {\n\t\t\ttoolQueuedCommand = null;\n\t\t\treturn false;\n\t\t}\n\n\t\tconst command = toolQueuedCommand;\n\t\ttoolQueuedCommand = null;\n\t\tawait restoreFn();\n\t\ttry {\n\t\t\tawait deps.executeCommand(command, storedCtx);\n\t\t} catch (error) {\n\t\t\tnotify(\n\t\t\t\tctx,\n\t\t\t\t`Failed to execute queued prompt command \"${command}\": ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\"error\",\n\t\t\t);\n\t\t}\n\t\treturn true;\n\t}\n\n\treturn {\n\t\tisEnabled() {\n\t\t\treturn toolEnabled;\n\t\t},\n\t\tgetGuidance() {\n\t\t\treturn toolGuidance;\n\t\t},\n\t\thasQueuedCommand() {\n\t\t\treturn toolQueuedCommand !== null;\n\t\t},\n\t\tclearQueue() {\n\t\t\ttoolQueuedCommand = null;\n\t\t},\n\t\tensureRegistered,\n\t\tregisterCommand,\n\t\tprocessQueue,\n\t};\n}\n"]}
+{"version":3,"file":"tool-manager.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-prompt-template-model/tool-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAK/G,MAAM,WAAW,eAAe;IAC/B,QAAQ,IAAI,OAAO,CAAC;IACpB,YAAY,IAAI,uBAAuB,GAAG,IAAI,CAAC;IAC/C,YAAY,CAAC,GAAG,EAAE,uBAAuB,GAAG,IAAI,GAAG,IAAI,CAAC;IACxD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe;;;;;;;;EA8LxE","sourcesContent":["// @ts-nocheck\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from \"@ashx-j/lunr\";\nimport { getAgentDir } from \"../../config.ts\";\nimport { Type } from \"typebox\";\nimport { notify } from \"./notifications.ts\";\n\nexport interface ToolManagerDeps {\n\tisActive(): boolean;\n\tgetStoredCtx(): ExtensionCommandContext | null;\n\tsetStoredCtx(ctx: ExtensionCommandContext | null): void;\n\texecuteCommand(command: string, ctx: ExtensionCommandContext): Promise<void>;\n}\n\nexport function createToolManager(pi: ExtensionAPI, deps: ToolManagerDeps) {\n\tlet toolEnabled = false;\n\tlet toolGuidance: string | null = null;\n\tlet toolRegistered = false;\n\tlet toolQueuedCommand: string | null = null;\n\tconst configPath = join(getAgentDir(), \"prompt-template-model.json\");\n\n\ttry {\n\t\tconst rawConfig = JSON.parse(readFileSync(configPath, \"utf-8\"));\n\t\tif (rawConfig && typeof rawConfig === \"object\") {\n\t\t\tconst config = rawConfig as { toolEnabled?: unknown; toolGuidance?: unknown };\n\t\t\tif (typeof config.toolEnabled === \"boolean\") {\n\t\t\t\ttoolEnabled = config.toolEnabled;\n\t\t\t}\n\t\t\tif (typeof config.toolGuidance === \"string\") {\n\t\t\t\ttoolGuidance = config.toolGuidance;\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\tconst err = error as NodeJS.ErrnoException;\n\t\tif (err.code !== \"ENOENT\") {\n\t\t\tprocess.stderr.write(\n\t\t\t\t`[pi-prompt-template-model] Failed to read ${configPath}: ${error instanceof Error ? error.message : String(error)}\\n`,\n\t\t\t);\n\t\t}\n\t}\n\n\tfunction saveToolConfig() {\n\t\ttry {\n\t\t\tmkdirSync(getAgentDir(), { recursive: true });\n\t\t\twriteFileSync(configPath, JSON.stringify({ toolEnabled, toolGuidance }, null, 2));\n\t\t} catch (error) {\n\t\t\tprocess.stderr.write(\n\t\t\t\t`[pi-prompt-template-model] Failed to write ${configPath}: ${error instanceof Error ? error.message : String(error)}\\n`,\n\t\t\t);\n\t\t}\n\t}\n\n\tfunction ensureRegistered() {\n\t\tif (toolRegistered) return;\n\t\ttoolRegistered = true;\n\t\tpi.registerTool({\n\t\t\tname: \"run-prompt\",\n\t\t\tlabel: \"Run Prompt\",\n\t\t\tdescription:\n\t\t\t\t\"Queue a prompt template command to execute when the current turn ends. Pass the template name and any arguments. \" +\n\t\t\t\t\"A queued result confirms acceptance, not completion. Rejected requests fail without changing the queue; wait for queued or running work to finish before retrying. \" +\n\t\t\t\t\"Supports --loop for loops (e.g. 'deslop --loop 5', 'deslop --loop=5', 'deslop --loop' for unlimited until convergence with a 999-iteration cap), \" +\n\t\t\t\t\"--fresh for context collapse between iterations, and --no-converge to disable early stopping for bounded loops. \" +\n\t\t\t\t\"Supports runtime delegation override via --subagent, --subagent=<name>, or --subagent:<name>. \" +\n\t\t\t\t\"Use 'chain-prompts template1 -> template2' for chaining and add --chain-context to pass previous step summaries into delegated steps.\",\n\t\t\tpromptSnippet:\n\t\t\t\t\"Use this to run slash/prompt templates by name with args (including --loop/--fresh and chain-prompts flows) when the user asks to execute a prompt template.\",\n\t\t\tparameters: Type.Object({\n\t\t\t\tcommand: Type.String({\n\t\t\t\t\tdescription: \"Template name and arguments (e.g. 'deslop --loop 5 --fresh', 'deslop --subagent:worker', 'deslop --subagent', 'chain-prompts analyze -> fix --chain-context', 'chain-prompts analyze -> fix --loop=3')\",\n\t\t\t\t}),\n\t\t\t}),\n\t\t\texecute: async (_id, params) => {\n\t\t\t\tif (!toolEnabled) {\n\t\t\t\t\tthrow new Error(\"run-prompt tool is disabled. User must run `/prompt-tool on` to enable.\");\n\t\t\t\t}\n\t\t\t\tif (deps.isActive()) {\n\t\t\t\t\tthrow new Error(\"A prompt command is already running. Wait for it to complete.\");\n\t\t\t\t}\n\t\t\t\tif (!deps.getStoredCtx()) {\n\t\t\t\t\tthrow new Error(\"No command context. Run any prompt command first to initialize.\");\n\t\t\t\t}\n\n\t\t\t\tconst commandParam = (params as { command?: unknown }).command;\n\t\t\t\tconst command = typeof commandParam === \"string\" ? commandParam.trim() : \"\";\n\t\t\t\tif (!command) {\n\t\t\t\t\tthrow new Error(\"No command specified.\");\n\t\t\t\t}\n\t\t\t\tif (toolQueuedCommand) {\n\t\t\t\t\tthrow new Error(\"A prompt command is already queued. Wait for it to execute.\");\n\t\t\t\t}\n\n\t\t\t\ttoolQueuedCommand = command;\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Prompt command queued: \"${command}\". Will execute when this turn ends.` }],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t},\n\t\t});\n\t}\n\n\tfunction registerCommand() {\n\t\tpi.registerCommand(\"prompt-tool\", {\n\t\t\tdescription: \"Manage the run-prompt tool (agent-accessible prompt execution)\",\n\t\t\thandler: async (args, ctx) => {\n\t\t\t\tdeps.setStoredCtx(ctx);\n\t\t\t\tconst trimmed = args.trim();\n\n\t\t\t\tif (trimmed === \"on\" || trimmed.startsWith(\"on \")) {\n\t\t\t\t\ttoolEnabled = true;\n\t\t\t\t\tensureRegistered();\n\t\t\t\t\tconst guidanceRaw = trimmed.slice(\"on\".length).trim();\n\t\t\t\t\tif (guidanceRaw) {\n\t\t\t\t\t\ttoolGuidance = guidanceRaw.replace(/^[\"']|[\"']$/g, \"\");\n\t\t\t\t\t\tnotify(ctx, `run-prompt tool enabled with guidance: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tnotify(ctx, \"run-prompt tool enabled.\", \"info\");\n\t\t\t\t\t}\n\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (trimmed === \"off\") {\n\t\t\t\t\ttoolEnabled = false;\n\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\tnotify(ctx, \"run-prompt tool disabled.\", \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (trimmed === \"guidance\" || trimmed.startsWith(\"guidance \")) {\n\t\t\t\t\tif (trimmed === \"guidance\" || trimmed === \"guidance show\") {\n\t\t\t\t\t\tif (toolGuidance) {\n\t\t\t\t\t\t\tnotify(ctx, `Current guidance: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tnotify(ctx, \"No guidance set. Use `/prompt-tool guidance <text>` to set.\", \"info\");\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (trimmed === \"guidance clear\") {\n\t\t\t\t\t\ttoolGuidance = null;\n\t\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\t\tnotify(ctx, \"Guidance cleared.\", \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tconst guidanceRaw = trimmed.slice(\"guidance\".length).trim();\n\t\t\t\t\t\ttoolGuidance = guidanceRaw.replace(/^[\"']|[\"']$/g, \"\");\n\t\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\t\tnotify(ctx, `Guidance set: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t}\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (!trimmed) {\n\t\t\t\t\tif (toolEnabled) {\n\t\t\t\t\t\tconst guidanceInfo = toolGuidance ? ` | Guidance: \"${toolGuidance}\"` : \"\";\n\t\t\t\t\t\tnotify(ctx, `run-prompt tool is enabled${guidanceInfo}`, \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tnotify(ctx, \"run-prompt tool is disabled\", \"info\");\n\t\t\t\t\t}\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tnotify(ctx, \"Usage: /prompt-tool [on [guidance] | off | guidance [text|clear]]\", \"error\");\n\t\t\t},\n\t\t});\n\t}\n\n\tasync function processQueue(ctx: ExtensionContext, restoreFn: () => Promise<void>) {\n\t\tif (!toolQueuedCommand) return false;\n\t\tconst storedCtx = deps.getStoredCtx();\n\t\tif (!storedCtx) {\n\t\t\ttoolQueuedCommand = null;\n\t\t\treturn false;\n\t\t}\n\n\t\tconst command = toolQueuedCommand;\n\t\ttoolQueuedCommand = null;\n\t\tawait restoreFn();\n\t\ttry {\n\t\t\tawait deps.executeCommand(command, storedCtx);\n\t\t} catch (error) {\n\t\t\tnotify(\n\t\t\t\tctx,\n\t\t\t\t`Failed to execute queued prompt command \"${command}\": ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\"error\",\n\t\t\t);\n\t\t}\n\t\treturn true;\n\t}\n\n\treturn {\n\t\tisEnabled() {\n\t\t\treturn toolEnabled;\n\t\t},\n\t\tgetGuidance() {\n\t\t\treturn toolGuidance;\n\t\t},\n\t\thasQueuedCommand() {\n\t\t\treturn toolQueuedCommand !== null;\n\t\t},\n\t\tclearQueue() {\n\t\t\ttoolQueuedCommand = null;\n\t\t},\n\t\tensureRegistered,\n\t\tregisterCommand,\n\t\tprocessQueue,\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-prompt-template-model/tool-manager.js

@@ -44,7 +44,8 @@ export function createToolManager(pi, deps) {
         pi.registerTool({
             name: "run-prompt",
             label: "Run Prompt",
-            description: "Run a prompt template command. Pass the template name and any arguments. " +
+            description: "Queue a prompt template command to execute when the current turn ends. Pass the template name and any arguments. " +
+                "A queued result confirms acceptance, not completion. Rejected requests fail without changing the queue; wait for queued or running work to finish before retrying. " +
                 "Supports --loop for loops (e.g. 'deslop --loop 5', 'deslop --loop=5', 'deslop --loop' for unlimited until convergence with a 999-iteration cap), " +
                 "--fresh for context collapse between iterations, and --no-converge to disable early stopping for bounded loops. " +
                 "Supports runtime delegation override via --subagent, --subagent=<name>, or --subagent:<name>. " +
@@ -57,39 +58,21 @@ export function createToolManager(pi, deps) {
             }),
             execute: async (_id, params) => {
                 if (!toolEnabled) {
-                    return {
-                        content: [{ type: "text", text: "run-prompt tool is disabled. User must run `/prompt-tool on` to enable." }],
-                        details: {},
-                    };
+                    throw new Error("run-prompt tool is disabled. User must run `/prompt-tool on` to enable.");
                 }
                 if (deps.isActive()) {
-                    return {
-                        content: [{ type: "text", text: "A prompt command is already running. Wait for it to complete." }],
-                        details: {},
-                    };
+                    throw new Error("A prompt command is already running. Wait for it to complete.");
                 }
                 if (!deps.getStoredCtx()) {
-                    return {
-                        content: [{ type: "text", text: "No command context. Run any prompt command first to initialize." }],
-                        details: {},
-                        isError: true,
-                    };
+                    throw new Error("No command context. Run any prompt command first to initialize.");
                 }
                 const commandParam = params.command;
                 const command = typeof commandParam === "string" ? commandParam.trim() : "";
                 if (!command) {
-                    return {
-                        content: [{ type: "text", text: "No command specified." }],
-                        details: {},
-                        isError: true,
-                    };
+                    throw new Error("No command specified.");
                 }
                 if (toolQueuedCommand) {
-                    return {
-                        content: [{ type: "text", text: "A prompt command is already queued. Wait for it to execute." }],
-                        details: {},
-                        isError: true,
-                    };
+                    throw new Error("A prompt command is already queued. Wait for it to execute.");
                 }
                 toolQueuedCommand = command;
                 return {

package/dist/builtin-extensions/pi-prompt-template-model/tool-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-manager.js","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-prompt-template-model/tool-manager.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from \"@ashx-j/lunr\";\nimport { getAgentDir } from \"../../config.ts\";\nimport { Type } from \"typebox\";\nimport { notify } from \"./notifications.ts\";\n\nexport interface ToolManagerDeps {\n\tisActive(): boolean;\n\tgetStoredCtx(): ExtensionCommandContext | null;\n\tsetStoredCtx(ctx: ExtensionCommandContext | null): void;\n\texecuteCommand(command: string, ctx: ExtensionCommandContext): Promise<void>;\n}\n\nexport function createToolManager(pi: ExtensionAPI, deps: ToolManagerDeps) {\n\tlet toolEnabled = false;\n\tlet toolGuidance: string | null = null;\n\tlet toolRegistered = false;\n\tlet toolQueuedCommand: string | null = null;\n\tconst configPath = join(getAgentDir(), \"prompt-template-model.json\");\n\n\ttry {\n\t\tconst rawConfig = JSON.parse(readFileSync(configPath, \"utf-8\"));\n\t\tif (rawConfig && typeof rawConfig === \"object\") {\n\t\t\tconst config = rawConfig as { toolEnabled?: unknown; toolGuidance?: unknown };\n\t\t\tif (typeof config.toolEnabled === \"boolean\") {\n\t\t\t\ttoolEnabled = config.toolEnabled;\n\t\t\t}\n\t\t\tif (typeof config.toolGuidance === \"string\") {\n\t\t\t\ttoolGuidance = config.toolGuidance;\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\tconst err = error as NodeJS.ErrnoException;\n\t\tif (err.code !== \"ENOENT\") {\n\t\t\tprocess.stderr.write(\n\t\t\t\t`[pi-prompt-template-model] Failed to read ${configPath}: ${error instanceof Error ? error.message : String(error)}\\n`,\n\t\t\t);\n\t\t}\n\t}\n\n\tfunction saveToolConfig() {\n\t\ttry {\n\t\t\tmkdirSync(getAgentDir(), { recursive: true });\n\t\t\twriteFileSync(configPath, JSON.stringify({ toolEnabled, toolGuidance }, null, 2));\n\t\t} catch (error) {\n\t\t\tprocess.stderr.write(\n\t\t\t\t`[pi-prompt-template-model] Failed to write ${configPath}: ${error instanceof Error ? error.message : String(error)}\\n`,\n\t\t\t);\n\t\t}\n\t}\n\n\tfunction ensureRegistered() {\n\t\tif (toolRegistered) return;\n\t\ttoolRegistered = true;\n\t\tpi.registerTool({\n\t\t\tname: \"run-prompt\",\n\t\t\tlabel: \"Run Prompt\",\n\t\t\tdescription:\n\t\t\t\t\"Run a prompt template command. Pass the template name and any arguments. \" +\n\t\t\t\t\"Supports --loop for loops (e.g. 'deslop --loop 5', 'deslop --loop=5', 'deslop --loop' for unlimited until convergence with a 999-iteration cap), \" +\n\t\t\t\t\"--fresh for context collapse between iterations, and --no-converge to disable early stopping for bounded loops. \" +\n\t\t\t\t\"Supports runtime delegation override via --subagent, --subagent=<name>, or --subagent:<name>. \" +\n\t\t\t\t\"Use 'chain-prompts template1 -> template2' for chaining and add --chain-context to pass previous step summaries into delegated steps.\",\n\t\t\tpromptSnippet:\n\t\t\t\t\"Use this to run slash/prompt templates by name with args (including --loop/--fresh and chain-prompts flows) when the user asks to execute a prompt template.\",\n\t\t\tparameters: Type.Object({\n\t\t\t\tcommand: Type.String({\n\t\t\t\t\tdescription: \"Template name and arguments (e.g. 'deslop --loop 5 --fresh', 'deslop --subagent:worker', 'deslop --subagent', 'chain-prompts analyze -> fix --chain-context', 'chain-prompts analyze -> fix --loop=3')\",\n\t\t\t\t}),\n\t\t\t}),\n\t\t\texecute: async (_id, params) => {\n\t\t\t\tif (!toolEnabled) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"run-prompt tool is disabled. User must run `/prompt-tool on` to enable.\" }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tif (deps.isActive()) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"A prompt command is already running. Wait for it to complete.\" }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tif (!deps.getStoredCtx()) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No command context. Run any prompt command first to initialize.\" }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t\tisError: true,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst commandParam = (params as { command?: unknown }).command;\n\t\t\t\tconst command = typeof commandParam === \"string\" ? commandParam.trim() : \"\";\n\t\t\t\tif (!command) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No command specified.\" }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t\tisError: true,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tif (toolQueuedCommand) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"A prompt command is already queued. Wait for it to execute.\" }],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t\tisError: true,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\ttoolQueuedCommand = command;\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Prompt command queued: \"${command}\". Will execute when this turn ends.` }],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t},\n\t\t});\n\t}\n\n\tfunction registerCommand() {\n\t\tpi.registerCommand(\"prompt-tool\", {\n\t\t\tdescription: \"Manage the run-prompt tool (agent-accessible prompt execution)\",\n\t\t\thandler: async (args, ctx) => {\n\t\t\t\tdeps.setStoredCtx(ctx);\n\t\t\t\tconst trimmed = args.trim();\n\n\t\t\t\tif (trimmed === \"on\" || trimmed.startsWith(\"on \")) {\n\t\t\t\t\ttoolEnabled = true;\n\t\t\t\t\tensureRegistered();\n\t\t\t\t\tconst guidanceRaw = trimmed.slice(\"on\".length).trim();\n\t\t\t\t\tif (guidanceRaw) {\n\t\t\t\t\t\ttoolGuidance = guidanceRaw.replace(/^[\"']|[\"']$/g, \"\");\n\t\t\t\t\t\tnotify(ctx, `run-prompt tool enabled with guidance: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tnotify(ctx, \"run-prompt tool enabled.\", \"info\");\n\t\t\t\t\t}\n\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (trimmed === \"off\") {\n\t\t\t\t\ttoolEnabled = false;\n\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\tnotify(ctx, \"run-prompt tool disabled.\", \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (trimmed === \"guidance\" || trimmed.startsWith(\"guidance \")) {\n\t\t\t\t\tif (trimmed === \"guidance\" || trimmed === \"guidance show\") {\n\t\t\t\t\t\tif (toolGuidance) {\n\t\t\t\t\t\t\tnotify(ctx, `Current guidance: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tnotify(ctx, \"No guidance set. Use `/prompt-tool guidance <text>` to set.\", \"info\");\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (trimmed === \"guidance clear\") {\n\t\t\t\t\t\ttoolGuidance = null;\n\t\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\t\tnotify(ctx, \"Guidance cleared.\", \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tconst guidanceRaw = trimmed.slice(\"guidance\".length).trim();\n\t\t\t\t\t\ttoolGuidance = guidanceRaw.replace(/^[\"']|[\"']$/g, \"\");\n\t\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\t\tnotify(ctx, `Guidance set: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t}\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (!trimmed) {\n\t\t\t\t\tif (toolEnabled) {\n\t\t\t\t\t\tconst guidanceInfo = toolGuidance ? ` | Guidance: \"${toolGuidance}\"` : \"\";\n\t\t\t\t\t\tnotify(ctx, `run-prompt tool is enabled${guidanceInfo}`, \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tnotify(ctx, \"run-prompt tool is disabled\", \"info\");\n\t\t\t\t\t}\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tnotify(ctx, \"Usage: /prompt-tool [on [guidance] | off | guidance [text|clear]]\", \"error\");\n\t\t\t},\n\t\t});\n\t}\n\n\tasync function processQueue(ctx: ExtensionContext, restoreFn: () => Promise<void>) {\n\t\tif (!toolQueuedCommand) return false;\n\t\tconst storedCtx = deps.getStoredCtx();\n\t\tif (!storedCtx) {\n\t\t\ttoolQueuedCommand = null;\n\t\t\treturn false;\n\t\t}\n\n\t\tconst command = toolQueuedCommand;\n\t\ttoolQueuedCommand = null;\n\t\tawait restoreFn();\n\t\ttry {\n\t\t\tawait deps.executeCommand(command, storedCtx);\n\t\t} catch (error) {\n\t\t\tnotify(\n\t\t\t\tctx,\n\t\t\t\t`Failed to execute queued prompt command \"${command}\": ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\"error\",\n\t\t\t);\n\t\t}\n\t\treturn true;\n\t}\n\n\treturn {\n\t\tisEnabled() {\n\t\t\treturn toolEnabled;\n\t\t},\n\t\tgetGuidance() {\n\t\t\treturn toolGuidance;\n\t\t},\n\t\thasQueuedCommand() {\n\t\t\treturn toolQueuedCommand !== null;\n\t\t},\n\t\tclearQueue() {\n\t\t\ttoolQueuedCommand = null;\n\t\t},\n\t\tensureRegistered,\n\t\tregisterCommand,\n\t\tprocessQueue,\n\t};\n}\n"]}
+{"version":3,"file":"tool-manager.js","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-prompt-template-model/tool-manager.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from \"@ashx-j/lunr\";\nimport { getAgentDir } from \"../../config.ts\";\nimport { Type } from \"typebox\";\nimport { notify } from \"./notifications.ts\";\n\nexport interface ToolManagerDeps {\n\tisActive(): boolean;\n\tgetStoredCtx(): ExtensionCommandContext | null;\n\tsetStoredCtx(ctx: ExtensionCommandContext | null): void;\n\texecuteCommand(command: string, ctx: ExtensionCommandContext): Promise<void>;\n}\n\nexport function createToolManager(pi: ExtensionAPI, deps: ToolManagerDeps) {\n\tlet toolEnabled = false;\n\tlet toolGuidance: string | null = null;\n\tlet toolRegistered = false;\n\tlet toolQueuedCommand: string | null = null;\n\tconst configPath = join(getAgentDir(), \"prompt-template-model.json\");\n\n\ttry {\n\t\tconst rawConfig = JSON.parse(readFileSync(configPath, \"utf-8\"));\n\t\tif (rawConfig && typeof rawConfig === \"object\") {\n\t\t\tconst config = rawConfig as { toolEnabled?: unknown; toolGuidance?: unknown };\n\t\t\tif (typeof config.toolEnabled === \"boolean\") {\n\t\t\t\ttoolEnabled = config.toolEnabled;\n\t\t\t}\n\t\t\tif (typeof config.toolGuidance === \"string\") {\n\t\t\t\ttoolGuidance = config.toolGuidance;\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\tconst err = error as NodeJS.ErrnoException;\n\t\tif (err.code !== \"ENOENT\") {\n\t\t\tprocess.stderr.write(\n\t\t\t\t`[pi-prompt-template-model] Failed to read ${configPath}: ${error instanceof Error ? error.message : String(error)}\\n`,\n\t\t\t);\n\t\t}\n\t}\n\n\tfunction saveToolConfig() {\n\t\ttry {\n\t\t\tmkdirSync(getAgentDir(), { recursive: true });\n\t\t\twriteFileSync(configPath, JSON.stringify({ toolEnabled, toolGuidance }, null, 2));\n\t\t} catch (error) {\n\t\t\tprocess.stderr.write(\n\t\t\t\t`[pi-prompt-template-model] Failed to write ${configPath}: ${error instanceof Error ? error.message : String(error)}\\n`,\n\t\t\t);\n\t\t}\n\t}\n\n\tfunction ensureRegistered() {\n\t\tif (toolRegistered) return;\n\t\ttoolRegistered = true;\n\t\tpi.registerTool({\n\t\t\tname: \"run-prompt\",\n\t\t\tlabel: \"Run Prompt\",\n\t\t\tdescription:\n\t\t\t\t\"Queue a prompt template command to execute when the current turn ends. Pass the template name and any arguments. \" +\n\t\t\t\t\"A queued result confirms acceptance, not completion. Rejected requests fail without changing the queue; wait for queued or running work to finish before retrying. \" +\n\t\t\t\t\"Supports --loop for loops (e.g. 'deslop --loop 5', 'deslop --loop=5', 'deslop --loop' for unlimited until convergence with a 999-iteration cap), \" +\n\t\t\t\t\"--fresh for context collapse between iterations, and --no-converge to disable early stopping for bounded loops. \" +\n\t\t\t\t\"Supports runtime delegation override via --subagent, --subagent=<name>, or --subagent:<name>. \" +\n\t\t\t\t\"Use 'chain-prompts template1 -> template2' for chaining and add --chain-context to pass previous step summaries into delegated steps.\",\n\t\t\tpromptSnippet:\n\t\t\t\t\"Use this to run slash/prompt templates by name with args (including --loop/--fresh and chain-prompts flows) when the user asks to execute a prompt template.\",\n\t\t\tparameters: Type.Object({\n\t\t\t\tcommand: Type.String({\n\t\t\t\t\tdescription: \"Template name and arguments (e.g. 'deslop --loop 5 --fresh', 'deslop --subagent:worker', 'deslop --subagent', 'chain-prompts analyze -> fix --chain-context', 'chain-prompts analyze -> fix --loop=3')\",\n\t\t\t\t}),\n\t\t\t}),\n\t\t\texecute: async (_id, params) => {\n\t\t\t\tif (!toolEnabled) {\n\t\t\t\t\tthrow new Error(\"run-prompt tool is disabled. User must run `/prompt-tool on` to enable.\");\n\t\t\t\t}\n\t\t\t\tif (deps.isActive()) {\n\t\t\t\t\tthrow new Error(\"A prompt command is already running. Wait for it to complete.\");\n\t\t\t\t}\n\t\t\t\tif (!deps.getStoredCtx()) {\n\t\t\t\t\tthrow new Error(\"No command context. Run any prompt command first to initialize.\");\n\t\t\t\t}\n\n\t\t\t\tconst commandParam = (params as { command?: unknown }).command;\n\t\t\t\tconst command = typeof commandParam === \"string\" ? commandParam.trim() : \"\";\n\t\t\t\tif (!command) {\n\t\t\t\t\tthrow new Error(\"No command specified.\");\n\t\t\t\t}\n\t\t\t\tif (toolQueuedCommand) {\n\t\t\t\t\tthrow new Error(\"A prompt command is already queued. Wait for it to execute.\");\n\t\t\t\t}\n\n\t\t\t\ttoolQueuedCommand = command;\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Prompt command queued: \"${command}\". Will execute when this turn ends.` }],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t},\n\t\t});\n\t}\n\n\tfunction registerCommand() {\n\t\tpi.registerCommand(\"prompt-tool\", {\n\t\t\tdescription: \"Manage the run-prompt tool (agent-accessible prompt execution)\",\n\t\t\thandler: async (args, ctx) => {\n\t\t\t\tdeps.setStoredCtx(ctx);\n\t\t\t\tconst trimmed = args.trim();\n\n\t\t\t\tif (trimmed === \"on\" || trimmed.startsWith(\"on \")) {\n\t\t\t\t\ttoolEnabled = true;\n\t\t\t\t\tensureRegistered();\n\t\t\t\t\tconst guidanceRaw = trimmed.slice(\"on\".length).trim();\n\t\t\t\t\tif (guidanceRaw) {\n\t\t\t\t\t\ttoolGuidance = guidanceRaw.replace(/^[\"']|[\"']$/g, \"\");\n\t\t\t\t\t\tnotify(ctx, `run-prompt tool enabled with guidance: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tnotify(ctx, \"run-prompt tool enabled.\", \"info\");\n\t\t\t\t\t}\n\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (trimmed === \"off\") {\n\t\t\t\t\ttoolEnabled = false;\n\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\tnotify(ctx, \"run-prompt tool disabled.\", \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (trimmed === \"guidance\" || trimmed.startsWith(\"guidance \")) {\n\t\t\t\t\tif (trimmed === \"guidance\" || trimmed === \"guidance show\") {\n\t\t\t\t\t\tif (toolGuidance) {\n\t\t\t\t\t\t\tnotify(ctx, `Current guidance: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tnotify(ctx, \"No guidance set. Use `/prompt-tool guidance <text>` to set.\", \"info\");\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (trimmed === \"guidance clear\") {\n\t\t\t\t\t\ttoolGuidance = null;\n\t\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\t\tnotify(ctx, \"Guidance cleared.\", \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tconst guidanceRaw = trimmed.slice(\"guidance\".length).trim();\n\t\t\t\t\t\ttoolGuidance = guidanceRaw.replace(/^[\"']|[\"']$/g, \"\");\n\t\t\t\t\t\tsaveToolConfig();\n\t\t\t\t\t\tnotify(ctx, `Guidance set: \"${toolGuidance}\"`, \"info\");\n\t\t\t\t\t}\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (!trimmed) {\n\t\t\t\t\tif (toolEnabled) {\n\t\t\t\t\t\tconst guidanceInfo = toolGuidance ? ` | Guidance: \"${toolGuidance}\"` : \"\";\n\t\t\t\t\t\tnotify(ctx, `run-prompt tool is enabled${guidanceInfo}`, \"info\");\n\t\t\t\t\t} else {\n\t\t\t\t\t\tnotify(ctx, \"run-prompt tool is disabled\", \"info\");\n\t\t\t\t\t}\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tnotify(ctx, \"Usage: /prompt-tool [on [guidance] | off | guidance [text|clear]]\", \"error\");\n\t\t\t},\n\t\t});\n\t}\n\n\tasync function processQueue(ctx: ExtensionContext, restoreFn: () => Promise<void>) {\n\t\tif (!toolQueuedCommand) return false;\n\t\tconst storedCtx = deps.getStoredCtx();\n\t\tif (!storedCtx) {\n\t\t\ttoolQueuedCommand = null;\n\t\t\treturn false;\n\t\t}\n\n\t\tconst command = toolQueuedCommand;\n\t\ttoolQueuedCommand = null;\n\t\tawait restoreFn();\n\t\ttry {\n\t\t\tawait deps.executeCommand(command, storedCtx);\n\t\t} catch (error) {\n\t\t\tnotify(\n\t\t\t\tctx,\n\t\t\t\t`Failed to execute queued prompt command \"${command}\": ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\"error\",\n\t\t\t);\n\t\t}\n\t\treturn true;\n\t}\n\n\treturn {\n\t\tisEnabled() {\n\t\t\treturn toolEnabled;\n\t\t},\n\t\tgetGuidance() {\n\t\t\treturn toolGuidance;\n\t\t},\n\t\thasQueuedCommand() {\n\t\t\treturn toolQueuedCommand !== null;\n\t\t},\n\t\tclearQueue() {\n\t\t\ttoolQueuedCommand = null;\n\t\t},\n\t\tensureRegistered,\n\t\tregisterCommand,\n\t\tprocessQueue,\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/extension/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/extension/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAoC,MAAM,iCAAiC,CAAC;AAEtG,OAAO,EAAO,SAAS,EAAU,IAAI,EAAmE,MAAM,wBAAwB,CAAC;AAsCvI,OAAO,EAGN,KAAK,aAAa,EAYlB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiFzC,wBAAgB,iCAAiC,CAAC,IAAI,KAAA,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAgBhG;AAED,wBAAgB,kBAAkB,CAAC,OAAO,KAAA,EAAE,KAAK,KAAA,EAAE,OAAO,KAAA,EAAE,OAAO,KAAA,oBA4ClE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,KAAA,EAAE,KAAK,KAAA,QASlD;AA8FD,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAucxE","sourcesContent":["// @ts-nocheck\n/**\n * Subagent Tool\n *\n * Full-featured subagent with foreground and async modes.\n * - Async (default): Background execution, emits events when done\n * - Foreground (async:false or clarify:true): Streams output, renders markdown, tracks usage\n *\n * Modes: single (agent + task), parallel (tasks[]), chain (chain[] with {previous})\n *\n * Config file: ~/.lunr/agent/extensions/subagent/config.json\n *   { \"maxSubagentDepth\": 1, \"intercomBridge\": { \"mode\": \"always\", \"instructionFile\": \"./intercom-bridge.md\" }, \"worktreeSetupHook\": \"./scripts/setup-worktree.mjs\" }\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { createSubagentCancellation, registerSubagentCancellation } from \"../../../../core/subagent-cancellation.ts\";\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport type { AgentToolResult } from \"@ashx-j/lunr-agent\";\nimport type { ExtensionAPI, ExtensionContext, ToolDefinition } from \"@ashx-j/lunr\";\nimport { awaitWithAbort } from \"../../../../utils/await-with-abort.ts\";\nimport { Box, Container, Spacer, Text, truncateToWidth, visibleWidth, wrapTextWithAnsi, type Component } from \"@ashx-j/lunr-tui\";\n\nimport { cleanupAllArtifactDirs, cleanupOldArtifacts, getArtifactsDir } from \"../shared/artifacts.ts\";\nimport { resolveCurrentSessionId } from \"../shared/session-identity.ts\";\nimport { cleanupOldChainDirs } from \"../shared/settings.ts\";\nimport {\n\tclearLegacyResultAnimationTimer,\n\tdisposeSubagentWidget,\n\trenderSubagentResult,\n\tSUBAGENT_PAINT_INTERVAL_MS,\n\tsubagentAnimSink,\n} from \"../tui/render.ts\";\nimport { SubagentParams } from \"./schemas.ts\";\nimport { validateChainInput } from \"./chain-validation.ts\";\nimport type { createSubagentExecutor, SubagentParamsLike } from \"../runs/foreground/subagent-executor.ts\";\nimport { resolveSubagentRequestParams } from \"../runs/foreground/request-params.ts\";\nimport { createAsyncJobTracker } from \"../runs/background/async-job-tracker.ts\";\nimport { createResultWatcher } from \"../runs/background/result-watcher.ts\";\nimport { createScheduledRunManager } from \"../runs/background/scheduled-runs.ts\";\nimport { isAsyncSubagentExecution, normalizeAsyncLaunchConfig, subagentLaunchRunsAsync } from \"../runs/background/top-level-async.ts\";\nimport { registerSlashCommands } from \"../slash/slash-commands.ts\";\nimport { registerPromptTemplateDelegationBridge } from \"../slash/prompt-template-bridge.ts\";\nimport { registerMainWatchdog } from \"../watchdog/register-main.ts\";\nimport { registerSlashSubagentBridge } from \"../slash/slash-bridge.ts\";\nimport { createNativeSupervisorChannel, registerSupervisorRenderers } from \"../intercom/native-supervisor-channel.ts\";\nimport { renderCommunicationCall, renderCommunicationResult } from \"../tui/communication.ts\";\nimport { registerSubagentRpcBridge } from \"./rpc.ts\";\nimport { clearSlashSnapshots, getSlashRenderableSnapshot, resolveSlashMessageDetails, restoreSlashFinalSnapshots, type SlashMessageDetails } from \"../slash/slash-live-state.ts\";\nimport { inspectSubagentStatus } from \"../runs/background/run-status.ts\";\nimport { resolveWaitToolConfig } from \"../runs/background/subagent-wait.ts\";\nimport { registerWaitTool } from \"../runs/background/wait-tool.ts\";\nimport { drainOutstandingWork } from \"../runs/background/auto-drain.ts\";\nimport registerSubagentNotify, { parseSubagentNotifyContent, type SubagentNotifyDetails } from \"../runs/background/notify.ts\";\nimport { formatSteeringNotice, handleSubagentSteeringNotice, SUBAGENT_STEERING_MESSAGE_TYPE, type SubagentSteeringMessageDetails } from \"./steering-notices.ts\";\nimport { SUBAGENT_CHILD_ENV, SUBAGENT_PARENT_SESSION_ENV } from \"../runs/shared/pi-args.ts\";\n\nimport { loadConfig } from \"./config.ts\";\nimport { buildSubagentToolDescription } from \"./tool-description.ts\";\nimport {\n\ttype AsyncJobState,\n\ttype Details,\n\ttype SubagentState,\n\tASYNC_DIR,\n\tchildRowLabel,\n\tDEFAULT_ARTIFACT_CONFIG,\n\tRESULTS_DIR,\n\tSLASH_RESULT_TYPE,\n\tSLASH_TEXT_RESULT_TYPE,\n\tSUBAGENT_ASYNC_COMPLETE_EVENT,\n\tSUBAGENT_ASYNC_STARTED_EVENT,\n\tSUBAGENT_CONTROL_EVENT,\n\tSUBAGENT_STEERING_NOTICE_EVENT,\n\tWIDGET_KEY,\n} from \"../shared/types.ts\";\nimport {\n\tclearPendingForegroundControlNotices,\n\tformatSubagentControlNotice,\n\thandleSubagentControlNotice,\n\tSUBAGENT_CONTROL_MESSAGE_TYPE,\n\ttype SubagentControlMessageDetails,\n} from \"./control-notices.ts\";\n\nexport { loadConfig } from \"./config.ts\";\n\n/**\n * Derive subagent session base directory from parent session file.\n * If parent session is ~/.lunr/agent/sessions/abc123.jsonl,\n * returns ~/.lunr/agent/sessions/abc123/ as the base.\n * Callers add runId to create the actual session root: abc123/{runId}/\n * Falls back to a unique temp directory if no parent session.\n */\nfunction getSubagentSessionRoot(parentSessionFile: string | null): string {\n\tif (parentSessionFile) {\n\t\tconst baseName = path.basename(parentSessionFile, \".jsonl\");\n\t\tconst sessionsDir = path.dirname(parentSessionFile);\n\t\treturn path.join(sessionsDir, baseName);\n\t}\n\treturn fs.mkdtempSync(path.join(os.tmpdir(), \"pi-subagent-session-\"));\n}\n\nfunction expandTilde(p: string): string {\n\treturn p.startsWith(\"~/\") ? path.join(os.homedir(), p.slice(2)) : p;\n}\n\n/**\n * Create a directory and verify it is actually accessible.\n * On Windows with Azure AD/Entra ID, directories created shortly after\n * wake-from-sleep can end up with broken NTFS ACLs (null DACL) when the\n * cloud SID cannot be resolved without network connectivity. This leaves\n * the directory completely inaccessible to the creating user.\n */\nfunction ensureAccessibleDir(dirPath: string): void {\n\tfs.mkdirSync(dirPath, { recursive: true });\n\ttry {\n\t\tfs.accessSync(dirPath, fs.constants.R_OK | fs.constants.W_OK);\n\t} catch {\n\t\ttry {\n\t\t\tfs.rmSync(dirPath, { recursive: true, force: true });\n\t\t} catch {\n\t\t\t// Best effort: retry mkdir/access even if cleanup fails.\n\t\t}\n\t\tfs.mkdirSync(dirPath, { recursive: true });\n\t\tfs.accessSync(dirPath, fs.constants.R_OK | fs.constants.W_OK);\n\t}\n}\n\nfunction isSlashResultRunning(result: { details?: Details }): boolean {\n\treturn result.details?.progress?.some((entry) => entry.status === \"running\")\n\t\t|| result.details?.results.some((entry) => entry.progress?.status === \"running\")\n\t\t|| false;\n}\n\n// Drives the inline running-indicator braille animation for foreground subagent\n// results. Foreground runs receive progress only on child events, so the glyph\n// (derived from progress fields) would freeze between events. While a result is\n// running we tick a frame counter every 80ms; renderResult registers the\n// running-glyph lines in state.animEntries (via subagentAnimSink) and the timer\n// rewrites just those Text nodes + requests a repaint, instead of invalidate()-ing\n// the whole tool component (a full renderSubagentResult rebuild 12.5x/s made the\n// spinner laggy).\nfunction subagentResultIsRunning(result: { details?: Details }): boolean {\n\treturn result.details?.progress?.some((entry) => entry.status === \"running\")\n\t\t|| result.details?.results.some((entry) => entry.progress?.status === \"running\")\n\t\t|| false;\n}\n\nfunction effectiveParallelTaskCount(tasks: Array<{ count?: unknown }> | undefined): number {\n\tif (!tasks || tasks.length === 0) return 0;\n\treturn tasks.reduce((total, task) => {\n\t\tconst count = typeof task.count === \"number\" && Number.isInteger(task.count) && task.count >= 1 ? task.count : 1;\n\t\treturn total + count;\n\t}, 0);\n}\n\nfunction matchingActionJobs(state: SubagentState, requestedId: string): AsyncJobState[] {\n\tconst jobs = new Map<string, AsyncJobState>();\n\tfor (const job of state.asyncJobs.values()) jobs.set(job.asyncId, job);\n\tfor (const job of state.fleetJobs?.values() ?? []) jobs.set(job.asyncId, job);\n\tconst exact = jobs.get(requestedId);\n\tif (exact) return [exact];\n\treturn [...jobs.values()].filter((job) => job.asyncId.startsWith(requestedId));\n}\n\nexport function resolveSubagentActionDisplayTitle(args, state: SubagentState): string | undefined {\n\tconst requestedId = (args.id || args.runId || \"\").trim();\n\tif (!requestedId) return undefined;\n\tconst matches = matchingActionJobs(state, requestedId);\n\tif (matches.length !== 1) return undefined;\n\tconst job = matches[0]!;\n\tconst steps = job.steps ?? [];\n\tif (Number.isInteger(args.index)) {\n\t\tconst step = steps.find((candidate) => candidate.index === args.index) ?? steps[args.index];\n\t\treturn step ? childRowLabel(step) : undefined;\n\t}\n\tif (steps.length === 1) return childRowLabel(steps[0]!);\n\tif (steps.length > 1) return `${job.mode ?? \"subagent\"} run`;\n\tif (job.agents?.length === 1) return job.agents[0];\n\tif (job.agents?.length) return `${job.mode ?? \"subagent\"} run`;\n\treturn undefined;\n}\n\nexport function renderSubagentCall(rawArgs, theme, context, options) {\n\tconst args = resolveSubagentRequestParams(rawArgs);\n\tif (args.action) {\n\t\tconst resultTitle = context?.result?.details?.displayTitle;\n\t\tconst resolvedTitle = resultTitle || options?.resolveActionTitle?.(args);\n\t\tconst target = resolvedTitle || args.id || args.runId || \"\";\n\t\tif ((args.action === \"steer\" || args.action === \"resume\") && args.message) {\n\t\t\treturn renderCommunicationCall(\n\t\t\t\t\"subagent\",\n\t\t\t\targs,\n\t\t\t\ttheme,\n\t\t\t\tcontext,\n\t\t\t\t{ direction: \"to\", peer: resolvedTitle || \"Subagent\", kind: \"steer\", message: args.message },\n\t\t\t\tresolvedTitle,\n\t\t\t);\n\t\t}\n\t\treturn new Text(\n\t\t\t`${theme.fg(\"toolTitle\", theme.bold(\"subagent \"))}${args.action}${target ? ` ${theme.fg(\"accent\", target)}` : \"\"}`,\n\t\t\t0,\n\t\t\t0,\n\t\t);\n\t}\n\tconst isParallel = (args.tasks?.length ?? 0) > 0;\n\tconst parallelCount = effectiveParallelTaskCount(args.tasks as Array<{ count?: unknown }> | undefined);\n\tconst asyncMark = subagentLaunchRunsAsync(args) ? `${theme.fg(\"warning\", \"async\")} ` : \"\";\n\tif (args.chain?.length) {\n\t\treturn new Text(\n\t\t\t`${theme.fg(\"toolTitle\", theme.bold(\"subagent \"))}${asyncMark}chain (${args.chain.length})`,\n\t\t\t0,\n\t\t\t0,\n\t\t);\n\t}\n\tif (isParallel) {\n\t\treturn new Text(\n\t\t\t`${theme.fg(\"toolTitle\", theme.bold(\"subagent \"))}${asyncMark}parallel (${parallelCount})`,\n\t\t\t0,\n\t\t\t0,\n\t\t);\n\t}\n\tconst showDescription = !context?.result && !context?.isPartial && !context?.expanded && !context?.isError;\n\tconst description = showDescription ? theme.fg(\"accent\", args.description || args.task || \"?\") : \"\";\n\tconst title = theme.fg(\"toolTitle\", theme.bold(\"subagent\"));\n\tconst rest = [asyncMark.trim() ? theme.fg(\"warning\", \"async\") : \"\", description].filter(Boolean).join(\" \");\n\treturn new Text(rest ? `${title} ${rest}` : title, 0, 0);\n}\n\nexport function renderSubagentNotify(details, theme) {\n\tconst status = typeof details?.status === \"string\" ? details.status : \"\";\n\tconst icon = status === \"completed\"\n\t\t? theme.fg(\"success\", \"✓\")\n\t\t: status === \"failed\"\n\t\t\t? theme.fg(\"error\", \"✗\")\n\t\t\t: theme.fg(\"warning\", \"■\");\n\tconst title = details?.agent || \"child\";\n\treturn new Text(`${icon} ${theme.bold(title)} ${theme.fg(\"dim\", status)}`, 0, 0);\n}\n\nfunction ensureSubagentResultAnimation(context: { state: Record<string, unknown>; invalidate?: () => void; requestRender?: () => void }): void {\n\tconst state = context.state as {\n\t\tsubagentResultAnimationTimer?: ReturnType<typeof setInterval>;\n\t\tframe?: number;\n\t\tanimEntries?: Array<{ text: Text; line: (frame: number, now: number) => string }>;\n\t};\n\tif (state.subagentResultAnimationTimer) return;\n\tif (typeof context.invalidate !== \"function\") return;\n\tif (state.frame === undefined) state.frame = 0;\n\tstate.subagentResultAnimationTimer = setInterval(() => {\n\t\tstate.frame = (state.frame ?? 0) + 1;\n\t\ttry {\n\t\t\tconst entries = state.animEntries;\n\t\t\tif (entries?.length && typeof context.requestRender === \"function\") {\n\t\t\t\tconst now = Date.now();\n\t\t\t\tfor (const entry of entries) entry.text.setText(entry.line(state.frame ?? 0, now));\n\t\t\t\tcontext.requestRender();\n\t\t\t} else {\n\t\t\t\tcontext.invalidate();\n\t\t\t}\n\t\t} catch {}\n\t}, SUBAGENT_PAINT_INTERVAL_MS);\n}\n\nfunction isSlashResultError(result: { details?: Details }): boolean {\n\treturn result.details?.results.some((entry) => entry.exitCode !== 0 && entry.progress?.status !== \"running\") || false;\n}\n\nfunction isStaleExtensionContextError(error: unknown): boolean {\n\treturn error instanceof Error && error.message.includes(\"Extension context no longer active\");\n}\n\nfunction rebuildSlashResultContainer(\n\tcontainer: Container,\n\tresult: AgentToolResult<Details>,\n\toptions: { expanded: boolean },\n\ttheme: ExtensionContext[\"ui\"][\"theme\"],\n): void {\n\tcontainer.clear();\n\tcontainer.addChild(new Spacer(1));\n\tconst boxTheme = isSlashResultRunning(result) ? \"toolPendingBg\" : isSlashResultError(result) ? \"toolErrorBg\" : \"toolSuccessBg\";\n\tconst box = new Box(1, 1, (text: string) => theme.bg(boxTheme, text));\n\tbox.addChild(renderSubagentResult(result, options, theme));\n\tcontainer.addChild(box);\n}\n\nfunction createSlashResultComponent(\n\tdetails: SlashMessageDetails,\n\toptions: { expanded: boolean },\n\ttheme: ExtensionContext[\"ui\"][\"theme\"],\n): Container {\n\tconst container = new Container();\n\tlet lastVersion = -1;\n\tcontainer.render = (width: number): string[] => {\n\t\tconst snapshot = getSlashRenderableSnapshot(details);\n\t\tif (snapshot.version !== lastVersion || isSlashResultRunning(snapshot.result)) {\n\t\t\tlastVersion = snapshot.version;\n\t\t\trebuildSlashResultContainer(container, snapshot.result, options, theme);\n\t\t}\n\t\treturn Container.prototype.render.call(container, width);\n\t};\n\treturn container;\n}\n\nclass SubagentControlNoticeComponent implements Component {\n\tconstructor(\n\t\tprivate readonly details: SubagentControlMessageDetails,\n\t\tprivate readonly theme: ExtensionContext[\"ui\"][\"theme\"],\n\t) {}\n\n\tinvalidate(): void {}\n\n\trender(width: number): string[] {\n\t\tconst eventLabel = this.details.event.type.replaceAll(\"_\", \" \");\n\t\tif (width < 3) return [truncateToWidth(`Subagent ${eventLabel}`, width)];\n\t\tconst bodyWidth = Math.max(1, width - 2);\n\t\tconst borderChar = \"─\";\n\t\tconst header = ` ⚠ Subagent ${eventLabel}: ${this.details.event.agent} `;\n\t\tconst headerText = truncateToWidth(header, bodyWidth, \"\");\n\t\tconst headerPadding = Math.max(0, bodyWidth - visibleWidth(headerText));\n\t\tconst lines = [this.theme.fg(\"accent\", `╭${headerText}${borderChar.repeat(headerPadding)}╮`)];\n\n\t\tfor (const line of wrapTextWithAnsi(formatSubagentControlNotice(this.details), bodyWidth)) {\n\t\t\tconst text = truncateToWidth(line, bodyWidth, \"\");\n\t\t\tconst padding = Math.max(0, bodyWidth - visibleWidth(text));\n\t\t\tlines.push(this.theme.fg(\"accent\", `│${text}${\" \".repeat(padding)}│`));\n\t\t}\n\t\tlines.push(this.theme.fg(\"accent\", `╰${borderChar.repeat(bodyWidth)}╯`));\n\t\treturn lines;\n\t}\n}\n\nexport default function registerSubagentExtension(pi: ExtensionAPI): void {\n\tif (process.env[SUBAGENT_CHILD_ENV] === \"1\") {\n\t\treturn;\n\t}\n\tconst globalStore = globalThis as Record<string, unknown>;\n\tconst runtimeCleanupStoreKey = \"__piSubagentRuntimeCleanup\";\n\tconst previousRuntimeCleanup = globalStore[runtimeCleanupStoreKey];\n\tif (typeof previousRuntimeCleanup === \"function\") {\n\t\ttry {\n\t\t\tpreviousRuntimeCleanup();\n\t\t} catch {\n\t\t\t// Best effort cleanup for stale timers from an older reload.\n\t\t}\n\t}\n\n\tensureAccessibleDir(RESULTS_DIR);\n\tensureAccessibleDir(ASYNC_DIR);\n\tcleanupOldChainDirs();\n\n\tconst config = normalizeAsyncLaunchConfig(loadConfig());\n\tconst waitToolConfig = resolveWaitToolConfig(config.waitTool);\n\tconst tempArtifactsDir = getArtifactsDir(null);\n\tcleanupAllArtifactDirs(DEFAULT_ARTIFACT_CONFIG.cleanupDays);\n\n\tconst state: SubagentState = {\n\t\tbaseCwd: \"\",\n\t\tcurrentSessionId: null,\n\t\tsessionGeneration: 0,\n\t\tforegroundSubagentInFlight: 0,\n\t\tsubagentSpawns: { sessionId: null, count: 0 },\n\t\tasyncJobs: new Map(),\n\t\tfleetJobs: new Map(),\n\t\tforegroundRuns: new Map(),\n\t\tforegroundControls: new Map(),\n\t\tlastForegroundControlId: null,\n\t\tpendingForegroundControlNotices: new Map(),\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: {\n\t\t\tschedule: () => false,\n\t\t\tclear: () => {},\n\t\t},\n\t};\n\n\tconst supervisorChannel = createNativeSupervisorChannel(pi, state);\n\tconst mainWatchdog = registerMainWatchdog(pi);\n\tconst { startResultWatcher, primeExistingResults, stopResultWatcher } = createResultWatcher(\n\t\tpi,\n\t\tstate,\n\t\tRESULTS_DIR,\n\t\t10 * 60 * 1000,\n\t);\n\tstartResultWatcher();\n\tprimeExistingResults();\n\n\tlet generation = 0;\n\tlet executorPromise: Promise<ReturnType<typeof createSubagentExecutor>> | undefined;\n\tconst pendingLaunches = new Set<Promise<void>>();\n\tconst pendingAsyncLaunches = new Set<Promise<void>>();\n\tlet unregisterCancellation: (() => void) | undefined;\n\tconst runtimeCleanup = () => {\n\t\tgeneration++;\n\t\tsupervisorChannel.cancelOwnedQuestions(\"parent runtime replaced\");\n\t\tstate.sessionGeneration = (state.sessionGeneration ?? 0) + 1;\n\t\texecutorPromise = undefined;\n\t\tpendingLaunches.clear();\n\t\tpendingAsyncLaunches.clear();\n\t\tunregisterCancellation?.();\n\t\tmainWatchdog.dispose();\n\t\tstopResultWatcher();\n\t\tscheduledRunManager.stop();\n\t\tsupervisorChannel.dispose();\n\t\tclearPendingForegroundControlNotices(state);\n\t\tdisposeSubagentWidget();\n\t\tif (state.poller) {\n\t\t\tclearInterval(state.poller);\n\t\t\tstate.poller = null;\n\t\t}\n\t};\n\tglobalStore[runtimeCleanupStoreKey] = runtimeCleanup;\n\n\tconst { ensurePoller, refreshWidget, handleStarted, handleComplete: trackComplete, resetJobs, restoreActiveJobs } = createAsyncJobTracker(pi, state, ASYNC_DIR, {\n\t\twidgetEnabled: config.asyncWidget !== false,\n\t});\n\tconst handleComplete = (data: unknown) => {\n\t\ttrackComplete(data);\n\t\tconst result = data as { id?: string; sessionId?: string };\n\t\tif (typeof state.currentSessionId === \"string\" && result.sessionId !== state.currentSessionId) return;\n\t\tif (typeof result.id === \"string\" && result.id.trim()) {\n\t\t\tsupervisorChannel.settleRunQuestions(result.id, \"async run settled\");\n\t\t}\n\t};\n\tlet executorExecute: ((id: string, params: SubagentParamsLike, signal: AbortSignal, onUpdate: ((r: AgentToolResult<Details>) => void) | undefined, ctx: ExtensionContext) => Promise<AgentToolResult<Details>>) | undefined;\n\tconst scheduledRunManager = createScheduledRunManager({\n\t\tconfig,\n\t\tlaunch: (params, ctx, signal) => {\n\t\t\tif (!executorExecute) {\n\t\t\t\treturn Promise.resolve({\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Scheduled subagent launch is unavailable (executor not ready).\" }],\n\t\t\t\t\tisError: true,\n\t\t\t\t\tdetails: { mode: \"management\" as const, results: [] },\n\t\t\t\t});\n\t\t\t}\n\t\t\treturn executorExecute(randomUUID(), params, signal, undefined, ctx);\n\t\t},\n\t});\n\tconst executor: ReturnType<typeof createSubagentExecutor> = {\n\t\tasync execute(id, params, signal, onUpdate, ctx) {\n\t\t\tlet resolveLaunchReady!: () => void;\n\t\t\tlet launchReady = false;\n\t\t\tconst launchReadyPromise = new Promise<void>((resolve) => {\n\t\t\t\tresolveLaunchReady = resolve;\n\t\t\t});\n\t\t\tconst markLaunchReady = () => {\n\t\t\t\tif (launchReady) return;\n\t\t\t\tlaunchReady = true;\n\t\t\t\tpendingLaunches.delete(launchReadyPromise);\n\t\t\t\tpendingAsyncLaunches.delete(launchReadyPromise);\n\t\t\t\tresolveLaunchReady();\n\t\t\t};\n\t\t\tpendingLaunches.add(launchReadyPromise);\n\t\t\tif (isAsyncSubagentExecution(resolveSubagentRequestParams(params))) pendingAsyncLaunches.add(launchReadyPromise);\n\t\t\ttry {\n\t\t\t\tconst currentGeneration = generation;\n\t\t\t\tsignal?.throwIfAborted();\n\t\t\t\tif (!executorPromise) {\n\t\t\t\t\tconst pending = import(\"../runs/foreground/subagent-executor.ts\").then(({ createSubagentExecutor }) => {\n\t\t\t\t\t\tif (generation !== currentGeneration) throw new Error(\"Subagent session changed before initialization\");\n\t\t\t\t\t\treturn createSubagentExecutor({\n\t\t\t\t\t\t\tpi, state, config,\n\t\t\t\t\t\t\twaitToolEnabled: waitToolConfig.enabled,\n\t\t\t\t\t\t\thandleScheduledRunAction: (params, ctx) => scheduledRunManager.handleToolCall(params, ctx),\n\t\t\t\t\t\t\twatchdog: mainWatchdog, tempArtifactsDir, getSubagentSessionRoot, expandTilde,\n\t\t\t\t\t\t});\n\t\t\t\t\t});\n\t\t\t\t\texecutorPromise = pending;\n\t\t\t\t\tvoid pending.catch(() => {\n\t\t\t\t\t\tif (executorPromise === pending) executorPromise = undefined;\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tconst ready = await awaitWithAbort(executorPromise, signal);\n\t\t\t\tsignal?.throwIfAborted();\n\t\t\t\tif (generation !== currentGeneration) throw new Error(\"Subagent session changed before execution\");\n\t\t\t\tconst execution = ready.execute(id, params, signal, onUpdate, ctx);\n\t\t\t\tmarkLaunchReady();\n\t\t\t\treturn await execution;\n\t\t\t} finally {\n\t\t\t\tmarkLaunchReady();\n\t\t\t}\n\t\t},\n\t};\n\texecutorExecute = executor.execute;\n\n\tregisterSupervisorRenderers(pi, state);\n\n\tpi.registerMessageRenderer<SlashMessageDetails>(SLASH_RESULT_TYPE, (message, options, theme) => {\n\t\tconst details = resolveSlashMessageDetails(message.details);\n\t\tif (!details) return undefined;\n\t\treturn createSlashResultComponent(details, options, theme);\n\t});\n\n\tpi.registerMessageRenderer<undefined>(SLASH_TEXT_RESULT_TYPE, (message, _options, _theme) => {\n\t\tconst content = typeof message.content === \"string\"\n\t\t\t? message.content\n\t\t\t: message.content\n\t\t\t\t.filter((entry) => entry.type === \"text\")\n\t\t\t\t.map((entry) => entry.text)\n\t\t\t\t.join(\"\\n\");\n\t\treturn new Text(content, 0, 0);\n\t});\n\n\tpi.registerMessageRenderer<SubagentNotifyDetails>(\"subagent-notify\", (message, _options, theme) => {\n\t\tconst content = typeof message.content === \"string\" ? message.content : \"\";\n\t\tconst details = (message.details as SubagentNotifyDetails | undefined) ?? parseSubagentNotifyContent(content);\n\t\tif (!details) return new Text(content, 0, 0);\n\t\treturn renderSubagentNotify(details, theme);\n\t});\n\n\tpi.registerMessageRenderer<SubagentSteeringMessageDetails>(SUBAGENT_STEERING_MESSAGE_TYPE, (message, _options, theme) => {\n\t\tconst details = message.details as SubagentSteeringMessageDetails | undefined;\n\t\tif (!details) return undefined;\n\t\treturn new Text(theme.fg(details.state === \"recovered\" ? \"warning\" : \"error\", formatSteeringNotice(details)), 0, 0);\n\t});\n\n\tpi.registerMessageRenderer<SubagentControlMessageDetails>(SUBAGENT_CONTROL_MESSAGE_TYPE, () => undefined);\n\n\tconst executeSubagentCollapsed = async (id: string, params: SubagentParamsLike, signal: AbortSignal, onUpdate: ((result: AgentToolResult<Details>) => void) | undefined, ctx: ExtensionContext) => {\n\t\tif (ctx.hasUI) ctx.ui.setToolsExpanded(false);\n\t\tconst isCommunication = (params.action === \"steer\" || params.action === \"resume\") && typeof params.message === \"string\";\n\t\tconst displayTitle = isCommunication ? resolveSubagentActionDisplayTitle(params, state) : undefined;\n\t\tconst jobs = isCommunication ? matchingActionJobs(state, (params.id || params.runId || \"\").trim()) : [];\n\t\tconst targetNames = new Map(jobs.length === 1 ? jobs[0]!.steps?.map((step, index) => [step.index ?? index, childRowLabel(step)]) : []);\n\t\tconst result = await executor.execute(id, params, signal, onUpdate, ctx);\n\t\tif (displayTitle && result.details) result.details.displayTitle = displayTitle;\n\t\tif (isCommunication && result.details) {\n\t\t\tconst targets = result.details.steering?.targets.map((target) => targetNames.get(target.index) ?? `Subagent ${target.index + 1}`);\n\t\t\tconst peer = targets?.length ? targets.join(\", \") : displayTitle || \"Subagent\";\n\t\t\tresult.details.communication = { direction: \"to\", peer, kind: \"steer\", message: params.message };\n\t\t}\n\t\treturn result;\n\t};\n\n\tconst slashBridge = registerSlashSubagentBridge({\n\t\tevents: pi.events,\n\t\tgetContext: () => state.lastUiContext,\n\t\texecute: (id, params, signal, onUpdate, ctx) =>\n\t\t\texecuteSubagentCollapsed(id, params, signal, onUpdate, ctx),\n\t});\n\n\tconst promptTemplateBridge = registerPromptTemplateDelegationBridge({\n\t\tevents: pi.events,\n\t\tgetContext: () => state.lastUiContext,\n\t\texecute: (requestId, params, signal, ctx, onUpdate) =>\n\t\t\texecuteSubagentCollapsed(requestId, params, signal, onUpdate, ctx),\n\t});\n\n\tconst rpcBridge = registerSubagentRpcBridge({\n\t\tevents: pi.events,\n\t\tgetContext: () => state.lastUiContext,\n\t\texecute: (id, params, signal, onUpdate, ctx) => executor.execute(id, params, signal, onUpdate, ctx),\n\t});\n\n\tconst tool: ToolDefinition<typeof SubagentParams, Details> = {\n\t\tname: \"subagent\",\n\t\tlabel: \"Subagent\",\n\t\tdescription: buildSubagentToolDescription(config),\n\t\tparameters: SubagentParams,\n\t\t// lunr: same-turn SINGLE calls overlap; sequential work uses chain.\n\t\texecutionMode: \"parallel\",\n\n\t\tprepareArguments(args) {\n\t\t\t// Run friendly chain validation before pi-ai's raw TypeBox schema check\n\t\t\t// so the model sees which property is disallowed, what is allowed, and a\n\t\t\t// valid example instead of `chain.N: must not have additional properties`.\n\t\t\tvalidateChainInput(args);\n\t\t\treturn args as never;\n\t\t},\n\n\t\texecute(id, params, signal, onUpdate, ctx) {\n\t\t\treturn executeSubagentCollapsed(id, params, signal, onUpdate, ctx);\n\t\t},\n\n\t\trenderCall: (args, theme, context) => renderSubagentCall(args, theme, context, {\n\t\t\tresolveActionTitle: (params) => resolveSubagentActionDisplayTitle(params, state),\n\t\t}),\n\n\t\trenderResult(result, options, theme, context) {\n\t\t\tif (result.details?.communication) return renderCommunicationResult(result.content, result.details, options.expanded, context.isError, theme);\n\t\t\tif (subagentResultIsRunning(result)) {\n\t\t\t\tensureSubagentResultAnimation(context);\n\t\t\t} else {\n\t\t\t\tclearLegacyResultAnimationTimer(context);\n\t\t\t}\n\t\t\tconst state = context.state as { frame?: number; animEntries?: Array<{ text: Text; line: (frame: number) => string }> };\n\t\t\t// lunr: collect running-glyph line templates while rendering so the\n\t\t\t// animation timer can rewrite them in place (see ensureSubagentResultAnimation).\n\t\t\tconst entries: Array<{ text: Text; line: (frame: number) => string }> = [];\n\t\t\tstate.animEntries = entries;\n\t\t\tsubagentAnimSink.current = entries;\n\t\t\ttry {\n\t\t\t\treturn renderSubagentResult(result, options, theme, state.frame ?? 0);\n\t\t\t} finally {\n\t\t\t\tsubagentAnimSink.current = null;\n\t\t\t}\n\t\t},\n\n\t};\n\n\tpi.registerTool(tool);\n\n\t// lunr: register a callback so model-tier settings changes rebuild the subagent\n\t// tool description and refresh the live registry.\n\tconst modelTierBridge = (globalThis as Record<symbol, unknown>)[Symbol.for(\"@lunr/model-tiers\")] as\n\t\t| { registerToolDescriptionRefresher?: (refresher: () => void) => void }\n\t\t| undefined;\n\tmodelTierBridge?.registerToolDescriptionRefresher?.(() => {\n\t\ttool.description = buildSubagentToolDescription(config);\n\t\t// pi.runtime is not on ExtensionAPI; registerTool refreshes the live registry.\n\t\tpi.registerTool(tool);\n\t});\n\n\tregisterWaitTool(pi, state, waitToolConfig.enabled, async (signal) => {\n\t\tconst launches = [...pendingLaunches];\n\t\tif (launches.length === 0) return;\n\t\tawait awaitWithAbort(Promise.all(launches).then(() => {}), signal);\n\t});\n\n\tpi.on(\"agent_end\", async (_event, ctx) => {\n\t\tif (ctx.hasUI) return;\n\t\tawait drainOutstandingWork({ state, events: pi.events, hasPendingMessages: () => ctx.hasPendingMessages() });\n\t});\n\n\tregisterSlashCommands(pi, state);\n\n\tconst eventUnsubscribeStoreKey = \"__piSubagentEventUnsubscribes\";\n\tconst controlNoticeSeenStoreKey = \"__piSubagentVisibleControlNotices\";\n\tconst previousEventUnsubscribes = globalStore[eventUnsubscribeStoreKey];\n\tif (Array.isArray(previousEventUnsubscribes)) {\n\t\tfor (const unsubscribe of previousEventUnsubscribes) {\n\t\t\tif (typeof unsubscribe !== \"function\") continue;\n\t\t\ttry {\n\t\t\t\tunsubscribe();\n\t\t\t} catch {\n\t\t\t\t// Best effort cleanup for stale handlers from an older reload.\n\t\t\t}\n\t\t}\n\t}\n\tregisterSubagentNotify(pi, state, { batchConfig: config.completionBatch });\n\n\tconst existingVisibleControlNotices = globalStore[controlNoticeSeenStoreKey];\n\tconst visibleControlNotices = existingVisibleControlNotices instanceof Set ? existingVisibleControlNotices as Set<string> : new Set<string>();\n\tglobalStore[controlNoticeSeenStoreKey] = visibleControlNotices;\n\tconst controlEventHandler = (payload: unknown) => {\n\t\thandleSubagentControlNotice({\n\t\t\tpi,\n\t\t\tstate,\n\t\t\tvisibleControlNotices,\n\t\t\tdetails: payload as SubagentControlMessageDetails,\n\t\t});\n\t};\n\tconst steeringNoticeHandler = (payload: unknown) => {\n\t\thandleSubagentSteeringNotice({ pi, state, details: payload as SubagentSteeringMessageDetails });\n\t};\n\tconst eventUnsubscribes = [\n\t\tpi.events.on(SUBAGENT_ASYNC_STARTED_EVENT, handleStarted),\n\t\tpi.events.on(SUBAGENT_ASYNC_COMPLETE_EVENT, handleComplete),\n\t\tpi.events.on(SUBAGENT_CONTROL_EVENT, controlEventHandler),\n\t\tpi.events.on(SUBAGENT_STEERING_NOTICE_EVENT, steeringNoticeHandler),\n\t\trpcBridge.dispose,\n\t];\n\tglobalStore[eventUnsubscribeStoreKey] = eventUnsubscribes;\n\n\tpi.on(\"tool_result\", (event, ctx) => {\n\t\tif (event.toolName !== \"subagent\") return;\n\t\tif (!ctx.hasUI) return;\n\t\tstate.lastUiContext = ctx;\n\t\tif (state.asyncJobs.size > 0) {\n\t\t\trefreshWidget(ctx);\n\t\t\tensurePoller();\n\t\t}\n\t});\n\n\tconst cleanupSessionArtifacts = (ctx: ExtensionContext) => {\n\t\ttry {\n\t\t\tconst sessionFile = ctx.sessionManager.getSessionFile();\n\t\t\tif (sessionFile) {\n\t\t\t\tcleanupOldArtifacts(getArtifactsDir(sessionFile), DEFAULT_ARTIFACT_CONFIG.cleanupDays);\n\t\t\t}\n\t\t} catch {\n\t\t\t// Cleanup failures should not block session lifecycle events.\n\t\t}\n\t};\n\n\tconst resetSessionState = (ctx: ExtensionContext) => {\n\t\tgeneration++;\n\t\tsupervisorChannel.cancelOwnedQuestions(\"parent session replaced\");\n\t\tstate.sessionGeneration = (state.sessionGeneration ?? 0) + 1;\n\t\texecutorPromise = undefined;\n\t\tpendingLaunches.clear();\n\t\tpendingAsyncLaunches.clear();\n\t\tunregisterCancellation?.();\n\t\tstate.baseCwd = ctx.cwd;\n\t\tstate.currentSessionId = resolveCurrentSessionId(ctx.sessionManager);\n\t\tstate.subagentSpawns = { sessionId: state.currentSessionId, count: 0 };\n\t\t// Set PI_SUBAGENT_PARENT_SESSION for permission-system forwarding.\n\t\t// Only set in the root session (the interactive UI session), not in\n\t\t// child subagent processes — children inherit the parent's value\n\t\t// through the process environment at spawn time and must not overwrite\n\t\t// it with their own session identity.\n\t\tif (!process.env[SUBAGENT_CHILD_ENV]) {\n\t\t\tconst sessionId = ctx.sessionManager.getSessionId();\n\t\t\tif (sessionId) {\n\t\t\t\tprocess.env[SUBAGENT_PARENT_SESSION_ENV] = sessionId;\n\t\t\t}\n\t\t}\n\t\tstate.lastUiContext = ctx;\n\t\tcleanupSessionArtifacts(ctx);\n\t\tclearPendingForegroundControlNotices(state);\n\t\tresetJobs(ctx);\n\t\trestoreActiveJobs(ctx);\n\t\tconst sessionId = state.currentSessionId;\n\t\tconst sessionGeneration = generation;\n\t\tif (sessionId) unregisterCancellation = registerSubagentCancellation(sessionId, createSubagentCancellation({\n\t\t\tpendingLaunches: pendingAsyncLaunches,\n\t\t\tisCurrent: () => generation === sessionGeneration && state.currentSessionId === sessionId,\n\t\t\tgetActiveRunIds: () => [...state.asyncJobs.values()]\n\t\t\t\t.filter((job) => job.sessionId === sessionId && (job.status === \"queued\" || job.status === \"running\"))\n\t\t\t\t.map((job) => job.asyncId),\n\t\t\tasync stopRun(id) {\n\t\t\t\tconst result = await executor.execute(randomUUID(), { action: \"stop\", id }, new AbortController().signal, undefined, ctx);\n\t\t\t\treturn !result.isError;\n\t\t\t},\n\t\t}));\n\t\tscheduledRunManager.bindSession(ctx);\n\t\trestoreSlashFinalSnapshots(ctx.sessionManager.getEntries());\n\t\tprimeExistingResults();\n\t};\n\n\tpi.on(\"session_start\", (_event, ctx) => {\n\t\tresetSessionState(ctx);\n\t\trpcBridge.emitReady(ctx);\n\t\tsupervisorChannel.start();\n\t});\n\n\tpi.on(\"session_shutdown\", () => {\n\t\tgeneration++;\n\t\tsupervisorChannel.cancelOwnedQuestions(\"parent session shutdown\");\n\t\tstate.sessionGeneration = (state.sessionGeneration ?? 0) + 1;\n\t\texecutorPromise = undefined;\n\t\tpendingLaunches.clear();\n\t\tpendingAsyncLaunches.clear();\n\t\tunregisterCancellation?.();\n\t\tdelete process.env[SUBAGENT_PARENT_SESSION_ENV];\n\t\tfor (const unsubscribe of eventUnsubscribes) {\n\t\t\ttry {\n\t\t\t\tunsubscribe();\n\t\t\t} catch {\n\t\t\t\t// Best effort cleanup during shutdown.\n\t\t\t}\n\t\t}\n\t\tif (globalStore[eventUnsubscribeStoreKey] === eventUnsubscribes) {\n\t\t\tdelete globalStore[eventUnsubscribeStoreKey];\n\t\t}\n\t\tstopResultWatcher();\n\t\tscheduledRunManager.stop();\n\t\tif (state.poller) clearInterval(state.poller);\n\t\tstate.poller = null;\n\t\tclearPendingForegroundControlNotices(state);\n\t\tfor (const timer of state.cleanupTimers.values()) {\n\t\t\tclearTimeout(timer);\n\t\t}\n\t\tstate.cleanupTimers.clear();\n\t\tstate.asyncJobs.clear();\n\t\tclearSlashSnapshots();\n\t\tslashBridge.cancelAll();\n\t\tslashBridge.dispose();\n\t\tpromptTemplateBridge.cancelAll();\n\t\tpromptTemplateBridge.dispose();\n\t\tsupervisorChannel.dispose();\n\t\tif (globalStore[runtimeCleanupStoreKey] === runtimeCleanup) {\n\t\t\tdelete globalStore[runtimeCleanupStoreKey];\n\t\t}\n\t\tdisposeSubagentWidget();\n\t\ttry {\n\t\t\tif (state.lastUiContext?.hasUI) {\n\t\t\t\tstate.lastUiContext.ui.setWidget(WIDGET_KEY, undefined);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tif (!isStaleExtensionContextError(error)) throw error;\n\t\t}\n\t});\n}\n"]}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/extension/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAoC,MAAM,iCAAiC,CAAC;AAEtG,OAAO,EAAO,SAAS,EAAU,IAAI,EAAmE,MAAM,wBAAwB,CAAC;AAuCvI,OAAO,EAGN,KAAK,aAAa,EAYlB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiFzC,wBAAgB,iCAAiC,CAAC,IAAI,KAAA,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAgBhG;AAED,wBAAgB,kBAAkB,CAAC,OAAO,KAAA,EAAE,KAAK,KAAA,EAAE,OAAO,KAAA,EAAE,OAAO,KAAA,oBA4ClE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,KAAA,EAAE,KAAK,KAAA,QASlD;AA8FD,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA8ZxE","sourcesContent":["// @ts-nocheck\n/**\n * Subagent Tool\n *\n * Full-featured subagent with foreground and async modes.\n * - Async (default): Background execution, emits events when done\n * - Foreground (async:false or clarify:true): Streams output, renders markdown, tracks usage\n *\n * Modes: single (agent + task), parallel (tasks[]), chain (chain[] with {previous})\n *\n * Config file: ~/.lunr/agent/extensions/subagent/config.json\n *   { \"maxSubagentDepth\": 1, \"intercomBridge\": { \"mode\": \"always\", \"instructionFile\": \"./intercom-bridge.md\" }, \"worktreeSetupHook\": \"./scripts/setup-worktree.mjs\" }\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { createSubagentCancellation, registerSubagentCancellation } from \"../../../../core/subagent-cancellation.ts\";\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport type { AgentToolResult } from \"@ashx-j/lunr-agent\";\nimport type { ExtensionAPI, ExtensionContext, ToolDefinition } from \"@ashx-j/lunr\";\nimport { awaitWithAbort } from \"../../../../utils/await-with-abort.ts\";\nimport { Box, Container, Spacer, Text, truncateToWidth, visibleWidth, wrapTextWithAnsi, type Component } from \"@ashx-j/lunr-tui\";\n\nimport { cleanupAllArtifactDirs, cleanupOldArtifacts, getArtifactsDir } from \"../shared/artifacts.ts\";\nimport { resolveCurrentSessionId } from \"../shared/session-identity.ts\";\nimport { cleanupOldChainDirs } from \"../shared/settings.ts\";\nimport {\n\tclearLegacyResultAnimationTimer,\n\tdisposeSubagentWidget,\n\trenderSubagentResult,\n\tSUBAGENT_PAINT_INTERVAL_MS,\n\tsubagentAnimSink,\n} from \"../tui/render.ts\";\nimport { SubagentParams } from \"./schemas.ts\";\nimport { validateChainInput } from \"./chain-validation.ts\";\nimport type { createSubagentExecutor, SubagentParamsLike } from \"../runs/foreground/subagent-executor.ts\";\nimport { resolveSubagentRequestParams } from \"../runs/foreground/request-params.ts\";\nimport { createAsyncJobTracker } from \"../runs/background/async-job-tracker.ts\";\nimport { createResultWatcher } from \"../runs/background/result-watcher.ts\";\nimport { createScheduledRunManager } from \"../runs/background/scheduled-runs.ts\";\nimport { isAsyncSubagentExecution, normalizeAsyncLaunchConfig, subagentLaunchRunsAsync } from \"../runs/background/top-level-async.ts\";\nimport { registerSlashCommands } from \"../slash/slash-commands.ts\";\nimport { registerPromptTemplateDelegationBridge } from \"../slash/prompt-template-bridge.ts\";\nimport { registerMainWatchdog } from \"../watchdog/register-main.ts\";\nimport { registerSlashSubagentBridge } from \"../slash/slash-bridge.ts\";\nimport { createNativeSupervisorChannel, registerSupervisorRenderers } from \"../intercom/native-supervisor-channel.ts\";\nimport { renderCommunicationCall, renderCommunicationResult } from \"../tui/communication.ts\";\nimport { registerSubagentRpcBridge } from \"./rpc.ts\";\nimport { clearSlashSnapshots, getSlashRenderableSnapshot, resolveSlashMessageDetails, restoreSlashFinalSnapshots, type SlashMessageDetails } from \"../slash/slash-live-state.ts\";\nimport { inspectSubagentStatus } from \"../runs/background/run-status.ts\";\nimport { resolveWaitToolConfig } from \"../runs/background/subagent-wait.ts\";\nimport { registerWaitTool } from \"../runs/background/wait-tool.ts\";\nimport { drainOutstandingWork } from \"../runs/background/auto-drain.ts\";\nimport registerSubagentNotify, { parseSubagentNotifyContent, type SubagentNotifyDetails } from \"../runs/background/notify.ts\";\nimport { formatSteeringNotice, handleSubagentSteeringNotice, SUBAGENT_STEERING_MESSAGE_TYPE, type SubagentSteeringMessageDetails } from \"./steering-notices.ts\";\nimport { controlNotificationKey } from \"../runs/shared/subagent-control.ts\";\nimport { SUBAGENT_CHILD_ENV } from \"../runs/shared/pi-args.ts\";\n\nimport { loadConfig } from \"./config.ts\";\nimport { buildSubagentToolDescription } from \"./tool-description.ts\";\nimport {\n\ttype AsyncJobState,\n\ttype Details,\n\ttype SubagentState,\n\tASYNC_DIR,\n\tchildRowLabel,\n\tDEFAULT_ARTIFACT_CONFIG,\n\tRESULTS_DIR,\n\tSLASH_RESULT_TYPE,\n\tSLASH_TEXT_RESULT_TYPE,\n\tSUBAGENT_ASYNC_COMPLETE_EVENT,\n\tSUBAGENT_ASYNC_STARTED_EVENT,\n\tSUBAGENT_CONTROL_EVENT,\n\tSUBAGENT_STEERING_NOTICE_EVENT,\n\tWIDGET_KEY,\n} from \"../shared/types.ts\";\nimport {\n\tclearPendingForegroundControlNotices,\n\tformatSubagentControlNotice,\n\thandleSubagentControlNotice,\n\tSUBAGENT_CONTROL_MESSAGE_TYPE,\n\ttype SubagentControlMessageDetails,\n} from \"./control-notices.ts\";\n\nexport { loadConfig } from \"./config.ts\";\n\n/**\n * Derive subagent session base directory from parent session file.\n * If parent session is ~/.lunr/agent/sessions/abc123.jsonl,\n * returns ~/.lunr/agent/sessions/abc123/ as the base.\n * Callers add runId to create the actual session root: abc123/{runId}/\n * Falls back to a unique temp directory if no parent session.\n */\nfunction getSubagentSessionRoot(parentSessionFile: string | null): string {\n\tif (parentSessionFile) {\n\t\tconst baseName = path.basename(parentSessionFile, \".jsonl\");\n\t\tconst sessionsDir = path.dirname(parentSessionFile);\n\t\treturn path.join(sessionsDir, baseName);\n\t}\n\treturn fs.mkdtempSync(path.join(os.tmpdir(), \"pi-subagent-session-\"));\n}\n\nfunction expandTilde(p: string): string {\n\treturn p.startsWith(\"~/\") ? path.join(os.homedir(), p.slice(2)) : p;\n}\n\n/**\n * Create a directory and verify it is actually accessible.\n * On Windows with Azure AD/Entra ID, directories created shortly after\n * wake-from-sleep can end up with broken NTFS ACLs (null DACL) when the\n * cloud SID cannot be resolved without network connectivity. This leaves\n * the directory completely inaccessible to the creating user.\n */\nfunction ensureAccessibleDir(dirPath: string): void {\n\tfs.mkdirSync(dirPath, { recursive: true });\n\ttry {\n\t\tfs.accessSync(dirPath, fs.constants.R_OK | fs.constants.W_OK);\n\t} catch {\n\t\ttry {\n\t\t\tfs.rmSync(dirPath, { recursive: true, force: true });\n\t\t} catch {\n\t\t\t// Best effort: retry mkdir/access even if cleanup fails.\n\t\t}\n\t\tfs.mkdirSync(dirPath, { recursive: true });\n\t\tfs.accessSync(dirPath, fs.constants.R_OK | fs.constants.W_OK);\n\t}\n}\n\nfunction isSlashResultRunning(result: { details?: Details }): boolean {\n\treturn result.details?.progress?.some((entry) => entry.status === \"running\")\n\t\t|| result.details?.results.some((entry) => entry.progress?.status === \"running\")\n\t\t|| false;\n}\n\n// Drives the inline running-indicator braille animation for foreground subagent\n// results. Foreground runs receive progress only on child events, so the glyph\n// (derived from progress fields) would freeze between events. While a result is\n// running we tick a frame counter every 80ms; renderResult registers the\n// running-glyph lines in state.animEntries (via subagentAnimSink) and the timer\n// rewrites just those Text nodes + requests a repaint, instead of invalidate()-ing\n// the whole tool component (a full renderSubagentResult rebuild 12.5x/s made the\n// spinner laggy).\nfunction subagentResultIsRunning(result: { details?: Details }): boolean {\n\treturn result.details?.progress?.some((entry) => entry.status === \"running\")\n\t\t|| result.details?.results.some((entry) => entry.progress?.status === \"running\")\n\t\t|| false;\n}\n\nfunction effectiveParallelTaskCount(tasks: Array<{ count?: unknown }> | undefined): number {\n\tif (!tasks || tasks.length === 0) return 0;\n\treturn tasks.reduce((total, task) => {\n\t\tconst count = typeof task.count === \"number\" && Number.isInteger(task.count) && task.count >= 1 ? task.count : 1;\n\t\treturn total + count;\n\t}, 0);\n}\n\nfunction matchingActionJobs(state: SubagentState, requestedId: string): AsyncJobState[] {\n\tconst jobs = new Map<string, AsyncJobState>();\n\tfor (const job of state.asyncJobs.values()) jobs.set(job.asyncId, job);\n\tfor (const job of state.fleetJobs?.values() ?? []) jobs.set(job.asyncId, job);\n\tconst exact = jobs.get(requestedId);\n\tif (exact) return [exact];\n\treturn [...jobs.values()].filter((job) => job.asyncId.startsWith(requestedId));\n}\n\nexport function resolveSubagentActionDisplayTitle(args, state: SubagentState): string | undefined {\n\tconst requestedId = (args.id || args.runId || \"\").trim();\n\tif (!requestedId) return undefined;\n\tconst matches = matchingActionJobs(state, requestedId);\n\tif (matches.length !== 1) return undefined;\n\tconst job = matches[0]!;\n\tconst steps = job.steps ?? [];\n\tif (Number.isInteger(args.index)) {\n\t\tconst step = steps.find((candidate) => candidate.index === args.index) ?? steps[args.index];\n\t\treturn step ? childRowLabel(step) : undefined;\n\t}\n\tif (steps.length === 1) return childRowLabel(steps[0]!);\n\tif (steps.length > 1) return `${job.mode ?? \"subagent\"} run`;\n\tif (job.agents?.length === 1) return job.agents[0];\n\tif (job.agents?.length) return `${job.mode ?? \"subagent\"} run`;\n\treturn undefined;\n}\n\nexport function renderSubagentCall(rawArgs, theme, context, options) {\n\tconst args = resolveSubagentRequestParams(rawArgs);\n\tif (args.action) {\n\t\tconst resultTitle = context?.result?.details?.displayTitle;\n\t\tconst resolvedTitle = resultTitle || options?.resolveActionTitle?.(args);\n\t\tconst target = resolvedTitle || args.id || args.runId || \"\";\n\t\tif ((args.action === \"steer\" || args.action === \"resume\") && args.message) {\n\t\t\treturn renderCommunicationCall(\n\t\t\t\t\"subagent\",\n\t\t\t\targs,\n\t\t\t\ttheme,\n\t\t\t\tcontext,\n\t\t\t\t{ direction: \"to\", peer: resolvedTitle || \"Subagent\", kind: \"steer\", message: args.message },\n\t\t\t\tresolvedTitle,\n\t\t\t);\n\t\t}\n\t\treturn new Text(\n\t\t\t`${theme.fg(\"toolTitle\", theme.bold(\"subagent \"))}${args.action}${target ? ` ${theme.fg(\"accent\", target)}` : \"\"}`,\n\t\t\t0,\n\t\t\t0,\n\t\t);\n\t}\n\tconst isParallel = (args.tasks?.length ?? 0) > 0;\n\tconst parallelCount = effectiveParallelTaskCount(args.tasks as Array<{ count?: unknown }> | undefined);\n\tconst asyncMark = subagentLaunchRunsAsync(args) ? `${theme.fg(\"warning\", \"async\")} ` : \"\";\n\tif (args.chain?.length) {\n\t\treturn new Text(\n\t\t\t`${theme.fg(\"toolTitle\", theme.bold(\"subagent \"))}${asyncMark}chain (${args.chain.length})`,\n\t\t\t0,\n\t\t\t0,\n\t\t);\n\t}\n\tif (isParallel) {\n\t\treturn new Text(\n\t\t\t`${theme.fg(\"toolTitle\", theme.bold(\"subagent \"))}${asyncMark}parallel (${parallelCount})`,\n\t\t\t0,\n\t\t\t0,\n\t\t);\n\t}\n\tconst showDescription = !context?.result && !context?.isPartial && !context?.expanded && !context?.isError;\n\tconst description = showDescription ? theme.fg(\"accent\", args.description || args.task || \"?\") : \"\";\n\tconst title = theme.fg(\"toolTitle\", theme.bold(\"subagent\"));\n\tconst rest = [asyncMark.trim() ? theme.fg(\"warning\", \"async\") : \"\", description].filter(Boolean).join(\" \");\n\treturn new Text(rest ? `${title} ${rest}` : title, 0, 0);\n}\n\nexport function renderSubagentNotify(details, theme) {\n\tconst status = typeof details?.status === \"string\" ? details.status : \"\";\n\tconst icon = status === \"completed\"\n\t\t? theme.fg(\"success\", \"✓\")\n\t\t: status === \"failed\"\n\t\t\t? theme.fg(\"error\", \"✗\")\n\t\t\t: theme.fg(\"warning\", \"■\");\n\tconst title = details?.agent || \"child\";\n\treturn new Text(`${icon} ${theme.bold(title)} ${theme.fg(\"dim\", status)}`, 0, 0);\n}\n\nfunction ensureSubagentResultAnimation(context: { state: Record<string, unknown>; invalidate?: () => void; requestRender?: () => void }): void {\n\tconst state = context.state as {\n\t\tsubagentResultAnimationTimer?: ReturnType<typeof setInterval>;\n\t\tframe?: number;\n\t\tanimEntries?: Array<{ text: Text; line: (frame: number, now: number) => string }>;\n\t};\n\tif (state.subagentResultAnimationTimer) return;\n\tif (typeof context.invalidate !== \"function\") return;\n\tif (state.frame === undefined) state.frame = 0;\n\tstate.subagentResultAnimationTimer = setInterval(() => {\n\t\tstate.frame = (state.frame ?? 0) + 1;\n\t\ttry {\n\t\t\tconst entries = state.animEntries;\n\t\t\tif (entries?.length && typeof context.requestRender === \"function\") {\n\t\t\t\tconst now = Date.now();\n\t\t\t\tfor (const entry of entries) entry.text.setText(entry.line(state.frame ?? 0, now));\n\t\t\t\tcontext.requestRender();\n\t\t\t} else {\n\t\t\t\tcontext.invalidate();\n\t\t\t}\n\t\t} catch {}\n\t}, SUBAGENT_PAINT_INTERVAL_MS);\n}\n\nfunction isSlashResultError(result: { details?: Details }): boolean {\n\treturn result.details?.results.some((entry) => entry.exitCode !== 0 && entry.progress?.status !== \"running\") || false;\n}\n\nfunction isStaleExtensionContextError(error: unknown): boolean {\n\treturn error instanceof Error && error.message.includes(\"Extension context no longer active\");\n}\n\nfunction rebuildSlashResultContainer(\n\tcontainer: Container,\n\tresult: AgentToolResult<Details>,\n\toptions: { expanded: boolean },\n\ttheme: ExtensionContext[\"ui\"][\"theme\"],\n): void {\n\tcontainer.clear();\n\tcontainer.addChild(new Spacer(1));\n\tconst boxTheme = isSlashResultRunning(result) ? \"toolPendingBg\" : isSlashResultError(result) ? \"toolErrorBg\" : \"toolSuccessBg\";\n\tconst box = new Box(1, 1, (text: string) => theme.bg(boxTheme, text));\n\tbox.addChild(renderSubagentResult(result, options, theme));\n\tcontainer.addChild(box);\n}\n\nfunction createSlashResultComponent(\n\tdetails: SlashMessageDetails,\n\toptions: { expanded: boolean },\n\ttheme: ExtensionContext[\"ui\"][\"theme\"],\n): Container {\n\tconst container = new Container();\n\tlet lastVersion = -1;\n\tcontainer.render = (width: number): string[] => {\n\t\tconst snapshot = getSlashRenderableSnapshot(details);\n\t\tif (snapshot.version !== lastVersion || isSlashResultRunning(snapshot.result)) {\n\t\t\tlastVersion = snapshot.version;\n\t\t\trebuildSlashResultContainer(container, snapshot.result, options, theme);\n\t\t}\n\t\treturn Container.prototype.render.call(container, width);\n\t};\n\treturn container;\n}\n\nclass SubagentControlNoticeComponent implements Component {\n\tconstructor(\n\t\tprivate readonly details: SubagentControlMessageDetails,\n\t\tprivate readonly theme: ExtensionContext[\"ui\"][\"theme\"],\n\t) {}\n\n\tinvalidate(): void {}\n\n\trender(width: number): string[] {\n\t\tconst eventLabel = this.details.event.type.replaceAll(\"_\", \" \");\n\t\tif (width < 3) return [truncateToWidth(`Subagent ${eventLabel}`, width)];\n\t\tconst bodyWidth = Math.max(1, width - 2);\n\t\tconst borderChar = \"─\";\n\t\tconst header = ` ⚠ Subagent ${eventLabel}: ${this.details.event.agent} `;\n\t\tconst headerText = truncateToWidth(header, bodyWidth, \"\");\n\t\tconst headerPadding = Math.max(0, bodyWidth - visibleWidth(headerText));\n\t\tconst lines = [this.theme.fg(\"accent\", `╭${headerText}${borderChar.repeat(headerPadding)}╮`)];\n\n\t\tfor (const line of wrapTextWithAnsi(formatSubagentControlNotice(this.details), bodyWidth)) {\n\t\t\tconst text = truncateToWidth(line, bodyWidth, \"\");\n\t\t\tconst padding = Math.max(0, bodyWidth - visibleWidth(text));\n\t\t\tlines.push(this.theme.fg(\"accent\", `│${text}${\" \".repeat(padding)}│`));\n\t\t}\n\t\tlines.push(this.theme.fg(\"accent\", `╰${borderChar.repeat(bodyWidth)}╯`));\n\t\treturn lines;\n\t}\n}\n\nexport default function registerSubagentExtension(pi: ExtensionAPI): void {\n\tif (process.env[SUBAGENT_CHILD_ENV] === \"1\") {\n\t\treturn;\n\t}\n\n\tensureAccessibleDir(RESULTS_DIR);\n\tensureAccessibleDir(ASYNC_DIR);\n\tcleanupOldChainDirs();\n\n\tconst config = normalizeAsyncLaunchConfig(loadConfig());\n\tconst waitToolConfig = resolveWaitToolConfig(config.waitTool);\n\tconst tempArtifactsDir = getArtifactsDir(null);\n\tcleanupAllArtifactDirs(DEFAULT_ARTIFACT_CONFIG.cleanupDays);\n\n\tconst state: SubagentState = {\n\t\tbaseCwd: \"\",\n\t\tcurrentSessionId: null,\n\t\tsessionGeneration: 0,\n\t\tforegroundSubagentInFlight: 0,\n\t\tsubagentSpawns: { sessionId: null, count: 0 },\n\t\tasyncJobs: new Map(),\n\t\tfleetJobs: new Map(),\n\t\tforegroundRuns: new Map(),\n\t\tforegroundControls: new Map(),\n\t\tlastForegroundControlId: null,\n\t\tpendingForegroundControlNotices: new Map(),\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: {\n\t\t\tschedule: () => false,\n\t\t\tclear: () => {},\n\t\t},\n\t};\n\n\tconst supervisorChannel = createNativeSupervisorChannel(pi, state);\n\tconst mainWatchdog = registerMainWatchdog(pi);\n\tconst { startResultWatcher, primeExistingResults, stopResultWatcher } = createResultWatcher(\n\t\tpi,\n\t\tstate,\n\t\tRESULTS_DIR,\n\t\t10 * 60 * 1000,\n\t);\n\n\tlet generation = 0;\n\tlet executorPromise: Promise<ReturnType<typeof createSubagentExecutor>> | undefined;\n\tconst pendingLaunches = new Set<Promise<void>>();\n\tconst pendingAsyncLaunches = new Set<Promise<void>>();\n\tlet unregisterCancellation: (() => void) | undefined;\n\n\tconst { ensurePoller, refreshWidget, handleStarted, handleComplete: trackComplete, resetJobs, restoreActiveJobs } = createAsyncJobTracker(pi, state, ASYNC_DIR, {\n\t\twidgetEnabled: config.asyncWidget !== false,\n\t});\n\tconst handleComplete = (data: unknown) => {\n\t\ttrackComplete(data);\n\t\tconst result = data as { id?: string; sessionId?: string };\n\t\tif (typeof state.currentSessionId === \"string\" && result.sessionId !== state.currentSessionId) return;\n\t\tif (typeof result.id === \"string\" && result.id.trim()) {\n\t\t\tsupervisorChannel.settleRunQuestions(result.id, \"async run settled\");\n\t\t}\n\t};\n\tlet executorExecute: ((id: string, params: SubagentParamsLike, signal: AbortSignal, onUpdate: ((r: AgentToolResult<Details>) => void) | undefined, ctx: ExtensionContext) => Promise<AgentToolResult<Details>>) | undefined;\n\tconst scheduledRunManager = createScheduledRunManager({\n\t\tconfig,\n\t\tlaunch: (params, ctx, signal) => {\n\t\t\tif (!executorExecute) {\n\t\t\t\treturn Promise.resolve({\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Scheduled subagent launch is unavailable (executor not ready).\" }],\n\t\t\t\t\tisError: true,\n\t\t\t\t\tdetails: { mode: \"management\" as const, results: [] },\n\t\t\t\t});\n\t\t\t}\n\t\t\treturn executorExecute(randomUUID(), params, signal, undefined, ctx);\n\t\t},\n\t});\n\tconst executor: ReturnType<typeof createSubagentExecutor> = {\n\t\tasync execute(id, params, signal, onUpdate, ctx) {\n\t\t\tlet resolveLaunchReady!: () => void;\n\t\t\tlet launchReady = false;\n\t\t\tconst launchReadyPromise = new Promise<void>((resolve) => {\n\t\t\t\tresolveLaunchReady = resolve;\n\t\t\t});\n\t\t\tconst markLaunchReady = () => {\n\t\t\t\tif (launchReady) return;\n\t\t\t\tlaunchReady = true;\n\t\t\t\tpendingLaunches.delete(launchReadyPromise);\n\t\t\t\tpendingAsyncLaunches.delete(launchReadyPromise);\n\t\t\t\tresolveLaunchReady();\n\t\t\t};\n\t\t\tpendingLaunches.add(launchReadyPromise);\n\t\t\tif (isAsyncSubagentExecution(resolveSubagentRequestParams(params))) pendingAsyncLaunches.add(launchReadyPromise);\n\t\t\ttry {\n\t\t\t\tconst currentGeneration = generation;\n\t\t\t\tsignal?.throwIfAborted();\n\t\t\t\tif (!executorPromise) {\n\t\t\t\t\tconst pending = import(\"../runs/foreground/subagent-executor.ts\").then(({ createSubagentExecutor }) => {\n\t\t\t\t\t\tif (generation !== currentGeneration) throw new Error(\"Subagent session changed before initialization\");\n\t\t\t\t\t\treturn createSubagentExecutor({\n\t\t\t\t\t\t\tpi, state, config,\n\t\t\t\t\t\t\twaitToolEnabled: waitToolConfig.enabled,\n\t\t\t\t\t\t\thandleScheduledRunAction: (params, ctx) => scheduledRunManager.handleToolCall(params, ctx),\n\t\t\t\t\t\t\twatchdog: mainWatchdog, tempArtifactsDir, getSubagentSessionRoot, expandTilde,\n\t\t\t\t\t\t});\n\t\t\t\t\t});\n\t\t\t\t\texecutorPromise = pending;\n\t\t\t\t\tvoid pending.catch(() => {\n\t\t\t\t\t\tif (executorPromise === pending) executorPromise = undefined;\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tconst ready = await awaitWithAbort(executorPromise, signal);\n\t\t\t\tsignal?.throwIfAborted();\n\t\t\t\tif (generation !== currentGeneration) throw new Error(\"Subagent session changed before execution\");\n\t\t\t\tconst execution = ready.execute(id, params, signal, onUpdate, ctx);\n\t\t\t\tmarkLaunchReady();\n\t\t\t\treturn await execution;\n\t\t\t} finally {\n\t\t\t\tmarkLaunchReady();\n\t\t\t}\n\t\t},\n\t};\n\texecutorExecute = executor.execute;\n\n\tregisterSupervisorRenderers(pi, state);\n\n\tpi.registerMessageRenderer<SlashMessageDetails>(SLASH_RESULT_TYPE, (message, options, theme) => {\n\t\tconst details = resolveSlashMessageDetails(message.details);\n\t\tif (!details) return undefined;\n\t\treturn createSlashResultComponent(details, options, theme);\n\t});\n\n\tpi.registerMessageRenderer<undefined>(SLASH_TEXT_RESULT_TYPE, (message, _options, _theme) => {\n\t\tconst content = typeof message.content === \"string\"\n\t\t\t? message.content\n\t\t\t: message.content\n\t\t\t\t.filter((entry) => entry.type === \"text\")\n\t\t\t\t.map((entry) => entry.text)\n\t\t\t\t.join(\"\\n\");\n\t\treturn new Text(content, 0, 0);\n\t});\n\n\tpi.registerMessageRenderer<SubagentNotifyDetails>(\"subagent-notify\", (message, _options, theme) => {\n\t\tconst content = typeof message.content === \"string\" ? message.content : \"\";\n\t\tconst details = (message.details as SubagentNotifyDetails | undefined) ?? parseSubagentNotifyContent(content);\n\t\tif (!details) return new Text(content, 0, 0);\n\t\treturn renderSubagentNotify(details, theme);\n\t});\n\n\tpi.registerMessageRenderer<SubagentSteeringMessageDetails>(SUBAGENT_STEERING_MESSAGE_TYPE, (message, _options, theme) => {\n\t\tconst details = message.details as SubagentSteeringMessageDetails | undefined;\n\t\tif (!details) return undefined;\n\t\treturn new Text(theme.fg(details.state === \"recovered\" ? \"warning\" : \"error\", formatSteeringNotice(details)), 0, 0);\n\t});\n\n\tpi.registerMessageRenderer<SubagentControlMessageDetails>(SUBAGENT_CONTROL_MESSAGE_TYPE, () => undefined);\n\n\tconst executeSubagentCollapsed = async (id: string, params: SubagentParamsLike, signal: AbortSignal, onUpdate: ((result: AgentToolResult<Details>) => void) | undefined, ctx: ExtensionContext) => {\n\t\tif (ctx.hasUI) ctx.ui.setToolsExpanded(false);\n\t\tconst isCommunication = (params.action === \"steer\" || params.action === \"resume\") && typeof params.message === \"string\";\n\t\tconst displayTitle = isCommunication ? resolveSubagentActionDisplayTitle(params, state) : undefined;\n\t\tconst jobs = isCommunication ? matchingActionJobs(state, (params.id || params.runId || \"\").trim()) : [];\n\t\tconst targetNames = new Map(jobs.length === 1 ? jobs[0]!.steps?.map((step, index) => [step.index ?? index, childRowLabel(step)]) : []);\n\t\tconst result = await executor.execute(id, params, signal, onUpdate, ctx);\n\t\tif (displayTitle && result.details) result.details.displayTitle = displayTitle;\n\t\tif (isCommunication && result.details) {\n\t\t\tconst targets = result.details.steering?.targets.map((target) => targetNames.get(target.index) ?? `Subagent ${target.index + 1}`);\n\t\t\tconst peer = targets?.length ? targets.join(\", \") : displayTitle || \"Subagent\";\n\t\t\tresult.details.communication = { direction: \"to\", peer, kind: \"steer\", message: params.message };\n\t\t}\n\t\treturn result;\n\t};\n\n\tconst slashBridge = registerSlashSubagentBridge({\n\t\tevents: pi.events,\n\t\tgetContext: () => state.lastUiContext,\n\t\texecute: (id, params, signal, onUpdate, ctx) =>\n\t\t\texecuteSubagentCollapsed(id, params, signal, onUpdate, ctx),\n\t});\n\n\tconst promptTemplateBridge = registerPromptTemplateDelegationBridge({\n\t\tevents: pi.events,\n\t\tgetContext: () => state.lastUiContext,\n\t\texecute: (requestId, params, signal, ctx, onUpdate) =>\n\t\t\texecuteSubagentCollapsed(requestId, params, signal, onUpdate, ctx),\n\t});\n\n\tconst rpcBridge = registerSubagentRpcBridge({\n\t\tevents: pi.events,\n\t\tgetContext: () => state.lastUiContext,\n\t\texecute: (id, params, signal, onUpdate, ctx) => executor.execute(id, params, signal, onUpdate, ctx),\n\t});\n\n\tconst tool: ToolDefinition<typeof SubagentParams, Details> = {\n\t\tname: \"subagent\",\n\t\tlabel: \"Subagent\",\n\t\tdescription: buildSubagentToolDescription(config),\n\t\tparameters: SubagentParams,\n\t\t// lunr: same-turn SINGLE calls overlap; sequential work uses chain.\n\t\texecutionMode: \"parallel\",\n\n\t\tprepareArguments(args) {\n\t\t\t// Run friendly chain validation before pi-ai's raw TypeBox schema check\n\t\t\t// so the model sees which property is disallowed, what is allowed, and a\n\t\t\t// valid example instead of `chain.N: must not have additional properties`.\n\t\t\tvalidateChainInput(args);\n\t\t\treturn args as never;\n\t\t},\n\n\t\texecute(id, params, signal, onUpdate, ctx) {\n\t\t\treturn executeSubagentCollapsed(id, params, signal, onUpdate, ctx);\n\t\t},\n\n\t\trenderCall: (args, theme, context) => renderSubagentCall(args, theme, context, {\n\t\t\tresolveActionTitle: (params) => resolveSubagentActionDisplayTitle(params, state),\n\t\t}),\n\n\t\trenderResult(result, options, theme, context) {\n\t\t\tif (result.details?.communication) return renderCommunicationResult(result.content, result.details, options.expanded, context.isError, theme);\n\t\t\tif (subagentResultIsRunning(result)) {\n\t\t\t\tensureSubagentResultAnimation(context);\n\t\t\t} else {\n\t\t\t\tclearLegacyResultAnimationTimer(context);\n\t\t\t}\n\t\t\tconst state = context.state as { frame?: number; animEntries?: Array<{ text: Text; line: (frame: number) => string }> };\n\t\t\t// lunr: collect running-glyph line templates while rendering so the\n\t\t\t// animation timer can rewrite them in place (see ensureSubagentResultAnimation).\n\t\t\tconst entries: Array<{ text: Text; line: (frame: number) => string }> = [];\n\t\t\tstate.animEntries = entries;\n\t\t\tsubagentAnimSink.current = entries;\n\t\t\ttry {\n\t\t\t\treturn renderSubagentResult(result, options, theme, state.frame ?? 0);\n\t\t\t} finally {\n\t\t\t\tsubagentAnimSink.current = null;\n\t\t\t}\n\t\t},\n\n\t};\n\n\tpi.registerTool(tool);\n\n\t// lunr: register a callback so model-tier settings changes rebuild the subagent\n\t// tool description and refresh the live registry.\n\tconst modelTierBridge = (globalThis as Record<symbol, unknown>)[Symbol.for(\"@lunr/model-tiers\")] as\n\t\t| { registerToolDescriptionRefresher?: (refresher: () => void) => void }\n\t\t| undefined;\n\tmodelTierBridge?.registerToolDescriptionRefresher?.(() => {\n\t\ttool.description = buildSubagentToolDescription(config);\n\t\t// pi.runtime is not on ExtensionAPI; registerTool refreshes the live registry.\n\t\tpi.registerTool(tool);\n\t});\n\n\tregisterWaitTool(pi, state, waitToolConfig.enabled, async (signal) => {\n\t\tconst launches = [...pendingLaunches];\n\t\tif (launches.length === 0) return;\n\t\tawait awaitWithAbort(Promise.all(launches).then(() => {}), signal);\n\t});\n\n\tpi.on(\"agent_end\", async (_event, ctx) => {\n\t\tif (ctx.hasUI) return;\n\t\tawait drainOutstandingWork({ state, events: pi.events, hasPendingMessages: () => ctx.hasPendingMessages() });\n\t});\n\n\tregisterSlashCommands(pi, state);\n\n\tlet disposeNotify = registerSubagentNotify(pi, state, { batchConfig: config.completionBatch });\n\tconst visibleControlNotices = new Set<string>();\n\tconst controlEventHandler = (payload: unknown) => {\n\t\thandleSubagentControlNotice({\n\t\t\tpi,\n\t\t\tstate,\n\t\t\tvisibleControlNotices,\n\t\t\tdetails: payload as SubagentControlMessageDetails,\n\t\t});\n\t};\n\tconst steeringNoticeHandler = (payload: unknown) => {\n\t\thandleSubagentSteeringNotice({ pi, state, details: payload as SubagentSteeringMessageDetails });\n\t};\n\tconst eventUnsubscribes = [\n\t\tpi.events.on(SUBAGENT_ASYNC_STARTED_EVENT, handleStarted),\n\t\tpi.events.on(SUBAGENT_ASYNC_COMPLETE_EVENT, handleComplete),\n\t\tpi.events.on(SUBAGENT_CONTROL_EVENT, controlEventHandler),\n\t\tpi.events.on(SUBAGENT_STEERING_NOTICE_EVENT, steeringNoticeHandler),\n\t\trpcBridge.dispose,\n\t];\n\n\tpi.on(\"tool_result\", (event, ctx) => {\n\t\tif (event.toolName !== \"subagent\") return;\n\t\tif (!ctx.hasUI) return;\n\t\tstate.lastUiContext = ctx;\n\t\tif (state.asyncJobs.size > 0) {\n\t\t\trefreshWidget(ctx);\n\t\t\tensurePoller();\n\t\t}\n\t});\n\n\tconst cleanupSessionArtifacts = (ctx: ExtensionContext) => {\n\t\ttry {\n\t\t\tconst sessionFile = ctx.sessionManager.getSessionFile();\n\t\t\tif (sessionFile) {\n\t\t\t\tcleanupOldArtifacts(getArtifactsDir(sessionFile), DEFAULT_ARTIFACT_CONFIG.cleanupDays);\n\t\t\t}\n\t\t} catch {\n\t\t\t// Cleanup failures should not block session lifecycle events.\n\t\t}\n\t};\n\n\tconst resetSessionState = (ctx: ExtensionContext) => {\n\t\tgeneration++;\n\t\tdisposeNotify();\n\t\tdisposeNotify = registerSubagentNotify(pi, state, { batchConfig: config.completionBatch });\n\t\tstopResultWatcher();\n\t\tsupervisorChannel.dispose();\n\t\tstate.sessionGeneration = (state.sessionGeneration ?? 0) + 1;\n\t\texecutorPromise = undefined;\n\t\tpendingLaunches.clear();\n\t\tpendingAsyncLaunches.clear();\n\t\tunregisterCancellation?.();\n\t\tstate.baseCwd = ctx.cwd;\n\t\tstate.currentSessionId = resolveCurrentSessionId(ctx.sessionManager);\n\t\tstate.subagentSpawns = { sessionId: state.currentSessionId, count: 0 };\n\t\t// Child spawn paths pass the owning session explicitly. Shared process\n\t\t// environment cannot represent several simultaneous gateway parents.\n\t\tstate.lastUiContext = ctx;\n\t\tcleanupSessionArtifacts(ctx);\n\t\tclearPendingForegroundControlNotices(state);\n\t\tvisibleControlNotices.clear();\n\t\tfor (const entry of ctx.sessionManager.getEntries()) {\n\t\t\tif ((entry.type !== \"custom_message\" && entry.type !== \"custom\") || entry.customType !== SUBAGENT_CONTROL_MESSAGE_TYPE) continue;\n\t\t\tconst data = entry.type === \"custom_message\" ? entry.details : entry.data;\n\t\t\tif (!data || typeof data !== \"object\" || !(\"event\" in data)) continue;\n\t\t\tconst details = data as SubagentControlMessageDetails;\n\t\t\tif (typeof details.event?.runId !== \"string\" || typeof details.event.type !== \"string\") continue;\n\t\t\tvisibleControlNotices.add(controlNotificationKey(details.event, details.childIntercomTarget));\n\t\t}\n\t\tresetJobs(ctx);\n\t\trestoreActiveJobs(ctx);\n\t\tconst sessionId = state.currentSessionId;\n\t\tconst sessionGeneration = generation;\n\t\tif (sessionId) {\n\t\t\tconst cancellation = createSubagentCancellation({\n\t\t\t\tpendingLaunches: pendingAsyncLaunches,\n\t\t\t\tisCurrent: () => generation === sessionGeneration && state.currentSessionId === sessionId,\n\t\t\t\tgetActiveRunIds: () => [...state.asyncJobs.values()]\n\t\t\t\t\t.filter((job) => job.sessionId === sessionId && (job.status === \"queued\" || job.status === \"running\"))\n\t\t\t\t\t.map((job) => job.asyncId),\n\t\t\t\tasync stopRun(id) {\n\t\t\t\t\tconst result = await executor.execute(randomUUID(), { action: \"stop\", id }, new AbortController().signal, undefined, ctx);\n\t\t\t\t\treturn !result.isError;\n\t\t\t\t},\n\t\t\t});\n\t\t\t// Results use the session file identity; gateway controls use its UUID.\n\t\t\tconst identities = new Set([sessionId, ctx.sessionManager.getSessionId()]);\n\t\t\tconst unregisters = [...identities].filter((id): id is string => Boolean(id))\n\t\t\t\t.map((id) => registerSubagentCancellation(id, cancellation));\n\t\t\tunregisterCancellation = () => {\n\t\t\t\tfor (const unregister of unregisters) unregister();\n\t\t\t};\n\t\t}\n\t\tscheduledRunManager.bindSession(ctx);\n\t\trestoreSlashFinalSnapshots(ctx.sessionManager.getEntries());\n\t\tstartResultWatcher();\n\t\tprimeExistingResults();\n\t};\n\n\tpi.on(\"session_start\", (_event, ctx) => {\n\t\tresetSessionState(ctx);\n\t\trpcBridge.emitReady(ctx);\n\t\tsupervisorChannel.start();\n\t});\n\n\tpi.on(\"session_shutdown\", () => {\n\t\tgeneration++;\n\t\tsupervisorChannel.cancelOwnedQuestions(\"parent session shutdown\");\n\t\tstate.sessionGeneration = (state.sessionGeneration ?? 0) + 1;\n\t\texecutorPromise = undefined;\n\t\tpendingLaunches.clear();\n\t\tpendingAsyncLaunches.clear();\n\t\tunregisterCancellation?.();\n\t\tdisposeNotify();\n\t\tmainWatchdog.dispose();\n\t\tfor (const unsubscribe of eventUnsubscribes) {\n\t\t\ttry {\n\t\t\t\tunsubscribe();\n\t\t\t} catch {\n\t\t\t\t// Best effort cleanup during shutdown.\n\t\t\t}\n\t\t}\n\t\tstopResultWatcher();\n\t\tscheduledRunManager.stop();\n\t\tif (state.poller) clearInterval(state.poller);\n\t\tstate.poller = null;\n\t\tclearPendingForegroundControlNotices(state);\n\t\tfor (const timer of state.cleanupTimers.values()) {\n\t\t\tclearTimeout(timer);\n\t\t}\n\t\tstate.cleanupTimers.clear();\n\t\tstate.asyncJobs.clear();\n\t\tclearSlashSnapshots();\n\t\tslashBridge.cancelAll();\n\t\tslashBridge.dispose();\n\t\tpromptTemplateBridge.cancelAll();\n\t\tpromptTemplateBridge.dispose();\n\t\tsupervisorChannel.dispose();\n\t\tif (state.lastUiContext) disposeSubagentWidget(state.lastUiContext);\n\t\ttry {\n\t\t\tif (state.lastUiContext?.hasUI) {\n\t\t\t\tstate.lastUiContext.ui.setWidget(WIDGET_KEY, undefined);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tif (!isStaleExtensionContextError(error)) throw error;\n\t\t}\n\t});\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/extension/index.js

@@ -42,7 +42,8 @@ import { registerWaitTool } from "../runs/background/wait-tool.js";
 import { drainOutstandingWork } from "../runs/background/auto-drain.js";
 import registerSubagentNotify, { parseSubagentNotifyContent } from "../runs/background/notify.js";
 import { formatSteeringNotice, handleSubagentSteeringNotice, SUBAGENT_STEERING_MESSAGE_TYPE } from "./steering-notices.js";
-import { SUBAGENT_CHILD_ENV, SUBAGENT_PARENT_SESSION_ENV } from "../runs/shared/pi-args.js";
+import { controlNotificationKey } from "../runs/shared/subagent-control.js";
+import { SUBAGENT_CHILD_ENV } from "../runs/shared/pi-args.js";
 import { loadConfig } from "./config.js";
 import { buildSubagentToolDescription } from "./tool-description.js";
 import { ASYNC_DIR, childRowLabel, DEFAULT_ARTIFACT_CONFIG, RESULTS_DIR, SLASH_RESULT_TYPE, SLASH_TEXT_RESULT_TYPE, SUBAGENT_ASYNC_COMPLETE_EVENT, SUBAGENT_ASYNC_STARTED_EVENT, SUBAGENT_CONTROL_EVENT, SUBAGENT_STEERING_NOTICE_EVENT, WIDGET_KEY, } from "../shared/types.js";
@@ -268,17 +269,6 @@ export default function registerSubagentExtension(pi) {
     if (process.env[SUBAGENT_CHILD_ENV] === "1") {
         return;
     }
-    const globalStore = globalThis;
-    const runtimeCleanupStoreKey = "__piSubagentRuntimeCleanup";
-    const previousRuntimeCleanup = globalStore[runtimeCleanupStoreKey];
-    if (typeof previousRuntimeCleanup === "function") {
-        try {
-            previousRuntimeCleanup();
-        }
-        catch {
-            // Best effort cleanup for stale timers from an older reload.
-        }
-    }
     ensureAccessibleDir(RESULTS_DIR);
     ensureAccessibleDir(ASYNC_DIR);
     cleanupOldChainDirs();
@@ -312,33 +302,11 @@ export default function registerSubagentExtension(pi) {
     const supervisorChannel = createNativeSupervisorChannel(pi, state);
     const mainWatchdog = registerMainWatchdog(pi);
     const { startResultWatcher, primeExistingResults, stopResultWatcher } = createResultWatcher(pi, state, RESULTS_DIR, 10 * 60 * 1000);
-    startResultWatcher();
-    primeExistingResults();
     let generation = 0;
     let executorPromise;
     const pendingLaunches = new Set();
     const pendingAsyncLaunches = new Set();
     let unregisterCancellation;
-    const runtimeCleanup = () => {
-        generation++;
-        supervisorChannel.cancelOwnedQuestions("parent runtime replaced");
-        state.sessionGeneration = (state.sessionGeneration ?? 0) + 1;
-        executorPromise = undefined;
-        pendingLaunches.clear();
-        pendingAsyncLaunches.clear();
-        unregisterCancellation?.();
-        mainWatchdog.dispose();
-        stopResultWatcher();
-        scheduledRunManager.stop();
-        supervisorChannel.dispose();
-        clearPendingForegroundControlNotices(state);
-        disposeSubagentWidget();
-        if (state.poller) {
-            clearInterval(state.poller);
-            state.poller = null;
-        }
-    };
-    globalStore[runtimeCleanupStoreKey] = runtimeCleanup;
     const { ensurePoller, refreshWidget, handleStarted, handleComplete: trackComplete, resetJobs, restoreActiveJobs } = createAsyncJobTracker(pi, state, ASYNC_DIR, {
         widgetEnabled: config.asyncWidget !== false,
     });
@@ -543,25 +511,8 @@ export default function registerSubagentExtension(pi) {
         await drainOutstandingWork({ state, events: pi.events, hasPendingMessages: () => ctx.hasPendingMessages() });
     });
     registerSlashCommands(pi, state);
-    const eventUnsubscribeStoreKey = "__piSubagentEventUnsubscribes";
-    const controlNoticeSeenStoreKey = "__piSubagentVisibleControlNotices";
-    const previousEventUnsubscribes = globalStore[eventUnsubscribeStoreKey];
-    if (Array.isArray(previousEventUnsubscribes)) {
-        for (const unsubscribe of previousEventUnsubscribes) {
-            if (typeof unsubscribe !== "function")
-                continue;
-            try {
-                unsubscribe();
-            }
-            catch {
-                // Best effort cleanup for stale handlers from an older reload.
-            }
-        }
-    }
-    registerSubagentNotify(pi, state, { batchConfig: config.completionBatch });
-    const existingVisibleControlNotices = globalStore[controlNoticeSeenStoreKey];
-    const visibleControlNotices = existingVisibleControlNotices instanceof Set ? existingVisibleControlNotices : new Set();
-    globalStore[controlNoticeSeenStoreKey] = visibleControlNotices;
+    let disposeNotify = registerSubagentNotify(pi, state, { batchConfig: config.completionBatch });
+    const visibleControlNotices = new Set();
     const controlEventHandler = (payload) => {
         handleSubagentControlNotice({
             pi,
@@ -580,7 +531,6 @@ export default function registerSubagentExtension(pi) {
         pi.events.on(SUBAGENT_STEERING_NOTICE_EVENT, steeringNoticeHandler),
         rpcBridge.dispose,
     ];
-    globalStore[eventUnsubscribeStoreKey] = eventUnsubscribes;
     pi.on("tool_result", (event, ctx) => {
         if (event.toolName !== "subagent")
             return;
@@ -605,7 +555,10 @@ export default function registerSubagentExtension(pi) {
     };
     const resetSessionState = (ctx) => {
         generation++;
-        supervisorChannel.cancelOwnedQuestions("parent session replaced");
+        disposeNotify();
+        disposeNotify = registerSubagentNotify(pi, state, { batchConfig: config.completionBatch });
+        stopResultWatcher();
+        supervisorChannel.dispose();
         state.sessionGeneration = (state.sessionGeneration ?? 0) + 1;
         executorPromise = undefined;
         pendingLaunches.clear();
@@ -614,26 +567,29 @@ export default function registerSubagentExtension(pi) {
         state.baseCwd = ctx.cwd;
         state.currentSessionId = resolveCurrentSessionId(ctx.sessionManager);
         state.subagentSpawns = { sessionId: state.currentSessionId, count: 0 };
-        // Set PI_SUBAGENT_PARENT_SESSION for permission-system forwarding.
-        // Only set in the root session (the interactive UI session), not in
-        // child subagent processes — children inherit the parent's value
-        // through the process environment at spawn time and must not overwrite
-        // it with their own session identity.
-        if (!process.env[SUBAGENT_CHILD_ENV]) {
-            const sessionId = ctx.sessionManager.getSessionId();
-            if (sessionId) {
-                process.env[SUBAGENT_PARENT_SESSION_ENV] = sessionId;
-            }
-        }
+        // Child spawn paths pass the owning session explicitly. Shared process
+        // environment cannot represent several simultaneous gateway parents.
         state.lastUiContext = ctx;
         cleanupSessionArtifacts(ctx);
         clearPendingForegroundControlNotices(state);
+        visibleControlNotices.clear();
+        for (const entry of ctx.sessionManager.getEntries()) {
+            if ((entry.type !== "custom_message" && entry.type !== "custom") || entry.customType !== SUBAGENT_CONTROL_MESSAGE_TYPE)
+                continue;
+            const data = entry.type === "custom_message" ? entry.details : entry.data;
+            if (!data || typeof data !== "object" || !("event" in data))
+                continue;
+            const details = data;
+            if (typeof details.event?.runId !== "string" || typeof details.event.type !== "string")
+                continue;
+            visibleControlNotices.add(controlNotificationKey(details.event, details.childIntercomTarget));
+        }
         resetJobs(ctx);
         restoreActiveJobs(ctx);
         const sessionId = state.currentSessionId;
         const sessionGeneration = generation;
-        if (sessionId)
-            unregisterCancellation = registerSubagentCancellation(sessionId, createSubagentCancellation({
+        if (sessionId) {
+            const cancellation = createSubagentCancellation({
                 pendingLaunches: pendingAsyncLaunches,
                 isCurrent: () => generation === sessionGeneration && state.currentSessionId === sessionId,
                 getActiveRunIds: () => [...state.asyncJobs.values()]
@@ -643,9 +599,19 @@ export default function registerSubagentExtension(pi) {
                     const result = await executor.execute(randomUUID(), { action: "stop", id }, new AbortController().signal, undefined, ctx);
                     return !result.isError;
                 },
-            }));
+            });
+            // Results use the session file identity; gateway controls use its UUID.
+            const identities = new Set([sessionId, ctx.sessionManager.getSessionId()]);
+            const unregisters = [...identities].filter((id) => Boolean(id))
+                .map((id) => registerSubagentCancellation(id, cancellation));
+            unregisterCancellation = () => {
+                for (const unregister of unregisters)
+                    unregister();
+            };
+        }
         scheduledRunManager.bindSession(ctx);
         restoreSlashFinalSnapshots(ctx.sessionManager.getEntries());
+        startResultWatcher();
         primeExistingResults();
     };
     pi.on("session_start", (_event, ctx) => {
@@ -661,7 +627,8 @@ export default function registerSubagentExtension(pi) {
         pendingLaunches.clear();
         pendingAsyncLaunches.clear();
         unregisterCancellation?.();
-        delete process.env[SUBAGENT_PARENT_SESSION_ENV];
+        disposeNotify();
+        mainWatchdog.dispose();
         for (const unsubscribe of eventUnsubscribes) {
             try {
                 unsubscribe();
@@ -670,9 +637,6 @@ export default function registerSubagentExtension(pi) {
                 // Best effort cleanup during shutdown.
             }
         }
-        if (globalStore[eventUnsubscribeStoreKey] === eventUnsubscribes) {
-            delete globalStore[eventUnsubscribeStoreKey];
-        }
         stopResultWatcher();
         scheduledRunManager.stop();
         if (state.poller)
@@ -690,10 +654,8 @@ export default function registerSubagentExtension(pi) {
         promptTemplateBridge.cancelAll();
         promptTemplateBridge.dispose();
         supervisorChannel.dispose();
-        if (globalStore[runtimeCleanupStoreKey] === runtimeCleanup) {
-            delete globalStore[runtimeCleanupStoreKey];
-        }
-        disposeSubagentWidget();
+        if (state.lastUiContext)
+            disposeSubagentWidget(state.lastUiContext);
         try {
             if (state.lastUiContext?.hasUI) {
                 state.lastUiContext.ui.setWidget(WIDGET_KEY, undefined);