@naturali/sdk 0.154.0 → 0.155.0

package/dist/index.mjs

@@ -1983,6 +1983,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
@@ -4668,7 +4813,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({
@@ -5303,6 +5448,7 @@ var NaturaliClient = class {
 	channels;
 	auth;
 	conversations;
+	deciders;
 	documents;
 	embeddings;
 	evaluations;
@@ -5355,6 +5501,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);
@@ -5386,4 +5533,4 @@ var NaturaliClient = class {
 	}
 };
 //#endregion
-export { Activity, Actors, Admin, AgentVersions, Agents, AiProviders, ApiKeys, Approvals, Assistant, AuditLog, Auth, Chains, Channels, Conversations, Documents, Embeddings, Evaluations, Exceptions, Files, Formations, Generations, Guardrails, IngestionRules, Knowledge, Memories, MemoryRules, MemoryStores, MetadataSchemas, ModelRoutes, Models, NaturaliClient, Orchestrations, Projects, Quotas, Secrets, Sessions, Tasks, Tools, Traces, Triggers, Users, Webhooks, Workflows, createClient, createConfig };
+export { Activity, Actors, Admin, AgentVersions, Agents, AiProviders, ApiKeys, Approvals, Assistant, AuditLog, Auth, Chains, Channels, Conversations, Deciders, Documents, Embeddings, Evaluations, Exceptions, Files, Formations, Generations, Guardrails, IngestionRules, Knowledge, Memories, MemoryRules, MemoryStores, MetadataSchemas, ModelRoutes, Models, NaturaliClient, Orchestrations, Projects, Quotas, Secrets, Sessions, Tasks, Tools, Traces, Triggers, Users, Webhooks, Workflows, createClient, createConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.154.0",
+  "version": "0.155.0",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.99.0",
-    "@naturali/api": "0.154.0",
+    "@naturali/api": "0.155.0",
     "@ttoss/openapi-codegen": "^0.3.1",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",