Skip to content

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.md
new file mode 100644
index 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.json
index 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.json
index 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.ts
index 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, RuntimeConfigSch
export 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.ts
index 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 = z
UserToolApprovalEventSchema,
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.ts
index 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 = z
export 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 = z
export const TurnStateSchema = z
.discriminatedUnion('status', [
TurnStateRunningSchema,
+ TurnStatePausedSchema,
TurnStateDoneSchema,
TurnStateCancelledSchema,
TurnStateErrorSchema,
@@ -182,12 +200,13 @@ export const TurnInboundEventItemSchema = z
UserToolApprovalMessageSchema,
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.ts
index 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.ts
index 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 UserToolApprovalPolic
export 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.ts
index 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.md
index 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.
```typescript
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/Client.ts b/packages/trueforge-sdk/src/api/resources/sessions/client/Client.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
similarity index 86%
rename from packages/trueforge-sdk/src/api/types/TurnUpdateStatePaused.ts
rename to packages/trueforge-sdk/src/api/types/TurnStatePaused.ts
index 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.ts
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
deleted file mode 100644
index 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.ts
deleted file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.Ra
TurnCreatedEvent,
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.ts
index 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.ts
index 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.ts
similarity index 76%
rename from packages/trueforge-sdk/src/serialization/types/TurnUpdateStatePaused.ts
rename to packages/trueforge-sdk/src/serialization/types/TurnStatePaused.ts
index 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.ts
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
deleted file mode 100644
index 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.ts
deleted file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 = z
UserToolApprovalEventSchema,
UserToolResponseEventSchema,
UserToolApprovalPolicyEventSchema,
+ UserMCPAuthContinueEventSchema,
]),
)
.describe('Events with server-minted `id` and `created_at`, in request order.'),
@@ -71,6 +70,7 @@ export const TurnStreamingEventSchema = z
UserToolApprovalEventSchema,
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.ts
index 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.md
index 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, UserMcpAuthContinueInputEvent
client = 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__.py
index 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.py
index 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, UserMcpAuthContinueInputEvent
client = 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, UserMcpAuthContinueInputEvent
client = 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.py
index 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__.py
index 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 TurnStateDone
from .turn_state_error import TurnStateError
from .turn_state_error_metrics import TurnStateErrorMetrics
+ from .turn_state_paused import TurnStatePaused
from .turn_state_running import TurnStateRunning
from .turn_streaming_event import TurnStreamingEvent
from .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 UserMcpAuthContinueInputEvent
from .user_message import UserMessage
from .user_message_content import UserMessageContent
from .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.py
index 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 UserMcpAuthContinueEvent
from .user_tool_approval_event import UserToolApprovalEvent
from .user_tool_approval_policy_event import UserToolApprovalPolicyEvent
from .user_tool_response_event import UserToolResponseEvent
CreateTurnEventResponseDataItem = 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.py
index 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 ToolResponseRequiredEvent
from .turn_created_event import TurnCreatedEvent
from .turn_done_event import TurnDoneEvent
from .turn_update_event import TurnUpdateEvent
+from .user_mcp_auth_continue_event import UserMcpAuthContinueEvent
from .user_tool_approval_event import UserToolApprovalEvent
from .user_tool_approval_policy_event import UserToolApprovalPolicyEvent
from .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.py
index 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 UserMcpAuthContinueInputEvent
from .user_tool_approval_input_event import UserToolApprovalInputEvent
from .user_tool_approval_policy_message import UserToolApprovalPolicyMessage
from .user_tool_response_input_event import UserToolResponseInputEvent
TurnInboundEventItem = 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.py
index 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 typing
from .turn_state_cancelled import TurnStateCancelled
from .turn_state_done import TurnStateDone
from .turn_state_error import TurnStateError
+from .turn_state_paused import TurnStatePaused
from .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.py
index 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] = None
output: 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.py
similarity index 93%
rename from python/trueforge_sdk/src/trueforge_sdk/types/turn_update_state_paused.py
rename to python/trueforge_sdk/src/trueforge_sdk/types/turn_state_paused.py
index 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 UncheckedBaseModel
from .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.py
index 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 ToolResponseRequiredEvent
from .turn_created_event import TurnCreatedEvent
from .turn_done_event import TurnDoneEvent
from .turn_update_event import TurnUpdateEvent
+from .user_mcp_auth_continue_event import UserMcpAuthContinueEvent
from .user_tool_approval_event import UserToolApprovalEvent
from .user_tool_approval_policy_event import UserToolApprovalPolicyEvent
from .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.py
index 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 typing
import pydantic
from ..core.pydantic_utilities import IS_PYDANTIC_V2
from ..core.unchecked_base_model import UncheckedBaseModel
-from .turn_update_state import TurnUpdateState
+from .turn_update_event_state import TurnUpdateEventState
class 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.py
new file mode 100644
index 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.py
deleted file mode 100644
index 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.py
new file mode 100644
index 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.allow
diff --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.py
similarity index 77%
rename from python/trueforge_sdk/src/trueforge_sdk/types/turn_update_state_running.py
rename to python/trueforge_sdk/src/trueforge_sdk/types/user_mcp_auth_continue_input_event.py
index 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_V2
from ..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