@truefoundry/assistant-ui-runtime 0.1.6-rc.0 → 0.1.7

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

@@ -1,6 +1,128 @@
 import { AgentSessionClient } from 'truefoundry-gateway-sdk/agents';
 import { PrivateAgentSessionClient } from 'truefoundry-gateway-sdk/agents/private';
-import { a as AgentChatServer } from '../../types-VUBzoJT2.js';
+import { A as AgentSpec, C as CreateSessionRequest, L as ListSessionsParams, S as Session, T as Turn, a as TurnState, b as AgentChatServer, U as UpdateSessionRequest } from '../../types-DbNsU075.js';
+import { TruefoundryGatewayApi } from 'truefoundry-gateway-sdk';
+
+/**
+ * TrueFoundry-specific type extensions over the runtime's generic bases.
+ *
+ * The runtime defines minimal bases (SkillMount = {id,name}, McpServerMount =
+ * {id,name}, AgentSpec.config = unknown, etc.) that hosts extend via generics.
+ *
+ * This file builds the concrete TrueFoundry types by:
+ *  - Importing the runtime's AgentSpec as the base to extend.
+ *  - Importing concrete sub-types from the gateway SDK namespace rather than
+ *    re-defining them — they're purely gateway concepts.
+ *  - Composing a TfyAgentSpec that satisfies both the runtime's
+ *    `TSpec extends AgentSpec` constraint and the gateway SDK's AgentSpec shape.
+ */
+
+type TfyRuntimeConfig = TruefoundryGatewayApi.RuntimeConfig;
+type TfyResponseFormat = TruefoundryGatewayApi.ResponseFormat;
+type TfyModelParams = TruefoundryGatewayApi.ModelParams;
+type TfySubject = TruefoundryGatewayApi.Subject;
+type ToolsSelectorTag = "@all" | "@read-only";
+type RequireApprovalToolsSelectorTag = "@all" | "@write" | "@destructive";
+type ToolsSelectorItem = ToolsSelectorTag | string;
+type RequireApprovalToolSelectorItem = RequireApprovalToolsSelectorTag | string;
+type RuntimeSkillMount = NonNullable<NonNullable<AgentSpec["skills"]>[number]>;
+type RuntimeMcpServerMount = NonNullable<NonNullable<AgentSpec["mcpServers"]>[number]>;
+type TfySkillMount = RuntimeSkillMount & TruefoundryGatewayApi.SkillMount;
+type TfyMcpServerMount = RuntimeMcpServerMount & TruefoundryGatewayApi.McpServer;
+interface TfyAgentSpec extends AgentSpec<TruefoundryGatewayApi.Model, TfySkillMount, TfyMcpServerMount> {
+    config?: TruefoundryGatewayApi.RuntimeConfig;
+    responseFormat?: TruefoundryGatewayApi.ResponseFormat;
+    messages?: TruefoundryGatewayApi.AgentSpecUserMessage[];
+}
+type TfyTurnCancelledReason = TruefoundryGatewayApi.TurnStateCancelledReason;
+type TfyTurnStateDoneOutput = TruefoundryGatewayApi.TurnStateDoneOutput;
+type RuntimeTurnStateDone = Extract<TurnState, {
+    status: "done";
+}>;
+type RuntimeTurnStateCancelled = Extract<TurnState, {
+    status: "cancelled";
+}>;
+/**
+ * The runtime types `output` as `unknown` and `reason` as bare `string`. The
+ * gateway sends a model message and one of four reasons — `cancelled-for-next-turn`
+ * in particular is routine and should not render like a failure.
+ */
+type TfyTurnState = Exclude<TurnState, {
+    status: "done" | "cancelled";
+}> | (Omit<RuntimeTurnStateDone, "output"> & {
+    output?: TfyTurnStateDoneOutput;
+}) | (Omit<RuntimeTurnStateCancelled, "reason"> & {
+    reason: TfyTurnCancelledReason;
+});
+interface TfyTurn extends Turn {
+    state: TfyTurnState;
+    createdBySubject: TfySubject;
+}
+interface TfySession<TSpec extends TfyAgentSpec = TfyAgentSpec> extends Session<TSpec> {
+    createdBySubject: TfySubject;
+}
+interface TfyCreateSessionRequest<TSpec extends TfyAgentSpec = TfyAgentSpec> extends CreateSessionRequest<TSpec> {
+    /** Sent as `x-tfy-metadata`, persisted server-side as `request_metadata`. */
+    tfyMetadata?: string;
+}
+interface TfyListSessionsParams extends ListSessionsParams {
+    /** Inclusive upper bound on `createdAt` (ISO-8601). */
+    endTimestamp?: string;
+}
+type TfyToolInfo = TruefoundryGatewayApi.ToolInfo;
+type TfySystemToolInfo = TruefoundryGatewayApi.TrueFoundrySystemToolInfo;
+type TfyMcpToolInfo = TruefoundryGatewayApi.McpToolInfo;
+type TfyModelMessageUsage = TruefoundryGatewayApi.ModelMessageUsage;
+type TfyFinishReason = TruefoundryGatewayApi.FinishReason;
+type TfyThreadState = TruefoundryGatewayApi.ThreadState;
+type TfyMcpServerInitInfo = TruefoundryGatewayApi.McpServerInitInfo;
+
+/**
+ * Point-of-use narrowing for the event half of the gateway protocol.
+ *
+ * `AgentChatServer` hardcodes the runtime's event types on listEvents,
+ * listTurnEvents, subscribeToTurn and prepareAndExecuteTurn — there is no
+ * generic to override them from here. So instead of typing those channels,
+ * hosts call these guards on the values they receive.
+ *
+ * They validate rather than cast: this data comes off the network, and the
+ * runtime types the relevant fields as `unknown` precisely because nothing
+ * has checked them yet.
+ */
+
+/**
+ * Identifies built-in tools such as `ask_user_question` and `create_sub_agent`.
+ * Note `toolInfo` is legitimately absent on streamed deltas, so callers must
+ * keep their `function.name` fallback rather than treating absence as an error.
+ */
+declare function isTfySystemToolInfo(toolInfo: unknown): toolInfo is TfySystemToolInfo;
+/** Carries `serverId` / `serverName`, so the UI can attribute a call to its MCP server. */
+declare function isTfyMcpToolInfo(toolInfo: unknown): toolInfo is TfyMcpToolInfo;
+declare function isTfyToolInfo(toolInfo: unknown): toolInfo is TfyToolInfo;
+/**
+ * Token usage including the TrueFoundry-specific `inputTokensBreakdown`, which
+ * attributes input tokens across harness, skills, instructions, tool
+ * definitions and messages.
+ */
+declare function getTfyUsage(source: {
+    usage?: unknown;
+} | null | undefined): TfyModelMessageUsage | undefined;
+/**
+ * Completion state of a sub-agent thread. The runtime types `thread.done`'s
+ * `state` as `unknown`, so a sub-agent that errored is otherwise
+ * indistinguishable from one that succeeded.
+ */
+declare function getTfyThreadState(event: {
+    state?: unknown;
+} | null | undefined): TfyThreadState | undefined;
+/**
+ * Servers from an `mcp.initialize` event, including each one's `transportType`.
+ * The runtime models this event with an index signature, so the array is
+ * `unknown` until checked.
+ */
+declare function getTfyMcpInitServers(event: {
+    mcpServers?: unknown;
+} | null | undefined): TfyMcpServerInitInfo[] | undefined;
 
 type CreateTrueFoundryChatServerOptions = {
     apiKey: string;
@@ -12,7 +134,14 @@ type CreateTrueFoundryChatServerOptions = {
         sessionId: string;
     }) => Promise<void>;
 };
