@deepraxis/sdk 0.1.0-dev.449ac38 → 0.1.0-dev.67c7f3b

package/dist/generated/types.gen.d.ts

@@ -5368,7 +5368,7 @@ export type AgentManaged170 = {
      */
     system: null | string;
     /**
-     * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+     * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
      */
     tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
     /**
@@ -5480,7 +5480,7 @@ export type AgentManaged252 = {
      */
     custom_tool_use_id: string;
     /**
-     * Result of a custom tool call. Custom tools are not offered on this platform and this event returns 400.
+     * Result of a custom tool call. Set custom_tool_use_id to the agent.custom_tool_use event id and send only text content blocks; omitted content becomes an empty array.
      */
     type: 'user.custom_tool_result';
     /**
@@ -5513,24 +5513,6 @@ export type AgentManaged253 = {
      */
     is_error?: null | false | true;
 };
-export type AgentManaged185 = {
-    /**
-     * Unique identifier for this event.
-     */
-    id: string;
-    /**
-     * Array of content blocks comprising the user message.
-     */
-    content: Array<AgentManaged60 | AgentManaged61 | AgentManaged65 | AgentManaged70>;
-    /**
-     * Always `user.message`. A message from the user to the agent, with content blocks.
-     */
-    type: 'user.message';
-    /**
-     * A timestamp in RFC 3339 format
-     */
-    processed_at?: null | string;
-};
 export type AgentSseEvent = ({
     /**
      * Always `user.message`. SSE event name of this frame; its data is a user.message payload. A message from the user to the agent, with content blocks.
@@ -5556,6 +5538,24 @@ export type AgentSseEvent = ({
          * A timestamp in RFC 3339 format
          */
         processed_at?: null | string;
+        /**
+         * Untrusted page context for this user message only. Resend on each turn when needed; never added to system instructions. The complete JSON value must be at most 4096 UTF-8 bytes; invalid values return 400 INVALID_PARAMS. Empty items are treated as absent. Available only on /agent/v1.
+         */
+        praxis_context?: {
+            /**
+             * Named page values supplied by the client for this turn.
+             */
+            items: Array<{
+                /**
+                 * Page context key, such as lesson or section.
+                 */
+                name: string;
+                /**
+                 * Untrusted page value; escaped before inclusion in the user message.
+                 */
+                value: string;
+            }>;
+        };
         /**
          * UI transcript message ID. Use the last assistant message in a successfully completed turn as the fork target.
          */
@@ -6352,6 +6352,86 @@ export type AgentSseEvent = ({
             };
         };
     };
+} | {
+    /**
+     * Always `agent.custom_tool_use`. SSE event name of this frame; its data is a agent.custom_tool_use payload. The agent called a custom tool defined by the client.
+     */
+    event?: 'agent.custom_tool_use';
+    /**
+     * Decoded JSON payload of this frame; its shape is selected by the event name.
+     */
+    data?: {
+        /**
+         * Unique identifier for this event.
+         */
+        id: string;
+        /**
+         * Input parameters for the tool call.
+         */
+        input: AgentManaged193;
+        /**
+         * Name of the custom tool being called.
+         */
+        name: string;
+        /**
+         * A timestamp in RFC 3339 format
+         */
+        processed_at: string;
+        /**
+         * Always `agent.custom_tool_use`. The agent called a custom tool defined by the client.
+         */
+        type: 'agent.custom_tool_use';
+        /**
+         * When set, this event was cross-posted from a subagent's thread to surface its
+         * custom tool use on the primary thread's stream. Empty on the thread's own
+         * events. Informational only: the server routes the matching
+         * `user.custom_tool_result` by `custom_tool_use_id`, so clients do not send it
+         * back.
+         */
+        session_thread_id?: null | string;
+    };
+} | {
+    /**
+     * Always `user.custom_tool_result`. SSE event name of this frame; its data is a user.custom_tool_result payload. The user's result for a custom tool call.
+     */
+    event?: 'user.custom_tool_result';
+    /**
+     * Decoded JSON payload of this frame; its shape is selected by the event name.
+     */
+    data?: {
+        /**
+         * Unique identifier for this event.
+         */
+        id: string;
+        /**
+         * The id of the `agent.custom_tool_use` event this result corresponds to, which
+         * can be found in the last `session.status_idle`
+         * [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids)
+         * `stop_reason.event_ids` field.
+         */
+        custom_tool_use_id: string;
+        /**
+         * Always `user.custom_tool_result`. The user's result for a custom tool call.
+         */
+        type: 'user.custom_tool_result';
+        /**
+         * The result content returned by the tool.
+         */
+        content?: Array<AgentManaged60 | AgentManaged61 | AgentManaged65 | AgentManaged189>;
+        /**
+         * Whether the tool execution resulted in an error.
+         */
+        is_error?: null | false | true;
+        /**
+         * A timestamp in RFC 3339 format
+         */
+        processed_at?: null | string;
+        /**
+         * Set by the server to the subagent thread this result was routed to. Omitted when
+         * it was routed to the primary thread.
+         */
+        session_thread_id?: null | string;
+    };
 } | {
     /**
      * Always `session.thread_created`. SSE event name of this frame; its data is a session.thread_created payload. A child thread was started.
@@ -7026,7 +7106,7 @@ export type AgentSseEvent = ({
     /**
      * Server-Sent Events event name of this frame.
      */
-    event: 'user.message' | 'user.interrupt' | 'agent.message' | 'agent.thinking' | 'session.status_running' | 'session.status_rescheduled' | 'session.status_idle' | 'session.status_terminated' | 'agent.thread_context_compacted' | 'agent.thread_context_reset' | 'session.updated' | 'session.error' | 'session.usage' | 'span.model_request_start' | 'span.model_request_end' | 'agent.tool_use' | 'agent.tool_result' | 'agent.mcp_tool_use' | 'agent.mcp_tool_result' | 'user.tool_confirmation' | 'session.thread_created' | 'session.thread_status_running' | 'session.thread_status_idle' | 'session.thread_status_rescheduled' | 'session.thread_status_terminated' | 'agent.thread_message_sent' | 'agent.thread_message_received' | 'user.withdraw' | 'user.steer' | 'system.notification' | 'session.forked' | 'session.goal_changed' | 'session.goal_verification' | 'event_start' | 'event_delta' | 'ping' | 'error';
+    event: 'user.message' | 'user.interrupt' | 'agent.message' | 'agent.thinking' | 'session.status_running' | 'session.status_rescheduled' | 'session.status_idle' | 'session.status_terminated' | 'agent.thread_context_compacted' | 'agent.thread_context_reset' | 'session.updated' | 'session.error' | 'session.usage' | 'span.model_request_start' | 'span.model_request_end' | 'agent.tool_use' | 'agent.tool_result' | 'agent.mcp_tool_use' | 'agent.mcp_tool_result' | 'user.tool_confirmation' | 'agent.custom_tool_use' | 'user.custom_tool_result' | 'session.thread_created' | 'session.thread_status_running' | 'session.thread_status_idle' | 'session.thread_status_rescheduled' | 'session.thread_status_terminated' | 'agent.thread_message_sent' | 'agent.thread_message_received' | 'user.withdraw' | 'user.steer' | 'system.notification' | 'session.forked' | 'session.goal_changed' | 'session.goal_verification' | 'event_start' | 'event_delta' | 'ping' | 'error';
     data: AgentSseData;
 };
 export type AgentManaged256 = {
@@ -17448,7 +17528,7 @@ export type AgentManaged172 = {
      */
     system: null | string;
     /**
-     * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+     * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
      */
     tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
     /**
@@ -17705,7 +17785,7 @@ export type AgentManaged191 = {
      */
     text: string;
     /**
-     * Text block inside a tool result. Tool results are not accepted as events on this platform; sending one returns 400.
+     * Text block inside a tool result. user.custom_tool_result accepts text blocks only; user.tool_result remains unsupported.
      */
     type: 'text';
 };
@@ -17977,6 +18057,24 @@ export type AgentSseData = {
      * A timestamp in RFC 3339 format
      */
     processed_at?: null | string;
+    /**
+     * Untrusted page context for this user message only. Resend on each turn when needed; never added to system instructions. The complete JSON value must be at most 4096 UTF-8 bytes; invalid values return 400 INVALID_PARAMS. Empty items are treated as absent. Available only on /agent/v1.
+     */
+    praxis_context?: {
+        /**
+         * Named page values supplied by the client for this turn.
+         */
+        items: Array<{
+            /**
+             * Page context key, such as lesson or section.
+             */
+            name: string;
+            /**
+             * Untrusted page value; escaped before inclusion in the user message.
+             */
+            value: string;
+        }>;
+    };
     /**
      * UI transcript message ID. Use the last assistant message in a successfully completed turn as the fork target.
      */
@@ -18601,6 +18699,68 @@ export type AgentSseData = {
             notes?: string;
         };
     };
+} | {
+    /**
+     * Unique identifier for this event.
+     */
+    id: string;
+    /**
+     * Input parameters for the tool call.
+     */
+    input: AgentManaged193;
+    /**
+     * Name of the custom tool being called.
+     */
+    name: string;
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    processed_at: string;
+    /**
+     * Always `agent.custom_tool_use`. The agent called a custom tool defined by the client.
+     */
+    type: 'agent.custom_tool_use';
+    /**
+     * When set, this event was cross-posted from a subagent's thread to surface its
+     * custom tool use on the primary thread's stream. Empty on the thread's own
+     * events. Informational only: the server routes the matching
+     * `user.custom_tool_result` by `custom_tool_use_id`, so clients do not send it
+     * back.
+     */
+    session_thread_id?: null | string;
+} | {
+    /**
+     * Unique identifier for this event.
+     */
+    id: string;
+    /**
+     * The id of the `agent.custom_tool_use` event this result corresponds to, which
+     * can be found in the last `session.status_idle`
+     * [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids)
+     * `stop_reason.event_ids` field.
+     */
+    custom_tool_use_id: string;
+    /**
+     * Always `user.custom_tool_result`. The user's result for a custom tool call.
+     */
+    type: 'user.custom_tool_result';
+    /**
+     * The result content returned by the tool.
+     */
+    content?: Array<AgentManaged60 | AgentManaged61 | AgentManaged65 | AgentManaged189>;
+    /**
+     * Whether the tool execution resulted in an error.
+     */
+    is_error?: null | false | true;
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    processed_at?: null | string;
+    /**
+     * Set by the server to the subagent thread this result was routed to. Omitted when
+     * it was routed to the primary thread.
+     */
+    session_thread_id?: null | string;
 } | {
     /**
      * Unique identifier for this event.
@@ -26430,6 +26590,598 @@ export type SetRunFeedbackResponses = {
     };
 };
 export type SetRunFeedbackResponse = SetRunFeedbackResponses[keyof SetRunFeedbackResponses];
+export type ListEndUsersData = {
+    body?: never;
+    path: {
+        /**
+         * Active service agent identifier from agent creation or listing.
+         */
+        agent_id: string;
+    };
+    query?: {
+        /**
+         * Maximum users per page; defaults to 20.
+         */
+        limit?: number;
+        /**
+         * next_page from the previous response with the same agent, q and limit.
+         */
+        page?: string;
+        /**
+         * Case-sensitive literal prefix of external_user_id; omit or use an empty string for all users.
+         */
+        q?: string;
+    };
+    url: '/agent/v1/agents/{agent_id}/end_users';
+};
+export type ListEndUsersErrors = {
+    /**
+     * Invalid identifier, prefix, limit, cursor or blocklist size; correct the reported input.
+     */
+    400: unknown;
+    /**
+     * Authenticate with a host credential.
+     */
+    401: unknown;
+    /**
+     * Agent or requested user is unavailable to this caller, or the caller is an end user.
+     */
+    404: unknown;
+};
+export type ListEndUsersResponses = {
+    /**
+     * Matching users and next page cursor.
+     */
+    200: {
+        /**
+         * Items of this page, in the order requested by the call.
+         */
+        data: Array<{
+            /**
+             * Host application's user identifier, scoped to this organization and agent.
+             */
+            external_user_id: string;
+            /**
+             * Earliest session creation or token issuance time; null for a preemptively blocked user with no history.
+             */
+            first_seen_at: string | null;
+            /**
+             * Latest session update or token issuance time; null when there is no history.
+             */
+            last_active_at: string | null;
+            /**
+             * Total sessions for this end user on this agent.
+             */
+            session_count: number;
+            /**
+             * Accumulated recorded session cost in millionths of a US dollar; zero when no cost has been recorded.
+             */
+            cost_micro_usd: number;
+            /**
+             * Whether the embed policy currently prevents this user from receiving tokens and creating sessions.
+             */
+            blocked: boolean;
+        }>;
+        /**
+         * Cursor for the same agent, q and limit; null when exhausted.
+         */
+        next_page: string | null;
+    };
+};
+export type ListEndUsersResponse = ListEndUsersResponses[keyof ListEndUsersResponses];
+export type DeleteEndUserData = {
+    body?: never;
+    path: {
+        /**
+         * Active service agent identifier from agent creation or listing.
+         */
+        agent_id: string;
+        /**
+         * Host user identifier supplied at issuance or from end-user listing.
+         */
+        external_user_id: string;
+    };
+    query: {
+        /**
+         * Must exactly equal the external_user_id path parameter to confirm destructive deletion.
+         */
+        confirm: string;
+    };
+    url: '/agent/v1/agents/{agent_id}/end_users/{external_user_id}';
+};
+export type DeleteEndUserErrors = {
+    /**
+     * Invalid identifier, prefix, limit, cursor or blocklist size; correct the reported input.
+     */
+    400: unknown;
+    /**
+     * Authenticate with a host credential.
+     */
+    401: unknown;
+    /**
+     * Agent or requested user is unavailable to this caller, or the caller is an end user.
+     */
+    404: unknown;
+};
+export type DeleteEndUserResponses = {
+    /**
+     * Deletion accepted; poll the deletion endpoint until done or failed.
+     */
+    202: {
+        /**
+         * Deletion task identifier.
+         */
+        id: string;
+        /**
+         * Accepted for asynchronous processing; poll deletion for progress.
+         */
+        status: 'pending';
+    };
+};
+export type DeleteEndUserResponse = DeleteEndUserResponses[keyof DeleteEndUserResponses];
+export type GetEndUserData = {
+    body?: never;
+    path: {
+        /**
+         * Active service agent identifier from agent creation or listing.
+         */
+        agent_id: string;
+        /**
+         * Host user identifier supplied at issuance or from end-user listing.
+         */
+        external_user_id: string;
+    };
+    query?: never;
+    url: '/agent/v1/agents/{agent_id}/end_users/{external_user_id}';
+};
+export type GetEndUserErrors = {
+    /**
+     * Invalid identifier, prefix, limit, cursor or blocklist size; correct the reported input.
+     */
+    400: unknown;
+    /**
+     * Authenticate with a host credential.
+     */
+    401: unknown;
+    /**
+     * Agent or requested user is unavailable to this caller, or the caller is an end user.
+     */
+    404: unknown;
+};
+export type GetEndUserResponses = {
+    /**
+     * Current end-user view.
+     */
+    200: {
+        /**
+         * Host application's user identifier, scoped to this organization and agent.
+         */
+        external_user_id: string;
+        /**
+         * Earliest session creation or token issuance time; null for a preemptively blocked user with no history.
+         */
+        first_seen_at: string | null;
+        /**
+         * Latest session update or token issuance time; null when there is no history.
+         */
+        last_active_at: string | null;
+        /**
+         * Total sessions for this end user on this agent.
+         */
+        session_count: number;
+        /**
+         * Accumulated recorded session cost in millionths of a US dollar; zero when no cost has been recorded.
+         */
+        cost_micro_usd: number;
+        /**
+         * Whether the embed policy currently prevents this user from receiving tokens and creating sessions.
+         */
+        blocked: boolean;
+        /**
+         * Up to twenty sessions, ordered by most recent update first.
+         */
+        recent_sessions: Array<{
+            /**
+             * Public sesn_ session identifier, usable with session retrieval.
+             */
+            id: string;
+            /**
+             * Session title, or null when unset.
+             */
+            title: string | null;
+            /**
+             * Session entry surface, or null when no surface was recorded.
+             */
+            source: string | null;
+            /**
+             * Session creation time in UTC.
+             */
+            created_at: string;
+            /**
+             * Most recent session update time in UTC.
+             */
+            updated_at: string;
+        }>;
+    };
+};
+export type GetEndUserResponse = GetEndUserResponses[keyof GetEndUserResponses];
+export type GetEndUserDeletionData = {
+    body?: never;
+    path: {
+        /**
+         * Active service agent identifier from agent creation or listing.
+         */
+        agent_id: string;
+        /**
+         * Host user identifier supplied at issuance or from end-user listing.
+         */
+        external_user_id: string;
+    };
+    query?: never;
+    url: '/agent/v1/agents/{agent_id}/end_users/{external_user_id}/deletion';
+};
+export type GetEndUserDeletionErrors = {
+    /**
+     * Invalid identifier, prefix, limit, cursor or blocklist size; correct the reported input.
+     */
+    400: unknown;
+    /**
+     * Authenticate with a host credential.
+     */
+    401: unknown;
+    /**
+     * Agent or requested user is unavailable to this caller, or the caller is an end user.
+     */
+    404: unknown;
+};
+export type GetEndUserDeletionResponses = {
+    /**
+     * Latest deletion task and snapshot counts.
+     */
+    200: {
+        /**
+         * Deletion task identifier.
+         */
+        id: string;
+        /**
+         * pending: accepted; snapshotting: exporting recovery data; deleting: verified snapshot exists and erasure is running; done: erasure completed; failed: stopped safely, retry DELETE to resume the same task.
+         */
+        status: 'pending' | 'snapshotting' | 'deleting' | 'done' | 'failed';
+        /**
+         * Counts from the verified snapshot; empty until snapshotting completes.
+         */
+        counts: {
+            /**
+             * Number of primary and child sessions in the snapshot.
+             */
+            sessions?: number;
+            /**
+             * Number of durable session events captured without changing the history.
+             */
+            events?: number;
+            /**
+             * Number of stored transcript messages in the snapshot.
+             */
+            messages?: number;
+            /**
+             * Number of backed-up directory, authorization, feedback and projection rows.
+             */
+            d1_rows?: number;
+            /**
+             * Number of session attachment references; their file bytes are retained.
+             */
+            attachments?: number;
+        };
+        /**
+         * Operator recovery snapshot key, retained for seven days. Attachment bytes are not copied or deleted.
+         */
+        snapshot_key?: string;
+        /**
+         * Content-free failure summary; retry the confirmed deletion to resume.
+         */
+        error?: string;
+        /**
+         * Task creation time in RFC 3339 format.
+         */
+        created_at: string;
+        /**
+         * Latest task update time in RFC 3339 format.
+         */
+        updated_at: string;
+    };
+};
+export type GetEndUserDeletionResponse = GetEndUserDeletionResponses[keyof GetEndUserDeletionResponses];
+export type RevokeEndUserTokensData = {
+    body?: never;
+    path: {
+        /**
+         * Active service agent identifier from agent creation or listing.
+         */
+        agent_id: string;
+        /**
+         * Host user identifier supplied at issuance or from end-user listing.
+         */
+        external_user_id: string;
+    };
+    query?: never;
+    url: '/agent/v1/agents/{agent_id}/end_users/{external_user_id}/revoke_tokens';
+};
+export type RevokeEndUserTokensErrors = {
+    /**
+     * Invalid identifier, prefix, limit, cursor or blocklist size; correct the reported input.
+     */
+    400: unknown;
+    /**
+     * Authenticate with a host credential.
+     */
+    401: unknown;
+    /**
+     * Agent or requested user is unavailable to this caller, or the caller is an end user.
+     */
+    404: unknown;
+    /**
+     * Credential revocation failed; grant timestamps remain unchanged. A requested block remains in effect; retry to finish revocation.
+     */
+    502: unknown;
+};
+export type RevokeEndUserTokensResponses = {
+    /**
+     * Number of newly revoked grants.
+     */
+    200: {
+        /**
+         * Number of previously unrevoked grants marked revoked by this request.
+         */
+        revoked: number;
+    };
+};
+export type RevokeEndUserTokensResponse = RevokeEndUserTokensResponses[keyof RevokeEndUserTokensResponses];
+export type BlockEndUserData = {
+    body?: never;
+    path: {
+        /**
+         * Active service agent identifier from agent creation or listing.
+         */
+        agent_id: string;
+        /**
+         * Host user identifier supplied at issuance or from end-user listing.
+         */
+        external_user_id: string;
+    };
+    query?: never;
+    url: '/agent/v1/agents/{agent_id}/end_users/{external_user_id}/block';
+};
+export type BlockEndUserErrors = {
+    /**
+     * Invalid identifier, prefix, limit, cursor or blocklist size; correct the reported input.
+     */
+    400: unknown;
+    /**
+     * Authenticate with a host credential.
+     */
+    401: unknown;
+    /**
+     * Agent or requested user is unavailable to this caller, or the caller is an end user.
+     */
+    404: unknown;
+    /**
+     * Configure an embed policy before blocking or unblocking; retry if a concurrent policy update caused the conflict.
+     */
+    409: unknown;
+    /**
+     * Credential revocation failed; grant timestamps remain unchanged. A requested block remains in effect; retry to finish revocation.
+     */
+    502: unknown;
+};
+export type BlockEndUserResponses = {
+    /**
+     * Current end-user view.
+     */
+    200: {
+        /**
+         * Host application's user identifier, scoped to this organization and agent.
+         */
+        external_user_id: string;
+        /**
+         * Earliest session creation or token issuance time; null for a preemptively blocked user with no history.
+         */
+        first_seen_at: string | null;
+        /**
+         * Latest session update or token issuance time; null when there is no history.
+         */
+        last_active_at: string | null;
+        /**
+         * Total sessions for this end user on this agent.
+         */
+        session_count: number;
+        /**
+         * Accumulated recorded session cost in millionths of a US dollar; zero when no cost has been recorded.
+         */
+        cost_micro_usd: number;
+        /**
+         * Whether the embed policy currently prevents this user from receiving tokens and creating sessions.
+         */
+        blocked: boolean;
+    };
+};
+export type BlockEndUserResponse = BlockEndUserResponses[keyof BlockEndUserResponses];
+export type UnblockEndUserData = {
+    body?: never;
+    path: {
+        /**
+         * Active service agent identifier from agent creation or listing.
+         */
+        agent_id: string;
+        /**
+         * Host user identifier supplied at issuance or from end-user listing.
+         */
+        external_user_id: string;
+    };
+    query?: never;
+    url: '/agent/v1/agents/{agent_id}/end_users/{external_user_id}/unblock';
+};
+export type UnblockEndUserErrors = {
+    /**
+     * Invalid identifier, prefix, limit, cursor or blocklist size; correct the reported input.
+     */
+    400: unknown;
+    /**
+     * Authenticate with a host credential.
+     */
+    401: unknown;
+    /**
+     * Agent or requested user is unavailable to this caller, or the caller is an end user.
+     */
+    404: unknown;
+    /**
+     * Configure an embed policy before blocking or unblocking; retry if a concurrent policy update caused the conflict.
+     */
+    409: unknown;
+};
+export type UnblockEndUserResponses = {
+    /**
+     * Current end-user view.
+     */
+    200: {
+        /**
+         * Host application's user identifier, scoped to this organization and agent.
+         */
+        external_user_id: string;
+        /**
+         * Earliest session creation or token issuance time; null for a preemptively blocked user with no history.
+         */
+        first_seen_at: string | null;
+        /**
+         * Latest session update or token issuance time; null when there is no history.
+         */
+        last_active_at: string | null;
+        /**
+         * Total sessions for this end user on this agent.
+         */
+        session_count: number;
+        /**
+         * Accumulated recorded session cost in millionths of a US dollar; zero when no cost has been recorded.
+         */
+        cost_micro_usd: number;
+        /**
+         * Whether the embed policy currently prevents this user from receiving tokens and creating sessions.
+         */
+        blocked: boolean;
+    };
+};
+export type UnblockEndUserResponse = UnblockEndUserResponses[keyof UnblockEndUserResponses];
+export type ExchangeEmbedCodeData = {
+    body: {
+        /**
+         * Single-use credential from the c fragment parameter of hosted_url returned by embed token creation. Valid for 60 seconds.
+         */
+        code: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/agent/v1/embed/exchange';
+};
+export type ExchangeEmbedCodeErrors = {
+    /**
+     * Expected a JSON object containing only code. Correct the request body.
+     */
+    400: unknown;
+    /**
+     * The code is expired, already used or unknown. Return to the host website for a new link; all three cases have the same response body.
+     */
+    404: unknown;
+    /**
+     * The IP minute limit is reached. Wait for Retry-After before trying a fresh link.
+     */
+    429: unknown;
+    /**
+     * Exchange or rate limiting is unavailable. Return to the host website for a new link later.
+     */
+    503: unknown;
+};
+export type ExchangeEmbedCodeResponses = {
+    /**
+     * The end-user token and its expiration; the code has been consumed.
+     */
+    200: {
+        /**
+         * End-user credential for the hosted conversation. Keep it in memory; it cannot be refreshed here.
+         */
+        token: string;
+        /**
+         * Token expiration as an ISO 8601 UTC timestamp. Return to the host website after expiration.
+         */
+        expires_at: string;
+    };
+};
+export type ExchangeEmbedCodeResponse = ExchangeEmbedCodeResponses[keyof ExchangeEmbedCodeResponses];
+export type CreateAnonymousEmbedTokenData = {
+    body: {
+        /**
+         * Public key created by the service agent owner; safe to include in browser code.
+         */
+        publishable_key: string;
+        /**
+         * Secret returned by a previous anonymous issuance for this key. Omit for a new visitor; an unknown secret creates a new visitor.
+         */
+        visitor_secret?: string;
+    };
+    headers: {
+        /**
+         * Browser page origin from the agent policy allowlist.
+         */
+        Origin: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/agent/v1/embed_tokens/anonymous';
+};
+export type CreateAnonymousEmbedTokenErrors = {
+    /**
+     * Unknown or invalid request fields, or key budget exceeds policy. Correct the request or ask the owner to update the key.
+     */
+    400: unknown;
+    /**
+     * Unknown or disabled publishable key. Ask the agent owner for an active key.
+     */
+    401: unknown;
+    /**
+     * EMBED_BUDGET_EXHAUSTED. The daily spending cap is reached; wait for the UTC reset or ask the owner to raise it.
+     */
+    402: unknown;
+    /**
+     * EMBED_ORIGIN_NOT_ALLOWED or EMBED_USER_BLOCKED. Use an allowed page origin or contact the owner.
+     */
+    403: unknown;
+    /**
+     * EMBED_RATE_LIMITED. Wait for the IP minute window or UTC daily session cap reset.
+     */
+    429: unknown;
+    /**
+     * Anonymous issuance or rate limiting is unavailable; retry later.
+     */
+    503: unknown;
+};
+export type CreateAnonymousEmbedTokenResponses = {
+    /**
+     * End-user token and expiration, with a visitor secret only for a new visitor.
+     */
+    200: {
+        /**
+         * Short-lived end-user bearer credential for this agent's embedded sessions.
+         */
+        token: string;
+        /**
+         * RFC 3339 expiration; refresh before this time using the same visitor_secret.
+         */
+        expires_at: string;
+        /**
+         * Newly generated visitor secret; save it locally and include it on later requests. Absent when the supplied secret was recognized.
+         */
+        visitor_secret?: string;
+    };
+};
+export type CreateAnonymousEmbedTokenResponse = CreateAnonymousEmbedTokenResponses[keyof CreateAnonymousEmbedTokenResponses];
 export type ListEmbedTokensData = {
     body?: never;
     path?: never;
@@ -26539,6 +27291,10 @@ export type ListEmbedTokensResponses = {
 export type ListEmbedTokensResponse = ListEmbedTokensResponses[keyof ListEmbedTokensResponses];
 export type CreateEmbedTokenData = {
     body: {
+        /**
+         * Set true to also return a hosted chat URL with a single-use credential valid for 60 seconds. Defaults to false; the agent must have an identity_number.
+         */
+        hosted?: boolean;
         /**
          * Service agent ID or identity_number from agent retrieval; it must belong to your organization and be active.
          */
@@ -26598,7 +27354,7 @@ export type CreateEmbedTokenData = {
 };
 export type CreateEmbedTokenErrors = {
     /**
-     * Request fields exceed policy limits, the policy or its environment is unavailable, or hosted was supplied. Configure the policy or correct the reported field.
+     * Request fields exceed policy limits, the policy or its environment is unavailable, or a hosted agent has no identity_number. Configure the policy or correct the reported field.
      */
     400: unknown;
     /**
@@ -26623,6 +27379,10 @@ export type CreateEmbedTokenResponses = {
      * Issued end-user token and its grant identifier and expiration.
      */
     201: {
+        /**
+         * Hosted chat link, returned only when hosted is true. Redirect the user here within 60 seconds; its fragment credential can be exchanged only once.
+         */
+        hosted_url?: string;
         /**
          * Grant identifier with the emb_ prefix, identifying this issuance.
          */
@@ -26857,6 +27617,10 @@ export type ComputersListResponses = {
              * Public id of the sandbox that backs the computer, usable with the sandbox API; null while none has been created.
              */
             sandbox_id: string | null;
+            /**
+             * not_started means the machine has not been created; first use provisions it. provisioned means a machine has been created, whether running or paused.
+             */
+            machine_state: 'not_started' | 'provisioned';
             /**
              * Environment recipe the computer was created with; null when none.
              */
@@ -27018,6 +27782,10 @@ export type ComputersCreateResponses = {
          * Public id of the sandbox that backs the computer, usable with the sandbox API; null while none has been created.
          */
         sandbox_id: string | null;
+        /**
+         * not_started means the machine has not been created; first use provisions it. provisioned means a machine has been created, whether running or paused.
+         */
+        machine_state: 'not_started' | 'provisioned';
         /**
          * Environment recipe the computer was created with; null when none.
          */
@@ -27286,6 +28054,10 @@ export type ComputersRetrieveResponses = {
          * Public id of the sandbox that backs the computer, usable with the sandbox API; null while none has been created.
          */
         sandbox_id: string | null;
+        /**
+         * not_started means the machine has not been created; first use provisions it. provisioned means a machine has been created, whether running or paused.
+         */
+        machine_state: 'not_started' | 'provisioned';
         /**
          * Environment recipe the computer was created with; null when none.
          */
@@ -27451,6 +28223,10 @@ export type ComputersUpdateResponses = {
          * Public id of the sandbox that backs the computer, usable with the sandbox API; null while none has been created.
          */
         sandbox_id: string | null;
+        /**
+         * not_started means the machine has not been created; first use provisions it. provisioned means a machine has been created, whether running or paused.
+         */
+        machine_state: 'not_started' | 'provisioned';
         /**
          * Environment recipe the computer was created with; null when none.
          */
@@ -27577,56 +28353,377 @@ export type ComputersArchiveErrors = {
         };
     };
 };
-export type ComputersArchiveError = ComputersArchiveErrors[keyof ComputersArchiveErrors];
-export type ComputersArchiveResponses = {
+export type ComputersArchiveError = ComputersArchiveErrors[keyof ComputersArchiveErrors];
+export type ComputersArchiveResponses = {
+    /**
+     * Computer result
+     */
+    200: {
+        /**
+         * Always `computer`. A computer.
+         */
+        type: 'computer';
+        /**
+         * Computer id (cmp_...), the computer_id of computer calls.
+         */
+        id: string;
+        /**
+         * Display name of the computer, 1 to 255 characters.
+         */
+        name: string;
+        /**
+         * Public id of the sandbox that backs the computer, usable with the sandbox API; null while none has been created.
+         */
+        sandbox_id: string | null;
+        /**
+         * not_started means the machine has not been created; first use provisions it. provisioned means a machine has been created, whether running or paused.
+         */
+        machine_state: 'not_started' | 'provisioned';
+        /**
+         * Environment recipe the computer was created with; null when none.
+         */
+        environment_id: string | null;
+        /**
+         * active computers can be used by new sessions; archived ones keep their files readable but cannot start new sessions.
+         */
+        status: 'active' | 'archived';
+        /**
+         * RFC 3339 time at which the computer was created.
+         */
+        created_at: string;
+        /**
+         * RFC 3339 time at which the computer was last modified.
+         */
+        updated_at: string;
+        /**
+         * RFC 3339 time at which the computer was archived; null while active.
+         */
+        archived_at: string | null;
+    };
+};
+export type ComputersArchiveResponse = ComputersArchiveResponses[keyof ComputersArchiveResponses];
+export type ComputersAttachmentsCreateData = {
+    /**
+     * Raw file content for the attachment named by the name query parameter.
+     */
+    body: Blob | File;
+    path: {
+        /**
+         * Computer id (cmp_...), as returned by computers.create or computers.list.
+         */
+        computer_id: string;
+    };
+    query: {
+        /**
+         * Single filename, at most 255 UTF-8 bytes, excluding slash, dot segments and control characters.
+         */
+        name: string;
+    };
+    url: '/agent/v1/computers/{computer_id}/attachments';
+};
+export type ComputersAttachmentsCreateErrors = {
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    400: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    401: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    403: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Computer or path not found; foreign computers are indistinguishable from absent computers.
+     */
+    404: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    409: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    413: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    429: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    500: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    503: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+};
+export type ComputersAttachmentsCreateError = ComputersAttachmentsCreateErrors[keyof ComputersAttachmentsCreateErrors];
+export type ComputersAttachmentsCreateResponses = {
+    /**
+     * Computer result
+     */
+    201: {
+        /**
+         * Absolute path of the entry on the computer.
+         */
+        path: string;
+        /**
+         * Name of the entry or object.
+         */
+        name: string;
+        /**
+         * Kind of entry: a file, a directory or a symbolic link.
+         */
+        type: 'file' | 'dir' | 'symlink';
+        /**
+         * Size in bytes.
+         */
+        size: number;
+        /**
+         * MIME type of the file.
+         */
+        mime_type: string;
+        /**
+         * True when the entry cannot be modified through the API.
+         */
+        read_only: boolean;
+        /**
+         * Content digest of the file; null when not computed.
+         */
+        digest?: string | null;
+        /**
+         * RFC 3339 time at which the object was last modified.
+         */
+        updated_at: string | null;
+    };
+};
+export type ComputersAttachmentsCreateResponse = ComputersAttachmentsCreateResponses[keyof ComputersAttachmentsCreateResponses];
+export type ComputersFilesListData = {
+    body?: never;
+    path: {
+        /**
+         * Computer id (cmp_...), as returned by computers.create or computers.list.
+         */
+        computer_id: string;
+    };
+    query?: {
+        /**
+         * Directory on the computer to list; absolute path as returned in the path field of an earlier listing. Omit it to list from the computer's root.
+         */
+        path?: string;
+    };
+    url: '/agent/v1/computers/{computer_id}/files';
+};
+export type ComputersFilesListErrors = {
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    400: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    401: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    403: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Computer or path not found; foreign computers are indistinguishable from absent computers.
+     */
+    404: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    409: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    413: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    429: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    500: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+    /**
+     * Platform error with Computer code, message and hint
+     */
+    503: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
+};
+export type ComputersFilesListError = ComputersFilesListErrors[keyof ComputersFilesListErrors];
+export type ComputersFilesListResponses = {
     /**
      * Computer result
      */
     200: {
         /**
-         * Always `computer`. A computer.
-         */
-        type: 'computer';
-        /**
-         * Computer id (cmp_...), the computer_id of computer calls.
-         */
-        id: string;
-        /**
-         * Display name of the computer, 1 to 255 characters.
-         */
-        name: string;
-        /**
-         * Public id of the sandbox that backs the computer, usable with the sandbox API; null while none has been created.
-         */
-        sandbox_id: string | null;
-        /**
-         * Environment recipe the computer was created with; null when none.
-         */
-        environment_id: string | null;
-        /**
-         * active computers can be used by new sessions; archived ones keep their files readable but cannot start new sessions.
+         * Items of this page, in the order requested by the call.
          */
-        status: 'active' | 'archived';
+        data: Array<{
+            /**
+             * Absolute path of the entry on the computer.
+             */
+            path: string;
+            /**
+             * Name of the entry or object.
+             */
+            name: string;
+            /**
+             * Kind of entry: a file, a directory or a symbolic link.
+             */
+            type: 'file' | 'dir' | 'symlink';
+            /**
+             * Size in bytes.
+             */
+            size: number;
+            /**
+             * MIME type of the file.
+             */
+            mime_type: string;
+            /**
+             * True when the entry cannot be modified through the API.
+             */
+            read_only: boolean;
+            /**
+             * Content digest of the file; null when not computed.
+             */
+            digest?: string | null;
+            /**
+             * RFC 3339 time at which the object was last modified.
+             */
+            updated_at: string | null;
+        }>;
         /**
-         * RFC 3339 time at which the computer was created.
+         * Whether more items exist beyond this page.
          */
-        created_at: string;
+        has_more: false;
+    };
+};
+export type ComputersFilesListResponse = ComputersFilesListResponses[keyof ComputersFilesListResponses];
+export type ComputersFilesContentData = {
+    body?: never;
+    headers?: {
         /**
-         * RFC 3339 time at which the computer was last modified.
+         * Quoted digest entity-tag; legacy unquoted digests are also accepted.
          */
-        updated_at: string;
+        'If-None-Match'?: string;
         /**
-         * RFC 3339 time at which the computer was archived; null while active.
+         * Single byte range, including open-ended and suffix ranges.
          */
-        archived_at: string | null;
+        Range?: string;
     };
-};
-export type ComputersArchiveResponse = ComputersArchiveResponses[keyof ComputersArchiveResponses];
-export type ComputersAttachmentsCreateData = {
-    /**
-     * Raw file content for the attachment named by the name query parameter.
-     */
-    body: Blob | File;
     path: {
         /**
          * Computer id (cmp_...), as returned by computers.create or computers.list.
@@ -27635,13 +28732,13 @@ export type ComputersAttachmentsCreateData = {
     };
     query: {
         /**
-         * Single filename, at most 255 UTF-8 bytes, excluding slash, dot segments and control characters.
+         * Absolute path of the file whose content to download, as returned in the path field of computers.files.list.
          */
-        name: string;
+        path: string;
     };
-    url: '/agent/v1/computers/{computer_id}/attachments';
+    url: '/agent/v1/computers/{computer_id}/files/content';
 };
-export type ComputersAttachmentsCreateErrors = {
+export type ComputersFilesContentErrors = {
     /**
      * Platform error with Computer code, message and hint
      */
@@ -27702,6 +28799,16 @@ export type ComputersAttachmentsCreateErrors = {
             hint: string;
         };
     };
+    /**
+     * Range unavailable
+     */
+    416: {
+        error: {
+            code: string;
+            message: string;
+            hint: string;
+        };
+    };
     /**
      * Platform error with Computer code, message and hint
      */
@@ -27733,48 +28840,19 @@ export type ComputersAttachmentsCreateErrors = {
         };
     };
 };
-export type ComputersAttachmentsCreateError = ComputersAttachmentsCreateErrors[keyof ComputersAttachmentsCreateErrors];
-export type ComputersAttachmentsCreateResponses = {
+export type ComputersFilesContentError = ComputersFilesContentErrors[keyof ComputersFilesContentErrors];
+export type ComputersFilesContentResponses = {
     /**
-     * Computer result
+     * Raw file bytes (at most 16 MiB); Content-Type is inferred from the extension. ETag is present only when a digest is available. Larger files require the sandbox connection issued by connect.
      */
-    201: {
-        /**
-         * Absolute path of the entry on the computer.
-         */
-        path: string;
-        /**
-         * Name of the entry or object.
-         */
-        name: string;
-        /**
-         * Kind of entry: a file, a directory or a symbolic link.
-         */
-        type: 'file' | 'dir' | 'symlink';
-        /**
-         * Size in bytes.
-         */
-        size: number;
-        /**
-         * MIME type of the file.
-         */
-        mime_type: string;
-        /**
-         * True when the entry cannot be modified through the API.
-         */
-        read_only: boolean;
-        /**
-         * Content digest of the file; null when not computed.
-         */
-        digest?: string | null;
-        /**
-         * RFC 3339 time at which the object was last modified.
-         */
-        updated_at: string | null;
-    };
+    200: Blob | File;
+    /**
+     * Single byte range
+     */
+    206: Blob | File;
 };
-export type ComputersAttachmentsCreateResponse = ComputersAttachmentsCreateResponses[keyof ComputersAttachmentsCreateResponses];
-export type ComputersFilesListData = {
+export type ComputersFilesContentResponse = ComputersFilesContentResponses[keyof ComputersFilesContentResponses];
+export type ConnectComputerData = {
     body?: never;
     path: {
         /**
@@ -27782,15 +28860,10 @@ export type ComputersFilesListData = {
          */
         computer_id: string;
     };
-    query?: {
-        /**
-         * Directory on the computer to list; absolute path as returned in the path field of an earlier listing. Omit it to list from the computer's root.
-         */
-        path?: string;
-    };
-    url: '/agent/v1/computers/{computer_id}/files';
+    query?: never;
+    url: '/agent/v1/computers/{computer_id}/connect';
 };
-export type ComputersFilesListErrors = {
+export type ConnectComputerErrors = {
     /**
      * Platform error with Computer code, message and hint
      */
@@ -27882,83 +28955,55 @@ export type ComputersFilesListErrors = {
         };
     };
 };
-export type ComputersFilesListError = ComputersFilesListErrors[keyof ComputersFilesListErrors];
-export type ComputersFilesListResponses = {
+export type ConnectComputerError = ConnectComputerErrors[keyof ConnectComputerErrors];
+export type ConnectComputerResponses = {
     /**
      * Computer result
      */
     200: {
         /**
-         * Items of this page, in the order requested by the call.
+         * Public id of the sandbox that backs the computer, usable with the sandbox API; null while none has been created.
          */
-        data: Array<{
-            /**
-             * Absolute path of the entry on the computer.
-             */
-            path: string;
-            /**
-             * Name of the entry or object.
-             */
-            name: string;
-            /**
-             * Kind of entry: a file, a directory or a symbolic link.
-             */
-            type: 'file' | 'dir' | 'symlink';
-            /**
-             * Size in bytes.
-             */
-            size: number;
-            /**
-             * MIME type of the file.
-             */
-            mime_type: string;
-            /**
-             * True when the entry cannot be modified through the API.
-             */
-            read_only: boolean;
-            /**
-             * Content digest of the file; null when not computed.
-             */
-            digest?: string | null;
-            /**
-             * RFC 3339 time at which the object was last modified.
-             */
-            updated_at: string | null;
-        }>;
+        sandbox_id: string;
         /**
-         * Whether more items exist beyond this page.
+         * Access token for the sandbox's environment daemon, returned by the connect call; treat it as a secret.
          */
-        has_more: false;
-    };
-};
-export type ComputersFilesListResponse = ComputersFilesListResponses[keyof ComputersFilesListResponses];
-export type ComputersFilesContentData = {
-    body?: never;
-    headers?: {
+        envd_access_token: string;
         /**
-         * Quoted digest entity-tag; legacy unquoted digests are also accepted.
+         * Sandbox template the computer's sandbox was created from.
          */
-        'If-None-Match'?: string;
+        template_id: string;
         /**
-         * Single byte range, including open-ended and suffix ranges.
+         * Machine the connection reached: light (the always-present file machine) or heavy (the full machine started on demand and kept while leases are held).
          */
-        Range?: string;
+        tier: 'light' | 'heavy';
+        /**
+         * Id of the lease that keeps this connection's machine in service; renew it while the connection is open and release it on close. Null when no lease exists.
+         */
+        lease_id: string | null;
+        /**
+         * Time the lease lapses unless renewed, as an ISO 8601 timestamp; renew at about a third of the time remaining.
+         */
+        lease_expires_at: string | null;
     };
+};
+export type ConnectComputerResponse = ConnectComputerResponses[keyof ConnectComputerResponses];
+export type RenewComputerLeaseData = {
+    body?: never;
     path: {
         /**
          * Computer id (cmp_...), as returned by computers.create or computers.list.
          */
         computer_id: string;
-    };
-    query: {
         /**
-         * Absolute path of the file whose content to download, as returned in the path field of computers.files.list.
+         * lease_id from the connect response.
          */
-        path: string;
+        lease_id: string;
     };
-    url: '/agent/v1/computers/{computer_id}/files/content';
+    query?: never;
+    url: '/agent/v1/computers/{computer_id}/leases/{lease_id}/renew';
 };
-export type ComputersFilesContentErrors = {
+export type RenewComputerLeaseErrors = {
     /**
      * Platform error with Computer code, message and hint
      */
@@ -28019,16 +29064,6 @@ export type ComputersFilesContentErrors = {
             hint: string;
         };
     };
-    /**
-     * Range unavailable
-     */
-    416: {
-        error: {
-            code: string;
-            message: string;
-            hint: string;
-        };
-    };
     /**
      * Platform error with Computer code, message and hint
      */
@@ -28060,30 +29095,39 @@ export type ComputersFilesContentErrors = {
         };
     };
 };
-export type ComputersFilesContentError = ComputersFilesContentErrors[keyof ComputersFilesContentErrors];
-export type ComputersFilesContentResponses = {
+export type RenewComputerLeaseError = RenewComputerLeaseErrors[keyof RenewComputerLeaseErrors];
+export type RenewComputerLeaseResponses = {
     /**
-     * Raw file bytes (at most 16 MiB); Content-Type is inferred from the extension. ETag is present only when a digest is available. Larger files require the sandbox connection issued by connect.
-     */
-    200: Blob | File;
-    /**
-     * Single byte range
+     * Computer result
      */
-    206: Blob | File;
+    200: {
+        /**
+         * Id of the lease that keeps this connection's machine in service; renew it while the connection is open and release it on close. Null when no lease exists.
+         */
+        lease_id: string;
+        /**
+         * Time the lease lapses unless renewed, as an ISO 8601 timestamp; renew at about a third of the time remaining.
+         */
+        lease_expires_at: string;
+    };
 };
-export type ComputersFilesContentResponse = ComputersFilesContentResponses[keyof ComputersFilesContentResponses];
-export type ConnectComputerData = {
+export type RenewComputerLeaseResponse = RenewComputerLeaseResponses[keyof RenewComputerLeaseResponses];
+export type ReleaseComputerLeaseData = {
     body?: never;
     path: {
         /**
          * Computer id (cmp_...), as returned by computers.create or computers.list.
          */
         computer_id: string;
+        /**
+         * lease_id from the connect response.
+         */
+        lease_id: string;
     };
     query?: never;
-    url: '/agent/v1/computers/{computer_id}/connect';
+    url: '/agent/v1/computers/{computer_id}/leases/{lease_id}';
 };
-export type ConnectComputerErrors = {
+export type ReleaseComputerLeaseErrors = {
     /**
      * Platform error with Computer code, message and hint
      */
@@ -28175,27 +29219,23 @@ export type ConnectComputerErrors = {
         };
     };
 };
-export type ConnectComputerError = ConnectComputerErrors[keyof ConnectComputerErrors];
-export type ConnectComputerResponses = {
+export type ReleaseComputerLeaseError = ReleaseComputerLeaseErrors[keyof ReleaseComputerLeaseErrors];
+export type ReleaseComputerLeaseResponses = {
     /**
      * Computer result
      */
     200: {
         /**
-         * Public id of the sandbox that backs the computer, usable with the sandbox API; null while none has been created.
+         * Id of the released lease.
          */
-        sandbox_id: string;
+        id: string;
         /**
-         * Access token for the sandbox's environment daemon, returned by the connect call; treat it as a secret.
+         * Object type tag.
          */
-        envd_access_token: string;
-        /**
-         * Sandbox template the computer's sandbox was created from.
-         */
-        template_id: string;
+        type: 'computer_lease_released';
     };
 };
-export type ConnectComputerResponse = ConnectComputerResponses[keyof ConnectComputerResponses];
+export type ReleaseComputerLeaseResponse = ReleaseComputerLeaseResponses[keyof ReleaseComputerLeaseResponses];
 export type ListToolsetsData = {
     body?: never;
     path?: never;
@@ -28588,11 +29628,11 @@ export type ForkSessionResponses = {
              */
             description: null | string;
             /**
-             * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
+             * Praxis extension: Streamable HTTP, SSE or trusted stdio MCP servers, persisted with the agent version. Optional fields remain omitted when not supplied.
              */
             mcp_servers: Array<{
                 /**
-                 * Always `url`. An MCP server reached over a URL.
+                 * Streamable HTTP transport.
                  */
                 type: 'url';
                 /**
@@ -28600,9 +29640,69 @@ export type ForkSessionResponses = {
                  */
                 name: string;
                 /**
-                 * http(s) endpoint of the MCP server, at most 2048 characters.
+                 * HTTP or HTTPS MCP server endpoint.
                  */
                 url: string;
+                /**
+                 * Praxis extension: request headers. Platform identity headers take precedence, case-insensitively.
+                 */
+                headers?: {
+                    [key: string]: string;
+                };
+                /**
+                 * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
+                 */
+                timeout_ms?: number;
+            } | {
+                /**
+                 * Legacy SSE transport.
+                 */
+                type: 'sse';
+                /**
+                 * Name of the MCP server; the mcp_toolset entry that refers to it uses the same name in mcp_server_name.
+                 */
+                name: string;
+                /**
+                 * HTTP or HTTPS MCP server endpoint.
+                 */
+                url: string;
+                /**
+                 * Praxis extension: request headers. Platform identity headers take precedence, case-insensitively.
+                 */
+                headers?: {
+                    [key: string]: string;
+                };
+                /**
+                 * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
+                 */
+                timeout_ms?: number;
+            } | {
+                /**
+                 * Run a command on the agent computer.
+                 */
+                type: 'stdio';
+                /**
+                 * Name of the MCP server; the mcp_toolset entry that refers to it uses the same name in mcp_server_name.
+                 */
+                name: string;
+                /**
+                 * Executable command on the agent computer.
+                 */
+                command: string;
+                /**
+                 * Command arguments; omitted means no arguments.
+                 */
+                args?: Array<string>;
+                /**
+                 * Praxis extension: environment variables for the command on the agent computer.
+                 */
+                env?: {
+                    [key: string]: string;
+                };
+                /**
+                 * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
+                 */
+                timeout_ms?: number;
             }>;
             /**
              * Model identifier and configuration.
@@ -28693,11 +29793,11 @@ export type ForkSessionResponses = {
                      */
                     description: null | string;
                     /**
-                     * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
+                     * Praxis extension: Streamable HTTP, SSE or trusted stdio MCP servers, persisted with the agent version. Optional fields remain omitted when not supplied.
                      */
                     mcp_servers: Array<{
                         /**
-                         * Always `url`. An MCP server reached over a URL.
+                         * Streamable HTTP transport.
                          */
                         type: 'url';
                         /**
@@ -28705,9 +29805,69 @@ export type ForkSessionResponses = {
                          */
                         name: string;
                         /**
-                         * http(s) endpoint of the MCP server, at most 2048 characters.
+                         * HTTP or HTTPS MCP server endpoint.
+                         */
+                        url: string;
+                        /**
+                         * Praxis extension: request headers. Platform identity headers take precedence, case-insensitively.
+                         */
+                        headers?: {
+                            [key: string]: string;
+                        };
+                        /**
+                         * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
+                         */
+                        timeout_ms?: number;
+                    } | {
+                        /**
+                         * Legacy SSE transport.
+                         */
+                        type: 'sse';
+                        /**
+                         * Name of the MCP server; the mcp_toolset entry that refers to it uses the same name in mcp_server_name.
+                         */
+                        name: string;
+                        /**
+                         * HTTP or HTTPS MCP server endpoint.
                          */
                         url: string;
+                        /**
+                         * Praxis extension: request headers. Platform identity headers take precedence, case-insensitively.
+                         */
+                        headers?: {
+                            [key: string]: string;
+                        };
+                        /**
+                         * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
+                         */
+                        timeout_ms?: number;
+                    } | {
+                        /**
+                         * Run a command on the agent computer.
+                         */
+                        type: 'stdio';
+                        /**
+                         * Name of the MCP server; the mcp_toolset entry that refers to it uses the same name in mcp_server_name.
+                         */
+                        name: string;
+                        /**
+                         * Executable command on the agent computer.
+                         */
+                        command: string;
+                        /**
+                         * Command arguments; omitted means no arguments.
+                         */
+                        args?: Array<string>;
+                        /**
+                         * Praxis extension: environment variables for the command on the agent computer.
+                         */
+                        env?: {
+                            [key: string]: string;
+                        };
+                        /**
+                         * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
+                         */
+                        timeout_ms?: number;
                     }>;
                     /**
                      * Model identifier and configuration.
@@ -28801,7 +29961,7 @@ export type ForkSessionResponses = {
                      */
                     system: null | string;
                     /**
-                     * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+                     * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
                      */
                     tools: Array<{
                         /**
@@ -29295,7 +30455,7 @@ export type ForkSessionResponses = {
              */
             system: null | string;
             /**
-             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
              */
             tools: Array<{
                 /**
@@ -30600,6 +31760,188 @@ export type ListSessionCompactionsResponses = {
     };
 };
 export type ListSessionCompactionsResponse = ListSessionCompactionsResponses[keyof ListSessionCompactionsResponses];
+export type GetEmbedAppearanceData = {
+    body?: never;
+    headers?: {
+        /**
+         * Active public key from the agent's console embed settings; alternative to an end-user Bearer token.
+         */
+        'Praxis-Publishable-Key'?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/agent/v1/embed/appearance';
+};
+export type GetEmbedAppearanceErrors = {
+    /**
+     * Addressing parameters are not accepted; remove identity_number, agent_id and other query parameters.
+     */
+    400: unknown;
+    /**
+     * Supply a valid embed token or an active publishable key; organization member credentials cannot read this surface.
+     */
+    401: unknown;
+    /**
+     * The credential's service agent is absent or archived; obtain credentials for an active service agent.
+     */
+    404: unknown;
+    /**
+     * Appearance is temporarily unavailable; use default appearance and continue the conversation.
+     */
+    503: unknown;
+};
+export type GetEmbedAppearanceResponses = {
+    /**
+     * Saved Kit options, at most 8192 UTF-8 JSON bytes. Omitted groups use Kit defaults; an unconfigured agent returns an empty object.
+     */
+    200: {
+        /**
+         * Public identity displayed on the chat page, independent of the internal agent name.
+         */
+        agent?: {
+            /**
+             * Display name; omission keeps the neutral browser-language default.
+             */
+            name?: string;
+            /**
+             * Optional HTTPS avatar image URL; non-HTTPS images are rejected.
+             */
+            avatar?: string;
+        };
+        /**
+         * Loader default: inline stays in the page, sidebar attaches to the edge, popup floats above its launcher, modal centers an overlay. A script data-layout overrides it; Hosted always uses inline.
+         */
+        layout?: 'inline' | 'sidebar' | 'popup' | 'modal';
+        /**
+         * Default entry button for the loader; an explicit script data-launcher takes precedence.
+         */
+        launcher?: {
+            /**
+             * Entry control: none hides the launcher, bubble shows a button, mascot shows the image.
+             */
+            type: 'none' | 'bubble' | 'mascot';
+            /**
+             * Optional HTTPS mascot image URL.
+             */
+            image?: string;
+            /**
+             * Launcher corner: bottom-right is the default; bottom-left uses the opposite corner.
+             */
+            position?: 'bottom-right' | 'bottom-left';
+            /**
+             * Accessible entry button label and bubble text; omission uses the default chat label.
+             */
+            label?: string;
+        };
+        /**
+         * Visible chat heading; omitted title uses the public agent name.
+         */
+        header?: {
+            /**
+             * Optional heading text shown instead of the public agent name.
+             */
+            title?: string;
+            /**
+             * Optional secondary line beneath the heading.
+             */
+            subtitle?: string;
+            /**
+             * Optional HTTPS image shown in the heading avatar position.
+             */
+            icon?: string;
+        };
+        /**
+         * Visual tokens applied to the conversation and header; omitted fields use Kit defaults.
+         */
+        theme?: {
+            /**
+             * light or dark selects a fixed scheme; system follows the device preference.
+             */
+            colorScheme?: 'light' | 'dark' | 'system';
+            /**
+             * Explicit opaque CSS accent color, for example #167A43.
+             */
+            accent?: string;
+            /**
+             * Explicit opaque CSS background color, for example #ffffff.
+             */
+            surface?: string;
+            /**
+             * neutral uses grayscale surfaces, warm uses warm tones, cool uses cool tones.
+             */
+            grayscale?: 'neutral' | 'warm' | 'cool';
+            /**
+             * Corner rounding: none is square, sm is small, md is medium, lg is large, full is fully rounded.
+             */
+            radius?: 'none' | 'sm' | 'md' | 'lg' | 'full';
+            /**
+             * Spacing: compact reduces gaps, normal uses defaults, spacious increases gaps.
+             */
+            density?: 'compact' | 'normal' | 'spacious';
+            /**
+             * CSS font family list using fonts available on the device; external font loading is not configured here.
+             */
+            fontFamily?: string;
+            /**
+             * Positive base font size in CSS pixels; omission preserves Kit sizing.
+             */
+            fontSize?: number;
+        };
+        /**
+         * Reserved Kit locale preference: zh for Chinese, en for English. Kit currently passes this option through without translating all controls.
+         */
+        locale?: 'zh' | 'en';
+        /**
+         * Content displayed before the first message in a conversation.
+         */
+        startScreen?: {
+            /**
+             * Optional welcome text on the empty conversation.
+             */
+            greeting?: string;
+            /**
+             * Up to four suggested questions; clicking a label sends its prompt text.
+             */
+            prompts?: Array<{
+                /**
+                 * Visible suggested-question button text.
+                 */
+                label: string;
+                /**
+                 * User message sent when this suggestion is selected.
+                 */
+                prompt: string;
+            }>;
+        };
+        /**
+         * Message input appearance; transport and attachment settings are excluded.
+         */
+        composer?: {
+            /**
+             * Hint shown when the message input is empty.
+             */
+            placeholder?: string;
+        };
+        /**
+         * Optional notice displayed beside the conversation composer.
+         */
+        disclaimer?: string;
+        /**
+         * Optional text below the conversation.
+         */
+        footer?: string;
+        /**
+         * Availability of the conversation history control.
+         */
+        history?: {
+            /**
+             * False hides history; omission uses the default enabled state.
+             */
+            enabled?: boolean;
+        };
+    };
+};
+export type GetEmbedAppearanceResponse = GetEmbedAppearanceResponses[keyof GetEmbedAppearanceResponses];
 export type CreateAudioSpeechData = {
     body: unknown & {
         /**
@@ -38156,7 +39498,7 @@ export type AgentsListResponses = {
              */
             system: null | string;
             /**
-             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
              */
             tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
             /**
@@ -39065,7 +40407,7 @@ export type AgentsCreateResponses = {
          */
         system: null | string;
         /**
-         * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+         * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
          */
         tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
         /**
@@ -39541,7 +40883,7 @@ export type AgentsRetrieveResponses = {
          */
         system: null | string;
         /**
-         * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+         * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
          */
         tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
         /**
@@ -40460,7 +41802,7 @@ export type AgentsUpdateResponses = {
          */
         system: null | string;
         /**
-         * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+         * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
          */
         tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
         /**
@@ -40930,7 +42272,7 @@ export type AgentsArchiveResponses = {
          */
         system: null | string;
         /**
-         * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+         * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
          */
         tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
         /**
@@ -41410,7 +42752,7 @@ export type AgentsVersionsListResponses = {
              */
             system: null | string;
             /**
-             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
              */
             tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
             /**
@@ -41947,7 +43289,7 @@ export type SessionsListResponses = {
                  */
                 system: null | string;
                 /**
-                 * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+                 * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
                  */
                 tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
                 /**
@@ -42256,7 +43598,7 @@ export type SessionsCreateResponses = {
              */
             system: null | string;
             /**
-             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
              */
             tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
             /**
@@ -42494,7 +43836,7 @@ export type SessionsRetrieveResponses = {
              */
             system: null | string;
             /**
-             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
              */
             tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
             /**
@@ -42772,7 +44114,7 @@ export type SessionsUpdateResponses = {
              */
             system: null | string;
             /**
-             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
              */
             tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
             /**
@@ -43010,7 +44352,7 @@ export type SessionsArchiveResponses = {
              */
             system: null | string;
             /**
-             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries; custom tool definitions are rejected with 400. Keep bash enabled to use codemode, skill and subagents.
+             * Tools of the agent: one agent_toolset_20260401 entry for the native tools (all resolved settings are returned, ready to send back on update), plus mcp_toolset entries and custom tool definitions. Custom calls emit agent.custom_tool_use and wait for user.custom_tool_result. Keep bash enabled to use codemode, skill and subagents.
              */
             tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
             /**
@@ -43229,6 +44571,24 @@ export type SessionsEventsListResponses = {
              * A timestamp in RFC 3339 format
              */
             processed_at?: null | string;
+            /**
+             * Untrusted page context for this user message only. Resend on each turn when needed; never added to system instructions. The complete JSON value must be at most 4096 UTF-8 bytes; invalid values return 400 INVALID_PARAMS. Empty items are treated as absent. Available only on /agent/v1.
+             */
+            praxis_context?: {
+                /**
+                 * Named page values supplied by the client for this turn.
+                 */
+                items: Array<{
+                    /**
+                     * Page context key, such as lesson or section.
+                     */
+                    name: string;
+                    /**
+                     * Untrusted page value; escaped before inclusion in the user message.
+                     */
+                    value: string;
+                }>;
+            };
             /**
              * UI transcript message ID. Use the last assistant message in a successfully completed turn as the fork target.
              */
@@ -43862,7 +45222,34 @@ export type SessionsEventsSendData = {
         /**
          * Events to send to the `session`.
          */
-        events: Array<AgentManaged59 | AgentManaged71 | AgentManaged74 | AgentManaged250 | AgentManaged251 | AgentManaged252 | AgentManaged253 | {
+        events: Array<{
+            /**
+             * Array of content blocks for the user message.
+             */
+            content: Array<AgentManaged60 | AgentManaged61 | AgentManaged65 | AgentManaged70>;
+            /**
+             * User message event carrying one nonempty text content block.
+             */
+            type: 'user.message';
+            /**
+             * Untrusted page context for this user message only. Resend on each turn when needed; never added to system instructions. The complete JSON value must be at most 4096 UTF-8 bytes; invalid values return 400 INVALID_PARAMS. Empty items are treated as absent. Available only on /agent/v1.
+             */
+            praxis_context?: {
+                /**
+                 * Named page values supplied by the client for this turn.
+                 */
+                items: Array<{
+                    /**
+                     * Page context key, such as lesson or section.
+                     */
+                    name: string;
+                    /**
+                     * Untrusted page value; escaped before inclusion in the user message.
+                     */
+                    value: string;
+                }>;
+            };
+        } | AgentManaged71 | AgentManaged74 | AgentManaged250 | AgentManaged251 | AgentManaged252 | AgentManaged253 | {
             /**
              * Request to inject the queued user message named by event_id into the running turn.
              */
@@ -43924,7 +45311,42 @@ export type SessionsEventsSendResponses = {
         /**
          * Sent events
          */
-        data?: Array<AgentManaged185 | AgentManaged186 | AgentManaged187 | AgentManaged188 | AgentManaged238 | AgentManaged243 | AgentManaged247 | {
+        data?: Array<{
+            /**
+             * Unique identifier for this event.
+             */
+            id: string;
+            /**
+             * Array of content blocks comprising the user message.
+             */
+            content: Array<AgentManaged60 | AgentManaged61 | AgentManaged65 | AgentManaged70>;
+            /**
+             * Always `user.message`. A message from the user to the agent, with content blocks.
+             */
+            type: 'user.message';
+            /**
+             * A timestamp in RFC 3339 format
+             */
+            processed_at?: null | string;
+            /**
+             * Untrusted page context for this user message only. Resend on each turn when needed; never added to system instructions. The complete JSON value must be at most 4096 UTF-8 bytes; invalid values return 400 INVALID_PARAMS. Empty items are treated as absent. Available only on /agent/v1.
+             */
+            praxis_context?: {
+                /**
+                 * Named page values supplied by the client for this turn.
+                 */
+                items: Array<{
+                    /**
+                     * Page context key, such as lesson or section.
+                     */
+                    name: string;
+                    /**
+                     * Untrusted page value; escaped before inclusion in the user message.
+                     */
+                    value: string;
+                }>;
+            };
+        } | AgentManaged186 | AgentManaged187 | AgentManaged188 | AgentManaged238 | AgentManaged243 | AgentManaged247 | {
             /**
              * Event id, unique within the session. Use it to refer to this event, for example in user.tool_confirmation or user.steer.
              */
@@ -44156,6 +45578,24 @@ export type SessionsThreadsEventsListResponses = {
              * A timestamp in RFC 3339 format
              */
             processed_at?: null | string;
+            /**
+             * Untrusted page context for this user message only. Resend on each turn when needed; never added to system instructions. The complete JSON value must be at most 4096 UTF-8 bytes; invalid values return 400 INVALID_PARAMS. Empty items are treated as absent. Available only on /agent/v1.
+             */
+            praxis_context?: {
+                /**
+                 * Named page values supplied by the client for this turn.
+                 */
+                items: Array<{
+                    /**
+                     * Page context key, such as lesson or section.
+                     */
+                    name: string;
+                    /**
+                     * Untrusted page value; escaped before inclusion in the user message.
+                     */
+                    value: string;
+                }>;
+            };
             /**
              * UI transcript message ID. Use the last assistant message in a successfully completed turn as the fork target.
              */