The open-source agent harness - the runtime layer that turns an LLM into a working agent.
enh: add API for POST events and add to event stream (#812)
Heer Ambavi0c824120d233
diff --git a/.changeset/20260923044631-regenerate-sdk-from-openapi.md b/.changeset/20260923044631-regenerate-sdk-from-openapi.mdnew file mode 100644index 000000000..efd8ff00f--- /dev/null+++ b/.changeset/20260923044631-regenerate-sdk-from-openapi.md@@ -0,0 +1,5 @@+---+"@truefoundry/trueforge-sdk": patch+---++Regenerate SDK from updated OpenAPI spec.diff --git a/.changeset/turn-inbound-events-api.md b/.changeset/turn-inbound-events-api.mdnew file mode 100644index 000000000..b5e2c656a--- /dev/null+++ b/.changeset/turn-inbound-events-api.md@@ -0,0 +1,7 @@+---+"@truefoundry/trueforge": patch+"@truefoundry/trueforge-core": patch+---++Add `POST /sessions/{session_id}/turns/{turn_id}/events` for tip HITL / policy events.+diff --git a/.github/fern/openapi/openapi.json b/.github/fern/openapi/openapi.jsonindex 76efd9628..2af2a5d16 100644--- a/.github/fern/openapi/openapi.json+++ b/.github/fern/openapi/openapi.json@@ -1163,6 +1163,55 @@],"type": "object"},+ "CreateTurnEventRequest": {+ "properties": {+ "events": {+ "description": "One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).",+ "items": {+ "$ref": "#/components/schemas/TurnInboundEventItem"+ },+ "minItems": 1,+ "type": "array"+ }+ },+ "required": [+ "events"+ ],+ "type": "object"+ },+ "CreateTurnEventResponse": {+ "properties": {+ "data": {+ "description": "Events with server-minted `id` and `created_at`, in request order.",+ "items": {+ "discriminator": {+ "mapping": {+ "user.tool_approval": "#/components/schemas/UserToolApprovalEvent",+ "user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent",+ "user.tool_response": "#/components/schemas/UserToolResponseEvent"+ },+ "propertyName": "type"+ },+ "oneOf": [+ {+ "$ref": "#/components/schemas/UserToolApprovalEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolResponseEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolApprovalPolicyEvent"+ }+ ]+ },+ "type": "array"+ }+ },+ "required": [+ "data"+ ],+ "type": "object"+ },"CreateTurnRequest": {"properties": {"input": {@@ -4108,7 +4157,10 @@"tool.response_required": "#/components/schemas/ToolResponseRequiredEvent","turn.created": "#/components/schemas/TurnCreatedEvent","turn.done": "#/components/schemas/TurnDoneEvent",- "turn.update": "#/components/schemas/TurnUpdateEvent"+ "turn.update": "#/components/schemas/TurnUpdateEvent",+ "user.tool_approval": "#/components/schemas/UserToolApprovalEvent",+ "user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent",+ "user.tool_response": "#/components/schemas/UserToolResponseEvent"},"propertyName": "type"},@@ -4148,6 +4200,15 @@},{"$ref": "#/components/schemas/ToolResponseRequiredEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolApprovalEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolResponseEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolApprovalPolicyEvent"}]},@@ -4778,6 +4839,58 @@],"type": "object"},+ "ToolApprovalPolicyAllowSession": {+ "properties": {+ "expire_at": {+ "description": "ISO 8601 timestamp when this session allow expires. Omit to allow for the whole session.",+ "type": "string"+ },+ "type": {+ "description": "Allow matching tool calls for the rest of this session.",+ "enum": [+ "allow_session"+ ],+ "type": "string"+ }+ },+ "required": [+ "type"+ ],+ "type": "object"+ },+ "ToolApprovalPolicyItem": {+ "properties": {+ "action": {+ "discriminator": {+ "mapping": {+ "allow_session": "#/components/schemas/ToolApprovalPolicyAllowSession"+ },+ "propertyName": "type"+ },+ "oneOf": [+ {+ "$ref": "#/components/schemas/ToolApprovalPolicyAllowSession"+ }+ ]+ },+ "name": {+ "description": "Tool name on that server.",+ "minLength": 1,+ "type": "string"+ },+ "server_name": {+ "description": "MCP server name.",+ "minLength": 1,+ "type": "string"+ }+ },+ "required": [+ "server_name",+ "name",+ "action"+ ],+ "type": "object"+ },"ToolApprovalRequiredEvent": {"properties": {"created_at": {@@ -5228,6 +5341,27 @@],"type": "object"},+ "TurnInboundEventItem": {+ "discriminator": {+ "mapping": {+ "user.tool_approval": "#/components/schemas/UserToolApprovalInputEvent",+ "user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyMessage",+ "user.tool_response": "#/components/schemas/UserToolResponseInputEvent"+ },+ "propertyName": "type"+ },+ "oneOf": [+ {+ "$ref": "#/components/schemas/UserToolApprovalInputEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolResponseInputEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolApprovalPolicyMessage"+ }+ ]+ },"TurnInputItem": {"discriminator": {"mapping": {@@ -5467,7 +5601,10 @@"tool.response_required": "#/components/schemas/ToolResponseRequiredEvent","turn.created": "#/components/schemas/TurnCreatedEvent","turn.done": "#/components/schemas/TurnDoneEvent",- "turn.update": "#/components/schemas/TurnUpdateEvent"+ "turn.update": "#/components/schemas/TurnUpdateEvent",+ "user.tool_approval": "#/components/schemas/UserToolApprovalEvent",+ "user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent",+ "user.tool_response": "#/components/schemas/UserToolResponseEvent"},"propertyName": "type"},@@ -5502,6 +5639,15 @@{"$ref": "#/components/schemas/ToolResponseRequiredEvent"},+ {+ "$ref": "#/components/schemas/UserToolApprovalEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolResponseEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolApprovalPolicyEvent"+ },{"$ref": "#/components/schemas/TurnCreatedEvent"},@@ -5764,6 +5910,47 @@}]},+ "UserToolApprovalEvent": {+ "properties": {+ "approval": {+ "$ref": "#/components/schemas/ApprovalDecision"+ },+ "created_at": {+ "description": "ISO 8601 event timestamp.",+ "type": "string"+ },+ "id": {+ "description": "Unique identifier for the event (monotonic ULID).",+ "type": "string"+ },+ "thread_id": {+ "description": "Thread that owns the pending tool call.",+ "minLength": 1,+ "type": "string"+ },+ "tool_call_id": {+ "description": "Tool call id being approved or denied.",+ "minLength": 1,+ "type": "string"+ },+ "type": {+ "description": "Client resume after tool.approval_required.",+ "enum": [+ "user.tool_approval"+ ],+ "type": "string"+ }+ },+ "required": [+ "type",+ "thread_id",+ "tool_call_id",+ "approval",+ "id",+ "created_at"+ ],+ "type": "object"+ },"UserToolApprovalInputEvent": {"properties": {"approval": {@@ -5795,6 +5982,107 @@],"type": "object"},+ "UserToolApprovalPolicyEvent": {+ "properties": {+ "created_at": {+ "description": "ISO 8601 event timestamp.",+ "type": "string"+ },+ "id": {+ "description": "Unique identifier for the event (monotonic ULID).",+ "type": "string"+ },+ "policies": {+ "description": "One or more (server_name, name) policy entries.",+ "items": {+ "$ref": "#/components/schemas/ToolApprovalPolicyItem"+ },+ "minItems": 1,+ "type": "array"+ },+ "type": {+ "description": "Sticky allow-session policy for matching tools (optional expiry).",+ "enum": [+ "user.tool_approval_policy"+ ],+ "type": "string"+ }+ },+ "required": [+ "type",+ "policies",+ "id",+ "created_at"+ ],+ "type": "object"+ },+ "UserToolApprovalPolicyMessage": {+ "properties": {+ "policies": {+ "description": "One or more (server_name, name) policy entries.",+ "items": {+ "$ref": "#/components/schemas/ToolApprovalPolicyItem"+ },+ "minItems": 1,+ "type": "array"+ },+ "type": {+ "description": "Sticky allow-session policy for matching tools (optional expiry).",+ "enum": [+ "user.tool_approval_policy"+ ],+ "type": "string"+ }+ },+ "required": [+ "type",+ "policies"+ ],+ "type": "object"+ },+ "UserToolResponseEvent": {+ "properties": {+ "content": {+ "description": "Client-side tool result content.",+ "minLength": 1,+ "type": "string"+ },+ "created_at": {+ "description": "ISO 8601 event timestamp.",+ "type": "string"+ },+ "id": {+ "description": "Unique identifier for the event (monotonic ULID).",+ "type": "string"+ },+ "thread_id": {+ "description": "Thread that owns the pending tool call.",+ "minLength": 1,+ "type": "string"+ },+ "tool_call_id": {+ "description": "Tool call id receiving the client response.",+ "minLength": 1,+ "type": "string"+ },+ "type": {+ "description": "Client resume after tool.response_required.",+ "enum": [+ "user.tool_response"+ ],+ "type": "string"+ }+ },+ "required": [+ "type",+ "thread_id",+ "tool_call_id",+ "content",+ "id",+ "created_at"+ ],+ "type": "object"+ },"UserToolResponseInputEvent": {"properties": {"content": {@@ -9349,6 +9637,104 @@"sessions"],"x-fern-sdk-method-name": "list_turn_events"+ },+ "post": {+ "description": "Create events for a turn. Only the session creator may create them.",+ "parameters": [+ {+ "description": "Session identifier.",+ "in": "path",+ "name": "session_id",+ "required": true,+ "schema": {+ "description": "Session identifier.",+ "maxLength": 64,+ "minLength": 1,+ "type": "string"+ }+ },+ {+ "description": "Turn identifier.",+ "in": "path",+ "name": "turn_id",+ "required": true,+ "schema": {+ "description": "Turn identifier.",+ "minLength": 1,+ "type": "string"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateTurnEventRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "201": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateTurnEventResponse"+ }+ }+ },+ "description": "Events created."+ },+ "400": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Invalid request body."+ },+ "403": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Caller is not the session creator."+ },+ "404": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Session or turn not found."+ },+ "409": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Turn is terminal, or an event id already exists."+ }+ },+ "summary": "Create turn events",+ "tags": [+ "Agent Sessions"+ ],+ "x-fern-sdk-group-name": [+ "sessions"+ ],+ "x-fern-sdk-method-name": "create_turn_event"}},"/api/v1/sessions/{session_id}/turns/{turn_id}/subscribe": {diff --git a/docs/openapi.json b/docs/openapi.jsonindex 76efd9628..2af2a5d16 100644--- a/docs/openapi.json+++ b/docs/openapi.json@@ -1163,6 +1163,55 @@],"type": "object"},+ "CreateTurnEventRequest": {+ "properties": {+ "events": {+ "description": "One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).",+ "items": {+ "$ref": "#/components/schemas/TurnInboundEventItem"+ },+ "minItems": 1,+ "type": "array"+ }+ },+ "required": [+ "events"+ ],+ "type": "object"+ },+ "CreateTurnEventResponse": {+ "properties": {+ "data": {+ "description": "Events with server-minted `id` and `created_at`, in request order.",+ "items": {+ "discriminator": {+ "mapping": {+ "user.tool_approval": "#/components/schemas/UserToolApprovalEvent",+ "user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent",+ "user.tool_response": "#/components/schemas/UserToolResponseEvent"+ },+ "propertyName": "type"+ },+ "oneOf": [+ {+ "$ref": "#/components/schemas/UserToolApprovalEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolResponseEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolApprovalPolicyEvent"+ }+ ]+ },+ "type": "array"+ }+ },+ "required": [+ "data"+ ],+ "type": "object"+ },"CreateTurnRequest": {"properties": {"input": {@@ -4108,7 +4157,10 @@"tool.response_required": "#/components/schemas/ToolResponseRequiredEvent","turn.created": "#/components/schemas/TurnCreatedEvent","turn.done": "#/components/schemas/TurnDoneEvent",- "turn.update": "#/components/schemas/TurnUpdateEvent"+ "turn.update": "#/components/schemas/TurnUpdateEvent",+ "user.tool_approval": "#/components/schemas/UserToolApprovalEvent",+ "user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent",+ "user.tool_response": "#/components/schemas/UserToolResponseEvent"},"propertyName": "type"},@@ -4148,6 +4200,15 @@},{"$ref": "#/components/schemas/ToolResponseRequiredEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolApprovalEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolResponseEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolApprovalPolicyEvent"}]},@@ -4778,6 +4839,58 @@],"type": "object"},+ "ToolApprovalPolicyAllowSession": {+ "properties": {+ "expire_at": {+ "description": "ISO 8601 timestamp when this session allow expires. Omit to allow for the whole session.",+ "type": "string"+ },+ "type": {+ "description": "Allow matching tool calls for the rest of this session.",+ "enum": [+ "allow_session"+ ],+ "type": "string"+ }+ },+ "required": [+ "type"+ ],+ "type": "object"+ },+ "ToolApprovalPolicyItem": {+ "properties": {+ "action": {+ "discriminator": {+ "mapping": {+ "allow_session": "#/components/schemas/ToolApprovalPolicyAllowSession"+ },+ "propertyName": "type"+ },+ "oneOf": [+ {+ "$ref": "#/components/schemas/ToolApprovalPolicyAllowSession"+ }+ ]+ },+ "name": {+ "description": "Tool name on that server.",+ "minLength": 1,+ "type": "string"+ },+ "server_name": {+ "description": "MCP server name.",+ "minLength": 1,+ "type": "string"+ }+ },+ "required": [+ "server_name",+ "name",+ "action"+ ],+ "type": "object"+ },"ToolApprovalRequiredEvent": {"properties": {"created_at": {@@ -5228,6 +5341,27 @@],"type": "object"},+ "TurnInboundEventItem": {+ "discriminator": {+ "mapping": {+ "user.tool_approval": "#/components/schemas/UserToolApprovalInputEvent",+ "user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyMessage",+ "user.tool_response": "#/components/schemas/UserToolResponseInputEvent"+ },+ "propertyName": "type"+ },+ "oneOf": [+ {+ "$ref": "#/components/schemas/UserToolApprovalInputEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolResponseInputEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolApprovalPolicyMessage"+ }+ ]+ },"TurnInputItem": {"discriminator": {"mapping": {@@ -5467,7 +5601,10 @@"tool.response_required": "#/components/schemas/ToolResponseRequiredEvent","turn.created": "#/components/schemas/TurnCreatedEvent","turn.done": "#/components/schemas/TurnDoneEvent",- "turn.update": "#/components/schemas/TurnUpdateEvent"+ "turn.update": "#/components/schemas/TurnUpdateEvent",+ "user.tool_approval": "#/components/schemas/UserToolApprovalEvent",+ "user.tool_approval_policy": "#/components/schemas/UserToolApprovalPolicyEvent",+ "user.tool_response": "#/components/schemas/UserToolResponseEvent"},"propertyName": "type"},@@ -5502,6 +5639,15 @@{"$ref": "#/components/schemas/ToolResponseRequiredEvent"},+ {+ "$ref": "#/components/schemas/UserToolApprovalEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolResponseEvent"+ },+ {+ "$ref": "#/components/schemas/UserToolApprovalPolicyEvent"+ },{"$ref": "#/components/schemas/TurnCreatedEvent"},@@ -5764,6 +5910,47 @@}]},+ "UserToolApprovalEvent": {+ "properties": {+ "approval": {+ "$ref": "#/components/schemas/ApprovalDecision"+ },+ "created_at": {+ "description": "ISO 8601 event timestamp.",+ "type": "string"+ },+ "id": {+ "description": "Unique identifier for the event (monotonic ULID).",+ "type": "string"+ },+ "thread_id": {+ "description": "Thread that owns the pending tool call.",+ "minLength": 1,+ "type": "string"+ },+ "tool_call_id": {+ "description": "Tool call id being approved or denied.",+ "minLength": 1,+ "type": "string"+ },+ "type": {+ "description": "Client resume after tool.approval_required.",+ "enum": [+ "user.tool_approval"+ ],+ "type": "string"+ }+ },+ "required": [+ "type",+ "thread_id",+ "tool_call_id",+ "approval",+ "id",+ "created_at"+ ],+ "type": "object"+ },"UserToolApprovalInputEvent": {"properties": {"approval": {@@ -5795,6 +5982,107 @@],"type": "object"},+ "UserToolApprovalPolicyEvent": {+ "properties": {+ "created_at": {+ "description": "ISO 8601 event timestamp.",+ "type": "string"+ },+ "id": {+ "description": "Unique identifier for the event (monotonic ULID).",+ "type": "string"+ },+ "policies": {+ "description": "One or more (server_name, name) policy entries.",+ "items": {+ "$ref": "#/components/schemas/ToolApprovalPolicyItem"+ },+ "minItems": 1,+ "type": "array"+ },+ "type": {+ "description": "Sticky allow-session policy for matching tools (optional expiry).",+ "enum": [+ "user.tool_approval_policy"+ ],+ "type": "string"+ }+ },+ "required": [+ "type",+ "policies",+ "id",+ "created_at"+ ],+ "type": "object"+ },+ "UserToolApprovalPolicyMessage": {+ "properties": {+ "policies": {+ "description": "One or more (server_name, name) policy entries.",+ "items": {+ "$ref": "#/components/schemas/ToolApprovalPolicyItem"+ },+ "minItems": 1,+ "type": "array"+ },+ "type": {+ "description": "Sticky allow-session policy for matching tools (optional expiry).",+ "enum": [+ "user.tool_approval_policy"+ ],+ "type": "string"+ }+ },+ "required": [+ "type",+ "policies"+ ],+ "type": "object"+ },+ "UserToolResponseEvent": {+ "properties": {+ "content": {+ "description": "Client-side tool result content.",+ "minLength": 1,+ "type": "string"+ },+ "created_at": {+ "description": "ISO 8601 event timestamp.",+ "type": "string"+ },+ "id": {+ "description": "Unique identifier for the event (monotonic ULID).",+ "type": "string"+ },+ "thread_id": {+ "description": "Thread that owns the pending tool call.",+ "minLength": 1,+ "type": "string"+ },+ "tool_call_id": {+ "description": "Tool call id receiving the client response.",+ "minLength": 1,+ "type": "string"+ },+ "type": {+ "description": "Client resume after tool.response_required.",+ "enum": [+ "user.tool_response"+ ],+ "type": "string"+ }+ },+ "required": [+ "type",+ "thread_id",+ "tool_call_id",+ "content",+ "id",+ "created_at"+ ],+ "type": "object"+ },"UserToolResponseInputEvent": {"properties": {"content": {@@ -9349,6 +9637,104 @@"sessions"],"x-fern-sdk-method-name": "list_turn_events"+ },+ "post": {+ "description": "Create events for a turn. Only the session creator may create them.",+ "parameters": [+ {+ "description": "Session identifier.",+ "in": "path",+ "name": "session_id",+ "required": true,+ "schema": {+ "description": "Session identifier.",+ "maxLength": 64,+ "minLength": 1,+ "type": "string"+ }+ },+ {+ "description": "Turn identifier.",+ "in": "path",+ "name": "turn_id",+ "required": true,+ "schema": {+ "description": "Turn identifier.",+ "minLength": 1,+ "type": "string"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateTurnEventRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "201": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateTurnEventResponse"+ }+ }+ },+ "description": "Events created."+ },+ "400": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Invalid request body."+ },+ "403": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Caller is not the session creator."+ },+ "404": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Session or turn not found."+ },+ "409": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Turn is terminal, or an event id already exists."+ }+ },+ "summary": "Create turn events",+ "tags": [+ "Agent Sessions"+ ],+ "x-fern-sdk-group-name": [+ "sessions"+ ],+ "x-fern-sdk-method-name": "create_turn_event"}},"/api/v1/sessions/{session_id}/turns/{turn_id}/subscribe": {diff --git a/packages/trueforge-core/src/agent-session/schemas/events.ts b/packages/trueforge-core/src/agent-session/schemas/events.tsindex 370f209c2..0a098f602 100644--- a/packages/trueforge-core/src/agent-session/schemas/events.ts+++ b/packages/trueforge-core/src/agent-session/schemas/events.ts@@ -18,6 +18,9 @@ import {ToolApprovalRequiredEventSchema,ToolResponseEventSchema,ToolResponseRequiredEventSchema,+ UserToolApprovalEventSchema,+ UserToolApprovalPolicyEventSchema,+ UserToolResponseEventSchema,} from '../../core/events/schema';import {TurnInputItemSchema,@@ -111,6 +114,9 @@ export const SessionEventSchema = zSandboxCreatedEventSchema,ToolApprovalRequiredEventSchema,ToolResponseRequiredEventSchema,+ UserToolApprovalEventSchema,+ UserToolResponseEventSchema,+ UserToolApprovalPolicyEventSchema,]).openapi('SessionEvent');diff --git a/packages/trueforge-core/src/core/events/schema.ts b/packages/trueforge-core/src/core/events/schema.tsindex a8f193cb0..a5e9ee9a8 100644--- a/packages/trueforge-core/src/core/events/schema.ts+++ b/packages/trueforge-core/src/core/events/schema.ts@@ -109,14 +109,8 @@ export const ToolApprovalPolicyAllowSessionSchema = zexport const ToolApprovalPolicyItemSchema = z.object({- server_name: z- .string()- .min(1, 'server_name is required')- .describe('Configured MCP server name (same as tool_info.server_name on model.message).'),- name: z- .string()- .min(1, 'name is required')- .describe('Tool name on that server (same as tool_info.name on model.message).'),+ server_name: z.string().min(1, 'server_name is required').describe('MCP server name.'),+ name: z.string().min(1, 'name is required').describe('Tool name on that server.'),action: z.discriminatedUnion('type', [ToolApprovalPolicyAllowSessionSchema]),}).openapi('ToolApprovalPolicyItem');@@ -130,6 +124,33 @@ export const UserToolApprovalPolicyMessageSchema = z}).openapi('UserToolApprovalPolicyMessage');+/** Durable / SSE form of {@link UserToolApprovalMessageSchema}. */+export const UserToolApprovalEventSchema = z+ .object({+ ...UserToolApprovalMessageSchema.shape,+ id: EventIdSchema,+ created_at: z.string().describe('ISO 8601 event timestamp.'),+ })+ .openapi('UserToolApprovalEvent');++/** Durable / SSE form of {@link UserToolResponseMessageSchema}. */+export const UserToolResponseEventSchema = z+ .object({+ ...UserToolResponseMessageSchema.shape,+ id: EventIdSchema,+ created_at: z.string().describe('ISO 8601 event timestamp.'),+ })+ .openapi('UserToolResponseEvent');++/** Durable / SSE form of {@link UserToolApprovalPolicyMessageSchema}. */+export const UserToolApprovalPolicyEventSchema = z+ .object({+ ...UserToolApprovalPolicyMessageSchema.shape,+ id: EventIdSchema,+ created_at: z.string().describe('ISO 8601 event timestamp.'),+ })+ .openapi('UserToolApprovalPolicyEvent');+export const TextContentPartSchema = z.object({type: z.literal('text').describe('Text content part.'),@@ -409,6 +430,9 @@ export type UserToolApprovalMessage = z.infer<typeof UserToolApprovalMessageScheexport type UserToolResponseMessage = z.infer<typeof UserToolResponseMessageSchema>;export type ToolApprovalPolicyItem = z.infer<typeof ToolApprovalPolicyItemSchema>;export type UserToolApprovalPolicyMessage = z.infer<typeof UserToolApprovalPolicyMessageSchema>;+export type UserToolApprovalEvent = z.infer<typeof UserToolApprovalEventSchema>;+export type UserToolResponseEvent = z.infer<typeof UserToolResponseEventSchema>;+export type UserToolApprovalPolicyEvent = z.infer<typeof UserToolApprovalPolicyEventSchema>;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 c9056a503..2a6fdf465 100644--- a/packages/trueforge-core/src/core/index.ts+++ b/packages/trueforge-core/src/core/index.ts@@ -113,8 +113,11 @@ export {ToolApprovalRequiredEventSchema,ToolResponseEventSchema,ToolResponseRequiredEventSchema,+ UserToolApprovalEventSchema,UserToolApprovalMessageSchema,+ UserToolApprovalPolicyEventSchema,UserToolApprovalPolicyMessageSchema,+ UserToolResponseEventSchema,UserToolResponseMessageSchema,newEventId,} from './events/schema';@@ -125,7 +128,10 @@ export type {MCPServerInitInfo,ThreadDoneEvent,ThreadOverwriteContextEvent,+ UserToolApprovalEvent,+ UserToolApprovalPolicyEvent,UserToolApprovalPolicyMessage,+ UserToolResponseEvent,} from './events/schema';export { CompletionUsageSchema } from './llm/LLMTypes';export type { CompletionUsage } from './llm/LLMTypes';diff --git a/packages/trueforge-sdk/reference.md b/packages/trueforge-sdk/reference.mdindex d4d1e893f..18f7dec6d 100644--- a/packages/trueforge-sdk/reference.md+++ b/packages/trueforge-sdk/reference.md@@ -2366,6 +2366,94 @@ const response = page.response;</dl>+</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">createTurnEvent</a>(session_id, turn_id, { ...params }) -> TrueForge.CreateTurnEventResponse</code></summary>+<dl>+<dd>++#### π Description++<dl>+<dd>++<dl>+<dd>++Create events for a turn. Only the session creator may create them.+</dd>+</dl>+</dd>+</dl>++#### π Usage++<dl>+<dd>++<dl>+<dd>++```typescript+await client.sessions.createTurnEvent("session_id", "turn_id", {+ events: [{+ approval: {+ status: "allow"+ },+ threadId: "thread_id",+ toolCallId: "tool_call_id",+ type: "user.tool_approval"+ }]+});++```+</dd>+</dl>+</dd>+</dl>++#### βοΈ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `string` β Session identifier.++</dd>+</dl>++<dl>+<dd>++**turn_id:** `string` β Turn identifier.++</dd>+</dl>++<dl>+<dd>++**request:** `TrueForge.CreateTurnEventRequest`++</dd>+</dl>++<dl>+<dd>++**requestOptions:** `SessionsClient.RequestOptions`++</dd>+</dl>+</dd>+</dl>++</dd></dl></details>diff --git a/packages/trueforge-sdk/src/api/resources/sessions/client/Client.ts b/packages/trueforge-sdk/src/api/resources/sessions/client/Client.tsindex 422c38ef2..e7fd1c4d2 100644--- a/packages/trueforge-sdk/src/api/resources/sessions/client/Client.ts+++ b/packages/trueforge-sdk/src/api/resources/sessions/client/Client.ts@@ -1742,6 +1742,158 @@ export class SessionsClient {});}+ /**+ * Create events for a turn. Only the session creator may create them.+ *+ * @param {string} session_id - Session identifier.+ * @param {string} turn_id - Turn identifier.+ * @param {TrueForge.CreateTurnEventRequest} request+ * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.+ *+ * @throws {@link TrueForge.BadRequestError}+ * @throws {@link TrueForge.ForbiddenError}+ * @throws {@link TrueForge.NotFoundError}+ * @throws {@link TrueForge.ConflictError}+ * @throws {@link errors.TrueForgeError}+ * @throws {@link errors.TrueForgeTimeoutError}+ *+ * @example+ * await client.sessions.createTurnEvent("session_id", "turn_id", {+ * events: [{+ * approval: {+ * status: "allow"+ * },+ * threadId: "thread_id",+ * toolCallId: "tool_call_id",+ * type: "user.tool_approval"+ * }]+ * })+ */+ public createTurnEvent(+ session_id: string,+ turn_id: string,+ request: TrueForge.CreateTurnEventRequest,+ requestOptions?: SessionsClient.RequestOptions,+ ): core.HttpResponsePromise<TrueForge.CreateTurnEventResponse> {+ return core.HttpResponsePromise.fromPromise(+ this.__createTurnEvent(session_id, turn_id, request, requestOptions),+ );+ }++ private async __createTurnEvent(+ session_id: string,+ turn_id: string,+ request: TrueForge.CreateTurnEventRequest,+ requestOptions?: SessionsClient.RequestOptions,+ ): Promise<core.WithRawResponse<TrueForge.CreateTurnEventResponse>> {+ const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();+ const _headers: core.Fetcher.Args["headers"] = mergeHeaders(+ _authRequest.headers,+ this._options?.headers,+ requestOptions?.headers,+ );+ const _response = await (this._options.fetcher ?? core.fetcher)({+ url: core.url.join(+ (await core.Supplier.get(this._options.baseUrl)) ??+ (await core.Supplier.get(this._options.environment)),+ `api/v1/sessions/${core.url.encodePathParam(session_id)}/turns/${core.url.encodePathParam(turn_id)}/events`,+ ),+ method: "POST",+ headers: _headers,+ contentType: "application/json",+ queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),+ requestType: "json",+ body: mergeAdditionalBodyParameters(+ serializers.CreateTurnEventRequest.jsonOrThrow(request, {+ unrecognizedObjectKeys: "passthrough",+ allowUnrecognizedUnionMembers: true,+ allowUnrecognizedEnumValues: true,+ omitUndefined: true,+ }),+ requestOptions?.additionalBodyParameters,+ ),+ timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,+ maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,+ abortSignal: requestOptions?.abortSignal,+ fetchFn: this._options?.fetch,+ logging: this._options.logging,+ });+ if (_response.ok) {+ return {+ data: serializers.CreateTurnEventResponse.parseOrThrow(_response.body, {+ unrecognizedObjectKeys: "passthrough",+ allowUnrecognizedUnionMembers: true,+ allowUnrecognizedEnumValues: true,+ skipValidation: true,+ breadcrumbsPrefix: ["response"],+ }),+ rawResponse: _response.rawResponse,+ };+ }++ if (_response.error.reason === "status-code") {+ switch (_response.error.statusCode) {+ case 400:+ throw new TrueForge.BadRequestError(+ serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {+ unrecognizedObjectKeys: "passthrough",+ allowUnrecognizedUnionMembers: true,+ allowUnrecognizedEnumValues: true,+ skipValidation: true,+ breadcrumbsPrefix: ["response"],+ }),+ _response.rawResponse,+ );+ case 403:+ throw new TrueForge.ForbiddenError(+ serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {+ unrecognizedObjectKeys: "passthrough",+ allowUnrecognizedUnionMembers: true,+ allowUnrecognizedEnumValues: true,+ skipValidation: true,+ breadcrumbsPrefix: ["response"],+ }),+ _response.rawResponse,+ );+ case 404:+ throw new TrueForge.NotFoundError(+ serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {+ unrecognizedObjectKeys: "passthrough",+ allowUnrecognizedUnionMembers: true,+ allowUnrecognizedEnumValues: true,+ skipValidation: true,+ breadcrumbsPrefix: ["response"],+ }),+ _response.rawResponse,+ );+ case 409:+ throw new TrueForge.ConflictError(+ serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {+ unrecognizedObjectKeys: "passthrough",+ allowUnrecognizedUnionMembers: true,+ allowUnrecognizedEnumValues: true,+ skipValidation: true,+ breadcrumbsPrefix: ["response"],+ }),+ _response.rawResponse,+ );+ default:+ throw new errors.TrueForgeError({+ statusCode: _response.error.statusCode,+ body: _response.error.body,+ rawResponse: _response.rawResponse,+ });+ }+ }++ return handleNonStatusCodeError(+ _response.error,+ _response.rawResponse,+ "POST",+ "/api/v1/sessions/{session_id}/turns/{turn_id}/events",+ );+ }+/*** Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive β events after this sequence number are replayed).*/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.tsnew file mode 100644index 000000000..3424eae7f--- /dev/null+++ b/packages/trueforge-sdk/src/api/resources/sessions/client/requests/CreateTurnEventRequest.ts@@ -0,0 +1,21 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../../../../index.js";++/**+ * @example+ * {+ * events: [{+ * approval: {+ * status: "allow"+ * },+ * threadId: "thread_id",+ * toolCallId: "tool_call_id",+ * type: "user.tool_approval"+ * }]+ * }+ */+export interface CreateTurnEventRequest {+ /** One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`). */+ events: TrueForge.TurnInboundEventItem[];+}diff --git a/packages/trueforge-sdk/src/api/resources/sessions/client/requests/index.ts b/packages/trueforge-sdk/src/api/resources/sessions/client/requests/index.tsindex 5299c014d..1d3fd9bcb 100644--- a/packages/trueforge-sdk/src/api/resources/sessions/client/requests/index.ts+++ b/packages/trueforge-sdk/src/api/resources/sessions/client/requests/index.ts@@ -1,5 +1,6 @@export type { CancelSessionRequest } from "./CancelSessionRequest.js";export type { CreateSessionRequest } from "./CreateSessionRequest.js";+export type { CreateTurnEventRequest } from "./CreateTurnEventRequest.js";export type { CreateTurnSessionsRequest } from "./CreateTurnSessionsRequest.js";export type { CreateTurnSessionsStreamRequest } from "./CreateTurnSessionsStreamRequest.js";export type { DownloadSandboxFileSessionsRequest } from "./DownloadSandboxFileSessionsRequest.js";diff --git a/packages/trueforge-sdk/src/api/types/CreateTurnEventResponse.ts b/packages/trueforge-sdk/src/api/types/CreateTurnEventResponse.tsnew file mode 100644index 000000000..54c94cc2f--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/CreateTurnEventResponse.ts@@ -0,0 +1,8 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../index.js";++export interface CreateTurnEventResponse {+ /** Events with server-minted `id` and `created_at`, in request order. */+ data: TrueForge.CreateTurnEventResponseDataItem[];+}diff --git a/packages/trueforge-sdk/src/api/types/CreateTurnEventResponseDataItem.ts b/packages/trueforge-sdk/src/api/types/CreateTurnEventResponseDataItem.tsnew file mode 100644index 000000000..c7632854a--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/CreateTurnEventResponseDataItem.ts@@ -0,0 +1,8 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../index.js";++export type CreateTurnEventResponseDataItem =+ | 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 8d305b279..d47a36b5b 100644--- a/packages/trueforge-sdk/src/api/types/SessionEvent.ts+++ b/packages/trueforge-sdk/src/api/types/SessionEvent.ts@@ -14,4 +14,7 @@ export type SessionEvent =| TrueForge.ToolResponseRequiredEvent| TrueForge.TurnCreatedEvent| TrueForge.TurnDoneEvent- | TrueForge.TurnUpdateEvent;+ | TrueForge.TurnUpdateEvent+ | TrueForge.UserToolApprovalEvent+ | TrueForge.UserToolApprovalPolicyEvent+ | TrueForge.UserToolResponseEvent;diff --git a/packages/trueforge-sdk/src/api/types/ToolApprovalPolicyAllowSession.ts b/packages/trueforge-sdk/src/api/types/ToolApprovalPolicyAllowSession.tsnew file mode 100644index 000000000..a01e8383b--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/ToolApprovalPolicyAllowSession.ts@@ -0,0 +1,7 @@+// This file was auto-generated by Fern from our API Definition.++export interface ToolApprovalPolicyAllowSession {+ /** ISO 8601 timestamp when this session allow expires. Omit to allow for the whole session. */+ expireAt?: string;+ type: "allow_session";+}diff --git a/packages/trueforge-sdk/src/api/types/ToolApprovalPolicyItem.ts b/packages/trueforge-sdk/src/api/types/ToolApprovalPolicyItem.tsnew file mode 100644index 000000000..bcbe037cd--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/ToolApprovalPolicyItem.ts@@ -0,0 +1,11 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../index.js";++export interface ToolApprovalPolicyItem {+ action: TrueForge.ToolApprovalPolicyAllowSession;+ /** Tool name on that server. */+ name: string;+ /** MCP server name. */+ serverName: string;+}diff --git a/packages/trueforge-sdk/src/api/types/TurnInboundEventItem.ts b/packages/trueforge-sdk/src/api/types/TurnInboundEventItem.tsnew file mode 100644index 000000000..70bc1cae6--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/TurnInboundEventItem.ts@@ -0,0 +1,8 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../index.js";++export type TurnInboundEventItem =+ | TrueForge.UserToolApprovalInputEvent+ | TrueForge.UserToolApprovalPolicyMessage+ | TrueForge.UserToolResponseInputEvent;diff --git a/packages/trueforge-sdk/src/api/types/TurnStreamingEvent.ts b/packages/trueforge-sdk/src/api/types/TurnStreamingEvent.tsindex 61f6515ac..35de83b0b 100644--- a/packages/trueforge-sdk/src/api/types/TurnStreamingEvent.ts+++ b/packages/trueforge-sdk/src/api/types/TurnStreamingEvent.ts@@ -15,4 +15,7 @@ export type TurnStreamingEvent =| TrueForge.ToolResponseRequiredEvent| TrueForge.TurnCreatedEvent| TrueForge.TurnDoneEvent- | TrueForge.TurnUpdateEvent;+ | TrueForge.TurnUpdateEvent+ | TrueForge.UserToolApprovalEvent+ | TrueForge.UserToolApprovalPolicyEvent+ | TrueForge.UserToolResponseEvent;diff --git a/packages/trueforge-sdk/src/api/types/UserToolApprovalEvent.ts b/packages/trueforge-sdk/src/api/types/UserToolApprovalEvent.tsnew file mode 100644index 000000000..d026b2b79--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/UserToolApprovalEvent.ts@@ -0,0 +1,16 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../index.js";++export interface UserToolApprovalEvent {+ approval: TrueForge.ApprovalDecision;+ /** ISO 8601 event timestamp. */+ createdAt: string;+ /** Unique identifier for the event (monotonic ULID). */+ id: string;+ /** Thread that owns the pending tool call. */+ threadId: string;+ /** Tool call id being approved or denied. */+ toolCallId: string;+ type: "user.tool_approval";+}diff --git a/packages/trueforge-sdk/src/api/types/UserToolApprovalPolicyEvent.ts b/packages/trueforge-sdk/src/api/types/UserToolApprovalPolicyEvent.tsnew file mode 100644index 000000000..0b9008ac0--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/UserToolApprovalPolicyEvent.ts@@ -0,0 +1,13 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../index.js";++export interface UserToolApprovalPolicyEvent {+ /** ISO 8601 event timestamp. */+ createdAt: string;+ /** Unique identifier for the event (monotonic ULID). */+ id: string;+ /** One or more (server_name, name) policy entries. */+ policies: TrueForge.ToolApprovalPolicyItem[];+ type: "user.tool_approval_policy";+}diff --git a/packages/trueforge-sdk/src/api/types/UserToolApprovalPolicyMessage.ts b/packages/trueforge-sdk/src/api/types/UserToolApprovalPolicyMessage.tsnew file mode 100644index 000000000..703d45998--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/UserToolApprovalPolicyMessage.ts@@ -0,0 +1,9 @@+// This file was auto-generated by Fern from our API Definition.++import type * as TrueForge from "../index.js";++export interface UserToolApprovalPolicyMessage {+ /** One or more (server_name, name) policy entries. */+ policies: TrueForge.ToolApprovalPolicyItem[];+ type: "user.tool_approval_policy";+}diff --git a/packages/trueforge-sdk/src/api/types/UserToolResponseEvent.ts b/packages/trueforge-sdk/src/api/types/UserToolResponseEvent.tsnew file mode 100644index 000000000..aec481da0--- /dev/null+++ b/packages/trueforge-sdk/src/api/types/UserToolResponseEvent.ts@@ -0,0 +1,15 @@+// This file was auto-generated by Fern from our API Definition.++export interface UserToolResponseEvent {+ /** Client-side tool result content. */+ content: string;+ /** ISO 8601 event timestamp. */+ createdAt: string;+ /** Unique identifier for the event (monotonic ULID). */+ id: string;+ /** Thread that owns the pending tool call. */+ threadId: string;+ /** Tool call id receiving the client response. */+ toolCallId: string;+ type: "user.tool_response";+}diff --git a/packages/trueforge-sdk/src/api/types/index.ts b/packages/trueforge-sdk/src/api/types/index.tsindex fcd37521a..77eafba9e 100644--- a/packages/trueforge-sdk/src/api/types/index.ts+++ b/packages/trueforge-sdk/src/api/types/index.ts@@ -49,6 +49,8 @@ export * from "./ContextManagementConfig.js";export * from "./CreatedBySubject.js";export * from "./CreateScheduleRunResponse.js";export * from "./CreateSessionAgent.js";+export * from "./CreateTurnEventResponse.js";+export * from "./CreateTurnEventResponseDataItem.js";export * from "./CronExpression.js";export * from "./CustomModelProvider.js";export * from "./DaytonaSandboxProviderAuth.js";@@ -203,6 +205,8 @@ export * from "./ThreadStateError.js";export * from "./Timezone.js";export * from "./TogetherAiModelProvider.js";export * from "./TokenPagination.js";+export * from "./ToolApprovalPolicyAllowSession.js";+export * from "./ToolApprovalPolicyItem.js";export * from "./ToolApprovalRequiredEvent.js";export * from "./ToolCall.js";export * from "./ToolCallRef.js";@@ -217,6 +221,7 @@ export * from "./Turn.js";export * from "./TurnCreatedEvent.js";export * from "./TurnDoneEvent.js";export * from "./TurnDoneEventState.js";+export * from "./TurnInboundEventItem.js";export * from "./TurnInputItem.js";export * from "./TurnMetrics.js";export * from "./TurnState.js";@@ -235,7 +240,11 @@ export * from "./TurnUpdateStateRunning.js";export * from "./UserMessage.js";export * from "./UserMessageContent.js";export * from "./UserMessageContentItem.js";+export * from "./UserToolApprovalEvent.js";export * from "./UserToolApprovalInputEvent.js";+export * from "./UserToolApprovalPolicyEvent.js";+export * from "./UserToolApprovalPolicyMessage.js";+export * from "./UserToolResponseEvent.js";export * from "./UserToolResponseInputEvent.js";export * from "./WebSearchCapability.js";export * from "./WebSearchConfig.js";diff --git a/packages/trueforge-sdk/src/serialization/resources/sessions/client/requests/CreateTurnEventRequest.ts b/packages/trueforge-sdk/src/serialization/resources/sessions/client/requests/CreateTurnEventRequest.tsnew file mode 100644index 000000000..41d8a1a4a--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/resources/sessions/client/requests/CreateTurnEventRequest.ts@@ -0,0 +1,19 @@+// 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 { TurnInboundEventItem } from "../../../../types/TurnInboundEventItem.js";++export const CreateTurnEventRequest: core.serialization.Schema<+ serializers.CreateTurnEventRequest.Raw,+ TrueForge.CreateTurnEventRequest+> = core.serialization.object({+ events: core.serialization.list(TurnInboundEventItem),+});++export declare namespace CreateTurnEventRequest {+ export interface Raw {+ events: TurnInboundEventItem.Raw[];+ }+}diff --git a/packages/trueforge-sdk/src/serialization/resources/sessions/client/requests/index.ts b/packages/trueforge-sdk/src/serialization/resources/sessions/client/requests/index.tsindex 834355641..5a5183300 100644--- a/packages/trueforge-sdk/src/serialization/resources/sessions/client/requests/index.ts+++ b/packages/trueforge-sdk/src/serialization/resources/sessions/client/requests/index.ts@@ -1,5 +1,6 @@export { CancelSessionRequest } from "./CancelSessionRequest.js";export { CreateSessionRequest } from "./CreateSessionRequest.js";+export { CreateTurnEventRequest } from "./CreateTurnEventRequest.js";export { CreateTurnSessionsRequest } from "./CreateTurnSessionsRequest.js";export { CreateTurnSessionsStreamRequest } from "./CreateTurnSessionsStreamRequest.js";export { UpdateSessionRequest } from "./UpdateSessionRequest.js";diff --git a/packages/trueforge-sdk/src/serialization/types/CreateTurnEventResponse.ts b/packages/trueforge-sdk/src/serialization/types/CreateTurnEventResponse.tsnew file mode 100644index 000000000..48c22ebe6--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/CreateTurnEventResponse.ts@@ -0,0 +1,19 @@+// 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 { CreateTurnEventResponseDataItem } from "./CreateTurnEventResponseDataItem.js";++export const CreateTurnEventResponse: core.serialization.ObjectSchema<+ serializers.CreateTurnEventResponse.Raw,+ TrueForge.CreateTurnEventResponse+> = core.serialization.object({+ data: core.serialization.list(CreateTurnEventResponseDataItem),+});++export declare namespace CreateTurnEventResponse {+ export interface Raw {+ data: CreateTurnEventResponseDataItem.Raw[];+ }+}diff --git a/packages/trueforge-sdk/src/serialization/types/CreateTurnEventResponseDataItem.ts b/packages/trueforge-sdk/src/serialization/types/CreateTurnEventResponseDataItem.tsnew file mode 100644index 000000000..5f8ccdb9b--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/CreateTurnEventResponseDataItem.ts@@ -0,0 +1,21 @@+// 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 { UserToolApprovalEvent } from "./UserToolApprovalEvent.js";+import { UserToolApprovalPolicyEvent } from "./UserToolApprovalPolicyEvent.js";+import { UserToolResponseEvent } from "./UserToolResponseEvent.js";++export const CreateTurnEventResponseDataItem: core.serialization.Schema<+ serializers.CreateTurnEventResponseDataItem.Raw,+ TrueForge.CreateTurnEventResponseDataItem+> = core.serialization.undiscriminatedUnion([+ UserToolApprovalEvent,+ UserToolApprovalPolicyEvent,+ UserToolResponseEvent,+]);++export declare namespace CreateTurnEventResponseDataItem {+ export type 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 bd14830f2..68d0482fc 100644--- a/packages/trueforge-sdk/src/serialization/types/SessionEvent.ts+++ b/packages/trueforge-sdk/src/serialization/types/SessionEvent.ts@@ -15,6 +15,9 @@ import { ToolResponseRequiredEvent } from "./ToolResponseRequiredEvent.js";import { TurnCreatedEvent } from "./TurnCreatedEvent.js";import { TurnDoneEvent } from "./TurnDoneEvent.js";import { TurnUpdateEvent } from "./TurnUpdateEvent.js";+import { UserToolApprovalEvent } from "./UserToolApprovalEvent.js";+import { UserToolApprovalPolicyEvent } from "./UserToolApprovalPolicyEvent.js";+import { UserToolResponseEvent } from "./UserToolResponseEvent.js";export const SessionEvent: core.serialization.Schema<serializers.SessionEvent.Raw, TrueForge.SessionEvent> =core.serialization.undiscriminatedUnion([@@ -30,6 +33,9 @@ export const SessionEvent: core.serialization.Schema<serializers.SessionEvent.RaTurnCreatedEvent,TurnDoneEvent,TurnUpdateEvent,+ UserToolApprovalEvent,+ UserToolApprovalPolicyEvent,+ UserToolResponseEvent,]);export declare namespace SessionEvent {@@ -45,5 +51,8 @@ export declare namespace SessionEvent {| ToolResponseRequiredEvent.Raw| TurnCreatedEvent.Raw| TurnDoneEvent.Raw- | TurnUpdateEvent.Raw;+ | TurnUpdateEvent.Raw+ | UserToolApprovalEvent.Raw+ | UserToolApprovalPolicyEvent.Raw+ | UserToolResponseEvent.Raw;}diff --git a/packages/trueforge-sdk/src/serialization/types/ToolApprovalPolicyAllowSession.ts b/packages/trueforge-sdk/src/serialization/types/ToolApprovalPolicyAllowSession.tsnew file mode 100644index 000000000..9bc42fd53--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/ToolApprovalPolicyAllowSession.ts@@ -0,0 +1,20 @@+// 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 ToolApprovalPolicyAllowSession: core.serialization.ObjectSchema<+ serializers.ToolApprovalPolicyAllowSession.Raw,+ TrueForge.ToolApprovalPolicyAllowSession+> = core.serialization.object({+ expireAt: core.serialization.property("expire_at", core.serialization.string().optional()),+ type: core.serialization.stringLiteral("allow_session"),+});++export declare namespace ToolApprovalPolicyAllowSession {+ export interface Raw {+ expire_at?: string | null;+ type: "allow_session";+ }+}diff --git a/packages/trueforge-sdk/src/serialization/types/ToolApprovalPolicyItem.ts b/packages/trueforge-sdk/src/serialization/types/ToolApprovalPolicyItem.tsnew file mode 100644index 000000000..ef64c3415--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/ToolApprovalPolicyItem.ts@@ -0,0 +1,23 @@+// 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 { ToolApprovalPolicyAllowSession } from "./ToolApprovalPolicyAllowSession.js";++export const ToolApprovalPolicyItem: core.serialization.ObjectSchema<+ serializers.ToolApprovalPolicyItem.Raw,+ TrueForge.ToolApprovalPolicyItem+> = core.serialization.object({+ action: ToolApprovalPolicyAllowSession,+ name: core.serialization.string(),+ serverName: core.serialization.property("server_name", core.serialization.string()),+});++export declare namespace ToolApprovalPolicyItem {+ export interface Raw {+ action: ToolApprovalPolicyAllowSession.Raw;+ name: string;+ server_name: string;+ }+}diff --git a/packages/trueforge-sdk/src/serialization/types/TurnInboundEventItem.ts b/packages/trueforge-sdk/src/serialization/types/TurnInboundEventItem.tsnew file mode 100644index 000000000..4865759c9--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/TurnInboundEventItem.ts@@ -0,0 +1,24 @@+// 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 { UserToolApprovalInputEvent } from "./UserToolApprovalInputEvent.js";+import { UserToolApprovalPolicyMessage } from "./UserToolApprovalPolicyMessage.js";+import { UserToolResponseInputEvent } from "./UserToolResponseInputEvent.js";++export const TurnInboundEventItem: core.serialization.Schema<+ serializers.TurnInboundEventItem.Raw,+ TrueForge.TurnInboundEventItem+> = core.serialization.undiscriminatedUnion([+ UserToolApprovalInputEvent,+ UserToolApprovalPolicyMessage,+ UserToolResponseInputEvent,+]);++export declare namespace TurnInboundEventItem {+ export type Raw =+ | UserToolApprovalInputEvent.Raw+ | UserToolApprovalPolicyMessage.Raw+ | UserToolResponseInputEvent.Raw;+}diff --git a/packages/trueforge-sdk/src/serialization/types/TurnStreamingEvent.ts b/packages/trueforge-sdk/src/serialization/types/TurnStreamingEvent.tsindex 29756a573..d160ee721 100644--- a/packages/trueforge-sdk/src/serialization/types/TurnStreamingEvent.ts+++ b/packages/trueforge-sdk/src/serialization/types/TurnStreamingEvent.ts@@ -16,6 +16,9 @@ import { ToolResponseRequiredEvent } from "./ToolResponseRequiredEvent.js";import { TurnCreatedEvent } from "./TurnCreatedEvent.js";import { TurnDoneEvent } from "./TurnDoneEvent.js";import { TurnUpdateEvent } from "./TurnUpdateEvent.js";+import { UserToolApprovalEvent } from "./UserToolApprovalEvent.js";+import { UserToolApprovalPolicyEvent } from "./UserToolApprovalPolicyEvent.js";+import { UserToolResponseEvent } from "./UserToolResponseEvent.js";export const TurnStreamingEvent: core.serialization.Schema<serializers.TurnStreamingEvent.Raw,@@ -34,6 +37,9 @@ export const TurnStreamingEvent: core.serialization.Schema<TurnCreatedEvent,TurnDoneEvent,TurnUpdateEvent,+ UserToolApprovalEvent,+ UserToolApprovalPolicyEvent,+ UserToolResponseEvent,]);export declare namespace TurnStreamingEvent {@@ -50,5 +56,8 @@ export declare namespace TurnStreamingEvent {| ToolResponseRequiredEvent.Raw| TurnCreatedEvent.Raw| TurnDoneEvent.Raw- | TurnUpdateEvent.Raw;+ | TurnUpdateEvent.Raw+ | UserToolApprovalEvent.Raw+ | UserToolApprovalPolicyEvent.Raw+ | UserToolResponseEvent.Raw;}diff --git a/packages/trueforge-sdk/src/serialization/types/UserToolApprovalEvent.ts b/packages/trueforge-sdk/src/serialization/types/UserToolApprovalEvent.tsnew file mode 100644index 000000000..edce2158c--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/UserToolApprovalEvent.ts@@ -0,0 +1,29 @@+// 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 { ApprovalDecision } from "./ApprovalDecision.js";++export const UserToolApprovalEvent: core.serialization.ObjectSchema<+ serializers.UserToolApprovalEvent.Raw,+ TrueForge.UserToolApprovalEvent+> = core.serialization.object({+ approval: ApprovalDecision,+ createdAt: core.serialization.property("created_at", core.serialization.string()),+ id: core.serialization.string(),+ threadId: core.serialization.property("thread_id", core.serialization.string()),+ toolCallId: core.serialization.property("tool_call_id", core.serialization.string()),+ type: core.serialization.stringLiteral("user.tool_approval"),+});++export declare namespace UserToolApprovalEvent {+ export interface Raw {+ approval: ApprovalDecision.Raw;+ created_at: string;+ id: string;+ thread_id: string;+ tool_call_id: string;+ type: "user.tool_approval";+ }+}diff --git a/packages/trueforge-sdk/src/serialization/types/UserToolApprovalPolicyEvent.ts b/packages/trueforge-sdk/src/serialization/types/UserToolApprovalPolicyEvent.tsnew file mode 100644index 000000000..80d201d3c--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/UserToolApprovalPolicyEvent.ts@@ -0,0 +1,25 @@+// 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 { ToolApprovalPolicyItem } from "./ToolApprovalPolicyItem.js";++export const UserToolApprovalPolicyEvent: core.serialization.ObjectSchema<+ serializers.UserToolApprovalPolicyEvent.Raw,+ TrueForge.UserToolApprovalPolicyEvent+> = core.serialization.object({+ createdAt: core.serialization.property("created_at", core.serialization.string()),+ id: core.serialization.string(),+ policies: core.serialization.list(ToolApprovalPolicyItem),+ type: core.serialization.stringLiteral("user.tool_approval_policy"),+});++export declare namespace UserToolApprovalPolicyEvent {+ export interface Raw {+ created_at: string;+ id: string;+ policies: ToolApprovalPolicyItem.Raw[];+ type: "user.tool_approval_policy";+ }+}diff --git a/packages/trueforge-sdk/src/serialization/types/UserToolApprovalPolicyMessage.ts b/packages/trueforge-sdk/src/serialization/types/UserToolApprovalPolicyMessage.tsnew file mode 100644index 000000000..a8ca2cea7--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/UserToolApprovalPolicyMessage.ts@@ -0,0 +1,21 @@+// 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 { ToolApprovalPolicyItem } from "./ToolApprovalPolicyItem.js";++export const UserToolApprovalPolicyMessage: core.serialization.ObjectSchema<+ serializers.UserToolApprovalPolicyMessage.Raw,+ TrueForge.UserToolApprovalPolicyMessage+> = core.serialization.object({+ policies: core.serialization.list(ToolApprovalPolicyItem),+ type: core.serialization.stringLiteral("user.tool_approval_policy"),+});++export declare namespace UserToolApprovalPolicyMessage {+ export interface Raw {+ policies: ToolApprovalPolicyItem.Raw[];+ type: "user.tool_approval_policy";+ }+}diff --git a/packages/trueforge-sdk/src/serialization/types/UserToolResponseEvent.ts b/packages/trueforge-sdk/src/serialization/types/UserToolResponseEvent.tsnew file mode 100644index 000000000..bcce18b61--- /dev/null+++ b/packages/trueforge-sdk/src/serialization/types/UserToolResponseEvent.ts@@ -0,0 +1,28 @@+// 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 UserToolResponseEvent: core.serialization.ObjectSchema<+ serializers.UserToolResponseEvent.Raw,+ TrueForge.UserToolResponseEvent+> = core.serialization.object({+ content: core.serialization.string(),+ createdAt: core.serialization.property("created_at", core.serialization.string()),+ id: core.serialization.string(),+ threadId: core.serialization.property("thread_id", core.serialization.string()),+ toolCallId: core.serialization.property("tool_call_id", core.serialization.string()),+ type: core.serialization.stringLiteral("user.tool_response"),+});++export declare namespace UserToolResponseEvent {+ export interface Raw {+ content: string;+ created_at: string;+ id: string;+ thread_id: string;+ tool_call_id: string;+ type: "user.tool_response";+ }+}diff --git a/packages/trueforge-sdk/src/serialization/types/index.ts b/packages/trueforge-sdk/src/serialization/types/index.tsindex fcd37521a..77eafba9e 100644--- a/packages/trueforge-sdk/src/serialization/types/index.ts+++ b/packages/trueforge-sdk/src/serialization/types/index.ts@@ -49,6 +49,8 @@ export * from "./ContextManagementConfig.js";export * from "./CreatedBySubject.js";export * from "./CreateScheduleRunResponse.js";export * from "./CreateSessionAgent.js";+export * from "./CreateTurnEventResponse.js";+export * from "./CreateTurnEventResponseDataItem.js";export * from "./CronExpression.js";export * from "./CustomModelProvider.js";export * from "./DaytonaSandboxProviderAuth.js";@@ -203,6 +205,8 @@ export * from "./ThreadStateError.js";export * from "./Timezone.js";export * from "./TogetherAiModelProvider.js";export * from "./TokenPagination.js";+export * from "./ToolApprovalPolicyAllowSession.js";+export * from "./ToolApprovalPolicyItem.js";export * from "./ToolApprovalRequiredEvent.js";export * from "./ToolCall.js";export * from "./ToolCallRef.js";@@ -217,6 +221,7 @@ export * from "./Turn.js";export * from "./TurnCreatedEvent.js";export * from "./TurnDoneEvent.js";export * from "./TurnDoneEventState.js";+export * from "./TurnInboundEventItem.js";export * from "./TurnInputItem.js";export * from "./TurnMetrics.js";export * from "./TurnState.js";@@ -235,7 +240,11 @@ export * from "./TurnUpdateStateRunning.js";export * from "./UserMessage.js";export * from "./UserMessageContent.js";export * from "./UserMessageContentItem.js";+export * from "./UserToolApprovalEvent.js";export * from "./UserToolApprovalInputEvent.js";+export * from "./UserToolApprovalPolicyEvent.js";+export * from "./UserToolApprovalPolicyMessage.js";+export * from "./UserToolResponseEvent.js";export * from "./UserToolResponseInputEvent.js";export * from "./WebSearchCapability.js";export * from "./WebSearchConfig.js";diff --git a/packages/trueforge-sdk/tests/wire/sessions.test.ts b/packages/trueforge-sdk/tests/wire/sessions.test.tsindex 0eb6c2dc9..1c585abaa 100644--- a/packages/trueforge-sdk/tests/wire/sessions.test.ts+++ b/packages/trueforge-sdk/tests/wire/sessions.test.ts@@ -1398,6 +1398,245 @@ describe("SessionsClient", () => {}).rejects.toThrow(TrueForgeTypes.NotFoundError);});+ 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",+ },+ ],+ };++ server+ .mockEndpoint()+ .post("/api/v1/sessions/session_id/turns/turn_id/events")+ .jsonBody(rawRequestBody)+ .respondWith()+ .statusCode(200)+ .jsonBody(rawResponseBody)+ .build();++ 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",+ },+ ],+ });+ expect(response).toEqual({+ data: [+ {+ approval: {+ status: "allow",+ },+ createdAt: "created_at",+ id: "id",+ threadId: "thread_id",+ toolCallId: "tool_call_id",+ type: "user.tool_approval",+ },+ ],+ });+ });++ 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 rawResponseBody = { error: { message: "message" } };++ server+ .mockEndpoint()+ .post("/api/v1/sessions/session_id/turns/turn_id/events")+ .jsonBody(rawRequestBody)+ .respondWith()+ .statusCode(400)+ .jsonBody(rawResponseBody)+ .build();++ await expect(async () => {+ return await client.sessions.createTurnEvent("session_id", "turn_id", {+ events: [+ {+ approval: {+ status: "allow",+ },+ threadId: "x",+ toolCallId: "x",+ type: "user.tool_approval",+ },+ {+ approval: {+ status: "allow",+ },+ threadId: "x",+ toolCallId: "x",+ type: "user.tool_approval",+ },+ ],+ });+ }).rejects.toThrow(TrueForgeTypes.BadRequestError);+ });++ 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 rawResponseBody = { error: { message: "message" } };++ server+ .mockEndpoint()+ .post("/api/v1/sessions/session_id/turns/turn_id/events")+ .jsonBody(rawRequestBody)+ .respondWith()+ .statusCode(403)+ .jsonBody(rawResponseBody)+ .build();++ await expect(async () => {+ return await client.sessions.createTurnEvent("session_id", "turn_id", {+ events: [+ {+ approval: {+ status: "allow",+ },+ threadId: "x",+ toolCallId: "x",+ type: "user.tool_approval",+ },+ {+ approval: {+ status: "allow",+ },+ threadId: "x",+ toolCallId: "x",+ type: "user.tool_approval",+ },+ ],+ });+ }).rejects.toThrow(TrueForgeTypes.ForbiddenError);+ });++ 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 rawResponseBody = { error: { message: "message" } };++ server+ .mockEndpoint()+ .post("/api/v1/sessions/session_id/turns/turn_id/events")+ .jsonBody(rawRequestBody)+ .respondWith()+ .statusCode(404)+ .jsonBody(rawResponseBody)+ .build();++ await expect(async () => {+ return await client.sessions.createTurnEvent("session_id", "turn_id", {+ events: [+ {+ approval: {+ status: "allow",+ },+ threadId: "x",+ toolCallId: "x",+ type: "user.tool_approval",+ },+ {+ approval: {+ status: "allow",+ },+ threadId: "x",+ toolCallId: "x",+ type: "user.tool_approval",+ },+ ],+ });+ }).rejects.toThrow(TrueForgeTypes.NotFoundError);+ });++ 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 rawResponseBody = { error: { message: "message" } };++ server+ .mockEndpoint()+ .post("/api/v1/sessions/session_id/turns/turn_id/events")+ .jsonBody(rawRequestBody)+ .respondWith()+ .statusCode(409)+ .jsonBody(rawResponseBody)+ .build();++ await expect(async () => {+ return await client.sessions.createTurnEvent("session_id", "turn_id", {+ events: [+ {+ approval: {+ status: "allow",+ },+ threadId: "x",+ toolCallId: "x",+ type: "user.tool_approval",+ },+ {+ approval: {+ status: "allow",+ },+ threadId: "x",+ toolCallId: "x",+ type: "user.tool_approval",+ },+ ],+ });+ }).rejects.toThrow(TrueForgeTypes.ConflictError);+ });+test("subscribe_to_turn (1)", async () => {const server = mockServerPool.createServer();const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });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 afc837de0..56ac6edcf 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@@ -35,16 +35,30 @@ function toUiTerminalTurnState(state: TrueForgeApi.TurnDoneEventState): Exclude<}}+/** SDK stream types the assistant-ui-runtime union does not include yet. */+// TODO: Remove this after we have migrated to the new schema.+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';+ }+> {+ return (+ event.type === 'turn.update' ||+ event.type === 'user.tool_approval' ||+ event.type === 'user.tool_response' ||+ event.type === 'user.tool_approval_policy'+ );+}+export function toUiSessionEvent(event: TrueForgeApi.SessionEvent): SessionEventItem['event'] | undefined {- // TODO: map turn.update when the runtime event union includes it- if (event.type === 'turn.update') return undefined;+ if (isUnmappedSdkEvent(event)) return undefined;if (event.type !== 'turn.done') return { ...event };return { ...event, state: toUiTerminalTurnState(event.state) };}export function toUiStreamingEvent(event: TrueForgeApi.TurnStreamingEvent): TurnStreamingEvent | undefined {- // TODO: map turn.update when the runtime event union includes it- if (event.type === 'turn.update') return undefined;+ if (isUnmappedSdkEvent(event)) return undefined;if (event.type !== 'turn.done') return { ...event };return { ...event, state: toUiTerminalTurnState(event.state) };}diff --git a/packages/trueforge/src/apis/turns.ts b/packages/trueforge/src/apis/turns.tsindex 4ffc8994c..c74b9ebcb 100644--- a/packages/trueforge/src/apis/turns.ts+++ b/packages/trueforge/src/apis/turns.ts@@ -22,6 +22,7 @@ import {isAgentInputUserMessage,isFileContentPart,McpConnectionError,+ newEventId,rawSandboxId,redisKey,SandboxError,@@ -42,6 +43,7 @@ import type { ISkillStore } from '../db/skillStore';import type { IWebSearchProviderStore } from '../db/webSearchProviderStore';import {createAndExecuteTurnRoute,+ createTurnEventRoute,downloadSandboxFileRoute,getTurnRoute,listTurnEventsRoute,@@ -923,12 +925,53 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {});};+ const createTurnEventHandler: RouteHandler<typeof createTurnEventRoute> = async c => {+ const { session_id: sessionId } = c.req.valid('param');+ const body = c.req.valid('json');+ const requestContext = deps.resolveRequestContext(c);+ const session = await deps.sessions.get({+ tenant_id: requestContext.tenant_id,+ session_id: sessionId,+ });+ if (!session) {+ return c.json({ error: { message: `Session not found: ${sessionId}` } }, 404);+ }+ if (+ !isSessionOwner({+ subject_id: requestContext.subject.id,+ created_by_subject: session.record.created_by_subject,+ })+ ) {+ return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);+ }++ const createdAt = new Date().toISOString();+ const events = body.events.map(payload => {+ const id = newEventId();+ return {+ event_id: id,+ payload,+ created_at: createdAt,+ created: { ...payload, id, created_at: createdAt },+ };+ });++ // Persist + apply/wake land later. Mint ids now so the client contract is stable.+ // await deps.sessionStore.insertTurnInboundEvents({+ // session_id: sessionId,+ // turn_id: turnId,+ // events: events.map(({ event_id, payload, created_at }) => ({ event_id, payload, created_at })),+ // });+ return c.json({ data: events.map(e => e.created) }, 201);+ };+const router = new OpenAPIHono();router.openapi(createAndExecuteTurnRoute, createAndExecuteTurnHandler);router.openapi(listTurnsRoute, listTurnsHandler);router.openapi(getTurnRoute, getTurnHandler);router.openapi(downloadSandboxFileRoute, downloadSandboxFileHandler);router.openapi(listTurnEventsRoute, listTurnEventsHandler);+ router.openapi(createTurnEventRoute, createTurnEventHandler);router.openapi(subscribeTurnRoute, subscribeTurnHandler);return router;}diff --git a/packages/trueforge/src/routes/turnRoutes.ts b/packages/trueforge/src/routes/turnRoutes.tsindex 14f9b9398..2a270a2af 100644--- a/packages/trueforge/src/routes/turnRoutes.ts+++ b/packages/trueforge/src/routes/turnRoutes.ts@@ -5,7 +5,11 @@*/import { createRoute, z } from '@hono/zod-openapi';import { RequestErrorResponseSchema } from '../schemas/errors';-import { TurnStreamingEventSchema } from '../schemas/events';+import {+ CreateTurnEventRequestSchema,+ CreateTurnEventResponseSchema,+ TurnStreamingEventSchema,+} from '../schemas/events';import {CreateTurnRequestSchema,DownloadSandboxFileRequestQuerySchema,@@ -168,6 +172,45 @@ export const listTurnEventsRoute = createRoute({},});+export const createTurnEventRoute = createRoute({+ method: 'post',+ path: '/{session_id}/turns/{turn_id}/events',+ tags: [OpenApiTag.AGENT_SESSIONS],+ summary: 'Create turn events',+ description: 'Create events for a turn. Only the session creator may create them.',+ 'x-fern-sdk-group-name': ['sessions'],+ 'x-fern-sdk-method-name': 'create_turn_event',+ request: {+ params: TurnIdParamsSchema,+ body: {+ content: { 'application/json': { schema: CreateTurnEventRequestSchema } },+ required: true,+ },+ },+ responses: {+ 201: {+ content: { 'application/json': { schema: CreateTurnEventResponseSchema } },+ description: 'Events created.',+ },+ 400: {+ content: { 'application/json': { schema: RequestErrorResponseSchema } },+ description: 'Invalid request body.',+ },+ 403: {+ content: { 'application/json': { schema: RequestErrorResponseSchema } },+ description: 'Caller is not the session creator.',+ },+ 404: {+ content: { 'application/json': { schema: RequestErrorResponseSchema } },+ description: 'Session or turn not found.',+ },+ 409: {+ content: { 'application/json': { schema: RequestErrorResponseSchema } },+ description: 'Turn is terminal, or an event id already exists.',+ },+ },+});+export const createAndExecuteTurnRoute = createRoute({method: 'post',path: '/{session_id}/turns',diff --git a/packages/trueforge/src/schemas/events.ts b/packages/trueforge/src/schemas/events.tsindex 4b702a6e1..d14a4ffb9 100644--- a/packages/trueforge/src/schemas/events.ts+++ b/packages/trueforge/src/schemas/events.ts@@ -9,6 +9,7 @@ import {TokenPaginationSchema,TurnCreatedEventSchema,TurnDoneEventSchema,+ TurnInboundEventItemSchema,TurnUpdateEventSchema,} from '@truefoundry/trueforge-core/agent-session';import {@@ -22,12 +23,38 @@ import {ToolApprovalRequiredEventSchema,ToolResponseEventSchema,ToolResponseRequiredEventSchema,+ UserToolApprovalEventSchema,+ UserToolApprovalPolicyEventSchema,+ UserToolResponseEventSchema,} from '@truefoundry/trueforge-core/core';import { EVENTS_PAGE_LIMIT } from './common';export type { TurnCreatedEvent } from '@truefoundry/trueforge-core/agent-session';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`).'),+ })+ .openapi('CreateTurnEventRequest');++export const CreateTurnEventResponseSchema = z+ .object({+ data: z+ .array(+ z.discriminatedUnion('type', [+ UserToolApprovalEventSchema,+ UserToolResponseEventSchema,+ UserToolApprovalPolicyEventSchema,+ ]),+ )+ .describe('Events with server-minted `id` and `created_at`, in request order.'),+ })+ .openapi('CreateTurnEventResponse');+/** Live SSE stream for session turns β content events, deltas and lifecycle. */export const TurnStreamingEventSchema = z.discriminatedUnion('type', [@@ -41,6 +68,9 @@ export const TurnStreamingEventSchema = zSandboxCreatedEventSchema,ToolApprovalRequiredEventSchema,ToolResponseRequiredEventSchema,+ UserToolApprovalEventSchema,+ UserToolResponseEventSchema,+ UserToolApprovalPolicyEventSchema,TurnCreatedEventSchema,TurnUpdateEventSchema,TurnDoneEventSchema,diff --git a/packages/trueforge/tests/unit/apis/sessionHttp.test.ts b/packages/trueforge/tests/unit/apis/sessionHttp.test.tsindex 5e64789f2..b9102a1df 100644--- a/packages/trueforge/tests/unit/apis/sessionHttp.test.ts+++ b/packages/trueforge/tests/unit/apis/sessionHttp.test.ts@@ -3,14 +3,17 @@ import { AgentSpecSchema, Sessions } from '@truefoundry/trueforge-core/agent-sesimport { RequestReplyRouter } from '@truefoundry/trueforge-core/request-reply';import { createClient } from 'redis';import { createLogger } from 'winston';+import { makeCreateTurnInput } from '../../../../trueforge-core/tests/agent-session/testHelpers';import { createInternalMetricsRouter } from '../../../src/apis/sessionMetrics';import {createInternalSessionsRouter,createSessionsRouter,type SessionsRouterDeps,} from '../../../src/apis/sessions';+import { createTurnsRouter } from '../../../src/apis/turns';import { TrueForgeAuthorizer, type Authorizer } from '../../../src/auth/authorizer';import { STANDALONE_REQUEST_CONTEXT } from '../../../src/auth/identity';+import { McpServerWithAuthStore } from '../../../src/db/McpServerWithAuthStore';import { migrateSqliteToLatest } from '../../../src/db/migrateSqlite';import { SqliteAgentStore } from '../../../src/db/sqlite/agent-store/SqliteAgentStore';import { createSqliteDb } from '../../../src/db/sqlite/client';@@ -20,8 +23,10 @@ import { SqliteSandboxProviderStore } from '../../../src/db/sqlite/sandbox-proviimport { SqliteSessionMetricsStore } from '../../../src/db/sqlite/session-metrics/SqliteSessionMetricsStore';import { SqliteSessionStore } from '../../../src/db/sqlite/session-store/SqliteSessionStore';import { SqliteSkillStore } from '../../../src/db/sqlite/skill-store/SqliteSkillStore';+import { SqliteOAuthTokenStore } from '../../../src/db/sqlite/token-store/SqliteOAuthTokenStore';import { SqliteWebSearchProviderStore } from '../../../src/db/sqlite/web-search-provider-store/SqliteWebSearchProviderStore';import { ActiveTurnRegistry } from '../../../src/runtime/activeTurns';+import { EventSubscriptionRegistry } from '../../../src/runtime/event-subscription/index.js';import { ListSessionsResponseSchema } from '../../../src/schemas/session';import {GetSessionMetricsChartDataResponseSchema,@@ -108,6 +113,30 @@ describe('sessions HTTP agent binding', () => {sessionDeps = deps;app = new OpenAPIHono();app.route('/', createSessionsRouter(deps));+ const tokenStore = new SqliteOAuthTokenStore(db);+ app.route(+ '/',+ createTurnsRouter({+ sessions,+ sessionStore,+ activeTurns: deps.activeTurns,+ resolveModelProviderStore: () => modelProviderStore,+ resolveMcpServerStore: () =>+ new McpServerWithAuthStore({+ store: mcpServerStore,+ tokenStore,+ clientName: 'test-client',+ }),+ resolveSkillStore: () => skillStore,+ resolveAgentStore: () => agentStore,+ eventSubscriptions: new EventSubscriptionRegistry(undefined),+ resolveSandboxProviderStore: () => sandboxProviderStore,+ resolveWebSearchProviderStore: () => webSearchProviderStore,+ logger: deps.logger,+ resolveRequestContext: deps.resolveRequestContext,+ authorizer: deps.authorizer,+ }),+ );app.route('/api/internal/sessions', createInternalSessionsRouter(deps));app.route('/api/internal/metrics',@@ -423,10 +452,88 @@ describe('sessions HTTP agent binding', () => {expect(eventsForbidden.status).toBe(403);expect(await eventsForbidden.json()).toEqual(forbiddenBody);+ const sendEventsForbidden = await app.request(+ '/other-user-session/turns/any-turn/events',+ jsonInit('POST', {+ events: [+ {+ type: 'user.tool_approval',+ thread_id: 'main',+ tool_call_id: 'tc-1',+ approval: { status: 'allow' },+ },+ ],+ }),+ );+ expect(sendEventsForbidden.status).toBe(403);+ expect(await sendEventsForbidden.json()).toEqual(forbiddenBody);+const allowed = await app.request(`/${json.data.id}`);expect(allowed.status).toBe(200);});+ it('POST /sessions/{id}/turns/{turn_id}/events mints ids for events', async () => {+ const created = await app.request('/', jsonInit('POST', { agent: { spec: inlineSpec } }));+ expect(created.status).toBe(201);+ const { data: session } = (await created.json()) as { data: { id: string } };+ await sessionStore.createTurn(makeCreateTurnInput({ sessionId: session.id, turnId: 'tip-1' }));++ const res = await app.request(+ `/${session.id}/turns/tip-1/events`,+ jsonInit('POST', {+ events: [+ {+ type: 'user.tool_approval',+ thread_id: 'main',+ tool_call_id: 'tc-1',+ approval: { status: 'allow' },+ },+ {+ type: 'user.tool_approval_policy',+ policies: [+ {+ server_name: 'github',+ name: 'create_issue',+ action: { type: 'allow_session' },+ },+ ],+ },+ ],+ }),+ );+ expect(res.status).toBe(201);+ const body = (await res.json()) as {+ data: Array<{+ id: string;+ created_at: string;+ type: string;+ thread_id?: string;+ tool_call_id?: string;+ approval?: { status: string };+ policies?: unknown[];+ }>;+ };+ expect(body.data).toHaveLength(2);+ expect(body.data[0]).toMatchObject({+ type: 'user.tool_approval',+ thread_id: 'main',+ tool_call_id: 'tc-1',+ approval: { status: 'allow' },+ });+ expect(body.data[0]?.id).toEqual(expect.any(String));+ expect(body.data[0]?.created_at).toEqual(expect.any(String));+ expect(body.data[1]).toMatchObject({+ type: 'user.tool_approval_policy',+ policies: [+ {+ server_name: 'github',+ name: 'create_issue',+ action: { type: 'allow_session' },+ },+ ],+ });+ });+it('rejects PATCH agent on a named session', async () => {const agent = await agentStore.createAgent({tenant_id: 'default',diff --git a/packages/trueforge/tests/unit/apis/turns.test.ts b/packages/trueforge/tests/unit/apis/turns.test.tsindex b8bdc9be2..db85a17a8 100644--- a/packages/trueforge/tests/unit/apis/turns.test.ts+++ b/packages/trueforge/tests/unit/apis/turns.test.ts@@ -107,6 +107,23 @@ describe('turns', () => {expect(eventsResponse.status).toBe(403);expect(await eventsResponse.json()).toEqual(forbiddenAccess);+ const createEventsResponse = await app.request('/s1/turns/any-turn/events', {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({+ events: [+ {+ type: 'user.tool_approval',+ thread_id: 'main',+ tool_call_id: 'tc-1',+ approval: { status: 'allow' },+ },+ ],+ }),+ });+ expect(createEventsResponse.status).toBe(403);+ expect(await createEventsResponse.json()).toEqual(forbiddenAccess);+const subscribeResponse = await app.request('/s1/turns/any-turn/subscribe');expect(subscribeResponse.status).toBe(403);expect(await subscribeResponse.json()).toEqual(forbiddenAccess);@@ -193,6 +210,24 @@ describe('turns', () => {})).status,).toBe(403);+ expect(+ (+ await app.request('/managed-session/turns/missing/events', {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({+ events: [+ {+ type: 'user.tool_approval',+ thread_id: 'main',+ tool_call_id: 'tc-1',+ approval: { status: 'allow' },+ },+ ],+ }),+ })+ ).status,+ ).toBe(403);});});diff --git a/python/trueforge_sdk/reference.md b/python/trueforge_sdk/reference.mdindex e6f916a46..245c0aad8 100644--- a/python/trueforge_sdk/reference.md+++ b/python/trueforge_sdk/reference.md@@ -2827,6 +2827,105 @@ client.sessions.list_turn_events(</dl>+</dd>+</dl>+</details>++<details><summary><code>client.sessions.<a href="src/trueforge_sdk/sessions/client.py">create_turn_event</a>(...) -> CreateTurnEventResponse</code></summary>+<dl>+<dd>++#### π Description++<dl>+<dd>++<dl>+<dd>++Create events for a turn. Only the session creator may create them.+</dd>+</dl>+</dd>+</dl>++#### π Usage++<dl>+<dd>++<dl>+<dd>++```python+from trueforge_sdk import TrueForge, UserToolApprovalInputEvent, ApprovalAllow++client = TrueForge(+ token="<token>",+ base_url="https://yourhost.com/path/to/api",+)++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",+ )+ ],+)++```+</dd>+</dl>+</dd>+</dl>++#### βοΈ Parameters++<dl>+<dd>++<dl>+<dd>++**session_id:** `str` β Session identifier.++</dd>+</dl>++<dl>+<dd>++**turn_id:** `str` β Turn identifier.++</dd>+</dl>++<dl>+<dd>++**events:** `typing.List[TurnInboundEventItem]` β One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).++</dd>+</dl>++<dl>+<dd>++**request_options:** `typing.Optional[RequestOptions]` β Request-specific configuration.++</dd>+</dl>+</dd>+</dl>++</dd></dl></details>diff --git a/python/trueforge_sdk/src/trueforge_sdk/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/__init__.pyindex 36414e450..6e256920d 100644--- a/python/trueforge_sdk/src/trueforge_sdk/__init__.py+++ b/python/trueforge_sdk/src/trueforge_sdk/__init__.py@@ -57,6 +57,8 @@ if typing.TYPE_CHECKING:ContextManagementConfig,CreateScheduleRunResponse,CreateSessionAgent,+ CreateTurnEventResponse,+ CreateTurnEventResponseDataItem,CreatedBySubject,CronExpression,CustomModelProvider,@@ -212,6 +214,8 @@ if typing.TYPE_CHECKING:Timezone,TogetherAiModelProvider,TokenPagination,+ ToolApprovalPolicyAllowSession,+ ToolApprovalPolicyItem,ToolApprovalRequiredEvent,ToolCall,ToolCallRef,@@ -226,6 +230,7 @@ if typing.TYPE_CHECKING:TurnCreatedEvent,TurnDoneEvent,TurnDoneEventState,+ TurnInboundEventItem,TurnInputItem,TurnMetrics,TurnState,@@ -244,7 +249,11 @@ if typing.TYPE_CHECKING:UserMessage,UserMessageContent,UserMessageContentItem,+ UserToolApprovalEvent,UserToolApprovalInputEvent,+ UserToolApprovalPolicyEvent,+ UserToolApprovalPolicyMessage,+ UserToolResponseEvent,UserToolResponseInputEvent,WebSearchCapability,WebSearchConfig,@@ -325,6 +334,8 @@ _dynamic_imports: typing.Dict[str, str] = {"ContextManagementConfig": ".types","CreateScheduleRunResponse": ".types","CreateSessionAgent": ".types",+ "CreateTurnEventResponse": ".types",+ "CreateTurnEventResponseDataItem": ".types","CreatedBySubject": ".types","CronExpression": ".types","CustomModelProvider": ".types",@@ -488,6 +499,8 @@ _dynamic_imports: typing.Dict[str, str] = {"Timezone": ".types","TogetherAiModelProvider": ".types","TokenPagination": ".types",+ "ToolApprovalPolicyAllowSession": ".types",+ "ToolApprovalPolicyItem": ".types","ToolApprovalRequiredEvent": ".types","ToolCall": ".types","ToolCallRef": ".types",@@ -503,6 +516,7 @@ _dynamic_imports: typing.Dict[str, str] = {"TurnCreatedEvent": ".types","TurnDoneEvent": ".types","TurnDoneEventState": ".types",+ "TurnInboundEventItem": ".types","TurnInputItem": ".types","TurnMetrics": ".types","TurnState": ".types",@@ -523,7 +537,11 @@ _dynamic_imports: typing.Dict[str, str] = {"UserMessage": ".types","UserMessageContent": ".types","UserMessageContentItem": ".types",+ "UserToolApprovalEvent": ".types","UserToolApprovalInputEvent": ".types",+ "UserToolApprovalPolicyEvent": ".types",+ "UserToolApprovalPolicyMessage": ".types",+ "UserToolResponseEvent": ".types","UserToolResponseInputEvent": ".types","WebSearchCapability": ".types","WebSearchConfig": ".types",@@ -621,6 +639,8 @@ __all__ = ["ContextManagementConfig","CreateScheduleRunResponse","CreateSessionAgent",+ "CreateTurnEventResponse",+ "CreateTurnEventResponseDataItem","CreatedBySubject","CronExpression","CustomModelProvider",@@ -784,6 +804,8 @@ __all__ = ["Timezone","TogetherAiModelProvider","TokenPagination",+ "ToolApprovalPolicyAllowSession",+ "ToolApprovalPolicyItem","ToolApprovalRequiredEvent","ToolCall","ToolCallRef",@@ -799,6 +821,7 @@ __all__ = ["TurnCreatedEvent","TurnDoneEvent","TurnDoneEventState",+ "TurnInboundEventItem","TurnInputItem","TurnMetrics","TurnState",@@ -819,7 +842,11 @@ __all__ = ["UserMessage","UserMessageContent","UserMessageContentItem",+ "UserToolApprovalEvent","UserToolApprovalInputEvent",+ "UserToolApprovalPolicyEvent",+ "UserToolApprovalPolicyMessage",+ "UserToolResponseEvent","UserToolResponseInputEvent","WebSearchCapability","WebSearchConfig",diff --git a/python/trueforge_sdk/src/trueforge_sdk/sessions/client.py b/python/trueforge_sdk/src/trueforge_sdk/sessions/client.pyindex ce744a779..96a18fab8 100644--- a/python/trueforge_sdk/src/trueforge_sdk/sessions/client.py+++ b/python/trueforge_sdk/src/trueforge_sdk/sessions/client.py@@ -9,6 +9,7 @@ from ..core.request_options import RequestOptionsfrom ..core.stream import AsyncStream, Stream, StreamEventfrom ..types.cancel_session_response import CancelSessionResponsefrom ..types.create_session_agent import CreateSessionAgent+from ..types.create_turn_event_response import CreateTurnEventResponsefrom ..types.get_session_response import GetSessionResponsefrom ..types.get_turn_response import GetTurnResponsefrom ..types.list_session_events_response import ListSessionEventsResponse@@ -25,6 +26,7 @@ from ..types.session_event_item import SessionEventItemfrom ..types.session_metadata import SessionMetadatafrom ..types.session_source_type import SessionSourceTypefrom ..types.turn import Turn+from ..types.turn_inbound_event_item import TurnInboundEventItemfrom ..types.turn_input_item import TurnInputItemfrom ..types.turn_streaming_event import TurnStreamingEventfrom .raw_client import AsyncRawSessionsClient, RawSessionsClient@@ -685,6 +687,61 @@ class SessionsClient:request_options=request_options,)+ def create_turn_event(+ self,+ *,+ session_id: str,+ turn_id: str,+ events: typing.Sequence[TurnInboundEventItem],+ request_options: typing.Optional[RequestOptions] = None,+ ) -> CreateTurnEventResponse:+ """+ Create events for a turn. Only the session creator may create them.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ events : typing.Sequence[TurnInboundEventItem]+ One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ CreateTurnEventResponse+ Events created.++ Examples+ --------+ from trueforge_sdk import ApprovalAllow, TrueForge, UserToolApprovalInputEvent++ client = TrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+ 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",+ )+ ],+ )+ """+ _response = self._raw_client.create_turn_event(+ session_id=session_id, turn_id=turn_id, events=events, request_options=request_options+ )+ return _response.data+def subscribe_to_turn(self,*,@@ -1509,6 +1566,73 @@ class AsyncSessionsClient:request_options=request_options,)+ async def create_turn_event(+ self,+ *,+ session_id: str,+ turn_id: str,+ events: typing.Sequence[TurnInboundEventItem],+ request_options: typing.Optional[RequestOptions] = None,+ ) -> CreateTurnEventResponse:+ """+ Create events for a turn. Only the session creator may create them.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ events : typing.Sequence[TurnInboundEventItem]+ One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ CreateTurnEventResponse+ Events created.++ Examples+ --------+ import asyncio++ from trueforge_sdk import (+ ApprovalAllow,+ AsyncTrueForge,+ UserToolApprovalInputEvent,+ )++ client = AsyncTrueForge(+ token="YOUR_TOKEN",+ base_url="https://yourhost.com/path/to/api",+ )+++ async def main() -> None:+ 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",+ )+ ],+ )+++ asyncio.run(main())+ """+ _response = await self._raw_client.create_turn_event(+ session_id=session_id, turn_id=turn_id, events=events, request_options=request_options+ )+ return _response.data+def subscribe_to_turn(self,*,diff --git a/python/trueforge_sdk/src/trueforge_sdk/sessions/raw_client.py b/python/trueforge_sdk/src/trueforge_sdk/sessions/raw_client.pyindex 1a8065d01..992928c8e 100644--- a/python/trueforge_sdk/src/trueforge_sdk/sessions/raw_client.py+++ b/python/trueforge_sdk/src/trueforge_sdk/sessions/raw_client.py@@ -20,6 +20,7 @@ from ..core.serialization import convert_and_respect_annotation_metadatafrom ..core.stream import AsyncStream, Stream, StreamEventfrom ..core.unchecked_base_model import construct_typefrom ..errors.bad_request_error import BadRequestError+from ..errors.conflict_error import ConflictErrorfrom ..errors.content_too_large_error import ContentTooLargeErrorfrom ..errors.failed_dependency_error import FailedDependencyErrorfrom ..errors.forbidden_error import ForbiddenError@@ -30,6 +31,7 @@ from ..errors.unauthorized_error import UnauthorizedErrorfrom ..errors.unprocessable_entity_error import UnprocessableEntityErrorfrom ..types.cancel_session_response import CancelSessionResponsefrom ..types.create_session_agent import CreateSessionAgent+from ..types.create_turn_event_response import CreateTurnEventResponsefrom ..types.get_session_response import GetSessionResponsefrom ..types.get_turn_response import GetTurnResponsefrom ..types.list_session_events_response import ListSessionEventsResponse@@ -47,6 +49,7 @@ from ..types.session_event_item import SessionEventItemfrom ..types.session_metadata import SessionMetadatafrom ..types.session_source_type import SessionSourceTypefrom ..types.turn import Turn+from ..types.turn_inbound_event_item import TurnInboundEventItemfrom ..types.turn_input_item import TurnInputItemfrom ..types.turn_streaming_event import TurnStreamingEventfrom pydantic import ValidationError@@ -1436,6 +1439,113 @@ class RawSessionsClient:)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+ def create_turn_event(+ self,+ *,+ session_id: str,+ turn_id: str,+ events: typing.Sequence[TurnInboundEventItem],+ request_options: typing.Optional[RequestOptions] = None,+ ) -> HttpResponse[CreateTurnEventResponse]:+ """+ Create events for a turn. Only the session creator may create them.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ events : typing.Sequence[TurnInboundEventItem]+ One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ HttpResponse[CreateTurnEventResponse]+ Events created.+ """+ _response = self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns/{encode_path_param(turn_id)}/events",+ method="POST",+ json={+ "events": convert_and_respect_annotation_metadata(+ object_=events, annotation=typing.Sequence[TurnInboundEventItem], direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CreateTurnEventResponse,+ construct_type(+ type_=CreateTurnEventResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return HttpResponse(response=_response, data=_data)+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+@contextlib.contextmanagerdef subscribe_to_turn(self,@@ -2971,6 +3081,113 @@ class AsyncRawSessionsClient:)raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+ async def create_turn_event(+ self,+ *,+ session_id: str,+ turn_id: str,+ events: typing.Sequence[TurnInboundEventItem],+ request_options: typing.Optional[RequestOptions] = None,+ ) -> AsyncHttpResponse[CreateTurnEventResponse]:+ """+ Create events for a turn. Only the session creator may create them.++ Parameters+ ----------+ session_id : str+ Session identifier.++ turn_id : str+ Turn identifier.++ events : typing.Sequence[TurnInboundEventItem]+ One or more events (`user.tool_approval`, `user.tool_response`, `user.tool_approval_policy`).++ request_options : typing.Optional[RequestOptions]+ Request-specific configuration.++ Returns+ -------+ AsyncHttpResponse[CreateTurnEventResponse]+ Events created.+ """+ _response = await self._client_wrapper.httpx_client.request(+ f"api/v1/sessions/{encode_path_param(session_id)}/turns/{encode_path_param(turn_id)}/events",+ method="POST",+ json={+ "events": convert_and_respect_annotation_metadata(+ object_=events, annotation=typing.Sequence[TurnInboundEventItem], direction="write"+ ),+ },+ headers={+ "content-type": "application/json",+ },+ request_options=request_options,+ omit=OMIT,+ )+ try:+ if 200 <= _response.status_code < 300:+ _data = typing.cast(+ CreateTurnEventResponse,+ construct_type(+ type_=CreateTurnEventResponse, # type: ignore+ object_=_response.json(),+ ),+ )+ return AsyncHttpResponse(response=_response, data=_data)+ if _response.status_code == 400:+ raise BadRequestError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 403:+ raise ForbiddenError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 404:+ raise NotFoundError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ if _response.status_code == 409:+ raise ConflictError(+ headers=dict(_response.headers),+ body=typing.cast(+ RequestErrorResponse,+ construct_type(+ type_=RequestErrorResponse, # type: ignore+ object_=_response.json(),+ ),+ ),+ )+ _response_json = _response.json()+ except JSONDecodeError:+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)+ except ValidationError as e:+ raise ParsingError(+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e+ )+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)+@contextlib.asynccontextmanagerasync def subscribe_to_turn(self,diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/__init__.py b/python/trueforge_sdk/src/trueforge_sdk/types/__init__.pyindex e07f381e8..126971be8 100644--- a/python/trueforge_sdk/src/trueforge_sdk/types/__init__.py+++ b/python/trueforge_sdk/src/trueforge_sdk/types/__init__.py@@ -56,6 +56,8 @@ if typing.TYPE_CHECKING:from .context_management_config import ContextManagementConfigfrom .create_schedule_run_response import CreateScheduleRunResponsefrom .create_session_agent import CreateSessionAgent+ from .create_turn_event_response import CreateTurnEventResponse+ from .create_turn_event_response_data_item import CreateTurnEventResponseDataItemfrom .created_by_subject import CreatedBySubjectfrom .cron_expression import CronExpressionfrom .custom_model_provider import CustomModelProvider@@ -211,6 +213,8 @@ if typing.TYPE_CHECKING:from .timezone import Timezonefrom .together_ai_model_provider import TogetherAiModelProviderfrom .token_pagination import TokenPagination+ from .tool_approval_policy_allow_session import ToolApprovalPolicyAllowSession+ from .tool_approval_policy_item import ToolApprovalPolicyItemfrom .tool_approval_required_event import ToolApprovalRequiredEventfrom .tool_call import ToolCallfrom .tool_call_ref import ToolCallRef@@ -225,6 +229,7 @@ if typing.TYPE_CHECKING:from .turn_created_event import TurnCreatedEventfrom .turn_done_event import TurnDoneEventfrom .turn_done_event_state import TurnDoneEventState+ from .turn_inbound_event_item import TurnInboundEventItemfrom .turn_input_item import TurnInputItemfrom .turn_metrics import TurnMetricsfrom .turn_state import TurnState@@ -243,7 +248,11 @@ if typing.TYPE_CHECKING:from .user_message import UserMessagefrom .user_message_content import UserMessageContentfrom .user_message_content_item import UserMessageContentItem+ from .user_tool_approval_event import UserToolApprovalEventfrom .user_tool_approval_input_event import UserToolApprovalInputEvent+ from .user_tool_approval_policy_event import UserToolApprovalPolicyEvent+ from .user_tool_approval_policy_message import UserToolApprovalPolicyMessage+ from .user_tool_response_event import UserToolResponseEventfrom .user_tool_response_input_event import UserToolResponseInputEventfrom .web_search_capability import WebSearchCapabilityfrom .web_search_config import WebSearchConfig@@ -300,6 +309,8 @@ _dynamic_imports: typing.Dict[str, str] = {"ContextManagementConfig": ".context_management_config","CreateScheduleRunResponse": ".create_schedule_run_response","CreateSessionAgent": ".create_session_agent",+ "CreateTurnEventResponse": ".create_turn_event_response",+ "CreateTurnEventResponseDataItem": ".create_turn_event_response_data_item","CreatedBySubject": ".created_by_subject","CronExpression": ".cron_expression","CustomModelProvider": ".custom_model_provider",@@ -455,6 +466,8 @@ _dynamic_imports: typing.Dict[str, str] = {"Timezone": ".timezone","TogetherAiModelProvider": ".together_ai_model_provider","TokenPagination": ".token_pagination",+ "ToolApprovalPolicyAllowSession": ".tool_approval_policy_allow_session",+ "ToolApprovalPolicyItem": ".tool_approval_policy_item","ToolApprovalRequiredEvent": ".tool_approval_required_event","ToolCall": ".tool_call","ToolCallRef": ".tool_call_ref",@@ -469,6 +482,7 @@ _dynamic_imports: typing.Dict[str, str] = {"TurnCreatedEvent": ".turn_created_event","TurnDoneEvent": ".turn_done_event","TurnDoneEventState": ".turn_done_event_state",+ "TurnInboundEventItem": ".turn_inbound_event_item","TurnInputItem": ".turn_input_item","TurnMetrics": ".turn_metrics","TurnState": ".turn_state",@@ -487,7 +501,11 @@ _dynamic_imports: typing.Dict[str, str] = {"UserMessage": ".user_message","UserMessageContent": ".user_message_content","UserMessageContentItem": ".user_message_content_item",+ "UserToolApprovalEvent": ".user_tool_approval_event","UserToolApprovalInputEvent": ".user_tool_approval_input_event",+ "UserToolApprovalPolicyEvent": ".user_tool_approval_policy_event",+ "UserToolApprovalPolicyMessage": ".user_tool_approval_policy_message",+ "UserToolResponseEvent": ".user_tool_response_event","UserToolResponseInputEvent": ".user_tool_response_input_event","WebSearchCapability": ".web_search_capability","WebSearchConfig": ".web_search_config",@@ -568,6 +586,8 @@ __all__ = ["ContextManagementConfig","CreateScheduleRunResponse","CreateSessionAgent",+ "CreateTurnEventResponse",+ "CreateTurnEventResponseDataItem","CreatedBySubject","CronExpression","CustomModelProvider",@@ -723,6 +743,8 @@ __all__ = ["Timezone","TogetherAiModelProvider","TokenPagination",+ "ToolApprovalPolicyAllowSession",+ "ToolApprovalPolicyItem","ToolApprovalRequiredEvent","ToolCall","ToolCallRef",@@ -737,6 +759,7 @@ __all__ = ["TurnCreatedEvent","TurnDoneEvent","TurnDoneEventState",+ "TurnInboundEventItem","TurnInputItem","TurnMetrics","TurnState",@@ -755,7 +778,11 @@ __all__ = ["UserMessage","UserMessageContent","UserMessageContentItem",+ "UserToolApprovalEvent","UserToolApprovalInputEvent",+ "UserToolApprovalPolicyEvent",+ "UserToolApprovalPolicyMessage",+ "UserToolResponseEvent","UserToolResponseInputEvent","WebSearchCapability","WebSearchConfig",diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/create_turn_event_response.py b/python/trueforge_sdk/src/trueforge_sdk/types/create_turn_event_response.pynew file mode 100644index 000000000..707e507f5--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/create_turn_event_response.py@@ -0,0 +1,23 @@+# 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+from .create_turn_event_response_data_item import CreateTurnEventResponseDataItem+++class CreateTurnEventResponse(UncheckedBaseModel):+ data: typing.List[CreateTurnEventResponseDataItem] = pydantic.Field()+ """+ Events with server-minted `id` and `created_at`, in request order.+ """++ 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/create_turn_event_response_data_item.py b/python/trueforge_sdk/src/trueforge_sdk/types/create_turn_event_response_data_item.pynew file mode 100644index 000000000..688e6a401--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/create_turn_event_response_data_item.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++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+]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/session_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/session_event.pyindex 6119fc25c..cbedb13d2 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,9 @@ from .tool_response_required_event import ToolResponseRequiredEventfrom .turn_created_event import TurnCreatedEventfrom .turn_done_event import TurnDoneEventfrom .turn_update_event import TurnUpdateEvent+from .user_tool_approval_event import UserToolApprovalEvent+from .user_tool_approval_policy_event import UserToolApprovalPolicyEvent+from .user_tool_response_event import UserToolResponseEventSessionEvent = typing.Union[McpAuthRequiredEvent,@@ -28,4 +31,7 @@ SessionEvent = typing.Union[TurnCreatedEvent,TurnDoneEvent,TurnUpdateEvent,+ UserToolApprovalEvent,+ UserToolApprovalPolicyEvent,+ UserToolResponseEvent,]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/tool_approval_policy_allow_session.py b/python/trueforge_sdk/src/trueforge_sdk/types/tool_approval_policy_allow_session.pynew file mode 100644index 000000000..93c9ebf9f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/tool_approval_policy_allow_session.py@@ -0,0 +1,24 @@+# 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 ToolApprovalPolicyAllowSession(UncheckedBaseModel):+ expire_at: typing.Optional[str] = pydantic.Field(default=None)+ """+ ISO 8601 timestamp when this session allow expires. Omit to allow for the whole session.+ """++ type: typing.Literal["allow_session"] = "allow_session"++ 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/tool_approval_policy_item.py b/python/trueforge_sdk/src/trueforge_sdk/types/tool_approval_policy_item.pynew file mode 100644index 000000000..1c1ce0e89--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/tool_approval_policy_item.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+from .tool_approval_policy_allow_session import ToolApprovalPolicyAllowSession+++class ToolApprovalPolicyItem(UncheckedBaseModel):+ action: ToolApprovalPolicyAllowSession+ name: str = pydantic.Field()+ """+ Tool name on that server.+ """++ server_name: str = pydantic.Field()+ """+ MCP server name.+ """++ 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_inbound_event_item.py b/python/trueforge_sdk/src/trueforge_sdk/types/turn_inbound_event_item.pynew file mode 100644index 000000000..47a5cfe5a--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/turn_inbound_event_item.py@@ -0,0 +1,11 @@+# This file was auto-generated by Fern from our API Definition.++import typing++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+]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 3570d5ed6..1a9d40b9a 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,9 @@ from .tool_response_required_event import ToolResponseRequiredEventfrom .turn_created_event import TurnCreatedEventfrom .turn_done_event import TurnDoneEventfrom .turn_update_event import TurnUpdateEvent+from .user_tool_approval_event import UserToolApprovalEvent+from .user_tool_approval_policy_event import UserToolApprovalPolicyEvent+from .user_tool_response_event import UserToolResponseEventTurnStreamingEvent = typing.Union[McpAuthRequiredEvent,@@ -30,4 +33,7 @@ TurnStreamingEvent = typing.Union[TurnCreatedEvent,TurnDoneEvent,TurnUpdateEvent,+ UserToolApprovalEvent,+ UserToolApprovalPolicyEvent,+ UserToolResponseEvent,]diff --git a/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_approval_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_approval_event.pynew file mode 100644index 000000000..a57a02864--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_approval_event.py@@ -0,0 +1,41 @@+# 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+from .approval_decision import ApprovalDecision+++class UserToolApprovalEvent(UncheckedBaseModel):+ approval: ApprovalDecision+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ thread_id: str = pydantic.Field()+ """+ Thread that owns the pending tool call.+ """++ tool_call_id: str = pydantic.Field()+ """+ Tool call id being approved or denied.+ """++ type: typing.Literal["user.tool_approval"] = "user.tool_approval"++ 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/user_tool_approval_policy_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_approval_policy_event.pynew file mode 100644index 000000000..155b5651c--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_approval_policy_event.py@@ -0,0 +1,35 @@+# 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+from .tool_approval_policy_item import ToolApprovalPolicyItem+++class UserToolApprovalPolicyEvent(UncheckedBaseModel):+ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ policies: typing.List[ToolApprovalPolicyItem] = pydantic.Field()+ """+ One or more (server_name, name) policy entries.+ """++ type: typing.Literal["user.tool_approval_policy"] = "user.tool_approval_policy"++ 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/user_tool_approval_policy_message.py b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_approval_policy_message.pynew file mode 100644index 000000000..6ab2ee34f--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_approval_policy_message.py@@ -0,0 +1,25 @@+# 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+from .tool_approval_policy_item import ToolApprovalPolicyItem+++class UserToolApprovalPolicyMessage(UncheckedBaseModel):+ policies: typing.List[ToolApprovalPolicyItem] = pydantic.Field()+ """+ One or more (server_name, name) policy entries.+ """++ type: typing.Literal["user.tool_approval_policy"] = "user.tool_approval_policy"++ 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/user_tool_response_event.py b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_response_event.pynew file mode 100644index 000000000..f902e885e--- /dev/null+++ b/python/trueforge_sdk/src/trueforge_sdk/types/user_tool_response_event.py@@ -0,0 +1,44 @@+# 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 UserToolResponseEvent(UncheckedBaseModel):+ content: str = pydantic.Field()+ """+ Client-side tool result content.+ """++ created_at: str = pydantic.Field()+ """+ ISO 8601 event timestamp.+ """++ id: str = pydantic.Field()+ """+ Unique identifier for the event (monotonic ULID).+ """++ thread_id: str = pydantic.Field()+ """+ Thread that owns the pending tool call.+ """++ tool_call_id: str = pydantic.Field()+ """+ Tool call id receiving the client response.+ """++ type: typing.Literal["user.tool_response"] = "user.tool_response"++ 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