create-client-tool

Create a Client Tool

Scaffold an AtlasTool named $ARGUMENTS. If the app has no approved in-app useAtlasChat, implement a Fusion action via integrate-fusion-agent instead.

Prerequisite: vendored src/atlas-agent/ and @sinclair/typebox from integrate-atlas-chat.

Background

Client tools let the Atlas Agent invoke browser-side logic — charts, local state, UI panels, navigation. The agent decides when to call; the app executes and returns a result.

1. Agent responds with a clientTool action
2. TypeBox validates the arguments
3. execute() runs in the browser and returns { output, details }
4. output (string) is sent back to the agent
5. details is available on message.toolCalls for the UI to render

---

Step 1 — Understand the codebase