@odradekk/vera-search-tools

Cross-platform rg/fd search tools for Vera agent

Package details

← Back
extension

Install @odradekk/vera-search-tools from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@odradekk/vera-search-tools
Package
@odradekk/vera-search-tools
Version
1.5.1
Published
May 5, 2026
Downloads
71/mo · 8/wk
Author
odradekk
License
MIT
Types
extension
Size
45.8 MB
Dependencies
2 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

vera-search-tools

Purpose

Provide fast local workspace search for Pi via bundled rg and fd, plus integrity and runtime diagnostics.

Search results are progressively paged: rg and fd return 5 results by default and expose offset / limit so the agent can continue searching in small slices instead of dumping everything at once. Output footers now include next_offset / use_offset to make continuation explicit.

Non-goals

  • web search, page reading, docs lookup, or PDF parsing
  • session UI, banners, or thinking shortcuts
  • compaction, prompt assembly, or provider compatibility patches
  • silently replacing built-in grep / find contracts that Pi may rely on

Registered surface

Tools

  • rg
  • fd
  • ensure_search_tools
  • check_search_tools
  • verify_search_tools

Commands

  • none intentionally exposed; search-binary maintenance is agent-internal

Hooks

  • session_start — verifies search binary availability and warns when bundled tools are missing or unverified

Config / auth

This package does not require API keys.

It relies on:

  • bundled binaries under bin/
  • integrity metadata in manifest.json
  • optional system rg / fd fallback when bundled binaries are unavailable

External dependencies

  • network access only when the agent runs ensure_search_tools to fetch binaries
  • executable support for the current platform

Smoke

  • npm run smoke
  • from project root: node agent/scripts/smoke-all.mjs

Debugging

  1. Run verify_search_tools to check sha256 status of bundled rg/fd.
  2. Run check_search_tools to see whether Pi is using bundled or system binaries.
  3. If binaries are missing, have the agent run ensure_search_tools.
  4. For package-only verification, run node packages/vera-search-tools/scripts/smoke.mjs.

Loaded through agent/settings.json as ./packages/vera-search-tools.