# agent.run() website

The website lives in this repository alongside the DSL. It includes the homepage workflows, animations and original assets, interactive examples, documentation, and Pi extension preview.

## Build and preview

From the repository root, with Node 22.19+:

```sh
npm ci --ignore-scripts
npm run build
npm run build:site
npm run check:site
```

Serve `site/dist` with a static HTTP server. For example, with Python 3:

```sh
python3 -m http.server 4173 --bind 127.0.0.1 --directory site/dist
```

Open <http://localhost:4173>. The preview uses recorded interpreter runs and scripted model responses; no model credentials are needed.

## Where to edit

- `dist/landing.html`, `dist/landing.js`, and the styles and motion scripts contain the homepage presentation. The build copies `landing.html` to `index.html`.
- `dist/assets/` contains the illustrations, videos, and asset provenance manifest.
- `../docs/` and package READMEs supply generated documentation; `../examples/` supplies runnable workflows and playback data.
- `../scripts/build-site.mjs` generates pages, traces, schema copies, and example copies. `PRODUCT.md` and `DESIGN.md` record the product and visual direction.

`dist` contains both authored and generated files: do not delete it as a disposable build directory. Regenerate after source edits and commit the generated changes. The source download under `dist/downloads/` is generated and intentionally ignored by Git.

The deployment directory is `site/dist`. Repository updates do not deploy the website. Public hosting and asset rights remain subject to the [release checklist](../docs/releasing.md).