mindoodb-app-sdk 0.0.71 → 0.0.73

package/dist/{types-Dff-SyIx.d.ts → types-CbH_R16h.d.ts}

@@ -282,6 +282,18 @@ interface MindooDBAppComponentSpec {
     provides?: MindooDBAppComponentContract[];
     /** Fields of the root document that point at other root documents. */
     references?: MindooDBAppComponentReference[];
+    /**
+     * What the component can do for its hosts beyond showing the document, so a host
+     * can pick one that fits (`components.list({ requires })`): `inspect:<contract>`
+     * (describes its document, e.g. `inspect:mindoo.inspect.document@1`), `validate`
+     * (asks before it saves, `session.embedding.validate`), `issues` (shows a host's
+     * findings, `embed.showIssues`), `reveal` (scrolls to an anchor, `embed.reveal`),
+     * `variables` (offers the host's fields to insert, `embed.setVariables`),
+     * `template` (starts a new document from a template, `embeds.open({ template })`),
+     * `export:<format>` (hands over a file, `embed.export`, e.g. `export:pdf`).
+     * Changing it does not ask users again: it grants no access.
+     */
+    supports?: string[];
 }
 /**
  * Text in one language, or a map from locale (`de`, `fr`, …) to text. A map must carry
@@ -391,6 +403,425 @@ declare function validateMindooDBAppDefinition(raw: unknown): MindooDBAppDefinit
  */
 declare function resolveMindooDBAppDefinitionUrl(baseUrl: string): string;
 
