@mariozechner/pi-coding-agent 0.34.1 → 0.35.0

package/examples/sdk/06-extensions.ts

@@ -0,0 +1,81 @@
+/**
+ * Extensions Configuration
+ *
+ * Extensions intercept agent events and can register custom tools.
+ * They provide a unified system for extensions, custom tools, commands, and more.
+ *
+ * Extension files are discovered from:
+ * - ~/.pi/agent/extensions/
+ * - <cwd>/.pi/extensions/
+ * - Paths specified in settings.json "extensions" array
+ * - Paths passed via --extension CLI flag
+ *
+ * An extension is a TypeScript file that exports a default function:
+ *   export default function (pi: ExtensionAPI) { ... }
+ */
+
+import { createAgentSession, SessionManager } from "@mariozechner/pi-coding-agent";
+
+// Extensions are loaded from disk, not passed inline to createAgentSession.
+// Use the discovery mechanism:
+//   1. Place extension files in ~/.pi/agent/extensions/ or .pi/extensions/
+//   2. Add paths to settings.json: { "extensions": ["./my-extension.ts"] }
+//   3. Use --extension flag: pi --extension ./my-extension.ts
+
+// To add additional extension paths beyond discovery:
+const { session } = await createAgentSession({
+	additionalExtensionPaths: ["./my-logging-extension.ts", "./my-safety-extension.ts"],
+	sessionManager: SessionManager.inMemory(),
+});
+
+session.subscribe((event) => {
+	if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+		process.stdout.write(event.assistantMessageEvent.delta);
+	}
+});
+
+await session.prompt("List files in the current directory.");
+console.log();
+
+// Example extension file (./my-logging-extension.ts):
+/*
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	pi.on("agent_start", async () => {
+		console.log("[Extension] Agent starting");
+	});
+
+	pi.on("tool_call", async (event) => {
+		console.log(\`[Extension] Tool: \${event.toolName}\`);
+		// Return { block: true, reason: "..." } to block execution
+		return undefined;
+	});
+
+	pi.on("agent_end", async (event) => {
+		console.log(\`[Extension] Done, \${event.messages.length} messages\`);
+	});
+
+	// Register a custom tool
+	pi.registerTool({
+		name: "my_tool",
+		label: "My Tool",
+		description: "Does something useful",
+		parameters: Type.Object({
+			input: Type.String(),
+		}),
+		execute: async (_toolCallId, params, _onUpdate, _ctx, _signal) => ({
+			content: [{ type: "text", text: \`Processed: \${params.input}\` }],
+			details: {},
+		}),
+	});
+
+	// Register a command
+	pi.registerCommand("mycommand", {
+		description: "Do something",
+		handler: async (args, ctx) => {
+			ctx.ui.notify(\`Command executed with: \${args}\`);
+		},
+	});
+}
+*/

package/examples/sdk/08-prompt-templates.ts

@@ -0,0 +1,42 @@
+/**
+ * Prompt Templates
+ *
+ * File-based templates that inject content when invoked with /templatename.
+ */
+
+import {
+	createAgentSession,
+	discoverPromptTemplates,
+	type PromptTemplate,
+	SessionManager,
+} from "@mariozechner/pi-coding-agent";
+
+// Discover templates from cwd/.pi/prompts/ and ~/.pi/agent/prompts/
+const discovered = discoverPromptTemplates();
+console.log("Discovered prompt templates:");
+for (const template of discovered) {
+	console.log(`  /${template.name}: ${template.description}`);
+}
+
+// Define custom templates
+const deployTemplate: PromptTemplate = {
+	name: "deploy",
+	description: "Deploy the application",
+	source: "(custom)",
+	content: `# Deploy Instructions
+
+1. Build: npm run build
+2. Test: npm test
+3. Deploy: npm run deploy`,
+};
+
+// Use discovered + custom templates
+await createAgentSession({
+	promptTemplates: [...discovered, deployTemplate],
+	sessionManager: SessionManager.inMemory(),
+});
+
+console.log(`Session created with ${discovered.length + 1} prompt templates`);
+
+// Disable prompt templates:
+// promptTemplates: []

package/examples/sdk/12-full-control.ts

@@ -6,21 +6,22 @@
  * IMPORTANT: When providing `tools` with a custom `cwd`, use the tool factory
  * functions (createReadTool, createBashTool, etc.) to ensure tools resolve
  * paths relative to your cwd.
+ *
+ * NOTE: Extensions (extensions, custom tools) are always loaded via discovery.
+ * To use custom extensions, place them in the extensions directory or
+ * pass paths via additionalExtensionPaths.
  */
 
 import { getModel } from "@mariozechner/pi-ai";
 import {
 	AuthStorage,
-	type CustomTool,
 	createAgentSession,
 	createBashTool,
 	createReadTool,
-	type HookFactory,
 	ModelRegistry,
 	SessionManager,
 	SettingsManager,
 } from "@mariozechner/pi-coding-agent";
