Agent notes

This is a component library, not an application.

Sources live in src/; never edit dist/ or build/ by hand, they are generated.
To validate a change, run npm install and then npm run build. The build must succeed before the library can be consumed by downstream packages.
Use npm install (not --ignore-scripts): the build-metrics dev dependency is fetched from the artifact mirror pinned in package-lock.json and is required by the build preset for provenance recording.
The build only needs Node; there are no external build tools to configure.
Keep component APIs backwards compatible; see src/index.ts for the public surface.