bruce-models 7.1.126 → 7.1.127

package/dist/bruce-models.umd.js

@@ -13909,7 +13909,7 @@
         DataLab.Get = Get;
         /**
          * Suggests a DataLab query from natural language prompt.
-         * This calls: POST entities/datalab/suggestDataLabQueryByPrompt
+         * This calls: POST entities/datalab/suggestQuery
          */
         function SuggestDataLabQueryByPrompt(params) {
             var _a, _b, _c;
@@ -13921,7 +13921,7 @@
                 if (!api) {
                     api = exports.ENVIRONMENT.Api().GetBruceApi();
                 }
-                const res = yield api.POST("entities/datalab/suggestDataLabQueryByPrompt", body, req ? exports.Api.PrepReqParams(req) : undefined);
+                const res = yield api.POST("entities/datalab/suggestQuery", body, req ? exports.Api.PrepReqParams(req) : undefined);
                 const raw = res;
                 return {
                     query: (_c = (_b = (_a = raw === null || raw === void 0 ? void 0 : raw.Query) !== null && _a !== void 0 ? _a : raw === null || raw === void 0 ? void 0 : raw.SuggestedQuery) !== null && _b !== void 0 ? _b : raw === null || raw === void 0 ? void 0 : raw.DataLabQuery) !== null && _c !== void 0 ? _c : raw,
@@ -14613,6 +14613,16 @@
             EEffectType["None"] = "NONE";
             EEffectType["Water"] = "WATER";
         })(EEffectType = Style.EEffectType || (Style.EEffectType = {}));
+        /**
+         * A look a renderer may put over a point, on top of the point or icon itself.
+         * Default is "NONE".
+         */
+        let EPointEffectType;
+        (function (EPointEffectType) {
+            EPointEffectType["None"] = "NONE";
+            // Marks which way the Entity faces, read from its Bruce.Transform.
+            EPointEffectType["Orientation"] = "ORIENTATION";
+        })(EPointEffectType = Style.EPointEffectType || (Style.EPointEffectType = {}));
         /**
          * Returns a list of styles.
          * @param params
@@ -19208,10 +19218,91 @@
         UIMarkup.GetListCacheKey = GetListCacheKey;
     })(exports.UIMarkup || (exports.UIMarkup = {}));
 
-    const DEFAULT_JOB_POLL_INTERVAL_MS = 1000;
-    const DEFAULT_JOB_POLL_TIMEOUT_MS = 10 * 60 * 1000; // match server timeout (10 minutes)
+    /**
+     * Wire contract of the Navigator chat-event protocol: the JSON-RPC methods, the `eventType` values the
+     * frontend sends, the step types and tracking kinds the backend broadcasts, and the parser for what the
+     * backend sends back. Values are fixed by deployed servers and frontends; the shared fixtures in the
+     * bruce-chat repository (ops/chat-contract-fixtures) pin them for every repository. This module has no
+     * runtime imports so any chat module can depend on it. Exported to consumers through ./navigator-chat.
+     */
+    const NAVIGATOR_CHAT_RPC_METHOD_CHAT_EVENT = "chat/event";
+    const NAVIGATOR_CHAT_RPC_METHOD_SERVER_READY = "server_ready";
+    const NAVIGATOR_CHAT_RPC_METHOD_SERVER_READY_ACK = "server_ready_ack";
+    const NAVIGATOR_CHAT_RPC_METHOD_TOOLS_CALL = "tools/call";
+    const NAVIGATOR_CHAT_RPC_METHOD_TOOL_RESPONSE = "tool_response";
+    /** `eventType` values the frontend sends to the backend inside `chat/event`. */
     const NAVIGATOR_CHAT_EVENT_ENTITY_HIGHLIGHT_APPLIED = "entity_highlight_applied";
     const NAVIGATOR_CHAT_EVENT_SCENE_CONTEXT_PREFETCHED = "scene_context_prefetched";
