@naturali/cli 0.154.0 → 0.156.0

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.154.0";
+var version = "0.156.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -1175,6 +1175,18 @@ var Admin = class {
 			...options
 		});
 	}
+	/**
+	* List a user's monthly statements
+	*
+	* The same statements the account reads at `GET /v1/users/me/statements`, for an operator to bill from. Needs the `admin` role.
+	*
+	*/
+	static listUserStatements(options) {
+		return (options.client ?? client).get({
+			url: "/v1/admin/users/{user_id}/statements",
+			...options
+		});
+	}
 };
 var Agents = class {
 	/**
@@ -2004,6 +2016,151 @@ var Conversations = class {
 		});
 	}
 };
+var Deciders = class {
+	/**
+	* List deciders
+	*
+	* Returns the deciders defined in a project, newest first.
+	*/
+	static listDeciders(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/deciders",
+			...options
+		});
+	}
+	/**
+	* Create a decider
+	*
+	* Creates a decider at version 1: a named question set and the backend that answers it, exactly one of `agent_id` and `tool_id`. Every question declares a finite answer space, validated here. The backend must be in the decider's project. An agent must carry no tool surface — no tool binding left active by `active_tool_ids` and no `knowledge_config.write_memory_store_id` — or the create is refused with `400 DECIDER_AGENT_NOT_TOOL_LESS`. A tool must be `http` or `pipeline` and must not pin `state` or `questions` in its `preset_parameters`, or the create is refused with `400 DECIDER_TOOL_NOT_CALLABLE`. A duplicate `name` in the project is `409 NAME_CONFLICT`.
+	*/
+	static createDecider(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/deciders",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a decider
+	*
+	* Deletes a decider and its version archive. Its decisions remain and keep naming the decider's ID.
+	*/
+	static deleteDecider(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/deciders/{decider_id}",
+			...options
+		});
+	}
+	/**
+	* Get a decider
+	*
+	* Returns a decider with its current question set and version.
+	*/
+	static getDecider(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/deciders/{decider_id}",
+			...options
+		});
+	}
+	/**
+	* Update a decider
+	*
+	* Updates any of `name`, `description`, the backend and `questions`. Naming `agent_id` or `tool_id` replaces the current backend; naming both is `400`. Only a change to `questions` archives a new version; a rename, a new backend or a rewrite of the questions the decider already holds leaves `version` where it is. A new backend is held to the same rules as on create.
+	*/
+	static updateDecider(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/deciders/{decider_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List a decider's versions
+	*
+	* Returns the decider's archived question sets, newest first. A version is written on create and on every write that changes `questions`.
+	*/
+	static listDeciderVersions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/deciders/{decider_id}/versions",
+			...options
+		});
+	}
+	/**
+	* Fetch an archived decider version
+	*
+	* Returns the question set a version held. A decision names the `decider_version` it was answered under, so this is how its criteria are read after the decider has changed.
+	*/
+	static getDeciderVersion(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/deciders/{decider_id}/versions/{version}",
+			...options
+		});
+	}
+	/**
+	* Restore an archived decider version
+	*
+	* Writes an archived question set back as the decider's live one, which archives it again as a new version rather than rewinding the counter. Restoring the question set the decider already holds is a no-op.
+	*/
+	static restoreDeciderVersion(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/deciders/{decider_id}/versions/{version}/restore",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Request a decision
+	*
+	* Evaluates the decider against `state` and records the decision. The questions come from the decider, never from the request, so a call site can only supply what is judged.
+	*
+	* Everything that can refuse the request is checked before the decision is written, so a refusal is a `4xx` and never a polled failure: the agent's tool surface (`400 DECIDER_AGENT_NOT_TOOL_LESS`), a tool that cannot answer (`400 DECIDER_TOOL_NOT_CALLABLE`), a paused project (`409 PROJECT_PAUSED`) and, for an agent, quota admission (`429 QUOTA_EXCEEDED`).
+	*
+	* A tool backend is called with `{ state, questions }` and must answer `{ answers: { <question id>: { choice | score | value, probabilities? } } }`; an answer outside that contract fails the decision with `DECISION_ANSWER_INVALID`.
+	*
+	* With `wait: false`, the default, the answer is `201` with the decision `queued`; poll `GET /v1/projects/{project_id}/decisions/{decision_id}` or subscribe to `decisions.completed` and `decisions.failed`. With `wait: true` it is `201` with the decision settled.
+	*/
+	static createDecision(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/deciders/{decider_id}/decisions",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List decisions
+	*
+	* Returns the decisions in a project, newest first.
+	*/
+	static listDecisions(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/decisions",
+			...options
+		});
+	}
+	/**
+	* Get a decision
+	*
+	* Returns a decision. Poll it after a `wait: false` request until `status` is `completed` or `failed`.
+	*/
+	static getDecision(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/decisions/{decision_id}",
+			...options
+		});
+	}
+};
 var Documents = class {
 	/**
 	* List documents
@@ -4689,7 +4846,7 @@ var Tools = class {
 	/**
 	* Delete a tool
 	*
-	* Deletes a tool by ID.
+	* Deletes a tool by ID. A tool that is a decider's backend is refused with `409 TOOL_HAS_DEPENDENTS`.
 	*/
 	static deleteTool(options) {
 		return (options.client ?? client).delete({
@@ -5030,6 +5187,32 @@ var Users = class {
 			...options
 		});
 	}
+	/**
+	* List the account's monthly statements
+	*
+	* What the account owes for each closed billing month, newest first: the subscription fee, prorated by the share of the month each plan was held, and runs past the allowance at the plan's overage rate. Overage is measured against the highest plan held that month.
+	*
+	* A statement is written within an hour of the month closing, once, and never changes. It is a record to bill from, not a charge and not a tax invoice. Months on the Free plan alone, contract plans and storage are not stated.
+	*
+	*/
+	static listCurrentUserStatements(options) {
+		return (options?.client ?? client).get({
+			url: "/v1/users/me/statements",
+			...options
+		});
+	}
+	/**
+	* Get a monthly statement
+	*
+	* One of this account's monthly statements, with its lines and total. Another account's statement answers `404`.
+	*
+	*/
+	static getCurrentUserStatement(options) {
+		return (options.client ?? client).get({
+			url: "/v1/users/me/statements/{statement_id}",
+			...options
+		});
+	}
 };
 var Webhooks = class {
 	/**
@@ -5324,6 +5507,7 @@ var NaturaliClient = class {
 	channels;
 	auth;
 	conversations;
+	deciders;
 	documents;
 	embeddings;
 	evaluations;
@@ -5376,6 +5560,7 @@ var NaturaliClient = class {
 		this.channels = bindResource(Channels, this.http);
 		this.auth = bindResource(Auth, this.http);
 		this.conversations = bindResource(Conversations, this.http);
+		this.deciders = bindResource(Deciders, this.http);
 		this.documents = bindResource(Documents, this.http);
 		this.embeddings = bindResource(Embeddings, this.http);
 		this.evaluations = bindResource(Evaluations, this.http);
@@ -5423,6 +5608,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Chains: () => Chains,
 	Channels: () => Channels,
 	Conversations: () => Conversations,
+	Deciders: () => Deciders,
 	Documents: () => Documents,
 	Embeddings: () => Embeddings,
 	Evaluations: () => Evaluations,
@@ -6935,6 +7121,40 @@ const routes = {
 		cookieParams: [],
 		flags: []
 	},
+	"list-user-statements": {
+		serviceClass: "Admin",
+		operationId: "listUserStatements",
+		description: "The same statements the account reads at `GET /v1/users/me/statements`, for an operator to bill from. Needs the `admin` role.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/admin",
+		httpMethod: "get",
+		pathParams: ["user_id"],
+		queryParams: ["limit", "cursor"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "user_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "The `next_cursor` of the previous page.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
 	"list-agents": {
 		serviceClass: "Agents",
 		operationId: "listAgents",
@@ -10355,22 +10575,14 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"list-documents": {
-		serviceClass: "Documents",
-		operationId: "listDocuments",
-		description: "Returns all documents in the project named in the path.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+	"list-deciders": {
+		serviceClass: "Deciders",
+		operationId: "listDeciders",
+		description: "Returns the deciders defined in a project, newest first.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/deciders",
 		httpMethod: "get",
 		pathParams: ["project_id"],
-		queryParams: [
-			"path_prefix",
-			"include_withdrawn",
-			"related_to",
-			"tags",
-			"metadata",
-			"limit",
-			"offset"
-		],
+		queryParams: ["limit", "offset"],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -10381,41 +10593,6 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
-			{
-				"name": "path_prefix",
-				"description": "Only documents filed under this directory. The prefix is a path boundary, not a substring: `/reports` returns `/reports/q1.txt` and never `/reports-archive/q1.txt`, and `/` selects the whole project. A leading slash is optional and a trailing one is ignored, so `reports`, `/reports` and `/reports/` are the same filter. `%` and `_` are literal characters, not wildcards.",
-				"required": false,
-				"type": "string",
-				"in": "query"
-			},
-			{
-				"name": "include_withdrawn",
-				"description": "Include withdrawn documents. A withdrawn document leaves every default read and is not in the knowledge index at all — its chunks are dropped when it is withdrawn — so this shows it in the listing but never in a search.",
-				"required": false,
-				"type": "boolean",
-				"in": "query"
-			},
-			{
-				"name": "related_to",
-				"description": "Only documents related to this one, on either side of the edge: what it points at, and what points at it. An id with no relations narrows the listing to nothing.",
-				"required": false,
-				"type": "string",
-				"in": "query"
-			},
-			{
-				"name": "tags",
-				"description": "Filter by tag pairs, written `key:value` (split on the first colon, so a value may contain colons). Repeat the parameter for several pairs; **all** must be present with exactly that value.\n",
-				"required": false,
-				"type": "array",
-				"in": "query"
-			},
-			{
-				"name": "metadata",
-				"description": "A `MetadataFilter` as JSON, url-encoded. It travels as JSON rather than as `key:value` pairs because the match is exact and a query string cannot otherwise say whether `3` is the number or the string.",
-				"required": false,
-				"type": "string",
-				"in": "query"
-			},
 			{
 				"name": "limit",
 				"description": "Maximum number of results to return",
@@ -10432,11 +10609,11 @@ const routes = {
 			}
 		]
 	},
-	"create-document": {
-		serviceClass: "Documents",
-		operationId: "createDocument",
-		description: "Creates a new text document and generates an embedding vector for semantic search, in the project named in the path.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+	"create-decider": {
+		serviceClass: "Deciders",
+		operationId: "createDecider",
+		description: "Creates a decider at version 1: a named question set and the backend that answers it, exactly one of `agent_id` and `tool_id`. Every question declares a finite answer space, validated here. The backend must be in the decider's project. An agent must carry no tool surface — no tool binding left active by `active_tool_ids` and no `knowledge_config.write_memory_store_id` — or the create is refused with `400 DECIDER_AGENT_NOT_TOOL_LESS`. A tool must be `http` or `pipeline` and must not pin `state` or `questions` in its `preset_parameters`, or the create is refused with `400 DECIDER_TOOL_NOT_CALLABLE`. A duplicate `name` in the project is `409 NAME_CONFLICT`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/deciders",
 		httpMethod: "post",
 		pathParams: ["project_id"],
 		queryParams: [],
@@ -10451,76 +10628,595 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "content",
-				"description": "",
+				"name": "name",
+				"description": "Human-readable name, unique per project",
 				"required": true,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "path",
-				"description": "Logical path within the project (e.g. /reports/q1.txt). Defaults to `/<filename>`, or to `/<document_id>.txt` when neither is given — a document with no path is reachable only by its id, since a prefix filter never matches null.",
-				"required": false,
-				"type": "string",
-				"in": "body"
-			},
-			{
-				"name": "filename",
+				"name": "description",
 				"description": "",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "title",
-				"description": "Document title",
+				"name": "agent_id",
+				"description": "A tool-less agent that answers",
 				"required": false,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "metadata",
-				"description": "Arbitrary metadata object. Unlike other body fields, keys are stored and returned verbatim in the casing supplied — they are not converted between snake_case and camelCase.",
+				"name": "tool_id",
+				"description": "An http or pipeline tool that answers",
 				"required": false,
-				"type": "object",
+				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "tags",
-				"description": "Key-value labels on a resource. A flat object of string values — an array, a nested object or a number is rejected with `400 VALIDATION_FAILED`, never coerced. Keys are opaque and stored verbatim, so `cost_center` and `costCenter` are two different tags. Matched by JSONB containment wherever tags are read: the `?tags=` filter and knowledge search.\n\nKeys beginning `system.` are reserved: the platform writes them to record which conversation, actor, agent and role a row came from, and a write naming one is refused with `400 RESERVED_TAG_KEY`. They are read and filtered like any other tag.\n\nThe bag is bounded, because every pair reaches the IAM context of every access check on the resource: at most 50 keys, each key at most 128 characters and each value at most 256. A write past a bound — including a merge that would grow the stored bag past the key count — is `400 VALIDATION_FAILED` with `meta.limit` naming the bound it crossed. `system.*` keys are the platform's and do not count against the 50.",
-				"required": false,
+				"name": "questions",
+				"description": "Question id → question, 1 to 20 of them. A question id starts with a letter or underscore and holds only letters, digits and underscores (at most 64), since it keys the answer object.",
+				"required": true,
 				"type": "object",
 				"in": "body"
 			},
 			{
-				"name": "chunk_strategy",
-				"description": "How to split the content into embeddable chunks. `whole` (default) stores the content as a single chunk; `size` splits into fixed-size character windows with overlap. `page` is equivalent to `whole` for plain text.",
+				"name": "version_label",
+				"description": "Optional tag for version 1, e.g. `initial`",
 				"required": false,
 				"type": "string",
 				"in": "body"
-			},
-			{
-				"name": "chunk_size",
-				"description": "Window size in characters when `chunk_strategy=size`. Defaults to 1000.",
-				"required": false,
-				"type": "integer",
-				"in": "body"
-			},
-			{
-				"name": "chunk_overlap",
-				"description": "Overlap in characters between consecutive windows when `chunk_strategy=size`. Defaults to 200.",
-				"required": false,
-				"type": "integer",
-				"in": "body"
 			}
 		]
 	},
-	"ingest-document": {
-		serviceClass: "Documents",
-		operationId: "ingestDocument",
-		description: "Parses an already-uploaded file and creates one Document split into one or more embedded chunks. The source format is detected from the file's content type: PDFs are parsed page-by-page; `text/plain` and `text/markdown` files are read as a single source. How the source is chunked is controlled by `chunk_strategy`. A file can only back one Document — a second call with the same `file_id` returns `409 FILE_ALREADY_INGESTED`. To re-process an already-ingested file (e.g. with a different `chunk_strategy`), use `POST /documents/{document_id}/ingest`; to ingest the same source under a different path, upload a new copy of the file first.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
-		httpMethod: "post",
+	"get-decider": {
+		serviceClass: "Deciders",
+		operationId: "getDecider",
+		description: "Returns a decider with its current question set and version.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/deciders",
+		httpMethod: "get",
+		pathParams: ["project_id", "decider_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "decider_id",
+			"description": "The decider ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-decider": {
+		serviceClass: "Deciders",
+		operationId: "updateDecider",
+		description: "Updates any of `name`, `description`, the backend and `questions`. Naming `agent_id` or `tool_id` replaces the current backend; naming both is `400`. Only a change to `questions` archives a new version; a rename, a new backend or a rewrite of the questions the decider already holds leaves `version` where it is. A new backend is held to the same rules as on create.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/deciders",
+		httpMethod: "patch",
+		pathParams: ["project_id", "decider_id"],
+		queryParams: [],
+		headerParams: ["If-Match"],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "decider_id",
+				"description": "The decider ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "If-Match",
+				"description": "The version the caller believes the resource holds, as an entity tag (`3` or `\"3\"`). Equivalent to `expected_version` in the request body; `*` states no precondition beyond the resource existing. A mismatch is `409 VERSION_CONFLICT`.",
+				"required": false,
+				"type": "string",
+				"in": "header"
+			},
+			{
+				"name": "name",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "agent_id",
+				"description": "Replaces the backend with this agent",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "tool_id",
+				"description": "Replaces the backend with this tool",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "questions",
+				"description": "Question id → question, 1 to 20 of them. A question id starts with a letter or underscore and holds only letters, digits and underscores (at most 64), since it keys the answer object.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "version_label",
+				"description": "Optional tag for the version this write archives. Ignored when the write changes no question, since no version is archived.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "expected_version",
+				"description": "Refuses the write unless the decider is at this version.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			}
+		]
+	},
+	"delete-decider": {
+		serviceClass: "Deciders",
+		operationId: "deleteDecider",
+		description: "Deletes a decider and its version archive. Its decisions remain and keep naming the decider's ID.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/deciders",
+		httpMethod: "delete",
+		pathParams: ["project_id", "decider_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "decider_id",
+			"description": "The decider ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"list-decider-versions": {
+		serviceClass: "Deciders",
+		operationId: "listDeciderVersions",
+		description: "Returns the decider's archived question sets, newest first. A version is written on create and on every write that changes `questions`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/deciders",
+		httpMethod: "get",
+		pathParams: ["project_id", "decider_id"],
+		queryParams: ["limit", "offset"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "decider_id",
+				"description": "The decider ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum number of results to return",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Number of results to skip",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"get-decider-version": {
+		serviceClass: "Deciders",
+		operationId: "getDeciderVersion",
+		description: "Returns the question set a version held. A decision names the `decider_version` it was answered under, so this is how its criteria are read after the decider has changed.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/deciders",
+		httpMethod: "get",
+		pathParams: [
+			"project_id",
+			"decider_id",
+			"version"
+		],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "decider_id",
+				"description": "The decider ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "version",
+				"description": "The archived version number",
+				"required": true,
+				"type": "integer",
+				"in": "path"
+			}
+		]
+	},
+	"restore-decider-version": {
+		serviceClass: "Deciders",
+		operationId: "restoreDeciderVersion",
+		description: "Writes an archived question set back as the decider's live one, which archives it again as a new version rather than rewinding the counter. Restoring the question set the decider already holds is a no-op.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/deciders",
+		httpMethod: "post",
+		pathParams: [
+			"project_id",
+			"decider_id",
+			"version"
+		],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "decider_id",
+				"description": "The decider ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "version",
+				"description": "The archived version number",
+				"required": true,
+				"type": "integer",
+				"in": "path"
+			},
+			{
+				"name": "label",
+				"description": "Optional tag for the new version. Defaults to `restored from vN`.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"create-decision": {
+		serviceClass: "Deciders",
+		operationId: "createDecision",
+		description: "Evaluates the decider against `state` and records the decision. The questions come from the decider, never from the request, so a call site can only supply what is judged. Everything that can refuse the request is checked before the decision is written, so a refusal is a `4xx` and never a polled failure: the agent's tool surface (`400 DECIDER_AGENT_NOT_TOOL_LESS`), a tool that cannot answer (`400 DECIDER_TOOL_NOT_CALLABLE`), a paused project (`409 PROJECT_PAUSED`) and, for an agent, quota admission (`429 QUOTA_EXCEEDED`). A tool backend is called with `{ state, questions }` and must answer `{ answers: { <question id>: { choice | score | value, probabilities? } } }`; an answer outside that contract fails the decision with `DECISION_ANSWER_INVALID`. With `wait: false`, the default, the answer is `201` with the decision `queued`; poll `GET /v1/projects/{project_id}/decisions/{decision_id}` or subscribe to `decisions.completed` and `decisions.failed`. With `wait: true` it is `201` with the decision settled.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/deciders",
+		httpMethod: "post",
+		pathParams: ["project_id", "decider_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "decider_id",
+				"description": "The decider ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "state",
+				"description": "What is judged: any JSON value. A string reaches the agent verbatim; anything else is serialized as JSON. Not stored.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "Caller-owned annotations stored on the decision and returned on every read — typically the id of what was judged, since the state itself is not stored. Written once, with the decision. A non-object is rejected with `400 VALIDATION_FAILED` and no decision is written.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "wait",
+				"description": "True evaluates before answering and returns the settled decision. False — the default — returns the `queued` decision at once.",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			}
+		]
+	},
+	"list-decisions": {
+		serviceClass: "Deciders",
+		operationId: "listDecisions",
+		description: "Returns the decisions in a project, newest first.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/deciders",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"decider_id",
+			"status",
+			"limit",
+			"offset"
+		],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "decider_id",
+				"description": "Only decisions requested from this decider",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "status",
+				"description": "Only decisions in this status",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum number of results to return",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Number of results to skip",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"get-decision": {
+		serviceClass: "Deciders",
+		operationId: "getDecision",
+		description: "Returns a decision. Poll it after a `wait: false` request until `status` is `completed` or `failed`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/deciders",
+		httpMethod: "get",
+		pathParams: ["project_id", "decision_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "decision_id",
+			"description": "The decision ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"list-documents": {
+		serviceClass: "Documents",
+		operationId: "listDocuments",
+		description: "Returns all documents in the project named in the path.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: [
+			"path_prefix",
+			"include_withdrawn",
+			"related_to",
+			"tags",
+			"metadata",
+			"limit",
+			"offset"
+		],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "path_prefix",
+				"description": "Only documents filed under this directory. The prefix is a path boundary, not a substring: `/reports` returns `/reports/q1.txt` and never `/reports-archive/q1.txt`, and `/` selects the whole project. A leading slash is optional and a trailing one is ignored, so `reports`, `/reports` and `/reports/` are the same filter. `%` and `_` are literal characters, not wildcards.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "include_withdrawn",
+				"description": "Include withdrawn documents. A withdrawn document leaves every default read and is not in the knowledge index at all — its chunks are dropped when it is withdrawn — so this shows it in the listing but never in a search.",
+				"required": false,
+				"type": "boolean",
+				"in": "query"
+			},
+			{
+				"name": "related_to",
+				"description": "Only documents related to this one, on either side of the edge: what it points at, and what points at it. An id with no relations narrows the listing to nothing.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "tags",
+				"description": "Filter by tag pairs, written `key:value` (split on the first colon, so a value may contain colons). Repeat the parameter for several pairs; **all** must be present with exactly that value.\n",
+				"required": false,
+				"type": "array",
+				"in": "query"
+			},
+			{
+				"name": "metadata",
+				"description": "A `MetadataFilter` as JSON, url-encoded. It travels as JSON rather than as `key:value` pairs because the match is exact and a query string cannot otherwise say whether `3` is the number or the string.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum number of results to return",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Number of results to skip",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"create-document": {
+		serviceClass: "Documents",
+		operationId: "createDocument",
+		description: "Creates a new text document and generates an embedding vector for semantic search, in the project named in the path.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "content",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "path",
+				"description": "Logical path within the project (e.g. /reports/q1.txt). Defaults to `/<filename>`, or to `/<document_id>.txt` when neither is given — a document with no path is reachable only by its id, since a prefix filter never matches null.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "filename",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "title",
+				"description": "Document title",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "Arbitrary metadata object. Unlike other body fields, keys are stored and returned verbatim in the casing supplied — they are not converted between snake_case and camelCase.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "tags",
+				"description": "Key-value labels on a resource. A flat object of string values — an array, a nested object or a number is rejected with `400 VALIDATION_FAILED`, never coerced. Keys are opaque and stored verbatim, so `cost_center` and `costCenter` are two different tags. Matched by JSONB containment wherever tags are read: the `?tags=` filter and knowledge search.\n\nKeys beginning `system.` are reserved: the platform writes them to record which conversation, actor, agent and role a row came from, and a write naming one is refused with `400 RESERVED_TAG_KEY`. They are read and filtered like any other tag.\n\nThe bag is bounded, because every pair reaches the IAM context of every access check on the resource: at most 50 keys, each key at most 128 characters and each value at most 256. A write past a bound — including a merge that would grow the stored bag past the key count — is `400 VALIDATION_FAILED` with `meta.limit` naming the bound it crossed. `system.*` keys are the platform's and do not count against the 50.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "chunk_strategy",
+				"description": "How to split the content into embeddable chunks. `whole` (default) stores the content as a single chunk; `size` splits into fixed-size character windows with overlap. `page` is equivalent to `whole` for plain text.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "chunk_size",
+				"description": "Window size in characters when `chunk_strategy=size`. Defaults to 1000.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "chunk_overlap",
+				"description": "Overlap in characters between consecutive windows when `chunk_strategy=size`. Defaults to 200.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			}
+		]
+	},
+	"ingest-document": {
+		serviceClass: "Documents",
+		operationId: "ingestDocument",
+		description: "Parses an already-uploaded file and creates one Document split into one or more embedded chunks. The source format is detected from the file's content type: PDFs are parsed page-by-page; `text/plain` and `text/markdown` files are read as a single source. How the source is chunked is controlled by `chunk_strategy`. A file can only back one Document — a second call with the same `file_id` returns `409 FILE_ALREADY_INGESTED`. To re-process an already-ingested file (e.g. with a different `chunk_strategy`), use `POST /documents/{document_id}/ingest`; to ingest the same source under a different path, upload a new copy of the file first.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
+		httpMethod: "post",
 		pathParams: ["project_id"],
 		queryParams: ["wait"],
 		headerParams: [],
@@ -18516,7 +19212,7 @@ const routes = {
 	"delete-tool": {
 		serviceClass: "Tools",
 		operationId: "deleteTool",
-		description: "Deletes a tool by ID.",
+		description: "Deletes a tool by ID. A tool that is a decider's backend is refused with `409 TOOL_HAS_DEPENDENTS`.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/tools",
 		httpMethod: "delete",
 		pathParams: ["project_id", "tool_id"],
@@ -19288,6 +19984,48 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"list-current-user-statements": {
+		serviceClass: "Users",
+		operationId: "listCurrentUserStatements",
+		description: "What the account owes for each closed billing month, newest first: the subscription fee, prorated by the share of the month each plan was held, and runs past the allowance at the plan's overage rate. Overage is measured against the highest plan held that month. A statement is written within an hour of the month closing, once, and never changes. It is a record to bill from, not a charge and not a tax invoice. Months on the Free plan alone, contract plans and storage are not stated.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/users",
+		httpMethod: "get",
+		pathParams: [],
+		queryParams: ["limit", "cursor"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "limit",
+			"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
+			"required": false,
+			"type": "integer",
+			"in": "query"
+		}, {
+			"name": "cursor",
+			"description": "The `next_cursor` of the previous page.",
+			"required": false,
+			"type": "string",
+			"in": "query"
+		}]
+	},
+	"get-current-user-statement": {
+		serviceClass: "Users",
+		operationId: "getCurrentUserStatement",
+		description: "One of this account's monthly statements, with its lines and total. Another account's statement answers `404`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/users",
+		httpMethod: "get",
+		pathParams: ["statement_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "statement_id",
+			"description": "The statement's ID (stm_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-webhooks": {
 		serviceClass: "Webhooks",
 		operationId: "listWebhooks",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.154.0",
+  "version": "0.156.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "yaml": "^2.9.1"
   },
   "devDependencies": {
-    "@naturali/sdk": "0.154.0",
+    "@naturali/sdk": "0.156.0",
     "@ttoss/openapi-codegen": "^0.3.1",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",