Tool Discovery

Selection quality degrades if every tool is placed in context. Pimsy indexes the catalogue and retrieves a small, high-precision candidate set per step.

Indexing#

• Each tool is embedded from its name, description, parameter semantics and example invocations.
• Tools carry tags (read, write, finance, repo, communication) used as hard filters.
• Historical outcome statistics per step archetype feed the ranking model.
• Deprecated tools remain resolvable but are demoted and annotated with their replacement.

Retrieval budget#

const candidates = await pimsy.tools.search({
  goal: class="tok-str">"post a summary to the incident channel",
  scopes: [class="tok-str">"connector.slack", class="tok-str">"connector.pagerduty"],
  limit: class="tok-num">8
});