The open-source agent harness - the runtime layer that turns an LLM into a working agent.
fix: add paused to turn state, add mcp auth_continue event. (#866)
Heer Ambavibbc4f7d13f4e
diff --git a/.changeset/user-mcp-auth-continue-event.md b/.changeset/user-mcp-auth-continue-event.mdnew file mode 100644index 000000000..12d9679ba--- /dev/null+++ b/.changeset/user-mcp-auth-continue-event.md@@ -0,0 +1,6 @@+---+"@truefoundry/trueforge-core": patch+"@truefoundry/trueforge": patch+---++Add `user.mcp_auth_continue` (`{ "type": "user.mcp_auth_continue" }`) on POST `/events`, session events, and the SSE stream. Add paused to turn state.diff --git a/.github/fern/openapi/openapi.json b/.github/fern/openapi/openapi.jsonindex 2af2a5d16..6fe2f9f7c 100644--- a/.github/fern/openapi/openapi.json+++ b/.github/fern/openapi/openapi.json@@ -1166,7 +1166,7 @@"CreateTurnEventRequest": {"properties": {"events": {- "description": "One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).",+ "description": "One or more user events.","items": {"$ref": "#/components/schemas/TurnInboundEventItem"},@@ -1186,6 +1186,7 @@"items": {"discriminator": {"mapping": {+ "user.mcp_auth_continue": "#/components/schemas/UserMCPAuthContinueEvent","user.tool_approval": "#/components/schemas/UserToolApprovalEvent","user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent","user.tool_response": "#/components/schemas/UserToolResponseEvent"@@ -1201,6 +1202,9 @@},{"$ref": "#/components/schemas/UserToolApprovalPolicyEvent"+ },+ {+ "$ref": "#/components/schemas/UserMCPAuthContinueEvent"}]},@@ -4158,6 +4162,7 @@"turn.created": "#/components/schemas/TurnCreatedEvent","turn.done": "#/components/schemas/TurnDoneEvent","turn.update": "#/components/schemas/TurnUpdateEvent",+ "user.mcp_auth_continue": "#/components/schemas/UserMCPAuthContinueEvent","user.tool_approval": "#/components/schemas/UserToolApprovalEvent","user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent","user.tool_response": "#/components/schemas/UserToolResponseEvent"@@ -4209,6 +4214,9 @@},{"$ref": "#/components/schemas/UserToolApprovalPolicyEvent"+ },+ {+ "$ref": "#/components/schemas/UserMCPAuthContinueEvent"}]},@@ -5344,6 +5352,7 @@"TurnInboundEventItem": {"discriminator": {"mapping": {+ "user.mcp_auth_continue": "#/components/schemas/UserMCPAuthContinueInputEvent","user.tool_approval": "#/components/schemas/UserToolApprovalInputEvent","user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyMessage","user.tool_response": "#/components/schemas/UserToolResponseInputEvent"@@ -5359,6 +5368,9 @@},{"$ref": "#/components/schemas/UserToolApprovalPolicyMessage"+ },+ {+ "$ref": "#/components/schemas/UserMCPAuthContinueInputEvent"}]},@@ -5430,6 +5442,7 @@"cancelled": "#/components/schemas/TurnStateCancelled","done": "#/components/schemas/TurnStateDone","error": "#/components/schemas/TurnStateError",+ "paused": "#/components/schemas/TurnStatePaused","running": "#/components/schemas/TurnStateRunning"},"propertyName": "status"@@ -5438,6 +5451,9 @@{"$ref": "#/components/schemas/TurnStateRunning"},+ {+ "$ref": "#/components/schemas/TurnStatePaused"+ },{"$ref": "#/components/schemas/TurnStateDone"},@@ -5511,7 +5527,7 @@"type": "null"}],- "description": "Final `model.message` for the turn, or null when the turn ended paused without a final message."+ "description": "Final `model.message` for the turn, or null when the turn ended without a final message."},"required_actions": {"description": "Pending actions (`tool.approval_required`, `tool.response_required`, `mcp.auth_required`); empty when none.",@@ -5521,7 +5537,7 @@"type": "array"},"status": {- "description": "Turn finished (possibly paused for required actions).",+ "description": "Turn finished with no open required actions.","enum": ["done"],@@ -5571,6 +5587,29 @@],"type": "object"},+ "TurnStatePaused": {+ "properties": {+ "action_required_on_events": {+ "description": "Events that still need a user or client action.",+ "items": {+ "$ref": "#/components/schemas/ActionRequired"+ },+ "type": "array"+ },+ "status": {+ "description": "Turn is paused waiting for required actions.",+ "enum": [+ "paused"+ ],+ "type": "string"+ }+ },+ "required": [+ "status",+ "action_required_on_events"+ ],+ "type": "object"+ },"TurnStateRunning": {"properties": {"status": {@@ -5602,6 +5641,7 @@"turn.created": "#/components/schemas/TurnCreatedEvent","turn.done": "#/components/schemas/TurnDoneEvent","turn.update": "#/components/schemas/TurnUpdateEvent",+ "user.mcp_auth_continue": "#/components/schemas/UserMCPAuthContinueEvent","user.tool_approval": "#/components/schemas/UserToolApprovalEvent","user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent","user.tool_response": "#/components/schemas/UserToolResponseEvent"@@ -5648,6 +5688,9 @@{"$ref": "#/components/schemas/UserToolApprovalPolicyEvent"},+ {+ "$ref": "#/components/schemas/UserMCPAuthContinueEvent"+ },{"$ref": "#/components/schemas/TurnCreatedEvent"},@@ -5670,7 +5713,22 @@"type": "string"},"state": {- "$ref": "#/components/schemas/TurnUpdateState"+ "description": "Live non-terminal turn state (paused or running).",+ "discriminator": {+ "mapping": {+ "paused": "#/components/schemas/TurnStatePaused",+ "running": "#/components/schemas/TurnStateRunning"+ },+ "propertyName": "status"+ },+ "oneOf": [+ {+ "$ref": "#/components/schemas/TurnStatePaused"+ },+ {+ "$ref": "#/components/schemas/TurnStateRunning"+ }+ ]},"thread_id": {"description": "Thread that owns the event; null for turn-level lifecycle events.",@@ -5696,62 +5754,6 @@],"type": "object"},- "TurnUpdateState": {- "description": "Live non-terminal turn status.",- "discriminator": {- "mapping": {- "paused": "#/components/schemas/TurnUpdateStatePaused",- "running": "#/components/schemas/TurnUpdateStateRunning"- },- "propertyName": "status"- },- "oneOf": [- {- "$ref": "#/components/schemas/TurnUpdateStatePaused"- },- {- "$ref": "#/components/schemas/TurnUpdateStateRunning"- }- ]- },- "TurnUpdateStatePaused": {- "properties": {- "action_required_on_events": {- "description": "Events that still need a user or client action.",- "items": {- "$ref": "#/components/schemas/ActionRequired"- },- "type": "array"- },- "status": {- "description": "Turn is paused waiting for required actions.",- "enum": [- "paused"- ],- "type": "string"- }- },- "required": [- "status",- "action_required_on_events"- ],- "type": "object"- },- "TurnUpdateStateRunning": {- "properties": {- "status": {- "description": "Turn is executing.",- "enum": [- "running"- ],- "type": "string"- }- },- "required": [- "status"- ],- "type": "object"- },"UpdateAgentRequest": {"additionalProperties": false,"properties": {@@ -5863,6 +5865,46 @@],"type": "object"},+ "UserMCPAuthContinueEvent": {+ "properties": {+ "created_at": {+ "description": "ISO 8601 event timestamp.",+ "type": "string"+ },+ "id": {+ "description": "Unique identifier for the event (monotonic ULID).",+ "type": "string"+ },+ "type": {+ "description": "Client resume after mcp.auth_required (OAuth completed).",+ "enum": [+ "user.mcp_auth_continue"+ ],+ "type": "string"+ }+ },+ "required": [+ "type",+ "id",+ "created_at"+ ],+ "type": "object"+ },+ "UserMCPAuthContinueInputEvent": {+ "properties": {+ "type": {+ "description": "Client resume after mcp.auth_required (OAuth completed).",+ "enum": [+ "user.mcp_auth_continue"+ ],+ "type": "string"+ }+ },+ "required": [+ "type"+ ],+ "type": "object"+ },"UserMessage": {"properties": {"content": {diff --git a/docs/openapi.json b/docs/openapi.jsonindex 2af2a5d16..6fe2f9f7c 100644--- a/docs/openapi.json+++ b/docs/openapi.json@@ -1166,7 +1166,7 @@"CreateTurnEventRequest": {"properties": {"events": {- "description": "One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).",+ "description": "One or more user events.","items": {"$ref": "#/components/schemas/TurnInboundEventItem"},@@ -1186,6 +1186,7 @@"items": {"discriminator": {"mapping": {+ "user.mcp_auth_continue": "#/components/schemas/UserMCPAuthContinueEvent","user.tool_approval": "#/components/schemas/UserToolApprovalEvent","user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent","user.tool_response": "#/components/schemas/UserToolResponseEvent"@@ -1201,6 +1202,9 @@},{"$ref": "#/components/schemas/UserToolApprovalPolicyEvent"+ },+ {+ "$ref": "#/components/schemas/UserMCPAuthContinueEvent"}]},@@ -4158,6 +4162,7 @@"turn.created": "#/components/schemas/TurnCreatedEvent","turn.done": "#/components/schemas/TurnDoneEvent","turn.update": "#/components/schemas/TurnUpdateEvent",+ "user.mcp_auth_continue": "#/components/schemas/UserMCPAuthContinueEvent","user.tool_approval": "#/components/schemas/UserToolApprovalEvent","user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent","user.tool_response": "#/components/schemas/UserToolResponseEvent"@@ -4209,6 +4214,9 @@},{"$ref": "#/components/schemas/UserToolApprovalPolicyEvent"+ },+ {+ "$ref": "#/components/schemas/UserMCPAuthContinueEvent"}]},@@ -5344,6 +5352,7 @@"TurnInboundEventItem": {"discriminator": {"mapping": {+ "user.mcp_auth_continue": "#/components/schemas/UserMCPAuthContinueInputEvent","user.tool_approval": "#/components/schemas/UserToolApprovalInputEvent","user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyMessage","user.tool_response": "#/components/schemas/UserToolResponseInputEvent"@@ -5359,6 +5368,9 @@},{"$ref": "#/components/schemas/UserToolApprovalPolicyMessage"+ },+ {+ "$ref": "#/components/schemas/UserMCPAuthContinueInputEvent"}]},@@ -5430,6 +5442,7 @@"cancelled": "#/components/schemas/TurnStateCancelled","done": "#/components/schemas/TurnStateDone","error": "#/components/schemas/TurnStateError",+ "paused": "#/components/schemas/TurnStatePaused","running": "#/components/schemas/TurnStateRunning"},"propertyName": "status"@@ -5438,6 +5451,9 @@{"$ref": "#/components/schemas/TurnStateRunning"},+ {+ "$ref": "#/components/schemas/TurnStatePaused"+ },{"$ref": "#/components/schemas/TurnStateDone"},@@ -5511,7 +5527,7 @@"type": "null"}],- "description": "Final `model.message` for the turn, or null when the turn ended paused without a final message."+ "description": "Final `model.message` for the turn, or null when the turn ended without a final message."},"required_actions": {"description": "Pending actions (`tool.approval_required`, `tool.response_required`, `mcp.auth_required`); empty when none.",@@ -5521,7 +5537,7 @@"type": "array"},"status": {- "description": "Turn finished (possibly paused for required actions).",+ "description": "Turn finished with no open required actions.","enum": ["done"],@@ -5571,6 +5587,29 @@],"type": "object"},+ "TurnStatePaused": {+ "properties": {+ "action_required_on_events": {+ "description": "Events that still need a user or client action.",+ "items": {+ "$ref": "#/components/schemas/ActionRequired"+ },+ "type": "array"+ },+ "status": {+ "description": "Turn is paused waiting for required actions.",+ "enum": [+ "paused"+ ],+ "type": "string"+ }+ },+ "required": [+ "status",+ "action_required_on_events"+ ],+ "type": "object"+ },"TurnStateRunning": {"properties": {"status": {@@ -5602,6 +5641,7 @@"turn.created": "#/components/schemas/TurnCreatedEvent","turn.done": "#/components/schemas/TurnDoneEvent","turn.update": "#/components/schemas/TurnUpdateEvent",+ "user.mcp_auth_continue": "#/components/schemas/UserMCPAuthContinueEvent","user.tool_approval": "#/components/schemas/UserToolApprovalEvent","user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent","user.tool_response": "#/components/schemas/UserToolResponseEvent"@@ -5648,6 +5688,9 @@{"$ref": "#/components/schemas/UserToolApprovalPolicyEvent"},+ {+ "$ref": "#/components/schemas/UserMCPAuthContinueEvent"+ },{"$ref": "#/components/schemas/TurnCreatedEvent"},@@ -5670,7 +5713,22 @@"type": "string"},"state": {- "$ref": "#/components/schemas/TurnUpdateState"+ "description": "Live non-terminal turn state (paused or running).",+ "discriminator": {+ "mapping": {+ "paused": "#/components/schemas/TurnStatePaused",+ "running": "#/components/schemas/TurnStateRunning"+ },+ "propertyName": "status"+ },+ "oneOf": [+ {+ "$ref": "#/components/schemas/TurnStatePaused"+ },+ {+ "$ref": "#/components/schemas/TurnStateRunning"+ }+ ]},"thread_id": {"description": "Thread that owns the event; null for turn-level lifecycle events.",@@ -5696,62 +5754,6 @@],"type": "object"},- "TurnUpdateState": {- "description": "Live non-terminal turn status.",- "discriminator": {- "mapping": {- "paused": "#/components/schemas/TurnUpdateStatePaused",- "running": "#/components/schemas/TurnUpdateStateRunning"- },- "propertyName": "status"- },- "oneOf": [- {- "$ref": "#/components/schemas/TurnUpdateStatePaused"- },- {- "$ref": "#/components/schemas/TurnUpdateStateRunning"- }- ]- },- "TurnUpdateStatePaused": {- "properties": {- "action_required_on_events": {- "description": "Events that still need a user or client action.",- "items": {- "$ref": "#/components/schemas/ActionRequired"- },- "type": "array"- },- "status": {- "description": "Turn is paused waiting for required actions.",- "enum": [- "paused"- ],- "type": "string"- }- },- "required": [- "status",- "action_required_on_events"- ],- "type": "object"- },- "TurnUpdateStateRunning": {- "properties": {- "status": {- "description": "Turn is executing.",- "enum": [- "running"- ],- "type": "string"- }- },- "required": [- "status"- ],- "type": "object"- },"UpdateAgentRequest": {"additionalProperties": false,"properties": {@@ -5863,6 +5865,46 @@],"type": "object"},+ "UserMCPAuthContinueEvent": {+ "properties": {+ "created_at": {+ "description": "ISO 8601 event timestamp.",+ "type": "string"+ },+ "id": {+ "description": "Unique identifier for the event (monotonic ULID).",+ "type": "string"+ },+ "type": {+ "description": "Client resume after mcp.auth_required (OAuth completed).",+ "enum": [+ "user.mcp_auth_continue"+ ],+ "type": "string"+ }+ },+ "required": [+ "type",+ "id",+ "created_at"+ ],+ "type": "object"+ },+ "UserMCPAuthContinueInputEvent": {+ "properties": {+ "type": {+ "description": "Client resume after mcp.auth_required (OAuth completed).",+ "enum": [+ "user.mcp_auth_continue"+ ],+ "type": "string"+ }+ },+ "required": [+ "type"+ ],+ "type": "object"+ },"UserMessage": {"properties": {"content": {diff --git a/packages/trueforge-core/src/agent-session/index.ts b/packages/trueforge-core/src/agent-session/index.tsindex a3caa641f..f380dd585 100644--- a/packages/trueforge-core/src/agent-session/index.ts+++ b/packages/trueforge-core/src/agent-session/index.ts@@ -7,6 +7,7 @@ export { AgentSpecSchema, DEFAULT_AGENT_CONFIG_ITERATION_LIMIT, RuntimeConfigSchexport type { AgentSpec, Skill } from './schemas/agentSpec';export {+ ActionRequiredSchema,CancellationReason,CreateTurnRequestSchema,TurnInboundEventItemSchema,@@ -17,6 +18,7 @@ export {TurnStateCancelledSchema,TurnStateDoneSchema,TurnStateErrorSchema,+ TurnStatePausedSchema,TurnStateRunningSchema,TurnStateSchema,} from './schemas/turn';diff --git a/packages/trueforge-core/src/agent-session/schemas/events.ts b/packages/trueforge-core/src/agent-session/schemas/events.tsindex 0a098f602..60acca22a 100644--- a/packages/trueforge-core/src/agent-session/schemas/events.ts+++ b/packages/trueforge-core/src/agent-session/schemas/events.ts@@ -18,6 +18,7 @@ import {ToolApprovalRequiredEventSchema,ToolResponseEventSchema,ToolResponseRequiredEventSchema,+ UserMCPAuthContinueEventSchema,UserToolApprovalEventSchema,UserToolApprovalPolicyEventSchema,UserToolResponseEventSchema,@@ -27,6 +28,7 @@ import {TurnStateCancelledSchema,TurnStateDoneSchema,TurnStateErrorSchema,+ TurnStatePausedSchema,TurnStateRunningSchema,} from './turn';@@ -63,37 +65,13 @@ export const TurnDoneEventSchema = z}).openapi('TurnDoneEvent');-export const ActionRequiredSchema = z- .object({- id: EventIdSchema,- })- .openapi('ActionRequired');--export const TurnUpdateStatePausedSchema = z- .object({- status: z.literal('paused').describe('Turn is paused waiting for required actions.'),- action_required_on_events: z- .array(ActionRequiredSchema)- .describe('Events that still need a user or client action.'),- })- .openapi('TurnUpdateStatePaused');--export const TurnUpdateStateRunningSchema = z- .object({- status: z.literal('running').describe('Turn is executing.'),- })- .openapi('TurnUpdateStateRunning');--export const TurnUpdateStateSchema = z- .discriminatedUnion('status', [TurnUpdateStatePausedSchema, TurnUpdateStateRunningSchema])- .describe('Live non-terminal turn status.')- .openapi('TurnUpdateState');-export const TurnUpdateEventSchema = z.object({type: z.literal(EventType.TURN_UPDATE).describe('Emitted when a turn pauses or resumes.'),id: EventIdSchema,- state: TurnUpdateStateSchema,+ state: z+ .discriminatedUnion('status', [TurnStatePausedSchema, TurnStateRunningSchema])+ .describe('Live non-terminal turn state (paused or running).'),created_at: z.string().describe('ISO 8601 event timestamp.'),thread_id: z.string().nullable().describe('Thread that owns the event; null for turn-level lifecycle events.'),})@@ -117,6 +95,7 @@ export const SessionEventSchema = zUserToolApprovalEventSchema,UserToolResponseEventSchema,UserToolApprovalPolicyEventSchema,+ UserMCPAuthContinueEventSchema,]).openapi('SessionEvent');diff --git a/packages/trueforge-core/src/agent-session/schemas/turn.ts b/packages/trueforge-core/src/agent-session/schemas/turn.tsindex dd6d6dec6..31073c32b 100644--- a/packages/trueforge-core/src/agent-session/schemas/turn.ts+++ b/packages/trueforge-core/src/agent-session/schemas/turn.ts@@ -3,7 +3,9 @@ import { z } from '@hono/zod-openapi';import {ActionRequiredEventSchema,AgentInputUserMessageSchema,+ EventIdSchema,ModelMessageEventSchema,+ UserMCPAuthContinueMessageSchema,UserToolApprovalMessageSchema,UserToolApprovalPolicyMessageSchema,UserToolResponseMessageSchema,@@ -26,6 +28,21 @@ export const TurnStateRunningSchema = z}).openapi('TurnStateRunning');+export const ActionRequiredSchema = z+ .object({+ id: EventIdSchema,+ })+ .openapi('ActionRequired');++export const TurnStatePausedSchema = z+ .object({+ status: z.literal('paused').describe('Turn is paused waiting for required actions.'),+ action_required_on_events: z+ .array(ActionRequiredSchema)+ .describe('Events that still need a user or client action.'),+ })+ .openapi('TurnStatePaused');+export const TurnStateCancelledReasonSchema = z.enum(CancellationReason).describe('Reason for the cancellation.')@@ -94,10 +111,10 @@ export const TurnStateErrorSchema = zexport const TurnStateDoneSchema = z.object({- status: z.literal('done').describe('Turn finished (possibly paused for required actions).'),+ status: z.literal('done').describe('Turn finished with no open required actions.'),output: z.union([ModelMessageEventSchema, z.null()])- .describe('Final `model.message` for the turn, or null when the turn ended paused without a final message.'),+ .describe('Final `model.message` for the turn, or null when the turn ended without a final message.'),required_actions: z.array(ActionRequiredEventSchema).describe(@@ -111,6 +128,7 @@ export const TurnStateDoneSchema = zexport const TurnStateSchema = z.discriminatedUnion('status', [TurnStateRunningSchema,+ TurnStatePausedSchema,TurnStateDoneSchema,TurnStateCancelledSchema,TurnStateErrorSchema,@@ -182,12 +200,13 @@ export const TurnInboundEventItemSchema = zUserToolApprovalMessageSchema,UserToolResponseMessageSchema,UserToolApprovalPolicyMessageSchema,+ UserMCPAuthContinueMessageSchema,]).openapi('TurnInboundEventItem');export type Turn = z.infer<typeof TurnSchema>;export type TurnInputItem = z.infer<typeof TurnInputItemSchema>;export type TurnState = z.infer<typeof TurnStateSchema>;-export type TerminalTurnState = Exclude<TurnState, { status: 'running' }>;+export type TerminalTurnState = Exclude<TurnState, { status: 'running' | 'paused' }>;export type TurnMetrics = z.infer<typeof TurnMetricsSchema>;export type TurnInboundEventItem = z.infer<typeof TurnInboundEventItemSchema>;diff --git a/packages/trueforge-core/src/agent-session/store/InMemorySessionStore.ts b/packages/trueforge-core/src/agent-session/store/InMemorySessionStore.tsindex 88ee5b224..a0a19615a 100644--- a/packages/trueforge-core/src/agent-session/store/InMemorySessionStore.ts+++ b/packages/trueforge-core/src/agent-session/store/InMemorySessionStore.ts@@ -475,6 +475,9 @@ export class InMemorySessionStore<// Same as createTurn: synchronous body ⇒ atomic under run-to-completion.const tKey = turnKey(input);const turn = this.requireTurn(input.session_id, input.turn_id);+ if (turn.state.status === 'paused') {+ throw new SessionStoreInvariantError(`expected running state for turn ${input.turn_id}, got paused`);+ }if (turn.state.status !== 'running') {throw new TurnNotRunningError(input.turn_id, turn.state);}@@ -564,6 +567,9 @@ export class InMemorySessionStore<private requireRunningTurn(sessionId: string, turnId: string): TurnRecord<TTurnCustom> {const turn = this.requireTurn(sessionId, turnId);+ if (turn.state.status === 'paused') {+ throw new SessionStoreInvariantError(`expected running state for turn ${turnId}, got paused`);+ }if (turn.state.status !== 'running') {throw new TurnNotRunningError(turnId, turn.state);}diff --git a/packages/trueforge-core/src/core/events/schema.ts b/packages/trueforge-core/src/core/events/schema.tsindex a5e9ee9a8..8c629e613 100644--- a/packages/trueforge-core/src/core/events/schema.ts+++ b/packages/trueforge-core/src/core/events/schema.ts@@ -41,6 +41,7 @@ export const EventType = {USER_TOOL_APPROVAL: 'user.tool_approval',USER_TOOL_RESPONSE: 'user.tool_response',USER_TOOL_APPROVAL_POLICY: 'user.tool_approval_policy',+ USER_MCP_AUTH_CONTINUE: 'user.mcp_auth_continue',USER_MESSAGE: 'user.message',} as const;@@ -124,6 +125,14 @@ export const UserToolApprovalPolicyMessageSchema = z}).openapi('UserToolApprovalPolicyMessage');+export const UserMCPAuthContinueMessageSchema = z+ .object({+ type: z+ .literal(EventType.USER_MCP_AUTH_CONTINUE)+ .describe('Client resume after mcp.auth_required (OAuth completed).'),+ })+ .openapi('UserMCPAuthContinueInputEvent');+/** Durable / SSE form of {@link UserToolApprovalMessageSchema}. */export const UserToolApprovalEventSchema = z.object({@@ -151,6 +160,15 @@ export const UserToolApprovalPolicyEventSchema = z}).openapi('UserToolApprovalPolicyEvent');+/** Durable / SSE form of {@link UserMCPAuthContinueMessageSchema}. */+export const UserMCPAuthContinueEventSchema = z+ .object({+ ...UserMCPAuthContinueMessageSchema.shape,+ id: EventIdSchema,+ created_at: z.string().describe('ISO 8601 event timestamp.'),+ })+ .openapi('UserMCPAuthContinueEvent');+export const TextContentPartSchema = z.object({type: z.literal('text').describe('Text content part.'),@@ -433,6 +451,8 @@ export type UserToolApprovalPolicyMessage = z.infer<typeof UserToolApprovalPolicexport type UserToolApprovalEvent = z.infer<typeof UserToolApprovalEventSchema>;export type UserToolResponseEvent = z.infer<typeof UserToolResponseEventSchema>;export type UserToolApprovalPolicyEvent = z.infer<typeof UserToolApprovalPolicyEventSchema>;+export type UserMCPAuthContinueMessage = z.infer<typeof UserMCPAuthContinueMessageSchema>;+export type UserMCPAuthContinueEvent = z.infer<typeof UserMCPAuthContinueEventSchema>;export type AgentApprovalDecisionMessage = z.infer<typeof AgentApprovalDecisionMessageSchema>;export type InputTokensBreakdown = z.infer<typeof InputTokensBreakdownSchema>;export type ModelMessageUsage = z.infer<typeof ModelMessageUsageSchema>;diff --git a/packages/trueforge-core/src/core/index.ts b/packages/trueforge-core/src/core/index.tsindex 2a6fdf465..3ac1e3947 100644--- a/packages/trueforge-core/src/core/index.ts+++ b/packages/trueforge-core/src/core/index.ts@@ -113,6 +113,8 @@ export {ToolApprovalRequiredEventSchema,ToolResponseEventSchema,ToolResponseRequiredEventSchema,+ UserMCPAuthContinueEventSchema,+ UserMCPAuthContinueMessageSchema,UserToolApprovalEventSchema,UserToolApprovalMessageSchema,UserToolApprovalPolicyEventSchema,@@ -128,6 +130,8 @@ export type {MCPServerInitInfo,ThreadDoneEvent,ThreadOverwriteContextEvent,+ UserMCPAuthContinueEvent,+ UserMCPAuthContinueMessage,UserToolApprovalEvent,UserToolApprovalPolicyEvent,UserToolApprovalPolicyMessage,diff --git a/packages/trueforge-sdk/reference.md b/packages/trueforge-sdk/reference.mdindex 18f7dec6d..40b7f73b3 100644--- a/packages/trueforge-sdk/reference.md+++ b/packages/trueforge-sdk/reference.md@@ -2399,12 +2399,7 @@ Create events for a turn. Only the session creator may create them.```typescriptawait client.sessions.createTurnEvent("session_id", "turn_id", {events: [{- approval: {- status: "allow"- },- threadId: "thread_id",- toolCallId: "tool_call_id",- type: "user.tool_approval"+ type: "user.mcp_auth_continue"}]});diff --git a/packages/trueforge-sdk/src/api/resources/sessions/client/Client.ts b/packages/trueforge-sdk/src/api/resources/sessions/client/Client.tsindex e7fd1c4d2..877b563c8 100644--- a/packages/trueforge-sdk/src/api/resources/sessions/client/Client.ts+++ b/packages/trueforge-sdk/src/api/resources/sessions/client/Client.ts@@ -1760,12 +1760,7 @@ export class SessionsClient {* @example* await client.sessions.createTurnEvent("session_id", "turn_id", {* events: [{- * approval: {- * status: "allow"- * },- * threadId: "thread_id",- * toolCallId: "tool_call_id",- * type: "user.tool_approval"+ * type: "user.mcp_auth_continue"* }]* })*/diff --git a/packages/trueforge-sdk/src/api/resources/sessions/client/requests/CreateTurnEventRequest.ts b/packages/trueforge-sdk/src/api/resources/sessions/client/requests/CreateTurnEventRequest.tsindex 3424eae7f..8d0598076 100644--- a/packages/trueforge-sdk/src/api/resources/sessions/client/requests/CreateTurnEventRequest.ts+++ b/packages/trueforge-sdk/src/api/resources/sessions/client/requests/CreateTurnEventRequest.ts@@ -6,16 +6,11 @@ import type * as TrueForge from "../../../../index.js";* @example* {* events: [{- * approval: {- * status: "allow"- * },- * threadId: "thread_id",- * toolCallId: "tool_call_id",- * type: "user.tool_approval"+ * type: "user.mcp_auth_continue"* }]* }*/export interface CreateTurnEventRequest {- /** One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`). */+ /** One or more user events. */events: TrueForge.TurnInboundEventItem[];}diff --git a/packages/trueforge-sdk/src/api/types/CreateTurnEventResponseDataItem.ts b/packages/trueforge-sdk/src/api/types/CreateTurnEventResponseDataItem.tsindex c7632854a..ef8e5b113 100644--- a/packages/trueforge-sdk/src/api/types/CreateTurnEventResponseDataItem.ts+++ b/packages/trueforge-sdk/src/api/types/CreateTurnEventResponseDataItem.ts@@ -3,6 +3,7 @@import type * as TrueForge from "../index.js";export type CreateTurnEventResponseDataItem =+ | TrueForge.UserMcpAuthContinueEvent| TrueForge.UserToolApprovalEvent| TrueForge.UserToolApprovalPolicyEvent| TrueForge.UserToolResponseEvent;diff --git a/packages/trueforge-sdk/src/api/types/SessionEvent.ts b/packages/trueforge-sdk/src/api/types/SessionEvent.tsindex d47a36b5b..5bb09576a 100644--- a/packages/trueforge-sdk/src/api/types/SessionEvent.ts+++ b/packages/trueforge-sdk/src/api/types/SessionEvent.ts@@ -15,6 +15,7 @@ export type SessionEvent =| TrueForge.TurnCreatedEvent| TrueForge.TurnDoneEvent| TrueForge.TurnUpdateEvent+ | TrueForge.UserMcpAuthContinueEvent| TrueForge.UserToolApprovalEvent| TrueForge.UserToolApprovalPolicyEvent| TrueForge.UserToolResponseEvent;diff --git a/packages/trueforge-sdk/src/api/types/TurnInboundEventItem.ts b/packages/trueforge-sdk/src/api/types/TurnInboundEventItem.tsindex 70bc1cae6..1f7d4d71b 100644--- a/packages/trueforge-sdk/src/api/types/TurnInboundEventItem.ts+++ b/packages/trueforge-sdk/src/api/types/TurnInboundEventItem.ts@@ -3,6 +3,7 @@import type * as TrueForge from "../index.js";export type TurnInboundEventItem =+ | TrueForge.UserMcpAuthContinueInputEvent| TrueForge.UserToolApprovalInputEvent| TrueForge.UserToolApprovalPolicyMessage| TrueForge.UserToolResponseInputEvent;diff --git a/packages/trueforge-sdk/src/api/types/TurnState.ts b/packages/trueforge-sdk/src/api/types/TurnState.tsindex 1d1ff9611..eef55f805 100644--- a/packages/trueforge-sdk/src/api/types/TurnState.ts+++ b/packages/trueforge-sdk/src/api/types/TurnState.ts@@ -6,4 +6,5 @@ export type TurnState =| TrueForge.TurnStateCancelled| TrueForge.TurnStateDone| TrueForge.TurnStateError+ | TrueForge.TurnStatePaused| TrueForge.TurnStateRunning;diff --git a/packages/trueforge-sdk/src/api/types/TurnStateDone.ts b/packages/trueforge-sdk/src/api/types/TurnStateDone.tsindex d8d10966a..c0a5e6747 100644--- a/packages/trueforge-sdk/src/api/types/TurnStateDone.ts+++ b/packages/trueforge-sdk/src/api/types/TurnStateDone.ts@@ -6,7 +6,7 @@ export interface TurnStateDone {/** ISO 8601 time when the turn reached a terminal state. */completedAt: string;metrics?: TrueForge.TurnMetrics;- /** Final `model.message` for the turn, or null when the turn ended paused without a final message. */+ /** Final `model.message` for the turn, or null when the turn ended without a final message. */output: TrueForge.ModelMessageEvent | null;/** Pending actions (`tool.approval_required`, `tool.response_required`, `mcp.auth_required`); empty when none. */requiredActions: TrueForge.ActionRequiredEvent[];diff --git a/packages/trueforge-sdk/src/api/types/TurnUpdateStatePaused.ts b/packages/trueforge-sdk/src/api/types/TurnStatePaused.tssimilarity index 86%rename from packages/trueforge-sdk/src/api/types/TurnUpdateStatePaused.tsrename to packages/trueforge-sdk/src/api/types/TurnStatePaused.tsindex 6610360e2..20725659e 100644--- a/packages/trueforge-sdk/src/api/types/TurnUpdateStatePaused.ts+++ b/packages/trueforge-sdk/src/api/types/TurnStatePaused.ts@@ -2,7 +2,7 @@import type * as TrueForge from "../index.js";-export interface TurnUpdateStatePaused {+export interface TurnStatePaused {/** Events that still need a user or client action. */actionRequiredOnEvents: TrueForge.ActionRequired[];status: "paused";diff --git a/packages/trueforge-sdk/src/api/types/TurnStreamingEvent.ts b/packages/trueforge-sdk/src/api/types/TurnStreamingEvent.tsindex 35de83b0b..f1ccddd58 100644--- a/packages/trueforge-sdk/src/api/types/TurnStreamingEvent.ts+++ b/packages/trueforge-sdk/src/api/types/TurnStreamingEvent.ts@@ -16,6 +16,7 @@ export type TurnStreamingEvent =| TrueForge.TurnCreatedEvent| TrueForge.TurnDoneEvent| TrueForge.TurnUpdateEvent+ | TrueForge.UserMcpAuthContinueEvent| TrueForge.UserToolApprovalEvent| TrueForge.UserToolApprovalPolicyEvent| TrueForge.UserToolResponseEvent;diff --git a/packages/trueforge-sdk/src/api/types/TurnUpdateEvent.ts b/packages/trueforge-sdk/src/api/types/TurnUpdateEvent.tsindex 3b6bf0f46..9dd2da390 100644--- a/packages/trueforge-sdk/src/api/types/TurnUpdateEvent.ts+++ b/packages/trueforge-sdk/src/api/types/TurnUpdateEvent.ts@@ -7,7 +7,8 @@ export interface TurnUpdateEvent {createdAt: string;/** Unique identifier for the event (monotonic ULID). */id: string;- state: TrueForge.TurnUpdateState;+ /** Live non-terminal turn state (paused or running). */+ state: TrueForge.TurnUpdateEventState;/** Thread that owns the event; null for turn-level lifecycle events. */threadId: string | null;type: "turn.update";diff --git a/packages/trueforge-sdk/src/api/types/TurnUpdateEventState.ts b/packages/trueforge-sdk/src/api/types/TurnUpdateEventState.tsnew file mode 100644index 000000000..e9254b9a7--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/TurnUpdateEventState.ts@@ -0,0 +1,8 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../index.js";++/**+ * Live non-terminal turn state (paused or running).+ */+export type TurnUpdateEventState = TrueForge.TurnStatePaused | TrueForge.TurnStateRunning;diff --git a/packages/trueforge-sdk/src/api/types/TurnUpdateState.ts b/packages/trueforge-sdk/src/api/types/TurnUpdateState.tsdeleted file mode 100644index 86c4d0e0e..000000000--- a/packages/trueforge-sdk/src/api/types/TurnUpdateState.ts+++ /dev/null@@ -1,8 +0,0 @@-// This file was auto-generated by Fern from our API Definition.--import type * as TrueForge from "../index.js";--/**- * Live non-terminal turn status.- */-export type TurnUpdateState = TrueForge.TurnUpdateStatePaused | TrueForge.TurnUpdateStateRunning;diff --git a/packages/trueforge-sdk/src/api/types/TurnUpdateStateRunning.ts b/packages/trueforge-sdk/src/api/types/TurnUpdateStateRunning.tsdeleted file mode 100644index bb4be8e7f..000000000--- a/packages/trueforge-sdk/src/api/types/TurnUpdateStateRunning.ts+++ /dev/null@@ -1,5 +0,0 @@-// This file was auto-generated by Fern from our API Definition.--export interface TurnUpdateStateRunning {- status: "running";-}diff --git a/packages/trueforge-sdk/src/api/types/UserMcpAuthContinueEvent.ts b/packages/trueforge-sdk/src/api/types/UserMcpAuthContinueEvent.tsnew file mode 100644index 000000000..1d4542ed9--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/UserMcpAuthContinueEvent.ts@@ -0,0 +1,9 @@+// This file was auto-generated by Fern from our API Definition.++export interface UserMcpAuthContinueEvent {+ /** ISO 8601 event timestamp. */+ createdAt: string;+ /** Unique identifier for the event (monotonic ULID). */+ id: string;+ type: "user.mcp_auth_continue";+}diff --git a/packages/trueforge-sdk/src/api/types/UserMcpAuthContinueInputEvent.ts b/packages/trueforge-sdk/src/api/types/UserMcpAuthContinueInputEvent.tsnew file mode 100644index 000000000..77f012759--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/UserMcpAuthContinueInputEvent.ts@@ -0,0 +1,5 @@+// This file was auto-generated by Fern from our API Definition.++export interface UserMcpAuthContinueInputEvent {+ type: "user.mcp_auth_continue";+}diff --git a/packages/trueforge-sdk/src/api/types/index.ts b/packages/trueforge-sdk/src/api/types/index.tsindex 77eafba9e..733cc6cdb 100644--- a/packages/trueforge-sdk/src/api/types/index.ts+++ b/packages/trueforge-sdk/src/api/types/index.ts@@ -231,12 +231,13 @@ export * from "./TurnStateCancelledReason.js";export * from "./TurnStateDone.js";export * from "./TurnStateError.js";export * from "./TurnStateErrorMetrics.js";+export * from "./TurnStatePaused.js";export * from "./TurnStateRunning.js";export * from "./TurnStreamingEvent.js";export * from "./TurnUpdateEvent.js";-export * from "./TurnUpdateState.js";-export * from "./TurnUpdateStatePaused.js";-export * from "./TurnUpdateStateRunning.js";+export * from "./TurnUpdateEventState.js";+export * from "./UserMcpAuthContinueEvent.js";+export * from "./UserMcpAuthContinueInputEvent.js";export * from "./UserMessage.js";export * from "./UserMessageContent.js";export * from "./UserMessageContentItem.js";diff --git a/packages/trueforge-sdk/src/serialization/types/CreateTurnEventResponseDataItem.ts b/packages/trueforge-sdk/src/serialization/types/CreateTurnEventResponseDataItem.tsindex 5f8ccdb9b..df1ba4815 100644--- a/packages/trueforge-sdk/src/serialization/types/CreateTurnEventResponseDataItem.ts+++ b/packages/trueforge-sdk/src/serialization/types/CreateTurnEventResponseDataItem.ts@@ -3,6 +3,7 @@import type * as TrueForge from "../../api/index.js";import * as core from "../../core/index.js";import type * as serializers from "../index.js";+import { UserMcpAuthContinueEvent } from "./UserMcpAuthContinueEvent.js";import { UserToolApprovalEvent } from "./UserToolApprovalEvent.js";import { UserToolApprovalPolicyEvent } from "./UserToolApprovalPolicyEvent.js";import { UserToolResponseEvent } from "./UserToolResponseEvent.js";@@ -11,11 +12,16 @@ export const CreateTurnEventResponseDataItem: core.serialization.Schema<serializers.CreateTurnEventResponseDataItem.Raw,TrueForge.CreateTurnEventResponseDataItem> = core.serialization.undiscriminatedUnion([+ UserMcpAuthContinueEvent,UserToolApprovalEvent,UserToolApprovalPolicyEvent,UserToolResponseEvent,]);export declare namespace CreateTurnEventResponseDataItem {- export type Raw = UserToolApprovalEvent.Raw | UserToolApprovalPolicyEvent.Raw | UserToolResponseEvent.Raw;+ export type Raw =+ | UserMcpAuthContinueEvent.Raw+ | UserToolApprovalEvent.Raw+ | UserToolApprovalPolicyEvent.Raw+ | UserToolResponseEvent.Raw;}diff --git a/packages/trueforge-sdk/src/serialization/types/SessionEvent.ts b/packages/trueforge-sdk/src/serialization/types/SessionEvent.tsindex 68d0482fc..4fb51638e 100644--- a/packages/trueforge-sdk/src/serialization/types/SessionEvent.ts+++ b/packages/trueforge-sdk/src/serialization/types/SessionEvent.ts@@ -15,6 +15,7 @@ import { ToolResponseRequiredEvent } from "./ToolResponseRequiredEvent.js";import { TurnCreatedEvent } from "./TurnCreatedEvent.js";import { TurnDoneEvent } from "./TurnDoneEvent.js";import { TurnUpdateEvent } from "./TurnUpdateEvent.js";+import { UserMcpAuthContinueEvent } from "./UserMcpAuthContinueEvent.js";import { UserToolApprovalEvent } from "./UserToolApprovalEvent.js";import { UserToolApprovalPolicyEvent } from "./UserToolApprovalPolicyEvent.js";import { UserToolResponseEvent } from "./UserToolResponseEvent.js";@@ -33,6 +34,7 @@ export const SessionEvent: core.serialization.Schema<serializers.SessionEvent.RaTurnCreatedEvent,TurnDoneEvent,TurnUpdateEvent,+ UserMcpAuthContinueEvent,UserToolApprovalEvent,UserToolApprovalPolicyEvent,UserToolResponseEvent,@@ -52,6 +54,7 @@ export declare namespace SessionEvent {| TurnCreatedEvent.Raw| TurnDoneEvent.Raw| TurnUpdateEvent.Raw+ | UserMcpAuthContinueEvent.Raw| UserToolApprovalEvent.Raw| UserToolApprovalPolicyEvent.Raw| UserToolResponseEvent.Raw;diff --git a/packages/trueforge-sdk/src/serialization/types/TurnInboundEventItem.ts b/packages/trueforge-sdk/src/serialization/types/TurnInboundEventItem.tsindex 4865759c9..b5b585af1 100644--- a/packages/trueforge-sdk/src/serialization/types/TurnInboundEventItem.ts+++ b/packages/trueforge-sdk/src/serialization/types/TurnInboundEventItem.ts@@ -3,6 +3,7 @@import type * as TrueForge from "../../api/index.js";import * as core from "../../core/index.js";import type * as serializers from "../index.js";+import { UserMcpAuthContinueInputEvent } from "./UserMcpAuthContinueInputEvent.js";import { UserToolApprovalInputEvent } from "./UserToolApprovalInputEvent.js";import { UserToolApprovalPolicyMessage } from "./UserToolApprovalPolicyMessage.js";import { UserToolResponseInputEvent } from "./UserToolResponseInputEvent.js";@@ -11,6 +12,7 @@ export const TurnInboundEventItem: core.serialization.Schema<serializers.TurnInboundEventItem.Raw,TrueForge.TurnInboundEventItem> = core.serialization.undiscriminatedUnion([+ UserMcpAuthContinueInputEvent,UserToolApprovalInputEvent,UserToolApprovalPolicyMessage,UserToolResponseInputEvent,@@ -18,6 +20,7 @@ export const TurnInboundEventItem: core.serialization.Schema<export declare namespace TurnInboundEventItem {export type Raw =+ | UserMcpAuthContinueInputEvent.Raw| UserToolApprovalInputEvent.Raw| UserToolApprovalPolicyMessage.Raw| UserToolResponseInputEvent.Raw;diff --git a/packages/trueforge-sdk/src/serialization/types/TurnState.ts b/packages/trueforge-sdk/src/serialization/types/TurnState.tsindex 252cd55c6..189a23194 100644--- a/packages/trueforge-sdk/src/serialization/types/TurnState.ts+++ b/packages/trueforge-sdk/src/serialization/types/TurnState.ts@@ -6,11 +6,23 @@ import type * as serializers from "../index.js";import { TurnStateCancelled } from "./TurnStateCancelled.js";import { TurnStateDone } from "./TurnStateDone.js";import { TurnStateError } from "./TurnStateError.js";+import { TurnStatePaused } from "./TurnStatePaused.js";import { TurnStateRunning } from "./TurnStateRunning.js";export const TurnState: core.serialization.Schema<serializers.TurnState.Raw, TrueForge.TurnState> =- core.serialization.undiscriminatedUnion([TurnStateCancelled, TurnStateDone, TurnStateError, TurnStateRunning]);+ core.serialization.undiscriminatedUnion([+ TurnStateCancelled,+ TurnStateDone,+ TurnStateError,+ TurnStatePaused,+ TurnStateRunning,+ ]);export declare namespace TurnState {- export type Raw = TurnStateCancelled.Raw | TurnStateDone.Raw | TurnStateError.Raw | TurnStateRunning.Raw;+ export type Raw =+ | TurnStateCancelled.Raw+ | TurnStateDone.Raw+ | TurnStateError.Raw+ | TurnStatePaused.Raw+ | TurnStateRunning.Raw;}diff --git a/packages/trueforge-sdk/src/serialization/types/TurnUpdateStatePaused.ts b/packages/trueforge-sdk/src/serialization/types/TurnStatePaused.tssimilarity index 76%rename from packages/trueforge-sdk/src/serialization/types/TurnUpdateStatePaused.tsrename to packages/trueforge-sdk/src/serialization/types/TurnStatePaused.tsindex 9642f6075..a73aeb5fc 100644--- a/packages/trueforge-sdk/src/serialization/types/TurnUpdateStatePaused.ts+++ b/packages/trueforge-sdk/src/serialization/types/TurnStatePaused.ts@@ -5,9 +5,9 @@ import * as core from "../../core/index.js";import type * as serializers from "../index.js";import { ActionRequired } from "./ActionRequired.js";-export const TurnUpdateStatePaused: core.serialization.ObjectSchema<- serializers.TurnUpdateStatePaused.Raw,- TrueForge.TurnUpdateStatePaused+export const TurnStatePaused: core.serialization.ObjectSchema<+ serializers.TurnStatePaused.Raw,+ TrueForge.TurnStatePaused> = core.serialization.object({actionRequiredOnEvents: core.serialization.property("action_required_on_events",@@ -16,7 +16,7 @@ export const TurnUpdateStatePaused: core.serialization.ObjectSchema<status: core.serialization.stringLiteral("paused"),});-export declare namespace TurnUpdateStatePaused {+export declare namespace TurnStatePaused {export interface Raw {action_required_on_events: ActionRequired.Raw[];status: "paused";diff --git a/packages/trueforge-sdk/src/serialization/types/TurnStreamingEvent.ts b/packages/trueforge-sdk/src/serialization/types/TurnStreamingEvent.tsindex d160ee721..02fd11d0c 100644--- a/packages/trueforge-sdk/src/serialization/types/TurnStreamingEvent.ts+++ b/packages/trueforge-sdk/src/serialization/types/TurnStreamingEvent.ts@@ -16,6 +16,7 @@ import { ToolResponseRequiredEvent } from "./ToolResponseRequiredEvent.js";import { TurnCreatedEvent } from "./TurnCreatedEvent.js";import { TurnDoneEvent } from "./TurnDoneEvent.js";import { TurnUpdateEvent } from "./TurnUpdateEvent.js";+import { UserMcpAuthContinueEvent } from "./UserMcpAuthContinueEvent.js";import { UserToolApprovalEvent } from "./UserToolApprovalEvent.js";import { UserToolApprovalPolicyEvent } from "./UserToolApprovalPolicyEvent.js";import { UserToolResponseEvent } from "./UserToolResponseEvent.js";@@ -37,6 +38,7 @@ export const TurnStreamingEvent: core.serialization.Schema<TurnCreatedEvent,TurnDoneEvent,TurnUpdateEvent,+ UserMcpAuthContinueEvent,UserToolApprovalEvent,UserToolApprovalPolicyEvent,UserToolResponseEvent,@@ -57,6 +59,7 @@ export declare namespace TurnStreamingEvent {| TurnCreatedEvent.Raw| TurnDoneEvent.Raw| TurnUpdateEvent.Raw+ | UserMcpAuthContinueEvent.Raw| UserToolApprovalEvent.Raw| UserToolApprovalPolicyEvent.Raw| UserToolResponseEvent.Raw;diff --git a/packages/trueforge-sdk/src/serialization/types/TurnUpdateEvent.ts b/packages/trueforge-sdk/src/serialization/types/TurnUpdateEvent.tsindex 84357a566..bd3497db4 100644--- a/packages/trueforge-sdk/src/serialization/types/TurnUpdateEvent.ts+++ b/packages/trueforge-sdk/src/serialization/types/TurnUpdateEvent.ts@@ -3,7 +3,7 @@import type * as TrueForge from "../../api/index.js";import * as core from "../../core/index.js";import type * as serializers from "../index.js";-import { TurnUpdateState } from "./TurnUpdateState.js";+import { TurnUpdateEventState } from "./TurnUpdateEventState.js";export const TurnUpdateEvent: core.serialization.ObjectSchema<serializers.TurnUpdateEvent.Raw,@@ -11,7 +11,7 @@ export const TurnUpdateEvent: core.serialization.ObjectSchema<> = core.serialization.object({createdAt: core.serialization.property("created_at", core.serialization.string()),id: core.serialization.string(),- state: TurnUpdateState,+ state: TurnUpdateEventState,threadId: core.serialization.property("thread_id", core.serialization.string().nullable()),type: core.serialization.stringLiteral("turn.update"),});@@ -20,7 +20,7 @@ export declare namespace TurnUpdateEvent {export interface Raw {created_at: string;id: string;- state: TurnUpdateState.Raw;+ state: TurnUpdateEventState.Raw;thread_id?: string | null;type: "turn.update";}diff --git a/packages/trueforge-sdk/src/serialization/types/TurnUpdateEventState.ts b/packages/trueforge-sdk/src/serialization/types/TurnUpdateEventState.tsnew file mode 100644index 000000000..c9f8a211e--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/TurnUpdateEventState.ts@@ -0,0 +1,16 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../../api/index.js";+import * as core from "../../core/index.js";+import type * as serializers from "../index.js";+import { TurnStatePaused } from "./TurnStatePaused.js";+import { TurnStateRunning } from "./TurnStateRunning.js";++export const TurnUpdateEventState: core.serialization.Schema<+ serializers.TurnUpdateEventState.Raw,+ TrueForge.TurnUpdateEventState+> = core.serialization.undiscriminatedUnion([TurnStatePaused, TurnStateRunning]);++export declare namespace TurnUpdateEventState {+ export type Raw = TurnStatePaused.Raw | TurnStateRunning.Raw;+}diff --git a/packages/trueforge-sdk/src/serialization/types/TurnUpdateState.ts b/packages/trueforge-sdk/src/serialization/types/TurnUpdateState.tsdeleted file mode 100644index d6f59a863..000000000--- a/packages/trueforge-sdk/src/serialization/types/TurnUpdateState.ts+++ /dev/null@@ -1,14 +0,0 @@-// This file was auto-generated by Fern from our API Definition.--import type * as TrueForge from "../../api/index.js";-import * as core from "../../core/index.js";-import type * as serializers from "../index.js";-import { TurnUpdateStatePaused } from "./TurnUpdateStatePaused.js";-import { TurnUpdateStateRunning } from "./TurnUpdateStateRunning.js";--export const TurnUpdateState: core.serialization.Schema<serializers.TurnUpdateState.Raw, TrueForge.TurnUpdateState> =- core.serialization.undiscriminatedUnion([TurnUpdateStatePaused, TurnUpdateStateRunning]);--export declare namespace TurnUpdateState {- export type Raw = TurnUpdateStatePaused.Raw | TurnUpdateStateRunning.Raw;-}diff --git a/packages/trueforge-sdk/src/serialization/types/TurnUpdateStateRunning.ts b/packages/trueforge-sdk/src/serialization/types/TurnUpdateStateRunning.tsdeleted file mode 100644index 426582c85..000000000--- a/packages/trueforge-sdk/src/serialization/types/TurnUpdateStateRunning.ts+++ /dev/null@@ -1,18 +0,0 @@-// This file was auto-generated by Fern from our API Definition.--import type * as TrueForge from "../../api/index.js";-import * as core from "../../core/index.js";-import type * as serializers from "../index.js";--export const TurnUpdateStateRunning: core.serialization.ObjectSchema<- serializers.TurnUpdateStateRunning.Raw,- TrueForge.TurnUpdateStateRunning-> = core.serialization.object({- status: core.serialization.stringLiteral("running"),-});--export declare namespace TurnUpdateStateRunning {- export interface Raw {- status: "running";- }-}diff --git a/packages/trueforge-sdk/src/serialization/types/UserMcpAuthContinueEvent.ts b/packages/trueforge-sdk/src/serialization/types/UserMcpAuthContinueEvent.tsnew file mode 100644index 000000000..edd96cc99--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/UserMcpAuthContinueEvent.ts@@ -0,0 +1,22 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../../api/index.js";+import * as core from "../../core/index.js";+import type * as serializers from "../index.js";++export const UserMcpAuthContinueEvent: core.serialization.ObjectSchema<+ serializers.UserMcpAuthContinueEvent.Raw,+ TrueForge.UserMcpAuthContinueEvent+> = core.serialization.object({+ createdAt: core.serialization.property("created_at", core.serialization.string()),+ id: core.serialization.string(),+ type: core.serialization.stringLiteral("user.mcp_auth_continue"),+});++export declare namespace UserMcpAuthContinueEvent {+ export interface Raw {+ created_at: string;+ id: string;+ type: "user.mcp_auth_continue";+ }+}diff --git a/packages/trueforge-sdk/src/serialization/types/UserMcpAuthContinueInputEvent.ts b/packages/trueforge-sdk/src/serialization/types/UserMcpAuthContinueInputEvent.tsnew file mode 100644index 000000000..aa5992996--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/UserMcpAuthContinueInputEvent.ts@@ -0,0 +1,18 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../../api/index.js";+import * as core from "../../core/index.js";+import type * as serializers from "../index.js";++export const UserMcpAuthContinueInputEvent: core.serialization.ObjectSchema<+ serializers.UserMcpAuthContinueInputEvent.Raw,+ TrueForge.UserMcpAuthContinueInputEvent+> = core.serialization.object({+ type: core.serialization.stringLiteral("user.mcp_auth_continue"),+});++export declare namespace UserMcpAuthContinueInputEvent {+ export interface Raw {+ type: "user.mcp_auth_continue";+ }+}diff --git a/packages/trueforge-sdk/src/serialization/types/index.ts b/packages/trueforge-sdk/src/serialization/types/index.tsindex 77eafba9e..733cc6cdb 100644--- a/packages/trueforge-sdk/src/serialization/types/index.ts+++ b/packages/trueforge-sdk/src/serialization/types/index.ts@@ -231,12 +231,13 @@ export * from "./TurnStateCancelledReason.js";export * from "./TurnStateDone.js";export * from "./TurnStateError.js";export * from "./TurnStateErrorMetrics.js";+export * from "./TurnStatePaused.js";export * from "./TurnStateRunning.js";export * from "./TurnStreamingEvent.js";export * from "./TurnUpdateEvent.js";-export * from "./TurnUpdateState.js";-export * from "./TurnUpdateStatePaused.js";-export * from "./TurnUpdateStateRunning.js";+export * from "./TurnUpdateEventState.js";+export * from "./UserMcpAuthContinueEvent.js";+export * from "./UserMcpAuthContinueInputEvent.js";export * from "./UserMessage.js";export * from "./UserMessageContent.js";export * from "./UserMessageContentItem.js";diff --git a/packages/trueforge-sdk/tests/wire/sessions.test.ts b/packages/trueforge-sdk/tests/wire/sessions.test.tsindex 1c585abaa..19226ab2f 100644--- a/packages/trueforge-sdk/tests/wire/sessions.test.ts+++ b/packages/trueforge-sdk/tests/wire/sessions.test.ts@@ -1401,28 +1401,8 @@ describe("SessionsClient", () => {test("create_turn_event (1)", async () => {const server = mockServerPool.createServer();const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });- const rawRequestBody = {- events: [- {- approval: { status: "allow" },- thread_id: "thread_id",- tool_call_id: "tool_call_id",- type: "user.tool_approval",- },- ],- };- const rawResponseBody = {- data: [- {- approval: { status: "allow" },- created_at: "created_at",- id: "id",- thread_id: "thread_id",- tool_call_id: "tool_call_id",- type: "user.tool_approval",- },- ],- };+ const rawRequestBody = { events: [{ type: "user.mcp_auth_continue" }] };+ const rawResponseBody = { data: [{ created_at: "created_at", id: "id", type: "user.mcp_auth_continue" }] };server.mockEndpoint()@@ -1436,26 +1416,16 @@ describe("SessionsClient", () => {const response = await client.sessions.createTurnEvent("session_id", "turn_id", {events: [{- approval: {- status: "allow",- },- threadId: "thread_id",- toolCallId: "tool_call_id",- type: "user.tool_approval",+ type: "user.mcp_auth_continue",},],});expect(response).toEqual({data: [{- approval: {- status: "allow",- },createdAt: "created_at",id: "id",- threadId: "thread_id",- toolCallId: "tool_call_id",- type: "user.tool_approval",+ type: "user.mcp_auth_continue",},],});@@ -1464,12 +1434,7 @@ describe("SessionsClient", () => {test("create_turn_event (2)", async () => {const server = mockServerPool.createServer();const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });- const rawRequestBody = {- events: [- { approval: { status: "allow" }, thread_id: "x", tool_call_id: "x", type: "user.tool_approval" },- { approval: { status: "allow" }, thread_id: "x", tool_call_id: "x", type: "user.tool_approval" },- ],- };+ const rawRequestBody = { events: [{ type: "user.mcp_auth_continue" }, { type: "user.mcp_auth_continue" }] };const rawResponseBody = { error: { message: "message" } };server@@ -1485,20 +1450,10 @@ describe("SessionsClient", () => {return await client.sessions.createTurnEvent("session_id", "turn_id", {events: [{- approval: {- status: "allow",- },- threadId: "x",- toolCallId: "x",- type: "user.tool_approval",+ type: "user.mcp_auth_continue",},{- approval: {- status: "allow",- },- threadId: "x",- toolCallId: "x",- type: "user.tool_approval",+ type: "user.mcp_auth_continue",},],});@@ -1508,12 +1463,7 @@ describe("SessionsClient", () => {test("create_turn_event (3)", async () => {const server = mockServerPool.createServer();const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });- const rawRequestBody = {- events: [- { approval: { status: "allow" }, thread_id: "x", tool_call_id: "x", type: "user.tool_approval" },- { approval: { status: "allow" }, thread_id: "x", tool_call_id: "x", type: "user.tool_approval" },- ],- };+ const rawRequestBody = { events: [{ type: "user.mcp_auth_continue" }, { type: "user.mcp_auth_continue" }] };const rawResponseBody = { error: { message: "message" } };server@@ -1529,20 +1479,10 @@ describe("SessionsClient", () => {return await client.sessions.createTurnEvent("session_id", "turn_id", {events: [{- approval: {- status: "allow",- },- threadId: "x",- toolCallId: "x",- type: "user.tool_approval",+ type: "user.mcp_auth_continue",},{- approval: {- status: "allow",- },- threadId: "x",- toolCallId: "x",- type: "user.tool_approval",+ type: "user.mcp_auth_continue",},],});@@ -1552,12 +1492,7 @@ describe("SessionsClient", () => {test("create_turn_event (4)", async () => {const server = mockServerPool.createServer();const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });- const rawRequestBody = {- events: [- { approval: { status: "allow" }, thread_id: "x", tool_call_id: "x", type: "user.tool_approval" },- { approval: { status: "allow" }, thread_id: "x", tool_call_id: "x", type: "user.tool_approval" },- ],- };+ const rawRequestBody = { events: [{ type: "user.mcp_auth_continue" }, { type: "user.mcp_auth_continue" }] };const rawResponseBody = { error: { message: "message" } };server@@ -1573,20 +1508,10 @@ describe("SessionsClient", () => {return await client.sessions.createTurnEvent("session_id", "turn_id", {events: [{- approval: {- status: "allow",- },- threadId: "x",- toolCallId: "x",- type: "user.tool_approval",+ type: "user.mcp_auth_continue",},{- approval: {- status: "allow",- },- threadId: "x",- toolCallId: "x",- type: "user.tool_approval",+ type: "user.mcp_auth_continue",},],});@@ -1596,12 +1521,7 @@ describe("SessionsClient", () => {test("create_turn_event (5)", async () => {const server = mockServerPool.createServer();const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });- const rawRequestBody = {- events: [- { approval: { status: "allow" }, thread_id: "x", tool_call_id: "x", type: "user.tool_approval" },- { approval: { status: "allow" }, thread_id: "x", tool_call_id: "x", type: "user.tool_approval" },- ],- };+ const rawRequestBody = { events: [{ type: "user.mcp_auth_continue" }, { type: "user.mcp_auth_continue" }] };const rawResponseBody = { error: { message: "message" } };server@@ -1617,20 +1537,10 @@ describe("SessionsClient", () => {return await client.sessions.createTurnEvent("session_id", "turn_id", {events: [{- approval: {- status: "allow",- },- threadId: "x",- toolCallId: "x",- type: "user.tool_approval",+ type: "user.mcp_auth_continue",},{- approval: {- status: "allow",- },- threadId: "x",- toolCallId: "x",- type: "user.tool_approval",+ type: "user.mcp_auth_continue",},],});diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/toUiTurnState.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/toUiTurnState.tsindex 56ac6edcf..b097525d2 100644--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/toUiTurnState.ts+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/toUiTurnState.ts@@ -15,7 +15,10 @@ export function toUiTurnDoneMetrics(metrics: TrueForgeApi.TurnMetrics): TurnDone}export function toUiTurnState(state: TrueForgeApi.TurnState | TrueForgeApi.TurnDoneEventState): TurnState {- return state.status === 'running' ? { status: 'running' } : toUiTerminalTurnState(state);+ if (state.status === 'running' || state.status === 'paused') {+ return { status: 'running' };+ }+ return toUiTerminalTurnState(state);}function toUiTerminalTurnState(state: TrueForgeApi.TurnDoneEventState): Exclude<TurnState, { status: 'running' }> {@@ -40,14 +43,20 @@ function toUiTerminalTurnState(state: TrueForgeApi.TurnDoneEventState): Exclude<function isUnmappedSdkEvent(event: TrueForgeApi.SessionEvent | TrueForgeApi.TurnStreamingEvent): event is Extract<TrueForgeApi.SessionEvent | TrueForgeApi.TurnStreamingEvent,{- type: 'turn.update' | 'user.tool_approval' | 'user.tool_response' | 'user.tool_approval_policy';+ type:+ | 'turn.update'+ | 'user.tool_approval'+ | 'user.tool_response'+ | 'user.tool_approval_policy'+ | 'user.mcp_auth_continue';}> {return (event.type === 'turn.update' ||event.type === 'user.tool_approval' ||event.type === 'user.tool_response' ||- event.type === 'user.tool_approval_policy'+ event.type === 'user.tool_approval_policy' ||+ event.type === 'user.mcp_auth_continue');}diff --git a/packages/trueforge/src/db/postgres/session-store/queries/turns.ts b/packages/trueforge/src/db/postgres/session-store/queries/turns.tsindex 06bcda570..4180945f8 100644--- a/packages/trueforge/src/db/postgres/session-store/queries/turns.ts+++ b/packages/trueforge/src/db/postgres/session-store/queries/turns.ts@@ -153,7 +153,8 @@ async function addSessionCostAndDuration(function terminalTurnState(state: TurnState, turn_id: string): TerminalTurnState {switch (state.status) {case 'running':- throw new SessionStoreInvariantError(`expected terminal state for turn ${turn_id}, got running`);+ case 'paused':+ throw new SessionStoreInvariantError(`expected terminal state for turn ${turn_id}, got ${state.status}`);case 'done':case 'cancelled':case 'error':diff --git a/packages/trueforge/src/db/sqlite/session-store/queries/turns.ts b/packages/trueforge/src/db/sqlite/session-store/queries/turns.tsindex db230fd20..160558471 100644--- a/packages/trueforge/src/db/sqlite/session-store/queries/turns.ts+++ b/packages/trueforge/src/db/sqlite/session-store/queries/turns.ts@@ -143,7 +143,8 @@ async function addSessionCostAndDuration(function terminalTurnState(state: TurnState, turn_id: string): TerminalTurnState {switch (state.status) {case 'running':- throw new SessionStoreInvariantError(`expected terminal state for turn ${turn_id}, got running`);+ case 'paused':+ throw new SessionStoreInvariantError(`expected terminal state for turn ${turn_id}, got ${state.status}`);case 'done':case 'cancelled':case 'error':diff --git a/packages/trueforge/src/schemas/events.ts b/packages/trueforge/src/schemas/events.tsindex d14a4ffb9..830eb1f3b 100644--- a/packages/trueforge/src/schemas/events.ts+++ b/packages/trueforge/src/schemas/events.ts@@ -23,6 +23,7 @@ import {ToolApprovalRequiredEventSchema,ToolResponseEventSchema,ToolResponseRequiredEventSchema,+ UserMCPAuthContinueEventSchema,UserToolApprovalEventSchema,UserToolApprovalPolicyEventSchema,UserToolResponseEventSchema,@@ -34,10 +35,7 @@ export { EventType };export const CreateTurnEventRequestSchema = z.object({- events: z- .array(TurnInboundEventItemSchema)- .min(1)- .describe('One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).'),+ events: z.array(TurnInboundEventItemSchema).min(1).describe('One or more user events.'),}).openapi('CreateTurnEventRequest');@@ -49,6 +47,7 @@ export const CreateTurnEventResponseSchema = zUserToolApprovalEventSchema,UserToolResponseEventSchema,UserToolApprovalPolicyEventSchema,+ UserMCPAuthContinueEventSchema,]),).describe('Events with server-minted `id` and `created_at`, in request order.'),@@ -71,6 +70,7 @@ export const TurnStreamingEventSchema = zUserToolApprovalEventSchema,UserToolResponseEventSchema,UserToolApprovalPolicyEventSchema,+ UserMCPAuthContinueEventSchema,TurnCreatedEventSchema,TurnUpdateEventSchema,TurnDoneEventSchema,diff --git a/packages/trueforge/tests/unit/apis/sessionHttp.test.ts b/packages/trueforge/tests/unit/apis/sessionHttp.test.tsindex b9102a1df..48ee641b0 100644--- a/packages/trueforge/tests/unit/apis/sessionHttp.test.ts+++ b/packages/trueforge/tests/unit/apis/sessionHttp.test.ts@@ -498,6 +498,9 @@ describe('sessions HTTP agent binding', () => {},],},+ {+ type: 'user.mcp_auth_continue',+ },],}),);@@ -513,7 +516,7 @@ describe('sessions HTTP agent binding', () => {policies?: unknown[];}>;};- expect(body.data).toHaveLength(2);+ expect(body.data).toHaveLength(3);expect(body.data[0]).toMatchObject({type: 'user.tool_approval',thread_id: 'main',@@ -532,6 +535,9 @@ describe('sessions HTTP agent binding', () => {},],});+ expect(body.data[2]).toMatchObject({ type: 'user.mcp_auth_continue' });+ expect(body.data[2]?.id).toEqual(expect.any(String));+ expect(body.data[2]?.created_at).toEqual(expect.any(String));});it('rejects PATCH agent on a named session', async () => {diff --git a/python/trueforge_sdk/reference.md b/python/trueforge_sdk/reference.mdindex 245c0aad8..0dd136f93 100644--- a/python/trueforge_sdk/reference.md+++ b/python/trueforge_sdk/reference.md@@ -2858,7 +2858,7 @@ Create events for a turn. Only the session creator may create them.<dd>```python-from trueforge_sdk import TrueForge, UserToolApprovalInputEvent, ApprovalAllow+from trueforge_sdk import TrueForge, UserMcpAuthContinueInputEventclient = TrueForge(token="<token>",@@ -2869,13 +2869,8 @@ client.sessions.create_turn_event(session_id="session_id",turn_id="turn_id",events=[- UserToolApprovalInputEvent(- approval=ApprovalAllow(- status="allow",- ),- thread_id="thread_id",- tool_call_id="tool_call_id",- type="user.tool_approval",+ UserMcpAuthContinueInputEvent(+ type="user.mcp_auth_continue",)],)@@ -2910,7 +2905,7 @@ client.sessions.create_turn_event(<dl><dd>-**events:** `typing.List[TurnInboundEventItem]` — One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).+**events:** `typing.List[TurnInboundEventItem]` — One or more user events.</dd></dl>diff --git a/python/trueforge_sdk/src/trueforge_sdk/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/__init__.pyindex 6e256920d..280074011 100644--- a/python/trueforge_sdk/src/trueforge_sdk/__init__.py+++ b/python/trueforge_sdk/src/trueforge_sdk/__init__.py@@ -240,12 +240,13 @@ if typing.TYPE_CHECKING:TurnStateDone,TurnStateError,TurnStateErrorMetrics,+ TurnStatePaused,TurnStateRunning,TurnStreamingEvent,TurnUpdateEvent,- TurnUpdateState,- TurnUpdateStatePaused,- TurnUpdateStateRunning,+ TurnUpdateEventState,+ UserMcpAuthContinueEvent,+ UserMcpAuthContinueInputEvent,UserMessage,UserMessageContent,UserMessageContentItem,@@ -526,14 +527,15 @@ _dynamic_imports: typing.Dict[str, str] = {"TurnStateDone": ".types","TurnStateError": ".types","TurnStateErrorMetrics": ".types",+ "TurnStatePaused": ".types","TurnStateRunning": ".types","TurnStreamingEvent": ".types","TurnUpdateEvent": ".types",- "TurnUpdateState": ".types",- "TurnUpdateStatePaused": ".types",- "TurnUpdateStateRunning": ".types",+ "TurnUpdateEventState": ".types","UnauthorizedError": ".errors","UnprocessableEntityError": ".errors",+ "UserMcpAuthContinueEvent": ".types",+ "UserMcpAuthContinueInputEvent": ".types","UserMessage": ".types","UserMessageContent": ".types","UserMessageContentItem": ".types",@@ -831,14 +833,15 @@ __all__ = ["TurnStateDone","TurnStateError","TurnStateErrorMetrics",+ "TurnStatePaused","TurnStateRunning","TurnStreamingEvent","TurnUpdateEvent",- "TurnUpdateState",- "TurnUpdateStatePaused",- "TurnUpdateStateRunning",+ "TurnUpdateEventState","UnauthorizedError","UnprocessableEntityError",+ "UserMcpAuthContinueEvent",+ "UserMcpAuthContinueInputEvent","UserMessage","UserMessageContent","UserMessageContentItem",diff --git a/python/trueforge_sdk/src/trueforge_sdk/sessions/client.py b/python/trueforge_sdk/src/trueforge_sdk/sessions/client.pyindex 96a18fab8..0bfcccc4a 100644--- a/python/trueforge_sdk/src/trueforge_sdk/sessions/client.py+++ b/python/trueforge_sdk/src/trueforge_sdk/sessions/client.py@@ -707,7 +707,7 @@ class SessionsClient:Turn identifier.events : typing.Sequence[TurnInboundEventItem]- One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).+ One or more user events.request_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -719,7 +719,7 @@ class SessionsClient:Examples--------- from trueforge_sdk import ApprovalAllow, TrueForge, UserToolApprovalInputEvent+ from trueforge_sdk import TrueForge, UserMcpAuthContinueInputEventclient = TrueForge(token="YOUR_TOKEN",@@ -728,13 +728,7 @@ class SessionsClient:client.sessions.create_turn_event(session_id="session_id",turn_id="turn_id",- events=[- UserToolApprovalInputEvent(- approval=ApprovalAllow(),- thread_id="thread_id",- tool_call_id="tool_call_id",- )- ],+ events=[UserMcpAuthContinueInputEvent()],)"""_response = self._raw_client.create_turn_event(@@ -1586,7 +1580,7 @@ class AsyncSessionsClient:Turn identifier.events : typing.Sequence[TurnInboundEventItem]- One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).+ One or more user events.request_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -1600,11 +1594,7 @@ class AsyncSessionsClient:--------import asyncio- from trueforge_sdk import (- ApprovalAllow,- AsyncTrueForge,- UserToolApprovalInputEvent,- )+ from trueforge_sdk import AsyncTrueForge, UserMcpAuthContinueInputEventclient = AsyncTrueForge(token="YOUR_TOKEN",@@ -1616,13 +1606,7 @@ class AsyncSessionsClient:await client.sessions.create_turn_event(session_id="session_id",turn_id="turn_id",- events=[- UserToolApprovalInputEvent(- approval=ApprovalAllow(),- thread_id="thread_id",- tool_call_id="tool_call_id",- )- ],+ events=[UserMcpAuthContinueInputEvent()],)diff --git a/python/trueforge_sdk/src/trueforge_sdk/sessions/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/sessions/raw_client.pyindex 992928c8e..86af6497b 100644--- a/python/trueforge_sdk/src/trueforge_sdk/sessions/raw_client.py+++ b/python/trueforge_sdk/src/trueforge_sdk/sessions/raw_client.py@@ -1459,7 +1459,7 @@ class RawSessionsClient:Turn identifier.events : typing.Sequence[TurnInboundEventItem]- One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).+ One or more user events.request_options : typing.Optional[RequestOptions]Request-specific configuration.@@ -3101,7 +3101,7 @@ class AsyncRawSessionsClient:Turn identifier.events : typing.Sequence[TurnInboundEventItem]- One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).+ One or more user events.request_options : typing.Optional[RequestOptions]Request-specific configuration.diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/types/__init__.pyindex 126971be8..7c265d263 100644--- a/python/trueforge_sdk/src/trueforge_sdk/types/__init__.py+++ b/python/trueforge_sdk/src/trueforge_sdk/types/__init__.py@@ -239,12 +239,13 @@ if typing.TYPE_CHECKING:from .turn_state_done import TurnStateDonefrom .turn_state_error import TurnStateErrorfrom .turn_state_error_metrics import TurnStateErrorMetrics+ from .turn_state_paused import TurnStatePausedfrom .turn_state_running import TurnStateRunningfrom .turn_streaming_event import TurnStreamingEventfrom .turn_update_event import TurnUpdateEvent- from .turn_update_state import TurnUpdateState- from .turn_update_state_paused import TurnUpdateStatePaused- from .turn_update_state_running import TurnUpdateStateRunning+ from .turn_update_event_state import TurnUpdateEventState+ from .user_mcp_auth_continue_event import UserMcpAuthContinueEvent+ from .user_mcp_auth_continue_input_event import UserMcpAuthContinueInputEventfrom .user_message import UserMessagefrom .user_message_content import UserMessageContentfrom .user_message_content_item import UserMessageContentItem@@ -492,12 +493,13 @@ _dynamic_imports: typing.Dict[str, str] = {"TurnStateDone": ".turn_state_done","TurnStateError": ".turn_state_error","TurnStateErrorMetrics": ".turn_state_error_metrics",+ "TurnStatePaused": ".turn_state_paused","TurnStateRunning": ".turn_state_running","TurnStreamingEvent": ".turn_streaming_event","TurnUpdateEvent": ".turn_update_event",- "TurnUpdateState": ".turn_update_state",- "TurnUpdateStatePaused": ".turn_update_state_paused",- "TurnUpdateStateRunning": ".turn_update_state_running",+ "TurnUpdateEventState": ".turn_update_event_state",+ "UserMcpAuthContinueEvent": ".user_mcp_auth_continue_event",+ "UserMcpAuthContinueInputEvent": ".user_mcp_auth_continue_input_event","UserMessage": ".user_message","UserMessageContent": ".user_message_content","UserMessageContentItem": ".user_message_content_item",@@ -769,12 +771,13 @@ __all__ = ["TurnStateDone","TurnStateError","TurnStateErrorMetrics",+ "TurnStatePaused","TurnStateRunning","TurnStreamingEvent","TurnUpdateEvent",- "TurnUpdateState",- "TurnUpdateStatePaused",- "TurnUpdateStateRunning",+ "TurnUpdateEventState",+ "UserMcpAuthContinueEvent",+ "UserMcpAuthContinueInputEvent","UserMessage","UserMessageContent","UserMessageContentItem",diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/create_turn_event_response_data_item.py b/python/trueforge_sdk/src/trueforge_sdk/types/create_turn_event_response_data_item.pyindex 688e6a401..e43973272 100644--- a/python/trueforge_sdk/src/trueforge_sdk/types/create_turn_event_response_data_item.py+++ b/python/trueforge_sdk/src/trueforge_sdk/types/create_turn_event_response_data_item.py@@ -2,10 +2,11 @@import typing+from .user_mcp_auth_continue_event import UserMcpAuthContinueEventfrom .user_tool_approval_event import UserToolApprovalEventfrom .user_tool_approval_policy_event import UserToolApprovalPolicyEventfrom .user_tool_response_event import UserToolResponseEventCreateTurnEventResponseDataItem = typing.Union[- UserToolApprovalEvent, UserToolApprovalPolicyEvent, UserToolResponseEvent+ UserMcpAuthContinueEvent, UserToolApprovalEvent, UserToolApprovalPolicyEvent, UserToolResponseEvent]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_event.pyindex cbedb13d2..9adcd8f8d 100644--- a/python/trueforge_sdk/src/trueforge_sdk/types/session_event.py+++ b/python/trueforge_sdk/src/trueforge_sdk/types/session_event.py@@ -14,6 +14,7 @@ from .tool_response_required_event import ToolResponseRequiredEventfrom .turn_created_event import TurnCreatedEventfrom .turn_done_event import TurnDoneEventfrom .turn_update_event import TurnUpdateEvent+from .user_mcp_auth_continue_event import UserMcpAuthContinueEventfrom .user_tool_approval_event import UserToolApprovalEventfrom .user_tool_approval_policy_event import UserToolApprovalPolicyEventfrom .user_tool_response_event import UserToolResponseEvent@@ -31,6 +32,7 @@ SessionEvent = typing.Union[TurnCreatedEvent,TurnDoneEvent,TurnUpdateEvent,+ UserMcpAuthContinueEvent,UserToolApprovalEvent,UserToolApprovalPolicyEvent,UserToolResponseEvent,diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_inbound_event_item.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_inbound_event_item.pyindex 47a5cfe5a..f509dad6f 100644--- a/python/trueforge_sdk/src/trueforge_sdk/types/turn_inbound_event_item.py+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_inbound_event_item.py@@ -2,10 +2,11 @@import typing+from .user_mcp_auth_continue_input_event import UserMcpAuthContinueInputEventfrom .user_tool_approval_input_event import UserToolApprovalInputEventfrom .user_tool_approval_policy_message import UserToolApprovalPolicyMessagefrom .user_tool_response_input_event import UserToolResponseInputEventTurnInboundEventItem = typing.Union[- UserToolApprovalInputEvent, UserToolApprovalPolicyMessage, UserToolResponseInputEvent+ UserMcpAuthContinueInputEvent, UserToolApprovalInputEvent, UserToolApprovalPolicyMessage, UserToolResponseInputEvent]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state.pyindex 868df1ae3..fc4a3f755 100644--- a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state.py+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state.py@@ -5,6 +5,7 @@ import typingfrom .turn_state_cancelled import TurnStateCancelledfrom .turn_state_done import TurnStateDonefrom .turn_state_error import TurnStateError+from .turn_state_paused import TurnStatePausedfrom .turn_state_running import TurnStateRunning-TurnState = typing.Union[TurnStateCancelled, TurnStateDone, TurnStateError, TurnStateRunning]+TurnState = typing.Union[TurnStateCancelled, TurnStateDone, TurnStateError, TurnStatePaused, TurnStateRunning]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_done.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_done.pyindex 17ab1bf82..20e5ef583 100644--- a/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_done.py+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_done.py@@ -19,7 +19,7 @@ class TurnStateDone(UncheckedBaseModel):metrics: typing.Optional[TurnMetrics] = Noneoutput: typing.Optional[ModelMessageEvent] = pydantic.Field(default=None)"""- Final `model.message` for the turn, or null when the turn ended paused without a final message.+ Final `model.message` for the turn, or null when the turn ended without a final message."""required_actions: typing.List[ActionRequiredEvent] = pydantic.Field()diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_state_paused.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_paused.pysimilarity index 93%rename from python/trueforge_sdk/src/trueforge_sdk/types/turn_update_state_paused.pyrename to python/trueforge_sdk/src/trueforge_sdk/types/turn_state_paused.pyindex 8edcce45f..a17fb2084 100644--- a/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_state_paused.py+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_state_paused.py@@ -8,7 +8,7 @@ from ..core.unchecked_base_model import UncheckedBaseModelfrom .action_required import ActionRequired-class TurnUpdateStatePaused(UncheckedBaseModel):+class TurnStatePaused(UncheckedBaseModel):action_required_on_events: typing.List[ActionRequired] = pydantic.Field()"""Events that still need a user or client action.diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_streaming_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_streaming_event.pyindex 1a9d40b9a..891c99e5e 100644--- a/python/trueforge_sdk/src/trueforge_sdk/types/turn_streaming_event.py+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_streaming_event.py@@ -15,6 +15,7 @@ from .tool_response_required_event import ToolResponseRequiredEventfrom .turn_created_event import TurnCreatedEventfrom .turn_done_event import TurnDoneEventfrom .turn_update_event import TurnUpdateEvent+from .user_mcp_auth_continue_event import UserMcpAuthContinueEventfrom .user_tool_approval_event import UserToolApprovalEventfrom .user_tool_approval_policy_event import UserToolApprovalPolicyEventfrom .user_tool_response_event import UserToolResponseEvent@@ -33,6 +34,7 @@ TurnStreamingEvent = typing.Union[TurnCreatedEvent,TurnDoneEvent,TurnUpdateEvent,+ UserMcpAuthContinueEvent,UserToolApprovalEvent,UserToolApprovalPolicyEvent,UserToolResponseEvent,diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_event.pyindex 678d98640..f8beece6b 100644--- a/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_event.py+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_event.py@@ -5,7 +5,7 @@ import typingimport pydanticfrom ..core.pydantic_utilities import IS_PYDANTIC_V2from ..core.unchecked_base_model import UncheckedBaseModel-from .turn_update_state import TurnUpdateState+from .turn_update_event_state import TurnUpdateEventStateclass TurnUpdateEvent(UncheckedBaseModel):@@ -19,7 +19,11 @@ class TurnUpdateEvent(UncheckedBaseModel):Unique identifier for the event (monotonic ULID)."""- state: TurnUpdateState+ state: TurnUpdateEventState = pydantic.Field()+ """+ Live non-terminal turn state (paused or running).+ """+thread_id: typing.Optional[str] = pydantic.Field(default=None)"""Thread that owns the event; null for turn-level lifecycle events.diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_event_state.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_event_state.pynew file mode 100644index 000000000..74770a29b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_event_state.py@@ -0,0 +1,8 @@+# This file was auto-generated by Fern from our API Definition.++import typing++from .turn_state_paused import TurnStatePaused+from .turn_state_running import TurnStateRunning++TurnUpdateEventState = typing.Union[TurnStatePaused, TurnStateRunning]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_state.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_state.pydeleted file mode 100644index 931194b20..000000000--- a/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_state.py+++ /dev/null@@ -1,8 +0,0 @@-# This file was auto-generated by Fern from our API Definition.--import typing--from .turn_update_state_paused import TurnUpdateStatePaused-from .turn_update_state_running import TurnUpdateStateRunning--TurnUpdateState = typing.Union[TurnUpdateStatePaused, TurnUpdateStateRunning]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/user_mcp_auth_continue_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/user_mcp_auth_continue_event.pynew file mode 100644index 000000000..0b7a4a21b--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/user_mcp_auth_continue_event.py@@ -0,0 +1,29 @@+# This file was auto-generated by Fern from our API Definition.++import typing++import pydantic+from ..core.pydantic_utilities import IS_PYDANTIC_V2+from ..core.unchecked_base_model import UncheckedBaseModel+++class UserMcpAuthContinueEvent(UncheckedBaseModel):+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ type: typing.Literal["user.mcp_auth_continue"] = "user.mcp_auth_continue"++ if IS_PYDANTIC_V2:+ model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2+ else:++ class Config:+ smart_union = True+ extra = pydantic.Extra.allowdiff --git a/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_state_running.py b/python/trueforge_sdk/src/trueforge_sdk/types/user_mcp_auth_continue_input_event.pysimilarity index 77%rename from python/trueforge_sdk/src/trueforge_sdk/types/turn_update_state_running.pyrename to python/trueforge_sdk/src/trueforge_sdk/types/user_mcp_auth_continue_input_event.pyindex d0b67f00d..0988b20bb 100644--- a/python/trueforge_sdk/src/trueforge_sdk/types/turn_update_state_running.py+++ b/python/trueforge_sdk/src/trueforge_sdk/types/user_mcp_auth_continue_input_event.py@@ -7,8 +7,8 @@ from ..core.pydantic_utilities import IS_PYDANTIC_V2from ..core.unchecked_base_model import UncheckedBaseModel-class TurnUpdateStateRunning(UncheckedBaseModel):- status: typing.Literal["running"] = "running"+class UserMcpAuthContinueInputEvent(UncheckedBaseModel):+ type: typing.Literal["user.mcp_auth_continue"] = "user.mcp_auth_continue"if IS_PYDANTIC_V2:model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow") # type: ignore # Pydantic v2