@flamingo-stack/openframe-frontend-core 0.0.346 → 0.0.347-snapshot.20260630182958

package/src/components/chat/.embeddable-chat.md

@@ -45,4 +45,37 @@ Portable, lib-safe port of the hub's `<GlobalAskAI>` chat panel component, decou
 | `useAuth()` | `useRequiredChatRuntime().user` |
 | `currentPlatform()` | `useRequiredChatRuntime().source` |
 | `useNavLink` / `NavLinkAnchor` | `handleChatNavClick` + `NavLinkAnchorViaRuntime` |
-| `useDocChat(source)` | `useSseChatAdapter()` (source from runtime) |
+| `useDocChat(source)` | `useSseChatAdapter()` (source from runtime) |
+## Agent mode (OpenFrame AI agents — Fae / Mingo)
+
+Reuse the SAME `<EmbeddableChat>` to render a global OpenFrame AI agent. No new
+component, no agent-specific render path — an "agent mode" just OVERRIDES the
+empty-state URL so the chat fetches the agent's display config (greeting +
+suggested prompts + source chips) from the public `/api/ai-agents/[slug]`
+endpoint, which is byte-compatible with the `EmptyStateConfig` wire shape
+(`{ greeting, suggestedQueries, enabledRagTableIds }`).
+
+- Pass `activeAgentSlug` (e.g. `"fae"`) to `<EmbeddableChat>`. **Works in BOTH
+  regular (host) and embedded modes** — there is no navigation-mode gate.
+
+```tsx
+<EmbeddableChat activeAgentSlug="fae" />
+```
+
+**Default routes, fully overridable.** Agent mode works with ZERO endpoint
+wiring — the component falls back to a built-in default route. Resolution order
+for the agent display-config route (highest → lowest precedence):
+
+1. `aiAgentConfigUrl` prop on `<EmbeddableChat>` (per-mount override)
+2. `runtime.endpoints.aiAgentConfigUrl(slug)` (shared runtime override)
+3. built-in default `` (slug) => `/api/ai-agents/${encodeURIComponent(slug)}` ``
+
+Same-origin embedders need nothing; cross-origin embedders behind a proxy set
+`runtime.endpoints.aiAgentConfigUrl` (or the prop) to their absolute proxied
+path. Every other chat route (`chatStreamUrl`, `commandsUrl`, …) comes from
+`runtime.endpoints` and is likewise overridable.
+
+DISPLAY-ONLY this phase: retrieval still resolves server-side from the platform
+(the chat route derives `source` from the deployment, not the client) — the
+agent customizes the greeting + suggested-prompt chips, not the corpus. In mingo
+mode, `mingoWelcome` still owns its own welcome surface.

package/src/components/chat/embeddable-chat.tsx

