mindoodb-app-sdk 0.0.65 → 0.0.67

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-BeRUxGKN.js';
-export { p as MINDOODB_APP_ACCEPTS_MAX, q as MINDOODB_APP_COMPONENTS_MAX, r as MINDOODB_APP_DEFINITION_FILE_NAME, s as MINDOODB_APP_DEFINITION_FORMAT, t as MINDOODB_APP_DEFINITION_PERMISSIONS, u as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, v as MINDOODB_APP_DEFINITION_VERSION, w as MINDOODB_APP_LISTING_DESCRIPTION_MAX, x as MINDOODB_APP_LISTING_MAX_SCREENSHOTS, y as MINDOODB_APP_LISTING_SUMMARY_MAX, z as MINDOODB_APP_SEAL_SIGNING_DOMAIN, A as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, B as MindooDBAppAcceptSpec, C as MindooDBAppAccessDecision, D as MindooDBAppAccessTier, E as MindooDBAppAgentApi, F as MindooDBAppAgentRegistration, G as MindooDBAppAgentTool, H as MindooDBAppAgentToolAnnotations, I as MindooDBAppAgentToolDescriptor, J as MindooDBAppAttachmentApi, K as MindooDBAppAttachmentChunk, L as MindooDBAppAttachmentInfo, N as MindooDBAppAttachmentPreviewOptions, O as MindooDBAppAttachmentPreviewSession, P as MindooDBAppAutomergeChangesPatch, Q as MindooDBAppAutomergeChangesSince, R as MindooDBAppAutomergeGetOptions, S as MindooDBAppAutomergePatchResult, T as MindooDBAppAutomergeSnapshot, U as MindooDBAppBridgeAgentInvokeMessage, V as MindooDBAppBridgeAgentResultMessage, W as MindooDBAppBridgeBeforeCloseAck, X as MindooDBAppBridgeBeforeCloseMessage, Y as MindooDBAppBridgeConnectMessage, Z as MindooDBAppBridgeConnectOptions, _ as MindooDBAppBridgeConnectedMessage, $ as MindooDBAppBridgeDragDropMessage, a0 as MindooDBAppBridgeDragLeaveMessage, a1 as MindooDBAppBridgeDragOverMessage, a2 as MindooDBAppBridgeEmbedEventMessage, a3 as MindooDBAppBridgeEmbeddingRequestMessage, a4 as MindooDBAppBridgeErrorPayload, a5 as MindooDBAppBridgeHandshakeErrorMessage, a6 as MindooDBAppBridgeHostFocusChangedMessage, a7 as MindooDBAppBridgeIncomingContentMessage, a8 as MindooDBAppBridgeLocaleChangedMessage, a9 as MindooDBAppBridgePortMessage, aa as MindooDBAppBridgeQueryResultMessage, ab as MindooDBAppBridgeRpcError, ac as MindooDBAppBridgeRpcMessage, ad as MindooDBAppBridgeRpcRequest, ae as MindooDBAppBridgeRpcSuccess, af as MindooDBAppBridgeShortcutInvokedMessage, ag as MindooDBAppBridgeShortcutsChangedMessage, ah as MindooDBAppBridgeStreamAbortRequest, ai as MindooDBAppBridgeStreamAck, aj as MindooDBAppBridgeStreamCloseRequest, ak as MindooDBAppBridgeStreamError, al as MindooDBAppBridgeStreamMessage, am as MindooDBAppBridgeStreamOpenResult, an as MindooDBAppBridgeStreamReadRequest, ao as MindooDBAppBridgeStreamWriteRequest, ap as MindooDBAppBridgeThemeChangedMessage, aq as MindooDBAppBridgeUiPreferencesChangedMessage, ar as MindooDBAppBridgeViewChangedMessage, as as MindooDBAppBridgeViewportChangedMessage, at as MindooDBAppBridgeWorkspaceFocusRequestedMessage, au as MindooDBAppBrowserFeatures, av as MindooDBAppCapability, aw as MindooDBAppComponentChildren, ax as MindooDBAppComponentFieldValue, ay as MindooDBAppComponentInfo, az as MindooDBAppComponentIntent, aA as MindooDBAppComponentQuery, aB as MindooDBAppComponentSpec, aC as MindooDBAppComponentsApi, aD as MindooDBAppConfiguredViewCategorizationStyle, aE as MindooDBAppConfiguredViewColumn, aF as MindooDBAppConfiguredViewColumnRole, aG as MindooDBAppConfiguredViewExpressionMode, aH as MindooDBAppConfiguredViewFieldExpression, aI as MindooDBAppConfiguredViewFilterDefinition, aJ as MindooDBAppConfiguredViewFilterMode, aK as MindooDBAppConfiguredViewFilterRule, aL as MindooDBAppConfiguredViewFormulaExpression, aM as MindooDBAppConfiguredViewFormulaFilterDefinition, aN as MindooDBAppConfiguredViewPreviewMode, aO as MindooDBAppConfiguredViewRuleFilterDefinition, aP as MindooDBAppConfiguredViewRuleMatchMode, aQ as MindooDBAppConfiguredViewRuleOperator, aR as MindooDBAppConfiguredViewValueExpression, aS as MindooDBAppCreateKeyInfo, aT as MindooDBAppCreateViewInput, aU as MindooDBAppCreateViewNavigatorInput, aV as MindooDBAppDatabaseInfo, aW as MindooDBAppDefinitionDatabase, aX as MindooDBAppDefinitionListing, aY as MindooDBAppDefinitionPermission, aZ as MindooDBAppDefinitionRegistrationPermission, a_ as MindooDBAppDefinitionScreenshot, a$ as MindooDBAppDefinitionValidation, b0 as MindooDBAppDirectoryApi, b1 as MindooDBAppDirectoryEntry, b2 as MindooDBAppDocumentApi, b3 as MindooDBAppDocumentHeadCursorResult, b4 as MindooDBAppDocumentHistoryEntry, b5 as MindooDBAppDocumentListQuery, b6 as MindooDBAppDocumentListResult, b7 as MindooDBAppDocumentQuery, b8 as MindooDBAppDocumentRevisionId, b9 as MindooDBAppDocumentScanPreset, ba as MindooDBAppDocumentSummary, bb as MindooDBAppDragApi, bc as MindooDBAppDragCancelReason, bd as MindooDBAppDragDropEvent, be as MindooDBAppDragEffect, bf as MindooDBAppDragHoverResult, bg as MindooDBAppDragOffer, bh as MindooDBAppDragOverEvent, bi as MindooDBAppDragPointer, bj as MindooDBAppDragProfile, bk as MindooDBAppEmbed, bl as MindooDBAppEmbedCloseReason, bm as MindooDBAppEmbedClosedEvent, bn as MindooDBAppEmbedContext, bo as MindooDBAppEmbedDirtyEvent, bp as MindooDBAppEmbedOpenInput, bq as MindooDBAppEmbedRect, br as MindooDBAppEmbeddingApi, bs as MindooDBAppEmbedsApi, bt as MindooDBAppEntryAttachmentRef, bu as MindooDBAppEntryProvenance, bv as MindooDBAppExtractDocumentTextInput, bw as MindooDBAppExtractDocumentTextResult, bx as MindooDBAppExtractTextFormat, by as MindooDBAppExtractionSetup, bz as MindooDBAppFulltextSetup, bA as MindooDBAppHistoricalDocument, bB as MindooDBAppHistoryQuery, bC as MindooDBAppHostTheme, bD as MindooDBAppIdentityApi, bE as MindooDBAppInaccessibleDocument, bF as MindooDBAppInaccessibleDocumentListQuery, bG as MindooDBAppInaccessibleDocumentListResult, bH as MindooDBAppIncomingContent, bI as MindooDBAppIncomingContentHandler, bJ as MindooDBAppIncomingContentInfo, bK as MindooDBAppIncomingItem, bL as MindooDBAppIncomingItemInfo, bM as MindooDBAppIncomingResult, bN as MindooDBAppIncomingSource, bO as MindooDBAppJsonCounterIncrementPatch, bP as MindooDBAppJsonListDeletePatch, bQ as MindooDBAppJsonListInsertPatch, bR as MindooDBAppJsonPatch, bS as MindooDBAppJsonSetPatch, bT as MindooDBAppJsonTextMarkPatch, bU as MindooDBAppJsonTextSplicePatch, bV as MindooDBAppJsonTextUnmarkPatch, bW as MindooDBAppJsonUnsetPatch, bX as MindooDBAppLaunchContext, bY as MindooDBAppListUsersOptions, bZ as MindooDBAppListUsersPage, b_ as MindooDBAppLiveQuerySubscription, b$ as MindooDBAppLocalizedText, c0 as MindooDBAppMenuAnchor, c1 as MindooDBAppMenuApi, c2 as MindooDBAppMenuCommandItem, c3 as MindooDBAppMenuDismissReason, c4 as MindooDBAppMenuDismissedResult, c5 as MindooDBAppMenuItem, c6 as MindooDBAppMenuKind, c7 as MindooDBAppMenuPlacement, c8 as MindooDBAppMenuPointAnchor, c9 as MindooDBAppMenuRect, ca as MindooDBAppMenuRectAnchor, cb as MindooDBAppMenuSelectionResult, cc as MindooDBAppMenuSeparatorItem, cd as MindooDBAppNotificationSeverity, ce as MindooDBAppNotifyInput, cf as MindooDBAppNotifyResult, cg as MindooDBAppProposeAppInput, ch as MindooDBAppProposeAppResult, ci as MindooDBAppQueryCoverage, cj as MindooDBAppQueryInclude, ck as MindooDBAppQueryIncludeCardinality, cl as MindooDBAppQueryIncludeSlots, cm as MindooDBAppQueryResult, cn as MindooDBAppQueryRow, co as MindooDBAppQuerySortKey, cp as MindooDBAppQueryTextClause, cq as MindooDBAppReadableAttachmentStream, cr as MindooDBAppRecipientOptions, cs as MindooDBAppResolvedViewDefinition, ct as MindooDBAppResolvedViewSource, cu as MindooDBAppRevisionPhase, cv as MindooDBAppRevisionVerification, cw as MindooDBAppRichTextBlockSpan, cx as MindooDBAppRichTextGetOptions, cy as MindooDBAppRichTextImmutableString, cz as MindooDBAppRichTextMarkRange, cA as MindooDBAppRichTextMaterializeValue, cB as MindooDBAppRichTextPatch, cC as MindooDBAppRichTextScalar, cD as MindooDBAppRichTextSpliceStep, cE as MindooDBAppRichTextStep, cF as MindooDBAppRichTextStepPatch, cG as MindooDBAppRichTextTextSpan, cH as MindooDBAppRuntime, cI as MindooDBAppScanAttachmentOptions, cJ as MindooDBAppScanAttachmentResult, cK as MindooDBAppScopedDocId, cL as MindooDBAppScopedDocumentSummary, cM as MindooDBAppSealIntent, cN as MindooDBAppSealedChannelOpenInput, cO as MindooDBAppSealedChannelOpenResult, cP as MindooDBAppSealedChannelRequestInput, cQ as MindooDBAppSession, cR as MindooDBAppShowMenuInput, cS as MindooDBAppShowMenuResult, cT as MindooDBAppSignPreview, cU as MindooDBAppSignPreviewScope, cV as MindooDBAppSignStatementInput, cW as MindooDBAppSignStatementResult, cX as MindooDBAppStorageApi, cY as MindooDBAppSummarySetup, cZ as MindooDBAppTextCursorOptions, c_ as MindooDBAppTextCursorPosition, c$ as MindooDBAppTextCursorPositionsResult, d0 as MindooDBAppTextCursorsResult, d1 as MindooDBAppTextEdit, d2 as MindooDBAppTextPatch, d3 as MindooDBAppThemeMode, d4 as MindooDBAppTimestampApi, d5 as MindooDBAppTimestampInput, d6 as MindooDBAppTimestampProvider, d7 as MindooDBAppTimestampResult, d8 as MindooDBAppUiPreferences, d9 as MindooDBAppUpdateDocumentInput, da as MindooDBAppViewCursorDocumentListResult, db as MindooDBAppViewCursorResult, dc as MindooDBAppViewEntry, dd as MindooDBAppViewEntryKind, de as MindooDBAppViewNavigator, df as MindooDBAppViewNavigatorExpansionState, dg as MindooDBAppViewNavigatorOpenOptions, dh as MindooDBAppViewNavigatorPageOptions, di as MindooDBAppViewNavigatorPageResult, dj as MindooDBAppViewNavigatorRangeQuery, dk as MindooDBAppViewNavigatorSelectionState, dl as MindooDBAppViewUpdateStats, dm as MindooDBAppViewport, dn as MindooDBAppWellKnownDragType, dp as MindooDBAppWritableAttachmentStream, dq as mindooDBAppAcceptMatchesType, dr as mindooDBAppComponentFieldsMatch, ds as resolveMindooDBAppDefinitionUrl, dt as resolveMindooDBAppListingAssetUrl, du as resolveMindooDBAppLocalizedText, dv as validateMindooDBAppAccepts, dw as validateMindooDBAppComponents, dx as validateMindooDBAppDefinition } from './types-BeRUxGKN.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

