Skip to content

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

bugfix: reset build agent selected agent when revisited the page (#828)

harshil-209656b3a597d031
diff --git a/.changeset/keep-builder-save-intent.md b/.changeset/keep-builder-save-intent.md
new file mode 100644
index 000000000..314eede40
--- /dev/null
+++ b/.changeset/keep-builder-save-intent.md
@@ -0,0 +1,5 @@
+---
+'@truefoundry/trueforge-ui': patch
+---
+
+Keep newly saved builders editable until the user leaves the build-agent page, then start fresh when they return.
diff --git a/packages/trueforge-ui/src/server/ShellModeContext.tsx b/packages/trueforge-ui/src/server/ShellModeContext.tsx
index 510adcc3d..ad5c41b2c 100644
--- a/packages/trueforge-ui/src/server/ShellModeContext.tsx
+++ b/packages/trueforge-ui/src/server/ShellModeContext.tsx
@@ -491,11 +491,12 @@ export function ShellModeProvider({
const isActiveAgentBuilder =
effectiveMode.status === 'active' && effectiveMode.isMutable && effectiveMode.isCreateAgent;
+ const isBoundAgentBuilder = isActiveAgentBuilder && effectiveMode.agentId != null;
const openAgentBuilder = useCallback(() => {
if (!isComposerEnabled) return;
refreshCapabilities?.();
- // Returning from an overlay must keep the live draft runtime and its unsaved instructions.
- if (isActiveAgentBuilder) {
+ // Preserve unsaved drafts, saved builders start fresh when revisited.
+ if (isActiveAgentBuilder && !isBoundAgentBuilder) {
setSettingsOpen(false);
setLibraryOpenState(false);
setLibraryAgentId(null);
@@ -507,6 +508,7 @@ export function ShellModeProvider({
selectLibraryAgent({ isMutable: true, isCreateAgent: true, agentSpec: agentSeedRef.current });
}, [
isActiveAgentBuilder,
+ isBoundAgentBuilder,
isComposerEnabled,
refreshCapabilities,
selectLibraryAgent,
diff --git a/packages/trueforge-ui/test/atoms/SaveAgentButton.test.tsx b/packages/trueforge-ui/test/atoms/SaveAgentButton.test.tsx
index a513cae99..d5c312d01 100644
--- a/packages/trueforge-ui/test/atoms/SaveAgentButton.test.tsx
+++ b/packages/trueforge-ui/test/atoms/SaveAgentButton.test.tsx
@@ -437,6 +437,8 @@ describe('SaveAgentButton', () => {
updatedAt: '2026-08-12T08:00:00.000Z',
}),
);
+ expect(screen.getByRole('button', { name: 'Update Agent' })).toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: 'Save Agent' })).not.toBeInTheDocument();
});
it('preserves opaque mount fields without exposing resource editors', async () => {
diff --git a/packages/trueforge-ui/test/server/ShellModeContext.test.tsx b/packages/trueforge-ui/test/server/ShellModeContext.test.tsx
index 7ae238d06..882f9d284 100644
--- a/packages/trueforge-ui/test/server/ShellModeContext.test.tsx
+++ b/packages/trueforge-ui/test/server/ShellModeContext.test.tsx
@@ -193,6 +193,32 @@ describe('ShellModeProvider', () => {
expect(result.current.runtimeKey).toBe(builderRuntimeKey);
});
+ it('starts a fresh agent builder after leaving a saved builder', () => {
+ const { result } = renderHook(() => useShellMode(), { wrapper: wrap() });
+
+ act(() => result.current.openAgentBuilder());
+ act(() =>
+ result.current.bindMutableAgent({
+ agentId: 'saved',
+ agentName: 'saved',
+ agentSpec: { model: { name: 'saved/model' } },
+ }),
+ );
+ expect(result.current.mode).toMatchObject({ agentId: 'saved', agentName: 'saved' });
+
+ act(() => result.current.setLibraryOpen(true));
+ act(() => result.current.openAgentBuilder());
+
+ expect(result.current.mode).toMatchObject({
+ status: 'active',
+ isMutable: true,
+ isCreateAgent: true,
+ });
+ if (result.current.mode.status !== 'active') throw new Error('expected active mode');
+ expect(result.current.mode.agentId).toBeUndefined();
+ expect(result.current.mode.agentName).toBeUndefined();
+ });
+
it('restores the active agent draft after visiting New Chat', () => {
const { result } = renderHook(() => useShellMode(), { wrapper: wrap() });
const agentDraft = {