+/**
+ * Typed document values that plain JSON cannot express.
+ *
+ * Each helper returns a tagged plain object such as
+ * `{ $mindoo: "counter", value: 0 }`. Use it anywhere a value is written:
+ * `documents.create({ set })`, `documents.update({ set })`, JSON patch `set`
+ * and `listInsert` values, also nested inside objects and arrays. Haven turns
+ * the tags into the matching collaborative type. Reads return plain JSON:
+ * atomic strings as strings, counters as numbers, timestamps as ISO 8601
+ * strings.
+ *
+ * The object key `$mindoo` is reserved; an object carrying it must be one of
+ * these values, otherwise the write is rejected.
+ */
+/** Reserved object key that marks a typed value. */
+declare const MINDOODB_APP_VALUE_TAG = "$mindoo";
+/** A string that is replaced as a whole on concurrent writes. */
+interface MindooDBAppAtomicValue {
+    $mindoo: "atomic";
+    value: string;
+}
+/** A number whose concurrent increments are summed on merge. */
+interface MindooDBAppCounterValue {
+    $mindoo: "counter";
+    value: number;
+}
+/** A point in time: epoch milliseconds or an ISO 8601 date-time string. */
+interface MindooDBAppTimestampValue {
+    $mindoo: "timestamp";
+    value: number | string;
+}
+type MindooDBAppTypedValue = MindooDBAppAtomicValue | MindooDBAppCounterValue | MindooDBAppTimestampValue;
+declare const MindooDBAppValue: {
+    /**
+     * An atomic string for identifiers, status and enum values, URLs, hashes
+     * and stored text cursors. Plain strings are collaborative text, where two
+     * concurrent changes of `"open"` to `"closed"` and `"blocked"` can
+     * interleave into a mix of both words.
+     */
+    readonly atomic: (value: string) => MindooDBAppAtomicValue;
+    /**
+     * A collaborative counter with an initial value (a safe integer). Create it
+     * once, then change it only with `json.counterIncrement`: writing a new
+     * counter is an assignment that does not merge with concurrent increments.
+     */
+    readonly counter: (value?: number) => MindooDBAppCounterValue;
+    /** A timestamp from a `Date`, epoch milliseconds or an ISO 8601 string. */
+    readonly timestamp: (value: Date | number | string) => MindooDBAppTimestampValue;
+    /** Whether `value` is a tagged typed value (any kind). */
+    readonly isTyped: (value: unknown) => value is MindooDBAppTypedValue;
+};
+
+/**
+ * Checking an embedded component's document before it is saved.
+ *
+ * A component that declares `supports: ["inspect:<contract>"]` describes its
+ * document on request in a shape every host can read without knowing the app:
+ * a Word or Markdown document as {@link MindooDBAppDocumentInspection}, a
+ * workbook as {@link MindooDBAppSpreadsheetInspection}, a deck as
+ * {@link MindooDBAppSlidesInspection}. A host asks for that (`embed.inspect`)
+ * or checks it before every save (`embed.onBeforeSave`), answering with
+ * {@link MindooDBAppIssue}s. The same checks can run on the small summary each
+ * component writes to its root document (`inspection` field), so a host can
+ * judge documents it does not have open.
+ *
+ * Rules that work on both: {@link defineDocumentRules}.
+ */
+
+/** Word and Markdown documents. */
+declare const MINDOODB_INSPECT_DOCUMENT = "mindoo.inspect.document@1";
+/** Workbooks. */
+declare const MINDOODB_INSPECT_SPREADSHEET = "mindoo.inspect.spreadsheet@1";
+/** Presentations. */
+declare const MINDOODB_INSPECT_SLIDES = "mindoo.inspect.slides@1";
+/** Root document field holding the summary a component writes on every save. */
+declare const MINDOODB_APP_INSPECTION_FIELD = "inspection";
+/** Upper bound of the root summary, as JSON. */
+declare const MINDOODB_APP_INSPECTION_SUMMARY_MAX_BYTES: number;
+/** Upper bound of a full inspection Haven passes between apps, as JSON. */
+declare const MINDOODB_APP_INSPECTION_MAX_BYTES: number;
+/** At most this many issues per check. */
+declare const MINDOODB_APP_ISSUES_MAX = 100;
+/**
+ * A place in the component's document, for `embed.reveal` and issues: a heading
+ * (its id from the outline), a cell (`Sheet1!B3`, or `B3` on the first sheet) or
+ * a slide (0-based).
+ */
+type MindooDBAppInspectAnchor = {
+    kind: "heading";
+    id: string;
+} | {
+    kind: "cell";
+    ref: string;
+} | {
+    kind: "slide";
+    index: number;
+};
+type MindooDBAppIssueSeverity = "error" | "warning" | "info";
+/**
+ * A finding about the document. Before a save, `error` stops it, `warning` asks
+ * the user whether to save anyway, `info` is only shown.
+ */
+interface MindooDBAppIssue {
+    severity: MindooDBAppIssueSeverity;
+    /** For the user, in their language. At most 500 characters. */
+    message: string;
+    /** Where in the document, so the component can show it (`embed.reveal`). */
+    anchor?: MindooDBAppInspectAnchor;
+    /** Stable id of the rule, e.g. `open-placeholders`. */
+    code?: string;
+}
+/** What a host asks a component to describe (`embed.inspect`, `onBeforeSave`). */
+interface MindooDBAppInspectRequest {
+    /** One of the component's `inspect:` contracts. Default: its first one. */
+    contract?: string;
+    /**
+     * Optional parts: `text` (plain text of a document, see `maxTextLength`). Other
+     * parts of the contracts are always there.
+     */
+    include?: string[];
+    /** Spreadsheets: cells whose values to return, `Sheet1!B3` or `B3` (first sheet). At most 200. */
+    cells?: string[];
+    /** With `include: ["text"]`: at most this many characters (default 4000, max 50000). */
+    maxTextLength?: number;
+}
+/** What every inspection carries. */
+interface MindooDBAppInspectionBase {
+    contract: string;
+    /** Title of the document (the root's `subject`). */
+    subject?: string;
+    /** Set when lists or text were shortened, e.g. in the root summary. */
+    truncated?: boolean;
+}
+/** `mindoo.inspect.document@1`: a Word or Markdown document. */
+interface MindooDBAppDocumentInspection extends MindooDBAppInspectionBase {
+    contract: typeof MINDOODB_INSPECT_DOCUMENT;
+    /** Plain text, shortened to `maxTextLength`; only with `include: ["text"]`. */
+    text?: string;
+    /** Headings in document order. */
+    outline: Array<{
+        level: number;
+        text: string;
+        anchor: {
+            kind: "heading";
+            id: string;
+        };
+    }>;
+    /** Placeholders and Word MERGEFIELDs that were not filled in yet. */
+    placeholders: Array<{
+        name: string;
+        kind: "placeholder" | "mergefield";
+        anchor?: MindooDBAppInspectAnchor;
+    }>;
+    /** Comments that are not resolved. */
+    openComments: number;
+    /** Tracked changes that were neither accepted nor rejected. */
+    openTrackedChanges: number;
+    wordCount: number;
+}
+/** A cell value as `mindoo.inspect.spreadsheet@1` reports it. */
+interface MindooDBAppInspectedCell {
+    value: string | number | boolean | null;
+    formula?: string;
+    /** Formula error such as `#REF!` or `#DIV/0!`. */
+    error?: string;
+}
+/** `mindoo.inspect.spreadsheet@1`: a workbook. */
+interface MindooDBAppSpreadsheetInspection extends MindooDBAppInspectionBase {
+    contract: typeof MINDOODB_INSPECT_SPREADSHEET;
+    sheets: Array<{
+        name: string;
+        rows?: number;
+        columns?: number;
+    }>;
+    namedRanges: Array<{
+        name: string;
+        ref: string;
+    }>;
+    /** The requested `cells`, keyed by the ref as requested. */
+    cells?: Record<string, MindooDBAppInspectedCell>;
+    /** Cells whose formula evaluates to an error. */
+    formulaErrors: Array<{
+        ref: string;
+        error: string;
+        formula?: string;
+    }>;
+}
+/** `mindoo.inspect.slides@1`: a presentation. */
+interface MindooDBAppSlidesInspection extends MindooDBAppInspectionBase {
+    contract: typeof MINDOODB_INSPECT_SLIDES;
+    slideCount: number;
+    slides: Array<{
+        index: number;
+        title?: string;
+    }>;
+    /** Layout placeholders nobody filled, e.g. an empty title. */
+    emptyPlaceholders: Array<{
+        slide: number;
+        placeholder: string;
+        anchor: {
+            kind: "slide";
+            index: number;
+        };
+    }>;
+}
+type MindooDBAppInspection = MindooDBAppDocumentInspection | MindooDBAppSpreadsheetInspection | MindooDBAppSlidesInspection;
+/** What a component passes to `session.embedding.complete`. */
+interface MindooDBAppEmbeddingResult {
+    /** Title of the document after the edit. */
+    subject: string;
+    /** One or two sentences for the host to show. */
+    summary?: string;
+    /** Small preview, a `data:image/png` or `data:image/jpeg` URL (the whole result stays below 64 KiB). */
+    thumbnail?: string;
+    /** Counts such as words, sheets or slides. */
+    stats?: Record<string, number>;
+}
+/** The outcome of `session.embedding.validate`. */
+interface MindooDBAppEmbedValidation {
+    /** False: do not save (an error, or the user did not confirm a warning). */
+    ok: boolean;
+    issues: MindooDBAppIssue[];
+    /** The host did not answer in time; Haven let the save go ahead. */
+    timedOut?: boolean;
+}
+/** Thrown by `session.embedding.save` when the host's checks stopped the save. */
+declare class MindooDBAppEmbedValidationError extends Error {
+    readonly issues: MindooDBAppIssue[];
+    constructor(issues: MindooDBAppIssue[]);
+}
+/**
+ * Whether a component's `supports` list covers `requirement`: `inspect` is met by
+ * any `inspect:…` entry, `inspect:mindoo.inspect.document@1` only by that one.
+ */
+declare function mindooDBAppComponentSupports(supports: readonly string[] | undefined, requirement: string): boolean;
+/** The contracts of a component's `inspect:` entries, in declared order. */
+declare function mindooDBAppInspectContracts(supports: readonly string[] | undefined): string[];
+/** A valid anchor, or undefined. */
+declare function normalizeMindooDBAppInspectAnchor(raw: unknown): MindooDBAppInspectAnchor | undefined;
+/**
+ * Issues as they may cross between apps: known severities, messages and codes
+ * shortened, invalid anchors dropped, at most {@link MINDOODB_APP_ISSUES_MAX}.
+ * Anything that is not an issue is left out.
+ */
+declare function normalizeMindooDBAppIssues(raw: unknown): MindooDBAppIssue[];
+/** An inspect request as it may cross between apps. */
+declare function normalizeMindooDBAppInspectRequest(raw: unknown): MindooDBAppInspectRequest;
+/**
+ * An inspection as it may cross between apps: plain JSON with a `contract`, at
+ * most {@link MINDOODB_APP_INSPECTION_MAX_BYTES}. Throws otherwise.
+ */
+declare function normalizeMindooDBAppInspection(raw: unknown): MindooDBAppInspectionBase & Record<string, unknown>;
+/**
+ * The small summary of an inspection a component keeps on its root document:
+ * no requested cells, text and lists shortened (`truncated: true` then) until it
+ * fits {@link MINDOODB_APP_INSPECTION_SUMMARY_MAX_BYTES}. Counts stay exact, so
+ * rules like "no open placeholders" give the same answer on it.
+ */
+declare function summarizeMindooDBAppInspection<T extends MindooDBAppInspectionBase>(inspection: T, maxBytes?: number): T;
+/**
+ * The summary as a value to write to the root (`set: { inspection: … }`): one
+ * atomic string of JSON, so concurrent saves replace it instead of merging text.
+ */
+declare function mindooDBAppInspectionSummaryValue(inspection: MindooDBAppInspectionBase): MindooDBAppAtomicValue;
+/** The summary a component wrote to this root document, or null. */
+declare function readMindooDBAppInspectionSummary<T extends MindooDBAppInspectionBase = MindooDBAppInspection>(root: Readonly<Record<string, unknown>> | null | undefined): T | null;
+/** What a rule's `check` may return: a message, issues, or nothing for "fine". */
+type MindooDBAppDocumentRuleOutcome = string | MindooDBAppIssue | MindooDBAppIssue[] | null | undefined | false;
+/** One check on an inspection. */
+interface MindooDBAppDocumentRule<T extends MindooDBAppInspectionBase = MindooDBAppInspection> {
+    /** Stable id; becomes the issue's `code`. */
+    code: string;
+    /** For a message returned as a string. Default `error`. */
+    severity?: MindooDBAppIssueSeverity;
+    check(inspection: T): MindooDBAppDocumentRuleOutcome;
+}
+/** What {@link defineDocumentRules} returns. */
+interface MindooDBAppDocumentRules {
+    /** What to ask the component for (`embed.onBeforeSave(handler, { inspect: rules.request })`). */
+    readonly request: MindooDBAppInspectRequest;
+    /** Issues of a full inspection; none for an inspection of another contract. */
+    check(inspection: MindooDBAppInspectionBase | null | undefined): MindooDBAppIssue[];
+    /** The same rules on a root document's summary (`inspection` field); none without one. */
+    checkRoot(root: Readonly<Record<string, unknown>> | null | undefined): MindooDBAppIssue[];
+    /** A ready `embed.onBeforeSave` handler. */
+    beforeSave(input: {
+        inspection: MindooDBAppInspectionBase | null;
+    }): {
+        issues: MindooDBAppIssue[];
+    };
+    /** Checks every save of this embed; returns the function that stops it. */
+    attach(embed: {
+        onBeforeSave(handler: (input: {
+            inspection: MindooDBAppInspectionBase | null;
+        }) => {
+            issues: MindooDBAppIssue[];
+        }, options?: {
+            inspect?: MindooDBAppInspectRequest;
+        }): () => void;
+    }): () => void;
+}
+/**
+ * Rules a host applies to a component's document, before a save (on the full
+ * inspection) and when reading (on the root's summary):
+ *
+ * ```ts
+ * const rules = defineDocumentRules<MindooDBAppDocumentInspection>({
+ *   contract: MINDOODB_INSPECT_DOCUMENT,
+ *   rules: [mindooDBAppInspectRules.noOpenPlaceholders(), mindooDBAppInspectRules.noOpenTrackedChanges("warning")],
+ * });
+ * rules.attach(embed);
+ * const issues = rules.checkRoot(document.data);
+ * ```
+ *
+ * The summary is shortened, so rules that look at text or long lists may see
+ * less on it than on the full inspection; counts are always exact.
+ */
+declare function defineDocumentRules<T extends MindooDBAppInspectionBase = MindooDBAppInspection>(definition: {
+    /** Only inspections of this contract are checked. */
+    contract?: string;
+    include?: string[];
+    cells?: string[];
+    maxTextLength?: number;
+    rules: Array<MindooDBAppDocumentRule<T>>;
+}): MindooDBAppDocumentRules;
+/** Common rules for {@link defineDocumentRules}; pass `message` to word them yourself. */
+declare const mindooDBAppInspectRules: {
+    /** Documents: no placeholder or MERGEFIELD left open. */
+    noOpenPlaceholders(severity?: MindooDBAppIssueSeverity, message?: (names: string[]) => string): MindooDBAppDocumentRule<MindooDBAppDocumentInspection>;
+    /** Documents: every comment resolved. */
+    noOpenComments(severity?: MindooDBAppIssueSeverity, message?: (count: number) => string): MindooDBAppDocumentRule<MindooDBAppDocumentInspection>;
+    /** Documents: every tracked change accepted or rejected. */
+    noOpenTrackedChanges(severity?: MindooDBAppIssueSeverity, message?: (count: number) => string): MindooDBAppDocumentRule<MindooDBAppDocumentInspection>;
+    /** Spreadsheets: no formula evaluates to an error; one issue per cell. */
+    noFormulaErrors(severity?: MindooDBAppIssueSeverity): MindooDBAppDocumentRule<MindooDBAppSpreadsheetInspection>;
+    /** Presentations: no layout placeholder left empty; one issue per slide. */
+    noEmptySlidePlaceholders(severity?: MindooDBAppIssueSeverity): MindooDBAppDocumentRule<MindooDBAppSlidesInspection>;
+};
+/**
+ * How Haven turns a host's answer into the component's `validate` result: an error
+ * stops the save, warnings stop it unless the user confirms (`confirm`), or
+ * nothing asks (`interactive: false`).
+ */
+declare function resolveMindooDBAppEmbedValidation(issues: MindooDBAppIssue[], interactive: boolean, confirm: (warnings: MindooDBAppIssue[]) => boolean | Promise<boolean>): Promise<MindooDBAppEmbedValidation>;
+
+/**
+ * What a host hands to an embedded component and gets back, beyond the document:
+ *
+ * - **Variables** (`embeds.open({ variables })`, `embed.setVariables`): named values
+ *   the user can insert as fields ("Insert field ▸"), e.g. a contact's name and
+ *   address. Word keeps them as MERGEFIELDs, text editors as `{{key}}`. Components
+ *   that offer this declare `supports: ["variables"]`.
+ * - **Templates** (`embeds.open({ template })`): a new document starts as a copy of
+ *   another one; the component copies it (it knows its format). `supports: ["template"]`.
+ * - **Export** (`embed.export({ format })`): the document as a file, e.g. a PDF to
+ *   file with the record or a PNG preview. `supports: ["export:pdf", "export:png"]`.
+ */
+/** A value a host offers to insert, e.g. `{ key: "company.name", label: "Company", value: "Müller GmbH" }`. */
+interface MindooDBAppEmbedVariable {
+    /** Stable name: letters, digits, `_` and `.`; how fields refer to it (`{{company.name}}`, `MERGEFIELD company.name`). */
+    key: string;
+    /** For the user, in their language. */
+    label: string;
+    /** The current value; `""` when the host has none (the field stays visible as a field). */
+    value: string;
+    /** For grouping in menus, e.g. "Company" or "Contact person". */
+    group?: string;
+}
+declare const MINDOODB_APP_EMBED_VARIABLES_MAX = 200;
+/**
+ * Variables as they may cross between apps: valid keys only, each once (the last
+ * wins), texts shortened, at most {@link MINDOODB_APP_EMBED_VARIABLES_MAX}.
+ */
+declare function normalizeMindooDBAppEmbedVariables(raw: unknown): MindooDBAppEmbedVariable[];
+/**
+ * `{{key}}` placeholders in `text` replaced by the variables' values; unknown keys
+ * (and keys whose value is empty, unless `keepEmpty`) stay as they are.
+ */
+declare function resolveMindooDBAppVariables(text: string, variables: readonly MindooDBAppEmbedVariable[], options?: {
+    keepEmpty?: boolean;
+}): string;
+/** A template for `embeds.open`: the document a new one starts as a copy of. */
+interface MindooDBAppEmbedTemplate {
+    /** Host database that holds the template; default the database of the new document. */
+    databaseId?: string;
+    docId: string;
+}
+/** Formats `embed.export` knows by name; components may offer others (`export:<format>`). */
+type MindooDBAppEmbedExportFormat = "pdf" | "docx" | "xlsx" | "pptx" | "png" | "md" | "csv" | (string & {});
+/** What a host asks `embed.export` for. */
+interface MindooDBAppEmbedExportRequest {
+    format: MindooDBAppEmbedExportFormat;
+    /** `png`: the largest width and height in CSS pixels (a preview); the component keeps the aspect ratio. */
+    maxWidth?: number;
+    maxHeight?: number;
+}
+/** What a component's export provider returns: the file, or the bytes with name and type. */
+type MindooDBAppEmbeddingExport = Blob | {
+    data: Blob | ArrayBuffer | Uint8Array;
+    name?: string;
+    mimeType?: string;
+};
+/** The export as it crosses between apps (Haven forwards it unchanged). */
+interface MindooDBAppEmbedExportPayload {
+    data: ArrayBuffer;
+    name: string;
+    mimeType: string;
+}
+/** Exports larger than this are refused. */
+declare const MINDOODB_APP_EMBED_EXPORT_MAX_BYTES: number;
+/** The media type a format stands for (`application/octet-stream` for unknown ones). */
+declare function mindooDBAppExportMimeType(format: string): string;
+/** An export request as it may cross between apps. Throws without a usable format. */
+declare function normalizeMindooDBAppEmbedExportRequest(raw: unknown): MindooDBAppEmbedExportRequest;
+/** A provider's result as a payload: bytes, a name with the format's extension, the media type. */
+declare function mindooDBAppExportPayload(result: MindooDBAppEmbeddingExport, request: MindooDBAppEmbedExportRequest, baseName?: string): Promise<MindooDBAppEmbedExportPayload>;
+/** The payload as a `File` for the host. */
+declare function mindooDBAppExportFile(payload: MindooDBAppEmbedExportPayload): File;
+
 /** Launch target used by the Haven when opening an app. */
 type MindooDBAppRuntime = "iframe" | "window";
 /**
@@ -628,6 +1059,15 @@ interface MindooDBAppEmbedContext {
         /** Opening other documents. Always false: the sandbox only holds this one. */
         open: boolean;
     };
