@oh-my-pi/pi-coding-agent 10.3.1 → 10.5.0

package/CHANGELOG.md

@@ -2,6 +2,52 @@
 
 ## [Unreleased]
 
+## [10.5.0] - 2026-02-04
+
+### Breaking Changes
+
+- Changed `ask` tool to require `questions` array parameter; single-question mode with `question`, `options`, `multi`, and `recommended` parameters is no longer supported
+- Removed support for local Python kernel gateway startup; shared gateway is now required
+
+### Added
+
+- Added browser tool powered by Ulixee Hero with support for navigation, DOM interaction, screenshots, and readable content extraction
+- Added `/browser` command to toggle browser headless vs visible mode in interactive sessions
+- Added `browser.enabled` and `browser.headless` settings to control browser automation behavior
+- Added Python prelude caching to improve startup performance by storing compiled prelude helpers and module metadata
+- Added `OMP_DEBUG_STARTUP` environment variable for conditional startup performance debugging output
+- Added autonomous memory system with storage, memory tools, and context injection
+
+### Changed
+
+- Updated task tool guidance to enforce small, well-defined task scope with maximum 3-5 files per task to prevent timeouts and improve parallel execution
+- Updated browser viewport to use 1.25x device scale factor for improved rendering on high-DPI displays
+- Modified device pixel ratio detection to respect actual screen capabilities instead of forcing 1x ratio
+- Updated system prompt guidance to state assumptions and proceed without asking for confirmation, reducing unnecessary round-trips
+- Tightened `ask` tool conditions to require multiple approaches with significantly different tradeoffs before prompting user
+- Strengthened `ask` tool guidance to default to action and only ask when genuinely blocked by decisions with materially different outcomes
+- Changed refactor workflow to automatically remove now-unused elements and note removals instead of asking for confirmation
+- Enforced exclusive concurrency mode for all file-modifying tools (edit, write, bash, python, ssh, todo-write) to prevent concurrent execution conflicts
+- Updated `ask` tool guidance to prioritize proactive problem-solving and default to action, asking only when truly blocked by decisions that materially change scope or behavior
+- Changed Python kernel initialization to require shared gateway mode; local gateway startup has been removed
+- Changed shared gateway error handling to retry on server errors (5xx status codes) before failing
+
+### Fixed
+
+- Fixed glob search returning no results when all files are ignored by gitignore by automatically retrying without gitignore filtering
+
+## [10.3.2] - 2026-02-03
+### Added
+
+- Added `renderCall` and `renderResult` methods to MCP tools for structured TUI display of tool calls and results
+- Added new `mcp/render.ts` module providing JSON tree rendering for MCP tool output with collapsible/expandable views
+
+### Changed
+
+- Updated `renderResult` signature in custom tools and extensions to accept optional `args` parameter for context-aware rendering
+- Changed environment variable from `ENV_AGENT_DIR` constant to hardcoded `OMP_CODING_AGENT_DIR` string in config and CLI help text
+- Fixed method binding in extension and hook tool wrappers to preserve `this` context for `renderCall` and `renderResult` methods
+
 ## [10.3.1] - 2026-02-03
 ### Fixed
 

package/docs/config-usage.md

@@ -8,7 +8,7 @@ This document shows how each file uses the config module and what subpaths they
 ┌─────────────────────────────────────────────────────────────────────────────────┐
 │                              config.ts exports                                   │
 ├─────────────────────────────────────────────────────────────────────────────────┤
-│ Constants:        APP_NAME, CONFIG_DIR_NAME, VERSION, ENV_AGENT_DIR             │
+│ Constants:        APP_NAME, CONFIG_DIR_NAME, VERSION                            │
 │ Single paths:     getAgentDir, getAuthPath, getModelsPath, getCommandsDir, ...  │
 │ Multi-config:     getConfigDirs, getConfigDirPaths, findConfigFile,             │
 │                   readConfigFile, findNearestProjectConfigDir, ...              │
@@ -19,51 +19,51 @@ This document shows how each file uses the config module and what subpaths they
 
 ### 1. Display/Branding Only (no file I/O)
 
