@deepraxis/cli 0.1.0-dev.35d57f8 → 0.1.0-dev.3fd48e7

package/dist/praxis.js

@@ -236,7 +236,8 @@ across all toolsets allowed.`
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        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."
       }
     ],
     query: [
@@ -260,7 +261,8 @@ across all toolsets allowed.`
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        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."
       }
     ],
     query: [],
@@ -449,7 +451,8 @@ current version; omit to apply the update unconditionally.`
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        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."
       }
     ],
     query: []
@@ -468,7 +471,8 @@ No Authorization header is required: the grant code or the publishable key is th
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Service agent id (agent_…) or its short identity number, from agent creation or listing."
       }
     ],
     query: [],
@@ -491,7 +495,8 @@ Send the current customer access token as the Bearer credential, with no body, w
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Service agent id (agent_…) or its short identity number, from agent creation or listing."
       }
     ],
     query: []
@@ -510,7 +515,8 @@ Send the current customer access token as the Bearer credential, with no body, a
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Service agent id (agent_…) or its short identity number, from agent creation or listing."
       }
     ],
     query: []
@@ -529,7 +535,8 @@ Call this from your backend with your API key after your own login succeeds, the
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Service agent id (agent_…) or its short identity number, from agent creation or listing."
       }
     ],
     query: [],
@@ -596,6 +603,12 @@ Call this from your backend with your API key after your own login succeeds, the
           type: "string",
           required: false,
           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."
+        },
+        {
+          name: "hosted",
+          type: "boolean",
+          required: false,
+          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."
         }
       ]
     }
@@ -614,7 +627,8 @@ Ordered by last_active_at and external_user_id descending. q is a case-sensitive
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Active service agent identifier from agent creation or listing."
       }
     ],
     query: [
@@ -652,11 +666,13 @@ Develop only. Set confirm to the exact external_user_id; missing or mismatched c
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Active service agent identifier from agent creation or listing."
       },
       {
         name: "external_user_id",
-        sdkName: "external_user_id"
+        sdkName: "external_user_id",
+        description: "Host user identifier supplied at issuance or from end-user listing."
       }
     ],
     query: [
@@ -682,11 +698,13 @@ Use external_user_id from listing or your host application. Users without sessio
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Active service agent identifier from agent creation or listing."
       },
       {
         name: "external_user_id",
-        sdkName: "external_user_id"
+        sdkName: "external_user_id",
+        description: "Host user identifier supplied at issuance or from end-user listing."
       }
     ],
     query: []
@@ -705,11 +723,13 @@ May block a user before any history exists; timestamps are then null and counts
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Active service agent identifier from agent creation or listing."
       },
       {
         name: "external_user_id",
-        sdkName: "external_user_id"
+        sdkName: "external_user_id",
+        description: "Host user identifier supplied at issuance or from end-user listing."
       }
     ],
     query: []
@@ -728,11 +748,13 @@ Use the same agent_id and external_user_id as the confirmed DELETE. Status is pe
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Active service agent identifier from agent creation or listing."
       },
       {
         name: "external_user_id",
-        sdkName: "external_user_id"
+        sdkName: "external_user_id",
+        description: "Host user identifier supplied at issuance or from end-user listing."
       }
     ],
     query: []
@@ -751,11 +773,13 @@ Revokes credentials before marking grants revoked. Upstream failure returns 502
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Active service agent identifier from agent creation or listing."
       },
       {
         name: "external_user_id",
-        sdkName: "external_user_id"
+        sdkName: "external_user_id",
+        description: "Host user identifier supplied at issuance or from end-user listing."
       }
     ],
     query: []
@@ -774,11 +798,13 @@ Removes the user from the blocklist; previously revoked tokens stay revoked. Ide
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Active service agent identifier from agent creation or listing."
       },
       {
         name: "external_user_id",
-        sdkName: "external_user_id"
+        sdkName: "external_user_id",
+        description: "Host user identifier supplied at issuance or from end-user listing."
       }
     ],
     query: []
@@ -795,7 +821,8 @@ Removes the user from the blocklist; previously revoked tokens stay revoked. Ide
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Agent id from creation or listing."
       }
     ],
     query: []
@@ -812,7 +839,8 @@ Removes the user from the blocklist; previously revoked tokens stay revoked. Ide
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        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."
       }
     ],
     query: [
@@ -842,11 +870,14 @@ Removes the user from the blocklist; previously revoked tokens stay revoked. Ide
     pathParams: [
       {
         name: "agent_id",
-        sdkName: "agent_id"
+        sdkName: "agent_id",
+        description: "Agent identifier from agents.create or agents.list."
       },
       {
         name: "version",
-        sdkName: "version"
+        sdkName: "version",
+        type: "integer",
+        description: "Existing version number from agents.versions.list to use for new sessions and tokens."
       }
     ],
     query: []
@@ -923,7 +954,8 @@ Own-face superset: Managed Agents has no persistent Computer deletion lifecycle.
     pathParams: [
       {
         name: "computer_id",
-        sdkName: "computer_id"
+        sdkName: "computer_id",
+        description: "Computer id (cmp_...), as returned by computers.create or computers.list."
       }
     ],
     query: []
@@ -942,7 +974,8 @@ Praxis extension: MA only has session-scoped temporary containers and memory_sto
     pathParams: [
       {
         name: "computer_id",
-        sdkName: "computer_id"
+        sdkName: "computer_id",
+        description: "Computer id (cmp_...), as returned by computers.create or computers.list."
       }
     ],
     query: []
@@ -961,7 +994,8 @@ Praxis extension: MA only has session-scoped temporary containers and memory_sto
     pathParams: [
       {
         name: "computer_id",
-        sdkName: "computer_id"
+        sdkName: "computer_id",
+        description: "Computer id (cmp_...), as returned by computers.create or computers.list."
       }
     ],
     query: [],
@@ -991,7 +1025,8 @@ Praxis extension: MA only has session-scoped temporary containers and memory_sto
     pathParams: [
       {
         name: "computer_id",
-        sdkName: "computer_id"
+        sdkName: "computer_id",
+        description: "Computer id (cmp_...), as returned by computers.create or computers.list."
       }
     ],
     query: []
@@ -1010,7 +1045,8 @@ Own-face superset: Managed Agents has no persistent Computer attachment director
     pathParams: [
       {
         name: "computer_id",
-        sdkName: "computer_id"
+        sdkName: "computer_id",
+        description: "Computer id (cmp_...), as returned by computers.create or computers.list."
       }
     ],
     query: [
@@ -1042,7 +1078,8 @@ Connect to a computer with a caller-held lease. Omit the body or send {} to requ
     pathParams: [
       {
         name: "computer_id",
-        sdkName: "computer_id"
+        sdkName: "computer_id",
+        description: "Computer id (cmp_...), as returned by computers.create or computers.list."
       }
     ],
     query: [],
@@ -1076,7 +1113,8 @@ Praxis extension: MA only has session-scoped temporary containers and memory_sto
     pathParams: [
       {
         name: "computer_id",
-        sdkName: "computer_id"
+        sdkName: "computer_id",
+        description: "Computer id (cmp_...), as returned by computers.create or computers.list."
       }
     ],
     query: [
@@ -1102,7 +1140,8 @@ Praxis extension: MA only has session-scoped temporary containers and memory_sto
     pathParams: [
       {
         name: "computer_id",
-        sdkName: "computer_id"
+        sdkName: "computer_id",
+        description: "Computer id (cmp_...), as returned by computers.create or computers.list."
       }
     ],
     query: [
@@ -1128,11 +1167,13 @@ Own-face extension. Idempotent: an unknown or already released lease succeeds as
     pathParams: [
       {
         name: "computer_id",
-        sdkName: "computer_id"
+        sdkName: "computer_id",
+        description: "Computer id (cmp_...), as returned by computers.create or computers.list."
       },
       {
         name: "lease_id",
-        sdkName: "lease_id"
+        sdkName: "lease_id",
+        description: "lease_id from the connect response."
       }
     ],
     query: []
@@ -1151,11 +1192,13 @@ Own-face extension. A lease that is no longer valid (released, expired, or the c
     pathParams: [
       {
         name: "computer_id",
-        sdkName: "computer_id"
+        sdkName: "computer_id",
+        description: "Computer id (cmp_...), as returned by computers.create or computers.list."
       },
       {
         name: "lease_id",
-        sdkName: "lease_id"
+        sdkName: "lease_id",
+        description: "lease_id from the connect response."
       }
     ],
     query: []
@@ -1247,7 +1290,8 @@ Own-face extension. A lease that is no longer valid (released, expired, or the c
     pathParams: [
       {
         name: "deployment_run_id",
-        sdkName: "deployment_run_id"
+        sdkName: "deployment_run_id",
+        description: "Deployment run id (drun_...), returned by deployments.run or deployment_runs.list."
       }
     ],
     query: []
@@ -1418,7 +1462,8 @@ created from this deployment. Maximum 50.`
     pathParams: [
       {
         name: "deployment_id",
-        sdkName: "deployment_id"
+        sdkName: "deployment_id",
+        description: "Deployment id (depl_...), returned by deployments.create or deployments.list."
       }
     ],
     query: []
