@sanity/workflow-studio 0.6.0 → 0.7.1

package/dist/index.cjs

@@ -1,212 +1,267 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: !0 });
-var workflowEngine = require("@sanity/workflow-engine"), observer = require("@sanity/workflow-react/observer"), observer$1 = require("@sanity/workflow-sdk/observer"), react = require("react"), sanity = require("sanity"), workflowReact = require("@sanity/workflow-react"), sdk = require("@sanity/sdk");
-function observableStore({
-  observable,
-  resolve,
-  initial
-}) {
-  let latest = initial;
-  return {
-    subscribe(onChange) {
-      const subscription = observable.subscribe((value) => {
-        latest = resolve(value), onChange();
-      });
-      return () => subscription.unsubscribe();
-    },
-    getSnapshot: () => latest
-  };
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+});
+
+var workflowEngine = require("@sanity/workflow-engine"), observer = require("@sanity/workflow-react/observer"), observer$1 = require("@sanity/workflow-sdk/observer"), sdk = require("@sanity/sdk"), react = require("react"), sanity = require("sanity"), workflowReact = require("@sanity/workflow-react");
+
+const RESUBSCRIBE_DELAY_MS = 5e3;
+
+function observableStore({observable: observable, resolve: resolve, initial: initial, name: name}) {
+    let latest = initial;
+    return {
+        subscribe(onChange) {
+            let subscription, retry, stopped = !1;
+            const connect = () => {
+                subscription = observable.subscribe({
+                    next: value => {
+                        latest = resolve(value), onChange();
+                    },
+                    error: err => {
+                        console.error(`[workflow-studio] ${name} stream errored — resubscribing in ${RESUBSCRIBE_DELAY_MS / 1e3}s:`, err), 
+                        stopped || (retry = setTimeout(connect, RESUBSCRIBE_DELAY_MS));
+                    }
+                });
+            };
+            return connect(), () => {
+                stopped = !0, retry !== void 0 && clearTimeout(retry), subscription?.unsubscribe();
+            };
+        },
+        getSnapshot: () => latest
+    };
 }
