# Tangle

Tangle builds infrastructure for AI services: model routing, sandboxed agent runtime, browser automation, Blueprint services, and x402 payment rails.

## Agent entry points

- Marketing overview: https://tangle.tools/
- Product docs: https://docs.tangle.tools/
- Router: https://router.tangle.tools/
- Sandbox app: https://sandbox.tangle.tools/
- Agent Builder: https://agents.tangle.tools/
- Browser Agent product page: https://tangle.tools/services/browser-agent
- Sandbox product page: https://tangle.tools/services/sandbox
- Blueprint Agent product page: https://tangle.tools/services/blueprint-agent
- Browser Agent manifest: https://tangle.tools/.well-known/tangle-browser-agent.json

## Installable packages

Do not install unscoped npm packages named `tcloud` or `bad`; they are not Tangle packages.

```bash
npm install @tangle-network/tcloud
npm install @tangle-network/sandbox
npm install -g @tangle-network/browser-agent-driver
```

Package purpose:

- `@tangle-network/tcloud`: Router SDK and CLI for model routing, billing headers, and agent service calls.
- `@tangle-network/sandbox`: TypeScript SDK for isolated agent sandboxes.
- `@tangle-network/browser-agent-driver`: Browser automation driver and CLI (`bad`).

## Programmatic contracts

- Router OpenAPI: https://router.tangle.tools/openapi.json
- Router agent manifest: https://router.tangle.tools/.well-known/tangle-agent.json
- Sandbox agent manifest: https://sandbox.tangle.tools/.well-known/tangle-agent.json
- Agent Builder OpenAPI: https://agents.tangle.tools/openapi.json
- Agent Builder manifest: https://agents.tangle.tools/.well-known/tangle-agent.json
- Browser Agent manifest: https://tangle.tools/.well-known/tangle-browser-agent.json
- Tangle product manifest: https://tangle.tools/.well-known/tangle-agent.json

## First action for coding agents

1. Read this file and the relevant product manifest.
2. Install only scoped Tangle packages.
3. Use `TANGLE_API_KEY` for authenticated calls.
4. Prefer non-mutating discovery calls first: `/v1/models`, `/api/health`, `/api/marketplace`.
5. Run one smoke call before generating integration code.

Safe discovery calls:

```bash
curl -fsS https://router.tangle.tools/api/health
curl -fsS https://router.tangle.tools/v1/models
curl -fsS https://tangle.tools/.well-known/tangle-browser-agent.json
curl -fsS https://sandbox.tangle.tools/health
curl -fsS https://sandbox.tangle.tools/.well-known/tangle-agent.json
curl -fsS https://sandbox.tangle.tools/v1/public-templates
curl -fsS https://sandbox.tangle.tools/v1/public-templates/featured
```