-type TrueFoundryChatServer = AgentChatServer & {
+/**
+ * Only the spec is generic. Session/Turn/list-params are the concrete Tfy*
+ * types because the adapter builds them as fixed object literals — a generic
+ * there would type fields that nothing ever populates. The spec is safe: the
+ * gateway SDK serializes with `unrecognizedObjectKeys: "passthrough"`, so
+ * host-added spec fields survive the round trip.
+ */
+type TrueFoundryChatServer<TSpec extends TfyAgentSpec = TfyAgentSpec> = AgentChatServer<TSpec, TfySession<TSpec>, TfyCreateSessionRequest<TSpec>, TfyListSessionsParams, UpdateSessionRequest<TSpec>, TfyTurn> & {
     /** Escape hatch for hosts that still need raw gateway clients. */
     getGatewayClients(): {
         client: AgentSessionClient;
@@ -23,8 +152,8 @@ type TrueFoundryChatServer = AgentChatServer & {
  * Wraps TrueFoundry gateway clients into a flat `AgentChatServer`.
  * Named vs draft routing is fully internal — an in-memory session-type cache
  * (populated by createSession/listSessions) determines which gateway client
- * to call. No try/catch fallback, no double network calls.
+ * to call, falling back to a one-time probe for ids seen only in a URL.
  */
-declare function createTrueFoundryChatServer(opts: CreateTrueFoundryChatServerOptions): TrueFoundryChatServer;
+declare function createTrueFoundryChatServer<TSpec extends TfyAgentSpec = TfyAgentSpec>(opts: CreateTrueFoundryChatServerOptions): TrueFoundryChatServer<TSpec>;
 
-export { type CreateTrueFoundryChatServerOptions, type TrueFoundryChatServer, createTrueFoundryChatServer };
+export { type CreateTrueFoundryChatServerOptions, type RequireApprovalToolSelectorItem, type RequireApprovalToolsSelectorTag, type TfyAgentSpec, type TfyCreateSessionRequest, type TfyFinishReason, type TfyListSessionsParams, type TfyMcpServerInitInfo, type TfyMcpServerMount, type TfyMcpToolInfo, type TfyModelMessageUsage, type TfyModelParams, type TfyResponseFormat, type TfyRuntimeConfig, type TfySession, type TfySkillMount, type TfySubject, type TfySystemToolInfo, type TfyThreadState, type TfyToolInfo, type TfyTurn, type TfyTurnCancelledReason, type TfyTurnState, type TfyTurnStateDoneOutput, type ToolsSelectorItem, type ToolsSelectorTag, type TrueFoundryChatServer, createTrueFoundryChatServer, getTfyMcpInitServers, getTfyThreadState, getTfyUsage, isTfyMcpToolInfo, isTfySystemToolInfo, isTfyToolInfo };

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

@@ -1,198 +1,19 @@
-// src/plugins/truefoundry-agent-server-adapter/index.ts
-import { AgentSessionClient } from "truefoundry-gateway-sdk/agents";
-import { PrivateAgentSessionClient } from "truefoundry-gateway-sdk/agents/private";
-function isDraft(session) {
-  return session.type === "session/draft";
-}
-function toSession(raw) {
-  const mutable = isDraft(raw);
-  return {
-    id: raw.id,
-    title: raw.title,
-    agentName: raw.agentName,
-    ...mutable ? { agentSpec: raw.agentSpec } : {},
-    isMutable: mutable,
-    createdAt: raw.createdAt,
-    updatedAt: raw.updatedAt
-  };
-}
-function toTurn(raw) {
-  return {
-    id: raw.id,
-    sessionId: raw.sessionId,
-    previousTurnId: raw.previousTurnId,
-    input: raw.input,
-    state: raw.state,
-    createdAt: raw.createdAt
-  };
-}
-async function toListResult(page, map) {
-  const nextPageToken = page.response?.pagination?.nextPageToken;
-  return {
-    data: page.data.map(map),
-    ...nextPageToken != null && nextPageToken !== "" ? { nextPageToken } : {}
-  };
-}
-function createTrueFoundryChatServer(opts) {
-  const gatewayOpts = { apiKey: opts.apiKey, baseUrl: opts.baseUrl };
-  const client = opts.client ?? new AgentSessionClient(gatewayOpts);
-  const privateClient = opts.privateClient ?? new PrivateAgentSessionClient(gatewayOpts);
-  const sessionTypeCache = /* @__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 });
-    }
-    if (isMutable === false) {
-      return client.getSession({ sessionId });
-    }
-    throw new Error(
-      `Cannot resolve session "${sessionId}": session type not cached. Ensure createSession or listSessions was called first.`
-    );
-  }
-  const server = {
-    async createSession(req) {
-      if (req.agentSpec != null) {
-        const draft = await privateClient.createDraftSession({
-          agentSpec: req.agentSpec,
-          ...req.agentName != null ? { agentName: req.agentName } : {}
-        });
-        const session = toSession(draft);
-        cacheSessionType(session);
-        return session;
-      }
-      if (req.agentName != null) {
-        const named = await client.createSession({
-          agentName: req.agentName
-        });
-        const session = toSession(named);
-        cacheSessionType(session);
-        return session;
-      }
-      throw new Error("createSession requires agentName and/or agentSpec");
-    },
-    async listSessions(req) {
-      const page = await privateClient.listOwnedSessions({
-        limit: req?.limit,
-        order: req?.order,
-        pageToken: req?.pageToken,
-        startTimestamp: req?.startTimestamp,
-        ...req?.agentName != null ? { agentName: req.agentName } : {}
-      });
-      const result = await toListResult(page, toSession);
-      for (const session of result.data) {
-        cacheSessionType(session);
-      }
-      return result;
-    },
-    async getSession({ sessionId }) {
-      const raw = await getSessionObj(sessionId);
-      const session = toSession(raw);
-      cacheSessionType(session);
-      return session;
-    },
-    async updateSession(req) {
-      const raw = await getSessionObj(req.sessionId);
-      if (!isDraft(raw)) {
-        throw new Error(
-          "updateSession: session is not mutable (isMutable=false)"
-        );
-      }
-      if (req.agentSpec != null) {
-        await raw.update({ agentSpec: req.agentSpec });
-      }
-      return toSession(raw);
-    },
-    prepareAndExecuteTurn(req) {
-      return (async function* () {
-        const session = await getSessionObj(req.sessionId);
-        const prepared = session.prepareTurn({
-          input: req.input,
-          previousTurnId: req.previousTurnId ?? "auto"
-        });
-        yield* prepared.execute(
-          { stream: true },
-          {
-            ...req.abortSignal != null ? { abortSignal: req.abortSignal } : {},
-            ...req.headers != null ? { headers: req.headers } : {}
-          }
-        );
-      })();
-    },
-    async cancelSession({ sessionId }) {
-      await (await getSessionObj(sessionId)).cancel();
-    },
-    async deleteSession({ sessionId }) {
-      if (opts.deleteSession == null) {
-        throw new Error(
-          "deleteSession is not on the gateway SDK. Pass deleteSession to createTrueFoundryChatServer."
-        );
-      }
-      await opts.deleteSession({ sessionId });
-    },
-    async listTurns({ sessionId, limit, pageToken, order }) {
-      const raw = await getSessionObj(sessionId);
-      const page = await raw.listTurns({
-        ...limit != null ? { limit } : {},
-        ...pageToken != null ? { pageToken } : {},
-        ...order != null ? { order } : {}
-      });
-      return toListResult(page, (turn) => toTurn(turn));
-    },
-    async getTurn({ sessionId, turnId }) {
-      const raw = await getSessionObj(sessionId);
-      return toTurn(await raw.getTurn({ turnId }));
-    },
-    async listEvents({ sessionId, pageToken, lastTurnId, limit }) {
-      const raw = await getSessionObj(sessionId);
-      const page = await raw.listEvents({
-        ...limit != null ? { limit } : {},
-        ...pageToken != null ? { pageToken } : {},
-        ...lastTurnId != null ? { lastTurnId } : {}
-      });
-      return toListResult(
-        page,
-        (item) => item
-      );
-    },
-    async listTurnEvents({ sessionId, turnId, limit, pageToken, order }) {
-      const raw = await getSessionObj(sessionId);
-      const turn = await raw.getTurn({ turnId });
-      const page = await turn.listEvents({
-        ...limit != null ? { limit } : {},
-        ...pageToken != null ? { pageToken } : {},
-        ...order != null ? { order } : {}
-      });
-      return toListResult(page, (event) => event);
-    },
-    async *subscribeToTurn({
-      sessionId,
-      turnId,
-      afterSequenceNumber,
-      abortSignal
-    }) {
-      const raw = await getSessionObj(sessionId);
-      const turn = await raw.getTurn({ turnId });
-      yield* turn.stream(
-        afterSequenceNumber != null ? { afterSequenceNumber } : {},
-        abortSignal != null ? { abortSignal } : {}
-      );
-    },
-    async downloadSandboxFile(sandboxId, req) {
-      const response = await privateClient.downloadSandboxFile(
-        sandboxId,
-        req
-      );
-      return await response.blob();
-    },
-    getGatewayClients: () => ({ client, privateClient })
-  };
-  return server;
-}
+import {
+  createTrueFoundryChatServer,
+  getTfyMcpInitServers,
+  getTfyThreadState,
+  getTfyUsage,
+  isTfyMcpToolInfo,
+  isTfySystemToolInfo,
+  isTfyToolInfo
+} from "../../chunk-SQDOTGP2.js";
 export {
-  createTrueFoundryChatServer
+  createTrueFoundryChatServer,
+  getTfyMcpInitServers,
+  getTfyThreadState,
+  getTfyUsage,
+  isTfyMcpToolInfo,
+  isTfySystemToolInfo,
+  isTfyToolInfo
 };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/plugins/truefoundry-agent-server-adapter/index.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    AgentSpec,\n    ListResult,\n    Session,\n    Turn,\n    TurnInputItem,\n    PreviousTurnIdInput,\n} from \"../../server/types.js\";\nimport type {\n    TurnEvent,\n    TurnStreamData,\n    SessionEventItem,\n} from \"../../server/events.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\nexport type TrueFoundryChatServer = AgentChatServer & {\n    /** Escape hatch for hosts that still need raw gateway clients. */\n    getGatewayClients(): {\n        client: AgentSessionClient;\n        privateClient: PrivateAgentSessionClient;\n    };\n};\n\nfunction isDraft(session: GwSession): session is AgentDraftSession {\n    return (session as AgentDraftSession).type === \"session/draft\";\n}\n\nfunction toSession(raw: GwSession): Session {\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 AgentSpec } : {}),\n        isMutable: mutable,\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: Turn[\"state\"];\n    createdAt: string;\n}): Turn {\n    return {\n        id: raw.id,\n        sessionId: raw.sessionId,\n        previousTurnId: raw.previousTurnId,\n        input: raw.input as TurnInputItem[] | undefined,\n        state: raw.state as Turn[\"state\"],\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. No try/catch fallback, no double network calls.\n */\nexport function createTrueFoundryChatServer(\n    opts: CreateTrueFoundryChatServerOptions,\n): TrueFoundryChatServer {\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\n    function cacheSessionType(session: Session): void {\n        sessionTypeCache.set(session.id, session.isMutable);\n    }\n\n    function getSessionObj(sessionId: string): Promise<GwSession> {\n        const isMutable = sessionTypeCache.get(sessionId);\n        if (isMutable === true) {\n            return privateClient.getDraftSession({ draftSessionId: sessionId });\n        }\n        if (isMutable === false) {\n            return client.getSession({ sessionId });\n        }\n        throw new Error(\n            `Cannot resolve session \"${sessionId}\": session type not cached. ` +\n                `Ensure createSession or listSessions was called first.`,\n        );\n    }\n\n    const server: TrueFoundryChatServer = {\n        async createSession(req) {\n            if (req.agentSpec != null) {\n                const draft = await privateClient.createDraftSession({\n                    agentSpec: req.agentSpec as never,\n                    ...(req.agentName != null ? { agentName: req.agentName } : {}),\n                });\n                const session = toSession(draft);\n                cacheSessionType(session);\n                return session;\n            }\n            if (req.agentName != null) {\n                const named = await client.createSession({\n                    agentName: req.agentName,\n                });\n                const session = toSession(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                ...(req?.agentName != null ? { agentName: req.agentName } : {}),\n            });\n            const result = await toListResult(page, toSession);\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(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 as never });\n            }\n            return toSession(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        async listTurns({ sessionId, limit, pageToken, order }) {\n            const raw = await getSessionObj(sessionId);\n            const page = await raw.listTurns({\n                ...(limit != null ? { limit } : {}),\n                ...(pageToken != null ? { pageToken } : {}),\n                ...(order != null ? { order } : {}),\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"],"mappings":"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","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server/index.d.ts

@@ -0,0 +1,17 @@
+import { R as TurnStreamingEvent, Y as DeltaEvents, c as TurnEvent } from '../types-DbNsU075.js';
+export { Z as ActionRequiredEvent, h as AgentBuilderServer, b as AgentChatServer, _ as AgentInfo, $ as AgentParent, a0 as AgentSelectorEntry, A as AgentSpec, i as AgentUIServerPort, a1 as ApprovalDecision, j as CatalogServer, a2 as ChunkDeltaToolCall, k as ConnectorAuth, l as ConnectorAuthPublic, m as ConnectorAuthType, n as ConnectorBase, o as ConnectorCatalogEntry, p as ConnectorCatalogServer, q as ConnectorConfigBase, a3 as ConnectorSelectorEntry, r as CreateConnectorRequest, s as CreateModelProviderRequest, C as CreateSessionRequest, t as CreateSkillRequest, u as ListResult, a4 as ListSessionsOrder, L as ListSessionsParams, M as McpAuthRequiredEvent, a5 as McpInitializeEvent, a6 as McpServerAuthInfo, a7 as McpServerMount, a8 as Model, v as ModelCatalogServer, w as ModelEntry, a9 as ModelMessageContentPart, aa as ModelMessageDeltaEvent, x as ModelMessageEvent, ab as ModelParams, y as ModelProviderBase, z as ModelProviderCatalogEntry, B as ModelProviderConfigBase, ac as ModelSelectorEntry, ad as PageParams, P as PreviousTurnIdInput, D as ProviderType, E as SandboxCreatedEvent, ae as SearchAgentSelectorParams, S as Session, F as SessionEventItem, G as SkillBase, H as SkillCatalogServer, af as SkillMount, ag as SkillSelectorEntry, d as ThreadCreatedEvent, ah as ThreadDoneEvent, I as ToolApprovalRequiredEvent, J as ToolBase, K as ToolCall, ai as ToolCallFunction, aj as ToolCallRef, ak as ToolInfo, al as ToolResponseEvent, N as ToolResponseRequiredEvent, T as Turn, am as TurnCreatedEvent, an as TurnDoneEvent, g as TurnInputItem, a as TurnState, ao as TurnStateCancelled, O as TurnStateDone, ap as TurnStateError, aq as TurnStateRunning, Q as TurnStreamData, V as UpdateConnectorRequest, W as UpdateModelProviderRequest, U as UpdateSessionRequest, X as UserMessage, ar as UserMessageContent, f as UserToolApprovalEvent, e as UserToolResponseEvent } from '../types-DbNsU075.js';
+
+/**
+ * Local implementations of streaming delta helpers.
+ * Formerly imported from truefoundry-gateway-sdk/agents.
+ */
+
+/** True for `.delta` streaming events. */
+declare function isEventDelta(event: TurnStreamingEvent): event is DeltaEvents;
+/**
+ * Merge `delta` into `base` in place (same `id` required).
+ * Currently handles `model.message.delta` → `model.message`.
+ */
+declare function mergeEventDelta(base: TurnEvent, delta: DeltaEvents): void;
+
+export { DeltaEvents, TurnEvent, TurnStreamingEvent, isEventDelta, mergeEventDelta };

package/dist/server/index.js

@@ -0,0 +1,9 @@
+import {
+  isEventDelta,
+  mergeEventDelta
+} from "../chunk-3A2EPLQG.js";
+export {
+  isEventDelta,
+  mergeEventDelta
+};
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}