@truefoundry/assistant-ui-runtime 0.1.5 → 0.1.6

package/dist/chunk-3A2EPLQG.js

@@ -0,0 +1,93 @@
+// src/server/eventUtils.ts
+function isEventDelta(event) {
+  return typeof event.type === "string" && event.type.endsWith(".delta");
+}
+function mergeEventDelta(base, delta) {
+  if (base.id !== delta.id) {
+    throw new Error(
+      `Cannot merge delta into a different event: base id "${base.id}" != delta id "${delta.id}".`
+    );
+  }
+  if (delta.type === "model.message.delta" && base.type === "model.message") {
+    mergeModelMessageDelta(base, delta);
+  }
+}
+function asToolInfo(value) {
+  if (value == null || typeof value !== "object") {
+    return void 0;
+  }
+  return value;
+}
+function mergeModelMessageDelta(base, delta) {
+  if (delta.content) {
+    if (base.content === void 0 || base.content === null || typeof base.content === "string") {
+      base.content = (base.content ?? "") + delta.content;
+    } else {
+      const last = base.content[base.content.length - 1];
+      if (last && last.type === "text") {
+        last.text += delta.content;
+      } else {
+        base.content.push({ type: "text", text: delta.content });
+      }
+    }
+  }
+  if (delta.refusal) {
+    base.refusal = (base.refusal ?? "") + delta.refusal;
+  }
+  if (delta.toolCalls) {
+    base.toolCalls ??= [];
+    for (const d of delta.toolCalls) {
+      let tc = base.toolCalls[d.index];
+      if (tc === void 0) {
+        const toolInfo2 = asToolInfo(d.toolInfo);
+        tc = {
+          id: d.id ?? "",
+          type: d.type ?? "function",
+          function: {
+            name: d.function?.name ?? "",
+            arguments: ""
+          },
+          ...toolInfo2 != null ? { toolInfo: toolInfo2 } : {}
+        };
+        base.toolCalls[d.index] = tc;
+      }
+      if (d.id) {
+        tc.id = d.id;
+      }
+      if (d.type) {
+        tc.type = d.type;
+      }
+      if (d.function?.name) {
+        tc.function.name = d.function.name;
+      }
+      if (d.function?.arguments) {
+        tc.function.arguments += d.function.arguments;
+      }
+      const toolInfo = asToolInfo(d.toolInfo);
+      if (toolInfo != null) {
+        tc.toolInfo = toolInfo;
+      }
+      if (d.providerSpecificFields) {
+        tc.providerSpecificFields = {
+          ...tc.providerSpecificFields ?? {},
+          ...d.providerSpecificFields
+        };
+      }
+    }
+  }
+  if (delta.finishReason) {
+    base.finishReason = delta.finishReason;
+  }
+  if (delta.reasoningContent) {
+    base.reasoningContent = (base.reasoningContent ?? "") + delta.reasoningContent;
+  }
+  if (delta.usage) {
+    base.usage = delta.usage;
+  }
+}
+
+export {
+  isEventDelta,
+  mergeEventDelta
+};
+//# sourceMappingURL=chunk-3A2EPLQG.js.map

