@mcp-b/char 0.0.6 → 0.1.0

package/dist/custom-elements.json

@@ -0,0 +1,2180 @@
+{
+  "schemaVersion": "1.0.0",
+  "readme": "",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "packages/char/src/web-component.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<char-agent>` custom element.\n\nCreates an iframe pointing to the SaaS app's /embed/ entrypoint and relays\nauth, styles, dark mode, display mode, and MCP messages via postMessage.\n\nUses a unified `char-context` message with diffing (only changed fields\nare sent) instead of separate messages per concern.",
+          "name": "CharAgentElement",
+          "members": [
+            {
+              "kind": "field",
+              "name": "devMode",
+              "type": {
+                "text": "DevModeConfig | undefined"
+              },
+              "description": "React 19-friendly property form of `dev-mode`.\nRead once during `connectedCallback`."
+            },
+            {
+              "kind": "field",
+              "name": "apiBase",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "React 19-friendly property form of `api-base`.\nRead once during `connectedCallback`."
+            },
+            {
+              "kind": "field",
+              "name": "_iframe",
+              "type": {
+                "text": "HTMLIFrameElement | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Active iframe element owned by this custom element instance."
+            },
+            {
+              "kind": "field",
+              "name": "_proxy",
+              "type": {
+                "text": "CharIframeProxy | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "MCP relay between host window and embed iframe."
+            },
+            {
+              "kind": "field",
+              "name": "_iframeReady",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Indicates whether the iframe has emitted `char-ready`."
+            },
+            {
+              "kind": "field",
+              "name": "_messageListener",
+              "type": {
+                "text": "((event: MessageEvent) => void) | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Bound window message handler for iframe-originated events."
+            },
+            {
+              "kind": "field",
+              "name": "_darkModeObserver",
+              "type": {
+                "text": "MutationObserver | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Observer that tracks host theme mutations."
+            },
+            {
+              "kind": "field",
+              "name": "_darkModeMediaQuery",
+              "type": {
+                "text": "MediaQueryList | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Media query object for `prefers-color-scheme`."
+            },
+            {
+              "kind": "field",
+              "name": "_darkModeMediaHandler",
+              "type": {
+                "text": "(() => void) | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Registered media query callback."
+            },
+            {
+              "kind": "field",
+              "name": "_styleObserver",
+              "type": {
+                "text": "MutationObserver | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Observer that tracks host style/class mutations."
+            },
+            {
+              "kind": "field",
+              "name": "_containerResizeObserver",
+              "type": {
+                "text": "ResizeObserver | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Observer that tracks container size changes."
+            },
+            {
+              "kind": "field",
+              "name": "_teardownPending",
+              "type": {
+                "text": "| { requestId: string; resolve: () => void; timeoutId: number }\n\t\t| null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "In-flight teardown request waiting for iframe acknowledgement."
+            },
+            {
+              "kind": "field",
+              "name": "_teardownSequence",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Monotonic sequence used to construct teardown request IDs."
+            },
+            {
+              "kind": "field",
+              "name": "_isDisconnecting",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Re-entrancy guard used during disconnect lifecycle."
+            },
+            {
+              "kind": "field",
+              "name": "_hostContext",
+              "type": {
+                "text": "CharHostContext"
+              },
+              "privacy": "private",
+              "default": "{}",
+              "description": "Last host context snapshot used for delta emission."
+            },
+            {
+              "kind": "field",
+              "name": "_pendingAuth",
+              "type": {
+                "text": "{\n\t\tidToken?: string\n\t\tclientId?: string\n\t\torganizationId?: string\n\t\tticketAuth?: TicketAuth\n\t} | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Pending credentials that are flushed when the iframe is ready."
+            },
+            {
+              "kind": "method",
+              "name": "_hasActiveRuntime",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Determines whether this instance already has an initialized runtime."
+            },
+            {
+              "kind": "method",
+              "name": "_resolveIframeOrigin",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "apiBase",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Parses and validates the iframe origin from the configured API base URL."
+            },
+            {
+              "kind": "method",
+              "name": "_createIframe",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLIFrameElement"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "apiBase",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Creates a fully configured iframe element for the embed runtime."
+            },
+            {
+              "kind": "method",
+              "name": "_createMessageListener",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "(event: MessageEvent) => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "iframe",
+                  "type": {
+                    "text": "HTMLIFrameElement"
+                  }
+                },
+                {
+                  "name": "iframeOrigin",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Creates the message listener that filters by source/origin and dispatches typed events."
+            },
+            {
+              "kind": "method",
+              "name": "_handleIframeMessage",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "data",
+                  "type": {
+                    "text": "CharIframeMessageData"
+                  }
+                },
+                {
+                  "name": "iframeOrigin",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Routes validated iframe messages to local handlers and host DOM events."
+            },
+            {
+              "kind": "method",
+              "name": "_emitCharEvent",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Emits a host-facing custom event without detail payload."
+            },
+            {
+              "kind": "method",
+              "name": "_emitCharEventWithDetail",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "type": {
+                    "text": "unknown"
+                  }
+                }
+              ],
+              "description": "Emits a host-facing custom event with detail payload."
+            },
+            {
+              "kind": "method",
+              "name": "_emitCharError",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "code",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Emits a standardized `char-error` event."
+            },
+            {
+              "kind": "method",
+              "name": "_finalizeDisconnect",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Releases iframe, observers, listeners, and pending teardown state."
+            },
+            {
+              "kind": "method",
+              "name": "connect",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "type": {
+                    "text": "ConnectOptions"
+                  },
+                  "description": "Authentication payload for either ID token or ticket auth."
+                }
+              ],
+              "description": "Connect to the Char agent with authentication.\n\nThe token is stored as a JavaScript property (not as a DOM attribute),\npreventing exposure to DOM inspection and session replay tools."
+            },
+            {
+              "kind": "method",
+              "name": "setAuth",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "type": {
+                    "text": "ConnectOptions | null"
+                  },
+                  "description": "Auth payload to connect, or `null` to disconnect."
+                }
+              ],
+              "description": "Convenience method for declarative wrappers.\nApplies auth when provided, otherwise clears auth."
+            },
+            {
+              "kind": "method",
+              "name": "disconnect",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Disconnect from the Char agent.\nClears the authentication token."
+            },
+            {
+              "kind": "method",
+              "name": "_getIframeOrigin",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              },
+              "description": "Resolves the current iframe origin when mounted."
+            },
+            {
+              "kind": "method",
+              "name": "setHostContext",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "hostContext",
+                  "type": {
+                    "text": "CharHostContext"
+                  },
+                  "description": "Partial host context patch to merge and emit."
+                }
+              ],
+              "description": "Update the host context sent to the iframe.\nOnly changed fields are transmitted (diffing pattern)."
+            },
+            {
+              "kind": "method",
+              "name": "_sendInitialContext",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "iframeOrigin",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "Trusted origin used for postMessage target filtering."
+                }
+              ],
+              "description": "Build and send the full initial context after iframe signals char-ready."
+            },
+            {
+              "kind": "method",
+              "name": "_sendContextDelta",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "changes",
+                  "type": {
+                    "text": "CharHostContext"
+                  },
+                  "description": "Minimal context patch derived from diffing."
+                }
+              ],
+              "description": "Send a context delta to the iframe."
+            },
+            {
+              "kind": "method",
+              "name": "_postAuth",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "iframeOrigin",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "Trusted origin used for postMessage target filtering."
+                }
+              ],
+              "description": "Post authentication credentials to the iframe."
+            },
+            {
+              "kind": "method",
+              "name": "_requestTeardown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "iframeOrigin",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "Trusted origin used for postMessage target filtering."
+                },
+                {
+                  "name": "reason",
+                  "type": {
+                    "text": "'disconnect' | 'unmount' | 'reload'"
+                  },
+                  "description": "Lifecycle reason for teardown."
+                }
+              ],
+              "description": "Requests graceful iframe teardown and resolves once acknowledged or timed out."
+            },
+            {
+              "kind": "method",
+              "name": "_resolvePendingTeardown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "requestId",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "Optional request identifier to match against pending teardown."
+                }
+              ],
+              "description": "Completes an in-flight teardown promise when the iframe acknowledges it."
+            },
+            {
+              "kind": "method",
+              "name": "_handleOpenLinkRequest",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "requestId",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "Link request identifier supplied by the iframe."
+                },
+                {
+                  "name": "url",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "Requested URL string."
+                },
+                {
+                  "name": "iframeOrigin",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "Trusted origin used for postMessage target filtering."
+                }
+              ],
+              "description": "Handles open-link requests from the iframe with protocol allowlisting.\nThis allowlist intentionally mirrors the iframe-side pre-filter."
+            },
+            {
+              "kind": "method",
+              "name": "_observeDarkMode",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Observe dark mode changes and forward to iframe via unified context."
+            },
+            {
+              "kind": "method",
+              "name": "_observeStyleChanges",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Observe style attribute changes on <char-agent> to detect CSS variable updates.\nRe-extracts variables and sends delta via unified context."
+            },
+            {
+              "kind": "method",
+              "name": "_observeContainerDimensions",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Observe host element dimensions to provide containerDimensions context."
+            },
+            {
+              "kind": "method",
+              "name": "_resolveDevMode",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Resolve devMode from property (React 19) or attribute."
+            },
+            {
+              "kind": "method",
+              "name": "_resolveApiBaseOverride",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Resolve apiBase override from property (React 19) or attribute."
+            }
+          ],
+          "events": [
+            {
+              "name": "type",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "name": "char-open-link",
+              "type": {
+                "text": "CustomEvent"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "dev-mode"
+            },
+            {
+              "name": "enable-debug-tools"
+            },
+            {
+              "name": "display-mode"
+            },
+            {
+              "name": "api-base"
+            }
+          ],
+          "superclass": {
+            "name": "HTMLElement"
+          },
+          "tagName": "tagName",
+          "customElement": true
+        },
+        {
+          "kind": "variable",
+          "name": "width"
+        },
+        {
+          "kind": "variable",
+          "name": "height"
+        },
+        {
+          "kind": "variable",
+          "name": "theme"
+        },
+        {
+          "kind": "function",
+          "name": "registerChar",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "tagName",
+              "default": "'char-agent'",
+              "description": "Optional custom tag name override."
+            }
+          ],
+          "description": "Register the <char-agent> custom element.\nCalled automatically when importing this module.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "CharContainerDimensions",
+          "declaration": {
+            "name": "CharContainerDimensions",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharDeviceCapabilities",
+          "declaration": {
+            "name": "CharDeviceCapabilities",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharDisplayMode",
+          "declaration": {
+            "name": "CharDisplayMode",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharErrorDetail",
+          "declaration": {
+            "name": "CharErrorDetail",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharHostCapabilities",
+          "declaration": {
+            "name": "CharHostCapabilities",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharHostContext",
+          "declaration": {
+            "name": "CharHostContext",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharHostStyles",
+          "declaration": {
+            "name": "CharHostStyles",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharOpenLinkDetail",
+          "declaration": {
+            "name": "CharOpenLinkDetail",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharPlatform",
+          "declaration": {
+            "name": "CharPlatform",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharRequestDisplayModeDetail",
+          "declaration": {
+            "name": "CharRequestDisplayModeDetail",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharSafeAreaInsets",
+          "declaration": {
+            "name": "CharSafeAreaInsets",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharSizeChangedDetail",
+          "declaration": {
+            "name": "CharSizeChangedDetail",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharTheme",
+          "declaration": {
+            "name": "CharTheme",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ConnectOptions",
+          "declaration": {
+            "name": "ConnectOptions",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DevModeConfig",
+          "declaration": {
+            "name": "DevModeConfig",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "TicketAuth",
+          "declaration": {
+            "name": "TicketAuth",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharAgentElement",
+          "declaration": {
+            "name": "CharAgentElement",
+            "module": "packages/char/src/web-component.tsx"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "registerChar",
+          "declaration": {
+            "name": "registerChar",
+            "module": "packages/char/src/web-component.tsx"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "tagName",
+          "declaration": {
+            "name": "CharAgentElement",
+            "module": "packages/char/src/web-component.tsx"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/char/src/shell-component.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<char-agent-shell>` custom element.\n\nOpinionated host shell that composes a persistent inner `<char-agent>` and\nowns responsive mode policy plus host layout orchestration.\nThis shell does not render chat controls, prompts, or composer UI.\nVisible assistant UI is always iframe-owned.\n\nPolicy:\n- closed to `pip`\n- open desktop to `inline`\n- open narrow viewport to `fullscreen`",
+          "name": "CharAgentShellElement",
+          "members": [
+            {
+              "kind": "field",
+              "name": "devMode",
+              "type": {
+                "text": "DevModeConfig | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "apiBase",
+              "type": {
+                "text": "string | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_agent",
+              "type": {
+                "text": "CharAgentElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_open",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_fullscreenBreakpoint",
+              "privacy": "private",
+              "default": "1024",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_panelWidth",
+              "privacy": "private",
+              "default": "420",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_pipWidth",
+              "privacy": "private",
+              "default": "300",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_pipHeight",
+              "privacy": "private",
+              "default": "96",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_pipPosition",
+              "type": {
+                "text": "CharPipPosition"
+              },
+              "privacy": "private",
+              "default": "'bottom-center'"
+            },
+            {
+              "kind": "field",
+              "name": "_isNarrowViewport",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_mediaQuery",
+              "type": {
+                "text": "MediaQueryList | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_mediaQueryHandler",
+              "type": {
+                "text": "((event: MediaQueryListEvent) => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pendingConnectOptions",
+              "type": {
+                "text": "ConnectOptions | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pendingHostContext",
+              "type": {
+                "text": "CharHostContext"
+              },
+              "privacy": "private",
+              "default": "{}"
+            },
+            {
+              "kind": "field",
+              "name": "_isApplyingOpenAttribute",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_forwardedListenersAttached",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_healthState",
+              "type": {
+                "text": "ShellHealthState"
+              },
+              "privacy": "private",
+              "default": "'idle'"
+            },
+            {
+              "kind": "field",
+              "name": "_healthTimeoutId",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pipMeasuredHeight",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_revealFrameId",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pipExpanded",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_pipPillElement",
+              "type": {
+                "text": "HTMLDivElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pipCollapseTimerId",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_hoverMediaQuery",
+              "type": {
+                "text": "MediaQueryList | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pipListenersAttached",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_pipAnimating",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_pipAnimationTimeoutId",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pendingPipMeasuredHeight",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_tapOutsideListener",
+              "type": {
+                "text": "((e: Event) => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pipHiddenByScroll",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_scrollListener",
+              "type": {
+                "text": "((e: Event) => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_scrollRafId",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_lastScrollEl",
+              "type": {
+                "text": "Element | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_lastScrollTop",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_scrollDelta",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "_swipeTouchStartY",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_swipeStartAtTop",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_swipeStartAtBottom",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_swipeTouchStartListener",
+              "type": {
+                "text": "((e: TouchEvent) => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_swipeTouchEndListener",
+              "type": {
+                "text": "((e: TouchEvent) => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_wheelListener",
+              "type": {
+                "text": "((e: WheelEvent) => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_wheelDelta",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "fullscreenBreakpoint",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "panelWidth",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "pipWidth",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "pipHeight",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "pipPosition",
+              "type": {
+                "text": "CharPipPosition"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "connect",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "type": {
+                    "text": "ConnectOptions"
+                  },
+                  "description": "Authentication payload for either ID token or ticket auth."
+                }
+              ],
+              "description": "Connects shell authentication and starts availability health checks."
+            },
+            {
+              "kind": "method",
+              "name": "disconnect",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Clears authentication and disconnects the inner `<char-agent>`."
+            },
+            {
+              "kind": "method",
+              "name": "setAuth",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "type": {
+                    "text": "ConnectOptions | null"
+                  },
+                  "description": "Auth payload to connect, or `null` to disconnect."
+                }
+              ],
+              "description": "Convenience method for declarative wrappers.\nApplies auth when provided, otherwise clears auth."
+            },
+            {
+              "kind": "method",
+              "name": "setHostContext",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "hostContext",
+                  "type": {
+                    "text": "CharHostContext"
+                  },
+                  "description": "Partial host context patch to forward."
+                }
+              ],
+              "description": "Merges and forwards host context to the inner `<char-agent>`.\nShell-owned fields (`displayMode`, `availableDisplayModes`) are ignored."
+            },
+            {
+              "kind": "method",
+              "name": "setOpen",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "open",
+                  "type": {
+                    "text": "boolean"
+                  },
+                  "description": "Next desired open state."
+                }
+              ],
+              "description": "Sets shell open state."
+            },
+            {
+              "kind": "method",
+              "name": "toggleOpen",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Toggles shell open state."
+            },
+            {
+              "kind": "method",
+              "name": "_upgradeProperty",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "propertyName",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_ensureAgent",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_primeAgentBootConfig",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "agent",
+                  "type": {
+                    "text": "CharAgentElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_attachForwardedListeners",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_detachForwardedListeners",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_readConfigFromAttributes",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_syncForwardedAttributes",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_setupViewportObserver",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_teardownViewportObserver",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_applyDisplayModeAndLayout",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_applyHostLayout",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "displayMode",
+                  "type": {
+                    "text": "CharDisplayMode"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_composePipTransform",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "opts",
+                  "type": {
+                    "text": "{\n\t\tscrollHide?: boolean\n\t}"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_applyAgentLayout",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "displayMode",
+                  "type": {
+                    "text": "CharDisplayMode"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_ensurePipPill",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLDivElement"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_updatePipPillPosition",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "pipWidth",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "heightDelta",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "pillHeight",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_applyPipVisualState",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_setPipExpanded",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "expanded",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_flushPendingPipMeasuredHeight",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_isHoverDevice",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_attachPipInteractionListeners",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_detachPipInteractionListeners",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_schedulePipCollapse",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_clearPipCollapseTimer",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_attachTapOutsideListener",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_detachTapOutsideListener",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_handlePipPointerEnter",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_handlePipPointerLeave",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_attachScrollHideListener",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_evaluateScrollPosition",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_detachScrollHideListener",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_attachSwipeGestureListeners",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_detachSwipeGestureListeners",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_attachWheelFallbackListener",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_detachWheelFallbackListener",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_handlePillClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_handlePillKeydown",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_hidePipPill",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_resetHostLayoutStyles",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_resetAgentLayoutStyles",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_applyUnavailableLayout",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_applyPreReadyLayout",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_startHealthWait",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_stopHealthWait",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_markHealthy",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_cancelRevealFade",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_startRevealFade",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_setUnavailable",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_recoverFromUnavailable",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_setOpenInternal",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "nextOpen",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "options",
+                  "type": {
+                    "text": "{ emit: boolean; reflect: boolean }"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_reflectOpenAttribute",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "open",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_flushPendingConnectAndContext",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_handleRequestDisplayMode",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_handleClose",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_handleInitialized",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_handleInnerError",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_handleInnerSizeChanged",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "name": "char-error",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "name": "SHELL_OPEN_CHANGE_EVENT",
+              "type": {
+                "text": "CustomEvent"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "open"
+            },
+            {
+              "name": "fullscreen-breakpoint"
+            },
+            {
+              "name": "panel-width"
+            },
+            {
+              "name": "pip-position"
+            },
+            {
+              "name": "pip-width"
+            },
+            {
+              "name": "pip-height"
+            },
+            {
+              "name": "dev-mode"
+            },
+            {
+              "name": "enable-debug-tools"
+            },
+            {
+              "name": "api-base"
+            }
+          ],
+          "superclass": {
+            "name": "HTMLElement"
+          },
+          "tagName": "tagName",
+          "customElement": true
+        },
+        {
+          "kind": "function",
+          "name": "registerCharShell",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "tagName",
+              "default": "'char-agent-shell'",
+              "description": "Optional custom tag name override."
+            }
+          ],
+          "description": "Registers the `<char-agent-shell>` custom element.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "CharContainerDimensions",
+          "declaration": {
+            "name": "CharContainerDimensions",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharDeviceCapabilities",
+          "declaration": {
+            "name": "CharDeviceCapabilities",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharDisplayMode",
+          "declaration": {
+            "name": "CharDisplayMode",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharHostCapabilities",
+          "declaration": {
+            "name": "CharHostCapabilities",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharHostContext",
+          "declaration": {
+            "name": "CharHostContext",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharHostStyles",
+          "declaration": {
+            "name": "CharHostStyles",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharPlatform",
+          "declaration": {
+            "name": "CharPlatform",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharSafeAreaInsets",
+          "declaration": {
+            "name": "CharSafeAreaInsets",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharTheme",
+          "declaration": {
+            "name": "CharTheme",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ConnectOptions",
+          "declaration": {
+            "name": "ConnectOptions",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DevModeConfig",
+          "declaration": {
+            "name": "DevModeConfig",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "TicketAuth",
+          "declaration": {
+            "name": "TicketAuth",
+            "module": "./types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CharAgentShellElement",
+          "declaration": {
+            "name": "CharAgentShellElement",
+            "module": "packages/char/src/shell-component.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "registerCharShell",
+          "declaration": {
+            "name": "registerCharShell",
+            "module": "packages/char/src/shell-component.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "tagName",
+          "declaration": {
+            "name": "CharAgentShellElement",
+            "module": "packages/char/src/shell-component.ts"
+          }
+        }
+      ]
+    }
+  ]
+}