@happyvertical/smrt-svelte 0.43.2 → 0.43.4

package/AGENTS.md

@@ -15,6 +15,9 @@ subpath you are editing. This file keeps what holds in every module.
 | `src/test-support/` + `__tests__/` | the golden-test harness and pattern for Svelte component tests | [agents/testing.md](agents/testing.md) |
 | `src/components/settings/` (`./settings`) | `SettingsCatalog`, `paginateSettingsCatalog`, and the summary-vs-detail scalability contract | [agents/settings.md](agents/settings.md) |
 | `src/components/workspace/` (`./workspace` + `./web`) | the AdminShell family and its principles, the legacy ToolsDock surface, the `./web` activity-feed and `updateAvailable` adapters, and server-side dock gates | [agents/workspace.md](agents/workspace.md) |
+| `src/web/remote-query.svelte.ts` | Svelte 5 binding for query-shaped remote pages: rows, page, totals, loading/refreshing/stale/error, retry, last-updated, and query-scoped live subscriptions (#2445) | — |
+| `src/web/webmcp-provider.ts` | Provider config for generated data/model WebMCP tools: definitions, effect policy, namespace, budget, legacy/canonical filters, and fetcher seams (#2520) | — |
+| `src/web/webmcp-ui.ts` | Fixed, low-cardinality WebMCP adapter over the Provider's mounted form-control and data-surface registries (#2521) | — |
 
 ## The UI split — primitive-adoption contract (#1589)
 
@@ -63,6 +66,26 @@ Wraps app in `+layout.svelte`. Provides auth state, permissions, WebSocket, and
 </Provider>
 ```
 
+An object `webmcp` config with `definitions` registers generated data/model
+tools through the same registrar as direct smrt-web callers. With no `effects`
+policy, only `read`-effect tools register; `write` and `destructive` require
+explicit opt-in. Use `filter` for legacy collection definitions and `filterTool`
+for canonical definitions; a filter supplied for definitions of the other kind
+fails closed. Namespace, budget, resolver, annotation, and atomic-validation
+behavior must stay identical between Provider and direct registration. The
+authenticated REST route remains the execution authorization boundary.
+
+With the fixed mounted-UI adapter enabled, Provider also owns shared
+control/data-surface registries and registers six fixed `smrt_ui_*` tools. This
+adapter is a separate, consent-gated surface and is not governed by the
+generated-model effect policy. Descendant rich Forms use the shared
+control registry unless their explicit `interactionRegistry` prop overrides it.
+Supply `webmcp.ui.dataSurfaceRegistry` when mounted surface components already
+share an application registry. The adapter resolves registry state at execution
+time, never reads the DOM, never accepts agent confirmation, and removes the
+entire tool set with one abort signal. A document may have only one active
+adapter for a prefix; configure distinct prefixes for intentional coexistence.
+
 ## Hooks
 
 | Hook | Returns |

package/README.md

@@ -60,6 +60,24 @@ state.
 
 ## Usage
 
+### Query-backed data surfaces
+
+Use the web binding when a table should render one remote page instead of
+hydrating its whole collection. It exposes `rows`, `page`, `total`,
+`loading`, `refreshing`, `stale`, `error`, `retry`, and `lastUpdated`.
+
+```svelte
+<script lang="ts">
+  import { remoteQuery } from '@happyvertical/smrt-svelte/web';
+  const view = remoteQuery(collection, transport);
+  // Failures remain available as view.error for reactive rendering.
+  void view.execute(request).catch(() => undefined);
+</script>
+
+{#if view.loading}<p>Loading…</p>{/if}
+{#each view.rows as row (row.id)}<div>{row.name}</div>{/each}
+```
+
 ### Provider Setup
 
 ```svelte
@@ -74,6 +92,70 @@ state.
 </Provider>
 ```
 
+The Provider can own generated WebMCP tools for the same lifecycle. Its policy
+is identical to `registerWebMcpTools`; omitted `effects` exposes reads only:
+
+```svelte
+<Provider webmcp={{
+  definitions,
+  effects: ['read', 'write'],
+  namespace: 'workspace',
+  maxTools: 24
+}}>
+  {@render children()}
+</Provider>
+```
+
+This controls capability exposure, not authorization. Tool execution still
+crosses the authenticated REST boundary and must retain its auth and tenancy
+guards. The `effects`, `filter`, and `filterTool` policy applies to generated
+data/model tools only; the fixed mounted-UI adapter has the separate controls
+described below.
+
+WebMCP test doubles and polyfills should implement the browser's
+promise-returning `document.modelContext.registerTool()` contract; declare the
+function `async` when migrating older void-returning fixtures.
+
+### Mounted UI through WebMCP
+
+`<Provider webmcp>` registers six fixed `smrt_ui_*` tools for the mounted UI:
+list, inspect, and execute for form controls and data surfaces. The tool set does
+not change as components mount and unmount; each call reads the current
+transport-neutral registries instead of inspecting or simulating the DOM.
+
+Forms automatically join the Provider's control registry. An explicit Form
+`interactionRegistry` still takes precedence. Pass the same data-surface
+registry used by `DataTable` or `CollectionToolbar` when those mounted surfaces
+should be discoverable:
+
+```svelte
+<script lang="ts">
+  import { createDataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
+  import { Provider } from '@happyvertical/smrt-svelte';
+
+  const surfaces = createDataSurfaceRegistry();
+</script>
+
+<Provider webmcp={{ ui: { dataSurfaceRegistry: surfaces } }}>
+  <!-- pass {surfaces} to mounted data-surface components -->
+  {@render children()}
+</Provider>
+```
+
+The default prefix is `smrt_ui_`. Configure `ui.prefix` when multiple Providers
+must coexist in one document; the same prefix cannot be registered twice.
+`ui: false` disables only the fixed UI adapter while leaving generated model
+tools enabled. For compatibility, an object config that omits `ui` continues to
+enable only generated model tools; use `webmcp={true}` or provide `ui: {}` to
+enable the mounted-UI adapter.
+
+Form commands always run with `source: 'agent'`. WebMCP input cannot assert
+confirmation: staging is allowed by the registry policy, while apply, clear,
+and undo require a separate human-confirmed path. Secret control values and
+hidden data-surface columns are not serialized. Read responses are marked as
+untrusted content. Bespoke `useWebMcpTool` and `<Form webmcp>` tools retain their
+existing lifecycle and submit behavior.
+
 ### Form Components
 
 ```svelte

package/dist/Provider.svelte

@@ -1,14 +1,11 @@
 <script lang="ts">
+import { createDataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
+import { createControlInteractionRegistry } from '@happyvertical/smrt-ui/forms';
 import {
   createI18nContext,
   type I18nSnapshot,
   setI18nContext,
 } from '@happyvertical/smrt-ui/i18n';
-import {
-  type RegisterWebMcpToolsOptions,
-  type SmrtWebClient,
-  type SmrtWebCollectionDefinition,
-} from '@happyvertical/smrt-web';
 import type { Snippet } from 'svelte';
 import { onDestroy, untrack } from 'svelte';
 import { logger } from './internal/logger.js';
@@ -21,6 +18,9 @@ import type {
 } from './state/app-state.js';
 import { createAppState } from './state/app-state.svelte.js';
 import { setAppStateContext } from './state/context.js';
+import type { WebMcpProviderConfig } from './web/webmcp-provider.js';
+import { registerWebMcpUiTools } from './web/webmcp-ui.js';
+import { setWebMcpUiContext } from './web/webmcp-ui-context.js';
 
 interface Props {
   /**
@@ -84,9 +84,9 @@ interface Props {
    */
   i18n?: I18nSnapshot;
   /**
-   * Opt in to the generated collection tools for this browser surface.
-   * WebMCP is feature-detected by smrt-web, so this is safe during SSR and on
-   * browsers that do not expose `document.modelContext`.
+   * Opt in to generated data tools and the fixed mounted-UI tool adapter for
+   * this browser surface. WebMCP is feature-detected, so this is safe during
+   * SSR and on browsers that do not expose `document.modelContext`.
    */
   webmcp?: boolean | WebMcpProviderConfig;
   /**
@@ -95,15 +95,6 @@ interface Props {
   children: Snippet;
 }
 
-export interface WebMcpProviderConfig {
-  definitions?: SmrtWebCollectionDefinition[];
-  client?: SmrtWebClient;
-  basePath?: string;
-  fetchFn?: typeof fetch;
-  scope?: string;
-  filter?: RegisterWebMcpToolsOptions['filter'];
-}
-
 const {
   mode,
   autoEnableSmrt = true,
@@ -135,6 +126,35 @@ const appState = createAppState({
   },
 });
 
+const localControlRegistry = createControlInteractionRegistry();
+const localDataSurfaceRegistry = createDataSurfaceRegistry();
+const webMcpConfig = $derived(typeof webmcp === 'object' ? webmcp : undefined);
+const webMcpUiConfig = $derived(
+  webmcp === true
+    ? {}
+    : typeof webMcpConfig?.ui === 'object'
+      ? webMcpConfig.ui
+      : undefined,
+);
+const resolvedControlRegistry = $derived(
+  webMcpUiConfig?.controlRegistry ?? localControlRegistry,
+);
+const resolvedDataSurfaceRegistry = $derived(
+  webMcpUiConfig?.dataSurfaceRegistry ?? localDataSurfaceRegistry,
+);
+
+setWebMcpUiContext({
+  get enabled() {
+    return webMcpUiConfig !== undefined;
+  },
+  get controlRegistry() {
+    return resolvedControlRegistry;
+  },
+  get dataSurfaceRegistry() {
+    return resolvedDataSurfaceRegistry;
+  },
+});
+
 $effect(() => {
   const currentPreferences = untrack(() => appState.state.session.preferences);
   if (currentPreferences.autoEnableSmrt === autoEnableSmrt) {
@@ -149,6 +169,21 @@ $effect(() => {
   });
 });
 
+// Register one fixed UI tool set. Mounted components change registry contents,
+// not the document-level WebMCP tool set.
+$effect(() => {
+  if (typeof window === 'undefined' || !webmcp || !webMcpUiConfig) return;
+  try {
+    return registerWebMcpUiTools({
+      controlRegistry: resolvedControlRegistry,
+      dataSurfaceRegistry: resolvedDataSurfaceRegistry,
+      ...(webMcpUiConfig.prefix ? { prefix: webMcpUiConfig.prefix } : {}),
+    });
+  } catch (error) {
+    logger.warn('Provider: WebMCP UI tool registration rejected', { error });
+  }
+});
+
 // Keep generated data-plane tools scoped to this Provider. The registrar
 // feature-detects WebMCP itself; effects do not run during SSR.
 $effect(() => {
@@ -160,16 +195,38 @@ $effect(() => {
 
   // Keep the data-plane engine out of applications that do not opt in. The
   // dynamic import also means SSR never evaluates browser-only engine code.
-  void import('@happyvertical/smrt-web').then(({ registerWebMcpTools }) => {
-    if (cancelled) return;
-    dispose = registerWebMcpTools(config.definitions ?? [], {
-      ...(config.client ? { client: config.client } : {}),
-      ...(config.basePath ? { basePath: config.basePath } : {}),
-      ...(config.fetchFn ? { fetchFn: config.fetchFn } : {}),
-      ...(config.scope ? { scope: config.scope } : {}),
-      ...(config.filter ? { filter: config.filter } : {}),
+  void import('@happyvertical/smrt-web')
+    .then(({ registerWebMcpTools }) => {
+      if (cancelled) return;
+      const registration = registerWebMcpTools(config.definitions ?? [], {
+        client: config.client,
+        basePath: config.basePath,
+        fetchFn: config.fetchFn,
+        scope: config.scope,
+        filter: config.filter,
+        filterTool: config.filterTool,
+        resolveFetchers: config.resolveFetchers,
+        resolveToolFetchers: config.resolveToolFetchers,
+        effects: config.effects,
+        namespace: config.namespace,
+        maxTools: config.maxTools,
+      });
+      dispose = registration;
+      void registration.ready.catch((error) => {
+        if (!cancelled) {
+          logger.warn('Provider: WebMCP data tool registration rejected', {
+            error,
+          });
+        }
+      });
+    })
+    .catch((error) => {
+      if (!cancelled) {
+        logger.warn('Provider: WebMCP data tool registration rejected', {
+          error,
+        });
+      }
     });
-  });
 
   return () => {
     cancelled = true;

package/dist/Provider.svelte.d.ts

@@ -1,15 +1,7 @@
 import { type I18nSnapshot } from '@happyvertical/smrt-ui/i18n';
-import { type RegisterWebMcpToolsOptions, type SmrtWebClient, type SmrtWebCollectionDefinition } from '@happyvertical/smrt-web';
 import type { Snippet } from 'svelte';
 import type { AIConfig, AILoadingState, AppMode, SocketConfig, User } from './state/app-state.js';
-export interface WebMcpProviderConfig {
-    definitions?: SmrtWebCollectionDefinition[];
-    client?: SmrtWebClient;
-    basePath?: string;
-    fetchFn?: typeof fetch;
-    scope?: string;
-    filter?: RegisterWebMcpToolsOptions['filter'];
-}
+import type { WebMcpProviderConfig } from './web/webmcp-provider.js';
 interface Props {
     /**
      * Initial mode: 'default' | 'smrt'
@@ -72,9 +64,9 @@ interface Props {
      */
     i18n?: I18nSnapshot;
     /**
-     * Opt in to the generated collection tools for this browser surface.
-     * WebMCP is feature-detected by smrt-web, so this is safe during SSR and on
-     * browsers that do not expose `document.modelContext`.
+     * Opt in to generated data tools and the fixed mounted-UI tool adapter for
+     * this browser surface. WebMCP is feature-detected, so this is safe during
+     * SSR and on browsers that do not expose `document.modelContext`.
      */
     webmcp?: boolean | WebMcpProviderConfig;
     /**

package/dist/Provider.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Provider.svelte.d.ts","sourceRoot":"","sources":["../src/Provider.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,aAAa,EAClB,KAAK,2BAA2B,EACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,OAAO,EACP,YAAY,EACZ,IAAI,EACL,MAAM,sBAAsB,CAAC;AAK9B,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,2BAA2B,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;CAC/C;AAED,UAAU,KAAK;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;;;;;;;;;;;OAeG;IACH,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACpD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;IACxC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AA4KD,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"Provider.svelte.d.ts","sourceRoot":"","sources":["../src/Provider.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,OAAO,EACP,YAAY,EACZ,IAAI,EACL,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAKrE,UAAU,KAAK;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;;;;;;;;;;;OAeG;IACH,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACpD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;IACxC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAiPD,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/__tests__/provider-webmcp-harness.svelte

@@ -0,0 +1,14 @@
+<script lang="ts">
+import Provider from '../Provider.svelte';
+import type { WebMcpProviderConfig } from '../web/webmcp-provider.js';
+
+interface Props {
+  webmcp: WebMcpProviderConfig;
+}
+
+const { webmcp }: Props = $props();
+</script>
+
+<Provider {webmcp}>
+  <span></span>
+</Provider>

package/dist/__tests__/provider-webmcp-harness.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { WebMcpProviderConfig } from '../web/webmcp-provider.js';
+interface Props {
+    webmcp: WebMcpProviderConfig;
+}
+declare const ProviderWebmcpHarness: import("svelte").Component<Props, {}, "">;
+type ProviderWebmcpHarness = ReturnType<typeof ProviderWebmcpHarness>;
+export default ProviderWebmcpHarness;
+//# sourceMappingURL=provider-webmcp-harness.svelte.d.ts.map

package/dist/__tests__/provider-webmcp-harness.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-webmcp-harness.svelte.d.ts","sourceRoot":"","sources":["../../src/__tests__/provider-webmcp-harness.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,UAAU,KAAK;IACb,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAeD,QAAA,MAAM,qBAAqB,2CAAwC,CAAC;AACpE,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACtE,eAAe,qBAAqB,CAAC"}

package/dist/components/forms/Form.svelte

@@ -19,6 +19,7 @@ import {
   setFormContext,
 } from '../../state/form-context.js';
 import { useWebMcpTool } from '../../web/webmcp.svelte.js';
+import { tryGetWebMcpUiContext } from '../../web/webmcp-ui-context.js';
 import type { LLMModelId, STTAdapterType } from './types.js';
 
 const { t } = useI18n();
@@ -80,11 +81,21 @@ const stt = useSTT();
 const instanceId = $props.id();
 const generatedFormId = `smrt-form-${instanceId}`;
 const localInteractionRegistry = createControlInteractionRegistry();
+const providerWebMcpUi = tryGetWebMcpUiContext();
 const resolvedFormId = $derived(formId ?? id ?? name ?? generatedFormId);
 const resolvedInteractionRegistry = $derived(
-  interactionRegistry ?? localInteractionRegistry,
+  interactionRegistry ??
+    (providerWebMcpUi?.enabled
+      ? providerWebMcpUi.controlRegistry
+      : undefined) ??
+    localInteractionRegistry,
 );
-const interactionDisposers = new Map<string, () => void>();
+const interactionDisposers = new Map<
+  string,
+  { field: FieldDefinition; dispose: () => void }
+>();
+let activeInteractionRegistry: ControlInteractionRegistry | undefined;
+let activeInteractionFormId: string | undefined;
 
 setControlInteractionContext({
   get formId() {
@@ -97,7 +108,14 @@ setControlInteractionContext({
 
 $effect(() => {
   if (!oninteraction) return;
-  return resolvedInteractionRegistry.subscribe(oninteraction);
+  return resolvedInteractionRegistry.subscribe((event) => {
+    if (event.identity.formId !== resolvedFormId) return;
+    try {
+      oninteraction(event);
+    } catch (error) {
+      logger.warn('Form: interaction observer failed', { error });
+    }
+  });
 });
 
 // Internal state
@@ -132,47 +150,104 @@ function interactionKind(field: FieldDefinition): ControlKind {
   }
 }
 
+function registerInteraction(
+  registry: ControlInteractionRegistry,
+  currentFormId: string,
+  field: FieldDefinition,
+): (() => void) | undefined {
+  const identity = {
+    formId: currentFormId,
+    controlId: field.controlId ?? field.name,
+  };
+  if (registry.get(identity)) {
+    logger.warn('Form: duplicate interaction identity rejected', { identity });
+    return undefined;
+  }
+  return registry.register({
+    identity,
+    metadata: {
+      kind: interactionKind(field),
+      label: field.label,
+      description: field.description,
+      sensitivity: field.sensitivity ?? 'public',
+      readable: field.readable,
+      writable: field.writable,
+      constraints: field.constraints,
+      options: field.options,
+      unit: field.unit,
+    },
+    getValue: field.getValue,
+    setValue: field.setValue,
+    clear: field.clear ?? (() => field.setValue('')),
+    focus: field.focus,
+    reveal: field.reveal,
+    highlight: field.highlight,
+    validate: field.validate,
+    getState: field.getState,
+  });
+}
+
+let interactionRegistryRevision = $state(0);
+
+$effect(() => {
+  const registry = resolvedInteractionRegistry;
+  return registry.subscribe((event) => {
+    if (event.type === 'registered' || event.type === 'unregistered') {
+      interactionRegistryRevision += 1;
+    }
+  });
+});
+
+$effect(() => {
+  const registry = resolvedInteractionRegistry;
+  const currentFormId = resolvedFormId;
+  const currentFields = new Map(fields);
+  void interactionRegistryRevision;
+  if (
+    activeInteractionRegistry !== registry ||
+    activeInteractionFormId !== currentFormId
+  ) {
+    for (const registration of interactionDisposers.values()) {
+      registration.dispose();
+    }
+    interactionDisposers.clear();
+    activeInteractionRegistry = registry;
+    activeInteractionFormId = currentFormId;
+  }
+  for (const [name, registration] of interactionDisposers) {
+    const identity = {
+      formId: currentFormId,
+      controlId: registration.field.controlId ?? registration.field.name,
+    };
+    if (
+      currentFields.get(name) !== registration.field ||
+      !registry.get(identity)
+    ) {
+      registration.dispose();
+      interactionDisposers.delete(name);
+    }
+  }
+  for (const [name, field] of currentFields) {
+    if (interactionDisposers.has(name)) continue;
+    const dispose = registerInteraction(registry, currentFormId, field);
+    if (!dispose) continue;
+    interactionDisposers.set(name, {
+      field,
+      dispose,
+    });
+  }
+});
+
 // Create form context
 const formContext: SMRTFormContext = {
   get mode() {
     return app.state.mode === 'smrt' ? 'smrt' : 'default';
   },
   registerField(field: FieldDefinition) {
-    interactionDisposers.get(field.name)?.();
     fields.set(field.name, field);
     fields = new Map(fields); // Trigger reactivity
-    interactionDisposers.set(
-      field.name,
-      resolvedInteractionRegistry.register({
-        identity: {
-          formId: resolvedFormId,
-          controlId: field.controlId ?? field.name,
-        },
-        metadata: {
-          kind: interactionKind(field),
-          label: field.label,
-          description: field.description,
-          sensitivity: field.sensitivity ?? 'public',
-          readable: field.readable,
-          writable: field.writable,
-          constraints: field.constraints,
-          options: field.options,
-          unit: field.unit,
-        },
-        getValue: field.getValue,
-        setValue: field.setValue,
-        clear: field.clear ?? (() => field.setValue('')),
-        focus: field.focus,
-        reveal: field.reveal,
-        highlight: field.highlight,
-        validate: field.validate,
-        getState: field.getState,
-      }),
-    );
   },
   unregisterField(name: string) {
-    interactionDisposers.get(name)?.();
-    interactionDisposers.delete(name);
     fields.delete(name);
     fields = new Map(fields);
   },
@@ -762,7 +837,9 @@ onDestroy(() => {
     clearTimeout(silenceTimer);
   }
   stopAudioLevelMonitoring();
-  for (const dispose of interactionDisposers.values()) dispose();
+  for (const registration of interactionDisposers.values()) {
+    registration.dispose();
+  }
   interactionDisposers.clear();
 });
 

package/dist/components/forms/Form.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Form.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/Form.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAIhC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAYtC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG7D,MAAM,WAAW,KAAK;IACpB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oCAAoC;IACpC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB;IACvB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;IACjD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyzBD,QAAA,MAAM,IAAI;uBAhFe,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;kCAQZ,0BAA0B;MAwEZ,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Form.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/Form.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAIhC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAatC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG7D,MAAM,WAAW,KAAK;IACpB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oCAAoC;IACpC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB;IACvB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;IACjD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAs4BD,QAAA,MAAM,IAAI;uBAhFe,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;kCAQZ,0BAA0B;MAwEZ,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}

package/dist/components/forms/__tests__/Form.webmcp.test.js

@@ -27,7 +27,7 @@ describe('Form WebMCP submit intent', () => {
     it('registers a field-derived tool and dispatches validation + submit', async () => {
         const registered = [];
         document.modelContext = {
-            registerTool(tool) {
+            async registerTool(tool) {
                 registered.push(tool);
             },
         };
@@ -54,7 +54,7 @@ describe('Form WebMCP submit intent', () => {
     it('publishes required and numeric constraints and validates them before submit', async () => {
         const registered = [];
         document.modelContext = {
-            registerTool(tool) {
+            async registerTool(tool) {
                 registered.push(tool);
             },
         };
@@ -94,7 +94,7 @@ describe('Form WebMCP submit intent', () => {
     it('publishes and accepts structured measurement, date range, and address fields', async () => {
         const registered = [];
         document.modelContext = {
-            registerTool(tool) {
+            async registerTool(tool) {
                 registered.push(tool);
             },
         };
@@ -154,7 +154,7 @@ describe('Form WebMCP submit intent', () => {
     it('limits the address schema and payload to configured fields', async () => {
         const registered = [];
         document.modelContext = {
-            registerTool(tool) {
+            async registerTool(tool) {
                 registered.push(tool);
             },
         };
@@ -190,7 +190,7 @@ describe('Form WebMCP submit intent', () => {
     it('allows partial payloads for optional structured fields', async () => {
         const registered = [];
         document.modelContext = {
-            registerTool(tool) {
+            async registerTool(tool) {
                 registered.push(tool);
             },
         };

package/dist/index.d.ts

@@ -18,4 +18,7 @@ export * from './hooks/index.js';
 export { default as Provider } from './Provider.svelte';
 export * from './state/index.js';
 export { useWebMcpTool, type WebMcpToolSpec } from './web/webmcp.svelte.js';
+export type { WebMcpProviderConfig, WebMcpUiProviderConfig, } from './web/webmcp-provider.js';
+export { type RegisterWebMcpUiToolsOptions, registerWebMcpUiTools, } from './web/webmcp-ui.js';
+export { useWebMcpUi, type WebMcpUiContext, } from './web/webmcp-ui-context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAGH,cAAc,6BAA6B,CAAC;AAE5C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,mBAAmB,CAAC;AAElC,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAExD,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAGH,cAAc,6BAA6B,CAAC;AAE5C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,mBAAmB,CAAC;AAElC,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAExD,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,4BAA4B,EACjC,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,KAAK,eAAe,GACrB,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -26,3 +26,5 @@ export { default as Provider } from './Provider.svelte';
 export * from './state/index.js';
 // Opt-in browser WebMCP lifecycle primitive.
 export { useWebMcpTool } from './web/webmcp.svelte.js';
+export { registerWebMcpUiTools, } from './web/webmcp-ui.js';
+export { useWebMcpUi, } from './web/webmcp-ui-context.js';