# 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 PORT=${PORT:-3000} PROXY_API_KEY=${PROXY_API_KEY:-dev-proxy-key} pnpm prod ``` The `.replit` `onBoot` command installs dependencies with: ```bash pnpm install --ignore-workspace ``` For publishing from a workspace that clones this repo into `./random-proxy-simple`, configure the workspace root `.replit` `[deployment]` block to build and run `random-proxy-simple` directly, then create a shell web artifact so the publish UI has a web target. ## Install Run from this repository root: ```bash pnpm install --ignore-workspace ``` Use the available `pnpm`. This repo intentionally has no `packageManager` pin. ## Start ```bash PORT=${PORT:-3000} PROXY_API_KEY=${PROXY_API_KEY:-dev-proxy-key} pnpm prod ``` 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, but mass deployments should use env vars: ```bash pnpm start -- \ --openai-base-url "" \ --openai-api-key "" \ --anthropic-base-url "" \ --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` For mass deployments, pass the generated proxy token through `PROXY_API_KEY`. Replit AI Integration provider values are read from the `AI_INTEGRATIONS_*` environment variables. ## Verify ```bash curl -s http://localhost:3000/api/healthz curl -s http://localhost:3000/dashboard | head curl -s -H "Authorization: Bearer ${PROXY_API_KEY:-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.