@ggui-ai/ui-visual-tester 0.8.0 → 0.9.0

package/fixture/fixture-runtime.js

@@ -42344,7 +42344,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.8.0";
+  var STDLIB_GADGETS_VERSION = "0.9.0";
   var STDLIB_GADGETS = [
     {
       package: STDLIB_GADGETS_PACKAGE,
@@ -42961,10 +42961,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     "PRODUCTION_FAILED",
     "VALIDATION_ERROR",
     "NO_PLATFORM_KEY",
-    "NO_CREDENTIALS"
+    "NO_CREDENTIALS",
+    "GENERATION_QUEUE_OVERLOADED"
   ]);
   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."),
+    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. GENERATION_QUEUE_OVERLOADED: the deployment's admission gate rejected the request before generation started (queue full or wait timed out) \u2014 not a failed attempt; safe to retry immediately."),
     message: external_exports.string().describe("Human-readable failure detail \u2014 fold into the next attempt or surface to the operator.")
   });
   var resourceReadErrorCodeSchema = external_exports.enum([
@@ -43022,33 +43023,78 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       description: external_exports.string(),
       example: external_exports.string(),
       args: external_exports.object({
-        sessionId: external_exports.string()
+        sessionId: external_exports.string(),
+        // The per-call long-poll window in seconds. Carried on the hint
+        // because consume's own default is 0 (single non-blocking
+        // drain): an agent copying a timeout-less hint gets an instant
+        // empty result and stops looping.
+        timeout: external_exports.number()
       })
-    }).optional().describe("Recovery hint \u2014 when the rendered contract has actions, points the agent at ggui_consume({sessionId}) for the inbound action loop. Absent for pure-display renders.")
+    }).optional().describe("Required-next-call hint \u2014 when the rendered contract has actions, points the agent at ggui_consume({sessionId, timeout}) for the inbound action loop. Absent for pure-display renders.")
   });
   var updateInputSchema = external_exports.discriminatedUnion("kind", [
     external_exports.object({
       sessionId: external_exports.string().describe("GguiSession 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.")
+      props: external_exports.record(external_exports.string(), external_exports.unknown()).describe("Full replacement props map. New map IS the new state, rendered as a NEW card (a new history entry). For an in-place repaint of the mounted card use ggui_amend.")
     }).strict(),
     external_exports.object({
       sessionId: external_exports.string().describe("GguiSession 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.")
+      patch: external_exports.record(external_exports.string(), external_exports.unknown()).describe("RFC 7396 JSON Merge Patch \u2014 null deletes a key; arrays fully replace. The merged state renders as a NEW card (a new history entry). For an in-place repaint of the mounted card use ggui_amend.")
+    }).strict()
+  ]);
+  var amendInputSchema = external_exports.discriminatedUnion("kind", [
+    external_exports.object({
+      sessionId: external_exports.string().describe("GguiSession 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, applied to the currently mounted card in place.")
+    }).strict(),
+    external_exports.object({
+      sessionId: external_exports.string().describe("GguiSession 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. Applied to the currently mounted card in place.")
     }).strict()
   ]);
   var updateOutputSchema = external_exports.object({
     sessionId: external_exports.string(),
     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
+     * The epoch-pinned URI of the NEW history record this update minted
+     * (`ui://ggui/render/{id}[/{key}]#{epoch}` — see epoch-uri.ts). On a
+     * no-op (`updated: false`) no record is minted and this is the bare
+     * live-head URI. 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()
+    resourceUri: external_exports.string(),
+    /**
+     * The session's head epoch after this call: advanced by one on a
+     * real update (`updated: true`), unchanged on a no-op. `ggui_render`
+     * mints epoch 0. The session ROW is the authority
+     * (`GguiSessionBase.epoch`, absent ⇒ 0); the ledger's `ui.reminted`
+     * events are the wire signal only — the ledger is horizon-bounded
+     * and must never be counted as the source of truth.
+     */
+    epoch: external_exports.number().int().min(0),
+    /**
+     * Present ONLY on a no-op (`updated: false`): the patch conformed to
+     * the contract but left the final props semantically identical to
+     * the current state, so nothing was written, nothing changes on
+     * screen, and NO new history record was minted. Model-visible by
+     * design — the common producer of a no-op is an agent echoing
+     * existing props back believing it changed the UI, and this field is
+     * its feedback channel.
+     */
+    warning: external_exports.string().optional()
+  });
+  var amendOutputSchema = external_exports.object({
+    sessionId: external_exports.string(),
+    updated: external_exports.boolean(),
+    resourceUri: external_exports.string(),
+    /** Same no-op feedback channel as ggui_update's `warning`. */
+    warning: external_exports.string().optional()
   });
   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.")