@@ -4,6 +4,7 @@ import {
   DEFAULT_HAVEN_HOST_SHORTCUTS,
   MINDOODB_APP_ACCEPTS_MAX,
   MINDOODB_APP_COMPONENTS_MAX,
+  MINDOODB_APP_COMPONENT_CONTRACT_PATTERN,
   MINDOODB_APP_DEFINITION_FILE_NAME,
   MINDOODB_APP_DEFINITION_FORMAT,
   MINDOODB_APP_DEFINITION_PERMISSIONS,
@@ -47,7 +48,7 @@ import {
   validateMindooDBAppAccepts,
   validateMindooDBAppComponents,
   validateMindooDBAppDefinition
-} from "./chunk-BE7LLFFE.js";
+} from "./chunk-376SABPG.js";
 import {
   MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
   MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME,
@@ -152,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";
@@ -1288,6 +1371,7 @@ export {
   MINDOODB_APP_BUNDLE_MANIFEST_FORMAT,
   MINDOODB_APP_BUNDLE_MANIFEST_VERSION,
   MINDOODB_APP_COMPONENTS_MAX,
+  MINDOODB_APP_COMPONENT_CONTRACT_PATTERN,
   MINDOODB_APP_DEFINITION_FILE_NAME,
   MINDOODB_APP_DEFINITION_FORMAT,
   MINDOODB_APP_DEFINITION_PERMISSIONS,
@@ -1314,12 +1398,15 @@ export {
   MindooDBRichTextHandle,
   MindooDBTextBuffer,
   abbreviateCanonicalName,
+  agentGuideExamples,
+  agentGuideSignatureIndex,
   applyHostedDocumentOverscrollContain,
   assertValidMindooDBCreateIds,
   bindDragSource,
   buildHavenAppInstallUrl,
   buildMindooDBAppBundleContentHashInput,
   canPreviewAttachment,
+  createAgentGuideTool,
   createMindooDBAppBridge,
   createMindooDBRichTextHandle,
   createMindooDBTextBuffer,
@@ -1348,6 +1435,7 @@ export {
   readMindooDBAppHostingMode,
   readMindooDBAppLaunchId,
   releaseMindooDBAppBridgeSessions,
+  renderAgentGuideGroup,
   renderHavenAppLandingPage,
   resolveCurrentHavenAppUrl,
   resolveMindooDBAppDefinitionUrl,

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { ay as MindooDBAppComponentInfo, bq as MindooDBAppEmbedRect, I as MindooDBAppAgentToolDescriptor, f as MindooDBAppAgentToolErrorCode, V as MindooDBAppBridgeAgentResultMessage, U as MindooDBAppBridgeAgentInvokeMessage, aU as MindooDBAppCreateViewNavigatorInput, de as MindooDBAppViewNavigator, ad as MindooDBAppBridgeRpcRequest, bC as MindooDBAppHostTheme, av as MindooDBAppCapability, d9 as MindooDBAppUpdateDocumentInput, l as MindooDBAppDocument, j as MindooDBAppDefinition, J as MindooDBAppAttachmentApi, e as MindooDBAppBridge, cQ as MindooDBAppSession, cg as MindooDBAppProposeAppInput, dm as MindooDBAppViewport, d8 as MindooDBAppUiPreferences, cm as MindooDBAppQueryResult, dl as MindooDBAppViewUpdateStats, a9 as MindooDBAppBridgePortMessage, aV as MindooDBAppDatabaseInfo, bl as MindooDBAppEmbedCloseReason, a4 as MindooDBAppBridgeErrorPayload, bX as MindooDBAppLaunchContext, b2 as MindooDBAppDocumentApi, dg as MindooDBAppViewNavigatorOpenOptions, bD as MindooDBAppIdentityApi, d4 as MindooDBAppTimestampApi, b0 as MindooDBAppDirectoryApi, bz as MindooDBAppFulltextSetup, by as MindooDBAppExtractionSetup, cY as MindooDBAppSummarySetup, ch as MindooDBAppProposeAppResult, bN as MindooDBAppIncomingSource, c as MindooDBAppDragStartResult, bj as MindooDBAppDragProfile, bM as MindooDBAppIncomingResult } from '../types-BeRUxGKN.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';
 
@@ -13,6 +13,10 @@ interface MockEmbedState {
     visible: boolean;
     /** What the component last reported (`setEmbedDirty`); `undefined` until then. */
     dirty?: boolean;
+    /** Whether it is the active one of its app's embeds (`embed.setActive`, or the newest). */
+    active: boolean;
+    /** The agent tools it offers (`setEmbedAgentTools`), as the host app sees them. */
+    agentTools: MindooDBAppEmbedAgentTools | null;
 }
 /** How an app running as an embedded component finished (`session.embedding`). */
 interface MockEmbeddingFinish {
@@ -20,6 +24,23 @@ interface MockEmbeddingFinish {
     result?: unknown;
     message?: string;
 }
+interface MockEmbedHostOptions {
+    /** What `session.components.list` offers. */
+    components?: MindooDBAppComponentInfo[];
+    /** Called when the app opens an embed, e.g. to draw a stand-in in the test host page. */
+    onEmbedChange?: (embeds: readonly MockEmbedState[]) => void;
+    /**
+     * For an app under test that runs as a component: answers its
+     * `session.embedding.lookup`, as Haven would from the host's database. No results
+     * 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[]>;
+}
 
 /**
  * Haven's side of agent tools, for tests: what `session.agent` talks to.
@@ -131,6 +152,8 @@ declare function createMockAgentHost(options: MockAgentHostOptions & {
     /** Posts to the app's port; `false` when no app is connected. */
     post(message: MindooDBAppBridgeAgentInvokeMessage): boolean;
     onChange?(): void;
+    /** Whether the app runs as an embedded component: then only its `document` tools count. */
+    embedded?(): boolean;
 }): MockAgentHost;
 
 type EvaluatingViewDocument = {
@@ -152,6 +175,33 @@ declare function loadMindoodbForTesting(): Promise<MindoodbVirtualViews | null>;
  */
 declare function createEvaluatingViewNavigator(input: MindooDBAppCreateViewNavigatorInput, documents: EvaluatingViewDocument[]): Promise<MindooDBAppViewNavigator | null>;
 
+interface TestHostUser {
+    /** Shown above the user's frame. */
+    name: string;
+    username: string;
+}
+declare const DEFAULT_TEST_HOST_USERS: readonly [TestHostUser, TestHostUser];
+/** Window handles of the two-user mode, for Playwright. */
+interface TwoUserTestHost {
+    hosts: [BrowserTestHost, BrowserTestHost];
+    /** Merge the two replicas now; resolves with the number of documents that changed. */
+    sync(): Promise<number>;
+    setAutoSync(on: boolean): void;
+    /** Documents that differ between the replicas. */
+    differences(): number;
+}
+declare global {
+    interface Window {
+        /** Set in two-user mode. */
+        __havenTwoUsers?: TwoUserTestHost;
+    }
+}
+declare function mountTwoUserTestHost(options: Omit<CreateBrowserTestHostOptions, "frame"> & {
+    container?: HTMLElement;
+    title?: string;
+    users?: readonly [TestHostUser, TestHostUser];
+}, createHost: (options: CreateBrowserTestHostOptions) => BrowserTestHost): TwoUserTestHost;
+
 /**
  * A stand-in Haven for a real browser: the app runs in an iframe, exactly as Haven frames
  * it, and talks to the same in-memory mock host the Vitest helpers use.
@@ -323,6 +373,14 @@ interface MountHavenTestHostOptions extends Omit<CreateBrowserTestHostOptions, "
      * true. URL settings win over the options passed here.
      */
     urlSettings?: boolean;
+    /**
+     * Two app frames side by side, each on its own replica of the databases, merged by
+     * "Sync" / auto-sync — for testing concurrent editing by hand. Also `?twoUsers=1`.
+     * See {@link mountTwoUserTestHost}.
+     */
+    twoUsers?: boolean;
+    /** Names of the two users in two-user mode (default Anna and Ben). */
+    users?: readonly [TestHostUser, TestHostUser];
 }
 /** The locales Haven's UI offers; the default of the panel's language switcher. */
 declare const TEST_HOST_LOCALES: ReadonlyArray<{
@@ -346,6 +404,11 @@ declare function previewJson(value: unknown, maxString?: number, maxItems?: numb
  * of notifications, previews, scans and requests (click an entry for details).
  * The returned host is also available as `window.__havenTestHost`.
  */
+/**
+ * "Single user" / "Two users": links to the same test page with or without
+ * `twoUsers=1`, keeping the other URL settings (db, enforce, users, locale, …).
+ */
+declare function modeSwitch(current: "single" | "two"): HTMLElement;
 declare function mountHavenTestHost(options: MountHavenTestHostOptions): BrowserTestHost;
 
 /**
@@ -487,10 +550,27 @@ interface CreateMockMindooDBAppSessionOptions {
      * `methods.directory` still wins.
      */
     directoryUsers?: readonly string[];
+    /**
+     * Automerge actor (hex) of the app's writes in `automerge: true` databases. Mocks
+     * that are synced with each other (`syncMockReplicas`, the test host's two-user
+     * mode) need distinct actors, like two devices.
+     */
+    automergeActor?: string;
     /** What `session.components.list` offers; see `closeEmbed` on the controller. */
     components?: MindooDBAppComponentInfo[];
     /** Called whenever the app opens, moves or closes an embed. */
     onEmbedChange?: (embeds: readonly MockEmbedState[]) => void;
+    /**
+     * For an app under test that runs as a component: answers its
+     * `session.embedding.lookup` (documents a reference may point at), as Haven would
+     * 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
@@ -553,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. */
@@ -561,6 +643,10 @@ interface MockMindooDBAppSessionController {
     getEmbeddingFinish(): MockEmbeddingFinish | null;
     /** As if the embedded component reported (un)saved changes; the app's embed follows. */
     setEmbedDirty(embedId: string, dirty: boolean): void;
+    /** As if the embedded component registered these agent tools (names without prefix). */
+    setEmbedAgentTools(embedId: string, names: string[] | null, options?: {
+        enabled?: boolean;
+    }): void;
     /** Makes the app's next `embed.save()` fail with this message. */
     failNextEmbedSave(message: string): void;
     /** For an app under test that runs as a component: its last `embedding.setDirty`. */
@@ -586,6 +672,20 @@ interface MockIncomingContentInput {
     }>;
 }
 
+type MockReplica = MockMindooDBAppSessionController | FakeBridgeHostController;
+/**
+ * How many documents differ between two mocks (missing on one side, other heads, or
+ * deleted on one side only): what `syncMockReplicas` would bring over.
+ */
+declare function mockReplicaDifferences(a: MockReplica, b: MockReplica): number;
+/**
+ * Syncs two mocks like two Haven devices: every document of every database both have
+ * is merged both ways (Automerge histories with `automerge: true`, so concurrent edits
+ * merge as in Haven; otherwise the newer copy wins), deletions spread, and attachments
+ * missing on one side are copied. Give the mocks distinct `automergeActor`s. Returns
+ * the number of documents that changed on either side.
+ */
+declare function syncMockReplicas(a: MockReplica, b: MockReplica): Promise<number>;
 declare function createMockMindooDBAppSession(options?: CreateMockMindooDBAppSessionOptions): MockMindooDBAppSessionController;
 declare function createMockMindooDBAppBridge(options?: CreateMockMindooDBAppSessionOptions): MockMindooDBAppSessionController;
 type FakeBridgeRequestHandler = (params: unknown, context: {
@@ -664,12 +764,21 @@ 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. */
     getEmbeddingFinish(): MockEmbeddingFinish | null;
     /** As if the embedded component reported (un)saved changes; pushes the `embed-event`. */
     setEmbedDirty(embedId: string, dirty: boolean): void;
+    /**
+     * As if the embedded component registered these agent tools (names without prefix);
+     * pushes the `embed-event`. `null` or `[]` withdraws them.
+     */
+    setEmbedAgentTools(embedId: string, names: string[] | null, options?: {
+        enabled?: boolean;
+    }): void;
     /** Makes the app's next `embed.save()` fail with this message. */
     failNextEmbedSave(message: string): void;
     /** For an app under test that runs as a component: its last `embedding.setDirty`. */
@@ -687,4 +796,4 @@ interface FakeBridgeHostController {
 }
 declare function createFakeBridgeHost(options?: CreateFakeBridgeHostOptions): FakeBridgeHostController;
 
-export { ALL_CAPABILITIES, type BrowserTestHost, type BrowserTestHostLog, type BrowserTestHostScan, type BrowserTestHostScanMode, type CreateBrowserTestHostOptions, type CreateFakeBridgeHostOptions, type CreateMockMindooDBAppSessionOptions, type EvaluatingViewDocument, type FakeBridgeHostController, type FakeBridgePortMessageHandler, type FakeBridgeRequestHandler, type FakeBridgeRpcResponse, type MockAgentCall, type MockAgentCallResult, type MockAgentConsent, type MockAgentFile, type MockAgentHost, type MockAgentHostController, type MockAgentHostOptions, type MockDatabaseOverride, type MockDatabasesFromDefinitionOptions, type MockEmbedState, type MockEmbeddingFinish, MockForbiddenError, type MockIncomingContentInput, type MockMindooDBAppDatabaseDefinition, type MockMindooDBAppSessionController, type MockRemoteUpdateOptions, type MockSealedChannelOptions, type MockSeedDocument, type MountHavenTestHostOptions, TEST_HOST_LOCALES, type TestHostUrlSettings, capabilitiesForDefinitionPermissions, createBrowserTestHost, createEvaluatingViewNavigator, createFakeBridgeHost, createMemoryAttachments, createMockAgentHost, createMockMindooDBAppBridge, createMockMindooDBAppSession, generateDirectoryUsers, loadMindoodbForTesting, mockAgentToolPrefix, mockDatabasesFromDefinition, mountHavenTestHost, previewJson, readTestHostUrlSettings, validateMockAgentTools };
+export { ALL_CAPABILITIES, type BrowserTestHost, type BrowserTestHostLog, type BrowserTestHostScan, type BrowserTestHostScanMode, type CreateBrowserTestHostOptions, type CreateFakeBridgeHostOptions, type CreateMockMindooDBAppSessionOptions, DEFAULT_TEST_HOST_USERS, type EvaluatingViewDocument, type FakeBridgeHostController, type FakeBridgePortMessageHandler, type FakeBridgeRequestHandler, type FakeBridgeRpcResponse, type MockAgentCall, type MockAgentCallResult, type MockAgentConsent, type MockAgentFile, type MockAgentHost, type MockAgentHostController, type MockAgentHostOptions, type MockDatabaseOverride, type MockDatabasesFromDefinitionOptions, type MockEmbedState, type MockEmbeddingFinish, MockForbiddenError, type MockIncomingContentInput, type MockMindooDBAppDatabaseDefinition, type MockMindooDBAppSessionController, type MockRemoteUpdateOptions, type MockSealedChannelOptions, type MockSeedDocument, type MountHavenTestHostOptions, TEST_HOST_LOCALES, type TestHostUrlSettings, type TestHostUser, type TwoUserTestHost, capabilitiesForDefinitionPermissions, createBrowserTestHost, createEvaluatingViewNavigator, createFakeBridgeHost, createMemoryAttachments, createMockAgentHost, createMockMindooDBAppBridge, createMockMindooDBAppSession, generateDirectoryUsers, loadMindoodbForTesting, mockAgentToolPrefix, mockDatabasesFromDefinition, mockReplicaDifferences, modeSwitch, mountHavenTestHost, mountTwoUserTestHost, previewJson, readTestHostUrlSettings, syncMockReplicas, validateMockAgentTools };