@sanity/client 8.3.0 → 8.4.0

package/dist/index.node.js

@@ -1,6 +1,7 @@
-import { t as require_dist } from "./dist-C9ExSk2R.js";
+import { n as __exportAll } from "./rolldown-runtime-4YWMqDIC.js";
 import { a as ServerError, c as isHttpError, i as CorsOriginError, l as isQueryParseError, o as formatQueryParseError, r as ClientError, t as defineRequester } from "./request-SnMg7nUX.js";
 import { t as isRecord } from "./isRecord-Kfmt-nk-.js";
+import { t as require_dist } from "./dist-C5K_YcEU.js";
 import { isTimeoutError } from "get-it";
 import { debug } from "get-it/middleware";
 import { Observable, catchError, concat, defer, finalize, isObservable, lastValueFrom, map, merge, mergeMap, of, share, tap, throwError, timer } from "rxjs";
@@ -66,6 +67,7 @@ const VALID_ASSET_TYPES = ["image", "file"], VALID_INSERT_LOCATIONS = [
 			if (id.split(".").length !== 2) throw Error("Dataset resource ID must be in the format \"project.dataset\"");
 			return;
 		case "dashboard":
+		case "knowledge-base":
 		case "media-library":
 		case "canvas": return;
 		default: throw Error(`Unsupported resource type: ${type.toString()}`);
@@ -114,7 +116,8 @@ const initConfig = (config, prevConfig) => {
 	specifiedConfig.apiVersion || printNoApiVersionSpecifiedWarning();
 	let newConfig = {
 		...defaultConfig,
-		...specifiedConfig
+		...specifiedConfig,
+		apiHost: specifiedConfig.apiHost ?? defaultConfig.apiHost
 	};
 	newConfig["~experimental_resource"] && !newConfig.resource && (printDeprecatedResourceConfigWarning(), newConfig.resource = newConfig["~experimental_resource"]);
 	let resourceConfig$1 = newConfig.resource, projectBased = newConfig.useProjectHostname && !resourceConfig$1;
@@ -611,7 +614,15 @@ var BaseTransaction = class {
 			...patchOps
 		} });
 	}
