@truefoundry/assistant-ui-runtime 0.1.15 → 0.1.17

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.15",
+  "version": "0.1.17",
   "description": "TrueFoundry Gateway agent runtime adapter for assistant-ui",
   "license": "Apache-2.0",
   "repository": {

package/src/convertTurnMessages.test.ts

@@ -18,8 +18,8 @@ import type {
 import { ROOT_THREAD_ID } from "./constants.js";
 import { collectPendingToolResponses } from "./collectPending.js";
 import {
-    buildSnapshotBeforeTurnIndex,
     buildSnapshotFromSessionEvents,
+    buildSnapshotThroughTurn,
     buildTurnAssistantContent,
     buildUserMessageContent,
     buildUserMessageFromTurnInput,
@@ -28,6 +28,7 @@ import {
     prependOlderSessionHistory,
     projectSessionMessages,
     repositoryItemsFromMessages,
+    resolveGatewayBranchPreviousTurnIdForTurn,
     streamTurnEvents,
     turnStreamUpdateToAssistantMessage,
 } from "./convertTurnMessages.js";
@@ -135,22 +136,68 @@ function mockTurn(
     };
 }
 
+/** Mirror runtime listTurns normalization: ASC stays, DESC (or tied) reverses. */
+function toOldestFirstTurns(turns: TurnFixture[]): TurnFixture[] {
+    const chain = turns.filter((turn) => turn.state.status !== "running");
+    let newestFirst = chain.length > 1;
+    for (let i = 1; i < chain.length; i++) {
+        const newer = chain[i];
+        const older = chain[i - 1];
+        if (newer == null || older == null) {
+            continue;
+        }
+        const delta = Date.parse(newer.createdAt) - Date.parse(older.createdAt);
+        if (delta < 0) {
+            newestFirst = true;
+            break;
+        }
+        if (delta > 0) {
+            newestFirst = false;
+            break;
+        }
+    }
+    return newestFirst ? [...chain].reverse() : [...chain];
+}
+
+/** Mirrors the host's ancestor walk: parent pointers only, sibling branches excluded. */
+function ancestorChainFromTurns(
+    turns: TurnFixture[],
+    anchorTurnId: string,
+): TurnFixture[] {
+    const turnsById = new Map(turns.map((turn) => [turn.id, turn]));
+    const chain: TurnFixture[] = [];
+    const seen = new Set<string>();
+    let cursor: string | null | undefined = anchorTurnId;
+    while (cursor != null && !seen.has(cursor)) {
+        seen.add(cursor);
+        const turn = turnsById.get(cursor);
+        if (turn == null) {
+            break;
+        }
+        if (turn.state.status !== "running") {
+            chain.unshift(turn);
+        }
+        cursor = turn.previousTurnId;
+    }
+    return chain;
+}
+
 /**
- * Builds session-level event items from per-turn mocks — newest-first turns,
- * running turns excluded (matches session.listEvents API contract).
+ * Builds session-level event items from per-turn mocks — accepts ASC or DESC
+ * listTurns order; running turns excluded (matches session.listEvents). An
+ * anchor selects that turn's ancestor chain, not a chronological prefix.
  */
 function sessionEventItemsFromTurns(
-    turnsNewestFirst: TurnFixture[],
+    turns: TurnFixture[],
     lastTurnId?: string,
 ): SessionEventItem[] {
-    let chain = turnsNewestFirst.filter((turn) => turn.state.status !== "running");
-    if (lastTurnId != null) {
-        const anchorIndex = chain.findIndex((turn) => turn.id === lastTurnId);
-        chain = anchorIndex === -1 ? [] : chain.slice(anchorIndex);
-    }
+    const chain =
+        lastTurnId == null
+            ? toOldestFirstTurns(turns)
+            : ancestorChainFromTurns(turns, lastTurnId);
 
     const items: SessionEventItem[] = [];
-    for (const turn of [...chain].reverse()) {
+    for (const turn of chain) {
         items.push({
             turnId: turn.id,
             event: {
@@ -160,6 +207,9 @@ function sessionEventItemsFromTurns(
                 input: turn.input,
                 state: { status: "running" },
                 createdAt: turn.createdAt,
+                ...(turn.previousTurnId === undefined
+                    ? {}
+                    : { previousTurnId: turn.previousTurnId }),
             },
         });
         for (const event of turn.events) {
@@ -180,10 +230,18 @@ function sessionEventItemsFromTurns(
 
 function mockServerWithTurns(turns: TurnFixture[]): AgentChatServer {
     const eventsByTurnId = new Map(turns.map((turn) => [turn.id, turn.events]));
+    const turnsById = new Map(turns.map((turn) => [turn.id, turn]));
     return {
         listTurns: async ({ limit }: { limit?: number } = {}) => ({
             data: limit != null ? turns.slice(0, limit) : turns,
         }),
+        getTurn: async ({ turnId }: { turnId: string }) => {
+            const turn = turnsById.get(turnId);
+            if (turn == null) {
+                throw new Error(`Turn ${turnId} not found`);
+            }
+            return turn;
+        },
         listEvents: async (opts: { lastTurnId?: string } = {}) => {
             const items = sessionEventItemsFromTurns(turns, opts.lastTurnId);
             const newestFirst = [...items].reverse();
@@ -2824,40 +2882,46 @@ describe("buildSnapshotFromSessionEvents", () => {
     });
 });
 
-describe("buildSnapshotBeforeTurnIndex", () => {
-    it("rewinds via session.listEvents({ lastTurnId }) excluding the branch turn", async () => {
-        const t1 = mockTurn({
-            id: "t1",
-            createdAt,
-            input: [{ type: "user.message", content: "first" }],
-            events: [
-                modelMessage({ id: "m1", threadId: ROOT_THREAD_ID, content: "reply 1" }),
+describe("buildSnapshotThroughTurn", () => {
+    /** Linear session t1 -> t2 -> t3, oldest-first. */
+    function linearTurns(): TurnFixture[] {
+        return [
+            mockTurn({
+                id: "t1",
+                createdAt: "2026-01-01T00:00:00.000Z",
+                previousTurnId: null,
+                input: [{ type: "user.message", content: "first" }],
+                events: [
+                    modelMessage({ id: "m1", threadId: ROOT_THREAD_ID, content: "reply 1" }),
                 ],
-        });
-        const t2 = mockTurn({
-            id: "t2",
-            createdAt,
-            input: [{ type: "user.message", content: "second" }],
-            events: [
-                modelMessage({ id: "m2", threadId: ROOT_THREAD_ID, content: "reply 2" }),
+            }),
+            mockTurn({
+                id: "t2",
+                createdAt: "2026-01-01T00:01:00.000Z",
+                previousTurnId: "t1",
+                input: [{ type: "user.message", content: "second" }],
+                events: [
+                    modelMessage({ id: "m2", threadId: ROOT_THREAD_ID, content: "reply 2" }),
                 ],
-        });
-        const t3 = mockTurn({
-            id: "t3",
-            createdAt,
-            input: [{ type: "user.message", content: "third" }],
-            events: [
-                modelMessage({ id: "m3", threadId: ROOT_THREAD_ID, content: "reply 3" }),
+            }),
+            mockTurn({
+                id: "t3",
+                createdAt: "2026-01-01T00:02:00.000Z",
+                previousTurnId: "t2",
+                input: [{ type: "user.message", content: "third" }],
+                events: [
+                    modelMessage({ id: "m3", threadId: ROOT_THREAD_ID, content: "reply 3" }),
                 ],
-        });
+            }),
+        ];
+    }
 
-        // listTurns is newest-first.
-        const server = mockServerWithTurns([t3, t2, t1]);
-        const snapshot = await buildSnapshotBeforeTurnIndex(server, SESSION_ID, 2);
+    it("rewinds to the anchor's ancestor chain, inclusive", async () => {
+        const server = mockServerWithTurns(linearTurns());
+        const snapshot = await buildSnapshotThroughTurn(server, SESSION_ID, "t2");
 
         expect(snapshot.turns.map((turn) => turn.id)).toEqual(["t1", "t2"]);
-        const messages = projectSessionMessages(snapshot);
-        expect(messages.map((message) => message.id)).toEqual([
+        expect(projectSessionMessages(snapshot).map((message) => message.id)).toEqual([
             "t1-user",
             "t1-assistant",
             "t2-user",
@@ -2865,12 +2929,116 @@ describe("buildSnapshotBeforeTurnIndex", () => {
         ]);
     });
 
-    it("returns an empty snapshot when branching from the first turn", async () => {
-        const server = mockServerWithTurns([
-            mockTurn({ id: "t1", createdAt }),
-        ]);
-        const snapshot = await buildSnapshotBeforeTurnIndex(server, SESSION_ID, 0);
+    it("returns an empty snapshot for a null anchor (branching from a root turn)", async () => {
+        const server = mockServerWithTurns(linearTurns());
+        const snapshot = await buildSnapshotThroughTurn(server, SESSION_ID, null);
         expect(snapshot.turns).toHaveLength(0);
     });
+
+    it("ignores listTurns page order", async () => {
+        const asc = linearTurns();
+        const ascSnapshot = await buildSnapshotThroughTurn(
+            mockServerWithTurns(asc),
+            SESSION_ID,
+            "t2",
+        );
+        const descSnapshot = await buildSnapshotThroughTurn(
+            mockServerWithTurns([...asc].reverse()),
+            SESSION_ID,
+            "t2",
+        );
+
+        expect(descSnapshot.turns.map((turn) => turn.id)).toEqual(
+            ascSnapshot.turns.map((turn) => turn.id),
+        );
+        expect(descSnapshot.turns.map((turn) => turn.id)).toEqual(["t1", "t2"]);
+    });
+
+    it("drops sibling turns left behind by an earlier rerun", async () => {
+        // m2/m3 were rerun once already: t2/t3 are orphans, t2p/t3p are live.
+        const [t1, t2, t3] = linearTurns();
+        const t2p = mockTurn({
+            id: "t2p",
+            createdAt: "2026-01-01T00:03:00.000Z",
+            previousTurnId: "t1",
+            input: [{ type: "user.message", content: "second again" }],
+            events: [
+                modelMessage({ id: "m2p", threadId: ROOT_THREAD_ID, content: "reply 2p" }),
+            ],
+        });
+        const t3p = mockTurn({
+            id: "t3p",
+            createdAt: "2026-01-01T00:04:00.000Z",
+            previousTurnId: "t2p",
+            input: [{ type: "user.message", content: "third again" }],
+            events: [
+                modelMessage({ id: "m3p", threadId: ROOT_THREAD_ID, content: "reply 3p" }),
+            ],
+        });
+        const server = mockServerWithTurns([t1!, t2!, t3!, t2p, t3p]);
+
+        // Rerunning the middle live turn rewinds to its parent, not to the
+        // chronologically preceding turn (t3), whose chain still holds t2/t3.
+        const previousTurnId = await resolveGatewayBranchPreviousTurnIdForTurn(
+            server,
+            SESSION_ID,
+            "t2p",
+        );
+        expect(previousTurnId).toBe("t1");
+
+        const snapshot = await buildSnapshotThroughTurn(server, SESSION_ID, previousTurnId);
+        expect(snapshot.turns.map((turn) => turn.id)).toEqual(["t1"]);
+
+        // The orphan chain is still reachable, so the assertion above is not
+        // passing by accident.
+        const orphanSnapshot = await buildSnapshotThroughTurn(server, SESSION_ID, "t3");
+        expect(orphanSnapshot.turns.map((turn) => turn.id)).toEqual(["t1", "t2", "t3"]);
+    });
+});
+
+describe("resolveGatewayBranchPreviousTurnIdForTurn", () => {
+    it("uses the turn parent for subsequent turns and none for roots (ASC listTurns)", async () => {
+        const t1 = mockTurn({
+            id: "t1",
+            createdAt: "2026-01-01T00:00:00.000Z",
+            previousTurnId: null,
+        });
+        const t2 = mockTurn({
+            id: "t2",
+            createdAt: "2026-01-01T00:01:00.000Z",
+            previousTurnId: "t1",
+        });
+        const t3 = mockTurn({
+            id: "t3",
+            createdAt: "2026-01-01T00:02:00.000Z",
+            previousTurnId: "t2",
+        });
+        const server = mockServerWithTurns([t1, t2, t3]);
+
+        await expect(
+            resolveGatewayBranchPreviousTurnIdForTurn(server, SESSION_ID, "t1"),
+        ).resolves.toBe("none");
+        await expect(
+            resolveGatewayBranchPreviousTurnIdForTurn(server, SESSION_ID, "t3"),
+        ).resolves.toBe("t2");
+    });
+
+    it("uses the turn parent when listTurns is newest-first", async () => {
+        const t1 = mockTurn({
+            id: "t1",
+            createdAt: "2026-01-01T00:00:00.000Z",
+            previousTurnId: null,
+        });
+        const t2 = mockTurn({
+            id: "t2",
+            createdAt: "2026-01-01T00:01:00.000Z",
+            previousTurnId: "t1",
+        });
+        const server = mockServerWithTurns([t2, t1]);
+
+        await expect(
+            resolveGatewayBranchPreviousTurnIdForTurn(server, SESSION_ID, "t2"),
+        ).resolves.toBe("t1");
+    });
 });