@flamingo-stack/openframe-frontend-core 0.0.217 → 0.0.218-snapshot.20260602043552

package/dist/utils/list-url.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Shared list-API URL builder — the single un-replicable piece of the
+ * chat entity-card fetch path.
+ *
+ * ## Why this exists
+ *
+ * A fetch-mode entity card (`dispatch.tsx` → `useChatCardItem`) expands a
+ * compact `[card://<type>:<id>]` marker by fetching the type's public list
+ * endpoint with an `?ids=` (or `?task_ids=`) filter and matching the row
+ * back by id. The per-type URL SHAPE is non-obvious — `task_ids` for the
+ * ClickUp-backed types, `pageSize` for blog, `&limit=N&filter=all` for the
+ * programs trio, a distinct `/customer-interviews` path, etc. — and lives in
+ * the hub's 12 RAG mapper closures (`lib/config/rag-mappers/*.ts`). An
+ * embedder can't reverse-engineer those shapes, so a wrong/missing builder
+ * resolves a null URL ⇒ `enabled:false` ⇒ the card never fetches and renders
+ * nothing.
+ *
+ * This builder is the ONE source for those shapes. The hub's 12 mappers
+ * delegate their `listApi` here (a byte-parity test guards the migration),
+ * and embedders wire it once:
+ *
+ *   endpoints.buildListUrl = (type, ids) => buildListUrl(type, ids, '/content')
+ *
+ * `base=''` (default) yields the hub-relative `/api/...`; `base='/content'`
+ * (or any reverse-proxy prefix) yields `/content/api/...`.
+ *
+ * Pure + server-safe (no React, no browser APIs) so the hub's server-side
+ * mappers can import it from `@flamingo-stack/openframe-frontend-core/utils`.
+ */
+/**
+ * Build a list-API URL that returns full rows for the given ids, or `null`
+ * when the type has no list endpoint (the caller skips fetching rather than
+ * fabricating a URL).
+ *
+ *   buildListUrl('roadmap_item', ['a','b'])             → '/api/roadmap?task_ids=a,b'
+ *   buildListUrl('blog_post_existing', ['a','b'])       → '/api/blog/posts?ids=a,b&pageSize=2'  (alias)
+ *   buildListUrl('roadmap_item', ['a','b'], '/content') → '/content/api/roadmap?task_ids=a,b'
+ *   buildListUrl('github_pr', ['a'])                    → null  (absent key)
+ *
+ * `marketing_campaign` (admin-only, non-RAG) is a LITERAL case, NOT a
+ * `BUILDERS` entry — a static branch keeps CodeQL able to prove no
+ * user-controlled dynamic dispatch reaches the admin endpoint; embedders
+ * can't hit `/api/admin` through their proxy anyway.
+ */
+export declare function buildListUrl(contentRefType: string, ids: string[], base?: string): string | null;
+//# sourceMappingURL=list-url.d.ts.map

package/dist/utils/list-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-url.d.ts","sourceRoot":"","sources":["../../src/utils/list-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAqCH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,SAAK,GAAG,MAAM,GAAG,IAAI,CAa5F"}

package/dist/utils/platform-config.d.ts

