@ggui-ai/iframe-runtime 0.2.0-alpha.3 → 0.3.0-rc.0

package/dist/context-observer.d.ts

@@ -116,10 +116,10 @@ export declare function installContextRegistry(registry: GguiContextRegistry, re
  *
  * Post-render-identity-collapse (2026-05-27): the previous
  * `{sessionId, appId, stackItemId}` tuple collapsed to
- * `{renderId, appId}` — render is the single identity key.
+ * `{sessionId, appId}` — render is the single identity key.
  */
 export interface ContextPostIdentity {
-    readonly renderId: string;
+    readonly sessionId: string;
     readonly appId: string;
 }
 /**
@@ -174,7 +174,7 @@ export interface ContextSnapshotPoster {
      * mirror.
      */
     readonly postContextMirror: (params: {
-        readonly renderId: string;
+        readonly sessionId: string;
         readonly appId: string;
         readonly snapshot: Record<string, unknown>;
     }) => void;
@@ -238,7 +238,7 @@ export declare function createContextStateHost(deps: {
     readonly consoleWarn?: (...args: unknown[]) => void;
     /** Identity bundle for the server-mirror destination. Threaded
      *  unchanged into `createSingleSlotProvider` so every slot's debounced
-     *  post carries the same authoritative session binding. */
+     *  post carries the same authoritative render binding. */
     readonly identity?: ContextPostIdentity;
 }): (props: {
     readonly slots: ReadonlyArray<ResolvedContextSlot>;

package/dist/context-observer.js

@@ -82,7 +82,7 @@ function specFor(slot) {
  *      — the existing path; agent's LLM reads these via
  *      `read_widget_context` for in-turn awareness.
  *   2. `tools/call` for `ggui_runtime_sync_context` — the server mirror.
- *      Server stores the snapshot on the active Render; chat-
+ *      Server stores the snapshot on the active GguiSession; chat-
  *      history rehydrate seeds `contextSlots[i].default` with the
  *      snapshotted values, restoring the user's last-known state.
  *
@@ -95,7 +95,7 @@ function specFor(slot) {
  * (`[ggui:context-slot] {slot,value}`). Empirical: claude.ai's host
  * treats each `ui/update-model-context` post as a REPLACE of the
  * widget's tracked context, not a per-slot merge. Server mirror
- * matches: REPLACE-per-renderId, last-write-wins. Both destinations
+ * matches: REPLACE-per-sessionId, last-write-wins. Both destinations
  * therefore stay structurally consistent.
  *
  * Server-mirror skipped when `identity` is undefined — dev/test code
@@ -117,7 +117,7 @@ function postContextSnapshot(poster, snapshot, identity) {
     // (dev / test paths without a real bootstrap).
     if (identity) {
         poster.postContextMirror({
-            renderId: identity.renderId,
+            sessionId: identity.sessionId,
             appId: identity.appId,
             snapshot,
         });

package/dist/events-polling.d.ts

@@ -2,14 +2,14 @@
  * Registry-level events-polling composition for the iframe-runtime (R7).
  *
  * The R7 cursor-replay model — paired transport of the
- * `/api/renders/:renderId/events?sinceSequence=N&limit=100` HTTP endpoint
+ * `/api/sessions/:sessionId/events?sinceSequence=N&limit=100` HTTP endpoint
  * + the WS subscribe `sinceSequence` cursor. Both transports replay
- * from the same RenderEvent ledger; the polling client uses HTTP, the
+ * from the same GguiSessionEvent ledger; the polling client uses HTTP, the
  * live client uses WS, and they SHARE the cursor model. Switching
  * transports does not lose events.
  *
  * Semantics (vs. R6 snapshot-polling):
- *   - **URL** — `/api/renders/<renderId>/events?wsToken=<token>` with
+ *   - **URL** — `/api/sessions/<sessionId>/events?wsToken=<token>` with
  *     `sinceSequence` and `limit` added per tick.
  *   - **Interval** — fixed 2000ms (mirrors R6's default).
  *   - **parseSnapshot** — reads the `EventsResponse` envelope, dispatches
@@ -27,7 +27,7 @@
  * Iframes mounted inside the Anthropic SDK lose `__GGUI_META__` because
  * the SDK strips `_meta` from `tools/call` responses before forwarding
  * the structured-content shell to the iframe. R5's documented gap was
- * that the first push's payload never reached the iframe.
+ * that the first render's payload never reached the iframe.
  *
  * R7's principled fix: the same /events endpoint that powers polling
  * ALSO serves the cold-mount path. An iframe booting without inline
@@ -43,7 +43,7 @@ export interface BuildEventsPollingOptions {
     /**
      * Base URL the polling tick reads from. The composer appends
      * `&sinceSequence=<cursor>&limit=<limit>` per tick. Typically the
-     * `/api/renders/<renderId>/events?wsToken=<token>` URL the iframe
+     * `/api/sessions/<sessionId>/events?wsToken=<token>` URL the iframe
      * derived from the render slice. Must already include a `?` or `&`
      * separator-ready terminator; we add the cursor params with
      * `&` if the URL contains `?`, else `?`.
@@ -70,8 +70,8 @@ export interface BuildEventsPollingOptions {
 }
 /**
  * Build a {@link RegistryPollingOptions} descriptor that reads
- * `/api/renders/:renderId/events?sinceSequence=N&limit=M` and dispatches
- * each `RenderEvent` by `event.type` to the registry's matching
+ * `/api/sessions/:sessionId/events?sinceSequence=N&limit=M` and dispatches
+ * each `GguiSessionEvent` by `event.type` to the registry's matching
  * channel handler. Cursor advances per-tick to the server's
  * `lastSequence`.
  *

package/dist/events-polling.js

@@ -27,9 +27,9 @@ function isEventsResponse(body) {
     return true;
 }
 /**
- * Type guard for one RenderEvent in the events array.
+ * Type guard for one GguiSessionEvent in the events array.
  */
-function isRenderEvent(value) {
+function isGguiSessionEvent(value) {
     if (value === null || typeof value !== 'object')
         return false;
     const obj = value;
@@ -45,8 +45,8 @@ function isRenderEvent(value) {
 }
 /**
  * Build a {@link RegistryPollingOptions} descriptor that reads
- * `/api/renders/:renderId/events?sinceSequence=N&limit=M` and dispatches
- * each `RenderEvent` by `event.type` to the registry's matching
+ * `/api/sessions/:sessionId/events?sinceSequence=N&limit=M` and dispatches
+ * each `GguiSessionEvent` by `event.type` to the registry's matching
  * channel handler. Cursor advances per-tick to the server's
  * `lastSequence`.
  *
@@ -129,7 +129,7 @@ export function buildEventsPolling(opts) {
             // the dispatch shape to a list per type.
             const frames = {};
             for (const event of body.events) {
-                if (!isRenderEvent(event))
+                if (!isGguiSessionEvent(event))
                     continue;
                 frames[event.type] = {
                     type: event.type,

package/dist/globals.d.ts

@@ -146,7 +146,7 @@ export interface GguiGlobalRegistry {
      * in `<CurrentStepContext.Provider value={…}>` and the runtime
      * observer reads values back via `useContext`.
      *
-     * Mutable across re-mounts: on a second `bootSelfContained` call,
+     * Mutable across re-mounts: on a re-mount (a second `applyRender`),
      * the registry is REUSED (entries are keyed by contextName and
      * skipped on re-create) so the LLM's destructured Context
      * references stay live across re-mounts. Only NEW context names

package/dist/host-context-emitter.d.ts

@@ -9,7 +9,7 @@
  *      `ui/notifications/host-context-changed` postMessage from the host.
  *   2. Echo each fresh value as a `type: 'host_context_observed'`
  *      WebSocket envelope so the server can persist it on
- *      `RenderRecord.hostContext` for agent visibility.
+ *      `GguiSessionRecord.hostContext` for agent visibility.
  *   3. Suppress no-op re-emissions (via deep-equality on the projection
  *      shape) — avoids server-side write traffic when a notification
  *      arrives but no projection-visible field actually changed (e.g.,
@@ -26,7 +26,7 @@
  *
  * Lifecycle:
  *
- *   - Initial seed: `seed(projection, renderId)` called from
+ *   - Initial seed: `seed(projection, sessionId)` called from
  *     `bootProduction` right after the WS transport is attached and we
  *     know the initial projection from `projectHostContext(app.getHostContext())`.
  *     {@link applyHostContextStyling} fires separately from
@@ -76,12 +76,12 @@ export type HostContextSendFn = (msg: {
  * the same projection) suppresses the duplicate emission via the
  * equality check.
  *
- * Re-seeding with a DIFFERENT `renderId` is undefined behavior; the
+ * Re-seeding with a DIFFERENT `sessionId` is undefined behavior; the
  * iframe-runtime is one-render-per-mount by construction. Tests
  * exercising multi-render flows MUST call `detach()` between seeds.
  */
 export declare function seed(args: {
-    readonly renderId: string;
+    readonly sessionId: string;
     readonly send: HostContextSendFn;
     readonly initial: HostContextProjection;
 }): void;

package/dist/host-context-emitter.js

@@ -9,7 +9,7 @@
  *      `ui/notifications/host-context-changed` postMessage from the host.
  *   2. Echo each fresh value as a `type: 'host_context_observed'`
  *      WebSocket envelope so the server can persist it on
- *      `RenderRecord.hostContext` for agent visibility.
+ *      `GguiSessionRecord.hostContext` for agent visibility.
  *   3. Suppress no-op re-emissions (via deep-equality on the projection
  *      shape) — avoids server-side write traffic when a notification
  *      arrives but no projection-visible field actually changed (e.g.,
@@ -26,7 +26,7 @@
  *
  * Lifecycle:
  *
- *   - Initial seed: `seed(projection, renderId)` called from
+ *   - Initial seed: `seed(projection, sessionId)` called from
  *     `bootProduction` right after the WS transport is attached and we
  *     know the initial projection from `projectHostContext(app.getHostContext())`.
  *     {@link applyHostContextStyling} fires separately from
@@ -64,7 +64,7 @@ let state = null;
  * the same projection) suppresses the duplicate emission via the
  * equality check.
  *
- * Re-seeding with a DIFFERENT `renderId` is undefined behavior; the
+ * Re-seeding with a DIFFERENT `sessionId` is undefined behavior; the
  * iframe-runtime is one-render-per-mount by construction. Tests
  * exercising multi-render flows MUST call `detach()` between seeds.
  */
@@ -72,7 +72,7 @@ export function seed(args) {
     // First seed — record state + emit initial.
     if (state === null) {
         state = {
-            renderId: args.renderId,
+            sessionId: args.sessionId,
             send: args.send,
             current: args.initial,
             listener: null,
@@ -167,7 +167,7 @@ export function _peekCurrent() {
 }
 /**
  * Subscribe to local projection updates so
- * iframe-side consumers (canvas mount handle's display-mode state)
+ * iframe-side consumers (e.g. display-mode state on the mount handle)
  * can react to `host-context-changed` notifications without re-
  * parsing the postMessage envelope themselves.
  *
@@ -178,7 +178,7 @@ export function _peekCurrent() {
  *     `state.current` (post-projection, post-equality-check).
  *
  * Returns an unsubscribe function. Multi-subscriber by design —
- * tests + production canvas mount can coexist.
+ * tests + the production mount can coexist.
  */
 const localSubscribers = new Set();
 export function subscribeLocal(listener) {
@@ -316,7 +316,7 @@ function emit() {
         state.send({
             type: 'host_context_observed',
             payload: {
-                renderId: state.renderId,
+                sessionId: state.sessionId,
                 hostContext: state.current,
             },
         });
@@ -328,8 +328,8 @@ function emit() {
         // eventually-consistent, not transactional.
     }
     // Fan out to local iframe-side subscribers
-    // (canvas mount's display-mode state). Independent from the
-    // WS-send try/catch above — a send failure must not skip the
+    // (e.g. display-mode state on the mount handle). Independent from
+    // the WS-send try/catch above — a send failure must not skip the
     // local fan-out, and a subscriber throwing must not skip other
     // subscribers.
     for (const listener of localSubscribers) {