@@ -1435,7 +1480,8 @@ created from this deployment. Maximum 50.`
     pathParams: [
       {
         name: "deployment_id",
-        sdkName: "deployment_id"
+        sdkName: "deployment_id",
+        description: "Deployment id (depl_...), returned by deployments.create or deployments.list."
       }
     ],
     query: [],
@@ -1533,7 +1579,8 @@ null to clear. Maximum 50.`
     pathParams: [
       {
         name: "deployment_id",
-        sdkName: "deployment_id"
+        sdkName: "deployment_id",
+        description: "Deployment id (depl_...), returned by deployments.create or deployments.list."
       }
     ],
     query: []
@@ -1550,7 +1597,8 @@ null to clear. Maximum 50.`
     pathParams: [
       {
         name: "deployment_id",
-        sdkName: "deployment_id"
+        sdkName: "deployment_id",
+        description: "Deployment id (depl_...), returned by deployments.create or deployments.list."
       }
     ],
     query: []
@@ -1567,7 +1615,8 @@ null to clear. Maximum 50.`
     pathParams: [
       {
         name: "deployment_id",
-        sdkName: "deployment_id"
+        sdkName: "deployment_id",
+        description: "Deployment id (depl_...), returned by deployments.create or deployments.list."
       }
     ],
     query: []
@@ -1584,7 +1633,8 @@ null to clear. Maximum 50.`
     pathParams: [
       {
         name: "deployment_id",
-        sdkName: "deployment_id"
+        sdkName: "deployment_id",
+        description: "Deployment id (depl_...), returned by deployments.create or deployments.list."
       }
     ],
     query: []
@@ -1791,7 +1841,8 @@ Use an id from issuance or listing. Revokes the credential before setting revoke
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Grant id returned by issuance or listing."
       }
     ],
     query: []
@@ -1884,7 +1935,8 @@ Use an id from issuance or listing. Revokes the credential before setting revoke
     pathParams: [
       {
         name: "environment_id",
-        sdkName: "environment_id"
+        sdkName: "environment_id",
+        description: "Environment id, as returned by environments.create or environments.list. Built-in environments can be read but not changed."
       }
     ],
     query: []
@@ -1901,7 +1953,8 @@ Use an id from issuance or listing. Revokes the credential before setting revoke
     pathParams: [
       {
         name: "environment_id",
-        sdkName: "environment_id"
+        sdkName: "environment_id",
+        description: "Environment id, as returned by environments.create or environments.list. Built-in environments can be read but not changed."
       }
     ],
     query: [],
@@ -1948,7 +2001,8 @@ clears to null; an empty string is stored as an empty string.`
     pathParams: [
       {
         name: "environment_id",
-        sdkName: "environment_id"
+        sdkName: "environment_id",
+        description: "Environment id, as returned by environments.create or environments.list. Built-in environments can be read but not changed."
       }
     ],
     query: []
