mindoodb-app-sdk 0.0.62 → 0.0.64

package/TESTING.md

@@ -344,6 +344,7 @@ The page shows the app next to a control panel:
 - **Databases**: one checkbox per capability for every mapped database, plus **Enforce capabilities**. Changing a capability relaunches the app, as Haven does after a permission change. With enforcement on, the mock rejects every call the database was not granted with a `forbidden` error (and `documents.canCreate()` and friends answer `allowed: false`), so you can check the app's hints for missing rights.
 - **Directory**: fills the tenant directory with 0 to 500 generated users (`CN=Test User 001/O=Test`, …) for recipient pickers and paging.
 - **Scanner**: what `attachments.scan()` returns — cancel, a generated sample page, or a file you choose. The file is written to the document's attachments like Haven's scanner does, so the app can read it back.
+- **Agent tools**: the tools the app declared with `session.agent.registerTools()` (with the prefix agents see, `read-only` and `asks first` tags, description and input schema), a form to call one with a JSON input as an agent would, and the result as the agent gets it (images in the result are shown). Tools marked `consequentialHint` go through a confirm, like Haven's consent dialog. A checkbox switches agent access off. **Agent files** imports files for the app (each gets a `fileRef` for `takeFile`) and lists the files the app handed over with `provideFile` for download. **Agent context** shows what the app last passed to `setContext`.
 - A live log of notifications, attachment previews, scans and every RPC request. Click a request for its parameters, its result or error, and how long it took; binary values show as size plus a hex preview.
 
 `mockDatabasesFromDefinition` gives every database an in-memory attachment store (`attachments: "none"` restores the stateless default) and takes overrides for testing other mappings than the definition requests:
