pi-subagents 0.69.0 → 0.70.0

package/src/runs/shared/child-session.js

@@ -0,0 +1,347 @@
+import { pinChildCacheRetention } from "../../shared/child-cache-retention.js";
+import { getAgentDir } from "../../shared/utils.js";
+/** Mirror pi's JSON event projection: `message_update` drops the partial message. */
+export function projectChildSessionEventForJson(event) {
+    if (event.type !== "message_update")
+        return event;
+    const assistantMessageEvent = event.assistantMessageEvent;
+    if (!assistantMessageEvent || typeof assistantMessageEvent !== "object")
+        return event;
+    const { partial: _partial, ...delta } = assistantMessageEvent;
+    return { type: "message_update", usage: event.message?.usage, assistantMessageEvent: delta };
+}
+export function childSessionHasQueuedMessages(session) {
+    try {
+        return session?.hasQueuedMessages?.() === true;
+    }
+    catch {
+        return false;
+    }
+}
+function inheritParentProviders(modelRuntime, parentProviders, claimedProviderIds, onError) {
+    let providerIds;
+    try {
+        providerIds = parentProviders.getRegisteredProviderIds();
+    }
+    catch (error) {
+        onError?.({ extensionPath: "<parent-providers>", event: "inherit_provider", error });
+        throw new Error(`Failed to enumerate parent providers: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+    let registered = false;
+    for (const providerId of new Set(providerIds)) {
+        if (claimedProviderIds.has(providerId))
+            continue;
+        try {
+            const native = parentProviders.getRegisteredNativeProvider(providerId);
+            const config = native ? undefined : parentProviders.getRegisteredProviderConfig(providerId);
+            if (native)
+                modelRuntime.registerNativeProvider(native);
+            else if (config)
+                modelRuntime.registerProvider(providerId, config);
+            else
+                throw new Error(`Parent provider '${providerId}' has no registered native provider or config.`);
+            registered = true;
+        }
+        catch (error) {
+            onError?.({ extensionPath: `<parent-provider:${providerId}>`, event: "inherit_provider", error });
+            throw new Error(`Failed to inherit parent provider '${providerId}': ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    }
+    return registered;
+}
+const CHILD_PROMPT_RUNTIME_EXTENSION_PATH = "<inline:pi-subagents:prompt-runtime>";
+/** The prompt runtime filters parent-only context before ambient extensions inspect
+ *  the child prompt. Other inline hooks keep their normal position after ambient
+ *  extensions, and ambient extension order stays unchanged. */
+function prioritizeChildPromptRuntime(result) {
+    const index = result.extensions.findIndex(({ path }) => path === CHILD_PROMPT_RUNTIME_EXTENSION_PATH);
+    if (index <= 0)
+        return result;
+    const extensions = [...result.extensions];
+    const [promptRuntime] = extensions.splice(index, 1);
+    if (!promptRuntime)
+        return result;
+    extensions.unshift(promptRuntime);
+    return { ...result, extensions };
+}
+/** One launch at a time from env application through `session_start`, so parallel launches never observe each other's `processEnv` while their extensions load and start. */
+let loading = Promise.resolve();
+/**
+ * pi caches extension factories per process and clears that cache only when a
+ * loader reloads a second time, so every child in one process would share each
+ * extension's module state. Marking the child's loader as already loaded makes
+ * its first `reload()` clear the cache, so the child gets its own instances the
+ * way a separate process had them. The flag is a private field of pi's loader.
+ */
+function resetExtensionCacheOnReload(loader) {
+    if (!("loaded" in loader))
+        return false;
+    loader.loaded = true;
+    return true;
+}
+function applyProcessEnv(values) {
+    if (!values)
+        return;
+    for (const [name, value] of Object.entries(values)) {
+        if (value === undefined)
+            delete process.env[name];
+        else
+            process.env[name] = value;
+    }
+}
+function flushQueuedProviderRegistrations(loader, modelRuntime, onError, requiredPaths) {
+    const claimedProviderIds = new Set();
+    if (!("getExtensions" in loader) || typeof loader.getExtensions !== "function")
+        return { claimedProviderIds, registered: false };
+    const { runtime } = loader.getExtensions();
+    let registered = false;
+    for (const { name, config, extensionPath } of runtime.pendingProviderRegistrations ?? []) {
+        claimedProviderIds.add(name);
+        try {
+            modelRuntime.registerProvider(name, config);
+            registered = true;
+        }
+        catch (error) {
+            onError?.({ extensionPath, event: "register_provider", error });
+            if (requiredPaths.has(extensionPath))
+                throw new Error(`Required child extension provider registration failed for '${extensionPath}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (Array.isArray(runtime.pendingProviderRegistrations))
+        runtime.pendingProviderRegistrations = [];
+    for (const { provider, extensionPath } of runtime.pendingNativeProviderRegistrations ?? []) {
+        claimedProviderIds.add(provider.id);
+        try {
+            modelRuntime.registerNativeProvider(provider);
+            registered = true;
+        }
+        catch (error) {
+            onError?.({ extensionPath, event: "register_provider", error });
+            if (requiredPaths.has(extensionPath))
+                throw new Error(`Required child extension provider registration failed for '${extensionPath}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (Array.isArray(runtime.pendingNativeProviderRegistrations))
+        runtime.pendingNativeProviderRegistrations = [];
+    return { claimedProviderIds, registered };
+}
+/**
+ * Default factory: detached/background sessions retain the existing shared
+ * runtime; each parent-bound foreground launch gets an isolated runtime.
+ */
+export function createDefaultChildSessionFactory(options = {}) {
+    const loadPiCodingAgent = options.loadPiCodingAgent ?? (() => import("@earendil-works/pi-coding-agent"));
+    const shutdownTimeoutMs = options.shutdownTimeoutMs ?? 5_000;
+    let runtime;
+    const live = new Set();
+    /** Extension shutdowns still running for disposed children; `dispose()` waits for them. */
+    const shutdowns = new Set();
+    const sharedRuntime = async (pi) => {
+        runtime ??= pi.ModelRuntime.create().catch((error) => {
+            runtime = undefined;
+            throw error;
+        });
+        return runtime;
+    };
+    return {
+        async create(launch) {
+            const pi = await loadPiCodingAgent();
+            const modelRuntime = launch.parentProviderRegistry
+                ? await pi.ModelRuntime.create()
+                : await sharedRuntime(pi);
+            const agentDir = getAgentDir();
+            const settingsManager = pi.SettingsManager.create(launch.cwd, agentDir);
+            // Foreground children share Pi's global theme with the parent, so reinitializing it
+            // would overwrite the parent's active light/dark appearance. Detached runners have
+            // no initialized theme and must initialize one for headless extension renderers.
+            const themeKey = Symbol.for("@earendil-works/pi-coding-agent:theme");
+            const themeInitialized = Boolean(globalThis[themeKey]);
+            if (!themeInitialized && typeof pi.initTheme === "function")
+                pi.initTheme(settingsManager.getTheme());
+            const loader = new pi.DefaultResourceLoader({
+                cwd: launch.cwd,
+                agentDir,
+                settingsManager,
+                noExtensions: !launch.ambientExtensions,
+                noSkills: launch.noSkills,
+                noPromptTemplates: true,
+                noThemes: true,
+                noContextFiles: launch.noContextFiles,
+                additionalExtensionPaths: launch.extensionPaths,
+                extensionFactories: launch.hooks,
+                extensionsOverride: prioritizeChildPromptRuntime,
+                ...(launch.systemPrompt !== undefined ? { systemPrompt: launch.systemPrompt } : {}),
+                ...(launch.appendSystemPrompt !== undefined ? { appendSystemPrompt: [launch.appendSystemPrompt] } : {}),
+            });
+            const open = async () => {
+                const requiredPaths = new Set((launch.requiredExtensions ?? []).map(({ path }) => path));
+                applyProcessEnv(launch.processEnv);
+                if (!resetExtensionCacheOnReload(loader) && (launch.ambientExtensions || launch.extensionPaths.length))
+                    launch.onExtensionError?.({ extensionPath: "<loader>", event: "load", error: new Error("pi's extension cache reset is unavailable; extensions loaded into this child share module state with other sessions in this process.") });
+                await loader.reload();
+                const loadErrors = requiredPaths.size > 0
+                    ? loader.getExtensions().errors.filter(({ path }) => requiredPaths.has(path)) : [];
+                if (loadErrors.length > 0)
+                    throw new Error(`Required child extension failed to load: ${loadErrors.map(({ path, error }) => `${path}: ${error}`).join("; ")}`);
+                const queued = flushQueuedProviderRegistrations(loader, modelRuntime, launch.onExtensionError, requiredPaths);
+                const inherited = launch.parentProviderRegistry
+                    ? inheritParentProviders(modelRuntime, launch.parentProviderRegistry, queued.claimedProviderIds, launch.onExtensionError)
+                    : false;
+                if (queued.registered || inherited) {
+                    try {
+                        await modelRuntime.refresh({ allowNetwork: false });
+                    }
+                    catch (error) {
+                        launch.onExtensionError?.({ extensionPath: "<provider-refresh>", event: "refresh_providers", error });
+                        throw new Error(`Failed to refresh child providers: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+                    }
+                }
+                const sessionManager = launch.storage.kind === "file"
+                    ? pi.SessionManager.open(launch.storage.sessionFile, undefined, launch.cwd)
+                    : launch.storage.kind === "dir"
+                        ? pi.SessionManager.create(launch.cwd, launch.storage.sessionDir)
+                        : launch.storage.kind === "memory"
+                            ? pi.SessionManager.inMemory(launch.cwd)
+                            : pi.SessionManager.create(launch.cwd);
+                const resolvedModel = launch.model
+                    ? pi.resolveCliModel({ cliModel: launch.model, modelRuntime })
+                    : undefined;
+                if (resolvedModel?.error)
+                    throw new Error(resolvedModel.error);
+                const { session } = await pi.createAgentSession({
+                    cwd: launch.cwd,
+                    agentDir,
+                    modelRuntime,
+                    ...(resolvedModel?.model ? { model: resolvedModel.model } : {}),
+                    ...(resolvedModel?.thinkingLevel ? { thinkingLevel: resolvedModel.thinkingLevel } : {}),
+                    ...(launch.tools ? { tools: launch.tools } : {}),
+                    ...(launch.excludeTools?.length ? { excludeTools: launch.excludeTools } : {}),
+                    resourceLoader: loader,
+                    sessionManager,
+                    settingsManager,
+                    sessionStartEvent: { type: "session_start", reason: "startup" },
+                });
+                pinChildCacheRetention(session.agent);
+                try {
+                    await session.bindExtensions({
+                        mode: "print",
+                        onError: (error) => launch.onExtensionError?.({ extensionPath: error.extensionPath, event: error.event, error: error.error }),
+                    });
+                }
+                catch (error) {
+                    session.dispose();
+                    throw error;
+                }
+                return session;
+            };
+            const opened = loading.catch(() => { }).then(open);
+            loading = opened;
+            const session = await opened;
+            let pending;
+            // pi's own hosts emit `session_shutdown` before disposing a session so the
+            // extensions loaded into it (ambient extensions included) release their
+            // watchers, servers, and timers. Do the same, then dispose.
+            const shutdown = async () => {
+                try {
+                    const runner = session.extensionRunner;
+                    if (runner.hasHandlers("session_shutdown")) {
+                        await Promise.race([runner.emit({ type: "session_shutdown", reason: "quit" }), new Promise((resolve) => setTimeout(resolve, shutdownTimeoutMs).unref?.())]);
+                    }
+                }
+                catch (error) {
+                    launch.onExtensionError?.({ extensionPath: "<session>", event: "session_shutdown", error });
+                }
+                finally {
+                    session.dispose();
+                }
+            };
+            const child = {
+                subscribe: (listener) => session.subscribe((event) => listener(event)),
+                prompt: (text) => session.prompt(text),
+                steer: (text) => session.steer(text),
+                followUp: (text) => session.followUp(text),
+                abort: () => session.abort(),
+                hasQueuedMessages: () => session.agent?.hasQueuedMessages?.() === true,
+                dispose: () => {
+                    if (!pending) {
+                        live.delete(child);
+                        const shutdownDone = shutdown();
+                        pending = shutdownDone;
+                        shutdowns.add(shutdownDone);
+                        void shutdownDone.finally(() => shutdowns.delete(shutdownDone));
+                    }
+                    return pending;
+                },
+                get messages() { return session.messages; },
+                get sessionFile() { return session.sessionFile; },
+                get sessionId() { return session.sessionId; },
+                get modelId() { return session.model ? `${session.model.provider}/${session.model.id}` : undefined; },
+            };
+            live.add(child);
+            return child;
+        },
+        async dispose() {
+            const children = [...live].filter((child) => !child.detached);
+            for (const child of children)
+                child.shutDown = true;
+            await Promise.allSettled(children.map((child) => child.abort()));
+            for (const child of children) {
+                try {
+                    void child.dispose();
+                }
+                catch { /* best effort */ }
+            }
+            await Promise.allSettled([...shutdowns]);
+            if (live.size === 0)
+                runtime = undefined;
+        },
+    };
+}
+let activeFactory;
+let activeFactoryModule;
+/** The process-wide factory foreground runs use unless a run passes its own. */
+export function childSessionFactory() {
+    activeFactory ??= createLazyPlacementFactory(createDefaultChildSessionFactory());
+    return activeFactory;
+}
+function createLazyPlacementFactory(local) {
+    let placed;
+    const factory = async () => placed ??= (await import("./herdr-placed-run.js")).createPlacementAwareChildSessionFactory(local);
+    return {
+        async create(launch) { return launch.machine ? (await factory()).create(launch) : local.create(launch); },
+        async dispose() { if (placed)
+            await placed.dispose();
+        else
+            await local.dispose(); },
+    };
+}
+/** Default factory including pane-native placement; detached runners use the same boundary. */
+export function createPlacementChildSessionFactory(options = {}) {
+    return createLazyPlacementFactory(createDefaultChildSessionFactory(options));
+}
+/**
+ * Replace the process-wide factory. Tests install a scripted factory; passing
+ * undefined restores the default on next use.
+ */
+export function setChildSessionFactory(factory) {
+    activeFactory = factory;
+}
+/**
+ * Module path the detached background runner imports its child session factory
+ * from. Tests point it at a scripted factory; production launches leave it
+ * unset and the runner creates real sessions from the installed pi package.
+ */
+export function childSessionFactoryModule() {
+    return activeFactoryModule;
+}
+export function setChildSessionFactoryModule(modulePath) {
+    activeFactoryModule = modulePath;
+}
+/** Abort and dispose every live in-process child and release the shared runtime. */
+export async function disposeChildSessions() {
+    const factory = activeFactory;
+    if (!factory)
+        return;
+    await factory.dispose();
+}
+//# sourceMappingURL=child-session.js.map

package/src/runs/shared/child-session.js.map

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

package/src/runs/shared/child-tool-plan.d.ts

@@ -0,0 +1,73 @@
+import { type McpRuntimeSnapshotHost, type ResolvedMcpDirectToolSelection } from "./mcp-direct-tool-allowlist.ts";
+import { type JsonSchemaObject, type LaunchResolvedChildExtensions } from "../../shared/types.ts";
+import type { PermissionRules } from "./permissions.ts";
+import { type RequiredChildExtensionSnapshot } from "../../shared/required-child-extensions.ts";
+import { type ResolvedSubagentCapabilityCeiling, type SubagentCapabilityAudit } from "./capability-ceiling.ts";
+/** True for the extension files pi-subagents itself installs in child sessions. */
+export declare function isSubagentRuntimeExtensionPath(extensionPath: string): boolean;
+export declare function deriveForkPromptCacheKey(parentSessionId: string | undefined): string | undefined;
+export declare function supervisorChannelDir(runId: string, agent: string, childIndex: number): string;
+export declare function applyThinkingSuffix(model: string | undefined, thinking: string | false | undefined, replaceExisting?: boolean): string | undefined;
+export interface ResolvePiLaunchToolPlanInput {
+    tools?: string[];
+    excludeTools?: string[];
+    allowNestedSubagents?: boolean;
+    extensions?: string[];
+    subagentOnlyExtensions?: string[];
+    requiredExtensions?: RequiredChildExtensionSnapshot;
+    mcpDirectTools?: string[];
+    cwd?: string;
+    requireReadTool?: boolean;
+    structuredOutput?: boolean | {
+        schema: JsonSchemaObject;
+        schemaPath: string;
+        outputPath: string;
+    };
+    fast?: boolean;
+    model?: string;
+    capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
+    inheritedCapabilityCeiling?: ResolvedSubagentCapabilityCeiling;
+    agentName?: string;
+    permissionRules?: PermissionRules;
+    runtimeSnapshotHost?: McpRuntimeSnapshotHost;
+}
+export interface PiLaunchToolPlan {
+    capabilityCeiling?: ResolvedSubagentCapabilityCeiling;
+    requestedBuiltinTools: string[];
+    declaredBuiltinTools: string[];
+    excludeTools: string[];
+    toolExtensionPaths: string[];
+    resolvedMcpSelections: ResolvedMcpDirectToolSelection[];
+    effectiveMcpSelections: ResolvedMcpDirectToolSelection[];
+    effectiveMcpTools: string[];
+    explicitToolAllowlist: boolean;
+    internalTools: string[];
+    effectiveToolAllowlist: string[];
+    requiredChildTools: string[];
+    fanoutAuthorized: boolean;
+    runtimeExtensions: string[];
+    configuredExtensions: string[];
+    requiredExtensions: RequiredChildExtensionSnapshot;
+    extensionArgs: string[];
+    disableAmbientExtensions: boolean;
+    capabilityAudit?: SubagentCapabilityAudit;
+    /** Non-fatal launch warnings; they do not change behavior. */
+    warnings: string[];
+}
+/**
+ * Children are pi sessions inside the parent or the runner process; a spawned
+ * `pi` received extra MCP server definitions as a CLI argument, but a session
+ * has no such input. Selecting a server that exists only in pi-mcp-adapter's
+ * runtime snapshot therefore cannot work and fails the launch.
+ */
+export declare function formatRuntimeSnapshotMcpServersError(agentName: string | undefined, serverNames: readonly string[]): string;
+export declare function projectLaunchResolvedChildExtensions(toolPlan: Pick<PiLaunchToolPlan, "runtimeExtensions" | "configuredExtensions" | "requiredExtensions" | "extensionArgs" | "disableAmbientExtensions">): LaunchResolvedChildExtensions;
+/**
+ * Resolve the permission-system extension entry point when installed.
+ * Returns the absolute path to the extension's main module, or undefined
+ * when the package is not installed. Callers can check `autoInject` config
+ * to decide whether to include it in child sessions.
+ */
+export declare function resolvePermissionSystemExtension(): string | undefined;
+export declare function resolvePiLaunchToolPlan(input: ResolvePiLaunchToolPlanInput): PiLaunchToolPlan;
+//# sourceMappingURL=child-tool-plan.d.ts.map

package/src/runs/shared/child-tool-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-tool-plan.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/child-tool-plan.ts"],"names":[],"mappings":"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"}