The open-source agent harness - the runtime layer that turns an LLM into a working agent.
Use previous_turn_id "none" as the wire sentinel for new root turns.
debajyoti-truefoundryb0171d63f42c
diff --git a/fern/openapi/openapi.json b/fern/openapi/openapi.jsonindex 519b463cb..8927c905d 100644--- a/fern/openapi/openapi.json+++ b/fern/openapi/openapi.json@@ -1908,15 +1908,18 @@"type": "string"},{- "minLength": 1,+ "enum": [+ "none"+ ],"type": "string"},{- "type": "null"+ "minLength": 1,+ "type": "string"}],"default": "auto",- "description": "Defaults to 'auto' (chain to session last turn). Use 'null' for the session's first turn."+ "description": "Defaults to 'auto' (chain to session last turn). Use 'none' for a new root turn."},"PutAgentResponse": {"properties": {@@ -4692,7 +4695,7 @@"x-fern-sdk-method-name": "list_turns"},"post": {- "description": "Create a turn within a session and execute it.\nWhen `stream` is true (default), respond with a Server-Sent Events stream of turn events.\nWhen `stream` is false, return the turn immediately with `state.status: \"running\"` while execution continues in the background; use get turn or subscribe to observe completion.\nUse `previous_turn_id` to chain to the session's last turn (defaults to `auto`).",+ "description": "Create a turn within a session and execute it.\nWhen `stream` is true (default), respond with a Server-Sent Events stream of turn events.\nWhen `stream` is false, return the turn immediately with `state.status: \"running\"` while execution continues in the background; use get turn or subscribe to observe completion.\nUse `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.","parameters": [{"description": "Session identifier.",diff --git a/packages/frontend/src/harnessServer.ts b/packages/frontend/src/harnessServer.tsindex 58d88fc2a..aab10b2cc 100644--- a/packages/frontend/src/harnessServer.ts+++ b/packages/frontend/src/harnessServer.ts@@ -168,14 +168,6 @@ function toHarnessInput(input: TurnInputItem[]): Harness.TurnInputItem[] {);}-/**- * The runtime marks a chain root with the gateway's `"none"` sentinel; Harness- * spells that `null` and would otherwise look `"none"` up as a turn id (404).- */-function toHarnessPreviousTurnId(previousTurnId: string): Harness.PreviousTurnIdInput | null {- return previousTurnId === 'none' ? null : previousTurnId;-}-export function createHarnessChatServer(options: CreateHarnessServerOptions = {}): AgentChatServer<HarnessAgentSpec> {const client =options.baseUrl === undefined && options.fetch === undefined ? harnessClient : createHarnessClient(options);@@ -223,7 +215,7 @@ export function createHarnessChatServer(options: CreateHarnessServerOptions = {}}) {const stream = await client.sessions.createTurnStream(sessionId, {...(input === undefined ? {} : { input: toHarnessInput(input) }),- ...(previousTurnId === undefined ? {} : { previousTurnId: toHarnessPreviousTurnId(previousTurnId) }),+ ...(previousTurnId === undefined ? {} : { previousTurnId }),});let fallbackSequence = 0;for await (const item of stream.withMetadata()) {diff --git a/packages/frontend/tests/harnessServer.test.ts b/packages/frontend/tests/harnessServer.test.tsindex 98af58d0c..fcd790253 100644--- a/packages/frontend/tests/harnessServer.test.ts+++ b/packages/frontend/tests/harnessServer.test.ts@@ -109,7 +109,6 @@ describe('createHarnessChatServer', () => {for await (const event of server.createTurn({sessionId: 'ses_1',input: [{ type: 'user.message', content: 'hello' }],- // The runtime's root sentinel; Harness 404s unless it becomes `null`.previousTurnId: 'none',})) {events.push(event);@@ -117,7 +116,7 @@ describe('createHarnessChatServer', () => {const sent = turnRequests.at(-1);assert.ok(sent !== null && typeof sent === 'object' && 'previous_turn_id' in sent && 'stream' in sent);- assert.equal(sent.previous_turn_id, null);+ assert.equal(sent.previous_turn_id, 'none');assert.equal(sent.stream, true);assert.deepEqual(events, [diff --git a/packages/harness/src/agent-session/SessionHandle.ts b/packages/harness/src/agent-session/SessionHandle.tsindex 3634806f1..b2492c84c 100644--- a/packages/harness/src/agent-session/SessionHandle.ts+++ b/packages/harness/src/agent-session/SessionHandle.ts@@ -34,11 +34,8 @@ import { TurnHandle } from './TurnHandle';/** How many recent ancestors SessionHandle persists on each turn. Store-local. */const MAX_TURN_ANCESTORS = 20;-function resolvePreviousTurnId(- requested: string | null | undefined,- lastTurnId: string | null | undefined,-): string | null {- if (requested === null) {+function resolvePreviousTurnId(requested: string | undefined, lastTurnId: string | null | undefined): string | null {+ if (requested === 'none') {return null;}if (requested === undefined || requested === 'auto') {@@ -160,15 +157,15 @@ export class SessionHandle<* so resources acquired here (e.g. a sandbox VM) never outlive a failed run.* On success, ownership of resolver.close() passes to TurnHandle.stream().*- * `previous_turn_id`: omitted/`'auto'` → session tip; `null` → new root+ * `previous_turn_id`: omitted/`'auto'` → session tip; `'none'` → new root* (no parent, even on a non-empty session); string → fork from that turn* (must exist). Concurrent `'auto'` forks both succeed.*/async createTurn(input: {turn_id: string;input?: TurnInputItem[] | undefined;- /** 'auto'/omitted → session.last_turn_id; null → new root; id → fork from that turn. */- previous_turn_id?: string | null | undefined;+ /** 'auto'/omitted → session.last_turn_id; 'none' → new root; id → fork from that turn. */+ previous_turn_id?: string | undefined;signal: AbortSignal;resolver: ITurnResourceResolver<TTurnCustom>;/** Value = stored as-is. Fn = merge over previous turn's custom. Omitted = undefined. */diff --git a/packages/harness/src/agent-session/schemas/turn.ts b/packages/harness/src/agent-session/schemas/turn.tsindex 6e8d81c20..0cd28c9f1 100644--- a/packages/harness/src/agent-session/schemas/turn.ts+++ b/packages/harness/src/agent-session/schemas/turn.ts@@ -107,10 +107,10 @@ export const CreateTurnRequestSchema = z.object({input: z.array(TurnInputItemSchema).optional(),previous_turn_id: z- .union([z.literal('auto'), z.string().min(1), z.null()])+ .union([z.literal('auto'), z.literal('none'), z.string().min(1)]).optional().default('auto')- .describe(`Defaults to 'auto' (chain to session last turn). Use 'null' for the session's first turn.`)+ .describe(`Defaults to 'auto' (chain to session last turn). Use 'none' for a new root turn.`).openapi('PreviousTurnIdInput'),stream: z.boolean()diff --git a/packages/harness/tests/agent-session/capabilityState.test.ts b/packages/harness/tests/agent-session/capabilityState.test.tsindex ec8d71238..16ba7b033 100644--- a/packages/harness/tests/agent-session/capabilityState.test.ts+++ b/packages/harness/tests/agent-session/capabilityState.test.ts@@ -73,7 +73,7 @@ describe('capability_state (tfy.plan fixture)', () => {const turn1 = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'start' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver({extraCapabilities: [@@ -142,7 +142,7 @@ describe('capability_state (tfy.plan fixture)', () => {const turn1 = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'start' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver({extraCapabilities: [makePlanShapedCapability({ enabled: true, emitState: planV1 })],@@ -230,7 +230,7 @@ describe('capability_state (tfy.plan fixture)', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'x' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver({ extraCapabilities: [undefinedStateCapability] }),});diff --git a/packages/harness/tests/agent-session/resolveAgentSpec.test.ts b/packages/harness/tests/agent-session/resolveAgentSpec.test.tsindex 03068c4a4..ed44064f9 100644--- a/packages/harness/tests/agent-session/resolveAgentSpec.test.ts+++ b/packages/harness/tests/agent-session/resolveAgentSpec.test.ts@@ -33,7 +33,7 @@ describe('SessionHandle.createTurn named resolve', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hi' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver({ agent }),});diff --git a/packages/harness/tests/agent-session/sessions.test.ts b/packages/harness/tests/agent-session/sessions.test.tsindex 9de9989cc..a986caea5 100644--- a/packages/harness/tests/agent-session/sessions.test.ts+++ b/packages/harness/tests/agent-session/sessions.test.ts@@ -41,7 +41,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver(),update_session_title_if_not_exist: 'From first message',@@ -69,7 +69,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {});const created = await session.createTurn({turn_id: mintTestTurnId(),- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver(),});@@ -106,7 +106,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {const t1 = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'one' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver<{ n: number }>(),custom: { n: 1 },@@ -124,7 +124,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {expect(t2.custom).toEqual({ n: 11 });});- it('previous_turn_id null creates a new root on a non-empty session', async () => {+ it('previous_turn_id none creates a new root on a non-empty session', async () => {const store = new InMemorySessionStore();const sessions = new Sessions({ sessionStore: store });const session = await sessions.create({@@ -135,7 +135,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {const first = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'one' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver(),});@@ -146,7 +146,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {const root2 = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'fresh root' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver(),});@@ -176,7 +176,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {approval: { status: 'allow' },},],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver(),}),@@ -215,7 +215,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {approval: { status: 'allow' },},],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver({ close: closeOnFailure }),}),@@ -227,7 +227,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver({ close: closeOnSuccess }),});diff --git a/packages/harness/tests/agent-session/turnStream.test.ts b/packages/harness/tests/agent-session/turnStream.test.tsindex f57f5b029..a829b0025 100644--- a/packages/harness/tests/agent-session/turnStream.test.ts+++ b/packages/harness/tests/agent-session/turnStream.test.ts@@ -40,7 +40,7 @@ describe('TurnHandle.stream()', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver(),});@@ -82,7 +82,7 @@ describe('TurnHandle.stream()', () => {const turn = await session.createTurn({turn_id: 'turn-usage',input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver({usage: {@@ -117,7 +117,7 @@ describe('TurnHandle.stream()', () => {const turn1 = await session.createTurn({turn_id: 'turn-isolation-1',input: [{ type: EventType.USER_MESSAGE, content: 'turn one' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver({usage: {@@ -182,7 +182,7 @@ describe('TurnHandle.stream()', () => {const turn = await session.createTurn({turn_id: 'turn-cache-read',input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver({usage: {@@ -208,7 +208,7 @@ describe('TurnHandle.stream()', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver(),});@@ -226,7 +226,7 @@ describe('TurnHandle.stream()', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver(),});@@ -250,7 +250,7 @@ describe('TurnHandle.stream()', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver({close: () => {@@ -281,7 +281,7 @@ describe('TurnHandle.stream()', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: controller.signal,resolver: makeTestResolver(),});@@ -307,7 +307,7 @@ describe('TurnHandle.stream()', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: controller.signal,resolver: makeTestResolver(),});@@ -335,7 +335,7 @@ describe('TurnHandle.stream()', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: controller.signal,resolver: makeTestResolver(),});@@ -363,7 +363,7 @@ describe('TurnHandle.stream()', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver: makeTestResolver({close: () => {@@ -402,7 +402,7 @@ describe('TurnHandle.stream()', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hello' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver,});@@ -487,7 +487,7 @@ describe('TurnResourceResolver caches', () => {const turn = await session.createTurn({turn_id: mintTestTurnId(),input: [{ type: EventType.USER_MESSAGE, content: 'hi' }],- previous_turn_id: null,+ previous_turn_id: 'none',signal: new AbortController().signal,resolver,});diff --git a/packages/sdk/.fern/metadata.json b/packages/sdk/.fern/metadata.jsonindex 37795aca2..9b7a311ce 100644--- a/packages/sdk/.fern/metadata.json+++ b/packages/sdk/.fern/metadata.json@@ -27,8 +27,8 @@"streamType": "web","useDefaultRequestParameterValues": true},- "originGitCommit": "bf81d3d493c19850340d29615d70c162b6aa0e81",- "originGitCommitIsDirty": false,+ "originGitCommit": "1819002252c4073d5d0ebf0cc6488a32a481594e",+ "originGitCommitIsDirty": true,"invokedBy": "manual","requestedVersion": "0.0.0","sdkVersion": "0.0.0"diff --git a/packages/sdk/reference.md b/packages/sdk/reference.mdindex 5ea5950ec..bfcf6335e 100644--- a/packages/sdk/reference.md+++ b/packages/sdk/reference.md@@ -1231,7 +1231,7 @@ await client.sessions.listTurns("session_id");Create a turn within a session and execute it.When `stream` is true (default), respond with a Server-Sent Events stream of turn events.When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.-Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`).+Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.</dd></dl></dd>@@ -1308,7 +1308,7 @@ for await (const item of response) {Create a turn within a session and execute it.When `stream` is true (default), respond with a Server-Sent Events stream of turn events.When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.-Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`).+Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.</dd></dl></dd>diff --git a/packages/sdk/src/api/resources/sessions/client/Client.ts b/packages/sdk/src/api/resources/sessions/client/Client.tsindex 2302b7b57..77517ca35 100644--- a/packages/sdk/src/api/resources/sessions/client/Client.ts+++ b/packages/sdk/src/api/resources/sessions/client/Client.ts@@ -857,7 +857,7 @@ export class SessionsClient {* Create a turn within a session and execute it.* When `stream` is true (default), respond with a Server-Sent Events stream of turn events.* When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.- * Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`).+ * Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.*/public createTurnStream(session_id: string,@@ -992,7 +992,7 @@ export class SessionsClient {* Create a turn within a session and execute it.* When `stream` is true (default), respond with a Server-Sent Events stream of turn events.* When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.- * Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`).+ * Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.** @param {string} session_id - Session identifier.* @param {TrueForge.CreateTurnSessionsRequest} requestdiff --git a/packages/sdk/src/api/resources/sessions/client/requests/CreateTurnSessionsRequest.ts b/packages/sdk/src/api/resources/sessions/client/requests/CreateTurnSessionsRequest.tsindex 80ab4093f..34c375525 100644--- a/packages/sdk/src/api/resources/sessions/client/requests/CreateTurnSessionsRequest.ts+++ b/packages/sdk/src/api/resources/sessions/client/requests/CreateTurnSessionsRequest.ts@@ -8,5 +8,5 @@ import type * as TrueForge from "../../../../index.js";*/export interface CreateTurnSessionsRequest {input?: TrueForge.TurnInputItem[];- previousTurnId?: TrueForge.PreviousTurnIdInput | null;+ previousTurnId?: TrueForge.PreviousTurnIdInput;}diff --git a/packages/sdk/src/api/resources/sessions/client/requests/CreateTurnSessionsStreamRequest.ts b/packages/sdk/src/api/resources/sessions/client/requests/CreateTurnSessionsStreamRequest.tsindex 5d44f5fa6..dc1f9c17e 100644--- a/packages/sdk/src/api/resources/sessions/client/requests/CreateTurnSessionsStreamRequest.ts+++ b/packages/sdk/src/api/resources/sessions/client/requests/CreateTurnSessionsStreamRequest.ts@@ -8,5 +8,5 @@ import type * as TrueForge from "../../../../index.js";*/export interface CreateTurnSessionsStreamRequest {input?: TrueForge.TurnInputItem[];- previousTurnId?: TrueForge.PreviousTurnIdInput | null;+ previousTurnId?: TrueForge.PreviousTurnIdInput;}diff --git a/packages/sdk/src/api/types/PreviousTurnIdInput.ts b/packages/sdk/src/api/types/PreviousTurnIdInput.tsindex b05dbd2a5..4abdbcd50 100644--- a/packages/sdk/src/api/types/PreviousTurnIdInput.ts+++ b/packages/sdk/src/api/types/PreviousTurnIdInput.ts@@ -1,6 +1,6 @@// This file was auto-generated by Fern from our API Definition./**- * Defaults to 'auto' (chain to session last turn). Use 'null' for the session's first turn.+ * Defaults to 'auto' (chain to session last turn). Use 'none' for a new root turn.*/-export type PreviousTurnIdInput = "auto" | string;+export type PreviousTurnIdInput = "auto" | "none" | string;diff --git a/packages/sdk/src/serialization/resources/sessions/client/requests/CreateTurnSessionsRequest.ts b/packages/sdk/src/serialization/resources/sessions/client/requests/CreateTurnSessionsRequest.tsindex ab2ea5bf3..f641f581c 100644--- a/packages/sdk/src/serialization/resources/sessions/client/requests/CreateTurnSessionsRequest.ts+++ b/packages/sdk/src/serialization/resources/sessions/client/requests/CreateTurnSessionsRequest.ts@@ -11,12 +11,12 @@ export const CreateTurnSessionsRequest: core.serialization.Schema<TrueForge.CreateTurnSessionsRequest> = core.serialization.object({input: core.serialization.list(TurnInputItem).optional(),- previousTurnId: core.serialization.property("previous_turn_id", PreviousTurnIdInput.optionalNullable()),+ previousTurnId: core.serialization.property("previous_turn_id", PreviousTurnIdInput.optional()),});export declare namespace CreateTurnSessionsRequest {export interface Raw {input?: TurnInputItem.Raw[] | null;- previous_turn_id?: (PreviousTurnIdInput.Raw | null | undefined) | null;+ previous_turn_id?: PreviousTurnIdInput.Raw | null;}}diff --git a/packages/sdk/src/serialization/resources/sessions/client/requests/CreateTurnSessionsStreamRequest.ts b/packages/sdk/src/serialization/resources/sessions/client/requests/CreateTurnSessionsStreamRequest.tsindex fef0431c3..15bf88614 100644--- a/packages/sdk/src/serialization/resources/sessions/client/requests/CreateTurnSessionsStreamRequest.ts+++ b/packages/sdk/src/serialization/resources/sessions/client/requests/CreateTurnSessionsStreamRequest.ts@@ -11,12 +11,12 @@ export const CreateTurnSessionsStreamRequest: core.serialization.Schema<TrueForge.CreateTurnSessionsStreamRequest> = core.serialization.object({input: core.serialization.list(TurnInputItem).optional(),- previousTurnId: core.serialization.property("previous_turn_id", PreviousTurnIdInput.optionalNullable()),+ previousTurnId: core.serialization.property("previous_turn_id", PreviousTurnIdInput.optional()),});export declare namespace CreateTurnSessionsStreamRequest {export interface Raw {input?: TurnInputItem.Raw[] | null;- previous_turn_id?: (PreviousTurnIdInput.Raw | null | undefined) | null;+ previous_turn_id?: PreviousTurnIdInput.Raw | null;}}diff --git a/packages/sdk/src/serialization/types/PreviousTurnIdInput.ts b/packages/sdk/src/serialization/types/PreviousTurnIdInput.tsindex 3bcc2e4a1..6c52ee5c5 100644--- a/packages/sdk/src/serialization/types/PreviousTurnIdInput.ts+++ b/packages/sdk/src/serialization/types/PreviousTurnIdInput.ts@@ -7,8 +7,12 @@ import type * as serializers from "../index.js";export const PreviousTurnIdInput: core.serialization.Schema<serializers.PreviousTurnIdInput.Raw,TrueForge.PreviousTurnIdInput-> = core.serialization.undiscriminatedUnion([core.serialization.stringLiteral("auto"), core.serialization.string()]);+> = core.serialization.undiscriminatedUnion([+ core.serialization.stringLiteral("auto"),+ core.serialization.stringLiteral("none"),+ core.serialization.string(),+]);export declare namespace PreviousTurnIdInput {- export type Raw = "auto" | string;+ export type Raw = "auto" | "none" | string;}diff --git a/packages/server/src/routes/turnRoutes.ts b/packages/server/src/routes/turnRoutes.tsindex fa1370d37..cd090c346 100644--- a/packages/server/src/routes/turnRoutes.ts+++ b/packages/server/src/routes/turnRoutes.ts@@ -113,7 +113,7 @@ export const createAndExecuteTurnRoute = createRoute({description: `Create a turn within a session and execute it.When \`stream\` is true (default), respond with a Server-Sent Events stream of turn events.When \`stream\` is false, return the turn immediately with \`state.status: "running"\` while execution continues in the background; use get turn or subscribe to observe completion.-Use \`previous_turn_id\` to chain to the session's last turn (defaults to \`auto\`).`,+Use \`previous_turn_id\` to chain to the session's last turn (defaults to \`auto\`); use \`none\` for a new root.`,'x-fern-sdk-group-name': ['sessions'],'x-fern-sdk-method-name': 'create_turn','x-fern-streaming': {diff --git a/packages/server/tests/unit/apis/createTurnNonStreaming.test.ts b/packages/server/tests/unit/apis/createTurnNonStreaming.test.tsindex 58fe4300f..5c06f805e 100644--- a/packages/server/tests/unit/apis/createTurnNonStreaming.test.ts+++ b/packages/server/tests/unit/apis/createTurnNonStreaming.test.ts@@ -5,6 +5,7 @@ import { createLogger } from 'winston';import { TENANT_ID } from '../../../src/apis/sessions';import { createTurnsRouter, turnStreamId } from '../../../src/apis/turns';import { migrateSqliteToLatest } from '../../../src/db/migrateSqlite';+import { SqliteAgentStore } from '../../../src/db/sqlite/agent-store/SqliteAgentStore';import { createSqliteDb } from '../../../src/db/sqlite/client';import { SqliteMcpServerStore } from '../../../src/db/sqlite/mcp-server-store/SqliteMcpServerStore';import { SqliteModelProviderStore } from '../../../src/db/sqlite/model-provider-store/SqliteModelProviderStore';@@ -83,6 +84,7 @@ describe('create turn non-streaming', () => {sessionStore: new SqliteSessionStore(db),activeTurns: new ActiveTurnRegistry(),modelProviderStore,+ agentStore: new SqliteAgentStore(db),mcpServerStore: new SqliteMcpServerStore(db),tokenStore: new SqliteOAuthTokenStore(db),skillStore: new SqliteSkillStore(db),diff --git a/packages/trueforge-ui-sdk/docs/server-types.temp.md b/packages/trueforge-ui-sdk/docs/server-types.temp.mdindex 848f831a9..1075afa32 100644--- a/packages/trueforge-ui-sdk/docs/server-types.temp.md+++ b/packages/trueforge-ui-sdk/docs/server-types.temp.md@@ -102,7 +102,7 @@ export type PageParams = {endTimestamp?: string;};-export type PreviousTurnIdInput = 'auto' | string;+export type PreviousTurnIdInput = 'auto' | 'none' | string;```### AgentSpec (+ nested)diff --git a/packages/trueforge-ui-sdk/docs/server-types.temp.ts b/packages/trueforge-ui-sdk/docs/server-types.temp.tsindex 72f3e7a53..a05f94101 100644--- a/packages/trueforge-ui-sdk/docs/server-types.temp.ts+++ b/packages/trueforge-ui-sdk/docs/server-types.temp.ts@@ -114,7 +114,7 @@ export type PageParams = {endTimestamp?: string;};-export type PreviousTurnIdInput = 'auto' | string;+export type PreviousTurnIdInput = 'auto' | 'none' | string;// ---------------------------------------------------------------------------// AgentSpec (+ nested) — base; hosts extend via TSpec extends AgentSpecdiff --git a/packages/trueforge-ui-sdk/src/server/types.ts b/packages/trueforge-ui-sdk/src/server/types.tsindex 3260e4b7a..7620e9ce1 100644--- a/packages/trueforge-ui-sdk/src/server/types.ts+++ b/packages/trueforge-ui-sdk/src/server/types.ts@@ -174,7 +174,7 @@ export interface ListSessionsResponse<pagination: TokenPagination;}-export type PreviousTurnIdInput = 'auto' | string;+export type PreviousTurnIdInput = 'auto' | 'none' | string;// ---------------------------------------------------------------------------// Turn input / state — what runtime sends and reads