@soat/sdk 0.71.1 → 0.71.2

package/dist/index.d.cts

@@ -4149,7 +4149,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;
@@ -5735,13 +5735,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 /api/v1/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 `/api/v1/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.
    */
@@ -8868,7 +8868,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;
   /**
@@ -8921,6 +8921,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`.
    *
@@ -10772,6 +10777,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
    */
@@ -14243,7 +14252,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;
@@ -18590,6 +18599,10 @@ type AddSessionMessageErrors = {
    * Not found
    */
   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 = {
@@ -18640,6 +18653,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 /api/v1/generations/{generation_id}.
    *
@@ -18685,6 +18702,11 @@ type SubmitSessionToolOutputsErrors = {
    * 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;
 };
 type SubmitSessionToolOutputsError = SubmitSessionToolOutputsErrors[keyof SubmitSessionToolOutputsErrors];
 type SubmitSessionToolOutputsResponses = {

package/dist/index.d.mts

@@ -4149,7 +4149,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;
@@ -5735,13 +5735,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 /api/v1/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 `/api/v1/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.
    */
@@ -8868,7 +8868,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;
   /**
@@ -8921,6 +8921,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`.
    *
@@ -10772,6 +10777,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
    */
@@ -14243,7 +14252,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;
@@ -18590,6 +18599,10 @@ type AddSessionMessageErrors = {
    * Not found
    */
   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 = {
@@ -18640,6 +18653,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 /api/v1/generations/{generation_id}.
    *
@@ -18685,6 +18702,11 @@ type SubmitSessionToolOutputsErrors = {
    * 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;
 };
 type SubmitSessionToolOutputsError = SubmitSessionToolOutputsErrors[keyof SubmitSessionToolOutputsErrors];
 type SubmitSessionToolOutputsResponses = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/sdk",
-  "version": "0.71.1",
+  "version": "0.71.2",
   "description": "TypeScript SDK for SOAT — open-source infrastructure for production-ready AI agents.",
   "keywords": [
     "ai-agents",