@naturali/cli 0.209.3 → 0.209.5

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.209.3";
+var version = "0.209.5";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -807,6 +807,8 @@ var Channels = class {
 	*
 	* `actor_id` binds an actor of this project, so the address speaks as the same actor your own sessions use. A changed actor deletes the address's conversations and their sessions — a session's actor is fixed — and the next message opens a fresh one; the actor naturali created for the address is deleted with them. An actor you bind is never deleted here.
 	*
+	* An identifier no channel kind produces is `400`.
+	*
 	*/
 	static setAddress(options) {
 		return (options.client ?? client).put({
@@ -913,7 +915,7 @@ var Channels = class {
 	/**
 	* Read the whole route table
 	*
-	* Every route across every channel in the project, one read — the table is small by construction (CHANNELS-ROUTING.md §3.6), so this is unpaginated.
+	* Every route across every channel in the project, one read — the table is small by construction, so this is unpaginated.
 	*
 	*/
 	static listProjectChannelRoutes(options) {
@@ -937,7 +939,7 @@ var Channels = class {
 	* Connect a channel
 	*
 	* Connect a channel. The required fields depend on `channel`; no credential is ever returned.
-	* **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application. Returns `501` when the deployment has no `CHANNEL_TOKEN_KEY` configured.
+	* **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application. Returns `501` when this deployment does not enable Discord channels.
 	* **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret:
 	* * **BYOT** (`credential_source: byot`, default) — supply
 	* `phone_number_id` and `access_token` from your own Meta app.
@@ -1508,7 +1510,7 @@ var AiProviders = class {
 	*
 	* Deletes an AI provider configuration.
 	*
-	* Live references — chats, agents, and model routes whose targets name this provider — always block deletion with `409 AI_PROVIDER_HAS_DEPENDENTS`; `force` does not override them, so delete or repoint those resources first. Soft dependents — price overrides and usage/generation records — also block with `409` unless `force=true`, which deletes the provider's price overrides and unlinks its usage history, preserving those rows: each usage event keeps the provider's id as its `ai_provider_id`. The `409` body's `error.meta` reports the counts, a sample of offending IDs, and a `forcible` flag that is `true` when a `force=true` retry would succeed.
+	* Live references — agents and model routes whose targets name this provider — always block deletion with `409 AI_PROVIDER_HAS_DEPENDENTS`; `force` does not override them, so delete or repoint those resources first. Soft dependents — price overrides and usage/generation records — also block with `409` unless `force=true`, which deletes the provider's price overrides and unlinks its usage history, preserving those rows: each usage event keeps the provider's id as its `ai_provider_id`. The `409` body's `error.meta` reports the counts, a sample of offending IDs, and a `forcible` flag that is `true` when a `force=true` retry would succeed.
 	*
 	*/
 	static deleteAiProvider(options) {
@@ -1970,7 +1972,7 @@ var Auth = class {
 	/**
 	* Refresh a session
 	*
-	* Exchanges a valid refresh token for a new access JWT and a rotated refresh token, taken from the body or from the `refresh_token` cookie set at sign-in — a browser sends an empty body and the cookie carries the credential. Refresh tokens are single-use; presenting a previously-rotated token is treated as reuse and revokes the whole session family (createRefreshRotation reuse detection), except within a few seconds of the rotation, where it is treated as two tabs racing on one cookie and rotated again.
+	* Exchanges a valid refresh token for a new access JWT and a rotated refresh token, taken from the body or from the `refresh_token` cookie set at sign-in — a browser sends an empty body and the cookie carries the credential. Refresh tokens are single-use; presenting a previously-rotated token is treated as reuse and revokes the whole session family, except within a few seconds of the rotation, where it is treated as two tabs racing on one cookie and rotated again.
 	*
 	*/
 	static refreshSession(options) {
@@ -4300,8 +4302,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. 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.
+	* 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`.
+	* 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.
 	*
 	*/
 	static getQueueStats(options) {
@@ -4322,7 +4324,7 @@ 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`.
+	* 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.
 	*
 	*/
 	static listQueueStatsProjects(options) {
@@ -5891,7 +5893,7 @@ var Triggers = class {
 	/**
 	* Update a trigger
 	*
-	* Updates an existing trigger's configuration. The type is immutable. Changing `target_type` or `target_id` re-checks the target-start action (`orchestrations:StartRun`, `agents:CreateAgentGeneration` or `tools:CallTool`) against the resulting target, because a firing runs with the trigger creator's authority rather than the updater's. A caller who could not start the new target is answered `403` and the trigger keeps the target it had.
+	* Updates an existing trigger's configuration. The type is immutable. Changing `target_type` or `target_id` re-checks that the caller may start the resulting target, because a firing runs with the trigger creator's authority rather than the updater's. A caller who could not start the new target is answered `403` and the trigger keeps the target it had.
 	*
 	*/
 	static updateTrigger(options) {
@@ -7883,7 +7885,7 @@ const routes = {
 	"set-address": {
 		serviceClass: "Channels",
 		operationId: "setAddress",
-		description: "Upserts the address with its `action`, the actor it speaks as, or both; a field left out is left alone. `action: null` forgets the exception and defers back to the route table; any other `action` requires the same fields a route or channel default would (`agent_id` for `agent`, `text` for `message`). `actor_id` binds an actor of this project, so the address speaks as the same actor your own sessions use. A changed actor deletes the address's conversations and their sessions — a session's actor is fixed — and the next message opens a fresh one; the actor naturali created for the address is deleted with them. An actor you bind is never deleted here.",
+		description: "Upserts the address with its `action`, the actor it speaks as, or both; a field left out is left alone. `action: null` forgets the exception and defers back to the route table; any other `action` requires the same fields a route or channel default would (`agent_id` for `agent`, `text` for `message`). `actor_id` binds an actor of this project, so the address speaks as the same actor your own sessions use. A changed actor deletes the address's conversations and their sessions — a session's actor is fixed — and the next message opens a fresh one; the actor naturali created for the address is deleted with them. An actor you bind is never deleted here. An identifier no channel kind produces is `400`.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/addresses",
 		httpMethod: "put",
 		pathParams: ["project_id", "identifier"],
@@ -8032,7 +8034,7 @@ const routes = {
 		serviceClass: "Admin",
 		operationId: "listUsers",
 		description: "A cursor page of every account, newest first, each with the plan it is on and the balance of its credit ledger. Needs the `admin` role. `email` narrows the page to one account. It matches the whole address case-insensitively and takes no wildcards: an operator looking for `Ana@Acme.com` finds a row stored as `ana@acme.com`, and there is no substring search across customers' addresses. An account with no subscription reads as `free` with a balance of `0`: the absence of a row is the free plan, and the least-privileged rung is also what any unresolvable lookup should answer.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		moduleDocsUrl: "https://naturali.ai/docs",
 		httpMethod: "get",
 		pathParams: [],
 		queryParams: [
@@ -8070,7 +8072,7 @@ const routes = {
 		serviceClass: "Admin",
 		operationId: "setUserRoles",
 		description: "Replaces the platform roles of any user. Needs the `admin` role, and each role that changes needs the caller to hold the role that grants it (today `admin` grants `admin`). Values outside the catalog are rejected with a 400, and a caller cannot remove their own `admin` role.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		moduleDocsUrl: "https://naturali.ai/docs",
 		httpMethod: "put",
 		pathParams: ["user_id"],
 		queryParams: [],
@@ -8094,7 +8096,7 @@ const routes = {
 		serviceClass: "Admin",
 		operationId: "listUserPlanHistory",
 		description: "A cursor page of the account's plan history, newest first, and the rung it is on now. Needs the `admin` role. The history is append-only, so this is the record of who put the account where and why — nothing edits or removes a line. `plan` at the top level is the same value every entitlement check resolves, so one response answers both \"what plan is this?\" and \"how did it get there?\".",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		moduleDocsUrl: "https://naturali.ai/docs",
 		httpMethod: "get",
 		pathParams: ["user_id"],
 		queryParams: ["limit", "cursor"],
@@ -8128,7 +8130,7 @@ const routes = {
 		serviceClass: "Admin",
 		operationId: "grantUserPlan",
 		description: "Puts the account on a rung of the infra ladder. Needs the `admin` role. `PUT` because an account is on exactly one rung at a time, but the change is **recorded rather than overwritten**: the plan history is append-only and the newest line is the account's plan. Setting the rung it already holds still writes a line — a re-confirmation is an act worth a record, and the `reason` given with it would otherwise have nowhere to go. Read the history back with `GET` on this path. An upgrade takes effect at once. A downgrade is the same call with a lower rung and takes effect when the month turns: until then `plan` stays the rung held and `next_plan` names the new one. At the turn, active channels past the new rung's allowance are disabled, oldest first; an upgrade re-enables them. A rung whose content-retention window a contract sets — `enterprise` — **requires `retention_days`**, since nothing else can answer what that window is and an unanswered one bounds nothing. Every other rung sets its own and refuses the field.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		moduleDocsUrl: "https://naturali.ai/docs",
 		httpMethod: "put",
 		pathParams: ["user_id"],
 		queryParams: [],
@@ -8169,7 +8171,7 @@ const routes = {
 		serviceClass: "Admin",
 		operationId: "listUserCredits",
 		description: "A cursor page of the account's credit lines, newest first, with the balance they sum to. Needs the `admin` role — including for the account's own owner, who reads their own balance at `GET /v1/users/me/billing` rather than here. That answers what is left; this is the line-by-line record behind it. What an operator reads it for is writing a correction: the line that was wrong stays on the record, so it has to be legible before it can be compensated for.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		moduleDocsUrl: "https://naturali.ai/docs",
 		httpMethod: "get",
 		pathParams: ["user_id"],
 		queryParams: [
@@ -8214,7 +8216,7 @@ const routes = {
 		serviceClass: "Admin",
 		operationId: "grantUserCredit",
 		description: "Writes one line to the account's credit ledger and answers with the balance it produced. Needs the `admin` role. The ledger is append-only and the balance is its sum — there is no balance to set and no line to edit or delete. A mistake is corrected by writing a **negative** `amount_usd`, which leaves the wrong line on the record beside the one that compensates for it. `kind` is required. Money received and credit given away report differently — one is revenue, the other customer-acquisition cost — so the line says which it is rather than defaulting to one of them. The balance this moves is not yet a ceiling anything enforces; turning it into one is a separate mechanism.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		moduleDocsUrl: "https://naturali.ai/docs",
 		httpMethod: "post",
 		pathParams: ["user_id"],
 		queryParams: [],
@@ -8255,7 +8257,7 @@ const routes = {
 		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",
+		moduleDocsUrl: "https://naturali.ai/docs",
 		httpMethod: "get",
 		pathParams: ["user_id"],
 		queryParams: [],
@@ -8273,7 +8275,7 @@ const routes = {
 		serviceClass: "Admin",
 		operationId: "getAdminPriceBook",
 		description: "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. These are a cost basis, not a tariff: what a customer pays is the plan they bought plus the multiplier in PRICING.md section 3, applied when spend is reconciled. This is the read behind the storage-rate assertion at boot and the pinned embedding rate.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		moduleDocsUrl: "https://naturali.ai/docs",
 		httpMethod: "get",
 		pathParams: [],
 		queryParams: [],
@@ -8285,7 +8287,7 @@ const routes = {
 		serviceClass: "Admin",
 		operationId: "listUserStatements",
 		description: "The same statements the account reads at `GET /v1/users/me/statements`, for an operator to bill from. Needs the `admin` role.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		moduleDocsUrl: "https://naturali.ai/docs",
 		httpMethod: "get",
 		pathParams: ["user_id"],
 		queryParams: ["limit", "cursor"],
@@ -8319,7 +8321,7 @@ const routes = {
 		serviceClass: "Admin",
 		operationId: "listAdminListings",
 		description: "Every listing in one state, newest first — `in_review` by default, the queue an operator works through.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		moduleDocsUrl: "https://naturali.ai/docs",
 		httpMethod: "get",
 		pathParams: [],
 		queryParams: [
@@ -8357,7 +8359,7 @@ const routes = {
 		serviceClass: "Admin",
 		operationId: "setAdminListingState",
 		description: "List a listing in review or one that is suspended, send one in review back to `draft`, or suspend any listing. A listing an operator suspends cannot be resumed by its publisher. An invalid move answers `409 invalid_listing_state`.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		moduleDocsUrl: "https://naturali.ai/docs",
 		httpMethod: "put",
 		pathParams: ["listing_id"],
 		queryParams: [],
@@ -9664,7 +9666,7 @@ const routes = {
 	"delete-ai-provider": {
 		serviceClass: "AIProviders",
 		operationId: "deleteAiProvider",
-		description: "Deletes an AI provider configuration. Live references — chats, agents, and model routes whose targets name this provider — always block deletion with `409 AI_PROVIDER_HAS_DEPENDENTS`; `force` does not override them, so delete or repoint those resources first. Soft dependents — price overrides and usage/generation records — also block with `409` unless `force=true`, which deletes the provider's price overrides and unlinks its usage history, preserving those rows: each usage event keeps the provider's id as its `ai_provider_id`. The `409` body's `error.meta` reports the counts, a sample of offending IDs, and a `forcible` flag that is `true` when a `force=true` retry would succeed.",
+		description: "Deletes an AI provider configuration. Live references — agents and model routes whose targets name this provider — always block deletion with `409 AI_PROVIDER_HAS_DEPENDENTS`; `force` does not override them, so delete or repoint those resources first. Soft dependents — price overrides and usage/generation records — also block with `409` unless `force=true`, which deletes the provider's price overrides and unlinks its usage history, preserving those rows: each usage event keeps the provider's id as its `ai_provider_id`. The `409` body's `error.meta` reports the counts, a sample of offending IDs, and a `forcible` flag that is `true` when a `force=true` retry would succeed.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/ai-providers",
 		httpMethod: "delete",
 		pathParams: ["project_id", "ai_provider_id"],
@@ -9688,7 +9690,7 @@ const routes = {
 			},
 			{
 				"name": "force",
-				"description": "When `true`, delete the provider's price overrides and unlink its usage history so a provider with only soft dependents can be removed. Has no effect on live references (chats, agents, model routes), which always block deletion.\n",
+				"description": "When `true`, delete the provider's price overrides and unlink its usage history so a provider with only soft dependents can be removed. Has no effect on live references (agents, model routes), which always block deletion.\n",
 				"required": false,
 				"type": "boolean",
 				"in": "query"
@@ -10124,7 +10126,7 @@ const routes = {
 			},
 			{
 				"name": "arguments",
-				"description": "Edited arguments to execute instead of the proposed ones. Editing composes a new call, so it additionally requires permission to make that call: `tools:CallTool` on the tool, and for a `builtin` proposal the action's own IAM action. Refused on an item with no `proposed_action`.",
+				"description": "Edited arguments to execute instead of the proposed ones. Editing composes a new call to the tool. Refused on an item with no `proposed_action`.",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -10638,7 +10640,7 @@ const routes = {
 	"refresh-session": {
 		serviceClass: "Auth",
 		operationId: "refreshSession",
-		description: "Exchanges a valid refresh token for a new access JWT and a rotated refresh token, taken from the body or from the `refresh_token` cookie set at sign-in — a browser sends an empty body and the cookie carries the credential. Refresh tokens are single-use; presenting a previously-rotated token is treated as reuse and revokes the whole session family (createRefreshRotation reuse detection), except within a few seconds of the rotation, where it is treated as two tabs racing on one cookie and rotated again.",
+		description: "Exchanges a valid refresh token for a new access JWT and a rotated refresh token, taken from the body or from the `refresh_token` cookie set at sign-in — a browser sends an empty body and the cookie carries the credential. Refresh tokens are single-use; presenting a previously-rotated token is treated as reuse and revokes the whole session family, except within a few seconds of the rotation, where it is treated as two tabs racing on one cookie and rotated again.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/auth",
 		httpMethod: "post",
 		pathParams: [],
@@ -11091,7 +11093,7 @@ const routes = {
 	"list-project-channel-routes": {
 		serviceClass: "Channels",
 		operationId: "listProjectChannelRoutes",
-		description: "Every route across every channel in the project, one read — the table is small by construction (CHANNELS-ROUTING.md §3.6), so this is unpaginated.",
+		description: "Every route across every channel in the project, one read — the table is small by construction, so this is unpaginated.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/channel-routes",
 		httpMethod: "get",
 		pathParams: ["project_id"],
@@ -11143,7 +11145,7 @@ const routes = {
 	"create-channel": {
 		serviceClass: "Channels",
 		operationId: "createChannel",
-		description: "Connect a channel. The required fields depend on `channel`; no credential is ever returned. **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application. Returns `501` when the deployment has no `CHANNEL_TOKEN_KEY` configured. **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret: * **BYOT** (`credential_source: byot`, default) — supply `phone_number_id` and `access_token` from your own Meta app. * **Embedded signup** (`credential_source: embedded_signup`) — supply `code` and `waba_id` from the Meta popup; naturali exchanges the `code` for the token, subscribes its app to the WABA and registers the number for sending when it is not yet, so the customer never hands over a token. Returns `501` on deployments where Meta App credentials are not configured. The project's plan limits how many channels it may hold. At the limit this responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit`, before any credential is acquired. Only `active` channels count, so disabling one frees allowance without deleting it.",
+		description: "Connect a channel. The required fields depend on `channel`; no credential is ever returned. **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application. Returns `501` when this deployment does not enable Discord channels. **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret: * **BYOT** (`credential_source: byot`, default) — supply `phone_number_id` and `access_token` from your own Meta app. * **Embedded signup** (`credential_source: embedded_signup`) — supply `code` and `waba_id` from the Meta popup; naturali exchanges the `code` for the token, subscribes its app to the WABA and registers the number for sending when it is not yet, so the customer never hands over a token. Returns `501` on deployments where Meta App credentials are not configured. The project's plan limits how many channels it may hold. At the limit this responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit`, before any credential is acquired. Only `active` channels count, so disabling one frees allowance without deleting it.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/channels",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -11209,7 +11211,7 @@ const routes = {
 			},
 			{
 				"name": "code",
-				"description": "Required for `embedded_signup`. The short-lived authorization code from the Meta popup; naturali exchanges it for the access token server-side. Never stored or returned.\n",
+				"description": "Required for `embedded_signup`. The short-lived authorization code from the Meta popup; naturali exchanges it for the access token server-side. Never stored or returned. A code Meta rejects (malformed, expired or already used) is `400 invalid_signup_code`.\n",
 				"required": false,
 				"type": "string",
 				"in": "body"
@@ -16232,7 +16234,7 @@ const routes = {
 		serviceClass: "Installs",
 		operationId: "listInstalls",
 		description: "The listings the project installed, newest first.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/installs",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "get",
 		pathParams: ["project_id"],
 		queryParams: ["limit", "cursor"],
@@ -16266,7 +16268,7 @@ const routes = {
 		serviceClass: "Installs",
 		operationId: "createInstall",
 		description: "Install a listing by its id. A listed entry, a draft and a listing in review all install; a suspended one answers `409 listing_suspended`. Installing again answers the existing install. After the publisher removed this project's access, installing answers `403 install_blocked`.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/installs",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "post",
 		pathParams: ["project_id"],
 		queryParams: [],
@@ -16290,7 +16292,7 @@ const routes = {
 		serviceClass: "Installs",
 		operationId: "getInstall",
 		description: "One of the project's installs.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/installs",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "get",
 		pathParams: ["project_id", "install_id"],
 		queryParams: [],
@@ -16314,7 +16316,7 @@ const routes = {
 		serviceClass: "Installs",
 		operationId: "deleteInstall",
 		description: "Remove the install. While the project's agents, ingestion rules or other resources still name the installed resource, this answers `409 install_in_use` with them in `details.references`; `force=true` uninstalls anyway and those resources stop reaching it. A `blocked` install, and the install managed conversion uses, answer `403`.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/installs",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "delete",
 		pathParams: ["project_id", "install_id"],
 		queryParams: ["force"],
@@ -16378,14 +16380,14 @@ const routes = {
 			},
 			{
 				"name": "rrf_k",
-				"description": "The `k` in the reciprocal rank fusion term `1 / (k + rank)`, which sets how steeply a result's contribution decays with its position in each ranked list. A smaller value weights the very top of each list more heavily. Defaults to the deployment's `KNOWLEDGE_RRF_K`, itself 60 by default. Only applies when `query` is provided.",
+				"description": "The `k` in the reciprocal rank fusion term `1 / (k + rank)`, which sets how steeply a result's contribution decays with its position in each ranked list. A smaller value weights the very top of each list more heavily. Defaults to 60. Only applies when `query` is provided.",
 				"required": false,
 				"type": "integer",
 				"in": "body"
 			},
 			{
 				"name": "recency_half_life_days",
-				"description": "Half-life, in days, of a recency decay applied to **memory store** results after fusion: a result's `score` is multiplied by `2 ^ (-age_in_days / recency_half_life_days)`, where age is measured from its `updated_at`. Document results are never decayed. `0` — the default, and the default of the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` — disables the blend entirely; it is a switch, not a lower bound, and sending `0` turns off a deployment-wide decay for this one request. Accepts fractions (`0.5` is twelve hours). How many ranks a given half-life costs depends on `rrf_k`. Only applies when `query` is provided. **No value is known to be safe in general**: every half-life measured against the reference corpus that lifted recency-sensitive queries also cost relevance-sensitive ones, which is why this ships disabled. Measure against your own corpus before setting it — see the Retrieval Quality guide.",
+				"description": "Half-life, in days, of a recency decay applied to **memory store** results after fusion: a result's `score` is multiplied by `2 ^ (-age_in_days / recency_half_life_days)`, where age is measured from its `updated_at`. Document results are never decayed. `0`, the default, disables the blend entirely. Accepts fractions (`0.5` is twelve hours). How many ranks a given half-life costs depends on `rrf_k`. Only applies when `query` is provided. **No value is known to be safe in general**: every half-life measured against the reference corpus that lifted recency-sensitive queries also cost relevance-sensitive ones, which is why this ships disabled. Measure against your own corpus before setting it.",
 				"required": false,
 				"type": "number",
 				"in": "body"
@@ -16452,7 +16454,7 @@ const routes = {
 		serviceClass: "Listings",
 		operationId: "listPublicListings",
 		description: "Every listed entry, newest first. `interface` is what an installing project sees of the resource, read live from the publisher.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/listings",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "get",
 		pathParams: [],
 		queryParams: ["limit", "cursor"],
@@ -16476,7 +16478,7 @@ const routes = {
 		serviceClass: "Listings",
 		operationId: "getPublicListing",
 		description: "One listed entry. A listing that is not listed answers `404`.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/listings",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "get",
 		pathParams: ["listing_id"],
 		queryParams: [],
@@ -16494,7 +16496,7 @@ const routes = {
 		serviceClass: "Listings",
 		operationId: "listListings",
 		description: "The listings the project publishes, newest first.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/listings",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "get",
 		pathParams: ["project_id"],
 		queryParams: ["limit", "cursor"],
@@ -16528,7 +16530,7 @@ const routes = {
 		serviceClass: "Listings",
 		operationId: "createListing",
 		description: "Publish one of the project's tools or agents as a `draft`. Any project member may publish. An agent on a naturali model whose model has no price answers `503 model_not_priced`. A resource that does not exist in the project answers `400 resource_not_found`, and one that already has a listing `409 listing_exists`.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/listings",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "post",
 		pathParams: ["project_id"],
 		queryParams: [],
@@ -16583,7 +16585,7 @@ const routes = {
 		serviceClass: "Listings",
 		operationId: "getListing",
 		description: "One of the project's listings.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/listings",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "get",
 		pathParams: ["project_id", "listing_id"],
 		queryParams: [],
@@ -16607,7 +16609,7 @@ const routes = {
 		serviceClass: "Listings",
 		operationId: "updateListing",
 		description: "Change the title or description, or pause and resume the listing. `state: suspended` stops a `listed` listing for every installing project at once; their installs are kept. `state: listed` resumes a listing you suspended, provided naturali had listed it; nobody reinstalls. A listing naturali suspended cannot be resumed here, and an invalid move answers `409 invalid_listing_state`.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/listings",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "patch",
 		pathParams: ["project_id", "listing_id"],
 		queryParams: [],
@@ -16662,7 +16664,7 @@ const routes = {
 		serviceClass: "Listings",
 		operationId: "deleteListing",
 		description: "Remove a listing and stop sharing its resource. Refused with `409 listing_has_installs` while any project holds an install, in any state: remove each one first, which takes two deletes of `/installs/{install_id}` for an `active` or `suspended` install. The listing's price stops applying from the next minute, and a later listing of the same resource starts from no price. The tool or agent itself is not touched.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/listings",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "delete",
 		pathParams: ["project_id", "listing_id"],
 		queryParams: [],
@@ -16686,7 +16688,7 @@ const routes = {
 		serviceClass: "Listings",
 		operationId: "submitListing",
 		description: "Move a `draft` listing to `in_review`. naturali lists it in the marketplace or sends it back to `draft`. Any other state answers `409 invalid_listing_state`.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/listings",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "post",
 		pathParams: ["project_id", "listing_id"],
 		queryParams: [],
@@ -16710,7 +16712,7 @@ const routes = {
 		serviceClass: "Listings",
 		operationId: "listListingInstalls",
 		description: "Each project that installed the listing, with its usage this billing cycle as last sampled. Never the content of a call.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/listings",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "get",
 		pathParams: ["project_id", "listing_id"],
 		queryParams: ["limit", "cursor"],
@@ -16751,7 +16753,7 @@ const routes = {
 		serviceClass: "Listings",
 		operationId: "deleteListingInstall",
 		description: "Cut one installing project off. An `active` or `suspended` install becomes `blocked`, and that project cannot install the listing again. Deleting a `blocked` install removes it, which lets that project install again.",
-		moduleDocsUrl: "https://naturali.ai/docs/modules/listings",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/marketplace",
 		httpMethod: "delete",
 		pathParams: [
 			"project_id",
@@ -18561,7 +18563,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. 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.",
+		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`. 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.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/orchestrations",
 		httpMethod: "get",
 		pathParams: ["project_id"],
@@ -18579,7 +18581,7 @@ const routes = {
 	"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`.",
+		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.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/orchestrations",
 		httpMethod: "get",
 		pathParams: ["project_id"],
@@ -23534,7 +23536,7 @@ const routes = {
 	"update-trigger": {
 		serviceClass: "Triggers",
 		operationId: "updateTrigger",
-		description: "Updates an existing trigger's configuration. The type is immutable. Changing `target_type` or `target_id` re-checks the target-start action (`orchestrations:StartRun`, `agents:CreateAgentGeneration` or `tools:CallTool`) against the resulting target, because a firing runs with the trigger creator's authority rather than the updater's. A caller who could not start the new target is answered `403` and the trigger keeps the target it had.",
+		description: "Updates an existing trigger's configuration. The type is immutable. Changing `target_type` or `target_id` re-checks that the caller may start the resulting target, because a firing runs with the trigger creator's authority rather than the updater's. A caller who could not start the new target is answered `403` and the trigger keeps the target it had.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/triggers",
 		httpMethod: "patch",
 		pathParams: ["project_id", "trigger_id"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.209.3",
+  "version": "0.209.5",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "keywords": [
     "naturali",
@@ -31,7 +31,7 @@
     "yaml": "^2.9.1"
   },
   "devDependencies": {
-    "@naturali/sdk": "0.209.3",
+    "@naturali/sdk": "0.209.5",
     "@ttoss/openapi-codegen": "^0.10.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",