The open-source agent harness - the runtime layer that turns an LLM into a working agent.
feat: Sandbox environments (#918)
harshil-20962b76ce3e5cc7
diff --git a/.changeset/environments-page-ui.md b/.changeset/environments-page-ui.mdnew file mode 100644index 000000000..739c12785--- /dev/null+++ b/.changeset/environments-page-ui.md@@ -0,0 +1,6 @@+---+'@truefoundry/trueforge-assistant-ui-runtime': patch+'@truefoundry/trueforge-ui': patch+---++Add Environments page for sandbox environment CRUD (`/environments`), with UI Form and YAML editors, sidebar Envs nav, and a SandboxEnvironmentServer port.diff --git a/.changeset/refresh-ready-sandbox-env-picker.md b/.changeset/refresh-ready-sandbox-env-picker.mdnew file mode 100644index 000000000..25a3eaf1a--- /dev/null+++ b/.changeset/refresh-ready-sandbox-env-picker.md@@ -0,0 +1,5 @@+---+'@truefoundry/trueforge-ui': patch+---++Refresh agent environment pickers after Manage Environments create/activate/delete so the ready list does not stay stale while the draft UI stays mounted.diff --git a/.changeset/update-sandbox-env-status-ready.md b/.changeset/update-sandbox-env-status-ready.mdnew file mode 100644index 000000000..7dcfb8045--- /dev/null+++ b/.changeset/update-sandbox-env-status-ready.md@@ -0,0 +1,6 @@+---+'@truefoundry/trueforge-assistant-ui-runtime': patch+'@truefoundry/trueforge-ui': patch+---++Update SandboxEnvironmentStatus from 'active' to 'ready' to align with backend environment version readiness, remove static default environment injection from draft selectors, fix sandbox provider readiness check latching false on EnvironmentsPage, and drain all sandbox environment pages with limit up to 1000 in agent draft pickers.diff --git a/packages/assistant-ui-runtime/src/server/index.ts b/packages/assistant-ui-runtime/src/server/index.tsindex 6bc307338..8b8ece6ad 100644--- a/packages/assistant-ui-runtime/src/server/index.ts+++ b/packages/assistant-ui-runtime/src/server/index.ts@@ -65,6 +65,7 @@ export type {ListPermissionsRequest,ListPermissionsResponse,ListResult,+ ListSandboxEnvironmentsParams,ListSchedulesParams,ListSessionEventsParams,ListSessionsOrder,@@ -92,6 +93,14 @@ export type {SandboxBase,SandboxCatalogEntry,SandboxCatalogServer,+ SandboxEnvironment,+ SandboxEnvironmentImage,+ SandboxEnvironmentManifest,+ SandboxEnvironmentNetworking,+ SandboxEnvironmentResources,+ SandboxEnvironmentSecret,+ SandboxEnvironmentServer,+ SandboxEnvironmentStatus,SandboxProviderBase,SandboxProviderCatalogEntry,SaveAgentRequest,diff --git a/packages/assistant-ui-runtime/src/server/types.ts b/packages/assistant-ui-runtime/src/server/types.tsindex 251ac2cc5..376aa4a20 100644--- a/packages/assistant-ui-runtime/src/server/types.ts+++ b/packages/assistant-ui-runtime/src/server/types.ts@@ -1050,6 +1050,65 @@ export interface ScheduleServer<createScheduleRun(req: CreateScheduleRunRequest): Promise<TRun>;}+// ---------------------------------------------------------------------------+// Sandbox environments — optional Environments page CRUD+// ---------------------------------------------------------------------------++export type SandboxEnvironmentStatus = 'pending' | 'ready' | 'failed';++export interface SandboxEnvironmentResources {+ cpu: number;+ memory: number;+ disk: number;+}++export interface SandboxEnvironmentSecret {+ env: string;+ value: string;+ hosts: string[];+}++export interface SandboxEnvironmentNetworking {+ networkBlockAll?: boolean;+ domainAllowList?: string;+ secrets?: SandboxEnvironmentSecret[];+}++export interface SandboxEnvironmentImage {+ type: 'build';+ buildScript?: string;+}++export interface SandboxEnvironmentManifest {+ name: string;+ description?: string;+ image?: SandboxEnvironmentImage;+ resources?: SandboxEnvironmentResources;+ environmentVariables?: Record<string, string>;+ networking?: SandboxEnvironmentNetworking;+}++export interface SandboxEnvironment {+ id: string;+ name: string;+ description: string;+ status: SandboxEnvironmentStatus;+ statusReason: string | null;+ manifest: SandboxEnvironmentManifest;+ createdBySubject: CreatedBySubject;+ createdAt: string;+ updatedAt: string;+}++export type ListSandboxEnvironmentsParams = Pick<PageParams, 'limit' | 'pageToken'>;++export interface SandboxEnvironmentServer<TEnvironment extends SandboxEnvironment = SandboxEnvironment> {+ listEnvironments(req?: ListSandboxEnvironmentsParams): Promise<ListResult<TEnvironment>>;+ getEnvironment(req: { name: string }): Promise<TEnvironment>;+ createOrUpdateEnvironment(req: { manifest: SandboxEnvironmentManifest }): Promise<TEnvironment>;+ deleteEnvironment(req: { name: string }): Promise<void>;+}+// ---------------------------------------------------------------------------// Permissions — optional resource mutation grants// ---------------------------------------------------------------------------@@ -1159,6 +1218,9 @@ export interface AgentMetricsServer<* `useScheduleServer()` / list and manage schedules; if omitted, that surface* stays hidden.*+ * `sandboxEnvironments` is optional — if the host passes it, Environments UI+ * can call `useSandboxEnvironmentServer()`; if omitted, that surface stays hidden.+ ** `metrics` is optional — if the host passes it, agent-detail UI can render* aggregate meter cards and time-series charts.*@@ -1170,6 +1232,7 @@ export type AgentUIServerPort<TCatalog extends CatalogServer = CatalogServer,TSessions extends AgentSessionsServer = AgentSessionsServer,TSchedules extends ScheduleServer = ScheduleServer,+ TSandboxEnvironments extends SandboxEnvironmentServer = SandboxEnvironmentServer,TMetrics extends AgentMetricsServer = AgentMetricsServer,TPermissions extends PermissionsServer = PermissionsServer,> = TChat &@@ -1177,6 +1240,7 @@ export type AgentUIServerPort<catalog?: TCatalog;sessions?: TSessions;schedules?: TSchedules;+ sandboxEnvironments?: TSandboxEnvironments;metrics?: TMetrics;permissions?: TPermissions;/** Authenticated caller identity. Used for tenant-scoped share copy. */diff --git a/packages/trueforge-ui/package.json b/packages/trueforge-ui/package.jsonindex dab1a8dc9..571a27cad 100644--- a/packages/trueforge-ui/package.json+++ b/packages/trueforge-ui/package.json@@ -112,6 +112,7 @@"remark-gfm": "^4.0.1","tailwind-merge": "^3.6.0","thinking-orbs": "^0.3.1",+ "yaml": "^2.9.0","zod": "^4.4.3"},"devDependencies": {diff --git a/packages/trueforge-ui/src/atoms/CodeEditor.tsx b/packages/trueforge-ui/src/atoms/CodeEditor.tsxindex fd120fd61..5adfc6217 100644--- a/packages/trueforge-ui/src/atoms/CodeEditor.tsx+++ b/packages/trueforge-ui/src/atoms/CodeEditor.tsx@@ -11,6 +11,7 @@ import type { MonacoEditorCoreProps } from './MonacoEditorCore.js';export type CodeEditorProps = Omit<MonacoEditorCoreProps, 'onAutoHeightChange' | 'options'> & {filename?: string;showToolbar?: boolean;+ defaultShowLineNumbers?: boolean;};function ToolbarButton({@@ -58,9 +59,10 @@ export function CodeEditor({className,height,showToolbar = true,+ defaultShowLineNumbers = false,}: CodeEditorProps) {const MonacoEditorCore = useSlot('MonacoEditorCore');- const [showLineNumbers, setShowLineNumbers] = useState(false);+ const [showLineNumbers, setShowLineNumbers] = useState(defaultShowLineNumbers);const [expanded, setExpanded] = useState(false);const [copied, setCopied] = useState(false);diff --git a/packages/trueforge-ui/src/atoms/EnvironmentsButton.tsx b/packages/trueforge-ui/src/atoms/EnvironmentsButton.tsxnew file mode 100644index 000000000..e1e1d012c--- /dev/null+++ b/packages/trueforge-ui/src/atoms/EnvironmentsButton.tsx@@ -0,0 +1,61 @@+'use client';++import { Icon } from '../icons/Icon.js';+import { useOptionalSandboxEnvironmentServer } from '../server/ServerContext.js';+import { useOptionalShellMode } from '../server/ShellModeContext.js';+import { isEnvironmentsChromeEnabled } from '../server/serverChrome.js';+import { auiButtonClass, sidebarButtonRadiusClassName, sidebarRailButtonClassName } from './lib/buttonClasses.js';+import { cn } from './lib/cn.js';++export type EnvironmentsButtonProps = {+ className?: string;+ compact?: boolean;+};++export function EnvironmentsButton({ className, compact = false }: EnvironmentsButtonProps) {+ const shell = useOptionalShellMode();+ const sandboxEnvironmentServer = useOptionalSandboxEnvironmentServer();++ const enabled = isEnvironmentsChromeEnabled({ sandboxEnvironments: sandboxEnvironmentServer }) && shell != null;+ const open = shell?.environmentsOpen === true;++ if (!enabled) return null;++ return (+ <div className={cn('relative min-w-0', compact ? 'flex justify-center' : 'w-full', className)}>+ <button+ type="button"+ aria-label={compact ? 'Envs' : undefined}+ title={compact ? 'Envs' : undefined}+ aria-current={open ? 'page' : undefined}+ className={auiButtonClass({+ variant: 'ghost',+ className: cn(+ sidebarButtonRadiusClassName,+ 'font-normal text-sidebar-text shadow-none hover:bg-secondary-button-hover hover:text-ghost-button-text',+ compact ? sidebarRailButtonClassName : 'h-8 w-full !justify-start px-2.5 text-sm',+ open &&+ 'bg-primary-button-bg font-medium text-primary-button-text hover:bg-primary-button-hover hover:text-primary-button-text',+ ),+ })}+ onClick={() => shell.setEnvironmentsOpen(!open)}+ >+ <Icon name="monitor" size={compact ? 14 : undefined} />+ {compact ? (+ <span className="text-center">Envs</span>+ ) : (+ <>+ <span className="truncate">Environments</span>+ <Icon name="chevron-right" className="ml-auto size-3.5 shrink-0 opacity-60" />+ </>+ )}+ </button>+ </div>+ );+}++declare module '../theme/SlotsProvider.js' {+ interface AtomSlots {+ EnvironmentsButton: typeof EnvironmentsButton;+ }+}diff --git a/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigFields.tsx b/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigFields.tsxindex 647345439..1ee8f1cf1 100644--- a/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigFields.tsx+++ b/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigFields.tsx@@ -1,6 +1,11 @@'use client';+import { useMemo } from 'react';++import { Icon } from '../../icons/Icon.js';+import { useOptionalShellMode } from '../../server/ShellModeContext.js';import type { AgentCompactionConfig, AgentRuntimeConfig } from '../../server/types.js';+import { useReadySandboxEnvironments } from '../environments/useReadySandboxEnvironments.js';import { cn } from '../lib/cn.js';import { auiInputClass } from '../lib/inputClasses.js';import { PopoverSelect } from '../primitives/PopoverSelect.js';@@ -59,6 +64,18 @@ export function AgentRuntimeConfigFields({layout = 'compact',onChange,}: AgentRuntimeConfigFieldsProps) {+ const shell = useOptionalShellMode();+ const { environments: readyEnvironments, refetch: refetchEnvironments } = useReadySandboxEnvironments();++ const environmentOptions = useMemo(+ () =>+ readyEnvironments.map(env => ({+ value: env.name,+ label: env.name,+ })),+ [readyEnvironments],+ );+const withCompaction = (compaction: AgentCompactionConfig): AgentRuntimeConfig => ({...value,contextManagement: {@@ -225,6 +242,45 @@ export function AgentRuntimeConfigFields({<section className="py-4">{switchField({ field: sandboxField, className: rowClassName })}<div className={`mt-3 border-l-2 border-primary-button-bg/50 pl-3 ${sandboxEnabled ? '' : 'opacity-50'}`}>+ <div className={cn('flex py-4', rowClassName)}>+ <span className="min-w-0 flex-1">+ <span className="text-text-primary block text-sm font-medium">Environment</span>+ <span className="text-text-secondary mt-0.5 block text-xs leading-snug">+ Image, resources, network and secrets the sandbox starts with. Stored by name.+ </span>+ {shell ? (+ <button+ type="button"+ onClick={() => shell.setEnvironmentsOpen(true)}+ className="text-primary-button-bg mt-1.5 inline-flex items-center gap-1 text-xs hover:underline"+ >+ <span>Manage Environments</span>+ <Icon name="external-link" className="size-3" />+ </button>+ ) : null}+ </span>+ <div className="flex shrink-0 items-center">+ <PopoverSelect+ aria-label="Environment"+ value={value.sandbox?.environment_name?.trim() || 'default'}+ options={environmentOptions}+ disabled={disabled || !sandboxAvailable || !sandboxEnabled}+ className="w-48"+ onOpenChange={nextOpen => {+ if (nextOpen) void refetchEnvironments();+ }}+ onValueChange={selected =>+ onChange({+ ...value,+ sandbox: {+ ...value.sandbox,+ environment_name: selected === 'default' ? undefined : selected,+ },+ })+ }+ />+ </div>+ </div>{switchField({ field: fileDownloadsField, className: rowClassName })}</div></section>diff --git a/packages/trueforge-ui/src/atoms/draft/DraftCompositeSelector.tsx b/packages/trueforge-ui/src/atoms/draft/DraftCompositeSelector.tsxindex 77dea5902..59975c20c 100644--- a/packages/trueforge-ui/src/atoms/draft/DraftCompositeSelector.tsx+++ b/packages/trueforge-ui/src/atoms/draft/DraftCompositeSelector.tsx@@ -9,9 +9,11 @@ import { useOptionalCatalogServer, useServerCapabilities } from '../../server/Seimport { useOptionalShellMode, type SettingsSection } from '../../server/ShellModeContext.js';import type { AgentSkill, ConnectorState } from '../../server/types.js';import { useSlot } from '../../theme/SlotsProvider.js';+import { useReadySandboxEnvironments } from '../environments/useReadySandboxEnvironments.js';import { auiButtonClass } from '../lib/buttonClasses.js';import { cn } from '../lib/cn.js';import { useCompactLayout } from '../lib/CompactLayoutContext.js';+import { formatRelativeTime } from '../lib/dateFormat.js';import { auiInputClass } from '../lib/inputClasses.js';import { useIsMobile } from '../lib/useIsMobile.js';import { BottomSheet } from '../primitives/BottomSheet.js';@@ -50,11 +52,12 @@ export function draftMountsFromSpec(value: unknown): DraftMount[] {}return mounts;}-type AttachTab = 'connectors' | 'skills';+type AttachTab = 'connectors' | 'skills' | 'environments';const TABS: { id: AttachTab; label: string; icon: string }[] = [{ id: 'connectors', label: 'Connectors', icon: 'plug' },{ id: 'skills', label: 'Skills', icon: 'lightbulb' },+ { id: 'environments', label: 'Environment', icon: 'monitor' },];const SPEC_FLUSH_MS = 300;@@ -67,6 +70,7 @@ export function CatalogRow({fallbackIcon,checked,disabled = false,+ selectionControl = 'checkbox',onToggle,onActivate,action,@@ -79,6 +83,7 @@ export function CatalogRow({fallbackIcon?: string;checked: boolean;disabled?: boolean;+ selectionControl?: 'checkbox' | 'radio';onToggle: () => void;onActivate?: () => void;action?: ReactNode;@@ -107,10 +112,27 @@ export function CatalogRow({</>);+ const control =+ selectionControl === 'radio' ? (+ <span+ className={cn(+ 'flex size-4 shrink-0 items-center justify-center rounded-full border transition-colors',+ checked ? 'border-primary-button-bg bg-primary-button-bg' : 'border-text-secondary/60 bg-input-box-bg',+ )}+ aria-hidden+ >+ {checked ? <span className="size-1.5 rounded-full bg-primary-button-text" /> : null}+ </span>+ ) : (+ <Checkbox checked={checked} />+ );++ const role = selectionControl === 'radio' ? 'menuitemradio' : 'menuitemcheckbox';+if (action || onActivate) {return (<div- role="menuitemcheckbox"+ role={role}aria-checked={checked}tabIndex={0}className="hover:bg-ghost-button-hover flex w-full cursor-pointer items-center gap-2 rounded-md px-2 py-2 text-left"@@ -131,7 +153,7 @@ export function CatalogRow({</span><buttontype="button"- role="checkbox"+ role={selectionControl === 'radio' ? 'radio' : 'checkbox'}aria-checked={checked}aria-label={`${checked ? 'Deselect' : 'Select'} ${title}`}disabled={disabled}@@ -141,7 +163,7 @@ export function CatalogRow({onToggle();}}>- <Checkbox checked={checked} />+ {control}</button></div>);@@ -150,14 +172,14 @@ export function CatalogRow({return (<buttontype="button"- role="menuitemcheckbox"+ role={role}aria-checked={checked}disabled={disabled}className="hover:bg-ghost-button-hover flex w-full cursor-pointer items-center gap-2 rounded-md px-2 py-2 text-left disabled:cursor-not-allowed disabled:opacity-50 disabled:hover:bg-transparent"onClick={onToggle}>{content}- {disabled ? <Icon name="lock" className="text-text-secondary size-3" /> : <Checkbox checked={checked} />}+ {disabled ? <Icon name="lock" className="text-text-secondary size-3" /> : control}</button>);}@@ -461,12 +483,22 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftC);};+ const {+ environments: readyEnvironments,+ loading: environmentsLoading,+ refetch: refetchEnvironments,+ } = useReadySandboxEnvironments();+const openPicker = (nextTab?: AttachTab) => {if (nextTab != null) {setTab(nextTab);setQuery('');}- if (open) return;+ const showEnvironments = nextTab === 'environments' || (nextTab == null && tab === 'environments');+ if (open) {+ if (showEnvironments) void refetchEnvironments();+ return;+ }setLocalMcp(specMcp);setLocalSkills(specSkills);dirtyRef.current = false;@@ -474,6 +506,7 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftCsetPinnedMcpIds(new Set(specMcp.map(m => m.id)));setPinnedSkillIds(new Set(specSkills.map(skill => skillFamilyId(skill.id))));setOpen(true);+ if (showEnvironments) void refetchEnvironments();};const openSettings = (section: SettingsSection) => {@@ -482,6 +515,34 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftCshell?.setSettingsOpen(true, section);};+ const currentEnvName = agentSpec?.config?.sandbox?.environment_name?.trim() || 'default';++ const filteredEnvironments = useMemo(() => {+ const all = readyEnvironments.map(e => ({+ name: e.name,+ description: e.manifest.description || `Created ${formatRelativeTime(e.createdAt)}`,+ }));+ const needle = query.trim().toLowerCase();+ if (!needle) return all;+ return all.filter(+ item => item.name.toLowerCase().includes(needle) || (item.description?.toLowerCase().includes(needle) ?? false),+ );+ }, [readyEnvironments, query]);++ const selectEnvironment = (envName: string) => {+ const isDefault = envName === 'default';+ updateAgentSpec?.({+ config: {+ ...agentSpec?.config,+ sandbox: {+ ...agentSpec?.config?.sandbox,+ enabled: isDefault ? agentSpec?.config?.sandbox?.enabled : true,+ environment_name: isDefault ? undefined : envName,+ },+ },+ });+ };+const content = (<><div className="flex shrink-0 border-b border-border">@@ -499,6 +560,9 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftConClick={() => {setTab(t.id);setQuery('');+ if (t.id === 'environments') {+ void refetchEnvironments();+ }}}><Icon name={t.icon} className="size-3.5" />@@ -515,7 +579,13 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftC<SearchFieldvalue={query}onChange={setQuery}- placeholder={tab === 'connectors' ? 'Search connectors...' : 'Search skills...'}+ placeholder={+ tab === 'connectors'+ ? 'Search connectors...'+ : tab === 'skills'+ ? 'Search skills...'+ : 'Search environment...'+ }/>{tab === 'skills' && skillsDisabled && skillsDisabledReason ? (<div@@ -581,7 +651,7 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftC/>) : null}</>- ) : (+ ) : tab === 'skills' ? (<>{pinnedSelectedSkills.length > 0 ? (<>@@ -608,6 +678,38 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftC/>) : null}</>+ ) : (+ <>+ {filteredEnvironments.map(env => {+ const isSelected = currentEnvName === env.name;+ return (+ <CatalogRow+ key={env.name}+ title={env.name}+ description={env.description}+ fallbackIcon="monitor"+ selectionControl="radio"+ checked={isSelected}+ onToggle={() => selectEnvironment(env.name)}+ />+ );+ })}+ {filteredEnvironments.length === 0 ? (+ <DraftCatalogEmptyState+ loading={environmentsLoading}+ emptyLabel="No environments"+ settingsTarget="Environments"+ onOpenSettings={+ shell+ ? () => {+ setOpenAndFlush(false);+ shell.setEnvironmentsOpen(true);+ }+ : undefined+ }+ />+ ) : null}+ </>)}</div></>diff --git a/packages/trueforge-ui/src/atoms/environments/EnvironmentFormDrawer.tsx b/packages/trueforge-ui/src/atoms/environments/EnvironmentFormDrawer.tsxnew file mode 100644index 000000000..1511b0b24--- /dev/null+++ b/packages/trueforge-ui/src/atoms/environments/EnvironmentFormDrawer.tsx@@ -0,0 +1,242 @@+'use client';++import { useEffect, useMemo, useState, type FormEvent } from 'react';++import { useToasterOptional } from '../../containers/ToasterContainer.js';+import { useSandboxEnvironmentServer } from '../../server/ServerContext.js';+import type { SandboxEnvironment, SandboxEnvironmentManifest } from '../../server/types.js';+import { getErrorMessage } from '../../utils/getErrorMessage.js';+import { CodeEditor } from '../CodeEditor.js';+import { cn } from '../lib/cn.js';+import { Button } from '../primitives/Button.js';+import { Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle } from '../primitives/Dialog.js';+import { SideDrawer } from '../primitives/SideDrawer.js';+import { defaultEnvironmentManifest } from './environmentDisplay.js';+import {+ EnvironmentFormFields,+ formValuesToManifest,+ manifestToFormValues,+ validateEnvironmentForm,+ type EnvironmentFormValues,+} from './EnvironmentFormFields.js';+import { manifestToYaml, parseManifestYaml } from './environmentYaml.js';++export type EnvironmentFormDrawerProps = {+ open: boolean;+ onOpenChange: (open: boolean) => void;+ mode: 'create' | 'edit';+ environment?: SandboxEnvironment;+ onSaved?: () => void;+};++type EditorMode = 'form' | 'yaml';++export function EnvironmentFormDrawer({ open, onOpenChange, mode, environment, onSaved }: EnvironmentFormDrawerProps) {+ const environmentServer = useSandboxEnvironmentServer();+ const toaster = useToasterOptional();+ const [editorMode, setEditorMode] = useState<EditorMode>('form');+ const [form, setForm] = useState<EnvironmentFormValues>(() => manifestToFormValues(defaultEnvironmentManifest()));+ const [yamlText, setYamlText] = useState(() => manifestToYaml(defaultEnvironmentManifest()));+ const [baselineForm, setBaselineForm] = useState(form);+ const [baselineYaml, setBaselineYaml] = useState(yamlText);+ const [pendingSwitch, setPendingSwitch] = useState<EditorMode | null>(null);+ const [saving, setSaving] = useState(false);+ const [error, setError] = useState<string | null>(null);++ useEffect(() => {+ if (!open) {+ setEditorMode('form');+ setError(null);+ setPendingSwitch(null);+ setSaving(false);+ return;+ }+ const manifest = mode === 'edit' && environment != null ? environment.manifest : defaultEnvironmentManifest();+ const nextForm = manifestToFormValues(manifest);+ const nextYaml = manifestToYaml(manifest);+ setForm(nextForm);+ setYamlText(nextYaml);+ setBaselineForm(nextForm);+ setBaselineYaml(nextYaml);+ setEditorMode('form');+ setError(null);+ setPendingSwitch(null);+ }, [open, mode, environment]);++ const formDirty = useMemo(() => JSON.stringify(form) !== JSON.stringify(baselineForm), [baselineForm, form]);+ const yamlDirty = yamlText !== baselineYaml;+ const dirty = editorMode === 'form' ? formDirty : yamlDirty;++ const requestSwitch = (next: EditorMode) => {+ if (next === editorMode) return;+ if (dirty) {+ setPendingSwitch(next);+ return;+ }+ applySwitch(next);+ };++ const applySwitch = (next: EditorMode) => {+ if (next === 'yaml') {+ const manifest = formValuesToManifest(form);+ const nextYaml = manifestToYaml(manifest);+ setYamlText(nextYaml);+ setBaselineYaml(nextYaml);+ setBaselineForm(form);+ } else {+ const parsed = parseManifestYaml(yamlText);+ if ('error' in parsed) {+ setError(parsed.error);+ setPendingSwitch(null);+ return;+ }+ const nextForm = manifestToFormValues(parsed.manifest);+ setForm(nextForm);+ setBaselineForm(nextForm);+ setBaselineYaml(yamlText);+ }+ setEditorMode(next);+ setPendingSwitch(null);+ setError(null);+ };++ const handleSave = async (event: FormEvent) => {+ event.preventDefault();+ setError(null);+ let manifest: SandboxEnvironmentManifest;+ if (editorMode === 'form') {+ const validationError = validateEnvironmentForm(form);+ if (validationError != null) {+ setError(validationError);+ return;+ }+ manifest = formValuesToManifest(form);+ } else {+ const parsed = parseManifestYaml(yamlText);+ if ('error' in parsed) {+ setError(parsed.error);+ return;+ }+ manifest = parsed.manifest;+ }++ setSaving(true);+ try {+ await environmentServer.createOrUpdateEnvironment({ manifest });+ toaster?.showSuccess({+ title: mode === 'create' ? 'Environment created' : 'Environment updated',+ });+ onSaved?.();+ onOpenChange(false);+ } catch (caught) {+ setError(getErrorMessage(caught, 'Failed to save environment'));+ } finally {+ setSaving(false);+ }+ };++ const title = mode === 'create' ? 'New environment' : (environment?.name ?? 'Edit environment');++ return (+ <>+ <SideDrawer+ open={open}+ onOpenChange={onOpenChange}+ title={title}+ description="Configure the environment as a form or edit its manifest directly."+ size="xl"+ headerActions={+ <div className="inline-flex shrink-0 rounded-md bg-secondary-bg p-0.5 border border-border">+ <button+ type="button"+ className={cn(+ 'rounded-sm px-2.5 py-1 text-xs font-medium transition-colors',+ editorMode === 'form'+ ? 'bg-primary-bg text-text-primary shadow-xs'+ : 'text-text-secondary hover:text-text-primary',+ )}+ onClick={() => requestSwitch('form')}+ >+ UI Form+ </button>+ <button+ type="button"+ className={cn(+ 'rounded-sm px-2.5 py-1 text-xs font-medium transition-colors',+ editorMode === 'yaml'+ ? 'bg-primary-bg text-text-primary shadow-xs'+ : 'text-text-secondary hover:text-text-primary',+ )}+ onClick={() => requestSwitch('yaml')}+ >+ YAML+ </button>+ </div>+ }+ footer={+ <div className="flex justify-end gap-2">+ <Button.Secondary type="button" disabled={saving} onClick={() => onOpenChange(false)}>+ Cancel+ </Button.Secondary>+ <Button.Primary type="submit" form="environment-form" disabled={saving}>+ {saving ? 'Saving…' : mode === 'create' ? 'Create' : 'Save'}+ </Button.Primary>+ </div>+ }+ >+ <form+ id="environment-form"+ className={cn(+ 'flex min-h-0 flex-1 flex-col gap-4 px-5 pt-4',+ editorMode === 'form' ? 'pb-10' : 'h-full pb-4',+ )}+ onSubmit={event => void handleSave(event)}+ >+ {error != null ? <p className="text-sm text-failure-bg">{error}</p> : null}++ {editorMode === 'form' ? (+ <EnvironmentFormFields values={form} onChange={setForm} nameDisabled={mode === 'edit'} />+ ) : (+ <div className="flex min-h-[30rem] flex-1 flex-col">+ <CodeEditor+ language="yaml"+ value={yamlText}+ height="100%"+ showToolbar={false}+ defaultShowLineNumbers+ className="flex-1"+ onChange={value => setYamlText(value)}+ />+ </div>+ )}+ </form>+ </SideDrawer>++ <Dialog open={pendingSwitch != null} onOpenChange={openDialog => !openDialog && setPendingSwitch(null)}>+ <DialogContent>+ <DialogHeader>+ <DialogTitle>Warning</DialogTitle>+ </DialogHeader>+ <p className="text-sm text-text-secondary">+ {pendingSwitch === 'form'+ ? 'The YAML changes will be lost. Are you sure you want to switch to UI form?'+ : 'You might lose all your changes from the form. Are you sure you want to switch to YAML Editor?'}+ </p>+ <DialogFooter>+ <Button.Secondary type="button" onClick={() => setPendingSwitch(null)}>+ Cancel+ </Button.Secondary>+ <Button.Primary+ type="button"+ onClick={() => {+ if (pendingSwitch != null) applySwitch(pendingSwitch);+ }}+ >+ Yes+ </Button.Primary>+ </DialogFooter>+ </DialogContent>+ </Dialog>+ </>+ );+}diff --git a/packages/trueforge-ui/src/atoms/environments/EnvironmentFormFields.tsx b/packages/trueforge-ui/src/atoms/environments/EnvironmentFormFields.tsxnew file mode 100644index 000000000..0f5b32f8a--- /dev/null+++ b/packages/trueforge-ui/src/atoms/environments/EnvironmentFormFields.tsx@@ -0,0 +1,343 @@+'use client';++import { Icon } from '../../icons/Icon.js';+import type { SandboxEnvironmentManifest, SandboxEnvironmentSecret } from '../../server/types.js';+import { auiButtonClass } from '../lib/buttonClasses.js';+import { cn } from '../lib/cn.js';+import { Switch } from '../primitives/Switch.js';+import { isReservedEnvironmentName } from './environmentDisplay.js';++export type EnvironmentFormValues = {+ name: string;+ description: string;+ buildScript: string;+ cpu: string;+ memory: string;+ disk: string;+ networkBlockAll: boolean;+ domainAllowList: string;+ secrets: SandboxEnvironmentSecret[];+ environmentVariables: Array<{ key: string; value: string }>;+};++export function manifestToFormValues(manifest: SandboxEnvironmentManifest): EnvironmentFormValues {+ return {+ name: manifest.name,+ description: manifest.description ?? '',+ buildScript: manifest.image?.buildScript ?? '',+ cpu: String(manifest.resources?.cpu ?? 1),+ memory: String(manifest.resources?.memory ?? 1),+ disk: String(manifest.resources?.disk ?? 3),+ networkBlockAll: manifest.networking?.networkBlockAll === true,+ domainAllowList: manifest.networking?.domainAllowList ?? '',+ secrets: manifest.networking?.secrets?.map(secret => ({ ...secret, hosts: [...secret.hosts] })) ?? [],+ environmentVariables: Object.entries(manifest.environmentVariables ?? {}).map(([key, value]) => ({+ key,+ value,+ })),+ };+}++export function formValuesToManifest(values: EnvironmentFormValues): SandboxEnvironmentManifest {+ const cpu = Number(values.cpu);+ const memory = Number(values.memory);+ const disk = Number(values.disk);+ const environmentVariables = Object.fromEntries(+ values.environmentVariables+ .map(row => [row.key.trim(), row.value] as const)+ .filter(([key, value]) => key.length > 0 && value.length > 0),+ );+ const secrets = values.networkBlockAll+ ? undefined+ : values.secrets+ .map(secret => ({+ env: secret.env.trim(),+ value: secret.value,+ hosts: secret.hosts.map(host => host.trim()).filter(host => host.length > 0),+ }))+ .filter(secret => secret.env.length > 0 && secret.value.length > 0);++ return {+ name: values.name.trim(),+ ...(values.description.trim().length === 0 ? {} : { description: values.description.trim() }),+ ...(values.buildScript.trim().length === 0 ? {} : { image: { type: 'build', buildScript: values.buildScript } }),+ resources: {+ cpu: Number.isFinite(cpu) && cpu > 0 ? cpu : 1,+ memory: Number.isFinite(memory) && memory > 0 ? memory : 1,+ disk: Number.isFinite(disk) && disk > 0 ? disk : 3,+ },+ ...(Object.keys(environmentVariables).length === 0 ? {} : { environmentVariables }),+ networking: values.networkBlockAll+ ? { networkBlockAll: true }+ : {+ networkBlockAll: false,+ ...(values.domainAllowList.trim().length === 0 ? {} : { domainAllowList: values.domainAllowList.trim() }),+ ...(secrets == null || secrets.length === 0 ? {} : { secrets }),+ },+ };+}++export function validateEnvironmentForm(values: EnvironmentFormValues): string | null {+ const name = values.name.trim();+ if (name.length === 0) return 'Name is required';+ if (isReservedEnvironmentName(name)) return 'Name "default" is reserved';+ const cpu = Number(values.cpu);+ const memory = Number(values.memory);+ const disk = Number(values.disk);+ if (!Number.isFinite(cpu) || cpu <= 0) return 'CPU must be a positive number';+ if (!Number.isFinite(memory) || memory <= 0) return 'Memory must be a positive number';+ if (!Number.isFinite(disk) || disk <= 0) return 'Disk must be a positive number';+ if (!values.networkBlockAll) {+ for (const secret of values.secrets) {+ if (secret.env.trim().length === 0) continue;+ if (secret.value.trim().length === 0) return 'Secret value is required';+ }+ }+ return null;+}++const fieldClassName =+ 'w-full rounded-md border border-border bg-input-box-bg px-2.5 py-1.5 text-sm text-text-primary placeholder:text-text-secondary/70 outline-none focus:border-primary-button-bg';+const labelClassName = 'text-sm font-medium text-text-primary';+const sectionCardClassName = 'rounded-lg border border-border p-4 flex flex-col gap-4';++export function EnvironmentFormFields({+ values,+ onChange,+ nameDisabled,+}: {+ values: EnvironmentFormValues;+ onChange: (next: EnvironmentFormValues) => void;+ nameDisabled?: boolean;+}) {+ const update = (patch: Partial<EnvironmentFormValues>) => onChange({ ...values, ...patch });++ return (+ <div className="flex flex-col gap-4 pb-8">+ {/* Name */}+ <label className="flex flex-col gap-1.5">+ <span className={labelClassName}>Name</span>+ <input+ className={cn(fieldClassName, nameDisabled && 'opacity-70')}+ value={values.name}+ disabled={nameDisabled}+ placeholder="my-environment"+ onChange={event => update({ name: event.target.value })}+ />+ </label>++ {/* Description */}+ <label className="flex flex-col gap-1.5">+ <span className={labelClassName}>Description</span>+ <textarea+ className={cn(fieldClassName, 'min-h-20 resize-y')}+ value={values.description}+ placeholder="write description ..."+ onChange={event => update({ description: event.target.value })}+ />+ </label>++ {/* Image And Resources Card */}+ <div className={sectionCardClassName}>+ <h3 className="text-sm font-medium text-text-primary">Image And Resources</h3>++ <label className="flex flex-col gap-1.5">+ <span className="text-xs font-medium text-text-secondary">+ Build Script ({values.buildScript.length}/5120)+ </span>+ <textarea+ className={cn(fieldClassName, 'min-h-24 resize-y font-mono text-xs')}+ value={values.buildScript}+ placeholder={'set -ex\npip install httpx\n'}+ onChange={event => update({ buildScript: event.target.value })}+ />+ </label>++ <div className="grid grid-cols-3 gap-3">+ <label className="flex flex-col gap-1">+ <span className="text-xs font-medium text-text-secondary">CPU</span>+ <input+ className={fieldClassName}+ type="number"+ min={0.1}+ step="any"+ value={values.cpu}+ placeholder="type..."+ onChange={event => update({ cpu: event.target.value })}+ />+ </label>+ <label className="flex flex-col gap-1">+ <span className="text-xs font-medium text-text-secondary">Memory (GB)</span>+ <input+ className={fieldClassName}+ type="number"+ min={0.1}+ step="any"+ value={values.memory}+ placeholder="type..."+ onChange={event => update({ memory: event.target.value })}+ />+ </label>+ <label className="flex flex-col gap-1">+ <span className="text-xs font-medium text-text-secondary">Disk (GB)</span>+ <input+ className={fieldClassName}+ type="number"+ min={0.1}+ step="any"+ value={values.disk}+ placeholder="type..."+ onChange={event => update({ disk: event.target.value })}+ />+ </label>+ </div>+ </div>++ {/* Environment Variables Card */}+ <div className={sectionCardClassName}>+ <div className="flex items-center justify-between">+ <h3 className="text-sm font-medium text-text-primary">Environment Variables</h3>+ <button+ type="button"+ className="cursor-pointer text-xs font-medium text-text-secondary transition-colors hover:text-text-primary"+ onClick={() => update({ environmentVariables: [...values.environmentVariables, { key: '', value: '' }] })}+ >+ + Add Variables+ </button>+ </div>+ {values.environmentVariables.map((row, index) => (+ <div key={index} className="flex items-center gap-2">+ <div className="flex min-w-0 flex-1 items-center gap-2">+ <input+ className={fieldClassName}+ value={row.key}+ placeholder="KEY"+ onChange={event => {+ const environmentVariables = values.environmentVariables.map((item, i) =>+ i === index ? { ...item, key: event.target.value } : item,+ );+ update({ environmentVariables });+ }}+ />+ <input+ className={fieldClassName}+ value={row.value}+ placeholder="value"+ onChange={event => {+ const environmentVariables = values.environmentVariables.map((item, i) =>+ i === index ? { ...item, value: event.target.value } : item,+ );+ update({ environmentVariables });+ }}+ />+ </div>+ <button+ type="button"+ className={auiButtonClass({ variant: 'ghost', size: 'icon' })}+ aria-label="Remove environment variable"+ onClick={() =>+ update({ environmentVariables: values.environmentVariables.filter((_, i) => i !== index) })+ }+ >+ <Icon name="trash" className="size-3.5 text-failure-bg" />+ </button>+ </div>+ ))}+ </div>++ {/* Networking Card */}+ <div className={sectionCardClassName}>+ <div className="flex items-center justify-between gap-4">+ <div className="flex flex-col">+ <span className="text-sm font-medium text-text-primary">Block All Network</span>+ <span className="text-xs text-text-secondary">Overrides the domain allow list</span>+ </div>+ <Switch+ checked={values.networkBlockAll}+ onCheckedChange={checked => update({ networkBlockAll: checked })}+ aria-label="Block All Network"+ />+ </div>+ {!values.networkBlockAll ? (+ <label className="flex flex-col gap-1.5 pt-1">+ <span className="text-xs font-medium text-text-secondary">Domain Allow List</span>+ <input+ className={fieldClassName}+ value={values.domainAllowList}+ placeholder="api.github.com,api.openai.com"+ onChange={event => update({ domainAllowList: event.target.value })}+ />+ </label>+ ) : null}+ </div>++ {/* Secrets Card */}+ {!values.networkBlockAll ? (+ <div className={sectionCardClassName}>+ <div className="flex items-center justify-between">+ <div className="flex flex-col">+ <h3 className="text-sm font-medium text-text-primary">Secrets</h3>+ <span className="text-xs text-text-secondary">Synced immediately with existing sandboxes</span>+ </div>+ <button+ type="button"+ className="cursor-pointer text-xs font-medium text-text-secondary transition-colors hover:text-text-primary"+ onClick={() => update({ secrets: [...values.secrets, { env: '', value: '', hosts: [] }] })}+ >+ + Add Secret+ </button>+ </div>+ {values.secrets.map((secret, index) => (+ <div key={index} className="flex flex-col gap-2 rounded-md border border-border p-3">+ <div className="flex items-center gap-2">+ <div className="flex min-w-0 flex-1 items-center gap-2">+ <input+ className={fieldClassName}+ value={secret.env}+ placeholder="ENV_NAME"+ onChange={event => {+ const secrets = values.secrets.map((row, i) =>+ i === index ? { ...row, env: event.target.value } : row,+ );+ update({ secrets });+ }}+ />+ <input+ className={fieldClassName}+ type="password"+ value={secret.value}+ placeholder="value"+ onChange={event => {+ const secrets = values.secrets.map((row, i) =>+ i === index ? { ...row, value: event.target.value } : row,+ );+ update({ secrets });+ }}+ />+ </div>+ <button+ type="button"+ className={auiButtonClass({ variant: 'ghost', size: 'icon' })}+ aria-label="Remove secret"+ onClick={() => update({ secrets: values.secrets.filter((_, i) => i !== index) })}+ >+ <Icon name="trash" className="size-3.5 text-failure-bg" />+ </button>+ </div>+ <input+ className={fieldClassName}+ value={secret.hosts.join(',')}+ placeholder="Allowed hosts (comma-separated)"+ onChange={event => {+ const hosts = event.target.value.split(',').map(part => part.trim());+ const secrets = values.secrets.map((row, i) => (i === index ? { ...row, hosts } : row));+ update({ secrets });+ }}+ />+ </div>+ ))}+ </div>+ ) : null}+ </div>+ );+}diff --git a/packages/trueforge-ui/src/atoms/environments/EnvironmentStatusBadge.tsx b/packages/trueforge-ui/src/atoms/environments/EnvironmentStatusBadge.tsxnew file mode 100644index 000000000..34bc95e8e--- /dev/null+++ b/packages/trueforge-ui/src/atoms/environments/EnvironmentStatusBadge.tsx@@ -0,0 +1,29 @@+import type { SandboxEnvironmentStatus } from '../../server/types.js';+import { Badge, type BadgeVariant } from '../primitives/Badge.js';+import { Tooltip } from '../primitives/Tooltip.js';++const STATUS_CONFIG: Record<SandboxEnvironmentStatus, { label: string; variant: BadgeVariant }> = {+ pending: { label: 'Pending', variant: 'info' },+ ready: { label: 'Ready', variant: 'success' },+ failed: { label: 'Failed', variant: 'destructive' },+};++export function EnvironmentStatusBadge({+ status,+ statusReason,+}: {+ status: SandboxEnvironmentStatus;+ statusReason?: string | null;+}) {+ const config = STATUS_CONFIG[status];+ const badge = (+ <Badge variant={config.variant} shape="rounded" size="sm">+ {config.label}+ </Badge>+ );++ if (status === 'failed' && statusReason != null && statusReason.length > 0) {+ return <Tooltip content={statusReason}>{badge}</Tooltip>;+ }+ return badge;+}diff --git a/packages/trueforge-ui/src/atoms/environments/EnvironmentsPage.tsx b/packages/trueforge-ui/src/atoms/environments/EnvironmentsPage.tsxnew file mode 100644index 000000000..c82c09c92--- /dev/null+++ b/packages/trueforge-ui/src/atoms/environments/EnvironmentsPage.tsx@@ -0,0 +1,411 @@+'use client';++import { useCallback, useEffect, useMemo, useRef, useState, type ComponentType } from 'react';++import { useToasterOptional } from '../../containers/ToasterContainer.js';+import { Icon } from '../../icons/Icon.js';+import { useOptionalCatalogServer, useSandboxEnvironmentServer } from '../../server/ServerContext.js';+import { useOptionalShellMode } from '../../server/ShellModeContext.js';+import type { SandboxEnvironment } from '../../server/types.js';+import {+ ENVIRONMENT_SHARE_CHANGE_EVENT,+ readEnvironmentShareSearch,+ replaceEnvironmentShareSearch,+} from '../../utils/environmentShareUrl.js';+import { getErrorMessage } from '../../utils/getErrorMessage.js';+import { EmptyScreen, EmptyScreenQueryHighlight } from '../EmptyScreen.js';+import { auiButtonClass } from '../lib/buttonClasses.js';+import { formatRelativeTime } from '../lib/dateFormat.js';+import { PageHeader } from '../PageHeader.js';+import { Button } from '../primitives/Button.js';+import { Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle } from '../primitives/Dialog.js';+import SearchInput from '../primitives/SearchInput.js';+import { Skeleton } from '../primitives/Skeleton.js';+import {+ DEFAULT_TABLE_PAGE_SIZE,+ Table,+ TableBody,+ TableCell,+ TableHead,+ TableHeader,+ TableRow,+ TableTokenPagination,+} from '../primitives/Table.js';+import { Tooltip } from '../primitives/Tooltip.js';+import { formatNetworkingSummary, formatResourcesSummary, isEnvironmentReadOnly } from './environmentDisplay.js';+import { EnvironmentFormDrawer } from './EnvironmentFormDrawer.js';+import { EnvironmentStatusBadge } from './EnvironmentStatusBadge.js';++type DrawerState = { kind: 'closed' } | { kind: 'create' } | { kind: 'edit'; environment: SandboxEnvironment };++const ENVIRONMENTS_PAGE_SIZE_OPTIONS = [10, 25] as const;+export const PENDING_ENVIRONMENTS_POLL_INTERVAL_MS = 10_000;++function clampPageSize(size: number): number {+ return Math.min(Math.max(size, 1), 25);+}++function initialDrawerState(): DrawerState {+ return readEnvironmentShareSearch(window.location.search).isNew ? { kind: 'create' } : { kind: 'closed' };+}++export type EnvironmentsPageProps = Record<string, never>;++export function EnvironmentsPage(_props: EnvironmentsPageProps) {+ const environmentServer = useSandboxEnvironmentServer();+ const catalog = useOptionalCatalogServer();+ const shell = useOptionalShellMode();+ const toaster = useToasterOptional();++ const [environments, setEnvironments] = useState<SandboxEnvironment[]>([]);+ const [loading, setLoading] = useState(true);+ const [providerReady, setProviderReady] = useState<boolean | null>(null);+ const [error, setError] = useState<string | null>(null);+ const [nameQuery, setNameQuery] = useState(() => readEnvironmentShareSearch(window.location.search).q ?? '');+ const [drawer, setDrawer] = useState<DrawerState>(() => initialDrawerState());+ const [pendingDelete, setPendingDelete] = useState<SandboxEnvironment | null>(null);+ const [deleting, setDeleting] = useState(false);+ const [pageSize, setPageSize] = useState(() => clampPageSize(DEFAULT_TABLE_PAGE_SIZE));+ const [pageToken, setPageToken] = useState<string | undefined>(undefined);+ const [nextPageToken, setNextPageToken] = useState<string | undefined>(undefined);+ const [previousPageToken, setPreviousPageToken] = useState<string | undefined>(undefined);+ const loadGenRef = useRef(0);+ const didConsumeIsNewRef = useRef(false);+ const wasSettingsOpenRef = useRef(shell?.settingsOpen ?? false);+ const settingsOpen = shell?.settingsOpen ?? false;++ const checkProvider = useCallback(async () => {+ const sandboxCatalog = catalog?.sandboxCatalog;+ if (sandboxCatalog == null) {+ setProviderReady(false);+ return false;+ }+ try {+ const providers = await sandboxCatalog.listSandboxProviders();+ const ready = providers.length > 0;+ setProviderReady(ready);+ return ready;+ } catch (caught) {+ setProviderReady(null);+ throw caught;+ }+ }, [catalog]);++ const loadEnvironments = useCallback(+ async ({ token, size, silent = false }: { token: string | undefined; size: number; silent?: boolean }) => {+ const gen = ++loadGenRef.current;+ if (!silent) {+ setLoading(true);+ setError(null);+ }+ try {+ const ready = await checkProvider();+ if (!ready) {+ if (gen !== loadGenRef.current) return;+ setEnvironments([]);+ setNextPageToken(undefined);+ setPreviousPageToken(undefined);+ return;+ }+ const page = await environmentServer.listEnvironments({+ limit: clampPageSize(size),+ ...(token === undefined || token === '' ? {} : { pageToken: token }),+ });+ if (gen !== loadGenRef.current) return;+ setEnvironments(page.data);+ setNextPageToken(page.nextPageToken);+ setPreviousPageToken(page.previousPageToken);+ } catch (caught) {+ if (gen !== loadGenRef.current) return;+ if (!silent) {+ setError(getErrorMessage(caught, 'Failed to load environments'));+ setEnvironments([]);+ setNextPageToken(undefined);+ setPreviousPageToken(undefined);+ }+ } finally {+ if (gen === loadGenRef.current && !silent) setLoading(false);+ }+ },+ [checkProvider, environmentServer],+ );++ useEffect(() => {+ replaceEnvironmentShareSearch({+ q: nameQuery.trim().length === 0 ? null : nameQuery,+ });+ }, [nameQuery]);++ useEffect(() => {+ void loadEnvironments({ token: pageToken, size: pageSize });+ }, [loadEnvironments, pageSize, pageToken]);++ useEffect(() => {+ if (wasSettingsOpenRef.current && !settingsOpen) {+ void loadEnvironments({ token: pageToken, size: pageSize });+ }+ wasSettingsOpenRef.current = settingsOpen;+ }, [settingsOpen, loadEnvironments, pageToken, pageSize]);++ // Poll individual pending environments using single-environment get API+ useEffect(() => {+ const pendingEnvs = environments.filter(env => env.status === 'pending');+ if (pendingEnvs.length === 0) return;++ const intervalId = window.setInterval(async () => {+ try {+ const updates = await Promise.all(+ pendingEnvs.map(env => environmentServer.getEnvironment({ name: env.name }).catch(() => null)),+ );+ const resolved = updates.filter((u): u is SandboxEnvironment => u != null);+ if (resolved.length === 0) return;++ setEnvironments(prev =>+ prev.map(item => {+ const updated = resolved.find(u => u.name === item.name);+ return updated ?? item;+ }),+ );+ // Pending envs becoming ready (or failed) must refresh still-mounted pickers.+ if (resolved.some(u => u.status !== 'pending')) {+ shell?.invalidateEnvironmentsList();+ }+ } catch {+ // Silently preserve current list on network error+ }+ }, PENDING_ENVIRONMENTS_POLL_INTERVAL_MS);++ return () => window.clearInterval(intervalId);+ }, [environments, environmentServer, shell]);++ useEffect(() => {+ if (didConsumeIsNewRef.current) return;+ if (!readEnvironmentShareSearch(window.location.search).isNew) return;+ didConsumeIsNewRef.current = true;+ setDrawer({ kind: 'create' });+ replaceEnvironmentShareSearch({ isNew: null });+ }, []);++ useEffect(() => {+ const onShareChange = () => {+ const share = readEnvironmentShareSearch(window.location.search);+ setNameQuery(share.q ?? '');+ if (share.isNew) setDrawer({ kind: 'create' });+ };+ window.addEventListener(ENVIRONMENT_SHARE_CHANGE_EVENT, onShareChange);+ return () => window.removeEventListener(ENVIRONMENT_SHARE_CHANGE_EVENT, onShareChange);+ }, []);++ const filtered = useMemo(() => {+ const q = nameQuery.trim().toLowerCase();+ if (q.length === 0) return environments;+ return environments.filter(env => env.name.toLowerCase().includes(q) || env.description.toLowerCase().includes(q));+ }, [environments, nameQuery]);++ const hasPageNav = nextPageToken != null || previousPageToken != null || environments.length > 0;++ const openCreate = () => {+ if (providerReady !== true) return;+ setDrawer({ kind: 'create' });+ };++ const handleDelete = async () => {+ if (pendingDelete == null) return;+ setDeleting(true);+ try {+ await environmentServer.deleteEnvironment({ name: pendingDelete.name });+ toaster?.showSuccess({ title: 'Environment deleted' });+ setPendingDelete(null);+ setPageToken(undefined);+ shell?.invalidateEnvironmentsList();+ void loadEnvironments({ token: undefined, size: pageSize });+ } catch (caught) {+ toaster?.showError(caught);+ } finally {+ setDeleting(false);+ }+ };++ return (+ <div className="flex h-full min-h-0 flex-col bg-primary-bg">+ <PageHeader+ title="Environments"+ end={+ <>+ <div className="w-64">+ <SearchInput query={nameQuery} setQuery={setNameQuery} placeholder="Search environments by name" />+ </div>+ <Button.Primary type="button" disabled={providerReady !== true} onClick={openCreate}>+ <Icon name="plus" className="size-3.5" />+ New Environment+ </Button.Primary>+ </>+ }+ />++ <div className="min-h-0 flex-1 overflow-auto px-4 py-4">+ {error != null ? (+ <p className="text-failure-bg px-3 py-8 text-center text-sm">{error}</p>+ ) : loading || providerReady == null ? (+ <div className="flex flex-col gap-2" role="status" aria-label="Loading environments">+ {Array.from({ length: 5 }, (_, i) => (+ <Skeleton key={i} className="h-12 w-full rounded-md" />+ ))}+ </div>+ ) : providerReady === false ? (+ <div className="flex min-h-full flex-col items-center justify-center gap-4">+ <EmptyScreen+ title="Configure a sandbox provider first"+ description="Sandbox environments require a Daytona sandbox provider. Add one in Settings → Sandbox."+ className="min-h-0 flex-none py-0"+ />+ <Button.Primary type="button" onClick={() => shell?.setSettingsOpen(true, 'sandbox')}>+ Open Sandbox settings+ </Button.Primary>+ </div>+ ) : environments.length === 0 ? (+ <EmptyScreen+ title="No environments yet"+ description="Create an environment to customize sandbox images, resources, and networking."+ className="min-h-full"+ />+ ) : filtered.length === 0 ? (+ <EmptyScreen+ title="No environments found"+ description={+ <>+ No environments match <EmptyScreenQueryHighlight>{nameQuery.trim()}</EmptyScreenQueryHighlight>.+ </>+ }+ className="min-h-full"+ />+ ) : (+ <div className="overflow-hidden rounded-lg border border-border">+ <Table className="min-w-240">+ <TableHeader>+ <TableRow className="hover:bg-transparent">+ <TableHead className="w-96 max-w-96">Name</TableHead>+ <TableHead>Build Status</TableHead>+ <TableHead>Resources</TableHead>+ <TableHead>Networking</TableHead>+ <TableHead>Updated</TableHead>+ <TableHead className="w-16" />+ </TableRow>+ </TableHeader>+ <TableBody>+ {filtered.map(env => {+ const readOnly = isEnvironmentReadOnly(env);+ return (+ <TableRow+ key={env.id}+ className={readOnly ? undefined : 'cursor-pointer'}+ onClick={() => {+ if (!readOnly) setDrawer({ kind: 'edit', environment: env });+ }}+ >+ <TableCell className="w-96 max-w-96">+ <div className="flex flex-col gap-0.5">+ <span className="truncate font-medium text-text-primary">{env.name}</span>+ {env.description.length > 0 ? (+ <Tooltip+ content={env.description}+ className="max-w-sm whitespace-normal text-left"+ triggerClassName="block min-w-0 w-full max-w-full"+ >+ <span className="block truncate text-xs text-text-secondary">{env.description}</span>+ </Tooltip>+ ) : null}+ </div>+ </TableCell>+ <TableCell>+ <EnvironmentStatusBadge status={env.status} statusReason={env.statusReason} />+ </TableCell>+ <TableCell className="text-sm text-text-secondary">+ {formatResourcesSummary(env.manifest.resources)}+ </TableCell>+ <TableCell className="text-sm text-text-secondary">+ {formatNetworkingSummary(env.manifest.networking)}+ </TableCell>+ <TableCell className="text-sm text-text-secondary">{formatRelativeTime(env.updatedAt)}</TableCell>+ <TableCell>+ {!readOnly ? (+ <button+ type="button"+ className={auiButtonClass({ variant: 'ghost', size: 'icon' })}+ aria-label={`Delete ${env.name}`}+ onClick={event => {+ event.stopPropagation();+ setPendingDelete(env);+ }}+ >+ <Icon name="trash" className="size-3.5 text-failure-bg" />+ </button>+ ) : null}+ </TableCell>+ </TableRow>+ );+ })}+ </TableBody>+ </Table>+ {hasPageNav ? (+ <TableTokenPagination+ pageSize={pageSize}+ rowCount={filtered.length}+ canPrev={previousPageToken != null}+ canNext={nextPageToken != null}+ onPrev={() => setPageToken(previousPageToken)}+ onNext={() => setPageToken(nextPageToken)}+ pageSizeOptions={ENVIRONMENTS_PAGE_SIZE_OPTIONS}+ onPageSizeChange={size => {+ setPageSize(clampPageSize(size));+ setPageToken(undefined);+ setPreviousPageToken(undefined);+ }}+ />+ ) : null}+ </div>+ )}+ </div>++ <EnvironmentFormDrawer+ open={drawer.kind !== 'closed'}+ mode={drawer.kind === 'edit' ? 'edit' : 'create'}+ {...(drawer.kind === 'edit' ? { environment: drawer.environment } : {})}+ onOpenChange={open => {+ if (!open) setDrawer({ kind: 'closed' });+ }}+ onSaved={() => {+ setPageToken(undefined);+ shell?.invalidateEnvironmentsList();+ void loadEnvironments({ token: undefined, size: pageSize });+ }}+ />++ <Dialog open={pendingDelete != null} onOpenChange={open => !open && setPendingDelete(null)}>+ <DialogContent>+ <DialogHeader>+ <DialogTitle>Delete environment</DialogTitle>+ </DialogHeader>+ <p className="text-sm text-text-secondary">+ Delete <span className="font-medium text-text-primary">{pendingDelete?.name}</span>? This cannot be undone.+ Delete fails if any agent still references the environment.+ </p>+ <DialogFooter>+ <Button.Secondary type="button" disabled={deleting} onClick={() => setPendingDelete(null)}>+ Cancel+ </Button.Secondary>+ <Button.Primary type="button" disabled={deleting} onClick={() => void handleDelete()}>+ {deleting ? 'Deleting…' : 'Delete'}+ </Button.Primary>+ </DialogFooter>+ </DialogContent>+ </Dialog>+ </div>+ );+}++declare module '../../theme/SlotsProvider.js' {+ interface AtomSlots {+ EnvironmentsPage: ComponentType<EnvironmentsPageProps>;+ }+}diff --git a/packages/trueforge-ui/src/atoms/environments/environmentDisplay.ts b/packages/trueforge-ui/src/atoms/environments/environmentDisplay.tsnew file mode 100644index 000000000..1b8e958ff--- /dev/null+++ b/packages/trueforge-ui/src/atoms/environments/environmentDisplay.ts@@ -0,0 +1,44 @@+import type {+ SandboxEnvironment,+ SandboxEnvironmentManifest,+ SandboxEnvironmentNetworking,+} from '../../server/types.js';++export const RESERVED_ENVIRONMENT_NAME = 'default';++export function isReservedEnvironmentName(name: string): boolean {+ return name.trim() === RESERVED_ENVIRONMENT_NAME;+}++export function isEnvironmentReadOnly(env: Pick<SandboxEnvironment, 'name'>): boolean {+ return isReservedEnvironmentName(env.name);+}++export function formatResourcesSummary(resources: SandboxEnvironmentManifest['resources']): string {+ const cpu = resources?.cpu ?? 1;+ const memory = resources?.memory ?? 1;+ const disk = resources?.disk ?? 3;+ return `${String(cpu)} vCPU · ${String(memory)} GB RAM · ${String(disk)} GB disk`;+}++export function formatNetworkingSummary(networking: SandboxEnvironmentNetworking | undefined): string {+ if (networking?.networkBlockAll === true) return 'Blocked';+ const allowList = networking?.domainAllowList?.trim() ?? '';+ if (allowList.length === 0) return 'Unrestricted';+ const count = allowList+ .split(',')+ .map(part => part.trim())+ .filter(part => part.length > 0).length;+ if (count === 0) return 'Unrestricted';+ return `${String(count)} allowed domain${count === 1 ? '' : 's'}`;+}++export function defaultEnvironmentManifest(): SandboxEnvironmentManifest {+ return {+ name: '',+ description: '',+ image: { type: 'build', buildScript: '' },+ resources: { cpu: 1, memory: 1, disk: 3 },+ networking: { networkBlockAll: false },+ };+}diff --git a/packages/trueforge-ui/src/atoms/environments/environmentYaml.ts b/packages/trueforge-ui/src/atoms/environments/environmentYaml.tsnew file mode 100644index 000000000..b66d7503d--- /dev/null+++ b/packages/trueforge-ui/src/atoms/environments/environmentYaml.ts@@ -0,0 +1,36 @@+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';++import type { SandboxEnvironmentManifest } from '../../server/types.js';+import { getErrorMessage } from '../../utils/getErrorMessage.js';+import { isReservedEnvironmentName } from './environmentDisplay.js';++export function manifestToYaml(manifest: SandboxEnvironmentManifest): string {+ return stringifyYaml(manifest, { lineWidth: 0 });+}++function isSandboxEnvironmentManifest(value: unknown): value is SandboxEnvironmentManifest {+ if (value == null || typeof value !== 'object' || Array.isArray(value)) return false;+ if (!('name' in value) || typeof value.name !== 'string' || value.name.trim().length === 0) {+ return false;+ }+ return true;+}++export function parseManifestYaml(text: string): { manifest: SandboxEnvironmentManifest } | { error: string } {+ let parsed: unknown;+ try {+ parsed = parseYaml(text);+ } catch (caught) {+ return { error: getErrorMessage(caught, 'Invalid YAML') };+ }+ if (!isSandboxEnvironmentManifest(parsed)) {+ if (parsed == null || typeof parsed !== 'object' || Array.isArray(parsed)) {+ return { error: 'YAML must be an object manifest' };+ }+ return { error: 'Manifest name is required' };+ }+ if (isReservedEnvironmentName(parsed.name)) {+ return { error: 'Name "default" is reserved' };+ }+ return { manifest: parsed };+}diff --git a/packages/trueforge-ui/src/atoms/environments/useReadySandboxEnvironments.ts b/packages/trueforge-ui/src/atoms/environments/useReadySandboxEnvironments.tsnew file mode 100644index 000000000..caa2ec80c--- /dev/null+++ b/packages/trueforge-ui/src/atoms/environments/useReadySandboxEnvironments.ts@@ -0,0 +1,84 @@+'use client';++import { useCallback, useEffect, useRef, useState } from 'react';++import { useOptionalSandboxEnvironmentServer } from '../../server/ServerContext.js';+import { useOptionalShellMode } from '../../server/ShellModeContext.js';+import type { SandboxEnvironment } from '../../server/types.js';+import { drainListPages } from '../../utils/drainListPages.js';+import { getErrorMessage } from '../../utils/getErrorMessage.js';++export type UseReadySandboxEnvironmentsResult = {+ environments: SandboxEnvironment[];+ loading: boolean;+ error: string | null;+ refetch: () => Promise<void>;+};++/**+ * Loads sandbox environments and filters strictly to ready (`status === 'ready'`) records.+ * Environments still building (`pending`) or failed (`failed`) are excluded.+ *+ * Re-fetches when the shell environments catalog epoch bumps (after manage CRUD /+ * activation) and when the Manage Environments overlay closes, so still-mounted+ * agent pickers stay in sync without remounting.+ */+export function useReadySandboxEnvironments(): UseReadySandboxEnvironmentsResult {+ const environmentServer = useOptionalSandboxEnvironmentServer();+ const shell = useOptionalShellMode();+ const environmentsListEpoch = shell?.environmentsListEpoch ?? 0;+ const environmentsOpen = shell?.environmentsOpen ?? false;+ const [environments, setEnvironments] = useState<SandboxEnvironment[]>([]);+ const [loading, setLoading] = useState(false);+ const [error, setError] = useState<string | null>(null);+ const requestGenRef = useRef(0);+ const wasEnvironmentsOpenRef = useRef(environmentsOpen);++ const fetchReadyEnvironments = useCallback(async () => {+ if (!environmentServer) {+ setEnvironments([]);+ setLoading(false);+ setError(null);+ return;+ }++ const gen = ++requestGenRef.current;+ setLoading(true);+ setError(null);++ try {+ const all = await drainListPages({+ fetchPage: pageToken => environmentServer.listEnvironments({ limit: 1000, pageToken }),+ });+ if (gen !== requestGenRef.current) return;+ const readyOnly = all.filter(env => env.status === 'ready');+ setEnvironments(readyOnly);+ } catch (caught) {+ if (gen !== requestGenRef.current) return;+ setError(getErrorMessage(caught, 'Failed to load sandbox environments.'));+ setEnvironments([]);+ } finally {+ if (gen === requestGenRef.current) {+ setLoading(false);+ }+ }+ }, [environmentServer]);++ useEffect(() => {+ void fetchReadyEnvironments();+ }, [fetchReadyEnvironments, environmentsListEpoch]);++ useEffect(() => {+ if (wasEnvironmentsOpenRef.current && !environmentsOpen) {+ void fetchReadyEnvironments();+ }+ wasEnvironmentsOpenRef.current = environmentsOpen;+ }, [environmentsOpen, fetchReadyEnvironments]);++ return {+ environments,+ loading,+ error,+ refetch: fetchReadyEnvironments,+ };+}diff --git a/packages/trueforge-ui/src/atoms/lib/dateFormat.ts b/packages/trueforge-ui/src/atoms/lib/dateFormat.tsindex af071542e..77c4f81d1 100644--- a/packages/trueforge-ui/src/atoms/lib/dateFormat.ts+++ b/packages/trueforge-ui/src/atoms/lib/dateFormat.ts@@ -9,3 +9,21 @@ export function formatAbsoluteDateTime(date: Date): string {hour12: true,}).format(date);}++/** Human-readable relative time (e.g. "just now", "5 min ago", "2 hours ago"). */+export function formatRelativeTime(+ iso: string | null | undefined,+ { fallback = '—', nowMs = Date.now() }: { fallback?: string; nowMs?: number } = {},+): string {+ if (iso == null) return fallback;+ const then = Date.parse(iso);+ if (Number.isNaN(then)) return fallback;+ const deltaSec = Math.round((nowMs - then) / 1000);+ if (deltaSec < 60) return 'just now';+ const mins = Math.round(deltaSec / 60);+ if (mins < 60) return `${String(mins)} min ago`;+ const hours = Math.round(mins / 60);+ if (hours < 48) return `${String(hours)} hour${hours === 1 ? '' : 's'} ago`;+ const days = Math.round(hours / 24);+ return `${String(days)} day${days === 1 ? '' : 's'} ago`;+}diff --git a/packages/trueforge-ui/src/atoms/primitives/Badge.tsx b/packages/trueforge-ui/src/atoms/primitives/Badge.tsxnew file mode 100644index 000000000..5bf0f4a43--- /dev/null+++ b/packages/trueforge-ui/src/atoms/primitives/Badge.tsx@@ -0,0 +1,69 @@+import React from 'react';++import { cn } from '../lib/cn.js';++export type BadgeVariant = 'default' | 'success' | 'info' | 'warning' | 'destructive' | 'outline';+export type BadgeShape = 'rounded' | 'pill';+export type BadgeSize = 'sm' | 'md';++export type BadgeProps = React.HTMLAttributes<HTMLSpanElement> & {+ variant?: BadgeVariant;+ shape?: BadgeShape;+ size?: BadgeSize;+ dot?: boolean;+};++const VARIANT_STYLES: Record<BadgeVariant, string> = {+ default: 'border-border bg-card-bg text-text-primary',+ success: 'border-success-bg/30 bg-success-bg/10 text-success-bg',+ info: 'border-primary-button-bg/30 bg-primary-button-bg/10 text-primary-button-bg',+ warning: 'border-warning-bg/40 bg-warning-bg/10 text-warning-bg',+ destructive: 'border-failure-bg/30 bg-failure-bg/10 text-failure-bg',+ outline: 'border-border bg-transparent text-text-secondary',+};++const DOT_STYLES: Record<BadgeVariant, string> = {+ default: 'bg-text-secondary',+ success: 'bg-success-bg',+ info: 'bg-primary-button-bg',+ warning: 'bg-warning-bg',+ destructive: 'bg-failure-bg',+ outline: 'bg-text-secondary',+};++const SHAPE_STYLES: Record<BadgeShape, string> = {+ rounded: 'rounded-sm',+ pill: 'rounded-full',+};++const SIZE_STYLES: Record<BadgeSize, string> = {+ sm: 'px-2 py-0.5 text-xs',+ md: 'px-2.5 py-0.5 text-xs',+};++export const Badge = React.forwardRef<HTMLSpanElement, BadgeProps>(+ ({ className, variant = 'default', shape = 'rounded', size = 'sm', dot = false, children, ...props }, ref) => {+ return (+ <span+ ref={ref}+ data-slot="badge"+ data-variant={variant}+ data-shape={shape}+ data-size={size}+ className={cn(+ 'inline-flex items-center gap-1.5 border font-medium leading-normal',+ VARIANT_STYLES[variant],+ SHAPE_STYLES[shape],+ SIZE_STYLES[size],+ className,+ )}+ {...props}+ >+ {dot ? <span className={cn('size-1.5 shrink-0 rounded-full', DOT_STYLES[variant])} aria-hidden /> : null}+ {children}+ </span>+ );+ },+);++Badge.displayName = 'Badge';diff --git a/packages/trueforge-ui/src/atoms/primitives/PopoverSelect.tsx b/packages/trueforge-ui/src/atoms/primitives/PopoverSelect.tsxindex 03bce6e2a..77e62a15f 100644--- a/packages/trueforge-ui/src/atoms/primitives/PopoverSelect.tsx+++ b/packages/trueforge-ui/src/atoms/primitives/PopoverSelect.tsx@@ -65,6 +65,8 @@ type CommonPopoverSelectProps<T extends string> = {prefix?: string;emptyContent?: ReactNode;footer?: ReactNode;+ /** Fires when the menu opens or closes. */+ onOpenChange?: (open: boolean) => void;'aria-label': string;};@@ -83,7 +85,11 @@ export type PopoverSelectProps<T extends string> = CommonPopoverSelectProps<T> &);export function PopoverSelect<T extends string>(props: PopoverSelectProps<T>) {- const [open, setOpen] = useState(false);+ const [open, setOpenState] = useState(false);+ const setOpen = (next: boolean) => {+ setOpenState(next);+ props.onOpenChange?.(next);+ };const [pos, setPos] = useState<{ top: number; left: number; width: number; placement: MenuPlacement } | null>(null);const rootRef = useRef<HTMLDivElement>(null);const triggerRef = useRef<HTMLButtonElement>(null);@@ -281,7 +287,7 @@ export function PopoverSelect<T extends string>(props: PopoverSelectProps<T>) {aria-expanded={open}aria-controls={open ? listboxId : undefined}className={props.prefix != null ? auiSelectPrefixTriggerClass() : auiSelectTriggerClass()}- onClick={() => setOpen(value => !value)}+ onClick={() => setOpen(!open)}onKeyDown={event => {if (event.key === 'ArrowDown' || event.key === 'Enter' || event.key === ' ') {event.preventDefault();diff --git a/packages/trueforge-ui/src/atoms/primitives/SideDrawer.tsx b/packages/trueforge-ui/src/atoms/primitives/SideDrawer.tsxindex 7e4f5e700..dbd899cb7 100644--- a/packages/trueforge-ui/src/atoms/primitives/SideDrawer.tsx+++ b/packages/trueforge-ui/src/atoms/primitives/SideDrawer.tsx@@ -17,6 +17,7 @@ export type SideDrawerProps = {title: string;description?: string;headerIcon?: ReactNode;+ headerActions?: ReactNode;children: ReactNode;footer?: ReactNode;/** Desktop side; ignored when compact / below `md` (falls back to bottom sheet). */@@ -44,6 +45,7 @@ export function SideDrawer({title,description,headerIcon,+ headerActions,children,footer,anchor = 'right',@@ -118,6 +120,7 @@ export function SideDrawer({</p>) : null}</div>+ {headerActions}<buttontype="button"aria-label="Close"diff --git a/packages/trueforge-ui/src/atoms/schedules/ScheduleStatusBadge.tsx b/packages/trueforge-ui/src/atoms/schedules/ScheduleStatusBadge.tsxindex 274f6743a..60bbf8431 100644--- a/packages/trueforge-ui/src/atoms/schedules/ScheduleStatusBadge.tsx+++ b/packages/trueforge-ui/src/atoms/schedules/ScheduleStatusBadge.tsx@@ -1,27 +1,11 @@-'use client';-import type { ScheduleStatus } from '../../server/types.js';-import { cn } from '../lib/cn.js';+import { Badge } from '../primitives/Badge.js';export function ScheduleStatusBadge({ status }: { status: ScheduleStatus }) {const active = status === 'active';return (- <span- className={cn(- 'inline-flex items-center gap-1.5 rounded-full border px-2.5 py-0.5 text-xs font-medium',- active- ? 'border-emerald-600/30 bg-emerald-500/10 text-emerald-700 dark:border-emerald-400/35 dark:bg-emerald-500/15 dark:text-emerald-300'- : 'border-amber-600/30 bg-amber-500/10 text-amber-800 dark:border-amber-400/35 dark:bg-amber-500/15 dark:text-amber-300',- )}- >- <span- className={cn(- 'size-1.5 shrink-0 rounded-full',- active ? 'bg-emerald-600 dark:bg-emerald-400' : 'bg-amber-600 dark:bg-amber-400',- )}- aria-hidden- />+ <Badge variant={active ? 'success' : 'warning'} shape="pill" size="md" dot>{active ? 'Active' : 'Paused'}- </span>+ </Badge>);}diff --git a/packages/trueforge-ui/src/atoms/schedules/cadence.ts b/packages/trueforge-ui/src/atoms/schedules/cadence.tsindex 310282970..341c8f9ef 100644--- a/packages/trueforge-ui/src/atoms/schedules/cadence.ts+++ b/packages/trueforge-ui/src/atoms/schedules/cadence.ts@@ -1,3 +1,5 @@+import { formatRelativeTime as formatRelativeTimeCommon } from '../lib/dateFormat.js';+export type RecurrenceKind = 'hourly' | 'daily' | 'weekly' | 'custom';export type ScheduleFormValues = {@@ -254,15 +256,5 @@ export function cronToFormValues(input: {}export function formatRelativeTime(iso: string | null, nowMs = Date.now()): string {- if (iso == null) return 'Never';- const then = Date.parse(iso);- if (Number.isNaN(then)) return 'Never';- const deltaSec = Math.round((nowMs - then) / 1000);- if (deltaSec < 60) return 'just now';- const mins = Math.round(deltaSec / 60);- if (mins < 60) return `${String(mins)} min ago`;- const hours = Math.round(mins / 60);- if (hours < 48) return `${String(hours)} hour${hours === 1 ? '' : 's'} ago`;- const days = Math.round(hours / 24);- return `${String(days)} day${days === 1 ? '' : 's'} ago`;+ return formatRelativeTimeCommon(iso, { fallback: 'Never', nowMs });}diff --git a/packages/trueforge-ui/src/containers/ThreadListContainer.tsx b/packages/trueforge-ui/src/containers/ThreadListContainer.tsxindex b5f12634b..52f757333 100644--- a/packages/trueforge-ui/src/containers/ThreadListContainer.tsx+++ b/packages/trueforge-ui/src/containers/ThreadListContainer.tsx@@ -192,7 +192,11 @@ function ThreadListItemRow({const showActions = showRename || showDelete;const renameDisabled = remoteId != null && !canManageResource(remoteId);const deleteDisabled = remoteId != null && !canDeleteResource(remoteId);- const sidebarNavOpen = shell?.libraryOpen === true || shell?.sessionsOpen === true || shell?.schedulesOpen === true;+ const sidebarNavOpen =+ shell?.libraryOpen === true ||+ shell?.sessionsOpen === true ||+ shell?.schedulesOpen === true ||+ shell?.environmentsOpen === true;const [renameOpen, setRenameOpen] = useState(false);const [renameSaving, setRenameSaving] = useState(false);@@ -227,6 +231,7 @@ function ThreadListItemRow({shell?.setLibraryOpen(false);shell?.setSessionsOpen(false);shell?.setSchedulesOpen(false);+ shell?.setEnvironmentsOpen(false);// Prefer custom.isMutable (session wire); agentName-only is a legacy fallback.const sessionMutable = threadListItemIsMutable(custom);@@ -406,6 +411,7 @@ export function ThreadListContainer({ onThreadOpen, variant = 'default' }: Threaconst AgentsLibraryButton = useSlot('AgentsLibraryButton');const SessionsBrowserButton = useSlot('SessionsBrowserButton');const SchedulesButton = useSlot('SchedulesButton');+ const EnvironmentsButton = useSlot('EnvironmentsButton');const ThreadListRowSkeleton = useSlot('ThreadListRowSkeleton');const ThreadListEmptyState = useSlot('ThreadListEmptyState');@@ -477,6 +483,7 @@ export function ThreadListContainer({ onThreadOpen, variant = 'default' }: Threa}shell?.setSettingsOpen(false);shell?.setSchedulesOpen(false);+ shell?.setEnvironmentsOpen(false);void Promise.resolve(aui.threads().switchToNewThread()).catch(() => undefined);};@@ -511,6 +518,7 @@ export function ThreadListContainer({ onThreadOpen, variant = 'default' }: Threa<AgentsLibraryButton /><SessionsBrowserButton /><SchedulesButton />+ <EnvironmentsButton /></div>)}diff --git a/packages/trueforge-ui/src/icons/IconRegistry.tsx b/packages/trueforge-ui/src/icons/IconRegistry.tsxindex 3371797e5..ff525e89b 100644--- a/packages/trueforge-ui/src/icons/IconRegistry.tsx+++ b/packages/trueforge-ui/src/icons/IconRegistry.tsx@@ -46,6 +46,7 @@ import {Menu,MessageSquareText,Minimize2,+ Monitor,Moon,PanelLeftClose,PanelLeftOpen,@@ -209,6 +210,7 @@ const defaults: Record<string, IconEntry> = {'external-link': ExternalLink,'square-arrow-out-up-right': SquareArrowOutUpRight,github: Github,+ monitor: Monitor,};for (const [name, icon] of Object.entries(defaults)) {diff --git a/packages/trueforge-ui/src/index.ts b/packages/trueforge-ui/src/index.tsindex 8c5a9f22f..8d0731e30 100644--- a/packages/trueforge-ui/src/index.ts+++ b/packages/trueforge-ui/src/index.ts@@ -30,8 +30,14 @@ export type {ThemePreset,} from './theme/types.js';+export { EnvironmentsPage } from './atoms/environments/EnvironmentsPage.js';+export type { EnvironmentsPageProps } from './atoms/environments/EnvironmentsPage.js';+export { EnvironmentsButton } from './atoms/EnvironmentsButton.js';+export type { EnvironmentsButtonProps } from './atoms/EnvironmentsButton.js';export { PermissionGuard } from './atoms/PermissionGuard.js';export type { PermissionGuardProps } from './atoms/PermissionGuard.js';+export { Badge } from './atoms/primitives/Badge.js';+export type { BadgeProps, BadgeShape, BadgeSize, BadgeVariant } from './atoms/primitives/Badge.js';export { BottomSheet } from './atoms/primitives/BottomSheet.js';export type { BottomSheetProps } from './atoms/primitives/BottomSheet.js';export { Button } from './atoms/primitives/Button.js';diff --git a/packages/trueforge-ui/src/layouts/DrawerLayout.tsx b/packages/trueforge-ui/src/layouts/DrawerLayout.tsxindex e7be20592..779397a0d 100644--- a/packages/trueforge-ui/src/layouts/DrawerLayout.tsx+++ b/packages/trueforge-ui/src/layouts/DrawerLayout.tsx@@ -21,6 +21,9 @@ const TruefoundrySettingsBuilder = lazy(() => import('../containers/SettingsBuilconst SchedulesPage = lazy(() =>import('../atoms/schedules/SchedulesPage.js').then(m => ({ default: m.SchedulesPage })),);+const EnvironmentsPage = lazy(() =>+ import('../atoms/environments/EnvironmentsPage.js').then(m => ({ default: m.EnvironmentsPage })),+);export function DrawerLayout({ className }: { className?: string }) {const aui = useAui();@@ -40,7 +43,8 @@ export function DrawerLayout({ className }: { className?: string }) {const libraryOpen = shell?.libraryOpen === true;const sessionsOpen = shell?.sessionsOpen === true;const schedulesOpen = shell?.schedulesOpen === true;- const overlayOpen = settingsOpen || libraryOpen || sessionsOpen || schedulesOpen;+ const environmentsOpen = shell?.environmentsOpen === true;+ const overlayOpen = settingsOpen || libraryOpen || sessionsOpen || schedulesOpen || environmentsOpen;const chatChromeActionsVisible = useChatChromeActionsVisible();const showAgentConfig =shell != null && shellIsCreateAgent(shell.mode) && !overlayOpen && (!isMobile || shell.agentConfigOpen);@@ -55,6 +59,7 @@ export function DrawerLayout({ className }: { className?: string }) {}shell?.setSettingsOpen(false);shell?.setSchedulesOpen(false);+ shell?.setEnvironmentsOpen(false);void Promise.resolve(aui.threads().switchToNewThread()).catch(() => undefined);};@@ -85,13 +90,14 @@ export function DrawerLayout({ className }: { className?: string }) {title={!overlayOpen ? (<NamedAgentHeaderLabel />- ) : libraryOpen || schedulesOpen ? (+ ) : libraryOpen || schedulesOpen || environmentsOpen ? (<buttontype="button"className={auiButtonClass({ variant: 'ghost', size: 'small' })}onClick={() => {shell?.setLibraryOpen(false);shell?.setSchedulesOpen(false);+ shell?.setEnvironmentsOpen(false);}}><Icon name="arrow-left" />@@ -178,6 +184,22 @@ export function DrawerLayout({ className }: { className?: string }) {><SchedulesPage /></Suspense>+ ) : environmentsOpen ? (+ <Suspense+ fallback={+ <div+ className="flex h-full items-center justify-center"+ role="status"+ aria-live="polite"+ aria-busy="true"+ >+ <Spinner size={28} className="text-text-primary" />+ <span className="sr-only">Loading</span>+ </div>+ }+ >+ <EnvironmentsPage />+ </Suspense>) : isIdle ? (<SelectAgentEmptyState />) : (diff --git a/packages/trueforge-ui/src/layouts/SidebarLayout.tsx b/packages/trueforge-ui/src/layouts/SidebarLayout.tsxindex e04a34872..386d5a9ef 100644--- a/packages/trueforge-ui/src/layouts/SidebarLayout.tsx+++ b/packages/trueforge-ui/src/layouts/SidebarLayout.tsx@@ -34,6 +34,9 @@ const TruefoundrySettingsBuilder = lazy(() => import('../containers/SettingsBuilconst SchedulesPage = lazy(() =>import('../atoms/schedules/SchedulesPage.js').then(m => ({ default: m.SchedulesPage })),);+const EnvironmentsPage = lazy(() =>+ import('../atoms/environments/EnvironmentsPage.js').then(m => ({ default: m.EnvironmentsPage })),+);const brandLogoClassName = 'h-5 w-5 max-w-40 shrink-0 object-contain';const railWidthClassName = 'w-20';@@ -66,12 +69,14 @@ function SidebarNav(): ReactNode {const AgentsLibraryButton = useSlot('AgentsLibraryButton');const SessionsBrowserButton = useSlot('SessionsBrowserButton');const SchedulesButton = useSlot('SchedulesButton');+ const EnvironmentsButton = useSlot('EnvironmentsButton');const showNewActions = shell?.isNewChatEnabled !== false;const overlayOpen =shell?.settingsOpen === true ||shell?.libraryOpen === true ||shell?.sessionsOpen === true ||- shell?.schedulesOpen === true;+ shell?.schedulesOpen === true ||+ shell?.environmentsOpen === true;const mode = shell?.mode;const newChatSelected =!overlayOpen &&@@ -89,6 +94,7 @@ function SidebarNav(): ReactNode {}shell?.setSettingsOpen(false);shell?.setSchedulesOpen(false);+ shell?.setEnvironmentsOpen(false);void Promise.resolve(aui.threads().switchToNewThread()).catch(() => undefined);};@@ -137,6 +143,7 @@ function SidebarNav(): ReactNode {<AgentsLibraryButton compact /><SessionsBrowserButton compact /><SchedulesButton compact />+ <EnvironmentsButton compact /></nav>);}@@ -205,7 +212,8 @@ export function SidebarLayout({ className }: { className?: string }) {const libraryOpen = shell?.libraryOpen === true;const sessionsOpen = shell?.sessionsOpen === true;const schedulesOpen = shell?.schedulesOpen === true;- const overlayOpen = settingsOpen || libraryOpen || sessionsOpen || schedulesOpen;+ const environmentsOpen = shell?.environmentsOpen === true;+ const overlayOpen = settingsOpen || libraryOpen || sessionsOpen || schedulesOpen || environmentsOpen;const showAgentConfig =shell != null && shellIsCreateAgent(shell.mode) && !overlayOpen && (!isMobile || shell.agentConfigOpen);const showRecentHistory = isRecentHistoryVisible({ overlayOpen, mode: shell?.mode });@@ -330,6 +338,22 @@ export function SidebarLayout({ className }: { className?: string }) {><SchedulesPage /></Suspense>+ ) : environmentsOpen ? (+ <Suspense+ fallback={+ <div+ className="flex h-full items-center justify-center"+ role="status"+ aria-live="polite"+ aria-busy="true"+ >+ <Spinner size={28} className="text-text-primary" />+ <span className="sr-only">Loading</span>+ </div>+ }+ >+ <EnvironmentsPage />+ </Suspense>) : isIdle ? (<SelectAgentEmptyState />) : (diff --git a/packages/trueforge-ui/src/layouts/StackChatPanel.tsx b/packages/trueforge-ui/src/layouts/StackChatPanel.tsxindex f9b05d46a..60bb248a0 100644--- a/packages/trueforge-ui/src/layouts/StackChatPanel.tsx+++ b/packages/trueforge-ui/src/layouts/StackChatPanel.tsx@@ -20,6 +20,9 @@ const TruefoundrySettingsBuilder = lazy(() => import('../containers/SettingsBuilconst SchedulesPage = lazy(() =>import('../atoms/schedules/SchedulesPage.js').then(m => ({ default: m.SchedulesPage })),);+const EnvironmentsPage = lazy(() =>+ import('../atoms/environments/EnvironmentsPage.js').then(m => ({ default: m.EnvironmentsPage })),+);export type StackChatPanelProps = {className?: string;@@ -47,6 +50,7 @@ export function StackChatPanel({ className, threadHeaderEnd }: StackChatPanelProconst libraryOpen = shell?.libraryOpen === true;const sessionsOpen = shell?.sessionsOpen === true;const schedulesOpen = shell?.schedulesOpen === true;+ const environmentsOpen = shell?.environmentsOpen === true;const chatChromeActionsVisible = useChatChromeActionsVisible();const showNewActions = shell?.isNewChatEnabled !== false;@@ -64,6 +68,7 @@ export function StackChatPanel({ className, threadHeaderEnd }: StackChatPanelPro}shell?.setSettingsOpen(false);shell?.setSchedulesOpen(false);+ shell?.setEnvironmentsOpen(false);void Promise.resolve(aui.threads().switchToNewThread()).catch(() => undefined);};@@ -125,6 +130,24 @@ export function StackChatPanel({ className, threadHeaderEnd }: StackChatPanelPro<SchedulesPage /></Suspense></div>+ ) : environmentsOpen ? (+ <div className="min-h-0 flex-1">+ <Suspense+ fallback={+ <div+ className="flex h-full items-center justify-center"+ role="status"+ aria-live="polite"+ aria-busy="true"+ >+ <Spinner size={28} className="text-text-primary" />+ <span className="sr-only">Loading</span>+ </div>+ }+ >+ <EnvironmentsPage />+ </Suspense>+ </div>) : (<><PageHeader@@ -170,13 +193,14 @@ export function StackChatPanel({ className, threadHeaderEnd }: StackChatPanelPro{/* Stable mount: only ShellActions needs to survive Settings / list / thread; host end chrome stays in the thread header. */}<footer className="flex shrink-0 items-center justify-between border-t border-border px-2 py-1.5"><div className="flex min-w-0 items-center gap-1">- {libraryOpen || schedulesOpen ? (+ {libraryOpen || schedulesOpen || environmentsOpen ? (<buttontype="button"className={auiButtonClass({ variant: 'ghost', size: 'small' })}onClick={() => {shell?.setLibraryOpen(false);shell?.setSchedulesOpen(false);+ shell?.setEnvironmentsOpen(false);}}><Icon name="arrow-left" />diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/index.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/index.tsindex 1cc6f07d0..8373f698e 100644--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/index.ts+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/index.ts@@ -14,6 +14,7 @@ import { createWebSearchProviderCatalog } from './catalogs/webSearchProviderCataimport { 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';@@ -74,6 +75,7 @@ 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';@@ -107,6 +109,7 @@ export function createTrueForgeAgentUIServer(options: CreateTrueForgeAgentUIServsessions: 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();diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/sandboxEnvironments/sandboxEnvironmentServer.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/sandboxEnvironments/sandboxEnvironmentServer.tsnew file mode 100644index 000000000..091329703--- /dev/null+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/sandboxEnvironments/sandboxEnvironmentServer.ts@@ -0,0 +1,159 @@+/**+ * Harness SandboxEnvironmentServer adapter — maps runtime DTOs to SDK wire.+ */+import type { TrueForge, TrueForgeApi } from '@truefoundry/trueforge-sdk';+import type {+ ListResult,+ ListSandboxEnvironmentsParams,+ SandboxEnvironment,+ SandboxEnvironmentManifest,+ SandboxEnvironmentServer,+} from '../../../server/types.js';+import { toListResult } from '../chatServer.js';++/** Default list environments page size. */+const DEFAULT_PAGE_LIMIT = 25;+/** Maximum allowed environments page size, matching backend route limit. */+const MAX_PAGE_LIMIT = 1000;++function toIsoInstant(value: Date | string): string {+ if (value instanceof Date) return value.toISOString();+ return value;+}++function toUiManifest(wire: TrueForgeApi.SandboxEnvironmentManifest): SandboxEnvironmentManifest {+ return {+ name: wire.name,+ ...(wire.description === undefined ? {} : { description: wire.description }),+ ...(wire.image === undefined+ ? {}+ : {+ image: {+ type: 'build',+ ...(wire.image.buildScript === undefined ? {} : { buildScript: wire.image.buildScript }),+ },+ }),+ ...(wire.resources === undefined+ ? {}+ : {+ resources: {+ cpu: wire.resources.cpu ?? 1,+ memory: wire.resources.memory ?? 1,+ disk: wire.resources.disk ?? 3,+ },+ }),+ ...(wire.environmentVariables === undefined ? {} : { environmentVariables: wire.environmentVariables }),+ ...(wire.networking === undefined+ ? {}+ : {+ networking: {+ ...(wire.networking.networkBlockAll === undefined+ ? {}+ : { networkBlockAll: wire.networking.networkBlockAll }),+ ...(wire.networking.domainAllowList === undefined+ ? {}+ : { domainAllowList: wire.networking.domainAllowList }),+ ...(wire.networking.secrets === undefined+ ? {}+ : {+ secrets: wire.networking.secrets.map(secret => ({+ env: secret.env,+ value: secret.value,+ hosts: secret.hosts,+ })),+ }),+ },+ }),+ };+}++function toWireManifest(manifest: SandboxEnvironmentManifest): TrueForgeApi.SandboxEnvironmentManifest {+ return {+ name: manifest.name,+ ...(manifest.description === undefined ? {} : { description: manifest.description }),+ ...(manifest.image === undefined+ ? {}+ : {+ image: {+ type: 'build',+ ...(manifest.image.buildScript === undefined ? {} : { buildScript: manifest.image.buildScript }),+ },+ }),+ ...(manifest.resources === undefined+ ? {}+ : {+ resources: {+ cpu: manifest.resources.cpu,+ memory: manifest.resources.memory,+ disk: manifest.resources.disk,+ },+ }),+ ...(manifest.environmentVariables === undefined ? {} : { environmentVariables: manifest.environmentVariables }),+ ...(manifest.networking === undefined+ ? {}+ : {+ networking: {+ ...(manifest.networking.networkBlockAll === undefined+ ? {}+ : { networkBlockAll: manifest.networking.networkBlockAll }),+ ...(manifest.networking.domainAllowList === undefined+ ? {}+ : { domainAllowList: manifest.networking.domainAllowList }),+ ...(manifest.networking.secrets === undefined+ ? {}+ : {+ secrets: manifest.networking.secrets.map(secret => ({+ env: secret.env,+ value: secret.value,+ hosts: secret.hosts,+ })),+ }),+ },+ }),+ };+}++function toUiEnvironment(wire: TrueForgeApi.SandboxEnvironment): SandboxEnvironment {+ return {+ id: wire.id,+ name: wire.name,+ description: wire.description,+ status: wire.status,+ statusReason: wire.statusReason,+ manifest: toUiManifest(wire.manifest),+ createdBySubject: wire.createdBySubject,+ createdAt: toIsoInstant(wire.createdAt),+ updatedAt: toIsoInstant(wire.updatedAt),+ };+}++export function createSandboxEnvironmentServer(options: { client: TrueForge }): SandboxEnvironmentServer {+ const { client } = options;++ return {+ async listEnvironments(req?: ListSandboxEnvironmentsParams): Promise<ListResult<SandboxEnvironment>> {+ const limit = Math.min(Math.max(req?.limit ?? DEFAULT_PAGE_LIMIT, 1), MAX_PAGE_LIMIT);+ const page = await client.sandboxEnvironments.list({+ limit,+ ...(req?.pageToken === undefined || req.pageToken === '' ? {} : { pageToken: req.pageToken }),+ });+ return toListResult(page, toUiEnvironment);+ },++ async getEnvironment({ name }): Promise<SandboxEnvironment> {+ const { data } = await client.sandboxEnvironments.get(name);+ return toUiEnvironment(data);+ },++ async createOrUpdateEnvironment({ manifest }): Promise<SandboxEnvironment> {+ const { data } = await client.sandboxEnvironments.createOrUpdate({+ manifest: toWireManifest(manifest),+ });+ return toUiEnvironment(data);+ },++ async deleteEnvironment({ name }): Promise<void> {+ await client.sandboxEnvironments.delete(name);+ },+ };+}diff --git a/packages/trueforge-ui/src/routing/ShellRouteSync.tsx b/packages/trueforge-ui/src/routing/ShellRouteSync.tsxindex 3c445fb22..dcecc9a68 100644--- a/packages/trueforge-ui/src/routing/ShellRouteSync.tsx+++ b/packages/trueforge-ui/src/routing/ShellRouteSync.tsx@@ -9,6 +9,7 @@ import { useToasterOptional } from '../containers/ToasterContainer.js';import {useOptionalAgentSessionsServer,useOptionalCatalogServer,+ useOptionalSandboxEnvironmentServer,useOptionalScheduleServer,useOptionalServer,useServerCapabilities,@@ -55,6 +56,7 @@ export function ShellRouteSync({const catalog = useOptionalCatalogServer();const sessions = useOptionalAgentSessionsServer();const schedules = useOptionalScheduleServer();+ const sandboxEnvironments = useOptionalSandboxEnvironmentServer();const capabilities = useServerCapabilities();const capabilitiesSettled = useServerCapabilitiesSettled();const toaster = useToasterOptional();@@ -62,8 +64,8 @@ export function ShellRouteSync({const location = useLocation();// Same gates as sidebar chrome: missing optional ports unregister their paths.const effectiveRoutes = useMemo(- () => toEffectiveRoutes({ routes, catalog, capabilities, sessions, schedules }),- [routes, catalog, capabilities, sessions, schedules],+ () => toEffectiveRoutes({ routes, catalog, capabilities, sessions, schedules, sandboxEnvironments }),+ [routes, catalog, capabilities, sessions, schedules, sandboxEnvironments],);const settingsChromeEnabled = effectiveRoutes.settings != null;// Gate identity only — avoid re-syncing when capabilities object identity churns@@ -74,6 +76,7 @@ export function ShellRouteSync({effectiveRoutes.sharedSession,effectiveRoutes.libraryAgent,effectiveRoutes.schedules,+ effectiveRoutes.environments,].join('\0');const snapshot: ShellSnapshot = {@@ -83,6 +86,7 @@ export function ShellRouteSync({sharedSessionId: shell.sharedSessionId,libraryAgentId: shell.libraryAgentId,schedulesOpen: shell.schedulesOpen,+ environmentsOpen: shell.environmentsOpen,pendingSessionId: shell.pendingSessionId,activeRemoteId,mode: shell.mode,@@ -118,6 +122,7 @@ export function ShellRouteSync({shell.setSettingsOpen(false);shell.setLibraryOpen(false);shell.setSchedulesOpen(false);+ shell.setEnvironmentsOpen(false);switch (shell.agentConfigMode) {case 'AgentLibrary':shell.openLibraryHome();@@ -241,6 +246,9 @@ export function ShellRouteSync({case 'schedules':shell.setSchedulesOpen(true);return;+ case 'environments':+ shell.setEnvironmentsOpen(true);+ return;case 'buildAgent':shell.openAgentBuilder();return;@@ -298,6 +306,8 @@ export function ShellRouteSync({shell.openLibraryAgent(urlPlace.agentId);} else if (urlPlace.type === 'schedules') {shell.setSchedulesOpen(true);+ } else if (urlPlace.type === 'environments') {+ shell.setEnvironmentsOpen(true);} else {const chatPlace = deriveChatPlace(snapshot);if (!placesEqual(chatPlace, urlPlace)) applyPlace(urlPlace);@@ -420,6 +430,9 @@ export function ShellRouteSync({// Leaving schedules via Back to a chat place.shell.setSchedulesOpen(false);}+ if (urlPlace.type !== 'environments' && shell.environmentsOpen) {+ shell.setEnvironmentsOpen(false);+ }applyPlace(urlPlace);}if (urlPlace.type !== 'agent' && placeOwnsHistoryAgentSearch(urlPlace)) {diff --git a/packages/trueforge-ui/src/routing/derivePlace.ts b/packages/trueforge-ui/src/routing/derivePlace.tsindex bf2e164e4..3f31b136a 100644--- a/packages/trueforge-ui/src/routing/derivePlace.ts+++ b/packages/trueforge-ui/src/routing/derivePlace.ts@@ -24,10 +24,11 @@ export function deriveChatPlace(snapshot: ShellSnapshot): RoutePlace {return { type: 'root' };}-/** Full place with overlay priority: settings, schedules, sessions, library, chat. */+/** Full place with overlay priority: settings, schedules, environments, sessions, library, chat. */export function derivePlace(snapshot: ShellSnapshot): RoutePlace {if (snapshot.settingsOpen) return { type: 'settings' };if (snapshot.schedulesOpen) return { type: 'schedules' };+ if (snapshot.environmentsOpen) return { type: 'environments' };if (snapshot.sessionsOpen && snapshot.sharedSessionId != null) {return { type: 'sharedSession', sessionId: snapshot.sharedSessionId };}diff --git a/packages/trueforge-ui/src/routing/paths.ts b/packages/trueforge-ui/src/routing/paths.tsindex 0c4b9409f..888e451d2 100644--- a/packages/trueforge-ui/src/routing/paths.ts+++ b/packages/trueforge-ui/src/routing/paths.ts@@ -1,3 +1,4 @@+import { clearEnvironmentShareSearch } from '../utils/environmentShareUrl.js';import { clearLibraryShareSearch } from '../utils/libraryShareUrl.js';import {clearScheduleShareSearch,@@ -17,6 +18,7 @@ const DEFAULTS = {library: '/library',libraryAgent: '/library/:agentId',schedules: '/schedules',+ environments: '/environments',buildAgent: '/build-agent',agent: '/agents/:agentName',session: '/sessions/:sessionId',@@ -45,6 +47,7 @@ export function resolveRoutesConfig(routes?: RoutesConfig): ResolvedRoutes {library: resolveOptional(paths?.library, DEFAULTS.library),libraryAgent: resolveOptional(paths?.libraryAgent, DEFAULTS.libraryAgent),schedules: resolveOptional(paths?.schedules, DEFAULTS.schedules),+ environments: resolveOptional(paths?.environments, DEFAULTS.environments),buildAgent: resolveOptional(paths?.buildAgent, DEFAULTS.buildAgent),agent: resolveOptional(paths?.agent, DEFAULTS.agent),session: resolveOptional(paths?.session, DEFAULTS.session),@@ -80,6 +83,8 @@ export function buildPath(place: RoutePlace, routes: ResolvedRoutes): string | nreturn routes.libraryAgent == null ? null : fillTemplate(routes.libraryAgent, place.agentId);case 'schedules':return routes.schedules;+ case 'environments':+ return routes.environments;case 'buildAgent':return routes.buildAgent;case 'agent':@@ -157,6 +162,7 @@ export function sanitizeSearchForPlace(place: RoutePlace, search: string): strinif (place.type === 'sessionsBrowser') {writeSessionShareSearch(params, { tab: null });clearScheduleShareSearch(params);+ clearEnvironmentShareSearch(params);clearLibraryShareSearch(params);} else if (place.type === 'library') {writeSessionShareSearch(params, {@@ -167,6 +173,7 @@ export function sanitizeSearchForPlace(place: RoutePlace, search: string): strintimeRange: null,});clearScheduleShareSearch(params);+ clearEnvironmentShareSearch(params);// Keep `agent_name` — owned by the library place.} else if (place.type === 'libraryAgent') {const share = readSessionShareSearch(search);@@ -177,6 +184,7 @@ export function sanitizeSearchForPlace(place: RoutePlace, search: string): strin...(share.sessionId != null && share.agentId !== place.agentId ? { sessionId: null, agentId: null } : {}),});clearScheduleShareSearch(params);+ clearEnvironmentShareSearch(params);clearLibraryShareSearch(params);if (share.tab === 'schedules') {writeScheduleShareSearch(params, {@@ -193,8 +201,20 @@ export function sanitizeSearchForPlace(place: RoutePlace, search: string): strinview: null,timeRange: null,});+ clearEnvironmentShareSearch(params);clearLibraryShareSearch(params);// Keep `agent` / `status` / `q` — owned by the schedules place.+ } else if (place.type === 'environments') {+ writeSessionShareSearch(params, {+ sessionId: null,+ agentId: null,+ tab: null,+ view: null,+ timeRange: null,+ });+ clearScheduleShareSearch(params);+ clearLibraryShareSearch(params);+ // Keep `envQ` / `envIsNew` — owned by the environments place.} else {writeSessionShareSearch(params, {sessionId: null,@@ -204,6 +224,7 @@ export function sanitizeSearchForPlace(place: RoutePlace, search: string): strintimeRange: null,});clearScheduleShareSearch(params);+ clearEnvironmentShareSearch(params);clearLibraryShareSearch(params);}const next = params.toString();@@ -260,6 +281,9 @@ export function matchPath(pathname: string, routes: ResolvedRoutes): RoutePlaceif (routes.schedules != null && normalized === routes.schedules) {return { type: 'schedules' };}+ if (routes.environments != null && normalized === routes.environments) {+ return { type: 'environments' };+ }if (routes.buildAgent != null && normalized === routes.buildAgent) {return { type: 'buildAgent' };}diff --git a/packages/trueforge-ui/src/routing/types.ts b/packages/trueforge-ui/src/routing/types.tsindex dba41efa8..9d7031cc7 100644--- a/packages/trueforge-ui/src/routing/types.ts+++ b/packages/trueforge-ui/src/routing/types.ts@@ -14,6 +14,7 @@ export type RoutePlace =| { type: 'libraryAgent'; agentId: string }| { type: 'sessionsBrowser' }| { type: 'schedules' }+ | { type: 'environments' }| { type: 'buildAgent' };/**@@ -35,6 +36,8 @@ export type RoutesConfig = {libraryAgent?: string | false;/** Schedules page. `false` keeps schedules overlay-only (no URL). Default `'/schedules'`. */schedules?: string | false;+ /** Environments page. `false` keeps environments overlay-only (no URL). Default `'/environments'`. */+ environments?: string | false;/** Agent builder. `false` disables its dedicated URL. Default `'/build-agent'`. */buildAgent?: string | false;/** Immutable "Try" agent. `false` disables. Default `'/agents/:agentName'`. */@@ -56,6 +59,7 @@ export type ResolvedRoutes = {library: string | null;libraryAgent: string | null;schedules: string | null;+ environments: string | null;buildAgent: string | null;agent: string | null;session: string | null;@@ -71,6 +75,7 @@ export type ShellSnapshot = {sharedSessionId: string | null;libraryAgentId: string | null;schedulesOpen: boolean;+ environmentsOpen: boolean;pendingSessionId?: string;/** Remote id of the active thread once a fresh chat is persisted. */activeRemoteId?: string;diff --git a/packages/trueforge-ui/src/server/ServerContext.tsx b/packages/trueforge-ui/src/server/ServerContext.tsxindex 9b69953d8..78c160887 100644--- a/packages/trueforge-ui/src/server/ServerContext.tsx+++ b/packages/trueforge-ui/src/server/ServerContext.tsx@@ -10,6 +10,7 @@ import type {AgentUIServer,CatalogServer,PermissionsServer,+ SandboxEnvironmentServer,ScheduleServer,} from './types.js';@@ -138,6 +139,20 @@ export function useOptionalScheduleServer(): ScheduleServer | null {return useOptionalServer()?.schedules ?? null;}+export function useSandboxEnvironmentServer(): SandboxEnvironmentServer {+ const server = useServer();+ if (server.sandboxEnvironments == null) {+ throw new Error(+ 'useSandboxEnvironmentServer requires AgentUIServer.sandboxEnvironments. Pass sandboxEnvironments to createTrueForgeServer.',+ );+ }+ return server.sandboxEnvironments;+}++export function useOptionalSandboxEnvironmentServer(): SandboxEnvironmentServer | null {+ return useOptionalServer()?.sandboxEnvironments ?? null;+}+export function useOptionalPermissionsServer(): PermissionsServer | null {return useOptionalServer()?.permissions ?? null;}diff --git a/packages/trueforge-ui/src/server/ShellModeContext.tsx b/packages/trueforge-ui/src/server/ShellModeContext.tsxindex d341efa71..a88c40b83 100644--- a/packages/trueforge-ui/src/server/ShellModeContext.tsx+++ b/packages/trueforge-ui/src/server/ShellModeContext.tsx@@ -12,11 +12,17 @@ import {writeDraftSpecPreferences,type DraftPreferenceKind,} from './draftSpecPreferences.js';-import { isSchedulesChromeEnabled, isSessionsChromeEnabled, isSettingsChromeEnabled } from './serverChrome.js';+import {+ isEnvironmentsChromeEnabled,+ isSchedulesChromeEnabled,+ isSessionsChromeEnabled,+ isSettingsChromeEnabled,+} from './serverChrome.js';import {useOptionalAgentSessionsServer,useOptionalCatalogServer,useOptionalRefreshServerCapabilities,+ useOptionalSandboxEnvironmentServer,useOptionalScheduleServer,useServerCapabilities,} from './ServerContext.js';@@ -110,6 +116,8 @@ type ShellModeContextValue = {closeLibraryAgent: () => void;schedulesOpen: boolean;setSchedulesOpen: (open: boolean) => void;+ environmentsOpen: boolean;+ setEnvironmentsOpen: (open: boolean) => void;/*** Bind from Agents (Try = immutable, Edit = mutable + agentSpec).* Prefer this over `selectAgent` / `openDraft` when both fields are available.@@ -162,6 +170,12 @@ type ShellModeContextValue = {*/agentsListEpoch: number;invalidateAgentsList: () => void;+ /**+ * Bumped when sandbox environments may have changed (create/update/delete/ready).+ * Agent environment pickers should re-fetch when this changes.+ */+ environmentsListEpoch: number;+ invalidateEnvironmentsList: () => void;};const ShellModeContext = createContext<ShellModeContextValue | null>(null);@@ -226,6 +240,7 @@ export function ShellModeProvider({const refreshCapabilities = useOptionalRefreshServerCapabilities();const sessionsServer = useOptionalAgentSessionsServer();const scheduleServer = useOptionalScheduleServer();+ const sandboxEnvironmentServer = useOptionalSandboxEnvironmentServer();const chatSeedRef = useRef(readDraftSpecPreferences('chat') ?? selectDraftSpecPreferences(mutableSeedFromConfig(agentConfig), 'chat'),);@@ -242,6 +257,7 @@ export function ShellModeProvider({const [mutableEpoch, setMutableEpoch] = useState(0);const [clearEpoch, setClearEpoch] = useState(0);const [agentsListEpoch, setAgentsListEpoch] = useState(0);+ const [environmentsListEpoch, setEnvironmentsListEpoch] = useState(0);const [settingsOpenState, setSettingsOpenState] = useState(initialSettingsOpen);const [settingsSection, setSettingsSection] = useState<SettingsSection>('models');const [agentConfigOpenState, setAgentConfigOpenState] = useState(false);@@ -250,6 +266,7 @@ export function ShellModeProvider({const [sharedSessionId, setSharedSessionId] = useState<string | null>(null);const [libraryAgentId, setLibraryAgentId] = useState<string | null>(null);const [schedulesOpenState, setSchedulesOpenState] = useState(false);+ const [environmentsOpenState, setEnvironmentsOpenState] = useState(false);const [historyAgentFilter, setHistoryAgentFilter] = useState<HistoryAgentFilter | null>(null);const [pendingSessionId, setPendingSessionId] = useState<string | undefined>(undefined);const [pendingSessionEpoch, setPendingSessionEpoch] = useState(0);@@ -258,6 +275,8 @@ export function ShellModeProvider({const sessionsEnabled = isSessionsChromeEnabled({ sessions: sessionsServer });const schedulesEnabled = isSchedulesChromeEnabled({ schedules: scheduleServer });const schedulesOpen = schedulesEnabled && schedulesOpenState;+ const environmentsEnabled = isEnvironmentsChromeEnabled({ sandboxEnvironments: sandboxEnvironmentServer });+ const environmentsOpen = environmentsEnabled && environmentsOpenState;const libraryOpen = isLibraryEnabled && libraryOpenState;const sessionsOpen = sessionsEnabled && sessionsOpenState;const setSessionsOpen = useCallback(@@ -268,6 +287,7 @@ export function ShellModeProvider({setLibraryOpenState(false);setLibraryAgentId(null);setSchedulesOpenState(false);+ setEnvironmentsOpenState(false);} else {replaceSessionShareSearch({view: null,@@ -287,6 +307,7 @@ export function ShellModeProvider({setLibraryOpenState(false);setLibraryAgentId(null);setSchedulesOpenState(false);+ setEnvironmentsOpenState(false);setSharedSessionId(sessionId);setSessionsOpenState(true);},@@ -304,6 +325,7 @@ export function ShellModeProvider({setAgentConfigOpenState(false);setSessionsOpen(false);setSchedulesOpenState(false);+ setEnvironmentsOpenState(false);}setLibraryAgentId(null);setLibraryOpenState(open);@@ -317,6 +339,7 @@ export function ShellModeProvider({setAgentConfigOpenState(false);setSessionsOpen(false);setSchedulesOpenState(false);+ setEnvironmentsOpenState(false);setLibraryOpenState(true);setLibraryAgentId(agentId);},@@ -336,6 +359,7 @@ export function ShellModeProvider({setLibraryAgentId(null);setSessionsOpen(false);setSchedulesOpenState(false);+ setEnvironmentsOpenState(false);}setSettingsOpenState(settingsEnabled && open);},@@ -349,6 +373,7 @@ export function ShellModeProvider({setLibraryAgentId(null);setSessionsOpen(false);setSchedulesOpenState(false);+ setEnvironmentsOpenState(false);}setAgentConfigOpenState(open);},@@ -362,11 +387,26 @@ export function ShellModeProvider({setLibraryOpenState(false);setLibraryAgentId(null);setSessionsOpen(false);+ setEnvironmentsOpenState(false);}setSchedulesOpenState(schedulesEnabled && open);},[schedulesEnabled, setSessionsOpen],);+ const setEnvironmentsOpen = useCallback(+ (open: boolean) => {+ if (open) {+ setSettingsOpenState(false);+ setAgentConfigOpenState(false);+ setLibraryOpenState(false);+ setLibraryAgentId(null);+ setSessionsOpen(false);+ setSchedulesOpenState(false);+ }+ setEnvironmentsOpenState(environmentsEnabled && open);+ },+ [environmentsEnabled, setSessionsOpen],+ );useEffect(() => {if (catalog == null || capabilities?.settings?.enabled === false) {@@ -387,10 +427,20 @@ export function ShellModeProvider({}}, [schedulesEnabled]);+ useEffect(() => {+ if (!environmentsEnabled) {+ setEnvironmentsOpenState(false);+ }+ }, [environmentsEnabled]);+const invalidateAgentsList = useCallback(() => {setAgentsListEpoch(n => n + 1);}, []);+ const invalidateEnvironmentsList = useCallback(() => {+ setEnvironmentsListEpoch(n => n + 1);+ }, []);+const lockedAgentName = agentConfig.mode === 'SingleAgent' ? agentConfig.name : '';const effectiveMode: ShellMode = useMemo(() => {if (!locked) return mode;@@ -432,6 +482,7 @@ export function ShellModeProvider({setLibraryAgentId(null);setSessionsOpen(false);setSchedulesOpen(false);+ setEnvironmentsOpen(false);setPendingSessionId(undefined);const isCreateAgent = resolveMutableIsCreateAgent(req);const kind: DraftPreferenceKind = isCreateAgent ? 'agent' : 'chat';@@ -457,6 +508,7 @@ export function ShellModeProvider({setLibraryAgentId(null);setSessionsOpen(false);setSchedulesOpen(false);+ setEnvironmentsOpen(false);setPendingSessionId(undefined);setAgentConfigOpenState(false);setMode({@@ -478,7 +530,15 @@ export function ShellModeProvider({}bumpEpoch(false);},- [isComposerEnabled, isLibraryEnabled, bumpEpoch, setSettingsOpen, setSessionsOpen, setSchedulesOpen],+ [+ isComposerEnabled,+ isLibraryEnabled,+ bumpEpoch,+ setSettingsOpen,+ setSessionsOpen,+ setSchedulesOpen,+ setEnvironmentsOpen,+ ],);const bindMutableAgent = useCallback(@@ -528,6 +588,7 @@ export function ShellModeProvider({setLibraryAgentId(null);setSessionsOpen(false);setSchedulesOpen(false);+ setEnvironmentsOpen(false);setAgentConfigOpenState(true);return;}@@ -538,6 +599,7 @@ export function ShellModeProvider({isComposerEnabled,refreshCapabilities,selectLibraryAgent,+ setEnvironmentsOpen,setSchedulesOpen,setSessionsOpen,setSettingsOpen,@@ -598,6 +660,7 @@ export function ShellModeProvider({setLibraryAgentId(null);setSessionsOpen(false);setSchedulesOpen(false);+ setEnvironmentsOpen(false);setPendingSessionId(sessionId);setPendingSessionEpoch(n => n + 1);if (isMutable) {@@ -621,7 +684,16 @@ export function ShellModeProvider({...(agentName != null ? { agentId: agentName, agentName } : {}),});},- [isLibraryEnabled, isComposerEnabled, locked, lockedAgentName, setSettingsOpen, setSessionsOpen, setSchedulesOpen],+ [+ isLibraryEnabled,+ isComposerEnabled,+ locked,+ lockedAgentName,+ setSettingsOpen,+ setSessionsOpen,+ setSchedulesOpen,+ setEnvironmentsOpen,+ ],);const clearChat = useCallback(() => {@@ -654,9 +726,10 @@ export function ShellModeProvider({setLibraryOpenState(false);setLibraryAgentId(null);setSchedulesOpen(false);+ setEnvironmentsOpen(false);setMode({ status: 'idle' });bumpEpoch(false);- }, [isLibraryEnabled, isComposerEnabled, setSettingsOpen, setSchedulesOpen, bumpEpoch]);+ }, [isLibraryEnabled, isComposerEnabled, setSettingsOpen, setSchedulesOpen, setEnvironmentsOpen, bumpEpoch]);// Only explicit resets remount the runtime; history and identity changes happen in place.const runtimeKey = useMemo(() => {@@ -689,6 +762,8 @@ export function ShellModeProvider({closeLibraryAgent,schedulesOpen,setSchedulesOpen,+ environmentsOpen,+ setEnvironmentsOpen,selectLibraryAgent,bindMutableAgent,selectAgent,@@ -706,6 +781,8 @@ export function ShellModeProvider({pendingSessionEpoch,agentsListEpoch,invalidateAgentsList,+ environmentsListEpoch,+ invalidateEnvironmentsList,}),[effectiveMode,@@ -730,6 +807,8 @@ export function ShellModeProvider({closeLibraryAgent,schedulesOpen,setSchedulesOpen,+ environmentsOpen,+ setEnvironmentsOpen,selectLibraryAgent,bindMutableAgent,selectAgent,@@ -746,6 +825,8 @@ export function ShellModeProvider({pendingSessionEpoch,agentsListEpoch,invalidateAgentsList,+ environmentsListEpoch,+ invalidateEnvironmentsList,],);diff --git a/packages/trueforge-ui/src/server/createTrueForgeServer.ts b/packages/trueforge-ui/src/server/createTrueForgeServer.tsindex b37753406..151993d03 100644--- a/packages/trueforge-ui/src/server/createTrueForgeServer.ts+++ b/packages/trueforge-ui/src/server/createTrueForgeServer.ts@@ -12,6 +12,7 @@ import type {ListResult,ModelSelection,PermissionsServer,+ SandboxEnvironmentServer,SaveAgentRequest,SaveAgentResult,ScheduleServer,@@ -30,6 +31,7 @@ export type CreateTrueForgeServerOptions<TSessions extends AgentSessionsServer<TSpec> = AgentSessionsServer<TSpec>,TMetrics extends AgentMetricsServer = AgentMetricsServer,TSchedules extends ScheduleServer = ScheduleServer,+ TSandboxEnvironments extends SandboxEnvironmentServer = SandboxEnvironmentServer,TPermissions extends PermissionsServer = PermissionsServer,> = {/** Chat port — e.g. from `@truefoundry/agent-server-adapter`. */@@ -51,6 +53,8 @@ export type CreateTrueForgeServerOptions<metrics?: TMetrics;/** Schedules listing + CRUD. Optional. */schedules?: TSchedules;+ /** Sandbox environments listing + CRUD. Optional. */+ sandboxEnvironments?: TSandboxEnvironments;/** Per-resource grants. Omit to leave actions enabled. */permissions?: TPermissions;/** Authenticated caller identity. Used for tenant-scoped share copy. */@@ -69,6 +73,7 @@ export type TrueForgeServer<TSessions extends AgentSessionsServer<TSpec> = AgentSessionsServer<TSpec>,TMetrics extends AgentMetricsServer = AgentMetricsServer,TSchedules extends ScheduleServer = ScheduleServer,+ TSandboxEnvironments extends SandboxEnvironmentServer = SandboxEnvironmentServer,TPermissions extends PermissionsServer = PermissionsServer,> = AgentChatServer<TSpec> &AgentBuilderServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCapabilities> & {@@ -76,6 +81,7 @@ export type TrueForgeServer<sessions?: TSessions;metrics?: TMetrics;schedules?: TSchedules;+ sandboxEnvironments?: TSandboxEnvironments;permissions?: TPermissions;getMe?: () => Promise<{ tenantId: string }>;};@@ -97,6 +103,7 @@ export function createTrueForgeServer<TSessions extends AgentSessionsServer<TSpec> = AgentSessionsServer<TSpec>,TMetrics extends AgentMetricsServer = AgentMetricsServer,TSchedules extends ScheduleServer = ScheduleServer,+ TSandboxEnvironments extends SandboxEnvironmentServer = SandboxEnvironmentServer,TPermissions extends PermissionsServer = PermissionsServer,>(opts: CreateTrueForgeServerOptions<@@ -111,6 +118,7 @@ export function createTrueForgeServer<TSessions,TMetrics,TSchedules,+ TSandboxEnvironments,TPermissions>,): TrueForgeServer<@@ -125,6 +133,7 @@ export function createTrueForgeServer<TSessions,TMetrics,TSchedules,+ TSandboxEnvironments,TPermissions> {const builder: AgentBuilderServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCapabilities> = {@@ -157,6 +166,7 @@ export function createTrueForgeServer<TSessions,TMetrics,TSchedules,+ TSandboxEnvironments,TPermissions> = {...opts.chatServer,@@ -165,6 +175,7 @@ export function createTrueForgeServer<...(opts.sessions != null ? { sessions: opts.sessions } : {}),...(opts.metrics != null ? { metrics: opts.metrics } : {}),...(opts.schedules != null ? { schedules: opts.schedules } : {}),+ ...(opts.sandboxEnvironments != null ? { sandboxEnvironments: opts.sandboxEnvironments } : {}),...(opts.permissions != null ? { permissions: opts.permissions } : {}),...(opts.getMe != null ? { getMe: opts.getMe } : {}),};diff --git a/packages/trueforge-ui/src/server/serverChrome.ts b/packages/trueforge-ui/src/server/serverChrome.tsindex 9246b2638..5d8452f97 100644--- a/packages/trueforge-ui/src/server/serverChrome.ts+++ b/packages/trueforge-ui/src/server/serverChrome.ts@@ -1,5 +1,11 @@import type { ResolvedRoutes } from '../routing/types.js';-import type { AgentMetricsServer, AgentSessionsServer, CatalogServer, ScheduleServer } from './types.js';+import type {+ AgentMetricsServer,+ AgentSessionsServer,+ CatalogServer,+ SandboxEnvironmentServer,+ ScheduleServer,+} from './types.js';/*** Whether Settings chrome is available: sidebar button and `/settings` route.@@ -25,6 +31,15 @@ export function isSchedulesChromeEnabled({ schedules }: { schedules: ScheduleSerreturn 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;@@ -40,12 +55,14 @@ export function toEffectiveRoutes({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 {@@ -55,5 +72,6 @@ export function toEffectiveRoutes({sharedSession: sessionsEnabled ? routes.sharedSession : null,libraryAgent: sessionsEnabled ? routes.libraryAgent : null,schedules: isSchedulesChromeEnabled({ schedules }) ? routes.schedules : null,+ environments: isEnvironmentsChromeEnabled({ sandboxEnvironments }) ? routes.environments : null,};}diff --git a/packages/trueforge-ui/src/server/types.ts b/packages/trueforge-ui/src/server/types.tsindex 0b25157b7..27fd3f0ee 100644--- a/packages/trueforge-ui/src/server/types.ts+++ b/packages/trueforge-ui/src/server/types.ts@@ -67,6 +67,7 @@ export type {ListPermissionsRequest,ListPermissionsResponse,ListResult,+ ListSandboxEnvironmentsParams,ListSchedulesParams,ListSessionEventsParams,ListSessionsOrder,@@ -92,6 +93,14 @@ export type {RegistrySkill,ResourcePermission,SandboxCatalogServer,+ SandboxEnvironment,+ SandboxEnvironmentImage,+ SandboxEnvironmentManifest,+ SandboxEnvironmentNetworking,+ SandboxEnvironmentResources,+ SandboxEnvironmentSecret,+ SandboxEnvironmentServer,+ SandboxEnvironmentStatus,SandboxProviderBase,SandboxProviderCatalogEntry,SaveAgentRequest,diff --git a/packages/trueforge-ui/src/theme/defaultSlots.ts b/packages/trueforge-ui/src/theme/defaultSlots.tsindex 603a13101..c802e68fd 100644--- a/packages/trueforge-ui/src/theme/defaultSlots.ts+++ b/packages/trueforge-ui/src/theme/defaultSlots.ts@@ -62,6 +62,8 @@ import { DraftComposerActionsMenu } from '../atoms/draft/DraftComposerActionsMenimport { DraftComposerLeftSection, DraftComposerRightSection } from '../atoms/draft/DraftComposerSections.js';import { CatalogRow, ConnectorConnectButton, DraftCompositeSelector } from '../atoms/draft/DraftCompositeSelector.js';import { DraftModelSelector } from '../atoms/draft/DraftModelSelector.js';+import type { EnvironmentsPageProps } from '../atoms/environments/EnvironmentsPage.js';+import { EnvironmentsButton } from '../atoms/EnvironmentsButton.js';import { FilePreviewPanel } from '../atoms/FilePreviewPanel.js';import { HistoryLoader } from '../atoms/HistoryLoader.js';import { Markdown } from '../atoms/Markdown.js';@@ -122,6 +124,10 @@ const SchedulesPage: ComponentType<SchedulesPageProps> = lazy(async () => {const mod = await import('../atoms/schedules/SchedulesPage.js');return { default: mod.SchedulesPage };});+const EnvironmentsPage: ComponentType<EnvironmentsPageProps> = lazy(async () => {+ const mod = await import('../atoms/environments/EnvironmentsPage.js');+ return { default: mod.EnvironmentsPage };+});const AgentSessionEventTimeline: ComponentType<AgentSessionEventTimelineProps> = lazy(async () => {const mod = await import('../atoms/agent-details/AgentSessionEventTimeline.js');return { default: mod.AgentSessionEventTimeline };@@ -243,6 +249,8 @@ export const defaultSlots = {AgentCodeBlock,SchedulesPage,SchedulesButton,+ EnvironmentsPage,+ EnvironmentsButton,SaveAgentButton,SaveAgentForm,SelectAgentEmptyState,diff --git a/packages/trueforge-ui/src/utils/environmentShareUrl.ts b/packages/trueforge-ui/src/utils/environmentShareUrl.tsnew file mode 100644index 000000000..ab27cb37e--- /dev/null+++ b/packages/trueforge-ui/src/utils/environmentShareUrl.ts@@ -0,0 +1,50 @@+/** Distinct from schedules `q` / `isNew` so places do not clobber each other. */+export const ENVIRONMENT_NAME_QUERY = 'envQ';+export const ENVIRONMENT_IS_NEW_QUERY = 'envIsNew';++export const ENVIRONMENT_SHARE_CHANGE_EVENT = 'trueforge-environment-share';++export type EnvironmentShareSearch = {+ /** Name search; `null` when empty. */+ q: string | null;+ /** One-shot flag to open the create environment drawer. */+ isNew: boolean;+};++export type EnvironmentShareWrite = {+ q?: string | null;+ isNew?: boolean | null;+};++function nonEmpty(value: string | null): string | null {+ return value != null && value.length > 0 ? value : null;+}++export function readEnvironmentShareSearch(search: string): EnvironmentShareSearch {+ const params = new URLSearchParams(search.startsWith('?') ? search.slice(1) : search);+ return {+ q: nonEmpty(params.get(ENVIRONMENT_NAME_QUERY)),+ isNew: params.get(ENVIRONMENT_IS_NEW_QUERY) === 'true',+ };+}++export function writeEnvironmentShareSearch(params: URLSearchParams, next: EnvironmentShareWrite): void {+ if (next.q === null) params.delete(ENVIRONMENT_NAME_QUERY);+ else if (next.q != null) params.set(ENVIRONMENT_NAME_QUERY, next.q);+ if (next.isNew === null || next.isNew === false) params.delete(ENVIRONMENT_IS_NEW_QUERY);+ else if (next.isNew === true) params.set(ENVIRONMENT_IS_NEW_QUERY, 'true');+}++/** Drop all environments-owned query keys (used when leaving the environments place). */+export function clearEnvironmentShareSearch(params: URLSearchParams): void {+ params.delete(ENVIRONMENT_NAME_QUERY);+ params.delete(ENVIRONMENT_IS_NEW_QUERY);+}++export function replaceEnvironmentShareSearch(next: EnvironmentShareWrite): string {+ const url = new URL(window.location.href);+ writeEnvironmentShareSearch(url.searchParams, next);+ window.history.replaceState(window.history.state, '', url);+ window.dispatchEvent(new Event(ENVIRONMENT_SHARE_CHANGE_EVENT));+ return url.search;+}diff --git a/packages/trueforge-ui/test/atoms/draft/AgentRuntimeConfigFields.test.tsx b/packages/trueforge-ui/test/atoms/draft/AgentRuntimeConfigFields.test.tsxnew file mode 100644index 000000000..26584f0e2--- /dev/null+++ b/packages/trueforge-ui/test/atoms/draft/AgentRuntimeConfigFields.test.tsx@@ -0,0 +1,122 @@+import { fireEvent, render, screen, waitFor } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { AgentRuntimeConfigFields } from '@/atoms/draft/AgentRuntimeConfigFields.js';+import { ServerProvider } from '@/server/ServerContext.js';+import type { AgentRuntimeConfig } from '@/server/types.js';+import { createMockAgentUIServer, createMockSandboxEnvironmentServer } from '../../server/mockServer.js';++const setEnvironmentsOpen = vi.fn();++vi.mock('@/server/ShellModeContext.js', () => ({+ useOptionalShellMode: () => ({ setEnvironmentsOpen }),+}));++function renderRuntimeFields({+ value = { sandbox: { enabled: true } },+ layout = 'detailed',+ sandboxAvailable = true,+ onChange = vi.fn(),+}: {+ value?: AgentRuntimeConfig;+ layout?: 'compact' | 'detailed';+ sandboxAvailable?: boolean;+ onChange?: (val: AgentRuntimeConfig) => void;+} = {}) {+ const environmentServer = createMockSandboxEnvironmentServer({+ listEnvironments: async () => ({+ data: [+ {+ id: 'env-default',+ name: 'default',+ description: 'Default environment',+ status: 'ready',+ statusReason: null,+ manifest: { name: 'default', description: 'Default environment' },+ createdBySubject: { subjectId: 'u1', subjectType: 'user', subjectDisplayName: 'user-1' },+ createdAt: '2026-09-01T10:00:00Z',+ updatedAt: '2026-09-01T10:00:00Z',+ },+ {+ id: 'env-1',+ name: 'python-dev',+ description: 'Python 3.11 environment',+ status: 'ready',+ statusReason: null,+ manifest: { name: 'python-dev', description: 'Python 3.11 environment' },+ createdBySubject: { subjectId: 'u1', subjectType: 'user', subjectDisplayName: 'user-1' },+ createdAt: '2026-09-01T10:00:00Z',+ updatedAt: '2026-09-01T10:00:00Z',+ },+ {+ id: 'env-2',+ name: 'pending-env',+ description: '',+ status: 'pending',+ statusReason: null,+ manifest: { name: 'pending-env' },+ createdBySubject: { subjectId: 'u1', subjectType: 'user', subjectDisplayName: 'user-1' },+ createdAt: '2026-09-01T10:00:00Z',+ updatedAt: '2026-09-01T10:00:00Z',+ },+ ],+ }),+ });++ const server = createMockAgentUIServer({+ sandboxEnvironments: environmentServer,+ });++ return render(+ <ServerProvider server={server}>+ <AgentRuntimeConfigFields+ value={value}+ sandboxAvailable={sandboxAvailable}+ hasSkills={false}+ layout={layout}+ onChange={onChange}+ />+ </ServerProvider>,+ );+}++describe('AgentRuntimeConfigFields', () => {+ it('renders environment row in detailed layout with Manage Environments link', async () => {+ renderRuntimeFields();++ expect(screen.getByText('Environment')).toBeInTheDocument();+ expect(+ screen.getByText('Image, resources, network and secrets the sandbox starts with. Stored by name.'),+ ).toBeInTheDocument();++ const manageBtn = screen.getByRole('button', { name: /Manage Environments/ });+ expect(manageBtn).toBeInTheDocument();+ fireEvent.click(manageBtn);+ expect(setEnvironmentsOpen).toHaveBeenCalledWith(true);+ });++ it('populates environment dropdown with default and ready environments only', async () => {+ const onChange = vi.fn();+ renderRuntimeFields({ onChange });++ const trigger = screen.getByRole('button', { name: 'Environment' });+ await waitFor(() => {+ expect(trigger).toHaveTextContent('default');+ });++ fireEvent.click(trigger);++ expect(await screen.findByRole('option', { name: 'python-dev' })).toBeInTheDocument();+ expect(screen.getByRole('option', { name: 'default' })).toBeInTheDocument();+ expect(screen.queryByRole('option', { name: 'pending-env' })).not.toBeInTheDocument();++ fireEvent.click(screen.getByRole('option', { name: 'python-dev' }));+ expect(onChange).toHaveBeenCalledWith(+ expect.objectContaining({+ sandbox: expect.objectContaining({+ environment_name: 'python-dev',+ }),+ }),+ );+ });+});diff --git a/packages/trueforge-ui/test/atoms/draft/DraftCompositeSelector.test.tsx b/packages/trueforge-ui/test/atoms/draft/DraftCompositeSelector.test.tsxindex abf2d418a..d01980507 100644--- a/packages/trueforge-ui/test/atoms/draft/DraftCompositeSelector.test.tsx+++ b/packages/trueforge-ui/test/atoms/draft/DraftCompositeSelector.test.tsx@@ -6,8 +6,19 @@ import { DraftCatalogProvider } from '@/atoms/draft/DraftCatalogProvider.js';import { DraftCompositeSelector } from '@/atoms/draft/DraftCompositeSelector.js';import { CompactLayoutProvider } from '@/atoms/lib/CompactLayoutContext.js';import { ServerProvider } from '@/server/ServerContext.js';-import type { AgentSkill, AgentSpec, CatalogServer, SandboxCatalogServer, SkillCatalogServer } from '@/server/types.js';-import { createMockAgentUIServer, createMockCatalog } from '../../server/mockServer.js';+import type {+ AgentSkill,+ AgentSpec,+ CatalogServer,+ SandboxCatalogServer,+ SandboxEnvironmentServer,+ SkillCatalogServer,+} from '@/server/types.js';+import {+ createMockAgentUIServer,+ createMockCatalog,+ createMockSandboxEnvironmentServer,+} from '../../server/mockServer.js';let agentSpec: AgentSpec;const updateAgentSpec = vi.fn();@@ -32,13 +43,15 @@ const sandboxCatalog: SandboxCatalogServer = {const settingsCatalog = createMockCatalog({ skillCatalog, sandboxCatalog });+const setEnvironmentsOpen = vi.fn();+vi.mock('@truefoundry/trueforge-assistant-ui-runtime', () => ({useTrueForgeAgentSpec: () => ({ agentSpec }),useTrueForgeUpdateAgentSpec: () => updateAgentSpec,}));vi.mock('@/server/ShellModeContext.js', () => ({- useOptionalShellMode: () => ({ setSettingsOpen }),+ useOptionalShellMode: () => ({ setSettingsOpen, setEnvironmentsOpen }),}));beforeAll(() => {@@ -58,6 +71,7 @@ function renderSelector({getMcp,catalog = settingsCatalog,compact = false,+ environmentServer,}: {onAttach?: () => void;getCapabilities?: () => Promise<{@@ -71,9 +85,11 @@ function renderSelector({getMcp?: () => Promise<{ id: string; name: string; authenticated: boolean }[]>;catalog?: CatalogServer | null;compact?: boolean;+ environmentServer?: SandboxEnvironmentServer;} = {}) {const server = createMockAgentUIServer({...(catalog === null ? {} : { catalog }),+ ...(environmentServer ? { sandboxEnvironments: environmentServer } : {}),getCapabilities:getCapabilities ??(async () => ({@@ -111,6 +127,7 @@ describe('DraftCompositeSelector', () => {};updateAgentSpec.mockReset();setSettingsOpen.mockReset();+ setEnvironmentsOpen.mockReset();});afterEach(() => {@@ -362,4 +379,94 @@ describe('DraftCompositeSelector', () => {expect(await screen.findByText('No skills')).toBeInTheDocument();expect(screen.queryByRole('button', { name: /Please configure a Sandbox/ })).not.toBeInTheDocument();});++ it('renders environment tab with default and ready environments only, excluding pending/failed and status badges', async () => {+ const environmentServer = createMockSandboxEnvironmentServer({+ listEnvironments: async () => ({+ data: [+ {+ id: 'env-default',+ name: 'default',+ description: 'Default environment',+ status: 'ready',+ statusReason: null,+ manifest: { name: 'default', description: 'Default environment' },+ createdBySubject: { subjectId: 'u1', subjectType: 'user', subjectDisplayName: 'user-1' },+ createdAt: '2026-09-01T10:00:00Z',+ updatedAt: '2026-09-01T10:00:00Z',+ },+ {+ id: 'env-1',+ name: 'python-dev',+ description: 'Python 3.11 environment with poetry',+ status: 'ready',+ statusReason: null,+ manifest: { name: 'python-dev', description: 'Python 3.11 environment with poetry' },+ createdBySubject: { subjectId: 'u1', subjectType: 'user', subjectDisplayName: 'user-1' },+ createdAt: '2026-09-01T10:00:00Z',+ updatedAt: '2026-09-01T10:00:00Z',+ },+ {+ id: 'env-2',+ name: 'building-env',+ description: '',+ status: 'pending',+ statusReason: null,+ manifest: { name: 'building-env' },+ createdBySubject: { subjectId: 'u1', subjectType: 'user', subjectDisplayName: 'user-1' },+ createdAt: '2026-09-01T10:00:00Z',+ updatedAt: '2026-09-01T10:00:00Z',+ },+ {+ id: 'env-3',+ name: 'broken-env',+ description: '',+ status: 'failed',+ statusReason: 'Build failed',+ manifest: { name: 'broken-env' },+ createdBySubject: { subjectId: 'u1', subjectType: 'user', subjectDisplayName: 'user-1' },+ createdAt: '2026-09-01T10:00:00Z',+ updatedAt: '2026-09-01T10:00:00Z',+ },+ ],+ }),+ });++ renderSelector({ environmentServer });+ fireEvent.click(screen.getByRole('button', { name: 'Tools (2)' }));+ fireEvent.click(screen.getByRole('button', { name: /Environment/ }));++ expect(await screen.findByText('default')).toBeInTheDocument();+ expect(screen.getByText('Default environment')).toBeInTheDocument();+ expect(await screen.findByText('python-dev')).toBeInTheDocument();+ expect(screen.getByText('Python 3.11 environment with poetry')).toBeInTheDocument();++ // pending and failed environments must NOT be displayed+ expect(screen.queryByText('building-env')).not.toBeInTheDocument();+ expect(screen.queryByText('broken-env')).not.toBeInTheDocument();++ // No "Ready" status badge should be rendered+ expect(screen.queryByText('Ready')).not.toBeInTheDocument();++ // Select custom environment+ fireEvent.click(screen.getByText('python-dev'));+ expect(updateAgentSpec).toHaveBeenCalledWith({+ config: expect.objectContaining({+ sandbox: expect.objectContaining({+ enabled: true,+ environment_name: 'python-dev',+ }),+ }),+ });++ // Select default environment clears environment_name+ fireEvent.click(screen.getByText('default'));+ expect(updateAgentSpec).toHaveBeenCalledWith({+ config: expect.objectContaining({+ sandbox: expect.objectContaining({+ environment_name: undefined,+ }),+ }),+ });+ });});diff --git a/packages/trueforge-ui/test/atoms/environments/EnvironmentFormDrawer.test.tsx b/packages/trueforge-ui/test/atoms/environments/EnvironmentFormDrawer.test.tsxnew file mode 100644index 000000000..dbecd4893--- /dev/null+++ b/packages/trueforge-ui/test/atoms/environments/EnvironmentFormDrawer.test.tsx@@ -0,0 +1,107 @@+// @vitest-environment jsdom+import { fireEvent, render, screen, waitFor } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import { EnvironmentFormDrawer } from '@/atoms/environments/EnvironmentFormDrawer.js';+import { ToasterProvider } from '@/containers/ToasterContainer.js';+import { ServerProvider } from '@/server/ServerContext.js';+import type { SandboxEnvironmentServer } from '@/server/types.js';+import { createMockAgentUIServer, createMockSandboxEnvironmentServer } from '../../server/mockServer.js';++const originalShowModal = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'showModal');+const originalClose = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'close');++beforeEach(() => {+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {+ configurable: true,+ value: function showModal(this: HTMLDialogElement) {+ this.open = true;+ },+ });+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {+ configurable: true,+ value: function close(this: HTMLDialogElement) {+ this.open = false;+ this.dispatchEvent(new Event('close'));+ },+ });+});++afterEach(() => {+ if (originalShowModal === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'showModal');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', originalShowModal);+ }+ if (originalClose === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'close');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'close', originalClose);+ }+});++function renderDrawer({+ environmentOverrides = {},+ onSaved = vi.fn(),+}: {+ environmentOverrides?: Partial<SandboxEnvironmentServer>;+ onSaved?: () => void;+} = {}) {+ const createOrUpdateEnvironment = vi.fn(async ({ manifest }) => ({+ id: 'e1',+ name: manifest.name,+ description: manifest.description ?? '',+ status: 'pending' as const,+ statusReason: null,+ manifest,+ createdBySubject: {+ subjectId: 'user-1',+ subjectType: 'user',+ subjectDisplayName: 'alice',+ },+ createdAt: '2024-01-01T00:00:00.000Z',+ updatedAt: '2024-01-01T00:00:00.000Z',+ }));+ const environmentServer = createMockSandboxEnvironmentServer({+ createOrUpdateEnvironment,+ ...environmentOverrides,+ });+ const server = createMockAgentUIServer({ sandboxEnvironments: environmentServer });+ const onOpenChange = vi.fn();++ render(+ <ServerProvider server={server}>+ <ToasterProvider>+ <EnvironmentFormDrawer open mode="create" onOpenChange={onOpenChange} onSaved={onSaved} />+ </ToasterProvider>+ </ServerProvider>,+ );++ return { createOrUpdateEnvironment, onOpenChange, onSaved };+}++describe('EnvironmentFormDrawer', () => {+ it('saves UI form values', async () => {+ const { createOrUpdateEnvironment, onSaved } = renderDrawer();+ const nameInput = screen.getByPlaceholderText('my-environment');+ fireEvent.change(nameInput, { target: { value: 'node-web' } });+ fireEvent.click(screen.getByRole('button', { name: 'Create' }));+ await waitFor(() => {+ expect(createOrUpdateEnvironment).toHaveBeenCalled();+ });+ expect(createOrUpdateEnvironment.mock.calls[0]?.[0]?.manifest.name).toBe('node-web');+ expect(onSaved).toHaveBeenCalled();+ });++ it('confirms when switching modes while dirty', async () => {+ renderDrawer();+ fireEvent.change(screen.getByPlaceholderText('my-environment'), { target: { value: 'dirty-env' } });+ fireEvent.click(screen.getByRole('button', { name: 'YAML' }));+ expect(await screen.findByRole('button', { name: 'Yes' })).toBeInTheDocument();+ fireEvent.click(screen.getByRole('button', { name: 'Yes' }));+ await waitFor(() => {+ expect(screen.queryByPlaceholderText('my-environment')).not.toBeInTheDocument();+ });+ expect(screen.queryByRole('button', { name: 'Yes' })).not.toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui/test/atoms/environments/EnvironmentsPage.test.tsx b/packages/trueforge-ui/test/atoms/environments/EnvironmentsPage.test.tsxnew file mode 100644index 000000000..3fbbc33d3--- /dev/null+++ b/packages/trueforge-ui/test/atoms/environments/EnvironmentsPage.test.tsx@@ -0,0 +1,212 @@+// @vitest-environment jsdom+import { act, render, screen, waitFor } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import { EnvironmentsPage, PENDING_ENVIRONMENTS_POLL_INTERVAL_MS } from '@/atoms/environments/EnvironmentsPage.js';+import { ToasterProvider } from '@/containers/ToasterContainer.js';+import { ServerProvider } from '@/server/ServerContext.js';+import { ShellModeProvider } from '@/server/ShellModeContext.js';+import type { SandboxEnvironment, SandboxEnvironmentServer } from '@/server/types.js';+import {+ createMockAgentUIServer,+ createMockCatalog,+ createMockSandboxEnvironmentServer,+} from '../../server/mockServer.js';++const sampleEnvironments: SandboxEnvironment[] = [+ {+ id: 'e1',+ name: 'python-data',+ description: 'Python with httpx',+ status: 'ready',+ statusReason: null,+ manifest: {+ name: 'python-data',+ description: 'Python with httpx',+ resources: { cpu: 2, memory: 4, disk: 10 },+ networking: { networkBlockAll: false, domainAllowList: 'api.example.com' },+ },+ createdBySubject: {+ subjectId: 'user-1',+ subjectType: 'user',+ subjectDisplayName: 'alice',+ },+ createdAt: '2024-01-01T00:00:00.000Z',+ updatedAt: '2024-01-02T00:00:00.000Z',+ },+];++const originalShowModal = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'showModal');+const originalClose = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'close');++beforeEach(() => {+ window.history.replaceState(null, '', '/environments');+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {+ configurable: true,+ value: function showModal(this: HTMLDialogElement) {+ this.open = true;+ },+ });+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {+ configurable: true,+ value: function close(this: HTMLDialogElement) {+ this.open = false;+ this.dispatchEvent(new Event('close'));+ },+ });+});++afterEach(() => {+ window.history.replaceState(null, '', '/');+ if (originalShowModal === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'showModal');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', originalShowModal);+ }+ if (originalClose === undefined) {+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'close');+ } else {+ Object.defineProperty(HTMLDialogElement.prototype, 'close', originalClose);+ }+});++function renderPage({+ environments = sampleEnvironments,+ providers = [{ id: 'daytona', name: 'Daytona', catalogId: 'daytona', isConnected: true }],+ environmentOverrides = {},+}: {+ environments?: SandboxEnvironment[];+ providers?: Array<{ id: string; name: string; catalogId: string; isConnected: boolean }>;+ environmentOverrides?: Partial<SandboxEnvironmentServer>;+} = {}) {+ const environmentServer = createMockSandboxEnvironmentServer({+ listEnvironments: vi.fn(async () => ({ data: environments })),+ ...environmentOverrides,+ });+ const catalog = createMockCatalog({+ sandboxCatalog: {+ getSandboxProviderCatalog: async () => [],+ listSandboxProviders: async () => providers,+ createSandboxProvider: vi.fn(),+ updateSandboxProvider: vi.fn(),+ },+ });+ const server = createMockAgentUIServer({+ catalog,+ sandboxEnvironments: environmentServer,+ });++ return render(+ <ServerProvider server={server}>+ <ShellModeProvider agentConfig={{ mode: 'AgentLibraryWithComposer' }}>+ <ToasterProvider>+ <EnvironmentsPage />+ </ToasterProvider>+ </ShellModeProvider>+ </ServerProvider>,+ );+}++describe('EnvironmentsPage', () => {+ it('shows configure-provider empty state when no sandbox provider exists', async () => {+ renderPage({ providers: [] });+ await waitFor(() => {+ expect(screen.getByText('Configure a sandbox provider first')).toBeInTheDocument();+ });+ expect(screen.getByRole('button', { name: 'Open Sandbox settings' })).toBeInTheDocument();+ });++ it('lists environments when a provider is configured', async () => {+ renderPage();+ await waitFor(() => {+ expect(screen.getByText('python-data')).toBeInTheDocument();+ });+ expect(screen.getByText('Python with httpx')).toBeInTheDocument();+ expect(screen.getByText('2 vCPU · 4 GB RAM · 10 GB disk')).toBeInTheDocument();+ expect(screen.getByText('1 allowed domain')).toBeInTheDocument();+ });++ it('opens create drawer from New Environment', async () => {+ renderPage();+ await waitFor(() => {+ expect(screen.getByRole('button', { name: /New Environment/i })).toBeEnabled();+ });+ screen.getByRole('button', { name: /New Environment/i }).click();+ await waitFor(() => {+ expect(screen.getByText('New environment')).toBeInTheDocument();+ });+ });++ it('polls pending environments using getEnvironment in the background', async () => {+ vi.useFakeTimers({ shouldAdvanceTime: true });+ const pendingEnv = {+ id: 'env-1',+ name: 'building-env',+ description: '',+ status: 'pending' as const,+ statusReason: null,+ manifest: { name: 'building-env' },+ createdBySubject: { subjectId: 'u1', subjectType: 'user', subjectDisplayName: 'user-1' },+ createdAt: '2026-09-01T10:00:00Z',+ updatedAt: '2026-09-01T10:00:00Z',+ };+ const listEnvironments = vi.fn(async () => ({+ data: [pendingEnv],+ }));+ const getEnvironment = vi.fn(async () => ({+ ...pendingEnv,+ status: 'ready' as const,+ }));++ try {+ renderPage({ environmentOverrides: { listEnvironments, getEnvironment } });+ await waitFor(() => {+ expect(screen.getByText('building-env')).toBeInTheDocument();+ });++ expect(getEnvironment).not.toHaveBeenCalled();++ await act(async () => {+ vi.advanceTimersByTime(PENDING_ENVIRONMENTS_POLL_INTERVAL_MS + 100);+ });++ expect(getEnvironment).toHaveBeenCalledWith({ name: 'building-env' });+ } finally {+ vi.useRealTimers();+ }+ });++ it('displays error message when listing providers throws an error', async () => {+ const listSandboxProviders = vi.fn(async () => {+ throw new Error('Network timeout fetching providers');+ });+ const catalog = createMockCatalog({+ sandboxCatalog: {+ getSandboxProviderCatalog: async () => [],+ listSandboxProviders,+ createSandboxProvider: vi.fn(),+ updateSandboxProvider: vi.fn(),+ },+ });+ const environmentServer = createMockSandboxEnvironmentServer();+ const server = createMockAgentUIServer({+ catalog,+ sandboxEnvironments: environmentServer,+ });++ render(+ <ServerProvider server={server}>+ <ShellModeProvider agentConfig={{ mode: 'AgentLibraryWithComposer' }}>+ <ToasterProvider>+ <EnvironmentsPage />+ </ToasterProvider>+ </ShellModeProvider>+ </ServerProvider>,+ );++ await waitFor(() => {+ expect(screen.getByText('Network timeout fetching providers')).toBeInTheDocument();+ });+ expect(screen.queryByText('Configure a sandbox provider first')).not.toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui/test/atoms/environments/environmentYaml.test.ts b/packages/trueforge-ui/test/atoms/environments/environmentYaml.test.tsnew file mode 100644index 000000000..2526d8895--- /dev/null+++ b/packages/trueforge-ui/test/atoms/environments/environmentYaml.test.ts@@ -0,0 +1,27 @@+import { describe, expect, it } from 'vitest';++import { manifestToYaml, parseManifestYaml } from '@/atoms/environments/environmentYaml.js';++describe('environmentYaml', () => {+ it('round-trips a manifest', () => {+ const yaml = manifestToYaml({+ name: 'yaml-env',+ description: 'from yaml',+ resources: { cpu: 2, memory: 2, disk: 5 },+ });+ const parsed = parseManifestYaml(yaml);+ expect(parsed).toEqual({+ manifest: {+ name: 'yaml-env',+ description: 'from yaml',+ resources: { cpu: 2, memory: 2, disk: 5 },+ },+ });+ });++ it('rejects reserved default name and invalid YAML', () => {+ expect(parseManifestYaml('name: default\n')).toEqual({ error: 'Name "default" is reserved' });+ expect(parseManifestYaml('name: ')).toMatchObject({ error: expect.any(String) });+ expect(parseManifestYaml('- just a list')).toEqual({ error: 'YAML must be an object manifest' });+ });+});diff --git a/packages/trueforge-ui/test/atoms/environments/useReadySandboxEnvironments.test.tsx b/packages/trueforge-ui/test/atoms/environments/useReadySandboxEnvironments.test.tsxnew file mode 100644index 000000000..899863b79--- /dev/null+++ b/packages/trueforge-ui/test/atoms/environments/useReadySandboxEnvironments.test.tsx@@ -0,0 +1,124 @@+// @vitest-environment jsdom+import { act, renderHook, waitFor } from '@testing-library/react';+import type { ReactNode } from 'react';+import { describe, expect, it, vi } from 'vitest';++import { useReadySandboxEnvironments } from '@/atoms/environments/useReadySandboxEnvironments.js';+import { ServerProvider } from '@/server/ServerContext.js';+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';+import type { SandboxEnvironment } from '@/server/types.js';+import { createMockAgentUIServer, createMockSandboxEnvironmentServer } from '../../server/mockServer.js';++const readyEnv: SandboxEnvironment = {+ id: 'e1',+ name: 'python-data',+ description: 'Python',+ status: 'ready',+ statusReason: null,+ manifest: { name: 'python-data', description: 'Python' },+ createdBySubject: {+ subjectId: 'user-1',+ subjectType: 'user',+ subjectDisplayName: 'alice',+ },+ createdAt: '2024-01-01T00:00:00.000Z',+ updatedAt: '2024-01-02T00:00:00.000Z',+};++const pendingEnv: SandboxEnvironment = {+ ...readyEnv,+ id: 'e2',+ name: 'pending-env',+ status: 'pending',+ manifest: { name: 'pending-env', description: 'Building' },+};++describe('useReadySandboxEnvironments', () => {+ it('filters to ready environments and refetches when the catalog epoch bumps', async () => {+ const listEnvironments = vi+ .fn()+ .mockResolvedValueOnce({ data: [readyEnv, pendingEnv] })+ .mockResolvedValueOnce({+ data: [+ readyEnv,+ { ...pendingEnv, status: 'ready' as const },+ {+ ...readyEnv,+ id: 'e3',+ name: 'new-ready',+ status: 'ready' as const,+ manifest: { name: 'new-ready', description: 'New' },+ },+ ],+ });+ const server = createMockAgentUIServer({+ sandboxEnvironments: createMockSandboxEnvironmentServer({ listEnvironments }),+ });++ function wrapper({ children }: { children: ReactNode }) {+ return (+ <ServerProvider server={server}>+ <ShellModeProvider>{children}</ShellModeProvider>+ </ServerProvider>+ );+ }++ const { result } = renderHook(+ () => ({+ ready: useReadySandboxEnvironments(),+ shell: useShellMode(),+ }),+ { wrapper },+ );++ await waitFor(() => {+ expect(result.current.ready.loading).toBe(false);+ });+ expect(result.current.ready.environments.map(e => e.name)).toEqual(['python-data']);+ expect(listEnvironments).toHaveBeenCalledTimes(1);++ act(() => result.current.shell.invalidateEnvironmentsList());++ await waitFor(() => {+ expect(listEnvironments).toHaveBeenCalledTimes(2);+ expect(result.current.ready.loading).toBe(false);+ expect(result.current.ready.environments.map(e => e.name).sort()).toEqual([+ 'new-ready',+ 'pending-env',+ 'python-data',+ ]);+ });+ });++ it('drains multiple pages of environments using limit: 1000', async () => {+ const page1Env = { ...readyEnv, id: 'e1', name: 'env-page-1' };+ const page2Env = { ...readyEnv, id: 'e2', name: 'env-page-2' };+ const listEnvironments = vi+ .fn()+ .mockResolvedValueOnce({ data: [page1Env], nextPageToken: 'token-page-2' })+ .mockResolvedValueOnce({ data: [page2Env] });++ const server = createMockAgentUIServer({+ sandboxEnvironments: createMockSandboxEnvironmentServer({ listEnvironments }),+ });++ function wrapper({ children }: { children: ReactNode }) {+ return (+ <ServerProvider server={server}>+ <ShellModeProvider agentConfig={{ mode: 'AgentLibraryWithComposer' }}>{children}</ShellModeProvider>+ </ServerProvider>+ );+ }++ const { result } = renderHook(() => useReadySandboxEnvironments(), { wrapper });++ await waitFor(() => {+ expect(result.current.loading).toBe(false);+ });++ expect(listEnvironments).toHaveBeenCalledTimes(2);+ expect(listEnvironments).toHaveBeenNthCalledWith(1, { limit: 1000, pageToken: undefined });+ expect(listEnvironments).toHaveBeenNthCalledWith(2, { limit: 1000, pageToken: 'token-page-2' });+ expect(result.current.environments.map(e => e.name)).toEqual(['env-page-1', 'env-page-2']);+ });+});diff --git a/packages/trueforge-ui/test/atoms/lib/dateFormat.test.ts b/packages/trueforge-ui/test/atoms/lib/dateFormat.test.tsindex ba189d590..93ca7e83a 100644--- a/packages/trueforge-ui/test/atoms/lib/dateFormat.test.ts+++ b/packages/trueforge-ui/test/atoms/lib/dateFormat.test.ts@@ -1,6 +1,6 @@import { describe, expect, it } from 'vitest';-import { formatAbsoluteDateTime } from '@/atoms/lib/dateFormat.js';+import { formatAbsoluteDateTime, formatRelativeTime } from '@/atoms/lib/dateFormat.js';describe('formatAbsoluteDateTime', () => {it('formats with the shared absolute date+time options', () => {@@ -17,3 +17,22 @@ describe('formatAbsoluteDateTime', () => {);});});++describe('formatRelativeTime', () => {+ const now = 1_000_000_000;++ it('handles null and invalid dates with custom or default fallback', () => {+ expect(formatRelativeTime(null)).toBe('—');+ expect(formatRelativeTime(null, { fallback: 'Never' })).toBe('Never');+ expect(formatRelativeTime('invalid-date')).toBe('—');+ expect(formatRelativeTime('invalid-date', { fallback: 'Never' })).toBe('Never');+ });++ it('formats seconds, minutes, hours, and days relative to now', () => {+ expect(formatRelativeTime(new Date(now - 30_000).toISOString(), { nowMs: now })).toBe('just now');+ expect(formatRelativeTime(new Date(now - 5 * 60_000).toISOString(), { nowMs: now })).toBe('5 min ago');+ expect(formatRelativeTime(new Date(now - 60 * 60_000).toISOString(), { nowMs: now })).toBe('1 hour ago');+ expect(formatRelativeTime(new Date(now - 5 * 3600_000).toISOString(), { nowMs: now })).toBe('5 hours ago');+ expect(formatRelativeTime(new Date(now - 2 * 86400_000).toISOString(), { nowMs: now })).toBe('2 days ago');+ });+});diff --git a/packages/trueforge-ui/test/atoms/primitives/Badge.test.tsx b/packages/trueforge-ui/test/atoms/primitives/Badge.test.tsxnew file mode 100644index 000000000..d04817661--- /dev/null+++ b/packages/trueforge-ui/test/atoms/primitives/Badge.test.tsx@@ -0,0 +1,38 @@+import { render, screen } from '@testing-library/react';+import { describe, expect, it } from 'vitest';++import { Badge } from '@/atoms/primitives/Badge.js';++describe('Badge', () => {+ it('renders with default variant and children', () => {+ render(<Badge>Default</Badge>);+ const badge = screen.getByText('Default');+ expect(badge).toBeInTheDocument();+ expect(badge).toHaveAttribute('data-variant', 'default');+ expect(badge).toHaveAttribute('data-shape', 'rounded');+ expect(badge).toHaveAttribute('data-size', 'sm');+ });++ it('renders with specified variant, shape, and size', () => {+ render(+ <Badge variant="success" shape="pill" size="md">+ Active+ </Badge>,+ );+ const badge = screen.getByText('Active');+ expect(badge).toHaveAttribute('data-variant', 'success');+ expect(badge).toHaveAttribute('data-shape', 'pill');+ expect(badge).toHaveAttribute('data-size', 'md');+ });++ it('renders a status dot when dot is true', () => {+ const { container } = render(+ <Badge variant="warning" dot>+ Paused+ </Badge>,+ );+ expect(screen.getByText('Paused')).toBeInTheDocument();+ const dot = container.querySelector('.rounded-full.size-1\\.5');+ expect(dot).toBeInTheDocument();+ });+});diff --git a/packages/trueforge-ui/test/containers/ThreadListContainer.pagination.test.tsx b/packages/trueforge-ui/test/containers/ThreadListContainer.pagination.test.tsxindex df52353df..64ec10ccb 100644--- a/packages/trueforge-ui/test/containers/ThreadListContainer.pagination.test.tsx+++ b/packages/trueforge-ui/test/containers/ThreadListContainer.pagination.test.tsx@@ -83,6 +83,7 @@ vi.mock('@/server/ServerContext.js', () => ({useOptionalAgentSessionsServer: () => null,useOptionalPermissionsServer: () => null,useOptionalScheduleServer: () => null,+ useOptionalSandboxEnvironmentServer: () => null,}));vi.mock('@/server/ShellModeContext.js', () => ({@@ -102,6 +103,7 @@ vi.mock('@/server/ShellModeContext.js', () => ({setLibraryOpen: vi.fn(),setSchedulesOpen,setSessionsOpen,+ setEnvironmentsOpen: vi.fn(),selectLibraryAgent: vi.fn(),openDraft: vi.fn(),openAgentBuilder: vi.fn(),diff --git a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/sandboxEnvironmentServer.test.ts b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/sandboxEnvironmentServer.test.tsnew file mode 100644index 000000000..ee20207d7--- /dev/null+++ b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/sandboxEnvironmentServer.test.ts@@ -0,0 +1,120 @@+import { describe, expect, it, vi } from 'vitest';++import { createSandboxEnvironmentServer } from '@/plugins/trueforge-agent-server-adapter/sandboxEnvironments/sandboxEnvironmentServer.js';+import type { TrueForge } from '@truefoundry/trueforge-sdk';++function mockClient(+ overrides: {+ list?: ReturnType<typeof vi.fn>;+ createOrUpdate?: ReturnType<typeof vi.fn>;+ delete?: ReturnType<typeof vi.fn>;+ } = {},+): TrueForge {+ const list =+ overrides.list ??+ vi.fn(async () => ({+ data: [+ {+ id: 'e1',+ name: 'python-data',+ description: 'Python with httpx',+ lifecycleStage: 'active' as const,+ status: 'ready' as const,+ statusReason: null,+ createdAt: new Date('2024-01-01T00:00:00.000Z'),+ updatedAt: new Date('2024-01-02T00:00:00.000Z'),+ createdBySubject: {+ subjectId: 'user-1',+ subjectType: 'user',+ subjectDisplayName: '[email protected]',+ },+ manifest: {+ name: 'python-data',+ description: 'Python with httpx',+ resources: { cpu: 2, memory: 4, disk: 10 },+ networking: { networkBlockAll: false, domainAllowList: 'api.example.com' },+ },+ },+ ],+ response: { pagination: { limit: 25, nextPageToken: 'next-1' } },+ hasNextPage: () => true,+ getNextPage: async () => undefined,+ }));++ return {+ sandboxEnvironments: {+ list,+ get: vi.fn(),+ createOrUpdate:+ overrides.createOrUpdate ??+ vi.fn(async () => ({+ data: {+ id: 'e2',+ name: 'node-web',+ description: '',+ lifecycleStage: 'active' as const,+ status: 'pending' as const,+ statusReason: null,+ createdAt: new Date('2024-01-01T00:00:00.000Z'),+ updatedAt: new Date('2024-01-01T00:00:00.000Z'),+ createdBySubject: {+ subjectId: 'user-1',+ subjectType: 'user',+ subjectDisplayName: '[email protected]',+ },+ manifest: { name: 'node-web', resources: { cpu: 1, memory: 1, disk: 3 } },+ },+ })),+ delete: overrides.delete ?? vi.fn(async () => ({})),+ },+ } as unknown as TrueForge;+}++describe('createSandboxEnvironmentServer', () => {+ it('lists environments with pagination tokens', async () => {+ const client = mockClient();+ const server = createSandboxEnvironmentServer({ client });+ const page = await server.listEnvironments({ limit: 10 });+ expect(client.sandboxEnvironments.list).toHaveBeenCalledWith({ limit: 10 });+ expect(page.data).toHaveLength(1);+ expect(page.data[0]?.name).toBe('python-data');+ expect(page.data[0]?.manifest.resources?.cpu).toBe(2);+ expect(page.nextPageToken).toBe('next-1');++ await server.listEnvironments({ limit: 1000 });+ expect(client.sandboxEnvironments.list).toHaveBeenCalledWith({ limit: 1000 });+ });++ it('createOrUpdate and delete call SDK methods', async () => {+ const createOrUpdate = vi.fn(async () => ({+ data: {+ id: 'e2',+ name: 'node-web',+ description: '',+ lifecycleStage: 'active' as const,+ status: 'pending' as const,+ statusReason: null,+ createdAt: new Date('2024-01-01T00:00:00.000Z'),+ updatedAt: new Date('2024-01-01T00:00:00.000Z'),+ createdBySubject: {+ subjectId: 'user-1',+ subjectType: 'user',+ subjectDisplayName: '[email protected]',+ },+ manifest: { name: 'node-web' },+ },+ }));+ const del = vi.fn(async () => ({}));+ const client = mockClient({ createOrUpdate, delete: del });+ const server = createSandboxEnvironmentServer({ client });+ const saved = await server.createOrUpdateEnvironment({+ manifest: { name: 'node-web', resources: { cpu: 1, memory: 1, disk: 3 } },+ });+ expect(saved.name).toBe('node-web');+ expect(createOrUpdate).toHaveBeenCalledWith({+ manifest: { name: 'node-web', resources: { cpu: 1, memory: 1, disk: 3 } },+ });+ await server.deleteEnvironment({ name: 'node-web' });+ expect(del).toHaveBeenCalledWith('node-web');+ });+});diff --git a/packages/trueforge-ui/test/publicUiExports.test.ts b/packages/trueforge-ui/test/publicUiExports.test.tsindex 09435c45d..d8b6f70ec 100644--- a/packages/trueforge-ui/test/publicUiExports.test.ts+++ b/packages/trueforge-ui/test/publicUiExports.test.ts@@ -47,6 +47,7 @@ const expectedRuntimeExports: Array<keyof typeof sdk> = ['Avatar','AvatarFallback','AvatarImage',+ 'Badge','BottomSheet','BrandLogo','Button',@@ -76,6 +77,8 @@ const expectedRuntimeExports: Array<keyof typeof sdk> = ['DraftComposerRightSection','DraftCompositeSelector','DraftModelSelector',+ 'EnvironmentsButton',+ 'EnvironmentsPage','ToasterProvider','HistoryLoader','HistoryLoaderContainer',diff --git a/packages/trueforge-ui/test/routing/ShellRouteSync.test.tsx b/packages/trueforge-ui/test/routing/ShellRouteSync.test.tsxindex 6acb84100..3a06a4618 100644--- a/packages/trueforge-ui/test/routing/ShellRouteSync.test.tsx+++ b/packages/trueforge-ui/test/routing/ShellRouteSync.test.tsx@@ -12,6 +12,7 @@ import {createMockAgentSessionsServer,createMockAgentUIServer,createMockCatalog,+ createMockSandboxEnvironmentServer,createMockScheduleServer,} from '../server/mockServer.js';@@ -47,6 +48,7 @@ function SettingsCatalogProvider({includeCatalog = true,includeSessions = true,includeSchedules = false,+ includeEnvironments = false,getSession,}: {children: ReactNode;@@ -55,6 +57,7 @@ function SettingsCatalogProvider({includeCatalog?: boolean;includeSessions?: boolean;includeSchedules?: boolean;+ includeEnvironments?: boolean;getSession?: (req: { sessionId: string }) => Promise<{id: string;title: string;@@ -68,6 +71,7 @@ function SettingsCatalogProvider({...(includeCatalog ? { catalog: createMockCatalog() } : {}),...(includeSessions ? { sessions: createMockAgentSessionsServer() } : {}),...(includeSchedules ? { schedules: createMockScheduleServer() } : {}),+ ...(includeEnvironments ? { sandboxEnvironments: createMockSandboxEnvironmentServer() } : {}),getCapabilities: async () => {if (capabilitiesFail) throw new Error('Unavailable');return {@@ -102,6 +106,7 @@ function Harness({includeCatalog = true,includeSessions = true,includeSchedules = false,+ includeEnvironments = false,getSession,onError,}: {@@ -113,6 +118,7 @@ function Harness({includeCatalog?: boolean;includeSessions?: boolean;includeSchedules?: boolean;+ includeEnvironments?: boolean;getSession?: (req: { sessionId: string }) => Promise<{id: string;title: string;@@ -132,6 +138,7 @@ function Harness({includeCatalog={includeCatalog}includeSessions={includeSessions}includeSchedules={includeSchedules}+ includeEnvironments={includeEnvironments}getSession={getSession}><ShellModeProvider agentConfig={agentConfig} initialSettingsOpen={initialSettingsOpen}>@@ -157,6 +164,7 @@ function renderSync(opts: {includeCatalog?: boolean;includeSessions?: boolean;includeSchedules?: boolean;+ includeEnvironments?: boolean;getSession?: (req: { sessionId: string }) => Promise<{id: string;title: string;@@ -178,6 +186,7 @@ function renderSync(opts: {includeCatalog={opts.includeCatalog}includeSessions={opts.includeSessions}includeSchedules={opts.includeSchedules}+ includeEnvironments={opts.includeEnvironments}getSession={opts.getSession}onError={opts.onError}/>@@ -544,6 +553,32 @@ describe('ShellRouteSync', () => {expect(pathname).toBe('/schedules');});+ it('unregisters /environments when sandboxEnvironments port is missing', async () => {+ renderSync({+ initialEntries: ['/environments'],+ agentConfig: { mode: 'AgentLibraryWithComposer' },+ includeEnvironments: false,+ });+ await waitFor(() => {+ expect(shell.environmentsOpen).toBe(false);+ expect(pathname).toBe('/');+ });+ act(() => shell.setEnvironmentsOpen(true));+ expect(shell.environmentsOpen).toBe(false);+ expect(pathname).toBe('/');+ });++ it('mirrors environments open through history when sandboxEnvironments port is present', () => {+ renderSync({+ initialEntries: ['/'],+ agentConfig: { mode: 'AgentLibraryWithComposer' },+ includeEnvironments: true,+ });+ act(() => shell.setEnvironmentsOpen(true));+ expect(shell.environmentsOpen).toBe(true);+ expect(pathname).toBe('/environments');+ });+it('returns to the chat place when a /library deep link is closed', () => {renderSync({ initialEntries: ['/library'], agentConfig: { mode: 'AgentLibraryWithComposer' } });expect(shell.libraryOpen).toBe(true);diff --git a/packages/trueforge-ui/test/routing/derivePlace.test.ts b/packages/trueforge-ui/test/routing/derivePlace.test.tsindex e8c924652..e827f6887 100644--- a/packages/trueforge-ui/test/routing/derivePlace.test.ts+++ b/packages/trueforge-ui/test/routing/derivePlace.test.ts@@ -11,6 +11,7 @@ function snap(partial: Partial<ShellSnapshot>): ShellSnapshot {sharedSessionId: null,libraryAgentId: null,schedulesOpen: false,+ environmentsOpen: false,mode: { status: 'idle' },agentConfigMode: 'AgentLibraryWithComposer',...partial,@@ -56,6 +57,16 @@ describe('derivePlace', () => {expect(derivePlace(snap({ settingsOpen: true, schedulesOpen: true }))).toEqual({ type: 'settings' });});+ it('environments overlay wins over chat when settings/schedules are closed', () => {+ expect(derivePlace(snap({ environmentsOpen: true, pendingSessionId: 'abc' }))).toEqual({+ type: 'environments',+ });+ });++ it('schedules wins over environments when both are open', () => {+ expect(derivePlace(snap({ schedulesOpen: true, environmentsOpen: true }))).toEqual({ type: 'schedules' });+ });+it('pendingSessionId maps to a session while no thread has reported yet', () => {expect(derivePlace(snap({ pendingSessionId: 'abc' }))).toEqual({ type: 'session', sessionId: 'abc' });});diff --git a/packages/trueforge-ui/test/routing/paths.test.ts b/packages/trueforge-ui/test/routing/paths.test.tsindex b09f27792..c78be5463 100644--- a/packages/trueforge-ui/test/routing/paths.test.ts+++ b/packages/trueforge-ui/test/routing/paths.test.ts@@ -20,6 +20,7 @@ describe('resolveRoutesConfig', () => {library: '/library',libraryAgent: '/library/:agentId',schedules: '/schedules',+ environments: '/environments',buildAgent: '/build-agent',agent: '/agents/:agentName',session: '/sessions/:sessionId',@@ -57,6 +58,7 @@ describe('buildPath', () => {expect(buildPath({ type: 'library' }, routes)).toBe('/library');expect(buildPath({ type: 'libraryAgent', agentId: 'agent/id' }, routes)).toBe('/library/agent%2Fid');expect(buildPath({ type: 'schedules' }, routes)).toBe('/schedules');+ expect(buildPath({ type: 'environments' }, routes)).toBe('/environments');expect(buildPath({ type: 'buildAgent' }, routes)).toBe('/build-agent');expect(buildPath({ type: 'agent', agentName: 'code-helper' }, routes)).toBe('/agents/code-helper');expect(buildPath({ type: 'session', sessionId: 'abc123' }, routes)).toBe('/sessions/abc123');@@ -166,6 +168,7 @@ describe('matchPath', () => {expect(matchPath('/library', routes)).toEqual({ type: 'library' });expect(matchPath('/library/agent%2Fid', routes)).toEqual({ type: 'libraryAgent', agentId: 'agent/id' });expect(matchPath('/schedules', routes)).toEqual({ type: 'schedules' });+ expect(matchPath('/environments', routes)).toEqual({ type: 'environments' });expect(matchPath('/build-agent', routes)).toEqual({ type: 'buildAgent' });expect(matchPath('/agents/a%2Fb', routes)).toEqual({ type: 'agent', agentName: 'a/b' });expect(matchPath('/sessions', routes)).toEqual({ type: 'sessionsBrowser' });@@ -197,6 +200,7 @@ describe('matchPath', () => {{ type: 'library' as const },{ type: 'libraryAgent' as const, agentId: 'agent id/1' },{ type: 'schedules' as const },+ { type: 'environments' as const },{ type: 'buildAgent' as const },{ type: 'agent' as const, agentName: 'weird name/1' },{ type: 'session' as const, sessionId: 'sess 9' },diff --git a/packages/trueforge-ui/test/server/ShellModeContext.test.tsx b/packages/trueforge-ui/test/server/ShellModeContext.test.tsxindex 882f9d284..ca8744336 100644--- a/packages/trueforge-ui/test/server/ShellModeContext.test.tsx+++ b/packages/trueforge-ui/test/server/ShellModeContext.test.tsx@@ -699,6 +699,13 @@ describe('ShellModeProvider', () => {expect(result.current.agentsListEpoch).toBe(1);});+ it('invalidateEnvironmentsList bumps environmentsListEpoch', () => {+ const { result } = renderHook(() => useShellMode(), { wrapper: wrap() });+ expect(result.current.environmentsListEpoch).toBe(0);+ act(() => result.current.invalidateEnvironmentsList());+ expect(result.current.environmentsListEpoch).toBe(1);+ });+it('bindMutableAgent attaches identity without remounting', () => {const { result } = renderHook(() => useShellMode(), {wrapper: wrap({ mode: 'AgentLibraryWithComposer' }),diff --git a/packages/trueforge-ui/test/server/mockServer.ts b/packages/trueforge-ui/test/server/mockServer.tsindex 40afae97f..4922d473a 100644--- a/packages/trueforge-ui/test/server/mockServer.ts+++ b/packages/trueforge-ui/test/server/mockServer.ts@@ -3,6 +3,7 @@ import type {AgentSessionsServer,AgentUIServer,CatalogServer,+ SandboxEnvironmentServer,ScheduleServer,} from '@/server/types.js';@@ -57,6 +58,18 @@ export function createMockScheduleServer(overrides: Partial<ScheduleServer> = {}};}+export function createMockSandboxEnvironmentServer(+ overrides: Partial<SandboxEnvironmentServer> = {},+): SandboxEnvironmentServer {+ return {+ listEnvironments: async () => ({ data: [] }),+ getEnvironment: unavailable,+ createOrUpdateEnvironment: unavailable,+ deleteEnvironment: unavailable,+ ...overrides,+ };+}+export function createMockAgentMetricsServer(overrides: Partial<AgentMetricsServer> = {}): AgentMetricsServer {return {getCharts: async () => [],diff --git a/packages/trueforge-ui/test/server/serverChrome.test.ts b/packages/trueforge-ui/test/server/serverChrome.test.tsindex 195df9b34..6d5a7b074 100644--- a/packages/trueforge-ui/test/server/serverChrome.test.ts+++ b/packages/trueforge-ui/test/server/serverChrome.test.ts@@ -2,6 +2,7 @@ import { describe, expect, it } from 'vitest';import { resolveRoutesConfig } from '@/routing/paths.js';import {+ isEnvironmentsChromeEnabled,isMetricsChromeEnabled,isSchedulesChromeEnabled,isSessionsChromeEnabled,@@ -12,6 +13,7 @@ import {createMockAgentMetricsServer,createMockAgentSessionsServer,createMockCatalog,+ createMockSandboxEnvironmentServer,createMockScheduleServer,} from './mockServer.js';@@ -19,6 +21,7 @@ describe('serverChrome', () => {const catalog = createMockCatalog();const sessions = createMockAgentSessionsServer();const schedules = createMockScheduleServer();+ const sandboxEnvironments = createMockSandboxEnvironmentServer();const metrics = createMockAgentMetricsServer();const routes = resolveRoutesConfig();@@ -40,11 +43,13 @@ describe('serverChrome', () => {).toBe(false);});- it('gates sessions / schedules / metrics on port presence', () => {+ it('gates sessions / schedules / environments / metrics on port presence', () => {expect(isSessionsChromeEnabled({ sessions: null })).toBe(false);expect(isSessionsChromeEnabled({ sessions })).toBe(true);expect(isSchedulesChromeEnabled({ schedules: null })).toBe(false);expect(isSchedulesChromeEnabled({ schedules })).toBe(true);+ expect(isEnvironmentsChromeEnabled({ sandboxEnvironments: null })).toBe(false);+ expect(isEnvironmentsChromeEnabled({ sandboxEnvironments })).toBe(true);expect(isMetricsChromeEnabled({ metrics: null })).toBe(false);expect(isMetricsChromeEnabled({ metrics })).toBe(true);});@@ -56,12 +61,14 @@ describe('serverChrome', () => {capabilities: null,sessions: null,schedules: null,+ sandboxEnvironments: null,});expect(disabled.settings).toBeNull();expect(disabled.sessionsBrowser).toBeNull();expect(disabled.sharedSession).toBeNull();expect(disabled.libraryAgent).toBeNull();expect(disabled.schedules).toBeNull();+ expect(disabled.environments).toBeNull();expect(disabled.root).toBe('/');expect(disabled.library).toBe('/library');@@ -71,11 +78,13 @@ describe('serverChrome', () => {capabilities: { settings: { enabled: true } },sessions,schedules,+ sandboxEnvironments,});expect(enabled.settings).toBe('/settings');expect(enabled.sessionsBrowser).toBe('/sessions');expect(enabled.sharedSession).toBe('/sessions/share/:sessionId');expect(enabled.libraryAgent).toBe('/library/:agentId');expect(enabled.schedules).toBe('/schedules');+ expect(enabled.environments).toBe('/environments');});});diff --git a/packages/trueforge-ui/test/utils/environmentShareUrl.test.ts b/packages/trueforge-ui/test/utils/environmentShareUrl.test.tsnew file mode 100644index 000000000..ca2a9dc49--- /dev/null+++ b/packages/trueforge-ui/test/utils/environmentShareUrl.test.ts@@ -0,0 +1,29 @@+import { describe, expect, it } from 'vitest';++import {+ clearEnvironmentShareSearch,+ readEnvironmentShareSearch,+ writeEnvironmentShareSearch,+} from '@/utils/environmentShareUrl.js';++describe('environmentShareUrl', () => {+ it('reads envQ and envIsNew', () => {+ expect(readEnvironmentShareSearch('?envQ=python&envIsNew=true')).toEqual({+ q: 'python',+ isNew: true,+ });+ expect(readEnvironmentShareSearch('')).toEqual({ q: null, isNew: false });+ });++ it('writes and clears share keys', () => {+ const params = new URLSearchParams('keep=1');+ writeEnvironmentShareSearch(params, { q: 'node', isNew: true });+ expect(params.get('envQ')).toBe('node');+ expect(params.get('envIsNew')).toBe('true');+ expect(params.get('keep')).toBe('1');+ clearEnvironmentShareSearch(params);+ expect(params.get('envQ')).toBeNull();+ expect(params.get('envIsNew')).toBeNull();+ expect(params.get('keep')).toBe('1');+ });+});diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex dbebcb884..220ed491b 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -459,6 +459,9 @@ importers:thinking-orbs:specifier: ^0.3.1version: 0.3.2([email protected])+ yaml:+ specifier: ^2.9.0+ version: 2.9.1zod:specifier: ^4.4.3version: 4.6.5