@robosystems/core 0.3.0

package/library/components/TaxonomySidebar.js

@@ -0,0 +1,45 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Badge, Card } from 'flowbite-react';
+const SECTION_ORDER = ['reporting', 'chart_of_accounts', 'schedule', 'mapping'];
+const SECTION_LABELS = {
+    reporting: 'Reporting',
+    chart_of_accounts: 'Chart of Accounts',
+    schedule: 'Schedules',
+    mapping: 'Mappings',
+};
+export function TaxonomySidebar({ taxonomies, selectedId, onSelect, }) {
+    var _a;
+    // Group by taxonomyType, preserve SECTION_ORDER
+    const groups = [];
+    const seen = new Set();
+    const grouped = new Map();
+    for (const t of taxonomies) {
+        const type = (_a = t.taxonomyType) !== null && _a !== void 0 ? _a : 'reporting';
+        if (!grouped.has(type))
+            grouped.set(type, []);
+        grouped.get(type).push(t);
+    }
+    for (const type of SECTION_ORDER) {
+        if (grouped.has(type)) {
+            groups.push({ type, items: grouped.get(type) });
+            seen.add(type);
+        }
+    }
+    // Any remaining types not in SECTION_ORDER
+    for (const [type, items] of grouped) {
+        if (!seen.has(type))
+            groups.push({ type, items });
+    }
+    const showSections = groups.length > 1;
+    return (_jsx("aside", { className: "col-span-12 min-h-0 md:col-span-3", children: _jsxs(Card, { className: "flex h-full flex-col overflow-hidden", children: [_jsx("h2", { className: "font-heading shrink-0 text-lg font-semibold text-gray-900 dark:text-white", children: "Taxonomies" }), _jsx("div", { className: "min-h-0 flex-1 space-y-3 overflow-y-auto", children: groups.map(({ type, items }, gi) => {
+                        var _a;
+                        return (_jsxs("div", { children: [showSections && (_jsx("div", { className: `px-1 pb-1 text-[10px] font-semibold tracking-wider text-gray-400 uppercase dark:text-gray-500 ${gi > 0 ? 'border-t border-gray-100 pt-3 dark:border-gray-700' : ''}`, children: (_a = SECTION_LABELS[type]) !== null && _a !== void 0 ? _a : type })), _jsx("ul", { className: "space-y-1", children: items.map((t) => {
+                                        var _a, _b;
+                                        const isSelected = t.id === selectedId;
+                                        return (_jsx("li", { children: _jsxs("button", { onClick: () => onSelect(t.id), className: `w-full rounded px-3 py-2 text-left text-sm transition-colors ${isSelected
+                                                    ? 'bg-primary-100 text-primary-900 dark:bg-primary-900/50 dark:text-primary-100'
+                                                    : 'text-gray-700 hover:bg-gray-100 dark:text-gray-200 dark:hover:bg-gray-800'}`, children: [_jsxs("div", { className: "flex items-center justify-between gap-2", children: [t.standard ? (_jsxs("span", { className: "truncate font-mono text-xs", title: `${t.standard}/${(_a = t.version) !== null && _a !== void 0 ? _a : ''}`, children: [t.standard, _jsxs("span", { className: "text-gray-400 dark:text-gray-500", children: ["/", (_b = t.version) !== null && _b !== void 0 ? _b : ''] })] })) : (_jsx("span", { className: "truncate text-xs font-medium", title: t.name, children: t.name })), t.elementCount !== null && (_jsx(Badge, { color: "gray", size: "xs", className: "shrink-0", children: t.elementCount.toLocaleString() }))] }), t.standard && (_jsx("div", { className: "truncate text-xs text-gray-500 dark:text-gray-400", title: t.name, children: t.name }))] }) }, t.id));
+                                    }) })] }, type));
+                    }) })] }) }));
+}

package/library/index.d.ts

