@ggui-ai/protocol 0.11.0 → 0.12.0

package/dist/gadgets/stdlib-gadgets.d.ts

@@ -12,7 +12,7 @@ export declare const STDLIB_GADGETS_PACKAGE = "@ggui-ai/gadgets";
  * in `@ggui-ai/gadgets` asserts the two stay in sync, so a release-time
  * bump to the runtime package without updating this constant fails CI.
  */
-export declare const STDLIB_GADGETS_VERSION = "0.11.0";
+export declare const STDLIB_GADGETS_VERSION = "0.12.0";
 /**
  * v1 catalog of stdlib gadget descriptors. Every entry's
  * `package` defaults to {@link STDLIB_GADGETS_PACKAGE}; the

package/dist/gadgets/stdlib-gadgets.js

@@ -39,7 +39,7 @@ export const STDLIB_GADGETS_PACKAGE = '@ggui-ai/gadgets';
  * in `@ggui-ai/gadgets` asserts the two stay in sync, so a release-time
  * bump to the runtime package without updating this constant fails CI.
  */
-export const STDLIB_GADGETS_VERSION = '0.11.0';
+export const STDLIB_GADGETS_VERSION = '0.12.0';
 /**
  * v1 catalog of stdlib gadget descriptors. Every entry's
  * `package` defaults to {@link STDLIB_GADGETS_PACKAGE}; the

package/dist/integrations/theme-binding.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Theme-binding resolution — THE one normative total order for the
+ * `ai.ggui/render` slice's `themeId` / `themeMode` facts, and the two
+ * projections of it that run on either side of the wire (ggui#598
+ * leg 4; one-projection doctrine per MCP Apps Compliance).
+ *
+ * ## The normative total order
+ *
+ * ```
+ * themeMode:  consolePick  >  staticConfig  >  sessionSidecar  >  hostAnnounced
+ * themeId:    consolePick  >  renderOverride  >  staticConfig  >  sidecarName
+ * ```
+ *
+ * - `consolePick`    — the live operator pick (console theme provider).
+ * - `renderOverride` — the agent's per-render `ggui_render({ themeId })`.
+ * - `staticConfig`   — the app's static `ggui.json#theme` deps.
+ * - `sessionSidecar` — the per-app `App.theme` sidecar snapshotted at
+ *   render-commit: its `mode` (for `themeMode`) / its `name` (for
+ *   `themeId`, the registered-theme base-ladder binding).
+ * - `hostAnnounced`  — the embedding host's `hostContext.theme`
+ *   (mode only; hosts announce no theme id).
+ *
+ * An unresolved fact is `undefined` — NEVER defaulted to `'light'`.
+ * Absence is load-bearing: it is the signal that lets the next layer
+ * down (ultimately the host) fill the fact (ggui#551).
+ *
+ * ## The two projections and the composition law
+ *
+ * The server cannot see `hostAnnounced`; the client cannot see the
+ * server-only layers except through the stamp. So the order ships as
+ * two projections:
+ *
+ * - {@link stampThemeMode} / {@link stampThemeId} — the SERVER
+ *   projection: folds the server-visible layers into the stamped
+ *   top-level slice field.
+ * - {@link effectiveThemeMode} / {@link effectiveThemeId} — the
+ *   CLIENT projection: stamped field first, then the layers the client
+ *   can see directly.
+ *
+ * **Composition law (pinned by the test suite for every input
+ * combination):** `effective(stamp(server-layers), client-layers)`
+ * MUST equal the normative total order applied to all layers at once.
+ * The law is what makes cross-side precedence drift structurally
+ * impossible — before this module the two sides ranked the sidecar at
+ * different local positions and coherence silently depended on every
+ * transport threading every layer (the ggui#595 RCA's "two resolvers,
+ * two ranks" finding).
+ *
+ * The client's direct `sessionSidecar` leg is NOT redundant with the
+ * stamp: a transport that fails to thread the sidecar server-side
+ * (e.g. an envelope minted outside the render path) still resolves the
+ * sidecar at the correct rank client-side, because the law holds
+ * per-projection, not per-thread.
+ *
+ * Pure functions, no I/O — safe for both the node server and the
+ * browser runtime bundle.
+ */
+/** A resolved color-scheme opinion. Absent = no opinion (never 'light'). */
+export type ThemeModeOpinion = 'light' | 'dark';
+/** Server-visible `themeMode` layers, highest rank first. */
+export interface ThemeModeStampSources {
+    /** Live operator pick (console theme provider) — highest rank. */
+    readonly consolePick?: ThemeModeOpinion | undefined;
+    /** Static `ggui.json#theme` deps. */
+    readonly staticConfig?: ThemeModeOpinion | undefined;
+    /** The session theme sidecar's own `mode` — lowest server rank. */
+    readonly sessionSidecar?: ThemeModeOpinion | undefined;
+}
+/** Client-visible `themeMode` layers, highest rank first. */
+export interface ThemeModeEffectiveSources {
+    /** The slice's stamped top-level `themeMode` (the server projection's output). */
+    readonly stamped?: ThemeModeOpinion | undefined;
+    /** The slice theme OBJECT's own `mode` (the sidecar, read directly). */
+    readonly sessionSidecar?: ThemeModeOpinion | undefined;
+    /** The embedding host's `hostContext.theme` announce — final fallback. */
+    readonly hostAnnounced?: ThemeModeOpinion | undefined;
+}
+/** Server projection of the `themeMode` total order → the stamped field. */
+export declare function stampThemeMode(s: ThemeModeStampSources): ThemeModeOpinion | undefined;
+/** Client projection of the `themeMode` total order → the effective mode. */
+export declare function effectiveThemeMode(s: ThemeModeEffectiveSources): ThemeModeOpinion | undefined;
+/** Server-visible `themeId` layers, highest rank first. */
+export interface ThemeIdStampSources {
+    /** Live operator pick (console theme provider) — highest rank. */
+    readonly consolePick?: string | undefined;
+    /** The agent's per-render `ggui_render({ themeId })` override. */
+    readonly renderOverride?: string | undefined;
+    /** Static `ggui.json#theme` deps. */
+    readonly staticConfig?: string | undefined;
+}
+/** Client-visible `themeId` layers, highest rank first. */
+export interface ThemeIdEffectiveSources {
+    /** The slice's stamped top-level `themeId`. */
+    readonly stamped?: string | undefined;
+    /**
+     * The slice theme OBJECT's `name` — the registered-theme base-ladder
+     * binding (ggui#589 ask 3): an unregistered name is harmless by
+     * construction (renderer falls back to the default ladder).
+     */
+    readonly sidecarName?: string | undefined;
+}
+/** Server projection of the `themeId` total order → the stamped field. */
+export declare function stampThemeId(s: ThemeIdStampSources): string | undefined;
+/** Client projection of the `themeId` total order → the effective id. */
+export declare function effectiveThemeId(s: ThemeIdEffectiveSources): string | undefined;
+//# sourceMappingURL=theme-binding.d.ts.map

