@naturali/sdk 0.173.2 → 0.173.3

package/dist/index.d.cts

@@ -5035,7 +5035,7 @@ type Generation = {
    */
   trace_id?: string;
   /**
-   * Public ID of the generation that triggered this one. Set for sub-agent invocations. Null for top-level generations.
+   * Public ID of the generation that started this one: a sub-agent invocation, an approval continuation, a client-tool re-handoff or a memory-rule handler turn. Null for top-level generations.
    *
    */
   initiator_generation_id?: string | null;
@@ -6659,13 +6659,13 @@ type OrchestrationRun = {
    */
   node_executions?: Array<NodeExecution>;
   /**
-   * What the run cost: token counts and `cost_usd` summed across every metered generation it produced **and every run it started** through `loop` / `sub_orchestration` nodes, at any depth. Present on the single-run read; omitted from run list responses.
+   * What the run cost: token counts and `cost_usd` summed across every metered generation it produced **and every run it started** through `loop` / `sub_orchestration` nodes, at any depth. Present only on the single-run read (`GET /v1/projects/{project_id}/orchestration-runs/{orchestration_run_id}`); omitted from run lists and from every write's response, including a start with `wait: true`.
    *
    * A nested child is a run record of its own, so this figure spans several of them. Two consequences: summing `usage` across a list that mixes parents and children double-counts (filter with `nested=false`), and the per-event receipt at `/v1/projects/{project_id}/usage/receipt` stays scoped to one run — its line items carry a `node_id` from one graph only.
    */
   usage?: UsageTotals;
   /**
-   * The same roll-up restricted to **this run's own nodes**, excluding every nested run it started. Equal to `usage` for a run with no children; below it for a run that delegates. Present on the single-run read; omitted from run list responses.
+   * The same roll-up restricted to **this run's own nodes**, excluding every nested run it started. Equal to `usage` for a run with no children; below it for a run that delegates. Present only on the single-run read, like `usage`.
    *
    * This is the field to read to see where cost sits in a run tree — own versus subtree — without walking the children.
    */
@@ -10465,7 +10465,7 @@ type CreateAgentGenerationErrors = {
    */
   409: ErrorResponse;
   /**
-   * `SHARE_CAP_EXCEEDED`: the agent is another project's, reached through a share whose `cap` is spent for the window. Carries a `Retry-After` header and `error.meta.retry_after`.
+   * `QUOTA_EXCEEDED`: an `enforce`-mode generation quota is exhausted; `error.meta` carries `quota_id`, `metric`, `limit`, `window` and `resets_at`. `SHARE_CAP_EXCEEDED`: the agent is another project's, reached through a share whose `cap` is spent for the window; `error.meta.retry_after` says when. Both carry a `Retry-After` header.
    */
   429: ErrorResponse;
   /**
@@ -10522,6 +10522,11 @@ type SubmitAgentToolOutputsErrors = {
    * Agent or generation not found
    */
   404: ErrorResponse;
+  /**
+   * The generation is not paused on client tool calls (GENERATION_NOT_AWAITING_TOOL_OUTPUTS): it never paused, or its outputs were already submitted. Each pause accepts outputs once.
+   *
+   */
+  409: ErrorResponse;
   /**
    * Upstream AI provider error (AI_PROVIDER_ERROR); model output that does not satisfy the agent's `output_schema` (OUTPUT_SCHEMA_VALIDATION_FAILED); or a model that wrote a tool invocation out as plain assistant text instead of calling the tool (TEXT_ENCODED_TOOL_CALL — `meta.tool_name` names the tool). The resumed generation is recorded `failed`.
    *
@@ -13350,6 +13355,10 @@ type GenerateConversationMessageErrors = {
    * Conversation or actor not found
    */
   404: ErrorResponse;
+  /**
+   * `QUOTA_EXCEEDED`: an `enforce`-mode generation quota is exhausted. `error.meta` carries `quota_id`, `metric`, `limit`, `window` and `resets_at`, with a `Retry-After` header. Only with `?wait=true`: a background call is answered `202` before the quota is read.
+   */
+  429: ErrorResponse;
   /**
    * Streaming not implemented
    */
@@ -16974,7 +16983,7 @@ type ListGenerationsData = {
      */
     actor_id?: string;
     /**
-     * Filter by the public ID of the parent generation. Returns all generations triggered by that generation — sub-agent invocations. Null-initiated (top-level) generations are not returned.
+     * Filter by the public ID of the parent generation. Returns every generation started by that generation: sub-agent invocations, approval continuations, client-tool re-handoffs and memory-rule handler turns. Top-level generations are not returned.
      *
      */
     initiator_generation_id?: string;
@@ -22495,6 +22504,10 @@ type AddSessionMessageErrors = {
    * The resource does not exist (existence is not leaked).
    */
   404: ErrorResponse;
+  /**
+   * `QUOTA_EXCEEDED`: the session auto-generates and an `enforce`-mode generation quota is exhausted. `error.meta` carries `quota_id`, `metric`, `limit`, `window` and `resets_at`, with a `Retry-After` header. The message is saved. A session with `message_delay_seconds` answers `201` before the quota is read.
+   */
+  429: ErrorResponse;
 };
 type AddSessionMessageError = AddSessionMessageErrors[keyof AddSessionMessageErrors];
 type AddSessionMessageResponses = {
@@ -22549,6 +22562,10 @@ type GenerateSessionResponseErrors = {
    * Session has expired due to inactivity
    */
   410: ErrorResponse;
+  /**
+   * `QUOTA_EXCEEDED`: an `enforce`-mode generation quota is exhausted. `error.meta` carries `quota_id`, `metric`, `limit`, `window` and `resets_at`, with a `Retry-After` header. Only with `?wait=true`: a background call is answered `202` before the quota is read.
+   */
+  429: ErrorResponse;
   /**
    * Upstream AI provider error (AI_PROVIDER_ERROR). The error `meta` includes the `generation_id` and `trace_id` of the failed generation for post-mortem debugging via GET /v1/projects/{project_id}/generations/{generation_id}.
    *
@@ -22598,6 +22615,11 @@ type SubmitSessionToolOutputsErrors = {
    * The resource does not exist (existence is not leaked).
    */
   404: ErrorResponse;
+  /**
+   * The generation is not paused on client tool calls (GENERATION_NOT_AWAITING_TOOL_OUTPUTS): it never paused, or its outputs were already submitted. Each pause accepts outputs once.
+   *
+   */
+  409: ErrorResponse;
 };
 type SubmitSessionToolOutputsError = SubmitSessionToolOutputsErrors[keyof SubmitSessionToolOutputsErrors];
 type SubmitSessionToolOutputsResponses = {

package/dist/index.d.mts

@@ -5035,7 +5035,7 @@ type Generation = {
    */
   trace_id?: string;
   /**
-   * Public ID of the generation that triggered this one. Set for sub-agent invocations. Null for top-level generations.
+   * Public ID of the generation that started this one: a sub-agent invocation, an approval continuation, a client-tool re-handoff or a memory-rule handler turn. Null for top-level generations.
    *
    */
   initiator_generation_id?: string | null;
@@ -6659,13 +6659,13 @@ type OrchestrationRun = {
    */
   node_executions?: Array<NodeExecution>;
   /**
-   * What the run cost: token counts and `cost_usd` summed across every metered generation it produced **and every run it started** through `loop` / `sub_orchestration` nodes, at any depth. Present on the single-run read; omitted from run list responses.
+   * What the run cost: token counts and `cost_usd` summed across every metered generation it produced **and every run it started** through `loop` / `sub_orchestration` nodes, at any depth. Present only on the single-run read (`GET /v1/projects/{project_id}/orchestration-runs/{orchestration_run_id}`); omitted from run lists and from every write's response, including a start with `wait: true`.
    *
    * A nested child is a run record of its own, so this figure spans several of them. Two consequences: summing `usage` across a list that mixes parents and children double-counts (filter with `nested=false`), and the per-event receipt at `/v1/projects/{project_id}/usage/receipt` stays scoped to one run — its line items carry a `node_id` from one graph only.
    */
   usage?: UsageTotals;
   /**
-   * The same roll-up restricted to **this run's own nodes**, excluding every nested run it started. Equal to `usage` for a run with no children; below it for a run that delegates. Present on the single-run read; omitted from run list responses.
+   * The same roll-up restricted to **this run's own nodes**, excluding every nested run it started. Equal to `usage` for a run with no children; below it for a run that delegates. Present only on the single-run read, like `usage`.
    *
    * This is the field to read to see where cost sits in a run tree — own versus subtree — without walking the children.
    */
@@ -10465,7 +10465,7 @@ type CreateAgentGenerationErrors = {
    */
   409: ErrorResponse;
   /**
-   * `SHARE_CAP_EXCEEDED`: the agent is another project's, reached through a share whose `cap` is spent for the window. Carries a `Retry-After` header and `error.meta.retry_after`.
+   * `QUOTA_EXCEEDED`: an `enforce`-mode generation quota is exhausted; `error.meta` carries `quota_id`, `metric`, `limit`, `window` and `resets_at`. `SHARE_CAP_EXCEEDED`: the agent is another project's, reached through a share whose `cap` is spent for the window; `error.meta.retry_after` says when. Both carry a `Retry-After` header.
    */
   429: ErrorResponse;
   /**
@@ -10522,6 +10522,11 @@ type SubmitAgentToolOutputsErrors = {
    * Agent or generation not found
    */
   404: ErrorResponse;
+  /**
+   * The generation is not paused on client tool calls (GENERATION_NOT_AWAITING_TOOL_OUTPUTS): it never paused, or its outputs were already submitted. Each pause accepts outputs once.
+   *
+   */
+  409: ErrorResponse;
   /**
    * Upstream AI provider error (AI_PROVIDER_ERROR); model output that does not satisfy the agent's `output_schema` (OUTPUT_SCHEMA_VALIDATION_FAILED); or a model that wrote a tool invocation out as plain assistant text instead of calling the tool (TEXT_ENCODED_TOOL_CALL — `meta.tool_name` names the tool). The resumed generation is recorded `failed`.
    *
@@ -13350,6 +13355,10 @@ type GenerateConversationMessageErrors = {
    * Conversation or actor not found
    */
   404: ErrorResponse;
+  /**
+   * `QUOTA_EXCEEDED`: an `enforce`-mode generation quota is exhausted. `error.meta` carries `quota_id`, `metric`, `limit`, `window` and `resets_at`, with a `Retry-After` header. Only with `?wait=true`: a background call is answered `202` before the quota is read.
+   */
+  429: ErrorResponse;
   /**
    * Streaming not implemented
    */
@@ -16974,7 +16983,7 @@ type ListGenerationsData = {
      */
     actor_id?: string;
     /**
-     * Filter by the public ID of the parent generation. Returns all generations triggered by that generation — sub-agent invocations. Null-initiated (top-level) generations are not returned.
+     * Filter by the public ID of the parent generation. Returns every generation started by that generation: sub-agent invocations, approval continuations, client-tool re-handoffs and memory-rule handler turns. Top-level generations are not returned.
      *
      */
     initiator_generation_id?: string;
@@ -22495,6 +22504,10 @@ type AddSessionMessageErrors = {
    * The resource does not exist (existence is not leaked).
    */
   404: ErrorResponse;
+  /**
+   * `QUOTA_EXCEEDED`: the session auto-generates and an `enforce`-mode generation quota is exhausted. `error.meta` carries `quota_id`, `metric`, `limit`, `window` and `resets_at`, with a `Retry-After` header. The message is saved. A session with `message_delay_seconds` answers `201` before the quota is read.
+   */
+  429: ErrorResponse;
 };
 type AddSessionMessageError = AddSessionMessageErrors[keyof AddSessionMessageErrors];
 type AddSessionMessageResponses = {
@@ -22549,6 +22562,10 @@ type GenerateSessionResponseErrors = {
    * Session has expired due to inactivity
    */
   410: ErrorResponse;
+  /**
+   * `QUOTA_EXCEEDED`: an `enforce`-mode generation quota is exhausted. `error.meta` carries `quota_id`, `metric`, `limit`, `window` and `resets_at`, with a `Retry-After` header. Only with `?wait=true`: a background call is answered `202` before the quota is read.
+   */
+  429: ErrorResponse;
   /**
    * Upstream AI provider error (AI_PROVIDER_ERROR). The error `meta` includes the `generation_id` and `trace_id` of the failed generation for post-mortem debugging via GET /v1/projects/{project_id}/generations/{generation_id}.
    *
@@ -22598,6 +22615,11 @@ type SubmitSessionToolOutputsErrors = {
    * The resource does not exist (existence is not leaked).
    */
   404: ErrorResponse;
+  /**
+   * The generation is not paused on client tool calls (GENERATION_NOT_AWAITING_TOOL_OUTPUTS): it never paused, or its outputs were already submitted. Each pause accepts outputs once.
+   *
+   */
+  409: ErrorResponse;
 };
 type SubmitSessionToolOutputsError = SubmitSessionToolOutputsErrors[keyof SubmitSessionToolOutputsErrors];
 type SubmitSessionToolOutputsResponses = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.173.2",
+  "version": "0.173.3",
   "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.173.2",
+    "@naturali/api": "0.173.3",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",