@ggui-ai/iframe-runtime 0.23.0 → 0.24.0

package/dist/render-item.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react';
 import type { AppTheme, GguiSession } from '@ggui-ai/protocol/wire';
 import type { GguiSessionSeedInput } from './types.js';
-import { type WireConfig } from '@ggui-ai/wire';
+import { type BuiltWireConfig } from '@ggui-ai/wire';
 import type { StreamBus } from './wire-config.js';
 export interface RenderItemOptions {
     /** The render to mount. */
@@ -10,8 +10,10 @@ export interface RenderItemOptions {
      *  `buildRootWireConfig(...)` (see `wire-config.ts`). `null` ⇒ the
      *  component mounts without a wire provider (standalone — matches
      *  today's DynamicComponent fallback when no GguiRender parent is
-     *  present). */
-    readonly scopedWireConfig: WireConfig | null;
+     *  present). The config carries the card's `actionSpent` source
+     *  (ggui#1223), and the component mounts inside `ActionSpentContext` too,
+     *  so `useActionSpent` reads the one-shot guard's own spent set. */
+    readonly scopedWireConfig: BuiltWireConfig | null;
     /** Shared stream bus — provisional renderer subscribes to
      *  `_ggui:preview` for this render. */
     readonly streamBus: StreamBus;

package/dist/render-item.js

@@ -39,6 +39,7 @@
  */
 import { createElement } from 'react';
 import { GguiWireProvider } from '@ggui-ai/wire';
+import { ActionSpentContext } from '@ggui-ai/wire/internal';
 import { mountReactRoot } from './react-renderer.js';
 import { mountProvisional, } from './provisional-renderer.js';
 import { mountMcpAppIframe, } from './mcp-app-iframe-host.js';
@@ -208,9 +209,13 @@ export async function mountRender(container, opts) {
      * mount. When absent, the wire provider is the only wrapper.
      */
     function wrapInScopedProvider(mountedComponent) {
-        const wireWrapped = currentOpts.scopedWireConfig === null
+        const config = currentOpts.scopedWireConfig;
+        const wireWrapped = config === null
             ? mountedComponent
-            : createElement(GguiWireProvider, { config: currentOpts.scopedWireConfig, children: mountedComponent });
+            : createElement(GguiWireProvider, {
+                config,
+                children: createElement(ActionSpentContext.Provider, { value: config.actionSpent, children: mountedComponent }),
+            });
         return currentOpts.wrapOuter !== undefined
             ? currentOpts.wrapOuter(wireWrapped)
             : wireWrapped;

package/dist/runtime.js

@@ -3794,6 +3794,15 @@ async function bootProduction(opts) {
             // through `currentRender`-returning thunks so they always see the
             // latest snapshot without holding stale refs.
             let currentRender = null;
+            // ggui#1223 — who to tell when `currentRender` is replaced, so the card's
+            // spent state (read through `getCurrentGguiSession`) is re-read at once.
+            const renderListeners = new Set();
+            const onRenderChange = (listener) => {
+                renderListeners.add(listener);
+                return () => {
+                    renderListeners.delete(listener);
+                };
+            };
             let renderHandle = null;
             const dispatchToolName = resolveDispatchToolName();
             // Native-idiom interceptors — the replacement for the retired
@@ -3841,6 +3850,7 @@ async function bootProduction(opts) {
                 sessionId: meta.sessionId,
                 appId: meta.appId,
                 getCurrentGguiSession: () => currentRender,
+                renderChanges: onRenderChange,
                 manager,
                 streamBus,
                 onDispatchEnvelope: (envelope) => {
@@ -3998,6 +4008,8 @@ async function bootProduction(opts) {
             };
             const applyRender = async (render) => {
                 currentRender = render;
+                for (const listener of [...renderListeners])
+                    listener();
                 if (renderHandle === null) {
                     renderHandle = await mountRender(renderInto, buildOpts(render));
                     return;

package/dist/shims/wire.js

@@ -1 +1 @@
-const w = globalThis.__ggui__.wire; export const useAction = w.useAction; export const useStream = w.useStream; export const useAuth = w.useAuth; export const useApp = w.useApp; export const useRender = w.useRender; export const useGguiContext = w.useGguiContext; export const useContract = w.useContract; export const useWireContext = w.useWireContext; export const GguiWireProvider = w.GguiWireProvider; export default w;
+const w = globalThis.__ggui__.wire; export const useAction = w.useAction; export const useStream = w.useStream; export const useAuth = w.useAuth; export const useApp = w.useApp; export const useRender = w.useRender; export const useGguiContext = w.useGguiContext; export const useContract = w.useContract; export const useWireContext = w.useWireContext; export const useActionSpent = w.useActionSpent; export const GguiWireProvider = w.GguiWireProvider; export default w;

package/dist/wire-config.d.ts

@@ -18,7 +18,7 @@
  */
 import type { ActionEnvelope, GguiSession } from '@ggui-ai/protocol/wire';
 import type { GguiSessionSeedInput } from './types.js';
-import { ClientContractViolationError, StreamBus, type WireConfig } from '@ggui-ai/wire';
+import { ClientContractViolationError, StreamBus, type BuiltWireConfig } from '@ggui-ai/wire';
 import type { WebSocketMessage } from '@ggui-ai/protocol/transport/websocket';
 /**
  * Outbound send surface — the minimal shape wire-config calls on the
@@ -48,6 +48,12 @@ export interface BuildRootWireConfigOptions {
      * WireConfig.
      */
     readonly getCurrentGguiSession: () => GguiSession | GguiSessionSeedInput | null;
+    /**
+     * The runtime's notice that the current render was replaced (a props
+     * update, a later live frame), so the card's spent state is re-read at
+     * once (ggui#1223). Passed through as wire's `spentInputsChanged`.
+     */
+    readonly renderChanges?: (listener: () => void) => () => void;
     /** Handle to the renderer's WS manager; used for outbound `action` frames. */
     readonly manager: RendererSendSurface;
     /** Shared bus for inbound stream deliveries. */
@@ -124,4 +130,4 @@ export interface BuildRootWireConfigOptions {
  * `RootWireConfigBundle` / `scopeWireConfig` / `buildScopedConfig`
  * indirection collapsed to a single `WireConfig`.
  */
-export declare function buildRootWireConfig(opts: BuildRootWireConfigOptions): WireConfig;
+export declare function buildRootWireConfig(opts: BuildRootWireConfigOptions): BuiltWireConfig;

package/dist/wire-config.js

@@ -87,6 +87,7 @@ export function buildRootWireConfig(opts) {
                 : undefined;
         },
         onActionSpecAbsent: nameUnenforceableOnce,
+        ...(opts.renderChanges !== undefined ? { spentInputsChanged: opts.renderChanges } : {}),
         // ggui#1223 — the card's persisted spent `oneShot` names. A re-served card
         // boots a new iframe, so the guard's in-memory set starts empty; the
         // render's record says what this card already spent. It counts only when

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/iframe-runtime",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "The iframe-local ggui runtime: a self-contained ESM bundle that boots inside an MCP Apps host iframe, runs the protocol-version handshake, opens the live-channel WebSocket, and mounts the rendered UI. Bundles React, ReactDOM, and the ggui design system so generated component code has a single seam to read from.",
   "keywords": [
     "ggui",
@@ -41,12 +41,12 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "zod": "^4.3.6",
-    "@ggui-ai/live-channel": "0.23.0",
-    "@ggui-ai/preview-a2ui": "0.23.0",
-    "@ggui-ai/protocol": "0.23.0",
-    "@ggui-ai/gadgets": "0.23.0",
-    "@ggui-ai/design": "0.23.0",
-    "@ggui-ai/wire": "0.23.0"
+    "@ggui-ai/design": "0.24.0",
+    "@ggui-ai/gadgets": "0.24.0",
+    "@ggui-ai/live-channel": "0.24.0",
+    "@ggui-ai/preview-a2ui": "0.24.0",
+    "@ggui-ai/protocol": "0.24.0",
+    "@ggui-ai/wire": "0.24.0"
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.27.0"