Skip to content

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

2.6 KB
Raw Blame
import type { ResolvedRoutes } from '../routing/types.js';
import type {
  AgentMetricsServer,
  AgentSessionsServer,
  CatalogServer,
  SandboxEnvironmentServer,
  ScheduleServer,
} from './types.js';

/**
 * Whether Settings chrome is available: sidebar button and `/settings` route.
 * Matches the gate in {@link ShellActions}.
 */
export function isSettingsChromeEnabled({
  catalog,
  capabilities,
}: {
  catalog: CatalogServer | null | undefined;
  capabilities: { settings?: { enabled?: boolean } } | null | undefined;
}): boolean {
  return catalog != null && capabilities?.settings?.enabled === true;
}

/** Sessions browser + agent-detail surfaces (Overview / sessions / code). */
export function isSessionsChromeEnabled({ sessions }: { sessions: AgentSessionsServer | null | undefined }): boolean {
  return sessions != null;
}

/** Schedules page + library schedules column. */
export function isSchedulesChromeEnabled({ schedules }: { schedules: ScheduleServer | null | undefined }): boolean {
  return schedules != null;
}

/** Environments page (sandbox environments CRUD). */
export function isEnvironmentsChromeEnabled({
  sandboxEnvironments,
}: {
  sandboxEnvironments: SandboxEnvironmentServer | null | undefined;
}): boolean {
  return sandboxEnvironments != null;
}

/** Agent-details Metrics tab (no top-level path). */
export function isMetricsChromeEnabled({ metrics }: { metrics: AgentMetricsServer | null | undefined }): boolean {
  return metrics != null;
}

/**
 * Unregister path-backed places whose optional server port is absent.
 * Chrome gates and route gates must stay in lockstep.
 */
export function toEffectiveRoutes({
  routes,
  catalog,
  capabilities,
  sessions,
  schedules,
  sandboxEnvironments,
}: {
  routes: ResolvedRoutes;
  catalog: CatalogServer | null | undefined;
  capabilities: { settings?: { enabled?: boolean } } | null | undefined;
  sessions: AgentSessionsServer | null | undefined;
  schedules: ScheduleServer | null | undefined;
  sandboxEnvironments: SandboxEnvironmentServer | null | undefined;
}): ResolvedRoutes {
  const sessionsEnabled = isSessionsChromeEnabled({ sessions });
  return {
    ...routes,
    settings: isSettingsChromeEnabled({ catalog, capabilities }) ? routes.settings : null,
    sessionsBrowser: sessionsEnabled ? routes.sessionsBrowser : null,
    sharedSession: sessionsEnabled ? routes.sharedSession : null,
    libraryAgent: sessionsEnabled ? routes.libraryAgent : null,
    schedules: isSchedulesChromeEnabled({ schedules }) ? routes.schedules : null,
    environments: isEnvironmentsChromeEnabled({ sandboxEnvironments }) ? routes.environments : null,
  };
}