bruce-models 7.1.126 → 7.1.128

package/README.md

@@ -2,100 +2,5 @@
 
 This is a library which defines data-models for the Nextspace API and provides functions for communicating with the endpoints.
 
-### Workflow Item priority and parent
-
-`WorkflowItem.IItem` and `WorkflowItem.ICreateItem` represent `Priority` as an optional
-`number | null` (signed int32) and `"Parent.Item.ID"` as an optional `number | null`
-(the API's int64 parent reference). Use parent IDs that JavaScript can represent
-as safe integers. Priority accepts zero and negative values; the API defines no
-fixed priority scale.
-
-`Create` and `Update` accept both fields. On update, omit a field to preserve it or
-send `null` to clear it. The API checks that the parent exists and prevents circular
-parent chains. The focused helpers update existing items through
-`POST workflow/item/{id}` and invalidate Workflow Item caches after success.
-
-```ts
-import { WorkflowItem } from "bruce-models";
-
-// Update one attribute while preserving other item fields.
-await WorkflowItem.UpdatePriority({ api, workflowItemId: 9, priority: 3 });
-await WorkflowItem.UpdateParent({ api, workflowItemId: 9, parentItemId: 5 });
-
-// Clear priority or detach from the parent.
-await WorkflowItem.UpdatePriority({ api, workflowItemId: 9, priority: null });
-await WorkflowItem.UpdateParent({ api, workflowItemId: 9, parentItemId: null });
-
-// Change both attributes in one request.
-await WorkflowItem.Update({
-    api,
-    workflowItem: { ID: 9, Priority: 0, "Parent.Item.ID": 5 }
-});
-
-// List direct children, filtered and sorted by priority.
-const { items } = await WorkflowItem.GetList({
-    api,
-    parentItemId: 5,
-    priority: [-2, 0, 3],
-    orderBy: WorkflowItem.EOrderBy.PRIORITY,
-    sortOrder: "DESC"
-});
-```
-
-`GetList` uses `GET workflow/itemsquery` with `Priority` and `ParentItemID` query
-parameters. Both filters accept a single value or an array. Use
-`WorkflowItem.EOrderBy.PARENT_ITEM_ID` to sort by parent instead.
-
-<br>
-
-### Client File folders
-
-`ClientFileFolder` manages virtual folders through `Get`, `GetList`, `Create`, `Update`, and `Delete`.
-Deleting a folder moves its files and immediate subfolders into its parent, or the top level; it preserves file data.
-
-```ts
-const { folder } = await ClientFileFolder.Create({ api, folder: { Name: "Plans" } });
-await ClientFile.Upload({ api, file, folderId: folder.ID, purpose: "Import" });
-await ClientFile.Update({ api, fileId, folderId: folder.ID });
-const { clientFiles } = await ClientFile.GetList({
-    api, filter: { "ClientFileFolder.ID": folder.ID, Purpose: "Import" }
-});
-const { folders } = await ClientFileFolder.GetList({ api, parentFolderId: folder.ID });
-```
-
-Omit the folder filter to include all folders; use `0` (or `null` in JSON filters) for top-level files.
-Folder filters combine with the existing criteria and layer permissions. `ClientFile.GetListByQuery`
-wraps `GET files` and also returns `nextPage` and `nextPageUrl`. Existing `GetList` callers keep using
-`POST files/filtered` without changes.
-
-`ClientFile.Update`, `UpdateList`, `ReplaceContent`, and `Upload` support folder membership. On updates,
-omit the field to preserve it; set `null` or `0` to clear it. Upload metadata is carried on every multipart request.
-All four `GetCounts*` methods accept `folderId`, with separate caches for each folder and the unfiltered result.
-Pass bigint IDs outside JavaScript's safe integer range as decimal strings when supplying IDs to these methods.
-Folder permissions and record-change events use the `clff` concept code.
-
-### Local build
-
-- `npm i`
-
-- `npm run build`
-
-<br>
-
-### Running tests
-
-- `npm i` (ignore if already run)
-
-- `npm run test` (running all tests)
-
-- `npx run jest ./test/unit/util` (example for testing just one test folder)
-
-<br>
-
-### Publishing new versions
-
-- Increase version inside `package.json` and push the change.
-
-- Bitbucket will run a build and test step.
-
-- Manually click `NPM Release` in Bitbucket Pipelines.
+To get started, see [Getting started (with web)](https://docs.nextspace.host/webgettingstarted/) in
+the Nextspace developer docs at [docs.nextspace.host](https://docs.nextspace.host).

package/dist/bruce-models.es5.js

@@ -14052,7 +14052,7 @@ var DataLab;
     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;
@@ -14064,7 +14064,7 @@ var DataLab;
             if (!api) {
                 api = ENVIRONMENT.Api().GetBruceApi();
             }
-            const res = yield api.POST("entities/datalab/suggestDataLabQueryByPrompt", body, req ? Api.PrepReqParams(req) : undefined);
+            const res = yield api.POST("entities/datalab/suggestQuery", body, req ? 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,
@@ -14775,6 +14775,16 @@ var Style;
         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
@@ -19496,10 +19506,91 @@ var UIMarkup;
     UIMarkup.GetListCacheKey = GetListCacheKey;
 })(UIMarkup || (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.
@@ -19756,7 +19847,7 @@ class NavigatorMcpWebSocketClient {
                     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);
             };
@@ -19822,11 +19913,7 @@ class NavigatorMcpWebSocketClient {
         this.currentAuth = auth;
     }
     sendChatEvent(event) {
-        this.send({
-            jsonrpc: "2.0",
-            method: "chat/event",
-            params: event
-        });
+        this.send(buildNavigatorChatEventMessage(event));
     }
     logger() {
         var _a;
@@ -19863,27 +19950,25 @@ class NavigatorMcpWebSocketClient {
         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 {
@@ -19894,21 +19979,21 @@ class NavigatorMcpWebSocketClient {
                     });
                 }
                 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);
             }
         });
     }