package/dist/integrations/theme-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-binding.d.ts","sourceRoot":"","sources":["../../src/integrations/theme-binding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhD,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpD,qCAAqC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrD,mEAAmE;IACnE,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACxD;AAED,6DAA6D;AAC7D,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAChD,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACvD,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACvD;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAC5B,CAAC,EAAE,qBAAqB,GACvB,gBAAgB,GAAG,SAAS,CAE9B;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,yBAAyB,GAC3B,gBAAgB,GAAG,SAAS,CAE9B;AAED,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,qCAAqC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,2DAA2D;AAC3D,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,uBAAuB,GAAG,MAAM,GAAG,SAAS,CAE/E"}

package/dist/integrations/theme-binding.js

@@ -0,0 +1,73 @@
+/**
+ * Theme-binding resolution — THE one normative total order for the
+ * `ai.ggui/render` slice's `themeId` / `themeMode` facts, and the two
+ * projections of it that run on either side of the wire (ggui#598
+ * leg 4; one-projection doctrine per MCP Apps Compliance).
+ *
+ * ## The normative total order
+ *
+ * ```
+ * themeMode:  consolePick  >  staticConfig  >  sessionSidecar  >  hostAnnounced
+ * themeId:    consolePick  >  renderOverride  >  staticConfig  >  sidecarName
+ * ```
+ *
+ * - `consolePick`    — the live operator pick (console theme provider).
+ * - `renderOverride` — the agent's per-render `ggui_render({ themeId })`.
+ * - `staticConfig`   — the app's static `ggui.json#theme` deps.
+ * - `sessionSidecar` — the per-app `App.theme` sidecar snapshotted at
+ *   render-commit: its `mode` (for `themeMode`) / its `name` (for
+ *   `themeId`, the registered-theme base-ladder binding).
+ * - `hostAnnounced`  — the embedding host's `hostContext.theme`
+ *   (mode only; hosts announce no theme id).
+ *
+ * An unresolved fact is `undefined` — NEVER defaulted to `'light'`.
+ * Absence is load-bearing: it is the signal that lets the next layer
+ * down (ultimately the host) fill the fact (ggui#551).
+ *
+ * ## The two projections and the composition law
+ *
+ * The server cannot see `hostAnnounced`; the client cannot see the
+ * server-only layers except through the stamp. So the order ships as
+ * two projections:
+ *
+ * - {@link stampThemeMode} / {@link stampThemeId} — the SERVER
+ *   projection: folds the server-visible layers into the stamped
+ *   top-level slice field.
+ * - {@link effectiveThemeMode} / {@link effectiveThemeId} — the
+ *   CLIENT projection: stamped field first, then the layers the client
+ *   can see directly.
+ *
+ * **Composition law (pinned by the test suite for every input
+ * combination):** `effective(stamp(server-layers), client-layers)`
+ * MUST equal the normative total order applied to all layers at once.
+ * The law is what makes cross-side precedence drift structurally
+ * impossible — before this module the two sides ranked the sidecar at
+ * different local positions and coherence silently depended on every
+ * transport threading every layer (the ggui#595 RCA's "two resolvers,
+ * two ranks" finding).
+ *
+ * The client's direct `sessionSidecar` leg is NOT redundant with the
+ * stamp: a transport that fails to thread the sidecar server-side
+ * (e.g. an envelope minted outside the render path) still resolves the
+ * sidecar at the correct rank client-side, because the law holds
+ * per-projection, not per-thread.
+ *
+ * Pure functions, no I/O — safe for both the node server and the
+ * browser runtime bundle.
+ */
+/** Server projection of the `themeMode` total order → the stamped field. */
+export function stampThemeMode(s) {
+    return s.consolePick ?? s.staticConfig ?? s.sessionSidecar;
+}
+/** Client projection of the `themeMode` total order → the effective mode. */
+export function effectiveThemeMode(s) {
+    return s.stamped ?? s.sessionSidecar ?? s.hostAnnounced;
+}
+/** Server projection of the `themeId` total order → the stamped field. */
+export function stampThemeId(s) {
+    return s.consolePick ?? s.renderOverride ?? s.staticConfig;
+}
+/** Client projection of the `themeId` total order → the effective id. */
+export function effectiveThemeId(s) {
+    return s.stamped ?? s.sidecarName;
+}

