@octostar/platform-api 0.5.31 → 0.5.32

package/dist/octostar-platform-api.js

@@ -22471,7 +22471,14 @@ exports.default = _default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.savedSearchApi = exports.remoteAppApi = exports.ontologyApi = exports.getOntologyApi = exports.getDesktopApi = exports.getContextApi = exports.extrasApi = exports.desktopApi = exports.contextApi = void 0;
+exports.getDesktopApi = exports.getContextApi = exports.extrasApi = exports.desktopApi = exports.contextApi = void 0;
+Object.defineProperty(exports, "getOctostarConnectionManager", {
+  enumerable: true,
+  get: function get() {
+    return _factory.getOctostarConnectionManager;
+  }
+});
+exports.savedSearchApi = exports.remoteAppApi = exports.ontologyApi = exports.getOntologyApi = void 0;
 var _AsyncServiceLocator = require("./lib/AsyncServiceLocator");
 var _factory = require("./factory");
 var _constants = require("./constants");
@@ -22593,6 +22600,11 @@ var getContextApi = exports.getContextApi = /*#__PURE__*/function () {
     return _ref3.apply(this, arguments);
   };
 }();
+/**
+ * @beta
+ * Gets the singleton instance of OctostarConnectionManager.
+ * This is the primary way to access connection management functionality.
+ */
 
 },{"./constants":34,"./factory":35,"./lib/AsyncServiceLocator":39}],24:[function(require,module,exports){
 "use strict";
@@ -23722,226 +23734,610 @@ var OCTOSTAR_ENTITIES_MIME_TYPE = exports.OCTOSTAR_ENTITIES_MIME_TYPE = 'applica
 },{}],35:[function(require,module,exports){
 "use strict";
 
-function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.forwardCallsToFutureObject = exports.createRemoteApiHandle = void 0;
+exports.forwardCallsToFutureObject = exports.createRemoteApiHandle = exports.OctostarConnectionManager = void 0;
+exports.getOctostarConnectionManager = getOctostarConnectionManager;
 var postRobot = _interopRequireWildcard(require("post-robot"));
 var _utils = require("./utils");
 var _constants = require("./constants");
-function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t2 in e) "default" !== _t2 && {}.hasOwnProperty.call(e, _t2) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t2)) && (i.get || i.set) ? o(f, _t2, i) : f[_t2] = e[_t2]); return f; })(e, t); }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
 function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
 function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
 function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
-function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
 function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
 function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
 function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
