Skip to content

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

fix: trueforge adapter is now part of the frontend sdk (#225)

Govinda Vashishthaf1f09fb2ac01
diff --git a/docs/ui-sdk/get-started/quickstart.mdx b/docs/ui-sdk/get-started/quickstart.mdx
index 63068e343..2b64f8f10 100644
--- a/docs/ui-sdk/get-started/quickstart.mdx
+++ b/docs/ui-sdk/get-started/quickstart.mdx
@@ -1,6 +1,6 @@
---
title: "Quickstart"
-description: "Render a working agent chat UI"
+description: "Render a working agent chat UI against a TrueForge server"
---
## Installation
@@ -8,36 +8,124 @@ description: "Render a working agent chat UI"
<CodeGroup>
```shellscript npm
-npm install @truefoundry/trueforge-ui
+npm install @truefoundry/trueforge-ui @truefoundry/trueforge-sdk
```
```text pnpm
-pnpm add @truefoundry/trueforge-ui
+pnpm add @truefoundry/trueforge-ui @truefoundry/trueforge-sdk
```
```text yarn
-yarn add @truefoundry/agent-ui-sdk
+yarn add @truefoundry/trueforge-ui @truefoundry/trueforge-sdk
```
</CodeGroup>
`react` and `react-dom` are required peer dependencies and must be version 18 or 19.
+`@truefoundry/trueforge-sdk` is the HTTP client used by the built-in Harness adapter
+(`type: "trueforge"`). It stays external to the UI bundle — install it alongside the UI package.
+
## Connect with TrueForge Server
-Typed for hosts adopting the harness adapter.
+Pass `server={{ type: "trueforge", … }}`. The SDK dynamically loads
+`@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter`, builds the HTTP client, and
+composes chat + builder + default settings catalogs into an `AgentUIServer`.
+
+Auth is host-owned: use a **Bearer `token`** for embeds / remote APIs, or inject **`fetch`** for
+same-origin cookie / OIDC sessions. `baseUrl` defaults to `'/'`.
+
+### Bearer token
+
+```tsx App.tsx
+import { TrueforgeUI } from "@truefoundry/trueforge-ui";
+
+export default function App() {
+ return (
+ <div style={{ height: "100dvh" }}>
+ <TrueforgeUI
+ server={{
+ type: "trueforge",
+ baseUrl: "http://localhost:8790", // optional; default '/'
+ token: process.env.TRUEFORGE_TOKEN!,
+ }}
+ layout="sidebar"
+ />
+ </div>
+ );
+}
+```
+
+### Cookie / same-origin hosts
+
+Omit `token` and pass a custom `fetch` (for example an auth-aware wrapper that follows OIDC cookies
+and redirects on HTTP 401):
+
+```tsx App.tsx
+import { TrueforgeUI } from "@truefoundry/trueforge-ui";
+
+export default function App({ authAwareFetch }: { authAwareFetch: typeof fetch }) {
+ return (
+ <div style={{ height: "100dvh" }}>
+ <TrueforgeUI
+ server={{
+ type: "trueforge",
+ baseUrl: "/",
+ fetch: authAwareFetch,
+ }}
+ layout="sidebar"
+ agentConfig={{
+ mode: "AgentLibraryWithComposer",
+ // Seed from your models list at boot when the composer needs a default.
+ defaultAgentSpec: { model: { name: "openai-main/gpt-4.1" } },
+ }}
+ />
+ </div>
+ );
+}
+```
+
+Optional: pass `catalog` on the config to override the built-in settings catalogs.
+
+Because this config is resolved asynchronously (dynamic import of the adapter), the SDK shows a
+brief loading indicator before the chat appears.
+
+## Build the server yourself
+
+If you need the resolved `AgentUIServer` outside `<TrueforgeUI />` — to wrap it, log through it, or
+pass it around before mounting — use the plugin factory:
```tsx
-<TrueforgeUI
- server={{
- type: "trueforge",
- baseUrl: 'http://localhost:8790'
- }}
-/>
+import { createTrueForgeAgentUIServer } from "@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter";
+import { TrueforgeUI } from "@truefoundry/trueforge-ui";
+
+const server = createTrueForgeAgentUIServer({
+ baseUrl: "http://localhost:8790",
+ token: process.env.TRUEFORGE_TOKEN!,
+});
+
+export default function App() {
+ return (
+ <div style={{ height: "100dvh" }}>
+ <TrueforgeUI server={server} layout="sidebar" />
+ </div>
+ );
+}
```
+## Other backends
+
+| Path | Docs |
+| --- | --- |
+| TrueFoundry control plane (`type: "truefoundry"`) | [Connect with TrueFoundry](/ui-sdk/setup-custom-servers/connect-with-truefoundry) |
+| Bring your own `AgentUIServer` | [Custom server](/ui-sdk/setup-custom-servers/custom-server) |
+| Full `server` type union | [Server contract](/ui-sdk/setup-custom-servers/server-contract) |
+
## Rendered UI
-When you run the app, you get a fully functional agent chat experience out of the box, with streaming responses, conversation history, and tool-call support.
+
+When you run the app, you get a fully functional agent chat experience out of the box, with
+streaming responses, conversation history, and tool-call support.
+
<Frame caption="What `TrueforgeUI` renders — a full agent chat with streaming, history, and tool calls.">
![The TrueforgeUI component rendering an agent chat with an agent-steps panel and a streamed response](/images/agent-composer-with-library.png)
-</Frame>
\ No newline at end of file
+</Frame>
diff --git a/docs/ui-sdk/guides/troubleshooting.mdx b/docs/ui-sdk/guides/troubleshooting.mdx
index ff4f88bef..f64b853cd 100644
--- a/docs/ui-sdk/guides/troubleshooting.mdx
+++ b/docs/ui-sdk/guides/troubleshooting.mdx
@@ -60,9 +60,10 @@ description: "Common failure modes and their causes."
</Accordion>
<Accordion title="An error alert appears immediately on mount">
- If you passed `type: "trueforge"`, that is expected — the harness adapter has not shipped, so it resolves to a not-implemented error. Use `type: "truefoundry"` or a [custom server](/ui-sdk/guides/custom-server) instead.
-
- Otherwise the server failed to resolve: check that `apiKey` and `controlPlaneURL` are set and reachable. Attach an `onError` handler to see the underlying error.
+ The built-in server failed to resolve. For `type: "trueforge"`, confirm `@truefoundry/trueforge-sdk`
+ is installed, `baseUrl` is reachable, and you passed either `token` or a working `fetch` — see
+ [Quickstart](/ui-sdk/get-started/quickstart). For `type: "truefoundry"`, check that `apiKey` and
+ `controlPlaneURL` are set and reachable. Attach an `onError` handler to see the underlying error.
</Accordion>
<Accordion title="Requests fail in composer mode with an unknown model">
diff --git a/docs/ui-sdk/reference/trueforge-ui.mdx b/docs/ui-sdk/reference/trueforge-ui.mdx
index f71ae6573..8c2f4dc9b 100644
--- a/docs/ui-sdk/reference/trueforge-ui.mdx
+++ b/docs/ui-sdk/reference/trueforge-ui.mdx
@@ -15,11 +15,12 @@ import { TrueforgeUI } from "@truefoundry/trueforge-ui";
<Expandable title="TrueforgeServerConfig">
<ParamField path="type" type='"truefoundry" | "trueforge"'>
Omit entirely to pass an `AgentUIServer` object directly — there is no `"custom"` wrapper.
- `"trueforge"` is typed for the forthcoming harness adapter and currently resolves to a
- not-implemented error.
+ `"trueforge"` loads the Harness adapter (`plugins/trueforge-agent-server-adapter`). See
+ [Quickstart](/ui-sdk/get-started/quickstart).
</ParamField>
<ParamField path="apiKey" type="string" required>
- Required by both built-in types. Client-side keys are for local development only.
+ TrueFoundry API key. Required when `type` is `"truefoundry"`. Client-side keys are for local
+ development only.
</ParamField>
<ParamField path="controlPlaneURL" type="string" required>
TrueFoundry control plane URL. Required when `type` is `"truefoundry"`.
@@ -27,12 +28,22 @@ import { TrueforgeUI } from "@truefoundry/trueforge-ui";
<ParamField path="gatewayPlaneURL" type="string">
Target a specific gateway. Resolved from the control plane when omitted.
</ParamField>
+ <ParamField path="baseUrl" type="string">
+ TrueForge / Harness API root. Used when `type` is `"trueforge"`. Defaults to `'/'`.
+ </ParamField>
+ <ParamField path="token" type="string">
+ Bearer token for `@truefoundry/trueforge-sdk` when `type` is `"trueforge"`. Prefer `fetch` for
+ cookie / OIDC hosts.
+ </ParamField>
+ <ParamField path="fetch" type="typeof fetch">
+ Custom fetch for `type: "trueforge"` (cookie sessions, auth interceptors).
+ </ParamField>
<ParamField path="catalog" type="CatalogServer">
- Attach to enable the settings panel. See [Settings catalog](/ui-sdk/reference/catalog).
+ Attach or override settings catalogs. See [Settings catalog](/ui-sdk/reference/catalog).
</ParamField>
</Expandable>
- See [Server contract](/ui-sdk/concepts/server-contract).
+ See [Server contract](/ui-sdk/setup-custom-servers/server-contract).
</ParamField>
<ParamField path="layout" type="LayoutProp" required>
diff --git a/docs/ui-sdk/setup-custom-servers/server-contract.mdx b/docs/ui-sdk/setup-custom-servers/server-contract.mdx
index 76a7dca77..95700c0b4 100644
--- a/docs/ui-sdk/setup-custom-servers/server-contract.mdx
+++ b/docs/ui-sdk/setup-custom-servers/server-contract.mdx
@@ -14,13 +14,25 @@ type TrueforgeServerConfig =
gatewayPlaneURL?: string;
catalog?: CatalogServer;
}
- | ({ type: "trueforge"; apiKey: string; catalog?: CatalogServer } & Record<string, unknown>)
+ | {
+ type: "trueforge";
+ baseUrl?: string;
+ token?: string;
+ fetch?: typeof fetch;
+ catalog?: CatalogServer;
+ }
| AgentUIServer;
```
-Each form resolves differently. An `AgentUIServer` object is used immediately. A `truefoundry` config is resolved asynchronously, so the SDK renders a loading indicator (`role="status"`) for a moment first. A `trueforge` config is typed for the forthcoming harness adapter and currently resolves to a not-implemented error — see [Quickstart](/ui-sdk/get-started/quickstart#trueforge).
+Each form resolves differently. An `AgentUIServer` object is used immediately. Built-in configs
+(`truefoundry` / `trueforge`) resolve asynchronously, so the SDK renders a loading indicator
+(`role="status"`) for a moment first. `type: "trueforge"` loads
+`plugins/trueforge-agent-server-adapter` and composes a full Harness `AgentUIServer` — see
+[Quickstart](/ui-sdk/get-started/quickstart).
-`catalog` is optional on both built-in forms and is attached to the resolved server, which is how you enable the [settings UI](/ui-sdk/reference/catalog) without hand-building a server.
+`catalog` is optional on both built-in forms. For `truefoundry` it is attached after resolution; for
+`trueforge` it overrides the adapter's default settings catalogs. Either way it enables the
+[settings UI](/ui-sdk/reference/catalog) without hand-building a server.
## The composed contract
diff --git a/package.json b/package.json
index 5615c4303..0d6f485a8 100644
--- a/package.json
+++ b/package.json
@@ -6,7 +6,7 @@
"node": ">=22.13.0"
},
"scripts": {
- "build": "pnpm --filter @truefoundry/trueforge-core build && pnpm --filter @truefoundry/trueforge-ui build && pnpm --filter frontend build && pnpm --filter @truefoundry/trueforge build",
+ "build": "pnpm --filter @truefoundry/trueforge-core build && pnpm --filter @truefoundry/trueforge-sdk build && pnpm --filter @truefoundry/trueforge-ui build && pnpm --filter frontend build && pnpm --filter @truefoundry/trueforge build",
"chart:deps": "helm dependency build charts/truefoundry-utils",
"chart:lint": "helm lint charts/truefoundry-utils --values charts/truefoundry-utils/ci/lint-values.yaml",
"chart:package": "helm package charts/truefoundry-utils --destination dist",
diff --git a/packages/frontend/README.md b/packages/frontend/README.md
index d27b82342..ba25fd935 100644
--- a/packages/frontend/README.md
+++ b/packages/frontend/README.md
@@ -5,17 +5,22 @@ Private agent chat UI for the harness server (registry + inline sessions). **Not
Built on:
```
-trueforge (local Harness SDK)
- → Harness AgentChatServer adapter
- → createTrueFoundryServer (chat port + catalog callbacks)
- → @truefoundry/trueforge-ui (TrueforgeUI, layout="sidebar")
+@truefoundry/trueforge-sdk (HTTP client; cookie/OIDC via host fetch)
+ → @truefoundry/trueforge-ui
+ server={{ type: 'trueforge', baseUrl, fetch }}
+ → plugins/trueforge-agent-server-adapter
+ (chat + builder + settings catalogs)
+ → TrueforgeUI (layout="sidebar")
```
-The SDK owns the shell: sidebar, thread list, composer, model and connector pickers, and the
-runtime wiring. [`App.tsx`](src/App.tsx) only seeds `defaultAgentSpec` from the Harness catalogs
-and renders the API error card.
+[`App.tsx`](src/App.tsx) owns product chrome only:
-No login is required.
+- auth gate / welcome / logout (`authFetch`, `authSession`)
+- boot: first model → `defaultAgentSpec`, `initialSettingsOpen`
+- `<TrueforgeUI server={{ type: 'trueforge', baseUrl: '/', fetch: authAwareFetch }} />`
+
+Chat, agent library, and settings catalogs are composed inside the UI SDK plugin —
+the host does **not** call `createTrueFoundryServer` or maintain harness adapters.
## Local development
@@ -29,25 +34,29 @@ pnpm dev:infra # then in another terminal:
pnpm dev # Postgres + Redis, Vite :3000 + API :8790
```
-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`. Vite uses `strictPort` — if that port is already bound, dev exits instead of
-picking another. 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.
+Open `http://localhost:3000`: Vite serves the UI from source (edits hot-reload) and
+proxies `/api/*` to `VITE_SERVER_URL` (default `http://localhost:8790`).
+`FRONTEND_PORT` moves Vite off `:3000`. Vite uses `strictPort` — if that port is
+already bound, dev exits instead of picking another. Proxy wiring lives in
+[`vite.config.ts`](vite.config.ts).
+
+`predev` / `prebuild` / `pretypecheck` build `@truefoundry/trueforge-sdk` and
+`@truefoundry/trueforge-ui` first so clean checkouts do not rely on stale `dist/`.
-### Server adapter
+### Auth
-[`src/harnessServer.ts`](src/harnessServer.ts) wraps the Harness SDK with the flat `AgentChatServer`
-contract. It maps mutable session DTOs, pagination, turns, event history, turn subscribe/resume,
-cancellation, and SSE metadata while keeping the browser pointed directly at `/api/v1/sessions`.
+[`authFetch.ts`](src/authFetch.ts) wraps `fetch` and redirects to OIDC login on HTTP 401.
+[`authSession.ts`](src/authSession.ts) probes `/me` with a non-redirecting client so the
+welcome screen can show before login. Pass the auth-aware `fetch` into
+`server={{ type: 'trueforge', fetch }}` so the built-in Harness adapter shares the same
+session cookies.
-`trueforge-ui` still declares the pre-0.1.6 contract (mounts carry `id`, list results are
-`PageResult`, absent values are `undefined`) while the runtime it delegates to reads `nextPageToken`
-and tolerates `null`. The adapter emits values valid under both — derived mount ids, pages carrying
-`nextPageToken` _and_ `hasNextPage()`, `null` normalised to absent — so no layer needs a cast.
+### Server adapter (in the UI package)
-The local SDK is linked as `trueforge`. Frontend dev, typecheck, test, and build scripts build it first,
-so clean checkouts do not rely on committed `dist/` output.
+Harness ↔ `AgentUIServer` mapping lives in
+[`@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter`](../trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/).
+Hosts that need the factory outside `<TrueforgeUI />` can import
+`createTrueForgeAgentUIServer` from that subpath.
## Production
@@ -60,29 +69,6 @@ those on the fly.
docker compose up --build # UI + API on http://localhost:8791
```
-## Composer lists + builder (model + MCP + skills)
-
-[`src/composerLists.ts`](src/composerLists.ts) calls the DB-backed list endpoints via `trueforge`.
-[`src/harnessBuilderServer.ts`](src/harnessBuilderServer.ts) maps those into `AgentBuilderServer`
-callbacks; `App.tsx` spreads them into `createTrueFoundryServer` (settings CRUD lives in `*Catalog.ts`):
-
-| Callback | Source |
-| -------------- | ----------------------------------------------------------------- |
-| `getModels` | `GET /api/v1/models` (also seeds `defaultAgentSpec.model`) |
-| `getMcp` | `GET /api/v1/mcp-servers` (name/url + per-user auth_status) |
-| `getSkills` | `GET /api/v1/skills` when `GET /api/v1/capabilities` has skill on |
-| `searchAgents` | `GET /api/v1/agents`, filtered by `query` and paged client-side |
-| `saveAgent` | `PUT`/`POST /api/v1/agents` — updates by name, else creates |
-
-The SDK's picker round-trips a skill as `{ id, name }`. Harness persists name refs only
-(`{ name }`), so `harnessServer` derives `id` from `name` on read and strips `id` on write.
-Skills stay empty in the picker when the skill capability is off (no sandbox provider configured).
-
-The Agents Library lists the registry, so sessions bind either to a registry agent (`{ name }`) or
-to an inline spec (`{ spec }`). Reads name their agent on the `reference` arm, so the adapter never
-resolves display names through the registry. History filtering forwards the library `agentId`
-straight to `GET /sessions?agent_id=`.
-
## Gaps
| Item | Status |
@@ -99,3 +85,4 @@ straight to `GET /sessions?agent_id=`.
| `pnpm dev` | Vite dev server |
| `pnpm build` | Typecheck + production bundle |
| `pnpm typecheck` | `tsc --noEmit` |
+| `pnpm test` | Auth unit tests |
diff --git a/packages/frontend/src/App.tsx b/packages/frontend/src/App.tsx
index cc8f978e5..fb05163ec 100644
--- a/packages/frontend/src/App.tsx
+++ b/packages/frontend/src/App.tsx
@@ -1,36 +1,21 @@
+import { getErrorMessage, ThemeProvider, TrueforgeUI, type SlotOverrides } from '@truefoundry/trueforge-ui';
import {
- createTrueFoundryServer,
- getErrorMessage,
- ThemeProvider,
- TrueforgeUI,
- type SlotOverrides,
-} from '@truefoundry/trueforge-ui';
+ createTrueForgeClient,
+ getCapabilities,
+ listModels,
+ type HarnessAgentSpec,
+} from '@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter';
import { useEffect, useMemo, useState } from 'react';
import { AuthErrorScreen } from './AuthErrorScreen';
+import { createAuthAwareFetch } from './authFetch';
import { probeSession, type SessionState } from './authSession';
import { parseAuthErrorReason } from './authStatusSearch';
-import { getCapabilities, listModels } from './composerLists';
-import { createConnectorCatalog } from './connectorCatalog';
import { GetStartedScreen } from './GetStartedScreen';
-import { createHarnessBuilderServer } from './harnessBuilderServer';
-import { createHarnessChatServer, type HarnessAgentSpec } from './harnessServer';
import { LogoutButton } from './LogoutButton';
-import { createModelProviderCatalog } from './modelProviderCatalog';
-import { createSandboxProviderCatalog } from './sandboxProviderCatalog';
-import { createSkillCatalog } from './skillCatalog';
-const chatServer = createHarnessChatServer();
-
-const server = createTrueFoundryServer<HarnessAgentSpec>({
- chatServer,
- ...createHarnessBuilderServer(),
- catalog: {
- modelCatalog: createModelProviderCatalog(),
- connectorCatalog: createConnectorCatalog(),
- skillCatalog: createSkillCatalog(),
- sandboxCatalog: createSandboxProviderCatalog(),
- },
-});
+/** Shared cookie/OIDC fetch for boot helpers and `<TrueforgeUI server />`. */
+const authAwareFetch = createAuthAwareFetch();
+const bootClient = createTrueForgeClient({ fetch: authAwareFetch });
type BootState =
| { status: 'loading' }
@@ -66,7 +51,7 @@ export function App() {
const state = { cancelled: false };
void (async () => {
try {
- const [models, capabilities] = await Promise.all([listModels(), getCapabilities()]);
+ const [models, capabilities] = await Promise.all([listModels(bootClient), getCapabilities(bootClient)]);
if (state.cancelled) {
return;
}
@@ -150,7 +135,7 @@ export function App() {
return (
<div className="app-root">
<TrueforgeUI
- server={server}
+ server={{ type: 'trueforge', baseUrl: '/', fetch: authAwareFetch }}
theme={{
brand: {
name: 'TrueForge',
diff --git a/packages/frontend/src/authSession.ts b/packages/frontend/src/authSession.ts
index dc1275060..8432e0f89 100644
--- a/packages/frontend/src/authSession.ts
+++ b/packages/frontend/src/authSession.ts
@@ -2,11 +2,28 @@
* Session helpers: SDK `auth.me()` / `auth.logout()` only.
* Login is not on the SDK (browser redirect to `/api/v1/auth/login`).
*/
-import type { TrueForge, TrueForgeApi } from '@truefoundry/trueforge-sdk';
-import { harnessClient, harnessProbeClient } from './harnessClient';
+import { TrueForge as TrueForgeClient, type TrueForge, type TrueForgeApi } from '@truefoundry/trueforge-sdk';
+import { createAuthAwareFetch } from './authFetch';
export type MeResponse = TrueForgeApi.MeResponse;
+const DEFAULT_BASE_URL = '/';
+
+/** Authenticated API client — 401 redirects to OIDC login. */
+const authClient = new TrueForgeClient({
+ baseUrl: DEFAULT_BASE_URL,
+ fetch: createAuthAwareFetch(),
+});
+
+/**
+ * Client for the pre-boot session probe. Unlike {@link authClient} it does NOT
+ * redirect on 401, so the welcome gate can observe the unauthenticated state.
+ */
+const probeClient = new TrueForgeClient({
+ baseUrl: DEFAULT_BASE_URL,
+ fetch: globalThis.fetch.bind(globalThis),
+});
+
/** Result of the pre-boot session probe. */
export type SessionState = 'authenticated' | 'unauthenticated';
@@ -26,14 +43,14 @@ export function resetOidcSessionCacheForTests(): void {
* True when the current session is a browser OIDC login (`type: "oidc-connected"`).
* When auth is enabled, unauthenticated callers get HTTP 401 from `/me`.
*/
-export async function isOidcConnectedSession(client: TrueForge = harnessClient): Promise<boolean> {
+export async function isOidcConnectedSession(client: TrueForge = authClient): Promise<boolean> {
const session = await client.auth.me();
const isConnected = session.type === 'oidc-connected';
cachedIsOidcConnected = isConnected;
return isConnected;
}
-export async function logout(client: TrueForge = harnessClient): Promise<void> {
+export async function logout(client: TrueForge = authClient): Promise<void> {
await client.auth.logout();
}
@@ -43,7 +60,7 @@ export async function logout(client: TrueForge = harnessClient): Promise<void> {
* unauthenticated so the app can render the welcome / "Let's Get Started" screen
* rather than bouncing to login before the user asks for it.
*/
-export async function probeSession(client: TrueForge = harnessProbeClient): Promise<SessionState> {
+export async function probeSession(client: TrueForge = probeClient): Promise<SessionState> {
try {
await client.auth.me();
return 'authenticated';
diff --git a/packages/frontend/src/composerLists.ts b/packages/frontend/src/composerLists.ts
deleted file mode 100644
index 016867d15..000000000
--- a/packages/frontend/src/composerLists.ts
+++ /dev/null
@@ -1,25 +0,0 @@
-/**
- * Configured-resource list helpers for composer pickers and app boot.
- * Not the settings catalog ports (`*Catalog.ts`).
- */
-import type { TrueForgeApi } from '@truefoundry/trueforge-sdk';
-import { harnessClient as client } from './harnessClient';
-
-export async function listModels(): Promise<TrueForgeApi.Model[]> {
- const body = await client.models.list();
- return body.data;
-}
-export async function listConfiguredMcpServers(): Promise<TrueForgeApi.McpServerReadEntry[]> {
- const body = await client.mcpServers.list();
- return body.data;
-}
-
-export async function listSkills(): Promise<TrueForgeApi.SkillReadEntry[]> {
- const body = await client.skills.list();
- return body.data;
-}
-
-export async function getCapabilities(): Promise<TrueForgeApi.GetCapabilitiesResponseData> {
- const body = await client.server.getCapabilities();
- return body.data;
-}
diff --git a/packages/frontend/src/harnessClient.ts b/packages/frontend/src/harnessClient.ts
deleted file mode 100644
index ad6625446..000000000
--- a/packages/frontend/src/harnessClient.ts
+++ /dev/null
@@ -1,37 +0,0 @@
-/**
- * Shared TrueForge HTTP client for the Harness host app.
- * One place for baseUrl / future auth (headers, API key) so catalog adapters
- * and the chat server do not each construct their own client.
- *
- * Default `fetch` intercepts 401 and sends the browser through OIDC login.
- */
-import { TrueForge } from '@truefoundry/trueforge-sdk';
-import { createAuthAwareFetch } from './authFetch';
-
-export interface CreateHarnessClientOptions {
- baseUrl?: string;
- fetch?: typeof fetch;
-}
-
-const DEFAULT_BASE_URL = '/';
-
-export function createHarnessClient(options: CreateHarnessClientOptions = {}): TrueForge {
- return new TrueForge({
- baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
- fetch: createAuthAwareFetch(options.fetch ?? globalThis.fetch.bind(globalThis)),
- });
-}
-
-/** Default browser client — Vite proxies `/api/*` to the Harness server. */
-export const harnessClient = createHarnessClient();
-
-/**
- * Client for the pre-boot session probe. Unlike {@link harnessClient} it does NOT
- * redirect on 401, so the welcome gate can observe the unauthenticated state
- * (auth enabled but no session cookie yet) and render "Let's Get Started"
- * instead of bouncing straight to the login flow.
- */
-export const harnessProbeClient = new TrueForge({
- baseUrl: DEFAULT_BASE_URL,
- fetch: globalThis.fetch.bind(globalThis),
-});
diff --git a/packages/trueforge-ui-sdk/CHANGELOG.md b/packages/trueforge-ui-sdk/CHANGELOG.md
index e3ebc7b23..784dc760c 100644
--- a/packages/trueforge-ui-sdk/CHANGELOG.md
+++ b/packages/trueforge-ui-sdk/CHANGELOG.md
@@ -9,6 +9,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
### Added
+- **`type: "trueforge"` built-in server** — `<TrueforgeUI server={{ type: 'trueforge', baseUrl?, token?, fetch? }} />`
+ resolves a full Harness `AgentUIServer` via
+ `@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter`
+ (`createTrueForgeAgentUIServer`), including chat, builder, and default settings
+ catalogs. Depends on `@truefoundry/trueforge-sdk` (workspace:* in-monorepo; external in the bundle).
- **Light/dark brand logo** — `theme.brand.logo` accepts a `BrandLogoConfig`
(`{ src?, light?, dark?, href? }`). The source is picked from the resolved theme
mode, falling back to the other mode and then `src`, so a single configured mode
diff --git a/packages/trueforge-ui-sdk/README.md b/packages/trueforge-ui-sdk/README.md
index 6395feafd..d3d9d53cc 100644
--- a/packages/trueforge-ui-sdk/README.md
+++ b/packages/trueforge-ui-sdk/README.md
@@ -102,21 +102,63 @@ export default function App() {
}
```
-**TrueForge** (`type: "trueforge"`) — harness (coming soon)
+**TrueForge** (`type: "trueforge"`) — Harness
-Typed for hosts adopting the harness adapter; selecting it currently surfaces a
-not-implemented error until the adapter ships.
+Zero-config path for the TrueForge / Harness API. The SDK dynamically loads
+`@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter`, builds the
+HTTP client, and composes chat + builder + default settings catalogs into an
+`AgentUIServer`.
+
+Install the SDK peer used by the adapter (workspace package in this monorepo):
+
+```bash
+pnpm add @truefoundry/trueforge-sdk
+```
+
+**Bearer token (embeds / remote API):**
+
+```tsx
+import { TrueforgeUI } from '@truefoundry/trueforge-ui';
+
+export default function App() {
+ return (
+ <div style={{ height: '100dvh' }}>
+ <TrueforgeUI
+ server={{
+ type: 'trueforge',
+ baseUrl: process.env.TRUEFORGE_BASE_URL, // optional; default '/'
+ token: process.env.TRUEFORGE_TOKEN!,
+ }}
+ layout="sidebar"
+ />
+ </div>
+ );
+}
+```
+
+**Cookie / same-origin hosts** — omit `token` and inject `fetch` (e.g. an
+auth-aware wrapper that follows OIDC cookies):
```tsx
<TrueforgeUI
server={{
type: 'trueforge',
- apiKey: process.env.TFY_API_KEY!,
+ baseUrl: '/',
+ fetch: authAwareFetch,
}}
layout="sidebar"
+ agentConfig={{
+ mode: 'AgentLibraryWithComposer',
+ defaultAgentSpec: { model: { name: '…' } }, // often seeded at boot from listModels
+ }}
/>
```
+Optional: pass `catalog` to override the built-in settings catalogs, or import
+`createTrueForgeAgentUIServer` from
+`@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter` when you need
+the factory outside `<TrueforgeUI />`.
+
**Custom** — bring your own `AgentUIServer`
Use this when you compose chat + builder yourself (e.g. chat-only gateway
@@ -159,7 +201,7 @@ export default function App() {
type: 'truefoundry',
apiKey: process.env.TFY_API_KEY!,
controlPlaneURL: process.env.TFY_CONTROL_PLANE_URL!,
- }} // or agentServer / { type: "trueforge", apiKey }
+ }} // or agentServer / { type: "trueforge", token?, baseUrl?, fetch? }
layout="sidebar" // 'sidebar' | 'drawer' | 'dock' | 'widget' | CustomLayout
agentConfig={{
mode: 'AgentLibraryWithComposer', // default when omitted
@@ -469,7 +511,13 @@ type TrueforgeServerConfig =
controlPlaneURL: string;
gatewayPlaneURL?: string;
}
- | { type: 'trueforge'; apiKey: string /* + open extras later */ }
+ | {
+ type: 'trueforge';
+ baseUrl?: string;
+ token?: string;
+ fetch?: typeof fetch;
+ catalog?: CatalogServer;
+ }
| AgentUIServer;
type AgentUIServer = AgentChatServer & AgentBuilderServer & { catalog?: CatalogServer };
@@ -482,6 +530,12 @@ type AgentUIServer = AgentChatServer & AgentBuilderServer & { catalog?: CatalogS
**Zero-config TrueFoundry** — see [Getting started](#getting-started). The SDK calls `createTrueFoundryAgentUIServer` for you.
+**Zero-config TrueForge (Harness)** — see [Getting started](#getting-started).
+`type: "trueforge"` resolves via
+`@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter`
+(`createTrueForgeAgentUIServer`: chat + builder + default catalogs). Auth is
+host-owned: pass `token` and/or `fetch`.
+
**Compose your own `AgentUIServer` (custom):**
```tsx
@@ -531,18 +585,19 @@ See [docs/server.md](./docs/server.md) for the full method list and BYO guidance
## Exports
-| Export | Kind | Purpose |
-| ------------------------------------------------------------ | ---------- | ------------------------------------------------------------ |
-| `TrueforgeUI` | Component | Root component — accepts all props above |
-| `TrueforgeServerConfig` | Type | `server` prop: `truefoundry` / `trueforge` / `AgentUIServer` |
-| `createTrueFoundryServer` | Function | Compose chat + builder into `AgentUIServer` |
-| `Thread`, `ThreadListContainer`, `BrandLogo` | Components | Layout primitives for custom layouts |
-| Composer / message / tool atoms | Components | Overridable, themeable building blocks |
-| `SlotsProvider`, `useSlot`, `useTheme` | API | Overrides + theme mode |
-| `AgentUIServer`, `AgentChatServer`, `AgentBuilderServer` | Types | Resolved server contract |
-| `ThemeConfig`, `LayoutProp`, `SlotOverrides`, `AgentSpec`, … | Types | Configuration contracts |
-| `@truefoundry/trueforge-ui/styles.css` | CSS | Optional; auto-injected by `ThemeProvider` |
-| `@truefoundry/trueforge-ui/assistant-ui` | Entry | Shared `useAui` / `useAuiState` (single instance) |
+| Export | Kind | Purpose |
+| ------------------------------------------------------------------ | ---------- | ------------------------------------------------------------ |
+| `TrueforgeUI` | Component | Root component — accepts all props above |
+| `TrueforgeServerConfig` | Type | `server` prop: `truefoundry` / `trueforge` / `AgentUIServer` |
+| `createTrueFoundryServer` | Function | Compose chat + builder into `AgentUIServer` |
+| `Thread`, `ThreadListContainer`, `BrandLogo` | Components | Layout primitives for custom layouts |
+| Composer / message / tool atoms | Components | Overridable, themeable building blocks |
+| `SlotsProvider`, `useSlot`, `useTheme` | API | Overrides + theme mode |
+| `AgentUIServer`, `AgentChatServer`, `AgentBuilderServer` | Types | Resolved server contract |
+| `ThemeConfig`, `LayoutProp`, `SlotOverrides`, `AgentSpec`, … | Types | Configuration contracts |
+| `@truefoundry/trueforge-ui/styles.css` | CSS | Optional; auto-injected by `ThemeProvider` |
+| `@truefoundry/trueforge-ui/assistant-ui` | Entry | Shared `useAui` / `useAuiState` (single instance) |
+| `@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter` | Entry | `createTrueForgeAgentUIServer` + Harness catalogs / chat |
Curated public API: [docs/api.md](./docs/api.md).
diff --git a/packages/trueforge-ui-sdk/docs/api.md b/packages/trueforge-ui-sdk/docs/api.md
index 88cc248d9..e0c94f59b 100644
--- a/packages/trueforge-ui-sdk/docs/api.md
+++ b/packages/trueforge-ui-sdk/docs/api.md
@@ -6,10 +6,40 @@ re-exports override **types** only where needed.
## Quick start
-| Export | Notes |
-| -------------------------------- | --------------------------------- |
-| `TrueforgeUI` | Slots + runtime + built-in layout |
-| `TrueforgeUIProps`, `ChatLayout` | Props / layout union |
+| Export | Notes |
+| -------------------------------- | ------------------------------------------------------------------------------------ |
+| `TrueforgeUI` | Slots + runtime + built-in layout |
+| `TrueforgeUIProps`, `ChatLayout` | Props / layout union |
+| `TrueforgeServerConfig` | `server` prop: `type: "truefoundry"` \| `type: "trueforge"` \| ready `AgentUIServer` |
+
+### Built-in servers
+
+| `server` config | What the SDK does |
+| -------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
+| `{ type: 'truefoundry', apiKey, controlPlaneURL, gatewayPlaneURL? }` | Calls runtime `createTrueFoundryAgentUIServer` |
+| `{ type: 'trueforge', baseUrl?, token?, fetch?, catalog? }` | Dynamic-imports `plugins/trueforge-agent-server-adapter` → full Harness `AgentUIServer` |
+| Ready `AgentUIServer` | Passthrough (host-composed or `createTrueFoundryServer`) |
+
+TrueForge hosts need `@truefoundry/trueforge-sdk`. Cookie apps pass `fetch`; embeds usually pass `token`.
+
+```tsx
+// Harness / TrueForge
+<TrueforgeUI
+ server={{ type: 'trueforge', baseUrl: '/', token: process.env.TRUEFORGE_TOKEN }}
+ layout="sidebar"
+/>
+
+// Or same-origin cookies:
+<TrueforgeUI server={{ type: 'trueforge', fetch: authAwareFetch }} layout="sidebar" />
+```
+
+Factory without `<TrueforgeUI />`:
+
+```ts
+import { createTrueForgeAgentUIServer } from '@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter';
+
+const server = createTrueForgeAgentUIServer({ baseUrl: '/', token });
+```
## Compose
diff --git a/packages/trueforge-ui-sdk/package.json b/packages/trueforge-ui-sdk/package.json
index 135995857..fbe703474 100644
--- a/packages/trueforge-ui-sdk/package.json
+++ b/packages/trueforge-ui-sdk/package.json
@@ -33,6 +33,10 @@
"types": "./dist/assistant-ui.d.ts",
"default": "./dist/assistant-ui.js"
},
+ "./plugins/trueforge-agent-server-adapter": {
+ "types": "./dist/plugins/trueforge-agent-server-adapter/index.d.ts",
+ "default": "./dist/plugins/trueforge-agent-server-adapter/index.js"
+ },
"./styles.css": "./dist/styles.css"
},
"main": "./dist/index.js",
@@ -49,14 +53,18 @@
"src/icons/registerAgentIcons.ts"
],
"scripts": {
+ "sdk:build": "pnpm --filter @truefoundry/trueforge-sdk build",
+ "prebuild": "pnpm run sdk:build",
"build": "rm -rf dist && tailwindcss --input src/build-styles.css --output dist/styles.css --minify && tsup",
"dev:watch": "pnpm run \"/^(dev:watch:js|dev:watch:css)$/\"",
"dev:watch:js": "tsup --watch",
"dev:watch:css": "tailwindcss --input src/build-styles.css --output dist/styles.css --watch",
"pack:tgz": "pnpm build && pnpm pack",
+ "pretest": "pnpm run sdk:build",
"test": "vitest run && pnpm test:package",
"test:package": "pnpm build && node test/packageExports.smoke.mjs",
"test:coverage": "vitest run --coverage",
+ "pretypecheck": "pnpm run sdk:build",
"typecheck": "tsc --noEmit && tsc --noEmit -p test/tsconfig.json",
"lint": "eslint src test --ext .ts,.tsx",
"format": "prettier --write \"src/**/*.{ts,tsx,css,md}\" \"test/**/*.{ts,tsx}\" \"*.md\" \"docs/**/*.md\" --config ../../.prettierrc"
diff --git a/packages/trueforge-ui-sdk/src/atoms/NamedAgentHeaderLabel.tsx b/packages/trueforge-ui-sdk/src/atoms/NamedAgentHeaderLabel.tsx
index 4b297fd47..99cf9c14f 100644
--- a/packages/trueforge-ui-sdk/src/atoms/NamedAgentHeaderLabel.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/NamedAgentHeaderLabel.tsx
@@ -3,6 +3,7 @@
import { useNamedAgentHeaderState } from '../hooks/useChatChromeActionsVisible.js';
import { Icon } from '../icons/Icon.js';
import { cn } from './lib/cn.js';
+import { Tooltip } from './primitives/Tooltip.js';
/** Left-of-header title for a named agent, including its mutable edit state. */
export function NamedAgentHeaderLabel({ className }: { className?: string }) {
@@ -10,17 +11,18 @@ export function NamedAgentHeaderLabel({ className }: { className?: string }) {
if (state === null) return null;
return (
- <h1
- className={cn('flex min-w-0 items-center gap-1.5 px-1 text-sm font-medium text-text-primary', className)}
- title={state.name}
- >
+ <h1 className={cn('flex min-w-0 items-center gap-1.5 px-1 text-sm font-medium text-text-primary', className)}>
<Icon name="robot" className="size-3.5 shrink-0" />
- <span className="truncate">{state.name}</span>
+ <span className="truncate" title={state.name}>
+ {state.name}
+ </span>
{state.isEditing ? (
- <span className="bg-secondary-bg text-text-secondary inline-flex shrink-0 items-center gap-1 rounded-full px-2 py-0.5 text-xs font-medium">
- <Icon name="pencil" className="size-3" />
- Editing
- </span>
+ <Tooltip content="Try changes here, then choose Update agent to save.">
+ <span className="bg-warning-bg text-warning-text inline-flex shrink-0 items-center gap-1 rounded-full px-2 py-0.5 text-xs font-medium">
+ <Icon name="pencil" className="size-3" />
+ Editing
+ </span>
+ </Tooltip>
) : null}
</h1>
);
diff --git a/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.tsx b/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.tsx
index bd4ba7c07..ae5fc5e29 100644
--- a/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.tsx
@@ -224,7 +224,7 @@ function SaveAgentButtonContent({
value={name}
disabled={saving || intent === 'update'}
onChange={event => setName(event.target.value)}
- placeholder="my-agent"
+ placeholder="release-notes"
className={auiInputClass('h-9 disabled:opacity-60')}
/>
</label>
@@ -236,32 +236,36 @@ function SaveAgentButtonContent({
disabled={saving}
onChange={event => setDraftSpec({ ...draftSpec, instructions: event.target.value })}
rows={4}
+ placeholder="You are a release notes writer for a platform team."
className={auiInputClass('resize-y py-2 disabled:opacity-60')}
/>
</label>
- <div className="mb-4 overflow-hidden rounded-xl border border-border">
- <SummarySection
- icon="cpu"
- title="Model"
- value={draftSpec.model.name ? displayModelLabel(draftSpec.model.name) : 'Not selected'}
- disabled={saving}
- onEdit={() => setEditor('model')}
- />
- <SummarySection
- icon="plug"
- title="MCP servers"
- value={`${mcpMounts.length} selected`}
- disabled={saving}
- onEdit={() => setEditor('mcp')}
- />
- <SummarySection
- icon="lightbulb"
- title="Skills"
- value={`${skillMounts.length} selected`}
- disabled={saving}
- onEdit={() => setEditor('skills')}
- />
+ <div className="mb-4">
+ <h3 className="mb-2 text-sm font-medium">Configuration</h3>
+ <div className="overflow-hidden rounded-xl border border-border">
+ <SummarySection
+ icon="cpu"
+ title="Model"
+ value={draftSpec.model.name ? displayModelLabel(draftSpec.model.name) : 'Not selected'}
+ disabled={saving}
+ onEdit={() => setEditor('model')}
+ />
+ <SummarySection
+ icon="plug"
+ title="Connectors"
+ value={`${mcpMounts.length} selected`}
+ disabled={saving}
+ onEdit={() => setEditor('mcp')}
+ />
+ <SummarySection
+ icon="lightbulb"
+ title="Skills"
+ value={`${skillMounts.length} selected`}
+ disabled={saving}
+ onEdit={() => setEditor('skills')}
+ />
+ </div>
</div>
<div>
@@ -317,10 +321,10 @@ function SaveAgentButtonContent({
setModelQuery('');
}
}}
- title={editor === 'model' ? 'Select model' : editor === 'mcp' ? 'MCP servers' : 'Skills'}
+ title={editor === 'model' ? 'Select model' : editor === 'mcp' ? 'Connectors' : 'Skills'}
className="md:max-w-md"
contentSized
- aria-label={editor === 'model' ? 'Edit model' : editor === 'mcp' ? 'Edit MCP servers' : 'Edit skills'}
+ aria-label={editor === 'model' ? 'Edit model' : editor === 'mcp' ? 'Edit Connectors' : 'Edit skills'}
>
{draftSpec && editor ? (
<div className="flex h-[min(28rem,calc(100dvh-10rem))] w-[min(28rem,calc(100vw-2rem))] flex-col">
@@ -338,6 +342,7 @@ function SaveAgentButtonContent({
query={modelQuery}
onQueryChange={setModelQuery}
listboxId={modelListId}
+ showHeading={false}
onSelect={nextModel => {
setDraftSpec({
...draftSpec,
@@ -347,7 +352,6 @@ function SaveAgentButtonContent({
nextModel.properties.reasoningEfforts,
),
});
- setEditor(null);
}}
/>
</>
@@ -367,7 +371,7 @@ function SaveAgentButtonContent({
<input
value={search}
onChange={event => setSearch(event.target.value)}
- placeholder={editor === 'mcp' ? 'Search MCP servers' : 'Search skills'}
+ placeholder={editor === 'mcp' ? 'Search connectors' : 'Search skills'}
className={auiInputClass('h-8 pr-2 pl-7')}
autoFocus
/>
@@ -443,6 +447,19 @@ function SaveAgentButtonContent({
</div>
</>
)}
+ <div className="bg-card-bg sticky bottom-0 z-10 flex shrink-0 justify-end border-t border-border px-5 py-4">
+ <button
+ type="button"
+ className={auiButtonClass({ variant: 'default' })}
+ onClick={() => {
+ setEditor(null);
+ setSearch('');
+ setModelQuery('');
+ }}
+ >
+ Continue
+ </button>
+ </div>
</div>
) : null}
</CenteredModal>
diff --git a/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelCatalogPanel.tsx b/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelCatalogPanel.tsx
index 2fea8e9ca..4520e2f88 100644
--- a/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelCatalogPanel.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelCatalogPanel.tsx
@@ -63,6 +63,7 @@ export function DraftModelCatalogPanel({
onSelect,
onOpenSettings,
listboxId,
+ showHeading = true,
}: {
models: ModelSelection[];
loading: boolean;
@@ -72,6 +73,7 @@ export function DraftModelCatalogPanel({
onSelect: (model: ModelSelection) => void;
onOpenSettings?: () => void;
listboxId: string;
+ showHeading?: boolean;
}) {
const needle = query.trim().toLowerCase();
const filtered = needle
@@ -87,7 +89,7 @@ export function DraftModelCatalogPanel({
return (
<>
<div className="border-b border-border px-3 py-2">
- <p className="text-text-primary mb-2 text-sm font-semibold">Select model</p>
+ {showHeading ? <p className="text-text-primary mb-2 text-sm font-semibold">Select model</p> : null}
<label className="relative block">
<Icon
name="search"
diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/AddMcpServerForm.tsx b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/AddMcpServerForm.tsx
index 4c5465daf..182ae5ec6 100644
--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/AddMcpServerForm.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/AddMcpServerForm.tsx
@@ -152,7 +152,7 @@ const AddMcpServerForm = ({ open, onOpenChange, onAdd, busy = false, error }: Ad
key={option.value}
className={`flex h-8 flex-1 cursor-pointer items-center justify-center rounded-sm text-sm font-medium transition-colors ${
authType === option.value
- ? 'bg-primary-bg text-text-primary shadow-sm'
+ ? 'bg-dropdown-selected-item-bg text-dropdown-selected-item-text shadow-sm'
: 'text-text-secondary hover:text-text-primary'
}`}
>
diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/index.tsx b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/index.tsx
index 6c8042e3c..e418e3d04 100644
--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/index.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/index.tsx
@@ -119,7 +119,7 @@ const TruefoundrySettingsBuilder = () => {
// Narrow panels cannot fit fixed-width tabs, so tabs split the row instead.
compact ? 'min-w-0 flex-1 justify-center gap-1.5 px-1.5' : 'shrink-0',
section === item.id
- ? 'bg-dropdown-selected-item-bg text-dropdown-selected-item-text'
+ ? 'bg-primary-button-bg text-primary-button-text'
: 'text-text-secondary hover:bg-ghost-button-hover/60 hover:text-text-primary',
)}
onClick={() => {
diff --git a/packages/trueforge-ui-sdk/src/containers/useResolvedServer.ts b/packages/trueforge-ui-sdk/src/containers/useResolvedServer.ts
index 0f0dc3a56..d830bebd2 100644
--- a/packages/trueforge-ui-sdk/src/containers/useResolvedServer.ts
+++ b/packages/trueforge-ui-sdk/src/containers/useResolvedServer.ts
@@ -74,7 +74,7 @@ function isAgentUIServer(value: object): value is AgentUIServer {
* Resolves a {@link TrueforgeServerConfig} to an {@link AgentUIServer}.
* - `AgentUIServer` — sync passthrough
* - `truefoundry` — async via `createTrueFoundryAgentUIServer`
- * - `trueforge` — not implemented yet (error state)
+ * - `trueforge` — via dynamic import of the Harness plugin adapter
*/
export function useResolvedServer(
config: TrueforgeServerConfig,
@@ -83,22 +83,18 @@ export function useResolvedServer(
const builtIn = isBuiltInConfig(config) ? config : null;
const directServer: AgentUIServer | null = isBuiltInConfig(config) ? null : config;
const type = builtIn?.type;
- const apiKey = builtIn?.apiKey ?? '';
+ const apiKey = builtIn?.type === 'truefoundry' ? builtIn.apiKey : '';
const controlPlaneURL = builtIn?.type === 'truefoundry' ? builtIn.controlPlaneURL : '';
const gatewayPlaneURL = builtIn?.type === 'truefoundry' ? (builtIn.gatewayPlaneURL ?? '') : '';
+ const trueforgeBaseUrl = builtIn?.type === 'trueforge' ? (builtIn.baseUrl ?? '') : '';
+ const trueforgeToken = builtIn?.type === 'trueforge' ? (builtIn.token ?? '') : '';
+ const trueforgeFetch = builtIn?.type === 'trueforge' ? builtIn.fetch : undefined;
const catalog = builtIn?.catalog;
const [state, setState] = useState<ResolvedServerState>(() => {
if (directServer) {
return { status: 'ready', server: directServer, error: null };
}
- if (type === 'trueforge') {
- return {
- status: 'error',
- server: null,
- error: new Error('TrueforgeUI: type "trueforge" is not implemented yet'),
- };
- }
return { status: 'loading', server: null, error: null };
});
@@ -108,27 +104,37 @@ export function useResolvedServer(
return;
}
- if (type === 'trueforge') {
- const error = new Error('TrueforgeUI: type "trueforge" is not implemented yet');
- onError?.(error);
- setState({ status: 'error', server: null, error });
- return;
- }
-
let cancelled = false;
setState({ status: 'loading', server: null, error: null });
- void createTrueFoundryAgentUIServer({
- apiKey,
- cpURL: controlPlaneURL,
- ...(gatewayPlaneURL ? { gatewayURL: gatewayPlaneURL } : {}),
- })
- .then(runtimeServer => {
+ const resolve = async (): Promise<AgentUIServer> => {
+ if (type === 'trueforge') {
+ const { createTrueForgeAgentUIServer } = await import('../plugins/trueforge-agent-server-adapter/index.js');
+ return createTrueForgeAgentUIServer({
+ ...(trueforgeBaseUrl ? { baseUrl: trueforgeBaseUrl } : {}),
+ ...(trueforgeToken ? { token: trueforgeToken } : {}),
+ ...(trueforgeFetch !== undefined ? { fetch: trueforgeFetch } : {}),
+ ...(catalog != null ? { catalog } : {}),
+ });
+ }
+
+ const runtimeServer = await createTrueFoundryAgentUIServer({
+ apiKey,
+ cpURL: controlPlaneURL,
+ ...(gatewayPlaneURL ? { gatewayURL: gatewayPlaneURL } : {}),
+ });
+ // TrueFoundry adapter may omit catalog; attach host-supplied catalog here.
+ return toAgentUIServer(runtimeServer, catalog);
+ };
+
+ void resolve()
+ .then(server => {
if (cancelled) return;
try {
+ // trueforge factory already includes catalog; still normalize capabilities.
setState({
status: 'ready',
- server: toAgentUIServer(runtimeServer, catalog),
+ server: type === 'trueforge' ? toAgentUIServer(server, undefined) : server,
error: null,
});
} catch (error: unknown) {
@@ -145,7 +151,18 @@ export function useResolvedServer(
return () => {
cancelled = true;
};
- }, [type, directServer, apiKey, controlPlaneURL, gatewayPlaneURL, catalog, onError]);
+ }, [
+ type,
+ directServer,
+ apiKey,
+ controlPlaneURL,
+ gatewayPlaneURL,
+ trueforgeBaseUrl,
+ trueforgeToken,
+ trueforgeFetch,
+ catalog,
+ onError,
+ ]);
return state;
}
diff --git a/packages/frontend/src/harnessBuilderServer.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/builderServer.ts
similarity index 78%
rename from packages/frontend/src/harnessBuilderServer.ts
rename to packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/builderServer.ts
index 644c52ee9..4ac20dd4f 100644
--- a/packages/frontend/src/harnessBuilderServer.ts
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/builderServer.ts
@@ -2,17 +2,17 @@
* AgentBuilderServer callbacks for createTrueFoundryServer.
* Composer pickers + agent library backed by the Harness agents registry.
*/
-import type { TrueForgeApi } from '@truefoundry/trueforge-sdk';
-import type {
- AgentBuilderServer,
- AgentLibraryEntry,
- ModelSelection,
- SearchAgentsParams,
-} from '@truefoundry/trueforge-ui';
-import { listConfiguredMcpServers, listSkills } from './composerLists';
-import { toUiConnectorFromReadEntry } from './connectorCatalog';
-import { createHarnessClient, harnessClient, type CreateHarnessClientOptions } from './harnessClient';
-import { agentManifest, toHarnessAgentSpec, toUiAgentSpec, type HarnessAgentSpec } from './harnessServer';
+import type { TrueForge, TrueForgeApi } from '@truefoundry/trueforge-sdk';
+import type { AgentBuilderServer, AgentLibraryEntry, ModelSelection, SearchAgentsParams } from '../../server/types.js';
+import { toUiConnectorFromReadEntry } from './catalogs/connectorCatalog.js';
+import { agentManifest, toHarnessAgentSpec, toUiAgentSpec } from './chatServer.js';
+import { createTrueForgeClient, type CreateTrueForgeClientOptions } from './client.js';
+import { listConfiguredMcpServers, listSkills } from './lists.js';
+import type { HarnessAgentSpec } from './types.js';
+
+export type CreateHarnessBuilderServerOptions = CreateTrueForgeClientOptions & {
+ client?: TrueForge;
+};
/** Well-known catalog entries key logos by `type` (same as configured provider resource name). */
export function modelProviderLogosByName(
@@ -53,10 +53,9 @@ function toLibraryEntry(agent: TrueForgeApi.Agent): AgentLibraryEntry {
}
export function createHarnessBuilderServer(
- options: CreateHarnessClientOptions = {},
+ options: CreateHarnessBuilderServerOptions = {},
): AgentBuilderServer<HarnessAgentSpec> {
- const client =
- options.baseUrl === undefined && options.fetch === undefined ? harnessClient : createHarnessClient(options);
+ const client = options.client ?? createTrueForgeClient(options);
return {
getCapabilities: () => client.server.getCapabilities(),
@@ -77,10 +76,10 @@ export function createHarnessBuilderServer(
},
// Skills require a configured sandbox provider; keep the picker empty when skill capability is off.
getSkills: async () => {
- const skills = await listSkills();
+ const skills = await listSkills(client);
return skills.map(skill => ({ id: skill.name, name: skill.name, description: skill.description }));
},
- getMcp: async () => (await listConfiguredMcpServers()).map(toUiConnectorFromReadEntry),
+ getMcp: async () => (await listConfiguredMcpServers(client)).map(toUiConnectorFromReadEntry),
async searchAgents(req?: SearchAgentsParams) {
const { data } = await client.agents.list();
diff --git a/packages/frontend/src/connectorCatalog.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts
similarity index 77%
rename from packages/frontend/src/connectorCatalog.ts
rename to packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts
index 6294729a8..0afa0e690 100644
--- a/packages/frontend/src/connectorCatalog.ts
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts
@@ -5,7 +5,7 @@
* UI: `dcr` / `header` / `none`, connector `id`.
* Harness: `dcr` / `header` / omitted auth, resource `name`.
*/
-import type { TrueForgeApi } from '@truefoundry/trueforge-sdk';
+import type { TrueForge, TrueForgeApi } from '@truefoundry/trueforge-sdk';
import type {
ConnectorAuth,
ConnectorAuthPublic,
@@ -15,8 +15,7 @@ import type {
CreateConnectorRequest,
ToolBase,
UpdateConnectorRequest,
-} from '@truefoundry/trueforge-ui';
-import { harnessClient as client } from './harnessClient';
+} from '../../../server/types.js';
export type UiConnectorAuth = ConnectorAuth;
export type UiConnectorAuthPublic = ConnectorAuthPublic;
@@ -112,45 +111,10 @@ export function toHarnessManifest(req: { name: string; url: string; auth: Connec
};
}
-async function getConfigured(name: string): Promise<TrueForgeApi.ConfiguredMcpServer> {
- const listed = await client.settings.mcpServers.list();
- const existing = listed.data.find(server => server.name === name);
- if (existing === undefined) {
- throw new Error(`MCP server "${name}" not found`);
- }
- return existing;
-}
-
-async function resolveWriteAuth(req: { id?: string; auth: ConnectorAuth }): Promise<ConnectorAuth> {
- if (req.auth.type !== 'header') {
- return req.auth;
- }
- const apiKey = req.auth.apiKey?.trim();
- if (apiKey !== undefined && apiKey !== '') {
- return req.auth;
- }
- if (req.id === undefined) {
- throw new Error('API key is required for header-authenticated MCP servers');
- }
- const existing = await getConfigured(req.id);
- if (existing.auth?.type !== 'header') {
- throw new Error(`MCP server "${req.id}" has no stored header credentials to reuse`);
- }
- const preferredHeader = req.auth.headerName?.trim();
- const storedHeaderName = Object.keys(existing.auth.headers)[0];
- const headerName =
- preferredHeader !== undefined && preferredHeader !== ''
- ? preferredHeader
- : (storedHeaderName ?? DEFAULT_API_KEY_HEADER);
- const stored = existing.auth.headers[headerName] ?? Object.values(existing.auth.headers)[0];
- if (stored === undefined) {
- throw new Error(`MCP server "${req.id}" has no stored header credentials to reuse`);
- }
- return { type: 'header', apiKey: stored, headerName };
-}
-
/** Settings connector port for `createTrueFoundryServer`. Delete omitted; disconnect unsupported. */
-export function createConnectorCatalog(): ConnectorCatalogServer<
+export function createConnectorCatalog(
+ client: TrueForge,
+): ConnectorCatalogServer<
ToolBase,
UiConnectorAuth,
UiConnectorAuthPublic,
@@ -159,6 +123,43 @@ export function createConnectorCatalog(): ConnectorCatalogServer<
CreateConnectorRequest,
UpdateConnectorRequest
> {
+ async function getConfigured(name: string): Promise<TrueForgeApi.ConfiguredMcpServer> {
+ const listed = await client.settings.mcpServers.list();
+ const existing = listed.data.find(server => server.name === name);
+ if (existing === undefined) {
+ throw new Error(`MCP server "${name}" not found`);
+ }
+ return existing;
+ }
+
+ async function resolveWriteAuth(req: { id?: string; auth: ConnectorAuth }): Promise<ConnectorAuth> {
+ if (req.auth.type !== 'header') {
+ return req.auth;
+ }
+ const apiKey = req.auth.apiKey?.trim();
+ if (apiKey !== undefined && apiKey !== '') {
+ return req.auth;
+ }
+ if (req.id === undefined) {
+ throw new Error('API key is required for header-authenticated MCP servers');
+ }
+ const existing = await getConfigured(req.id);
+ if (existing.auth?.type !== 'header') {
+ throw new Error(`MCP server "${req.id}" has no stored header credentials to reuse`);
+ }
+ const preferredHeader = req.auth.headerName?.trim();
+ const storedHeaderName = Object.keys(existing.auth.headers)[0];
+ const headerName =
+ preferredHeader !== undefined && preferredHeader !== ''
+ ? preferredHeader
+ : (storedHeaderName ?? DEFAULT_API_KEY_HEADER);
+ const stored = existing.auth.headers[headerName] ?? Object.values(existing.auth.headers)[0];
+ if (stored === undefined) {
+ throw new Error(`MCP server "${req.id}" has no stored header credentials to reuse`);
+ }
+ return { type: 'header', apiKey: stored, headerName };
+ }
+
return {
getConnectorCatalog: async () => {
const body = await client.catalog.mcpServers.list();
diff --git a/packages/frontend/src/modelProviderCatalog.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.ts
similarity index 76%
rename from packages/frontend/src/modelProviderCatalog.ts
rename to packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.ts
index 490e83d8c..b47584cb2 100644
--- a/packages/frontend/src/modelProviderCatalog.ts
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.ts
@@ -5,6 +5,7 @@
* UI: flat `apiKey` / model `id`. Harness: `auth.apiKey` / `modelId`.
* Provider `id` in the UI is the Harness resource `name`.
*/
+import type { TrueForge } from '@truefoundry/trueforge-sdk';
import { TrueForgeApi } from '@truefoundry/trueforge-sdk';
import type {
CreateModelProviderRequest,
@@ -13,8 +14,8 @@ import type {
ModelProviderBase,
ModelProviderCatalogEntry,
UpdateModelProviderRequest,
-} from '@truefoundry/trueforge-ui';
-import { harnessClient as client } from './harnessClient';
+} from '../../../server/types.js';
+
/** Custom-form rows omit properties; catalog rows round-trip them. */
export type UiModelEntry = ModelEntry & {
properties?: TrueForgeApi.ModelProperties;
@@ -109,54 +110,56 @@ export function toHarnessModelProvider(req: {
return { type: req.type, auth, models };
}
-async function resolveApiKey(req: { id?: string; type?: string; apiKey: string }): Promise<string> {
- const trimmed = req.apiKey.trim();
- if (trimmed !== '') {
- return trimmed;
- }
- if (req.id === undefined) {
- // Create with a blank key: allow only for custom; "" is mapped to omitted auth below.
- if (req.type === 'custom') {
- return '';
- }
- throw new Error('API key is required');
- }
- // Update with empty means keep the stored key.
- const listed = await client.settings.modelProviders.list();
- const existing = listed.data.find(provider => toUiModelProvider(provider).id === req.id);
- if (existing === undefined) {
- throw new Error(`Model provider "${req.id}" not found`);
- }
- return existing.auth?.apiKey ?? '';
-}
-
-async function upsertFromUi(req: {
- type: string;
- name: string;
- apiKey: string;
- baseUrl?: string;
- models: UiModelEntry[];
-}): Promise<UiModelProvider> {
- const body = await client.settings.modelProviders.upsert(
- toHarnessModelProvider({
- type: req.type,
- name: req.name,
- apiKey: req.apiKey,
- ...(req.baseUrl === undefined ? {} : { baseUrl: req.baseUrl }),
- models: req.models,
- }),
- );
- return toUiModelProvider(body.data);
-}
-
/** Settings model-catalog port for `createTrueFoundryServer`. Delete is omitted (no BE route). */
-export function createModelProviderCatalog(): ModelCatalogServer<
+export function createModelProviderCatalog(
+ client: TrueForge,
+): ModelCatalogServer<
UiModelEntry,
UiModelProvider,
UiModelProviderCatalogEntry,
CreateModelProviderRequest<UiModelEntry>,
UpdateModelProviderRequest<UiModelEntry>
> {
+ async function resolveApiKey(req: { id?: string; type?: string; apiKey: string }): Promise<string> {
+ const trimmed = req.apiKey.trim();
+ if (trimmed !== '') {
+ return trimmed;
+ }
+ if (req.id === undefined) {
+ // Create with a blank key: allow only for custom; "" is mapped to omitted auth below.
+ if (req.type === 'custom') {
+ return '';
+ }
+ throw new Error('API key is required');
+ }
+ // Update with empty means keep the stored key.
+ const listed = await client.settings.modelProviders.list();
+ const existing = listed.data.find(provider => toUiModelProvider(provider).id === req.id);
+ if (existing === undefined) {
+ throw new Error(`Model provider "${req.id}" not found`);
+ }
+ return existing.auth?.apiKey ?? '';
+ }
+
+ async function upsertFromUi(req: {
+ type: string;
+ name: string;
+ apiKey: string;
+ baseUrl?: string;
+ models: UiModelEntry[];
+ }): Promise<UiModelProvider> {
+ const body = await client.settings.modelProviders.upsert(
+ toHarnessModelProvider({
+ type: req.type,
+ name: req.name,
+ apiKey: req.apiKey,
+ ...(req.baseUrl === undefined ? {} : { baseUrl: req.baseUrl }),
+ models: req.models,
+ }),
+ );
+ return toUiModelProvider(body.data);
+ }
+
return {
getModelProviderCatalog: async () => {
const body = await client.catalog.modelProviders.list();
diff --git a/packages/frontend/src/sandboxProviderCatalog.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.ts
similarity index 90%
rename from packages/frontend/src/sandboxProviderCatalog.ts
rename to packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.ts
index bbbf4206b..3b66ff901 100644
--- a/packages/frontend/src/sandboxProviderCatalog.ts
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.ts
@@ -6,14 +6,14 @@
* Harness: one Daytona provider per tenant; catalog YAML has no name — synthetic
* identity uses `type` (`daytona`) as id/catalogId and display name `Daytona`.
*/
+import type { TrueForge } from '@truefoundry/trueforge-sdk';
import { TrueForgeApi } from '@truefoundry/trueforge-sdk';
import type {
SandboxCatalogServer,
SandboxProviderBase,
SandboxProviderCatalogEntry,
SandboxProviderConfig,
-} from '@truefoundry/trueforge-ui';
-import { harnessClient as client } from './harnessClient';
+} from '../../../server/types.js';
export type UiSandboxProvider = SandboxProviderBase;
export type UiSandboxProviderCatalogEntry = SandboxProviderCatalogEntry;
@@ -79,17 +79,17 @@ export function toHarnessManifest(
};
}
-async function resolveApiKey(apiKey: string | undefined): Promise<string> {
- const trimmed = apiKey?.trim();
- if (trimmed !== undefined && trimmed !== '') {
- return trimmed;
+/** Settings sandbox-catalog port for `createTrueFoundryServer`. Delete omitted (no BE route). */
+export function createSandboxProviderCatalog(client: TrueForge): SandboxCatalogServer {
+ async function resolveApiKey(apiKey: string | undefined): Promise<string> {
+ const trimmed = apiKey?.trim();
+ if (trimmed !== undefined && trimmed !== '') {
+ return trimmed;
+ }
+ const existing = await client.settings.sandboxProviders.get();
+ return existing.data.auth.apiKey;
}
- const existing = await client.settings.sandboxProviders.get();
- return existing.data.auth.apiKey;
-}
-/** Settings sandbox-catalog port for `createTrueFoundryServer`. Delete omitted (no BE route). */
-export function createSandboxProviderCatalog(): SandboxCatalogServer {
return {
getSandboxProviderCatalog: async () => {
const body = await client.catalog.sandboxProviders.list();
diff --git a/packages/frontend/src/skillCatalog.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.ts
similarity index 91%
rename from packages/frontend/src/skillCatalog.ts
rename to packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.ts
index 1531eff8e..1ad36bfd5 100644
--- a/packages/frontend/src/skillCatalog.ts
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.ts
@@ -7,9 +7,8 @@
* For now UI `id = name`; registry link uses `catalogId = name` when the
* configured skill name matches a catalog preset.
*/
-import type { TrueForgeApi } from '@truefoundry/trueforge-sdk';
-import type { DefinedSkill, SkillCatalogEntry, SkillCatalogServer, SkillConfigBase } from '@truefoundry/trueforge-ui';
-import { harnessClient as client } from './harnessClient';
+import type { TrueForge, TrueForgeApi } from '@truefoundry/trueforge-sdk';
+import type { DefinedSkill, SkillCatalogEntry, SkillCatalogServer, SkillConfigBase } from '../../../server/types.js';
export type UiSkill = DefinedSkill;
export type UiSkillCatalogEntry = SkillCatalogEntry;
@@ -50,7 +49,7 @@ export function toUiSkill(skill: TrueForgeApi.SkillManifest, catalogNames: Reado
}
/** Settings skill-catalog port for `createTrueFoundryServer`. Delete omitted (no BE route). */
-export function createSkillCatalog(): SkillCatalogServer<UiSkill> {
+export function createSkillCatalog(client: TrueForge): SkillCatalogServer<UiSkill> {
return {
getSkillCatalog: async () => {
const body = await client.catalog.skills.list();
diff --git a/packages/frontend/src/harnessServer.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/chatServer.ts
similarity index 90%
rename from packages/frontend/src/harnessServer.ts
rename to packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/chatServer.ts
index 80d44b0a6..14d74db99 100644
--- a/packages/frontend/src/harnessServer.ts
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/chatServer.ts
@@ -1,5 +1,5 @@
/**
- * Harness `AgentUIServer` adapter for @truefoundry/trueforge-ui.
+ * Harness `AgentChatServer` adapter for @truefoundry/trueforge-ui.
*
* Runtime contract: opaque mounts (`object`), flat `ListResult` (`data` +
* `nextPageToken`), and `null` normalized to absent. Harness keys MCP mounts by
@@ -11,34 +11,24 @@
* `reference`/`inline` discriminator, with reference rows already naming their
* agent. The UI filters with registry `agentId`.
*/
-import type { TrueForgeApi } from '@truefoundry/trueforge-sdk';
+import type { TrueForge, TrueForgeApi } from '@truefoundry/trueforge-sdk';
import type {
AgentChatServer,
- AgentSpec,
ListResult,
Session,
SessionEventItem,
Turn,
TurnInputItem,
UserMessageContent,
-} from '@truefoundry/trueforge-ui';
-import { createHarnessClient, harnessClient, type CreateHarnessClientOptions } from './harnessClient';
+} from '../../server/types.js';
+import { createTrueForgeClient, type CreateTrueForgeClientOptions } from './client.js';
+import type { HarnessAgentSpec, HarnessMcpServerMount, HarnessSkillMount } from './types.js';
-export type HarnessSkillMount = TrueForgeApi.SkillNameRef;
-export type HarnessMcpServerMount = TrueForgeApi.McpServer;
-
-export interface HarnessAgentSpec extends AgentSpec<
- TrueForgeApi.AgentSpecModel,
- HarnessSkillMount,
- HarnessMcpServerMount
-> {
- config?: TrueForgeApi.RuntimeConfig;
- instructions?: string;
- messages?: TrueForgeApi.AgentSpecUserMessage[];
- responseFormat?: TrueForgeApi.ResponseFormat;
-}
-
-export type CreateHarnessServerOptions = CreateHarnessClientOptions;
+export type { HarnessAgentSpec, HarnessMcpServerMount, HarnessSkillMount } from './types.js';
+export type CreateHarnessChatServerOptions = CreateTrueForgeClientOptions & {
+ /** Injected client — skips creating one from options. */
+ client?: TrueForge;
+};
function toUiMcpServer(server: TrueForgeApi.McpServer): HarnessMcpServerMount {
return server;
@@ -164,9 +154,10 @@ function toHarnessInput(input: TurnInputItem[]): TrueForgeApi.TurnInputItem[] {
);
}
-export function createHarnessChatServer(options: CreateHarnessServerOptions = {}): AgentChatServer<HarnessAgentSpec> {
- const client =
- options.baseUrl === undefined && options.fetch === undefined ? harnessClient : createHarnessClient(options);
+export function createHarnessChatServer(
+ options: CreateHarnessChatServerOptions = {},
+): AgentChatServer<HarnessAgentSpec> {
+ const client = options.client ?? createTrueForgeClient(options);
return {
// The sandbox is resolved server-side from the turn, so `sandboxId` is accepted for parity
// with hosts that address sandboxes directly and deliberately not forwarded.
diff --git a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/client.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/client.ts
new file mode 100644
index 000000000..e1b6dce46
--- /dev/null
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/client.ts
@@ -0,0 +1,22 @@
+/**
+ * TrueForge HTTP client for the Harness adapter.
+ * Auth is host-owned: pass `token` (Bearer) and/or a custom `fetch` (e.g. cookie + OIDC).
+ */
+import { TrueForge } from '@truefoundry/trueforge-sdk';
+
+export interface CreateTrueForgeClientOptions {
+ baseUrl?: string;
+ /** SDK Bearer token (`Authorization: Bearer …`). */
+ token?: string;
+ fetch?: typeof fetch;
+}
+
+const DEFAULT_BASE_URL = '/';
+
+export function createTrueForgeClient(options: CreateTrueForgeClientOptions = {}): TrueForge {
+ return new TrueForge({
+ baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
+ ...(options.token === undefined ? {} : { token: options.token }),
+ ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+ });
+}
diff --git a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/index.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/index.ts
new file mode 100644
index 000000000..33b0d36af
--- /dev/null
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/index.ts
@@ -0,0 +1,78 @@
+/**
+ * Built-in Harness → AgentUIServer factory for `<TrueforgeUI server={{ type: "trueforge", … }} />`.
+ */
+import { createTrueFoundryServer } from '../../server/createTrueFoundryServer.js';
+import type { CatalogServer } from '../../server/types.js';
+import { createHarnessBuilderServer } from './builderServer.js';
+import { createConnectorCatalog } from './catalogs/connectorCatalog.js';
+import { createModelProviderCatalog } from './catalogs/modelProviderCatalog.js';
+import { createSandboxProviderCatalog } from './catalogs/sandboxProviderCatalog.js';
+import { createSkillCatalog } from './catalogs/skillCatalog.js';
+import { createHarnessChatServer } from './chatServer.js';
+import { createTrueForgeClient, type CreateTrueForgeClientOptions } from './client.js';
+import type { HarnessAgentSpec } from './types.js';
+
+export {
+ createHarnessBuilderServer,
+ modelProviderLogosByName,
+ toModelSelection,
+ type CreateHarnessBuilderServerOptions,
+} from './builderServer.js';
+export {
+ createConnectorCatalog,
+ toHarnessAuth,
+ toHarnessManifest as toHarnessConnectorManifest,
+ toUiConnector,
+ toUiConnectorFromReadEntry,
+} from './catalogs/connectorCatalog.js';
+export {
+ createModelProviderCatalog,
+ toHarnessModelProvider,
+ toUiCatalogModelProviderEntry,
+ toUiModelProvider,
+} from './catalogs/modelProviderCatalog.js';
+export {
+ configFromHarness,
+ createSandboxProviderCatalog,
+ toHarnessManifest as toHarnessSandboxManifest,
+ toUiSandboxProvider,
+} from './catalogs/sandboxProviderCatalog.js';
+export { createSkillCatalog, toHarnessManifest as toHarnessSkillManifest, toUiSkill } from './catalogs/skillCatalog.js';
+export {
+ agentManifest,
+ createHarnessChatServer,
+ toHarnessAgentSpec,
+ toUiAgentSpec,
+ type CreateHarnessChatServerOptions,
+} from './chatServer.js';
+export { createTrueForgeClient } from './client.js';
+export type { CreateTrueForgeClientOptions } from './client.js';
+export { getCapabilities, listConfiguredMcpServers, listModels, listSkills } from './lists.js';
+export type { HarnessAgentSpec, HarnessMcpServerMount, HarnessSkillMount } from './types.js';
+
+export type CreateTrueForgeAgentUIServerOptions = CreateTrueForgeClientOptions & {
+ /** Override the default Harness settings catalogs. */
+ catalog?: CatalogServer;
+};
+
+/**
+ * Compose chat + builder + default settings catalogs into an `AgentUIServer`.
+ */
+export function createTrueForgeAgentUIServer(options: CreateTrueForgeAgentUIServerOptions = {}) {
+ const { catalog: catalogOverride, ...clientOptions } = options;
+ const client = createTrueForgeClient(clientOptions);
+ const catalog =
+ catalogOverride ??
+ ({
+ modelCatalog: createModelProviderCatalog(client),
+ connectorCatalog: createConnectorCatalog(client),
+ skillCatalog: createSkillCatalog(client),
+ sandboxCatalog: createSandboxProviderCatalog(client),
+ } satisfies CatalogServer);
+
+ return createTrueFoundryServer<HarnessAgentSpec>({
+ chatServer: createHarnessChatServer({ client }),
+ ...createHarnessBuilderServer({ client }),
+ catalog,
+ });
+}
diff --git a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/lists.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/lists.ts
new file mode 100644
index 000000000..339d71325
--- /dev/null
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/lists.ts
@@ -0,0 +1,25 @@
+/**
+ * Configured-resource list helpers for composer pickers and host boot.
+ * Not the settings catalog ports (`catalogs/*`).
+ */
+import type { TrueForge, TrueForgeApi } from '@truefoundry/trueforge-sdk';
+
+export async function listModels(client: TrueForge): Promise<TrueForgeApi.Model[]> {
+ const body = await client.models.list();
+ return body.data;
+}
+
+export async function listConfiguredMcpServers(client: TrueForge): Promise<TrueForgeApi.McpServerReadEntry[]> {
+ const body = await client.mcpServers.list();
+ return body.data;
+}
+
+export async function listSkills(client: TrueForge): Promise<TrueForgeApi.SkillReadEntry[]> {
+ const body = await client.skills.list();
+ return body.data;
+}
+
+export async function getCapabilities(client: TrueForge): Promise<TrueForgeApi.GetCapabilitiesResponseData> {
+ const body = await client.server.getCapabilities();
+ return body.data;
+}
diff --git a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/types.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/types.ts
new file mode 100644
index 000000000..ec964d97a
--- /dev/null
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/types.ts
@@ -0,0 +1,16 @@
+import type { TrueForgeApi } from '@truefoundry/trueforge-sdk';
+import type { AgentSpec } from '../../server/types.js';
+
+export type HarnessSkillMount = TrueForgeApi.SkillNameRef;
+export type HarnessMcpServerMount = TrueForgeApi.McpServer;
+
+export interface HarnessAgentSpec extends AgentSpec<
+ TrueForgeApi.AgentSpecModel,
+ HarnessSkillMount,
+ HarnessMcpServerMount
+> {
+ config?: TrueForgeApi.RuntimeConfig;
+ instructions?: string;
+ messages?: TrueForgeApi.AgentSpecUserMessage[];
+ responseFormat?: TrueForgeApi.ResponseFormat;
+}
diff --git a/packages/trueforge-ui-sdk/src/server/TrueforgeServerConfig.ts b/packages/trueforge-ui-sdk/src/server/TrueforgeServerConfig.ts
index 111ffe880..32e30eeb5 100644
--- a/packages/trueforge-ui-sdk/src/server/TrueforgeServerConfig.ts
+++ b/packages/trueforge-ui-sdk/src/server/TrueforgeServerConfig.ts
@@ -12,11 +12,16 @@ export type TrueforgeBuiltInServerConfig =
gatewayPlaneURL?: string;
catalog?: CatalogServer;
}
- | ({
+ | {
type: 'trueforge';
- apiKey: string;
+ /** Harness API root. Defaults to `'/'` (same-origin / proxied). */
+ baseUrl?: string;
+ /** Bearer token for `@truefoundry/trueforge-sdk` (`Authorization: Bearer …`). */
+ token?: string;
+ /** Custom fetch (cookie sessions, auth interceptors). */
+ fetch?: typeof fetch;
catalog?: CatalogServer;
- } & Record<string, unknown>);
+ };
/**
* `server` prop for `<TrueforgeUI />`: a built-in config, or a ready
diff --git a/packages/trueforge-ui-sdk/src/theme/presets/index.ts b/packages/trueforge-ui-sdk/src/theme/presets/index.ts
index 86f7d4d58..02ab44ca3 100644
--- a/packages/trueforge-ui-sdk/src/theme/presets/index.ts
+++ b/packages/trueforge-ui-sdk/src/theme/presets/index.ts
@@ -20,12 +20,12 @@ const trueforge: PresetTokens = {
cardBg: '#FFFFFF',
dropdownSelectedItemBg: '#F1F1F2',
dropdownSelectedItemText: '#18181B',
- userMessageBg: '#18181B',
+ userMessageBg: '#6366F1',
userMessageText: '#FFFFFF',
assistantMessageBg: 'transparent',
assistantMessageText: '#18181B',
- primaryButtonBg: '#18181B',
- primaryButtonHover: '#27272A',
+ primaryButtonBg: '#6366F1',
+ primaryButtonHover: '#4F46E5',
primaryButtonText: '#FFFFFF',
secondaryButtonBg: '#FAFAFA',
secondaryButtonHover: '#E4E4E7',
@@ -48,7 +48,7 @@ const trueforge: PresetTokens = {
},
dark: {
sidebarBg: '#18181B',
- topbarBg: '#1F1F22',
+ topbarBg: '#18181B',
primaryBg: '#1F1F22',
secondaryBg: '#27272A',
border: '#343439',
@@ -58,7 +58,7 @@ const trueforge: PresetTokens = {
textPrimary: '#FDFDFD',
textSecondary: '#A1A1AA',
cardBg: '#18181B',
- dropdownSelectedItemBg: '#343439',
+ dropdownSelectedItemBg: '#3F3F46',
dropdownSelectedItemText: '#FDFDFD',
userMessageBg: '#6366F1',
userMessageText: '#FFFFFF',
diff --git a/packages/trueforge-ui-sdk/test/atoms/SaveAgentButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/SaveAgentButton.test.tsx
index 401ccdb74..c69b59165 100644
--- a/packages/trueforge-ui-sdk/test/atoms/SaveAgentButton.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/SaveAgentButton.test.tsx
@@ -207,8 +207,8 @@ describe('SaveAgentButton', () => {
expect(within(dialog).getByLabelText('Instructions')).toHaveValue('Latest flushed instructions.');
expect(within(dialog).getByRole('switch', { name: 'Generative UI' })).toHaveAttribute('aria-checked', 'false');
- fireEvent.click(within(dialog).getByRole('button', { name: 'Edit MCP servers' }));
- const mcpDialog = await findStackedDialog('Edit MCP servers');
+ fireEvent.click(within(dialog).getByRole('button', { name: 'Edit Connectors' }));
+ const mcpDialog = await findStackedDialog('Edit Connectors');
expect(await within(mcpDialog).findByRole('menuitemcheckbox', { name: /Slack/ })).toHaveAttribute(
'aria-checked',
'true',
@@ -313,8 +313,8 @@ describe('SaveAgentButton', () => {
const saveDialog = await screen.findByRole('dialog', { name: 'Save agent' });
fireEvent.change(within(saveDialog).getByLabelText('Agent name'), { target: { value: 'preserved-agent' } });
- fireEvent.click(within(saveDialog).getByRole('button', { name: 'Edit MCP servers' }));
- const mcpDialog = await findStackedDialog('Edit MCP servers');
+ fireEvent.click(within(saveDialog).getByRole('button', { name: 'Edit Connectors' }));
+ const mcpDialog = await findStackedDialog('Edit Connectors');
fireEvent.click(await within(mcpDialog).findByRole('menuitemcheckbox', { name: /Slack/ }));
fireEvent.click(within(mcpDialog).getByRole('button', { name: 'Close' }));
@@ -359,8 +359,8 @@ describe('SaveAgentButton', () => {
const saveDialog = await screen.findByRole('dialog', { name: 'Save agent' });
fireEvent.change(within(saveDialog).getByLabelText('Agent name'), { target: { value: 'trimmed-agent' } });
- fireEvent.click(within(saveDialog).getByRole('button', { name: 'Edit MCP servers' }));
- const mcpDialog = await findStackedDialog('Edit MCP servers');
+ fireEvent.click(within(saveDialog).getByRole('button', { name: 'Edit Connectors' }));
+ const mcpDialog = await findStackedDialog('Edit Connectors');
fireEvent.click(await within(mcpDialog).findByRole('menuitemcheckbox', { name: /GitHub/ }));
fireEvent.click(within(mcpDialog).getByRole('button', { name: 'Close' }));
diff --git a/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsx b/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsx
index 7b0cd34a5..fd2e0e465 100644
--- a/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsx
@@ -40,6 +40,20 @@ vi.mock('@truefoundry/assistant-ui-runtime/plugins/truefoundry-agent-server-adap
),
}));
+vi.mock('@/plugins/trueforge-agent-server-adapter/index.js', () => ({
+ createTrueForgeAgentUIServer: vi.fn(async () =>
+ createMockAgentUIServer({
+ getCapabilities: async () => ({
+ data: {
+ sandbox: { enabled: true },
+ skill: { enabled: true },
+ settings: { enabled: true },
+ },
+ }),
+ }),
+ ),
+}));
+
import { TrueforgeUI, type ChatLayout } from '@/containers/TrueforgeUI.js';
import { DrawerLayout } from '@/layouts/DrawerLayout.js';
import { SidebarLayout } from '@/layouts/SidebarLayout.js';
@@ -197,8 +211,8 @@ describe('TrueforgeUI', () => {
expect(await within(modelDialog).findByRole('option', { name: 'gpt-4.1' })).toBeInTheDocument();
fireEvent.click(within(modelDialog).getByRole('button', { name: 'Close' }));
- fireEvent.click(within(saveDialog).getByRole('button', { name: 'Edit MCP servers' }));
- const mcpDialog = document.querySelector('dialog[aria-label="Edit MCP servers"]');
+ fireEvent.click(within(saveDialog).getByRole('button', { name: 'Edit Connectors' }));
+ const mcpDialog = document.querySelector('dialog[aria-label="Edit Connectors"]');
if (!(mcpDialog instanceof HTMLDialogElement)) throw new Error('expected stacked MCP dialog');
expect(await within(mcpDialog).findByText('GitHub')).toBeInTheDocument();
expect(getModels).toHaveBeenCalledOnce();
@@ -239,16 +253,13 @@ describe('TrueforgeUI', () => {
}
});
- it('surfaces trueforge-not-implemented as an alert', async () => {
- const onError = vi.fn();
- render(
- <TrueforgeUI server={{ type: 'trueforge', apiKey: 'k' }} layout="sidebar" className="h-96" onError={onError} />,
- );
+ it('resolves type trueforge and mounts the layout', async () => {
+ render(<TrueforgeUI server={{ type: 'trueforge', token: 'tok' }} layout="sidebar" className="h-96" />);
await waitFor(() => {
- expect(screen.getByRole('alert')).toHaveTextContent(/trueforge.*not implemented/i);
+ expect(screen.queryByRole('status', { name: 'Loading' })).not.toBeInTheDocument();
});
- expect(onError).toHaveBeenCalled();
+ expect(screen.queryByRole('alert')).not.toBeInTheDocument();
});
it('shows a loader while truefoundry server init is pending', () => {
diff --git a/packages/trueforge-ui-sdk/test/containers/useResolvedServer.test.tsx b/packages/trueforge-ui-sdk/test/containers/useResolvedServer.test.tsx
index 661af023a..15bb67751 100644
--- a/packages/trueforge-ui-sdk/test/containers/useResolvedServer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/useResolvedServer.test.tsx
@@ -5,6 +5,20 @@ import { describe, expect, it, vi } from 'vitest';
import { useResolvedServer } from '@/containers/useResolvedServer.js';
import { createMockAgentUIServer, createMockCatalog } from '../server/mockServer.js';
+const mockCreateTrueForgeAgentUIServer = vi.fn((_options?: unknown) =>
+ Promise.resolve(
+ createMockAgentUIServer({
+ getCapabilities: async () => ({
+ data: {
+ sandbox: { enabled: true },
+ skill: { enabled: true },
+ settings: { enabled: true },
+ },
+ }),
+ }),
+ ),
+);
+
vi.mock('@truefoundry/assistant-ui-runtime/plugins/truefoundry-agent-server-adapter', () => ({
createTrueFoundryAgentUIServer: vi.fn(async () => ({
createSession: vi.fn(),
@@ -24,6 +38,10 @@ vi.mock('@truefoundry/assistant-ui-runtime/plugins/truefoundry-agent-server-adap
})),
}));
+vi.mock('@/plugins/trueforge-agent-server-adapter/index.js', () => ({
+ createTrueForgeAgentUIServer: (options?: unknown) => mockCreateTrueForgeAgentUIServer(options),
+}));
+
describe('useResolvedServer', () => {
it('passes through AgentUIServer synchronously', () => {
const server = createMockAgentUIServer({ saveAgent: vi.fn() });
@@ -35,15 +53,59 @@ describe('useResolvedServer', () => {
});
});
- it('errors for trueforge until the adapter exists', async () => {
- const onError = vi.fn();
- const { result } = renderHook(() => useResolvedServer({ type: 'trueforge', apiKey: 'k' }, onError));
+ it('loads trueforge via createTrueForgeAgentUIServer', async () => {
+ mockCreateTrueForgeAgentUIServer.mockClear();
+ const fetchImpl = vi.fn() as unknown as typeof fetch;
+ const { result } = renderHook(() =>
+ useResolvedServer({
+ type: 'trueforge',
+ baseUrl: 'https://harness.example',
+ token: 'tok',
+ fetch: fetchImpl,
+ }),
+ );
+
+ await waitFor(() => {
+ expect(result.current.status).toBe('ready');
+ });
+ expect(mockCreateTrueForgeAgentUIServer).toHaveBeenCalledWith({
+ baseUrl: 'https://harness.example',
+ token: 'tok',
+ fetch: fetchImpl,
+ });
+ expect(result.current.server?.getCapabilities).toEqual(expect.any(Function));
+ });
+
+ it('attaches an optional catalog onto the trueforge server when factory returns one', async () => {
+ const catalog = createMockCatalog();
+ mockCreateTrueForgeAgentUIServer.mockImplementationOnce(async () =>
+ createMockAgentUIServer({
+ catalog,
+ getCapabilities: async () => ({
+ data: {
+ sandbox: { enabled: true },
+ skill: { enabled: true },
+ settings: { enabled: true },
+ },
+ }),
+ }),
+ );
+ const { result } = renderHook(() =>
+ useResolvedServer({
+ type: 'trueforge',
+ token: 'tok',
+ catalog,
+ }),
+ );
await waitFor(() => {
- expect(result.current.status).toBe('error');
+ expect(result.current.status).toBe('ready');
+ });
+ expect(mockCreateTrueForgeAgentUIServer).toHaveBeenCalledWith({
+ token: 'tok',
+ catalog,
});
- expect(String(result.current.error)).toMatch(/not implemented/i);
- expect(onError).toHaveBeenCalled();
+ expect(result.current.server?.catalog).toBe(catalog);
});
it('loads truefoundry via createTrueFoundryAgentUIServer', async () => {
diff --git a/packages/trueforge-ui-sdk/test/packageExports.smoke.mjs b/packages/trueforge-ui-sdk/test/packageExports.smoke.mjs
index 235c8fd81..678ce6a8f 100644
--- a/packages/trueforge-ui-sdk/test/packageExports.smoke.mjs
+++ b/packages/trueforge-ui-sdk/test/packageExports.smoke.mjs
@@ -1,6 +1,6 @@
import assert from 'node:assert/strict';
import { execFileSync } from 'node:child_process';
-import { mkdir, mkdtemp, readdir, rm, writeFile } from 'node:fs/promises';
+import { mkdir, mkdtemp, readdir, rm, symlink, writeFile } from 'node:fs/promises';
import path from 'node:path';
import { execPath } from 'node:process';
import { fileURLToPath, URL } from 'node:url';
@@ -27,6 +27,12 @@ try {
await mkdir(packageDir, { recursive: true });
execFileSync('tar', ['-xzf', path.join(tempDir, tarballName), '--strip-components=1', '-C', packageDir]);
+ // Plugin adapter depends on @truefoundry/trueforge-sdk (workspace:* in monorepo) — expose it to the smoke consumer.
+ await symlink(
+ path.resolve(packageRoot, '../sdk'),
+ path.join(tempDir, 'node_modules', '@truefoundry', 'trueforge-sdk'),
+ );
+
// create a package.json for the consumer
await writeFile(
path.join(tempDir, 'package.json'),
@@ -42,12 +48,14 @@ import { fileURLToPath } from 'node:url';
const sdk = await import('@truefoundry/trueforge-ui');
const assistantUi = await import('@truefoundry/trueforge-ui/assistant-ui');
+const trueforgeAdapter = await import('@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter');
assert.equal(typeof sdk.TrueforgeUI, 'function');
assert.equal(typeof sdk.createTrueFoundryServer, 'function');
assert.equal(typeof sdk.useMCPAuth, 'function');
assert.equal(typeof assistantUi.useAui, 'function');
assert.equal(typeof assistantUi.useAuiState, 'function');
+assert.equal(typeof trueforgeAdapter.createTrueForgeAgentUIServer, 'function');
const stylesPath = fileURLToPath(import.meta.resolve('@truefoundry/trueforge-ui/styles.css'));
await access(stylesPath);
diff --git a/packages/frontend/tests/connectorCatalog.test.ts b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.test.ts
similarity index 97%
rename from packages/frontend/tests/connectorCatalog.test.ts
rename to packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.test.ts
index 49662ce20..7ae9d183f 100644
--- a/packages/frontend/tests/connectorCatalog.test.ts
+++ b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.test.ts
@@ -1,5 +1,6 @@
import assert from 'node:assert/strict';
-import { describe, it } from 'node:test';
+import { describe, it } from 'vitest';
+
import {
toHarnessAuth,
toHarnessManifest,
@@ -8,7 +9,7 @@ import {
toUiConnector,
toUiConnectorFromReadEntry,
toUiTool,
-} from '../src/connectorCatalog';
+} from '@/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.js';
describe('connectorCatalog mappers', () => {
it('maps harness auth to UI public auth without secrets', () => {
diff --git a/packages/frontend/tests/modelProviderCatalog.test.ts b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.test.ts
similarity index 96%
rename from packages/frontend/tests/modelProviderCatalog.test.ts
rename to packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.test.ts
index 8db8694d3..bf6c1f129 100644
--- a/packages/frontend/tests/modelProviderCatalog.test.ts
+++ b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.test.ts
@@ -1,13 +1,14 @@
import { TrueForgeApi } from '@truefoundry/trueforge-sdk';
import assert from 'node:assert/strict';
-import { describe, it } from 'node:test';
+import { describe, it } from 'vitest';
+
import {
toHarnessModelEntry,
toHarnessModelProvider,
toUiCatalogModelProviderEntry,
toUiModelEntry,
toUiModelProvider,
-} from '../src/modelProviderCatalog';
+} from '@/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.js';
describe('modelProviderCatalog mappers', () => {
it('round-trips harness model entries through the UI shape', () => {
@@ -17,7 +18,7 @@ describe('modelProviderCatalog mappers', () => {
properties: {
contextLength: 400000,
maxOutputTokens: 32768,
- reasoningEfforts: ['low', 'medium', 'high'],
+ reasoningEfforts: ['low', 'medium', 'high'] as TrueForgeApi.ReasoningEffort[],
},
};
diff --git a/packages/frontend/tests/sandboxProviderCatalog.test.ts b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.test.ts
similarity index 94%
rename from packages/frontend/tests/sandboxProviderCatalog.test.ts
rename to packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.test.ts
index 299c69d81..775d162c3 100644
--- a/packages/frontend/tests/sandboxProviderCatalog.test.ts
+++ b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.test.ts
@@ -1,11 +1,12 @@
import assert from 'node:assert/strict';
-import { describe, it } from 'node:test';
+import { describe, it } from 'vitest';
+
import {
configFromHarness,
toHarnessManifest,
toUiCatalogEntry,
toUiSandboxProvider,
-} from '../src/sandboxProviderCatalog';
+} from '@/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.js';
describe('sandboxProviderCatalog mappers', () => {
const harnessCatalog = {
diff --git a/packages/frontend/tests/skillCatalog.test.ts b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.test.ts
similarity index 94%
rename from packages/frontend/tests/skillCatalog.test.ts
rename to packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.test.ts
index 393b185d7..0f03a1e55 100644
--- a/packages/frontend/tests/skillCatalog.test.ts
+++ b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.test.ts
@@ -1,6 +1,11 @@
import assert from 'node:assert/strict';
-import { describe, it } from 'node:test';
-import { toHarnessManifest, toUiCatalogEntry, toUiSkill } from '../src/skillCatalog';
+import { describe, it } from 'vitest';
+
+import {
+ toHarnessManifest,
+ toUiCatalogEntry,
+ toUiSkill,
+} from '@/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.js';
describe('skillCatalog mappers', () => {
it('maps catalog presets with id = name and repoURL from url', () => {
diff --git a/packages/frontend/tests/harnessBuilderServer.test.ts b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/harnessBuilderServer.test.ts
similarity index 97%
rename from packages/frontend/tests/harnessBuilderServer.test.ts
rename to packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/harnessBuilderServer.test.ts
index f08f1f27a..4e65a4107 100644
--- a/packages/frontend/tests/harnessBuilderServer.test.ts
+++ b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/harnessBuilderServer.test.ts
@@ -1,6 +1,11 @@
import assert from 'node:assert/strict';
-import { describe, it } from 'node:test';
-import { createHarnessBuilderServer, modelProviderLogosByName, toModelSelection } from '../src/harnessBuilderServer';
+import { describe, it } from 'vitest';
+
+import {
+ createHarnessBuilderServer,
+ modelProviderLogosByName,
+ toModelSelection,
+} from '@/plugins/trueforge-agent-server-adapter/builderServer.js';
describe('harnessBuilderServer', () => {
it('modelProviderLogosByName maps well-known catalog logos by type', () => {
diff --git a/packages/frontend/tests/harnessServer.test.ts b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/harnessServer.test.ts
similarity index 99%
rename from packages/frontend/tests/harnessServer.test.ts
rename to packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/harnessServer.test.ts
index e9c42659c..57c2b0485 100644
--- a/packages/frontend/tests/harnessServer.test.ts
+++ b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/harnessServer.test.ts
@@ -1,6 +1,7 @@
import assert from 'node:assert/strict';
-import { describe, it } from 'node:test';
-import { createHarnessChatServer, type HarnessAgentSpec } from '../src/harnessServer';
+import { describe, it } from 'vitest';
+
+import { createHarnessChatServer, type HarnessAgentSpec } from '@/plugins/trueforge-agent-server-adapter/chatServer.js';
const session = {
id: 'ses_1',
diff --git a/packages/trueforge-ui-sdk/tsup.config.ts b/packages/trueforge-ui-sdk/tsup.config.ts
index c1d41b039..34d053219 100644
--- a/packages/trueforge-ui-sdk/tsup.config.ts
+++ b/packages/trueforge-ui-sdk/tsup.config.ts
@@ -10,7 +10,7 @@ import { defineConfig } from 'tsup';
import { embedCssPlugin } from './embedCssPlugin.mjs';
export default defineConfig({
- entry: ['src/index.ts', 'src/assistant-ui.ts'],
+ entry: ['src/index.ts', 'src/assistant-ui.ts', 'src/plugins/trueforge-agent-server-adapter/index.ts'],
format: ['esm'],
dts: true,
sourcemap: true,
@@ -44,5 +44,6 @@ export default defineConfig({
'remark-gfm',
'react-syntax-highlighter',
'monaco-editor',
+ '@truefoundry/trueforge-sdk',
],
});