my-pi/pi-tool-search/CHANGELOG.md

Changelog

Unreleased — my-pi maintained source

Changed

• Pinned Pi's built-in codemode (exposure model-only) in alwaysEnabled so batching several tool calls through one script never depends on a tool_search activation; platformToolPolicy now also drops tools with hidden or codemode (script-only) exposure so they can never enter the catalog or the unknown-tools path.
• Removed the PI_TOOL_SEARCH_CONFIG_PATH environment override; the extension reads the bundle config/tool-search.json, and tests inject a path through the createToolSearchExtension({ configPath }) factory.
• Removed the retired context-mode integration: the ctx_execute / ctx_execute_file / ctx_batch_execute pins left alwaysEnabled and the four context-* bundle groups were dropped. Large tool results are now bounded by pi-overflow and recoverable through the pinned overflow_query.
• Imported upstream v0.3.6 at ddfb23646fd3957b791214de278e23aa393c9b13 for direct local maintenance.
• Migrated runtime imports to @earendil-works/pi-coding-agent and current typebox.
• Replaced the hidden steer/retry compatibility loop with current Pi dynamic-tool propagation.
• Replaced the truncated name manifest and add-only lifetime with validated model-generated Tool Cards, workflow groups, and bounded LRU activation.
• Added deterministic no-model fallback grouping, private manifest-hash caching, exact group overrides, lazy /tool-search-rebuild, and nested model usage accounting.
• Added limits for active groups, generated group size, and total dynamic tools, plus current-host catalog/config/LRU tests.
• Added checked-in authoritative groups for every tool exposed by the standard my-pi bundle, eliminating first-use model generation and user caching unless unrecognized third-party tools are present.
• Replaced the Hermes and third-party Hippo assignments with the five tools exposed by the official Hippo Pi extension, grouped into recall and management workflows.
• Replaced the retired Hippo hippo_* assignments with the vendored Hermes memory extension's six tools, grouped into memory-recall (memory_search, session_search, context_tree_query) and memory-management (memory_add, memory_replace, memory_remove, skill_manage).
• Added overflow_query to memory-recall and pinned it in alwaysEnabled — inspecting a pi-overflow-stored original must not depend on a tool_search activation.
• Added the enabled bundle's Agent, get_subagent_result, and steer_subagent tools to a checked-in subagents orchestration group.
• Added authoritative ssh-connection, ssh-remote-files, ssh-remote-search, and ssh-remote-shell groups for the maintained pi-ssh tools, keeping reviewed connection, bounded discovery, structured file operations, and reviewed shell execution separate; the connection workflow now requires sequential ssh_connect to succeed before dependent tools.
• Added sequential ssh_cd to the authoritative remote-shell workflow and direct the model to wait for a successful workspace change before dependent remote calls, avoiding both the unknown-tools fallback and cwd races.
• Added the authoritative user-interaction group for the maintained ask_user_question TUI tool.
• Added authoritative chrome-navigation, chrome-interaction, and chrome-debugging groups for all 21 tools registered by the pinned pi-chrome bridge after explicit session authorization.
• Raised the bundle defaults to five active groups and 28 dynamic tools, and pinned the high-frequency Context Mode execution trio alongside CodeGraph exploration and LSP diagnostics.
• Moved user configuration from the settings.json toolSearch section to the bundle-owned <agent-dir>/my-pi/tool-search/config.json, deployed by the bundle's rebuild script; a missing or invalid file falls back to BUNDLE_TOOL_SEARCH_DEFAULTS. Moved the model-enriched catalog cache to <agent-dir>/my-pi/tool-search/catalog-v1.json.

Removed

• Removed ensureToolSearchDefaults, BUNDLE_TOOL_SEARCH_DEFAULTS_VERSION, bundleDefaultsVersion handling, and all settings.json reads/writes; the bundle deploys config via scripts/rebuild-bundle-config.mjs instead of extension-side seeding or snapshot migration.
• Pinned all six Hermes memory tools in the bundle defaults and raised bundleDefaultsVersion to 3. The injected memory policy expects these schemas every turn, and pinning also keeps the request prefix cache-stable instead of paying a tool_search round trip plus a cache invalidation. scripts/migrate-tool-search-settings.mjs migrates the complete version-2 snapshot with an owner-only backup, atomic replacement, and fail-safe preservation of custom or invalid settings.
• Pinned context_tree_query alongside the memory tools and raised bundleDefaultsVersion to 4. Recovering pruned tool evidence must not depend on a tool_search activation, and the added name keeps the request prefix stable. The migration helper now accepts the complete version-3 snapshot in addition to version 2.
• Added atomic multi-group activation through tool_search.groups, bounded to five exact group ids and rejected without state changes when the complete workflow cannot fit.
• Weighted exact tool names, group metadata, and common SSH/Chrome/Context aliases during query routing; weak or ambiguous matches now return candidates instead of activating arbitrarily.
• Added /tool-search-status for catalog source, capacity, active-group LRU order, and latest eviction diagnostics.
• Added an explicit update.sh migration for the complete former 3/20 bundle-default snapshot, with owner-only backup, atomic replacement, provenance versioning, and fail-safe preservation of custom or invalid user settings.

Fixed

• Treat Pi's optional powershell definition as the same pinned local-shell/core class as bash on Windows, while excluding it from non-Windows catalogs so it cannot become an unknown-tool model group.
• Activate exact existing groups from the current catalog before optional unknown-tool model enrichment, preventing unrelated catalog generation from delaying known group loads.
• Include pinned tools in the optional footer's total-tool denominator.

[0.3.6] - 2026-04-24

Bug Fixes

• Clear footer status when toolSearch.showToolSearchFooterStatus is false, and re-read setting each refresh so settings changes take effect without stale status.
• Add explicit showToolSearchFooterStatus config name with backward compatibility for older status keys.

[0.3.5] - 2026-04-23

Other

• Add pi install npm:pi-tool-search command to README

[0.3.4] - 2026-04-23

Other

• Clarify core defaults and token-saving purpose

[0.3.3] - 2026-04-23

Bug Fixes

• Refresh active tools on every turn_start, not only fresh user prompts, so unlocked tools stay available during agent-loop continuations
• Queue hidden steer hint after successful tool_search so agent can continue/retry without waiting for another user message
• Stop showing visible retry guidance in tool_search results and narrow hidden retry hint so successful same-turn tool calls are not repeated

Other

• Document same-response activation caveat and recovery behavior in README.md

[0.3.2] - 2026-04-23

Bug Fixes

• Split tool_search description into "Already active" and "Hidden" sections so LLM skips redundant enable calls
• Add grep and find to default core tools (always enabled alongside read, write, edit, bash)

[0.3.1] - 2026-04-23

Other

• Add repository field to package.json

0.3.0

• Renamed from pi-lazy-tools to pi-tool-search
• Config key changed: lazyTools → toolSearch in settings.json
• showStatus config option: show/hide N / total tools footer status (default: on)
• Provider-agnostic: removed payload-level filtering, relies solely on setActiveTools
• readUserConfig() consolidates all settings reads into one call

0.2.0

• User config: add "toolSearch": { "alwaysEnabled": ["lsp", "grep"] } to settings.json to pre-unlock tools beyond the defaults
• Reads config at each session_start — no reinstall needed after changes

0.1.0

• Initial release
• Manifest-aware tool_search gate
• names: string[] batch enabling
• Per-turn manifest refresh via before_agent_start