@naturali/sdk 0.173.2 → 0.173.4

package/dist/index.cjs

@@ -915,7 +915,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). 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 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.

package/dist/index.d.cts

@@ -2481,6 +2481,22 @@ type Channel = {
    * Whether an access token is on file (its value is never returned).
    */
   has_credential: boolean;
+  /**
+   * Why Discord refused this channel's gateway connection, when it did: the worker stops retrying, so the channel stays silent until a `PATCH` changes `bot_token`, `modes` or `status`, which clears it. Null when there is none, and for non-Discord channels.
+   *
+   */
+  gateway_error: {
+    /**
+     * `invalid_bot_token` — the token was reset or revoked. `disallowed_intents` — `mention_threads` needs the privileged Message Content intent enabled on the Discord application.
+     *
+     */
+    code: 'invalid_bot_token' | 'disallowed_intents' | 'gateway_rejected';
+    /**
+     * The gateway close code Discord sent.
+     */
+    close_code: number;
+    at: Date;
+  } | null;
   created_at: Date;
   updated_at: Date;
 };
@@ -2545,7 +2561,7 @@ type ChannelCreate = {
   modes?: DiscordModes;
 };
 /**
- * At least one field is required. For WhatsApp, `access_token` rotates the write-only credential; for Discord, `bot_token` rotates the sealed bot token and `modes` turns the gateway flows on or off. `default` replaces the channel's default action whole when present. The worker picks either change up on its next poll and reconnects.
+ * At least one field is required. For WhatsApp, `access_token` rotates the write-only credential; for Discord, `bot_token` rotates the sealed bot token (checked with Discord as on connect) and `modes` turns the gateway flows on or off. `default` replaces the channel's default action whole when present. The worker picks either change up on its next poll and reconnects.
  *
  */
 type ChannelUpdate = {
@@ -5035,7 +5051,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 +6675,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 +10481,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 +10538,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 +13371,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 +16999,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 +22520,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 +22578,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 +22631,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 = {
@@ -25226,7 +25264,7 @@ export declare class Channels {
    * 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). 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 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.

package/dist/index.d.mts

@@ -2481,6 +2481,22 @@ type Channel = {
    * Whether an access token is on file (its value is never returned).
    */
   has_credential: boolean;
+  /**
+   * Why Discord refused this channel's gateway connection, when it did: the worker stops retrying, so the channel stays silent until a `PATCH` changes `bot_token`, `modes` or `status`, which clears it. Null when there is none, and for non-Discord channels.
+   *
+   */
+  gateway_error: {
+    /**
+     * `invalid_bot_token` — the token was reset or revoked. `disallowed_intents` — `mention_threads` needs the privileged Message Content intent enabled on the Discord application.
+     *
+     */
+    code: 'invalid_bot_token' | 'disallowed_intents' | 'gateway_rejected';
+    /**
+     * The gateway close code Discord sent.
+     */
+    close_code: number;
+    at: Date;
+  } | null;
   created_at: Date;
   updated_at: Date;
 };
@@ -2545,7 +2561,7 @@ type ChannelCreate = {
   modes?: DiscordModes;
 };
 /**
- * At least one field is required. For WhatsApp, `access_token` rotates the write-only credential; for Discord, `bot_token` rotates the sealed bot token and `modes` turns the gateway flows on or off. `default` replaces the channel's default action whole when present. The worker picks either change up on its next poll and reconnects.
+ * At least one field is required. For WhatsApp, `access_token` rotates the write-only credential; for Discord, `bot_token` rotates the sealed bot token (checked with Discord as on connect) and `modes` turns the gateway flows on or off. `default` replaces the channel's default action whole when present. The worker picks either change up on its next poll and reconnects.
  *
  */
 type ChannelUpdate = {
@@ -5035,7 +5051,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 +6675,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 +10481,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 +10538,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 +13371,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 +16999,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 +22520,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 +22578,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 +22631,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 = {
@@ -25226,7 +25264,7 @@ export declare class Channels {
    * 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). 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 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.

package/dist/index.mjs

@@ -914,7 +914,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). 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 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.

package/package.json

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