@happyvertical/smrt-svelte 0.51.39 → 0.52.0

package/dist/index.d.ts

@@ -21,5 +21,5 @@ export { type UseViewIntentOptions, useViewIntent, type ViewIntentIdentity, } fr
 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';
+export { tryUseWebMcpUi, 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;AAGjC,OAAO,EACL,KAAK,oBAAoB,EACzB,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,6BAA6B,CAAC;AAErC,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"}
+{"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;AAGjC,OAAO,EACL,KAAK,oBAAoB,EACzB,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,6BAA6B,CAAC;AAErC,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,cAAc,EACd,WAAW,EACX,KAAK,eAAe,GACrB,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -30,4 +30,4 @@ export { useViewIntent, } from './web/view-intent.svelte.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';
+export { tryUseWebMcpUi, useWebMcpUi, } from './web/webmcp-ui-context.js';

package/dist/web/__tests__/assistant-dock.integration.svelte.test.js

@@ -98,7 +98,7 @@ describe('AssistantDock integration (#2904)', () => {
         const transport = createInMemoryAssistantTransport();
         render(AssistantDock, { props: { transport, registry } });
         await waitFor(() => {
-            expect(screen.getByText(/No data surfaces are mounted on this route/i)).toBeInTheDocument();
+            expect(screen.getByText(/Nothing on this page can be changed from the chat/i)).toBeInTheDocument();
         });
     });
     it('discovers a mounted surface via the registry and renders a sent conversation', async () => {
@@ -114,7 +114,7 @@ describe('AssistantDock integration (#2904)', () => {
         });
         render(AssistantDock, { props: { transport, registry } });
         await waitFor(() => {
-            expect(screen.queryByText(/No data surfaces are mounted on this route/i)).not.toBeInTheDocument();
+            expect(screen.queryByText(/Nothing on this page can be changed from the chat/i)).not.toBeInTheDocument();
         });
         const thread = await transport.createThread('Order question');
         // Drive the same controller the component owns internally by exercising

package/dist/web/__tests__/list-sort-surface.fixture.svelte

@@ -0,0 +1,41 @@
+<script lang="ts">
+import type {
+  DataSurfaceRegistry,
+  ListSort,
+} from '@happyvertical/smrt-ui/data';
+import { useListSurface } from '../list-surface.svelte.js';
+
+let {
+  registry,
+  rows,
+  sort = $bindable({ columnId: 'published', direction: 'desc' }),
+  deny = false,
+}: {
+  registry: DataSurfaceRegistry;
+  rows: Array<{ id: string; title: string; published: string }>;
+  sort?: ListSort;
+  deny?: boolean;
+} = $props();
+
+useListSurface(
+  () => ({
+    surfaceId: 'stories-ui',
+    label: 'Stories',
+    description: 'Stories on this page',
+    columns: [
+      { id: 'id', label: 'ID', rowKey: true },
+      { id: 'title', label: 'Title', sortable: true },
+      { id: 'published', label: 'Published', sortable: true },
+    ],
+    rows,
+    sort,
+    onSort: (next) => {
+      if (deny) return false;
+      sort = next;
+    },
+  }),
+  registry,
+);
+</script>
+
+<p data-testid="sort">{sort.columnId}:{sort.direction}</p>

package/dist/web/__tests__/list-sort-surface.fixture.svelte.d.ts

@@ -0,0 +1,15 @@
+import type { DataSurfaceRegistry, ListSort } from '@happyvertical/smrt-ui/data';
+type $$ComponentProps = {
+    registry: DataSurfaceRegistry;
+    rows: Array<{
+        id: string;
+        title: string;
+        published: string;
+    }>;
+    sort?: ListSort;
+    deny?: boolean;
+};
+declare const ListSortSurface: import("svelte").Component<$$ComponentProps, {}, "sort">;
+type ListSortSurface = ReturnType<typeof ListSortSurface>;
+export default ListSortSurface;
+//# sourceMappingURL=list-sort-surface.fixture.svelte.d.ts.map

package/dist/web/__tests__/list-sort-surface.fixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-sort-surface.fixture.svelte.d.ts","sourceRoot":"","sources":["../../../src/web/__tests__/list-sort-surface.fixture.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACT,MAAM,6BAA6B,CAAC;AAGpC,KAAK,gBAAgB,GAAI;IACxB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAqCF,QAAA,MAAM,eAAe,0DAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/web/__tests__/list-sort-surface.svelte.test.js

@@ -0,0 +1,59 @@
+import { createDataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
+import { render, screen } from '@testing-library/svelte';
+import { tick } from 'svelte';
+import { describe, expect, it } from 'vitest';
+import Fixture from './list-sort-surface.fixture.svelte';
+const rows = [
+    { id: 's1', title: 'Budget passes', published: '2026-09-01' },
+    { id: 's2', title: 'Arena opens', published: '2026-09-20' },
+];
+const identity = { surfaceId: 'stories-ui', kind: 'list' };
+let sequence = 0;
+function setSorting(expectedRevision, sorting) {
+    sequence += 1;
+    return {
+        version: 1,
+        commandId: `sort-${sequence}`,
+        identity,
+        expectedRevision,
+        controlId: 'set-sorting',
+        payload: { sorting },
+    };
+}
+describe('useListSurface sorting', () => {
+    it('reports the page sort and applies an agent sort through onSort', async () => {
+        const registry = createDataSurfaceRegistry();
+        render(Fixture, { props: { registry, rows } });
+        await tick();
+        const before = registry.inspect(identity);
+        expect([...(before?.descriptor.query.sortableColumnIds ?? [])].sort()).toEqual(['published', 'title']);
+        expect(before?.descriptor.controls.map((control) => control.id)).toContain('set-sorting');
+        expect(before?.state.sort).toEqual({
+            columnId: 'published',
+            direction: 'desc',
+        });
+        const result = await registry.execute(setSorting(before?.revision ?? 0, [
+            { columnId: 'title', direction: 'asc' },
+        ]));
+        expect(result.ok).toBe(true);
+        await tick();
+        expect(screen.getByTestId('sort').textContent).toBe('title:asc');
+        expect(registry.inspect(identity)?.state.sort).toEqual({
+            columnId: 'title',
+            direction: 'asc',
+        });
+    });
+    it('refuses unsortable columns, multiple rules, and a denied onSort', async () => {
+        const registry = createDataSurfaceRegistry();
+        render(Fixture, { props: { registry, rows, deny: true } });
+        await tick();
+        const revision = () => registry.inspect(identity)?.revision ?? 0;
+        expect((await registry.execute(setSorting(revision(), [{ columnId: 'id', direction: 'asc' }]))).ok).toBe(false);
+        expect((await registry.execute(setSorting(revision(), [
+            { columnId: 'title', direction: 'asc' },
+            { columnId: 'published', direction: 'desc' },
+        ]))).ok).toBe(false);
+        expect((await registry.execute(setSorting(revision(), [{ columnId: 'title', direction: 'asc' }]))).ok).toBe(false);
+        expect(screen.getByTestId('sort').textContent).toBe('published:desc');
+    });
+});

package/dist/web/__tests__/surfaces.child.fixture.svelte

@@ -0,0 +1,69 @@
+<script lang="ts">
+import { useLinkSurface } from '../link-surface.svelte.js';
+import { useListSurface } from '../list-surface.svelte.js';
+import { useStepSurface } from '../step-surface.svelte.js';
+import { tryUseWebMcpUi } from '../webmcp-ui-context.js';
+
+let {
+  rows,
+  step = $bindable('town'),
+  navigate,
+  onContext,
+  create,
+}: {
+  rows: Array<{ id: string; title: string; status: string; token: string }>;
+  step?: string;
+  navigate: (href: string) => void;
+  onContext?: (enabled: boolean) => void;
+  create: () => void;
+} = $props();
+
+onContext?.(tryUseWebMcpUi() !== null);
+
+useListSurface(() => ({
+  surfaceId: 'articles-ui',
+  label: 'Articles',
+  description: 'Articles on this page',
+  columns: [
+    { id: 'id', label: 'ID', rowKey: true },
+    { id: 'title', label: 'Title', searchable: true },
+    { id: 'status', label: 'Status', status: true },
+  ],
+  rows,
+  maxRows: 2,
+}));
+
+useLinkSurface(() => ({
+  surfaceId: 'site-sections-ui',
+  label: 'Site sections',
+  description: 'Pages in this site',
+  links: [
+    { id: 'events', label: 'Events', href: '/s/events' },
+    { id: 'articles', label: 'Articles', href: '/s/articles' },
+  ],
+  navigate,
+  state: { active: 'articles' },
+}));
+
+useStepSurface(() => ({
+  surfaceId: 'new-site-steps',
+  label: 'New site',
+  description: 'Start a new town site',
+  steps: [
+    { id: 'town', label: 'Your town', complete: step !== 'town' },
+    { id: 'features', label: 'Features' },
+  ],
+  current: step,
+  next: () => {
+    step = 'features';
+  },
+  nextWrites: step === 'features',
+  showNext: () => document.getElementById('create')?.focus(),
+  back: () => {
+    step = 'town';
+  },
+}));
+</script>
+
+<p data-testid="step">{step}</p>
+<button id="create" type="button" onclick={create}>Create site</button>

package/dist/web/__tests__/surfaces.child.fixture.svelte.d.ts

@@ -0,0 +1,16 @@
+type $$ComponentProps = {
+    rows: Array<{
+        id: string;
+        title: string;
+        status: string;
+        token: string;
+    }>;
+    step?: string;
+    navigate: (href: string) => void;
+    onContext?: (enabled: boolean) => void;
+    create: () => void;
+};
+declare const Surfaces: import("svelte").Component<$$ComponentProps, {}, "step">;
+type Surfaces = ReturnType<typeof Surfaces>;
+export default Surfaces;
+//# sourceMappingURL=surfaces.child.fixture.svelte.d.ts.map

package/dist/web/__tests__/surfaces.child.fixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.child.fixture.svelte.d.ts","sourceRoot":"","sources":["../../../src/web/__tests__/surfaces.child.fixture.svelte.ts"],"names":[],"mappings":"AAQC,KAAK,gBAAgB,GAAI;IACxB,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAmEF,QAAA,MAAM,QAAQ,0DAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/web/__tests__/surfaces.fixture.svelte

@@ -0,0 +1,26 @@
+<script lang="ts">
+import type { DataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
+import Provider from '../../Provider.svelte';
+import Child from './surfaces.child.fixture.svelte';
+
+let {
+  dataSurfaceRegistry,
+  withProvider = true,
+  ...childProps
+}: {
+  dataSurfaceRegistry: DataSurfaceRegistry;
+  withProvider?: boolean;
+  rows: Array<{ id: string; title: string; status: string; token: string }>;
+  navigate: (href: string) => void;
+  onContext?: (enabled: boolean) => void;
+  create: () => void;
+} = $props();
+</script>
+
+{#if withProvider}
+  <Provider webmcp={{ ui: { dataSurfaceRegistry } }}>
+    <Child {...childProps} />
+  </Provider>
+{:else}
+  <Child {...childProps} />
+{/if}

package/dist/web/__tests__/surfaces.fixture.svelte.d.ts

@@ -0,0 +1,18 @@
+import type { DataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
+type $$ComponentProps = {
+    dataSurfaceRegistry: DataSurfaceRegistry;
+    withProvider?: boolean;
+    rows: Array<{
+        id: string;
+        title: string;
+        status: string;
+        token: string;
+    }>;
+    navigate: (href: string) => void;
+    onContext?: (enabled: boolean) => void;
+    create: () => void;
+};
+declare const Surfaces: import("svelte").Component<$$ComponentProps, {}, "">;
+type Surfaces = ReturnType<typeof Surfaces>;
+export default Surfaces;
+//# sourceMappingURL=surfaces.fixture.svelte.d.ts.map

package/dist/web/__tests__/surfaces.fixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.fixture.svelte.d.ts","sourceRoot":"","sources":["../../../src/web/__tests__/surfaces.fixture.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAItE,KAAK,gBAAgB,GAAI;IACxB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAuBF,QAAA,MAAM,QAAQ,sDAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/web/__tests__/surfaces.svelte.test.js

@@ -0,0 +1,140 @@
+import { createDataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
+import { render, screen } from '@testing-library/svelte';
+import { tick } from 'svelte';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import Fixture from './surfaces.fixture.svelte';
+const rows = [
+    {
+        id: 'a1',
+        title: 'Council approves budget',
+        status: 'published',
+        token: 's3cret',
+    },
+    { id: 'a2', title: 'Café opens downtown', status: 'draft', token: 's3cret' },
+    {
+        id: 'a3',
+        title: 'Council meeting moved',
+        status: 'review',
+        token: 's3cret',
+    },
+];
+let sequence = 0;
+function command(identity, controlId, expectedRevision, payload) {
+    sequence += 1;
+    return {
+        version: 1,
+        commandId: `cmd-${sequence}`,
+        identity,
+        expectedRevision,
+        controlId,
+        ...(payload === undefined ? {} : { payload: payload }),
+    };
+}
+afterEach(() => {
+    delete document.modelContext;
+});
+describe('surface hooks on the Provider registry', () => {
+    it('tryUseWebMcpUi is null without a Provider and the hooks register nothing', () => {
+        const registry = createDataSurfaceRegistry();
+        const onContext = vi.fn();
+        render(Fixture, {
+            props: {
+                dataSurfaceRegistry: registry,
+                withProvider: false,
+                rows,
+                navigate: vi.fn(),
+                onContext,
+                create: vi.fn(),
+            },
+        });
+        expect(onContext).toHaveBeenCalledWith(false);
+        expect(registry.list()).toEqual([]);
+    });
+    it('useListSurface publishes projected rows and finds rows by title across all rows', async () => {
+        const registry = createDataSurfaceRegistry();
+        const onContext = vi.fn();
+        const view = render(Fixture, {
+            props: {
+                dataSurfaceRegistry: registry,
+                rows,
+                navigate: vi.fn(),
+                onContext,
+                create: vi.fn(),
+            },
+        });
+        await tick();
+        expect(onContext).toHaveBeenCalledWith(true);
+        const identity = { surfaceId: 'articles-ui', kind: 'list' };
+        const before = registry.inspect(identity);
+        expect(before?.state.rows).toEqual([
+            { id: 'a1', title: 'Council approves budget', status: 'published' },
+            { id: 'a2', title: 'Café opens downtown', status: 'draft' },
+        ]);
+        expect(before?.state.rowsTruncated).toBe(true);
+        expect(JSON.stringify(before?.state)).not.toContain('s3cret');
+        expect(before?.descriptor.query.searchableColumnIds).toEqual(['title']);
+        const found = await registry.execute(command(identity, 'find', before?.revision ?? 0, { text: 'MEETING' }));
+        expect(found.ok).toBe(true);
+        const after = registry.inspect(identity);
+        expect(after?.state.rows).toEqual([
+            { id: 'a3', title: 'Council meeting moved', status: 'review' },
+        ]);
+        expect(after?.state.find).toEqual({ text: 'MEETING', matches: 1 });
+        const accent = await registry.execute(command(identity, 'find', after?.revision ?? 0, 'cafe'));
+        expect(accent.ok).toBe(true);
+        expect(registry.inspect(identity)?.state.rows).toEqual([
+            { id: 'a2', title: 'Café opens downtown', status: 'draft' },
+        ]);
+        const cleared = await registry.execute(command(identity, 'find', registry.inspect(identity)?.revision ?? 0, {
+            text: '',
+        }));
+        expect(cleared.ok).toBe(true);
+        expect(registry.inspect(identity)?.state.find).toBeUndefined();
+        // Table commands stay refused: the page's own controls own its state.
+        const refused = await registry.execute(command(identity, 'set-search', registry.inspect(identity)?.revision ?? 0, {
+            search: 'x',
+        }));
+        expect(refused.ok).toBe(false);
+        view.unmount();
+        expect(registry.list()).toEqual([]);
+    });
+    it('useLinkSurface navigates to a published link', async () => {
+        const registry = createDataSurfaceRegistry();
+        const navigate = vi.fn();
+        render(Fixture, {
+            props: { dataSurfaceRegistry: registry, rows, navigate, create: vi.fn() },
+        });
+        await tick();
+        const identity = { surfaceId: 'site-sections-ui', kind: 'list' };
+        const snapshot = registry.inspect(identity);
+        expect(snapshot?.state.active).toBe('articles');
+        const result = await registry.execute(command(identity, 'open', snapshot?.revision ?? 0, { target: 'events' }));
+        expect(result.ok).toBe(true);
+        expect(navigate).toHaveBeenCalledWith('/s/events');
+    });
+    it('useStepSurface moves a wizard forward and leaves the writing step to the person', async () => {
+        const registry = createDataSurfaceRegistry();
+        const create = vi.fn();
+        render(Fixture, {
+            props: { dataSurfaceRegistry: registry, rows, navigate: vi.fn(), create },
+        });
+        await tick();
+        const identity = { surfaceId: 'new-site-steps', kind: 'custom' };
+        const first = registry.inspect(identity);
+        expect(first?.state.current).toBe('town');
+        expect((await registry.execute(command(identity, 'next', first?.revision ?? 0)))
+            .ok).toBe(true);
+        await tick();
+        expect(screen.getByTestId('step')).toHaveTextContent('features');
+        const second = registry.inspect(identity);
+        expect(second?.state).toMatchObject({
+            current: 'features',
+            nextWrites: true,
+        });
+        expect((await registry.execute(command(identity, 'next', second?.revision ?? 0)))
+            .ok).toBe(true);
+        expect(create).not.toHaveBeenCalled();
+        expect(document.activeElement).toBe(screen.getByRole('button', { name: 'Create site' }));
+        expect(registry.inspect(identity)?.state.awaitingPerson).toBe(true);
+    });
+});

package/dist/web/__tests__/webmcp-ui.test.js

@@ -1,6 +1,7 @@
 import { createDataSurfaceRegistry, } from '@happyvertical/smrt-ui/data';
 import { createControlInteractionRegistry, } from '@happyvertical/smrt-ui/forms';
 import { registerWebMcpBespokeTool, WebMcpToolNameCollisionError, } from '@happyvertical/smrt-web';
+import { isWebMcpProposalTool } from '@happyvertical/smrt-web/webmcp-tool-names';
 import { afterEach, describe, expect, it, vi } from 'vitest';
 import { registerWebMcpUiTools } from '../webmcp-ui.js';
 function modelContext() {
@@ -207,6 +208,10 @@ describe('registerWebMcpUiTools', () => {
             focus: () => {
                 throw new Error('never-serialize-this cannot be focused');
             },
+            // An agent's `focus` reveals instead of moving keyboard focus.
+            reveal: () => {
+                throw new Error('never-serialize-this cannot be revealed');
+            },
         });
         registerWebMcpUiTools({
             controlRegistry: controls,
@@ -702,4 +707,17 @@ describe('cross-path tool-name lock (#2613)', () => {
         expect(registered).toHaveLength(19);
         bespokeDisposer();
     });
+    it('brands every fixed UI tool as proposal-only for the in-page assistant', () => {
+        const browser = modelContext();
+        const dispose = registerWebMcpUiTools({
+            controlRegistry: createControlInteractionRegistry(),
+            dataSurfaceRegistry: createDataSurfaceRegistry(),
+            document: browser.document,
+        });
+        expect(browser.registered).toHaveLength(6);
+        for (const tool of browser.registered) {
+            expect(isWebMcpProposalTool(tool.execute)).toBe(true);
+        }
+        dispose();
+    });
 });

package/dist/web/index.d.ts

@@ -15,11 +15,14 @@
  * @packageDocumentation
  */
 export { type ActivityFeedHandle, type ActivityFeedMap, type ActivityFeedOptions, activityFeed, type ShellActivityInput, } from './activity-feed.svelte.js';
+export { type UseLinkSurfaceOptions, useLinkSurface, } from './link-surface.svelte.js';
 export { type ListDataSurfaceContext, type ListDataSurfaceContextPatch, type ListDataSurfaceControlResult, type ListDataSurfaceHandle, type MountListDataSurfaceOptions, mountListDataSurface, } from './list-data-surface.svelte.js';
+export { findListRows, type ListSurfaceColumn, type ListSurfaceOptions, listSurfaceDescriptor, projectListRows, useListSurface, } from './list-surface.svelte.js';
 export { type LiveCollection, type LiveCollectionMutation, type LiveCollectionOptions, type LiveCollectionStatus, liveCollection, } from './live-collection.svelte.js';
 export { type RemoteQueryBinding, remoteQuery, } from './remote-query.svelte.js';
+export { type UseStepSurfaceOptions, useStepSurface, } from './step-surface.svelte.js';
 export { type UpdateAvailableView, type UseUpdateAvailableOptions, useUpdateAvailable, } from './update-available.svelte.js';
 export type { WebMcpProviderConfig, WebMcpUiProviderConfig, } from './webmcp-provider.js';
 export { type RegisterWebMcpUiToolsOptions, registerWebMcpUiTools, } from './webmcp-ui.js';
-export { useWebMcpUi, type WebMcpUiContext, } from './webmcp-ui-context.js';
+export { tryUseWebMcpUi, useWebMcpUi, type WebMcpUiContext, } from './webmcp-ui-context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/web/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,kBAAkB,EACvB,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,4BAA4B,EACjC,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,qBAAqB,EAC1B,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,kBAAkB,EACvB,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,qBAAqB,EAC1B,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,4BAA4B,EACjC,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,WAAW,EACX,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC"}

package/dist/web/index.js

@@ -15,9 +15,12 @@
  * @packageDocumentation
  */
 export { activityFeed, } from './activity-feed.svelte.js';
+export { useLinkSurface, } from './link-surface.svelte.js';
 export { mountListDataSurface, } from './list-data-surface.svelte.js';
+export { findListRows, listSurfaceDescriptor, projectListRows, useListSurface, } from './list-surface.svelte.js';
 export { liveCollection, } from './live-collection.svelte.js';
 export { remoteQuery, } from './remote-query.svelte.js';
+export { useStepSurface, } from './step-surface.svelte.js';
 export { useUpdateAvailable, } from './update-available.svelte.js';
 export { registerWebMcpUiTools, } from './webmcp-ui.js';
-export { useWebMcpUi, } from './webmcp-ui-context.js';
+export { tryUseWebMcpUi, useWebMcpUi, } from './webmcp-ui-context.js';

package/dist/web/link-surface.svelte.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `useLinkSurface` — mount a navigation list (a menu, a tab row, a section
+ * list) on the nearest `<Provider webmcp>` data-surface registry for the
+ * calling component's lifetime, so an agent can move the person between
+ * pages. See `registerLinkSurface` in `@happyvertical/smrt-ui/data`.
+ *
+ * Re-mounts when the identity (surface id + kind + subject) changes and
+ * publishes link/state changes as new revisions. A no-op without a WebMCP
+ * Provider (nothing could dispatch to it). Call during component init.
+ */
+import { type DataSurfaceRegistry, type LinkSurfaceOptions } from '@happyvertical/smrt-ui/data';
+export type UseLinkSurfaceOptions = Omit<LinkSurfaceOptions, 'registry'>;
+export declare function useLinkSurface(getOptions: () => UseLinkSurfaceOptions | null, registry?: DataSurfaceRegistry): void;
+//# sourceMappingURL=link-surface.svelte.d.ts.map

package/dist/web/link-surface.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-surface.svelte.d.ts","sourceRoot":"","sources":["../../src/web/link-surface.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,KAAK,mBAAmB,EAExB,KAAK,kBAAkB,EAExB,MAAM,6BAA6B,CAAC;AAIrC,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;AAEzE,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,qBAAqB,GAAG,IAAI,EAC9C,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,IAAI,CAuCN"}

package/dist/web/link-surface.svelte.js

@@ -0,0 +1,49 @@
+/**
+ * `useLinkSurface` — mount a navigation list (a menu, a tab row, a section
+ * list) on the nearest `<Provider webmcp>` data-surface registry for the
+ * calling component's lifetime, so an agent can move the person between
+ * pages. See `registerLinkSurface` in `@happyvertical/smrt-ui/data`.
+ *
+ * Re-mounts when the identity (surface id + kind + subject) changes and
+ * publishes link/state changes as new revisions. A no-op without a WebMCP
+ * Provider (nothing could dispatch to it). Call during component init.
+ */
+import { registerLinkSurface, } from '@happyvertical/smrt-ui/data';
+import { onDestroy } from 'svelte';
+import { tryGetWebMcpUiContext } from './webmcp-ui-context.js';
+export function useLinkSurface(getOptions, registry) {
+    const uiContext = tryGetWebMcpUiContext();
+    let handle = null;
+    let mountedKey = null;
+    let mountedRegistry = null;
+    const teardown = () => {
+        handle?.destroy();
+        handle = null;
+        mountedKey = null;
+        mountedRegistry = null;
+    };
+    $effect(() => {
+        const options = getOptions();
+        const resolved = registry ??
+            (uiContext?.enabled ? uiContext.dataSurfaceRegistry : undefined);
+        if (!resolved || !options) {
+            teardown();
+            return;
+        }
+        const key = JSON.stringify([
+            options.surfaceId,
+            options.kind ?? 'list',
+            options.subject ?? null,
+            (options.controls ?? []).map((control) => control.id),
+        ]);
+        if (key !== mountedKey || resolved !== mountedRegistry) {
+            teardown();
+            handle = registerLinkSurface({ ...options, registry: resolved });
+            mountedKey = key;
+            mountedRegistry = resolved;
+            return;
+        }
+        handle?.update({ links: options.links, state: options.state });
+    });
+    onDestroy(teardown);
+}