@oh-my-pi/pi-coding-agent 3.20.1 → 3.24.0

package/CHANGELOG.md

@@ -2,7 +2,98 @@
 
 ## [Unreleased]
 
+## [3.24.0] - 2026-01-07
+### Added
+
+- Added `ToolSession` interface to unify tool creation with session context including cwd, UI availability, and rulebook rules
+- Added Bun Worker-based execution for subagent tasks, replacing subprocess spawning for improved performance and event streaming
+- Added `toolNames` option to filter which built-in tools are included in agent sessions
+- Added `BUILTIN_TOOLS` registry constant for programmatic access to available tool factories
+- Added unit tests for `createTools` function covering tool filtering and conditional tool creation
+
+### Changed
+
+- Changed subagent execution from spawning separate `omp` processes to running in Bun Workers with direct event streaming
+- Changed tool factories to accept `ToolSession` parameter instead of separate cwd and options arguments
+- Changed `createTools` to return tools as a Map and support conditional tool creation based on session context
+- Changed system prompt builder to dynamically generate tool descriptions from the tool registry
+- Changed task tool description to be generated from a template with dynamic agent list injection
+- Changed tool creation to use a unified `ToolSession` interface instead of separate parameters for cwd, options, and callbacks
+- Changed `createTools` to return tools as a Map instead of an array for consistent tool registry access
+- Changed system prompt builder to receive tool registry Map for dynamic tool description generation
+- Changed subprocess usage tracking to accumulate incrementally from message_end events rather than parsing stored events after completion
+
+### Removed
+
+- Removed `browser` embedded agent from task tool agent discovery
+- Removed `recursive` property from agent definitions
+- Removed environment variables `OMP_NO_SUBAGENTS`, `OMP_BLOCKED_AGENT`, and `OMP_SPAWNS` for subagent control
+- Removed pre-instantiated tool exports (`readTool`, `bashTool`, `editTool`, `writeTool`, `grepTool`, `findTool`, `lsTool`) in favor of factory functions
+- Removed `createCodingTools` and `createReadOnlyTools` helper functions
+- Removed `codingTools` and `readOnlyTools` convenience exports
+- Removed `wrapToolsWithExtensions` function from extensions API
+- Removed `hidden` property support from custom tools
+- Removed subagent and question custom tool examples
+
+### Fixed
+
+- Fixed memory accumulation in task subprocess by streaming events directly to disk instead of storing in memory
+- Fixed session persistence to exclude transient streaming data (partialJson, jsonlEvents) that was causing unnecessary storage bloat
+- Fixed createTools respecting explicit tool lists instead of returning all non-hidden tools
+
+## [3.21.0] - 2026-01-06
+
+### Changed
+
+- Switched from local `@oh-my-pi/pi-ai` to upstream `@mariozechner/pi-ai` package
+
+### Added
+
+- Added `webSearchProvider` setting to override auto-detection priority (Exa > Perplexity > Anthropic)
+- Added `imageProvider` setting to override auto-detection priority (OpenRouter > Gemini)
+- Added `git.enabled` setting to enable/disable the structured git tool
+- Added `offset` and `limit` parameters to Output tool for paginated reading of large outputs
+- Added provider fallback chain for web search that tries all configured providers before failing
+- Added `WebSearchProviderError` class with HTTP status for actionable provider error messages
+- Added bash interceptor rule to block git commands when structured git tool is enabled
+- Added validation requiring `message` parameter for git commit operations (prevents interactive editor)
+- Added output ID hints in multi-agent Task results pointing to Output tool for full logs
+- Added fuzzy matching support for `all: true` mode in edit tool, enabling replacement of similar text blocks with whitespace differences
+- Added `all` parameter to edit tool for replacing all occurrences instead of requiring unique matches
+- Added OpenRouter support for image generation when `OPENROUTER_API_KEY` is set
+- Added ImageMagick fallback for image processing when sharp module is unavailable
+- Added slash commands to the extensions inspector panel for visibility and management
+- Added support for file-based slash commands from `commands/` directories
+- Added `$ARGUMENTS` placeholder for slash command argument substitution, aligning with Claude and Codex conventions
+
+### Changed
+
+- Refactored tool renderers to be co-located with their respective tool implementations for improved code organization
+- Changed web search to try all configured providers in sequence with fallback before reporting errors
+- Changed default Anthropic web search model from `claude-sonnet-4-5-20250514` to `claude-haiku-4-5`
+- Changed read tool to show first 50KB of oversized lines instead of directing users to bash sed
+- Changed web_fetch to use `Bun.which()` instead of spawning `which`/`where` for command detection
+- Changed web_fetch to check Content-Length header before downloading to reject oversized files early
+- Changed generate_image tool to save images to temp files and report paths instead of inline base64
+- Changed system prompt with tool usage guidance (ground answers with tools, minimize context, iterate on results)
+- Changed Task tool prompt with plan-then-execute guidance and output tool hints
+- Changed edit tool success message to report count when replacing multiple occurrences with `all: true`
+- Changed default image generation model to `gemini-3-pro-image-preview`
+- Changed error message for multiple occurrences to suggest using `all: true` option
+- Changed web_fetch tool label from `web_fetch` to `Web Fetch` for improved display
+- Changed argument substitution order in slash commands to process positional args ($1, $2) before wildcards ($@, $ARGUMENTS) to prevent re-substitution issues
+- Changed image tool name from `gemini_image` to `generate_image` with label `GenerateImage`
+
+### Fixed
+
+- Fixed read tool markitdown truncation message using broken template string (missing `${` around format call)
+- Fixed web_fetch URL normalization order to run before special handlers
+- Fixed TUI image display for generate_image tool by sourcing images from details.images in addition to content blocks
+- Fixed context file preview in inspector panel to display content correctly instead of attempting async file reads
+- Fixed Linux ARM64 installs failing on fresh Debian when the `sharp` module is unavailable during session image compression
+
 ## [3.20.1] - 2026-01-06
