@sanity/sdk-react 2.3.0 → 2.4.0

package/dist/index.d.ts

@@ -1,4 +1,11 @@
 import {ActionsResult} from '@sanity/sdk'
+import {AgentGenerateOptions} from '@sanity/sdk'
+import {AgentPatchOptions} from '@sanity/sdk'
+import {AgentPatchResult} from '@sanity/sdk'
+import {AgentPromptOptions} from '@sanity/sdk'
+import {AgentPromptResult} from '@sanity/sdk'
+import {AgentTransformOptions} from '@sanity/sdk'
+import {AgentTranslateOptions} from '@sanity/sdk'
 import {ApplyDocumentActionsOptions} from '@sanity/sdk'
 import {AuthState} from '@sanity/sdk'
 import {CanvasResource} from '@sanity/message-protocol'
@@ -11,6 +18,7 @@ import {DocumentEvent} from '@sanity/sdk'
 import {DocumentHandle} from '@sanity/sdk'
 import {DocumentOptions} from '@sanity/sdk'
 import {DocumentPermissionsResult} from '@sanity/sdk'
+import {DocumentSource} from '@sanity/sdk'
 import {FallbackProps} from 'react-error-boundary'
 import {FavoriteStatusResponse} from '@sanity/sdk'
 import {FrameMessage} from '@sanity/sdk'