package/dist/chunk-3A2EPLQG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/eventUtils.ts"],"sourcesContent":["/**\n * Local implementations of streaming delta helpers.\n * Formerly imported from truefoundry-gateway-sdk/agents.\n */\n\nimport type {\n    DeltaEvents,\n    ModelMessageDeltaEvent,\n    ModelMessageEvent,\n    ToolCall,\n    ToolInfo,\n    TurnEvent,\n    TurnStreamingEvent,\n} from \"./events.js\";\n\n/** True for `.delta` streaming events. */\nexport function isEventDelta(event: TurnStreamingEvent): event is DeltaEvents {\n    return typeof event.type === \"string\" && event.type.endsWith(\".delta\");\n}\n\n/**\n * Merge `delta` into `base` in place (same `id` required).\n * Currently handles `model.message.delta` → `model.message`.\n */\nexport function mergeEventDelta(base: TurnEvent, delta: DeltaEvents): void {\n    if (base.id !== delta.id) {\n        throw new Error(\n            `Cannot merge delta into a different event: base id \"${base.id}\" != delta id \"${delta.id}\".`,\n        );\n    }\n    if (delta.type === \"model.message.delta\" && base.type === \"model.message\") {\n        mergeModelMessageDelta(base, delta);\n    }\n}\n\nfunction asToolInfo(value: unknown): ToolInfo | undefined {\n    if (value == null || typeof value !== \"object\") {\n        return undefined;\n    }\n    return value as ToolInfo;\n}\n\nfunction mergeModelMessageDelta(\n    base: ModelMessageEvent,\n    delta: ModelMessageDeltaEvent,\n): void {\n    if (delta.content) {\n        if (\n            base.content === undefined ||\n            base.content === null ||\n            typeof base.content === \"string\"\n        ) {\n            base.content = (base.content ?? \"\") + delta.content;\n        } else {\n            const last = base.content[base.content.length - 1];\n            if (last && last.type === \"text\") {\n                last.text += delta.content;\n            } else {\n                base.content.push({ type: \"text\", text: delta.content });\n            }\n        }\n    }\n\n    if (delta.refusal) {\n        base.refusal = (base.refusal ?? \"\") + delta.refusal;\n    }\n\n    if (delta.toolCalls) {\n        base.toolCalls ??= [];\n        for (const d of delta.toolCalls) {\n            let tc: ToolCall | undefined = base.toolCalls[d.index];\n            if (tc === undefined) {\n                const toolInfo = asToolInfo(d.toolInfo);\n                tc = {\n                    id: d.id ?? \"\",\n                    type: d.type ?? \"function\",\n                    function: {\n                        name: d.function?.name ?? \"\",\n                        arguments: \"\",\n                    },\n                    ...(toolInfo != null ? { toolInfo } : {}),\n                };\n                base.toolCalls[d.index] = tc;\n            }\n            if (d.id) {\n                tc.id = d.id;\n            }\n            if (d.type) {\n                tc.type = d.type;\n            }\n            if (d.function?.name) {\n                tc.function.name = d.function.name;\n            }\n            if (d.function?.arguments) {\n                tc.function.arguments += d.function.arguments;\n            }\n            const toolInfo = asToolInfo(d.toolInfo);\n            if (toolInfo != null) {\n                tc.toolInfo = toolInfo;\n            }\n            if (d.providerSpecificFields) {\n                tc.providerSpecificFields = {\n                    ...(tc.providerSpecificFields ?? {}),\n                    ...d.providerSpecificFields,\n                };\n            }\n        }\n    }\n\n    if (delta.finishReason) {\n        base.finishReason = delta.finishReason;\n    }\n    if (delta.reasoningContent) {\n        base.reasoningContent =\n            (base.reasoningContent ?? \"\") + delta.reasoningContent;\n    }\n    if (delta.usage) {\n        base.usage = delta.usage;\n    }\n}\n"],"mappings":";AAgBO,SAAS,aAAa,OAAiD;AAC1E,SAAO,OAAO,MAAM,SAAS,YAAY,MAAM,KAAK,SAAS,QAAQ;AACzE;AAMO,SAAS,gBAAgB,MAAiB,OAA0B;AACvE,MAAI,KAAK,OAAO,MAAM,IAAI;AACtB,UAAM,IAAI;AAAA,MACN,uDAAuD,KAAK,EAAE,kBAAkB,MAAM,EAAE;AAAA,IAC5F;AAAA,EACJ;AACA,MAAI,MAAM,SAAS,yBAAyB,KAAK,SAAS,iBAAiB;AACvE,2BAAuB,MAAM,KAAK;AAAA,EACtC;AACJ;AAEA,SAAS,WAAW,OAAsC;AACtD,MAAI,SAAS,QAAQ,OAAO,UAAU,UAAU;AAC5C,WAAO;AAAA,EACX;AACA,SAAO;AACX;AAEA,SAAS,uBACL,MACA,OACI;AACJ,MAAI,MAAM,SAAS;AACf,QACI,KAAK,YAAY,UACjB,KAAK,YAAY,QACjB,OAAO,KAAK,YAAY,UAC1B;AACE,WAAK,WAAW,KAAK,WAAW,MAAM,MAAM;AAAA,IAChD,OAAO;AACH,YAAM,OAAO,KAAK,QAAQ,KAAK,QAAQ,SAAS,CAAC;AACjD,UAAI,QAAQ,KAAK,SAAS,QAAQ;AAC9B,aAAK,QAAQ,MAAM;AAAA,MACvB,OAAO;AACH,aAAK,QAAQ,KAAK,EAAE,MAAM,QAAQ,MAAM,MAAM,QAAQ,CAAC;AAAA,MAC3D;AAAA,IACJ;AAAA,EACJ;AAEA,MAAI,MAAM,SAAS;AACf,SAAK,WAAW,KAAK,WAAW,MAAM,MAAM;AAAA,EAChD;AAEA,MAAI,MAAM,WAAW;AACjB,SAAK,cAAc,CAAC;AACpB,eAAW,KAAK,MAAM,WAAW;AAC7B,UAAI,KAA2B,KAAK,UAAU,EAAE,KAAK;AACrD,UAAI,OAAO,QAAW;AAClB,cAAMA,YAAW,WAAW,EAAE,QAAQ;AACtC,aAAK;AAAA,UACD,IAAI,EAAE,MAAM;AAAA,UACZ,MAAM,EAAE,QAAQ;AAAA,UAChB,UAAU;AAAA,YACN,MAAM,EAAE,UAAU,QAAQ;AAAA,YAC1B,WAAW;AAAA,UACf;AAAA,UACA,GAAIA,aAAY,OAAO,EAAE,UAAAA,UAAS,IAAI,CAAC;AAAA,QAC3C;AACA,aAAK,UAAU,EAAE,KAAK,IAAI;AAAA,MAC9B;AACA,UAAI,EAAE,IAAI;AACN,WAAG,KAAK,EAAE;AAAA,MACd;AACA,UAAI,EAAE,MAAM;AACR,WAAG,OAAO,EAAE;AAAA,MAChB;AACA,UAAI,EAAE,UAAU,MAAM;AAClB,WAAG,SAAS,OAAO,EAAE,SAAS;AAAA,MAClC;AACA,UAAI,EAAE,UAAU,WAAW;AACvB,WAAG,SAAS,aAAa,EAAE,SAAS;AAAA,MACxC;AACA,YAAM,WAAW,WAAW,EAAE,QAAQ;AACtC,UAAI,YAAY,MAAM;AAClB,WAAG,WAAW;AAAA,MAClB;AACA,UAAI,EAAE,wBAAwB;AAC1B,WAAG,yBAAyB;AAAA,UACxB,GAAI,GAAG,0BAA0B,CAAC;AAAA,UAClC,GAAG,EAAE;AAAA,QACT;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAEA,MAAI,MAAM,cAAc;AACpB,SAAK,eAAe,MAAM;AAAA,EAC9B;AACA,MAAI,MAAM,kBAAkB;AACxB,SAAK,oBACA,KAAK,oBAAoB,MAAM,MAAM;AAAA,EAC9C;AACA,MAAI,MAAM,OAAO;AACb,SAAK,QAAQ,MAAM;AAAA,EACvB;AACJ;","names":["toolInfo"]}

