@ashx-j/lunr 0.1.0

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

@@ -0,0 +1,125 @@
+// @ts-nocheck
+/**
+ * Friendly chain parameter validation.
+ *
+ * The runtime (pi-ai) validates tool arguments against the TypeBox schema before
+ * the tool's `execute` runs. When a chain step has an extra property, the model
+ * receives a raw TypeBox message such as `chain.1: must not have additional
+ * properties` — which does not name the offending property, list the allowed
+ * ones, or show the expected shape. Agents then iteratively guess the format and
+ * waste several turns before getting it right.
+ *
+ * `validateChainInput` runs from the tool's `prepareArguments` shim (and the RPC
+ * bridge) *before* schema validation. It throws a rich, actionable error for the
+ * common chain-shape failures, so the model sees which property is disallowed,
+ * what is allowed, and a valid example — instead of a raw TypeBox diagnostic.
+ *
+ * Allowed property names and additional-property strictness are derived directly
+ * from the schema objects in `schemas.ts` so this stays aligned with TypeBox.
+ */
+import { ChainItem, ParallelTaskSchema, DynamicParallelTemplateSchema, DynamicExpandSchema, DynamicCollectSchema, } from "./schemas.js";
+function allowedKeysOf(schema) {
+    return schema?.properties ? Object.keys(schema.properties) : [];
+}
+const ExpandFromSchema = (DynamicExpandSchema.properties?.from ?? {});
+export const CHAIN_STEP_KEYS = allowedKeysOf(ChainItem);
+export const PARALLEL_TASK_KEYS = allowedKeysOf(ParallelTaskSchema);
+export const DYNAMIC_TEMPLATE_KEYS = allowedKeysOf(DynamicParallelTemplateSchema);
+export const EXPAND_KEYS = allowedKeysOf(DynamicExpandSchema);
+export const EXPAND_FROM_KEYS = allowedKeysOf(ExpandFromSchema);
+export const COLLECT_KEYS = allowedKeysOf(DynamicCollectSchema);
+const CHAIN_STEP_EXAMPLE = '{"agent": "worker", "task": "do X"}';
+const PARALLEL_TASK_EXAMPLE = '{"agent": "worker", "task": "do X"}';
+const DYNAMIC_TEMPLATE_EXAMPLE = '{"agent": "worker", "task": "Review {item.path}"}';
+const EXPAND_EXAMPLE = '{"from": {"output": "targets", "path": "/items"}, "maxItems": 4}';
+const EXPAND_FROM_EXAMPLE = '{"output": "targets", "path": "/items"}';
+const COLLECT_EXAMPLE = '{"as": "reviews"}';
+function isPlainObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function disallowedKeys(value, allowed) {
+    return Object.keys(value).filter((key) => !allowed.includes(key));
+}
+function typeName(value) {
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+function quoteList(keys) {
+    return keys.map((key) => `"${key}"`).join(", ");
+}
+function disallowedMessage(path, keys, allowed, example) {
+    const subject = keys.length === 1
+        ? `property "${keys[0]}" is not allowed`
+        : `properties ${quoteList(keys)} are not allowed`;
+    const examplePart = example ? `\n\nExample: ${example}` : "";
+    return `subagent ${path}: ${subject}.\nAllowed properties: ${allowed.join(", ")}.${examplePart}`;
+}
+function expectObject(value, path, allowed, example) {
+    if (!isPlainObject(value)) {
+        const examplePart = example ? `\n\nExample: ${example}` : "";
+        throw new Error(`subagent ${path}: expected an object, received ${typeName(value)}.\nAllowed properties: ${allowed.join(", ")}.${examplePart}`);
+    }
+}
+function checkNoExtraKeys(value, path, schema, allowed, example) {
+    if (schema.additionalProperties !== false)
+        return;
+    const extra = disallowedKeys(value, allowed);
+    if (extra.length > 0) {
+        throw new Error(disallowedMessage(path, extra, allowed, example));
+    }
+}
+/**
+ * Validates the `chain` array on a raw subagent tool-call argument object and
+ * throws a friendly, actionable error when a chain step (or a nested
+ * `parallel`/`expand`/`collect` object) has a disallowed property or wrong shape.
+ *
+ * No-op when `chain` is absent or not an array, so management/control/single/
+ * parallel calls are unaffected.
+ */
+export function validateChainInput(args) {
+    if (!isPlainObject(args))
+        return;
+    const chain = args.chain;
+    if (!Array.isArray(chain))
+        return;
+    chain.forEach((step, index) => {
+        const stepPath = `chain step validation failed at chain[${index}]`;
+        expectObject(step, stepPath, CHAIN_STEP_KEYS, CHAIN_STEP_EXAMPLE);
+        checkNoExtraKeys(step, stepPath, ChainItem, CHAIN_STEP_KEYS, CHAIN_STEP_EXAMPLE);
+        if (step.expand !== undefined) {
+            const expandPath = `${stepPath}.expand`;
+            expectObject(step.expand, expandPath, EXPAND_KEYS, EXPAND_EXAMPLE);
+            checkNoExtraKeys(step.expand, expandPath, DynamicExpandSchema, EXPAND_KEYS, EXPAND_EXAMPLE);
+            const from = step.expand.from;
+            if (from !== undefined) {
+                const fromPath = `${expandPath}.from`;
+                expectObject(from, fromPath, EXPAND_FROM_KEYS, EXPAND_FROM_EXAMPLE);
+                checkNoExtraKeys(from, fromPath, ExpandFromSchema, EXPAND_FROM_KEYS, EXPAND_FROM_EXAMPLE);
+            }
+        }
+        if (step.collect !== undefined) {
+            const collectPath = `${stepPath}.collect`;
+            expectObject(step.collect, collectPath, COLLECT_KEYS, COLLECT_EXAMPLE);
+            checkNoExtraKeys(step.collect, collectPath, DynamicCollectSchema, COLLECT_KEYS, COLLECT_EXAMPLE);
+        }
+        const parallel = step.parallel;
+        if (parallel === undefined)
+            return;
+        if (Array.isArray(parallel)) {
+            parallel.forEach((task, pIndex) => {
+                const taskPath = `${stepPath}.parallel[${pIndex}]`;
+                expectObject(task, taskPath, PARALLEL_TASK_KEYS, PARALLEL_TASK_EXAMPLE);
+                checkNoExtraKeys(task, taskPath, ParallelTaskSchema, PARALLEL_TASK_KEYS, PARALLEL_TASK_EXAMPLE);
+            });
+            return;
+        }
+        if (isPlainObject(parallel)) {
+            const templatePath = `${stepPath}.parallel (dynamic fanout template)`;
+            checkNoExtraKeys(parallel, templatePath, DynamicParallelTemplateSchema, DYNAMIC_TEMPLATE_KEYS, DYNAMIC_TEMPLATE_EXAMPLE);
+            return;
+        }
+        throw new Error(`subagent ${stepPath}.parallel: expected an array of task objects or a dynamic fanout template object, received ${typeName(parallel)}.\n\nExample static: [${PARALLEL_TASK_EXAMPLE}]\nExample dynamic: ${DYNAMIC_TEMPLATE_EXAMPLE}`);
+    });
+}
+//# sourceMappingURL=chain-validation.js.map

package/dist/builtin-extensions/pi-subagents/src/extension/chain-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-validation.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/extension/chain-validation.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * Friendly chain parameter validation.\n *\n * The runtime (pi-ai) validates tool arguments against the TypeBox schema before\n * the tool's `execute` runs. When a chain step has an extra property, the model\n * receives a raw TypeBox message such as `chain.1: must not have additional\n * properties` — which does not name the offending property, list the allowed\n * ones, or show the expected shape. Agents then iteratively guess the format and\n * waste several turns before getting it right.\n *\n * `validateChainInput` runs from the tool's `prepareArguments` shim (and the RPC\n * bridge) *before* schema validation. It throws a rich, actionable error for the\n * common chain-shape failures, so the model sees which property is disallowed,\n * what is allowed, and a valid example — instead of a raw TypeBox diagnostic.\n *\n * Allowed property names and additional-property strictness are derived directly\n * from the schema objects in `schemas.ts` so this stays aligned with TypeBox.\n */\n\nimport {\n\tChainItem,\n\tParallelTaskSchema,\n\tDynamicParallelTemplateSchema,\n\tDynamicExpandSchema,\n\tDynamicCollectSchema,\n} from \"./schemas.ts\";\n\ntype ObjectSchema = {\n\tproperties?: Record<string, unknown>;\n\tadditionalProperties?: unknown;\n};\n\nfunction allowedKeysOf(schema: ObjectSchema | undefined): string[] {\n\treturn schema?.properties ? Object.keys(schema.properties) : [];\n}\n\nconst ExpandFromSchema = (DynamicExpandSchema.properties?.from ?? {}) as ObjectSchema;\n\nexport const CHAIN_STEP_KEYS = allowedKeysOf(ChainItem);\nexport const PARALLEL_TASK_KEYS = allowedKeysOf(ParallelTaskSchema);\nexport const DYNAMIC_TEMPLATE_KEYS = allowedKeysOf(DynamicParallelTemplateSchema);\nexport const EXPAND_KEYS = allowedKeysOf(DynamicExpandSchema);\nexport const EXPAND_FROM_KEYS = allowedKeysOf(ExpandFromSchema);\nexport const COLLECT_KEYS = allowedKeysOf(DynamicCollectSchema);\n\nconst CHAIN_STEP_EXAMPLE = '{\"agent\": \"worker\", \"task\": \"do X\"}';\nconst PARALLEL_TASK_EXAMPLE = '{\"agent\": \"worker\", \"task\": \"do X\"}';\nconst DYNAMIC_TEMPLATE_EXAMPLE = '{\"agent\": \"worker\", \"task\": \"Review {item.path}\"}';\nconst EXPAND_EXAMPLE = '{\"from\": {\"output\": \"targets\", \"path\": \"/items\"}, \"maxItems\": 4}';\nconst EXPAND_FROM_EXAMPLE = '{\"output\": \"targets\", \"path\": \"/items\"}';\nconst COLLECT_EXAMPLE = '{\"as\": \"reviews\"}';\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n\treturn Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction disallowedKeys(value: Record<string, unknown>, allowed: readonly string[]): string[] {\n\treturn Object.keys(value).filter((key) => !allowed.includes(key));\n}\n\nfunction typeName(value: unknown): string {\n\tif (Array.isArray(value)) return \"array\";\n\treturn typeof value;\n}\n\nfunction quoteList(keys: string[]): string {\n\treturn keys.map((key) => `\"${key}\"`).join(\", \");\n}\n\nfunction disallowedMessage(\n\tpath: string,\n\tkeys: string[],\n\tallowed: readonly string[],\n\texample?: string,\n): string {\n\tconst subject = keys.length === 1\n\t\t? `property \"${keys[0]}\" is not allowed`\n\t\t: `properties ${quoteList(keys)} are not allowed`;\n\tconst examplePart = example ? `\\n\\nExample: ${example}` : \"\";\n\treturn `subagent ${path}: ${subject}.\\nAllowed properties: ${allowed.join(\", \")}.${examplePart}`;\n}\n\nfunction expectObject(value: unknown, path: string, allowed: readonly string[], example?: string): asserts value is Record<string, unknown> {\n\tif (!isPlainObject(value)) {\n\t\tconst examplePart = example ? `\\n\\nExample: ${example}` : \"\";\n\t\tthrow new Error(\n\t\t\t`subagent ${path}: expected an object, received ${typeName(value)}.\\nAllowed properties: ${allowed.join(\", \")}.${examplePart}`,\n\t\t);\n\t}\n}\n\nfunction checkNoExtraKeys(\n\tvalue: Record<string, unknown>,\n\tpath: string,\n\tschema: ObjectSchema,\n\tallowed: readonly string[],\n\texample?: string,\n): void {\n\tif (schema.additionalProperties !== false) return;\n\tconst extra = disallowedKeys(value, allowed);\n\tif (extra.length > 0) {\n\t\tthrow new Error(disallowedMessage(path, extra, allowed, example));\n\t}\n}\n\n/**\n * Validates the `chain` array on a raw subagent tool-call argument object and\n * throws a friendly, actionable error when a chain step (or a nested\n * `parallel`/`expand`/`collect` object) has a disallowed property or wrong shape.\n *\n * No-op when `chain` is absent or not an array, so management/control/single/\n * parallel calls are unaffected.\n */\nexport function validateChainInput(args: unknown): void {\n\tif (!isPlainObject(args)) return;\n\tconst chain = (args as Record<string, unknown>).chain;\n\tif (!Array.isArray(chain)) return;\n\n\tchain.forEach((step, index) => {\n\t\tconst stepPath = `chain step validation failed at chain[${index}]`;\n\t\texpectObject(step, stepPath, CHAIN_STEP_KEYS, CHAIN_STEP_EXAMPLE);\n\t\tcheckNoExtraKeys(step, stepPath, ChainItem, CHAIN_STEP_KEYS, CHAIN_STEP_EXAMPLE);\n\n\t\tif (step.expand !== undefined) {\n\t\t\tconst expandPath = `${stepPath}.expand`;\n\t\t\texpectObject(step.expand, expandPath, EXPAND_KEYS, EXPAND_EXAMPLE);\n\t\t\tcheckNoExtraKeys(step.expand, expandPath, DynamicExpandSchema, EXPAND_KEYS, EXPAND_EXAMPLE);\n\n\t\t\tconst from = (step.expand as Record<string, unknown>).from;\n\t\t\tif (from !== undefined) {\n\t\t\t\tconst fromPath = `${expandPath}.from`;\n\t\t\t\texpectObject(from, fromPath, EXPAND_FROM_KEYS, EXPAND_FROM_EXAMPLE);\n\t\t\t\tcheckNoExtraKeys(from, fromPath, ExpandFromSchema, EXPAND_FROM_KEYS, EXPAND_FROM_EXAMPLE);\n\t\t\t}\n\t\t}\n\n\t\tif (step.collect !== undefined) {\n\t\t\tconst collectPath = `${stepPath}.collect`;\n\t\t\texpectObject(step.collect, collectPath, COLLECT_KEYS, COLLECT_EXAMPLE);\n\t\t\tcheckNoExtraKeys(step.collect, collectPath, DynamicCollectSchema, COLLECT_KEYS, COLLECT_EXAMPLE);\n\t\t}\n\n\t\tconst parallel = step.parallel;\n\t\tif (parallel === undefined) return;\n\n\t\tif (Array.isArray(parallel)) {\n\t\t\tparallel.forEach((task, pIndex) => {\n\t\t\t\tconst taskPath = `${stepPath}.parallel[${pIndex}]`;\n\t\t\t\texpectObject(task, taskPath, PARALLEL_TASK_KEYS, PARALLEL_TASK_EXAMPLE);\n\t\t\t\tcheckNoExtraKeys(task, taskPath, ParallelTaskSchema, PARALLEL_TASK_KEYS, PARALLEL_TASK_EXAMPLE);\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\tif (isPlainObject(parallel)) {\n\t\t\tconst templatePath = `${stepPath}.parallel (dynamic fanout template)`;\n\t\t\tcheckNoExtraKeys(parallel, templatePath, DynamicParallelTemplateSchema, DYNAMIC_TEMPLATE_KEYS, DYNAMIC_TEMPLATE_EXAMPLE);\n\t\t\treturn;\n\t\t}\n\n\t\tthrow new Error(\n\t\t\t`subagent ${stepPath}.parallel: expected an array of task objects or a dynamic fanout template object, received ${typeName(parallel)}.\\n\\nExample static: [${PARALLEL_TASK_EXAMPLE}]\\nExample dynamic: ${DYNAMIC_TEMPLATE_EXAMPLE}`,\n\t\t);\n\t});\n}"]}

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

