@sanity/workflow-studio 0.31.0 → 0.33.0

package/CHANGELOG.md

@@ -1,5 +1,81 @@
 # @sanity/workflow-studio
 
+## 0.33.0
+
+### Minor Changes
+
+- 225e0fb: **BREAKING:** Workflows App SDK and Studio integrations now require `@sanity/sdk` 3.1 or later in the 3.x line, and `@sanity/workflow-sdk` requires the matching `@sanity/sdk-react` 3.1 line when its React entry is used. The previous SDK 2 peer contract is no longer supported. The exported `WorkflowClient`, `TelemetryIntakeClient`, `ProjectUserProfileClient`, and `StudioUserClient` request contracts now pass their target in `url`; the previous `uri` request target is no longer used. The engine's effective client config also accepts the broader `{type: string, id: string}` resource descriptors returned by Sanity client 8.
+
+  Before upgrading Workflows, upgrade `@sanity/sdk` and `@sanity/sdk-react` together to 3.1 or later. Applications that stay on SDK 2 must stay on an earlier Workflows release. If you implement any of the request contracts named above, update it to read the request target from `url` instead of `uri`; otherwise its request-backed reads will fail. Existing `WorkflowClient.config()` implementations need no change when their resource descriptor already has string `type` and `id` fields. No separate CLI upgrade action is required; its definition-sharing and telemetry requests adopt `url` internally.
+
+  Before installing, override SDK 3's `@sanity/mutate` dependency to `0.18.2` in your application's root package-manager configuration, reinstall, and commit the updated lockfile. SDK 3.1.0 allows Mutate 0.18.1, which can leave document reads pending with client 8. For npm, set `overrides["@sanity/sdk"]["@sanity/mutate"]` to `"0.18.2"` in `package.json`. For pnpm, set `overrides['@sanity/sdk@3>@sanity/mutate']` to `0.18.2` in `pnpm-workspace.yaml`. Keep the override until your SDK release requires Mutate 0.18.2 or later. Complete examples and verification steps are in the Installation section of the published `@sanity/workflow-sdk` README.
+
+  Malformed project-member responses now report an inaccessible directory and can recover on a later lookup, instead of being cached as a missing user. No additional upgrade action is required for this correction.
+
+  **Docs impact:** Update the App SDK and Studio integration installation guidance, package compatibility references, and examples to require Sanity App SDK 3.1 and the consumer Mutate override described in the published `@sanity/workflow-sdk` README; update the client API references for `request({url})`, effective resource descriptors, and directory-response failures.
+
+### Patch Changes
+
+- 7eb9eca: Correct the API references for field initialization and edits, start requirements,
+  transitions, reference IDs, effect handling, reactive state, member controls,
+  Studio mappings, test helpers, and GROQ condition outcomes. The references state
+  caller constraints and defaults that were missing or incorrect. Package setup
+  guidance identifies the public npm packages and supported deployment command;
+  the MCP validation description distinguishes validation from deployment checks.
+  Runtime behavior and API signatures are unchanged.
+
+  **No upgrade action required.**
+
+  **Docs impact:** After release and reference sync, reconcile the modeling,
+  runtime, reactive UI, Studio, testing, deployment, MCP, and evaluation-insight
+  guides and references with the corrected contracts. Fix affected examples and
+  replace redundant API inventories with verified symbol links while preserving
+  useful teaching and the CLI/MCP reference material not exposed by TypeDoc.
+
+- Updated dependencies [393ac71]
+- Updated dependencies [8874c50]
+- Updated dependencies [0555271]
+- Updated dependencies [b3b2797]
+- Updated dependencies [225e0fb]
+- Updated dependencies [7eb9eca]
+- Updated dependencies [2cef086]
+- Updated dependencies [232f811]
+  - @sanity/workflow-engine@0.33.0
+  - @sanity/workflow-sdk@0.33.0
+  - @sanity/workflow-react@0.33.0
+
+## 0.32.0
+
+### Minor Changes
+
+- 2de38fd: **BREAKING:** `createEngine` takes its effect settings as one `effects` group. The top-level `effectHandlers`, `effectLeaseMs`, and `missingHandler` options are removed, with no alias and no deprecation shim, so everyone who builds an engine — a Sanity Function drainer, a hosted runtime, a script, a test — must move them into `effects: {handlers, leaseMs, missingHandler}`. An unmigrated TypeScript call stops compiling. An unmigrated plain-JavaScript call still builds an engine, but one with no handlers and the default `fail` policy, so its first drain throws `MissingHandlerError` instead of dispatching.
+
+  Migrate every construction site: `createEngine({client, workflowResource, tag, effectHandlers: H, effectLeaseMs: L, missingHandler: P})` becomes `createEngine({client, workflowResource, tag, effects: {handlers: H, leaseMs: L, missingHandler: P}})`. The resolved values read back off the engine under the same word, so `engine.effectHandlers` and `engine.missingHandler` become `engine.effects.handlers` and `engine.effects.missingHandler`. Nothing about draining changes: the same `fail` default, the same five-minute default lease, and the same claim, dispatch, and deploy-verification semantics. `@sanity/workflow-engine-test`'s `createBenchEngine(bench, overrides)` forwards `CreateEngineArgs` unchanged, so bench engines move their handler and policy overrides into the same group.
+
+  `@sanity/workflow-studio`'s `useWorkflowEngine` follows the engine: its `effectHandlers` and `missingHandler` props are replaced by one `effects` prop taking the engine's exported `EngineEffectsArgs`, so a Studio-side drainer passes `effects: {handlers, missingHandler}`. Keep that object referentially stable, at module scope or through `useMemo` — the hook memoizes the engine on it, and a new object every render rebuilds the engine every render. The `@sanity/workflow-studio-plugin` `effectHandlers` config key is unchanged; the plugin translates it into the group where it builds the engine.
+
+  **Docs impact:** Update the `createEngine` options reference and the effects concepts page for the new group, the missing-handler and claim-lease reference entries that named the old keys, the `useWorkflowEngine` adapter reference, the Studio plugin README's drain-function example, and every cookbook or runtime example that constructs an engine with handlers; carry the migration into the release notes.
+
+- 26dd4e5: Generated API references now include every type used by a public signature and link cross-package symbols to their authoritative package entry. Caller-facing helper contracts such as field mutation operations, engine operation context types, test-bench argument types, member avatar data, MCP client policy, and Studio user clients are now available as named exports where their public APIs already expose those shapes. GROQ condition consumers can import the documented `COMPARISON_OPS` list alongside its `ComparisonOp` type, while the shared cross-package exhaustiveness helper is an unsupported `@internal` export and is omitted from the reference.
+
+  **No upgrade action required.** Existing imports and runtime behavior remain compatible; consumers may adopt the new named type exports instead of reconstructing those shapes locally.
+
+  **Docs impact:** Refresh the generated API references for the affected packages; no conceptual guides, examples, or migration guidance need changes.
+
+### Patch Changes
+
+- Updated dependencies [a8ed312]
+- Updated dependencies [2ba0c09]
+- Updated dependencies [2de38fd]
+- Updated dependencies [a2ce4a7]
+- Updated dependencies [2ddd3d7]
+- Updated dependencies [6035672]
+- Updated dependencies [26dd4e5]
+- Updated dependencies [b04580d]
+  - @sanity/workflow-engine@0.32.0
+  - @sanity/workflow-react@0.32.0
+  - @sanity/workflow-sdk@0.32.0
+
 ## 0.31.0
 
 ### Patch Changes