@@ -2194,7 +2248,8 @@ offsets ("+08:00") and unknown names return 400. Never stored in
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: []
@@ -2211,7 +2266,8 @@ offsets ("+08:00") and unknown names return 400. Never stored in
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: []
@@ -2228,7 +2284,8 @@ offsets ("+08:00") and unknown names return 400. Never stored in
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: [],
@@ -2288,7 +2345,8 @@ delete it. Omit the field to preserve.`
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: []
@@ -2307,7 +2365,8 @@ Own-face extension. Returns { data: BackgroundTask[] }. Each task has id, kind,
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: []
@@ -2326,11 +2385,13 @@ Own-face extension. offset defaults to 0; max_bytes defaults to 65536 and must b
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       },
       {
         name: "task_id",
-        sdkName: "task_id"
+        sdkName: "task_id",
+        description: "Background task id (task_...), as listed by sessions.background_tasks.list."
       }
     ],
     query: [
@@ -2362,11 +2423,13 @@ Own-face extension. No request body is required. Uses the same stop implementati
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       },
       {
         name: "task_id",
-        sdkName: "task_id"
+        sdkName: "task_id",
+        description: "Background task id (task_...), as listed by sessions.background_tasks.list."
       }
     ],
     query: []
@@ -2385,7 +2448,8 @@ Available only on /agent/v1. The body may be omitted or {}. Optional instruction
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: [],
@@ -2415,11 +2479,13 @@ Available only on /agent/v1. Returns { type: session_compaction, id, status, rea
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       },
       {
         name: "operation_id",
-        sdkName: "operation_id"
+        sdkName: "operation_id",
+        description: "Compaction operation id returned by sessions.compact in the id field of the session_compaction object."
       }
     ],
     query: []
@@ -2438,7 +2504,8 @@ Available only on /agent/v1. Returns { data: [...] }. Each entry contains type,
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: []
@@ -2457,7 +2524,8 @@ Praxis extension available only on /agent/v1, following Claude Agent SDK getCont
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: []
@@ -2474,7 +2542,8 @@ Praxis extension available only on /agent/v1, following Claude Agent SDK getCont
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: [
@@ -2545,7 +2614,8 @@ Praxis extension available only on /agent/v1, following Claude Agent SDK getCont
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: [],
@@ -2574,7 +2644,8 @@ Praxis extension available only on /agent/v1, following Claude Agent SDK getCont
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: [
@@ -2605,7 +2676,8 @@ Available only on /agent/v1. Use the message_id field from own-face events, not
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: [],
@@ -2633,7 +2705,8 @@ Available only on /agent/v1. Use the message_id field from own-face events, not
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: [
@@ -2663,7 +2736,8 @@ Available only on /agent/v1. Use the message_id field from own-face events, not
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: [
@@ -2707,11 +2781,13 @@ Available only on /agent/v1. Use the message_id field from own-face events, not
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       },
       {
         name: "resource_id",
-        sdkName: "resource_id"
+        sdkName: "resource_id",
+        description: "Id of a resource attached to the session, as returned by sessions.resources.add or sessions.resources.list."
       }
     ],
     query: [
@@ -2736,11 +2812,13 @@ Available only on /agent/v1. Use the message_id field from own-face events, not
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       },
       {
         name: "resource_id",
-        sdkName: "resource_id"
+        sdkName: "resource_id",
+        description: "Id of a resource attached to the session, as returned by sessions.resources.add or sessions.resources.list."
       }
     ],
     query: [
@@ -2767,11 +2845,13 @@ Own-face extension. Use the session id from session creation or listing and the
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        description: "Session id from session creation or listing."
       },
       {
         name: "run_id",
-        sdkName: "run_id"
+        sdkName: "run_id",
+        description: "Existing run_id from this session's events."
       }
     ],
     query: []
@@ -2790,11 +2870,13 @@ Own-face extension. Use a readable session and a run_id from its events. Each su
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        description: "Session id from session creation or listing."
       },
       {
         name: "run_id",
-        sdkName: "run_id"
+        sdkName: "run_id",
+        description: "Existing run_id from this session's events."
       }
     ],
     query: [],
@@ -2832,7 +2914,8 @@ Own-face extension. Use a readable session and a run_id from its events. Each su
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       }
     ],
     query: [
@@ -2862,11 +2945,13 @@ Own-face extension. Use a readable session and a run_id from its events. Each su
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       },
       {
         name: "thread_id",
-        sdkName: "thread_id"
+        sdkName: "thread_id",
+        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."
       }
     ],
     query: [
@@ -2891,11 +2976,13 @@ Own-face extension. Use a readable session and a run_id from its events. Each su
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       },
       {
         name: "thread_id",
-        sdkName: "thread_id"
+        sdkName: "thread_id",
+        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."
       }
     ],
     query: [
@@ -2920,11 +3007,13 @@ Own-face extension. Use a readable session and a run_id from its events. Each su
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       },
       {
         name: "thread_id",
-        sdkName: "thread_id"
+        sdkName: "thread_id",
+        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."
       }
     ],
     query: [
@@ -2961,11 +3050,13 @@ Own-face extension. Use a readable session and a run_id from its events. Each su
     pathParams: [
       {
         name: "session_id",
-        sdkName: "session_id"
+        sdkName: "session_id",
+        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."
       },
       {
         name: "thread_id",
-        sdkName: "thread_id"
+        sdkName: "thread_id",
+        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."
       }
     ],
     query: [
@@ -3071,7 +3162,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "skill_id",
-        sdkName: "skill_id"
+        sdkName: "skill_id",
+        description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404."
       }
     ],
     query: []
@@ -3088,7 +3180,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "skill_id",
-        sdkName: "skill_id"
+        sdkName: "skill_id",
+        description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404."
       }
     ],
     query: []
@@ -3105,7 +3198,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "skill_id",
-        sdkName: "skill_id"
+        sdkName: "skill_id",
+        description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404."
       }
     ],
     query: [
@@ -3136,7 +3230,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "skill_id",
-        sdkName: "skill_id"
+        sdkName: "skill_id",
+        description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404."
       }
     ],
     query: [],
@@ -3168,11 +3263,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "skill_id",
-        sdkName: "skill_id"
+        sdkName: "skill_id",
+        description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404."
       },
       {
         name: "version",
-        sdkName: "version"
+        sdkName: "version",
+        description: "Skill version id, as returned by skills.versions.create or skills.versions.list; an opaque string that increases with each upload."
       }
     ],
     query: []
@@ -3189,11 +3286,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "skill_id",
-        sdkName: "skill_id"
+        sdkName: "skill_id",
+        description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404."
       },
       {
         name: "version",
-        sdkName: "version"
+        sdkName: "version",
+        description: "Skill version id, as returned by skills.versions.create or skills.versions.list; an opaque string that increases with each upload."
       }
     ],
     query: []
@@ -3210,11 +3309,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "skill_id",
-        sdkName: "skill_id"
+        sdkName: "skill_id",
+        description: "Skill id (skill_...), as returned by skills.create or skills.list. A skill of another organization returns 404."
       },
       {
         name: "version",
-        sdkName: "version"
+        sdkName: "version",
+        description: "Skill version id, as returned by skills.versions.create or skills.versions.list; an opaque string that increases with each upload."
       }
     ],
     query: []
@@ -3386,7 +3487,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: []
@@ -3403,7 +3505,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: [
@@ -3427,7 +3530,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: [],
@@ -3480,7 +3584,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: [],
@@ -3508,7 +3613,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: []
@@ -3525,7 +3631,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: [
@@ -3555,7 +3662,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: [],
@@ -3605,11 +3713,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       },
       {
         name: "deployment_id",
-        sdkName: "deployment_id"
+        sdkName: "deployment_id",
+        description: "ID from the id of CreateDeployment or ListDeployments, prefixed dep_."
       }
     ],
     query: []
@@ -3626,7 +3736,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: [
@@ -3656,7 +3767,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: []
@@ -3673,7 +3785,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: [],
@@ -3711,11 +3824,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       },
       {
         name: "grant_id",
-        sdkName: "grant_id"
+        sdkName: "grant_id",
+        description: "Grant ID (grt_…)."
       }
     ],
     query: []
@@ -3732,7 +3847,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: []
@@ -3749,7 +3865,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: []
@@ -3766,11 +3883,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        description: "Secret name as seen in the Worker's env: 1–64 letters, digits or underscores, not starting with a digit."
       }
     ],
     query: []
@@ -3787,11 +3906,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        description: "Secret name as seen in the Worker's env: 1–64 letters, digits or underscores, not starting with a digit."
       }
     ],
     query: [],
@@ -3819,7 +3940,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: [
@@ -3849,7 +3971,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       }
     ],
     query: [],
@@ -3928,11 +4051,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       },
       {
         name: "version_id",
-        sdkName: "version_id"
+        sdkName: "version_id",
+        description: "Version ID (ver_…)."
       }
     ],
     query: []
@@ -3949,11 +4074,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "worker_id",
-        sdkName: "worker_id"
+        sdkName: "worker_id",
+        description: "Worker ID (wkr_…)."
       },
       {
         name: "version_id",
-        sdkName: "version_id"
+        sdkName: "version_id",
+        description: "Version ID from versions.list or the active deployment."
       }
     ],
     query: []
@@ -4139,11 +4266,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: []
@@ -4160,11 +4289,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [
@@ -4248,11 +4379,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [],
@@ -4273,11 +4406,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [
@@ -4307,11 +4442,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [
@@ -4382,11 +4519,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [],
@@ -4407,11 +4546,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [
@@ -4450,15 +4591,18 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       },
       {
         name: "revision",
-        sdkName: "revision"
+        sdkName: "revision",
+        description: "Action revision ID (actr_); the query parameter filters invocation records."
       }
     ],
     query: []
@@ -4475,11 +4619,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [],
@@ -4513,11 +4659,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "trigger_id",
-        sdkName: "trigger_id"
+        sdkName: "trigger_id",
+        description: "Trigger ID (trg_)."
       },
       {
         name: "token",
-        sdkName: "token"
+        sdkName: "token",
+        description: "Secret URL token returned on creation or rotation; do not disclose it."
       }
     ],
     query: [],
@@ -4730,7 +4878,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: [
@@ -4768,7 +4917,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: [
@@ -4798,7 +4948,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: [
@@ -4828,7 +4979,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: [],
@@ -4856,7 +5008,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: [
@@ -4886,7 +5039,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: [
@@ -4916,7 +5070,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: [],
@@ -4944,7 +5099,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: [],
@@ -4965,7 +5121,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: []
@@ -4982,7 +5139,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: [],
@@ -5003,7 +5161,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: [
@@ -5051,7 +5210,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       }
     ],
     query: [
@@ -5081,11 +5241,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Run ID (run_)."
       },
       {
         name: "wait_id",
-        sdkName: "wait_id"
+        sdkName: "wait_id",
+        description: "Wait ID (wait_) belonging to this run."
       }
     ],
     query: [],
@@ -5239,11 +5401,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: []
@@ -5260,11 +5424,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [],
@@ -5304,11 +5470,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [],
@@ -5329,11 +5497,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: []
@@ -5350,15 +5520,18 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       },
       {
         name: "tag",
-        sdkName: "tag"
+        sdkName: "tag",
+        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."
       }
     ],
     query: []
@@ -5375,15 +5548,18 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       },
       {
         name: "tag",
-        sdkName: "tag"
+        sdkName: "tag",
+        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."
       }
     ],
     query: [],
@@ -5411,11 +5587,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [],
@@ -5436,11 +5614,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [
@@ -5482,11 +5662,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [],
@@ -5507,15 +5689,18 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       },
       {
         name: "version",
-        sdkName: "version"
+        sdkName: "version",
+        description: "Exact version or dist-tag; ranges are rejected with 400 and a hint."
       }
     ],
     query: []
@@ -5532,15 +5717,18 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       },
       {
         name: "version",
-        sdkName: "version"
+        sdkName: "version",
+        description: "An exact canonical semantic version, such as 1.2.0 or 1.3.0-beta.1, not a range."
       }
     ],
     query: [],
@@ -5846,7 +6034,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Trigger ID (trg_)."
       }
     ],
     query: []
@@ -5863,7 +6052,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Trigger ID (trg_)."
       }
     ],
     query: []
@@ -5880,7 +6070,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Trigger ID (trg_)."
       }
     ],
     query: [],
@@ -5988,7 +6179,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Trigger ID (trg_)."
       }
     ],
     query: []
@@ -6005,7 +6197,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Trigger ID (trg_)."
       }
     ],
     query: [
@@ -6056,7 +6249,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Trigger ID (trg_)."
       }
     ],
     query: []
@@ -6073,7 +6267,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Trigger ID (trg_)."
       }
     ],
     query: []
@@ -6090,7 +6285,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Trigger ID (trg_)."
       }
     ],
     query: []
@@ -6261,11 +6457,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: []
@@ -6282,11 +6480,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [],
@@ -6326,11 +6526,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [],
@@ -6351,11 +6553,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: []
@@ -6372,15 +6576,18 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       },
       {
         name: "tag",
-        sdkName: "tag"
+        sdkName: "tag",
+        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."
       }
     ],
     query: []
@@ -6397,15 +6604,18 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       },
       {
         name: "tag",
-        sdkName: "tag"
+        sdkName: "tag",
+        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."
       }
     ],
     query: [],
@@ -6433,11 +6643,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [],
@@ -6458,11 +6670,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [
@@ -6504,11 +6718,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       }
     ],
     query: [],
@@ -6529,15 +6745,18 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       },
       {
         name: "version",
-        sdkName: "version"
+        sdkName: "version",
+        description: "Exact version or dist-tag; ranges are rejected with 400 and a hint."
       }
     ],
     query: []
@@ -6554,15 +6773,18 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "ns",
-        sdkName: "ns"
+        sdkName: "ns",
+        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."
       },
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        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}."
       },
       {
         name: "version",
-        sdkName: "version"
+        sdkName: "version",
+        description: "An exact canonical semantic version, such as 1.2.0 or 1.3.0-beta.1, not a range."
       }
     ],
     query: [],
@@ -6717,7 +6939,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "contextId",
-        sdkName: "contextId"
+        sdkName: "contextId",
+        description: "登录态 ID；使用创建或列出登录态返回的 id，以 bsc_ 开头。"
       }
     ],
     query: []
@@ -6734,7 +6957,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "contextId",
-        sdkName: "contextId"
+        sdkName: "contextId",
+        description: "登录态 ID；使用创建或列出登录态返回的 id，以 bsc_ 开头。"
       }
     ],
     query: []
@@ -6751,7 +6975,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "contextId",
-        sdkName: "contextId"
+        sdkName: "contextId",
+        description: "登录态 ID；使用创建或列出登录态返回的 id，以 bsc_ 开头。"
       }
     ],
     query: [],
@@ -6785,11 +7010,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "sessionId",
-        sdkName: "sessionId"
+        sdkName: "sessionId",
+        description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。"
       },
       {
         name: "pageId",
-        sdkName: "pageId"
+        sdkName: "pageId",
+        description: "实时观看地址中的标签页 ID；使用 debug 返回链接中的原值，_ 表示会话级画面。"
       }
     ],
     query: [
@@ -6958,7 +7185,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "sessionId",
-        sdkName: "sessionId"
+        sdkName: "sessionId",
+        description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。"
       }
     ],
     query: [
@@ -6982,7 +7210,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "sessionId",
-        sdkName: "sessionId"
+        sdkName: "sessionId",
+        description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。"
       }
     ],
     query: [],
@@ -7013,7 +7242,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "sessionId",
-        sdkName: "sessionId"
+        sdkName: "sessionId",
+        description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。"
       }
     ],
     query: []
@@ -7030,7 +7260,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "sessionId",
-        sdkName: "sessionId"
+        sdkName: "sessionId",
+        description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。"
       }
     ],
     query: [
@@ -7066,7 +7297,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "sessionId",
-        sdkName: "sessionId"
+        sdkName: "sessionId",
+        description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。"
       }
     ],
     query: [],
@@ -7100,7 +7332,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "sessionId",
-        sdkName: "sessionId"
+        sdkName: "sessionId",
+        description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。"
       }
     ],
     query: []
@@ -7117,7 +7350,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "sessionId",
-        sdkName: "sessionId"
+        sdkName: "sessionId",
+        description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。"
       }
     ],
     query: []
@@ -7134,7 +7368,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "sessionId",
-        sdkName: "sessionId"
+        sdkName: "sessionId",
+        description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。"
       }
     ],
     query: [],
@@ -7232,7 +7467,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       }
     ],
     query: []
@@ -7249,7 +7485,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       }
     ],
     query: []
@@ -7266,7 +7503,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       }
     ],
     query: [],
@@ -7300,7 +7538,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       }
     ],
     query: [
@@ -7346,7 +7585,8 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       }
     ],
     query: []
@@ -7363,11 +7603,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       },
       {
         name: "table",
-        sdkName: "table"
+        sdkName: "table",
+        description: "table ID or name."
       }
     ],
     query: [
@@ -7451,11 +7693,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       },
       {
         name: "table",
-        sdkName: "table"
+        sdkName: "table",
+        description: "table ID or name."
       }
     ],
     query: [
@@ -7539,11 +7783,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       },
       {
         name: "table",
-        sdkName: "table"
+        sdkName: "table",
+        description: "table ID or name."
       }
     ],
     query: [
@@ -7627,11 +7873,13 @@ file at the root of that directory.`
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       },
       {
         name: "table",
-        sdkName: "table"
+        sdkName: "table",
+        description: "table ID or name."
       }
     ],
     query: [
@@ -7721,11 +7969,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       },
       {
         name: "table",
-        sdkName: "table"
+        sdkName: "table",
+        description: "table ID or name."
       }
     ],
     query: [
@@ -7813,7 +8063,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       }
     ],
     query: []