@@ -2,17 +2,17 @@ import React from 'react';
 import type { SelectableOption } from '../components/features';
 import type { PlatformConfig } from '../types/platform';
 export declare const platformIcons: {
-    openframe: import("react/jsx-runtime").JSX.Element;
-    openmsp: import("react/jsx-runtime").JSX.Element;
-    flamingo: import("react/jsx-runtime").JSX.Element;
-    'flamingo-teaser': import("react/jsx-runtime").JSX.Element;
-    'marketing-hub': import("react/jsx-runtime").JSX.Element;
-    'product-hub': import("react/jsx-runtime").JSX.Element;
-    'revenue-hub': import("react/jsx-runtime").JSX.Element;
-    'people-hub': import("react/jsx-runtime").JSX.Element;
-    'company-hub': import("react/jsx-runtime").JSX.Element;
-    tmcg: import("react/jsx-runtime").JSX.Element;
-    universal: import("react/jsx-runtime").JSX.Element;
+    openframe: React.JSX.Element;
+    openmsp: React.JSX.Element;
+    flamingo: React.JSX.Element;
+    'flamingo-teaser': React.JSX.Element;
+    'marketing-hub': React.JSX.Element;
+    'product-hub': React.JSX.Element;
+    'revenue-hub': React.JSX.Element;
+    'people-hub': React.JSX.Element;
+    'company-hub': React.JSX.Element;
+    tmcg: React.JSX.Element;
+    universal: React.JSX.Element;
 };
 export declare const platformColors: {
     openmsp: string;
@@ -94,7 +94,7 @@ export declare function transformPlatformConfigsToOptions(platformConfigs: Platf
 /**
  * Get platform icon by name
  */
-export declare function getPlatformIcon(platformName: string): import("react/jsx-runtime").JSX.Element;
+export declare function getPlatformIcon(platformName: string): React.JSX.Element;
 /**
  * Get platform color by name
  */

package/dist/utils/platform-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-config.d.ts","sourceRoot":"","sources":["../../src/utils/platform-config.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,eAAO,MAAM,aAAa;;;;;;;;;;;;CAYzB,CAAC;AAGF,eAAO,MAAM,cAAc;;;;;;;;;;;;CAY1B,CAAC;AAGF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;CAYhC,CAAC;AAGF,eAAO,MAAM,oBAAoB;;;;;;;CAOhC,CAAC;AAGF,eAAO,MAAM,eAAe;;;;;;;CAO3B,CAAC;AAGF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAC;AAGF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,iCAAiC,CAAC,eAAe,EAAE,cAAc,EAAE,GAAG,gBAAgB,EAAE,CASvG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,2CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,UAEpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CA2B1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,KAAK,CAAC,SAAS,CAyB7G"}
+{"version":3,"file":"platform-config.d.ts","sourceRoot":"","sources":["../../src/utils/platform-config.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,eAAO,MAAM,aAAa;;;;;;;;;;;;CAYzB,CAAC;AAGF,eAAO,MAAM,cAAc;;;;;;;;;;;;CAY1B,CAAC;AAGF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;CAYhC,CAAC;AAGF,eAAO,MAAM,oBAAoB;;;;;;;CAOhC,CAAC;AAGF,eAAO,MAAM,eAAe;;;;;;;CAO3B,CAAC;AAGF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAC;AAGF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,iCAAiC,CAAC,eAAe,EAAE,cAAc,EAAE,GAAG,gBAAgB,EAAE,CASvG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,qBAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,UAEpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CA2B1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,KAAK,CAAC,SAAS,CAyB7G"}

package/dist/utils/release-badge.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Single source of truth for mapping a product release's `release_type` to
+ * the `StatusBadge` colorScheme used in the `ProductReleaseCard` lg variant's
+ * metadata-grid Type cell. Every surface that renders a
+ * `<ProductReleaseCard size="lg" ...>` must pass this value as
+ * `releaseTypeBadgeColor` or the card falls back to a `'—'` placeholder
+ * (the card requires BOTH `releaseType && releaseTypeBadgeColor` to paint a
+ * colored badge).
+ *
+ * Mapping mirrors the visual hierarchy operators expect at a glance:
+ *   major  → error   (red, breaking change)
+ *   minor  → cyan    (accent, feature)
+ *   patch  → success (green, safe bump)
+ *   beta/alpha → warning (yellow, preview)
+ *
+ * (Lifted from the hub so every embedder — not just the hub — gets the rich
+ * card metadata. The admin form's `releaseTypeOptions.color` array uses a
+ * different color vocabulary — different concern; don't unify here.)
+ */
+export type ReleaseType = 'major' | 'minor' | 'patch' | 'beta' | 'alpha';
+export type ReleaseTypeBadgeColor = 'error' | 'cyan' | 'success' | 'warning';
+/**
+ * Accepts a wider input type than `ReleaseType` because list-API rows can
+ * carry legacy / unenforced `release_type` values. Returns `undefined` for
+ * unknown values — the card guards on `releaseType && releaseTypeBadgeColor`
+ * to decide whether to render a colored badge or fall back to an em-dash, so
+ * an undefined return is the correct failure mode (badge hidden), not a crash.
+ */
+export declare function releaseTypeToBadgeColor(t: ReleaseType | string | null | undefined): ReleaseTypeBadgeColor | undefined;
+//# sourceMappingURL=release-badge.d.ts.map

package/dist/utils/release-badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-badge.d.ts","sourceRoot":"","sources":["../../src/utils/release-badge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;AACxE,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;AAE5E;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACzC,qBAAqB,GAAG,SAAS,CAcnC"}

package/dist/utils/release-cover.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Single source of truth for the ProductReleaseCard cover-image fallback
+ * priority. Every surface that renders a `<ProductReleaseCard>` (catalog row,
+ * chat-inline dispatcher, chat wrapper) computes the cover via this helper —
+ * adding a new fallback source or reordering the priority is ONE edit.
+ *
+ * **Priority** (intentional):
+ *   1. `featured_image` — editor-curated cover, always wins.
+ *   2. `highlight_video_thumbnail` — AI-generated highlight reel thumb.
+ *   3. `main_video_thumbnail` — full-release video thumb.
+ *   4. `og_image_url` — SEO fallback.
+ *   5. `null` — caller renders the entity placeholder.
+ *
+ * **`hasVideoCover`** fires ONLY when the active cover is a video thumb
+ * (priority 2 or 3). When the editor configured a still `featured_image`, a
+ * Play overlay would be misleading and is suppressed.
+ *
+ * Operator note: `||` (not `??`) so empty-string DB values fall through to the
+ * next fallback rather than rendering `<Image src="">`.
+ *
+ * (Lifted from the hub so the rich `buildProductReleaseCardProps` works in the
+ * lib / any embedder, not just the hub.)
+ */
+export interface ReleaseCoverSource {
+    featured_image?: string | null;
+    highlight_video_thumbnail?: string | null;
+    main_video_thumbnail?: string | null;
+    og_image_url?: string | null;
+}
+export interface ReleaseCoverResult {
+    cover: string | null;
+    hasVideoCover: boolean;
+}
+export declare function resolveReleaseCover(r: ReleaseCoverSource): ReleaseCoverResult;
+//# sourceMappingURL=release-cover.d.ts.map

package/dist/utils/release-cover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-cover.d.ts","sourceRoot":"","sources":["../../src/utils/release-cover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAS7E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flamingo-stack/openframe-frontend-core",
-  "version": "0.0.217",
+  "version": "0.0.218-snapshot.20260602043552",
   "description": "Shared design system and components for all Flamingo platforms",
   "type": "module",
   "main": "./dist/index.js",
@@ -191,7 +191,7 @@
     "test:ui": "vitest --ui",
     "test:run": "vitest run",
     "test:coverage": "vitest run --coverage",
-    "yalc:watch": "NODE_OPTIONS='--max-old-space-size=4096' nodemon --watch src --watch tsconfig.json --watch tsup.config.ts --watch tailwind.config.ts --watch package.json -e ts,tsx,json,css --ignore dist --ignore node_modules --ignore '*.lock' --ignore .yalc --ignore yalc.lock --exec 'rm -rf dist && tsup && yalc push --changed'",
+    "yalc:watch": "NODE_OPTIONS='--max-old-space-size=4096' nodemon --watch src --watch tsconfig.json --watch tsup.config.ts --watch tailwind.config.ts --watch package.json -e ts,tsx,json,css --ignore dist --ignore node_modules --ignore '*.lock' --ignore .yalc --ignore yalc.lock --exec 'rm -rf dist && tsup && tsc -p tsconfig.declarations.json && yalc push --changed'",
     "yalc:push": "yalc push",
     "yalc:publish": "yalc publish",
     "generate:icons": "node scripts/generate-icons.mjs",

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

@@ -47,6 +47,7 @@ import { XmarkIcon } from '../icons-v2-generated/signs-and-symbols/xmark-icon'
 
 import { ChatFooter } from './chat-container'
 import { ChatInput } from './chat-input'
+import { ChatSidebar } from './chat-sidebar'
 import { MingoOnboardingCard } from './mingo-onboarding-card'
 import { MingoOnboardingCardSkeleton } from './mingo-onboarding-card-skeleton'
 import { ChatMessageList } from './chat-message-list'
@@ -58,6 +59,7 @@ import { renderChatInlineEntityCard } from './entity-cards/dispatch'
 import type { ChatCardDispatchExtras } from './entity-cards/dispatch'
 
 import { useRequiredChatRuntime } from '../../contexts/chat-runtime-context'
+import { useRouter } from '../../embed-shims/next-navigation'
 import { type ChatSource, type UseSseChatAdapterOptions } from './hooks/use-sse-chat-adapter'
 import {
   useUnifiedChat,
@@ -80,7 +82,7 @@ import { handleChatNavClick } from './utils/nav-click-handler'
 import { computeIsNewTab, newTabAnchorAttrs } from './utils/nav-anchor-props'
 import { resolveHrefForRuntime } from './utils/chat-nav-resolution'
 import { ChatPanelContext, type ChatPanelHandle } from './chat-panel-context'
-import { resolveSourceRowCTA } from './utils/source-row-cta'
+import { resolveSourceRowCTA, sourceRowCtxFromRuntime } from './utils/source-row-cta'
 import { chatChipClass } from './utils/chip-styles'
 import { getIconComponent } from './utils/icon-registry'
 import { resolveOnboardingIcon } from './utils/onboarding-icons'
@@ -167,6 +169,20 @@ export interface EmbeddableChatProps {
    * else `'mingo'`.
    */
   defaultActiveMode?: ChatMode
+
+  /**
+   * Wrapper shell around the chat body.
+   *   - `'drawer'` (default): wraps in a body-level Radix Drawer (slide-in
+   *     overlay from the right) — the original MPH / standalone behaviour.
+   *   - `'none'`: no shell. Renders only the chat body so the consumer can
+   *     host it inside their own container (e.g. `AppLayoutDrawerContent`).
+   *     The internal "Ask AI" trigger and iOS body scroll-lock are also
+   *     suppressed — those are Drawer-shell concerns. The consumer is
+   *     responsible for mount/unmount and for opening/closing via the
+   *     `open` / `onOpenChange` props (which the in-body close button still
+   *     drives).
+   */
+  shell?: 'drawer' | 'none'
 }
 
 // =============================================================================
@@ -278,6 +294,7 @@ function SourceChip({
   onDiscuss?: (ref: ChatRef) => void
 }) {
   const runtime = useRequiredChatRuntime()
+  const router = useRouter()
   // Single CTA resolver — same icon, same href chain, same ChatRef
   // synthesis the inline card and search-result paths use.
   const cta = resolveSourceRowCTA(
@@ -290,7 +307,7 @@ function SourceChip({
       targetPlatform: src.targetPlatform ?? null,
       path: src.path,
     },
-    { baseRoute, chipBasePlatform, currentPlatform: runtime.source },
+    sourceRowCtxFromRuntime(runtime, { baseRoute, chipBasePlatform }),
   )
   const Icon = cta.icon
   const icon = <Icon className="h-3.5 w-3.5" />
@@ -314,7 +331,7 @@ function SourceChip({
           targetPlatform: item.targetPlatform ?? null,
           path: item.path,
         },
-        { baseRoute, chipBasePlatform, currentPlatform: runtime.source },
+        sourceRowCtxFromRuntime(runtime, { baseRoute, chipBasePlatform }),
       )
       const ItemIcon = itemCta.icon
       return {
@@ -388,7 +405,7 @@ function SourceChip({
   // Single close model: matches `ChatCardNavWrap` for inline cards.
   const buildClickHandler = (href: string, path: string | null | undefined, targetPlatform: string | null, isNewTab: boolean) =>
     (e: React.MouseEvent<HTMLAnchorElement>) => {
-      const handled = handleChatNavClick(e, runtime, { href, path, targetPlatform })
+      const handled = handleChatNavClick(e, runtime, { href, path, targetPlatform }, router.push)
       if (handled && !isNewTab && onClose) onClose()
     }
 
@@ -562,9 +579,17 @@ function EmbeddableChatInner({
   activeMode: controlledActiveMode,
   onActiveModeChange,
   defaultActiveMode,
+  shell = 'drawer',
 }: EmbeddableChatProps) {
+  // `shell === 'none'` means the consumer hosts us inside their own panel
+  // (e.g. AppLayoutDrawer in openframe-frontend). Several drawer-shell
+  // concerns are unconditional in this codebase — gate them off here so
+  // we don't double-up with the host's behaviour.
+  const shellLess = shell === 'none'
   const runtime = useRequiredChatRuntime()
-  const source = runtime.source as DocSource
+  // Optional on embedders (platform-agnostic); '' is a harmless sentinel for the
+  // `ask-ai:open-with-ref` event filter below. (DocSource is a `string` alias.)
+  const source = (runtime.source ?? '') as DocSource
   const commandsUrl = runtime.endpoints.commandsUrl
   // Server-resolved identity — drives the greeting first-name AND the
   // attachment capability flag. Single source of truth: the chat-identity
@@ -603,12 +628,15 @@ function EmbeddableChatInner({
 
   // iOS scroll-lock — react-aria's two-layer approach plus body fixed-pos.
   // See hub original for the long mechanism comment; logic copied verbatim.
-  usePreventScroll({ isDisabled: !isOpen })
+  // Skipped in shell-less mode: the host (AppLayoutDrawer) is in-layout, so
+  // there's no body-level overlay that should block page scrolling.
+  usePreventScroll({ isDisabled: !isOpen || shellLess })
 
   const navigatingAwayRef = useRef(false)
 
   useEffect(() => {
     if (!isOpen) return
+    if (shellLess) return
     if (typeof window === 'undefined') return
     if (!isIOS()) return
 
@@ -634,7 +662,7 @@ function EmbeddableChatInner({
       if (window.location.pathname !== openPathname) return
       window.scrollTo(0, scrollY)
     }
-  }, [isOpen])
+  }, [isOpen, shellLess])
 
   // Imperative handle to the chat input.
   const chatInputRef = useRef<ChatInputRef | null>(null)
@@ -755,8 +783,46 @@ function EmbeddableChatInner({
     currentCacheHitRatePct,
     currentUsageBreakdown,
     displayRef,
+    // ─── Dialog management (Mingo-mode sidebar) ───
+    dialogs,
+    activeDialogId,
+    selectDialog,
+    startNewDialog,
+    isDialogsLoading,
+    hasMoreDialogs,
+    loadMoreDialogs,
   } = useUnifiedChat({ modes: effectiveModes, activeMode })
 
+  // Whether the in-panel dialog sidebar should render. Gated on:
+  //   1. Mingo mode is active (Guide has localStorage-only history that
+  //      isn't yet structured as a sidebar list — see
+  //      [[chat-architecture-and-migration]] for the asymmetry).
+  //   2. The host wired `fetchDialogs` — managed-dialog mode, not the
+  //      bare-transport Tauri flow.
+  const showSidebar =
+    activeMode === 'mingo' && effectiveModes.mingo?.fetchDialogs !== undefined
+
+  // Pending startNewDialog promise — used to gate the "Start new chat"
+  // button while creation is in flight so a double-click doesn't spawn
+  // two backend dialogs.
+  const [isStartingNewDialog, setIsStartingNewDialog] = useState<boolean>(false)
+  const handleStartNewDialog = useCallback(async () => {
+    if (isStartingNewDialog) return
+    setIsStartingNewDialog(true)
+    try {
+      await startNewDialog()
+    } finally {
+      setIsStartingNewDialog(false)
+    }
+  }, [isStartingNewDialog, startNewDialog])
+
+  const handleSelectDialog = useCallback(
+    (id: string) => {
+      selectDialog(id)
+    },
+    [selectDialog],
+  )
+
   // Chat-attachment hooks (v2 attachment feature).
   const {
     attachments: stagedAttachments,
@@ -770,7 +836,12 @@ function EmbeddableChatInner({
     useChatAttachmentImageGallery()
 
   // Resolve base route. Hub default mapping: flamingo → /knowledge-base,
-  // anything else → /data-room. Embedders can override per platform.
+  // anything else → /data-room. Embedders override per platform. An embedder that
+  // doesn't host an in-app doc viewer should NOT pass an empty baseRoute (that just
+  // falls back to the platform default here) — instead it sets a truthy baseRoute +
+  // `chipBasePlatform` so doc chips with no externalUrl resolve cross-platform to that
+  // platform's public knowledge hub (`getBaseUrl(chipBasePlatform)/knowledge-base/…`),
+  // exactly like the hub's openframe config (baseRoute:'/', chipBasePlatform:'flamingo').
   const resolvedBaseRoute =
     baseRoute || (source === 'flamingo' ? '/knowledge-base' : '/data-room')
 
@@ -930,8 +1001,9 @@ function EmbeddableChatInner({
   return (
     <>
       {/* Floating "Ask AI" button — sticky-dock pattern. See hub original
-          for the full mechanism explanation. */}
-      {showInternalTrigger && (
+          for the full mechanism explanation. Suppressed in shell-less mode:
+          the host controls open/close, so an internal trigger would race. */}
+      {showInternalTrigger && !shellLess && (
         <div
           aria-hidden={isOpen}
           className={`sticky bottom-0 h-0 z-[9990] pointer-events-none ${
@@ -953,36 +1025,17 @@ function EmbeddableChatInner({
         </div>
       )}
 
-      <Drawer open={isOpen} onOpenChange={(o: boolean) => !o && handleClose()}>
-        <ChatPanelContext.Provider value={chatPanelHandle}>
-          {/*
-            Panel-level handle for descendants (inline cards via
-            `ChatCardNavWrap`, markdown-body links via
-            `NavLinkAnchorViaRuntime`) to close the panel after same-tab
-            navigation. Same-tab clicks fire `closeChat`; new-tab clicks
-            leave the panel open while the new tab loads.
-          */}
-          <DrawerContent
-            side="right"
-            flush
-            resizable
-            minSize={480}
-            maxSize={1280}
-            defaultSize={640}
-            storageKey="mingo-chat-width"
-            resizeAriaLabel="Resize chat panel"
-            overlayClassName="mingo-chat-overlay md:bg-black/20"
-            aria-describedby={undefined}
-            className="
-              mingo-chat-content !bg-ods-bg shadow-2xl
-              focus:outline-none focus-visible:outline-none
-              w-screen md:w-auto
-            "
-          >
-            <VisuallyHidden>
-              <DialogPrimitive.Title>{sourceLabel} AI Assistant</DialogPrimitive.Title>
-            </VisuallyHidden>
-
+      {/*
+        Conditional shell — overlay (Drawer, MPH default) vs inline
+        (positioned `<aside>` anchored to the nearest positioned
+        ancestor, openframe-frontend's nav-embedded chat). Both share
+        the same `body` JSX so the chat content is defined exactly
+        once; the IIFE keeps both branches type-balanced inside JSX
+        (no opening tag in one ternary branch + closing in another).
+      */}
+      {(() => {
+        const body = (
+          <>
             <div className="flex h-full flex-col overflow-hidden">
               {/* Figma node 7363:205930 — top-navigation. Title intentionally
                   omitted; a chevron-left + "New Chat" back-style affordance
@@ -1021,6 +1074,27 @@ function EmbeddableChatInner({
                 </button>
               </div>
 
+              {/* Sidebar + chat-panel row. When Mingo is the active mode and
+                  `fetchDialogs` is wired, the in-panel `<ChatSidebar>` lists
+                  the user's backend-driven dialog history. Guide mode keeps
+                  history in localStorage and currently renders no sidebar. */}
+              <div className="flex flex-1 min-h-0 overflow-hidden">
+                {showSidebar && (
+                  <ChatSidebar
+                    className="w-72 shrink-0"
+                    dialogs={dialogs}
+                    activeDialogId={activeDialogId ?? undefined}
+                    onDialogSelect={handleSelectDialog}
+                    onNewChat={() => { void handleStartNewDialog() }}
+                    isLoading={isDialogsLoading && dialogs.length === 0}
+                    isCreatingDialog={isStartingNewDialog}
+                    hasNextPage={hasMoreDialogs}
+                    isFetchingNextPage={isDialogsLoading && dialogs.length > 0}
+                    onLoadMore={() => { void loadMoreDialogs() }}
+                  />
+                )}
+                <div className="flex flex-1 flex-col min-h-0 min-w-0">
+
               {showModeToggle ? (
                 <div
                   role="radiogroup"
@@ -1222,11 +1296,63 @@ function EmbeddableChatInner({
                   </div>
                 </div>
               </div>
+                </div>
+              </div>
             </div>
             {galleryModal}
-          </DrawerContent>
-        </ChatPanelContext.Provider>
-      </Drawer>
+          </>
+        )
+
+        // Shell-less branch — host (e.g. AppLayoutDrawer) provides the panel
+        // chrome, focus trap, animation, and size. We render only the chat
+        // body plus ChatPanelContext so descendants can still close after
+        // same-tab navigation via the host's `onOpenChange`.
+        if (shellLess) {
+          return (
+            <ChatPanelContext.Provider value={chatPanelHandle}>
+              {body}
+            </ChatPanelContext.Provider>
+          )
+        }
+
+        // Body-level Radix Drawer — backdrop, iOS scroll-lock, focus
+        // trap, drag-to-resize handle. Slides in from the right edge.
+        return (
+          <Drawer open={isOpen} onOpenChange={(o: boolean) => !o && handleClose()}>
+            <ChatPanelContext.Provider value={chatPanelHandle}>
+              {/*
+                Panel-level handle for descendants (inline cards via
+                `ChatCardNavWrap`, markdown-body links via
+                `NavLinkAnchorViaRuntime`) to close the panel after same-tab
+                navigation. Same-tab clicks fire `closeChat`; new-tab clicks
+                leave the panel open while the new tab loads.
+              */}
+              <DrawerContent
+                side="right"
+                flush
+                resizable
+                minSize={showSidebar ? 720 : 480}
+                maxSize={1600}
+                defaultSize={showSidebar ? 960 : 640}
+                storageKey={showSidebar ? 'mingo-chat-width-with-sidebar' : 'mingo-chat-width'}
+                resizeAriaLabel="Resize chat panel"
+                overlayClassName="mingo-chat-overlay md:bg-black/20"
+                aria-describedby={undefined}
+                className="
+                  mingo-chat-content !bg-ods-bg shadow-2xl
+                  focus:outline-none focus-visible:outline-none
+                  w-screen md:w-auto
+                "
+              >
+                <VisuallyHidden>
+                  <DialogPrimitive.Title>{sourceLabel} AI Assistant</DialogPrimitive.Title>
+                </VisuallyHidden>
+                {body}
+              </DrawerContent>
+            </ChatPanelContext.Provider>
+          </Drawer>
+        )
+      })()}
     </>
   )
 }

package/src/components/chat/entity-cards/dispatch.tsx

@@ -31,10 +31,11 @@
 
 import React, { type ReactNode } from 'react'
 import { useRequiredChatRuntime } from '../../../contexts/chat-runtime-context'
+import { useRouter } from '../../../embed-shims/next-navigation'
 import type { ChatRef } from '../chat-ref.types'
 import { useChatCardItem } from '../hooks/use-chat-card-item'
 import { handleChatNavClick } from '../utils/nav-click-handler'
-import { resolveSourceRowCTA, resolveSourceIcon } from '../utils/source-row-cta'
+import { resolveSourceRowCTA, resolveSourceIcon, sourceRowCtxFromRuntime } from '../utils/source-row-cta'
 import { resolveHrefForRuntime } from '../utils/chat-nav-resolution'
 import {
   computeIsNewTab,
@@ -866,6 +867,7 @@ function ChatCardNavWrap({
   children: ReactNode
 }) {
   const runtime = useRequiredChatRuntime()
+  const router = useRouter()
   const panel = useChatPanel()
   const onClickCapture = (e: React.MouseEvent<HTMLElement>) => {
     if (!href) return
@@ -879,7 +881,7 @@ function ChatCardNavWrap({
     if (targetEl?.closest?.('button')) return
     if (!targetEl?.closest?.('a')) return
 
-    const handled = handleChatNavClick(e, runtime, { href, path, targetPlatform })
+    const handled = handleChatNavClick(e, runtime, { href, path, targetPlatform }, router.push)
     if (!handled) return
     // Modifier-clicks fall through (handled=false) without stopPropagation
     // so ancestor telemetry handlers still see the bubble.
@@ -950,11 +952,7 @@ export function ChatCardLoader({
             ? (chatRef.metadata.path as string)
             : null,
       },
-      {
-        baseRoute,
-        chipBasePlatform,
-        currentPlatform: runtime.source,
-      },
+      sourceRowCtxFromRuntime(runtime, { baseRoute, chipBasePlatform }),
     )
     const finalHref = cta.href ? resolveHrefForRuntime(cta.href, runtime) : null
     return {

package/src/components/chat/entity-cards/index.ts

@@ -36,6 +36,14 @@ export {
   type ProductReleaseCardSize,
   type ProductReleaseCardAnchorProps,
 } from './product-release-card'
+// Card-prop builders: `defaultBuildProductReleaseCardProps` (sm chat default) +
+// `buildProductReleaseCardProps` (RICH lg builder — the ProductReleasesView
+// default; lifted from the hub so embedders get the full metadata grid).
+export {
+  defaultBuildProductReleaseCardProps,
+  buildProductReleaseCardProps,
+  type ProductReleaseCardDerivedProps,
+} from './product-release-card-defaults'
 
 // Refactored pure-presentation cards
 export { BlogCard, BlogCardSkeleton, type BlogCardProps } from './blog-card'

package/src/components/chat/entity-cards/onboarding-guide-card.tsx

@@ -18,6 +18,7 @@
 
 import React from 'react'
 import Image from '../../../embed-shims/next-image'
+import Link from '../../../embed-shims/next-link'
 import { Clock, ExternalLink, GraduationCap, Play } from 'lucide-react'
 import { cn } from '../../../utils/cn'
 import { BlogImagePlaceholder } from './blog-image-placeholder'
@@ -178,10 +179,11 @@ export function OnboardingGuideCard({
         : ''
 
     return (
-      <a
+      <Link
         href={href}
         target={target}
         rel={rel}
+        prefetch={false}
         className={cn(
           'group block no-underline bg-ods-system-greys-black',
           'border border-ods-border rounded-lg overflow-hidden',
@@ -253,7 +255,7 @@ export function OnboardingGuideCard({
             ]}
           />
         </div>
-      </a>
+      </Link>
     )
   }
 
@@ -269,7 +271,7 @@ export function OnboardingGuideCard({
       author,
     ].filter((s): s is string => typeof s === 'string' && s.length > 0)
     return (
-      <a href={href} target={target} rel={rel} className={cn(COMPACT_CARD_OUTER, className)}>
+      <Link href={href} target={target} rel={rel} prefetch={false} className={cn(COMPACT_CARD_OUTER, className)}>
         <span className={COMPACT_CARD_IMAGE_SLOT}>
           {compactCover ? (
             <Image
@@ -311,7 +313,7 @@ export function OnboardingGuideCard({
         <span className="flex shrink-0 items-center self-start h-5 text-ods-text-secondary">
           <ExternalLink className="w-3.5 h-3.5" />
         </span>
-      </a>
+      </Link>
     )
   }
 
@@ -320,10 +322,11 @@ export function OnboardingGuideCard({
   const summary = (guide.video_summary || guide.content || '').trim()
 
   return (
-    <a
+    <Link
       href={href}
       target={target}
       rel={rel}
+      prefetch={false}
       className={cn(
         `flex items-start gap-3 rounded-md border border-ods-border bg-ods-card hover:border-ods-accent transition-colors ${t.padding}`,
         className,
@@ -347,6 +350,6 @@ export function OnboardingGuideCard({
           </span>
         )}
       </span>
-    </a>
+    </Link>
   )
 }