<!-- Generated by scripts/build-sdk-docs.mjs from docs/languages/typescript/AGENTS.md. Edit the source, not this copy. -->
<!-- BEGIN:autonoma-agent-rules -->

# Autonoma SDK: read the bundled docs before wiring the endpoint

This package implements the **Autonoma Environment Factory** - a backend endpoint that creates and tears down isolated test data. If you are integrating it, the accurate, version-matched docs ship inside this package. Read them before writing code; your training data may describe an older, adapter-based API that no longer exists.

**Start here:** `./docs/implement.md` (in `node_modules/@autonoma-ai/sdk/docs/implement.md` once installed).

Reading order:

1. `docs/overview.md` - what the Environment Factory is and why it is factory-driven.
2. `docs/implement.md` - step-by-step setup: install, factories, handler, auth, validate.
3. `docs/factories.md` - the `defineFactory` contract in TypeScript.
4. `docs/scenarios.md` - the `create` data format (`_alias`/`_ref`).
5. `docs/protocol.md` - the HTTP wire protocol and error codes.
6. `docs/validation.md` - dry-running scenarios with `checkScenario`.

Key facts that differ from older docs: the SDK is **factory-driven** (register factories with `defineFactory`; there is no `prismaAdapter`/`drizzleAdapter` and no ORM adapter package). The main entry is `handleRequest`, wrapped by a server adapter (`createHandler`, `createExpressHandler`, `createHonoHandler`, `createNodeHandler`). The auth callback returns `{ cookies?, headers?, credentials? }` - there is no `token` field.

<!-- END:autonoma-agent-rules -->
