@naturali/sdk 0.193.5 → 0.194.0

package/dist/index.d.cts

@@ -1078,6 +1078,16 @@ type Agent = {
    * Maximum number of recent messages to include in the context window sent to the model. When null, all messages are included.
    */
   max_context_messages?: number | null;
+  /**
+   * Maximum number of tokens the model may generate per step of a turn. A response that reaches it stops with `stop_reason` `length`. Null leaves the model's default.
+   */
+  max_output_tokens?: number | null;
+  /**
+   * How much the model reasons before answering. Translated per provider (Anthropic thinking, Gemini thinking config, OpenAI reasoning effort) against what the model supports; a model that cannot reason ignores it. `none` turns reasoning off where the model allows it. Reasoning tokens are metered as output. Null leaves the model's default.
+   */
+  reasoning?: {
+    effort: 'none' | 'low' | 'medium' | 'high';
+  } | null;
   /**
    * When true, only one open session per actor_id is allowed for this agent. Creating a second open session for the same actor returns 409.
    */
@@ -1139,7 +1149,7 @@ type AgentVersion = {
    */
   version?: number;
   /**
-   * The agent's configuration as it stood at this version: every mutable field of the `Agent` schema (`instructions`, `model`, `tool_bindings`, `max_steps`, `tool_choice`, `stop_conditions`, `active_tool_ids`, `step_rules`, `boundary_policy`, `temperature`, `knowledge_config`, `output_schema`, `max_context_messages`, `single_session_per_actor`, `on_approval_expiry`, `guardrail_ids`, `ai_provider_id`, `model_route_id`, `name`), and none of its identity or bookkeeping fields (`id`, `project_id`, `version`, `active_release`, timestamps).
+   * The agent's configuration as it stood at this version: every mutable field of the `Agent` schema (`instructions`, `model`, `tool_bindings`, `max_steps`, `tool_choice`, `stop_conditions`, `active_tool_ids`, `step_rules`, `boundary_policy`, `temperature`, `knowledge_config`, `output_schema`, `max_context_messages`, `max_output_tokens`, `reasoning`, `single_session_per_actor`, `on_approval_expiry`, `guardrail_ids`, `ai_provider_id`, `model_route_id`, `name`), and none of its identity or bookkeeping fields (`id`, `project_id`, `version`, `active_release`, timestamps).
    *
    * Deliberately open rather than a fixed schema: an archive written by an earlier release of the runtime reflects the agent surface **of its own time**, so it may carry fields the current schema no longer defines, or lack ones it has since gained. Knowledge retrieval is not part of the snapshot — a version records which `knowledge_config` applied, while the documents and memory stores it resolves keep their own histories and are pinned at generation time.
    */
@@ -1312,6 +1322,16 @@ type CreateAgentRequest = {
    * Maximum number of recent messages included in the context window. Null means no limit.
    */
   max_context_messages?: number;
+  /**
+   * Maximum number of tokens the model may generate per step of a turn. A response that reaches it stops with `stop_reason` `length`. Null leaves the model's default.
+   */
+  max_output_tokens?: number | null;
+  /**
+   * How much the model reasons before answering. Translated per provider (Anthropic thinking, Gemini thinking config, OpenAI reasoning effort) against what the model supports; a model that cannot reason ignores it. `none` turns reasoning off where the model allows it. Reasoning tokens are metered as output. Null leaves the model's default.
+   */
+  reasoning?: {
+    effort: 'none' | 'low' | 'medium' | 'high';
+  } | null;
   /**
    * When true, only one open session per actor_id is allowed for this agent.
    */
@@ -1447,6 +1467,16 @@ type UpdateAgentRequest = {
    * Maximum number of recent messages included in the context window. Null means no limit.
    */
   max_context_messages?: number | null;
+  /**
+   * Maximum number of tokens the model may generate per step of a turn. A response that reaches it stops with `stop_reason` `length`. Null leaves the model's default.
+   */
+  max_output_tokens?: number | null;
+  /**
+   * How much the model reasons before answering. Translated per provider (Anthropic thinking, Gemini thinking config, OpenAI reasoning effort) against what the model supports; a model that cannot reason ignores it. `none` turns reasoning off where the model allows it. Reasoning tokens are metered as output. Null leaves the model's default.
+   */
+  reasoning?: {
+    effort: 'none' | 'low' | 'medium' | 'high';
+  } | null;
   /**
    * When true, only one open session per actor_id is allowed for this agent.
    */
@@ -2601,6 +2631,11 @@ type Channel = {
   application_id: string | null;
   modes: DiscordModes;
   default: ChannelDefaultAction;
+  /**
+   * The most recent messages each conversation's session sends the model, taking precedence over the agent's own `max_context_messages`. Null defers to the agent.
+   *
+   */
+  max_context_messages?: number | null;
   /**
    * Whether an access token is on file (its value is never returned).
    */
@@ -2648,6 +2683,11 @@ type ChannelCreate = {
    */
   idempotency_key?: string;
   default: ChannelDefaultActionInput;
+  /**
+   * The most recent messages each conversation's session sends the model, taking precedence over the agent's own `max_context_messages`. An open conversation picks a change up on its next message. Null defers to the agent.
+   *
+   */
+  max_context_messages?: number | null;
   channel?: 'whatsapp' | 'discord';
   /**
    * Required for `whatsapp`.
@@ -2707,6 +2747,11 @@ type WhatsAppSignupComplete = {
  */
 type ChannelUpdate = {
   default?: ChannelDefaultActionInput;
+  /**
+   * The most recent messages each conversation's session sends the model, taking precedence over the agent's own `max_context_messages`. An open conversation picks a change up on its next message. Null defers to the agent.
+   *
+   */
+  max_context_messages?: number | null;
   /**
    * WhatsApp. Write-only. Replaces the stored credential.
    */
@@ -4102,6 +4147,16 @@ type AgentResourceProperties = {
    * Maximum number of recent messages to include in the context window sent to the model. When null, all messages are included.
    */
   max_context_messages?: number | null;
+  /**
+   * Maximum number of tokens the model may generate per step of a turn. A response that reaches it stops with `stop_reason` `length`. Null leaves the model's default.
+   */
+  max_output_tokens?: number | null;
+  /**
+   * How much the model reasons before answering. Translated per provider (Anthropic thinking, Gemini thinking config, OpenAI reasoning effort) against what the model supports; a model that cannot reason ignores it. `none` turns reasoning off where the model allows it. Reasoning tokens are metered as output. Null leaves the model's default.
+   */
+  reasoning?: {
+    effort: 'none' | 'low' | 'medium' | 'high';
+  } | null;
   /**
    * When true, only one open session per actor_id is allowed for this agent.
    */
@@ -4702,6 +4757,10 @@ type SessionResourceProperties = {
    * Number of seconds of inactivity after which the session expires. 0 means never expires.
    */
   inactivity_ttl_seconds?: number;
+  /**
+   * Maximum number of recent conversation messages sent to the model on each generation, taking precedence over the agent's. null defers to the agent.
+   */
+  max_context_messages?: number | null;
   /**
    * Optional context object passed to tool calls. Write-only: no read of a session returns it.
    */
@@ -7742,6 +7801,11 @@ type SessionRecord = {
    *
    */
   message_delay_seconds?: number | null;
+  /**
+   * Maximum number of recent conversation messages sent to the model on each generation. Takes precedence over the agent's `max_context_messages`; null defers to it. A fork keeps its parent's value.
+   *
+   */
+  max_context_messages?: number | null;
   /**
    * Timestamp of the last activity on the session (message added or response generated).
    */
@@ -7822,6 +7886,11 @@ type CreateSessionRequest = {
    *
    */
   message_delay_seconds?: number | null;
+  /**
+   * Maximum number of recent conversation messages sent to the model on each generation, taking precedence over the agent's `max_context_messages`. null or absent defers to the agent.
+   *
+   */
+  max_context_messages?: number | null;
 };
 type UpdateSessionRequest = {
   /**
@@ -7852,6 +7921,11 @@ type UpdateSessionRequest = {
    *
    */
   message_delay_seconds?: number | null;
+  /**
+   * Maximum number of recent conversation messages sent to the model on each generation, taking precedence over the agent's `max_context_messages`. Set to null to defer to the agent.
+   *
+   */
+  max_context_messages?: number | null;
 };
 type AddSessionMessageRequest = {
   /**

package/dist/index.d.mts

@@ -1078,6 +1078,16 @@ type Agent = {
    * Maximum number of recent messages to include in the context window sent to the model. When null, all messages are included.
    */
   max_context_messages?: number | null;
+  /**
+   * Maximum number of tokens the model may generate per step of a turn. A response that reaches it stops with `stop_reason` `length`. Null leaves the model's default.
+   */
+  max_output_tokens?: number | null;
+  /**
+   * How much the model reasons before answering. Translated per provider (Anthropic thinking, Gemini thinking config, OpenAI reasoning effort) against what the model supports; a model that cannot reason ignores it. `none` turns reasoning off where the model allows it. Reasoning tokens are metered as output. Null leaves the model's default.
+   */
+  reasoning?: {
+    effort: 'none' | 'low' | 'medium' | 'high';
+  } | null;
   /**
    * When true, only one open session per actor_id is allowed for this agent. Creating a second open session for the same actor returns 409.
    */
@@ -1139,7 +1149,7 @@ type AgentVersion = {
    */
   version?: number;
   /**
-   * The agent's configuration as it stood at this version: every mutable field of the `Agent` schema (`instructions`, `model`, `tool_bindings`, `max_steps`, `tool_choice`, `stop_conditions`, `active_tool_ids`, `step_rules`, `boundary_policy`, `temperature`, `knowledge_config`, `output_schema`, `max_context_messages`, `single_session_per_actor`, `on_approval_expiry`, `guardrail_ids`, `ai_provider_id`, `model_route_id`, `name`), and none of its identity or bookkeeping fields (`id`, `project_id`, `version`, `active_release`, timestamps).
+   * The agent's configuration as it stood at this version: every mutable field of the `Agent` schema (`instructions`, `model`, `tool_bindings`, `max_steps`, `tool_choice`, `stop_conditions`, `active_tool_ids`, `step_rules`, `boundary_policy`, `temperature`, `knowledge_config`, `output_schema`, `max_context_messages`, `max_output_tokens`, `reasoning`, `single_session_per_actor`, `on_approval_expiry`, `guardrail_ids`, `ai_provider_id`, `model_route_id`, `name`), and none of its identity or bookkeeping fields (`id`, `project_id`, `version`, `active_release`, timestamps).
    *
    * Deliberately open rather than a fixed schema: an archive written by an earlier release of the runtime reflects the agent surface **of its own time**, so it may carry fields the current schema no longer defines, or lack ones it has since gained. Knowledge retrieval is not part of the snapshot — a version records which `knowledge_config` applied, while the documents and memory stores it resolves keep their own histories and are pinned at generation time.
    */
@@ -1312,6 +1322,16 @@ type CreateAgentRequest = {
    * Maximum number of recent messages included in the context window. Null means no limit.
    */
   max_context_messages?: number;
+  /**
+   * Maximum number of tokens the model may generate per step of a turn. A response that reaches it stops with `stop_reason` `length`. Null leaves the model's default.
+   */
+  max_output_tokens?: number | null;
+  /**
+   * How much the model reasons before answering. Translated per provider (Anthropic thinking, Gemini thinking config, OpenAI reasoning effort) against what the model supports; a model that cannot reason ignores it. `none` turns reasoning off where the model allows it. Reasoning tokens are metered as output. Null leaves the model's default.
+   */
+  reasoning?: {
+    effort: 'none' | 'low' | 'medium' | 'high';
+  } | null;
   /**
    * When true, only one open session per actor_id is allowed for this agent.
    */
@@ -1447,6 +1467,16 @@ type UpdateAgentRequest = {
    * Maximum number of recent messages included in the context window. Null means no limit.
    */
   max_context_messages?: number | null;
+  /**
+   * Maximum number of tokens the model may generate per step of a turn. A response that reaches it stops with `stop_reason` `length`. Null leaves the model's default.
+   */
+  max_output_tokens?: number | null;
+  /**
+   * How much the model reasons before answering. Translated per provider (Anthropic thinking, Gemini thinking config, OpenAI reasoning effort) against what the model supports; a model that cannot reason ignores it. `none` turns reasoning off where the model allows it. Reasoning tokens are metered as output. Null leaves the model's default.
+   */
+  reasoning?: {
+    effort: 'none' | 'low' | 'medium' | 'high';
+  } | null;
   /**
    * When true, only one open session per actor_id is allowed for this agent.
    */
@@ -2601,6 +2631,11 @@ type Channel = {
   application_id: string | null;
   modes: DiscordModes;
   default: ChannelDefaultAction;
+  /**
+   * The most recent messages each conversation's session sends the model, taking precedence over the agent's own `max_context_messages`. Null defers to the agent.
+   *
+   */
+  max_context_messages?: number | null;
   /**
    * Whether an access token is on file (its value is never returned).
    */
@@ -2648,6 +2683,11 @@ type ChannelCreate = {
    */
   idempotency_key?: string;
   default: ChannelDefaultActionInput;
+  /**
+   * The most recent messages each conversation's session sends the model, taking precedence over the agent's own `max_context_messages`. An open conversation picks a change up on its next message. Null defers to the agent.
+   *
+   */
+  max_context_messages?: number | null;
   channel?: 'whatsapp' | 'discord';
   /**
    * Required for `whatsapp`.
@@ -2707,6 +2747,11 @@ type WhatsAppSignupComplete = {
  */
 type ChannelUpdate = {
   default?: ChannelDefaultActionInput;
+  /**
+   * The most recent messages each conversation's session sends the model, taking precedence over the agent's own `max_context_messages`. An open conversation picks a change up on its next message. Null defers to the agent.
+   *
+   */
+  max_context_messages?: number | null;
   /**
    * WhatsApp. Write-only. Replaces the stored credential.
    */
@@ -4102,6 +4147,16 @@ type AgentResourceProperties = {
    * Maximum number of recent messages to include in the context window sent to the model. When null, all messages are included.
    */
   max_context_messages?: number | null;
+  /**
+   * Maximum number of tokens the model may generate per step of a turn. A response that reaches it stops with `stop_reason` `length`. Null leaves the model's default.
+   */
+  max_output_tokens?: number | null;
+  /**
+   * How much the model reasons before answering. Translated per provider (Anthropic thinking, Gemini thinking config, OpenAI reasoning effort) against what the model supports; a model that cannot reason ignores it. `none` turns reasoning off where the model allows it. Reasoning tokens are metered as output. Null leaves the model's default.
+   */
+  reasoning?: {
+    effort: 'none' | 'low' | 'medium' | 'high';
+  } | null;
   /**
    * When true, only one open session per actor_id is allowed for this agent.
    */
@@ -4702,6 +4757,10 @@ type SessionResourceProperties = {
    * Number of seconds of inactivity after which the session expires. 0 means never expires.
    */
   inactivity_ttl_seconds?: number;
+  /**
+   * Maximum number of recent conversation messages sent to the model on each generation, taking precedence over the agent's. null defers to the agent.
+   */
+  max_context_messages?: number | null;
   /**
    * Optional context object passed to tool calls. Write-only: no read of a session returns it.
    */
@@ -7742,6 +7801,11 @@ type SessionRecord = {
    *
    */
   message_delay_seconds?: number | null;
+  /**
+   * Maximum number of recent conversation messages sent to the model on each generation. Takes precedence over the agent's `max_context_messages`; null defers to it. A fork keeps its parent's value.
+   *
+   */
+  max_context_messages?: number | null;
   /**
    * Timestamp of the last activity on the session (message added or response generated).
    */
@@ -7822,6 +7886,11 @@ type CreateSessionRequest = {
    *
    */
   message_delay_seconds?: number | null;
+  /**
+   * Maximum number of recent conversation messages sent to the model on each generation, taking precedence over the agent's `max_context_messages`. null or absent defers to the agent.
+   *
+   */
+  max_context_messages?: number | null;
 };
 type UpdateSessionRequest = {
   /**
@@ -7852,6 +7921,11 @@ type UpdateSessionRequest = {
    *
    */
   message_delay_seconds?: number | null;
+  /**
+   * Maximum number of recent conversation messages sent to the model on each generation, taking precedence over the agent's `max_context_messages`. Set to null to defer to the agent.
+   *
+   */
+  max_context_messages?: number | null;
 };
 type AddSessionMessageRequest = {
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.193.5",
+  "version": "0.194.0",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "keywords": [
     "naturali",
@@ -38,7 +38,7 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.99.0",
-    "@naturali/api": "0.193.5",
+    "@naturali/api": "0.194.0",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",