@truefoundry/assistant-ui-runtime 0.1.4 → 0.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truefoundry/assistant-ui-runtime",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "TrueFoundry Gateway agent runtime adapter for assistant-ui",
   "license": "Apache-2.0",
   "repository": {
@@ -50,7 +50,7 @@
   "peerDependencies": {
     "@types/react": "*",
     "react": "^18 || ^19",
-    "truefoundry-gateway-sdk": "^0.4.0-rc.1"
+    "truefoundry-gateway-sdk": "^0.4.0-rc.5"
   },
   "peerDependenciesMeta": {
     "@types/react": {
@@ -63,7 +63,7 @@
     "@types/react": "^19.2.17",
     "jsdom": "^29.1.1",
     "react": "^19.2.4",
-    "truefoundry-gateway-sdk": "0.4.0-rc.1",
+    "truefoundry-gateway-sdk": "0.4.0-rc.5",
     "tsup": "^8.5.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.9"

package/src/buildEditedUserMessageContent.test.ts

@@ -12,11 +12,11 @@ describe("user message branch helpers", () => {
         expect(parseTurnIdFromMessageId("turn-abc-user")).toBe("turn-abc");
     });
 
-    it("resolveBranchPreviousTurnId returns null for the first turn", () => {
+    it("resolveBranchPreviousTurnId returns \"none\" for the first turn", () => {
         const turns: SessionTurnRecord[] = [
             { id: "a", createdAt: "", state: { status: "done", requiredActions: [], completedAt: "" } },
         ];
-        expect(resolveBranchPreviousTurnId(turns, "a")).toBeNull();
+        expect(resolveBranchPreviousTurnId(turns, "a")).toBe("none");
     });
 
     it("resolveBranchPreviousTurnId returns the prior turn id", () => {

package/src/convertTurnMessages.ts

@@ -1276,24 +1276,24 @@ export async function buildSnapshotBeforeTurnIndex(
     return snapshot;
 }
 
-/** Gateway turn id to branch from when resubmitting at `turnIndex` (null for first turn). */
+/** Gateway turn id to branch from when resubmitting at `turnIndex` (`"none"` for first turn). */
 export async function resolveGatewayBranchPreviousTurnId(
     session: AgentSession,
     turnIndex: number,
     orderedTurns?: Turn[],
-): Promise<string | null> {
+): Promise<string> {
     if (turnIndex <= 0) {
-        return null;
+        return "none";
     }
     const turns = orderedTurns ?? (await listSessionTurnsOrdered(session));
-    return turns[turnIndex - 1]?.id ?? null;
+    return turns[turnIndex - 1]?.id ?? "none";
 }
 
 /** Resolves `previousTurnId` by turn id so partial history windows stay correct. */
 export async function resolveGatewayBranchPreviousTurnIdForTurn(
     session: AgentSession,
     turnId: string,
-): Promise<string | null> {
+): Promise<string> {
     const turns = await listSessionTurnsOrdered(session);
     const turnIndex = turns.findIndex((turn) => turn.id === turnId);
     return resolveGatewayBranchPreviousTurnId(session, turnIndex, turns);
@@ -1456,14 +1456,14 @@ export function parseTurnIdFromMessageId(messageId: string): string {
     return messageId.replace(/-user$/, "");
 }
 
-/** Parent turn id for branching before `turnId`; `null` when editing the first turn. */
+/** Parent turn id for branching before `turnId`; `"none"` when editing the first turn. */
 export function resolveBranchPreviousTurnId(
     turns: readonly SessionTurnRecord[],
     turnId: string,
-): string | null {
+): string {
     const turnIndex = turns.findIndex((turn) => turn.id === turnId);
     if (turnIndex <= 0) {
-        return null;
+        return "none";
     }
     return turns[turnIndex - 1]!.id;
 }

package/src/streamTurn.test.ts

@@ -150,7 +150,7 @@ describe("streamTurn", () => {
             });
         });
 
-        it("forwards previousTurnId null when branching from root", async () => {
+        it("forwards previousTurnId \"none\" when branching from root", async () => {
             const execute = vi.fn(() => (async function* () {})());
             const prepareTurn = vi.fn(() => ({ execute }));
             const session = {
@@ -162,14 +162,14 @@ describe("streamTurn", () => {
                 streamTurnContent(
                     session,
                     new PeerThreadFoldState(),
-                    { userMessage: "first", previousTurnId: null },
+                    { userMessage: "first", previousTurnId: "none" },
                     new AbortController().signal,
                 ),
             );
 
             expect(prepareTurn).toHaveBeenCalledWith({
                 input: [{ type: "user.message", content: "first" }],
-                previousTurnId: null,
+                previousTurnId: "none",
             });
         });
 

package/src/streamTurn.ts

@@ -18,10 +18,10 @@ export type StreamTurnOptions = {
     resumeMcpAuth?: boolean;
     inputs?: RequiredActionInput[];
     /**
-     * Branch anchor for `prepareTurn`. Omit for `"auto"`. Pass `null` for a fresh
-     * root turn — sent as `previous_turn_id: null` on the wire.
+     * Branch anchor for `prepareTurn`. Omit for `"auto"`. Pass `"none"` for a fresh
+     * root turn — sent as `previous_turn_id: "none"` on the wire.
      */
-    previousTurnId?: string | null;
+    previousTurnId?: TruefoundryGatewayApi.PreviousTurnIdInput;
     /** Extra headers for the createTurn request (`execute` request options). */
     headers?: Record<string, string>;
 };
@@ -62,18 +62,9 @@ export async function* streamTurnContent(
      */
     onTurnIdAvailable?: (turnId: string) => void,
 ): AsyncGenerator<TurnStreamUpdate> {
-    // When previousTurnId is explicitly null, pass it through to prepareTurn so the
-    // SDK serializer emits `previous_turn_id: null` on the wire (first turn in session).
-    // The SDK type doesn't admit null, but the Fern serializer handles it correctly.
-    const previousTurnId: TruefoundryGatewayApi.PreviousTurnIdInput | null | undefined =
-        options.previousTurnId === null
-            ? null
-            : (options.previousTurnId ?? "auto");
     const turn = session.prepareTurn({
         input: buildTurnInput(options),
-        ...(previousTurnId !== undefined
-            ? { previousTurnId: previousTurnId as TruefoundryGatewayApi.PreviousTurnIdInput }
-            : {}),
+        previousTurnId: options.previousTurnId ?? "auto",
     });
 
     const onAbort = bindAbort(session, abortSignal);

package/src/truefoundryThreadListAdapter.ts

@@ -23,7 +23,7 @@ export function createTrueFoundryThreadListAdapter(options: {
             const threads = page.data.map((session) => ({
                 status: "regular" as const,
                 remoteId: session.id,
-                title: session.title,
+                title: session.title ?? undefined,
                 lastMessageAt: new Date(session.updatedAt),
             }));
             return {
@@ -42,7 +42,7 @@ export function createTrueFoundryThreadListAdapter(options: {
             return {
                 status: "regular" as const,
                 remoteId: session.id,
-                title: session.title,
+                title: session.title ?? undefined,
                 lastMessageAt: new Date(session.updatedAt),
             };
         },

package/src/useTrueFoundryAgentMessages.ts

@@ -80,7 +80,7 @@ export type UseTrueFoundryAgentMessagesOptions = {
 export type SendTurnOptions =
     | {
           userMessage: UserMessageContent;
-          previousTurnId?: string | null;
+          previousTurnId?: string;
           /**
            * When branching (edit/reset), the already-rewound history to send from.
            * Applied atomically with `pendingUser` so a stale React snapshot cannot
@@ -596,7 +596,7 @@ export function useTrueFoundryAgentMessages({
                 isContinuation && continuationTurnId != null
                     ? continuationTurnId
                     : generateId();
-            // First turns must send previousTurnId: null.
+            // First turns must send previousTurnId: "none".
             const isFirstTurnInSession =
                 "userMessage" in options &&
                 options.previousTurnId === undefined &&
@@ -697,7 +697,7 @@ export function useTrueFoundryAgentMessages({
                             ...(options.previousTurnId !== undefined
                                 ? { previousTurnId: options.previousTurnId }
                                 : isFirstTurnInSession
-                                  ? { previousTurnId: null }
+                                  ? { previousTurnId: "none" }
                                   : {}),
                             ...streamHeaders,
                         },