@truefoundry/assistant-ui-runtime 0.1.12 → 0.1.14

package/dist/plugins/truefoundry-agent-server-adapter/index.d.ts

@@ -1,6 +1,6 @@
 import { AgentSessionClient } from 'truefoundry-gateway-sdk/agents';
 import { PrivateAgentSessionClient } from 'truefoundry-gateway-sdk/agents/private';
-import { A as AgentSpec, K as CreateSessionRequest, W as ListSessionsParams, S as Session, d as Turn, ax as TurnState, a as AgentChatServer, aF as UpdateSessionRequest, i as AgentSelectorEntry, E as ConnectorSelectorEntry, a5 as ModelSelectorEntry, as as SkillSelectorEntry, g as AgentBuilderServer } from '../../types-CSRQSnHu.js';
+import { A as AgentSpec, N as CreateSessionRequest, Y as ListSessionsParams, S as Session, d as Turn, aC as TurnState, a as AgentChatServer, aK as UpdateSessionRequest, k as AgentSelectorEntry, G as ConnectorSelectorEntry, a8 as ModelSelectorEntry, ax as SkillSelectorEntry, g as AgentBuilderServer } from '../../types-VU3Fc17W.js';
 import { TruefoundryGatewayApi } from 'truefoundry-gateway-sdk';
 
 /**
@@ -29,8 +29,7 @@ type RuntimeSkillMount = NonNullable<NonNullable<AgentSpec["skills"]>[number]>;
 type RuntimeMcpServerMount = NonNullable<NonNullable<AgentSpec["mcpServers"]>[number]>;
 type TfySkillMount = RuntimeSkillMount & TruefoundryGatewayApi.SkillMount;
 type TfyMcpServerMount = RuntimeMcpServerMount & TruefoundryGatewayApi.McpServer;
-interface TfyAgentSpec extends AgentSpec<TruefoundryGatewayApi.Model, TfySkillMount, TfyMcpServerMount> {
-    config?: TruefoundryGatewayApi.RuntimeConfig;
+interface TfyAgentSpec extends AgentSpec<TruefoundryGatewayApi.Model, TfySkillMount, TfyMcpServerMount, TruefoundryGatewayApi.RuntimeConfig> {
     responseFormat?: TruefoundryGatewayApi.ResponseFormat;
     messages?: TruefoundryGatewayApi.AgentSpecUserMessage[];
 }
@@ -121,7 +120,6 @@ interface TfyModelSelectorEntry extends ModelSelectorEntry {
     apiModel: string;
     modelId: string;
     providerAccount?: string;
-    id?: string;
 }
 interface TfySkillSelectorEntry extends SkillSelectorEntry {
     /** Version FQN — mount as RegisteredSkillMount.fqn. */

package/dist/plugins/truefoundry-agent-server-adapter/index.js

