@naturali/sdk 0.133.2 → 0.134.0

package/dist/index.cjs

@@ -3725,8 +3725,9 @@ var Projects = class {
 	/**
 	* Update a project
 	*
-	* Rename or archive a project, and/or change its content-retention settings (`trace_content_retention_days`, `trace_content_mode`). Archiving is reversible; resources are retained.
+	* Rename or archive a project, and/or change its content-retention settings (`trace_content_retention_days`, `trace_content_mode`), its execution ceilings (`max_concurrent_runs`, `max_chain_generations`, `max_orchestration_run_depth`) and its priced-model gate (`require_priced_model`). Archiving is reversible; resources are retained.
 	* Requires the `admin` role in the project (an `owner` has it too).
+	* The ceilings and the priced-model gate are uncapped by plan: each one only ever narrows what the project may spend, so setting one takes on a restriction rather than claiming an entitlement. On the three ceilings `null` clears the project's own bound and omission leaves it alone — they are different instructions.
 	* The two retention controls answer different questions. The window bounds how long content *stays* — a daily sweep purges anything past it, leaving auditable skeletons behind. `trace_content_mode: none` means content is never *written*, which is the stronger guarantee: it cannot be missed by a sweep or survive in a backup.
 	*
 	* Your plan sets the longest window you may keep content for. A wider one — `null` included, which keeps content indefinitely — responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit` in days. Anything shorter is always allowed. Moving to a plan with a shorter window takes effect at the end of the billing cycle, and content already stored is then purged by age like everything else.

package/dist/index.d.cts

@@ -768,6 +768,16 @@ type Agent = {
      *
      */
     min_score?: number;
+    /**
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     *
+     */
+    rrf_k?: number;
+    /**
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     *
+     */
+    recency_half_life_days?: number;
     /**
      * Maximum number of results to inject. Omitted, 10 are injected.
      *
@@ -968,6 +978,16 @@ type CreateAgentRequest = {
      *
      */
     min_score?: number;
+    /**
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     *
+     */
+    rrf_k?: number;
+    /**
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     *
+     */
+    recency_half_life_days?: number;
     /**
      * Maximum number of results to inject. Omitted, 10 are injected.
      *
@@ -1066,6 +1086,16 @@ type UpdateAgentRequest = {
      *
      */
     min_score?: number;
+    /**
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     *
+     */
+    rrf_k?: number;
+    /**
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     *
+     */
+    recency_half_life_days?: number;
     /**
      * Maximum number of results to inject. Omitted, 10 are injected.
      *
@@ -1160,7 +1190,7 @@ type CreateAgentGenerationRequest = {
     [key: string]: unknown;
   } | null;
   /**
-   * Per-generation knowledge retrieval override. Array filters (memory_store_ids, document_ids, document_paths) are unioned with the agent's stored knowledge_config; `tags` pairs are merged with the override winning per key; scalar fields (min_score, limit) use the per-generation value when present.
+   * Per-generation knowledge retrieval override. Array filters (memory_store_ids, document_ids, document_paths) are unioned with the agent's stored knowledge_config; `tags` pairs are merged with the override winning per key; scalar fields (min_score, rrf_k, recency_half_life_days, limit) use the per-generation value when present.
    */
   knowledge_config?: {
     memory_store_ids?: Array<string>;
@@ -1175,6 +1205,16 @@ type CreateAgentGenerationRequest = {
      *
      */
     min_score?: number;
+    /**
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     *
+     */
+    rrf_k?: number;
+    /**
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     *
+     */
+    recency_half_life_days?: number;
     /**
      * Maximum number of results to inject. Omitted, 10 are injected.
      *
@@ -3162,9 +3202,17 @@ type AgentResourceProperties = {
      */
     tags?: TagBag;
     /**
-     * Minimum similarity score (0–1) for retrieved chunks
+     * Minimum raw cosine similarity (0–1) a vector candidate must reach to be ranked. Omitted, there is no floor.
      */
     min_score?: number;
+    /**
+     * The `k` in the fusion term `1 / (k + rank)`; smaller weights the top of each ranking more heavily
+     */
+    rrf_k?: number;
+    /**
+     * Half-life in days of the decay applied to memory results after fusion; `0` disables it
+     */
+    recency_half_life_days?: number;
     /**
      * Maximum number of chunks to inject
      */
@@ -3617,6 +3665,12 @@ type TriggerResourceProperties = {
   input?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Caller context every firing forwards to the run it starts, so an agent whose tools authorize through `{{context:<key>}}` can be scheduled. Write-only. A value may be a `{{secret:...}}` reference, which is what a template should carry — the credential stays in the secret store and only its name is checked in
+   */
+  tool_context?: {
+    [key: string]: string;
+  } | null;
   /**
    * 5-field cron expression (UTC). Required when type is schedule
    */
@@ -5556,12 +5610,6 @@ type OrchestrationRun = {
   input?: {
     [key: string]: unknown;
   } | null;
-  /**
-   * The `tool_context` supplied at run creation, forwarded as `X-Naturali-Context-<key>` headers on every tool call the run's agent nodes make. Null when the run was started without one.
-   */
-  tool_context?: {
-    [key: string]: string;
-  } | null;
   /**
    * The caller-owned key/value metadata supplied at run creation, returned verbatim. Null when the run was started without any. The server writes nothing here and no key is reserved; the bag is never merged into `state`, so nothing in it reaches the graph.
    */
@@ -5736,7 +5784,7 @@ type StartOrchestrationRunRequest = {
   /**
    * Key-value pairs forwarded as `X-Naturali-Context-<key>` headers on every `http` and `mcp` tool call made by an agent node of this run — including the agents of any child run a `loop` or `sub_orchestration` node starts. The header name is `X-Naturali-Context-` plus the key verbatim; no character is re-cased.
    *
-   * The bag is stored on the run and re-read on every step, so it survives an `awaiting_input` pause, a `sleeping` wait, a background worker drive and a crash redrive. A key that is not a valid HTTP header name, or two keys that map to the same header, are rejected with `400 INVALID_TOOL_CONTEXT_KEY` and no run is created.
+   * The bag is stored on the run and re-read on every step, so it survives an `awaiting_input` pause, a `sleeping` wait, a background worker drive and a crash redrive. It is **write-only**: a run is a record every principal who may read runs can read, and a credential in it is not theirs to see, so it is never returned on one. A key that is not a valid HTTP header name, or two keys that map to the same header, are rejected with `400 INVALID_TOOL_CONTEXT_KEY` and no run is created.
    *
    * The reserved identity keys (`session_id`, `actor_id`, `actor_external_id`) are stripped at generation time — a caller cannot address them from here.
    */
@@ -5799,6 +5847,26 @@ type Project = {
    *
    */
   trace_content_mode: 'full' | 'none';
+  /**
+   * Orchestration runs of this project driven at once. `null` (the default) is unlimited. Enforced when a run is claimed — runs past the limit wait for a slot rather than failing.
+   *
+   */
+  max_concurrent_runs: number | null;
+  /**
+   * Generations one continuation chain in this project may hold before it stops being resumed. `null` (the default) leaves the platform-wide ceiling in force. The budget actually applied is the smallest of that ceiling, this number, and the agent's own — an agent author can be stricter than this, never looser.
+   *
+   */
+  max_chain_generations: number | null;
+  /**
+   * Nesting levels a run tree in this project may reach before the next child is refused. `null` (the default) leaves the platform-wide bound in force; the bound applied is the smaller of the two.
+   *
+   */
+  max_orchestration_run_depth: number | null;
+  /**
+   * Whether a generation whose model carries no price is refused before the provider is called. `false` by default, which runs the model and meters it at no cost. Mainly of use with your own providers — see [Requiring a priced model](/docs/modules/projects#requiring-a-priced-model).
+   *
+   */
+  require_priced_model: boolean;
   created_at: Date;
   updated_at: Date;
 };
@@ -5886,6 +5954,26 @@ type ProjectUpdate = {
    *
    */
   trace_content_mode?: 'full' | 'none';
+  /**
+   * Orchestration runs driven at once. Send `null` to lift the limit. Omitting the field leaves it unchanged.
+   *
+   */
+  max_concurrent_runs?: number | null;
+  /**
+   * Generations one continuation chain may hold. Send `null` to drop back to the platform-wide ceiling. Omitting the field leaves it unchanged.
+   *
+   */
+  max_chain_generations?: number | null;
+  /**
+   * Nesting levels a run tree may reach. Send `null` to drop back to the platform-wide bound. Omitting the field leaves it unchanged.
+   *
+   */
+  max_orchestration_run_depth?: number | null;
+  /**
+   * Refuse a generation whose model carries no price, before the provider is called. Uncapped by plan — it only ever narrows what the project may spend.
+   *
+   */
+  require_priced_model?: boolean;
 };
 /**
  * Token counts (input_tokens already includes cached input).
@@ -7037,6 +7125,17 @@ type CreateTriggerRequest = {
   input?: {
     [key: string]: unknown;
   };
+  /**
+   * Caller context every firing forwards to the run it starts, so an agent whose tools authorize through `{{context:<key>}}` can be put on a schedule — a firing has no request to carry one. Each key is forwarded as one `X-Naturali-Context-<key>` header.
+   *
+   * **Write-only.** It is accepted here and never returned on a read, so the record cannot be used to recover a value.
+   *
+   * A value may be a `{{secret:...}}` reference, which keeps the credential in the [secret](/docs/modules/secrets) store and leaves only its name on the trigger; it is resolved at fire time, so rotating the secret changes the next firing without touching the trigger. A reference naming a secret that does not exist in this project is refused here rather than at fire time.
+   *
+   */
+  tool_context?: {
+    [key: string]: string;
+  };
   /**
    * 5-field cron expression (UTC). Required when type is schedule
    */
@@ -7057,6 +7156,13 @@ type UpdateTriggerRequest = {
   input?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Replaces the stored bag; `null` clears it. Write-only and resolved at fire time — see `CreateTriggerRequest.tool_context`.
+   *
+   */
+  tool_context?: {
+    [key: string]: string;
+  } | null;
   cron?: string | null;
   event_pattern?: string | null;
   active?: boolean;
@@ -7069,6 +7175,15 @@ type FireTriggerRequest = {
   input?: {
     [key: string]: unknown;
   };
+  /**
+   * Fire-time caller context, shallow-merged per key over the trigger's stored `tool_context`. A manual fire has a caller, so this is the one path that can supply a value without storing it.
+   *
+   * Forwarded exactly as written: a `{{secret:...}}` reference is resolved only in the trigger's stored bag, never in one supplied here.
+   *
+   */
+  tool_context?: {
+    [key: string]: string;
+  };
 };
 type TriggerSecretResponse = {
   secret?: string;
@@ -22709,8 +22824,9 @@ export declare class Projects {
   /**
    * Update a project
    *
-   * Rename or archive a project, and/or change its content-retention settings (`trace_content_retention_days`, `trace_content_mode`). Archiving is reversible; resources are retained.
+   * Rename or archive a project, and/or change its content-retention settings (`trace_content_retention_days`, `trace_content_mode`), its execution ceilings (`max_concurrent_runs`, `max_chain_generations`, `max_orchestration_run_depth`) and its priced-model gate (`require_priced_model`). Archiving is reversible; resources are retained.
    * Requires the `admin` role in the project (an `owner` has it too).
+   * The ceilings and the priced-model gate are uncapped by plan: each one only ever narrows what the project may spend, so setting one takes on a restriction rather than claiming an entitlement. On the three ceilings `null` clears the project's own bound and omission leaves it alone — they are different instructions.
    * The two retention controls answer different questions. The window bounds how long content *stays* — a daily sweep purges anything past it, leaving auditable skeletons behind. `trace_content_mode: none` means content is never *written*, which is the stronger guarantee: it cannot be missed by a sweep or survive in a backup.
    *
    * Your plan sets the longest window you may keep content for. A wider one — `null` included, which keeps content indefinitely — responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit` in days. Anything shorter is always allowed. Moving to a plan with a shorter window takes effect at the end of the billing cycle, and content already stored is then purged by age like everything else.

package/dist/index.d.mts

@@ -768,6 +768,16 @@ type Agent = {
      *
      */
     min_score?: number;
+    /**
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     *
+     */
+    rrf_k?: number;
+    /**
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     *
+     */
+    recency_half_life_days?: number;
     /**
      * Maximum number of results to inject. Omitted, 10 are injected.
      *
@@ -968,6 +978,16 @@ type CreateAgentRequest = {
      *
      */
     min_score?: number;
+    /**
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     *
+     */
+    rrf_k?: number;
+    /**
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     *
+     */
+    recency_half_life_days?: number;
     /**
      * Maximum number of results to inject. Omitted, 10 are injected.
      *
@@ -1066,6 +1086,16 @@ type UpdateAgentRequest = {
      *
      */
     min_score?: number;
+    /**
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     *
+     */
+    rrf_k?: number;
+    /**
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     *
+     */
+    recency_half_life_days?: number;
     /**
      * Maximum number of results to inject. Omitted, 10 are injected.
      *
@@ -1160,7 +1190,7 @@ type CreateAgentGenerationRequest = {
     [key: string]: unknown;
   } | null;
   /**
-   * Per-generation knowledge retrieval override. Array filters (memory_store_ids, document_ids, document_paths) are unioned with the agent's stored knowledge_config; `tags` pairs are merged with the override winning per key; scalar fields (min_score, limit) use the per-generation value when present.
+   * Per-generation knowledge retrieval override. Array filters (memory_store_ids, document_ids, document_paths) are unioned with the agent's stored knowledge_config; `tags` pairs are merged with the override winning per key; scalar fields (min_score, rrf_k, recency_half_life_days, limit) use the per-generation value when present.
    */
   knowledge_config?: {
     memory_store_ids?: Array<string>;
@@ -1175,6 +1205,16 @@ type CreateAgentGenerationRequest = {
      *
      */
     min_score?: number;
+    /**
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     *
+     */
+    rrf_k?: number;
+    /**
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     *
+     */
+    recency_half_life_days?: number;
     /**
      * Maximum number of results to inject. Omitted, 10 are injected.
      *
@@ -3162,9 +3202,17 @@ type AgentResourceProperties = {
      */
     tags?: TagBag;
     /**
-     * Minimum similarity score (0–1) for retrieved chunks
+     * Minimum raw cosine similarity (0–1) a vector candidate must reach to be ranked. Omitted, there is no floor.
      */
     min_score?: number;
+    /**
+     * The `k` in the fusion term `1 / (k + rank)`; smaller weights the top of each ranking more heavily
+     */
+    rrf_k?: number;
+    /**
+     * Half-life in days of the decay applied to memory results after fusion; `0` disables it
+     */
+    recency_half_life_days?: number;
     /**
      * Maximum number of chunks to inject
      */
@@ -3617,6 +3665,12 @@ type TriggerResourceProperties = {
   input?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Caller context every firing forwards to the run it starts, so an agent whose tools authorize through `{{context:<key>}}` can be scheduled. Write-only. A value may be a `{{secret:...}}` reference, which is what a template should carry — the credential stays in the secret store and only its name is checked in
+   */
+  tool_context?: {
+    [key: string]: string;
+  } | null;
   /**
    * 5-field cron expression (UTC). Required when type is schedule
    */
@@ -5556,12 +5610,6 @@ type OrchestrationRun = {
   input?: {
     [key: string]: unknown;
   } | null;
-  /**
-   * The `tool_context` supplied at run creation, forwarded as `X-Naturali-Context-<key>` headers on every tool call the run's agent nodes make. Null when the run was started without one.
-   */
-  tool_context?: {
-    [key: string]: string;
-  } | null;
   /**
    * The caller-owned key/value metadata supplied at run creation, returned verbatim. Null when the run was started without any. The server writes nothing here and no key is reserved; the bag is never merged into `state`, so nothing in it reaches the graph.
    */
@@ -5736,7 +5784,7 @@ type StartOrchestrationRunRequest = {
   /**
    * Key-value pairs forwarded as `X-Naturali-Context-<key>` headers on every `http` and `mcp` tool call made by an agent node of this run — including the agents of any child run a `loop` or `sub_orchestration` node starts. The header name is `X-Naturali-Context-` plus the key verbatim; no character is re-cased.
    *
-   * The bag is stored on the run and re-read on every step, so it survives an `awaiting_input` pause, a `sleeping` wait, a background worker drive and a crash redrive. A key that is not a valid HTTP header name, or two keys that map to the same header, are rejected with `400 INVALID_TOOL_CONTEXT_KEY` and no run is created.
+   * The bag is stored on the run and re-read on every step, so it survives an `awaiting_input` pause, a `sleeping` wait, a background worker drive and a crash redrive. It is **write-only**: a run is a record every principal who may read runs can read, and a credential in it is not theirs to see, so it is never returned on one. A key that is not a valid HTTP header name, or two keys that map to the same header, are rejected with `400 INVALID_TOOL_CONTEXT_KEY` and no run is created.
    *
    * The reserved identity keys (`session_id`, `actor_id`, `actor_external_id`) are stripped at generation time — a caller cannot address them from here.
    */
@@ -5799,6 +5847,26 @@ type Project = {
    *
    */
   trace_content_mode: 'full' | 'none';
+  /**
+   * Orchestration runs of this project driven at once. `null` (the default) is unlimited. Enforced when a run is claimed — runs past the limit wait for a slot rather than failing.
+   *
+   */
+  max_concurrent_runs: number | null;
+  /**
+   * Generations one continuation chain in this project may hold before it stops being resumed. `null` (the default) leaves the platform-wide ceiling in force. The budget actually applied is the smallest of that ceiling, this number, and the agent's own — an agent author can be stricter than this, never looser.
+   *
+   */
+  max_chain_generations: number | null;
+  /**
+   * Nesting levels a run tree in this project may reach before the next child is refused. `null` (the default) leaves the platform-wide bound in force; the bound applied is the smaller of the two.
+   *
+   */
+  max_orchestration_run_depth: number | null;
+  /**
+   * Whether a generation whose model carries no price is refused before the provider is called. `false` by default, which runs the model and meters it at no cost. Mainly of use with your own providers — see [Requiring a priced model](/docs/modules/projects#requiring-a-priced-model).
+   *
+   */
+  require_priced_model: boolean;
   created_at: Date;
   updated_at: Date;
 };
@@ -5886,6 +5954,26 @@ type ProjectUpdate = {
    *
    */
   trace_content_mode?: 'full' | 'none';
+  /**
+   * Orchestration runs driven at once. Send `null` to lift the limit. Omitting the field leaves it unchanged.
+   *
+   */
+  max_concurrent_runs?: number | null;
+  /**
+   * Generations one continuation chain may hold. Send `null` to drop back to the platform-wide ceiling. Omitting the field leaves it unchanged.
+   *
+   */
+  max_chain_generations?: number | null;
+  /**
+   * Nesting levels a run tree may reach. Send `null` to drop back to the platform-wide bound. Omitting the field leaves it unchanged.
+   *
+   */
+  max_orchestration_run_depth?: number | null;
+  /**
+   * Refuse a generation whose model carries no price, before the provider is called. Uncapped by plan — it only ever narrows what the project may spend.
+   *
+   */
+  require_priced_model?: boolean;
 };
 /**
  * Token counts (input_tokens already includes cached input).
@@ -7037,6 +7125,17 @@ type CreateTriggerRequest = {
   input?: {
     [key: string]: unknown;
   };
+  /**
+   * Caller context every firing forwards to the run it starts, so an agent whose tools authorize through `{{context:<key>}}` can be put on a schedule — a firing has no request to carry one. Each key is forwarded as one `X-Naturali-Context-<key>` header.
+   *
+   * **Write-only.** It is accepted here and never returned on a read, so the record cannot be used to recover a value.
+   *
+   * A value may be a `{{secret:...}}` reference, which keeps the credential in the [secret](/docs/modules/secrets) store and leaves only its name on the trigger; it is resolved at fire time, so rotating the secret changes the next firing without touching the trigger. A reference naming a secret that does not exist in this project is refused here rather than at fire time.
+   *
+   */
+  tool_context?: {
+    [key: string]: string;
+  };
   /**
    * 5-field cron expression (UTC). Required when type is schedule
    */
@@ -7057,6 +7156,13 @@ type UpdateTriggerRequest = {
   input?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Replaces the stored bag; `null` clears it. Write-only and resolved at fire time — see `CreateTriggerRequest.tool_context`.
+   *
+   */
+  tool_context?: {
+    [key: string]: string;
+  } | null;
   cron?: string | null;
   event_pattern?: string | null;
   active?: boolean;
@@ -7069,6 +7175,15 @@ type FireTriggerRequest = {
   input?: {
     [key: string]: unknown;
   };
+  /**
+   * Fire-time caller context, shallow-merged per key over the trigger's stored `tool_context`. A manual fire has a caller, so this is the one path that can supply a value without storing it.
+   *
+   * Forwarded exactly as written: a `{{secret:...}}` reference is resolved only in the trigger's stored bag, never in one supplied here.
+   *
+   */
+  tool_context?: {
+    [key: string]: string;
+  };
 };
 type TriggerSecretResponse = {
   secret?: string;
@@ -22709,8 +22824,9 @@ export declare class Projects {
   /**
    * Update a project
    *
-   * Rename or archive a project, and/or change its content-retention settings (`trace_content_retention_days`, `trace_content_mode`). Archiving is reversible; resources are retained.
+   * Rename or archive a project, and/or change its content-retention settings (`trace_content_retention_days`, `trace_content_mode`), its execution ceilings (`max_concurrent_runs`, `max_chain_generations`, `max_orchestration_run_depth`) and its priced-model gate (`require_priced_model`). Archiving is reversible; resources are retained.
    * Requires the `admin` role in the project (an `owner` has it too).
+   * The ceilings and the priced-model gate are uncapped by plan: each one only ever narrows what the project may spend, so setting one takes on a restriction rather than claiming an entitlement. On the three ceilings `null` clears the project's own bound and omission leaves it alone — they are different instructions.
    * The two retention controls answer different questions. The window bounds how long content *stays* — a daily sweep purges anything past it, leaving auditable skeletons behind. `trace_content_mode: none` means content is never *written*, which is the stronger guarantee: it cannot be missed by a sweep or survive in a backup.
    *
    * Your plan sets the longest window you may keep content for. A wider one — `null` included, which keeps content indefinitely — responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit` in days. Anything shorter is always allowed. Moving to a plan with a shorter window takes effect at the end of the billing cycle, and content already stored is then purged by age like everything else.

package/dist/index.mjs

@@ -3724,8 +3724,9 @@ var Projects = class {
 	/**
 	* Update a project
 	*
-	* Rename or archive a project, and/or change its content-retention settings (`trace_content_retention_days`, `trace_content_mode`). Archiving is reversible; resources are retained.
+	* Rename or archive a project, and/or change its content-retention settings (`trace_content_retention_days`, `trace_content_mode`), its execution ceilings (`max_concurrent_runs`, `max_chain_generations`, `max_orchestration_run_depth`) and its priced-model gate (`require_priced_model`). Archiving is reversible; resources are retained.
 	* Requires the `admin` role in the project (an `owner` has it too).
+	* The ceilings and the priced-model gate are uncapped by plan: each one only ever narrows what the project may spend, so setting one takes on a restriction rather than claiming an entitlement. On the three ceilings `null` clears the project's own bound and omission leaves it alone — they are different instructions.
 	* The two retention controls answer different questions. The window bounds how long content *stays* — a daily sweep purges anything past it, leaving auditable skeletons behind. `trace_content_mode: none` means content is never *written*, which is the stronger guarantee: it cannot be missed by a sweep or survive in a backup.
 	*
 	* Your plan sets the longest window you may keep content for. A wider one — `null` included, which keeps content indefinitely — responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit` in days. Anything shorter is always allowed. Moving to a plan with a shorter window takes effect at the end of the billing cycle, and content already stored is then purged by age like everything else.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.133.2",
+  "version": "0.134.0",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.99.0",
-    "@naturali/api": "0.133.2",
+    "@naturali/api": "0.134.0",
     "@ttoss/openapi-codegen": "^0.3.1",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",