feat: point Try It panels at localhost with editable port, format all API output

[BunsDev]

What

Server URL → localhost, never docs.opencoven.ai

• OpenAPI servers is now http://localhost:{port}/api/v1 with an editable port variable (default 3000) — the playground server selector renders it as an input (persisted per-reader). 3000 matches the documented daemon standard coven daemon serve --tcp 127.0.0.1:3000.
• Previously the relative /api/coven-proxy/api/v1 server resolved against the docs origin, so hosted pages displayed and targeted https://docs.opencoven.ai/....

Proxy bridge (both app/api/coven-proxy routes + lib/coven-proxy-dial.ts)

• Socket-first dial ($COVEN_HOME/coven.sock), fallback to loopback TCP on the chosen port.
• Playground route validates absolute targets: http: only, loopback hosts only, paths under /api/; legacy /api/coven-proxy-prefixed URLs still work.
• Self-dial guard: if the fallback port is the docs site itself, return a clear 503 daemon_unreachable hint instead of a confusing Next.js 404.

Formatted output everywhere

• Bridge pretty-prints all application/json / +json responses (Try It panels, status banner).
• Code samples: curl pipes | jq .; TS/Python/Rust print pretty JSON (JSON.stringify(...,null,2), json.dumps(indent=2), serde_json::to_string_pretty).

Prose: openapi/index.mdx (port selector, TCP fallback row, jq sanity check), daemon/socket-api.mdx + reference/api.mdx (standard port 3000).

Verified

• npx tsc --noEmit and full pnpm build (all check scripts) green
• Live matrix against dev server + running daemon: socket 200 pretty JSON; legacy and absolute URLs OK; non-loopback / https / non-/api/ → 400
• TCP fallback to a mock daemon → 200 pretty-printed; self-dial → 503 cause:'self' + hint; no listener → 503 ECONNREFUSED
• Regenerated .built.yaml + endpoint MDX via openapi:build (gitignored artifacts)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
coven-docs	Ready	Preview	Jul 21, 2026 11:55pm

[Copilot]

Pull request overview

Updates the docs-site OpenAPI “Try It” experience to target localhost with an editable port, bridge requests to the local daemon (Unix socket first, TCP loopback fallback), and present consistently pretty-printed JSON output across the proxy and generated code samples.

Changes:

• Switch OpenAPI servers to http://localhost:{port}/api/v1 with a port variable defaulting to 3000, and refresh related prose.
• Extend the proxy dialer to attempt $COVEN_HOME/coven.sock first, then fall back to 127.0.0.1:<port> with a self-dial guard and JSON pretty-printing.
• Update generated OpenAPI code samples (curl/TS/Python/Rust) to print formatted JSON output.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
scripts/build-openapi-samples.mjs	Pretty-prints API output in generated code samples (adds jq and language-specific formatting).
openapi/coven.daemon.v1.yaml	Sets localhost server with editable port and refactors repeated event cursor params into reusable components.
lib/coven-proxy-dial.ts	Adds TCP fallback dialing, self-dial avoidance, and JSON response formatting for the proxy bridge.
app/api/coven-proxy/route.ts	Validates absolute loopback targets, extracts port for fallback, and preserves legacy /api/coven-proxy/... behavior.
app/api/coven-proxy/[...path]/route.ts	Passes selfHost into the dialer for self-dial guarding on path-prefix proxy calls.
content/docs/openapi/index.mdx	Documents the server URL/port selector behavior, fallback transport, and jq sanity check.
content/docs/daemon/socket-api.mdx	Updates transport prose and examples to reflect formatted output and standard port 3000.
content/docs/reference/api.mdx	Notes the standard loopback TCP address/port in the reference transport description.