package/README.md

@@ -99,12 +99,26 @@ live cross-dataset end-to-end verification) are known follow-up work.
 This adapter composes `@sanity/workflow-sdk`'s store layer through its headless
 `./observer` entry. What that means for installs:
 
-- **`@sanity/sdk` is required** (peer) — it addresses every observed resource.
+- **`@sanity/sdk` 3.1 or later in the 3.x line is required** (peer) — it addresses every observed resource.
 - **`@sanity/workflow-engine` is required** (peer) — the host and adapter share one engine runtime.
 - **`@sanity/workflow-react` and `@sanity/workflow-sdk` are required** (exact-version peers) — install the matching Workflows release stack so the reactive context and SDK store are single-sourced.
 - **`@sanity/sdk-react` is NOT required** — nothing here touches the App
   SDK's React binding.
 
+Before installing, configure your application's root overrides to select
+Mutate 0.18.2 for SDK 3. For npm, set
+`overrides["@sanity/sdk"]["@sanity/mutate"]` to `"0.18.2"` in
+`package.json`. For pnpm, set
+`overrides['@sanity/sdk@3>@sanity/mutate']` to `0.18.2` in
+`pnpm-workspace.yaml`. An existing lockfile can otherwise retain Mutate
+0.18.1 and leave document reads pending.
+
+Reinstall, commit the configuration and lockfile, and verify SDK 3 resolves
+Mutate 0.18.2 with `npm ls @sanity/sdk @sanity/mutate` or
+`pnpm why @sanity/mutate`. Remove the override only once your SDK release
+requires Mutate 0.18.2 or later. Complete examples are in the
+[SDK package's installation guide](https://www.npmjs.com/package/@sanity/workflow-sdk#installation).
+
 `useSource` remains a non-public Studio context hook, which is the standard
 plugin-context caveat.
 

package/dist/index.cjs

@@ -103,7 +103,7 @@ function useSharedDispose(owner, shared) {
     }, [ owner, shared ]);
 }
 
