@sanity/sdk 2.3.1 → 2.4.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _sanity_client12 from "@sanity/client";
-import { ClientConfig, ClientPerspective, ListenEvent, ResponseQueryOptions, SanityClient, SanityDocument as SanityDocument$1, SanityProject as SanityProject$1, StackablePerspective } from "@sanity/client";
+import { ClientConfig, ClientError, ClientPerspective, ListenEvent, ResponseQueryOptions, SanityClient, SanityDocument as SanityDocument$1, SanityProject as SanityProject$1, StackablePerspective } from "@sanity/client";
 import { Observable, Subject } from "rxjs";
 import { CurrentUser, CurrentUser as CurrentUser$1, Mutation, PatchOperations, Role, SanityDocument, SanityDocument as SanityDocument$2, SanityDocumentLike } from "@sanity/types";
 import * as _sanity_comlink3 from "@sanity/comlink";
@@ -9,17 +9,6 @@ import { SanityDocument as SanityDocument$3, SanityProjectionResult, SanityQuery
 import { ExprNode } from "groq-js";
 import { CanvasResource, MediaResource, StudioResource } from "@sanity/message-protocol";
 import { getIndexForKey, getPathDepth, joinPaths, jsonMatch, slicePath, stringifyPath } from "@sanity/json-match";
-/**
- * Represents the various states the authentication type can be in.
- *
- * @public
- */
-declare enum AuthStateType {
-  LOGGED_IN = "logged-in",
-  LOGGING_IN = "logging-in",
-  ERROR = "error",
-  LOGGED_OUT = "logged-out",
-}
 /**
  * Configuration for an authentication provider
  * @public
@@ -150,6 +139,39 @@ interface SanityConfig extends DatasetHandle, PerspectiveHandle {
     enabled: boolean;
   };
 }
+declare const SOURCE_ID = "__sanity_internal_sourceId";
+/**
+ * A document source can be used for querying.
+ *
+ * @beta
+ * @see datasetSource Construct a document source for a given projectId and dataset.
+ * @see mediaLibrarySource Construct a document source for a mediaLibraryId.
+ * @see canvasSource Construct a document source for a canvasId.
+ */
+type DocumentSource = {
+  [SOURCE_ID]: ['media-library', string] | ['canvas', string] | {
+    projectId: string;
+    dataset: string;
+  };
+};
+/**
+ * Returns a document source for a projectId and dataset.
+ *
+ * @beta
+ */
+declare function datasetSource(projectId: string, dataset: string): DocumentSource;
+/**
+ * Returns a document source for a Media Library.
+ *
+ * @beta
+ */
+declare function mediaLibrarySource(id: string): DocumentSource;
+/**
+ * Returns a document source for a Canvas.
+ *
+ * @beta
+ */
+declare function canvasSource(id: string): DocumentSource;
 /**
  * Represents a Sanity.io resource instance with its own configuration and lifecycle
  * @remarks Instances form a hierarchy through parent/child relationships
@@ -211,6 +233,77 @@ interface SanityInstance {
  * @public
  */
 declare function createSanityInstance(config?: SanityConfig): SanityInstance;
+/** @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): 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): 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): 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): 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): Observable<AgentPatchResult>;
+/**
+ * Represents the various states the authentication type can be in.
+ *
+ * @public
+ */
+declare enum AuthStateType {
+  LOGGED_IN = "logged-in",
+  LOGGING_IN = "logging-in",
+  ERROR = "error",
+  LOGGED_OUT = "logged-out",
+}
 /**
  * Represents a store action that has been bound to a specific store instance
  */
@@ -374,6 +467,24 @@ declare const handleAuthCallback: BoundStoreAction<AuthStoreState, [locationHref
  * @public
  */
 declare const logout: BoundStoreAction<AuthStoreState, [], Promise<void>>;
+/** @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;
 type AllowedClientConfigKey = 'useCdn' | 'token' | 'perspective' | 'apiHost' | 'proxy' | 'withCredentials' | 'timeout' | 'maxRetries' | 'dataset' | 'projectId' | 'requestTagPrefix' | 'useProjectHostname';
 /**
  * States tracked by the client store
@@ -415,6 +526,10 @@ interface ClientOptions extends Pick<ClientConfig, AllowedClientConfigKey> {
    * @internal
    */
   '~experimental_resource'?: ClientConfig['~experimental_resource'];
+  /**
+   * @internal
+   */
+  'source'?: DocumentSource;
 }
 /**
  * Retrieves a Sanity client instance configured with the provided options.
@@ -596,6 +711,12 @@ declare const resolveDatasets: BoundStoreAction<FetcherStoreState<[options?: Pro
  */
 interface CreateDocumentAction<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentTypeHandle<TDocumentType, TDataset, TProjectId> {
   type: 'document.create';
+  /**
+   * Optional initial field values for the document.
+   * These values will be set when the document is created.
+   * System fields (_id, _type, _rev, _createdAt, _updatedAt) are omitted as they are set automatically.
+   */
+  initialValue?: Partial<Omit<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`>, '_id' | '_type' | '_rev' | '_createdAt' | '_updatedAt'>>;
 }
 /**
  * Represents an action to delete an existing document.
@@ -646,10 +767,11 @@ type DocumentAction<TDocumentType extends string = string, TDataset extends stri
 /**
  * Creates a `CreateDocumentAction` object.
  * @param doc - A handle identifying the document type, dataset, and project. An optional `documentId` can be provided.
+ * @param initialValue - Optional initial field values for the document. (System fields are omitted as they are set automatically.)
  * @returns A `CreateDocumentAction` object ready for dispatch.
  * @beta
  */
-declare function createDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentTypeHandle<TDocumentType, TDataset, TProjectId>): CreateDocumentAction<TDocumentType, TDataset, TProjectId>;
+declare function createDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentTypeHandle<TDocumentType, TDataset, TProjectId>, initialValue?: Partial<Omit<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`>, '_id' | '_type' | '_rev' | '_createdAt' | '_updatedAt'>>): CreateDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
  * Creates a `DeleteDocumentAction` object.
  * @param doc - A handle uniquely identifying the document to be deleted.
@@ -1494,6 +1616,7 @@ declare const resolveProjects: BoundStoreAction<FetcherStoreState<[options?: {
 interface QueryOptions<TQuery extends string = string, TDataset extends string = string, TProjectId extends string = string> extends Pick<ResponseQueryOptions, 'useCdn' | 'cache' | 'next' | 'cacheMode' | 'tag'>, DatasetHandle<TDataset, TProjectId> {
   query: TQuery;
   params?: Record<string, unknown>;
+  source?: DocumentSource;
 }
 /**
  * @beta
@@ -1579,7 +1702,7 @@ declare const getActiveReleasesState: BoundStoreAction<ReleasesStoreState, [], S
  *
  * @public
  */
-declare const getPerspectiveState: BoundStoreAction<ReleasesStoreState, [options?: PerspectiveHandle | undefined], StateSource<string[] | "previewDrafts" | "published" | "drafts" | "raw" | undefined>>;
+declare const getPerspectiveState: BoundStoreAction<ReleasesStoreState, [options?: PerspectiveHandle | undefined], StateSource<string[] | "raw" | "previewDrafts" | "published" | "drafts" | undefined>>;
 /** @internal */
 declare const getUsersKey: (instance: SanityInstance, {
   resourceType,
@@ -1609,7 +1732,7 @@ declare const parseUsersKey: (key: string) => {
  *
  * @beta
  */
-declare const getUsersState: BoundStoreAction<UsersStoreState, [options?: GetUsersOptions], StateSource<{
+declare const getUsersState: BoundStoreAction<UsersStoreState, [options?: GetUsersOptions | undefined], StateSource<{
   data: SanityUser[];
   totalCount: number;
   hasMore: boolean;
@@ -1658,7 +1781,7 @@ declare const getUserState: BoundStoreAction<UsersStoreState, [GetUserOptions],
 /**
  * @beta
  */
-declare const resolveUser: BoundStoreAction<UsersStoreState, [ResolveUserOptions], Promise<SanityUser | undefined>>;
+declare const resolveUser: BoundStoreAction<UsersStoreState, [ResolveUserOptions], Promise<SanityUser>>;
 interface StoreEntry<TParams extends unknown[], TData> {
   params: TParams;
   instance: SanityInstance;
@@ -1870,4 +1993,4 @@ declare const CORE_SDK_VERSION: {};
  * @public
  */
 type SanityProject = SanityProject$1;
-export { type ActionErrorEvent, type ActionsResult, type ApplyDocumentActionsOptions, type AuthConfig, type AuthProvider, type AuthState, AuthStateType, type AuthStoreState, CORE_SDK_VERSION, type ClientOptions, type ClientStoreState as ClientState, type ComlinkControllerState, type ComlinkNodeState, type CreateDocumentAction, type CurrentUser, type DatasetHandle, type DeleteDocumentAction, type DiscardDocumentAction, type DisconnectEvent, type DocumentAction, type DocumentCreatedEvent, type DocumentDeletedEvent, type DocumentDiscardedEvent, type DocumentEditedEvent, type DocumentEvent, type DocumentHandle, type DocumentOptions, type DocumentPermissionsResult, type DocumentPublishedEvent, type DocumentTypeHandle, type DocumentUnpublishedEvent, type EditDocumentAction, type ErrorAuthState, type FavoriteStatusResponse, type FetcherStore, type FetcherStoreState, type FrameMessage, type GetPreviewStateOptions, type GetUserOptions, type GetUsersOptions, type Intent, type IntentFilter, type JsonMatch, type LoggedInAuthState, type LoggedOutAuthState, type LoggingInAuthState, type Membership, type NewTokenResponseMessage, type NodeState, type OrgVerificationResult, type PermissionDeniedReason, type PerspectiveHandle, type PresenceLocation, type PreviewStoreState, type PreviewValue, type ProjectHandle, type ProjectionValuePending, type PublishDocumentAction, type QueryOptions, type ReleaseDocument, type ReleasePerspective, type RequestNewTokenMessage, type ResolvePreviewOptions, type ResolveUserOptions, type ResolveUsersOptions, type Role, type RollCallEvent, type SanityConfig, type SanityDocument, type SanityInstance, SanityProject, type SanityUser, type SanityUserResponse, type Selector, type StateEvent, type StateSource, type TransactionAcceptedEvent, type TransactionRevertedEvent, type TransportEvent, type UnpublishDocumentAction, type UserPresence, type UserProfile, type UsersGroupState, type UsersStoreState, type ValidProjection, type ValuePending, type WindowMessage, applyDocumentActions, createDatasetHandle, createDocument, createDocumentHandle, createDocumentTypeHandle, createGroqSearchFilter, createProjectHandle, createSanityInstance, defineIntent, deleteDocument, destroyController, discardDocument, editDocument, getActiveReleasesState, getAuthState, getClient, getClientState, getCorsErrorProjectId, getCurrentUserState, getDashboardOrganizationId, getDatasetsState, getDocumentState, getDocumentSyncStatus, getFavoritesState, getIndexForKey, getIsInDashboardState, getLoginUrlState, getNodeState, getOrCreateChannel, getOrCreateController, getOrCreateNode, getPathDepth, getPermissionsState, getPerspectiveState, getPresence, getPreviewState, getProjectState, getProjectionState, getProjectsState, getQueryKey, getQueryState, getTokenState, getUserState, getUsersKey, getUsersState, handleAuthCallback, joinPaths, jsonMatch, loadMoreUsers, logout, observeOrganizationVerificationState, parseQueryKey, parseUsersKey, publishDocument, releaseChannel, releaseNode, resolveDatasets, resolveDocument, resolveFavoritesState, resolvePermissions, resolvePreview, resolveProject, resolveProjection, resolveProjects, resolveQuery, resolveUser, resolveUsers, setAuthToken, slicePath, stringifyPath, subscribeDocumentEvents, unpublishDocument };
+export { type ActionErrorEvent, type ActionsResult, type AgentGenerateOptions, type AgentGenerateResult, type AgentPatchOptions, type AgentPatchResult, type AgentPromptOptions, type AgentPromptResult, type AgentTransformOptions, type AgentTransformResult, type AgentTranslateOptions, type AgentTranslateResult, type ApiErrorBody, type ApplyDocumentActionsOptions, type AuthConfig, type AuthProvider, type AuthState, AuthStateType, type AuthStoreState, CORE_SDK_VERSION, type ClientOptions, type ClientStoreState as ClientState, type ComlinkControllerState, type ComlinkNodeState, type CreateDocumentAction, type CurrentUser, type DatasetHandle, type DeleteDocumentAction, type DiscardDocumentAction, type DisconnectEvent, type DocumentAction, type DocumentCreatedEvent, type DocumentDeletedEvent, type DocumentDiscardedEvent, type DocumentEditedEvent, type DocumentEvent, type DocumentHandle, type DocumentOptions, type DocumentPermissionsResult, type DocumentPublishedEvent, type DocumentSource, type DocumentTypeHandle, type DocumentUnpublishedEvent, type EditDocumentAction, type ErrorAuthState, type FavoriteStatusResponse, type FetcherStore, type FetcherStoreState, type FrameMessage, type GetPreviewStateOptions, type GetUserOptions, type GetUsersOptions, type Intent, type IntentFilter, type JsonMatch, type LoggedInAuthState, type LoggedOutAuthState, type LoggingInAuthState, type Membership, type NewTokenResponseMessage, type NodeState, type OrgVerificationResult, type PermissionDeniedReason, type PerspectiveHandle, type PresenceLocation, type PreviewStoreState, type PreviewValue, type ProjectHandle, type ProjectionValuePending, type PublishDocumentAction, type QueryOptions, type ReleaseDocument, type ReleasePerspective, type RequestNewTokenMessage, type ResolvePreviewOptions, type ResolveUserOptions, type ResolveUsersOptions, type Role, type RollCallEvent, type SanityConfig, type SanityDocument, type SanityInstance, SanityProject, type SanityUser, type SanityUserResponse, type Selector, type StateEvent, type StateSource, type TransactionAcceptedEvent, type TransactionRevertedEvent, type TransportEvent, type UnpublishDocumentAction, type UserPresence, type UserProfile, type UsersGroupState, type UsersStoreState, type ValidProjection, type ValuePending, type WindowMessage, agentGenerate, agentPatch, agentPrompt, agentTransform, agentTranslate, applyDocumentActions, canvasSource, createDatasetHandle, createDocument, createDocumentHandle, createDocumentTypeHandle, createGroqSearchFilter, createProjectHandle, createSanityInstance, datasetSource, defineIntent, deleteDocument, destroyController, discardDocument, editDocument, getActiveReleasesState, getAuthState, getClient, getClientErrorApiBody, getClientErrorApiDescription, getClientErrorApiType, getClientState, getCorsErrorProjectId, getCurrentUserState, getDashboardOrganizationId, getDatasetsState, getDocumentState, getDocumentSyncStatus, getFavoritesState, getIndexForKey, getIsInDashboardState, getLoginUrlState, getNodeState, getOrCreateChannel, getOrCreateController, getOrCreateNode, getPathDepth, getPermissionsState, getPerspectiveState, getPresence, getPreviewState, getProjectState, getProjectionState, getProjectsState, getQueryKey, getQueryState, getTokenState, getUserState, getUsersKey, getUsersState, handleAuthCallback, isProjectUserNotFoundClientError, joinPaths, jsonMatch, loadMoreUsers, logout, mediaLibrarySource, observeOrganizationVerificationState, parseQueryKey, parseUsersKey, publishDocument, releaseChannel, releaseNode, resolveDatasets, resolveDocument, resolveFavoritesState, resolvePermissions, resolvePreview, resolveProject, resolveProjection, resolveProjects, resolveQuery, resolveUser, resolveUsers, setAuthToken, slicePath, stringifyPath, subscribeDocumentEvents, unpublishDocument };

package/dist/index.js

@@ -1,8 +1,8 @@
-import { createClient, CorsOriginError } from "@sanity/client";
 import { Observable, share, map, distinctUntilChanged, skip, filter, exhaustMap, from, timer, switchMap, takeWhile, firstValueFrom, fromEvent, EMPTY, defer, asapScheduler, combineLatest, of, concatMap, withLatestFrom, concat, throwError, first as first$1, Subject, takeUntil, partition, merge, shareReplay, tap as tap$1, catchError as catchError$1, startWith as startWith$1, pairwise as pairwise$1, groupBy as groupBy$1, mergeMap as mergeMap$1, throttle, race, NEVER, Subscription, retry, debounceTime as debounceTime$1 } from "rxjs";
+import { createClient, CorsOriginError } from "@sanity/client";
+import { pick, omit, isEqual, isObject } from "lodash-es";
 import { devtools } from "zustand/middleware";
 import { createStore } from "zustand/vanilla";
-import { pick, omit, isEqual, isObject } from "lodash-es";
 import { first, switchMap as switchMap$1, groupBy, mergeMap, startWith, pairwise, filter as filter$1, map as map$1, delay, tap, catchError, scan, share as share$1, take, debounceTime } from "rxjs/operators";
 import { createController, createNode } from "@sanity/comlink";
 import { createSelector } from "reselect";
@@ -17,7 +17,16 @@ import { isKeySegment, isKeyedObject } from "@sanity/types";
 import { createDocumentLoaderFromClient } from "@sanity/mutate/_unstable_store";
 import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
 import { fromUrl } from "@sanity/bifur-client";
-var AuthStateType = /* @__PURE__ */ ((AuthStateType2) => (AuthStateType2.LOGGED_IN = "logged-in", AuthStateType2.LOGGING_IN = "logging-in", AuthStateType2.ERROR = "error", AuthStateType2.LOGGED_OUT = "logged-out", AuthStateType2))(AuthStateType || {});
+const SOURCE_ID = "__sanity_internal_sourceId";
+function datasetSource(projectId, dataset) {
+  return { [SOURCE_ID]: { projectId, dataset } };
+}
+function mediaLibrarySource(id) {
+  return { [SOURCE_ID]: ["media-library", id] };
+}
+function canvasSource(id) {
+  return { [SOURCE_ID]: ["canvas", id] };
+}
 function getPublishedId(id) {
   const draftsPrefix = "drafts.";
   return id.startsWith(draftsPrefix) ? id.slice(draftsPrefix.length) : id;
@@ -105,7 +114,7 @@ function createActionBinder(keyFn) {
   const instanceRegistry = /* @__PURE__ */ new Map(), storeRegistry = /* @__PURE__ */ new Map();
   return function(storeDefinition, action) {
     return function(instance, ...params) {
-      const keySuffix = keyFn(instance.config), compositeKey = storeDefinition.name + (keySuffix ? `:${keySuffix}` : "");
+      const keySuffix = keyFn(instance.config, ...params), compositeKey = storeDefinition.name + (keySuffix ? `:${keySuffix}` : "");
       let instances = instanceRegistry.get(compositeKey);
       instances || (instances = /* @__PURE__ */ new Set(), instanceRegistry.set(compositeKey, instances)), instances.has(instance.instanceId) || (instances.add(instance.instanceId), instance.onDispose(() => {
         instances.delete(instance.instanceId), instances.size === 0 && (storeRegistry.get(compositeKey)?.dispose(), storeRegistry.delete(compositeKey), instanceRegistry.delete(compositeKey));
@@ -119,7 +128,18 @@ const bindActionByDataset = createActionBinder(({ projectId, dataset }) => {
   if (!projectId || !dataset)
     throw new Error("This API requires a project ID and dataset configured.");
   return `${projectId}.${dataset}`;
-}), bindActionGlobally = createActionBinder(() => "global");
+}), bindActionBySource = createActionBinder(
+  ({ projectId, dataset }, { source }) => {
+    if (source) {
+      const id = source[SOURCE_ID];
+      if (!id) throw new Error("Invalid source (missing ID information)");
+      return Array.isArray(id) ? id.join(":") : `${id.projectId}.${id.dataset}`;
+    }
+    if (!projectId || !dataset)
+      throw new Error("This API requires a project ID and dataset configured.");
+    return `${projectId}.${dataset}`;
+  }
+), bindActionGlobally = createActionBinder(() => "global");
 function createStateSourceAction(options) {
   const selector = typeof options == "function" ? options : options.selector, subscribeHandler = options && "onSubscribe" in options ? options.onSubscribe : void 0, isEqual2 = options && "isEqual" in options ? options.isEqual ?? Object.is : Object.is, selectorContextCache = /* @__PURE__ */ new WeakMap();
   function stateSourceAction(context, ...params) {
@@ -167,6 +187,7 @@ function createStateSourceAction(options) {
   }
   return stateSourceAction;
 }
+var AuthStateType = /* @__PURE__ */ ((AuthStateType2) => (AuthStateType2.LOGGED_IN = "logged-in", AuthStateType2.LOGGING_IN = "logging-in", AuthStateType2.ERROR = "error", AuthStateType2.LOGGED_OUT = "logged-out", AuthStateType2))(AuthStateType || {});
 const DEFAULT_BASE = "http://localhost", AUTH_CODE_PARAM = "sid", DEFAULT_API_VERSION$1 = "2021-06-07", REQUEST_TAG_PREFIX = "sanity.sdk.auth", REFRESH_INTERVAL = 12 * 60 * 60 * 1e3, LOCK_NAME = "sanity-token-refresh-lock";
 function getLastRefreshTime(storageArea, storageKey) {
   try {
@@ -389,6 +410,21 @@ function getCleanedUrl(locationUrl) {
   }
   return loc.searchParams.delete("sid"), loc.searchParams.delete("url"), loc.toString();
 }
+function getClientErrorApiBody(error) {
+  const body = error.response?.body;
+  return body && typeof body == "object" ? body : void 0;
+}
+function getClientErrorApiType(error) {
+  const body = getClientErrorApiBody(error);
+  return body?.error?.type ?? body?.type;
+}
+function getClientErrorApiDescription(error) {
+  const body = getClientErrorApiBody(error);
+  return body?.error?.description ?? body?.description;
+}
+function isProjectUserNotFoundClientError(error) {
+  return getClientErrorApiType(error) === "projectUserNotFoundError";
+}
 async function checkForCookieAuth(projectId, clientFactory) {
   if (!projectId) return !1;
   try {
@@ -584,13 +620,7 @@ const authStore = {
   }) : currentAuthState.type !== AuthStateType.LOGGED_OUT && state.set("setToken", {
     authState: { type: AuthStateType.LOGGED_OUT, isDestroyingSession: !1 }
   });
-});
-function compareProjectOrganization(projectId, projectOrganizationId, currentDashboardOrgId) {
-  return projectOrganizationId !== currentDashboardOrgId ? {
-    error: `Project ${projectId} belongs to Organization ${projectOrganizationId ?? "unknown"}, but the Dashboard has Organization ${currentDashboardOrgId} selected`
-  } : { error: null };
-}
-const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.sdk", allowedKeys = Object.keys({
+}), DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.sdk", allowedKeys = Object.keys({
   apiHost: null,
   useCdn: null,
   token: null,
@@ -605,7 +635,8 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
   apiVersion: null,
   requestTagPrefix: null,
   useProjectHostname: null,
-  "~experimental_resource": null
+  "~experimental_resource": null,
+  source: null
 }), DEFAULT_CLIENT_CONFIG = {
   apiVersion: DEFAULT_API_VERSION,
   useCdn: !1,
@@ -631,6 +662,10 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
 }), getClientConfigKey = (options) => JSON.stringify(pick(options, ...allowedKeys)), getClient = bindActionGlobally(
   clientStore,
   ({ state, instance }, options) => {
+    if (!options || typeof options != "object")
+      throw new Error(
+        'getClient() requires a configuration object with at least an "apiVersion" property. Example: getClient(instance, { apiVersion: "2024-11-12" })'
+      );
     const disallowedKeys = Object.keys(options).filter((key2) => !allowedKeys.includes(key2));
     if (disallowedKeys.length > 0) {
       const listFormatter = new Intl.ListFormat("en", { style: "long", type: "conjunction" });
@@ -638,16 +673,22 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
         `The client options provided contains unsupported properties: ${listFormatter.format(disallowedKeys)}. Allowed keys are: ${listFormatter.format(allowedKeys)}.`
       );
     }
-    const tokenFromState = state.get().token, { clients, authMethod } = state.get(), projectId = options.projectId ?? instance.config.projectId, dataset = options.dataset ?? instance.config.dataset, apiHost = options.apiHost ?? instance.config.auth?.apiHost, effectiveOptions = {
+    const tokenFromState = state.get().token, { clients, authMethod } = state.get(), hasSource = !!options.source;
+    let sourceId = options.source?.[SOURCE_ID], resource;
+    Array.isArray(sourceId) && (resource = { type: sourceId[0], id: sourceId[1] }, sourceId = void 0);
+    const projectId = options.projectId ?? instance.config.projectId, dataset = options.dataset ?? instance.config.dataset, apiHost = options.apiHost ?? instance.config.auth?.apiHost, effectiveOptions = {
       ...DEFAULT_CLIENT_CONFIG,
-      ...(options.scope === "global" || !projectId) && { useProjectHostname: !1 },
+      ...(options.scope === "global" || !projectId || hasSource) && { useProjectHostname: !1 },
       token: authMethod === "cookie" ? void 0 : tokenFromState ?? void 0,
       ...options,
       ...projectId && { projectId },
       ...dataset && { dataset },
-      ...apiHost && { apiHost }
+      ...apiHost && { apiHost },
+      ...resource && { "~experimental_resource": resource }
     };
-    effectiveOptions.token === null || typeof effectiveOptions.token > "u" ? (delete effectiveOptions.token, authMethod === "cookie" && (effectiveOptions.withCredentials = !0)) : delete effectiveOptions.withCredentials;
+    hasSource && ((options.projectId || options.dataset) && console.warn(
+      "Both source and explicit projectId/dataset are provided. The source will be used and projectId/dataset will be ignored."
+    ), delete effectiveOptions.projectId, delete effectiveOptions.dataset), effectiveOptions.token === null || typeof effectiveOptions.token > "u" ? (delete effectiveOptions.token, authMethod === "cookie" && (effectiveOptions.withCredentials = !0)) : delete effectiveOptions.withCredentials;
     const key = getClientConfigKey(effectiveOptions);
     if (clients[key]) return clients[key];
     const client = createClient(effectiveOptions);
@@ -656,7 +697,47 @@ const DEFAULT_API_VERSION = "2024-11-12", DEFAULT_REQUEST_TAG_PREFIX = "sanity.s
 ), getClientState = bindActionGlobally(
   clientStore,
   createStateSourceAction(({ instance }, options) => getClient(instance, options))
-);
+), API_VERSION$6 = "vX";
+function agentGenerate(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.generate(options)));
+}
+function agentTransform(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.transform(options)));
+}
+function agentTranslate(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => client.observable.agent.action.translate(options)));
+}
+function agentPrompt(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => from(client.agent.action.prompt(options))));
+}
+function agentPatch(instance, options) {
+  return getClientState(instance, {
+    apiVersion: API_VERSION$6,
+    projectId: instance.config.projectId,
+    dataset: instance.config.dataset
+  }).observable.pipe(switchMap((client) => from(client.agent.action.patch(options))));
+}
+function compareProjectOrganization(projectId, projectOrganizationId, currentDashboardOrgId) {
+  return projectOrganizationId !== currentDashboardOrgId ? {
+    error: `Project ${projectId} belongs to Organization ${projectOrganizationId ?? "unknown"}, but the Dashboard has Organization ${currentDashboardOrgId} selected`
+  } : { error: null };
+}
 function createFetcherStore({
   name,
   fetcher: getObservable,
@@ -1078,11 +1159,12 @@ const API_VERSION$4 = "v2025-02-19", datasets = createFetcherStore({
     useProjectHostname: !0
   }).observable.pipe(switchMap((client) => client.observable.datasets.list()))
 }), getDatasetsState = datasets.getState, resolveDatasets = datasets.resolveState, isSanityMutatePatch = (value) => !(typeof value != "object" || !value || !("type" in value) || typeof value.type != "string" || value.type !== "patch" || !("id" in value) || typeof value.id != "string" || !("patches" in value) || !Array.isArray(value.patches));
-function createDocument(doc) {
+function createDocument(doc, initialValue) {
   return {
     type: "document.create",
     ...doc,
-    ...doc.documentId && { documentId: getPublishedId(doc.documentId) }
+    ...doc.documentId && { documentId: getPublishedId(doc.documentId) },
+    ...initialValue && { initialValue }
   };
 }
 function deleteDocument(doc) {
@@ -1791,7 +1873,17 @@ function processActions({
             transactionId,
             message: "A draft version of this document already exists. Please use or discard the existing draft before creating a new one."
           });
-        const newDocBase = { ...base[publishedId], _type: action.documentType, _id: draftId }, newDocWorking = { ...working[publishedId], _type: action.documentType, _id: draftId }, mutations = [{ create: newDocWorking }];
+        const newDocBase = {
+          ...base[publishedId],
+          _type: action.documentType,
+          _id: draftId,
+          ...action.initialValue
+        }, newDocWorking = {
+          ...working[publishedId],
+          _type: action.documentType,
+          _id: draftId,
+          ...action.initialValue
+        }, mutations = [{ create: newDocWorking }];
         if (base = processMutations({
           documents: base,
           transactionId,
@@ -3252,6 +3344,7 @@ const queryStore = {
           projectId,
           dataset,
           tag,
+          source,
           perspective: perspectiveFromOptions,
           ...restOptions
         } = parseQueryKey(group$.key), perspective$ = getPerspectiveState(instance, {
@@ -3259,7 +3352,8 @@ const queryStore = {
         }).observable.pipe(filter(Boolean)), client$ = getClientState(instance, {
           apiVersion: QUERY_STORE_API_VERSION,
           projectId,
-          dataset
+          dataset,
+          source
         }).observable;
         return combineLatest([lastLiveEventId$, client$, perspective$]).pipe(
           switchMap(
@@ -3322,7 +3416,7 @@ const queryStore = {
 function getQueryState(...args) {
   return _getQueryState(...args);
 }
-const _getQueryState = bindActionByDataset(
+const _getQueryState = bindActionBySource(
   queryStore,
   createStateSourceAction({
     selector: ({ state, instance }, options) => {
@@ -3345,7 +3439,7 @@ const _getQueryState = bindActionByDataset(
 function resolveQuery(...args) {
   return _resolveQuery(...args);
 }
-const _resolveQuery = bindActionByDataset(
+const _resolveQuery = bindActionBySource(
   queryStore,
   ({ state, instance }, { signal, ...options }) => {
     const normalized = normalizeOptionsWithPerspective(instance, options), { getCurrent } = getQueryState(instance, normalized), key = getQueryKey(normalized), aborted$ = signal ? new Observable((observer) => {
@@ -3902,12 +3996,18 @@ function getCorsErrorProjectId(error) {
   const projMatch = (error.message || "").match(/manage\/project\/([^/?#]+)/);
   return projMatch ? projMatch[1] : null;
 }
-var version = "2.3.1";
+var version = "2.4.0";
 const CORE_SDK_VERSION = getEnv("PKG_VERSION") || `${version}-development`;
 export {
   AuthStateType,
   CORE_SDK_VERSION,
+  agentGenerate,
+  agentPatch,
+  agentPrompt,
+  agentTransform,
+  agentTranslate,
   applyDocumentActions,
+  canvasSource,
   createDatasetHandle,
   createDocument,
   createDocumentHandle,
@@ -3915,6 +4015,7 @@ export {
   createGroqSearchFilter,
   createProjectHandle,
   createSanityInstance,
+  datasetSource,
   defineIntent,
   deleteDocument,
   destroyController,
@@ -3923,6 +4024,9 @@ export {
   getActiveReleasesState,
   getAuthState,
   getClient,
+  getClientErrorApiBody,
+  getClientErrorApiDescription,
+  getClientErrorApiType,
   getClientState,
   getCorsErrorProjectId,
   getCurrentUserState,
@@ -3953,10 +4057,12 @@ export {
   getUsersKey,
   getUsersState,
   handleAuthCallback,
+  isProjectUserNotFoundClientError,
   joinPaths,
   jsonMatch2 as jsonMatch,
   loadMoreUsers,
   logout,
+  mediaLibrarySource,
   observeOrganizationVerificationState,
   parseQueryKey,
   parseUsersKey,