mindoodb-app-sdk 0.0.64 → 0.0.66

package/README.md

@@ -327,10 +327,44 @@ if (session.agent) {
 - **`annotations`**: `readOnlyHint` for reads; `consequentialHint` for anything the user should confirm (sending, sharing, deleting) — Haven shows its own confirmation dialog and a refusal reaches the agent as `NOT_ALLOWED`; `untrustedContentHint` when the result contains text other people wrote.
 - **Errors**: throw `MindooDBAppAgentToolError(code, message, requiredAction?)` with `NOT_FOUND`, `INVALID_INPUT`, `INVALID_STATE`, `STATE_CHANGED`, `NOT_ALLOWED` or `FAILED`; `requiredAction` tells the agent what to do next ("call todo_tasks_search"). Any other exception becomes `FAILED`. Haven passes the agent one JSON error.
 - **Results** must be JSON. Return what changed (ids, new values), not just `ok`.
+- **`scope`**: `"app"` (default) for the app's own operations ("list documents", "create a map"), `"document"` for operations on the document it shows ("write this paragraph", "set these cells"). See *Agent tools of embedded components* below.
 - **`setContext(context)`** shows the app's state to agents in `haven_get_context` under the focused app.
 - **Files** never travel through the agent. `agent.provideFile(blob, { name, mimeType })` hands Haven a file the app produced and returns a `fileRef` (valid ten minutes) for the agent to pass to `haven_files_export`, which saves it into the user's exchange folder. `agent.takeFile(fileRef)` returns a `File` the agent imported for this app with `haven_files_import`.
 - A call that runs longer than two minutes fails with `FAILED`; files are limited to 50 MB.
 
+#### Agent tools of embedded components
+
+Agents work on three levels: Haven's own tools (`haven_*`), the tools of the app the
+user has open, and the tools of the components that app embeds. A host such as Mindoo
+CRM offers the *workbench*: finding, creating, filing, opening and closing documents.
+The embedded editors offer the *content* of the one document each shows.
+
+- **Embedded, an app offers only its `scope: "document"` tools.** It sees just its
+  sandbox, so "list documents" or "create a document" would mislead; the host has its
+  own tools for those. Register the same tool list either way; Haven drops the rest.
+- **One component per app is active.** When a host shows two documents of the same
+  app (two text documents side by side), the app's tool names belong to the active one:
+  the newest, until the host calls `embed.setActive()`, e.g. when a tab comes to the
+  front. Components of different apps (a spreadsheet next to a text) all keep theirs.
+  Haven prefers the launch in the focused app, so a component in the CRM wins over the
+  same app running in a background tab.
+- **The host learns about its components' tools**: `embed.agentTools` is
+  `{ prefix, names, active, enabled }` or `null`, `embed.onAgentToolsChange` follows it,
+  and `embed.waitForAgentTools(timeoutMs)` resolves once the component offers tools.
+  A host's "open document" tool can wait for it and tell the agent which tools to use
+  next:
+
+```ts
+const embed = await session.embeds.open({ componentKey, databaseId, docId, container });
+await embed.setActive();
+const tools = await embed.waitForAgentTools(5000);
+return { docKey, editorTools: tools ? { prefix: tools.prefix, names: tools.names } : null };
+```
+
+In tests, `host.setEmbedAgentTools(embedId, ["text_insert"])` acts as if the component
+registered tools, and an app under test launched with `launchContext.embed` offers only
+its document tools, as in Haven.
+
 `session.agent` is absent on hosts without agent tools, so check for it. Test tools by calling `execute` directly in unit tests; the reference implementation is `src/features/agent/` in [mindoodb-app-vega](https://github.com/klehmann/mindoodb-app-vega). How to design tools that agents use well is in the [best practices guide](https://github.com/klehmann/MindooDB/blob/main/docs/best-practices.md) (section "Offer operations to AI agents").
 
 ### Host-owned drag
@@ -426,6 +460,39 @@ await session.embedding.complete({ title }); // or session.embedding.cancel()
 Haven writes every change back to the host's database as it happens and only lets the
 component create documents that are children of the root.
 
+**Kinds, contracts and references.** Three optional fields let hosts pick components by
+what they do instead of by app:
+
+```json
+{
+  "id": "person",
+  "label": { "en": "Person", "de": "Person" },
+  "intents": ["create", "edit", "view"],
+  "match": { "form": "contactperson" },
+  "category": "form",
+  "provides": [{ "contract": "mindoo.contacts.person@1", "fields": { "parents": "companyIds" } }],
+  "references": [
+    { "field": "companyIds", "to": "mindoo.contacts.company@1", "match": { "form": "contactcompany" }, "show": ["subject"] }
+  ]
+}
+```
+
+- `category`: `editor` (content: a document, a spreadsheet, a map) or `form` (a record: a
+  company, a person); hosts may treat a component without one as an `editor`. A CRM
+  offers its editors under "New" and uses its forms elsewhere.
+- `provides`: contracts the root documents fulfil (`<name>@<major version>`), so a host
+  can rely on their shape; `fields` maps contract fields to this app's field names.
+  Another app offering the same contract can take this one's place.
+- `references`: fields that point at other root documents (not parts, unlike
+  `children`), e.g. a person's company. Embedded, the component cannot see the host's
+  database, so it asks Haven:
+
+```ts
+const companies = await session.embedding.lookup("companyIds", { query: "Mül" });
+// [{ docId, fields: { subject } }]: only documents matching the reference's `match`,
+// only its `show` fields. `docIds: [...]` fetches given ones (to show the current value).
+```
+
 **Embedding a component** (host app):
 
 ```ts
@@ -485,6 +552,9 @@ answers like a current Haven, so the SDK frames that URL in the container. Both
 controllers simulate unsaved changes: `setEmbedDirty`, `failNextEmbedSave`, and for an
 app under test that is a component, `getEmbeddingDirty` and `requestEmbeddingSave`.
 
+A host with agent tools marks the component in the front tab with `embed.setActive()`
+and reads `embed.agentTools`; see *Agent tools of embedded components*.
+
 ### Databases and capabilities
 
 Each database mapped to your app carries a set of **capabilities** that Haven controls. Your app should check capabilities before attempting operations and adapt its UI accordingly.

package/TESTING.md

@@ -108,6 +108,24 @@ Each database entry can provide:
 - `methods.attachments`
 - `fulltextSetup` — the initial config returned by `db.getFulltextSetup()`; `db.setFulltextSetup()` overwrites it for the lifetime of the handle. Use this to test your app's full-text bootstrap logic. Note the mock evaluates `text` query clauses regardless of this config.
 - `summarySetup` — the initial config returned by `db.getSummarySetup()`; `db.setSummarySetup()` overwrites it for the lifetime of the handle. The mock's `query()` reads seeded documents directly and ignores this config; use it to test your app's summary bootstrap logic.
+- `automerge: true` — back every document with a real Automerge document, as Haven does (off by default: plain JSON with `mock-head-N` heads). `create`/`update` then return real Automerge heads, `update` applies `set`/`unset`, `json` (with `Automerge.changeAt(json.baseHeads)` when given) and `text` patches as Automerge changes with Haven's rules (missing parents and lists are created, `unset` is idempotent, `counterIncrement` needs a counter, an empty `json` patch is rejected), and `get`/`list`/`query` return the plain projection (atomic strings as strings, counters as numbers, timestamps as ISO strings). `richText` patches run Automerge's `updateSpans` at their `baseHeads` and `richTextSteps` splice and mark at theirs, both validated and with MindooDB's recovery, and `getRichText` returns `Automerge.spans` — so values Automerge rejects (an `immutableString` as a mark value) fail here as they do in Haven. A `richText` snapshot written at older `baseHeads` is applied on a fork at those heads and merged back, as MindooDB does (Automerge 3.5's `updateSpans` inside `changeAt` indexes the current text), so a concurrent edit of the same text survives. As in MindooDB's `applyDocumentUpdate`, all parts of one `update` whose `baseHeads` agree are applied as one Automerge change (one history entry), all or nothing. Seeds are built with a fixed actor, so two mocks from the same seed have identical heads. `mockDatabasesFromDefinition(definition, seed, { automerge: true })` and the test host URL setting `automerge=1` turn it on, too.
+
+#### Concurrent edits from another device
+
+`applyRemoteUpdate(databaseId, docId, input, { actor? })` on the controller (`createMockMindooDBAppSession`, `createFakeBridgeHost`, the browser test host and `window.__havenTestHost`) writes `input` as another device and syncs it in; live queries update as after any write. With `automerge: true` the device holds the history up to `input.json.baseHeads` (plus its own earlier changes) and writes as its own Automerge actor, so its edit truly merges with an app save at the same heads:
+
+```ts
+const doc = await database.documents.get("sheet-1");          // heads H
+await mock.applyRemoteUpdate("main", "sheet-1", {             // device B, at H
+  json: { baseHeads: doc!.heads, listInsert: [{ path: ["rows"], index: 1, values: ["remote"] }] },
+});
+const saved = await database.documents.update("sheet-1", {   // the app, also at H
+  json: { baseHeads: doc!.heads, listInsert: [{ path: ["rows"], index: 1, values: ["local"] }] },
+});
+// saved.data.rows keeps both entries; saved.heads has two heads
+```
+
+The relative order of concurrent inserts at the same index follows Automerge's op ids, as in Haven. Without `automerge`, `applyRemoteUpdate` is a plain update.
 
 ### Evaluating VirtualViews
 
@@ -161,6 +179,24 @@ const page = await navigator.entriesForward({ limit: 100 });
 Without `mindoodb`, the testing entrypoint falls back to an empty navigator and
 logs a warning — install the peer for realistic view tests.
 
+Views configured for the app in Haven arrive in `launchContext.views`. Pass
+them there and `session.openViewNavigator(viewId, options)` evaluates them
+over their source databases' seeded documents, compiled the way Haven does
+(rule or formula filter, field or formula columns). Each call opens a
+navigator of its own with its options applied (`rootCategoryPath`,
+`includeCategories`, `includeDocuments`, …), as in Haven; disposing one does
+not affect the others. A view created with `createViewNavigator` can be
+opened again by its definition id the same way.
+
+```ts
+const mock = createMockMindooDBAppBridge({
+  launchContext: { views: [contactsByCompany] }, // a MindooDBAppResolvedViewDefinition
+  databases: [{ info: { id: "main", title: "Main", capabilities: ["read", "views"] }, documents: contacts }],
+});
+const session = await mock.bridge.connect();
+const acme = await session.openViewNavigator("contacts_by_company", { rootCategoryPath: ["ACME"] });
+```
+
 The default in-memory document store also implements `documents.query()` and `documents.liveQuery()`: expression and formula-string filters are evaluated against the seeded documents, `sortBy`/`limit`/`offset` work as documented, and live query callbacks fire automatically after `create`/`update`/`delete`/`undelete` mutations. Full-text `text` clauses are supported with a deterministic mock implementation (token matching with prefix/AND semantics and an occurrence-count `textScore`) — assert on membership and relative ordering, not absolute scores, since real hosts use a BM25-style engine. That means app code built on queries and live queries is testable at Level 1 without any extra setup:
 
 ```ts
@@ -364,7 +400,7 @@ mountHavenTestHost({
 });
 ```
 
-The panel keeps its settings in the page URL, so a scenario can be linked or opened by Playwright directly: `/__haven-test/?db=main:read,attachments&db=archive:none&enforce=1&users=120&locale=de-DE&theme=dark` (`db=<id>:none` unmaps a database; URL settings win over the options). The same controls are scriptable as `window.__havenTestHost`:
+The panel keeps its settings in the page URL, so a scenario can be linked or opened by Playwright directly: `/__haven-test/?db=main:read,attachments&db=archive:none&enforce=1&users=120&locale=de-DE&theme=dark` (`db=<id>:none` unmaps a database; `automerge=1` backs all databases with Automerge documents; URL settings win over the options). The same controls are scriptable as `window.__havenTestHost`:
 
 ```ts
 await page.goto("/__haven-test/?enforce=1");
@@ -376,6 +412,9 @@ await page.evaluate(() => window.__havenTestHost!.setLocale("de-DE"));
 await page.evaluate(() => window.__havenTestHost!.setNextScan({ fileName: "receipt.pdf", mimeType: "application/pdf", size: 1024 }));
 await app.getByRole("button", { name: "Scan" }).click();
 expect(await page.evaluate(() => window.__havenTestHost!.log.scans)).toHaveLength(1);
+
+// with ?automerge=1: another device edits the document the app has open
+await page.evaluate(() => window.__havenTestHost!.applyRemoteUpdate("main", "sheet-1", { set: { title: "Renamed elsewhere" } }));
 ```
 
 Agent tools are scriptable through `window.__havenTestHost.agent`, the same controller the Vitest helpers expose as `createFakeBridgeHost().agent`:
@@ -401,6 +440,25 @@ Lower-level pieces, if you build your own page: `createBrowserTestHost({ frame,
 
 Keep the test page out of production builds. The starter template builds it only for `vite dev` and when `HAVEN_TEST_HOST=1` is set (for preview deployments), so the app's public URL keeps showing its landing page.
 
+### Two users on two replicas
+
+The panel's **Mode** section switches between *Single user* and *Two users* (keeping the other URL settings). `/__haven-test/?twoUsers=1` (or `mountHavenTestHost({ twoUsers: true })`) shows the app twice, side by side, as two people on two devices: each frame is launched by its own mock Haven with its own replica of every database (`automerge: true`, distinct Automerge actors), so their edits really are concurrent. The bar on top:
+
+- **Auto-sync every 2 s** (on by default) merges the replicas with `syncMockReplicas`, like Haven's sync. Turn it off to keep the two apart — two devices offline — edit on both sides, then press **Sync** and watch the merge.
+- The status says "✓ in sync" or how many documents still differ.
+
+Each app sees the other's changes the way it would in Haven (changefeed, live queries, or its own polling). Use it to try "one changes the text, the other the color", "both add a slide", "both format the same word" by hand. Playwright reaches both frames as `[data-testid="haven-two-users-frame-1"]` / `-2`, and `window.__havenTwoUsers` scripts the mode (`sync()`, `setAutoSync(on)`, `differences()`, `hosts`).
+
+In Vitest, two mocks with distinct `automergeActor`s plus `syncMockReplicas(a, b)` do the same without a browser:
+
+```ts
+const a = createMockMindooDBAppSession({ databases: [def()], automergeActor: "a1".repeat(16) });
+const b = createMockMindooDBAppSession({ databases: [def()], automergeActor: "b2".repeat(16) });
+// … edit through each session, then:
+await syncMockReplicas(a, b); // documents, deletions and attachments, both ways
+expect(mockReplicaDifferences(a, b)).toBe(0);
+```
+
 ## When to use which level
 
 Choose Level 1 when:

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

@@ -363,6 +363,89 @@ function readComponentFieldMatch(value, label, errors) {
   }
   return result;
 }
+var COMPONENT_CATEGORY_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
+var MINDOODB_APP_COMPONENT_CONTRACT_PATTERN = /^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)+@[1-9][0-9]{0,3}$/;
+var COMPONENT_CONTRACTS_MAX = 8;
+var COMPONENT_REFERENCES_MAX = 8;
+var COMPONENT_REFERENCE_SHOW_MAX = 8;
+function readComponentContracts(value, label, errors) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!Array.isArray(value) || value.length > COMPONENT_CONTRACTS_MAX) {
+    errors.push(`${label} must be an array of at most ${COMPONENT_CONTRACTS_MAX} contracts.`);
+    return void 0;
+  }
+  const result = [];
+  for (const [index, entry] of value.entries()) {
+    const contract = isPlainObject(entry) && typeof entry.contract === "string" ? entry.contract.trim() : "";
+    if (!MINDOODB_APP_COMPONENT_CONTRACT_PATTERN.test(contract)) {
+      errors.push(`${label}[${index}].contract must look like "mindoo.contacts.company@1".`);
+      return void 0;
+    }
+    let fields;
+    if (isPlainObject(entry) && entry.fields !== void 0) {
+      if (!isPlainObject(entry.fields)) {
+        errors.push(`${label}[${index}].fields must map contract fields to document fields.`);
+        return void 0;
+      }
+      fields = {};
+      for (const [from, to] of Object.entries(entry.fields)) {
+        if (!COMPONENT_FIELD_PATTERN.test(from) || typeof to !== "string" || !COMPONENT_FIELD_PATTERN.test(to)) {
+          errors.push(`${label}[${index}].fields must map field names to top-level field names.`);
+          return void 0;
+        }
+        fields[from] = to;
+      }
+    }
+    result.push({ contract, ...fields && Object.keys(fields).length ? { fields } : {} });
+  }
+  return result.length ? result : void 0;
+}
+function readComponentReferences(value, label, rootMatch, errors) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!Array.isArray(value) || value.length > COMPONENT_REFERENCES_MAX) {
+    errors.push(`${label} must be an array of at most ${COMPONENT_REFERENCES_MAX} references.`);
+    return void 0;
+  }
+  const result = [];
+  const fieldsSeen = /* @__PURE__ */ new Set();
+  for (const [index, entry] of value.entries()) {
+    const at = `${label}[${index}]`;
+    if (!isPlainObject(entry)) {
+      errors.push(`${at} must be an object.`);
+      return void 0;
+    }
+    const field = typeof entry.field === "string" ? entry.field.trim() : "";
+    if (!COMPONENT_FIELD_PATTERN.test(field) || field in rootMatch || fieldsSeen.has(field)) {
+      errors.push(`${at}.field must be a top-level field name, not a match field and not used twice.`);
+      return void 0;
+    }
+    fieldsSeen.add(field);
+    const to = typeof entry.to === "string" ? entry.to.trim() : void 0;
+    if (entry.to !== void 0 && !MINDOODB_APP_COMPONENT_CONTRACT_PATTERN.test(to ?? "")) {
+      errors.push(`${at}.to must look like "mindoo.contacts.company@1".`);
+      return void 0;
+    }
+    const match = readComponentFieldMatch(entry.match, `${at}.match`, errors);
+    if (!match) {
+      return void 0;
+    }
+    if (!Object.keys(match).length) {
+      errors.push(`${at}.match must name at least one field, or every document could be referenced.`);
+      return void 0;
+    }
+    const show = Array.isArray(entry.show) ? entry.show.filter((name) => typeof name === "string" && COMPONENT_FIELD_PATTERN.test(name)) : [];
+    if (!show.length || show.length !== entry.show.length || show.length > COMPONENT_REFERENCE_SHOW_MAX) {
+      errors.push(`${at}.show must list 1-${COMPONENT_REFERENCE_SHOW_MAX} top-level field names.`);
+      return void 0;
+    }
+    result.push({ field, ...to ? { to } : {}, match, show: [...new Set(show)] });
+  }
+  return result.length ? result : void 0;
+}
 function readComponents(value, errors) {
   if (value === void 0 || value === null) {
     return void 0;
@@ -475,6 +558,16 @@ function readComponents(value, errors) {
       }
       children = { linkField, ...childMatch && Object.keys(childMatch).length ? { match: childMatch } : {} };
     }
+    let category;
+    if (entry.category !== void 0) {
+      category = typeof entry.category === "string" ? entry.category.trim() : "";
+      if (!COMPONENT_CATEGORY_PATTERN.test(category)) {
+        errors.push(`${label}.category must be 1-32 lowercase letters, digits or "-", e.g. "editor" or "form".`);
+        return;
+      }
+    }
+    const provides = readComponentContracts(entry.provides, `${label}.provides`, errors);
+    const references = readComponentReferences(entry.references, `${label}.references`, match, errors);
     if (errors.length !== errorCount) {
       return;
     }
@@ -486,7 +579,10 @@ function readComponents(value, errors) {
       intents,
       match,
       ...create ? { create } : {},
-      ...children ? { children } : {}
+      ...children ? { children } : {},
+      ...category ? { category } : {},
+      ...provides ? { provides } : {},
+      ...references ? { references } : {}
     });
   });
   return result.length ? result : void 0;
