@ggui-ai/protocol-conformance 0.23.0 → 0.24.0

package/dist/n1-compat-conformance/cases/release-9-1-handshake-suggestion.json

@@ -0,0 +1,27 @@
+{
+    "name": "release-9-1-handshake-suggestion",
+    "description": "The ggui_handshake suggestion in the shape ggui tag 9.1 (60a234ce0, serving prod) emits on a cache hit: `origin: cache`, the templated `match-semantic` rationale, a full `blueprintMeta` WITHOUT `matchedIntent`, and the contract summary. Built with that release's own `blueprintKey` / `summarizeContract` / `decide-handshake` cache-hit shape (the suggestion schema, key and summary code are unchanged since 60a234ce0). Today's handshakeSuggestionSchema MUST accept it: `blueprintMeta.matchedIntent` (#1336) is optional, so a consumer holding this release's payload keeps parsing (VERSION-POLICY §3.6).",
+    "release": {
+        "label": "ggui tag 9.1",
+        "sha": "60a234ce0"
+    },
+    "wire": "handshake-suggestion",
+    "payload": {
+        "origin": "cache",
+        "rationale": "match-semantic: a saved interface matches this intent — reusing it",
+        "blueprintMeta": {
+            "blueprintId": "bp_3f6c2a9e-8d41-4b7a-9c15-2e7f0b6d4a18",
+            "contractHash": "a84bfa0945745fee",
+            "codeHash": "d6b5657622c1bb6b6c33576a187b3f3d320337c90d6a2298a24a28e78cea13fc",
+            "source": {
+                "kind": "llm",
+                "generator": "ui-gen-default",
+                "model": "anthropic/claude-haiku-4-5"
+            },
+            "variance": {},
+            "selectedReason": "match-semantic: a saved interface matches this intent — reusing it"
+        },
+        "proposedContractSummary": "slots=∅; actions=archive(id); streams=∅; props=messages:array!"
+    },
+    "expect": "accepted"
+}

package/dist/n1-compat-conformance/index.d.ts

@@ -1,5 +1,5 @@
 /** The protocol-owned wires the catalog can grade. */
-export declare const N1_COMPAT_WIRES: readonly ["app-theme", "app-theme-read", "app-theme-carry", "render-meta", "generation-profile", "ops-generate-blueprint"];
+export declare const N1_COMPAT_WIRES: readonly ["app-theme", "app-theme-read", "app-theme-carry", "render-meta", "generation-profile", "ops-generate-blueprint", "handshake-suggestion"];
 /** `backward`: the previous release's payload against today's parser. `forward`: a later release's payload against today's READ door. */
 export declare const N1_COMPAT_DIRECTIONS: readonly ["backward", "forward"];
 export type N1CompatDirection = (typeof N1_COMPAT_DIRECTIONS)[number];

package/dist/n1-compat-conformance/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/n1-compat-conformance/index.ts"],"names":[],"mappings":"AA8BA,sDAAsD;AACtD,eAAO,MAAM,eAAe,4HAA6H,CAAC;AAE1J,yIAAyI;AACzI,eAAO,MAAM,oBAAoB,kCAAmC,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iKAAiK;IACjK,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAgDD,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAQhC,CAAC;AA2FpB,4DAA4D;AAC5D,wBAAgB,sBAAsB,IAAI,SAAS,cAAc,EAAE,CAgBlE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/n1-compat-conformance/index.ts"],"names":[],"mappings":"AA+BA,sDAAsD;AACtD,eAAO,MAAM,eAAe,oJAAqJ,CAAC;AAElL,yIAAyI;AACzI,eAAO,MAAM,oBAAoB,kCAAmC,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iKAAiK;IACjK,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAgDD,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAShC,CAAC;AAoGpB,4DAA4D;AAC5D,wBAAgB,sBAAsB,IAAI,SAAS,cAAc,EAAE,CAkBlE"}

package/dist/n1-compat-conformance/index.js

@@ -14,17 +14,18 @@
  * Pure-function catalog: no transport, no adopter input — graded on every
  * `runConformance()` and by the kit's own unit lane.
  */
