@naturali/cli 0.180.0 → 0.182.0

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.180.0";
+var version = "0.182.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -1162,6 +1162,18 @@ var Admin = class {
 		});
 	}
 	/**
+	* Read a user's usage this billing cycle
+	*
+	* The same answer `GET /v1/users/me/usage` gives the account itself: runs, indexed storage and the plan-capped counts, per project and against the rung. Needs the `admin` role.
+	*
+	*/
+	static getUserUsage(options) {
+		return (options.client ?? client).get({
+			url: "/v1/admin/users/{user_id}/usage",
+			...options
+		});
+	}
+	/**
 	* Read the global price book
 	*
 	* The upstream runtime's global default prices — the rows carrying neither a provider nor a project, which is all the upstream listing returns, so no tenant's own rates appear here.
@@ -1505,6 +1517,7 @@ var AiProviders = class {
 	* Listing resolves credentials the same way generation does, so a record that can generate can list. The API-key types (`openai`, `groq`, `xai`, `gateway`, `custom`, `anthropic`, `google`) use the record's linked secret and cannot list without one. `bedrock` and `vertex` use the linked secret — IAM keys or a Bedrock API key, a Google service-account key. A record with no `secret_id` would fall back to the server's own credentials (the AWS default credential chain, Google Application Default Credentials); it can list only on a deployment that allows a record to use them, and returns `400 AI_PROVIDER_MISCONFIGURED` otherwise.
 	* A Vertex record needs no `config.project` when its secret is a service-account key, since the key file names its own project. A Vertex record in express mode (API key) cannot list at all: the publisher-model listing rejects API keys and needs a credential that asserts a principal, so it returns `400 MODEL_LISTING_UNSUPPORTED`.
 	* The Vertex answer is the publisher catalogue the record's `config.location` region serves. The project behind the credential is billed and quota'd for the call but does not filter the result, so a listed model may still be unavailable to that project at generation time.
+	* The provider answers its whole catalogue in one call; `q`, `limit` and `offset` narrow and page what it returned. A request without `limit` gets the first 50 models.
 	*
 	*/
 	static listAiProviderModels(options) {
@@ -1779,6 +1792,34 @@ var Assistant = class {
 		});
 	}
 	/**
+	* Delete a conversation
+	*
+	* Deletes one of your conversations and its messages. What its turns cost stays on your usage.
+	*
+	*/
+	static deleteAssistantSession(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/assistant/sessions/{session_id}",
+			...options
+		});
+	}
+	/**
+	* Rename a conversation
+	*
+	* Sets the name the conversation is listed by. A name given before the first message is kept.
+	*
+	*/
+	static renameAssistantSession(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/assistant/sessions/{session_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
 	* Read a conversation
 	*
 	* The newest 100 messages of one conversation, oldest first.
@@ -3255,6 +3296,18 @@ var Generations = class {
 		});
 	}
 	/**
+	* List the memory writes a generation made
+	*
+	* Every memory write this turn made, oldest first: each memory rule's firings and the agent's own `write_memory` calls alike. The rows behind the generation's per-rule `extraction` counts. Reading them is reading the generation (`generations:GetGeneration`).
+	*
+	*/
+	static listGenerationMemoryAssertions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/generations/{generation_id}/memory-assertions",
+			...options
+		});
+	}
+	/**
 	* Get a generation's transcript
 	*
 	* Returns one generation's turn read back as an ordered sequence of steps: what it was asked, each model step with its tool calls and results, and how it ended.
@@ -4203,8 +4256,8 @@ var Orchestrations = class {
 	/**
 	* Get orchestration queue stats
 	*
-	* Returns a point-in-time snapshot of the orchestration run queue: how many tasks are waiting to be claimed (`queue_depth`), how many are currently claimed with a valid lease (`claimed_tasks`), the age of the oldest waiting task, recent claim-latency percentiles over a rolling in-process window, and a per-project breakdown. Intended for admin/operator policies; guarded by `orchestrations:GetQueueStats`.
-	* Every figure is scoped to what the caller may see. A project-scoped caller gets `per_project` for their own projects only, `queue_depth` and `claimed_tasks` summed over those same projects, and `null` for `oldest_queued_age_seconds` and the `claim_latency_ms` percentiles — both describe the whole deployment and cannot be narrowed, so they are withheld rather than approximated. An unrestricted caller (the action granted on every project) gets the deployment-wide figures.
+	* Returns a point-in-time snapshot of the orchestration run queue: how many tasks are waiting to be claimed (`queue_depth`), how many are currently claimed with a valid lease (`claimed_tasks`), the age of the oldest waiting task, recent claim-latency percentiles over a rolling in-process window. The per-project breakdown is listed by `GET /v1/projects/{project_id}/orchestrations/queue/stats/projects`. Intended for admin/operator policies; guarded by `orchestrations:GetQueueStats`.
+	* Every figure is scoped to what the caller may see. A project-scoped caller gets `queue_depth` and `claimed_tasks` summed over their own projects, and `null` for `oldest_queued_age_seconds` and the `claim_latency_ms` percentiles — both describe the whole deployment and cannot be narrowed, so they are withheld rather than approximated. An unrestricted caller (the action granted on every project) gets the deployment-wide figures.
 	*
 	*/
 	static getQueueStats(options) {
@@ -4223,6 +4276,27 @@ var Orchestrations = class {
 		});
 	}
 	/**
+	* List the projects with queued orchestration work
+	*
+	* One row per project with any queued or claimed task, ordered by project ID: the per-project breakdown of `GET /v1/projects/{project_id}/orchestrations/queue/stats`. A project-scoped caller sees its own projects only. Guarded by `orchestrations:GetQueueStats`.
+	*
+	*/
+	static listQueueStatsProjects(options) {
+		return (options.client ?? client).get({
+			security: [{
+				key: "bearerAuth",
+				scheme: "bearer",
+				type: "http"
+			}, {
+				key: "oauth2",
+				scheme: "bearer",
+				type: "http"
+			}],
+			url: "/v1/projects/{project_id}/orchestrations/queue/stats/projects",
+			...options
+		});
+	}
+	/**
 	* Delete an orchestration
 	*
 	* Deletes an orchestration definition and all its runs.
@@ -4396,6 +4470,17 @@ var Orchestrations = class {
 			...options
 		});
 	}
+	/**
+	* List a run's node executions
+	*
+	* The run's per-node execution records, oldest first: one per node attempt, retries and skipped nodes included. Each captures the resolved input, output, status and error of that attempt — the orchestration analogue of an LLM trace. Reading them is reading the run (`orchestrations:GetRun`).
+	*/
+	static listOrchestrationRunNodeExecutions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/orchestration-runs/{orchestration_run_id}/node-executions",
+			...options
+		});
+	}
 };
 var Projects = class {
 	/**
@@ -5217,7 +5302,7 @@ var Traces = class {
 	/**
 	* Get trace tree
 	*
-	* Returns the full execution tree rooted at the given trace (or its root if the given trace is a child). Each node represents one agent's execution session. The `children` array contains traces triggered by sub-agent tool calls from that trace.
+	* Returns the full execution tree rooted at the given trace (or its root if the given trace is a child). Each node represents one agent's execution session. The `children` array contains traces triggered by sub-agent tool calls from that trace. A node's generations are listed by `GET /v1/projects/{project_id}/generations?trace_id=`, and a node's direct children page by `GET /v1/projects/{project_id}/traces?parent_trace_id=`.
 	*
 	*/
 	static getTraceTree(options) {
@@ -5417,7 +5502,9 @@ var Users = class {
 		});
 	}
 	/**
-	* Get the current account's runs this billing cycle
+	* Get the current account's usage this billing cycle
+	*
+	* What the account uses this billing cycle, per project and against its plan: runs, indexed storage, and the counts the plan caps — projects, active channels and triggers.
 	*
 	* How many runs the account has made this billing cycle, and how many its plan includes. A **run is one agent generation or one tool call** — the unit every rung is priced in. Every tool call counts, including those an agent makes inside a generation; a `client` tool counts nothing.
 	*
@@ -5429,7 +5516,7 @@ var Users = class {
 	*
 	* **This route counts live; the refusal reads a figure counted every few minutes.** So the two can differ by a burst: this is the more current number, and a refusal quotes the one it actually enforced.
 	*
-	* It is also more expensive than the balance read: it asks the meter once per project. Poll it on the order of minutes, not seconds.
+	* It is also more expensive than the balance read: it reads the runtime several times per project. Poll it on the order of minutes, not seconds. A figure that could not be read is `null` rather than failing the request.
 	*
 	*/
 	static getCurrentUserUsage(options) {
@@ -5439,6 +5526,22 @@ var Users = class {
 		});
 	}
 	/**
+	* List the current account's credit ledger
+	*
+	* A cursor page of the account's model-credit ledger, newest first, with the balance the whole ledger sums to. The ledger is append-only: a correction is a new line, never an edit.
+	*
+	* A `usage` line is managed model spend, written as the meter is reconciled every 15 minutes per project, so the ledger grows by a line per project per window that spent anything. Filter with `kind`.
+	*
+	* The other side of a marketplace line is another account's project, so a `fee` or `earned` line names the cycle it settles, not that project.
+	*
+	*/
+	static listCurrentUserCredits(options) {
+		return (options?.client ?? client).get({
+			url: "/v1/users/me/credits",
+			...options
+		});
+	}
+	/**
 	* List what a billing ceiling stopped
 	*
 	* Schedule triggers, eval runs, orchestration runs and workflow tasks the platform stopped on this account's projects because the credit balance went below zero or a Free plan's runs ran out, and that have not been restored or dismissed yet. Newest first.
@@ -6751,7 +6854,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -6890,14 +6993,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -7511,7 +7614,11 @@ const routes = {
 		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
 		httpMethod: "get",
 		pathParams: ["user_id"],
-		queryParams: ["limit", "cursor"],
+		queryParams: [
+			"kind",
+			"limit",
+			"cursor"
+		],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -7522,6 +7629,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "kind",
+				"description": "Only lines of this kind.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
@@ -7579,6 +7693,24 @@ const routes = {
 			}
 		]
 	},
+	"get-user-usage": {
+		serviceClass: "Admin",
+		operationId: "getUserUsage",
+		description: "The same answer `GET /v1/users/me/usage` gives the account itself: runs, indexed storage and the plan-capped counts, per project and against the rung. Needs the `admin` role.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		httpMethod: "get",
+		pathParams: ["user_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "user_id",
+			"description": "",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"get-admin-price-book": {
 		serviceClass: "Admin",
 		operationId: "getAdminPriceBook",
@@ -7707,14 +7839,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -7853,7 +7985,7 @@ const routes = {
 			},
 			{
 				"name": "prompt_caching",
-				"description": "Prompt caching for this agent's turns. `{\"enabled\": true}` marks a cache breakpoint at the end of the turn's static prefix — the tool definitions and the instructions together — so a provider that caches by explicit breakpoint reads that prefix back on every later step of the turn and every later turn of the session instead of being charged for it again. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. An agent with no `instructions` has no block to mark and caches nothing. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage.",
+				"description": "Prompt caching for this agent's turns. `{\"enabled\": true}` marks two cache breakpoints: the end of the system block, which covers the tool definitions and the instructions, and the last message of each step, which covers the conversation so far. A provider that caches by explicit breakpoint then reads, on every later step and every later turn of the session, the whole prefix the previous one sent, and writes only what was appended. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. A prefix below the model's minimum cacheable length is not cached. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage; a write with no `cache_write_tokens` price bills at the input rate.",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -8065,7 +8197,7 @@ const routes = {
 			},
 			{
 				"name": "prompt_caching",
-				"description": "Prompt caching for this agent's turns. `{\"enabled\": true}` marks a cache breakpoint at the end of the turn's static prefix — the tool definitions and the instructions together — so a provider that caches by explicit breakpoint reads that prefix back on every later step of the turn and every later turn of the session instead of being charged for it again. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. An agent with no `instructions` has no block to mark and caches nothing. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage.",
+				"description": "Prompt caching for this agent's turns. `{\"enabled\": true}` marks two cache breakpoints: the end of the system block, which covers the tool definitions and the instructions, and the last message of each step, which covers the conversation so far. A provider that caches by explicit breakpoint then reads, on every later step and every later turn of the session, the whole prefix the previous one sent, and writes only what was appended. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. A prefix below the model's minimum cacheable length is not cached. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage; a write with no `cache_write_tokens` price bills at the input rate.",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -8260,7 +8392,7 @@ const routes = {
 			},
 			{
 				"name": "prompt_caching",
-				"description": "Prompt caching for this agent's turns. `{\"enabled\": true}` marks a cache breakpoint at the end of the turn's static prefix — the tool definitions and the instructions together — so a provider that caches by explicit breakpoint reads that prefix back on every later step of the turn and every later turn of the session instead of being charged for it again. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. An agent with no `instructions` has no block to mark and caches nothing. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage.",
+				"description": "Prompt caching for this agent's turns. `{\"enabled\": true}` marks two cache breakpoints: the end of the system block, which covers the tool definitions and the instructions, and the last message of each step, which covers the conversation so far. A provider that caches by explicit breakpoint then reads, on every later step and every later turn of the session, the whole prefix the previous one sent, and writes only what was appended. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. A prefix below the model's minimum cacheable length is not cached. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage; a write with no `cache_write_tokens` price bills at the input rate.",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -8533,14 +8665,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -8753,14 +8885,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Number of results per page",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -8959,26 +9091,54 @@ const routes = {
 	"list-ai-provider-models": {
 		serviceClass: "AIProviders",
 		operationId: "listAiProviderModels",
-		description: "Asks the provider which models it can run, using this provider record's own credentials and configuration, and returns provider-native model ids — the same strings `default_model` and an agent's `model` carry. Which models are reachable is a property of the credential, not of the provider type: a Vertex provider sees only the publisher models its Google Cloud project and location serve, and a Bedrock provider only the foundation models enabled in its region. Reading the list is how a caller avoids pinning a model that fails at generation time. Not every provider type can answer. `azure` lists deployments an operator named rather than models, and `ollama` lists whatever was pulled onto that host, so both return `400 MODEL_LISTING_UNSUPPORTED`. Listing resolves credentials the same way generation does, so a record that can generate can list. The API-key types (`openai`, `groq`, `xai`, `gateway`, `custom`, `anthropic`, `google`) use the record's linked secret and cannot list without one. `bedrock` and `vertex` use the linked secret — IAM keys or a Bedrock API key, a Google service-account key. A record with no `secret_id` would fall back to the server's own credentials (the AWS default credential chain, Google Application Default Credentials); it can list only on a deployment that allows a record to use them, and returns `400 AI_PROVIDER_MISCONFIGURED` otherwise. A Vertex record needs no `config.project` when its secret is a service-account key, since the key file names its own project. A Vertex record in express mode (API key) cannot list at all: the publisher-model listing rejects API keys and needs a credential that asserts a principal, so it returns `400 MODEL_LISTING_UNSUPPORTED`. The Vertex answer is the publisher catalogue the record's `config.location` region serves. The project behind the credential is billed and quota'd for the call but does not filter the result, so a listed model may still be unavailable to that project at generation time.",
+		description: "Asks the provider which models it can run, using this provider record's own credentials and configuration, and returns provider-native model ids — the same strings `default_model` and an agent's `model` carry. Which models are reachable is a property of the credential, not of the provider type: a Vertex provider sees only the publisher models its Google Cloud project and location serve, and a Bedrock provider only the foundation models enabled in its region. Reading the list is how a caller avoids pinning a model that fails at generation time. Not every provider type can answer. `azure` lists deployments an operator named rather than models, and `ollama` lists whatever was pulled onto that host, so both return `400 MODEL_LISTING_UNSUPPORTED`. Listing resolves credentials the same way generation does, so a record that can generate can list. The API-key types (`openai`, `groq`, `xai`, `gateway`, `custom`, `anthropic`, `google`) use the record's linked secret and cannot list without one. `bedrock` and `vertex` use the linked secret — IAM keys or a Bedrock API key, a Google service-account key. A record with no `secret_id` would fall back to the server's own credentials (the AWS default credential chain, Google Application Default Credentials); it can list only on a deployment that allows a record to use them, and returns `400 AI_PROVIDER_MISCONFIGURED` otherwise. A Vertex record needs no `config.project` when its secret is a service-account key, since the key file names its own project. A Vertex record in express mode (API key) cannot list at all: the publisher-model listing rejects API keys and needs a credential that asserts a principal, so it returns `400 MODEL_LISTING_UNSUPPORTED`. The Vertex answer is the publisher catalogue the record's `config.location` region serves. The project behind the credential is billed and quota'd for the call but does not filter the result, so a listed model may still be unavailable to that project at generation time. The provider answers its whole catalogue in one call; `q`, `limit` and `offset` narrow and page what it returned. A request without `limit` gets the first 50 models.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/ai-providers",
 		httpMethod: "get",
 		pathParams: ["project_id", "ai_provider_id"],
-		queryParams: [],
+		queryParams: [
+			"q",
+			"limit",
+			"offset"
+		],
 		headerParams: [],
 		cookieParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "ai_provider_id",
-			"description": "AI Provider ID",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "ai_provider_id",
+				"description": "AI Provider ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "q",
+				"description": "Keeps the models whose `id` or `display_name` contains this text, ignoring case. Applied before paging, so `total` counts the matches.\n",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
 	},
 	"get-ai-provider-prices": {
 		serviceClass: "AIProviders",
@@ -9231,14 +9391,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -9284,14 +9444,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of groups to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of groups to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -9511,6 +9671,48 @@ const routes = {
 		cookieParams: [],
 		flags: []
 	},
+	"rename-assistant-session": {
+		serviceClass: "Assistant",
+		operationId: "renameAssistantSession",
+		description: "Sets the name the conversation is listed by. A name given before the first message is kept.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/assistant",
+		httpMethod: "patch",
+		pathParams: ["session_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "session_id",
+			"description": "Assistant session ID, as listed.",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "name",
+			"description": "Trimmed before it is stored.",
+			"required": true,
+			"type": "string",
+			"in": "body"
+		}]
+	},
+	"delete-assistant-session": {
+		serviceClass: "Assistant",
+		operationId: "deleteAssistantSession",
+		description: "Deletes one of your conversations and its messages. What its turns cost stays on your usage.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/assistant",
+		httpMethod: "delete",
+		pathParams: ["session_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "session_id",
+			"description": "Assistant session ID, as listed.",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-assistant-session-messages": {
 		serviceClass: "Assistant",
 		operationId: "listAssistantSessionMessages",
@@ -9624,14 +9826,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Number of results per page (1–200, default 25)",
+				"description": "Results per page. Above 200 it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -9872,14 +10074,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -10777,14 +10979,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -10962,14 +11164,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -11250,14 +11452,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -11484,14 +11686,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -11668,14 +11870,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -11831,14 +12033,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -12152,22 +12354,39 @@ const routes = {
 		moduleDocsUrl: "https://naturali.ai/docs/modules/documents",
 		httpMethod: "get",
 		pathParams: ["project_id", "document_id"],
-		queryParams: [],
+		queryParams: ["limit", "offset"],
 		headerParams: [],
 		cookieParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "document_id",
-			"description": "",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "document_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
 	},
 	"create-document-relation": {
 		serviceClass: "Documents",
@@ -12347,14 +12566,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -12645,14 +12864,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -12809,14 +13028,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -13036,14 +13255,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -13256,14 +13475,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -13408,14 +13627,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -13507,14 +13726,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -13642,14 +13861,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -14135,14 +14354,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -14320,14 +14539,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -14429,14 +14648,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -14525,6 +14744,47 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"list-generation-memory-assertions": {
+		serviceClass: "Generations",
+		operationId: "listGenerationMemoryAssertions",
+		description: "Every memory write this turn made, oldest first: each memory rule's firings and the agent's own `write_memory` calls alike. The rows behind the generation's per-rule `extraction` counts. Reading them is reading the generation (`generations:GetGeneration`).",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/generations",
+		httpMethod: "get",
+		pathParams: ["project_id", "generation_id"],
+		queryParams: ["limit", "offset"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "generation_id",
+				"description": "Public ID of the generation",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
 	"get-generation-transcript": {
 		serviceClass: "Generations",
 		operationId: "getGenerationTranscript",
@@ -14569,14 +14829,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -14803,14 +15063,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -14968,14 +15228,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Number of results per page",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -15804,14 +16064,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -16086,14 +16346,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -16223,14 +16483,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Number of results per page",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -16510,14 +16770,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -16751,14 +17011,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -16929,14 +17189,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -17127,14 +17387,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -17398,14 +17658,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -17532,7 +17792,7 @@ const routes = {
 	"get-queue-stats": {
 		serviceClass: "Orchestrations",
 		operationId: "getQueueStats",
-		description: "Returns a point-in-time snapshot of the orchestration run queue: how many tasks are waiting to be claimed (`queue_depth`), how many are currently claimed with a valid lease (`claimed_tasks`), the age of the oldest waiting task, recent claim-latency percentiles over a rolling in-process window, and a per-project breakdown. Intended for admin/operator policies; guarded by `orchestrations:GetQueueStats`. Every figure is scoped to what the caller may see. A project-scoped caller gets `per_project` for their own projects only, `queue_depth` and `claimed_tasks` summed over those same projects, and `null` for `oldest_queued_age_seconds` and the `claim_latency_ms` percentiles — both describe the whole deployment and cannot be narrowed, so they are withheld rather than approximated. An unrestricted caller (the action granted on every project) gets the deployment-wide figures.",
+		description: "Returns a point-in-time snapshot of the orchestration run queue: how many tasks are waiting to be claimed (`queue_depth`), how many are currently claimed with a valid lease (`claimed_tasks`), the age of the oldest waiting task, recent claim-latency percentiles over a rolling in-process window. The per-project breakdown is listed by `GET /v1/projects/{project_id}/orchestrations/queue/stats/projects`. Intended for admin/operator policies; guarded by `orchestrations:GetQueueStats`. Every figure is scoped to what the caller may see. A project-scoped caller gets `queue_depth` and `claimed_tasks` summed over their own projects, and `null` for `oldest_queued_age_seconds` and the `claim_latency_ms` percentiles — both describe the whole deployment and cannot be narrowed, so they are withheld rather than approximated. An unrestricted caller (the action granted on every project) gets the deployment-wide figures.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/orchestrations",
 		httpMethod: "get",
 		pathParams: ["project_id"],
@@ -17547,6 +17807,40 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"list-queue-stats-projects": {
+		serviceClass: "Orchestrations",
+		operationId: "listQueueStatsProjects",
+		description: "One row per project with any queued or claimed task, ordered by project ID: the per-project breakdown of `GET /v1/projects/{project_id}/orchestrations/queue/stats`. A project-scoped caller sees its own projects only. Guarded by `orchestrations:GetQueueStats`.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/orchestrations",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: ["limit", "offset"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
 	"get-orchestration": {
 		serviceClass: "Orchestrations",
 		operationId: "getOrchestration",
@@ -17719,14 +18013,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -17871,14 +18165,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -18094,6 +18388,47 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"list-orchestration-run-node-executions": {
+		serviceClass: "Orchestrations",
+		operationId: "listOrchestrationRunNodeExecutions",
+		description: "The run's per-node execution records, oldest first: one per node attempt, retries and skipped nodes included. Each captures the resolved input, output, status and error of that attempt — the orchestration analogue of an LLM trace. Reading them is reading the run (`orchestrations:GetRun`).",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/orchestrations",
+		httpMethod: "get",
+		pathParams: ["project_id", "orchestration_run_id"],
+		queryParams: ["limit", "offset"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "orchestration_run_id",
+				"description": "Public ID of the run (run_...)",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
 	"list-projects": {
 		serviceClass: "Projects",
 		operationId: "listProjects",
@@ -18877,14 +19212,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -19083,14 +19418,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Number of results per page",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -19285,14 +19620,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -19725,14 +20060,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -19894,14 +20229,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -20186,22 +20521,39 @@ const routes = {
 		moduleDocsUrl: "https://naturali.ai/docs/modules/tasks",
 		httpMethod: "get",
 		pathParams: ["project_id", "task_id"],
-		queryParams: [],
+		queryParams: ["limit", "offset"],
 		headerParams: [],
 		cookieParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "task_id",
-			"description": "",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "task_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
 	},
 	"list-tools": {
 		serviceClass: "Tools",
@@ -20223,14 +20575,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -20579,7 +20931,11 @@ const routes = {
 		moduleDocsUrl: "https://naturali.ai/docs/modules/traces",
 		httpMethod: "get",
 		pathParams: ["project_id"],
-		queryParams: ["limit", "offset"],
+		queryParams: [
+			"parent_trace_id",
+			"limit",
+			"offset"
+		],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -20590,16 +20946,23 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "parent_trace_id",
+				"description": "Only the direct children of this trace. A trace naming nothing the caller can read matches nothing rather than widening the listing.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -20633,36 +20996,26 @@ const routes = {
 	"get-trace-tree": {
 		serviceClass: "Traces",
 		operationId: "getTraceTree",
-		description: "Returns the full execution tree rooted at the given trace (or its root if the given trace is a child). Each node represents one agent's execution session. The `children` array contains traces triggered by sub-agent tool calls from that trace.",
+		description: "Returns the full execution tree rooted at the given trace (or its root if the given trace is a child). Each node represents one agent's execution session. The `children` array contains traces triggered by sub-agent tool calls from that trace. A node's generations are listed by `GET /v1/projects/{project_id}/generations?trace_id=`, and a node's direct children page by `GET /v1/projects/{project_id}/traces?parent_trace_id=`.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/traces",
 		httpMethod: "get",
 		pathParams: ["project_id", "trace_id"],
-		queryParams: ["include"],
+		queryParams: [],
 		headerParams: [],
 		cookieParams: [],
-		flags: [
-			{
-				"name": "project_id",
-				"description": "Project public ID (proj_ prefix).",
-				"required": true,
-				"type": "string",
-				"in": "path"
-			},
-			{
-				"name": "trace_id",
-				"description": "Public ID of any trace in the tree (root or child)",
-				"required": true,
-				"type": "string",
-				"in": "path"
-			},
-			{
-				"name": "include",
-				"description": "Comma-separated list of related resources to embed on each node. Supported value: `generations` — attaches all generations that belong to each trace node (including sub-agent generations linked via `initiator_generation_id`).\n",
-				"required": false,
-				"type": "string",
-				"in": "query"
-			}
-		]
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "trace_id",
+			"description": "Public ID of any trace in the tree (root or child)",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
 	},
 	"purge-trace-content": {
 		serviceClass: "Traces",
@@ -20727,14 +21080,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -21117,14 +21470,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -21206,7 +21559,7 @@ const routes = {
 	"get-current-user-usage": {
 		serviceClass: "Users",
 		operationId: "getCurrentUserUsage",
-		description: "How many runs the account has made this billing cycle, and how many its plan includes. A **run is one agent generation or one tool call** — the unit every rung is priced in. Every tool call counts, including those an agent makes inside a generation; a `client` tool counts nothing. Counted across the projects this account is the billing owner of, over the current UTC calendar month, from the meter itself. Archived projects are included: the runs they already made were made. **On the `free` plan the allowance is enforced.** An account that has used it is refused `403 plan_limit_reached` with `resource: \"runs\"` on everything that starts a generation and on a direct tool call — on its own provider credential as much as on a managed model, because a run is a run — until the billing month turns or it upgrades. On `pro` and `business` nothing is refused: runs past the allowance are billed at the overage rate those plans are sold with. A contract plan is not counted. The other thing that stops a managed-model generation is a negative credit balance, which is `GET /v1/users/me/billing`, and it never applies to your own credential. **This route counts live; the refusal reads a figure counted every few minutes.** So the two can differ by a burst: this is the more current number, and a refusal quotes the one it actually enforced. It is also more expensive than the balance read: it asks the meter once per project. Poll it on the order of minutes, not seconds.",
+		description: "What the account uses this billing cycle, per project and against its plan: runs, indexed storage, and the counts the plan caps — projects, active channels and triggers. How many runs the account has made this billing cycle, and how many its plan includes. A **run is one agent generation or one tool call** — the unit every rung is priced in. Every tool call counts, including those an agent makes inside a generation; a `client` tool counts nothing. Counted across the projects this account is the billing owner of, over the current UTC calendar month, from the meter itself. Archived projects are included: the runs they already made were made. **On the `free` plan the allowance is enforced.** An account that has used it is refused `403 plan_limit_reached` with `resource: \"runs\"` on everything that starts a generation and on a direct tool call — on its own provider credential as much as on a managed model, because a run is a run — until the billing month turns or it upgrades. On `pro` and `business` nothing is refused: runs past the allowance are billed at the overage rate those plans are sold with. A contract plan is not counted. The other thing that stops a managed-model generation is a negative credit balance, which is `GET /v1/users/me/billing`, and it never applies to your own credential. **This route counts live; the refusal reads a figure counted every few minutes.** So the two can differ by a burst: this is the more current number, and a refusal quotes the one it actually enforced. It is also more expensive than the balance read: it reads the runtime several times per project. Poll it on the order of minutes, not seconds. A figure that could not be read is `null` rather than failing the request.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/users",
 		httpMethod: "get",
 		pathParams: [],
@@ -21215,6 +21568,44 @@ const routes = {
 		cookieParams: [],
 		flags: []
 	},
+	"list-current-user-credits": {
+		serviceClass: "Users",
+		operationId: "listCurrentUserCredits",
+		description: "A cursor page of the account's model-credit ledger, newest first, with the balance the whole ledger sums to. The ledger is append-only: a correction is a new line, never an edit. A `usage` line is managed model spend, written as the meter is reconciled every 15 minutes per project, so the ledger grows by a line per project per window that spent anything. Filter with `kind`. The other side of a marketplace line is another account's project, so a `fee` or `earned` line names the cycle it settles, not that project.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/users",
+		httpMethod: "get",
+		pathParams: [],
+		queryParams: [
+			"kind",
+			"limit",
+			"cursor"
+		],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "kind",
+				"description": "Only lines of this kind.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "The `next_cursor` of the previous page.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
 	"list-current-user-stops": {
 		serviceClass: "Users",
 		operationId: "listCurrentUserStops",
@@ -21799,14 +22190,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -22033,14 +22424,14 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return",
+				"description": "Results per page. Above the maximum it is clamped, and `limit` in the response reports the page served; below 1 or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"
 			},
 			{
 				"name": "offset",
-				"description": "Number of results to skip",
+				"description": "Results to skip. Negative or not an integer it is `400 VALIDATION_FAILED`.",
 				"required": false,
 				"type": "integer",
 				"in": "query"