pi-subagents 0.68.0 → 0.70.0

package/src/api/shared-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-types.d.ts","sourceRoot":"","sources":["../../../src/api/shared-types.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,qBAAqB,EACrB,YAAY,EACZ,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,KAAK,EACV,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,GAC/B,MAAM,oBAAoB,CAAC"}

package/src/api/shared-types.js

@@ -0,0 +1,2 @@
+export { DEFAULT_FORK_PREAMBLE, wrapForkTask, } from "../shared/types.js";
+//# sourceMappingURL=shared-types.js.map

package/src/api/shared-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-types.js","sourceRoot":"","sources":["../../../src/api/shared-types.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,qBAAqB,EACrB,YAAY,GA0BZ,MAAM,oBAAoB,CAAC"}

package/src/api/workflow-resources.d.ts

@@ -0,0 +1,3 @@
+export { registerWorkflowResource } from "../workflows/workflow-resources.ts";
+export type { RegisterWorkflowResourceInput, WorkflowResourceDefinition, WorkflowResourceRegistration, } from "../workflows/workflow-resources.ts";
+//# sourceMappingURL=workflow-resources.d.ts.map

package/src/api/workflow-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-resources.d.ts","sourceRoot":"","sources":["../../../src/api/workflow-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,YAAY,EACX,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,GAC5B,MAAM,oCAAoC,CAAC"}

package/src/api/workflow-resources.js

@@ -0,0 +1,2 @@
+export { registerWorkflowResource } from "../workflows/workflow-resources.js";
+//# sourceMappingURL=workflow-resources.js.map

package/src/api/workflow-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-resources.js","sourceRoot":"","sources":["../../../src/api/workflow-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC"}

package/src/extension/config.d.ts

@@ -0,0 +1,8 @@
+import { type ExtensionConfig } from "../shared/types.ts";
+export declare function resolveScheduledStoreRoot(value: string): string;
+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 resolveAsyncByDefault(config: Pick<ExtensionConfig, "asyncByDefault">): boolean;
+export declare function loadConfig(): ExtensionConfig;
+//# sourceMappingURL=config.d.ts.map

package/src/extension/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/extension/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwD,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA4ChH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI/D;AAgID,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAYD,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,CAMnG;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,GAAG,OAAO,CAE9F;AAED,wBAAgB,UAAU,IAAI,eAAe,CAkB5C"}

package/src/extension/config.js