@@ -7830,7 +8081,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       }
     ],
     query: []
@@ -7847,7 +8099,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       }
     ],
     query: [],
@@ -7888,11 +8141,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       },
       {
         name: "table",
-        sdkName: "table"
+        sdkName: "table",
+        description: "table ID or name."
       }
     ],
     query: []
@@ -7909,11 +8164,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       },
       {
         name: "table",
-        sdkName: "table"
+        sdkName: "table",
+        description: "table ID or name."
       }
     ],
     query: []
@@ -7930,11 +8187,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       },
       {
         name: "table",
-        sdkName: "table"
+        sdkName: "table",
+        description: "table ID or name."
       }
     ],
     query: [],
@@ -7968,11 +8227,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       },
       {
         name: "table",
-        sdkName: "table"
+        sdkName: "table",
+        description: "table ID or name."
       }
     ],
     query: [],
@@ -7993,15 +8254,18 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       },
       {
         name: "table",
-        sdkName: "table"
+        sdkName: "table",
+        description: "table ID or name."
       },
       {
         name: "field",
-        sdkName: "field"
+        sdkName: "field",
+        description: "field ID or name."
       }
     ],
     query: []
@@ -8018,15 +8282,18 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "database_id",
-        sdkName: "database_id"
+        sdkName: "database_id",
+        description: "Identifier of the database to act on: the id (db_…) returned by databaseCreateDatabase or databaseListDatabases. A display name is not accepted."
       },
       {
         name: "table",
-        sdkName: "table"
+        sdkName: "table",
+        description: "table ID or name."
       },
       {
         name: "field",
-        sdkName: "field"
+        sdkName: "field",
+        description: "field ID or name."
       }
     ],
     query: [],
