@deepraxis/sdk 0.1.1-dev.c64b603 → 0.1.1-dev.d775f1e

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

@@ -1,6 +1,261 @@
 export type ClientOptions = {
     baseUrl: 'https://api.deepraxis.com' | (string & {});
 };
+/**
+ * Praxis extension: Streamable HTTP, SSE or trusted stdio MCP servers, persisted with the agent version. Optional fields remain omitted when not supplied.
+ */
+export type AgentManaged36 = {
+    /**
+     * Streamable HTTP transport.
+     */
+    type: 'url';
+    /**
+     * 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;
+} | {
+    /**
+     * 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;
+};
+/**
+ * Free-form string key/value pairs stored with the agent for your own bookkeeping.
+ */
+export type AgentManaged37 = {
+    [key: string]: string;
+};
+export type AgentManaged2 = {
+    /**
+     * Always `low`. Lowest reasoning effort of the supported levels.
+     */
+    type: 'low';
+};
+export type AgentManaged3 = {
+    /**
+     * Always `medium`. Middle reasoning effort.
+     */
+    type: 'medium';
+};
+export type AgentManaged4 = {
+    /**
+     * Always `high`. High reasoning effort.
+     */
+    type: 'high';
+};
+export type AgentManaged5 = {
+    /**
+     * Always `xhigh`. Extra-high reasoning effort, above high; only models that list it in thinking.efforts accept it.
+     */
+    type: 'xhigh';
+};
+export type AgentManaged6 = {
+    /**
+     * Always `max`. Maximum effort level of the Managed Agents shape, above xhigh.
+     */
+    type: 'max';
+};
+export type AgentManaged39 = {
+    /**
+     * Agents the coordinator may spawn as session threads, each resolved to a specific
+     * version.
+     */
+    agents: Array<AgentManaged40 | AgentManaged41>;
+    /**
+     * Always `coordinator`. The agent coordinates the roster in agents and can delegate to its members.
+     */
+    type: 'coordinator';
+};
+export type AgentManaged42 = {
+    /**
+     * Id of the skill to attach.
+     */
+    skill_id: string;
+    /**
+     * Always `anthropic`. A skill provided by Anthropic, identified by skill_id.
+     */
+    type: 'anthropic';
+    /**
+     * Version of the skill: omit or `latest` to follow the newest version at each new session; give a version id to pin it.
+     */
+    version: string;
+};
+export type AgentManaged43 = {
+    /**
+     * Id of the skill to attach.
+     */
+    skill_id: string;
+    /**
+     * Always `custom`. A skill created by you, identified by skill_id.
+     */
+    type: 'custom';
+    /**
+     * Version of the skill: omit or `latest` to follow the newest version at each new session; give a version id to pin it.
+     */
+    version: string;
+};
+export type AgentManaged44 = {
+    /**
+     * Per-tool settings that override default_config. Tools that are not listed follow default_config.
+     */
+    configs: Array<AgentManaged45 | AgentManaged46 | AgentManaged47 | AgentManaged48 | AgentManaged49 | AgentManaged50 | AgentManaged51 | AgentManaged52 | {
+        /**
+         * Name of the native tool this entry configures.
+         */
+        name: 'task_output' | 'task_stop' | 'monitor' | 'agent' | 'send_message' | 'codemode' | 'skill';
+        /**
+         * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
+         */
+        enabled: boolean;
+        /**
+         * Whether a call to this tool runs automatically (always_allow) or waits for user.tool_confirmation (always_ask). Omitted means the toolset default.
+         */
+        permission_policy: {
+            /**
+             * Permission policy kind.
+             */
+            type: 'always_allow' | 'always_ask';
+        };
+    }>;
+    /**
+     * Resolved default configuration for agent tools.
+     */
+    default_config: AgentManaged53;
+    /**
+     * Always `agent_toolset_20260401`. The native toolset entry (bash, edit, glob, grep, read, write, web_search, web_fetch, task_output, task_stop, monitor, agent, send_message).
+     */
+    type: 'agent_toolset_20260401';
+};
+/**
+ * Exactly one toolset per declared MCP server. Tools default to enabled and always_ask; per-tool overrides inherit omitted settings.
+ */
+export type AgentManaged54 = {
+    /**
+     * Always `mcp_toolset`. An entry that exposes the tools of one MCP server from mcp_servers.
+     */
+    type: 'mcp_toolset';
+    /**
+     * Name of the MCP server in mcp_servers whose tools this entry exposes.
+     */
+    mcp_server_name: string;
+    /**
+     * Settings applied to every tool of this toolset that configs does not name. When omitted, tools are enabled with the always_allow policy.
+     */
+    default_config?: {
+        /**
+         * Whether tools of the toolset are offered to the model when configs does not name them. Null or omitted means enabled.
+         */
+        enabled?: boolean | null;
+        /**
+         * Permission policy for tools that configs does not name: always_allow runs calls automatically, always_ask waits for user.tool_confirmation.
+         */
+        permission_policy?: null | {
+            /**
+             * Permission policy kind.
+             */
+            type: 'always_allow' | 'always_ask';
+        };
+    } | null;
+    /**
+     * Per-tool settings that override default_config. Tools that are not listed follow default_config.
+     */
+    configs?: Array<{
+        /**
+         * Bare tool name reported by the MCP server.
+         */
+        name: string;
+        /**
+         * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
+         */
+        enabled?: boolean | null;
+        /**
+         * Whether a call to this tool runs automatically (always_allow) or waits for user.tool_confirmation (always_ask). Omitted means the toolset default.
+         */
+        permission_policy?: null | {
+            /**
+             * Permission policy kind.
+             */
+            type: 'always_allow' | 'always_ask';
+        };
+    }> | null;
+};
+export type AgentManaged57 = {
+    /**
+     * What the custom tool does and when the model should call it.
+     */
+    description: string;
+    /**
+     * JSON Schema for custom tool input parameters.
+     */
+    input_schema: AgentManaged33;
+    /**
+     * Name of the custom tool, as the model sees and calls it.
+     */
+    name: string;
+    /**
+     * Always `custom`. A custom tool defined by name, description and input_schema; its calls are answered by the client with user.custom_tool_result.
+     */
+    type: 'custom';
+};
 export type AgentError = {
     type: 'error';
     error: {
@@ -3966,488 +4221,233 @@ export type AgentManaged184 = {
      */
     type: 'session_deleted';
 };
+export type AgentManaged171 = {
+    /**
+     * Full `agent` definitions the coordinator may spawn as session threads.
+     */
+    agents: Array<AgentManaged41 | AgentManaged172>;
+    /**
+     * Always `coordinator`. The agent coordinates the roster in agents and can delegate to its members.
+     */
+    type: 'coordinator';
+};
+/**
+ * Session spending limit, {type: "limit", max_list_cost: {amount, currency}}; null when unlimited. amount is in US dollars: send an integer or up to 2 decimals ("0.50"), and responses carry exactly 2 decimals ("20.00"). Creation defaults to USD 20.00 when omitted. More decimals, zero or a number return 400. Removing the limit with null prevents setting it again for that session.
+ */
+export type AgentManaged76 = {
+    /**
+     * A monetary amount in a specific currency.
+     */
+    max_list_cost: AgentManaged77;
+    /**
+     * Budget kind; always limit. Any other value, including max_list_cost, returns 400 budget.type must be "limit".
+     */
+    type: 'limit';
+};
+/**
+ * Free-form string key/value pairs stored with the session, changed through sessions.update patch semantics.
+ */
+export type AgentManaged173 = {
+    [key: string]: string;
+};
+export type AgentManaged174 = {
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    completed_at: null | string;
+    /**
+     * What the agent should produce.
+     */
+    description: string;
+    /**
+     * Grader's verdict text from the most recent evaluation. For `satisfied`, explains
+     * why criteria are met; for `needs_revision` (intermediate), what's missing; for
+     * `failed`, why unrecoverable.
+     */
+    explanation: null | string;
+    /**
+     * 0-indexed revision cycle the outcome is currently on.
+     */
+    iteration: number;
+    /**
+     * Server-generated outc\_ ID for this outcome.
+     */
+    outcome_id: string;
+    /**
+     * Current evaluation state. `pending` before the agent begins work; `running`
+     * while producing or revising; `evaluating` while the grader scores;
+     * `satisfied`/`max_iterations_reached`/`failed`/`interrupted` are terminal.
+     */
+    result: string;
+    /**
+     * Always `outcome_evaluation`. Record of one outcome evaluation.
+     */
+    type: 'outcome_evaluation';
+};
+export type AgentManaged175 = {
+    /**
+     * Resource id, the resource_id of sessions.resources calls.
+     */
+    id: string;
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    created_at: string;
+    /**
+     * Path inside the machine where the file is mounted; defaults to /mnt/session/uploads/<file_id>, and custom paths are rooted there.
+     */
+    mount_path: string;
+    /**
+     * Always `github_repository`. A GitHub repository resource; not supported on this platform.
+     */
+    type: 'github_repository';
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    updated_at: string;
+    /**
+     * Repository URL.
+     */
+    url: string;
+    /**
+     * Branch or commit to check out.
+     */
+    checkout?: null | AgentManaged80 | AgentManaged81;
+};
+export type AgentManaged176 = {
+    /**
+     * Resource id, the resource_id of sessions.resources calls.
+     */
+    id: string;
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    created_at: string;
+    /**
+     * Id of the uploaded file; it must exist and belong to your tenant.
+     */
+    file_id: string;
+    /**
+     * Path inside the machine where the file is mounted; defaults to /mnt/session/uploads/<file_id>, and custom paths are rooted there.
+     */
+    mount_path: string;
+    /**
+     * Always `file`. A file resource: an uploaded file mounted into the session's machine.
+     */
+    type: 'file';
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    updated_at: string;
+};
+export type AgentManaged177 = {
+    /**
+     * The memory store ID (memstore\_...). Must belong to the caller's organization
+     * and workspace.
+     */
+    memory_store_id: string;
+    /**
+     * Always `memory_store`. A memory store resource; not supported on this platform.
+     */
+    type: 'memory_store';
+    /**
+     * Access mode for an attached memory store.
+     */
+    access?: null | 'read_write' | 'read_only';
+    /**
+     * Description of the memory store, snapshotted at attach time. Rendered into the
+     * agent's system prompt. Empty string when the store has no description.
+     */
+    description?: string;
+    /**
+     * Per-attachment guidance for the agent on how to use this store. Rendered into
+     * the memory section of the system prompt. Max 4096 chars.
+     */
+    instructions?: null | string;
+    /**
+     * Filesystem path where the store is mounted in the session container, e.g.
+     * /mnt/memory/user-preferences. Derived from the store's name. Output-only.
+     */
+    mount_path?: null | string;
+    /**
+     * Display name of the memory store, snapshotted at attach time. Later edits to the
+     * store's name do not propagate to this resource.
+     */
+    name?: null | string;
+};
+/**
+ * Cumulative timing statistics of the session.
+ */
+export type AgentManaged178 = {
+    /**
+     * Cumulative time in seconds the session spent in `running` status. Excludes idle
+     * time.
+     */
+    active_seconds?: number;
+    /**
+     * Elapsed time since session creation in seconds. For terminated sessions, frozen
+     * at the final update.
+     */
+    duration_seconds?: number;
+};
+/**
+ * Cumulative token usage and list cost of the session so far.
+ */
+export type AgentManaged179 = {
+    /**
+     * Cumulative time in seconds during which the session had at least one thread in
+     * running status. Overlapping activity from concurrent threads is counted once,
+     * unlike `stats.active_seconds`, which sums each thread's own active time. This is
+     * the duration the session's runtime cost is priced on.
+     */
+    active_seconds?: number;
+    /**
+     * Prompt-cache creation token usage broken down by cache lifetime.
+     */
+    cache_creation?: AgentManaged180;
+    /**
+     * Total tokens read from prompt cache.
+     */
+    cache_read_input_tokens?: number;
+    /**
+     * Total input tokens consumed across all turns.
+     */
+    input_tokens?: number;
+    /**
+     * A monetary amount in a specific currency.
+     */
+    list_cost?: null | AgentManaged77;
+    /**
+     * Total output tokens generated across all turns.
+     */
+    output_tokens?: number;
+    /**
+     * Cumulative count of server-executed tool invocations, broken down by tool.
+     */
+    server_tool_use?: null | AgentManaged181;
+    /**
+     * Praxis extension: priced runtime of this session (the time it was running), billed separately from list_cost and not counted against the budget. amount is in US dollars as a decimal string with exactly 6 decimals, e.g. "0.000280". Each thread's runtime is reported on that thread. /agent/v1 only.
+     */
+    runtime_cost?: {
+        /**
+         * Runtime cost in US dollars, decimal string with exactly 6 decimals.
+         */
+        amount: string;
+        /**
+         * Always USD.
+         */
+        currency: 'USD';
+    };
+};
+export type AgentManaged183 = {
+    [key: string]: null | string;
+};
 /**
  * Praxis extension: Streamable HTTP, SSE or trusted stdio MCP servers, persisted with the agent version. Optional fields remain omitted when not supplied.
  */
-export type AgentManaged36 = {
+export type AgentManaged7 = {
     /**
-     * Streamable HTTP transport.
-     */
-    type: 'url';
-    /**
-     * 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;
-} | {
-    /**
-     * 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;
-};
-export type AgentManaged2 = {
-    /**
-     * Always `low`. Lowest reasoning effort of the supported levels.
-     */
-    type: 'low';
-};
-export type AgentManaged3 = {
-    /**
-     * Always `medium`. Middle reasoning effort.
-     */
-    type: 'medium';
-};
-export type AgentManaged4 = {
-    /**
-     * Always `high`. High reasoning effort.
-     */
-    type: 'high';
-};
-export type AgentManaged5 = {
-    /**
-     * Always `xhigh`. Extra-high reasoning effort, above high; only models that list it in thinking.efforts accept it.
-     */
-    type: 'xhigh';
-};
-export type AgentManaged6 = {
-    /**
-     * Always `max`. Maximum effort level of the Managed Agents shape, above xhigh.
-     */
-    type: 'max';
-};
-export type AgentManaged171 = {
-    /**
-     * Full `agent` definitions the coordinator may spawn as session threads.
-     */
-    agents: Array<AgentManaged41 | AgentManaged172>;
-    /**
-     * Always `coordinator`. The agent coordinates the roster in agents and can delegate to its members.
-     */
-    type: 'coordinator';
-};
-export type AgentManaged42 = {
-    /**
-     * Id of the skill to attach.
-     */
-    skill_id: string;
-    /**
-     * Always `anthropic`. A skill provided by Anthropic, identified by skill_id.
-     */
-    type: 'anthropic';
-    /**
-     * Version of the skill: omit or `latest` to follow the newest version at each new session; give a version id to pin it.
-     */
-    version: string;
-};
-export type AgentManaged43 = {
-    /**
-     * Id of the skill to attach.
-     */
-    skill_id: string;
-    /**
-     * Always `custom`. A skill created by you, identified by skill_id.
-     */
-    type: 'custom';
-    /**
-     * Version of the skill: omit or `latest` to follow the newest version at each new session; give a version id to pin it.
-     */
-    version: string;
-};
-export type AgentManaged44 = {
-    /**
-     * Per-tool settings that override default_config. Tools that are not listed follow default_config.
-     */
-    configs: Array<AgentManaged45 | AgentManaged46 | AgentManaged47 | AgentManaged48 | AgentManaged49 | AgentManaged50 | AgentManaged51 | AgentManaged52 | {
-        /**
-         * Name of the native tool this entry configures.
-         */
-        name: 'task_output' | 'task_stop' | 'monitor' | 'agent' | 'send_message' | 'codemode' | 'skill';
-        /**
-         * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-         */
-        enabled: boolean;
-        /**
-         * Whether a call to this tool runs automatically (always_allow) or waits for user.tool_confirmation (always_ask). Omitted means the toolset default.
-         */
-        permission_policy: {
-            /**
-             * Permission policy kind.
-             */
-            type: 'always_allow' | 'always_ask';
-        };
-    }>;
-    /**
-     * Resolved default configuration for agent tools.
-     */
-    default_config: AgentManaged53;
-    /**
-     * Always `agent_toolset_20260401`. The native toolset entry (bash, edit, glob, grep, read, write, web_search, web_fetch, task_output, task_stop, monitor, agent, send_message).
-     */
-    type: 'agent_toolset_20260401';
-};
-/**
- * Exactly one toolset per declared MCP server. Tools default to enabled and always_ask; per-tool overrides inherit omitted settings.
- */
-export type AgentManaged54 = {
-    /**
-     * Always `mcp_toolset`. An entry that exposes the tools of one MCP server from mcp_servers.
-     */
-    type: 'mcp_toolset';
-    /**
-     * Name of the MCP server in mcp_servers whose tools this entry exposes.
-     */
-    mcp_server_name: string;
-    /**
-     * Settings applied to every tool of this toolset that configs does not name. When omitted, tools are enabled with the always_allow policy.
-     */
-    default_config?: {
-        /**
-         * Whether tools of the toolset are offered to the model when configs does not name them. Null or omitted means enabled.
-         */
-        enabled?: boolean | null;
-        /**
-         * Permission policy for tools that configs does not name: always_allow runs calls automatically, always_ask waits for user.tool_confirmation.
-         */
-        permission_policy?: null | {
-            /**
-             * Permission policy kind.
-             */
-            type: 'always_allow' | 'always_ask';
-        };
-    } | null;
-    /**
-     * Per-tool settings that override default_config. Tools that are not listed follow default_config.
-     */
-    configs?: Array<{
-        /**
-         * Bare tool name reported by the MCP server.
-         */
-        name: string;
-        /**
-         * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-         */
-        enabled?: boolean | null;
-        /**
-         * Whether a call to this tool runs automatically (always_allow) or waits for user.tool_confirmation (always_ask). Omitted means the toolset default.
-         */
-        permission_policy?: null | {
-            /**
-             * Permission policy kind.
-             */
-            type: 'always_allow' | 'always_ask';
-        };
-    }> | null;
-};
-export type AgentManaged57 = {
-    /**
-     * What the custom tool does and when the model should call it.
-     */
-    description: string;
-    /**
-     * JSON Schema for custom tool input parameters.
-     */
-    input_schema: AgentManaged33;
-    /**
-     * Name of the custom tool, as the model sees and calls it.
-     */
-    name: string;
-    /**
-     * Always `custom`. A custom tool defined by name, description and input_schema; its calls are answered by the client with user.custom_tool_result.
-     */
-    type: 'custom';
-};
-/**
- * Session spending limit, {type: "limit", max_list_cost: {amount, currency}}; null when unlimited. amount is in US dollars: send an integer or up to 2 decimals ("0.50"), and responses carry exactly 2 decimals ("20.00"). Creation defaults to USD 20.00 when omitted. More decimals, zero or a number return 400. Removing the limit with null prevents setting it again for that session.
- */
-export type AgentManaged76 = {
-    /**
-     * A monetary amount in a specific currency.
-     */
-    max_list_cost: AgentManaged77;
-    /**
-     * Budget kind; always limit. Any other value, including max_list_cost, returns 400 budget.type must be "limit".
-     */
-    type: 'limit';
-};
-/**
- * Free-form string key/value pairs stored with the session, changed through sessions.update patch semantics.
- */
-export type AgentManaged173 = {
-    [key: string]: string;
-};
-export type AgentManaged174 = {
-    /**
-     * A timestamp in RFC 3339 format
-     */
-    completed_at: null | string;
-    /**
-     * What the agent should produce.
-     */
-    description: string;
-    /**
-     * Grader's verdict text from the most recent evaluation. For `satisfied`, explains
-     * why criteria are met; for `needs_revision` (intermediate), what's missing; for
-     * `failed`, why unrecoverable.
-     */
-    explanation: null | string;
-    /**
-     * 0-indexed revision cycle the outcome is currently on.
-     */
-    iteration: number;
-    /**
-     * Server-generated outc\_ ID for this outcome.
-     */
-    outcome_id: string;
-    /**
-     * Current evaluation state. `pending` before the agent begins work; `running`
-     * while producing or revising; `evaluating` while the grader scores;
-     * `satisfied`/`max_iterations_reached`/`failed`/`interrupted` are terminal.
-     */
-    result: string;
-    /**
-     * Always `outcome_evaluation`. Record of one outcome evaluation.
-     */
-    type: 'outcome_evaluation';
-};
-export type AgentManaged175 = {
-    /**
-     * Resource id, the resource_id of sessions.resources calls.
-     */
-    id: string;
-    /**
-     * A timestamp in RFC 3339 format
-     */
-    created_at: string;
-    /**
-     * Path inside the machine where the file is mounted; defaults to /mnt/session/uploads/<file_id>, and custom paths are rooted there.
-     */
-    mount_path: string;
-    /**
-     * Always `github_repository`. A GitHub repository resource; not supported on this platform.
-     */
-    type: 'github_repository';
-    /**
-     * A timestamp in RFC 3339 format
-     */
-    updated_at: string;
-    /**
-     * Repository URL.
-     */
-    url: string;
-    /**
-     * Branch or commit to check out.
-     */
-    checkout?: null | AgentManaged80 | AgentManaged81;
-};
-export type AgentManaged176 = {
-    /**
-     * Resource id, the resource_id of sessions.resources calls.
-     */
-    id: string;
-    /**
-     * A timestamp in RFC 3339 format
-     */
-    created_at: string;
-    /**
-     * Id of the uploaded file; it must exist and belong to your tenant.
-     */
-    file_id: string;
-    /**
-     * Path inside the machine where the file is mounted; defaults to /mnt/session/uploads/<file_id>, and custom paths are rooted there.
-     */
-    mount_path: string;
-    /**
-     * Always `file`. A file resource: an uploaded file mounted into the session's machine.
-     */
-    type: 'file';
-    /**
-     * A timestamp in RFC 3339 format
-     */
-    updated_at: string;
-};
-export type AgentManaged177 = {
-    /**
-     * The memory store ID (memstore\_...). Must belong to the caller's organization
-     * and workspace.
-     */
-    memory_store_id: string;
-    /**
-     * Always `memory_store`. A memory store resource; not supported on this platform.
-     */
-    type: 'memory_store';
-    /**
-     * Access mode for an attached memory store.
-     */
-    access?: null | 'read_write' | 'read_only';
-    /**
-     * Description of the memory store, snapshotted at attach time. Rendered into the
-     * agent's system prompt. Empty string when the store has no description.
-     */
-    description?: string;
-    /**
-     * Per-attachment guidance for the agent on how to use this store. Rendered into
-     * the memory section of the system prompt. Max 4096 chars.
-     */
-    instructions?: null | string;
-    /**
-     * Filesystem path where the store is mounted in the session container, e.g.
-     * /mnt/memory/user-preferences. Derived from the store's name. Output-only.
-     */
-    mount_path?: null | string;
-    /**
-     * Display name of the memory store, snapshotted at attach time. Later edits to the
-     * store's name do not propagate to this resource.
-     */
-    name?: null | string;
-};
-/**
- * Cumulative timing statistics of the session.
- */
-export type AgentManaged178 = {
-    /**
-     * Cumulative time in seconds the session spent in `running` status. Excludes idle
-     * time.
-     */
-    active_seconds?: number;
-    /**
-     * Elapsed time since session creation in seconds. For terminated sessions, frozen
-     * at the final update.
-     */
-    duration_seconds?: number;
-};
-/**
- * Cumulative token usage and list cost of the session so far.
- */
-export type AgentManaged179 = {
-    /**
-     * Cumulative time in seconds during which the session had at least one thread in
-     * running status. Overlapping activity from concurrent threads is counted once,
-     * unlike `stats.active_seconds`, which sums each thread's own active time. This is
-     * the duration the session's runtime cost is priced on.
-     */
-    active_seconds?: number;
-    /**
-     * Prompt-cache creation token usage broken down by cache lifetime.
-     */
-    cache_creation?: AgentManaged180;
-    /**
-     * Total tokens read from prompt cache.
-     */
-    cache_read_input_tokens?: number;
-    /**
-     * Total input tokens consumed across all turns.
-     */
-    input_tokens?: number;
-    /**
-     * A monetary amount in a specific currency.
-     */
-    list_cost?: null | AgentManaged77;
-    /**
-     * Total output tokens generated across all turns.
-     */
-    output_tokens?: number;
-    /**
-     * Cumulative count of server-executed tool invocations, broken down by tool.
-     */
-    server_tool_use?: null | AgentManaged181;
-    /**
-     * Praxis extension: priced runtime of this session (the time it was running), billed separately from list_cost and not counted against the budget. amount is in US dollars as a decimal string with exactly 6 decimals, e.g. "0.000280". Each thread's runtime is reported on that thread. /agent/v1 only.
-     */
-    runtime_cost?: {
-        /**
-         * Runtime cost in US dollars, decimal string with exactly 6 decimals.
-         */
-        amount: string;
-        /**
-         * Always USD.
-         */
-        currency: 'USD';
-    };
-};
-export type AgentManaged183 = {
-    [key: string]: null | string;
-};
-/**
- * Free-form string key/value pairs stored with the agent for your own bookkeeping.
- */
-export type AgentManaged37 = {
-    [key: string]: string;
-};
-export type AgentManaged39 = {
-    /**
-     * Agents the coordinator may spawn as session threads, each resolved to a specific
-     * version.
-     */
-    agents: Array<AgentManaged40 | AgentManaged41>;
-    /**
-     * Always `coordinator`. The agent coordinates the roster in agents and can delegate to its members.
-     */
-    type: 'coordinator';
-};
-/**
- * Praxis extension: Streamable HTTP, SSE or trusted stdio MCP servers, persisted with the agent version. Optional fields remain omitted when not supplied.
- */
-export type AgentManaged7 = {
-    /**
-     * URL transport for an MCP server declared on the agent.
+     * URL transport for an MCP server declared on the agent.
      */
     type: 'url';
     /**
@@ -13304,6 +13304,232 @@ export type TicketRepository = {
      */
     update_time: string;
 };
+/**
+ * Agent definition the session uses after the change; null when unchanged.
+ */
+export type AgentManaged40 = {
+    /**
+     * Agent id (agent_...). Pass it as agent when creating a session and as agent_id in agent calls.
+     */
+    id: string;
+    /**
+     * Always `agent`. A roster member that refers to an agent by id and pinned version.
+     */
+    type: 'agent';
+    /**
+     * The latest saved version of the agent, the editable head; it differs from active_version after a save with apply false. Starts at 1 and increments each time the agent is modified.
+     */
+    version: number;
+};
+export type AgentManaged41 = {
+    /**
+     * The advisor model id.
+     */
+    model: string;
+    /**
+     * Always `advisor`. An advisor whose model is consulted for advice in a separate thread (at most one per coordinator).
+     */
+    type: 'advisor';
+};
+export type AgentManaged45 = {
+    /**
+     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
+     */
+    enabled: boolean;
+    /**
+     * Name of the native tool this entry configures.
+     */
+    name: 'bash';
+    /**
+     * Permission policy for tool execution.
+     */
+    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
+    /**
+     * Always `bash`. Selects the bash tool, which runs shell commands in the session's machine.
+     */
+    type: 'bash';
+};
+export type AgentManaged46 = {
+    /**
+     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
+     */
+    enabled: boolean;
+    /**
+     * Name of the native tool this entry configures.
+     */
+    name: 'edit';
+    /**
+     * Permission policy for tool execution.
+     */
+    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
+    /**
+     * Always `edit`. Selects the edit tool, which changes an existing file.
+     */
+    type: 'edit';
+};
+export type AgentManaged47 = {
+    /**
+     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
+     */
+    enabled: boolean;
+    /**
+     * Name of the native tool this entry configures.
+     */
+    name: 'read';
+    /**
+     * Permission policy for tool execution.
+     */
+    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
+    /**
+     * Always `read`. Selects the read tool, which reads a file.
+     */
+    type: 'read';
+};
+export type AgentManaged48 = {
+    /**
+     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
+     */
+    enabled: boolean;
+    /**
+     * Name of the native tool this entry configures.
+     */
+    name: 'write';
+    /**
+     * Permission policy for tool execution.
+     */
+    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
+    /**
+     * Always `write`. Selects the write tool, which writes a file.
+     */
+    type: 'write';
+};
+export type AgentManaged49 = {
+    /**
+     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
+     */
+    enabled: boolean;
+    /**
+     * Name of the native tool this entry configures.
+     */
+    name: 'glob';
+    /**
+     * Permission policy for tool execution.
+     */
+    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
+    /**
+     * Always `glob`. Selects the glob tool, which finds files by name pattern.
+     */
+    type: 'glob';
+};
+export type AgentManaged50 = {
+    /**
+     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
+     */
+    enabled: boolean;
+    /**
+     * Name of the native tool this entry configures.
+     */
+    name: 'grep';
+    /**
+     * Permission policy for tool execution.
+     */
+    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
+    /**
+     * Always `grep`. Selects the grep tool, which searches file contents.
+     */
+    type: 'grep';
+};
+export type AgentManaged51 = {
+    /**
+     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
+     */
+    enabled: boolean;
+    /**
+     * Name of the native tool this entry configures.
+     */
+    name: 'web_fetch';
+    /**
+     * Permission policy for tool execution.
+     */
+    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
+    /**
+     * Always `web_fetch`. Selects the web_fetch tool, which fetches a web page.
+     */
+    type: 'web_fetch';
+    /**
+     * Hosts the tool may fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with blocked_domains.
+     */
+    allowed_domains?: Array<string>;
+    /**
+     * Hosts the tool must never fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with allowed_domains.
+     */
+    blocked_domains?: Array<string>;
+    /**
+     * Maximum number of tokens of fetched text content included in context per call; does not apply to binary content such as PDFs. Null for no explicit limit.
+     */
+    max_content_tokens?: null | number;
+};
+export type AgentManaged52 = {
+    /**
+     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
+     */
+    enabled: boolean;
+    /**
+     * Name of the native tool this entry configures.
+     */
+    name: 'web_search';
+    /**
+     * Permission policy for tool execution.
+     */
+    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
+    /**
+     * Always `web_search`. Selects the web_search tool, which searches the web.
+     */
+    type: 'web_search';
+    /**
+     * Hosts the tool may fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with blocked_domains.
+     */
+    allowed_domains?: Array<string>;
+    /**
+     * Hosts the tool must never fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with allowed_domains.
+     */
+    blocked_domains?: Array<string>;
+    /**
+     * Approximate user location for search result localization.
+     */
+    user_location?: null | AgentManaged27;
+};
+/**
+ * Settings applied to every tool of this toolset that configs does not name. When omitted, tools are enabled with the always_allow policy.
+ */
+export type AgentManaged53 = {
+    /**
+     * Whether tools of the toolset are offered to the model when configs does not name them. Null or omitted means enabled.
+     */
+    enabled: boolean;
+    /**
+     * Permission policy for tool execution.
+     */
+    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
+};
+/**
+ * JSON Schema of the custom tool's input object, passed to the model as the tool's parameters.
+ */
+export type AgentManaged33 = {
+    /**
+     * Always `object`. The input is a JSON object.
+     */
+    type: 'object';
+    /**
+     * JSON Schema of each input property, keyed by property name.
+     */
+    properties?: null | AgentManaged34;
+    /**
+     * Names of the input properties the model must supply.
+     */
+    required?: null | Array<string>;
+    [key: string]: unknown;
+};
 /**
  * File expiration policy
  *
@@ -17863,16 +18089,6 @@ export type SandboxError = {
      */
     message: string;
 };
-export type AgentManaged41 = {
-    /**
-     * The advisor model id.
-     */
-    model: string;
-    /**
-     * Always `advisor`. An advisor whose model is consulted for advice in a separate thread (at most one per coordinator).
-     */
-    type: 'advisor';
-};
 export type AgentManaged172 = {
     /**
      * Agent id (agent_...). Pass it as agent when creating a session and as agent_id in agent calls.
@@ -17915,205 +18131,6 @@ export type AgentManaged172 = {
      */
     version: number;
 };
-export type AgentManaged45 = {
-    /**
-     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-     */
-    enabled: boolean;
-    /**
-     * Name of the native tool this entry configures.
-     */
-    name: 'bash';
-    /**
-     * Permission policy for tool execution.
-     */
-    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
-    /**
-     * Always `bash`. Selects the bash tool, which runs shell commands in the session's machine.
-     */
-    type: 'bash';
-};
-export type AgentManaged46 = {
-    /**
-     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-     */
-    enabled: boolean;
-    /**
-     * Name of the native tool this entry configures.
-     */
-    name: 'edit';
-    /**
-     * Permission policy for tool execution.
-     */
-    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
-    /**
-     * Always `edit`. Selects the edit tool, which changes an existing file.
-     */
-    type: 'edit';
-};
-export type AgentManaged47 = {
-    /**
-     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-     */
-    enabled: boolean;
-    /**
-     * Name of the native tool this entry configures.
-     */
-    name: 'read';
-    /**
-     * Permission policy for tool execution.
-     */
-    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
-    /**
-     * Always `read`. Selects the read tool, which reads a file.
-     */
-    type: 'read';
-};
-export type AgentManaged48 = {
-    /**
-     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-     */
-    enabled: boolean;
-    /**
-     * Name of the native tool this entry configures.
-     */
-    name: 'write';
-    /**
-     * Permission policy for tool execution.
-     */
-    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
-    /**
-     * Always `write`. Selects the write tool, which writes a file.
-     */
-    type: 'write';
-};
-export type AgentManaged49 = {
-    /**
-     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-     */
-    enabled: boolean;
-    /**
-     * Name of the native tool this entry configures.
-     */
-    name: 'glob';
-    /**
-     * Permission policy for tool execution.
-     */
-    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
-    /**
-     * Always `glob`. Selects the glob tool, which finds files by name pattern.
-     */
-    type: 'glob';
-};
-export type AgentManaged50 = {
-    /**
-     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-     */
-    enabled: boolean;
-    /**
-     * Name of the native tool this entry configures.
-     */
-    name: 'grep';
-    /**
-     * Permission policy for tool execution.
-     */
-    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
-    /**
-     * Always `grep`. Selects the grep tool, which searches file contents.
-     */
-    type: 'grep';
-};
-export type AgentManaged51 = {
-    /**
-     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-     */
-    enabled: boolean;
-    /**
-     * Name of the native tool this entry configures.
-     */
-    name: 'web_fetch';
-    /**
-     * Permission policy for tool execution.
-     */
-    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
-    /**
-     * Always `web_fetch`. Selects the web_fetch tool, which fetches a web page.
-     */
-    type: 'web_fetch';
-    /**
-     * Hosts the tool may fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with blocked_domains.
-     */
-    allowed_domains?: Array<string>;
-    /**
-     * Hosts the tool must never fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with allowed_domains.
-     */
-    blocked_domains?: Array<string>;
-    /**
-     * Maximum number of tokens of fetched text content included in context per call; does not apply to binary content such as PDFs. Null for no explicit limit.
-     */
-    max_content_tokens?: null | number;
-};
-export type AgentManaged52 = {
-    /**
-     * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-     */
-    enabled: boolean;
-    /**
-     * Name of the native tool this entry configures.
-     */
-    name: 'web_search';
-    /**
-     * Permission policy for tool execution.
-     */
-    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
-    /**
-     * Always `web_search`. Selects the web_search tool, which searches the web.
-     */
-    type: 'web_search';
-    /**
-     * Hosts the tool may fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with blocked_domains.
-     */
-    allowed_domains?: Array<string>;
-    /**
-     * Hosts the tool must never fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with allowed_domains.
-     */
-    blocked_domains?: Array<string>;
-    /**
-     * Approximate user location for search result localization.
-     */
-    user_location?: null | AgentManaged27;
-};
-/**
- * Settings applied to every tool of this toolset that configs does not name. When omitted, tools are enabled with the always_allow policy.
- */
-export type AgentManaged53 = {
-    /**
-     * Whether tools of the toolset are offered to the model when configs does not name them. Null or omitted means enabled.
-     */
-    enabled: boolean;
-    /**
-     * Permission policy for tool execution.
-     */
-    permission_policy: AgentManaged17 | AgentManaged18 | AgentManaged19;
-};
-/**
- * JSON Schema of the custom tool's input object, passed to the model as the tool's parameters.
- */
-export type AgentManaged33 = {
-    /**
-     * Always `object`. The input is a JSON object.
-     */
-    type: 'object';
-    /**
-     * JSON Schema of each input property, keyed by property name.
-     */
-    properties?: null | AgentManaged34;
-    /**
-     * Names of the input properties the model must supply.
-     */
-    required?: null | Array<string>;
-    [key: string]: unknown;
-};
 /**
  * Largest list-price cost the session may reach, as {amount, currency}. amount is in US dollars with at most 2 decimals, not cents.
  */
@@ -18173,23 +18190,6 @@ export type AgentManaged181 = {
      */
     web_search_requests?: number;
 };
-/**
- * Agent definition the session uses after the change; null when unchanged.
- */
-export type AgentManaged40 = {
-    /**
-     * Agent id (agent_...). Pass it as agent when creating a session and as agent_id in agent calls.
-     */
-    id: string;
-    /**
-     * Always `agent`. A roster member that refers to an agent by id and pinned version.
-     */
-    type: 'agent';
-    /**
-     * The latest saved version of the agent, the editable head; it differs from active_version after a save with apply false. Starts at 1 and increments each time the agent is modified.
-     */
-    version: number;
-};
 export type AgentManaged11 = {
     /**
      * Reference to the agent being created or updated as a member of its own roster.
@@ -22175,6 +22175,49 @@ export type VaultVaultTemplate = {
      */
     value_hint: string | null;
 };
+export type AgentManaged17 = {
+    /**
+     * Permission policy that allows a tool call without confirmation, subject to the session permission mode and rules.
+     */
+    type: 'always_allow';
+};
+export type AgentManaged18 = {
+    /**
+     * Permission policy that requests confirmation before a tool call, subject to the session permission mode and rules.
+     */
+    type: 'always_ask';
+};
+export type AgentManaged19 = {
+    /**
+     * Always `auto`. Reserved: a server-side judgement per call. Not yet supported; sending it returns 400.
+     */
+    type: 'auto';
+};
+export type AgentManaged27 = {
+    /**
+     * Approximate user location for localizing web search results.
+     */
+    type: 'approximate';
+    /**
+     * City name.
+     */
+    city?: null | string;
+    /**
+     * Two-letter ISO 3166-1 country code, uppercase.
+     */
+    country?: null | string;
+    /**
+     * Region or state name.
+     */
+    region?: null | string;
+    /**
+     * IANA timezone identifier, e.g. "America/Los_Angeles".
+     */
+    timezone?: null | string;
+};
+export type AgentManaged34 = {
+    [key: string]: unknown;
+};
 export type OwnFileMisalignmentErrorDetailsResource = {
     /**
      * An optional classification; clients must accept additional values.
@@ -25832,49 +25875,6 @@ export type AnthropicServerToolUsage = {
  * Action taken when the sandbox times out.
  */
 export type SandboxSandboxOnTimeout = 'kill' | 'pause';
-export type AgentManaged17 = {
-    /**
-     * Permission policy that allows a tool call without confirmation, subject to the session permission mode and rules.
-     */
-    type: 'always_allow';
-};
-export type AgentManaged18 = {
-    /**
-     * Permission policy that requests confirmation before a tool call, subject to the session permission mode and rules.
-     */
-    type: 'always_ask';
-};
-export type AgentManaged19 = {
-    /**
-     * Always `auto`. Reserved: a server-side judgement per call. Not yet supported; sending it returns 400.
-     */
-    type: 'auto';
-};
-export type AgentManaged27 = {
-    /**
-     * Approximate user location for localizing web search results.
-     */
-    type: 'approximate';
-    /**
-     * City name.
-     */
-    city?: null | string;
-    /**
-     * Two-letter ISO 3166-1 country code, uppercase.
-     */
-    country?: null | string;
-    /**
-     * Region or state name.
-     */
-    region?: null | string;
-    /**
-     * IANA timezone identifier, e.g. "America/Los_Angeles".
-     */
-    timezone?: null | string;
-};
-export type AgentManaged34 = {
-    [key: string]: unknown;
-};
 export type AgentManaged213 = {
     /**
      * Always `retrying`. The server retries automatically.
@@ -27070,6 +27070,12 @@ export type PraxisSdkSseGetAutomationV1RunsIdLogs = ({
         [key: string]: unknown;
     };
 };
+/**
+ * Free-form string key/value pairs stored with the agent for your own bookkeeping.
+ */
+export type AgentManaged37Writable = {
+    [key: string]: string;
+};
 /**
  * Models to use for completion
  */
@@ -27083,12 +27089,6 @@ export type AgentManaged173Writable = {
 export type AgentManaged183Writable = {
     [key: string]: null | string;
 };
-/**
- * Free-form string key/value pairs stored with the agent for your own bookkeeping.
- */
-export type AgentManaged37Writable = {
-    [key: string]: string;
-};
 /**
  * Free-form string key/value pairs.
  */
@@ -27325,7 +27325,7 @@ export type ApplyAgentVersionErrors = {
 export type ApplyAgentVersionError = ApplyAgentVersionErrors[keyof ApplyAgentVersionErrors];
 export type ApplyAgentVersionResponses = {
     /**
-     * Latest saved agent with the selected active_version; no new version was created.
+     * Effective agent configuration and newest saved version number; no new version was created.
      */
     200: {
         /**
@@ -27345,88 +27345,10 @@ export type ApplyAgentVersionResponses = {
          */
         description: null | string;
         /**
-         * 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<{
-            /**
-             * Streamable HTTP transport.
-             */
-            type: 'url';
-            /**
-             * 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;
-        } | {
-            /**
-             * 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;
-        }>;
-        /**
-         * Free-form string key/value pairs stored with the agent for your own bookkeeping.
+         * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
          */
-        metadata: {
-            [key: string]: string;
-        };
+        mcp_servers: Array<AgentManaged36>;
+        metadata: AgentManaged37;
         /**
          * Model identifier and configuration.
          */
@@ -27439,32 +27361,7 @@ export type ApplyAgentVersionResponses = {
              * How hard Claude works on each turn. Sets `output_config.effort` on every
              * Messages call the session makes.
              */
-            effort?: {
-                /**
-                 * Always `low`. Lowest reasoning effort of the supported levels.
-                 */
-                type: 'low';
-            } | {
-                /**
-                 * Always `medium`. Middle reasoning effort.
-                 */
-                type: 'medium';
-            } | {
-                /**
-                 * Always `high`. High reasoning effort.
-                 */
-                type: 'high';
-            } | {
-                /**
-                 * Always `xhigh`. Extra-high reasoning effort, above high; only models that list it in thinking.efforts accept it.
-                 */
-                type: 'xhigh';
-            } | {
-                /**
-                 * Always `max`. Maximum effort level of the Managed Agents shape, above xhigh.
-                 */
-                type: 'max';
-            };
+            effort?: AgentManaged2 | AgentManaged3 | AgentManaged4 | AgentManaged5 | AgentManaged6;
             /**
              * Geographic region for model inference. When unset, requests fall through to the
              * workspace's default_inference_geo.
@@ -27487,41 +27384,9 @@ export type ApplyAgentVersionResponses = {
             };
         };
         /**
-         * Resolved coordinator topology with a concrete agent roster.
+         * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
-        multiagent: null | {
-            /**
-             * Agents the coordinator may spawn as session threads, each resolved to a specific
-             * version.
-             */
-            agents: Array<{
-                /**
-                 * Agent id (agent_...). Pass it as agent when creating a session and as agent_id in agent calls.
-                 */
-                id: string;
-                /**
-                 * Always `agent`. A roster member that refers to an agent by id and pinned version.
-                 */
-                type: 'agent';
-                /**
-                 * The latest saved version of the agent, the editable head; it differs from active_version after a save with apply false. Starts at 1 and increments each time the agent is modified.
-                 */
-                version: number;
-            } | {
-                /**
-                 * The advisor model id.
-                 */
-                model: string;
-                /**
-                 * Always `advisor`. An advisor whose model is consulted for advice in a separate thread (at most one per coordinator).
-                 */
-                type: 'advisor';
-            }>;
-            /**
-             * Always `coordinator`. The agent coordinates the roster in agents and can delegate to its members.
-             */
-            type: 'coordinator';
-        };
+        multiagent: null | AgentManaged39;
         /**
          * Display name of the agent, as set on create or update. It is a label, not a unique key.
          */
@@ -27529,33 +27394,7 @@ export type ApplyAgentVersionResponses = {
         /**
          * Custom skills attached to the agent, each {type: "custom", skill_id, version?}: skill_id comes from skills.create or skills.list, at most 20 skills, no repeated skill_id. Omit version, or send "latest", to use the skill's newest version at the moment a session starts; a pinned version stays fixed. type anthropic returns 400: upload the skill and attach it as custom. On update, omit the field to keep the list, send an array to replace it, or send [] or null to clear it.
          */
-        skills: Array<{
-            /**
-             * Id of the skill to attach.
-             */
-            skill_id: string;
-            /**
-             * Always `anthropic`. A skill provided by Anthropic, identified by skill_id.
-             */
-            type: 'anthropic';
-            /**
-             * Version of the skill: omit or `latest` to follow the newest version at each new session; give a version id to pin it.
-             */
-            version: string;
-        } | {
-            /**
-             * Id of the skill to attach.
-             */
-            skill_id: string;
-            /**
-             * Always `custom`. A skill created by you, identified by skill_id.
-             */
-            type: 'custom';
-            /**
-             * Version of the skill: omit or `latest` to follow the newest version at each new session; give a version id to pin it.
-             */
-            version: string;
-        }>;
+        skills: Array<AgentManaged42 | AgentManaged43>;
         /**
          * System prompt given to the model at the start of every session of this agent; null when none was set.
          */
@@ -27563,445 +27402,7 @@ export type ApplyAgentVersionResponses = {
         /**
          * 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<{
-            /**
-             * Per-tool settings that override default_config. Tools that are not listed follow default_config.
-             */
-            configs: Array<{
-                /**
-                 * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-                 */
-                enabled: boolean;
-                /**
-                 * Name of the native tool this entry configures.
-                 */
-                name: 'bash';
-                /**
-                 * Permission policy for tool execution.
-                 */
-                permission_policy: {
-                    /**
-                     * Always `always_allow`. Calls run without asking.
-                     */
-                    type: 'always_allow';
-                } | {
-                    /**
-                     * Always `always_ask`. Calls wait for user.tool_confirmation before running.
-                     */
-                    type: 'always_ask';
-                } | {
-                    /**
-                     * Always `auto`. Reserved: a server-side judgement per call. Not yet supported; sending it returns 400.
-                     */
-                    type: 'auto';
-                };
-                /**
-                 * Always `bash`. Selects the bash tool, which runs shell commands in the session's machine.
-                 */
-                type: 'bash';
-            } | {
-                /**
-                 * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-                 */
-                enabled: boolean;
-                /**
-                 * Name of the native tool this entry configures.
-                 */
-                name: 'edit';
-                /**
-                 * Permission policy for tool execution.
-                 */
-                permission_policy: {
-                    /**
-                     * Always `always_allow`. Calls run without asking.
-                     */
-                    type: 'always_allow';
-                } | {
-                    /**
-                     * Always `always_ask`. Calls wait for user.tool_confirmation before running.
-                     */
-                    type: 'always_ask';
-                } | {
-                    /**
-                     * Always `auto`. Reserved: a server-side judgement per call. Not yet supported; sending it returns 400.
-                     */
-                    type: 'auto';
-                };
-                /**
-                 * Always `edit`. Selects the edit tool, which changes an existing file.
-                 */
-                type: 'edit';
-            } | {
-                /**
-                 * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-                 */
-                enabled: boolean;
-                /**
-                 * Name of the native tool this entry configures.
-                 */
-                name: 'read';
-                /**
-                 * Permission policy for tool execution.
-                 */
-                permission_policy: {
-                    /**
-                     * Always `always_allow`. Calls run without asking.
-                     */
-                    type: 'always_allow';
-                } | {
-                    /**
-                     * Always `always_ask`. Calls wait for user.tool_confirmation before running.
-                     */
-                    type: 'always_ask';
-                } | {
-                    /**
-                     * Always `auto`. Reserved: a server-side judgement per call. Not yet supported; sending it returns 400.
-                     */
-                    type: 'auto';
-                };
-                /**
-                 * Always `read`. Selects the read tool, which reads a file.
-                 */
-                type: 'read';
-            } | {
-                /**
-                 * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-                 */
-                enabled: boolean;
-                /**
-                 * Name of the native tool this entry configures.
-                 */
-                name: 'write';
-                /**
-                 * Permission policy for tool execution.
-                 */
-                permission_policy: {
-                    /**
-                     * Always `always_allow`. Calls run without asking.
-                     */
-                    type: 'always_allow';
-                } | {
-                    /**
-                     * Always `always_ask`. Calls wait for user.tool_confirmation before running.
-                     */
-                    type: 'always_ask';
-                } | {
-                    /**
-                     * Always `auto`. Reserved: a server-side judgement per call. Not yet supported; sending it returns 400.
-                     */
-                    type: 'auto';
-                };
-                /**
-                 * Always `write`. Selects the write tool, which writes a file.
-                 */
-                type: 'write';
-            } | {
-                /**
-                 * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-                 */
-                enabled: boolean;
-                /**
-                 * Name of the native tool this entry configures.
-                 */
-                name: 'glob';
-                /**
-                 * Permission policy for tool execution.
-                 */
-                permission_policy: {
-                    /**
-                     * Always `always_allow`. Calls run without asking.
-                     */
-                    type: 'always_allow';
-                } | {
-                    /**
-                     * Always `always_ask`. Calls wait for user.tool_confirmation before running.
-                     */
-                    type: 'always_ask';
-                } | {
-                    /**
-                     * Always `auto`. Reserved: a server-side judgement per call. Not yet supported; sending it returns 400.
-                     */
-                    type: 'auto';
-                };
-                /**
-                 * Always `glob`. Selects the glob tool, which finds files by name pattern.
-                 */
-                type: 'glob';
-            } | {
-                /**
-                 * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-                 */
-                enabled: boolean;
-                /**
-                 * Name of the native tool this entry configures.
-                 */
-                name: 'grep';
-                /**
-                 * Permission policy for tool execution.
-                 */
-                permission_policy: {
-                    /**
-                     * Always `always_allow`. Calls run without asking.
-                     */
-                    type: 'always_allow';
-                } | {
-                    /**
-                     * Always `always_ask`. Calls wait for user.tool_confirmation before running.
-                     */
-                    type: 'always_ask';
-                } | {
-                    /**
-                     * Always `auto`. Reserved: a server-side judgement per call. Not yet supported; sending it returns 400.
-                     */
-                    type: 'auto';
-                };
-                /**
-                 * Always `grep`. Selects the grep tool, which searches file contents.
-                 */
-                type: 'grep';
-            } | {
-                /**
-                 * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-                 */
-                enabled: boolean;
-                /**
-                 * Name of the native tool this entry configures.
-                 */
-                name: 'web_fetch';
-                /**
-                 * Permission policy for tool execution.
-                 */
-                permission_policy: {
-                    /**
-                     * Always `always_allow`. Calls run without asking.
-                     */
-                    type: 'always_allow';
-                } | {
-                    /**
-                     * Always `always_ask`. Calls wait for user.tool_confirmation before running.
-                     */
-                    type: 'always_ask';
-                } | {
-                    /**
-                     * Always `auto`. Reserved: a server-side judgement per call. Not yet supported; sending it returns 400.
-                     */
-                    type: 'auto';
-                };
-                /**
-                 * Always `web_fetch`. Selects the web_fetch tool, which fetches a web page.
-                 */
-                type: 'web_fetch';
-                /**
-                 * Hosts the tool may fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with blocked_domains.
-                 */
-                allowed_domains?: Array<string>;
-                /**
-                 * Hosts the tool must never fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with allowed_domains.
-                 */
-                blocked_domains?: Array<string>;
-                /**
-                 * Maximum number of tokens of fetched text content included in context per call; does not apply to binary content such as PDFs. Null for no explicit limit.
-                 */
-                max_content_tokens?: null | number;
-            } | {
-                /**
-                 * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-                 */
-                enabled: boolean;
-                /**
-                 * Name of the native tool this entry configures.
-                 */
-                name: 'web_search';
-                /**
-                 * Permission policy for tool execution.
-                 */
-                permission_policy: {
-                    /**
-                     * Always `always_allow`. Calls run without asking.
-                     */
-                    type: 'always_allow';
-                } | {
-                    /**
-                     * Always `always_ask`. Calls wait for user.tool_confirmation before running.
-                     */
-                    type: 'always_ask';
-                } | {
-                    /**
-                     * Always `auto`. Reserved: a server-side judgement per call. Not yet supported; sending it returns 400.
-                     */
-                    type: 'auto';
-                };
-                /**
-                 * Always `web_search`. Selects the web_search tool, which searches the web.
-                 */
-                type: 'web_search';
-                /**
-                 * Hosts the tool may fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with blocked_domains.
-                 */
-                allowed_domains?: Array<string>;
-                /**
-                 * Hosts the tool must never fetch or search, as plain hostnames (no scheme, port or path); a listed domain also covers its subdomains. At most 64 entries, and it cannot be combined with allowed_domains.
-                 */
-                blocked_domains?: Array<string>;
-                /**
-                 * Approximate user location for search result localization.
-                 */
-                user_location?: null | {
-                    /**
-                     * Location precision. Only "approximate" is supported.
-                     */
-                    type: 'approximate';
-                    /**
-                     * City name.
-                     */
-                    city?: null | string;
-                    /**
-                     * Two-letter ISO 3166-1 country code, uppercase.
-                     */
-                    country?: null | string;
-                    /**
-                     * Region or state name.
-                     */
-                    region?: null | string;
-                    /**
-                     * IANA timezone identifier, e.g. "America/Los_Angeles".
-                     */
-                    timezone?: null | string;
-                };
-            } | {
-                /**
-                 * Name of the native tool this entry configures.
-                 */
-                name: 'task_output' | 'task_stop' | 'monitor' | 'agent' | 'send_message' | 'codemode' | 'skill';
-                /**
-                 * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-                 */
-                enabled: boolean;
-                /**
-                 * Whether a call to this tool runs automatically (always_allow) or waits for user.tool_confirmation (always_ask). Omitted means the toolset default.
-                 */
-                permission_policy: {
-                    /**
-                     * Permission policy kind.
-                     */
-                    type: 'always_allow' | 'always_ask';
-                };
-            }>;
-            /**
-             * Resolved default configuration for agent tools.
-             */
-            default_config: {
-                /**
-                 * Whether tools of the toolset are offered to the model when configs does not name them. Null or omitted means enabled.
-                 */
-                enabled: boolean;
-                /**
-                 * Permission policy for tool execution.
-                 */
-                permission_policy: {
-                    /**
-                     * Always `always_allow`. Calls run without asking.
-                     */
-                    type: 'always_allow';
-                } | {
-                    /**
-                     * Always `always_ask`. Calls wait for user.tool_confirmation before running.
-                     */
-                    type: 'always_ask';
-                } | {
-                    /**
-                     * Always `auto`. Reserved: a server-side judgement per call. Not yet supported; sending it returns 400.
-                     */
-                    type: 'auto';
-                };
-            };
-            /**
-             * Always `agent_toolset_20260401`. The native toolset entry (bash, edit, glob, grep, read, write, web_search, web_fetch, task_output, task_stop, monitor, agent, send_message).
-             */
-            type: 'agent_toolset_20260401';
-        } | {
-            /**
-             * Always `mcp_toolset`. An entry that exposes the tools of one MCP server from mcp_servers.
-             */
-            type: 'mcp_toolset';
-            /**
-             * Name of the MCP server in mcp_servers whose tools this entry exposes.
-             */
-            mcp_server_name: string;
-            /**
-             * Settings applied to every tool of this toolset that configs does not name. When omitted, tools are enabled with the always_allow policy.
-             */
-            default_config?: {
-                /**
-                 * Whether tools of the toolset are offered to the model when configs does not name them. Null or omitted means enabled.
-                 */
-                enabled?: boolean | null;
-                /**
-                 * Permission policy for tools that configs does not name: always_allow runs calls automatically, always_ask waits for user.tool_confirmation.
-                 */
-                permission_policy?: null | {
-                    /**
-                     * Permission policy kind.
-                     */
-                    type: 'always_allow' | 'always_ask';
-                };
-            } | null;
-            /**
-             * Per-tool settings that override default_config. Tools that are not listed follow default_config.
-             */
-            configs?: Array<{
-                /**
-                 * Bare tool name reported by the MCP server.
-                 */
-                name: string;
-                /**
-                 * Whether the tool is offered to the model. Null or omitted means the toolset default applies (enabled unless default_config says otherwise).
-                 */
-                enabled?: boolean | null;
-                /**
-                 * Whether a call to this tool runs automatically (always_allow) or waits for user.tool_confirmation (always_ask). Omitted means the toolset default.
-                 */
-                permission_policy?: null | {
-                    /**
-                     * Permission policy kind.
-                     */
-                    type: 'always_allow' | 'always_ask';
-                };
-            }> | null;
-        } | {
-            /**
-             * What the custom tool does and when the model should call it.
-             */
-            description: string;
-            /**
-             * JSON Schema for custom tool input parameters.
-             */
-            input_schema: {
-                /**
-                 * Always `object`. The input is a JSON object.
-                 */
-                type: 'object';
-                /**
-                 * JSON Schema of each input property, keyed by property name.
-                 */
-                properties?: null | {
-                    [key: string]: unknown;
-                };
-                /**
-                 * Names of the input properties the model must supply.
-                 */
-                required?: null | Array<string>;
-                [key: string]: unknown;
-            };
-            /**
-             * Name of the custom tool, as the model sees and calls it.
-             */
-            name: string;
-            /**
-             * Always `custom`. A custom tool defined by name, description and input_schema; its calls are answered by the client with user.custom_tool_result.
-             */
-            type: 'custom';
-        }>;
+        tools: Array<AgentManaged44 | AgentManaged54 | AgentManaged57>;
         /**
          * Always `agent`. An agent definition.
          */
@@ -28011,12 +27412,15 @@ export type ApplyAgentVersionResponses = {
          */
         updated_at: string;
         /**
-         * The agent's current version. Starts at 1 and increments when the agent is
-         * modified.
+         * Version of this returned configuration. Default retrieve returns the effective version; an explicit version query or a version-history item returns that saved version.
          */
         version: number;
         /**
-         * Version used by new sessions and newly issued embed tokens when no version is specified. Starts at 1; saving with apply false leaves it unchanged. Existing sessions and tokens keep their version.
+         * Newest saved version number, including an unapplied save. Returned by default retrieve, update and apply; use it for optimistic concurrency when updating.
+         */
+        latest_version?: number;
+        /**
+         * Agent-level currently effective version used by new sessions and newly issued embed tokens. This same value appears on every history item; it is not that item's version. Saving with apply false leaves it unchanged. Existing sessions and tokens retain their version.
          */
         active_version: number;
         /**
@@ -29787,557 +29191,6 @@ 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;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * Agent or requested user is unavailable to this caller, or the caller is an end user.
-     */
-    404: unknown;
-};
-export type ListEndUsersError = ListEndUsersErrors[keyof ListEndUsersErrors];
-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 cost of this customer's sessions on this agent: model usage (threads included) plus session runtime; amount "0.000000" when nothing has been recorded.
-             */
-            cost: {
-                /**
-                 * Amount in US dollars, as a decimal string with exactly 6 decimals and no exponent, e.g. "0.000345" or "12.500000".
-                 */
-                amount: string;
-                /**
-                 * Always USD.
-                 */
-                currency: 'USD';
-            };
-            /**
-             * 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;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * Agent or requested user is unavailable to this caller, or the caller is an end user.
-     */
-    404: unknown;
-};
-export type DeleteEndUserError = DeleteEndUserErrors[keyof DeleteEndUserErrors];
-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;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * Agent or requested user is unavailable to this caller, or the caller is an end user.
-     */
-    404: unknown;
-};
-export type GetEndUserError = GetEndUserErrors[keyof GetEndUserErrors];
-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 cost of this customer's sessions on this agent: model usage (threads included) plus session runtime; amount "0.000000" when nothing has been recorded.
-         */
-        cost: {
-            /**
-             * Amount in US dollars, as a decimal string with exactly 6 decimals and no exponent, e.g. "0.000345" or "12.500000".
-             */
-            amount: string;
-            /**
-             * Always USD.
-             */
-            currency: 'USD';
-        };
-        /**
-         * 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;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * Agent or requested user is unavailable to this caller, or the caller is an end user.
-     */
-    404: unknown;
-};
-export type GetEndUserDeletionError = GetEndUserDeletionErrors[keyof GetEndUserDeletionErrors];
-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;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * 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 RevokeEndUserTokensError = RevokeEndUserTokensErrors[keyof RevokeEndUserTokensErrors];
-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;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * 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 BlockEndUserError = BlockEndUserErrors[keyof BlockEndUserErrors];
-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 cost of this customer's sessions on this agent: model usage (threads included) plus session runtime; amount "0.000000" when nothing has been recorded.
-         */
-        cost: {
-            /**
-             * Amount in US dollars, as a decimal string with exactly 6 decimals and no exponent, e.g. "0.000345" or "12.500000".
-             */
-            amount: string;
-            /**
-             * Always USD.
-             */
-            currency: 'USD';
-        };
-        /**
-         * 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;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * 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 UnblockEndUserError = UnblockEndUserErrors[keyof UnblockEndUserErrors];
-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 cost of this customer's sessions on this agent: model usage (threads included) plus session runtime; amount "0.000000" when nothing has been recorded.
-         */
-        cost: {
-            /**
-             * Amount in US dollars, as a decimal string with exactly 6 decimals and no exponent, e.g. "0.000345" or "12.500000".
-             */
-            amount: string;
-            /**
-             * Always USD.
-             */
-            currency: 'USD';
-        };
-        /**
-         * Whether the embed policy currently prevents this user from receiving tokens and creating sessions.
-         */
-        blocked: boolean;
-    };
-};
-export type UnblockEndUserResponse = UnblockEndUserResponses[keyof UnblockEndUserResponses];
 export type ListCustomersData = {
     body?: never;
     path: {
@@ -31456,439 +30309,6 @@ export type DeleteCurrentCustomerAccessTokenResponses = {
     204: void;
 };
 export type DeleteCurrentCustomerAccessTokenResponse = DeleteCurrentCustomerAccessTokenResponses[keyof DeleteCurrentCustomerAccessTokenResponses];
-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;
-    /**
-     * UNAUTHENTICATED (or INVALID_API_KEY, API_KEY_DISABLED, API_KEY_EXPIRED, INVALID_API_TOKEN, API_TOKEN_EXPIRED, API_TOKEN_REVOKED): the API key is missing, invalid or revoked. Send a valid key as X-API-Key or as a Bearer token.
-     */
-    401: AgentError;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * 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 ExchangeEmbedCodeError = ExchangeEmbedCodeErrors[keyof ExchangeEmbedCodeErrors];
-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;
-    query?: {
-        /**
-         * Filter by service agent identifier (agent_ or agt_ prefix).
-         */
-        agent_id?: string;
-        /**
-         * Exact host user identifier supplied at issuance.
-         */
-        external_user_id?: string;
-        /**
-         * Maximum records per page; defaults to 20.
-         */
-        limit?: number;
-        /**
-         * next_page from a previous response with the same filters.
-         */
-        page?: string;
-    };
-    url: '/agent/v1/embed_tokens';
-};
-export type ListEmbedTokensErrors = {
-    /**
-     * Invalid filter, limit or cursor; reuse the cursor with its original filters.
-     */
-    400: unknown;
-    /**
-     * Authenticate with a host credential.
-     */
-    401: unknown;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * The grant is missing or belongs to another organization, or the caller is an end user.
-     */
-    404: unknown;
-    /**
-     * Upstream revocation failed; the record remains unrevoked and the request may be retried.
-     */
-    502: unknown;
-};
-export type ListEmbedTokensError = ListEmbedTokensErrors[keyof ListEmbedTokensErrors];
-export type ListEmbedTokensResponses = {
-    /**
-     * Issuance records and next page cursor.
-     */
-    200: {
-        /**
-         * Items of this page, in the order requested by the call.
-         */
-        data: Array<{
-            /**
-             * Grant identifier returned by embed token creation.
-             */
-            id: string;
-            /**
-             * Toolset type id as used in an agent's tools entry, for example agent_toolset_20260401.
-             */
-            type: 'embed_token';
-            /**
-             * Service agent identifier.
-             */
-            agent_id: string;
-            /**
-             * Pinned agent version.
-             */
-            agent_version: number;
-            /**
-             * Exact host user identifier supplied at issuance.
-             */
-            external_user_id: string;
-            /**
-             * Issuance time in RFC 3339 format.
-             */
-            created_at: string;
-            /**
-             * Expiration time in RFC 3339 format.
-             */
-            expires_at: string;
-            /**
-             * Revocation time in RFC 3339 format, or null while not revoked.
-             */
-            revoked_at: string | null;
-            /**
-             * Host origin recorded at issuance, or null when absent.
-             */
-            host_origin: string | null;
-            /**
-             * User or API key that issued the token.
-             */
-            issued_by: {
-                /**
-                 * user identifies a signed-in organization member; api_key identifies the issuing API key.
-                 */
-                type: 'user' | 'api_key';
-                /**
-                 * Identifier of the object, as returned by the API; pass it in the path of follow-up calls on the same resource.
-                 */
-                id: string;
-            };
-        }>;
-        /**
-         * Cursor for the next page using the same filters, or null when exhausted.
-         */
-        next_page: string | null;
-    };
-};
-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.
-         */
-        agent: string;
-        /**
-         * Existing agent version to pin. Omit to pin the latest version at issuance.
-         */
-        version?: number;
-        /**
-         * Your application's stable end-user identifier, scoped to this organization and agent.
-         */
-        external_user_id: string;
-        /**
-         * Token lifetime in seconds. Defaults to the embed policy TTL and cannot exceed its maximum or 3600 seconds.
-         */
-        ttl_seconds?: number;
-        /**
-         * Session budget in cents. Defaults to the embed policy session budget and cannot exceed its maximum.
-         */
-        budget_cents?: number;
-        /**
-         * Optional host context as text blocks, limited to 8192 UTF-8 bytes in total.
-         */
-        system_message?: Array<{
-            /**
-             * The text block kind; text is the only supported kind.
-             */
-            type: 'text';
-            /**
-             * Host context text. All blocks together must fit within 8192 UTF-8 bytes.
-             */
-            text: string;
-        }>;
-        /**
-         * Optional system prompt override, accepted only when the embed policy allows agent overrides.
-         */
-        agent_override?: {
-            /**
-             * Replacement system prompt, or null to clear it for this grant.
-             */
-            system: string | null;
-        };
-        /**
-         * Optional subset of the policy origin entries, compared exactly. Omit to snapshot every policy origin.
-         */
-        allowed_origins?: Array<string>;
-        /**
-         * Host metadata preserved verbatim; at most 16 keys of 1–64 characters and string values of at most 512 characters. Defaults to an empty object.
-         */
-        metadata?: {
-            [key: string]: string;
-        };
-    };
-    path?: never;
-    query?: never;
-    url: '/agent/v1/embed_tokens';
-};
-export type CreateEmbedTokenErrors = {
-    /**
-     * 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;
-    /**
-     * A valid host credential is required; authenticate with your backend API key.
-     */
-    401: unknown;
-    /**
-     * The end user is blocked by the embed policy; contact the agent owner.
-     */
-    403: unknown;
-    /**
-     * The service agent or requested version is unavailable to this caller; check the agent identifier and version.
-     */
-    404: unknown;
-    /**
-     * Token issuance is unavailable; no usable credential was returned.
-     */
-    502: unknown;
-};
-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.
-         */
-        id: string;
-        /**
-         * Short-lived end-user credential to pass to your frontend; keep the host API key on your backend.
-         */
-        token: string;
-        /**
-         * Token expiration as an ISO 8601 UTC timestamp, as issued by identity.
-         */
-        expires_at: string;
-    };
-};
-export type CreateEmbedTokenResponse = CreateEmbedTokenResponses[keyof CreateEmbedTokenResponses];
-export type RevokeEmbedTokenData = {
-    body?: never;
-    path: {
-        /**
-         * Grant id returned by issuance or listing.
-         */
-        id: string;
-    };
-    query?: never;
-    url: '/agent/v1/embed_tokens/{id}/revoke';
-};
-export type RevokeEmbedTokenErrors = {
-    /**
-     * Invalid filter, limit or cursor; reuse the cursor with its original filters.
-     */
-    400: unknown;
-    /**
-     * Authenticate with a host credential.
-     */
-    401: unknown;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * The grant is missing or belongs to another organization, or the caller is an end user.
-     */
-    404: unknown;
-    /**
-     * Upstream revocation failed; the record remains unrevoked and the request may be retried.
-     */
-    502: unknown;
-};
-export type RevokeEmbedTokenError = RevokeEmbedTokenErrors[keyof RevokeEmbedTokenErrors];
-export type RevokeEmbedTokenResponses = {
-    /**
-     * Revoked issuance record, including its original revocation time on repeated calls.
-     */
-    200: {
-        /**
-         * Grant identifier returned by embed token creation.
-         */
-        id: string;
-        /**
-         * Type tag of the object.
-         */
-        type: 'embed_token';
-        /**
-         * Service agent identifier.
-         */
-        agent_id: string;
-        /**
-         * Pinned agent version.
-         */
-        agent_version: number;
-        /**
-         * Exact host user identifier supplied at issuance.
-         */
-        external_user_id: string;
-        /**
-         * Issuance time in RFC 3339 format.
-         */
-        created_at: string;
-        /**
-         * Expiration time in RFC 3339 format.
-         */
-        expires_at: string;
-        /**
-         * Revocation time in RFC 3339 format, or null while not revoked.
-         */
-        revoked_at: string | null;
-        /**
-         * Host origin recorded at issuance, or null when absent.
-         */
-        host_origin: string | null;
-        /**
-         * User or API key that issued the token.
-         */
-        issued_by: {
-            /**
-             * user identifies a signed-in organization member; api_key identifies the issuing API key.
-             */
-            type: 'user' | 'api_key';
-            /**
-             * Identifier of the object, as returned by the API; pass it in the path of follow-up calls on the same resource.
-             */
-            id: string;
-        };
-    };
-};
-export type RevokeEmbedTokenResponse = RevokeEmbedTokenResponses[keyof RevokeEmbedTokenResponses];
 export type ComputersListData = {
     body?: never;
     path?: never;
@@ -37444,228 +35864,70 @@ export type CompactSessionErrors = {
      */
     503: unknown;
 };
-export type CompactSessionError = CompactSessionErrors[keyof CompactSessionErrors];
-export type CompactSessionResponses = {
-    /**
-     * Skipped, succeeded or failed compaction
-     */
-    200: {
-        /**
-         * Always `session_compaction`. Result of a compaction request.
-         */
-        type: 'session_compaction';
-        /**
-         * Compaction operation id; pass it as operation_id to sessions.compact.retrieve.
-         */
-        id: string;
-        /**
-         * State of the compaction operation: queued and running are in progress, skipped means nothing needed compaction, succeeded and failed are final.
-         */
-        status: 'queued' | 'running' | 'skipped' | 'succeeded' | 'failed';
-        /**
-         * Why the compaction was skipped or failed; absent otherwise.
-         */
-        reason?: string;
-    };
-    /**
-     * Queued or running compaction
-     */
-    202: {
-        /**
-         * Always `session_compaction`. Result of a compaction request.
-         */
-        type: 'session_compaction';
-        /**
-         * Compaction operation id; pass it as operation_id to sessions.compact.retrieve.
-         */
-        id: string;
-        /**
-         * State of the compaction operation: queued and running are in progress, skipped means nothing needed compaction, succeeded and failed are final.
-         */
-        status: 'queued' | 'running' | 'skipped' | 'succeeded' | 'failed';
-        /**
-         * Why the compaction was skipped or failed; absent otherwise.
-         */
-        reason?: string;
-    };
-};
-export type CompactSessionResponse = CompactSessionResponses[keyof CompactSessionResponses];
-export type GetSessionCompactionData = {
-    body?: never;
-    path: {
-        /**
-         * Session id (sesn_...), as returned by sessions.create or sessions.list. The same id is also accepted as the session_id query parameter on resource and thread calls, where it must equal the path value.
-         */
-        session_id: string;
-        /**
-         * Compaction operation id returned by sessions.compact in the id field of the session_compaction object.
-         */
-        operation_id: string;
-    };
-    query?: never;
-    url: '/agent/v1/sessions/{session_id}/compact/{operation_id}';
-};
-export type GetSessionCompactionErrors = {
-    /**
-     * Authentication required
-     */
-    401: unknown;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * Session or compaction operation not found
-     */
-    404: unknown;
-    /**
-     * Agent service failed
-     */
-    502: unknown;
-    /**
-     * Agent service unavailable
-     */
-    503: unknown;
-};
-export type GetSessionCompactionError = GetSessionCompactionErrors[keyof GetSessionCompactionErrors];
-export type GetSessionCompactionResponses = {
-    /**
-     * Compaction operation
-     */
-    200: {
-        /**
-         * Always `session_compaction`. Result of a compaction request.
-         */
-        type: 'session_compaction';
-        /**
-         * Compaction operation id; pass it as operation_id to sessions.compact.retrieve.
-         */
-        id: string;
-        /**
-         * State of the compaction operation: queued and running are in progress, skipped means nothing needed compaction, succeeded and failed are final.
-         */
-        status: 'queued' | 'running' | 'skipped' | 'succeeded' | 'failed';
-        /**
-         * Why the compaction was skipped or failed; absent otherwise.
-         */
-        reason?: string;
-    };
-};
-export type GetSessionCompactionResponse = GetSessionCompactionResponses[keyof GetSessionCompactionResponses];
-export type ListSessionCompactionsData = {
-    body?: never;
-    path: {
-        /**
-         * Session id (sesn_...), as returned by sessions.create or sessions.list. The same id is also accepted as the session_id query parameter on resource and thread calls, where it must equal the path value.
-         */
-        session_id: string;
-    };
-    query?: never;
-    url: '/agent/v1/sessions/{session_id}/compactions';
-};
-export type ListSessionCompactionsErrors = {
-    /**
-     * Authentication required
-     */
-    401: unknown;
-    /**
-     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
-     */
-    403: AgentError;
-    /**
-     * Session not found
-     */
-    404: unknown;
-    /**
-     * Agent service failed
-     */
-    502: unknown;
-    /**
-     * Agent service unavailable
-     */
-    503: unknown;
-};
-export type ListSessionCompactionsError = ListSessionCompactionsErrors[keyof ListSessionCompactionsErrors];
-export type ListSessionCompactionsResponses = {
+export type CompactSessionError = CompactSessionErrors[keyof CompactSessionErrors];
+export type CompactSessionResponses = {
     /**
-     * Compaction history
+     * Skipped, succeeded or failed compaction
      */
     200: {
         /**
-         * Items of this page, in the order requested by the call.
+         * Always `session_compaction`. Result of a compaction request.
          */
-        data: Array<{
-            /**
-             * Always `context_compaction`. Record of one past compaction.
-             */
-            type: 'context_compaction';
-            /**
-             * Compaction record id.
-             */
-            id: string;
-            /**
-             * Id of the agent.thread_context_compacted event emitted for this compaction; null when none.
-             */
-            event_id: string | null;
-            /**
-             * What started the compaction.
-             */
-            trigger: 'auto' | 'manual' | 'model_downshift';
-            /**
-             * Final outcome of the compaction.
-             */
-            status: 'succeeded' | 'failed';
-            /**
-             * Model that wrote the summary.
-             */
-            model: string;
-            /**
-             * Number of messages replaced by the summary.
-             */
-            compacted_message_count: number;
-            /**
-             * Context tokens before the compaction.
-             */
-            input_tokens_before: number;
-            /**
-             * Context tokens after the compaction; null when not measured.
-             */
-            input_tokens_after: number | null;
-            /**
-             * Summary text that replaced the messages; null when the compaction failed.
-             */
-            summary: string | null;
-            /**
-             * Failure reason; null when the compaction succeeded.
-             */
-            error: string | null;
-            /**
-             * RFC 3339 time at which the compaction was recorded.
-             */
-            created_at: string;
-        }>;
+        type: 'session_compaction';
+        /**
+         * Compaction operation id; pass it as operation_id to sessions.compact.retrieve.
+         */
+        id: string;
+        /**
+         * State of the compaction operation: queued and running are in progress, skipped means nothing needed compaction, succeeded and failed are final.
+         */
+        status: 'queued' | 'running' | 'skipped' | 'succeeded' | 'failed';
+        /**
+         * Why the compaction was skipped or failed; absent otherwise.
+         */
+        reason?: string;
+    };
+    /**
+     * Queued or running compaction
+     */
+    202: {
+        /**
+         * Always `session_compaction`. Result of a compaction request.
+         */
+        type: 'session_compaction';
+        /**
+         * Compaction operation id; pass it as operation_id to sessions.compact.retrieve.
+         */
+        id: string;
+        /**
+         * State of the compaction operation: queued and running are in progress, skipped means nothing needed compaction, succeeded and failed are final.
+         */
+        status: 'queued' | 'running' | 'skipped' | 'succeeded' | 'failed';
+        /**
+         * Why the compaction was skipped or failed; absent otherwise.
+         */
+        reason?: string;
     };
 };
-export type ListSessionCompactionsResponse = ListSessionCompactionsResponses[keyof ListSessionCompactionsResponses];
-export type GetEmbedAppearanceData = {
+export type CompactSessionResponse = CompactSessionResponses[keyof CompactSessionResponses];
+export type GetSessionCompactionData = {
     body?: never;
-    headers?: {
+    path: {
+        /**
+         * Session id (sesn_...), as returned by sessions.create or sessions.list. The same id is also accepted as the session_id query parameter on resource and thread calls, where it must equal the path value.
+         */
+        session_id: string;
         /**
-         * Active public key from the agent's console embed settings; alternative to an end-user Bearer token.
+         * Compaction operation id returned by sessions.compact in the id field of the session_compaction object.
          */
-        'Praxis-Publishable-Key'?: string;
+        operation_id: string;
     };
-    path?: never;
     query?: never;
-    url: '/agent/v1/embed/appearance';
+    url: '/agent/v1/sessions/{session_id}/compact/{operation_id}';
 };
-export type GetEmbedAppearanceErrors = {
-    /**
-     * Addressing parameters are not accepted; remove identity_number, agent_id and other query parameters.
-     */
-    400: unknown;
+export type GetSessionCompactionErrors = {
     /**
-     * Supply a valid embed token or an active publishable key; organization member credentials cannot read this surface.
+     * Authentication required
      */
     401: unknown;
     /**
@@ -37673,217 +35935,138 @@ export type GetEmbedAppearanceErrors = {
      */
     403: AgentError;
     /**
-     * The credential's service agent is absent or archived; obtain credentials for an active service agent.
+     * Session or compaction operation not found
      */
     404: unknown;
     /**
-     * Appearance is temporarily unavailable; use default appearance and continue the conversation.
+     * Agent service failed
+     */
+    502: unknown;
+    /**
+     * Agent service unavailable
      */
     503: unknown;
 };
-export type GetEmbedAppearanceError = GetEmbedAppearanceErrors[keyof GetEmbedAppearanceErrors];
-export type GetEmbedAppearanceResponses = {
+export type GetSessionCompactionError = GetSessionCompactionErrors[keyof GetSessionCompactionErrors];
+export type GetSessionCompactionResponses = {
     /**
-     * Saved Kit options, at most 8192 UTF-8 JSON bytes. Omitted groups use Kit defaults; an unconfigured agent returns an empty object.
+     * Compaction operation
      */
     200: {
         /**
-         * Public identity displayed on the chat page, independent of the internal agent name.
+         * Always `session_compaction`. Result of a compaction request.
          */
-        agent?: {
-            /**
-             * Display name; omission keeps the neutral browser-language default.
-             */
-            name?: string;
-            /**
-             * Optional HTTPS avatar image URL; non-HTTPS images are rejected.
-             */
-            avatar?: string;
-        };
+        type: 'session_compaction';
         /**
-         * 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.
+         * Compaction operation id; pass it as operation_id to sessions.compact.retrieve.
          */
-        layout?: 'inline' | 'sidebar' | 'popup' | 'modal';
+        id: string;
         /**
-         * Default entry button for the loader; an explicit script data-launcher takes precedence.
+         * State of the compaction operation: queued and running are in progress, skipped means nothing needed compaction, succeeded and failed are final.
          */
-        launcher?: {
-            /**
-             * Entry control: none hides the launcher, bubble shows a button, mascot shows a character that reacts while the visitor types and the agent thinks and answers. A mascot needs pack.
-             */
-            type: 'none' | 'bubble' | 'mascot';
-            /**
-             * Mascot images: exactly one of preset or images. Send pack, not image.
-             */
-            pack?: {
-                /**
-                 * Built-in character: mint (mint support girl), cat (cat-eared girl) or bot (small robot).
-                 */
-                preset?: 'mint' | 'cat' | 'bot';
-                /**
-                 * One HTTPS image per slot; only idle is required and a missing slot shows idle. Use 2:3 canvases with the feet bottom-centered on a transparent background; PNG or WebP stay still, GIF, WebP and APNG play as they are.
-                 */
-                images?: {
-                    /**
-                     * Resting state.
-                     */
-                    idle: string;
-                    /**
-                     * Page open and while the greeting bubble shows.
-                     */
-                    greet?: string;
-                    /**
-                     * The visitor is typing in the composer.
-                     */
-                    listening?: string;
-                    /**
-                     * After the visitor sends, before the first reply text.
-                     */
-                    thinking?: string;
-                    /**
-                     * While the reply streams; alternates with talking-2 every 220 ms.
-                     */
-                    talking?: string;
-                    /**
-                     * Second mouth frame of talking, mouth closed; without it talking alternates with idle.
-                     */
-                    'talking-2'?: string;
-                    /**
-                     * The last turn failed or was refused.
-                     */
-                    sorry?: string;
-                    /**
-                     * No interaction for 60 seconds; hover or click wakes the mascot.
-                     */
-                    sleep?: string;
-                };
-            };
-            /**
-             * Legacy single mascot image, read as pack.images.idle. When pack is present, pack wins.
-             */
-            image?: string;
-            /**
-             * float (default) gently floats the mascot, bounces on hover and waves with the greeting; none keeps it still. Reduced-motion settings always win.
-             */
-            motion?: 'float' | 'none';
-            /**
-             * 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;
-        };
+        status: 'queued' | 'running' | 'skipped' | 'succeeded' | 'failed';
         /**
-         * Visible chat heading; omitted title uses the public agent name.
+         * Why the compaction was skipped or failed; absent otherwise.
          */
-        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;
-        };
+        reason?: string;
+    };
+};
+export type GetSessionCompactionResponse = GetSessionCompactionResponses[keyof GetSessionCompactionResponses];
+export type ListSessionCompactionsData = {
+    body?: never;
+    path: {
         /**
-         * Visual tokens applied to the conversation and header; omitted fields use Kit defaults.
+         * Session id (sesn_...), as returned by sessions.create or sessions.list. The same id is also accepted as the session_id query parameter on resource and thread calls, where it must equal the path value.
          */
-        theme?: {
+        session_id: string;
+    };
+    query?: never;
+    url: '/agent/v1/sessions/{session_id}/compactions';
+};
+export type ListSessionCompactionsErrors = {
+    /**
+     * Authentication required
+     */
+    401: unknown;
+    /**
+     * permission_error: the credential's role or bound resources do not allow this operation. Use a key with access to the agent domain and its resources.
+     */
+    403: AgentError;
+    /**
+     * Session not found
+     */
+    404: unknown;
+    /**
+     * Agent service failed
+     */
+    502: unknown;
+    /**
+     * Agent service unavailable
+     */
+    503: unknown;
+};
+export type ListSessionCompactionsError = ListSessionCompactionsErrors[keyof ListSessionCompactionsErrors];
+export type ListSessionCompactionsResponses = {
+    /**
+     * Compaction history
+     */
+    200: {
+        /**
+         * Items of this page, in the order requested by the call.
+         */
+        data: Array<{
             /**
-             * light or dark selects a fixed scheme; system follows the device preference.
+             * Always `context_compaction`. Record of one past compaction.
              */
-            colorScheme?: 'light' | 'dark' | 'system';
+            type: 'context_compaction';
             /**
-             * Explicit opaque CSS accent color, for example #167A43.
+             * Compaction record id.
              */
-            accent?: string;
+            id: string;
             /**
-             * Explicit opaque CSS background color, for example #ffffff.
+             * Id of the agent.thread_context_compacted event emitted for this compaction; null when none.
              */
-            surface?: string;
+            event_id: string | null;
             /**
-             * neutral uses grayscale surfaces, warm uses warm tones, cool uses cool tones.
+             * What started the compaction.
              */
-            grayscale?: 'neutral' | 'warm' | 'cool';
+            trigger: 'auto' | 'manual' | 'model_downshift';
             /**
-             * Corner rounding: none is square, sm is small, md is medium, lg is large, full is fully rounded.
+             * Final outcome of the compaction.
              */
-            radius?: 'none' | 'sm' | 'md' | 'lg' | 'full';
+            status: 'succeeded' | 'failed';
             /**
-             * Spacing: compact reduces gaps, normal uses defaults, spacious increases gaps.
+             * Model that wrote the summary.
              */
-            density?: 'compact' | 'normal' | 'spacious';
+            model: string;
             /**
-             * CSS font family list using fonts available on the device; external font loading is not configured here.
+             * Number of messages replaced by the summary.
              */
-            fontFamily?: string;
+            compacted_message_count: number;
             /**
-             * Positive base font size in CSS pixels; omission preserves Kit sizing.
+             * Context tokens before the compaction.
              */
-            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?: {
+            input_tokens_before: number;
             /**
-             * Optional welcome text on the empty conversation.
+             * Context tokens after the compaction; null when not measured.
              */
-            greeting?: string;
+            input_tokens_after: number | null;
             /**
-             * Up to four suggested questions; clicking a label sends its prompt text.
+             * Summary text that replaced the messages; null when the compaction failed.
              */
-            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?: {
+            summary: string | null;
             /**
-             * Hint shown when the message input is empty.
+             * Failure reason; null when the compaction succeeded.
              */
-            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?: {
+            error: string | null;
             /**
-             * False hides history; omission uses the default enabled state.
+             * RFC 3339 time at which the compaction was recorded.
              */
-            enabled?: boolean;
-        };
+            created_at: string;
+        }>;
     };
 };
-export type GetEmbedAppearanceResponse = GetEmbedAppearanceResponses[keyof GetEmbedAppearanceResponses];
+export type ListSessionCompactionsResponse = ListSessionCompactionsResponses[keyof ListSessionCompactionsResponses];
 export type CreateAudioSpeechData = {
     body: unknown & {
         /**
@@ -46147,7 +44330,7 @@ export type AgentsListResponses = {
                 };
             };
             /**
-             * Resolved coordinator topology with a concrete agent roster.
+             * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
              */
             multiagent: null | AgentManaged39;
             /**
@@ -46175,12 +44358,11 @@ export type AgentsListResponses = {
              */
             updated_at: string;
             /**
-             * The agent's current version. Starts at 1 and increments when the agent is
-             * modified.
+             * Version of this returned configuration. Default retrieve returns the effective version; an explicit version query or a version-history item returns that saved version.
              */
             version: number;
             /**
-             * Version used by new sessions and newly issued embed tokens when no version is specified. Starts at 1; saving with apply false leaves it unchanged. Existing sessions and tokens keep their version.
+             * Agent-level currently effective version used by new sessions and newly issued embed tokens. This same value appears on every history item; it is not that item's version. Saving with apply false leaves it unchanged. Existing sessions and tokens retain their version.
              */
             active_version: number;
             /**
@@ -46707,9 +44889,7 @@ export type AgentsCreateData = {
          */
         metadata?: AgentManaged8Writable;
         /**
-         * A coordinator topology: the session's primary thread orchestrates
-         * work by spawning session threads, each running an agent drawn from the `agents`
-         * roster.
+         * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
         multiagent?: null | AgentManaged9;
         /**
@@ -47232,7 +45412,7 @@ export type AgentsCreateResponses = {
             };
         };
         /**
-         * Resolved coordinator topology with a concrete agent roster.
+         * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
         multiagent: null | AgentManaged39;
         /**
@@ -47260,12 +45440,11 @@ export type AgentsCreateResponses = {
          */
         updated_at: string;
         /**
-         * The agent's current version. Starts at 1 and increments when the agent is
-         * modified.
+         * Version of this returned configuration. Default retrieve returns the effective version; an explicit version query or a version-history item returns that saved version.
          */
         version: number;
         /**
-         * Version used by new sessions and newly issued embed tokens when no version is specified. Starts at 1; saving with apply false leaves it unchanged. Existing sessions and tokens keep their version.
+         * Agent-level currently effective version used by new sessions and newly issued embed tokens. This same value appears on every history item; it is not that item's version. Saving with apply false leaves it unchanged. Existing sessions and tokens retain their version.
          */
         active_version: number;
         /**
@@ -47741,8 +45920,8 @@ export type AgentsRetrieveData = {
     };
     query?: {
         /**
-         * Agent version. Omit for the most recent version. Must be at least 1
-         * if specified.
+         * Agent version to read. Omit, or pass active, for the effective version.
+         * Pass an integer of at least 1 to read that saved version.
          */
         version?: number;
     };
@@ -47828,7 +46007,7 @@ export type AgentsRetrieveResponses = {
             };
         };
         /**
-         * Resolved coordinator topology with a concrete agent roster.
+         * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
         multiagent: null | AgentManaged39;
         /**
@@ -47856,12 +46035,15 @@ export type AgentsRetrieveResponses = {
          */
         updated_at: string;
         /**
-         * The agent's current version. Starts at 1 and increments when the agent is
-         * modified.
+         * Version of this returned configuration. Default retrieve returns the effective version; an explicit version query or a version-history item returns that saved version.
          */
         version: number;
         /**
-         * Version used by new sessions and newly issued embed tokens when no version is specified. Starts at 1; saving with apply false leaves it unchanged. Existing sessions and tokens keep their version.
+         * Newest saved version number, including an unapplied save. Returned by default retrieve, update and apply; use it for optimistic concurrency when updating.
+         */
+        latest_version?: number;
+        /**
+         * Agent-level currently effective version used by new sessions and newly issued embed tokens. This same value appears on every history item; it is not that item's version. Saving with apply false leaves it unchanged. Existing sessions and tokens retain their version.
          */
         active_version: number;
         /**
@@ -48380,9 +46562,7 @@ export type AgentsUpdateData = {
             };
         };
         /**
-         * A coordinator topology: the session's primary thread orchestrates
-         * work by spawning session threads, each running an agent drawn from the `agents`
-         * roster.
+         * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
         multiagent?: null | AgentManaged9;
         /**
@@ -48404,20 +46584,17 @@ export type AgentsUpdateData = {
          */
         tools?: null | Array<AgentManaged15 | AgentManaged29 | AgentManaged32>;
         /**
-         * The agent's current version, used to prevent concurrent overwrites.
-         * Obtain this value from a create or retrieve response. Must be at least 1 if
-         * specified. When supplied, the request fails if it does not match the server's
-         * current version; omit to apply the update unconditionally.
+         * Newest saved version used for optimistic concurrency. Obtain latest_version from the default retrieve or update response, or version from versions.list. A stale value returns 409; omit for an unconditional update.
          */
         version?: number;
         /**
-         * Defaults to true: apply the newly saved version, or the latest version when configuration is unchanged. Set false to save without changing active_version. Unlike Managed Agents, saving and applying can be separate.
+         * Defaults to true: apply a newly saved configuration version. Set false to save without changing active_version. An unchanged configuration is a no-op, including note-only updates; use versions.apply to activate a saved version.
          */
         apply?: boolean;
         /**
-         * Optional change explanation stored as note on the new immutable version, up to 280 characters. Omission or null stores no note. A note sent when nothing else changes returns 400 (nothing to save), because a note is stored only with a new version.
+         * Optional change explanation, at most 280 characters. Recorded only when a configuration change creates a new immutable version. A note-only update is a no-op returning 200 and the current effective version. Null is equivalent to omission.
          */
-        version_note?: string;
+        version_note?: string | null;
         /**
          * Replace the whole bindings list; omission preserves it, and null or [] clears it. Additions apply only to new sessions; once this version is applied, disabling, removing or downgrading a binding revokes it immediately in running sessions on older versions, while apply=false changes no access. Only service agents accept a nonempty list.
          */
@@ -48934,7 +47111,7 @@ export type AgentsUpdateResponses = {
             };
         };
         /**
-         * Resolved coordinator topology with a concrete agent roster.
+         * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
         multiagent: null | AgentManaged39;
         /**
@@ -48962,12 +47139,15 @@ export type AgentsUpdateResponses = {
          */
         updated_at: string;
         /**
-         * The agent's current version. Starts at 1 and increments when the agent is
-         * modified.
+         * Version of this returned configuration. Default retrieve returns the effective version; an explicit version query or a version-history item returns that saved version.
          */
         version: number;
         /**
-         * Version used by new sessions and newly issued embed tokens when no version is specified. Starts at 1; saving with apply false leaves it unchanged. Existing sessions and tokens keep their version.
+         * Newest saved version number, including an unapplied save. Returned by default retrieve, update and apply; use it for optimistic concurrency when updating.
+         */
+        latest_version?: number;
+        /**
+         * Agent-level currently effective version used by new sessions and newly issued embed tokens. This same value appears on every history item; it is not that item's version. Saving with apply false leaves it unchanged. Existing sessions and tokens retain their version.
          */
         active_version: number;
         /**
@@ -49520,7 +47700,7 @@ export type AgentsArchiveResponses = {
             };
         };
         /**
-         * Resolved coordinator topology with a concrete agent roster.
+         * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
         multiagent: null | AgentManaged39;
         /**
@@ -49548,12 +47728,11 @@ export type AgentsArchiveResponses = {
          */
         updated_at: string;
         /**
-         * The agent's current version. Starts at 1 and increments when the agent is
-         * modified.
+         * Version of this returned configuration. Default retrieve returns the effective version; an explicit version query or a version-history item returns that saved version.
          */
         version: number;
         /**
-         * Version used by new sessions and newly issued embed tokens when no version is specified. Starts at 1; saving with apply false leaves it unchanged. Existing sessions and tokens keep their version.
+         * Agent-level currently effective version used by new sessions and newly issued embed tokens. This same value appears on every history item; it is not that item's version. Saving with apply false leaves it unchanged. Existing sessions and tokens retain their version.
          */
         active_version: number;
         /**
@@ -50061,7 +48240,7 @@ export type AgentsVersionsListResponses = {
      */
     200: {
         /**
-         * Items of this page, in the order requested by the call.
+         * Saved agent configurations in ascending version number, oldest first. Each own-face item carries the same agent-level active_version.
          */
         data: Array<{
             /**
@@ -50120,7 +48299,7 @@ export type AgentsVersionsListResponses = {
                 };
             };
             /**
-             * Resolved coordinator topology with a concrete agent roster.
+             * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
              */
             multiagent: null | AgentManaged39;
             /**
@@ -50148,12 +48327,11 @@ export type AgentsVersionsListResponses = {
              */
             updated_at: string;
             /**
-             * The agent's current version. Starts at 1 and increments when the agent is
-             * modified.
+             * Version of this returned configuration. Default retrieve returns the effective version; an explicit version query or a version-history item returns that saved version.
              */
             version: number;
             /**
-             * Version used by new sessions and newly issued embed tokens when no version is specified. Starts at 1; saving with apply false leaves it unchanged. Existing sessions and tokens keep their version.
+             * Agent-level currently effective version used by new sessions and newly issued embed tokens. This same value appears on every history item; it is not that item's version. Saving with apply false leaves it unchanged. Existing sessions and tokens retain their version.
              */
             active_version: number;
             /**