@happyvertical/smrt-web 0.49.2 → 0.49.4

package/dist/index.d.ts

@@ -240,6 +240,10 @@ export declare function executeSmrtWebDataQuery(transport: SmrtWebDataQueryTrans
     signal?: AbortSignal;
 }): Promise<SmrtWebDataQueryResult>;
 
+export declare function executeSmrtWebDataSurfaceAction(transport: SmrtWebDataSurfaceActionTransport, request: SmrtWebDataSurfaceActionRequest, options?: {
+    signal?: AbortSignal;
+}): Promise<SmrtWebDataSurfaceActionResult>;
+
 /**
  * Retrieve the underlying engine collection backing a handle — an advanced
  * bridge for trusted framework bindings (e.g. the smrt-svelte live-query
@@ -315,6 +319,14 @@ export declare const MAX_SMRT_WEB_DATA_QUERY_STRING_LENGTH = 65536;
 
 export declare const MAX_SMRT_WEB_DATA_QUERY_WARNINGS = 100;
 
+export declare const MAX_SMRT_WEB_DATA_SURFACE_ACTION_CONTAINER_ITEMS = 1000;
+
+export declare const MAX_SMRT_WEB_DATA_SURFACE_ACTION_IDENTIFIER_LENGTH = 256;
+
+export declare const MAX_SMRT_WEB_DATA_SURFACE_ACTION_JSON_DEPTH = 16;
+
+export declare const MAX_SMRT_WEB_DATA_SURFACE_ACTION_RESULT_BYTES = 1000000;
+
 /** The settle outcome handed to {@link SmrtWebCapability.onSettled}. */
 export declare type MutationSettleOutcome = {
     ok: true;
@@ -339,6 +351,9 @@ export declare function newLocalId(): string;
  */
 export declare function normalizeSmrtWebDataQueryResult(value: unknown): SmrtWebDataQueryResult;
 
+/** Fail closed before an action result reaches browser state. */
+export declare function normalizeSmrtWebDataSurfaceActionResult(value: unknown): SmrtWebDataSurfaceActionResult;
+
 /**
  * Build a durable offline-outbox capability for a collection. Add the returned
  * capability to the collection's `capabilities` array; a collection without it
@@ -1041,6 +1056,73 @@ export declare interface SmrtWebDataQueryTransport {
     }): Promise<unknown>;
 }
 
+export declare interface SmrtWebDataSurfaceActionRequest {
+    version: 1;
+    requestId: string;
+    identity: SmrtWebDataSurfaceIdentity;
+    actionId: string;
+    phase: 'preview' | 'apply';
+    expectedRevision: number;
+    /** Required by the server for apply; retries with the same key replay safely. */
+    idempotencyKey?: string;
+    selection: SmrtWebDataSurfaceSelection;
+    payload?: SmrtWebDataSurfaceJsonValue;
+    confirmationToken?: string;
+}
+
+export declare interface SmrtWebDataSurfaceActionResult {
+    version: 1;
+    requestId: string;
+    identity: SmrtWebDataSurfaceIdentity;
+    actionId: string;
+    phase: 'preview' | 'apply';
+    ok: boolean;
+    reason?: string;
+    confirmationToken?: string;
+    details?: {
+        [key: string]: SmrtWebDataSurfaceJsonValue;
+    };
+}
+
+export declare interface SmrtWebDataSurfaceActionTransport {
+    action(request: SmrtWebDataSurfaceActionRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+}
+
+export declare interface SmrtWebDataSurfaceIdentity {
+    surfaceId: string;
+    kind: 'table' | 'list' | 'report' | 'custom';
+    subject?: {
+        type: string;
+        id: string;
+        label?: string;
+    };
+}
+
+/**
+ * Browser transport for bounded data-surface action envelopes.
+ *
+ * This structurally mirrors smrt-types without importing another SMRT package.
+ * The server remains responsible for authority, descriptor allowlists, and
+ * confirmation-token validation; this boundary only rejects malformed replies.
+ */
+export declare type SmrtWebDataSurfaceJsonPrimitive = string | number | boolean | null;
+
+export declare type SmrtWebDataSurfaceJsonValue = SmrtWebDataSurfaceJsonPrimitive | SmrtWebDataSurfaceJsonValue[] | {
+    [key: string]: SmrtWebDataSurfaceJsonValue;
+};
+
+export declare type SmrtWebDataSurfaceSelection = {
+    scope: 'current-page';
+} | {
+    scope: 'explicit-ids';
+    rowIds: Array<string | number>;
+} | {
+    scope: 'all-matching';
+    queryFingerprint: string;
+};
+
 /**
  * The minimal `EventSource` surface the subscriber uses — declared here so a
  * test injects a fake without a real DOM, and so this module compiles without
@@ -1635,7 +1717,7 @@ export declare interface WebMcpBespokeToolSpec {
         openWorldHint?: boolean;
         untrustedContentHint?: boolean;
     };
-    execute: (args: Record<string, unknown>) => string | Promise<string>;
+    execute: (args: Record<string, unknown>, options?: WebMcpToolExecutionOptions) => string | Promise<string>;
 }
 
 /** The MCP-shaped annotation set a resolved classification emits. */
@@ -1738,6 +1820,12 @@ export declare interface WebMcpToolDefinition extends WebToolDescriptor {
  */
 export declare type WebMcpToolEffect = 'read' | 'write' | 'destructive';
 
+/** Host-supplied per-invocation options, distinct from registration lifetime. */
+export declare interface WebMcpToolExecutionOptions {
+    /** Caller cancellation. Older hosts may omit execution options entirely. */
+    signal?: AbortSignal;
+}
+
 /**
  * Thrown synchronously when a name is already held. Carries the colliding
  * name and the owner that holds it so a host can report both without parsing

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as MAX_SMRT_WEB_DATA_QUERY_OFFSET, C as offlineOutbox, D as MAX_SMRT_WEB_DATA_QUERY_CONTAINER_ITEMS, E as wipeDurableStore, F as MAX_SMRT_WEB_DATA_QUERY_WARNINGS, I as executeSmrtWebDataQuery, L as normalizeSmrtWebDataQueryResult, M as MAX_SMRT_WEB_DATA_QUERY_RESULT_BYTES, N as MAX_SMRT_WEB_DATA_QUERY_ROWS, O as MAX_SMRT_WEB_DATA_QUERY_FACETS, P as MAX_SMRT_WEB_DATA_QUERY_STRING_LENGTH, R as runWrapMutation, S as getOutboxHandle, T as registerDurableResource, _ as createSmrtWebEventSubscriber, a as createSmrtWebClient, b as DEFAULT_PERSIST_DEBOUNCE_MS, c as newLocalId, d as unwrapListResult, f as validateSmrtWebClient, g as createUpdateState, h as registerWebMcpTools, i as createSmrtCollection, j as MAX_SMRT_WEB_DATA_QUERY_PAGE_LIMIT, k as MAX_SMRT_WEB_DATA_QUERY_FACET_VALUES, l as throwIfSmrtWebError, m as registerWebMcpBespokeTool, n as buildListQuery, o as getEngineCollection, p as registerViewIntent, r as createDefinitionFetchers, s as invalidateSmrtWebCollections, t as SmrtWebRequestError, u as unwrapItemResult, v as liveInvalidation, w as durableStoreNamespace, x as persistCollection, y as createSmrtWebQuery } from "./chunks/src-DHH8ptH8.js";
+import { A as MAX_SMRT_WEB_DATA_SURFACE_ACTION_RESULT_BYTES, B as MAX_SMRT_WEB_DATA_QUERY_STRING_LENGTH, C as offlineOutbox, D as MAX_SMRT_WEB_DATA_SURFACE_ACTION_CONTAINER_ITEMS, E as wipeDurableStore, F as MAX_SMRT_WEB_DATA_QUERY_FACET_VALUES, H as executeSmrtWebDataQuery, I as MAX_SMRT_WEB_DATA_QUERY_OFFSET, L as MAX_SMRT_WEB_DATA_QUERY_PAGE_LIMIT, M as normalizeSmrtWebDataSurfaceActionResult, N as MAX_SMRT_WEB_DATA_QUERY_CONTAINER_ITEMS, O as MAX_SMRT_WEB_DATA_SURFACE_ACTION_IDENTIFIER_LENGTH, P as MAX_SMRT_WEB_DATA_QUERY_FACETS, R as MAX_SMRT_WEB_DATA_QUERY_RESULT_BYTES, S as getOutboxHandle, T as registerDurableResource, U as normalizeSmrtWebDataQueryResult, V as MAX_SMRT_WEB_DATA_QUERY_WARNINGS, W as runWrapMutation, _ as createSmrtWebEventSubscriber, a as createSmrtWebClient, b as DEFAULT_PERSIST_DEBOUNCE_MS, c as newLocalId, d as unwrapListResult, f as validateSmrtWebClient, g as createUpdateState, h as registerWebMcpTools, i as createSmrtCollection, j as executeSmrtWebDataSurfaceAction, k as MAX_SMRT_WEB_DATA_SURFACE_ACTION_JSON_DEPTH, l as throwIfSmrtWebError, m as registerWebMcpBespokeTool, n as buildListQuery, o as getEngineCollection, p as registerViewIntent, r as createDefinitionFetchers, s as invalidateSmrtWebCollections, t as SmrtWebRequestError, u as unwrapItemResult, v as liveInvalidation, w as durableStoreNamespace, x as persistCollection, y as createSmrtWebQuery, z as MAX_SMRT_WEB_DATA_QUERY_ROWS } from "./chunks/src-0IQGhPIM.js";
 import { n as compileViewIntentToolSpec, o as viewIntentToolName } from "./chunks/intents-BUTyN7YQ.js";
 import { WebMcpToolNameCollisionError, reserveWebMcpToolNames, webMcpToolNameOwner } from "./webmcp-tool-names.js";
-export { DEFAULT_PERSIST_DEBOUNCE_MS, MAX_SMRT_WEB_DATA_QUERY_CONTAINER_ITEMS, MAX_SMRT_WEB_DATA_QUERY_FACETS, MAX_SMRT_WEB_DATA_QUERY_FACET_VALUES, MAX_SMRT_WEB_DATA_QUERY_OFFSET, MAX_SMRT_WEB_DATA_QUERY_PAGE_LIMIT, MAX_SMRT_WEB_DATA_QUERY_RESULT_BYTES, MAX_SMRT_WEB_DATA_QUERY_ROWS, MAX_SMRT_WEB_DATA_QUERY_STRING_LENGTH, MAX_SMRT_WEB_DATA_QUERY_WARNINGS, SmrtWebRequestError, WebMcpToolNameCollisionError, buildListQuery, compileViewIntentToolSpec, createDefinitionFetchers, createSmrtCollection, createSmrtWebClient, createSmrtWebEventSubscriber, createSmrtWebQuery, createUpdateState, durableStoreNamespace, executeSmrtWebDataQuery, getEngineCollection, getOutboxHandle, invalidateSmrtWebCollections, liveInvalidation, newLocalId, normalizeSmrtWebDataQueryResult, offlineOutbox, persistCollection, registerDurableResource, registerViewIntent, registerWebMcpBespokeTool, registerWebMcpTools, reserveWebMcpToolNames, runWrapMutation, throwIfSmrtWebError, unwrapItemResult, unwrapListResult, validateSmrtWebClient, viewIntentToolName, webMcpToolNameOwner, wipeDurableStore };
+export { DEFAULT_PERSIST_DEBOUNCE_MS, MAX_SMRT_WEB_DATA_QUERY_CONTAINER_ITEMS, MAX_SMRT_WEB_DATA_QUERY_FACETS, MAX_SMRT_WEB_DATA_QUERY_FACET_VALUES, MAX_SMRT_WEB_DATA_QUERY_OFFSET, MAX_SMRT_WEB_DATA_QUERY_PAGE_LIMIT, MAX_SMRT_WEB_DATA_QUERY_RESULT_BYTES, MAX_SMRT_WEB_DATA_QUERY_ROWS, MAX_SMRT_WEB_DATA_QUERY_STRING_LENGTH, MAX_SMRT_WEB_DATA_QUERY_WARNINGS, MAX_SMRT_WEB_DATA_SURFACE_ACTION_CONTAINER_ITEMS, MAX_SMRT_WEB_DATA_SURFACE_ACTION_IDENTIFIER_LENGTH, MAX_SMRT_WEB_DATA_SURFACE_ACTION_JSON_DEPTH, MAX_SMRT_WEB_DATA_SURFACE_ACTION_RESULT_BYTES, SmrtWebRequestError, WebMcpToolNameCollisionError, buildListQuery, compileViewIntentToolSpec, createDefinitionFetchers, createSmrtCollection, createSmrtWebClient, createSmrtWebEventSubscriber, createSmrtWebQuery, createUpdateState, durableStoreNamespace, executeSmrtWebDataQuery, executeSmrtWebDataSurfaceAction, getEngineCollection, getOutboxHandle, invalidateSmrtWebCollections, liveInvalidation, newLocalId, normalizeSmrtWebDataQueryResult, normalizeSmrtWebDataSurfaceActionResult, offlineOutbox, persistCollection, registerDurableResource, registerViewIntent, registerWebMcpBespokeTool, registerWebMcpTools, reserveWebMcpToolNames, runWrapMutation, throwIfSmrtWebError, unwrapItemResult, unwrapListResult, validateSmrtWebClient, viewIntentToolName, webMcpToolNameOwner, wipeDurableStore };

package/dist/webmcp.d.ts

@@ -445,7 +445,7 @@ export declare interface WebMcpBespokeToolSpec {
         openWorldHint?: boolean;
         untrustedContentHint?: boolean;
     };
-    execute: (args: Record<string, unknown>) => string | Promise<string>;
+    execute: (args: Record<string, unknown>, options?: WebMcpToolExecutionOptions) => string | Promise<string>;
 }
 
 /** A fully resolved classification. */
@@ -528,6 +528,12 @@ declare interface WebMcpToolDefinition extends WebToolDescriptor {
  */
 export declare type WebMcpToolEffect = 'read' | 'write' | 'destructive';
 
+/** Host-supplied per-invocation options, distinct from registration lifetime. */
+export declare interface WebMcpToolExecutionOptions {
+    /** Caller cancellation. Older hosts may omit execution options entirely. */
+    signal?: AbortSignal;
+}
+
 /**
  * Thrown synchronously when a name is already held. Carries the colliding
  * name and the owner that holds it so a host can report both without parsing

package/dist/webmcp.js

@@ -1,3 +1,3 @@
-import { h as registerWebMcpTools, m as registerWebMcpBespokeTool, p as registerViewIntent } from "./chunks/src-DHH8ptH8.js";
+import { h as registerWebMcpTools, m as registerWebMcpBespokeTool, p as registerViewIntent } from "./chunks/src-0IQGhPIM.js";
 import { WebMcpToolNameCollisionError, reserveWebMcpToolNames, webMcpToolNameOwner } from "./webmcp-tool-names.js";
 export { WebMcpToolNameCollisionError, registerViewIntent, registerWebMcpBespokeTool, registerWebMcpTools, reserveWebMcpToolNames, webMcpToolNameOwner };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-web",
-  "version": "0.49.2",
+  "version": "0.49.4",
   "description": "SMRT browser client data runtime: typed collection factory wrapping the client-data engine over generated REST clients",
   "author": "HappyVertical",
   "type": "module",
@@ -36,8 +36,8 @@
     "@tanstack/query-db-collection": "^1.0.46"
   },
   "devDependencies": {
-    "@happyvertical/smrt-core": "0.49.2",
-    "@happyvertical/smrt-scanner": "0.49.2",
+    "@happyvertical/smrt-core": "0.49.4",
+    "@happyvertical/smrt-scanner": "0.49.4",
     "@types/node": "24.13.2",
     "fake-indexeddb": "^6.2.5",
     "typescript": "5.9.3",