@@ -8185,7 +8452,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "file_id",
-        sdkName: "file_id"
+        sdkName: "file_id",
+        description: "ID of a tenant-owned live file, as returned by upload or list; starts with file-."
       }
     ],
     query: []
@@ -8202,7 +8470,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "file_id",
-        sdkName: "file_id"
+        sdkName: "file_id",
+        description: "ID of a tenant-owned live file, as returned by upload or list; starts with file-."
       }
     ],
     query: []
@@ -8219,7 +8488,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "file_id",
-        sdkName: "file_id"
+        sdkName: "file_id",
+        description: "ID of a tenant-owned live file, as returned by upload or list; starts with file-."
       }
     ],
     query: []
@@ -8294,7 +8564,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "upload_id",
-        sdkName: "upload_id"
+        sdkName: "upload_id",
+        description: "Upload identifier returned by create; belongs to your organization."
       }
     ],
     query: []
@@ -8311,7 +8582,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "upload_id",
-        sdkName: "upload_id"
+        sdkName: "upload_id",
+        description: "Upload identifier returned by create; belongs to your organization."
       }
     ],
     query: [],
@@ -8347,7 +8619,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "upload_id",
-        sdkName: "upload_id"
+        sdkName: "upload_id",
+        description: "Upload identifier returned by create; belongs to your organization."
       }
     ],
     query: [
@@ -8493,7 +8766,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       }
     ],
     query: []
@@ -8510,7 +8784,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       }
     ],
     query: [
@@ -8548,7 +8823,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       }
     ],
     query: [],
@@ -8594,7 +8870,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       }
     ],
     query: [
@@ -8624,7 +8901,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       }
     ],
     query: [],
@@ -8645,11 +8923,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       },
       {
         name: "batch_id",
-        sdkName: "batch_id"
+        sdkName: "batch_id",
+        description: "File-batch ID returned by batch creation in this knowledge base."
       }
     ],
     query: []
@@ -8666,11 +8946,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       },
       {
         name: "batch_id",
-        sdkName: "batch_id"
+        sdkName: "batch_id",
+        description: "File-batch ID returned by batch creation in this knowledge base."
       }
     ],
     query: []
@@ -8687,11 +8969,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       },
       {
         name: "batch_id",
-        sdkName: "batch_id"
+        sdkName: "batch_id",
+        description: "File-batch ID returned by batch creation in this knowledge base."
       }
     ],
     query: [
@@ -8749,7 +9033,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       }
     ],
     query: [
@@ -8807,7 +9092,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       }
     ],
     query: [],
@@ -8847,11 +9133,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       },
       {
         name: "file_id",
-        sdkName: "file_id"
+        sdkName: "file_id",
+        description: "Source File ID of an attachment, returned by file attachment or listing."
       }
     ],
     query: []
@@ -8868,11 +9156,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       },
       {
         name: "file_id",
-        sdkName: "file_id"
+        sdkName: "file_id",
+        description: "Source File ID of an attachment, returned by file attachment or listing."
       }
     ],
     query: []
@@ -8889,11 +9179,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       },
       {
         name: "file_id",
-        sdkName: "file_id"
+        sdkName: "file_id",
+        description: "Source File ID of an attachment, returned by file attachment or listing."
       }
     ],
     query: [],
@@ -8921,11 +9213,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       },
       {
         name: "file_id",
-        sdkName: "file_id"
+        sdkName: "file_id",
+        description: "Source File ID of an attachment, returned by file attachment or listing."
       }
     ],
     query: []
@@ -8942,11 +9236,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       },
       {
         name: "file_id",
-        sdkName: "file_id"
+        sdkName: "file_id",
+        description: "Source File ID of an attachment, returned by file attachment or listing."
       }
     ],
     query: []
