@naturali/sdk 0.38.0 → 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;
@@ -732,7 +753,10 @@ type BoardCreate = {
  */
 type BoardUpdate = {
   name?: string;
-  description?: string;
+  /**
+   * Send null to clear it.
+   */
+  description?: string | null;
   states?: Array<BoardState>;
   transitions?: Array<BoardTransition>;
   /**
@@ -1913,7 +1937,8 @@ type Task = {
    */
   automation_status: 'running' | 'completed' | 'failed' | 'unrouted';
   /**
-   * The in-flight dispatch, if any. An agent column reports `{ kind: "agent", id, status }`, where `id` is the generation — real provenance, readable through Generations. A tool column reports `{ kind: "tool", tool_id, status }`: the machinery a tool column runs on is naturali's own and is not addressable by a caller, so it is named by the tool it stands for rather than by an internal id.
+   * The in-flight dispatch, if any. `kind` is always the column's own kind — the same `agent` / `tool` the board was written with — never the name of the machinery underneath.
+   * An agent column reports `{ kind: "agent", id, status }`, where `id` is the generation — real provenance, readable through Generations. A tool column reports `{ kind: "tool", tool_id, status }`: the machinery a tool column runs on is naturali's own and is not addressable by a caller, so it is named by the tool it stands for rather than by an internal id.
    *
    */
   active_dispatch: {
@@ -1955,7 +1980,8 @@ type TaskUpdate = {
    */
   assignee?: string | null;
   /**
-   * Shallow-merged over the current payload; omitted keys are preserved.
+   * Shallow-merged over the current payload; omitted keys are preserved. Not nullable — `null` is rejected rather than ignored, since a merge has no meaning to give it. Send `{}` to change nothing.
+   *
    */
   payload?: {
     [key: string]: unknown;
@@ -6019,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;
@@ -732,7 +753,10 @@ type BoardCreate = {
  */
 type BoardUpdate = {
   name?: string;
-  description?: string;
+  /**
+   * Send null to clear it.
+   */
+  description?: string | null;
   states?: Array<BoardState>;
   transitions?: Array<BoardTransition>;
   /**
@@ -1913,7 +1937,8 @@ type Task = {
    */
   automation_status: 'running' | 'completed' | 'failed' | 'unrouted';
   /**
-   * The in-flight dispatch, if any. An agent column reports `{ kind: "agent", id, status }`, where `id` is the generation — real provenance, readable through Generations. A tool column reports `{ kind: "tool", tool_id, status }`: the machinery a tool column runs on is naturali's own and is not addressable by a caller, so it is named by the tool it stands for rather than by an internal id.
+   * The in-flight dispatch, if any. `kind` is always the column's own kind — the same `agent` / `tool` the board was written with — never the name of the machinery underneath.
+   * An agent column reports `{ kind: "agent", id, status }`, where `id` is the generation — real provenance, readable through Generations. A tool column reports `{ kind: "tool", tool_id, status }`: the machinery a tool column runs on is naturali's own and is not addressable by a caller, so it is named by the tool it stands for rather than by an internal id.
    *
    */
   active_dispatch: {
@@ -1955,7 +1980,8 @@ type TaskUpdate = {
    */
   assignee?: string | null;
   /**
-   * Shallow-merged over the current payload; omitted keys are preserved.
+   * Shallow-merged over the current payload; omitted keys are preserved. Not nullable — `null` is rejected rather than ignored, since a merge has no meaning to give it. Send `{}` to change nothing.
+   *
    */
   payload?: {
     [key: string]: unknown;
@@ -6019,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.0",
+  "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.0"
+    "@naturali/api": "0.39.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",