@truefoundry/assistant-ui-runtime 0.1.16 → 0.1.18

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, 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 { A as AgentSpec, N as CreateSessionRequest, Y as ListSessionsParams, S as Session, d as Turn, aE as TurnState, a as AgentChatServer, aM as UpdateSessionRequest, k as AgentSelectorEntry, G as ConnectorSelectorEntry, a8 as ModelSelectorEntry, az as SkillSelectorEntry, g as AgentBuilderServer } from '../../types-BRrQpoVy.js';
 import { TruefoundryGatewayApi } from 'truefoundry-gateway-sdk';
 
 /**
@@ -116,7 +116,11 @@ declare function createTrueFoundryChatServer<TSpec extends TfyAgentSpec = TfyAge
  */
 
 interface TfyModelSelectorEntry extends ModelSelectorEntry {
-    /** Write into AgentSpec.model.name (model_fqn). */
+    /**
+     * model_fqn for AgentSpec.model.name.
+     * Same value as {@link ModelSelectorEntry.name} / `id` — trueforge-ui writes
+     * `name` into the spec; keep this alias for hosts that still read `apiModel`.
+     */
     apiModel: string;
     modelId: string;
     providerAccount?: string;

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

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

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-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';
+import { aH as TurnStreamingEvent, aO as DeltaEvents, T as TurnEvent } from '../types-BRrQpoVy.js';
+export { aP as ActionRequiredEvent, f as AgentBuilderCapabilitiesResponse, g as AgentBuilderServer, h as AgentCapabilityConfig, a as AgentChatServer, aQ as AgentInfo, i as AgentLibraryEntry, aR 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, aS 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, aT as McpInitializeEvent, aU as McpServerAuthInfo, Z as McpServerMount, _ as Model, $ as ModelCatalogServer, a0 as ModelEntry, aV as ModelMessageContentPart, aW 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 SandboxProviderListEntry, an as SandboxSnapshotSyncStatus, ao as SaveAgentRequest, ap as SaveAgentResult, aq as SearchAgentSelectorParams, ar as SearchAgentsParams, as as SelectRegistrySkillRequest, S as Session, at as SessionEventItem, au as SkillBase, av as SkillCatalogEntry, aw as SkillCatalogServer, ax as SkillConfigBase, ay as SkillMount, az as SkillSelectorEntry, b as ThreadCreatedEvent, aX as ThreadDoneEvent, aA as ToolApprovalRequiredEvent, aB as ToolBase, aC as ToolCall, aY as ToolCallFunction, aZ as ToolCallRef, a_ as ToolInfo, a$ as ToolResponseEvent, aD as ToolResponseRequiredEvent, d as Turn, b0 as TurnCreatedEvent, b1 as TurnDoneEvent, e as TurnInputItem, aE as TurnState, b2 as TurnStateCancelled, aF as TurnStateDone, b3 as TurnStateError, b4 as TurnStateRunning, aG as TurnStreamData, aI as UpdateConnectorRequest, aJ as UpdateModelProviderRequest, aK as UpdateSandboxProviderRequest, aL as UpdateSandboxRequest, aM as UpdateSessionRequest, aN as UserMessage, b5 as UserMessageContent, c as UserToolApprovalEvent, U as UserToolResponseEvent } from '../types-BRrQpoVy.js';
 
 /**
  * Local implementations of streaming delta helpers.

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

@@ -271,19 +271,19 @@ type SearchAgentSelectorParams = {
     offset?: number;
 };
 /**
-* Mounts written to AgentSpec.skills[] / AgentSpec.mcpServers[].
-*
-* These are opaque to the runtime — it stores and forwards them but never reads
-* a field, and the backend owns the shape (the gateway identifies a skill by
-* `fqn`, with no `id` or `name` anywhere). So the base constrains only that a
-* mount is an object; hosts intersect their concrete mount type over it, as
-* `TfySkillMount` / `TfyMcpServerMount` do in the gateway adapter.
-*
-* Naming a field here would not just be unread, it would be wrong: a base with
-* required fields rejects the backend's own payloads, and one with only optional
-* fields is a weak type, which TypeScript rejects for a source that shares no
-* property with it — the gateway's registry skill shares none.
-*/
+ * Mounts written to AgentSpec.skills[] / AgentSpec.mcpServers[].
+ *
+ * These are opaque to the runtime — it stores and forwards them but never reads
+ * a field, and the backend owns the shape (the gateway identifies a skill by
+ * `fqn`, with no `id` or `name` anywhere). So the base constrains only that a
+ * mount is an object; hosts intersect their concrete mount type over it, as
+ * `TfySkillMount` / `TfyMcpServerMount` do in the gateway adapter.
+ *
+ * Naming a field here would not just be unread, it would be wrong: a base with
+ * required fields rejects the backend's own payloads, and one with only optional
+ * fields is a weak type, which TypeScript rejects for a source that shares no
+ * property with it — the gateway's registry skill shares none.
+ */
 type SkillMount = object;
 type McpServerMount = object;
 interface ModelParams {
@@ -303,10 +303,10 @@ interface AgentRuntimeConfig {
     askUserQuestions?: AgentCapabilityConfig;
 }
 /**
-* SDK-owned agent definition — fields the FE reads/writes.
-* Host widens `model` / `skills` / `mcpServers` / `config` via type params,
-* and adds extra fields via `TSpec extends AgentSpec<...>`.
-*/
+ * SDK-owned agent definition — fields the FE reads/writes.
+ * 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, TConfig extends AgentRuntimeConfig = AgentRuntimeConfig> {
     model: TModel;
     skills?: TSkill[];
@@ -413,11 +413,11 @@ interface Turn {
     createdAt: string;
 }
 /**
-* Chat / session port — the runtime calls these.
-*
-* All session ops are flat (sessionId param). No gateway client dependency.
-* `createTrueFoundryServer` is one possible implementation (TFY adapter).
-*/
+ * Chat / session port — the runtime calls these.
+ *
+ * All session ops are flat (sessionId param). No gateway client dependency.
+ * `createTrueFoundryServer` is one possible implementation (TFY adapter).
+ */
 interface AgentChatServer<TSpec extends AgentSpec = AgentSpec, TSession extends Session<TSpec> = Session<TSpec>, TCreate extends CreateSessionRequest<TSpec> = CreateSessionRequest<TSpec>, TList extends ListSessionsParams = ListSessionsParams, TUpdate extends UpdateSessionRequest<TSpec> = UpdateSessionRequest<TSpec>, TTurn extends Turn = Turn> {
     createSession(req: TCreate): Promise<TSession>;
     listSessions(req?: TList): Promise<ListResult<TSession>>;
@@ -512,9 +512,9 @@ interface AgentBuilderCapabilitiesResponse {
     };
 }
 /**
-* Builder catalog + persist port — atoms call these.
-* Passed separately from the runtime's chat server.
-*/
+ * 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 = SaveAgentResult, TCapabilities extends AgentBuilderCapabilitiesResponse = AgentBuilderCapabilitiesResponse> {
     getCapabilities(): Promise<TCapabilities>;
     getModels(): Promise<TModel[]>;
@@ -527,25 +527,25 @@ interface AgentBuilderServer<TSpec extends AgentSpec = AgentSpec, TModel extends
     }): Promise<void>;
 }
 /**
-* Provider type id. Reserved literal: `"custom"` for user-defined providers;
-* any other string is a builtin (e.g. `"openai"`, `"anthropic"`).
-*
-* Note: `string | "custom"` is useless in TypeScript (`"custom"` ⊆ `string`),
-* so this stays `string` and `"custom"` is a documented convention.
-*/
+ * Provider type id. Reserved literal: `"custom"` for user-defined providers;
+ * any other string is a builtin (e.g. `"openai"`, `"anthropic"`).
+ *
+ * Note: `string | "custom"` is useless in TypeScript (`"custom"` ⊆ `string`),
+ * so this stays `string` and `"custom"` is a documented convention.
+ */
 type ProviderType = string;
 /**
-* Model row — form "Model ID" + "Display name".
-* Host extends for properties, etc.
-*/
+ * Model row — form "Model ID" + "Display name".
+ * Host extends for properties, etc.
+ */
 interface ModelEntry {
     id: string;
     name: string;
 }
 /**
-* Write config for create/update (custom form + catalog "Save key").
-* Host extends. `baseUrl` present iff `type === "custom"`.
-*/
+ * Write config for create/update (custom form + catalog "Save key").
+ * Host extends. `baseUrl` present iff `type === "custom"`.
+ */
 interface ModelProviderConfigBase<TModel extends ModelEntry = ModelEntry> {
     type: ProviderType;
     name: string;
@@ -555,9 +555,9 @@ interface ModelProviderConfigBase<TModel extends ModelEntry = ModelEntry> {
     models: TModel[];
 }
 /**
-* Configured provider card (list/read). No raw `apiKey`.
-* Host extends for apiKeySet, timestamps, etc.
-*/
+ * Configured provider card (list/read). No raw `apiKey`.
+ * Host extends for apiKeySet, timestamps, etc.
+ */
 interface ModelProviderBase<TModel extends ModelEntry = ModelEntry> {
     id: string;
     type: ProviderType;
@@ -567,10 +567,10 @@ interface ModelProviderBase<TModel extends ModelEntry = ModelEntry> {
     models: TModel[];
 }
 /**
-* Discovery-only catalog provider (AVAILABLE list).
-* `type` must not be `"custom"` — custom providers use the custom form.
-* Host extends for richer model rows.
-*/
+ * Discovery-only catalog provider (AVAILABLE list).
+ * `type` must not be `"custom"` — custom providers use the custom form.
+ * Host extends for richer model rows.
+ */
 interface ModelProviderCatalogEntry<TModel extends ModelEntry = ModelEntry> {
     type: ProviderType;
     name: string;
@@ -628,10 +628,11 @@ type ConnectorAuthPublicNone = {
 };
 type ConnectorAuthPublic = ConnectorAuthPublicOAuth | ConnectorAuthPublicApiKey | ConnectorAuthPublicNone;
 /**
-* MCP / connector create-edit config. Host extends for extra fields, etc.
-*/
+ * MCP / connector create-edit config. Host extends for extra fields, etc.
+ */
 interface ConnectorConfigBase<TAuth extends ConnectorAuth = ConnectorAuth> {
     name: string;
+    description: string;
     url: string;
     auth: TAuth;
 }
@@ -749,7 +750,6 @@ interface SkillCatalogServer<TSkill extends SkillBase = SkillBase, TCatalogEntry
 }
 /** Mutable sandbox provider settings shared by catalog rows, create, and update. */
 interface SandboxConfig {
-    snapshotName: string;
     execTimeoutMs: number;
     autoStopIntervalInMinutes: number;
     autoArchiveIntervalInMinutes: number;
@@ -770,6 +770,14 @@ interface SandboxBase extends SandboxConfig {
     catalogId: string;
     isConnected: boolean;
 }
+type SandboxSnapshotSyncStatus = {
+    status: "pending" | "ready" | "failed";
+    statusReason?: string | null;
+};
+interface SandboxProviderListEntry<TSandbox extends SandboxBase = SandboxBase> {
+    data: TSandbox;
+    snapshotSyncStatus: SandboxSnapshotSyncStatus;
+}
 interface CreateSandboxRequest extends SandboxConfig {
     /** `SandboxCatalogEntry.id` used to create this sandbox provider. */
     catalogId: string;
@@ -788,11 +796,11 @@ type SandboxProviderCatalogEntry = SandboxCatalogEntry;
 type SandboxProviderBase = SandboxBase;
 type CreateSandboxProviderRequest = CreateSandboxRequest;
 type UpdateSandboxProviderRequest = UpdateSandboxRequest;
-interface SandboxCatalogServer<TProvider extends SandboxBase = SandboxBase, TCatalogEntry extends SandboxCatalogEntry = SandboxCatalogEntry, TCreate extends CreateSandboxRequest = CreateSandboxRequest, TUpdate extends UpdateSandboxRequest = UpdateSandboxRequest> {
+interface SandboxCatalogServer<TProvider extends SandboxBase = SandboxBase, TCatalogEntry extends SandboxCatalogEntry = SandboxCatalogEntry, TCreate extends CreateSandboxRequest = CreateSandboxRequest, TUpdate extends UpdateSandboxRequest = UpdateSandboxRequest, TListEntry extends SandboxProviderListEntry<TProvider> = SandboxProviderListEntry<TProvider>> {
     getSandboxProviderCatalog(): Promise<TCatalogEntry[]>;
     listSandboxProviders(req?: {
         query?: string;
-    }): Promise<TProvider[]>;
+    }): Promise<TListEntry[]>;
     createSandboxProvider(req: TCreate): Promise<TProvider>;
     updateSandboxProvider(req: TUpdate): Promise<TProvider>;
     deleteSandboxProvider?(req: {
@@ -806,10 +814,10 @@ type ConnectorState = ConnectorSelectorEntry;
 type AgentLibraryEntry = AgentSelectorEntry;
 type SearchAgentsParams = SearchAgentSelectorParams;
 /**
-* Settings management aggregate — modelCatalog + connectorCatalog + optional
-* skill and sandbox catalogs.
-* Hosts may pass the whole object to an app shell, or a focused sub-port to a page.
-*/
+ * Settings management aggregate — modelCatalog + connectorCatalog + optional
+ * skill and sandbox catalogs.
+ * Hosts may pass the whole object to an app shell, or a focused sub-port to a page.
+ */
 interface CatalogServer<TModelCatalog extends ModelCatalogServer = ModelCatalogServer, TConnectorCatalog extends ConnectorCatalogServer = ConnectorCatalogServer, TSkillCatalog extends SkillCatalogServer = SkillCatalogServer, TSandboxCatalog extends SandboxCatalogServer = SandboxCatalogServer> {
     modelCatalog: TModelCatalog;
     connectorCatalog: TConnectorCatalog;
@@ -833,4 +841,4 @@ type AgentUIServerPort<TChat extends AgentChatServer = AgentChatServer, TBuilder
 /** Host-facing alias used by trueforge-ui. */
 type AgentUIServer = AgentUIServerPort;
 
-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 };
+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, ToolResponseEvent 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, ToolApprovalRequiredEvent as aA, ToolBase as aB, ToolCall as aC, ToolResponseRequiredEvent as aD, TurnState as aE, TurnStateDone as aF, TurnStreamData as aG, TurnStreamingEvent as aH, UpdateConnectorRequest as aI, UpdateModelProviderRequest as aJ, UpdateSandboxProviderRequest as aK, UpdateSandboxRequest as aL, UpdateSessionRequest as aM, UserMessage as aN, DeltaEvents as aO, ActionRequiredEvent as aP, AgentInfo as aQ, AgentParent as aR, ChunkDeltaToolCall as aS, McpInitializeEvent as aT, McpServerAuthInfo as aU, ModelMessageContentPart as aV, ModelMessageDeltaEvent as aW, ThreadDoneEvent as aX, ToolCallFunction as aY, ToolCallRef as aZ, ToolInfo 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, SandboxProviderListEntry as am, SandboxSnapshotSyncStatus as an, SaveAgentRequest as ao, SaveAgentResult as ap, SearchAgentSelectorParams as aq, SearchAgentsParams as ar, SelectRegistrySkillRequest as as, SessionEventItem as at, SkillBase as au, SkillCatalogEntry as av, SkillCatalogServer as aw, SkillConfigBase as ax, SkillMount as ay, SkillSelectorEntry as az, ThreadCreatedEvent as b, TurnCreatedEvent as b0, TurnDoneEvent as b1, TurnStateCancelled as b2, TurnStateError as b3, TurnStateRunning as b4, UserMessageContent as b5, 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.16",
+  "version": "0.1.18",
   "description": "TrueFoundry Gateway agent runtime adapter for assistant-ui",
   "license": "Apache-2.0",
   "repository": {
@@ -81,4 +81,4 @@
     "typescript": "^5.9.3",
     "vitest": "4.1.9"
   }
-}
+}

package/src/hooks.ts

@@ -6,7 +6,8 @@ import { useAui, useAuiState } from "@assistant-ui/store";
 import type { TrueFoundryMessageCustomMetadata } from "./messageCustomMetadata.js";
 import {
     EMPTY_DRAFT_EXTRAS,
-    trueFoundryExtras,
+    getTrueFoundryExtras,
+    useTrueFoundryRuntimeExtras,
     type TrueFoundryDraftRuntimeExtras,
 } from "./truefoundryExtras.js";
 import type { RespondToToolApprovalOptions } from "./toolApproval.js";
@@ -14,7 +15,7 @@ import type { RespondToToolResponseOptions } from "./toolResponse.js";
 
 /** Pending tool approvals plus a respond action. */
 export const useTrueFoundryApprovals = () => {
-    const extras = trueFoundryExtras.use((e) => e, undefined);
+    const extras = useTrueFoundryRuntimeExtras();
 
     return useMemo(
         () => ({
@@ -31,7 +32,7 @@ export const useTrueFoundryApprovals = () => {
 
 /** Pending ask-user tool responses plus a respond action. */
 export const useTrueFoundryToolResponses = () => {
-    const extras = trueFoundryExtras.use((e) => e, undefined);
+    const extras = useTrueFoundryRuntimeExtras();
 
     return useMemo(
         () => ({
@@ -48,7 +49,7 @@ export const useTrueFoundryToolResponses = () => {
 
 /** Pending MCP OAuth plus a resume action. */
 export const useTrueFoundryMcpAuth = () => {
-    const extras = trueFoundryExtras.use((e) => e, undefined);
+    const extras = useTrueFoundryRuntimeExtras();
 
     return useMemo(
         () => ({
@@ -67,25 +68,25 @@ export const useTrueFoundryMcpAuth = () => {
 export const useTrueFoundryRespondToToolApproval = () => {
     const aui = useAui();
     return (response: RespondToToolApprovalOptions) =>
-        trueFoundryExtras.get(aui).respondToToolApproval(response);
+        getTrueFoundryExtras(aui).respondToToolApproval(response);
 };
 
 /** Returns a function to respond to a pending tool response from any render context. */
 export const useTrueFoundryRespondToToolResponse = () => {
     const aui = useAui();
     return (response: RespondToToolResponseOptions) =>
-        trueFoundryExtras.get(aui).respondToToolResponse(response);
+        getTrueFoundryExtras(aui).respondToToolResponse(response);
 };
 
 /** Returns a function to resume after MCP OAuth from any render context. */
 export const useTrueFoundryResumeMcpAuth = () => {
     const aui = useAui();
-    return () => trueFoundryExtras.get(aui).resumeMcpAuth();
+    return () => getTrueFoundryExtras(aui).resumeMcpAuth();
 };
 
 /** Current sandboxId for this session, if a sandbox has been created. */
 export const useTrueFoundrySandboxId = (): string | undefined =>
-    trueFoundryExtras.use((e) => e.sandboxId, undefined);
+    useTrueFoundryRuntimeExtras()?.sandboxId;
 
 /** Turn that produced the message being rendered. Only defined inside a message scope. */
 export const useTrueFoundryTurnId = (): string | undefined =>
@@ -108,25 +109,25 @@ export const useTrueFoundryDownloadSandboxFile = () => {
                 "Downloading a sandbox file requires a message scope to resolve its turn.",
             );
         }
-        return trueFoundryExtras.get(aui).downloadSandboxFile({ turnId, path });
+        return getTrueFoundryExtras(aui).downloadSandboxFile({ turnId, path });
     };
 };
 
 /** Returns a function to cancel the current run from any render context. */
 export const useTrueFoundryCancel = () => {
     const aui = useAui();
-    return () => trueFoundryExtras.get(aui).cancel();
+    return () => getTrueFoundryExtras(aui).cancel();
 };
 
 /** Returns a function to reload (retry) the current session from any render context. */
 export const useTrueFoundryReload = () => {
     const aui = useAui();
-    return () => trueFoundryExtras.get(aui).reload();
+    return () => getTrueFoundryExtras(aui).reload();
 };
 
 /** Older history pagination state plus a load-more action for scroll-up. */
 export const useTrueFoundryHistoryPagination = () => {
-    const extras = trueFoundryExtras.use((e) => e, undefined);
+    const extras = useTrueFoundryRuntimeExtras();
 
     return useMemo(
         () => ({
@@ -147,17 +148,17 @@ export const useTrueFoundryHistoryPagination = () => {
  * arrive in this client. Falls back to `false` on runtimes that predate the flag.
  */
 export const useTrueFoundryResumeUnavailable = () =>
-    trueFoundryExtras.use((e) => e.resumeUnavailable, false) ?? false;
+    useTrueFoundryRuntimeExtras()?.resumeUnavailable ?? false;
 
 /** Returns a function to reset (re-submit) a user turn from any render context. */
 export const useTrueFoundryResetFromTurn = () => {
     const aui = useAui();
-    return (turnId: string) => trueFoundryExtras.get(aui).resetFromTurn(turnId);
+    return (turnId: string) => getTrueFoundryExtras(aui).resetFromTurn(turnId);
 };
 
 /** Current draft agent spec and sync state (draft mode only). */
 export const useTrueFoundryAgentSpec = () => {
-    const extras = trueFoundryExtras.use((e) => e.draft, null);
+    const extras = useTrueFoundryRuntimeExtras()?.draft ?? null;
 
     return useMemo(
         () => ({ ...EMPTY_DRAFT_EXTRAS, ...extras }),
@@ -169,14 +170,14 @@ export const useTrueFoundryAgentSpec = () => {
 export const useTrueFoundryUpdateAgentSpec = () => {
     const aui = useAui();
     return (update: Parameters<TrueFoundryDraftRuntimeExtras["updateAgentSpec"]>[0]) =>
-        trueFoundryExtras.get(aui).draft?.updateAgentSpec(update);
+        getTrueFoundryExtras(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();
+        getTrueFoundryExtras(aui).draft?.flushAgentSpec() ?? Promise.resolve();
 };
 
 /** Adopts a spec already persisted by another server operation without syncing again. */
@@ -184,6 +185,5 @@ export const useTrueFoundryAdoptAgentSpec = () => {
     const aui = useAui();
     return (
         request: Parameters<TrueFoundryDraftRuntimeExtras["adoptAgentSpec"]>[0],
-    ) => trueFoundryExtras.get(aui).draft?.adoptAgentSpec(request);
+    ) => getTrueFoundryExtras(aui).draft?.adoptAgentSpec(request);
 };
-

package/src/index.ts

@@ -42,7 +42,11 @@ export type {
 } from "./messageCustomMetadata.js";
 export type { PendingApproval, PendingToolResponse } from "./collectPending.js";
 export type { TrueFoundryRuntimeExtras } from "./truefoundryExtras.js";
-export { trueFoundryExtras } from "./truefoundryExtras.js";
+export {
+    trueFoundryExtras,
+    getTrueFoundryExtras,
+    tryGetTrueFoundryExtras,
+} from "./truefoundryExtras.js";
 export {
     useTrueFoundryApprovals,
     useTrueFoundryToolResponses,
@@ -143,6 +147,8 @@ export type {
     SandboxConfig,
     SandboxCatalogEntry,
     SandboxBase,
+    SandboxSnapshotSyncStatus,
+    SandboxProviderListEntry,
     CreateSandboxRequest,
     UpdateSandboxRequest,
     SandboxProviderConfig,

package/src/plugins/truefoundry-agent-server-adapter/README.md

@@ -89,7 +89,7 @@ Implemented against Control Plane HTTP (not the gateway SDK):
 
 | Method | CP path |
 | ------ | ------- |
-| `getModels` | `GET /api/svc/v1/llm-gateway/model/enabled` |
+| `getModels` | `GET /api/svc/v1/llm-gateway/model/enabled` (+ `GET /api/svc/v1/provider-accounts/providers` for `properties.reasoningEfforts`) |
 | `getSkills` | `GET /api/ml/v1/agent-skills?include_empty_agent_skills=false` |
 | `getMcp` | `GET /api/svc/v1/mcp-servers` |
 | `searchAgents` | `GET /api/svc/v1/agents?type=truefoundry-agent&…` |

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

@@ -150,7 +150,7 @@ describe("normalizeEnabledModels", () => {
         expect(rows).toEqual([
             {
                 id: "openai-main/gpt-4.1",
-                name: "gpt-4.1",
+                name: "openai-main/gpt-4.1",
                 provider: { name: "openai" },
                 properties: {},
                 apiModel: "openai-main/gpt-4.1",
@@ -159,7 +159,7 @@ describe("normalizeEnabledModels", () => {
             },
             {
                 id: "anthropic-prod/claude-sonnet-4-6",
-                name: "claude-sonnet-4-6",
+                name: "anthropic-prod/claude-sonnet-4-6",
                 provider: { name: "anthropic" },
                 properties: {},
                 apiModel: "anthropic-prod/claude-sonnet-4-6",
@@ -186,7 +186,7 @@ describe("normalizeEnabledModels", () => {
         expect(rows).toEqual([
             {
                 id: "virtual-main/router",
-                name: "router",
+                name: "virtual-main/router",
                 provider: { name: "virtual-model" },
                 properties: {},
                 apiModel: "virtual-main/router",

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

@@ -13,6 +13,11 @@ import type {
     SearchAgentSelectorParams,
     SkillSelectorEntry,
 } from "../../server/types.js";
+import {
+    buildMetadataMap,
+    metadataKey,
+    reasoningEffortsForModel,
+} from "./modelReasoningEffort.js";
 import { normalizeAgentSpecForGateway } from "./normalizeAgentSpec.js";
 import type { TfyAgentSpec } from "./types.js";
 
@@ -21,7 +26,11 @@ import type { TfyAgentSpec } from "./types.js";
 // ---------------------------------------------------------------------------
 
 export interface TfyModelSelectorEntry extends ModelSelectorEntry {
-    /** Write into AgentSpec.model.name (model_fqn). */
+    /**
+     * model_fqn for AgentSpec.model.name.
+     * Same value as {@link ModelSelectorEntry.name} / `id` — trueforge-ui writes
+     * `name` into the spec; keep this alias for hosts that still read `apiModel`.
+     */
     apiModel: string;
     modelId: string;
     providerAccount?: string;
@@ -158,15 +167,17 @@ function isChatModel(row: RawEnabledModel): boolean {
 
 function toModelEntry(row: RawEnabledModel): TfyModelSelectorEntry | null {
     if (!isChatModel(row)) return null;
+    // Gateway AgentSpec.model.name must be model_fqn (e.g. account/model-id).
+    // trueforge-ui DraftModelSelector writes ModelSelectorEntry.name into that
+    // field, so `name` is the FQN — not the CP short display label.
     const apiModel = row.model_fqn ?? row.id;
-    const name = row.name;
-    if (apiModel == null || apiModel === "" || name == null || name === "") {
+    if (apiModel == null || apiModel === "") {
         return null;
     }
-    const modelId = row.model_id ?? name;
+    const modelId = row.model_id ?? row.name ?? apiModel;
     return {
         id: apiModel,
-        name,
+        name: apiModel,
         provider: { name: row.provider ?? "unknown" },
         properties: {},
         apiModel,
@@ -219,14 +230,44 @@ export function normalizeEnabledModels(raw: unknown): TfyModelSelectorEntry[] {
     return out;
 }
 
+/**
+ * Attach `properties.reasoningEfforts` from provider-account metadata when the
+ * model supports thinking. Pure — used by {@link listEnabledModels} and tests.
+ */
+export function enrichModelsWithReasoningEfforts(
+    models: TfyModelSelectorEntry[],
+    providerMetadataRaw: unknown,
+): TfyModelSelectorEntry[] {
+    const map = buildMetadataMap(providerMetadataRaw);
+    if (map.size === 0) return models;
+    return models.map((model) => {
+        const meta = map.get(metadataKey(model.provider.name, model.modelId));
+        const reasoningEfforts = reasoningEffortsForModel(
+            meta,
+            model.provider.name,
+        );
+        if (reasoningEfforts == null) return model;
+        return {
+            ...model,
+            properties: { ...model.properties, reasoningEfforts },
+        };
+    });
+}
+
 export async function listEnabledModels(
     opts: CpCredentials,
 ): Promise<TfyModelSelectorEntry[]> {
-    const raw = await cpFetch<unknown>(
-        opts,
-        "/api/svc/v1/llm-gateway/model/enabled",
-    );
-    return normalizeEnabledModels(raw);
+    // Parallel: providers is enrichment-only; soft-fail keeps models usable.
+    const [raw, providers] = await Promise.all([
+        cpFetch<unknown>(opts, "/api/svc/v1/llm-gateway/model/enabled"),
+        cpFetch<unknown>(
+            opts,
+            "/api/svc/v1/provider-accounts/providers",
+        ).catch(() => null),
+    ]);
+    const models = normalizeEnabledModels(raw);
+    if (providers == null) return models;
+    return enrichModelsWithReasoningEfforts(models, providers);
 }
 
 // ---------------------------------------------------------------------------