Skip to content

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.md
new file mode 100644
index 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.ts
index 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.tsx
index 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.ts
new file mode 100644
index 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.tsx
index 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.ts
index 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.tsx
index 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.tsx
index 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.ts
index 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',