+    /**
+     * Set when the host wants the new document to start as a copy of a template
+     * (`embeds.open({ template })`): the template's root document id in the sandbox.
+     * It and its children are there to read only; copy them into `docId` while it is
+     * still empty. Absent otherwise.
+     */
+    template?: {
+        docId: string;
+    };
 }
 /** Attachment metadata returned by the attachment APIs. */
 interface MindooDBAppAttachmentInfo {
@@ -1912,12 +2352,20 @@ interface MindooDBAppComponentInfo {
     provides?: MindooDBAppComponentContract[];
     /** Fields of its root documents that point at other root documents. */
     references?: MindooDBAppComponentReference[];
+    /** What it can do beyond showing the document, e.g. `inspect:mindoo.inspect.document@1`, `validate`. */
+    supports?: string[];
 }
 /** Filter for `session.components.list`. */
 interface MindooDBAppComponentQuery {
     intent?: MindooDBAppComponentIntent;
     /** Only components whose `match` fits these root document fields. */
     document?: Record<string, unknown>;
+    /**
+     * Only components that support all of these (`supports` in their haven-app.json):
+     * `inspect` matches any `inspect:…` entry, `inspect:mindoo.inspect.document@1`
+     * only that contract.
+     */
+    requires?: string[];
 }
 /** Rectangle in the host app's viewport, CSS pixels. */
 type MindooDBAppEmbedRect = MindooDBAppMenuRect;
@@ -1949,6 +2397,19 @@ interface MindooDBAppEmbedOpenInput {
     rect?: MindooDBAppEmbedRect;
     /** Default true. */
     visible?: boolean;
+    /**
+     * Values the user can insert as fields, e.g. the linked contact's name and address
+     * (components with `supports: ["variables"]`). Change them later with
+     * `embed.setVariables`.
+     */
+    variables?: MindooDBAppEmbedVariable[];
+    /**
+     * Start the (new, empty) document as a copy of this one (components with
+     * `supports: ["template"]`). The template must match the component, and this app
+     * must be allowed to read its database. Haven hands it to the component to read;
+     * nothing is written back to it.
+     */
+    template?: MindooDBAppEmbedTemplate;
 }
 /** One component a host app wants to show, for `session.embeds.requestAccess`. */
 interface MindooDBAppEmbedAccessComponent {
@@ -2062,6 +2523,63 @@ interface MindooDBAppEmbed {
      * `timeoutMs` (default 10 s) or when the component closes.
      */
     waitForAgentTools(timeoutMs?: number): Promise<MindooDBAppEmbedAgentTools | null>;
+    /** What the component supports (`supports` in its haven-app.json); empty on older Havens. */
+    readonly supports: readonly string[];
+    /**
+     * Asks the component to describe its document (it must support `inspect:<contract>`),
+     * e.g. to show the open placeholders of a letter. Rejects with `unsupported` when it
+     * does not.
+     */
+    inspect<T extends MindooDBAppInspectionBase = MindooDBAppInspectionBase>(request?: MindooDBAppInspectRequest): Promise<T>;
+    /**
+     * Checks every save of the component before it happens (components that support
+     * `validate` ask before they save, `session.embedding.validate`). `handler` gets the
+     * component's inspection, asked for with `options.inspect` (null when the component
+     * cannot describe its document), plus the root document as saved last time, and
+     * answers with issues: an `error` stops the save, a `warning` makes Haven ask the
+     * user. Saves the user, this app (`save()`) or an agent start alike. Without an
+     * answer within about 5 s the component saves and the user is told. One handler at
+     * a time; returns the function that removes it.
+     */
+    onBeforeSave(handler: (input: MindooDBAppEmbedBeforeSaveInput) => MindooDBAppEmbedBeforeSaveResult | Promise<MindooDBAppEmbedBeforeSaveResult>, options?: {
+        inspect?: MindooDBAppInspectRequest;
+    }): () => void;
+    /** Called after the component saved (it reports that through `session.embedding.save`). */
+    onAfterSave(listener: (event: MindooDBAppEmbedSavedEvent) => void): () => void;
+    /** Shows issues in the component (it must support `issues`), e.g. after this app checked it. */
+    showIssues(issues: MindooDBAppIssue[]): Promise<void>;
+    /** Scrolls the component to a place in its document (it must support `reveal`). */
+    reveal(anchor: MindooDBAppInspectAnchor): Promise<void>;
+    /**
+     * Runs one of the component's document agent tools (`scope: "document"`), e.g.
+     * `text_insert`, with or without its prefix. For what the other methods do not
+     * cover; agent tools need not be switched on. Resolves with the tool's result.
+     */
+    callTool(name: string, input?: Record<string, unknown>): Promise<unknown>;
+    /** Replaces the values the user can insert as fields (`supports: ["variables"]`). */
+    setVariables(variables: MindooDBAppEmbedVariable[]): Promise<void>;
+    /**
+     * The document as a file in `format` (the component must support `export:<format>`),
+     * e.g. a PDF to keep with the record or a PNG preview. Edits the component has not
+     * saved yet are included as it shows them.
+     */
+    export(request: MindooDBAppEmbedExportRequest): Promise<File>;
+}
+/** What an `embed.onBeforeSave` handler gets. */
+interface MindooDBAppEmbedBeforeSaveInput {
+    embedId: string;
+    /** The component's description of the document as it is about to be saved; null if it has none. */
+    inspection: MindooDBAppInspectionBase | null;
+    /** The root document's fields as last saved (large fields may be missing). */
+    root: Record<string, unknown> | null;
+}
+/** What an `embed.onBeforeSave` handler answers. */
+interface MindooDBAppEmbedBeforeSaveResult {
+    issues: MindooDBAppIssue[];
+}
+/** Pushed after an embedded component saved. */
+interface MindooDBAppEmbedSavedEvent {
+    embedId: string;
 }
 /** The agent tools of an embedded component, as its host sees them. */
 interface MindooDBAppEmbedAgentTools {
@@ -2135,6 +2653,60 @@ interface MindooDBAppEmbeddingApi {
      * 20, max 100) results.
      */
     lookup(field: string, options?: MindooDBAppEmbeddingLookupOptions): Promise<MindooDBAppEmbeddingLookupResult[]>;
+    /**
+     * Describes the document when the host asks (`embed.inspect`, its save checks),
+     * following one of the contracts in `supports` (`inspect:<contract>`). Also used
+     * by `save` for the root summary. One provider at a time; returns the unregister
+     * function.
+     */
+    provideInspection(provider: (request: MindooDBAppInspectRequest) => MindooDBAppInspectionBase | Promise<MindooDBAppInspectionBase>): () => void;
+    /**
+     * Lets the host check the document before this component saves it: Haven asks the
+     * host's `onBeforeSave` (with this app's inspection) and, for warnings, the user
+     * (unless `interactive: false`, e.g. for an agent's save; then warnings do not
+     * stop it). Resolves `ok: true` right away when not embedded or the host has no
+     * checks. Prefer {@link save}, which also writes the root summary.
+     */
+    validate(options?: {
+        interactive?: boolean;
+    }): Promise<MindooDBAppEmbedValidation>;
+    /**
+     * Saving with the host's checks: `validate`, then `flush` (write the pending
+     * changes; put `context.inspection` into the root's `inspection` field when it is
+     * set), then tells the host it saved. Throws a `MindooDBAppEmbedValidationError`
+     * without calling `flush` when the checks stopped it, after passing the issues to
+     * the `onShowIssues` handler. Works the same standalone, without checks.
+     */
+    save(flush: (context: MindooDBAppEmbeddingSaveContext) => void | Promise<void>, options?: {
+        interactive?: boolean;
+    }): Promise<MindooDBAppEmbedValidation>;
+    /** Shows the host's issues (`embed.showIssues`, and failed saves). Returns the unregister function. */
+    onShowIssues(handler: (issues: MindooDBAppIssue[]) => void | Promise<void>): () => void;
+    /** Scrolls to a place in the document (`embed.reveal`). Returns the unregister function. */
+    onReveal(handler: (anchor: MindooDBAppInspectAnchor) => void | Promise<void>): () => void;
+    /**
+     * The values the host offers to insert as fields (`embeds.open({ variables })`);
+     * empty when it offers none, when not embedded, and on older Havens.
+     */
+    getVariables(): Promise<MindooDBAppEmbedVariable[]>;
+    /** Called with the new list whenever the host changes it (`embed.setVariables`). */
+    onVariablesChange(listener: (variables: MindooDBAppEmbedVariable[]) => void): () => void;
+    /**
+     * Hands the document over as a file when the host asks (`embed.export`), in one of
+     * the formats in `supports` (`export:<format>`). Throw for a format you do not
+     * offer. One provider at a time; returns the unregister function.
+     */
+    provideExport(provider: (request: MindooDBAppEmbedExportRequest) => MindooDBAppEmbeddingExport | Promise<MindooDBAppEmbeddingExport>): () => void;
+}
+/** What `session.embedding.save` hands to `flush`. */
+interface MindooDBAppEmbeddingSaveContext {
+    /**
+     * The summary of this app's inspection (see `provideInspection`), ready to write as
+     * the root's `inspection` field; null without a provider.
+     */
+    inspection: MindooDBAppAtomicValue | null;
+    /** What the host's checks found but let pass (warnings the user confirmed, infos). */
+    issues: MindooDBAppIssue[];
 }
 interface MindooDBAppEmbeddingLookupOptions {
     query?: string;
@@ -2147,12 +2719,32 @@ interface MindooDBAppEmbeddingLookupResult {
     /** The reference's `show` fields the document has. */
     fields: Record<string, unknown>;
 }
-/** Haven → component: the host asked for something (`embed.save()`). */
+/**
+ * Haven → component: the host asked for something (`embed.save()`, `embed.inspect()`,
+ * …). The component answers with `embedding.respond`.
+ */
 interface MindooDBAppBridgeEmbeddingRequestMessage {
     protocol: "mindoodb-app-bridge";
     kind: "embedding-request";
     requestId: string;
-    request: "save";
+    request: "save" | "inspect" | "showIssues" | "reveal" | "variables" | "export";
+    /**
+     * `inspect`: `{ request }`, `showIssues`: `{ issues }`, `reveal`: `{ anchor }`,
+     * `variables`: `{ variables }`, `export`: `{ request }`.
+     */
+    params?: Record<string, unknown>;
+}
+/** Haven → host: a question about an embed the host has to answer (`embeds.respond`). */
+interface MindooDBAppBridgeEmbedRequestMessage {
+    protocol: "mindoodb-app-bridge";
+    kind: "embed-request";
+    requestId: string;
+    embedId: string;
+    request: "beforeSave";
+    params: {
+        inspection: MindooDBAppInspectionBase | null;
+        root: Record<string, unknown> | null;
+    };
 }
 /** The component reported whether it has unsaved changes. */
 interface MindooDBAppEmbedDirtyEvent {
@@ -2169,9 +2761,11 @@ interface MindooDBAppBridgeEmbedEventMessage {
         type: "dirty";
     } & MindooDBAppEmbedDirtyEvent) | ({
         type: "agentTools";
-    } & MindooDBAppEmbedAgentToolsEvent);
+    } & MindooDBAppEmbedAgentToolsEvent) | ({
+        type: "saved";
+    } & MindooDBAppEmbedSavedEvent);
 }
