@robosystems/core 0.8.8 → 0.9.0

package/components/index.d.ts

@@ -4,6 +4,7 @@ export { EntitySelectorCore, type EntityLike, type EntityRecord, type EntitySele
 export { GraphFilters, byGraphType, composeFilters, excludeRepositories, excludeSubgraphs, hasAllSchemaExtensions, hasAnySchemaExtension, hasSchemaExtension, onlyEntityGraphs, onlyGenericGraphs, onlyRepositories, onlyUserGraphs, } from './graph-filters';
 export { GraphSelectorCore, type GraphSelectorProps } from './GraphSelectorCore';
 export { PageLayout } from './PageLayout';
+export { ReportChat, anchoredMessage, errorDetail, type ReportChatProps, } from './report-chat';
 export { ActiveSubscriptions, BrowseRepositories, type ActiveSubscriptionsProps, type BrowseRepositoriesProps, } from './repositories';
 export { RepositoryGuard, useIsRepository } from './RepositoryGuard';
 export { SearchBar, SearchContent, SearchHitCard, SearchPagination, SearchResultsMeta, } from './search';

package/components/index.js

@@ -4,6 +4,7 @@ export { EntitySelectorCore, } from './EntitySelectorCore';
 export { GraphFilters, byGraphType, composeFilters, excludeRepositories, excludeSubgraphs, hasAllSchemaExtensions, hasAnySchemaExtension, hasSchemaExtension, onlyEntityGraphs, onlyGenericGraphs, onlyRepositories, onlyUserGraphs, } from './graph-filters';
 export { GraphSelectorCore } from './GraphSelectorCore';
 export { PageLayout } from './PageLayout';
+export { ReportChat, anchoredMessage, errorDetail, } from './report-chat';
 export { ActiveSubscriptions, BrowseRepositories, } from './repositories';
 export { RepositoryGuard, useIsRepository } from './RepositoryGuard';
 export { SearchBar, SearchContent, SearchHitCard, SearchPagination, SearchResultsMeta, } from './search';

package/components/report-chat/ReportChat.d.ts

@@ -0,0 +1,29 @@
+import { type ReactNode } from 'react';
+export interface ReportChatProps {
+    /** The graph the operator runs on. */
+    graphId: string;
+    /** The note that anchors the operator on the report on screen. */
+    anchorNote: string;
+    /** The same report's identifiers, sent as `context.focus`. */
+    focus?: Record<string, unknown>;
+    /** Card title. */
+    title?: string;
+    /** Short text at the right of the header, e.g. what answers and what it costs. */
+    hint?: string;
+    /** The empty-state paragraph above the example questions. */
+    intro?: ReactNode;
+    /** Tap-to-ask questions on the empty state. */
+    examples?: string[];
+    placeholder?: string;
+    /**
+     * When false the body shows `unavailable` instead of the chat — for a user
+     * without access to the graph, say. The header still renders, so the card
+     * reads the same wherever it sits.
+     */
+    available?: boolean;
+    unavailable?: ReactNode;
+    defaultOpen?: boolean;
+    /** Operator mode; `standard` gives the loop enough tool turns for a schema read, a query or two, and an answer. */
+    mode?: 'quick' | 'standard' | 'extended';
+}
+export declare function ReportChat({ graphId, anchorNote, focus, title, hint, intro, examples, placeholder, available, unavailable, defaultOpen, mode, }: ReportChatProps): import("react").JSX.Element;

package/components/report-chat/ReportChat.js

@@ -0,0 +1,101 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Ask about this report — a collapsible chat card that sends questions to the
+ * RoboSystems operator on one graph, anchored on the report the host page
+ * has on screen. No key to enter: the call is the account's own, through the
+ * SDK's operator client (the same one the Console uses), and it spends the
+ * account's credits, which each answer shows.
+ *
+ * The host decides the anchor. RoboInvestor passes a filer and a filing on
+ * the SEC graph; RoboLedger passes an entity and a report on its own graph.
+ * Both hand the same shape: a note the operator reads ahead of every
+ * question, and a `focus` object with the same identifiers for an operator
+ * release that reads `context` directly.
+ */
+import { Spinner } from 'flowbite-react';
+import { useCallback, useRef, useState } from 'react';
+import { HiChevronDown, HiChevronRight, HiSparkles } from 'react-icons/hi';
+import ReactMarkdown from 'react-markdown';
+import remarkGfm from 'remark-gfm';
+import { anchoredMessage, errorDetail } from './anchor';
+const MARKDOWN_CLASS = 'text-sm leading-relaxed text-zinc-800 dark:text-zinc-200 [&_a]:text-primary-600 dark:[&_a]:text-primary-400 [&_a]:underline [&_code]:rounded [&_code]:bg-zinc-100 [&_code]:px-1 dark:[&_code]:bg-zinc-800 [&_h1]:mt-3 [&_h1]:text-base [&_h1]:font-semibold [&_h2]:mt-3 [&_h2]:text-base [&_h2]:font-semibold [&_h3]:mt-2 [&_h3]:font-semibold [&_li]:my-0.5 [&_ol]:list-decimal [&_ol]:pl-5 [&_p]:my-2 [&_strong]:font-semibold [&_table]:my-2 [&_table]:text-xs [&_td]:px-2 [&_td]:py-1 [&_th]:px-2 [&_th]:py-1 [&_th]:text-left [&_ul]:list-disc [&_ul]:pl-5';
+export function ReportChat({ graphId, anchorNote, focus, title = 'Ask about this report', hint, intro, examples = [], placeholder = 'Ask…', available = true, unavailable, defaultOpen = false, mode = 'standard', }) {
+    const [open, setOpen] = useState(defaultOpen);
+    const [turns, setTurns] = useState([]);
+    const [draft, setDraft] = useState('');
+    const [busy, setBusy] = useState(false);
+    const [progress, setProgress] = useState('');
+    const scrollRef = useRef(null);
+    const ask = useCallback(async (question) => {
+        var _a;
+        const q = question.trim();
+        if (!q || busy)
+            return;
+        setTurns((prev) => [...prev, { role: 'user', text: q }]);
+        setBusy(true);
+        setProgress('Thinking');
+        try {
+            const { clients } = await import('@robosystems/client/clients');
+            // Prior turns as the operator saw them: the questions without the
+            // anchor, which rides on every current message, and the answers.
+            const history = turns.map((t) => ({ role: t.role, content: t.text }));
+            const result = await clients.operator.executeQuery(graphId, Object.assign(Object.assign({ message: anchoredMessage(anchorNote, q), mode }, (history.length > 0 ? { history } : {})), (focus ? { context: { focus } } : {})), {
+                mode: 'auto',
+                onProgress: (message, percentage) => setProgress(percentage !== undefined
+                    ? `${message} (${percentage}%)`
+                    : message),
+            });
+            // The API reports operator failures (credit pre-flight, timeouts) as
+            // a normal response with `error_details` set; render those as errors.
+            if (result.error_details) {
+                setTurns((prev) => [
+                    ...prev,
+                    {
+                        role: 'assistant',
+                        text: errorDetail(result.error_details, result.content ||
+                            'The operator could not complete this request.'),
+                        error: true,
+                    },
+                ]);
+                return;
+            }
+            const credits = ((_a = result.metadata) !== null && _a !== void 0 ? _a : {})['credits_consumed'];
+            setTurns((prev) => [
+                ...prev,
+                {
+                    role: 'assistant',
+                    text: result.content || '(no answer returned)',
+                    credits: typeof credits === 'number' ? credits : null,
+                },
+            ]);
+        }
+        catch (e) {
+            setTurns((prev) => [
+                ...prev,
+                {
+                    role: 'assistant',
+                    text: `Error: ${e instanceof Error ? e.message : String(e)}`,
+                    error: true,
+                },
+            ]);
+        }
+        finally {
+            setBusy(false);
+            setProgress('');
+            requestAnimationFrame(() => {
+                const el = scrollRef.current;
+                if (el)
+                    el.scrollTop = el.scrollHeight;
+            });
+        }
+    }, [busy, turns, graphId, anchorNote, focus, mode]);
+    return (_jsxs("section", { className: "mb-8 rounded-lg border border-zinc-200 bg-white dark:border-zinc-800 dark:bg-zinc-900/60", children: [_jsxs("button", { type: "button", onClick: () => setOpen((o) => !o), "aria-expanded": open, className: "flex w-full items-center gap-2 px-4 py-3 text-left", children: [open ? (_jsx(HiChevronDown, { className: "h-4 w-4 shrink-0 text-zinc-400" })) : (_jsx(HiChevronRight, { className: "h-4 w-4 shrink-0 text-zinc-400" })), _jsx(HiSparkles, { className: "text-primary-500 h-4 w-4 shrink-0" }), _jsx("span", { className: "font-semibold text-zinc-900 dark:text-white", children: title }), hint ? (_jsx("span", { className: "ml-auto hidden text-xs text-zinc-500 sm:inline dark:text-zinc-400", children: hint })) : null] }), open && !available ? (_jsx("div", { className: "border-t border-zinc-200 px-4 py-4 text-sm text-zinc-600 dark:border-zinc-800 dark:text-zinc-400", children: unavailable })) : null, open && available ? (_jsxs("div", { className: "border-t border-zinc-200 dark:border-zinc-800", children: [_jsxs("div", { ref: scrollRef, className: "max-h-[28rem] space-y-3 overflow-y-auto px-4 py-4", children: [turns.length === 0 ? (_jsxs("div", { className: "text-sm text-zinc-600 dark:text-zinc-400", children: [intro ? _jsx("p", { children: intro }) : null, examples.length > 0 ? (_jsx("div", { className: "mt-3 flex flex-wrap gap-2", children: examples.map((q) => (_jsx("button", { type: "button", disabled: busy, onClick: () => void ask(q), className: "rounded-full border border-zinc-300 px-3 py-1 text-xs text-zinc-700 hover:bg-zinc-50 disabled:opacity-50 dark:border-zinc-700 dark:text-zinc-300 dark:hover:bg-zinc-800", children: q }, q))) })) : null] })) : (turns.map((turn, i) => turn.role === 'user' ? (_jsx("div", { className: "ml-auto max-w-[85%] rounded-lg bg-zinc-100 px-3 py-2 text-sm text-zinc-900 dark:bg-zinc-800 dark:text-zinc-100", children: turn.text }, i)) : (_jsxs("div", { className: `max-w-[95%] rounded-lg px-3 py-2 ${turn.error
+                                    ? 'border border-red-200 bg-red-50 text-sm text-red-700 dark:border-red-900/50 dark:bg-red-900/20 dark:text-red-400'
+                                    : 'bg-zinc-50 dark:bg-zinc-950/40'}`, children: [turn.error ? (turn.text) : (_jsx("div", { className: MARKDOWN_CLASS, children: _jsx(ReactMarkdown, { remarkPlugins: [remarkGfm], children: turn.text }) })), typeof turn.credits === 'number' ? (_jsxs("div", { className: "mt-1 text-xs text-zinc-400", children: [turn.credits.toFixed(1), " credits"] })) : null] }, i)))), busy ? (_jsxs("div", { className: "flex items-center gap-2 text-sm text-zinc-500 dark:text-zinc-400", children: [_jsx(Spinner, { size: "sm" }), " ", progress || 'Thinking', "\u2026"] })) : null] }), _jsxs("form", { className: "flex gap-2 border-t border-zinc-200 px-4 py-3 dark:border-zinc-800", onSubmit: (e) => {
+                            e.preventDefault();
+                            const q = draft;
+                            setDraft('');
+                            void ask(q);
+                        }, children: [_jsx("input", { type: "text", value: draft, onChange: (e) => setDraft(e.target.value), placeholder: placeholder, disabled: busy, "aria-label": title, className: "focus:border-primary-500 focus:ring-primary-500 flex-1 rounded-lg border border-zinc-300 bg-white px-3 py-2 text-sm text-zinc-900 placeholder-zinc-400 dark:border-zinc-700 dark:bg-zinc-900 dark:text-zinc-100 dark:placeholder-zinc-500" }), _jsx("button", { type: "submit", disabled: busy || !draft.trim(), className: "bg-primary-600 hover:bg-primary-700 rounded-lg px-4 py-2 text-sm font-medium text-white disabled:opacity-50", children: "Ask" })] })] })) : null] }));
+}

package/components/report-chat/anchor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The message sent for one question: the anchor note the host page wrote
+ * for the report on screen, then the question. The note rides on every
+ * message because the operator does not yet read `context.focus` into its
+ * prompt; when it does, hosts can pass `focus` alone and an empty note.
+ */
+export declare function anchoredMessage(anchorNote: string, question: string): string;
+/** The first non-empty string among an operator failure's fields. */
+export declare function errorDetail(details: Record<string, unknown> | undefined, fallback: string): string;

package/components/report-chat/anchor.js

@@ -0,0 +1,18 @@
+/**
+ * The message sent for one question: the anchor note the host page wrote
+ * for the report on screen, then the question. The note rides on every
+ * message because the operator does not yet read `context.focus` into its
+ * prompt; when it does, hosts can pass `focus` alone and an empty note.
+ */
+export function anchoredMessage(anchorNote, question) {
+    const q = question.trim();
+    const note = anchorNote.trim();
+    return note ? `${note}\n\nQuestion: ${q}` : q;
+}
+/** The first non-empty string among an operator failure's fields. */
+export function errorDetail(details, fallback) {
+    if (!details)
+        return fallback;
+    const found = [details.message, details.error, details.detail].find((v) => typeof v === 'string' && v.length > 0);
+    return found !== null && found !== void 0 ? found : fallback;
+}

package/components/report-chat/index.d.ts

@@ -0,0 +1,2 @@
+export { anchoredMessage, errorDetail } from './anchor';
+export { ReportChat, type ReportChatProps } from './ReportChat';

package/components/report-chat/index.js

@@ -0,0 +1,2 @@
+export { anchoredMessage, errorDetail } from './anchor';
+export { ReportChat } from './ReportChat';

package/index.d.ts

@@ -12,6 +12,7 @@ export type { Entities, Entity, User } from './types';
 export { customTheme } from './theme';
 export { buildGraphAwareConsoleConfig, ConsoleContent, EXAMPLE_SETS, getGraphExampleKind, useGraphAwareConsoleConfig, } from './components/console';
 export type { ConsoleBranding, ConsoleCommandContext, ConsoleConfig, ConsoleExtraCommand, ConsoleHeaderConfig, ConsoleMcpConfig, ConsoleWelcomeConfig, GraphExampleKind, GraphExampleSet, SampleQuery, } from './components/console';
+export { anchoredMessage, errorDetail, ReportChat, type ReportChatProps, } from './components/report-chat';
 export { ActiveSubscriptions, BrowseRepositories, EntitySelector, EntitySelectorCore, GraphSelectorCore, PageLayout, RepositoryGuard, SearchBar, SearchContent, SearchHitCard, SearchPagination, SearchResultsMeta, useIsRepository, type ActiveSubscriptionsProps, type BrowseRepositoriesProps, type EntityGroup, type EntityLike, type EntityRecord, type EntitySelectorProps, type GraphSelectorProps, type GraphWithEntities, type SearchBarProps, type SearchConfig, type SearchFilterConfig, type SearchHitCardProps, type SearchPaginationProps, type SearchResultsMetaProps, type SelectableEntity, } from './components';
 export { composeFilters, excludeRepositories, excludeSubgraphs, GraphFilters, hasSchemaExtension, onlyRepositories, onlyUserGraphs, } from './components/graph-filters';
 export { ApiKeyDisplay, BrandSpinner, categorizeError, CategoryInput, ChatHeader, ChatInputArea, ChatMessage, ConfirmModal, CoreNavbar, CoreSidebar, CreateApiKeyModal, DeepResearchToggle, EmptyState, ErrorType, GeneralInformationCard, generateMessageId, getErrorMessage, LandingFooter, LoadingState, MarkdownProse, PageContainer, PageHeader, PasswordInformationCard, PasswordRequirements, SecureApiKeyField, SettingsCard, SettingsContainer, SettingsFormField, SettingsPageHeader, Spinner, StatCard, StatusAlert, SupportModal, TagInput, ThemeToggle, } from './ui-components';

package/index.js

@@ -31,6 +31,7 @@ export { customTheme } from './theme';
 // Export components
 // Export console components
 export { buildGraphAwareConsoleConfig, ConsoleContent, EXAMPLE_SETS, getGraphExampleKind, useGraphAwareConsoleConfig, } from './components/console';
+export { anchoredMessage, errorDetail, ReportChat, } from './components/report-chat';
 export { ActiveSubscriptions, BrowseRepositories, EntitySelector, EntitySelectorCore, GraphSelectorCore, PageLayout, RepositoryGuard, SearchBar, SearchContent, SearchHitCard, SearchPagination, SearchResultsMeta, useIsRepository, } from './components';
 // Export graph filters
 export { composeFilters, excludeRepositories, excludeSubgraphs, GraphFilters, hasSchemaExtension, onlyRepositories, onlyUserGraphs, } from './components/graph-filters';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robosystems/core",
-  "version": "0.8.8",
+  "version": "0.9.0",
   "description": "Shared RoboSystems frontend core library (auth, contexts, task monitoring, UI components) for the RoboSystems Next.js apps",
   "license": "MIT",
   "private": false,

package/ui-components/MarkdownProse.d.ts

@@ -11,7 +11,8 @@ export interface MarkdownProseProps {
  * search results). Theme-aware via `dark:prose-dark` — the consuming apps
  * define the `typography.dark` variant in their Tailwind configs; do NOT
  * switch to `dark:prose-invert`, which doesn't resolve under their
- * Tailwind v4 + typography-plugin setup (see research/ResearchArticle.tsx).
+ * Tailwind v4 + typography-plugin setup (first hit in the research article,
+ * now roboinvestor-app's src/components/research/ResearchArticle.tsx).
  * Works in server and client components alike.
  */
 export declare function MarkdownProse({ children, size, className, }: MarkdownProseProps): import("react").JSX.Element;

package/ui-components/MarkdownProse.js

@@ -7,7 +7,8 @@ import { twMerge } from 'tailwind-merge';
  * search results). Theme-aware via `dark:prose-dark` — the consuming apps
  * define the `typography.dark` variant in their Tailwind configs; do NOT
  * switch to `dark:prose-invert`, which doesn't resolve under their
- * Tailwind v4 + typography-plugin setup (see research/ResearchArticle.tsx).
+ * Tailwind v4 + typography-plugin setup (first hit in the research article,
+ * now roboinvestor-app's src/components/research/ResearchArticle.tsx).
  * Works in server and client components alike.
  */
 export function MarkdownProse({ children, size = 'base', className, }) {

package/ui-components/layout/LandingFooter.js

@@ -43,5 +43,5 @@ export function LandingFooter({ tagline, productLinks, contactModal: ContactModa
                                             return (_jsx("li", { children: _jsx(Link, Object.assign({ href: cfg.url }, (isCurrent
                                                     ? {}
                                                     : { target: '_blank', rel: 'noopener noreferrer' }), { className: linkClass, children: cfg.displayName })) }, app));
-                                        }) })] }), _jsxs("div", { children: [_jsx("h3", { className: headingClass, children: "Company" }), _jsxs("ul", { className: "space-y-2 text-sm", children: [_jsx("li", { children: _jsx(Link, Object.assign({ href: researchHref }, researchLinkProps, { className: linkClass, children: "Research" })) }), _jsx("li", { children: _jsx(Link, { href: "https://holon.robosystems.ai", target: "_blank", rel: "noopener noreferrer", className: linkClass, children: "Holon Viewer" }) }), _jsx("li", { children: _jsx(Link, Object.assign({ href: resolvedBlogHref }, blogLinkProps, { className: linkClass, children: "Blog" })) }), _jsx("li", { children: _jsx(Link, Object.assign({ href: `${companyBase}/pages/privacy` }, companyLinkProps, { className: linkClass, children: "Privacy" })) }), _jsx("li", { children: _jsx(Link, Object.assign({ href: `${companyBase}/pages/terms` }, companyLinkProps, { className: linkClass, children: "Terms" })) }), _jsx("li", { children: _jsx(Link, { href: "https://trust.robosystems.ai", target: "_blank", rel: "noopener noreferrer", className: linkClass, children: "Trust Center" }) }), _jsx("li", { children: _jsx(Link, { href: "https://status.robosystems.ai", target: "_blank", rel: "noopener noreferrer", className: linkClass, children: "Status" }) }), ContactModal && (_jsx("li", { children: _jsx("button", { onClick: () => setShowContact(true), className: linkClass, children: "Contact" }) }))] })] })] }), _jsx("div", { className: "mt-8 border-t border-gray-800 pt-8 text-center text-sm text-gray-400", children: _jsxs("p", { children: ["\u00A9 ", new Date().getFullYear(), " RFS LLC. All rights reserved."] }) })] }), ContactModal && (_jsx(ContactModal, { isOpen: showContact, onClose: () => setShowContact(false) }))] }));
+                                        }) })] }), _jsxs("div", { children: [_jsx("h3", { className: headingClass, children: "Company" }), _jsxs("ul", { className: "space-y-2 text-sm", children: [_jsx("li", { children: _jsx(Link, Object.assign({ href: researchHref }, researchLinkProps, { className: linkClass, children: "Research" })) }), _jsx("li", { children: _jsx(Link, { href: "https://xbrlkit.com", target: "_blank", rel: "noopener noreferrer", className: linkClass, children: "xbrlkit viewer" }) }), _jsx("li", { children: _jsx(Link, Object.assign({ href: resolvedBlogHref }, blogLinkProps, { className: linkClass, children: "Blog" })) }), _jsx("li", { children: _jsx(Link, Object.assign({ href: `${companyBase}/pages/privacy` }, companyLinkProps, { className: linkClass, children: "Privacy" })) }), _jsx("li", { children: _jsx(Link, Object.assign({ href: `${companyBase}/pages/terms` }, companyLinkProps, { className: linkClass, children: "Terms" })) }), _jsx("li", { children: _jsx(Link, { href: "https://trust.robosystems.ai", target: "_blank", rel: "noopener noreferrer", className: linkClass, children: "Trust Center" }) }), _jsx("li", { children: _jsx(Link, { href: "https://status.robosystems.ai", target: "_blank", rel: "noopener noreferrer", className: linkClass, children: "Status" }) }), ContactModal && (_jsx("li", { children: _jsx("button", { onClick: () => setShowContact(true), className: linkClass, children: "Contact" }) }))] })] })] }), _jsx("div", { className: "mt-8 border-t border-gray-800 pt-8 text-center text-sm text-gray-400", children: _jsxs("p", { children: ["\u00A9 ", new Date().getFullYear(), " RFS LLC. All rights reserved."] }) })] }), ContactModal && (_jsx(ContactModal, { isOpen: showContact, onClose: () => setShowContact(false) }))] }));
 }

