@truefoundry/assistant-ui-runtime 0.1.6 → 0.1.7

package/README.md

@@ -278,7 +278,7 @@ See the [plugin README](./src/plugins/truefoundry-agent-server-adapter/README.md
 | `trueFoundryAttachmentAdapter` | Adapter | Opt-in composer attachments |
 | `trueFoundryExtras` | Namespace | Low-level extras access |
 | `useTrueFoundryApprovals` / `ToolResponses` / `McpAuth` / … | Hooks | Pending state + actions |
-| `AgentChatServer`, `Session`, `Turn`, … | Types | Server port + DTOs |
+| `AgentChatServer`, `AgentBuilderServer`, `CatalogServer`, `Session`, `Turn`, … | Types | Server ports + DTOs |
 | `TfyAgentSpec`, `TfySession`, `isTfyToolInfo`, … | Types / guards | Gateway-concrete types from the plugin |
 | `NamedAgentConfig`, `DraftAgentConfig` | Types | Agent source discriminants |
 
@@ -290,8 +290,9 @@ For contributors working inside this package. Source lives in `src/`; the publis
 
 | File | Responsibility |
 | ---- | -------------- |
-| `server/types.ts` | `AgentChatServer` + `AgentBuilderServer`, session/turn/pagination types |
+| `server/types.ts` | `AgentChatServer` + `AgentBuilderServer` + `CatalogServer` (modelCatalog/connectorCatalog/skillCatalog, optional via `AgentUIServerPort.catalog`), `AgentSpec`, session/turn/pagination types |
 | `server/events.ts` | Concrete turn/stream event types |
+| `draft/` | Draft-mode helpers (`mergeAgentSpec`, session bridge, draft thread-list, `useDraftAgentSpec`) |
 | `useTrueFoundryAgentRuntime.ts` | Public hook — external-store + thread-list + extras |
 | `useTrueFoundryAgentMessages.ts` | Reactive session snapshot: load, stream, cancel, resume |
 | `truefoundryExtras.ts` / `hooks.ts` | Extras namespace + consumer hooks |

package/dist/{chunk-Q2SHKMLM.js → chunk-SQDOTGP2.js}

@@ -60,6 +60,9 @@ function getTfyMcpInitServers(event) {
 }
 
 // src/plugins/truefoundry-agent-server-adapter/index.ts
+function isNotFound(error) {
+  return typeof error === "object" && error !== null && error.statusCode === 404;
+}
 function isDraft(session) {
   return session.type === "session/draft";
 }
@@ -99,20 +102,39 @@ function createTrueFoundryChatServer(opts) {
   const client = opts.client ?? new AgentSessionClient(gatewayOpts);
   const privateClient = opts.privateClient ?? new PrivateAgentSessionClient(gatewayOpts);
   const sessionTypeCache = /* @__PURE__ */ new Map();
+  const sessionTypeProbes = /* @__PURE__ */ new Map();
   function cacheSessionType(session) {
     sessionTypeCache.set(session.id, session.isMutable);
   }
-  function getSessionObj(sessionId) {
-    const isMutable = sessionTypeCache.get(sessionId);
-    if (isMutable === true) {
-      return privateClient.getDraftSession({ draftSessionId: sessionId });
+  async function probeSessionType(sessionId) {
+    const inflight = sessionTypeProbes.get(sessionId);
+    if (inflight != null) {
+      return inflight;
     }
-    if (isMutable === false) {
-      return client.getSession({ sessionId });
+    const probe = (async () => {
+      try {
+        await privateClient.getDraftSession({ draftSessionId: sessionId });
+        return true;
+      } catch (error) {
+        if (!isNotFound(error)) {
+          throw error;
+        }
+        await client.getSession({ sessionId });
+        return false;
+      }
+    })();
+    sessionTypeProbes.set(sessionId, probe);
+    try {
+      const isMutable = await probe;
+      sessionTypeCache.set(sessionId, isMutable);
+      return isMutable;
+    } finally {
+      sessionTypeProbes.delete(sessionId);
     }
-    throw new Error(
-      `Cannot resolve session "${sessionId}": session type not cached. Ensure createSession or listSessions was called first.`
-    );
+  }
+  async function getSessionObj(sessionId) {
+    const isMutable = sessionTypeCache.get(sessionId) ?? await probeSessionType(sessionId);
+    return isMutable ? privateClient.getDraftSession({ draftSessionId: sessionId }) : client.getSession({ sessionId });
   }
   const server = {
     async createSession(req) {
@@ -267,4 +289,4 @@ export {
   getTfyMcpInitServers,
   createTrueFoundryChatServer
 };
-//# sourceMappingURL=chunk-Q2SHKMLM.js.map
+//# sourceMappingURL=chunk-SQDOTGP2.js.map

package/dist/chunk-SQDOTGP2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugins/truefoundry-agent-server-adapter/index.ts","../src/plugins/truefoundry-agent-server-adapter/guards.ts"],"sourcesContent":["import { AgentSessionClient } from \"truefoundry-gateway-sdk/agents\";\nimport type { AgentSession } from \"truefoundry-gateway-sdk/agents\";\nimport { PrivateAgentSessionClient } from \"truefoundry-gateway-sdk/agents/private\";\nimport type { AgentDraftSession } from \"truefoundry-gateway-sdk/agents/private\";\nimport type {\n    AgentChatServer,\n    ListResult,\n    TurnInputItem,\n    PreviousTurnIdInput,\n    UpdateSessionRequest,\n} from \"../../server/types.js\";\nimport type {\n    SessionEventItem,\n    TurnEvent,\n    TurnStreamData,\n} from \"../../server/events.js\";\nimport type {\n    TfyAgentSpec,\n    TfyCreateSessionRequest,\n    TfyListSessionsParams,\n    TfySession,\n    TfyTurn,\n    TfyTurnState,\n} from \"./types.js\";\n\nexport {\n    type TfyAgentSpec,\n    type TfySkillMount,\n    type TfyMcpServerMount,\n    type TfyModelParams,\n    type TfyRuntimeConfig,\n    type TfyResponseFormat,\n    type TfySubject,\n    type ToolsSelectorItem,\n    type ToolsSelectorTag,\n    type RequireApprovalToolSelectorItem,\n    type RequireApprovalToolsSelectorTag,\n    type TfyTurn,\n    type TfyTurnState,\n    type TfyTurnCancelledReason,\n    type TfyTurnStateDoneOutput,\n    type TfySession,\n    type TfyCreateSessionRequest,\n    type TfyListSessionsParams,\n    type TfyToolInfo,\n    type TfySystemToolInfo,\n    type TfyMcpToolInfo,\n    type TfyModelMessageUsage,\n    type TfyFinishReason,\n    type TfyThreadState,\n    type TfyMcpServerInitInfo,\n} from \"./types.js\";\n\nexport {\n    isTfyToolInfo,\n    isTfySystemToolInfo,\n    isTfyMcpToolInfo,\n    getTfyUsage,\n    getTfyThreadState,\n    getTfyMcpInitServers,\n} from \"./guards.js\";\n\ntype GwSession = AgentSession | AgentDraftSession;\n\nexport type CreateTrueFoundryChatServerOptions = {\n    apiKey: string;\n    baseUrl: string;\n    /** Optional override — otherwise constructed from apiKey/baseUrl. */\n    client?: AgentSessionClient;\n    privateClient?: PrivateAgentSessionClient;\n    deleteSession?: (req: { sessionId: string }) => Promise<void>;\n};\n\n/**\n * Only the spec is generic. Session/Turn/list-params are the concrete Tfy*\n * types because the adapter builds them as fixed object literals — a generic\n * there would type fields that nothing ever populates. The spec is safe: the\n * gateway SDK serializes with `unrecognizedObjectKeys: \"passthrough\"`, so\n * host-added spec fields survive the round trip.\n */\nexport type TrueFoundryChatServer<TSpec extends TfyAgentSpec = TfyAgentSpec> =\n    AgentChatServer<\n        TSpec,\n        TfySession<TSpec>,\n        TfyCreateSessionRequest<TSpec>,\n        TfyListSessionsParams,\n        UpdateSessionRequest<TSpec>,\n        TfyTurn\n    > & {\n        /** Escape hatch for hosts that still need raw gateway clients. */\n        getGatewayClients(): {\n            client: AgentSessionClient;\n            privateClient: PrivateAgentSessionClient;\n        };\n    };\n\n/** Gateway SDK errors carry the HTTP status as `statusCode`. */\nfunction isNotFound(error: unknown): boolean {\n    return (\n        typeof error === \"object\" &&\n        error !== null &&\n        (error as { statusCode?: unknown }).statusCode === 404\n    );\n}\n\nfunction isDraft(session: GwSession): session is AgentDraftSession {\n    return (session as AgentDraftSession).type === \"session/draft\";\n}\n\nfunction toSession<TSpec extends TfyAgentSpec>(raw: GwSession): TfySession<TSpec> {\n    const mutable = isDraft(raw);\n    return {\n        id: raw.id,\n        title: raw.title,\n        agentName: raw.agentName,\n        ...(mutable ? { agentSpec: raw.agentSpec as TSpec } : {}),\n        isMutable: mutable,\n        createdBySubject: raw.createdBySubject,\n        createdAt: raw.createdAt,\n        updatedAt: raw.updatedAt,\n    };\n}\n\nfunction toTurn(raw: {\n    id: string;\n    sessionId: string;\n    previousTurnId?: string | null;\n    input?: TurnInputItem[];\n    state: unknown;\n    createdBySubject: TfyTurn[\"createdBySubject\"];\n    createdAt: string;\n}): TfyTurn {\n    return {\n        id: raw.id,\n        sessionId: raw.sessionId,\n        previousTurnId: raw.previousTurnId,\n        input: raw.input,\n        state: raw.state as TfyTurnState,\n        createdBySubject: raw.createdBySubject,\n        createdAt: raw.createdAt,\n    };\n}\n\nasync function toListResult<TIn, TOut>(\n    page: {\n        data: TIn[];\n        response?: { pagination?: { nextPageToken?: string } };\n        hasNextPage?: () => boolean;\n    },\n    map: (item: TIn) => TOut,\n): Promise<ListResult<TOut>> {\n    const nextPageToken = page.response?.pagination?.nextPageToken;\n    return {\n        data: page.data.map(map),\n        ...(nextPageToken != null && nextPageToken !== \"\"\n            ? { nextPageToken }\n            : {}),\n    };\n}\n\n/**\n * Wraps TrueFoundry gateway clients into a flat `AgentChatServer`.\n * Named vs draft routing is fully internal — an in-memory session-type cache\n * (populated by createSession/listSessions) determines which gateway client\n * to call, falling back to a one-time probe for ids seen only in a URL.\n */\nexport function createTrueFoundryChatServer<\n    TSpec extends TfyAgentSpec = TfyAgentSpec,\n>(\n    opts: CreateTrueFoundryChatServerOptions,\n): TrueFoundryChatServer<TSpec> {\n    const gatewayOpts = { apiKey: opts.apiKey, baseUrl: opts.baseUrl };\n    const client = opts.client ?? new AgentSessionClient(gatewayOpts);\n    const privateClient =\n        opts.privateClient ?? new PrivateAgentSessionClient(gatewayOpts);\n\n    const sessionTypeCache = new Map<string, boolean>();\n    const sessionTypeProbes = new Map<string, Promise<boolean>>();\n\n    function cacheSessionType(session: {\n        id: string;\n        isMutable: boolean;\n    }): void {\n        sessionTypeCache.set(session.id, session.isMutable);\n    }\n\n    /**\n     * Resolving a session id straight from a URL (page reload / shared link)\n     * reaches the gateway before createSession or listSessions has cached the\n     * type, so discover it by probing the draft endpoint and falling back to\n     * the conversation endpoint. Concurrent callers share one probe.\n     */\n    async function probeSessionType(sessionId: string): Promise<boolean> {\n        const inflight = sessionTypeProbes.get(sessionId);\n        if (inflight != null) {\n            return inflight;\n        }\n        const probe = (async () => {\n            try {\n                await privateClient.getDraftSession({ draftSessionId: sessionId });\n                return true;\n            } catch (error) {\n                // Only a miss proves the id isn't a draft. Auth or transient\n                // failures would otherwise be retried as a conversation session\n                // and mislabel a real draft as named.\n                if (!isNotFound(error)) {\n                    throw error;\n                }\n                await client.getSession({ sessionId });\n                return false;\n            }\n        })();\n        sessionTypeProbes.set(sessionId, probe);\n        try {\n            const isMutable = await probe;\n            sessionTypeCache.set(sessionId, isMutable);\n            return isMutable;\n        } finally {\n            sessionTypeProbes.delete(sessionId);\n        }\n    }\n\n    async function getSessionObj(sessionId: string): Promise<GwSession> {\n        const isMutable =\n            sessionTypeCache.get(sessionId) ?? (await probeSessionType(sessionId));\n        return isMutable\n            ? privateClient.getDraftSession({ draftSessionId: sessionId })\n            : client.getSession({ sessionId });\n    }\n\n    const server: TrueFoundryChatServer<TSpec> = {\n        async createSession(req) {\n            if (req.agentSpec != null) {\n                const draft = await privateClient.createDraftSession({\n                    agentSpec: req.agentSpec,\n                    ...(req.agentName != null ? { agentName: req.agentName } : {}),\n                    ...(req.tfyMetadata != null\n                        ? { tfyMetadata: req.tfyMetadata }\n                        : {}),\n                });\n                const session = toSession<TSpec>(draft);\n                cacheSessionType(session);\n                return session;\n            }\n            if (req.agentName != null) {\n                const named = await client.createSession({\n                    agentName: req.agentName,\n                    ...(req.tfyMetadata != null\n                        ? { tfyMetadata: req.tfyMetadata }\n                        : {}),\n                });\n                const session = toSession<TSpec>(named);\n                cacheSessionType(session);\n                return session;\n            }\n            throw new Error(\"createSession requires agentName and/or agentSpec\");\n        },\n\n        async listSessions(req) {\n            const page = await privateClient.listOwnedSessions({\n                limit: req?.limit,\n                order: req?.order,\n                pageToken: req?.pageToken,\n                startTimestamp: req?.startTimestamp,\n                endTimestamp: req?.endTimestamp,\n                ...(req?.agentName != null ? { agentName: req.agentName } : {}),\n            });\n            const result = await toListResult(page, (s) => toSession<TSpec>(s));\n            for (const session of result.data) {\n                cacheSessionType(session);\n            }\n            return result;\n        },\n\n        async getSession({ sessionId }) {\n            const raw = await getSessionObj(sessionId);\n            const session = toSession<TSpec>(raw);\n            cacheSessionType(session);\n            return session;\n        },\n\n        async updateSession(req) {\n            const raw = await getSessionObj(req.sessionId);\n            if (!isDraft(raw)) {\n                throw new Error(\n                    \"updateSession: session is not mutable (isMutable=false)\",\n                );\n            }\n            if (req.agentSpec != null) {\n                await raw.update({ agentSpec: req.agentSpec });\n            }\n            return toSession<TSpec>(raw);\n        },\n\n        prepareAndExecuteTurn(req: {\n            sessionId: string;\n            input?: TurnInputItem[];\n            previousTurnId?: PreviousTurnIdInput;\n            abortSignal?: AbortSignal;\n            headers?: Record<string, string>;\n        }): AsyncIterable<TurnStreamData> {\n            return (async function* () {\n                const session = await getSessionObj(req.sessionId);\n                const prepared = session.prepareTurn({\n                    input: req.input,\n                    previousTurnId: req.previousTurnId ?? \"auto\",\n                });\n                yield* prepared.execute(\n                    { stream: true },\n                    {\n                        ...(req.abortSignal != null\n                            ? { abortSignal: req.abortSignal }\n                            : {}),\n                        ...(req.headers != null ? { headers: req.headers } : {}),\n                    },\n                ) as AsyncIterable<TurnStreamData>;\n            })();\n        },\n\n        async cancelSession({ sessionId }) {\n            await (await getSessionObj(sessionId)).cancel();\n        },\n\n        async deleteSession({ sessionId }) {\n            if (opts.deleteSession == null) {\n                throw new Error(\n                    \"deleteSession is not on the gateway SDK. Pass deleteSession to createTrueFoundryChatServer.\",\n                );\n            }\n            await opts.deleteSession({ sessionId });\n        },\n\n        // The runtime's signature offers `order`, but the gateway's listTurns\n        // takes no such param — forwarding it silently did nothing.\n        async listTurns({ sessionId, limit, pageToken }) {\n            const raw = await getSessionObj(sessionId);\n            const page = await raw.listTurns({\n                ...(limit != null ? { limit } : {}),\n                ...(pageToken != null ? { pageToken } : {}),\n            });\n            return toListResult(page, (turn) => toTurn(turn));\n        },\n\n        async getTurn({ sessionId, turnId }) {\n            const raw = await getSessionObj(sessionId);\n            return toTurn(await raw.getTurn({ turnId }));\n        },\n\n        async listEvents({ sessionId, pageToken, lastTurnId, limit }) {\n            const raw = await getSessionObj(sessionId);\n            const page = await raw.listEvents({\n                ...(limit != null ? { limit } : {}),\n                ...(pageToken != null ? { pageToken } : {}),\n                ...(lastTurnId != null ? { lastTurnId } : {}),\n            });\n            return toListResult(\n                page,\n                (item) => item as SessionEventItem,\n            );\n        },\n\n        async listTurnEvents({ sessionId, turnId, limit, pageToken, order }) {\n            const raw = await getSessionObj(sessionId);\n            const turn = await raw.getTurn({ turnId });\n            const page = await turn.listEvents({\n                ...(limit != null ? { limit } : {}),\n                ...(pageToken != null ? { pageToken } : {}),\n                ...(order != null ? { order } : {}),\n            });\n            return toListResult(page, (event) => event as TurnEvent);\n        },\n\n        async *subscribeToTurn({\n            sessionId,\n            turnId,\n            afterSequenceNumber,\n            abortSignal,\n        }) {\n            const raw = await getSessionObj(sessionId);\n            const turn = await raw.getTurn({ turnId });\n            yield* turn.stream(\n                afterSequenceNumber != null ? { afterSequenceNumber } : {},\n                abortSignal != null ? { abortSignal } : {},\n            ) as AsyncIterable<TurnStreamData>;\n        },\n\n        async downloadSandboxFile(sandboxId, req) {\n            const response = await privateClient.downloadSandboxFile(\n                sandboxId,\n                req,\n            );\n            return await response.blob();\n        },\n\n        getGatewayClients: () => ({ client, privateClient }),\n    };\n\n    return server;\n}\n","/**\n * Point-of-use narrowing for the event half of the gateway protocol.\n *\n * `AgentChatServer` hardcodes the runtime's event types on listEvents,\n * listTurnEvents, subscribeToTurn and prepareAndExecuteTurn — there is no\n * generic to override them from here. So instead of typing those channels,\n * hosts call these guards on the values they receive.\n *\n * They validate rather than cast: this data comes off the network, and the\n * runtime types the relevant fields as `unknown` precisely because nothing\n * has checked them yet.\n */\n\nimport type {\n    TfyMcpServerInitInfo,\n    TfyMcpToolInfo,\n    TfyModelMessageUsage,\n    TfySystemToolInfo,\n    TfyThreadState,\n    TfyToolInfo,\n} from \"./types.js\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return typeof value === \"object\" && value !== null;\n}\n\nfunction hasNumbers<K extends string>(\n    value: unknown,\n    keys: readonly K[],\n): value is Record<string, unknown> & Record<K, number> {\n    return isRecord(value) && keys.every((key) => typeof value[key] === \"number\");\n}\n\n/**\n * Identifies built-in tools such as `ask_user_question` and `create_sub_agent`.\n * Note `toolInfo` is legitimately absent on streamed deltas, so callers must\n * keep their `function.name` fallback rather than treating absence as an error.\n */\nexport function isTfySystemToolInfo(\n    toolInfo: unknown,\n): toolInfo is TfySystemToolInfo {\n    return (\n        isRecord(toolInfo) &&\n        toolInfo.type === \"truefoundry-system\" &&\n        typeof toolInfo.name === \"string\"\n    );\n}\n\n/** Carries `serverId` / `serverName`, so the UI can attribute a call to its MCP server. */\nexport function isTfyMcpToolInfo(toolInfo: unknown): toolInfo is TfyMcpToolInfo {\n    return (\n        isRecord(toolInfo) &&\n        toolInfo.type === \"mcp\" &&\n        typeof toolInfo.name === \"string\" &&\n        typeof toolInfo.serverId === \"string\" &&\n        typeof toolInfo.serverName === \"string\"\n    );\n}\n\nexport function isTfyToolInfo(toolInfo: unknown): toolInfo is TfyToolInfo {\n    return isTfySystemToolInfo(toolInfo) || isTfyMcpToolInfo(toolInfo);\n}\n\nconst USAGE_BREAKDOWN_KEYS = [\n    \"harness\",\n    \"skills\",\n    \"instructions\",\n    \"toolDefinitions\",\n    \"messages\",\n] as const;\n\n/**\n * Token usage including the TrueFoundry-specific `inputTokensBreakdown`, which\n * attributes input tokens across harness, skills, instructions, tool\n * definitions and messages.\n */\nexport function getTfyUsage(\n    source: { usage?: unknown } | null | undefined,\n): TfyModelMessageUsage | undefined {\n    const usage = source?.usage;\n    if (!hasNumbers(usage, [\"inputTokens\", \"outputTokens\"])) {\n        return undefined;\n    }\n    if (!hasNumbers(usage.inputTokensBreakdown, USAGE_BREAKDOWN_KEYS)) {\n        return undefined;\n    }\n    return usage as unknown as TfyModelMessageUsage;\n}\n\n/**\n * Completion state of a sub-agent thread. The runtime types `thread.done`'s\n * `state` as `unknown`, so a sub-agent that errored is otherwise\n * indistinguishable from one that succeeded.\n */\nexport function getTfyThreadState(\n    event: { state?: unknown } | null | undefined,\n): TfyThreadState | undefined {\n    const state = event?.state;\n    if (!isRecord(state)) {\n        return undefined;\n    }\n    if (state.status === \"done\" && isRecord(state.output)) {\n        return state as unknown as TfyThreadState;\n    }\n    if (state.status === \"error\" && typeof state.error === \"string\") {\n        return state as unknown as TfyThreadState;\n    }\n    return undefined;\n}\n\n/**\n * Servers from an `mcp.initialize` event, including each one's `transportType`.\n * The runtime models this event with an index signature, so the array is\n * `unknown` until checked.\n */\nexport function getTfyMcpInitServers(\n    event: { mcpServers?: unknown } | null | undefined,\n): TfyMcpServerInitInfo[] | undefined {\n    const servers = event?.mcpServers;\n    if (!Array.isArray(servers)) {\n        return undefined;\n    }\n    const valid = servers.every(\n        (server) =>\n            isRecord(server) &&\n            typeof server.id === \"string\" &&\n            typeof server.name === \"string\",\n    );\n    return valid ? (servers as TfyMcpServerInitInfo[]) : undefined;\n}\n"],"mappings":"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","names":[]}

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, b as AgentChatServer, c as TurnEvent, d as ThreadCreatedEvent, e as UserToolResponseEvent, M as McpAuthRequiredEvent, f as UserToolApprovalEvent, T as Turn, g as TurnInputItem, S as Session } from './types-BfiFf8O1.js';
-export { h as AgentBuilderServer, C as CreateSessionRequest, i as ListResult, L as ListSessionsParams, j as ModelMessageEvent, P as PreviousTurnIdInput, k as SandboxCreatedEvent, l as SessionEventItem, m as ToolApprovalRequiredEvent, n as ToolCall, o as ToolResponseRequiredEvent, a as TurnState, p as TurnStateDone, q as TurnStreamData, r as TurnStreamingEvent, U as UpdateSessionRequest, s as UserMessage } from './types-BfiFf8O1.js';
+import { A as AgentSpec, b as AgentChatServer, c as TurnEvent, d as ThreadCreatedEvent, e as UserToolResponseEvent, M as McpAuthRequiredEvent, f as UserToolApprovalEvent, T as Turn, g as TurnInputItem, S as Session } from './types-DbNsU075.js';
+export { h as AgentBuilderServer, i as AgentUIServerPort, j as CatalogServer, k as ConnectorAuth, l as ConnectorAuthPublic, m as ConnectorAuthType, n as ConnectorBase, o as ConnectorCatalogEntry, p as ConnectorCatalogServer, q as ConnectorConfigBase, r as CreateConnectorRequest, s as CreateModelProviderRequest, C as CreateSessionRequest, t as CreateSkillRequest, u as ListResult, L as ListSessionsParams, v as ModelCatalogServer, w as ModelEntry, x as ModelMessageEvent, y as ModelProviderBase, z as ModelProviderCatalogEntry, B as ModelProviderConfigBase, P as PreviousTurnIdInput, D as ProviderType, E as SandboxCreatedEvent, F as SessionEventItem, G as SkillBase, H as SkillCatalogServer, I as ToolApprovalRequiredEvent, J as ToolBase, K as ToolCall, N as ToolResponseRequiredEvent, a as TurnState, O as TurnStateDone, Q as TurnStreamData, R as TurnStreamingEvent, V as UpdateConnectorRequest, W as UpdateModelProviderRequest, U as UpdateSessionRequest, X as UserMessage } from './types-DbNsU075.js';
 import * as _assistant_ui_core_internal from '@assistant-ui/core/internal';
 export { isEventDelta, mergeEventDelta } from './server/index.js';
 export { CreateTrueFoundryChatServerOptions, RequireApprovalToolSelectorItem, RequireApprovalToolsSelectorTag, TfyAgentSpec, TfyCreateSessionRequest, TfyFinishReason, TfyListSessionsParams, TfyMcpServerInitInfo, TfyMcpServerMount, TfyMcpToolInfo, TfyModelMessageUsage, TfyModelParams, TfyResponseFormat, TfyRuntimeConfig, TfySession, TfySkillMount, TfySubject, TfySystemToolInfo, TfyThreadState, TfyToolInfo, TfyTurn, TfyTurnCancelledReason, TfyTurnState, TfyTurnStateDoneOutput, ToolsSelectorItem, ToolsSelectorTag, TrueFoundryChatServer, createTrueFoundryChatServer, getTfyMcpInitServers, getTfyThreadState, getTfyUsage, isTfyMcpToolInfo, isTfySystemToolInfo, isTfyToolInfo } from './plugins/truefoundry-agent-server-adapter/index.js';
@@ -9,26 +9,6 @@ import 'truefoundry-gateway-sdk/agents';
 import 'truefoundry-gateway-sdk/agents/private';
 import 'truefoundry-gateway-sdk';
 
-/** @deprecated Use Session with isMutable: true instead. Kept for title helper. */
-type DraftSession = {
-    title?: string | null;
-    agentSpec: AgentSpec;
-};
-type AgentSpecUpdate = {
-    instructions?: string;
-    model?: Partial<AgentSpec["model"]> & {
-        params?: Partial<NonNullable<AgentSpec["model"]["params"]>>;
-    };
-    mcpServers?: AgentSpec["mcpServers"];
-    skills?: AgentSpec["skills"];
-    messages?: AgentSpec["messages"];
-    variables?: AgentSpec["variables"];
-    responseFormat?: AgentSpec["responseFormat"];
-    config?: AgentSpec["config"];
-};
-declare function mergeAgentSpec(base: AgentSpec, update: AgentSpecUpdate): AgentSpec;
-declare function draftSessionTitle(draft: DraftSession): string;
-
 type NamedAgentConfig = {
     mode: "named";
     agentName: string;
@@ -181,6 +161,20 @@ declare function parseTurnIdFromMessageId(messageId: string): string;
 declare function buildEditedUserMessageContent(editedText: string, originalInput: TurnInputItem[] | undefined): UserMessageContent;
 declare function repositoryItemsFromMessages(messages: readonly ThreadMessage[]): ExportedMessageRepositoryItem[];
 
+/** @deprecated Use Session with isMutable: true instead. Kept for title helper. */
+type DraftSession = {
+    title?: string | null;
+    agentSpec: AgentSpec;
+};
+/** Partial update — host fields flow through when `TSpec` is widened. */
+type AgentSpecUpdate<TSpec extends AgentSpec = AgentSpec> = {
+    [K in keyof TSpec]?: K extends "model" ? Omit<Partial<TSpec["model"]>, "params"> & {
+        params?: Partial<NonNullable<TSpec["model"]["params"]>>;
+    } : TSpec[K];
+};
+declare function mergeAgentSpec<TSpec extends AgentSpec>(base: TSpec, update: AgentSpecUpdate<TSpec>): TSpec;
+declare function draftSessionTitle(draft: DraftSession): string;
+
 declare function createTrueFoundryDraftThreadListAdapter(options: {
     server: AgentChatServer;
     defaultAgentSpec: AgentSpec;
@@ -221,6 +215,7 @@ type PendingToolResponse = {
 type TrueFoundryDraftRuntimeExtras = {
     agentSpec: AgentSpec | null;
     draftSessionId: string | undefined;
+    isSpecLoading: boolean;
     isSpecSyncing: boolean;
     specError: unknown | null;
     updateAgentSpec: (update: AgentSpecUpdate) => void;
@@ -289,6 +284,7 @@ declare const useTrueFoundryResetFromTurn: () => (turnId: string) => Promise<voi
 declare const useTrueFoundryAgentSpec: () => {
     agentSpec: AgentSpec | null;
     draftSessionId: string | undefined;
+    isSpecLoading: boolean;
     isSpecSyncing: boolean;
     specError: unknown | null;
     updateAgentSpec: (update: AgentSpecUpdate) => void;
@@ -317,4 +313,4 @@ declare function getSession(server: AgentChatServer, sessionId: string): Promise
  */
 declare const trueFoundryAttachmentAdapter: AttachmentAdapter;
 
-export { AgentChatServer, AgentSpec, type AgentSpecUpdate, type ConvertTurnsResult, type DraftAgentConfig, type DraftSession, type DraftSessionBridge, type McpAuthMessageCustomMetadata, McpAuthRequiredEvent, type NamedAgentConfig, type PendingApproval, type PendingToolResponse, ROOT_THREAD_ID, type SandboxMessageCustomMetadata, AgentSpec as ServerAgentSpec, Session, type SubAgentArtifact, type SubAgentCustomMetadata, type SubAgentMessageCustomMetadata, TOOL_RESPONSE_THREAD_ID_CUSTOM_KEY, ThreadCreatedEvent, type ToolApprovalMessageCustomMetadata, type ToolResponseMessageCustomMetadata, type TrueFoundryAgentConfig, type TrueFoundryDraftRuntimeExtras, type TrueFoundryMessageCustomMetadata, type TrueFoundryRuntimeExtras, Turn, TurnEvent, TurnInputItem, type UseTrueFoundryAgentRuntimeOptions, type UserMessageContent, UserToolApprovalEvent, UserToolResponseEvent, buildEditedUserMessageContent, buildTurnAssistantContent, buildUserMessageContent, collectApprovalInputs, collectRequiredActionInputs, collectResponseInputs, convertTurnsToThreadMessages, createDraftSessionBridge, createTrueFoundryDraftThreadListAdapter, createTrueFoundryOwnedSessionsThreadListAdapter, createTrueFoundryThreadListAdapter, draftSessionTitle, findPausedAssistantMessage, getSession, getTurnMessageContent, mergeAgentSpec, messageHasPendingApprovals, messageHasPendingRequiredActions, messageHasPendingResponses, parseTurnIdFromMessageId, repositoryItemsFromMessages, toTrueFoundryApprovalInputs, trueFoundryAttachmentAdapter, trueFoundryExtras, useTrueFoundryAgentRuntime, useTrueFoundryAgentSpec, useTrueFoundryApprovals, useTrueFoundryCancel, useTrueFoundryDownloadSandboxFile, useTrueFoundryHistoryPagination, useTrueFoundryMcpAuth, useTrueFoundryReload, useTrueFoundryResetFromTurn, useTrueFoundryRespondToToolApproval, useTrueFoundryRespondToToolResponse, useTrueFoundryResumeMcpAuth, useTrueFoundrySandboxId, useTrueFoundryToolResponses, useTrueFoundryUpdateAgentSpec };
+export { AgentChatServer, AgentSpec, type AgentSpecUpdate, type ConvertTurnsResult, type DraftAgentConfig, type DraftSession, type DraftSessionBridge, type McpAuthMessageCustomMetadata, McpAuthRequiredEvent, type NamedAgentConfig, type PendingApproval, type PendingToolResponse, ROOT_THREAD_ID, type SandboxMessageCustomMetadata, Session, type SubAgentArtifact, type SubAgentCustomMetadata, type SubAgentMessageCustomMetadata, TOOL_RESPONSE_THREAD_ID_CUSTOM_KEY, ThreadCreatedEvent, type ToolApprovalMessageCustomMetadata, type ToolResponseMessageCustomMetadata, type TrueFoundryAgentConfig, type TrueFoundryDraftRuntimeExtras, type TrueFoundryMessageCustomMetadata, type TrueFoundryRuntimeExtras, Turn, TurnEvent, TurnInputItem, type UseTrueFoundryAgentRuntimeOptions, type UserMessageContent, UserToolApprovalEvent, UserToolResponseEvent, buildEditedUserMessageContent, buildTurnAssistantContent, buildUserMessageContent, collectApprovalInputs, collectRequiredActionInputs, collectResponseInputs, convertTurnsToThreadMessages, createDraftSessionBridge, createTrueFoundryDraftThreadListAdapter, createTrueFoundryOwnedSessionsThreadListAdapter, createTrueFoundryThreadListAdapter, draftSessionTitle, findPausedAssistantMessage, getSession, getTurnMessageContent, mergeAgentSpec, messageHasPendingApprovals, messageHasPendingRequiredActions, messageHasPendingResponses, parseTurnIdFromMessageId, repositoryItemsFromMessages, toTrueFoundryApprovalInputs, trueFoundryAttachmentAdapter, trueFoundryExtras, useTrueFoundryAgentRuntime, useTrueFoundryAgentSpec, useTrueFoundryApprovals, useTrueFoundryCancel, useTrueFoundryDownloadSandboxFile, useTrueFoundryHistoryPagination, useTrueFoundryMcpAuth, useTrueFoundryReload, useTrueFoundryResetFromTurn, useTrueFoundryRespondToToolApproval, useTrueFoundryRespondToToolResponse, useTrueFoundryResumeMcpAuth, useTrueFoundrySandboxId, useTrueFoundryToolResponses, useTrueFoundryUpdateAgentSpec };