-};
+}, types_exports = /* @__PURE__ */ __exportAll({ possibleStoreRequestOptions: () => possibleStoreRequestOptions });
+/** @internal */
+const possibleStoreRequestOptions = [
+	"headers",
+	"signal",
+	"tag",
+	"timeout",
+	"token"
+];
 /**
 * Project the public request options (`timeout: 0` to disable,
 * `withCredentials`, `maxRedirects`, the function/object-form `fetch`, ...)
@@ -725,7 +736,7 @@ function _fetchRequest(_stega, _params, options) {
 }
 /** @internal */
 function _fetchObservable(client, httpRequest, _stega, query, _params = {}, options = {}) {
-	return _observe(options.signal, (signal) => _fetch$1(client, httpRequest, _stega, query, _params, {
+	return _observe(options.signal, (signal) => _fetch$2(client, httpRequest, _stega, query, _params, {
 		...options,
 		signal
 	}));
@@ -735,12 +746,12 @@ function _fetchObservable(client, httpRequest, _stega, query, _params = {}, opti
 *
 * @internal
 */
-function _fetch$1(client, httpRequest, _stega, query, _params = {}, options = {}) {
+function _fetch$2(client, httpRequest, _stega, query, _params = {}, options = {}) {
 	let { stega, params, mapResponse, reqOpts } = _fetchRequest(_stega, _params, options), request = _dataRequest(client, httpRequest, "query", {
 		query,
 		params
 	}, reqOpts);
-	return stega.enabled ? Promise.all([request, import("./stegaEncodeSourceMap-DbM2fTN4.js")]).then(([res, { stegaEncodeSourceMap }]) => {
+	return stega.enabled ? Promise.all([request, import("./stegaEncodeSourceMap-CO1HKnm2.js")]).then(([res, { stegaEncodeSourceMap }]) => {
 		let result = stegaEncodeSourceMap(res.result, res.resultSourceMap, stega);
 		return mapResponse({
 			...res,
@@ -1297,6 +1308,7 @@ const resourceDataBase = (config) => {
 			return `/projects/${segments[0]}/datasets/${segments[1]}`;
 		}
 		case "canvas": return `/canvases/${id}`;
+		case "knowledge-base": return `/knowledge-bases/${id}`;
 		case "media-library": return `/media-libraries/${id}`;
 		case "dashboard": return `/dashboards/${id}`;
 		default: throw Error(`Unsupported resource type: ${type.toString()}`);
@@ -1490,7 +1502,7 @@ function _upload(client, _httpRequest, assetType, body, opts = {}) {
 		body
 	};
 	return typeof XMLHttpRequest < "u" ? defer(async () => {
-		let { uploadWithProgress } = await import("./browserUpload-2tz6Sdqp.js"), req = _prepareRequest(client, { ...baseRequest });
+		let { uploadWithProgress } = await import("./browserUpload-C7PwCs-C.js"), req = _prepareRequest(client, { ...baseRequest });
 		return uploadWithProgress({
 			url: appendQuery(req.url, req.query),
 			method: req.method ?? "POST",
@@ -1514,6 +1526,7 @@ function buildAssetUploadUrl(config, assetType) {
 		switch (type) {
 			case "dataset": throw Error("Assets are not supported for dataset resources, yet. Configure the client with `{projectId: <projectId>, dataset: <datasetId>}` instead.");
 			case "canvas": return `/canvases/${id}/assets/${assetTypeEndpoint}`;
+			case "knowledge-base": throw Error("Assets are not supported for knowledge-base resources. Use `client.context.imports` to add content instead.");
 			case "media-library": return `/media-libraries/${id}/upload`;
 			case "dashboard": return `/dashboards/${id}/assets/${assetTypeEndpoint}`;
 			default: throw Error(`Unsupported resource type: ${type.toString()}`);
@@ -1600,7 +1613,7 @@ const possibleOptions = [
 	"tag"
 ], defaultOptions = { includeResult: !0 };
 /** @public */
-function _listen$1(query, params, opts = {}) {
+function _listen$2(query, params, opts = {}) {
 	let { url, requestTagPrefix } = this.config(), tag = opts.tag && requestTagPrefix ? [requestTagPrefix, opts.tag].join(".") : opts.tag, options = {
 		...defaults_default(opts, defaultOptions),
 		tag
@@ -1719,7 +1732,7 @@ function _removeReaction(client, httpRequest, id, shortName, options) {
 	return writeDocument(id, client, httpRequest, "DELETE", `${commentUrl(id)}/reactions/${encodeURIComponent(shortName)}`, void 0, options);
 }
 /** @internal */
-function _fetch(client, httpRequest, query, params, options) {
+function _fetch$1(client, httpRequest, query, params, options) {
 	let search = resourceQuery(client);
 	return _requestObservable(client, httpRequest, {
 		...encodeQueryString({
@@ -1745,7 +1758,7 @@ function _fetch(client, httpRequest, query, params, options) {
 	}).pipe(map$1((response) => response.result));
 }
 /** @internal */
-function _listen(client, query, params, options) {
+function _listen$1(client, query, params, options) {
 	let opts = options ?? {}, { requestTagPrefix } = client.config(), tag = opts.tag && requestTagPrefix ? [requestTagPrefix, opts.tag].join(".") : opts.tag, listenOpts = pick({
 		...defaults_default(opts, defaultOptions),
 		tag
@@ -1868,10 +1881,10 @@ var ObservableCollaborationCommentsClient = class {
 	* @param options - Optional request options
 	*/
 	fetch(query, params, options) {
-		return _fetch(this.#client, this.#httpRequest, query, params, options);
+		return _fetch$1(this.#client, this.#httpRequest, query, params, options);
 	}
 	listen(query, params, options) {
-		return _listen(this.#client, query, params, options);
+		return _listen$1(this.#client, query, params, options);
 	}
 }, CollaborationCommentsClient = class {
 	#client;
@@ -1974,12 +1987,811 @@ var ObservableCollaborationCommentsClient = class {
 	* @param params - Optional query parameters
 	* @param options - Optional request options
 	*/
+	fetch(query, params, options) {
+		return lastValueFrom(_fetch$1(this.#client, this.#httpRequest, query, params, options));
+	}
+	listen(query, params, options) {
+		return _listen$1(this.#client, query, params, options);
+	}
+};
+/** @internal */
+function _organizationId(client) {
+	let organizationId = client.config().context?.organizationId;
+	if (!organizationId) throw Error("`context.organizationId` must be configured to query Context documents");
+	return organizationId;
+}
+function storeUrl(client, suffix) {
+	return `/context/organizations/${encodeURIComponent(_organizationId(client))}/${suffix}`;
+}
+/** @internal */
+function _fetch(client, httpRequest, query, params, options) {
+	let url = storeUrl(client, "query");
+	return _requestObservable(client, httpRequest, {
+		...encodeQueryString({
+			query,
+			params
+		}).length < 11264 ? {
+			method: "GET",
+			url: `${url}${encodeQueryString({
+				query,
+				params
+			})}`
+		} : {
+			method: "POST",
+			url,
+			body: {
+				query,
+				params: params ?? {}
+			}
+		},
+		...pick(options || {}, possibleStoreRequestOptions)
+	}).pipe(map$1((response) => response.result));
+}
+/** @internal */
+function _listen(client, query, params, options) {
+	let opts = options ?? {}, { requestTagPrefix } = client.config(), tag = opts.tag && requestTagPrefix ? [requestTagPrefix, opts.tag].join(".") : opts.tag, listenOpts = pick({
+		...defaults_default(opts, defaultOptions),
+		tag
+	}, possibleOptions), qs = encodeQueryString({
+		query,
+		params,
+		options: listenOpts
+	}), uri = `${client.getUrl(storeUrl(client, "listen"))}${qs}`;
+	return uri.length > 14800 ? throwError(() => /* @__PURE__ */ Error("Query too large for listener")) : _connectListenEventSource(client, uri, opts.events ? opts.events : ["mutation"]);
+}
+const ENTRY_TYPE = "sanity.context.entry", ISSUE_TYPE = "sanity.context.issue", MCP_TYPE = "sanity.context.mcp";
+function _one(client, httpRequest, query, params, options) {
+	return lastValueFrom(_fetch(client, httpRequest, query, params, options));
+}
+/**
+* Drain every page of a `(_createdAt, _id)`-keyset read. Termination keys on
+* the raw page length before anything looks at the rows: a short page means
+* the store had nothing more to give, and filtering must never shorten a
+* full page into a false stop.
+*/
+async function _drainByCreatedAt(client, httpRequest, filter, params, options) {
+	let all = [], cursor;
+	for (;;) {
+		let query = `*[${cursor ? `${filter} && (_createdAt > \$c || (_createdAt == \$c && _id > \$i))` : filter}] | order(_createdAt asc, _id asc) [0...200]`, page = await lastValueFrom(_fetch(client, httpRequest, query, cursor ? {
+			...params,
+			...cursor
+		} : params, options));
+		if (all.push(...page), page.length < 200) return all;
+		let last = page[page.length - 1];
+		cursor = {
+			c: last._createdAt,
+			i: last._id
+		};
+	}
+}
+/** @internal */
+function _readEntry(client, httpRequest, knowledgeBaseId, path, options) {
+	return _one(client, httpRequest, `*[_type == "${ENTRY_TYPE}" && knowledgeBaseId == $kb && path == $path][0]`, {
+		kb: knowledgeBaseId,
+		path
+	}, options);
+}
+/** @internal */
+async function _listEntries(client, httpRequest, knowledgeBaseId, options) {
+	let all = [], after = "";
+	for (;;) {
+		let page = await lastValueFrom(_fetch(client, httpRequest, `*[_type == "${ENTRY_TYPE}" && knowledgeBaseId == $kb && path > $after] | order(path asc) [0...200] {_id, path, title, tldr, status}`, {
+			kb: knowledgeBaseId,
+			after
+		}, options));
+		if (all.push(...page), page.length < 200) return all;
+		after = page[page.length - 1].path;
+	}
+}
+/** @internal */
+function _listIssues(client, httpRequest, knowledgeBaseId, status, options) {
+	return _drainByCreatedAt(client, httpRequest, `_type == "${ISSUE_TYPE}" && knowledgeBaseId == $kb${status === void 0 ? "" : " && status == $status"}`, status === void 0 ? { kb: knowledgeBaseId } : {
+		kb: knowledgeBaseId,
+		status
+	}, options);
+}
+/** @internal */
+function _readIssue(client, httpRequest, knowledgeBaseId, issueId, options) {
+	return _one(client, httpRequest, `*[_type == "${ISSUE_TYPE}" && knowledgeBaseId == $kb && _id == $id][0]`, {
+		kb: knowledgeBaseId,
+		id: issueId
+	}, options);
+}
+/** @internal */
+function _listInstructions(client, httpRequest, knowledgeBaseId, options) {
+	return _drainByCreatedAt(client, httpRequest, "_type == \"sanity.context.instruction\" && knowledgeBaseId == $kb && schemaVersion == 1", { kb: knowledgeBaseId }, options);
+}
+/** @internal */
+function _listMcpEndpoints(client, httpRequest, options) {
+	return lastValueFrom(_fetch(client, httpRequest, `*[_type == "${MCP_TYPE}" && organizationId == $org] | order(_createdAt asc, _id asc) [0...500]`, { org: _organizationId(client) }, options));
+}
+/** @internal */
+function _readMcpEndpoint(client, httpRequest, name, options) {
+	return _one(client, httpRequest, `*[_type == "${MCP_TYPE}" && organizationId == $org && name == $name][0]`, {
+		org: _organizationId(client),
+		name
+	}, options);
+}
+/** @internal */
+function _readConversation(client, httpRequest, threadId, options) {
+	return _one(client, httpRequest, "*[_type == \"sanity.context.conversation\" && organizationId == $org && threadId == $threadId][0]", {
+		org: _organizationId(client),
+		threadId
+	}, options);
+}
+const COLLECTION_URL = "/context/knowledge-bases";
+/**
+* The knowledge base every scoped method operates on comes from the client's
+* `resource` configuration, matching how media libraries and canvases are
+* addressed. Resolved per call so `withConfig` clones behave.
+*/
+function _resolveKnowledgeBaseId(client) {
+	let resource = client.config().resource;
+	if (resource?.type !== "knowledge-base") throw Error("`resource` of type `knowledge-base` must be configured to use knowledge-base methods");
+	return resource.id;
+}
+function _knowledgeBaseUrl(knowledgeBaseId, suffix = "") {
+	return `${COLLECTION_URL}/${encodeURIComponent(knowledgeBaseId)}${suffix}`;
+}
+/** Serialize defined values into query params, dropping the undefined ones. */
+function _conversationUrl(client, threadId) {
+	let organizationId = client.config().context?.organizationId;
+	if (!organizationId) throw Error("`context.organizationId` must be configured to record conversations");
+	if (!threadId) throw Error("`threadId` must be provided");
+	return `/context/organizations/${encodeURIComponent(organizationId)}/conversations/${encodeURIComponent(threadId)}`;
+}
+function _query(entries) {
+	return Object.fromEntries(Object.entries(entries).flatMap(([key, value]) => value === void 0 ? [] : [[key, `${value}`]]));
+}
+function _fetchBody(file) {
+	return ArrayBuffer.isView(file) ? file.buffer instanceof ArrayBuffer ? new Uint8Array(file.buffer, file.byteOffset, file.byteLength) : Uint8Array.from(file) : file;
+}
+/**
+* `client.context` — knowledge bases and everything scoped to them.
+*
+* Collection-level management (create, list, get, edit, delete) addresses
+* knowledge bases per call, like `client.projects`. Everything scoped to one
+* knowledge base (imports, builds, issues, entries, ...) operates on the
+* client's configured `resource`, like media libraries:
+*
+* @example Full lifecycle
+* ```ts
+* const created = await client.context.knowledgeBases.create({
+*   organizationId: 'org123',
+*   title: 'Support docs',
+*   description: 'Product docs and troubleshooting guides',
+* })
+*
+* const kb = createClient({
+*   apiVersion: '2026-08-25',
+*   token,
+*   resource: {type: 'knowledge-base', id: created.publicId},
+* })
+*
+* await kb.context.imports.create({type: 'text', title: 'Refund policy', content: refundMd})
+* const {jobId} = await kb.context.build()
+* ```
+*
+* @beta
+*/
+var ContextClient = class {
+	#client;
+	#httpRequest;
+	constructor(client, httpRequest) {
+		this.#client = client, this.#httpRequest = httpRequest;
+	}
+	/** Request against the configured knowledge base. */
+	#request(suffix, reqOptions = {}) {
+		return _request(this.#client, this.#httpRequest, {
+			url: _knowledgeBaseUrl(_resolveKnowledgeBaseId(this.#client), suffix),
+			...reqOptions
+		});
+	}
+	/** Shared shape of every paginated list endpoint scoped to the knowledge base. */
+	#list(suffix, params, extraQuery) {
+		return this.#request(suffix, {
+			query: _query({
+				cursor: params?.cursor,
+				limit: params?.limit,
+				...extraQuery
+			}),
+			signal: params?.signal,
+			tag: params?.tag
+		});
+	}
+	async #uploadFile(params, options) {
+		let staged = await this.#request("/imports/uploads", {
+			method: "POST",
+			body: {
+				filename: params.filename,
+				...params.contentType && { contentType: params.contentType }
+			},
+			...options
+		}), config = this.#client.config(), putResponse = await (config.resolveFetch?.(config.proxy) ?? globalThis.fetch)(staged.uploadUrl, {
+			method: "PUT",
+			body: _fetchBody(params.file),
+			...params.contentType && { headers: { "content-type": params.contentType } },
+			signal: options?.signal
+		});
+		if (!putResponse.ok) throw Error(`File upload failed: ${putResponse.status} ${putResponse.statusText}`);
+		return this.#request(`/imports/uploads/${encodeURIComponent(staged.importId)}/complete`, {
+			method: "POST",
+			body: {},
+			...options
+		});
+	}
+	/** The knowledge base collection: management addressed per call. */
+	knowledgeBases = {
+		/** Create a knowledge base. Requires the org-level knowledge-base create grant. */
+		create: (params, options) => _request(this.#client, this.#httpRequest, {
+			url: COLLECTION_URL,
+			method: "POST",
+			body: params,
+			...options
+		}),
+		/** List the organization's knowledge bases. */
+		list: (params) => _request(this.#client, this.#httpRequest, {
+			url: COLLECTION_URL,
+			query: _query({
+				organizationId: params.organizationId,
+				cursor: params.cursor,
+				limit: params.limit
+			}),
+			signal: params.signal,
+			tag: params.tag
+		}),
+		/** Fetch a knowledge base by its id. */
+		get: (knowledgeBaseId, options) => _request(this.#client, this.#httpRequest, {
+			url: _knowledgeBaseUrl(knowledgeBaseId),
+			...options
+		}),
+		/** Edit a knowledge base's configuration. */
+		edit: (knowledgeBaseId, params, options) => _request(this.#client, this.#httpRequest, {
+			url: _knowledgeBaseUrl(knowledgeBaseId),
+			method: "PATCH",
+			body: params,
+			...options
+		}),
+		/** Delete a knowledge base and its generated content. */
+		delete: async (knowledgeBaseId, options) => {
+			await _request(this.#client, this.#httpRequest, {
+				url: _knowledgeBaseUrl(knowledgeBaseId),
+				method: "DELETE",
+				...options
+			});
+		}
+	};
+	/**
+	* GROQ over the organization's Context documents (conversation telemetry
+	* today; the store holds every Context family and the caller's access
+	* decides what a query returns, so filter on `_type`).
+	*
+	* Requires `context.organizationId` in the client configuration.
+	*/
 	fetch(query, params, options) {
 		return lastValueFrom(_fetch(this.#client, this.#httpRequest, query, params, options));
 	}
+	/**
+	* Listen for changes to the organization's Context documents. Mirrors
+	* `client.listen(query, params, options)` and emits mutation events by
+	* default.
+	*/
 	listen(query, params, options) {
 		return _listen(this.#client, query, params, options);
 	}
+	/**
+	* Conversation telemetry. `threadId` identifies the conversation within
+	* the organization — reuse means the same conversation. Beyond the canned
+	* `get`, reads go through {@link fetch} and {@link listen} with GROQ
+	* (`_type == "sanity.context.conversation"`).
+	*
+	* Requires `context.organizationId` in the client configuration.
+	*/
+	conversations = {
+		/**
+		* Record a conversation. Messages replace the stored transcript
+		* wholesale; `metadata` and model fields only overwrite when present.
+		* Last write per thread wins — retries are safe.
+		*/
+		save: (params, options) => {
+			let { threadId, ...body } = params;
+			return _request(this.#client, this.#httpRequest, {
+				url: _conversationUrl(this.#client, threadId),
+				method: "PUT",
+				body,
+				...options
+			});
+		},
+		/**
+		* Record the classification your own model produced for one thread:
+		* exactly one of `coreMetrics` (a verdict) or `classificationError`
+		* (why classification failed).
+		*/
+		classify: (params, options) => {
+			let { threadId, ...body } = params;
+			return _request(this.#client, this.#httpRequest, {
+				url: _conversationUrl(this.#client, threadId),
+				method: "PATCH",
+				body,
+				...options
+			});
+		},
+		/**
+		* One recorded conversation by its thread id, or `null` when the thread
+		* was never recorded. Runs:
+		*
+		* `*[_type == "sanity.context.conversation" && organizationId == $org && threadId == $threadId][0]`
+		*
+		* For anything more, use {@link fetch}.
+		*/
+		get: (params, options) => _readConversation(this.#client, this.#httpRequest, params.threadId, options)
+	};
+	/**
+	* Build the configured knowledge base. The server waits for pending import
+	* processing before assembling, so importing and building back to back is
+	* safe. Track the returned job with {@link jobs}.
+	*/
+	build(options) {
+		return this.#request("/build", {
+			method: "POST",
+			...options
+		});
+	}
+	/** Cancel the running build, if any. */
+	cancelBuild(options) {
+		return this.#request("/build/cancel", {
+			method: "POST",
+			...options
+		});
+	}
+	/** Run an incremental refresh: re-check sources and apply what changed. */
+	refresh(options) {
+		return this.#request("/refresh", {
+			method: "POST",
+			...options
+		});
+	}
+	/** Imports: feed content into the configured knowledge base. */
+	imports = {
+		/**
+		* Import content. One entry point, discriminated on `type`: inline
+		* `text`, a website `crawl`, a Sanity `dataset` bind, or a `file`
+		* upload. Processing queues automatically. The file variant stages the
+		* upload, PUTs the bytes to a signed storage URL, and confirms; the
+		* bytes never pass through the Context API.
+		*/
+		create: (params, options) => params.type === "file" ? this.#uploadFile(params, options) : this.#request("/imports", {
+			method: "POST",
+			body: params,
+			...options
+		}),
+		list: (params) => this.#list("/imports", params),
+		get: (params, options) => this.#request(`/imports/${encodeURIComponent(params.importId)}`, options),
+		/** A short-lived signed URL for the original uploaded bytes. */
+		download: (params, options) => this.#request(`/imports/${encodeURIComponent(params.importId)}/download`, options),
+		delete: async (params, options) => {
+			await this.#request(`/imports/${encodeURIComponent(params.importId)}`, {
+				method: "DELETE",
+				...options
+			});
+		}
+	};
+	/** Jobs: poll async work (builds, imports) to a terminal state. */
+	jobs = { get: (params, options) => this.#request(`/jobs/${encodeURIComponent(params.jobId)}`, options) };
+	/**
+	* Issues: findings from builds awaiting triage. Reads are canned GROQ
+	* queries against the organization's document store; for anything more,
+	* use {@link fetch}. Reads require `context.organizationId` alongside the
+	* knowledge-base `resource` in the client configuration.
+	*/
+	issues = {
+		/**
+		* Every issue on the knowledge base, oldest first, optionally narrowed
+		* to one status. Drains keyset pages internally and resolves with the
+		* complete set. Runs:
+		*
+		* `*[_type == "sanity.context.issue" && knowledgeBaseId == $kb && status == $status] | order(_createdAt asc, _id asc)`
+		*
+		* (the status clause only when given). For anything more, use {@link fetch}.
+		*/
+		list: (params, options) => _listIssues(this.#client, this.#httpRequest, _resolveKnowledgeBaseId(this.#client), params?.status, options),
+		/**
+		* One issue by its document id, or `null` when it does not exist. Runs:
+		*
+		* `*[_type == "sanity.context.issue" && knowledgeBaseId == $kb && _id == $id][0]`
+		*
+		* For anything more, use {@link fetch}.
+		*/
+		get: (params, options) => _readIssue(this.#client, this.#httpRequest, _resolveKnowledgeBaseId(this.#client), params.issueId, options),
+		/** Resolve a conflict issue. Mints the standing instruction, same as the dashboard. */
+		resolve: (params, options) => {
+			let { issueId, ...body } = params;
+			return this.#request(`/issues/${encodeURIComponent(issueId)}/resolve`, {
+				method: "POST",
+				body,
+				...options
+			});
+		},
+		dismiss: (params, options) => this.#request(`/issues/${encodeURIComponent(params.issueId)}/dismiss`, {
+			method: "POST",
+			...options
+		}),
+		reopen: (params, options) => this.#request(`/issues/${encodeURIComponent(params.issueId)}/reopen`, {
+			method: "POST",
+			...options
+		}),
+		/** Apply already-accepted issues to the knowledge base in one batch. */
+		apply: (params, options) => this.#request("/issues/apply", {
+			method: "POST",
+			body: params,
+			...options
+		})
+	};
+	/** Instructions: standing decisions that steer every build. */
+	instructions = {
+		create: (params, options) => this.#request("/instructions", {
+			method: "POST",
+			body: params,
+			...options
+		}),
+		/**
+		* Every current-schema instruction on the knowledge base, oldest first.
+		* Drains keyset pages internally and resolves with the complete set.
+		* Runs:
+		*
+		* `*[_type == "sanity.context.instruction" && knowledgeBaseId == $kb && schemaVersion == 1] | order(_createdAt asc, _id asc)`
+		*
+		* For anything more, use {@link fetch}. Requires `context.organizationId`
+		* alongside the knowledge-base `resource` in the client configuration.
+		*/
+		list: (options) => _listInstructions(this.#client, this.#httpRequest, _resolveKnowledgeBaseId(this.#client), options),
+		edit: (params, options) => {
+			let { instructionId, ...body } = params;
+			return this.#request(`/instructions/${encodeURIComponent(instructionId)}`, {
+				method: "PATCH",
+				body,
+				...options
+			});
+		},
+		delete: async (params, options) => {
+			await this.#request(`/instructions/${encodeURIComponent(params.instructionId)}`, {
+				method: "DELETE",
+				...options
+			});
+		}
+	};
+	/**
+	* Entries: the built outline, one entry per node. Reads are canned GROQ
+	* queries against the organization's document store; for anything more,
+	* use {@link fetch}. Requires `context.organizationId` alongside the
+	* knowledge-base `resource` in the client configuration.
+	*/
+	entries = {
+		/**
+		* Every entry, path-ordered, as a metadata view (`_id`, `path`,
+		* `title`, `tldr`, `status`) with bodies excluded. Drains keyset pages
+		* internally and resolves with the complete set. Runs:
+		*
+		* `*[_type == "sanity.context.entry" && knowledgeBaseId == $kb && path > $after] | order(path asc) [0...200] {_id, path, title, tldr, status}`
+		*
+		* For bodies, use `entries.get` or {@link fetch}.
+		*/
+		list: (options) => _listEntries(this.#client, this.#httpRequest, _resolveKnowledgeBaseId(this.#client), options),
+		/**
+		* One entry with its full body and citations, by outline path (e.g.
+		* `billing/refunds`), or `null` when no entry sits at that path. Runs:
+		*
+		* `*[_type == "sanity.context.entry" && knowledgeBaseId == $kb && path == $path][0]`
+		*
+		* For anything more, use {@link fetch}.
+		*/
+		get: (params, options) => _readEntry(this.#client, this.#httpRequest, _resolveKnowledgeBaseId(this.#client), params.path, options),
+		/**
+		* Rebuild one entry from its already-placed sources, by outline path.
+		* Poll the returned job with {@link jobs}; `affectedEntries` lists every
+		* entry the rebuild touches.
+		*/
+		rebuild: (params, options) => this.#request(`/entries/${encodeURIComponent(params.path)}/rebuild`, {
+			method: "POST",
+			...options
+		})
+	};
+	/**
+	* MCP endpoint configurations, org-owned documents read with canned GROQ
+	* queries. Requires `context.organizationId` in the client configuration.
+	*/
+	mcpEndpoints = {
+		/**
+		* The organization's MCP endpoint configurations, oldest first. Runs:
+		*
+		* `*[_type == "sanity.context.mcp" && organizationId == $org] | order(_createdAt asc, _id asc) [0...500]`
+		*
+		* For anything more, use {@link fetch}.
+		*/
+		list: (options) => _listMcpEndpoints(this.#client, this.#httpRequest, options),
+		/**
+		* One MCP endpoint configuration by its URL name, or `null` when none
+		* carries that name. Runs:
+		*
+		* `*[_type == "sanity.context.mcp" && organizationId == $org && name == $name][0]`
+		*
+		* For anything more, use {@link fetch}.
+		*/
+		get: (params, options) => _readMcpEndpoint(this.#client, this.#httpRequest, params.name, options)
+	};
+	/** Sources: the distilled units builds cite. */
+	sources = {
+		/**
+		* List sources, optionally filtered by `status` or the `importId` they
+		* came from. `ids` is a lookup mode: it resolves those exact sources
+		* (e.g. from an entry's citations) and overrides `status` and `cursor`.
+		*/
+		list: (params) => this.#list("/sources", params, {
+			status: params?.status,
+			importId: params?.importId,
+			ids: params?.ids?.join(",")
+		}),
+		get: (params, options) => this.#request(`/sources/${encodeURIComponent(params.sourceId)}`, options),
+		/**
+		* Distilled source content, optionally a line range: the evidence behind
+		* a citation or an issue.
+		*/
+		content: (params, options) => this.#request(`/sources/${encodeURIComponent(params.sourceId)}/content`, {
+			query: _query({
+				startLine: params.startLine,
+				endLine: params.endLine
+			}),
+			...options
+		}),
+		delete: async (params, options) => {
+			await this.#request(`/sources/${encodeURIComponent(params.sourceId)}`, {
+				method: "DELETE",
+				...options
+			});
+		}
+	};
+}, ObservableContextClient = class {
+	#client;
+	#httpRequest;
+	constructor(client, httpRequest) {
+		this.#client = client, this.#httpRequest = httpRequest;
+	}
+	/** The knowledge base collection: management addressed per call. */
+	knowledgeBases = {
+		/** Create a knowledge base. Requires the org-level knowledge-base create grant. */
+		create: (params, options) => _observe(options?.signal, (signal) => _request(this.#client, this.#httpRequest, {
+			url: COLLECTION_URL,
+			method: "POST",
+			body: params,
+			tag: options?.tag,
+			signal
+		})),
+		/** List the organization's knowledge bases. */
+		list: (params) => _observe(params.signal, (signal) => _request(this.#client, this.#httpRequest, {
+			url: COLLECTION_URL,
+			query: _query({
+				organizationId: params.organizationId,
+				cursor: params.cursor,
+				limit: params.limit
+			}),
+			tag: params.tag,
+			signal
+		})),
+		/** Fetch a knowledge base by its id. */
+		get: (knowledgeBaseId, options) => _observe(options?.signal, (signal) => _request(this.#client, this.#httpRequest, {
+			url: _knowledgeBaseUrl(knowledgeBaseId),
+			tag: options?.tag,
+			signal
+		})),
+		/** Edit a knowledge base's configuration. */
+		edit: (knowledgeBaseId, params, options) => _observe(options?.signal, (signal) => _request(this.#client, this.#httpRequest, {
+			url: _knowledgeBaseUrl(knowledgeBaseId),
+			method: "PATCH",
+			body: params,
+			tag: options?.tag,
+			signal
+		})),
+		/** Delete a knowledge base and its generated content. */
+		delete: (knowledgeBaseId, options) => _observe(options?.signal, (signal) => _request(this.#client, this.#httpRequest, {
+			url: _knowledgeBaseUrl(knowledgeBaseId),
+			method: "DELETE",
+			tag: options?.tag,
+			signal
+		}))
+	};
+	/**
+	* GROQ over the organization's Context documents (conversation telemetry
+	* today; the store holds every Context family and the caller's access
+	* decides what a query returns, so filter on `_type`).
+	*
+	* Requires `context.organizationId` in the client configuration.
+	*/
+	fetch(query, params, options) {
+		return _fetch(this.#client, this.#httpRequest, query, params, options);
+	}
+	/**
+	* Listen for changes to the organization's Context documents. Mirrors
+	* `client.listen(query, params, options)` and emits mutation events by
+	* default.
+	*/
+	listen(query, params, options) {
+		return _listen(this.#client, query, params, options);
+	}
+	/**
+	* Conversation telemetry. `threadId` identifies the conversation within
+	* the organization — reuse means the same conversation. Beyond the canned
+	* `get`, reads go through {@link fetch} and {@link listen} with GROQ
+	* (`_type == "sanity.context.conversation"`).
+	*
+	* Requires `context.organizationId` in the client configuration.
+	*/
+	conversations = {
+		/**
+		* Record a conversation. Messages replace the stored transcript
+		* wholesale; `metadata` and model fields only overwrite when present.
+		* Last write per thread wins — retries are safe.
+		*/
+		save: (params, options) => {
+			let { threadId, ...body } = params;
+			return _observe(options?.signal, (signal) => _request(this.#client, this.#httpRequest, {
+				url: _conversationUrl(this.#client, threadId),
+				method: "PUT",
+				body,
+				tag: options?.tag,
+				signal
+			}));
+		},
+		/**
+		* Record the classification your own model produced for one thread:
+		* exactly one of `coreMetrics` (a verdict) or `classificationError`
+		* (why classification failed).
+		*/
+		classify: (params, options) => {
+			let { threadId, ...body } = params;
+			return _observe(options?.signal, (signal) => _request(this.#client, this.#httpRequest, {
+				url: _conversationUrl(this.#client, threadId),
+				method: "PATCH",
+				body,
+				tag: options?.tag,
+				signal
+			}));
+		},
+		/**
+		* One recorded conversation by its thread id, or `null` when the thread
+		* was never recorded. Runs:
+		*
+		* `*[_type == "sanity.context.conversation" && organizationId == $org && threadId == $threadId][0]`
+		*
+		* For anything more, use {@link fetch}.
+		*/
+		get: (params, options) => _observe(options?.signal, (signal) => _readConversation(this.#client, this.#httpRequest, params.threadId, {
+			...options,
+			signal
+		}))
+	};
+	/**
+	* Entries: the built outline, one entry per node. Reads are canned GROQ
+	* queries against the organization's document store; for anything more,
+	* use {@link fetch}. Requires `context.organizationId` alongside the
+	* knowledge-base `resource` in the client configuration.
+	*/
+	entries = {
+		/**
+		* Every entry, path-ordered, as a metadata view (`_id`, `path`,
+		* `title`, `tldr`, `status`) with bodies excluded. Drains keyset pages
+		* internally and emits the complete set. Runs:
+		*
+		* `*[_type == "sanity.context.entry" && knowledgeBaseId == $kb && path > $after] | order(path asc) [0...200] {_id, path, title, tldr, status}`
+		*
+		* For bodies, use `entries.get` or {@link fetch}.
+		*/
+		list: (options) => _observe(options?.signal, (signal) => _listEntries(this.#client, this.#httpRequest, _resolveKnowledgeBaseId(this.#client), {
+			...options,
+			signal
+		})),
+		/**
+		* One entry with its full body and citations, by outline path (e.g.
+		* `billing/refunds`), or `null` when no entry sits at that path. Runs:
+		*
+		* `*[_type == "sanity.context.entry" && knowledgeBaseId == $kb && path == $path][0]`
+		*
+		* For anything more, use {@link fetch}.
+		*/
+		get: (params, options) => _observe(options?.signal, (signal) => _readEntry(this.#client, this.#httpRequest, _resolveKnowledgeBaseId(this.#client), params.path, {
+			...options,
+			signal
+		})),
+		/**
+		* Rebuild one entry from its already-placed sources, by outline path.
+		* Poll the returned job with the promise client's `jobs`;
+		* `affectedEntries` lists every entry the rebuild touches.
+		*/
+		rebuild: (params, options) => _observe(options?.signal, (signal) => _request(this.#client, this.#httpRequest, {
+			url: _knowledgeBaseUrl(_resolveKnowledgeBaseId(this.#client), `/entries/${encodeURIComponent(params.path)}/rebuild`),
+			method: "POST",
+			tag: options?.tag,
+			signal
+		}))
+	};
+	/**
+	* Issues: findings from builds awaiting triage. Reads are canned GROQ
+	* queries against the organization's document store; for anything more,
+	* use {@link fetch}. Requires `context.organizationId` alongside the
+	* knowledge-base `resource` in the client configuration.
+	*/
+	issues = {
+		/**
+		* Every issue on the knowledge base, oldest first, optionally narrowed
+		* to one status. Drains keyset pages internally and emits the complete
+		* set. Runs:
+		*
+		* `*[_type == "sanity.context.issue" && knowledgeBaseId == $kb && status == $status] | order(_createdAt asc, _id asc)`
+		*
+		* (the status clause only when given). For anything more, use {@link fetch}.
+		*/
+		list: (params, options) => _observe(options?.signal, (signal) => _listIssues(this.#client, this.#httpRequest, _resolveKnowledgeBaseId(this.#client), params?.status, {
+			...options,
+			signal
+		})),
+		/**
+		* One issue by its document id, or `null` when it does not exist. Runs:
+		*
+		* `*[_type == "sanity.context.issue" && knowledgeBaseId == $kb && _id == $id][0]`
+		*
+		* For anything more, use {@link fetch}.
+		*/
+		get: (params, options) => _observe(options?.signal, (signal) => _readIssue(this.#client, this.#httpRequest, _resolveKnowledgeBaseId(this.#client), params.issueId, {
+			...options,
+			signal
+		}))
+	};
+	/**
+	* Instructions: standing decisions that steer every build. The canned
+	* GROQ read; writes are promise-based on `client.context`.
+	*/
+	instructions = { 
+	/**
+	* Every current-schema instruction on the knowledge base, oldest first.
+	* Drains keyset pages internally and emits the complete set. Runs:
+	*
+	* `*[_type == "sanity.context.instruction" && knowledgeBaseId == $kb && schemaVersion == 1] | order(_createdAt asc, _id asc)`
+	*
+	* For anything more, use {@link fetch}. Requires `context.organizationId`
+	* alongside the knowledge-base `resource` in the client configuration.
+	*/
+list: (options) => _observe(options?.signal, (signal) => _listInstructions(this.#client, this.#httpRequest, _resolveKnowledgeBaseId(this.#client), {
+		...options,
+		signal
+	})) };
+	/**
+	* MCP endpoint configurations, org-owned documents read with canned GROQ
+	* queries. Requires `context.organizationId` in the client configuration.
+	*/
+	mcpEndpoints = {
+		/**
+		* The organization's MCP endpoint configurations, oldest first. Runs:
+		*
+		* `*[_type == "sanity.context.mcp" && organizationId == $org] | order(_createdAt asc, _id asc) [0...500]`
+		*
+		* For anything more, use {@link fetch}.
+		*/
+		list: (options) => _observe(options?.signal, (signal) => _listMcpEndpoints(this.#client, this.#httpRequest, {
+			...options,
+			signal
+		})),
+		/**
+		* One MCP endpoint configuration by its URL name, or `null` when none
+		* carries that name. Runs:
+		*
+		* `*[_type == "sanity.context.mcp" && organizationId == $org && name == $name][0]`
+		*
+		* For anything more, use {@link fetch}.
+		*/
+		get: (params, options) => _observe(options?.signal, (signal) => _readMcpEndpoint(this.#client, this.#httpRequest, params.name, {
+			...options,
+			signal
+		}))
+	};
 };
 /**
 * A variant of share that takes a predicate function to determine which value to replay to new subscribers
@@ -3040,6 +3852,8 @@ var ObservableReleasesClient = class {
 	collaboration;
 	functions;
 	releases;
+	/** @beta */
+	context;
 	/**
 	* Private properties
 	*/
