@naturali/cli 0.181.0 → 0.182.0

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.181.0";
+var version = "0.182.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -1517,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) {
@@ -3295,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.
@@ -4243,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) {
@@ -4263,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.
@@ -4436,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 {
 	/**
@@ -5257,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) {
@@ -6809,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"
@@ -6948,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"
@@ -7794,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"
@@ -7940,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"
@@ -8152,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"
@@ -8347,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"
@@ -8620,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"
@@ -8840,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"
@@ -9046,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",
@@ -9318,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"
@@ -9371,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"
@@ -9753,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"
@@ -10001,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"
@@ -10906,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"
@@ -11091,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"
@@ -11379,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"
@@ -11613,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"
@@ -11797,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"
@@ -11960,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"
@@ -12281,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",
@@ -12476,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"
@@ -12774,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"
@@ -12938,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"
@@ -13165,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"
@@ -13385,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"
@@ -13537,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"
@@ -13636,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"
@@ -13771,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"
@@ -14264,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"
@@ -14449,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"
@@ -14558,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"
@@ -14654,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",
@@ -14698,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"
@@ -14932,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"
@@ -15097,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"
@@ -15933,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"
@@ -16215,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"
@@ -16352,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"
@@ -16639,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"
@@ -16880,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"
@@ -17058,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"
@@ -17256,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"
@@ -17527,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"
@@ -17661,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"],
@@ -17676,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",
@@ -17848,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"
@@ -18000,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"
@@ -18223,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",
@@ -19006,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"
@@ -19212,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"
@@ -19414,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"
@@ -19854,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"
@@ -20023,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"
@@ -20315,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",
@@ -20352,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"
@@ -20708,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: [
@@ -20719,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"
@@ -20762,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",
@@ -20856,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"
@@ -21246,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"
@@ -21966,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"
@@ -22200,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"