Skip to content

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

5.2 KB
Raw Blame
/**
 * Built-in Harness → AgentUIServer factory for `<TrueForgeUI server={{ type: "trueforge", … }} />`.
 */
import { createTrueForgeServer } from '../../server/createTrueForgeServer.js';
import type { CatalogServer, PermissionsServer } from '../../server/types.js';
import { createHarnessAgentMetricsServer } from './agentMetricsServer.js';
import { createHarnessAgentSessionsServer } from './agentSessionsServer.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 { createWebSearchProviderCatalog } from './catalogs/webSearchProviderCatalog.js';
import { createHarnessChatServer } from './chatServer.js';
import { createTrueForgeClient, type CreateTrueForgeClientOptions } from './client.js';
import { createHarnessPermissionsServer } from './permissionsServer.js';
import { createSandboxEnvironmentServer } from './sandboxEnvironments/sandboxEnvironmentServer.js';
import { createScheduleServer } from './schedules/scheduleServer.js';
import type { HarnessAgentSpec } from './types.js';

export { createHarnessAgentMetricsServer, type CreateHarnessAgentMetricsServerOptions } from './agentMetricsServer.js';
export {
  createHarnessAgentSessionsServer,
  type CreateHarnessAgentSessionsServerOptions,
} from './agentSessionsServer.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,
  filterUiSandboxProviders,
  isDaytonaSandboxConfig,
  toHarnessManifest as toHarnessSandboxManifest,
  toUiCatalogEntry as toUiSandboxCatalogEntry,
  toUiSandboxProvider,
  type DaytonaSandboxCatalogServer,
  type DaytonaSandboxConfig,
  type UiCreateSandboxProviderRequest,
  type UiSandboxProvider,
  type UiSandboxProviderCatalogEntry,
  type UiUpdateSandboxProviderRequest,
} from './catalogs/sandboxProviderCatalog.js';
export { createSkillCatalog, toHarnessManifest as toHarnessSkillManifest, toUiSkill } from './catalogs/skillCatalog.js';
export {
  createWebSearchProviderCatalog,
  filterUiWebSearchProviders,
  toHarnessManifest as toHarnessWebSearchManifest,
  toUiCatalogEntry as toUiWebSearchCatalogEntry,
  toUiWebSearchProvider,
} from './catalogs/webSearchProviderCatalog.js';
export {
  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 { createHarnessPermissionsServer, type CreateHarnessPermissionsServerOptions } from './permissionsServer.js';
export { createSandboxEnvironmentServer } from './sandboxEnvironments/sandboxEnvironmentServer.js';
export { createScheduleServer } from './schedules/scheduleServer.js';
export type { HarnessAgentSpec, HarnessMcpServerMount, HarnessSkillMount } from './types.js';

export type CreateTrueForgeAgentUIServerOptions = CreateTrueForgeClientOptions & {
  /** Override the default Harness settings catalogs. */
  catalog?: CatalogServer;
  /** Optional host-provided resource permissions port. */
  permissions?: PermissionsServer;
};

/**
 * Compose chat + builder + agent sessions + default settings catalogs into an `AgentUIServer`.
 */
export function createTrueForgeAgentUIServer(options: CreateTrueForgeAgentUIServerOptions = {}) {
  const { catalog: catalogOverride, permissions, ...clientOptions } = options;
  const client = createTrueForgeClient(clientOptions);
  const catalog =
    catalogOverride ??
    ({
      modelCatalog: createModelProviderCatalog(client),
      connectorCatalog: createConnectorCatalog(client),
      skillCatalog: createSkillCatalog(client),
      sandboxCatalog: createSandboxProviderCatalog(client),
      webSearchCatalog: createWebSearchProviderCatalog(client),
    } satisfies CatalogServer);

  return createTrueForgeServer<HarnessAgentSpec>({
    chatServer: createHarnessChatServer({ client }),
    ...createHarnessBuilderServer({ client }),
    catalog,
    sessions: createHarnessAgentSessionsServer({ ...clientOptions, client }),
    metrics: createHarnessAgentMetricsServer({ ...clientOptions, client }),
    schedules: createScheduleServer({ client }),
    sandboxEnvironments: createSandboxEnvironmentServer({ client }),
    permissions: permissions ?? createHarnessPermissionsServer({ client }),
    getMe: async () => {
      const { data } = await client.auth.me();
      return { tenantId: data.tenantId };
    },
  });
}