-| File | Imports | Purpose |
-|------|---------|---------|
-| `cli/args.ts` | `APP_NAME`, `CONFIG_DIR_NAME`, `ENV_AGENT_DIR` | Help text, env var names |
-| `cli/plugin-cli.ts` | `APP_NAME` | Command output |
-| `cli/update-cli.ts` | `APP_NAME`, `VERSION` | Update messages |
-| `core/export-html/index.ts` | `APP_NAME` | HTML export title |
-| `modes/interactive/components/welcome.ts` | `APP_NAME` | Welcome banner |
-| `utils/tools-manager.ts` | `APP_NAME` | Tool download messages |
+| File                                      | Imports                       | Purpose                  |
+| ----------------------------------------- | ----------------------------- | ------------------------ |
+| `cli/args.ts`                             | `APP_NAME`, `CONFIG_DIR_NAME` | Help text, env var names |
+| `cli/plugin-cli.ts`                       | `APP_NAME`                    | Command output           |
+| `cli/update-cli.ts`                       | `APP_NAME`, `VERSION`         | Update messages          |
+| `core/export-html/index.ts`               | `APP_NAME`                    | HTML export title        |
+| `modes/interactive/components/welcome.ts` | `APP_NAME`                    | Welcome banner           |
+| `utils/tools-manager.ts`                  | `APP_NAME`                    | Tool download messages   |
 
 ### 2. Single Fixed Paths (user-level only)
 
-| File | Imports | Path | Purpose |
-|------|---------|------|---------|
-| `core/logger.ts` | `CONFIG_DIR_NAME` | `~/.omp/logs/` | Log file directory |
-| `core/agent-session.ts` | `getAuthPath` | `~/.omp/agent/auth.json` | Error messages |
-| `core/session-manager.ts` | `getAgentDir` | `~/.omp/agent/sessions/` | Session storage |
-| `modes/interactive/theme/theme.ts` | `getCustomThemesDir` | `~/.omp/agent/themes/` | Custom themes |
-| `modes/interactive/interactive-mode.ts` | `getAuthPath`, `getDebugLogPath` | auth.json, debug log | Status messages |
-| `utils/changelog.ts` | `getChangelogPath` | Package CHANGELOG.md | Re-exports |
-| `core/system-prompt.ts` | `getAgentDir`, `getDocsPath`, `getExamplesPath`, `getReadmePath` | Package assets + AGENTS.md | System prompt building |
-| `migrations.ts` | `getAgentDir` | `~/.omp/agent/` | Auth/session migration |
-| `core/plugins/installer.ts` | `getAgentDir` | `~/.omp/agent/` | Plugin installation |
-| `core/plugins/paths.ts` | `CONFIG_DIR_NAME` | `~/.omp/plugins/` | Plugin directories |
+| File                                    | Imports                                                          | Path                       | Purpose                |
+| --------------------------------------- | ---------------------------------------------------------------- | -------------------------- | ---------------------- |
+| `core/logger.ts`                        | `CONFIG_DIR_NAME`                                                | `~/.omp/logs/`             | Log file directory     |
+| `core/agent-session.ts`                 | `getAuthPath`                                                    | `~/.omp/agent/auth.json`   | Error messages         |
+| `core/session-manager.ts`               | `getAgentDir`                                                    | `~/.omp/agent/sessions/`   | Session storage        |
+| `modes/interactive/theme/theme.ts`      | `getCustomThemesDir`                                             | `~/.omp/agent/themes/`     | Custom themes          |
+| `modes/interactive/interactive-mode.ts` | `getAuthPath`, `getDebugLogPath`                                 | auth.json, debug log       | Status messages        |
+| `utils/changelog.ts`                    | `getChangelogPath`                                               | Package CHANGELOG.md       | Re-exports             |
+| `core/system-prompt.ts`                 | `getAgentDir`, `getDocsPath`, `getExamplesPath`, `getReadmePath` | Package assets + AGENTS.md | System prompt building |
+| `migrations.ts`                         | `getAgentDir`                                                    | `~/.omp/agent/`            | Auth/session migration |
+| `core/plugins/installer.ts`             | `getAgentDir`                                                    | `~/.omp/agent/`            | Plugin installation    |
+| `core/plugins/paths.ts`                 | `CONFIG_DIR_NAME`                                                | `~/.omp/plugins/`          | Plugin directories     |
 
 ### 3. Multi-Config Discovery (with fallbacks)
 
 These use the new helpers to check `.omp`, `.pi`, `.claude` directories:
 
-| File | Helper Used | Subpath(s) | Levels |
-|------|-------------|------------|--------|
-| `main.ts` | `findConfigFile` | `SYSTEM.md` | project |
-| `core/sdk.ts` | `getConfigDirPaths` | `auth.json`, `models.json` | user |
-| `core/settings-manager.ts` | `readConfigFile` | `settings.json` | user+project |
-| `core/skills.ts` | `getConfigDirPaths` | `skills/` | user+project |
-| `core/slash-commands.ts` | `getConfigDirPaths` | `commands/` | project |
-| `core/hooks/loader.ts` | `getConfigDirPaths` | `hooks/` | project |
-| `core/custom-tools/loader.ts` | `getConfigDirPaths` | `tools/` | project |
-| `core/custom-commands/loader.ts` | `getConfigDirPaths` | `commands/` | project |
-| `core/plugins/paths.ts` | `getConfigDirPaths` | `plugin-overrides.json` | project |
-| `core/mcp/config.ts` | `getConfigDirPaths` | `mcp.json` | user+project |
-| `core/tools/lsp/config.ts` | `getConfigDirPaths` | `lsp.json`, `.lsp.json` | user+project |
-| `core/tools/task/commands.ts` | `getConfigDirPaths`, `findAllNearestProjectConfigDirs` | `commands/` | user+project |
-| `core/tools/task/discovery.ts` | `getConfigDirs`, `findAllNearestProjectConfigDirs` | `agents/` | user+project |
-| `core/tools/task/model-resolver.ts` | `readConfigFile` | `settings.json` | user |
-| `core/tools/web-search/auth.ts` | `getConfigDirPaths` | `` (root for models.json, auth.json) | user |
+| File                                | Helper Used                                            | Subpath(s)                           | Levels       |
+| ----------------------------------- | ------------------------------------------------------ | ------------------------------------ | ------------ |
+| `main.ts`                           | `findConfigFile`                                       | `SYSTEM.md`                          | project      |
+| `core/sdk.ts`                       | `getConfigDirPaths`                                    | `auth.json`, `models.json`           | user         |
+| `core/settings-manager.ts`          | `readConfigFile`                                       | `settings.json`                      | user+project |
+| `core/skills.ts`                    | `getConfigDirPaths`                                    | `skills/`                            | user+project |
+| `core/slash-commands.ts`            | `getConfigDirPaths`                                    | `commands/`                          | project      |
+| `core/hooks/loader.ts`              | `getConfigDirPaths`                                    | `hooks/`                             | project      |
+| `core/custom-tools/loader.ts`       | `getConfigDirPaths`                                    | `tools/`                             | project      |
+| `core/custom-commands/loader.ts`    | `getConfigDirPaths`                                    | `commands/`                          | project      |
+| `core/plugins/paths.ts`             | `getConfigDirPaths`                                    | `plugin-overrides.json`              | project      |
+| `core/mcp/config.ts`                | `getConfigDirPaths`                                    | `mcp.json`                           | user+project |
+| `core/tools/lsp/config.ts`          | `getConfigDirPaths`                                    | `lsp.json`, `.lsp.json`              | user+project |
+| `core/tools/task/commands.ts`       | `getConfigDirPaths`, `findAllNearestProjectConfigDirs` | `commands/`                          | user+project |
+| `core/tools/task/discovery.ts`      | `getConfigDirs`, `findAllNearestProjectConfigDirs`     | `agents/`                            | user+project |
+| `core/tools/task/model-resolver.ts` | `readConfigFile`                                       | `settings.json`                      | user         |
+| `core/tools/web-search/auth.ts`     | `getConfigDirPaths`                                    | `` (root for models.json, auth.json) | user         |
 
 ## Subpath Summary
 
@@ -107,7 +107,7 @@ Special paths (not under agent/):
 
 These files construct paths manually because they only use the primary config dir:
 
-| File | Current Approach | Reason |
-|------|------------------|--------|
-| `core/logger.ts` | `CONFIG_DIR_NAME` for logs dir | Logs only written to primary (~/.omp/logs/) |
+| File                    | Current Approach                  | Reason                                              |
+| ----------------------- | --------------------------------- | --------------------------------------------------- |
+| `core/logger.ts`        | `CONFIG_DIR_NAME` for logs dir    | Logs only written to primary (~/.omp/logs/)         |
 | `core/plugins/paths.ts` | `CONFIG_DIR_NAME` for plugins dir | Plugins only installed in primary (~/.omp/plugins/) |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "10.3.1",
