@soat/sdk 0.61.1 → 0.63.0

package/dist/index.cjs

@@ -1510,6 +1510,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: "/api/v1/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: "/api/v1/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: "/api/v1/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: "/api/v1/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: "/api/v1/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: "/api/v1/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: "/api/v1/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: "/api/v1/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 /api/v1/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: "/api/v1/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: "/api/v1/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: "/api/v1/decisions/{decision_id}",
+			...options
+		});
+	}
+};
 var Documents = class {
 	/**
 	* List documents
@@ -3620,6 +3765,34 @@ var Projects = class {
 		});
 	}
 	/**
+	* Pause a project
+	*
+	* Stops everything the project runs, with one call. From the moment it answers, nothing new starts in the project: agent, session and conversation generations, tool-output continuations, chat completions, direct tool calls, orchestration runs, eval runs and trigger firings are refused with `409 PROJECT_PAUSED`, and so is resuming a single run or task the pause holds.
+	* What is already in motion is parked rather than discarded: every live orchestration run is paused the way pause-orchestration-run pauses it (a running one parks at its next checkpoint), every open task's automation is paused, schedule triggers stop firing, and queued eval items wait unclaimed. A generation or node already in flight finishes. Reads and configuration writes keep working.
+	* Idempotent: pausing a paused project answers it unchanged and keeps the first `reason`. Emits `projects.paused`.
+	*/
+	static pauseProject(options) {
+		return (options.client ?? client).post({
+			url: "/api/v1/projects/{project_id}/pause",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Resume a project
+	*
+	* Lifts the project's pause and hands back exactly what it held: the runs and tasks the pause parked are resumed (a run the way resume-orchestration-run resumes it, in the background; a task's suppressed dispatch runs as the caller), and schedule triggers fire again from their next occurrence after now — an occurrence that fell due while paused is not fired late. A run or task an operator paused before the project was paused keeps its own pause. Eval runs continue from the item they stopped at. Emits `projects.resumed`.
+	*/
+	static resumeProject(options) {
+		return (options.client ?? client).post({
+			url: "/api/v1/projects/{project_id}/resume",
+			...options
+		});
+	}
+	/**
 	* List a project's price rows
 	*
 	* Returns the project's per-provider-slug price rows — the middle pricing tier that covers every one of the project's instances of a given provider slug. At cost time a per-provider-instance override wins over these, and these win over the global default. Authorized by the caller's access to the project.
@@ -4119,7 +4292,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({
@@ -4856,6 +5029,7 @@ var SoatClient = class {
 	chains;
 	chats;
 	conversations;
+	deciders;
 	documents;
 	embeddings;
 	evaluations;
@@ -4905,6 +5079,7 @@ var SoatClient = class {
 		this.chains = bindResource(Chains, httpClient);
 		this.chats = bindResource(Chats, httpClient);
 		this.conversations = bindResource(Conversations, httpClient);
+		this.deciders = bindResource(Deciders, httpClient);
 		this.documents = bindResource(Documents, httpClient);
 		this.embeddings = bindResource(Embeddings, httpClient);
 		this.evaluations = bindResource(Evaluations, httpClient);
@@ -4948,6 +5123,7 @@ exports.AuditLog = AuditLog;
 exports.Chains = Chains;
 exports.Chats = Chats;
 exports.Conversations = Conversations;
+exports.Deciders = Deciders;
 exports.Documents = Documents;
 exports.Embeddings = Embeddings;
 exports.Evaluations = Evaluations;