@@ -377,6 +378,21 @@ await app.getByRole("button", { name: "Scan" }).click();
 expect(await page.evaluate(() => window.__havenTestHost!.log.scans)).toHaveLength(1);
 ```
 
+Agent tools are scriptable through `window.__havenTestHost.agent`, the same controller the Vitest helpers expose as `createFakeBridgeHost().agent`:
+
+```ts
+const agent = () => window.__havenTestHost!.agent;
+const fileRef = await page.evaluate(() =>
+  agent().importFile({ name: "logo.png", mimeType: "image/png", data: new Uint8Array([137, 80, 78, 71]) }),
+);
+const added = await page.evaluate((ref) => agent().call("image_add", { fileRef: ref }), fileRef);
+expect(added).toMatchObject({ ok: true });
+const exported = await page.evaluate(() => agent().call("deck_export", { format: "pptx" }));
+const file = await page.evaluate((ref) => agent().getFile(ref)?.name, (exported as any).result.files[0].fileRef);
+```
+
+`call()` takes the tool's own name or the prefixed one and never throws: failures come back as `{ ok: false, error: { code, message, requiredAction } }`, the codes an agent sees. The mock follows Haven: tool declarations are validated (name, at most 64 tools, 2000-character descriptions, an object `inputSchema`), the prefix is the definition's `agentToolPrefix` (pass it as the `agentToolPrefix` option) or derived from the app id, an app can only `takeFile()` what was imported for it, and file refs expire after ten minutes. `setConsent("allow" | "deny" | fn)` answers the consent step in scripts, `setEnabled(false)` switches access off, and `calls()` lists every call with its outcome.
+
 `setNextScan()` decides only the next scan (pass `bytes` to attach real content); `setScanMode()` decides the ones after it. `setDirectoryUsers()` and `setEnforceCapabilities()` apply to the next call.
 
 The Level 1 and 2 helpers take the same options: `createMockMindooDBAppSession({ enforceCapabilities: true, directoryUsers: generateDirectoryUsers(120) })`, with `setCapabilities()`, `setEnforceCapabilities()` and `setDirectoryUsers()` on the controller, and `createMemoryAttachments()` for a database's `methods.attachments`. `createFakeBridgeHost({ onResponse })` reports every answer with its duration.

package/dist/{chunk-QQRLEHFE.js → chunk-BE7LLFFE.js}

@@ -1482,7 +1482,6 @@ var MindooDBAppEmbedImpl = class {
     }
     if (this.frame) {
       this.frame.style.visibility = visible ? "" : "hidden";
-      return;
     }
     await this.rpc.call("embeds.setVisible", { embedId: this.embedId, visible: visible === true });
   }

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-ClOh6z0L.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-ClOh6z0L.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 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';
 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';

package/dist/index.js

@@ -47,7 +47,7 @@ import {
   validateMindooDBAppAccepts,
   validateMindooDBAppComponents,
   validateMindooDBAppDefinition
-} from "./chunk-QQRLEHFE.js";
+} from "./chunk-BE7LLFFE.js";
 import {
   MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
   MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME,

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { ay as MindooDBAppComponentInfo, bq as MindooDBAppEmbedRect, aU as MindooDBAppCreateViewNavigatorInput, de as MindooDBAppViewNavigator, ad as MindooDBAppBridgeRpcRequest, bC as MindooDBAppHostTheme, av as MindooDBAppCapability, 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, l as MindooDBAppDocument, 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-ClOh6z0L.js';
+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, 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, l as MindooDBAppDocument, 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 * as mindoodb from 'mindoodb';
 import 'mindoodb-view-language';
 
@@ -21,6 +21,118 @@ interface MockEmbeddingFinish {
     message?: string;
 }
 
+/**
+ * Haven's side of agent tools, for tests: what `session.agent` talks to.
+ *
+ * It accepts the app's tool declarations and context with Haven's validation, keeps
+ * the files the app hands over (`provideFile`), lets a test hand the app files the way
+ * Haven imports them from the exchange folder (`takeFile`), and calls the app's tools
+ * over the bridge port like Haven's broker, including the consent step for tools
+ * marked `consequentialHint`.
+ */
+
+/** A file in the mock exchange: handed over by the app, or imported for it by the test. */
+interface MockAgentFile {
+    fileRef: string;
+    name: string;
+    mimeType: string;
+    data: Uint8Array;
+    /** `app`: the app produced it (`provideFile`); `host`: imported for the app (`takeFile`). */
+    source: "app" | "host";
+    createdAt: number;
+    expiresAt: number;
+}
+/** How Haven's consent dialog answers a call to a consequential tool. */
+type MockAgentConsent = "allow" | "deny" | ((call: {
+    tool: string;
+    input: Record<string, unknown>;
+}) => boolean | Promise<boolean>);
+type MockAgentCallResult = {
+    ok: true;
+    result: unknown;
+    durationMs: number;
+} | {
+    ok: false;
+    error: {
+        code: MindooDBAppAgentToolErrorCode | "LOCKED" | string;
+        message: string;
+        requiredAction?: string;
+    };
+    durationMs: number;
+};
+/** One tool call as the log records it. */
+interface MockAgentCall {
+    callId: string;
+    tool: string;
+    input: Record<string, unknown>;
+    startedAt: number;
+    outcome?: MockAgentCallResult;
+}
+interface MockAgentHostOptions {
+    /**
+     * The prefix agents see in front of the app's tool names (`agentToolPrefix` in
+     * `haven-app.json`). Without one it is derived from the app id, as Haven does.
+     */
+    agentToolPrefix?: string;
+    /** Whether the user has agent access on (`registerTools` answers `enabled`). Default true. */
+    agentToolsEnabled?: boolean;
+    /** Answer of the consent dialog for consequential tools. Default `"allow"`. */
+    agentConsent?: MockAgentConsent;
+    /** How long a call waits for the app. Default 120 s, Haven's limit. */
+    agentInvokeTimeoutMs?: number;
+}
+interface MockAgentHostController {
+    /** The app's tools as it declared them (without prefix). */
+    tools(): MindooDBAppAgentToolDescriptor[];
+    /** The names agents see: `<prefix>_<name>`. */
+    exposedNames(): string[];
+    readonly prefix: string;
+    /** What the app last passed to `setContext`. */
+    context(): Record<string, unknown> | null;
+    isEnabled(): boolean;
+    setEnabled(enabled: boolean): void;
+    setConsent(consent: MockAgentConsent): void;
+    /**
+     * Calls one of the app's tools as an agent would, by its own name or the prefixed
+     * one. Never throws: failures come back as `{ ok: false, error }` with the code the
+     * agent would see.
+     */
+    call(tool: string, input?: Record<string, unknown>): Promise<MockAgentCallResult>;
+    /** Every call so far, oldest first. */
+    calls(): ReadonlyArray<MockAgentCall>;
+    /** Puts a file in the exchange for the app, as Haven's `haven_files_import`; returns its fileRef. */
+    importFile(file: {
+        name: string;
+        mimeType?: string;
+        data: Uint8Array | ArrayBuffer | Blob | string;
+    }): Promise<string>;
+    /** A file the app handed over (`provideFile`), or `null` when unknown or expired. */
+    getFile(fileRef: string): MockAgentFile | null;
+    /** Files in the exchange (both directions), newest first. */
+    files(): MockAgentFile[];
+}
+/** Haven's derivation when the app declares no prefix (`agentAppKey`). */
+declare function mockAgentToolPrefix(appId: string, declared?: string): string;
+/** Haven's checks on declared tools (`validateAgentToolDescriptors`). */
+declare function validateMockAgentTools(raw: unknown): MindooDBAppAgentToolDescriptor[];
+interface MockAgentHost {
+    controller: MockAgentHostController;
+    /** Answers `agent.*` requests; `undefined` for any other method. */
+    dispatch(method: string, params: unknown): Promise<{
+        result: unknown;
+    } | undefined>;
+    /** The app's `agent-result` message. */
+    handleResult(message: MindooDBAppBridgeAgentResultMessage): void;
+    /** Fails pending calls (the app closed or reloaded). */
+    reset(reason?: string): void;
+}
+declare function createMockAgentHost(options: MockAgentHostOptions & {
+    appId: () => string;
+    /** Posts to the app's port; `false` when no app is connected. */
+    post(message: MindooDBAppBridgeAgentInvokeMessage): boolean;
+    onChange?(): void;
+}): MockAgentHost;
+
 type EvaluatingViewDocument = {
     origin: string;
     docId: string;
@@ -105,6 +217,12 @@ interface CreateBrowserTestHostOptions extends CreateFakeBridgeHostOptions {
 interface BrowserTestHost {
     host: FakeBridgeHostController;
     log: BrowserTestHostLog;
+    /**
+     * Haven's agent-tool side (same as `host.agent`): the app's declared tools and
+     * context, `call(tool, input)` as an agent would, `importFile()` to hand the app a
+     * file for `takeFile`, and `getFile()` for what it handed over with `provideFile`.
+     */
+    agent: MockAgentHostController;
     /**
      * Decides the outcome of the app's next `attachments.scan()`: a file to "scan", or
      * `null` to act as if the user cancelled. Later scans follow {@link setScanMode}.
@@ -451,8 +569,10 @@ type FakeBridgeRpcResponse = {
     error: MindooDBAppBridgeErrorPayload;
     durationMs: number;
 };
-interface CreateFakeBridgeHostOptions extends CreateMockMindooDBAppSessionOptions {
+interface CreateFakeBridgeHostOptions extends CreateMockMindooDBAppSessionOptions, MockAgentHostOptions {
     windowMode?: "parent" | "opener";
+    /** Called when the app's agent tools, context or exchange files change, and after each tool call. */
+    onAgentChange?: () => void;
     requestHandlers?: Record<string, FakeBridgeRequestHandler>;
     /** Called for every RPC request the app sends, before it is answered. */
     onRequest?: (request: MindooDBAppBridgeRpcRequest) => void;
@@ -519,7 +639,12 @@ interface FakeBridgeHostController {
      * over the port and resolves or rejects with the app's answer.
      */
     requestEmbeddingSave(): Promise<void>;
+    /**
+     * Haven's agent-tool side: the tools and context the app declared, files in the
+     * exchange, and `call()` to run a tool as an agent would.
+     */
+    readonly agent: MockAgentHostController;
 }
 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 MockDatabaseOverride, type MockDatabasesFromDefinitionOptions, type MockEmbedState, type MockEmbeddingFinish, MockForbiddenError, type MockIncomingContentInput, type MockMindooDBAppDatabaseDefinition, type MockMindooDBAppSessionController, type MockSealedChannelOptions, type MockSeedDocument, type MountHavenTestHostOptions, TEST_HOST_LOCALES, type TestHostUrlSettings, capabilitiesForDefinitionPermissions, createBrowserTestHost, createEvaluatingViewNavigator, createFakeBridgeHost, createMemoryAttachments, createMockMindooDBAppBridge, createMockMindooDBAppSession, generateDirectoryUsers, loadMindoodbForTesting, mockDatabasesFromDefinition, mountHavenTestHost, previewJson, readTestHostUrlSettings };
+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 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 };

package/dist/testing/index.js

@@ -4,7 +4,7 @@ import {
   mindooDBAppComponentFieldsMatch,
   pageUsers,
   releaseMindooDBAppBridgeSessions
-} from "../chunk-QQRLEHFE.js";
+} from "../chunk-BE7LLFFE.js";
 
 // src/testing/index.ts
 import * as Automerge from "@automerge/automerge";
@@ -102,7 +102,7 @@ function getCategoryPath(entry) {
   }
   return path;
 }
-function serializeEntry(navigator, entry) {
+function serializeEntry(navigator2, entry) {
   const parent = entry.getParent();
   return {
     key: entry.getPositionStr(),
@@ -122,8 +122,8 @@ function serializeEntry(navigator, entry) {
     childCategoryCount: entry.getChildCategoryCount(),
     childDocumentCount: entry.getChildDocumentCount(),
     position: entry.getPositionStr(),
-    expanded: entry.isCategory() ? navigator.isExpanded(entry) : false,
-    selected: navigator.isSelected(entry.origin, entry.docId),
+    expanded: entry.isCategory() ? navigator2.isExpanded(entry) : false,
+    selected: navigator2.isSelected(entry.origin, entry.docId),
     isVisible: true
   };
 }
@@ -208,21 +208,21 @@ function createCoreNavigator(mindoodb, view, options) {
 function normalizePageLimit(limit) {
   return Math.max(1, Math.min(1e3, Math.trunc(limit ?? 100)));
 }
-function pageEntries(navigator, direction, options = {}) {
+function pageEntries(navigator2, direction, options = {}) {
   const entries = [];
-  const startOk = options.startPosition ? navigator.gotoPos(options.startPosition) : direction === "forward" ? navigator.gotoFirst() : navigator.gotoLast();
+  const startOk = options.startPosition ? navigator2.gotoPos(options.startPosition) : direction === "forward" ? navigator2.gotoFirst() : navigator2.gotoLast();
   if (!startOk) {
     return { entries, nextPosition: null, hasMore: false };
   }
   const moveNext = () => {
     if (direction === "forward") {
-      return options.selectedOnly ? navigator.gotoNextSelected() : navigator.gotoNext();
+      return options.selectedOnly ? navigator2.gotoNextSelected() : navigator2.gotoNext();
     }
-    return options.selectedOnly ? navigator.gotoPrevSelected() : navigator.gotoPrev();
+    return options.selectedOnly ? navigator2.gotoPrevSelected() : navigator2.gotoPrev();
   };
   if (options.selectedOnly) {
-    const current = navigator.getCurrentEntry();
-    if (!current || !navigator.isSelected(current.origin, current.docId)) {
+    const current = navigator2.getCurrentEntry();
+    if (!current || !navigator2.isSelected(current.origin, current.docId)) {
       if (!moveNext()) return { entries, nextPosition: null, hasMore: false };
     }
   }
@@ -230,26 +230,26 @@ function pageEntries(navigator, direction, options = {}) {
   let nextPosition = null;
   let hasMore = false;
   while (true) {
-    const current = navigator.getCurrentEntry();
+    const current = navigator2.getCurrentEntry();
     if (!current) break;
-    entries.push(serializeEntry(navigator, current));
+    entries.push(serializeEntry(navigator2, current));
     if (entries.length >= limit) {
       hasMore = moveNext();
-      nextPosition = hasMore ? navigator.getCurrentEntry()?.getPositionStr() ?? null : null;
+      nextPosition = hasMore ? navigator2.getCurrentEntry()?.getPositionStr() ?? null : null;
       break;
     }
     if (!moveNext()) break;
   }
   return { entries, nextPosition, hasMore };
 }
-function resolveEntry(navigator, entryKey) {
-  const entry = navigator.getPos(entryKey);
+function resolveEntry(navigator2, entryKey) {
+  const entry = navigator2.getPos(entryKey);
   if (!entry) {
     throw new Error(`Unknown view entry: ${entryKey}`);
   }
   return entry;
 }
-function wrapNavigator(definition, navigator) {
+function wrapNavigator(definition, navigator2) {
   const updateListeners = /* @__PURE__ */ new Set();
   let viewCursor = null;
   return {
@@ -267,164 +267,164 @@ function wrapNavigator(definition, navigator) {
       return () => updateListeners.delete(listener);
     },
     async getCurrentEntry() {
-      const entry = navigator.getCurrentEntry();
-      return entry ? serializeEntry(navigator, entry) : null;
+      const entry = navigator2.getCurrentEntry();
+      return entry ? serializeEntry(navigator2, entry) : null;
     },
     async gotoFirst() {
-      return navigator.gotoFirst();
+      return navigator2.gotoFirst();
     },
     async gotoLast() {
-      return navigator.gotoLast();
+      return navigator2.gotoLast();
     },
     async gotoNext() {
-      return navigator.gotoNext();
+      return navigator2.gotoNext();
     },
     async gotoPrev() {
-      return navigator.gotoPrev();
+      return navigator2.gotoPrev();
     },
     async gotoNextSibling() {
-      return navigator.gotoNextSibling();
+      return navigator2.gotoNextSibling();
     },
     async gotoPrevSibling() {
-      return navigator.gotoPrevSibling();
+      return navigator2.gotoPrevSibling();
     },
     async gotoParent() {
-      return navigator.gotoParent();
+      return navigator2.gotoParent();
     },
     async gotoFirstChild() {
-      return navigator.gotoFirstChild();
+      return navigator2.gotoFirstChild();
     },
     async gotoLastChild() {
-      return navigator.gotoLastChild();
+      return navigator2.gotoLastChild();
     },
     async gotoPos(position) {
-      return navigator.gotoPos(position);
+      return navigator2.gotoPos(position);
     },
     async getPos(position) {
-      const entry = navigator.getPos(position);
-      return entry ? serializeEntry(navigator, entry) : null;
+      const entry = navigator2.getPos(position);
+      return entry ? serializeEntry(navigator2, entry) : null;
     },
     async findCategoryEntryByParts(parts) {
-      const entry = navigator.findCategoryEntryByParts(parts);
-      return entry ? serializeEntry(navigator, entry) : null;
+      const entry = navigator2.findCategoryEntryByParts(parts);
+      return entry ? serializeEntry(navigator2, entry) : null;
     },
     async entriesForward(options) {
-      return pageEntries(navigator, "forward", options);
+      return pageEntries(navigator2, "forward", options);
     },
     async entriesBackward(options) {
-      return pageEntries(navigator, "backward", options);
+      return pageEntries(navigator2, "backward", options);
     },
     async gotoNextSelected() {
-      return navigator.gotoNextSelected();
+      return navigator2.gotoNextSelected();
     },
     async gotoPrevSelected() {
-      return navigator.gotoPrevSelected();
+      return navigator2.gotoPrevSelected();
     },
     async select(origin, docId, selectParentCategories = false) {
-      navigator.select(origin, docId, selectParentCategories);
+      navigator2.select(origin, docId, selectParentCategories);
     },
     async deselect(origin, docId) {
-      navigator.deselect(origin, docId);
+      navigator2.deselect(origin, docId);
     },
     async selectAllEntries() {
-      navigator.selectAllEntries();
+      navigator2.selectAllEntries();
     },
     async deselectAllEntries() {
-      navigator.deselectAllEntries();
+      navigator2.deselectAllEntries();
     },
     async isSelected(origin, docId) {
-      return navigator.isSelected(origin, docId);
+      return navigator2.isSelected(origin, docId);
     },
     async getSelectionState() {
       return {
-        selectAllByDefault: navigator.isSelectAllByDefault(),
-        entryKeys: Array.from(navigator.getSelectedOrDeselectedEntries())
+        selectAllByDefault: navigator2.isSelectAllByDefault(),
+        entryKeys: Array.from(navigator2.getSelectedOrDeselectedEntries())
       };
     },
     async setSelectionState(state) {
-      if (state.selectAllByDefault) navigator.selectAllEntries();
-      else navigator.deselectAllEntries();
-      navigator.setSelectedOrDeselectedEntries(new Set(state.entryKeys));
+      if (state.selectAllByDefault) navigator2.selectAllEntries();
+      else navigator2.deselectAllEntries();
+      navigator2.setSelectedOrDeselectedEntries(new Set(state.entryKeys));
     },
     async expand(origin, docId) {
-      navigator.expand(origin, docId);
+      navigator2.expand(origin, docId);
     },
     async collapse(origin, docId) {
-      navigator.collapse(origin, docId);
+      navigator2.collapse(origin, docId);
     },
     async expandAll() {
-      navigator.expandAll();
+      navigator2.expandAll();
     },
     async collapseAll() {
-      navigator.collapseAll();
+      navigator2.collapseAll();
     },
     async expandToLevel(level) {
-      navigator.expandToLevel(level);
+      navigator2.expandToLevel(level);
     },
     async isExpanded(entryKey) {
-      const entry = navigator.getPos(entryKey);
-      return entry ? navigator.isExpanded(entry) : false;
+      const entry = navigator2.getPos(entryKey);
+      return entry ? navigator2.isExpanded(entry) : false;
     },
     async getExpansionState() {
       return {
-        expandAllByDefault: navigator.isExpandAllByDefault(),
-        expandLevel: navigator.getExpandLevel(),
-        entryKeys: Array.from(navigator.getExpandedOrCollapsedEntries())
+        expandAllByDefault: navigator2.isExpandAllByDefault(),
+        expandLevel: navigator2.getExpandLevel(),
+        entryKeys: Array.from(navigator2.getExpandedOrCollapsedEntries())
       };
     },
     async setExpansionState(state) {
-      if (state.expandAllByDefault) navigator.expandAll();
-      else navigator.collapseAll();
-      navigator.expandToLevel(state.expandLevel);
-      navigator.setExpandedOrCollapsedEntries(new Set(state.entryKeys));
+      if (state.expandAllByDefault) navigator2.expandAll();
+      else navigator2.collapseAll();
+      navigator2.expandToLevel(state.expandLevel);
+      navigator2.setExpandedOrCollapsedEntries(new Set(state.entryKeys));
     },
     async childEntries(entryKey, descending) {
-      return navigator.childEntries(resolveEntry(navigator, entryKey), descending).map((entry) => serializeEntry(navigator, entry));
+      return navigator2.childEntries(resolveEntry(navigator2, entryKey), descending).map((entry) => serializeEntry(navigator2, entry));
     },
     async childCategories(entryKey, descending) {
-      return navigator.childCategories(resolveEntry(navigator, entryKey), descending).map((entry) => serializeEntry(navigator, entry));
+      return navigator2.childCategories(resolveEntry(navigator2, entryKey), descending).map((entry) => serializeEntry(navigator2, entry));
     },
     async childDocuments(entryKey, descending) {
-      return navigator.childDocuments(resolveEntry(navigator, entryKey), descending).map((entry) => serializeEntry(navigator, entry));
+      return navigator2.childDocuments(resolveEntry(navigator2, entryKey), descending).map((entry) => serializeEntry(navigator2, entry));
     },
     async childCategoriesByKey(entryKey, key, exact, descending) {
-      return navigator.childCategoriesByKey(
-        resolveEntry(navigator, entryKey),
+      return navigator2.childCategoriesByKey(
+        resolveEntry(navigator2, entryKey),
         String(key ?? ""),
         Boolean(exact),
         descending
-      ).map((entry) => serializeEntry(navigator, entry));
+      ).map((entry) => serializeEntry(navigator2, entry));
     },
     async childDocumentsByKey(entryKey, key, exact, descending) {
-      return navigator.childDocumentsByKey(
-        resolveEntry(navigator, entryKey),
+      return navigator2.childDocumentsByKey(
+        resolveEntry(navigator2, entryKey),
         String(key ?? ""),
         Boolean(exact),
         descending
-      ).map((entry) => serializeEntry(navigator, entry));
+      ).map((entry) => serializeEntry(navigator2, entry));
     },
     async childCategoriesBetween(entryKey, range) {
-      return navigator.childCategoriesBetween(
-        resolveEntry(navigator, entryKey),
+      return navigator2.childCategoriesBetween(
+        resolveEntry(navigator2, entryKey),
         range.startKey,
         range.endKey,
         range.descending
-      ).map((entry) => serializeEntry(navigator, entry));
+      ).map((entry) => serializeEntry(navigator2, entry));
     },
     async childDocumentsBetween(entryKey, range) {
-      return navigator.childDocumentsBetween(
-        resolveEntry(navigator, entryKey),
+      return navigator2.childDocumentsBetween(
+        resolveEntry(navigator2, entryKey),
         range.startKey,
         range.endKey,
         range.descending
-      ).map((entry) => serializeEntry(navigator, entry));
+      ).map((entry) => serializeEntry(navigator2, entry));
     },
     async getSortedDocIds(descending) {
-      const page = pageEntries(navigator, descending ? "backward" : "forward", { limit: 1e3 });
+      const page = pageEntries(navigator2, descending ? "backward" : "forward", { limit: 1e3 });
       return collectSortedDocIds(page.entries);
     },
     async getSortedDocIdsScoped(entryKey, descending) {
-      const docs = navigator.childDocuments(resolveEntry(navigator, entryKey), descending);
+      const docs = navigator2.childDocuments(resolveEntry(navigator2, entryKey), descending);
       return docs.map((entry) => ({ origin: entry.origin, docId: entry.docId }));
     },
     async dispose() {
@@ -453,8 +453,8 @@ async function createEvaluatingViewNavigator(input, documents) {
     documents,
     input.categorizationStyle
   );
-  const navigator = createCoreNavigator(mindoodb, view, input.options);
-  return wrapNavigator(input.definition, navigator);
+  const navigator2 = createCoreNavigator(mindoodb, view, input.options);
+  return wrapNavigator(input.definition, navigator2);
 }
 
 // src/testing/mockEmbeds.ts
@@ -828,6 +828,246 @@ function guardDatabase(database, currentInfo, enforce) {
   };
 }
 
+// src/testing/mockAgentTools.ts
+var TOOL_NAME_PATTERN = /^[a-z][a-z0-9_]{0,47}$/;
+var PREFIX_PATTERN = /^[a-z][a-z0-9_]{0,15}$/;
+var MOCK_AGENT_MAX_TOOLS = 64;
+var MOCK_AGENT_MAX_DESCRIPTION = 2e3;
+var MOCK_AGENT_FILE_TTL_MS = 10 * 60 * 1e3;
+var MOCK_AGENT_FILE_MAX_BYTES = 50 * 1024 * 1024;
+var DEFAULT_INVOKE_TIMEOUT_MS = 12e4;
+function invalid(message) {
+  return Object.assign(new Error(message), { name: "invalid-params" });
+}
+function notFound(message) {
+  return Object.assign(new Error(message), { name: "not-found" });
+}
+function mockAgentToolPrefix(appId, declared) {
+  if (declared && PREFIX_PATTERN.test(declared) && !declared.endsWith("_") && !/^haven(?:_|$)/.test(declared)) {
+    return declared;
+  }
+  const key = (appId.split("\\").pop() ?? "").trim().toLowerCase().replace(/^mindoodb-app-/, "").replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 16).replace(/_+$/, "");
+  if (!key) return "app";
+  return /^[a-z]/.test(key) ? key : `app_${key}`.slice(0, 16);
+}
+function validateMockAgentTools(raw) {
+  if (!Array.isArray(raw)) throw invalid("tools must be an array.");
+  if (raw.length > MOCK_AGENT_MAX_TOOLS) throw invalid(`An app may offer at most ${MOCK_AGENT_MAX_TOOLS} agent tools.`);
+  const seen = /* @__PURE__ */ new Set();
+  return raw.map((entry) => {
+    const tool = entry;
+    if (!tool || typeof tool.name !== "string" || !TOOL_NAME_PATTERN.test(tool.name)) {
+      throw invalid(`Invalid agent tool name "${String(tool?.name)}".`);
+    }
+    if (seen.has(tool.name)) throw invalid(`Agent tool "${tool.name}" is declared twice.`);
+    seen.add(tool.name);
+    if (typeof tool.description !== "string" || !tool.description.trim()) {
+      throw invalid(`Agent tool "${tool.name}" needs a description.`);
+    }
+    if (tool.description.length > MOCK_AGENT_MAX_DESCRIPTION) {
+      throw invalid(`The description of agent tool "${tool.name}" is too long.`);
+    }
+    const schema = tool.inputSchema;
+    if (!schema || typeof schema !== "object" || Array.isArray(schema) || schema.type !== "object") {
+      throw invalid(`Agent tool "${tool.name}" needs an object inputSchema.`);
+    }
+    const annotations = tool.annotations ?? {};
+    for (const key of ["readOnlyHint", "consequentialHint", "untrustedContentHint"]) {
+      if (annotations[key] !== void 0 && typeof annotations[key] !== "boolean") {
+        throw invalid(`Agent tool "${tool.name}" has invalid annotations.`);
+      }
+    }
+    return {
+      name: tool.name,
+      description: tool.description,
+      inputSchema: schema,
+      ...tool.annotations ? { annotations: { ...tool.annotations } } : {}
+    };
+  });
+}
+async function bytesOf(data) {
+  if (typeof data === "string") return new TextEncoder().encode(data);
+  if (data instanceof Uint8Array) return data.slice();
+  if (typeof Blob !== "undefined" && data instanceof Blob) return new Uint8Array(await data.arrayBuffer());
+  return new Uint8Array(data);
+}
+function structuralBytes(data) {
+  if (ArrayBuffer.isView(data)) return new Uint8Array(data.buffer, data.byteOffset, data.byteLength).slice();
+  if (Object.prototype.toString.call(data) === "[object ArrayBuffer]") return new Uint8Array(data).slice();
+  return null;
+}
+function createMockAgentHost(options) {
+  const prefix = mockAgentToolPrefix(options.appId(), options.agentToolPrefix);
+  let tools = [];
+  let context = null;
+  let enabled = options.agentToolsEnabled ?? true;
+  let consent = options.agentConsent ?? "allow";
+  const timeoutMs = options.agentInvokeTimeoutMs ?? DEFAULT_INVOKE_TIMEOUT_MS;
+  const files = /* @__PURE__ */ new Map();
+  const calls = [];
+  const pending = /* @__PURE__ */ new Map();
+  let counter = 0;
+  const changed = () => options.onChange?.();
+  function prune(now = Date.now()) {
+    for (const [ref, file] of files) if (file.expiresAt <= now) files.delete(ref);
+  }
+  function addFile(file) {
+    prune();
+    if (file.data.length > MOCK_AGENT_FILE_MAX_BYTES) {
+      throw invalid(`Files for agents may be at most ${MOCK_AGENT_FILE_MAX_BYTES / 1024 / 1024} MB.`);
+    }
+    const now = Date.now();
+    counter += 1;
+    const entry = {
+      ...file,
+      fileRef: `file_test${counter.toString(16).padStart(4, "0")}`,
+      createdAt: now,
+      expiresAt: now + MOCK_AGENT_FILE_TTL_MS
+    };
+    files.set(entry.fileRef, entry);
+    changed();
+    return entry;
+  }
+  function registration() {
+    return { enabled, exposedNames: tools.map((tool) => `${prefix}_${tool.name}`) };
+  }
+  async function dispatch(method, params) {
+    const input = params ?? {};
+    if (method === "agent.registerTools") {
+      tools = validateMockAgentTools(input.tools);
+      changed();
+      return { result: registration() };
+    }
+    if (method === "agent.setContext") {
+      const next = input.context ?? null;
+      if (next !== null && (typeof next !== "object" || Array.isArray(next))) {
+        throw invalid("context must be an object or null.");
+      }
+      context = next;
+      changed();
+      return { result: null };
+    }
+    if (method === "agent.provideFile") {
+      if (typeof input.name !== "string" || !input.name.trim()) throw invalid("provideFile needs a file name.");
+      const data = structuralBytes(input.data);
+      if (!data) throw invalid("provideFile needs the file content as an ArrayBuffer.");
+      const mimeType = typeof input.mimeType === "string" && input.mimeType ? input.mimeType : "application/octet-stream";
+      const file = addFile({ name: input.name.trim(), mimeType, data, source: "app" });
+      return { result: { fileRef: file.fileRef, size: file.data.length } };
+    }
+    if (method === "agent.takeFile") {
+      prune();
+      const file = typeof input.fileRef === "string" ? files.get(input.fileRef) : void 0;
+      if (!file || file.source !== "host") throw notFound("Unknown or expired file reference.");
+      return { result: { name: file.name, mimeType: file.mimeType, data: file.data.slice().buffer } };
+    }
+    return void 0;
+  }
+  function finish(callId, outcome) {
+    const call2 = calls.find((entry) => entry.callId === callId);
+    if (call2) call2.outcome = outcome;
+    changed();
+    return outcome;
+  }
+  async function call(name, input = {}) {
+    counter += 1;
+    const callId = `test-call-${counter}`;
+    const startedAt = Date.now();
+    const toolName = name.startsWith(`${prefix}_`) && !tools.some((t) => t.name === name) ? name.slice(prefix.length + 1) : name;
+    calls.push({ callId, tool: toolName, input, startedAt });
+    changed();
+    const failWith = (code, message, requiredAction) => finish(callId, {
+      ok: false,
+      error: { code, message, ...requiredAction ? { requiredAction } : {} },
+      durationMs: Date.now() - startedAt
+    });
+    if (!enabled) return failWith("NOT_ALLOWED", "The user has agent tools switched off for this app.");
+    const tool = tools.find((entry) => entry.name === toolName);
+    if (!tool) return failWith("NOT_FOUND", `The app offers no tool "${name}".`);
+    if (tool.annotations?.consequentialHint) {
+      const allowed = typeof consent === "function" ? await consent({ tool: toolName, input }) : consent === "allow";
+      if (!allowed) return failWith("NOT_ALLOWED", "The user declined this call.", "ask the user before trying again");
+    }
+    return await new Promise((resolve) => {
+      const timer = setTimeout(() => {
+        pending.delete(callId);
+        resolve(failWith("FAILED", `The app did not answer "${toolName}" in time.`));
+      }, timeoutMs);
+      pending.set(callId, { resolve, startedAt, timer });
+      const posted = options.post({ protocol: "mindoodb-app-bridge", kind: "agent-invoke", callId, tool: toolName, input });
+      if (!posted) {
+        clearTimeout(timer);
+        pending.delete(callId);
+        resolve(failWith("INVALID_STATE", "The app is not connected."));
+      }
+    });
+  }
+  function handleResult(message) {
+    const entry = pending.get(message.callId);
+    if (!entry) return;
+    pending.delete(message.callId);
+    clearTimeout(entry.timer);
+    const durationMs = Date.now() - entry.startedAt;
+    entry.resolve(
+      finish(
+        message.callId,
+        message.ok ? { ok: true, result: message.result ?? null, durationMs } : {
+          ok: false,
+          error: {
+            code: message.error?.code ?? "FAILED",
+            message: message.error?.message ?? "The app reported an error.",
+            ...message.error?.requiredAction ? { requiredAction: message.error.requiredAction } : {}
+          },
+          durationMs
+        }
+      )
+    );
+  }
+  function reset(reason = "The app was closed.") {
+    for (const [callId, entry] of pending) {
+      clearTimeout(entry.timer);
+      entry.resolve(
+        finish(callId, { ok: false, error: { code: "INVALID_STATE", message: reason }, durationMs: Date.now() - entry.startedAt })
+      );
+    }
+    pending.clear();
+    tools = [];
+    context = null;
+    changed();
+  }
+  const controller = {
+    prefix,
+    tools: () => tools.map((tool) => ({ ...tool })),
+    exposedNames: () => registration().exposedNames,
+    context: () => context,
+    isEnabled: () => enabled,
+    setEnabled(next) {
+      enabled = next;
+      changed();
+    },
+    setConsent(next) {
+      consent = next;
+    },
+    call,
+    calls: () => calls,
+    async importFile(file) {
+      const data = await bytesOf(file.data);
+      const mimeType = file.mimeType || (typeof Blob !== "undefined" && file.data instanceof Blob ? file.data.type : "") || "application/octet-stream";
+      return addFile({ name: file.name, mimeType, data, source: "host" }).fileRef;
+    },
+    getFile(fileRef) {
+      prune();
+      const file = files.get(fileRef);
+      return file && file.source === "app" ? file : null;
+    },
+    files() {
+      prune();
+      return [...files.values()].sort((a, b) => b.createdAt - a.createdAt);
+    }
+  };
+  return { controller, dispatch, handleResult, reset };
+}
+
 // src/testing/memoryAttachments.ts
 function concat(chunks) {
   const bytes = new Uint8Array(chunks.reduce((total, chunk) => total + chunk.length, 0));
@@ -1020,6 +1260,10 @@ function createBrowserTestHost(options) {
   const changed = () => queueMicrotask(() => onChange?.());
   const host = createFakeBridgeHost({
     ...hostOptions,
+    onAgentChange() {
+      hostOptions.onAgentChange?.();
+      changed();
+    },
     onRequest(request) {
       log.requests.push(request);
       const params = request.params ?? {};
@@ -1110,6 +1354,7 @@ function createBrowserTestHost(options) {
   return {
     host,
     log,
+    agent: host.agent,
     setNextScan(scan) {
       nextScan = scan;
     },
@@ -1200,6 +1445,10 @@ var STYLE = `
 .htest__meta{margin-left:auto;color:#5b6478;font-size:11px;white-space:nowrap}
 .htest__error{color:#b42318}
 .htest pre{margin:4px 0 2px;padding:6px 8px;background:#fff;border:1px solid #e4e8f1;border-radius:6px;font:11px/1.4 ui-monospace,monospace;white-space:pre-wrap;word-break:break-all;max-height:260px;overflow:auto}
+.htest textarea{width:100%;min-height:70px;font:11px/1.4 ui-monospace,monospace;border:1px solid #c9d0e0;border-radius:6px;padding:6px}
+.htest__tag{display:inline-block;padding:0 6px;border-radius:999px;background:#e4e8f1;color:#334155;font-size:10px;margin-left:4px}
+.htest__tag--warn{background:#fee4e2;color:#912018}
+.htest__shot{max-width:100%;border:1px solid #e4e8f1;border-radius:6px;margin-top:4px;background:#fff}
 @media (max-width:720px){.htest{grid-template-columns:1fr;grid-template-rows:65vh auto}.htest__panel{border-left:0;border-top:1px solid #d7dce8}}
 `;
 function previewJson(value, maxString = 400, maxItems = 30, maxDepth = 6) {
@@ -1430,14 +1679,24 @@ function mountHavenTestHost(options) {
     lists.scans.replaceChildren(...log.scans.map(scanEntry));
     lists.requests.replaceChildren(...log.requests.slice(-50).reverse().map(requestEntry));
   }
+  let agentReady = false;
   const testHost = createBrowserTestHost({
+    // Haven's consent dialog, as a browser confirm (scripts can switch it with agent.setConsent)
+    agentConsent: ({ tool, input }) => window.confirm(`An agent wants to run "${tool}" (marked consequential).
+
+${previewJson(input, 200, 10, 3)}
+
+Allow?`),
     ...hostOptions,
     databases,
     launchContext,
     enforceCapabilities: url.enforceCapabilities ?? hostOptions.enforceCapabilities,
     directoryUsers: url.directoryUserCount !== void 0 ? generateDirectoryUsers(url.directoryUserCount) : hostOptions.directoryUsers,
     frame,
-    onChange: render,
+    onChange: () => {
+      render();
+      if (agentReady) renderAgent();
+    },
     onEmbedChange(embeds) {
       hostOptions.onEmbedChange?.(embeds);
       renderEmbeds(embeds);
@@ -1574,11 +1833,213 @@ function mountHavenTestHost(options) {
     scanInput,
     hint("What attachments.scan() returns; the file is attached to the document like in Haven.")
   );
+  const agentState = document.createElement("div");
+  agentState.className = "htest__muted";
+  const agentEnabled = document.createElement("label");
+  agentEnabled.className = "htest__check";
+  const agentEnabledBox = document.createElement("input");
+  agentEnabledBox.type = "checkbox";
+  agentEnabledBox.dataset.testid = "haven-test-agent-enabled";
+  agentEnabledBox.checked = testHost.agent.isEnabled();
+  agentEnabledBox.addEventListener("change", () => testHost.agent.setEnabled(agentEnabledBox.checked));
+  agentEnabled.append(agentEnabledBox, "Agent access on (registerTools answers enabled)");
+  const agentTools = document.createElement("ul");
+  const toolSelect = document.createElement("select");
+  toolSelect.dataset.testid = "haven-test-agent-tool";
+  toolSelect.setAttribute("aria-label", "Agent tool");
+  const toolInput = document.createElement("textarea");
+  toolInput.dataset.testid = "haven-test-agent-input";
+  toolInput.setAttribute("aria-label", "Tool input (JSON)");
+  toolInput.value = "{}";
+  const toolResult = document.createElement("div");
+  toolResult.dataset.testid = "haven-test-agent-result";
+  const callButton = button("Call tool", () => void runTool());
+  callButton.dataset.testid = "haven-test-agent-call";
+  const agentContext = document.createElement("pre");
+  agentContext.dataset.testid = "haven-test-agent-context";
+  const agentFiles = document.createElement("ul");
+  const agentCalls = document.createElement("ul");
+  const importInput = document.createElement("input");
+  importInput.type = "file";
+  importInput.multiple = true;
+  importInput.dataset.testid = "haven-test-agent-import";
+  importInput.setAttribute("aria-label", "Import files for the app");
+  importInput.addEventListener("change", () => {
+    void (async () => {
+      for (const file of importInput.files ?? []) {
+        await testHost.agent.importFile({ name: file.name, mimeType: file.type, data: file });
+      }
+      importInput.value = "";
+    })();
+  });
+  function showOutcome(target, call) {
+    const pre = document.createElement("pre");
+    const outcome = call.outcome;
+    if (!outcome) {
+      pre.textContent = "running\u2026";
+      target.replaceChildren(pre);
+      return;
+    }
+    if (outcome.ok) {
+      pre.textContent = previewJson(outcome.result, 2e3, 60, 8);
+    } else {
+      pre.className = "htest__error";
+      pre.textContent = `${outcome.error.code}: ${outcome.error.message}${outcome.error.requiredAction ? `
+\u2192 ${outcome.error.requiredAction}` : ""}`;
+    }
+    const images = [];
+    const collect = (value, depth) => {
+      if (depth > 4 || images.length >= 4) return;
+      if (typeof value === "string" && /^data:image\/(png|jpeg|gif|webp|svg\+xml);base64,/.test(value)) images.push(value);
+      else if (value && typeof value === "object") for (const child of Object.values(value)) collect(child, depth + 1);
+    };
+    if (outcome.ok) collect(outcome.result, 0);
+    target.replaceChildren(
+      pre,
+      ...images.map((src) => {
+        const img = document.createElement("img");
+        img.className = "htest__shot";
+        img.src = src;
+        img.alt = "image in the tool result";
+        return img;
+      })
+    );
+  }
+  async function runTool() {
+    let input;
+    try {
+      const parsed = JSON.parse(toolInput.value || "{}");
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("The input must be a JSON object.");
+      input = parsed;
+    } catch (error) {
+      const pre = document.createElement("pre");
+      pre.className = "htest__error";
+      pre.textContent = error instanceof Error ? error.message : String(error);
+      toolResult.replaceChildren(pre);
+      return;
+    }
+    callButton.disabled = true;
+    try {
+      await testHost.agent.call(toolSelect.value, input);
+      const last = testHost.agent.calls().at(-1);
+      if (last) showOutcome(toolResult, last);
+    } finally {
+      callButton.disabled = false;
+    }
+  }
+  function download(name, mimeType, data) {
+    const link = document.createElement("a");
+    link.textContent = name;
+    link.download = name;
+    link.href = URL.createObjectURL(new Blob([data.slice().buffer], { type: mimeType }));
+    return link;
+  }
+  const openCalls = /* @__PURE__ */ new Set();
+  function renderAgent() {
+    const agent = testHost.agent;
+    const tools = agent.tools();
+    agentState.textContent = `prefix "${agent.prefix}" \xB7 ${tools.length} tool(s) \xB7 ${agent.isEnabled() ? "access on" : "access off"}`;
+    agentEnabledBox.checked = agent.isEnabled();
+    agentTools.replaceChildren(
+      ...tools.map((tool) => {
+        const li = document.createElement("li");
+        const details = document.createElement("details");
+        const summary = document.createElement("summary");
+        const name = document.createElement("span");
+        name.textContent = `${agent.prefix}_${tool.name}`;
+        summary.append(name);
+        const hints = tool.annotations ?? {};
+        if (hints.readOnlyHint) summary.append(Object.assign(document.createElement("span"), { className: "htest__tag", textContent: "read-only" }));
+        if (hints.consequentialHint) summary.append(Object.assign(document.createElement("span"), { className: "htest__tag htest__tag--warn", textContent: "asks first" }));
+        const description = document.createElement("p");
+        description.textContent = tool.description;
+        const schema = document.createElement("pre");
+        schema.textContent = previewJson(tool.inputSchema, 400, 60, 10);
+        details.append(summary, description, schema);
+        li.append(details);
+        return li;
+      })
+    );
+    const selected = toolSelect.value;
+    toolSelect.replaceChildren(...tools.map((tool) => new Option(`${agent.prefix}_${tool.name}`, tool.name)));
+    if (tools.some((tool) => tool.name === selected)) toolSelect.value = selected;
+    callButton.disabled = tools.length === 0;
+    agentContext.textContent = previewJson(agent.context(), 400, 30, 6);
+    agentFiles.replaceChildren(
+      ...agent.files().map((file) => {
+        const li = document.createElement("li");
+        const ref = document.createElement("code");
+        ref.textContent = file.fileRef;
+        const copy = button("copy ref", () => void navigator.clipboard?.writeText(file.fileRef));
+        li.append(
+          file.source === "app" ? "from app: " : "for app: ",
+          file.source === "app" ? download(file.name, file.mimeType, file.data) : file.name,
+          ` (${file.data.length} bytes) `,
+          ref,
+          " ",
+          copy
+        );
+        return li;
+      })
+    );
+    agentCalls.replaceChildren(
+      ...agent.calls().slice(-20).reverse().map((call) => {
+        const li = document.createElement("li");
+        const details = document.createElement("details");
+        const summary = document.createElement("summary");
+        const label = document.createElement("span");
+        label.textContent = call.tool;
+        if (call.outcome && !call.outcome.ok) label.className = "htest__error";
+        const meta = document.createElement("span");
+        meta.className = "htest__meta";
+        meta.textContent = call.outcome ? `${call.outcome.durationMs} ms` : "\u2026";
+        summary.append(label, meta);
+        const body = document.createElement("div");
+        const input = document.createElement("pre");
+        input.textContent = previewJson(call.input);
+        details.append(summary, body);
+        details.addEventListener("toggle", () => {
+          if (details.open) {
+            openCalls.add(call.callId);
+            const out = document.createElement("div");
+            showOutcome(out, call);
+            body.replaceChildren(input, out);
+          } else openCalls.delete(call.callId);
+        });
+        if (openCalls.has(call.callId)) details.open = true;
+        li.append(details);
+        return li;
+      })
+    );
+  }
+  const callRow = document.createElement("div");
+  callRow.className = "htest__row";
+  callRow.append(toolSelect, callButton);
+  section(
+    "Agent tools",
+    agentState,
+    agentEnabled,
+    agentTools,
+    callRow,
+    toolInput,
+    toolResult,
+    hint("Calls a tool as an agent would; tools marked \u201Casks first\u201D go through a confirm, like Haven's consent dialog.")
+  );
+  section(
+    "Agent files",
+    importInput,
+    hint("Import puts a file in the exchange for the app (takeFile); pass its fileRef to a tool. Files the app hands over (provideFile) can be downloaded."),
+    agentFiles
+  );
+  section("Agent context", agentContext);
+  section("Agent calls (latest first)", agentCalls);
   section("Notifications", lists.notifications);
   section("Previews", lists.previews);
   section("Scans", lists.scans);
   section("Requests (latest first, click for details)", lists.requests);
   render();
+  agentReady = true;
+  renderAgent();
   syncUrl();
   window.__havenTestHost = testHost;
   return testHost;
@@ -2373,9 +2834,9 @@ function createLiveMockViewNavigator(initial, rebuild, subscribe) {
           listeners.clear();
           if (pendingNotify) clearTimeout(pendingNotify);
         }
-        const navigator = await current();
-        const member = navigator[property];
-        return typeof member === "function" ? member.apply(navigator, args) : member;
+        const navigator2 = await current();
+        const member = navigator2[property];
+        return typeof member === "function" ? member.apply(navigator2, args) : member;
       };
     }
   });
@@ -4158,6 +4619,20 @@ function createFakeBridgeHost(options = {}) {
   );
   const requests = [];
   const connectedPorts = /* @__PURE__ */ new Set();
+  const agentHost = createMockAgentHost({
+    ...options.agentToolPrefix !== void 0 ? { agentToolPrefix: options.agentToolPrefix } : {},
+    ...options.agentToolsEnabled !== void 0 ? { agentToolsEnabled: options.agentToolsEnabled } : {},
+    ...options.agentConsent !== void 0 ? { agentConsent: options.agentConsent } : {},
+    ...options.agentInvokeTimeoutMs !== void 0 ? { agentInvokeTimeoutMs: options.agentInvokeTimeoutMs } : {},
+    appId: () => state.getLaunchContext().appId,
+    post(message) {
+      const port = [...connectedPorts].pop();
+      if (!port) return false;
+      port.postMessage(message);
+      return true;
+    },
+    onChange: () => options.onAgentChange?.()
+  });
   state.embedHost.onClosed((event) => {
     connectedPorts.forEach(
       (port) => port.postMessage({ protocol: PROTOCOL, kind: "embed-event", event: { type: "closed", ...event } })
@@ -4199,6 +4674,7 @@ function createFakeBridgeHost(options = {}) {
         "Expected the bridge connection to transfer a MessagePort."
       );
     }
+    if (connectedPorts.size > 0) agentHost.reset("The app was reloaded.");
     connectedPorts.add(port);
     port.addEventListener("message", (event) => {
       void handlePortMessage(port, event.data);
@@ -4289,9 +4765,9 @@ function createFakeBridgeHost(options = {}) {
     if (existing) {
       return existing;
     }
-    const navigator = await state.openViewNavigator(viewId);
-    viewSessions.set(viewId, navigator);
-    return navigator;
+    const navigator2 = await state.openViewNavigator(viewId);
+    viewSessions.set(viewId, navigator2);
+    return navigator2;
   }
   function postRpcSuccess(port, requestId, result) {
     port.postMessage({
@@ -4340,14 +4816,14 @@ function createFakeBridgeHost(options = {}) {
         return { ok: true };
       case "session.createViewNavigator": {
         const navigatorId = `navigator-${viewCounter += 1}`;
-        const navigator = await state.createViewNavigator({
+        const navigator2 = await state.createViewNavigator({
           databaseIds: Array.isArray(params.databaseIds) ? params.databaseIds.map((entry) => String(entry)) : [],
           definition: params.definition,
           categorizationStyle: params.categorizationStyle === "category_then_document" ? "category_then_document" : "document_then_category",
           options: params.options
         });
-        viewSessions.set(navigatorId, navigator);
-        navigator.onDidUpdate((stats) => {
+        viewSessions.set(navigatorId, navigator2);
+        navigator2.onDidUpdate((stats) => {
           if (!viewSessions.has(navigatorId)) return;
           const payload = {
             protocol: PROTOCOL,
@@ -4361,11 +4837,11 @@ function createFakeBridgeHost(options = {}) {
       }
       case "session.openViewNavigator": {
         const navigatorId = `navigator-${viewCounter += 1}`;
-        const navigator = await state.openViewNavigator(
+        const navigator2 = await state.openViewNavigator(
           String(params.viewId),
           params.options
         );
-        viewSessions.set(navigatorId, navigator);
+        viewSessions.set(navigatorId, navigator2);
         return { navigatorId };
       }
       case "menus.show":
@@ -4858,8 +5334,8 @@ function createFakeBridgeHost(options = {}) {
         );
       case "viewNavigators.dispose": {
         const key = String(params.navigatorId);
-        const navigator = await resolveViewNavigator(key);
-        await navigator.dispose();
+        const navigator2 = await resolveViewNavigator(key);
+        await navigator2.dispose();
         viewSessions.delete(key);
         return void 0;
       }
@@ -4944,6 +5420,10 @@ function createFakeBridgeHost(options = {}) {
       beforeCloseWaiters.get(message.closeId)?.();
       return;
     }
+    if (message.kind === "agent-result") {
+      agentHost.handleResult(message);
+      return;
+    }
     if (message.kind === "workspace-focus-requested") {
       state.setHostFocused(true);
       const payload = {
@@ -4985,6 +5465,11 @@ function createFakeBridgeHost(options = {}) {
           succeed(result);
           return;
         }
+        const agentResult = await agentHost.dispatch(message.method, message.params);
+        if (agentResult) {
+          succeed(agentResult.result);
+          return;
+        }
         const builtinResult = await handleBuiltinRequest(message);
         if (builtinResult === NOT_HANDLED) {
           fail({
@@ -5026,6 +5511,7 @@ function createFakeBridgeHost(options = {}) {
   const controller = {
     bridge: state.bridge,
     session: state.session,
+    agent: agentHost.controller,
     get launchId() {
       return state.getLaunchContext().launchId;
     },
@@ -5183,12 +5669,15 @@ export {
   createEvaluatingViewNavigator,
   createFakeBridgeHost,
   createMemoryAttachments,
+  createMockAgentHost,
   createMockMindooDBAppBridge,
   createMockMindooDBAppSession,
   generateDirectoryUsers,
   loadMindoodbForTesting,
+  mockAgentToolPrefix,
   mockDatabasesFromDefinition,
   mountHavenTestHost,
   previewJson,
-  readTestHostUrlSettings
+  readTestHostUrlSettings,
+  validateMockAgentTools
 };

package/dist/{types-ClOh6z0L.d.ts → types-BeRUxGKN.d.ts}

@@ -1671,7 +1671,11 @@ interface MindooDBAppEmbed {
      * `container`, whose rectangle the SDK follows itself.
      */
     setRect(rect: MindooDBAppEmbedRect): Promise<void>;
-    /** Hide without closing, e.g. while a dialog of the host covers it. */
+    /**
+     * Hide without closing, e.g. while a dialog of the host covers it, or (also with
+     * `frame` placement) while it sits in a background tab: a hidden component gets
+     * no drops of host-owned drags.
+     */
     setVisible(visible: boolean): Promise<void>;
     /**
      * Whether the component has changes it has not saved yet, as it last reported

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindoodb-app-sdk",
-  "version": "0.0.62",
+  "version": "0.0.64",
   "engines": {
     "node": ">=22.13.0"
   },