@truefoundry/assistant-ui-runtime 0.1.16 → 0.1.17

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as _assistant_ui_core from '@assistant-ui/core';
 import { ExternalStoreSharedOptions, AttachmentAdapter, SpeechSynthesisAdapter, DictationAdapter, RealtimeVoiceAdapter, FeedbackAdapter, ThreadAssistantMessagePart, ThreadMessage, AppendMessage, ExportedMessageRepositoryItem, RemoteThreadListAdapter } from '@assistant-ui/core';
-import { A as AgentSpec, a as AgentChatServer, T as TurnEvent, b as ThreadCreatedEvent, U as UserToolResponseEvent, M as McpAuthRequiredEvent, c as UserToolApprovalEvent, d as Turn, e as TurnInputItem, S as Session } from './types-VU3Fc17W.js';
-export { f as AgentBuilderCapabilitiesResponse, g as AgentBuilderServer, h as AgentCapabilityConfig, i as AgentLibraryEntry, j as AgentRuntimeConfig, k as AgentSelectorEntry, l as AgentSkill, m as AgentUIServer, n as AgentUIServerPort, o as ApprovalDecision, p as AuthenticateConnectorRequest, C as CatalogServer, 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, Z as McpServerMount, _ as Model, $ as ModelCatalogServer, a0 as ModelEntry, 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, ar as SessionEventItem, as as SkillBase, at as SkillCatalogEntry, au as SkillCatalogServer, av as SkillConfigBase, aw as SkillMount, ax as SkillSelectorEntry, ay as ToolApprovalRequiredEvent, az as ToolBase, aA as ToolCall, aB as ToolResponseRequiredEvent, aC as TurnState, aD as TurnStateDone, aE as TurnStreamData, aF as TurnStreamingEvent, aG as UpdateConnectorRequest, aH as UpdateModelProviderRequest, aI as UpdateSandboxProviderRequest, aJ as UpdateSandboxRequest, aK as UpdateSessionRequest, aL as UserMessage } from './types-VU3Fc17W.js';
+import { A as AgentSpec, a as AgentChatServer, T as TurnEvent, b as ThreadCreatedEvent, U as UserToolResponseEvent, M as McpAuthRequiredEvent, c as UserToolApprovalEvent, d as Turn, e as TurnInputItem, S as Session } from './types-CctJojlz.js';
+export { f as AgentBuilderCapabilitiesResponse, g as AgentBuilderServer, h as AgentCapabilityConfig, i as AgentLibraryEntry, j as AgentRuntimeConfig, k as AgentSelectorEntry, l as AgentSkill, m as AgentUIServer, n as AgentUIServerPort, o as ApprovalDecision, p as AuthenticateConnectorRequest, C as CatalogServer, 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, Z as McpServerMount, _ as Model, $ as ModelCatalogServer, a0 as ModelEntry, 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, at as SessionEventItem, au as SkillBase, av as SkillCatalogEntry, aw as SkillCatalogServer, ax as SkillConfigBase, ay as SkillMount, az as SkillSelectorEntry, aA as ToolApprovalRequiredEvent, aB as ToolBase, aC as ToolCall, aD as ToolResponseRequiredEvent, aE as TurnState, aF as TurnStateDone, aG as TurnStreamData, aH as TurnStreamingEvent, aI as UpdateConnectorRequest, aJ as UpdateModelProviderRequest, aK as UpdateSandboxProviderRequest, aL as UpdateSandboxRequest, aM as UpdateSessionRequest, aN as UserMessage } from './types-CctJojlz.js';
 import * as _assistant_ui_core_internal from '@assistant-ui/core/internal';
 export { isEventDelta, mergeEventDelta } from './server/index.js';
 export { CreateTrueFoundryAgentUIServerOptions, CreateTrueFoundryChatServerOptions, RequireApprovalToolSelectorItem, RequireApprovalToolsSelectorTag, TfyAgentSelectorEntry, TfyAgentSpec, TfyConnectorSelectorEntry, TfyCreateSessionRequest, TfyFinishReason, TfyListSessionsParams, TfyMcpServerInitInfo, TfyMcpServerMount, TfyMcpToolInfo, TfyModelMessageUsage, TfyModelParams, TfyModelSelectorEntry, TfyResponseFormat, TfyRuntimeConfig, TfySession, TfySkillMount, TfySkillSelectorEntry, TfySubject, TfySystemToolInfo, TfyThreadState, TfyToolInfo, TfyTurn, TfyTurnCancelledReason, TfyTurnState, TfyTurnStateDoneOutput, ToolsSelectorItem, ToolsSelectorTag, TrueFoundryAgentUIServer, TrueFoundryChatServer, createTrueFoundryAgentUIServer, createTrueFoundryChatServer, getTfyMcpInitServers, getTfyThreadState, getTfyUsage, isTfyMcpToolInfo, isTfySystemToolInfo, isTfyToolInfo } from './plugins/truefoundry-agent-server-adapter/index.js';

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-CctJojlz.js';
 import { TruefoundryGatewayApi } from 'truefoundry-gateway-sdk';
 
 /**

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-CctJojlz.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-CctJojlz.js';
 
 /**
  * Local implementations of streaming delta helpers.

package/dist/{types-VU3Fc17W.d.ts → types-CctJojlz.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,8 +628,8 @@ 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;
     url: string;
@@ -749,7 +749,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 +769,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 +795,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 +813,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 +840,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.17",
   "description": "TrueFoundry Gateway agent runtime adapter for assistant-ui",
   "license": "Apache-2.0",
   "repository": {

package/src/index.ts

@@ -143,6 +143,8 @@ export type {
     SandboxConfig,
     SandboxCatalogEntry,
     SandboxBase,
+    SandboxSnapshotSyncStatus,
+    SandboxProviderListEntry,
     CreateSandboxRequest,
     UpdateSandboxRequest,
     SandboxProviderConfig,

package/src/server/index.ts

@@ -83,6 +83,8 @@ export type {
     SandboxConfig,
     SandboxCatalogEntry,
     SandboxBase,
+    SandboxSnapshotSyncStatus,
+    SandboxProviderListEntry,
     CreateSandboxRequest,
     UpdateSandboxRequest,
     SandboxProviderConfig,

package/src/server/types.ts

@@ -10,7 +10,7 @@ import type {
   ActionRequiredEvent,
   SessionEventItem,
   TurnEvent,
-  TurnStreamData
+  TurnStreamData,
 } from "./events.js";
 
 // ---------------------------------------------------------------------------
@@ -74,19 +74,19 @@ export type SearchAgentSelectorParams = {
 // ---------------------------------------------------------------------------
 
 /**
-* 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.
+ */
 export type SkillMount = object;
 
 export type McpServerMount = object;
