@noodleseed/assistant 1.22.0 → 1.24.0

package/dist/react.d.cts

@@ -1,26 +1,25 @@
 import { ReactElement, RefAttributes } from 'react';
-import { a as AssistantThemeMode } from './appearance-Cc-eqSbp.cjs';
+import { a as AssistantThemeMode } from './appearance-0nS2LFjb.cjs';
 import { AssistantAppearance, AssistantAppearanceWarning, NoodleAssistantElement } from './index.cjs';
-import { c as AssistantClient, d as AssistantViewAvailableDetail, A as AssistantPageContext, a as AssistantContext, e as AssistantModelContextUpdate, f as AssistantClientEvent, g as AssistantErrorDetail } from './client-BZ7xPwfW.cjs';
+import { A as AssistantClient, a as AssistantViewAvailableDetail, b as AssistantPageContext, c as AssistantContext, f as AssistantModelContextUpdate, g as AssistantClientEvent, e as AssistantErrorDetail } from './client-By4gqB1k.cjs';
+import { a as AssistantAppViewErrorDetail } from './app-view-element-DSPtyEul.cjs';
 import 'ai';
 
 interface NoodleAppViewProps {
     readonly client: AssistantClient;
     readonly view: AssistantViewAvailableDetail;
     readonly theme?: 'light' | 'dark';
+    /** Permit App-requested fullscreen presentation. Defaults to inline-only. */
+    readonly allowFullscreen?: boolean;
     readonly className?: string;
-    readonly onError?: (failure: {
-        readonly code: 'view_render_timeout';
-        readonly retryable: false;
-    }) => void;
+    readonly onError?: (failure: AssistantAppViewErrorDetail) => void;
 }
 /**
  * Securely hosts one service-resolved MCP App inside a customer-owned React renderer.
  *
- * The bridge lifetime follows semantic view identity, so ordinary parent rerenders cannot reset an
- * in-progress App interaction.
+ * Compatibility adapter for the framework-neutral `<noodle-app-view>` host.
  */
