pi-subagents 0.8.5 → 0.9.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-02-17
+
+### Added
+- **Builtin agents** — the extension now ships with a default set of agent definitions in `agents/`. These are loaded with lowest priority so user and project agents always override them. New users get a useful set of agents out of the box without manual setup.
+  - `scout` — fast codebase recon (claude-haiku-4-5)
+  - `planner` — implementation plans from context (claude-opus-4-6, thinking: high)
+  - `worker` — general-purpose execution (claude-sonnet-4-6)
+  - `reviewer` — validates implementation against plans (gpt-5.2, thinking: high)
+  - `code-reviewer` — bug hunting and code review (claude-opus-4-6, thinking: high)
+  - `context-builder` — analyzes requirements and codebase (claude-sonnet-4-6)
+  - `researcher` — autonomous web research with search, evaluation, and synthesis (claude-sonnet-4-6)
+- **`"builtin"` agent source** — new third tier in agent discovery. Priority: builtin < user < project. Builtin agents appear in listings with a `[builtin]` badge and cannot be modified or deleted through management actions (create a same-named user agent to override instead).
+
+### Fixed
+- Async subagent session sharing no longer fails with `ERR_PACKAGE_PATH_NOT_EXPORTED`. The runner tried `require.resolve("@mariozechner/pi-coding-agent/package.json")` to find pi's HTML export module, but pi's `exports` map doesn't include that subpath. The fix resolves the package root in the main pi process by walking up from `process.argv[1]` and passes it to the spawned runner through the config, bypassing `require.resolve` entirely. The Windows CLI resolution fallback in `getPiSpawnCommand` benefits from the same walk-up function.
+
 ## [0.8.5] - 2026-02-16
 
 ### Fixed

package/agents.ts

@@ -11,6 +11,8 @@ import { mergeAgentsForScope } from "./agent-selection.js";
 
 export type AgentScope = "user" | "project" | "both";
 