package/dist/schemas/app-theme.d.ts

@@ -33,6 +33,11 @@ export declare const appThemeSchema: z.ZodObject<{
     }>;
     cssVariables: z.ZodRecord<z.ZodString, z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
+    base: z.ZodOptional<z.ZodObject<{
+        documentHash: z.ZodString;
+        light: z.ZodRecord<z.ZodString, z.ZodString>;
+        dark: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export type AppTheme = z.infer<typeof appThemeSchema>;
 //# sourceMappingURL=app-theme.d.ts.map

package/dist/schemas/app-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-theme.d.ts","sourceRoot":"","sources":["../../src/schemas/app-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,QAA2B,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAShD,eAAO,MAAM,cAAc;;;;;;;kBAQhB,CAAC;AAEZ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"app-theme.d.ts","sourceRoot":"","sources":["../../src/schemas/app-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,QAA2B,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAahD,eAAO,MAAM,cAAc;;;;;;;;;;;;kBA2BhB,CAAC;AAEZ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/schemas/app-theme.js

@@ -32,12 +32,34 @@ const cssValue = z
     .max(256)
     .regex(CSS_VALUE_SAFE_RE, 'css value contains a disallowed character')
     .refine((v) => !v.includes('/*'), 'css value may not contain a comment');
+const cssVariableMap = z
+    .record(z.string().regex(GGUI_CSS_VAR_KEY_RE, 'css var key must be --ggui-*'), cssValue)
+    .refine((m) => Object.keys(m).length <= 200, 'too many css variables (max 200)');
 export const appThemeSchema = z
     .object({
     mode: z.enum(['light', 'dark']),
-    cssVariables: z
-        .record(z.string().regex(GGUI_CSS_VAR_KEY_RE, 'css var key must be --ggui-*'), cssValue)
-        .refine((m) => Object.keys(m).length <= 200, 'too many css variables (max 200)'),
+    cssVariables: cssVariableMap,
     name: z.string().min(1).max(64).optional(),
+    /**
+     * The REGISTERED base ladder, delivered (runtime theme
+     * registration): both modes' resolved variable sets ride the
+     * envelope so a mid-session mode switch is a local operation and
+     * delivery never depends on the iframe being able to fetch. The
+     * renderer injects the mode-selected set BELOW `cssVariables` (the
+     * per-app overlay) in the documented precedence. `documentHash` is
+     * the registration's identity: it joins painted ladders to
+     * registration records, and a receiver holding the hash may be
+     * served a future envelope without the variable sets.
+     */
+    base: z
+        .object({
+        documentHash: z
+            .string()
+            .regex(/^[0-9a-f]{64}$/, 'documentHash must be sha256 lowercase hex'),
+        light: cssVariableMap,
+        dark: cssVariableMap,
+    })
+        .strict()
+        .optional(),
 })
     .strict();

package/dist/schemas/mcp.d.ts

@@ -578,6 +578,8 @@ export declare const updateOutputSchema: z.ZodObject<{
     resourceUri: z.ZodString;
     epoch: z.ZodNumber;
     warning: z.ZodOptional<z.ZodString>;
+    propsSchemaHash: z.ZodOptional<z.ZodString>;
+    propsSchemaProfile: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * `ggui_amend` wire output (#483) — acknowledgement only. `resourceUri`
@@ -591,6 +593,8 @@ export declare const amendOutputSchema: z.ZodObject<{
     updated: z.ZodBoolean;
     resourceUri: z.ZodString;
     warning: z.ZodOptional<z.ZodString>;
+    propsSchemaHash: z.ZodOptional<z.ZodString>;
+    propsSchemaProfile: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * `ggui_runtime_declare_tool_catalog` — the host runtime declares its

package/dist/schemas/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/schemas/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,cAAc;;;iBAGzB,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUnB,CAAC;AAYjB;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;CAgBpB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;iBAA8B,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;iBAA2B,CAAC;AAExD,eAAO,MAAM,oBAAoB;;CAKvB,CAAC;AAEX,eAAO,MAAM,qBAAqB;;iBAAiC,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;;CAK5B,CAAC;AAEX,eAAO,MAAM,0BAA0B;;iBAAsC,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,IAAc,CAAC;AAE5D,eAAO,MAAM,iCAAiC,gCAE7C,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;CAwB7B,CAAC;AAEX,eAAO,MAAM,2BAA2B;;;;;iBAAuC,CAAC;AAEhF,eAAO,MAAM,yBAAyB;;CAO5B,CAAC;AAEX,eAAO,MAAM,0BAA0B;;iBAAsC,CAAC;AAE9E,eAAO,MAAM,kBAAkB,IAAc,CAAC;AAE9C,eAAO,MAAM,mBAAmB,gCAA+B,CAAC;AAahE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,oBAAoB;;;;kBA0BtB,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;iBAgChC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,gBAAgB;;IAO3B;;;;;;;;OAQG;;IAEH;;;;;OAKG;;IAQH;;;;;;;;;;OAUG;;;;IAaH;;;;;;;;;;;OAWG;;;;;CAuBK,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAA6B,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;iBAyBlC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,qBAAqB;;;;;;EAMhC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;iBAS5B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,2BAA2B;;;;;EAKtC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;iBAalC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6E7B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;4BAa5B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;4BAa3B,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB;;;;;;iBAgC7B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;iBAM5B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,6BAA6B;;;;;kBAW/B,CAAC;AAEZ,eAAO,MAAM,8BAA8B;;;kBAKhC,CAAC;AAIZ;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAsBjC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,qBAAqB;;;;;CA8BxB,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;iBAAkC,CAAC;AAEtE;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;iBAItC,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;mBAGlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,0BAA0B;;;;;;;CA+B7B,CAAC;AAEX,eAAO,MAAM,2BAA2B;;;;;;;iBAAuC,CAAC;AAEhF,8DAA8D;AAC9D,eAAO,MAAM,4BAA4B;;iBAAoC,CAAC"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/schemas/mcp.ts"],"names":[],"mappings":"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"}

package/dist/schemas/mcp.js

@@ -699,6 +699,17 @@ export const updateOutputSchema = z.object({
      * its feedback channel.
      */
     warning: z.string().optional(),
+    /**
+     * Schema attestation (ggui#560): identity hash of the enforced props
+     * schema this mutation was validated against — the same schema the
+     * paired handshake disclosed. Present when the session declares a
+     * `propsSpec`; equal to the handshake's `propsSchemaHash` under the
+     * session-continuity guarantee, so a mismatch is the observable form
+     * of a contract changing mid-session.
+     */
+    propsSchemaHash: z.string().optional(),
+    /** Present with `propsSchemaHash`; same profile classifier as the handshake's. */
+    propsSchemaProfile: z.string().optional(),
 });
 /**
  * `ggui_amend` wire output (#483) — acknowledgement only. `resourceUri`
@@ -713,6 +724,10 @@ export const amendOutputSchema = z.object({
     resourceUri: z.string(),
     /** Same no-op feedback channel as ggui_update's `warning`. */
     warning: z.string().optional(),
+    /** Schema attestation (ggui#560) — same semantics as ggui_update's. */
+    propsSchemaHash: z.string().optional(),
+    /** Present with `propsSchemaHash`. */
+    propsSchemaProfile: z.string().optional(),
 });
 /**
  * `ggui_runtime_declare_tool_catalog` — the host runtime declares its

package/dist/validation/enforced-props-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enforced-props-schema.d.ts","sourceRoot":"","sources":["../../src/validation/enforced-props-schema.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAIvE,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,MAAM,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAcpD,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAWnD,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEpE;AAuED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAIpE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,UAAU,GACjB,kBAAkB,CAiCpB"}
+{"version":3,"file":"enforced-props-schema.d.ts","sourceRoot":"","sources":["../../src/validation/enforced-props-schema.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAIvE,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,MAAM,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAcpD,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAWnD,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEpE;AAuFD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAIpE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,UAAU,GACjB,kBAAkB,CAiCpB"}

package/dist/validation/enforced-props-schema.js

@@ -151,6 +151,22 @@ function canonicalizeSchemaNode(node) {
                 continue;
             }
         }
+        if (key === 'required' && Array.isArray(node.required)) {
+            // `required` is SET-semantics in JSON Schema — member order never
+            // affects validation — but it is an ARRAY on the wire, and JCS
+            // rightly preserves array order while sorting only object keys.
+            // The wrapper's `required` is derived from properties ITERATION
+            // order, an order-unstable source (a DynamoDB Map round-trip
+            // legally reorders object keys), so without this sort one
+            // contract stored under two representations rebuilt to two
+            // different propsSchemaHashes (production incident 2026-08-20:
+            // ca204076… vs d130e5b9… for the same Deskly contract). Sorting
+            // here — for derived AND authored arrays at every depth — makes
+            // the canonical bytes (and therefore the hash) canonical over the
+            // keyword's actual semantics.
+            out.required = [...node.required].sort();
+            continue;
+        }
         out[key] = value;
     }
     return out;

package/dist/version.d.ts

@@ -3074,6 +3074,23 @@
  *      sample).
  */
 export declare const PROTOCOL_VERSION = "draft-2026-08-19";
+/**
+ * The shipped `@ggui-ai/*` WAVE version — bare semver, identical to
+ * `package.json#version` on every published package (the lockstep
+ * cohort; `@ggui-ai/protocol` is its anchor). Distinct from
+ * {@link PROTOCOL_VERSION}: that names the WIRE draft (what the
+ * messages mean), this names the SHIPPED BUILD (which release an agent
+ * is actually talking to). Runtime surfaces that identify themselves
+ * — MCP `serverInfo.version`, the MCP Apps `appInfo.version` — report
+ * this, never a hand-typed literal (ggui#622: a hard-coded `0.0.1`
+ * told every connected agent the wrong thing for four waves).
+ *
+ * Moves with every wave: `version.test.ts` pins it to this package's
+ * `package.json#version` (the same parity pattern as
+ * `STDLIB_GADGETS_VERSION` and `agent-server`'s `CLIENT_INFO`), and the
+ * `/release:cut` straggler list names it so the bump is mechanical.
+ */
+export declare const GGUI_WAVE_VERSION = "0.12.0";
 /**
  * Schema version stamped onto wire envelopes that opt into the
  * `schemaVersion` forward-compat field (see {@link ActionEnvelope},

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkgGG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,uBAAuB,qBAAmB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAErD,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkgGG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,uBAAuB,qBAAmB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAErD,CAAC"}

package/dist/version.js

@@ -3074,6 +3074,23 @@
  *      sample).
  */
 export const PROTOCOL_VERSION = "draft-2026-08-19";
+/**
+ * The shipped `@ggui-ai/*` WAVE version — bare semver, identical to
+ * `package.json#version` on every published package (the lockstep
+ * cohort; `@ggui-ai/protocol` is its anchor). Distinct from
+ * {@link PROTOCOL_VERSION}: that names the WIRE draft (what the
+ * messages mean), this names the SHIPPED BUILD (which release an agent
+ * is actually talking to). Runtime surfaces that identify themselves
+ * — MCP `serverInfo.version`, the MCP Apps `appInfo.version` — report
+ * this, never a hand-typed literal (ggui#622: a hard-coded `0.0.1`
+ * told every connected agent the wrong thing for four waves).
+ *
+ * Moves with every wave: `version.test.ts` pins it to this package's
+ * `package.json#version` (the same parity pattern as
+ * `STDLIB_GADGETS_VERSION` and `agent-server`'s `CLIENT_INFO`), and the
+ * `/release:cut` straggler list names it so the bump is mechanical.
+ */
+export const GGUI_WAVE_VERSION = "0.12.0";
 /**
  * Schema version stamped onto wire envelopes that opt into the
  * `schemaVersion` forward-compat field (see {@link ActionEnvelope},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/protocol",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "ggui protocol types — events, renders, WebSocket, MCP, LLM models",
   "license": "Apache-2.0",
   "keywords": [
@@ -68,6 +68,12 @@
       "require": "./dist/integrations/mcp-apps.js",
       "default": "./dist/integrations/mcp-apps.js"
     },
+    "./integrations/theme-binding": {
+      "types": "./dist/integrations/theme-binding.d.ts",
+      "import": "./dist/integrations/theme-binding.js",
+      "require": "./dist/integrations/theme-binding.js",
+      "default": "./dist/integrations/theme-binding.js"
+    },
     "./version": {
       "types": "./dist/version.d.ts",
       "import": "./dist/version.js",