@robosystems/core 0.12.0 → 0.13.1

package/components/console/ConsoleContent.d.ts

@@ -1,4 +1,6 @@
 import type { ConsoleConfig } from './types';
-export declare function ConsoleContent({ config }: {
+export declare function ConsoleContent({ config, variant, }: {
     config: ConsoleConfig;
+    /** `panel` drops the page header and fills its container (the drawer). */
+    variant?: 'page' | 'panel';
 }): import("react").JSX.Element;

package/components/console/ConsoleContent.js

@@ -6,6 +6,7 @@ import { useCallback, useEffect, useRef, useState } from 'react';
 import { HiTerminal } from 'react-icons/hi';
 import { useGraphContext } from '../../contexts';
 import { useStreamingQuery } from '../../hooks';
+import { emitGraphWrites, readGraphWrites, } from '../../lib/graph-writes';
 import { ConsoleMarkdown } from './ConsoleMarkdown';
 import { ProgressiveText } from './ProgressiveText';
 function generateMessageId() {
@@ -53,11 +54,28 @@ function downloadText(filename, text, mime) {
     anchor.click();
     URL.revokeObjectURL(url);
 }
+const WRITE_LABELS = {
+    'create-taxonomy-block': 'Created taxonomy block',
+    'create-information-block': 'Created block',
+    'update-information-block': 'Updated block',
+    'assert-metrics': 'Asserted metrics',
+    'compute-metrics': 'Computed metrics',
+    'compute-forecast': 'Computed forecast',
+    'create-agent': 'Created counterparty',
+    'update-agent': 'Updated counterparty',
+    remember: 'Saved memory',
+};
+function describeWrite(write) {
+    var _a, _b;
+    const label = (_a = WRITE_LABELS[write.operation]) !== null && _a !== void 0 ? _a : write.operation;
+    const subject = (_b = write.name) !== null && _b !== void 0 ? _b : write.id;
+    return subject ? `${label}: ${subject}` : label;
+}
 function copyRowsJson(rows) {
     var _a;
     (_a = navigator.clipboard) === null || _a === void 0 ? void 0 : _a.writeText(JSON.stringify(rows, null, 2));
 }
-export function ConsoleContent({ config }) {
+export function ConsoleContent({ config, variant = 'page', }) {
     const { state: graphState } = useGraphContext();
     const graphId = graphState.currentGraphId;
     const streamingQuery = useStreamingQuery();
@@ -102,6 +120,9 @@ export function ConsoleContent({ config }) {
             (config.enableRecall
                 ? `  /recall     - Recall semantic memories\n`
                 : '') +
+            (config.enableAuthor
+                ? `  /do         - Make a change (a block, a counterparty, a memory)\n`
+                : '') +
             `  /mcp        - Connect an MCP client (sign in — no key)\n` +
             `  /mcp key    - Mint a graph-scoped API key for header-only clients\n` +
             `  /help       - Show this help message\n` +
@@ -145,6 +166,7 @@ export function ConsoleContent({ config }) {
         setTerminalMessages((prev) => [...prev, message]);
     }, []);
     const addResultMessage = useCallback((content, data, cypher, opts) => {
+        var _a;
         const message = {
             id: generateMessageId(),
             type: 'system',
@@ -154,6 +176,7 @@ export function ConsoleContent({ config }) {
             cypher,
             markdown: opts === null || opts === void 0 ? void 0 : opts.markdown,
             footer: opts === null || opts === void 0 ? void 0 : opts.footer,
+            writes: ((_a = opts === null || opts === void 0 ? void 0 : opts.writes) === null || _a === void 0 ? void 0 : _a.length) ? opts.writes : undefined,
         };
         setTerminalMessages((prev) => [...prev, message]);
     }, []);
@@ -328,7 +351,9 @@ export function ConsoleContent({ config }) {
             setCurrentQueryStartTime(null);
         }
     };
-    const executeOperatorQuery = async (userQuery) => {
+    // `operatorType` names an operator (`author` for /do); unset, the API
+    // chooses one for a question.
+    const executeOperatorQuery = async (userQuery, operatorType) => {
         var _a;
         if (!graphId) {
             addErrorMessage(config.noSelectionError);
@@ -342,10 +367,11 @@ export function ConsoleContent({ config }) {
         try {
             const { clients } = await import('@robosystems/client/clients');
             const history = conversationRef.current;
-            const result = await clients.operator.executeQuery(graphId, Object.assign({ message: userQuery, 
+            const request = Object.assign({ message: userQuery, 
                 // `standard` gives the operator loop six tool turns; `quick` (three)
                 // was exhausted by schema + examples before the first query ran.
-                mode: 'standard' }, (history.length > 0 ? { history } : {})), {
+                mode: 'standard' }, (history.length > 0 ? { history } : {}));
+            const options = {
                 mode: 'auto',
                 onProgress: (message, percentage) => {
                     if (isStale())
@@ -356,7 +382,10 @@ export function ConsoleContent({ config }) {
                         percentage,
                     });
                 },
-            });
+            };
+            const result = operatorType
+                ? await clients.operator.executeOperator(graphId, operatorType, request, options)
+                : await clients.operator.executeQuery(graphId, request, options);
             // The user switched graphs while the operator ran: the reset already
             // cleared the console, so drop the answer rather than print it (and
             // record it as history) under the new graph.
@@ -378,6 +407,9 @@ export function ConsoleContent({ config }) {
             }
             const duration = Date.now() - startTime;
             const metadata = (result.metadata || {});
+            const writes = readGraphWrites(metadata);
+            // Pages showing this graph reload what the console just changed.
+            emitGraphWrites(requestGraphId, writes);
             const creditsUsed = metadata.credits_consumed;
             const resultCount = metadata.result_count;
             // Prefer the structured outputs the operator loop now returns
@@ -429,7 +461,11 @@ export function ConsoleContent({ config }) {
             // otherwise collapse under markdown). With no narrative, fall back to the
             // plain footer, matching the direct-query result style.
             if (narrative) {
-                addResultMessage(narrative, rows, cypher, { markdown: true, footer });
+                addResultMessage(narrative, rows, cypher, {
+                    markdown: true,
+                    footer,
+                    writes,
+                });
                 // Record the exchange for follow-ups. Only a narrative answer is
                 // worth carrying; the answer is clipped so history stays cheap.
                 conversationRef.current = [
@@ -439,7 +475,7 @@ export function ConsoleContent({ config }) {
                 ].slice(-6);
             }
             else {
-                addResultMessage(footer, rows, cypher);
+                addResultMessage(footer, rows, cypher, { writes });
             }
         }
         catch (error) {
@@ -596,6 +632,17 @@ export function ConsoleContent({ config }) {
             }
             return;
         }
+        // Handle /do — the author operator, which may change the graph. Writes
+        // are never inferred from a question; they need this command.
+        if (config.enableAuthor && /^\/do(\s|$)/i.test(command)) {
+            const request = command.slice(3).trim();
+            if (!request) {
+                addErrorMessage('Usage: /do <change>\n\nExamples:\n  /do add Notion Labs as a vendor\n  /do remember that we report ARPC on subscription revenue only');
+                return;
+            }
+            await executeOperatorQuery(request, 'author');
+            return;
+        }
         // Handle /recall command — built-in only when the target supports
         // semantic memory (user graphs; shared repositories reject it). When
         // disabled it falls through to the unknown-command branch below.
@@ -691,10 +738,11 @@ export function ConsoleContent({ config }) {
     };
     // ── Render ──────────────────────────────────────────────────────────
     const { header } = config;
-    return (_jsxs("div", { className: "mx-auto max-w-7xl space-y-6 p-4 sm:p-6", children: [_jsxs("div", { className: "flex flex-col gap-2 sm:flex-row sm:items-start sm:justify-between sm:gap-4", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-3 sm:gap-4", children: [_jsx("div", { className: `shrink-0 rounded-lg bg-gradient-to-br ${header.gradientFrom} ${header.gradientTo} p-2.5 sm:p-3`, children: _jsx(HiTerminal, { className: "h-6 w-6 text-white sm:h-8 sm:w-8" }) }), _jsxs("div", { className: "min-w-0", children: [_jsx("h1", { className: "font-heading text-2xl font-bold break-words text-gray-900 sm:text-3xl dark:text-white", children: header.title }), _jsx("p", { className: "mt-1 text-sm break-words text-gray-500 dark:text-gray-400", children: header.subtitle })] })] }), (streamingQuery.isStreaming || operatorProgress.isRunning) && (_jsxs("div", { className: "flex items-center gap-2 text-sm text-gray-600 dark:text-gray-400", children: [_jsx("span", { className: "inline-block h-2 w-2 animate-pulse rounded-full bg-green-500" }), operatorProgress.isRunning && operatorProgress.message
+    const isPanel = variant === 'panel';
+    return (_jsxs("div", { className: isPanel ? 'h-full' : 'mx-auto max-w-7xl space-y-6 p-4 sm:p-6', children: [!isPanel && (_jsxs("div", { className: "flex flex-col gap-2 sm:flex-row sm:items-start sm:justify-between sm:gap-4", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-3 sm:gap-4", children: [_jsx("div", { className: `shrink-0 rounded-lg bg-gradient-to-br ${header.gradientFrom} ${header.gradientTo} p-2.5 sm:p-3`, children: _jsx(HiTerminal, { className: "h-6 w-6 text-white sm:h-8 sm:w-8" }) }), _jsxs("div", { className: "min-w-0", children: [_jsx("h1", { className: "font-heading text-2xl font-bold break-words text-gray-900 sm:text-3xl dark:text-white", children: header.title }), _jsx("p", { className: "mt-1 text-sm break-words text-gray-500 dark:text-gray-400", children: header.subtitle })] })] }), (streamingQuery.isStreaming || operatorProgress.isRunning) && (_jsxs("div", { className: "flex items-center gap-2 text-sm text-gray-600 dark:text-gray-400", children: [_jsx("span", { className: "inline-block h-2 w-2 animate-pulse rounded-full bg-green-500" }), operatorProgress.isRunning && operatorProgress.message
                                 ? operatorProgress.message
                                 : 'Processing...', operatorProgress.percentage !== undefined &&
-                                ` (${operatorProgress.percentage}%)`] }))] }), _jsx(Card, { className: "overflow-hidden bg-gray-950 !p-0 [&>div]:!p-0", children: _jsxs("div", { className: "flex flex-col bg-gray-950", style: { height: 'calc(100vh - 280px)' }, children: [_jsxs("div", { ref: terminalScrollRef, className: "flex-1 overflow-y-auto p-4 font-mono text-sm", children: [terminalMessages.map((message) => (_jsxs("div", { className: "mb-4", children: [_jsxs("div", { className: "mb-1 flex items-center gap-2 text-xs text-gray-700", children: [_jsx("span", { children: message.timestamp.toLocaleTimeString() }), _jsx("span", { children: "-" }), _jsx("span", { className: "tracking-wider uppercase", children: message.type })] }), _jsxs("div", { className: `leading-relaxed break-words ${message.markdown && !message.isAnimating
+                                ` (${operatorProgress.percentage}%)`] }))] })), _jsx(Card, { className: `overflow-hidden bg-gray-950 !p-0 [&>div]:!p-0 ${isPanel ? 'h-full rounded-none border-0 [&>div]:h-full' : ''}`, children: _jsxs("div", { className: "flex flex-col bg-gray-950", style: { height: isPanel ? '100%' : 'calc(100vh - 280px)' }, children: [_jsxs("div", { ref: terminalScrollRef, className: "flex-1 overflow-y-auto p-4 font-mono text-sm", children: [terminalMessages.map((message) => (_jsxs("div", { className: "mb-4", children: [_jsxs("div", { className: "mb-1 flex items-center gap-2 text-xs text-gray-700", children: [_jsx("span", { children: message.timestamp.toLocaleTimeString() }), _jsx("span", { children: "-" }), _jsx("span", { className: "tracking-wider uppercase", children: message.type })] }), _jsxs("div", { className: `leading-relaxed break-words ${message.markdown && !message.isAnimating
                                                 ? ''
                                                 : 'whitespace-pre-wrap'} ${message.type === 'system'
                                                 ? 'text-cyan-400'
@@ -702,7 +750,10 @@ export function ConsoleContent({ config }) {
                                                     ? 'text-green-400'
                                                     : message.type === 'error'
                                                         ? 'text-red-400'
-                                                        : 'text-gray-300'}`, children: [message.type === 'user' && (_jsx("span", { className: "mr-2 text-green-500", children: "$" })), message.isAnimating ? (_jsx(ProgressiveText, { text: message.content, onComplete: () => handleAnimationComplete(message.id), onUpdate: scrollToBottom })) : message.markdown ? (_jsx(ConsoleMarkdown, { content: message.content })) : (message.content)] }), message.footer && (_jsx("div", { className: "mt-3 text-xs whitespace-pre-wrap text-gray-500", children: message.footer })), message.cypher && (_jsxs("div", { className: "mt-3 overflow-hidden rounded border border-gray-800 bg-gray-900/40", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-gray-800 px-3 py-1.5", children: [_jsx("span", { className: "text-xs tracking-wider text-gray-500 uppercase", children: "Generated Cypher" }), _jsx("button", { onClick: () => { var _a; return handleCommand(`/query ${(_a = message.cypher) !== null && _a !== void 0 ? _a : ''}`); }, className: "rounded bg-cyan-600/90 px-2 py-0.5 text-xs font-medium text-white transition-colors hover:bg-cyan-600", children: "Run" })] }), _jsx("pre", { className: "overflow-x-auto px-3 py-2 font-mono text-xs whitespace-pre-wrap text-cyan-300", children: message.cypher })] })), message.data && message.data.length > 0 && (_jsxs("div", { className: "mt-3 overflow-hidden rounded border border-gray-800", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-gray-800 bg-gray-900 px-4 py-2", children: [_jsxs("span", { className: "text-xs text-gray-500", children: [message.data.length, " row", message.data.length === 1 ? '' : 's'] }), _jsxs("div", { className: "flex gap-2", children: [_jsx("button", { onClick: () => copyRowsJson(message.data), className: "rounded border border-gray-700 px-2 py-0.5 text-xs text-gray-300 transition-colors hover:bg-gray-800", children: "Copy JSON" }), _jsx("button", { onClick: () => downloadText('results.csv', rowsToCsv(message.data), 'text/csv'), className: "rounded border border-gray-700 px-2 py-0.5 text-xs text-gray-300 transition-colors hover:bg-gray-800", children: "Download CSV" })] })] }), _jsx("div", { className: "max-h-96 overflow-auto", children: _jsxs("table", { className: "w-full border-collapse text-xs", children: [_jsx("thead", { className: "sticky top-0", children: _jsx("tr", { className: "border-b border-gray-800 bg-gray-900", children: Object.keys(message.data[0]).map((key) => (_jsx("th", { className: "px-4 py-2 text-left font-semibold whitespace-nowrap text-cyan-400", children: key }, key))) }) }), _jsx("tbody", { children: message.data
+                                                        : 'text-gray-300'}`, children: [message.type === 'user' && (_jsx("span", { className: "mr-2 text-green-500", children: "$" })), message.isAnimating ? (_jsx(ProgressiveText, { text: message.content, onComplete: () => handleAnimationComplete(message.id), onUpdate: scrollToBottom })) : message.markdown ? (_jsx(ConsoleMarkdown, { content: message.content })) : (message.content)] }), message.writes && (_jsxs("div", { className: "mt-3 rounded border border-emerald-900/60 bg-emerald-950/30 px-3 py-2", children: [_jsx("div", { className: "text-xs tracking-wider text-emerald-400 uppercase", children: "Changes made" }), _jsx("ul", { className: "mt-1 space-y-0.5 text-sm text-emerald-200", children: message.writes.map((write, idx) => {
+                                                        var _a;
+                                                        return (_jsxs("li", { children: ["\u2713 ", describeWrite(write)] }, `${write.operation}-${(_a = write.id) !== null && _a !== void 0 ? _a : idx}`));
+                                                    }) })] })), message.footer && (_jsx("div", { className: "mt-3 text-xs whitespace-pre-wrap text-gray-500", children: message.footer })), message.cypher && (_jsxs("div", { className: "mt-3 overflow-hidden rounded border border-gray-800 bg-gray-900/40", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-gray-800 px-3 py-1.5", children: [_jsx("span", { className: "text-xs tracking-wider text-gray-500 uppercase", children: "Generated Cypher" }), _jsx("button", { onClick: () => { var _a; return handleCommand(`/query ${(_a = message.cypher) !== null && _a !== void 0 ? _a : ''}`); }, className: "rounded bg-cyan-600/90 px-2 py-0.5 text-xs font-medium text-white transition-colors hover:bg-cyan-600", children: "Run" })] }), _jsx("pre", { className: "overflow-x-auto px-3 py-2 font-mono text-xs whitespace-pre-wrap text-cyan-300", children: message.cypher })] })), message.data && message.data.length > 0 && (_jsxs("div", { className: "mt-3 overflow-hidden rounded border border-gray-800", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-gray-800 bg-gray-900 px-4 py-2", children: [_jsxs("span", { className: "text-xs text-gray-500", children: [message.data.length, " row", message.data.length === 1 ? '' : 's'] }), _jsxs("div", { className: "flex gap-2", children: [_jsx("button", { onClick: () => copyRowsJson(message.data), className: "rounded border border-gray-700 px-2 py-0.5 text-xs text-gray-300 transition-colors hover:bg-gray-800", children: "Copy JSON" }), _jsx("button", { onClick: () => downloadText('results.csv', rowsToCsv(message.data), 'text/csv'), className: "rounded border border-gray-700 px-2 py-0.5 text-xs text-gray-300 transition-colors hover:bg-gray-800", children: "Download CSV" })] })] }), _jsx("div", { className: "max-h-96 overflow-auto", children: _jsxs("table", { className: "w-full border-collapse text-xs", children: [_jsx("thead", { className: "sticky top-0", children: _jsx("tr", { className: "border-b border-gray-800 bg-gray-900", children: Object.keys(message.data[0]).map((key) => (_jsx("th", { className: "px-4 py-2 text-left font-semibold whitespace-nowrap text-cyan-400", children: key }, key))) }) }), _jsx("tbody", { children: message.data
                                                                     .slice(0, MAX_TABLE_ROWS)
                                                                     .map((row, idx) => (_jsx("tr", { className: "border-b border-gray-900 hover:bg-gray-900/50", children: Object.keys(message.data[0]).map((key) => {
                                                                         const value = row[key];

package/components/console/ConsoleDrawer.d.ts

@@ -0,0 +1,15 @@
+import type { ConsoleConfig } from './types';
+/** Height of the closed drawer's bar. */
+export declare const CONSOLE_DRAWER_BAR_HEIGHT = 32;
+/** Set on <html> to the space the drawer covers; pad page content by it. */
+export declare const CONSOLE_DRAWER_HEIGHT_VAR = "--console-drawer-height";
+/**
+ * The console as a bottom panel, like VS Code's: a thin bar when closed, a
+ * resizable panel when open, toggled with Ctrl+`. It stays mounted once
+ * opened, so the conversation survives closing it. `className` positions it,
+ * e.g. an offset for the app's sidebar.
+ */
+export declare function ConsoleDrawer({ config, className, }: {
+    config: ConsoleConfig;
+    className?: string;
+}): import("react").JSX.Element;

package/components/console/ConsoleDrawer.js

@@ -0,0 +1,129 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { HiChevronDown, HiChevronUp, HiOutlineArrowsExpand, HiOutlineMinus, HiTerminal, } from 'react-icons/hi';
+import { ConsoleContent } from './ConsoleContent';
+const STORAGE_KEY = 'robosystems:console-drawer';
+/** Height of the closed drawer's bar. */
+export const CONSOLE_DRAWER_BAR_HEIGHT = 32;
+/** Set on <html> to the space the drawer covers; pad page content by it. */
+export const CONSOLE_DRAWER_HEIGHT_VAR = '--console-drawer-height';
+const DEFAULT_HEIGHT = 320;
+const MIN_HEIGHT = 160;
+// Leave the page's own header in view at full stretch.
+const MAX_HEIGHT_RATIO = 0.8;
+function readState() {
+    try {
+        const raw = window.localStorage.getItem(STORAGE_KEY);
+        if (raw) {
+            const parsed = JSON.parse(raw);
+            return {
+                open: parsed.open === true,
+                height: typeof parsed.height === 'number' ? parsed.height : DEFAULT_HEIGHT,
+            };
+        }
+    }
+    catch (_a) {
+        // Storage blocked or corrupt: start closed at the default height.
+    }
+    return { open: false, height: DEFAULT_HEIGHT };
+}
+function writeState(state) {
+    try {
+        window.localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
+    }
+    catch (_a) {
+        // Not persisting is fine; the drawer still works for this page view.
+    }
+}
+function clampHeight(height) {
+    const max = Math.floor(window.innerHeight * MAX_HEIGHT_RATIO);
+    return Math.min(Math.max(height, MIN_HEIGHT), Math.max(max, MIN_HEIGHT));
+}
+/**
+ * The console as a bottom panel, like VS Code's: a thin bar when closed, a
+ * resizable panel when open, toggled with Ctrl+`. It stays mounted once
+ * opened, so the conversation survives closing it. `className` positions it,
+ * e.g. an offset for the app's sidebar.
+ */
+export function ConsoleDrawer({ config, className = 'left-0 right-0', }) {
+    const [state, setState] = useState({
+        open: false,
+        height: DEFAULT_HEIGHT,
+    });
+    // Mount the console on first open, then keep it.
+    const [hasOpened, setHasOpened] = useState(false);
+    const dragging = useRef(false);
+    // The height to return to when a maximized drawer is restored.
+    const restoreHeight = useRef(DEFAULT_HEIGHT);
+    useEffect(() => {
+        const stored = readState();
+        setState(Object.assign(Object.assign({}, stored), { height: clampHeight(stored.height) }));
+        if (stored.open)
+            setHasOpened(true);
+    }, []);
+    const toggle = useCallback(() => {
+        setState((prev) => {
+            const merged = Object.assign(Object.assign({}, prev), { open: !prev.open });
+            writeState(merged);
+            return merged;
+        });
+        setHasOpened(true);
+    }, []);
+    useEffect(() => {
+        const covered = state.open ? state.height : CONSOLE_DRAWER_BAR_HEIGHT;
+        document.documentElement.style.setProperty(CONSOLE_DRAWER_HEIGHT_VAR, `${covered}px`);
+    }, [state.open, state.height]);
+    useEffect(() => () => {
+        document.documentElement.style.removeProperty(CONSOLE_DRAWER_HEIGHT_VAR);
+    }, []);
+    useEffect(() => {
+        const onKey = (event) => {
+            if (event.ctrlKey && event.key === '`') {
+                event.preventDefault();
+                toggle();
+            }
+        };
+        window.addEventListener('keydown', onKey);
+        return () => window.removeEventListener('keydown', onKey);
+    }, [toggle]);
+    const setHeight = (height) => {
+        setState((prev) => {
+            const merged = Object.assign(Object.assign({}, prev), { height: clampHeight(height) });
+            writeState(merged);
+            return merged;
+        });
+    };
+    const isMaximized = typeof window !== 'undefined' &&
+        state.height >= clampHeight(Number.POSITIVE_INFINITY);
+    const toggleMaximized = () => {
+        if (isMaximized) {
+            setHeight(restoreHeight.current);
+        }
+        else {
+            restoreHeight.current = state.height;
+            setHeight(Number.POSITIVE_INFINITY);
+        }
+    };
+    const onResizeStart = (event) => {
+        event.preventDefault();
+        dragging.current = true;
+        const onMove = (move) => {
+            if (!dragging.current)
+                return;
+            setState((prev) => (Object.assign(Object.assign({}, prev), { height: clampHeight(window.innerHeight - move.clientY) })));
+        };
+        const onUp = () => {
+            dragging.current = false;
+            window.removeEventListener('pointermove', onMove);
+            window.removeEventListener('pointerup', onUp);
+            setState((prev) => {
+                writeState(prev);
+                return prev;
+            });
+        };
+        window.addEventListener('pointermove', onMove);
+        window.addEventListener('pointerup', onUp);
+    };
+    return (_jsxs("div", { className: `fixed bottom-0 z-30 flex flex-col border-t border-gray-800 bg-gray-950 shadow-2xl ${className}`, style: { height: state.open ? state.height : undefined }, "data-testid": "console-drawer", children: [state.open && (_jsx("div", { role: "separator", "aria-orientation": "horizontal", "aria-label": "Resize console", onPointerDown: onResizeStart, onDoubleClick: () => setHeight(DEFAULT_HEIGHT), title: "Drag to resize; double-click to reset", className: "h-1 shrink-0 cursor-row-resize bg-gray-800 hover:bg-cyan-700" })), _jsxs("div", { className: "flex h-8 shrink-0 items-center text-xs text-gray-400", children: [_jsxs("button", { type: "button", onClick: toggle, "aria-expanded": state.open, className: "flex h-full flex-1 items-center gap-2 px-3 hover:text-gray-200", children: [_jsx(HiTerminal, { className: "h-4 w-4" }), _jsx("span", { className: "font-medium tracking-wider uppercase", children: "Console" }), _jsx("span", { className: "text-gray-600", children: "Ctrl+`" }), _jsx("span", { className: "ml-auto", children: state.open ? (_jsx(HiChevronDown, { className: "h-4 w-4" })) : (_jsx(HiChevronUp, { className: "h-4 w-4" })) })] }), state.open && (_jsx("button", { type: "button", onClick: toggleMaximized, "aria-label": isMaximized ? 'Restore console size' : 'Maximize console', title: isMaximized ? 'Restore' : 'Maximize', className: "flex h-full items-center px-3 hover:text-gray-200", children: isMaximized ? (_jsx(HiOutlineMinus, { className: "h-4 w-4" })) : (_jsx(HiOutlineArrowsExpand, { className: "h-4 w-4" })) }))] }), hasOpened && (_jsx("div", { className: `min-h-0 flex-1 ${state.open ? '' : 'hidden'}`, children: _jsx(ConsoleContent, { config: config, variant: "panel" }) }))] }));
+}

package/components/console/graphAwareConfig.js

@@ -404,6 +404,8 @@ export function buildGraphAwareConsoleConfig(graph, branding) {
         noSelectionError: (_c = branding.noSelectionError) !== null && _c !== void 0 ? _c : 'No graph selected. Please select a graph first.',
         // Semantic memory is per-user-graph; shared repositories reject it.
         enableRecall: !isRepository,
+        // Writes need a user graph; the API also checks the write role.
+        enableAuthor: !isRepository,
     };
 }
 /**

package/components/console/index.d.ts

@@ -1,4 +1,5 @@
 export { ConsoleContent } from './ConsoleContent';
+export { CONSOLE_DRAWER_BAR_HEIGHT, CONSOLE_DRAWER_HEIGHT_VAR, ConsoleDrawer, } from './ConsoleDrawer';
 export { ConsoleMarkdown } from './ConsoleMarkdown';
 export { EXAMPLE_SETS, buildGraphAwareConsoleConfig, getGraphExampleKind, useGraphAwareConsoleConfig, } from './graphAwareConfig';
 export type { ConsoleBranding, GraphExampleKind, GraphExampleSet, } from './graphAwareConfig';

package/components/console/index.js

@@ -1,4 +1,5 @@
 export { ConsoleContent } from './ConsoleContent';
+export { CONSOLE_DRAWER_BAR_HEIGHT, CONSOLE_DRAWER_HEIGHT_VAR, ConsoleDrawer, } from './ConsoleDrawer';
 export { ConsoleMarkdown } from './ConsoleMarkdown';
 export { EXAMPLE_SETS, buildGraphAwareConsoleConfig, getGraphExampleKind, useGraphAwareConsoleConfig, } from './graphAwareConfig';
 export { ProgressiveText } from './ProgressiveText';

package/components/console/types.d.ts

@@ -1,3 +1,4 @@
+import type { GraphWrite } from '../../lib/graph-writes';
 export interface SampleQuery {
     name: string;
     query: string;
@@ -65,6 +66,9 @@ export interface ConsoleConfig {
      *  shared repositories don't support memory, so the graph-aware builder
      *  enables it only for user graphs. */
     enableRecall?: boolean;
+    /** Enable `/do`, which runs the write-capable author operator. The API
+     *  gates it on the graph write role; off for shared repositories. */
+    enableAuthor?: boolean;
     /** Extra slash commands beyond the built-in set */
     extraCommands?: ConsoleExtraCommand[];
 }
@@ -90,4 +94,6 @@ export interface TerminalMessage {
      * breaks survive markdown rendering.
      */
     footer?: string;
+    /** Changes the author operator made, shown as a receipt below the answer. */
+    writes?: GraphWrite[];
 }

package/components/index.d.ts

@@ -1,4 +1,4 @@
-export { ConsoleContent } from './console';
+export { CONSOLE_DRAWER_BAR_HEIGHT, CONSOLE_DRAWER_HEIGHT_VAR, ConsoleContent, ConsoleDrawer, } from './console';
 export { EntitySelector, type EntityGroup, type SelectableEntity, } from './EntitySelector';
 export { EntitySelectorCore, type EntityLike, type EntityRecord, type EntitySelectorProps, type GraphWithEntities, } from './EntitySelectorCore';
 export { GraphFilters, byGraphType, composeFilters, excludeRepositories, excludeSubgraphs, hasAllSchemaExtensions, hasAnySchemaExtension, hasSchemaExtension, onlyEntityGraphs, onlyGenericGraphs, onlyRepositories, onlyUserGraphs, } from './graph-filters';

package/components/index.js

@@ -1,4 +1,4 @@
-export { ConsoleContent } from './console';
+export { CONSOLE_DRAWER_BAR_HEIGHT, CONSOLE_DRAWER_HEIGHT_VAR, ConsoleContent, ConsoleDrawer, } from './console';
 export { EntitySelector, } from './EntitySelector';
 export { EntitySelectorCore, } from './EntitySelectorCore';
 export { GraphFilters, byGraphType, composeFilters, excludeRepositories, excludeSubgraphs, hasAllSchemaExtensions, hasAnySchemaExtension, hasSchemaExtension, onlyEntityGraphs, onlyGenericGraphs, onlyRepositories, onlyUserGraphs, } from './graph-filters';

package/hooks/index.d.ts

@@ -1,5 +1,6 @@
 export { useApiError } from './use-api-error';
 export { useCrossAppLink, type CrossAppTarget, type OpenCrossAppOptions, type UseCrossAppLinkResult, } from './use-cross-app-link';
+export { useGraphWrites } from './use-graph-writes';
 export { useMediaQuery } from './use-media-query';
 export { useStreamingQuery } from './use-streaming-query';
 export { useToast, type ToastMessage } from './use-toast';

package/hooks/index.js

@@ -1,5 +1,6 @@
 export { useApiError } from './use-api-error';
 export { useCrossAppLink, } from './use-cross-app-link';
+export { useGraphWrites } from './use-graph-writes';
 export { useMediaQuery } from './use-media-query';
 export { useStreamingQuery } from './use-streaming-query';
 export { useToast } from './use-toast';

package/hooks/use-graph-writes.d.ts

@@ -0,0 +1,6 @@
+import { type GraphWrite } from '../lib/graph-writes';
+/**
+ * Calls `onWrites` when the console changes the graph a page is showing, so
+ * the page can reload what it displays. Writes to other graphs are ignored.
+ */
+export declare function useGraphWrites(graphId: string | null | undefined, onWrites: (writes: GraphWrite[]) => void): void;

package/hooks/use-graph-writes.js

@@ -0,0 +1,22 @@
+'use client';
+import { useEffect, useRef } from 'react';
+import { GRAPH_WRITES_EVENT, } from '../lib/graph-writes';
+/**
+ * Calls `onWrites` when the console changes the graph a page is showing, so
+ * the page can reload what it displays. Writes to other graphs are ignored.
+ */
+export function useGraphWrites(graphId, onWrites) {
+    const onWritesRef = useRef(onWrites);
+    onWritesRef.current = onWrites;
+    useEffect(() => {
+        if (!graphId)
+            return;
+        const handler = (event) => {
+            const detail = event.detail;
+            if ((detail === null || detail === void 0 ? void 0 : detail.graphId) === graphId)
+                onWritesRef.current(detail.writes);
+        };
+        window.addEventListener(GRAPH_WRITES_EVENT, handler);
+        return () => window.removeEventListener(GRAPH_WRITES_EVENT, handler);
+    }, [graphId]);
+}

package/index.d.ts

@@ -2,16 +2,16 @@ export * as AuthCore from './auth-core';
 export { clearToken, getAuthHeader, getRefreshToken, getToken, getValidToken, handleAuthResponse, hasValidToken, storeToken, } from './auth-core/token-storage';
 export { clearUserCookies, clearUserLocalStorage, clearUserSessionStorage, listUserData, performLogoutCleanup, resetUIState, } from './auth-core/cleanup';
 export { AppSwitcher, AuthGuard, AuthProvider, LoginRedirector, SignInForm, SignUpForm, useAuth, } from './auth-components';
-export { useApiError, useMediaQuery, useToast, useUser, useUserLimits, type ToastMessage, } from './hooks';
+export { useApiError, useGraphWrites, useMediaQuery, useToast, useUser, useUserLimits, type ToastMessage, } from './hooks';
 export { createGraphContext, createGraphProvider, createUseGraphContext, EntityProvider, GraphContext, GraphProvider, OrgProvider, ServiceOfferingsProvider, SidebarProvider, useEntity, useGraphContext, useOrg, useServiceOfferings, useSidebarContext, type EntityContextValue, type EntityProviderProps, type GraphContextValue, type GraphProviderProps, type GraphState, type OrgContextState, type OrgContextValue, type OrgProviderProps, type ServiceOfferings, } from './contexts';
-export { clientGraphCookie, clientSidebarCookie, createMcpConnectorUrl, entityCookie, graphCookie, sidebarCookie, type EntityCookie, type GraphCookie, type McpConnectorUrl, type SidebarCookie, } from './lib';
+export { clientGraphCookie, clientSidebarCookie, createMcpConnectorUrl, emitGraphWrites, entityCookie, GRAPH_WRITES_EVENT, graphCookie, readGraphWrites, sidebarCookie, type EntityCookie, type GraphCookie, type GraphWrite, type GraphWritesDetail, type McpConnectorUrl, type SidebarCookie, } from './lib';
 export { ApiError, errorStatus, extractErrorDetail, isApiError, isSessionRejection, isTransientError, toApiError, unwrapSdk, type SdkResult, } from './lib/sdk-errors';
 export { generateEntityUri, isUUID, UUID_REGEX } from './utils';
 export { clearGraphSelection, getGraphSelection, persistGraphSelection, } from './actions/graph-actions';
 export { clearEntitySelection, getEntitySelection, persistEntitySelection, } from './actions/entity-actions';
 export type { Entities, Entity, User } from './types';
 export { customTheme } from './theme';
-export { buildGraphAwareConsoleConfig, ConsoleContent, EXAMPLE_SETS, getGraphExampleKind, useGraphAwareConsoleConfig, } from './components/console';
+export { buildGraphAwareConsoleConfig, CONSOLE_DRAWER_BAR_HEIGHT, CONSOLE_DRAWER_HEIGHT_VAR, ConsoleContent, ConsoleDrawer, 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';

package/index.js

@@ -8,7 +8,7 @@ export { clearUserCookies, clearUserLocalStorage, clearUserSessionStorage, listU
 // Export auth-components
 export { AppSwitcher, AuthGuard, AuthProvider, LoginRedirector, SignInForm, SignUpForm, useAuth, } from './auth-components';
 // Export hooks
-export { useApiError, useMediaQuery, useToast, useUser, useUserLimits, } from './hooks';
+export { useApiError, useGraphWrites, useMediaQuery, useToast, useUser, useUserLimits, } from './hooks';
 // Export contexts
 export { 
 // Graph context exports
@@ -20,7 +20,7 @@ OrgProvider,
 // Service offerings context
 ServiceOfferingsProvider, SidebarProvider, useEntity, useGraphContext, useOrg, useServiceOfferings, useSidebarContext, } from './contexts';
 // Export lib utilities
-export { clientGraphCookie, clientSidebarCookie, createMcpConnectorUrl, entityCookie, graphCookie, sidebarCookie, } from './lib';
+export { clientGraphCookie, clientSidebarCookie, createMcpConnectorUrl, emitGraphWrites, entityCookie, GRAPH_WRITES_EVENT, graphCookie, readGraphWrites, sidebarCookie, } from './lib';
 // Export the SDK error seam (unwrap an SDK result or throw ApiError)
 export { ApiError, errorStatus, extractErrorDetail, isApiError, isSessionRejection, isTransientError, toApiError, unwrapSdk, } from './lib/sdk-errors';
 // Export utils
@@ -32,7 +32,7 @@ export { clearEntitySelection, getEntitySelection, persistEntitySelection, } fro
 export { customTheme } from './theme';
 // Export components
 // Export console components
-export { buildGraphAwareConsoleConfig, ConsoleContent, EXAMPLE_SETS, getGraphExampleKind, useGraphAwareConsoleConfig, } from './components/console';
+export { buildGraphAwareConsoleConfig, CONSOLE_DRAWER_BAR_HEIGHT, CONSOLE_DRAWER_HEIGHT_VAR, ConsoleContent, ConsoleDrawer, 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

package/lib/graph-writes.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A write an operator made, as the API reports it in `metadata.writes`.
+ * `id` is null when the tool returned no object id (for example a memory).
+ */
+export interface GraphWrite {
+    operation: string;
+    id: string | null;
+    name: string | null;
+    block_type?: string;
+}
+export interface GraphWritesDetail {
+    graphId: string;
+    writes: GraphWrite[];
+}
+/** Window event fired after the console changes a graph. */
+export declare const GRAPH_WRITES_EVENT = "robosystems:graph-writes";
+/** Tell any page showing `graphId` that it changed. No-op when nothing was written. */
+export declare function emitGraphWrites(graphId: string, writes: GraphWrite[]): void;
+/** Read `metadata.writes` defensively: anything malformed yields no writes. */
+export declare function readGraphWrites(metadata: unknown): GraphWrite[];

package/lib/graph-writes.js

@@ -0,0 +1,19 @@
+/** Window event fired after the console changes a graph. */
+export const GRAPH_WRITES_EVENT = 'robosystems:graph-writes';
+/** Tell any page showing `graphId` that it changed. No-op when nothing was written. */
+export function emitGraphWrites(graphId, writes) {
+    if (typeof window === 'undefined' || writes.length === 0)
+        return;
+    window.dispatchEvent(new CustomEvent(GRAPH_WRITES_EVENT, {
+        detail: { graphId, writes },
+    }));
+}
+/** Read `metadata.writes` defensively: anything malformed yields no writes. */
+export function readGraphWrites(metadata) {
+    const writes = metadata === null || metadata === void 0 ? void 0 : metadata.writes;
+    if (!Array.isArray(writes))
+        return [];
+    return writes.filter((w) => typeof w === 'object' &&
+        w !== null &&
+        typeof w.operation === 'string');
+}

package/lib/index.d.ts

@@ -1,5 +1,6 @@
 export { clientSidebarCookie, sidebarCookie, type SidebarCookie, } from './sidebar-cookie';
 export { clientGraphCookie, graphCookie, type GraphCookie, } from './graph-cookie';
 export { entityCookie, type EntityCookie } from './entity-cookie';
+export { GRAPH_WRITES_EVENT, emitGraphWrites, readGraphWrites, type GraphWrite, type GraphWritesDetail, } from './graph-writes';
 export { createMcpConnectorUrl, type McpConnectorUrl } from './mcp-connector';
 export { ApiError, errorStatus, extractErrorDetail, isApiError, isSessionRejection, isTransientError, toApiError, unwrapSdk, type SdkResult, } from './sdk-errors';

package/lib/index.js

@@ -1,5 +1,6 @@
 export { clientSidebarCookie, sidebarCookie, } from './sidebar-cookie';
 export { clientGraphCookie, graphCookie, } from './graph-cookie';
 export { entityCookie } from './entity-cookie';
+export { GRAPH_WRITES_EVENT, emitGraphWrites, readGraphWrites, } from './graph-writes';
 export { createMcpConnectorUrl } from './mcp-connector';
 export { ApiError, errorStatus, extractErrorDetail, isApiError, isSessionRejection, isTransientError, toApiError, unwrapSdk, } from './sdk-errors';

package/package.json

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