@robosystems/core 0.8.9 → 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.9",
+  "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,