@naturali/sdk 0.55.0 → 0.55.1

package/dist/index.cjs

@@ -2023,7 +2023,7 @@ var Tasks = class {
 	* Update a task
 	*
 	* Edit the card's `title`, `assignee` or `payload`. At least one is required.
-	* `payload` is **shallow-merged** over what is there: keys the request omits are preserved, so setting one field never discards what a column's automation wrote (`payload.last_result`). The merged result is validated against the board's `payload_schema`.
+	* `payload` is **shallow-merged** over what is there: keys the request omits are preserved. The merged result is validated against the board's `payload_schema`. `last_result` is read-only and lives in its own field — a payload write can never discard or forge it.
 	* `state` and `board_id` are rejected — a card moves only through `:transition`, and it never changes boards.
 	*
 	*/

package/dist/index.d.cts

@@ -2506,13 +2506,20 @@ type Task = {
    */
   status: 'open' | 'closed';
   /**
-   * The card's working data — what a column's `input_mapping` reads and what a completed dispatch writes back to (`payload.last_result`). Store references to artifacts (file and document ids), not the artifacts themselves.
-   * **`last_result` is shaped by the kind of column that wrote it.** An agent column writes its generation output. A **tool** column writes the enclosing run's state, which puts the tool's own result one level down under `nodes.tool` — so a later column chains off a tool column with `{"var": "task.payload.last_result.nodes.tool.<field>"}`, not `last_result.<field>`. (Inside the tool column's *own* `on_complete`, `result.<field>` works as documented; only chaining from a *later* column sees the run-state shape.)
+   * The card's working data — entirely caller-owned, and what a column's `input_mapping` reads. Store references to artifacts (file and document ids), not the artifacts themselves. A dispatch's result does **not** land here — see `last_result`.
    *
    */
   payload: {
     [key: string]: unknown;
   };
+  /**
+   * The most recent column's dispatch result — read-only, and overwritten whole by every dispatch (never merged with the previous one). Null until the card's first dispatch settles.
+   * **Shaped by the kind of column that wrote it.** An agent column writes its generation output. A **tool** or **poll** column writes the enclosing run's state, which puts the tool's own result one level down under `nodes.tool` (or `nodes.poll`) — so a later column chains off one with `{"var": "task.last_result.nodes.tool.<field>"}`, not `last_result.<field>`. (Inside that column's *own* `on_complete`, `result.<field>` works as documented; only chaining from a *later* column sees the run-state shape.) A delay column writes nothing meaningful here — it dispatches no tool.
+   *
+   */
+  last_result: {
+    [key: string]: unknown;
+  } | null;
   /**
    * Informational label; it does not restrict who may move the card.
    */
@@ -2523,8 +2530,8 @@ type Task = {
    */
   automation_status: 'running' | 'completed' | 'failed' | 'unrouted';
   /**
-   * 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.
+   * The in-flight dispatch, if any. `kind` is always the column's own kind — the same `agent` / `tool` / `poll` / `delay` 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 or poll column reports `{ kind: "tool" | "poll", tool_id, status }`: the machinery these columns run 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. A delay column names no tool, so it reports `{ kind: "delay", status }` with no `tool_id`.
    *
    */
   active_dispatch: {
@@ -9456,7 +9463,7 @@ declare class Tasks {
    * Update a task
    *
    * Edit the card's `title`, `assignee` or `payload`. At least one is required.
-   * `payload` is **shallow-merged** over what is there: keys the request omits are preserved, so setting one field never discards what a column's automation wrote (`payload.last_result`). The merged result is validated against the board's `payload_schema`.
+   * `payload` is **shallow-merged** over what is there: keys the request omits are preserved. The merged result is validated against the board's `payload_schema`. `last_result` is read-only and lives in its own field — a payload write can never discard or forge it.
    * `state` and `board_id` are rejected — a card moves only through `:transition`, and it never changes boards.
    *
    */

package/dist/index.d.mts

@@ -2506,13 +2506,20 @@ type Task = {
    */
   status: 'open' | 'closed';
   /**
-   * The card's working data — what a column's `input_mapping` reads and what a completed dispatch writes back to (`payload.last_result`). Store references to artifacts (file and document ids), not the artifacts themselves.
-   * **`last_result` is shaped by the kind of column that wrote it.** An agent column writes its generation output. A **tool** column writes the enclosing run's state, which puts the tool's own result one level down under `nodes.tool` — so a later column chains off a tool column with `{"var": "task.payload.last_result.nodes.tool.<field>"}`, not `last_result.<field>`. (Inside the tool column's *own* `on_complete`, `result.<field>` works as documented; only chaining from a *later* column sees the run-state shape.)
+   * The card's working data — entirely caller-owned, and what a column's `input_mapping` reads. Store references to artifacts (file and document ids), not the artifacts themselves. A dispatch's result does **not** land here — see `last_result`.
    *
    */
   payload: {
     [key: string]: unknown;
   };
+  /**
+   * The most recent column's dispatch result — read-only, and overwritten whole by every dispatch (never merged with the previous one). Null until the card's first dispatch settles.
+   * **Shaped by the kind of column that wrote it.** An agent column writes its generation output. A **tool** or **poll** column writes the enclosing run's state, which puts the tool's own result one level down under `nodes.tool` (or `nodes.poll`) — so a later column chains off one with `{"var": "task.last_result.nodes.tool.<field>"}`, not `last_result.<field>`. (Inside that column's *own* `on_complete`, `result.<field>` works as documented; only chaining from a *later* column sees the run-state shape.) A delay column writes nothing meaningful here — it dispatches no tool.
+   *
+   */
+  last_result: {
+    [key: string]: unknown;
+  } | null;
   /**
    * Informational label; it does not restrict who may move the card.
    */
@@ -2523,8 +2530,8 @@ type Task = {
    */
   automation_status: 'running' | 'completed' | 'failed' | 'unrouted';
   /**
-   * 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.
+   * The in-flight dispatch, if any. `kind` is always the column's own kind — the same `agent` / `tool` / `poll` / `delay` 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 or poll column reports `{ kind: "tool" | "poll", tool_id, status }`: the machinery these columns run 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. A delay column names no tool, so it reports `{ kind: "delay", status }` with no `tool_id`.
    *
    */
   active_dispatch: {
@@ -9456,7 +9463,7 @@ declare class Tasks {
    * Update a task
    *
    * Edit the card's `title`, `assignee` or `payload`. At least one is required.
-   * `payload` is **shallow-merged** over what is there: keys the request omits are preserved, so setting one field never discards what a column's automation wrote (`payload.last_result`). The merged result is validated against the board's `payload_schema`.
+   * `payload` is **shallow-merged** over what is there: keys the request omits are preserved. The merged result is validated against the board's `payload_schema`. `last_result` is read-only and lives in its own field — a payload write can never discard or forge it.
    * `state` and `board_id` are rejected — a card moves only through `:transition`, and it never changes boards.
    *
    */

package/dist/index.mjs

@@ -2022,7 +2022,7 @@ var Tasks = class {
 	* Update a task
 	*
 	* Edit the card's `title`, `assignee` or `payload`. At least one is required.
-	* `payload` is **shallow-merged** over what is there: keys the request omits are preserved, so setting one field never discards what a column's automation wrote (`payload.last_result`). The merged result is validated against the board's `payload_schema`.
+	* `payload` is **shallow-merged** over what is there: keys the request omits are preserved. The merged result is validated against the board's `payload_schema`. `last_result` is read-only and lives in its own field — a payload write can never discard or forge it.
 	* `state` and `board_id` are rejected — a card moves only through `:transition`, and it never changes boards.
 	*
 	*/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.55.0",
+  "version": "0.55.1",
   "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.55.0"
+    "@naturali/api": "0.55.1"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",