@naturali/sdk 0.50.0 → 0.51.0

package/dist/index.cjs

@@ -1736,6 +1736,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
@@ -2039,6 +2109,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
@@ -2266,10 +2438,12 @@ exports.Models = Models;
 exports.NaturaliClient = NaturaliClient;
 exports.Projects = Projects;
 exports.Providers = Providers;
+exports.Runs = Runs;
 exports.Sessions = Sessions;
 exports.Tasks = Tasks;
 exports.Tools = Tools;
 exports.Traces = Traces;
+exports.Triggers = Triggers;
 exports.Webhooks = Webhooks;
 exports.createClient = createClient;
 exports.createConfig = createConfig;