@soat/sdk 0.15.6 → 0.15.8

package/dist/index.mjs

@@ -954,7 +954,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) {
@@ -992,7 +992,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({
@@ -2184,7 +2184,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({
@@ -2710,6 +2710,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
@@ -3274,6 +3365,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
 /**
@@ -3376,4 +3532,4 @@ var SoatClient = class {
 	}
 };
 //#endregion
-export { Actors, Agents, AiProviders, ApiKeys, Approvals, Chats, Conversations, Discussions, Documents, Embeddings, Files, Formations, Generations, IngestionRules, Knowledge, Memories, MemoryEntries, Orchestrations, Policies, Projects, Secrets, Sessions, SoatClient, Tools, Traces, Triggers, Usage, Users, Webhooks, createClient, createConfig };
+export { Actors, Agents, AiProviders, ApiKeys, Approvals, Chats, Conversations, Discussions, Documents, Embeddings, Files, Formations, Generations, IngestionRules, Knowledge, Memories, MemoryEntries, Orchestrations, Policies, Projects, Secrets, Sessions, SoatClient, Tasks, Tools, Traces, Triggers, Usage, Users, Webhooks, Workflows, createClient, createConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/sdk",
-  "version": "0.15.6",
+  "version": "0.15.8",
   "description": "TypeScript SDK for the SOAT API",
   "type": "module",
   "main": "dist/index.mjs",