mindoodb-app-sdk 0.0.71 → 0.0.72

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

@@ -282,6 +282,15 @@ 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`).
+     * 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 +400,351 @@ 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>;
+
 /** Launch target used by the Haven when opening an app. */
 type MindooDBAppRuntime = "iframe" | "window";
 /**
@@ -1912,12 +2266,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;
@@ -2062,6 +2424,55 @@ 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>;
+}
+/** 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 +2546,47 @@ 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;
+}
+/** 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 +2599,29 @@ 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";
+    /** `inspect`: `{ request }`, `showIssues`: `{ issues }`, `reveal`: `{ anchor }`. */
+    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 +2638,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 +4353,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 MindooDBAppAgentRegistration 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_INSPECTION_FIELD as H, MINDOODB_APP_INSPECTION_MAX_BYTES as I, MINDOODB_APP_INSPECTION_SUMMARY_MAX_BYTES as J, MINDOODB_APP_ISSUES_MAX as K, MINDOODB_APP_LISTING_DESCRIPTION_MAX as L, type MindooDBAppAttachmentPreviewMode as M, MINDOODB_APP_LISTING_MAX_SCREENSHOTS as N, MINDOODB_APP_LISTING_SUMMARY_MAX as O, MINDOODB_APP_SEAL_SIGNING_DOMAIN as P, MINDOODB_APP_VALUE_TAG as Q, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as R, MINDOODB_INSPECT_DOCUMENT as S, MINDOODB_INSPECT_SLIDES as T, MINDOODB_INSPECT_SPREADSHEET as U, type MindooDBAppAcceptSpec as V, type MindooDBAppAccessDecision as W, type MindooDBAppAccessTier as X, type MindooDBAppAgentApi as Y, type MindooDBAppAgentCapability as Z, type MindooDBAppAgentProfile as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppComponentReference as a$, type MindooDBAppAgentToolAnnotations as a0, type MindooDBAppAgentToolDescriptor as a1, type MindooDBAppAgentToolScope as a2, type MindooDBAppAtomicValue as a3, type MindooDBAppAttachmentApi as a4, type MindooDBAppAttachmentChunk as a5, type MindooDBAppAttachmentInfo as a6, type MindooDBAppAttachmentPreviewOptions as a7, type MindooDBAppAttachmentPreviewSession as a8, type MindooDBAppAutomergeChangesPatch as a9, type MindooDBAppBridgeRpcMessage as aA, type MindooDBAppBridgeRpcRequest as aB, type MindooDBAppBridgeRpcSuccess as aC, type MindooDBAppBridgeShortcutInvokedMessage as aD, type MindooDBAppBridgeShortcutsChangedMessage as aE, type MindooDBAppBridgeStreamAbortRequest as aF, type MindooDBAppBridgeStreamAck as aG, type MindooDBAppBridgeStreamCloseRequest as aH, type MindooDBAppBridgeStreamError as aI, type MindooDBAppBridgeStreamMessage as aJ, type MindooDBAppBridgeStreamOpenResult as aK, type MindooDBAppBridgeStreamReadRequest as aL, type MindooDBAppBridgeStreamWriteRequest as aM, type MindooDBAppBridgeThemeChangedMessage as aN, type MindooDBAppBridgeUiPreferencesChangedMessage as aO, type MindooDBAppBridgeViewChangedMessage as aP, type MindooDBAppBridgeViewportChangedMessage as aQ, type MindooDBAppBridgeWorkspaceFocusRequestedMessage as aR, type MindooDBAppBrowserFeatures as aS, type MindooDBAppCapability as aT, type MindooDBAppComponentCategory as aU, type MindooDBAppComponentChildren as aV, type MindooDBAppComponentContract as aW, type MindooDBAppComponentFieldValue as aX, type MindooDBAppComponentInfo as aY, type MindooDBAppComponentIntent as aZ, type MindooDBAppComponentQuery as a_, type MindooDBAppAutomergeChangesSince as aa, type MindooDBAppAutomergeGetOptions as ab, type MindooDBAppAutomergePatchResult as ac, type MindooDBAppAutomergeSnapshot as ad, type MindooDBAppBridgeAgentInvokeMessage as ae, type MindooDBAppBridgeAgentResultMessage as af, type MindooDBAppBridgeBeforeCloseAck as ag, type MindooDBAppBridgeBeforeCloseMessage as ah, type MindooDBAppBridgeConnectMessage as ai, type MindooDBAppBridgeConnectOptions as aj, type MindooDBAppBridgeConnectedMessage as ak, type MindooDBAppBridgeDragDropMessage as al, type MindooDBAppBridgeDragLeaveMessage as am, type MindooDBAppBridgeDragOverMessage as an, type MindooDBAppBridgeEmbedEventMessage as ao, type MindooDBAppBridgeEmbedRequestMessage as ap, type MindooDBAppBridgeEmbeddingRequestMessage as aq, type MindooDBAppBridgeErrorPayload as ar, type MindooDBAppBridgeHandshakeErrorMessage as as, type MindooDBAppBridgeHostFocusChangedMessage as at, type MindooDBAppBridgeIncomingContentMessage as au, type MindooDBAppBridgeLocaleChangedMessage as av, type MindooDBAppBridgePortMessage as aw, type MindooDBAppBridgeQueryResultMessage as ax, type MindooDBAppBridgeReminderOpenedMessage as ay, type MindooDBAppBridgeRpcError as az, type MindooDBAppDragStartInput as b, type MindooDBAppEmbedContext as b$, type MindooDBAppComponentSpec as b0, type MindooDBAppComponentsApi as b1, type MindooDBAppConfiguredViewCategorizationStyle as b2, type MindooDBAppConfiguredViewColumn as b3, type MindooDBAppConfiguredViewColumnRole as b4, type MindooDBAppConfiguredViewExpressionMode as b5, type MindooDBAppConfiguredViewFieldExpression as b6, type MindooDBAppConfiguredViewFilterDefinition as b7, type MindooDBAppConfiguredViewFilterMode as b8, type MindooDBAppConfiguredViewFilterRule as b9, type MindooDBAppDocumentQuery as bA, type MindooDBAppDocumentRevisionId as bB, type MindooDBAppDocumentRule as bC, type MindooDBAppDocumentRuleOutcome as bD, type MindooDBAppDocumentRules as bE, type MindooDBAppDocumentScanPreset as bF, type MindooDBAppDocumentSummary as bG, type MindooDBAppDragApi as bH, type MindooDBAppDragCancelReason as bI, type MindooDBAppDragDropEvent as bJ, type MindooDBAppDragEffect as bK, type MindooDBAppDragHoverResult as bL, type MindooDBAppDragOffer as bM, type MindooDBAppDragOverEvent as bN, type MindooDBAppDragPointer as bO, type MindooDBAppDragProfile as bP, type MindooDBAppEmbed as bQ, type MindooDBAppEmbedAccessComponent as bR, type MindooDBAppEmbedAccessInput as bS, type MindooDBAppEmbedAccessPair as bT, type MindooDBAppEmbedAccessResult as bU, type MindooDBAppEmbedAgentTools as bV, type MindooDBAppEmbedAgentToolsEvent as bW, type MindooDBAppEmbedBeforeSaveInput as bX, type MindooDBAppEmbedBeforeSaveResult as bY, type MindooDBAppEmbedCloseReason as bZ, type MindooDBAppEmbedClosedEvent as b_, type MindooDBAppConfiguredViewFormulaExpression as ba, type MindooDBAppConfiguredViewFormulaFilterDefinition as bb, type MindooDBAppConfiguredViewPreviewMode as bc, type MindooDBAppConfiguredViewRuleFilterDefinition as bd, type MindooDBAppConfiguredViewRuleMatchMode as be, type MindooDBAppConfiguredViewRuleOperator as bf, type MindooDBAppConfiguredViewValueExpression as bg, type MindooDBAppCounterValue as bh, type MindooDBAppCreateKeyInfo as bi, type MindooDBAppCreateViewInput as bj, type MindooDBAppCreateViewNavigatorInput as bk, type MindooDBAppDatabaseInfo as bl, type MindooDBAppDefinitionDatabase as bm, type MindooDBAppDefinitionListing as bn, type MindooDBAppDefinitionPermission as bo, type MindooDBAppDefinitionRegistrationPermission as bp, type MindooDBAppDefinitionScreenshot as bq, type MindooDBAppDefinitionValidation as br, type MindooDBAppDirectoryApi as bs, type MindooDBAppDirectoryEntry as bt, type MindooDBAppDocumentApi as bu, type MindooDBAppDocumentHeadCursorResult as bv, type MindooDBAppDocumentHistoryEntry as bw, type MindooDBAppDocumentInspection as bx, type MindooDBAppDocumentListQuery as by, type MindooDBAppDocumentListResult as bz, type MindooDBAppDragStartResult as c, type MindooDBAppMenuPointAnchor as c$, type MindooDBAppEmbedDirtyEvent as c0, type MindooDBAppEmbedOpenInput as c1, type MindooDBAppEmbedRect as c2, type MindooDBAppEmbedSavedEvent as c3, type MindooDBAppEmbedValidation as c4, MindooDBAppEmbedValidationError as c5, type MindooDBAppEmbeddingApi as c6, type MindooDBAppEmbeddingLookupOptions as c7, type MindooDBAppEmbeddingLookupResult as c8, type MindooDBAppEmbeddingResult as c9, type MindooDBAppInspection as cA, type MindooDBAppInspectionBase as cB, type MindooDBAppIssue as cC, type MindooDBAppIssueSeverity as cD, type MindooDBAppJsonCounterIncrementPatch as cE, type MindooDBAppJsonListDeletePatch as cF, type MindooDBAppJsonListInsertPatch as cG, type MindooDBAppJsonPatch as cH, type MindooDBAppJsonSetPatch as cI, type MindooDBAppJsonTextMarkPatch as cJ, type MindooDBAppJsonTextSplicePatch as cK, type MindooDBAppJsonTextUnmarkPatch as cL, type MindooDBAppJsonUnsetPatch as cM, type MindooDBAppLaunchContext as cN, type MindooDBAppListUsersOptions as cO, type MindooDBAppListUsersPage as cP, type MindooDBAppLiveQuerySubscription as cQ, type MindooDBAppLocaleMap as cR, type MindooDBAppLocalizedText as cS, type MindooDBAppMenuAnchor as cT, type MindooDBAppMenuApi as cU, type MindooDBAppMenuCommandItem as cV, type MindooDBAppMenuDismissReason as cW, type MindooDBAppMenuDismissedResult as cX, type MindooDBAppMenuItem as cY, type MindooDBAppMenuKind as cZ, type MindooDBAppMenuPlacement as c_, type MindooDBAppEmbeddingSaveContext as ca, type MindooDBAppEmbedsApi as cb, type MindooDBAppEntryAttachmentRef as cc, type MindooDBAppEntryProvenance as cd, type MindooDBAppExtractDocumentTextInput as ce, type MindooDBAppExtractDocumentTextResult as cf, type MindooDBAppExtractTextFormat as cg, type MindooDBAppExtractionSetup as ch, type MindooDBAppFulltextSetup as ci, type MindooDBAppHistoricalDocument as cj, type MindooDBAppHistoryQuery as ck, type MindooDBAppHostTheme as cl, type MindooDBAppIdentityApi as cm, type MindooDBAppInaccessibleDocument as cn, type MindooDBAppInaccessibleDocumentListQuery as co, type MindooDBAppInaccessibleDocumentListResult as cp, type MindooDBAppIncomingContent as cq, type MindooDBAppIncomingContentHandler as cr, type MindooDBAppIncomingContentInfo as cs, type MindooDBAppIncomingItem as ct, type MindooDBAppIncomingItemInfo as cu, type MindooDBAppIncomingResult as cv, type MindooDBAppIncomingSource as cw, type MindooDBAppInspectAnchor as cx, type MindooDBAppInspectRequest as cy, type MindooDBAppInspectedCell as cz, type MindooDBAppDragPreview as d, type MindooDBAppSpreadsheetInspection as d$, type MindooDBAppMenuRect as d0, type MindooDBAppMenuRectAnchor as d1, type MindooDBAppMenuSelectionResult as d2, type MindooDBAppMenuSeparatorItem as d3, type MindooDBAppNotificationSeverity as d4, type MindooDBAppNotifyInput as d5, type MindooDBAppNotifyResult as d6, type MindooDBAppPdfApi as d7, type MindooDBAppPdfSignInput as d8, type MindooDBAppPdfSignResult as d9, type MindooDBAppRichTextGetOptions as dA, type MindooDBAppRichTextImmutableString as dB, type MindooDBAppRichTextMarkRange as dC, type MindooDBAppRichTextMaterializeValue as dD, type MindooDBAppRichTextPatch as dE, type MindooDBAppRichTextScalar as dF, type MindooDBAppRichTextSpliceStep as dG, type MindooDBAppRichTextStep as dH, type MindooDBAppRichTextStepPatch as dI, type MindooDBAppRichTextTextSpan as dJ, type MindooDBAppRuntime as dK, type MindooDBAppScanAttachmentOptions as dL, type MindooDBAppScanAttachmentResult as dM, type MindooDBAppScopedDocId as dN, type MindooDBAppScopedDocumentSummary as dO, type MindooDBAppSealIntent as dP, type MindooDBAppSealedChannelOpenInput as dQ, type MindooDBAppSealedChannelOpenResult as dR, type MindooDBAppSealedChannelRequestInput as dS, type MindooDBAppSession as dT, type MindooDBAppShowMenuInput as dU, type MindooDBAppShowMenuResult as dV, type MindooDBAppSignPreview as dW, type MindooDBAppSignPreviewScope as dX, type MindooDBAppSignStatementInput as dY, type MindooDBAppSignStatementResult as dZ, type MindooDBAppSlidesInspection as d_, type MindooDBAppPdfSignaturePosition as da, type MindooDBAppPdfSigner as db, type MindooDBAppProposeAppInput as dc, type MindooDBAppProposeAppResult as dd, type MindooDBAppQueryCoverage as de, type MindooDBAppQueryInclude as df, type MindooDBAppQueryIncludeCardinality as dg, type MindooDBAppQueryIncludeSlots as dh, type MindooDBAppQueryResult as di, type MindooDBAppQueryRow as dj, type MindooDBAppQuerySortKey as dk, type MindooDBAppQueryTextClause as dl, type MindooDBAppReadableAttachmentStream as dm, type MindooDBAppRecipientOptions as dn, type MindooDBAppReminder as dp, type MindooDBAppReminderOpened as dq, type MindooDBAppReminderOpenedHandler as dr, type MindooDBAppReminderRequest as ds, type MindooDBAppReminderScheduleResult as dt, type MindooDBAppRemindersApi as du, type MindooDBAppResolvedViewDefinition as dv, type MindooDBAppResolvedViewSource as dw, type MindooDBAppRevisionPhase as dx, type MindooDBAppRevisionVerification as dy, type MindooDBAppRichTextBlockSpan as dz, type MindooDBAppBridge as e, type MindooDBAppStorageApi as e0, type MindooDBAppSummarySetup as e1, type MindooDBAppTextCursorOptions as e2, type MindooDBAppTextCursorPosition as e3, type MindooDBAppTextCursorPositionsResult as e4, type MindooDBAppTextCursorsResult as e5, type MindooDBAppTextEdit as e6, type MindooDBAppTextPatch as e7, type MindooDBAppThemeMode as e8, type MindooDBAppTimestampApi as e9, mindooDBAppComponentSupports as eA, mindooDBAppInspectContracts as eB, mindooDBAppInspectRules as eC, mindooDBAppInspectionSummaryValue as eD, normalizeMindooDBAppInspectAnchor as eE, normalizeMindooDBAppInspectRequest as eF, normalizeMindooDBAppInspection as eG, normalizeMindooDBAppIssues as eH, readMindooDBAppInspectionSummary as eI, resolveMindooDBAppDefinitionUrl as eJ, resolveMindooDBAppEmbedValidation as eK, resolveMindooDBAppListingAssetUrl as eL, resolveMindooDBAppLocalizedText as eM, summarizeMindooDBAppInspection as eN, validateMindooDBAppAccepts as eO, validateMindooDBAppAgentProfile as eP, validateMindooDBAppComponents as eQ, validateMindooDBAppDefinition as eR, type MindooDBAppTimestampInput as ea, type MindooDBAppTimestampProvider as eb, type MindooDBAppTimestampResult as ec, type MindooDBAppTimestampValue as ed, type MindooDBAppTypedValue as ee, type MindooDBAppUiPreferences as ef, type MindooDBAppUpdateDocumentInput as eg, MindooDBAppValue as eh, type MindooDBAppViewCursorDocumentListResult as ei, type MindooDBAppViewCursorResult as ej, type MindooDBAppViewEntry as ek, type MindooDBAppViewEntryKind as el, type MindooDBAppViewNavigator as em, type MindooDBAppViewNavigatorExpansionState as en, type MindooDBAppViewNavigatorOpenOptions as eo, type MindooDBAppViewNavigatorPageOptions as ep, type MindooDBAppViewNavigatorPageResult as eq, type MindooDBAppViewNavigatorRangeQuery as er, type MindooDBAppViewNavigatorSelectionState as es, type MindooDBAppViewUpdateStats as et, type MindooDBAppViewport as eu, type MindooDBAppWellKnownDragType as ev, type MindooDBAppWritableAttachmentStream as ew, defineDocumentRules as ex, mindooDBAppAcceptMatchesType as ey, mindooDBAppComponentFieldsMatch as ez, 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 };

package/package.json

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