@naturali/cli 0.206.10 → 0.207.0

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.206.10";
+var version = "0.207.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -5630,6 +5630,21 @@ var Tasks = class {
 		});
 	}
 	/**
+	* Migrate a task to a newer workflow version
+	*
+	* Moves an open task onto a newer version of its workflow. A state the target version also declares maps to itself; `state_map` maps a state it lacks. The payload is re-validated against the target `payload_schema`. The mapped state's `on_enter` is not fired: transition the task when you want the target's automation. A task with a dispatch in flight or a transition pending approval is refused, since both belong to the version they started under. Recorded in history as a row with `transition: null` and both versions.
+	*/
+	static migrateTask(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/tasks/{task_id}/migrate",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
 	* Pause a task
 	*
 	* Pauses a task's automation. While a pause is in force no state's `on_enter` dispatches and no retry chain continues — an agent generation, a tool call and a sub-orchestration alike — so the task stops spending without losing its place.
@@ -6421,7 +6436,7 @@ var Workflows = class {
 	/**
 	* Fetch an archived workflow version
 	*
-	* Returns the exact state machine a given version describes. Every task records the version it entered on in `workflow_version` and runs on that machine for its whole life, so this is how you read the definition a task is actually being validated against — including a task whose workflow has been rewired since.
+	* Returns the exact state machine a given version describes. Every task records the version it runs on in `workflow_version`, fixed at creation and moved only by migrate-task, so this is how you read the definition a task is actually being validated against — including a task whose workflow has been rewired since.
 	*
 	*/
 	static getWorkflowVersion(options) {
@@ -6448,6 +6463,32 @@ var Workflows = class {
 			}
 		});
 	}
+	/**
+	* Migrate a workflow's open tasks to one of its versions
+	*
+	* Moves every open task of the workflow that runs on an older version, or on none, onto `to_version`. Each task is migrated as migrate-task migrates one and needs `tasks:MigrateTask` on it; a task it would refuse is reported as `refused` with the error, and the run goes on. The tasks and the caller's permission on each are fixed when the run is recorded. A `state_map` target the version lacks, or a terminal one, refuses the request before any task moves. Runs in the background by default (`status: queued`); `wait: true` answers once every task has settled. See [Migrating every open task](/docs/modules/workflows#migrating-every-open-task).
+	*/
+	static createWorkflowMigration(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/workflows/{workflow_id}/migrations",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Get a workflow migration
+	*
+	* Returns a workflow migration with the outcome of each task.
+	*/
+	static getWorkflowMigration(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/workflows/{workflow_id}/migrations/{migration_id}",
+			...options
+		});
+	}
 };
 //#endregion
 //#region ../sdk/src/naturaliClient.ts
@@ -22420,6 +22461,47 @@ const routes = {
 			}
 		]
 	},
+	"migrate-task": {
+		serviceClass: "Tasks",
+		operationId: "migrateTask",
+		description: "Moves an open task onto a newer version of its workflow. A state the target version also declares maps to itself; `state_map` maps a state it lacks. The payload is re-validated against the target `payload_schema`. The mapped state's `on_enter` is not fired: transition the task when you want the target's automation. A task with a dispatch in flight or a transition pending approval is refused, since both belong to the version they started under. Recorded in history as a row with `transition: null` and both versions.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/tasks",
+		httpMethod: "post",
+		pathParams: ["project_id", "task_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "task_id",
+				"description": "The task to migrate.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "to_version",
+				"description": "The workflow version to move the task onto; newer than its current one.",
+				"required": true,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "state_map",
+				"description": "Current state name to a state the target version declares. Required only for a state the target lacks; an entry for a state both declare overrides the identity mapping.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
 	"pause-task": {
 		serviceClass: "Tasks",
 		operationId: "pauseTask",
@@ -24419,7 +24501,7 @@ const routes = {
 	"get-workflow-version": {
 		serviceClass: "Workflows",
 		operationId: "getWorkflowVersion",
-		description: "Returns the exact state machine a given version describes. Every task records the version it entered on in `workflow_version` and runs on that machine for its whole life, so this is how you read the definition a task is actually being validated against — including a task whose workflow has been rewired since.",
+		description: "Returns the exact state machine a given version describes. Every task records the version it runs on in `workflow_version`, fixed at creation and moved only by migrate-task, so this is how you read the definition a task is actually being validated against — including a task whose workflow has been rewired since.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/workflows",
 		httpMethod: "get",
 		pathParams: [
@@ -24498,6 +24580,92 @@ const routes = {
 				"in": "body"
 			}
 		]
+	},
+	"create-workflow-migration": {
+		serviceClass: "Workflows",
+		operationId: "createWorkflowMigration",
+		description: "Moves every open task of the workflow that runs on an older version, or on none, onto `to_version`. Each task is migrated as migrate-task migrates one and needs `tasks:MigrateTask` on it; a task it would refuse is reported as `refused` with the error, and the run goes on. The tasks and the caller's permission on each are fixed when the run is recorded. A `state_map` target the version lacks, or a terminal one, refuses the request before any task moves. Runs in the background by default (`status: queued`); `wait: true` answers once every task has settled. See [Migrating every open task](/docs/modules/workflows#migrating-every-open-task).",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/workflows",
+		httpMethod: "post",
+		pathParams: ["project_id", "workflow_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "workflow_id",
+				"description": "The workflow whose tasks migrate.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "to_version",
+				"description": "The workflow version to move the open tasks onto.",
+				"required": true,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "state_map",
+				"description": "Current state name to a state the target version declares, applied to every task as migrate-task applies it to one.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "wait",
+				"description": "When omitted or `false` (default), the run is answered `queued` and settles in the background; poll get-workflow-migration. Pass `true` to answer once every task has settled.",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			}
+		]
+	},
+	"get-workflow-migration": {
+		serviceClass: "Workflows",
+		operationId: "getWorkflowMigration",
+		description: "Returns a workflow migration with the outcome of each task.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/workflows",
+		httpMethod: "get",
+		pathParams: [
+			"project_id",
+			"workflow_id",
+			"migration_id"
+		],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "workflow_id",
+				"description": "The workflow whose tasks migrate.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "migration_id",
+				"description": "The workflow migration to read.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			}
+		]
 	}
 };
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.206.10",
+  "version": "0.207.0",
   "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.10",
+    "@naturali/sdk": "0.207.0",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",