Lint

Findings from agency lint and the editor (grayed-out code, quick fixes). Lint findings are style and hygiene notices, not errors: the program still compiles and runs, and agency lint exits 0 on hint-level findings so they never fail CI.

AL0001 — '{name}' is imported but never used.

Default severity: hint.

An import brings in a name the file never references. Unused imports add noise and can hide a mistake (an import you meant to use). This is a hint, not an error — the program still compiles and runs. The editor grays the name out and offers "Remove unused import"; agency lint reports it. Names imported from std::index and import test { … } imports are not reported.

AL0002 — '{name}' is exported but has no docstring.

Default severity: hint.

In Agency, functions are tools: an exported function's docstring becomes the tool description the LLM reads when deciding whether and how to call it. An exported function without one gives every agent that imports it a tool with no description. Add a docstring — terse and user-facing, describing what the tool does. A comment above the function does not count: comments never reach the LLM.

AL0003 — '{name}' is already available without an import.

Default severity: hint.

Every Agency file gets the prelude (print, map, filter, range, and the rest) without importing anything, so importing one of those names from std::index is redundant. Not everything in std::index is prelude, though: types like WriteMode must be imported, and an aliased import (map as arrMap) or one carrying a destructive/idempotent marker does real work — none of those are reported.