@guuey/mcp-apps-host 0.24.0 → 0.26.0

package/README.md

@@ -56,3 +56,8 @@ package is guuey's OSS host-side support for the same spec.
 
 Conformance status and roadmap: `docs/development/mcp-apps-host-conformance.md`
 in the guuey monorepo (guuey#123).
+
+## Support
+
+Questions and help: the guuey community on Discord — https://guuey.com/discord.
+Bugs and feature requests: https://github.com/withguuey/guuey-sdks/issues.

package/dist/action.d.ts

@@ -128,8 +128,14 @@ export declare const PULL_CIRCUIT_THRESHOLD = 3;
 /**
  * Logged ONCE when a locator's pull circuit opens — the bounded-storm marker
  * (sentry's readability ask; the #1233 next-incident is scopeable from it).
+ * The SYMBOL is the handle code and tests grep; its VALUE is the sentence a
+ * builder reads in their own site's console (guuey#1375) — our one prefix,
+ * then what happened and what follows, never an internal token. It says
+ * exactly what the circuit does: the relay stops pulling for that locator,
+ * the host is told the session is unrestorable (`onSessionUnrestorable`),
+ * and nothing retries unattended.
  */
-export declare const UI_ACTION_PULL_CIRCUIT_OPEN = "UI_ACTION_PULL_CIRCUIT_OPEN";
+export declare const UI_ACTION_PULL_CIRCUIT_OPEN = "[guuey] card updates stopped \u2014 the session behind this card could not be restored; the widget reports it, and a new conversation starts fresh";
 /**
  * Assemble the sandbox-facing action relay from a host transport. The
  * returned function is shaped for an `onCallTool` bridge: it always

package/dist/action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,CAC3C;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAChB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CACnB,CAAC;CACH,CAAC;AAEN;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAI9C,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAEvD,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,0BAA0B,2CACG,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,iBAAiB,CAK7D;AAkCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAgB9E;AAED,iFAAiF;AACjF,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,QAAQ,EAAE,CACR,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,wBAAwB,GAAG,SAAS,KACvC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,wBAAwB,CAAC;CACtC;AAKD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,2BAA2B,gCAAgC,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,0BAA0B,GAC/B,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAmD1D"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,CAC3C;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAChB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CACnB,CAAC;CACH,CAAC;AAEN;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAI9C,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAEvD,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,0BAA0B,2CACG,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,iBAAiB,CAK7D;AAkCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAgB9E;AAED,iFAAiF;AACjF,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,QAAQ,EAAE,CACR,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,wBAAwB,GAAG,SAAS,KACvC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,wBAAwB,CAAC;CACtC;AAKD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,uJACyG,CAAC;AAElJ;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,0BAA0B,GAC/B,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAmD1D"}

package/dist/action.js

@@ -125,8 +125,14 @@ export const PULL_CIRCUIT_THRESHOLD = 3;
 /**
  * Logged ONCE when a locator's pull circuit opens — the bounded-storm marker
  * (sentry's readability ask; the #1233 next-incident is scopeable from it).
+ * The SYMBOL is the handle code and tests grep; its VALUE is the sentence a
+ * builder reads in their own site's console (guuey#1375) — our one prefix,
+ * then what happened and what follows, never an internal token. It says
+ * exactly what the circuit does: the relay stops pulling for that locator,
+ * the host is told the session is unrestorable (`onSessionUnrestorable`),
+ * and nothing retries unattended.
  */
-export const UI_ACTION_PULL_CIRCUIT_OPEN = "UI_ACTION_PULL_CIRCUIT_OPEN";
+export const UI_ACTION_PULL_CIRCUIT_OPEN = "[guuey] card updates stopped — the session behind this card could not be restored; the widget reports it, and a new conversation starts fresh";
 /**
  * Assemble the sandbox-facing action relay from a host transport. The
  * returned function is shaped for an `onCallTool` bridge: it always

package/dist/host-style-variables.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The spec's `hostContext.styles.variables` record, complete (guuey#1128).
+ *
+ * `@modelcontextprotocol/ext-apps` types `McpUiStyles` as
+ * `Record<McpUiStyleVariableKey, string | undefined>` — every key PRESENT,
+ * value optional — and says why in its own doc: "rather than
+ * `Partial<Record<K, string>>` for compatibility with Zod schema generation.
+ * Both are functionally equivalent for validation." So a host that announces
+ * a partial palette must hand the type a complete record whose unset slots
+ * are `undefined`. On the wire the two are the same bytes (`JSON.stringify`
+ * drops `undefined`), the app-side `applyHostStyleVariables` skips
+ * `undefined` values, and ggui's bridge takes `string | undefined` per slot.
+ *
+ * {@link EMPTY_HOST_STYLE_VARIABLES} is that complete record with nothing
+ * set — a MIRROR of the spec's key union that the compiler enforces both
+ * ways (`Record<McpUiStyleVariableKey, undefined>`: a key missing here or a
+ * key the spec dropped is a type error the moment the dependency moves), and
+ * `host-style-variables.test.ts` pins it against the spec's own zod schema
+ * at runtime. {@link hostStyleVariablesRecord} completes a partial palette.
+ */
+import type { McpUiStyleVariableKey, McpUiStyles } from "@modelcontextprotocol/ext-apps";
+export type { McpUiStyleVariableKey, McpUiStyles };
+/** Every spec style-variable key, unset. Spread a partial palette over it. */
+export declare const EMPTY_HOST_STYLE_VARIABLES: Readonly<Record<McpUiStyleVariableKey, undefined>>;
+/** The spec-typed record for a partial palette: the announced slots set, every other slot `undefined`. */
+export declare function hostStyleVariablesRecord(partial: Readonly<Partial<McpUiStyles>>): McpUiStyles;
+/** The slots a record actually announces (the wire's view of it). */
+export declare function announcedHostStyleVariables(record: Readonly<McpUiStyles>): Partial<Record<McpUiStyleVariableKey, string>>;
+//# sourceMappingURL=host-style-variables.d.ts.map

package/dist/host-style-variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-style-variables.d.ts","sourceRoot":"","sources":["../src/host-style-variables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAEzF,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,CAAC;AAEnD,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,SAAS,CAAC,CA6EzF,CAAC;AAEF,0GAA0G;AAC1G,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,WAAW,CAE7F;AAED,qEAAqE;AACrE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAMzH"}

package/dist/host-style-variables.js

@@ -0,0 +1,92 @@
+/** Every spec style-variable key, unset. Spread a partial palette over it. */
+export const EMPTY_HOST_STYLE_VARIABLES = {
+    "--color-background-primary": undefined,
+    "--color-background-secondary": undefined,
+    "--color-background-tertiary": undefined,
+    "--color-background-inverse": undefined,
+    "--color-background-ghost": undefined,
+    "--color-background-info": undefined,
+    "--color-background-danger": undefined,
+    "--color-background-success": undefined,
+    "--color-background-warning": undefined,
+    "--color-background-disabled": undefined,
+    "--color-text-primary": undefined,
+    "--color-text-secondary": undefined,
+    "--color-text-tertiary": undefined,
+    "--color-text-inverse": undefined,
+    "--color-text-ghost": undefined,
+    "--color-text-info": undefined,
+    "--color-text-danger": undefined,
+    "--color-text-success": undefined,
+    "--color-text-warning": undefined,
+    "--color-text-disabled": undefined,
+    "--color-border-primary": undefined,
+    "--color-border-secondary": undefined,
+    "--color-border-tertiary": undefined,
+    "--color-border-inverse": undefined,
+    "--color-border-ghost": undefined,
+    "--color-border-info": undefined,
+    "--color-border-danger": undefined,
+    "--color-border-success": undefined,
+    "--color-border-warning": undefined,
+    "--color-border-disabled": undefined,
+    "--color-ring-primary": undefined,
+    "--color-ring-secondary": undefined,
+    "--color-ring-inverse": undefined,
+    "--color-ring-info": undefined,
+    "--color-ring-danger": undefined,
+    "--color-ring-success": undefined,
+    "--color-ring-warning": undefined,
+    "--font-sans": undefined,
+    "--font-mono": undefined,
+    "--font-weight-normal": undefined,
+    "--font-weight-medium": undefined,
+    "--font-weight-semibold": undefined,
+    "--font-weight-bold": undefined,
+    "--font-text-xs-size": undefined,
+    "--font-text-sm-size": undefined,
+    "--font-text-md-size": undefined,
+    "--font-text-lg-size": undefined,
+    "--font-heading-xs-size": undefined,
+    "--font-heading-sm-size": undefined,
+    "--font-heading-md-size": undefined,
+    "--font-heading-lg-size": undefined,
+    "--font-heading-xl-size": undefined,
+    "--font-heading-2xl-size": undefined,
+    "--font-heading-3xl-size": undefined,
+    "--font-text-xs-line-height": undefined,
+    "--font-text-sm-line-height": undefined,
+    "--font-text-md-line-height": undefined,
+    "--font-text-lg-line-height": undefined,
+    "--font-heading-xs-line-height": undefined,
+    "--font-heading-sm-line-height": undefined,
+    "--font-heading-md-line-height": undefined,
+    "--font-heading-lg-line-height": undefined,
+    "--font-heading-xl-line-height": undefined,
+    "--font-heading-2xl-line-height": undefined,
+    "--font-heading-3xl-line-height": undefined,
+    "--border-radius-xs": undefined,
+    "--border-radius-sm": undefined,
+    "--border-radius-md": undefined,
+    "--border-radius-lg": undefined,
+    "--border-radius-xl": undefined,
+    "--border-radius-full": undefined,
+    "--border-width-regular": undefined,
+    "--shadow-hairline": undefined,
+    "--shadow-sm": undefined,
+    "--shadow-md": undefined,
+    "--shadow-lg": undefined,
+};
+/** The spec-typed record for a partial palette: the announced slots set, every other slot `undefined`. */
+export function hostStyleVariablesRecord(partial) {
+    return { ...EMPTY_HOST_STYLE_VARIABLES, ...partial };
+}
+/** The slots a record actually announces (the wire's view of it). */
+export function announcedHostStyleVariables(record) {
+    const out = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}

package/dist/index.d.ts

@@ -13,4 +13,5 @@ export { initializeResult, initialViewHostState, resourceReadResponse, RESOURCES
 export { attachViewHost, viewDocumentHtml, type AttachViewHostConfig, type ViewCspEvents, type ViewFrameLike, type ViewHostEvents, } from "./view-host.js";
 export { attachSandboxPageDelivery, isSandboxProxyReady, SANDBOX_PROXY_READY_METHOD, SANDBOX_RESOURCE_READY_METHOD, type SandboxPageDeliveryConfig, } from "./sandbox-page.js";
 export { toolResultRenderRefusal, type PreGenerationRefusal } from "./render-refusal.js";
+export { EMPTY_HOST_STYLE_VARIABLES, announcedHostStyleVariables, hostStyleVariablesRecord, type McpUiStyleVariableKey, type McpUiStyles, } from "./host-style-variables.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,4BAA4B,EAC5B,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AAIrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EACf,0BAA0B,EAC1B,wBAAwB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,uBAAuB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,4BAA4B,EAC5B,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AAIrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EACf,0BAA0B,EAC1B,wBAAwB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,uBAAuB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIzF,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,GACjB,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -15,3 +15,7 @@ export { attachSandboxPageDelivery, isSandboxProxyReady, SANDBOX_PROXY_READY_MET
 // (`@ggui-ai/protocol` 0.14.0's third `outcome`). Hosts face it with words
 // instead of showing the envelope as an unexplained tool failure.
 export { toolResultRenderRefusal } from "./render-refusal.js";
+// guuey#1128: the spec's complete `hostContext.styles.variables` record for a
+// partial host palette (the type is every key, values optional — by the
+// spec's own design; the wire is the partial).
+export { EMPTY_HOST_STYLE_VARIABLES, announcedHostStyleVariables, hostStyleVariablesRecord, } from "./host-style-variables.js";

package/dist/react.d.ts

@@ -44,7 +44,7 @@ export type { ViewCspDiagnosis, ViewCspOrigins, ViewHostPhase } from "./view-hos
 export type { ResolvedViewMount, ViewMount, ViewMountChannel } from "./card-mount.js";
 export { defaultViewHostStrings } from "./view-strings.js";
 export type { ViewHostStrings } from "./view-strings.js";
-export interface GuueyViewProps extends Pick<AttachViewHostConfig, "hostCapabilities" | "hostInfo" | "hostContext" | "onCallTool" | "onUpdateModelContext" | "onUserMessage" | "onOpenLink" | "onReadResource" | "onSizeChanged" | "negotiationTimeoutMs" | "cspOrigins" | "onCspDiagnosis"> {
+export interface GuueyViewProps extends Pick<AttachViewHostConfig, "hostCapabilities" | "hostInfo" | "hostContext" | "onCallTool" | "onUpdateModelContext" | "onUserMessage" | "onOpenLink" | "onReadResource" | "onSizeChanged" | "onDismiss" | "negotiationTimeoutMs" | "cspOrigins" | "onCspDiagnosis"> {
     /** The resolved card to mount (see `toolResultViewMount`/`resolveViewMount`). */
     mount: ResolvedViewMount;
     /**

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAwC,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjG,OAAO,EAAoC,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACzG,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC/F,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD,MAAM,WAAW,cACf,SAAQ,IAAI,CACV,oBAAoB,EAClB,kBAAkB,GAClB,UAAU,GACV,aAAa,GACb,YAAY,GACZ,sBAAsB,GACtB,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,eAAe,GACf,sBAAsB,GACtB,YAAY,GACZ,gBAAgB,CACnB;IACD,iFAAiF;IACjF,KAAK,EAAE,iBAAiB,CAAC;IACzB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;IACtC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,gBAAgB,KAAK,SAAS,CAAC;IACjF;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACpC;AAkDD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAsL1D"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAwC,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjG,OAAO,EAAoC,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACzG,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC/F,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD,MAAM,WAAW,cACf,SAAQ,IAAI,CACV,oBAAoB,EAClB,kBAAkB,GAClB,UAAU,GACV,aAAa,GACb,YAAY,GACZ,sBAAsB,GACtB,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,eAAe,GACf,WAAW,GACX,sBAAsB,GACtB,YAAY,GACZ,gBAAgB,CACnB;IACD,iFAAiF;IACjF,KAAK,EAAE,iBAAiB,CAAC;IACzB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;IACtC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,gBAAgB,KAAK,SAAS,CAAC;IACjF;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACpC;AAkDD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAsL1D"}

package/dist/view-host-protocol.d.ts

@@ -32,6 +32,7 @@
  * minor as deprecated re-exports and was deleted at 0.8.0.)
  */
 import { type McpUiHostCapabilities, type McpUiHostContext, type McpUiInitializeResult, type McpUiResourceCsp } from "@modelcontextprotocol/ext-apps";
+import { type McpAppDismissReason } from "@ggui-ai/protocol/integrations/mcp-apps";
 import type { McpToolStructuredContent } from "./action.js";
 import type { McpResourceReadResult } from "./reader.js";
 /**
@@ -207,6 +208,28 @@ export type ViewHostEffect = {
     kind: "size-changed";
     width?: number;
     height?: number;
+} | {
+    /**
+     * The view asked to be dismissed (`ggui:dismiss`, protocol 0.18.0 —
+     * ggui#1109 / guuey#1423): the user made a dismiss gesture with focus
+     * INSIDE the card document, where the embedding page's own key
+     * handlers cannot hear it, and the card forwarded it. An INTENT, never
+     * a command — the embedder decides what dismiss means on its surface
+     * (close a takeover, return focus, collapse to a chip, nothing);
+     * ignoring it is conformant, so the glue only ever OBSERVES it
+     * ({@link AttachViewHostConfig.onDismiss} in `view-host.ts`).
+     *
+     * `reason` is the card's stated cause, forwarded verbatim. The set is
+     * EXTENSIBLY-closed on the wire: `MCP_APP_DISMISS_REASONS` documents
+     * the reasons this release NAMES, and `isMcpAppDismissMessage` admits
+     * any non-empty string on purpose — a reason a later card names that
+     * this host does not know is still a dismiss request, of unknown
+     * cause, never a message to drop (the N−1 failure the openness exists
+     * to prevent). So: NO reason whitelist here, no `reason === "escape"`
+     * branch; the effect fires for every shape the protocol guard accepts.
+     */
+    kind: "dismiss";
+    reason: McpAppDismissReason;
 };
 /**
  * The host identity/behavior the machine answers with. Everything here is
@@ -268,7 +291,9 @@ export declare function teardownMessage(): ViewHostOutbound;
  * Feed one inbound postMessage payload to the machine.
  *
  * The contract, exactly:
- *  - non-RPC data → ignored (not ours);
+ *  - non-RPC data → ignored (not ours) — with ONE typed exception: protocol
+ *    0.18.0's `ggui:dismiss` intent (`isMcpAppDismissMessage`) → a `dismiss`
+ *    effect, state untouched (guuey#1423);
  *  - notifications (no id) → consumed silently, JSON-RPC-correctly; the
  *    `ui/notifications/initialized` ack is remembered on the state;
  *  - `ui/initialize` → answered spec-canonically; phase → `"connected"`

package/dist/view-host-protocol.d.ts.map

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

package/dist/view-host-protocol.js

@@ -32,6 +32,10 @@
  * minor as deprecated re-exports and was deleted at 0.8.0.)
  */
 import { INITIALIZE_METHOD, LATEST_PROTOCOL_VERSION, RESOURCE_TEARDOWN_METHOD, SIZE_CHANGED_METHOD, } from "@modelcontextprotocol/ext-apps";
+// The ONE non-JSON-RPC message this host hears: protocol 0.18.0's dismiss
+// INTENT (ggui#1109 / guuey#1423). The guard proves the envelope's shape and,
+// by design, admits any non-empty `reason` — see the `dismiss` effect.
+import { isMcpAppDismissMessage } from "@ggui-ai/protocol/integrations/mcp-apps";
 /** JSON-RPC `method not found` — the spec's code, not an invented one. */
 const METHOD_NOT_SUPPORTED = -32601;
 /** The standard MCP method a view uses to reach host-proxied tools. */
@@ -157,7 +161,9 @@ export function teardownMessage() {
  * Feed one inbound postMessage payload to the machine.
  *
  * The contract, exactly:
- *  - non-RPC data → ignored (not ours);
+ *  - non-RPC data → ignored (not ours) — with ONE typed exception: protocol
+ *    0.18.0's `ggui:dismiss` intent (`isMcpAppDismissMessage`) → a `dismiss`
+ *    effect, state untouched (guuey#1423);
  *  - notifications (no id) → consumed silently, JSON-RPC-correctly; the
  *    `ui/notifications/initialized` ack is remembered on the state;
  *  - `ui/initialize` → answered spec-canonically; phase → `"connected"`
@@ -167,6 +173,11 @@ export function teardownMessage() {
  *  - every other REQUEST → `method_not_supported`, honestly.
  */
 export function viewHostReceive(state, behavior, data) {
+    // Checked BEFORE the envelope narrowing, which would otherwise file this
+    // non-RPC intent under "not ours". Any accepted shape dismisses — the
+    // reason is classified by the embedder, never whitelisted here.
+    if (isMcpAppDismissMessage(data))
+        return { state, effects: [{ kind: "dismiss", reason: data.reason }] };
     const req = asInboundEnvelope(data);
     if (req === undefined)
         return { state, effects: [] };

package/dist/view-host.d.ts

@@ -27,6 +27,7 @@
  * Seeded from ggui's console `surface-host.ts` (donated, guuey#186 audit);
  * re-derived here against the pure machine + our own tests.
  */
+import type { McpAppDismissReason } from "@ggui-ai/protocol/integrations/mcp-apps";
 import { type CspViolationLike, type ViewCspDiagnosis, type ViewCspOrigins, type ViewHostPhase } from "./view-host-protocol.js";
 import type { McpResourceReadResult } from "./reader.js";
 import { type McpToolCallResult, type UiActionRequest } from "./action.js";
@@ -157,6 +158,21 @@ export interface AttachViewHostConfig {
         width?: number;
         height?: number;
     }) => void;
+    /**
+     * The view asked to be dismissed — protocol 0.18.0's `ggui:dismiss`
+     * INTENT (ggui#1109 / guuey#1423): a dismiss gesture made with focus
+     * INSIDE the card document, which the embedding page's own key handlers
+     * can never hear. The card forwards; the EMBEDDER decides what dismiss
+     * means on its surface (guuey's widget routes it to the same collapse its
+     * host-document Escape takes; a transcript card may do nothing). Ignoring
+     * is conformant, so this is an observer, not a capability: nothing is
+     * advertised, nothing is answered, and absent → the intent is consumed
+     * silently exactly as before 0.18.0. `reason` is the card's stated cause
+     * and the set is extensibly-closed: it fires for EVERY shape the protocol
+     * guard accepts, an unknown reason included — treat one as "dismiss
+     * requested, cause unknown", never as nothing.
+     */
+    onDismiss?: (reason: McpAppDismissReason) => void;
     /** Observe phase transitions (see {@link ViewHostPhase}). */
     onPhaseChange?: (phase: ViewHostPhase) => void;
     /**

package/dist/view-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-host.d.ts","sourceRoot":"","sources":["../src/view-host.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"view-host.d.ts","sourceRoot":"","sources":["../src/view-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAQL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAGnB,KAAK,aAAa,EAEnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAEL,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE;QAAE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAC5D,IAAI,CAAC;IACR,mBAAmB,CACjB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAC5D,IAAI,CAAC;CACT;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,IAAI,EAAE,yBAAyB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;IACrG,mBAAmB,CAAC,IAAI,EAAE,yBAAyB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;CACzG;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtE;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACpE;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC;IAC7C;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAAC;IAC7E;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACpE;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAClD,6DAA6D;IAC7D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACvD,6EAA6E;IAC7E,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qEAAqE;IACrE,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AA+DD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,oBAAyB,GAAG,MAAM,IAAI,CAgJlG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAcnF"}

package/dist/view-host.js

@@ -1,32 +1,3 @@
-/**
- * `attachViewHost` — the DOM glue around `view-host-protocol.ts`'s pure
- * machine (guuey#186 Gap 1). Framework-agnostic: any embedder with an
- * iframe can play the MCP Apps Host role with one call; `react.tsx` is one
- * convenience composition of exactly this, and a future full transcript
- * renderer composes the same primitive differently.
- *
- * This module is glue by DESIGN — every decision (what to answer, what to
- * refuse, when the negotiation window lapses) lives in the machine, which
- * the Node-only publish gate can test. What genuinely needs a browser is
- * this file's five moves: listen, identity-filter, post, time, detach —
- * covered by the monorepo's Playwright leg (`e2e/`), which the guuey-sdks
- * mirror deliberately does not carry.
- *
- * ## The identity filter (security invariant)
- *
- * Messages are matched by `event.source === frame.contentWindow`, NEVER by
- * `event.origin`: a view frame runs `sandbox="allow-scripts"` WITHOUT
- * `allow-same-origin`, so its origin is opaque — every message it posts
- * carries `"null"`, a value every other sandboxed frame on the page
- * shares, identifying nobody. The window handle is the only identity that
- * names the frame; a frame with no `contentWindow` matches nothing rather
- * than everything. Responses target `'*'` for the same reason: an opaque
- * origin is not addressable by name, and the handshake payload carries no
- * secrets — it is the result the spec defines for any host.
- *
- * Seeded from ggui's console `surface-host.ts` (donated, guuey#186 audit);
- * re-derived here against the pure machine + our own tests.
- */
 import { diagnoseCspViolation, initialViewHostState, resourceReadResponse, teardownMessage, toolCallResponse, viewHostElapsed, viewHostReceive, } from "./view-host-protocol.js";
 import { unavailableToolCallResult, } from "./action.js";
 const DEFAULT_HOST_INFO = { name: "guuey-view-host", version: "1" };
@@ -171,6 +142,17 @@ export function attachViewHost(frame, config = {}) {
                     // logs; the view's contract is already satisfied.
                 }
             }
+            else if (effect.kind === "dismiss") {
+                // Observation only (guuey#1423): the machine answered nothing (an
+                // intent owes no reply) and the embedder's decision is its own —
+                // contained like every other observer.
+                try {
+                    config.onDismiss?.(effect.reason);
+                }
+                catch {
+                    // Observer failure is the embedder's bug; the message pump stands.
+                }
+            }
             else {
                 config.onSizeChanged?.({
                     ...(effect.width !== undefined ? { width: effect.width } : {}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guuey/mcp-apps-host",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "description": "The MCP Apps (SEP-1865) Host role for guuey's chat surfaces — view-mount narrowing across UI channels, ui:// locator rehydration by resources/read, and the sandbox-trust channel contract. Vendor-neutral: any spec-following MCP App mounts through it.",
   "license": "MIT",
   "type": "module",
@@ -33,7 +33,7 @@
     }
   },
   "dependencies": {
-    "@ggui-ai/protocol": "0.17.0",
+    "@ggui-ai/protocol": "0.19.0",
     "@modelcontextprotocol/ext-apps": "^1.7.5",
     "@silverprotocol/core": "0.6.2"
   },

package/src/action.ts

@@ -199,8 +199,15 @@ export const PULL_CIRCUIT_THRESHOLD = 3;
 /**
  * Logged ONCE when a locator's pull circuit opens — the bounded-storm marker
  * (sentry's readability ask; the #1233 next-incident is scopeable from it).
+ * The SYMBOL is the handle code and tests grep; its VALUE is the sentence a
+ * builder reads in their own site's console (guuey#1375) — our one prefix,
+ * then what happened and what follows, never an internal token. It says
+ * exactly what the circuit does: the relay stops pulling for that locator,
+ * the host is told the session is unrestorable (`onSessionUnrestorable`),
+ * and nothing retries unattended.
  */
-export const UI_ACTION_PULL_CIRCUIT_OPEN = "UI_ACTION_PULL_CIRCUIT_OPEN";
+export const UI_ACTION_PULL_CIRCUIT_OPEN =
+  "[guuey] card updates stopped — the session behind this card could not be restored; the widget reports it, and a new conversation starts fresh";
 
 /**
  * Assemble the sandbox-facing action relay from a host transport. The

package/src/host-style-variables.ts

@@ -0,0 +1,117 @@
+/**
+ * The spec's `hostContext.styles.variables` record, complete (guuey#1128).
+ *
+ * `@modelcontextprotocol/ext-apps` types `McpUiStyles` as
+ * `Record<McpUiStyleVariableKey, string | undefined>` — every key PRESENT,
+ * value optional — and says why in its own doc: "rather than
+ * `Partial<Record<K, string>>` for compatibility with Zod schema generation.
+ * Both are functionally equivalent for validation." So a host that announces
+ * a partial palette must hand the type a complete record whose unset slots
+ * are `undefined`. On the wire the two are the same bytes (`JSON.stringify`
+ * drops `undefined`), the app-side `applyHostStyleVariables` skips
+ * `undefined` values, and ggui's bridge takes `string | undefined` per slot.
+ *
+ * {@link EMPTY_HOST_STYLE_VARIABLES} is that complete record with nothing
+ * set — a MIRROR of the spec's key union that the compiler enforces both
+ * ways (`Record<McpUiStyleVariableKey, undefined>`: a key missing here or a
+ * key the spec dropped is a type error the moment the dependency moves), and
+ * `host-style-variables.test.ts` pins it against the spec's own zod schema
+ * at runtime. {@link hostStyleVariablesRecord} completes a partial palette.
+ */
+import type { McpUiStyleVariableKey, McpUiStyles } from "@modelcontextprotocol/ext-apps";
+
+export type { McpUiStyleVariableKey, McpUiStyles };
+
+/** Every spec style-variable key, unset. Spread a partial palette over it. */
+export const EMPTY_HOST_STYLE_VARIABLES: Readonly<Record<McpUiStyleVariableKey, undefined>> = {
+  "--color-background-primary": undefined,
+  "--color-background-secondary": undefined,
+  "--color-background-tertiary": undefined,
+  "--color-background-inverse": undefined,
+  "--color-background-ghost": undefined,
+  "--color-background-info": undefined,
+  "--color-background-danger": undefined,
+  "--color-background-success": undefined,
+  "--color-background-warning": undefined,
+  "--color-background-disabled": undefined,
+  "--color-text-primary": undefined,
+  "--color-text-secondary": undefined,
+  "--color-text-tertiary": undefined,
+  "--color-text-inverse": undefined,
+  "--color-text-ghost": undefined,
+  "--color-text-info": undefined,
+  "--color-text-danger": undefined,
+  "--color-text-success": undefined,
+  "--color-text-warning": undefined,
+  "--color-text-disabled": undefined,
+  "--color-border-primary": undefined,
+  "--color-border-secondary": undefined,
+  "--color-border-tertiary": undefined,
+  "--color-border-inverse": undefined,
+  "--color-border-ghost": undefined,
+  "--color-border-info": undefined,
+  "--color-border-danger": undefined,
+  "--color-border-success": undefined,
+  "--color-border-warning": undefined,
+  "--color-border-disabled": undefined,
+  "--color-ring-primary": undefined,
+  "--color-ring-secondary": undefined,
+  "--color-ring-inverse": undefined,
+  "--color-ring-info": undefined,
+  "--color-ring-danger": undefined,
+  "--color-ring-success": undefined,
+  "--color-ring-warning": undefined,
+  "--font-sans": undefined,
+  "--font-mono": undefined,
+  "--font-weight-normal": undefined,
+  "--font-weight-medium": undefined,
+  "--font-weight-semibold": undefined,
+  "--font-weight-bold": undefined,
+  "--font-text-xs-size": undefined,
+  "--font-text-sm-size": undefined,
+  "--font-text-md-size": undefined,
+  "--font-text-lg-size": undefined,
+  "--font-heading-xs-size": undefined,
+  "--font-heading-sm-size": undefined,
+  "--font-heading-md-size": undefined,
+  "--font-heading-lg-size": undefined,
+  "--font-heading-xl-size": undefined,
+  "--font-heading-2xl-size": undefined,
+  "--font-heading-3xl-size": undefined,
+  "--font-text-xs-line-height": undefined,
+  "--font-text-sm-line-height": undefined,
+  "--font-text-md-line-height": undefined,
+  "--font-text-lg-line-height": undefined,
+  "--font-heading-xs-line-height": undefined,
+  "--font-heading-sm-line-height": undefined,
+  "--font-heading-md-line-height": undefined,
+  "--font-heading-lg-line-height": undefined,
+  "--font-heading-xl-line-height": undefined,
+  "--font-heading-2xl-line-height": undefined,
+  "--font-heading-3xl-line-height": undefined,
+  "--border-radius-xs": undefined,
+  "--border-radius-sm": undefined,
+  "--border-radius-md": undefined,
+  "--border-radius-lg": undefined,
+  "--border-radius-xl": undefined,
+  "--border-radius-full": undefined,
+  "--border-width-regular": undefined,
+  "--shadow-hairline": undefined,
+  "--shadow-sm": undefined,
+  "--shadow-md": undefined,
+  "--shadow-lg": undefined,
+};
+
+/** The spec-typed record for a partial palette: the announced slots set, every other slot `undefined`. */
+export function hostStyleVariablesRecord(partial: Readonly<Partial<McpUiStyles>>): McpUiStyles {
+  return { ...EMPTY_HOST_STYLE_VARIABLES, ...partial };
+}
+
+/** The slots a record actually announces (the wire's view of it). */
+export function announcedHostStyleVariables(record: Readonly<McpUiStyles>): Partial<Record<McpUiStyleVariableKey, string>> {
+  const out: Partial<Record<McpUiStyleVariableKey, string>> = {};
+  for (const [key, value] of Object.entries(record) as Array<[McpUiStyleVariableKey, string | undefined]>) {
+    if (value !== undefined) out[key] = value;
+  }
+  return out;
+}

package/src/index.ts

@@ -100,3 +100,13 @@ export {
 // (`@ggui-ai/protocol` 0.14.0's third `outcome`). Hosts face it with words
 // instead of showing the envelope as an unexplained tool failure.
 export { toolResultRenderRefusal, type PreGenerationRefusal } from "./render-refusal.js";
+// guuey#1128: the spec's complete `hostContext.styles.variables` record for a
+// partial host palette (the type is every key, values optional — by the
+// spec's own design; the wire is the partial).
+export {
+  EMPTY_HOST_STYLE_VARIABLES,
+  announcedHostStyleVariables,
+  hostStyleVariablesRecord,
+  type McpUiStyleVariableKey,
+  type McpUiStyles,
+} from "./host-style-variables.js";

package/src/react.tsx

@@ -69,6 +69,7 @@ export interface GuueyViewProps
     | "onOpenLink"
     | "onReadResource"
     | "onSizeChanged"
+    | "onDismiss"
     | "negotiationTimeoutMs"
     | "cspOrigins"
     | "onCspDiagnosis"

package/src/view-host-protocol.ts

@@ -41,6 +41,10 @@ import {
   type McpUiInitializeResult,
   type McpUiResourceCsp,
 } from "@modelcontextprotocol/ext-apps";
+// The ONE non-JSON-RPC message this host hears: protocol 0.18.0's dismiss
+// INTENT (ggui#1109 / guuey#1423). The guard proves the envelope's shape and,
+// by design, admits any non-empty `reason` — see the `dismiss` effect.
+import { isMcpAppDismissMessage, type McpAppDismissReason } from "@ggui-ai/protocol/integrations/mcp-apps";
 import type { McpToolStructuredContent } from "./action.js";
 import type { McpResourceReadResult } from "./reader.js";
 
@@ -233,6 +237,29 @@ export type ViewHostEffect =
       kind: "size-changed";
       width?: number;
       height?: number;
+    }
+  | {
+      /**
+       * The view asked to be dismissed (`ggui:dismiss`, protocol 0.18.0 —
+       * ggui#1109 / guuey#1423): the user made a dismiss gesture with focus
+       * INSIDE the card document, where the embedding page's own key
+       * handlers cannot hear it, and the card forwarded it. An INTENT, never
+       * a command — the embedder decides what dismiss means on its surface
+       * (close a takeover, return focus, collapse to a chip, nothing);
+       * ignoring it is conformant, so the glue only ever OBSERVES it
+       * ({@link AttachViewHostConfig.onDismiss} in `view-host.ts`).
+       *
+       * `reason` is the card's stated cause, forwarded verbatim. The set is
+       * EXTENSIBLY-closed on the wire: `MCP_APP_DISMISS_REASONS` documents
+       * the reasons this release NAMES, and `isMcpAppDismissMessage` admits
+       * any non-empty string on purpose — a reason a later card names that
+       * this host does not know is still a dismiss request, of unknown
+       * cause, never a message to drop (the N−1 failure the openness exists
+       * to prevent). So: NO reason whitelist here, no `reason === "escape"`
+       * branch; the effect fires for every shape the protocol guard accepts.
+       */
+      kind: "dismiss";
+      reason: McpAppDismissReason;
     };
 
 /**
@@ -366,7 +393,9 @@ export function teardownMessage(): ViewHostOutbound {
  * Feed one inbound postMessage payload to the machine.
  *
  * The contract, exactly:
- *  - non-RPC data → ignored (not ours);
+ *  - non-RPC data → ignored (not ours) — with ONE typed exception: protocol
+ *    0.18.0's `ggui:dismiss` intent (`isMcpAppDismissMessage`) → a `dismiss`
+ *    effect, state untouched (guuey#1423);
  *  - notifications (no id) → consumed silently, JSON-RPC-correctly; the
  *    `ui/notifications/initialized` ack is remembered on the state;
  *  - `ui/initialize` → answered spec-canonically; phase → `"connected"`
@@ -380,6 +409,10 @@ export function viewHostReceive(
   behavior: ViewHostBehavior,
   data: unknown,
 ): ViewHostTransition {
+  // Checked BEFORE the envelope narrowing, which would otherwise file this
+  // non-RPC intent under "not ours". Any accepted shape dismisses — the
+  // reason is classified by the embedder, never whitelisted here.
+  if (isMcpAppDismissMessage(data)) return { state, effects: [{ kind: "dismiss", reason: data.reason }] };
   const req = asInboundEnvelope(data);
   if (req === undefined) return { state, effects: [] };
 

package/src/view-host.ts

@@ -27,6 +27,7 @@
  * Seeded from ggui's console `surface-host.ts` (donated, guuey#186 audit);
  * re-derived here against the pure machine + our own tests.
  */
+import type { McpAppDismissReason } from "@ggui-ai/protocol/integrations/mcp-apps";
 import {
   diagnoseCspViolation,
   initialViewHostState,
@@ -172,6 +173,21 @@ export interface AttachViewHostConfig {
    * exactly this callback.
    */
   onSizeChanged?: (size: { width?: number; height?: number }) => void;
+  /**
+   * The view asked to be dismissed — protocol 0.18.0's `ggui:dismiss`
+   * INTENT (ggui#1109 / guuey#1423): a dismiss gesture made with focus
+   * INSIDE the card document, which the embedding page's own key handlers
+   * can never hear. The card forwards; the EMBEDDER decides what dismiss
+   * means on its surface (guuey's widget routes it to the same collapse its
+   * host-document Escape takes; a transcript card may do nothing). Ignoring
+   * is conformant, so this is an observer, not a capability: nothing is
+   * advertised, nothing is answered, and absent → the intent is consumed
+   * silently exactly as before 0.18.0. `reason` is the card's stated cause
+   * and the set is extensibly-closed: it fires for EVERY shape the protocol
+   * guard accepts, an unknown reason included — treat one as "dismiss
+   * requested, cause unknown", never as nothing.
+   */
+  onDismiss?: (reason: McpAppDismissReason) => void;
   /** Observe phase transitions (see {@link ViewHostPhase}). */
   onPhaseChange?: (phase: ViewHostPhase) => void;
   /**
@@ -361,7 +377,16 @@ export function attachViewHost(frame: ViewFrameLike, config: AttachViewHostConfi
           // logs; the view's contract is already satisfied.
         }
       }
-      else {
+      else if (effect.kind === "dismiss") {
+        // Observation only (guuey#1423): the machine answered nothing (an
+        // intent owes no reply) and the embedder's decision is its own —
+        // contained like every other observer.
+        try {
+          config.onDismiss?.(effect.reason);
+        } catch {
+          // Observer failure is the embedder's bug; the message pump stands.
+        }
+      } else {
         config.onSizeChanged?.({
           ...(effect.width !== undefined ? { width: effect.width } : {}),
           ...(effect.height !== undefined ? { height: effect.height } : {}),