package/research/CoverageBrowser.d.ts

@@ -1,19 +0,0 @@
-import type { CoverageItem } from './types';
-export interface CoverageBrowserProps {
-    items: CoverageItem[];
-    /** Base path for card links, forwarded to the grid (defaults to /research). */
-    hrefBase?: string;
-    /** Override the search box placeholder. */
-    placeholder?: string;
-}
-/**
- * The research listing with a live client-side filter above it. A drop-in
- * replacement for {@link CoverageGrid}: the full grid renders on first paint
- * (so the server-rendered SEO page keeps every card in its HTML), and typing
- * narrows it in the browser. Matches ticker, company, title, and tags —
- * someone who types "Green Thumb" finds GTBIF without knowing the symbol.
- *
- * Filtering the whole in-memory catalog is fine at this scale; when the
- * catalog outgrows a single fetch this is where server-backed search slots in.
- */
-export declare function CoverageBrowser({ items, hrefBase, placeholder, }: CoverageBrowserProps): import("react").JSX.Element;

package/research/CoverageBrowser.js

@@ -1,35 +0,0 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { TextInput } from 'flowbite-react';
-import { useMemo, useState } from 'react';
-import { HiSearch } from 'react-icons/hi';
-import { CoverageGrid } from './CoverageGrid';
-/**
- * The research listing with a live client-side filter above it. A drop-in
- * replacement for {@link CoverageGrid}: the full grid renders on first paint
- * (so the server-rendered SEO page keeps every card in its HTML), and typing
- * narrows it in the browser. Matches ticker, company, title, and tags —
- * someone who types "Green Thumb" finds GTBIF without knowing the symbol.
- *
- * Filtering the whole in-memory catalog is fine at this scale; when the
- * catalog outgrows a single fetch this is where server-backed search slots in.
- */
-export function CoverageBrowser({ items, hrefBase, placeholder = 'Search by ticker, company, or title…', }) {
-    const [query, setQuery] = useState('');
-    const filtered = useMemo(() => {
-        const term = query.trim().toLowerCase();
-        if (!term)
-            return items;
-        return items.filter((item) => item.ticker.toLowerCase().includes(term) ||
-            item.company.toLowerCase().includes(term) ||
-            item.title.toLowerCase().includes(term) ||
-            item.tags.some((tag) => tag.toLowerCase().includes(term)));
-    }, [items, query]);
-    // Empty catalog: let the grid render its own "no coverage yet" state, no
-    // point showing a search box over nothing.
-    if (!items.length) {
-        return _jsx(CoverageGrid, { items: items, hrefBase: hrefBase });
-    }
-    const term = query.trim();
-    return (_jsxs("div", { className: "space-y-6", children: [_jsx(TextInput, { icon: HiSearch, type: "search", value: query, onChange: (e) => setQuery(e.target.value), placeholder: placeholder, "aria-label": "Search research" }), term && filtered.length === 0 ? (_jsxs("p", { className: "py-12 text-center text-gray-500 dark:text-gray-400", children: ["No results for \u201C", term, "\u201D."] })) : (_jsx(CoverageGrid, { items: filtered, hrefBase: hrefBase }))] }));
-}

