@naturali/cli 0.50.1 → 0.51.1

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.50.1";
+var version = "0.51.1";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
@@ -1753,6 +1753,76 @@ var Providers = class {
 		});
 	}
 };
+var Runs = class {
+	/**
+	* List runs
+	*
+	* Runs of one orchestration, most recent first. `orchestration_id` is required — a project-wide run feed is not offered, since the upstream runtime's own list has no project filter (see the file description).
+	*
+	*/
+	static listRuns(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/runs",
+			...options
+		});
+	}
+	/**
+	* Start a run
+	*
+	* Creates a new run of the orchestration named by `orchestration_id`. By default the run executes durably in the background and this call returns immediately with status `queued`; poll `GET …/runs/{run_id}` to observe progress. Pass `wait: true` to block until the run reaches a terminal or `awaiting_input` state instead.
+	*
+	*/
+	static startRun(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/runs",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Get a run
+	*
+	* One run's status, accumulated state, per-node artifacts and execution trace.
+	*
+	*/
+	static getRun(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/runs/{run_id}",
+			...options
+		});
+	}
+	/**
+	* Cancel a run
+	*
+	* Stops a run that has not yet reached a terminal state.
+	*/
+	static cancelRun(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/runs/{run_id}:cancel",
+			...options
+		});
+	}
+	/**
+	* Resume a run
+	*
+	* Moves a run parked at `awaiting_input` forward — the single door for every resume, whatever the run is parked on. Send `output` to answer a human-node pause and advance past it; omit it to re-drive a run without answering anything, which re-parks a human or webhook-receive pause on the same node (useful for a delay/poll wait, or to nudge a run after an external side effect completed out of band).
+	* Only valid on a run whose status is `awaiting_input`; any other status answers 409.
+	*
+	*/
+	static resumeRun(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/runs/{run_id}:resume",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Sessions = class {
 	/**
 	* Open a session
@@ -2387,6 +2457,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	NaturaliClient: () => NaturaliClient,
 	Projects: () => Projects,
 	Providers: () => Providers,
+	Runs: () => Runs,
 	Sessions: () => Sessions,
 	Tasks: () => Tasks,
 	Tools: () => Tools,
@@ -5893,6 +5964,164 @@ const routes = {
 			}
 		]
 	},
+	"list-runs": {
+		serviceClass: "Runs",
+		operationId: "listRuns",
+		description: "Runs of one orchestration, most recent first. `orchestration_id` is required — a project-wide run feed is not offered, since the upstream runtime's own list has no project filter (see the file description).",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/runs",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"orchestration_id",
+			"limit",
+			"cursor"
+		],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "orchestration_id",
+				"description": "Only runs of this orchestration. Required — see the file description for why a project-wide feed is not offered. An orchestration this project does not own is a 404, not an empty page.\n",
+				"required": true,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "Opaque pagination cursor from a previous response's next_cursor.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
+	"start-run": {
+		serviceClass: "Runs",
+		operationId: "startRun",
+		description: "Creates a new run of the orchestration named by `orchestration_id`. By default the run executes durably in the background and this call returns immediately with status `queued`; poll `GET …/runs/{run_id}` to observe progress. Pass `wait: true` to block until the run reaches a terminal or `awaiting_input` state instead.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/runs",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "orchestration_id",
+				"description": "The orchestration to run.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "input",
+				"description": "Initial state for the run, merged with the orchestration's own defaults.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "wait",
+				"description": "When true, block until the run reaches a terminal or `awaiting_input` state and return the settled run. When false (default), return immediately with `status: \"queued\"`.\n",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			}
+		]
+	},
+	"get-run": {
+		serviceClass: "Runs",
+		operationId: "getRun",
+		description: "One run's status, accumulated state, per-node artifacts and execution trace.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/runs",
+		httpMethod: "get",
+		pathParams: ["project_id", "run_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "run_id",
+			"description": "Run public ID (orch_run_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"cancel-run": {
+		serviceClass: "Runs",
+		operationId: "cancelRun",
+		description: "Stops a run that has not yet reached a terminal state.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/runs",
+		httpMethod: "post",
+		pathParams: ["project_id", "run_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "run_id",
+			"description": "Run public ID (orch_run_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"resume-run": {
+		serviceClass: "Runs",
+		operationId: "resumeRun",
+		description: "Moves a run parked at `awaiting_input` forward — the single door for every resume, whatever the run is parked on. Send `output` to answer a human-node pause and advance past it; omit it to re-drive a run without answering anything, which re-parks a human or webhook-receive pause on the same node (useful for a delay/poll wait, or to nudge a run after an external side effect completed out of band). Only valid on a run whose status is `awaiting_input`; any other status answers 409.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/runs",
+		httpMethod: "post",
+		pathParams: ["project_id", "run_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "run_id",
+				"description": "Run public ID (orch_run_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "output",
+				"description": "Answers a human-node pause and advances the run past it. Omit to re-drive the run without answering anything.\n",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
 	"create-session": {
 		serviceClass: "Sessions",
 		operationId: "createSession",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.50.1",
+  "version": "0.51.1",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/sdk": "0.50.1"
+    "@naturali/sdk": "0.51.1"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",