Create a Client Tool

Scaffold a new AtlasTool named $ARGUMENTS and wire it into the app.

Prerequisite

integrate-atlas-chat must already be complete: the app should vend the atlas-agent sources under src/atlas-agent/ (including react.ts) and have @sinclair/typebox, ajv, and ajv-formats installed as in that skill.

Background

Client tools let the Atlas Agent invoke logic that runs in the browser — rendering charts, querying local state, showing UI panels, triggering navigation, etc. The agent decides when to call the tool; the app executes it and returns a result.

The flow is:

1. Agent responds with a clientTool action
2. The library validates the arguments against the TypeBox schema
3. execute() runs in the browser and returns { output, details }
4. output (string) is sent back to the agent as the tool result