@@ -3048,9 +3862,9 @@ var ObservableReleasesClient = class {
 	/**
 	* Instance properties
 	*/
-	listen = _listen$1;
+	listen = _listen$2;
 	constructor(httpRequest, config = defaultConfig) {
-		this.config(config), this.#httpRequest = httpRequest, this.assets = new ObservableAssetsClient(this, this.#httpRequest), this.datasets = new ObservableDatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.mediaLibrary = { video: new ObservableMediaLibraryVideoClient(this, this.#httpRequest) }, this.projects = new ObservableProjectsClient(this, this.#httpRequest), this.users = new ObservableUsersClient(this, this.#httpRequest), this.agent = { action: new ObservableAgentsActionClient(this, this.#httpRequest) }, this.collaboration = { comments: new ObservableCollaborationCommentsClient(this, this.#httpRequest) }, this.functions = new ObservableFunctionsClient(this, this.#httpRequest), this.releases = new ObservableReleasesClient(this, this.#httpRequest);
+		this.config(config), this.#httpRequest = httpRequest, this.assets = new ObservableAssetsClient(this, this.#httpRequest), this.datasets = new ObservableDatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.mediaLibrary = { video: new ObservableMediaLibraryVideoClient(this, this.#httpRequest) }, this.projects = new ObservableProjectsClient(this, this.#httpRequest), this.users = new ObservableUsersClient(this, this.#httpRequest), this.agent = { action: new ObservableAgentsActionClient(this, this.#httpRequest) }, this.collaboration = { comments: new ObservableCollaborationCommentsClient(this, this.#httpRequest) }, this.functions = new ObservableFunctionsClient(this, this.#httpRequest), this.releases = new ObservableReleasesClient(this, this.#httpRequest), this.context = new ObservableContextClient(this, this.#httpRequest);
 	}
 	/**
 	* Clone the client - returns a new instance
@@ -3276,6 +4090,8 @@ var ObservableReleasesClient = class {
 	collaboration;
 	functions;
 	releases;
+	/** @beta */
+	context;
 	/**
 	* Observable version of the Sanity client, with the same configuration as the promise-based one
 	*/
@@ -3288,9 +4104,9 @@ var ObservableReleasesClient = class {
 	/**
 	* Instance properties
 	*/
-	listen = _listen$1;
+	listen = _listen$2;
 	constructor(httpRequest, config = defaultConfig) {
-		this.config(config), this.#httpRequest = httpRequest, this.assets = new AssetsClient(this, this.#httpRequest), this.datasets = new DatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.mediaLibrary = { video: new MediaLibraryVideoClient(this, this.#httpRequest) }, this.projects = new ProjectsClient(this, this.#httpRequest), this.users = new UsersClient(this, this.#httpRequest), this.agent = { action: new AgentActionsClient(this, this.#httpRequest) }, this.collaboration = { comments: new CollaborationCommentsClient(this, this.#httpRequest) }, this.functions = new FunctionsClient(this, this.#httpRequest), this.releases = new ReleasesClient(this, this.#httpRequest), this.observable = new ObservableSanityClient(httpRequest, config);
+		this.config(config), this.#httpRequest = httpRequest, this.assets = new AssetsClient(this, this.#httpRequest), this.datasets = new DatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.mediaLibrary = { video: new MediaLibraryVideoClient(this, this.#httpRequest) }, this.projects = new ProjectsClient(this, this.#httpRequest), this.users = new UsersClient(this, this.#httpRequest), this.agent = { action: new AgentActionsClient(this, this.#httpRequest) }, this.collaboration = { comments: new CollaborationCommentsClient(this, this.#httpRequest) }, this.functions = new FunctionsClient(this, this.#httpRequest), this.releases = new ReleasesClient(this, this.#httpRequest), this.context = new ContextClient(this, this.#httpRequest), this.observable = new ObservableSanityClient(httpRequest, config);
 	}
 	/**
 	* Clone the client - returns a new instance
@@ -3320,7 +4136,7 @@ var ObservableReleasesClient = class {
 		});
 	}
 	fetch(query, params, options) {
-		return _fetch$1(this, this.#httpRequest, this.#clientConfig.stega, query, params, options);
+		return _fetch$2(this, this.#httpRequest, this.#clientConfig.stega, query, params, options);
 	}
 	getDocument(id, options) {
 		if (options?.includeAllVersions === !0) return _getDocument(this, this.#httpRequest, id, {
@@ -3552,7 +4368,7 @@ function defineDeprecatedCreateClient(createClient) {
 		return printNoDefaultExport(), createClient(config);
 	};
 }
-var name = "@sanity/client", version = "8.3.0";
+var name = "@sanity/client", version = "8.4.0";
 const log = createDebug("sanity:client");
 function isNodeReadableStream(value) {
 	return typeof value != "object" || !value || !("pipe" in value) ? !1 : typeof value.pipe == "function";
@@ -3609,6 +4425,6 @@ const middleware = [
 	middleware,
 	resolveFetch
 }, SanityClient), requester = exp.requester, createClient = exp.createClient, deprecatedCreateClient = defineDeprecatedCreateClient(createClient);
-export { BasePatch, BaseTransaction, ChannelError, ClientError, ConnectionFailedError, CorsOriginError, DisconnectError, EXPERIMENTAL_API_WARNING, MessageError, MessageParseError, ObservablePatch, ObservableSanityClient, ObservableTransaction, Patch, SanityClient, ServerError, Transaction, connectEventSource, createClient, deprecatedCreateClient as default, formatQueryParseError, isHttpError, isQueryParseError, isTimeoutError, requester, validateApiPerspective };
+export { BasePatch, BaseTransaction, ChannelError, ClientError, ConnectionFailedError, types_exports as Context, CorsOriginError, DisconnectError, EXPERIMENTAL_API_WARNING, MessageError, MessageParseError, ObservablePatch, ObservableSanityClient, ObservableTransaction, Patch, SanityClient, ServerError, Transaction, connectEventSource, createClient, deprecatedCreateClient as default, formatQueryParseError, isHttpError, isQueryParseError, isTimeoutError, requester, validateApiPerspective };
 
 //# sourceMappingURL=index.node.js.map