@@ -8963,11 +9259,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       },
       {
         name: "file_id",
-        sdkName: "file_id"
+        sdkName: "file_id",
+        description: "Source File ID of an attachment, returned by file attachment or listing."
       }
     ],
     query: [
@@ -9013,7 +9311,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       }
     ],
     query: []
@@ -9030,7 +9329,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       }
     ],
     query: []
@@ -9047,7 +9347,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       }
     ],
     query: [],
@@ -9111,11 +9412,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "vector_store_id",
-        sdkName: "vector_store_id"
+        sdkName: "vector_store_id",
+        description: "Knowledge-base ID returned by create or list; use the ID rather than its display name."
       },
       {
         name: "chunk_id",
-        sdkName: "chunk_id"
+        sdkName: "chunk_id",
+        description: "Chunk ID returned by segment listing or native search content."
       }
     ],
     query: []
@@ -9214,7 +9517,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: []
@@ -9231,7 +9535,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: []
@@ -9248,7 +9553,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [],
@@ -9294,7 +9600,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [
@@ -9342,7 +9649,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [],
@@ -9454,7 +9762,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [],
@@ -9565,11 +9874,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       },
       {
         name: "asset_id",
-        sdkName: "asset_id"
+        sdkName: "asset_id",
+        description: "32-character asset ID."
       }
     ],
     query: []
@@ -9586,11 +9897,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       },
       {
         name: "asset_id",
-        sdkName: "asset_id"
+        sdkName: "asset_id",
+        description: "32-character asset ID."
       }
     ],
     query: []
@@ -9607,11 +9920,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       },
       {
         name: "asset_id",
-        sdkName: "asset_id"
+        sdkName: "asset_id",
+        description: "32-character asset ID."
       }
     ],
     query: [],
@@ -9658,11 +9973,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       },
       {
         name: "asset_id",
-        sdkName: "asset_id"
+        sdkName: "asset_id",
+        description: "32-character asset ID."
       }
     ],
     query: [],
@@ -9697,11 +10014,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       },
       {
         name: "asset_id",
-        sdkName: "asset_id"
+        sdkName: "asset_id",
+        description: "32-character asset ID."
       }
     ],
     query: [
@@ -9750,7 +10069,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [],
@@ -9778,7 +10098,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [],
@@ -9806,11 +10127,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       },
       {
         name: "job_id",
-        sdkName: "job_id"
+        sdkName: "job_id",
+        description: "Batch identifier returned by createBatch or batchAssets; resolved within this library."
       }
     ],
     query: []
@@ -9827,7 +10150,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [
@@ -9873,7 +10197,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [
@@ -9897,11 +10222,13 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       },
       {
         name: "job_id",
-        sdkName: "job_id"
+        sdkName: "job_id",
+        description: "Batch identifier returned by createBatch or batchAssets; resolved within this library."
       }
     ],
     query: []
@@ -9918,7 +10245,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: []
@@ -9935,7 +10263,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: []
@@ -9952,7 +10281,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [],
@@ -10002,7 +10332,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [],
@@ -10073,7 +10404,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [],
@@ -10123,7 +10455,8 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
     pathParams: [
       {
         name: "library_id",
-        sdkName: "library_id"
+        sdkName: "library_id",
+        description: "Library ID returned by creation."
       }
     ],
     query: [],
@@ -10216,7 +10549,8 @@ services (model, agent, automation…); call the operation you need and read its
     pathParams: [
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        description: "Exact method name from the search results, for example `praxis.database.databases.tables.create`."
       }
     ],
     query: []
@@ -10873,7 +11207,8 @@ services (model, agent, automation…); call the operation you need and read its
     pathParams: [
       {
         name: "conversation_id",
-        sdkName: "conversation_id"
+        sdkName: "conversation_id",
+        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."
       }
     ],
     query: []
@@ -10890,7 +11225,8 @@ services (model, agent, automation…); call the operation you need and read its
     pathParams: [
       {
         name: "conversation_id",
-        sdkName: "conversation_id"
+        sdkName: "conversation_id",
+        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."
       }
     ],
     query: []
@@ -10907,7 +11243,8 @@ services (model, agent, automation…); call the operation you need and read its
     pathParams: [
       {
         name: "conversation_id",
-        sdkName: "conversation_id"
+        sdkName: "conversation_id",
+        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."
       }
     ],
     query: [],
@@ -10935,7 +11272,8 @@ services (model, agent, automation…); call the operation you need and read its
     pathParams: [
       {
         name: "conversation_id",
-        sdkName: "conversation_id"
+        sdkName: "conversation_id",
+        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."
       }
     ],
     query: []
@@ -10952,7 +11290,8 @@ services (model, agent, automation…); call the operation you need and read its
     pathParams: [
       {
         name: "conversation_id",
-        sdkName: "conversation_id"
+        sdkName: "conversation_id",
+        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."
       }
     ],
     query: [],
@@ -10981,11 +11320,13 @@ services (model, agent, automation…); call the operation you need and read its
     pathParams: [
       {
         name: "conversation_id",
-        sdkName: "conversation_id"
+        sdkName: "conversation_id",
+        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."
       },
       {
         name: "item_id",
-        sdkName: "item_id"
+        sdkName: "item_id",
+        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."
       }
     ],
     query: []
@@ -11002,11 +11343,13 @@ services (model, agent, automation…); call the operation you need and read its
     pathParams: [
       {
         name: "conversation_id",
-        sdkName: "conversation_id"
+        sdkName: "conversation_id",
+        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."
       },
       {
         name: "item_id",
-        sdkName: "item_id"
+        sdkName: "item_id",
+        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."
       }
     ],
     query: []
@@ -11772,7 +12115,8 @@ for more details.`
     pathParams: [
       {
         name: "model",
-        sdkName: "model"
+        sdkName: "model",
+        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."
       }
     ],
     query: []
@@ -12231,7 +12575,8 @@ for more details.`
     pathParams: [
       {
         name: "response_id",
-        sdkName: "response_id"
+        sdkName: "response_id",
+        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."
       }
     ],
     query: []
@@ -12248,7 +12593,8 @@ for more details.`
     pathParams: [
       {
         name: "response_id",
-        sdkName: "response_id"
+        sdkName: "response_id",
+        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."
       }
     ],
     query: []
@@ -12265,7 +12611,8 @@ for more details.`
     pathParams: [
       {
         name: "response_id",
-        sdkName: "response_id"
+        sdkName: "response_id",
+        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."
       }
     ],
     query: []
@@ -12282,7 +12629,8 @@ for more details.`
     pathParams: [
       {
         name: "response_id",
-        sdkName: "response_id"
+        sdkName: "response_id",
+        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."
       }
     ],
     query: []
@@ -12438,7 +12786,8 @@ for more details.`
     pathParams: [
       {
         name: "video_id",
-        sdkName: "video_id"
+        sdkName: "video_id",
+        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."
       }
     ],
     query: []
