Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

serve FE from server (#14)

pranjaltrvdc2ce530483af
diff --git a/packages/server/Dockerfile b/Dockerfile
similarity index 64%
rename from packages/server/Dockerfile
rename to Dockerfile
index 1fee9ba1b..2ba0a69be 100644
--- a/packages/server/Dockerfile
+++ b/Dockerfile
@@ -1,10 +1,9 @@
# syntax=docker/dockerfile:1
#
-# Multi-stage build for @truefoundry/server.
+# Multi-stage build for @truefoundry/server, which also serves the UI: the only image the stack needs.
#
-# The build context must be the repository root (this is a pnpm workspace and
-# the server depends on the workspace package @truefoundry/utils). See the
-# docker-compose.yml / build command at the repo root.
+# Lives at the repository root because the build needs the whole pnpm workspace
+# as its context: the server depends on the workspace package @truefoundry/utils.
#
# Dependency install uses pnpm fetch (lockfile-only) then install --offline so
# the download layer stays cached when only package.json / scripts change.
@@ -17,23 +16,29 @@ RUN corepack enable && pnpm config set store-dir /pnpm/store
WORKDIR /app
# ---------------------------------------------------------------------------
-# builder: install all deps (incl. dev) and build utils + server.
+# store: the pnpm store, from the lockfile only (stable when manifests churn).
# ---------------------------------------------------------------------------
-FROM base AS builder
-# Populate the store from the lockfile only (stable when manifests churn).
+FROM base AS store
COPY pnpm-lock.yaml pnpm-workspace.yaml ./
COPY patches patches
RUN --mount=type=cache,id=pnpm,target=/pnpm/store pnpm fetch
+# ---------------------------------------------------------------------------
+# workspace: install inputs shared by every stage below — the manifests plus the
+# sources the root postinstall hook (build:gen) inlines.
+# ---------------------------------------------------------------------------
+FROM store AS workspace
COPY package.json .npmrc tsconfig.base.json ./
COPY packages/harness/package.json packages/harness/package.json
COPY packages/server/package.json packages/server/package.json
-# Workspace lockfile lists frontend; package.json must exist for install.
COPY packages/frontend/package.json packages/frontend/package.json
-# The root postinstall hook runs build:gen in @truefoundry/utils, which needs
-# the generator script and the sandbox Python sources it inlines.
COPY packages/harness/scripts packages/harness/scripts
COPY packages/harness/src/core/sandbox/scripts packages/harness/src/core/sandbox/scripts
+
+# ---------------------------------------------------------------------------
+# builder: install all deps (incl. dev) and build utils + server.
+# ---------------------------------------------------------------------------
+FROM workspace AS builder
RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
pnpm install --frozen-lockfile --offline --filter @truefoundry/server...
COPY packages/harness packages/harness
@@ -41,20 +46,18 @@ COPY packages/server packages/server
RUN pnpm --filter @truefoundry/utils build && pnpm --filter @truefoundry/server build
# ---------------------------------------------------------------------------
-# prod-deps: resolve only production dependencies (no dev tooling).
+# frontend-builder: build the UI the server serves (parallel to builder above).
# ---------------------------------------------------------------------------
-FROM base AS prod-deps
-COPY pnpm-lock.yaml pnpm-workspace.yaml ./
-COPY patches patches
-RUN --mount=type=cache,id=pnpm,target=/pnpm/store pnpm fetch --prod
+FROM workspace AS frontend-builder
+RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
+ pnpm install --frozen-lockfile --offline --filter frontend...
+COPY packages/frontend packages/frontend
+RUN pnpm --filter frontend build
-COPY package.json .npmrc ./
-COPY packages/harness/package.json packages/harness/package.json
-COPY packages/server/package.json packages/server/package.json
-COPY packages/frontend/package.json packages/frontend/package.json
-# Same as builder: the root postinstall hook needs the build:gen inputs.
-COPY packages/harness/scripts packages/harness/scripts
-COPY packages/harness/src/core/sandbox/scripts packages/harness/src/core/sandbox/scripts
+# ---------------------------------------------------------------------------
+# prod-deps: production dependency tree (no dev tooling), resolved offline.
+# ---------------------------------------------------------------------------
+FROM workspace AS prod-deps
RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
pnpm install --frozen-lockfile --offline --prod --filter @truefoundry/server...
@@ -77,6 +80,10 @@ COPY --from=builder /app/packages/harness/dist ./packages/harness/dist
COPY --from=builder /app/packages/server/package.json ./packages/server/package.json
COPY --from=builder /app/packages/server/dist ./packages/server/dist
+# The UI, at an absolute path so it resolves from any working directory.
+COPY --from=frontend-builder /app/packages/frontend/dist ./packages/frontend/dist
+ENV FRONTEND_DIR=/app/packages/frontend/dist
+
WORKDIR /app/packages/server
# The YAML registry (models.yaml, mcp.yaml, skills.yaml) is read at runtime from
diff --git a/README.md b/README.md
index 60f928c80..ce56b021c 100644
--- a/README.md
+++ b/README.md
@@ -2,11 +2,11 @@
pnpm workspace with:
-| Package | Path | Role |
-| --------------------- | ---------------------------------------- | ------------------------------------------------ |
-| `@truefoundry/utils` | [`packages/harness`](packages/harness) | Published library (`core` + `agent-session`) |
-| `@truefoundry/server` | [`packages/server`](packages/server) | HTTP server (private; depends on utils) |
-| `frontend` | [`packages/frontend`](packages/frontend) | Private draft-only agent chat UI (not published) |
+| Package | Path | Role |
+| --------------------- | ---------------------------------------- | ------------------------------------------------- |
+| `@truefoundry/utils` | [`packages/harness`](packages/harness) | Published library (`core` + `agent-session`) |
+| `@truefoundry/server` | [`packages/server`](packages/server) | HTTP server + UI host (private; depends on utils) |
+| `frontend` | [`packages/frontend`](packages/frontend) | Private draft-only agent chat UI (not published) |
## Develop
@@ -28,27 +28,39 @@ cp packages/server/.env.example packages/server/.env
cp -R packages/server/registry-example packages/server/registry
```
-Fill in `MODEL_API_KEY` in `packages/server/.env`, then start the server:
+Fill in `MODEL_API_KEY` in `packages/server/.env`, then start both dev servers:
```bash
-pnpm dev:server
+pnpm dev # API on :8790 and Vite on :3000, one terminal
```
+| Script | Runs |
+| -------------------- | ------------------------------------------------------ |
+| `pnpm dev` | Both of the below, in parallel |
+| `pnpm dev:server` | API only on `:8790`; never rebuilds the UI |
+| `pnpm dev:frontend` | Vite only on `:3000`, proxying `/api/*` to the API |
+| `pnpm dev:server:ui` | Rebuilds the UI, then the API serves it too on `:8790` |
+
+Open `:3000` for UI work. `:8790` serves the UI only when a build exists in `packages/frontend/dist`.
+
Migrations run automatically on startup. To migrate without starting HTTP:
```bash
pnpm --filter @truefoundry/server migrate
```
-## Run the frontend (local)
+## Work on the UI (local)
-With the server on `:8790`:
+Vite serves the UI from source with hot reload and proxies `/api/*` to `:8790`, so UI edits need no
+rebuild or server restart. `FRONTEND_PORT` moves it off `:3000`, `VITE_SERVER_URL` points it at another
+API. See [`packages/frontend/README.md`](packages/frontend/README.md).
-```bash
-pnpm dev:frontend
-```
+## Serving the UI from the server
-Vite serves the UI on `http://localhost:3000` and proxies `/v1/agents/*` → `/v1/sessions*` plus catalog routes. See [`packages/frontend/README.md`](packages/frontend/README.md).
+Deployments are one process on one origin: `/api/*` (including `/api/v1/docs` and `/api/v1/openapi.json`) and
+`/healthz` are the API, everything else resolves to the UI. `FRONTEND_DIR` points at the build (default
+`../frontend/dist`; the image sets an absolute path). It is not required: with no build there the server
+logs a warning and serves the API only, which is what running the server behind Vite needs.
## Docker Compose
@@ -56,10 +68,9 @@ Vite serves the UI on `http://localhost:3000` and proxies `/v1/agents/*` → `/v
docker compose up --build
```
-Starts Postgres 17 (data in `./data/postgres`), the API, and the frontend. The server waits for Postgres to be healthy, runs migrations, then listens.
-
-- API: `http://localhost:8790`
-- UI: `http://localhost:3000` (Caddy proxies same-origin `/v1/...` to `server:8790`)
+One image serves both the UI and the API. Compose starts Postgres 17 (data in `./data/postgres`) and
+Redis, and the server waits for both to be healthy, runs migrations, then listens on
+`http://localhost:8790`.
The local `.env` file, `packages/server/registry/`, and `data/` are ignored by Git. Docker Compose requires `packages/server/.env` and mounts the registry read-only into the server container.
diff --git a/docker-compose.yml b/docker-compose.yml
index a74ae98bf..55fd9c679 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -28,10 +28,10 @@ services:
retries: 5
restart: unless-stopped
+ # Serves both the API and the UI on one port.
server:
build:
context: .
- dockerfile: packages/server/Dockerfile
image: truefoundry-server:latest
ports:
- '${PORT:-8790}:8790'
@@ -55,14 +55,14 @@ services:
condition: service_healthy
redis:
condition: service_healthy
- # Probes existing GET / (plain text OK!); node is already in the image.
+ # Probes GET /healthz (plain text OK!); node is already in the image.
healthcheck:
test:
[
'CMD',
'node',
'-e',
- "fetch('http://127.0.0.1:8790/').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))",
+ "fetch('http://127.0.0.1:8790/healthz').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))",
]
interval: 5s
timeout: 5s
@@ -72,15 +72,3 @@ services:
# cut off turn drain.
stop_grace_period: 35s
restart: unless-stopped
-
- frontend:
- build:
- context: .
- dockerfile: packages/frontend/Dockerfile
- image: truefoundry-frontend:latest
- ports:
- - '${FRONTEND_PORT:-3000}:80'
- depends_on:
- server:
- condition: service_healthy
- restart: unless-stopped
diff --git a/fern/generators.yml b/fern/generators.yml
index ce3b3c532..29357a88b 100644
--- a/fern/generators.yml
+++ b/fern/generators.yml
@@ -12,7 +12,7 @@ readme:
# Fern keys this lookup on the stream flag, so the string form misses and fails.
defaultEndpoint:
method: POST
- path: /v1/sessions/{sessionId}/turns
+ path: /api/v1/sessions/{sessionId}/turns
stream: true
api:
specs:
diff --git a/fern/openapi/openapi.json b/fern/openapi/openapi.json
index cecbe8586..c220ae119 100644
--- a/fern/openapi/openapi.json
+++ b/fern/openapi/openapi.json
@@ -2469,7 +2469,7 @@
},
"openapi": "3.1.0",
"paths": {
- "/v1/capabilities": {
+ "/api/v1/capabilities": {
"get": {
"description": "Report optional runtime capabilities available in this server deployment.",
"responses": {
@@ -2494,7 +2494,7 @@
"x-fern-sdk-method-name": "get_capabilities"
}
},
- "/v1/mcp-servers": {
+ "/api/v1/mcp-servers": {
"get": {
"description": "MCP servers declared in mcp.yaml. Auth headers are configured via env vars and never returned.",
"responses": {
@@ -2519,7 +2519,7 @@
"x-fern-sdk-method-name": "list"
}
},
- "/v1/mcp-servers/{name}/tools": {
+ "/api/v1/mcp-servers/{name}/tools": {
"get": {
"description": "All tools exposed by the given MCP server (non-paginated), as returned by the MCP `tools/list` call. No agent-spec tool selectors are applied — this is the raw server catalog.",
"parameters": [
@@ -2587,7 +2587,7 @@
"x-fern-sdk-method-name": "list_tools"
}
},
- "/v1/models": {
+ "/api/v1/models": {
"get": {
"description": "Models declared in models.yaml, reachable through the OpenAI-compatible API at the file's base_url.",
"responses": {
@@ -2612,7 +2612,7 @@
"x-fern-sdk-method-name": "list"
}
},
- "/v1/sessions": {
+ "/api/v1/sessions": {
"get": {
"description": "List sessions (newest first by default), token-paginated. Pass `page_token` to fetch the next page, keeping the other query params constant.",
"parameters": [
@@ -2759,7 +2759,7 @@
"x-fern-sdk-method-name": "create"
}
},
- "/v1/sessions/{sessionId}": {
+ "/api/v1/sessions/{sessionId}": {
"get": {
"description": "Fetch a session by ID.",
"parameters": [
@@ -2885,7 +2885,7 @@
"x-fern-sdk-method-name": "update"
}
},
- "/v1/sessions/{sessionId}/cancel": {
+ "/api/v1/sessions/{sessionId}/cancel": {
"post": {
"description": "Cancel the running last turn for a session.",
"parameters": [
@@ -2954,7 +2954,7 @@
"x-fern-sdk-method-name": "cancel"
}
},
- "/v1/sessions/{sessionId}/events": {
+ "/api/v1/sessions/{sessionId}/events": {
"get": {
"description": "List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor.",
"parameters": [
@@ -3051,7 +3051,7 @@
"x-fern-sdk-method-name": "list_events"
}
},
- "/v1/sessions/{sessionId}/turns": {
+ "/api/v1/sessions/{sessionId}/turns": {
"get": {
"description": "List turns for a session (newest first by default), token-paginated.",
"parameters": [
@@ -3219,7 +3219,7 @@
}
}
},
- "/v1/sessions/{sessionId}/turns/{turnId}": {
+ "/api/v1/sessions/{sessionId}/turns/{turnId}": {
"get": {
"description": "Fetch a single turn by ID.",
"parameters": [
@@ -3279,7 +3279,7 @@
"x-fern-sdk-method-name": "get_turn"
}
},
- "/v1/sessions/{sessionId}/turns/{turnId}/events": {
+ "/api/v1/sessions/{sessionId}/turns/{turnId}/events": {
"get": {
"description": "Paginated persisted events for a turn (insertion order by default).",
"parameters": [
@@ -3386,7 +3386,7 @@
"x-fern-sdk-method-name": "list_turn_events"
}
},
- "/v1/skills": {
+ "/api/v1/skills": {
"get": {
"description": "Agent skills declared in skills.yaml.",
"responses": {
diff --git a/package.json b/package.json
index 909465e25..50c58de8e 100644
--- a/package.json
+++ b/package.json
@@ -12,9 +12,11 @@
"format:fix": "prettier --write \"**/*.{js,jsx,ts,tsx,json,md}\" --cache --config .prettierrc",
"test": "pnpm --filter @truefoundry/utils test && pnpm --filter @truefoundry/server test && pnpm --filter frontend test",
"test:store:local": "bash scripts/test-store-with-postgres.sh",
+ "dev": "pnpm --parallel --filter @truefoundry/server --filter frontend dev",
"dev:server": "pnpm --filter @truefoundry/server dev",
- "openapi:write": "pnpm --filter @truefoundry/server openapi:write",
"dev:frontend": "pnpm --filter frontend dev",
+ "dev:server:ui": "pnpm --filter frontend build && pnpm dev:server",
+ "openapi:write": "pnpm --filter @truefoundry/server openapi:write",
"ui:shot": "node ui-shots/shot.mjs",
"ui:clean": "node ui-shots/clean.mjs",
"pack:dry": "pnpm --filter @truefoundry/utils pack:dry",
diff --git a/packages/frontend/Caddyfile b/packages/frontend/Caddyfile
deleted file mode 100644
index 8f69ead65..000000000
--- a/packages/frontend/Caddyfile
+++ /dev/null
@@ -1,32 +0,0 @@
-:80 {
- encode gzip
-
- # SDK draft/session paths → harness /v1/sessions
- @draftSessions path /v1/agents/draft-sessions /v1/agents/draft-sessions/*
- handle @draftSessions {
- uri replace /v1/agents/draft-sessions /v1/sessions
- reverse_proxy server:8790 {
- flush_interval -1
- }
- }
-
- @agentSessions path /v1/agents/sessions /v1/agents/sessions/*
- handle @agentSessions {
- uri replace /v1/agents/sessions /v1/sessions
- reverse_proxy server:8790 {
- flush_interval -1
- }
- }
-
- handle /v1/* {
- reverse_proxy server:8790 {
- flush_interval -1
- }
- }
-
- handle {
- root * /usr/share/caddy
- try_files {path} /index.html
- file_server
- }
-}
diff --git a/packages/frontend/Dockerfile b/packages/frontend/Dockerfile
deleted file mode 100644
index 4b380ddbb..000000000
--- a/packages/frontend/Dockerfile
+++ /dev/null
@@ -1,37 +0,0 @@
-# syntax=docker/dockerfile:1
-#
-# Multi-stage build for the private frontend app (not published to npm).
-# Context must be the repository root (pnpm workspace).
-#
-# Dependency install uses pnpm fetch (lockfile-only) then install --offline so
-# the download layer stays cached when only package.json / scripts change.
-# See https://pnpm.io/cli/fetch
-
-FROM node:24-slim AS base
-ENV PNPM_HOME=/pnpm
-ENV PATH="$PNPM_HOME:$PATH"
-RUN corepack enable && pnpm config set store-dir /pnpm/store
-WORKDIR /app
-
-FROM base AS builder
-# Populate the store from the lockfile only (stable when manifests churn).
-COPY pnpm-lock.yaml pnpm-workspace.yaml ./
-COPY patches patches
-RUN --mount=type=cache,id=pnpm,target=/pnpm/store pnpm fetch
-
-COPY package.json .npmrc ./
-COPY packages/harness/package.json packages/harness/package.json
-COPY packages/server/package.json packages/server/package.json
-COPY packages/frontend/package.json packages/frontend/package.json
-# Root postinstall builds utils gen scripts — copy the inputs it needs.
-COPY packages/harness/scripts packages/harness/scripts
-COPY packages/harness/src/core/sandbox/scripts packages/harness/src/core/sandbox/scripts
-RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
- pnpm install --frozen-lockfile --offline --filter frontend...
-COPY packages/frontend packages/frontend
-RUN pnpm --filter frontend build
-
-FROM caddy:2-alpine AS runner
-COPY packages/frontend/Caddyfile /etc/caddy/Caddyfile
-COPY --from=builder /app/packages/frontend/dist /usr/share/caddy
-EXPOSE 80
diff --git a/packages/frontend/README.md b/packages/frontend/README.md
index f98aef687..72bf1a3fb 100644
--- a/packages/frontend/README.md
+++ b/packages/frontend/README.md
@@ -16,45 +16,47 @@ No login (`auth: false`). Skills are not wired in v1.
## Local development
```bash
-# terminal 1 — harness API (default :8790)
-pnpm --filter @truefoundry/server dev
-
-# terminal 2 — Vite UI (:3000) with path proxy
-pnpm --filter frontend dev
-# or: pnpm dev:frontend
+pnpm dev # API on :8790 and Vite on :3000 together
+pnpm dev:frontend # or Vite alone, against an API that is already up
```
-Open `http://localhost:3000`.
+Open `http://localhost:3000`: Vite serves the UI from source (edits hot-reload, no rebuild or server
+restart) and proxies `/api/*` to `VITE_SERVER_URL`, default `http://localhost:8790`. `FRONTEND_PORT`
+moves Vite off `:3000`. That proxy is the only dev-specific wiring and lives entirely in
+[`vite.config.ts`](vite.config.ts); the server needs no build to answer the API.
-### Vite proxy map
+### Session paths
-| Browser | Upstream (`localhost:8790`) |
-| ------------------------------------------------ | --------------------------- |
-| `/v1/agents/draft-sessions*` | `/v1/sessions*` |
-| `/v1/agents/sessions*` | `/v1/sessions*` |
-| `/v1/models*`, `/v1/mcp-servers*`, `/v1/skills*` | passthrough |
+The gateway SDK's session routes sit under `/v1/agents`, with draft sessions as a separate resource. The
+harness serves one `/api/v1/sessions` surface, so [`src/harnessFetch.ts`](src/harnessFetch.ts) rewrites
+requests on their way out and is handed to both clients as their `fetch`:
-## Docker Compose
+| SDK request | Harness route |
+| ---------------------------- | ------------------- |
+| `/v1/agents/draft-sessions*` | `/api/v1/sessions*` |
+| `/v1/agents/sessions*` | `/api/v1/sessions*` |
-Requires `packages/server/.env` and `packages/server/registry/` (see server docs).
+It runs in the browser, so the mapping is identical in dev and production; the dev proxy just forwards.
-```bash
-docker compose up --build
-```
+## Production
-- UI: `http://localhost:3000` (`FRONTEND_PORT`)
-- API: `http://localhost:8790` (direct) or same-origin `/v1/...` via Caddy in the frontend container
+There is no frontend image. `pnpm build` writes `dist/` plus `.br`/`.gz` siblings
+(`vite-plugin-compression2`) that the server serves from `FRONTEND_DIR`, sharing one origin with the API.
+The Monaco workers land outside Vite's asset pipeline and cannot be precompressed, so the server gzips
+those on the fly.
-Caddy uses the same path rewrite as Vite and disables buffering for SSE.
+```bash
+docker compose up --build # UI + API on http://localhost:8790
+```
## Catalogs (model + MCP)
The SDK has no catalog client. On boot the app:
-1. `GET /v1/models` → seeds `defaultAgentSpec.model.name`
+1. `GET /api/v1/models` → seeds `defaultAgentSpec.model.name`
2. Renders custom `ComposerRightSection` controls that `fetch` models/MCP and call `updateAgentSpec`
-Skills: catalog UI lists `GET /v1/skills` (empty state when none). Selection is local-only — session admission still rejects `agent_spec.skills`.
+Skills: catalog UI lists `GET /api/v1/skills` (empty state when none). Selection is local-only — session admission still rejects `agent_spec.skills`.
## Gaps
diff --git a/packages/frontend/package.json b/packages/frontend/package.json
index 5fc1778ed..740726fc8 100644
--- a/packages/frontend/package.json
+++ b/packages/frontend/package.json
@@ -11,7 +11,7 @@
"build": "tsc --noEmit && vite build",
"preview": "vite preview",
"typecheck": "tsc --noEmit",
- "test": "tsx --test src/**/*.test.ts"
+ "test": "tsx --test \"tests/**/*.test.ts\""
},
"dependencies": {
"@assistant-ui/core": "0.2.21",
@@ -33,6 +33,7 @@
"tsx": "^4.16.2",
"typescript": "^5.9.3",
"vite": "^6.3.5",
+ "vite-plugin-compression2": "^2.5.3",
"vite-plugin-monaco-editor-esm": "^2.0.2"
}
}
diff --git a/packages/frontend/src/App.tsx b/packages/frontend/src/App.tsx
index 45adcee71..572f23217 100644
--- a/packages/frontend/src/App.tsx
+++ b/packages/frontend/src/App.tsx
@@ -9,6 +9,7 @@ import { ApiErrorCard } from './ApiErrorCard';
import { ServerCapabilitiesProvider } from './capabilities';
import { getCapabilities, listModels, type ServerCapabilities } from './catalog';
import { AppComposerShell } from './ComposerShell';
+import { harnessFetch } from './harnessFetch';
import { PanelLeftIcon } from './icons';
import { AppWelcomeScreen } from './slots';
import { ThreadHeader } from './ThreadHeader';
@@ -17,11 +18,13 @@ import { ThreadSidebar } from './ThreadSidebar';
const client = new AgentSessionClient({
baseUrl: '/',
auth: false,
+ fetch: harnessFetch,
});
const privateClient = new PrivateAgentSessionClient({
baseUrl: '/',
auth: false,
+ fetch: harnessFetch,
});
const slotOverrides = {
@@ -134,7 +137,7 @@ export function App() {
const [models, serverCapabilities] = await Promise.all([listModels(), getCapabilities()]);
const first = models[0];
if (!first) {
- throw new Error('No models in GET /v1/models — check models.yaml');
+ throw new Error('No models in GET /api/v1/models — check models.yaml');
}
if (!state.cancelled) {
const defaultReasoningEffort = first.reasoning_efforts?.[0];
diff --git a/packages/frontend/src/catalog.ts b/packages/frontend/src/catalog.ts
index 82fa5a8c3..8c88948ff 100644
--- a/packages/frontend/src/catalog.ts
+++ b/packages/frontend/src/catalog.ts
@@ -42,21 +42,21 @@ async function fetchJson<T>(path: string): Promise<T> {
}
export async function listModels(): Promise<ModelEntry[]> {
- const body = await fetchJson<ListEnvelope<ModelEntry>>('/v1/models');
+ const body = await fetchJson<ListEnvelope<ModelEntry>>('/api/v1/models');
return body.data;
}
export async function listMcpServers(): Promise<McpServerEntry[]> {
- const body = await fetchJson<ListEnvelope<McpServerEntry>>('/v1/mcp-servers');
+ const body = await fetchJson<ListEnvelope<McpServerEntry>>('/api/v1/mcp-servers');
return body.data;
}
export async function listSkills(): Promise<SkillEntry[]> {
- const body = await fetchJson<ListEnvelope<SkillEntry>>('/v1/skills');
+ const body = await fetchJson<ListEnvelope<SkillEntry>>('/api/v1/skills');
return body.data;
}
export async function getCapabilities(): Promise<ServerCapabilities> {
- const body = await fetchJson<DataEnvelope<ServerCapabilities>>('/v1/capabilities');
+ const body = await fetchJson<DataEnvelope<ServerCapabilities>>('/api/v1/capabilities');
return body.data;
}
diff --git a/packages/frontend/src/harnessFetch.ts b/packages/frontend/src/harnessFetch.ts
new file mode 100644
index 000000000..24f92e79d
--- /dev/null
+++ b/packages/frontend/src/harnessFetch.ts
@@ -0,0 +1,17 @@
+/**
+ * The gateway SDK targets /v1/agents with draft sessions as a separate resource; the harness serves one
+ * /api/v1/sessions surface. Handed to the SDK clients as their `fetch`, this is the only place that knows.
+ */
+
+const SESSION_PATH = /^(https?:\/\/[^/]+)?\/v1\/agents\/(?:draft-)?sessions(?=$|[/?])/;
+
+export function toHarnessUrl(url: string): string {
+ return url.replace(SESSION_PATH, '$1/api/v1/sessions');
+}
+
+export const harnessFetch: typeof fetch = (input, init) => {
+ if (typeof input === 'string' || input instanceof URL) return globalThis.fetch(toHarnessUrl(String(input)), init);
+ const url = toHarnessUrl(input.url);
+ // Rebuilding a Request that carries a body requires `duplex`, so only do it when the path changed.
+ return url === input.url ? globalThis.fetch(input, init) : globalThis.fetch(new Request(url, input), init);
+};
diff --git a/packages/frontend/src/apiErrors.test.ts b/packages/frontend/tests/apiErrors.test.ts
similarity index 86%
rename from packages/frontend/src/apiErrors.test.ts
rename to packages/frontend/tests/apiErrors.test.ts
index 9fd7a0d09..031a97b9d 100644
--- a/packages/frontend/src/apiErrors.test.ts
+++ b/packages/frontend/tests/apiErrors.test.ts
@@ -1,6 +1,6 @@
import assert from 'node:assert/strict';
import { beforeEach, describe, it } from 'node:test';
-import { clearApiErrors, getApiErrorsSnapshot, installApiErrorInterceptor, subscribeApiErrors } from './apiErrors';
+import { clearApiErrors, getApiErrorsSnapshot, installApiErrorInterceptor, subscribeApiErrors } from '../src/apiErrors';
let stubbedResponse: () => Response | Promise<Response>;
@@ -15,12 +15,12 @@ describe('api error interceptor', () => {
it('records failed responses with status and body, and keeps the body readable', async () => {
stubbedResponse = () =>
new Response(JSON.stringify({ message: 'boom' }), { status: 500, statusText: 'Internal Server Error' });
- const response = await fetch('/v1/models', { method: 'POST' });
+ const response = await fetch('/api/v1/models', { method: 'POST' });
const [record] = getApiErrorsSnapshot();
assert.ok(record);
assert.equal(record.method, 'POST');
- assert.equal(record.url, '/v1/models');
+ assert.equal(record.url, '/api/v1/models');
assert.equal(record.status, 500);
assert.equal(record.statusText, 'Internal Server Error');
assert.equal(record.body, '{"message":"boom"}');
@@ -29,7 +29,7 @@ describe('api error interceptor', () => {
it('ignores successful responses', async () => {
stubbedResponse = () => new Response('ok', { status: 200 });
- await fetch('/v1/models');
+ await fetch('/api/v1/models');
assert.equal(getApiErrorsSnapshot().length, 0);
});
@@ -37,7 +37,7 @@ describe('api error interceptor', () => {
stubbedResponse = () => {
throw new Error('connection refused');
};
- await assert.rejects(fetch('/v1/skills'), /connection refused/);
+ await assert.rejects(fetch('/api/v1/skills'), /connection refused/);
const [record] = getApiErrorsSnapshot();
assert.ok(record);
diff --git a/packages/frontend/tests/harnessFetch.test.ts b/packages/frontend/tests/harnessFetch.test.ts
new file mode 100644
index 000000000..cd8afd74f
--- /dev/null
+++ b/packages/frontend/tests/harnessFetch.test.ts
@@ -0,0 +1,75 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { harnessFetch, toHarnessUrl } from '../src/harnessFetch';
+
+describe('toHarnessUrl', () => {
+ it('maps both session prefixes onto /api/v1/sessions', () => {
+ assert.equal(toHarnessUrl('/v1/agents/draft-sessions'), '/api/v1/sessions');
+ assert.equal(toHarnessUrl('/v1/agents/sessions'), '/api/v1/sessions');
+ assert.equal(toHarnessUrl('/v1/agents/sessions/ses_1/turns'), '/api/v1/sessions/ses_1/turns');
+ assert.equal(toHarnessUrl('/v1/agents/draft-sessions?limit=10'), '/api/v1/sessions?limit=10');
+ });
+
+ it('preserves the origin of absolute urls', () => {
+ assert.equal(
+ toHarnessUrl('http://localhost:8790/v1/agents/sessions/ses_1'),
+ 'http://localhost:8790/api/v1/sessions/ses_1',
+ );
+ });
+
+ it('leaves other paths untouched', () => {
+ assert.equal(toHarnessUrl('/api/v1/models'), '/api/v1/models');
+ assert.equal(toHarnessUrl('/api/v1/sessions/ses_1'), '/api/v1/sessions/ses_1');
+ // A longer segment only shares the prefix; it is a different route.
+ assert.equal(toHarnessUrl('/v1/agents/sessions-archive'), '/v1/agents/sessions-archive');
+ // Only the path is matched, so a prefix inside the query means nothing.
+ assert.equal(
+ toHarnessUrl('/api/v1/sessions?next=/v1/agents/sessions'),
+ '/api/v1/sessions?next=/v1/agents/sessions',
+ );
+ });
+});
+
+describe('harnessFetch', () => {
+ it('rewrites string, URL and Request inputs through the global fetch', async () => {
+ const seen: string[] = [];
+ const originalFetch = globalThis.fetch;
+ globalThis.fetch = (input: RequestInfo | URL) => {
+ seen.push(input instanceof Request ? input.url : String(input));
+ return Promise.resolve(new Response('ok'));
+ };
+
+ try {
+ await harnessFetch('/v1/agents/sessions');
+ await harnessFetch(new URL('http://localhost:8790/v1/agents/draft-sessions'));
+ await harnessFetch(new Request('http://localhost:8790/v1/agents/sessions/ses_1'));
+ } finally {
+ globalThis.fetch = originalFetch;
+ }
+
+ assert.deepEqual(seen, [
+ '/api/v1/sessions',
+ 'http://localhost:8790/api/v1/sessions',
+ 'http://localhost:8790/api/v1/sessions/ses_1',
+ ]);
+ });
+
+ it('passes a bodied Request through untouched when the path needs no rewrite', async () => {
+ const originalFetch = globalThis.fetch;
+ let forwarded: Request | undefined;
+ globalThis.fetch = (input: RequestInfo | URL) => {
+ if (input instanceof Request) forwarded = input;
+ return Promise.resolve(new Response('ok'));
+ };
+
+ const request = new Request('http://localhost:8790/api/v1/sessions', { method: 'POST', body: '{"a":1}' });
+ try {
+ await harnessFetch(request);
+ } finally {
+ globalThis.fetch = originalFetch;
+ }
+
+ assert.equal(forwarded, request);
+ assert.equal(await request.text(), '{"a":1}');
+ });
+});
diff --git a/packages/frontend/src/skillMounts.test.ts b/packages/frontend/tests/skillMounts.test.ts
similarity index 89%
rename from packages/frontend/src/skillMounts.test.ts
rename to packages/frontend/tests/skillMounts.test.ts
index 2d7dd0492..a2ff27271 100644
--- a/packages/frontend/src/skillMounts.test.ts
+++ b/packages/frontend/tests/skillMounts.test.ts
@@ -1,7 +1,12 @@
import assert from 'node:assert/strict';
import { describe, it } from 'node:test';
-import type { SkillEntry } from './catalog';
-import { DEFAULT_SKILL_REF, selectedSkillNamesFromSpec, skillMountsFromNames, toGitSkillMount } from './skillMounts';
+import type { SkillEntry } from '../src/catalog';
+import {
+ DEFAULT_SKILL_REF,
+ selectedSkillNamesFromSpec,
+ skillMountsFromNames,
+ toGitSkillMount,
+} from '../src/skillMounts';
const entry: SkillEntry = {
name: 'pr-review',
diff --git a/packages/frontend/tsconfig.json b/packages/frontend/tsconfig.json
index 4470695e6..1dac979a5 100644
--- a/packages/frontend/tsconfig.json
+++ b/packages/frontend/tsconfig.json
@@ -20,6 +20,6 @@
"isolatedModules": true,
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo"
},
- "include": ["src"],
- "exclude": ["src/**/*.test.ts"]
+ "include": ["src", "tests"],
+ "exclude": ["tests/**/*.test.ts"]
}
diff --git a/packages/frontend/vite.config.ts b/packages/frontend/vite.config.ts
index 13f217d6c..ef27ef26f 100644
--- a/packages/frontend/vite.config.ts
+++ b/packages/frontend/vite.config.ts
@@ -1,16 +1,14 @@
import react from '@vitejs/plugin-react';
import type { ProxyOptions } from 'vite';
import { defineConfig } from 'vite';
+import { compression } from 'vite-plugin-compression2';
// Maintained ESM fork of vite-plugin-monaco-editor (works with Vite 6 ESM config).
import monacoEditorPlugin from 'vite-plugin-monaco-editor-esm';
const SERVER = process.env.VITE_SERVER_URL ?? 'http://localhost:8790';
-
-/** Rewrite SDK draft/session paths onto harness /v1/sessions. */
-function rewriteAgentsToSessions(path: string): string {
- return path
- .replace(/^\/v1\/agents\/draft-sessions/, '/v1/sessions')
- .replace(/^\/v1\/agents\/sessions/, '/v1/sessions');
+const PORT = Number(process.env.FRONTEND_PORT ?? 3000);
+if (!Number.isInteger(PORT)) {
+ throw new Error(`FRONTEND_PORT must be an integer, got "${process.env.FRONTEND_PORT}"`);
}
const apiProxy: ProxyOptions = {
@@ -33,6 +31,12 @@ export default defineConfig({
monacoEditorPlugin({
languageWorkers: ['editorWorkerService', 'css', 'html', 'json', 'typescript'],
}),
+ // The server serves these siblings instead of compressing per request.
+ compression({
+ algorithms: ['br', 'gz'],
+ threshold: 1024,
+ skipIfLargerOrEqual: true,
+ }),
],
// Single React / assistant-ui Context instance (avoids "requires an AuiProvider").
resolve: {
@@ -46,17 +50,10 @@ export default defineConfig({
],
},
server: {
- port: 3000,
+ port: PORT,
+ // Plain passthrough: harnessFetch already maps SDK paths onto harness routes.
proxy: {
- '/v1/agents': {
- ...apiProxy,
- rewrite: rewriteAgentsToSessions,
- },
- '/v1/capabilities': apiProxy,
- '/v1/models': apiProxy,
- '/v1/mcp-servers': apiProxy,
- '/v1/skills': apiProxy,
- '/v1/sessions': apiProxy,
+ '/api': apiProxy,
},
},
});
diff --git a/packages/sdk/.fern/metadata.json b/packages/sdk/.fern/metadata.json
index afe6487a1..56a137d56 100644
--- a/packages/sdk/.fern/metadata.json
+++ b/packages/sdk/.fern/metadata.json
@@ -26,8 +26,8 @@
"streamType": "web",
"useDefaultRequestParameterValues": true
},
- "originGitCommit": "5360bb423eae4f38106c9faeba6ca272904bc605",
- "originGitCommitIsDirty": true,
+ "originGitCommit": "124289a5430e1855ea5559ea906e0e07e8dfb0e1",
+ "originGitCommitIsDirty": false,
"invokedBy": "ci",
"requestedVersion": "0.0.0",
"ciProvider": "github",
diff --git a/packages/sdk/src/api/resources/mcpServers/client/Client.ts b/packages/sdk/src/api/resources/mcpServers/client/Client.ts
index d6a06f359..6d9421bb6 100644
--- a/packages/sdk/src/api/resources/mcpServers/client/Client.ts
+++ b/packages/sdk/src/api/resources/mcpServers/client/Client.ts
@@ -47,7 +47,7 @@ export class McpServersClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- "v1/mcp-servers",
+ "api/v1/mcp-servers",
),
method: "GET",
headers: _headers,
@@ -79,7 +79,7 @@ export class McpServersClient {
});
}
- return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/mcp-servers");
+ return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/mcp-servers");
}
/**
@@ -113,7 +113,7 @@ export class McpServersClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- `v1/mcp-servers/${core.url.encodePathParam(name)}/tools`,
+ `api/v1/mcp-servers/${core.url.encodePathParam(name)}/tools`,
),
method: "GET",
headers: _headers,
@@ -181,6 +181,11 @@ export class McpServersClient {
}
}
- return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/mcp-servers/{name}/tools");
+ return handleNonStatusCodeError(
+ _response.error,
+ _response.rawResponse,
+ "GET",
+ "/api/v1/mcp-servers/{name}/tools",
+ );
}
}
diff --git a/packages/sdk/src/api/resources/models/client/Client.ts b/packages/sdk/src/api/resources/models/client/Client.ts
index 0de585374..ee592e914 100644
--- a/packages/sdk/src/api/resources/models/client/Client.ts
+++ b/packages/sdk/src/api/resources/models/client/Client.ts
@@ -47,7 +47,7 @@ export class ModelsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- "v1/models",
+ "api/v1/models",
),
method: "GET",
headers: _headers,
@@ -79,6 +79,6 @@ export class ModelsClient {
});
}
- return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/models");
+ return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/models");
}
}
diff --git a/packages/sdk/src/api/resources/server/client/Client.ts b/packages/sdk/src/api/resources/server/client/Client.ts
index 78783ce54..3e87c2155 100644
--- a/packages/sdk/src/api/resources/server/client/Client.ts
+++ b/packages/sdk/src/api/resources/server/client/Client.ts
@@ -47,7 +47,7 @@ export class ServerClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- "v1/capabilities",
+ "api/v1/capabilities",
),
method: "GET",
headers: _headers,
@@ -79,6 +79,6 @@ export class ServerClient {
});
}
- return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/capabilities");
+ return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/capabilities");
}
}
diff --git a/packages/sdk/src/api/resources/sessions/client/Client.ts b/packages/sdk/src/api/resources/sessions/client/Client.ts
index 61541fcca..29084ee95 100644
--- a/packages/sdk/src/api/resources/sessions/client/Client.ts
+++ b/packages/sdk/src/api/resources/sessions/client/Client.ts
@@ -68,7 +68,7 @@ export class SessionsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- "v1/sessions",
+ "api/v1/sessions",
),
method: "GET",
headers: _headers,
@@ -116,7 +116,7 @@ export class SessionsClient {
});
}
}
- return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/sessions");
+ return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/sessions");
},
);
const dataWithRawResponse = await list(request).withRawResponse();
@@ -169,7 +169,7 @@ export class SessionsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- "v1/sessions",
+ "api/v1/sessions",
),
method: "POST",
headers: _headers,
@@ -237,7 +237,7 @@ export class SessionsClient {
}
}
- return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/sessions");
+ return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/api/v1/sessions");
}
/**
@@ -269,7 +269,7 @@ export class SessionsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- `v1/sessions/${core.url.encodePathParam(sessionId)}`,
+ `api/v1/sessions/${core.url.encodePathParam(sessionId)}`,
),
method: "GET",
headers: _headers,
@@ -315,7 +315,7 @@ export class SessionsClient {
}
}
- return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/sessions/{sessionId}");
+ return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/sessions/{sessionId}");
}
/**
@@ -352,7 +352,7 @@ export class SessionsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- `v1/sessions/${core.url.encodePathParam(sessionId)}`,
+ `api/v1/sessions/${core.url.encodePathParam(sessionId)}`,
),
method: "PATCH",
headers: _headers,
@@ -431,7 +431,12 @@ export class SessionsClient {
}
}
- return handleNonStatusCodeError(_response.error, _response.rawResponse, "PATCH", "/v1/sessions/{sessionId}");
+ return handleNonStatusCodeError(
+ _response.error,
+ _response.rawResponse,
+ "PATCH",
+ "/api/v1/sessions/{sessionId}",
+ );
}
/**
@@ -467,7 +472,7 @@ export class SessionsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- `v1/sessions/${core.url.encodePathParam(sessionId)}/cancel`,
+ `api/v1/sessions/${core.url.encodePathParam(sessionId)}/cancel`,
),
method: "POST",
headers: _headers,
@@ -539,7 +544,7 @@ export class SessionsClient {
_response.error,
_response.rawResponse,
"POST",
- "/v1/sessions/{sessionId}/cancel",
+ "/api/v1/sessions/{sessionId}/cancel",
);
}
@@ -581,7 +586,7 @@ export class SessionsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- `v1/sessions/${core.url.encodePathParam(sessionId)}/events`,
+ `api/v1/sessions/${core.url.encodePathParam(sessionId)}/events`,
),
method: "GET",
headers: _headers,
@@ -644,7 +649,7 @@ export class SessionsClient {
_response.error,
_response.rawResponse,
"GET",
- "/v1/sessions/{sessionId}/events",
+ "/api/v1/sessions/{sessionId}/events",
);
},
);
@@ -699,7 +704,7 @@ export class SessionsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- `v1/sessions/${core.url.encodePathParam(sessionId)}/turns`,
+ `api/v1/sessions/${core.url.encodePathParam(sessionId)}/turns`,
),
method: "GET",
headers: _headers,
@@ -762,7 +767,7 @@ export class SessionsClient {
_response.error,
_response.rawResponse,
"GET",
- "/v1/sessions/{sessionId}/turns",
+ "/api/v1/sessions/{sessionId}/turns",
);
},
);
@@ -802,7 +807,7 @@ export class SessionsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- `v1/sessions/${core.url.encodePathParam(sessionId)}/turns`,
+ `api/v1/sessions/${core.url.encodePathParam(sessionId)}/turns`,
),
method: "POST",
headers: _headers,
@@ -895,7 +900,7 @@ export class SessionsClient {
_response.error,
_response.rawResponse,
"POST",
- "/v1/sessions/{sessionId}/turns",
+ "/api/v1/sessions/{sessionId}/turns",
);
}
@@ -931,7 +936,7 @@ export class SessionsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- `v1/sessions/${core.url.encodePathParam(sessionId)}/turns/${core.url.encodePathParam(turnId)}`,
+ `api/v1/sessions/${core.url.encodePathParam(sessionId)}/turns/${core.url.encodePathParam(turnId)}`,
),
method: "GET",
headers: _headers,
@@ -981,7 +986,7 @@ export class SessionsClient {
_response.error,
_response.rawResponse,
"GET",
- "/v1/sessions/{sessionId}/turns/{turnId}",
+ "/api/v1/sessions/{sessionId}/turns/{turnId}",
);
}
@@ -1033,7 +1038,7 @@ export class SessionsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- `v1/sessions/${core.url.encodePathParam(sessionId)}/turns/${core.url.encodePathParam(turnId)}/events`,
+ `api/v1/sessions/${core.url.encodePathParam(sessionId)}/turns/${core.url.encodePathParam(turnId)}/events`,
),
method: "GET",
headers: _headers,
@@ -1096,7 +1101,7 @@ export class SessionsClient {
_response.error,
_response.rawResponse,
"GET",
- "/v1/sessions/{sessionId}/turns/{turnId}/events",
+ "/api/v1/sessions/{sessionId}/turns/{turnId}/events",
);
},
);
diff --git a/packages/sdk/src/api/resources/skills/client/Client.ts b/packages/sdk/src/api/resources/skills/client/Client.ts
index 65b0932b4..edeeedb5c 100644
--- a/packages/sdk/src/api/resources/skills/client/Client.ts
+++ b/packages/sdk/src/api/resources/skills/client/Client.ts
@@ -47,7 +47,7 @@ export class SkillsClient {
url: core.url.join(
(await core.Supplier.get(this._options.baseUrl)) ??
(await core.Supplier.get(this._options.environment)),
- "v1/skills",
+ "api/v1/skills",
),
method: "GET",
headers: _headers,
@@ -79,6 +79,6 @@ export class SkillsClient {
});
}
- return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/skills");
+ return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/skills");
}
}
diff --git a/packages/sdk/tests/wire/mcpServers.test.ts b/packages/sdk/tests/wire/mcpServers.test.ts
index 5ea5ba678..fed495e8a 100644
--- a/packages/sdk/tests/wire/mcpServers.test.ts
+++ b/packages/sdk/tests/wire/mcpServers.test.ts
@@ -11,7 +11,13 @@ describe("McpServersClient", () => {
const rawResponseBody = { data: [{ name: "name", url: "url" }] };
- server.mockEndpoint().get("/v1/mcp-servers").respondWith().statusCode(200).jsonBody(rawResponseBody).build();
+ server
+ .mockEndpoint()
+ .get("/api/v1/mcp-servers")
+ .respondWith()
+ .statusCode(200)
+ .jsonBody(rawResponseBody)
+ .build();
const response = await client.mcpServers.list();
expect(response).toEqual({
@@ -32,7 +38,7 @@ describe("McpServersClient", () => {
server
.mockEndpoint()
- .get("/v1/mcp-servers/name/tools")
+ .get("/api/v1/mcp-servers/name/tools")
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
@@ -56,7 +62,7 @@ describe("McpServersClient", () => {
server
.mockEndpoint()
- .get("/v1/mcp-servers/name/tools")
+ .get("/api/v1/mcp-servers/name/tools")
.respondWith()
.statusCode(401)
.jsonBody(rawResponseBody)
@@ -75,7 +81,7 @@ describe("McpServersClient", () => {
server
.mockEndpoint()
- .get("/v1/mcp-servers/name/tools")
+ .get("/api/v1/mcp-servers/name/tools")
.respondWith()
.statusCode(404)
.jsonBody(rawResponseBody)
@@ -94,7 +100,7 @@ describe("McpServersClient", () => {
server
.mockEndpoint()
- .get("/v1/mcp-servers/name/tools")
+ .get("/api/v1/mcp-servers/name/tools")
.respondWith()
.statusCode(502)
.jsonBody(rawResponseBody)
diff --git a/packages/sdk/tests/wire/models.test.ts b/packages/sdk/tests/wire/models.test.ts
index 0e8f87c1c..65936b9f7 100644
--- a/packages/sdk/tests/wire/models.test.ts
+++ b/packages/sdk/tests/wire/models.test.ts
@@ -12,7 +12,7 @@ describe("ModelsClient", () => {
data: [{ max_output_tokens: 1, name: "name", reasoning_efforts: ["reasoning_efforts"] }],
};
- server.mockEndpoint().get("/v1/models").respondWith().statusCode(200).jsonBody(rawResponseBody).build();
+ server.mockEndpoint().get("/api/v1/models").respondWith().statusCode(200).jsonBody(rawResponseBody).build();
const response = await client.models.list();
expect(response).toEqual({
diff --git a/packages/sdk/tests/wire/server.test.ts b/packages/sdk/tests/wire/server.test.ts
index 46b5807ca..19b5e735c 100644
--- a/packages/sdk/tests/wire/server.test.ts
+++ b/packages/sdk/tests/wire/server.test.ts
@@ -10,7 +10,13 @@ describe("ServerClient", () => {
const rawResponseBody = { data: { sandbox: { enabled: true } } };
- server.mockEndpoint().get("/v1/capabilities").respondWith().statusCode(200).jsonBody(rawResponseBody).build();
+ server
+ .mockEndpoint()
+ .get("/api/v1/capabilities")
+ .respondWith()
+ .statusCode(200)
+ .jsonBody(rawResponseBody)
+ .build();
const response = await client.server.getCapabilities();
expect(response).toEqual({
diff --git a/packages/sdk/tests/wire/sessions.test.ts b/packages/sdk/tests/wire/sessions.test.ts
index 2c08ef288..1e3f7ba45 100644
--- a/packages/sdk/tests/wire/sessions.test.ts
+++ b/packages/sdk/tests/wire/sessions.test.ts
@@ -24,7 +24,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint({ once: false })
- .get("/v1/sessions")
+ .get("/api/v1/sessions")
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
@@ -64,7 +64,7 @@ describe("SessionsClient", () => {
const rawResponseBody = { error: { message: "message" } };
- server.mockEndpoint().get("/v1/sessions").respondWith().statusCode(400).jsonBody(rawResponseBody).build();
+ server.mockEndpoint().get("/api/v1/sessions").respondWith().statusCode(400).jsonBody(rawResponseBody).build();
await expect(async () => {
return await client.sessions.list();
@@ -95,7 +95,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .post("/v1/sessions")
+ .post("/api/v1/sessions")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(200)
@@ -159,7 +159,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .post("/v1/sessions")
+ .post("/api/v1/sessions")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(400)
@@ -185,7 +185,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .post("/v1/sessions")
+ .post("/api/v1/sessions")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(422)
@@ -227,7 +227,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .get("/v1/sessions/sessionId")
+ .get("/api/v1/sessions/sessionId")
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
@@ -284,7 +284,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .get("/v1/sessions/sessionId")
+ .get("/api/v1/sessions/sessionId")
.respondWith()
.statusCode(404)
.jsonBody(rawResponseBody)
@@ -319,7 +319,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .patch("/v1/sessions/sessionId")
+ .patch("/api/v1/sessions/sessionId")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(200)
@@ -377,7 +377,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .patch("/v1/sessions/sessionId")
+ .patch("/api/v1/sessions/sessionId")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(400)
@@ -397,7 +397,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .patch("/v1/sessions/sessionId")
+ .patch("/api/v1/sessions/sessionId")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(404)
@@ -417,7 +417,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .patch("/v1/sessions/sessionId")
+ .patch("/api/v1/sessions/sessionId")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(422)
@@ -437,7 +437,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .post("/v1/sessions/sessionId/cancel")
+ .post("/api/v1/sessions/sessionId/cancel")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(200)
@@ -456,7 +456,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .post("/v1/sessions/sessionId/cancel")
+ .post("/api/v1/sessions/sessionId/cancel")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(404)
@@ -476,7 +476,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .post("/v1/sessions/sessionId/cancel")
+ .post("/api/v1/sessions/sessionId/cancel")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(412)
@@ -510,7 +510,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint({ once: false })
- .get("/v1/sessions/sessionId/events")
+ .get("/api/v1/sessions/sessionId/events")
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
@@ -557,7 +557,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .get("/v1/sessions/sessionId/events")
+ .get("/api/v1/sessions/sessionId/events")
.respondWith()
.statusCode(400)
.jsonBody(rawResponseBody)
@@ -576,7 +576,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .get("/v1/sessions/sessionId/events")
+ .get("/api/v1/sessions/sessionId/events")
.respondWith()
.statusCode(404)
.jsonBody(rawResponseBody)
@@ -607,7 +607,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint({ once: false })
- .get("/v1/sessions/sessionId/turns")
+ .get("/api/v1/sessions/sessionId/turns")
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
@@ -655,7 +655,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .get("/v1/sessions/sessionId/turns")
+ .get("/api/v1/sessions/sessionId/turns")
.respondWith()
.statusCode(400)
.jsonBody(rawResponseBody)
@@ -674,7 +674,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .get("/v1/sessions/sessionId/turns")
+ .get("/api/v1/sessions/sessionId/turns")
.respondWith()
.statusCode(404)
.jsonBody(rawResponseBody)
@@ -694,7 +694,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .post("/v1/sessions/sessionId/turns")
+ .post("/api/v1/sessions/sessionId/turns")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(200)
@@ -731,7 +731,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .post("/v1/sessions/sessionId/turns")
+ .post("/api/v1/sessions/sessionId/turns")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(400)
@@ -751,7 +751,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .post("/v1/sessions/sessionId/turns")
+ .post("/api/v1/sessions/sessionId/turns")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(404)
@@ -771,7 +771,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .post("/v1/sessions/sessionId/turns")
+ .post("/api/v1/sessions/sessionId/turns")
.jsonBody(rawRequestBody)
.respondWith()
.statusCode(412)
@@ -800,7 +800,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .get("/v1/sessions/sessionId/turns/turnId")
+ .get("/api/v1/sessions/sessionId/turns/turnId")
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
@@ -836,7 +836,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .get("/v1/sessions/sessionId/turns/turnId")
+ .get("/api/v1/sessions/sessionId/turns/turnId")
.respondWith()
.statusCode(404)
.jsonBody(rawResponseBody)
@@ -866,7 +866,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint({ once: false })
- .get("/v1/sessions/sessionId/turns/turnId/events")
+ .get("/api/v1/sessions/sessionId/turns/turnId/events")
.respondWith()
.statusCode(200)
.jsonBody(rawResponseBody)
@@ -910,7 +910,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .get("/v1/sessions/sessionId/turns/turnId/events")
+ .get("/api/v1/sessions/sessionId/turns/turnId/events")
.respondWith()
.statusCode(400)
.jsonBody(rawResponseBody)
@@ -929,7 +929,7 @@ describe("SessionsClient", () => {
server
.mockEndpoint()
- .get("/v1/sessions/sessionId/turns/turnId/events")
+ .get("/api/v1/sessions/sessionId/turns/turnId/events")
.respondWith()
.statusCode(404)
.jsonBody(rawResponseBody)
diff --git a/packages/sdk/tests/wire/skills.test.ts b/packages/sdk/tests/wire/skills.test.ts
index 074668816..c2480b050 100644
--- a/packages/sdk/tests/wire/skills.test.ts
+++ b/packages/sdk/tests/wire/skills.test.ts
@@ -12,7 +12,7 @@ describe("SkillsClient", () => {
data: [{ description: "description", name: "name", path: "path", ref: "ref", url: "url" }],
};
- server.mockEndpoint().get("/v1/skills").respondWith().statusCode(200).jsonBody(rawResponseBody).build();
+ server.mockEndpoint().get("/api/v1/skills").respondWith().statusCode(200).jsonBody(rawResponseBody).build();
const response = await client.skills.list();
expect(response).toEqual({
diff --git a/packages/server/.env.example b/packages/server/.env.example
index a073e190e..e5ffafd42 100644
--- a/packages/server/.env.example
+++ b/packages/server/.env.example
@@ -14,6 +14,11 @@ PORT=8790
# in models.yaml; only its API key lives here.
# REGISTRY_DIR=registry
+# Frontend build the server serves alongside the API. Optional, defaults to
+# ../frontend/dist relative to the working directory. With no build there the
+# server logs a warning and serves the API only.
+# FRONTEND_DIR=../frontend/dist
+
# Required. Redis connection URL shared by all server replicas; carries
# executor peering so a cancel that lands on one replica reaches the replica
# running the turn. docker-compose provides this automatically.
diff --git a/packages/server/package.json b/packages/server/package.json
index 1a47021de..756c21442 100644
--- a/packages/server/package.json
+++ b/packages/server/package.json
@@ -12,7 +12,7 @@
"migrate": "tsx --env-file=.env src/db/postgres/migrate-cli.ts",
"typecheck": "tsc --noEmit",
"openapi:write": "tsx --env-file=.env.test scripts/write-openapi.ts",
- "test": "tsx --env-file=.env.test --test src/**/*.test.ts",
+ "test": "tsx --env-file=.env.test --test \"src/**/*.test.ts\"",
"test:store": "jest --config jest.store.config.cjs",
"start": "node dist/main.js"
},
diff --git a/packages/server/src/app.ts b/packages/server/src/app.ts
index 73d188f39..a60596828 100644
--- a/packages/server/src/app.ts
+++ b/packages/server/src/app.ts
@@ -1,11 +1,9 @@
-/**
- * HTTP application: composes the resource routers and serves the OpenAPI
- * document (/openapi.json) and Swagger UI (/docs).
- */
+/** The API: resource routers, the OpenAPI document and Swagger UI, all under /api/v1. */
import { swaggerUI } from '@hono/swagger-ui';
import { OpenAPIHono } from '@hono/zod-openapi';
import type { ISessionStore, Sessions, TurnSandboxFactory } from '@truefoundry/utils/agent-session';
import type { RequestReplyRouter } from '@truefoundry/utils/request-reply';
+import type { Context } from 'hono';
import { HTTPException } from 'hono/http-exception';
import type { RedisClientType } from 'redis';
import type { Logger } from 'winston';
@@ -34,6 +32,10 @@ export function buildOpenApiDocument(app: OpenAPIHono) {
return app.getOpenAPI31Document(openApiDocConfig);
}
+function routeNotFound(c: Context) {
+ return c.json({ error: { message: `Route not found: ${c.req.method} ${c.req.path}` } }, 404);
+}
+
export interface ServerDeps {
modelStore: ModelStore;
mcpStore: McpStore;
@@ -53,14 +55,14 @@ export interface ServerDeps {
export function createServerApp(deps: ServerDeps) {
const app = new OpenAPIHono();
- app.get('/', c => c.text('OK!'));
+ app.get('/healthz', c => c.text('OK!'));
- app.route('/v1/capabilities', createCapabilitiesRouter({ sandboxEnabled: deps.sandboxFactory !== undefined }));
- app.route('/v1/models', createModelsRouter(deps.modelStore));
- app.route('/v1/mcp-servers', createMcpRouter({ mcpStore: deps.mcpStore, logger: deps.logger }));
- app.route('/v1/skills', createSkillsRouter(deps.skillStore));
+ app.route('/api/v1/capabilities', createCapabilitiesRouter({ sandboxEnabled: deps.sandboxFactory !== undefined }));
+ app.route('/api/v1/models', createModelsRouter(deps.modelStore));
+ app.route('/api/v1/mcp-servers', createMcpRouter({ mcpStore: deps.mcpStore, logger: deps.logger }));
+ app.route('/api/v1/skills', createSkillsRouter(deps.skillStore));
app.route(
- '/v1/sessions',
+ '/api/v1/sessions',
createSessionsRouter({
sessions: deps.sessions,
sessionStore: deps.sessionStore,
@@ -73,7 +75,7 @@ export function createServerApp(deps: ServerDeps) {
}),
);
app.route(
- '/v1/sessions',
+ '/api/v1/sessions',
createTurnsRouter({
sessions: deps.sessions,
activeTurns: deps.activeTurns,
@@ -84,10 +86,10 @@ export function createServerApp(deps: ServerDeps) {
}),
);
- app.get('/docs', swaggerUI({ url: '/openapi.json' }));
- app.get('/openapi.json', c => c.json(buildOpenApiDocument(app)));
+ app.get('/api/v1/docs', swaggerUI({ url: '/api/v1/openapi.json' }));
+ app.get('/api/v1/openapi.json', c => c.json(buildOpenApiDocument(app)));
- app.notFound(c => c.json({ error: { message: `Route not found: ${c.req.method} ${c.req.path}` } }, 404));
+ app.notFound(routeNotFound);
app.onError((error, c) => {
if (error instanceof HTTPException) {
diff --git a/packages/server/src/config.ts b/packages/server/src/config.ts
index 3a1eedf0f..ec050f6a7 100644
--- a/packages/server/src/config.ts
+++ b/packages/server/src/config.ts
@@ -182,6 +182,9 @@ export const buildPostgresConnectionString = (parts: {
export const DEFAULT_PORT = 8790;
+/** Relative to the working directory, like REGISTRY_DIR; the image sets an absolute FRONTEND_DIR. */
+const DEFAULT_FRONTEND_DIR = '../frontend/dist';
+
export interface ServerConfiguration {
/** HTTP port the server listens on. Env: `PORT`. */
PORT: number;
@@ -192,6 +195,11 @@ export interface ServerConfiguration {
* `./registry`.
*/
REGISTRY_DIR: string;
+ /**
+ * Frontend build served alongside the API; a missing directory leaves the server API-only.
+ * Env: `FRONTEND_DIR`, defaults to `../frontend/dist` relative to the working directory.
+ */
+ FRONTEND_DIR: string;
/**
* Default API key for the OpenAI-compatible API at models.yaml's base_url,
* sent as `Authorization: Bearer <key>` on every model request.
@@ -301,6 +309,7 @@ const postgresPort = parsePositiveInt({
const configuration: ServerConfiguration = {
PORT: parsePort(getEnv('PORT')),
REGISTRY_DIR: path.resolve(getEnv('REGISTRY_DIR', { defaultValue: 'registry' }) ?? 'registry'),
+ FRONTEND_DIR: path.resolve(getEnv('FRONTEND_DIR', { defaultValue: DEFAULT_FRONTEND_DIR }) ?? DEFAULT_FRONTEND_DIR),
MODEL_API_KEY: getEnv('MODEL_API_KEY', { required: true }) ?? '',
MODEL_API_KEY_BY_NAME: parseApiKeysByName(),
MODEL_HEADERS: parseHeaders('MODEL_HEADERS', getEnv('MODEL_HEADERS')),
diff --git a/packages/server/src/frontend.ts b/packages/server/src/frontend.ts
new file mode 100644
index 000000000..e2d30e283
--- /dev/null
+++ b/packages/server/src/frontend.ts
@@ -0,0 +1,64 @@
+/** Serves the built frontend, so one container answers both the UI and the API. */
+import { serveStatic } from '@hono/node-server/serve-static';
+import type { OpenAPIHono } from '@hono/zod-openapi';
+import type { MiddlewareHandler } from 'hono';
+import { every } from 'hono/combine';
+import { compress } from 'hono/compress';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+
+/** Routes the server answers itself; never served from the build. /api covers every version below it. */
+const SERVER_PATH_PREFIXES = ['/api', '/healthz'];
+
+/** Only Vite's hashed asset names can be cached forever. */
+const HASHED_ASSET_PREFIX = '/assets/';
+const IMMUTABLE_CACHE_CONTROL = 'public, max-age=31536000, immutable';
+const REVALIDATE_CACHE_CONTROL = 'no-cache';
+
+function isServerPath(pathname: string): boolean {
+ return SERVER_PATH_PREFIXES.some(prefix => pathname === prefix || pathname.startsWith(`${prefix}/`));
+}
+
+/**
+ * Must be called after the API routes are registered, so those always win over the static handler.
+ * Returns false when `dir` holds no build, leaving the server API-only for UI work behind Vite.
+ */
+export function mountFrontend(app: OpenAPIHono, dir: string): boolean {
+ if (!existsSync(path.join(dir, 'index.html'))) {
+ return false;
+ }
+
+ // serveStatic joins `root` with the request path, so an absolute dir is working-directory proof.
+ const serveFile = serveStatic({ root: dir, precompressed: true });
+
+ const serveWithCacheHeaders: MiddlewareHandler = async (c, next) => {
+ const response = await serveFile(c, next);
+ // Only when a file was served: a missing asset must not cache its 404.
+ if (response instanceof Response) {
+ const cacheControl = c.req.path.startsWith(HASHED_ASSET_PREFIX)
+ ? IMMUTABLE_CACHE_CONTROL
+ : REVALIDATE_CACHE_CONTROL;
+ response.headers.set('Cache-Control', cacheControl);
+ // compress() below encodes without advertising it, which a shared cache would get wrong.
+ response.headers.set('Vary', 'Accept-Encoding');
+ }
+ return response;
+ };
+
+ /**
+ * compress() skips responses that already carry Content-Encoding, so it only reaches what the build
+ * could not precompress: the Monaco workers. It stays behind the isServerPath guard below because
+ * compressing an API response would buffer the SSE streams that must flush per event.
+ */
+ const serveCompressed = every(compress(), serveWithCacheHeaders);
+
+ const serveBuild: MiddlewareHandler = async (c, next) => {
+ if (isServerPath(c.req.path)) return next();
+ if (c.req.method !== 'GET' && c.req.method !== 'HEAD') return next();
+ return serveCompressed(c, next);
+ };
+
+ app.use('/*', serveBuild);
+
+ return true;
+}
diff --git a/packages/server/src/main.ts b/packages/server/src/main.ts
index f135c2ebe..311449cf6 100644
--- a/packages/server/src/main.ts
+++ b/packages/server/src/main.ts
@@ -9,6 +9,7 @@ import winston from 'winston';
try {
const [
{ createServerApp },
+ { mountFrontend },
{ default: configuration },
{ createDb },
{ migrateToLatest },
@@ -23,6 +24,7 @@ try {
{ PostgresSessionStore },
] = await Promise.all([
import('./app'),
+ import('./frontend'),
import('./config'),
import('./db/postgres/client'),
import('./db/migratePostgres'),
@@ -72,6 +74,15 @@ try {
logger,
});
+ if (mountFrontend(app, configuration.FRONTEND_DIR)) {
+ logger.info(`Serving frontend from ${configuration.FRONTEND_DIR}`);
+ } else {
+ logger.warn(
+ `No frontend build at ${configuration.FRONTEND_DIR}: serving the API only. ` +
+ 'Run `pnpm --filter frontend build` to serve the UI from here, or `pnpm dev:frontend` for UI work.',
+ );
+ }
+
// After createServerApp so every request-reply route is registered before
// the executor starts consuming messages. The executor needs a dedicated
// subscriber connection (a subscribed client cannot issue normal commands);
@@ -97,7 +108,7 @@ try {
await requestReplyExecutor.init();
const server = serve({ fetch: app.fetch, port: configuration.PORT }, info => {
- console.log(`Agent server listening on http://localhost:${String(info.port)} (docs at /docs)`);
+ console.log(`Agent server listening on http://localhost:${String(info.port)} (docs at /api/v1/docs)`);
});
server.on('error', (error: unknown) => {
diff --git a/packages/server/src/routes/sessionRoutes.ts b/packages/server/src/routes/sessionRoutes.ts
index dd4386991..af4d16c8b 100644
--- a/packages/server/src/routes/sessionRoutes.ts
+++ b/packages/server/src/routes/sessionRoutes.ts
@@ -1,5 +1,5 @@
/**
- * Session route definitions (mounted at /v1/sessions). A session holds an
+ * Session route definitions (mounted at /api/v1/sessions). A session holds an
* inline agent spec. Handlers are registered in apis/sessions.ts.
*/
import { createRoute, z } from '@hono/zod-openapi';
diff --git a/packages/server/src/routes/turnRoutes.ts b/packages/server/src/routes/turnRoutes.ts
index 5da36a7b1..5202a728a 100644
--- a/packages/server/src/routes/turnRoutes.ts
+++ b/packages/server/src/routes/turnRoutes.ts
@@ -1,5 +1,5 @@
/**
- * Turn route definitions (mounted at /v1/sessions). Creating a turn responds
+ * Turn route definitions (mounted at /api/v1/sessions). Creating a turn responds
* with a Server-Sent Events stream; a running turn can be re-subscribed to
* with resume support. Handlers are registered in apis/turns.ts.
*/
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 1239f8da0..4075c23bb 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -100,6 +100,9 @@ importers:
vite:
specifier: ^6.3.5
+ vite-plugin-compression2:
+ specifier: ^2.5.3
+ version: 2.5.3([email protected])
vite-plugin-monaco-editor-esm:
specifier: ^2.0.2
version: 2.0.2([email protected])
@@ -2553,6 +2556,15 @@ packages:
'@rolldown/[email protected]':
resolution: {integrity: sha512-+d0F4MKMCbeVUJwG96uQ4SgAznZNSq93I3V+9NHA4OpvqG8mRCpGdKmK8l/dl02h2CCDHwW2FqilnTyDcAnqjA==}
+ '@rollup/[email protected]':
+ resolution: {integrity: sha512-MfPp06CjRLfXQ3wY0R8vJDYBy/MvVcc9OulEfR0B8Iv9ko+GCNaRZ+EpJYFl27LhKsZK0o420sYCRHCjfCgeUg==}
+ engines: {node: '>=14.0.0'}
+ peerDependencies:
+ rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
'@rollup/[email protected]':
resolution: {integrity: sha512-6o7ZLZK+BeenkZCFNDXqpbjw9bD6nuWonvS/lwQJp7NoVVxm6p3qE7qQ5jGuBjiFsgvqjD8mZAU5oWxTmbOeOg==}
cpu: [arm]
@@ -3945,6 +3957,9 @@ packages:
resolution: {integrity: sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==}
+ resolution: {integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==}
+
resolution: {integrity: sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==}
engines: {node: '>=0.10.0'}
@@ -5813,6 +5828,9 @@ packages:
engines: {node: '>=14.0.0'}
hasBin: true
+ resolution: {integrity: sha512-+qfUHz700DWnRutdUsxRRVZ38G1Qr27OetwaMYTdg8hcPxf46U0S1Zf76dQMWRBmusOt2ZCK5kbIaiLkoGO7WQ==}
+
resolution: {integrity: sha512-XdhtCvlMywwxpCW8YEq3lOXBJpUPTR2OHHcwLPO3HwsJqOHa2Ok/oJ7ruGzp+JrKoRPVCzJwAdEjqLW/vNRPHA==}
engines: {node: '>=18'}
@@ -6106,6 +6124,9 @@ packages:
resolution: {integrity: sha512-PnpQQMuxlwYdocC8fIJqVXvkeViHYzotI+NJrCuav0ZYFoq912ZHBk3mCeuj+5/VpodOjPe1z0Fk2ihgzlXqjQ==}
+ resolution: {integrity: sha512-ItPgqQWkcnBbVw7is9OKwiZ8v6+ju9rYROl5Lp6QfQDEx/d55AwJQb/KLpsQqsU9HoigYBsZ8tK6I02UwJNvEw==}
+
resolution: {integrity: sha512-XVkOpL/r0rw1NpbO30vUwG4S0THkC9KB1vjjV8olGd49h4/EQsKl3DrxB6KRDwyZNC9mKiiZgk2L6njUYj3oKQ==}
peerDependencies:
@@ -8884,6 +8905,14 @@ snapshots:
'@rolldown/[email protected]': {}
+ dependencies:
+ '@types/estree': 1.0.9
+ estree-walker: 2.0.2
+ picomatch: 4.0.5
+ optionalDependencies:
+ rollup: 4.62.2
+
'@rollup/[email protected]':
optional: true
@@ -10297,6 +10326,8 @@ snapshots:
+
@@ -12760,6 +12791,8 @@ snapshots:
transitivePeerDependencies:
- ts-node
+
dependencies:
'@isaacs/fs-minipass': 4.0.1
@@ -13089,6 +13122,13 @@ snapshots:
d3-time: 3.1.0
d3-timer: 3.0.1
+ dependencies:
+ '@rollup/pluginutils': 5.4.0([email protected])
+ tar-mini: 0.2.0
+ transitivePeerDependencies:
+ - rollup
+
dependencies:
monaco-editor: 0.52.2