+
 function makeStudioObserver(documentStore, options) {
-  const { mounted, engineResource, sdk: sdk2 } = options, engineIsMounted = observer.sameDataset(engineResource, mounted), editStateStore = ({
-    id,
-    type,
-    release
-  }) => observableStore({
-    observable: documentStore.pair.editState(id, type, release),
-    resolve: resolveEditState,
-    initial: void 0
-  }), requireSdk = (what) => {
-    if (sdk2 !== void 0) return sdk2;
-    throw new Error(
-      `@sanity/workflow-studio: ${what} \u2014 Studio's document store is bound to ${mounted.projectId}.${mounted.dataset} and cannot observe it. Pass an App SDK instance via the hook's \`sdk\` option (e.g. \`useWorkflowSession({engine, instanceId, sdk})\`) to observe foreign resources.`
-    );
-  };
-  return {
-    observeInstance: (instanceId) => engineIsMounted ? editStateStore({ id: instanceId, type: workflowEngine.WORKFLOW_INSTANCE_TYPE, release: void 0 }) : observer$1.sdkInstanceDocStore({
-      sdk: requireSdk(
-        `instance "${instanceId}" lives in the engine dataset ${engineResource.projectId}.${engineResource.dataset}`
-      ),
-      instanceId,
-      engineResource
-    }),
-    observeDocs: (documents, perspective) => observer.combineDocStores(
-      documents.map((ref) => observer.classifyRef(ref, mounted) === "mounted-dataset" ? {
-        key: ref.globalDocumentId,
-        store: editStateStore({
-          id: ref.documentId,
-          type: ref.type,
-          release: workflowEngine.contentReleaseName({ ref, perspective })
-        })
-      } : {
-        key: ref.globalDocumentId,
-        store: observer$1.sdkContentDocStore({
-          sdk: requireSdk(`"${ref.globalDocumentId}" lives outside this workspace`),
-          ref,
-          perspective
-        })
-      })
-    ),
-    observeGuards: (instanceId, resources) => observer.combineGuardStores(
-      resources.map((resource) => {
-        if (observer.sameDataset(resource, mounted)) {
-          const { query, params } = workflowEngine.instanceGuardQuery(instanceId);
-          return observableStore({
-            observable: documentStore.listenQuery(query, params, {}),
-            resolve: (docs) => docs,
-            initial: void 0
-          });
-        }
-        return observer$1.sdkGuardStore({
-          sdk: requireSdk(
-            `guards for "${instanceId}" live in ${resource.projectId}.${resource.dataset}`
-          ),
-          instanceId,
-          resource
-        });
-      })
-    ),
-    observeInstances: (query) => engineIsMounted ? observableStore({
-      observable: documentStore.listenQuery(query.query, query.params, {}),
-      resolve: (docs) => docs,
-      initial: void 0
-    }) : observer$1.sdkInstancesStore({
-      sdk: requireSdk(
-        `the instance list lives in the engine dataset ${engineResource.projectId}.${engineResource.dataset}`
-      ),
-      query,
-      resource: engineResource
-    })
-  };
+    const {mounted: mounted, engineResource: engineResource, sdk: sdk2, client: client} = options, engineIsMounted = observer.sameDataset(engineResource, mounted), editStateStore = ({id: id, type: type, release: release, draftFallback: draftFallback}) => observableStore({
+        observable: documentStore.pair.editState(id, type, release),
+        resolve: editState => resolveEditState(editState, draftFallback),
+        initial: void 0,
+        name: `the edit state of "${id}"`
+    }), requireSdk = what => {
+        if (sdk2 !== void 0) return sdk2;
+        throw new Error(`@sanity/workflow-studio: ${what} — Studio's document store is bound to ${mounted.projectId}.${mounted.dataset} and cannot observe it. Pass an App SDK instance via the hook's \`sdk\` option (e.g. \`useWorkflowSession({engine, instanceId, sdk})\`) to observe foreign resources.`);
+    };
+    return {
+        observeInstance: instanceId => engineIsMounted ? editStateStore({
+            id: instanceId,
+            type: workflowEngine.WORKFLOW_INSTANCE_TYPE,
+            release: void 0,
+            draftFallback: !0
+        }) : observer$1.sdkInstanceDocStore({
+            sdk: requireSdk(`instance "${instanceId}" lives in the engine dataset ${engineResource.projectId}.${engineResource.dataset}`),
+            instanceId: instanceId,
+            engineResource: engineResource
+        }),
+        observeDocs: (documents, perspective) => observer.combineDocStores(documents.map(ref => observer.classifyRef(ref, mounted) === "mounted-dataset" ? {
+            key: ref.globalDocumentId,
+            store: editStateStore({
+                id: ref.documentId,
+                type: ref.type,
+                release: workflowEngine.contentReleaseName({
+                    ref: ref,
+                    perspective: perspective
+                }),
+                draftFallback: workflowEngine.contentDraftFallback({
+                    ref: ref,
+                    perspective: perspective
+                })
+            })
+        } : {
+            key: ref.globalDocumentId,
+            store: observer$1.sdkContentDocStore({
+                sdk: requireSdk(`"${ref.globalDocumentId}" lives outside this workspace`),
+                ref: ref,
+                perspective: perspective
+            })
+        })),
+        observeGuards: (instanceId, resources) => observer.combineGuardStores(resources.map(resource => {
+            if (observer.sameDataset(resource, mounted)) {
+                const {query: query, params: params} = workflowEngine.instanceGuardQuery(instanceId);
+                return observableStore({
+                    observable: documentStore.listenQuery(query, params, {}),
+                    resolve: docs => docs,
+                    initial: void 0,
+                    name: `the guard list for "${instanceId}"`
+                });
+            }
+            return observer$1.sdkGuardStore({
+                sdk: requireSdk(`guards for "${instanceId}" live in ${resource.projectId}.${resource.dataset}`),
+                instanceId: instanceId,
+                resource: resource
+            });
+        })),
+        observeInstances: query => engineIsMounted ? observableStore({
+            observable: documentStore.listenQuery(query.query, query.params, {}),
+            resolve: docs => docs,
+            initial: void 0,
+            name: "the instance list"
+        }) : observer$1.sdkInstancesStore({
+            sdk: requireSdk(`the instance list lives in the engine dataset ${engineResource.projectId}.${engineResource.dataset}`),
+            query: query,
+            resource: engineResource
+        }),
+        ensureDocumentExists: args => observer.ensureDocumentExists(client, args)
+    };
 }
