@naturali/sdk 0.38.1 → 0.39.0

package/dist/index.cjs

@@ -655,7 +655,7 @@ var Agents = class {
 	/**
 	* 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(options) {

package/dist/index.d.cts

@@ -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;
@@ -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;
@@ -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>;

package/dist/index.d.mts

@@ -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;
@@ -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;
@@ -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>;

package/dist/index.mjs

@@ -654,7 +654,7 @@ var Agents = class {
 	/**
 	* 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(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.38.1",
+  "version": "0.39.0",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -37,7 +37,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/api": "0.38.1"
+    "@naturali/api": "0.39.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",