@@ -1174,7 +1270,8 @@ var MindooDBAppAgentApiImpl = class {
         name: tool.name,
         description: tool.description,
         inputSchema: toJson(tool.inputSchema),
-        ...tool.annotations ? { annotations: { ...tool.annotations } } : {}
+        ...tool.annotations ? { annotations: { ...tool.annotations } } : {},
+        ...tool.scope ? { scope: tool.scope } : {}
       }))
     });
   }
@@ -1438,6 +1535,8 @@ var MindooDBAppEmbedImpl = class {
   dirtyListeners = /* @__PURE__ */ new Set();
   dirtyState = void 0;
   tracker = null;
+  toolsState = null;
+  toolsListeners = /* @__PURE__ */ new Set();
   get placement() {
     return this.frame ? "frame" : "overlay";
   }
@@ -1470,6 +1569,56 @@ var MindooDBAppEmbedImpl = class {
     }
     await this.rpc.call("embeds.save", { embedId: this.embedId });
   }
+  async setActive() {
+    if (this.closedEvent) {
+      return;
+    }
+    await this.rpc.call("embeds.setActive", { embedId: this.embedId });
+  }
+  get agentTools() {
+    return this.toolsState;
+  }
+  onAgentToolsChange(listener) {
+    this.toolsListeners.add(listener);
+    return () => {
+      this.toolsListeners.delete(listener);
+    };
+  }
+  /** Haven reported the component's agent tools. */
+  setAgentToolsState(tools) {
+    if (this.closedEvent) {
+      return;
+    }
+    this.toolsState = tools ? { ...tools, names: [...tools.names] } : null;
+    this.toolsListeners.forEach((listener) => {
+      try {
+        listener(this.toolsState);
+      } catch (error) {
+        console.error("MindooDB embed agent tools listener failed.", error);
+      }
+    });
+  }
+  waitForAgentTools(timeoutMs = 1e4) {
+    if (this.toolsState?.names.length) {
+      return Promise.resolve(this.toolsState);
+    }
+    if (this.closedEvent) {
+      return Promise.resolve(null);
+    }
+    return new Promise((resolve) => {
+      const finish = (tools) => {
+        clearTimeout(timer);
+        stopTools();
+        stopClosed();
+        resolve(tools);
+      };
+      const timer = setTimeout(() => finish(null), timeoutMs);
+      const stopTools = this.onAgentToolsChange((tools) => {
+        if (tools?.names.length) finish(tools);
+      });
+      const stopClosed = this.onClosed(() => finish(null));
+    });
+  }
   async setRect(rect) {
     if (this.closedEvent) {
       return;
@@ -1524,6 +1673,15 @@ var MindooDBAppEmbedImpl = class {
     });
     this.listeners.clear();
     this.dirtyListeners.clear();
+    this.toolsState = null;
+    this.toolsListeners.forEach((listener) => {
+      try {
+        listener(null);
+      } catch (error) {
+        console.error("MindooDB embed agent tools listener failed.", error);
+      }
+    });
+    this.toolsListeners.clear();
   }
 };
 var MindooDBAppEmbedsClient = class {
@@ -1547,6 +1705,16 @@ var MindooDBAppEmbedsClient = class {
         }
         return;
       }
