@ggui-ai/ui-visual-tester 0.1.0-rc.3 → 0.2.0-alpha.1

package/dist/fixture-runtime.js

@@ -141,7 +141,7 @@ function mountTree(Comp) {
      */
     const wireConfig = {
         app: { appId: 'vt-app', appName: 'vt-app' },
-        session: { sessionId: 'vt-session', isConnected: true },
+        render: { renderId: 'vt-render', isConnected: true },
         auth: { isAuthenticated: false },
         dispatch: (actionName, data) => {
             dispatches.push({ actionName, data, t: Date.now() });

package/fixture/fixture-runtime.js

@@ -27121,7 +27121,7 @@
     useAuth: () => useAuth,
     useContract: () => useContract,
     useGguiContext: () => useGguiContext,
-    useSession: () => useSession,
+    useRender: () => useRender,
     useStream: () => useStream,
     useWireContext: () => useWireContext,
     validateInboundPropsPayload: () => validateInboundPropsPayload,
@@ -27264,14 +27264,14 @@
     return app;
   }
 
-  // ../wire/dist/useSession.js
-  function useSession() {
-    const { session } = useWireContext();
-    return session;
+  // ../wire/dist/useRender.js
+  function useRender() {
+    const { render } = useWireContext();
+    return render;
   }
 
   // ../protocol/dist/version.js
-  var PROTOCOL_VERSION = "draft-2026-05-24";
+  var PROTOCOL_VERSION = "draft-2026-05-28";
   var PROTOCOL_SCHEMA_VERSION = PROTOCOL_VERSION;
   var CLIENT_SUPPORTED_VERSIONS = Object.freeze([
     PROTOCOL_SCHEMA_VERSION
@@ -41495,28 +41495,18 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     colorScheme: external_exports.enum(["light", "dark"]).optional(),
     reducedMotion: external_exports.boolean().optional()
   }).passthrough();
-  var popInputSchema = external_exports.object({
-    sessionId: external_exports.string().describe("Session opaque id from ggui_new_session.")
-  }).strict();
   var consumeInputSchema = external_exports.object({
-    stackItemId: external_exports.string().describe("Stack item opaque id (UUID) \u2014 returned by ggui_push."),
+    renderId: external_exports.string().describe("Render opaque id (UUID) \u2014 returned by ggui_render."),
     timeout: external_exports.number().min(0).max(25).optional().describe("Long-poll timeout in seconds (default short; max 25).")
   }).strict();
   var emitInputSchema = external_exports.object({
-    sessionId: external_exports.string().describe("Session opaque id from ggui_new_session."),
-    channel: external_exports.string().describe("Channel name declared on the active stack item streamSpec."),
+    renderId: external_exports.string().describe("Render opaque id (UUID) \u2014 returned by ggui_render."),
+    channel: external_exports.string().describe("Channel name declared on the active render streamSpec."),
     payload: external_exports.unknown().describe("Payload \u2014 must match streamSpec[channel].schema."),
-    complete: external_exports.boolean().optional().describe("True marks the stream complete; subsequent emits on this channel reject."),
-    stackItemId: external_exports.string().optional().describe("Stack item to scope this emit to; defaults to session top.")
-  }).strict();
-  var getSessionInputSchema = external_exports.object({
-    sessionId: external_exports.string().describe("Session opaque id from ggui_new_session.")
-  }).strict();
-  var getStackInputSchema = external_exports.object({
-    sessionId: external_exports.string().describe("Session opaque id from ggui_new_session.")
+    complete: external_exports.boolean().optional().describe("True marks the stream complete; subsequent emits on this channel reject.")
   }).strict();
-  var closeInputSchema = external_exports.object({
-    sessionId: external_exports.string().describe("Session opaque id from ggui_new_session.")
+  var getRenderInputSchema = external_exports.object({
+    renderId: external_exports.string().describe("Render opaque id (UUID) \u2014 returned by ggui_render.")
   }).strict();
   var listFeaturedBlueprintsInputSchema = external_exports.object({
     level: external_exports.enum(["primitive", "component", "composite", "template"]).optional(),
@@ -41536,27 +41526,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   var requestCredentialInputSchema = external_exports.object({
     serviceId: external_exports.string().describe('OAuth service ID (e.g., "bashdoor", "ubot")'),
     reason: external_exports.string().optional().describe("Why the agent needs this credential (shown to user)"),
-    sessionId: external_exports.string().optional().describe("Existing session ID to push consent UI into")
+    renderId: external_exports.string().optional().describe("Existing render id to push consent UI into.")
   }).strict();
-  var newSessionInputSchema = external_exports.object({}).strict();
-  var newSessionOutputSchema = external_exports.object({
-    sessionId: external_exports.string().describe("Thread this through every subsequent ggui_handshake / ggui_update call in this chat."),
-    appId: external_exports.string(),
-    createdAt: external_exports.string().describe("ISO 8601 \u2014 creation timestamp of the freshly-minted session."),
-    nextStep: external_exports.object({
-      tool: external_exports.literal("ggui_handshake"),
-      description: external_exports.string(),
-      example: external_exports.string()
-    }).describe("Wire-shape recovery hint \u2014 a worked literal example of the next call.")
-  });
   var handshakeInputSchema = external_exports.object({
-    /**
-     * Required. Mint via `ggui_new_session` once per chat, then thread
-     * through every subsequent handshake. Server validates existence +
-     * tenant ownership; unknown / cross-tenant ids surface as
-     * session_not_found.
-     */
-    sessionId: external_exports.string().min(1).describe("Session handle minted by ggui_new_session. Required \u2014 call ggui_new_session({seed?}) first to obtain one. Reuse the same sessionId across multiple handshake/push pairs in the same chat to grow the session stack."),
     /**
      * Concise semantic identity of the UI. Same intent across calls =
      * same component reused. Required — drives blueprint-search keying
@@ -41576,20 +41548,20 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
      * Skip blueprint-search on step-2 and route straight to validation
      * + (if validation passes) agent-mode suggestion against the draft.
      * Used after a prior handshake returned an unwanted cache suggestion
-     * and the agent wants to force a fresh-gen path on the paired push.
+     * and the agent wants to force a fresh-gen path on the paired render.
      */
     forceCreate: external_exports.boolean().optional()
   }).strict();
   var handshakeOutputSchema = external_exports.object({
-    handshakeId: external_exports.string().describe("Stable id \u2014 pass to ggui_push / ggui_update"),
-    action: external_exports.enum(["create", "reuse", "update", "replace", "compose", "declined"]),
+    handshakeId: external_exports.string().describe("Stable id \u2014 pass to ggui_render / ggui_update"),
+    action: external_exports.enum(["create", "reuse", "update", "replace", "declined"]),
     /**
      * The handshake suggestion — see `handshakeSuggestionSchema`. The
      * routing discriminator is `suggestion.origin`; `blueprintMeta` is
      * ALWAYS present; `amendments` / `validationFindings` are
      * conditional on the routing outcome.
      */
-    suggestion: handshakeSuggestionSchema.describe("Server's suggestion \u2014 origin-routed (cache | agent | synth). Always carries a provisional `blueprintMeta` the agent reuses by sending `decision: 'accept'` on push."),
+    suggestion: handshakeSuggestionSchema.describe("Server's suggestion \u2014 origin-routed (cache | agent | synth). Always carries a provisional `blueprintMeta` the agent reuses by sending `decision: 'accept'` on render."),
     /**
      * Truncated human-readable rationale for the `action` value. Helps
      * the agent and the operator narrate why the server chose to reuse a cached
@@ -41599,19 +41571,19 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
      */
     reason: external_exports.string().max(280).optional().describe("Short rationale (\u2264280 chars) for the `action` value. Surfaced for agent + operator visibility; truncated to keep the structuredContent payload predictable."),
     nextStep: external_exports.object({
-      tool: external_exports.literal("ggui_push"),
+      tool: external_exports.literal("ggui_render"),
       description: external_exports.string(),
       example: external_exports.string()
-    }).optional().describe("Wire-shape recovery hint. A worked literal example of the next ggui_push call the agent should emit \u2014 the example string can be copied verbatim and tweaked (e.g. fill in `props` placeholders). Top-level field so a skimming agent finds it immediately.")
+    }).optional().describe("Wire-shape recovery hint. A worked literal example of the next ggui_render call the agent should emit \u2014 the example string can be copied verbatim and tweaked (e.g. fill in `props` placeholders). Top-level field so a skimming agent finds it immediately.")
   });
-  var pushInputSchema = external_exports.object({
+  var renderInputSchema = external_exports.object({
     handshakeId: external_exports.string({
-      message: "ggui_push: handshakeId is REQUIRED. Call ggui_handshake({sessionId, intent, blueprintDraft}) first to negotiate \u2014 handshake returns a handshakeId + suggestion. Then push with {handshakeId, decision: {kind: 'accept'}} (accept the suggestion) or {handshakeId, decision: {kind: 'override', blueprintDraft: {...}}} (override with a fresh draft). Direct-push without a handshakeId is not supported."
-    }).min(1, "ggui_push: handshakeId must be a non-empty string from a prior ggui_handshake call."),
+      message: "ggui_render: handshakeId is REQUIRED. Call ggui_handshake({intent, blueprintDraft}) first to negotiate \u2014 handshake returns a handshakeId + suggestion. Then render with {handshakeId, decision: {kind: 'accept'}} (accept the suggestion) or {handshakeId, decision: {kind: 'override', blueprintDraft: {...}}} (override with a fresh draft). Direct-render without a handshakeId is not supported."
+    }).min(1, "ggui_render: handshakeId must be a non-empty string from a prior ggui_handshake call."),
     /**
      * Runtime prop values for THIS render. Validated against the
      * effective contract's `propsSpec` — required-field checks + type
-     * checks per spec entry. Validation failures fail the push with a
+     * checks per spec entry. Validation failures fail the render with a
      * recoverable `ContractViolationError`.
      */
     props: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
@@ -41629,20 +41601,28 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
      */
     decision: pushDecisionSchema.describe("Accept the handshake suggestion (use provisional blueprintId verbatim) or override with a fresh draft (mint new blueprintId).")
   }).strict();
-  var pushOutputSchema = external_exports.object({
-    stackItemId: external_exports.string(),
-    url: external_exports.string().url(),
-    action: external_exports.enum(["create", "reuse", "update", "replace", "compose", "declined"]),
+  var renderOutputSchema = external_exports.object({
+    renderId: external_exports.string(),
+    /**
+     * Spec-canonical MCP-Apps entry-point — same `ui://ggui/render/{id}`
+     * URI surfaced on `_meta.ui.resourceUri`. Surfacing it on the LLM-
+     * visible structuredContent too lets SDKs that strip `_meta` from
+     * tool_results (OpenAI Agents SDK, Google ADK) reach the mount URI;
+     * SDKs that preserve `_meta` see the same value on both fields.
+     * Mirrors the `resourceUri` field on `ggui_update`'s output.
+     */
+    resourceUri: external_exports.string(),
+    action: external_exports.enum(["create", "reuse", "update", "replace", "declined"]),
     /**
      * Wire-shape recovery hint for the next call. Emitted ONLY when the
-     * pushed contract has a non-empty `actionSpec` — i.e. the agent will
-     * receive user-action events on this stack item. Pure-display pushes
+     * rendered contract has a non-empty `actionSpec` — i.e. the agent will
+     * receive user-action events on this render. Pure-display renders
      * (props only) get no `nextStep` because there is nothing to consume.
      *
-     * Mirrors the chain at `new_session.nextStep` (→ handshake) and
-     * `handshake.nextStep` (→ push). Closes the loop with consume.
+     * Mirrors the chain at `handshake.nextStep` (→ render). Closes the loop
+     * with consume.
      *
-     * `args.stackItemId` is the literal value the agent passes to
+     * `args.renderId` is the literal value the agent passes to
      * `ggui_consume` — copy-paste shape.
      */
     nextStep: external_exports.object({
@@ -41650,24 +41630,24 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       description: external_exports.string(),
       example: external_exports.string(),
       args: external_exports.object({
-        stackItemId: external_exports.string()
+        renderId: external_exports.string()
       })
-    }).optional().describe("Recovery hint \u2014 when the pushed contract has actions, points the agent at ggui_consume({stackItemId}) for the inbound action loop. Absent for pure-display pushes.")
+    }).optional().describe("Recovery hint \u2014 when the rendered contract has actions, points the agent at ggui_consume({renderId}) for the inbound action loop. Absent for pure-display renders.")
   });
   var updateInputSchema = external_exports.discriminatedUnion("kind", [
     external_exports.object({
-      stackItemId: external_exports.string().describe("Stack item opaque id (UUID) \u2014 returned by ggui_push."),
+      renderId: external_exports.string().describe("Render opaque id (UUID) \u2014 returned by ggui_render."),
       kind: external_exports.literal("replace"),
       props: external_exports.record(external_exports.string(), external_exports.unknown()).describe("Full replacement props map. New map IS the new state.")
     }).strict(),
     external_exports.object({
-      stackItemId: external_exports.string().describe("Stack item opaque id (UUID) \u2014 returned by ggui_push."),
+      renderId: external_exports.string().describe("Render opaque id (UUID) \u2014 returned by ggui_render."),
       kind: external_exports.literal("merge"),
       patch: external_exports.record(external_exports.string(), external_exports.unknown()).describe("RFC 7396 JSON Merge Patch \u2014 null deletes a key; arrays fully replace.")
     }).strict()
   ]);
   var updateOutputSchema = external_exports.object({
-    stackItemId: external_exports.string(),
+    renderId: external_exports.string(),
     updated: external_exports.boolean()
   });
 
@@ -46731,15 +46711,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   }
   function makeActionEnvelope(parts) {
     const envelope = {
-      sessionId: parts.sessionId,
+      renderId: parts.renderId,
       type: parts.type
     };
     if (parts.payload !== void 0)
       envelope.payload = parts.payload;
-    if (parts.stackIndex !== void 0)
-      envelope.stackIndex = parts.stackIndex;
-    if (parts.stackItemId !== void 0)
-      envelope.stackItemId = parts.stackItemId;
     if (parts.clientSeq !== void 0)
       envelope.clientSeq = parts.clientSeq;
     const stamp = resolveSchemaVersion(parts);
@@ -47158,12 +47134,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
           });
         }
         break;
-      case "push_started":
-        requireString("stackItemId");
+      case "render_started":
+        requireString("renderId");
         requireString("intent");
         break;
       case "consume_polling":
-        requireString("stackItemId");
+        requireString("renderId");
         if (p.state !== "open") {
           violations.push({
             field: "state",
@@ -47177,7 +47153,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         violations.push({
           field: "kind",
           message: `Unknown lifecycle kind '${p.kind}'. Closed union; new kinds bump protocol version.`,
-          expected: "'handshake_started' | 'handshake_completed' | 'push_started' | 'consume_polling'",
+          expected: "'handshake_started' | 'handshake_completed' | 'render_started' | 'consume_polling'",
           received: p.kind
         });
     }
@@ -47295,7 +47271,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 
   // ../protocol/dist/bridge/invoke-agent.js
   var agentResponseSchema = external_exports.object({
-    sessionId: external_exports.string().optional(),
+    hostSessionId: external_exports.string().optional(),
     text: external_exports.string().optional(),
     events: external_exports.array(external_exports.object({
       type: external_exports.string(),
@@ -50217,7 +50193,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     "useStream",
     "useAuth",
     "useApp",
-    "useSession",
+    "useRender",
     // `useGguiContext` is the contextSpec hook every generated
     // component imports for declared context slots.
     "useGguiContext",
@@ -50650,7 +50626,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     window.__ggui_test_dispatches__ = dispatches;
     const wireConfig = {
       app: { appId: "vt-app", appName: "vt-app" },
-      session: { sessionId: "vt-session", isConnected: true },
+      render: { renderId: "vt-render", isConnected: true },
       auth: { isAuthenticated: false },
       dispatch: (actionName, data) => {
         dispatches.push({ actionName, data, t: Date.now() });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/ui-visual-tester",
-  "version": "0.1.0-rc.3",
+  "version": "0.2.0-alpha.1",
   "description": "Behavioral validator for ggui-generated component code. Renders a component in real Chromium via Playwright, clicks each action declared in its contract, and verifies the action actually does something — mutating bound state or dispatching to the agent. Catches buttons wired to no-op handlers that structural validators miss. Playwright is an optional peer dependency, injected by the caller.",
   "keywords": [
     "ggui",
@@ -48,9 +48,9 @@
   "dependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@ggui-ai/design": "0.1.0-rc.3",
-    "@ggui-ai/protocol": "0.1.0-rc.3",
-    "@ggui-ai/wire": "0.1.0-rc.3"
+    "@ggui-ai/design": "0.2.0-alpha.1",
+    "@ggui-ai/wire": "0.2.0-alpha.1",
+    "@ggui-ai/protocol": "0.2.0-alpha.1"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.0",