@@ -12455,7 +12804,8 @@ for more details.`
     pathParams: [
       {
         name: "video_id",
-        sdkName: "video_id"
+        sdkName: "video_id",
+        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."
       }
     ],
     query: []
@@ -12472,7 +12822,8 @@ for more details.`
     pathParams: [
       {
         name: "video_id",
-        sdkName: "video_id"
+        sdkName: "video_id",
+        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."
       }
     ],
     query: [
@@ -12507,7 +12858,8 @@ for more details.`
     pathParams: [
       {
         name: "video_id",
-        sdkName: "video_id"
+        sdkName: "video_id",
+        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."
       }
     ],
     query: []
@@ -12652,7 +13004,8 @@ for more details.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "The event id from the events list."
       }
     ],
     query: []
@@ -12806,7 +13159,8 @@ for more details.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Feedback identifier, prefixed with fb_."
       }
     ],
     query: []
@@ -12823,7 +13177,8 @@ for more details.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Feedback identifier, prefixed with fb_."
       }
     ],
     query: [
@@ -12853,7 +13208,8 @@ for more details.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Feedback identifier, prefixed with fb_."
       }
     ],
     query: [],
@@ -13111,7 +13467,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: []
@@ -13128,7 +13485,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: []
@@ -13145,7 +13503,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [],
@@ -13173,7 +13532,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [],
@@ -13207,7 +13567,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [],
@@ -13240,7 +13601,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [],
@@ -13274,7 +13636,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [
@@ -13332,7 +13695,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [
@@ -13362,7 +13726,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [],
@@ -13417,7 +13782,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [],
@@ -13445,7 +13811,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [
@@ -13474,11 +13841,13 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       },
       {
         name: "processID",
-        sdkName: "processID"
+        sdkName: "processID",
+        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."
       }
     ],
     query: []
@@ -13495,7 +13864,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [],
@@ -13523,7 +13893,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [],
@@ -13551,7 +13922,8 @@ for more details.`
     pathParams: [
       {
         name: "sandboxID",
-        sdkName: "sandboxID"
+        sdkName: "sandboxID",
+        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."
       }
     ],
     query: [],
@@ -13579,7 +13951,8 @@ for more details.`
     pathParams: [
       {
         name: "sandbox_id",
-        sdkName: "sandbox_id"
+        sdkName: "sandbox_id",
+        description: "Sandbox ID returned by sandboxes.create or sandboxes.list."
       }
     ],
     query: [],
@@ -13625,7 +13998,8 @@ for more details.`
     pathParams: [
       {
         name: "sandbox_id",
-        sdkName: "sandbox_id"
+        sdkName: "sandbox_id",
+        description: "Sandbox ID returned by sandboxes.create or sandboxes.list."
       }
     ],
     query: [
@@ -13649,7 +14023,8 @@ for more details.`
     pathParams: [
       {
         name: "sandbox_id",
-        sdkName: "sandbox_id"
+        sdkName: "sandbox_id",
+        description: "Sandbox ID returned by sandboxes.create or sandboxes.list."
       }
     ],
     query: [
@@ -13673,7 +14048,8 @@ for more details.`
     pathParams: [
       {
         name: "sandbox_id",
-        sdkName: "sandbox_id"
+        sdkName: "sandbox_id",
+        description: "Sandbox ID returned by sandboxes.create or sandboxes.list."
       }
     ],
     query: [],
@@ -13707,7 +14083,8 @@ for more details.`
     pathParams: [
       {
         name: "sandbox_id",
-        sdkName: "sandbox_id"
+        sdkName: "sandbox_id",
+        description: "Sandbox ID returned by sandboxes.create or sandboxes.list."
       }
     ],
     query: [
@@ -13731,7 +14108,8 @@ for more details.`
     pathParams: [
       {
         name: "sandbox_id",
-        sdkName: "sandbox_id"
+        sdkName: "sandbox_id",
+        description: "Sandbox ID returned by sandboxes.create or sandboxes.list."
       }
     ],
     query: [
@@ -13792,7 +14170,8 @@ for more details.`
     pathParams: [
       {
         name: "snapshotID",
-        sdkName: "snapshotID"
+        sdkName: "snapshotID",
+        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."
       }
     ],
     query: []
@@ -13875,7 +14254,8 @@ for more details.`
     pathParams: [
       {
         name: "volumeID",
-        sdkName: "volumeID"
+        sdkName: "volumeID",
+        description: "Id of the team volume, the `volumeID` returned by createVolume or listVolumes."
       }
     ],
     query: []
@@ -13892,7 +14272,8 @@ for more details.`
     pathParams: [
       {
         name: "volumeID",
-        sdkName: "volumeID"
+        sdkName: "volumeID",
+        description: "Id of the team volume, the `volumeID` returned by createVolume or listVolumes."
       }
     ],
     query: []
@@ -14611,7 +14992,8 @@ for more details.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers."
       }
     ],
     query: [
@@ -14635,7 +15017,8 @@ for more details.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers."
       }
     ],
     query: [
@@ -14659,7 +15042,8 @@ for more details.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers."
       }
     ],
     query: [
@@ -14700,7 +15084,8 @@ for more details.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers."
       }
     ],
     query: [
@@ -14736,7 +15121,8 @@ for more details.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers."
       }
     ],
     query: [
@@ -14781,11 +15167,13 @@ for more details.`
     pathParams: [
       {
         name: "id",
-        sdkName: "id"
+        sdkName: "id",
+        description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers."
       },
       {
         name: "content",
-        sdkName: "content"
+        sdkName: "content",
+        description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers."
       }
     ],
     query: [
@@ -14882,7 +15270,8 @@ for more details.`
     pathParams: [
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        description: "Label name from the repository label list."
       }
     ],
     query: [
@@ -14906,7 +15295,8 @@ for more details.`
     pathParams: [
       {
         name: "name",
-        sdkName: "name"
+        sdkName: "name",
+        description: "Label name from the repository label list."
       }
     ],
     query: [
@@ -15036,7 +15426,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Milestone number shown by create and list; not the object id."
       }
     ],
     query: [
@@ -15060,7 +15452,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Milestone number shown by create and list; not the object id."
       }
     ],
     query: [
@@ -15084,7 +15478,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Milestone number shown by create and list; not the object id."
       }
     ],
     query: [
@@ -15271,7 +15667,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15295,7 +15693,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15389,7 +15789,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15425,7 +15827,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15466,7 +15870,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15502,7 +15908,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15537,11 +15945,15 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       },
       {
         name: "n",
-        sdkName: "n"
+        sdkName: "n",
+        type: "integer",
+        description: "Number of the other ticket in the relation or dependency."
       }
     ],
     query: [
@@ -15565,7 +15977,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15601,7 +16015,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15637,7 +16053,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15661,7 +16079,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15702,7 +16122,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15738,7 +16160,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15783,11 +16207,14 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       },
       {
         name: "content",
-        sdkName: "content"
+        sdkName: "content",
+        description: "Identifier returned by the matching create or list operation; number paths take repository-local numbers."
       }
     ],
     query: [
@@ -15811,7 +16238,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15847,7 +16276,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15882,11 +16313,15 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       },
       {
         name: "n",
-        sdkName: "n"
+        sdkName: "n",
+        type: "integer",
+        description: "Number of the other ticket in the relation or dependency."
       }
     ],
     query: [
@@ -15910,7 +16345,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15946,7 +16383,9 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       }
     ],
     query: [
@@ -15987,11 +16426,15 @@ for more details.`
     pathParams: [
       {
         name: "number",
-        sdkName: "number"
+        sdkName: "number",
+        type: "integer",
+        description: "Ticket number shown by create and list (#12 is 12); not the tk_ id."
       },
       {
         name: "child",
-        sdkName: "child"
+        sdkName: "child",
+        type: "integer",
+        description: "Number of the sub-ticket to detach."
       }
     ],
     query: [
@@ -16091,7 +16534,8 @@ for more details.`
     pathParams: [
       {
         name: "authorization_id",
-        sdkName: "authorization_id"
+        sdkName: "authorization_id",
+        description: "ID of the authorization in your account, returned when authorization is created."
       }
     ],
     query: []
@@ -16108,7 +16552,8 @@ for more details.`
     pathParams: [
       {
         name: "token",
-        sdkName: "token"
+        sdkName: "token",
+        description: "One-time token from connect_url."
       }
     ],
     query: []
@@ -16125,7 +16570,8 @@ for more details.`
     pathParams: [
       {
         name: "token",
-        sdkName: "token"
+        sdkName: "token",
+        description: "One-time token from connect_url."
       }
     ],
     query: []
@@ -16142,7 +16588,8 @@ for more details.`
     pathParams: [
       {
         name: "token",
-        sdkName: "token"
+        sdkName: "token",
+        description: "One-time token from connect_url."
       }
     ],
     query: []
@@ -16279,7 +16726,8 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       }
     ],
     query: []
@@ -16296,7 +16744,8 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       }
     ],
     query: []
@@ -16313,7 +16762,8 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       }
     ],
     query: [],
@@ -16347,7 +16797,8 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       }
     ],
     query: []
@@ -16364,7 +16815,8 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       }
     ],
     query: [
@@ -16400,7 +16852,8 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       }
     ],
     query: [
@@ -16436,7 +16889,8 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       }
     ],
     query: [],
@@ -16510,11 +16964,13 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       },
       {
         name: "secret",
-        sdkName: "secret"
+        sdkName: "secret",
+        description: "Secret name, or its vsec_ ID."
       }
     ],
     query: []
@@ -16531,11 +16987,13 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       },
       {
         name: "secret",
-        sdkName: "secret"
+        sdkName: "secret",
+        description: "Secret name, or its vsec_ ID."
       }
     ],
     query: []
@@ -16552,11 +17010,13 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       },
       {
         name: "secret",
-        sdkName: "secret"
+        sdkName: "secret",
+        description: "Secret name, or its vsec_ ID."
       }
     ],
     query: [],
@@ -16603,11 +17063,13 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       },
       {
         name: "secret",
-        sdkName: "secret"
+        sdkName: "secret",
+        description: "Secret name, or its vsec_ ID."
       }
     ],
     query: []
@@ -16624,11 +17086,13 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       },
       {
         name: "secret",
-        sdkName: "secret"
+        sdkName: "secret",
+        description: "Secret name, or its vsec_ ID."
       }
     ],
     query: [],
@@ -16659,11 +17123,13 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       },
       {
         name: "secret",
-        sdkName: "secret"
+        sdkName: "secret",
+        description: "Secret name, or its vsec_ ID."
       }
     ],
     query: []
@@ -16680,7 +17146,8 @@ for more details.`
     pathParams: [
       {
         name: "vault_id",
-        sdkName: "vault_id"
+        sdkName: "vault_id",
+        description: "ID of the vault in your account, returned when the vault is created."
       }
     ],
     query: [],
@@ -25149,7 +25616,7 @@ function operationOptions(op) {
     if (p === target)
       continue;
     const before = op.path.slice(0, op.path.indexOf(`{${p.name}}`)).split("/").filter(Boolean).at(-1);
-    specs.push({ name: before.startsWith("{") ? kebab(p.sdkName) : singular(kebab(before)), type: "string", required: true, location: "path", sdkName: p.sdkName });
+    specs.push({ name: before.startsWith("{") ? kebab(p.sdkName) : singular(kebab(before)), type: p.type ?? "string", required: true, location: "path", sdkName: p.sdkName, ...p.description ? { description: p.description } : {} });
   }
   for (const location of ["query", "body"]) {
     const fields = location === "query" ? op.query : op.body?.fields ?? [];
@@ -25247,7 +25714,7 @@ function convert(value, spec) {
   } else if (spec.type === "number" || spec.type === "integer") {
     const n = typeof value === "string" && value.trim() ? Number(value) : NaN;
     if (!Number.isFinite(n) || spec.type === "integer" && !Number.isSafeInteger(n))
-      throw new UsageError(`--${spec.name} must be ${spec.type}`);
+      throw new UsageError(`--${spec.name} must be ${spec.type}`, spec.location === "path" ? spec.description : undefined);
     result = n;
   } else if (typeof value !== "string")
     throw new UsageError(`--${spec.name} requires a value`);
@@ -25295,8 +25762,13 @@ function bindArgs(parsed, op, data) {
   if (target) {
     if (parsed.positional[0] === undefined)
       missing.push(`<${target.sdkName}> (target ID)`);
-    else
-      opts.path = { [target.sdkName]: parsed.positional[0] };
+    else {
+      const raw = parsed.positional[0];
+      if (target.type && !(target.type === "integer" ? Number.isSafeInteger(Number(raw)) : Number.isFinite(Number(raw))) || target.type && !raw.trim()) {
+        throw new UsageError(`<${target.sdkName}> must be ${target.type}`, target.description);
+      }
+      opts.path = { [target.sdkName]: target.type ? Number(raw) : raw };
+    }
   }
   if (data !== undefined)
     opts.body = data;
@@ -25373,9 +25845,10 @@ function help(commands, prefix, command) {
       `praxis ${command.words.join(" ")}${target ? ` <${target.sdkName}>` : ""} [options]`,
       `SDK: ${command.op.resource}.${command.alias ?? command.op.method}`,
       `${command.op.http} ${command.op.path}`,
-      ...target ? [`Position: <${target.sdkName}> (required target ID)`] : [],
+      ...target ? [`Position: <${target.sdkName}>${target.type ? ` <${target.type}>` : ""} (required target ID)`] : [],
       "",
       "Options:",
+      ...target?.description ? [`  <${target.sdkName}> — ${target.description.replace(/\s+/g, " ")}`] : [],
       ...[...operationOptions(command.op), ...command.op.body ? [dataOption] : [], ...globalOptions].map((s) => `  ${describeOption(s)}`),
       ...command.op.body?.fields.filter((f) => f.type === "object" || f.type === "array" && !["string", "number", "integer", "boolean"].includes(f.itemType ?? "")).map((f) => `  --data: ${f.name} (${f.type}${f.required ? ", required" : ""})`) ?? [],
       "  -h is an alias of --help",
@@ -26556,7 +27029,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
 }
 
 // src/main.ts
-var version = "0.1.0-dev.35d57f8";
+var version = "0.1.0-dev.3fd48e7";
 var commands = commandTree(operations);
 var manual = [["login"], ["logout"], ["whoami"], ["org", "list"], ["org", "switch"], ["api"], ["skill"]];
 function route(argv) {