@soat/sdk 0.15.6 → 0.15.8

package/dist/index.cjs

@@ -955,7 +955,7 @@ var ApiKeys = class {
 	/**
 	* Create an API key
 	*
-	* Creates a new API key for the authenticated user. - `project_id` is required: every key is scoped to exactly one project. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - Otherwise the key inherits the user's permissions, confined to the key's project.
+	* Creates a new API key for the authenticated user. - `project_id` is optional. When set, the key is scoped to that single project. When omitted or null, the key is **unscoped** and spans every project its owner can reach. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - Otherwise the key inherits the user's permissions (confined to the key's project when scoped).
 	*
 	*/
 	static createApiKey(options) {
@@ -993,7 +993,7 @@ var ApiKeys = class {
 	/**
 	* Update an API key
 	*
-	* Updates an API key's name, project scope, or policies. The project scope can be changed to another project but never cleared. Only the owner or an admin can update it.
+	* Updates an API key's name, project scope, or policies. The project scope can be changed to another project, set (scoping a previously unscoped key), or cleared with null (unscoping the key). Only the owner or an admin can update it.
 	*/
 	static updateApiKey(options) {
 		return (options.client ?? client).put({
@@ -2185,7 +2185,7 @@ var Orchestrations = class {
 	/**
 	* Create an orchestration
 	*
-	* Creates a new orchestration workflow definition in the project.
+	* Creates a new orchestration (pipeline) definition in the project.
 	*/
 	static createOrchestration(options) {
 		return (options.client ?? client).post({
@@ -2711,6 +2711,97 @@ var Sessions = class {
 		});
 	}
 };
+var Tasks = class {
+	/**
+	* List tasks
+	*
+	* Lists tasks (the board query). Filter by workflow, state, status, or assignee — `GET /tasks?workflow_id=...&state=...` is one board column.
+	*/
+	static listTasks(options) {
+		return (options?.client ?? client).get({
+			url: "/api/v1/tasks",
+			...options
+		});
+	}
+	/**
+	* Create a task
+	*
+	* Creates a task bound to a workflow. The task is placed in the workflow's initial state and that state's `on_enter` automation fires.
+	*/
+	static createTask(options) {
+		return (options.client ?? client).post({
+			url: "/api/v1/tasks",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a task
+	*
+	* Deletes a task. Its transition history cascades.
+	*/
+	static deleteTask(options) {
+		return (options.client ?? client).delete({
+			url: "/api/v1/tasks/{task_id}",
+			...options
+		});
+	}
+	/**
+	* Get a task
+	*
+	* Retrieves a task, including its active dispatch and automation status.
+	*/
+	static getTask(options) {
+		return (options.client ?? client).get({
+			url: "/api/v1/tasks/{task_id}",
+			...options
+		});
+	}
+	/**
+	* Update a task
+	*
+	* Updates a task's payload, title, or assignee. `state` is never directly writable — move it with a transition.
+	*/
+	static updateTask(options) {
+		return (options.client ?? client).patch({
+			url: "/api/v1/tasks/{task_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Transition a task
+	*
+	* Fires a named transition on a task. The transition must exist in the workflow and be valid from the task's current state; its guard must pass. This is the single path every state change routes through.
+	*/
+	static transitionTask(options) {
+		return (options.client ?? client).post({
+			url: "/api/v1/tasks/{task_id}/transitions",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Get task history
+	*
+	* Returns the append-only transition history of a task.
+	*/
+	static getTaskHistory(options) {
+		return (options.client ?? client).get({
+			url: "/api/v1/tasks/{task_id}/history",
+			...options
+		});
+	}
+};
 var Tools = class {
 	/**
 	* List tools
@@ -3275,6 +3366,71 @@ var Webhooks = class {
 		});
 	}
 };
+var Workflows = class {
+	/**
+	* List workflows
+	*
+	* Lists workflow definitions in a project.
+	*/
+	static listWorkflows(options) {
+		return (options?.client ?? client).get({
+			url: "/api/v1/workflows",
+			...options
+		});
+	}
+	/**
+	* Create a workflow
+	*
+	* Creates a new workflow definition. The definition is statically validated.
+	*/
+	static createWorkflow(options) {
+		return (options.client ?? client).post({
+			url: "/api/v1/workflows",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a workflow
+	*
+	* Deletes a workflow. Rejected while open tasks exist.
+	*/
+	static deleteWorkflow(options) {
+		return (options.client ?? client).delete({
+			url: "/api/v1/workflows/{workflow_id}",
+			...options
+		});
+	}
+	/**
+	* Get a workflow
+	*
+	* Retrieves a workflow definition.
+	*/
+	static getWorkflow(options) {
+		return (options.client ?? client).get({
+			url: "/api/v1/workflows/{workflow_id}",
+			...options
+		});
+	}
+	/**
+	* Update a workflow
+	*
+	* Updates a workflow definition. Structural changes (states/transitions) are re-validated. Existing tasks in a removed state stay put but can only leave via transitions valid in the new definition.
+	*/
+	static updateWorkflow(options) {
+		return (options.client ?? client).patch({
+			url: "/api/v1/workflows/{workflow_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 //#endregion
 //#region src/soatClient.ts
 /**
@@ -3400,11 +3556,13 @@ exports.Projects = Projects;
 exports.Secrets = Secrets;
 exports.Sessions = Sessions;
 exports.SoatClient = SoatClient;
+exports.Tasks = Tasks;
 exports.Tools = Tools;
 exports.Traces = Traces;
 exports.Triggers = Triggers;
 exports.Usage = Usage;
 exports.Users = Users;
 exports.Webhooks = Webhooks;
+exports.Workflows = Workflows;
 exports.createClient = createClient;
 exports.createConfig = createConfig;