+
 ### Fixed
 
 - Fixed find tool failing to match patterns with path separators (e.g., `reports/**`) by enabling full-path matching in fd
@@ -13,6 +104,7 @@
 - Changed ls tool to show relative modification times (e.g., "2d ago", "just now") for each entry
 
 ## [3.20.0] - 2026-01-06
+
 ### Added
 
 - Added extensions API with auto-discovery (`.omp/extensions`) and `--extension`/`-e` loading for custom tools, commands, and lifecycle hooks
@@ -152,6 +244,7 @@
 - Fixed session persistence to truncate oversized entries before writing JSONL to prevent out-of-memory errors
 
 ## [3.14.0] - 2026-01-04
+
 ### Added
 
 - Added `getUsageStatistics()` method to SessionManager for tracking cumulative token usage and costs across session messages
@@ -176,6 +269,7 @@
 - Fixed stale diagnostics persisting after file content changes in LSP client
 
 ## [3.8.1337] - 2026-01-04
+
 ### Added
 
 - Added automatic browser opening after exporting session to HTML
@@ -186,6 +280,7 @@
 - Fixed session titles not persisting to file when set before first flush
 
 ## [3.7.1337] - 2026-01-04
+
 ### Added
 
 - Added `EditMatchError` class for structured error handling in edit operations
@@ -244,6 +339,7 @@
 - Updated version update notification to suggest `omp update` instead of manual npm install command
 
 ## [3.1.1337] - 2026-01-03
+
 ### Added
 
 - Added `spawns` frontmatter field for agent definitions to control which sub-agents can be spawned
@@ -262,7 +358,7 @@
 - Added Discovery settings tab in interactive mode to enable/disable individual configuration providers
 - Added provider source attribution showing which tool contributed each configuration item
 - Added support for Cursor MDC rule format with frontmatter (description, globs, alwaysApply)