@@ -7,7 +7,7 @@ import {
   isTfyMcpToolInfo,
   isTfySystemToolInfo,
   isTfyToolInfo
-} from "../../chunk-2NLIAJJX.js";
+} from "../../chunk-S4SH2KT2.js";
 export {
   createTrueFoundryAgentUIServer,
   createTrueFoundryChatServer,

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-import { aA as TurnStreamingEvent, aH as DeltaEvents, T as TurnEvent } from '../types-CSRQSnHu.js';
-export { aI as ActionRequiredEvent, f as AgentBuilderCapabilitiesResponse, g as AgentBuilderServer, a as AgentChatServer, aJ as AgentInfo, h as AgentLibraryEntry, aK as AgentParent, i as AgentSelectorEntry, j as AgentSkill, A as AgentSpec, k as AgentUIServer, l as AgentUIServerPort, m as ApprovalDecision, n as AuthenticateConnectorRequest, C as CatalogServer, aL as ChunkDeltaToolCall, o as ConnectorAuth, p as ConnectorAuthApiKey, q as ConnectorAuthNone, r as ConnectorAuthOAuth, s as ConnectorAuthPublic, t as ConnectorAuthPublicApiKey, u as ConnectorAuthPublicNone, v as ConnectorAuthPublicOAuth, w as ConnectorAuthType, x as ConnectorAuthenticationResult, y as ConnectorBase, z as ConnectorCatalogEntry, B as ConnectorCatalogServer, D as ConnectorConfigBase, E as ConnectorSelectorEntry, F as ConnectorState, G as CreateConnectorRequest, H as CreateModelProviderRequest, I as CreateSandboxProviderRequest, J as CreateSandboxRequest, K as CreateSessionRequest, L as CreateSkillRequest, N as CreateSkillRequestBase, O as DefinedSkill, P as GithubSkill, Q as ImportGithubSkillRequest, R as ListResult, V as ListSessionsOrder, W as ListSessionsParams, M as McpAuthRequiredEvent, aM as McpInitializeEvent, aN as McpServerAuthInfo, X as McpServerMount, Y as Model, Z as ModelCatalogServer, _ as ModelEntry, aO as ModelMessageContentPart, aP as ModelMessageDeltaEvent, $ as ModelMessageEvent, a0 as ModelParams, a1 as ModelProviderBase, a2 as ModelProviderCatalogEntry, a3 as ModelProviderConfigBase, a4 as ModelSelection, a5 as ModelSelectorEntry, a6 as PageParams, a7 as PreviousTurnIdInput, a8 as ProviderType, a9 as RegistrySkill, aa as SandboxBase, ab as SandboxCatalogEntry, ac as SandboxCatalogServer, ad as SandboxConfig, ae as SandboxCreatedEvent, af as SandboxProviderBase, ag as SandboxProviderCatalogEntry, ah as SandboxProviderConfig, ai as SaveAgentRequest, aj as SearchAgentSelectorParams, ak as SearchAgentsParams, al as SelectRegistrySkillRequest, S as Session, am as SessionEventItem, an as SkillBase, ao as SkillCatalogEntry, ap as SkillCatalogServer, aq as SkillConfigBase, ar as SkillMount, as as SkillSelectorEntry, b as ThreadCreatedEvent, aQ as ThreadDoneEvent, at as ToolApprovalRequiredEvent, au as ToolBase, av as ToolCall, aR as ToolCallFunction, aS as ToolCallRef, aT as ToolInfo, aU as ToolResponseEvent, aw as ToolResponseRequiredEvent, d as Turn, aV as TurnCreatedEvent, aW as TurnDoneEvent, e as TurnInputItem, ax as TurnState, aX as TurnStateCancelled, ay as TurnStateDone, aY as TurnStateError, aZ as TurnStateRunning, az as TurnStreamData, aB as UpdateConnectorRequest, aC as UpdateModelProviderRequest, aD as UpdateSandboxProviderRequest, aE as UpdateSandboxRequest, aF as UpdateSessionRequest, aG as UserMessage, a_ as UserMessageContent, c as UserToolApprovalEvent, U as UserToolResponseEvent } from '../types-CSRQSnHu.js';
+import { aF as TurnStreamingEvent, aM as DeltaEvents, T as TurnEvent } from '../types-VU3Fc17W.js';
+export { aN as ActionRequiredEvent, f as AgentBuilderCapabilitiesResponse, g as AgentBuilderServer, h as AgentCapabilityConfig, a as AgentChatServer, aO as AgentInfo, i as AgentLibraryEntry, aP as AgentParent, j as AgentRuntimeConfig, k as AgentSelectorEntry, l as AgentSkill, A as AgentSpec, m as AgentUIServer, n as AgentUIServerPort, o as ApprovalDecision, p as AuthenticateConnectorRequest, C as CatalogServer, aQ as ChunkDeltaToolCall, q as ConnectorAuth, r as ConnectorAuthApiKey, s as ConnectorAuthNone, t as ConnectorAuthOAuth, u as ConnectorAuthPublic, v as ConnectorAuthPublicApiKey, w as ConnectorAuthPublicNone, x as ConnectorAuthPublicOAuth, y as ConnectorAuthType, z as ConnectorAuthenticationResult, B as ConnectorBase, D as ConnectorCatalogEntry, E as ConnectorCatalogServer, F as ConnectorConfigBase, G as ConnectorSelectorEntry, H as ConnectorState, I as CreateConnectorRequest, J as CreateModelProviderRequest, K as CreateSandboxProviderRequest, L as CreateSandboxRequest, N as CreateSessionRequest, O as CreateSkillRequest, P as CreateSkillRequestBase, Q as DefinedSkill, R as GithubSkill, V as ImportGithubSkillRequest, W as ListResult, X as ListSessionsOrder, Y as ListSessionsParams, M as McpAuthRequiredEvent, aR as McpInitializeEvent, aS as McpServerAuthInfo, Z as McpServerMount, _ as Model, $ as ModelCatalogServer, a0 as ModelEntry, aT as ModelMessageContentPart, aU as ModelMessageDeltaEvent, a1 as ModelMessageEvent, a2 as ModelParams, a3 as ModelProperties, a4 as ModelProviderBase, a5 as ModelProviderCatalogEntry, a6 as ModelProviderConfigBase, a7 as ModelSelection, a8 as ModelSelectorEntry, a9 as PageParams, aa as PreviousTurnIdInput, ab as ProviderEntry, ac as ProviderType, ad as RegistrySkill, ae as SandboxBase, af as SandboxCatalogEntry, ag as SandboxCatalogServer, ah as SandboxConfig, ai as SandboxCreatedEvent, aj as SandboxProviderBase, ak as SandboxProviderCatalogEntry, al as SandboxProviderConfig, am as SaveAgentRequest, an as SaveAgentResult, ao as SearchAgentSelectorParams, ap as SearchAgentsParams, aq as SelectRegistrySkillRequest, S as Session, ar as SessionEventItem, as as SkillBase, at as SkillCatalogEntry, au as SkillCatalogServer, av as SkillConfigBase, aw as SkillMount, ax as SkillSelectorEntry, b as ThreadCreatedEvent, aV as ThreadDoneEvent, ay as ToolApprovalRequiredEvent, az as ToolBase, aA as ToolCall, aW as ToolCallFunction, aX as ToolCallRef, aY as ToolInfo, aZ as ToolResponseEvent, aB as ToolResponseRequiredEvent, d as Turn, a_ as TurnCreatedEvent, a$ as TurnDoneEvent, e as TurnInputItem, aC as TurnState, b0 as TurnStateCancelled, aD as TurnStateDone, b1 as TurnStateError, b2 as TurnStateRunning, aE as TurnStreamData, aG as UpdateConnectorRequest, aH as UpdateModelProviderRequest, aI as UpdateSandboxProviderRequest, aJ as UpdateSandboxRequest, aK as UpdateSessionRequest, aL as UserMessage, b3 as UserMessageContent, c as UserToolApprovalEvent, U as UserToolResponseEvent } from '../types-VU3Fc17W.js';
 
 /**
  * Local implementations of streaming delta helpers.

package/dist/{types-CSRQSnHu.d.ts → types-VU3Fc17W.d.ts}

@@ -227,13 +227,19 @@ type DeltaEvents = ModelMessageDeltaEvent;
  * No dependency on truefoundry-gateway-sdk.
  */
 
-/** Model selector row. Host extends for apiModel, modelId, pricing, etc. */
-interface ModelSelectorEntry {
+interface ProviderEntry {
     name: string;
-    provider: string;
+    logo?: string;
+}
+interface ModelProperties {
     reasoningEfforts?: string[];
-    /** Provider logo URL from the model catalog; selector falls back to a monogram when omitted. */
-    providerLogo?: string;
+}
+/** Model selector row. Host extends for apiModel, modelId, pricing, etc. */
+interface ModelSelectorEntry<TProvider extends ProviderEntry = ProviderEntry, TProperties extends ModelProperties = ModelProperties> {
+    name: string;
+    id: string;
+    provider: TProvider;
+    properties: TProperties;
 }
 /** Skill selector row. Host extends for fqn, preload, etc. */
 interface SkillSelectorEntry {
@@ -288,15 +294,24 @@ interface Model {
     name: string;
     params?: ModelParams;
 }
+interface AgentCapabilityConfig {
+    enabled?: boolean;
+}
+interface AgentRuntimeConfig {
+    generativeUi?: AgentCapabilityConfig;
+    dynamicSubAgents?: AgentCapabilityConfig;
+    askUserQuestions?: AgentCapabilityConfig;
+}
 /**
 * SDK-owned agent definition — fields the FE reads/writes.
-* Host widens `model` / `skills` / `mcpServers` via type params, and adds
-* extra fields via `TSpec extends AgentSpec<...>`.
+* Host widens `model` / `skills` / `mcpServers` / `config` via type params,
+* and adds extra fields via `TSpec extends AgentSpec<...>`.
 */
-interface AgentSpec<TModel extends Model = Model, TSkill extends SkillMount = SkillMount, TMcp extends McpServerMount = McpServerMount> {
+interface AgentSpec<TModel extends Model = Model, TSkill extends SkillMount = SkillMount, TMcp extends McpServerMount = McpServerMount, TConfig extends AgentRuntimeConfig = AgentRuntimeConfig> {
     model: TModel;
     skills?: TSkill[];
     mcpServers?: TMcp[];
+    config?: TConfig;
     instructions?: string;
     variables?: Record<string, string>;
 }
@@ -469,6 +484,15 @@ interface AgentChatServer<TSpec extends AgentSpec = AgentSpec, TSession extends
 interface SaveAgentRequest<TSpec extends AgentSpec = AgentSpec> {
     agentName: string;
     agentSpec: TSpec;
+    intent: "create" | "update";
+    /** Current mutable session to update atomically with the named agent. */
+    sessionId?: string;
+}
+interface SaveAgentResult {
+    /** Immutable id allocated by the host registry. */
+    agentId?: string;
+    /** Timestamp returned when the active mutable session was updated. */
+    sessionUpdatedAt?: string;
 }
 /**
  * Builder feature flags — atoms gate sandbox / skill / settings surfaces on these.
@@ -491,7 +515,7 @@ interface AgentBuilderCapabilitiesResponse {
 * Builder catalog + persist port — atoms call these.
 * Passed separately from the runtime's chat server.
 */
-interface AgentBuilderServer<TSpec extends AgentSpec = AgentSpec, TModel extends ModelSelectorEntry = ModelSelectorEntry, TSkill extends SkillSelectorEntry = SkillSelectorEntry, TMcp extends ConnectorSelectorEntry = ConnectorSelectorEntry, TAgent extends AgentSelectorEntry = AgentSelectorEntry, TSave = unknown, TCapabilities extends AgentBuilderCapabilitiesResponse = AgentBuilderCapabilitiesResponse> {
+interface AgentBuilderServer<TSpec extends AgentSpec = AgentSpec, TModel extends ModelSelectorEntry = ModelSelectorEntry, TSkill extends SkillSelectorEntry = SkillSelectorEntry, TMcp extends ConnectorSelectorEntry = ConnectorSelectorEntry, TAgent extends AgentSelectorEntry = AgentSelectorEntry, TSave = SaveAgentResult, TCapabilities extends AgentBuilderCapabilitiesResponse = AgentBuilderCapabilitiesResponse> {
     getCapabilities(): Promise<TCapabilities>;
     getModels(): Promise<TModel[]>;
     getSkills(): Promise<TSkill[]>;
@@ -809,4 +833,4 @@ type AgentUIServerPort<TChat extends AgentChatServer = AgentChatServer, TBuilder
 /** Host-facing alias used by trueforge-ui. */
 type AgentUIServer = AgentUIServerPort;
 
-export type { ModelMessageEvent as $, AgentSpec as A, ConnectorCatalogServer as B, CatalogServer as C, ConnectorConfigBase as D, ConnectorSelectorEntry as E, ConnectorState as F, CreateConnectorRequest as G, CreateModelProviderRequest as H, CreateSandboxProviderRequest as I, CreateSandboxRequest as J, CreateSessionRequest as K, CreateSkillRequest as L, McpAuthRequiredEvent as M, CreateSkillRequestBase as N, DefinedSkill as O, GithubSkill as P, ImportGithubSkillRequest as Q, ListResult as R, Session as S, TurnEvent as T, UserToolResponseEvent as U, ListSessionsOrder as V, ListSessionsParams as W, McpServerMount as X, Model as Y, ModelCatalogServer as Z, ModelEntry as _, AgentChatServer as a, ModelParams as a0, ModelProviderBase as a1, ModelProviderCatalogEntry as a2, ModelProviderConfigBase as a3, ModelSelection as a4, ModelSelectorEntry as a5, PageParams as a6, PreviousTurnIdInput as a7, ProviderType as a8, RegistrySkill as a9, TurnStreamingEvent as aA, UpdateConnectorRequest as aB, UpdateModelProviderRequest as aC, UpdateSandboxProviderRequest as aD, UpdateSandboxRequest as aE, UpdateSessionRequest as aF, UserMessage as aG, DeltaEvents as aH, ActionRequiredEvent as aI, AgentInfo as aJ, AgentParent as aK, ChunkDeltaToolCall as aL, McpInitializeEvent as aM, McpServerAuthInfo as aN, ModelMessageContentPart as aO, ModelMessageDeltaEvent as aP, ThreadDoneEvent as aQ, ToolCallFunction as aR, ToolCallRef as aS, ToolInfo as aT, ToolResponseEvent as aU, TurnCreatedEvent as aV, TurnDoneEvent as aW, TurnStateCancelled as aX, TurnStateError as aY, TurnStateRunning as aZ, UserMessageContent as a_, SandboxBase as aa, SandboxCatalogEntry as ab, SandboxCatalogServer as ac, SandboxConfig as ad, SandboxCreatedEvent as ae, SandboxProviderBase as af, SandboxProviderCatalogEntry as ag, SandboxProviderConfig as ah, SaveAgentRequest as ai, SearchAgentSelectorParams as aj, SearchAgentsParams as ak, SelectRegistrySkillRequest as al, SessionEventItem as am, SkillBase as an, SkillCatalogEntry as ao, SkillCatalogServer as ap, SkillConfigBase as aq, SkillMount as ar, SkillSelectorEntry as as, ToolApprovalRequiredEvent as at, ToolBase as au, ToolCall as av, ToolResponseRequiredEvent as aw, TurnState as ax, TurnStateDone as ay, TurnStreamData as az, ThreadCreatedEvent as b, UserToolApprovalEvent as c, Turn as d, TurnInputItem as e, AgentBuilderCapabilitiesResponse as f, AgentBuilderServer as g, AgentLibraryEntry as h, AgentSelectorEntry as i, AgentSkill as j, AgentUIServer as k, AgentUIServerPort as l, ApprovalDecision as m, AuthenticateConnectorRequest as n, ConnectorAuth as o, ConnectorAuthApiKey as p, ConnectorAuthNone as q, ConnectorAuthOAuth as r, ConnectorAuthPublic as s, ConnectorAuthPublicApiKey as t, ConnectorAuthPublicNone as u, ConnectorAuthPublicOAuth as v, ConnectorAuthType as w, ConnectorAuthenticationResult as x, ConnectorBase as y, ConnectorCatalogEntry as z };
+export type { ModelCatalogServer as $, AgentSpec as A, ConnectorBase as B, CatalogServer as C, ConnectorCatalogEntry as D, ConnectorCatalogServer as E, ConnectorConfigBase as F, ConnectorSelectorEntry as G, ConnectorState as H, CreateConnectorRequest as I, CreateModelProviderRequest as J, CreateSandboxProviderRequest as K, CreateSandboxRequest as L, McpAuthRequiredEvent as M, CreateSessionRequest as N, CreateSkillRequest as O, CreateSkillRequestBase as P, DefinedSkill as Q, GithubSkill as R, Session as S, TurnEvent as T, UserToolResponseEvent as U, ImportGithubSkillRequest as V, ListResult as W, ListSessionsOrder as X, ListSessionsParams as Y, McpServerMount as Z, Model as _, AgentChatServer as a, TurnDoneEvent as a$, ModelEntry as a0, ModelMessageEvent as a1, ModelParams as a2, ModelProperties as a3, ModelProviderBase as a4, ModelProviderCatalogEntry as a5, ModelProviderConfigBase as a6, ModelSelection as a7, ModelSelectorEntry as a8, PageParams as a9, ToolCall as aA, ToolResponseRequiredEvent as aB, TurnState as aC, TurnStateDone as aD, TurnStreamData as aE, TurnStreamingEvent as aF, UpdateConnectorRequest as aG, UpdateModelProviderRequest as aH, UpdateSandboxProviderRequest as aI, UpdateSandboxRequest as aJ, UpdateSessionRequest as aK, UserMessage as aL, DeltaEvents as aM, ActionRequiredEvent as aN, AgentInfo as aO, AgentParent as aP, ChunkDeltaToolCall as aQ, McpInitializeEvent as aR, McpServerAuthInfo as aS, ModelMessageContentPart as aT, ModelMessageDeltaEvent as aU, ThreadDoneEvent as aV, ToolCallFunction as aW, ToolCallRef as aX, ToolInfo as aY, ToolResponseEvent as aZ, TurnCreatedEvent as a_, PreviousTurnIdInput as aa, ProviderEntry as ab, ProviderType as ac, RegistrySkill as ad, SandboxBase as ae, SandboxCatalogEntry as af, SandboxCatalogServer as ag, SandboxConfig as ah, SandboxCreatedEvent as ai, SandboxProviderBase as aj, SandboxProviderCatalogEntry as ak, SandboxProviderConfig as al, SaveAgentRequest as am, SaveAgentResult as an, SearchAgentSelectorParams as ao, SearchAgentsParams as ap, SelectRegistrySkillRequest as aq, SessionEventItem as ar, SkillBase as as, SkillCatalogEntry as at, SkillCatalogServer as au, SkillConfigBase as av, SkillMount as aw, SkillSelectorEntry as ax, ToolApprovalRequiredEvent as ay, ToolBase as az, ThreadCreatedEvent as b, TurnStateCancelled as b0, TurnStateError as b1, TurnStateRunning as b2, UserMessageContent as b3, UserToolApprovalEvent as c, Turn as d, TurnInputItem as e, AgentBuilderCapabilitiesResponse as f, AgentBuilderServer as g, AgentCapabilityConfig as h, AgentLibraryEntry as i, AgentRuntimeConfig as j, AgentSelectorEntry as k, AgentSkill as l, AgentUIServer as m, AgentUIServerPort as n, ApprovalDecision as o, AuthenticateConnectorRequest as p, ConnectorAuth as q, ConnectorAuthApiKey as r, ConnectorAuthNone as s, ConnectorAuthOAuth as t, ConnectorAuthPublic as u, ConnectorAuthPublicApiKey as v, ConnectorAuthPublicNone as w, ConnectorAuthPublicOAuth as x, ConnectorAuthType as y, ConnectorAuthenticationResult as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truefoundry/assistant-ui-runtime",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "TrueFoundry Gateway agent runtime adapter for assistant-ui",
   "license": "Apache-2.0",
   "repository": {

package/src/draft/useDraftAgentSpec.test.tsx

@@ -150,4 +150,111 @@ describe("useDraftAgentSpec", () => {
         expect(syncAgentSpec).toHaveBeenCalledOnce();
         expect(result.current.isSpecSyncing).toBe(false);
     });
+
+    it("flushes pending work before a coordinated save", async () => {
+        const syncAgentSpec = vi
+            .fn()
+            .mockResolvedValue("2026-06-30T15:00:00.000Z");
+        const draftBridge: DraftSessionBridge = {
+            getDraftAgentSpec: vi.fn().mockResolvedValue(defaultAgentSpec),
+            syncAgentSpec,
+        };
+        const { result } = renderHook(() =>
+            useDraftAgentSpec({
+                draftSessionId: "draft-1",
+                draftBridge,
+                defaultAgentSpec,
+            }),
+        );
+        await flushMicrotasks();
+
+        act(() => {
+            result.current.updateAgentSpec({ instructions: "latest draft" });
+        });
+        await act(async () => {
+            await result.current.flushAgentSpec();
+        });
+
+        expect(syncAgentSpec).toHaveBeenCalledWith("draft-1", {
+            model: defaultAgentSpec.model,
+            instructions: "latest draft",
+        });
+    });
+
+    it("adopts an atomically persisted spec without scheduling another sync", async () => {
+        const syncAgentSpec = vi.fn().mockResolvedValue("unused");
+        const draftBridge: DraftSessionBridge = {
+            getDraftAgentSpec: vi.fn().mockResolvedValue(defaultAgentSpec),
+            syncAgentSpec,
+        };
+        const { result } = renderHook(() =>
+            useDraftAgentSpec({
+                draftSessionId: "draft-1",
+                draftBridge,
+                defaultAgentSpec,
+            }),
+        );
+        await flushMicrotasks();
+
+        act(() => {
+            result.current.adoptAgentSpec({
+                agentSpec: {
+                    model: { name: "openai/gpt-5" },
+                    config: { generativeUi: { enabled: false } },
+                },
+                updatedAt: "2026-06-30T16:00:00.000Z",
+            });
+        });
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(400);
+        });
+
+        expect(result.current.agentSpec).toEqual({
+            model: { name: "openai/gpt-5" },
+            config: { generativeUi: { enabled: false } },
+        });
+        expect(syncAgentSpec).not.toHaveBeenCalled();
+        await expect(result.current.takeTurnHeaderTimestamp()).resolves.toBe(
+            "2026-06-30T16:00:00.000Z",
+        );
+    });
+
+    it("preserves the last sync timestamp when adopt omits updatedAt", async () => {
+        const syncAgentSpec = vi
+            .fn()
+            .mockResolvedValue("2026-06-30T17:00:00.000Z");
+        const draftBridge: DraftSessionBridge = {
+            getDraftAgentSpec: vi.fn().mockResolvedValue(defaultAgentSpec),
+            syncAgentSpec,
+        };
+        const { result } = renderHook(() =>
+            useDraftAgentSpec({
+                draftSessionId: "draft-1",
+                draftBridge,
+                defaultAgentSpec,
+            }),
+        );
+        await flushMicrotasks();
+
+        act(() => {
+            result.current.updateAgentSpec({ instructions: "synced" });
+        });
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(400);
+        });
+        await flushMicrotasks();
+        expect(syncAgentSpec).toHaveBeenCalledOnce();
+
+        act(() => {
+            result.current.adoptAgentSpec({
+                agentSpec: {
+                    model: { name: "openai/gpt-5" },
+                },
+            });
+        });
+
+        await expect(result.current.takeTurnHeaderTimestamp()).resolves.toBe(
+            "2026-06-30T17:00:00.000Z",
+        );
+    });
 });

package/src/draft/useDraftAgentSpec.ts

@@ -23,6 +23,11 @@ export type UseDraftAgentSpecResult = {
     isSpecSyncing: boolean;
     specError: unknown | null;
     updateAgentSpec: (update: AgentSpecUpdate) => void;
+    flushAgentSpec: () => Promise<void>;
+    adoptAgentSpec: (request: {
+        agentSpec: AgentSpec;
+        updatedAt?: string;
+    }) => void;
     takeTurnHeaderTimestamp: () => Promise<string | undefined>;
 };
 
@@ -206,6 +211,35 @@ export function useDraftAgentSpec({
         }
     }, []);
 
+    const adoptAgentSpec = useCallback(
+        ({
+            agentSpec: persistedSpec,
+            updatedAt,
+        }: {
+            agentSpec: AgentSpec;
+            updatedAt?: string;
+        }) => {
+            if (syncTimeoutRef.current != null) {
+                clearTimeout(syncTimeoutRef.current);
+                syncTimeoutRef.current = undefined;
+            }
+            syncGenerationRef.current++;
+            pendingFlushRef.current = undefined;
+            inFlightFlushRef.current = undefined;
+            localDirtyRef.current = false;
+            // Keep the last successful sync timestamp when the caller omits
+            // updatedAt (e.g. a save that did not return sessionUpdatedAt).
+            if (updatedAt !== undefined) {
+                lastUpdatedAtRef.current = updatedAt;
+            }
+            agentSpecRef.current = persistedSpec;
+            setAgentSpec(persistedSpec);
+            setSpecError(null);
+            setIsSpecSyncing(false);
+        },
+        [],
+    );
+
     const takeTurnHeaderTimestamp = useCallback(async () => {
         await flushPendingSpecSyncNow();
         const updatedAt = lastUpdatedAtRef.current;
@@ -245,6 +279,8 @@ export function useDraftAgentSpec({
             isSpecSyncing: enabled ? isSpecSyncing : false,
             specError: enabled ? specError : null,
             updateAgentSpec,
+            flushAgentSpec: flushPendingSpecSyncNow,
+            adoptAgentSpec,
             takeTurnHeaderTimestamp,
         }),
         [
@@ -254,6 +290,8 @@ export function useDraftAgentSpec({
             isSpecLoading,
             isSpecSyncing,
             specError,
+            flushPendingSpecSyncNow,
+            adoptAgentSpec,
             takeTurnHeaderTimestamp,
             updateAgentSpec,
         ],

package/src/hooks.ts

@@ -142,6 +142,13 @@ export const useTrueFoundryHistoryPagination = () => {
     );
 };
 
+/**
+ * True while a turn runs that this server cannot stream, so its result will not
+ * arrive in this client. Falls back to `false` on runtimes that predate the flag.
+ */
+export const useTrueFoundryResumeUnavailable = () =>
+    trueFoundryExtras.use((e) => e.resumeUnavailable, false) ?? false;
+
 /** Returns a function to reset (re-submit) a user turn from any render context. */
 export const useTrueFoundryResetFromTurn = () => {
     const aui = useAui();
@@ -165,3 +172,18 @@ export const useTrueFoundryUpdateAgentSpec = () => {
         trueFoundryExtras.get(aui).draft?.updateAgentSpec(update);
 };
 
+/** Flushes any pending draft-spec synchronization before a coordinated write. */
+export const useTrueFoundryFlushAgentSpec = () => {
+    const aui = useAui();
+    return () =>
+        trueFoundryExtras.get(aui).draft?.flushAgentSpec() ?? Promise.resolve();
+};
+
+/** Adopts a spec already persisted by another server operation without syncing again. */
+export const useTrueFoundryAdoptAgentSpec = () => {
+    const aui = useAui();
+    return (
+        request: Parameters<TrueFoundryDraftRuntimeExtras["adoptAgentSpec"]>[0],
+    ) => trueFoundryExtras.get(aui).draft?.adoptAgentSpec(request);
+};
+

package/src/index.ts

@@ -25,7 +25,9 @@ export { createTrueFoundryOwnedSessionsThreadListAdapter } from "./truefoundryOw
 export { createDraftSessionBridge } from "./draft/draftSessionBridge.js";
 export type { DraftSessionBridge } from "./draft/draftSessionBridge.js";
 export {
+    useTrueFoundryAdoptAgentSpec,
     useTrueFoundryAgentSpec,
+    useTrueFoundryFlushAgentSpec,
     useTrueFoundryUpdateAgentSpec,
 } from "./hooks.js";
 export type { TrueFoundryDraftRuntimeExtras } from "./truefoundryExtras.js";
@@ -55,6 +57,7 @@ export {
     useTrueFoundryResetFromTurn,
     useTrueFoundryReload,
     useTrueFoundryHistoryPagination,
+    useTrueFoundryResumeUnavailable,
 } from "./hooks.js";
 export {
     collectApprovalInputs,
@@ -79,7 +82,10 @@ export type {
     AgentChatServer,
     AgentBuilderCapabilitiesResponse,
     AgentBuilderServer,
+    AgentCapabilityConfig,
+    AgentRuntimeConfig,
     SaveAgentRequest,
+    SaveAgentResult,
     Session,
     Turn,
     TurnState,
@@ -148,6 +154,8 @@ export type {
     CatalogServer,
     AgentUIServerPort,
     AgentUIServer,
+    ProviderEntry,
+    ModelProperties,
     ModelSelectorEntry,
     SkillSelectorEntry,
     ConnectorSelectorEntry,

package/src/plugins/truefoundry-agent-server-adapter/cp.test.ts

@@ -149,20 +149,22 @@ describe("normalizeEnabledModels", () => {
 
         expect(rows).toEqual([
             {
+                id: "openai-main/gpt-4.1",
                 name: "gpt-4.1",
-                provider: "openai",
+                provider: { name: "openai" },
+                properties: {},
                 apiModel: "openai-main/gpt-4.1",
                 modelId: "gpt-4.1",
                 providerAccount: "openai-main",
-                id: "openai-main/gpt-4.1",
             },
             {
+                id: "anthropic-prod/claude-sonnet-4-6",
                 name: "claude-sonnet-4-6",
-                provider: "anthropic",
+                provider: { name: "anthropic" },
+                properties: {},
                 apiModel: "anthropic-prod/claude-sonnet-4-6",
                 modelId: "claude-sonnet-4-6",
                 providerAccount: "anthropic-prod",
-                id: "anthropic-prod/claude-sonnet-4-6",
             },
         ]);
     });
@@ -183,12 +185,13 @@ describe("normalizeEnabledModels", () => {
 
         expect(rows).toEqual([
             {
+                id: "virtual-main/router",
                 name: "router",
-                provider: "virtual-model",
+                provider: { name: "virtual-model" },
+                properties: {},
                 apiModel: "virtual-main/router",
                 modelId: "router",
                 providerAccount: "virtual-main",
-                id: "virtual-main/router",
             },
         ]);
     });

package/src/plugins/truefoundry-agent-server-adapter/cp.ts

@@ -9,6 +9,7 @@ import type {
     AgentSelectorEntry,
     ConnectorSelectorEntry,
     ModelSelectorEntry,
+    SaveAgentRequest,
     SearchAgentSelectorParams,
     SkillSelectorEntry,
 } from "../../server/types.js";
@@ -24,7 +25,6 @@ export interface TfyModelSelectorEntry extends ModelSelectorEntry {
     apiModel: string;
     modelId: string;
     providerAccount?: string;
-    id?: string;
 }
 
 export interface TfySkillSelectorEntry extends SkillSelectorEntry {
@@ -163,17 +163,17 @@ function toModelEntry(row: RawEnabledModel): TfyModelSelectorEntry | null {
     if (apiModel == null || apiModel === "" || name == null || name === "") {
         return null;
     }
-    const provider = row.provider ?? "unknown";
     const modelId = row.model_id ?? name;
     return {
+        id: apiModel,
         name,
-        provider,
+        provider: { name: row.provider ?? "unknown" },
+        properties: {},
         apiModel,
         modelId,
         ...(row.provider_account_name != null
             ? { providerAccount: row.provider_account_name }
             : {}),
-        id: apiModel,
     };
 }
 
@@ -596,7 +596,7 @@ export function buildSaveAgentManifest(
  */
 export async function saveAgent(
     opts: CpCredentials,
-    req: { agentName: string; agentSpec: TfyAgentSpec },
+    req: SaveAgentRequest<TfyAgentSpec>,
 ): Promise<unknown> {
     const manifest = buildSaveAgentManifest(req.agentName, req.agentSpec);
     return cpFetch(opts, "/api/svc/v1/agents", {

package/src/plugins/truefoundry-agent-server-adapter/types.ts

@@ -67,9 +67,9 @@ export interface TfyAgentSpec
     extends AgentSpec<
         TruefoundryGatewayApi.Model,
         TfySkillMount,
-        TfyMcpServerMount
+        TfyMcpServerMount,
+        TruefoundryGatewayApi.RuntimeConfig
     > {
-    config?: TruefoundryGatewayApi.RuntimeConfig;
     responseFormat?: TruefoundryGatewayApi.ResponseFormat;
     messages?: TruefoundryGatewayApi.AgentSpecUserMessage[];
 }

package/src/server/index.ts

@@ -1,4 +1,6 @@
 export type {
+    ProviderEntry,
+    ModelProperties,
     ModelSelectorEntry,
     SkillSelectorEntry,
     ConnectorSelectorEntry,
@@ -13,8 +15,11 @@ export type {
     McpServerMount,
     ModelParams,
     Model,
+    AgentCapabilityConfig,
+    AgentRuntimeConfig,
     AgentSpec,
     SaveAgentRequest,
+    SaveAgentResult,
     Session,
     CreateSessionRequest,
     UpdateSessionRequest,

package/src/server/types.ts

@@ -16,14 +16,24 @@ import type {
 // ---------------------------------------------------------------------------
 // Catalog — selector rows (SDK-minimal; host extends via generics)
 // ---------------------------------------------------------------------------
+export interface ProviderEntry {
+  name: string;
+  logo?: string;
+}
+
+export interface ModelProperties {
+  reasoningEfforts?: string[];
+}
 
 /** Model selector row. Host extends for apiModel, modelId, pricing, etc. */
-export interface ModelSelectorEntry {
+export interface ModelSelectorEntry<
+  TProvider extends ProviderEntry = ProviderEntry,
+  TProperties extends ModelProperties = ModelProperties,
+> {
   name: string;
-  provider: string;
-  reasoningEfforts?: string[];
-  /** Provider logo URL from the model catalog; selector falls back to a monogram when omitted. */
-  providerLogo?: string;
+  id: string;
+  provider: TProvider;
+  properties: TProperties;
 }
 
 /** Skill selector row. Host extends for fqn, preload, etc. */
@@ -95,19 +105,31 @@ export interface Model {
   params?: ModelParams;
 }
 
+export interface AgentCapabilityConfig {
+  enabled?: boolean;
+}
+
+export interface AgentRuntimeConfig {
+  generativeUi?: AgentCapabilityConfig;
+  dynamicSubAgents?: AgentCapabilityConfig;
+  askUserQuestions?: AgentCapabilityConfig;
+}
+
 /**
 * SDK-owned agent definition — fields the FE reads/writes.
-* Host widens `model` / `skills` / `mcpServers` via type params, and adds
-* extra fields via `TSpec extends AgentSpec<...>`.
+* Host widens `model` / `skills` / `mcpServers` / `config` via type params,
+* and adds extra fields via `TSpec extends AgentSpec<...>`.
 */
 export interface AgentSpec<
   TModel extends Model = Model,
   TSkill extends SkillMount = SkillMount,
   TMcp extends McpServerMount = McpServerMount,
+  TConfig extends AgentRuntimeConfig = AgentRuntimeConfig,
 > {
   model: TModel;
   skills?: TSkill[];
   mcpServers?: TMcp[];
+  config?: TConfig;
   instructions?: string;
   variables?: Record<string, string>;
 }
@@ -319,6 +341,16 @@ export interface AgentChatServer<
 export interface SaveAgentRequest<TSpec extends AgentSpec = AgentSpec> {
   agentName: string;
   agentSpec: TSpec;
+  intent: "create" | "update";
+  /** Current mutable session to update atomically with the named agent. */
+  sessionId?: string;
+}
+
+export interface SaveAgentResult {
+  /** Immutable id allocated by the host registry. */
+  agentId?: string;
+  /** Timestamp returned when the active mutable session was updated. */
+  sessionUpdatedAt?: string;
 }
 
 /**
@@ -342,7 +374,7 @@ export interface AgentBuilderServer<
   TSkill extends SkillSelectorEntry = SkillSelectorEntry,
   TMcp extends ConnectorSelectorEntry = ConnectorSelectorEntry,
   TAgent extends AgentSelectorEntry = AgentSelectorEntry,
-  TSave = unknown,
+  TSave = SaveAgentResult,
   TCapabilities extends AgentBuilderCapabilitiesResponse = AgentBuilderCapabilitiesResponse,
 > {
   getCapabilities(): Promise<TCapabilities>;

package/src/streamTurn.test.ts

@@ -357,6 +357,24 @@ describe("streamTurn", () => {
             expect(updates).toEqual([{ content: [{ type: "text", text: "resumed" }] }]);
         });
 
+        it("yields nothing when the server omits subscribeToTurn", async () => {
+            const cancelSession = vi.fn().mockResolvedValue(undefined);
+            const server = mockServer({ cancelSession });
+
+            const updates = await collectUpdates(
+                resumeTurnStream(
+                    server,
+                    SESSION_ID,
+                    "turn-1",
+                    new PeerThreadFoldState(),
+                    new AbortController().signal,
+                ),
+            );
+
+            expect(updates).toEqual([]);
+            expect(cancelSession).not.toHaveBeenCalled();
+        });
+
         it("returns early when aborted before streaming starts", async () => {
             const subscribeToTurn = vi.fn(async function* () {});
             const cancelSession = vi.fn().mockResolvedValue(undefined);