-type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage | MindooDBAppBridgeLocaleChangedMessage | MindooDBAppBridgeQueryResultMessage | MindooDBAppBridgeViewChangedMessage | MindooDBAppBridgeBeforeCloseMessage | MindooDBAppBridgeBeforeCloseAck | MindooDBAppBridgeShortcutsChangedMessage | MindooDBAppBridgeShortcutInvokedMessage | MindooDBAppBridgeWorkspaceFocusRequestedMessage | MindooDBAppBridgeHostFocusChangedMessage | MindooDBAppBridgeAgentInvokeMessage | MindooDBAppBridgeAgentResultMessage | MindooDBAppBridgeDragOverMessage | MindooDBAppBridgeDragLeaveMessage | MindooDBAppBridgeDragDropMessage | MindooDBAppBridgeIncomingContentMessage | MindooDBAppBridgeReminderOpenedMessage | MindooDBAppBridgeEmbedEventMessage | MindooDBAppBridgeEmbeddingRequestMessage;
+type MindooDBAppBridgePortMessage = MindooDBAppBridgeRpcMessage | MindooDBAppBridgeStreamMessage | MindooDBAppBridgeThemeChangedMessage | MindooDBAppBridgeViewportChangedMessage | MindooDBAppBridgeUiPreferencesChangedMessage | MindooDBAppBridgeLocaleChangedMessage | MindooDBAppBridgeQueryResultMessage | MindooDBAppBridgeViewChangedMessage | MindooDBAppBridgeBeforeCloseMessage | MindooDBAppBridgeBeforeCloseAck | MindooDBAppBridgeShortcutsChangedMessage | MindooDBAppBridgeShortcutInvokedMessage | MindooDBAppBridgeWorkspaceFocusRequestedMessage | MindooDBAppBridgeHostFocusChangedMessage | MindooDBAppBridgeAgentInvokeMessage | MindooDBAppBridgeAgentResultMessage | MindooDBAppBridgeDragOverMessage | MindooDBAppBridgeDragLeaveMessage | MindooDBAppBridgeDragDropMessage | MindooDBAppBridgeIncomingContentMessage | MindooDBAppBridgeReminderOpenedMessage | MindooDBAppBridgeEmbedEventMessage | MindooDBAppBridgeEmbedRequestMessage | MindooDBAppBridgeEmbeddingRequestMessage;
 /** Placement hint for a host-rendered overlay menu. */
 type MindooDBAppMenuPlacement = "auto" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "right-start" | "left-start";
 /** Semantic hint allowing Haven to tune menu behavior or styling. */