@@ -0,0 +1,245 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { Key } from "@earendil-works/pi-tui";
+import { FLEET_KEYBINDING_ACTIONS } from "../shared/types.js";
+import { validateMissionStoreConfig } from "../missions/store.js";
+import { validateAuthorityPolicy } from "../policy/authority.js";
+import { getAgentDir } from "../shared/utils.js";
+import { validatePermissionConfig } from "../runs/shared/permissions.js";
+import { MAX_ABANDONED_SLOT_RELEASE_AFTER_MS, MIN_ABANDONED_SLOT_RELEASE_AFTER_MS } from "../runs/background/active-async-capacity.js";
+import { normalizeWorktreeBranchPrefix } from "../runs/shared/worktree.js";
+import { validateModelResponseAliases } from "../shared/model-response-aliases.js";
+const ARTIFACT_DIR_PREFERENCES = new Set(["project", "session", "temp"]);
+const FLEET_KEYBINDING_ACTION_SET = new Set(FLEET_KEYBINDING_ACTIONS);
+const KEY_MODIFIERS = new Set(["ctrl", "shift", "alt", "super"]);
+const BASE_KEY_IDS = new Set([
+    ..."abcdefghijklmnopqrstuvwxyz0123456789",
+    ...Object.values(Key).flatMap((value) => typeof value === "string" ? [value.toLowerCase()] : []),
+]);
+class PrunedForkConfigError extends Error {
+}
+function validateForkContextConfig(value) {
+    if (value === undefined)
+        return;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("config.forkContext must be a JSON object");
+    const config = value;
+    if (config.mode !== undefined && config.mode !== "full" && config.mode !== "pruned") {
+        throw new Error('config.forkContext.mode must be "full" or "pruned"');
+    }
+    if (config.model !== undefined && (typeof config.model !== "string" || !config.model.trim())) {
+        throw new PrunedForkConfigError("config.forkContext.model must be a non-empty string");
+    }
+    if (config.mode === "pruned" && config.model === undefined) {
+        throw new PrunedForkConfigError('config.forkContext.model is required when config.forkContext.mode is "pruned"');
+    }
+}
+function isValidKeyId(value) {
+    if (value !== value.trim())
+        return false;
+    const parts = value.toLowerCase().split("+");
+    const base = parts.pop();
+    if (!base || !BASE_KEY_IDS.has(base))
+        return false;
+    return parts.length <= KEY_MODIFIERS.size
+        && new Set(parts).size === parts.length
+        && parts.every((modifier) => KEY_MODIFIERS.has(modifier));
+}
+export function resolveScheduledStoreRoot(value) {
+    const expanded = value.startsWith("~/") ? path.join(os.homedir(), value.slice(2)) : value;
+    if (!path.isAbsolute(expanded))
+        throw new Error(`config.scheduledRuns.storeRoot must be an absolute path or "~/...", got ${JSON.stringify(value)}`);
+    return path.normalize(expanded);
+}
+function validateScheduledRunsConfig(value) {
+    if (value === undefined)
+        return;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("config.scheduledRuns must be a JSON object");
+    const storeRoot = value.storeRoot;
+    if (storeRoot === undefined)
+        return;
+    if (typeof storeRoot !== "string" || !storeRoot.trim())
+        throw new Error("config.scheduledRuns.storeRoot must be a non-empty string");
+    resolveScheduledStoreRoot(storeRoot);
+}
+function validateFleetKeybindingsConfig(value) {
+    if (value === undefined)
+        return;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("config.fleetKeybindings must be a JSON object");
+    for (const [action, bindings] of Object.entries(value)) {
+        if (!FLEET_KEYBINDING_ACTION_SET.has(action))
+            throw new Error(`config.fleetKeybindings.${action} is not a supported Fleet action`);
+        if (!Array.isArray(bindings) || bindings.length === 0)
+            throw new Error(`config.fleetKeybindings.${action} must be a non-empty array of strings`);
+        for (const binding of bindings) {
+            if (typeof binding !== "string" || !binding.trim())
+                throw new Error(`config.fleetKeybindings.${action} entries must be non-empty strings`);
+        }
+    }
+}
+function validateArtifactConfig(value) {
+    if (value === undefined)
+        return;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("config.artifactConfig must be a JSON object");
+    const cleanupDays = value.cleanupDays;
+    if (cleanupDays !== undefined && (typeof cleanupDays !== "number" || !Number.isInteger(cleanupDays) || cleanupDays < 0)) {
+        throw new Error("config.artifactConfig.cleanupDays must be a non-negative integer");
+    }
+}
+function validateCapacityConfig(value) {
+    if (value === undefined)
+        return;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("config.capacity must be a JSON object");
+    const abandonedSlotReleaseAfterMs = value.abandonedSlotReleaseAfterMs;
+    if (abandonedSlotReleaseAfterMs !== undefined
+        && abandonedSlotReleaseAfterMs !== false
+        && (typeof abandonedSlotReleaseAfterMs !== "number"
+            || !Number.isInteger(abandonedSlotReleaseAfterMs)
+            || abandonedSlotReleaseAfterMs < MIN_ABANDONED_SLOT_RELEASE_AFTER_MS
+            || abandonedSlotReleaseAfterMs > MAX_ABANDONED_SLOT_RELEASE_AFTER_MS)) {
+        throw new Error(`config.capacity.abandonedSlotReleaseAfterMs must be false or an integer from ${MIN_ABANDONED_SLOT_RELEASE_AFTER_MS} to ${MAX_ABANDONED_SLOT_RELEASE_AFTER_MS}`);
+    }
+}
+function validateOrcaProgressTabsConfig(value) {
+    if (value === undefined)
+        return;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("config.orcaProgressTabs must be a JSON object");
+    const config = value;
+    for (const key of Object.keys(config)) {
+        if (key !== "enabled")
+            throw new Error(`config.orcaProgressTabs.${key} is not supported`);
+    }
+    if (config.enabled !== undefined && typeof config.enabled !== "boolean") {
+        throw new Error("config.orcaProgressTabs.enabled must be a boolean");
+    }
+}
+function validateMainWindowRendererConfig(value) {
+    if (value === undefined)
+        return;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("config.mainWindowRenderer must be a JSON object");
+    const rendererConfig = value;
+    if (rendererConfig.horizontalSpacing !== undefined
+        && (typeof rendererConfig.horizontalSpacing !== "number"
+            || !Number.isInteger(rendererConfig.horizontalSpacing)
+            || rendererConfig.horizontalSpacing < 0
+            || rendererConfig.horizontalSpacing > 4)) {
+        throw new Error("config.mainWindowRenderer.horizontalSpacing must be an integer from 0 to 4");
+    }
+    if (rendererConfig.compactResultMaxLines !== undefined
+        && (typeof rendererConfig.compactResultMaxLines !== "number"
+            || !Number.isInteger(rendererConfig.compactResultMaxLines)
+            || rendererConfig.compactResultMaxLines < 1)) {
+        throw new Error("config.mainWindowRenderer.compactResultMaxLines must be a positive integer");
+    }
+}
+function validateConfig(config) {
+    if (config.worktree !== undefined && typeof config.worktree !== "boolean") {
+        throw new Error("config.worktree must be a boolean");
+    }
+    if (config.worktreeProvider !== undefined && config.worktreeProvider !== "auto" && config.worktreeProvider !== "native" && config.worktreeProvider !== "worktrunk") {
+        throw new Error('config.worktreeProvider must be "auto", "native", or "worktrunk"');
+    }
+    if (config.worktreeBranchPrefix !== undefined) {
+        if (typeof config.worktreeBranchPrefix !== "string")
+            throw new Error("config.worktreeBranchPrefix must be a string");
+        normalizeWorktreeBranchPrefix(config.worktreeBranchPrefix);
+    }
+    if (config.defaultSubagentContext !== undefined && config.defaultSubagentContext !== "fresh" && config.defaultSubagentContext !== "fork") {
+        throw new Error('config.defaultSubagentContext must be "fresh" or "fork"');
+    }
+    validateForkContextConfig(config.forkContext);
+    if (config.checkpointBeforeDeadlineMs !== undefined
+        && (typeof config.checkpointBeforeDeadlineMs !== "number"
+            || !Number.isInteger(config.checkpointBeforeDeadlineMs)
+            || config.checkpointBeforeDeadlineMs <= 0
+            || config.checkpointBeforeDeadlineMs > 2_147_483_647)) {
+        throw new Error("config.checkpointBeforeDeadlineMs must be a positive integer no larger than 2147483647");
+    }
+    if (config.foregroundDetachShortcut !== undefined
+        && (typeof config.foregroundDetachShortcut !== "string" || !isValidKeyId(config.foregroundDetachShortcut))) {
+        throw new Error("config.foregroundDetachShortcut must be a valid keybinding string such as \"ctrl+b\"");
+    }
+    if (config.artifactDir !== undefined && !ARTIFACT_DIR_PREFERENCES.has(config.artifactDir)) {
+        throw new Error(`config.artifactDir must be "project", "session", or "temp"`);
+    }
+    if (config.maxActiveAsyncRunsPerSession !== undefined
+        && (typeof config.maxActiveAsyncRunsPerSession !== "number"
+            || !Number.isInteger(config.maxActiveAsyncRunsPerSession)
+            || config.maxActiveAsyncRunsPerSession < 0)) {
+        throw new Error("config.maxActiveAsyncRunsPerSession must be a non-negative integer");
+    }
+    if (config.resultScanLogging !== undefined && config.resultScanLogging !== "all" && config.resultScanLogging !== "activity" && config.resultScanLogging !== "off") {
+        throw new Error('config.resultScanLogging must be "all", "activity", or "off"');
+    }
+    validateMissionStoreConfig(config.missions);
+    validateAuthorityPolicy(config.authorityPolicy);
+    validatePermissionConfig(config.permissions);
+    validateScheduledRunsConfig(config.scheduledRuns);
+    validateFleetKeybindingsConfig(config.fleetKeybindings);
+    validateArtifactConfig(config.artifactConfig);
+    validateCapacityConfig(config.capacity);
+    if (config.modelExclusions !== undefined)
+        throw new Error("config.modelExclusions was removed; model failures are no longer persisted or used for automatic switching");
+    validateModelResponseAliases(config.modelResponseAliases);
+    validateMainWindowRendererConfig(config.mainWindowRenderer);
+    validateOrcaProgressTabsConfig(config.orcaProgressTabs);
+}
+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`);
+    }
+    validateConfig(parsed);
+    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));
+    validateConfig(next);
+    saveConfig(next, configPath);
+    return next;
+}
+export function resolveAsyncByDefault(config) {
+    return config.asyncByDefault !== false;
+}
+export function loadConfig() {
+    const configPath = getConfigPath();
+    try {
+        return readConfigForUpdate(configPath);
+    }
+    catch (error) {
+        if (error instanceof PrunedForkConfigError)
+            throw error;
+        // Explicit route identity, worktree, and checkpoint policies must not be silently
+        // discarded and replaced by the built-in defaults after validation fails.
+        try {
+            const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            if (raw && typeof raw === "object" && !Array.isArray(raw)
+                && (Object.hasOwn(raw, "worktreeProvider") || Object.hasOwn(raw, "worktreeBranchPrefix") || Object.hasOwn(raw, "modelResponseAliases") || Object.hasOwn(raw, "modelExclusions") || Object.hasOwn(raw, "checkpointBeforeDeadlineMs")))
+                throw error;
+        }
+        catch (readError) {
+            if (readError === error)
+                throw error;
+        }
+        console.error(`Failed to load subagent config from '${configPath}':`, error);
+    }
+    return {};
+}
+//# sourceMappingURL=config.js.map

package/src/extension/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/extension/config.ts"],"names":[],"mappings":"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"}

package/src/extension/control-notices.d.ts

@@ -0,0 +1,19 @@
+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" | "goal";
+    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 handleSubagentControlNotice(input: {
+    pi: Pick<ExtensionAPI, "sendMessage">;
+    state: SubagentState;
+    visibleControlNotices: Set<string>;
+    details: SubagentControlMessageDetails;
+}): void;
+//# sourceMappingURL=control-notices.d.ts.map

package/src/extension/control-notices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-notices.d.ts","sourceRoot":"","sources":["../../../src/extension/control-notices.ts"],"names":[],"mappings":"AAAA,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,GAAG,MAAM,CAAC;IACzC,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;AAuBD,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;CACvC,GAAG,IAAI,CASP"}

package/src/extension/control-notices.js

@@ -0,0 +1,34 @@
+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 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 === "async" });
+}
+export function handleSubagentControlNotice(input) {
+    if (!input.details?.event || input.details.event.type === "active_long_running")
+        return;
+    if (input.details.source === "foreground") {
+        // A foreground tool blocks Pi from displaying this message. The run can
+        // finish before Pi flushes it, and queued messages cannot be withdrawn.
+        // Foreground control remains available through the live tool and fleet state.
+        return;
+    }
+    deliverControlNotice(input);
+}
+//# sourceMappingURL=control-notices.js.map

package/src/extension/control-notices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-notices.js","sourceRoot":"","sources":["../../../src/extension/control-notices.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGxG,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAC;AAUvE,MAAM,UAAU,mBAAmB,CAAC,OAAsC;IACzE,OAAO,OAAO,CAAC,mBAAmB,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAsC,EAAE,OAAgB;IACnG,OAAO,OAAO,CAAC,UAAU,IAAI,OAAO,IAAI,0BAA0B,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;AACjH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAI7B;IACA,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IAC7E,IAAI,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IACjD,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,IAAI,0BAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACpH,KAAK,CAAC,EAAE,CAAC,WAAW,CACnB;QACC,UAAU,EAAE,6BAA6B;QACzC,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE;KAC9D,EACD,EAAE,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAK3C;IACA,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,qBAAqB;QAAE,OAAO;IACxF,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QAC3C,wEAAwE;QACxE,wEAAwE;QACxE,8EAA8E;QAC9E,OAAO;IACR,CAAC;IACD,oBAAoB,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/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/src/extension/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/extension/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,qBAAqB,CAAC;AAK1E,OAAO,EAAE,sBAAsB,EAAiC,MAAM,gCAAgC,CAAC;AACvG,OAAO,EAAE,uBAAuB,EAAoB,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAIN,KAAK,eAAe,EACpB,KAAK,aAAa,EAGlB,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;AAwLD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA4ClE"}

package/src/extension/doctor.js

@@ -0,0 +1,231 @@
+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 { formatSpawnBudgetSummary, getSpawnBudgetSnapshot } from "../runs/shared/spawn-budget.js";
+import { getActiveAsyncCapacitySnapshot, resolveAbandonedSlotReleaseAfterMs, resolveMaxActiveAsyncRunsPerSession } from "../runs/background/active-async-capacity.js";
+import { diagnoseIntercomBridge } from "../intercom/intercom-bridge.js";
+import { discoverAvailableSkills } from "../agents/skills.js";
+import { DIRS, CHAIN_RUNS_DIR, TEMP_ROOT_DIR, normalizeMaxSubagentSpawnsPerRun, resolveMaxSubagentSpawnsPerRun, } from "../shared/types.js";
+function defaultPaths() {
+    return {
+        tempRootDir: TEMP_ROOT_DIR,
+        asyncDir: DIRS.async,
+        resultsDir: DIRS.results,
+        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", () => {
+            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,
+                runtime: 0,
+            };
+            const diagnostics = discovered.agentDiagnostics ?? [];
+            return [
+                `- agents: total ${agentCounts.builtin + agentCounts.package + agentCounts.user + agentCounts.project} (${formatSourceCounts(agentCounts)})`,
+                ...diagnostics.map((diagnostic) => `- invalid agent ${diagnostic.name ?? diagnostic.filePath} (${diagnostic.source}): ${diagnostic.error}`),
+            ].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 formatSpawnBudgetSection(input) {
+    const snapshot = getSpawnBudgetSnapshot(input.state, input.config, input.currentSessionId ?? input.state.currentSessionId);
+    return [
+        `- usage: ${formatSpawnBudgetSummary(snapshot)}`,
+        `- recent grants: ${snapshot.grantHistory.length === 0
+            ? "none"
+            : snapshot.grantHistory.map((grant) => `+${grant.amount} at ${new Date(grant.grantedAt).toISOString()} (${grant.previousLimit} → ${grant.limit})`).join("; ")}`,
+        "- reset boundary: a new parent session resets usage and grants; compaction does not",
+    ];
+}
+function formatRunFanoutSection(input) {
+    const configured = resolveMaxSubagentSpawnsPerRun(input.config.maxSubagentSpawnsPerRun);
+    const source = normalizeMaxSubagentSpawnsPerRun(process.env.PI_SUBAGENT_MAX_SPAWNS_PER_RUN) !== undefined
+        ? "environment"
+        : normalizeMaxSubagentSpawnsPerRun(input.config.maxSubagentSpawnsPerRun) !== undefined ? "config" : "default";
+    return [`- configured limit: ${configured} (${source})`, "- usage: available after a run starts", "- reset boundary: cumulative claims are never released; a new top-level run creates a new budget"];
+}
+function formatActiveAsyncCapacitySection(input) {
+    const limit = resolveMaxActiveAsyncRunsPerSession(input.config.maxActiveAsyncRunsPerSession);
+    const sessionId = input.currentSessionId ?? input.state.currentSessionId;
+    const snapshot = sessionId
+        ? getActiveAsyncCapacitySnapshot(sessionId, limit, { liveWorkflowRunIds: new Set(input.state.workflowControllers?.keys() ?? []), abandonedSlotReleaseAfterMs: resolveAbandonedSlotReleaseAfterMs(input.config.capacity?.abandonedSlotReleaseAfterMs) })
+        : { used: 0, limit: limit ?? 0 };
+    input.state.activeAsyncCapacity = snapshot;
+    return [
+        `- usage: ${snapshot.used}/${snapshot.limit || "unlimited"} used`,
+        "- scope: top-level async runs in the current parent session; foreground and nested workflow children are not charged again",
+        "- release: terminal state plus matching observed process-terminal proof, or abandoned-timeout for failed runs with a dead runner PID and stale activity when enabled; false keeps unknown-proof slots",
+    ];
+}
+function formatPermissionSystemSection() {
+    const lines = [];
+    const parentSession = process.env["PI_SUBAGENT_PARENT_SESSION"] ?? "";
+    const trimmed = parentSession.trim();
+    const isChild = process.env["PI_SUBAGENT_CHILD"] === "1";
+    if (isChild && trimmed) {
+        lines.push(`- runner parent session: set (${trimmed}) — explicit target for this dedicated child process`);
+    }
+    else if (isChild) {
+        lines.push("- runner parent session: not set — this child process has no forwarding target");
+    }
+    else if (trimmed) {
+        lines.push("- root parent session: ignored legacy process-global value — root sessions do not use it for routing");
+    }
+    else {
+        lines.push("- root parent session: not set (healthy) — detached forwarding is attached at runner launch");
+    }
+    if (!isChild)
+        lines.push("- foreground external ask forwarding: unavailable until the permission extension supports a session-scoped target");
+    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;
+}
+function formatWorkflowScriptSection() {
+    return [
+        "- helpers: runs.run, runs.all, runs.steer, runs.status, runs.ref/refs, emit, console",
+        "- recovery: if runs.all is missing, reload or update pi-subagents; await Promise.all([runs.run(...)]) is also supported",
+    ];
+}
+export function buildDoctorReport(input) {
+    const paths = input.paths ?? defaultPaths();
+    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),
+        "",
+        "Spawn budget",
+        ...formatSpawnBudgetSection(input),
+        "",
+        "Run fan-out budget",
+        ...formatRunFanoutSection(input),
+        "",
+        "Active async capacity",
+        ...formatActiveAsyncCapacitySection(input),
+        "",
+        "Workflow script",
+        ...formatWorkflowScriptSection(),
+        "",
+        "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