@naturali/cli 0.154.0 → 0.155.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.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({
@@ -5324,6 +5469,7 @@ var NaturaliClient = class {
 	channels;
 	auth;
 	conversations;
+	deciders;
 	documents;
 	embeddings;
 	evaluations;
@@ -5376,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);
@@ -5423,6 +5570,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Chains: () => Chains,
 	Channels: () => Channels,
 	Conversations: () => Conversations,
+	Deciders: () => Deciders,
 	Documents: () => Documents,
 	Embeddings: () => Embeddings,
 	Evaluations: () => Evaluations,
@@ -10355,6 +10503,482 @@ const routes = {
 			"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", "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",
@@ -18516,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"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.154.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.154.0",
+    "@naturali/sdk": "0.155.0",
     "@ttoss/openapi-codegen": "^0.3.1",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",