@m4ss/pi-search-delegator

Keep Pi's main context clean: remove web search, fetch, and llms_txt tools from the main model and force delegation to a focused, cheaper searcher subagent

Packages

Package details

extension

Install @m4ss/pi-search-delegator from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@m4ss/pi-search-delegator

Package: @m4ss/pi-search-delegator
Version: 0.2.0
Published: Oct 28, 2026
Downloads: 229/mo · 219/wk
Author: paolobarbolini
License: MIT
Types: extension
Size: 19 KB
Dependencies: 0 dependencies · 2 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

@m4ss/pi-search-delegator

We designed this to keep your main model's context clean. The extension removes staan_search, web_fetch, and llms_txt from the main model and forces it to delegate web research to a focused searcher subagent instead.

The searcher runs headless, does the web work, and returns a compact answer in three sections: Answer, Evidence (each key claim with its source URL and a short quote, so the main model can check it), and Gaps. This keeps the main context uncluttered. This also lets you run the searcher on a cheaper model.

Delegating web work to the searcher:

subagent({
  agent: "searcher",
  task: "Find the latest GDPR NIS2 and AI Act requirements for companies in Europe; return key obligations, dates, source URLs."
})

The main model is told to split independent questions into separate searcher calls and run them in parallel.

curl, wget, and other shell commands are not blocked.

Related packages

@m4ss/pi-staan-search – provides the staan_search tool
@m4ss/pi-web-fetch – provides the web_fetch tool
@m4ss/pi-llms-txt – provides the llms_txt tool

Install

pi install npm:pi-subagents
pi install npm:@m4ss/pi-search-delegator

It creates ~/.pi/agent/agents/searcher.md and blocks the web tools at session start.

Commands

Command	Action
`/search-delegator`	Show current status

Configuration

Config file: ~/.pi/agent/search-delegator.json (missing fields fall back to defaults).

Field	Default	Description
`blocked_tools`	`["staan_search", "web_fetch", "llms_txt"]`	Tool names removed from the main model and granted to the searcher
`searcher_subagent_name`	`"searcher"`	Subagent name (must match the `.md`)
`searcher_model`	`""`	Model for the searcher (`provider/model`). Empty = inherit parent's default. Set a cheap model to keep web research inexpensive
`orchestrator_prompt`	(built-in web-research guidance)	Text sent to the main model at session start, telling it how to delegate to the searcher

The searcher.md template is regenerated whenever the config changes. If you edit searcher.md by hand, your version is detected and left untouched.

Tightening the searcher

~/.pi/agent/agents/searcher.md restricts the child to the tools listed in blocked_tools (by default tools: staan_search, web_fetch, llms_txt). To narrow it further, edit that file, but keep whatever extensions provide those tools loaded.

License

MIT