79 lines
2.0 KiB
Markdown
79 lines
2.0 KiB
Markdown
# Agent Runbook
|
|
|
|
This app is already prepared for one-shot deployment. Follow these commands exactly unless one fails.
|
|
|
|
Do not add this repo to a parent workspace. Do not move it into `artifacts/`. Do not edit source files. Do not edit `package.json`. Do not create `config.json` or a `/tmp` config file for deployment. Do not inspect or free unrelated ports.
|
|
|
|
## Replit
|
|
|
|
The repo includes `.replit`, so after import the Run button starts the app with:
|
|
|
|
```bash
|
|
pnpm dev
|
|
```
|
|
|
|
The `.replit` `onBoot` command installs dependencies with:
|
|
|
|
```bash
|
|
pnpm install --ignore-workspace
|
|
```
|
|
|
|
## Install
|
|
|
|
Run from this repository root:
|
|
|
|
```bash
|
|
pnpm install --ignore-workspace
|
|
```
|
|
|
|
Use the available `pnpm`. This repo intentionally has no `packageManager` pin.
|
|
|
|
## Start
|
|
|
|
```bash
|
|
pnpm dev
|
|
```
|
|
|
|
When Replit AI Integrations are provisioned, the app reads these variables automatically:
|
|
|
|
- `AI_INTEGRATIONS_OPENAI_BASE_URL`
|
|
- `AI_INTEGRATIONS_OPENAI_API_KEY`
|
|
- `AI_INTEGRATIONS_ANTHROPIC_BASE_URL`
|
|
- `AI_INTEGRATIONS_ANTHROPIC_API_KEY`
|
|
|
|
Provider CLI flags are still supported for manual overrides:
|
|
|
|
```bash
|
|
pnpm dev -- \
|
|
--openai-base-url "<ai-integrations-openai-base-url>" \
|
|
--openai-api-key "<ai-integrations-openai-api-key>" \
|
|
--anthropic-base-url "<ai-integrations-anthropic-base-url>" \
|
|
--anthropic-api-key "<ai-integrations-anthropic-api-key>"
|
|
```
|
|
|
|
Use Replit AI Integrations endpoints only. Never use public official provider endpoints. Do not print provider tokens.
|
|
|
|
## Defaults
|
|
|
|
- host: `0.0.0.0`
|
|
- port: `3000`
|
|
- bearer token: `dev-proxy-key`
|
|
|
|
These can be overridden with CLI flags or environment variables:
|
|
|
|
- `--host` or `HOST`
|
|
- `--port` or `PORT`
|
|
- `--proxy-api-key` or `PROXY_API_KEY`
|
|
|
|
## Verify
|
|
|
|
```bash
|
|
curl -s http://localhost:3000/api/healthz
|
|
curl -s http://localhost:3000/dashboard | head
|
|
curl -s -H "Authorization: Bearer dev-proxy-key" http://localhost:3000/v1/models
|
|
```
|
|
|
|
Expected without provider flags: dashboard, health, and model list work; chat completions return `503`.
|
|
|
|
Report only the local URL and verification results.
|