@@ -43057,6 +43103,45 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     saved: external_exports.boolean(),
     appId: external_exports.string()
   }).strict();
+  var RUNTIME_PULL_MAX_LIMIT = 100;
+  var RUNTIME_PULL_MAX_WAIT_SECONDS = 20;
+  var gguiSessionEventSchema = external_exports.object({
+    seq: external_exports.number().int().min(1).describe('Monotonic, gap-free per render; starts at 1 (0 is the "no events yet" cursor sentinel, never an event).'),
+    type: external_exports.string().min(1).describe("Wire-frame type \u2014 see the canonical GguiSessionEventType taxonomy; plain string so servers can mint new types without a protocol bump."),
+    timestamp: external_exports.string().describe("ISO 8601 UTC timestamp the server stamped on emission."),
+    data: external_exports.unknown().describe("Type-specific payload \u2014 structurally identical to the matching live-channel frame payload.")
+  });
+  var runtimePullInputShape = {
+    sessionId: external_exports.string().min(1).describe('Active render id \u2014 sourced from `_meta["ai.ggui/render"].sessionId` on the iframe boot envelope. Unknown and cross-tenant ids surface uniformly as session_not_found.'),
+    sinceSequence: external_exports.number().int().min(0).optional().describe("Replay cursor \u2014 only events with seq > sinceSequence return. Omit (= 0) on first pull; advance to the last event's seq (or lastSequence on an empty page) on every subsequent pull."),
+    limit: external_exports.number().int().min(1).optional().describe(`Max events per page. Values above ${RUNTIME_PULL_MAX_LIMIT} are clamped to ${RUNTIME_PULL_MAX_LIMIT}; omit for the default ${RUNTIME_PULL_MAX_LIMIT}. When hasMore is true, immediately re-pull with the advanced cursor.`),
+    wait: external_exports.number().min(0).optional().describe(`Subscription-mode hold, in seconds. When set and the cursor page is empty, the server holds this call until an event lands or the hold elapses (values above ${RUNTIME_PULL_MAX_WAIT_SECONDS} are clamped to ${RUNTIME_PULL_MAX_WAIT_SECONDS}). An empty page after a full hold is a NORMAL result \u2014 immediately re-pull to stay subscribed, or back off to sparse un-held pulls after a few consecutive empties. Omit (= 0) for an immediate return.`)
+  };
+  var runtimePullInputSchema = external_exports.object(runtimePullInputShape);
+  var runtimePullEventsPageSchema = external_exports.object({
+    events: external_exports.array(gguiSessionEventSchema),
+    lastSequence: external_exports.number().int().min(0),
+    hasMore: external_exports.boolean()
+  });
+  var runtimePullHorizonSchema = external_exports.object({
+    reason: external_exports.literal("REPLAY_HORIZON_PASSED"),
+    currentSequence: external_exports.number().int().min(0)
+  });
+  var runtimePullOutputSchema = external_exports.union([
+    runtimePullEventsPageSchema,
+    runtimePullHorizonSchema
+  ]);
+  var RUNTIME_TELEMETRY_MAX_EVENTS = 40;
+  var runtimeTelemetryInputShape = {
+    sessionId: external_exports.string().min(1).describe("Render id the report concerns \u2014 sourced from the boot envelope. Client-claimed: used as a log tag only."),
+    events: external_exports.array(external_exports.object({
+      at: external_exports.number().min(0).describe("Milliseconds since iframe boot (monotonic, client clock)."),
+      kind: external_exports.string().min(1).max(64).describe("Event name \u2014 e.g. 'boot.path', 'status.connected', 'channel_failover_swap', 'doorbell.ring'."),
+      detail: external_exports.string().max(512).optional().describe("Optional compact context (JSON fragment or message).")
+    })).min(1).max(RUNTIME_TELEMETRY_MAX_EVENTS).describe("Batched ladder/doorbell events, oldest first.")
+  };
+  var runtimeTelemetryInputSchema = external_exports.object(runtimeTelemetryInputShape);
+  var runtimeTelemetryOutputSchema = external_exports.object({ ok: external_exports.literal(true) });
 
   // ../protocol/dist/schemas/invoke.js
   var textBlockSchema = external_exports.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/ui-visual-tester",
-  "version": "0.8.0",
+  "version": "0.9.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/design": "0.8.0",
-    "@ggui-ai/wire": "0.8.0",
-    "@ggui-ai/protocol": "0.8.0"
+    "@ggui-ai/design": "0.9.0",
+    "@ggui-ai/protocol": "0.9.0",
+    "@ggui-ai/wire": "0.9.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",