@naturali/cli 0.34.1 → 0.35.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.34.1";
+var version = "0.35.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
@@ -842,6 +842,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
@@ -1549,6 +1619,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
@@ -1715,6 +1885,7 @@ var NaturaliClient = class {
 	agents;
 	apiKeys;
 	auth;
+	boards;
 	channels;
 	contacts;
 	generations;
@@ -1723,6 +1894,7 @@ var NaturaliClient = class {
 	projects;
 	providers;
 	sessions;
+	tasks;
 	tools;
 	traces;
 	/** The underlying HTTP client, for interceptors or one-off requests. */
@@ -1738,6 +1910,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);
@@ -1746,6 +1919,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);
 	}
@@ -1756,6 +1930,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Agents: () => Agents,
 	ApiKeys: () => ApiKeys,
 	Auth: () => Auth,
+	Boards: () => Boards,
 	Channels: () => Channels,
 	Contacts: () => Contacts,
 	Generations: () => Generations,
@@ -1765,6 +1940,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Projects: () => Projects,
 	Providers: () => Providers,
 	Sessions: () => Sessions,
+	Tasks: () => Tasks,
 	Tools: () => Tools,
 	Traces: () => Traces,
 	createClient: () => createClient,
@@ -2614,6 +2790,195 @@ const routes = {
 		queryParams: [],
 		flags: []
 	},
+	"list-boards": {
+		serviceClass: "Boards",
+		operationId: "listBoards",
+		description: "Lists the boards defined in the project, newest first.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/boards",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: ["limit", "cursor"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "Opaque pagination cursor from a previous response's next_cursor.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
+	"create-board": {
+		serviceClass: "Boards",
+		operationId: "createBoard",
+		description: "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`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/boards",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "Unique within the project — reusing another board's name is rejected as an invalid definition.\n",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "states",
+				"description": "",
+				"required": true,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "transitions",
+				"description": "",
+				"required": true,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "payload_schema",
+				"description": "Optional JSON Schema validated against every card's payload.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"get-board": {
+		serviceClass: "Boards",
+		operationId: "getBoard",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/boards",
+		httpMethod: "get",
+		pathParams: ["project_id", "board_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "board_id",
+			"description": "Board public ID (brd_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-board": {
+		serviceClass: "Boards",
+		operationId: "updateBoard",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/boards",
+		httpMethod: "patch",
+		pathParams: ["project_id", "board_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "board_id",
+				"description": "Board public ID (brd_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "states",
+				"description": "",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "transitions",
+				"description": "",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "payload_schema",
+				"description": "Send null to clear it.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"delete-board": {
+		serviceClass: "Boards",
+		operationId: "deleteBoard",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/boards",
+		httpMethod: "delete",
+		pathParams: ["project_id", "board_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "board_id",
+			"description": "Board public ID (brd_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-channels": {
 		serviceClass: "Channels",
 		operationId: "listChannels",
@@ -4665,6 +5030,270 @@ const routes = {
 			}
 		]
 	},
+	"list-tasks": {
+		serviceClass: "Tasks",
+		operationId: "listTasks",
+		description: "The board query. Filter by `board_id` for one board, add `state` for one column, or use `status` / `assignee` across boards.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/tasks",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"board_id",
+			"state",
+			"status",
+			"assignee",
+			"limit",
+			"cursor"
+		],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "board_id",
+				"description": "Only cards on this board. An unowned board is a 404, not an empty page.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "state",
+				"description": "Only cards currently in this column — one kanban column.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "status",
+				"description": "Only open or only closed cards.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "assignee",
+				"description": "Only cards labelled with this assignee.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "Opaque pagination cursor from a previous response's next_cursor.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
+	"create-task": {
+		serviceClass: "Tasks",
+		operationId: "createTask",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/tasks",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "board_id",
+				"description": "The board to put the card on.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "title",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "payload",
+				"description": "The card's starting data, validated against the board's `payload_schema`.\n",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "assignee",
+				"description": "Informational label.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"get-task": {
+		serviceClass: "Tasks",
+		operationId: "getTask",
+		description: "One card, including its automation status and in-flight dispatch.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/tasks",
+		httpMethod: "get",
+		pathParams: ["project_id", "task_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "task_id",
+			"description": "Task public ID (task_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-task": {
+		serviceClass: "Tasks",
+		operationId: "updateTask",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/tasks",
+		httpMethod: "patch",
+		pathParams: ["project_id", "task_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "task_id",
+				"description": "Task public ID (task_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "title",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "assignee",
+				"description": "Send null to unassign.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "payload",
+				"description": "Shallow-merged over the current payload; omitted keys are preserved.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"delete-task": {
+		serviceClass: "Tasks",
+		operationId: "deleteTask",
+		description: "Removes the card and its transition history. Distinct from closing it: a card that reaches a terminal column closes and keeps its audit trail.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/tasks",
+		httpMethod: "delete",
+		pathParams: ["project_id", "task_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "task_id",
+			"description": "Task public ID (task_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"transition-task": {
+		serviceClass: "Tasks",
+		operationId: "transitionTask",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/tasks",
+		httpMethod: "post",
+		pathParams: ["project_id", "task_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "task_id",
+				"description": "Task public ID (task_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "transition",
+				"description": "The name of a move the board declares from the card's current column.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "note",
+				"description": "Optional reason, recorded on the history entry.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"list-task-transitions": {
+		serviceClass: "Tasks",
+		operationId: "listTaskTransitions",
+		description: "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.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/tasks",
+		httpMethod: "get",
+		pathParams: ["project_id", "task_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "task_id",
+			"description": "Task public ID (task_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-tools": {
 		serviceClass: "Tools",
 		operationId: "listTools",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.34.1",
+  "version": "0.35.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/sdk": "0.34.1"
+    "@naturali/sdk": "0.35.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",