@@ -116,10 +116,10 @@ export interface AgentRuntimeConfig {
 }
 
 /**
-* 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<...>`.
+ */
 export interface AgentSpec<
   TModel extends Model = Model,
   TSkill extends SkillMount = SkillMount,
@@ -193,7 +193,10 @@ export type PreviousTurnIdInput = "auto" | "none" | string;
 
 export type UserMessageContent =
   | string
-  | Array<{ type: "text"; text: string } | { type: "file"; name: string; data: string }>;
+  | Array<
+      | { type: "text"; text: string }
+      | { type: "file"; name: string; data: string }
+    >;
 
 export interface UserMessage {
   type: "user.message";
@@ -265,11 +268,11 @@ export interface Turn {
 // ---------------------------------------------------------------------------
 
 /**
-* 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).
+ */
 export interface AgentChatServer<
   TSpec extends AgentSpec = AgentSpec,
   TSession extends Session<TSpec> = Session<TSpec>,
@@ -284,44 +287,44 @@ export interface AgentChatServer<
   updateSession(req: TUpdate): Promise<TSession>;
 
   createTurn(req: {
-      sessionId: string;
-      input?: TurnInputItem[];
-      previousTurnId?: PreviousTurnIdInput;
-      abortSignal?: AbortSignal;
-      headers?: Record<string, string>;
+    sessionId: string;
+    input?: TurnInputItem[];
+    previousTurnId?: PreviousTurnIdInput;
+    abortSignal?: AbortSignal;
+    headers?: Record<string, string>;
   }): AsyncIterable<TurnStreamData>;
 
   cancelSession(req: { sessionId: string }): Promise<void>;
   deleteSession?(req: { sessionId: string }): Promise<void>;
 
   listTurns(req: {
-      sessionId: string;
-      limit?: number;
-      pageToken?: string;
-      order?: ListSessionsOrder;
+    sessionId: string;
+    limit?: number;
+    pageToken?: string;
+    order?: ListSessionsOrder;
   }): Promise<ListResult<TTurn>>;
   getTurn(req: { sessionId: string; turnId: string }): Promise<TTurn>;
   listEvents(req: {
-      sessionId: string;
-      pageToken?: string;
-      lastTurnId?: string;
-      limit?: number;
+    sessionId: string;
+    pageToken?: string;
+    lastTurnId?: string;
+    limit?: number;
   }): Promise<ListResult<SessionEventItem>>;
 
   /** Optional per-turn event listing (hydrate in-flight turn content). */
   listTurnEvents?(req: {
-      sessionId: string;
-      turnId: string;
-      limit?: number;
-      pageToken?: string;
-      order?: ListSessionsOrder;
+    sessionId: string;
+    turnId: string;
+    limit?: number;
+    pageToken?: string;
+    order?: ListSessionsOrder;
   }): Promise<ListResult<TurnEvent>>;
 
   subscribeToTurn?(req: {
-      sessionId: string;
-      turnId: string;
-      afterSequenceNumber?: number;
-      abortSignal?: AbortSignal;
+    sessionId: string;
+    turnId: string;
+    afterSequenceNumber?: number;
+    abortSignal?: AbortSignal;
   }): AsyncIterable<TurnStreamData>;
 
   /**
@@ -330,10 +333,10 @@ export interface AgentChatServer<
    * directly use `sandboxId`.
    */
   downloadSandboxFile?(req: {
-      sessionId: string;
-      turnId: string;
-      sandboxId: string;
-      path: string;
+    sessionId: string;
+    turnId: string;
+    sandboxId: string;
+    path: string;
   }): Promise<Blob>;
 }
 
@@ -365,9 +368,9 @@ export 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.
+ */
 export interface AgentBuilderServer<
   TSpec extends AgentSpec = AgentSpec,
   TModel extends ModelSelectorEntry = ModelSelectorEntry,
@@ -375,7 +378,8 @@ export interface AgentBuilderServer<
   TMcp extends ConnectorSelectorEntry = ConnectorSelectorEntry,
   TAgent extends AgentSelectorEntry = AgentSelectorEntry,
   TSave = SaveAgentResult,
-  TCapabilities extends AgentBuilderCapabilitiesResponse = AgentBuilderCapabilitiesResponse,
+  TCapabilities extends AgentBuilderCapabilitiesResponse =
+    AgentBuilderCapabilitiesResponse,
 > {
   getCapabilities(): Promise<TCapabilities>;
   getModels(): Promise<TModel[]>;
@@ -391,28 +395,30 @@ export interface AgentBuilderServer<
 // ---------------------------------------------------------------------------
 
 /**
-* 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.
+ */
 export 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.
+ */
 export interface ModelEntry {
   id: string;
   name: string;
 }
 
 /**
-* Write config for create/update (custom form + catalog "Save key").
-* Host extends. `baseUrl` present iff `type === "custom"`.
-*/
-export interface ModelProviderConfigBase<TModel extends ModelEntry = ModelEntry> {
+ * Write config for create/update (custom form + catalog "Save key").
+ * Host extends. `baseUrl` present iff `type === "custom"`.
+ */
+export interface ModelProviderConfigBase<
+  TModel extends ModelEntry = ModelEntry,
+> {
   type: ProviderType;
   name: string;
   /** Present iff `type === "custom"`. */
@@ -422,9 +428,9 @@ export interface ModelProviderConfigBase<TModel extends ModelEntry = ModelEntry>
 }
 
 /**
-* 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.
+ */
 export interface ModelProviderBase<TModel extends ModelEntry = ModelEntry> {
   id: string;
   type: ProviderType;
@@ -435,11 +441,13 @@ export interface ModelProviderBase<TModel extends ModelEntry = ModelEntry> {
 }
 
 /**
-* Discovery-only catalog provider (AVAILABLE list).
-* `type` must not be `"custom"` — custom providers use the custom form.
-* Host extends for richer model rows.
-*/
-export interface ModelProviderCatalogEntry<TModel extends ModelEntry = ModelEntry> {
+ * Discovery-only catalog provider (AVAILABLE list).
+ * `type` must not be `"custom"` — custom providers use the custom form.
+ * Host extends for richer model rows.
+ */
+export interface ModelProviderCatalogEntry<
+  TModel extends ModelEntry = ModelEntry,
+> {
   type: ProviderType;
   name: string;
   models: TModel[];
@@ -458,9 +466,12 @@ export type UpdateModelProviderRequest<TModel extends ModelEntry = ModelEntry> =
 export interface ModelCatalogServer<
   TModel extends ModelEntry = ModelEntry,
   TProvider extends ModelProviderBase<TModel> = ModelProviderBase<TModel>,
-  TCatalogProvider extends ModelProviderCatalogEntry<TModel> = ModelProviderCatalogEntry<TModel>,
-  TCreate extends CreateModelProviderRequest<TModel> = CreateModelProviderRequest<TModel>,
-  TUpdate extends UpdateModelProviderRequest<TModel> = UpdateModelProviderRequest<TModel>,
+  TCatalogProvider extends ModelProviderCatalogEntry<TModel> =
+    ModelProviderCatalogEntry<TModel>,
+  TCreate extends CreateModelProviderRequest<TModel> =
+    CreateModelProviderRequest<TModel>,
+  TUpdate extends UpdateModelProviderRequest<TModel> =
+    UpdateModelProviderRequest<TModel>,
 > {
   getModelProviderCatalog(): Promise<TCatalogProvider[]>;
   listModelProviders(): Promise<TProvider[]>;
@@ -506,8 +517,8 @@ export type ConnectorAuthPublic =
   | ConnectorAuthPublicNone;
 
 /**
-* MCP / connector create-edit config. Host extends for extra fields, etc.
-*/
+ * MCP / connector create-edit config. Host extends for extra fields, etc.
+ */
 export interface ConnectorConfigBase<
   TAuth extends ConnectorAuth = ConnectorAuth,
 > {
@@ -547,12 +558,14 @@ export interface ConnectorCatalogEntry<
 }
 
 /** Create connector — no `id`; server assigns it. Host extends. */
-export type CreateConnectorRequest<TAuth extends ConnectorAuth = ConnectorAuth> =
-  ConnectorConfigBase<TAuth>;
+export type CreateConnectorRequest<
+  TAuth extends ConnectorAuth = ConnectorAuth,
+> = ConnectorConfigBase<TAuth>;
 
 /** Update connector — `id` required. Host extends. */
-export type UpdateConnectorRequest<TAuth extends ConnectorAuth = ConnectorAuth> =
-  ConnectorConfigBase<TAuth> & { id: string };
+export type UpdateConnectorRequest<
+  TAuth extends ConnectorAuth = ConnectorAuth,
+> = ConnectorConfigBase<TAuth> & { id: string };
 
 export interface AuthenticateConnectorRequest {
   id: string;
@@ -664,7 +677,6 @@ export interface SkillCatalogServer<
 
 /** Mutable sandbox provider settings shared by catalog rows, create, and update. */
 export interface SandboxConfig {
-  snapshotName: string;
   execTimeoutMs: number;
   autoStopIntervalInMinutes: number;
   autoArchiveIntervalInMinutes: number;
@@ -688,6 +700,18 @@ export interface SandboxBase extends SandboxConfig {
   isConnected: boolean;
 }
 
+export type SandboxSnapshotSyncStatus = {
+  status: "pending" | "ready" | "failed";
+  statusReason?: string | null;
+};
+
+export interface SandboxProviderListEntry<
+  TSandbox extends SandboxBase = SandboxBase,
+> {
+  data: TSandbox;
+  snapshotSyncStatus: SandboxSnapshotSyncStatus;
+}
+
 export interface CreateSandboxRequest extends SandboxConfig {
   /** `SandboxCatalogEntry.id` used to create this sandbox provider. */
   catalogId: string;
@@ -714,9 +738,11 @@ export interface SandboxCatalogServer<
   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[]>;
+  listSandboxProviders(req?: { query?: string }): Promise<TListEntry[]>;
   createSandboxProvider(req: TCreate): Promise<TProvider>;
   updateSandboxProvider(req: TUpdate): Promise<TProvider>;
   deleteSandboxProvider?(req: { id: string }): Promise<void>;
@@ -730,10 +756,10 @@ export type AgentLibraryEntry = AgentSelectorEntry;
 export 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.
+ */
 export interface CatalogServer<
   TModelCatalog extends ModelCatalogServer = ModelCatalogServer,
   TConnectorCatalog extends ConnectorCatalogServer = ConnectorCatalogServer,