The open-source agent harness - the runtime layer that turns an LLM into a working agent.
chore: Preload Monaco editor on UI shell mount for improved performance (#791)
harshil-2096a273ed897b41
diff --git a/.changeset/monaco-shell-preload.md b/.changeset/monaco-shell-preload.mdnew file mode 100644index 000000000..94503b3b5--- /dev/null+++ b/.changeset/monaco-shell-preload.md@@ -0,0 +1,5 @@+---+'@truefoundry/trueforge-ui': patch+---++Preload Monaco when the UI shell mounts so tool request/response editors open faster.diff --git a/packages/frontend/src/publicPath.ts b/packages/frontend/src/publicPath.tsindex 8db061161..d78ee8206 100644--- a/packages/frontend/src/publicPath.ts+++ b/packages/frontend/src/publicPath.ts@@ -66,11 +66,11 @@ export function installMonacoWorkerPublicPath(): void {if (typeof window === 'undefined') {return;}- const previous = window.MonacoEnvironment?.getWorkerUrl;+ const previousEnvironment = window.MonacoEnvironment;window.MonacoEnvironment = {- ...window.MonacoEnvironment,+ ...previousEnvironment,getWorkerUrl(moduleId: string, label: string) {- const raw = previous?.call(window.MonacoEnvironment, moduleId, label);+ const raw = previousEnvironment?.getWorkerUrl?.(moduleId, label);if (typeof raw === 'string' && raw.length > 0) {return monacoWorkerUrl(raw);}diff --git a/packages/trueforge-ui/src/atoms/MonacoEditorCore.tsx b/packages/trueforge-ui/src/atoms/MonacoEditorCore.tsxindex 357ce21a8..2cc020f6d 100644--- a/packages/trueforge-ui/src/atoms/MonacoEditorCore.tsx+++ b/packages/trueforge-ui/src/atoms/MonacoEditorCore.tsx@@ -4,6 +4,7 @@ import { useEffect, useRef, useState } from 'react';import { useOptionalContentClassNames, useOptionalThemeMode } from '../theme/ThemeProvider.js';import { cn } from './lib/cn.js';+import { preloadMonaco } from './monacoPreload.js';export type MonacoEditorCoreProps = {value: string;@@ -210,7 +211,7 @@ export function MonacoEditorCore({let sizeDisposable: { dispose(): void } | null = null;let destroyed = false;- void import('monaco-editor').then(mod => {+ void preloadMonaco().then(mod => {if (destroyed || !containerRef.current) return;const monaco = mod as unknown as MonacoModule;diff --git a/packages/trueforge-ui/src/atoms/monacoPreload.ts b/packages/trueforge-ui/src/atoms/monacoPreload.tsnew file mode 100644index 000000000..596505ef5--- /dev/null+++ b/packages/trueforge-ui/src/atoms/monacoPreload.ts@@ -0,0 +1,13 @@+/** Shared dynamic import so shell preload and editors race the same promise. */+let monacoImportPromise: Promise<typeof import('monaco-editor')> | undefined;++/** Start loading Monaco without mounting an editor. Safe to call repeatedly. */+export function preloadMonaco(): Promise<typeof import('monaco-editor')> {+ monacoImportPromise ??= import('monaco-editor');+ return monacoImportPromise;+}++/** Test-only: clear the cached import so preload can be re-exercised. */+export function resetMonacoPreloadForTests(): void {+ monacoImportPromise = undefined;+}diff --git a/packages/trueforge-ui/src/containers/TrueForgeUIShell.tsx b/packages/trueforge-ui/src/containers/TrueForgeUIShell.tsxindex 34b525724..ca8309399 100644--- a/packages/trueforge-ui/src/containers/TrueForgeUIShell.tsx+++ b/packages/trueforge-ui/src/containers/TrueForgeUIShell.tsx@@ -1,7 +1,7 @@'use client';import type { TrueFoundryAgentConfig, UseTrueFoundryAgentRuntimeOptions } from '@truefoundry/assistant-ui-runtime';-import { lazy, Suspense, useCallback, useMemo, useState, type ReactNode } from 'react';+import { lazy, Suspense, useCallback, useEffect, useMemo, useState, type ReactNode } from 'react';import { ThinkingOrb } from 'thinking-orbs';import { AgentConfigInstructionsProvider } from '../atoms/draft/AgentConfigInstructionsContext.js';@@ -9,6 +9,7 @@ import { DraftCatalogProvider } from '../atoms/draft/DraftCatalogProvider.js';import { DraftSpecPreferenceBridge } from '../atoms/draft/DraftSpecPreferenceBridge.js';import { cn } from '../atoms/lib/cn.js';import { IS_CREATE_AGENT_METADATA_KEY, isCreateAgentMetadataValue } from '../atoms/lib/sessionCreateAgent.js';+import { preloadMonaco } from '../atoms/monacoPreload.js';import { CurrentUserProvider, type CurrentUser } from '../contexts/CurrentUserContext.js';import { WidgetVisibilityProvider } from '../layouts/WidgetVisibilityContext.js';import { HistorySessionSwitchBridge } from '../routing/HistorySessionSwitchBridge.js';@@ -290,6 +291,11 @@ export function TrueForgeUIShell(props: TrueForgeUIShellProps) {const [activeRemoteId, setActiveRemoteId] = useState<string | undefined>(undefined);const handleRemoteIdChange = useCallback((id: string | undefined) => setActiveRemoteId(id), []);+ // Warm Monaco while the shell boots so tool request/response cards paint faster.+ useEffect(() => {+ void preloadMonaco();+ }, []);+if (resolved.status === 'loading') {return (<SlotsProvider overrides={overrides} theme={theme}>diff --git a/packages/trueforge-ui/src/index.ts b/packages/trueforge-ui/src/index.tsindex 121657190..39b9294ad 100644--- a/packages/trueforge-ui/src/index.ts+++ b/packages/trueforge-ui/src/index.ts@@ -108,6 +108,7 @@ export { MessageTimestamp } from './atoms/MessageTimestamp.js';export type { MessageTimestampProps } from './atoms/MessageTimestamp.js';export { MonacoEditorCore } from './atoms/MonacoEditorCore.js';export type { MonacoEditorCoreProps } from './atoms/MonacoEditorCore.js';+export { preloadMonaco } from './atoms/monacoPreload.js';export { OpenUiFenceBlock } from './atoms/OpenUiFenceBlock.js';export type { OpenUiFenceBlockProps } from './atoms/OpenUiFenceBlock.js';export { SandboxArtifactDownload } from './atoms/SandboxArtifactDownload.js';diff --git a/packages/trueforge-ui/test/atoms/MonacoEditorCore.test.tsx b/packages/trueforge-ui/test/atoms/MonacoEditorCore.test.tsxindex 7a6b5e844..8c1eb312e 100644--- a/packages/trueforge-ui/test/atoms/MonacoEditorCore.test.tsx+++ b/packages/trueforge-ui/test/atoms/MonacoEditorCore.test.tsx@@ -3,6 +3,7 @@ import { act, render, waitFor } from '@testing-library/react';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import { MonacoEditorCore } from '@/atoms/MonacoEditorCore.js';+import { preloadMonaco, resetMonacoPreloadForTests } from '@/atoms/monacoPreload.js';const monacoMocks = vi.hoisted(() => {let changeListener: (() => void) | undefined;@@ -48,6 +49,7 @@ vi.mock('monaco-editor', () => monacoMocks.module);describe('MonacoEditorCore', () => {beforeEach(() => {vi.clearAllMocks();+ resetMonacoPreloadForTests();monacoMocks.editor.getValue.mockReturnValue('initial value');monacoMocks.editor.getContentHeight.mockReturnValue(72);vi.stubGlobal('requestAnimationFrame', (callback: FrameRequestCallback) => {@@ -56,7 +58,21 @@ describe('MonacoEditorCore', () => {});});- afterEach(() => vi.unstubAllGlobals());+ afterEach(() => {+ resetMonacoPreloadForTests();+ vi.unstubAllGlobals();+ });++ it('shares one Monaco import across preload and editor mount', async () => {+ const first = preloadMonaco();+ const second = preloadMonaco();+ expect(first).toBe(second);+ await expect(first).resolves.toMatchObject({ editor: expect.any(Object) });++ render(<MonacoEditorCore value="initial value" />);+ await waitFor(() => expect(monacoMocks.editorApi.create).toHaveBeenCalledOnce());+ expect(preloadMonaco()).toBe(first);+ });it('creates Monaco with consumer options and forwards lifecycle and change callbacks', async () => {const beforeMount = vi.fn();diff --git a/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx b/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsxindex b6c1380f1..d338d07c6 100644--- a/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx+++ b/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx@@ -45,6 +45,10 @@ vi.mock('thinking-orbs', () => ({ThinkingOrb: () => <div data-testid="thinking-orb" />,}));+vi.mock('@/atoms/monacoPreload.js', () => ({+ preloadMonaco: vi.fn(() => Promise.resolve({ editor: {} })),+}));+vi.mock('@/plugins/trueforge-agent-server-adapter/index.js', () => ({createTrueForgeAgentUIServer: vi.fn(async () =>createMockAgentUIServer({diff --git a/packages/trueforge-ui/test/publicUiExports.test.ts b/packages/trueforge-ui/test/publicUiExports.test.tsindex 86436adc3..1520be1fe 100644--- a/packages/trueforge-ui/test/publicUiExports.test.ts+++ b/packages/trueforge-ui/test/publicUiExports.test.ts@@ -98,6 +98,7 @@ const expectedRuntimeExports: Array<keyof typeof sdk> = ['MessageListSkeleton','MessageTimestamp','MonacoEditorCore',+ 'preloadMonaco','OpenUiFenceBlock','PRESETS','PermissionGuard',