@sanity/sdk 3.0.0-rc.1 → 3.0.0

package/README.md

@@ -9,6 +9,18 @@ The App SDK Core is a pure TypeScript implementation of the App SDK’s business
 
 We highly recommend that users default to using the hooks provided by the React SDK for building custom apps on the Sanity platform, unless you’re looking to create your own Sanity App SDK using this core layer.
 
+## Entry points
+
+The package exposes multiple entry points:
+
+| Entry point           | Contents                                                                |
+| --------------------- | ----------------------------------------------------------------------- |
+| `@sanity/sdk`         | Core SDK — auth, documents, queries, presence, projects, users, etc.    |
+| `@sanity/sdk/agent`   | AI agent utilities — `agentGenerate`, `agentPatch`, `agentPrompt`, etc. |
+| `@sanity/sdk/comlink` | Comlink channel/controller/node utilities and message types             |
+
+`@sanity/sdk-react` re-exports the main `@sanity/sdk` entry point only. Import the agent and comlink utilities from their sub-entries directly.
+
 **Looking for our React SDK?** You’ll find it on:
 
 - [GitHub](https://github.com/sanity-io/sdk/tree/main/packages/react)

package/dist/_exports/_internal.d.ts

@@ -1,5 +1,49 @@
-import { A as transformProjectionToPreview, B as getClientErrorApiBody, E as parseQueryKey, H as getClientErrorApiType, R as PREVIEW_PROJECTION, S as defineMutation, U as isProjectUserNotFoundClientError, V as getClientErrorApiDescription, _ as FetcherDefinition, b as MutationResult, ct as isStudioConfig, g as Fetcher, h as CacheWriter, m as CacheTag, n as getUsersKey, ot as SanityInstance, r as parseUsersKey, t as createGroqSearchFilter, v as FetcherSnapshot, w as getQueryKey, x as defineFetcher, y as MutationDefinition, z as ApiErrorBody } from "../_chunks-dts/createGroqSearchFilter.js";
-import { SanityClient } from "@sanity/client";
+import { m as SanityConfig, s as DocumentResource, t as SanityInstance } from "../createSanityInstance-DUI1bGIg.js";
+import { B as parseQueryKey, R as getQueryKey, Si as defineMutation, _i as FetcherDefinition, bi as MutationResult, et as PreviewQueryResult, gi as Fetcher, gr as getCommentsOptionsKey, hi as CacheWriter, mi as CacheTag, tt as PreviewValue, vi as FetcherSnapshot, vr as parseCommentsOptionsKey, xi as defineFetcher, yi as MutationDefinition, yt as GetUsersOptions } from "../authStore-C0o1NOxW.js";
+import { ClientError, SanityClient } from "@sanity/client";
+import { Observable } from "rxjs";
+import { CurrentUser } from "@sanity/types";
+/**
+ * Returns `true` when the config indicates the SDK is running inside a Studio.
+ *
+ * @internal
+ */
+declare function isStudioConfig(config: SanityConfig): boolean;
+/** @internal */
+type ApiErrorBody = {
+  error?: {
+    type?: string;
+    description?: string;
+  };
+  type?: string;
+  description?: string;
+  message?: string;
+};
+/** @internal Extracts the structured API error body from a ClientError, if present. */
+declare function getClientErrorApiBody(error: ClientError): ApiErrorBody | undefined;
+/** @internal Returns the error type string from an API error body, if available. */
+declare function getClientErrorApiType(error: ClientError): string | undefined;
+/** @internal Returns the error description string from an API error body, if available. */
+declare function getClientErrorApiDescription(error: ClientError): string | undefined;
+/** @internal True if the error represents a projectUserNotFoundError. */
+declare function isProjectUserNotFoundClientError(error: ClientError): boolean;
+/**
+ * Generates a GROQ projection for preview data without requiring a schema.
+ * Uses common field names to make educated guesses about which fields to use.
+ *
+ * @internal
+ */
+declare const PREVIEW_PROJECTION: string;
+/**
+ * Transforms a projection result (with titleCandidates, subtitleCandidates, media)
+ * into a PreviewValue (with title, subtitle, media).
+ *
+ * @param projectionResult - The raw projection result from GROQ
+ * @param instance - The Sanity instance to use for client configuration
+ * @param resource - Data resource for the preview
+ * @internal
+ */
+declare function transformProjectionToPreview(instance: SanityInstance, projectionResult: PreviewQueryResult, resource?: DocumentResource): PreviewValue;
 /**
  * Manages telemetry for a single SDK instance.
  *
@@ -77,6 +121,30 @@ declare function getTelemetryManager(instance: SanityInstance): TelemetryManager
  * @internal
  */
 declare function trackHookMounted(instance: SanityInstance, hookName: string): void;
+/** @internal */
+declare const getUsersKey: (instance: SanityInstance, { resourceType, organizationId, batchSize, projectId, userId }?: GetUsersOptions) => string;
+/** @internal */
+declare const parseUsersKey: (key: string) => {
+  batchSize: number;
+  resourceType?: "organization" | "project";
+  projectId?: string;
+  organizationId?: string;
+  userId?: string;
+};
+/**
+ * Creates a GROQ search filter string (`[@] match text::query("...")`)
+ * from a raw search query string.
+ *
+ * It applies wildcard ('*') logic to the last eligible token and escapes
+ * double quotes within the search term.
+ *
+ * If the input query is empty or only whitespace, it returns an empty string.
+ *
+ * @param query - The raw input search string.
+ * @returns The GROQ search filter string, or an empty string.
+ * @internal
+ */
+declare function createGroqSearchFilter(query: string): string;
 /**
  * Creates a shallow copy containing only the provided properties.
  *
@@ -91,5 +159,5 @@ declare function pickProperties<T extends object, K extends keyof T>(value: T, k
  * @internal
  */
 declare function isDeepEqual<T>(left: T, right: T): boolean;
-export { type ApiErrorBody, type CacheTag, type CacheWriter, type Fetcher, type FetcherDefinition, type FetcherSnapshot, type MutationDefinition, type MutationResult, PREVIEW_PROJECTION, createGroqSearchFilter, defineFetcher, defineMutation, getClientErrorApiBody, getClientErrorApiDescription, getClientErrorApiType, getQueryKey, getTelemetryManager, getUsersKey, initTelemetry, isDeepEqual, isProjectUserNotFoundClientError, isStudioConfig, parseQueryKey, parseUsersKey, pickProperties, trackHookMounted, transformProjectionToPreview };
+export { type ApiErrorBody, type CacheTag, type CacheWriter, type Fetcher, type FetcherDefinition, type FetcherSnapshot, type MutationDefinition, type MutationResult, PREVIEW_PROJECTION, createGroqSearchFilter, defineFetcher, defineMutation, getClientErrorApiBody, getClientErrorApiDescription, getClientErrorApiType, getCommentsOptionsKey, getQueryKey, getTelemetryManager, getUsersKey, initTelemetry, isDeepEqual, isProjectUserNotFoundClientError, isStudioConfig, parseCommentsOptionsKey, parseQueryKey, parseUsersKey, pickProperties, trackHookMounted, transformProjectionToPreview };
 //# sourceMappingURL=_internal.d.ts.map

package/dist/_exports/_internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_internal.d.ts","names":[],"sources":["../../src/telemetry/telemetryManager.ts","../../src/telemetry/initTelemetry.ts","../../src/utils/object.ts"],"mappings":";;;;;;;;;;;;;UAgCiB;;;;;;;EAOf,gBAAgB;;EAGhB,kBAAkB;IAAO;IAAmB;IAAqB;;;EAGjE,iBAAiB;;EAGjB,SAAS,mBAAmB;;EAG5B;;EAGA;;WAGS,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;iBCXN,cAAc,UAAU,gBAAgB;;;;;;;iBAoIxC,oBAAoB,UAAU,iBAAiB;;;;;;;;iBAW/C,iBAAiB,UAAU,gBAAgB;;;;;;iBCvJ3C,eAAe,kBAAkB,gBAAgB,GAC/D,OAAO,GACP,eAAe,MACd,KAAK,GAAG;;;;;;;;iBA2DK,YAAY,GAAG,MAAM,GAAG,OAAO"}
+{"version":3,"file":"_internal.d.ts","names":[],"sources":["../../src/auth/authMode.ts","../../src/auth/utils.ts","../../src/preview/previewConstants.ts","../../src/preview/previewProjectionUtils.ts","../../src/telemetry/telemetryManager.ts","../../src/telemetry/initTelemetry.ts","../../src/users/reducers.ts","../../src/utils/createGroqSearchFilter.ts","../../src/utils/object.ts"],"mappings":";;;;;;;;;;iBAsCgB,eAAe,QAAQ;;KC0I3B;EACV;IAAS;IAAe;;EACxB;EACA;EACA;;;iBAIc,sBAAsB,OAAO,cAAc;;iBAM3C,sBAAsB,OAAO;;iBAM7B,6BAA6B,OAAO;;iBAMpC,iCAAiC,OAAO;;;;;;;cCpL3C;;;;;;;;;;iBCiDG,6BACd,UAAU,gBACV,kBAAkB,oBAClB,WAAW,mBACV;;;;;;;;;;;;UC3Cc;;;;;;;EAOf,gBAAgB;;EAGhB,kBAAkB;IAAO;IAAmB;IAAqB;;;EAGjE,iBAAiB;;EAGjB,SAAS,mBAAmB;;EAG5B;;EAGA;;WAGS,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;iBCXN,cAAc,UAAU,gBAAgB;;;;;;;iBAoIxC,oBAAoB,UAAU,iBAAiB;;;;;;;;iBAW/C,iBAAiB,UAAU,gBAAgB;;cCvL9C,cACX,UAAU,kBACV,cAAA,gBAAA,WAAA,WAAA,WAMG;;cAWQ,gBACX;EAEA;EACA;EACA;EACA;EACA;;;;;;;;;;;;;;;iBCYc,uBAAuB;;;;;;iBCNvB,eAAe,kBAAkB,gBAAgB,GAC/D,OAAO,GACP,eAAe,MACd,KAAK,GAAG;;;;;;;;iBA2DK,YAAY,GAAG,MAAM,GAAG,OAAO"}

package/dist/_exports/_internal.js

@@ -1,24 +1,332 @@
-import { PREVIEW_PROJECTION, createGroqSearchFilter, defineFetcher, defineMutation, getClientErrorApiBody, getClientErrorApiDescription, getClientErrorApiType, getQueryKey, getUsersKey, isDeepEqual, isProjectUserNotFoundClientError, isStudioConfig, parseQueryKey, parseUsersKey, pickProperties, transformProjectionToPreview } from "../_chunks-es/createGroqSearchFilter.js";
-import { getTelemetryManager, initTelemetry, trackHookMounted } from "../_chunks-es/_internal.js";
-export {
-  PREVIEW_PROJECTION,
-  createGroqSearchFilter,
-  defineFetcher,
-  defineMutation,
-  getClientErrorApiBody,
-  getClientErrorApiDescription,
-  getClientErrorApiType,
-  getQueryKey,
-  getTelemetryManager,
-  getUsersKey,
-  initTelemetry,
-  isDeepEqual,
-  isProjectUserNotFoundClientError,
-  isStudioConfig,
-  parseQueryKey,
-  parseUsersKey,
-  pickProperties,
-  trackHookMounted,
-  transformProjectionToPreview
-};
-//# sourceMappingURL=_internal.js.map
+import { C as parseCommentsOptionsKey, U as defineFetcher, W as defineMutation, f as parseUsersKey, r as parseQueryKey, t as getQueryKey, u as getUsersKey, x as getCommentsOptionsKey } from "../queryStore-C7yMHPUI.js";
+import { n as createLogger } from "../logger-DAtJb5RQ.js";
+import { g as getClientErrorApiType, h as getClientErrorApiDescription, m as getClientErrorApiBody, x as isStudioConfig, y as isProjectUserNotFoundClientError } from "../authStore-CtE9bLHW.js";
+import { i as pickProperties, n as isObject, t as isDeepEqual } from "../object-CxXlSVg7.js";
+import { n as getClient } from "../clientStore-BtE2-q2i.js";
+import "@sanity/client";
+import { createImageUrlBuilder } from "@sanity/image-url";
+/**
+* The fields to check for a title.
+* The order of the items in the array defines the priority.
+*
+* @internal
+*/
+const TITLE_CANDIDATES = [
+	"title",
+	"name",
+	"label",
+	"heading",
+	"header",
+	"caption"
+], SUBTITLE_CANDIDATES = [
+	"description",
+	"subtitle",
+	...TITLE_CANDIDATES
+], PREVIEW_PROJECTION = `{
+  // Get all potential title fields
+  "titleCandidates": {
+    ${TITLE_CANDIDATES.map((field) => `"${field}": ${field}`).join(",\n      ")}
+  },
+  // Get all potential subtitle fields
+  "subtitleCandidates": {
+    ${SUBTITLE_CANDIDATES.map((field) => `"${field}": ${field}`).join(",\n      ")}
+  },
+  "media": coalesce(
+    select(
+      defined(asset) => {"type": "image-asset", "_ref": asset._ref},
+      defined(image.asset) => {"type": "image-asset", "_ref": image.asset._ref},
+      defined(mainImage.asset) => {"type": "image-asset", "_ref": mainImage.asset._ref},
+      null
+    )
+  ),
+  _type,
+  _id,
+  _updatedAt
+}`;
+/**
+* Checks if the provided value has `_ref` property that is a string and starts with `image-`
+*/
+function hasImageRef(value) {
+	return isObject(value) && "_ref" in value && typeof value._ref == "string";
+}
+/**
+* Normalizes a media asset to a preview value.
+* Adds a url to a media asset reference using `@sanity/image-url`.
+*
+* @internal
+*/
+function normalizeMedia(media, client) {
+	if (!media || !hasImageRef(media)) return null;
+	let url = createImageUrlBuilder(client).image({ _ref: media._ref }).url();
+	return {
+		type: "image-asset",
+		_ref: media._ref,
+		url
+	};
+}
+/**
+* Finds a single field value from a set of candidates based on a priority list of field names.
+* Returns the first non-empty string value found from the candidates matching the priority list order.
+*
+* @internal
+*/
+function findFirstDefined(fieldsToSearch, candidates, exclude) {
+	if (candidates) for (let field of fieldsToSearch) {
+		let value = candidates[field];
+		if (typeof value == "string" && value.trim() !== "" && value !== exclude) return value;
+	}
+}
+/**
+* Transforms a projection result (with titleCandidates, subtitleCandidates, media)
+* into a PreviewValue (with title, subtitle, media).
+*
+* @param projectionResult - The raw projection result from GROQ
+* @param instance - The Sanity instance to use for client configuration
+* @param resource - Data resource for the preview
+* @internal
+*/
+function transformProjectionToPreview(instance, projectionResult, resource) {
+	let title = findFirstDefined(TITLE_CANDIDATES, projectionResult.titleCandidates), subtitle = findFirstDefined(SUBTITLE_CANDIDATES, projectionResult.subtitleCandidates, title), client = getClient(instance, {
+		apiVersion: "v2025-05-06",
+		resource
+	});
+	return {
+		title: String(title || `${projectionResult._type}: ${projectionResult._id}`),
+		subtitle: subtitle || void 0,
+		media: normalizeMedia(projectionResult.media, client),
+		...projectionResult._status && { _status: projectionResult._status }
+	};
+}
+/**
+* Hostname suffixes that count as Sanity-controlled for the purposes of
+* production telemetry. A user reaching one of these hosts in the
+* browser is authenticated against Sanity and has a Populus consent
+* record, so we apply the same telemetry rules as the Studio's
+* `telemetry-sink`.
+*
+* The leading `.` is required: it ensures suffix matches hit a real
+* subdomain boundary, so apex matches (`sanity.io`, `sanity.studio`)
+* and lookalikes (`evilsanity.studio`) are excluded. Only production
+* hosts are listed; staging (`*.sanity.work`) and preview
+* (`*.sanity.dev`) hosts are excluded by omission.
+*
+* @internal
+*/
+const SANITY_CONTROLLED_HOST_SUFFIXES = [".sanity.studio", ".sanity.io"];
+function getBrowserHostname(win) {
+	let hostname = win.location?.hostname;
+	return typeof hostname == "string" && hostname.length > 0 ? hostname.toLowerCase() : null;
+}
+function isLocalHostname(hostname) {
+	return hostname === "localhost" || hostname === "127.0.0.1";
+}
+function isSanityControlledHostname(hostname) {
+	return SANITY_CONTROLLED_HOST_SUFFIXES.some((suffix) => hostname.endsWith(suffix));
+}
+/**
+* Returns the telemetry environment for the current runtime, or `null`
+* when telemetry should not run at all.
+*
+* Browser:
+* - `localhost` / `127.0.0.1` → `'development'`
+* - host matches the Sanity-controlled allowlist → `'production'`
+* - anything else (customer domains, unknown contexts) → `null`
+*
+* Node (scripts, SSR, tests):
+* - `NODE_ENV=development` → `'development'`
+* - otherwise → `null`. Production-side server runtimes don't carry the
+*   browser-authenticated user/consent assumption, so we don't enable
+*   them under the production gate.
+*
+* Bracket-notation `process.env['NODE_ENV']` is used to avoid bundler
+* dead-code replacement.
+*
+* @internal
+*/
+function getTelemetryEnvironment() {
+	if (typeof window < "u") {
+		let hostname = getBrowserHostname(window);
+		return hostname ? isLocalHostname(hostname) ? "development" : isSanityControlledHostname(hostname) ? "production" : null : null;
+	}
+	return typeof process < "u" && process.env?.NODE_ENV === "development" ? "development" : null;
+}
+const logger = createLogger("telemetry"), telemetryManagers = /* @__PURE__ */ new WeakMap(), pendingHooks = /* @__PURE__ */ new WeakMap(), initInFlight = /* @__PURE__ */ new WeakSet();
+/**
+* Initializes telemetry for a SDK instance if the runtime environment
+* qualifies. The environment is resolved by `getTelemetryEnvironment()`:
+*
+* - `'development'` — local dev servers (`localhost` / `127.0.0.1`, or
+*   Node with `NODE_ENV=development`). This is the original opt-in
+*   surface.
+* - `'production'` — apps deployed to Sanity-controlled domains
+*   (e.g. `*.sanity.studio`, the dashboard). End users are
+*   authenticated Sanity users with Populus consent records, so we
+*   apply the same consent gate as the Studio's `telemetry-sink`.
+*
+* Apps on customer-controlled domains return `null` and skip telemetry
+* entirely.
+*
+* `telemetryManager` and `clientStore` are dynamically imported so the
+* telemetry code path stays out of production bundles for apps that
+* don't qualify. Only the lightweight environment check runs at boot.
+*
+* The `projectId` must be passed explicitly because the resource
+* configuration is typically set by the React layer after the
+* instance has already been created.
+*
+* @internal
+*/
+function initTelemetry(instance, projectId) {
+	let environment = getTelemetryEnvironment();
+	if (!environment) {
+		logger.trace("initTelemetry skipped: environment not eligible", { internal: !0 });
+		return;
+	}
+	if (!projectId) {
+		logger.trace("initTelemetry skipped: no projectId", { internal: !0 });
+		return;
+	}
+	telemetryManagers.has(instance) || initInFlight.has(instance) || (initInFlight.add(instance), logger.debug("initializing telemetry", {
+		projectId,
+		environment
+	}), Promise.all([
+		import("../telemetryManager-UIEiMtC0.js").then((n) => n.t),
+		import("../clientStore-BtE2-q2i.js").then((n) => n.t),
+		import("../authStore-CtE9bLHW.js").then((n) => n.n)
+	]).then(async ([{ createTelemetryManager }, { getClient }, { getTokenState }]) => {
+		if (instance.isDisposed()) {
+			initInFlight.delete(instance), logger.debug("telemetry skipped: instance disposed before imports resolved");
+			return;
+		}
+		let token = getTokenState(instance).getCurrent();
+		if (logger.trace("auth token check", {
+			tokenPresent: !!token,
+			internal: !0
+		}), !token && (logger.debug("waiting for auth token"), !await new Promise((resolve) => {
+			if (instance.isDisposed()) return resolve(!1);
+			let cleanup = { unsubscribe: () => {} }, unsub = instance.onDispose(() => {
+				cleanup.unsubscribe(), resolve(!1);
+			}), received = !1, sub = getTokenState(instance).observable.subscribe((t) => {
+				received || !t || (received = !0, logger.debug("auth token received"), unsub(), resolve(!0), cleanup.unsubscribe());
+			});
+			cleanup.unsubscribe = () => sub.unsubscribe(), received && cleanup.unsubscribe();
+		}) || instance.isDisposed())) {
+			initInFlight.delete(instance), logger.debug("telemetry skipped: no token resolved or instance disposed");
+			return;
+		}
+		let manager = createTelemetryManager({
+			sessionId: instance.instanceId,
+			getClient: () => getClient(instance, { apiVersion: "2024-11-12" }),
+			projectId,
+			environment
+		}), consented = await manager.checkConsent();
+		if (logger.debug("consent check complete", { consented }), !consented || instance.isDisposed()) {
+			initInFlight.delete(instance), manager.dispose();
+			return;
+		}
+		initInFlight.delete(instance), telemetryManagers.set(instance, manager);
+		let buffered = pendingHooks.get(instance);
+		if (buffered) {
+			logger.debug("flushing buffered hooks", { hooks: Array.from(buffered) });
+			for (let hookName of buffered) manager.logHookFirstUsed(hookName);
+			pendingHooks.delete(instance);
+		}
+		let config = instance.config, perspective = typeof config.perspective == "string" ? config.perspective : "published", authMethod = config.auth?.token ? "token" : config.studio?.auth?.token ? "studio" : "default";
+		logger.info("telemetry session started", {
+			projectId,
+			perspective,
+			authMethod,
+			environment
+		}), manager.logSessionStarted({
+			projectId,
+			perspective,
+			authMethod
+		}), instance.onDispose(() => {
+			manager.endSession(), telemetryManagers.delete(instance), logger.debug("telemetry session ended");
+		});
+	}).catch((err) => {
+		initInFlight.delete(instance), logger.warn("telemetry init failed", { error: err });
+	}));
+}
+/**
+* Retrieves the telemetry manager for an instance, if one exists.
+* Returns undefined when telemetry is disabled or not yet initialized.
+*
+* @internal
+*/
+function getTelemetryManager(instance) {
+	return telemetryManagers.get(instance);
+}
+/**
+* Record a hook name for an instance. If the telemetry manager is
+* already initialized the event is logged immediately. Otherwise
+* the name is buffered and flushed when init completes.
+*
+* @internal
+*/
+function trackHookMounted(instance, hookName) {
+	if (!getTelemetryEnvironment()) return;
+	let manager = findManager(instance);
+	if (manager) {
+		logger.trace("hook mounted (logged)", {
+			hookName,
+			internal: !0
+		}), manager.logHookFirstUsed(hookName);
+		return;
+	}
+	let root = getRootInstance(instance), hooks = pendingHooks.get(root);
+	hooks || (hooks = /* @__PURE__ */ new Set(), pendingHooks.set(root, hooks)), hooks.has(hookName) || logger.trace("hook mounted (buffered)", {
+		hookName,
+		internal: !0
+	}), hooks.add(hookName);
+}
+function findManager(instance) {
+	return telemetryManagers.get(instance);
+}
+function getRootInstance(instance) {
+	return instance;
+}
+const TOKEN_REGEX = /(?:[^\s"]+|"[^"]*")+/g;
+/**
+* @internal
+* Checks if a token starts with the negation character.
+*/
+function isNegationToken(token) {
+	return token !== void 0 && token.trim().startsWith("-");
+}
+/**
+* @internal
+* Checks if a token ends with the wildcard character.
+*/
+function isPrefixToken(token) {
+	return token !== void 0 && token.trim().endsWith("*");
+}
+/**
+* @internal
+* Checks if a token is enclosed in double quotes.
+*/
+function isExactMatchToken(token) {
+	return !!token && token.length >= 2 && token.startsWith("\"") && token.endsWith("\"");
+}
+/**
+* Creates a GROQ search filter string (`[@] match text::query("...")`)
+* from a raw search query string.
+*
+* It applies wildcard ('*') logic to the last eligible token and escapes
+* double quotes within the search term.
+*
+* If the input query is empty or only whitespace, it returns an empty string.
+*
+* @param query - The raw input search string.
+* @returns The GROQ search filter string, or an empty string.
+* @internal
+*/
+function createGroqSearchFilter(query) {
+	let trimmedQuery = query.trim();
+	if (!trimmedQuery) return "";
+	let tokens = trimmedQuery.match(TOKEN_REGEX) ?? [], reversedIndex = [...tokens].reverse().findIndex((token) => !isNegationToken(token) && !isExactMatchToken(token)), finalIncrementalTokenIndex = reversedIndex === -1 ? -1 : tokens.length - 1 - reversedIndex, finalIncrementalToken = tokens[finalIncrementalTokenIndex], processedTokens = [...tokens];
+	return finalIncrementalToken !== void 0 && !isPrefixToken(finalIncrementalToken) && processedTokens.splice(finalIncrementalTokenIndex, 1, `${finalIncrementalToken}*`), `[@] match text::query("${processedTokens.join(" ").replace(/"/g, "\\\"")}")`;
+}
+export { PREVIEW_PROJECTION, createGroqSearchFilter, defineFetcher, defineMutation, getClientErrorApiBody, getClientErrorApiDescription, getClientErrorApiType, getCommentsOptionsKey, getQueryKey, getTelemetryManager, getUsersKey, initTelemetry, isDeepEqual, isProjectUserNotFoundClientError, isStudioConfig, parseCommentsOptionsKey, parseQueryKey, parseUsersKey, pickProperties, trackHookMounted, transformProjectionToPreview };
+
+//# sourceMappingURL=_internal.js.map

package/dist/_exports/_internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"_internal.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}
+{"version":3,"file":"_internal.js","names":[],"sources":["../../src/preview/previewConstants.ts","../../src/preview/previewProjectionUtils.ts","../../src/telemetry/environment.ts","../../src/telemetry/initTelemetry.ts","../../src/utils/createGroqSearchFilter.ts"],"sourcesContent":["/**\n * The fields to check for a title.\n * The order of the items in the array defines the priority.\n *\n * @internal\n */\nexport const TITLE_CANDIDATES = ['title', 'name', 'label', 'heading', 'header', 'caption']\n\n/**\n * The fields to check for a subtitle.\n * The order of the items in the array defines the priority.\n *\n * @internal\n */\nexport const SUBTITLE_CANDIDATES = ['description', 'subtitle', ...TITLE_CANDIDATES]\n\n/**\n * Generates a GROQ projection for preview data without requiring a schema.\n * Uses common field names to make educated guesses about which fields to use.\n *\n * @internal\n */\nexport const PREVIEW_PROJECTION = `{\n  // Get all potential title fields\n  \"titleCandidates\": {\n    ${TITLE_CANDIDATES.map((field) => `\"${field}\": ${field}`).join(',\\n      ')}\n  },\n  // Get all potential subtitle fields\n  \"subtitleCandidates\": {\n    ${SUBTITLE_CANDIDATES.map((field) => `\"${field}\": ${field}`).join(',\\n      ')}\n  },\n  \"media\": coalesce(\n    select(\n      defined(asset) => {\"type\": \"image-asset\", \"_ref\": asset._ref},\n      defined(image.asset) => {\"type\": \"image-asset\", \"_ref\": image.asset._ref},\n      defined(mainImage.asset) => {\"type\": \"image-asset\", \"_ref\": mainImage.asset._ref},\n      null\n    )\n  ),\n  _type,\n  _id,\n  _updatedAt\n}`\n","import {type SanityClient} from '@sanity/client'\nimport {createImageUrlBuilder} from '@sanity/image-url'\n\nimport {getClient} from '../client/clientStore'\nimport {type DocumentResource} from '../config/sanityConfig'\nimport {type SanityInstance} from '../store/createSanityInstance'\nimport {isObject} from '../utils/object'\nimport {SUBTITLE_CANDIDATES, TITLE_CANDIDATES} from './previewConstants'\nimport {type PreviewQueryResult, type PreviewValue} from './types'\n\nconst API_VERSION = 'v2025-05-06'\n\n/**\n * Checks if the provided value has `_ref` property that is a string and starts with `image-`\n */\nfunction hasImageRef<T>(value: unknown): value is T & {_ref: string} {\n  return isObject(value) && '_ref' in value && typeof (value as {_ref: unknown})._ref === 'string'\n}\n\n/**\n * Normalizes a media asset to a preview value.\n * Adds a url to a media asset reference using `@sanity/image-url`.\n *\n * @internal\n */\nexport function normalizeMedia(media: unknown, client: SanityClient): PreviewValue['media'] {\n  if (!media) return null\n  if (!hasImageRef(media)) return null\n\n  const builder = createImageUrlBuilder(client)\n  const url = builder.image({_ref: media._ref}).url()\n\n  return {\n    type: 'image-asset',\n    _ref: media._ref,\n    url,\n  }\n}\n\n/**\n * Finds a single field value from a set of candidates based on a priority list of field names.\n * Returns the first non-empty string value found from the candidates matching the priority list order.\n *\n * @internal\n */\nfunction findFirstDefined(\n  fieldsToSearch: string[],\n  candidates: Record<string, unknown>,\n  exclude?: unknown,\n): string | undefined {\n  if (!candidates) return undefined\n\n  for (const field of fieldsToSearch) {\n    const value = candidates[field]\n    if (typeof value === 'string' && value.trim() !== '' && value !== exclude) {\n      return value\n    }\n  }\n\n  return undefined\n}\n\n/**\n * Transforms a projection result (with titleCandidates, subtitleCandidates, media)\n * into a PreviewValue (with title, subtitle, media).\n *\n * @param projectionResult - The raw projection result from GROQ\n * @param instance - The Sanity instance to use for client configuration\n * @param resource - Data resource for the preview\n * @internal\n */\nexport function transformProjectionToPreview(\n  instance: SanityInstance,\n  projectionResult: PreviewQueryResult,\n  resource?: DocumentResource,\n): PreviewValue {\n  const title = findFirstDefined(TITLE_CANDIDATES, projectionResult.titleCandidates)\n  const subtitle = findFirstDefined(SUBTITLE_CANDIDATES, projectionResult.subtitleCandidates, title)\n\n  // Get a client for the resource (if provided) or use the instance config\n  const client = getClient(instance, {\n    apiVersion: API_VERSION,\n    resource,\n  })\n\n  return {\n    title: String(title || `${projectionResult._type}: ${projectionResult._id}`),\n    subtitle: subtitle || undefined,\n    media: normalizeMedia(projectionResult.media, client),\n    ...(projectionResult._status && {_status: projectionResult._status}),\n  }\n}\n","/**\n * Telemetry environment classification.\n *\n * - `'development'` — the SDK is running on the local developer's machine\n *   (`localhost` / `127.0.0.1` in the browser, or `NODE_ENV=development`\n *   in Node). These are the original dev-only telemetry sessions.\n *\n * - `'production'` — the SDK is running on a production Sanity-controlled\n *   domain (Studio deployments on `*.sanity.studio`, the dashboard on\n *   `*.sanity.io`) where end users are authenticated Sanity users with\n *   Populus consent records. Production telemetry is gated to this\n *   allowlist; SDK apps deployed to customer-controlled domains do not\n *   emit telemetry. Staging (`*.sanity.work`) and preview\n *   (`*.sanity.dev`) hosts are deliberately excluded.\n *\n * @internal\n */\nexport type TelemetryEnvironment = 'development' | 'production'\n\n/**\n * Hostname suffixes that count as Sanity-controlled for the purposes of\n * production telemetry. A user reaching one of these hosts in the\n * browser is authenticated against Sanity and has a Populus consent\n * record, so we apply the same telemetry rules as the Studio's\n * `telemetry-sink`.\n *\n * The leading `.` is required: it ensures suffix matches hit a real\n * subdomain boundary, so apex matches (`sanity.io`, `sanity.studio`)\n * and lookalikes (`evilsanity.studio`) are excluded. Only production\n * hosts are listed; staging (`*.sanity.work`) and preview\n * (`*.sanity.dev`) hosts are excluded by omission.\n *\n * @internal\n */\nconst SANITY_CONTROLLED_HOST_SUFFIXES = ['.sanity.studio', '.sanity.io'] as const\n\nfunction getBrowserHostname(win: Window): string | null {\n  const hostname = win.location?.hostname\n  return typeof hostname === 'string' && hostname.length > 0 ? hostname.toLowerCase() : null\n}\n\nfunction isLocalHostname(hostname: string): boolean {\n  return hostname === 'localhost' || hostname === '127.0.0.1'\n}\n\nfunction isSanityControlledHostname(hostname: string): boolean {\n  return SANITY_CONTROLLED_HOST_SUFFIXES.some((suffix) => hostname.endsWith(suffix))\n}\n\n/**\n * Returns the telemetry environment for the current runtime, or `null`\n * when telemetry should not run at all.\n *\n * Browser:\n * - `localhost` / `127.0.0.1` → `'development'`\n * - host matches the Sanity-controlled allowlist → `'production'`\n * - anything else (customer domains, unknown contexts) → `null`\n *\n * Node (scripts, SSR, tests):\n * - `NODE_ENV=development` → `'development'`\n * - otherwise → `null`. Production-side server runtimes don't carry the\n *   browser-authenticated user/consent assumption, so we don't enable\n *   them under the production gate.\n *\n * Bracket-notation `process.env['NODE_ENV']` is used to avoid bundler\n * dead-code replacement.\n *\n * @internal\n */\nexport function getTelemetryEnvironment(): TelemetryEnvironment | null {\n  if (typeof window !== 'undefined') {\n    const hostname = getBrowserHostname(window)\n    if (!hostname) return null\n    if (isLocalHostname(hostname)) return 'development'\n    if (isSanityControlledHostname(hostname)) return 'production'\n    return null\n  }\n\n  if (typeof process !== 'undefined' && process.env?.['NODE_ENV'] === 'development') {\n    return 'development'\n  }\n  return null\n}\n\n/**\n * Convenience predicate for \"telemetry can run in this environment\".\n *\n * @internal\n */\nexport function isTelemetryEnabled(): boolean {\n  return getTelemetryEnvironment() !== null\n}\n","import {type SanityInstance} from '../store/createSanityInstance'\nimport {createLogger} from '../utils/logger'\nimport {getTelemetryEnvironment} from './environment'\nimport {type TelemetryManager} from './telemetryManager'\n\nconst DEFAULT_TELEMETRY_API_VERSION = '2024-11-12'\n\nconst logger = createLogger('telemetry')\n\n/**\n * Per-instance map of active telemetry managers. Allows the React\n * package (and other consumers) to look up the manager for a given\n * instance and log hook usage / errors without importing the full\n * telemetry module themselves.\n *\n * @internal\n */\nconst telemetryManagers = new WeakMap<SanityInstance, TelemetryManager>()\nconst pendingHooks = new WeakMap<SanityInstance, Set<string>>()\nconst initInFlight = new WeakSet<SanityInstance>()\n\n/**\n * Initializes telemetry for a SDK instance if the runtime environment\n * qualifies. The environment is resolved by `getTelemetryEnvironment()`:\n *\n * - `'development'` — local dev servers (`localhost` / `127.0.0.1`, or\n *   Node with `NODE_ENV=development`). This is the original opt-in\n *   surface.\n * - `'production'` — apps deployed to Sanity-controlled domains\n *   (e.g. `*.sanity.studio`, the dashboard). End users are\n *   authenticated Sanity users with Populus consent records, so we\n *   apply the same consent gate as the Studio's `telemetry-sink`.\n *\n * Apps on customer-controlled domains return `null` and skip telemetry\n * entirely.\n *\n * `telemetryManager` and `clientStore` are dynamically imported so the\n * telemetry code path stays out of production bundles for apps that\n * don't qualify. Only the lightweight environment check runs at boot.\n *\n * The `projectId` must be passed explicitly because the resource\n * configuration is typically set by the React layer after the\n * instance has already been created.\n *\n * @internal\n */\nexport function initTelemetry(instance: SanityInstance, projectId: string): void {\n  const environment = getTelemetryEnvironment()\n  if (!environment) {\n    logger.trace('initTelemetry skipped: environment not eligible', {internal: true})\n    return\n  }\n  if (!projectId) {\n    logger.trace('initTelemetry skipped: no projectId', {internal: true})\n    return\n  }\n  if (telemetryManagers.has(instance) || initInFlight.has(instance)) {\n    return\n  }\n  initInFlight.add(instance)\n\n  logger.debug('initializing telemetry', {projectId, environment})\n\n  Promise.all([\n    import('./telemetryManager'),\n    import('../client/clientStore'),\n    import('../auth/authStore'),\n  ])\n    .then(async ([{createTelemetryManager}, {getClient}, {getTokenState}]) => {\n      if (instance.isDisposed()) {\n        initInFlight.delete(instance)\n        logger.debug('telemetry skipped: instance disposed before imports resolved')\n        return\n      }\n\n      // Wait for the auth store to resolve a token. The client needs a\n      // Bearer token for the consent check and batch POSTs. If the token\n      // is already available (e.g. static token config), this resolves\n      // immediately. For OAuth/localStorage discovery it waits for the\n      // first emission. For unauthenticated apps the promise never\n      // resolves, which is fine since telemetry requires auth anyway.\n      const token = getTokenState(instance).getCurrent()\n      logger.trace('auth token check', {tokenPresent: !!token, internal: true})\n\n      if (!token) {\n        logger.debug('waiting for auth token')\n        const hasToken = await new Promise<boolean>((resolve) => {\n          if (instance.isDisposed()) return resolve(false)\n          const cleanup = {unsubscribe: () => {}}\n          const unsub = instance.onDispose(() => {\n            cleanup.unsubscribe()\n            resolve(false)\n          })\n          // The token observable is a `shareReplay({bufferSize: 1, refCount: true})`\n          // (see `createStateSourceAction`), so it can deliver a buffered value\n          // synchronously while we're still inside `.subscribe(cb)`. At that\n          // moment `sub` is in the TDZ, so the callback can't reach it. We\n          // gate on a `received` flag and let the post-subscribe block do the\n          // unsubscribe in the sync-emission case.\n          let received = false\n          const sub = getTokenState(instance).observable.subscribe((t) => {\n            if (received || !t) return\n            received = true\n            logger.debug('auth token received')\n            unsub()\n            resolve(true)\n            cleanup.unsubscribe()\n          })\n          cleanup.unsubscribe = () => sub.unsubscribe()\n          if (received) cleanup.unsubscribe()\n        })\n        if (!hasToken || instance.isDisposed()) {\n          initInFlight.delete(instance)\n          logger.debug('telemetry skipped: no token resolved or instance disposed')\n          return\n        }\n      }\n\n      const manager = createTelemetryManager({\n        sessionId: instance.instanceId,\n        getClient: () => getClient(instance, {apiVersion: DEFAULT_TELEMETRY_API_VERSION}),\n        projectId,\n        environment,\n      })\n\n      const consented = await manager.checkConsent()\n      logger.debug('consent check complete', {consented})\n      if (!consented || instance.isDisposed()) {\n        initInFlight.delete(instance)\n        manager.dispose()\n        return\n      }\n\n      initInFlight.delete(instance)\n      telemetryManagers.set(instance, manager)\n\n      const buffered = pendingHooks.get(instance)\n      if (buffered) {\n        logger.debug('flushing buffered hooks', {hooks: Array.from(buffered)})\n        for (const hookName of buffered) {\n          manager.logHookFirstUsed(hookName)\n        }\n        pendingHooks.delete(instance)\n      }\n\n      const config = instance.config\n      const perspective = typeof config.perspective === 'string' ? config.perspective : 'published'\n      const authMethod = config.auth?.token\n        ? 'token'\n        : config.studio?.auth?.token\n          ? 'studio'\n          : 'default'\n\n      logger.info('telemetry session started', {projectId, perspective, authMethod, environment})\n      manager.logSessionStarted({\n        projectId,\n        perspective,\n        authMethod,\n      })\n\n      instance.onDispose(() => {\n        manager.endSession()\n        telemetryManagers.delete(instance)\n        logger.debug('telemetry session ended')\n      })\n    })\n    .catch((err) => {\n      initInFlight.delete(instance)\n      logger.warn('telemetry init failed', {error: err})\n    })\n}\n\n/**\n * Retrieves the telemetry manager for an instance, if one exists.\n * Returns undefined when telemetry is disabled or not yet initialized.\n *\n * @internal\n */\nexport function getTelemetryManager(instance: SanityInstance): TelemetryManager | undefined {\n  return telemetryManagers.get(instance)\n}\n\n/**\n * Record a hook name for an instance. If the telemetry manager is\n * already initialized the event is logged immediately. Otherwise\n * the name is buffered and flushed when init completes.\n *\n * @internal\n */\nexport function trackHookMounted(instance: SanityInstance, hookName: string): void {\n  if (!getTelemetryEnvironment()) return\n\n  const manager = findManager(instance)\n  if (manager) {\n    logger.trace('hook mounted (logged)', {hookName, internal: true})\n    manager.logHookFirstUsed(hookName)\n    return\n  }\n\n  const root = getRootInstance(instance)\n  let hooks = pendingHooks.get(root)\n  if (!hooks) {\n    hooks = new Set()\n    pendingHooks.set(root, hooks)\n  }\n  if (!hooks.has(hookName)) {\n    logger.trace('hook mounted (buffered)', {hookName, internal: true})\n  }\n  hooks.add(hookName)\n}\n\nfunction findManager(instance: SanityInstance): TelemetryManager | undefined {\n  return telemetryManagers.get(instance)\n}\n\nfunction getRootInstance(instance: SanityInstance): SanityInstance {\n  return instance\n}\n","const WILDCARD_TOKEN = '*'\nconst NEGATION_TOKEN = '-'\n// This regex handles simple cases including quoted phrases.\n// More complex query syntaxes might need a more robust parser.\nconst TOKEN_REGEX = /(?:[^\\s\"]+|\"[^\"]*\")+/g\n\n/**\n * @internal\n * Checks if a token starts with the negation character.\n */\nfunction isNegationToken(token: string | undefined): boolean {\n  return typeof token !== 'undefined' && token.trim().startsWith(NEGATION_TOKEN)\n}\n\n/**\n * @internal\n * Checks if a token ends with the wildcard character.\n */\nfunction isPrefixToken(token: string | undefined): boolean {\n  return typeof token !== 'undefined' && token.trim().endsWith(WILDCARD_TOKEN)\n}\n\n/**\n * @internal\n * Checks if a token is enclosed in double quotes.\n */\nfunction isExactMatchToken(token: string | undefined): boolean {\n  // Ensure the token exists, has at least 2 characters, and starts/ends with \"\n  return !!token && token.length >= 2 && token.startsWith('\"') && token.endsWith('\"')\n}\n\n/**\n * Creates a GROQ search filter string (`[@] match text::query(\"...\")`)\n * from a raw search query string.\n *\n * It applies wildcard ('*') logic to the last eligible token and escapes\n * double quotes within the search term.\n *\n * If the input query is empty or only whitespace, it returns an empty string.\n *\n * @param query - The raw input search string.\n * @returns The GROQ search filter string, or an empty string.\n * @internal\n */\nexport function createGroqSearchFilter(query: string): string {\n  // Trim leading/trailing whitespace from the overall query first\n  const trimmedQuery = query.trim()\n  if (!trimmedQuery) {\n    return '' // Return empty if query is empty or just whitespace\n  }\n\n  // Extract tokens using the regex\n  const tokens = trimmedQuery.match(TOKEN_REGEX) ?? []\n\n  // Find the index of the last token eligible for wildcard appending\n  const reversedTokens = [...tokens].reverse()\n  const reversedIndex = reversedTokens.findIndex(\n    (token: string) => !isNegationToken(token) && !isExactMatchToken(token),\n  )\n  const finalIncrementalTokenIndex = reversedIndex === -1 ? -1 : tokens.length - 1 - reversedIndex\n\n  // Get the actual token based on the found index\n  const finalIncrementalToken = tokens[finalIncrementalTokenIndex]\n\n  const processedTokens = [...tokens]\n  // If a suitable token was found and it doesn't already end with a wildcard,\n  // apply the wildcard.\n  if (finalIncrementalToken !== undefined && !isPrefixToken(finalIncrementalToken)) {\n    // Replace the identified token with its wildcarded version\n    processedTokens.splice(\n      finalIncrementalTokenIndex,\n      1,\n      `${finalIncrementalToken}${WILDCARD_TOKEN}`,\n    )\n  }\n\n  // Join the tokens back into a space-separated string\n  const wildcardSearch = processedTokens.join(' ')\n\n  // Escape double quotes within the final search term for the GROQ query\n  const escapedSearch = wildcardSearch.replace(/\"/g, '\\\\\"')\n\n  // Construct the final GROQ filter clause\n  return `[@] match text::query(\"${escapedSearch}\")`\n}\n"],"mappings":"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"}

package/dist/_exports/agent.d.ts

@@ -0,0 +1,65 @@
+import { s as DocumentResource, t as SanityInstance } from "../createSanityInstance-DUI1bGIg.js";
+import { SanityClient } from "@sanity/client";
+import { Observable } from "rxjs";
+/** @alpha */
+type AgentGenerateOptions = Parameters<SanityClient['observable']['agent']['action']['generate']>[0];
+/** @alpha */
+type AgentTransformOptions = Parameters<SanityClient['observable']['agent']['action']['transform']>[0];
+/** @alpha */
+type AgentTranslateOptions = Parameters<SanityClient['observable']['agent']['action']['translate']>[0];
+/** @alpha */
+type AgentPromptOptions = Parameters<SanityClient['agent']['action']['prompt']>[0];
+/** @alpha */
+type AgentPatchOptions = Parameters<SanityClient['agent']['action']['patch']>[0];
+/** @alpha */
+type AgentGenerateResult = Awaited<ReturnType<SanityClient['observable']['agent']['action']['generate']>>;
+/** @alpha */
+type AgentTransformResult = Awaited<ReturnType<SanityClient['observable']['agent']['action']['transform']>>;
+/** @alpha */
+type AgentTranslateResult = Awaited<ReturnType<SanityClient['observable']['agent']['action']['translate']>>;
+/** @alpha */
+type AgentPromptResult = Awaited<ReturnType<SanityClient['agent']['action']['prompt']>>;
+/** @alpha */
+type AgentPatchResult = Awaited<ReturnType<SanityClient['agent']['action']['patch']>>;
+/**
+ * Generates a new document using the agent.
+ * @param instance - The Sanity instance.
+ * @param options - The options for the agent generate action. See the [Agent Actions API](https://www.sanity.io/docs/agent-actions/introduction) for more details.
+ * @returns An Observable emitting the result of the agent generate action.
+ * @alpha
+ */
+declare function agentGenerate(instance: SanityInstance, options: AgentGenerateOptions, resource?: DocumentResource): AgentGenerateResult;
+/**
+ * Transforms a document using the agent.
+ * @param instance - The Sanity instance.
+ * @param options - The options for the agent transform action. See the [Agent Actions API](https://www.sanity.io/docs/agent-actions/introduction) for more details.
+ * @returns An Observable emitting the result of the agent transform action.
+ * @alpha
+ */
+declare function agentTransform(instance: SanityInstance, options: AgentTransformOptions, resource?: DocumentResource): AgentTransformResult;
+/**
+ * Translates a document using the agent.
+ * @param instance - The Sanity instance.
+ * @param options - The options for the agent translate action. See the [Agent Actions API](https://www.sanity.io/docs/agent-actions/introduction) for more details.
+ * @returns An Observable emitting the result of the agent translate action.
+ * @alpha
+ */
+declare function agentTranslate(instance: SanityInstance, options: AgentTranslateOptions, resource?: DocumentResource): AgentTranslateResult;
+/**
+ * Prompts the agent using the same instruction template format as the other actions, but returns text or json instead of acting on a document.
+ * @param instance - The Sanity instance.
+ * @param options - The options for the agent prompt action. See the [Agent Actions API](https://www.sanity.io/docs/agent-actions/introduction) for more details.
+ * @returns An Observable emitting the result of the agent prompt action.
+ * @alpha
+ */
+declare function agentPrompt(instance: SanityInstance, options: AgentPromptOptions, resource?: DocumentResource): Observable<AgentPromptResult>;
+/**
+ * Patches a document using the agent.
+ * @param instance - The Sanity instance.
+ * @param options - The options for the agent patch action. See the [Agent Actions API](https://www.sanity.io/docs/agent-actions/introduction) for more details.
+ * @returns An Observable emitting the result of the agent patch action.
+ * @alpha
+ */
+declare function agentPatch(instance: SanityInstance, options: AgentPatchOptions, resource?: DocumentResource): Observable<AgentPatchResult>;
+export { type AgentGenerateOptions, type AgentGenerateResult, type AgentPatchOptions, type AgentPatchResult, type AgentPromptOptions, type AgentPromptResult, type AgentTransformOptions, type AgentTransformResult, type AgentTranslateOptions, type AgentTranslateResult, agentGenerate, agentPatch, agentPrompt, agentTransform, agentTranslate };
+//# sourceMappingURL=agent.d.ts.map

package/dist/_exports/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","names":[],"sources":["../../src/agent/agentActions.ts"],"mappings":";;;;KAUY,uBAAuB,WACjC;;KAIU,wBAAwB,WAClC;;KAIU,wBAAwB,WAClC;;KAIU,qBAAqB,WAAW;;KAGhC,oBAAoB,WAAW;;KAG/B,sBAAsB,QAChC,WAAW;;KAID,uBAAuB,QACjC,WAAW;;KAID,uBAAuB,QACjC,WAAW;;KAID,oBAAoB,QAAQ,WAAW;;KAGvC,mBAAmB,QAAQ,WAAW;;;;;;;;iBASlC,cACd,UAAU,gBACV,SAAS,sBACT,WAAW,mBACV;;;;;;;;iBAaa,eACd,UAAU,gBACV,SAAS,uBACT,WAAW,mBACV;;;;;;;;iBAaa,eACd,UAAU,gBACV,SAAS,uBACT,WAAW,mBACV;;;;;;;;iBAaa,YACd,UAAU,gBACV,SAAS,oBACT,WAAW,mBACV,WAAW;;;;;;;;iBAaE,WACd,UAAU,gBACV,SAAS,mBACT,WAAW,mBACV,WAAW"}