The open-source agent harness - the runtime layer that turns an LLM into a working agent.
Refactor frontend to use trueforge-sdk instead of trueforge
Chirag Jainbf838d380487
diff --git a/docs/api/overview.mdx b/docs/api/overview.mdxindex 4c766c999..797f49ed1 100644--- a/docs/api/overview.mdx+++ b/docs/api/overview.mdx@@ -327,7 +327,7 @@ curl -X POST http://localhost:8790/api/v1/sessions \<Tab title="TypeScript">```typescript-import { TrueForge } from 'trueforge';+import { TrueForge } from 'trueforge-sdk';const client = new TrueForge({ baseUrl: 'http://localhost:8790' });diff --git a/packages/frontend/package.json b/packages/frontend/package.jsonindex ad4edf1ca..c851e6e8a 100644--- a/packages/frontend/package.json+++ b/packages/frontend/package.json@@ -29,7 +29,7 @@"monaco-editor": "^0.52.0","react": "^19.2.4","react-dom": "^19.2.4",- "trueforge": "link:../sdk"+ "trueforge-sdk": "link:../sdk"},"devDependencies": {"@types/react": "^19.2.17",diff --git a/packages/frontend/src/authSession.ts b/packages/frontend/src/authSession.tsindex 383257fea..f8fb09d1e 100644--- a/packages/frontend/src/authSession.ts+++ b/packages/frontend/src/authSession.ts@@ -2,10 +2,10 @@* Session helpers: SDK `auth.me()` / `auth.logout()` only.* Login is not on the SDK (browser redirect to `/api/v1/auth/login`).*/-import type { TrueForgeApi as Harness, TrueForge } from 'trueforge';+import type { TrueForge, TrueForgeApi } from 'trueforge-sdk';import { harnessClient } from './harnessClient';-export type MeResponse = Harness.MeResponse;+export type MeResponse = TrueForgeApi.MeResponse;/** Last successful me() OIDC check — survives remounts of host chrome. */let cachedIsOidcConnected: boolean | undefined;diff --git a/packages/frontend/src/composerLists.ts b/packages/frontend/src/composerLists.tsindex abf376302..16fac431f 100644--- a/packages/frontend/src/composerLists.ts+++ b/packages/frontend/src/composerLists.ts@@ -2,24 +2,24 @@* Configured-resource list helpers for composer pickers and app boot.* Not the settings catalog ports (`*Catalog.ts`).*/-import type { TrueForgeApi as Harness } from 'trueforge';+import type { TrueForgeApi } from 'trueforge-sdk';import { harnessClient as client } from './harnessClient';-export async function listModels(): Promise<Harness.Model[]> {+export async function listModels(): Promise<TrueForgeApi.Model[]> {const body = await client.models.list();return body.data;}-export async function listConfiguredMcpServers(): Promise<Harness.ConfiguredMcpServer[]> {+export async function listConfiguredMcpServers(): Promise<TrueForgeApi.ConfiguredMcpServer[]> {const body = await client.settings.mcpServers.list();return body.data;}-export async function listSkills(): Promise<Harness.SkillReadEntry[]> {+export async function listSkills(): Promise<TrueForgeApi.SkillReadEntry[]> {const body = await client.skills.list();return body.data;}-export async function getCapabilities(): Promise<Harness.GetCapabilitiesResponseData> {+export async function getCapabilities(): Promise<TrueForgeApi.GetCapabilitiesResponseData> {const body = await client.server.getCapabilities();return body.data;}diff --git a/packages/frontend/src/connectorCatalog.ts b/packages/frontend/src/connectorCatalog.tsindex 34f700f81..1d0c83344 100644--- a/packages/frontend/src/connectorCatalog.ts+++ b/packages/frontend/src/connectorCatalog.ts@@ -15,7 +15,7 @@ import type {ToolBase,UpdateConnectorRequest,} from '@truefoundry/trueforge-ui';-import type { TrueForgeApi as Harness } from 'trueforge';+import type { TrueForgeApi } from 'trueforge-sdk';import { harnessClient as client } from './harnessClient';export type UiConnectorAuth = ConnectorAuth;@@ -25,7 +25,7 @@ export type UiConnectorCatalogEntry = ConnectorCatalogEntry;const DEFAULT_API_KEY_HEADER = 'Authorization';-export function toUiAuthPublic(auth: Harness.ConfiguredMcpServerAuth | undefined): UiConnectorAuthPublic {+export function toUiAuthPublic(auth: TrueForgeApi.ConfiguredMcpServerAuth | undefined): UiConnectorAuthPublic {if (auth === undefined) {return { type: 'none' };}@@ -39,7 +39,7 @@ export function toUiAuthPublic(auth: Harness.ConfiguredMcpServerAuth | undefined};}-export function toHarnessAuth(auth: ConnectorAuth): Harness.ConfiguredMcpServerAuth | undefined {+export function toHarnessAuth(auth: ConnectorAuth): TrueForgeApi.ConfiguredMcpServerAuth | undefined {if (auth.type === 'none') {return undefined;}@@ -55,7 +55,7 @@ export function toHarnessAuth(auth: ConnectorAuth): Harness.ConfiguredMcpServerAreturn { type: 'header', headers: { [headerName]: apiKey } };}-export function toUiCatalogEntry(server: Harness.CatalogMcpServer): UiConnectorCatalogEntry {+export function toUiCatalogEntry(server: TrueForgeApi.CatalogMcpServer): UiConnectorCatalogEntry {return {id: server.name,name: server.name,@@ -71,7 +71,7 @@ export function toUiTool(tool: Record<string, unknown>): ToolBase {return { id: name, name, description };}-export function toUiConnector(server: Harness.ConfiguredMcpServer): UiConnector {+export function toUiConnector(server: TrueForgeApi.ConfiguredMcpServer): UiConnector {const auth = toUiAuthPublic(server.auth);return {id: server.name,@@ -87,7 +87,7 @@ export function toUiConnector(server: Harness.ConfiguredMcpServer): UiConnectorexport interface HarnessMcpUpsert {name: string;url: string;- auth?: Harness.ConfiguredMcpServerAuth;+ auth?: TrueForgeApi.ConfiguredMcpServerAuth;}export function toHarnessManifest(req: { name: string; url: string; auth: ConnectorAuth }): HarnessMcpUpsert {@@ -99,7 +99,7 @@ export function toHarnessManifest(req: { name: string; url: string; auth: Connec};}-async function getConfigured(name: string): Promise<Harness.ConfiguredMcpServer> {+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) {diff --git a/packages/frontend/src/harnessBuilderServer.ts b/packages/frontend/src/harnessBuilderServer.tsindex 3a323d403..81f3710a7 100644--- a/packages/frontend/src/harnessBuilderServer.ts+++ b/packages/frontend/src/harnessBuilderServer.ts@@ -8,7 +8,7 @@ import type {ModelSelection,SearchAgentsParams,} from '@truefoundry/trueforge-ui';-import type { TrueForgeApi as Harness } from 'trueforge';+import type { TrueForgeApi } from 'trueforge-sdk';import { listConfiguredMcpServers, listModels, listSkills } from './composerLists';import { toUiConnector } from './connectorCatalog';import { createHarnessClient, harnessClient, type CreateHarnessClientOptions } from './harnessClient';@@ -20,7 +20,7 @@ export function providerOf(name: string): string {}/** Map harness model rows onto the UI picker shape (incl. reasoning-effort options). */-export function toModelSelection(model: Harness.Model): ModelSelection {+export function toModelSelection(model: TrueForgeApi.Model): ModelSelection {const efforts = model.properties.reasoningEfforts;return {name: model.name,@@ -29,7 +29,7 @@ export function toModelSelection(model: Harness.Model): ModelSelection {};}-function toLibraryEntry(agent: Harness.Agent): AgentLibraryEntry {+function toLibraryEntry(agent: TrueForgeApi.Agent): AgentLibraryEntry {return {name: agent.name,agentId: agent.id,diff --git a/packages/frontend/src/harnessClient.ts b/packages/frontend/src/harnessClient.tsindex aaac5182f..4489175c9 100644--- a/packages/frontend/src/harnessClient.ts+++ b/packages/frontend/src/harnessClient.ts@@ -5,7 +5,7 @@** Default `fetch` intercepts 401 and sends the browser through OIDC login.*/-import { TrueForge } from 'trueforge';+import { TrueForge } from 'trueforge-sdk';import { createAuthAwareFetch } from './authFetch';export interface CreateHarnessClientOptions {diff --git a/packages/frontend/src/harnessServer.ts b/packages/frontend/src/harnessServer.tsindex 37ae2d040..cd0ec6191 100644--- a/packages/frontend/src/harnessServer.ts+++ b/packages/frontend/src/harnessServer.ts@@ -28,33 +28,37 @@ import type {TurnInputItem,UserMessageContent,} from '@truefoundry/trueforge-ui';-import type { TrueForgeApi as Harness } from 'trueforge';+import type { TrueForgeApi } from 'trueforge-sdk';import { createHarnessClient, harnessClient, type CreateHarnessClientOptions } from './harnessClient';export type HarnessSkillMount = SkillMount;-export type HarnessMcpServerMount = McpServerMount & Harness.McpServer;+export type HarnessMcpServerMount = McpServerMount & TrueForgeApi.McpServer;-export interface HarnessAgentSpec extends AgentSpec<Harness.AgentSpecModel, HarnessSkillMount, HarnessMcpServerMount> {- config?: Harness.RuntimeConfig;+export interface HarnessAgentSpec extends AgentSpec<+ TrueForgeApi.AgentSpecModel,+ HarnessSkillMount,+ HarnessMcpServerMount+> {+ config?: TrueForgeApi.RuntimeConfig;instructions?: string;- messages?: Harness.AgentSpecUserMessage[];- responseFormat?: Harness.ResponseFormat;+ messages?: TrueForgeApi.AgentSpecUserMessage[];+ responseFormat?: TrueForgeApi.ResponseFormat;variables?: Record<string, string>;}export type CreateHarnessServerOptions = CreateHarnessClientOptions;/** Mount ids are derived, not stored: Harness returns MCP servers keyed by name. */-function toUiMcpServer(server: Harness.McpServer): HarnessMcpServerMount {+function toUiMcpServer(server: TrueForgeApi.McpServer): HarnessMcpServerMount {return { ...server, id: server.name };}/** Skill ids are derived from the name ref Harness persists. */-function toUiSkill(skill: Harness.SkillNameRef): HarnessSkillMount {+function toUiSkill(skill: TrueForgeApi.SkillNameRef): HarnessSkillMount {return { id: skill.name, name: skill.name };}/** Strip UI-only `id` before admission; Harness skills are name refs only. */-export function toHarnessAgentSpec(spec: HarnessAgentSpec): Harness.AgentSpec {+export function toHarnessAgentSpec(spec: HarnessAgentSpec): TrueForgeApi.AgentSpec {const { skills, mcpServers, ...rest } = spec;return {...rest,@@ -71,7 +75,7 @@ export function toHarnessAgentSpec(spec: HarnessAgentSpec): Harness.AgentSpec {};}-export function toUiAgentSpec(spec: Harness.AgentSpec): HarnessAgentSpec {+export function toUiAgentSpec(spec: TrueForgeApi.AgentSpec): HarnessAgentSpec {const { mcpServers, skills, ...rest } = spec;return {...rest,@@ -81,14 +85,14 @@ export function toUiAgentSpec(spec: Harness.AgentSpec): HarnessAgentSpec {}/** Drop registry identity columns so the rest is a plain AgentSpec. */-export function agentManifest(agent: Harness.Agent): Harness.AgentSpec {+export function agentManifest(agent: TrueForgeApi.Agent): TrueForgeApi.AgentSpec {const { id, name, ...spec } = agent;void id;void name;return spec;}-function toUiSession(session: Harness.Session): Session<HarnessAgentSpec> {+function toUiSession(session: TrueForgeApi.Session): Session<HarnessAgentSpec> {return {id: session.id,isMutable: session.agent.type === 'inline',@@ -103,15 +107,15 @@ function toUiSession(session: Harness.Session): Session<HarnessAgentSpec> {}/** Spread drops the interface identity, which is what makes the SDK's index-signature part type accept it. */-function toUiContent(content: Harness.UserMessageContent): UserMessageContent {+function toUiContent(content: TrueForgeApi.UserMessageContent): UserMessageContent {return typeof content === 'string' ? content : content.map(part => ({ ...part }));}-function toUiInput(input: Harness.TurnInputItem[]): TurnInputItem[] {+function toUiInput(input: TrueForgeApi.TurnInputItem[]): TurnInputItem[] {return input.map(item => (item.type === 'user.message' ? { ...item, content: toUiContent(item.content) } : item));}-function toUiTurn(turn: Harness.Turn): Turn {+function toUiTurn(turn: TrueForgeApi.Turn): Turn {const { previousTurnId, input, ...rest } = turn;return {...rest,@@ -120,17 +124,17 @@ function toUiTurn(turn: Harness.Turn): Turn {};}-function toUiEvent(event: Harness.SessionEvent | Harness.TurnStreamingEvent): SessionEvent {+function toUiEvent(event: TrueForgeApi.SessionEvent | TrueForgeApi.TurnStreamingEvent): SessionEvent {return { ...event };}-function toUiEventItem(item: Harness.SessionEventItem): SessionEventItem {+function toUiEventItem(item: TrueForgeApi.SessionEventItem): SessionEventItem {return { turnId: item.turnId, event: toUiEvent(item.event) };}interface HarnessPageSource<T> {data: T[];- response: { pagination: Harness.TokenPagination };+ response: { pagination: TrueForgeApi.TokenPagination };getNextPage(): Promise<HarnessPageSource<T>>;}@@ -158,7 +162,7 @@ function sequenceNumber(id: string | undefined, fallback: number): number {return Number.isSafeInteger(parsed) && parsed >= 0 ? parsed : fallback;}-function toHarnessContent(content: UserMessageContent): Harness.UserMessageContent {+function toHarnessContent(content: UserMessageContent): TrueForgeApi.UserMessageContent {if (typeof content === 'string') return content;return content.map(part => {if (part.type === 'text') return part;@@ -170,7 +174,7 @@ function toHarnessContent(content: UserMessageContent): Harness.UserMessageConte});}-function toHarnessInput(input: TurnInputItem[]): Harness.TurnInputItem[] {+function toHarnessInput(input: TurnInputItem[]): TrueForgeApi.TurnInputItem[] {return input.map(item =>item.type === 'user.message' ? { ...item, content: toHarnessContent(item.content) } : item,);diff --git a/packages/frontend/src/modelProviderCatalog.ts b/packages/frontend/src/modelProviderCatalog.tsindex acf96d8a4..1be1163cc 100644--- a/packages/frontend/src/modelProviderCatalog.ts+++ b/packages/frontend/src/modelProviderCatalog.ts@@ -13,22 +13,22 @@ import type {ModelProviderCatalogEntry,UpdateModelProviderRequest,} from '@truefoundry/trueforge-ui';-import { TrueForgeApi as Harness } from 'trueforge';+import { TrueForgeApi } from 'trueforge-sdk';import { harnessClient as client } from './harnessClient';/** Custom-form rows omit properties; catalog rows round-trip them. */export type UiModelEntry = ModelEntry & {- properties?: Harness.ModelProperties;+ properties?: TrueForgeApi.ModelProperties;};export type UiModelProvider = ModelProviderBase<UiModelEntry>;export type UiModelProviderCatalogEntry = ModelProviderCatalogEntry<UiModelEntry>;-const DEFAULT_MODEL_PROPERTIES: Harness.ModelProperties = {+const DEFAULT_MODEL_PROPERTIES: TrueForgeApi.ModelProperties = {contextLength: 128_000,maxOutputTokens: 16_384,};-export function toUiModelEntry(model: Harness.ModelEntry): UiModelEntry {+export function toUiModelEntry(model: TrueForgeApi.ModelEntry): UiModelEntry {return {id: model.modelId,name: model.name,@@ -36,7 +36,7 @@ export function toUiModelEntry(model: Harness.ModelEntry): UiModelEntry {};}-export function toHarnessModelEntry(model: UiModelEntry): Harness.ModelEntry {+export function toHarnessModelEntry(model: UiModelEntry): TrueForgeApi.ModelEntry {return {modelId: model.id,name: model.name,@@ -44,7 +44,7 @@ export function toHarnessModelEntry(model: UiModelEntry): Harness.ModelEntry {};}-export function toUiModelProvider(provider: Harness.ModelProvider): UiModelProvider {+export function toUiModelProvider(provider: TrueForgeApi.ModelProvider): UiModelProvider {// Every type but `custom` is named after itself, so the wire leaves `name` optional.const name = provider.name ?? provider.type;return {@@ -56,7 +56,7 @@ export function toUiModelProvider(provider: Harness.ModelProvider): UiModelProvi};}-export function toUiCatalogEntry(provider: Harness.CatalogProvider): UiModelProviderCatalogEntry {+export function toUiCatalogEntry(provider: TrueForgeApi.CatalogProvider): UiModelProviderCatalogEntry {return {type: provider.type,name: provider.name,@@ -66,9 +66,9 @@ export function toUiCatalogEntry(provider: Harness.CatalogProvider): UiModelProv}/** The catalog lists every type but `custom`, which only exists as tenant configuration. */-const PROVIDER_TYPES: readonly string[] = [...Object.values(Harness.CatalogProviderType), 'custom'];+const PROVIDER_TYPES: readonly string[] = [...Object.values(TrueForgeApi.CatalogProviderType), 'custom'];-function isProviderType(type: string): type is Harness.ModelProvider['type'] {+function isProviderType(type: string): type is TrueForgeApi.ModelProvider['type'] {return PROVIDER_TYPES.includes(type);}@@ -78,7 +78,7 @@ export function toHarnessModelProvider(req: {apiKey: string;baseUrl?: string;models: UiModelEntry[];-}): Harness.ModelProvider {+}): TrueForgeApi.ModelProvider {const models = req.models.map(toHarnessModelEntry);const auth = { apiKey: req.apiKey };if (!isProviderType(req.type)) {diff --git a/packages/frontend/src/sandboxProviderCatalog.ts b/packages/frontend/src/sandboxProviderCatalog.tsindex ae94f95e1..b3ceefd4b 100644--- a/packages/frontend/src/sandboxProviderCatalog.ts+++ b/packages/frontend/src/sandboxProviderCatalog.ts@@ -12,7 +12,7 @@ import type {SandboxProviderCatalogEntry,SandboxProviderConfig,} from '@truefoundry/trueforge-ui';-import { TrueForgeApi as Harness } from 'trueforge';+import { TrueForgeApi } from 'trueforge-sdk';import { harnessClient as client } from './harnessClient';export type UiSandboxProvider = SandboxProviderBase;@@ -29,7 +29,7 @@ function displayNameForType(type: string): string {}export function configFromHarness(- provider: Harness.CatalogDaytonaSandboxProvider | Harness.DaytonaSandboxProvider,+ provider: TrueForgeApi.CatalogDaytonaSandboxProvider | TrueForgeApi.DaytonaSandboxProvider,): SandboxProviderConfig {return {snapshotName: provider.snapshotName,@@ -40,7 +40,7 @@ export function configFromHarness(};}-export function toUiCatalogEntry(provider: Harness.CatalogDaytonaSandboxProvider): UiSandboxProviderCatalogEntry {+export function toUiCatalogEntry(provider: TrueForgeApi.CatalogDaytonaSandboxProvider): UiSandboxProviderCatalogEntry {return {id: provider.type,name: displayNameForType(provider.type),@@ -49,7 +49,7 @@ export function toUiCatalogEntry(provider: Harness.CatalogDaytonaSandboxProvider};}-export function toUiSandboxProvider(provider: Harness.DaytonaSandboxProvider): UiSandboxProvider {+export function toUiSandboxProvider(provider: TrueForgeApi.DaytonaSandboxProvider): UiSandboxProvider {return {id: provider.type,name: displayNameForType(provider.type),@@ -64,7 +64,7 @@ export function toHarnessManifest(type: string;apiKey: string;} & SandboxProviderConfig,-): Harness.DaytonaSandboxProvider {+): TrueForgeApi.DaytonaSandboxProvider {if (req.type !== DAYTONA_TYPE) {throw new Error(`Unsupported sandbox provider type: ${req.type}`);}@@ -101,7 +101,7 @@ export function createSandboxProviderCatalog(): SandboxCatalogServer {const body = await client.settings.sandboxProviders.get();providers = [toUiSandboxProvider(body.data)];} catch (err) {- if (err instanceof Harness.NotFoundError) {+ if (err instanceof TrueForgeApi.NotFoundError) {providers = [];} else {throw err;diff --git a/packages/frontend/src/skillCatalog.ts b/packages/frontend/src/skillCatalog.tsindex 422019c36..fbc775469 100644--- a/packages/frontend/src/skillCatalog.ts+++ b/packages/frontend/src/skillCatalog.ts@@ -8,13 +8,13 @@* configured skill name matches a catalog preset.*/import type { DefinedSkill, SkillCatalogEntry, SkillCatalogServer, SkillConfigBase } from '@truefoundry/trueforge-ui';-import type { TrueForgeApi as Harness } from 'trueforge';+import type { TrueForgeApi } from 'trueforge-sdk';import { harnessClient as client } from './harnessClient';export type UiSkill = DefinedSkill;export type UiSkillCatalogEntry = SkillCatalogEntry;-export function toUiCatalogEntry(skill: Harness.CatalogSkill): UiSkillCatalogEntry {+export function toUiCatalogEntry(skill: TrueForgeApi.CatalogSkill): UiSkillCatalogEntry {return {id: skill.name,name: skill.name,@@ -25,7 +25,7 @@ export function toUiCatalogEntry(skill: Harness.CatalogSkill): UiSkillCatalogEnt};}-export function toHarnessManifest(req: SkillConfigBase): Harness.SkillManifest {+export function toHarnessManifest(req: SkillConfigBase): TrueForgeApi.SkillManifest {const path = req.path.trim();return {type: 'git',@@ -37,7 +37,7 @@ export function toHarnessManifest(req: SkillConfigBase): Harness.SkillManifest {};}-export function toUiSkill(skill: Harness.SkillManifest, catalogNames: ReadonlySet<string>): UiSkill {+export function toUiSkill(skill: TrueForgeApi.SkillManifest, catalogNames: ReadonlySet<string>): UiSkill {const base = {id: skill.name,name: skill.name,diff --git a/packages/frontend/tests/authSession.test.ts b/packages/frontend/tests/authSession.test.tsindex ec9d05b89..5e064238c 100644--- a/packages/frontend/tests/authSession.test.ts+++ b/packages/frontend/tests/authSession.test.ts@@ -1,6 +1,6 @@import assert from 'node:assert/strict';import { describe, it } from 'node:test';-import type { TrueForge } from 'trueforge';+import type { TrueForge } from 'trueforge-sdk';import {getCachedIsOidcConnectedSession,isOidcConnectedSession,diff --git a/packages/frontend/tests/modelProviderCatalog.test.ts b/packages/frontend/tests/modelProviderCatalog.test.tsindex 930fc5382..2a780159b 100644--- a/packages/frontend/tests/modelProviderCatalog.test.ts+++ b/packages/frontend/tests/modelProviderCatalog.test.ts@@ -1,6 +1,6 @@import assert from 'node:assert/strict';import { describe, it } from 'node:test';-import { TrueForgeApi } from 'trueforge';+import { TrueForgeApi } from 'trueforge-sdk';import {toHarnessModelEntry,toHarnessModelProvider,diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex 857f502d3..f93a407a9 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -69,7 +69,7 @@ importers:react-dom:specifier: ^19.2.4version: 19.2.8([email protected])- trueforge:+ trueforge-sdk:specifier: link:../sdkversion: link:../sdkdevDependencies: