@soat/sdk 0.71.0 → 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;
@@ -5495,7 +5495,7 @@ type OrchestrationEdge = {
    */
   activation_group?: string;
   /**
-   * Whether all or any edges in the activation group must fire.
+   * Whether all or any edges in the activation group must come from a completed node before the target runs. Omitted, `all`.
    */
   activation_condition?: 'all' | 'any';
 };
@@ -5555,7 +5555,13 @@ type CreateOrchestrationRequest = {
    */
   name: string;
   description?: string | null;
+  /**
+   * The graph's nodes. Each `id` is unique and is what edges and `nodes.<id>` state references name; a node with no incoming edge starts the run.
+   */
   nodes: Array<OrchestrationNode>;
+  /**
+   * Directed edges between node `id`s. Every `from`/`to` must name a node in `nodes`, and the graph must be acyclic unless it contains a `loop` node. A node with several outgoing edges activates every target in parallel. `[]` for a graph of independent nodes.
+   */
   edges: Array<OrchestrationEdge>;
   state_schema?: {
     [key: string]: unknown;
@@ -5572,7 +5578,13 @@ type CreateOrchestrationRequest = {
 type UpdateOrchestrationRequest = {
   name?: string;
   description?: string | null;
+  /**
+   * The graph's nodes. Each `id` is unique and is what edges and `nodes.<id>` state references name; a node with no incoming edge starts the run. Replaces the stored list; omitted, the stored nodes are kept and validated against the new `edges`.
+   */
   nodes?: Array<OrchestrationNode>;
+  /**
+   * Directed edges between node `id`s. Every `from`/`to` must name a node in `nodes`, and the graph must be acyclic unless it contains a `loop` node. A node with several outgoing edges activates every target in parallel. Replaces the stored list; omitted, the stored edges are kept and validated against the new `nodes`.
+   */
   edges?: Array<OrchestrationEdge>;
   state_schema?: {
     [key: string]: unknown;
@@ -5723,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.
    */
@@ -5893,7 +5905,13 @@ type StartOrchestrationRunRequest = {
   wait?: boolean;
 };
 type ValidateOrchestrationRequest = {
+  /**
+   * The graph's nodes. Each `id` is unique and is what edges and `nodes.<id>` state references name; a node with no incoming edge starts the run. Checked exactly as create checks them, without persisting.
+   */
   nodes?: Array<OrchestrationNode>;
+  /**
+   * Directed edges between node `id`s. Every `from`/`to` must name a node in `nodes`, and the graph must be acyclic unless it contains a `loop` node. A node with several outgoing edges activates every target in parallel. Checked exactly as create checks them, without persisting.
+   */
   edges?: Array<OrchestrationEdge>;
   /**
    * Optional JSON Schema for run inputs; its top-level properties seed state.
@@ -8850,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;
   /**
@@ -8903,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`.
    *
@@ -10754,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
    */
@@ -14225,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;
@@ -18572,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 = {
@@ -18622,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}.
    *
@@ -18667,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;
@@ -5495,7 +5495,7 @@ type OrchestrationEdge = {
    */
   activation_group?: string;
   /**
-   * Whether all or any edges in the activation group must fire.
+   * Whether all or any edges in the activation group must come from a completed node before the target runs. Omitted, `all`.
    */
   activation_condition?: 'all' | 'any';
 };
@@ -5555,7 +5555,13 @@ type CreateOrchestrationRequest = {
    */
   name: string;
   description?: string | null;
+  /**
+   * The graph's nodes. Each `id` is unique and is what edges and `nodes.<id>` state references name; a node with no incoming edge starts the run.
+   */
   nodes: Array<OrchestrationNode>;
+  /**
+   * Directed edges between node `id`s. Every `from`/`to` must name a node in `nodes`, and the graph must be acyclic unless it contains a `loop` node. A node with several outgoing edges activates every target in parallel. `[]` for a graph of independent nodes.
+   */
   edges: Array<OrchestrationEdge>;
   state_schema?: {
     [key: string]: unknown;
@@ -5572,7 +5578,13 @@ type CreateOrchestrationRequest = {
 type UpdateOrchestrationRequest = {
   name?: string;
   description?: string | null;
+  /**
+   * The graph's nodes. Each `id` is unique and is what edges and `nodes.<id>` state references name; a node with no incoming edge starts the run. Replaces the stored list; omitted, the stored nodes are kept and validated against the new `edges`.
+   */
   nodes?: Array<OrchestrationNode>;
+  /**
+   * Directed edges between node `id`s. Every `from`/`to` must name a node in `nodes`, and the graph must be acyclic unless it contains a `loop` node. A node with several outgoing edges activates every target in parallel. Replaces the stored list; omitted, the stored edges are kept and validated against the new `nodes`.
+   */
   edges?: Array<OrchestrationEdge>;
   state_schema?: {
     [key: string]: unknown;
@@ -5723,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.
    */
@@ -5893,7 +5905,13 @@ type StartOrchestrationRunRequest = {
   wait?: boolean;
 };
 type ValidateOrchestrationRequest = {
+  /**
+   * The graph's nodes. Each `id` is unique and is what edges and `nodes.<id>` state references name; a node with no incoming edge starts the run. Checked exactly as create checks them, without persisting.
+   */
   nodes?: Array<OrchestrationNode>;
+  /**
+   * Directed edges between node `id`s. Every `from`/`to` must name a node in `nodes`, and the graph must be acyclic unless it contains a `loop` node. A node with several outgoing edges activates every target in parallel. Checked exactly as create checks them, without persisting.
+   */
   edges?: Array<OrchestrationEdge>;
   /**
    * Optional JSON Schema for run inputs; its top-level properties seed state.
@@ -8850,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;
   /**
@@ -8903,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`.
    *
@@ -10754,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
    */
@@ -14225,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;
@@ -18572,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 = {
@@ -18622,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}.
    *
@@ -18667,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.0",
+  "version": "0.71.2",
   "description": "TypeScript SDK for SOAT — open-source infrastructure for production-ready AI agents.",
   "keywords": [
     "ai-agents",