@@ -0,0 +1,8 @@
+export { LIBRARY_GRAPH_ID, LibraryClient } from '@robosystems/client/clients';
+export type { GetLibraryElementIdentifier, LibraryArc, LibraryElement, LibraryElementArc, LibraryElementClassification, LibraryElementDetail, LibraryEquivalence, LibraryLabel, LibraryReference, LibrarySearchResult, LibraryStructure, LibraryTaxonomy, LibraryTaxonomyDetail, ListLibraryElementsOptions, ListLibraryStructuresOptions, ListLibraryTaxonomyArcsOptions, ListLibraryTaxonomyArcsResult, SearchLibraryElementsOptions, } from '@robosystems/client/clients';
+export { arcTypeColor, classificationColor } from './colors';
+export { ClassificationPicker } from './components/ClassificationPicker';
+export { ElementBrowser } from './components/ElementBrowser';
+export { ElementDetail } from './components/ElementDetail';
+export { LibraryHierarchy } from './components/LibraryHierarchy';
+export { TaxonomySidebar } from './components/TaxonomySidebar';

package/library/index.js

@@ -0,0 +1,7 @@
+export { LIBRARY_GRAPH_ID, LibraryClient } from '@robosystems/client/clients';
+export { arcTypeColor, classificationColor } from './colors';
+export { ClassificationPicker } from './components/ClassificationPicker';
+export { ElementBrowser } from './components/ElementBrowser';
+export { ElementDetail } from './components/ElementDetail';
+export { LibraryHierarchy } from './components/LibraryHierarchy';
+export { TaxonomySidebar } from './components/TaxonomySidebar';

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@robosystems/core",
+  "version": "0.3.0",
+  "description": "Shared RoboSystems frontend core library (auth, contexts, task monitoring, UI components) for the RoboSystems Next.js apps",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "sideEffects": [
+    "./index.js"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RoboFinSystems/robosystems-core.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "react-markdown": "^10",
+    "remark-gfm": "^4.0.1",
+    "tailwind-merge": "^3"
+  },
+  "peerDependencies": {
+    "@robosystems/client": ">=0.3.2 <1",
+    "flowbite-react": "^0.12.5",
+    "next": ">=15 <17",
+    "react": ">=18 <20",
+    "react-dom": ">=18 <20",
+    "react-icons": ">=4 <6"
+  }
+}

package/research/CoverageCard.d.ts

@@ -0,0 +1,12 @@
+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

