mindoodb-app-sdk 0.0.70 → 0.0.72

package/dist/{types-7oOzrSr5.d.ts → types-DN-E0X34.d.ts}

@@ -135,6 +135,51 @@ interface MindooDBAppDefinition {
      * Display-only; nothing in here affects what the app is granted.
      */
     listing?: MindooDBAppDefinitionListing;
+    /**
+     * What AI agents learn about the app before they open it: what it is for, what its
+     * agent tools can do, example requests and a longer how-to. Haven shows it through
+     * `haven_apps_describe`. See {@link MindooDBAppAgentProfile}.
+     */
+    agent?: MindooDBAppAgentProfile;
+}
+/**
+ * Per-locale text: `en` is required and the fallback for every locale it does not
+ * name. Unlike {@link MindooDBAppLocalizedText} a plain string is not accepted.
+ */
+type MindooDBAppLocaleMap<T> = {
+    en: T;
+} & Record<string, T>;
+/** One thing an agent can do with the app, and the tools it takes. */
+interface MindooDBAppAgentCapability {
+    /** Stable id, unique within the profile. Lowercase letters, digits, `-` and `_`. */
+    id: string;
+    /** Short title, e.g. "Find, open and create maps". At most 80 characters. */
+    title: MindooDBAppLocaleMap<string>;
+    /**
+     * The tools behind it, named as in `registerTools` (without the app's prefix):
+     * `nodes_add`, not `vega_nodes_add`. Haven's own `haven_*` tools do not belong here.
+     */
+    tools: string[];
+}
+/**
+ * The app as an agent should know it before opening it (`agent` in haven-app.json).
+ * Everything here is text the publisher writes for agents; it grants nothing.
+ */
+interface MindooDBAppAgentProfile {
+    /** Neutral description in 1-3 sentences, at most 400 characters per locale. */
+    summary: MindooDBAppLocaleMap<string>;
+    /** 1-8 capabilities that together cover the app's agent tools. */
+    capabilities: MindooDBAppAgentCapability[];
+    /** Example requests a user might give an agent, per locale. */
+    examples?: MindooDBAppLocaleMap<string[]>;
+    /** What the app deliberately does not do, so an agent does not try. */
+    limits?: MindooDBAppLocaleMap<string[]>;
+    /**
+     * Markdown how-to per locale (`agent/agent.en.md`): typical steps, where ids come
+     * from, pitfalls. A path relative to haven-app.json, at most
+     * {@link MINDOODB_APP_AGENT_GUIDE_MAX_BYTES} bytes.
+     */
+    guide?: MindooDBAppLocaleMap<string>;
 }
 /** One kind of content an app takes, as a choice in Haven's picker. */
 interface MindooDBAppAcceptSpec {
@@ -237,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
@@ -274,6 +328,19 @@ interface MindooDBAppDefinitionListing {
 declare const MINDOODB_APP_LISTING_SUMMARY_MAX = 300;
 declare const MINDOODB_APP_LISTING_DESCRIPTION_MAX = 4000;
 declare const MINDOODB_APP_LISTING_MAX_SCREENSHOTS = 8;
+declare const MINDOODB_APP_AGENT_SUMMARY_MAX = 400;
+declare const MINDOODB_APP_AGENT_CAPABILITIES_MAX = 8;
+declare const MINDOODB_APP_AGENT_CAPABILITY_TITLE_MAX = 80;
+/** Most tools one capability lists; an app registers at most 64 tools. */
+declare const MINDOODB_APP_AGENT_CAPABILITY_TOOLS_MAX = 64;
+/** Most examples or limits per locale. */
+declare const MINDOODB_APP_AGENT_LIST_MAX = 8;
+declare const MINDOODB_APP_AGENT_EXAMPLE_MAX = 200;
+declare const MINDOODB_APP_AGENT_LIMIT_MAX = 300;
+/** Largest agent guide a host loads; longer guides are cut. */
+declare const MINDOODB_APP_AGENT_GUIDE_MAX_BYTES: number;
+/** An agent tool name as `registerTools` accepts it, without the app's prefix. */
+declare const MINDOODB_APP_AGENT_TOOL_NAME_PATTERN: RegExp;
 interface MindooDBAppDefinitionValidation {
     definition: MindooDBAppDefinition | null;
     errors: string[];
@@ -302,6 +369,14 @@ declare function validateMindooDBAppComponents(value: unknown): {
 };
 /** Whether every field in `match` has exactly that value in `data`. */
 declare function mindooDBAppComponentFieldsMatch(match: Readonly<Record<string, MindooDBAppComponentFieldValue>>, data: Readonly<Record<string, unknown>> | null | undefined): boolean;
+/**
+ * Validates an `agent` block on its own, for hosts that read it from another manifest
+ * format (Haven's app store catalog).
+ */
+declare function validateMindooDBAppAgentProfile(value: unknown): {
+    agent: MindooDBAppAgentProfile | undefined;
+    errors: string[];
+};
 /**
  * Picks the text for `locale` out of a localized value: the exact locale, then its
  * language (`de` for `de-CH`), then `en`.
@@ -325,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";
 /**
@@ -1846,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;
@@ -1996,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 {
@@ -2069,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;
@@ -2081,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 {
@@ -2103,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. */
@@ -3816,4 +4353,4 @@ interface MindooDBAppBridge {
     connect(options?: MindooDBAppBridgeConnectOptions): Promise<MindooDBAppSession>;
 }
 
-export { type MindooDBAppBridgeConnectOptions as $, MINDOODB_APP_LISTING_SUMMARY_MAX as A, MINDOODB_APP_SEAL_SIGNING_DOMAIN as B, MINDOODB_APP_WELL_KNOWN_DRAG_TYPES as C, type MindooDBAppAcceptSpec as D, type MindooDBAppAccessDecision as E, type MindooDBAppAccessTier as F, type MindooDBAppAgentApi as G, type MindooDBAppAgentRegistration as H, type MindooDBAppAgentToolAnnotations as I, type MindooDBAppAgentToolDescriptor as J, type MindooDBAppAgentToolScope as K, type MindooDBAppAttachmentApi as L, type MindooDBAppAttachmentPreviewMode as M, type MindooDBAppAttachmentChunk as N, type MindooDBAppAttachmentInfo as O, type MindooDBAppAttachmentPreviewOptions as P, type MindooDBAppAttachmentPreviewSession as Q, type MindooDBAppAutomergeChangesPatch as R, type MindooDBAppAutomergeChangesSince as S, type MindooDBAppAutomergeGetOptions as T, type MindooDBAppAutomergePatchResult as U, type MindooDBAppAutomergeSnapshot as V, type MindooDBAppBridgeAgentInvokeMessage as W, type MindooDBAppBridgeAgentResultMessage as X, type MindooDBAppBridgeBeforeCloseAck as Y, type MindooDBAppBridgeBeforeCloseMessage as Z, type MindooDBAppBridgeConnectMessage as _, type MindooDBAppDragBindSourceOptions as a, type MindooDBAppDatabaseInfo as a$, type MindooDBAppBridgeConnectedMessage as a0, type MindooDBAppBridgeDragDropMessage as a1, type MindooDBAppBridgeDragLeaveMessage as a2, type MindooDBAppBridgeDragOverMessage as a3, type MindooDBAppBridgeEmbedEventMessage as a4, type MindooDBAppBridgeEmbeddingRequestMessage as a5, type MindooDBAppBridgeErrorPayload as a6, type MindooDBAppBridgeHandshakeErrorMessage as a7, type MindooDBAppBridgeHostFocusChangedMessage as a8, type MindooDBAppBridgeIncomingContentMessage as a9, type MindooDBAppComponentChildren as aA, type MindooDBAppComponentContract as aB, type MindooDBAppComponentFieldValue as aC, type MindooDBAppComponentInfo as aD, type MindooDBAppComponentIntent as aE, type MindooDBAppComponentQuery as aF, type MindooDBAppComponentReference as aG, type MindooDBAppComponentSpec as aH, type MindooDBAppComponentsApi as aI, type MindooDBAppConfiguredViewCategorizationStyle as aJ, type MindooDBAppConfiguredViewColumn as aK, type MindooDBAppConfiguredViewColumnRole as aL, type MindooDBAppConfiguredViewExpressionMode as aM, type MindooDBAppConfiguredViewFieldExpression as aN, type MindooDBAppConfiguredViewFilterDefinition as aO, type MindooDBAppConfiguredViewFilterMode as aP, type MindooDBAppConfiguredViewFilterRule as aQ, type MindooDBAppConfiguredViewFormulaExpression as aR, type MindooDBAppConfiguredViewFormulaFilterDefinition as aS, type MindooDBAppConfiguredViewPreviewMode as aT, type MindooDBAppConfiguredViewRuleFilterDefinition as aU, type MindooDBAppConfiguredViewRuleMatchMode as aV, type MindooDBAppConfiguredViewRuleOperator as aW, type MindooDBAppConfiguredViewValueExpression as aX, type MindooDBAppCreateKeyInfo as aY, type MindooDBAppCreateViewInput as aZ, type MindooDBAppCreateViewNavigatorInput as a_, type MindooDBAppBridgeLocaleChangedMessage as aa, type MindooDBAppBridgePortMessage as ab, type MindooDBAppBridgeQueryResultMessage as ac, type MindooDBAppBridgeReminderOpenedMessage as ad, type MindooDBAppBridgeRpcError as ae, type MindooDBAppBridgeRpcMessage as af, type MindooDBAppBridgeRpcRequest as ag, type MindooDBAppBridgeRpcSuccess as ah, type MindooDBAppBridgeShortcutInvokedMessage as ai, type MindooDBAppBridgeShortcutsChangedMessage as aj, type MindooDBAppBridgeStreamAbortRequest as ak, type MindooDBAppBridgeStreamAck as al, type MindooDBAppBridgeStreamCloseRequest as am, type MindooDBAppBridgeStreamError as an, type MindooDBAppBridgeStreamMessage as ao, type MindooDBAppBridgeStreamOpenResult as ap, type MindooDBAppBridgeStreamReadRequest as aq, type MindooDBAppBridgeStreamWriteRequest as ar, type MindooDBAppBridgeThemeChangedMessage as as, type MindooDBAppBridgeUiPreferencesChangedMessage as at, type MindooDBAppBridgeViewChangedMessage as au, type MindooDBAppBridgeViewportChangedMessage as av, type MindooDBAppBridgeWorkspaceFocusRequestedMessage as aw, type MindooDBAppBrowserFeatures as ax, type MindooDBAppCapability as ay, type MindooDBAppComponentCategory as az, type MindooDBAppDragStartInput as b, type MindooDBAppIncomingSource as b$, type MindooDBAppDefinitionDatabase as b0, type MindooDBAppDefinitionListing as b1, type MindooDBAppDefinitionPermission as b2, type MindooDBAppDefinitionRegistrationPermission as b3, type MindooDBAppDefinitionScreenshot as b4, type MindooDBAppDefinitionValidation as b5, type MindooDBAppDirectoryApi as b6, type MindooDBAppDirectoryEntry as b7, type MindooDBAppDocumentApi as b8, type MindooDBAppDocumentHeadCursorResult as b9, type MindooDBAppEmbedDirtyEvent as bA, type MindooDBAppEmbedOpenInput as bB, type MindooDBAppEmbedRect as bC, type MindooDBAppEmbeddingApi as bD, type MindooDBAppEmbeddingLookupOptions as bE, type MindooDBAppEmbeddingLookupResult as bF, type MindooDBAppEmbedsApi as bG, type MindooDBAppEntryAttachmentRef as bH, type MindooDBAppEntryProvenance as bI, type MindooDBAppExtractDocumentTextInput as bJ, type MindooDBAppExtractDocumentTextResult as bK, type MindooDBAppExtractTextFormat as bL, type MindooDBAppExtractionSetup as bM, type MindooDBAppFulltextSetup as bN, type MindooDBAppHistoricalDocument as bO, type MindooDBAppHistoryQuery as bP, type MindooDBAppHostTheme as bQ, type MindooDBAppIdentityApi as bR, type MindooDBAppInaccessibleDocument as bS, type MindooDBAppInaccessibleDocumentListQuery as bT, type MindooDBAppInaccessibleDocumentListResult as bU, type MindooDBAppIncomingContent as bV, type MindooDBAppIncomingContentHandler as bW, type MindooDBAppIncomingContentInfo as bX, type MindooDBAppIncomingItem as bY, type MindooDBAppIncomingItemInfo as bZ, type MindooDBAppIncomingResult as b_, type MindooDBAppDocumentHistoryEntry as ba, type MindooDBAppDocumentListQuery as bb, type MindooDBAppDocumentListResult as bc, type MindooDBAppDocumentQuery as bd, type MindooDBAppDocumentRevisionId 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 MindooDBAppEmbedCloseReason as bx, type MindooDBAppEmbedClosedEvent as by, type MindooDBAppEmbedContext as bz, type MindooDBAppDragStartResult as c, type MindooDBAppRichTextScalar as c$, type MindooDBAppJsonCounterIncrementPatch as c0, type MindooDBAppJsonListDeletePatch as c1, type MindooDBAppJsonListInsertPatch as c2, type MindooDBAppJsonPatch as c3, type MindooDBAppJsonSetPatch as c4, type MindooDBAppJsonTextMarkPatch as c5, type MindooDBAppJsonTextSplicePatch as c6, type MindooDBAppJsonTextUnmarkPatch as c7, type MindooDBAppJsonUnsetPatch as c8, type MindooDBAppLaunchContext as c9, type MindooDBAppProposeAppResult as cA, type MindooDBAppQueryCoverage as cB, type MindooDBAppQueryInclude as cC, type MindooDBAppQueryIncludeCardinality as cD, type MindooDBAppQueryIncludeSlots as cE, type MindooDBAppQueryResult as cF, type MindooDBAppQueryRow as cG, type MindooDBAppQuerySortKey as cH, type MindooDBAppQueryTextClause as cI, type MindooDBAppReadableAttachmentStream as cJ, type MindooDBAppRecipientOptions as cK, type MindooDBAppReminder as cL, type MindooDBAppReminderOpened as cM, type MindooDBAppReminderOpenedHandler as cN, type MindooDBAppReminderRequest as cO, type MindooDBAppReminderScheduleResult as cP, type MindooDBAppRemindersApi as cQ, type MindooDBAppResolvedViewDefinition as cR, type MindooDBAppResolvedViewSource as cS, type MindooDBAppRevisionPhase as cT, type MindooDBAppRevisionVerification as cU, type MindooDBAppRichTextBlockSpan as cV, type MindooDBAppRichTextGetOptions as cW, type MindooDBAppRichTextImmutableString as cX, type MindooDBAppRichTextMarkRange as cY, type MindooDBAppRichTextMaterializeValue as cZ, type MindooDBAppRichTextPatch as c_, type MindooDBAppListUsersOptions as ca, type MindooDBAppListUsersPage as cb, type MindooDBAppLiveQuerySubscription as cc, type MindooDBAppLocalizedText as cd, type MindooDBAppMenuAnchor as ce, type MindooDBAppMenuApi as cf, type MindooDBAppMenuCommandItem as cg, type MindooDBAppMenuDismissReason as ch, type MindooDBAppMenuDismissedResult as ci, type MindooDBAppMenuItem as cj, type MindooDBAppMenuKind as ck, type MindooDBAppMenuPlacement as cl, type MindooDBAppMenuPointAnchor as cm, type MindooDBAppMenuRect as cn, type MindooDBAppMenuRectAnchor as co, type MindooDBAppMenuSelectionResult as cp, type MindooDBAppMenuSeparatorItem as cq, type MindooDBAppNotificationSeverity as cr, type MindooDBAppNotifyInput as cs, type MindooDBAppNotifyResult as ct, type MindooDBAppPdfApi as cu, type MindooDBAppPdfSignInput as cv, type MindooDBAppPdfSignResult as cw, type MindooDBAppPdfSignaturePosition as cx, type MindooDBAppPdfSigner as cy, type MindooDBAppProposeAppInput as cz, type MindooDBAppDragPreview as d, type MindooDBAppRichTextSpliceStep as d0, type MindooDBAppRichTextStep as d1, type MindooDBAppRichTextStepPatch as d2, type MindooDBAppRichTextTextSpan as d3, type MindooDBAppRuntime as d4, type MindooDBAppScanAttachmentOptions as d5, type MindooDBAppScanAttachmentResult as d6, type MindooDBAppScopedDocId as d7, type MindooDBAppScopedDocumentSummary as d8, type MindooDBAppSealIntent as d9, type MindooDBAppViewCursorDocumentListResult as dA, type MindooDBAppViewCursorResult as dB, type MindooDBAppViewEntry as dC, type MindooDBAppViewEntryKind as dD, type MindooDBAppViewNavigator as dE, type MindooDBAppViewNavigatorExpansionState as dF, type MindooDBAppViewNavigatorOpenOptions as dG, type MindooDBAppViewNavigatorPageOptions as dH, type MindooDBAppViewNavigatorPageResult as dI, type MindooDBAppViewNavigatorRangeQuery as dJ, type MindooDBAppViewNavigatorSelectionState as dK, type MindooDBAppViewUpdateStats as dL, type MindooDBAppViewport as dM, type MindooDBAppWellKnownDragType as dN, type MindooDBAppWritableAttachmentStream as dO, mindooDBAppAcceptMatchesType as dP, mindooDBAppComponentFieldsMatch as dQ, resolveMindooDBAppDefinitionUrl as dR, resolveMindooDBAppListingAssetUrl as dS, resolveMindooDBAppLocalizedText as dT, validateMindooDBAppAccepts as dU, validateMindooDBAppComponents as dV, validateMindooDBAppDefinition as dW, type MindooDBAppSealedChannelOpenInput as da, type MindooDBAppSealedChannelOpenResult as db, type MindooDBAppSealedChannelRequestInput as dc, type MindooDBAppSession as dd, type MindooDBAppShowMenuInput as de, type MindooDBAppShowMenuResult as df, type MindooDBAppSignPreview as dg, type MindooDBAppSignPreviewScope as dh, type MindooDBAppSignStatementInput as di, type MindooDBAppSignStatementResult as dj, type MindooDBAppStorageApi as dk, type MindooDBAppSummarySetup as dl, type MindooDBAppTextCursorOptions as dm, type MindooDBAppTextCursorPosition as dn, type MindooDBAppTextCursorPositionsResult as dp, type MindooDBAppTextCursorsResult as dq, type MindooDBAppTextEdit as dr, type MindooDBAppTextPatch as ds, type MindooDBAppThemeMode as dt, type MindooDBAppTimestampApi as du, type MindooDBAppTimestampInput as dv, type MindooDBAppTimestampProvider as dw, type MindooDBAppTimestampResult as dx, type MindooDBAppUiPreferences as dy, type MindooDBAppUpdateDocumentInput as dz, type MindooDBAppBridge as e, 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_COMPONENTS_MAX as r, MINDOODB_APP_COMPONENT_CONTRACT_PATTERN as s, MINDOODB_APP_DEFINITION_FILE_NAME as t, MINDOODB_APP_DEFINITION_FORMAT as u, MINDOODB_APP_DEFINITION_PERMISSIONS as v, MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS as w, MINDOODB_APP_DEFINITION_VERSION as x, MINDOODB_APP_LISTING_DESCRIPTION_MAX as y, MINDOODB_APP_LISTING_MAX_SCREENSHOTS 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 };