@@ -22133,6 +22218,10 @@ var ProjectViewBookmark;
         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.
@@ -23911,9 +24000,10 @@ var User;
          * @param accountId
          * @param exclusive
          * @param search
+         * @param expand
          * @returns
          */
-        function GetListCacheKey(sessionId, accountId, exclusive, search) {
+        function GetListCacheKey(sessionId, accountId, exclusive, search, expand) {
             if (!exclusive) {
                 exclusive = false;
             }
@@ -23926,7 +24016,10 @@ var User;
             if (!accountId) {
                 accountId = "";
             }
-            return Api.ECacheKey.User + Api.ECacheKey.Account + Api.ECacheKey.Id + accountId + Api.ECacheKey.Id + exclusive + Api.ECacheKey.Id + search + Api.ECacheKey.Session + Api.ECacheKey.Id + sessionId;
+            if (!expand) {
+                expand = "";
+            }
+            return Api.ECacheKey.User + Api.ECacheKey.Account + Api.ECacheKey.Id + accountId + Api.ECacheKey.Id + exclusive + Api.ECacheKey.Id + search + Api.ECacheKey.Session + Api.ECacheKey.Id + sessionId + Api.ECacheKey.Id + expand;
         }
         LoginUser.GetListCacheKey = GetListCacheKey;
         /**
@@ -23953,15 +24046,16 @@ var User;
          */
         function GetList(params) {
             return __awaiter(this, void 0, void 0, function* () {
-                let { api, accountId, exclusive, req: reqParams, search } = params;
+                let { api, accountId, exclusive, req: reqParams, search, expandLastAccess } = params;
                 if (!api) {
                     api = ENVIRONMENT.Api().GetGuardianApi();
                 }
                 if (!exclusive) {
                     exclusive = false;
                 }
+                const expand = GetListExpand(expandLastAccess);
                 const sessionId = api.GetSessionId();
-                const cacheKey = GetListCacheKey(sessionId, accountId, exclusive, search);
+                const cacheKey = GetListCacheKey(sessionId, accountId, exclusive, search, expand);
                 const cache = exclusive ? null : api.GetCacheItem(cacheKey, reqParams);
                 if (cache === null || cache === void 0 ? void 0 : cache.found) {
                     return cache.data;
@@ -23978,6 +24072,9 @@ var User;
                         if (exclusive) {
                             urlParams.append("allExcludingClientAccount", "true");
                         }
+                        if (expand) {
+                            urlParams.append("Expand", expand);
+                        }
                         const data = yield api.GET(`v3/users?${urlParams.toString()}`, reqParams);
                         res({
                             users: data.Items
@@ -24153,16 +24250,20 @@ var User;
          * }
          * @param sessionId
          * @param accountId
+         * @param expand
          * @returns
          */
-        function GetListCacheKey(sessionId, accountId) {
+        function GetListCacheKey(sessionId, accountId, expand) {
             if (!sessionId) {
                 sessionId = "anonymous";
             }
             if (!accountId) {
                 accountId = "";
             }
-            return Api.ECacheKey.AccessToken + Api.ECacheKey.Account + Api.ECacheKey.Id + accountId + Api.ECacheKey.Session + Api.ECacheKey.Id + sessionId;
+            if (!expand) {
+                expand = "";
+            }
+            return Api.ECacheKey.AccessToken + Api.ECacheKey.Account + Api.ECacheKey.Id + accountId + Api.ECacheKey.Session + Api.ECacheKey.Id + sessionId + Api.ECacheKey.Id + expand;
         }
         AccessToken.GetListCacheKey = GetListCacheKey;
         /**
@@ -24172,18 +24273,26 @@ var User;
          */
         function GetList(params) {
             return __awaiter(this, void 0, void 0, function* () {
-                let { api, accountId, req: reqParams } = params;
+                let { api, accountId, expandLastAccess, req: reqParams } = params;
+                if (!accountId) {
+                    throw ("Account ID is required.");
+                }
                 if (!api) {
                     api = ENVIRONMENT.Api().GetGuardianApi();
                 }
-                const cacheKey = GetListCacheKey(api.GetSessionId(), accountId);
+                const expand = GetListExpand(expandLastAccess);
+                const cacheKey = GetListCacheKey(api.GetSessionId(), accountId, expand);
                 const cache = api.GetCacheItem(cacheKey, reqParams);
                 if (cache === null || cache === void 0 ? void 0 : cache.found) {
                     return cache.data;
                 }
                 const req = new Promise((res, rej) => __awaiter(this, void 0, void 0, function* () {
                     try {
-                        const data = yield api.GET(`v3/account/${accountId}/accessTokens`, reqParams);
+                        let url = `v3/account/${accountId}/accessTokens`;
+                        if (expand) {
+                            url += "?Expand=" + expand;
+                        }
+                        const data = yield api.GET(url, reqParams);
                         res({
                             users: data.Items
                         });
@@ -24246,6 +24355,16 @@ var User;
         }
         AccessToken.Create = Create;
     })(AccessToken = User$$1.AccessToken || (User$$1.AccessToken = {}));
+    /**
+     * Builds the Expand value for a user list, or undefined to leave Guardian's default.
+     * An explicit Expand replaces the default permission expansion, so it is asked for again.
+     */
+    function GetListExpand(expandLastAccess) {
+        if (!expandLastAccess) {
+            return undefined;
+        }
+        return "permission,lastAccess";
+    }
     /**
      * Updates the password for a user by supplying the existing and new password.
      * @param params
@@ -24868,6 +24987,73 @@ var WorkflowItem;
         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 = 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`, 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 = 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}`, 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;
@@ -25152,10 +25338,41 @@ var WorkflowItem;
         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 `${Api.ECacheKey.WorkflowItem}${Api.ECacheKey.Id}${id}`;
     }
     WorkflowItem.GetCacheKey = GetCacheKey;
+    function GetHistoryListCacheKey(workflowItemId) {
+        return `${Api.ECacheKey.WorkflowItem}${Api.ECacheKey.Id}${workflowItemId}${Api.ECacheKey.ListId}history`;
+    }
+    WorkflowItem.GetHistoryListCacheKey = GetHistoryListCacheKey;
+    function GetHistoryCacheKey(workflowItemId, workflowItemHistoryId) {
+        return `${Api.ECacheKey.WorkflowItem}${Api.ECacheKey.Id}${workflowItemId}${Api.ECacheKey.ListId}history${Api.ECacheKey.Id}${workflowItemHistoryId}`;
+    }
+    WorkflowItem.GetHistoryCacheKey = GetHistoryCacheKey;
     function GetListCacheKey(params) {
         return `${Api.ECacheKey.WorkflowItem}${Api.ECacheKey.ListId}${BuildListUrl(params)}`;
     }
@@ -25682,7 +25899,7 @@ function getFirstWrappedArray(data, wrapperKeys) {
 }
 
 // This is updated with the package.json version on build.
-const VERSION = "7.1.126";
+const VERSION = "7.1.128";
 
-export { VERSION, Account, AccountAudit, AccountConcept, AccountFeatures, AccountInvite, AccountLimits, AccountTemplate, AccountType, AnnDocument, AbstractApi, Api, ApiGetters, BruceApi, GlobalApi, GuardianApi, Assembly, Calculator, ChangeSet, ClientFile, ClientFileFolder, ClientFileValueMap, Bounds, BruceEvent, BruceVariable, CacheControl, Camera, Cartes, Carto, Color, DelayQueue, RequestLane, GeoJson, Geometry, LRUCache, UTC, CustomForm, DashboardView, DataFeed, DataLab, DataLabGroup, DataSource, DataTransform, Comment, Entity, EntityAttachment, EntityAttachmentType, EntityAttribute, EntityComment, EntityCoords, EntityHistoricData, EntityLink, EntityLod, EntityLodCategory, EntityRelation, EntityRelationType, EntitySource, EntityTableView, EntityTag, EntityType, EntityTypeRelation, EntityTypeSource, EntityTypeTrigger, Ontology, OntologyDocument, ENVIRONMENT, ExportBrz, ExportCsv, ExportNsx, ExportUsd, Hexbin, ImportAssembly, ImportCad, ImportCsv, ImportGeoJson, ImportJson, ImportKml, ImportLcc, ImportTif, ImportedFile, Uploader, Markup, UIMarkup, NAVIGATOR_CHAT_EVENT_ENTITY_HIGHLIGHT_APPLIED, NAVIGATOR_CHAT_EVENT_SCENE_CONTEXT_PREFETCHED, NavigatorChatClient, NavigatorMcpWebSocketClient, Plugin, PluginAiTool, ProgramKey, MenuItem, ProjectView, ProjectViewBookmark, ProjectViewBookmarkGroup, ProjectViewLegacy, ProjectViewLegacyBookmark, ProjectViewLegacyTile, ProjectViewTile, ZoomControl, Scenario, HostingLocation, MessageBroker, PendingAction, RecordChangeFeed, Style, Tileset, Tracking, Permission, Session, User, UserGroup, UserMfaMethod, EncryptUtils, MathUtils, ObjectUtils, PathUtils, UrlUtils, WorkflowItem, WorkflowSchedule, WorkflowType, WorkflowItemType };
+export { VERSION, Account, AccountAudit, AccountConcept, AccountFeatures, AccountInvite, AccountLimits, AccountTemplate, AccountType, AnnDocument, AbstractApi, Api, ApiGetters, BruceApi, GlobalApi, GuardianApi, Assembly, Calculator, ChangeSet, ClientFile, ClientFileFolder, ClientFileValueMap, Bounds, BruceEvent, BruceVariable, CacheControl, Camera, Cartes, Carto, Color, DelayQueue, RequestLane, GeoJson, Geometry, LRUCache, UTC, CustomForm, DashboardView, DataFeed, DataLab, DataLabGroup, DataSource, DataTransform, Comment, Entity, EntityAttachment, EntityAttachmentType, EntityAttribute, EntityComment, EntityCoords, EntityHistoricData, EntityLink, EntityLod, EntityLodCategory, EntityRelation, EntityRelationType, EntitySource, EntityTableView, EntityTag, EntityType, EntityTypeRelation, EntityTypeSource, EntityTypeTrigger, Ontology, OntologyDocument, ENVIRONMENT, ExportBrz, ExportCsv, ExportNsx, ExportUsd, Hexbin, ImportAssembly, ImportCad, ImportCsv, ImportGeoJson, ImportJson, ImportKml, ImportLcc, ImportTif, ImportedFile, Uploader, Markup, UIMarkup, NavigatorChatClient, NAVIGATOR_CHAT_RPC_METHOD_CHAT_EVENT, NAVIGATOR_CHAT_RPC_METHOD_SERVER_READY, NAVIGATOR_CHAT_RPC_METHOD_SERVER_READY_ACK, NAVIGATOR_CHAT_RPC_METHOD_TOOLS_CALL, NAVIGATOR_CHAT_RPC_METHOD_TOOL_RESPONSE, NAVIGATOR_CHAT_EVENT_ENTITY_HIGHLIGHT_APPLIED, NAVIGATOR_CHAT_EVENT_SCENE_CONTEXT_PREFETCHED, NAVIGATOR_CHAT_EVENT_PRESENTATION_PLAN_APPLIED, NAVIGATOR_CHAT_LEGACY_EVENT_SESSION_CLEARED, NAVIGATOR_CHAT_STEP_TRACKING_UPDATE, NAVIGATOR_CHAT_STEP_JOB_COMPLETE, NAVIGATOR_CHAT_STEP_QUEUED_INPUT, NAVIGATOR_CHAT_STEP_LLM_CONTEXT, NAVIGATOR_CHAT_TRACKING_KIND_PRESENTATION_PLAN, NAVIGATOR_CHAT_CANCELLED_JOB_STATUSES, isNavigatorChatClientEventType, isNavigatorChatCancelledJobStatus, buildNavigatorChatEventMessage, parseNavigatorChatServerMessage, NavigatorMcpWebSocketClient, Plugin, PluginAiTool, ProgramKey, MenuItem, ProjectView, ProjectViewBookmark, ProjectViewBookmarkGroup, ProjectViewLegacy, ProjectViewLegacyBookmark, ProjectViewLegacyTile, ProjectViewTile, ZoomControl, Scenario, HostingLocation, MessageBroker, PendingAction, RecordChangeFeed, Style, Tileset, Tracking, Permission, Session, User, UserGroup, UserMfaMethod, EncryptUtils, MathUtils, ObjectUtils, PathUtils, UrlUtils, WorkflowItem, WorkflowSchedule, WorkflowType, WorkflowItemType };
 //# sourceMappingURL=bruce-models.es5.js.map