@ggui-ai/protocol 0.1.0-rc.1 → 0.2.0-alpha.1

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,UAAU,EACV,UAAU,EACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAK5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA+B9D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,gBAAgB,GAEhB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,gBAAgB;CAC3E,CAAC;AAMF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,UAAU;IACzB;kEAC8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;iBACa;IACb,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;KAChC,CAAC;IACF;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B;mCAC+B;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,MAAM,CAAC,MAAM,GAAG,UAAU,IAClC,eAAe,CAAC,MAAM,CAAC,GACvB,YAAY,GACZ,aAAa,CAAC;AAElB;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,UAAU,CAAE,SAAQ,UAAU;IACtE,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;qFACiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;qDACiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;gCAC4B;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC;IAC9C,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;qCACiC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC;+BAC2B;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B;+BAC2B;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC;mDAC+C;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,sBAAsB,CAAC;IACrD;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACzD;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,SAAS,UAAU,GAAG,UAAU,CAClE,SAAQ,UAAU;IAClB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAAC,SAAS,GAAG,UAAU;IACtD,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EACA,QAAQ,GACR,aAAa,GACb,UAAU,GACV,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,UAAU,GACV,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/ui-generator.d.ts

@@ -1,4 +1,3 @@
-import type { EventSubscription } from './events';
 import type { DataContract, JsonObject, JsonSchema, JsonValue } from './data-contract';
 /**
  * Design system version — used as part of the cache fingerprint.
@@ -46,22 +45,22 @@ export declare function computeStyleFingerprint(input: StyleFingerprintInput): s
  * Generic `TContext` defaults to {@link JsonObject} for generator context hints.
  */
 export interface UIGenerationRequest<TContext = JsonObject> {
-    sessionId: string;
+    renderId: string;
     prompt: string;
     context?: TContext;
     schema?: JsonSchema;
-    subscription?: EventSubscription;
 }
 /**
  * Internal response from UI generation. This is the GENERATOR-OUTPUT
  * shape — `componentCode` is the freshly produced ESM string. Before
- * the stack item commits to the wire, the bootstrap-meta derivation
+ * the render commits to the wire, the slice-meta derivation
  * uploads the code body and projects `codeUrl` (a fetchable URL) onto
- * `_meta.ggui.bootstrap` instead of inlining the source. Iframe
- * runtimes fetch the code from `codeUrl`; they never see this field.
+ * the `ai.ggui/render` slice instead of inlining the source.
+ * Iframe runtimes fetch the code from `codeUrl`; they never see this
+ * field.
  */
 export interface UIGenerationResponse {
-    stackItemId: string;
+    renderId: string;
     componentCode: string;
     sourceCode?: string;
     warnings?: string[];
@@ -71,8 +70,8 @@ export interface UIGenerationResponse {
      * Populated by the generator when the component calls wire hooks
      * (`useAction('name')`, `useStream('channel')`) — the generator
      * extracts the call sites and emits a matching authoring-side
-     * envelope so downstream consumers (`ggui_push` → StackItem, console
-     * inspectors, session-channel router) have the contract available.
+     * envelope so downstream consumers (`ggui_render` → Render, console
+     * inspectors, render-channel router) have the contract available.
      *
      * - When the caller supplied `UiGenerateInput.contract` that
      *   envelope is passed through as-is (already authoritative).

package/dist/types/ui-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-generator.d.ts","sourceRoot":"","sources":["../../src/types/ui-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAuBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAO5E;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,QAAQ,GAAG,UAAU;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB"}
+{"version":3,"file":"ui-generator.d.ts","sourceRoot":"","sources":["../../src/types/ui-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAuBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAO5E;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,QAAQ,GAAG,UAAU;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB"}

package/dist/validation/contract-validator.d.ts

@@ -167,7 +167,7 @@ export declare function validateActionEnvelope(envelope: ActionEnvelope, spec: A
  * Compile a contract's runtime-validated sub-schemas into standalone,
  * eval-free ESM validator modules — the producer half of the
  * precompiled-validator channel
- * ({@link CompiledContractValidators} on `GguiBootstrapMeta`).
+ * ({@link CompiledContractValidators} on `McpAppAiGguiMeta`).
  *
  * The renderer iframe runs under a strict CSP with no `'unsafe-eval'`,
  * so it cannot call `ajv.compile()` (which builds validators via
@@ -189,7 +189,7 @@ export declare function validateActionEnvelope(envelope: ActionEnvelope, spec: A
  *     validates `value`.
  *
  * Returns `undefined` when the contract declares no runtime-validated
- * schema at all — the bootstrap projection then omits the field.
+ * schema at all — the slice-meta projection then omits the field.
  */
 export declare function compileContractValidators(specs: {
     readonly propsSpec?: PropsSpec;
@@ -197,6 +197,62 @@ export declare function compileContractValidators(specs: {
     readonly streamSpec?: StreamSpec;
     readonly contextSpec?: ContextSpec;
 }): CompiledContractValidators | undefined;
+/**
+ * Wrap a {@link CompiledContractValidators} object as the source text of
+ * an ES module whose `default` export is the same object. This is the
+ * wire format served from the content-addressable contract route
+ * (`GET /contract/<hash>.js`) in #109's decomposition slice — one URL,
+ * one fetch, one dynamic-import per unique contract.
+ *
+ * Why a wrapping module rather than emitting the validator-modules
+ * raw: each inner validator-module is independently `export default ...`,
+ * so they can't share a single file without name collisions. The
+ * iframe-runtime's existing `loadCompiledValidators` already knows how
+ * to take a `CompiledContractValidators` and load each inner module via
+ * `blob:` import; this wrapper just hands it the same shape it expects,
+ * sourced from one HTTP round-trip instead of inline.
+ *
+ * `JSON.stringify` is deterministic on objects with string keys in V8
+ * + Node — the producer's iteration order is preserved, so a given
+ * contract always serializes to identical bytes. {@link computeContractBundle}
+ * leans on that determinism so the resulting hash is stable across
+ * pushes of the same contract.
+ *
+ * @public
+ */
+export declare function bundleCompiledValidatorsAsModule(compiled: CompiledContractValidators): string;
+/**
+ * Convenience over {@link compileContractValidators} +
+ * {@link bundleCompiledValidatorsAsModule} + sha256 — produces the
+ * `{contractHash, bundleSource, validators}` triple the emitter (push.ts
+ * / update.ts in #109 C4) writes to the content-addressable store and
+ * emits as `_meta["ai.ggui/contract"] = {contractHash, validatorsUrl}`.
+ *
+ * `contractHash` is `sha256(canonicalJsonStringify(specs))` (hex). Hashing
+ * the INPUT specs — not the compiled output — guarantees a stable hash
+ * across server processes and Ajv version bumps: the same contract
+ * definition always lands at the same URL. Compiled output bytes may
+ * differ across calls (Ajv's standalone emitter uses incrementing
+ * counter names like `validate10`/`validate11`), but the CodeStore is
+ * idempotent (first write wins) and the URL response carries
+ * `Cache-Control: immutable`, so browsers + CDNs lock in the
+ * first-served bytes and never observe a counter-name reshuffle.
+ *
+ * Returns `undefined` when the contract declares no runtime-validated
+ * schema at all (matches {@link compileContractValidators}'s posture).
+ *
+ * @public
+ */
+export declare function computeContractBundle(specs: {
+    readonly propsSpec?: PropsSpec;
+    readonly actionSpec?: ActionSpec;
+    readonly streamSpec?: StreamSpec;
+    readonly contextSpec?: ContextSpec;
+}): Promise<{
+    readonly contractHash: string;
+    readonly bundleSource: string;
+    readonly validators: CompiledContractValidators;
+} | undefined>;
 /**
  * Format violations into a human-readable error message for the target agent.
  */
@@ -226,10 +282,10 @@ export declare function formatViolations(violations: ContractViolation[]): strin
 export declare function validateContractStructure(contract: DataContract): ValidationResult;
 export declare class ContractViolationError extends Error {
     readonly violations: ContractViolation[];
-    readonly tool: 'ggui_push' | 'ggui_update' | 'ggui_emit' | 'ggui_event';
+    readonly tool: 'ggui_render' | 'ggui_update' | 'ggui_emit' | 'ggui_event';
     readonly hint: string;
     constructor(opts: {
-        tool: 'ggui_push' | 'ggui_update' | 'ggui_emit' | 'ggui_event';
+        tool: 'ggui_render' | 'ggui_update' | 'ggui_emit' | 'ggui_event';
         violations: ContractViolation[];
         hint?: string;
     });

package/dist/validation/contract-validator.d.ts.map

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

package/dist/validation/contract-validator.js

@@ -294,7 +294,7 @@ export function validateActionEnvelope(envelope, spec, precompiledActions) {
  * Compile a contract's runtime-validated sub-schemas into standalone,
  * eval-free ESM validator modules — the producer half of the
  * precompiled-validator channel
- * ({@link CompiledContractValidators} on `GguiBootstrapMeta`).
+ * ({@link CompiledContractValidators} on `McpAppAiGguiMeta`).
  *
  * The renderer iframe runs under a strict CSP with no `'unsafe-eval'`,
  * so it cannot call `ajv.compile()` (which builds validators via
@@ -316,7 +316,7 @@ export function validateActionEnvelope(envelope, spec, precompiledActions) {
  *     validates `value`.
  *
  * Returns `undefined` when the contract declares no runtime-validated
- * schema at all — the bootstrap projection then omits the field.
+ * schema at all — the slice-meta projection then omits the field.
  */
 export function compileContractValidators(specs) {
     const compilePerEntry = (spec) => {
@@ -350,6 +350,102 @@ export function compileContractValidators(specs) {
         out.context = context;
     return Object.keys(out).length > 0 ? out : undefined;
 }
+/**
+ * Wrap a {@link CompiledContractValidators} object as the source text of
+ * an ES module whose `default` export is the same object. This is the
+ * wire format served from the content-addressable contract route
+ * (`GET /contract/<hash>.js`) in #109's decomposition slice — one URL,
+ * one fetch, one dynamic-import per unique contract.
+ *
+ * Why a wrapping module rather than emitting the validator-modules
+ * raw: each inner validator-module is independently `export default ...`,
+ * so they can't share a single file without name collisions. The
+ * iframe-runtime's existing `loadCompiledValidators` already knows how
+ * to take a `CompiledContractValidators` and load each inner module via
+ * `blob:` import; this wrapper just hands it the same shape it expects,
+ * sourced from one HTTP round-trip instead of inline.
+ *
+ * `JSON.stringify` is deterministic on objects with string keys in V8
+ * + Node — the producer's iteration order is preserved, so a given
+ * contract always serializes to identical bytes. {@link computeContractBundle}
+ * leans on that determinism so the resulting hash is stable across
+ * pushes of the same contract.
+ *
+ * @public
+ */
+export function bundleCompiledValidatorsAsModule(compiled) {
+    return `export default ${JSON.stringify(compiled)};\n`;
+}
+/**
+ * Recursive canonical-JSON serializer with object keys sorted
+ * lexicographically at every depth. Output is byte-stable across any
+ * two callers building the same logical contract via different key
+ * orders (e.g. `{a:1, b:2}` vs `{b:2, a:1}`) — so {@link computeContractBundle}'s
+ * hash is robust to spec-author hand-ordering.
+ *
+ * Arrays preserve element order (semantically meaningful in JSON
+ * Schema, e.g. `required: [a, b]` differs from `[b, a]` for some
+ * validators / error message ordering). Functions are not part of
+ * `DataContract` specs, so the type-`function` branch is unreachable
+ * in normal use and excluded.
+ */
+function canonicalJsonStringify(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return JSON.stringify(value);
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return `[${value.map(canonicalJsonStringify).join(',')}]`;
+    }
+    if (typeof value === 'object') {
+        const keys = Object.keys(value).sort();
+        const parts = keys.map((k) => `${JSON.stringify(k)}:${canonicalJsonStringify(value[k])}`);
+        return `{${parts.join(',')}}`;
+    }
+    // undefined / function — not valid inside DataContract specs.
+    return 'null';
+}
+/**
+ * Convenience over {@link compileContractValidators} +
+ * {@link bundleCompiledValidatorsAsModule} + sha256 — produces the
+ * `{contractHash, bundleSource, validators}` triple the emitter (push.ts
+ * / update.ts in #109 C4) writes to the content-addressable store and
+ * emits as `_meta["ai.ggui/contract"] = {contractHash, validatorsUrl}`.
+ *
+ * `contractHash` is `sha256(canonicalJsonStringify(specs))` (hex). Hashing
+ * the INPUT specs — not the compiled output — guarantees a stable hash
+ * across server processes and Ajv version bumps: the same contract
+ * definition always lands at the same URL. Compiled output bytes may
+ * differ across calls (Ajv's standalone emitter uses incrementing
+ * counter names like `validate10`/`validate11`), but the CodeStore is
+ * idempotent (first write wins) and the URL response carries
+ * `Cache-Control: immutable`, so browsers + CDNs lock in the
+ * first-served bytes and never observe a counter-name reshuffle.
+ *
+ * Returns `undefined` when the contract declares no runtime-validated
+ * schema at all (matches {@link compileContractValidators}'s posture).
+ *
+ * @public
+ */
+export async function computeContractBundle(specs) {
+    const validators = compileContractValidators(specs);
+    if (validators === undefined)
+        return undefined;
+    const bundleSource = bundleCompiledValidatorsAsModule(validators);
+    // Web Crypto's subtle.digest is universal (Node 19+, all modern
+    // browsers, Workers). The protocol package ships into iframe-runtime
+    // bundles too — `node:crypto` would force esbuild to mark a Node
+    // builtin unresolved at browser bundle time even though this
+    // function is server-only at call time.
+    const bytes = new TextEncoder().encode(canonicalJsonStringify(specs));
+    const digest = await globalThis.crypto.subtle.digest('SHA-256', bytes);
+    const contractHash = Array.from(new Uint8Array(digest))
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+    return { contractHash, bundleSource, validators };
+}
 /**
  * Format violations into a human-readable error message for the target agent.
  */
@@ -679,13 +775,13 @@ function validateSchemaStructure(schema, path, violations) {
  * Thrown by commit/update/stream handlers when agent data doesn't match
  * the negotiated contract. The MCP handler catches this and returns a
  * structured error response with violations + hint so the agent can
- * self-correct (fix data or propose a new contract via ggui_push).
+ * self-correct (fix data or propose a new contract via ggui_render).
  */
 function defaultHintFor(tool) {
     if (tool === 'ggui_event') {
-        return 'The user-action payload did not match the session\'s actionSpec. Re-check the client-side action wiring, or have the agent push a new UI whose actionSpec covers this payload shape.';
+        return 'The user-action payload did not match the render\'s actionSpec. Re-check the client-side action wiring, or have the agent render a new UI whose actionSpec covers this payload shape.';
     }
-    return 'Fix your data to match the contract, or call ggui_push to create a new UI for this data shape.';
+    return 'Fix your data to match the contract, or call ggui_render to create a new UI for this data shape.';
 }
 export class ContractViolationError extends Error {
     violations;

package/dist/validation/reserved-channels.d.ts

@@ -3,7 +3,7 @@ import type { ValidationResult } from './contract-validator';
 export declare const RESERVED_CHANNEL_PREFIX = "_ggui:";
 /**
  * Reserved channel for provisional A2UI assembly streams emitted by
- * the server during fresh-gen `ggui_push` flows. The agent never
+ * the server during fresh-gen `ggui_render` flows. The agent never
  * authors messages on this channel; the renderer subscribes implicitly
  * and dispatches the A2UI payload through its preview surface.
  */

package/dist/validation/reserved-channels.js

@@ -2,7 +2,7 @@
 export const RESERVED_CHANNEL_PREFIX = '_ggui:';
 /**
  * Reserved channel for provisional A2UI assembly streams emitted by
- * the server during fresh-gen `ggui_push` flows. The agent never
+ * the server during fresh-gen `ggui_render` flows. The agent never
  * authors messages on this channel; the renderer subscribes implicitly
  * and dispatches the A2UI payload through its preview surface.
  */
@@ -329,12 +329,12 @@ export function validateCanvasLifecyclePayload(payload) {
                 });
             }
             break;
-        case 'push_started':
-            requireString('stackItemId');
+        case 'render_started':
+            requireString('renderId');
             requireString('intent');
             break;
         case 'consume_polling':
-            requireString('stackItemId');
+            requireString('renderId');
             if (p.state !== 'open') {
                 violations.push({
                     field: 'state',
@@ -348,7 +348,7 @@ export function validateCanvasLifecyclePayload(payload) {
             violations.push({
                 field: 'kind',
                 message: `Unknown lifecycle kind '${p.kind}'. Closed union; new kinds bump protocol version.`,
-                expected: "'handshake_started' | 'handshake_completed' | 'push_started' | 'consume_polling'",
+                expected: "'handshake_started' | 'handshake_completed' | 'render_started' | 'consume_polling'",
                 received: p.kind,
             });
     }

package/dist/validation/sanitize-error.js

@@ -9,7 +9,7 @@
 // and env-var dumps. The envelope flows on the reserved
 // `_ggui:contract-error` channel with `replay: 'all'`, so anything that
 // lands in `causedBy` persists in the session ring buffer and is visible
-// in operator tools (SessionInspector activity panels). If an operator
+// in operator tools (RenderInspector activity panels). If an operator
 // shares a bug report with that data, the credential leaks externally.
 //
 // This module's default posture is "sanitize before emission": the

package/dist/validation/schema-compat-invariants.d.ts

@@ -18,7 +18,7 @@
  * `streamSpec[*].schema` vs `agentCapabilities.tools[*].inputSchema` /
  * `outputSchema`, all of which are author-declared JSON Schemas
  * already on the contract. No tool registry, no zod conversion, no
- * server state. The server-level F4 check (`checkStackItemSchemaCompat`
+ * server state. The server-level F4 check (`checkRenderSchemaCompat`
  * in `@ggui-ai/mcp-server`) compares the same `actionSpec` /
  * `streamSpec` schemas against the SERVER-REGISTERED tools' actual
  * zod schemas; it covers the operator-side "did the deployed tool
@@ -132,7 +132,7 @@ export declare class SchemaCompatInvariantError extends Error {
  *
  * Slots alongside `assertCrossReferences` + `assertNameInvariants`
  * at push time. Different scope from the server-level
- * `SchemaCompatError` thrown by `checkStackItemSchemaCompat` in
+ * `SchemaCompatError` thrown by `checkRenderSchemaCompat` in
  * `@ggui-ai/mcp-server`: this check uses ONLY the contract's own
  * catalog; the server-level check uses the runtime tool registry.
  */

package/dist/validation/schema-compat-invariants.js

@@ -18,7 +18,7 @@
  * `streamSpec[*].schema` vs `agentCapabilities.tools[*].inputSchema` /
  * `outputSchema`, all of which are author-declared JSON Schemas
  * already on the contract. No tool registry, no zod conversion, no
- * server state. The server-level F4 check (`checkStackItemSchemaCompat`
+ * server state. The server-level F4 check (`checkRenderSchemaCompat`
  * in `@ggui-ai/mcp-server`) compares the same `actionSpec` /
  * `streamSpec` schemas against the SERVER-REGISTERED tools' actual
  * zod schemas; it covers the operator-side "did the deployed tool
@@ -208,7 +208,7 @@ export class SchemaCompatInvariantError extends Error {
  *
  * Slots alongside `assertCrossReferences` + `assertNameInvariants`
  * at push time. Different scope from the server-level
- * `SchemaCompatError` thrown by `checkStackItemSchemaCompat` in
+ * `SchemaCompatError` thrown by `checkRenderSchemaCompat` in
  * `@ggui-ai/mcp-server`: this check uses ONLY the contract's own
  * catalog; the server-level check uses the runtime tool registry.
  */

package/dist/validation/schema-meta-validation.d.ts

@@ -23,7 +23,7 @@
  * Designed to slot at:
  *   - `ggui_handshake` entry — validates `blueprintDraft.contract`
  *     before the negotiator runs.
- *   - `ggui_push` entry — validates the `effectiveContract` (either
+ *   - `ggui_render` entry — validates the `effectiveContract` (either
  *     synth-amended or override) before any state mutation.
  *
  * Both call sites already run cross-reference and name-invariant

package/dist/validation/schema-meta-validation.js

@@ -23,7 +23,7 @@
  * Designed to slot at:
  *   - `ggui_handshake` entry — validates `blueprintDraft.contract`
  *     before the negotiator runs.
- *   - `ggui_push` entry — validates the `effectiveContract` (either
+ *   - `ggui_render` entry — validates the `effectiveContract` (either
  *     synth-amended or override) before any state mutation.
  *
  * Both call sites already run cross-reference and name-invariant
@@ -50,7 +50,7 @@ export class ContractSchemaMetaError extends Error {
             'Fix the JSON Schema at the named field. Common causes: ' +
                 'missing `items` on an array schema, a properties entry that ' +
                 'is not itself a JSON Schema object, or an unknown keyword. ' +
-                'Re-call ggui_push (or ggui_handshake) once corrected.';
+                'Re-call ggui_render (or ggui_handshake) once corrected.';
     }
 }
 function tryCompile(field, schema, violations) {

package/dist/validation/schema-subset.d.ts

@@ -12,7 +12,7 @@
  *
  * **Check points.**
  *
- *   - Pre-commit of a `StackItem` with `actionSpec` / `streamSpec`
+ *   - Pre-commit of a `Render` with `actionSpec` / `streamSpec`
  *     entries that reference tools: each action's declared schema
  *     MUST be a subset of the tool's inputSchema (what the action
  *     payload is allowed to send ⊆ what the tool accepts). Each