mindoodb-app-sdk 0.0.66 → 0.0.68

package/README.md

@@ -332,6 +332,41 @@ if (session.agent) {
 - **Files** never travel through the agent. `agent.provideFile(blob, { name, mimeType })` hands Haven a file the app produced and returns a `fileRef` (valid ten minutes) for the agent to pass to `haven_files_export`, which saves it into the user's exchange folder. `agent.takeFile(fileRef)` returns a `File` the agent imported for this app with `haven_files_import`.
 - A call that runs longer than two minutes fails with `FAILED`; files are limited to 50 MB.
 
+#### An op guide for edit tools
+
+Apps with an edit language (`apply_ops` batches, formatting changes) do better with short tool descriptions plus a reference the agent loads when it needs it. `createAgentGuideTool` builds that reference as a read-only tool (`ops_guide` by default): without arguments it returns the group list and one signature line per op; with `groups` it returns field tables, units, JSON examples and common mistakes of those groups.
+
+```ts
+import { agentGuideExamples, createAgentGuideTool, type MindooDBAppAgentGuideGroup } from "mindoodb-app-sdk";
+
+const GUIDE: MindooDBAppAgentGuideGroup[] = [
+  {
+    name: "blocks",
+    summary: "insert, replace, move and delete blocks",
+    intro: "Block indexes come from todo_document_read and refer to the document before the call.",
+    ops: [
+      {
+        name: "insertContent",
+        signature: "{after, markdown}",
+        fields: [
+          { name: "after", type: "integer | {heading}", required: true, description: "-1 = document start" },
+          { name: "markdown", type: "string", required: true, description: "One or more blocks." },
+        ],
+        examples: [{ op: "insertContent", after: -1, markdown: "# Agenda" }],
+      },
+    ],
+    mistakes: ["Sending indexes from an old read: pass the revision, read again when refused."],
+  },
+];
+
+const tools = [
+  createAgentGuideTool({ documents: "todo_apply_ops", groups: GUIDE }),
+  // apply_ops' description: "... Signatures and examples: todo_ops_guide."
+];
+```
+
+A group can also bring its reference as ready Markdown in `content` (TeamSlides passes GenOffice's op docs). Test the examples: `agentGuideExamples(GUIDE)` lists them, so a unit test can dry-run each one through the edit tool.
+
 #### Agent tools of embedded components
 
 Agents work on three levels: Haven's own tools (`haven_*`), the tools of the app the
@@ -514,6 +549,25 @@ hands its connection to Haven, so the host cannot reach into the component or it
 channel. Haven tells the SDK where the container is (for the component's own menus);
 the SDK follows the container's size and position by itself.
 
+**Asking once.** The first time a host shows a component in one of its databases,
+Haven asks the user whether that app may see the document. A host that shows several
+components asks for all of them at once instead, e.g. right after `components.list`:
+
+```ts
+const { granted, pending } = await session.embeds.requestAccess({
+  components: [
+    { componentKey: sheet.key, databaseIds: ["crm"] },
+    { componentKey: person.key, databaseIds: ["contacts"] }, // default: all its databases
+  ],
+});
+```
+
+Haven lists what is not allowed yet in one dialog; the user may untick entries. What the
+user allowed or put off before is not asked again, so call it on every start. `open`
+still asks for a pending pair when it is used, and asks again when a newer version of
+the component wants more access (e.g. new `references`). In tests, `embedAccess` on the
+mock plays the user (default: allow all).
+
 **Unsaved changes.** A component reports whether it has changes it has not saved yet,
 and saves when its host asks:
 

package/TESTING.md

@@ -104,6 +104,7 @@ Each database entry can provide:
 - `info`
 - `documents` — seed documents into the mock store (used by `list`/`query` and by evaluating VirtualViews). A seed's `decryptionKeyId` is reported back by `documents.get`, like a real host; documents created through the mock report `"default"` unless `create` named a key, and person-encrypted documents (`recipients`) report none.
 - `methods.documents`
+- Document history: every write (create, update, delete, a remote update) is kept as a revision, so `listHistory` (newest first, `isCurrent` on the latest), `getAtRevision` (with `phase: "before"`) and `getAtTimestamp` return the states the document went through. Revision ids are `<docId>@<n>`; timestamps are the write's `updatedAt`, strictly increasing per document.
 - `methods.views` for session-level `createView()` and `openView()` calls (overrides the default evaluating navigator)
 - `methods.attachments`
 - `fulltextSetup` — the initial config returned by `db.getFulltextSetup()`; `db.setFulltextSetup()` overwrites it for the lifetime of the handle. Use this to test your app's full-text bootstrap logic. Note the mock evaluates `text` query clauses regardless of this config.

package/dist/{chunk-B3K3I2S2.js → chunk-44S2R2PT.js}

@@ -1771,6 +1771,29 @@ var MindooDBAppEmbedsClient = class {
           this.open.set(embed.embedId, embed);
         }
         return embed;
+      },
+      requestAccess: async (input) => {
+        const components = (input?.components ?? []).map((entry) => ({
+          componentKey: String(entry.componentKey),
+          ...entry.databaseIds ? { databaseIds: entry.databaseIds.map(String) } : {},
+          ...entry.intent === "view" ? { intent: "view" } : {}
+        }));
+        try {
+          const response = await this.rpc.call("embeds.requestAccess", {
+            input: { components }
+          });
+          return { granted: response?.granted ?? [], pending: response?.pending ?? [] };
+        } catch (error) {
+          if (!(error instanceof Error && error.name === "method-not-found")) {
+            throw error;
+          }
+          return {
+            granted: [],
+            pending: components.flatMap(
+              (entry) => (entry.databaseIds ?? []).map((databaseId) => ({ componentKey: entry.componentKey, databaseId }))
+            )
+          };
+        }
       }
     };
     this.embedding = {
@@ -1954,6 +1977,103 @@ var MindooDBAppIncomingApiImpl = class {
   }
 };
 
+// src/client/reminders.ts
+function isReminderOpenedMessage(message) {
+  return message.kind === "reminder-opened";
+}
+function isUnknownMethod(error) {
+  const code = error?.code;
+  return code === "method-not-found" || code === "unsupported";
+}
+var MindooDBAppRemindersApiImpl = class {
+  constructor(rpc) {
+    this.rpc = rpc;
+    this.stopListening = this.rpc.addMessageListener((message) => {
+      if (!isReminderOpenedMessage(message)) {
+        return;
+      }
+      if (this.handler) {
+        void this.deliver(message.reminder);
+      } else {
+        this.pending.push(message.reminder);
+      }
+    });
+  }
+  rpc;
+  handler = null;
+  pending = [];
+  stopListening;
+  async schedule(request) {
+    const at = request.at instanceof Date ? request.at.getTime() : request.at;
+    try {
+      return await this.rpc.call("reminders.schedule", {
+        id: request.id,
+        title: request.title,
+        body: request.body,
+        at,
+        target: request.target
+      });
+    } catch (error) {
+      if (isUnknownMethod(error)) {
+        return { status: "unsupported" };
+      }
+      throw error;
+    }
+  }
+  async cancel(id) {
+    try {
+      await this.rpc.call("reminders.cancel", { id });
+    } catch (error) {
+      if (!isUnknownMethod(error)) {
+        throw error;
+      }
+    }
+  }
+  async list() {
+    try {
+      return await this.rpc.call("reminders.list", {});
+    } catch (error) {
+      if (isUnknownMethod(error)) {
+        return [];
+      }
+      throw error;
+    }
+  }
+  onOpened(handler) {
+    this.handler = handler;
+    void this.rpc.call("reminders.subscribe", {}).catch(() => {
+    });
+    this.pending.splice(0).forEach((opened) => {
+      void this.deliver(opened);
+    });
+    return () => {
+      if (this.handler !== handler) {
+        return;
+      }
+      this.handler = null;
+      void this.rpc.call("reminders.unsubscribe", {}).catch(() => {
+      });
+    };
+  }
+  dispose() {
+    this.stopListening();
+    this.handler = null;
+    this.pending.length = 0;
+  }
+  async deliver(opened) {
+    const handler = this.handler;
+    if (!handler) {
+      this.pending.push(opened);
+      return;
+    }
+    try {
+      await handler(opened);
+    } catch (error) {
+      console.warn("[mindoodb-app-sdk] A reminder handler failed.", error);
+    }
+  }
+};
+
 // src/client/portRpcClient.ts
 var PROTOCOL = "mindoodb-app-bridge";
 function normalizeRpcValue(value, seen = /* @__PURE__ */ new WeakMap()) {
@@ -3230,6 +3350,7 @@ var MindooDBAppSessionImpl = class {
     this.drag = new MindooDBAppDragApiImpl(this.rpc);
     this.agent = new MindooDBAppAgentApiImpl(this.rpc);
     this.incoming = new MindooDBAppIncomingApiImpl(this.rpc);
+    this.reminders = new MindooDBAppRemindersApiImpl(this.rpc);
     this.embedsClient = new MindooDBAppEmbedsClient(this.rpc);
     this.components = this.embedsClient.components;
     this.embeds = this.embedsClient.embeds;
@@ -3298,6 +3419,7 @@ var MindooDBAppSessionImpl = class {
   storage;
   agent;
   incoming;
+  reminders;
   embedsClient;
   components;
   embeds;
@@ -3480,6 +3602,7 @@ var MindooDBAppSessionImpl = class {
     this.drag.dispose();
     this.agent.dispose();
     this.incoming.dispose();
+    this.reminders.dispose();
     this.embedsClient.dispose();
     try {
       await this.rpc.call("session.disconnect", {});

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppDragBindSourceOptions, b as MindooDBAppDragStartInput, c as MindooDBAppDragStartResult, d as MindooDBAppDragPreview, e as MindooDBAppBridge, f as MindooDBAppAgentToolErrorCode, g as MindooDBAppHostShortcutBinding, h as MindooDBAppHostShortcutAction, i as MindooDBAppHostingMode, j as MindooDBAppDefinition, k as MindooDBAppDatabase, l as MindooDBAppDocument, m as MindooDBAppRichTextSpan, n as MindooDBAppRichTextSnapshot, o as MindooDBAppCreateDocumentInput } from './types-Cuw-0Iou.js';
-export { p as MINDOODB_APP_ACCEPTS_MAX, q as MINDOODB_APP_COMPONENTS_MAX, r as MINDOODB_APP_COMPONENT_CONTRACT_PATTERN, s as MINDOODB_APP_DEFINITION_FILE_NAME, t as MINDOODB_APP_DEFINITION_FORMAT, u as MINDOODB_APP_DEFINITION_PERMISSIONS, v as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, w as MINDOODB_APP_DEFINITION_VERSION, x as MINDOODB_APP_LISTING_DESCRIPTION_MAX, y as MINDOODB_APP_LISTING_MAX_SCREENSHOTS, z as MINDOODB_APP_LISTING_SUMMARY_MAX, A as MINDOODB_APP_SEAL_SIGNING_DOMAIN, B as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, C as MindooDBAppAcceptSpec, D as MindooDBAppAccessDecision, E as MindooDBAppAccessTier, F as MindooDBAppAgentApi, G as MindooDBAppAgentRegistration, H as MindooDBAppAgentTool, I as MindooDBAppAgentToolAnnotations, J as MindooDBAppAgentToolDescriptor, K as MindooDBAppAgentToolScope, L as MindooDBAppAttachmentApi, N as MindooDBAppAttachmentChunk, O as MindooDBAppAttachmentInfo, P as MindooDBAppAttachmentPreviewOptions, Q as MindooDBAppAttachmentPreviewSession, R as MindooDBAppAutomergeChangesPatch, S as MindooDBAppAutomergeChangesSince, T as MindooDBAppAutomergeGetOptions, U as MindooDBAppAutomergePatchResult, V as MindooDBAppAutomergeSnapshot, W as MindooDBAppBridgeAgentInvokeMessage, X as MindooDBAppBridgeAgentResultMessage, Y as MindooDBAppBridgeBeforeCloseAck, Z as MindooDBAppBridgeBeforeCloseMessage, _ as MindooDBAppBridgeConnectMessage, $ as MindooDBAppBridgeConnectOptions, a0 as MindooDBAppBridgeConnectedMessage, a1 as MindooDBAppBridgeDragDropMessage, a2 as MindooDBAppBridgeDragLeaveMessage, a3 as MindooDBAppBridgeDragOverMessage, a4 as MindooDBAppBridgeEmbedEventMessage, a5 as MindooDBAppBridgeEmbeddingRequestMessage, a6 as MindooDBAppBridgeErrorPayload, a7 as MindooDBAppBridgeHandshakeErrorMessage, a8 as MindooDBAppBridgeHostFocusChangedMessage, a9 as MindooDBAppBridgeIncomingContentMessage, aa as MindooDBAppBridgeLocaleChangedMessage, ab as MindooDBAppBridgePortMessage, ac as MindooDBAppBridgeQueryResultMessage, ad as MindooDBAppBridgeRpcError, ae as MindooDBAppBridgeRpcMessage, af as MindooDBAppBridgeRpcRequest, ag as MindooDBAppBridgeRpcSuccess, ah as MindooDBAppBridgeShortcutInvokedMessage, ai as MindooDBAppBridgeShortcutsChangedMessage, aj as MindooDBAppBridgeStreamAbortRequest, ak as MindooDBAppBridgeStreamAck, al as MindooDBAppBridgeStreamCloseRequest, am as MindooDBAppBridgeStreamError, an as MindooDBAppBridgeStreamMessage, ao as MindooDBAppBridgeStreamOpenResult, ap as MindooDBAppBridgeStreamReadRequest, aq as MindooDBAppBridgeStreamWriteRequest, ar as MindooDBAppBridgeThemeChangedMessage, as as MindooDBAppBridgeUiPreferencesChangedMessage, at as MindooDBAppBridgeViewChangedMessage, au as MindooDBAppBridgeViewportChangedMessage, av as MindooDBAppBridgeWorkspaceFocusRequestedMessage, aw as MindooDBAppBrowserFeatures, ax as MindooDBAppCapability, ay as MindooDBAppComponentCategory, az as MindooDBAppComponentChildren, aA as MindooDBAppComponentContract, aB as MindooDBAppComponentFieldValue, aC as MindooDBAppComponentInfo, aD as MindooDBAppComponentIntent, aE as MindooDBAppComponentQuery, aF as MindooDBAppComponentReference, aG as MindooDBAppComponentSpec, aH as MindooDBAppComponentsApi, aI as MindooDBAppConfiguredViewCategorizationStyle, aJ as MindooDBAppConfiguredViewColumn, aK as MindooDBAppConfiguredViewColumnRole, aL as MindooDBAppConfiguredViewExpressionMode, aM as MindooDBAppConfiguredViewFieldExpression, aN as MindooDBAppConfiguredViewFilterDefinition, aO as MindooDBAppConfiguredViewFilterMode, aP as MindooDBAppConfiguredViewFilterRule, aQ as MindooDBAppConfiguredViewFormulaExpression, aR as MindooDBAppConfiguredViewFormulaFilterDefinition, aS as MindooDBAppConfiguredViewPreviewMode, aT as MindooDBAppConfiguredViewRuleFilterDefinition, aU as MindooDBAppConfiguredViewRuleMatchMode, aV as MindooDBAppConfiguredViewRuleOperator, aW as MindooDBAppConfiguredViewValueExpression, aX as MindooDBAppCreateKeyInfo, aY as MindooDBAppCreateViewInput, aZ as MindooDBAppCreateViewNavigatorInput, a_ as MindooDBAppDatabaseInfo, a$ as MindooDBAppDefinitionDatabase, b0 as MindooDBAppDefinitionListing, b1 as MindooDBAppDefinitionPermission, b2 as MindooDBAppDefinitionRegistrationPermission, b3 as MindooDBAppDefinitionScreenshot, b4 as MindooDBAppDefinitionValidation, b5 as MindooDBAppDirectoryApi, b6 as MindooDBAppDirectoryEntry, b7 as MindooDBAppDocumentApi, b8 as MindooDBAppDocumentHeadCursorResult, b9 as MindooDBAppDocumentHistoryEntry, ba as MindooDBAppDocumentListQuery, bb as MindooDBAppDocumentListResult, bc as MindooDBAppDocumentQuery, bd as MindooDBAppDocumentRevisionId, be as MindooDBAppDocumentScanPreset, bf as MindooDBAppDocumentSummary, bg as MindooDBAppDragApi, bh as MindooDBAppDragCancelReason, bi as MindooDBAppDragDropEvent, bj as MindooDBAppDragEffect, bk as MindooDBAppDragHoverResult, bl as MindooDBAppDragOffer, bm as MindooDBAppDragOverEvent, bn as MindooDBAppDragPointer, bo as MindooDBAppDragProfile, bp as MindooDBAppEmbed, bq as MindooDBAppEmbedAgentTools, br as MindooDBAppEmbedAgentToolsEvent, bs as MindooDBAppEmbedCloseReason, bt as MindooDBAppEmbedClosedEvent, bu as MindooDBAppEmbedContext, bv as MindooDBAppEmbedDirtyEvent, bw as MindooDBAppEmbedOpenInput, bx as MindooDBAppEmbedRect, by as MindooDBAppEmbeddingApi, bz as MindooDBAppEmbeddingLookupOptions, bA as MindooDBAppEmbeddingLookupResult, bB as MindooDBAppEmbedsApi, bC as MindooDBAppEntryAttachmentRef, bD as MindooDBAppEntryProvenance, bE as MindooDBAppExtractDocumentTextInput, bF as MindooDBAppExtractDocumentTextResult, bG as MindooDBAppExtractTextFormat, bH as MindooDBAppExtractionSetup, bI as MindooDBAppFulltextSetup, bJ as MindooDBAppHistoricalDocument, bK as MindooDBAppHistoryQuery, bL as MindooDBAppHostTheme, bM as MindooDBAppIdentityApi, bN as MindooDBAppInaccessibleDocument, bO as MindooDBAppInaccessibleDocumentListQuery, bP as MindooDBAppInaccessibleDocumentListResult, bQ as MindooDBAppIncomingContent, bR as MindooDBAppIncomingContentHandler, bS as MindooDBAppIncomingContentInfo, bT as MindooDBAppIncomingItem, bU as MindooDBAppIncomingItemInfo, bV as MindooDBAppIncomingResult, bW as MindooDBAppIncomingSource, bX as MindooDBAppJsonCounterIncrementPatch, bY as MindooDBAppJsonListDeletePatch, bZ as MindooDBAppJsonListInsertPatch, b_ as MindooDBAppJsonPatch, b$ as MindooDBAppJsonSetPatch, c0 as MindooDBAppJsonTextMarkPatch, c1 as MindooDBAppJsonTextSplicePatch, c2 as MindooDBAppJsonTextUnmarkPatch, c3 as MindooDBAppJsonUnsetPatch, c4 as MindooDBAppLaunchContext, c5 as MindooDBAppListUsersOptions, c6 as MindooDBAppListUsersPage, c7 as MindooDBAppLiveQuerySubscription, c8 as MindooDBAppLocalizedText, c9 as MindooDBAppMenuAnchor, ca as MindooDBAppMenuApi, cb as MindooDBAppMenuCommandItem, cc as MindooDBAppMenuDismissReason, cd as MindooDBAppMenuDismissedResult, ce as MindooDBAppMenuItem, cf as MindooDBAppMenuKind, cg as MindooDBAppMenuPlacement, ch as MindooDBAppMenuPointAnchor, ci as MindooDBAppMenuRect, cj as MindooDBAppMenuRectAnchor, ck as MindooDBAppMenuSelectionResult, cl as MindooDBAppMenuSeparatorItem, cm as MindooDBAppNotificationSeverity, cn as MindooDBAppNotifyInput, co as MindooDBAppNotifyResult, cp as MindooDBAppProposeAppInput, cq as MindooDBAppProposeAppResult, cr as MindooDBAppQueryCoverage, cs as MindooDBAppQueryInclude, ct as MindooDBAppQueryIncludeCardinality, cu as MindooDBAppQueryIncludeSlots, cv as MindooDBAppQueryResult, cw as MindooDBAppQueryRow, cx as MindooDBAppQuerySortKey, cy as MindooDBAppQueryTextClause, cz as MindooDBAppReadableAttachmentStream, cA as MindooDBAppRecipientOptions, cB as MindooDBAppResolvedViewDefinition, cC as MindooDBAppResolvedViewSource, cD as MindooDBAppRevisionPhase, cE as MindooDBAppRevisionVerification, cF as MindooDBAppRichTextBlockSpan, cG as MindooDBAppRichTextGetOptions, cH as MindooDBAppRichTextImmutableString, cI as MindooDBAppRichTextMarkRange, cJ as MindooDBAppRichTextMaterializeValue, cK as MindooDBAppRichTextPatch, cL as MindooDBAppRichTextScalar, cM as MindooDBAppRichTextSpliceStep, cN as MindooDBAppRichTextStep, cO as MindooDBAppRichTextStepPatch, cP as MindooDBAppRichTextTextSpan, cQ as MindooDBAppRuntime, cR as MindooDBAppScanAttachmentOptions, cS as MindooDBAppScanAttachmentResult, cT as MindooDBAppScopedDocId, cU as MindooDBAppScopedDocumentSummary, cV as MindooDBAppSealIntent, cW as MindooDBAppSealedChannelOpenInput, cX as MindooDBAppSealedChannelOpenResult, cY as MindooDBAppSealedChannelRequestInput, cZ as MindooDBAppSession, c_ as MindooDBAppShowMenuInput, c$ as MindooDBAppShowMenuResult, d0 as MindooDBAppSignPreview, d1 as MindooDBAppSignPreviewScope, d2 as MindooDBAppSignStatementInput, d3 as MindooDBAppSignStatementResult, d4 as MindooDBAppStorageApi, d5 as MindooDBAppSummarySetup, d6 as MindooDBAppTextCursorOptions, d7 as MindooDBAppTextCursorPosition, d8 as MindooDBAppTextCursorPositionsResult, d9 as MindooDBAppTextCursorsResult, da as MindooDBAppTextEdit, db as MindooDBAppTextPatch, dc as MindooDBAppThemeMode, dd as MindooDBAppTimestampApi, de as MindooDBAppTimestampInput, df as MindooDBAppTimestampProvider, dg as MindooDBAppTimestampResult, dh as MindooDBAppUiPreferences, di as MindooDBAppUpdateDocumentInput, dj as MindooDBAppViewCursorDocumentListResult, dk as MindooDBAppViewCursorResult, dl as MindooDBAppViewEntry, dm as MindooDBAppViewEntryKind, dn as MindooDBAppViewNavigator, dp as MindooDBAppViewNavigatorExpansionState, dq as MindooDBAppViewNavigatorOpenOptions, dr as MindooDBAppViewNavigatorPageOptions, ds as MindooDBAppViewNavigatorPageResult, dt as MindooDBAppViewNavigatorRangeQuery, du as MindooDBAppViewNavigatorSelectionState, dv as MindooDBAppViewUpdateStats, dw as MindooDBAppViewport, dx as MindooDBAppWellKnownDragType, dy as MindooDBAppWritableAttachmentStream, dz as mindooDBAppAcceptMatchesType, dA as mindooDBAppComponentFieldsMatch, dB as resolveMindooDBAppDefinitionUrl, dC as resolveMindooDBAppListingAssetUrl, dD as resolveMindooDBAppLocalizedText, dE as validateMindooDBAppAccepts, dF as validateMindooDBAppComponents, dG as validateMindooDBAppDefinition } from './types-Cuw-0Iou.js';
+import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppDragBindSourceOptions, b as MindooDBAppDragStartInput, c as MindooDBAppDragStartResult, d as MindooDBAppDragPreview, e as MindooDBAppBridge, f as MindooDBAppAgentToolErrorCode, g as MindooDBAppAgentTool, h as MindooDBAppHostShortcutBinding, i as MindooDBAppHostShortcutAction, j as MindooDBAppHostingMode, k as MindooDBAppDefinition, l as MindooDBAppDatabase, m as MindooDBAppDocument, n as MindooDBAppRichTextSpan, o as MindooDBAppRichTextSnapshot, p as MindooDBAppCreateDocumentInput } from './types-BYsO5n5-.js';
+export { q as MINDOODB_APP_ACCEPTS_MAX, r as MINDOODB_APP_COMPONENTS_MAX, s as MINDOODB_APP_COMPONENT_CONTRACT_PATTERN, t as MINDOODB_APP_DEFINITION_FILE_NAME, u as MINDOODB_APP_DEFINITION_FORMAT, v as MINDOODB_APP_DEFINITION_PERMISSIONS, w as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, x as MINDOODB_APP_DEFINITION_VERSION, y as MINDOODB_APP_LISTING_DESCRIPTION_MAX, z as MINDOODB_APP_LISTING_MAX_SCREENSHOTS, A as MINDOODB_APP_LISTING_SUMMARY_MAX, B as MINDOODB_APP_SEAL_SIGNING_DOMAIN, C as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, D as MindooDBAppAcceptSpec, E as MindooDBAppAccessDecision, F as MindooDBAppAccessTier, G as MindooDBAppAgentApi, H as MindooDBAppAgentRegistration, I as MindooDBAppAgentToolAnnotations, J as MindooDBAppAgentToolDescriptor, K as MindooDBAppAgentToolScope, L as MindooDBAppAttachmentApi, N as MindooDBAppAttachmentChunk, O as MindooDBAppAttachmentInfo, P as MindooDBAppAttachmentPreviewOptions, Q as MindooDBAppAttachmentPreviewSession, R as MindooDBAppAutomergeChangesPatch, S as MindooDBAppAutomergeChangesSince, T as MindooDBAppAutomergeGetOptions, U as MindooDBAppAutomergePatchResult, V as MindooDBAppAutomergeSnapshot, W as MindooDBAppBridgeAgentInvokeMessage, X as MindooDBAppBridgeAgentResultMessage, Y as MindooDBAppBridgeBeforeCloseAck, Z as MindooDBAppBridgeBeforeCloseMessage, _ as MindooDBAppBridgeConnectMessage, $ as MindooDBAppBridgeConnectOptions, a0 as MindooDBAppBridgeConnectedMessage, a1 as MindooDBAppBridgeDragDropMessage, a2 as MindooDBAppBridgeDragLeaveMessage, a3 as MindooDBAppBridgeDragOverMessage, a4 as MindooDBAppBridgeEmbedEventMessage, a5 as MindooDBAppBridgeEmbeddingRequestMessage, a6 as MindooDBAppBridgeErrorPayload, a7 as MindooDBAppBridgeHandshakeErrorMessage, a8 as MindooDBAppBridgeHostFocusChangedMessage, a9 as MindooDBAppBridgeIncomingContentMessage, aa as MindooDBAppBridgeLocaleChangedMessage, ab as MindooDBAppBridgePortMessage, ac as MindooDBAppBridgeQueryResultMessage, ad as MindooDBAppBridgeReminderOpenedMessage, ae as MindooDBAppBridgeRpcError, af as MindooDBAppBridgeRpcMessage, ag as MindooDBAppBridgeRpcRequest, ah as MindooDBAppBridgeRpcSuccess, ai as MindooDBAppBridgeShortcutInvokedMessage, aj as MindooDBAppBridgeShortcutsChangedMessage, ak as MindooDBAppBridgeStreamAbortRequest, al as MindooDBAppBridgeStreamAck, am as MindooDBAppBridgeStreamCloseRequest, an as MindooDBAppBridgeStreamError, ao as MindooDBAppBridgeStreamMessage, ap as MindooDBAppBridgeStreamOpenResult, aq as MindooDBAppBridgeStreamReadRequest, ar as MindooDBAppBridgeStreamWriteRequest, as as MindooDBAppBridgeThemeChangedMessage, at as MindooDBAppBridgeUiPreferencesChangedMessage, au as MindooDBAppBridgeViewChangedMessage, av as MindooDBAppBridgeViewportChangedMessage, aw as MindooDBAppBridgeWorkspaceFocusRequestedMessage, ax as MindooDBAppBrowserFeatures, ay as MindooDBAppCapability, az as MindooDBAppComponentCategory, aA as MindooDBAppComponentChildren, aB as MindooDBAppComponentContract, aC as MindooDBAppComponentFieldValue, aD as MindooDBAppComponentInfo, aE as MindooDBAppComponentIntent, aF as MindooDBAppComponentQuery, aG as MindooDBAppComponentReference, aH as MindooDBAppComponentSpec, aI as MindooDBAppComponentsApi, aJ as MindooDBAppConfiguredViewCategorizationStyle, aK as MindooDBAppConfiguredViewColumn, aL as MindooDBAppConfiguredViewColumnRole, aM as MindooDBAppConfiguredViewExpressionMode, aN as MindooDBAppConfiguredViewFieldExpression, aO as MindooDBAppConfiguredViewFilterDefinition, aP as MindooDBAppConfiguredViewFilterMode, aQ as MindooDBAppConfiguredViewFilterRule, aR as MindooDBAppConfiguredViewFormulaExpression, aS as MindooDBAppConfiguredViewFormulaFilterDefinition, aT as MindooDBAppConfiguredViewPreviewMode, aU as MindooDBAppConfiguredViewRuleFilterDefinition, aV as MindooDBAppConfiguredViewRuleMatchMode, aW as MindooDBAppConfiguredViewRuleOperator, aX as MindooDBAppConfiguredViewValueExpression, aY as MindooDBAppCreateKeyInfo, aZ as MindooDBAppCreateViewInput, a_ as MindooDBAppCreateViewNavigatorInput, a$ as MindooDBAppDatabaseInfo, b0 as MindooDBAppDefinitionDatabase, b1 as MindooDBAppDefinitionListing, b2 as MindooDBAppDefinitionPermission, b3 as MindooDBAppDefinitionRegistrationPermission, b4 as MindooDBAppDefinitionScreenshot, b5 as MindooDBAppDefinitionValidation, b6 as MindooDBAppDirectoryApi, b7 as MindooDBAppDirectoryEntry, b8 as MindooDBAppDocumentApi, b9 as MindooDBAppDocumentHeadCursorResult, ba as MindooDBAppDocumentHistoryEntry, bb as MindooDBAppDocumentListQuery, bc as MindooDBAppDocumentListResult, bd as MindooDBAppDocumentQuery, be as MindooDBAppDocumentRevisionId, bf as MindooDBAppDocumentScanPreset, bg as MindooDBAppDocumentSummary, bh as MindooDBAppDragApi, bi as MindooDBAppDragCancelReason, bj as MindooDBAppDragDropEvent, bk as MindooDBAppDragEffect, bl as MindooDBAppDragHoverResult, bm as MindooDBAppDragOffer, bn as MindooDBAppDragOverEvent, bo as MindooDBAppDragPointer, bp as MindooDBAppDragProfile, bq as MindooDBAppEmbed, br as MindooDBAppEmbedAccessComponent, bs as MindooDBAppEmbedAccessInput, bt as MindooDBAppEmbedAccessPair, bu as MindooDBAppEmbedAccessResult, bv as MindooDBAppEmbedAgentTools, bw as MindooDBAppEmbedAgentToolsEvent, bx as MindooDBAppEmbedCloseReason, by as MindooDBAppEmbedClosedEvent, bz as MindooDBAppEmbedContext, bA as MindooDBAppEmbedDirtyEvent, bB as MindooDBAppEmbedOpenInput, bC as MindooDBAppEmbedRect, bD as MindooDBAppEmbeddingApi, bE as MindooDBAppEmbeddingLookupOptions, bF as MindooDBAppEmbeddingLookupResult, bG as MindooDBAppEmbedsApi, bH as MindooDBAppEntryAttachmentRef, bI as MindooDBAppEntryProvenance, bJ as MindooDBAppExtractDocumentTextInput, bK as MindooDBAppExtractDocumentTextResult, bL as MindooDBAppExtractTextFormat, bM as MindooDBAppExtractionSetup, bN as MindooDBAppFulltextSetup, bO as MindooDBAppHistoricalDocument, bP as MindooDBAppHistoryQuery, bQ as MindooDBAppHostTheme, bR as MindooDBAppIdentityApi, bS as MindooDBAppInaccessibleDocument, bT as MindooDBAppInaccessibleDocumentListQuery, bU as MindooDBAppInaccessibleDocumentListResult, bV as MindooDBAppIncomingContent, bW as MindooDBAppIncomingContentHandler, bX as MindooDBAppIncomingContentInfo, bY as MindooDBAppIncomingItem, bZ as MindooDBAppIncomingItemInfo, b_ as MindooDBAppIncomingResult, b$ as MindooDBAppIncomingSource, c0 as MindooDBAppJsonCounterIncrementPatch, c1 as MindooDBAppJsonListDeletePatch, c2 as MindooDBAppJsonListInsertPatch, c3 as MindooDBAppJsonPatch, c4 as MindooDBAppJsonSetPatch, c5 as MindooDBAppJsonTextMarkPatch, c6 as MindooDBAppJsonTextSplicePatch, c7 as MindooDBAppJsonTextUnmarkPatch, c8 as MindooDBAppJsonUnsetPatch, c9 as MindooDBAppLaunchContext, ca as MindooDBAppListUsersOptions, cb as MindooDBAppListUsersPage, cc as MindooDBAppLiveQuerySubscription, cd as MindooDBAppLocalizedText, ce as MindooDBAppMenuAnchor, cf as MindooDBAppMenuApi, cg as MindooDBAppMenuCommandItem, ch as MindooDBAppMenuDismissReason, ci as MindooDBAppMenuDismissedResult, cj as MindooDBAppMenuItem, ck as MindooDBAppMenuKind, cl as MindooDBAppMenuPlacement, cm as MindooDBAppMenuPointAnchor, cn as MindooDBAppMenuRect, co as MindooDBAppMenuRectAnchor, cp as MindooDBAppMenuSelectionResult, cq as MindooDBAppMenuSeparatorItem, cr as MindooDBAppNotificationSeverity, cs as MindooDBAppNotifyInput, ct as MindooDBAppNotifyResult, cu as MindooDBAppProposeAppInput, cv as MindooDBAppProposeAppResult, cw as MindooDBAppQueryCoverage, cx as MindooDBAppQueryInclude, cy as MindooDBAppQueryIncludeCardinality, cz as MindooDBAppQueryIncludeSlots, cA as MindooDBAppQueryResult, cB as MindooDBAppQueryRow, cC as MindooDBAppQuerySortKey, cD as MindooDBAppQueryTextClause, cE as MindooDBAppReadableAttachmentStream, cF as MindooDBAppRecipientOptions, cG as MindooDBAppReminder, cH as MindooDBAppReminderOpened, cI as MindooDBAppReminderOpenedHandler, cJ as MindooDBAppReminderRequest, cK as MindooDBAppReminderScheduleResult, cL as MindooDBAppRemindersApi, cM as MindooDBAppResolvedViewDefinition, cN as MindooDBAppResolvedViewSource, cO as MindooDBAppRevisionPhase, cP as MindooDBAppRevisionVerification, cQ as MindooDBAppRichTextBlockSpan, cR as MindooDBAppRichTextGetOptions, cS as MindooDBAppRichTextImmutableString, cT as MindooDBAppRichTextMarkRange, cU as MindooDBAppRichTextMaterializeValue, cV as MindooDBAppRichTextPatch, cW as MindooDBAppRichTextScalar, cX as MindooDBAppRichTextSpliceStep, cY as MindooDBAppRichTextStep, cZ as MindooDBAppRichTextStepPatch, c_ as MindooDBAppRichTextTextSpan, c$ as MindooDBAppRuntime, d0 as MindooDBAppScanAttachmentOptions, d1 as MindooDBAppScanAttachmentResult, d2 as MindooDBAppScopedDocId, d3 as MindooDBAppScopedDocumentSummary, d4 as MindooDBAppSealIntent, d5 as MindooDBAppSealedChannelOpenInput, d6 as MindooDBAppSealedChannelOpenResult, d7 as MindooDBAppSealedChannelRequestInput, d8 as MindooDBAppSession, d9 as MindooDBAppShowMenuInput, da as MindooDBAppShowMenuResult, db as MindooDBAppSignPreview, dc as MindooDBAppSignPreviewScope, dd as MindooDBAppSignStatementInput, de as MindooDBAppSignStatementResult, df as MindooDBAppStorageApi, dg as MindooDBAppSummarySetup, dh as MindooDBAppTextCursorOptions, di as MindooDBAppTextCursorPosition, dj as MindooDBAppTextCursorPositionsResult, dk as MindooDBAppTextCursorsResult, dl as MindooDBAppTextEdit, dm as MindooDBAppTextPatch, dn as MindooDBAppThemeMode, dp as MindooDBAppTimestampApi, dq as MindooDBAppTimestampInput, dr as MindooDBAppTimestampProvider, ds as MindooDBAppTimestampResult, dt as MindooDBAppUiPreferences, du as MindooDBAppUpdateDocumentInput, dv as MindooDBAppViewCursorDocumentListResult, dw as MindooDBAppViewCursorResult, dx as MindooDBAppViewEntry, dy as MindooDBAppViewEntryKind, dz as MindooDBAppViewNavigator, dA as MindooDBAppViewNavigatorExpansionState, dB as MindooDBAppViewNavigatorOpenOptions, dC as MindooDBAppViewNavigatorPageOptions, dD as MindooDBAppViewNavigatorPageResult, dE as MindooDBAppViewNavigatorRangeQuery, dF as MindooDBAppViewNavigatorSelectionState, dG as MindooDBAppViewUpdateStats, dH as MindooDBAppViewport, dI as MindooDBAppWellKnownDragType, dJ as MindooDBAppWritableAttachmentStream, dK as mindooDBAppAcceptMatchesType, dL as mindooDBAppComponentFieldsMatch, dM as resolveMindooDBAppDefinitionUrl, dN as resolveMindooDBAppListingAssetUrl, dO as resolveMindooDBAppLocalizedText, dP as validateMindooDBAppAccepts, dQ as validateMindooDBAppComponents, dR as validateMindooDBAppDefinition } from './types-BYsO5n5-.js';
 export { M as MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME, a as MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME, b as MINDOODB_APP_BUNDLE_MANIFEST_FORMAT, c as MINDOODB_APP_BUNDLE_MANIFEST_VERSION, d as MindooDBAppBundleArchive, e as MindooDBAppBundleFileEntry, f as MindooDBAppBundleHash, g as MindooDBAppBundleManifest, h as MindooDBAppBundleManifestValidation, i as buildMindooDBAppBundleContentHashInput, j as isMindooDBAppBundleHash, n as normalizeMindooDBAppBundlePath, v as validateMindooDBAppBundleManifest } from './appBundleManifest-B0xfpaXG.js';
 import { MindooDBAppBooleanExpression } from 'mindoodb-view-language';
 export { MindooDBAppBooleanExpression, MindooDBAppExpression, MindooDBAppFilterDefinition, MindooDBAppViewCategoryChildrenPageRequest, MindooDBAppViewColumn, MindooDBAppViewColumnRole, MindooDBAppViewDefinition, MindooDBAppViewExpansionState, MindooDBAppViewExpressionBase, MindooDBAppViewExpressionDatePart, MindooDBAppViewExpressionOperation, MindooDBAppViewFieldExpression, MindooDBAppViewIfExpression, MindooDBAppViewLetExpression, MindooDBAppViewLiteralExpression, MindooDBAppViewLookupByPath, MindooDBAppViewOperationExpression, MindooDBAppViewOriginExpression, MindooDBAppViewPageRequest, MindooDBAppViewPageResult, MindooDBAppViewRow, MindooDBAppViewSortDirection, MindooDBAppViewTotalMode, MindooDBAppViewValueExpressionRef, MindooDBAppViewVariableExpression, createViewLanguage } from 'mindoodb-view-language';
@@ -218,6 +218,92 @@ declare class MindooDBAppAgentToolError extends Error {
     constructor(code: MindooDBAppAgentToolErrorCode, message: string, requiredAction?: string);
 }
 
+/**
+ * A reference tool for an app's edit language ("ops_guide"), so the edit tools
+ * themselves can keep short descriptions.
+ *
+ * Without arguments the tool answers with the group list and one signature line
+ * per op, a few KB that tell an agent what exists. With `groups` it returns the
+ * full reference of those groups: field tables, units, runnable JSON examples
+ * and common mistakes. Agents load the groups they need before a batch they have
+ * not sent before, instead of every request carrying all of it.
+ *
+ * @module agentGuide
+ */
+
+/** One field of an op, as a row of the group's field table. */
+interface MindooDBAppAgentGuideField {
+    name: string;
+    /** Short type: `string`, `number (pt)`, `"left" | "center"`, `{start, end?}`. */
+    type: string;
+    required?: boolean;
+    description: string;
+}
+/** One op (or one kind of entry) of an edit tool. */
+interface MindooDBAppAgentGuideOp {
+    /** The op's name as the agent writes it (`insertContent`, `style`). */
+    name: string;
+    /** Compact usage: the fields, `?` marking optional ones (`{target, markdown}`). */
+    signature: string;
+    /** One or two sentences: what it does, when to use it. */
+    summary?: string;
+    fields?: MindooDBAppAgentGuideField[];
+    /** JSON values an agent can send as they are; shown as ```json blocks. Test them. */
+    examples?: unknown[];
+    notes?: string[];
+}
+/** A group of ops, loaded together. */
+interface MindooDBAppAgentGuideGroup {
+    /** Id the agent passes in `groups`: lower case, digits, `_` or `-`. */
+    name: string;
+    /** One line for the group list. */
+    summary: string;
+    /** Heading of the group's reference; default `name`. */
+    title?: string;
+    /**
+     * The group's whole reference as Markdown, for apps that keep it elsewhere.
+     * Replaces what `intro`, `ops` and `mistakes` would render; `ops` still feed
+     * the signature index.
+     */
+    content?: string;
+    /** Prose before the ops: units, addressing, what applies to all of them. */
+    intro?: string;
+    ops?: MindooDBAppAgentGuideOp[];
+    mistakes?: string[];
+}
+interface MindooDBAppAgentGuideOptions {
+    /** Tool name within the app; default `ops_guide`. */
+    name?: string;
+    /**
+     * Full tool description. Default: names `documents`, explains the two modes and
+     * lists the groups.
+     */
+    description?: string;
+    /** The tool(s) the guide documents, as agents see them (`teamedit_markdown_apply_ops`). */
+    documents?: string;
+    groups: MindooDBAppAgentGuideGroup[];
+    /**
+     * Signature index returned without `groups`. Default: one `## group` heading per
+     * group with an `opName signature` line per op.
+     */
+    signatures?: string | (() => string);
+}
+/** The group's reference as Markdown, as the guide tool returns it. */
+declare function renderAgentGuideGroup(group: MindooDBAppAgentGuideGroup): string;
+/** `opName signature` lines per group: what exists and how each op is shaped. */
+declare function agentGuideSignatureIndex(groups: MindooDBAppAgentGuideGroup[]): string;
+/** Every example of the guide, for a test that runs each one through the real tool. */
+declare function agentGuideExamples(groups: MindooDBAppAgentGuideGroup[]): Array<{
+    group: string;
+    op: string;
+    example: unknown;
+}>;
+/**
+ * Builds the guide tool. Register it next to the edit tools and point their
+ * descriptions at it ("signatures and examples: <prefix>_ops_guide").
+ */
+declare function createAgentGuideTool(options: MindooDBAppAgentGuideOptions): MindooDBAppAgentTool;
+
 /**
  * Haven's default host chords. Both sides of the bridge use this table so a
  * key that Haven handles on its own pages is the same key an iframe reports.
@@ -611,4 +697,4 @@ declare function inheritDocumentEncryption(parent: Pick<MindooDBAppDocument, "de
  */
 declare function watchWordChunks(database: MindooDBAppDatabase, parentId: string, listener: (docIds: string[]) => void): Promise<() => Promise<void>>;
 
-export { type CreateMindooDBRichTextHandleOptions, type CreateMindooDBTextBufferOptions, DEFAULT_DRAG_LONG_PRESS_MS, DEFAULT_DRAG_POINTER_THRESHOLD_PX, DEFAULT_HAVEN_HOST_SHORTCUTS, DEFAULT_HAVEN_URL, type HavenAppLandingPage, type HavenStorageShimHandle, type InstallHavenStorageShimOptions, type ListingBlock, type ListingInline, MINDOODB_APP_HOSTING_QUERY_PARAM, MINDOODB_APP_LAUNCH_ID_QUERY_PARAM, MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE, MINDOODB_APP_MAX_DRAG_TYPES, MINDOODB_APP_VALUE_TAG, MINDOODB_CUSTOM_DOCUMENT_ID_PATTERN, MINDOODB_DOCUMENT_ID_PREFIX_PATTERN, MINIMAL_DRAG_PREVIEW_PNG, MindooDBAppAgentToolError, MindooDBAppAgentToolErrorCode, type MindooDBAppAtomicValue, MindooDBAppAttachmentPreviewMode, MindooDBAppBridge, type MindooDBAppCounterValue, MindooDBAppCreateDocumentInput, MindooDBAppDatabase, MindooDBAppDefinition, MindooDBAppDocument, MindooDBAppDragBindSourceOptions, MindooDBAppDragInputError, MindooDBAppDragPreview, MindooDBAppDragStartInput, MindooDBAppDragStartResult, MindooDBAppHostShortcutAction, MindooDBAppHostShortcutBinding, MindooDBAppHostingMode, MindooDBAppRichTextSnapshot, MindooDBAppRichTextSpan, type MindooDBAppTimestampValue, type MindooDBAppTypedValue, MindooDBAppValue, MindooDBRichTextHandle, type MindooDBRichTextHandleChangeListener, type MindooDBRichTextHandleFlushResult, MindooDBTextBuffer, type MindooDBTextBufferFlushResult, type RenderHavenAppLandingPageOptions, abbreviateCanonicalName, applyHostedDocumentOverscrollContain, assertValidMindooDBCreateIds, bindDragSource, buildHavenAppInstallUrl, canPreviewAttachment, createMindooDBAppBridge, createMindooDBRichTextHandle, createMindooDBTextBuffer, expandAbbreviatedName, inheritDocumentEncryption, installHavenStorageShim, installHostShortcutCapture, isHostShortcutAction, isHostedBundleRuntime, isLaunchedByHaven, isMindooDBAppDragType, isValidMindooDBDocumentId, listingMarkdownToPlainText, matchHostShortcut, mindooDBDocumentId, normalizeDragAccepts, normalizeDragPointerInput, normalizeDragStartInput, parseListingMarkdown, queryDocuments, readMindooDBAppHostingMode, readMindooDBAppLaunchId, releaseMindooDBAppBridgeSessions, renderHavenAppLandingPage, resolveCurrentHavenAppUrl, sanitizeHostShortcutBindings, sanitizeListingHref, snapshotElementToPng, watchWordChunks };
+export { type CreateMindooDBRichTextHandleOptions, type CreateMindooDBTextBufferOptions, DEFAULT_DRAG_LONG_PRESS_MS, DEFAULT_DRAG_POINTER_THRESHOLD_PX, DEFAULT_HAVEN_HOST_SHORTCUTS, DEFAULT_HAVEN_URL, type HavenAppLandingPage, type HavenStorageShimHandle, type InstallHavenStorageShimOptions, type ListingBlock, type ListingInline, MINDOODB_APP_HOSTING_QUERY_PARAM, MINDOODB_APP_LAUNCH_ID_QUERY_PARAM, MINDOODB_APP_MAX_DRAG_PAYLOAD_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_BYTES, MINDOODB_APP_MAX_DRAG_PREVIEW_EDGE, MINDOODB_APP_MAX_DRAG_TYPES, MINDOODB_APP_VALUE_TAG, MINDOODB_CUSTOM_DOCUMENT_ID_PATTERN, MINDOODB_DOCUMENT_ID_PREFIX_PATTERN, MINIMAL_DRAG_PREVIEW_PNG, type MindooDBAppAgentGuideField, type MindooDBAppAgentGuideGroup, type MindooDBAppAgentGuideOp, type MindooDBAppAgentGuideOptions, MindooDBAppAgentTool, MindooDBAppAgentToolError, MindooDBAppAgentToolErrorCode, type MindooDBAppAtomicValue, MindooDBAppAttachmentPreviewMode, MindooDBAppBridge, type MindooDBAppCounterValue, MindooDBAppCreateDocumentInput, MindooDBAppDatabase, MindooDBAppDefinition, MindooDBAppDocument, MindooDBAppDragBindSourceOptions, MindooDBAppDragInputError, MindooDBAppDragPreview, MindooDBAppDragStartInput, MindooDBAppDragStartResult, MindooDBAppHostShortcutAction, MindooDBAppHostShortcutBinding, MindooDBAppHostingMode, MindooDBAppRichTextSnapshot, MindooDBAppRichTextSpan, type MindooDBAppTimestampValue, type MindooDBAppTypedValue, MindooDBAppValue, MindooDBRichTextHandle, type MindooDBRichTextHandleChangeListener, type MindooDBRichTextHandleFlushResult, MindooDBTextBuffer, type MindooDBTextBufferFlushResult, type RenderHavenAppLandingPageOptions, abbreviateCanonicalName, agentGuideExamples, agentGuideSignatureIndex, applyHostedDocumentOverscrollContain, assertValidMindooDBCreateIds, bindDragSource, buildHavenAppInstallUrl, canPreviewAttachment, createAgentGuideTool, createMindooDBAppBridge, createMindooDBRichTextHandle, createMindooDBTextBuffer, expandAbbreviatedName, inheritDocumentEncryption, installHavenStorageShim, installHostShortcutCapture, isHostShortcutAction, isHostedBundleRuntime, isLaunchedByHaven, isMindooDBAppDragType, isValidMindooDBDocumentId, listingMarkdownToPlainText, matchHostShortcut, mindooDBDocumentId, normalizeDragAccepts, normalizeDragPointerInput, normalizeDragStartInput, parseListingMarkdown, queryDocuments, readMindooDBAppHostingMode, readMindooDBAppLaunchId, releaseMindooDBAppBridgeSessions, renderAgentGuideGroup, renderHavenAppLandingPage, resolveCurrentHavenAppUrl, sanitizeHostShortcutBindings, sanitizeListingHref, snapshotElementToPng, watchWordChunks };

package/dist/index.js

@@ -48,7 +48,7 @@ import {
   validateMindooDBAppAccepts,
   validateMindooDBAppComponents,
   validateMindooDBAppDefinition
-} from "./chunk-B3K3I2S2.js";
+} from "./chunk-44S2R2PT.js";
 import {
   MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
   MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME,
@@ -153,6 +153,88 @@ function expandAbbreviatedName(value) {
   }).join("/");
 }
 
+// src/client/agentGuide.ts
+var GROUP_NAME_PATTERN = /^[a-z][a-z0-9_-]{0,47}$/;
+function renderAgentGuideGroup(group) {
+  if (group.content !== void 0) return group.content;
+  const parts = [`# ${group.title ?? group.name}`, `> ${group.summary}`];
+  if (group.intro) parts.push(group.intro.trim());
+  for (const op of group.ops ?? []) {
+    const lines = [`### ${op.name}`, `\`${op.signature}\``];
+    if (op.summary) lines.push("", op.summary);
+    if (op.fields?.length) {
+      lines.push("", "| field | type | required | meaning |", "|---|---|---|---|");
+      for (const field of op.fields) {
+        lines.push(`| ${cell(field.name)} | ${cell(field.type)} | ${field.required ? "yes" : ""} | ${cell(field.description)} |`);
+      }
+    }
+    for (const example of op.examples ?? []) {
+      lines.push("", "```json", JSON.stringify(example), "```");
+    }
+    if (op.notes?.length) lines.push("", ...op.notes.map((note) => `- ${note}`));
+    parts.push(lines.join("\n"));
+  }
+  if (group.mistakes?.length) {
+    parts.push(["## Common mistakes", ...group.mistakes.map((mistake) => `- ${mistake}`)].join("\n"));
+  }
+  return parts.join("\n\n");
+}
+function cell(text) {
+  return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
+}
+function agentGuideSignatureIndex(groups) {
+  return groups.filter((group) => group.ops?.length).map((group) => `## ${group.name}
+${group.ops.map((op) => `${op.name} ${op.signature}`).join("\n")}`).join("\n");
+}
+function agentGuideExamples(groups) {
+  return groups.flatMap(
+    (group) => (group.ops ?? []).flatMap((op) => (op.examples ?? []).map((example) => ({ group: group.name, op: op.name, example })))
+  );
+}
+function createAgentGuideTool(options) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const group of options.groups) {
+    if (!GROUP_NAME_PATTERN.test(group.name)) {
+      throw new Error(`Invalid guide group name "${group.name}": use lower case, digits, "_" and "-".`);
+    }
+    if (groups.has(group.name)) throw new Error(`Guide group "${group.name}" is defined twice.`);
+    groups.set(group.name, group);
+  }
+  if (groups.size === 0) throw new Error("A guide needs at least one group.");
+  const names = [...groups.keys()];
+  const subject = options.documents ? `the op reference for ${options.documents}` : "the op reference";
+  const description = options.description ?? `${subject[0].toUpperCase()}${subject.slice(1)}. Without groups: the group list and every op's one-line signature. With groups: field tables, units, runnable JSON examples and common mistakes. Load the groups you need before a batch you have not sent before. Groups: ${names.join(", ")}.`;
+  return {
+    name: options.name ?? "ops_guide",
+    description,
+    inputSchema: {
+      type: "object",
+      properties: {
+        groups: { type: "array", items: { type: "string", enum: names } }
+      }
+    },
+    annotations: { readOnlyHint: true },
+    async execute(input) {
+      const raw = Array.isArray(input.groups) ? input.groups.map(String) : typeof input.groups === "string" && input.groups ? [input.groups] : [];
+      if (raw.length === 0) {
+        const signatures = typeof options.signatures === "function" ? options.signatures() : options.signatures ?? agentGuideSignatureIndex(options.groups);
+        return {
+          groups: options.groups.map((group) => `${group.name} \u2014 ${group.summary}`).join("\n"),
+          signatures
+        };
+      }
+      const unknown = raw.filter((name) => !groups.has(name));
+      if (unknown.length) {
+        throw new MindooDBAppAgentToolError(
+          "INVALID_INPUT",
+          `Unknown group(s): ${unknown.join(", ")}. Available: ${names.join(", ")}.`
+        );
+      }
+      return { guide: [...new Set(raw)].map((name) => renderAgentGuideGroup(groups.get(name))).join("\n\n---\n\n") };
+    }
+  };
+}
+
 // src/client/hosting.ts
 var MINDOODB_APP_HOSTING_QUERY_PARAM = "mindoodbAppHosting";
 var MINDOODB_APP_LAUNCH_ID_QUERY_PARAM = "mindoodbAppLaunchId";
