@soat/sdk 0.18.0 → 0.18.2

package/dist/index.cjs

@@ -855,6 +855,94 @@ var Agents = class {
 		});
 	}
 };
+var AgentVersions = class {
+	/**
+	* List an agent's config versions
+	*
+	* Returns the agent's archived configurations, newest first. A version is written on create and on every subsequent write that changes the config — through the REST API or a formation apply alike. See [Versioning and Staged Rollout](/docs/modules/agents#versioning-and-staged-rollout).
+	*
+	*/
+	static listAgentVersions(options) {
+		return (options.client ?? client).get({
+			url: "/api/v1/agents/{agent_id}/versions",
+			...options
+		});
+	}
+	/**
+	* Get an archived agent config version
+	*
+	* Returns the exact configuration the agent held at a given version, so a generation can be traced back to the config that produced it.
+	*
+	*/
+	static getAgentVersion(options) {
+		return (options.client ?? client).get({
+			url: "/api/v1/agents/{agent_id}/versions/{version}",
+			...options
+		});
+	}
+	/**
+	* Restore an archived config as a new version
+	*
+	* Copies the named version's configuration onto the agent as a **new** version rather than rewinding the counter, so history stays append-only and the versions in between remain retrievable. Restoring the config the agent already holds is a no-op and creates no version.
+	*
+	* The restored config fully replaces the current one: a field the archived version did not set is cleared, not merged. Restore re-validates the config, so a tool, provider, or guardrail deleted since the snapshot was taken fails the request instead of writing a broken agent.
+	*
+	*/
+	static restoreAgentVersion(options) {
+		return (options.client ?? client).post({
+			url: "/api/v1/agents/{agent_id}/versions/{version}/restore",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Set or replace a staged rollout
+	*
+	* Starts serving two archived versions side by side: `canary_percent` of traffic gets `canary_version`, the rest gets `stable_version`.
+	*
+	* Assignment is deterministic — it hashes the actor behind the request's session (falling back to the session itself), so one end user never flip-flops between configs mid-conversation. Requests with neither are split randomly.
+	*
+	* While a release is active the agent's live columns act as a **draft**: further edits archive new versions but do not disturb either side of the running split. End the rollout with `promote` or `abort`.
+	*
+	*/
+	static setAgentRelease(options) {
+		return (options.client ?? client).put({
+			url: "/api/v1/agents/{agent_id}/release",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Promote the canary and end the rollout
+	*
+	* Makes the canary version's config the agent's live config and clears the release. The canary is pinned by version, so an edit that landed mid-rollout is not promoted in its place — it stays an unreleased draft in the version history.
+	*
+	*/
+	static promoteAgentRelease(options) {
+		return (options.client ?? client).post({
+			url: "/api/v1/agents/{agent_id}/release/promote",
+			...options
+		});
+	}
+	/**
+	* Abort the rollout and roll back to stable
+	*
+	* Restores the stable version's config as the agent's live config and clears the release, so all traffic returns to the configuration the rollout was measured against — not to whatever draft the live columns happened to hold.
+	*
+	*/
+	static abortAgentRelease(options) {
+		return (options.client ?? client).post({
+			url: "/api/v1/agents/{agent_id}/release/abort",
+			...options
+		});
+	}
+};
 var AiProviders = class {
 	/**
 	* List AI providers
@@ -1505,6 +1593,12 @@ var Documents = class {
 	* are read as a single source. How the source is chunked is controlled by
 	* `chunk_strategy`.
 	*
+	* A file can only back one Document — a second call with the same `file_id`
+	* returns `409 FILE_ALREADY_INGESTED`. To re-process an already-ingested file
+	* (e.g. with a different `chunk_strategy`), use
+	* `POST /documents/{document_id}/ingest`; to ingest the same source under a
+	* different path, upload a new copy of the file first.
+	*
 	*/
 	static ingestDocument(options) {
 		return (options.client ?? client).post({
@@ -3888,6 +3982,7 @@ var SoatClient = class {
 //#endregion
 exports.Activity = Activity;
 exports.Actors = Actors;
+exports.AgentVersions = AgentVersions;
 exports.Agents = Agents;
 exports.AiProviders = AiProviders;
 exports.ApiKeys = ApiKeys;