-function resolveEditState(editState) {
-  if (editState.ready)
-    return editState.version ?? editState.draft ?? editState.published;
+
+function resolveEditState(editState, draftFallback) {
+    if (!editState.ready) return;
+    const draft = draftFallback ? editState.draft : null;
+    return editState.version ?? draft ?? editState.published;
 }
-function useWorkflowEngine({
-  workflowResource,
-  tag,
-  resourceClients,
-  apiVersion
-}) {
-  const client = sanity.useClient({ apiVersion: apiVersion ?? workflowEngine.ENGINE_API_VERSION }), resource = observer.useKeyed([workflowResource.type, workflowResource.id], () => workflowResource);
-  return react.useMemo(() => {
-    const engineDataset = observer.datasetResourceId(resource), engineClient = client.withConfig({
-      projectId: engineDataset.projectId,
-      dataset: engineDataset.dataset,
-      useCdn: !1
-    });
-    return workflowEngine.createEngine({
-      client: engineClient,
-      workflowResource: resource,
-      tag,
-      resourceClients: resourceClients ?? studioResourceClients(client)
+
+const SESSION_CLIENT_OPTIONS = {
+    apiVersion: workflowEngine.ENGINE_API_VERSION
+};
+
+function useStudioObserver({engine: engine, sdk: suppliedSdk}) {
+    const documentStore = sanity.useDocumentStore(), source = sanity.useSource(), {projectId: projectId, dataset: dataset} = source, mounted = react.useMemo(() => ({
+        projectId: projectId,
+        dataset: dataset
+    }), [ projectId, dataset ]), engineResource = react.useMemo(() => observer.datasetResourceId(engine.workflowResource), [ engine ]), sdk2 = useEmbeddedSdk({
+        supplied: suppliedSdk,
+        needed: !observer.sameDataset(engineResource, mounted),
+        mounted: mounted,
+        sessionToken: source.getClient(SESSION_CLIENT_OPTIONS).config().token
     });
-  }, [client, resource, tag, resourceClients]);
-}
-function studioResourceClients(client) {
-  return (parsed) => parsed.scheme === "dataset" && parsed.projectId !== void 0 && parsed.dataset !== void 0 ? client.withConfig({ projectId: parsed.projectId, dataset: parsed.dataset, useCdn: !1 }) : void 0;
-}
-const SESSION_CLIENT_OPTIONS = { apiVersion: workflowEngine.ENGINE_API_VERSION };
-function useStudioObserver({
-  engine,
-  sdk: suppliedSdk
-}) {
-  const documentStore = sanity.useDocumentStore(), source = sanity.useSource(), { projectId, dataset } = source, mounted = react.useMemo(() => ({ projectId, dataset }), [projectId, dataset]), engineResource = react.useMemo(() => observer.datasetResourceId(engine.workflowResource), [engine]), sdk2 = useEmbeddedSdk({
-    supplied: suppliedSdk,
-    // The engine dataset being foreign is the signal an SDK instance is
-    // needed; foreign content refs without one still fail loud per ref.
-    needed: !observer.sameDataset(engineResource, mounted),
-    mounted,
-    // The session's token rides the source client's config (absent under
-    // cookie auth) — the public read; Studio's token storage is private.
-    sessionToken: source.getClient(SESSION_CLIENT_OPTIONS).config().token
-  });
-  return react.useMemo(
-    () => makeStudioObserver(documentStore, {
-      mounted,
-      engineResource,
-      ...sdk2 !== void 0 ? { sdk: sdk2 } : {}
-    }),
-    [documentStore, mounted, engineResource, sdk2]
-  );
+    return react.useMemo(() => makeStudioObserver(documentStore, {
+        mounted: mounted,
+        client: source.getClient(SESSION_CLIENT_OPTIONS),
+        engineResource: engineResource,
+        ...sdk2 !== void 0 ? {
+            sdk: sdk2
+        } : {}
+    }), [ documentStore, source, mounted, engineResource, sdk2 ]);
 }
-function useEmbeddedSdk({
-  supplied,
-  needed,
-  mounted,
-  sessionToken
-}) {
-  const wanted = supplied === void 0 && needed, held = react.useRef(void 0), key = `${mounted.projectId}.${mounted.dataset}`;
-  wanted && (held.current?.key !== key || held.current.instance.isDisposed()) && (held.current = { key, instance: bootstrapInstance(mounted, sessionToken) });
-  const embedded = wanted ? held.current?.instance : void 0;
-  return useDeferredDispose(embedded), supplied ?? embedded;
+
+function useEmbeddedSdk({supplied: supplied, needed: needed, mounted: mounted, sessionToken: sessionToken}) {
+    const wanted = supplied === void 0 && needed, held = react.useRef(void 0), key = `${mounted.projectId}.${mounted.dataset}`;
+    wanted && (held.current?.key !== key || held.current.instance.isDisposed()) && (held.current = {
+        key: key,
+        instance: bootstrapInstance(mounted, sessionToken)
+    });
+    const embedded = wanted ? held.current?.instance : void 0;
+    return useDeferredDispose(embedded), supplied ?? embedded;
 }
+
 function bootstrapInstance(mounted, sessionToken) {
-  if (sessionToken === void 0)
-    throw new Error(
-      "@sanity/workflow-studio: the engine's state dataset is not this workspace's dataset, and no Studio session token is readable to bootstrap an App SDK instance (cookie-authenticated studio?). Pass one explicitly via the hook's `sdk` option, e.g. useWorkflowSession({engine, instanceId, sdk})."
-    );
-  return sdk.createSanityInstance({
-    projectId: mounted.projectId,
-    dataset: mounted.dataset,
-    auth: { token: sessionToken }
-  });
+    if (sessionToken === void 0) throw new Error("@sanity/workflow-studio: the engine's state dataset is not this workspace's dataset, and no Studio session token is readable to bootstrap an App SDK instance (cookie-authenticated studio?). Pass one explicitly via the hook's `sdk` option, e.g. useWorkflowSession({engine, instanceId, sdk}).");
+    return sdk.createSanityInstance({
+        projectId: mounted.projectId,
+        dataset: mounted.dataset,
+        auth: {
+            token: sessionToken
+        }
+    });
 }
+
 function useDeferredDispose(instance) {
-  const disposal = react.useRef(void 0);
-  react.useEffect(() => {
-    if (instance !== void 0)
-      return disposal.current?.instance === instance && (clearTimeout(disposal.current.timeoutId), disposal.current = void 0), () => {
-        disposal.current = {
-          instance,
-          timeoutId: setTimeout(() => {
-            instance.isDisposed() || instance.dispose();
-          }, 0)
+    const disposal = react.useRef(void 0);
+    react.useEffect(() => {
+        if (instance !== void 0) return disposal.current?.instance === instance && (clearTimeout(disposal.current.timeoutId), 
+        disposal.current = void 0), () => {
+            disposal.current = {
+                instance: instance,
+                timeoutId: setTimeout(() => {
+                    instance.isDisposed() || instance.dispose();
+                }, 0)
+            };
         };
-      };
-  }, [instance]);
+    }, [ instance ]);
 }
-function useWorkflowSession({
-  engine,
-  instanceId,
-  access,
-  grantsFromPath,
-  sdk: sdk2
-}) {
-  const observer2 = useStudioObserver({ engine, sdk: sdk2 });
-  return workflowReact.useWorkflowSession({ engine, instanceId, observer: observer2, opts: { access, grantsFromPath } });
+
+function useWorkflowEngine({workflowResource: workflowResource, tag: tag, resourceClients: resourceClients, effectHandlers: effectHandlers, missingHandler: missingHandler}) {
+    const client = sanity.useClient({
+        apiVersion: workflowEngine.ENGINE_API_VERSION
+    }), resource = observer.useKeyed([ workflowResource.type, workflowResource.id ], () => workflowResource), telemetry = workflowReact.useWorkflowTelemetry();
+    return react.useMemo(() => {
+        const engineDataset = observer.datasetResourceId(resource), engineClient = client.withConfig({
+            projectId: engineDataset.projectId,
+            dataset: engineDataset.dataset,
+            useCdn: !1,
+            requestTagPrefix: "sanity.workflows.studio"
+        });
+        return workflowEngine.createEngine({
+            client: engineClient,
+            workflowResource: resource,
+            tag: tag,
+            resourceClients: resourceClients ?? studioResourceClients(client),
+            executionContext: {
+                kind: workflowEngine.EXECUTION_KINDS.studio
+            },
+            ...effectHandlers !== void 0 ? {
+                effectHandlers: effectHandlers
+            } : {},
+            ...missingHandler !== void 0 ? {
+                missingHandler: missingHandler
+            } : {},
+            telemetry: telemetry
+        });
+    }, [ client, resource, tag, resourceClients, effectHandlers, missingHandler, telemetry ]);
 }
-function useWorkflowInstances({
-  engine,
-  filter,
-  sdk: sdk2
-}) {
-  const observer2 = useStudioObserver({ engine, sdk: sdk2 });
-  return workflowReact.useWorkflowInstances({ engine, observer: observer2, ...filter !== void 0 ? { filter } : {} });
+
+function studioResourceClients(client) {
+    return parsed => parsed.scheme === "dataset" && parsed.projectId !== void 0 && parsed.dataset !== void 0 ? client.withConfig({
+        projectId: parsed.projectId,
+        dataset: parsed.dataset,
+        useCdn: !1,
+        requestTagPrefix: "sanity.workflows.studio"
+    }) : void 0;
+}
+
+function useWorkflowSession({engine: engine, instanceId: instanceId, grantsFromPath: grantsFromPath, sdk: sdk2}) {
+    const observer2 = useStudioObserver({
+        engine: engine,
+        sdk: sdk2
+    });
+    return workflowReact.useWorkflowSession({
+        engine: engine,
+        instanceId: instanceId,
+        observer: observer2,
+        host: "studio",
+        opts: {
+            grantsFromPath: grantsFromPath
+        }
+    });
 }
-function useDocumentWorkflows({
-  engine,
-  document,
-  sdk: sdk2
-}) {
-  const observer2 = useStudioObserver({ engine, sdk: sdk2 });
-  return workflowReact.useDocumentWorkflows({ engine, observer: observer2, document });
+
+function useWorkflowInstances({engine: engine, filter: filter, sdk: sdk2}) {
+    const observer2 = useStudioObserver({
+        engine: engine,
+        sdk: sdk2
+    });
+    return workflowReact.useWorkflowInstances({
+        engine: engine,
+        observer: observer2,
+        ...filter !== void 0 ? {
+            filter: filter
+        } : {}
+    });
+}
+
+function useDocumentWorkflows({engine: engine, document: document, sdk: sdk2}) {
+    const observer2 = useStudioObserver({
+        engine: engine,
+        sdk: sdk2
+    });
+    return workflowReact.useDocumentWorkflows({
+        engine: engine,
+        observer: observer2,
+        document: document
+    });
 }
+
 exports.makeStudioObserver = makeStudioObserver;
+
 exports.studioResourceClients = studioResourceClients;
+
 exports.useDocumentWorkflows = useDocumentWorkflows;
+
+exports.useStudioObserver = useStudioObserver;
+
 exports.useWorkflowEngine = useWorkflowEngine;
+
 exports.useWorkflowInstances = useWorkflowInstances;
+
 exports.useWorkflowSession = useWorkflowSession;
-//# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -1,13 +1,15 @@
 import { DatasetResourceId } from "@sanity/workflow-react/observer";
 import type { DocumentStore } from "sanity";
+import { EffectHandler } from "@sanity/workflow-engine";
 import { Engine } from "@sanity/workflow-engine";
 import type { GdrUri } from "@sanity/workflow-engine";
 import type { InstancesQueryFilter } from "@sanity/workflow-engine";
+import { MissingHandlerPolicy } from "@sanity/workflow-engine";
 import { MutationGuardDoc } from "@sanity/workflow-react";
 import { ResourceClientResolver } from "@sanity/workflow-engine";
-import type { SanityInstance } from "@sanity/sdk";
+import type { SanityClient } from "sanity";
+import { SanityInstance } from "@sanity/sdk";
 import { useClient } from "sanity";
-import type { WorkflowAccessOverride } from "@sanity/workflow-engine";
 import { WorkflowInstanceList } from "@sanity/workflow-react";
 import { WorkflowObserver } from "@sanity/workflow-react/observer";
 import { WorkflowResource } from "@sanity/workflow-engine";
@@ -40,6 +42,9 @@ export declare interface StudioObserverOptions {
   /** The workspace's project + dataset — the only resource Studio's
    *  `documentStore` can address. */
   mounted: DatasetResourceId;
+  /** A workspace-bound client — carries `ensureDocumentExists` writes, which
+   *  address the mounted dataset (where the workspace's subject docs live). */
+  client: SanityClient;
   /** The engine's state dataset (`datasetResourceId(engine.workflowResource)`)
    *  — where the instance doc and its verdict-relevant guards live. Routinely
    *  a dedicated `workflows` dataset distinct from the workspace. */
@@ -54,9 +59,11 @@ export declare interface StudioObserverOptions {
 /**
  * The default Studio {@link ResourceClientResolver}: any fully-addressed
  * `dataset:` GDR resolves to the workspace client rebound to that
- * project/dataset; other schemes (media-library, canvas) return `undefined` so
- * the engine falls back to its own client. A custom resolver can delegate to
- * this for the dataset arm and handle other schemes itself.
+ * project/dataset; other schemes (media-library, canvas) return `undefined`,
+ * letting the engine route them — a sibling client derived from the engine
+ * client's own credentials for foreign resources, its own client for the
+ * workflow resource. A custom resolver can delegate to this for the dataset
+ * arm and handle other schemes itself.
  */
 export declare function studioResourceClients(
   client: StudioClient,
@@ -75,26 +82,46 @@ export declare function useDocumentWorkflows({
   sdk?: SanityInstance;
 }): WorkflowInstanceList;
 
+/**
+ * The Studio observer for this engine — the shared wiring under every
+ * reactive hook in this package. Workspace-dataset streams ride
+ * `documentStore`; anything foreign (routinely the engine's dedicated
+ * `workflows` dataset) rides an App SDK instance, bootstrapped from the
+ * Studio session when the caller doesn't supply one. Must run inside Studio
+ * source context (so `useDocumentStore`/`useSource` resolve).
+ */
+export declare function useStudioObserver({
+  engine,
+  sdk: suppliedSdk,
+}: {
+  engine: Engine;
+  sdk?: SanityInstance | undefined;
+}): WorkflowObserver;
+
 /**
  * Build the Studio-side engine once: the workspace client rebound to the
  * engine's state dataset, plus {@link studioResourceClients} as the default
  * per-resource routing — so subjects and refs across many content datasets
  * resolve without call sites assembling clients. Pass `resourceClients` to
  * override the routing (compose with {@link studioResourceClients} to keep
- * dataset-GDR routing). Memoized on the config's content, so inline
- * `workflowResource` literals are fine; a custom `resourceClients` function
- * should still be stable. Must render inside Studio source context.
+ * dataset-GDR routing). `effectHandlers`/`missingHandler` feed
+ * {@link Engine.drainEffects} for engines that drain effects in the Studio.
+ * Memoized on the config's content, so inline `workflowResource` literals are
+ * fine; custom `resourceClients` and `effectHandlers` values should still be
+ * stable. Must render inside Studio source context.
  */
 export declare function useWorkflowEngine({
   workflowResource,
   tag,
   resourceClients,
-  apiVersion,
+  effectHandlers,
+  missingHandler,
 }: {
   workflowResource: WorkflowResource;
   tag: string;
   resourceClients?: ResourceClientResolver;
-  apiVersion?: string;
+  effectHandlers?: Record<string, EffectHandler>;
+  missingHandler?: MissingHandlerPolicy;
 }): Engine;
 
 /** A live, filterable workflow-instance list observed from Sanity Studio —
@@ -120,19 +147,18 @@ export declare function useWorkflowInstances({
  * from the workspace, an SDK instance is bootstrapped automatically from the
  * Studio session (pass `sdk` to supply your own — required for
  * cookie-authenticated studios, where no session token is readable). Returns
- * `{evaluation, ready, guards, tick, fireAction, editField}`; the consumer decides when
- * to advance. Must render inside Studio source context.
+ * the full {@link WorkflowSession} (evaluation, ready, guards, and the
+ * tick/fireAction/editField/preview verbs); the consumer decides when to
+ * advance. Must render inside Studio source context.
  */
 export declare function useWorkflowSession({
   engine,
   instanceId,
-  access,
   grantsFromPath,
   sdk,
 }: {
   engine: Engine;
   instanceId: string;
-  access?: WorkflowAccessOverride;
   grantsFromPath?: string;
   sdk?: SanityInstance;
 }): WorkflowSession;