package/research/CoverageCard.d.ts

@@ -1,12 +0,0 @@
-import type { CoverageItem } from './types';
-/**
- * A coverage tile: full-bleed thumbnail on top, then ticker/label, title, summary, and
- * prior-report count. Self-contained (not the shared Flowbite Card) so the cover image
- * sits flush at the top of every card regardless of how much text each one has — the
- * shared card theme centers its content (`justify-center`), which left the covers at
- * different heights across a row.
- */
-export declare function CoverageCard({ item, hrefBase, }: {
-    item: CoverageItem;
-    hrefBase?: string;
-}): import("react").JSX.Element;

package/research/CoverageCard.js

@@ -1,13 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import Link from 'next/link';
-/**
- * A coverage tile: full-bleed thumbnail on top, then ticker/label, title, summary, and
- * prior-report count. Self-contained (not the shared Flowbite Card) so the cover image
- * sits flush at the top of every card regardless of how much text each one has — the
- * shared card theme centers its content (`justify-center`), which left the covers at
- * different heights across a row.
- */
-export function CoverageCard({ item, hrefBase = '/research', }) {
-    var _a;
-    return (_jsx(Link, { href: `${hrefBase}/${item.ticker.toLowerCase()}`, className: "group block h-full", children: _jsxs("div", { className: "flex h-full flex-col overflow-hidden rounded-lg border border-gray-200 bg-white/80 shadow-lg backdrop-blur-sm transition-shadow duration-300 hover:shadow-xl dark:border-gray-700 dark:bg-zinc-950", children: [item.assets.thumbnail && (_jsx("img", { src: item.assets.thumbnail, alt: item.title, className: "aspect-video w-full object-cover" })), _jsxs("div", { className: "flex flex-1 flex-col gap-2 p-5", children: [_jsxs("div", { className: "flex items-center gap-2 text-xs font-medium text-gray-500 dark:text-gray-400", children: [_jsx("span", { className: "rounded bg-cyan-500/10 px-2 py-0.5 font-semibold text-cyan-600 dark:text-cyan-400", children: item.ticker }), item.coverage_label && _jsx("span", { children: item.coverage_label }), _jsx("span", { className: "ml-auto", children: (_a = item.date) === null || _a === void 0 ? void 0 : _a.slice(0, 10) })] }), _jsx("h3", { className: "text-lg font-bold text-gray-900 group-hover:text-cyan-600 dark:text-white dark:group-hover:text-cyan-400", children: item.title }), _jsx("p", { className: "line-clamp-3 text-sm text-gray-600 dark:text-gray-300", children: item.summary }), item.history.length > 0 && (_jsxs("p", { className: "mt-auto pt-1 text-xs text-gray-400", children: ["+", item.history.length, " prior", ' ', item.history.length === 1 ? 'report' : 'reports'] }))] })] }) }));
-}