@@ -0,0 +1,6 @@
+import type { ExtensionConfig } from "../shared/types.ts";
+export declare function getConfigPath(): string;
+export declare function saveConfig(config: ExtensionConfig, configPath?: string): void;
+export declare function updateConfig(updater: (config: ExtensionConfig) => ExtensionConfig): ExtensionConfig;
+export declare function loadConfig(): ExtensionConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/extension/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAWD,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,SAAkB,GAAG,IAAI,CAGtF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,eAAe,GAAG,eAAe,CAKnG;AAED,wBAAgB,UAAU,IAAI,eAAe,CAQ5C","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { ExtensionConfig } from \"../shared/types.ts\";\nimport { getAgentDir } from \"../shared/utils.ts\";\n\nexport function getConfigPath(): string {\n\treturn path.join(getAgentDir(), \"extensions\", \"subagent\", \"config.json\");\n}\n\nfunction readConfigForUpdate(configPath = getConfigPath()): ExtensionConfig {\n\tif (!fs.existsSync(configPath)) return {};\n\tconst parsed = JSON.parse(fs.readFileSync(configPath, \"utf-8\")) as unknown;\n\tif (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n\t\tthrow new Error(`Subagent config at '${configPath}' must be a JSON object`);\n\t}\n\treturn parsed as ExtensionConfig;\n}\n\nexport function saveConfig(config: ExtensionConfig, configPath = getConfigPath()): void {\n\tfs.mkdirSync(path.dirname(configPath), { recursive: true });\n\tfs.writeFileSync(configPath, `${JSON.stringify(config, null, \"\\t\")}\\n`, \"utf-8\");\n}\n\nexport function updateConfig(updater: (config: ExtensionConfig) => ExtensionConfig): ExtensionConfig {\n\tconst configPath = getConfigPath();\n\tconst next = updater(readConfigForUpdate(configPath));\n\tsaveConfig(next, configPath);\n\treturn next;\n}\n\nexport function loadConfig(): ExtensionConfig {\n\tconst configPath = getConfigPath();\n\ttry {\n\t\treturn readConfigForUpdate(configPath);\n\t} catch (error) {\n\t\tconsole.error(`Failed to load subagent config from '${configPath}':`, error);\n\t}\n\treturn {};\n}\n"]}

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

