@naturali/sdk 0.51.1 → 0.53.0

package/dist/index.cjs

@@ -1594,6 +1594,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
@@ -1736,76 +1893,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
@@ -2113,7 +2200,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({
@@ -2124,7 +2213,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) {
@@ -2160,7 +2249,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) {
@@ -2388,12 +2477,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;
@@ -2415,12 +2506,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);
 	}
 };
@@ -2436,9 +2529,9 @@ exports.Generations = Generations;
 exports.Knowledge = Knowledge;
 exports.Models = Models;
 exports.NaturaliClient = NaturaliClient;
+exports.Orchestrations = Orchestrations;
 exports.Projects = Projects;
 exports.Providers = Providers;
-exports.Runs = Runs;
 exports.Sessions = Sessions;
 exports.Tasks = Tasks;
 exports.Tools = Tools;