@truefoundry/assistant-ui-runtime 0.1.1 → 0.1.3-rc.1

package/dist/index.js

@@ -1304,6 +1304,280 @@ function replaceSessionSnapshot(snapshot, patch) {
 // src/convertTurnMessages.ts
 var TURN_EVENTS_PAGE_SIZE = 25;
 var SESSION_EVENTS_PAGE_SIZE = 100;
+var MAX_HISTORY_BOUNDARY_PAGES = 10;
+function trimIncompleteLeadingEvents(itemsAsc) {
+  const start = itemsAsc.findIndex((item) => item.event.type === "turn.created");
+  if (start === -1) {
+    return [];
+  }
+  return itemsAsc.slice(start);
+}
+function oldestCompleteTurnGroupState(itemsAsc) {
+  const trimmed = trimIncompleteLeadingEvents(itemsAsc);
+  if (trimmed.length === 0) {
+    return "incomplete";
+  }
+  const created = trimmed[0];
+  if (created?.event.type !== "turn.created") {
+    return "incomplete";
+  }
+  const hasDone = trimmed.some(
+    (item) => item.turnId === created.turnId && item.event.type === "turn.done"
+  );
+  if (!hasDone) {
+    return "incomplete";
+  }
+  return extractTurnUserText(created.event.input) != null ? "user-group" : "continuation";
+}
+async function fetchSessionEventsPage(session, options) {
+  const page = await session.listEvents({
+    limit: SESSION_EVENTS_PAGE_SIZE,
+    ...options?.lastTurnId != null ? { lastTurnId: options.lastTurnId } : {},
+    ...options?.pageToken != null ? { pageToken: options.pageToken } : {}
+  });
+  const response = page.response;
+  const olderPageToken = response.pagination?.nextPageToken;
+  const hasOlder = typeof page.hasNextPage === "function" ? page.hasNextPage() : olderPageToken != null && olderPageToken !== "";
+  return {
+    itemsNewestFirst: page.data,
+    ...olderPageToken != null && olderPageToken !== "" ? { olderPageToken } : {},
+    hasOlder
+  };
+}
+async function fetchSessionEventsWindow(session, options) {
+  let itemsNewestFirst = [];
+  let pageToken = options?.pageToken;
+  let olderPageToken;
+  let hasOlder = false;
+  for (let pageCount = 0; pageCount < MAX_HISTORY_BOUNDARY_PAGES; pageCount++) {
+    const page = await fetchSessionEventsPage(session, {
+      ...options,
+      ...pageToken != null ? { pageToken } : {}
+    });
+    itemsNewestFirst = [...itemsNewestFirst, ...page.itemsNewestFirst];
+    olderPageToken = page.olderPageToken;
+    hasOlder = page.hasOlder;
+    const itemsAsc2 = trimIncompleteLeadingEvents([...itemsNewestFirst].reverse());
+    const groupState = oldestCompleteTurnGroupState(itemsAsc2);
+    if (groupState === "user-group" || !hasOlder) {
+      return {
+        itemsAsc: itemsAsc2,
+        ...olderPageToken != null ? { olderPageToken } : {},
+        hasOlder
+      };
+    }
+    if (olderPageToken == null) {
+      return { itemsAsc: itemsAsc2, hasOlder: false };
+    }
+    pageToken = olderPageToken;
+  }
+  const itemsAsc = trimIncompleteLeadingEvents([...itemsNewestFirst].reverse());
+  return {
+    itemsAsc,
+    ...olderPageToken != null ? { olderPageToken } : {},
+    hasOlder
+  };
+}
+async function fetchAllSessionEvents(session, options) {
+  const items = [];
+  for await (const item of await session.listEvents({
+    limit: SESSION_EVENTS_PAGE_SIZE,
+    ...options?.lastTurnId != null ? { lastTurnId: options.lastTurnId } : {}
+  })) {
+    items.push(item);
+  }
+  items.reverse();
+  return items;
+}
+function cloneThreadBucket(bucket) {
+  return {
+    events: new Map(bucket.events),
+    modelMessageIds: [...bucket.modelMessageIds],
+    toolResults: new Map(bucket.toolResults),
+    pendingApprovals: new Map(bucket.pendingApprovals),
+    approvalDecisions: new Map(bucket.approvalDecisions),
+    pendingResponses: new Map(bucket.pendingResponses),
+    done: bucket.done,
+    ...bucket.title != null ? { title: bucket.title } : {},
+    ...bucket.agentInfo != null ? { agentInfo: bucket.agentInfo } : {}
+  };
+}
+function prependFoldState(older, newer) {
+  const result = new PeerThreadFoldState();
+  const threadIds = /* @__PURE__ */ new Set([...older.threads.keys(), ...newer.threads.keys()]);
+  for (const threadId of threadIds) {
+    const olderBucket = older.threads.get(threadId);
+    const newerBucket = newer.threads.get(threadId);
+    if (olderBucket == null && newerBucket != null) {
+      result.threads.set(threadId, cloneThreadBucket(newerBucket));
+      continue;
+    }
+    if (newerBucket == null && olderBucket != null) {
+      result.threads.set(threadId, cloneThreadBucket(olderBucket));
+      continue;
+    }
+    if (olderBucket == null || newerBucket == null) {
+      continue;
+    }
+    result.threads.set(threadId, {
+      events: new Map([...olderBucket.events, ...newerBucket.events]),
+      modelMessageIds: [
+        ...olderBucket.modelMessageIds,
+        ...newerBucket.modelMessageIds
+      ],
+      toolResults: new Map([
+        ...olderBucket.toolResults,
+        ...newerBucket.toolResults
+      ]),
+      pendingApprovals: new Map([
+        ...olderBucket.pendingApprovals,
+        ...newerBucket.pendingApprovals
+      ]),
+      approvalDecisions: new Map([
+        ...olderBucket.approvalDecisions,
+        ...newerBucket.approvalDecisions
+      ]),
+      pendingResponses: new Map([
+        ...olderBucket.pendingResponses,
+        ...newerBucket.pendingResponses
+      ]),
+      done: newerBucket.done || olderBucket.done,
+      ...newerBucket.title != null || olderBucket.title != null ? { title: newerBucket.title ?? olderBucket.title } : {},
+      ...newerBucket.agentInfo != null || olderBucket.agentInfo != null ? { agentInfo: newerBucket.agentInfo ?? olderBucket.agentInfo } : {}
+    });
+  }
+  for (const [threadId, link] of older.threadParents) {
+    result.threadParents.set(threadId, link);
+  }
+  for (const [threadId, link] of newer.threadParents) {
+    result.threadParents.set(threadId, link);
+  }
+  return result;
+}
+function ingestSessionEventsIntoSnapshot(snapshot, items, onTurnComplete) {
+  let currentTurnId = null;
+  let currentCreatedEvent = null;
+  let currentContentEvents = [];
+  let beforeCount = 0;
+  for (const item of items) {
+    const { turnId, event } = item;
+    if (event.type === "turn.created") {
+      currentTurnId = turnId;
+      currentCreatedEvent = event;
+      currentContentEvents = [];
+      beforeCount = snapshot.fold.threads.get(ROOT_THREAD_ID)?.modelMessageIds.length ?? 0;
+    } else if (event.type === "turn.done") {
+      if (currentTurnId == null || currentCreatedEvent == null) {
+        continue;
+      }
+      const afterBucket = snapshot.fold.threads.get(ROOT_THREAD_ID);
+      const rootModelMessageIds = (afterBucket?.modelMessageIds ?? []).slice(
+        beforeCount
+      );
+      const sandboxEvent = currentContentEvents.find(
+        (ev) => ev.type === "sandbox.created"
+      );
+      applyUserToolResponsesToFold(
+        snapshot.fold,
+        currentCreatedEvent.input ?? []
+      );
+      snapshot.turns.push(
+        sessionEventsToSessionRecord(
+          currentTurnId,
+          currentCreatedEvent,
+          event,
+          rootModelMessageIds,
+          sandboxEvent?.sandboxId
+        )
+      );
+      onTurnComplete?.(replaceSessionSnapshot(snapshot, {}));
+      currentTurnId = null;
+      currentCreatedEvent = null;
+      currentContentEvents = [];
+    } else {
+      if (currentTurnId != null) {
+        ingestTurnEvent(snapshot.fold, event);
+        currentContentEvents.push(event);
+      }
+    }
+  }
+}
+function attachRunningTurn(snapshot, runningTurn) {
+  if (runningTurn == null) {
+    return snapshot;
+  }
+  const pendingUserText = extractTurnUserText(runningTurn.input);
+  return replaceSessionSnapshot(snapshot, {
+    runningTurn,
+    unstable_resume: true,
+    groupRootBaseline: computeGroupRootBaseline(snapshot.turns),
+    ...pendingUserText ? {
+      pendingUser: {
+        turnId: runningTurn.id,
+        content: extractTurnUserMessageContent(runningTurn.input),
+        createdAt: new Date(runningTurn.createdAt)
+      }
+    } : {}
+  });
+}
+async function buildSnapshotFromSessionEvents(session, onProgress) {
+  const turnsPage = await session.listTurns({ limit: 1 });
+  const newestTurn = turnsPage.data[0];
+  const runningTurn = newestTurn?.state?.status === "running" ? newestTurn : void 0;
+  const window = await fetchSessionEventsWindow(session);
+  const historyPagination = {
+    hasOlder: window.hasOlder,
+    ...window.olderPageToken != null ? { olderPageToken: window.olderPageToken } : {}
+  };
+  const snapshot = createEmptySessionSnapshot();
+  ingestSessionEventsIntoSnapshot(snapshot, window.itemsAsc, onProgress);
+  const withHistory = replaceSessionSnapshot(snapshot, {
+    historyEvents: window.itemsAsc,
+    historyPagination
+  });
+  return attachRunningTurn(withHistory, runningTurn);
+}
+async function prependOlderSessionHistory(session, snapshot) {
+  const pagination = snapshot.historyPagination;
+  if (pagination?.hasOlder !== true || pagination.olderPageToken == null) {
+    return snapshot;
+  }
+  const window = await fetchSessionEventsWindow(session, {
+    pageToken: pagination.olderPageToken
+  });
+  if (window.itemsAsc.length === 0) {
+    return replaceSessionSnapshot(snapshot, {
+      historyPagination: { hasOlder: false }
+    });
+  }
+  const olderSnap = createEmptySessionSnapshot();
+  ingestSessionEventsIntoSnapshot(olderSnap, window.itemsAsc);
+  const existingIds = new Set(snapshot.turns.map((turn) => turn.id));
+  const olderTurns = olderSnap.turns.filter((turn) => !existingIds.has(turn.id));
+  const mergedFold = prependFoldState(olderSnap.fold, snapshot.fold);
+  const historyEvents = [
+    ...window.itemsAsc,
+    ...snapshot.historyEvents ?? []
+  ];
+  const olderRootIds = olderTurns.flatMap(
+    (turn) => turn.rootModelMessageIds ?? []
+  );
+  return replaceSessionSnapshot(snapshot, {
+    fold: mergedFold,
+    turns: [...olderTurns, ...snapshot.turns],
+    historyEvents,
+    historyPagination: {
+      hasOlder: window.hasOlder,
+      ...window.olderPageToken != null ? { olderPageToken: window.olderPageToken } : {}
+    },
+    ...snapshot.groupRootBaseline != null ? {
+      groupRootBaseline: [
+        ...olderRootIds,
+        ...snapshot.groupRootBaseline
+      ]
+    } : {}
+  });
+}
 function assistantStatusFromTurnState(state) {
   switch (state.status) {
     case "done":
@@ -1710,92 +1984,6 @@ function projectSessionMessages(snapshot, options) {
   );
 }
 var DEFAULT_LIST_EVENTS_CONCURRENCY = 5;
-async function fetchAllSessionEvents(session, options) {
-  const items = [];
-  for await (const item of await session.listEvents({
-    limit: SESSION_EVENTS_PAGE_SIZE,
-    ...options?.lastTurnId != null ? { lastTurnId: options.lastTurnId } : {}
-  })) {
-    items.push(item);
-  }
-  items.reverse();
-  return items;
-}
-function ingestSessionEventsIntoSnapshot(snapshot, items, onTurnComplete) {
-  let currentTurnId = null;
-  let currentCreatedEvent = null;
-  let currentContentEvents = [];
-  let beforeCount = 0;
-  for (const item of items) {
-    const { turnId, event } = item;
-    if (event.type === "turn.created") {
-      currentTurnId = turnId;
-      currentCreatedEvent = event;
-      currentContentEvents = [];
-      beforeCount = snapshot.fold.threads.get(ROOT_THREAD_ID)?.modelMessageIds.length ?? 0;
-    } else if (event.type === "turn.done") {
-      if (currentTurnId == null || currentCreatedEvent == null) {
-        continue;
-      }
-      const afterBucket = snapshot.fold.threads.get(ROOT_THREAD_ID);
-      const rootModelMessageIds = (afterBucket?.modelMessageIds ?? []).slice(
-        beforeCount
-      );
-      const sandboxEvent = currentContentEvents.find(
-        (ev) => ev.type === "sandbox.created"
-      );
-      applyUserToolResponsesToFold(
-        snapshot.fold,
-        currentCreatedEvent.input ?? []
-      );
-      snapshot.turns.push(
-        sessionEventsToSessionRecord(
-          currentTurnId,
-          currentCreatedEvent,
-          event,
-          rootModelMessageIds,
-          sandboxEvent?.sandboxId
-        )
-      );
-      onTurnComplete?.(replaceSessionSnapshot(snapshot, {}));
-      currentTurnId = null;
-      currentCreatedEvent = null;
-      currentContentEvents = [];
-    } else {
-      if (currentTurnId != null) {
-        ingestTurnEvent(snapshot.fold, event);
-        currentContentEvents.push(event);
-      }
-    }
-  }
-}
-async function buildSnapshotFromSessionEvents(session, onProgress) {
-  let runningTurn;
-  for await (const turn of await session.listTurns({ limit: 1 })) {
-    if (turn.state?.status === "running") {
-      runningTurn = turn;
-    }
-  }
-  const items = await fetchAllSessionEvents(session);
-  const snapshot = createEmptySessionSnapshot();
-  ingestSessionEventsIntoSnapshot(snapshot, items, onProgress);
-  if (runningTurn == null) {
-    return snapshot;
-  }
-  const pendingUserText = extractTurnUserText(runningTurn.input);
-  return replaceSessionSnapshot(snapshot, {
-    runningTurn,
-    unstable_resume: true,
-    groupRootBaseline: computeGroupRootBaseline(snapshot.turns),
-    ...pendingUserText ? {
-      pendingUser: {
-        turnId: runningTurn.id,
-        content: extractTurnUserMessageContent(runningTurn.input),
-        createdAt: new Date(runningTurn.createdAt)
-      }
-    } : {}
-  });
-}
 function ingestTurnsIntoSnapshot(snapshot, turns, eventArrays) {
   let runningTurn;
   for (let i = 0; i < turns.length; i++) {
@@ -1834,9 +2022,18 @@ async function buildSnapshotFromSession(session, concurrency = DEFAULT_LIST_EVEN
   return replaceSessionSnapshot(snapshot, {
     runningTurn: turn,
     unstable_resume: true,
-    groupRootBaseline: computeGroupRootBaseline(snapshot.turns)
+    groupRootBaseline: computeGroupRootBaseline(snapshot.turns),
+    pendingUser: void 0
   });
 }
+async function buildSnapshotBeforeTurn(session, beforeTurnId, concurrency = DEFAULT_LIST_EVENTS_CONCURRENCY) {
+  const turns = await listSessionTurnsOrdered(session);
+  const beforeIndex = turns.findIndex((turn) => turn.id === beforeTurnId);
+  if (beforeIndex === -1) {
+    throw new Error(`Turn ${beforeTurnId} not found in session`);
+  }
+  return buildSnapshotBeforeTurnIndex(session, beforeIndex, concurrency, turns);
+}
 async function buildSnapshotBeforeTurnIndex(session, turnIndex, _concurrency = DEFAULT_LIST_EVENTS_CONCURRENCY, orderedTurns) {
   if (turnIndex <= 0) {
     return createEmptySessionSnapshot();
@@ -1859,6 +2056,11 @@ async function resolveGatewayBranchPreviousTurnId(session, turnIndex, orderedTur
   const turns = orderedTurns ?? await listSessionTurnsOrdered(session);
   return turns[turnIndex - 1]?.id ?? null;
 }
+async function resolveGatewayBranchPreviousTurnIdForTurn(session, turnId) {
+  const turns = await listSessionTurnsOrdered(session);
+  const turnIndex = turns.findIndex((turn) => turn.id === turnId);
+  return resolveGatewayBranchPreviousTurnId(session, turnIndex, turns);
+}
 async function listSessionTurnsOrdered(session) {
   const turns = [];
   for await (const turn of await session.listTurns()) {
@@ -2073,1199 +2275,187 @@ async function* streamTurnEvents(stream, foldState, groupRootBaseline) {
         toolApprovalMessageCustom(
           approvalThreadId === ROOT_THREAD_ID ? ROOT_THREAD_ID : approvalThreadId
         )
-      );
-    }
-    if (responseThreadId != null) {
-      Object.assign(
-        custom,
-        toolResponseMessageCustom(
-          responseThreadId === ROOT_THREAD_ID ? ROOT_THREAD_ID : responseThreadId
-        )
-      );
-    }
-    const ids = groupRootBaseline != null ? rootModelMessageIdsSinceBaseline(foldState, groupRootBaseline) : foldState.threads.get(ROOT_THREAD_ID)?.modelMessageIds ?? [];
-    yield withSandbox({
-      content: buildRootAssistantContentForIds(foldState, ids),
-      status: approvalThreadId != null ? toolApprovalStatus() : toolResponseStatus(),
-      metadata: { custom }
-    });
-    return;
-  }
-  if (sandboxId != null && !sandboxIdYielded) {
-    const ids = groupRootBaseline != null ? rootModelMessageIdsSinceBaseline(foldState, groupRootBaseline) : foldState.threads.get(ROOT_THREAD_ID)?.modelMessageIds ?? [];
-    yield withSandbox({ content: buildRootAssistantContentForIds(foldState, ids) });
-  }
-}
-function turnStreamUpdateToAssistantMessage(turnId, update, existing, options) {
-  const id = existing?.role === "assistant" ? existing.id : `${turnId}-assistant`;
-  const fallbackCreatedAt = existing?.createdAt ?? /* @__PURE__ */ new Date();
-  return {
-    id,
-    role: "assistant",
-    content: update.content,
-    status: update.status ?? { type: "running" },
-    createdAt: resolveCreatedAt(id, fallbackCreatedAt, options),
-    metadata: {
-      unstable_state: null,
-      unstable_annotations: [],
-      unstable_data: [],
-      steps: [],
-      custom: update.metadata?.custom ?? {}
-    }
-  };
-}
-function repositoryItemsFromMessages(messages) {
-  const items = [];
-  let parentId = null;
-  for (const message of messages) {
-    items.push({ parentId, message });
-    parentId = message.id;
-  }
-  return items;
-}
-
-// src/private/draftSessionBridge.ts
-function createDraftSessionBridge(gateway) {
-  async function getDraft(draftSessionId) {
-    const response = await gateway.agents.private.draftSessions.get(draftSessionId);
-    return response.data;
-  }
-  return {
-    async getDraftAgentSpec(draftSessionId) {
-      const draft = await getDraft(draftSessionId);
-      return draft.agentSpec;
-    },
-    async syncAgentSpec(draftSessionId, agentSpec) {
-      await gateway.agents.private.draftSessions.update(draftSessionId, { agentSpec });
-    }
-  };
-}
-
-// src/private/agentSpec.ts
-function mergeAgentSpec(base, update) {
-  const { model: modelUpdate, ...rest } = update;
-  const next = {
-    ...base,
-    ...rest
-  };
-  if (modelUpdate != null) {
-    next.model = {
-      ...base.model,
-      ...modelUpdate,
-      name: modelUpdate.name ?? base.model.name,
-      params: modelUpdate.params != null ? { ...base.model.params, ...modelUpdate.params } : base.model.params
-    };
-  }
-  return next;
-}
-function draftSessionTitle(draft) {
-  return draft.title ?? draft.agentSpec.model.name;
-}
-
-// src/sessionListStartTimestamp.ts
-function sessionListStartTimestamp() {
-  const start = /* @__PURE__ */ new Date();
-  start.setFullYear(start.getFullYear() - 1);
-  return start.toISOString();
-}
-
-// src/private/truefoundryDraftThreadListAdapter.ts
-var THREAD_LIST_PAGE_SIZE = 20;
-function createTrueFoundryDraftThreadListAdapter(options) {
-  const { gateway, defaultAgentSpec, getAgentSpec } = options;
-  return {
-    async list({ after } = {}) {
-      const page = await gateway.agents.private.draftSessions.list({
-        limit: THREAD_LIST_PAGE_SIZE,
-        pageToken: after,
-        startTimestamp: sessionListStartTimestamp()
-      });
-      const threads = page.data.map((draft) => ({
-        status: "regular",
-        remoteId: draft.id,
-        title: draftSessionTitle(draft),
-        lastMessageAt: new Date(draft.updatedAt)
-      }));
-      return {
-        threads,
-        nextCursor: page.response.pagination.nextPageToken ?? void 0
-      };
-    },
-    async initialize(_threadId) {
-      const response = await gateway.agents.private.draftSessions.create({
-        agentSpec: getAgentSpec?.() ?? defaultAgentSpec
-      });
-      const draft = response.data;
-      return { remoteId: draft.id, externalId: void 0 };
-    },
-    async fetch(remoteId) {
-      const response = await gateway.agents.private.draftSessions.get(remoteId);
-      const draft = response.data;
-      return {
-        status: "regular",
-        remoteId: draft.id,
-        title: draftSessionTitle(draft),
-        lastMessageAt: new Date(draft.updatedAt)
-      };
-    },
-    async rename() {
-    },
-    async archive() {
-    },
-    async unarchive() {
-    },
-    async delete() {
-    },
-    async generateTitle() {
-      return new ReadableStream();
-    }
-  };
-}
-
-// src/truefoundryExtras.ts
-import { createRuntimeExtras } from "@assistant-ui/core/internal";
-var trueFoundryExtras = createRuntimeExtras(
-  "useTrueFoundryAgentRuntime"
-);
-var EMPTY_DRAFT_EXTRAS = {
-  agentSpec: null,
-  draftSessionId: void 0,
-  isSpecSyncing: false,
-  specError: null,
-  updateAgentSpec: () => {
-    throw new Error("Draft agent extras are only available in draft mode.");
-  }
-};
-
-// ../../node_modules/.pnpm/truefoundry-gateway-sdk@0.3.1/node_modules/truefoundry-gateway-sdk/dist/esm/core/fetcher/HttpResponsePromise.mjs
-var __awaiter = function(thisArg, _arguments, P, generator) {
-  function adopt(value) {
-    return value instanceof P ? value : new P(function(resolve) {
-      resolve(value);
-    });
-  }
-  return new (P || (P = Promise))(function(resolve, reject) {
-    function fulfilled(value) {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    }
-    function rejected(value) {
-      try {
-        step(generator["throw"](value));
-      } catch (e) {
-        reject(e);
-      }
-    }
-    function step(result) {
-      result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
-    }
-    step((generator = generator.apply(thisArg, _arguments || [])).next());
-  });
-};
-var HttpResponsePromise = class _HttpResponsePromise extends Promise {
-  constructor(promise) {
-    super((resolve) => {
-      resolve(void 0);
-    });
-    this.innerPromise = promise;
-  }
-  /**
-   * Creates an `HttpResponsePromise` from a function that returns a promise.
-   *
-   * @param fn - A function that returns a promise resolving to a `WithRawResponse` object.
-   * @param args - Arguments to pass to the function.
-   * @returns An `HttpResponsePromise` instance.
-   */
-  static fromFunction(fn, ...args) {
-    return new _HttpResponsePromise(fn(...args));
-  }
-  /**
-   * Creates a function that returns an `HttpResponsePromise` from a function that returns a promise.
-   *
-   * @param fn - A function that returns a promise resolving to a `WithRawResponse` object.
-   * @returns A function that returns an `HttpResponsePromise` instance.
-   */
-  static interceptFunction(fn) {
-    return (...args) => {
-      return _HttpResponsePromise.fromPromise(fn(...args));
-    };
-  }
-  /**
-   * Creates an `HttpResponsePromise` from an existing promise.
-   *
-   * @param promise - A promise resolving to a `WithRawResponse` object.
-   * @returns An `HttpResponsePromise` instance.
-   */
-  static fromPromise(promise) {
-    return new _HttpResponsePromise(promise);
-  }
-  /**
-   * Creates an `HttpResponsePromise` from an executor function.
-   *
-   * @param executor - A function that takes resolve and reject callbacks to create a promise.
-   * @returns An `HttpResponsePromise` instance.
-   */
-  static fromExecutor(executor) {
-    const promise = new Promise(executor);
-    return new _HttpResponsePromise(promise);
-  }
-  /**
-   * Creates an `HttpResponsePromise` from a resolved result.
-   *
-   * @param result - A `WithRawResponse` object to resolve immediately.
-   * @returns An `HttpResponsePromise` instance.
-   */
-  static fromResult(result) {
-    const promise = Promise.resolve(result);
-    return new _HttpResponsePromise(promise);
-  }
-  unwrap() {
-    if (!this.unwrappedPromise) {
-      this.unwrappedPromise = this.innerPromise.then(({ data }) => data);
-    }
-    return this.unwrappedPromise;
-  }
-  /** @inheritdoc */
-  then(onfulfilled, onrejected) {
-    return this.unwrap().then(onfulfilled, onrejected);
-  }
-  /** @inheritdoc */
-  catch(onrejected) {
-    return this.unwrap().catch(onrejected);
-  }
-  /** @inheritdoc */
-  finally(onfinally) {
-    return this.unwrap().finally(onfinally);
-  }
-  /**
-   * Retrieves the data and raw response.
-   *
-   * @returns A promise resolving to a `WithRawResponse` object.
-   */
-  withRawResponse() {
-    return __awaiter(this, void 0, void 0, function* () {
-      return yield this.innerPromise;
-    });
-  }
-};
-
-// ../../node_modules/.pnpm/truefoundry-gateway-sdk@0.3.1/node_modules/truefoundry-gateway-sdk/dist/esm/core/pagination/Page.mjs
-var __awaiter2 = function(thisArg, _arguments, P, generator) {
-  function adopt(value) {
-    return value instanceof P ? value : new P(function(resolve) {
-      resolve(value);
-    });
-  }
-  return new (P || (P = Promise))(function(resolve, reject) {
-    function fulfilled(value) {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    }
-    function rejected(value) {
-      try {
-        step(generator["throw"](value));
-      } catch (e) {
-        reject(e);
-      }
-    }
-    function step(result) {
-      result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
-    }
-    step((generator = generator.apply(thisArg, _arguments || [])).next());
-  });
-};
-var __await = function(v) {
-  return this instanceof __await ? (this.v = v, this) : new __await(v);
-};
-var __asyncGenerator = function(thisArg, _arguments, generator) {
-  if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-  var g = generator.apply(thisArg, _arguments || []), i, q = [];
-  return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function() {
-    return this;
-  }, i;
-  function awaitReturn(f) {
-    return function(v) {
-      return Promise.resolve(v).then(f, reject);
-    };
-  }
-  function verb(n, f) {
-    if (g[n]) {
-      i[n] = function(v) {
-        return new Promise(function(a, b) {
-          q.push([n, v, a, b]) > 1 || resume(n, v);
-        });
-      };
-      if (f) i[n] = f(i[n]);
-    }
-  }
-  function resume(n, v) {
-    try {
-      step(g[n](v));
-    } catch (e) {
-      settle(q[0][3], e);
-    }
-  }
-  function step(r) {
-    r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r);
-  }
-  function fulfill(value) {
-    resume("next", value);
-  }
-  function reject(value) {
-    resume("throw", value);
-  }
-  function settle(f, v) {
-    if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]);
-  }
-};
-var __asyncValues = function(o) {
-  if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-  var m = o[Symbol.asyncIterator], i;
-  return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function() {
-    return this;
-  }, i);
-  function verb(n) {
-    i[n] = o[n] && function(v) {
-      return new Promise(function(resolve, reject) {
-        v = o[n](v), settle(resolve, reject, v.done, v.value);
-      });
-    };
-  }
-  function settle(resolve, reject, d, v) {
-    Promise.resolve(v).then(function(v2) {
-      resolve({ value: v2, done: d });
-    }, reject);
-  }
-};
-var Page = class {
-  constructor({ response, rawResponse, hasNextPage, getItems, loadPage }) {
-    this.response = response;
-    this.rawResponse = rawResponse;
-    this.data = getItems(response);
-    this._hasNextPage = hasNextPage;
-    this.getItems = getItems;
-    this.loadNextPage = loadPage;
-  }
-  /**
-   * Retrieves the next page
-   * @returns this
-   */
-  getNextPage() {
-    return __awaiter2(this, void 0, void 0, function* () {
-      const { data, rawResponse } = yield this.loadNextPage(this.response).withRawResponse();
-      this.response = data;
-      this.rawResponse = rawResponse;
-      this.data = this.getItems(this.response);
-      return this;
-    });
-  }
-  /**
-   * @returns whether there is a next page to load
-   */
-  hasNextPage() {
-    return this._hasNextPage(this.response);
-  }
-  iterMessages() {
-    return __asyncGenerator(this, arguments, function* iterMessages_1() {
-      for (const item of this.data) {
-        yield yield __await(item);
-      }
-      while (this.hasNextPage()) {
-        yield __await(this.getNextPage());
-        for (const item of this.data) {
-          yield yield __await(item);
-        }
-      }
-    });
-  }
-  [Symbol.asyncIterator]() {
-    return __asyncGenerator(this, arguments, function* _a() {
-      var _b, e_1, _c, _d;
-      try {
-        for (var _e = true, _f = __asyncValues(this.iterMessages()), _g; _g = yield __await(_f.next()), _b = _g.done, !_b; _e = true) {
-          _d = _g.value;
-          _e = false;
-          const message = _d;
-          yield yield __await(message);
-        }
-      } catch (e_1_1) {
-        e_1 = { error: e_1_1 };
-      } finally {
-        try {
-          if (!_e && !_b && (_c = _f.return)) yield __await(_c.call(_f));
-        } finally {
-          if (e_1) throw e_1.error;
-        }
-      }
-    });
-  }
-};
-
-// ../../node_modules/.pnpm/truefoundry-gateway-sdk@0.3.1/node_modules/truefoundry-gateway-sdk/dist/esm/agents/TurnStreamData.mjs
-function parseSequenceNumber(id) {
-  if (!id) {
-    throw new Error("Missing SSE sequence number id.");
-  }
-  const parsed = Number(id);
-  if (!Number.isFinite(parsed)) {
-    throw new Error(`Invalid SSE sequence number id: "${id}".`);
-  }
-  return parsed;
-}
-
-// ../../node_modules/.pnpm/truefoundry-gateway-sdk@0.3.1/node_modules/truefoundry-gateway-sdk/dist/esm/agents/Turn.mjs
-var __awaiter3 = function(thisArg, _arguments, P, generator) {
-  function adopt(value) {
-    return value instanceof P ? value : new P(function(resolve) {
-      resolve(value);
-    });
-  }
-  return new (P || (P = Promise))(function(resolve, reject) {
-    function fulfilled(value) {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    }
-    function rejected(value) {
-      try {
-        step(generator["throw"](value));
-      } catch (e) {
-        reject(e);
-      }
-    }
-    function step(result) {
-      result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
-    }
-    step((generator = generator.apply(thisArg, _arguments || [])).next());
-  });
-};
-var __classPrivateFieldSet = function(receiver, state, value, kind, f) {
-  if (kind === "m") throw new TypeError("Private method is not writable");
-  if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-  if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-  return kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value), value;
-};
-var __classPrivateFieldGet = function(receiver, state, kind, f) {
-  if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-  if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-  return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var __await2 = function(v) {
-  return this instanceof __await2 ? (this.v = v, this) : new __await2(v);
-};
-var __asyncValues2 = function(o) {
-  if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-  var m = o[Symbol.asyncIterator], i;
-  return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function() {
-    return this;
-  }, i);
-  function verb(n) {
-    i[n] = o[n] && function(v) {
-      return new Promise(function(resolve, reject) {
-        v = o[n](v), settle(resolve, reject, v.done, v.value);
-      });
-    };
-  }
-  function settle(resolve, reject, d, v) {
-    Promise.resolve(v).then(function(v2) {
-      resolve({ value: v2, done: d });
-    }, reject);
-  }
-};
-var __asyncGenerator2 = function(thisArg, _arguments, generator) {
-  if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-  var g = generator.apply(thisArg, _arguments || []), i, q = [];
-  return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function() {
-    return this;
-  }, i;
-  function awaitReturn(f) {
-    return function(v) {
-      return Promise.resolve(v).then(f, reject);
-    };
-  }
-  function verb(n, f) {
-    if (g[n]) {
-      i[n] = function(v) {
-        return new Promise(function(a, b) {
-          q.push([n, v, a, b]) > 1 || resume(n, v);
-        });
-      };
-      if (f) i[n] = f(i[n]);
-    }
-  }
-  function resume(n, v) {
-    try {
-      step(g[n](v));
-    } catch (e) {
-      settle(q[0][3], e);
-    }
-  }
-  function step(r) {
-    r.value instanceof __await2 ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r);
-  }
-  function fulfill(value) {
-    resume("next", value);
-  }
-  function reject(value) {
-    resume("throw", value);
-  }
-  function settle(f, v) {
-    if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]);
-  }
-};
-var _Turn_instances;
-var _Turn_client;
-var _Turn_state;
-var _Turn_applyEvent;
-var DEFAULT_POLL_INTERVAL_MS = 3e3;
-var MIN_POLL_INTERVAL_MS = 3e3;
-var Turn = class {
-  constructor(turn, session, client) {
-    _Turn_instances.add(this);
-    _Turn_client.set(this, void 0);
-    _Turn_state.set(this, void 0);
-    this.id = turn.id;
-    this.sessionId = turn.sessionId;
-    this.previousTurnId = turn.previousTurnId;
-    this.input = turn.input;
-    this.createdBySubject = turn.createdBySubject;
-    this.createdAt = turn.createdAt;
-    __classPrivateFieldSet(this, _Turn_state, turn.state, "f");
-    this.session = session;
-    __classPrivateFieldSet(this, _Turn_client, client, "f");
-  }
-  /**
-   * @returns {TrueFoundryGatewayApi.TurnState} Updated by `refresh()`, `stream()`, and `waitForCompletion()`.
-   */
-  get state() {
-    return __classPrivateFieldGet(this, _Turn_state, "f");
-  }
-  // Terminal states are listed explicitly (not `status !== "running"`) so a newly added
-  // non-terminal status keeps polling by default; new terminal states must be added here.
-  isTerminal(state) {
-    switch (state.status) {
-      case "done":
-      case "cancelled":
-      case "error":
-        return true;
-      default:
-        return false;
-    }
-  }
-  // Refetch from the server, update #state in place, and return self.
-  /**
-   * Refetch from the server, update state in-place and return self.
-   *
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {this} This turn with updated state.
-   */
-  refresh(requestOptions) {
-    return __awaiter3(this, void 0, void 0, function* () {
-      const response = yield __classPrivateFieldGet(this, _Turn_client, "f").agents.sessions.getTurn(this.sessionId, this.id, requestOptions);
-      __classPrivateFieldSet(this, _Turn_state, response.data.state, "f");
-      return this;
-    });
-  }
-  /**
-   * Poll getTurn until terminal.
-   *
-   * @param opts.pollIntervalMs - Poll interval ms while waiting. Minimum 3000.
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {TrueFoundryGatewayApi.TurnState} Terminal turn state.
-   */
-  waitForCompletion(opts, requestOptions) {
-    return __awaiter3(this, void 0, void 0, function* () {
-      var _a;
-      const pollIntervalMs = (_a = opts === null || opts === void 0 ? void 0 : opts.pollIntervalMs) !== null && _a !== void 0 ? _a : DEFAULT_POLL_INTERVAL_MS;
-      if (pollIntervalMs < MIN_POLL_INTERVAL_MS) {
-        throw new Error(`pollIntervalMs must be at least ${MIN_POLL_INTERVAL_MS}ms`);
-      }
-      while (!this.isTerminal(__classPrivateFieldGet(this, _Turn_state, "f"))) {
-        yield new Promise((r) => setTimeout(r, pollIntervalMs));
-        yield this.refresh(requestOptions);
-      }
-      return __classPrivateFieldGet(this, _Turn_state, "f");
-    });
-  }
-  // Reconnect to the turn's SSE; let the server decide what to stream (no client-side guard).
-  // Updates #state in place from any event that carries a state snapshot.
-  /**
-   * Reconnect to the turn's SSE. Updates state in-place from lifecycle events.
-   *
-   * @param opts.afterSequenceNumber - Sequence number to resume SSE subscription after.
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @yields {TurnStreamData} SSE stream items.
-   */
-  stream(opts, requestOptions) {
-    return __asyncGenerator2(this, arguments, function* stream_1() {
-      var _a, e_1, _b, _c;
-      const sse = yield __await2(__classPrivateFieldGet(this, _Turn_client, "f").agents.sessions.subscribeToTurn(this.sessionId, this.id, { afterSequenceNumber: opts === null || opts === void 0 ? void 0 : opts.afterSequenceNumber }, requestOptions));
-      try {
-        for (var _d = true, _e = __asyncValues2(sse.withMetadata()), _f; _f = yield __await2(_e.next()), _a = _f.done, !_a; _d = true) {
-          _c = _f.value;
-          _d = false;
-          const { data: event, id } = _c;
-          __classPrivateFieldGet(this, _Turn_instances, "m", _Turn_applyEvent).call(this, event);
-          yield yield __await2({ sequenceNumber: parseSequenceNumber(id), event });
-        }
-      } catch (e_1_1) {
-        e_1 = { error: e_1_1 };
-      } finally {
-        try {
-          if (!_d && !_a && (_b = _e.return)) yield __await2(_b.call(_e));
-        } finally {
-          if (e_1) throw e_1.error;
-        }
-      }
-    });
-  }
-  /**
-   * Cancel the running last turn for the session.
-   *
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {void}
-   */
-  cancel(requestOptions) {
-    return __awaiter3(this, void 0, void 0, function* () {
-      yield __classPrivateFieldGet(this, _Turn_client, "f").agents.sessions.cancel(this.sessionId, {}, requestOptions);
-    });
-  }
-  // Expose the autogen Fern Page as-is (it is already async-iterable); no re-wrapping.
-  /**
-   * Paginated turn events; use `stream()` for live SSE.
-   *
-   * @param opts.pageToken - Token from the previous response nextPageToken.
-   * @param opts.limit - Page size. Default 25.
-   * @param opts.order - Sort by creation time. Default `asc`.
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {Promise<core.Page<TrueFoundryGatewayApi.TurnEvent, TrueFoundryGatewayApi.ListEventsResponse>>} Paginated turn events.
-   */
-  listEvents(opts, requestOptions) {
-    return __classPrivateFieldGet(this, _Turn_client, "f").agents.sessions.listTurnEvents(this.sessionId, this.id, opts, requestOptions);
-  }
-};
-_Turn_client = /* @__PURE__ */ new WeakMap(), _Turn_state = /* @__PURE__ */ new WeakMap(), _Turn_instances = /* @__PURE__ */ new WeakSet(), _Turn_applyEvent = function _Turn_applyEvent2(event) {
-  if (event.type === "turn.created" || event.type === "turn.done")
-    __classPrivateFieldSet(this, _Turn_state, event.state, "f");
-};
-
-// ../../node_modules/.pnpm/truefoundry-gateway-sdk@0.3.1/node_modules/truefoundry-gateway-sdk/dist/esm/agents/PreparedTurn.mjs
-var __awaiter4 = function(thisArg, _arguments, P, generator) {
-  function adopt(value) {
-    return value instanceof P ? value : new P(function(resolve) {
-      resolve(value);
-    });
-  }
-  return new (P || (P = Promise))(function(resolve, reject) {
-    function fulfilled(value) {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    }
-    function rejected(value) {
-      try {
-        step(generator["throw"](value));
-      } catch (e) {
-        reject(e);
-      }
-    }
-    function step(result) {
-      result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
-    }
-    step((generator = generator.apply(thisArg, _arguments || [])).next());
-  });
-};
-var __classPrivateFieldSet2 = function(receiver, state, value, kind, f) {
-  if (kind === "m") throw new TypeError("Private method is not writable");
-  if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-  if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-  return kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value), value;
-};
-var __classPrivateFieldGet2 = function(receiver, state, kind, f) {
-  if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-  if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-  return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var __asyncValues3 = function(o) {
-  if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-  var m = o[Symbol.asyncIterator], i;
-  return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function() {
-    return this;
-  }, i);
-  function verb(n) {
-    i[n] = o[n] && function(v) {
-      return new Promise(function(resolve, reject) {
-        v = o[n](v), settle(resolve, reject, v.done, v.value);
-      });
-    };
-  }
-  function settle(resolve, reject, d, v) {
-    Promise.resolve(v).then(function(v2) {
-      resolve({ value: v2, done: d });
-    }, reject);
-  }
-};
-var __await3 = function(v) {
-  return this instanceof __await3 ? (this.v = v, this) : new __await3(v);
-};
-var __asyncDelegator = function(o) {
-  var i, p;
-  return i = {}, verb("next"), verb("throw", function(e) {
-    throw e;
-  }), verb("return"), i[Symbol.iterator] = function() {
-    return this;
-  }, i;
-  function verb(n, f) {
-    i[n] = o[n] ? function(v) {
-      return (p = !p) ? { value: __await3(o[n](v)), done: false } : f ? f(v) : v;
-    } : f;
-  }
-};
-var __asyncGenerator3 = function(thisArg, _arguments, generator) {
-  if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-  var g = generator.apply(thisArg, _arguments || []), i, q = [];
-  return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function() {
-    return this;
-  }, i;
-  function awaitReturn(f) {
-    return function(v) {
-      return Promise.resolve(v).then(f, reject);
-    };
-  }
-  function verb(n, f) {
-    if (g[n]) {
-      i[n] = function(v) {
-        return new Promise(function(a, b) {
-          q.push([n, v, a, b]) > 1 || resume(n, v);
-        });
-      };
-      if (f) i[n] = f(i[n]);
-    }
-  }
-  function resume(n, v) {
-    try {
-      step(g[n](v));
-    } catch (e) {
-      settle(q[0][3], e);
-    }
-  }
-  function step(r) {
-    r.value instanceof __await3 ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r);
-  }
-  function fulfill(value) {
-    resume("next", value);
-  }
-  function reject(value) {
-    resume("throw", value);
-  }
-  function settle(f, v) {
-    if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]);
-  }
-};
-var _PreparedTurn_client;
-var _PreparedTurn_input;
-var _PreparedTurn_previousTurnIdInput;
-var _PreparedTurn_start;
-var _PreparedTurn_turn;
-var PreparedTurn = class {
-  constructor(init, session, client) {
-    _PreparedTurn_client.set(this, void 0);
-    _PreparedTurn_input.set(this, void 0);
-    _PreparedTurn_previousTurnIdInput.set(this, void 0);
-    _PreparedTurn_start.set(this, void 0);
-    _PreparedTurn_turn.set(this, void 0);
-    this.session = session;
-    this.sessionId = session.id;
-    __classPrivateFieldSet2(this, _PreparedTurn_client, client, "f");
-    __classPrivateFieldSet2(this, _PreparedTurn_input, init.input, "f");
-    __classPrivateFieldSet2(this, _PreparedTurn_previousTurnIdInput, init.previousTurnId, "f");
-  }
-  // Remaining data getters delegate to the inner Turn (undefined until started).
-  /**
-   * @returns {string | undefined} Undefined until `execute()` starts the turn.
-   */
-  get id() {
-    var _a;
-    return (_a = __classPrivateFieldGet2(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.id;
-  }
-  /**
-   * @returns {string | undefined} Undefined until `execute()` starts the turn.
-   */
-  get previousTurnId() {
-    var _a;
-    return (_a = __classPrivateFieldGet2(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.previousTurnId;
-  }
-  /**
-   * @returns {TrueFoundryGatewayApi.TurnState | undefined} Undefined until `execute()` starts the turn.
-   */
-  get state() {
-    var _a;
-    return (_a = __classPrivateFieldGet2(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.state;
-  }
-  /**
-   * @returns {TrueFoundryGatewayApi.Subject | undefined} Undefined until `execute()` starts the turn.
-   */
-  get createdBySubject() {
-    var _a;
-    return (_a = __classPrivateFieldGet2(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.createdBySubject;
-  }
-  /**
-   * @returns {string | undefined} Undefined until `execute()` starts the turn.
-   */
-  get createdAt() {
-    var _a;
-    return (_a = __classPrivateFieldGet2(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.createdAt;
-  }
-  /**
-   * @returns {TrueFoundryGatewayApi.TurnInputItem[] | undefined} Staged input before execute; inner turn input after.
-   */
-  get input() {
-    var _a, _b;
-    return (_b = (_a = __classPrivateFieldGet2(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.input) !== null && _b !== void 0 ? _b : __classPrivateFieldGet2(this, _PreparedTurn_input, "f");
-  }
-  execute(opts, requestOptions) {
-    if (__classPrivateFieldGet2(this, _PreparedTurn_start, "f") != null)
-      throw new Error("Turn already started; use stream() / waitForCompletion().");
-    __classPrivateFieldSet2(this, _PreparedTurn_start, this.openCreateTurn(requestOptions), "f");
-    const { stream = true, pollIntervalMs } = opts !== null && opts !== void 0 ? opts : {};
-    return stream === false ? this.startAndWait(pollIntervalMs, requestOptions) : this.runStreaming();
-  }
-  // Post-execution behaviors. Each throws via mustGetTurn() until execute() has started the turn,
-  // then delegates to the inner Turn. stream() here is the re-subscribe path (subscribeToTurn).
-  /**
-   * Resubscribe via subscribeToTurn after `execute()`.
-   *
-   * @param opts.afterSequenceNumber - Sequence number to resume SSE subscription after.
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @yields {TurnStreamData} SSE stream items.
-   */
-  stream(opts, requestOptions) {
-    return __asyncGenerator3(this, arguments, function* stream_1() {
-      yield __await3(yield* __asyncDelegator(__asyncValues3(this.mustGetTurn().stream(opts, requestOptions))));
-    });
-  }
-  /**
-   * Refetch from the server, update state in-place and return self.
-   *
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {this} This prepared turn with updated state.
-   */
-  refresh(requestOptions) {
-    return __awaiter4(this, void 0, void 0, function* () {
-      yield this.mustGetTurn().refresh(requestOptions);
-      return this;
-    });
-  }
-  /**
-   * Poll getTurn until terminal.
-   *
-   * @param opts.pollIntervalMs - Poll interval ms while waiting. Minimum 3000.
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {TrueFoundryGatewayApi.TurnState} Terminal turn state.
-   */
-  waitForCompletion(opts, requestOptions) {
-    return __awaiter4(this, void 0, void 0, function* () {
-      return this.mustGetTurn().waitForCompletion(opts, requestOptions);
-    });
-  }
-  /**
-   * Cancel the running last turn for the session.
-   *
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {void}
-   */
-  cancel(requestOptions) {
-    return __awaiter4(this, void 0, void 0, function* () {
-      return this.mustGetTurn().cancel(requestOptions);
-    });
-  }
-  /**
-   * Paginated turn events; use `stream()` for live SSE.
-   *
-   * @param opts.pageToken - Token from the previous response nextPageToken.
-   * @param opts.limit - Page size. Default 25.
-   * @param opts.order - Sort by creation time. Default `asc`.
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {Promise<core.Page<TrueFoundryGatewayApi.TurnEvent, TrueFoundryGatewayApi.ListEventsResponse>>} Paginated turn events.
-   */
-  listEvents(opts, requestOptions) {
-    return this.mustGetTurn().listEvents(opts, requestOptions);
-  }
-  // execute(stream:true) path: consume the already-open createTurn SSE (#start), adopting the inner Turn on turn.created.
-  runStreaming() {
-    return __asyncGenerator3(this, arguments, function* runStreaming_1() {
-      yield __await3(yield* __asyncDelegator(__asyncValues3(this.consumeStream(yield __await3(__classPrivateFieldGet2(this, _PreparedTurn_start, "f"))))));
-    });
-  }
-  // execute(stream:false) path: drive the open createTurn SSE until turn.created mints the inner Turn, then poll to terminal.
-  startAndWait(pollIntervalMs, requestOptions) {
-    return __awaiter4(this, void 0, void 0, function* () {
-      const turn = yield this.createTurnIfNotExist();
-      return turn.waitForCompletion({ pollIntervalMs }, requestOptions);
-    });
-  }
-  // Consume an SSE stream, adopting the inner Turn from the first turn.created and yielding all events.
-  // Isolated so a future reconnect wrapper can re-open the stream (subscribeToTurn) on disconnect.
-  // NOTE: reconnect/resume is out of current scope.
-  consumeStream(sse) {
-    return __asyncGenerator3(this, arguments, function* consumeStream_1() {
-      var _a, e_1, _b, _c;
-      try {
-        for (var _d = true, _e = __asyncValues3(sse.withMetadata()), _f; _f = yield __await3(_e.next()), _a = _f.done, !_a; _d = true) {
-          _c = _f.value;
-          _d = false;
-          const { data: event, id } = _c;
-          if (event.type === "turn.created" && __classPrivateFieldGet2(this, _PreparedTurn_turn, "f") == null)
-            this.adoptTurn(event);
-          else if (__classPrivateFieldGet2(this, _PreparedTurn_turn, "f") != null && event.type === "turn.done")
-            this.replaceTurnState(event.state);
-          yield yield __await3({ sequenceNumber: parseSequenceNumber(id), event });
-        }
-      } catch (e_1_1) {
-        e_1 = { error: e_1_1 };
-      } finally {
-        try {
-          if (!_d && !_a && (_b = _e.return)) yield __await3(_b.call(_e));
-        } finally {
-          if (e_1) throw e_1.error;
-        }
-      }
-    });
-  }
-  // Returns the inner Turn or throws if execute() has not started it yet.
-  mustGetTurn() {
-    if (__classPrivateFieldGet2(this, _PreparedTurn_turn, "f") == null) {
-      throw new Error("Turn not started yet; call execute() first.");
-    }
-    return __classPrivateFieldGet2(this, _PreparedTurn_turn, "f");
-  }
-  // Drive the in-flight createTurn SSE (#start) only until the first turn.created has built the inner
-  // Turn, then break (which closes the underlying SSE via the generator's return()). Returns the Turn.
-  createTurnIfNotExist() {
-    return __awaiter4(this, void 0, void 0, function* () {
-      var _a, e_2, _b, _c;
-      if (__classPrivateFieldGet2(this, _PreparedTurn_turn, "f") == null) {
-        try {
-          for (var _d = true, _e = __asyncValues3(this.consumeStream(yield __classPrivateFieldGet2(this, _PreparedTurn_start, "f"))), _f; _f = yield _e.next(), _a = _f.done, !_a; _d = true) {
-            _c = _f.value;
-            _d = false;
-            const _event = _c;
-            if (__classPrivateFieldGet2(this, _PreparedTurn_turn, "f") != null)
-              break;
-          }
-        } catch (e_2_1) {
-          e_2 = { error: e_2_1 };
-        } finally {
-          try {
-            if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
-          } finally {
-            if (e_2) throw e_2.error;
-          }
-        }
-      }
-      return this.mustGetTurn();
-    });
-  }
-  // Open the createTurn SSE with the pending input/previousTurnId. Called synchronously by execute()
-  // so the POST is in flight (and #start latched) before execute returns.
-  openCreateTurn(requestOptions) {
-    return __classPrivateFieldGet2(this, _PreparedTurn_client, "f").agents.sessions.createTurn(this.sessionId, { input: __classPrivateFieldGet2(this, _PreparedTurn_input, "f"), previousTurnId: __classPrivateFieldGet2(this, _PreparedTurn_previousTurnIdInput, "f") }, requestOptions);
-  }
-  // Build the inner Turn directly from the turn.created event (no extra getTurn round trip).
-  // The TurnCreatedEvent member of the TurnStreamingEvent union carries everything Turn needs.
-  // input comes from the request we sent (this.#input), not the event.
-  adoptTurn(event) {
-    __classPrivateFieldSet2(this, _PreparedTurn_turn, new Turn({
-      id: event.turnId,
-      sessionId: this.sessionId,
-      previousTurnId: event.previousTurnId,
-      input: __classPrivateFieldGet2(this, _PreparedTurn_input, "f"),
-      state: event.state,
-      createdBySubject: event.createdBy,
-      createdAt: event.createdAt
-    }, this.session, __classPrivateFieldGet2(this, _PreparedTurn_client, "f")), "f");
-  }
-  // Replace the inner Turn with a fresh one carrying the new state. State changes are rare, so
-  // rebuilding via Turn's own constructor (rather than mutating it) keeps Turn the source of truth.
-  replaceTurnState(state) {
-    const turn = this.mustGetTurn();
-    __classPrivateFieldSet2(this, _PreparedTurn_turn, new Turn({
-      id: turn.id,
-      sessionId: turn.sessionId,
-      previousTurnId: turn.previousTurnId,
-      input: turn.input,
-      state,
-      createdBySubject: turn.createdBySubject,
-      createdAt: turn.createdAt
-    }, this.session, __classPrivateFieldGet2(this, _PreparedTurn_client, "f")), "f");
-  }
-};
-_PreparedTurn_client = /* @__PURE__ */ new WeakMap(), _PreparedTurn_input = /* @__PURE__ */ new WeakMap(), _PreparedTurn_previousTurnIdInput = /* @__PURE__ */ new WeakMap(), _PreparedTurn_start = /* @__PURE__ */ new WeakMap(), _PreparedTurn_turn = /* @__PURE__ */ new WeakMap();
-
-// ../../node_modules/.pnpm/truefoundry-gateway-sdk@0.3.1/node_modules/truefoundry-gateway-sdk/dist/esm/agents/AgentSession.mjs
-var __awaiter5 = function(thisArg, _arguments, P, generator) {
-  function adopt(value) {
-    return value instanceof P ? value : new P(function(resolve) {
-      resolve(value);
-    });
-  }
-  return new (P || (P = Promise))(function(resolve, reject) {
-    function fulfilled(value) {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    }
-    function rejected(value) {
-      try {
-        step(generator["throw"](value));
-      } catch (e) {
-        reject(e);
-      }
+      );
     }
-    function step(result) {
-      result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
+    if (responseThreadId != null) {
+      Object.assign(
+        custom,
+        toolResponseMessageCustom(
+          responseThreadId === ROOT_THREAD_ID ? ROOT_THREAD_ID : responseThreadId
+        )
+      );
     }
-    step((generator = generator.apply(thisArg, _arguments || [])).next());
-  });
-};
-var __classPrivateFieldSet3 = function(receiver, state, value, kind, f) {
-  if (kind === "m") throw new TypeError("Private method is not writable");
-  if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-  if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-  return kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value), value;
-};
-var __classPrivateFieldGet3 = function(receiver, state, kind, f) {
-  if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-  if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-  return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _AgentSession_client;
-var AgentSession = class {
-  constructor(session, client) {
-    _AgentSession_client.set(this, void 0);
-    this.id = session.id;
-    this.agentName = session.agentName;
-    this.title = session.title;
-    this.createdBySubject = session.createdBySubject;
-    this.createdAt = session.createdAt;
-    this.updatedAt = session.updatedAt;
-    __classPrivateFieldSet3(this, _AgentSession_client, client, "f");
-  }
-  /**
-   * Stage a turn locally; call `execute()` to start `createTurn`.
-   *
-   * @param opts.input - Turn input items passed to createTurn.
-   * @param opts.previousTurnId - Previous turn to chain from. Default `auto`.
-   * @returns {PreparedTurn} Staged turn.
-   */
-  prepareTurn(opts) {
-    return new PreparedTurn({ input: opts === null || opts === void 0 ? void 0 : opts.input, previousTurnId: opts === null || opts === void 0 ? void 0 : opts.previousTurnId }, this, __classPrivateFieldGet3(this, _AgentSession_client, "f"));
-  }
-  /**
-   * List turns in this session.
-   *
-   * @param opts.pageToken - Token from the previous response nextPageToken.
-   * @param opts.limit - Page size. Default 10.
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {core.Page<Turn, TrueFoundryGatewayApi.ListTurnsResponse>} Paginated turns.
-   */
-  listTurns(opts, requestOptions) {
-    return __awaiter5(this, void 0, void 0, function* () {
-      const client = __classPrivateFieldGet3(this, _AgentSession_client, "f");
-      const sessionId = this.id;
-      const page = yield client.agents.sessions.listTurns(sessionId, opts, requestOptions);
-      return new Page({
-        response: page.response,
-        rawResponse: page.rawResponse,
-        hasNextPage: (response) => !!(response === null || response === void 0 ? void 0 : response.pagination.nextPageToken),
-        getItems: (response) => {
-          var _a;
-          return ((_a = response === null || response === void 0 ? void 0 : response.data) !== null && _a !== void 0 ? _a : []).map((turn) => new Turn(turn, this, client));
-        },
-        loadPage: (response) => HttpResponsePromise.fromPromise(client.agents.sessions.listTurns(sessionId, Object.assign(Object.assign({}, opts), { pageToken: response === null || response === void 0 ? void 0 : response.pagination.nextPageToken }), requestOptions).then((nextPage) => ({ data: nextPage.response, rawResponse: nextPage.rawResponse })))
-      });
-    });
-  }
-  /**
-   * Fetch a turn by ID.
-   *
-   * @param opts.turnId - Unique identifier of the turn to fetch.
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {Turn} Turn data.
-   */
-  getTurn(opts, requestOptions) {
-    return __awaiter5(this, void 0, void 0, function* () {
-      const response = yield __classPrivateFieldGet3(this, _AgentSession_client, "f").agents.sessions.getTurn(this.id, opts.turnId, requestOptions);
-      return new Turn(response.data, this, __classPrivateFieldGet3(this, _AgentSession_client, "f"));
+    const ids = groupRootBaseline != null ? rootModelMessageIdsSinceBaseline(foldState, groupRootBaseline) : foldState.threads.get(ROOT_THREAD_ID)?.modelMessageIds ?? [];
+    yield withSandbox({
+      content: buildRootAssistantContentForIds(foldState, ids),
+      status: approvalThreadId != null ? toolApprovalStatus() : toolResponseStatus(),
+      metadata: { custom }
     });
+    return;
   }
-  /**
-   * Cancel the running last turn for the session.
-   *
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {void}
-   */
-  cancel(requestOptions) {
-    return __awaiter5(this, void 0, void 0, function* () {
-      yield __classPrivateFieldGet3(this, _AgentSession_client, "f").agents.sessions.cancel(this.id, {}, requestOptions);
-    });
+  if (sandboxId != null && !sandboxIdYielded) {
+    const ids = groupRootBaseline != null ? rootModelMessageIdsSinceBaseline(foldState, groupRootBaseline) : foldState.threads.get(ROOT_THREAD_ID)?.modelMessageIds ?? [];
+    yield withSandbox({ content: buildRootAssistantContentForIds(foldState, ids) });
   }
-  /**
-   * Paginated session events across turns (newest first); subscribe to a running turn for live events.
-   *
-   * @param opts.pageToken - Token from the previous response nextPageToken.
-   * @param opts.lastTurnId - Newest turn in the listing window (initial load only). Omit to use the session last turn.
-   * @param opts.limit - Page size. Default 100.
-   * @param requestOptions - Overrides client timeout, retries, abortSignal, headers, queryParams.
-   * @returns {Promise<core.Page<TrueFoundryGatewayApi.SessionEventItem, TrueFoundryGatewayApi.ListSessionEventsResponse>>} Paginated session events.
-   */
-  listEvents(opts, requestOptions) {
-    return __classPrivateFieldGet3(this, _AgentSession_client, "f").agents.sessions.listEvents(this.id, opts, requestOptions);
+}
+function turnStreamUpdateToAssistantMessage(turnId, update, existing, options) {
+  const id = existing?.role === "assistant" ? existing.id : `${turnId}-assistant`;
+  const fallbackCreatedAt = existing?.createdAt ?? /* @__PURE__ */ new Date();
+  return {
+    id,
+    role: "assistant",
+    content: update.content,
+    status: update.status ?? { type: "running" },
+    createdAt: resolveCreatedAt(id, fallbackCreatedAt, options),
+    metadata: {
+      unstable_state: null,
+      unstable_annotations: [],
+      unstable_data: [],
+      steps: [],
+      custom: update.metadata?.custom ?? {}
+    }
+  };
+}
+function repositoryItemsFromMessages(messages) {
+  const items = [];
+  let parentId = null;
+  for (const message of messages) {
+    items.push({ parentId, message });
+    parentId = message.id;
   }
-};
-_AgentSession_client = /* @__PURE__ */ new WeakMap();
+  return items;
+}
 
-// src/private/bindDraftAgentSession.ts
-var inflightByDraftId = /* @__PURE__ */ new Map();
-function getGatewayFromSessionClient(client) {
-  const internal = client;
+// src/private/getGatewayFromPrivateClient.ts
+function getGatewayFromPrivateClient(privateClient) {
+  const internal = privateClient;
   if (internal.client == null) {
-    throw new Error("AgentSessionClient is missing an internal gateway client.");
+    throw new Error("PrivateAgentSessionClient is missing an internal gateway client.");
   }
   return internal.client;
 }
-function draftToSessionRecord(draft) {
+
+// src/private/draftSessionBridge.ts
+var DRAFT_SESSION_LAST_UPDATED_AT_HEADER = "x-tfy-session-last-updated-at";
+function createDraftSessionBridge(privateClient) {
+  return {
+    async getDraftAgentSpec(draftSessionId) {
+      const draft = await privateClient.getDraftSession({ draftSessionId });
+      return draft.agentSpec;
+    },
+    async syncAgentSpec(draftSessionId, agentSpec) {
+      const gateway = getGatewayFromPrivateClient(privateClient);
+      const response = await gateway.agents.private.draftSessions.update(
+        draftSessionId,
+        { agentSpec }
+      );
+      return response.data.updatedAt;
+    }
+  };
+}
+
+// src/private/agentSpec.ts
+function mergeAgentSpec(base, update) {
+  const { model: modelUpdate, ...rest } = update;
+  const next = {
+    ...base,
+    ...rest
+  };
+  if (modelUpdate != null) {
+    next.model = {
+      ...base.model,
+      ...modelUpdate,
+      name: modelUpdate.name ?? base.model.name,
+      params: modelUpdate.params != null ? { ...base.model.params, ...modelUpdate.params } : base.model.params
+    };
+  }
+  return next;
+}
+function draftSessionTitle(draft) {
+  return draft.title ?? draft.agentSpec.model.name;
+}
+
+// src/sessionListStartTimestamp.ts
+function sessionListStartTimestamp() {
+  const start = /* @__PURE__ */ new Date();
+  start.setFullYear(start.getFullYear() - 1);
+  return start.toISOString();
+}
+
+// src/private/truefoundryDraftThreadListAdapter.ts
+var THREAD_LIST_PAGE_SIZE = 20;
+function createTrueFoundryDraftThreadListAdapter(options) {
+  const { privateClient, defaultAgentSpec, getAgentSpec } = options;
   return {
-    id: draft.id,
-    agentName: draft.agentName ?? "",
-    title: draft.title,
-    createdBySubject: draft.createdBySubject,
-    createdAt: draft.createdAt,
-    updatedAt: draft.updatedAt
+    async list({ after } = {}) {
+      const page = await privateClient.listDraftSessions({
+        limit: THREAD_LIST_PAGE_SIZE,
+        pageToken: after,
+        startTimestamp: sessionListStartTimestamp()
+      });
+      const threads = page.data.map((draft) => ({
+        status: "regular",
+        remoteId: draft.id,
+        title: draftSessionTitle(draft),
+        lastMessageAt: new Date(draft.updatedAt)
+      }));
+      return {
+        threads,
+        nextCursor: page.response.pagination.nextPageToken ?? void 0
+      };
+    },
+    async initialize(_threadId) {
+      const draft = await privateClient.createDraftSession({
+        agentSpec: getAgentSpec?.() ?? defaultAgentSpec
+      });
+      return { remoteId: draft.id, externalId: void 0 };
+    },
+    async fetch(remoteId) {
+      const draft = await privateClient.getDraftSession({
+        draftSessionId: remoteId
+      });
+      return {
+        status: "regular",
+        remoteId: draft.id,
+        title: draftSessionTitle(draft),
+        lastMessageAt: new Date(draft.updatedAt)
+      };
+    },
+    async rename() {
+    },
+    async archive() {
+    },
+    async unarchive() {
+    },
+    async delete() {
+    },
+    async generateTitle() {
+      return new ReadableStream();
+    }
   };
 }
-async function bindDraftAgentSession(client, gateway, draftSessionId) {
+
+// src/truefoundryExtras.ts
+import { createRuntimeExtras } from "@assistant-ui/core/internal";
+var trueFoundryExtras = createRuntimeExtras(
+  "useTrueFoundryAgentRuntime"
+);
+var EMPTY_DRAFT_EXTRAS = {
+  agentSpec: null,
+  draftSessionId: void 0,
+  isSpecSyncing: false,
+  specError: null,
+  updateAgentSpec: () => {
+    throw new Error("Draft agent extras are only available in draft mode.");
+  }
+};
+
+// src/private/bindDraftAgentSession.ts
+var inflightByDraftId = /* @__PURE__ */ new Map();
+async function bindDraftAgentSession(privateClient, draftSessionId) {
   let inflight = inflightByDraftId.get(draftSessionId);
   if (inflight == null) {
-    inflight = (async () => {
-      const response = await gateway.agents.private.draftSessions.get(draftSessionId);
-      return new AgentSession(
-        draftToSessionRecord(response.data),
-        getGatewayFromSessionClient(client)
-      );
-    })().finally(() => {
+    inflight = privateClient.getDraftSession({ draftSessionId }).then((draft) => draft).finally(() => {
       if (inflightByDraftId.get(draftSessionId) === inflight) {
         inflightByDraftId.delete(draftSessionId);
       }
@@ -3278,8 +2468,8 @@ async function bindDraftAgentSession(client, gateway, draftSessionId) {
 // src/sessions.ts
 var inflightBySessionId = /* @__PURE__ */ new Map();
 function getSession(client, sessionId, options) {
-  if (options?.draftGateway != null) {
-    return bindDraftAgentSession(client, options.draftGateway, sessionId);
+  if (options?.privateClient != null) {
+    return bindDraftAgentSession(options.privateClient, sessionId);
   }
   let inflight = inflightBySessionId.get(sessionId);
   if (inflight == null) {
@@ -3360,15 +2550,15 @@ function resolveTrueFoundryAgentConfig(options) {
 }
 function resolveTrueFoundryAgentRuntimeOptions(options) {
   const agent = resolveTrueFoundryAgentConfig(options);
-  if (agent.mode === "draft" && options.gateway == null) {
+  if (agent.mode === "draft" && options.privateClient == null) {
     throw new Error(
-      "Draft agent mode requires a `gateway` TrueFoundryGateway client."
+      "Draft agent mode requires a `privateClient` PrivateAgentSessionClient."
     );
   }
   return {
     ...options,
     agent,
-    gateway: options.gateway
+    privateClient: options.privateClient
   };
 }
 
@@ -3392,6 +2582,29 @@ function useDraftAgentSpec({
   const syncGenerationRef = useRef(0);
   const loadedDraftIdRef = useRef(void 0);
   const localDirtyRef = useRef(false);
+  const lastUpdatedAtRef = useRef(void 0);
+  const pendingFlushRef = useRef(void 0);
+  const inFlightFlushRef = useRef(void 0);
+  const activeDraftIdRef = useRef(draftSessionId);
+  useEffect(() => {
+    const previousDraftId = activeDraftIdRef.current;
+    if (previousDraftId === draftSessionId) {
+      return;
+    }
+    activeDraftIdRef.current = draftSessionId;
+    syncGenerationRef.current++;
+    if (syncTimeoutRef.current != null) {
+      clearTimeout(syncTimeoutRef.current);
+      syncTimeoutRef.current = void 0;
+    }
+    pendingFlushRef.current = void 0;
+    inFlightFlushRef.current = void 0;
+    lastUpdatedAtRef.current = void 0;
+    setIsSpecSyncing(false);
+    if (previousDraftId != null) {
+      localDirtyRef.current = false;
+    }
+  }, [draftSessionId]);
   useEffect(() => {
     if (!enabled || draftBridge == null) {
       return;
@@ -3440,10 +2653,11 @@ function useDraftAgentSpec({
       }
       setIsSpecSyncing(true);
       try {
-        await draftBridge.syncAgentSpec(draftId, spec);
+        const updatedAt = await draftBridge.syncAgentSpec(draftId, spec);
         if (generation !== syncGenerationRef.current) {
           return;
         }
+        lastUpdatedAtRef.current = updatedAt || (/* @__PURE__ */ new Date()).toISOString();
         setSpecError(null);
         onAgentSpecChange?.(spec);
       } catch (error) {
@@ -3465,14 +2679,47 @@ function useDraftAgentSpec({
         clearTimeout(syncTimeoutRef.current);
       }
       const generation = ++syncGenerationRef.current;
+      const flush = () => {
+        pendingFlushRef.current = void 0;
+        syncTimeoutRef.current = void 0;
+        const promise = flushSpecSync(draftId, spec, generation).finally(() => {
+          if (inFlightFlushRef.current === promise) {
+            inFlightFlushRef.current = void 0;
+          }
+        });
+        inFlightFlushRef.current = promise;
+        return promise;
+      };
+      pendingFlushRef.current = flush;
       syncTimeoutRef.current = setTimeout(() => {
-        void flushSpecSync(draftId, spec, generation);
+        void flush();
       }, SPEC_SYNC_DEBOUNCE_MS);
     },
     [flushSpecSync]
   );
   const scheduleSpecSyncRef = useRef(scheduleSpecSync);
   scheduleSpecSyncRef.current = scheduleSpecSync;
+  const flushPendingSpecSyncNow = useCallback(async () => {
+    if (syncTimeoutRef.current != null) {
+      clearTimeout(syncTimeoutRef.current);
+      syncTimeoutRef.current = void 0;
+    }
+    const pending = pendingFlushRef.current;
+    if (pending != null) {
+      pendingFlushRef.current = void 0;
+      await pending();
+      return;
+    }
+    if (inFlightFlushRef.current != null) {
+      await inFlightFlushRef.current;
+    }
+  }, []);
+  const takeTurnHeaderTimestamp = useCallback(async () => {
+    await flushPendingSpecSyncNow();
+    const updatedAt = lastUpdatedAtRef.current;
+    lastUpdatedAtRef.current = void 0;
+    return updatedAt;
+  }, [flushPendingSpecSyncNow]);
   useEffect(
     () => () => {
       if (syncTimeoutRef.current != null) {
@@ -3501,7 +2748,8 @@ function useDraftAgentSpec({
       draftSessionId: enabled ? draftSessionId : void 0,
       isSpecSyncing: enabled ? isSpecSyncing : false,
       specError: enabled ? specError : null,
-      updateAgentSpec
+      updateAgentSpec,
+      takeTurnHeaderTimestamp
     }),
     [
       agentSpec,
@@ -3509,6 +2757,7 @@ function useDraftAgentSpec({
       enabled,
       isSpecSyncing,
       specError,
+      takeTurnHeaderTimestamp,
       updateAgentSpec
     ]
   );
@@ -3521,7 +2770,7 @@ import { useCallback as useCallback2, useEffect as useEffect2, useMemo as useMem
 // src/loadSessionSnapshot.ts
 var inflightBySessionId2 = /* @__PURE__ */ new Map();
 function loadSessionSnapshot(client, sessionId, sessionOptions, onProgress) {
-  const cacheKey = sessionOptions?.draftGateway != null ? `draft:${sessionId}` : sessionId;
+  const cacheKey = sessionOptions?.privateClient != null ? `draft:${sessionId}` : sessionId;
   let inflight = inflightBySessionId2.get(cacheKey);
   if (inflight == null) {
     inflight = getSession(client, sessionId, sessionOptions).then(
@@ -3593,7 +2842,13 @@ async function* streamTurnContent(session, foldState, options, abortSignal, grou
   }
   try {
     yield* streamTurnEvents(
-      turn.execute({ stream: true }, { abortSignal }),
+      turn.execute(
+        { stream: true },
+        {
+          abortSignal,
+          ...options.headers != null ? { headers: options.headers } : {}
+        }
+      ),
       foldState,
       groupRootBaseline
     );
@@ -3745,16 +3000,6 @@ async function resolveActiveSessionId(remoteId, resolveConversationSessionId) {
   }
   return remoteId;
 }
-function findTurnIndex(snapshot, turnId) {
-  const committedIndex = snapshot.turns.findIndex((turn) => turn.id === turnId);
-  if (committedIndex !== -1) {
-    return committedIndex;
-  }
-  if (snapshot.pendingUser?.turnId === turnId) {
-    return snapshot.turns.length;
-  }
-  throw new Error(`Turn ${turnId} not found in session snapshot`);
-}
 function resolveTurnInput(snapshot, turnId) {
   const turnRecord = snapshot.turns.find((turn) => turn.id === turnId);
   if (turnRecord?.input != null) {
@@ -3773,24 +3018,29 @@ function useTrueFoundryAgentMessages({
   onError,
   initializeSession,
   resolveConversationSessionId,
-  draftGateway
+  privateClient,
+  getTurnHeaders
 }) {
   const sessionOptions = useMemo2(
-    () => draftGateway != null ? { draftGateway } : void 0,
-    [draftGateway]
+    () => privateClient != null ? { privateClient } : void 0,
+    [privateClient]
   );
   const [snapshot, setSnapshot] = useState2(createEmptySessionSnapshot);
   const [isRunning, setIsRunning] = useState2(false);
   const [isLoading, setIsLoading] = useState2(false);
+  const [isLoadingOlderHistory, setIsLoadingOlderHistory] = useState2(false);
   const [loadRetryTrigger, setLoadRetryTrigger] = useState2(0);
   const snapshotRef = useRef2(snapshot);
   snapshotRef.current = snapshot;
+  const loadOlderInflightRef = useRef2(null);
   const onErrorRef = useRef2(onError);
   onErrorRef.current = onError;
   const resolveConversationSessionIdRef = useRef2(resolveConversationSessionId);
   resolveConversationSessionIdRef.current = resolveConversationSessionId;
   const initializeSessionRef = useRef2(initializeSession);
   initializeSessionRef.current = initializeSession;
+  const getTurnHeadersRef = useRef2(getTurnHeaders);
+  getTurnHeadersRef.current = getTurnHeaders;
   const createdAtByMessageIdRef = useRef2(/* @__PURE__ */ new Map());
   const abortControllerRef = useRef2(null);
   const activeRunRef = useRef2(null);
@@ -3920,9 +3170,11 @@ function useTrueFoundryAgentMessages({
     const generation = ++loadGenerationRef.current;
     ++streamGenerationRef.current;
     abortControllerRef.current?.abort();
+    loadOlderInflightRef.current = null;
     createdAtByMessageIdRef.current = /* @__PURE__ */ new Map();
     setSnapshot(createEmptySessionSnapshot());
     setIsLoading(true);
+    setIsLoadingOlderHistory(false);
     try {
       const conversationSessionId = await resolveActiveSessionId(
         sessionId,
@@ -3990,6 +3242,8 @@ function useTrueFoundryAgentMessages({
         resolveConversationSessionIdRef.current
       );
       const session = await getSession(client, conversationSessionId, sessionOptions);
+      const turnHeaders = await getTurnHeadersRef.current?.();
+      const streamHeaders = turnHeaders != null ? { headers: turnHeaders } : {};
       const isContinuation = "inputs" in options || "resumeMcpAuth" in options && options.resumeMcpAuth === true;
       const continuationTurnId = snapshotRef.current.activeStream?.turnId;
       const turnId = isContinuation && continuationTurnId != null ? continuationTurnId : generateId();
@@ -4048,7 +3302,7 @@ function useTrueFoundryAgentMessages({
             return streamTurnContent(
               session,
               snapshotRef.current.fold,
-              { inputs: options.inputs },
+              { inputs: options.inputs, ...streamHeaders },
               signal,
               groupRootBaseline
             );
@@ -4057,7 +3311,7 @@ function useTrueFoundryAgentMessages({
             return streamTurnContent(
               session,
               snapshotRef.current.fold,
-              { resumeMcpAuth: true },
+              { resumeMcpAuth: true, ...streamHeaders },
               signal,
               groupRootBaseline
             );
@@ -4067,7 +3321,8 @@ function useTrueFoundryAgentMessages({
             snapshotRef.current.fold,
             {
               userMessage: options.userMessage,
-              ...options.previousTurnId !== void 0 ? { previousTurnId: options.previousTurnId } : {}
+              ...options.previousTurnId !== void 0 ? { previousTurnId: options.previousTurnId } : {},
+              ...streamHeaders
             },
             signal,
             groupRootBaseline
@@ -4171,20 +3426,19 @@ function useTrueFoundryAgentMessages({
       }
       const committed = commitActiveStream(snapshotRef.current);
       setSnapshot(committed);
-      const turnIndex = findTurnIndex(committed, turnId);
       await cancel();
       const conversationSessionId = await resolveActiveSessionId(
         activeSessionId,
         resolveConversationSessionIdRef.current
       );
       const session = await getSession(client, conversationSessionId, sessionOptions);
-      const previousTurnId = await resolveGatewayBranchPreviousTurnId(
+      const previousTurnId = await resolveGatewayBranchPreviousTurnIdForTurn(
         session,
-        turnIndex
+        turnId
       );
-      const rewound = await buildSnapshotBeforeTurnIndex(
+      const rewound = await buildSnapshotBeforeTurn(
         session,
-        turnIndex,
+        turnId,
         listEventsConcurrency
       );
       createdAtByMessageIdRef.current = /* @__PURE__ */ new Map();
@@ -4235,10 +3489,64 @@ function useTrueFoundryAgentMessages({
   const retryLoad = useCallback2(() => {
     setLoadRetryTrigger((n) => n + 1);
   }, []);
+  const hasOlderHistory = snapshot.historyPagination?.hasOlder === true;
+  const loadOlderHistory = useCallback2(async () => {
+    if (sessionId == null || isMain === false) {
+      return;
+    }
+    if (loadOlderInflightRef.current != null) {
+      return loadOlderInflightRef.current;
+    }
+    const current = snapshotRef.current;
+    if (current.historyPagination?.hasOlder !== true) {
+      return;
+    }
+    if (current.historyPagination.olderPageToken == null) {
+      return;
+    }
+    const generation = loadGenerationRef.current;
+    setIsLoadingOlderHistory(true);
+    const run = (async () => {
+      try {
+        const conversationSessionId = await resolveActiveSessionId(
+          sessionId,
+          resolveConversationSessionIdRef.current
+        );
+        const session = await getSession(
+          client,
+          conversationSessionId,
+          sessionOptions
+        );
+        const next = await prependOlderSessionHistory(
+          session,
+          snapshotRef.current
+        );
+        if (generation !== loadGenerationRef.current) {
+          return;
+        }
+        setSnapshot(next);
+      } catch (error) {
+        if (generation === loadGenerationRef.current) {
+          onErrorRef.current?.(error);
+        }
+        throw error;
+      } finally {
+        if (generation === loadGenerationRef.current) {
+          setIsLoadingOlderHistory(false);
+        }
+        loadOlderInflightRef.current = null;
+      }
+    })();
+    loadOlderInflightRef.current = run;
+    return run;
+  }, [client, isMain, sessionId, sessionOptions]);
   return {
     messages,
     isRunning,
     isLoading,
+    isLoadingOlderHistory,
+    hasOlderHistory,
+    loadOlderHistory,
     retryLoad,
     sendTurn,
     cancel,
@@ -4256,14 +3564,14 @@ function useTrueFoundryAgentRuntimeImpl(options, pendingAgentSpecRef) {
   const {
     client,
     agent,
-    gateway,
+    privateClient,
     adapters,
     onError,
     listEventsConcurrency,
     ...sharedOptions
   } = options;
   const draftBridgeRef = useRef3(
-    agent.mode === "draft" && gateway != null ? createDraftSessionBridge(gateway) : null
+    agent.mode === "draft" && privateClient != null ? createDraftSessionBridge(privateClient) : null
   );
   const draftSessionId = useAuiState(
     (state) => agent.mode === "draft" ? state.threadListItem.remoteId ?? void 0 : void 0
@@ -4279,6 +3587,18 @@ function useTrueFoundryAgentRuntimeImpl(options, pendingAgentSpecRef) {
     onAgentSpecChange: agent.mode === "draft" ? agent.onAgentSpecChange : void 0,
     onError
   });
+  const takeTurnHeaderTimestampRef = useRef3(draftSpec.takeTurnHeaderTimestamp);
+  takeTurnHeaderTimestampRef.current = draftSpec.takeTurnHeaderTimestamp;
+  const getTurnHeaders = useCallback3(async () => {
+    if (agent.mode !== "draft") {
+      return void 0;
+    }
+    const updatedAt = await takeTurnHeaderTimestampRef.current();
+    if (updatedAt == null) {
+      return void 0;
+    }
+    return { [DRAFT_SESSION_LAST_UPDATED_AT_HEADER]: updatedAt };
+  }, [agent.mode]);
   const aui = useAui();
   const initializeSession = useCallback3(
     () => aui.threadListItem().initialize(),
@@ -4290,6 +3610,9 @@ function useTrueFoundryAgentRuntimeImpl(options, pendingAgentSpecRef) {
     messages,
     isRunning,
     isLoading,
+    isLoadingOlderHistory,
+    hasOlderHistory,
+    loadOlderHistory,
     sendTurn,
     cancel,
     respondToToolApproval,
@@ -4305,7 +3628,8 @@ function useTrueFoundryAgentRuntimeImpl(options, pendingAgentSpecRef) {
     listEventsConcurrency,
     onError,
     initializeSession,
-    draftGateway: agent.mode === "draft" ? gateway : void 0
+    privateClient: agent.mode === "draft" ? privateClient : void 0,
+    getTurnHeaders: agent.mode === "draft" ? getTurnHeaders : void 0
   });
   if (agent.mode === "draft" && draftSpec.agentSpec != null) {
     pendingAgentSpecRef.current = draftSpec.agentSpec;
@@ -4326,9 +3650,9 @@ function useTrueFoundryAgentRuntimeImpl(options, pendingAgentSpecRef) {
   );
   const downloadSandboxFile = useCallback3(
     async (path) => {
-      if (gateway == null) {
+      if (privateClient == null) {
         const error = new Error(
-          "Downloading a sandbox file requires a `gateway` TrueFoundryGateway client."
+          "Downloading a sandbox file requires a `privateClient` PrivateAgentSessionClient."
         );
         onError?.(error);
         throw error;
@@ -4338,10 +3662,11 @@ function useTrueFoundryAgentRuntimeImpl(options, pendingAgentSpecRef) {
         onError?.(error);
         throw error;
       }
+      const gateway = getGatewayFromPrivateClient(privateClient);
       const response = await gateway.agents.downloadSandboxFile(sandboxId, { path });
       return await response.blob();
     },
-    [gateway, sandboxId, onError]
+    [privateClient, sandboxId, onError]
   );
   const draftExtras = useMemo3(() => {
     if (agent.mode !== "draft") {
@@ -4374,6 +3699,9 @@ function useTrueFoundryAgentRuntimeImpl(options, pendingAgentSpecRef) {
         onError?.(error);
       }),
       reload: retryLoad,
+      hasOlderHistory,
+      isLoadingOlderHistory,
+      loadOlderHistory,
       draft: draftExtras
     }),
     unstable_enableToolInvocations: true,
@@ -4423,7 +3751,7 @@ function useTrueFoundryAgentRuntimeImpl(options, pendingAgentSpecRef) {
 }
 function useTrueFoundryAgentRuntime(options) {
   const resolved = resolveTrueFoundryAgentRuntimeOptions(options);
-  const { client, agent, gateway } = resolved;
+  const { client, agent, privateClient } = resolved;
   const pendingAgentSpecRef = useRef3(
     agent.mode === "draft" ? agent.defaultAgentSpec : void 0
   );
@@ -4431,14 +3759,14 @@ function useTrueFoundryAgentRuntime(options) {
   const namedAgentName = agent.mode === "named" ? agent.agentName : void 0;
   const threadListAdapter = useMemo3(() => {
     if (agentMode === "draft") {
-      if (gateway == null) {
+      if (privateClient == null) {
         throw new Error(
-          "Draft agent mode requires a `gateway` TrueFoundryGateway client."
+          "Draft agent mode requires a `privateClient` PrivateAgentSessionClient."
         );
       }
       const draftAgent = agent;
       return createTrueFoundryDraftThreadListAdapter({
-        gateway,
+        privateClient,
         defaultAgentSpec: draftAgent.defaultAgentSpec,
         getAgentSpec: () => pendingAgentSpecRef.current ?? draftAgent.defaultAgentSpec
       });
@@ -4447,7 +3775,7 @@ function useTrueFoundryAgentRuntime(options) {
       client,
       agentName: namedAgentName
     });
-  }, [agentMode, namedAgentName, client, gateway]);
+  }, [agentMode, namedAgentName, client, privateClient]);
   return useRemoteThreadListRuntime({
     allowNesting: true,
     adapter: threadListAdapter,
@@ -4458,6 +3786,67 @@ function useTrueFoundryAgentRuntime(options) {
   });
 }
 
+// src/truefoundryOwnedSessionsThreadListAdapter.ts
+var THREAD_LIST_PAGE_SIZE3 = 20;
+function ownedSessionTitle(session) {
+  if (session.type === "session/draft") {
+    return draftSessionTitle(session);
+  }
+  return session.title ?? session.agentName;
+}
+function createTrueFoundryOwnedSessionsThreadListAdapter(options) {
+  const { privateClient } = options;
+  return {
+    async list({ after } = {}) {
+      const page = await privateClient.listOwnedSessions({
+        limit: THREAD_LIST_PAGE_SIZE3,
+        pageToken: after,
+        startTimestamp: sessionListStartTimestamp()
+      });
+      const threads = page.data.map((session) => ({
+        status: "regular",
+        remoteId: session.id,
+        title: ownedSessionTitle(session),
+        lastMessageAt: new Date(session.updatedAt)
+      }));
+      return {
+        threads,
+        nextCursor: page.response.pagination.nextPageToken ?? void 0
+      };
+    },
+    async initialize() {
+      throw new Error(
+        "Owned sessions history adapter is read-only; create sessions via a named or draft runtime."
+      );
+    },
+    async fetch(remoteId) {
+      const draft = await privateClient.getDraftSession({
+        draftSessionId: remoteId
+      });
+      return {
+        status: "regular",
+        remoteId: draft.id,
+        title: draftSessionTitle(draft),
+        lastMessageAt: new Date(draft.updatedAt)
+      };
+    },
+    async rename() {
+    },
+    async archive() {
+    },
+    async unarchive() {
+    },
+    async delete() {
+    },
+    async generateTitle() {
+      return new ReadableStream();
+    }
+  };
+}
+
+// src/index.ts
+import { PrivateAgentSessionClient } from "truefoundry-gateway-sdk/agents/private";
+
 // src/hooks.ts
 import { useMemo as useMemo4 } from "react";
 import { useAui as useAui2 } from "@assistant-ui/store";
@@ -4522,6 +3911,19 @@ var useTrueFoundryReload = () => {
   const aui = useAui2();
   return () => trueFoundryExtras.get(aui).reload();
 };
+var useTrueFoundryHistoryPagination = () => {
+  const extras = trueFoundryExtras.use((e) => e, void 0);
+  return useMemo4(
+    () => ({
+      hasOlderHistory: extras?.hasOlderHistory ?? false,
+      isLoadingOlderHistory: extras?.isLoadingOlderHistory ?? false,
+      loadOlderHistory: extras?.loadOlderHistory ?? (async () => {
+        throw new Error("TrueFoundry runtime is not ready yet");
+      })
+    }),
+    [extras]
+  );
+};
 var useTrueFoundryResetFromTurn = () => {
   const aui = useAui2();
   return (turnId) => trueFoundryExtras.get(aui).resetFromTurn(turnId);
@@ -4589,6 +3991,7 @@ var trueFoundryAttachmentAdapter = {
   }
 };
 export {
+  PrivateAgentSessionClient,
   ROOT_THREAD_ID,
   TOOL_RESPONSE_THREAD_ID_CUSTOM_KEY,
   buildEditedUserMessageContent,
@@ -4600,6 +4003,7 @@ export {
   convertTurnsToThreadMessages,
   createDraftSessionBridge,
   createTrueFoundryDraftThreadListAdapter,
+  createTrueFoundryOwnedSessionsThreadListAdapter,
   createTrueFoundryThreadListAdapter,
   draftSessionTitle,
   findPausedAssistantMessage,
@@ -4619,6 +4023,7 @@ export {
   useTrueFoundryApprovals,
   useTrueFoundryCancel,
   useTrueFoundryDownloadSandboxFile,
+  useTrueFoundryHistoryPagination,
   useTrueFoundryMcpAuth,
   useTrueFoundryReload,
   useTrueFoundryResetFromTurn,