package/dist/chunk-Q2SHKMLM.js

@@ -0,0 +1,270 @@
+// src/plugins/truefoundry-agent-server-adapter/index.ts
+import { AgentSessionClient } from "truefoundry-gateway-sdk/agents";
+import { PrivateAgentSessionClient } from "truefoundry-gateway-sdk/agents/private";
+
+// src/plugins/truefoundry-agent-server-adapter/guards.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function hasNumbers(value, keys) {
+  return isRecord(value) && keys.every((key) => typeof value[key] === "number");
+}
+function isTfySystemToolInfo(toolInfo) {
+  return isRecord(toolInfo) && toolInfo.type === "truefoundry-system" && typeof toolInfo.name === "string";
+}
+function isTfyMcpToolInfo(toolInfo) {
+  return isRecord(toolInfo) && toolInfo.type === "mcp" && typeof toolInfo.name === "string" && typeof toolInfo.serverId === "string" && typeof toolInfo.serverName === "string";
+}
+function isTfyToolInfo(toolInfo) {
+  return isTfySystemToolInfo(toolInfo) || isTfyMcpToolInfo(toolInfo);
+}
+var USAGE_BREAKDOWN_KEYS = [
+  "harness",
+  "skills",
+  "instructions",
+  "toolDefinitions",
+  "messages"
+];
+function getTfyUsage(source) {
+  const usage = source?.usage;
+  if (!hasNumbers(usage, ["inputTokens", "outputTokens"])) {
+    return void 0;
+  }
+  if (!hasNumbers(usage.inputTokensBreakdown, USAGE_BREAKDOWN_KEYS)) {
+    return void 0;
+  }
+  return usage;
+}
+function getTfyThreadState(event) {
+  const state = event?.state;
+  if (!isRecord(state)) {
+    return void 0;
+  }
+  if (state.status === "done" && isRecord(state.output)) {
+    return state;
+  }
+  if (state.status === "error" && typeof state.error === "string") {
+    return state;
+  }
+  return void 0;
+}
+function getTfyMcpInitServers(event) {
+  const servers = event?.mcpServers;
+  if (!Array.isArray(servers)) {
+    return void 0;
+  }
+  const valid = servers.every(
+    (server) => isRecord(server) && typeof server.id === "string" && typeof server.name === "string"
+  );
+  return valid ? servers : void 0;
+}
+
+// src/plugins/truefoundry-agent-server-adapter/index.ts
+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,
+    createdBySubject: raw.createdBySubject,
+    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,
+    createdBySubject: raw.createdBySubject,
+    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 } : {},
+          ...req.tfyMetadata != null ? { tfyMetadata: req.tfyMetadata } : {}
+        });
+        const session = toSession(draft);
+        cacheSessionType(session);
+        return session;
+      }
+      if (req.agentName != null) {
+        const named = await client.createSession({
+          agentName: req.agentName,
+          ...req.tfyMetadata != null ? { tfyMetadata: req.tfyMetadata } : {}
+        });
+        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,
+        endTimestamp: req?.endTimestamp,
+        ...req?.agentName != null ? { agentName: req.agentName } : {}
+      });
+      const result = await toListResult(page, (s) => toSession(s));
+      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 });
+    },
+    // The runtime's signature offers `order`, but the gateway's listTurns
+    // takes no such param — forwarding it silently did nothing.
+    async listTurns({ sessionId, limit, pageToken }) {
+      const raw = await getSessionObj(sessionId);
+      const page = await raw.listTurns({
+        ...limit != null ? { limit } : {},
+        ...pageToken != null ? { pageToken } : {}
+      });
+      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;
+}
+
+export {
+  isTfySystemToolInfo,
+  isTfyMcpToolInfo,
+  isTfyToolInfo,
+  getTfyUsage,
+  getTfyThreadState,
+  getTfyMcpInitServers,
+  createTrueFoundryChatServer
+};
+//# sourceMappingURL=chunk-Q2SHKMLM.js.map

