@deepraxis/sdk 0.1.0 → 0.1.1-dev.54635ff

package/dist/operations.generated.d.ts

@@ -45,7 +45,7 @@ export declare const operations: readonly [{
     readonly resource: "agent.agents";
     readonly method: "create";
     readonly summary: "Create agent";
-    readonly description: "Create a reusable agent definition, then pass its returned id to sessions.create to start a conversation. The definition includes model, system prompt, tools, MCP servers and an optional multiagent roster. It is saved as version 1; real updates create new versions. Unlike Anthropic Managed Agents, nonempty skills attachments return 400; the native skill tool is separate from the skills field. Use tools: [{type: \"agent_toolset_20260401\"}] for built-in tools including codemode, skill and agent; inspect toolsets.list for names and schemas, and keep bash enabled for native additions. To offer only some tools, set default_config: {enabled: false} and list the tools to keep in configs, e.g. tools: [{type: \"agent_toolset_20260401\", default_config: {enabled: false}, configs: [{name: \"codemode\", enabled: true}, {name: \"bash\", enabled: true, permission_policy: {type: \"always_ask\"}}]}]; every tool not listed, including todo_write, enter_plan_mode, ask_user_question and goal_read, follows default_config, and the response echoes it. codemode runs through bash, so enabling codemode while bash is disabled returns 400. Optional mcp_toolset entries pair with mcp_servers. model accepts platform model IDs such as deepseek-flash, not only the Claude IDs in the protocol examples. model.settings.reasoning sets default thinking; other extra model controls return 400. Example: {\"name\":\"helper\",\"model\":{\"id\":\"deepseek-flash\"},\"tools\":[{\"type\":\"agent_toolset_20260401\"}]}.";
+    readonly description: "Create a reusable agent definition, then pass its returned id to sessions.create to start a conversation. The definition includes model, system prompt, tools, MCP servers and an optional multiagent roster. It is saved as version 1; real updates create new versions. skills attaches uploaded custom skills as [{type: \"custom\", skill_id, version?}] (skill_id from skills.create or skills.list; at most 20, no repeated skill_id). Omit version, or send \"latest\", to use the skill's newest version when a session starts. type anthropic returns 400. Use tools: [{type: \"agent_toolset_20260401\"}] for built-in tools including codemode, skill and agent; inspect toolsets.list for names and schemas, and keep bash enabled for native additions. To offer only some tools, set default_config: {enabled: false} and list the tools to keep in configs, e.g. tools: [{type: \"agent_toolset_20260401\", default_config: {enabled: false}, configs: [{name: \"codemode\", enabled: true}, {name: \"bash\", enabled: true, permission_policy: {type: \"always_ask\"}}]}]; every tool not listed, including todo_write, enter_plan_mode, ask_user_question and goal_read, follows default_config, and the response echoes it. codemode runs through bash, so enabling codemode while bash is disabled returns 400. Optional mcp_toolset entries pair with mcp_servers. model accepts platform model IDs such as deepseek-flash, not only the Claude IDs in the protocol examples. model.settings.reasoning sets default thinking; other extra model controls return 400. model and every models.allowed entry must be a catalog model that can run an agent: an unknown id returns 400 \"model <id> is not in the model catalog\" and an embedding, image or speech model returns 400 \"model <id> cannot run an agent\". name is a label, not a unique key: 1 to 256 characters after trimming, no NUL or line breaks. avatar is trimmed, must not contain spaces or point at a loopback, private or internal host, and its scheme is stored in lowercase. script and workflow binding ids are stored in lowercase, the form automation matches; bindings together with environment_id null return 400 because bindings need a machine. Example: {\"name\":\"helper\",\"model\":{\"id\":\"deepseek-flash\"},\"tools\":[{\"type\":\"agent_toolset_20260401\"}]}.";
     readonly http: "POST";
     readonly path: "/agent/v1/agents";
     readonly streaming: "no";
@@ -58,12 +58,12 @@ export declare const operations: readonly [{
             readonly name: "model";
             readonly type: "object";
             readonly required: true;
-            readonly description: "Model identifier. Accepts the\n[model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),\ne.g. `claude-opus-5`, or a `model_config` object for additional configuration\ncontrol";
+            readonly description: "A model id from the Praxis model catalog (`praxis.model.models.list`), or a `model_config` object for additional configuration control. Unlike Anthropic, Claude model ids other than those in the catalog are rejected.";
         }, {
             readonly name: "name";
             readonly type: "string";
             readonly required: true;
-            readonly description: "Human-readable name for the agent.";
+            readonly description: "Display name of the agent, 1 to 256 characters after trimming, with no NUL or line breaks. A label, not a unique key: two agents may share a name.";
         }, {
             readonly name: "description";
             readonly type: "string";
@@ -90,7 +90,7 @@ export declare const operations: readonly [{
             readonly type: "array";
             readonly itemType: "object";
             readonly required: false;
-            readonly description: "Skill attachments are not supported: a nonempty array returns 400. Omit this field or send an empty array; the native skill tool is configured separately through tools.";
+            readonly description: "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.";
         }, {
             readonly name: "system";
             readonly type: "string";
@@ -107,7 +107,7 @@ export declare const operations: readonly [{
             readonly type: "array";
             readonly itemType: "object";
             readonly required: false;
-            readonly description: "Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file_..., read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. A resource that is not bound returns 404, a service that is not opened returns 403, and writes to read_only resources are refused. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.";
+            readonly description: "Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.";
         }, {
             readonly name: "kind";
             readonly type: "string";
@@ -124,6 +124,11 @@ export declare const operations: readonly [{
             readonly type: "string";
             readonly required: false;
             readonly description: "Praxis extension: default subagent model ID, pinned in the agent revision. Call model overrides this; otherwise it overrides the roster member model or the parent model for built-ins. Null clears the default. /agent/v1 only.";
+        }, {
+            readonly name: "image_model";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Model used by the imagine image tool; defaults to gpt-image-2 when unset. Only models that can generate images are accepted. Omit to preserve; null clears the configured model. /agent/v1 only.";
         }, {
             readonly name: "subagents";
             readonly type: "array";
@@ -174,7 +179,7 @@ export declare const operations: readonly [{
     readonly resource: "agent.agents";
     readonly method: "retrieve";
     readonly summary: "Get agent";
-    readonly description: "Read one agent by id, at its latest version or, with version, at a specific earlier version. The response lists every native tool with its resolved configuration in one agent_toolset_20260401 entry, so it can be sent back unchanged to agents.update. Use agents.versions.list to enumerate versions.";
+    readonly description: "Read one agent by id. The top level is the latest saved version, the editable head whose version you send back for optimistic concurrency; after a save with apply false it differs from active_version, and new sessions use active_version, which you read with version=active. With version, read a specific saved version. The response lists every native tool with its resolved configuration in one agent_toolset_20260401 entry, so it can be sent back unchanged to agents.update. Use agents.versions.list to enumerate versions.";
     readonly http: "GET";
     readonly path: "/agent/v1/agents/{agent_id}";
     readonly streaming: "no";
@@ -182,18 +187,19 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name.";
     }];
     readonly query: readonly [{
         readonly name: "version";
         readonly type: "number";
         readonly required: false;
-        readonly description: "Agent version to read; omit for the latest. Integer of at least 1; versions are listed by agents.versions.list.";
+        readonly description: "Agent version to read; omit for the latest saved version. An integer of at least 1 (versions are listed by agents.versions.list), or the string active for the version new sessions use.";
     }];
 }, {
     readonly resource: "agent.agents";
     readonly method: "update";
     readonly summary: "Update agent";
-    readonly description: "Update an agent. Send the current version in the body for optimistic concurrency: a stale version returns 409, and an update that changes nothing keeps the version number. Any real change saves a new version. apply defaults to true and moves active_version to the new version, or to the latest when configuration is unchanged; apply false saves without applying. version_note optionally records up to 280 characters on a newly created version. Existing sessions and tokens keep their version. Omitted fields keep their value. multiagent takes null or a coordinator roster; subagent_model keeps its value when omitted and is cleared by null. Archived agents cannot be updated. Unlike Anthropic Managed Agents, nonempty skills attachments return 400; use the native skill tool for available runtime skills.";
+    readonly description: "Update an agent. Send the current version in the body for optimistic concurrency: a stale version returns 409, and an update that changes nothing keeps the version number. Any real change saves a new version. apply defaults to true and moves active_version to the new version, or to the latest when configuration is unchanged; apply false saves without applying. version_note optionally records up to 280 characters on a newly created version; null means no note, and a note sent when the request changes nothing else returns 400 because a note is stored only with a new version. Existing sessions and tokens keep their version. Omitted fields keep their value. multiagent takes null or a coordinator roster; subagent_model keeps its value when omitted and is cleared by null. Archived agents cannot be updated. tools: [] removes every tool, while tools: null returns 400 (tools cannot be null; send [] to remove every tool). On update, omit skills to keep them, send an array to replace them, or send [] or null to clear them. skills attaches uploaded custom skills as [{type: \"custom\", skill_id, version?}] (skill_id from skills.create or skills.list; at most 20, no repeated skill_id). Omit version, or send \"latest\", to use the skill's newest version when a session starts. type anthropic returns 400.";
     readonly http: "POST";
     readonly path: "/agent/v1/agents/{agent_id}";
     readonly streaming: "no";
@@ -201,6 +207,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -225,7 +232,7 @@ export declare const operations: readonly [{
             readonly name: "model";
             readonly type: "object";
             readonly required: false;
-            readonly description: "Model identifier. Accepts the\n[model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),\ne.g. `claude-opus-5`, or a `model_config` object for additional configuration\ncontrol. Omit to preserve. Cannot be cleared.";
+            readonly description: "A model id from the Praxis model catalog (`praxis.model.models.list`), or a `model_config` object for additional configuration control. Unlike Anthropic, Claude model ids other than those in the catalog are rejected.";
         }, {
             readonly name: "multiagent";
             readonly type: "object";
@@ -235,13 +242,13 @@ export declare const operations: readonly [{
             readonly name: "name";
             readonly type: "string";
             readonly required: false;
-            readonly description: "Human-readable name. Must be non-empty. Omit to preserve. Cannot be\ncleared.";
+            readonly description: "New display name, 1 to 256 characters after trimming, with no NUL or line breaks. A label, not a unique key; omit to keep the current name.";
         }, {
             readonly name: "skills";
             readonly type: "array";
             readonly itemType: "object";
             readonly required: false;
-            readonly description: "Skill attachments are not supported: a nonempty array returns 400. Omit this field or send an empty array; the native skill tool is configured separately through tools.";
+            readonly description: "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.";
         }, {
             readonly name: "system";
             readonly type: "string";
@@ -267,13 +274,13 @@ export declare const operations: readonly [{
             readonly name: "version_note";
             readonly type: "string";
             readonly required: false;
-            readonly description: "Optional change explanation stored as note on the new immutable version, up to 280 characters. Omission stores null. A note alone does not create a version or rewrite an existing note.";
+            readonly description: "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.";
         }, {
             readonly name: "bindings";
             readonly type: "array";
             readonly itemType: "object";
             readonly required: false;
-            readonly description: "Replace the whole bindings list; omission preserves it, and null or [] clears it. Additions apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. Only service agents accept a nonempty list.";
+            readonly description: "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.";
         }, {
             readonly name: "kind";
             readonly type: "string";
@@ -290,6 +297,11 @@ export declare const operations: readonly [{
             readonly type: "string";
             readonly required: false;
             readonly description: "Praxis extension: default subagent model ID, pinned in the agent revision. Call model overrides this; otherwise it overrides the roster member model or the parent model for built-ins. Null clears the default. /agent/v1 only.";
+        }, {
+            readonly name: "image_model";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Model used by the imagine image tool; defaults to gpt-image-2 when unset. Only models that can generate images are accepted. Omit to preserve; null clears the configured model. /agent/v1 only.";
         }, {
             readonly name: "subagents";
             readonly type: "array";
@@ -336,6 +348,21 @@ export declare const operations: readonly [{
             readonly description: "Optional tool preset. minimal enables read, glob, grep and ask_user_question; data-editor also enables write and edit; full uses the default toolset with always_allow. Explicit tools override matching preset entries. codemode requires bash and is absent from data-editor.";
         }];
     };
+}, {
+    readonly resource: "agent.agents";
+    readonly method: "retrieveAppearance";
+    readonly summary: "Get agent appearance";
+    readonly description: "Read the saved chat appearance of a service agent.\n\nAgent Kit calls this from the page with a customer access token of this agent; your API key and console members can read it too. A token of another agent returns 404. The body is the same as the embed appearance read; a missing appearance returns the agent's own name and avatar only. Responses are private and cacheable for 60 seconds.";
+    readonly http: "GET";
+    readonly path: "/agent/v1/agents/{agent_id}/appearance";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Service agent id from agent creation or listing; with a customer access token, the agent the token was issued for.";
+    }];
+    readonly query: readonly [];
 }, {
     readonly resource: "agent.agents";
     readonly method: "archive";
@@ -348,6 +375,291 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "agent.agents.customers";
+    readonly method: "list";
+    readonly summary: "List customers";
+    readonly description: "List the customers of a service agent, identified and anonymous, most recently seen first.\n\nCall this from your backend with your API key, or from the console. Customers follow Shopify Admin customers (list, retrieve, block, sign-out and data deletion of the people who use your storefront), so that experience applies. The list includes customers who signed in but have not started a session yet, and customers recorded under your own ids by embed tokens before customer sign-in existed; an id first seen that way is identified unless it starts with anon_. Unlike Shopify, a customer can be anonymous: a visitor admitted with the publishable key gets an anon_ id, and when it later signs in with anonymous_access_token it is merged: merged_into names the identified customer, and its sessions count toward that customer. Filter with q (a case-sensitive customer id prefix), type (identified or anonymous) and blocked (true or false). limit is 1 to 100, default 20; reuse next_page with the same filters and limit. A customer access token gets 404. Example: GET /agent/v1/agents/agent_example/customers?type=identified&blocked=false&limit=50.";
+    readonly http: "GET";
+    readonly path: "/agent/v1/agents/{agent_id}/customers";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Active service agent id from agent creation or listing.";
+    }];
+    readonly query: readonly [{
+        readonly name: "limit";
+        readonly type: "integer";
+        readonly required: false;
+        readonly description: "Maximum customers per page, 1 to 100; defaults to 20.";
+    }, {
+        readonly name: "page";
+        readonly type: "string";
+        readonly required: false;
+        readonly description: "next_page from the previous response with the same q, type, blocked and limit.";
+    }, {
+        readonly name: "q";
+        readonly type: "string";
+        readonly required: false;
+        readonly description: "Case-sensitive literal prefix of the customer id; omit for all customers.";
+    }, {
+        readonly name: "type";
+        readonly type: "string";
+        readonly enum: readonly ["identified", "anonymous"];
+        readonly required: false;
+        readonly description: "Only identified or only anonymous customers; omit for both.";
+    }, {
+        readonly name: "blocked";
+        readonly type: "boolean";
+        readonly required: false;
+        readonly description: "true for blocked customers only, false for customers who are not blocked; omit for both.";
+    }];
+}, {
+    readonly resource: "agent.agents.customers.auth.accessTokens";
+    readonly method: "create";
+    readonly summary: "Create customer access token";
+    readonly description: "Exchange a grant code, or the agent's publishable key for an anonymous visitor, for a customer access token that authorizes the agent's embedded sessions.\n\nNo Authorization header is required: the grant code or the publishable key is the credential. Agent Kit calls this from the browser, so send the page Origin. With grant_code, the code is consumed atomically: concurrent attempts have exactly one winner, and unknown, used, expired and other-agent codes all return the same 401 GRANT_CODE_INVALID. The sign-in starts now and lasts the code's max_session_seconds. Unlike Shopify, a visitor without an account gets a token too: send publishable_key instead and a new anonymous customer (anon_…) is created, bound to the request Origin, for 7 days. The access token lasts at most two hours and never outlives the sign-in; renew it with access_tokens/renew before expires_at. Both forms share the per-IP minute limit of anonymous issuance (default 20). Example body: {\"grant_code\":\"cgc_…\"}.";
+    readonly http: "POST";
+    readonly path: "/agent/v1/agents/{agent_id}/customers/auth/access_tokens";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Service agent id (agent_…) or its short identity number, from agent creation or listing.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [];
+    };
+}, {
+    readonly resource: "agent.agents.customers.auth.accessTokens";
+    readonly method: "deleteCurrent";
+    readonly summary: "Log out customer";
+    readonly description: "Log the customer out by revoking the sign-in of the presented access token and every token issued in it.\n\nSend the current customer access token as the Bearer credential, with no body, when the customer logs out of your site. Every token of the sign-in, including renewed ones, stops working, and their live event streams close; the customer's conversations are kept. Returns 204. Calling it again with the same token returns 401 ACCESS_TOKEN_REVOKED, so treat that as already logged out.";
+    readonly http: "DELETE";
+    readonly path: "/agent/v1/agents/{agent_id}/customers/auth/access_tokens/current";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Service agent id (agent_…) or its short identity number, from agent creation or listing.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "agent.agents.customers.auth.accessTokens.renew";
+    readonly method: "create";
+    readonly summary: "Renew customer access token";
+    readonly description: "Get a fresh customer access token in the same sign-in, authenticated with the current one.\n\nSend the current customer access token as the Bearer credential, with no body, a few minutes before expires_at. The new token keeps the version, budget, context, metadata and origin binding of the sign-in and lasts at most two hours, never past session_expires_at. Unlike Shopify, renewal does not revoke the presented token: it stays valid until its own expiry, so a reply that is streaming on it is not cut off. When less than 60 seconds of the sign-in remain, renewal returns 401 CUSTOMER_SESSION_EXPIRED; sign the customer in again with a new grant code from your backend. A token that was logged out or merged returns 401 ACCESS_TOKEN_REVOKED.";
+    readonly http: "POST";
+    readonly path: "/agent/v1/agents/{agent_id}/customers/auth/access_tokens/renew";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Service agent id (agent_…) or its short identity number, from agent creation or listing.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "agent.agents.customers.auth.grantCodes";
+    readonly method: "create";
+    readonly summary: "Create customer grant code";
+    readonly description: "Sign your logged-in customer in to a service agent from your backend with a one-time grant code that Agent Kit exchanges for a customer access token.\n\nCall this from your backend with your API key after your own login succeeds, then pass the returned code to Agent Kit in the browser; never call it from the browser. Customer authorization follows Shopify Storefront customer access tokens (Multipass-style sign-in, a short-lived token, renewal and logout), so that experience applies. customer_id is your own identifier for the customer: use an opaque id such as your database user id, not an email address or phone number. The value auth is reserved, and ids starting with anon_ are reserved for anonymous customers. The code works once and expires after expires_in seconds (default 900). The sign-in it starts lasts max_session_seconds (default 7 days); version, budget (US dollars, at most 2 decimals), system_message, agent_override and metadata apply to every token of the sign-in. Unlike Shopify, origin binds the whole sign-in to one page origin, and anonymous_access_token merges the conversations of the anonymous visitor who chatted before signing in into this customer. Example body: {\"customer_id\":\"cus_8f2a91\",\"origin\":\"https://shop.example.com\"}.";
+    readonly http: "POST";
+    readonly path: "/agent/v1/agents/{agent_id}/customers/auth/grant_codes";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Service agent id (agent_…) or its short identity number, from agent creation or listing.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "customer_id";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Your stable, opaque identifier for the signed-in customer, such as your database user id. Do not use an email address or phone number. \"auth\" is reserved, and ids starting with anon_ are reserved for anonymous customers.";
+        }, {
+            readonly name: "version";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Existing agent version that every token of this sign-in pins. Defaults to the agent's active_version when the code is issued.";
+        }, {
+            readonly name: "budget";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Budget for each session the customer starts, in the same shape as a session budget. Defaults to the embed policy session budget and cannot exceed its maximum.";
+        }, {
+            readonly name: "system_message";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly description: "Optional context the agent receives at the start of each session, as text blocks, limited to 8192 UTF-8 bytes in total.";
+        }, {
+            readonly name: "agent_override";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Optional system prompt override, accepted only when the embed policy allows agent overrides.";
+        }, {
+            readonly name: "metadata";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Up to 16 string pairs copied onto every session the customer starts. The playground key is reserved.";
+        }, {
+            readonly name: "origin";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Page origin, such as https://shop.example.com, that must be one of the agent policy's allowed_origins (or localhost when the policy allows it). When set, every token of this sign-in works only from exactly this origin. Omit to accept any policy origin.";
+        }, {
+            readonly name: "expires_in";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Seconds the code stays redeemable, from 60 to 86400. Defaults to 900.";
+        }, {
+            readonly name: "max_session_seconds";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Total lifetime of the sign-in in seconds, from 3600 to 604800 (7 days). Tokens renew within it; after it the customer signs in again. Defaults to 604800.";
+        }, {
+            readonly name: "anonymous_access_token";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "The current access token of the anonymous customer who used this agent before signing in. Their conversations become visible to the identified customer, and the anonymous sign-in ends at exchange.";
+        }, {
+            readonly name: "hosted";
+            readonly type: "boolean";
+            readonly required: false;
+            readonly description: "Set true to also return hosted_url, a link to the agent's Hosted chat page that carries the code in its fragment. The page exchanges the code only when the customer clicks to start, so link previews in email or chat apps do not use it up. The agent must have an identity_number, and origin cannot be set: the code is bound to no origin. Defaults to false.";
+        }];
+    };
+}, {
+    readonly resource: "agent.agents.customers";
+    readonly method: "delete";
+    readonly summary: "Delete customer data";
+    readonly description: "Delete a customer's data from one service agent after explicit confirmation.\n\nDevelop only. Set confirm to the exact customer id; a missing or different confirm returns 400 naming the value to send. Returns 202 with a pending task id; poll the deletion endpoint. Concurrent requests reuse the unfinished task; retry DELETE after failure to resume it. Tokens are revoked and the customer is blocked before a seven-day recovery snapshot is verified; sessions including child sessions, conversation data, grants and feedback are then removed. A block that existed before stays; a temporary block is removed on success. File attachments are retained. Example: DELETE /agent/v1/agents/agent_example/customers/cus_8f2a91?confirm=cus_8f2a91.";
+    readonly http: "DELETE";
+    readonly path: "/agent/v1/agents/{agent_id}/customers/{customer_id}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Active service agent id from agent creation or listing.";
+    }, {
+        readonly name: "customer_id";
+        readonly sdkName: "customer_id";
+        readonly description: "Customer id from customer listing, or your own customer_id.";
+    }];
+    readonly query: readonly [{
+        readonly name: "confirm";
+        readonly type: "string";
+        readonly required: true;
+        readonly description: "Must equal the customer_id path parameter exactly, confirming the destructive deletion.";
+    }];
+}, {
+    readonly resource: "agent.agents.customers";
+    readonly method: "retrieve";
+    readonly summary: "Get customer";
+    readonly description: "Retrieve one customer of a service agent with its twenty most recently updated sessions.\n\nUse the customer id from the list or your own customer_id. An unknown customer returns 404 CUSTOMER_NOT_FOUND, and so does a customer access token. Unlike Shopify, an identified customer's session_count, cost and recent_sessions include the sessions of anonymous customers merged into it; the merged anonymous customer still shows its own sessions and its merged_into.";
+    readonly http: "GET";
+    readonly path: "/agent/v1/agents/{agent_id}/customers/{customer_id}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Active service agent id from agent creation or listing.";
+    }, {
+        readonly name: "customer_id";
+        readonly sdkName: "customer_id";
+        readonly description: "Customer id from customer listing, or your own customer_id.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "agent.agents.customers.block";
+    readonly method: "create";
+    readonly summary: "Block customer";
+    readonly description: "Block a customer and end every sign-in it has on this agent.\n\nBlocks the customer, then ends every live sign-in the way logout does: each access token is revoked and its open event streams close. From then on grant_codes, access_tokens, renew and new sessions for this customer return CUSTOMER_BLOCKED until you unblock it. Idempotent: a repeat keeps the first block time and revokes whatever is still live. If credential revocation fails the request returns 502 and the customer stays blocked; retry to finish. An unknown customer returns 404 CUSTOMER_NOT_FOUND.";
+    readonly http: "POST";
+    readonly path: "/agent/v1/agents/{agent_id}/customers/{customer_id}/block";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Active service agent id from agent creation or listing.";
+    }, {
+        readonly name: "customer_id";
+        readonly sdkName: "customer_id";
+        readonly description: "Customer id from customer listing, or your own customer_id.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "agent.agents.customers";
+    readonly method: "retrieveDeletion";
+    readonly summary: "Get customer deletion";
+    readonly description: "Poll the latest deletion task of a customer, including after its data has been removed.\n\nUse the same agent_id and customer id as the confirmed DELETE. Status is pending, snapshotting, deleting, done or failed. Counts are empty until a verified snapshot exists. snapshot_key is an operator recovery reference retained for seven days, not a download URL. A customer access token and a missing task return 404.";
+    readonly http: "GET";
+    readonly path: "/agent/v1/agents/{agent_id}/customers/{customer_id}/deletion";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Active service agent id from agent creation or listing.";
+    }, {
+        readonly name: "customer_id";
+        readonly sdkName: "customer_id";
+        readonly description: "Customer id from customer listing, or your own customer_id.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "agent.agents.customers.revokeTokens";
+    readonly method: "create";
+    readonly summary: "Revoke customer tokens";
+    readonly description: "Sign a customer out everywhere without blocking it.\n\nEnds every live sign-in of the customer, revoking each access token and closing its open event streams; the customer can sign in again right away. Returns the number of access tokens this request revoked; a repeat returns 0. Credential revocation failure returns 502; retry to finish. An unknown customer returns 404 CUSTOMER_NOT_FOUND.";
+    readonly http: "POST";
+    readonly path: "/agent/v1/agents/{agent_id}/customers/{customer_id}/revoke_tokens";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Active service agent id from agent creation or listing.";
+    }, {
+        readonly name: "customer_id";
+        readonly sdkName: "customer_id";
+        readonly description: "Customer id from customer listing, or your own customer_id.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "agent.agents.customers.unblock";
+    readonly method: "create";
+    readonly summary: "Unblock customer";
+    readonly description: "Allow a blocked customer to sign in and start sessions again.\n\nIdempotent. Access tokens revoked while the customer was blocked stay revoked; sign the customer in again with a new grant code. An unknown customer returns 404 CUSTOMER_NOT_FOUND.";
+    readonly http: "POST";
+    readonly path: "/agent/v1/agents/{agent_id}/customers/{customer_id}/unblock";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "agent_id";
+        readonly sdkName: "agent_id";
+        readonly description: "Active service agent id from agent creation or listing.";
+    }, {
+        readonly name: "customer_id";
+        readonly sdkName: "customer_id";
+        readonly description: "Customer id from customer listing, or your own customer_id.";
     }];
     readonly query: readonly [];
 }, {
@@ -362,6 +674,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Active service agent identifier from agent creation or listing.";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -391,9 +704,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Active service agent identifier from agent creation or listing.";
     }, {
         readonly name: "external_user_id";
         readonly sdkName: "external_user_id";
+        readonly description: "Host user identifier supplied at issuance or from end-user listing.";
     }];
     readonly query: readonly [{
         readonly name: "confirm";
@@ -413,9 +728,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Active service agent identifier from agent creation or listing.";
     }, {
         readonly name: "external_user_id";
         readonly sdkName: "external_user_id";
+        readonly description: "Host user identifier supplied at issuance or from end-user listing.";
     }];
     readonly query: readonly [];
 }, {
@@ -430,9 +747,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Active service agent identifier from agent creation or listing.";
     }, {
         readonly name: "external_user_id";
         readonly sdkName: "external_user_id";
+        readonly description: "Host user identifier supplied at issuance or from end-user listing.";
     }];
     readonly query: readonly [];
 }, {
@@ -447,9 +766,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Active service agent identifier from agent creation or listing.";
     }, {
         readonly name: "external_user_id";
         readonly sdkName: "external_user_id";
+        readonly description: "Host user identifier supplied at issuance or from end-user listing.";
     }];
     readonly query: readonly [];
 }, {
@@ -464,9 +785,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Active service agent identifier from agent creation or listing.";
     }, {
         readonly name: "external_user_id";
         readonly sdkName: "external_user_id";
+        readonly description: "Host user identifier supplied at issuance or from end-user listing.";
     }];
     readonly query: readonly [];
 }, {
@@ -481,9 +804,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Active service agent identifier from agent creation or listing.";
     }, {
         readonly name: "external_user_id";
         readonly sdkName: "external_user_id";
+        readonly description: "Host user identifier supplied at issuance or from end-user listing.";
     }];
     readonly query: readonly [];
 }, {
@@ -498,13 +823,14 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Agent id from creation or listing.";
     }];
     readonly query: readonly [];
 }, {
     readonly resource: "agent.agents.versions";
     readonly method: "list";
     readonly summary: "List agent versions";
-    readonly description: "List the saved versions of one agent, in pages of at most 100 (default 20). Each item is the full agent definition at that version, so you can compare what changed between versions. Use agents.retrieve with version to read a single one; agent_id comes from agents.list or agents.create.";
+    readonly description: "List the saved versions of one agent, in pages of at most 100 (default 20). Each item is the full agent definition at that version, so you can compare what changed between versions. active is true only for the item that new sessions use; active_version on each item is the agent-level value, kept for compatibility. Use agents.retrieve with version to read a single one; agent_id comes from agents.list or agents.create.";
     readonly http: "GET";
     readonly path: "/agent/v1/agents/{agent_id}/versions";
     readonly streaming: "no";
@@ -512,6 +838,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name.";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -536,16 +863,19 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "agent_id";
         readonly sdkName: "agent_id";
+        readonly description: "Agent identifier from agents.create or agents.list.";
     }, {
         readonly name: "version";
         readonly sdkName: "version";
+        readonly type: "integer";
+        readonly description: "Existing version number from agents.versions.list to use for new sessions and tokens.";
     }];
     readonly query: readonly [];
 }, {
     readonly resource: "agent.computers";
     readonly method: "list";
-    readonly summary: "ComputersList";
-    readonly description: "Tenant-owned durable computer resource.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
+    readonly summary: "List Computers";
+    readonly description: "List the computers of your organization, archived ones included.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
     readonly http: "GET";
     readonly path: "/agent/v1/computers";
     readonly streaming: "no";
@@ -565,8 +895,8 @@ export declare const operations: readonly [{
 }, {
     readonly resource: "agent.computers";
     readonly method: "create";
-    readonly summary: "ComputersCreate";
-    readonly description: "Tenant-owned durable computer resource.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
+    readonly summary: "Create Computer";
+    readonly description: "Create a durable computer: a named machine whose files outlive sessions, for personal agents.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
     readonly http: "POST";
     readonly path: "/agent/v1/computers";
     readonly streaming: "no";
@@ -599,13 +929,14 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "computer_id";
         readonly sdkName: "computer_id";
+        readonly description: "Computer id (cmp_...), as returned by computers.create or computers.list.";
     }];
     readonly query: readonly [];
 }, {
     readonly resource: "agent.computers";
     readonly method: "retrieve";
-    readonly summary: "ComputersRetrieve";
-    readonly description: "Tenant-owned durable computer resource.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
+    readonly summary: "Get Computer";
+    readonly description: "Read one computer's status, storage use and sandbox id.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
     readonly http: "GET";
     readonly path: "/agent/v1/computers/{computer_id}";
     readonly streaming: "no";
@@ -613,13 +944,14 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "computer_id";
         readonly sdkName: "computer_id";
+        readonly description: "Computer id (cmp_...), as returned by computers.create or computers.list.";
     }];
     readonly query: readonly [];
 }, {
     readonly resource: "agent.computers";
     readonly method: "update";
-    readonly summary: "ComputersUpdate";
-    readonly description: "Tenant-owned durable computer resource.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
+    readonly summary: "Update Computer";
+    readonly description: "Rename a computer.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
     readonly http: "POST";
     readonly path: "/agent/v1/computers/{computer_id}";
     readonly streaming: "no";
@@ -627,6 +959,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "computer_id";
         readonly sdkName: "computer_id";
+        readonly description: "Computer id (cmp_...), as returned by computers.create or computers.list.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -641,8 +974,8 @@ export declare const operations: readonly [{
 }, {
     readonly resource: "agent.computers";
     readonly method: "archive";
-    readonly summary: "ComputersArchive";
-    readonly description: "Tenant-owned durable computer resource.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
+    readonly summary: "Archive Computer";
+    readonly description: "Archive a computer: its files stay readable but new sessions cannot use it.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
     readonly http: "POST";
     readonly path: "/agent/v1/computers/{computer_id}/archive";
     readonly streaming: "no";
@@ -650,6 +983,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "computer_id";
         readonly sdkName: "computer_id";
+        readonly description: "Computer id (cmp_...), as returned by computers.create or computers.list.";
     }];
     readonly query: readonly [];
 }, {
@@ -664,6 +998,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "computer_id";
         readonly sdkName: "computer_id";
+        readonly description: "Computer id (cmp_...), as returned by computers.create or computers.list.";
     }];
     readonly query: readonly [{
         readonly name: "name";
@@ -687,6 +1022,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "computer_id";
         readonly sdkName: "computer_id";
+        readonly description: "Computer id (cmp_...), as returned by computers.create or computers.list.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -702,8 +1038,8 @@ export declare const operations: readonly [{
 }, {
     readonly resource: "agent.computers.files";
     readonly method: "list";
-    readonly summary: "ComputersFilesList";
-    readonly description: "Tenant-owned durable computer resource.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
+    readonly summary: "List Computer Files";
+    readonly description: "List the entries of one directory on a computer.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
     readonly http: "GET";
     readonly path: "/agent/v1/computers/{computer_id}/files";
     readonly streaming: "no";
@@ -711,6 +1047,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "computer_id";
         readonly sdkName: "computer_id";
+        readonly description: "Computer id (cmp_...), as returned by computers.create or computers.list.";
     }];
     readonly query: readonly [{
         readonly name: "path";
@@ -721,8 +1058,8 @@ export declare const operations: readonly [{
 }, {
     readonly resource: "agent.computers.files";
     readonly method: "retrieveContent";
-    readonly summary: "ComputersFilesContent";
-    readonly description: "Tenant-owned durable computer resource.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
+    readonly summary: "Get Computer File Content";
+    readonly description: "Download the bytes of one file on a computer, up to 16 MiB, with single-range support.\n\nPraxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.";
     readonly http: "GET";
     readonly path: "/agent/v1/computers/{computer_id}/files/content";
     readonly streaming: "no";
@@ -730,6 +1067,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "computer_id";
         readonly sdkName: "computer_id";
+        readonly description: "Computer id (cmp_...), as returned by computers.create or computers.list.";
     }];
     readonly query: readonly [{
         readonly name: "path";
@@ -749,9 +1087,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "computer_id";
         readonly sdkName: "computer_id";
+        readonly description: "Computer id (cmp_...), as returned by computers.create or computers.list.";
     }, {
         readonly name: "lease_id";
         readonly sdkName: "lease_id";
+        readonly description: "lease_id from the connect response.";
     }];
     readonly query: readonly [];
 }, {
@@ -766,9 +1106,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "computer_id";
         readonly sdkName: "computer_id";
+        readonly description: "Computer id (cmp_...), as returned by computers.create or computers.list.";
     }, {
         readonly name: "lease_id";
         readonly sdkName: "lease_id";
+        readonly description: "lease_id from the connect response.";
     }];
     readonly query: readonly [];
 }, {
@@ -841,6 +1183,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "deployment_run_id";
         readonly sdkName: "deployment_run_id";
+        readonly description: "Deployment run id (drun_...), returned by deployments.run or deployment_runs.list.";
     }];
     readonly query: readonly [];
 }, {
@@ -976,6 +1319,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "deployment_id";
         readonly sdkName: "deployment_id";
+        readonly description: "Deployment id (depl_...), returned by deployments.create or deployments.list.";
     }];
     readonly query: readonly [];
 }, {
@@ -990,6 +1334,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "deployment_id";
         readonly sdkName: "deployment_id";
+        readonly description: "Deployment id (depl_...), returned by deployments.create or deployments.list.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -1066,6 +1411,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "deployment_id";
         readonly sdkName: "deployment_id";
+        readonly description: "Deployment id (depl_...), returned by deployments.create or deployments.list.";
     }];
     readonly query: readonly [];
 }, {
@@ -1080,6 +1426,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "deployment_id";
         readonly sdkName: "deployment_id";
+        readonly description: "Deployment id (depl_...), returned by deployments.create or deployments.list.";
     }];
     readonly query: readonly [];
 }, {
@@ -1094,6 +1441,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "deployment_id";
         readonly sdkName: "deployment_id";
+        readonly description: "Deployment id (depl_...), returned by deployments.create or deployments.list.";
     }];
     readonly query: readonly [];
 }, {
@@ -1108,6 +1456,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "deployment_id";
         readonly sdkName: "deployment_id";
+        readonly description: "Deployment id (depl_...), returned by deployments.create or deployments.list.";
     }];
     readonly query: readonly [];
 }, {
@@ -1276,6 +1625,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Grant id returned by issuance or listing.";
     }];
     readonly query: readonly [];
 }, {
@@ -1309,7 +1659,7 @@ export declare const operations: readonly [{
     readonly resource: "agent.environments";
     readonly method: "create";
     readonly summary: "Create environment";
-    readonly description: "Create a tenant-owned cloud environment: a sandbox recipe (packages to install and networking policy) that sessions can select through environment_id. Package installation happens when the session's sandbox is created; a failed install terminates that session with ENVIRONMENT_PACKAGE_INSTALL_FAILED. Limited networking is applied at sandbox creation. Unlike Anthropic Managed Agents, self_hosted environments, scope and cross-session package caching are not supported.";
+    readonly description: "Create a tenant-owned cloud environment: a sandbox recipe (packages to install and networking policy) that sessions can select through environment_id. Package installation happens when the session's sandbox is created; a failed install terminates that session with ENVIRONMENT_PACKAGE_INSTALL_FAILED. Limited networking is applied at sandbox creation. Unlike Anthropic Managed Agents, self_hosted environments, scope and cross-session package caching are not supported. config.template must name an available sandbox template, otherwise 400 lists the available ones.";
     readonly http: "POST";
     readonly path: "/agent/v1/environments";
     readonly streaming: "no";
@@ -1338,12 +1688,6 @@ export declare const operations: readonly [{
             readonly type: "object";
             readonly required: false;
             readonly description: "Free-form string key/value pairs.";
-        }, {
-            readonly name: "scope";
-            readonly type: "string";
-            readonly enum: readonly ["organization", "account"];
-            readonly required: false;
-            readonly description: "The visibility scope for this environment. 'organization' makes the\nenvironment visible to all accounts. 'account' restricts visibility to the\nowning account only. API organizations support only 'organization'; 'account' is\nrejected. If not specified, defaults based on organization type.";
         }];
     };
 }, {
@@ -1358,13 +1702,14 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "environment_id";
         readonly sdkName: "environment_id";
+        readonly description: "Environment id, as returned by environments.create or environments.list. Built-in environments can be read but not changed.";
     }];
     readonly query: readonly [];
 }, {
     readonly resource: "agent.environments";
     readonly method: "update";
     readonly summary: "Update environment";
-    readonly description: "Update the configuration of a tenant-owned cloud environment. Built-in environments are read-only. Package installation and limited networking are applied when a session's sandbox is created. Omitted fields keep their value.";
+    readonly description: "Update the configuration of a tenant-owned cloud environment. Built-in environments are read-only. Package installation and limited networking are applied when a session's sandbox is created. Omitted fields keep their value. A changed config.template must name an available sandbox template, otherwise 400 lists the available ones.";
     readonly http: "POST";
     readonly path: "/agent/v1/environments/{environment_id}";
     readonly streaming: "no";
@@ -1372,6 +1717,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "environment_id";
         readonly sdkName: "environment_id";
+        readonly description: "Environment id, as returned by environments.create or environments.list. Built-in environments can be read but not changed.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -1396,19 +1742,13 @@ export declare const operations: readonly [{
             readonly type: "string";
             readonly required: false;
             readonly description: "Updated name for the environment";
-        }, {
-            readonly name: "scope";
-            readonly type: "string";
-            readonly enum: readonly ["organization", "account"];
-            readonly required: false;
-            readonly description: "The visibility scope for this environment. 'organization' makes the\nenvironment visible to all accounts. 'account' restricts visibility to the\nowning account only.";
         }];
     };
 }, {
     readonly resource: "agent.environments";
     readonly method: "archive";
     readonly summary: "Archive environment";
-    readonly description: "Soft-archive a tenant-owned cloud environment so it can no longer be used to create new sessions. Built-in environments are read-only and cannot be archived.";
+    readonly description: "Soft-archive a tenant-owned cloud environment so it can no longer be used to create new sessions. Built-in environments are read-only and cannot be archived. An environment that the active version of a non-archived agent uses as environment_id returns 409 RESOURCE_IN_USE naming the agents; point them at another environment first.";
     readonly http: "POST";
     readonly path: "/agent/v1/environments/{environment_id}/archive";
     readonly streaming: "no";
@@ -1416,13 +1756,14 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "environment_id";
         readonly sdkName: "environment_id";
+        readonly description: "Environment id, as returned by environments.create or environments.list. Built-in environments can be read but not changed.";
     }];
     readonly query: readonly [];
 }, {
     readonly resource: "agent.sessions";
     readonly method: "list";
     readonly summary: "List sessions";
-    readonly description: "List sessions of the workspace behind your API key, newest first, in pages of at most 100 (default 20). Unlike Anthropic Managed Agents, only limit, page, agent_id and deployment_id are honored; the other filters declared here (agent_version, created_at ranges, memory_store_id, include_archived, order, statuses) are not supported and return 400. Use the returned id with sessions.retrieve or sessions.events.list; pass next_page as page for the next page.";
+    readonly description: "List sessions of the workspace behind your API key, newest first, in pages of at most 100 (default 20). Archived sessions are hidden unless include_archived is true. Unlike Anthropic Managed Agents, only limit, page, agent_id, deployment_id and include_archived are honored; the other filters declared here (agent_version, created_at ranges, memory_store_id, order, statuses) are not supported and return 400. Use the returned id with sessions.retrieve or sessions.events.list; pass next_page as page for the next page.";
     readonly http: "GET";
     readonly path: "/agent/v1/sessions";
     readonly streaming: "no";
@@ -1447,7 +1788,7 @@ export declare const operations: readonly [{
         readonly name: "created_at[gte]";
         readonly type: "string";
         readonly required: false;
-        readonly description: "Created-at lower bound for sessions. Declared by the Managed Agents shape but not supported here: sessions.list honors only limit, page, agent_id and deployment_id, and other filters return 400.";
+        readonly description: "Created-at lower bound for sessions. Declared by the Managed Agents shape but not supported here: sessions.list honors only limit, page, agent_id, deployment_id and include_archived, and other filters return 400.";
     }, {
         readonly name: "created_at[lt]";
         readonly type: "string";
@@ -1457,7 +1798,7 @@ export declare const operations: readonly [{
         readonly name: "created_at[lte]";
         readonly type: "string";
         readonly required: false;
-        readonly description: "Created-at upper bound for sessions. Declared by the Managed Agents shape but not supported here: sessions.list honors only limit, page, agent_id and deployment_id, and other filters return 400.";
+        readonly description: "Created-at upper bound for sessions. Declared by the Managed Agents shape but not supported here: sessions.list honors only limit, page, agent_id, deployment_id and include_archived, and other filters return 400.";
     }, {
         readonly name: "deployment_id";
         readonly type: "string";
@@ -1468,7 +1809,7 @@ export declare const operations: readonly [{
         readonly type: "boolean";
         readonly enum: readonly [false, true];
         readonly required: false;
-        readonly description: "Declared by the Managed Agents shape but not supported by sessions.list; sending it returns 400. Archived sessions are retrievable by id.";
+        readonly description: "Whether archived sessions are listed: true includes them, false (the default) hides them. A value other than true or false returns 400. Archived sessions stay retrievable by id either way.";
     }, {
         readonly name: "memory_store_id";
         readonly type: "string";
@@ -1513,7 +1854,7 @@ export declare const operations: readonly [{
     readonly resource: "agent.sessions";
     readonly method: "create";
     readonly summary: "Create session";
-    readonly description: "Create a session: one conversation with an agent. Pass agent as an agent id (active_version) or {id, version, type:\"agent\"}. Unlike Anthropic Managed Agents, omit environment_id to get a light machine, unless computer_id (explicit, or the agent's default) selects a Computer; pass an environment id for a sandbox recipe. For service agents, omission returns environment_id=light; explicit null allocates no machine, so codemode, bash and other machine tools are unavailable. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|max|none} or null, where null inherits the agent default and then the model default (none requires the model to allow disabling thinking). Selections are saved before initial_events run; invalid ones return 400 invalid_request_error. Inline agent overrides are not supported. Supports vault_ids, up to 50, owned by the current organization and not archived; credential injection is deferred to a later version. Omitted budget defaults to USD 20; null removes the limit, and a limit object uses a positive integer string of USD cents. Up to 500 file resources can be attached. Use initial_events to send a first user.message in this request, or send messages afterwards with sessions.events.send. The returned status can still be idle before initial events run; read agent.message and the subsequent session.status_idle event to confirm completion.";
+    readonly description: "Create a session: one conversation with an agent. Pass agent as an agent id or {type:\"agent\", id, version?}; an id alone, or an object without version, pins the agent's active_version (the version chosen with agents.versions.apply, not necessarily the newest saved one). Unlike Anthropic Managed Agents, omit environment_id to use the default environment saved in the agent version (light for a new agent), unless computer_id (explicit, or the agent's default) selects a Computer; pass an environment id for a sandbox recipe. For service agents, explicit null allocates no machine, so codemode, bash and other machine tools are unavailable. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|max|none} or null, where null inherits the agent default and then the model default (none requires the model to allow disabling thinking). Selections are saved before initial_events run; invalid ones return 400 invalid_request_error. Unlike Anthropic Managed Agents, the only inline agent override is system ({type:\"agent_with_overrides\", id, system}); to change the model, tools, MCP servers or skills, save a version instead. Supports vault_ids, up to 50, owned by the current organization and not archived; credential injection is deferred to a later version. budget is {type:\"limit\", max_list_cost:{amount, currency:\"USD\"}} where amount is a positive integer string of US cents (\"2000\" is USD 20.00); omitted budget defaults to \"2000\" and null removes the limit. Up to 500 file resources can be attached. Use initial_events to send a first user.message in this request, or send messages afterwards with sessions.events.send. The returned status can still be idle before initial events run; read agent.message and the subsequent session.status_idle event to confirm completion.";
     readonly http: "POST";
     readonly path: "/agent/v1/sessions";
     readonly streaming: "no";
@@ -1526,17 +1867,17 @@ export declare const operations: readonly [{
             readonly name: "agent";
             readonly type: "object";
             readonly required: true;
-            readonly description: "Agent identifier. Accepts the `agent` ID string, which pins the\nlatest version for the session, or an `agent` object with both id and version\nspecified.";
+            readonly description: "The agent to run: an agent id string, or {type: \"agent\", id, version?}. An id alone, or an object without version, pins the agent's active_version at the moment the session is created (the version chosen with agents.versions.apply, not necessarily the newest saved one); version pins that exact version. Unlike Managed Agents, the only inline override is a system prompt ({type: \"agent_with_overrides\", id, system}); to change the model, tools, MCP servers or skills, save a version instead.";
         }, {
             readonly name: "environment_id";
             readonly type: "string";
             readonly required: false;
-            readonly description: "Execution environment id from agent.environments.list or agent.environments.create. For a service agent, omission selects the built-in light environment and returns session.environment_id=light; explicit null allocates no machine and makes machine tools, including codemode and bash, unavailable. Personal agents use their selected Computer.";
+            readonly description: "Execution environment id from agent.environments.list or agent.environments.create. For a service agent, omission uses the default environment saved in the agent version (light for a new agent) and returns it as session.environment_id; explicit null allocates no machine and makes machine tools, including codemode and bash, unavailable. Personal agents use their selected Computer.";
         }, {
             readonly name: "budget";
             readonly type: "object";
             readonly required: false;
-            readonly description: "Session spending limit in USD cents; null when unlimited. Creation defaults to USD 20 when omitted. A limit amount is a positive integer string; removing a limit with null prevents setting it again for that session.";
+            readonly description: "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.";
         }, {
             readonly name: "initial_events";
             readonly type: "array";
@@ -1604,6 +1945,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [];
 }, {
@@ -1618,6 +1960,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [];
 }, {
@@ -1632,16 +1975,12 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [];
     readonly body: {
         readonly required: true;
         readonly fields: readonly [{
-            readonly name: "agent";
-            readonly type: "object";
-            readonly required: false;
-            readonly description: "Agent definition the session uses after the change; null when unchanged.";
-        }, {
             readonly name: "budget";
             readonly type: "object";
             readonly required: false;
@@ -1686,6 +2025,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [];
 }, {
@@ -1700,6 +2040,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [];
 }, {
@@ -1714,9 +2055,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }, {
         readonly name: "task_id";
         readonly sdkName: "task_id";
+        readonly description: "Background task id (task_...), as listed by sessions.background_tasks.list.";
     }];
     readonly query: readonly [{
         readonly name: "offset";
@@ -1741,9 +2084,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }, {
         readonly name: "task_id";
         readonly sdkName: "task_id";
+        readonly description: "Background task id (task_...), as listed by sessions.background_tasks.list.";
     }];
     readonly query: readonly [];
 }, {
@@ -1758,6 +2103,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -1781,9 +2127,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }, {
         readonly name: "operation_id";
         readonly sdkName: "operation_id";
+        readonly description: "Compaction operation id returned by sessions.compact in the id field of the session_compaction object.";
     }];
     readonly query: readonly [];
 }, {
@@ -1798,6 +2146,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [];
 }, {
@@ -1812,6 +2161,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [];
 }, {
@@ -1826,6 +2176,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [{
         readonly name: "created_at[gt]";
@@ -1882,6 +2233,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -1906,6 +2258,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [{
         readonly name: "event_deltas";
@@ -1927,6 +2280,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -1950,6 +2304,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -1974,6 +2329,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [{
         readonly name: "type";
@@ -2008,9 +2364,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }, {
         readonly name: "resource_id";
         readonly sdkName: "resource_id";
+        readonly description: "Id of a resource attached to the session, as returned by sessions.resources.add or sessions.resources.list.";
     }];
     readonly query: readonly [{
         readonly name: "session_id";
@@ -2031,9 +2389,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }, {
         readonly name: "resource_id";
         readonly sdkName: "resource_id";
+        readonly description: "Id of a resource attached to the session, as returned by sessions.resources.add or sessions.resources.list.";
     }];
     readonly query: readonly [{
         readonly name: "session_id";
@@ -2054,9 +2414,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "Session id from session creation or listing.";
     }, {
         readonly name: "run_id";
         readonly sdkName: "run_id";
+        readonly description: "Existing run_id from this session's events.";
     }];
     readonly query: readonly [];
 }, {
@@ -2071,9 +2433,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "Session id from session creation or listing.";
     }, {
         readonly name: "run_id";
         readonly sdkName: "run_id";
+        readonly description: "Existing run_id from this session's events.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -2103,6 +2467,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -2127,9 +2492,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }, {
         readonly name: "thread_id";
         readonly sdkName: "thread_id";
+        readonly description: "Execution thread id (sthr_...), as listed by sessions.threads.list; the primary thread id equals the session's own thread. Unknown or foreign ids return 404.";
     }];
     readonly query: readonly [{
         readonly name: "session_id";
@@ -2150,9 +2517,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }, {
         readonly name: "thread_id";
         readonly sdkName: "thread_id";
+        readonly description: "Execution thread id (sthr_...), as listed by sessions.threads.list; the primary thread id equals the session's own thread. Unknown or foreign ids return 404.";
     }];
     readonly query: readonly [{
         readonly name: "session_id";
@@ -2173,9 +2542,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }, {
         readonly name: "thread_id";
         readonly sdkName: "thread_id";
+        readonly description: "Execution thread id (sthr_...), as listed by sessions.threads.list; the primary thread id equals the session's own thread. Unknown or foreign ids return 404.";
     }];
     readonly query: readonly [{
         readonly name: "session_id";
@@ -2206,9 +2577,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "session_id";
         readonly sdkName: "session_id";
+        readonly description: "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.";
     }, {
         readonly name: "thread_id";
         readonly sdkName: "thread_id";
+        readonly description: "Execution thread id (sthr_...), as listed by sessions.threads.list; the primary thread id equals the session's own thread. Unknown or foreign ids return 404.";
     }];
     readonly query: readonly [{
         readonly name: "session_id";
@@ -2254,7 +2627,7 @@ export declare const operations: readonly [{
     readonly resource: "agent.skills";
     readonly method: "create";
     readonly summary: "Create skill";
-    readonly description: "Upload a skill: a directory that contains SKILL.md, which the agent reads when it needs the skill. Send multipart/form-data with one files part per file, each file name being its path under one top-level directory (pdf/SKILL.md, pdf/scripts/run.py), and an optional display_name. SKILL.md frontmatter needs a description; name defaults to the directory name. Limits: 8 MB in total, at most 200 files, no .. segments, absolute paths or empty names; a violation returns 400 naming the path or field. The upload creates the skill and its first version, and versions are immutable. Attach the skill to an agent with `skills` on the agent.";
+    readonly description: "Upload a skill: a directory that contains SKILL.md, which the agent reads when it needs the skill. Send multipart/form-data with one files part per file, each file name being its path under one top-level directory (pdf/SKILL.md, pdf/scripts/run.py), and an optional display_name. SKILL.md frontmatter needs a description; name defaults to the directory name and must be one folder name (1-255 characters, no \"/\", backslash or NUL, not \".\" or \"..\"), otherwise the upload returns 400 stating the allowed form. Limits: 8 MB in total, at most 200 files, no .. segments, absolute paths or empty names; a violation returns 400 naming the path or field. The upload creates the skill and its first version, and versions are immutable. Attach the skill to an agent with `skills` on the agent.";
     readonly http: "POST";
     readonly path: "/agent/v1/skills";
     readonly streaming: "no";
@@ -2281,7 +2654,7 @@ export declare const operations: readonly [{
     readonly resource: "agent.skills";
     readonly method: "delete";
     readonly summary: "Delete skill";
-    readonly description: "Delete a skill that has no live versions. A skill that still has versions returns 409 Delete all versions first; remove each with skills.versions.delete, then call this. Returns {id, type: skill_deleted}. skill_id comes from skills.create or skills.list.";
+    readonly description: "Delete a skill together with all of its versions. A skill that is still attached to an agent returns 409 RESOURCE_IN_USE naming up to 10 agent ids (the active or latest version of a non-archived agent counts); remove it from those agents first. Returns {id, type: skill_deleted}. skill_id comes from skills.create or skills.list.";
     readonly http: "DELETE";
     readonly path: "/agent/v1/skills/{skill_id}";
     readonly streaming: "no";
@@ -2289,6 +2662,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "skill_id";
         readonly sdkName: "skill_id";
+        readonly description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -2303,6 +2677,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "skill_id";
         readonly sdkName: "skill_id";
+        readonly description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -2317,6 +2692,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "skill_id";
         readonly sdkName: "skill_id";
+        readonly description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404.";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -2342,6 +2718,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "skill_id";
         readonly sdkName: "skill_id";
+        readonly description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -2358,7 +2735,7 @@ export declare const operations: readonly [{
     readonly resource: "agent.skills.versions";
     readonly method: "delete";
     readonly summary: "Delete skill version";
-    readonly description: "Soft-delete one version of a skill so it can no longer be read or downloaded; latest_version_id of the skill falls back to the newest remaining version. Returns {id, type: skill_version_deleted}. A skill can be deleted only after all of its versions are deleted.";
+    readonly description: "Soft-delete one version of a skill so it can no longer be read or downloaded; latest_version_id of the skill falls back to the newest remaining version. Returns {id, type: skill_version_deleted}. A skill keeps at least one version: deleting the last remaining version returns 409 SKILL_LAST_VERSION (delete the skill instead), so latest_version_id is never null. A version that a non-archived agent pins returns 409 RESOURCE_IN_USE naming the agents.";
     readonly http: "DELETE";
     readonly path: "/agent/v1/skills/{skill_id}/versions/{version}";
     readonly streaming: "no";
@@ -2366,9 +2743,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "skill_id";
         readonly sdkName: "skill_id";
+        readonly description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404.";
     }, {
         readonly name: "version";
         readonly sdkName: "version";
+        readonly description: "Skill version id, as returned by skills.versions.create or skills.versions.list; an opaque string that increases with each upload.";
     }];
     readonly query: readonly [];
 }, {
@@ -2383,9 +2762,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "skill_id";
         readonly sdkName: "skill_id";
+        readonly description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404.";
     }, {
         readonly name: "version";
         readonly sdkName: "version";
+        readonly description: "Skill version id, as returned by skills.versions.create or skills.versions.list; an opaque string that increases with each upload.";
     }];
     readonly query: readonly [];
 }, {
@@ -2400,9 +2781,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "skill_id";
         readonly sdkName: "skill_id";
+        readonly description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404.";
     }, {
         readonly name: "version";
         readonly sdkName: "version";
+        readonly description: "Skill version id, as returned by skills.versions.create or skills.versions.list; an opaque string that increases with each upload.";
     }];
     readonly query: readonly [];
 }, {
@@ -2551,6 +2934,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [];
 }, {
@@ -2565,6 +2949,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [{
         readonly name: "expand";
@@ -2584,6 +2969,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -2628,6 +3014,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -2651,6 +3038,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [];
 }, {
@@ -2665,6 +3053,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [{
         readonly name: "cursor";
@@ -2689,6 +3078,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -2729,9 +3119,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }, {
         readonly name: "deployment_id";
         readonly sdkName: "deployment_id";
+        readonly description: "ID from the id of CreateDeployment or ListDeployments, prefixed dep_.";
     }];
     readonly query: readonly [];
 }, {
@@ -2746,6 +3138,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [{
         readonly name: "after_seq";
@@ -2770,6 +3163,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [];
 }, {
@@ -2784,6 +3178,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -2813,9 +3208,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }, {
         readonly name: "grant_id";
         readonly sdkName: "grant_id";
+        readonly description: "Grant ID (grt_…).";
     }];
     readonly query: readonly [];
 }, {
@@ -2830,6 +3227,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [];
 }, {
@@ -2844,6 +3242,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [];
 }, {
@@ -2858,9 +3257,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Secret name as seen in the Worker's env: 1–64 letters, digits or underscores, not starting with a digit.";
     }];
     readonly query: readonly [];
 }, {
@@ -2875,9 +3276,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Secret name as seen in the Worker's env: 1–64 letters, digits or underscores, not starting with a digit.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -2901,6 +3304,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [{
         readonly name: "cursor";
@@ -2925,6 +3329,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -2991,9 +3396,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }, {
         readonly name: "version_id";
         readonly sdkName: "version_id";
+        readonly description: "Version ID (ver_…).";
     }];
     readonly query: readonly [];
 }, {
@@ -3008,9 +3415,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "worker_id";
         readonly sdkName: "worker_id";
+        readonly description: "Worker ID (wkr_…).";
     }, {
         readonly name: "version_id";
         readonly sdkName: "version_id";
+        readonly description: "Version ID from versions.list or the active deployment.";
     }];
     readonly query: readonly [];
 }, {
@@ -3162,9 +3571,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
 }, {
@@ -3179,9 +3590,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [{
         readonly name: "dry_run";
@@ -3251,9 +3664,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -3272,9 +3687,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -3299,9 +3716,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -3354,9 +3773,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -3375,9 +3796,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -3408,12 +3831,15 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }, {
         readonly name: "revision";
         readonly sdkName: "revision";
+        readonly description: "Action revision ID (actr_); the query parameter filters invocation records.";
     }];
     readonly query: readonly [];
 }, {
@@ -3428,9 +3854,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -3459,9 +3887,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "trigger_id";
         readonly sdkName: "trigger_id";
+        readonly description: "Trigger ID (trg_).";
     }, {
         readonly name: "token";
         readonly sdkName: "token";
+        readonly description: "Secret URL token returned on creation or rotation; do not disclose it.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -3622,6 +4052,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [{
         readonly name: "expand";
@@ -3648,6 +4079,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -3672,6 +4104,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -3696,6 +4129,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -3719,6 +4153,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -3743,6 +4178,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -3767,6 +4203,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -3790,6 +4227,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -3808,6 +4246,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [];
 }, {
@@ -3822,6 +4261,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -3840,6 +4280,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -3876,6 +4317,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -3900,9 +4342,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Run ID (run_).";
     }, {
         readonly name: "wait_id";
         readonly sdkName: "wait_id";
+        readonly description: "Wait ID (wait_) belonging to this run.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -4030,9 +4474,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
 }, {
@@ -4047,9 +4493,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -4083,9 +4531,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -4104,9 +4554,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
 }, {
@@ -4121,12 +4573,15 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }, {
         readonly name: "tag";
         readonly sdkName: "tag";
+        readonly description: "Distribution tag. A prerelease (such as 1.3.0-beta.1) requires a tag and it cannot be latest; a tag may only use URL-safe characters (letters, digits and - _ . ! ~ * ' ( )), no spaces or / ? # and no leading or trailing whitespace; it cannot be a version or a version range (such as 1.2.3, ^1, 1.x, *); any other name such as beta, next or debug is allowed. Violations return TAG_INVALID or TAG_REQUIRED with the complete rules in hint.";
     }];
     readonly query: readonly [];
 }, {
@@ -4141,12 +4596,15 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }, {
         readonly name: "tag";
         readonly sdkName: "tag";
+        readonly description: "Distribution tag. A prerelease (such as 1.3.0-beta.1) requires a tag and it cannot be latest; a tag may only use URL-safe characters (letters, digits and - _ . ! ~ * ' ( )), no spaces or / ? # and no leading or trailing whitespace; it cannot be a version or a version range (such as 1.2.3, ^1, 1.x, *); any other name such as beta, next or debug is allowed. Violations return TAG_INVALID or TAG_REQUIRED with the complete rules in hint.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -4170,9 +4628,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -4191,9 +4651,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -4225,9 +4687,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -4246,12 +4710,15 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }, {
         readonly name: "version";
         readonly sdkName: "version";
+        readonly description: "Exact version or dist-tag; ranges are rejected with 400 and a hint.";
     }];
     readonly query: readonly [];
 }, {
@@ -4266,12 +4733,15 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }, {
         readonly name: "version";
         readonly sdkName: "version";
+        readonly description: "An exact canonical semantic version, such as 1.2.0 or 1.3.0-beta.1, not a range.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -4516,6 +4986,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Trigger ID (trg_).";
     }];
     readonly query: readonly [];
 }, {
@@ -4530,6 +5001,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Trigger ID (trg_).";
     }];
     readonly query: readonly [];
 }, {
@@ -4544,6 +5016,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Trigger ID (trg_).";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -4629,6 +5102,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Trigger ID (trg_).";
     }];
     readonly query: readonly [];
 }, {
@@ -4643,6 +5117,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Trigger ID (trg_).";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -4679,6 +5154,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Trigger ID (trg_).";
     }];
     readonly query: readonly [];
 }, {
@@ -4693,6 +5169,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Trigger ID (trg_).";
     }];
     readonly query: readonly [];
 }, {
@@ -4707,6 +5184,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Trigger ID (trg_).";
     }];
     readonly query: readonly [];
 }, {
@@ -4846,9 +5324,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
 }, {
@@ -4863,9 +5343,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -4899,9 +5381,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -4920,9 +5404,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
 }, {
@@ -4937,12 +5423,15 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }, {
         readonly name: "tag";
         readonly sdkName: "tag";
+        readonly description: "Distribution tag. A prerelease (such as 1.3.0-beta.1) requires a tag and it cannot be latest; a tag may only use URL-safe characters (letters, digits and - _ . ! ~ * ' ( )), no spaces or / ? # and no leading or trailing whitespace; it cannot be a version or a version range (such as 1.2.3, ^1, 1.x, *); any other name such as beta, next or debug is allowed. Violations return TAG_INVALID or TAG_REQUIRED with the complete rules in hint.";
     }];
     readonly query: readonly [];
 }, {
@@ -4957,12 +5446,15 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }, {
         readonly name: "tag";
         readonly sdkName: "tag";
+        readonly description: "Distribution tag. A prerelease (such as 1.3.0-beta.1) requires a tag and it cannot be latest; a tag may only use URL-safe characters (letters, digits and - _ . ! ~ * ' ( )), no spaces or / ? # and no leading or trailing whitespace; it cannot be a version or a version range (such as 1.2.3, ^1, 1.x, *); any other name such as beta, next or debug is allowed. Violations return TAG_INVALID or TAG_REQUIRED with the complete rules in hint.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -4986,9 +5478,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -5007,9 +5501,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -5041,9 +5537,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -5062,12 +5560,15 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }, {
         readonly name: "version";
         readonly sdkName: "version";
+        readonly description: "Exact version or dist-tag; ranges are rejected with 400 and a hint.";
     }];
     readonly query: readonly [];
 }, {
@@ -5082,12 +5583,15 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "ns";
         readonly sdkName: "ns";
+        readonly description: "Namespace, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}. praxis is reserved for built-in Actions.";
     }, {
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Name, folded to lowercase; matches [a-z0-9][a-z0-9._-]{0,63} for existing references, including historical dotted names; new names must match [a-z0-9][a-z0-9_-]{0,63}.";
     }, {
         readonly name: "version";
         readonly sdkName: "version";
+        readonly description: "An exact canonical semantic version, such as 1.2.0 or 1.3.0-beta.1, not a range.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -5218,6 +5722,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "contextId";
         readonly sdkName: "contextId";
+        readonly description: "登录态 ID；使用创建或列出登录态返回的 id，以 bsc_ 开头。";
     }];
     readonly query: readonly [];
 }, {
@@ -5232,6 +5737,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "contextId";
         readonly sdkName: "contextId";
+        readonly description: "登录态 ID；使用创建或列出登录态返回的 id，以 bsc_ 开头。";
     }];
     readonly query: readonly [];
 }, {
@@ -5246,6 +5752,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "contextId";
         readonly sdkName: "contextId";
+        readonly description: "登录态 ID；使用创建或列出登录态返回的 id，以 bsc_ 开头。";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -5274,9 +5781,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sessionId";
         readonly sdkName: "sessionId";
+        readonly description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。";
     }, {
         readonly name: "pageId";
         readonly sdkName: "pageId";
+        readonly description: "实时观看地址中的标签页 ID；使用 debug 返回链接中的原值，_ 表示会话级画面。";
     }];
     readonly query: readonly [{
         readonly name: "t";
@@ -5414,6 +5923,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sessionId";
         readonly sdkName: "sessionId";
+        readonly description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。";
     }];
     readonly query: readonly [{
         readonly name: "expand";
@@ -5433,6 +5943,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sessionId";
         readonly sdkName: "sessionId";
+        readonly description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -5457,6 +5968,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sessionId";
         readonly sdkName: "sessionId";
+        readonly description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。";
     }];
     readonly query: readonly [];
 }, {
@@ -5471,6 +5983,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sessionId";
         readonly sdkName: "sessionId";
+        readonly description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。";
     }];
     readonly query: readonly [{
         readonly name: "cursor";
@@ -5500,6 +6013,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sessionId";
         readonly sdkName: "sessionId";
+        readonly description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -5528,6 +6042,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sessionId";
         readonly sdkName: "sessionId";
+        readonly description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。";
     }];
     readonly query: readonly [];
 }, {
@@ -5542,6 +6057,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sessionId";
         readonly sdkName: "sessionId";
+        readonly description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。";
     }];
     readonly query: readonly [];
 }, {
@@ -5556,6 +6072,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sessionId";
         readonly sdkName: "sessionId";
+        readonly description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -5636,6 +6153,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }];
     readonly query: readonly [];
 }, {
@@ -5650,6 +6168,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }];
     readonly query: readonly [];
 }, {
@@ -5664,6 +6183,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -5692,6 +6212,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }];
     readonly query: readonly [{
         readonly name: "after_seq";
@@ -5727,6 +6248,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }];
     readonly query: readonly [];
 }, {
@@ -5741,9 +6263,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }, {
         readonly name: "table";
         readonly sdkName: "table";
+        readonly description: "table ID or name.";
     }];
     readonly query: readonly [{
         readonly name: "select";
@@ -5813,9 +6337,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }, {
         readonly name: "table";
         readonly sdkName: "table";
+        readonly description: "table ID or name.";
     }];
     readonly query: readonly [{
         readonly name: "select";
@@ -5885,9 +6411,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }, {
         readonly name: "table";
         readonly sdkName: "table";
+        readonly description: "table ID or name.";
     }];
     readonly query: readonly [{
         readonly name: "select";
@@ -5957,9 +6485,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }, {
         readonly name: "table";
         readonly sdkName: "table";
+        readonly description: "table ID or name.";
     }];
     readonly query: readonly [{
         readonly name: "select";
@@ -6033,9 +6563,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }, {
         readonly name: "table";
         readonly sdkName: "table";
+        readonly description: "table ID or name.";
     }];
     readonly query: readonly [{
         readonly name: "select";
@@ -6109,6 +6641,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }];
     readonly query: readonly [];
 }, {
@@ -6123,6 +6656,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }];
     readonly query: readonly [];
 }, {
@@ -6137,6 +6671,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -6171,9 +6706,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }, {
         readonly name: "table";
         readonly sdkName: "table";
+        readonly description: "table ID or name.";
     }];
     readonly query: readonly [];
 }, {
@@ -6188,9 +6725,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }, {
         readonly name: "table";
         readonly sdkName: "table";
+        readonly description: "table ID or name.";
     }];
     readonly query: readonly [];
 }, {
@@ -6205,9 +6744,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }, {
         readonly name: "table";
         readonly sdkName: "table";
+        readonly description: "table ID or name.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -6236,9 +6777,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }, {
         readonly name: "table";
         readonly sdkName: "table";
+        readonly description: "table ID or name.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -6257,12 +6800,15 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }, {
         readonly name: "table";
         readonly sdkName: "table";
+        readonly description: "table ID or name.";
     }, {
         readonly name: "field";
         readonly sdkName: "field";
+        readonly description: "field ID or name.";
     }];
     readonly query: readonly [];
 }, {
@@ -6277,12 +6823,15 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "database_id";
         readonly sdkName: "database_id";
+        readonly description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted.";
     }, {
         readonly name: "table";
         readonly sdkName: "table";
+        readonly description: "table ID or name.";
     }, {
         readonly name: "field";
         readonly sdkName: "field";
+        readonly description: "field ID or name.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -6410,6 +6959,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "file_id";
         readonly sdkName: "file_id";
+        readonly description: "ID of a tenant-owned live file, as returned by upload or list; starts with file-.";
     }];
     readonly query: readonly [];
 }, {
@@ -6424,6 +6974,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "file_id";
         readonly sdkName: "file_id";
+        readonly description: "ID of a tenant-owned live file, as returned by upload or list; starts with file-.";
     }];
     readonly query: readonly [];
 }, {
@@ -6438,6 +6989,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "file_id";
         readonly sdkName: "file_id";
+        readonly description: "ID of a tenant-owned live file, as returned by upload or list; starts with file-.";
     }];
     readonly query: readonly [];
 }, {
@@ -6498,6 +7050,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "upload_id";
         readonly sdkName: "upload_id";
+        readonly description: "Upload identifier returned by create; belongs to your organization.";
     }];
     readonly query: readonly [];
 }, {
@@ -6512,6 +7065,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "upload_id";
         readonly sdkName: "upload_id";
+        readonly description: "Upload identifier returned by create; belongs to your organization.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -6542,6 +7096,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "upload_id";
         readonly sdkName: "upload_id";
+        readonly description: "Upload identifier returned by create; belongs to your organization.";
     }];
     readonly query: readonly [{
         readonly name: "part_number";
@@ -6659,6 +7214,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }];
     readonly query: readonly [];
 }, {
@@ -6673,6 +7229,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }];
     readonly query: readonly [{
         readonly name: "expand";
@@ -6701,6 +7258,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -6739,6 +7297,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }];
     readonly query: readonly [{
         readonly name: "after_seq";
@@ -6763,6 +7322,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -6781,9 +7341,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }, {
         readonly name: "batch_id";
         readonly sdkName: "batch_id";
+        readonly description: "File-batch ID returned by batch creation in this knowledge base.";
     }];
     readonly query: readonly [];
 }, {
@@ -6798,9 +7360,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }, {
         readonly name: "batch_id";
         readonly sdkName: "batch_id";
+        readonly description: "File-batch ID returned by batch creation in this knowledge base.";
     }];
     readonly query: readonly [];
 }, {
@@ -6815,9 +7379,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }, {
         readonly name: "batch_id";
         readonly sdkName: "batch_id";
+        readonly description: "File-batch ID returned by batch creation in this knowledge base.";
     }];
     readonly query: readonly [{
         readonly name: "after";
@@ -6859,6 +7425,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }];
     readonly query: readonly [{
         readonly name: "after";
@@ -6900,6 +7467,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -6933,9 +7501,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }, {
         readonly name: "file_id";
         readonly sdkName: "file_id";
+        readonly description: "Source File ID of an attachment, returned by file attachment or listing.";
     }];
     readonly query: readonly [];
 }, {
@@ -6950,9 +7520,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }, {
         readonly name: "file_id";
         readonly sdkName: "file_id";
+        readonly description: "Source File ID of an attachment, returned by file attachment or listing.";
     }];
     readonly query: readonly [];
 }, {
@@ -6967,9 +7539,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }, {
         readonly name: "file_id";
         readonly sdkName: "file_id";
+        readonly description: "Source File ID of an attachment, returned by file attachment or listing.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -6993,9 +7567,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }, {
         readonly name: "file_id";
         readonly sdkName: "file_id";
+        readonly description: "Source File ID of an attachment, returned by file attachment or listing.";
     }];
     readonly query: readonly [];
 }, {
@@ -7010,9 +7586,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }, {
         readonly name: "file_id";
         readonly sdkName: "file_id";
+        readonly description: "Source File ID of an attachment, returned by file attachment or listing.";
     }];
     readonly query: readonly [];
 }, {
@@ -7027,9 +7605,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }, {
         readonly name: "file_id";
         readonly sdkName: "file_id";
+        readonly description: "Source File ID of an attachment, returned by file attachment or listing.";
     }];
     readonly query: readonly [{
         readonly name: "after";
@@ -7065,6 +7645,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }];
     readonly query: readonly [];
 }, {
@@ -7079,6 +7660,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }];
     readonly query: readonly [];
 }, {
@@ -7093,6 +7675,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -7146,9 +7729,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vector_store_id";
         readonly sdkName: "vector_store_id";
+        readonly description: "Knowledge-base ID returned by create or list; use the ID rather than its display name.";
     }, {
         readonly name: "chunk_id";
         readonly sdkName: "chunk_id";
+        readonly description: "Chunk ID returned by segment listing or native search content.";
     }];
     readonly query: readonly [];
 }, {
@@ -7230,6 +7815,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
 }, {
@@ -7244,6 +7830,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
 }, {
@@ -7258,6 +7845,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -7296,6 +7884,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [{
         readonly name: "asset_folder";
@@ -7332,6 +7921,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -7421,6 +8011,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -7509,9 +8100,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }, {
         readonly name: "asset_id";
         readonly sdkName: "asset_id";
+        readonly description: "32-character asset ID.";
     }];
     readonly query: readonly [];
 }, {
@@ -7526,9 +8119,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }, {
         readonly name: "asset_id";
         readonly sdkName: "asset_id";
+        readonly description: "32-character asset ID.";
     }];
     readonly query: readonly [];
 }, {
@@ -7543,9 +8138,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }, {
         readonly name: "asset_id";
         readonly sdkName: "asset_id";
+        readonly description: "32-character asset ID.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -7585,9 +8182,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }, {
         readonly name: "asset_id";
         readonly sdkName: "asset_id";
+        readonly description: "32-character asset ID.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -7613,9 +8212,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }, {
         readonly name: "asset_id";
         readonly sdkName: "asset_id";
+        readonly description: "32-character asset ID.";
     }];
     readonly query: readonly [{
         readonly name: "include_superseded";
@@ -7651,6 +8252,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -7674,6 +8276,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -7697,9 +8300,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }, {
         readonly name: "job_id";
         readonly sdkName: "job_id";
+        readonly description: "Batch identifier returned by createBatch or batchAssets; resolved within this library.";
     }];
     readonly query: readonly [];
 }, {
@@ -7714,6 +8319,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [{
         readonly name: "after_seq";
@@ -7749,6 +8355,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [{
         readonly name: "parent";
@@ -7768,9 +8375,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }, {
         readonly name: "job_id";
         readonly sdkName: "job_id";
+        readonly description: "Batch identifier returned by createBatch or batchAssets; resolved within this library.";
     }];
     readonly query: readonly [];
 }, {
@@ -7785,6 +8394,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
 }, {
@@ -7799,6 +8409,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
 }, {
@@ -7813,6 +8424,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -7852,6 +8464,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -7905,6 +8518,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -7944,6 +8558,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "library_id";
         readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -8019,6 +8634,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Exact method name from the search results, for example `praxis.database.databases.tables.create`.";
     }];
     readonly query: readonly [];
 }, {
@@ -8525,6 +9141,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "conversation_id";
         readonly sdkName: "conversation_id";
+        readonly description: "Id of the conversation, the `id` of the object returned by createConversation (it looks like conv_...). Another tenant's conversation, an unknown id and a deleted conversation all answer 404 conversation_not_found.";
     }];
     readonly query: readonly [];
 }, {
@@ -8539,6 +9156,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "conversation_id";
         readonly sdkName: "conversation_id";
+        readonly description: "Id of the conversation, the `id` of the object returned by createConversation (it looks like conv_...). Another tenant's conversation, an unknown id and a deleted conversation all answer 404 conversation_not_found.";
     }];
     readonly query: readonly [];
 }, {
@@ -8553,6 +9171,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "conversation_id";
         readonly sdkName: "conversation_id";
+        readonly description: "Id of the conversation, the `id` of the object returned by createConversation (it looks like conv_...). Another tenant's conversation, an unknown id and a deleted conversation all answer 404 conversation_not_found.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -8576,6 +9195,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "conversation_id";
         readonly sdkName: "conversation_id";
+        readonly description: "Id of the conversation, the `id` of the object returned by createConversation (it looks like conv_...). Another tenant's conversation, an unknown id and a deleted conversation all answer 404 conversation_not_found.";
     }];
     readonly query: readonly [];
 }, {
@@ -8590,6 +9210,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "conversation_id";
         readonly sdkName: "conversation_id";
+        readonly description: "Id of the conversation, the `id` of the object returned by createConversation (it looks like conv_...). Another tenant's conversation, an unknown id and a deleted conversation all answer 404 conversation_not_found.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -8614,9 +9235,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "conversation_id";
         readonly sdkName: "conversation_id";
+        readonly description: "Id of the conversation, the `id` of the object returned by createConversation (it looks like conv_...). Another tenant's conversation, an unknown id and a deleted conversation all answer 404 conversation_not_found.";
     }, {
         readonly name: "item_id";
         readonly sdkName: "item_id";
+        readonly description: "Id of the item to delete, from the `id` of an item returned by createConversationItems or listConversationItems. An id that is not in the conversation answers 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -8631,9 +9254,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "conversation_id";
         readonly sdkName: "conversation_id";
+        readonly description: "Id of the conversation, the `id` of the object returned by createConversation (it looks like conv_...). Another tenant's conversation, an unknown id and a deleted conversation all answer 404 conversation_not_found.";
     }, {
         readonly name: "item_id";
         readonly sdkName: "item_id";
+        readonly description: "Id of the item to read, from the `id` of an item returned by createConversationItems or listConversationItems. An id that is not in the conversation answers 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -9078,6 +9703,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "model";
         readonly sdkName: "model";
+        readonly description: "Id of the model to read. It may carry a creator prefix with a slash, such as deepseek/deepseek-v4-pro, so the value runs to the end of the path. Ids come from the `id` field of listModels; an unknown id answers 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -9448,6 +10074,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "response_id";
         readonly sdkName: "response_id";
+        readonly description: "Id of the stored response, the `id` returned by createResponse (it looks like resp_...). An unknown id, a response created with store false, an expired response and another tenant's response all answer 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -9462,6 +10089,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "response_id";
         readonly sdkName: "response_id";
+        readonly description: "Id of the stored response, the `id` returned by createResponse (it looks like resp_...). An unknown id, a response created with store false, an expired response and another tenant's response all answer 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -9476,6 +10104,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "response_id";
         readonly sdkName: "response_id";
+        readonly description: "Id of the stored response, the `id` returned by createResponse (it looks like resp_...). An unknown id, a response created with store false, an expired response and another tenant's response all answer 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -9490,6 +10119,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "response_id";
         readonly sdkName: "response_id";
+        readonly description: "Id of the stored response, the `id` returned by createResponse (it looks like resp_...). An unknown id, a response created with store false, an expired response and another tenant's response all answer 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -9619,6 +10249,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "video_id";
         readonly sdkName: "video_id";
+        readonly description: "Id of the video job whose output you want, the `id` returned by createVideo. The job must be completed; before that the call answers 400.";
     }];
     readonly query: readonly [];
 }, {
@@ -9633,6 +10264,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "video_id";
         readonly sdkName: "video_id";
+        readonly description: "Id of the video job whose output you want, the `id` returned by createVideo. The job must be completed; before that the call answers 400.";
     }];
     readonly query: readonly [];
 }, {
@@ -9647,6 +10279,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "video_id";
         readonly sdkName: "video_id";
+        readonly description: "Id of the video job whose output you want, the `id` returned by createVideo. The job must be completed; before that the call answers 400.";
     }];
     readonly query: readonly [{
         readonly name: "variant";
@@ -9672,6 +10305,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "video_id";
         readonly sdkName: "video_id";
+        readonly description: "Id of the video job whose output you want, the `id` returned by createVideo. The job must be completed; before that the call answers 400.";
     }];
     readonly query: readonly [];
 }, {
@@ -9782,6 +10416,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "The event id from the events list.";
     }];
     readonly query: readonly [];
 }, {
@@ -9910,6 +10545,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Feedback identifier, prefixed with fb_.";
     }];
     readonly query: readonly [];
 }, {
@@ -9924,6 +10560,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Feedback identifier, prefixed with fb_.";
     }];
     readonly query: readonly [{
         readonly name: "limit";
@@ -9948,6 +10585,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Feedback identifier, prefixed with fb_.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10151,6 +10789,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -10165,6 +10804,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -10179,6 +10819,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10202,6 +10843,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10230,6 +10872,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10254,6 +10897,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10282,6 +10926,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [{
         readonly name: "cursor";
@@ -10323,6 +10968,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [{
         readonly name: "start";
@@ -10347,6 +10993,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10392,6 +11039,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10415,6 +11063,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [{
         readonly name: "state";
@@ -10435,9 +11084,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }, {
         readonly name: "processID";
         readonly sdkName: "processID";
+        readonly description: "Id of the process, the `processId` of an entry returned by listObservedProcesses. Observed processes look like obs-<n>; a process that was only seen live (live-<pid>) has no retained output and answers 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -10452,6 +11103,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10475,6 +11127,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10498,6 +11151,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandboxID";
         readonly sdkName: "sandboxID";
+        readonly description: "Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10521,6 +11175,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandbox_id";
         readonly sdkName: "sandbox_id";
+        readonly description: "Sandbox ID returned by sandboxes.create or sandboxes.list.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10559,6 +11214,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandbox_id";
         readonly sdkName: "sandbox_id";
+        readonly description: "Sandbox ID returned by sandboxes.create or sandboxes.list.";
     }];
     readonly query: readonly [{
         readonly name: "path";
@@ -10578,6 +11234,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandbox_id";
         readonly sdkName: "sandbox_id";
+        readonly description: "Sandbox ID returned by sandboxes.create or sandboxes.list.";
     }];
     readonly query: readonly [{
         readonly name: "path";
@@ -10597,6 +11254,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandbox_id";
         readonly sdkName: "sandbox_id";
+        readonly description: "Sandbox ID returned by sandboxes.create or sandboxes.list.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -10625,6 +11283,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandbox_id";
         readonly sdkName: "sandbox_id";
+        readonly description: "Sandbox ID returned by sandboxes.create or sandboxes.list.";
     }];
     readonly query: readonly [{
         readonly name: "path";
@@ -10644,6 +11303,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "sandbox_id";
         readonly sdkName: "sandbox_id";
+        readonly description: "Sandbox ID returned by sandboxes.create or sandboxes.list.";
     }];
     readonly query: readonly [{
         readonly name: "path";
@@ -10694,6 +11354,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "snapshotID";
         readonly sdkName: "snapshotID";
+        readonly description: "Id of the snapshot, the `snapshotID` returned by createSnapshot or listSnapshots. A snapshot that does not exist or belongs to someone else answers 404.";
     }];
     readonly query: readonly [];
 }, {
@@ -10765,6 +11426,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "volumeID";
         readonly sdkName: "volumeID";
+        readonly description: "Id of the team volume, the `volumeID` returned by createVolume or listVolumes.";
     }];
     readonly query: readonly [];
 }, {
@@ -10779,6 +11441,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "volumeID";
         readonly sdkName: "volumeID";
+        readonly description: "Id of the team volume, the `volumeID` returned by createVolume or listVolumes.";
     }];
     readonly query: readonly [];
 }, {
@@ -11218,6 +11881,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11237,6 +11901,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11256,6 +11921,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11289,6 +11955,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11318,6 +11985,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11347,9 +12015,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "id";
         readonly sdkName: "id";
+        readonly description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers.";
     }, {
         readonly name: "content";
         readonly sdkName: "content";
+        readonly description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11430,6 +12100,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Label name from the repository label list.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11449,6 +12120,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "name";
         readonly sdkName: "name";
+        readonly description: "Label name from the repository label list.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11554,6 +12226,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Milestone number shown by create and list; not the object id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11573,6 +12247,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Milestone number shown by create and list; not the object id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11592,6 +12268,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Milestone number shown by create and list; not the object id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11745,6 +12423,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11764,6 +12444,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11836,6 +12518,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11865,6 +12549,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11898,6 +12584,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11927,6 +12615,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11955,9 +12645,13 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }, {
         readonly name: "n";
         readonly sdkName: "n";
+        readonly type: "integer";
+        readonly description: "Number of the other ticket in the relation or dependency.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -11977,6 +12671,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12006,6 +12702,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12035,6 +12733,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12054,6 +12754,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12083,6 +12785,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12112,6 +12816,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12141,9 +12847,12 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }, {
         readonly name: "content";
         readonly sdkName: "content";
+        readonly description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12163,6 +12872,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12192,6 +12903,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12220,9 +12933,13 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }, {
         readonly name: "n";
         readonly sdkName: "n";
+        readonly type: "integer";
+        readonly description: "Number of the other ticket in the relation or dependency.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12242,6 +12959,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12271,6 +12990,8 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12304,9 +13025,13 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "number";
         readonly sdkName: "number";
+        readonly type: "integer";
+        readonly description: "Ticket number shown by create and list (#12 is 12); not the tk_ id.";
     }, {
         readonly name: "child";
         readonly sdkName: "child";
+        readonly type: "integer";
+        readonly description: "Number of the sub-ticket to detach.";
     }];
     readonly query: readonly [{
         readonly name: "repository";
@@ -12389,6 +13114,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "authorization_id";
         readonly sdkName: "authorization_id";
+        readonly description: "ID of the authorization in your account, returned when authorization is created.";
     }];
     readonly query: readonly [];
 }, {
@@ -12403,6 +13129,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "token";
         readonly sdkName: "token";
+        readonly description: "One-time token from connect_url.";
     }];
     readonly query: readonly [];
 }, {
@@ -12417,6 +13144,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "token";
         readonly sdkName: "token";
+        readonly description: "One-time token from connect_url.";
     }];
     readonly query: readonly [];
 }, {
@@ -12431,6 +13159,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "token";
         readonly sdkName: "token";
+        readonly description: "One-time token from connect_url.";
     }];
     readonly query: readonly [];
 }, {
@@ -12550,6 +13279,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }];
     readonly query: readonly [];
 }, {
@@ -12564,6 +13294,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }];
     readonly query: readonly [];
 }, {
@@ -12578,6 +13309,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -12606,6 +13338,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }];
     readonly query: readonly [];
 }, {
@@ -12620,6 +13353,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }];
     readonly query: readonly [{
         readonly name: "secret";
@@ -12649,6 +13383,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }];
     readonly query: readonly [{
         readonly name: "cursor";
@@ -12678,6 +13413,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -12734,9 +13470,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }, {
         readonly name: "secret";
         readonly sdkName: "secret";
+        readonly description: "Secret name, or its vsec_ ID.";
     }];
     readonly query: readonly [];
 }, {
@@ -12751,9 +13489,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }, {
         readonly name: "secret";
         readonly sdkName: "secret";
+        readonly description: "Secret name, or its vsec_ ID.";
     }];
     readonly query: readonly [];
 }, {
@@ -12768,9 +13508,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }, {
         readonly name: "secret";
         readonly sdkName: "secret";
+        readonly description: "Secret name, or its vsec_ ID.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -12810,9 +13552,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }, {
         readonly name: "secret";
         readonly sdkName: "secret";
+        readonly description: "Secret name, or its vsec_ ID.";
     }];
     readonly query: readonly [];
 }, {
@@ -12827,9 +13571,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }, {
         readonly name: "secret";
         readonly sdkName: "secret";
+        readonly description: "Secret name, or its vsec_ ID.";
     }];
     readonly query: readonly [];
     readonly body: {
@@ -12854,9 +13600,11 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }, {
         readonly name: "secret";
         readonly sdkName: "secret";
+        readonly description: "Secret name, or its vsec_ ID.";
     }];
     readonly query: readonly [];
 }, {
@@ -12871,6 +13619,7 @@ export declare const operations: readonly [{
     readonly pathParams: readonly [{
         readonly name: "vault_id";
         readonly sdkName: "vault_id";
+        readonly description: "ID of the vault in your account, returned when the vault is created.";
     }];
     readonly query: readonly [];
     readonly body: {