-import { Type } from "@sinclair/typebox";
 
 // Custom auth storage location
 const authStorage = new AuthStorage("/tmp/my-agent/auth.json");
@@ -33,27 +34,7 @@ if (process.env.MY_ANTHROPIC_KEY) {
 // Model registry with no custom models.json
 const modelRegistry = new ModelRegistry(authStorage);
 
-// Inline hook
-const auditHook: HookFactory = (api) => {
-	api.on("tool_call", async (event) => {
-		console.log(`[Audit] ${event.toolName}`);
-		return undefined;
-	});
-};
-
-// Inline custom tool
-const statusTool: CustomTool = {
-	name: "status",
-	label: "Status",
-	description: "Get system status",
-	parameters: Type.Object({}),
-	execute: async () => ({
-		content: [{ type: "text", text: `Uptime: ${process.uptime()}s, Node: ${process.version}` }],
-		details: {},
-	}),
-};
-
-const model = getModel("anthropic", "claude-opus-4-5");
+const model = getModel("anthropic", "claude-sonnet-4-20250514");
 if (!model) throw new Error("Model not found");
 
 // In-memory settings with overrides
@@ -73,14 +54,14 @@ const { session } = await createAgentSession({
 	authStorage,
 	modelRegistry,
 	systemPrompt: `You are a minimal assistant.
-Available: read, bash, status. Be concise.`,
+Available: read, bash. Be concise.`,
 	// Use factory functions with the same cwd to ensure path resolution works correctly
 	tools: [createReadTool(cwd), createBashTool(cwd)],
-	customTools: [{ tool: statusTool }],
-	hooks: [{ factory: auditHook }],
+	// Extensions are loaded from disk - use additionalExtensionPaths to add custom ones
+	// additionalExtensionPaths: ["./my-extension.ts"],
 	skills: [],
 	contextFiles: [],
-	slashCommands: [],
+	promptTemplates: [],
 	sessionManager: SessionManager.inMemory(),
 	settingsManager,
 });
@@ -91,5 +72,5 @@ session.subscribe((event) => {
 	}
 });
 
-await session.prompt("Get status and list files.");
+await session.prompt("List files in the current directory.");
 console.log();

package/examples/sdk/README.md

@@ -11,7 +11,7 @@ Programmatic usage of pi-coding-agent via `createAgentSession()`.
 | `03-custom-prompt.ts` | Replace or modify system prompt |
 | `04-skills.ts` | Discover, filter, or replace skills |
 | `05-tools.ts` | Built-in tools, custom tools |
-| `06-hooks.ts` | Logging, blocking, result modification |
+| `06-extensions.ts` | Logging, blocking, result modification |
 | `07-context-files.ts` | AGENTS.md context files |
 | `08-slash-commands.ts` | File-based slash commands |
 | `09-api-keys-and-oauth.ts` | API key resolution, OAuth config |
@@ -36,7 +36,7 @@ import {
   discoverAuthStorage,
   discoverModels,
   discoverSkills,
-  discoverHooks,
+  discoverExtensions,
   discoverCustomTools,
   discoverContextFiles,
   discoverSlashCommands,
@@ -89,7 +89,7 @@ const { session } = await createAgentSession({
   systemPrompt: "You are helpful.",
   tools: [readTool, bashTool],
   customTools: [{ tool: myTool }],
-  hooks: [{ factory: myHook }],
+  extensions: [{ factory: myExtension }],
   skills: [],
   contextFiles: [],
   slashCommands: [],
@@ -119,8 +119,8 @@ await session.prompt("Hello");
 | `tools` | `codingTools` | Built-in tools |
 | `customTools` | Discovered | Replaces discovery |
 | `additionalCustomToolPaths` | `[]` | Merge with discovery |
-| `hooks` | Discovered | Replaces discovery |
-| `additionalHookPaths` | `[]` | Merge with discovery |
+| `extensions` | Discovered | Replaces discovery |
+| `additionalExtensionPaths` | `[]` | Merge with discovery |
 | `skills` | Discovered | Skills for prompt |
 | `contextFiles` | Discovered | AGENTS.md files |
 | `slashCommands` | Discovered | File commands |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mariozechner/pi-coding-agent",
-	"version": "0.34.1",
+	"version": "0.35.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {
@@ -39,9 +39,9 @@
 	},
 	"dependencies": {
 		"@crosscopy/clipboard": "^0.2.8",
-		"@mariozechner/pi-agent-core": "^0.34.1",
-		"@mariozechner/pi-ai": "^0.34.1",
-		"@mariozechner/pi-tui": "^0.34.1",
+		"@mariozechner/pi-agent-core": "^0.35.0",
+		"@mariozechner/pi-ai": "^0.35.0",
+		"@mariozechner/pi-tui": "^0.35.0",
 		"chalk": "^5.5.0",
 		"cli-highlight": "^2.1.11",
 		"diff": "^8.0.2",

package/dist/core/custom-tools/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Custom tools module.
- */
-export { discoverAndLoadCustomTools, loadCustomTools } from "./loader.js";
-export type { AgentToolResult, AgentToolUpdateCallback, CustomTool, CustomToolAPI, CustomToolContext, CustomToolFactory, CustomToolResult, CustomToolSessionEvent, CustomToolsLoadResult, CustomToolUIContext, ExecResult, LoadedCustomTool, RenderResultOptions, } from "./types.js";
-export { wrapCustomTool, wrapCustomTools } from "./wrapper.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/core/custom-tools/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/custom-tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EACX,eAAe,EACf,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC","sourcesContent":["/**\n * Custom tools module.\n */\n\nexport { discoverAndLoadCustomTools, loadCustomTools } from \"./loader.js\";\nexport type {\n\tAgentToolResult,\n\tAgentToolUpdateCallback,\n\tCustomTool,\n\tCustomToolAPI,\n\tCustomToolContext,\n\tCustomToolFactory,\n\tCustomToolResult,\n\tCustomToolSessionEvent,\n\tCustomToolsLoadResult,\n\tCustomToolUIContext,\n\tExecResult,\n\tLoadedCustomTool,\n\tRenderResultOptions,\n} from \"./types.js\";\nexport { wrapCustomTool, wrapCustomTools } from \"./wrapper.js\";\n"]}

package/dist/core/custom-tools/index.js

@@ -1,6 +0,0 @@
-/**
- * Custom tools module.
- */
-export { discoverAndLoadCustomTools, loadCustomTools } from "./loader.js";
-export { wrapCustomTool, wrapCustomTools } from "./wrapper.js";
-//# sourceMappingURL=index.js.map

package/dist/core/custom-tools/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/custom-tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgB1E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC","sourcesContent":["/**\n * Custom tools module.\n */\n\nexport { discoverAndLoadCustomTools, loadCustomTools } from \"./loader.js\";\nexport type {\n\tAgentToolResult,\n\tAgentToolUpdateCallback,\n\tCustomTool,\n\tCustomToolAPI,\n\tCustomToolContext,\n\tCustomToolFactory,\n\tCustomToolResult,\n\tCustomToolSessionEvent,\n\tCustomToolsLoadResult,\n\tCustomToolUIContext,\n\tExecResult,\n\tLoadedCustomTool,\n\tRenderResultOptions,\n} from \"./types.js\";\nexport { wrapCustomTool, wrapCustomTools } from \"./wrapper.js\";\n"]}

package/dist/core/custom-tools/loader.d.ts

@@ -1,30 +0,0 @@
-/**
- * Custom tool loader - loads TypeScript tool modules using jiti.
- *
- * For Bun compiled binaries, custom tools that import from @mariozechner/* packages
- * are not supported because Bun's plugin system doesn't intercept imports from
- * external files loaded at runtime. Users should use the npm-installed version
- * for custom tools that depend on pi packages.
- */
-import type { CustomToolsLoadResult } from "./types.js";
-/**
- * Load all tools from configuration.
- * @param paths - Array of tool file paths
- * @param cwd - Current working directory for resolving relative paths
- * @param builtInToolNames - Names of built-in tools to check for conflicts
- */
-export declare function loadCustomTools(paths: string[], cwd: string, builtInToolNames: string[]): Promise<CustomToolsLoadResult>;
-/**
- * Discover and load tools from standard locations:
- * 1. agentDir/tools/*.ts (global)
- * 2. cwd/.pi/tools/*.ts (project-local)
- *
- * Plus any explicitly configured paths from settings or CLI.
- *
- * @param configuredPaths - Explicit paths from settings.json and CLI --tool flags
- * @param cwd - Current working directory
- * @param builtInToolNames - Names of built-in tools to check for conflicts
- * @param agentDir - Agent config directory. Default: from getAgentDir()
- */
-export declare function discoverAndLoadCustomTools(configuredPaths: string[], cwd: string, builtInToolNames: string[], agentDir?: string): Promise<CustomToolsLoadResult>;
-//# sourceMappingURL=loader.d.ts.map

package/dist/core/custom-tools/loader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/custom-tools/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,OAAO,KAAK,EAAoC,qBAAqB,EAAoB,MAAM,YAAY,CAAC;AAyL5G;;;;;GAKG;AACH,wBAAsB,eAAe,CACpC,KAAK,EAAE,MAAM,EAAE,EACf,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,qBAAqB,CAAC,CA+ChC;AAgCD;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAC/C,eAAe,EAAE,MAAM,EAAE,EACzB,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,EAAE,EAC1B,QAAQ,GAAE,MAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA2BhC","sourcesContent":["/**\n * Custom tool loader - loads TypeScript tool modules using jiti.\n *\n * For Bun compiled binaries, custom tools that import from @mariozechner/* packages\n * are not supported because Bun's plugin system doesn't intercept imports from\n * external files loaded at runtime. Users should use the npm-installed version\n * for custom tools that depend on pi packages.\n */\n\nimport * as fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { createJiti } from \"jiti\";\nimport { getAgentDir, isBunBinary } from \"../../config.js\";\nimport { theme } from \"../../modes/interactive/theme/theme.js\";\nimport type { ExecOptions } from \"../exec.js\";\nimport { execCommand } from \"../exec.js\";\nimport type { HookUIContext } from \"../hooks/types.js\";\nimport type { CustomToolAPI, CustomToolFactory, CustomToolsLoadResult, LoadedCustomTool } from \"./types.js\";\n\n// Create require function to resolve module paths at runtime\nconst require = createRequire(import.meta.url);\n\n// Lazily computed aliases - resolved at runtime to handle global installs\nlet _aliases: Record<string, string> | null = null;\nfunction getAliases(): Record<string, string> {\n\tif (_aliases) return _aliases;\n\n\tconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\tconst packageIndex = path.resolve(__dirname, \"../..\", \"index.js\");\n\n\t// For typebox, we need the package root directory (not the entry file)\n\t// because jiti's alias is prefix-based: imports like \"@sinclair/typebox/compiler\"\n\t// get the alias prepended. If we alias to the entry file (.../build/cjs/index.js),\n\t// then \"@sinclair/typebox/compiler\" becomes \".../build/cjs/index.js/compiler\" (invalid).\n\t// By aliasing to the package root, it becomes \".../typebox/compiler\" which resolves correctly.\n\tconst typeboxEntry = require.resolve(\"@sinclair/typebox\");\n\tconst typeboxRoot = typeboxEntry.replace(/\\/build\\/cjs\\/index\\.js$/, \"\");\n\n\t_aliases = {\n\t\t\"@mariozechner/pi-coding-agent\": packageIndex,\n\t\t\"@mariozechner/pi-tui\": require.resolve(\"@mariozechner/pi-tui\"),\n\t\t\"@mariozechner/pi-ai\": require.resolve(\"@mariozechner/pi-ai\"),\n\t\t\"@sinclair/typebox\": typeboxRoot,\n\t};\n\treturn _aliases;\n}\n\nconst UNICODE_SPACES = /[\\u00A0\\u2000-\\u200A\\u202F\\u205F\\u3000]/g;\n\nfunction normalizeUnicodeSpaces(str: string): string {\n\treturn str.replace(UNICODE_SPACES, \" \");\n}\n\nfunction expandPath(p: string): string {\n\tconst normalized = normalizeUnicodeSpaces(p);\n\tif (normalized.startsWith(\"~/\")) {\n\t\treturn path.join(os.homedir(), normalized.slice(2));\n\t}\n\tif (normalized.startsWith(\"~\")) {\n\t\treturn path.join(os.homedir(), normalized.slice(1));\n\t}\n\treturn normalized;\n}\n\n/**\n * Resolve tool path.\n * - Absolute paths used as-is\n * - Paths starting with ~ expanded to home directory\n * - Relative paths resolved from cwd\n */\nfunction resolveToolPath(toolPath: string, cwd: string): string {\n\tconst expanded = expandPath(toolPath);\n\n\tif (path.isAbsolute(expanded)) {\n\t\treturn expanded;\n\t}\n\n\t// Relative paths resolved from cwd\n\treturn path.resolve(cwd, expanded);\n}\n\n/**\n * Create a no-op UI context for headless modes.\n */\nfunction createNoOpUIContext(): HookUIContext {\n\treturn {\n\t\tselect: async () => undefined,\n\t\tconfirm: async () => false,\n\t\tinput: async () => undefined,\n\t\tnotify: () => {},\n\t\tsetStatus: () => {},\n\t\tsetWidget: () => {},\n\t\tsetTitle: () => {},\n\t\tcustom: async () => undefined as never,\n\t\tsetEditorText: () => {},\n\t\tgetEditorText: () => \"\",\n\t\teditor: async () => undefined,\n\t\tget theme() {\n\t\t\treturn theme;\n\t\t},\n\t};\n}\n\n/**\n * Load a tool in Bun binary mode.\n *\n * Since Bun plugins don't work for dynamically loaded external files,\n * custom tools that import from @mariozechner/* packages won't work.\n * Tools that only use standard npm packages (installed in the tool's directory)\n * may still work.\n */\nasync function loadToolWithBun(\n\tresolvedPath: string,\n\tsharedApi: CustomToolAPI,\n): Promise<{ tools: LoadedCustomTool[] | null; error: string | null }> {\n\ttry {\n\t\t// Try to import directly - will work for tools without @mariozechner/* imports\n\t\tconst module = await import(resolvedPath);\n\t\tconst factory = (module.default ?? module) as CustomToolFactory;\n\n\t\tif (typeof factory !== \"function\") {\n\t\t\treturn { tools: null, error: \"Tool must export a default function\" };\n\t\t}\n\n\t\tconst toolResult = await factory(sharedApi);\n\t\tconst toolsArray = Array.isArray(toolResult) ? toolResult : [toolResult];\n\n\t\tconst loadedTools: LoadedCustomTool[] = toolsArray.map((tool) => ({\n\t\t\tpath: resolvedPath,\n\t\t\tresolvedPath,\n\t\t\ttool,\n\t\t}));\n\n\t\treturn { tools: loadedTools, error: null };\n\t} catch (err) {\n\t\tconst message = err instanceof Error ? err.message : String(err);\n\n\t\t// Check if it's a module resolution error for our packages\n\t\tif (message.includes(\"Cannot find module\") && message.includes(\"@mariozechner/\")) {\n\t\t\treturn {\n\t\t\t\ttools: null,\n\t\t\t\terror:\n\t\t\t\t\t`${message}\\n` +\n\t\t\t\t\t\"Note: Custom tools importing from @mariozechner/* packages are not supported in the standalone binary.\\n\" +\n\t\t\t\t\t\"Please install pi via npm: npm install -g @mariozechner/pi-coding-agent\",\n\t\t\t};\n\t\t}\n\n\t\treturn { tools: null, error: `Failed to load tool: ${message}` };\n\t}\n}\n\n/**\n * Load a single tool module using jiti (or Bun.build for compiled binaries).\n */\nasync function loadTool(\n\ttoolPath: string,\n\tcwd: string,\n\tsharedApi: CustomToolAPI,\n): Promise<{ tools: LoadedCustomTool[] | null; error: string | null }> {\n\tconst resolvedPath = resolveToolPath(toolPath, cwd);\n\n\t// Use Bun.build for compiled binaries since jiti can't resolve bundled modules\n\tif (isBunBinary) {\n\t\treturn loadToolWithBun(resolvedPath, sharedApi);\n\t}\n\n\ttry {\n\t\t// Create jiti instance for TypeScript/ESM loading\n\t\t// Use aliases to resolve package imports since tools are loaded from user directories\n\t\t// (e.g. ~/.pi/agent/tools) but import from packages installed with pi-coding-agent\n\t\tconst jiti = createJiti(import.meta.url, {\n\t\t\talias: getAliases(),\n\t\t});\n\n\t\t// Import the module\n\t\tconst module = await jiti.import(resolvedPath, { default: true });\n\t\tconst factory = module as CustomToolFactory;\n\n\t\tif (typeof factory !== \"function\") {\n\t\t\treturn { tools: null, error: \"Tool must export a default function\" };\n\t\t}\n\n\t\t// Call factory with shared API\n\t\tconst result = await factory(sharedApi);\n\n\t\t// Handle single tool or array of tools\n\t\tconst toolsArray = Array.isArray(result) ? result : [result];\n\n\t\tconst loadedTools: LoadedCustomTool[] = toolsArray.map((tool) => ({\n\t\t\tpath: toolPath,\n\t\t\tresolvedPath,\n\t\t\ttool,\n\t\t}));\n\n\t\treturn { tools: loadedTools, error: null };\n\t} catch (err) {\n\t\tconst message = err instanceof Error ? err.message : String(err);\n\t\treturn { tools: null, error: `Failed to load tool: ${message}` };\n\t}\n}\n\n/**\n * Load all tools from configuration.\n * @param paths - Array of tool file paths\n * @param cwd - Current working directory for resolving relative paths\n * @param builtInToolNames - Names of built-in tools to check for conflicts\n */\nexport async function loadCustomTools(\n\tpaths: string[],\n\tcwd: string,\n\tbuiltInToolNames: string[],\n): Promise<CustomToolsLoadResult> {\n\tconst tools: LoadedCustomTool[] = [];\n\tconst errors: Array<{ path: string; error: string }> = [];\n\tconst seenNames = new Set<string>(builtInToolNames);\n\n\t// Shared API object - all tools get the same instance\n\tconst sharedApi: CustomToolAPI = {\n\t\tcwd,\n\t\texec: (command: string, args: string[], options?: ExecOptions) =>\n\t\t\texecCommand(command, args, options?.cwd ?? cwd, options),\n\t\tui: createNoOpUIContext(),\n\t\thasUI: false,\n\t};\n\n\tfor (const toolPath of paths) {\n\t\tconst { tools: loadedTools, error } = await loadTool(toolPath, cwd, sharedApi);\n\n\t\tif (error) {\n\t\t\terrors.push({ path: toolPath, error });\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (loadedTools) {\n\t\t\tfor (const loadedTool of loadedTools) {\n\t\t\t\t// Check for name conflicts\n\t\t\t\tif (seenNames.has(loadedTool.tool.name)) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tpath: toolPath,\n\t\t\t\t\t\terror: `Tool name \"${loadedTool.tool.name}\" conflicts with existing tool`,\n\t\t\t\t\t});\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tseenNames.add(loadedTool.tool.name);\n\t\t\t\ttools.push(loadedTool);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\ttools,\n\t\terrors,\n\t\tsetUIContext(uiContext, hasUI) {\n\t\t\tsharedApi.ui = uiContext;\n\t\t\tsharedApi.hasUI = hasUI;\n\t\t},\n\t};\n}\n\n/**\n * Discover tool files from a directory.\n * Only loads index.ts files from subdirectories (e.g., tools/mytool/index.ts).\n */\nfunction discoverToolsInDir(dir: string): string[] {\n\tif (!fs.existsSync(dir)) {\n\t\treturn [];\n\t}\n\n\tconst tools: string[] = [];\n\n\ttry {\n\t\tconst entries = fs.readdirSync(dir, { withFileTypes: true });\n\n\t\tfor (const entry of entries) {\n\t\t\tif (entry.isDirectory() || entry.isSymbolicLink()) {\n\t\t\t\t// Check for index.ts in subdirectory\n\t\t\t\tconst indexPath = path.join(dir, entry.name, \"index.ts\");\n\t\t\t\tif (fs.existsSync(indexPath)) {\n\t\t\t\t\ttools.push(indexPath);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t} catch {\n\t\treturn [];\n\t}\n\n\treturn tools;\n}\n\n/**\n * Discover and load tools from standard locations:\n * 1. agentDir/tools/*.ts (global)\n * 2. cwd/.pi/tools/*.ts (project-local)\n *\n * Plus any explicitly configured paths from settings or CLI.\n *\n * @param configuredPaths - Explicit paths from settings.json and CLI --tool flags\n * @param cwd - Current working directory\n * @param builtInToolNames - Names of built-in tools to check for conflicts\n * @param agentDir - Agent config directory. Default: from getAgentDir()\n */\nexport async function discoverAndLoadCustomTools(\n\tconfiguredPaths: string[],\n\tcwd: string,\n\tbuiltInToolNames: string[],\n\tagentDir: string = getAgentDir(),\n): Promise<CustomToolsLoadResult> {\n\tconst allPaths: string[] = [];\n\tconst seen = new Set<string>();\n\n\t// Helper to add paths without duplicates\n\tconst addPaths = (paths: string[]) => {\n\t\tfor (const p of paths) {\n\t\t\tconst resolved = path.resolve(p);\n\t\t\tif (!seen.has(resolved)) {\n\t\t\t\tseen.add(resolved);\n\t\t\t\tallPaths.push(p);\n\t\t\t}\n\t\t}\n\t};\n\n\t// 1. Global tools: agentDir/tools/\n\tconst globalToolsDir = path.join(agentDir, \"tools\");\n\taddPaths(discoverToolsInDir(globalToolsDir));\n\n\t// 2. Project-local tools: cwd/.pi/tools/\n\tconst localToolsDir = path.join(cwd, \".pi\", \"tools\");\n\taddPaths(discoverToolsInDir(localToolsDir));\n\n\t// 3. Explicitly configured paths (can override/add)\n\taddPaths(configuredPaths.map((p) => resolveToolPath(p, cwd)));\n\n\treturn loadCustomTools(allPaths, cwd, builtInToolNames);\n}\n"]}

package/dist/core/custom-tools/loader.js

@@ -1,276 +0,0 @@
-/**
- * Custom tool loader - loads TypeScript tool modules using jiti.
- *
- * For Bun compiled binaries, custom tools that import from @mariozechner/* packages
- * are not supported because Bun's plugin system doesn't intercept imports from
- * external files loaded at runtime. Users should use the npm-installed version
- * for custom tools that depend on pi packages.
- */
-import * as fs from "node:fs";
-import { createRequire } from "node:module";
-import * as os from "node:os";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import { createJiti } from "jiti";
-import { getAgentDir, isBunBinary } from "../../config.js";
-import { theme } from "../../modes/interactive/theme/theme.js";
-import { execCommand } from "../exec.js";
-// Create require function to resolve module paths at runtime
-const require = createRequire(import.meta.url);
-// Lazily computed aliases - resolved at runtime to handle global installs
-let _aliases = null;
-function getAliases() {
-    if (_aliases)
-        return _aliases;
-    const __dirname = path.dirname(fileURLToPath(import.meta.url));
-    const packageIndex = path.resolve(__dirname, "../..", "index.js");
-    // For typebox, we need the package root directory (not the entry file)
-    // because jiti's alias is prefix-based: imports like "@sinclair/typebox/compiler"
-    // get the alias prepended. If we alias to the entry file (.../build/cjs/index.js),
-    // then "@sinclair/typebox/compiler" becomes ".../build/cjs/index.js/compiler" (invalid).
-    // By aliasing to the package root, it becomes ".../typebox/compiler" which resolves correctly.
-    const typeboxEntry = require.resolve("@sinclair/typebox");
-    const typeboxRoot = typeboxEntry.replace(/\/build\/cjs\/index\.js$/, "");
-    _aliases = {
-        "@mariozechner/pi-coding-agent": packageIndex,
-        "@mariozechner/pi-tui": require.resolve("@mariozechner/pi-tui"),
-        "@mariozechner/pi-ai": require.resolve("@mariozechner/pi-ai"),
-        "@sinclair/typebox": typeboxRoot,
-    };
-    return _aliases;
-}
-const UNICODE_SPACES = /[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g;
-function normalizeUnicodeSpaces(str) {
-    return str.replace(UNICODE_SPACES, " ");
-}
-function expandPath(p) {
-    const normalized = normalizeUnicodeSpaces(p);
-    if (normalized.startsWith("~/")) {
-        return path.join(os.homedir(), normalized.slice(2));
-    }
-    if (normalized.startsWith("~")) {
-        return path.join(os.homedir(), normalized.slice(1));
-    }
-    return normalized;
-}
-/**
- * Resolve tool path.
- * - Absolute paths used as-is
- * - Paths starting with ~ expanded to home directory
- * - Relative paths resolved from cwd
- */
-function resolveToolPath(toolPath, cwd) {
-    const expanded = expandPath(toolPath);
-    if (path.isAbsolute(expanded)) {
-        return expanded;
-    }
-    // Relative paths resolved from cwd
-    return path.resolve(cwd, expanded);
-}
-/**
- * Create a no-op UI context for headless modes.
- */
-function createNoOpUIContext() {
-    return {
-        select: async () => undefined,
-        confirm: async () => false,
-        input: async () => undefined,
-        notify: () => { },
-        setStatus: () => { },
-        setWidget: () => { },
-        setTitle: () => { },
-        custom: async () => undefined,
-        setEditorText: () => { },
-        getEditorText: () => "",
-        editor: async () => undefined,
-        get theme() {
-            return theme;
-        },
-    };
-}
-/**
- * Load a tool in Bun binary mode.
- *
- * Since Bun plugins don't work for dynamically loaded external files,
- * custom tools that import from @mariozechner/* packages won't work.
- * Tools that only use standard npm packages (installed in the tool's directory)
- * may still work.
- */
-async function loadToolWithBun(resolvedPath, sharedApi) {
-    try {
-        // Try to import directly - will work for tools without @mariozechner/* imports
-        const module = await import(resolvedPath);
-        const factory = (module.default ?? module);
-        if (typeof factory !== "function") {
-            return { tools: null, error: "Tool must export a default function" };
-        }
-        const toolResult = await factory(sharedApi);
-        const toolsArray = Array.isArray(toolResult) ? toolResult : [toolResult];
-        const loadedTools = toolsArray.map((tool) => ({
-            path: resolvedPath,
-            resolvedPath,
-            tool,
-        }));
-        return { tools: loadedTools, error: null };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        // Check if it's a module resolution error for our packages
-        if (message.includes("Cannot find module") && message.includes("@mariozechner/")) {
-            return {
-                tools: null,
-                error: `${message}\n` +
-                    "Note: Custom tools importing from @mariozechner/* packages are not supported in the standalone binary.\n" +
-                    "Please install pi via npm: npm install -g @mariozechner/pi-coding-agent",
-            };
-        }
-        return { tools: null, error: `Failed to load tool: ${message}` };
-    }
-}
-/**
- * Load a single tool module using jiti (or Bun.build for compiled binaries).
- */
-async function loadTool(toolPath, cwd, sharedApi) {
-    const resolvedPath = resolveToolPath(toolPath, cwd);
-    // Use Bun.build for compiled binaries since jiti can't resolve bundled modules
-    if (isBunBinary) {
-        return loadToolWithBun(resolvedPath, sharedApi);
-    }
-    try {
-        // Create jiti instance for TypeScript/ESM loading
-        // Use aliases to resolve package imports since tools are loaded from user directories
-        // (e.g. ~/.pi/agent/tools) but import from packages installed with pi-coding-agent
-        const jiti = createJiti(import.meta.url, {
-            alias: getAliases(),
-        });
-        // Import the module
-        const module = await jiti.import(resolvedPath, { default: true });
-        const factory = module;
-        if (typeof factory !== "function") {
-            return { tools: null, error: "Tool must export a default function" };
-        }
-        // Call factory with shared API
-        const result = await factory(sharedApi);
-        // Handle single tool or array of tools
-        const toolsArray = Array.isArray(result) ? result : [result];
-        const loadedTools = toolsArray.map((tool) => ({
-            path: toolPath,
-            resolvedPath,
-            tool,
-        }));
-        return { tools: loadedTools, error: null };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { tools: null, error: `Failed to load tool: ${message}` };
-    }
-}
-/**
- * Load all tools from configuration.
- * @param paths - Array of tool file paths
- * @param cwd - Current working directory for resolving relative paths
- * @param builtInToolNames - Names of built-in tools to check for conflicts
- */
-export async function loadCustomTools(paths, cwd, builtInToolNames) {
-    const tools = [];
-    const errors = [];
-    const seenNames = new Set(builtInToolNames);
-    // Shared API object - all tools get the same instance
-    const sharedApi = {
-        cwd,
-        exec: (command, args, options) => execCommand(command, args, options?.cwd ?? cwd, options),
-        ui: createNoOpUIContext(),
-        hasUI: false,
-    };
-    for (const toolPath of paths) {
-        const { tools: loadedTools, error } = await loadTool(toolPath, cwd, sharedApi);
-        if (error) {
-            errors.push({ path: toolPath, error });
-            continue;
-        }
-        if (loadedTools) {
-            for (const loadedTool of loadedTools) {
-                // Check for name conflicts
-                if (seenNames.has(loadedTool.tool.name)) {
-                    errors.push({
-                        path: toolPath,
-                        error: `Tool name "${loadedTool.tool.name}" conflicts with existing tool`,
-                    });
-                    continue;
-                }
-                seenNames.add(loadedTool.tool.name);
-                tools.push(loadedTool);
-            }
-        }
-    }
-    return {
-        tools,
-        errors,
-        setUIContext(uiContext, hasUI) {
-            sharedApi.ui = uiContext;
-            sharedApi.hasUI = hasUI;
-        },
-    };
-}
-/**
- * Discover tool files from a directory.
- * Only loads index.ts files from subdirectories (e.g., tools/mytool/index.ts).
- */
-function discoverToolsInDir(dir) {
-    if (!fs.existsSync(dir)) {
-        return [];
-    }
-    const tools = [];
-    try {
-        const entries = fs.readdirSync(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            if (entry.isDirectory() || entry.isSymbolicLink()) {
-                // Check for index.ts in subdirectory
-                const indexPath = path.join(dir, entry.name, "index.ts");
-                if (fs.existsSync(indexPath)) {
-                    tools.push(indexPath);
-                }
-            }
-        }
-    }
-    catch {
-        return [];
-    }
-    return tools;
-}
-/**
- * Discover and load tools from standard locations:
- * 1. agentDir/tools/*.ts (global)
- * 2. cwd/.pi/tools/*.ts (project-local)
- *
- * Plus any explicitly configured paths from settings or CLI.
- *
- * @param configuredPaths - Explicit paths from settings.json and CLI --tool flags
- * @param cwd - Current working directory
- * @param builtInToolNames - Names of built-in tools to check for conflicts
- * @param agentDir - Agent config directory. Default: from getAgentDir()
- */
-export async function discoverAndLoadCustomTools(configuredPaths, cwd, builtInToolNames, agentDir = getAgentDir()) {
-    const allPaths = [];
-    const seen = new Set();
-    // Helper to add paths without duplicates
-    const addPaths = (paths) => {
-        for (const p of paths) {
-            const resolved = path.resolve(p);
-            if (!seen.has(resolved)) {
-                seen.add(resolved);
-                allPaths.push(p);
-            }
-        }
-    };
-    // 1. Global tools: agentDir/tools/
-    const globalToolsDir = path.join(agentDir, "tools");
-    addPaths(discoverToolsInDir(globalToolsDir));
-    // 2. Project-local tools: cwd/.pi/tools/
-    const localToolsDir = path.join(cwd, ".pi", "tools");
-    addPaths(discoverToolsInDir(localToolsDir));
-    // 3. Explicitly configured paths (can override/add)
-    addPaths(configuredPaths.map((p) => resolveToolPath(p, cwd)));
-    return loadCustomTools(allPaths, cwd, builtInToolNames);
-}
-//# sourceMappingURL=loader.js.map