-var hasParent = function hasParent(window) {
-  return window.parent !== window;
-};
-function getOctostarWindow(channelId) {
-  var currentWindow = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : window;
-  var depth = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
-  // Check all iframes in the current window
-  var iframes;
-  try {
-    iframes = currentWindow.document.querySelectorAll('iframe');
-  } catch (e) {
-    // assuming cross-origin iframe
-    return currentWindow;
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * Manages Octostar connection state, including remote dev mode, channel IDs, window references,
+ * and connection lifecycle. This is a singleton class accessed via getOctostarConnectionManager().
+ */
+var OctostarConnectionManager = exports.OctostarConnectionManager = /*#__PURE__*/function () {
+  function OctostarConnectionManager() {
+    _classCallCheck(this, OctostarConnectionManager);
+    this.remoteDevWindow = null;
+    this.channelIdSubscribers = new Set();
   }
-  for (var i = 0; i < iframes.length; i += 1) {
-    var iframe = iframes[i];
-    if (iframe.getAttribute('data-octostar-iframe') === 'true' && iframe.getAttribute('data-octostar-iframe-channel') === channelId) {
-      return currentWindow;
+  /* ------------------------------------------------------------------ */
+  /*  Private Helpers                                                   */
+  /* ------------------------------------------------------------------ */
+  return _createClass(OctostarConnectionManager, [{
+    key: "hasParent",
+    value: function hasParent(window) {
+      return window.parent !== window;
     }
-  }
-  // Check if we've reached the top window
-  if (!hasParent(currentWindow)) {
-    console.error('Top window reached without finding the Octostar window. You are trying to view the app from outside Octostar?');
-    // could be an old version of Octostar?
-    return currentWindow;
-  }
-  // Prevent infinite loops or excessive searching
-  if (depth > 25) {
-    throw new Error('Max depth reached. Octostar window not found.');
-  }
-  // If not found, continue searching in the parent window
-  return getOctostarWindow(channelId, currentWindow.parent, depth + 1);
-}
-var handlePostResponse = function handlePostResponse(response) {
-  if (response.data.error) {
-    throw new Error(response.data.error.message);
-  }
-  return response.data.data;
-};
-var createObjectProxy = function createObjectProxy(value, options) {
-  return new Proxy(value, {
-    get: function get(target, prop) {
-      // This construction does not support nested objects
-      if (typeof target[prop] === 'function') {
-        return new Proxy(target[prop], {
-          apply: function apply(methodTarget, _, args) {
-            var callResult = methodTarget.apply(void 0, _toConsumableArray(args));
-            var isPromise = callResult instanceof Promise;
-            var isPromiseLike = typeof (callResult === null || callResult === void 0 ? void 0 : callResult.then) === 'function' && typeof (callResult === null || callResult === void 0 ? void 0 : callResult["catch"]) === 'function';
-            if (isPromise || isPromiseLike) {
-              return callResult["catch"](function (e) {
-                var methodFullPath = "".concat(options.name, ".").concat(prop, "()");
-                var error = new Error("Error calling ".concat(methodFullPath, ": ").concat(e.message));
-                error.stack = "at ".concat(methodFullPath, ": ").concat(e.stack);
-                error.originalError = e;
-                throw error;
-              });
+  }, {
+    key: "getParentOctostarWindow",
+    value: function getParentOctostarWindow(channelId) {
+      var currentWindow = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : window;
+      var depth = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
+      var iframes;
+      try {
+        iframes = currentWindow.document.querySelectorAll('iframe');
+      } catch (_unused) {
+        return currentWindow;
+      }
+      var _iterator = _createForOfIteratorHelper(iframes),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var iframe = _step.value;
+          if (iframe.getAttribute('data-octostar-iframe') === 'true' && iframe.getAttribute('data-octostar-iframe-channel') === channelId) {
+            return currentWindow;
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      if (!this.hasParent(currentWindow)) {
+        return undefined;
+      }
+      if (depth > 25) {
+        return undefined;
+      }
+      return this.getParentOctostarWindow(channelId, currentWindow.parent, depth + 1);
+    }
+  }, {
+    key: "tryFetchingFromAttributes",
+    value: function tryFetchingFromAttributes(currentWindow) {
+      try {
+        var iframes = currentWindow.parent.document.getElementsByTagName('iframe');
+        var _iterator2 = _createForOfIteratorHelper(iframes),
+          _step2;
+        try {
+          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+            var iframe = _step2.value;
+            if (iframe.contentWindow === currentWindow) {
+              var _iframe$getAttribute;
+              return (_iframe$getAttribute = iframe.getAttribute('data-octostar-iframe-channel')) !== null && _iframe$getAttribute !== void 0 ? _iframe$getAttribute : undefined;
             }
-            return callResult;
           }
-        });
+        } catch (err) {
+          _iterator2.e(err);
+        } finally {
+          _iterator2.f();
+        }
+      } catch (_unused2) {
+        /* ignore */
       }
-      return target[prop];
+      return undefined;
     }
-  });
-};
-function tryFetchingFomAttributes(currentWindow) {
-  try {
-    var iframes = currentWindow.parent.document.getElementsByTagName('iframe');
-    var _iterator = _createForOfIteratorHelper(iframes),
-      _step;
-    try {
-      for (_iterator.s(); !(_step = _iterator.n()).done;) {
-        var iframe = _step.value;
-        if (iframe.contentWindow === currentWindow) {
-          var channelId = iframe.getAttribute('data-octostar-iframe-channel');
-          if (channelId) {
-            console.log("PostRobot: Setting channelId from iframe attribute ".concat(channelId));
-            window.octostarChannelId = channelId;
-            return channelId;
+  }, {
+    key: "traverseForChannelId",
+    value: function traverseForChannelId() {
+      var currentWindow = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : window;
+      var depth = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+      if (depth > 25) return undefined;
+      // Try to read octostarChannelId from window, but handle SecurityError for cross-origin windows
+      try {
+        if (currentWindow.octostarChannelId) {
+          return currentWindow.octostarChannelId;
+        }
+      } catch (_unused3) {
+        // SecurityError on cross-origin windows - continue to fallback mechanisms
+      }
+      // Try to get channelId from URL query params
+      try {
+        if (currentWindow.location.search) {
+          var params = new URLSearchParams(currentWindow.location.search);
+          var fromQuery = params.get('octostarChannelId');
+          if (fromQuery) {
+            window.octostarChannelId = fromQuery;
+            return fromQuery;
           }
         }
+      } catch (_unused4) {
+        // Cross-origin iframe - can't access location
+        // Continue to try other methods
+      }
+      // Try fetching from iframe attributes (only works if we can access parent)
+      try {
+        var fromAttrs = this.tryFetchingFromAttributes(currentWindow);
+        if (fromAttrs) {
+          window.octostarChannelId = fromAttrs;
+          return fromAttrs;
+        }
+      } catch (_unused5) {
+        // Ignore errors
+      }
+      // Try parent window
+      try {
+        return this.traverseForChannelId(currentWindow.parent, depth + 1);
+      } catch (_unused6) {
+        // Cross-origin parent - can't traverse further
+        return undefined;
       }
-    } catch (err) {
-      _iterator.e(err);
-    } finally {
-      _iterator.f();
     }
-    return undefined;
-  } catch (e) {
-    // Ignore errors, maybe cross-origin iframes
-    return undefined;
-  }
-}
-function traverseForChannelId() {
-  var currentWindow = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : window;
-  var depth = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-  // Prevent infinite loops or excessive searching
-  if (depth > 25) {
-    throw new Error('PostRobot: Max depth reached. octostarChannelId not found.');
-  }
-  // Try to access octostarChannelId, but handle cross-origin errors
-  try {
-    if (currentWindow.octostarChannelId) {
-      return currentWindow.octostarChannelId;
+  }, {
+    key: "clearConnectionHistory",
+    value: function clearConnectionHistory() {
+      sessionStorage.removeItem('octostarRemoteDevWasConnected');
+      sessionStorage.removeItem('octostarRemoteDevIntentionallyDisconnected');
     }
-  } catch (e) {
-    // Cross-origin iframe - can't access window properties
-    // Continue to try other methods
-  }
-  try {
-    // Try to get channelId from URL query params
-    if (currentWindow.location.search) {
-      var urlParams = new URLSearchParams(currentWindow.location.search);
-      var channelId = urlParams.get('octostarChannelId');
-      if (channelId) {
-        console.log("PostRobot: Setting channelId from queryParams ".concat(channelId));
-        window.octostarChannelId = channelId;
-        return channelId;
+  }, {
+    key: "notifyChannelIdChanged",
+    value: function notifyChannelIdChanged(channelId) {
+      this.channelIdSubscribers.forEach(function (callback) {
+        callback(channelId);
+      });
+    }
+  }, {
+    key: "handlePostResponse",
+    value: function handlePostResponse(response) {
+      if (response.data.error) {
+        throw new Error(response.data.error.message);
       }
+      return response.data.data;
     }
-  } catch (e) {
-    // Cross-origin iframe - can't access location
-    // Continue to try other methods
-  }
-  // Try fetching from iframe attributes (only works if we can access parent)
-  try {
-    var _channelId = tryFetchingFomAttributes(currentWindow);
-    if (_channelId) {
-      return _channelId;
+  }, {
+    key: "createObjectProxy",
+    value: function createObjectProxy(value, options) {
+      return new Proxy(value, {
+        get: function get(target, prop) {
+          if (typeof target[prop] === 'function') {
+            return new Proxy(target[prop], {
+              apply: function apply(methodTarget, _, args) {
+                var result = methodTarget.apply(void 0, _toConsumableArray(args));
+                if (result !== null && result !== void 0 && result.then) {
+                  return result["catch"](function (e) {
+                    var path = "".concat(options.name, ".").concat(String(prop), "()");
+                    var err = new Error("Error calling ".concat(path, ": ").concat(e.message));
+                    err.originalError = e;
+                    throw err;
+                  });
+                }
+                return result;
+              }
+            });
+          }
+          return target[prop];
+        }
+      });
     }
-  } catch (e) {
-    // Ignore errors
-  }
-  // Try parent window
-  try {
-    return traverseForChannelId(currentWindow.parent, depth + 1);
-  } catch (e) {
-    // Cross-origin parent - can't traverse further
-    console.error('PostRobot: Cannot traverse to parent window (cross-origin)', e);
-    return undefined;
+    /* ------------------------------------------------------------------ */
+    /*  Public API - Window Management                                    */
+    /* ------------------------------------------------------------------ */
+    /**
+     * Sets the remote dev window reference.
+     * This should be called when opening a remote dev window from a React component.
+     */
+  }, {
+    key: "setWindow",
+    value: function setWindow(window) {
+      this.remoteDevWindow = window;
+    }
+    /**
+     * Gets the remote dev window reference.
+     */
+  }, {
+    key: "getWindow",
+    value: function getWindow() {
+      return this.remoteDevWindow;
+    }
+    /* ------------------------------------------------------------------ */
+    /*  Public API - Channel ID Management                                */
+    /* ------------------------------------------------------------------ */
+    /**
+     * Gets or creates a remote dev channel ID.
+     * If a channel ID already exists in sessionStorage, returns it.
+     * Otherwise, generates a new one and stores it.
+     */
+  }, {
+    key: "getOrCreateChannelId",
+    value: function getOrCreateChannelId() {
+      var key = 'octostarRemoteDevChannelId';
+      var existing = sessionStorage.getItem(key);
+      if (existing) return existing;
+      var generated = typeof crypto !== 'undefined' && 'randomUUID' in crypto ? crypto.randomUUID() : "rd-".concat(Date.now(), "-").concat(Math.random().toString(16).slice(2));
+      sessionStorage.setItem(key, generated);
+      return generated;
+    }
+    /**
+     * Checks if a remote dev channel ID exists without creating one.
+     * Used to determine if a connection attempt has been made.
+     */
+  }, {
+    key: "hasChannelId",
+    value: function hasChannelId() {
+      var key = 'octostarRemoteDevChannelId';
+      return sessionStorage.getItem(key) !== null;
+    }
+    /**
+     * Subscribe to remote dev channel ID changes.
+     * Returns an unsubscribe function.
+     */
+  }, {
+    key: "onChannelIdChanged",
+    value: function onChannelIdChanged(callback) {
+      var _this = this;
+      this.channelIdSubscribers.add(callback);
+      return function () {
+        return _this.channelIdSubscribers["delete"](callback);
+      };
+    }
+    /* ------------------------------------------------------------------ */
+    /*  Public API - Connection State                                     */
+    /* ------------------------------------------------------------------ */
+    /**
+     * Marks that a successful remote dev connection was established.
+     * This is called when a connection is successfully made (e.g., ping succeeds).
+     */
+  }, {
+    key: "markConnectionSuccess",
+    value: function markConnectionSuccess() {
+      sessionStorage.setItem('octostarRemoteDevWasConnected', 'true');
+      // Clear intentional disconnect flag since we're now connected
+      sessionStorage.removeItem('octostarRemoteDevIntentionallyDisconnected');
+    }
+    /**
+     * Marks whether the remote dev connection was intentionally disconnected.
+     * @param intentionallyDisconnected - true if user clicked Disconnect/Reset, false if user is trying to connect
+     */
+  }, {
+    key: "markIntentionallyDisconnected",
+    value: function markIntentionallyDisconnected(intentionallyDisconnected) {
+      if (intentionallyDisconnected) {
+        sessionStorage.setItem('octostarRemoteDevIntentionallyDisconnected', 'true');
+      } else {
+        sessionStorage.removeItem('octostarRemoteDevIntentionallyDisconnected');
+      }
+    }
+    /**
+     * Returns whether a successful remote dev connection was ever established in this session.
+     * This persists across component remounts and page refreshes (within the same session).
+     * Only returns true if a channel ID exists (fixes initial load bug).
+     */
+  }, {
+    key: "wasEverConnected",
+    value: function wasEverConnected() {
+      // Only return true if we have evidence of a connection attempt (channel ID exists)
+      // This prevents showing "CONNECTION LOST" on initial load when sessionStorage has stale data
+      return this.hasChannelId() && sessionStorage.getItem('octostarRemoteDevWasConnected') === 'true';
+    }
+    /**
+     * Returns whether the remote dev connection was intentionally disconnected.
+     * This is used to determine whether to show "Connect" vs "Reconnect" button.
+     */
+  }, {
+    key: "wasIntentionallyDisconnected",
+    value: function wasIntentionallyDisconnected() {
+      return sessionStorage.getItem('octostarRemoteDevIntentionallyDisconnected') === 'true';
+    }
+    /* ------------------------------------------------------------------ */
+    /*  Public API - URL Management                                      */
+    /* ------------------------------------------------------------------ */
+    /**
+     * Gets the remote dev URL from sessionStorage.
+     * Returns empty string if not set.
+     */
+  }, {
+    key: "getUrl",
+    value: function getUrl() {
+      return sessionStorage.getItem('octostarRemoteDevUrl') || '';
+    }
+    /**
+     * Sets the remote dev URL in sessionStorage.
+     */
+  }, {
+    key: "setUrl",
+    value: function setUrl(url) {
+      sessionStorage.setItem('octostarRemoteDevUrl', url);
+    }
+    /* ------------------------------------------------------------------ */
+    /*  Public API - Mode Detection                                       */
+    /* ------------------------------------------------------------------ */
+    /**
+     * Returns true when the app is not in connected iframe mode (no octostarChannelId found in URL or
+     * iframe chain), i.e. running in remote dev mode. Returns false when running inside an Octostar
+     * iframe (embedded).
+     */
+  }, {
+    key: "isRemoteDevMode",
+    value: function isRemoteDevMode() {
+      if (this.resolvedMode) {
+        return this.resolvedMode.mode === 'remote';
+      }
+      return this.traverseForChannelId() === undefined;
+    }
+    /* ------------------------------------------------------------------ */
+    /*  Public API - Connection Lifecycle                                */
+    /* ------------------------------------------------------------------ */
+    /**
+     * Clears resolvedMode if the channel ID has changed.
+     * This is called when SET_CHANNEL_ID message is received to ensure
+     * createRemoteApiHandle re-resolves with the new channel ID.
+     * @param newChannelId - The new channel ID that was set
+     */
+  }, {
+    key: "clearResolvedModeIfChannelChanged",
+    value: function clearResolvedModeIfChannelChanged(newChannelId) {
+      if (this.resolvedMode && this.resolvedMode.mode === 'iframe') {
+        if (this.resolvedMode.channelId !== newChannelId) {
+          console.log('PostRobot: channel ID changed, clearing cached resolvedMode', {
+            old: this.resolvedMode.channelId,
+            "new": newChannelId
+          });
+          this.resolvedMode = undefined;
+        }
+      }
+    }
+    /**
+     * Resets the remote dev connection state.
+     * This clears the resolved mode and window reference, allowing the connection to be re-established.
+     * Should be called when connection is lost and user wants to reconnect.
+     */
+  }, {
+    key: "resetConnection",
+    value: function resetConnection() {
+      // Clear resolved mode to force re-resolution on next API call
+      this.resolvedMode = undefined;
+      // Clear remote dev window if it's closed
+      if (this.remoteDevWindow && this.remoteDevWindow.closed) {
+        this.remoteDevWindow = null;
+      }
+    }
+    /**
+     * Resets remote dev mode by closing the window and clearing all connection state.
+     * This puts the app back into a disconnected startup state.
+     * A new channel ID will be generated automatically when the user clicks Connect.
+     */
+  }, {
+    key: "resetMode",
+    value: function resetMode() {
+      // Close the remote dev window if it's open
+      if (this.remoteDevWindow && !this.remoteDevWindow.closed) {
+        this.remoteDevWindow.close();
+      }
+      // Get the old channel ID before clearing it, so we can clear its cached app mapping
+      var oldChannelId = sessionStorage.getItem('octostarRemoteDevChannelId');
+      // Clear the old channel ID from sessionStorage
+      sessionStorage.removeItem('octostarRemoteDevChannelId');
+      // Clear the cached app entity mapping for the old channel ID
+      // Note: mappings are stored in localStorage (not sessionStorage) to persist across tab closes
+      // Only clear the mapping for this specific channel to avoid invalidating other active remote dev sessions
+      if (oldChannelId) {
+        var mappingKey = "octostarRemoteDevMapping-".concat(oldChannelId);
+        localStorage.removeItem(mappingKey);
+      }
+      // Clear resolved mode to force re-resolution on next API call
+      this.resolvedMode = undefined;
+      // Clear remote dev window reference
+      this.remoteDevWindow = null;
+      // Clear connection history
+      this.clearConnectionHistory();
+      // Don't generate a new channel ID or notify subscribers here
+      // A new channel ID will be created when openWindow() is called
+    }
+    /**
+     * Opens a remote dev window with the given URL.
+     * This function:
+     * - Validates the URL
+     * - Saves it to sessionStorage
+     * - Gets or creates a channel ID
+     * - Adds remoteDevChannelId as a URL parameter
+     * - Opens the window and stores the reference
+     * - Returns the window or null if popup was blocked
+     */
+  }, {
+    key: "openWindow",
+    value: function openWindow(url) {
+      if (!url) {
+        return null;
+      }
+      // Save URL to sessionStorage
+      this.setUrl(url);
+      // Mark that user is trying to connect (not intentionally disconnected)
+      this.markIntentionallyDisconnected(false);
+      // Check if channel ID already exists
+      var key = 'octostarRemoteDevChannelId';
+      var existingChannelId = sessionStorage.getItem(key);
+      // Get or create channel ID
+      var channelId = this.getOrCreateChannelId();
+      // Notify subscribers if this is a new channel ID (created after reset)
+      if (!existingChannelId) {
+        this.notifyChannelIdChanged(channelId);
+      }
+      // Add remoteDevChannelId as a URL parameter
+      var urlObj;
+      try {
+        urlObj = new URL(url);
+      } catch (error) {
+        // Invalid URL - return null to indicate failure (consistent with popup blocked behavior)
+        return null;
+      }
+      urlObj.searchParams.set('remoteDevChannelId', channelId);
+      // Open window
+      var win = window.open(urlObj.toString(), channelId);
+      if (!win) {
+        return null;
+      }
+      // Store window reference
+      this.setWindow(win);
+      return win;
+    }
+    /* ------------------------------------------------------------------ */
+    /*  Public API - API Creation                                         */
+    /* ------------------------------------------------------------------ */
+    /**
+     * Creates a remote API handle for communicating with Octostar.
+     * This resolves the connection mode (iframe vs remote dev) and sets up post-robot communication.
+     */
+  }, {
+    key: "createRemoteApiHandle",
+    value: (function () {
+      var _createRemoteApiHandle = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(params) {
+        var _this2 = this;
+        var iframeChannelId, _targetWindow, _targetWindow3, _channelId, _targetWindow2, _this$resolvedMode, channelId, targetWindow, mode, topic, retryOptions, response, api;
+        return _regenerator().w(function (_context) {
+          while (1) switch (_context.n) {
+            case 0:
+              if (this.resolvedMode) {
+                _context.n = 4;
+                break;
+              }
+              iframeChannelId = this.traverseForChannelId();
+              if (!iframeChannelId) {
+                _context.n = 2;
+                break;
+              }
+              _targetWindow = this.getParentOctostarWindow(iframeChannelId);
+              if (_targetWindow) {
+                _context.n = 1;
+                break;
+              }
+              throw new Error('PostRobot: iframe channel found but no Octostar window');
+            case 1:
+              this.resolvedMode = {
+                mode: 'iframe',
+                channelId: iframeChannelId,
+                targetWindow: _targetWindow
+              };
+              _context.n = 4;
+              break;
+            case 2:
+              _channelId = this.getOrCreateChannelId();
+              _targetWindow2 = this.remoteDevWindow; // Check if existing window is closed, and clear it if so
+              if ((_targetWindow3 = _targetWindow2) !== null && _targetWindow3 !== void 0 && _targetWindow3.closed) {
+                this.remoteDevWindow = null;
+                _targetWindow2 = null;
+              }
+              if (_targetWindow2) {
+                _context.n = 3;
+                break;
+              }
+              throw new Error('Remote dev window not open. Please click "Connect" or "Reconnect" to open the Octostar window.');
+            case 3:
+              console.log('PostRobot: No iframe detected → remote dev mode', _channelId);
+              this.resolvedMode = {
+                mode: 'remote',
+                channelId: _channelId,
+                targetWindow: _targetWindow2
+              };
+            case 4:
+              _this$resolvedMode = this.resolvedMode, channelId = _this$resolvedMode.channelId, targetWindow = _this$resolvedMode.targetWindow, mode = _this$resolvedMode.mode;
+              topic = (0, _constants.getPostMessageNames)(channelId).get_api;
+              console.debug('PostRobot: sending get_api', topic, params === null || params === void 0 ? void 0 : params.name);
+              // Use different retry parameters based on connection mode:
+              // - iframe mode: fail fast (3 attempts) since parent window should be immediately available
+              // - remote mode: retry many times (100 attempts) since Octostar window may take a while to open
+              retryOptions = mode === 'iframe' ? {
+                maxAttempts: 3,
+                retryInterval: 1000
+              } : {
+                maxAttempts: 100,
+                retryInterval: 1000
+              };
+              _context.n = 5;
+              return (0, _utils.retry)(function () {
+                var _this2$remoteDevWindo;
+                var actualTargetWindow = (_this2$remoteDevWindo = _this2.remoteDevWindow) !== null && _this2$remoteDevWindo !== void 0 ? _this2$remoteDevWindo : targetWindow;
+                return postRobot.send(actualTargetWindow, topic, params);
+              }, retryOptions);
+            case 5:
+              response = _context.v;
+              api = this.handlePostResponse(response);
+              return _context.a(2, this.createObjectProxy(api, {
+                name: params.name
+              }));
+          }
+        }, _callee, this);
+      }));
+      function createRemoteApiHandle(_x) {
+        return _createRemoteApiHandle.apply(this, arguments);
+      }
+      return createRemoteApiHandle;
+    }())
+  }]);
+}();
+/* ------------------------------------------------------------------ */
+/*  Singleton Pattern                                                 */
+/* ------------------------------------------------------------------ */
+var instance = null;
+/**
+ * Gets the singleton instance of OctostarConnectionManager.
+ * Creates a new instance if one doesn't exist.
+ */
+function getOctostarConnectionManager() {
+  if (!instance) {
+    instance = new OctostarConnectionManager();
   }
+  return instance;
 }
+/* ------------------------------------------------------------------ */
+/*  Standalone Functions (used internally)                            */
+/* ------------------------------------------------------------------ */
+// Listen for SET_CHANNEL_ID messages and update channel ID + clear cached resolvedMode
 window.addEventListener('message', function (event) {
   var _event$data;
-  if (((_event$data = event.data) === null || _event$data === void 0 ? void 0 : _event$data.type) === 'SET_CHANNEL_ID') {
-    window.octostarChannelId = event.data.channelId;
-    console.log('PostRobot: received channelId', event.data.channelId);
+  if (((_event$data = event.data) === null || _event$data === void 0 ? void 0 : _event$data.type) === 'SET_CHANNEL_ID' && typeof event.data.channelId === 'string') {
+    var newChannelId = event.data.channelId;
+    window.octostarChannelId = newChannelId;
+    console.log('PostRobot: received channelId', newChannelId);
+    // Clear cached resolvedMode if channel ID changed and we're in iframe mode
+    // This ensures createRemoteApiHandle re-resolves with the new channel ID
+    var manager = getOctostarConnectionManager();
+    manager.clearResolvedModeIfChannelChanged(newChannelId);
   }
 });
+/**
+ * Creates a remote API handle. This is a convenience function that delegates to the manager.
+ * @deprecated Use getOctostarConnectionManager().createRemoteApiHandle() instead
+ */
 var createRemoteApiHandle = exports.createRemoteApiHandle = /*#__PURE__*/function () {
-  var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(params) {
-    var channelId, octostarWindow, topic, response, api, _t;
-    return _regenerator().w(function (_context) {
-      while (1) switch (_context.p = _context.n) {
+  var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(params) {
+    return _regenerator().w(function (_context2) {
+      while (1) switch (_context2.n) {
         case 0:
-          channelId = traverseForChannelId();
-          if (channelId) {
-            _context.n = 1;
-            break;
-          }
-          throw new Error('PostRobot: No channelId found');
-        case 1:
-          octostarWindow = getOctostarWindow(channelId);
-          console.log("PostRobot: Trying to get handle ".concat(channelId));
-          topic = (0, _constants.getPostMessageNames)(channelId).get_api;
-          _context.p = 2;
-          _context.n = 3;
-          return (0, _utils.retry)(function () {
-            return postRobot.send(octostarWindow, topic, params);
-          }, {
-            maxAttempts: 5,
-            retryInterval: 2000
-          });
-        case 3:
-          response = _context.v;
-          console.log("PostRobot: Got remote api handle for ".concat(params.name, " on ").concat(channelId));
-          api = handlePostResponse(response);
-          return _context.a(2, createObjectProxy(api, {
-            name: params.name
-          }));
-        case 4:
-          _context.p = 4;
-          _t = _context.v;
-          console.log("PostRobot: Error while trying to create remote API handle on ".concat(topic), _t);
-          throw _t;
-        case 5:
-          return _context.a(2);
+          return _context2.a(2, getOctostarConnectionManager().createRemoteApiHandle(params));
       }
-    }, _callee, null, [[2, 4]]);
+    }, _callee2);
   }));
-  return function createRemoteApiHandle(_x) {
+  return function createRemoteApiHandle(_x2) {
     return _ref.apply(this, arguments);
   };
 }();
+/**
+ * Forwards calls to a future object. Used for creating proxies that forward to promises.
+ */
 var forwardCallsToFutureObject = exports.forwardCallsToFutureObject = function forwardCallsToFutureObject(chain) {
   return new Proxy({}, {
-    get: function get(target, prop) {
+    get: function get(_, prop) {
       return new Proxy(function () {}, {
-        apply: function apply(__, _, args) {
+        apply: function apply(_, __, args) {
           return chain.then(function (obj) {
             return obj[prop].apply(obj, _toConsumableArray(args));
           });
@@ -23951,7 +24347,7 @@ var forwardCallsToFutureObject = exports.forwardCallsToFutureObject = function f
   });
 };
 
-},{"./constants":34,"./utils":52,"post-robot":6}],36:[function(require,module,exports){
+},{"./constants":34,"./utils":53,"post-robot":6}],36:[function(require,module,exports){
 "use strict";
 
 Object.defineProperty(exports, "__esModule", {
@@ -24155,8 +24551,19 @@ Object.keys(_ApiConfig).forEach(function (key) {
     }
   });
 });
+var _RemoteDevManager = require("./lib/RemoteDevManager");
+Object.keys(_RemoteDevManager).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _RemoteDevManager[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _RemoteDevManager[key];
+    }
+  });
+});
 
-},{"./apis":23,"./components":33,"./constants":34,"./lib/AIClientImpl":37,"./lib/ApiConfig":38,"./lib/ContextApiRegistry":40,"./lib/FilesAPIImpl":41,"./lib/FusionApi":42,"./lib/JWTProvider":43,"./lib/LiveContextAPI":44,"./lib/Proxy":45,"./lib/SearchQueryBuilder":46,"./lib/browserChannel":47,"./lib/userWorkspace":48,"./permissions":49,"./type/FusionTypes":50,"./types":51,"./utils":52}],37:[function(require,module,exports){
+},{"./apis":23,"./components":33,"./constants":34,"./lib/AIClientImpl":37,"./lib/ApiConfig":38,"./lib/ContextApiRegistry":40,"./lib/FilesAPIImpl":41,"./lib/FusionApi":42,"./lib/JWTProvider":43,"./lib/LiveContextAPI":44,"./lib/Proxy":45,"./lib/RemoteDevManager":46,"./lib/SearchQueryBuilder":47,"./lib/browserChannel":48,"./lib/userWorkspace":49,"./permissions":50,"./type/FusionTypes":51,"./types":52,"./utils":53}],37:[function(require,module,exports){
 "use strict";
 
 Object.defineProperty(exports, "__esModule", {
@@ -24983,7 +25390,7 @@ var FilesAPIImpl = exports.FilesAPIImpl = /*#__PURE__*/function () {
   }]);
 }();
 
-},{"./browserChannel":47}],42:[function(require,module,exports){
+},{"./browserChannel":48}],42:[function(require,module,exports){
 "use strict";
 
 Object.defineProperty(exports, "__esModule", {
@@ -26210,6 +26617,260 @@ var makeProxy = exports.makeProxy = function makeProxy(obj) {
 },{}],46:[function(require,module,exports){
 "use strict";
 
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RemoteDevManager = void 0;
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * Singleton manager for remote dev channel ID and app entity mapping.
+ * Maintains state in memory and persists to localStorage.
+ * Automatically initializes from URL parameter and localStorage on first access.
+ */
+var STORAGE_PREFIX = 'octostarRemoteDevMapping-';
+/**
+ * Singleton manager for remote dev channel ID and app entity mapping.
+ * Only one remote dev app can be active at a time.
+ */
+var RemoteDevManager = exports.RemoteDevManager = /*#__PURE__*/function () {
+  function RemoteDevManager() {
+    _classCallCheck(this, RemoteDevManager);
+    this.remoteDevChannelId = null;
+    this.appEntity = null;
+    this.listeners = new Set();
+    this.initialized = false;
+    // Private constructor for singleton pattern
+  }
+  /**
+   * Get the singleton instance. Automatically initializes on first call.
+   */
+  return _createClass(RemoteDevManager, [{
+    key: "getRemoteDevChannelId",
+    value:
+    /**
+     * Get the current remote dev channel ID.
+     */
+    function getRemoteDevChannelId() {
+      return this.remoteDevChannelId;
+    }
+    /**
+     * Check if the current app is running in remote dev mode.
+     */
+  }, {
+    key: "isRemoteDevMode",
+    value: function isRemoteDevMode() {
+      return this.remoteDevChannelId !== null;
+    }
+    /**
+     * Get the current app entity ID (entity_id from appEntity).
+     */
+  }, {
+    key: "getAppId",
+    value: function getAppId() {
+      var _this$appEntity$entit, _this$appEntity;
+      return (_this$appEntity$entit = (_this$appEntity = this.appEntity) === null || _this$appEntity === void 0 ? void 0 : _this$appEntity.entity_id) !== null && _this$appEntity$entit !== void 0 ? _this$appEntity$entit : null;
+    }
+    /**
+     * Get the current app entity.
+     */
+  }, {
+    key: "getAppEntity",
+    value: function getAppEntity() {
+      return this.appEntity;
+    }
+    /**
+     * Set the mapping between remote dev channel ID and app entity.
+     * Saves to localStorage and notifies all listeners.
+     */
+  }, {
+    key: "setMapping",
+    value: function setMapping(remoteDevChannelId, entity) {
+      if (!remoteDevChannelId || !entity || !entity.entity_id || !entity.entity_type || !entity.entity_label) {
+        return;
+      }
+      // Check localStorage accessibility
+      if (!this.isLocalStorageAvailable()) {
+        return;
+      }
+      var key = "".concat(STORAGE_PREFIX).concat(remoteDevChannelId);
+      // Store the minimal entity object with just the required fields
+      var entityToStore = {
+        entity_type: entity.entity_type,
+        entity_id: entity.entity_id,
+        entity_label: entity.entity_label
+      };
+      var valueToStore = JSON.stringify(entityToStore);
+      try {
+        localStorage.setItem(key, valueToStore);
+        this.remoteDevChannelId = remoteDevChannelId;
+        this.appEntity = entityToStore;
+        this.notifyListeners();
+      } catch (error) {
+        // Silently fail if storage is unavailable
+      }
+    }
+    /**
+     * Clear the current mapping.
+     * Removes from localStorage and notifies all listeners.
+     */
+  }, {
+    key: "clear",
+    value: function clear() {
+      if (this.remoteDevChannelId) {
+        var key = "".concat(STORAGE_PREFIX).concat(this.remoteDevChannelId);
+        try {
+          localStorage.removeItem(key);
+        } catch (error) {
+          // Silently fail if storage is unavailable
+        }
+      }
+      this.remoteDevChannelId = null;
+      this.appEntity = null;
+      this.notifyListeners();
+    }
+    /**
+     * Subscribe to state changes.
+     * Returns an unsubscribe function.
+     */
+  }, {
+    key: "subscribe",
+    value: function subscribe(listener) {
+      var _this = this;
+      this.listeners.add(listener);
+      return function () {
+        _this.listeners["delete"](listener);
+      };
+    }
+    /**
+     * Private: Initialize from URL parameter and localStorage.
+     * Called automatically on first getInstance() call.
+     */
+  }, {
+    key: "initialize",
+    value: function initialize() {
+      if (this.initialized) {
+        return;
+      }
+      this.initialized = true;
+      // Get remoteDevChannelId from URL
+      var urlChannelId = this.getRemoteDevChannelIdFromUrl();
+      if (urlChannelId) {
+        // Clear URL parameter immediately
+        this.removeRemoteDevChannelIdFromUrl();
+        // Always set remoteDevChannelId when present in URL (so modal can show for unrecognised IDs)
+        this.remoteDevChannelId = urlChannelId;
+        // Load entity from localStorage if we have a cached mapping
+        this.appEntity = this.getAppEntityForChannel(urlChannelId);
+      }
+    }
+    /**
+     * Private: Get remote dev channel ID from URL search parameters.
+     */
+  }, {
+    key: "getRemoteDevChannelIdFromUrl",
+    value: function getRemoteDevChannelIdFromUrl() {
+      if (typeof window === 'undefined') return null;
+      try {
+        var params = new URLSearchParams(window.location.search);
+        return params.get('remoteDevChannelId');
+      } catch (_unused) {
+        return null;
+      }
+    }
+    /**
+     * Private: Remove remoteDevChannelId from URL search parameters.
+     */
+  }, {
+    key: "removeRemoteDevChannelIdFromUrl",
+    value: function removeRemoteDevChannelIdFromUrl() {
+      if (typeof window === 'undefined') return;
+      try {
+        var params = new URLSearchParams(window.location.search);
+        params["delete"]('remoteDevChannelId');
+        var newUrl = window.location.pathname + (params.toString() ? "?".concat(params.toString()) : '') + window.location.hash;
+        window.history.replaceState({}, '', newUrl);
+      } catch (_unused2) {
+        // Silently fail if URL manipulation fails
+      }
+    }
+    /**
+     * Private: Get app entity from localStorage for a given channel ID.
+     */
+  }, {
+    key: "getAppEntityForChannel",
+    value: function getAppEntityForChannel(channelId) {
+      if (!channelId) return null;
+      if (!this.isLocalStorageAvailable()) {
+        return null;
+      }
+      var key = "".concat(STORAGE_PREFIX).concat(channelId);
+      var stored = localStorage.getItem(key);
+      if (!stored) {
+        return null;
+      }
+      try {
+        var entity = JSON.parse(stored);
+        // Validate it has the required fields
+        if (entity !== null && entity !== void 0 && entity.entity_type && entity.entity_id && entity.entity_label) {
+          return entity;
+        }
+        console.error('Invalid remote dev mapping:', entity);
+      } catch (error) {
+        console.error('Failed to parse remote dev mapping:', error);
+      }
+      return null;
+    }
+    /**
+     * Private: Check if localStorage is available.
+     */
+  }, {
+    key: "isLocalStorageAvailable",
+    value: function isLocalStorageAvailable() {
+      try {
+        var testKey = '__test_storage_access__';
+        localStorage.setItem(testKey, 'test');
+        localStorage.removeItem(testKey);
+        return true;
+      } catch (_unused3) {
+        return false;
+      }
+    }
+    /**
+     * Private: Notify all listeners of state changes.
+     */
+  }, {
+    key: "notifyListeners",
+    value: function notifyListeners() {
+      this.listeners.forEach(function (listener) {
+        try {
+          listener();
+        } catch (error) {
+          console.error('Error in RemoteDevManager listener:', error);
+        }
+      });
+    }
+  }], [{
+    key: "getInstance",
+    value: function getInstance() {
+      if (!RemoteDevManager.instance) {
+        RemoteDevManager.instance = new RemoteDevManager();
+      }
+      if (!RemoteDevManager.instance.initialized) {
+        RemoteDevManager.instance.initialize();
+      }
+      return RemoteDevManager.instance;
+    }
+  }]);
+}();
+
+},{}],47:[function(require,module,exports){
+"use strict";
+
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 Object.defineProperty(exports, "__esModule", {
   value: true
@@ -26315,7 +26976,7 @@ function buildTextSearchClauses(query, options) {
   return clauses;
 }
 
-},{}],47:[function(require,module,exports){
+},{}],48:[function(require,module,exports){
 "use strict";
 
 Object.defineProperty(exports, "__esModule", {
@@ -26387,7 +27048,7 @@ function readBrowserChannel() {
   return getBrowserChannel();
 }
 
-},{}],48:[function(require,module,exports){
+},{}],49:[function(require,module,exports){
 "use strict";
 
 Object.defineProperty(exports, "__esModule", {
@@ -26466,7 +27127,7 @@ var getOrCreateUsersPrivateWorkspaceRecord = exports.getOrCreateUsersPrivateWork
   };
 }();
 
-},{"uuid":7}],49:[function(require,module,exports){
+},{"uuid":7}],50:[function(require,module,exports){
 "use strict";
 
 Object.defineProperty(exports, "__esModule", {
@@ -26491,21 +27152,21 @@ var ONTOLOGY_PERMISSION_GROUP = exports.ONTOLOGY_PERMISSION_GROUP = 'octostar:on
 var ALL_PERMISSIONS = exports.ALL_PERMISSIONS = 'all';
 var ALL_PERMISSIONS_ARRAY = exports.ALL_PERMISSIONS_ARRAY = [ALL_PERMISSIONS];
 
-},{}],50:[function(require,module,exports){
+},{}],51:[function(require,module,exports){
 "use strict";
 
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 
-},{}],51:[function(require,module,exports){
+},{}],52:[function(require,module,exports){
 "use strict";
 
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 
-},{}],52:[function(require,module,exports){
+},{}],53:[function(require,module,exports){
 "use strict";
 
 Object.defineProperty(exports, "__esModule", {
@@ -26536,7 +27197,7 @@ var retry = exports.retry = /*#__PURE__*/function () {
           retryInterval = (_options$retryInterva = options === null || options === void 0 ? void 0 : options.retryInterval) !== null && _options$retryInterva !== void 0 ? _options$retryInterva : 1000;
         case 1:
           if (!true) {
-            _context.n = 6;
+            _context.n = 7;
             break;
           }
           attempts += 1;
@@ -26548,17 +27209,20 @@ var retry = exports.retry = /*#__PURE__*/function () {
         case 4:
           _context.p = 4;
           _t = _context.v;
-          if (!(attempts < maxAttempts)) {
+          if (!(attempts >= maxAttempts)) {
             _context.n = 5;
             break;
           }
-          _context.n = 5;
+          throw _t;
+        case 5:
+          _context.n = 6;
           return new Promise(function (resolve) {
             return setTimeout(resolve, retryInterval);
           });
-        case 5:
-          throw _t;
         case 6:
+          _context.n = 1;
+          break;
+        case 7:
           return _context.a(2);
       }
     }, _callee, null, [[2, 4]]);