@@ -142,6 +150,26 @@ declare interface DashboardResource {
 
 export {DatasetsResponse}
 
+/**
+ * Return type for the useDispatchIntent hook
+ * @beta
+ */
+declare interface DispatchIntent {
+  dispatchIntent: () => void
+}
+
+/**
+ * Document handle that optionally includes a source (e.g., media library source)
+ * or projectId and dataset for traditional dataset sources
+ * (but now marked optional since it's valid to just use a source)
+ * @beta
+ */
+declare interface DocumentHandleWithSource extends Omit<DocumentHandle, 'projectId' | 'dataset'> {
+  source?: DocumentSource
+  projectId?: string
+  dataset?: string
+}
+
 declare interface DocumentInteractionHistory {
   recordEvent: (eventType: 'viewed' | 'edited' | 'created' | 'deleted') => void
 }
@@ -156,8 +184,8 @@ export declare interface DocumentsOptions<
   TDocumentType extends string = string,
   TDataset extends string = string,
   TProjectId extends string = string,
-> extends DatasetHandle<TDataset, TProjectId>,
-    Pick<QueryOptions, 'perspective' | 'params'> {
+>
+  extends DatasetHandle<TDataset, TProjectId>, Pick<QueryOptions, 'perspective' | 'params'> {
   /**
    * Filter documents by their `_type`. Can be a single type or an array of types.
    */
@@ -269,6 +297,12 @@ export declare interface NavigateToStudioResult {
   navigateToStudioDocument: () => void
 }
 
+declare interface Observer<T> {
+  next?: (value: T) => void
+  error?: (err: unknown) => void
+  complete?: () => void
+}
+
 /**
  * Configuration options for the usePaginatedDocuments hook
  *
@@ -569,6 +603,19 @@ declare interface StudioWorkspacesResult {
   error: string | null
 }
 
+declare interface Subscribable<T> {
+  subscribe(observer: Observer<T>): Subscription
+  subscribe(
+    next: (value: T) => void,
+    error?: (err: unknown) => void,
+    complete?: () => void,
+  ): Subscription
+}
+
+declare interface Subscription {
+  unsubscribe(): void
+}
+
 declare type Updater<TValue> = TValue | ((currentValue: TValue) => TValue)
 
 /**
@@ -595,6 +642,70 @@ declare type UseActiveReleases = {
  */
 export declare const useActiveReleases: UseActiveReleases
 
+/**
+ * @alpha
+ * Generates content for a document (or specific fields) via Sanity Agent Actions.
+ * - Uses instruction templates with `$variables` and supports `instructionParams` (constants, fields, documents, GROQ queries).
+ * - Can target specific paths/fields; supports image generation when targeting image fields.
+ * - Supports optional `temperature`, `async`, `noWrite`, and `conditionalPaths`.
+ *
+ * Returns a stable callback that triggers the action and yields a Subscribable stream.
+ */
+export declare const useAgentGenerate: () => (
+  options: AgentGenerateOptions,
+) => Subscribable<unknown>
+
+/**
+ * @alpha
+ * Schema-aware patching with Sanity Agent Actions.
+ * - Validates provided paths/values against the document schema and merges object values safely.
+ * - Prevents duplicate keys and supports array appends (including after a specific keyed item).
+ * - Accepts `documentId` or `targetDocument` (mutually exclusive).
+ * - Optional `async`, `noWrite`, `conditionalPaths`.
+ *
+ * Returns a stable callback that triggers the action and resolves a Promise with the patch result.
+ */
+export declare const useAgentPatch: () => (options: AgentPatchOptions) => Promise<AgentPatchResult>
+
+/**
+ * @alpha
+ * Prompts the LLM using the same instruction template format as other actions.
+ * - `format`: 'string' or 'json' (instruction must contain the word "json" for JSON responses).
+ * - Optional `temperature`.
+ *
+ * Returns a stable callback that triggers the action and resolves a Promise with the prompt result.
+ */
+export declare const useAgentPrompt: () => (
+  options: AgentPromptOptions,
+) => Promise<AgentPromptResult>
+
+/**
+ * @alpha
+ * Transforms an existing document or selected fields using Sanity Agent Actions.
+ * - Accepts `instruction` and `instructionParams` (constants, fields, documents, GROQ queries).
+ * - Can write to the same or a different `targetDocument` (create/edit), and target specific paths.
+ * - Supports per-path image transform instructions and image description operations.
+ * - Optional `temperature`, `async`, `noWrite`, `conditionalPaths`.
+ *
+ * Returns a stable callback that triggers the action and yields a Subscribable stream.
+ */
+export declare const useAgentTransform: () => (
+  options: AgentTransformOptions,
+) => Subscribable<unknown>
+
+/**
+ * @alpha
+ * Translates documents or fields using Sanity Agent Actions.
+ * - Configure `fromLanguage`/`toLanguage`, optional `styleGuide`, and `protectedPhrases`.
+ * - Can write into a different `targetDocument`, and/or store language in a field.
+ * - Optional `temperature`, `async`, `noWrite`, `conditionalPaths`.
+ *
+ * Returns a stable callback that triggers the action and yields a Subscribable stream.
+ */
+export declare const useAgentTranslate: () => (
+  options: AgentTranslateOptions,
+) => Subscribable<unknown>
+
 /**
  * @public
  */
@@ -702,6 +813,37 @@ declare interface UseApplyDocumentActions {
  *   )
  * }
  * ```
+ *
+ * @example Create a document with initial field values
+ * ```tsx
+ * import {
+ *   createDocument,
+ *   createDocumentHandle,
+ *   useApplyDocumentActions
+ * } from '@sanity/sdk-react'
+ *
+ * function CreateArticleButton() {
+ *   const apply = useApplyDocumentActions()
+ *
+ *   const handleCreateArticle = () => {
+ *     const newDocHandle = createDocumentHandle({
+ *       documentId: crypto.randomUUID(),
+ *       documentType: 'article'
+ *     })
+ *
+ *     // Create document with initial values in one action
+ *     apply(
+ *       createDocument(newDocHandle, {
+ *         title: 'New Article',
+ *         author: 'John Doe',
+ *         publishedAt: new Date().toISOString(),
+ *       })
+ *     )
+ *   }
+ *
+ *   return <button onClick={handleCreateArticle}>Create Article</button>
+ * }
+ * ```
  */
 export declare const useApplyDocumentActions: UseApplyDocumentActions
 
@@ -762,7 +904,7 @@ export declare const useAuthToken: () => string | null
  * @public
  * @function
  */
-export declare const useClient: (x: ClientOptions) => SanityClient
+export declare const useClient: (options: ClientOptions) => SanityClient
 
 declare type UseCurrentUser = {
   /**
@@ -894,6 +1036,70 @@ declare type UseDatasets = {
  */
 export declare const useDatasets: UseDatasets
 
+/**
+ * @beta
+ *
+ * A hook for dispatching intent messages to the Dashboard with a document handle.
+ * This allows applications to signal their intent to pass the referenced document to other applications that have registered the ability to perform specific actions on that document.
+ *
+ * @param params - Object containing:
+ *   - `action` - Action to perform (currently only 'edit' is supported). Will prompt a picker if multiple handlers are available.
+ *   - `intentId` - Specific ID of the intent to dispatch. Either `action` or `intentId` is required.
+ *   - `documentHandle` - The document handle containing document ID, type, and either:
+ *     - `projectId` and `dataset` for traditional dataset sources, like `{documentId: '123', documentType: 'book', projectId: 'abc123', dataset: 'production'}`
+ *     - `source` for media library, canvas, or dataset sources, like `{documentId: '123', documentType: 'sanity.asset', source: mediaLibrarySource('ml123')}` or `{documentId: '123', documentType: 'sanity.canvas.document', source: canvasSource('canvas123')}`
+ *   - `paremeters` - Optional parameters to include in the dispatch; will be passed to the resolved intent handler
+ * @returns An object containing:
+ * - `dispatchIntent` - Function to dispatch the intent message
+ *
+ * @example
+ * ```tsx
+ * import {useDispatchIntent} from '@sanity/sdk-react'
+ * import {Button} from '@sanity/ui'
+ * import {Suspense} from 'react'
+ *
+ * function DispatchIntentButton({documentId, documentType, projectId, dataset}) {
+ *   const {dispatchIntent} = useDispatchIntent({
+ *     action: 'edit',
+ *     documentHandle: {documentId, documentType, projectId, dataset},
+ *   })
+ *
+ *   return (
+ *     <Button
+ *       onClick={() => dispatchIntent()}
+ *       text="Dispatch Intent"
+ *     />
+ *   )
+ * }
+ *
+ * // Wrap the component with Suspense since the hook may suspend
+ * function MyDocumentAction({documentId, documentType, projectId, dataset}) {
+ *   return (
+ *     <Suspense fallback={<Button text="Loading..." disabled />}>
+ *       <DispatchIntentButton
+ *         documentId={documentId}
+ *         documentType={documentType}
+ *         projectId={projectId}
+ *         dataset={dataset}
+ *       />
+ *     </Suspense>
+ *   )
+ * }
+ * ```
+ */
+export declare function useDispatchIntent(params: UseDispatchIntentParams): DispatchIntent
+
+/**
+ * Parameters for the useDispatchIntent hook
+ * @beta
+ */
+declare interface UseDispatchIntentParams {
+  action?: 'edit'
+  intentId?: string
+  documentHandle: DocumentHandleWithSource
+  parameters?: Record<string, unknown>
+}
+
 declare interface UseDocument {
   /** @internal */
   <TDocumentType extends string, TDataset extends string, TProjectId extends string = string>(
@@ -2499,7 +2705,7 @@ export declare function useUser(options: GetUserOptions): UserResult
  *         <address>{user.profile.email}</address>
  *       </figure>
  *     ))}
- *     {hasMore && <button onClick={loadMore}>{isPending ? 'Loading...' : 'Load More'</button>}
+ *     {hasMore && <button onClick={loadMore}>{isPending ? 'Loading...' : 'Load More'}</button>}
  *   </div>
  * )
  * ```

package/dist/index.js

@@ -1,9 +1,9 @@
 import { jsx, jsxs, Fragment } from "react/jsx-runtime";
 import { c } from "react-compiler-runtime";
 import { ClientError, CorsOriginError } from "@sanity/client";
-import { getAuthState, getNodeState, getIsInDashboardState, setAuthToken, AuthStateType, getLoginUrlState, observeOrganizationVerificationState, handleAuthCallback, logout, getCorsErrorProjectId, createSanityInstance, getTokenState, getCurrentUserState, getDashboardOrganizationId, getClientState, getOrCreateController, getOrCreateChannel, releaseChannel, getFavoritesState, resolveFavoritesState, resolveDatasets, getDatasetsState, applyDocumentActions, resolveDocument, getDocumentState, subscribeDocumentEvents, getPermissionsState, getDocumentSyncStatus, editDocument, getQueryKey, parseQueryKey, getQueryState, resolveQuery, createGroqSearchFilter, getPresence, getPreviewState, resolvePreview, getProjectionState, resolveProjection, resolveProject, getProjectState, resolveProjects, getProjectsState, getActiveReleasesState, getPerspectiveState, getUsersKey, parseUsersKey, getUsersState, resolveUsers, loadMoreUsers } from "@sanity/sdk";
+import { getAuthState, getNodeState, getIsInDashboardState, setAuthToken, AuthStateType, getLoginUrlState, observeOrganizationVerificationState, handleAuthCallback, logout, isProjectUserNotFoundClientError, getClientErrorApiDescription, getClientErrorApiBody, getCorsErrorProjectId, createSanityInstance, agentGenerate, agentTransform, agentTranslate, agentPrompt, agentPatch, getTokenState, getCurrentUserState, getDashboardOrganizationId, getClientState, getOrCreateController, getOrCreateChannel, releaseChannel, getFavoritesState, resolveFavoritesState, resolveDatasets, getDatasetsState, applyDocumentActions, resolveDocument, getDocumentState, subscribeDocumentEvents, getPermissionsState, getDocumentSyncStatus, editDocument, getQueryKey, parseQueryKey, getQueryState, resolveQuery, createGroqSearchFilter, getPresence, getPreviewState, resolvePreview, getProjectionState, resolveProjection, resolveProject, getProjectState, resolveProjects, getProjectsState, getActiveReleasesState, getPerspectiveState, getUsersKey, parseUsersKey, getUsersState, resolveUsers, loadMoreUsers } from "@sanity/sdk";
 export * from "@sanity/sdk";
-import { createContext, useContext, useSyncExternalStore, useRef, useEffect, useState, Suspense, useMemo, useCallback, useInsertionEffect, useTransition } from "react";
+import { createContext, useContext, useSyncExternalStore, useRef, useEffect, useState, Suspense, useCallback, useMemo, useInsertionEffect, useTransition } from "react";
 import { ErrorBoundary } from "react-error-boundary";
 import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
 import { firstValueFrom, filter, identity, Observable, startWith, distinctUntilChanged, switchMap, EMPTY } from "rxjs";
@@ -142,7 +142,9 @@ const ComlinkTokenRefreshProvider = (t0) => {
     children
   } = t0, instance = useSanityInstance();
   let t1;
-  if (t1 = getIsInDashboardState(instance).getCurrent(), t1) {
+  t1 = getIsInDashboardState(instance).getCurrent();
+  const isInDashboard = t1, studioModeEnabled = !!instance.config.studioMode?.enabled;
+  if (isInDashboard && !studioModeEnabled) {
     let t2;
     return $[0] !== children ? (t2 = /* @__PURE__ */ jsx(DashboardTokenRefresh, { children }), $[0] = children, $[1] = t2) : t2 = $[1], t2;
   }
@@ -295,13 +297,13 @@ function _temp$5(replacementLocation) {
 }
 const useLogOut = createCallbackHook(logout);
 function LoginError(t0) {
-  const $ = c(17), {
+  const $ = c(18), {
     error,
     resetErrorBoundary
   } = t0;
   if (!(error instanceof AuthError || error instanceof ConfigurationError || error instanceof ClientError))
     throw error;
-  const logout2 = useLogOut(), authState = useAuthState(), [authErrorMessage, setAuthErrorMessage] = useState("Please try again or contact support if the problem persists.");
+  const logout2 = useLogOut(), authState = useAuthState(), [authErrorMessage, setAuthErrorMessage] = useState("Please try again or contact support if the problem persists."), [showRetryCta, setShowRetryCta] = useState(!0);
   let t1;
   $[0] !== logout2 || $[1] !== resetErrorBoundary ? (t1 = async () => {
     await logout2(), resetErrorBoundary();
@@ -311,24 +313,28 @@ function LoginError(t0) {
   $[3] !== authState.type || $[4] !== error || $[5] !== handleRetry ? (t2 = () => {
     if (error instanceof ClientError) {
       if (error.statusCode === 401)
-        handleRetry();
+        if (isProjectUserNotFoundClientError(error)) {
+          const description = getClientErrorApiDescription(error);
+          description && setAuthErrorMessage(description), setShowRetryCta(!1);
+        } else
+          setShowRetryCta(!0), handleRetry();
       else if (error.statusCode === 404) {
-        const errorMessage = error.response.body.message || "";
-        errorMessage.startsWith("Session with sid") && errorMessage.endsWith("not found") ? setAuthErrorMessage("The session ID is invalid or expired.") : setAuthErrorMessage("The login link is invalid or expired. Please try again.");
+        const errorMessage = getClientErrorApiBody(error)?.message || "";
+        errorMessage.startsWith("Session with sid") && errorMessage.endsWith("not found") ? setAuthErrorMessage("The session ID is invalid or expired.") : setAuthErrorMessage("The login link is invalid or expired. Please try again."), setShowRetryCta(!0);
       }
     }
-    authState.type !== AuthStateType.ERROR && error instanceof ConfigurationError && setAuthErrorMessage(error.message);
+    authState.type !== AuthStateType.ERROR && error instanceof ConfigurationError && (setAuthErrorMessage(error.message), setShowRetryCta(!0));
   }, $[3] = authState.type, $[4] = error, $[5] = handleRetry, $[6] = t2) : t2 = $[6];
   let t3;
   $[7] !== authState || $[8] !== error || $[9] !== handleRetry ? (t3 = [authState, handleRetry, error], $[7] = authState, $[8] = error, $[9] = handleRetry, $[10] = t3) : t3 = $[10], useEffect(t2, t3);
   const t4 = error instanceof AuthError ? "Authentication Error" : "Configuration Error";
   let t5;
-  $[11] !== handleRetry ? (t5 = {
+  $[11] !== handleRetry || $[12] !== showRetryCta ? (t5 = showRetryCta ? {
     text: "Retry",
     onClick: handleRetry
-  }, $[11] = handleRetry, $[12] = t5) : t5 = $[12];
+  } : void 0, $[11] = handleRetry, $[12] = showRetryCta, $[13] = t5) : t5 = $[13];
   let t6;
-  return $[13] !== authErrorMessage || $[14] !== t4 || $[15] !== t5 ? (t6 = /* @__PURE__ */ jsx(Error$1, { heading: t4, description: authErrorMessage, cta: t5 }), $[13] = authErrorMessage, $[14] = t4, $[15] = t5, $[16] = t6) : t6 = $[16], t6;
+  return $[14] !== authErrorMessage || $[15] !== t4 || $[16] !== t5 ? (t6 = /* @__PURE__ */ jsx(Error$1, { heading: t4, description: authErrorMessage, cta: t5 }), $[14] = authErrorMessage, $[15] = t4, $[16] = t5, $[17] = t6) : t6 = $[17], t6;
 }
 if (isInIframe() && !document.querySelector("[data-sanity-core]")) {
   const parsedUrl = new URL(window.location.href), mode = new URLSearchParams(parsedUrl.hash.slice(1)).get("mode"), script = document.createElement("script");
@@ -353,7 +359,7 @@ function AuthBoundary(t0) {
   return $[7] !== FallbackComponent || $[8] !== t4 ? (t5 = /* @__PURE__ */ jsx(ComlinkTokenRefreshProvider, { children: /* @__PURE__ */ jsx(ErrorBoundary, { FallbackComponent, children: t4 }) }), $[7] = FallbackComponent, $[8] = t4, $[9] = t5) : t5 = $[9], t5;
 }
 function AuthSwitch(t0) {
-  const $ = c(13);
+  const $ = c(14);
   let children, projectIds, props, t1, t2;
   $[0] !== t0 ? ({
     CallbackComponent: t1,
@@ -362,11 +368,11 @@ function AuthSwitch(t0) {
     projectIds,
     ...props
   } = t0, $[0] = t0, $[1] = children, $[2] = projectIds, $[3] = props, $[4] = t1, $[5] = t2) : (children = $[1], projectIds = $[2], props = $[3], t1 = $[4], t2 = $[5]);
-  const CallbackComponent = t1 === void 0 ? LoginCallback : t1, verifyOrganization = t2 === void 0 ? !0 : t2, authState = useAuthState(), orgError = useVerifyOrgProjects(!verifyOrganization, projectIds), isLoggedOut = authState.type === AuthStateType.LOGGED_OUT && !authState.isDestroyingSession, loginUrl = useLoginUrl();
+  const CallbackComponent = t1 === void 0 ? LoginCallback : t1, verifyOrganization = t2 === void 0 ? !0 : t2, authState = useAuthState(), studioModeEnabled = useSanityInstance().config.studioMode?.enabled, disableVerifyOrg = !verifyOrganization || studioModeEnabled || authState.type !== AuthStateType.LOGGED_IN, orgError = useVerifyOrgProjects(disableVerifyOrg, projectIds), isLoggedOut = authState.type === AuthStateType.LOGGED_OUT && !authState.isDestroyingSession, loginUrl = useLoginUrl();
   let t3, t4;
-  if ($[6] !== isLoggedOut || $[7] !== loginUrl ? (t3 = () => {
-    isLoggedOut && !isInIframe() && (window.location.href = loginUrl);
-  }, t4 = [isLoggedOut, loginUrl], $[6] = isLoggedOut, $[7] = loginUrl, $[8] = t3, $[9] = t4) : (t3 = $[8], t4 = $[9]), useEffect(t3, t4), verifyOrganization && orgError)
+  if ($[6] !== isLoggedOut || $[7] !== loginUrl || $[8] !== studioModeEnabled ? (t3 = () => {
+    isLoggedOut && !isInIframe() && !studioModeEnabled && (window.location.href = loginUrl);
+  }, t4 = [isLoggedOut, loginUrl, studioModeEnabled], $[6] = isLoggedOut, $[7] = loginUrl, $[8] = studioModeEnabled, $[9] = t3, $[10] = t4) : (t3 = $[9], t4 = $[10]), useEffect(t3, t4), verifyOrganization && orgError)
     throw new ConfigurationError({
       message: orgError
     });
@@ -375,7 +381,7 @@ function AuthSwitch(t0) {
       throw new AuthError(authState.error);
     case AuthStateType.LOGGING_IN: {
       let t5;
-      return $[10] !== CallbackComponent || $[11] !== props ? (t5 = /* @__PURE__ */ jsx(CallbackComponent, { ...props }), $[10] = CallbackComponent, $[11] = props, $[12] = t5) : t5 = $[12], t5;
+      return $[11] !== CallbackComponent || $[12] !== props ? (t5 = /* @__PURE__ */ jsx(CallbackComponent, { ...props }), $[11] = CallbackComponent, $[12] = props, $[13] = t5) : t5 = $[13], t5;
     }
     case AuthStateType.LOGGED_IN:
       return children;
@@ -447,7 +453,15 @@ function SanityApp(t0) {
 function _temp$4() {
   console.warn("Redirecting to core", REDIRECT_URL), window.location.replace(REDIRECT_URL);
 }
-const useAuthToken = createStateSourceHook(getTokenState), useCurrentUser = createStateSourceHook(getCurrentUserState);
+const useAgentGenerate = createCallbackHook(agentGenerate), useAgentTransform = createCallbackHook(agentTransform), useAgentTranslate = createCallbackHook(agentTranslate);
+function promptAdapter(instance, options) {
+  return firstValueFrom(agentPrompt(instance, options));
+}
+const useAgentPrompt = createCallbackHook(promptAdapter);
+function patchAdapter(instance, options) {
+  return firstValueFrom(agentPatch(instance, options));
+}
+const useAgentPatch = createCallbackHook(patchAdapter), useAuthToken = createStateSourceHook(getTokenState), useCurrentUser = createStateSourceHook(getCurrentUserState);
 function useDashboardOrganizationId() {
   const $ = c(2), instance = useSanityInstance();
   let t0, t1;
@@ -459,8 +473,12 @@ function useDashboardOrganizationId() {
   return useSyncExternalStore(subscribe, getCurrent);
 }
 const useClient = createStateSourceHook({
-  getState: getClientState,
-  getConfig: identity
+  getState: (instance, options) => {
+    if (!options || typeof options != "object")
+      throw new Error('useClient() requires a configuration object with at least an "apiVersion" property. Example: useClient({ apiVersion: "2024-11-12" })');
+    return getClientState(instance, options);
+  },
+  getConfig: (options) => options
 });
 function useFrameConnection(options) {
   const $ = c(12), {
@@ -524,6 +542,84 @@ function useDashboardNavigate(navigateFn) {
     }
   }, $[0] = navigateFn, $[1] = t0) : t0 = $[1], useWindowConnection(t0);
 }
+const SOURCE_ID = "__sanity_internal_sourceId", isDocumentHandleWithSource = (documentHandle) => "source" in documentHandle;
+function getResourceIdFromDocumentHandle(documentHandle) {
+  let source;
+  const {
+    projectId,
+    dataset
+  } = documentHandle;
+  isDocumentHandleWithSource(documentHandle) && (source = documentHandle.source);
+  let resourceId = projectId + "." + dataset, resourceType;
+  if (source) {
+    const sourceId = source[SOURCE_ID];
+    if (Array.isArray(sourceId))
+      (sourceId[0] === "media-library" || sourceId[0] === "canvas") && (resourceType = sourceId[0], resourceId = sourceId[1]);
+    else if (sourceId && typeof sourceId == "object" && "projectId" in sourceId) {
+      const datasetSource = sourceId;
+      resourceId = `${datasetSource.projectId}.${datasetSource.dataset}`;
+    }
+  }
+  return {
+    id: resourceId,
+    type: resourceType
+  };
+}
+function useDispatchIntent(params) {
+  const {
+    action,
+    intentId,
+    documentHandle,
+    parameters
+  } = params, {
+    sendMessage
+  } = useWindowConnection({
+    name: SDK_NODE_NAME,
+    connectTo: SDK_CHANNEL_NAME
+  });
+  return {
+    dispatchIntent: useCallback(() => {
+      try {
+        if (!action && !intentId)
+          throw new Error("useDispatchIntent: Either `action` or `intentId` must be provided.");
+        const {
+          projectId,
+          dataset,
+          source
+        } = documentHandle;
+        if (action && intentId && console.warn("useDispatchIntent: Both `action` and `intentId` were provided. Using `intentId` and ignoring `action`."), !source && (!projectId || !dataset))
+          throw new Error("useDispatchIntent: Either `source` or both `projectId` and `dataset` must be provided in documentHandle.");
+        const resource = getResourceIdFromDocumentHandle(documentHandle), message = {
+          type: "dashboard/v1/events/intents/dispatch-intent",
+          data: {
+            ...action && !intentId ? {
+              action
+            } : {},
+            ...intentId ? {
+              intentId
+            } : {},
+            document: {
+              id: documentHandle.documentId,
+              type: documentHandle.documentType
+            },
+            resource: {
+              id: resource.id,
+              ...resource.type ? {
+                type: resource.type
+              } : {}
+            },
+            ...parameters && Object.keys(parameters).length > 0 ? {
+              parameters
+            } : {}
+          }
+        };
+        sendMessage(message.type, message.data);
+      } catch (error) {
+        throw console.error("Failed to dispatch intent:", error), error;
+      }
+    }, [action, intentId, documentHandle, parameters, sendMessage])
+  };
+}
 function useManageFavorite({
   documentId,
   documentType,
@@ -1123,35 +1219,27 @@ function useDocumentPreview(t0) {
     return currentState;
   }, $[9] = docHandle, $[10] = instance, $[11] = stateSource, $[12] = t3) : t3 = $[12], useSyncExternalStore(subscribe, t3);
 }
-function useDocumentProjection(t0) {
-  const $ = c(12);
-  let docHandle, projection, ref;
-  $[0] !== t0 ? ({
-    ref,
-    projection,
-    ...docHandle
-  } = t0, $[0] = t0, $[1] = docHandle, $[2] = projection, $[3] = ref) : (docHandle = $[1], projection = $[2], ref = $[3]);
-  const instance = useSanityInstance(docHandle);
-  let stateSource, t1;
-  if ($[4] !== docHandle || $[5] !== instance || $[6] !== projection ? (stateSource = getProjectionState(instance, {
+function useDocumentProjection({
+  ref,
+  projection,
+  ...docHandle
+}) {
+  const instance = useSanityInstance(docHandle), normalizedProjection = useMemo(() => projection.trim(), [projection]), stateSource = useMemo(() => getProjectionState(instance, {
     ...docHandle,
-    projection
-  }), t1 = stateSource.getCurrent()?.data, $[4] = docHandle, $[5] = instance, $[6] = projection, $[7] = stateSource, $[8] = t1) : (stateSource = $[7], t1 = $[8]), t1 === null)
+    projection: normalizedProjection
+  }), [instance, normalizedProjection, docHandle]);
+  if (stateSource.getCurrent()?.data === null)
     throw resolveProjection(instance, {
       ...docHandle,
-      projection
+      projection: normalizedProjection
     });
-  let t2;
-  return $[9] !== ref || $[10] !== stateSource ? (t2 = (onStoreChanged) => {
+  const subscribe = useCallback((onStoreChanged) => {
     const subscription = new Observable((observer) => {
       if (typeof IntersectionObserver > "u" || typeof HTMLElement > "u") {
         observer.next(!0);
         return;
       }
-      const intersectionObserver = new IntersectionObserver((t3) => {
-        const [entry] = t3;
-        return observer.next(entry.isIntersecting);
-      }, {
+      const intersectionObserver = new IntersectionObserver(([entry]) => observer.next(entry.isIntersecting), {
         rootMargin: "0px",
         threshold: 0
       });
@@ -1160,7 +1248,8 @@ function useDocumentProjection(t0) {
       next: onStoreChanged
     });
     return () => subscription.unsubscribe();
-  }, $[9] = ref, $[10] = stateSource, $[11] = t2) : t2 = $[11], useSyncExternalStore(t2, stateSource.getCurrent);
+  }, [stateSource, ref]);
+  return useSyncExternalStore(subscribe, stateSource.getCurrent);
 }
 const useProject = createStateSourceHook({
   // remove `undefined` since we're suspending when that is the case
@@ -1231,7 +1320,7 @@ function useUsers(options) {
     loadMore
   };
 }
-var version = "2.3.0";
+var version = "2.4.0";
 function getEnv(key) {
   if (typeof import.meta < "u" && import.meta.env)
     return import.meta.env[key];
@@ -1249,6 +1338,11 @@ export {
   SDKProvider,
   SanityApp,
   useActiveReleases,
+  useAgentGenerate,
+  useAgentPatch,
+  useAgentPrompt,
+  useAgentTransform,
+  useAgentTranslate,
   useApplyDocumentActions,
   useAuthState,
   useAuthToken,
@@ -1257,6 +1351,7 @@ export {
   useDashboardNavigate,
   useDashboardOrganizationId,
   useDatasets,
+  useDispatchIntent,
   useDocument,
   useDocumentEvent,
   useDocumentPermissions,