mindoodb-app-sdk 0.0.53 → 0.0.55

package/dist/{types-CsKw_niD.d.ts → types-Dl70Tlfj.d.ts}

@@ -118,6 +118,13 @@ interface MindooDBAppDefinitionListing {
     summary?: MindooDBAppLocalizedText;
     /** Longer plain text. Blank lines separate paragraphs; no markup is rendered. */
     description?: MindooDBAppLocalizedText;
+    /**
+     * The same description with formatting: the Markdown subset of `listingMarkdown.ts`
+     * (paragraphs, headings, lists, bold/italic, code, `https:`/`mailto:` links).
+     * Readers that know this field show it instead of `description`; older ones ignore it
+     * and keep showing `description`, so set both when older Haven versions matter.
+     */
+    descriptionMarkdown?: MindooDBAppLocalizedText;
     /** Square icon, path relative to the app origin or an absolute `https:` URL. */
     icon?: string;
     screenshots?: MindooDBAppDefinitionScreenshot[];
@@ -1234,8 +1241,117 @@ interface MindooDBAppNotifyInput {
 interface MindooDBAppNotifyResult {
     id: string;
 }
+/**
+ * Why an agent tool call failed, in terms an AI agent can act on. Haven passes
+ * the code through to the agent unchanged.
+ *
+ * - `NOT_FOUND`: an id the agent passed does not exist (any more).
+ * - `INVALID_INPUT`: the input does not match the schema or allowed values.
+ * - `INVALID_STATE`: the call is valid but cannot run in the app's current state.
+ * - `STATE_CHANGED`: what the agent planned on changed in between.
+ * - `NOT_ALLOWED`: the user or a policy does not permit it.
+ * - `FAILED`: anything else.
+ *
+ * `LOCKED` is Haven's own and never comes from an app.
+ */
+type MindooDBAppAgentToolErrorCode = "NOT_FOUND" | "INVALID_INPUT" | "INVALID_STATE" | "STATE_CHANGED" | "NOT_ALLOWED" | "FAILED";
+/** Hints an agent uses to decide how carefully to treat a tool (WebMCP `ToolAnnotations`). */
+interface MindooDBAppAgentToolAnnotations {
+    /** The tool only reads. */
+    readOnlyHint?: boolean;
+    /** The tool changes something the user would want to confirm; Haven asks first. */
+    consequentialHint?: boolean;
+    /** The result carries text other people wrote (names, notes, document content). */
+    untrustedContentHint?: boolean;
+}
+/** What an app tells Haven about one agent tool; everything but the implementation. */
+interface MindooDBAppAgentToolDescriptor {
+    /**
+     * Name within the app: lower case, digits, underscore, starting with a letter.
+     * Haven exposes it to agents prefixed with the app's key (`vega_maps_list`).
+     */
+    name: string;
+    /** Written for an AI agent: what the tool does, when to use it, where ids come from. */
+    description: string;
+    /** JSON Schema of the input object. */
+    inputSchema: Record<string, unknown>;
+    annotations?: MindooDBAppAgentToolAnnotations;
+}
+/** One agent tool an app offers. `execute` runs inside the app; its result must be JSON. */
+interface MindooDBAppAgentTool extends MindooDBAppAgentToolDescriptor {
+    execute(input: Record<string, unknown>): Promise<unknown>;
+}
+/** Haven's answer to {@link MindooDBAppAgentApi.registerTools}. */
+interface MindooDBAppAgentRegistration {
+    /**
+     * Whether agents can call the tools right now. `false` while the user has agent
+     * access off, globally or for this app; Haven keeps the tools and offers them
+     * as soon as access is switched on.
+     */
+    enabled: boolean;
+    /** The names agents see, prefix included. */
+    exposedNames: string[];
+}
+/**
+ * Lets an app offer operations to AI agents through Haven.
+ *
+ * The app declares tools; Haven registers them with the browser's agent
+ * interface (WebMCP) under the app's namespace, checks the user's permission,
+ * asks for confirmation where a tool is consequential, and calls `execute`
+ * through the bridge. The tools disappear when the app closes.
+ */
+interface MindooDBAppAgentApi {
+    /** Replaces the app's whole tool set. Pass `[]` to withdraw all tools. */
+    registerTools(tools: MindooDBAppAgentTool[]): Promise<MindooDBAppAgentRegistration>;
+    /**
+     * The app's state as an agent should see it (open document, view, selection).
+     * Shown to agents in `haven_get_context` under the focused app. `null` clears it.
+     * Keep it small and semantic; it is not a UI dump.
+     */
+    setContext(context: Record<string, unknown> | null): Promise<void>;
+    /**
+     * Hands Haven a file the app produced (an export, a rendering, an attachment)
+     * and returns a short-lived `fileRef` (ten minutes). Return the ref from a
+     * tool; the agent passes it to `haven_files_export` to get the file into the
+     * user's exchange folder. Files never travel through the agent as bytes.
+     */
+    provideFile(data: Blob | ArrayBuffer | Uint8Array, options: {
+        name: string;
+        mimeType?: string;
+    }): Promise<{
+        fileRef: string;
+        size: number;
+    }>;
+    /**
+     * Takes a file Haven imported for this app (`haven_files_import` with the
+     * app's key). Fails for refs that expired or were imported for another app.
+     */
+    takeFile(fileRef: string): Promise<File>;
+}
+/** Host → app: an agent called one of the app's tools. */
+interface MindooDBAppBridgeAgentInvokeMessage {
+    protocol: "mindoodb-app-bridge";
+    kind: "agent-invoke";
+    callId: string;
+    /** The tool's name as the app registered it, without the prefix. */
+    tool: string;
+    input: Record<string, unknown>;
+}
+/** App → host: the outcome of an {@link MindooDBAppBridgeAgentInvokeMessage}. */
+interface MindooDBAppBridgeAgentResultMessage {
+    protocol: "mindoodb-app-bridge";
+    kind: "agent-result";
+    callId: string;
+    ok: boolean;
+    result?: unknown;
+    error?: {
+        code: MindooDBAppAgentToolErrorCode;
+        message: string;
+        requiredAction?: string;
+    };
+}
 /** Any message that can travel across the dedicated bridge MessagePort. */
-type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage | MindooDBAppBridgeLocaleChangedMessage | MindooDBAppBridgeQueryResultMessage | MindooDBAppBridgeViewChangedMessage | MindooDBAppBridgeBeforeCloseMessage | MindooDBAppBridgeBeforeCloseAck | MindooDBAppBridgeShortcutsChangedMessage | MindooDBAppBridgeShortcutInvokedMessage | MindooDBAppBridgeWorkspaceFocusRequestedMessage | MindooDBAppBridgeHostFocusChangedMessage | MindooDBAppBridgeDragOverMessage | MindooDBAppBridgeDragLeaveMessage | MindooDBAppBridgeDragDropMessage;
+type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage | MindooDBAppBridgeLocaleChangedMessage | MindooDBAppBridgeQueryResultMessage | MindooDBAppBridgeViewChangedMessage | MindooDBAppBridgeBeforeCloseMessage | MindooDBAppBridgeBeforeCloseAck | MindooDBAppBridgeShortcutsChangedMessage | MindooDBAppBridgeShortcutInvokedMessage | MindooDBAppBridgeWorkspaceFocusRequestedMessage | MindooDBAppBridgeHostFocusChangedMessage | MindooDBAppBridgeAgentInvokeMessage | MindooDBAppBridgeAgentResultMessage | MindooDBAppBridgeDragOverMessage | MindooDBAppBridgeDragLeaveMessage | MindooDBAppBridgeDragDropMessage;
 /** Placement hint for a host-rendered overlay menu. */
 type MindooDBAppMenuPlacement = "auto" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "right-start" | "left-start";
 /** Semantic hint allowing Haven to tune menu behavior or styling. */
@@ -2101,8 +2217,29 @@ interface MindooDBAppDirectoryApi {
     /**
      * Active directory usernames in this tenant, for recipient pickers.
      * Requires the `directory` capability.
+     *
+     * Without options: every username. With options: one page, filtered by a
+     * case-insensitive `query` and continued with `nextCursor` — use this for large
+     * directories. Hosts without paging support return the full list; the SDK then
+     * filters and pages it on the client, so the paged form works everywhere.
      */
     listUsers(): Promise<string[]>;
+    listUsers(options: MindooDBAppListUsersOptions): Promise<MindooDBAppListUsersPage>;
+}
+/** Paging and search for {@link MindooDBAppDirectoryApi.listUsers}. */
+interface MindooDBAppListUsersOptions {
+    /** Case-insensitive substring of the username. */
+    query?: string;
+    /** `nextCursor` of the previous page; omit for the first page. */
+    cursor?: string | null;
+    /** Page size, default 50, at most 500. */
+    limit?: number;
+}
+/** One page of {@link MindooDBAppDirectoryApi.listUsers}. */
+interface MindooDBAppListUsersPage {
+    users: string[];
+    /** Cursor for the next page, `null` on the last page. */
+    nextCursor: string | null;
 }
 /**
  * The only signing domain apps may request today. Domain separation is not
@@ -2877,6 +3014,11 @@ interface MindooDBAppSession {
      * replace one from another launch.
      */
     notify(input: MindooDBAppNotifyInput): Promise<MindooDBAppNotifyResult>;
+    /**
+     * Offer operations to AI agents through Haven. Absent on hosts that predate
+     * agent tools, so check before use.
+     */
+    agent?: MindooDBAppAgentApi;
     /**
      * Tear down the session: close the bridge port and release all host-side
      * resources of this launch (navigators, live queries, streams). The
@@ -2895,4 +3037,4 @@ interface MindooDBAppBridge {
     connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
 }
 
-export { type MindooDBAppBridgeRpcRequest as $, type MindooDBAppAttachmentApi as A, type MindooDBAppAttachmentChunk as B, type MindooDBAppAttachmentInfo as C, type MindooDBAppAttachmentPreviewOptions as D, type MindooDBAppAttachmentPreviewSession as E, type MindooDBAppAutomergeChangesPatch as F, type MindooDBAppAutomergeChangesSince as G, type MindooDBAppAutomergeGetOptions as H, type MindooDBAppAutomergePatchResult as I, type MindooDBAppAutomergeSnapshot as J, type MindooDBAppBridgeBeforeCloseAck as K, type MindooDBAppBridgeBeforeCloseMessage as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppBridgeConnectMessage as N, type MindooDBAppBridgeConnectOptions as O, type MindooDBAppBridgeConnectedMessage as P, type MindooDBAppBridgeDragDropMessage as Q, type MindooDBAppBridgeDragLeaveMessage as R, type MindooDBAppBridgeDragOverMessage as S, type MindooDBAppBridgeErrorPayload as T, type MindooDBAppBridgeHandshakeErrorMessage as U, type MindooDBAppBridgeHostFocusChangedMessage as V, type MindooDBAppBridgeLocaleChangedMessage as W, type MindooDBAppBridgePortMessage as X, type MindooDBAppBridgeQueryResultMessage as Y, type MindooDBAppBridgeRpcError as Z, type MindooDBAppBridgeRpcMessage as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppEntryProvenance as a$, type MindooDBAppBridgeRpcSuccess as a0, type MindooDBAppBridgeShortcutInvokedMessage as a1, type MindooDBAppBridgeShortcutsChangedMessage as a2, type MindooDBAppBridgeStreamAbortRequest as a3, type MindooDBAppBridgeStreamAck as a4, type MindooDBAppBridgeStreamCloseRequest as a5, type MindooDBAppBridgeStreamError as a6, type MindooDBAppBridgeStreamMessage as a7, type MindooDBAppBridgeStreamOpenResult as a8, type MindooDBAppBridgeStreamReadRequest as a9, type MindooDBAppDefinitionDatabase as aA, type MindooDBAppDefinitionListing as aB, type MindooDBAppDefinitionPermission as aC, type MindooDBAppDefinitionRegistrationPermission as aD, type MindooDBAppDefinitionScreenshot as aE, type MindooDBAppDefinitionValidation as aF, type MindooDBAppDirectoryApi as aG, type MindooDBAppDirectoryEntry as aH, type MindooDBAppDocumentApi as aI, type MindooDBAppDocumentHeadCursorResult as aJ, type MindooDBAppDocumentHistoryEntry as aK, type MindooDBAppDocumentListQuery as aL, type MindooDBAppDocumentListResult as aM, type MindooDBAppDocumentQuery as aN, type MindooDBAppDocumentRevisionId as aO, type MindooDBAppDocumentScanPreset as aP, type MindooDBAppDocumentSummary as aQ, type MindooDBAppDragApi as aR, type MindooDBAppDragCancelReason as aS, type MindooDBAppDragDropEvent as aT, type MindooDBAppDragEffect as aU, type MindooDBAppDragHoverResult as aV, type MindooDBAppDragOffer as aW, type MindooDBAppDragOverEvent as aX, type MindooDBAppDragPointer as aY, type MindooDBAppDragProfile as aZ, type MindooDBAppEntryAttachmentRef as a_, type MindooDBAppBridgeStreamWriteRequest as aa, type MindooDBAppBridgeThemeChangedMessage as ab, type MindooDBAppBridgeUiPreferencesChangedMessage as ac, type MindooDBAppBridgeViewChangedMessage as ad, type MindooDBAppBridgeViewportChangedMessage as ae, type MindooDBAppBridgeWorkspaceFocusRequestedMessage as af, type MindooDBAppCapability as ag, type MindooDBAppConfiguredViewCategorizationStyle as ah, type MindooDBAppConfiguredViewColumn as ai, type MindooDBAppConfiguredViewColumnRole as aj, type MindooDBAppConfiguredViewExpressionMode as ak, type MindooDBAppConfiguredViewFieldExpression as al, type MindooDBAppConfiguredViewFilterDefinition as am, type MindooDBAppConfiguredViewFilterMode as an, type MindooDBAppConfiguredViewFilterRule as ao, type MindooDBAppConfiguredViewFormulaExpression as ap, type MindooDBAppConfiguredViewFormulaFilterDefinition as aq, type MindooDBAppConfiguredViewPreviewMode as ar, type MindooDBAppConfiguredViewRuleFilterDefinition as as, type MindooDBAppConfiguredViewRuleMatchMode as at, type MindooDBAppConfiguredViewRuleOperator as au, type MindooDBAppConfiguredViewValueExpression as av, type MindooDBAppCreateKeyInfo as aw, type MindooDBAppCreateViewInput as ax, type MindooDBAppCreateViewNavigatorInput as ay, type MindooDBAppDatabaseInfo as az, type MindooDBAppDragStartInput as b, type MindooDBAppRichTextSpliceStep as b$, type MindooDBAppExtractDocumentTextInput as b0, type MindooDBAppExtractDocumentTextResult as b1, type MindooDBAppExtractTextFormat as b2, type MindooDBAppExtractionSetup as b3, type MindooDBAppFulltextSetup as b4, type MindooDBAppHistoricalDocument as b5, type MindooDBAppHistoryQuery as b6, type MindooDBAppHostTheme as b7, type MindooDBAppIdentityApi as b8, type MindooDBAppInaccessibleDocument as b9, type MindooDBAppMenuSeparatorItem as bA, type MindooDBAppNotificationSeverity as bB, type MindooDBAppNotifyInput as bC, type MindooDBAppNotifyResult as bD, type MindooDBAppProposeAppInput as bE, type MindooDBAppProposeAppResult as bF, type MindooDBAppQueryCoverage as bG, type MindooDBAppQueryInclude as bH, type MindooDBAppQueryIncludeCardinality as bI, type MindooDBAppQueryIncludeSlots as bJ, type MindooDBAppQueryResult as bK, type MindooDBAppQueryRow as bL, type MindooDBAppQuerySortKey as bM, type MindooDBAppQueryTextClause as bN, type MindooDBAppReadableAttachmentStream as bO, type MindooDBAppRecipientOptions as bP, type MindooDBAppResolvedViewDefinition as bQ, type MindooDBAppResolvedViewSource as bR, type MindooDBAppRevisionPhase as bS, type MindooDBAppRevisionVerification as bT, type MindooDBAppRichTextBlockSpan as bU, type MindooDBAppRichTextGetOptions as bV, type MindooDBAppRichTextImmutableString as bW, type MindooDBAppRichTextMarkRange as bX, type MindooDBAppRichTextMaterializeValue as bY, type MindooDBAppRichTextPatch as bZ, type MindooDBAppRichTextScalar as b_, type MindooDBAppInaccessibleDocumentListQuery as ba, type MindooDBAppInaccessibleDocumentListResult as bb, type MindooDBAppJsonCounterIncrementPatch as bc, type MindooDBAppJsonListDeletePatch as bd, type MindooDBAppJsonListInsertPatch as be, type MindooDBAppJsonPatch as bf, type MindooDBAppJsonSetPatch as bg, type MindooDBAppJsonTextMarkPatch as bh, type MindooDBAppJsonTextSplicePatch as bi, type MindooDBAppJsonTextUnmarkPatch as bj, type MindooDBAppJsonUnsetPatch as bk, type MindooDBAppLaunchContext as bl, type MindooDBAppLiveQuerySubscription as bm, type MindooDBAppLocalizedText as bn, type MindooDBAppMenuAnchor as bo, type MindooDBAppMenuApi as bp, type MindooDBAppMenuCommandItem as bq, type MindooDBAppMenuDismissReason as br, type MindooDBAppMenuDismissedResult as bs, type MindooDBAppMenuItem as bt, type MindooDBAppMenuKind as bu, type MindooDBAppMenuPlacement as bv, type MindooDBAppMenuPointAnchor as bw, type MindooDBAppMenuRect as bx, type MindooDBAppMenuRectAnchor as by, type MindooDBAppMenuSelectionResult as bz, type MindooDBAppDragStartResult as c, type MindooDBAppRichTextStep as c0, type MindooDBAppRichTextStepPatch as c1, type MindooDBAppRichTextTextSpan as c2, type MindooDBAppRuntime as c3, type MindooDBAppScanAttachmentOptions as c4, type MindooDBAppScanAttachmentResult as c5, type MindooDBAppScopedDocId as c6, type MindooDBAppScopedDocumentSummary as c7, type MindooDBAppSealIntent as c8, type MindooDBAppSealedChannelOpenInput as c9, type MindooDBAppViewEntry as cA, type MindooDBAppViewEntryKind as cB, type MindooDBAppViewNavigator as cC, type MindooDBAppViewNavigatorExpansionState as cD, type MindooDBAppViewNavigatorOpenOptions as cE, type MindooDBAppViewNavigatorPageOptions as cF, type MindooDBAppViewNavigatorPageResult as cG, type MindooDBAppViewNavigatorRangeQuery as cH, type MindooDBAppViewNavigatorSelectionState as cI, type MindooDBAppViewUpdateStats as cJ, type MindooDBAppViewport as cK, type MindooDBAppWellKnownDragType as cL, type MindooDBAppWritableAttachmentStream as cM, resolveMindooDBAppDefinitionUrl as cN, resolveMindooDBAppListingAssetUrl as cO, resolveMindooDBAppLocalizedText as cP, validateMindooDBAppDefinition as cQ, type MindooDBAppSealedChannelOpenResult as ca, type MindooDBAppSealedChannelRequestInput as cb, type MindooDBAppSession as cc, type MindooDBAppShowMenuInput as cd, type MindooDBAppShowMenuResult as ce, type MindooDBAppSignPreview as cf, type MindooDBAppSignPreviewScope as cg, type MindooDBAppSignStatementInput as ch, type MindooDBAppSignStatementResult as ci, type MindooDBAppStorageApi as cj, type MindooDBAppSummarySetup as ck, type MindooDBAppTextCursorOptions as cl, type MindooDBAppTextCursorPosition as cm, type MindooDBAppTextCursorPositionsResult as cn, type MindooDBAppTextCursorsResult as co, type MindooDBAppTextEdit as cp, type MindooDBAppTextPatch as cq, type MindooDBAppThemeMode as cr, type MindooDBAppTimestampApi as cs, type MindooDBAppTimestampInput as ct, type MindooDBAppTimestampProvider as cu, type MindooDBAppTimestampResult as cv, type MindooDBAppUiPreferences as cw, type MindooDBAppUpdateDocumentInput as cx, type MindooDBAppViewCursorDocumentListResult as cy, type MindooDBAppViewCursorResult as cz, type MindooDBAppDragPreview as d, type MindooDBAppBridge as e, type MindooDBAppHostShortcutBinding as f, type MindooDBAppHostShortcutAction as g, type MindooDBAppHostingMode as h, type MindooDBAppDefinition as i, type MindooDBAppDatabase as j, type MindooDBAppDocument as k, type MindooDBAppRichTextSpan as l, type MindooDBAppRichTextSnapshot as m, type MindooDBAppCreateDocumentInput as n, MINDOODB_APP_DEFINITION_FILE_NAME as o, MINDOODB_APP_DEFINITION_FORMAT as p, MINDOODB_APP_DEFINITION_PERMISSIONS as q, MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS as r, MINDOODB_APP_DEFINITION_VERSION as s, MINDOODB_APP_LISTING_DESCRIPTION_MAX as t, MINDOODB_APP_LISTING_MAX_SCREENSHOTS as u, MINDOODB_APP_LISTING_SUMMARY_MAX as v, MINDOODB_APP_SEAL_SIGNING_DOMAIN as w, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as x, type MindooDBAppAccessDecision as y, type MindooDBAppAccessTier as z };
+export { type MindooDBAppBridgeErrorPayload as $, type MindooDBAppAccessTier as A, type MindooDBAppAgentApi as B, type MindooDBAppAgentRegistration as C, type MindooDBAppAgentTool as D, type MindooDBAppAgentToolAnnotations as E, type MindooDBAppAgentToolDescriptor as F, type MindooDBAppAttachmentApi as G, type MindooDBAppAttachmentChunk as H, type MindooDBAppAttachmentInfo as I, type MindooDBAppAttachmentPreviewOptions as J, type MindooDBAppAttachmentPreviewSession as K, type MindooDBAppAutomergeChangesPatch as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppAutomergeChangesSince as N, type MindooDBAppAutomergeGetOptions as O, type MindooDBAppAutomergePatchResult as P, type MindooDBAppAutomergeSnapshot as Q, type MindooDBAppBridgeAgentInvokeMessage as R, type MindooDBAppBridgeAgentResultMessage as S, type MindooDBAppBridgeBeforeCloseAck as T, type MindooDBAppBridgeBeforeCloseMessage as U, type MindooDBAppBridgeConnectMessage as V, type MindooDBAppBridgeConnectOptions as W, type MindooDBAppBridgeConnectedMessage as X, type MindooDBAppBridgeDragDropMessage as Y, type MindooDBAppBridgeDragLeaveMessage as Z, type MindooDBAppBridgeDragOverMessage as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppDragDropEvent as a$, type MindooDBAppBridgeHandshakeErrorMessage as a0, type MindooDBAppBridgeHostFocusChangedMessage as a1, type MindooDBAppBridgeLocaleChangedMessage as a2, type MindooDBAppBridgePortMessage as a3, type MindooDBAppBridgeQueryResultMessage as a4, type MindooDBAppBridgeRpcError as a5, type MindooDBAppBridgeRpcMessage as a6, type MindooDBAppBridgeRpcRequest as a7, type MindooDBAppBridgeRpcSuccess as a8, type MindooDBAppBridgeShortcutInvokedMessage as a9, type MindooDBAppConfiguredViewRuleFilterDefinition as aA, type MindooDBAppConfiguredViewRuleMatchMode as aB, type MindooDBAppConfiguredViewRuleOperator as aC, type MindooDBAppConfiguredViewValueExpression as aD, type MindooDBAppCreateKeyInfo as aE, type MindooDBAppCreateViewInput as aF, type MindooDBAppCreateViewNavigatorInput as aG, type MindooDBAppDatabaseInfo as aH, type MindooDBAppDefinitionDatabase as aI, type MindooDBAppDefinitionListing as aJ, type MindooDBAppDefinitionPermission as aK, type MindooDBAppDefinitionRegistrationPermission as aL, type MindooDBAppDefinitionScreenshot as aM, type MindooDBAppDefinitionValidation as aN, type MindooDBAppDirectoryApi as aO, type MindooDBAppDirectoryEntry as aP, type MindooDBAppDocumentApi as aQ, type MindooDBAppDocumentHeadCursorResult as aR, type MindooDBAppDocumentHistoryEntry as aS, type MindooDBAppDocumentListQuery as aT, type MindooDBAppDocumentListResult as aU, type MindooDBAppDocumentQuery as aV, type MindooDBAppDocumentRevisionId as aW, type MindooDBAppDocumentScanPreset as aX, type MindooDBAppDocumentSummary as aY, type MindooDBAppDragApi as aZ, type MindooDBAppDragCancelReason as a_, type MindooDBAppBridgeShortcutsChangedMessage as aa, type MindooDBAppBridgeStreamAbortRequest as ab, type MindooDBAppBridgeStreamAck as ac, type MindooDBAppBridgeStreamCloseRequest as ad, type MindooDBAppBridgeStreamError as ae, type MindooDBAppBridgeStreamMessage as af, type MindooDBAppBridgeStreamOpenResult as ag, type MindooDBAppBridgeStreamReadRequest as ah, type MindooDBAppBridgeStreamWriteRequest as ai, type MindooDBAppBridgeThemeChangedMessage as aj, type MindooDBAppBridgeUiPreferencesChangedMessage as ak, type MindooDBAppBridgeViewChangedMessage as al, type MindooDBAppBridgeViewportChangedMessage as am, type MindooDBAppBridgeWorkspaceFocusRequestedMessage as an, type MindooDBAppCapability as ao, type MindooDBAppConfiguredViewCategorizationStyle as ap, type MindooDBAppConfiguredViewColumn as aq, type MindooDBAppConfiguredViewColumnRole as ar, type MindooDBAppConfiguredViewExpressionMode as as, type MindooDBAppConfiguredViewFieldExpression as at, type MindooDBAppConfiguredViewFilterDefinition as au, type MindooDBAppConfiguredViewFilterMode as av, type MindooDBAppConfiguredViewFilterRule as aw, type MindooDBAppConfiguredViewFormulaExpression as ax, type MindooDBAppConfiguredViewFormulaFilterDefinition as ay, type MindooDBAppConfiguredViewPreviewMode as az, type MindooDBAppDragStartInput as b, type MindooDBAppResolvedViewSource as b$, type MindooDBAppDragEffect as b0, type MindooDBAppDragHoverResult as b1, type MindooDBAppDragOffer as b2, type MindooDBAppDragOverEvent as b3, type MindooDBAppDragPointer as b4, type MindooDBAppDragProfile as b5, type MindooDBAppEntryAttachmentRef as b6, type MindooDBAppEntryProvenance as b7, type MindooDBAppExtractDocumentTextInput as b8, type MindooDBAppExtractDocumentTextResult as b9, type MindooDBAppMenuCommandItem as bA, type MindooDBAppMenuDismissReason as bB, type MindooDBAppMenuDismissedResult as bC, type MindooDBAppMenuItem as bD, type MindooDBAppMenuKind as bE, type MindooDBAppMenuPlacement as bF, type MindooDBAppMenuPointAnchor as bG, type MindooDBAppMenuRect as bH, type MindooDBAppMenuRectAnchor as bI, type MindooDBAppMenuSelectionResult as bJ, type MindooDBAppMenuSeparatorItem as bK, type MindooDBAppNotificationSeverity as bL, type MindooDBAppNotifyInput as bM, type MindooDBAppNotifyResult as bN, type MindooDBAppProposeAppInput as bO, type MindooDBAppProposeAppResult as bP, type MindooDBAppQueryCoverage as bQ, type MindooDBAppQueryInclude as bR, type MindooDBAppQueryIncludeCardinality as bS, type MindooDBAppQueryIncludeSlots as bT, type MindooDBAppQueryResult as bU, type MindooDBAppQueryRow as bV, type MindooDBAppQuerySortKey as bW, type MindooDBAppQueryTextClause as bX, type MindooDBAppReadableAttachmentStream as bY, type MindooDBAppRecipientOptions as bZ, type MindooDBAppResolvedViewDefinition as b_, type MindooDBAppExtractTextFormat as ba, type MindooDBAppExtractionSetup as bb, type MindooDBAppFulltextSetup as bc, type MindooDBAppHistoricalDocument as bd, type MindooDBAppHistoryQuery as be, type MindooDBAppHostTheme as bf, type MindooDBAppIdentityApi as bg, type MindooDBAppInaccessibleDocument as bh, type MindooDBAppInaccessibleDocumentListQuery as bi, type MindooDBAppInaccessibleDocumentListResult as bj, type MindooDBAppJsonCounterIncrementPatch as bk, type MindooDBAppJsonListDeletePatch as bl, type MindooDBAppJsonListInsertPatch as bm, type MindooDBAppJsonPatch as bn, type MindooDBAppJsonSetPatch as bo, type MindooDBAppJsonTextMarkPatch as bp, type MindooDBAppJsonTextSplicePatch as bq, type MindooDBAppJsonTextUnmarkPatch as br, type MindooDBAppJsonUnsetPatch as bs, type MindooDBAppLaunchContext as bt, type MindooDBAppListUsersOptions as bu, type MindooDBAppListUsersPage as bv, type MindooDBAppLiveQuerySubscription as bw, type MindooDBAppLocalizedText as bx, type MindooDBAppMenuAnchor as by, type MindooDBAppMenuApi as bz, type MindooDBAppDragStartResult as c, type MindooDBAppRevisionPhase as c0, type MindooDBAppRevisionVerification as c1, type MindooDBAppRichTextBlockSpan as c2, type MindooDBAppRichTextGetOptions as c3, type MindooDBAppRichTextImmutableString as c4, type MindooDBAppRichTextMarkRange as c5, type MindooDBAppRichTextMaterializeValue as c6, type MindooDBAppRichTextPatch as c7, type MindooDBAppRichTextScalar as c8, type MindooDBAppRichTextSpliceStep as c9, type MindooDBAppTextPatch as cA, type MindooDBAppThemeMode as cB, type MindooDBAppTimestampApi as cC, type MindooDBAppTimestampInput as cD, type MindooDBAppTimestampProvider as cE, type MindooDBAppTimestampResult as cF, type MindooDBAppUiPreferences as cG, type MindooDBAppUpdateDocumentInput as cH, type MindooDBAppViewCursorDocumentListResult as cI, type MindooDBAppViewCursorResult as cJ, type MindooDBAppViewEntry as cK, type MindooDBAppViewEntryKind as cL, type MindooDBAppViewNavigator as cM, type MindooDBAppViewNavigatorExpansionState as cN, type MindooDBAppViewNavigatorOpenOptions as cO, type MindooDBAppViewNavigatorPageOptions as cP, type MindooDBAppViewNavigatorPageResult as cQ, type MindooDBAppViewNavigatorRangeQuery as cR, type MindooDBAppViewNavigatorSelectionState as cS, type MindooDBAppViewUpdateStats as cT, type MindooDBAppViewport as cU, type MindooDBAppWellKnownDragType as cV, type MindooDBAppWritableAttachmentStream as cW, resolveMindooDBAppDefinitionUrl as cX, resolveMindooDBAppListingAssetUrl as cY, resolveMindooDBAppLocalizedText as cZ, validateMindooDBAppDefinition as c_, type MindooDBAppRichTextStep as ca, type MindooDBAppRichTextStepPatch as cb, type MindooDBAppRichTextTextSpan as cc, type MindooDBAppRuntime as cd, type MindooDBAppScanAttachmentOptions as ce, type MindooDBAppScanAttachmentResult as cf, type MindooDBAppScopedDocId as cg, type MindooDBAppScopedDocumentSummary as ch, type MindooDBAppSealIntent as ci, type MindooDBAppSealedChannelOpenInput as cj, type MindooDBAppSealedChannelOpenResult as ck, type MindooDBAppSealedChannelRequestInput as cl, type MindooDBAppSession as cm, type MindooDBAppShowMenuInput as cn, type MindooDBAppShowMenuResult as co, type MindooDBAppSignPreview as cp, type MindooDBAppSignPreviewScope as cq, type MindooDBAppSignStatementInput as cr, type MindooDBAppSignStatementResult as cs, type MindooDBAppStorageApi as ct, type MindooDBAppSummarySetup as cu, type MindooDBAppTextCursorOptions as cv, type MindooDBAppTextCursorPosition as cw, type MindooDBAppTextCursorPositionsResult as cx, type MindooDBAppTextCursorsResult as cy, type MindooDBAppTextEdit as cz, type MindooDBAppDragPreview as d, type MindooDBAppBridge as e, type MindooDBAppAgentToolErrorCode as f, type MindooDBAppHostShortcutBinding as g, type MindooDBAppHostShortcutAction as h, type MindooDBAppHostingMode as i, type MindooDBAppDefinition as j, type MindooDBAppDatabase as k, type MindooDBAppDocument as l, type MindooDBAppRichTextSpan as m, type MindooDBAppRichTextSnapshot as n, type MindooDBAppCreateDocumentInput as o, MINDOODB_APP_DEFINITION_FILE_NAME as p, MINDOODB_APP_DEFINITION_FORMAT as q, MINDOODB_APP_DEFINITION_PERMISSIONS as r, MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS as s, MINDOODB_APP_DEFINITION_VERSION as t, MINDOODB_APP_LISTING_DESCRIPTION_MAX as u, MINDOODB_APP_LISTING_MAX_SCREENSHOTS as v, MINDOODB_APP_LISTING_SUMMARY_MAX as w, MINDOODB_APP_SEAL_SIGNING_DOMAIN as x, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as y, type MindooDBAppAccessDecision as z };

package/dist/vite/index.d.ts

@@ -26,22 +26,35 @@ interface HavenBundleOptions {
 }
 interface ResolvedViteConfig {
     root: string;
+    command?: "build" | "serve";
     build: {
         outDir: string;
     };
+    server?: {
+        host?: string | boolean;
+        port?: number;
+    };
+}
+interface ShareHtmlContext {
+    filename?: string;
+    server?: {
+        resolvedUrls?: {
+            local?: string[];
+        } | null;
+    };
 }
 /** Structural subset of Vite's `Plugin`, so the SDK does not need to depend on Vite. */
 interface HavenBundleVitePlugin {
     name: string;
-    apply: "build";
+    /**
+     * Runs in dev and in build. The zip is still build-only; dev needs the same plugin so
+     * `index.html` carries the share tags while `vite dev` is serving it.
+     */
     configResolved: (config: ResolvedViteConfig) => void;
+    transformIndexHtml: (html: string, ctx: ShareHtmlContext) => Promise<string>;
     writeBundle: () => Promise<void>;
     closeBundle: () => Promise<void>;
 }
-/**
- * Emits `haven-bundle.json` and `haven-bundle.zip` next to the build output so a MindooDB
- * host can install and update the app from a URL.
- */
 declare function havenBundle(options?: HavenBundleOptions): HavenBundleVitePlugin;
 
 export { type HavenBundleOptions, type HavenBundleVitePlugin, havenBundle };

package/dist/vite/index.js

@@ -11,6 +11,127 @@ import { createHash } from "crypto";
 import { access, readdir, readFile, writeFile } from "fs/promises";
 import path from "path";
 
+// src/shareMeta.ts
+var SUMMARY_CARD = "summary";
+function escapeText(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function escapeAttr(value) {
+  return escapeText(value).replace(/"/g, "&quot;").replace(/[\t\n\r]/g, " ");
+}
+function meta(attr, key, content) {
+  return `<meta ${attr}="${key}" content="${escapeAttr(content)}">`;
+}
+function localized(value) {
+  if (typeof value === "string") {
+    return value.trim();
+  }
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return "";
+  }
+  const record = value;
+  if (typeof record.en === "string" && record.en.trim()) {
+    return record.en.trim();
+  }
+  for (const text of Object.values(record)) {
+    if (typeof text === "string" && text.trim()) {
+      return text.trim();
+    }
+  }
+  return "";
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function havenAppPublicUrl(raw) {
+  if (!isRecord(raw)) {
+    return void 0;
+  }
+  return havenAppSharePageUrl(raw.publicUrl);
+}
+function havenAppSharePageUrl(value) {
+  if (typeof value !== "string" || !value.trim()) {
+    return void 0;
+  }
+  try {
+    const url = new URL(value.trim());
+    if (url.protocol !== "https:" && url.protocol !== "http:") {
+      return void 0;
+    }
+    return url.origin + "/";
+  } catch {
+    return void 0;
+  }
+}
+function absoluteRasterUrl(asset, pageUrl) {
+  if (/\.svg($|\?)/i.test(asset)) {
+    return void 0;
+  }
+  try {
+    const url = new URL(asset, pageUrl);
+    if (url.protocol !== "https:" && url.protocol !== "http:") {
+      return void 0;
+    }
+    return url.href;
+  } catch {
+    return void 0;
+  }
+}
+function havenAppShareMeta(raw, pageUrl) {
+  const page = havenAppSharePageUrl(pageUrl);
+  if (!isRecord(raw) || !page) {
+    return void 0;
+  }
+  const title = typeof raw.label === "string" ? raw.label.trim() : "";
+  if (!title) {
+    return void 0;
+  }
+  const listing = isRecord(raw.listing) ? raw.listing : void 0;
+  const summary = localized(listing?.summary);
+  const descriptionText = localized(listing?.description);
+  const description = summary || descriptionText.split(/\n\s*\n/)[0]?.trim() || (typeof raw.description === "string" ? raw.description.trim() : "");
+  const icon = typeof listing?.icon === "string" ? listing.icon.trim() : "";
+  const imageUrl = icon ? absoluteRasterUrl(icon, page) : void 0;
+  return { title, description, pageUrl: page, ...imageUrl ? { imageUrl } : {} };
+}
+function renderHavenAppShareMeta(metaData) {
+  const lines = [
+    "<!-- mindoodb-share -->",
+    meta("name", "description", metaData.description),
+    meta("property", "og:type", "website"),
+    meta("property", "og:title", metaData.title),
+    meta("property", "og:description", metaData.description),
+    meta("property", "og:url", metaData.pageUrl)
+  ];
+  if (metaData.imageUrl) {
+    lines.push(meta("property", "og:image", metaData.imageUrl), meta("property", "og:image:alt", metaData.title));
+  }
+  lines.push(
+    meta("name", "twitter:card", SUMMARY_CARD),
+    meta("name", "twitter:title", metaData.title),
+    meta("name", "twitter:description", metaData.description)
+  );
+  if (metaData.imageUrl) {
+    lines.push(meta("name", "twitter:image", metaData.imageUrl));
+  }
+  lines.push("<!-- /mindoodb-share -->");
+  return lines.filter((line) => !line.includes('content=""')).join("\n");
+}
+var TITLE_PATTERN = /<title>[^<]*<\/title>/i;
+function injectHavenAppShareMeta(html, metaData) {
+  if (html.includes("<!-- mindoodb-share -->")) {
+    return html;
+  }
+  const block = renderHavenAppShareMeta(metaData);
+  const titled = TITLE_PATTERN.test(html) ? html.replace(TITLE_PATTERN, `<title>${escapeText(metaData.title)}</title>`) : html;
+  const headEnd = titled.search(/<\/head>/i);
+  if (headEnd === -1) {
+    return titled;
+  }
+  return `${titled.slice(0, headEnd)}${block}
+${titled.slice(headEnd)}`;
+}
+
 // src/vite/zip.ts
 import { deflateRawSync } from "zlib";
 var CRC32_TABLE = (() => {
@@ -229,11 +350,26 @@ async function readPackageMetadata(root) {
     return { name: void 0, version: void 0 };
   }
 }
+function devPageUrl(config, ctx) {
+  const local = ctx.server?.resolvedUrls?.local ?? [];
+  const fromServer = havenAppSharePageUrl(local.find((url) => url.includes("127.0.0.1")) ?? local[0]);
+  if (fromServer) {
+    return fromServer;
+  }
+  const port = config.server?.port;
+  if (!port) {
+    return void 0;
+  }
+  const host = config.server?.host;
+  const hostname = !host || host === true || host === "0.0.0.0" ? "127.0.0.1" : host;
+  return havenAppSharePageUrl(`http://${hostname}:${port}/`);
+}
 function havenBundle(options = {}) {
   let resolvedConfig = null;
   let emitted = false;
+  let isBuild = true;
   async function emitBundle() {
-    if (emitted) {
+    if (!isBuild || emitted) {
       return;
     }
     if (!resolvedConfig) {
@@ -296,9 +432,27 @@ function havenBundle(options = {}) {
   }
   return {
     name: "haven-bundle",
-    apply: "build",
     configResolved(config) {
       resolvedConfig = config;
+      isBuild = config.command !== "serve";
+    },
+    async transformIndexHtml(html, ctx) {
+      if (!resolvedConfig || ctx.filename?.includes("__haven-test")) {
+        return html;
+      }
+      let raw;
+      try {
+        raw = JSON.parse(await readFile(path.join(resolvedConfig.root, "public", "haven-app.json"), "utf8"));
+      } catch {
+        return html;
+      }
+      const baked = havenAppPublicUrl(raw);
+      const pageUrl = resolvedConfig.command === "serve" ? devPageUrl(resolvedConfig, ctx) ?? baked : baked;
+      if (!pageUrl) {
+        return html;
+      }
+      const meta2 = havenAppShareMeta(raw, pageUrl);
+      return meta2 ? injectHavenAppShareMeta(html, meta2) : html;
     },
     async writeBundle() {
       await emitBundle();

package/package.json

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