@robosystems/core 0.12.0 → 0.13.0

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,6 +54,23 @@ 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));
@@ -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.
@@ -702,7 +749,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/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/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/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,9 +2,9 @@ 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';

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

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.0",
   "description": "Shared RoboSystems frontend core library (auth, contexts, task monitoring, UI components) for the RoboSystems Next.js apps",
   "license": "MIT",
   "private": false,