+    const NAVIGATOR_CHAT_EVENT_PRESENTATION_PLAN_APPLIED = "presentation_plan_applied";
+    /** Legacy bare event (field `event`, no step `type`) the backend broadcasts when a session is cleared. */
+    const NAVIGATOR_CHAT_LEGACY_EVENT_SESSION_CLEARED = "SESSION_CLEARED";
+    /** Step `type` values the backend broadcasts that the frontend routes specially. */
+    const NAVIGATOR_CHAT_STEP_TRACKING_UPDATE = "TRACKING_UPDATE";
+    const NAVIGATOR_CHAT_STEP_JOB_COMPLETE = "JOB_COMPLETE";
+    const NAVIGATOR_CHAT_STEP_QUEUED_INPUT = "QUEUED_INPUT";
+    const NAVIGATOR_CHAT_STEP_LLM_CONTEXT = "LLM_CONTEXT";
+    /** `trackingKind` of the plan step the backend emits; the receipts reuse the event names above. */
+    const NAVIGATOR_CHAT_TRACKING_KIND_PRESENTATION_PLAN = "presentation_plan";
+    /**
+     * Job statuses that mean the job did not run to its end. The WebSocket step path and the streaming
+     * (SSE) path have always recognised slightly different sets - the stream path never treated
+     * INTERRUPTED as cancellation - so each keeps its own list.
+     */
+    const NAVIGATOR_CHAT_CANCELLED_JOB_STATUSES = {
+        chatEvent: ["CANCELLED", "CANCELED", "INTERRUPTED", "PAUSED"],
+        chatStream: ["CANCELLED", "CANCELED", "PAUSED"]
+    };
+    const CLIENT_EVENT_TYPES = [
+        NAVIGATOR_CHAT_EVENT_ENTITY_HIGHLIGHT_APPLIED,
+        NAVIGATOR_CHAT_EVENT_SCENE_CONTEXT_PREFETCHED,
+        NAVIGATOR_CHAT_EVENT_PRESENTATION_PLAN_APPLIED
+    ];
+    /** True for an `eventType` the backend acts on. Matching is exact and case-sensitive. */
+    function isNavigatorChatClientEventType(value) {
+        return typeof value === "string" && CLIENT_EVENT_TYPES.indexOf(value) !== -1;
+    }
+    /** True when a job status means the job was cancelled, interrupted or paused on that path. */
+    function isNavigatorChatCancelledJobStatus(status, path = "chatEvent") {
+        return typeof status === "string"
+            && NAVIGATOR_CHAT_CANCELLED_JOB_STATUSES[path].indexOf(status) !== -1;
+    }
+    /** The JSON-RPC message that carries a frontend chat event to the backend. */
+    function buildNavigatorChatEventMessage(event) {
+        return {
+            jsonrpc: "2.0",
+            method: NAVIGATOR_CHAT_RPC_METHOD_CHAT_EVENT,
+            params: event
+        };
+    }
+    /**
+     * Classifies a raw WebSocket message from the backend. A string is parsed as JSON and a parse failure
+     * throws, so the caller keeps deciding how to report an invalid message. A `chat/event` without params
+     * is delivered as an empty event rather than dropped, as older servers relied on.
+     */
+    function parseNavigatorChatServerMessage(raw) {
+        var _a, _b, _c;
+        const message = typeof raw === "string" ? JSON.parse(raw) : raw;
+        const method = message === null || message === void 0 ? void 0 : message.method;
+        if (method === NAVIGATOR_CHAT_RPC_METHOD_CHAT_EVENT) {
+            return { kind: "chat_event", event: ((_a = message === null || message === void 0 ? void 0 : message.params) !== null && _a !== void 0 ? _a : {}) };
+        }
+        if (method !== NAVIGATOR_CHAT_RPC_METHOD_TOOLS_CALL) {
+            return { kind: "ignored", method, message };
+        }
+        const name = (_b = message === null || message === void 0 ? void 0 : message.params) === null || _b === void 0 ? void 0 : _b.name;
+        if (!name) {
+            return { kind: "invalid_tool_call", message };
+        }
+        return {
+            kind: "tool_call",
+            name,
+            args: (_c = message === null || message === void 0 ? void 0 : message.params) === null || _c === void 0 ? void 0 : _c.arguments,
+            messageId: message === null || message === void 0 ? void 0 : message.id
+        };
+    }
+
+    const DEFAULT_JOB_POLL_INTERVAL_MS = 1000;
+    const DEFAULT_JOB_POLL_TIMEOUT_MS = 10 * 60 * 1000; // match server timeout (10 minutes)
     const DEFAULT_BASE_URL = "http://localhost:8888";
     /**
      * Lightweight client for the Navigator MCP chat HTTP endpoints.
@@ -19468,7 +19559,7 @@
                         return;
                     (_b = (_a = this.logger()).log) === null || _b === void 0 ? void 0 : _b.call(_a, "[NavigatorMcpWS] Connected");
                     this.isConnecting = false;
-                    this.send({ method: "server_ready" });
+                    this.send({ method: NAVIGATOR_CHAT_RPC_METHOD_SERVER_READY });
                     this.flushResponses();
                     (_d = (_c = this.options).onOpen) === null || _d === void 0 ? void 0 : _d.call(_c, event);
                 };
@@ -19534,11 +19625,7 @@
             this.currentAuth = auth;
         }
         sendChatEvent(event) {
-            this.send({
-                jsonrpc: "2.0",
-                method: "chat/event",
-                params: event
-            });
+            this.send(buildNavigatorChatEventMessage(event));
         }
         logger() {
             var _a;
@@ -19575,27 +19662,25 @@
             return urlInstance.toString();
         }
         handleMessage(raw) {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
             return __awaiter(this, void 0, void 0, function* () {
                 try {
-                    const message = typeof raw === "string" ? JSON.parse(raw) : raw;
-                    const method = message === null || message === void 0 ? void 0 : message.method;
-                    if (method === "chat/event") {
-                        const payload = ((_a = message === null || message === void 0 ? void 0 : message.params) !== null && _a !== void 0 ? _a : {});
-                        (_c = (_b = this.options).onChatEvent) === null || _c === void 0 ? void 0 : _c.call(_b, payload);
+                    const parsed = parseNavigatorChatServerMessage(raw);
+                    if (parsed.kind === "chat_event") {
+                        (_b = (_a = this.options).onChatEvent) === null || _b === void 0 ? void 0 : _b.call(_a, parsed.event);
                         return;
                     }
-                    if (method !== "tools/call") {
-                        (_e = (_d = this.logger()).debug) === null || _e === void 0 ? void 0 : _e.call(_d, "[NavigatorMcpWS] Ignoring unsupported message", message);
+                    if (parsed.kind === "ignored") {
+                        (_d = (_c = this.logger()).debug) === null || _d === void 0 ? void 0 : _d.call(_c, "[NavigatorMcpWS] Ignoring unsupported message", parsed.message);
                         return;
                     }
-                    const toolName = (_f = message === null || message === void 0 ? void 0 : message.params) === null || _f === void 0 ? void 0 : _f.name;
-                    const toolArgs = (_g = message === null || message === void 0 ? void 0 : message.params) === null || _g === void 0 ? void 0 : _g.arguments;
-                    const messageId = message === null || message === void 0 ? void 0 : message.id;
-                    if (!toolName) {
-                        (_j = (_h = this.logger()).warn) === null || _j === void 0 ? void 0 : _j.call(_h, "[NavigatorMcpWS] Received tool call without name", message);
+                    if (parsed.kind === "invalid_tool_call") {
+                        (_f = (_e = this.logger()).warn) === null || _f === void 0 ? void 0 : _f.call(_e, "[NavigatorMcpWS] Received tool call without name", parsed.message);
                         return;
                     }
+                    const toolName = parsed.name;
+                    const toolArgs = parsed.args;
+                    const messageId = parsed.messageId;
                     let result;
                     const generation = this.responseGeneration;
                     try {
@@ -19606,21 +19691,21 @@
                         });
                     }
                     catch (error) {
-                        (_l = (_k = this.logger()).error) === null || _l === void 0 ? void 0 : _l.call(_k, "[NavigatorMcpWS] Tool handler threw", error);
+                        (_h = (_g = this.logger()).error) === null || _h === void 0 ? void 0 : _h.call(_g, "[NavigatorMcpWS] Tool handler threw", error);
                         result = `Error: ${error instanceof Error ? error.message : String(error)}`;
                     }
                     if (generation !== this.responseGeneration) {
-                        (_o = (_m = this.logger()).warn) === null || _o === void 0 ? void 0 : _o.call(_m, "[NavigatorMcpWS] Discarding result from a previous session", messageId);
+                        (_k = (_j = this.logger()).warn) === null || _k === void 0 ? void 0 : _k.call(_j, "[NavigatorMcpWS] Discarding result from a previous session", messageId);
                         return;
                     }
                     this.sendResponse({
-                        method: "tool_response",
+                        method: NAVIGATOR_CHAT_RPC_METHOD_TOOL_RESPONSE,
                         id: messageId,
                         result
                     });
                 }
                 catch (error) {
-                    (_q = (_p = this.logger()).error) === null || _q === void 0 ? void 0 : _q.call(_p, "[NavigatorMcpWS] Invalid message", error);
+                    (_m = (_l = this.logger()).error) === null || _m === void 0 ? void 0 : _m.call(_l, "[NavigatorMcpWS] Invalid message", error);
                 }
             });
         }
@@ -21807,6 +21892,10 @@
             EContentType["WEB_3D_MODEL_SPACE"] = "WEB_3D_MODEL_SPACE";
             EContentType["WEB_3D_SPLIT_PLUGIN"] = "WEB_3D_SPLIT_PLUGIN";
             EContentType["IFRAME"] = "IFRAME";
+            // Renders a dashboard in place of the scene.
+            EContentType["DASHBOARD"] = "DASHBOARD";
+            // Renders a diagram (2D graph view) in place of the scene.
+            EContentType["DIAGRAM"] = "DIAGRAM";
         })(EContentType = ProjectViewBookmark.EContentType || (ProjectViewBookmark.EContentType = {}));
         /**
          * Gets a bookmark record.
@@ -24481,6 +24570,73 @@
             EOrderBy["THUMBNAIL_CLIENT_FILE_ID"] = "ThumbnailClientFileID";
             EOrderBy["RANDOM"] = "RANDOM";
         })(EOrderBy = WorkflowItem.EOrderBy || (WorkflowItem.EOrderBy = {}));
+        /**
+         * Gets the history timeline of a Workflow Item, newest first.
+         * Route: GET workflow/item/{workflow_item_id}/history
+         */
+        function GetHistoryList(params) {
+            return __awaiter(this, void 0, void 0, function* () {
+                let { api, workflowItemId, req } = params;
+                if (isInvalidId(workflowItemId)) {
+                    throw ("Workflow Item ID is required.");
+                }
+                if (!api) {
+                    api = exports.ENVIRONMENT.Api().GetBruceApi();
+                }
+                const key = GetHistoryListCacheKey(workflowItemId);
+                const cache = api.GetCacheItem(key, req);
+                if (cache === null || cache === void 0 ? void 0 : cache.found) {
+                    return cache.data;
+                }
+                const request = new Promise((res, rej) => __awaiter(this, void 0, void 0, function* () {
+                    try {
+                        const data = yield api.GET(`workflow/item/${workflowItemId}/history`, exports.Api.PrepReqParams(req));
+                        res(ParseHistoryListResponse(data));
+                    }
+                    catch (e) {
+                        rej(e);
+                    }
+                }));
+                api.SetCacheItem({ key, value: request, req });
+                return request;
+            });
+        }
+        WorkflowItem.GetHistoryList = GetHistoryList;
+        /**
+         * Gets one history record of a Workflow Item.
+         * Route: GET workflow/item/{workflow_item_id}/history/{workflow_item_history_id}
+         */
+        function GetHistory(params) {
+            return __awaiter(this, void 0, void 0, function* () {
+                let { api, workflowItemId, workflowItemHistoryId, req } = params;
+                if (isInvalidId(workflowItemId)) {
+                    throw ("Workflow Item ID is required.");
+                }
+                if (isInvalidId(workflowItemHistoryId)) {
+                    throw ("Workflow Item History ID is required.");
+                }
+                if (!api) {
+                    api = exports.ENVIRONMENT.Api().GetBruceApi();
+                }
+                const key = GetHistoryCacheKey(workflowItemId, workflowItemHistoryId);
+                const cache = api.GetCacheItem(key, req);
+                if (cache === null || cache === void 0 ? void 0 : cache.found) {
+                    return cache.data;
+                }
+                const request = new Promise((res, rej) => __awaiter(this, void 0, void 0, function* () {
+                    try {
+                        const data = yield api.GET(`workflow/item/${workflowItemId}/history/${workflowItemHistoryId}`, exports.Api.PrepReqParams(req));
+                        res({ history: ParseHistoryResponse(data) });
+                    }
+                    catch (e) {
+                        rej(e);
+                    }
+                }));
+                api.SetCacheItem({ key, value: request, req });
+                return request;
+            });
+        }
+        WorkflowItem.GetHistory = GetHistory;
         function Get(params) {
             return __awaiter(this, void 0, void 0, function* () {
                 let { api, workflowItemId, req } = params;
@@ -24765,10 +24921,41 @@
             return result;
         }
         WorkflowItem.ParseStatisticsResponse = ParseStatisticsResponse;
+        function ParseHistoryResponse(response) {
+            var _a;
+            const parsed = parseObject$5(response);
+            const parsedResult = (_a = parseObject$5(parsed === null || parsed === void 0 ? void 0 : parsed.Result)) !== null && _a !== void 0 ? _a : parsed === null || parsed === void 0 ? void 0 : parsed.Result;
+            return parsedResult !== null && parsedResult !== void 0 ? parsedResult : parsed;
+        }
+        WorkflowItem.ParseHistoryResponse = ParseHistoryResponse;
+        function ParseHistoryListResponse(response) {
+            var _a;
+            const parsed = parseObject$5(response);
+            const parsedResult = (_a = parseObject$5(parsed === null || parsed === void 0 ? void 0 : parsed.Result)) !== null && _a !== void 0 ? _a : parsed === null || parsed === void 0 ? void 0 : parsed.Result;
+            const source = parsedResult !== null && parsedResult !== void 0 ? parsedResult : parsed;
+            const items = Array.isArray(source)
+                ? source
+                : Array.isArray(source === null || source === void 0 ? void 0 : source.Items)
+                    ? source.Items
+                    : [];
+            return {
+                items,
+                totalCount: source === null || source === void 0 ? void 0 : source.TotalCount
+            };
+        }
+        WorkflowItem.ParseHistoryListResponse = ParseHistoryListResponse;
         function GetCacheKey(id) {
             return `${exports.Api.ECacheKey.WorkflowItem}${exports.Api.ECacheKey.Id}${id}`;
         }
         WorkflowItem.GetCacheKey = GetCacheKey;
+        function GetHistoryListCacheKey(workflowItemId) {
+            return `${exports.Api.ECacheKey.WorkflowItem}${exports.Api.ECacheKey.Id}${workflowItemId}${exports.Api.ECacheKey.ListId}history`;
+        }
+        WorkflowItem.GetHistoryListCacheKey = GetHistoryListCacheKey;
+        function GetHistoryCacheKey(workflowItemId, workflowItemHistoryId) {
+            return `${exports.Api.ECacheKey.WorkflowItem}${exports.Api.ECacheKey.Id}${workflowItemId}${exports.Api.ECacheKey.ListId}history${exports.Api.ECacheKey.Id}${workflowItemHistoryId}`;
+        }
+        WorkflowItem.GetHistoryCacheKey = GetHistoryCacheKey;
         function GetListCacheKey(params) {
             return `${exports.Api.ECacheKey.WorkflowItem}${exports.Api.ECacheKey.ListId}${BuildListUrl(params)}`;
         }
@@ -25289,7 +25476,7 @@
     }
 
     // This is updated with the package.json version on build.
-    const VERSION = "7.1.126";
+    const VERSION = "7.1.127";
 
     exports.VERSION = VERSION;
     exports.AbstractApi = AbstractApi;
@@ -25298,9 +25485,26 @@
     exports.CacheControl = CacheControl;
     exports.DelayQueue = DelayQueue;
     exports.LRUCache = LRUCache;
+    exports.NavigatorChatClient = NavigatorChatClient;
+    exports.NAVIGATOR_CHAT_RPC_METHOD_CHAT_EVENT = NAVIGATOR_CHAT_RPC_METHOD_CHAT_EVENT;
+    exports.NAVIGATOR_CHAT_RPC_METHOD_SERVER_READY = NAVIGATOR_CHAT_RPC_METHOD_SERVER_READY;
+    exports.NAVIGATOR_CHAT_RPC_METHOD_SERVER_READY_ACK = NAVIGATOR_CHAT_RPC_METHOD_SERVER_READY_ACK;
+    exports.NAVIGATOR_CHAT_RPC_METHOD_TOOLS_CALL = NAVIGATOR_CHAT_RPC_METHOD_TOOLS_CALL;
+    exports.NAVIGATOR_CHAT_RPC_METHOD_TOOL_RESPONSE = NAVIGATOR_CHAT_RPC_METHOD_TOOL_RESPONSE;
     exports.NAVIGATOR_CHAT_EVENT_ENTITY_HIGHLIGHT_APPLIED = NAVIGATOR_CHAT_EVENT_ENTITY_HIGHLIGHT_APPLIED;
     exports.NAVIGATOR_CHAT_EVENT_SCENE_CONTEXT_PREFETCHED = NAVIGATOR_CHAT_EVENT_SCENE_CONTEXT_PREFETCHED;
-    exports.NavigatorChatClient = NavigatorChatClient;
+    exports.NAVIGATOR_CHAT_EVENT_PRESENTATION_PLAN_APPLIED = NAVIGATOR_CHAT_EVENT_PRESENTATION_PLAN_APPLIED;
+    exports.NAVIGATOR_CHAT_LEGACY_EVENT_SESSION_CLEARED = NAVIGATOR_CHAT_LEGACY_EVENT_SESSION_CLEARED;
+    exports.NAVIGATOR_CHAT_STEP_TRACKING_UPDATE = NAVIGATOR_CHAT_STEP_TRACKING_UPDATE;
+    exports.NAVIGATOR_CHAT_STEP_JOB_COMPLETE = NAVIGATOR_CHAT_STEP_JOB_COMPLETE;
+    exports.NAVIGATOR_CHAT_STEP_QUEUED_INPUT = NAVIGATOR_CHAT_STEP_QUEUED_INPUT;
+    exports.NAVIGATOR_CHAT_STEP_LLM_CONTEXT = NAVIGATOR_CHAT_STEP_LLM_CONTEXT;
+    exports.NAVIGATOR_CHAT_TRACKING_KIND_PRESENTATION_PLAN = NAVIGATOR_CHAT_TRACKING_KIND_PRESENTATION_PLAN;
+    exports.NAVIGATOR_CHAT_CANCELLED_JOB_STATUSES = NAVIGATOR_CHAT_CANCELLED_JOB_STATUSES;
+    exports.isNavigatorChatClientEventType = isNavigatorChatClientEventType;
+    exports.isNavigatorChatCancelledJobStatus = isNavigatorChatCancelledJobStatus;
+    exports.buildNavigatorChatEventMessage = buildNavigatorChatEventMessage;
+    exports.parseNavigatorChatServerMessage = parseNavigatorChatServerMessage;
     exports.NavigatorMcpWebSocketClient = NavigatorMcpWebSocketClient;
     exports.WorkflowItemType = WorkflowItemType;