@ggui-ai/protocol 0.2.0-alpha.4 → 0.4.0-rc.0

package/dist/types/{canvas-lifecycle.d.ts → lifecycle.d.ts}

@@ -1,24 +1,21 @@
 /**
- * Canvas-mode lifecycle envelopes.
+ * Generation-progress lifecycle envelopes.
  *
  * Carried over the reserved `_ggui:lifecycle` channel via `data`
  * WebSocket messages. The server emits at four lifecycle moments;
- * canvas iframes consume (via the animator host) to drive their
- * pill state machine:
+ * subscribed clients consume them to drive progress indicators:
  *
  *   - `handshake_started` / `handshake_completed`: bracket each
- *     `ggui_handshake` call so the animator can render "negotiating"
+ *     `ggui_handshake` call so a progress UI can render "negotiating"
  *     during the gap.
  *   - `render_started`: emitted at the gen gate of `ggui_render`, before
- *     the final `render` envelope lands. Drives the animator's
- *     `constructing` state. The eventual `render` envelope (existing
- *     wire type) signals completion → animator transitions to
- *     `content`.
+ *     the final `render` envelope lands. Drives a "constructing"
+ *     indicator. The eventual `render` envelope (existing wire type)
+ *     signals completion → the indicator gives way to content.
  *   - `consume_polling`: signals that `ggui_consume` opened a long-
- *     poll. The animator's `listening` state. The complementary
- *     "close" signal is the existing `drain_ack` envelope (consume
- *     drained an action) — no separate "closed" lifecycle kind is
- *     needed.
+ *     poll — a "listening" indicator. The complementary "close"
+ *     signal is the existing `drain_ack` envelope (consume drained an
+ *     action) — no separate "closed" lifecycle kind is needed.
  *
  * Discriminated on `kind`. Adding a kind is a protocol-version bump,
  * not a silent extension — keeps the union closed so producers and
@@ -30,38 +27,39 @@
  *
  * Boundary discipline:
  *   - This module describes ENVELOPE SHAPES carried on a reserved
- *     channel. It does NOT describe the animator state machine that
- *     consumes them (lives in `@ggui-ai/iframe-runtime/canvas/animator`).
+ *     channel. It does NOT describe the progress-indicator state
+ *     machine that consumes them — that is client-side presentation,
+ *     outside the protocol.
  *   - This module is `data` only — no functions, no reducers. Pure
  *     types so the protocol bundle stays tiny.
  */
 import type { JsonObject } from './data-contract';
 /**
  * Emitted when the server starts processing a `ggui_handshake` call.
- * Animator transitions from current state into `handshake` (or its
- * `content`-substate equivalent).
+ * Progress UIs transition from their current state into a
+ * "negotiating" indicator.
  */
 export interface HandshakeStartedPayload extends JsonObject {
     readonly kind: 'handshake_started';
     readonly handshakeId: string;
-    /** Agent's intent string — animator may surface this as a label. */
+    /** Agent's intent string — consumers may surface this as a label. */
     readonly intent: string;
 }
 /**
- * Emitted when the server finishes a `ggui_handshake` call. Animator
- * either drops back to `ready`/`content` (no gen expected) or
- * pre-warms to `constructing` if `genExpected: true` so the
- * transition from handshake → constructing doesn't flicker.
+ * Emitted when the server finishes a `ggui_handshake` call. A progress
+ * UI either drops back to its idle/content state (no gen expected) or
+ * pre-warms its "constructing" indicator if `genExpected: true` so the
+ * handshake → constructing transition doesn't flicker.
  */
 export interface HandshakeCompletedPayload extends JsonObject {
     readonly kind: 'handshake_completed';
     readonly handshakeId: string;
-    /** Negotiator outcome — informational; animator may surface. */
+    /** Negotiator outcome — informational; consumers may surface. */
     readonly outcome: 'accepted' | 'amended' | 'declined' | 'cached';
     /**
      * Whether a cold gen is about to follow this handshake. When true,
-     * the canvas may pre-warm the `constructing` state to suppress a
-     * `handshake → ready → constructing` flicker.
+     * the consumer may pre-warm its "constructing" indicator to suppress
+     * a `handshake → idle → constructing` flicker.
      */
     readonly genExpected: boolean;
 }