@@ -0,0 +1,37 @@
+// @ts-nocheck
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getAgentDir } from "../shared/utils.js";
+export function getConfigPath() {
+    return path.join(getAgentDir(), "extensions", "subagent", "config.json");
+}
+function readConfigForUpdate(configPath = getConfigPath()) {
+    if (!fs.existsSync(configPath))
+        return {};
+    const parsed = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`Subagent config at '${configPath}' must be a JSON object`);
+    }
+    return parsed;
+}
+export function saveConfig(config, configPath = getConfigPath()) {
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    fs.writeFileSync(configPath, `${JSON.stringify(config, null, "\t")}\n`, "utf-8");
+}
+export function updateConfig(updater) {
+    const configPath = getConfigPath();
+    const next = updater(readConfigForUpdate(configPath));
+    saveConfig(next, configPath);
+    return next;
+}
+export function loadConfig() {
+    const configPath = getConfigPath();
+    try {
+        return readConfigForUpdate(configPath);
+    }
+    catch (error) {
+        console.error(`Failed to load subagent config from '${configPath}':`, error);
+    }
+    return {};
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/extension/config.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,UAAU,aAAa,GAAW;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;AAAA,CACzE;AAED,SAAS,mBAAmB,CAAC,UAAU,GAAG,aAAa,EAAE,EAAmB;IAC3E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAY,CAAC;IAC3E,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,yBAAyB,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,MAAyB,CAAC;AAAA,CACjC;AAED,MAAM,UAAU,UAAU,CAAC,MAAuB,EAAE,UAAU,GAAG,aAAa,EAAE,EAAQ;IACvF,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAAA,CACjF;AAED,MAAM,UAAU,YAAY,CAAC,OAAqD,EAAmB;IACpG,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC;IACtD,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC;AAAA,CACZ;AAED,MAAM,UAAU,UAAU,GAAoB;IAC7C,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,IAAI,CAAC;QACJ,OAAO,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,wCAAwC,UAAU,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,CAAC;AAAA,CACV","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { ExtensionConfig } from \"../shared/types.ts\";\nimport { getAgentDir } from \"../shared/utils.ts\";\n\nexport function getConfigPath(): string {\n\treturn path.join(getAgentDir(), \"extensions\", \"subagent\", \"config.json\");\n}\n\nfunction readConfigForUpdate(configPath = getConfigPath()): ExtensionConfig {\n\tif (!fs.existsSync(configPath)) return {};\n\tconst parsed = JSON.parse(fs.readFileSync(configPath, \"utf-8\")) as unknown;\n\tif (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n\t\tthrow new Error(`Subagent config at '${configPath}' must be a JSON object`);\n\t}\n\treturn parsed as ExtensionConfig;\n}\n\nexport function saveConfig(config: ExtensionConfig, configPath = getConfigPath()): void {\n\tfs.mkdirSync(path.dirname(configPath), { recursive: true });\n\tfs.writeFileSync(configPath, `${JSON.stringify(config, null, \"\\t\")}\\n`, \"utf-8\");\n}\n\nexport function updateConfig(updater: (config: ExtensionConfig) => ExtensionConfig): ExtensionConfig {\n\tconst configPath = getConfigPath();\n\tconst next = updater(readConfigForUpdate(configPath));\n\tsaveConfig(next, configPath);\n\treturn next;\n}\n\nexport function loadConfig(): ExtensionConfig {\n\tconst configPath = getConfigPath();\n\ttry {\n\t\treturn readConfigForUpdate(configPath);\n\t} catch (error) {\n\t\tconsole.error(`Failed to load subagent config from '${configPath}':`, error);\n\t}\n\treturn {};\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/extension/control-notices.d.ts

@@ -0,0 +1,21 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { ControlEvent, SubagentState } from "../shared/types.ts";
+export declare const SUBAGENT_CONTROL_MESSAGE_TYPE = "subagent_control_notice";
+export interface SubagentControlMessageDetails {
+    event: ControlEvent;
+    source?: "foreground" | "async";
+    asyncDir?: string;
+    childIntercomTarget?: string;
+    noticeText?: string;
+}
+export declare function controlNoticeTarget(details: SubagentControlMessageDetails): string | undefined;
+export declare function formatSubagentControlNotice(details: SubagentControlMessageDetails, content?: string): string;
+export declare function clearPendingForegroundControlNotices(state: SubagentState, runId?: string): void;
+export declare function handleSubagentControlNotice(input: {
+    pi: Pick<ExtensionAPI, "sendMessage">;
+    state: SubagentState;
+    visibleControlNotices: Set<string>;
+    details: SubagentControlMessageDetails;
+    foregroundDelayMs?: number;
+}): void;
+//# sourceMappingURL=control-notices.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control-notices.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/extension/control-notices.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEtE,eAAO,MAAM,6BAA6B,4BAA4B,CAAC;AAEvE,MAAM,WAAW,6BAA6B;IAC7C,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,6BAA6B,GAAG,MAAM,GAAG,SAAS,CAE9F;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,6BAA6B,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5G;AAOD,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ/F;AA+BD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IAClD,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IACtC,KAAK,EAAE,aAAa,CAAC;IACrB,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,EAAE,6BAA6B,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,IAAI,CAmBP","sourcesContent":["// @ts-nocheck\nimport type { ExtensionAPI } from \"@earendil-works/pi-coding-agent\";\nimport { controlNotificationKey, formatControlNoticeMessage } from \"../runs/shared/subagent-control.ts\";\nimport type { ControlEvent, SubagentState } from \"../shared/types.ts\";\n\nexport const SUBAGENT_CONTROL_MESSAGE_TYPE = \"subagent_control_notice\";\n\nexport interface SubagentControlMessageDetails {\n\tevent: ControlEvent;\n\tsource?: \"foreground\" | \"async\";\n\tasyncDir?: string;\n\tchildIntercomTarget?: string;\n\tnoticeText?: string;\n}\n\nexport function controlNoticeTarget(details: SubagentControlMessageDetails): string | undefined {\n\treturn details.childIntercomTarget;\n}\n\nexport function formatSubagentControlNotice(details: SubagentControlMessageDetails, content?: string): string {\n\treturn details.noticeText ?? content ?? formatControlNoticeMessage(details.event, controlNoticeTarget(details));\n}\n\nfunction noticeTimerKey(details: SubagentControlMessageDetails): string {\n\tconst childIntercomTarget = controlNoticeTarget(details);\n\treturn `${details.event.runId}:${controlNotificationKey(details.event, childIntercomTarget)}`;\n}\n\nexport function clearPendingForegroundControlNotices(state: SubagentState, runId?: string): void {\n\tconst pending = state.pendingForegroundControlNotices;\n\tif (!pending) return;\n\tfor (const [key, timer] of pending) {\n\t\tif (runId !== undefined && !key.startsWith(`${runId}:`)) continue;\n\t\tclearTimeout(timer);\n\t\tpending.delete(key);\n\t}\n}\n\nfunction deliverControlNotice(input: {\n\tpi: Pick<ExtensionAPI, \"sendMessage\">;\n\tvisibleControlNotices: Set<string>;\n\tdetails: SubagentControlMessageDetails;\n}): void {\n\tconst childIntercomTarget = controlNoticeTarget(input.details);\n\tconst key = controlNotificationKey(input.details.event, childIntercomTarget);\n\tif (input.visibleControlNotices.has(key)) return;\n\tinput.visibleControlNotices.add(key);\n\tconst noticeText = input.details.noticeText ?? formatControlNoticeMessage(input.details.event, childIntercomTarget);\n\tinput.pi.sendMessage(\n\t\t{\n\t\t\tcustomType: SUBAGENT_CONTROL_MESSAGE_TYPE,\n\t\t\tcontent: noticeText,\n\t\t\tdisplay: true,\n\t\t\tdetails: { ...input.details, childIntercomTarget, noticeText },\n\t\t},\n\t\t{ triggerTurn: input.details.source !== \"foreground\" },\n\t);\n}\n\nfunction isForegroundNoticeStillActionable(state: SubagentState, details: SubagentControlMessageDetails): boolean {\n\tconst control = state.foregroundControls.get(details.event.runId);\n\tif (!control) return false;\n\tif (control.currentAgent && control.currentAgent !== details.event.agent) return false;\n\tif (details.event.index !== undefined && control.currentIndex !== details.event.index) return false;\n\treturn control.currentActivityState === \"needs_attention\";\n}\n\nexport function handleSubagentControlNotice(input: {\n\tpi: Pick<ExtensionAPI, \"sendMessage\">;\n\tstate: SubagentState;\n\tvisibleControlNotices: Set<string>;\n\tdetails: SubagentControlMessageDetails;\n\tforegroundDelayMs?: number;\n}): void {\n\tif (!input.details?.event || input.details.event.type === \"active_long_running\") return;\n\tif (input.details.source !== \"foreground\") {\n\t\tdeliverControlNotice(input);\n\t\treturn;\n\t}\n\n\tconst pending = input.state.pendingForegroundControlNotices ?? new Map<string, ReturnType<typeof setTimeout>>();\n\tinput.state.pendingForegroundControlNotices = pending;\n\tconst timerKey = noticeTimerKey(input.details);\n\tconst existing = pending.get(timerKey);\n\tif (existing) clearTimeout(existing);\n\tconst timer = setTimeout(() => {\n\t\tpending.delete(timerKey);\n\t\tif (!isForegroundNoticeStillActionable(input.state, input.details)) return;\n\t\tdeliverControlNotice(input);\n\t}, input.foregroundDelayMs ?? 1000);\n\ttimer.unref?.();\n\tpending.set(timerKey, timer);\n}\n"]}

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

@@ -0,0 +1,70 @@
+import { controlNotificationKey, formatControlNoticeMessage } from "../runs/shared/subagent-control.js";
+export const SUBAGENT_CONTROL_MESSAGE_TYPE = "subagent_control_notice";
+export function controlNoticeTarget(details) {
+    return details.childIntercomTarget;
+}
+export function formatSubagentControlNotice(details, content) {
+    return details.noticeText ?? content ?? formatControlNoticeMessage(details.event, controlNoticeTarget(details));
+}
+function noticeTimerKey(details) {
+    const childIntercomTarget = controlNoticeTarget(details);
+    return `${details.event.runId}:${controlNotificationKey(details.event, childIntercomTarget)}`;
+}
+export function clearPendingForegroundControlNotices(state, runId) {
+    const pending = state.pendingForegroundControlNotices;
+    if (!pending)
+        return;
+    for (const [key, timer] of pending) {
+        if (runId !== undefined && !key.startsWith(`${runId}:`))
+            continue;
+        clearTimeout(timer);
+        pending.delete(key);
+    }
+}
+function deliverControlNotice(input) {
+    const childIntercomTarget = controlNoticeTarget(input.details);
+    const key = controlNotificationKey(input.details.event, childIntercomTarget);
+    if (input.visibleControlNotices.has(key))
+        return;
+    input.visibleControlNotices.add(key);
+    const noticeText = input.details.noticeText ?? formatControlNoticeMessage(input.details.event, childIntercomTarget);
+    input.pi.sendMessage({
+        customType: SUBAGENT_CONTROL_MESSAGE_TYPE,
+        content: noticeText,
+        display: true,
+        details: { ...input.details, childIntercomTarget, noticeText },
+    }, { triggerTurn: input.details.source !== "foreground" });
+}
+function isForegroundNoticeStillActionable(state, details) {
+    const control = state.foregroundControls.get(details.event.runId);
+    if (!control)
+        return false;
+    if (control.currentAgent && control.currentAgent !== details.event.agent)
+        return false;
+    if (details.event.index !== undefined && control.currentIndex !== details.event.index)
+        return false;
+    return control.currentActivityState === "needs_attention";
+}
+export function handleSubagentControlNotice(input) {
+    if (!input.details?.event || input.details.event.type === "active_long_running")
+        return;
+    if (input.details.source !== "foreground") {
+        deliverControlNotice(input);
+        return;
+    }
+    const pending = input.state.pendingForegroundControlNotices ?? new Map();
+    input.state.pendingForegroundControlNotices = pending;
+    const timerKey = noticeTimerKey(input.details);
+    const existing = pending.get(timerKey);
+    if (existing)
+        clearTimeout(existing);
+    const timer = setTimeout(() => {
+        pending.delete(timerKey);
+        if (!isForegroundNoticeStillActionable(input.state, input.details))
+            return;
+        deliverControlNotice(input);
+    }, input.foregroundDelayMs ?? 1000);
+    timer.unref?.();
+    pending.set(timerKey, timer);
+}
+//# sourceMappingURL=control-notices.js.map

package/dist/builtin-extensions/pi-subagents/src/extension/control-notices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-notices.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/extension/control-notices.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport type { ExtensionAPI } from \"@earendil-works/pi-coding-agent\";\nimport { controlNotificationKey, formatControlNoticeMessage } from \"../runs/shared/subagent-control.ts\";\nimport type { ControlEvent, SubagentState } from \"../shared/types.ts\";\n\nexport const SUBAGENT_CONTROL_MESSAGE_TYPE = \"subagent_control_notice\";\n\nexport interface SubagentControlMessageDetails {\n\tevent: ControlEvent;\n\tsource?: \"foreground\" | \"async\";\n\tasyncDir?: string;\n\tchildIntercomTarget?: string;\n\tnoticeText?: string;\n}\n\nexport function controlNoticeTarget(details: SubagentControlMessageDetails): string | undefined {\n\treturn details.childIntercomTarget;\n}\n\nexport function formatSubagentControlNotice(details: SubagentControlMessageDetails, content?: string): string {\n\treturn details.noticeText ?? content ?? formatControlNoticeMessage(details.event, controlNoticeTarget(details));\n}\n\nfunction noticeTimerKey(details: SubagentControlMessageDetails): string {\n\tconst childIntercomTarget = controlNoticeTarget(details);\n\treturn `${details.event.runId}:${controlNotificationKey(details.event, childIntercomTarget)}`;\n}\n\nexport function clearPendingForegroundControlNotices(state: SubagentState, runId?: string): void {\n\tconst pending = state.pendingForegroundControlNotices;\n\tif (!pending) return;\n\tfor (const [key, timer] of pending) {\n\t\tif (runId !== undefined && !key.startsWith(`${runId}:`)) continue;\n\t\tclearTimeout(timer);\n\t\tpending.delete(key);\n\t}\n}\n\nfunction deliverControlNotice(input: {\n\tpi: Pick<ExtensionAPI, \"sendMessage\">;\n\tvisibleControlNotices: Set<string>;\n\tdetails: SubagentControlMessageDetails;\n}): void {\n\tconst childIntercomTarget = controlNoticeTarget(input.details);\n\tconst key = controlNotificationKey(input.details.event, childIntercomTarget);\n\tif (input.visibleControlNotices.has(key)) return;\n\tinput.visibleControlNotices.add(key);\n\tconst noticeText = input.details.noticeText ?? formatControlNoticeMessage(input.details.event, childIntercomTarget);\n\tinput.pi.sendMessage(\n\t\t{\n\t\t\tcustomType: SUBAGENT_CONTROL_MESSAGE_TYPE,\n\t\t\tcontent: noticeText,\n\t\t\tdisplay: true,\n\t\t\tdetails: { ...input.details, childIntercomTarget, noticeText },\n\t\t},\n\t\t{ triggerTurn: input.details.source !== \"foreground\" },\n\t);\n}\n\nfunction isForegroundNoticeStillActionable(state: SubagentState, details: SubagentControlMessageDetails): boolean {\n\tconst control = state.foregroundControls.get(details.event.runId);\n\tif (!control) return false;\n\tif (control.currentAgent && control.currentAgent !== details.event.agent) return false;\n\tif (details.event.index !== undefined && control.currentIndex !== details.event.index) return false;\n\treturn control.currentActivityState === \"needs_attention\";\n}\n\nexport function handleSubagentControlNotice(input: {\n\tpi: Pick<ExtensionAPI, \"sendMessage\">;\n\tstate: SubagentState;\n\tvisibleControlNotices: Set<string>;\n\tdetails: SubagentControlMessageDetails;\n\tforegroundDelayMs?: number;\n}): void {\n\tif (!input.details?.event || input.details.event.type === \"active_long_running\") return;\n\tif (input.details.source !== \"foreground\") {\n\t\tdeliverControlNotice(input);\n\t\treturn;\n\t}\n\n\tconst pending = input.state.pendingForegroundControlNotices ?? new Map<string, ReturnType<typeof setTimeout>>();\n\tinput.state.pendingForegroundControlNotices = pending;\n\tconst timerKey = noticeTimerKey(input.details);\n\tconst existing = pending.get(timerKey);\n\tif (existing) clearTimeout(existing);\n\tconst timer = setTimeout(() => {\n\t\tpending.delete(timerKey);\n\t\tif (!isForegroundNoticeStillActionable(input.state, input.details)) return;\n\t\tdeliverControlNotice(input);\n\t}, input.foregroundDelayMs ?? 1000);\n\ttimer.unref?.();\n\tpending.set(timerKey, timer);\n}\n"]}

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

