@naturali/cli 0.50.0 → 0.51.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.50.0";
+var version = "0.51.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) };
@@ -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
@@ -2056,6 +2126,108 @@ var Traces = class {
 		});
 	}
 };
+var Triggers = class {
+	/**
+	* List triggers
+	*
+	* The project's schedule triggers.
+	*/
+	static listTriggers(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/triggers",
+			...options
+		});
+	}
+	/**
+	* Create a trigger
+	*
+	* Schedules `target_id` (an agent in this project) to run on `cron`, a 5-field cron expression evaluated in UTC.
+	*
+	*/
+	static createTrigger(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/triggers",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a trigger
+	*
+	* Removes the trigger. Its firing history is kept.
+	*/
+	static deleteTrigger(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}",
+			...options
+		});
+	}
+	/**
+	* Get a trigger
+	*/
+	static getTrigger(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}",
+			...options
+		});
+	}
+	/**
+	* 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.
+	*
+	*/
+	static updateTrigger(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Fire a trigger manually
+	*
+	* Runs the trigger's target right now, outside its schedule, and waits for the run to finish. This is the `…:fire` action; the path segment is `{trigger_id}:fire`.
+	* `input` is shallow-merged over the trigger's own stored `input` for this run only — the trigger's configuration is unchanged.
+	*
+	*/
+	static fireTrigger(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}:fire",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List a trigger's firings
+	*
+	* Every time this trigger ran, newest first — scheduled and manual alike.
+	*/
+	static listTriggerFirings(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}/firings",
+			...options
+		});
+	}
+	/**
+	* Get a trigger firing
+	*/
+	static getTriggerFiring(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}/firings/{firing_id}",
+			...options
+		});
+	}
+};
 var Webhooks = class {
 	/**
 	* List webhooks
@@ -2285,10 +2457,12 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	NaturaliClient: () => NaturaliClient,
 	Projects: () => Projects,
 	Providers: () => Providers,
+	Runs: () => Runs,
 	Sessions: () => Sessions,
 	Tasks: () => Tasks,
 	Tools: () => Tools,
 	Traces: () => Traces,
+	Triggers: () => Triggers,
 	Webhooks: () => Webhooks,
 	createClient: () => createClient,
 	createConfig: () => createConfig
@@ -5790,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 (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 (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 (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",
@@ -6738,6 +7070,316 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"list-triggers": {
+		serviceClass: "Triggers",
+		operationId: "listTriggers",
+		description: "The project's schedule triggers.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		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"
+			}
+		]
+	},
+	"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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "target_id",
+				"description": "The agent this trigger runs. Must belong to this project.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "input",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "cron",
+				"description": "5-field cron expression, evaluated in UTC.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "active",
+				"description": "",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			}
+		]
+	},
+	"get-trigger": {
+		serviceClass: "Triggers",
+		operationId: "getTrigger",
+		description: "Get a trigger",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "get",
+		pathParams: ["project_id", "trigger_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "trigger_id",
+			"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "patch",
+		pathParams: ["project_id", "trigger_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "trigger_id",
+				"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+				"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": "target_id",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "input",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "cron",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "active",
+				"description": "",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			}
+		]
+	},
+	"delete-trigger": {
+		serviceClass: "Triggers",
+		operationId: "deleteTrigger",
+		description: "Removes the trigger. Its firing history is kept.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "delete",
+		pathParams: ["project_id", "trigger_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "trigger_id",
+			"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"fire-trigger": {
+		serviceClass: "Triggers",
+		operationId: "fireTrigger",
+		description: "Runs the trigger's target right now, outside its schedule, and waits for the run to finish. This is the `…:fire` action; the path segment is `{trigger_id}:fire`. `input` is shallow-merged over the trigger's own stored `input` for this run only — the trigger's configuration is unchanged.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "post",
+		pathParams: ["project_id", "trigger_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "trigger_id",
+				"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "input",
+				"description": "Fire-time input, shallow-merged over the trigger's stored `input`.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"list-trigger-firings": {
+		serviceClass: "Triggers",
+		operationId: "listTriggerFirings",
+		description: "Every time this trigger ran, newest first — scheduled and manual alike.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "get",
+		pathParams: ["project_id", "trigger_id"],
+		queryParams: ["limit", "offset"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "trigger_id",
+				"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+				"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"
+			}
+		]
+	},
+	"get-trigger-firing": {
+		serviceClass: "Triggers",
+		operationId: "getTriggerFiring",
+		description: "Get a trigger firing",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "get",
+		pathParams: [
+			"project_id",
+			"trigger_id",
+			"firing_id"
+		],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "trigger_id",
+				"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "firing_id",
+				"description": "Firing public ID — the runtime firing id.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			}
+		]
+	},
 	"list-webhooks": {
 		serviceClass: "Webhooks",
 		operationId: "listWebhooks",

package/package.json

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