package/dist/chunk-Q2SHKMLM.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\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. No try/catch fallback, no double network calls.\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\n    function cacheSessionType(session: {\n        id: string;\n        isMutable: boolean;\n    }): 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<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,15 +1,19 @@
 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 * as truefoundry_gateway_sdk_agents from 'truefoundry-gateway-sdk/agents';
-import { AgentSessionClient, TurnEvent, ThreadCreatedEvent, UserToolResponseEvent, McpAuthRequiredEvent, UserToolApprovalEvent, Turn, TurnInputItem, AgentSession } from 'truefoundry-gateway-sdk/agents';
-export { SandboxCreatedEvent } from 'truefoundry-gateway-sdk/agents';
-import { PrivateAgentSessionClient } from 'truefoundry-gateway-sdk/agents/private';
-export { AgentDraftSession, PrivateAgentSessionClient } from 'truefoundry-gateway-sdk/agents/private';
-import { TruefoundryGatewayApi } from 'truefoundry-gateway-sdk';
+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 * 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';
+import 'truefoundry-gateway-sdk/agents';
+import 'truefoundry-gateway-sdk/agents/private';
+import 'truefoundry-gateway-sdk';
 
-type AgentSpec = TruefoundryGatewayApi.AgentSpec;
-type DraftSession = TruefoundryGatewayApi.DraftSession;
+/** @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"]> & {
@@ -36,7 +40,7 @@ type DraftAgentConfig = {
 };
 type TrueFoundryAgentConfig = NamedAgentConfig | DraftAgentConfig;
 type TrueFoundryAgentRuntimeBaseOptions = ExternalStoreSharedOptions & {
-    client: AgentSessionClient;
+    server: AgentChatServer;
     initialSessionId?: string | undefined;
     threadId?: string | undefined;
     onThreadIdChange?: ((threadId: string | undefined) => void) | undefined;
@@ -55,11 +59,6 @@ type UseTrueFoundryAgentRuntimeOptions = TrueFoundryAgentRuntimeBaseOptions & {
     agent?: TrueFoundryAgentConfig | undefined;
     /** Legacy named-agent shorthand. Prefer `agent: { mode: "named", agentName }`. */
     agentName?: string | undefined;
-    /**
-     * Required when `agent.mode === "draft"`. Also used for sandbox file downloads
-     * (named or draft).
-     */
-    privateClient?: PrivateAgentSessionClient | undefined;
 };
 
 declare function useTrueFoundryAgentRuntime(options: UseTrueFoundryAgentRuntimeOptions): _assistant_ui_core.AssistantRuntime;
@@ -157,8 +156,8 @@ type ConvertTurnsResult = {
     runningTurn?: Turn;
     unstable_resume?: boolean;
 };
