@ggui-ai/mcp-server-handlers 0.6.2 → 0.7.0

package/dist/renders/sync-context.js

@@ -53,6 +53,7 @@
  */
 import { z } from 'zod';
 import { CONTEXT_SLOT_VALUE_MAX_BYTES, CONTEXT_SNAPSHOT_MAX_BYTES, CONTEXT_SNAPSHOT_MAX_SLOTS, jsonValueSchema, validateContextData, } from '@ggui-ai/protocol';
+import { refreshRenderIdentity } from './render-identity.js';
 const inputSchema = {
     sessionId: z
         .string()
@@ -184,7 +185,7 @@ export function createGguiSyncContextHandler(deps) {
                 ...stored.render,
                 contextSnapshot: snapshot,
             };
-            await deps.renderStore.commit({
+            const committed = await deps.renderStore.commit({
                 render: updated,
                 appId: stored.appId,
                 ...(stored.userId !== undefined ? { userId: stored.userId } : {}),
@@ -196,6 +197,10 @@ export function createGguiSyncContextHandler(deps) {
                     ? { hostSession: stored.hostSession }
                     : {}),
             });
+            // Keep the durable identity record's view of this row current.
+            // Reads the row the commit RETURNED so the record can't disagree
+            // with what was persisted.
+            await refreshRenderIdentity(deps.renderIdentityStore, committed);
             return { ok: true };
         },
     };

package/dist/renders/update.d.ts

@@ -62,7 +62,7 @@
  */
 import { z } from 'zod';
 import { ContractViolationError, type JsonObject } from '@ggui-ai/protocol';
-import type { GguiSessionStore } from '@ggui-ai/mcp-server-core';
+import type { GguiSessionStore, RenderIdentityStore } from '@ggui-ai/mcp-server-core';
 import type { HandlerContext, SharedHandler } from '../types.js';
 import { type RenderSliceMetaDeps } from './slice-meta-derivation.js';
 import { GguiSessionNotFoundError } from './errors.js';
@@ -134,6 +134,20 @@ export interface BillingGate {
 export interface GguiUpdateHandlerDeps extends RenderSliceMetaDeps {
     /** GguiSession-backing store. Used to load + persist the patched render. */
     readonly renderStore: GguiSessionStore;
+    /**
+     * Durable render-identity side store. When present, a successful
+     * patch refreshes the existing record's view of the row it just
+     * re-committed — props, the sequence at that commit, and the
+     * freshness stamp. The identity itself (`blueprintId`,
+     * `contractKey`, `variantKey`) is carried forward untouched; this
+     * tool never sees the agreed contract those keys were derived from,
+     * so it is in no position to recompute them.
+     *
+     * A render with no record yet (store wired after it was rendered) is
+     * skipped, not synthesized. Writes are best-effort and can never
+     * fail the patch. Absent = no refresh, everything else unchanged.
+     */
+    readonly renderIdentityStore?: RenderIdentityStore;
     /**
      * Optional live-subscriber notifier. When present, every successful
      * persistence fans a `{type:'props_update', payload:{sessionId, props}}`

package/dist/renders/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/renders/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,sBAAsB,EAEtB,KAAK,UAAU,EAEhB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjE,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAGvD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED;;;wDAGwD;AACxD,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;QAC7B;;;;WAIG;QACH,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa,CAAC;KAC9C,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAO/B;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,WAAW;IACf;;;;;OAKG;;IAEH;;;;OAIG;;;;;IAEH;;;;OAIG;;IAEH;;;;;OAKG;;CAEK,CAAC;AAEX,QAAA,MAAM,YAAY;;;IAGhB;;;;;;;;;OASG;;CAEK,CAAC;AAEX,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,qBAAqB,GAC1B,aAAa,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,EAAE,YAAY,CAAC,CAiRtE"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/renders/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,sBAAsB,EAEtB,KAAK,UAAU,EAEhB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjE,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAGvD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED;;;wDAGwD;AACxD,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;QAC7B;;;;WAIG;QACH,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa,CAAC;KAC9C,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IACnD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAO/B;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,WAAW;IACf;;;;;OAKG;;IAEH;;;;OAIG;;;;;IAEH;;;;OAIG;;IAEH;;;;;OAKG;;CAEK,CAAC;AAEX,QAAA,MAAM,YAAY;;;IAGhB;;;;;;;;;OASG;;CAEK,CAAC;AAEX,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,qBAAqB,GAC1B,aAAa,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,EAAE,YAAY,CAAC,CAsRtE"}

package/dist/renders/update.js

@@ -63,6 +63,7 @@
 import { z } from 'zod';
 import { ContractViolationError, } from '@ggui-ai/protocol';
 import { GGUI_RENDER_UI_META, toMcpAppEnvelope, } from '@ggui-ai/protocol/integrations/mcp-apps';
+import { refreshRenderIdentity } from './render-identity.js';
 import { applyGguiSessionPatch, } from './apply-ggui-session-patch.js';
 import { assembleRenderSliceBase, deriveRenderMeta, } from './slice-meta-derivation.js';
 import { GguiSessionNotFoundError } from './errors.js';
@@ -254,7 +255,7 @@ export function createGguiUpdateHandler(deps) {
             // replaces visible-bits in place. Lifecycle fields owned by the
             // store (createdAt, eventSequence, hostSession) preserved across
             // the upsert.
-            await deps.renderStore.commit({
+            const committed = await deps.renderStore.commit({
                 render: updatedSession,
                 appId: stored.appId,
                 ...(stored.userId !== undefined ? { userId: stored.userId } : {}),
@@ -266,6 +267,10 @@ export function createGguiUpdateHandler(deps) {
                     ? { hostSession: stored.hostSession }
                     : {}),
             });
+            // Keep the durable identity record's view of this row current.
+            // Reads the row the commit RETURNED so the record can't disagree
+            // with what was persisted.
+            await refreshRenderIdentity(deps.renderIdentityStore, committed);
             // Best-effort live delivery. Persistence is the source of truth;
             // the live-channel fan-out is a latency optimization. Errors are
             // swallowed — a failed notify must not fail the tool call (the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/mcp-server-handlers",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "MCP tool handler logic for the ggui protocol. Pure over @ggui-ai/mcp-server-core seams and consumed by @ggui-ai/mcp-server. Never imports AWS, HTTP transports, or CLI concerns.",
   "keywords": [
     "ggui",
@@ -69,17 +69,17 @@
   },
   "dependencies": {
     "zod": "^4.3.6",
-    "@ggui-ai/mcp-server-core": "0.6.2",
-    "@ggui-ai/negotiator": "0.6.2",
-    "@ggui-ai/protocol": "0.6.2",
-    "@ggui-ai/ui-registry": "0.6.2",
-    "@ggui-ai/ui-gen": "0.6.2"
+    "@ggui-ai/mcp-server-core": "0.7.0",
+    "@ggui-ai/negotiator": "0.7.0",
+    "@ggui-ai/protocol": "0.7.0",
+    "@ggui-ai/ui-gen": "0.7.0",
+    "@ggui-ai/ui-registry": "0.7.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "typescript": "^5.0.0",
     "vitest": "^3.2.6",
-    "@ggui-ai/protocol-conformance": "0.6.2"
+    "@ggui-ai/protocol-conformance": "0.7.0"
   },
   "repository": {
     "type": "git",