@@ -209,6 +209,33 @@ export interface EmbeddableChatProps {
   /** Controlled active-mode change handler. Required when `activeMode` is set. */
   onActiveModeChange?: (mode: ChatMode) => void
 
+  /**
+   * OpenFrame AI agent mode — render a global agent (e.g. `'fae'`, `'mingo'`).
+   * Works in BOTH regular (host) AND embedded modes. When set, the chat fetches
+   * that agent's display config (greeting + suggested prompts) instead of the
+   * platform empty-state — the "agent mode" URL override. DISPLAY-only this
+   * phase: retrieval still resolves server-side from the platform. Optional;
+   * unset = today's behavior.
+   *
+   * Route resolution (highest → lowest precedence):
+   *   1. `aiAgentConfigUrl` prop (below)
+   *   2. `runtime.endpoints.aiAgentConfigUrl`
+   *   3. the component's built-in default (`/api/ai-agents/<slug>`)
+   * So agent mode works with ZERO wiring, yet every route stays overridable.
+   */
+  activeAgentSlug?: string
+
+  /** Optional agent switcher callback (host renders the agent picker UI). */
+  onAgentChange?: (slug: string) => void
+
+  /**
+   * Per-component override for the agent display-config route. Highest
+   * precedence (over `runtime.endpoints.aiAgentConfigUrl` and the built-in
+   * default). Lets a single embed point a specific agent at a custom/proxied
+   * endpoint without changing the shared runtime. Optional.
+   */
+  aiAgentConfigUrl?: (slug: string) => string
+
   /**
    * Initial active mode for uncontrolled mode. Ignored when `activeMode`
    * is set. Defaults to `'guide'` when `modes.guide` is configured,
@@ -338,6 +365,16 @@ const mentionTokenOf = (key: string, markerByType: Map<string, string>): string
  */
 const FALLBACK_TOP_RETRIEVED = 3
 
+/**
+ * Built-in default route for an OpenFrame AI agent's display config — the
+ * lowest-precedence fallback so "agent mode" works with ZERO endpoint wiring.
+ * Overridden by `runtime.endpoints.aiAgentConfigUrl` or the `aiAgentConfigUrl`
+ * prop. Same-origin relative path (works for host + same-origin embeds);
+ * cross-origin embedders behind a proxy override with their absolute path.
+ */
+const DEFAULT_AI_AGENT_CONFIG_URL = (slug: string): string =>
+  `/api/ai-agents/${encodeURIComponent(slug)}`
+
 /**
  * Per-row width palette for the empty-state skeleton stack. Cycled
  * by index so each render is deterministic (no jitter between
@@ -720,6 +757,9 @@ function EmbeddableChatInner({
   mingoDialogCapabilities,
   activeMode: controlledActiveMode,
   onActiveModeChange,
+  activeAgentSlug,
+  onAgentChange: _onAgentChange,
+  aiAgentConfigUrl: aiAgentConfigUrlProp,
   defaultActiveMode,
   shell = 'drawer',
   mingoWelcome,
@@ -956,9 +996,26 @@ function EmbeddableChatInner({
   // hits the endpoint. Cached with `staleTime/gcTime: Infinity` inside the hook,
   // so toggling to Guide or reopening the (remounting) drawer reads from cache
   // — NOT a request per open.
-  const emptyStateUrl = runtime.endpoints.emptyStateUrl
+  // Agent-mode URL override: when an OpenFrame agent is selected, point the
+  // empty-state fetch at the agent's display-config endpoint (byte-compatible
+  // EmptyStateConfig shape) instead of the platform `emptyStateUrl`. Works in
+  // BOTH host and embed mode (no navigation-mode gate). Route precedence:
+  //   prop `aiAgentConfigUrl` → runtime endpoint → built-in default
+  // so agent mode functions with zero wiring yet stays fully overridable. The
+  // single `emptyStateUrl` var below feeds BOTH the fetch AND the downstream
+  // `emptyStateUrl ? fetched : prop` discriminator, so no other code changes.
+  const resolveAgentConfigUrl =
+    aiAgentConfigUrlProp ?? runtime.endpoints.aiAgentConfigUrl ?? DEFAULT_AI_AGENT_CONFIG_URL
+  const agentConfigUrl = activeAgentSlug ? resolveAgentConfigUrl(activeAgentSlug) : undefined
+  const emptyStateUrl = agentConfigUrl ?? runtime.endpoints.emptyStateUrl
+  // Widen the fetch gate so a selected agent's display loads regardless of the
+  // guide/mingo active mode (the platform empty-state stays Guide-only).
+  // `MingoWelcome` still owns its own surface in mingo mode — this just warms
+  // the agent config so greeting/suggested prompts are ready.
   const { config: emptyStateConfig, loading: emptyStateLoading } =
-    useEmptyStateConfig(emptyStateUrl, { enabled: activeMode === 'guide' })
+    useEmptyStateConfig(emptyStateUrl, {
+      enabled: activeMode === 'guide' || !!activeAgentSlug,
+    })
   // Resolution: fetched (when `emptyStateUrl` set) → explicit prop → default.
   // `greeting` is null-unambiguous so `??` chains cleanly; the arrays use
   // `emptyStateUrl` as the discriminator because `[]` is a legitimate fetched

package/src/contexts/chat-runtime-context.tsx

@@ -81,6 +81,15 @@ export interface ChatRuntime {
      *  unset, the chat falls back to the explicit `emptyStateGreeting` /
      *  `suggestedQueries` / `enabledRagTableIds` props (or in-code defaults). */
     emptyStateUrl?: string
+    /** Build the per-agent display-config URL for an OpenFrame AI agent
+     *  (Fae/Mingo). OPTIONAL. The returned endpoint MUST be byte-compatible
+     *  with the empty-state wire shape ({ greeting, suggestedQueries,
+     *  enabledRagTableIds }). When set AND `EmbeddableChat` receives an
+     *  `activeAgentSlug` in embed mode, the chat fetches THIS url instead of
+     *  `emptyStateUrl` to render the selected agent's greeting + suggested
+     *  prompts (the "agent mode" URL override). Hub: `(slug) =>
+     *  '/api/ai-agents/' + encodeURIComponent(slug)`. */
+    aiAgentConfigUrl?: (slug: string) => string
     /** Build entity-card list URL for a content type + ids. Hub delegates
      *  to the rag-table-config registry; embedded app provides its own
      *  per-type URL builder against the reverse proxy. Returns null when

package/src/stories/AnnouncementBar.stories.tsx

@@ -40,8 +40,7 @@ const baseAnnouncement: Announcement = {
   title: 'New Feature Released',
   description: 'Check out our latest updates and improvements to the platform.',
   background_color: '#FFD951',
-  icon_type: 'svg',
-  icon_svg_name: 'rocket',
+  icon_name: 'rocket',
   platform_id: 'openframe',
   is_active: true,
   created_at: now,
@@ -95,12 +94,12 @@ export const WithCTA: Story = {
         title: 'OpenFrame v2.0 is here!',
         description: 'Explore the new dashboard, improved device management, and more.',
         background_color: '#FFD951',
-        icon_svg_name: 'star',
+        icon_name: 'star',
         cta_enabled: true,
         cta_text: 'Learn More',
         cta_url: 'https://example.com',
         cta_target: '_blank',
-        cta_icon: 'rocket',
+        cta_icon_name: 'rocket',
         cta_show_icon: true,
         cta_button_background_color: '#1A1A1A',
         cta_button_text_color: '#FFFFFF',
@@ -122,7 +121,7 @@ export const WithCTASameTab: Story = {
         title: 'Scheduled Maintenance',
         description: 'We will perform maintenance on Saturday from 2:00 AM to 4:00 AM UTC.',
         background_color: '#FFE082',
-        icon_svg_name: 'info',
+        icon_name: 'info',
         cta_enabled: true,
         cta_text: 'View Status',
         cta_url: '/status',
@@ -145,7 +144,7 @@ export const BlueBackground: Story = {
         title: 'Join our Community',
         description: 'Connect with other MSPs and share best practices.',
         background_color: '#60A5FA',
-        icon_svg_name: 'megaphone',
+        icon_name: 'megaphone',
       })
       return <Story />
     },
@@ -164,7 +163,7 @@ export const GreenBackground: Story = {
         title: 'All Systems Operational',
         description: 'Everything is running smoothly. No issues detected.',
         background_color: '#86EFAC',
-        icon_svg_name: 'bell',
+        icon_name: 'bell',
       })
       return <Story />
     },
@@ -183,7 +182,7 @@ export const WithOpenFrameLogo: Story = {
         title: 'Welcome to OpenFrame',
         description: 'Your open-source IT infrastructure management platform.',
         background_color: '#FFD951',
-        icon_svg_name: 'openframe-logo',
+        icon_name: 'openframe-logo',
         cta_enabled: true,
         cta_text: 'Get Started',
         cta_url: '/getting-started',
@@ -208,8 +207,7 @@ export const WithPNGIcon: Story = {
         title: 'Partner Program Launch',
         description: 'Become an OpenFrame certified partner and grow your business.',
         background_color: '#C4B5FD',
-        icon_type: 'png',
-        icon_png_url: 'https://placehold.co/32x32/1a1a1a/white?text=OF',
+        icon_url: 'https://placehold.co/32x32/1a1a1a/white?text=OF',
       })
       return <Story />
     },
@@ -229,7 +227,7 @@ export const LongContent: Story = {
         description:
           'This is an extremely long description that goes into great detail about the announcement. It should be truncated on the desktop view and hidden on mobile view to keep the bar compact and readable.',
         background_color: '#FCA5A5',
-        icon_svg_name: 'info',
+        icon_name: 'info',
         cta_enabled: true,
         cta_text: 'Read Full Announcement',
         cta_url: '/announcements/long',

package/src/types/announcement.ts

@@ -2,26 +2,23 @@
 import type { LegacyPlatform, PlatformFilter, PlatformRecord } from './platform';
 
 // For backward compatibility, maintain the old Platform type temporarily
-export type IconType = 'svg' | 'png';
-
 // Database Models
 export interface Announcement {
   id: string;
   title: string;
   description: string;
   background_color: string;
-  icon_type: IconType;
-  icon_svg_name?: string;
-  icon_png_url?: string;
+  icon_name?: string;
+  icon_url?: string;
   /** Extra props for the main bar/icon */
-  icon_svg_props?: Record<string, any>;
+  icon_props?: Record<string, any>;
   platform_id: string;  // Foreign key to platforms table
   platform?: PlatformRecord;  // Joined platform data
   is_active: boolean;
   // CTA (Call-To-Action) fields
   cta_enabled?: boolean;
   cta_text?: string;
-  cta_icon?: string;
+  cta_icon_name?: string;
   cta_show_icon?: boolean;
   cta_url?: string;
   cta_target?: '_self' | '_blank';
@@ -57,17 +54,16 @@ export interface CreateAnnouncementData {
   title: string;
   description: string;
   background_color: string;
-  icon_type: IconType;
-  icon_svg_name?: string;
-  icon_png_url?: string;
+  icon_name?: string;
+  icon_url?: string;
   /** Extra props for the main bar/icon */
-  icon_svg_props?: Record<string, any>;
+  icon_props?: Record<string, any>;
   platforms?: string[];  // entity_platforms set (multi-select)
   is_active?: boolean;
   // CTA (Call-To-Action) fields
   cta_enabled?: boolean;
   cta_text?: string;
-  cta_icon?: string;
+  cta_icon_name?: string;
   cta_show_icon?: boolean;
   cta_url?: string;
   cta_target?: '_self' | '_blank';
@@ -81,17 +77,16 @@ export interface UpdateAnnouncementData {
   title?: string;
   description?: string;
   background_color?: string;
-  icon_type?: IconType;
-  icon_svg_name?: string;
-  icon_png_url?: string;
+  icon_name?: string;
+  icon_url?: string;
   /** Extra props for the main bar/icon */
-  icon_svg_props?: Record<string, any>;
+  icon_props?: Record<string, any>;
   platforms?: string[];  // entity_platforms set (multi-select)
   is_active?: boolean;
   // CTA (Call-To-Action) fields
   cta_enabled?: boolean;
   cta_text?: string;
-  cta_icon?: string;
+  cta_icon_name?: string;
   cta_show_icon?: boolean;
   cta_url?: string;
   cta_target?: '_self' | '_blank';
@@ -123,15 +118,14 @@ export interface AnnouncementFormData {
   title: string;
   description: string;
   background_color: string;
-  icon_type: IconType;
-  icon_svg_name: string;
-  icon_png_file?: File;
+  icon_name: string;
+  icon_url?: string;
   platforms: string[];  // entity_platforms set (multi-select; no single platform_id)
   is_active: boolean;
   // CTA (Call-To-Action) fields
   cta_enabled: boolean;
   cta_text: string;
-  cta_icon: string;
+  cta_icon_name: string;
   cta_show_icon: boolean;
   cta_url: string;
   cta_target: '_self' | '_blank';
@@ -140,7 +134,7 @@ export interface AnnouncementFormData {
   cta_button_text_color?: string;
   cta_icon_props?: string; // JSON string in form
   /** Extra props for the main bar/icon */
-  icon_svg_props?: string;
+  icon_props?: string;
 }
 
 // API Query Parameters
@@ -197,7 +191,7 @@ export interface AnnouncementValidation {
     required: boolean;
     pattern: RegExp;
   };
-  icon_svg_name: {
+  icon_name: {
     required: boolean;
     validOptions: string[];
   };

package/src/types/supabase.ts

@@ -56,9 +56,8 @@ export type Database = {
           created_at: string | null
           created_by: string | null
           description: string
-          icon_png_url: string | null
-          icon_svg_name: string | null
-          icon_type: string | null
+          icon_url: string | null
+          icon_name: string | null
           id: string
           is_active: boolean | null
           title: string
@@ -69,9 +68,8 @@ export type Database = {
           created_at?: string | null
           created_by?: string | null
           description: string
-          icon_png_url?: string | null
-          icon_svg_name?: string | null
-          icon_type?: string | null
+          icon_url?: string | null
+          icon_name?: string | null
           id?: string
           is_active?: boolean | null
           title: string
@@ -82,9 +80,8 @@ export type Database = {
           created_at?: string | null
           created_by?: string | null
           description?: string
-          icon_png_url?: string | null
-          icon_svg_name?: string | null
-          icon_type?: string | null
+          icon_url?: string | null
+          icon_name?: string | null
           id?: string
           is_active?: boolean | null
           title?: string

package/dist/chunk-2FI3USTC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/contexts/endpoints-runtime-context.tsx","../src/contexts/chat-runtime-context.tsx"],"sourcesContent":["'use client'\n\n/**\n * Endpoints runtime — sibling of ChatRuntime. Carries the API path\n * literals consumed by oss-lib components/hooks/utils so a host\n * application can override them (e.g. when running behind a reverse\n * proxy as `user1.openframe.ai` → `/api/mingo-guide/*`).\n *\n * The hub mounts `<HubRuntimeProvider>` at root with the\n * canonical hub paths; an embedded app mounts its own provider with\n * remapped paths. The pattern mirrors ChatRuntimeContext exactly:\n *\n *   - `useEndpointsRuntime()` returns null when no provider is mounted.\n *     For optional consumers that should gracefully no-op without one.\n *   - `useRequiredEndpointsRuntime()` throws on missing provider — for\n *     hooks/components that cannot function without endpoints.\n *\n * IMPORTANT for embedders: memoize the value passed to\n * `<EndpointsRuntimeContext.Provider value={...}>` (e.g. React.useMemo).\n * Reference changes invalidate downstream effect dependency arrays and\n * trigger unnecessary re-fetches.\n */\n\nimport { createContext, useContext } from 'react'\n\nexport interface EndpointsRuntime {\n  /** GET active announcement (used by `<AnnouncementBar>` polling). */\n  announcementsUrl: string\n  accessCode: {\n    /** POST validate access code. */\n    validateUrl: string\n    /** POST consume / redeem access code after registration. */\n    consumeUrl: string\n  }\n  /** POST contact-form submission. */\n  contactUrl: string\n}\n\nexport const EndpointsRuntimeContext = createContext<EndpointsRuntime | null>(null)\n\n/**\n * Optional read — returns null when no provider is mounted. Use for\n * surfaces that should silently skip the fetch (e.g. announcement\n * polling on a page rendered outside the provider tree).\n */\nexport function useEndpointsRuntime(): EndpointsRuntime | null {\n  return useContext(EndpointsRuntimeContext)\n}\n\n/**\n * Strict variant — throws on missing provider. Use for consumers that\n * cannot function without an endpoint (form submission, code\n * validation). In tests/Storybook, wrap with the hub's\n * `<HubRuntimeProvider>` or a stub\n * `<EndpointsRuntimeContext.Provider value={mockedEndpoints}>`.\n */\nexport function useRequiredEndpointsRuntime(): EndpointsRuntime {\n  const v = useContext(EndpointsRuntimeContext)\n  if (!v) {\n    throw new Error(\n      '[endpoints-runtime] hook called outside an <EndpointsRuntimeContext.Provider>. ' +\n        'Hub: mount <HubRuntimeProvider> in your providers tree. ' +\n        'Embedded app: mount your own provider with proxied URLs at the tree root. ' +\n        'Tests/Storybook: wrap render() in <EndpointsRuntimeContext.Provider value={mocked}>.',\n    )\n  }\n  return v\n}\n","'use client'\n\n/**\n * Chat runtime context — single seam for embedding the chat panel in a\n * different host (e.g. user1.openframe.ai reverse-proxying API calls\n * under /api/mingo-guide/* to hub.openframe.ai/api/*).\n *\n * Three concerns, one context:\n *   1. API endpoints: chatStreamUrl / approvalToolUrl / commandsUrl /\n *      buildListUrl + attachment endpoints + chat-identity. The chat\n *      reads them from runtime; hub vs embedded app supply different\n *      strings via different providers.\n *   2. Navigation mode + callbacks: 'host' or 'embed' mode. Host wires\n *      its own router/docNav via the optional `navigate` callback\n *      (plain function, NOT a hook); embed forces new-tab via\n *      `defaultContentOrigin` + lib's `resolveExternalNavigation`.\n *   3. Identity context: only `source` (required for localStorage\n *      namespacing). The display identity (greeting first-name etc.)\n *      comes from the server via `useChatIdentity()` — never injected\n *      client-side, so it always matches the server-resolved auth.\n *\n * Sibling of EndpointsRuntimeContext (announcement bar, contact form,\n * access codes). Each runtime stays an independent React context so\n * embedders can opt into either feature without forcing the other.\n *\n * IMPORTANT for embedders: memoize the value passed to\n * `<ChatRuntimeContext.Provider value={...}>` (e.g. via React.useMemo).\n * Every change to its reference identity invalidates downstream\n * `useMemo` consumers (the chat input's slash-commands binding,\n * useNavLink's embed-resolution memo, useDocChat's streamFn factory).\n * The hub's `<HubRuntimeProvider>` already memoizes correctly with\n * stable deps. Embedded apps that build the value inline on each render\n * will pay an avoidable re-render cost across the entire chat tree.\n */\n\nimport { createContext, useContext, type ReactNode } from 'react'\n\nimport type { ComposeContentUrl } from '../utils/content-href'\n\n/**\n * Runtime config consumed by the chat panel.\n */\nexport interface ChatRuntime {\n  endpoints: {\n    /** POST streaming chat. Hub: '/api/docs/chat'. */\n    chatStreamUrl: string\n    /** POST agent approve/reject. Hub: '/api/chat/agent/confirm-tool'. */\n    approvalToolUrl: string\n    /** Customer-ticket agent endpoints (Help Center). OPTIONAL — when unset,\n     *  the ticket hooks fall back to the bare hub paths\n     *  (`/api/chat/agent/{find-ticket,ticket-action,list-engagements}`).\n     *  Embedders behind a reverse proxy set these to their proxied paths\n     *  (e.g. `/content/api/chat/agent/...`) so tickets route through the SAME\n     *  endpoint config + proxy as every other endpoint. */\n    findTicketUrl?: string\n    ticketActionUrl?: string\n    listEngagementsUrl?: string\n    /** GET slash-command catalog. Hub: '/api/docs/commands'. */\n    commandsUrl: string\n    /** GET RAG-search endpoint behind `<DocSearchBar>` (the in-source search\n     *  bar mounted by `<DocViewer>` / `<DocsHubPage>` when `showAIChat` is on).\n     *  Hub: '/api/docs/search'. OPTIONAL — falls back to the hub path so\n     *  same-origin Next.js hosts don't need to set it. Cross-origin embedders\n     *  set their proxied path so the search bar routes through the same\n     *  reverse proxy as everything else. Same pattern as `findTicketUrl`. */\n    docsSearchUrl?: string\n    /** POST internal-link resolver. The in-source markdown renderer (lib or\n     *  custom) calls `<DocViewer>`'s `handlers.onResolveLink(href, currentPath)`\n     *  for relative hrefs like `./getting-started/intro.md` — that callback\n     *  posts to this URL with `{ link, currentPath, source }` and expects a\n     *  `ResolveLinkResult` back. Hub: '/api/docs/resolve-link'. OPTIONAL — same\n     *  fall-back chain as `docsSearchUrl`: prop override → runtime → default. */\n    docsResolveLinkUrl?: string\n    /** GET per-platform empty-state config (admin-edited in\n     *  `/admin/chat-config`): `{ greeting, enabledRagTableIds, suggestedQueries }`.\n     *  Hub: '/api/docs/empty-state'. OPTIONAL — the in-app (host-mode) chat\n     *  injects these values as SSR props instead, so it leaves this unset.\n     *  Cross-origin EMBEDDERS (no server hop) set it to their proxied path\n     *  (e.g. '/content/api/docs/empty-state') so `<EmbeddableChat>` can fetch\n     *  the greeting / quick-action chips / RAG-source filter at runtime. When\n     *  unset, the chat falls back to the explicit `emptyStateGreeting` /\n     *  `suggestedQueries` / `enabledRagTableIds` props (or in-code defaults). */\n    emptyStateUrl?: string\n    /** Build entity-card list URL for a content type + ids. Hub delegates\n     *  to the rag-table-config registry; embedded app provides its own\n     *  per-type URL builder against the reverse proxy. Returns null when\n     *  the type has no list endpoint (caller skips rendering). */\n    buildListUrl: (type: string, ids: string[]) => string | null\n    /** Chat-attachment endpoints — added for the v2 attachment feature.\n     *\n     *  Three concerns:\n     *    - `attachmentUploadUrl` — POSTed by the chat-attachment hook\n     *      to mint a Supabase signed-upload-URL + HMAC view token.\n     *    - `attachmentViewUrlPrefix` — embedded in markdown URLs the\n     *      chat hosts in user message bubbles (`![]()` / `[Attached]`).\n     *      Stored in chat history; chosen at SEND time. In host mode the\n     *      relative `/api/storage/view/chat-attachments/` is sufficient\n     *      (same-origin); embedders supply an absolute hub URL so the\n     *      browser can fetch cross-origin.\n     *    - `identityUrl` — GET endpoint the `useChatIdentity` hook\n     *      hits to learn the `{authTier, source, attachmentsEnabled}`\n     *      capability bag for the current session. Used beyond chat\n     *      (tickets / contact form / any embedded surface that needs\n     *      to identify the proxied customer), so the name has no\n     *      \"chat\" prefix even though the consuming hook still does. */\n    attachmentUploadUrl: string\n    attachmentViewUrlPrefix: string\n    identityUrl: string\n    /** Optional URL prefix for the image proxy (`<prefix>?url=<external>`).\n     *  When unset, lib's `getProxiedImageUrl` returns the original URL\n     *  unchanged. Hub default: '/api/image-proxy'. Embedders that don't\n     *  host an image-proxy route leave this undefined → images load\n     *  directly cross-origin (CORS-permitting). */\n    imageProxyUrlPrefix?: string\n    /** Optional list of hostnames that should bypass the image proxy\n     *  (rendered direct). Hub uses ['openmsp.ai']; embedders typically\n     *  leave it unset. Matches the `skipDomains` parameter of\n     *  `getProxiedImageUrl`. */\n    imageProxySkipDomains?: string[]\n    /** Optional base URL for the branded og-placeholder image route — the\n     *  DEFAULT cover-image fallback for entity cards with no image. The lib\n     *  appends `?title=…` (+ `w`/`h` for square slots) itself, so this is\n     *  the base, NOT a full URL: relative (`/api/og-placeholder`) for same-\n     *  origin hosts, or the proxied path (`/content/api/og-placeholder`) for\n     *  cross-origin embedders. May carry baked-in query params (preserved when\n     *  the lib layers `title`/dimensions on top) — but per-platform brand\n     *  colors are NO LONGER baked here; the `/api/og-placeholder` route\n     *  resolves them server-side from the platform. Most hosts leave this unset\n     *  and let the lib derive the base from `imageProxyUrlPrefix`.\n     *\n     *  OPTIONAL — when unset the lib derives the base from the sibling\n     *  `imageProxyUrlPrefix` (same API base, route name swapped), then falls\n     *  back to the relative `/api/og-placeholder`. So an embedder that already\n     *  proxies images needs NO og-placeholder wiring. See\n     *  `resolveOgPlaceholderBase` / `buildOgPlaceholderUrl` in `../utils`. */\n    ogPlaceholderUrl?: string\n    /** Supabase storage origin (e.g. `https://xyz.supabase.co`) — used\n     *  by `useVideoWarmup` to scope the `<link rel=\"preload\" as=\"video\">`\n     *  hint to MP4s the deployment actually hosts. Hub wires it via\n     *  `getSupabaseStorageOrigin()`; embedders without a Supabase\n     *  storage origin leave it unset (preload is then skipped; Mux/\n     *  YouTube preconnect still fires). */\n    supabaseStorageOrigin?: string\n  }\n  navigation: {\n    /** ONE knob, two behaviors:\n     *  - 'host' = use the host page's existing click-routing untouched.\n     *    The chat panel calls `navigate?.()` for in-app routing.\n     *  - 'embed' = guest inside another app: short-circuit at the top\n     *    of click handlers to force new-tab + absolutize via\n     *    resolveExternalNavigation. */\n    mode: 'host' | 'embed'\n    /** Embed-only fallback origin for relative URLs whose target platform\n     *  can't be inferred. Used by resolveExternalNavigation when\n     *  `targetPlatform` is null — without this, a relative `/foo` href would\n     *  window.open against the embedder's origin, which is WRONG.\n     *  Set to your content host (e.g. 'https://hub.openframe.ai').\n     *  Required by the embedded app whenever mode='embed'. */\n    defaultContentOrigin?: string\n    /** Override for opening external URLs. MUST BE SYNCHRONOUS —\n     *  Safari/Firefox block popups opened outside a direct user gesture.\n     *  Default: window.open(href, '_blank', 'noopener,noreferrer'). */\n    openExternal?: (href: string) => void\n    /** Optional in-app navigation callback (host-mode only).\n     *  Returns `true` if the host handled the click in-app\n     *  (router.push + docNav.navigate); returns `false`, `undefined`,\n     *  or `void` → lib falls back to window.location.assign(href).\n     *  Hub wires this via HubRuntimeProvider's HubNavigationWiring;\n     *  embedders not in Next.js leave it undefined. */\n    navigate?: (input: { href: string; path?: string | null; targetPlatform?: string | null }) => boolean | void\n    /** Optional new-tab decision callback. Returns true → lib opens in\n     *  new tab; false → same tab via `navigate`. Hub wires the existing\n     *  `decideNewTab` logic from use-nav-link.tsx (re-imports the pure\n     *  helper from lib). Embedders may omit; lib defaults to:\n     *  same-origin/same-platform → same tab, else new tab. */\n    decideNewTab?: (args: { href: string; targetPlatform?: string | null }) => boolean\n  }\n  /** Optional content-URL composer. Returns the platform-aware href +\n   *  target-platform tuple for a content entity. Hub wires this to its\n   *  `buildContentURL(type, slug, extractPrimaryPlatform(platforms))`\n   *  pipeline so the lib catalog/detail views can derive cross-\n   *  platform hrefs without knowing the hub's platform topology\n   *  (openmsp.ai / openframe.app / flamingo.run / tmcg).\n   *\n   *  THE single content-href authority for every embeddable surface — page\n   *  views (onboarding catalog/detail, releases) AND chat cards / chips /\n   *  search results all resolve content links through this one seam, so a\n   *  given type lands in the SAME place regardless of where it's rendered.\n   *  Embedders wire `makeComposeContentUrl({ hostedTypes, contentOrigin })`;\n   *  omit it and lib views fall back to a same-origin relative path\n   *  (`buildDefaultHref`).\n   *\n   *  Takes a single `ComposeContentUrlInput`: `type` + `identifier` (page\n   *  views pass the slug; chat rows pass the id + `externalUrl`, whose path\n   *  yields the slug for in-app routing) + optional `platforms` /\n   *  `externalUrl` / `targetPlatform`. */\n  composeContentUrl?: ComposeContentUrl\n  /** Per-`documentType` doc-viewer targets — the UNIFIED, DYNAMIC replacement for\n   *  the single `chipBasePlatform` prop. Maps a doc-table documentType\n   *  (`'markdown'`, `'data_room_doc'`, …) → `{ platform, basePath }` for the PUBLIC\n   *  doc viewer that hosts it. Doc chips with no `externalUrl` resolve PER ROW to\n   *  `getBaseUrl(platform)/<basePath>/<path>`, so a chat mixing several doc sources\n   *  sends EACH to its own home (markdown→flamingo/knowledge-base,\n   *  data_room_doc→company-hub/data-room) instead of one static fallback. The hub\n   *  may keep using `chipBasePlatform` (one doc source per platform); embedders that\n   *  surface multiple doc sources wire this. Threaded into `resolveSourceRowCTA`. */\n  docPlatformTargets?: Record<string, { platform: string; basePath: string }>\n  /** Chat source / platform identifier — OPTIONAL. The hub sets it from\n   *  `currentPlatform()`; EMBEDDERS leave it unset and stay platform-agnostic.\n   *\n   *  It is NOT required for chat to work. The wire resolves source server-side\n   *  (`/docs/chat|search|commands` reject any client `source`); the\n   *  same-tab-vs-new-tab link decision falls back to an origin comparison when\n   *  it's absent (`decideNewTab` → `isCrossOriginUrl`); and the localStorage\n   *  history namespace falls back to a stable constant. Set it only where the\n   *  client legitimately needs to know its platform a priori — i.e. the hub,\n   *  where several platforms share related origins so \"same platform\" can't be\n   *  inferred from a URL alone. */\n  source?: string\n  // NOTE: No `user` field. The chat's display identity (greeting\n  // first-name, etc.) comes from the SERVER-resolved auth via\n  // `useChatIdentity()` — the same identity the server uses to\n  // authorize requests. Letting embedders pass a client-side `user`\n  // would let it desync from the actual auth tier, causing greetings\n  // like \"Hey Bob\" while the server treats the session as\n  // alice@example.com. Single source of truth: the server.\n}\n\nexport const ChatRuntimeContext = createContext<ChatRuntime | null>(null)\n\n/**\n * Returns the active runtime, or null when no provider is mounted.\n * NULL is a first-class value — it signals \"no chat runtime configured.\"\n * Optional consumers fall back to no-op behavior; strict consumers\n * use `useRequiredChatRuntime` (below).\n */\nexport function useChatRuntime(): ChatRuntime | null {\n  return useContext(ChatRuntimeContext)\n}\n\n/**\n * Strict variant used INSIDE the chat panel. Throws if no provider.\n * The hub guarantees one exists by mounting `<HubRuntimeProvider>` at\n * root; the embedded app mounts its own `<ChatRuntimeContext.Provider>`\n * at the tree root. In Jest / Storybook tests that render chat\n * internals directly, wrap with `<HubRuntimeProvider>` (hub defaults)\n * or supply `<ChatRuntimeContext.Provider value={mockedRuntime}>`.\n */\nexport function useRequiredChatRuntime(): ChatRuntime {\n  const v = useContext(ChatRuntimeContext)\n  if (!v) {\n    throw new Error(\n      '[chat-runtime] hook called outside a <ChatRuntimeContext.Provider>. ' +\n        'The hub mounts <HubRuntimeProvider> at root — this only fires when ' +\n        'chat internals are rendered above the provider tree. ' +\n        'Fix: ensure the rendering subtree descends from the runtime provider. ' +\n        'In tests/Storybook: wrap with <HubRuntimeProvider> or supply ' +\n        'a <ChatRuntimeContext.Provider value={mockedRuntime}>.',\n    )\n  }\n  return v\n}\n"],"mappings":";;;AAuBA,SAAS,eAAe,kBAAkB;AAenC,IAAM,0BAA0B,cAAuC,IAAI;AAO3E,SAAS,sBAA+C;AAC7D,SAAO,WAAW,uBAAuB;AAC3C;AASO,SAAS,8BAAgD;AAC9D,QAAM,IAAI,WAAW,uBAAuB;AAC5C,MAAI,CAAC,GAAG;AACN,UAAM,IAAI;AAAA,MACR;AAAA,IAIF;AAAA,EACF;AACA,SAAO;AACT;;;AChCA,SAAS,iBAAAA,gBAAe,cAAAC,mBAAkC;AAiMnD,IAAM,qBAAqBD,eAAkC,IAAI;AAQjE,SAAS,iBAAqC;AACnD,SAAOC,YAAW,kBAAkB;AACtC;AAUO,SAAS,yBAAsC;AACpD,QAAM,IAAIA,YAAW,kBAAkB;AACvC,MAAI,CAAC,GAAG;AACN,UAAM,IAAI;AAAA,MACR;AAAA,IAMF;AAAA,EACF;AACA,SAAO;AACT;","names":["createContext","useContext"]}