@@ -1316,12 +1398,15 @@ export {
   MindooDBRichTextHandle,
   MindooDBTextBuffer,
   abbreviateCanonicalName,
+  agentGuideExamples,
+  agentGuideSignatureIndex,
   applyHostedDocumentOverscrollContain,
   assertValidMindooDBCreateIds,
   bindDragSource,
   buildHavenAppInstallUrl,
   buildMindooDBAppBundleContentHashInput,
   canPreviewAttachment,
+  createAgentGuideTool,
   createMindooDBAppBridge,
   createMindooDBRichTextHandle,
   createMindooDBTextBuffer,
@@ -1350,6 +1435,7 @@ export {
   readMindooDBAppHostingMode,
   readMindooDBAppLaunchId,
   releaseMindooDBAppBridgeSessions,
+  renderAgentGuideGroup,
   renderHavenAppLandingPage,
   resolveCurrentHavenAppUrl,
   resolveMindooDBAppDefinitionUrl,

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { aC as MindooDBAppComponentInfo, bx as MindooDBAppEmbedRect, bq as MindooDBAppEmbedAgentTools, bz as MindooDBAppEmbeddingLookupOptions, bA as MindooDBAppEmbeddingLookupResult, J as MindooDBAppAgentToolDescriptor, f as MindooDBAppAgentToolErrorCode, X as MindooDBAppBridgeAgentResultMessage, W as MindooDBAppBridgeAgentInvokeMessage, aZ as MindooDBAppCreateViewNavigatorInput, dn as MindooDBAppViewNavigator, af as MindooDBAppBridgeRpcRequest, bL as MindooDBAppHostTheme, ax as MindooDBAppCapability, di as MindooDBAppUpdateDocumentInput, l as MindooDBAppDocument, j as MindooDBAppDefinition, L as MindooDBAppAttachmentApi, e as MindooDBAppBridge, cZ as MindooDBAppSession, cp as MindooDBAppProposeAppInput, dw as MindooDBAppViewport, dh as MindooDBAppUiPreferences, cv as MindooDBAppQueryResult, dv as MindooDBAppViewUpdateStats, ab as MindooDBAppBridgePortMessage, a_ as MindooDBAppDatabaseInfo, bs as MindooDBAppEmbedCloseReason, a6 as MindooDBAppBridgeErrorPayload, c4 as MindooDBAppLaunchContext, b7 as MindooDBAppDocumentApi, dq as MindooDBAppViewNavigatorOpenOptions, bM as MindooDBAppIdentityApi, dd as MindooDBAppTimestampApi, b5 as MindooDBAppDirectoryApi, bI as MindooDBAppFulltextSetup, bH as MindooDBAppExtractionSetup, d5 as MindooDBAppSummarySetup, cq as MindooDBAppProposeAppResult, bW as MindooDBAppIncomingSource, c as MindooDBAppDragStartResult, bo as MindooDBAppDragProfile, bV as MindooDBAppIncomingResult } from '../types-Cuw-0Iou.js';
+import { aD as MindooDBAppComponentInfo, bC as MindooDBAppEmbedRect, bv as MindooDBAppEmbedAgentTools, bE as MindooDBAppEmbeddingLookupOptions, bF as MindooDBAppEmbeddingLookupResult, bt as MindooDBAppEmbedAccessPair, J as MindooDBAppAgentToolDescriptor, f as MindooDBAppAgentToolErrorCode, X as MindooDBAppBridgeAgentResultMessage, W as MindooDBAppBridgeAgentInvokeMessage, a_ as MindooDBAppCreateViewNavigatorInput, dz as MindooDBAppViewNavigator, ag as MindooDBAppBridgeRpcRequest, bQ as MindooDBAppHostTheme, ay as MindooDBAppCapability, du as MindooDBAppUpdateDocumentInput, m as MindooDBAppDocument, k as MindooDBAppDefinition, L as MindooDBAppAttachmentApi, e as MindooDBAppBridge, d8 as MindooDBAppSession, cu as MindooDBAppProposeAppInput, dH as MindooDBAppViewport, dt as MindooDBAppUiPreferences, cA as MindooDBAppQueryResult, dG as MindooDBAppViewUpdateStats, ab as MindooDBAppBridgePortMessage, a$ as MindooDBAppDatabaseInfo, bs as MindooDBAppEmbedAccessInput, bx as MindooDBAppEmbedCloseReason, a6 as MindooDBAppBridgeErrorPayload, c9 as MindooDBAppLaunchContext, b8 as MindooDBAppDocumentApi, dB as MindooDBAppViewNavigatorOpenOptions, bR as MindooDBAppIdentityApi, dp as MindooDBAppTimestampApi, b6 as MindooDBAppDirectoryApi, bN as MindooDBAppFulltextSetup, bM as MindooDBAppExtractionSetup, dg as MindooDBAppSummarySetup, cv as MindooDBAppProposeAppResult, b$ as MindooDBAppIncomingSource, c as MindooDBAppDragStartResult, bp as MindooDBAppDragProfile, b_ as MindooDBAppIncomingResult, cG as MindooDBAppReminder } from '../types-BYsO5n5-.js';
 import * as mindoodb from 'mindoodb';
 import 'mindoodb-view-language';
 
@@ -35,6 +35,11 @@ interface MockEmbedHostOptions {
      * without it.
      */
     embeddingLookup?: (field: string, options: MindooDBAppEmbeddingLookupOptions) => MindooDBAppEmbeddingLookupResult[] | Promise<MindooDBAppEmbeddingLookupResult[]>;
+    /**
+     * Plays the user for `session.embeds.requestAccess`: gets the pairs Haven would
+     * ask for and returns the ones the user allows. Without it every pair is allowed.
+     */
+    embedAccess?: (pairs: MindooDBAppEmbedAccessPair[]) => MindooDBAppEmbedAccessPair[] | Promise<MindooDBAppEmbedAccessPair[]>;
 }
 
 /**
@@ -561,6 +566,11 @@ interface CreateMockMindooDBAppSessionOptions {
      * from the host's database. No results without it.
      */
     embeddingLookup?: MockEmbedHostOptions["embeddingLookup"];
+    /**
+     * Plays the user for `session.embeds.requestAccess`: returns the pairs allowed of
+     * those Haven would ask for. Without it every pair is allowed.
+     */
+    embedAccess?: MockEmbedHostOptions["embedAccess"];
     /**
      * Answer `embeds.open` with a `container` like a current Haven: with this page
      * for the SDK to frame (e.g. `about:blank`). Without it the host behaves like an
@@ -621,8 +631,17 @@ interface MockMindooDBAppSessionController {
      * and resolves with the handler's result.
      */
     emitIncomingContent(input: MockIncomingContentInput): Promise<MindooDBAppIncomingResult>;
+    /** Reminders the app scheduled (`session.reminders.schedule`) that were not tapped or cancelled. */
+    listReminders(): MindooDBAppReminder[];
+    /**
+     * As if the user tapped this reminder (`"open"`) or pressed "Done": delivered
+     * to `session.reminders.onOpened` (held until registered).
+     */
+    emitReminderOpened(id: string, action?: "open" | "done"): Promise<void>;
     /** Embeds the app has open (`session.embeds.open`). */
     listEmbeds(): MockEmbedState[];
+    /** Every `session.embeds.requestAccess` input so far, oldest first. */
+    getEmbedAccessRequests(): MindooDBAppEmbedAccessInput[];
     /** Closes an embed as Haven does when the component finishes or the user closes it. */
     closeEmbed(embedId: string, reason?: MindooDBAppEmbedCloseReason, result?: unknown): void;
     /** Replaces what `session.components.list` offers. */
@@ -752,6 +771,8 @@ interface FakeBridgeHostController {
     applyRemoteUpdate(databaseId: string, docId: string, input: MindooDBAppUpdateDocumentInput, options?: MockRemoteUpdateOptions): Promise<MindooDBAppDocument>;
     /** Embeds the app has open (`session.embeds.open`). */
     listEmbeds(): MockEmbedState[];
+    /** Every `session.embeds.requestAccess` input so far, oldest first. */
+    getEmbedAccessRequests(): MindooDBAppEmbedAccessInput[];
     /** Closes an embed and pushes the `embed-event` to the app. */
     closeEmbed(embedId: string, reason?: MindooDBAppEmbedCloseReason, result?: unknown): void;
     /** For an app under test that runs as a component: its `session.embedding` call. */

package/dist/testing/index.js

@@ -4,7 +4,7 @@ import {
   mindooDBAppComponentFieldsMatch,
   pageUsers,
   releaseMindooDBAppBridgeSessions
-} from "../chunk-B3K3I2S2.js";
+} from "../chunk-44S2R2PT.js";
 
 // src/testing/index.ts
 import * as Automerge from "@automerge/automerge";
@@ -458,7 +458,7 @@ async function createEvaluatingViewNavigator(input, documents) {
 }
 
 // src/testing/mockEmbeds.ts
-function createMockEmbedHost(options, getDatabase) {
+function createMockEmbedHost(options, getDatabase, listDatabaseIds = () => []) {
   let components = [...options.components ?? []];
   const embeds = /* @__PURE__ */ new Map();
   const handles = /* @__PURE__ */ new Map();
@@ -471,6 +471,27 @@ function createMockEmbedHost(options, getDatabase) {
   let saveRequestHandler = null;
   let embedCounter = 0;
   let embeddingFinish = null;
+  const accessRequests = [];
+  const grantedAccess = /* @__PURE__ */ new Set();
+  const pendingAccess = /* @__PURE__ */ new Set();
+  async function requestAccess(input) {
+    accessRequests.push(structuredClone(input));
+    const pairs = (input.components ?? []).flatMap(
+      (entry) => components.some((component) => component.key === entry.componentKey) ? (entry.databaseIds ?? listDatabaseIds()).filter((databaseId) => listDatabaseIds().includes(databaseId)).map((databaseId) => ({ componentKey: entry.componentKey, databaseId })) : []
+    );
+    const pairKey = (pair) => `${pair.componentKey}/${pair.databaseId}`;
+    const ask = pairs.filter((pair) => !grantedAccess.has(pairKey(pair)) && !pendingAccess.has(pairKey(pair)));
+    if (ask.length) {
+      const allowed = new Set((await (options.embedAccess?.(structuredClone(ask)) ?? ask)).map(pairKey));
+      for (const pair of ask) {
+        (allowed.has(pairKey(pair)) ? grantedAccess : pendingAccess).add(pairKey(pair));
+      }
+    }
+    return {
+      granted: pairs.filter((pair) => grantedAccess.has(pairKey(pair))),
+      pending: pairs.filter((pair) => !grantedAccess.has(pairKey(pair)))
+    };
+  }
   function notifyChange() {
     options.onEmbedChange?.([...embeds.values()].map((entry) => ({ ...entry, rect: { ...entry.rect } })));
   }
@@ -711,7 +732,8 @@ function createMockEmbedHost(options, getDatabase) {
         const handle = new MockEmbed(embedId, input.componentKey, input.databaseId, input.docId);
         handles.set(embedId, handle);
         return handle;
-      }
+      },
+      requestAccess
     },
     embedding: {
       async complete(result) {
@@ -748,6 +770,12 @@ function createMockEmbedHost(options, getDatabase) {
     setComponents(next) {
       components = [...next];
     },
+    getAccessRequests() {
+      return structuredClone(accessRequests);
+    },
+    getGrantedAccess() {
+      return [...grantedAccess];
+    },
     getEmbeddingFinish() {
       return embeddingFinish;
     },
@@ -4310,6 +4338,13 @@ async function mockSha256Hex(value) {
   const digest = await subtle.digest("SHA-256", new TextEncoder().encode(value));
   return Array.from(new Uint8Array(digest)).map((byte) => byte.toString(16).padStart(2, "0")).join("");
 }
+function mockRevisionId(docId, index) {
+  return `${docId}@${index}`;
+}
+function mockRevisionIndex(docId, revisionId) {
+  const prefix = `${docId}@`;
+  return revisionId.startsWith(prefix) ? Number(revisionId.slice(prefix.length)) : -1;
+}
 function createDatabaseHandle(definition, peers, directoryUsers = () => [], localActor = MOCK_AUTOMERGE_LOCAL_ACTOR) {
   let createCounter = 0;
   let changeCounter = 0;
@@ -4318,12 +4353,41 @@ function createDatabaseHandle(definition, peers, directoryUsers = () => [], loca
   const automergeMode = definition.automerge === true;
   let changeSequence = 0;
   const changedAt = /* @__PURE__ */ new Map();
+  const revisions = /* @__PURE__ */ new Map();
   const storedDocuments = new class extends Map {
     set(id, document2) {
       changedAt.set(id, ++changeSequence);
+      const timeline = revisions.get(id) ?? [];
+      const updatedAt = document2.updatedAt ? Date.parse(document2.updatedAt) : NaN;
+      const previous = timeline[timeline.length - 1]?.timestamp ?? 0;
+      timeline.push({
+        // Strictly increasing, so a timestamp names one revision.
+        timestamp: Math.max(Number.isFinite(updatedAt) ? updatedAt : Date.now(), previous + 1),
+        data: structuredClone(document2.data),
+        heads: document2.heads ? [...document2.heads] : void 0,
+        isDeleted: document2.isDeleted,
+        authorLabel: document2.authorLabel,
+        attachments: structuredClone(document2.attachments ?? [])
+      });
+      revisions.set(id, timeline);
       return super.set(id, document2);
     }
   }();
+  function historicalDocument(docId, index, timestamp, revisionId) {
+    const revision = index >= 0 ? revisions.get(docId)?.[index] : void 0;
+    if (!revision) {
+      return { id: docId, timestamp, state: "missing", data: null, attachments: [], ...revisionId ? { revisionId } : {} };
+    }
+    return {
+      id: docId,
+      revisionId: revisionId ?? mockRevisionId(docId, index),
+      timestamp: revision.timestamp,
+      heads: revision.heads ? [...revision.heads] : [],
+      state: revision.isDeleted ? "deleted" : "exists",
+      data: revision.isDeleted ? null : structuredClone(revision.data),
+      attachments: structuredClone(revision.attachments)
+    };
+  }
   for (const seed of definition.documents ?? []) {
     const stored = {
       id: seed.id,
@@ -4889,28 +4953,30 @@ function createDatabaseHandle(definition, peers, directoryUsers = () => [], loca
     async listCreateKeys() {
       return [{ keyId: "default", isDefault: true }];
     },
-    async listHistory(_docId) {
-      return [];
+    async listHistory(docId) {
+      const timeline = revisions.get(docId) ?? [];
+      return timeline.map((revision, index) => ({
+        revisionId: mockRevisionId(docId, index),
+        timestamp: revision.timestamp,
+        ...revision.heads ? { heads: [...revision.heads] } : {},
+        publicKey: revision.authorLabel ?? "mock-user",
+        ...revision.authorLabel ? { identityLabel: revision.authorLabel } : {},
+        isDeleted: revision.isDeleted,
+        isCurrent: index === timeline.length - 1,
+        ...index > 0 ? { dependencyIds: [mockRevisionId(docId, index - 1)] } : {}
+      })).reverse();
     },
     async getAtTimestamp(docId, timestamp) {
-      return {
-        id: docId,
-        timestamp,
-        state: "missing",
-        data: null,
-        attachments: []
-      };
+      const timeline = revisions.get(docId) ?? [];
+      let index = -1;
+      timeline.forEach((revision, position) => {
+        if (revision.timestamp <= timestamp) index = position;
+      });
+      return historicalDocument(docId, index, timestamp);
     },
-    async getAtRevision(docId, revisionId) {
-      return {
-        id: docId,
-        revisionId,
-        timestamp: Date.now(),
-        heads: [],
-        state: "missing",
-        data: null,
-        attachments: []
-      };
+    async getAtRevision(docId, revisionId, revisionOptions) {
+      const index = mockRevisionIndex(docId, revisionId);
+      return historicalDocument(docId, revisionOptions?.phase === "before" ? index - 1 : index, Date.now(), revisionId);
     },
     async getAtHeads(docId, _headIds) {
       return {
@@ -5112,15 +5178,22 @@ function createDatabaseHandle(definition, peers, directoryUsers = () => [], loca
 }
 function createMockSessionState(options = {}) {
   let launchContext = createDefaultLaunchContext(options.launchContext);
-  const embedHost = createMockEmbedHost(options, (databaseId) => {
-    const database = databaseHandles.get(databaseId);
-    if (!database) {
-      throw new Error(`Unknown test database: ${databaseId}`);
-    }
-    return database;
-  });
+  const embedHost = createMockEmbedHost(
+    options,
+    (databaseId) => {
+      const database = databaseHandles.get(databaseId);
+      if (!database) {
+        throw new Error(`Unknown test database: ${databaseId}`);
+      }
+      return database;
+    },
+    () => [...databaseHandles.keys()]
+  );
   const themeListeners = /* @__PURE__ */ new Set();
   let incomingHandler = null;
+  const mockReminders = /* @__PURE__ */ new Map();
+  let reminderHandler = null;
+  const pendingReminderTaps = [];
   const pendingIncoming = [];
   let incomingCounter = 0;
   const hostFocusListeners = /* @__PURE__ */ new Set();
@@ -5484,6 +5557,38 @@ function createMockSessionState(options = {}) {
         }
       };
     },
+    reminders: {
+      async schedule(request) {
+        const at = request.at instanceof Date ? request.at.getTime() : request.at;
+        if (!request.id || !request.title || !Number.isFinite(at) || at <= Date.now()) {
+          return { status: "invalid", reason: "id, title and a future time are required" };
+        }
+        const reminder = {
+          id: request.id,
+          title: request.title,
+          at,
+          ...request.body ? { body: request.body } : {},
+          ...request.target ? { target: request.target } : {}
+        };
+        mockReminders.set(request.id, reminder);
+        return { status: "scheduled", reminder: { ...reminder } };
+      },
+      async cancel(id) {
+        mockReminders.delete(id);
+      },
+      async list() {
+        return [...mockReminders.values()].sort((a, b) => a.at - b.at).map((reminder) => ({ ...reminder }));
+      },
+      onOpened(handler) {
+        reminderHandler = handler;
+        pendingReminderTaps.splice(0).forEach((opened) => void handler(opened));
+        return () => {
+          if (reminderHandler === handler) {
+            reminderHandler = null;
+          }
+        };
+      }
+    },
     onBeforeClose(listener) {
       beforeCloseListeners.add(listener);
       return () => {
@@ -5580,6 +5685,23 @@ function createMockSessionState(options = {}) {
         deliver();
       });
     },
+    listReminders() {
+      return [...mockReminders.values()].map((reminder) => ({ ...reminder }));
+    },
+    async emitReminderOpened(id, action = "open") {
+      const reminder = mockReminders.get(id);
+      const opened = {
+        id,
+        action,
+        ...reminder?.target ? { target: reminder.target } : {}
+      };
+      mockReminders.delete(id);
+      if (reminderHandler) {
+        await reminderHandler(opened);
+      } else {
+        pendingReminderTaps.push(opened);
+      }
+    },
     emitThemeChange(theme) {
       launchContext = mergeLaunchContext(launchContext, { theme });
       themeListeners.forEach(
@@ -5768,7 +5890,10 @@ function createMockMindooDBAppSession(options = {}) {
     resolveDrag: state.resolveDrag,
     getDragProfile: state.getDragProfile,
     emitIncomingContent: state.emitIncomingContent,
+    listReminders: state.listReminders,
+    emitReminderOpened: state.emitReminderOpened,
     listEmbeds: () => state.embedHost.listEmbeds(),
+    getEmbedAccessRequests: () => state.embedHost.getAccessRequests(),
     closeEmbed: (embedId, reason, result) => state.embedHost.closeEmbed(embedId, reason, result),
     setComponents: (components) => state.embedHost.setComponents(components),
     getEmbeddingFinish: () => state.embedHost.getEmbeddingFinish(),
@@ -6062,6 +6187,10 @@ function createFakeBridgeHost(options = {}) {
         const embedId = await state.embedHost.openEmbed(input);
         return input.placement === "frame" && options.embedFrameUrl ? { embedId, frame: { url: options.embedFrameUrl } } : { embedId };
       }
+      case "embeds.requestAccess":
+        return await state.embedHost.embeds.requestAccess(
+          params.input ?? { components: [] }
+        );
       case "embeds.setRect":
         state.embedHost.setRect(String(params.embedId), params.rect);
         return { ok: true };
@@ -6719,6 +6848,7 @@ function createFakeBridgeHost(options = {}) {
     getDirectoryUsers: state.getDirectoryUsers,
     applyRemoteUpdate: state.applyRemoteUpdate,
     listEmbeds: () => state.embedHost.listEmbeds(),
+    getEmbedAccessRequests: () => state.embedHost.getAccessRequests(),
     closeEmbed: (embedId, reason, result) => state.embedHost.closeEmbed(embedId, reason, result),
     getEmbeddingFinish: () => state.embedHost.getEmbeddingFinish(),
     setEmbedDirty: (embedId, dirty) => state.embedHost.setEmbedDirty(embedId, dirty),

package/dist/{types-Cuw-0Iou.d.ts → types-BYsO5n5-.d.ts}

@@ -1638,6 +1638,87 @@ interface MindooDBAppBridgeIncomingContentMessage {
     kind: "incoming-content";
     content: MindooDBAppIncomingContentInfo;
 }
+/**
+ * A reminder an app asks Haven to show as a notification at `at` (native
+ * app only). Haven decides: the user allows reminders per app once, sees
+ * them in Haven's settings and can remove them there.
+ */
+interface MindooDBAppReminderRequest {
+    /** The app's own id for the reminder; scheduling the same id again replaces it. Max. 100 characters. */
+    id: string;
+    /** Short title, max. 120 characters. Shown with the app's name; lock screens hide it. */
+    title: string;
+    /** Optional detail, max. 300 characters. */
+    body?: string;
+    /** When to show it: epoch milliseconds or a Date, in the future, at most one year ahead. */
+    at: number | Date;
+    /**
+     * Handed back in {@link MindooDBAppReminderOpened.target} when the user taps
+     * the reminder, e.g. a document id. Max. 500 characters. Do not put secrets
+     * here: Haven keeps it outside the encrypted databases.
+     */
+    target?: string;
+}
+/** A reminder as Haven holds it for this app. */
+interface MindooDBAppReminder {
+    id: string;
+    title: string;
+    body?: string;
+    /** Epoch milliseconds. */
+    at: number;
+    target?: string;
+}
+/**
+ * What became of a request. `denied`: the user (or the system permission)
+ * does not allow reminders for this app; `unsupported`: the host has no
+ * notifications (browser, older app version); `invalid`: the request broke a
+ * limit (`reason` says which).
+ */
+type MindooDBAppReminderScheduleResult = {
+    status: "scheduled";
+    reminder: MindooDBAppReminder;
+} | {
+    status: "denied" | "unsupported" | "invalid";
+    reason?: string;
+};
+/** The user tapped one of this app's reminders, or one of its actions. */
+interface MindooDBAppReminderOpened {
+    id: string;
+    target?: string;
+    /**
+     * `"open"`: the notification itself was tapped (Haven started or focused the
+     * app for it). `"done"`: the user pressed "Done" in the notification; the
+     * app hears about it the next time it runs and should mark the item done
+     * itself, Haven writes nothing on its behalf. ("In 1 hour" is handled by
+     * Haven alone: the reminder simply comes back an hour later.)
+     */
+    action: "open" | "done";
+}
+type MindooDBAppReminderOpenedHandler = (opened: MindooDBAppReminderOpened) => void | Promise<void>;
+/** `session.reminders`: notifications at a time the app chooses (Haven's native app). */
+interface MindooDBAppRemindersApi {
+    /**
+     * Asks Haven to show a reminder. The first request of an app asks the user
+     * whether the app may send reminders at all.
+     */
+    schedule(request: MindooDBAppReminderRequest): Promise<MindooDBAppReminderScheduleResult>;
+    /** Removes a reminder of this app; unknown ids are ignored. */
+    cancel(id: string): Promise<void>;
+    /** This app's reminders that have not fired yet, earliest first. */
+    list(): Promise<MindooDBAppReminder[]>;
+    /**
+     * Called when the user taps one of this app's reminders. Haven starts or
+     * focuses the app and delivers taps once a handler is registered, also
+     * those from before the app was running. Returns an unsubscribe function.
+     */
+    onOpened(handler: MindooDBAppReminderOpenedHandler): () => void;
+}
+/** Push message: a reminder of this app was tapped. */
+interface MindooDBAppBridgeReminderOpenedMessage {
+    protocol: "mindoodb-app-bridge";
+    kind: "reminder-opened";
+    reminder: MindooDBAppReminderOpened;
+}
 /** A component another app offers, as `session.components.list` returns it. */
 interface MindooDBAppComponentInfo {
     /** Opaque key for `session.embeds.open`. */
@@ -1702,6 +1783,36 @@ interface MindooDBAppEmbedOpenInput {
     /** Default true. */
     visible?: boolean;
 }
+/** One component a host app wants to show, for `session.embeds.requestAccess`. */
+interface MindooDBAppEmbedAccessComponent {
+    componentKey: string;
+    /**
+     * Host databases it will show documents of. Default: every database of this app
+     * that it may update (`edit`) or read (`view`).
+     */
+    databaseIds?: string[];
+    /** Default `edit`. */
+    intent?: "edit" | "view";
+}
+/** Input of `session.embeds.requestAccess`. */
+interface MindooDBAppEmbedAccessInput {
+    components: MindooDBAppEmbedAccessComponent[];
+}
+/** A component in one host database. */
+interface MindooDBAppEmbedAccessPair {
+    componentKey: string;
+    databaseId: string;
+}
+/** What `session.embeds.requestAccess` settled on. */
+interface MindooDBAppEmbedAccessResult {
+    /** Allowed, now or before: `embeds.open` shows these without asking. */
+    granted: MindooDBAppEmbedAccessPair[];
+    /**
+     * Not allowed (the user unticked them or chose "Not now"): Haven asks again when
+     * `embeds.open` shows one of them, and `requestAccess` does not ask for them again.
+     */
+    pending: MindooDBAppEmbedAccessPair[];
+}
 /** Why an embedded component went away. */
 type MindooDBAppEmbedCloseReason = "completed" | "cancelled" | "closed" | "error";
 /** Delivered once when an embedded component closes. */
@@ -1814,6 +1925,19 @@ interface MindooDBAppEmbedsApi {
      * update. The first time, Haven asks the user to allow the pairing.
      */
     open(input: MindooDBAppEmbedOpenInput): Promise<MindooDBAppEmbed>;
+    /**
+     * Asks the user once for all components this app is going to show, e.g. right
+     * after `components.list`, instead of one prompt per component and database on
+     * `open`. Haven shows a single list of what is not allowed yet (the user may
+     * untick entries) and skips what the user allowed or put off before, so calling
+     * this on every start is fine. Unknown components and databases this app may not
+     * use are left out of the result.
+     *
+     * Havens that predate this answer with `method-not-found`; the SDK then resolves
+     * with nothing granted and the pairs named in `databaseIds` pending, and `open`
+     * asks as before.
+     */
+    requestAccess(input: MindooDBAppEmbedAccessInput): Promise<MindooDBAppEmbedAccessResult>;
 }
 /** For an app running as an embedded component (check `launchContext.embed`). */
 interface MindooDBAppEmbeddingApi {
@@ -1880,7 +2004,7 @@ interface MindooDBAppBridgeEmbedEventMessage {
         type: "agentTools";
     } & MindooDBAppEmbedAgentToolsEvent);
 }
-type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage | MindooDBAppBridgeLocaleChangedMessage | MindooDBAppBridgeQueryResultMessage | MindooDBAppBridgeViewChangedMessage | MindooDBAppBridgeBeforeCloseMessage | MindooDBAppBridgeBeforeCloseAck | MindooDBAppBridgeShortcutsChangedMessage | MindooDBAppBridgeShortcutInvokedMessage | MindooDBAppBridgeWorkspaceFocusRequestedMessage | MindooDBAppBridgeHostFocusChangedMessage | MindooDBAppBridgeAgentInvokeMessage | MindooDBAppBridgeAgentResultMessage | MindooDBAppBridgeDragOverMessage | MindooDBAppBridgeDragLeaveMessage | MindooDBAppBridgeDragDropMessage | MindooDBAppBridgeIncomingContentMessage | MindooDBAppBridgeEmbedEventMessage | MindooDBAppBridgeEmbeddingRequestMessage;
+type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage | MindooDBAppBridgeLocaleChangedMessage | MindooDBAppBridgeQueryResultMessage | MindooDBAppBridgeViewChangedMessage | MindooDBAppBridgeBeforeCloseMessage | MindooDBAppBridgeBeforeCloseAck | MindooDBAppBridgeShortcutsChangedMessage | MindooDBAppBridgeShortcutInvokedMessage | MindooDBAppBridgeWorkspaceFocusRequestedMessage | MindooDBAppBridgeHostFocusChangedMessage | MindooDBAppBridgeAgentInvokeMessage | MindooDBAppBridgeAgentResultMessage | MindooDBAppBridgeDragOverMessage | MindooDBAppBridgeDragLeaveMessage | MindooDBAppBridgeDragDropMessage | MindooDBAppBridgeIncomingContentMessage | MindooDBAppBridgeReminderOpenedMessage | MindooDBAppBridgeEmbedEventMessage | MindooDBAppBridgeEmbeddingRequestMessage;
 /** Placement hint for a host-rendered overlay menu. */
 type MindooDBAppMenuPlacement = "auto" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "right-start" | "left-start";
 /** Semantic hint allowing Haven to tune menu behavior or styling. */
@@ -3522,6 +3646,11 @@ interface MindooDBAppSession {
      * Returns an unsubscribe function.
      */
     onIncomingContent(handler: MindooDBAppIncomingContentHandler): () => void;
+    /**
+     * Reminders as local notifications (Haven's native app; `unsupported`
+     * elsewhere). See {@link MindooDBAppRemindersApi}.
+     */
+    reminders: MindooDBAppRemindersApi;
     /**
      * Run work before the host tears this launch down, e.g. flushing buffered writes.
      *
@@ -3584,4 +3713,4 @@ interface MindooDBAppBridge {
     connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
 }
 
-export { type MindooDBAppBridgeConnectOptions as $, MINDOODB_APP_SEAL_SIGNING_DOMAIN as A, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as B, type MindooDBAppAcceptSpec as C, type MindooDBAppAccessDecision as D, type MindooDBAppAccessTier as E, type MindooDBAppAgentApi as F, type MindooDBAppAgentRegistration as G, type MindooDBAppAgentTool as H, type MindooDBAppAgentToolAnnotations as I, type MindooDBAppAgentToolDescriptor as J, type MindooDBAppAgentToolScope as K, type MindooDBAppAttachmentApi as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppAttachmentChunk as N, type MindooDBAppAttachmentInfo as O, type MindooDBAppAttachmentPreviewOptions as P, type MindooDBAppAttachmentPreviewSession as Q, type MindooDBAppAutomergeChangesPatch as R, type MindooDBAppAutomergeChangesSince as S, type MindooDBAppAutomergeGetOptions as T, type MindooDBAppAutomergePatchResult as U, type MindooDBAppAutomergeSnapshot as V, type MindooDBAppBridgeAgentInvokeMessage as W, type MindooDBAppBridgeAgentResultMessage as X, type MindooDBAppBridgeBeforeCloseAck as Y, type MindooDBAppBridgeBeforeCloseMessage as Z, type MindooDBAppBridgeConnectMessage as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppDefinitionDatabase as a$, type MindooDBAppBridgeConnectedMessage as a0, type MindooDBAppBridgeDragDropMessage as a1, type MindooDBAppBridgeDragLeaveMessage as a2, type MindooDBAppBridgeDragOverMessage as a3, type MindooDBAppBridgeEmbedEventMessage as a4, type MindooDBAppBridgeEmbeddingRequestMessage as a5, type MindooDBAppBridgeErrorPayload as a6, type MindooDBAppBridgeHandshakeErrorMessage as a7, type MindooDBAppBridgeHostFocusChangedMessage as a8, type MindooDBAppBridgeIncomingContentMessage as a9, type MindooDBAppComponentContract as aA, type MindooDBAppComponentFieldValue as aB, type MindooDBAppComponentInfo as aC, type MindooDBAppComponentIntent as aD, type MindooDBAppComponentQuery as aE, type MindooDBAppComponentReference as aF, type MindooDBAppComponentSpec as aG, type MindooDBAppComponentsApi as aH, type MindooDBAppConfiguredViewCategorizationStyle as aI, type MindooDBAppConfiguredViewColumn as aJ, type MindooDBAppConfiguredViewColumnRole as aK, type MindooDBAppConfiguredViewExpressionMode as aL, type MindooDBAppConfiguredViewFieldExpression as aM, type MindooDBAppConfiguredViewFilterDefinition as aN, type MindooDBAppConfiguredViewFilterMode as aO, type MindooDBAppConfiguredViewFilterRule as aP, type MindooDBAppConfiguredViewFormulaExpression as aQ, type MindooDBAppConfiguredViewFormulaFilterDefinition as aR, type MindooDBAppConfiguredViewPreviewMode as aS, type MindooDBAppConfiguredViewRuleFilterDefinition as aT, type MindooDBAppConfiguredViewRuleMatchMode as aU, type MindooDBAppConfiguredViewRuleOperator as aV, type MindooDBAppConfiguredViewValueExpression as aW, type MindooDBAppCreateKeyInfo as aX, type MindooDBAppCreateViewInput as aY, type MindooDBAppCreateViewNavigatorInput as aZ, type MindooDBAppDatabaseInfo as a_, type MindooDBAppBridgeLocaleChangedMessage as aa, type MindooDBAppBridgePortMessage as ab, type MindooDBAppBridgeQueryResultMessage as ac, type MindooDBAppBridgeRpcError as ad, type MindooDBAppBridgeRpcMessage as ae, type MindooDBAppBridgeRpcRequest as af, type MindooDBAppBridgeRpcSuccess as ag, type MindooDBAppBridgeShortcutInvokedMessage as ah, type MindooDBAppBridgeShortcutsChangedMessage as ai, type MindooDBAppBridgeStreamAbortRequest as aj, type MindooDBAppBridgeStreamAck as ak, type MindooDBAppBridgeStreamCloseRequest as al, type MindooDBAppBridgeStreamError as am, type MindooDBAppBridgeStreamMessage as an, type MindooDBAppBridgeStreamOpenResult as ao, type MindooDBAppBridgeStreamReadRequest as ap, type MindooDBAppBridgeStreamWriteRequest as aq, type MindooDBAppBridgeThemeChangedMessage as ar, type MindooDBAppBridgeUiPreferencesChangedMessage as as, type MindooDBAppBridgeViewChangedMessage as at, type MindooDBAppBridgeViewportChangedMessage as au, type MindooDBAppBridgeWorkspaceFocusRequestedMessage as av, type MindooDBAppBrowserFeatures as aw, type MindooDBAppCapability as ax, type MindooDBAppComponentCategory as ay, type MindooDBAppComponentChildren as az, type MindooDBAppDragStartInput as b, type MindooDBAppJsonSetPatch as b$, type MindooDBAppDefinitionListing as b0, type MindooDBAppDefinitionPermission as b1, type MindooDBAppDefinitionRegistrationPermission as b2, type MindooDBAppDefinitionScreenshot as b3, type MindooDBAppDefinitionValidation as b4, type MindooDBAppDirectoryApi as b5, type MindooDBAppDirectoryEntry as b6, type MindooDBAppDocumentApi as b7, type MindooDBAppDocumentHeadCursorResult as b8, type MindooDBAppDocumentHistoryEntry as b9, type MindooDBAppEmbeddingLookupResult as bA, type MindooDBAppEmbedsApi as bB, type MindooDBAppEntryAttachmentRef as bC, type MindooDBAppEntryProvenance as bD, type MindooDBAppExtractDocumentTextInput as bE, type MindooDBAppExtractDocumentTextResult as bF, type MindooDBAppExtractTextFormat as bG, type MindooDBAppExtractionSetup as bH, type MindooDBAppFulltextSetup as bI, type MindooDBAppHistoricalDocument as bJ, type MindooDBAppHistoryQuery as bK, type MindooDBAppHostTheme as bL, type MindooDBAppIdentityApi as bM, type MindooDBAppInaccessibleDocument as bN, type MindooDBAppInaccessibleDocumentListQuery as bO, type MindooDBAppInaccessibleDocumentListResult as bP, type MindooDBAppIncomingContent as bQ, type MindooDBAppIncomingContentHandler as bR, type MindooDBAppIncomingContentInfo as bS, type MindooDBAppIncomingItem as bT, type MindooDBAppIncomingItemInfo as bU, type MindooDBAppIncomingResult as bV, type MindooDBAppIncomingSource as bW, type MindooDBAppJsonCounterIncrementPatch as bX, type MindooDBAppJsonListDeletePatch as bY, type MindooDBAppJsonListInsertPatch as bZ, type MindooDBAppJsonPatch as b_, type MindooDBAppDocumentListQuery as ba, type MindooDBAppDocumentListResult as bb, type MindooDBAppDocumentQuery as bc, type MindooDBAppDocumentRevisionId as bd, type MindooDBAppDocumentScanPreset as be, type MindooDBAppDocumentSummary as bf, type MindooDBAppDragApi as bg, type MindooDBAppDragCancelReason as bh, type MindooDBAppDragDropEvent as bi, type MindooDBAppDragEffect as bj, type MindooDBAppDragHoverResult as bk, type MindooDBAppDragOffer as bl, type MindooDBAppDragOverEvent as bm, type MindooDBAppDragPointer as bn, type MindooDBAppDragProfile as bo, type MindooDBAppEmbed as bp, type MindooDBAppEmbedAgentTools as bq, type MindooDBAppEmbedAgentToolsEvent as br, type MindooDBAppEmbedCloseReason as bs, type MindooDBAppEmbedClosedEvent as bt, type MindooDBAppEmbedContext as bu, type MindooDBAppEmbedDirtyEvent as bv, type MindooDBAppEmbedOpenInput as bw, type MindooDBAppEmbedRect as bx, type MindooDBAppEmbeddingApi as by, type MindooDBAppEmbeddingLookupOptions as bz, type MindooDBAppDragStartResult as c, type MindooDBAppShowMenuResult as c$, type MindooDBAppJsonTextMarkPatch as c0, type MindooDBAppJsonTextSplicePatch as c1, type MindooDBAppJsonTextUnmarkPatch as c2, type MindooDBAppJsonUnsetPatch as c3, type MindooDBAppLaunchContext as c4, type MindooDBAppListUsersOptions as c5, type MindooDBAppListUsersPage as c6, type MindooDBAppLiveQuerySubscription as c7, type MindooDBAppLocalizedText as c8, type MindooDBAppMenuAnchor as c9, type MindooDBAppRecipientOptions as cA, type MindooDBAppResolvedViewDefinition as cB, type MindooDBAppResolvedViewSource as cC, type MindooDBAppRevisionPhase as cD, type MindooDBAppRevisionVerification as cE, type MindooDBAppRichTextBlockSpan as cF, type MindooDBAppRichTextGetOptions as cG, type MindooDBAppRichTextImmutableString as cH, type MindooDBAppRichTextMarkRange as cI, type MindooDBAppRichTextMaterializeValue as cJ, type MindooDBAppRichTextPatch as cK, type MindooDBAppRichTextScalar as cL, type MindooDBAppRichTextSpliceStep as cM, type MindooDBAppRichTextStep as cN, type MindooDBAppRichTextStepPatch as cO, type MindooDBAppRichTextTextSpan as cP, type MindooDBAppRuntime as cQ, type MindooDBAppScanAttachmentOptions as cR, type MindooDBAppScanAttachmentResult as cS, type MindooDBAppScopedDocId as cT, type MindooDBAppScopedDocumentSummary as cU, type MindooDBAppSealIntent as cV, type MindooDBAppSealedChannelOpenInput as cW, type MindooDBAppSealedChannelOpenResult as cX, type MindooDBAppSealedChannelRequestInput as cY, type MindooDBAppSession as cZ, type MindooDBAppShowMenuInput as c_, type MindooDBAppMenuApi as ca, type MindooDBAppMenuCommandItem as cb, type MindooDBAppMenuDismissReason as cc, type MindooDBAppMenuDismissedResult as cd, type MindooDBAppMenuItem as ce, type MindooDBAppMenuKind as cf, type MindooDBAppMenuPlacement as cg, type MindooDBAppMenuPointAnchor as ch, type MindooDBAppMenuRect as ci, type MindooDBAppMenuRectAnchor as cj, type MindooDBAppMenuSelectionResult as ck, type MindooDBAppMenuSeparatorItem as cl, type MindooDBAppNotificationSeverity as cm, type MindooDBAppNotifyInput as cn, type MindooDBAppNotifyResult as co, type MindooDBAppProposeAppInput as cp, type MindooDBAppProposeAppResult as cq, type MindooDBAppQueryCoverage as cr, type MindooDBAppQueryInclude as cs, type MindooDBAppQueryIncludeCardinality as ct, type MindooDBAppQueryIncludeSlots as cu, type MindooDBAppQueryResult as cv, type MindooDBAppQueryRow as cw, type MindooDBAppQuerySortKey as cx, type MindooDBAppQueryTextClause as cy, type MindooDBAppReadableAttachmentStream as cz, type MindooDBAppDragPreview as d, type MindooDBAppSignPreview as d0, type MindooDBAppSignPreviewScope as d1, type MindooDBAppSignStatementInput as d2, type MindooDBAppSignStatementResult as d3, type MindooDBAppStorageApi as d4, type MindooDBAppSummarySetup as d5, type MindooDBAppTextCursorOptions as d6, type MindooDBAppTextCursorPosition as d7, type MindooDBAppTextCursorPositionsResult as d8, type MindooDBAppTextCursorsResult as d9, mindooDBAppComponentFieldsMatch as dA, resolveMindooDBAppDefinitionUrl as dB, resolveMindooDBAppListingAssetUrl as dC, resolveMindooDBAppLocalizedText as dD, validateMindooDBAppAccepts as dE, validateMindooDBAppComponents as dF, validateMindooDBAppDefinition as dG, type MindooDBAppTextEdit as da, type MindooDBAppTextPatch as db, type MindooDBAppThemeMode as dc, type MindooDBAppTimestampApi as dd, type MindooDBAppTimestampInput as de, type MindooDBAppTimestampProvider as df, type MindooDBAppTimestampResult as dg, type MindooDBAppUiPreferences as dh, type MindooDBAppUpdateDocumentInput as di, type MindooDBAppViewCursorDocumentListResult as dj, type MindooDBAppViewCursorResult as dk, type MindooDBAppViewEntry as dl, type MindooDBAppViewEntryKind as dm, type MindooDBAppViewNavigator as dn, type MindooDBAppViewNavigatorExpansionState as dp, type MindooDBAppViewNavigatorOpenOptions as dq, type MindooDBAppViewNavigatorPageOptions as dr, type MindooDBAppViewNavigatorPageResult as ds, type MindooDBAppViewNavigatorRangeQuery as dt, type MindooDBAppViewNavigatorSelectionState as du, type MindooDBAppViewUpdateStats as dv, type MindooDBAppViewport as dw, type MindooDBAppWellKnownDragType as dx, type MindooDBAppWritableAttachmentStream as dy, mindooDBAppAcceptMatchesType as dz, type MindooDBAppBridge as e, type MindooDBAppAgentToolErrorCode as f, type MindooDBAppHostShortcutBinding as g, type MindooDBAppHostShortcutAction as h, type MindooDBAppHostingMode as i, type MindooDBAppDefinition as j, type MindooDBAppDatabase as k, type MindooDBAppDocument as l, type MindooDBAppRichTextSpan as m, type MindooDBAppRichTextSnapshot as n, type MindooDBAppCreateDocumentInput as o, MINDOODB_APP_ACCEPTS_MAX as p, MINDOODB_APP_COMPONENTS_MAX as q, MINDOODB_APP_COMPONENT_CONTRACT_PATTERN as r, MINDOODB_APP_DEFINITION_FILE_NAME as s, MINDOODB_APP_DEFINITION_FORMAT as t, MINDOODB_APP_DEFINITION_PERMISSIONS as u, MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS as v, MINDOODB_APP_DEFINITION_VERSION as w, MINDOODB_APP_LISTING_DESCRIPTION_MAX as x, MINDOODB_APP_LISTING_MAX_SCREENSHOTS as y, MINDOODB_APP_LISTING_SUMMARY_MAX as z };
+export { type MindooDBAppBridgeConnectOptions as $, MINDOODB_APP_LISTING_SUMMARY_MAX as A, MINDOODB_APP_SEAL_SIGNING_DOMAIN as B, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as C, type MindooDBAppAcceptSpec as D, type MindooDBAppAccessDecision as E, type MindooDBAppAccessTier as F, type MindooDBAppAgentApi as G, type MindooDBAppAgentRegistration as H, type MindooDBAppAgentToolAnnotations as I, type MindooDBAppAgentToolDescriptor as J, type MindooDBAppAgentToolScope as K, type MindooDBAppAttachmentApi as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppAttachmentChunk as N, type MindooDBAppAttachmentInfo as O, type MindooDBAppAttachmentPreviewOptions as P, type MindooDBAppAttachmentPreviewSession as Q, type MindooDBAppAutomergeChangesPatch as R, type MindooDBAppAutomergeChangesSince as S, type MindooDBAppAutomergeGetOptions as T, type MindooDBAppAutomergePatchResult as U, type MindooDBAppAutomergeSnapshot as V, type MindooDBAppBridgeAgentInvokeMessage as W, type MindooDBAppBridgeAgentResultMessage as X, type MindooDBAppBridgeBeforeCloseAck as Y, type MindooDBAppBridgeBeforeCloseMessage as Z, type MindooDBAppBridgeConnectMessage as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppDatabaseInfo as a$, type MindooDBAppBridgeConnectedMessage as a0, type MindooDBAppBridgeDragDropMessage as a1, type MindooDBAppBridgeDragLeaveMessage as a2, type MindooDBAppBridgeDragOverMessage as a3, type MindooDBAppBridgeEmbedEventMessage as a4, type MindooDBAppBridgeEmbeddingRequestMessage as a5, type MindooDBAppBridgeErrorPayload as a6, type MindooDBAppBridgeHandshakeErrorMessage as a7, type MindooDBAppBridgeHostFocusChangedMessage as a8, type MindooDBAppBridgeIncomingContentMessage as a9, type MindooDBAppComponentChildren as aA, type MindooDBAppComponentContract as aB, type MindooDBAppComponentFieldValue as aC, type MindooDBAppComponentInfo as aD, type MindooDBAppComponentIntent as aE, type MindooDBAppComponentQuery as aF, type MindooDBAppComponentReference as aG, type MindooDBAppComponentSpec as aH, type MindooDBAppComponentsApi as aI, type MindooDBAppConfiguredViewCategorizationStyle as aJ, type MindooDBAppConfiguredViewColumn as aK, type MindooDBAppConfiguredViewColumnRole as aL, type MindooDBAppConfiguredViewExpressionMode as aM, type MindooDBAppConfiguredViewFieldExpression as aN, type MindooDBAppConfiguredViewFilterDefinition as aO, type MindooDBAppConfiguredViewFilterMode as aP, type MindooDBAppConfiguredViewFilterRule as aQ, type MindooDBAppConfiguredViewFormulaExpression as aR, type MindooDBAppConfiguredViewFormulaFilterDefinition as aS, type MindooDBAppConfiguredViewPreviewMode as aT, type MindooDBAppConfiguredViewRuleFilterDefinition as aU, type MindooDBAppConfiguredViewRuleMatchMode as aV, type MindooDBAppConfiguredViewRuleOperator as aW, type MindooDBAppConfiguredViewValueExpression as aX, type MindooDBAppCreateKeyInfo as aY, type MindooDBAppCreateViewInput as aZ, type MindooDBAppCreateViewNavigatorInput as a_, type MindooDBAppBridgeLocaleChangedMessage as aa, type MindooDBAppBridgePortMessage as ab, type MindooDBAppBridgeQueryResultMessage as ac, type MindooDBAppBridgeReminderOpenedMessage as ad, type MindooDBAppBridgeRpcError as ae, type MindooDBAppBridgeRpcMessage as af, type MindooDBAppBridgeRpcRequest as ag, type MindooDBAppBridgeRpcSuccess as ah, type MindooDBAppBridgeShortcutInvokedMessage as ai, type MindooDBAppBridgeShortcutsChangedMessage as aj, type MindooDBAppBridgeStreamAbortRequest as ak, type MindooDBAppBridgeStreamAck as al, type MindooDBAppBridgeStreamCloseRequest as am, type MindooDBAppBridgeStreamError as an, type MindooDBAppBridgeStreamMessage as ao, type MindooDBAppBridgeStreamOpenResult as ap, type MindooDBAppBridgeStreamReadRequest as aq, type MindooDBAppBridgeStreamWriteRequest as ar, type MindooDBAppBridgeThemeChangedMessage as as, type MindooDBAppBridgeUiPreferencesChangedMessage as at, type MindooDBAppBridgeViewChangedMessage as au, type MindooDBAppBridgeViewportChangedMessage as av, type MindooDBAppBridgeWorkspaceFocusRequestedMessage as aw, type MindooDBAppBrowserFeatures as ax, type MindooDBAppCapability as ay, type MindooDBAppComponentCategory as az, type MindooDBAppDragStartInput as b, type MindooDBAppIncomingSource as b$, type MindooDBAppDefinitionDatabase as b0, type MindooDBAppDefinitionListing as b1, type MindooDBAppDefinitionPermission as b2, type MindooDBAppDefinitionRegistrationPermission as b3, type MindooDBAppDefinitionScreenshot as b4, type MindooDBAppDefinitionValidation as b5, type MindooDBAppDirectoryApi as b6, type MindooDBAppDirectoryEntry as b7, type MindooDBAppDocumentApi as b8, type MindooDBAppDocumentHeadCursorResult as b9, type MindooDBAppEmbedDirtyEvent as bA, type MindooDBAppEmbedOpenInput as bB, type MindooDBAppEmbedRect as bC, type MindooDBAppEmbeddingApi as bD, type MindooDBAppEmbeddingLookupOptions as bE, type MindooDBAppEmbeddingLookupResult as bF, type MindooDBAppEmbedsApi as bG, type MindooDBAppEntryAttachmentRef as bH, type MindooDBAppEntryProvenance as bI, type MindooDBAppExtractDocumentTextInput as bJ, type MindooDBAppExtractDocumentTextResult as bK, type MindooDBAppExtractTextFormat as bL, type MindooDBAppExtractionSetup as bM, type MindooDBAppFulltextSetup as bN, type MindooDBAppHistoricalDocument as bO, type MindooDBAppHistoryQuery as bP, type MindooDBAppHostTheme as bQ, type MindooDBAppIdentityApi as bR, type MindooDBAppInaccessibleDocument as bS, type MindooDBAppInaccessibleDocumentListQuery as bT, type MindooDBAppInaccessibleDocumentListResult as bU, type MindooDBAppIncomingContent as bV, type MindooDBAppIncomingContentHandler as bW, type MindooDBAppIncomingContentInfo as bX, type MindooDBAppIncomingItem as bY, type MindooDBAppIncomingItemInfo as bZ, type MindooDBAppIncomingResult as b_, type MindooDBAppDocumentHistoryEntry as ba, type MindooDBAppDocumentListQuery as bb, type MindooDBAppDocumentListResult as bc, type MindooDBAppDocumentQuery as bd, type MindooDBAppDocumentRevisionId as be, type MindooDBAppDocumentScanPreset as bf, type MindooDBAppDocumentSummary as bg, type MindooDBAppDragApi as bh, type MindooDBAppDragCancelReason as bi, type MindooDBAppDragDropEvent as bj, type MindooDBAppDragEffect as bk, type MindooDBAppDragHoverResult as bl, type MindooDBAppDragOffer as bm, type MindooDBAppDragOverEvent as bn, type MindooDBAppDragPointer as bo, type MindooDBAppDragProfile as bp, type MindooDBAppEmbed as bq, type MindooDBAppEmbedAccessComponent as br, type MindooDBAppEmbedAccessInput as bs, type MindooDBAppEmbedAccessPair as bt, type MindooDBAppEmbedAccessResult as bu, type MindooDBAppEmbedAgentTools as bv, type MindooDBAppEmbedAgentToolsEvent as bw, type MindooDBAppEmbedCloseReason as bx, type MindooDBAppEmbedClosedEvent as by, type MindooDBAppEmbedContext as bz, type MindooDBAppDragStartResult as c, type MindooDBAppRuntime as c$, type MindooDBAppJsonCounterIncrementPatch as c0, type MindooDBAppJsonListDeletePatch as c1, type MindooDBAppJsonListInsertPatch as c2, type MindooDBAppJsonPatch as c3, type MindooDBAppJsonSetPatch as c4, type MindooDBAppJsonTextMarkPatch as c5, type MindooDBAppJsonTextSplicePatch as c6, type MindooDBAppJsonTextUnmarkPatch as c7, type MindooDBAppJsonUnsetPatch as c8, type MindooDBAppLaunchContext as c9, type MindooDBAppQueryResult as cA, type MindooDBAppQueryRow as cB, type MindooDBAppQuerySortKey as cC, type MindooDBAppQueryTextClause as cD, type MindooDBAppReadableAttachmentStream as cE, type MindooDBAppRecipientOptions as cF, type MindooDBAppReminder as cG, type MindooDBAppReminderOpened as cH, type MindooDBAppReminderOpenedHandler as cI, type MindooDBAppReminderRequest as cJ, type MindooDBAppReminderScheduleResult as cK, type MindooDBAppRemindersApi as cL, type MindooDBAppResolvedViewDefinition as cM, type MindooDBAppResolvedViewSource as cN, type MindooDBAppRevisionPhase as cO, type MindooDBAppRevisionVerification as cP, type MindooDBAppRichTextBlockSpan as cQ, type MindooDBAppRichTextGetOptions as cR, type MindooDBAppRichTextImmutableString as cS, type MindooDBAppRichTextMarkRange as cT, type MindooDBAppRichTextMaterializeValue as cU, type MindooDBAppRichTextPatch as cV, type MindooDBAppRichTextScalar as cW, type MindooDBAppRichTextSpliceStep as cX, type MindooDBAppRichTextStep as cY, type MindooDBAppRichTextStepPatch as cZ, type MindooDBAppRichTextTextSpan as c_, type MindooDBAppListUsersOptions as ca, type MindooDBAppListUsersPage as cb, type MindooDBAppLiveQuerySubscription as cc, type MindooDBAppLocalizedText as cd, type MindooDBAppMenuAnchor as ce, type MindooDBAppMenuApi as cf, type MindooDBAppMenuCommandItem as cg, type MindooDBAppMenuDismissReason as ch, type MindooDBAppMenuDismissedResult as ci, type MindooDBAppMenuItem as cj, type MindooDBAppMenuKind as ck, type MindooDBAppMenuPlacement as cl, type MindooDBAppMenuPointAnchor as cm, type MindooDBAppMenuRect as cn, type MindooDBAppMenuRectAnchor as co, type MindooDBAppMenuSelectionResult as cp, type MindooDBAppMenuSeparatorItem as cq, type MindooDBAppNotificationSeverity as cr, type MindooDBAppNotifyInput as cs, type MindooDBAppNotifyResult as ct, type MindooDBAppProposeAppInput as cu, type MindooDBAppProposeAppResult as cv, type MindooDBAppQueryCoverage as cw, type MindooDBAppQueryInclude as cx, type MindooDBAppQueryIncludeCardinality as cy, type MindooDBAppQueryIncludeSlots as cz, type MindooDBAppDragPreview as d, type MindooDBAppScanAttachmentOptions as d0, type MindooDBAppScanAttachmentResult as d1, type MindooDBAppScopedDocId as d2, type MindooDBAppScopedDocumentSummary as d3, type MindooDBAppSealIntent as d4, type MindooDBAppSealedChannelOpenInput as d5, type MindooDBAppSealedChannelOpenResult as d6, type MindooDBAppSealedChannelRequestInput as d7, type MindooDBAppSession as d8, type MindooDBAppShowMenuInput as d9, type MindooDBAppViewNavigatorExpansionState as dA, type MindooDBAppViewNavigatorOpenOptions as dB, type MindooDBAppViewNavigatorPageOptions as dC, type MindooDBAppViewNavigatorPageResult as dD, type MindooDBAppViewNavigatorRangeQuery as dE, type MindooDBAppViewNavigatorSelectionState as dF, type MindooDBAppViewUpdateStats as dG, type MindooDBAppViewport as dH, type MindooDBAppWellKnownDragType as dI, type MindooDBAppWritableAttachmentStream as dJ, mindooDBAppAcceptMatchesType as dK, mindooDBAppComponentFieldsMatch as dL, resolveMindooDBAppDefinitionUrl as dM, resolveMindooDBAppListingAssetUrl as dN, resolveMindooDBAppLocalizedText as dO, validateMindooDBAppAccepts as dP, validateMindooDBAppComponents as dQ, validateMindooDBAppDefinition as dR, type MindooDBAppShowMenuResult as da, type MindooDBAppSignPreview as db, type MindooDBAppSignPreviewScope as dc, type MindooDBAppSignStatementInput as dd, type MindooDBAppSignStatementResult as de, type MindooDBAppStorageApi as df, type MindooDBAppSummarySetup as dg, type MindooDBAppTextCursorOptions as dh, type MindooDBAppTextCursorPosition as di, type MindooDBAppTextCursorPositionsResult as dj, type MindooDBAppTextCursorsResult as dk, type MindooDBAppTextEdit as dl, type MindooDBAppTextPatch as dm, type MindooDBAppThemeMode as dn, type MindooDBAppTimestampApi as dp, type MindooDBAppTimestampInput as dq, type MindooDBAppTimestampProvider as dr, type MindooDBAppTimestampResult as ds, type MindooDBAppUiPreferences as dt, type MindooDBAppUpdateDocumentInput as du, type MindooDBAppViewCursorDocumentListResult as dv, type MindooDBAppViewCursorResult as dw, type MindooDBAppViewEntry as dx, type MindooDBAppViewEntryKind as dy, type MindooDBAppViewNavigator as dz, type MindooDBAppBridge as e, type MindooDBAppAgentToolErrorCode as f, type MindooDBAppAgentTool as g, type MindooDBAppHostShortcutBinding as h, type MindooDBAppHostShortcutAction as i, type MindooDBAppHostingMode as j, type MindooDBAppDefinition as k, type MindooDBAppDatabase as l, type MindooDBAppDocument as m, type MindooDBAppRichTextSpan as n, type MindooDBAppRichTextSnapshot as o, type MindooDBAppCreateDocumentInput as p, MINDOODB_APP_ACCEPTS_MAX as q, MINDOODB_APP_COMPONENTS_MAX as r, MINDOODB_APP_COMPONENT_CONTRACT_PATTERN as s, MINDOODB_APP_DEFINITION_FILE_NAME as t, MINDOODB_APP_DEFINITION_FORMAT as u, MINDOODB_APP_DEFINITION_PERMISSIONS as v, MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS as w, MINDOODB_APP_DEFINITION_VERSION as x, MINDOODB_APP_LISTING_DESCRIPTION_MAX as y, MINDOODB_APP_LISTING_MAX_SCREENSHOTS as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindoodb-app-sdk",
-  "version": "0.0.66",
+  "version": "0.0.68",
   "engines": {
     "node": ">=22.13.0"
   },
@@ -45,7 +45,7 @@
   },
   "peerDependencies": {
     "@automerge/automerge": "^3.3.2",
-    "mindoodb": ">=0.0.74"
+    "mindoodb": ">=0.0.75"
   },
   "peerDependenciesMeta": {
     "@automerge/automerge": {
@@ -57,7 +57,7 @@
   },
   "devDependencies": {
     "@automerge/automerge": "^3.5.0",
-    "mindoodb": "^0.0.74",
+    "mindoodb": "^0.0.75",
     "@types/node": "25.5.0",
     "jsdom": "^29.0.1",
     "tsup": "^8.5.1",