+	"version": "10.5.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"ompConfig": {
@@ -79,31 +79,36 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@oh-my-pi/omp-stats": "10.3.1",
-		"@oh-my-pi/pi-agent-core": "10.3.1",
-		"@oh-my-pi/pi-ai": "10.3.1",
-		"@oh-my-pi/pi-natives": "10.3.1",
-		"@oh-my-pi/pi-tui": "10.3.1",
-		"@oh-my-pi/pi-utils": "10.3.1",
-		"@openai/agents": "^0.4.4",
+		"@mozilla/readability": "0.6.0",
+		"@oh-my-pi/omp-stats": "10.5.0",
+		"@oh-my-pi/pi-agent-core": "10.5.0",
+		"@oh-my-pi/pi-ai": "10.5.0",
+		"@oh-my-pi/pi-natives": "10.5.0",
+		"@oh-my-pi/pi-tui": "10.5.0",
+		"@oh-my-pi/pi-utils": "10.5.0",
+		"@openai/agents": "^0.4.5",
 		"@sinclair/typebox": "^0.34.48",
 		"ajv": "^8.17.1",
 		"chalk": "^5.6.2",
 		"diff": "^8.0.3",
 		"file-type": "^21.3.0",
-		"glob": "^13.0.0",
+		"glob": "^13.0.1",
 		"handlebars": "^4.7.8",
 		"ignore": "^7.0.5",
+		"jsdom": "28.0.0",
 		"marked": "^17.0.1",
 		"nanoid": "^5.1.6",
 		"node-html-parser": "^7.0.2",
+		"puppeteer": "^24.36.1",
 		"smol-toml": "^1.6.0",
 		"zod": "^4.3.6"
 	},
 	"devDependencies": {
-		"@types/diff": "^8.0.0",
+		"@types/diff": "^7.0.2",
+		"@types/jsdom": "27.0.0",
+		"bun-types": "^1.3.8",
 		"@types/ms": "^2.1.0",
-		"@types/node": "^25.0.10",
+		"@types/bun": "^1.3.8",
 		"ms": "^2.1.3"
 	},
 	"keywords": [

package/src/capability/index.ts

@@ -8,6 +8,12 @@
  */
 import * as os from "node:os";
 import * as path from "node:path";
+
+/** Conditional startup debug prints (stderr) when OMP_DEBUG_STARTUP is set */
+const debugStartup = process.env.OMP_DEBUG_STARTUP
+	? (stage: string) => process.stderr.write(`[startup] ${stage}\n`)
+	: () => {};
+
 import type { Settings } from "../config/settings";
 import { clearCache as clearFsCache, cacheStats as fsCacheStats, invalidate as invalidateFs } from "./fs";
 import type {
@@ -109,9 +115,12 @@ async function loadImpl<T>(
 	const results = await Promise.all(
 		providers.map(async provider => {
 			try {
+				debugStartup(`capability:${capability.id}:${provider.id}:start`);
 				const result = await provider.load(ctx);
+				debugStartup(`capability:${capability.id}:${provider.id}:done`);
 				return { provider, result };
 			} catch (error) {
+				debugStartup(`capability:${capability.id}:${provider.id}:error`);
 				return { provider, error };
 			}
 		}),

package/src/cli/args.ts

@@ -3,7 +3,7 @@
  */
 import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import chalk from "chalk";
-import { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR } from "../config";
+import { APP_NAME, CONFIG_DIR_NAME } from "../config";
 import { BUILTIN_TOOLS } from "../tools";
 
 export type Mode = "text" | "json" | "rpc";
@@ -286,7 +286,7 @@ ${chalk.bold("Environment Variables:")}
   PERPLEXITY_API_KEY      - Perplexity search API key
 
   ${chalk.dim("# Configuration")}
-  ${ENV_AGENT_DIR.padEnd(23)} - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)
+  OMP_CODING_AGENT_DIR    - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)
 
 ${chalk.bold("Available Tools (all enabled by default):")}
   read       - Read file contents

package/src/cli/update-cli.ts

@@ -7,7 +7,6 @@
 import { execSync, spawnSync } from "node:child_process";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { isEnoent } from "@oh-my-pi/pi-utils";
 import chalk from "chalk";
@@ -200,8 +199,7 @@ async function updateViaBinary(release: ReleaseInfo): Promise<void> {
 	}
 
 	const fileStream = fs.createWriteStream(tempPath, { mode: 0o755 });
-	const nodeStream = Readable.fromWeb(response.body as import("stream/web").ReadableStream);
-	await pipeline(nodeStream, fileStream);
+	await pipeline(response.body, fileStream);
 
 	// Download native addon
 	console.log(chalk.dim(`Downloading ${nativeAddonName}...`));
@@ -212,8 +210,7 @@ async function updateViaBinary(release: ReleaseInfo): Promise<void> {
 	}
 
 	const nativeFileStream = fs.createWriteStream(nativeTempPath, { mode: 0o755 });
-	const nativeNodeStream = Readable.fromWeb(nativeResponse.body as import("stream/web").ReadableStream);
-	await pipeline(nativeNodeStream, nativeFileStream);
+	await pipeline(nativeResponse.body, nativeFileStream);
 
 	// Replace current binary
 	console.log(chalk.dim("Installing update..."));

package/src/config/settings-schema.ts

@@ -358,6 +358,24 @@ export const SETTINGS_SCHEMA = {
 			description: "Enable the calculator tool for basic calculations",
 		},
 	},
+	"browser.enabled": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "tools",
+			label: "Enable Browser",
+			description: "Enable the browser tool (Ulixee Hero)",
+		},
+	},
+	"browser.headless": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "tools",
+			label: "Browser headless",
+			description: "Launch browser in headless mode (disable to show browser UI)",
+		},
+	},
 
 	// ─────────────────────────────────────────────────────────────────────────
 	// Startup settings

