@naturali/cli 0.51.1 → 0.53.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.51.1";
+var version = "0.53.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
@@ -1611,6 +1611,163 @@ var Models = class {
 		});
 	}
 };
+var Orchestrations = class {
+	/**
+	* List orchestrations
+	*
+	* Lists the project's orchestration definitions.
+	*/
+	static listOrchestrations(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/orchestrations",
+			...options
+		});
+	}
+	/**
+	* Create an orchestration
+	*
+	* Creates a new orchestration (pipeline) definition in the project.
+	*/
+	static createOrchestration(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/orchestrations",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Validate an orchestration graph
+	*
+	* Statically validates a graph without persisting anything — the same checks `create`/`update` enforce (unique node ids, edges reference existing nodes, the graph is acyclic unless it contains a loop node, every `input_mapping` reference resolves). Returns blocking `errors` and non-blocking `warnings`.
+	*
+	*/
+	static validateOrchestration(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/orchestrations/validate",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete an orchestration
+	*
+	* Deletes the orchestration definition and all of its runs.
+	*/
+	static deleteOrchestration(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/orchestrations/{orchestration_id}",
+			...options
+		});
+	}
+	/**
+	* Get an orchestration
+	*
+	* Returns one orchestration with its nodes and edges. Belonging to another project responds `404`, not `403` — existence is not leaked.
+	*
+	*/
+	static getOrchestration(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/orchestrations/{orchestration_id}",
+			...options
+		});
+	}
+	/**
+	* Update an orchestration
+	*
+	* Partially updates an orchestration's definition.
+	*/
+	static updateOrchestration(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/orchestrations/{orchestration_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List orchestration runs
+	*
+	* Lists runs of one orchestration. `orchestration_id` is required — it is what scopes the list to this project, since a run carries no cheaper project-level filter of its own.
+	*
+	*/
+	static listOrchestrationRuns(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/orchestration-runs",
+			...options
+		});
+	}
+	/**
+	* Start an orchestration run
+	*
+	* Starts a new run of the orchestration named by `orchestration_id`, which must belong to this project. By default the run executes durably in the background and this returns immediately with `status: "queued"`; pass `wait: true` to block until the run reaches a terminal or `awaiting_input` state instead.
+	*/
+	static startOrchestrationRun(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/orchestration-runs",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Get an orchestration run
+	*
+	* Returns the status, state, and artifacts of one run.
+	*/
+	static getOrchestrationRun(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/orchestration-runs/{orchestration_run_id}",
+			...options
+		});
+	}
+	/**
+	* Cancel an orchestration run
+	*
+	* Cancels a run that has not yet reached a terminal state.
+	*/
+	static cancelOrchestrationRun(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/orchestration-runs/{orchestration_run_id}/cancel",
+			...options
+		});
+	}
+	/**
+	* Resume an orchestration run
+	*
+	* Re-drives an `awaiting_input` run from its last checkpoint. This does not satisfy the pause itself — a run parked on a human or webhook node re-parks on the same node. Use `human-input` to supply the awaited payload and advance the run.
+	*/
+	static resumeOrchestrationRun(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/orchestration-runs/{orchestration_run_id}/resume",
+			...options
+		});
+	}
+	/**
+	* Submit human input
+	*
+	* Provides human input to a run that is `awaiting_input` at a human node, and advances it.
+	*/
+	static submitHumanInput(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/orchestration-runs/{orchestration_run_id}/human-input",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Projects = class {
 	/**
 	* List projects
@@ -1753,76 +1910,6 @@ 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
@@ -2130,7 +2217,9 @@ var Triggers = class {
 	/**
 	* List triggers
 	*
-	* The project's schedule triggers.
+	* The project's schedule triggers, of either fronted target kind.
+	* `total` is the runtime's count of the project's schedule triggers, so it can exceed the rows returned when a trigger was authored directly against the runtime with a target this surface doesn't front (the same bypass `getTrigger` answers `404` for). Pass `target_type` — which is filtered and counted upstream — when an exact count matters.
+	*
 	*/
 	static listTriggers(options) {
 		return (options.client ?? client).get({
@@ -2141,7 +2230,7 @@ var Triggers = class {
 	/**
 	* Create a trigger
 	*
-	* Schedules `target_id` (an agent in this project) to run on `cron`, a 5-field cron expression evaluated in UTC.
+	* Schedules `target_id` — an agent or an orchestration in this project, per `target_type` — to run on `cron`, a 5-field cron expression evaluated in UTC.
 	*
 	*/
 	static createTrigger(options) {
@@ -2177,7 +2266,7 @@ var Triggers = class {
 	/**
 	* Update a trigger
 	*
-	* Retune the schedule, its target, or whether it fires at all. At least one field is required. `type` and `target_type` are immutable.
+	* Retune the schedule, its target, or whether it fires at all. At least one field is required. `type` is immutable; `target_type` may be changed only together with `target_id`.
 	*
 	*/
 	static updateTrigger(options) {
@@ -2405,12 +2494,14 @@ var NaturaliClient = class {
 	generations;
 	knowledge;
 	models;
+	orchestrations;
 	projects;
 	providers;
 	sessions;
 	tasks;
 	tools;
 	traces;
+	triggers;
 	webhooks;
 	/** The underlying HTTP client, for interceptors or one-off requests. */
 	http;
@@ -2432,12 +2523,14 @@ var NaturaliClient = class {
 		this.generations = bindResource(Generations, this.http);
 		this.knowledge = bindResource(Knowledge, this.http);
 		this.models = bindResource(Models, this.http);
+		this.orchestrations = bindResource(Orchestrations, this.http);
 		this.projects = bindResource(Projects, this.http);
 		this.providers = bindResource(Providers, this.http);
 		this.sessions = bindResource(Sessions, this.http);
 		this.tasks = bindResource(Tasks, this.http);
 		this.tools = bindResource(Tools, this.http);
 		this.traces = bindResource(Traces, this.http);
+		this.triggers = bindResource(Triggers, this.http);
 		this.webhooks = bindResource(Webhooks, this.http);
 	}
 };
@@ -2455,9 +2548,9 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Knowledge: () => Knowledge,
 	Models: () => Models,
 	NaturaliClient: () => NaturaliClient,
+	Orchestrations: () => Orchestrations,
 	Projects: () => Projects,
 	Providers: () => Providers,
-	Runs: () => Runs,
 	Sessions: () => Sessions,
 	Tasks: () => Tasks,
 	Tools: () => Tools,
@@ -5600,66 +5693,44 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"list-projects": {
-		serviceClass: "Projects",
-		operationId: "listProjects",
-		description: "Lists projects accessible to the caller.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
-		httpMethod: "get",
-		pathParams: [],
-		queryParams: ["limit", "cursor"],
-		flags: [{
-			"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"
-		}]
-	},
-	"create-project": {
-		serviceClass: "Projects",
-		operationId: "createProject",
-		description: "Creates a project (one per client or per environment).",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
-		httpMethod: "post",
-		pathParams: [],
-		queryParams: [],
-		flags: [{
-			"name": "name",
-			"description": "Human-readable project name.",
-			"required": true,
-			"type": "string",
-			"in": "body"
-		}]
-	},
-	"get-project": {
-		serviceClass: "Projects",
-		operationId: "getProject",
-		description: "Get a project",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
+	"list-orchestrations": {
+		serviceClass: "Orchestrations",
+		operationId: "listOrchestrations",
+		description: "Lists the project's orchestration definitions.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
 		httpMethod: "get",
 		pathParams: ["project_id"],
-		queryParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
+		queryParams: ["limit", "offset"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items to return (1–100).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Items to skip. These lists page by offset rather than by naturali's usual opaque cursor because the upstream ordering is offset-based; a cursor here would only imitate a keyset.\n",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
 	},
-	"update-project": {
-		serviceClass: "Projects",
-		operationId: "updateProject",
-		description: "Rename or archive a project. Archiving is reversible; resources are retained.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
-		httpMethod: "patch",
+	"create-orchestration": {
+		serviceClass: "Orchestrations",
+		operationId: "createOrchestration",
+		description: "Creates a new orchestration (pipeline) definition in the project.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
+		httpMethod: "post",
 		pathParams: ["project_id"],
 		queryParams: [],
 		flags: [
@@ -5673,29 +5744,480 @@ const routes = {
 			{
 				"name": "name",
 				"description": "",
-				"required": false,
+				"required": true,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "status",
+				"name": "description",
 				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
-			}
-		]
-	},
-	"delete-project": {
-		serviceClass: "Projects",
-		operationId: "deleteProject",
-		description: "Permanently deletes the project and its backing runtime project. Fails with 409 if the runtime project still has dependent resources — remove them first, or pass `force=true` to delete the project and all its dependents (agents, providers, tools, sessions, generations, traces). Forcing is destructive and irreversible.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
-		httpMethod: "delete",
-		pathParams: ["project_id"],
-		queryParams: ["force"],
-		flags: [{
-			"name": "project_id",
+			},
+			{
+				"name": "nodes",
+				"description": "",
+				"required": true,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "edges",
+				"description": "",
+				"required": true,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "state_schema",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "input_schema",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"validate-orchestration": {
+		serviceClass: "Orchestrations",
+		operationId: "validateOrchestration",
+		description: "Statically validates a graph without persisting anything — the same checks `create`/`update` enforce (unique node ids, edges reference existing nodes, the graph is acyclic unless it contains a loop node, every `input_mapping` reference resolves). Returns blocking `errors` and non-blocking `warnings`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "nodes",
+				"description": "",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "edges",
+				"description": "",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "input_schema",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"get-orchestration": {
+		serviceClass: "Orchestrations",
+		operationId: "getOrchestration",
+		description: "Returns one orchestration with its nodes and edges. Belonging to another project responds `404`, not `403` — existence is not leaked.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
+		httpMethod: "get",
+		pathParams: ["project_id", "orchestration_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "orchestration_id",
+			"description": "Orchestration public ID (orch_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-orchestration": {
+		serviceClass: "Orchestrations",
+		operationId: "updateOrchestration",
+		description: "Partially updates an orchestration's definition.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
+		httpMethod: "patch",
+		pathParams: ["project_id", "orchestration_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "orchestration_id",
+				"description": "Orchestration public ID (orch_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "nodes",
+				"description": "",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "edges",
+				"description": "",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "state_schema",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "input_schema",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"delete-orchestration": {
+		serviceClass: "Orchestrations",
+		operationId: "deleteOrchestration",
+		description: "Deletes the orchestration definition and all of its runs.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
+		httpMethod: "delete",
+		pathParams: ["project_id", "orchestration_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "orchestration_id",
+			"description": "Orchestration public ID (orch_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"list-orchestration-runs": {
+		serviceClass: "Orchestrations",
+		operationId: "listOrchestrationRuns",
+		description: "Lists runs of one orchestration. `orchestration_id` is required — it is what scopes the list to this project, since a run carries no cheaper project-level filter of its own.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"orchestration_id",
+			"limit",
+			"offset"
+		],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "orchestration_id",
+				"description": "Orchestration public ID to list runs of.",
+				"required": true,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items to return (1–100).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Items to skip. These lists page by offset rather than by naturali's usual opaque cursor because the upstream ordering is offset-based; a cursor here would only imitate a keyset.\n",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"start-orchestration-run": {
+		serviceClass: "Orchestrations",
+		operationId: "startOrchestrationRun",
+		description: "Starts a new run of the orchestration named by `orchestration_id`, which must belong to this project. By default the run executes durably in the background and this returns immediately with `status: \"queued\"`; pass `wait: true` to block until the run reaches a terminal or `awaiting_input` state instead.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
+		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": "Orchestration to run.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "input",
+				"description": "Initial state for the run, merged with orchestration 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\"`.",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			}
+		]
+	},
+	"get-orchestration-run": {
+		serviceClass: "Orchestrations",
+		operationId: "getOrchestrationRun",
+		description: "Returns the status, state, and artifacts of one run.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
+		httpMethod: "get",
+		pathParams: ["project_id", "orchestration_run_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "orchestration_run_id",
+			"description": "Orchestration run public ID (orch_run_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"cancel-orchestration-run": {
+		serviceClass: "Orchestrations",
+		operationId: "cancelOrchestrationRun",
+		description: "Cancels a run that has not yet reached a terminal state.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
+		httpMethod: "post",
+		pathParams: ["project_id", "orchestration_run_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "orchestration_run_id",
+			"description": "Orchestration run public ID (orch_run_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"resume-orchestration-run": {
+		serviceClass: "Orchestrations",
+		operationId: "resumeOrchestrationRun",
+		description: "Re-drives an `awaiting_input` run from its last checkpoint. This does not satisfy the pause itself — a run parked on a human or webhook node re-parks on the same node. Use `human-input` to supply the awaited payload and advance the run.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
+		httpMethod: "post",
+		pathParams: ["project_id", "orchestration_run_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "orchestration_run_id",
+			"description": "Orchestration run public ID (orch_run_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"submit-human-input": {
+		serviceClass: "Orchestrations",
+		operationId: "submitHumanInput",
+		description: "Provides human input to a run that is `awaiting_input` at a human node, and advances it.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/orchestrations",
+		httpMethod: "post",
+		pathParams: ["project_id", "orchestration_run_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "orchestration_run_id",
+				"description": "Orchestration run public ID (orch_run_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "node_id",
+				"description": "ID of the human node to satisfy.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "output",
+				"description": "Output/response provided by the human reviewer.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"list-projects": {
+		serviceClass: "Projects",
+		operationId: "listProjects",
+		description: "Lists projects accessible to the caller.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
+		httpMethod: "get",
+		pathParams: [],
+		queryParams: ["limit", "cursor"],
+		flags: [{
+			"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"
+		}]
+	},
+	"create-project": {
+		serviceClass: "Projects",
+		operationId: "createProject",
+		description: "Creates a project (one per client or per environment).",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
+		httpMethod: "post",
+		pathParams: [],
+		queryParams: [],
+		flags: [{
+			"name": "name",
+			"description": "Human-readable project name.",
+			"required": true,
+			"type": "string",
+			"in": "body"
+		}]
+	},
+	"get-project": {
+		serviceClass: "Projects",
+		operationId: "getProject",
+		description: "Get a project",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-project": {
+		serviceClass: "Projects",
+		operationId: "updateProject",
+		description: "Rename or archive a project. Archiving is reversible; resources are retained.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
+		httpMethod: "patch",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "status",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"delete-project": {
+		serviceClass: "Projects",
+		operationId: "deleteProject",
+		description: "Permanently deletes the project and its backing runtime project. Fails with 409 if the runtime project still has dependent resources — remove them first, or pass `force=true` to delete the project and all its dependents (agents, providers, tools, sessions, generations, traces). Forcing is destructive and irreversible.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
+		httpMethod: "delete",
+		pathParams: ["project_id"],
+		queryParams: ["force"],
+		flags: [{
+			"name": "project_id",
 			"description": "Project public ID (proj_ prefix).",
 			"required": true,
 			"type": "string",
@@ -5964,164 +6486,6 @@ 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",
@@ -7073,11 +7437,15 @@ const routes = {
 	"list-triggers": {
 		serviceClass: "Triggers",
 		operationId: "listTriggers",
-		description: "The project's schedule triggers.",
+		description: "The project's schedule triggers, of either fronted target kind. `total` is the runtime's count of the project's schedule triggers, so it can exceed the rows returned when a trigger was authored directly against the runtime with a target this surface doesn't front (the same bypass `getTrigger` answers `404` for). Pass `target_type` — which is filtered and counted upstream — when an exact count matters.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
 		httpMethod: "get",
 		pathParams: ["project_id"],
-		queryParams: ["limit", "offset"],
+		queryParams: [
+			"target_type",
+			"limit",
+			"offset"
+		],
 		flags: [
 			{
 				"name": "project_id",
@@ -7086,6 +7454,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "target_type",
+				"description": "Narrow the page to one target kind. Filtered and counted upstream, so `total` is exact. Omit it to list both kinds — see the operation's note on `total`.\n",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "Maximum items to return (1–100).",
@@ -7105,7 +7480,7 @@ const routes = {
 	"create-trigger": {
 		serviceClass: "Triggers",
 		operationId: "createTrigger",
-		description: "Schedules `target_id` (an agent in this project) to run on `cron`, a 5-field cron expression evaluated in UTC.",
+		description: "Schedules `target_id` — an agent or an orchestration in this project, per `target_type` — to run on `cron`, a 5-field cron expression evaluated in UTC.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -7132,9 +7507,16 @@ const routes = {
 				"type": "string",
 				"in": "body"
 			},
+			{
+				"name": "target_type",
+				"description": "Which kind of resource `target_id` names. Defaults to `agent`, so a body written before the orchestration target existed keeps its meaning.\n",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
 			{
 				"name": "target_id",
-				"description": "The agent this trigger runs. Must belong to this project.",
+				"description": "The agent or orchestration this trigger runs, per `target_type`. Must belong to this project — an id from another project is `404`.\n",
 				"required": true,
 				"type": "string",
 				"in": "body"
@@ -7187,7 +7569,7 @@ const routes = {
 	"update-trigger": {
 		serviceClass: "Triggers",
 		operationId: "updateTrigger",
-		description: "Retune the schedule, its target, or whether it fires at all. At least one field is required. `type` and `target_type` are immutable.",
+		description: "Retune the schedule, its target, or whether it fires at all. At least one field is required. `type` is immutable; `target_type` may be changed only together with `target_id`.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
 		httpMethod: "patch",
 		pathParams: ["project_id", "trigger_id"],
@@ -7221,6 +7603,13 @@ const routes = {
 				"type": "string",
 				"in": "body"
 			},
+			{
+				"name": "target_type",
+				"description": "Change what kind of resource the trigger runs. Must be sent **together with `target_id`** — the kind and the id are one target, and accepting the kind alone would leave the trigger pointing at an id of the wrong kind (`400`). Sending `target_id` on its own is fine and keeps the trigger's current kind, which is the kind the new id is validated against.\n",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
 			{
 				"name": "target_id",
 				"description": "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.51.1",
+  "version": "0.53.0",
   "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.51.1"
+    "@naturali/sdk": "0.53.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",