@naturali/cli 0.153.0 → 0.155.0

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.153.0";
+var version = "0.155.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -2004,6 +2004,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 +4834,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({
@@ -4990,6 +5135,46 @@ var Users = class {
 			...options
 		});
 	}
+	/**
+	* List what a billing ceiling stopped
+	*
+	* Schedule triggers, eval runs, orchestration runs and workflow tasks the platform stopped on this account's projects because the credit balance went below zero or a Free plan's runs ran out, and that have not been restored or dismissed yet. Newest first.
+	*
+	* `blocked_by` names the ceiling still closed: while it is set, nothing can be restored. Top up for `debt`; upgrade or wait for the month to turn for `run_allowance`. A project-confined key sees its own project's stops only.
+	*
+	*/
+	static listCurrentUserStops(options) {
+		return (options?.client ?? client).get({
+			url: "/v1/users/me/stops",
+			...options
+		});
+	}
+	/**
+	* Restore a stopped item
+	*
+	* Turns one stopped item back on — re-enables the schedule trigger, or resumes the orchestration run or workflow task — and stops listing it. An item that is no longer stopped (resumed already, finished or deleted) is marked restored too.
+	*
+	* Refused with `409 stop_ceiling_closed` while a ceiling is still closed, naming it in `details.blocked_by`, and with `409 stop_not_restorable` for a cancelled eval run, which can only be dismissed.
+	*
+	*/
+	static restoreCurrentUserStop(options) {
+		return (options.client ?? client).post({
+			url: "/v1/users/me/stops/{stop_id}/restore",
+			...options
+		});
+	}
+	/**
+	* Dismiss a stopped item
+	*
+	* Stops listing an item without turning it back on. Allowed while a ceiling is still closed.
+	*
+	*/
+	static dismissCurrentUserStop(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/users/me/stops/{stop_id}",
+			...options
+		});
+	}
 };
 var Webhooks = class {
 	/**
@@ -5284,6 +5469,7 @@ var NaturaliClient = class {
 	channels;
 	auth;
 	conversations;
+	deciders;
 	documents;
 	embeddings;
 	evaluations;
@@ -5336,6 +5522,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);
@@ -5383,6 +5570,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Chains: () => Chains,
 	Channels: () => Channels,
 	Conversations: () => Conversations,
+	Deciders: () => Deciders,
 	Documents: () => Documents,
 	Embeddings: () => Embeddings,
 	Evaluations: () => Evaluations,
@@ -10016,13 +10204,515 @@ const routes = {
 			}
 		]
 	},
-	"delete-conversation": {
-		serviceClass: "Conversations",
-		operationId: "deleteConversation",
-		description: "Deletes a conversation by its ID",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+	"delete-conversation": {
+		serviceClass: "Conversations",
+		operationId: "deleteConversation",
+		description: "Deletes a conversation by its ID",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+		httpMethod: "delete",
+		pathParams: ["project_id", "conversation_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "conversation_id",
+			"description": "Conversation ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"list-conversation-messages": {
+		serviceClass: "Conversations",
+		operationId: "listConversationMessages",
+		description: "Returns all messages (documents) attached to a conversation, ordered by position",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+		httpMethod: "get",
+		pathParams: ["project_id", "conversation_id"],
+		queryParams: ["limit", "offset"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "conversation_id",
+				"description": "Conversation 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"
+			}
+		]
+	},
+	"add-conversation-message": {
+		serviceClass: "Conversations",
+		operationId: "addConversationMessage",
+		description: "Creates a document from the message text and attaches it to the conversation at the given position. If position is omitted, it is appended at the end.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+		httpMethod: "post",
+		pathParams: ["project_id", "conversation_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "conversation_id",
+				"description": "Conversation ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "message",
+				"description": "Message text content to add to the conversation",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "role",
+				"description": "Role of the message sender",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "actor_id",
+				"description": "Optional actor ID to associate with this message (user identity)",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "position",
+				"description": "Zero-based position. Defaults to MAX+1 (append).",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "metadata",
+				"description": "Caller-owned annotations on the message (e.g. a phone number, a channel), stored as sent and returned verbatim. The platform does not read the bag, so nothing in it reaches the model: a value the model should see belongs in `message`.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"generate-conversation-message": {
+		serviceClass: "Conversations",
+		operationId: "generateConversationMessage",
+		description: "Generates the next message using the specified actor's linked agent or chat. Background by default: returns `202 Accepted` immediately and the reply lands as a new ConversationMessage when it completes — poll `GET /v1/projects/{project_id}/conversations/{conversation_id}/messages` for it. Pass `?wait=true` to block and receive the result inline. On `completed`, the reply is persisted as a new ConversationMessage authored by that actor. On `requires_action`, nothing is persisted; the caller must submit tool outputs via the Agents module and re-invoke generate — so a flow using client tools should pass `?wait=true`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+		httpMethod: "post",
+		pathParams: ["project_id", "conversation_id"],
+		queryParams: ["wait"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "conversation_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "wait",
+				"description": "When omitted or `false` (default), the generation runs in the background and `202 Accepted` is returned immediately. Pass `true` to block until the generation settles and receive the result.",
+				"required": false,
+				"type": "boolean",
+				"in": "query"
+			},
+			{
+				"name": "agent_id",
+				"description": "ID of the agent that will produce the next message.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "model",
+				"description": "Optional model override.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "stream",
+				"description": "If true, stream tokens via SSE. NOT IMPLEMENTED in v1 — returns 501.",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			},
+			{
+				"name": "tool_context",
+				"description": "Key-value pairs forwarded as `X-Naturali-Context-<key>` headers on every `http` and `mcp` tool call in this generation. The header name is the deployment's configured context prefix (`X-Naturali-Context-` by default) plus the key verbatim — no character is re-cased and keys are never case-converted, so they round-trip exactly as sent. An invalid or colliding key is rejected with `400 INVALID_TOOL_CONTEXT_KEY`.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"remove-conversation-message": {
+		serviceClass: "Conversations",
+		operationId: "removeConversationMessage",
+		description: "Removes a document from a conversation",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+		httpMethod: "delete",
+		pathParams: [
+			"project_id",
+			"conversation_id",
+			"document_id"
+		],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "conversation_id",
+				"description": "Conversation ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "document_id",
+				"description": "Document ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			}
+		]
+	},
+	"get-conversation-tags": {
+		serviceClass: "Conversations",
+		operationId: "getConversationTags",
+		description: "Returns all tags attached to the conversation",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+		httpMethod: "get",
+		pathParams: ["project_id", "conversation_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "conversation_id",
+			"description": "Conversation ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"replace-conversation-tags": {
+		serviceClass: "Conversations",
+		operationId: "replaceConversationTags",
+		description: "Replaces all tags on the conversation with the provided tags",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+		httpMethod: "put",
+		pathParams: ["project_id", "conversation_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "conversation_id",
+			"description": "Conversation ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"merge-conversation-tags": {
+		serviceClass: "Conversations",
+		operationId: "mergeConversationTags",
+		description: "Merges provided tags into the conversation's existing tags (existing tags are preserved unless overridden)",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+		httpMethod: "patch",
+		pathParams: ["project_id", "conversation_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "conversation_id",
+			"description": "Conversation ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"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: ["limit", "offset"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"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"
+			}
+		]
+	},
+	"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: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "Human-readable name, unique per project",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "agent_id",
+				"description": "A tool-less agent that answers",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "tool_id",
+				"description": "An http or pipeline tool that answers",
+				"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": true,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "version_label",
+				"description": "Optional tag for version 1, e.g. `initial`",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"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", "conversation_id"],
+		pathParams: ["project_id", "decider_id"],
 		queryParams: [],
 		headerParams: [],
 		cookieParams: [],
@@ -10033,20 +10723,20 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "conversation_id",
-			"description": "Conversation ID",
+			"name": "decider_id",
+			"description": "The decider ID",
 			"required": true,
 			"type": "string",
 			"in": "path"
 		}]
 	},
-	"list-conversation-messages": {
-		serviceClass: "Conversations",
-		operationId: "listConversationMessages",
-		description: "Returns all messages (documents) attached to a conversation, ordered by position",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+	"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", "conversation_id"],
+		pathParams: ["project_id", "decider_id"],
 		queryParams: ["limit", "offset"],
 		headerParams: [],
 		cookieParams: [],
@@ -10059,8 +10749,8 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "conversation_id",
-				"description": "Conversation ID",
+				"name": "decider_id",
+				"description": "The decider ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
@@ -10081,13 +10771,17 @@ const routes = {
 			}
 		]
 	},
-	"add-conversation-message": {
-		serviceClass: "Conversations",
-		operationId: "addConversationMessage",
-		description: "Creates a document from the message text and attaches it to the conversation at the given position. If position is omitted, it is appended at the end.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
-		httpMethod: "post",
-		pathParams: ["project_id", "conversation_id"],
+	"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: [],
@@ -10100,57 +10794,74 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "conversation_id",
-				"description": "Conversation ID",
+				"name": "decider_id",
+				"description": "The decider ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "message",
-				"description": "Message text content to add to the conversation",
+				"name": "version",
+				"description": "The archived version number",
 				"required": true,
-				"type": "string",
-				"in": "body"
-			},
+				"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": "role",
-				"description": "Role of the message sender",
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
 				"required": true,
 				"type": "string",
-				"in": "body"
+				"in": "path"
 			},
 			{
-				"name": "actor_id",
-				"description": "Optional actor ID to associate with this message (user identity)",
-				"required": false,
+				"name": "decider_id",
+				"description": "The decider ID",
+				"required": true,
 				"type": "string",
-				"in": "body"
+				"in": "path"
 			},
 			{
-				"name": "position",
-				"description": "Zero-based position. Defaults to MAX+1 (append).",
-				"required": false,
+				"name": "version",
+				"description": "The archived version number",
+				"required": true,
 				"type": "integer",
-				"in": "body"
+				"in": "path"
 			},
 			{
-				"name": "metadata",
-				"description": "Caller-owned annotations on the message (e.g. a phone number, a channel), stored as sent and returned verbatim. The platform does not read the bag, so nothing in it reaches the model: a value the model should see belongs in `message`.",
+				"name": "label",
+				"description": "Optional tag for the new version. Defaults to `restored from vN`.",
 				"required": false,
-				"type": "object",
+				"type": "string",
 				"in": "body"
 			}
 		]
 	},
-	"generate-conversation-message": {
-		serviceClass: "Conversations",
-		operationId: "generateConversationMessage",
-		description: "Generates the next message using the specified actor's linked agent or chat. Background by default: returns `202 Accepted` immediately and the reply lands as a new ConversationMessage when it completes — poll `GET /v1/projects/{project_id}/conversations/{conversation_id}/messages` for it. Pass `?wait=true` to block and receive the result inline. On `completed`, the reply is persisted as a new ConversationMessage authored by that actor. On `requires_action`, nothing is persisted; the caller must submit tool outputs via the Agents module and re-invoke generate — so a flow using client tools should pass `?wait=true`.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+	"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", "conversation_id"],
-		queryParams: ["wait"],
+		pathParams: ["project_id", "decider_id"],
+		queryParams: [],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -10162,61 +10873,48 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "conversation_id",
-				"description": "",
+				"name": "decider_id",
+				"description": "The decider ID",
 				"required": true,
 				"type": "string",
 				"in": "path"
 			},
 			{
-				"name": "wait",
-				"description": "When omitted or `false` (default), the generation runs in the background and `202 Accepted` is returned immediately. Pass `true` to block until the generation settles and receive the result.",
-				"required": false,
-				"type": "boolean",
-				"in": "query"
-			},
-			{
-				"name": "agent_id",
-				"description": "ID of the agent that will produce the next message.",
+				"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": "model",
-				"description": "Optional model override.",
+				"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": "string",
+				"type": "object",
 				"in": "body"
 			},
 			{
-				"name": "stream",
-				"description": "If true, stream tokens via SSE. NOT IMPLEMENTED in v1 — returns 501.",
+				"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"
-			},
-			{
-				"name": "tool_context",
-				"description": "Key-value pairs forwarded as `X-Naturali-Context-<key>` headers on every `http` and `mcp` tool call in this generation. The header name is the deployment's configured context prefix (`X-Naturali-Context-` by default) plus the key verbatim — no character is re-cased and keys are never case-converted, so they round-trip exactly as sent. An invalid or colliding key is rejected with `400 INVALID_TOOL_CONTEXT_KEY`.",
-				"required": false,
-				"type": "object",
-				"in": "body"
 			}
 		]
 	},
-	"remove-conversation-message": {
-		serviceClass: "Conversations",
-		operationId: "removeConversationMessage",
-		description: "Removes a document from a conversation",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
-		httpMethod: "delete",
-		pathParams: [
-			"project_id",
-			"conversation_id",
-			"document_id"
+	"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"
 		],
-		queryParams: [],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -10228,76 +10926,42 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "conversation_id",
-				"description": "Conversation ID",
-				"required": true,
+				"name": "decider_id",
+				"description": "Only decisions requested from this decider",
+				"required": false,
 				"type": "string",
-				"in": "path"
+				"in": "query"
 			},
 			{
-				"name": "document_id",
-				"description": "Document ID",
-				"required": true,
+				"name": "status",
+				"description": "Only decisions in this status",
+				"required": false,
 				"type": "string",
-				"in": "path"
+				"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-conversation-tags": {
-		serviceClass: "Conversations",
-		operationId: "getConversationTags",
-		description: "Returns all tags attached to the conversation",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
+	"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", "conversation_id"],
-		queryParams: [],
-		headerParams: [],
-		cookieParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "conversation_id",
-			"description": "Conversation ID",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
-	},
-	"replace-conversation-tags": {
-		serviceClass: "Conversations",
-		operationId: "replaceConversationTags",
-		description: "Replaces all tags on the conversation with the provided tags",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
-		httpMethod: "put",
-		pathParams: ["project_id", "conversation_id"],
-		queryParams: [],
-		headerParams: [],
-		cookieParams: [],
-		flags: [{
-			"name": "project_id",
-			"description": "Project public ID (proj_ prefix).",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "conversation_id",
-			"description": "Conversation ID",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
-	},
-	"merge-conversation-tags": {
-		serviceClass: "Conversations",
-		operationId: "mergeConversationTags",
-		description: "Merges provided tags into the conversation's existing tags (existing tags are preserved unless overridden)",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
-		httpMethod: "patch",
-		pathParams: ["project_id", "conversation_id"],
+		pathParams: ["project_id", "decision_id"],
 		queryParams: [],
 		headerParams: [],
 		cookieParams: [],
@@ -10308,8 +10972,8 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "conversation_id",
-			"description": "Conversation ID",
+			"name": "decision_id",
+			"description": "The decision ID",
 			"required": true,
 			"type": "string",
 			"in": "path"
@@ -18476,7 +19140,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"],
@@ -19188,6 +19852,66 @@ const routes = {
 		cookieParams: [],
 		flags: []
 	},
+	"list-current-user-stops": {
+		serviceClass: "Users",
+		operationId: "listCurrentUserStops",
+		description: "Schedule triggers, eval runs, orchestration runs and workflow tasks the platform stopped on this account's projects because the credit balance went below zero or a Free plan's runs ran out, and that have not been restored or dismissed yet. Newest first. `blocked_by` names the ceiling still closed: while it is set, nothing can be restored. Top up for `debt`; upgrade or wait for the month to turn for `run_allowance`. A project-confined key sees its own project's stops only.",
+		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"
+		}]
+	},
+	"restore-current-user-stop": {
+		serviceClass: "Users",
+		operationId: "restoreCurrentUserStop",
+		description: "Turns one stopped item back on — re-enables the schedule trigger, or resumes the orchestration run or workflow task — and stops listing it. An item that is no longer stopped (resumed already, finished or deleted) is marked restored too. Refused with `409 stop_ceiling_closed` while a ceiling is still closed, naming it in `details.blocked_by`, and with `409 stop_not_restorable` for a cancelled eval run, which can only be dismissed.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/users",
+		httpMethod: "post",
+		pathParams: ["stop_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "stop_id",
+			"description": "The stop's ID (sst_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"dismiss-current-user-stop": {
+		serviceClass: "Users",
+		operationId: "dismissCurrentUserStop",
+		description: "Stops listing an item without turning it back on. Allowed while a ceiling is still closed.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/users",
+		httpMethod: "delete",
+		pathParams: ["stop_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "stop_id",
+			"description": "The stop's ID (sst_ 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.153.0",
+  "version": "0.155.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.153.0",
+    "@naturali/sdk": "0.155.0",
     "@ttoss/openapi-codegen": "^0.3.1",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",