@@ -0,0 +1,33 @@
+import { discoverAgentsAll } from "../agents/agents.ts";
+import { diagnoseIntercomBridge } from "../intercom/intercom-bridge.ts";
+import { discoverAvailableSkills } from "../agents/skills.ts";
+import { type ExtensionConfig, type SubagentState } from "../shared/types.ts";
+interface DoctorPaths {
+    tempRootDir: string;
+    asyncDir: string;
+    resultsDir: string;
+    chainRunsDir: string;
+}
+interface DoctorDeps {
+    isAsyncAvailable: () => boolean;
+    discoverAgentsAll: typeof discoverAgentsAll;
+    discoverAvailableSkills: typeof discoverAvailableSkills;
+    diagnoseIntercomBridge: typeof diagnoseIntercomBridge;
+}
+interface DoctorReportInput {
+    cwd: string;
+    config: ExtensionConfig;
+    state: SubagentState;
+    context?: "fresh" | "fork";
+    requestedSessionDir?: string;
+    currentSessionFile?: string | null;
+    currentSessionId?: string | null;
+    orchestratorTarget?: string;
+    sessionError?: string;
+    expandTilde?: (value: string) => string;
+    paths?: DoctorPaths;
+    deps?: Partial<DoctorDeps>;
+}
+export declare function buildDoctorReport(input: DoctorReportInput): string;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/extension/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAAE,sBAAsB,EAAiC,MAAM,gCAAgC,CAAC;AACvG,OAAO,EAAE,uBAAuB,EAAoB,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAKN,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,MAAM,oBAAoB,CAAC;AAE5B,UAAU,WAAW;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,UAAU;IACnB,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,uBAAuB,EAAE,OAAO,uBAAuB,CAAC;IACxD,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CACtD;AAED,UAAU,iBAAiB;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3B;AA2ID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAgClE","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { discoverAgentsAll, type AgentSource } from \"../agents/agents.ts\";\nimport { isAsyncAvailable } from \"../runs/background/async-execution.ts\";\nimport { diagnoseIntercomBridge, type IntercomBridgeDiagnostic } from \"../intercom/intercom-bridge.ts\";\nimport { discoverAvailableSkills, type SkillSource } from \"../agents/skills.ts\";\nimport {\n\tASYNC_DIR,\n\tCHAIN_RUNS_DIR,\n\tRESULTS_DIR,\n\tTEMP_ROOT_DIR,\n\ttype ExtensionConfig,\n\ttype SubagentState,\n} from \"../shared/types.ts\";\n\ninterface DoctorPaths {\n\ttempRootDir: string;\n\tasyncDir: string;\n\tresultsDir: string;\n\tchainRunsDir: string;\n}\n\ninterface DoctorDeps {\n\tisAsyncAvailable: () => boolean;\n\tdiscoverAgentsAll: typeof discoverAgentsAll;\n\tdiscoverAvailableSkills: typeof discoverAvailableSkills;\n\tdiagnoseIntercomBridge: typeof diagnoseIntercomBridge;\n}\n\ninterface DoctorReportInput {\n\tcwd: string;\n\tconfig: ExtensionConfig;\n\tstate: SubagentState;\n\tcontext?: \"fresh\" | \"fork\";\n\trequestedSessionDir?: string;\n\tcurrentSessionFile?: string | null;\n\tcurrentSessionId?: string | null;\n\torchestratorTarget?: string;\n\tsessionError?: string;\n\texpandTilde?: (value: string) => string;\n\tpaths?: DoctorPaths;\n\tdeps?: Partial<DoctorDeps>;\n}\n\nconst DEFAULT_PATHS: DoctorPaths = {\n\ttempRootDir: TEMP_ROOT_DIR,\n\tasyncDir: ASYNC_DIR,\n\tresultsDir: RESULTS_DIR,\n\tchainRunsDir: CHAIN_RUNS_DIR,\n};\n\nconst DEFAULT_DEPS: DoctorDeps = {\n\tisAsyncAvailable,\n\tdiscoverAgentsAll,\n\tdiscoverAvailableSkills,\n\tdiagnoseIntercomBridge,\n};\n\nfunction errorText(error: unknown): string {\n\treturn error instanceof Error ? `${error.name}: ${error.message}` : String(error);\n}\n\nfunction lineFromCheck(label: string, check: () => string): string {\n\ttry {\n\t\treturn check();\n\t} catch (error) {\n\t\treturn `- ${label}: failed — ${errorText(error)}`;\n\t}\n}\n\nfunction formatExistingDirectory(label: string, dirPath: string): string {\n\ttry {\n\t\tif (!fs.existsSync(dirPath)) return `- ${label}: missing (${dirPath})`;\n\t\tconst stats = fs.statSync(dirPath);\n\t\tif (!stats.isDirectory()) throw new Error(`not a directory: ${dirPath}`);\n\t\tfs.accessSync(dirPath, fs.constants.R_OK | fs.constants.W_OK);\n\t\treturn `- ${label}: ok (${dirPath})`;\n\t} catch (error) {\n\t\treturn `- ${label}: failed (${dirPath}) — ${errorText(error)}`;\n\t}\n}\n\nfunction formatSourceCounts(counts: Record<AgentSource, number>): string {\n\treturn `builtin ${counts.builtin}, package ${counts.package}, user ${counts.user}, project ${counts.project}`;\n}\n\nfunction formatSkillSourceCounts(skills: Array<{ source: SkillSource }>): string {\n\tconst counts = new Map<SkillSource, number>();\n\tfor (const skill of skills) counts.set(skill.source, (counts.get(skill.source) ?? 0) + 1);\n\tconst ordered: SkillSource[] = [\n\t\t\"project\",\n\t\t\"project-settings\",\n\t\t\"project-package\",\n\t\t\"user\",\n\t\t\"user-settings\",\n\t\t\"user-package\",\n\t\t\"extension\",\n\t\t\"builtin\",\n\t\t\"unknown\",\n\t];\n\tconst parts = ordered\n\t\t.map((source) => `${source} ${counts.get(source) ?? 0}`)\n\t\t.filter((part) => !part.endsWith(\" 0\"));\n\treturn parts.length > 0 ? parts.join(\", \") : \"none\";\n}\n\nfunction formatConfiguredSessionDir(input: DoctorReportInput): string {\n\tif (input.requestedSessionDir) {\n\t\treturn path.resolve(input.expandTilde?.(input.requestedSessionDir) ?? input.requestedSessionDir);\n\t}\n\tif (input.config.defaultSessionDir) {\n\t\treturn path.resolve(input.expandTilde?.(input.config.defaultSessionDir) ?? input.config.defaultSessionDir);\n\t}\n\treturn \"not configured\";\n}\n\nfunction formatSessionLines(input: DoctorReportInput): string[] {\n\tconst sessionFile = input.currentSessionFile ?? null;\n\tconst lines = [\n\t\tlineFromCheck(\"configured session dir\", () => `- configured session dir: ${formatConfiguredSessionDir(input)}`),\n\t\t`- current session file: ${sessionFile ?? \"not available\"}`,\n\t\t`- current session dir: ${sessionFile ? path.dirname(sessionFile) : \"not available\"}`,\n\t\t`- current session id: ${input.currentSessionId ?? input.state.currentSessionId ?? \"not available\"}`,\n\t];\n\tif (input.sessionError) lines.push(`- session manager: failed — ${input.sessionError}`);\n\treturn lines;\n}\n\nfunction formatDiscovery(input: DoctorReportInput, deps: DoctorDeps): string[] {\n\treturn [\n\t\tlineFromCheck(\"agents/chains\", () => {\n\t\t\tconst discovered = deps.discoverAgentsAll(input.cwd);\n\t\t\tconst agentCounts = {\n\t\t\t\tbuiltin: discovered.builtin.length,\n\t\t\t\tpackage: discovered.package?.length ?? 0,\n\t\t\t\tuser: discovered.user.length,\n\t\t\t\tproject: discovered.project.length,\n\t\t\t};\n\t\t\tconst chainCounts = discovered.chains.reduce<Record<AgentSource, number>>((counts, chain) => {\n\t\t\t\tcounts[chain.source] += 1;\n\t\t\t\treturn counts;\n\t\t\t}, { builtin: 0, package: 0, user: 0, project: 0 });\n\t\t\treturn [\n\t\t\t\t`- agents: total ${agentCounts.builtin + agentCounts.package + agentCounts.user + agentCounts.project} (${formatSourceCounts(agentCounts)})`,\n\t\t\t\t`- chains: total ${discovered.chains.length} (${formatSourceCounts(chainCounts)})`,\n\t\t\t].join(\"\\n\");\n\t\t}),\n\t\tlineFromCheck(\"skills\", () => {\n\t\t\tconst skills = deps.discoverAvailableSkills(input.cwd);\n\t\t\treturn `- skills: total ${skills.length} (${formatSkillSourceCounts(skills)})`;\n\t\t}),\n\t];\n}\n\nfunction formatIntercomDiagnostic(diagnostic: IntercomBridgeDiagnostic, context: \"fresh\" | \"fork\" | undefined): string[] {\n\tconst lines = [\n\t\t`- bridge: ${diagnostic.active ? \"active\" : \"inactive\"}${diagnostic.reason ? ` (${diagnostic.reason})` : \"\"}`,\n\t\t`- mode: ${diagnostic.mode}; context: ${context ?? \"unspecified\"}`,\n\t\t`- orchestrator target: ${diagnostic.orchestratorTarget ?? \"not available\"}`,\n\t\t`- supervisor channel: ${diagnostic.supervisorChannelAvailable ? \"available\" : \"unavailable\"} (${diagnostic.extensionDir})`,\n\t];\n\treturn lines;\n}\n\nfunction formatPermissionSystemSection(): string[] {\n\tconst lines: string[] = [];\n\tconst parentSession = process.env[\"PI_SUBAGENT_PARENT_SESSION\"] ?? \"\";\n\tconst trimmed = parentSession.trim();\n\tif (trimmed) {\n\t\tlines.push(`- parent session: set (${trimmed})`);\n\t} else {\n\t\tlines.push(\"- parent session: not set — ask forwarding from subprocess children will not reach a parent UI\");\n\t}\n\tconst isChild = process.env[\"PI_SUBAGENT_CHILD\"] === \"1\";\n\tlines.push(`- subagent process: ${isChild ? \"yes (PI_SUBAGENT_CHILD=1)\" : \"no\"}`);\n\t// Whether pi-permission-system is installed and where it stores config is\n\t// outside pi-subagents' control, so we only report the forwarding signal we\n\t// own. Run `pi list` to confirm the permission extension is installed.\n\treturn lines;\n}\n\nexport function buildDoctorReport(input: DoctorReportInput): string {\n\tconst paths = input.paths ?? DEFAULT_PATHS;\n\tconst deps = { ...DEFAULT_DEPS, ...input.deps };\n\tconst lines = [\n\t\t\"Subagents doctor report\",\n\t\t\"\",\n\t\t\"Runtime\",\n\t\t`- cwd: ${input.cwd}`,\n\t\tlineFromCheck(\"async support\", () => `- async support: ${deps.isAsyncAvailable() ? \"available\" : \"unavailable\"}`),\n\t\t...formatSessionLines(input),\n\t\t\"\",\n\t\t\"Filesystem\",\n\t\tformatExistingDirectory(\"temp root\", paths.tempRootDir),\n\t\tformatExistingDirectory(\"async runs\", paths.asyncDir),\n\t\tformatExistingDirectory(\"results\", paths.resultsDir),\n\t\tformatExistingDirectory(\"chain runs\", paths.chainRunsDir),\n\t\t\"\",\n\t\t\"Discovery\",\n\t\t...formatDiscovery(input, deps),\n\t\t\"\",\n\t\t\"Permission system\",\n\t\t...formatPermissionSystemSection(),\n\t\t\"\",\n\t\t\"Intercom bridge\",\n\t\t...lineFromCheck(\"intercom bridge\", () => formatIntercomDiagnostic(deps.diagnoseIntercomBridge({\n\t\t\tconfig: input.config.intercomBridge,\n\t\t\tcontext: input.context,\n\t\t\torchestratorTarget: input.orchestratorTarget,\n\t\t\tcwd: input.cwd,\n\t\t}), input.context).join(\"\\n\")).split(\"\\n\"),\n\t];\n\treturn lines.join(\"\\n\");\n}\n"]}

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