+export type AgentSource = "builtin" | "user" | "project";
+
 export interface AgentConfig {
 	name: string;
 	description: string;
@@ -19,7 +21,7 @@ export interface AgentConfig {
 	model?: string;
 	thinking?: string;
 	systemPrompt: string;
-	source: "user" | "project";
+	source: AgentSource;
 	filePath: string;
 	skills?: string[];
 	extensions?: string[];
@@ -44,7 +46,7 @@ export interface ChainStepConfig {
 export interface ChainConfig {
 	name: string;
 	description: string;
-	source: "user" | "project";
+	source: AgentSource;
 	filePath: string;
 	steps: ChainStepConfig[];
 	extraFields?: Record<string, string>;
@@ -85,7 +87,7 @@ function parseFrontmatter(content: string): { frontmatter: Record<string, string
 	return { frontmatter, body };
 }
 
-function loadAgentsFromDir(dir: string, source: "user" | "project"): AgentConfig[] {
+function loadAgentsFromDir(dir: string, source: AgentSource): AgentConfig[] {
 	const agents: AgentConfig[] = [];
 
 	if (!fs.existsSync(dir)) {
@@ -184,7 +186,7 @@ function loadAgentsFromDir(dir: string, source: "user" | "project"): AgentConfig
 	return agents;
 }
 
-function loadChainsFromDir(dir: string, source: "user" | "project"): ChainConfig[] {
+function loadChainsFromDir(dir: string, source: AgentSource): ChainConfig[] {
 	const chains: ChainConfig[] = [];
 
 	if (!fs.existsSync(dir)) {
@@ -240,13 +242,16 @@ function findNearestProjectAgentsDir(cwd: string): string | null {
 	}
 }
 
+const BUILTIN_AGENTS_DIR = path.join(os.homedir(), ".pi", "agent", "extensions", "subagent", "agents");
+
 export function discoverAgents(cwd: string, scope: AgentScope): AgentDiscoveryResult {
 	const userDir = path.join(os.homedir(), ".pi", "agent", "agents");
 	const projectAgentsDir = findNearestProjectAgentsDir(cwd);
 
+	const builtinAgents = loadAgentsFromDir(BUILTIN_AGENTS_DIR, "builtin");
 	const userAgents = scope === "project" ? [] : loadAgentsFromDir(userDir, "user");
 	const projectAgents = scope === "user" || !projectAgentsDir ? [] : loadAgentsFromDir(projectAgentsDir, "project");
-	const agents = mergeAgentsForScope(scope, userAgents, projectAgents);
+	const agents = mergeAgentsForScope(scope, userAgents, projectAgents, builtinAgents);
 
 	return { agents, projectAgentsDir };
 }

package/async-execution.ts

@@ -13,6 +13,7 @@ import type { AgentConfig } from "./agents.js";
 import { applyThinkingSuffix } from "./execution.js";
 import { injectSingleOutputInstruction, resolveSingleOutputPath } from "./single-output.js";
 import { isParallelStep, resolveStepBehavior, type ChainStep, type SequentialStep, type StepOverrides } from "./settings.js";
+import { resolvePiPackageRoot } from "./pi-spawn.js";
 import { buildSkillInjection, normalizeSkillInput, resolveSkills } from "./skills.js";
 import {
 	type ArtifactConfig,
@@ -23,6 +24,7 @@ import {
 } from "./types.js";
 
 const require = createRequire(import.meta.url);
+const piPackageRoot = resolvePiPackageRoot();
 const jitiCliPath: string | undefined = (() => {
 	const candidates: Array<() => string> = [
 		() => path.join(path.dirname(require.resolve("jiti/package.json")), "lib/jiti-cli.mjs"),
@@ -188,6 +190,7 @@ export function executeAsyncChain(
 			sessionDir: sessionRoot ? path.join(sessionRoot, `async-${id}`) : undefined,
 			asyncDir,
 			sessionId: ctx.currentSessionId,
+			piPackageRoot,
 		},
 		id,
 		runnerCwd,
@@ -265,6 +268,7 @@ export function executeAsyncSingle(
 			sessionDir: sessionRoot ? path.join(sessionRoot, `async-${id}`) : undefined,
 			asyncDir,
 			sessionId: ctx.currentSessionId,
+			piPackageRoot,
 		},
 		id,
 		runnerCwd,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-subagents",
-  "version": "0.8.5",
+  "version": "0.9.0",
   "description": "Pi extension for delegating tasks to subagents with chains, parallel execution, and TUI clarification",
   "author": "Nico Bailon",
   "license": "MIT",

package/pi-spawn.ts

@@ -4,6 +4,22 @@ import * as path from "node:path";
 
 const require = createRequire(import.meta.url);
 
+export function resolvePiPackageRoot(): string | undefined {
+	try {
+		const entry = process.argv[1];
+		if (!entry) return undefined;
+		let dir = path.dirname(fs.realpathSync(entry));
+		while (dir !== path.dirname(dir)) {
+			try {
+				const pkg = JSON.parse(fs.readFileSync(path.join(dir, "package.json"), "utf-8"));
+				if (pkg.name === "@mariozechner/pi-coding-agent") return dir;
+			} catch {}
+			dir = path.dirname(dir);
+		}
+	} catch {}
+	return undefined;
+}
+
 export interface PiSpawnDeps {
 	platform?: NodeJS.Platform;
 	execPath?: string;
@@ -11,6 +27,7 @@ export interface PiSpawnDeps {
 	existsSync?: (filePath: string) => boolean;
 	readFileSync?: (filePath: string, encoding: "utf-8") => string;
 	resolvePackageJson?: () => string;
+	piPackageRoot?: string;
 }
 
 export interface PiSpawnCommand {
@@ -40,7 +57,11 @@ export function resolveWindowsPiCliScript(deps: PiSpawnDeps = {}): string | unde
 	}
 
 	try {
-		const resolvePackageJson = deps.resolvePackageJson ?? (() => require.resolve("@mariozechner/pi-coding-agent/package.json"));
+		const resolvePackageJson = deps.resolvePackageJson ?? (() => {
+			const root = deps.piPackageRoot ?? resolvePiPackageRoot();
+			if (root) return path.join(root, "package.json");
+			return require.resolve("@mariozechner/pi-coding-agent/package.json");
+		});
 		const packageJsonPath = resolvePackageJson();
 		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8")) as {
 			bin?: string | Record<string, string>;

package/subagent-runner.ts

@@ -44,6 +44,7 @@ interface SubagentRunConfig {
 	sessionDir?: string;
 	asyncDir: string;
 	sessionId?: string | null;
+	piPackageRoot?: string;
 }
 
 interface StepResult {
@@ -134,8 +135,8 @@ function runPiStreaming(
 	});
 }
 
-async function exportSessionHtml(sessionFile: string, outputDir: string): Promise<string> {
-	const pkgRoot = path.dirname(require.resolve("@mariozechner/pi-coding-agent/package.json"));
+async function exportSessionHtml(sessionFile: string, outputDir: string, piPackageRoot?: string): Promise<string> {
+	const pkgRoot = piPackageRoot ?? path.dirname(require.resolve("@mariozechner/pi-coding-agent/package.json"));
 	const exportModulePath = path.join(pkgRoot, "dist", "core", "export-html", "index.js");
 	const moduleUrl = pathToFileURL(exportModulePath).href;
 	const mod = await import(moduleUrl);
@@ -516,7 +517,7 @@ async function runSubagent(config: SubagentRunConfig): Promise<void> {
 		sessionFile = findLatestSessionFile(config.sessionDir) ?? undefined;
 		if (sessionFile) {
 			try {
-				const htmlPath = await exportSessionHtml(sessionFile, config.sessionDir);
+				const htmlPath = await exportSessionHtml(sessionFile, config.sessionDir, config.piPackageRoot);
 				const share = createShareLink(htmlPath);
 				if ("error" in share) shareError = share.error;
 				else {