@@ -72,34 +70,34 @@ export interface HandshakeCompletedPayload extends JsonObject {
  */
 export interface RenderStartedPayload extends JsonObject {
     readonly kind: 'render_started';
-    /** The render id the eventual `render` envelope will carry. */
-    readonly renderId: string;
-    /** Echoed for the animator label ("Building: <intent>"). */
+    /** The GguiSession id the eventual `render` envelope will carry. */
+    readonly sessionId: string;
+    /** Echoed for the progress label ("Building: <intent>"). */
     readonly intent: string;
 }
 /**
  * Emitted when `ggui_consume` opens a long-poll (after the action
- * pipe is found empty). Animator transitions to `listening`. The
- * complementary "close" signal is the existing `drain_ack` envelope.
+ * pipe is found empty) — a "listening" indicator. The complementary
+ * "close" signal is the existing `drain_ack` envelope.
  */
 export interface ConsumePollingPayload extends JsonObject {
     readonly kind: 'consume_polling';
     /**
      * Always `'open'` today — the closing transition is signaled
      * by the existing `drain_ack` envelope (action consumed) and by the
-     * absence of further `consume_polling` for the same render.
+     * absence of further `consume_polling` for the same GguiSession.
      * Reserved as a discriminator field rather than implicit so future
      * `'closed'` / `'timeout'` variants can layer in without a wire
      * shape change.
      */
     readonly state: 'open';
-    /** Render id whose action pipe is being polled. */
-    readonly renderId: string;
+    /** GguiSession id whose action pipe is being polled. */
+    readonly sessionId: string;
 }
 /**
- * Closed discriminated union of every canvas-mode lifecycle payload.
- * New kinds bump the protocol version; consumers narrow on `kind`
- * with exhaustive switch.
+ * Closed discriminated union of every generation-progress lifecycle
+ * payload. New kinds bump the protocol version; consumers narrow on
+ * `kind` with exhaustive switch.
  */
-export type CanvasLifecyclePayload = HandshakeStartedPayload | HandshakeCompletedPayload | RenderStartedPayload | ConsumePollingPayload;
-//# sourceMappingURL=canvas-lifecycle.d.ts.map
+export type GguiLifecyclePayload = HandshakeStartedPayload | HandshakeCompletedPayload | RenderStartedPayload | ConsumePollingPayload;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/types/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/types/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,UAAU;IACzD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,yBAA0B,SAAQ,UAAU;IAC3D,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACjE;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC5B,uBAAuB,GACvB,yBAAyB,GACzB,oBAAoB,GACpB,qBAAqB,CAAC"}

package/dist/types/{canvas-lifecycle.js → lifecycle.js}

@@ -1,24 +1,21 @@
 /**
- * Canvas-mode lifecycle envelopes.
+ * Generation-progress lifecycle envelopes.
  *
  * Carried over the reserved `_ggui:lifecycle` channel via `data`
  * WebSocket messages. The server emits at four lifecycle moments;
- * canvas iframes consume (via the animator host) to drive their
- * pill state machine:
+ * subscribed clients consume them to drive progress indicators:
  *
  *   - `handshake_started` / `handshake_completed`: bracket each
- *     `ggui_handshake` call so the animator can render "negotiating"
+ *     `ggui_handshake` call so a progress UI can render "negotiating"
  *     during the gap.
  *   - `render_started`: emitted at the gen gate of `ggui_render`, before
- *     the final `render` envelope lands. Drives the animator's
- *     `constructing` state. The eventual `render` envelope (existing
- *     wire type) signals completion → animator transitions to
- *     `content`.
+ *     the final `render` envelope lands. Drives a "constructing"
+ *     indicator. The eventual `render` envelope (existing wire type)
+ *     signals completion → the indicator gives way to content.
  *   - `consume_polling`: signals that `ggui_consume` opened a long-
- *     poll. The animator's `listening` state. The complementary
- *     "close" signal is the existing `drain_ack` envelope (consume
- *     drained an action) — no separate "closed" lifecycle kind is
- *     needed.
+ *     poll — a "listening" indicator. The complementary "close"
+ *     signal is the existing `drain_ack` envelope (consume drained an
+ *     action) — no separate "closed" lifecycle kind is needed.
  *
  * Discriminated on `kind`. Adding a kind is a protocol-version bump,
  * not a silent extension — keeps the union closed so producers and
@@ -30,8 +27,9 @@
  *
  * Boundary discipline:
  *   - This module describes ENVELOPE SHAPES carried on a reserved
- *     channel. It does NOT describe the animator state machine that
- *     consumes them (lives in `@ggui-ai/iframe-runtime/canvas/animator`).
+ *     channel. It does NOT describe the progress-indicator state
+ *     machine that consumes them — that is client-side presentation,
+ *     outside the protocol.
  *   - This module is `data` only — no functions, no reducers. Pure
  *     types so the protocol bundle stays tiny.
  */

package/dist/types/live-channel.d.ts

@@ -15,14 +15,25 @@
  * The corresponding inbound user-action envelope ({@link ActionEnvelope})
  * lives in `types/events.ts` alongside the event-type enum.
  */
-import type { Render } from './session';
+import type { GguiSession } from './render';
 import type { JsonObject, JsonValue, StreamChannelMode } from './data-contract';
 /**
  * Payload for subscribe message
  */
 export interface SubscribePayload {
-    renderId: string;
-    appId: string;
+    sessionId: string;
+    /**
+     * App (tenant) identity. OPTIONAL — absent ⇒ the server resolves the
+     * caller's identity-default app, the same resolution rule the MCP
+     * route uses: a token binding (`wsToken` binds `(sessionId, appId)`)
+     * wins, then the deployment's identity → appId mapping, then the
+     * deployment default. Clients never invent a default; the identity
+     * resolves it server-side.
+     *
+     * When present it MUST match the GguiSession's bound `appId` or the
+     * subscribe fails `APP_MISMATCH` (SPEC §12.2.3).
+     */
+    appId?: string;
     /** Role of the subscriber: 'user' (Portal) or 'agent' (MCP bridge) */
     role?: 'user' | 'agent';
     /**
@@ -42,7 +53,7 @@ export interface SubscribePayload {
      *     the last envelope the client observed.
      *
      * Honored only by implementations that expose
-     * `RenderStreamBuffer`-backed replay. Hosted cloud does NOT
+     * `GguiSessionStreamBuffer`-backed replay. Hosted cloud does NOT
      * yet honor `fromSeq` — the field is silently ignored there. OSS
      * `@ggui-ai/mcp-server` honors it fully.
      */
@@ -50,7 +61,7 @@ export interface SubscribePayload {
     /**
      * Opaque WS auth credential for initial subscribe — the live-channel
      * counterpart to a bearer token. Symmetric with {@link
-     * SubscribePayload.renderId}/`appId`/`wsUrl` — names what it auths.
+     * SubscribePayload.sessionId}/`appId`/`wsUrl` — names what it auths.
      *
      * **Auth-credential string only.** Identity/render fields ride on
      * the `ai.ggui/render` slice meta delivered through the MCP Apps
@@ -64,7 +75,7 @@ export interface SubscribePayload {
      * field with the same semantics:
      *
      *   - Opaque to the client — validated server-side against the
-     *     subscribe's `renderId` + `appId`.
+     *     subscribe's `sessionId` + `appId`.
      *   - Short TTL (seconds-to-minutes); stale tokens are rejected
      *     (refresh via `ggui_runtime_refresh_ws_token` within the
      *     refresh window, otherwise re-handshake).
@@ -72,7 +83,7 @@ export interface SubscribePayload {
      *     can reconnect without a fresh handshake.
      *
      * On a successful ws-token-authed subscribe, the server SHOULD issue
-     * a longer-lived reconnect credential via {@link AckPayload.renderToken}.
+     * a longer-lived reconnect credential via {@link AckPayload.sessionToken}.
      *
      * Mutually compatible with upstream bearer-auth (`Authorization`
      * header / `?token=` query). When both are present, server behavior
@@ -101,7 +112,7 @@ export interface SubscribePayload {
      *
      * **Distinct from `fromSeq`.** `fromSeq` is for per-stream-channel
      * `StreamEnvelope` replay (declared `streamSpec[name].replay`
-     * policy); `sinceSequence` is for the render-level event ledger
+     * policy); `sinceSequence` is for the GguiSession-level event ledger
      * (render/update/props_update/etc.). Both cursors travel on the
      * same subscribe frame and the server honors them independently —
      * `sinceSequence` events replay first, then per-channel `fromSeq`
@@ -132,14 +143,6 @@ export interface SubscribePayload {
      * windows.
      */
     supportedVersions?: string[];
-    /**
-     * Optional bootstrap credential for transports that mint a one-time
-     * opaque token at handshake (e.g. an MCP Apps `_meta`-delivered short-
-     * lived bootstrap). Generic string slot, not coupled to any specific
-     * integration — host adapters interpret the value per their own
-     * bootstrap contract.
-     */
-    bootstrap?: string;
 }
 /**
  * Payload for ack message (subscribe response includes current render)
@@ -147,9 +150,9 @@ export interface SubscribePayload {
 export interface AckPayload {
     sequence: number;
     timestamp: number;
-    /** Current render snapshot (returned on subscribe). Single item,
+    /** Current session snapshot (returned on subscribe). Single item,
      *  not an array — Phase B collapsed the vessel. */
-    render?: Render;
+    session?: GguiSession;
     /**
      * Current outbound-stream cursor snapshot at the moment the ack is
      * sent. Distinct from `sequence` (which counts INBOUND events like
@@ -158,7 +161,7 @@ export interface AckPayload {
      *   - seed their `lastSeenSeq` if they didn't pass `fromSeq` on
      *     subscribe.
      *
-     * Absent on implementations without a `RenderStreamBuffer`.
+     * Absent on implementations without a `GguiSessionStreamBuffer`.
      * 0 means the render has recorded no outbound envelopes yet.
      */
     streamSeq?: number;
@@ -185,16 +188,16 @@ export interface AckPayload {
      *
      * Semantics:
      *   - Longer TTL than the ws token (minutes-to-hours).
-     *   - Bound to the same `renderId` + `appId`.
+     *   - Bound to the same `sessionId` + `appId`.
      *   - Passed on reconnect via the standard bearer path
-     *     (`Authorization: Bearer <renderToken>` or `?token=`), NOT in
+     *     (`Authorization: Bearer <sessionToken>` or `?token=`), NOT in
      *     `SubscribePayload.wsToken` (which is short-TTL and credential-scoped).
      *
      * Absent when the subscribe was bearer-authed (no ws-token-bound
      * reconnect credential needed) and on servers that don't implement
      * ws-token auth.
      */
-    renderToken?: string;
+    sessionToken?: string;
     /**
      * Protocol schema version this server emits on. Advertised on every
      * successful ack. First-party servers populate this with
@@ -213,11 +216,11 @@ export interface AckPayload {
 }
 /**
  * Payload for render message (Server → Client: agent push event with
- * generated/cached UI). Carries a {@link Render} — either a
+ * generated/cached UI). Carries a {@link GguiSession} — either a
  * component variant or an embedded MCP Apps iframe variant.
  */
 export interface RenderPayload {
-    render: Render;
+    session: GguiSession;
     matchType?: string;
 }
 /**
@@ -242,8 +245,8 @@ export interface RenderPayload {
  * addition driven by a concrete client-UX need.
  */
 export interface StreamEnvelope {
-    /** Render this delivery belongs to. */
-    renderId: string;
+    /** GguiSession this delivery belongs to. */
+    sessionId: string;
     /** Channel name (keys into `spec.channels`). */
     channel: string;
     /**
@@ -266,7 +269,7 @@ export interface StreamEnvelope {
      */
     complete?: boolean;
     /**
-     * Render-scoped monotonic outbound sequence. Server-assigned;
+     * GguiSession-scoped monotonic outbound sequence. Server-assigned;
      * clients MUST NOT populate it on producer-side inputs. Gap-free
      * within a single render, starting at 1. Used by the client to:
      *   - track `lastSeenSeq` for reconnect (pass it back as
@@ -274,7 +277,7 @@ export interface StreamEnvelope {
      *   - dedupe deliveries (at-least-once semantics).
      *
      * OPTIONAL because hosted cloud does not yet stamp `seq`;
-     * implementations backed by `RenderStreamBuffer`
+     * implementations backed by `GguiSessionStreamBuffer`
      * (OSS `@ggui-ai/mcp-server`) always populate it. When absent,
      * clients treat deliveries as single-shot with no replay possible.
      * This becomes required once the hosted runtime supports replay.
@@ -290,17 +293,6 @@ export interface StreamEnvelope {
      */
     schemaVersion?: string;
 }
-/**
- * Payload for stream message (Server → Client)
- * Delivers streaming text chunks from the agent in real-time.
- */
-export interface StreamPayload {
-    renderId: string;
-    /** Text chunk from agent. Empty string on final (done=true) message. */
-    chunk: string;
-    /** Whether this is the final chunk in the stream. */
-    done: boolean;
-}
 /**
  * Payload for error message.
  * The `details` field is {@link JsonValue} to carry any JSON-safe diagnostic data.
@@ -328,15 +320,15 @@ export interface ErrorPayload {
  * to begin polling the channel's `streamSpec[ch].source.tool` on the
  * iframe's behalf and fan results out as `channel_payload` frames.
  *
- * Idempotent on reconnect: replaying the same `{renderId, channelName,
+ * Idempotent on reconnect: replaying the same `{sessionId, channelName,
  * pollIntervalMs?, args?}` triple after a WS disconnect re-binds the
  * existing subscription rather than minting a duplicate. The server is
  * authoritative on `pollIntervalMs` — clients propose, server caps to
  * its policy floor.
  */
 export interface ChannelSubscribePayload {
-    /** Active render id from the iframe's bootstrap. */
-    renderId: string;
+    /** Active GguiSession id from the iframe's bootstrap. */
+    sessionId: string;
     /** Active app id from the iframe's bootstrap. */
     appId: string;
     /** Channel name as keyed in `streamSpec`. The source.tool comes from the contract. */
@@ -356,13 +348,13 @@ export interface ChannelSubscribePayload {
 }
 /**
  * Payload for `channel_unsubscribe` (Client → Server). Idempotent: the
- * server tolerates an unsubscribe for an unknown `{renderId,
+ * server tolerates an unsubscribe for an unknown `{sessionId,
  * channelName}` pair (treats as a no-op + ack). Closing the WebSocket
  * implicitly unsubscribes all channels on that subscriber — this
  * message is for fine-grained mid-render cancellation.
  */
 export interface ChannelUnsubscribePayload {
-    renderId: string;
+    sessionId: string;
     appId: string;
     channelName: string;
 }
@@ -377,7 +369,7 @@ export interface ChannelUnsubscribePayload {
  * semantics as iframe-polled payloads.
  */
 export interface ChannelPayloadFrame {
-    renderId: string;
+    sessionId: string;
     appId: string;
     channelName: string;
     /** Server-monotonic sequence for this channel — gap-detection on the client. */
@@ -406,75 +398,34 @@ export interface ChannelPayloadFrame {
  *
  *   - `CHANNEL_UNKNOWN`         — channelName not present in streamSpec.
  *   - `CHANNEL_NOT_LOCAL`       — `source.tool` not in `streamWebSocketLocalTools`; iframe must poll directly.
- *   - `RENDER_NOT_FOUND`        — `renderId` not on the server.
+ *   - `SESSION_NOT_FOUND`        — `sessionId` not on the server.
  *   - `SUBSCRIBE_UNAUTHORIZED`  — WS auth token expired or render-mismatch.
  *   - `POLL_FAILED`             — source.tool invocation threw. `details` carries the error.
  */
 export interface ChannelErrorPayload {
-    renderId: string;
+    sessionId: string;
     channelName: string;
-    code: 'CHANNEL_UNKNOWN' | 'CHANNEL_NOT_LOCAL' | 'RENDER_NOT_FOUND' | 'SUBSCRIBE_UNAUTHORIZED' | 'POLL_FAILED' | (string & {});
+    code: 'CHANNEL_UNKNOWN' | 'CHANNEL_NOT_LOCAL' | 'SESSION_NOT_FOUND' | 'SUBSCRIBE_UNAUTHORIZED' | 'POLL_FAILED' | (string & {});
     message: string;
     details?: JsonValue;
 }
-/**
- * Payload for close message (Client → Server: close render)
- */
-export interface ClosePayload {
-    renderId: string;
-}
 /**
  * Generation strategy controls how ggui resolves UI generation requests.
  *
- * - `strict`   — Only use predefined/cached blueprints. Fails if no match found.
+ * - `strict`   — Only use cached/curated blueprints. Fails if no match found.
  * - `balanced` — Try blueprint matching first, fall back to LLM generation.
- * - `creative` — Always generate fresh UI via LLM (no blueprint matching).
- */
-export type GenerationStrategy = 'strict' | 'balanced' | 'creative';
-/**
- * Progress step during UI generation
  */
-export type ProgressStep = 'queued' | 'primitives' | 'writing' | 'compiling';
-/**
- * Payload for progress message (Server → Client)
- */
-export interface ProgressPayload {
-    renderId: string;
-    step: ProgressStep;
-    message: string;
-}
-/**
- * Payload for agent thinking message (Server → Client).
- * Sent immediately when a user message is received, before the agent processes it.
- * Agent message payload — used for both thinking and final messages.
- */
-export type AgentMsgType = 'thinking' | 'chat';
-export interface AgentMsgPayload {
-    /** Message type — 'thinking' for status updates, 'chat' for final responses */
-    type: AgentMsgType;
-    /** Message text from the agent */
-    message: string;
-    /** Render ID */
-    renderId: string;
-}
+export type GenerationStrategy = 'strict' | 'balanced';
 /**
  * Payload for props_update message (Server → Client).
  * Replaces props on an existing rendered component without re-generation.
  */
 export interface PropsUpdatePayload {
-    /** Render id of the rendered component being updated. */
-    renderId: string;
+    /** GguiSession id of the rendered component being updated. */
+    sessionId: string;
     /** New props — full replacement */
     props: JsonObject;
 }
-/**
- * Payload for url message (Server → Client)
- * Note: shortCode is returned; client constructs full URL using renderUrl from amplify_outputs
- */
-export interface UrlPayload {
-    renderId: string;
-    shortCode: string;
-}
 /**
  * System-level event actions sent from platform to client.
  *
@@ -501,15 +452,8 @@ export interface SystemPayload {
     status?: string;
     /** App ID requesting access (used with auth_required for app-scoped grants) */
     appId?: string;
-    /** Render ID for WebSocket context (used with auth_required) */
-    renderId?: string;
-}
-/**
- * Payload for internal:progress message (generator → handler)
- */
-export interface InternalProgressPayload {
-    renderId: string;
-    step: ProgressStep;
+    /** GguiSession ID for WebSocket context (used with auth_required) */
+    sessionId?: string;
 }
 /**
  * Payload for `drain_ack` (Server → Client). Sent by `ggui_consume` after
@@ -532,8 +476,8 @@ export interface InternalProgressPayload {
 export interface DrainAckPayload {
     /** Active app id from the bootstrap that emitted the action. */
     appId: string;
-    /** Render the drained event was queued on. */
-    renderId: string;
+    /** GguiSession the drained event was queued on. */
+    sessionId: string;
     /**
      * Server-assigned `ActionEnvelope.id` of the specific event that
      * was drained. The iframe-runtime keys its toast resolution on this

package/dist/types/live-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-channel.d.ts","sourceRoot":"","sources":["../../src/types/live-channel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"live-channel.d.ts","sourceRoot":"","sources":["../../src/types/live-channel.ts"],"names":[],"mappings":"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"}

package/dist/types/llm-route.d.ts

@@ -51,11 +51,11 @@
  *     ready.
  */
 export declare const MODELS: {
-    readonly anthropic: readonly ["claude-haiku-4-5-20251001", "claude-sonnet-4-6", "claude-opus-4-7", "claude-opus-4-6"];
-    readonly openai: readonly ["gpt-5.5", "gpt-5.5-2026-04-23", "gpt-5.5-pro", "gpt-5.5-pro-2026-04-23", "gpt-5.4", "gpt-5.4-2026-03-05", "gpt-5.4-mini", "gpt-5.4-mini-2026-03-17", "gpt-5.4-nano", "gpt-5.4-nano-2026-03-17", "gpt-5.3-codex"];
-    readonly google: readonly ["gemini-3.5-flash", "gemini-flash-latest", "gemini-3.1-flash-lite", "gemini-3.1-pro-preview", "gemini-3.1-flash-lite-preview", "gemini-3-flash-preview"];
+    readonly anthropic: readonly ["claude-fable-5", "claude-opus-5", "claude-sonnet-5", "claude-haiku-4-5-20251001", "claude-sonnet-4-6", "claude-opus-4-7", "claude-opus-4-6"];
+    readonly openai: readonly ["gpt-5.6", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-5.5", "gpt-5.5-2026-04-23", "gpt-5.5-pro", "gpt-5.5-pro-2026-04-23", "gpt-5.4", "gpt-5.4-2026-03-05", "gpt-5.4-mini", "gpt-5.4-mini-2026-03-17", "gpt-5.4-nano", "gpt-5.4-nano-2026-03-17", "gpt-5.3-codex"];
+    readonly google: readonly ["gemini-3.6-flash", "gemini-3.5-flash", "gemini-3.5-flash-lite", "gemini-flash-latest", "gemini-3.1-flash-lite", "gemini-3.1-pro-preview", "gemini-3.1-flash-lite-preview", "gemini-3-flash-preview"];
     readonly bedrock: readonly ["us.anthropic.claude-haiku-4-5-20251001-v1:0", "eu.anthropic.claude-haiku-4-5-20251001-v1:0", "apac.anthropic.claude-haiku-4-5-20251001-v1:0", "global.anthropic.claude-haiku-4-5-20251001-v1:0", "us.anthropic.claude-sonnet-4-6", "eu.anthropic.claude-sonnet-4-6", "apac.anthropic.claude-sonnet-4-6", "us.anthropic.claude-opus-4-7", "eu.anthropic.claude-opus-4-7", "apac.anthropic.claude-opus-4-7", "global.anthropic.claude-opus-4-7", "us.anthropic.claude-opus-4-6-v1"];
-    readonly openrouter: readonly ["anthropic/claude-haiku-4.5", "anthropic/claude-sonnet-4.6", "anthropic/claude-opus-4.7", "openai/gpt-5.5", "openai/gpt-5.5-pro", "openai/gpt-5.4-mini", "openai/gpt-5.4-nano", "google/gemini-3.5-flash", "google/gemini-3.1-pro-preview", "google/gemini-3.1-flash-lite", "x-ai/grok-4.3", "meta-llama/llama-4-maverick", "meta-llama/llama-3.3-70b-instruct", "deepseek/deepseek-v4-pro", "deepseek/deepseek-r1-0528", "qwen/qwen3.7-max", "qwen/qwen3-coder", "mistralai/mistral-large-2512", "openai/gpt-oss-120b"];
+    readonly openrouter: readonly ["anthropic/claude-fable-5", "anthropic/claude-opus-5", "anthropic/claude-sonnet-5", "anthropic/claude-haiku-4.5", "anthropic/claude-sonnet-4.6", "anthropic/claude-opus-4.7", "openai/gpt-5.6-sol", "openai/gpt-5.6-terra", "openai/gpt-5.6-luna", "openai/gpt-5.5", "openai/gpt-5.5-pro", "openai/gpt-5.4-mini", "openai/gpt-5.4-nano", "google/gemini-3.6-flash", "google/gemini-3.5-flash", "google/gemini-3.5-flash-lite", "google/gemini-3.1-pro-preview", "google/gemini-3.1-flash-lite", "x-ai/grok-4.3", "meta-llama/llama-4-maverick", "meta-llama/llama-3.3-70b-instruct", "deepseek/deepseek-v4-pro", "deepseek/deepseek-r1-0528", "qwen/qwen3.7-max", "qwen/qwen3-coder", "mistralai/mistral-large-2512", "openai/gpt-oss-120b"];
 };
 /**
  * Every supported LLM provider. Adding a new provider = add a key to

package/dist/types/llm-route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-route.d.ts","sourceRoot":"","sources":["../../src/types/llm-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,MAAM;;;;;;CA2GT,CAAC;AAMX;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,MAAM,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,SAC1C,YAAY,GACZ,SAAS,GACT,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GAC/B,YAAY,CAAC,CAAC,CAAC,CAAC;AAEpB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,QAAQ,GAAG;KACpB,CAAC,IAAI,WAAW,GAAG;QAAE,QAAQ,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE;CACvD,CAAC,WAAW,CAAC,CAAC;AAMf;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,WAAW,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAChD,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAE1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CASxE;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQjE;AA8CD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAgB7D;AAuBD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAKvD;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAE3D"}
+{"version":3,"file":"llm-route.d.ts","sourceRoot":"","sources":["../../src/types/llm-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,MAAM;;;;;;CAiIT,CAAC;AAMX;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,MAAM,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,SAC1C,YAAY,GACZ,SAAS,GACT,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GAC/B,YAAY,CAAC,CAAC,CAAC,CAAC;AAEpB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,QAAQ,GAAG;KACpB,CAAC,IAAI,WAAW,GAAG;QAAE,QAAQ,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE;CACvD,CAAC,WAAW,CAAC,CAAC;AAMf;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,WAAW,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAChD,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAE1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CASxE;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQjE;AA8CD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAgB7D;AAuBD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAKvD;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAE3D"}

package/dist/types/llm-route.js

@@ -57,8 +57,12 @@ export const MODELS = {
     anthropic: [
         // Wire-canonical IDs accepted by api.anthropic.com/v1/messages.
         // Per Anthropic's official models doc (claude.com/docs/about-claude/models/overview):
-        // 4.6/4.7 generation dropped the date suffix in the wire ID;
-        // Haiku 4.5 still uses the dated form.
+        // the Claude 5 family (2026-07: Opus 5, Sonnet 5, and the
+        // Mythos-class Fable 5) and the 4.6/4.7 generation carry undated
+        // wire IDs; Haiku 4.5 still uses the dated form.
+        'claude-fable-5',
+        'claude-opus-5',
+        'claude-sonnet-5',
         'claude-haiku-4-5-20251001',
         'claude-sonnet-4-6',
         'claude-opus-4-7',
@@ -68,6 +72,14 @@ export const MODELS = {
         // Per OpenAI's model registry (developers.openai.com/api/docs/models/all).
         // Both unversioned aliases AND dated snapshots are valid wire IDs;
         // we enumerate both because operators reasonably use either.
+        // GPT-5.6 family (2026-07): named-suffix tiers — `sol` (deepest
+        // reasoning), `terra` (balanced), `luna` (fast/cost). The bare
+        // `gpt-5.6` alias routes to Sol on OpenAI's side. No dated
+        // siblings registered at adoption time.
+        'gpt-5.6',
+        'gpt-5.6-sol',
+        'gpt-5.6-terra',
+        'gpt-5.6-luna',
         'gpt-5.5',
         'gpt-5.5-2026-04-23',
         'gpt-5.5-pro',
@@ -85,7 +97,9 @@ export const MODELS = {
         // Stable + the commonly-used previews. The `-preview` suffix is
         // load-bearing on the wire for preview models — Gemini's API
         // rejects the bare name for those.
+        'gemini-3.6-flash',
         'gemini-3.5-flash',
+        'gemini-3.5-flash-lite',
         'gemini-flash-latest',
         'gemini-3.1-flash-lite',
         'gemini-3.1-pro-preview',
@@ -131,16 +145,24 @@ export const MODELS = {
         // for Anthropic version (`claude-haiku-4.5`) where Anthropic direct
         // uses dash (`claude-haiku-4-5`) — preserve OpenRouter's wire form.
         // Anthropic family
+        'anthropic/claude-fable-5',
+        'anthropic/claude-opus-5',
+        'anthropic/claude-sonnet-5',
         'anthropic/claude-haiku-4.5',
         'anthropic/claude-sonnet-4.6',
         'anthropic/claude-opus-4.7',
         // OpenAI family
+        'openai/gpt-5.6-sol',
+        'openai/gpt-5.6-terra',
+        'openai/gpt-5.6-luna',
         'openai/gpt-5.5',
         'openai/gpt-5.5-pro',
         'openai/gpt-5.4-mini',
         'openai/gpt-5.4-nano',
         // Google family
+        'google/gemini-3.6-flash',
         'google/gemini-3.5-flash',
+        'google/gemini-3.5-flash-lite',
         'google/gemini-3.1-pro-preview',
         'google/gemini-3.1-flash-lite',
         // Frontier alternatives