AGENTS.md

1<!-- Agent tool test performance notes for avoiding heavyweight plugin/channel runtime loads. -->
2 
3# Agent Tools Performance
4 
5Tool tests should not load full channel or plugin runtimes for static tool
6descriptions.
7 
8## Guardrails
9 
10- Message-tool discovery should flow through shared discovery helpers and
11  lightweight channel artifacts before falling back to a full channel plugin
12  load.
13- Channel-specific tool schemas, action lists, and static capabilities belong
14  in plugin-owned helpers that are reused by both the full plugin and the
15  lightweight artifact.
16- Do not add direct bundled-plugin imports to agent tool tests for schema or
17  capability assertions. If the production path needs the same data, promote a
18  small public artifact instead.
19- If a single assertion starts paying multi-second import/setup cost, split the
20  static descriptor path from runtime execution instead of adding more mocks
21  around the broad import.
22 
23## Verification
24 
25- For `src/agents/tools/*.test.ts` performance work, compare targeted file
26  runtime with `pnpm test <file>` before/after.
27- Run `pnpm build` when adding or changing bundled plugin artifacts.
28