Skip to content

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.json
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.json
index 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.md
index 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.ts
index 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} request
diff --git a/packages/sdk/src/api/resources/sessions/client/requests/CreateTurnSessionsRequest.ts b/packages/sdk/src/api/resources/sessions/client/requests/CreateTurnSessionsRequest.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.md
index 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.ts
index 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 AgentSpec
diff --git a/packages/trueforge-ui-sdk/src/server/types.ts b/packages/trueforge-ui-sdk/src/server/types.ts
index 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