@@ -0,0 +1,174 @@
+// @ts-nocheck
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { discoverAgentsAll } from "../agents/agents.js";
+import { isAsyncAvailable } from "../runs/background/async-execution.js";
+import { diagnoseIntercomBridge } from "../intercom/intercom-bridge.js";
+import { discoverAvailableSkills } from "../agents/skills.js";
+import { ASYNC_DIR, CHAIN_RUNS_DIR, RESULTS_DIR, TEMP_ROOT_DIR, } from "../shared/types.js";
+const DEFAULT_PATHS = {
+    tempRootDir: TEMP_ROOT_DIR,
+    asyncDir: ASYNC_DIR,
+    resultsDir: RESULTS_DIR,
+    chainRunsDir: CHAIN_RUNS_DIR,
+};
+const DEFAULT_DEPS = {
+    isAsyncAvailable,
+    discoverAgentsAll,
+    discoverAvailableSkills,
+    diagnoseIntercomBridge,
+};
+function errorText(error) {
+    return error instanceof Error ? `${error.name}: ${error.message}` : String(error);
+}
+function lineFromCheck(label, check) {
+    try {
+        return check();
+    }
+    catch (error) {
+        return `- ${label}: failed — ${errorText(error)}`;
+    }
+}
+function formatExistingDirectory(label, dirPath) {
+    try {
+        if (!fs.existsSync(dirPath))
+            return `- ${label}: missing (${dirPath})`;
+        const stats = fs.statSync(dirPath);
+        if (!stats.isDirectory())
+            throw new Error(`not a directory: ${dirPath}`);
+        fs.accessSync(dirPath, fs.constants.R_OK | fs.constants.W_OK);
+        return `- ${label}: ok (${dirPath})`;
+    }
+    catch (error) {
+        return `- ${label}: failed (${dirPath}) — ${errorText(error)}`;
+    }
+}
+function formatSourceCounts(counts) {
+    return `builtin ${counts.builtin}, package ${counts.package}, user ${counts.user}, project ${counts.project}`;
+}
+function formatSkillSourceCounts(skills) {
+    const counts = new Map();
+    for (const skill of skills)
+        counts.set(skill.source, (counts.get(skill.source) ?? 0) + 1);
+    const ordered = [
+        "project",
+        "project-settings",
+        "project-package",
+        "user",
+        "user-settings",
+        "user-package",
+        "extension",
+        "builtin",
+        "unknown",
+    ];
+    const parts = ordered
+        .map((source) => `${source} ${counts.get(source) ?? 0}`)
+        .filter((part) => !part.endsWith(" 0"));
+    return parts.length > 0 ? parts.join(", ") : "none";
+}
+function formatConfiguredSessionDir(input) {
+    if (input.requestedSessionDir) {
+        return path.resolve(input.expandTilde?.(input.requestedSessionDir) ?? input.requestedSessionDir);
+    }
+    if (input.config.defaultSessionDir) {
+        return path.resolve(input.expandTilde?.(input.config.defaultSessionDir) ?? input.config.defaultSessionDir);
+    }
+    return "not configured";
+}
+function formatSessionLines(input) {
+    const sessionFile = input.currentSessionFile ?? null;
+    const lines = [
+        lineFromCheck("configured session dir", () => `- configured session dir: ${formatConfiguredSessionDir(input)}`),
+        `- current session file: ${sessionFile ?? "not available"}`,
+        `- current session dir: ${sessionFile ? path.dirname(sessionFile) : "not available"}`,
+        `- current session id: ${input.currentSessionId ?? input.state.currentSessionId ?? "not available"}`,
+    ];
+    if (input.sessionError)
+        lines.push(`- session manager: failed — ${input.sessionError}`);
+    return lines;
+}
+function formatDiscovery(input, deps) {
+    return [
+        lineFromCheck("agents/chains", () => {
+            const discovered = deps.discoverAgentsAll(input.cwd);
+            const agentCounts = {
+                builtin: discovered.builtin.length,
+                package: discovered.package?.length ?? 0,
+                user: discovered.user.length,
+                project: discovered.project.length,
+            };
+            const chainCounts = discovered.chains.reduce((counts, chain) => {
+                counts[chain.source] += 1;
+                return counts;
+            }, { builtin: 0, package: 0, user: 0, project: 0 });
+            return [
+                `- agents: total ${agentCounts.builtin + agentCounts.package + agentCounts.user + agentCounts.project} (${formatSourceCounts(agentCounts)})`,
+                `- chains: total ${discovered.chains.length} (${formatSourceCounts(chainCounts)})`,
+            ].join("\n");
+        }),
+        lineFromCheck("skills", () => {
+            const skills = deps.discoverAvailableSkills(input.cwd);
+            return `- skills: total ${skills.length} (${formatSkillSourceCounts(skills)})`;
+        }),
+    ];
+}
+function formatIntercomDiagnostic(diagnostic, context) {
+    const lines = [
+        `- bridge: ${diagnostic.active ? "active" : "inactive"}${diagnostic.reason ? ` (${diagnostic.reason})` : ""}`,
+        `- mode: ${diagnostic.mode}; context: ${context ?? "unspecified"}`,
+        `- orchestrator target: ${diagnostic.orchestratorTarget ?? "not available"}`,
+        `- supervisor channel: ${diagnostic.supervisorChannelAvailable ? "available" : "unavailable"} (${diagnostic.extensionDir})`,
+    ];
+    return lines;
+}
+function formatPermissionSystemSection() {
+    const lines = [];
+    const parentSession = process.env["PI_SUBAGENT_PARENT_SESSION"] ?? "";
+    const trimmed = parentSession.trim();
+    if (trimmed) {
+        lines.push(`- parent session: set (${trimmed})`);
+    }
+    else {
+        lines.push("- parent session: not set — ask forwarding from subprocess children will not reach a parent UI");
+    }
+    const isChild = process.env["PI_SUBAGENT_CHILD"] === "1";
+    lines.push(`- subagent process: ${isChild ? "yes (PI_SUBAGENT_CHILD=1)" : "no"}`);
+    // Whether pi-permission-system is installed and where it stores config is
+    // outside pi-subagents' control, so we only report the forwarding signal we
+    // own. Run `pi list` to confirm the permission extension is installed.
+    return lines;
+}
+export function buildDoctorReport(input) {
+    const paths = input.paths ?? DEFAULT_PATHS;
+    const deps = { ...DEFAULT_DEPS, ...input.deps };
+    const lines = [
+        "Subagents doctor report",
+        "",
+        "Runtime",
+        `- cwd: ${input.cwd}`,
+        lineFromCheck("async support", () => `- async support: ${deps.isAsyncAvailable() ? "available" : "unavailable"}`),
+        ...formatSessionLines(input),
+        "",
+        "Filesystem",
+        formatExistingDirectory("temp root", paths.tempRootDir),
+        formatExistingDirectory("async runs", paths.asyncDir),
+        formatExistingDirectory("results", paths.resultsDir),
+        formatExistingDirectory("chain runs", paths.chainRunsDir),
+        "",
+        "Discovery",
+        ...formatDiscovery(input, deps),
+        "",
+        "Permission system",
+        ...formatPermissionSystemSection(),
+        "",
+        "Intercom bridge",
+        ...lineFromCheck("intercom bridge", () => formatIntercomDiagnostic(deps.diagnoseIntercomBridge({
+            config: input.config.intercomBridge,
+            context: input.context,
+            orchestratorTarget: input.orchestratorTarget,
+            cwd: input.cwd,
+        }), input.context).join("\n")).split("\n"),
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=doctor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/extension/doctor.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { discoverAgentsAll, type AgentSource } from \"../agents/agents.ts\";\nimport { isAsyncAvailable } from \"../runs/background/async-execution.ts\";\nimport { diagnoseIntercomBridge, type IntercomBridgeDiagnostic } from \"../intercom/intercom-bridge.ts\";\nimport { discoverAvailableSkills, type SkillSource } from \"../agents/skills.ts\";\nimport {\n\tASYNC_DIR,\n\tCHAIN_RUNS_DIR,\n\tRESULTS_DIR,\n\tTEMP_ROOT_DIR,\n\ttype ExtensionConfig,\n\ttype SubagentState,\n} from \"../shared/types.ts\";\n\ninterface DoctorPaths {\n\ttempRootDir: string;\n\tasyncDir: string;\n\tresultsDir: string;\n\tchainRunsDir: string;\n}\n\ninterface DoctorDeps {\n\tisAsyncAvailable: () => boolean;\n\tdiscoverAgentsAll: typeof discoverAgentsAll;\n\tdiscoverAvailableSkills: typeof discoverAvailableSkills;\n\tdiagnoseIntercomBridge: typeof diagnoseIntercomBridge;\n}\n\ninterface DoctorReportInput {\n\tcwd: string;\n\tconfig: ExtensionConfig;\n\tstate: SubagentState;\n\tcontext?: \"fresh\" | \"fork\";\n\trequestedSessionDir?: string;\n\tcurrentSessionFile?: string | null;\n\tcurrentSessionId?: string | null;\n\torchestratorTarget?: string;\n\tsessionError?: string;\n\texpandTilde?: (value: string) => string;\n\tpaths?: DoctorPaths;\n\tdeps?: Partial<DoctorDeps>;\n}\n\nconst DEFAULT_PATHS: DoctorPaths = {\n\ttempRootDir: TEMP_ROOT_DIR,\n\tasyncDir: ASYNC_DIR,\n\tresultsDir: RESULTS_DIR,\n\tchainRunsDir: CHAIN_RUNS_DIR,\n};\n\nconst DEFAULT_DEPS: DoctorDeps = {\n\tisAsyncAvailable,\n\tdiscoverAgentsAll,\n\tdiscoverAvailableSkills,\n\tdiagnoseIntercomBridge,\n};\n\nfunction errorText(error: unknown): string {\n\treturn error instanceof Error ? `${error.name}: ${error.message}` : String(error);\n}\n\nfunction lineFromCheck(label: string, check: () => string): string {\n\ttry {\n\t\treturn check();\n\t} catch (error) {\n\t\treturn `- ${label}: failed — ${errorText(error)}`;\n\t}\n}\n\nfunction formatExistingDirectory(label: string, dirPath: string): string {\n\ttry {\n\t\tif (!fs.existsSync(dirPath)) return `- ${label}: missing (${dirPath})`;\n\t\tconst stats = fs.statSync(dirPath);\n\t\tif (!stats.isDirectory()) throw new Error(`not a directory: ${dirPath}`);\n\t\tfs.accessSync(dirPath, fs.constants.R_OK | fs.constants.W_OK);\n\t\treturn `- ${label}: ok (${dirPath})`;\n\t} catch (error) {\n\t\treturn `- ${label}: failed (${dirPath}) — ${errorText(error)}`;\n\t}\n}\n\nfunction formatSourceCounts(counts: Record<AgentSource, number>): string {\n\treturn `builtin ${counts.builtin}, package ${counts.package}, user ${counts.user}, project ${counts.project}`;\n}\n\nfunction formatSkillSourceCounts(skills: Array<{ source: SkillSource }>): string {\n\tconst counts = new Map<SkillSource, number>();\n\tfor (const skill of skills) counts.set(skill.source, (counts.get(skill.source) ?? 0) + 1);\n\tconst ordered: SkillSource[] = [\n\t\t\"project\",\n\t\t\"project-settings\",\n\t\t\"project-package\",\n\t\t\"user\",\n\t\t\"user-settings\",\n\t\t\"user-package\",\n\t\t\"extension\",\n\t\t\"builtin\",\n\t\t\"unknown\",\n\t];\n\tconst parts = ordered\n\t\t.map((source) => `${source} ${counts.get(source) ?? 0}`)\n\t\t.filter((part) => !part.endsWith(\" 0\"));\n\treturn parts.length > 0 ? parts.join(\", \") : \"none\";\n}\n\nfunction formatConfiguredSessionDir(input: DoctorReportInput): string {\n\tif (input.requestedSessionDir) {\n\t\treturn path.resolve(input.expandTilde?.(input.requestedSessionDir) ?? input.requestedSessionDir);\n\t}\n\tif (input.config.defaultSessionDir) {\n\t\treturn path.resolve(input.expandTilde?.(input.config.defaultSessionDir) ?? input.config.defaultSessionDir);\n\t}\n\treturn \"not configured\";\n}\n\nfunction formatSessionLines(input: DoctorReportInput): string[] {\n\tconst sessionFile = input.currentSessionFile ?? null;\n\tconst lines = [\n\t\tlineFromCheck(\"configured session dir\", () => `- configured session dir: ${formatConfiguredSessionDir(input)}`),\n\t\t`- current session file: ${sessionFile ?? \"not available\"}`,\n\t\t`- current session dir: ${sessionFile ? path.dirname(sessionFile) : \"not available\"}`,\n\t\t`- current session id: ${input.currentSessionId ?? input.state.currentSessionId ?? \"not available\"}`,\n\t];\n\tif (input.sessionError) lines.push(`- session manager: failed — ${input.sessionError}`);\n\treturn lines;\n}\n\nfunction formatDiscovery(input: DoctorReportInput, deps: DoctorDeps): string[] {\n\treturn [\n\t\tlineFromCheck(\"agents/chains\", () => {\n\t\t\tconst discovered = deps.discoverAgentsAll(input.cwd);\n\t\t\tconst agentCounts = {\n\t\t\t\tbuiltin: discovered.builtin.length,\n\t\t\t\tpackage: discovered.package?.length ?? 0,\n\t\t\t\tuser: discovered.user.length,\n\t\t\t\tproject: discovered.project.length,\n\t\t\t};\n\t\t\tconst chainCounts = discovered.chains.reduce<Record<AgentSource, number>>((counts, chain) => {\n\t\t\t\tcounts[chain.source] += 1;\n\t\t\t\treturn counts;\n\t\t\t}, { builtin: 0, package: 0, user: 0, project: 0 });\n\t\t\treturn [\n\t\t\t\t`- agents: total ${agentCounts.builtin + agentCounts.package + agentCounts.user + agentCounts.project} (${formatSourceCounts(agentCounts)})`,\n\t\t\t\t`- chains: total ${discovered.chains.length} (${formatSourceCounts(chainCounts)})`,\n\t\t\t].join(\"\\n\");\n\t\t}),\n\t\tlineFromCheck(\"skills\", () => {\n\t\t\tconst skills = deps.discoverAvailableSkills(input.cwd);\n\t\t\treturn `- skills: total ${skills.length} (${formatSkillSourceCounts(skills)})`;\n\t\t}),\n\t];\n}\n\nfunction formatIntercomDiagnostic(diagnostic: IntercomBridgeDiagnostic, context: \"fresh\" | \"fork\" | undefined): string[] {\n\tconst lines = [\n\t\t`- bridge: ${diagnostic.active ? \"active\" : \"inactive\"}${diagnostic.reason ? ` (${diagnostic.reason})` : \"\"}`,\n\t\t`- mode: ${diagnostic.mode}; context: ${context ?? \"unspecified\"}`,\n\t\t`- orchestrator target: ${diagnostic.orchestratorTarget ?? \"not available\"}`,\n\t\t`- supervisor channel: ${diagnostic.supervisorChannelAvailable ? \"available\" : \"unavailable\"} (${diagnostic.extensionDir})`,\n\t];\n\treturn lines;\n}\n\nfunction formatPermissionSystemSection(): string[] {\n\tconst lines: string[] = [];\n\tconst parentSession = process.env[\"PI_SUBAGENT_PARENT_SESSION\"] ?? \"\";\n\tconst trimmed = parentSession.trim();\n\tif (trimmed) {\n\t\tlines.push(`- parent session: set (${trimmed})`);\n\t} else {\n\t\tlines.push(\"- parent session: not set — ask forwarding from subprocess children will not reach a parent UI\");\n\t}\n\tconst isChild = process.env[\"PI_SUBAGENT_CHILD\"] === \"1\";\n\tlines.push(`- subagent process: ${isChild ? \"yes (PI_SUBAGENT_CHILD=1)\" : \"no\"}`);\n\t// Whether pi-permission-system is installed and where it stores config is\n\t// outside pi-subagents' control, so we only report the forwarding signal we\n\t// own. Run `pi list` to confirm the permission extension is installed.\n\treturn lines;\n}\n\nexport function buildDoctorReport(input: DoctorReportInput): string {\n\tconst paths = input.paths ?? DEFAULT_PATHS;\n\tconst deps = { ...DEFAULT_DEPS, ...input.deps };\n\tconst lines = [\n\t\t\"Subagents doctor report\",\n\t\t\"\",\n\t\t\"Runtime\",\n\t\t`- cwd: ${input.cwd}`,\n\t\tlineFromCheck(\"async support\", () => `- async support: ${deps.isAsyncAvailable() ? \"available\" : \"unavailable\"}`),\n\t\t...formatSessionLines(input),\n\t\t\"\",\n\t\t\"Filesystem\",\n\t\tformatExistingDirectory(\"temp root\", paths.tempRootDir),\n\t\tformatExistingDirectory(\"async runs\", paths.asyncDir),\n\t\tformatExistingDirectory(\"results\", paths.resultsDir),\n\t\tformatExistingDirectory(\"chain runs\", paths.chainRunsDir),\n\t\t\"\",\n\t\t\"Discovery\",\n\t\t...formatDiscovery(input, deps),\n\t\t\"\",\n\t\t\"Permission system\",\n\t\t...formatPermissionSystemSection(),\n\t\t\"\",\n\t\t\"Intercom bridge\",\n\t\t...lineFromCheck(\"intercom bridge\", () => formatIntercomDiagnostic(deps.diagnoseIntercomBridge({\n\t\t\tconfig: input.config.intercomBridge,\n\t\t\tcontext: input.context,\n\t\t\torchestratorTarget: input.orchestratorTarget,\n\t\t\tcwd: input.cwd,\n\t\t}), input.context).join(\"\\n\")).split(\"\\n\"),\n\t];\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/extension/fanout-child.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function registerFanoutChildSubagentExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=fanout-child.d.ts.map