@naturali/sdk 0.34.1 → 0.35.0

package/dist/index.cjs

@@ -825,6 +825,76 @@ var Auth = class {
 		});
 	}
 };
+var Boards = class {
+	/**
+	* List boards
+	*
+	* Lists the boards defined in the project, newest first.
+	*/
+	static listBoards(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/boards",
+			...options
+		});
+	}
+	/**
+	* Create a board
+	*
+	* Define a board's columns and moves. Exactly one column must be `initial: true`; any number may be `terminal: true` (a card closes when it enters one). Every agent or tool a column dispatches must belong to this project, and every move a column routes to must be declared in `transitions`.
+	*
+	*/
+	static createBoard(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/boards",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a board
+	*
+	* Refused while the board still has open cards (409 `board_has_open_tasks`) — close or delete them first. Deleting a board whose cards are all closed removes those cards and their transition history along with it.
+	*
+	*/
+	static deleteBoard(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/boards/{board_id}",
+			...options
+		});
+	}
+	/**
+	* Get a board
+	*
+	* The board's current definition — the source of truth for which columns exist and which moves are legal from each, so a UI renders its columns and its buttons from this response.
+	*
+	*/
+	static getBoard(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/boards/{board_id}",
+			...options
+		});
+	}
+	/**
+	* Update a board
+	*
+	* Change the name, description, `payload_schema`, or the definition itself. `states` and `transitions` are edited together or not at all — a column routes to a move and a move names columns, so validating one against a stale copy of the other would accept a definition that cannot route. At least one field is required.
+	* Cards already on the board are not moved. A card sitting in a column the new definition drops stays where it is and can only leave through a move the new definition declares: the definition is the sole authority at the moment a move is fired.
+	*
+	*/
+	static updateBoard(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/boards/{board_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Channels = class {
 	/**
 	* List channels
@@ -1532,6 +1602,106 @@ var Sessions = class {
 		});
 	}
 };
+var Tasks = class {
+	/**
+	* List tasks
+	*
+	* The board query. Filter by `board_id` for one board, add `state` for one column, or use `status` / `assignee` across boards.
+	*
+	*/
+	static listTasks(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/tasks",
+			...options
+		});
+	}
+	/**
+	* Create a task
+	*
+	* Put a card on a board. It lands in the board's initial column and that column's automation fires — so a board whose first column dispatches an agent starts working on this call and keeps going, unattended, until a column needs a person.
+	*
+	*/
+	static createTask(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/tasks",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a task
+	*
+	* Removes the card and its transition history. Distinct from closing it: a card that reaches a terminal column closes and keeps its audit trail.
+	*
+	*/
+	static deleteTask(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/tasks/{task_id}",
+			...options
+		});
+	}
+	/**
+	* Get a task
+	*
+	* One card, including its automation status and in-flight dispatch.
+	*/
+	static getTask(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/tasks/{task_id}",
+			...options
+		});
+	}
+	/**
+	* Update a task
+	*
+	* Edit the card's `title`, `assignee` or `payload`. At least one is required.
+	* `payload` is **shallow-merged** over what is there: keys the request omits are preserved, so setting one field never discards what a column's automation wrote (`payload.last_result`). The merged result is validated against the board's `payload_schema`.
+	* `state` and `board_id` are rejected — a card moves only through `:transition`, and it never changes boards.
+	*
+	*/
+	static updateTask(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/tasks/{task_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Move a task
+	*
+	* Fire a named move on the card — the single path every state change takes. The move must be declared on the board and valid from the card's current column; the board's definition is what a UI renders its buttons from.
+	* Naming a move that does not exist, one that is not legal from this column, or any move at all on a closed card all answer 409 `task_transition_conflict`: it is a conflict with the card's state rather than a malformed request — the same body succeeds one column earlier.
+	*
+	*/
+	static transitionTask(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/tasks/{task_id}:transition",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List the task's moves
+	*
+	* The card's append-only history, oldest first: every move it made, what kind of actor made it, and what caused it. Returned whole — `next_cursor` is always null.
+	*
+	*/
+	static listTaskTransitions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/tasks/{task_id}/transitions",
+			...options
+		});
+	}
+};
 var Tools = class {
 	/**
 	* List tools
@@ -1698,6 +1868,7 @@ var NaturaliClient = class {
 	agents;
 	apiKeys;
 	auth;
+	boards;
 	channels;
 	contacts;
 	generations;
@@ -1706,6 +1877,7 @@ var NaturaliClient = class {
 	projects;
 	providers;
 	sessions;
+	tasks;
 	tools;
 	traces;
 	/** The underlying HTTP client, for interceptors or one-off requests. */
@@ -1721,6 +1893,7 @@ var NaturaliClient = class {
 		this.agents = bindResource(Agents, this.http);
 		this.apiKeys = bindResource(ApiKeys, this.http);
 		this.auth = bindResource(Auth, this.http);
+		this.boards = bindResource(Boards, this.http);
 		this.channels = bindResource(Channels, this.http);
 		this.contacts = bindResource(Contacts, this.http);
 		this.generations = bindResource(Generations, this.http);
@@ -1729,6 +1902,7 @@ var NaturaliClient = class {
 		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);
 	}
@@ -1737,6 +1911,7 @@ var NaturaliClient = class {
 exports.Agents = Agents;
 exports.ApiKeys = ApiKeys;
 exports.Auth = Auth;
+exports.Boards = Boards;
 exports.Channels = Channels;
 exports.Contacts = Contacts;
 exports.Generations = Generations;
@@ -1746,6 +1921,7 @@ exports.NaturaliClient = NaturaliClient;
 exports.Projects = Projects;
 exports.Providers = Providers;
 exports.Sessions = Sessions;
+exports.Tasks = Tasks;
 exports.Tools = Tools;
 exports.Traces = Traces;
 exports.createClient = createClient;