-declare function NoodleAppView({ client, view, theme, className, onError, }: NoodleAppViewProps): ReactElement;
+declare function NoodleAppView({ client, view, theme, allowFullscreen, className, onError, }: NoodleAppViewProps): ReactElement;
 
 interface NoodleAssistantProps<TPageContext extends AssistantPageContext = AssistantContext> {
     /** In-app mount: the customer backend route that exchanges an embed secret for a session. */

package/dist/react.d.ts

@@ -1,26 +1,25 @@
 import { ReactElement, RefAttributes } from 'react';
-import { a as AssistantThemeMode } from './appearance-Cc-eqSbp.js';
+import { a as AssistantThemeMode } from './appearance-0nS2LFjb.js';
 import { AssistantAppearance, AssistantAppearanceWarning, NoodleAssistantElement } from './index.js';
-import { c as AssistantClient, d as AssistantViewAvailableDetail, A as AssistantPageContext, a as AssistantContext, e as AssistantModelContextUpdate, f as AssistantClientEvent, g as AssistantErrorDetail } from './client-BkJlpN5N.js';
+import { A as AssistantClient, a as AssistantViewAvailableDetail, b as AssistantPageContext, c as AssistantContext, f as AssistantModelContextUpdate, g as AssistantClientEvent, e as AssistantErrorDetail } from './client-Cf38TgwN.js';
+import { a as AssistantAppViewErrorDetail } from './app-view-element-DDtXu08a.js';
 import 'ai';
 
 interface NoodleAppViewProps {
     readonly client: AssistantClient;
     readonly view: AssistantViewAvailableDetail;
     readonly theme?: 'light' | 'dark';
+    /** Permit App-requested fullscreen presentation. Defaults to inline-only. */
+    readonly allowFullscreen?: boolean;
     readonly className?: string;
-    readonly onError?: (failure: {
-        readonly code: 'view_render_timeout';
-        readonly retryable: false;
-    }) => void;
+    readonly onError?: (failure: AssistantAppViewErrorDetail) => void;
 }
 /**
  * Securely hosts one service-resolved MCP App inside a customer-owned React renderer.
  *
- * The bridge lifetime follows semantic view identity, so ordinary parent rerenders cannot reset an
- * in-progress App interaction.
+ * Compatibility adapter for the framework-neutral `<noodle-app-view>` host.
  */
-declare function NoodleAppView({ client, view, theme, className, onError, }: NoodleAppViewProps): ReactElement;
+declare function NoodleAppView({ client, view, theme, allowFullscreen, className, onError, }: NoodleAppViewProps): ReactElement;
 
 interface NoodleAssistantProps<TPageContext extends AssistantPageContext = AssistantContext> {
     /** In-app mount: the customer backend route that exchanges an embed secret for a session. */

package/dist/react.js

@@ -1,10 +1,13 @@
 import {
-  mountAssistantApp,
-  registerNoodleAssistant,
-  unmountAssistantApp,
-  updateAssistantAppTheme
-} from "./chunk-6TT3R555.js";
-import "./chunk-ZPZHPXIQ.js";
+  registerNoodleAssistant
+} from "./chunk-6PVDV7SO.js";
+import {
+  APP_VIEW_TAG_NAME,
+  registerNoodleAppView
+} from "./chunk-5NBHHNI3.js";
+import "./chunk-XKTUXFGX.js";
+import "./chunk-IBDP6PXQ.js";
+import "./chunk-P223CYPO.js";
 import "./chunk-3YYTUJPJ.js";
 import "./chunk-5FUTL2UF.js";
 
@@ -23,48 +26,35 @@ function NoodleAppView({
   client,
   view,
   theme = "light",
+  allowFullscreen = false,
   className,
   onError
 }) {
-  const container = useRef(null);
-  const mounted = useRef(null);
-  const current = useRef({ view, theme, onError });
-  const viewId = view.id;
-  const resourceUri = view.resourceUri;
-  useEffect(() => {
-    current.current = { view, theme, onError };
-  });
+  const elementRef = useRef(null);
+  const onErrorRef = useRef(onError);
+  onErrorRef.current = onError;
   useEffect(() => {
-    const host = container.current;
-    if (!host) return;
-    const initialView = { ...current.current.view, id: viewId, resourceUri };
-    const sandboxUrl = client.appSandboxUrl?.();
-    const card = mountAssistantApp(
-      initialView,
-      {
-        client,
-        sendMessage: (message) => client.sendMessage(message),
-        updateModelContext: (update) => client.updateModelContext(update),
-        theme: current.current.theme
-      },
-      {
-        ...sandboxUrl ? { sandboxUrl } : {},
-        getDetail: () => current.current.view,
-        onRenderFailure: (failure) => current.current.onError?.(failure)
-      }
-    );
-    if (!card) return;
-    mounted.current = card;
-    host.replaceChildren(card);
+    const element = elementRef.current;
+    if (!element) return;
+    const handleError = (event) => {
+      onErrorRef.current?.(event.detail);
+    };
+    element.addEventListener("assistant-error", handleError);
+    registerNoodleAppView();
     return () => {
-      if (mounted.current === card) mounted.current = null;
-      void unmountAssistantApp(card);
+      element.removeEventListener("assistant-error", handleError);
     };
-  }, [client, resourceUri, viewId]);
+  }, []);
   useEffect(() => {
-    if (mounted.current) updateAssistantAppTheme(mounted.current, theme);
-  }, [theme]);
-  return createElement("div", { ref: container, className });
+    const element = elementRef.current;
+    if (!element) return;
+    if (element.client !== client) element.view = void 0;
+    element.allowFullscreen = allowFullscreen;
+    element.client = client;
+    element.theme = theme;
+    element.view = view;
+  }, [allowFullscreen, client, theme, view]);
+  return createElement(APP_VIEW_TAG_NAME, { ref: elementRef, class: className });
 }
 
 // src/react.ts

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react.ts","../src/react-app-view.ts"],"sourcesContent":["import {\n  createElement,\n  forwardRef,\n  type ReactElement,\n  type RefAttributes,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n} from 'react';\nimport type { AssistantThemeMode } from './appearance.js';\nimport type { AssistantAppearance, AssistantAppearanceWarning } from './host-appearance.js';\n\nexport type { AssistantAppearance, AssistantAppearanceWarning } from './host-appearance.js';\n\nimport type {\n  AssistantClientEvent,\n  AssistantContext,\n  AssistantModelContextUpdate,\n  AssistantPageContext,\n} from './client.js';\nimport { type NoodleAssistantElement, registerNoodleAssistant } from './element.js';\nimport type { AssistantErrorDetail } from './transport.js';\n\nexport { NoodleAppView, type NoodleAppViewProps } from './react-app-view.js';\n\nexport interface NoodleAssistantProps<\n  TPageContext extends AssistantPageContext = AssistantContext,\n> {\n  /** In-app mount: the customer backend route that exchanges an embed secret for a session. */\n  readonly sessionEndpoint?: string;\n  /** Public mount: the non-secret embed id `noodle deploy` printed. Exclusive with `sessionEndpoint`. */\n  readonly embedId?: string;\n  /** Only for a dev or self-hosted service; a published page needs no origin. */\n  readonly serviceUrl?: string;\n  readonly theme?: AssistantThemeMode;\n  readonly appearance?: AssistantAppearance;\n  readonly open?: boolean;\n  readonly className?: string;\n  readonly context?: AssistantContext;\n  readonly pageContext?: TPageContext;\n  readonly modelContext?: AssistantModelContextUpdate;\n  readonly onEvent?: (event: AssistantClientEvent) => void;\n  /**\n   * Fires at most once per component instance, when the element's shadow DOM is rendered and its\n   * imperative API (`sendMessage`, `confirmTool`, …) is callable — NOT when a session exists (listen\n   * for the `session_started` client event via `onEvent` for that). It fires whether the element\n   * upgraded before or after this component mounted, and the first callback identity wins: a later\n   * re-render with a different `onReady` is never invoked.\n   */\n  readonly onReady?: () => void;\n  readonly onError?: (error: AssistantErrorDetail) => void;\n  readonly onAppearanceWarning?: (warning: AssistantAppearanceWarning) => void;\n  readonly onSessionExpired?: () => void;\n}\n\nconst NoodleAssistantWithRef = forwardRef<NoodleAssistantElement, NoodleAssistantProps>(\n  function NoodleAssistant(props, forwardedRef): ReactElement {\n    const ref = useRef<NoodleAssistantElement>(null);\n    const readyNotified = useRef(false);\n    useImperativeHandle(forwardedRef, () => ref.current as NoodleAssistantElement, []);\n    useEffect(() => {\n      const element = ref.current;\n      if (!element) return;\n      const ready = () => {\n        if (readyNotified.current) return;\n        readyNotified.current = true;\n        // The one observable breadcrumb for the readiness path: integrators could previously\n        // neither convict nor exonerate this callback for a field failure.\n        console.debug('[noodle-assistant] ready');\n        props.onReady?.();\n      };\n      const error = (event: Event) =>\n        props.onError?.((event as CustomEvent<AssistantErrorDetail>).detail);\n      const expired = () => props.onSessionExpired?.();\n      const assistantEvent = (event: Event) =>\n        props.onEvent?.((event as CustomEvent<AssistantClientEvent>).detail);\n      const appearanceWarning = (event: Event) =>\n        props.onAppearanceWarning?.((event as CustomEvent<AssistantAppearanceWarning>).detail);\n      element.addEventListener('assistant-ready', ready);\n      element.addEventListener('assistant-error', error);\n      element.addEventListener('assistant-session-expired', expired);\n      element.addEventListener('assistant-event', assistantEvent);\n      element.addEventListener('assistant-appearance-warning', appearanceWarning);\n      registerNoodleAssistant();\n      element.sessionEndpoint = props.sessionEndpoint ?? '';\n      element.embedId = props.embedId ?? '';\n      element.serviceUrl = props.serviceUrl ?? '';\n      element.appearance = props.appearance;\n      element.toggleAttribute('open', props.open === true);\n      if (props.context) element.updateContext(props.context);\n      if (props.pageContext) element.updatePageContext(props.pageContext);\n      if (props.modelContext) element.updateModelContext(props.modelContext);\n      // The canonical entry may have registered and upgraded the element before this effect ran.\n      // Readiness is sticky once the shadow root exists, so late React listeners still fire once.\n      if (element.shadowRoot) ready();\n      return () => {\n        element.removeEventListener('assistant-ready', ready);\n        element.removeEventListener('assistant-error', error);\n        element.removeEventListener('assistant-session-expired', expired);\n        element.removeEventListener('assistant-event', assistantEvent);\n        element.removeEventListener('assistant-appearance-warning', appearanceWarning);\n      };\n    }, [\n      props.context,\n      props.appearance,\n      props.modelContext,\n      props.onError,\n      props.onAppearanceWarning,\n      props.onEvent,\n      props.onReady,\n      props.onSessionExpired,\n      props.open,\n      props.pageContext,\n      props.sessionEndpoint,\n      props.embedId,\n      props.serviceUrl,\n    ]);\n    return createElement('noodle-assistant', {\n      ref,\n      class: props.className,\n      ...(props.sessionEndpoint ? { 'session-endpoint': props.sessionEndpoint } : {}),\n      ...(props.embedId ? { 'embed-id': props.embedId } : {}),\n      ...(props.serviceUrl ? { 'service-url': props.serviceUrl } : {}),\n      ...(props.theme ? { theme: props.theme } : {}),\n    });\n  },\n);\n\nexport const NoodleAssistant = NoodleAssistantWithRef as <\n  TPageContext extends AssistantPageContext = AssistantContext,\n>(\n  props: NoodleAssistantProps<TPageContext> & RefAttributes<NoodleAssistantElement>,\n) => ReactElement;\n","import { createElement, type ReactElement, useEffect, useRef } from 'react';\nimport { mountAssistantApp, unmountAssistantApp, updateAssistantAppTheme } from './app-host.js';\nimport type { AssistantClient, AssistantViewAvailableDetail } from './client.js';\n\nexport interface NoodleAppViewProps {\n  readonly client: AssistantClient;\n  readonly view: AssistantViewAvailableDetail;\n  readonly theme?: 'light' | 'dark';\n  readonly className?: string;\n  readonly onError?: (failure: {\n    readonly code: 'view_render_timeout';\n    readonly retryable: false;\n  }) => void;\n}\n\n/**\n * Securely hosts one service-resolved MCP App inside a customer-owned React renderer.\n *\n * The bridge lifetime follows semantic view identity, so ordinary parent rerenders cannot reset an\n * in-progress App interaction.\n */\nexport function NoodleAppView({\n  client,\n  view,\n  theme = 'light',\n  className,\n  onError,\n}: NoodleAppViewProps): ReactElement {\n  const container = useRef<HTMLDivElement>(null);\n  const mounted = useRef<HTMLElement>(null);\n  const current = useRef({ view, theme, onError });\n  const viewId = view.id;\n  const resourceUri = view.resourceUri;\n\n  useEffect(() => {\n    current.current = { view, theme, onError };\n  });\n\n  useEffect(() => {\n    const host = container.current;\n    if (!host) return;\n    const initialView = { ...current.current.view, id: viewId, resourceUri };\n    const sandboxUrl = client.appSandboxUrl?.();\n    const card = mountAssistantApp(\n      initialView,\n      {\n        client,\n        sendMessage: (message) => client.sendMessage(message),\n        updateModelContext: (update) => client.updateModelContext(update),\n        theme: current.current.theme,\n      },\n      {\n        ...(sandboxUrl ? { sandboxUrl } : {}),\n        getDetail: () => current.current.view,\n        onRenderFailure: (failure) => current.current.onError?.(failure),\n      },\n    );\n    if (!card) return;\n    mounted.current = card;\n    host.replaceChildren(card);\n    return () => {\n      if (mounted.current === card) mounted.current = null;\n      void unmountAssistantApp(card);\n    };\n  }, [client, resourceUri, viewId]);\n\n  useEffect(() => {\n    if (mounted.current) updateAssistantAppTheme(mounted.current, theme);\n  }, [theme]);\n\n  return createElement('div', { ref: container, className });\n}\n"],"mappings":"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","names":["createElement","useEffect","useRef","useRef","useEffect","createElement","NoodleAssistant"]}
+{"version":3,"sources":["../src/react.ts","../src/react-app-view.ts"],"sourcesContent":["import {\n  createElement,\n  forwardRef,\n  type ReactElement,\n  type RefAttributes,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n} from 'react';\nimport type { AssistantThemeMode } from './appearance.js';\nimport type { AssistantAppearance, AssistantAppearanceWarning } from './host-appearance.js';\n\nexport type { AssistantAppearance, AssistantAppearanceWarning } from './host-appearance.js';\n\nimport type {\n  AssistantClientEvent,\n  AssistantContext,\n  AssistantModelContextUpdate,\n  AssistantPageContext,\n} from './client.js';\nimport { type NoodleAssistantElement, registerNoodleAssistant } from './element.js';\nimport type { AssistantErrorDetail } from './transport.js';\n\nexport { NoodleAppView, type NoodleAppViewProps } from './react-app-view.js';\n\nexport interface NoodleAssistantProps<\n  TPageContext extends AssistantPageContext = AssistantContext,\n> {\n  /** In-app mount: the customer backend route that exchanges an embed secret for a session. */\n  readonly sessionEndpoint?: string;\n  /** Public mount: the non-secret embed id `noodle deploy` printed. Exclusive with `sessionEndpoint`. */\n  readonly embedId?: string;\n  /** Only for a dev or self-hosted service; a published page needs no origin. */\n  readonly serviceUrl?: string;\n  readonly theme?: AssistantThemeMode;\n  readonly appearance?: AssistantAppearance;\n  readonly open?: boolean;\n  readonly className?: string;\n  readonly context?: AssistantContext;\n  readonly pageContext?: TPageContext;\n  readonly modelContext?: AssistantModelContextUpdate;\n  readonly onEvent?: (event: AssistantClientEvent) => void;\n  /**\n   * Fires at most once per component instance, when the element's shadow DOM is rendered and its\n   * imperative API (`sendMessage`, `confirmTool`, …) is callable — NOT when a session exists (listen\n   * for the `session_started` client event via `onEvent` for that). It fires whether the element\n   * upgraded before or after this component mounted, and the first callback identity wins: a later\n   * re-render with a different `onReady` is never invoked.\n   */\n  readonly onReady?: () => void;\n  readonly onError?: (error: AssistantErrorDetail) => void;\n  readonly onAppearanceWarning?: (warning: AssistantAppearanceWarning) => void;\n  readonly onSessionExpired?: () => void;\n}\n\nconst NoodleAssistantWithRef = forwardRef<NoodleAssistantElement, NoodleAssistantProps>(\n  function NoodleAssistant(props, forwardedRef): ReactElement {\n    const ref = useRef<NoodleAssistantElement>(null);\n    const readyNotified = useRef(false);\n    useImperativeHandle(forwardedRef, () => ref.current as NoodleAssistantElement, []);\n    useEffect(() => {\n      const element = ref.current;\n      if (!element) return;\n      const ready = () => {\n        if (readyNotified.current) return;\n        readyNotified.current = true;\n        // The one observable breadcrumb for the readiness path: integrators could previously\n        // neither convict nor exonerate this callback for a field failure.\n        console.debug('[noodle-assistant] ready');\n        props.onReady?.();\n      };\n      const error = (event: Event) =>\n        props.onError?.((event as CustomEvent<AssistantErrorDetail>).detail);\n      const expired = () => props.onSessionExpired?.();\n      const assistantEvent = (event: Event) =>\n        props.onEvent?.((event as CustomEvent<AssistantClientEvent>).detail);\n      const appearanceWarning = (event: Event) =>\n        props.onAppearanceWarning?.((event as CustomEvent<AssistantAppearanceWarning>).detail);\n      element.addEventListener('assistant-ready', ready);\n      element.addEventListener('assistant-error', error);\n      element.addEventListener('assistant-session-expired', expired);\n      element.addEventListener('assistant-event', assistantEvent);\n      element.addEventListener('assistant-appearance-warning', appearanceWarning);\n      registerNoodleAssistant();\n      element.sessionEndpoint = props.sessionEndpoint ?? '';\n      element.embedId = props.embedId ?? '';\n      element.serviceUrl = props.serviceUrl ?? '';\n      element.appearance = props.appearance;\n      element.toggleAttribute('open', props.open === true);\n      if (props.context) element.updateContext(props.context);\n      if (props.pageContext) element.updatePageContext(props.pageContext);\n      if (props.modelContext) element.updateModelContext(props.modelContext);\n      // The canonical entry may have registered and upgraded the element before this effect ran.\n      // Readiness is sticky once the shadow root exists, so late React listeners still fire once.\n      if (element.shadowRoot) ready();\n      return () => {\n        element.removeEventListener('assistant-ready', ready);\n        element.removeEventListener('assistant-error', error);\n        element.removeEventListener('assistant-session-expired', expired);\n        element.removeEventListener('assistant-event', assistantEvent);\n        element.removeEventListener('assistant-appearance-warning', appearanceWarning);\n      };\n    }, [\n      props.context,\n      props.appearance,\n      props.modelContext,\n      props.onError,\n      props.onAppearanceWarning,\n      props.onEvent,\n      props.onReady,\n      props.onSessionExpired,\n      props.open,\n      props.pageContext,\n      props.sessionEndpoint,\n      props.embedId,\n      props.serviceUrl,\n    ]);\n    return createElement('noodle-assistant', {\n      ref,\n      class: props.className,\n      ...(props.sessionEndpoint ? { 'session-endpoint': props.sessionEndpoint } : {}),\n      ...(props.embedId ? { 'embed-id': props.embedId } : {}),\n      ...(props.serviceUrl ? { 'service-url': props.serviceUrl } : {}),\n      ...(props.theme ? { theme: props.theme } : {}),\n    });\n  },\n);\n\nexport const NoodleAssistant = NoodleAssistantWithRef as <\n  TPageContext extends AssistantPageContext = AssistantContext,\n>(\n  props: NoodleAssistantProps<TPageContext> & RefAttributes<NoodleAssistantElement>,\n) => ReactElement;\n","import { createElement, type ReactElement, useEffect, useRef } from 'react';\nimport {\n  APP_VIEW_TAG_NAME,\n  type AssistantAppViewErrorDetail,\n  type NoodleAppViewElement,\n  registerNoodleAppView,\n} from './app-view.js';\nimport type { AssistantClient, AssistantViewAvailableDetail } from './client.js';\n\nexport interface NoodleAppViewProps {\n  readonly client: AssistantClient;\n  readonly view: AssistantViewAvailableDetail;\n  readonly theme?: 'light' | 'dark';\n  /** Permit App-requested fullscreen presentation. Defaults to inline-only. */\n  readonly allowFullscreen?: boolean;\n  readonly className?: string;\n  readonly onError?: (failure: AssistantAppViewErrorDetail) => void;\n}\n\n/**\n * Securely hosts one service-resolved MCP App inside a customer-owned React renderer.\n *\n * Compatibility adapter for the framework-neutral `<noodle-app-view>` host.\n */\nexport function NoodleAppView({\n  client,\n  view,\n  theme = 'light',\n  allowFullscreen = false,\n  className,\n  onError,\n}: NoodleAppViewProps): ReactElement {\n  const elementRef = useRef<NoodleAppViewElement>(null);\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n\n  useEffect(() => {\n    const element = elementRef.current;\n    if (!element) return;\n    const handleError = (event: Event) => {\n      onErrorRef.current?.((event as CustomEvent<AssistantAppViewErrorDetail>).detail);\n    };\n    element.addEventListener('assistant-error', handleError);\n    registerNoodleAppView();\n    return () => {\n      element.removeEventListener('assistant-error', handleError);\n    };\n  }, []);\n\n  useEffect(() => {\n    const element = elementRef.current;\n    if (!element) return;\n    if (element.client !== client) element.view = undefined;\n    element.allowFullscreen = allowFullscreen;\n    element.client = client;\n    element.theme = theme;\n    element.view = view;\n  }, [allowFullscreen, client, theme, view]);\n\n  return createElement(APP_VIEW_TAG_NAME, { ref: elementRef, class: className });\n}\n"],"mappings":"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","names":["createElement","useEffect","useRef","useRef","useEffect","createElement","NoodleAssistant"]}

package/dist/server.d.cts

@@ -1,4 +1,4 @@
-import { A as AssistantConfiguration } from './appearance-Cc-eqSbp.cjs';
+import { A as AssistantConfiguration } from './appearance-0nS2LFjb.cjs';
 
 interface AssistantSessionExchangeBase {
     readonly serviceUrl: string;

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { A as AssistantConfiguration } from './appearance-Cc-eqSbp.js';
+import { A as AssistantConfiguration } from './appearance-0nS2LFjb.js';
 
 interface AssistantSessionExchangeBase {
     readonly serviceUrl: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@noodleseed/assistant",
-  "version": "1.22.0",
-  "description": "Embed the Noodle Seed customer-branded assistant in your web app with a Web Component, managed or custom React UI, DOM-free client, and backend session helper. Authoring and deploying the server is @noodleseed/one.",
+  "version": "1.24.0",
+  "description": "Embed the Noodle Seed customer-branded assistant in your web app with managed or framework-owned UI, a framework-neutral MCP App host, a DOM-free client, and a backend session helper. Authoring and deploying the server is @noodleseed/one.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -26,6 +26,17 @@
       },
       "default": "./dist/index.js"
     },
+    "./app-view": {
+      "import": {
+        "types": "./dist/app-view.d.ts",
+        "default": "./dist/app-view.js"
+      },
+      "require": {
+        "types": "./dist/app-view.d.cts",
+        "default": "./dist/app-view.cjs"
+      },
+      "default": "./dist/app-view.js"
+    },
     "./client": {
       "import": {
         "types": "./dist/client.d.ts",
@@ -103,6 +114,9 @@
   "module": "./dist/index.js",
   "typesVersions": {
     "*": {
+      "app-view": [
+        "./dist/app-view.d.ts"
+      ],
       "react": [
         "./dist/react.d.ts"
       ],