-function useWorkflowEngine({workflowResource: workflowResource, tag: tag, resourceClients: resourceClients, effectHandlers: effectHandlers, missingHandler: missingHandler}) {
+function useWorkflowEngine({workflowResource: workflowResource, tag: tag, resourceClients: resourceClients, effects: effects}) {
     const client = sanity.useClient({
         apiVersion: workflowEngine.ENGINE_API_VERSION
     }), resource = observer.useKeyed([ workflowResource.type, workflowResource.id ], () => workflowResource), telemetry = workflowReact.useWorkflowTelemetry();
@@ -122,15 +122,12 @@ function useWorkflowEngine({workflowResource: workflowResource, tag: tag, resour
             executionContext: {
                 kind: workflowEngine.EXECUTION_KINDS.studio
             },
-            ...effectHandlers !== void 0 ? {
-                effectHandlers: effectHandlers
-            } : {},
-            ...missingHandler !== void 0 ? {
-                missingHandler: missingHandler
+            ...effects !== void 0 ? {
+                effects: effects
             } : {},
             telemetry: telemetry
         });
-    }, [ client, resource, tag, resourceClients, effectHandlers, missingHandler, telemetry ]);
+    }, [ client, resource, tag, resourceClients, effects, telemetry ]);
 }
 
 function studioResourceClients(client) {
@@ -218,15 +215,11 @@ function isRole(value) {
 }
 
 function isMembership(value) {
-    return isRecord(value) && typeof value.id == "string" && (value.isRobot === void 0 || typeof value.isRobot == "boolean") && (value.isCurrentUser === void 0 || typeof value.isCurrentUser == "boolean") && (value.roles === void 0 || Array.isArray(value.roles) && value.roles.every(isRole));
+    return (value.isCurrentUser === void 0 || typeof value.isCurrentUser == "boolean") && (value.roles === void 0 || Array.isArray(value.roles) && value.roles.every(isRole));
 }
 
 async function fetchProjectUsers(client, projectId) {
-    const project = await client.request({
-        uri: `/projects/${projectId}`
-    });
-    if (!isRecord(project) || !Array.isArray(project.members)) throw new Error("Studio project user response did not contain a members array");
-    const membershipRows = project.members;
+    const membershipRows = await workflowEngine._requestProjectMembers(options => client.request(options), projectId);
     if (!membershipRows.every(isMembership)) throw new Error("Studio project user response contained an invalid membership row");
     const memberships = membershipRows.filter(member => !member.isRobot);
     if (memberships.length === 0) return [];

package/dist/index.d.cts

@@ -1,16 +1,16 @@
 import { DatasetResourceId } from "@sanity/workflow-react/observer";
-import { EffectHandler } from "@sanity/workflow-engine";
 import { Engine } from "@sanity/workflow-engine";
+import { EngineEffectsArgs } from "@sanity/workflow-engine";
 import { EnsureDocumentClient } from "@sanity/workflow-react/observer";
 import type { GdrUri } from "@sanity/workflow-engine";
 import { InstancePreviewList } from "@sanity/workflow-react";
 import { InstancePreviewsFilter } from "@sanity/workflow-react";
 import type { InstancesQueryFilter } from "@sanity/workflow-engine";
-import { MissingHandlerPolicy } from "@sanity/workflow-engine";
 import { MutationGuardDoc } from "@sanity/workflow-react";
 import { ProjectRole } from "@sanity/workflow-sdk/project-users";
 import { ProjectUserDirectory } from "@sanity/workflow-engine";
 import { ProjectUserProfile } from "@sanity/workflow-sdk/project-users";
+import { ProjectUserProfileClient } from "@sanity/workflow-sdk/project-users";
 import { ResourceClientResolver } from "@sanity/workflow-engine";
 import { SanityClient } from "sanity";
 import { SanityInstance } from "@sanity/sdk";
@@ -94,14 +94,10 @@ export declare function studioResourceClients(
   client: SanityClient,
 ): ResourceClientResolver;
 
-declare interface StudioUserClient {
+export declare interface StudioUserClient extends ProjectUserProfileClient {
   readonly config: () => {
     readonly projectId?: string;
   };
-  readonly request: (options: {
-    readonly uri: string;
-    readonly tag?: string;
-  }) => Promise<unknown>;
 }
 
 export declare interface StudioUserProfile extends ProjectUserProfile {
@@ -144,24 +140,22 @@ export declare function useStudioProjectUsers(): StudioProjectUsersState;
  * 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). `effectHandlers`/`missingHandler` feed
- * {@link Engine.drainEffects} for engines that drain effects in the Studio.
+ * dataset-GDR routing). `effects` feeds {@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
+ * fine; custom `resourceClients` and `effects` values should still be
  * stable. Must render inside Studio source context.
  */
 export declare function useWorkflowEngine({
   workflowResource,
   tag,
   resourceClients,
-  effectHandlers,
-  missingHandler,
+  effects,
 }: {
   workflowResource: WorkflowResource;
   tag: string;
   resourceClients?: ResourceClientResolver;
-  effectHandlers?: Record<string, EffectHandler<SanityClient>>;
-  missingHandler?: MissingHandlerPolicy;
+  effects?: EngineEffectsArgs<SanityClient>;
 }): Engine;
 
 /** A live, progressively-hydrated instance-preview list observed from Sanity
@@ -176,8 +170,10 @@ export declare function useWorkflowInstancePreviews({
 }: {
   engine: Engine;
   filter?: InstancePreviewsFilter;
-  /** A development throttle between hydration pages; leave unset in production. */
+  /** Milliseconds between hydration pages. Defaults to `0`, with no delay.
+   *  Leave unset in production; use a delay to inspect progressive loading. */
   interPageDelayMs?: number;
+  /** Rows per hydration page. Defaults to `500`. */
   pageSize?: number;
   sdk?: SanityInstance;
 }): InstancePreviewList;
@@ -214,6 +210,10 @@ export declare function useWorkflowSession({
 }: {
   engine: Engine;
   instanceId: string;
+  /** URL path where the engine client reads the actor's ACL grants, such as
+   *  `/projects/PROJECT_ID/datasets/DATASET/acl` or `/canvases/CANVAS_ID/acl`.
+   *  Supply it for conditions using `$can`; omission leaves `$can` undefined.
+   *  Grants inform advisory verdicts. Content Lake enforces writes. */
   grantsFromPath?: string;
   /** The id-set of every co-mounted session, handed identically to each one
    *  so guard observation consolidates into one shared live query per

package/dist/index.d.ts

@@ -1,16 +1,16 @@
 import { DatasetResourceId } from "@sanity/workflow-react/observer";
-import { EffectHandler } from "@sanity/workflow-engine";
 import { Engine } from "@sanity/workflow-engine";
+import { EngineEffectsArgs } from "@sanity/workflow-engine";
 import { EnsureDocumentClient } from "@sanity/workflow-react/observer";
 import type { GdrUri } from "@sanity/workflow-engine";
 import { InstancePreviewList } from "@sanity/workflow-react";
 import { InstancePreviewsFilter } from "@sanity/workflow-react";
 import type { InstancesQueryFilter } from "@sanity/workflow-engine";
-import { MissingHandlerPolicy } from "@sanity/workflow-engine";
 import { MutationGuardDoc } from "@sanity/workflow-react";
 import { ProjectRole } from "@sanity/workflow-sdk/project-users";
 import { ProjectUserDirectory } from "@sanity/workflow-engine";
 import { ProjectUserProfile } from "@sanity/workflow-sdk/project-users";
+import { ProjectUserProfileClient } from "@sanity/workflow-sdk/project-users";
 import { ResourceClientResolver } from "@sanity/workflow-engine";
 import { SanityClient } from "sanity";
 import { SanityInstance } from "@sanity/sdk";
@@ -94,14 +94,10 @@ export declare function studioResourceClients(
   client: SanityClient,
 ): ResourceClientResolver;
 
-declare interface StudioUserClient {
+export declare interface StudioUserClient extends ProjectUserProfileClient {
   readonly config: () => {
     readonly projectId?: string;
   };
-  readonly request: (options: {
-    readonly uri: string;
-    readonly tag?: string;
-  }) => Promise<unknown>;
 }
 
 export declare interface StudioUserProfile extends ProjectUserProfile {
@@ -144,24 +140,22 @@ export declare function useStudioProjectUsers(): StudioProjectUsersState;
  * 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). `effectHandlers`/`missingHandler` feed
- * {@link Engine.drainEffects} for engines that drain effects in the Studio.
+ * dataset-GDR routing). `effects` feeds {@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
+ * fine; custom `resourceClients` and `effects` values should still be
  * stable. Must render inside Studio source context.
  */
 export declare function useWorkflowEngine({
   workflowResource,
   tag,
   resourceClients,
-  effectHandlers,
-  missingHandler,
+  effects,
 }: {
   workflowResource: WorkflowResource;
   tag: string;
   resourceClients?: ResourceClientResolver;
-  effectHandlers?: Record<string, EffectHandler<SanityClient>>;
-  missingHandler?: MissingHandlerPolicy;
+  effects?: EngineEffectsArgs<SanityClient>;
 }): Engine;
 
 /** A live, progressively-hydrated instance-preview list observed from Sanity
@@ -176,8 +170,10 @@ export declare function useWorkflowInstancePreviews({
 }: {
   engine: Engine;
   filter?: InstancePreviewsFilter;
-  /** A development throttle between hydration pages; leave unset in production. */
+  /** Milliseconds between hydration pages. Defaults to `0`, with no delay.
+   *  Leave unset in production; use a delay to inspect progressive loading. */
   interPageDelayMs?: number;
+  /** Rows per hydration page. Defaults to `500`. */
   pageSize?: number;
   sdk?: SanityInstance;
 }): InstancePreviewList;
@@ -214,6 +210,10 @@ export declare function useWorkflowSession({
 }: {
   engine: Engine;
   instanceId: string;
+  /** URL path where the engine client reads the actor's ACL grants, such as
+   *  `/projects/PROJECT_ID/datasets/DATASET/acl` or `/canvases/CANVAS_ID/acl`.
+   *  Supply it for conditions using `$can`; omission leaves `$can` undefined.
+   *  Grants inform advisory verdicts. Content Lake enforces writes. */
   grantsFromPath?: string;
   /** The id-set of every co-mounted session, handed identically to each one
    *  so guard observation consolidates into one shared live query per

package/dist/index.js

@@ -4,7 +4,7 @@ import { makeSdkObserver } from "@sanity/workflow-sdk/observer";
 
 import { createSanityInstance } from "@sanity/sdk";
 
-import { ENGINE_API_VERSION, createEngine, EXECUTION_KINDS } from "@sanity/workflow-engine";
+import { ENGINE_API_VERSION, createEngine, EXECUTION_KINDS, _requestProjectMembers } from "@sanity/workflow-engine";
 
 import { useMemo, useEffect, useSyncExternalStore } from "react";
 
@@ -111,7 +111,7 @@ function useSharedDispose(owner, shared) {
     }, [ owner, shared ]);
 }
 
-function useWorkflowEngine({workflowResource: workflowResource, tag: tag, resourceClients: resourceClients, effectHandlers: effectHandlers, missingHandler: missingHandler}) {
+function useWorkflowEngine({workflowResource: workflowResource, tag: tag, resourceClients: resourceClients, effects: effects}) {
     const client = useClient({
         apiVersion: ENGINE_API_VERSION
     }), resource = useKeyed([ workflowResource.type, workflowResource.id ], () => workflowResource), telemetry = useWorkflowTelemetry();
@@ -130,15 +130,12 @@ function useWorkflowEngine({workflowResource: workflowResource, tag: tag, resour
             executionContext: {
                 kind: EXECUTION_KINDS.studio
             },
-            ...effectHandlers !== void 0 ? {
-                effectHandlers: effectHandlers
-            } : {},
-            ...missingHandler !== void 0 ? {
-                missingHandler: missingHandler
+            ...effects !== void 0 ? {
+                effects: effects
             } : {},
             telemetry: telemetry
         });
-    }, [ client, resource, tag, resourceClients, effectHandlers, missingHandler, telemetry ]);
+    }, [ client, resource, tag, resourceClients, effects, telemetry ]);
 }
 
 function studioResourceClients(client) {
@@ -226,15 +223,11 @@ function isRole(value) {
 }
 
 function isMembership(value) {
-    return isRecord(value) && typeof value.id == "string" && (value.isRobot === void 0 || typeof value.isRobot == "boolean") && (value.isCurrentUser === void 0 || typeof value.isCurrentUser == "boolean") && (value.roles === void 0 || Array.isArray(value.roles) && value.roles.every(isRole));
+    return (value.isCurrentUser === void 0 || typeof value.isCurrentUser == "boolean") && (value.roles === void 0 || Array.isArray(value.roles) && value.roles.every(isRole));
 }
 
 async function fetchProjectUsers(client, projectId) {
-    const project = await client.request({
-        uri: `/projects/${projectId}`
-    });
-    if (!isRecord(project) || !Array.isArray(project.members)) throw new Error("Studio project user response did not contain a members array");
-    const membershipRows = project.members;
+    const membershipRows = await _requestProjectMembers(options => client.request(options), projectId);
     if (!membershipRows.every(isMembership)) throw new Error("Studio project user response contained an invalid membership row");
     const memberships = membershipRows.filter(member => !member.isRobot);
     if (memberships.length === 0) return [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/workflow-studio",
-  "version": "0.31.0",
+  "version": "0.33.0",
   "description": "React adapter that drives the @sanity/workflow-engine reactive session in Sanity Studio through the App SDK store.",
   "keywords": [
     "sanity",
@@ -42,7 +42,7 @@
   },
   "devDependencies": {
     "@sanity/pkg-utils": "^10.5.2",
-    "@sanity/sdk": "^2.12.0",
+    "@sanity/sdk": "^3.1.0",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.17",
     "jsdom": "^29.1.1",
@@ -50,23 +50,24 @@
     "react-dom": "^19.2.7",
     "sanity": "^6",
     "vitest": "^4.1.8",
-    "@sanity/workflow-engine": "0.31.0",
-    "@sanity/workflow-react": "0.31.0",
-    "@sanity/workflow-sdk": "0.31.0"
+    "@sanity/workflow-engine": "0.33.0",
+    "@sanity/workflow-react": "0.33.0",
+    "@sanity/workflow-sdk": "0.33.0"
   },
   "peerDependencies": {
-    "@sanity/sdk": "^2.12.0",
+    "@sanity/sdk": "^3.1.0",
     "react": "^19.2.7",
     "sanity": "^6",
-    "@sanity/workflow-engine": "0.31.0",
-    "@sanity/workflow-react": "0.31.0",
-    "@sanity/workflow-sdk": "0.31.0"
+    "@sanity/workflow-engine": "0.33.0",
+    "@sanity/workflow-react": "0.33.0",
+    "@sanity/workflow-sdk": "0.33.0"
   },
   "engines": {
     "node": ">=20"
   },
   "scripts": {
     "build": "pkg-utils build --clean",
+    "docs": "node ../../scripts/run-typedoc.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit -p tsconfig.json"