@naturali/cli 0.206.7 → 0.206.9

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.206.7";
+var version = "0.206.9";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -5543,7 +5543,7 @@ var Tasks = class {
 	/**
 	* List tasks
 	*
-	* Lists tasks (the board query). Filter by workflow, state, status, automation status, or assignee — `GET /tasks?workflow_id=...&state=...` is one board column.
+	* Lists tasks (the board query). Filter by workflow, state, status, automation status, assignee, or `metadata` — `GET /tasks?workflow_id=...&state=...` is one board column.
 	*/
 	static listTasks(options) {
 		return (options.client ?? client).get({
@@ -5604,6 +5604,17 @@ var Tasks = class {
 		});
 	}
 	/**
+	* List a task's transitions
+	*
+	* Lists every transition of the workflow version the task is pinned to, with whether firing it now as the caller would be accepted and, when not, the error code firing it would answer. The guard runs with the caller as `principal`. A `requires_approval` transition is allowed before its guard passes: the guard runs when the approval resolves. Advisory: firing re-validates under the task's lock.
+	*/
+	static listTaskTransitions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/tasks/{task_id}/transitions",
+			...options
+		});
+	}
+	/**
 	* Transition a task
 	*
 	* Fires a named transition on a task. The transition must exist in the workflow and be valid from the task's current state; its guard must pass. This is the single path every state change routes through. A transition declaring `requires_approval` does not move the task — it parks a pending ApprovalItem and returns the task with `pending_transition` set; the move applies only when the approval is approved.
@@ -22052,7 +22063,7 @@ const routes = {
 	"list-tasks": {
 		serviceClass: "Tasks",
 		operationId: "listTasks",
-		description: "Lists tasks (the board query). Filter by workflow, state, status, automation status, or assignee — `GET /tasks?workflow_id=...&state=...` is one board column.",
+		description: "Lists tasks (the board query). Filter by workflow, state, status, automation status, assignee, or `metadata` — `GET /tasks?workflow_id=...&state=...` is one board column.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/tasks",
 		httpMethod: "get",
 		pathParams: ["project_id"],
@@ -22062,6 +22073,7 @@ const routes = {
 			"status",
 			"automation_status",
 			"assignee",
+			"metadata",
 			"limit",
 			"offset"
 		],
@@ -22110,6 +22122,13 @@ const routes = {
 				"type": "string",
 				"in": "query"
 			},
+			{
+				"name": "metadata",
+				"description": "A `MetadataFilter` as JSON, url-encoded. It travels as JSON rather than as `key:value` pairs because the match is exact and a query string cannot otherwise say whether `3` is the number or the string.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is `400`.",
@@ -22291,6 +22310,47 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"list-task-transitions": {
+		serviceClass: "Tasks",
+		operationId: "listTaskTransitions",
+		description: "Lists every transition of the workflow version the task is pinned to, with whether firing it now as the caller would be accepted and, when not, the error code firing it would answer. The guard runs with the caller as `principal`. A `requires_approval` transition is allowed before its guard passes: the guard runs when the approval resolves. Advisory: firing re-validates under the task's lock.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/tasks",
+		httpMethod: "get",
+		pathParams: ["project_id", "task_id"],
+		queryParams: ["limit", "offset"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "task_id",
+				"description": "The task whose transitions are listed.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is `400`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
 	"transition-task": {
 		serviceClass: "Tasks",
 		operationId: "transitionTask",
@@ -22299,7 +22359,7 @@ const routes = {
 		httpMethod: "post",
 		pathParams: ["project_id", "task_id"],
 		queryParams: [],
-		headerParams: [],
+		headerParams: ["Idempotency-Key"],
 		cookieParams: [],
 		flags: [
 			{
@@ -22316,6 +22376,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "Idempotency-Key",
+				"description": "The request's deduplication key. Equivalent to `idempotency_key` in the request body; sending both with different values is `400 VALIDATION_FAILED`. A non-empty string of at most 255 characters.",
+				"required": false,
+				"type": "string",
+				"in": "header"
+			},
 			{
 				"name": "transition",
 				"description": "",
@@ -22330,6 +22397,20 @@ const routes = {
 				"type": "string",
 				"in": "body"
 			},
+			{
+				"name": "payload",
+				"description": "Keys shallow-merged over the task's payload under the transition's lock, before the guard reads it, exactly as `PATCH` merges them; the result must satisfy the payload schema of the version the task is pinned to (`TASK_PAYLOAD_INVALID`). A refused move writes none of it. On a `requires_approval` transition the payload is held with the gate and merged when the approval fires the move, so a rejected or expired gate writes nothing.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "idempotency_key",
+				"description": "The move's deduplication key, unique within the task and claimed for as long as the task exists. The same key with the same body replays the task as it is now instead of moving it again, whether the move applied or parked an approval; with a different body it is `409 IDEMPOTENCY_KEY_REUSED`. Equivalent to the `Idempotency-Key` header.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
 			{
 				"name": "tool_context",
 				"description": "Caller context for the automation dispatches the task makes from here on, forwarded as `X-Naturali-Context-<key>` headers on their tool calls.\nSupplying it **replaces** the task's stored bag wholesale; omitting it keeps the current one, so the context follows whoever last moved the task and survives every move that does not speak about it — including an approval gate, a retry, and an automation hop. Send an empty object to clear it without closing the task.\nThe reserved identity keys (`session_id`, `actor_id`, `actor_external_id`) are stripped in any casing and re-derived server-side. A key outside the HTTP header-name grammar is rejected with `INVALID_TOOL_CONTEXT_KEY` (400).\nWrite-only: never returned by a task read, and cleared when the transition closes the task.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.206.7",
+  "version": "0.206.9",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "keywords": [
     "naturali",
@@ -31,7 +31,7 @@
     "yaml": "^2.9.1"
   },
   "devDependencies": {
-    "@naturali/sdk": "0.206.7",
+    "@naturali/sdk": "0.206.9",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",