> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sudoiq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Node.js client

> JavaScript and TypeScript SDK roadmap for the Agents API

A first-party **Node.js** SDK is **not published yet**.

When it ships, it will mirror the Python surface: **runs**, **tools** (register + execute), **validators**, **tests**, and **feedback**. Until then you can:

<Note>
  Interested in trying the Node.js SDK early? Reach out to the Sudoiq team through your normal support/contact channel and we can coordinate preview access.
</Note>

* Use the [Python client](/clients/python) or [CLI](/clients/cli)
* Call the HTTP API directly (see your OpenAPI or internal route list)

### Adding a tool (future shape)

Expect a pattern similar to Python: **register** tool JSON on the API, then either **stream** a run with app-defined tools or use **webhooks** + tool-result endpoints. Example placeholder:

```typescript theme={"theme":{"light":"github-light","dark":"github-dark"}}
// Coming soon — illustrative only
// await client.tools.registerTools([{ name: "my_tool", namespace: "main", ... }]);
// await client.runAgent({ agentId, inputs, tools: { my_tool: handler } });
export {};
```

See [Register server tools](/tools/register-server-tools) for the HTTP payload shape.