@ggui-ai/protocol-reference-server 0.25.0 → 0.26.0

package/README.md

@@ -1,17 +1,17 @@
 # @ggui-ai/protocol-reference-server
 
-Minimal reference implementation of the **ggui protocol** — the narrow WebSocket server
+Minimal reference implementation of the **GGUI protocol** — the narrow WebSocket server
 that `@ggui-ai/protocol-conformance` runs against to prove the protocol is vendor-neutral.
 
 This package is **not a production server**. It implements exactly enough of the
-ggui live-channel WebSocket wire to pass the conformance kit. Its deliberate design
+GGUI live-channel WebSocket wire to pass the conformance kit. Its deliberate design
 constraint — zero runtime dependency on `@ggui-ai/mcp-server*` — is what makes the
 vendor-neutrality claim real: an independent, from-scratch implementation passing the
 kit grounds the claim empirically rather than by assertion.
 
 ## Scope
 
-- WebSocket transport matching the ggui live-channel wire.
+- WebSocket transport matching the GGUI live-channel wire.
 - In-memory render store with a consume-buffer event ledger (no persistence).
 - `schemaVersion` handshake with `UPGRADE_REQUIRED` on mismatch.
 - Subscribe app scope: the subscribe's `appId` must match the GguiSession's
@@ -49,9 +49,10 @@ Prints `READY ws://127.0.0.1:3100/ws` when bound. Ctrl-C to stop.
 ## CI proof
 
 `src/conformance.test.ts` boots this server and runs `@ggui-ai/protocol-conformance`
-against it through a `ConformanceHost` adapter. Every drivable conformance fixture must
+against it through a `ConformanceHost` adapter. Every drivable MUST fixture must
 pass (bootstrap-success, action-ack-sequence, undeclared-action-rejected,
 action-payload-schema-violation, version-match, version-mismatch, app-mismatch,
 absent-appid-defaults, host-context-observed-persists); directives outside this server's scope
 (renderer-url-override, ui-initialize-response-override, and similar) skip cleanly per
-the kit's design.
+the kit's design. The one SHOULD it declines, `fresh-subscribe-replays-reserved-preview` (this server keeps no
+retained stream, so a fresh subscribe replays nothing), is graded a warning and pinned as the exact warned set.

package/dist/conformance-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conformance-host.d.ts","sourceRoot":"","sources":["../src/conformance-host.ts"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,EAC7C,cAAc,GACf,EAAE,mCAAmC,GAAG,eAAe,CA+IvD"}
+{"version":3,"file":"conformance-host.d.ts","sourceRoot":"","sources":["../src/conformance-host.ts"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,EAC7C,cAAc,GACf,EAAE,mCAAmC,GAAG,eAAe,CAyIvD"}

package/dist/conformance-host.js

@@ -112,20 +112,16 @@ export function createReferenceConformanceHost({ serverInstance, }) {
                     schemaVersion: serverInstance.renders.get(sessionId)?.versionOverride ??
                         serverInstance.advertisedVersion,
                 });
-                const fanned = serverInstance.renders.injectFrame(sessionId, {
+                // `injectFrame` reaches no one when no subscriber is attached. The
+                // kit dispatches every setup directive before it subscribes, and
+                // this server keeps no retained stream, so a later fresh subscribe
+                // replays nothing. That is the SHOULD the kit grades as a warning
+                // (`fresh-subscribe-replays-reserved-preview`), not a directive
+                // failure, so the result is not checked here.
+                serverInstance.renders.injectFrame(sessionId, {
                     type: 'data',
                     payload: envelope,
                 });
-                if (!fanned) {
-                    // No subscribers attached — the directive's emission is
-                    // unobservable. Surface for fixture-authoring debuggability
-                    // (the canonical sequence is create-session → subscribe →
-                    // emit-envelope; fixtures that swap order silently lose the
-                    // injection). Not a throw — the directive itself succeeded;
-                    // the unobservability is a fixture concern.
-                    // eslint-disable-next-line no-console
-                    console.warn(`[@ggui-ai/protocol-reference-server] emit-envelope on render '${sessionId}' channel '${step.channel}' had no subscribers — frame dropped`);
-                }
                 return;
             }
             if (step.kind === 'renderer-url-override') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/protocol-reference-server",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Minimal reference implementation of the ggui protocol. Implements exactly enough of the live-channel WebSocket wire to pass the @ggui-ai/protocol-conformance kit. Not a production server — it exists to prove the protocol is vendor-neutral: an independent, from-scratch implementation passing the kit grounds that claim empirically.",
   "keywords": [
     "ggui",
@@ -29,14 +29,14 @@
   },
   "dependencies": {
     "ws": "^8.20.1",
-    "@ggui-ai/protocol": "0.25.0"
+    "@ggui-ai/protocol": "0.26.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/ws": "^8.5.10",
     "typescript": "^5.0.0",
     "vitest": "^3.2.6",
-    "@ggui-ai/protocol-conformance": "0.25.0"
+    "@ggui-ai/protocol-conformance": "0.26.0"
   },
   "repository": {
     "type": "git",