@naturali/sdk 0.154.0 → 0.155.0

package/dist/index.cjs

@@ -1984,6 +1984,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
@@ -4669,7 +4814,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({
@@ -5304,6 +5449,7 @@ var NaturaliClient = class {
 	channels;
 	auth;
 	conversations;
+	deciders;
 	documents;
 	embeddings;
 	evaluations;
@@ -5356,6 +5502,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);
@@ -5401,6 +5548,7 @@ exports.Auth = Auth;
 exports.Chains = Chains;
 exports.Channels = Channels;
 exports.Conversations = Conversations;
+exports.Deciders = Deciders;
 exports.Documents = Documents;
 exports.Embeddings = Embeddings;
 exports.Evaluations = Evaluations;