@@ -0,0 +1,15 @@
+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 && (
+                // eslint-disable-next-line @next/next/no-img-element
+                _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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,5 @@
+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

@@ -0,0 +1,7 @@
+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

@@ -0,0 +1,15 @@
+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.
+ * Styled for a dark background — render inside a dark (`bg-black`/`.dark`) container.
+ * The prose styling mirrors the blog article body so research reads consistently with it
+ * (explicit `prose-invert` + element overrides rather than `dark:prose-invert`, which the
+ * Tailwind v4 + typography-plugin setup in these apps does not resolve from a `.dark` class).
+ */
+export declare function ResearchArticle({ item, briefMarkdown, }: {
+    item: CoverageItem;
+    briefMarkdown?: string;
+}): import("react").JSX.Element;

package/research/ResearchArticle.js

@@ -0,0 +1,26 @@
+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.
+ * Styled for a dark background — render inside a dark (`bg-black`/`.dark`) container.
+ * The prose styling mirrors the blog article body so research reads consistently with it
+ * (explicit `prose-invert` + element overrides rather than `dark:prose-invert`, which the
+ * Tailwind v4 + typography-plugin setup in these apps does not resolve from a `.dark` class).
+ */
+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 && (
+            // eslint-disable-next-line jsx-a11y/media-has-caption
+            _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-gray-900/50 p-4", 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-invert prose-headings:font-heading prose-headings:font-bold prose-headings:text-white prose-p:text-gray-300 prose-p:leading-relaxed prose-a:text-cyan-400 prose-a:no-underline hover:prose-a:text-cyan-300 prose-strong:text-white prose-strong:font-semibold prose-code:text-cyan-400 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-400 prose-blockquote:italic prose-ul:text-gray-300 prose-ol:text-gray-300 prose-li:marker:text-cyan-500 prose-table:border-gray-700 prose-th:bg-gray-900 prose-th:text-white 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

@@ -0,0 +1,14 @@
+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

@@ -0,0 +1,42 @@
+// 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

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

package/research/index.js

@@ -0,0 +1,9 @@
+// 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 { CoverageCard } from './CoverageCard';
+export { CoverageGrid } from './CoverageGrid';
+export { CoverageHistory } from './CoverageHistory';
+export { ResearchArticle } from './ResearchArticle';
+export * from './types';

package/research/types.d.ts

@@ -0,0 +1,38 @@
+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

@@ -0,0 +1,4 @@
+// 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 {};

package/task-monitoring/hooks.d.ts

@@ -0,0 +1,26 @@
+import type { TaskMonitorState } from './types';
+export interface UseTaskMonitoringResult extends TaskMonitorState {
+    startMonitoring: (taskId: string, options?: {
+        maxAttempts?: number;
+        pollInterval?: number;
+    }) => Promise<any>;
+    cancelTask: () => Promise<void>;
+    reset: () => void;
+}
+export declare function useTaskMonitoring(): UseTaskMonitoringResult;
+export declare function useEntityCreationTask(): {
+    createEntityWithGraph: (entityData: any) => Promise<any>;
+    startMonitoring: (taskId: string, options?: {
+        maxAttempts?: number;
+        pollInterval?: number;
+    }) => Promise<any>;
+    cancelTask: () => Promise<void>;
+    reset: () => void;
+    isLoading: boolean;
+    progress: number | null;
+    currentStep: string | null;
+    error: string | null;
+    taskId: string | null;
+    result: any | null;
+};
+export declare function getProgressFromStep(step?: string | null): number;

package/task-monitoring/hooks.js

@@ -0,0 +1,126 @@
+'use client';
+import * as SDK from '@robosystems/client';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { taskMonitor } from './taskMonitor';
+export function useTaskMonitoring() {
+    const [state, setState] = useState({
+        isLoading: false,
+        progress: null,
+        currentStep: null,
+        error: null,
+        taskId: null,
+        result: null,
+    });
+    const currentTaskId = useRef(null);
+    const reset = useCallback(() => {
+        setState({
+            isLoading: false,
+            progress: null,
+            currentStep: null,
+            error: null,
+            taskId: null,
+            result: null,
+        });
+        currentTaskId.current = null;
+    }, []);
+    const cancelTask = useCallback(async () => {
+        if (currentTaskId.current) {
+            try {
+                await taskMonitor.cancelTask(currentTaskId.current);
+                setState((prev) => (Object.assign(Object.assign({}, prev), { isLoading: false, error: 'Task was cancelled', result: null })));
+            }
+            catch (error) {
+                console.error('Failed to cancel task:', error);
+                setState((prev) => (Object.assign(Object.assign({}, prev), { error: 'Failed to cancel task', result: null })));
+            }
+        }
+    }, []);
+    const startMonitoring = useCallback(async (taskId, options) => {
+        currentTaskId.current = taskId;
+        setState({
+            isLoading: true,
+            progress: null,
+            currentStep: null,
+            error: null,
+            taskId,
+            result: null,
+        });
+        try {
+            const result = await taskMonitor.pollTask({
+                taskId,
+                maxAttempts: options === null || options === void 0 ? void 0 : options.maxAttempts,
+                pollInterval: options === null || options === void 0 ? void 0 : options.pollInterval,
+                onProgress: (status) => {
+                    setState((prev) => (Object.assign(Object.assign({}, prev), { progress: status.progress || null, currentStep: status.step || status.message || 'Processing...' })));
+                },
+                onComplete: (result) => {
+                    setState((prev) => (Object.assign(Object.assign({}, prev), { isLoading: false, progress: 100, currentStep: 'Completed', result: result })));
+                },
+                onError: (errorMsg) => {
+                    setState((prev) => (Object.assign(Object.assign({}, prev), { isLoading: false, error: errorMsg, result: null })));
+                },
+            });
+            return result.details || result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            setState((prev) => (Object.assign(Object.assign({}, prev), { isLoading: false, error: errorMessage, result: null })));
+            throw error;
+        }
+        finally {
+            currentTaskId.current = null;
+        }
+    }, []);
+    // Cleanup on unmount
+    useEffect(() => {
+        return () => {
+            if (currentTaskId.current) {
+                taskMonitor.cancelTask(currentTaskId.current);
+            }
+        };
+    }, []);
+    return Object.assign(Object.assign({}, state), { startMonitoring,
+        cancelTask,
+        reset });
+}
+// Convenience hook for entity creation specifically
+export function useEntityCreationTask() {
+    const taskMonitoring = useTaskMonitoring();
+    const createEntityWithGraph = useCallback(async (entityData) => {
+        try {
+            // Call the SDK function to create company with new graph
+            // Note: createCompanyWithNewGraph function does not exist in SDK
+            // This is a placeholder implementation
+            const response = await SDK.createGraph({
+                body: entityData,
+            });
+            const responseData = response.data;
+            if (!(responseData === null || responseData === void 0 ? void 0 : responseData.operationId)) {
+                throw new Error('No operation ID returned from company creation');
+            }
+            // Start monitoring the task
+            const result = await taskMonitoring.startMonitoring(responseData.operationId);
+            return result;
+        }
+        catch (error) {
+            console.error('Company creation failed:', error);
+            throw error;
+        }
+    }, [taskMonitoring]);
+    return Object.assign(Object.assign({}, taskMonitoring), { createEntityWithGraph });
+}
+// Helper function to get progress percentage from step name
+export function getProgressFromStep(step) {
+    if (!step)
+        return 0;
+    const stepProgress = {
+        initializing: 10,
+        checking_mode: 20,
+        creating_database: 40,
+        installing_labels: 60,
+        creating_company: 80,
+        updating_user_graph: 90,
+        completed: 100,
+    };
+    return stepProgress[step.toLowerCase()] || 0;
+}

package/task-monitoring/index.d.ts

@@ -0,0 +1,5 @@
+export * from './hooks';
+export * from './taskMonitor';
+export * from './types';
+export * from './operationHooks';
+export * from './operationMonitor';

package/task-monitoring/index.js

@@ -0,0 +1,7 @@
+// Legacy exports (for backward compatibility)
+export * from './hooks';
+export * from './taskMonitor';
+export * from './types';
+// New operation-based exports
+export * from './operationHooks';
+export * from './operationMonitor';

package/task-monitoring/operationErrors.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Error handling for operation-based monitoring
+ */
+export declare enum OperationErrorCode {
+    CONNECTION_FAILED = "CONNECTION_FAILED",
+    CONNECTION_LOST = "CONNECTION_LOST",
+    TIMEOUT = "TIMEOUT",
+    OPERATION_NOT_FOUND = "OPERATION_NOT_FOUND",
+    OPERATION_CANCELLED = "OPERATION_CANCELLED",
+    OPERATION_FAILED = "OPERATION_FAILED",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    FORBIDDEN = "FORBIDDEN",
+    INSUFFICIENT_CREDITS = "INSUFFICIENT_CREDITS",
+    RESOURCE_NOT_FOUND = "RESOURCE_NOT_FOUND",
+    RESOURCE_LOCKED = "RESOURCE_LOCKED",
+    RESOURCE_LIMIT_EXCEEDED = "RESOURCE_LIMIT_EXCEEDED",
+    INVALID_INPUT = "INVALID_INPUT",
+    INVALID_QUERY = "INVALID_QUERY",
+    SCHEMA_VIOLATION = "SCHEMA_VIOLATION",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    RATE_LIMITED = "RATE_LIMITED"
+}
+export declare class OperationError extends Error {
+    code: OperationErrorCode;
+    details?: any;
+    constructor(code: OperationErrorCode, message: string, details?: any);
+    /**
+     * Check if error is recoverable
+     */
+    isRecoverable(): boolean;
+    /**
+     * Check if error requires user action
+     */
+    requiresUserAction(): boolean;
+    /**
+     * Get user-friendly message
+     */
+    getUserMessage(): string;
+    /**
+     * Get recommended action for the user
+     */
+    getRecommendedAction(): string | null;
+}
+/**
+ * Parse SSE error events into OperationError
+ */
+export declare function parseOperationError(event: any): OperationError;
+/**
+ * Error recovery strategies
+ */
+export declare class ErrorRecovery {
+    private retryCount;
+    private readonly maxRetries;
+    private readonly baseDelay;
+    /**
+     * Determine if we should retry
+     */
+    shouldRetry(operationId: string, error: OperationError): boolean;
+    /**
+     * Get retry delay with exponential backoff
+     */
+    getRetryDelay(operationId: string): number;
+    /**
+     * Reset retry count for an operation
+     */
+    reset(operationId: string): void;
+    /**
+     * Clear all retry counts
+     */
+    clear(): void;
+}
+/**
+ * Error notification helper
+ */
+export interface ErrorNotification {
+    title: string;
+    message: string;
+    action?: string;
+    severity: 'info' | 'warning' | 'error';
+}
+export declare function createErrorNotification(error: OperationError): ErrorNotification;