package/research/CoverageGrid.d.ts

@@ -1,6 +0,0 @@
-import type { CoverageItem } from './types';
-/** Responsive grid of coverage cards. */
-export declare function CoverageGrid({ items, hrefBase, }: {
-    items: CoverageItem[];
-    hrefBase?: string;
-}): import("react").JSX.Element;

package/research/CoverageGrid.js

@@ -1,9 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { CoverageCard } from './CoverageCard';
-/** Responsive grid of coverage cards. */
-export function CoverageGrid({ items, hrefBase, }) {
-    if (!items.length) {
-        return (_jsx("p", { className: "py-12 text-center text-gray-500 dark:text-gray-400", children: "No coverage yet \u2014 check back soon." }));
-    }
-    return (_jsx("div", { className: "grid grid-cols-1 gap-6 md:grid-cols-2 lg:grid-cols-3", children: items.map((item) => (_jsx(CoverageCard, { item: item, hrefBase: hrefBase }, item.ticker))) }));
-}

package/research/CoverageHistory.d.ts

@@ -1,5 +0,0 @@
-import type { CoverageVersion } from './types';
-/** The continuing-coverage timeline: prior dated reports with links to their archived assets. */
-export declare function CoverageHistory({ history }: {
-    history: CoverageVersion[];
-}): import("react").JSX.Element;