-declare function buildTurnAssistantContent(turn: Pick<Turn, "listEvents" | "state">, foldState?: PeerThreadFoldState): Promise<AssistantContentPart[]>;
-declare function convertTurnsToThreadMessages(session: AgentSession): Promise<ConvertTurnsResult>;
+declare function buildTurnAssistantContent(server: AgentChatServer, sessionId: string, turn: Pick<Turn, "id" | "state">, foldState?: PeerThreadFoldState): Promise<AssistantContentPart[]>;
+declare function convertTurnsToThreadMessages(server: AgentChatServer, sessionId: string): Promise<ConvertTurnsResult>;
 declare function getTurnMessageContent(message: AppendMessage): string;
 /**
  * Gateway `user.message` content (string for text-only, or text/file parts).
@@ -183,24 +182,24 @@ declare function buildEditedUserMessageContent(editedText: string, originalInput
 declare function repositoryItemsFromMessages(messages: readonly ThreadMessage[]): ExportedMessageRepositoryItem[];
 
 declare function createTrueFoundryDraftThreadListAdapter(options: {
-    privateClient: PrivateAgentSessionClient;
+    server: AgentChatServer;
     defaultAgentSpec: AgentSpec;
     getAgentSpec?: () => AgentSpec;
 }): RemoteThreadListAdapter;
 
 /**
- * Read-only thread-list adapter backed by `PrivateAgentSessionClient.listOwnedSessions`.
- * Returns every session the caller owns (named + draft), newest first.
+ * Read-only thread-list adapter backed by `AgentChatServer.listSessions`.
+ * Hosts that previously used listOwnedSessions should filter in their server impl.
  */
 declare function createTrueFoundryOwnedSessionsThreadListAdapter(options: {
-    privateClient: PrivateAgentSessionClient;
+    server: AgentChatServer;
 }): RemoteThreadListAdapter;
 
 type DraftSessionBridge = {
     syncAgentSpec: (draftSessionId: string, agentSpec: AgentSpec) => Promise<string>;
     getDraftAgentSpec: (draftSessionId: string) => Promise<AgentSpec>;
 };
-declare function createDraftSessionBridge(privateClient: PrivateAgentSessionClient): DraftSessionBridge;
+declare function createDraftSessionBridge(server: AgentChatServer): DraftSessionBridge;
 
 type PendingApproval = {
     approvalId: string;
@@ -260,7 +259,7 @@ declare const useTrueFoundryToolResponses: () => {
 /** Pending MCP OAuth plus a resume action. */
 declare const useTrueFoundryMcpAuth: () => {
     pending: {
-        mcpServers: truefoundry_gateway_sdk_agents.McpAuthRequiredEvent["mcpServers"];
+        mcpServers: McpAuthRequiredEvent["mcpServers"];
     } | null;
     resume: () => Promise<void>;
 };
@@ -305,16 +304,12 @@ declare function findPausedAssistantMessage(messages: readonly ThreadMessage[]):
 }> | undefined;
 
 declare function createTrueFoundryThreadListAdapter(options: {
-    client: AgentSessionClient;
+    server: AgentChatServer;
     agentName: string;
 }): RemoteThreadListAdapter;
 
-type GetSessionOptions = {
-    /** When set, validates the draft and binds turns via PrivateAgentSessionClient. */
-    privateClient?: PrivateAgentSessionClient;
-};
 /** `sessionId` is the assistant-ui thread `remoteId` from `RemoteThreadListAdapter.initialize`. */
-declare function getSession(client: AgentSessionClient, sessionId: string, options?: GetSessionOptions): Promise<AgentSession>;
+declare function getSession(server: AgentChatServer, sessionId: string): Promise<Session>;
 
 /**
  * Reads composer files into `CompleteAttachment` `file` parts for send.
@@ -322,4 +317,4 @@ declare function getSession(client: AgentSessionClient, sessionId: string, optio
  */
 declare const trueFoundryAttachmentAdapter: AttachmentAdapter;
 
-export { type AgentSpec, type AgentSpecUpdate, type ConvertTurnsResult, type DraftAgentConfig, type DraftSession, type DraftSessionBridge, type McpAuthMessageCustomMetadata, type NamedAgentConfig, type PendingApproval, type PendingToolResponse, ROOT_THREAD_ID, type SandboxMessageCustomMetadata, type SubAgentArtifact, type SubAgentCustomMetadata, type SubAgentMessageCustomMetadata, TOOL_RESPONSE_THREAD_ID_CUSTOM_KEY, type ToolApprovalMessageCustomMetadata, type ToolResponseMessageCustomMetadata, type TrueFoundryAgentConfig, type TrueFoundryDraftRuntimeExtras, type TrueFoundryMessageCustomMetadata, type TrueFoundryRuntimeExtras, type UseTrueFoundryAgentRuntimeOptions, type UserMessageContent, 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, 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 };