@naturali/sdk 0.38.1 → 0.40.0

package/dist/index.d.cts

@@ -336,7 +336,7 @@ type ClientOptions = {
 };
 type Agent = {
   /**
-   * Public agent ID (agent_ prefix) — the SOAT agent id.
+   * Public agent ID (agent_ prefix) — the runtime agent id.
    */
   id: string;
   project_id: string;
@@ -367,6 +367,13 @@ type Agent = {
    */
   tool_ids: Array<string>;
   tool_choice: ToolChoice;
+  /**
+   * JSON Schema describing the structured object the model must return. When set, a non-streaming generation is constrained to it and the parsed value comes back as `object` on the generation result. Null (the default) leaves the output unconstrained. Streaming generations are unaffected.
+   *
+   */
+  output_schema: {
+    [key: string]: unknown;
+  } | null;
   status: 'active' | 'disabled';
   created_at: Date;
   updated_at: Date;
@@ -385,7 +392,7 @@ type AgentCreate = {
    */
   name?: string;
   /**
-   * Model string SOAT sends (see /v1/models soat_model). Defaults to the provider's default model.
+   * Model string the runtime sends (see /v1/models provider_model). Defaults to the provider's default model.
    */
   model?: string;
   /**
@@ -401,6 +408,13 @@ type AgentCreate = {
    */
   tool_ids?: Array<string>;
   tool_choice?: ToolChoice;
+  /**
+   * JSON Schema describing the structured object the model must return. When set, a non-streaming generation is constrained to it and the parsed value comes back as `object` on the generation result. Omit (the default) to leave the output unconstrained. Streaming generations are unaffected.
+   *
+   */
+  output_schema?: {
+    [key: string]: unknown;
+  };
 };
 /**
  * At least one field must be present.
@@ -422,6 +436,13 @@ type AgentUpdate = {
    */
   tool_ids?: Array<string>;
   tool_choice?: ToolChoice;
+  /**
+   * Replace the agent's structured-output schema. An object constrains non-streaming generations to it; `null` clears it and leaves the output unconstrained.
+   *
+   */
+  output_schema?: {
+    [key: string]: unknown;
+  } | null;
   status?: 'active' | 'disabled';
 };
 type AgentList = {
@@ -610,7 +631,7 @@ type BoardDispatch = {
 type BoardCompletionRule = {
   /**
    * JSON Logic evaluated against `{ task, result }`. `result` is the dispatch's output: for an agent column its generation output; for a tool column the tool's own result object.
-   * Routing an agent column on *structured* output (`result.object.…`) needs the agent to declare an output schema, and the Agents API does not expose one yet — so today an agent column can only route on what its generation happens to return.
+   * Routing an agent column on *structured* output (`result.object.…`) needs the agent to declare an `output_schema` — set one and every field of it is addressable here.
    *
    */
   when: unknown;
@@ -795,7 +816,7 @@ type Channel = {
  * the optional `modes` opting into the gateway flows. Discord runs over
  * the Gateway, so the bot token is kept in naturali's encrypted store
  * (the worker must present it to authenticate its WebSocket) rather than
- * as a SOAT secret; deployments without `CHANNEL_TOKEN_KEY` configured
+ * as a secret on the runtime; deployments without `CHANNEL_TOKEN_KEY` configured
  * return `501`.
  *
  * No credential value is ever returned.
@@ -918,7 +939,7 @@ type ChannelBindingSet = {
   status?: 'active' | 'disabled';
 };
 /**
- * One contact's dialogue on a channel — naturali-native, keyed by (channel, contact identity) so the same identifier never opens two conversations, and mapped 1:1 to the SOAT session that carries the message history. `contact_id` is who the dialogue is with (see the Contacts API); a merge moves it without disturbing the identity that keys the dialogue.
+ * One contact's dialogue on a channel — naturali-native, keyed by (channel, contact identity) so the same identifier never opens two conversations, and mapped 1:1 to the runtime session that carries the message history. `contact_id` is who the dialogue is with (see the Contacts API); a merge moves it without disturbing the identity that keys the dialogue.
  *
  */
 type Conversation = {
@@ -940,12 +961,12 @@ type Conversation = {
    */
   contact_identifier: string | null;
   /**
-   * The SOAT actor the contact speaks as. Null when the contact has not needed one yet.
+   * The runtime actor the contact speaks as. Null when the contact has not needed one yet.
    *
    */
   actor_id: string | null;
   /**
-   * The SOAT session this conversation maps 1:1 to.
+   * The runtime session this conversation maps 1:1 to.
    */
   session_id: string;
   created_at: Date;
@@ -959,11 +980,11 @@ type ConversationList = {
   next_cursor: string | null;
 };
 /**
- * One message in the conversation's transcript, as SOAT records it.
+ * One message in the conversation's transcript, as the runtime records it.
  */
 type ConversationMessage = {
   /**
-   * The SOAT document holding the message text.
+   * The runtime document holding the message text.
    */
   document_id?: string | null;
   role?: 'user' | 'assistant' | 'system' | null;
@@ -1016,7 +1037,7 @@ type Contact = {
     [key: string]: unknown;
   } | null;
   /**
-   * The SOAT actor the contact speaks as — one per contact, created on first need. Memory hangs off it.
+   * The runtime actor the contact speaks as — one per contact, created on first need. Memory hangs off it.
    *
    */
   actor_id: string | null;
@@ -1106,7 +1127,7 @@ type ContactConversation = {
   contact_id: string;
   contact_identity_id: string;
   /**
-   * The SOAT session this conversation maps 1:1 to.
+   * The runtime session this conversation maps 1:1 to.
    */
   session_id: string;
   created_at: Date;
@@ -1243,7 +1264,7 @@ type GenerationResult = {
   }> | null;
 };
 /**
- * A stored generation record — one model loop an agent ran, as SOAT recorded it. This is what a read returns; `GenerationResult` is what running one returns.
+ * A stored generation record — one model loop an agent ran, as the runtime recorded it. This is what a read returns; `GenerationResult` is what running one returns.
  * The record carries no prompt or completion text: the transcript belongs to the session that ran the turn, and the step-level detail to the trace.
  *
  */
@@ -1433,7 +1454,7 @@ type KnowledgeCollectionList = {
 };
 type KnowledgeDocument = {
   /**
-   * Public document ID (doc_ prefix) — the SOAT document id.
+   * Public document ID (doc_ prefix) — the runtime document id.
    */
   id: string;
   collection_id: string;
@@ -1525,7 +1546,7 @@ type Model = {
   id: string;
   display_name: string;
   /**
-   * SOAT provider slug that serves the model.
+   * The provider slug that serves the model.
    */
   provider: string;
   /**
@@ -1533,10 +1554,10 @@ type Model = {
    */
   vendor: string;
   /**
-   * The exact model string SOAT sends to the provider — a cross-region inference-profile id (us.…) when the model is profile-only.
+   * The exact model string the runtime sends to the provider — a cross-region inference-profile id (us.…) when the model is profile-only.
    *
    */
-  soat_model: string;
+  provider_model: string;
   /**
    * Accepted input modalities.
    */
@@ -1636,13 +1657,13 @@ type ProjectList = {
 };
 type Provider = {
   /**
-   * Public provider ID (aip_ prefix) — the SOAT ai_provider id.
+   * Public provider ID (aip_ prefix) — the provider id on the runtime.
    */
   id: string;
   project_id: string;
   name: string;
   /**
-   * SOAT provider slug.
+   * The provider slug.
    */
   provider: 'openai' | 'anthropic' | 'google' | 'xai' | 'groq' | 'ollama' | 'azure' | 'bedrock' | 'gateway' | 'custom';
   default_model: string;
@@ -1661,7 +1682,7 @@ type Provider = {
 };
 /**
  * Two modes, selected by `kind` (default `byok`).
- * `managed` (naturali-keyed, metered at cost on SOAT): supply only `model` (a catalog model id offered as managed, e.g. amazon.nova-lite-v1:0) and an optional `name`. No credential — managed providers use naturali's own AWS access, and are metered at raw AWS cost (customer markup is applied later by the naturali cost API).
+ * `managed` (naturali-keyed, metered at cost on the runtime): supply only `model` (a catalog model id offered as managed, e.g. amazon.nova-lite-v1:0) and an optional `name`. No credential — managed providers use naturali's own AWS access, and are metered at raw AWS cost (customer markup is applied later by the naturali cost API).
  * `byok`: supply `provider`, `default_model` and `api_key` (+ optional `name`, `base_url`). The credential is stored write-only and never priced.
  *
  */
@@ -1672,11 +1693,11 @@ type ProviderCreate = {
    */
   model?: string;
   /**
-   * BYOK only — the SOAT provider slug.
+   * BYOK only — the provider slug.
    */
   provider?: 'openai' | 'anthropic' | 'google' | 'xai' | 'groq' | 'ollama' | 'azure' | 'bedrock' | 'gateway' | 'custom';
   /**
-   * BYOK only — model string SOAT sends (see /v1/models soat_model).
+   * BYOK only — model string the runtime sends (see /v1/models provider_model).
    */
   default_model?: string;
   /**
@@ -1722,12 +1743,12 @@ type SessionCreate = {
    */
   name?: string;
   /**
-   * The contact the session is for (Contacts API, §6). naturali resolves it to the contact's SOAT actor — minting one on first need — so a web or in-app session gets the same continuity, memory and history a channel conversation gets, instead of a throwaway identity per session. When the contact has an `external_id` it rides along in `tool_context` as `actor_external_id`, so the customer's own HTTP tools receive the user reference they already key on; an explicit `tool_context` entry still wins. Mutually exclusive with `actor_id`.
+   * The contact the session is for (Contacts API, §6). naturali resolves it to the contact's runtime actor — minting one on first need — so a web or in-app session gets the same continuity, memory and history a channel conversation gets, instead of a throwaway identity per session. When the contact has an `external_id` it rides along in `tool_context` as `actor_external_id`, so the customer's own HTTP tools receive the user reference they already key on; an explicit `tool_context` entry still wins. Mutually exclusive with `actor_id`.
    *
    */
   contact_id?: string;
   /**
-   * Public ID of an existing actor to attach as the user actor. A SOAT id showing through the public contract; prefer `contact_id`. Mutually exclusive with it.
+   * Public ID of an existing actor to attach as the user actor. A runtime id showing through the public contract; prefer `contact_id`. Mutually exclusive with it.
    *
    */
   actor_id?: string;
@@ -1762,7 +1783,7 @@ type Session = {
    */
   agent_id: string;
   /**
-   * The underlying SOAT conversation backing the session.
+   * The underlying runtime conversation backing the session.
    */
   conversation_id?: string | null;
   /**
@@ -2061,7 +2082,7 @@ type McpConfig = {
 };
 type Tool = {
   /**
-   * Public tool ID (tool_ prefix) — the SOAT tool id.
+   * Public tool ID (tool_ prefix) — the runtime tool id.
    */
   id: string;
   project_id: string;
@@ -2322,7 +2343,7 @@ type GenerationStatus = 'in_progress' | 'requires_action' | 'completed' | 'faile
  */
 type CollectionId = string;
 /**
- * Knowledge document public ID (doc_ prefix) — the SOAT document id.
+ * Knowledge document public ID (doc_ prefix) — the runtime document id.
  */
 type DocumentId = string;
 /**
@@ -2430,7 +2451,7 @@ type CreateAgentErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -2477,7 +2498,7 @@ type DeleteAgentErrors = {
    */
   409: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -2551,7 +2572,7 @@ type UpdateAgentErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -2908,7 +2929,7 @@ type ListBoardsErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -2952,7 +2973,7 @@ type CreateBoardErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -2993,7 +3014,7 @@ type DeleteBoardErrors = {
    */
   409: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -3030,7 +3051,7 @@ type GetBoardErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -3072,7 +3093,7 @@ type UpdateBoardErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -3162,7 +3183,7 @@ type CreateChannelErrors = {
    */
   501: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -3199,7 +3220,7 @@ type DeleteChannelErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -3273,7 +3294,7 @@ type UpdateChannelErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -3527,7 +3548,7 @@ type ListChannelConversationMessagesErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -3671,7 +3692,7 @@ type DeleteContactErrors = {
    */
   409: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -3905,7 +3926,7 @@ type MergeContactErrors = {
    */
   409: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -3983,7 +4004,7 @@ type RevertContactMergeErrors = {
    */
   409: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -4037,7 +4058,7 @@ type ListAgentGenerationsErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -4084,7 +4105,7 @@ type CreateGenerationErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -4122,7 +4143,7 @@ type GetGenerationErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -4159,7 +4180,7 @@ type GetGenerationUsageErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -4392,7 +4413,7 @@ type QueryKnowledgeCollectionErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -4438,7 +4459,7 @@ type ListKnowledgeDocumentsErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -4485,7 +4506,7 @@ type CreateKnowledgeDocumentErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -4509,7 +4530,7 @@ type DeleteKnowledgeDocumentData = {
      */
     collection_id: string;
     /**
-     * Knowledge document public ID (doc_ prefix) — the SOAT document id.
+     * Knowledge document public ID (doc_ prefix) — the runtime document id.
      */
     document_id: string;
   };
@@ -4526,7 +4547,7 @@ type DeleteKnowledgeDocumentErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -4550,7 +4571,7 @@ type GetKnowledgeDocumentData = {
      */
     collection_id: string;
     /**
-     * Knowledge document public ID (doc_ prefix) — the SOAT document id.
+     * Knowledge document public ID (doc_ prefix) — the runtime document id.
      */
     document_id: string;
   };
@@ -4567,7 +4588,7 @@ type GetKnowledgeDocumentErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -4591,7 +4612,7 @@ type ReingestKnowledgeDocumentData = {
      */
     collection_id: string;
     /**
-     * Knowledge document public ID (doc_ prefix) — the SOAT document id.
+     * Knowledge document public ID (doc_ prefix) — the runtime document id.
      */
     document_id: string;
   };
@@ -4608,7 +4629,7 @@ type ReingestKnowledgeDocumentErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -4637,7 +4658,7 @@ type ListModelsData = {
      */
     vendor?: string;
     /**
-     * Filter by the SOAT provider slug that serves the model.
+     * Filter by the provider slug that serves the model.
      */
     provider?: string;
     /**
@@ -4790,7 +4811,7 @@ type DeleteProjectErrors = {
    */
   404: ErrorResponse;
   /**
-   * The project still has dependent resources in SOAT (retry with `force=true`).
+   * The project still has dependent resources on the runtime (retry with `force=true`).
    */
   409: ErrorResponse;
 };
@@ -4975,7 +4996,7 @@ type CreateProviderErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5022,7 +5043,7 @@ type DeleteProviderErrors = {
    */
   409: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5096,7 +5117,7 @@ type UpdateProviderErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5143,7 +5164,7 @@ type CreateSessionErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5184,7 +5205,7 @@ type GetSessionErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5229,7 +5250,7 @@ type AddSessionMessageErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5287,7 +5308,7 @@ type GenerateSessionResponseErrors = {
    */
   410: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5349,7 +5370,7 @@ type ListTasksErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5392,7 +5413,7 @@ type CreateTaskErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5429,7 +5450,7 @@ type DeleteTaskErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5466,7 +5487,7 @@ type GetTaskErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5507,7 +5528,7 @@ type UpdateTaskErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5552,7 +5573,7 @@ type TransitionTaskErrors = {
    */
   409: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5589,7 +5610,7 @@ type ListTaskTransitionsErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5670,7 +5691,7 @@ type CreateToolErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5711,7 +5732,7 @@ type DeleteToolErrors = {
    */
   409: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5785,7 +5806,7 @@ type UpdateToolErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5831,7 +5852,7 @@ type ListTracesErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5868,7 +5889,7 @@ type GetTraceErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5915,7 +5936,7 @@ type GetTraceTreeErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -5969,7 +5990,7 @@ type ListTraceGenerationsErrors = {
    */
   404: ErrorResponse;
   /**
-   * The backing SOAT platform could not complete the operation.
+   * The upstream runtime could not complete the operation.
    */
   502: ErrorResponse;
 };
@@ -6013,7 +6034,7 @@ declare class Agents {
   /**
    * Delete an agent
    *
-   * Deletes the backing SOAT agent. Returns 409 if the agent still has dependent generations or traces — pass `force=true` to delete those along with the agent (destructive and irreversible).
+   * Deletes the backing runtime agent. Returns 409 if the agent still has dependent generations or traces — pass `force=true` to delete those along with the agent (destructive and irreversible).
    *
    */
   static deleteAgent<ThrowOnError extends boolean = false>(options: Options<DeleteAgentData, ThrowOnError>): RequestResult<DeleteAgentResponses, DeleteAgentErrors, ThrowOnError>;
@@ -6024,7 +6045,7 @@ declare class Agents {
   /**
    * Update an agent
    *
-   * Change the bound provider, name, model, instructions, sampling/step config, attached tools (tool_ids/tool_choice), or the naturali-side status. At least one field is required.
+   * Change the bound provider, name, model, instructions, sampling/step config, attached tools (tool_ids/tool_choice), the structured-output schema (output_schema), or the naturali-side status. At least one field is required.
    *
    */
   static updateAgent<ThrowOnError extends boolean = false>(options: Options<UpdateAgentData, ThrowOnError>): RequestResult<UpdateAgentResponses, UpdateAgentErrors, ThrowOnError>;
@@ -6203,7 +6224,7 @@ declare class Channels {
   /**
    * List the channel's conversations
    *
-   * A cursor page of the channel's conversations, newest first. A conversation is one contact's dialogue on the channel — the continuity anchor that resumes the same SOAT session instead of starting fresh per message — so this is the read path for who has talked to the channel and which actor/session their dialogue resolved to.
+   * A cursor page of the channel's conversations, newest first. A conversation is one contact's dialogue on the channel — the continuity anchor that resumes the same runtime session instead of starting fresh per message — so this is the read path for who has talked to the channel and which actor/session their dialogue resolved to.
    * Conversations are created by the inbound path (the WhatsApp webhook, the Discord gateway worker) when a real message arrives; there is no way to create one directly.
    *
    */
@@ -6215,7 +6236,7 @@ declare class Channels {
   /**
    * Read a conversation's transcript
    *
-   * The conversation's messages, oldest first. naturali stores no message bodies — the dialogue lives in the SOAT session the conversation maps to, so this reads through to SOAT. Pagination is `limit`/`offset` rather than an opaque cursor because the upstream is offset-based over a stable `position` ordering.
+   * The conversation's messages, oldest first. naturali stores no message bodies — the dialogue lives in the runtime session the conversation maps to, so this reads through to the runtime. Pagination is `limit`/`offset` rather than an opaque cursor because the upstream is offset-based over a stable `position` ordering.
    *
    */
   static listChannelConversationMessages<ThrowOnError extends boolean = false>(options: Options<ListChannelConversationMessagesData, ThrowOnError>): RequestResult<ListChannelConversationMessagesResponses, ListChannelConversationMessagesErrors, ThrowOnError>;
@@ -6233,14 +6254,14 @@ declare class Contacts {
    * Create a contact
    *
    * Record a contact the customer already knows about, optionally with the identifiers it is expected to arrive at.
-   * Optional by design — the inbound path creates contacts on its own. This is for the embedder who has a user in their own system and wants naturali to agree about who that is before the first message, which is what makes `external_id` (and, through it, a session's `tool_context`) useful. No SOAT actor is created here; the contact gets one on first need.
+   * Optional by design — the inbound path creates contacts on its own. This is for the embedder who has a user in their own system and wants naturali to agree about who that is before the first message, which is what makes `external_id` (and, through it, a session's `tool_context`) useful. No runtime actor is created here; the contact gets one on first need.
    *
    */
   static createContact<ThrowOnError extends boolean = false>(options: Options<CreateContactData, ThrowOnError>): RequestResult<CreateContactResponses, CreateContactErrors, ThrowOnError>;
   /**
    * Erase a contact
    *
-   * **Erasure (C4/LGPD).** Not a soft delete and not reversible: the contact's sessions — with their messages and media — its SOAT actor, its memory container and every identifier it was reachable at are removed, along with the merge records that reference it.
+   * **Erasure (C4/LGPD).** Not a soft delete and not reversible: the contact's sessions — with their messages and media — its runtime actor, its memory container and every identifier it was reachable at are removed, along with the merge records that reference it.
    * The upstream deletes happen first, so a failure there aborts before the local pointers are dropped and a retry can still find what is left. A contact that was merged into another cannot be erased directly: its data lives with the survivor, so erase that one.
    *
    */
@@ -6281,7 +6302,7 @@ declare class Contacts {
    * Merge another contact into this one
    *
    * Fold `source_contact_id` into this contact — "same human, two identifiers" (C4).
-   * What moves: every identity and every conversation, so the survivor's history is the union of both. What is *shared* rather than moved: agent memory — SOAT hangs it off the actor, so the source's actor is re-pointed at the survivor's memory container and both keep answering with one recollection. Existing sessions keep working, which is the point of not rewriting them.
+   * What moves: every identity and every conversation, so the survivor's history is the union of both. What is *shared* rather than moved: agent memory — the runtime hangs it off the actor, so the source's actor is re-pointed at the survivor's memory container and both keep answering with one recollection. Existing sessions keep working, which is the point of not rewriting them.
    * The source is not deleted: it stays as a tombstone pointing at the survivor, and the returned merge record lists exactly what moved, so the merge can be audited and reverted.
    *
    */
@@ -6313,7 +6334,7 @@ declare class Generations {
   /**
    * Run an agent generation
    *
-   * Sends messages to the agent, resolves its tools, and runs the model loop. Returns the final text when `status` is `completed` (plus `object` when the agent has an output schema), or the pending `tool_calls` when `status` is `requires_action`. With `stream: true` the response is a Server-Sent Events stream (Content-Type text/event-stream) proxied from SOAT instead of a single JSON body.
+   * Sends messages to the agent, resolves its tools, and runs the model loop. Returns the final text when `status` is `completed` (plus `object` when the agent has an output schema), or the pending `tool_calls` when `status` is `requires_action`. With `stream: true` the response is a Server-Sent Events stream (Content-Type text/event-stream) proxied from the runtime instead of a single JSON body.
    *
    */
   static createGeneration<ThrowOnError extends boolean = false>(options: Options<CreateGenerationData, ThrowOnError>): RequestResult<CreateGenerationResponses, CreateGenerationErrors, ThrowOnError>;
@@ -6328,7 +6349,7 @@ declare class Generations {
   /**
    * Get a generation's cost
    *
-   * What this one generation cost, and the tokens it was charged on — the billing-grade receipt SOAT froze at write time, per model line item.
+   * What this one generation cost, and the tokens it was charged on — the billing-grade receipt the runtime froze at write time, per model line item.
    * This is the per-generation grain that `GET /v1/projects/{project_id}/usage` cannot express: that meter buckets a whole project by model, agent, run, day or meter type, and a run can hold more than one generation. Use this to price a single turn, and the project meter to roll spend up.
    * `cost_usd` is `null` when nothing was priced — never that the work was free. Only naturali-managed providers are priced; a BYOK generation runs on your own provider account, so it carries no LLM cost here (its tokens are still reported).
    * A generation belonging to another project responds `404`, not `403`.
@@ -6434,7 +6455,7 @@ declare class Projects {
   /**
    * Delete a project
    *
-   * Permanently deletes the project and its backing SOAT project. Fails with 409 if the SOAT project still has dependent resources — remove them first, or pass `force=true` to delete the project and all its dependents (agents, providers, tools, sessions, generations, traces). Forcing is destructive and irreversible.
+   * Permanently deletes the project and its backing runtime project. Fails with 409 if the runtime project still has dependent resources — remove them first, or pass `force=true` to delete the project and all its dependents (agents, providers, tools, sessions, generations, traces). Forcing is destructive and irreversible.
    *
    */
   static deleteProject<ThrowOnError extends boolean = false>(options: Options<DeleteProjectData, ThrowOnError>): RequestResult<DeleteProjectResponses, DeleteProjectErrors, ThrowOnError>;
@@ -6451,7 +6472,7 @@ declare class Projects {
   /**
    * Get per-project usage
    *
-   * The per-project meter — the re-billing view (A11/C12/P3). Aggregates the project's usage over an optional [from, to] window, bucketed by a single dimension. Costs are the billing-grade cost_usd SOAT freezes at write time; null means nothing in the bucket was priced (never that it was free). Only managed providers are priced (on SOAT), so cost reflects managed usage; BYOK usage carries no LLM cost.
+   * The per-project meter — the re-billing view (A11/C12/P3). Aggregates the project's usage over an optional [from, to] window, bucketed by a single dimension. Costs are the billing-grade cost_usd the runtime freezes at write time; null means nothing in the bucket was priced (never that it was free). Only managed providers are priced (on the runtime), so cost reflects managed usage; BYOK usage carries no LLM cost.
    *
    */
   static getProjectUsage<ThrowOnError extends boolean = false>(options: Options<GetProjectUsageData, ThrowOnError>): RequestResult<GetProjectUsageResponses, GetProjectUsageErrors, ThrowOnError>;
@@ -6466,14 +6487,14 @@ declare class Providers {
   /**
    * Register a provider (managed or BYOK)
    *
-   * Register a managed provider (naturali-keyed, priced on SOAT) or a BYOK provider (your credentials, stored write-only and never priced). See ProviderCreate for the fields each mode takes.
+   * Register a managed provider (naturali-keyed, priced on the runtime) or a BYOK provider (your credentials, stored write-only and never priced). See ProviderCreate for the fields each mode takes.
    *
    */
   static createProvider<ThrowOnError extends boolean = false>(options: Options<CreateProviderData, ThrowOnError>): RequestResult<CreateProviderResponses, CreateProviderErrors, ThrowOnError>;
   /**
    * Delete a provider
    *
-   * Deletes the backing SOAT ai_provider and its secret. Returns 409 if the provider is still referenced by live resources (agents) — detach those first. `force=true` clears only soft dependents (price overrides, usage history); live references always block deletion.
+   * Deletes the backing provider record on the runtime and its secret. Returns 409 if the provider is still referenced by live resources (agents) — detach those first. `force=true` clears only soft dependents (price overrides, usage history); live references always block deletion.
    *
    */
   static deleteProvider<ThrowOnError extends boolean = false>(options: Options<DeleteProviderData, ThrowOnError>): RequestResult<DeleteProviderResponses, DeleteProviderErrors, ThrowOnError>;
@@ -6493,14 +6514,14 @@ declare class Sessions {
   /**
    * Open a session
    *
-   * Opens a durable session against the agent. The session accumulates messages and is resumable by id; its lifecycle (open / closed / expired) and configuration live in the backing SOAT session.
+   * Opens a durable session against the agent. The session accumulates messages and is resumable by id; its lifecycle (open / closed / expired) and configuration live in the backing runtime session.
    *
    */
   static createSession<ThrowOnError extends boolean = false>(options: Options<CreateSessionData, ThrowOnError>): RequestResult<CreateSessionResponses, CreateSessionErrors, ThrowOnError>;
   /**
    * Get a session
    *
-   * Returns the session's current state — status, activity timestamps and configuration — read live from the backing SOAT session, so a resumed session reflects everything that has happened since it was opened.
+   * Returns the session's current state — status, activity timestamps and configuration — read live from the backing runtime session, so a resumed session reflects everything that has happened since it was opened.
    *
    */
   static getSession<ThrowOnError extends boolean = false>(options: Options<GetSessionData, ThrowOnError>): RequestResult<GetSessionResponses, GetSessionErrors, ThrowOnError>;
@@ -6589,7 +6610,7 @@ declare class Tools {
   /**
    * Delete a tool
    *
-   * Deletes the backing SOAT tool. Returns 409 if the tool is still attached to an agent (detach it first).
+   * Deletes the backing runtime tool. Returns 409 if the tool is still attached to an agent (detach it first).
    *
    */
   static deleteTool<ThrowOnError extends boolean = false>(options: Options<DeleteToolData, ThrowOnError>): RequestResult<DeleteToolResponses, DeleteToolErrors, ThrowOnError>;