-import { appGenerationProfileSchema, appThemeGetResponseSchema, appThemeSchema, opsGenerateBlueprintInputSchema, parseAppThemeAtReadDoor } from '@ggui-ai/protocol';
+import { appGenerationProfileSchema, appThemeGetResponseSchema, appThemeSchema, handshakeSuggestionSchema, opsGenerateBlueprintInputSchema, parseAppThemeAtReadDoor } from '@ggui-ai/protocol';
 import { MCP_APP_AI_GGUI_RENDER_META_KEY, parseMcpAppAiGguiRenderMeta, } from '@ggui-ai/protocol/integrations/mcp-apps';
 import release2AppThemeV2 from './cases/release-2-app-theme-v2.json' with { type: 'json' };
 import release2RenderMeta from './cases/release-2-render-meta.json' with { type: 'json' };
 import release2GenerationProfile from './cases/release-2-generation-profile.json' with { type: 'json' };
 import release2OpsGenerateBlueprint from './cases/release-2-ops-generate-blueprint.json' with { type: 'json' };
+import release91HandshakeSuggestion from './cases/release-9-1-handshake-suggestion.json' with { type: 'json' };
 import forwardAppThemeUnknownMember from './cases/forward-app-theme-unknown-member.json' with { type: 'json' };
 import forwardAppThemeCarryUnknownMember from './cases/forward-app-theme-carry-unknown-member.json' with { type: 'json' };
 import forwardRenderMetaUnknownMember from './cases/forward-render-meta-unknown-member.json' with { type: 'json' };
 /** The protocol-owned wires the catalog can grade. */
-export const N1_COMPAT_WIRES = ['app-theme', 'app-theme-read', 'app-theme-carry', 'render-meta', 'generation-profile', 'ops-generate-blueprint'];
+export const N1_COMPAT_WIRES = ['app-theme', 'app-theme-read', 'app-theme-carry', 'render-meta', 'generation-profile', 'ops-generate-blueprint', 'handshake-suggestion'];
 /** `backward`: the previous release's payload against today's parser. `forward`: a later release's payload against today's READ door. */
 export const N1_COMPAT_DIRECTIONS = ['backward', 'forward'];
 function isN1CompatWire(v) {
@@ -80,6 +81,7 @@ export const N1_COMPAT_CASES = [
     release2RenderMeta,
     release2GenerationProfile,
     release2OpsGenerateBlueprint,
+    release91HandshakeSuggestion,
     forwardAppThemeUnknownMember,
     forwardAppThemeCarryUnknownMember,
     forwardRenderMetaUnknownMember,
@@ -176,6 +178,14 @@ function gradeRenderMeta(payload) {
             (sentSpent ? ', spentOneShots preserved' : ''),
     };
 }
+// ggui#1336 — the handshake suggestion the served release emits must keep parsing
+// when the suggestion gains an optional member (`blueprintMeta.matchedIntent`).
+function gradeHandshakeSuggestion(payload) {
+    const r = handshakeSuggestionSchema.safeParse(payload);
+    return r.success
+        ? { pass: true, detail: 'handshakeSuggestionSchema: accepted' }
+        : { pass: false, detail: `handshakeSuggestionSchema refused the previous release's suggestion: ${r.error.issues.map((i) => i.message).join('; ')}` };
+}
 /** Grade every N−1 case against the protocol as shipped. */
 export function runN1CompatConformance() {
     return N1_COMPAT_CASES.map((c) => {
@@ -189,7 +199,9 @@ export function runN1CompatConformance() {
                         ? gradeRenderMeta(c.payload)
                         : c.wire === 'generation-profile'
                             ? gradeGenerationProfile(c.payload)
-                            : gradeOpsGenerateBlueprint(c.payload);
+                            : c.wire === 'handshake-suggestion'
+                                ? gradeHandshakeSuggestion(c.payload)
+                                : gradeOpsGenerateBlueprint(c.payload);
         return { name: c.name, direction: c.direction, pass: graded.pass, detail: `${c.release.label} (${c.release.sha}) → ${graded.detail}` };
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/protocol-conformance",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Conformance test kit for the ggui protocol. Drives a behavioral fixture catalog against a live implementation over WebSocket, a resources/read catalog against a live MCP server, and nine pure-function catalogs (schema, registration, resolution, binding, props-schema, host-helper, refusal-envelope, registry-completeness, transport-refusal) for the gadget, tool-binding, schema-precise-render, host-helper and pre-generation-refusal obligations, reporting a scorecard-style pass / fail / skip. MCP builders adopt this kit to prove their implementation is protocol-conformant.",
   "license": "Apache-2.0",
   "keywords": [
@@ -104,7 +104,7 @@
   },
   "dependencies": {
     "ws": "^8.20.1",
-    "@ggui-ai/protocol": "0.23.0"
+    "@ggui-ai/protocol": "0.24.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",