package/research/CoverageHistory.js

@@ -1,7 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/** The continuing-coverage timeline: prior dated reports with links to their archived assets. */
-export function CoverageHistory({ history }) {
-    if (!history.length)
-        return null;
-    return (_jsxs("section", { className: "mt-12 border-t border-gray-200 pt-8 dark:border-gray-800", children: [_jsx("h2", { className: "mb-4 text-xl font-bold text-gray-900 dark:text-white", children: "Coverage history" }), _jsx("ol", { className: "space-y-3", children: history.map((h) => (_jsxs("li", { className: "flex flex-col gap-1 rounded-lg border border-gray-200 p-4 sm:flex-row sm:items-center sm:gap-4 dark:border-gray-800", children: [_jsx("span", { className: "shrink-0 rounded bg-gray-100 px-2 py-0.5 text-xs font-semibold text-gray-600 dark:bg-gray-800 dark:text-gray-300", children: h.version }), _jsxs("span", { className: "flex-1 text-sm text-gray-700 dark:text-gray-200", children: [h.title || 'Prior report', h.legacy_ticker && (_jsxs("em", { className: "text-gray-400", children: [" (as ", h.legacy_ticker, ")"] }))] }), _jsxs("span", { className: "flex gap-3 text-xs", children: [(h.youtube_url || h.assets.video) && (_jsx("a", { href: h.youtube_url || h.assets.video, className: "text-cyan-600 hover:underline dark:text-cyan-400", children: "Video" })), h.assets.podcast_mp3 && (_jsx("a", { href: h.assets.podcast_mp3, className: "text-cyan-600 hover:underline dark:text-cyan-400", children: "Podcast" })), h.assets.brief && (_jsx("a", { href: h.assets.brief, className: "text-cyan-600 hover:underline dark:text-cyan-400", children: "Brief" }))] })] }, h.version))) })] }));
-}