@@ -3882,4 +4476,4 @@ interface MindooDBAppBridge {
     connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
 }
 
-export { type MindooDBAppAttachmentPreviewSession as $, MINDOODB_APP_COMPONENTS_MAX as A, MINDOODB_APP_COMPONENT_CONTRACT_PATTERN as B, MINDOODB_APP_DEFINITION_FILE_NAME as C, MINDOODB_APP_DEFINITION_FORMAT as D, MINDOODB_APP_DEFINITION_PERMISSIONS as E, MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS as F, MINDOODB_APP_DEFINITION_VERSION as G, MINDOODB_APP_LISTING_DESCRIPTION_MAX as H, MINDOODB_APP_LISTING_MAX_SCREENSHOTS as I, MINDOODB_APP_LISTING_SUMMARY_MAX as J, MINDOODB_APP_SEAL_SIGNING_DOMAIN as K, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppAcceptSpec as N, type MindooDBAppAccessDecision as O, type MindooDBAppAccessTier as P, type MindooDBAppAgentApi as Q, type MindooDBAppAgentCapability as R, type MindooDBAppAgentProfile as S, type MindooDBAppAgentRegistration as T, type MindooDBAppAgentToolAnnotations as U, type MindooDBAppAgentToolDescriptor as V, type MindooDBAppAgentToolScope as W, type MindooDBAppAttachmentApi as X, type MindooDBAppAttachmentChunk as Y, type MindooDBAppAttachmentInfo as Z, type MindooDBAppAttachmentPreviewOptions as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppConfiguredViewFilterRule as a$, type MindooDBAppAutomergeChangesPatch as a0, type MindooDBAppAutomergeChangesSince as a1, type MindooDBAppAutomergeGetOptions as a2, type MindooDBAppAutomergePatchResult as a3, type MindooDBAppAutomergeSnapshot as a4, type MindooDBAppBridgeAgentInvokeMessage as a5, type MindooDBAppBridgeAgentResultMessage as a6, type MindooDBAppBridgeBeforeCloseAck as a7, type MindooDBAppBridgeBeforeCloseMessage as a8, type MindooDBAppBridgeConnectMessage as a9, type MindooDBAppBridgeStreamOpenResult as aA, type MindooDBAppBridgeStreamReadRequest as aB, type MindooDBAppBridgeStreamWriteRequest as aC, type MindooDBAppBridgeThemeChangedMessage as aD, type MindooDBAppBridgeUiPreferencesChangedMessage as aE, type MindooDBAppBridgeViewChangedMessage as aF, type MindooDBAppBridgeViewportChangedMessage as aG, type MindooDBAppBridgeWorkspaceFocusRequestedMessage as aH, type MindooDBAppBrowserFeatures as aI, type MindooDBAppCapability as aJ, type MindooDBAppComponentCategory as aK, type MindooDBAppComponentChildren as aL, type MindooDBAppComponentContract as aM, type MindooDBAppComponentFieldValue as aN, type MindooDBAppComponentInfo as aO, type MindooDBAppComponentIntent as aP, type MindooDBAppComponentQuery as aQ, type MindooDBAppComponentReference as aR, type MindooDBAppComponentSpec as aS, type MindooDBAppComponentsApi as aT, type MindooDBAppConfiguredViewCategorizationStyle as aU, type MindooDBAppConfiguredViewColumn as aV, type MindooDBAppConfiguredViewColumnRole as aW, type MindooDBAppConfiguredViewExpressionMode as aX, type MindooDBAppConfiguredViewFieldExpression as aY, type MindooDBAppConfiguredViewFilterDefinition as aZ, type MindooDBAppConfiguredViewFilterMode as a_, type MindooDBAppBridgeConnectOptions as aa, type MindooDBAppBridgeConnectedMessage as ab, type MindooDBAppBridgeDragDropMessage as ac, type MindooDBAppBridgeDragLeaveMessage as ad, type MindooDBAppBridgeDragOverMessage as ae, type MindooDBAppBridgeEmbedEventMessage as af, type MindooDBAppBridgeEmbeddingRequestMessage as ag, type MindooDBAppBridgeErrorPayload as ah, type MindooDBAppBridgeHandshakeErrorMessage as ai, type MindooDBAppBridgeHostFocusChangedMessage as aj, type MindooDBAppBridgeIncomingContentMessage as ak, type MindooDBAppBridgeLocaleChangedMessage as al, type MindooDBAppBridgePortMessage as am, type MindooDBAppBridgeQueryResultMessage as an, type MindooDBAppBridgeReminderOpenedMessage as ao, type MindooDBAppBridgeRpcError as ap, type MindooDBAppBridgeRpcMessage as aq, type MindooDBAppBridgeRpcRequest as ar, type MindooDBAppBridgeRpcSuccess as as, type MindooDBAppBridgeShortcutInvokedMessage as at, type MindooDBAppBridgeShortcutsChangedMessage as au, type MindooDBAppBridgeStreamAbortRequest as av, type MindooDBAppBridgeStreamAck as aw, type MindooDBAppBridgeStreamCloseRequest as ax, type MindooDBAppBridgeStreamError as ay, type MindooDBAppBridgeStreamMessage as az, type MindooDBAppDragStartInput as b, type MindooDBAppHostTheme as b$, type MindooDBAppConfiguredViewFormulaExpression as b0, type MindooDBAppConfiguredViewFormulaFilterDefinition as b1, type MindooDBAppConfiguredViewPreviewMode as b2, type MindooDBAppConfiguredViewRuleFilterDefinition as b3, type MindooDBAppConfiguredViewRuleMatchMode as b4, type MindooDBAppConfiguredViewRuleOperator as b5, type MindooDBAppConfiguredViewValueExpression as b6, type MindooDBAppCreateKeyInfo as b7, type MindooDBAppCreateViewInput as b8, type MindooDBAppCreateViewNavigatorInput as b9, type MindooDBAppDragProfile as bA, type MindooDBAppEmbed as bB, type MindooDBAppEmbedAccessComponent as bC, type MindooDBAppEmbedAccessInput as bD, type MindooDBAppEmbedAccessPair as bE, type MindooDBAppEmbedAccessResult as bF, type MindooDBAppEmbedAgentTools as bG, type MindooDBAppEmbedAgentToolsEvent as bH, type MindooDBAppEmbedCloseReason as bI, type MindooDBAppEmbedClosedEvent as bJ, type MindooDBAppEmbedContext as bK, type MindooDBAppEmbedDirtyEvent as bL, type MindooDBAppEmbedOpenInput as bM, type MindooDBAppEmbedRect as bN, type MindooDBAppEmbeddingApi as bO, type MindooDBAppEmbeddingLookupOptions as bP, type MindooDBAppEmbeddingLookupResult as bQ, type MindooDBAppEmbedsApi as bR, type MindooDBAppEntryAttachmentRef as bS, type MindooDBAppEntryProvenance as bT, type MindooDBAppExtractDocumentTextInput as bU, type MindooDBAppExtractDocumentTextResult as bV, type MindooDBAppExtractTextFormat as bW, type MindooDBAppExtractionSetup as bX, type MindooDBAppFulltextSetup as bY, type MindooDBAppHistoricalDocument as bZ, type MindooDBAppHistoryQuery as b_, type MindooDBAppDatabaseInfo as ba, type MindooDBAppDefinitionDatabase as bb, type MindooDBAppDefinitionListing as bc, type MindooDBAppDefinitionPermission as bd, type MindooDBAppDefinitionRegistrationPermission as be, type MindooDBAppDefinitionScreenshot as bf, type MindooDBAppDefinitionValidation as bg, type MindooDBAppDirectoryApi as bh, type MindooDBAppDirectoryEntry as bi, type MindooDBAppDocumentApi as bj, type MindooDBAppDocumentHeadCursorResult as bk, type MindooDBAppDocumentHistoryEntry as bl, type MindooDBAppDocumentListQuery as bm, type MindooDBAppDocumentListResult as bn, type MindooDBAppDocumentQuery as bo, type MindooDBAppDocumentRevisionId as bp, type MindooDBAppDocumentScanPreset as bq, type MindooDBAppDocumentSummary as br, type MindooDBAppDragApi as bs, type MindooDBAppDragCancelReason as bt, type MindooDBAppDragDropEvent as bu, type MindooDBAppDragEffect as bv, type MindooDBAppDragHoverResult as bw, type MindooDBAppDragOffer as bx, type MindooDBAppDragOverEvent as by, type MindooDBAppDragPointer as bz, type MindooDBAppDragStartResult as c, type MindooDBAppReminderScheduleResult as c$, type MindooDBAppIdentityApi as c0, type MindooDBAppInaccessibleDocument as c1, type MindooDBAppInaccessibleDocumentListQuery as c2, type MindooDBAppInaccessibleDocumentListResult as c3, type MindooDBAppIncomingContent as c4, type MindooDBAppIncomingContentHandler as c5, type MindooDBAppIncomingContentInfo as c6, type MindooDBAppIncomingItem as c7, type MindooDBAppIncomingItemInfo as c8, type MindooDBAppIncomingResult as c9, type MindooDBAppMenuRectAnchor as cA, type MindooDBAppMenuSelectionResult as cB, type MindooDBAppMenuSeparatorItem as cC, type MindooDBAppNotificationSeverity as cD, type MindooDBAppNotifyInput as cE, type MindooDBAppNotifyResult as cF, type MindooDBAppPdfApi as cG, type MindooDBAppPdfSignInput as cH, type MindooDBAppPdfSignResult as cI, type MindooDBAppPdfSignaturePosition as cJ, type MindooDBAppPdfSigner as cK, type MindooDBAppProposeAppInput as cL, type MindooDBAppProposeAppResult as cM, type MindooDBAppQueryCoverage as cN, type MindooDBAppQueryInclude as cO, type MindooDBAppQueryIncludeCardinality as cP, type MindooDBAppQueryIncludeSlots as cQ, type MindooDBAppQueryResult as cR, type MindooDBAppQueryRow as cS, type MindooDBAppQuerySortKey as cT, type MindooDBAppQueryTextClause as cU, type MindooDBAppReadableAttachmentStream as cV, type MindooDBAppRecipientOptions as cW, type MindooDBAppReminder as cX, type MindooDBAppReminderOpened as cY, type MindooDBAppReminderOpenedHandler as cZ, type MindooDBAppReminderRequest as c_, type MindooDBAppIncomingSource as ca, type MindooDBAppJsonCounterIncrementPatch as cb, type MindooDBAppJsonListDeletePatch as cc, type MindooDBAppJsonListInsertPatch as cd, type MindooDBAppJsonPatch as ce, type MindooDBAppJsonSetPatch as cf, type MindooDBAppJsonTextMarkPatch as cg, type MindooDBAppJsonTextSplicePatch as ch, type MindooDBAppJsonTextUnmarkPatch as ci, type MindooDBAppJsonUnsetPatch as cj, type MindooDBAppLaunchContext as ck, type MindooDBAppListUsersOptions as cl, type MindooDBAppListUsersPage as cm, type MindooDBAppLiveQuerySubscription as cn, type MindooDBAppLocaleMap as co, type MindooDBAppLocalizedText as cp, type MindooDBAppMenuAnchor as cq, type MindooDBAppMenuApi as cr, type MindooDBAppMenuCommandItem as cs, type MindooDBAppMenuDismissReason as ct, type MindooDBAppMenuDismissedResult as cu, type MindooDBAppMenuItem as cv, type MindooDBAppMenuKind as cw, type MindooDBAppMenuPlacement as cx, type MindooDBAppMenuPointAnchor as cy, type MindooDBAppMenuRect as cz, type MindooDBAppDragPreview as d, mindooDBAppAcceptMatchesType as d$, type MindooDBAppRemindersApi as d0, type MindooDBAppResolvedViewDefinition as d1, type MindooDBAppResolvedViewSource as d2, type MindooDBAppRevisionPhase as d3, type MindooDBAppRevisionVerification as d4, type MindooDBAppRichTextBlockSpan as d5, type MindooDBAppRichTextGetOptions as d6, type MindooDBAppRichTextImmutableString as d7, type MindooDBAppRichTextMarkRange as d8, type MindooDBAppRichTextMaterializeValue as d9, type MindooDBAppTextCursorPosition as dA, type MindooDBAppTextCursorPositionsResult as dB, type MindooDBAppTextCursorsResult as dC, type MindooDBAppTextEdit as dD, type MindooDBAppTextPatch as dE, type MindooDBAppThemeMode as dF, type MindooDBAppTimestampApi as dG, type MindooDBAppTimestampInput as dH, type MindooDBAppTimestampProvider as dI, type MindooDBAppTimestampResult as dJ, type MindooDBAppUiPreferences as dK, type MindooDBAppUpdateDocumentInput as dL, type MindooDBAppViewCursorDocumentListResult as dM, type MindooDBAppViewCursorResult as dN, type MindooDBAppViewEntry as dO, type MindooDBAppViewEntryKind as dP, type MindooDBAppViewNavigator as dQ, type MindooDBAppViewNavigatorExpansionState as dR, type MindooDBAppViewNavigatorOpenOptions as dS, type MindooDBAppViewNavigatorPageOptions as dT, type MindooDBAppViewNavigatorPageResult as dU, type MindooDBAppViewNavigatorRangeQuery as dV, type MindooDBAppViewNavigatorSelectionState as dW, type MindooDBAppViewUpdateStats as dX, type MindooDBAppViewport as dY, type MindooDBAppWellKnownDragType as dZ, type MindooDBAppWritableAttachmentStream as d_, type MindooDBAppRichTextPatch as da, type MindooDBAppRichTextScalar as db, type MindooDBAppRichTextSpliceStep as dc, type MindooDBAppRichTextStep as dd, type MindooDBAppRichTextStepPatch as de, type MindooDBAppRichTextTextSpan as df, type MindooDBAppRuntime as dg, type MindooDBAppScanAttachmentOptions as dh, type MindooDBAppScanAttachmentResult as di, type MindooDBAppScopedDocId as dj, type MindooDBAppScopedDocumentSummary as dk, type MindooDBAppSealIntent as dl, type MindooDBAppSealedChannelOpenInput as dm, type MindooDBAppSealedChannelOpenResult as dn, type MindooDBAppSealedChannelRequestInput as dp, type MindooDBAppSession as dq, type MindooDBAppShowMenuInput as dr, type MindooDBAppShowMenuResult as ds, type MindooDBAppSignPreview as dt, type MindooDBAppSignPreviewScope as du, type MindooDBAppSignStatementInput as dv, type MindooDBAppSignStatementResult as dw, type MindooDBAppStorageApi as dx, type MindooDBAppSummarySetup as dy, type MindooDBAppTextCursorOptions as dz, type MindooDBAppBridge as e, mindooDBAppComponentFieldsMatch as e0, resolveMindooDBAppDefinitionUrl as e1, resolveMindooDBAppListingAssetUrl as e2, resolveMindooDBAppLocalizedText as e3, validateMindooDBAppAccepts as e4, validateMindooDBAppAgentProfile as e5, validateMindooDBAppComponents as e6, validateMindooDBAppDefinition as e7, type MindooDBAppAgentToolErrorCode as f, type MindooDBAppAgentTool as g, type MindooDBAppHostShortcutBinding as h, type MindooDBAppHostShortcutAction as i, type MindooDBAppHostingMode as j, type MindooDBAppDefinition as k, type MindooDBAppDatabase as l, type MindooDBAppDocument as m, type MindooDBAppRichTextSpan as n, type MindooDBAppRichTextSnapshot as o, type MindooDBAppCreateDocumentInput as p, MINDOODB_APP_ACCEPTS_MAX as q, MINDOODB_APP_AGENT_CAPABILITIES_MAX as r, MINDOODB_APP_AGENT_CAPABILITY_TITLE_MAX as s, MINDOODB_APP_AGENT_CAPABILITY_TOOLS_MAX as t, MINDOODB_APP_AGENT_EXAMPLE_MAX as u, MINDOODB_APP_AGENT_GUIDE_MAX_BYTES as v, MINDOODB_APP_AGENT_LIMIT_MAX as w, MINDOODB_APP_AGENT_LIST_MAX as x, MINDOODB_APP_AGENT_SUMMARY_MAX as y, MINDOODB_APP_AGENT_TOOL_NAME_PATTERN as z };
+export { type MindooDBAppAgentCapability as $, MINDOODB_APP_COMPONENTS_MAX as A, MINDOODB_APP_COMPONENT_CONTRACT_PATTERN as B, MINDOODB_APP_DEFINITION_FILE_NAME as C, MINDOODB_APP_DEFINITION_FORMAT as D, MINDOODB_APP_DEFINITION_PERMISSIONS as E, MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS as F, MINDOODB_APP_DEFINITION_VERSION as G, MINDOODB_APP_EMBED_EXPORT_MAX_BYTES as H, MINDOODB_APP_EMBED_VARIABLES_MAX as I, MINDOODB_APP_INSPECTION_FIELD as J, MINDOODB_APP_INSPECTION_MAX_BYTES as K, MINDOODB_APP_INSPECTION_SUMMARY_MAX_BYTES as L, type MindooDBAppAttachmentPreviewMode as M, MINDOODB_APP_ISSUES_MAX as N, MINDOODB_APP_LISTING_DESCRIPTION_MAX as O, MINDOODB_APP_LISTING_MAX_SCREENSHOTS as P, MINDOODB_APP_LISTING_SUMMARY_MAX as Q, MINDOODB_APP_SEAL_SIGNING_DOMAIN as R, MINDOODB_APP_VALUE_TAG as S, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as T, MINDOODB_INSPECT_DOCUMENT as U, MINDOODB_INSPECT_SLIDES as V, MINDOODB_INSPECT_SPREADSHEET as W, type MindooDBAppAcceptSpec as X, type MindooDBAppAccessDecision as Y, type MindooDBAppAccessTier as Z, type MindooDBAppAgentApi as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppComponentIntent as a$, type MindooDBAppAgentProfile as a0, type MindooDBAppAgentRegistration as a1, type MindooDBAppAgentToolAnnotations as a2, type MindooDBAppAgentToolDescriptor as a3, type MindooDBAppAgentToolScope as a4, type MindooDBAppAtomicValue as a5, type MindooDBAppAttachmentApi as a6, type MindooDBAppAttachmentChunk as a7, type MindooDBAppAttachmentInfo as a8, type MindooDBAppAttachmentPreviewOptions as a9, type MindooDBAppBridgeReminderOpenedMessage as aA, type MindooDBAppBridgeRpcError as aB, type MindooDBAppBridgeRpcMessage as aC, type MindooDBAppBridgeRpcRequest as aD, type MindooDBAppBridgeRpcSuccess as aE, type MindooDBAppBridgeShortcutInvokedMessage as aF, type MindooDBAppBridgeShortcutsChangedMessage as aG, type MindooDBAppBridgeStreamAbortRequest as aH, type MindooDBAppBridgeStreamAck as aI, type MindooDBAppBridgeStreamCloseRequest as aJ, type MindooDBAppBridgeStreamError as aK, type MindooDBAppBridgeStreamMessage as aL, type MindooDBAppBridgeStreamOpenResult as aM, type MindooDBAppBridgeStreamReadRequest as aN, type MindooDBAppBridgeStreamWriteRequest as aO, type MindooDBAppBridgeThemeChangedMessage as aP, type MindooDBAppBridgeUiPreferencesChangedMessage as aQ, type MindooDBAppBridgeViewChangedMessage as aR, type MindooDBAppBridgeViewportChangedMessage as aS, type MindooDBAppBridgeWorkspaceFocusRequestedMessage as aT, type MindooDBAppBrowserFeatures as aU, type MindooDBAppCapability as aV, type MindooDBAppComponentCategory as aW, type MindooDBAppComponentChildren as aX, type MindooDBAppComponentContract as aY, type MindooDBAppComponentFieldValue as aZ, type MindooDBAppComponentInfo as a_, type MindooDBAppAttachmentPreviewSession as aa, type MindooDBAppAutomergeChangesPatch as ab, type MindooDBAppAutomergeChangesSince as ac, type MindooDBAppAutomergeGetOptions as ad, type MindooDBAppAutomergePatchResult as ae, type MindooDBAppAutomergeSnapshot as af, type MindooDBAppBridgeAgentInvokeMessage as ag, type MindooDBAppBridgeAgentResultMessage as ah, type MindooDBAppBridgeBeforeCloseAck as ai, type MindooDBAppBridgeBeforeCloseMessage as aj, type MindooDBAppBridgeConnectMessage as ak, type MindooDBAppBridgeConnectOptions as al, type MindooDBAppBridgeConnectedMessage as am, type MindooDBAppBridgeDragDropMessage as an, type MindooDBAppBridgeDragLeaveMessage as ao, type MindooDBAppBridgeDragOverMessage as ap, type MindooDBAppBridgeEmbedEventMessage as aq, type MindooDBAppBridgeEmbedRequestMessage as ar, type MindooDBAppBridgeEmbeddingRequestMessage as as, type MindooDBAppBridgeErrorPayload as at, type MindooDBAppBridgeHandshakeErrorMessage as au, type MindooDBAppBridgeHostFocusChangedMessage as av, type MindooDBAppBridgeIncomingContentMessage as aw, type MindooDBAppBridgeLocaleChangedMessage as ax, type MindooDBAppBridgePortMessage as ay, type MindooDBAppBridgeQueryResultMessage as az, type MindooDBAppDragStartInput as b, type MindooDBAppEmbedCloseReason as b$, type MindooDBAppComponentQuery as b0, type MindooDBAppComponentReference as b1, type MindooDBAppComponentSpec as b2, type MindooDBAppComponentsApi as b3, type MindooDBAppConfiguredViewCategorizationStyle as b4, type MindooDBAppConfiguredViewColumn as b5, type MindooDBAppConfiguredViewColumnRole as b6, type MindooDBAppConfiguredViewExpressionMode as b7, type MindooDBAppConfiguredViewFieldExpression as b8, type MindooDBAppConfiguredViewFilterDefinition as b9, type MindooDBAppDocumentListQuery as bA, type MindooDBAppDocumentListResult as bB, type MindooDBAppDocumentQuery as bC, type MindooDBAppDocumentRevisionId as bD, type MindooDBAppDocumentRule as bE, type MindooDBAppDocumentRuleOutcome as bF, type MindooDBAppDocumentRules as bG, type MindooDBAppDocumentScanPreset as bH, type MindooDBAppDocumentSummary as bI, type MindooDBAppDragApi as bJ, type MindooDBAppDragCancelReason as bK, type MindooDBAppDragDropEvent as bL, type MindooDBAppDragEffect as bM, type MindooDBAppDragHoverResult as bN, type MindooDBAppDragOffer as bO, type MindooDBAppDragOverEvent as bP, type MindooDBAppDragPointer as bQ, type MindooDBAppDragProfile as bR, type MindooDBAppEmbed as bS, type MindooDBAppEmbedAccessComponent as bT, type MindooDBAppEmbedAccessInput as bU, type MindooDBAppEmbedAccessPair as bV, type MindooDBAppEmbedAccessResult as bW, type MindooDBAppEmbedAgentTools as bX, type MindooDBAppEmbedAgentToolsEvent as bY, type MindooDBAppEmbedBeforeSaveInput as bZ, type MindooDBAppEmbedBeforeSaveResult as b_, type MindooDBAppConfiguredViewFilterMode as ba, type MindooDBAppConfiguredViewFilterRule as bb, type MindooDBAppConfiguredViewFormulaExpression as bc, type MindooDBAppConfiguredViewFormulaFilterDefinition as bd, type MindooDBAppConfiguredViewPreviewMode as be, type MindooDBAppConfiguredViewRuleFilterDefinition as bf, type MindooDBAppConfiguredViewRuleMatchMode as bg, type MindooDBAppConfiguredViewRuleOperator as bh, type MindooDBAppConfiguredViewValueExpression as bi, type MindooDBAppCounterValue as bj, type MindooDBAppCreateKeyInfo as bk, type MindooDBAppCreateViewInput as bl, type MindooDBAppCreateViewNavigatorInput as bm, type MindooDBAppDatabaseInfo as bn, type MindooDBAppDefinitionDatabase as bo, type MindooDBAppDefinitionListing as bp, type MindooDBAppDefinitionPermission as bq, type MindooDBAppDefinitionRegistrationPermission as br, type MindooDBAppDefinitionScreenshot as bs, type MindooDBAppDefinitionValidation as bt, type MindooDBAppDirectoryApi as bu, type MindooDBAppDirectoryEntry as bv, type MindooDBAppDocumentApi as bw, type MindooDBAppDocumentHeadCursorResult as bx, type MindooDBAppDocumentHistoryEntry as by, type MindooDBAppDocumentInspection as bz, type MindooDBAppDragStartResult as c, type MindooDBAppMenuAnchor as c$, type MindooDBAppEmbedClosedEvent as c0, type MindooDBAppEmbedContext as c1, type MindooDBAppEmbedDirtyEvent as c2, type MindooDBAppEmbedExportFormat as c3, type MindooDBAppEmbedExportPayload as c4, type MindooDBAppEmbedExportRequest as c5, type MindooDBAppEmbedOpenInput as c6, type MindooDBAppEmbedRect as c7, type MindooDBAppEmbedSavedEvent as c8, type MindooDBAppEmbedTemplate as c9, type MindooDBAppIncomingContentInfo as cA, type MindooDBAppIncomingItem as cB, type MindooDBAppIncomingItemInfo as cC, type MindooDBAppIncomingResult as cD, type MindooDBAppIncomingSource as cE, type MindooDBAppInspectAnchor as cF, type MindooDBAppInspectRequest as cG, type MindooDBAppInspectedCell as cH, type MindooDBAppInspection as cI, type MindooDBAppInspectionBase as cJ, type MindooDBAppIssue as cK, type MindooDBAppIssueSeverity as cL, type MindooDBAppJsonCounterIncrementPatch as cM, type MindooDBAppJsonListDeletePatch as cN, type MindooDBAppJsonListInsertPatch as cO, type MindooDBAppJsonPatch as cP, type MindooDBAppJsonSetPatch as cQ, type MindooDBAppJsonTextMarkPatch as cR, type MindooDBAppJsonTextSplicePatch as cS, type MindooDBAppJsonTextUnmarkPatch as cT, type MindooDBAppJsonUnsetPatch as cU, type MindooDBAppLaunchContext as cV, type MindooDBAppListUsersOptions as cW, type MindooDBAppListUsersPage as cX, type MindooDBAppLiveQuerySubscription as cY, type MindooDBAppLocaleMap as cZ, type MindooDBAppLocalizedText as c_, type MindooDBAppEmbedValidation as ca, MindooDBAppEmbedValidationError as cb, type MindooDBAppEmbedVariable as cc, type MindooDBAppEmbeddingApi as cd, type MindooDBAppEmbeddingExport as ce, type MindooDBAppEmbeddingLookupOptions as cf, type MindooDBAppEmbeddingLookupResult as cg, type MindooDBAppEmbeddingResult as ch, type MindooDBAppEmbeddingSaveContext as ci, type MindooDBAppEmbedsApi as cj, type MindooDBAppEntryAttachmentRef as ck, type MindooDBAppEntryProvenance as cl, type MindooDBAppExtractDocumentTextInput as cm, type MindooDBAppExtractDocumentTextResult as cn, type MindooDBAppExtractTextFormat as co, type MindooDBAppExtractionSetup as cp, type MindooDBAppFulltextSetup as cq, type MindooDBAppHistoricalDocument as cr, type MindooDBAppHistoryQuery as cs, type MindooDBAppHostTheme as ct, type MindooDBAppIdentityApi as cu, type MindooDBAppInaccessibleDocument as cv, type MindooDBAppInaccessibleDocumentListQuery as cw, type MindooDBAppInaccessibleDocumentListResult as cx, type MindooDBAppIncomingContent as cy, type MindooDBAppIncomingContentHandler as cz, type MindooDBAppDragPreview as d, type MindooDBAppSession as d$, type MindooDBAppMenuApi as d0, type MindooDBAppMenuCommandItem as d1, type MindooDBAppMenuDismissReason as d2, type MindooDBAppMenuDismissedResult as d3, type MindooDBAppMenuItem as d4, type MindooDBAppMenuKind as d5, type MindooDBAppMenuPlacement as d6, type MindooDBAppMenuPointAnchor as d7, type MindooDBAppMenuRect as d8, type MindooDBAppMenuRectAnchor as d9, type MindooDBAppReminderRequest as dA, type MindooDBAppReminderScheduleResult as dB, type MindooDBAppRemindersApi as dC, type MindooDBAppResolvedViewDefinition as dD, type MindooDBAppResolvedViewSource as dE, type MindooDBAppRevisionPhase as dF, type MindooDBAppRevisionVerification as dG, type MindooDBAppRichTextBlockSpan as dH, type MindooDBAppRichTextGetOptions as dI, type MindooDBAppRichTextImmutableString as dJ, type MindooDBAppRichTextMarkRange as dK, type MindooDBAppRichTextMaterializeValue as dL, type MindooDBAppRichTextPatch as dM, type MindooDBAppRichTextScalar as dN, type MindooDBAppRichTextSpliceStep as dO, type MindooDBAppRichTextStep as dP, type MindooDBAppRichTextStepPatch as dQ, type MindooDBAppRichTextTextSpan as dR, type MindooDBAppRuntime as dS, type MindooDBAppScanAttachmentOptions as dT, type MindooDBAppScanAttachmentResult as dU, type MindooDBAppScopedDocId as dV, type MindooDBAppScopedDocumentSummary as dW, type MindooDBAppSealIntent as dX, type MindooDBAppSealedChannelOpenInput as dY, type MindooDBAppSealedChannelOpenResult as dZ, type MindooDBAppSealedChannelRequestInput as d_, type MindooDBAppMenuSelectionResult as da, type MindooDBAppMenuSeparatorItem as db, type MindooDBAppNotificationSeverity as dc, type MindooDBAppNotifyInput as dd, type MindooDBAppNotifyResult as de, type MindooDBAppPdfApi as df, type MindooDBAppPdfSignInput as dg, type MindooDBAppPdfSignResult as dh, type MindooDBAppPdfSignaturePosition as di, type MindooDBAppPdfSigner as dj, type MindooDBAppProposeAppInput as dk, type MindooDBAppProposeAppResult as dl, type MindooDBAppQueryCoverage as dm, type MindooDBAppQueryInclude as dn, type MindooDBAppQueryIncludeCardinality as dp, type MindooDBAppQueryIncludeSlots as dq, type MindooDBAppQueryResult as dr, type MindooDBAppQueryRow as ds, type MindooDBAppQuerySortKey as dt, type MindooDBAppQueryTextClause as du, type MindooDBAppReadableAttachmentStream as dv, type MindooDBAppRecipientOptions as dw, type MindooDBAppReminder as dx, type MindooDBAppReminderOpened as dy, type MindooDBAppReminderOpenedHandler as dz, type MindooDBAppBridge as e, summarizeMindooDBAppInspection as e$, type MindooDBAppShowMenuInput as e0, type MindooDBAppShowMenuResult as e1, type MindooDBAppSignPreview as e2, type MindooDBAppSignPreviewScope as e3, type MindooDBAppSignStatementInput as e4, type MindooDBAppSignStatementResult as e5, type MindooDBAppSlidesInspection as e6, type MindooDBAppSpreadsheetInspection as e7, type MindooDBAppStorageApi as e8, type MindooDBAppSummarySetup as e9, type MindooDBAppViewNavigatorSelectionState as eA, type MindooDBAppViewUpdateStats as eB, type MindooDBAppViewport as eC, type MindooDBAppWellKnownDragType as eD, type MindooDBAppWritableAttachmentStream as eE, defineDocumentRules as eF, mindooDBAppAcceptMatchesType as eG, mindooDBAppComponentFieldsMatch as eH, mindooDBAppComponentSupports as eI, mindooDBAppExportFile as eJ, mindooDBAppExportMimeType as eK, mindooDBAppExportPayload as eL, mindooDBAppInspectContracts as eM, mindooDBAppInspectRules as eN, mindooDBAppInspectionSummaryValue as eO, normalizeMindooDBAppEmbedExportRequest as eP, normalizeMindooDBAppEmbedVariables as eQ, normalizeMindooDBAppInspectAnchor as eR, normalizeMindooDBAppInspectRequest as eS, normalizeMindooDBAppInspection as eT, normalizeMindooDBAppIssues as eU, readMindooDBAppInspectionSummary as eV, resolveMindooDBAppDefinitionUrl as eW, resolveMindooDBAppEmbedValidation as eX, resolveMindooDBAppListingAssetUrl as eY, resolveMindooDBAppLocalizedText as eZ, resolveMindooDBAppVariables as e_, type MindooDBAppTextCursorOptions as ea, type MindooDBAppTextCursorPosition as eb, type MindooDBAppTextCursorPositionsResult as ec, type MindooDBAppTextCursorsResult as ed, type MindooDBAppTextEdit as ee, type MindooDBAppTextPatch as ef, type MindooDBAppThemeMode as eg, type MindooDBAppTimestampApi as eh, type MindooDBAppTimestampInput as ei, type MindooDBAppTimestampProvider as ej, type MindooDBAppTimestampResult as ek, type MindooDBAppTimestampValue as el, type MindooDBAppTypedValue as em, type MindooDBAppUiPreferences as en, type MindooDBAppUpdateDocumentInput as eo, MindooDBAppValue as ep, type MindooDBAppViewCursorDocumentListResult as eq, type MindooDBAppViewCursorResult as er, type MindooDBAppViewEntry as es, type MindooDBAppViewEntryKind as et, type MindooDBAppViewNavigator as eu, type MindooDBAppViewNavigatorExpansionState as ev, type MindooDBAppViewNavigatorOpenOptions as ew, type MindooDBAppViewNavigatorPageOptions as ex, type MindooDBAppViewNavigatorPageResult as ey, type MindooDBAppViewNavigatorRangeQuery as ez, type MindooDBAppAgentToolErrorCode as f, validateMindooDBAppAccepts as f0, validateMindooDBAppAgentProfile as f1, validateMindooDBAppComponents as f2, validateMindooDBAppDefinition as f3, type MindooDBAppAgentTool as g, type MindooDBAppHostShortcutBinding as h, type MindooDBAppHostShortcutAction as i, type MindooDBAppHostingMode as j, type MindooDBAppDefinition as k, type MindooDBAppDatabase as l, type MindooDBAppDocument as m, type MindooDBAppRichTextSpan as n, type MindooDBAppRichTextSnapshot as o, type MindooDBAppCreateDocumentInput as p, MINDOODB_APP_ACCEPTS_MAX as q, MINDOODB_APP_AGENT_CAPABILITIES_MAX as r, MINDOODB_APP_AGENT_CAPABILITY_TITLE_MAX as s, MINDOODB_APP_AGENT_CAPABILITY_TOOLS_MAX as t, MINDOODB_APP_AGENT_EXAMPLE_MAX as u, MINDOODB_APP_AGENT_GUIDE_MAX_BYTES as v, MINDOODB_APP_AGENT_LIMIT_MAX as w, MINDOODB_APP_AGENT_LIST_MAX as x, MINDOODB_APP_AGENT_SUMMARY_MAX as y, MINDOODB_APP_AGENT_TOOL_NAME_PATTERN as z };