-- Added support for Windsurf rules from .windsurf/rules/*.md and global_rules.md
+- Added support for Windsurf rules from .windsurf/rules/\*.md and global_rules.md
 - Added support for Cline rules from .clinerules file or directory
 - Added support for GitHub Copilot instructions with applyTo glob patterns
 - Added support for Gemini extensions and system.md customization files
@@ -299,6 +395,7 @@
 - Removed separate asset copying steps from build scripts
 
 ## [2.0.1337] - 2026-01-03
+
 ### Added
 
 - Added shell environment snapshot to preserve user aliases, functions, and shell options when executing bash commands
@@ -311,6 +408,7 @@
 - Changed Edit tool to reject `.ipynb` files with guidance to use NotebookEdit tool instead
 
 ## [1.500.0] - 2026-01-03
+
 ### Added
 
 - Added provider tabs to model selector with Tab/Arrow navigation for filtering models by provider
@@ -372,6 +470,7 @@
 - Fixed Task tool showing "done + succeeded" when aborted; now correctly displays "⊘ aborted" status
 
 ## [1.341.0] - 2026-01-03
+
 ### Added
 
 - Added interruptMode setting to control when queued messages are processed during tool execution.
@@ -587,7 +686,7 @@ See [docs/custom-tools.md](docs/custom-tools.md) and [examples/custom-tools/](ex
 - `AppMessage` → `AgentMessage`
 - `sessionFile` returns `string | undefined` (was `string | null`)
 - `model` returns `Model | undefined` (was `Model | null`)
-- `Attachment` type removed. Use `ImageContent` from `@oh-my-pi/pi-ai` instead. Add images directly to message content arrays.
+- `Attachment` type removed. Use `ImageContent` from `@mariozechner/pi-ai` instead. Add images directly to message content arrays.
 
 **AgentSession API:**
 
@@ -813,7 +912,7 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
   - `createAgentSession()` now accepts `authStorage` and `modelRegistry` options
   - Removed `configureOAuthStorage()`, `defaultGetApiKey()`, `findModel()`, `discoverAvailableModels()`
   - Removed `getApiKey` callback option (use `AuthStorage.setRuntimeApiKey()` for runtime overrides)
-  - Use `getModel()` from `@oh-my-pi/pi-ai` for built-in models, `modelRegistry.find()` for custom models + built-in models
+  - Use `getModel()` from `@mariozechner/pi-ai` for built-in models, `modelRegistry.find()` for custom models + built-in models
   - See updated [SDK documentation](docs/sdk.md) and [README](README.md)
 
 - **Settings changes**: Removed `apiKeys` from `settings.json`. Use `auth.json` instead. ([#296](https://github.com/badlogic/pi-mono/issues/296))
@@ -1116,7 +1215,7 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
   - `rpc.md`: Added missing `hook_error` event documentation
   - `README.md`: Complete settings table, condensed philosophy section, standardized OAuth docs
 
-- Hooks loader now supports same import aliases as custom tools (`@sinclair/typebox`, `@oh-my-pi/pi-ai`, `@oh-my-pi/pi-tui`, `@oh-my-pi/pi-coding-agent`).
+- Hooks loader now supports same import aliases as custom tools (`@sinclair/typebox`, `@mariozechner/pi-ai`, `@oh-my-pi/pi-tui`, `@oh-my-pi/pi-coding-agent`).
 
 ### Breaking Changes
 
@@ -1138,7 +1237,7 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
 
 - Fixed TUI performance regression caused by Box component lacking render caching. Built-in tools now use Text directly (like v0.22.5), and Box has proper caching for custom tool rendering.
 
-- Fixed custom tools failing to load from `~/.omp/agent/tools/` when omp is installed globally. Module imports (`@sinclair/typebox`, `@oh-my-pi/pi-tui`, `@oh-my-pi/pi-ai`) are now resolved via aliases.
+- Fixed custom tools failing to load from `~/.omp/agent/tools/` when omp is installed globally. Module imports (`@sinclair/typebox`, `@oh-my-pi/pi-tui`, `@mariozechner/pi-ai`) are now resolved via aliases.
 
 ## [0.23.0] - 2025-12-17
 
@@ -1178,7 +1277,7 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
 
 - **Tool output display**: When collapsed, tool output now shows the last N lines instead of the first N lines, making streaming output more useful.
 
-- Updated `@oh-my-pi/pi-ai` with X-Initiator header support for GitHub Copilot, ensuring agent calls are not deducted from quota. ([#200](https://github.com/badlogic/pi-mono/pull/200) by [@kim0](https://github.com/kim0))
+- Updated `@mariozechner/pi-ai` with X-Initiator header support for GitHub Copilot, ensuring agent calls are not deducted from quota. ([#200](https://github.com/badlogic/pi-mono/pull/200) by [@kim0](https://github.com/kim0))
 
 ### Fixed
 
@@ -1190,7 +1289,7 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
 
 ### Changed
 
-- Updated `@oh-my-pi/pi-ai` with interleaved thinking enabled by default for Anthropic Claude 4 models.
+- Updated `@mariozechner/pi-ai` with interleaved thinking enabled by default for Anthropic Claude 4 models.
 
 ## [0.22.1] - 2025-12-15
 
@@ -1198,7 +1297,7 @@ _Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_
 
 ### Changed
 
-- Updated `@oh-my-pi/pi-ai` with interleaved thinking support for Anthropic models.
+- Updated `@mariozechner/pi-ai` with interleaved thinking support for Anthropic models.
 
 ## [0.22.0] - 2025-12-15
 

package/docs/custom-tools.md

@@ -65,8 +65,8 @@ Tools must be in a subdirectory with an `index.ts` entry point:
 
 | Location                            | Scope                 | Auto-discovered |
 | ----------------------------------- | --------------------- | --------------- |
-| `~/.omp/agent/tools/*/index.ts`      | Global (all projects) | Yes             |
-| `.omp/tools/*/index.ts`              | Project-local         | Yes             |
+| `~/.omp/agent/tools/*/index.ts`     | Global (all projects) | Yes             |
+| `.omp/tools/*/index.ts`             | Project-local         | Yes             |
 | `settings.json` `customTools` array | Configured paths      | Yes             |
 | `--tool <path>` CLI flag            | One-off/debugging     | No              |
 
@@ -94,7 +94,7 @@ Custom tools can import from these packages:
 | --------------------------- | --------------------------------------------------------- | --------------------------------------------------- |
 | `@sinclair/typebox`         | Schema definitions (`Type.Object`, `Type.String`, etc.)   | Via `pi.typebox.*` (injected)                       |
 | `@oh-my-pi/pi-coding-agent` | Types and utilities                                       | Via `pi.pi.*` (injected) or direct import for types |
-| `@oh-my-pi/pi-ai`           | AI utilities (`StringEnum` for Google-compatible enums)   | Via `pi.pi.*` (re-exported through coding-agent)    |
+| `@mariozechner/pi-ai`       | AI utilities (`StringEnum` for Google-compatible enums)   | Via `pi.pi.*` (re-exported through coding-agent)    |
 | `@oh-my-pi/pi-tui`          | TUI components (`Text`, `Box`, etc. for custom rendering) | Via `pi.pi.*` (re-exported through coding-agent)    |
 
 Node.js built-in modules (`node:fs`, `node:path`, etc.) are also available.