package/research/ResearchArticle.d.ts

@@ -1,16 +0,0 @@
-import type { CoverageItem } from './types';
-/**
- * The full coverage report: native video, the Q&A podcast (surfaced as a prominent
- * "Listen" card right under the video), then the brief rendered from markdown (its own
- * leading H1 is stripped — we render the title above it), and the continuing-coverage
- * history. Works in a server component (SSR'd for SEO) or a client one.
- * Theme-aware: readable in both light and dark. The prose body sets an explicit
- * light + `dark:` color for every element it renders (headings, p, strong, em, links,
- * lists, code, blockquote, hr, tables) rather than relying on `prose-invert` /
- * `dark:prose-invert` — the latter doesn't resolve from a `.dark` class in the
- * Tailwind v4 + typography-plugin setup these apps use.
- */
-export declare function ResearchArticle({ item, briefMarkdown, }: {
-    item: CoverageItem;
-    briefMarkdown?: string;
-}): import("react").JSX.Element;

package/research/ResearchArticle.js

@@ -1,25 +0,0 @@
-import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
-import ReactMarkdown from 'react-markdown';
-import remarkGfm from 'remark-gfm';
-import { youtubeId } from './catalog';
-import { CoverageHistory } from './CoverageHistory';
-/**
- * The full coverage report: native video, the Q&A podcast (surfaced as a prominent
- * "Listen" card right under the video), then the brief rendered from markdown (its own
- * leading H1 is stripped — we render the title above it), and the continuing-coverage
- * history. Works in a server component (SSR'd for SEO) or a client one.
- * Theme-aware: readable in both light and dark. The prose body sets an explicit
- * light + `dark:` color for every element it renders (headings, p, strong, em, links,
- * lists, code, blockquote, hr, tables) rather than relying on `prose-invert` /
- * `dark:prose-invert` — the latter doesn't resolve from a `.dark` class in the
- * Tailwind v4 + typography-plugin setup these apps use.
- */
-export function ResearchArticle({ item, briefMarkdown, }) {
-    var _a;
-    const body = (briefMarkdown || '').replace(/^#\s.*(\r?\n)+/, '');
-    const ytId = youtubeId(item.youtube_url);
-    const podcastYtId = youtubeId(item.podcast_youtube_url);
-    return (_jsxs("article", { className: "mx-auto max-w-3xl", children: [_jsxs("div", { className: "mb-3 flex flex-wrap items-center gap-2 text-sm text-gray-500 dark:text-gray-400", children: [_jsxs("span", { className: "rounded bg-cyan-500/10 px-2 py-0.5 font-semibold text-cyan-600 dark:text-cyan-400", children: [item.company, " \u00B7 ", item.ticker] }), item.coverage_label && _jsx("span", { children: item.coverage_label }), _jsx("span", { children: (_a = item.date) === null || _a === void 0 ? void 0 : _a.slice(0, 10) })] }), _jsx("h1", { className: "mb-6 text-3xl font-bold text-gray-900 dark:text-white", children: item.title }), ytId ? (_jsx("div", { className: "mb-8 aspect-video w-full overflow-hidden rounded-xl bg-black", children: _jsx("iframe", { className: "h-full w-full", src: `https://www.youtube.com/embed/${ytId}`, title: item.title, loading: "lazy", allow: "accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share", allowFullScreen: true }) })) : (item.assets.video && (_jsx("video", { controls: true, poster: item.assets.thumbnail, src: item.assets.video, className: "mb-8 aspect-video w-full rounded-xl bg-black" }))), (item.assets.podcast_mp3 || podcastYtId) && (_jsx("section", { className: "mb-8", children: item.assets.podcast_mp3 ? (_jsxs("div", { className: "rounded-xl border border-cyan-500/30 bg-cyan-50/60 p-4 dark:bg-gray-900/50", children: [_jsxs("div", { className: "mb-2 flex items-center justify-between gap-3", children: [_jsx("p", { className: "text-sm font-semibold text-cyan-600 dark:text-cyan-400", children: "\uD83C\uDF99 Listen \u2014 Q&A podcast" }), podcastYtId && (_jsx("a", { href: item.podcast_youtube_url, target: "_blank", rel: "noopener noreferrer", className: "shrink-0 text-xs text-cyan-600 hover:underline dark:text-cyan-400", children: "Watch on YouTube \u2197" }))] }), _jsx("audio", { controls: true, preload: "none", src: item.assets.podcast_mp3, className: "w-full" })] })) : (
-                // no MP3 yet — fall back to the YouTube video player
-                _jsxs(_Fragment, { children: [_jsx("h2", { className: "mb-3 text-xl font-bold text-gray-900 dark:text-white", children: "Listen \u2014 Q&A podcast" }), _jsx("div", { className: "aspect-video w-full overflow-hidden rounded-xl bg-black", children: _jsx("iframe", { className: "h-full w-full", src: `https://www.youtube.com/embed/${podcastYtId}`, title: `${item.title} — Q&A podcast`, loading: "lazy", allow: "accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share", allowFullScreen: true }) })] })) })), body && (_jsx("div", { className: "prose prose-lg prose-headings:font-heading prose-headings:font-bold prose-headings:text-gray-900 dark:prose-headings:text-white prose-p:text-gray-700 dark:prose-p:text-gray-300 prose-p:leading-relaxed prose-a:text-cyan-600 dark:prose-a:text-cyan-400 prose-a:no-underline hover:prose-a:text-cyan-500 dark:hover:prose-a:text-cyan-300 prose-strong:text-gray-900 dark:prose-strong:text-white prose-strong:font-semibold prose-em:text-gray-700 dark:prose-em:text-gray-300 prose-code:text-cyan-700 dark:prose-code:text-cyan-400 prose-code:bg-gray-100 dark:prose-code:bg-gray-800 prose-code:px-2 prose-code:py-1 prose-code:rounded prose-pre:bg-gray-900 prose-pre:border prose-pre:border-gray-800 prose-blockquote:border-l-cyan-500 prose-blockquote:text-gray-600 dark:prose-blockquote:text-gray-400 prose-blockquote:italic prose-ul:text-gray-700 dark:prose-ul:text-gray-300 prose-ol:text-gray-700 dark:prose-ol:text-gray-300 prose-li:marker:text-cyan-500 prose-hr:border-gray-200 dark:prose-hr:border-gray-800 prose-table:border-gray-300 dark:prose-table:border-gray-700 prose-th:bg-gray-100 dark:prose-th:bg-gray-900 prose-th:text-gray-900 dark:prose-th:text-white prose-td:text-gray-700 dark:prose-td:text-gray-300 max-w-none", children: _jsx(ReactMarkdown, { remarkPlugins: [remarkGfm], children: body }) })), _jsx(CoverageHistory, { history: item.history }), _jsxs("footer", { className: "mt-12 border-t border-gray-200 pt-6 dark:border-gray-800", children: [_jsx("p", { className: "text-sm text-gray-500 dark:text-gray-400", children: "Audio & music produced with ElevenLabs." }), _jsxs("a", { href: "https://elevenlabs.io/startup-grants", target: "_blank", rel: "noopener noreferrer", "aria-label": "Backed by the ElevenLabs Grants program", className: "mt-3 inline-block", children: [_jsx("img", { src: "/images/logos/elevenlabs-grants.webp", alt: "Backed by the ElevenLabs Grants program", width: 200, className: "h-auto dark:hidden" }), _jsx("img", { src: "/images/logos/elevenlabs-grants-white.webp", alt: "Backed by the ElevenLabs Grants program", width: 200, className: "hidden h-auto dark:block" })] }), _jsxs("p", { className: "mt-2 text-xs text-gray-400 dark:text-gray-500", children: ["Using ElevenLabs yourself? Our", ' ', _jsx("a", { href: "https://try.elevenlabs.io/v9z3wzm97gk3", target: "_blank", rel: "noopener noreferrer", className: "hover:underline", children: "referral link" }), ' ', "costs you nothing extra and supports this research."] })] })] }));
-}

package/research/catalog.d.ts

@@ -1,14 +0,0 @@
-import type { Catalog, CoverageItem } from './types';
-export declare const CATALOG_URL: string;
-/** Fetch the full catalog. `revalidate` (seconds) drives Next ISR on the server. */
-export declare function fetchCatalog(revalidate?: number): Promise<Catalog>;
-/** All coverage items, newest first (the catalog is already sorted, but be defensive). */
-export declare function getAllCoverage(revalidate?: number): Promise<CoverageItem[]>;
-/** One company's coverage (latest + history), or null if not in the catalog. */
-export declare function getCoverage(ticker: string, revalidate?: number): Promise<CoverageItem | null>;
-/** Tickers for generateStaticParams(). */
-export declare function getCoverageTickers(): Promise<string[]>;
-/** Fetch a brief's raw markdown (rendered to HTML by ResearchArticle). */
-export declare function fetchBrief(url: string, revalidate?: number): Promise<string>;
-/** Extract a YouTube video id from a youtu.be / watch?v= / embed URL (or null). */
-export declare function youtubeId(url?: string | null): string | null;

package/research/catalog.js

@@ -1,42 +0,0 @@
-// Data access for the research catalog. The catalog is a single public JSON file served
-// via the CloudFront CDN, produced by `just reindex` in robosystems-content-machine.
-// Fetched server-side (SSG/ISR) in the public site and client-side in the logged-in app.
-export const CATALOG_URL = process.env.NEXT_PUBLIC_RESEARCH_CATALOG_URL ||
-    'https://assets.robosystems.ai/content/index.json';
-/** Fetch the full catalog. `revalidate` (seconds) drives Next ISR on the server. */
-export async function fetchCatalog(revalidate = 3600) {
-    const res = await fetch(CATALOG_URL, { next: { revalidate } });
-    if (!res.ok)
-        throw new Error(`Research catalog fetch failed: ${res.status}`);
-    return (await res.json());
-}
-/** All coverage items, newest first (the catalog is already sorted, but be defensive). */
-export async function getAllCoverage(revalidate = 3600) {
-    const { items } = await fetchCatalog(revalidate);
-    return [...items].sort((a, b) => (b.date || '').localeCompare(a.date || ''));
-}
-/** One company's coverage (latest + history), or null if not in the catalog. */
-export async function getCoverage(ticker, revalidate = 3600) {
-    const { items } = await fetchCatalog(revalidate);
-    const t = ticker.toUpperCase();
-    return items.find((i) => i.ticker.toUpperCase() === t) || null;
-}
-/** Tickers for generateStaticParams(). */
-export async function getCoverageTickers() {
-    const { items } = await fetchCatalog();
-    return items.map((i) => i.ticker);
-}
-/** Fetch a brief's raw markdown (rendered to HTML by ResearchArticle). */
-export async function fetchBrief(url, revalidate = 3600) {
-    const res = await fetch(url, { next: { revalidate } });
-    if (!res.ok)
-        throw new Error(`Brief fetch failed: ${res.status}`);
-    return await res.text();
-}
-/** Extract a YouTube video id from a youtu.be / watch?v= / embed URL (or null). */
-export function youtubeId(url) {
-    if (!url)
-        return null;
-    const m = url.match(/(?:youtu\.be\/|[?&]v=|embed\/)([A-Za-z0-9_-]{6,})/);
-    return m ? m[1] : null;
-}

package/research/index.d.ts

@@ -1,7 +0,0 @@
-export { CATALOG_URL, fetchBrief, fetchCatalog, getAllCoverage, getCoverage, getCoverageTickers, youtubeId, } from './catalog';
-export { CoverageBrowser, type CoverageBrowserProps } from './CoverageBrowser';
-export { CoverageCard } from './CoverageCard';
-export { CoverageGrid } from './CoverageGrid';
-export { CoverageHistory } from './CoverageHistory';
-export { ResearchArticle } from './ResearchArticle';
-export * from './types';

package/research/index.js

@@ -1,10 +0,0 @@
-// Research portal module — shared across robosystems-app (public/SEO) and
-// roboinvestor-app (logged-in). Data layer reads the S3 catalog produced by
-// robosystems-content-machine; components render the coverage + continuing-coverage thread.
-export { CATALOG_URL, fetchBrief, fetchCatalog, getAllCoverage, getCoverage, getCoverageTickers, youtubeId, } from './catalog';
-export { CoverageBrowser } from './CoverageBrowser';
-export { CoverageCard } from './CoverageCard';
-export { CoverageGrid } from './CoverageGrid';
-export { CoverageHistory } from './CoverageHistory';
-export { ResearchArticle } from './ResearchArticle';
-export * from './types';

package/research/types.d.ts

@@ -1,38 +0,0 @@
-export interface CoverageAssets {
-    video?: string;
-    short?: string;
-    podcast_mp3?: string;
-    podcast_mp4?: string;
-    brief?: string;
-    thumbnail?: string;
-}
-export interface CoverageVersion {
-    version: string;
-    date?: string;
-    title?: string;
-    legacy_ticker?: string;
-    youtube_url?: string;
-    assets: CoverageAssets;
-}
-export interface CoverageItem {
-    ticker: string;
-    company: string;
-    title: string;
-    summary: string;
-    tags: string[];
-    campaign?: string | null;
-    campaign_slug?: string | null;
-    coverage_label?: string | null;
-    date: string;
-    version: string;
-    youtube_url?: string;
-    short_youtube_url?: string;
-    podcast_youtube_url?: string;
-    assets: CoverageAssets;
-    history: CoverageVersion[];
-}
-export interface Catalog {
-    generated: string;
-    count: number;
-    items: CoverageItem[];
-}

package/research/types.js

@@ -1,4 +0,0 @@
-// Shared types for the equity-research catalog produced by robosystems-content-machine
-// (https://assets.robosystems.ai/content/index.json). The company is the durable
-// entity; each run is a dated quarterly report version (latest + history[]).
-export {};