mindoodb-app-sdk 0.0.66 → 0.0.67

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-376SABPG.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 = {

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-BGLXh4JQ.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 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 MindooDBAppEmbedAccessComponent, br as MindooDBAppEmbedAccessInput, bs as MindooDBAppEmbedAccessPair, bt as MindooDBAppEmbedAccessResult, bu as MindooDBAppEmbedAgentTools, bv as MindooDBAppEmbedAgentToolsEvent, bw as MindooDBAppEmbedCloseReason, bx as MindooDBAppEmbedClosedEvent, by as MindooDBAppEmbedContext, bz as MindooDBAppEmbedDirtyEvent, bA as MindooDBAppEmbedOpenInput, bB as MindooDBAppEmbedRect, bC as MindooDBAppEmbeddingApi, bD as MindooDBAppEmbeddingLookupOptions, bE as MindooDBAppEmbeddingLookupResult, bF as MindooDBAppEmbedsApi, bG as MindooDBAppEntryAttachmentRef, bH as MindooDBAppEntryProvenance, bI as MindooDBAppExtractDocumentTextInput, bJ as MindooDBAppExtractDocumentTextResult, bK as MindooDBAppExtractTextFormat, bL as MindooDBAppExtractionSetup, bM as MindooDBAppFulltextSetup, bN as MindooDBAppHistoricalDocument, bO as MindooDBAppHistoryQuery, bP as MindooDBAppHostTheme, bQ as MindooDBAppIdentityApi, bR as MindooDBAppInaccessibleDocument, bS as MindooDBAppInaccessibleDocumentListQuery, bT as MindooDBAppInaccessibleDocumentListResult, bU as MindooDBAppIncomingContent, bV as MindooDBAppIncomingContentHandler, bW as MindooDBAppIncomingContentInfo, bX as MindooDBAppIncomingItem, bY as MindooDBAppIncomingItemInfo, bZ as MindooDBAppIncomingResult, b_ as MindooDBAppIncomingSource, b$ as MindooDBAppJsonCounterIncrementPatch, c0 as MindooDBAppJsonListDeletePatch, c1 as MindooDBAppJsonListInsertPatch, c2 as MindooDBAppJsonPatch, c3 as MindooDBAppJsonSetPatch, c4 as MindooDBAppJsonTextMarkPatch, c5 as MindooDBAppJsonTextSplicePatch, c6 as MindooDBAppJsonTextUnmarkPatch, c7 as MindooDBAppJsonUnsetPatch, c8 as MindooDBAppLaunchContext, c9 as MindooDBAppListUsersOptions, ca as MindooDBAppListUsersPage, cb as MindooDBAppLiveQuerySubscription, cc as MindooDBAppLocalizedText, cd as MindooDBAppMenuAnchor, ce as MindooDBAppMenuApi, cf as MindooDBAppMenuCommandItem, cg as MindooDBAppMenuDismissReason, ch as MindooDBAppMenuDismissedResult, ci as MindooDBAppMenuItem, cj as MindooDBAppMenuKind, ck as MindooDBAppMenuPlacement, cl as MindooDBAppMenuPointAnchor, cm as MindooDBAppMenuRect, cn as MindooDBAppMenuRectAnchor, co as MindooDBAppMenuSelectionResult, cp as MindooDBAppMenuSeparatorItem, cq as MindooDBAppNotificationSeverity, cr as MindooDBAppNotifyInput, cs as MindooDBAppNotifyResult, ct as MindooDBAppProposeAppInput, cu as MindooDBAppProposeAppResult, cv as MindooDBAppQueryCoverage, cw as MindooDBAppQueryInclude, cx as MindooDBAppQueryIncludeCardinality, cy as MindooDBAppQueryIncludeSlots, cz as MindooDBAppQueryResult, cA as MindooDBAppQueryRow, cB as MindooDBAppQuerySortKey, cC as MindooDBAppQueryTextClause, cD as MindooDBAppReadableAttachmentStream, cE as MindooDBAppRecipientOptions, cF as MindooDBAppResolvedViewDefinition, cG as MindooDBAppResolvedViewSource, cH as MindooDBAppRevisionPhase, cI as MindooDBAppRevisionVerification, cJ as MindooDBAppRichTextBlockSpan, cK as MindooDBAppRichTextGetOptions, cL as MindooDBAppRichTextImmutableString, cM as MindooDBAppRichTextMarkRange, cN as MindooDBAppRichTextMaterializeValue, cO as MindooDBAppRichTextPatch, cP as MindooDBAppRichTextScalar, cQ as MindooDBAppRichTextSpliceStep, cR as MindooDBAppRichTextStep, cS as MindooDBAppRichTextStepPatch, cT as MindooDBAppRichTextTextSpan, cU as MindooDBAppRuntime, cV as MindooDBAppScanAttachmentOptions, cW as MindooDBAppScanAttachmentResult, cX as MindooDBAppScopedDocId, cY as MindooDBAppScopedDocumentSummary, cZ as MindooDBAppSealIntent, c_ as MindooDBAppSealedChannelOpenInput, c$ as MindooDBAppSealedChannelOpenResult, d0 as MindooDBAppSealedChannelRequestInput, d1 as MindooDBAppSession, d2 as MindooDBAppShowMenuInput, d3 as MindooDBAppShowMenuResult, d4 as MindooDBAppSignPreview, d5 as MindooDBAppSignPreviewScope, d6 as MindooDBAppSignStatementInput, d7 as MindooDBAppSignStatementResult, d8 as MindooDBAppStorageApi, d9 as MindooDBAppSummarySetup, da as MindooDBAppTextCursorOptions, db as MindooDBAppTextCursorPosition, dc as MindooDBAppTextCursorPositionsResult, dd as MindooDBAppTextCursorsResult, de as MindooDBAppTextEdit, df as MindooDBAppTextPatch, dg as MindooDBAppThemeMode, dh as MindooDBAppTimestampApi, di as MindooDBAppTimestampInput, dj as MindooDBAppTimestampProvider, dk as MindooDBAppTimestampResult, dl as MindooDBAppUiPreferences, dm as MindooDBAppUpdateDocumentInput, dn as MindooDBAppViewCursorDocumentListResult, dp as MindooDBAppViewCursorResult, dq as MindooDBAppViewEntry, dr as MindooDBAppViewEntryKind, ds as MindooDBAppViewNavigator, dt as MindooDBAppViewNavigatorExpansionState, du as MindooDBAppViewNavigatorOpenOptions, dv as MindooDBAppViewNavigatorPageOptions, dw as MindooDBAppViewNavigatorPageResult, dx as MindooDBAppViewNavigatorRangeQuery, dy as MindooDBAppViewNavigatorSelectionState, dz as MindooDBAppViewUpdateStats, dA as MindooDBAppViewport, dB as MindooDBAppWellKnownDragType, dC as MindooDBAppWritableAttachmentStream, dD as mindooDBAppAcceptMatchesType, dE as mindooDBAppComponentFieldsMatch, dF as resolveMindooDBAppDefinitionUrl, dG as resolveMindooDBAppListingAssetUrl, dH as resolveMindooDBAppLocalizedText, dI as validateMindooDBAppAccepts, dJ as validateMindooDBAppComponents, dK as validateMindooDBAppDefinition } from './types-BGLXh4JQ.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-376SABPG.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 { aC as MindooDBAppComponentInfo, bB as MindooDBAppEmbedRect, bu as MindooDBAppEmbedAgentTools, bD as MindooDBAppEmbeddingLookupOptions, bE as MindooDBAppEmbeddingLookupResult, bs as MindooDBAppEmbedAccessPair, J as MindooDBAppAgentToolDescriptor, f as MindooDBAppAgentToolErrorCode, X as MindooDBAppBridgeAgentResultMessage, W as MindooDBAppBridgeAgentInvokeMessage, aZ as MindooDBAppCreateViewNavigatorInput, ds as MindooDBAppViewNavigator, af as MindooDBAppBridgeRpcRequest, bP as MindooDBAppHostTheme, ax as MindooDBAppCapability, dm as MindooDBAppUpdateDocumentInput, m as MindooDBAppDocument, k as MindooDBAppDefinition, L as MindooDBAppAttachmentApi, e as MindooDBAppBridge, d1 as MindooDBAppSession, ct as MindooDBAppProposeAppInput, dA as MindooDBAppViewport, dl as MindooDBAppUiPreferences, cz as MindooDBAppQueryResult, dz as MindooDBAppViewUpdateStats, ab as MindooDBAppBridgePortMessage, a_ as MindooDBAppDatabaseInfo, br as MindooDBAppEmbedAccessInput, bw as MindooDBAppEmbedCloseReason, a6 as MindooDBAppBridgeErrorPayload, c8 as MindooDBAppLaunchContext, b7 as MindooDBAppDocumentApi, du as MindooDBAppViewNavigatorOpenOptions, bQ as MindooDBAppIdentityApi, dh as MindooDBAppTimestampApi, b5 as MindooDBAppDirectoryApi, bM as MindooDBAppFulltextSetup, bL as MindooDBAppExtractionSetup, d9 as MindooDBAppSummarySetup, cu as MindooDBAppProposeAppResult, b_ as MindooDBAppIncomingSource, c as MindooDBAppDragStartResult, bo as MindooDBAppDragProfile, bZ as MindooDBAppIncomingResult } from '../types-BGLXh4JQ.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
@@ -623,6 +633,8 @@ interface MockMindooDBAppSessionController {
     emitIncomingContent(input: MockIncomingContentInput): Promise<MindooDBAppIncomingResult>;
     /** 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 +764,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-376SABPG.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,13 +5178,17 @@ 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 pendingIncoming = [];
@@ -5769,6 +5839,7 @@ function createMockMindooDBAppSession(options = {}) {
     getDragProfile: state.getDragProfile,
     emitIncomingContent: state.emitIncomingContent,
     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 +6133,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 +6794,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-BGLXh4JQ.d.ts}

@@ -1702,6 +1702,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 +1844,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 {
@@ -3584,4 +3627,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 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 MindooDBAppJsonCounterIncrementPatch 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 MindooDBAppEmbedOpenInput as bA, type MindooDBAppEmbedRect as bB, type MindooDBAppEmbeddingApi as bC, type MindooDBAppEmbeddingLookupOptions as bD, type MindooDBAppEmbeddingLookupResult as bE, type MindooDBAppEmbedsApi as bF, type MindooDBAppEntryAttachmentRef as bG, type MindooDBAppEntryProvenance as bH, type MindooDBAppExtractDocumentTextInput as bI, type MindooDBAppExtractDocumentTextResult as bJ, type MindooDBAppExtractTextFormat as bK, type MindooDBAppExtractionSetup as bL, type MindooDBAppFulltextSetup as bM, type MindooDBAppHistoricalDocument as bN, type MindooDBAppHistoryQuery as bO, type MindooDBAppHostTheme as bP, type MindooDBAppIdentityApi as bQ, type MindooDBAppInaccessibleDocument as bR, type MindooDBAppInaccessibleDocumentListQuery as bS, type MindooDBAppInaccessibleDocumentListResult as bT, type MindooDBAppIncomingContent as bU, type MindooDBAppIncomingContentHandler as bV, type MindooDBAppIncomingContentInfo as bW, type MindooDBAppIncomingItem as bX, type MindooDBAppIncomingItemInfo as bY, type MindooDBAppIncomingResult as bZ, type MindooDBAppIncomingSource 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 MindooDBAppEmbedAccessComponent as bq, type MindooDBAppEmbedAccessInput as br, type MindooDBAppEmbedAccessPair as bs, type MindooDBAppEmbedAccessResult as bt, type MindooDBAppEmbedAgentTools as bu, type MindooDBAppEmbedAgentToolsEvent as bv, type MindooDBAppEmbedCloseReason as bw, type MindooDBAppEmbedClosedEvent as bx, type MindooDBAppEmbedContext as by, type MindooDBAppEmbedDirtyEvent as bz, type MindooDBAppDragStartResult as c, type MindooDBAppSealedChannelOpenResult as c$, type MindooDBAppJsonListDeletePatch as c0, type MindooDBAppJsonListInsertPatch as c1, type MindooDBAppJsonPatch as c2, type MindooDBAppJsonSetPatch as c3, type MindooDBAppJsonTextMarkPatch as c4, type MindooDBAppJsonTextSplicePatch as c5, type MindooDBAppJsonTextUnmarkPatch as c6, type MindooDBAppJsonUnsetPatch as c7, type MindooDBAppLaunchContext as c8, type MindooDBAppListUsersOptions as c9, type MindooDBAppQueryRow as cA, type MindooDBAppQuerySortKey as cB, type MindooDBAppQueryTextClause as cC, type MindooDBAppReadableAttachmentStream as cD, type MindooDBAppRecipientOptions as cE, type MindooDBAppResolvedViewDefinition as cF, type MindooDBAppResolvedViewSource as cG, type MindooDBAppRevisionPhase as cH, type MindooDBAppRevisionVerification as cI, type MindooDBAppRichTextBlockSpan as cJ, type MindooDBAppRichTextGetOptions as cK, type MindooDBAppRichTextImmutableString as cL, type MindooDBAppRichTextMarkRange as cM, type MindooDBAppRichTextMaterializeValue as cN, type MindooDBAppRichTextPatch as cO, type MindooDBAppRichTextScalar as cP, type MindooDBAppRichTextSpliceStep as cQ, type MindooDBAppRichTextStep as cR, type MindooDBAppRichTextStepPatch as cS, type MindooDBAppRichTextTextSpan as cT, type MindooDBAppRuntime as cU, type MindooDBAppScanAttachmentOptions as cV, type MindooDBAppScanAttachmentResult as cW, type MindooDBAppScopedDocId as cX, type MindooDBAppScopedDocumentSummary as cY, type MindooDBAppSealIntent as cZ, type MindooDBAppSealedChannelOpenInput as c_, type MindooDBAppListUsersPage as ca, type MindooDBAppLiveQuerySubscription as cb, type MindooDBAppLocalizedText as cc, type MindooDBAppMenuAnchor as cd, type MindooDBAppMenuApi as ce, type MindooDBAppMenuCommandItem as cf, type MindooDBAppMenuDismissReason as cg, type MindooDBAppMenuDismissedResult as ch, type MindooDBAppMenuItem as ci, type MindooDBAppMenuKind as cj, type MindooDBAppMenuPlacement as ck, type MindooDBAppMenuPointAnchor as cl, type MindooDBAppMenuRect as cm, type MindooDBAppMenuRectAnchor as cn, type MindooDBAppMenuSelectionResult as co, type MindooDBAppMenuSeparatorItem as cp, type MindooDBAppNotificationSeverity as cq, type MindooDBAppNotifyInput as cr, type MindooDBAppNotifyResult as cs, type MindooDBAppProposeAppInput as ct, type MindooDBAppProposeAppResult as cu, type MindooDBAppQueryCoverage as cv, type MindooDBAppQueryInclude as cw, type MindooDBAppQueryIncludeCardinality as cx, type MindooDBAppQueryIncludeSlots as cy, type MindooDBAppQueryResult as cz, type MindooDBAppDragPreview as d, type MindooDBAppSealedChannelRequestInput as d0, type MindooDBAppSession as d1, type MindooDBAppShowMenuInput as d2, type MindooDBAppShowMenuResult as d3, type MindooDBAppSignPreview as d4, type MindooDBAppSignPreviewScope as d5, type MindooDBAppSignStatementInput as d6, type MindooDBAppSignStatementResult as d7, type MindooDBAppStorageApi as d8, type MindooDBAppSummarySetup as d9, type MindooDBAppViewport as dA, type MindooDBAppWellKnownDragType as dB, type MindooDBAppWritableAttachmentStream as dC, mindooDBAppAcceptMatchesType as dD, mindooDBAppComponentFieldsMatch as dE, resolveMindooDBAppDefinitionUrl as dF, resolveMindooDBAppListingAssetUrl as dG, resolveMindooDBAppLocalizedText as dH, validateMindooDBAppAccepts as dI, validateMindooDBAppComponents as dJ, validateMindooDBAppDefinition as dK, type MindooDBAppTextCursorOptions as da, type MindooDBAppTextCursorPosition as db, type MindooDBAppTextCursorPositionsResult as dc, type MindooDBAppTextCursorsResult as dd, type MindooDBAppTextEdit as de, type MindooDBAppTextPatch as df, type MindooDBAppThemeMode as dg, type MindooDBAppTimestampApi as dh, type MindooDBAppTimestampInput as di, type MindooDBAppTimestampProvider as dj, type MindooDBAppTimestampResult as dk, type MindooDBAppUiPreferences as dl, type MindooDBAppUpdateDocumentInput as dm, type MindooDBAppViewCursorDocumentListResult as dn, type MindooDBAppViewCursorResult as dp, type MindooDBAppViewEntry as dq, type MindooDBAppViewEntryKind as dr, type MindooDBAppViewNavigator as ds, type MindooDBAppViewNavigatorExpansionState as dt, type MindooDBAppViewNavigatorOpenOptions as du, type MindooDBAppViewNavigatorPageOptions as dv, type MindooDBAppViewNavigatorPageResult as dw, type MindooDBAppViewNavigatorRangeQuery as dx, type MindooDBAppViewNavigatorSelectionState as dy, type MindooDBAppViewUpdateStats 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.67",
   "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",