+      if (message.event?.type === "agentTools") {
+        const { embedId, agentTools } = message.event;
+        const embed2 = this.open.get(embedId);
+        if (embed2) {
+          embed2.setAgentToolsState(agentTools ?? null);
+        } else {
+          this.earlyTools.set(embedId, agentTools ?? null);
+        }
+        return;
+      }
       if (message.event?.type !== "closed") {
         return;
       }
@@ -1591,6 +1759,10 @@ var MindooDBAppEmbedsClient = class {
           this.earlyDirty.delete(embed.embedId);
           embed.setDirtyState(earlyDirty);
         }
+        if (this.earlyTools.has(embed.embedId)) {
+          embed.setAgentToolsState(this.earlyTools.get(embed.embedId) ?? null);
+          this.earlyTools.delete(embed.embedId);
+        }
         const early = this.early.get(embed.embedId);
         if (early) {
           this.early.delete(embed.embedId);
@@ -1617,6 +1789,15 @@ var MindooDBAppEmbedsClient = class {
       setDirty: async (dirty) => {
         await this.rpc.call("embedding.setDirty", { dirty: dirty === true });
       },
+      lookup: async (field, options) => {
+        const result = await this.rpc.call("embedding.lookup", {
+          field: String(field),
+          ...options?.query ? { query: String(options.query) } : {},
+          ...options?.docIds ? { docIds: options.docIds.map(String) } : {},
+          ...options?.limit ? { limit: Number(options.limit) } : {}
+        });
+        return Array.isArray(result) ? result : [];
+      },
       onSaveRequest: (handler) => {
         this.saveHandler = handler;
         return () => {
@@ -1635,6 +1816,7 @@ var MindooDBAppEmbedsClient = class {
   /** Events that arrived before `embeds.open` resolved with their id. */
   early = /* @__PURE__ */ new Map();
   earlyDirty = /* @__PURE__ */ new Map();
+  earlyTools = /* @__PURE__ */ new Map();
   stopListening;
   /** This app as a component: what to do when its host asks it to save. */
   saveHandler = null;
@@ -3370,6 +3552,7 @@ export {
   validateMindooDBAppAccepts,
   mindooDBAppAcceptMatchesType,
   MINDOODB_APP_COMPONENTS_MAX,
+  MINDOODB_APP_COMPONENT_CONTRACT_PATTERN,
   validateMindooDBAppComponents,
   mindooDBAppComponentFieldsMatch,
   resolveMindooDBAppLocalizedText,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppDragBindSourceOptions, b as MindooDBAppDragStartInput, c as MindooDBAppDragStartResult, d as MindooDBAppDragPreview, e as MindooDBAppBridge, f as MindooDBAppAgentToolErrorCode, g as MindooDBAppHostShortcutBinding, h as MindooDBAppHostShortcutAction, i as MindooDBAppHostingMode, j as MindooDBAppDefinition, k as MindooDBAppDatabase, l as MindooDBAppDocument, m as MindooDBAppRichTextSpan, n as MindooDBAppRichTextSnapshot, o as MindooDBAppCreateDocumentInput } from './types-BeRUxGKN.js';
-export { p as MINDOODB_APP_ACCEPTS_MAX, q as MINDOODB_APP_COMPONENTS_MAX, r as MINDOODB_APP_DEFINITION_FILE_NAME, s as MINDOODB_APP_DEFINITION_FORMAT, t as MINDOODB_APP_DEFINITION_PERMISSIONS, u as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, v as MINDOODB_APP_DEFINITION_VERSION, w as MINDOODB_APP_LISTING_DESCRIPTION_MAX, x as MINDOODB_APP_LISTING_MAX_SCREENSHOTS, y as MINDOODB_APP_LISTING_SUMMARY_MAX, z as MINDOODB_APP_SEAL_SIGNING_DOMAIN, A as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, B as MindooDBAppAcceptSpec, C as MindooDBAppAccessDecision, D as MindooDBAppAccessTier, E as MindooDBAppAgentApi, F as MindooDBAppAgentRegistration, G as MindooDBAppAgentTool, H as MindooDBAppAgentToolAnnotations, I as MindooDBAppAgentToolDescriptor, J as MindooDBAppAttachmentApi, K as MindooDBAppAttachmentChunk, L as MindooDBAppAttachmentInfo, N as MindooDBAppAttachmentPreviewOptions, O as MindooDBAppAttachmentPreviewSession, P as MindooDBAppAutomergeChangesPatch, Q as MindooDBAppAutomergeChangesSince, R as MindooDBAppAutomergeGetOptions, S as MindooDBAppAutomergePatchResult, T as MindooDBAppAutomergeSnapshot, U as MindooDBAppBridgeAgentInvokeMessage, V as MindooDBAppBridgeAgentResultMessage, W as MindooDBAppBridgeBeforeCloseAck, X as MindooDBAppBridgeBeforeCloseMessage, Y as MindooDBAppBridgeConnectMessage, Z as MindooDBAppBridgeConnectOptions, _ as MindooDBAppBridgeConnectedMessage, $ as MindooDBAppBridgeDragDropMessage, a0 as MindooDBAppBridgeDragLeaveMessage, a1 as MindooDBAppBridgeDragOverMessage, a2 as MindooDBAppBridgeEmbedEventMessage, a3 as MindooDBAppBridgeEmbeddingRequestMessage, a4 as MindooDBAppBridgeErrorPayload, a5 as MindooDBAppBridgeHandshakeErrorMessage, a6 as MindooDBAppBridgeHostFocusChangedMessage, a7 as MindooDBAppBridgeIncomingContentMessage, a8 as MindooDBAppBridgeLocaleChangedMessage, a9 as MindooDBAppBridgePortMessage, aa as MindooDBAppBridgeQueryResultMessage, ab as MindooDBAppBridgeRpcError, ac as MindooDBAppBridgeRpcMessage, ad as MindooDBAppBridgeRpcRequest, ae as MindooDBAppBridgeRpcSuccess, af as MindooDBAppBridgeShortcutInvokedMessage, ag as MindooDBAppBridgeShortcutsChangedMessage, ah as MindooDBAppBridgeStreamAbortRequest, ai as MindooDBAppBridgeStreamAck, aj as MindooDBAppBridgeStreamCloseRequest, ak as MindooDBAppBridgeStreamError, al as MindooDBAppBridgeStreamMessage, am as MindooDBAppBridgeStreamOpenResult, an as MindooDBAppBridgeStreamReadRequest, ao as MindooDBAppBridgeStreamWriteRequest, ap as MindooDBAppBridgeThemeChangedMessage, aq as MindooDBAppBridgeUiPreferencesChangedMessage, ar as MindooDBAppBridgeViewChangedMessage, as as MindooDBAppBridgeViewportChangedMessage, at as MindooDBAppBridgeWorkspaceFocusRequestedMessage, au as MindooDBAppBrowserFeatures, av as MindooDBAppCapability, aw as MindooDBAppComponentChildren, ax as MindooDBAppComponentFieldValue, ay as MindooDBAppComponentInfo, az as MindooDBAppComponentIntent, aA as MindooDBAppComponentQuery, aB as MindooDBAppComponentSpec, aC as MindooDBAppComponentsApi, aD as MindooDBAppConfiguredViewCategorizationStyle, aE as MindooDBAppConfiguredViewColumn, aF as MindooDBAppConfiguredViewColumnRole, aG as MindooDBAppConfiguredViewExpressionMode, aH as MindooDBAppConfiguredViewFieldExpression, aI as MindooDBAppConfiguredViewFilterDefinition, aJ as MindooDBAppConfiguredViewFilterMode, aK as MindooDBAppConfiguredViewFilterRule, aL as MindooDBAppConfiguredViewFormulaExpression, aM as MindooDBAppConfiguredViewFormulaFilterDefinition, aN as MindooDBAppConfiguredViewPreviewMode, aO as MindooDBAppConfiguredViewRuleFilterDefinition, aP as MindooDBAppConfiguredViewRuleMatchMode, aQ as MindooDBAppConfiguredViewRuleOperator, aR as MindooDBAppConfiguredViewValueExpression, aS as MindooDBAppCreateKeyInfo, aT as MindooDBAppCreateViewInput, aU as MindooDBAppCreateViewNavigatorInput, aV as MindooDBAppDatabaseInfo, aW as MindooDBAppDefinitionDatabase, aX as MindooDBAppDefinitionListing, aY as MindooDBAppDefinitionPermission, aZ as MindooDBAppDefinitionRegistrationPermission, a_ as MindooDBAppDefinitionScreenshot, a$ as MindooDBAppDefinitionValidation, b0 as MindooDBAppDirectoryApi, b1 as MindooDBAppDirectoryEntry, b2 as MindooDBAppDocumentApi, b3 as MindooDBAppDocumentHeadCursorResult, b4 as MindooDBAppDocumentHistoryEntry, b5 as MindooDBAppDocumentListQuery, b6 as MindooDBAppDocumentListResult, b7 as MindooDBAppDocumentQuery, b8 as MindooDBAppDocumentRevisionId, b9 as MindooDBAppDocumentScanPreset, ba as MindooDBAppDocumentSummary, bb as MindooDBAppDragApi, bc as MindooDBAppDragCancelReason, bd as MindooDBAppDragDropEvent, be as MindooDBAppDragEffect, bf as MindooDBAppDragHoverResult, bg as MindooDBAppDragOffer, bh as MindooDBAppDragOverEvent, bi as MindooDBAppDragPointer, bj as MindooDBAppDragProfile, bk as MindooDBAppEmbed, bl as MindooDBAppEmbedCloseReason, bm as MindooDBAppEmbedClosedEvent, bn as MindooDBAppEmbedContext, bo as MindooDBAppEmbedDirtyEvent, bp as MindooDBAppEmbedOpenInput, bq as MindooDBAppEmbedRect, br as MindooDBAppEmbeddingApi, bs as MindooDBAppEmbedsApi, bt as MindooDBAppEntryAttachmentRef, bu as MindooDBAppEntryProvenance, bv as MindooDBAppExtractDocumentTextInput, bw as MindooDBAppExtractDocumentTextResult, bx as MindooDBAppExtractTextFormat, by as MindooDBAppExtractionSetup, bz as MindooDBAppFulltextSetup, bA as MindooDBAppHistoricalDocument, bB as MindooDBAppHistoryQuery, bC as MindooDBAppHostTheme, bD as MindooDBAppIdentityApi, bE as MindooDBAppInaccessibleDocument, bF as MindooDBAppInaccessibleDocumentListQuery, bG as MindooDBAppInaccessibleDocumentListResult, bH as MindooDBAppIncomingContent, bI as MindooDBAppIncomingContentHandler, bJ as MindooDBAppIncomingContentInfo, bK as MindooDBAppIncomingItem, bL as MindooDBAppIncomingItemInfo, bM as MindooDBAppIncomingResult, bN as MindooDBAppIncomingSource, bO as MindooDBAppJsonCounterIncrementPatch, bP as MindooDBAppJsonListDeletePatch, bQ as MindooDBAppJsonListInsertPatch, bR as MindooDBAppJsonPatch, bS as MindooDBAppJsonSetPatch, bT as MindooDBAppJsonTextMarkPatch, bU as MindooDBAppJsonTextSplicePatch, bV as MindooDBAppJsonTextUnmarkPatch, bW as MindooDBAppJsonUnsetPatch, bX as MindooDBAppLaunchContext, bY as MindooDBAppListUsersOptions, bZ as MindooDBAppListUsersPage, b_ as MindooDBAppLiveQuerySubscription, b$ as MindooDBAppLocalizedText, c0 as MindooDBAppMenuAnchor, c1 as MindooDBAppMenuApi, c2 as MindooDBAppMenuCommandItem, c3 as MindooDBAppMenuDismissReason, c4 as MindooDBAppMenuDismissedResult, c5 as MindooDBAppMenuItem, c6 as MindooDBAppMenuKind, c7 as MindooDBAppMenuPlacement, c8 as MindooDBAppMenuPointAnchor, c9 as MindooDBAppMenuRect, ca as MindooDBAppMenuRectAnchor, cb as MindooDBAppMenuSelectionResult, cc as MindooDBAppMenuSeparatorItem, cd as MindooDBAppNotificationSeverity, ce as MindooDBAppNotifyInput, cf as MindooDBAppNotifyResult, cg as MindooDBAppProposeAppInput, ch as MindooDBAppProposeAppResult, ci as MindooDBAppQueryCoverage, cj as MindooDBAppQueryInclude, ck as MindooDBAppQueryIncludeCardinality, cl as MindooDBAppQueryIncludeSlots, cm as MindooDBAppQueryResult, cn as MindooDBAppQueryRow, co as MindooDBAppQuerySortKey, cp as MindooDBAppQueryTextClause, cq as MindooDBAppReadableAttachmentStream, cr as MindooDBAppRecipientOptions, cs as MindooDBAppResolvedViewDefinition, ct as MindooDBAppResolvedViewSource, cu as MindooDBAppRevisionPhase, cv as MindooDBAppRevisionVerification, cw as MindooDBAppRichTextBlockSpan, cx as MindooDBAppRichTextGetOptions, cy as MindooDBAppRichTextImmutableString, cz as MindooDBAppRichTextMarkRange, cA as MindooDBAppRichTextMaterializeValue, cB as MindooDBAppRichTextPatch, cC as MindooDBAppRichTextScalar, cD as MindooDBAppRichTextSpliceStep, cE as MindooDBAppRichTextStep, cF as MindooDBAppRichTextStepPatch, cG as MindooDBAppRichTextTextSpan, cH as MindooDBAppRuntime, cI as MindooDBAppScanAttachmentOptions, cJ as MindooDBAppScanAttachmentResult, cK as MindooDBAppScopedDocId, cL as MindooDBAppScopedDocumentSummary, cM as MindooDBAppSealIntent, cN as MindooDBAppSealedChannelOpenInput, cO as MindooDBAppSealedChannelOpenResult, cP as MindooDBAppSealedChannelRequestInput, cQ as MindooDBAppSession, cR as MindooDBAppShowMenuInput, cS as MindooDBAppShowMenuResult, cT as MindooDBAppSignPreview, cU as MindooDBAppSignPreviewScope, cV as MindooDBAppSignStatementInput, cW as MindooDBAppSignStatementResult, cX as MindooDBAppStorageApi, cY as MindooDBAppSummarySetup, cZ as MindooDBAppTextCursorOptions, c_ as MindooDBAppTextCursorPosition, c$ as MindooDBAppTextCursorPositionsResult, d0 as MindooDBAppTextCursorsResult, d1 as MindooDBAppTextEdit, d2 as MindooDBAppTextPatch, d3 as MindooDBAppThemeMode, d4 as MindooDBAppTimestampApi, d5 as MindooDBAppTimestampInput, d6 as MindooDBAppTimestampProvider, d7 as MindooDBAppTimestampResult, d8 as MindooDBAppUiPreferences, d9 as MindooDBAppUpdateDocumentInput, da as MindooDBAppViewCursorDocumentListResult, db as MindooDBAppViewCursorResult, dc as MindooDBAppViewEntry, dd as MindooDBAppViewEntryKind, de as MindooDBAppViewNavigator, df as MindooDBAppViewNavigatorExpansionState, dg as MindooDBAppViewNavigatorOpenOptions, dh as MindooDBAppViewNavigatorPageOptions, di as MindooDBAppViewNavigatorPageResult, dj as MindooDBAppViewNavigatorRangeQuery, dk as MindooDBAppViewNavigatorSelectionState, dl as MindooDBAppViewUpdateStats, dm as MindooDBAppViewport, dn as MindooDBAppWellKnownDragType, dp as MindooDBAppWritableAttachmentStream, dq as mindooDBAppAcceptMatchesType, dr as mindooDBAppComponentFieldsMatch, ds as resolveMindooDBAppDefinitionUrl, dt as resolveMindooDBAppListingAssetUrl, du as resolveMindooDBAppLocalizedText, dv as validateMindooDBAppAccepts, dw as validateMindooDBAppComponents, dx as validateMindooDBAppDefinition } from './types-BeRUxGKN.js';
+import { M as MindooDBAppAttachmentPreviewMode, a as MindooDBAppDragBindSourceOptions, b as MindooDBAppDragStartInput, c as MindooDBAppDragStartResult, d as MindooDBAppDragPreview, e as MindooDBAppBridge, f as MindooDBAppAgentToolErrorCode, g as MindooDBAppHostShortcutBinding, h as MindooDBAppHostShortcutAction, i as MindooDBAppHostingMode, j as MindooDBAppDefinition, k as MindooDBAppDatabase, l as MindooDBAppDocument, m as MindooDBAppRichTextSpan, n as MindooDBAppRichTextSnapshot, o as MindooDBAppCreateDocumentInput } from './types-Cuw-0Iou.js';
+export { p as MINDOODB_APP_ACCEPTS_MAX, q as MINDOODB_APP_COMPONENTS_MAX, r as MINDOODB_APP_COMPONENT_CONTRACT_PATTERN, s as MINDOODB_APP_DEFINITION_FILE_NAME, t as MINDOODB_APP_DEFINITION_FORMAT, u as MINDOODB_APP_DEFINITION_PERMISSIONS, v as MINDOODB_APP_DEFINITION_REGISTRATION_PERMISSIONS, w as MINDOODB_APP_DEFINITION_VERSION, x as MINDOODB_APP_LISTING_DESCRIPTION_MAX, y as MINDOODB_APP_LISTING_MAX_SCREENSHOTS, z as MINDOODB_APP_LISTING_SUMMARY_MAX, A as MINDOODB_APP_SEAL_SIGNING_DOMAIN, B as MINDOODB_APP_WELL_KNOWN_DRAG_TYPES, C as MindooDBAppAcceptSpec, D as MindooDBAppAccessDecision, E as MindooDBAppAccessTier, F as MindooDBAppAgentApi, G as MindooDBAppAgentRegistration, H as MindooDBAppAgentTool, I as MindooDBAppAgentToolAnnotations, J as MindooDBAppAgentToolDescriptor, K as MindooDBAppAgentToolScope, L as MindooDBAppAttachmentApi, N as MindooDBAppAttachmentChunk, O as MindooDBAppAttachmentInfo, P as MindooDBAppAttachmentPreviewOptions, Q as MindooDBAppAttachmentPreviewSession, R as MindooDBAppAutomergeChangesPatch, S as MindooDBAppAutomergeChangesSince, T as MindooDBAppAutomergeGetOptions, U as MindooDBAppAutomergePatchResult, V as MindooDBAppAutomergeSnapshot, W as MindooDBAppBridgeAgentInvokeMessage, X as MindooDBAppBridgeAgentResultMessage, Y as MindooDBAppBridgeBeforeCloseAck, Z as MindooDBAppBridgeBeforeCloseMessage, _ as MindooDBAppBridgeConnectMessage, $ as MindooDBAppBridgeConnectOptions, a0 as MindooDBAppBridgeConnectedMessage, a1 as MindooDBAppBridgeDragDropMessage, a2 as MindooDBAppBridgeDragLeaveMessage, a3 as MindooDBAppBridgeDragOverMessage, a4 as MindooDBAppBridgeEmbedEventMessage, a5 as MindooDBAppBridgeEmbeddingRequestMessage, a6 as MindooDBAppBridgeErrorPayload, a7 as MindooDBAppBridgeHandshakeErrorMessage, a8 as MindooDBAppBridgeHostFocusChangedMessage, a9 as MindooDBAppBridgeIncomingContentMessage, aa as MindooDBAppBridgeLocaleChangedMessage, ab as MindooDBAppBridgePortMessage, ac as MindooDBAppBridgeQueryResultMessage, ad as MindooDBAppBridgeRpcError, ae as MindooDBAppBridgeRpcMessage, af as MindooDBAppBridgeRpcRequest, ag as MindooDBAppBridgeRpcSuccess, ah as MindooDBAppBridgeShortcutInvokedMessage, ai as MindooDBAppBridgeShortcutsChangedMessage, aj as MindooDBAppBridgeStreamAbortRequest, ak as MindooDBAppBridgeStreamAck, al as MindooDBAppBridgeStreamCloseRequest, am as MindooDBAppBridgeStreamError, an as MindooDBAppBridgeStreamMessage, ao as MindooDBAppBridgeStreamOpenResult, ap as MindooDBAppBridgeStreamReadRequest, aq as MindooDBAppBridgeStreamWriteRequest, ar as MindooDBAppBridgeThemeChangedMessage, as as MindooDBAppBridgeUiPreferencesChangedMessage, at as MindooDBAppBridgeViewChangedMessage, au as MindooDBAppBridgeViewportChangedMessage, av as MindooDBAppBridgeWorkspaceFocusRequestedMessage, aw as MindooDBAppBrowserFeatures, ax as MindooDBAppCapability, ay as MindooDBAppComponentCategory, az as MindooDBAppComponentChildren, aA as MindooDBAppComponentContract, aB as MindooDBAppComponentFieldValue, aC as MindooDBAppComponentInfo, aD as MindooDBAppComponentIntent, aE as MindooDBAppComponentQuery, aF as MindooDBAppComponentReference, aG as MindooDBAppComponentSpec, aH as MindooDBAppComponentsApi, aI as MindooDBAppConfiguredViewCategorizationStyle, aJ as MindooDBAppConfiguredViewColumn, aK as MindooDBAppConfiguredViewColumnRole, aL as MindooDBAppConfiguredViewExpressionMode, aM as MindooDBAppConfiguredViewFieldExpression, aN as MindooDBAppConfiguredViewFilterDefinition, aO as MindooDBAppConfiguredViewFilterMode, aP as MindooDBAppConfiguredViewFilterRule, aQ as MindooDBAppConfiguredViewFormulaExpression, aR as MindooDBAppConfiguredViewFormulaFilterDefinition, aS as MindooDBAppConfiguredViewPreviewMode, aT as MindooDBAppConfiguredViewRuleFilterDefinition, aU as MindooDBAppConfiguredViewRuleMatchMode, aV as MindooDBAppConfiguredViewRuleOperator, aW as MindooDBAppConfiguredViewValueExpression, aX as MindooDBAppCreateKeyInfo, aY as MindooDBAppCreateViewInput, aZ as MindooDBAppCreateViewNavigatorInput, a_ as MindooDBAppDatabaseInfo, a$ as MindooDBAppDefinitionDatabase, b0 as MindooDBAppDefinitionListing, b1 as MindooDBAppDefinitionPermission, b2 as MindooDBAppDefinitionRegistrationPermission, b3 as MindooDBAppDefinitionScreenshot, b4 as MindooDBAppDefinitionValidation, b5 as MindooDBAppDirectoryApi, b6 as MindooDBAppDirectoryEntry, b7 as MindooDBAppDocumentApi, b8 as MindooDBAppDocumentHeadCursorResult, b9 as MindooDBAppDocumentHistoryEntry, ba as MindooDBAppDocumentListQuery, bb as MindooDBAppDocumentListResult, bc as MindooDBAppDocumentQuery, bd as MindooDBAppDocumentRevisionId, be as MindooDBAppDocumentScanPreset, bf as MindooDBAppDocumentSummary, bg as MindooDBAppDragApi, bh as MindooDBAppDragCancelReason, bi as MindooDBAppDragDropEvent, bj as MindooDBAppDragEffect, bk as MindooDBAppDragHoverResult, bl as MindooDBAppDragOffer, bm as MindooDBAppDragOverEvent, bn as MindooDBAppDragPointer, bo as MindooDBAppDragProfile, bp as MindooDBAppEmbed, bq as MindooDBAppEmbedAgentTools, br as MindooDBAppEmbedAgentToolsEvent, bs as MindooDBAppEmbedCloseReason, bt as MindooDBAppEmbedClosedEvent, bu as MindooDBAppEmbedContext, bv as MindooDBAppEmbedDirtyEvent, bw as MindooDBAppEmbedOpenInput, bx as MindooDBAppEmbedRect, by as MindooDBAppEmbeddingApi, bz as MindooDBAppEmbeddingLookupOptions, bA as MindooDBAppEmbeddingLookupResult, bB as MindooDBAppEmbedsApi, bC as MindooDBAppEntryAttachmentRef, bD as MindooDBAppEntryProvenance, bE as MindooDBAppExtractDocumentTextInput, bF as MindooDBAppExtractDocumentTextResult, bG as MindooDBAppExtractTextFormat, bH as MindooDBAppExtractionSetup, bI as MindooDBAppFulltextSetup, bJ as MindooDBAppHistoricalDocument, bK as MindooDBAppHistoryQuery, bL as MindooDBAppHostTheme, bM as MindooDBAppIdentityApi, bN as MindooDBAppInaccessibleDocument, bO as MindooDBAppInaccessibleDocumentListQuery, bP as MindooDBAppInaccessibleDocumentListResult, bQ as MindooDBAppIncomingContent, bR as MindooDBAppIncomingContentHandler, bS as MindooDBAppIncomingContentInfo, bT as MindooDBAppIncomingItem, bU as MindooDBAppIncomingItemInfo, bV as MindooDBAppIncomingResult, bW as MindooDBAppIncomingSource, bX as MindooDBAppJsonCounterIncrementPatch, bY as MindooDBAppJsonListDeletePatch, bZ as MindooDBAppJsonListInsertPatch, b_ as MindooDBAppJsonPatch, b$ as MindooDBAppJsonSetPatch, c0 as MindooDBAppJsonTextMarkPatch, c1 as MindooDBAppJsonTextSplicePatch, c2 as MindooDBAppJsonTextUnmarkPatch, c3 as MindooDBAppJsonUnsetPatch, c4 as MindooDBAppLaunchContext, c5 as MindooDBAppListUsersOptions, c6 as MindooDBAppListUsersPage, c7 as MindooDBAppLiveQuerySubscription, c8 as MindooDBAppLocalizedText, c9 as MindooDBAppMenuAnchor, ca as MindooDBAppMenuApi, cb as MindooDBAppMenuCommandItem, cc as MindooDBAppMenuDismissReason, cd as MindooDBAppMenuDismissedResult, ce as MindooDBAppMenuItem, cf as MindooDBAppMenuKind, cg as MindooDBAppMenuPlacement, ch as MindooDBAppMenuPointAnchor, ci as MindooDBAppMenuRect, cj as MindooDBAppMenuRectAnchor, ck as MindooDBAppMenuSelectionResult, cl as MindooDBAppMenuSeparatorItem, cm as MindooDBAppNotificationSeverity, cn as MindooDBAppNotifyInput, co as MindooDBAppNotifyResult, cp as MindooDBAppProposeAppInput, cq as MindooDBAppProposeAppResult, cr as MindooDBAppQueryCoverage, cs as MindooDBAppQueryInclude, ct as MindooDBAppQueryIncludeCardinality, cu as MindooDBAppQueryIncludeSlots, cv as MindooDBAppQueryResult, cw as MindooDBAppQueryRow, cx as MindooDBAppQuerySortKey, cy as MindooDBAppQueryTextClause, cz as MindooDBAppReadableAttachmentStream, cA as MindooDBAppRecipientOptions, cB as MindooDBAppResolvedViewDefinition, cC as MindooDBAppResolvedViewSource, cD as MindooDBAppRevisionPhase, cE as MindooDBAppRevisionVerification, cF as MindooDBAppRichTextBlockSpan, cG as MindooDBAppRichTextGetOptions, cH as MindooDBAppRichTextImmutableString, cI as MindooDBAppRichTextMarkRange, cJ as MindooDBAppRichTextMaterializeValue, cK as MindooDBAppRichTextPatch, cL as MindooDBAppRichTextScalar, cM as MindooDBAppRichTextSpliceStep, cN as MindooDBAppRichTextStep, cO as MindooDBAppRichTextStepPatch, cP as MindooDBAppRichTextTextSpan, cQ as MindooDBAppRuntime, cR as MindooDBAppScanAttachmentOptions, cS as MindooDBAppScanAttachmentResult, cT as MindooDBAppScopedDocId, cU as MindooDBAppScopedDocumentSummary, cV as MindooDBAppSealIntent, cW as MindooDBAppSealedChannelOpenInput, cX as MindooDBAppSealedChannelOpenResult, cY as MindooDBAppSealedChannelRequestInput, cZ as MindooDBAppSession, c_ as MindooDBAppShowMenuInput, c$ as MindooDBAppShowMenuResult, d0 as MindooDBAppSignPreview, d1 as MindooDBAppSignPreviewScope, d2 as MindooDBAppSignStatementInput, d3 as MindooDBAppSignStatementResult, d4 as MindooDBAppStorageApi, d5 as MindooDBAppSummarySetup, d6 as MindooDBAppTextCursorOptions, d7 as MindooDBAppTextCursorPosition, d8 as MindooDBAppTextCursorPositionsResult, d9 as MindooDBAppTextCursorsResult, da as MindooDBAppTextEdit, db as MindooDBAppTextPatch, dc as MindooDBAppThemeMode, dd as MindooDBAppTimestampApi, de as MindooDBAppTimestampInput, df as MindooDBAppTimestampProvider, dg as MindooDBAppTimestampResult, dh as MindooDBAppUiPreferences, di as MindooDBAppUpdateDocumentInput, dj as MindooDBAppViewCursorDocumentListResult, dk as MindooDBAppViewCursorResult, dl as MindooDBAppViewEntry, dm as MindooDBAppViewEntryKind, dn as MindooDBAppViewNavigator, dp as MindooDBAppViewNavigatorExpansionState, dq as MindooDBAppViewNavigatorOpenOptions, dr as MindooDBAppViewNavigatorPageOptions, ds as MindooDBAppViewNavigatorPageResult, dt as MindooDBAppViewNavigatorRangeQuery, du as MindooDBAppViewNavigatorSelectionState, dv as MindooDBAppViewUpdateStats, dw as MindooDBAppViewport, dx as MindooDBAppWellKnownDragType, dy as MindooDBAppWritableAttachmentStream, dz as mindooDBAppAcceptMatchesType, dA as mindooDBAppComponentFieldsMatch, dB as resolveMindooDBAppDefinitionUrl, dC as resolveMindooDBAppListingAssetUrl, dD as resolveMindooDBAppLocalizedText, dE as validateMindooDBAppAccepts, dF as validateMindooDBAppComponents, dG as validateMindooDBAppDefinition } from './types-Cuw-0Iou.js';
 export { M as MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME, a as MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME, b as MINDOODB_APP_BUNDLE_MANIFEST_FORMAT, c as MINDOODB_APP_BUNDLE_MANIFEST_VERSION, d as MindooDBAppBundleArchive, e as MindooDBAppBundleFileEntry, f as MindooDBAppBundleHash, g as MindooDBAppBundleManifest, h as MindooDBAppBundleManifestValidation, i as buildMindooDBAppBundleContentHashInput, j as isMindooDBAppBundleHash, n as normalizeMindooDBAppBundlePath, v as validateMindooDBAppBundleManifest } from './appBundleManifest-B0xfpaXG.js';
 import { MindooDBAppBooleanExpression } from 'mindoodb-view-language';
 export { MindooDBAppBooleanExpression, MindooDBAppExpression, MindooDBAppFilterDefinition, MindooDBAppViewCategoryChildrenPageRequest, MindooDBAppViewColumn, MindooDBAppViewColumnRole, MindooDBAppViewDefinition, MindooDBAppViewExpansionState, MindooDBAppViewExpressionBase, MindooDBAppViewExpressionDatePart, MindooDBAppViewExpressionOperation, MindooDBAppViewFieldExpression, MindooDBAppViewIfExpression, MindooDBAppViewLetExpression, MindooDBAppViewLiteralExpression, MindooDBAppViewLookupByPath, MindooDBAppViewOperationExpression, MindooDBAppViewOriginExpression, MindooDBAppViewPageRequest, MindooDBAppViewPageResult, MindooDBAppViewRow, MindooDBAppViewSortDirection, MindooDBAppViewTotalMode, MindooDBAppViewValueExpressionRef, MindooDBAppViewVariableExpression, createViewLanguage } from 'mindoodb-view-language';

package/dist/index.js

@@ -4,6 +4,7 @@ import {
   DEFAULT_HAVEN_HOST_SHORTCUTS,
   MINDOODB_APP_ACCEPTS_MAX,
   MINDOODB_APP_COMPONENTS_MAX,
+  MINDOODB_APP_COMPONENT_CONTRACT_PATTERN,
   MINDOODB_APP_DEFINITION_FILE_NAME,
   MINDOODB_APP_DEFINITION_FORMAT,
   MINDOODB_APP_DEFINITION_PERMISSIONS,
@@ -47,7 +48,7 @@ import {
   validateMindooDBAppAccepts,
   validateMindooDBAppComponents,
   validateMindooDBAppDefinition
-} from "./chunk-BE7LLFFE.js";
+} from "./chunk-B3K3I2S2.js";
 import {
   MINDOODB_APP_BUNDLE_ARCHIVE_FILE_NAME,
   MINDOODB_APP_BUNDLE_MANIFEST_FILE_NAME,
@@ -1288,6 +1289,7 @@ export {
   MINDOODB_APP_BUNDLE_MANIFEST_FORMAT,
   MINDOODB_APP_BUNDLE_MANIFEST_VERSION,
   MINDOODB_APP_COMPONENTS_MAX,
+  MINDOODB_APP_COMPONENT_CONTRACT_PATTERN,
   MINDOODB_APP_DEFINITION_FILE_NAME,
   MINDOODB_APP_DEFINITION_FORMAT,
   MINDOODB_APP_DEFINITION_PERMISSIONS,