@ggui-ai/ui-visual-tester 0.3.0-rc.0 → 0.4.0-rc.0

package/fixture/fixture-runtime.js

@@ -41055,7 +41055,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 
   // ../protocol/dist/gadgets/stdlib-gadgets.js
   var STDLIB_GADGETS_PACKAGE = "@ggui-ai/gadgets";
-  var STDLIB_GADGETS_VERSION = "0.3.0";
+  var STDLIB_GADGETS_VERSION = "0.4.0-rc.0";
   var STDLIB_GADGETS = [
     {
       package: STDLIB_GADGETS_PACKAGE,
@@ -41668,6 +41668,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     kind: external_exports.enum(["full-template", "cold"]).optional().describe("full-template = a whole stored component was served; cold = freshly generated."),
     reason: external_exports.string().optional().describe("Compact human-readable explanation of the cache outcome \u2014 why this render reused a stored component or generated cold. Diagnostic; default-available without the verbose env-gated trace.")
   });
+  var renderErrorCodeSchema = external_exports.enum([
+    "PRODUCTION_FAILED",
+    "VALIDATION_ERROR",
+    "NO_PLATFORM_KEY",
+    "NO_CREDENTIALS"
+  ]);
+  var renderErrorSchema = external_exports.object({
+    code: renderErrorCodeSchema.describe("Canonical failure class. PRODUCTION_FAILED: generation did not produce a component. VALIDATION_ERROR: a server-side precondition rejected the render before generation. NO_PLATFORM_KEY: the server's managed provider-key configuration has no key for the resolved route. NO_CREDENTIALS: no generation credentials are configured on the server."),
+    message: external_exports.string().describe("Human-readable failure detail \u2014 fold into the next attempt or surface to the operator.")
+  });
   var renderOutputSchema = external_exports.object({
     sessionId: external_exports.string(),
     /**
@@ -41677,13 +41687,24 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
      * 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.
+     *
+     * OPTIONAL — present iff the render is mountable. Absent on the
+     * failure envelope (`error` present): a failed render commits an
+     * error GguiSession but exposes no mount affordance.
      */
-    resourceUri: external_exports.string(),
+    resourceUri: external_exports.string().optional().describe("MCP-Apps mount URI (ui://ggui/render/{id}). Present iff the render is mountable; absent on a failed render."),
     action: external_exports.enum(["create", "reuse", "update", "replace", "declined"]),
     contractHash: external_exports.string().describe("Canonical hash of the rendered data contract (shape only \u2014 fields, types, specs). Same hash \u27FA same data flow."),
     blueprintId: external_exports.string().describe("Opaque id of the materialised component for this render. On the handshake-decided reuse paths (accept a cache-origin proposal, or a variance re-aim that resolves to an existing variant) it is the stored id \u2014 equal ids across renders mean the same stored component. override.contract always generates cold and mints a fresh id, even for an identical contract."),
     variantKey: external_exports.string().describe("Canonical hash of the design-time variance (persona, aesthetic, seed prompt, context). With contractHash it forms the reuse key: the same pair reuses one component; a different variant of the same contract gets its own."),
     cache: renderCacheMarkerSchema.describe("Reuse outcome for this render: whether a stored component was served, its similarity, the matched component id, and how many generation calls that avoided."),
+    /**
+     * In-result failure marker — present iff the tool result is
+     * `isError: true`. The structuredContent stays schema-conformant on
+     * failures; this field carries the canonical `{code, message}`
+     * classification. Absent on every successful render.
+     */
+    error: renderErrorSchema.optional().describe("Present iff the tool result is isError \u2014 canonical {code, message} for a failed/rejected generation. Absent on success."),
     /**
      * Wire-shape recovery hint for the next call. Emitted ONLY when the
      * rendered contract has a non-empty `actionSpec` — i.e. the agent will
@@ -41719,7 +41740,15 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   ]);
   var updateOutputSchema = external_exports.object({
     sessionId: external_exports.string(),
-    updated: external_exports.boolean()
+    updated: external_exports.boolean(),
+    /**
+     * Unchanged from the initial render — the same `ui://ggui/render/{id}`
+     * URI the mount stamped. Mirrored on the LLM-visible structuredContent
+     * so SDKs that strip `_meta` from tool_results can still reach the
+     * mount URI. Kept in sync with the update handler's wire shape —
+     * this export and the handler's inline schema must not drift.
+     */
+    resourceUri: external_exports.string()
   });
   var declareToolCatalogInputSchema = external_exports.object({
     toolCatalog: external_exports.record(external_exports.string(), external_exports.object({ name: external_exports.string(), version: external_exports.string().optional() }).strict()).describe("Per-app canonical tool identities: bare tool name -> its server's initialize-declared serverInfo. Host/library-supplied; not an agent action.")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/ui-visual-tester",
-  "version": "0.3.0-rc.0",
+  "version": "0.4.0-rc.0",
   "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/protocol": "0.3.0-rc.0",
-    "@ggui-ai/design": "0.3.0-rc.0",
-    "@ggui-ai/wire": "0.3.0-rc.0"
+    "@ggui-ai/design": "0.4.0-rc.0",
+    "@ggui-ai/protocol": "0.4.0-rc.0",
+    "@ggui-ai/wire": "0.4.0-rc.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",
@@ -60,7 +60,7 @@
     "esbuild": "^0.25.12",
     "playwright-core": "^1.60.0",
     "typescript": "^5.0.0",
-    "vitest": "^3.0.0"
+    "vitest": "^3.2.6"
   },
   "engines": {
     "node": ">=20.0.0"