package/src/config.ts

@@ -22,9 +22,6 @@ const priorityList = [
 	{ dir: ".gemini" },
 ];
 
-// e.g., OMP_CODING_AGENT_DIR
-export const ENV_AGENT_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_DIR`;
-
 // =============================================================================
 // Package Directory (for optional external docs/examples)
 // =============================================================================
@@ -56,7 +53,7 @@ export function getChangelogPath(): string {
 
 /** Get the agent config directory (e.g., ~/.omp/agent/) */
 export function getAgentDir(): string {
-	return process.env[ENV_AGENT_DIR] || path.join(os.homedir(), CONFIG_DIR_NAME, "agent");
+	return process.env.OMP_CODING_AGENT_DIR || path.join(os.homedir(), CONFIG_DIR_NAME, "agent");
 }
 
 /** Get path to user's custom themes directory */

package/src/extensibility/custom-tools/types.ts

@@ -147,7 +147,12 @@ export interface CustomTool<TParams extends TSchema = TSchema, TDetails = any> {
 	renderCall?: (args: Static<TParams>, theme: Theme) => Component;
 
 	/** Custom rendering for tool result display - return a Component */
-	renderResult?: (result: CustomToolResult<TDetails>, options: RenderResultOptions, theme: Theme) => Component;
+	renderResult?: (
+		result: CustomToolResult<TDetails>,
+		options: RenderResultOptions,
+		theme: Theme,
+		args?: Static<TParams>,
+	) => Component;
 }
 
 /** Factory function that creates a custom tool or array of tools */

package/src/extensibility/custom-tools/wrapper.ts

@@ -1,34 +1,25 @@
 /**
  * CustomToolAdapter wraps CustomTool instances into AgentTool for use with the agent.
  */
-import type { AgentTool, AgentToolResult, AgentToolUpdateCallback, RenderResultOptions } from "@oh-my-pi/pi-agent-core";
-import type { Component } from "@oh-my-pi/pi-tui";
+import type { AgentTool, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
 import type { Static, TSchema } from "@sinclair/typebox";
 import type { Theme } from "../../modes/theme/theme";
+import { applyToolProxy } from "../tool-proxy";
 import type { CustomTool, CustomToolContext, LoadedCustomTool } from "./types";
 
 export class CustomToolAdapter<TParams extends TSchema = TSchema, TDetails = any, TTheme extends Theme = Theme>
 	implements AgentTool<TParams, TDetails, TTheme>
 {
+	declare name: string;
+	declare label: string;
+	declare description: string;
+	declare parameters: TParams;
+
 	constructor(
 		private tool: CustomTool<TParams, TDetails>,
 		private getContext: () => CustomToolContext,
-	) {}
-
-	get name() {
-		return this.tool.name;
-	}
-
-	get label() {
-		return this.tool.label;
-	}
-
-	get description() {
-		return this.tool.description;
-	}
-
-	get parameters() {
-		return this.tool.parameters;
+	) {
+		applyToolProxy(tool, this);
 	}
 
 	execute(
@@ -41,16 +32,6 @@ export class CustomToolAdapter<TParams extends TSchema = TSchema, TDetails = any
 		return this.tool.execute(toolCallId, params, onUpdate, context ?? this.getContext(), signal);
 	}
 
-	/** Optional custom rendering for tool call display (returns UI component) */
-	renderCall(args: Static<TParams>, theme: TTheme): Component | undefined {
-		return this.tool.renderCall?.(args, theme);
-	}
-
-	/** Optional custom rendering for tool result display (returns UI component) */
-	renderResult(result: AgentToolResult<TDetails>, options: RenderResultOptions, theme: TTheme): Component | undefined {
-		return this.tool.renderResult?.(result, options, theme);
-	}
-
 	/**
 	 * Backward-compatible export of factory function for existing callers.
 	 * Prefer CustomToolAdapter constructor directly.

package/src/extensibility/extensions/types.ts

@@ -255,7 +255,12 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
 	renderCall?: (args: Static<TParams>, theme: Theme) => Component;
 
 	/** Custom rendering for tool result display */
-	renderResult?: (result: AgentToolResult<TDetails>, options: ToolRenderResultOptions, theme: Theme) => Component;
+	renderResult?: (
+		result: AgentToolResult<TDetails>,
+		options: ToolRenderResultOptions,
+		theme: Theme,
+		args?: Static<TParams>,
+	) => Component;
 }
 
 // ============================================================================

package/src/extensibility/extensions/wrapper.ts

@@ -5,6 +5,7 @@ import type { AgentTool, AgentToolContext, AgentToolUpdateCallback } from "@oh-m
 import type { ImageContent, TextContent } from "@oh-my-pi/pi-ai";
 import type { Static, TSchema } from "@sinclair/typebox";
 import type { Theme } from "../../modes/theme/theme";
+import { applyToolProxy } from "../tool-proxy";
 import type { ExtensionRunner } from "./runner";
 import type { RegisteredTool, ToolCallEventResult, ToolResultEventResult } from "./types";
 
@@ -12,20 +13,16 @@ import type { RegisteredTool, ToolCallEventResult, ToolResultEventResult } from
  * Adapts a RegisteredTool into an AgentTool.
  */
 export class RegisteredToolAdapter implements AgentTool<any, any, any> {
-	readonly name: string;
-	readonly label: string;
-	readonly description: string;
-	readonly parameters: any;
+	declare name: string;
+	declare description: string;
+	declare parameters: any;
+	declare label: string;
 
 	constructor(
 		private registeredTool: RegisteredTool,
 		private runner: ExtensionRunner,
 	) {
-		const { definition } = registeredTool;
-		this.name = definition.name;
-		this.label = definition.label || "";
-		this.description = definition.description;
-		this.parameters = definition.parameters;
+		applyToolProxy(registeredTool.definition, this);
 	}
 
 	async execute(
@@ -42,11 +39,12 @@ export class RegisteredToolAdapter implements AgentTool<any, any, any> {
 		return this.registeredTool.definition.renderCall?.(args, theme as Theme);
 	}
 
-	renderResult?(result: any, options: any, theme: any) {
+	renderResult?(result: any, options: any, theme: any, args?: any) {
 		return this.registeredTool.definition.renderResult?.(
 			result,
 			{ expanded: options.expanded, isPartial: options.isPartial, spinnerFrame: options.spinnerFrame },
 			theme as Theme,
+			args,
 		);
 	}
 }
@@ -73,35 +71,25 @@ export function wrapRegisteredTools(registeredTools: RegisteredTool[], runner: E
 export class ExtensionToolWrapper<TParameters extends TSchema = TSchema, TDetails = unknown>
 	implements AgentTool<TParameters, TDetails>
 {
-	renderCall?: AgentTool<TParameters, TDetails>["renderCall"];
-	renderResult?: AgentTool<TParameters, TDetails>["renderResult"];
-	mergeCallAndResult?: boolean;
-	inline?: boolean;
+	declare name: string;
+	declare description: string;
+	declare parameters: TParameters;
+	declare label: string;
 
 	constructor(
 		private tool: AgentTool<TParameters, TDetails>,
 		private runner: ExtensionRunner,
 	) {
-		this.renderCall = tool.renderCall;
-		this.renderResult = tool.renderResult;
-		this.mergeCallAndResult = (tool as { mergeCallAndResult?: boolean }).mergeCallAndResult;
-		this.inline = (tool as { inline?: boolean }).inline;
+		applyToolProxy(tool, this);
 	}
 
-	get name(): string {
-		return this.tool.name;
-	}
-
-	get label(): string {
-		return this.tool.label ?? "";
-	}
-
-	get description(): string {
-		return this.tool.description;
-	}
-
-	get parameters(): TParameters {
-		return this.tool.parameters;
+	/**
+	 * Forward browser mode changes when available.
+	 */
+	restartForModeChange(): Promise<void> {
+		const target = this.tool as { restartForModeChange?: () => Promise<void> };
+		if (!target.restartForModeChange) return Promise.resolve();
+		return target.restartForModeChange();
 	}
 
 	async execute(

package/src/extensibility/hooks/tool-wrapper.ts

@@ -3,6 +3,7 @@
  */
 import type { AgentTool, AgentToolContext, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
 import type { Static, TSchema } from "@sinclair/typebox";
+import { applyToolProxy } from "../tool-proxy";
 import type { HookRunner } from "./runner";
 import type { ToolCallEventResult, ToolResultEventResult } from "./types";
 
@@ -17,27 +18,16 @@ import type { ToolCallEventResult, ToolResultEventResult } from "./types";
 export class HookToolWrapper<TParameters extends TSchema = TSchema, TDetails = unknown>
 	implements AgentTool<TParameters, TDetails>
 {
-	name: string;
-	label: string;
-	description: string;
-	parameters: TParameters;
-	renderCall?: AgentTool<TParameters, TDetails>["renderCall"];
-	renderResult?: AgentTool<TParameters, TDetails>["renderResult"];
-	mergeCallAndResult?: boolean;
-	inline?: boolean;
+	declare name: string;
+	declare description: string;
+	declare parameters: TParameters;
+	declare label: string;
 
 	constructor(
 		private tool: AgentTool<TParameters, TDetails>,
 		private hookRunner: HookRunner,
 	) {
-		this.name = tool.name;
-		this.label = tool.label ?? "";
-		this.description = tool.description;
-		this.parameters = tool.parameters;
-		this.renderCall = tool.renderCall;
-		this.renderResult = tool.renderResult;
-		this.mergeCallAndResult = (tool as { mergeCallAndResult?: boolean }).mergeCallAndResult;
-		this.inline = (tool as { inline?: boolean }).inline;
+		applyToolProxy(tool, this);
 	}
 
 	async execute(

package/src/extensibility/tool-proxy.ts

@@ -0,0 +1,25 @@
+/**
+ * Defines lazy proxy properties on a wrapper so it forwards to the underlying tool.
+ */
+export function applyToolProxy<TTool extends object>(tool: TTool, wrapper: object): void {
+	const visited = new Set<PropertyKey>();
+	let current: object | null = tool;
+
+	while (current && current !== Object.prototype) {
+		for (const key of Reflect.ownKeys(current)) {
+			if (key === "constructor" || visited.has(key) || key in wrapper) {
+				continue;
+			}
+			visited.add(key);
+			Object.defineProperty(wrapper, key, {
+				get() {
+					const value = (tool as Record<PropertyKey, unknown>)[key];
+					return typeof value === "function" ? value.bind(tool) : value;
+				},
+				enumerable: true,
+				configurable: true,
+			});
+		}
+		current = Object.getPrototypeOf(current);
+	}
+}

package/src/index.ts

@@ -239,6 +239,7 @@ export {
 // Tools (detail types and utilities)
 export {
 	type BashToolDetails,
+	type BrowserToolDetails,
 	DEFAULT_MAX_BYTES,
 	DEFAULT_MAX_LINES,
 	type FindOperations,