@ateam-ai-mobile/plugin-runtime 0.1.8 → 0.1.9

package/dist/index.js

@@ -75,6 +75,66 @@ var init_voice = __esm({
   }
 });
 
+// src/sdk/device-state.ts
+var device_state_exports = {};
+__export(device_state_exports, {
+  DeviceBridgeError: () => DeviceBridgeError,
+  explainCapability: () => explainCapability,
+  isActionable: () => isActionable,
+  neverObserved: () => neverObserved
+});
+function isActionable(quality, budget) {
+  const { freshness, confidence } = quality;
+  if (freshness.state === "unknown" || freshness.state === "stale") return false;
+  if (freshness.ageMs === null || freshness.ageMs > budget.maxAgeMs) return false;
+  if (budget.minConfidence) {
+    const have = CONFIDENCE_ORDER[confidence?.level ?? "unknown"];
+    if (have < CONFIDENCE_ORDER[budget.minConfidence]) return false;
+  }
+  return true;
+}
+function neverObserved() {
+  return { state: "unknown", observedAt: null, ageMs: null };
+}
+function explainCapability(status) {
+  if (status.support === "unsupported") return "this device does not have it";
+  if (status.permission === "denied") return "permission was denied";
+  if (status.permission === "restricted") return "permission is restricted";
+  if (status.permission === "notDetermined") return "permission has not been asked for yet";
+  if (status.permission === "limited") return "only limited access was granted";
+  if (status.restriction === "policyRestricted") return "this plugin did not declare it";
+  if (status.restriction === "backgroundRestricted") return "the app is in the background";
+  if (status.restriction === "lowPowerRestricted") return "the device is in low-power mode";
+  if (status.availability === "busy") return "it is in use by something else";
+  if (status.availability === "temporarilyUnavailable") return "it is temporarily unavailable";
+  if (status.availability === "unavailable") return "it is unavailable";
+  if (status.support === "unknown" || status.availability === "unknown") {
+    return "its state could not be determined";
+  }
+  return null;
+}
+var DeviceBridgeError, CONFIDENCE_ORDER;
+var init_device_state = __esm({
+  "src/sdk/device-state.ts"() {
+    "use strict";
+    DeviceBridgeError = class extends Error {
+      constructor(code, message, opts) {
+        super(message);
+        this.name = "DeviceBridgeError";
+        this.code = code;
+        this.domain = opts?.domain;
+        this.recoverable = opts?.recoverable;
+      }
+    };
+    CONFIDENCE_ORDER = {
+      unknown: 0,
+      low: 1,
+      medium: 2,
+      high: 3
+    };
+  }
+});
+
 // src/sdk/primitives.ts
 var import_react_native;
 var init_primitives = __esm({
@@ -666,6 +726,8 @@ __export(sdk_exports, {
   TextInput: () => import_react_native.TextInput,
   TouchableOpacity: () => import_react_native.TouchableOpacity,
   View: () => import_react_native.View,
+  explainCapability: () => explainCapability,
+  isActionable: () => isActionable,
   register: () => register,
   registerService: () => registerService,
   registerTools: () => registerTools,
@@ -680,6 +742,7 @@ var init_sdk = __esm({
     init_registration();
     init_registration();
     init_voice();
+    init_device_state();
     init_primitives();
     init_components();
     init_CameraPreview();
@@ -1278,6 +1341,26 @@ var init_registry = __esm({
   }
 });
 
+// src/bundles/bundleUrl.ts
+function pluginBundleUrl(pluginId) {
+  return `/api/ui-plugins/${encodeURIComponent(pluginId)}/bundle.js`;
+}
+function isPluginBundleUrl(url, pluginId) {
+  if (typeof url !== "string") return false;
+  const canonical = pluginBundleUrl(pluginId);
+  if (url === canonical) return true;
+  try {
+    return decodeURIComponent(url) === decodeURIComponent(canonical);
+  } catch {
+    return false;
+  }
+}
+var init_bundleUrl = __esm({
+  "src/bundles/bundleUrl.ts"() {
+    "use strict";
+  }
+});
+
 // src/api/plugins.ts
 function supportsNative(manifest) {
   const mode = manifest.render?.mode;
@@ -1289,12 +1372,9 @@ function getNativeComponentId(manifest) {
   return null;
 }
 function getNativeBundleUrl(manifest) {
-  const direct = manifest.bundleUrl;
-  if (direct) return direct;
   const render = manifest.render;
-  if (render.mode === "react-native") return render.bundleUrl || null;
-  if (render.mode === "adaptive") return render.reactNative?.bundleUrl || null;
-  return null;
+  const declared = manifest.bundleUrl || (render?.mode === "react-native" ? render.bundleUrl : null) || (render?.mode === "adaptive" ? render.reactNative?.bundleUrl : null);
+  return declared && manifest.id ? pluginBundleUrl(manifest.id) : null;
 }
 function getNativeBundleHash(manifest) {
   const direct = manifest.bundleHash;
@@ -1384,6 +1464,7 @@ var init_plugins = __esm({
     "use strict";
     import_core3 = require("@ateam-ai-mobile/core");
     import_core4 = require("@ateam-ai-mobile/core");
+    init_bundleUrl();
   }
 });
 
@@ -2212,6 +2293,20 @@ var init_SurfaceDispatcher = __esm({
   }
 });
 
+// src/bundles/bundleModuleNames.ts
+function sdkModuleRefusal(name) {
+  if (name === PLUGIN_SDK_MODULE) return null;
+  if (!name.startsWith("@ateam-ai-mobile/") && !name.startsWith("@adas/")) return null;
+  return `a plugin bundle required '${name}', which does not exist inside a bundle. Import from '${PLUGIN_SDK_MODULE}' instead \u2014 it is the only SDK module a bundle can require (values and types alike), and the one to keep external when building. '@ateam-ai-mobile/*' are the host app's packages, not the plugin's.`;
+}
+var PLUGIN_SDK_MODULE;
+var init_bundleModuleNames = __esm({
+  "src/bundles/bundleModuleNames.ts"() {
+    "use strict";
+    PLUGIN_SDK_MODULE = "@adas/plugin-sdk";
+  }
+});
+
 // src/utils/sha256.ts
 function sha256Hex(message) {
   const utf8 = unescape(encodeURIComponent(message));
@@ -2378,6 +2473,22 @@ function selectOwnedCacheEntries(entries, tenant) {
   if (!tenant) return [];
   return (entries || []).filter((e) => !!e && e.tenant === tenant);
 }
+async function loadCacheIndex(storage = getBundleStorage()) {
+  const index = await storage.loadIndex() || {};
+  for (const [key, entry] of Object.entries(index)) {
+    const pluginId = entry?.trusted?.pluginId;
+    if (!pluginId) continue;
+    const canonical = pluginBundleUrl(pluginId);
+    if (key === canonical) continue;
+    if (!isPluginBundleUrl(key, pluginId) || !isPluginBundleUrl(entry.bundleUrl, pluginId)) continue;
+    delete index[key];
+    const held = index[canonical];
+    if (!held || (entry.timestamp ?? 0) > (held.timestamp ?? 0)) {
+      index[canonical] = { ...entry, bundleUrl: canonical };
+    }
+  }
+  return index;
+}
 function setBundleStorage(storage) {
   _storage = storage;
 }
@@ -2388,6 +2499,7 @@ var MemoryBundleStorage, _storage;
 var init_storage = __esm({
   "src/bundles/storage.ts"() {
     "use strict";
+    init_bundleUrl();
     MemoryBundleStorage = class {
       constructor() {
         this.index = {};
@@ -2420,6 +2532,9 @@ var init_storage = __esm({
 });
 
 // src/bundles/bundleManager.ts
+function bundleKey(pluginId, bundleUrl) {
+  return isPluginBundleUrl(bundleUrl, pluginId) ? pluginBundleUrl(pluginId) : bundleUrl;
+}
 var import_react9, import_react10, ReactNative, import_core9, ReactShim, PluginSDKShim, requireShim, CACHE_TTL, hasComponent, hasTools, BundleManager, bundleManager;
 var init_bundleManager = __esm({
   "src/bundles/bundleManager.ts"() {
@@ -2435,9 +2550,11 @@ var init_bundleManager = __esm({
     init_store();
     init_SurfaceDispatcher();
     init_host();
+    init_bundleModuleNames();
     init_sha256();
     init_integrity();
     init_storage();
+    init_bundleUrl();
     init_registry();
     ReactShim = {
       __esModule: true,
@@ -2484,7 +2601,9 @@ var init_bundleManager = __esm({
     requireShim = (name) => {
       if (name === "react") return ReactShim;
       if (name === "react-native") return ReactNative;
-      if (name === "@adas/plugin-sdk") return PluginSDKShim;
+      if (name === PLUGIN_SDK_MODULE) return PluginSDKShim;
+      const refusal = sdkModuleRefusal(name);
+      if (refusal) throw new Error(`[BundleManager] ${refusal}`);
       const hostModule = resolveBundleModule(name);
       if (hostModule !== void 0) return hostModule;
       console.warn(`[BundleManager] Unknown module: ${name} \u2014 register it via registerBundleModules()`);
@@ -2612,6 +2731,7 @@ var init_bundleManager = __esm({
        * manifest-driven tool loader already made.
        */
       async load(pluginId, bundleUrl, version, expectedHash, grants) {
+        bundleUrl = bundleKey(pluginId, bundleUrl);
         const tenant = this.requireTenant();
         const epoch = this.epoch;
         const cached = this.getComponentFromMemory(pluginId, bundleUrl);
@@ -2657,6 +2777,7 @@ var init_bundleManager = __esm({
         if (!grants) {
           throw new Error(`[BundleManager] loadTools(${pluginId}) needs the manifest's grants (resolvePluginGrants) \u2014 refusing to register tools on the bundle's own claim`);
         }
+        bundleUrl = bundleKey(pluginId, bundleUrl);
         const tenant = this.requireTenant();
         const epoch = this.epoch;
         let modulePromise = this.inflight.get(bundleUrl);
@@ -2727,11 +2848,12 @@ var init_bundleManager = __esm({
        */
       async clearPlugin(pluginId) {
         const storage = getBundleStorage();
-        const index = await storage.loadIndex();
-        const entry = index[pluginId];
+        const index = await loadCacheIndex(storage);
+        const bundleUrl = pluginBundleUrl(pluginId);
+        const entry = index[bundleUrl];
         if (entry) {
-          this.modules.delete(entry.bundleUrl);
-          delete index[pluginId];
+          this.modules.delete(bundleUrl);
+          delete index[bundleUrl];
           await storage.saveIndex(index);
           try {
             await storage.deleteBundle(entry.localPath);
@@ -2760,7 +2882,7 @@ var init_bundleManager = __esm({
           return;
         }
         const storage = getBundleStorage();
-        const index = await storage.loadIndex();
+        const index = await loadCacheIndex(storage);
         const expectedLc = expectedHash ? expectedHash.toLowerCase() : null;
         let content = null;
         let verifiedHash = null;
@@ -2895,7 +3017,7 @@ var init_bundleManager = __esm({
         if (this.recordedDeclarations.get(bundleUrl) === key) return;
         try {
           const storage = getBundleStorage();
-          const index = await storage.loadIndex();
+          const index = await loadCacheIndex(storage);
           const entry = index[bundleUrl];
           const running = this.provenance.get(bundleUrl)?.hash;
           if (!entry || entry.tenant !== tenant || !running || entry.bundleHash?.toLowerCase() !== running) return;
@@ -3087,7 +3209,7 @@ async function ensureDeviceToolsLoaded({ force = false } = {}) {
 }
 async function loadFromDiskCache() {
   try {
-    const index = await getBundleStorage().loadIndex();
+    const index = await loadCacheIndex(getBundleStorage());
     const entries = Object.values(index || {});
     if (entries.length === 0) return [];
     const tenant = (0, import_core10.getTenant)();
@@ -3205,6 +3327,7 @@ __export(index_exports, {
   listPlugins: () => listPlugins,
   nativePluginRegistry: () => nativePluginRegistry,
   neverObserved: () => neverObserved,
+  pluginBundleUrl: () => pluginBundleUrl,
   register: () => register,
   registerBundleModules: () => registerBundleModules,
   registerDeviceTools: () => registerDeviceTools,
@@ -3239,62 +3362,8 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 init_sdk();
-
-// src/sdk/device-state.ts
-var device_state_exports = {};
-__export(device_state_exports, {
-  DeviceBridgeError: () => DeviceBridgeError,
-  explainCapability: () => explainCapability,
-  isActionable: () => isActionable,
-  neverObserved: () => neverObserved
-});
-var DeviceBridgeError = class extends Error {
-  constructor(code, message, opts) {
-    super(message);
-    this.name = "DeviceBridgeError";
-    this.code = code;
-    this.domain = opts?.domain;
-    this.recoverable = opts?.recoverable;
-  }
-};
-var CONFIDENCE_ORDER = {
-  unknown: 0,
-  low: 1,
-  medium: 2,
-  high: 3
-};
-function isActionable(quality, budget) {
-  const { freshness, confidence } = quality;
-  if (freshness.state === "unknown" || freshness.state === "stale") return false;
-  if (freshness.ageMs === null || freshness.ageMs > budget.maxAgeMs) return false;
-  if (budget.minConfidence) {
-    const have = CONFIDENCE_ORDER[confidence?.level ?? "unknown"];
-    if (have < CONFIDENCE_ORDER[budget.minConfidence]) return false;
-  }
-  return true;
-}
-function neverObserved() {
-  return { state: "unknown", observedAt: null, ageMs: null };
-}
-function explainCapability(status) {
-  if (status.support === "unsupported") return "this device does not have it";
-  if (status.permission === "denied") return "permission was denied";
-  if (status.permission === "restricted") return "permission is restricted";
-  if (status.permission === "notDetermined") return "permission has not been asked for yet";
-  if (status.permission === "limited") return "only limited access was granted";
-  if (status.restriction === "policyRestricted") return "this plugin did not declare it";
-  if (status.restriction === "backgroundRestricted") return "the app is in the background";
-  if (status.restriction === "lowPowerRestricted") return "the device is in low-power mode";
-  if (status.availability === "busy") return "it is in use by something else";
-  if (status.availability === "temporarilyUnavailable") return "it is temporarily unavailable";
-  if (status.availability === "unavailable") return "it is unavailable";
-  if (status.support === "unknown" || status.availability === "unknown") {
-    return "its state could not be determined";
-  }
-  return null;
-}
-
-// src/index.ts
+init_device_state();
+init_device_state();
 init_deviceStateHost();
 init_voiceHost();
 init_host();
@@ -3417,6 +3486,7 @@ var import_react11 = require("react");
 init_bundleManager();
 init_host();
 init_pluginRuntime();
+init_bundleUrl();
 function extractBundleUrl(pluginId, manifest) {
   const render = manifest.render;
   if (!render || typeof render !== "object") return { url: null, source: "none" };
@@ -3424,7 +3494,7 @@ function extractBundleUrl(pluginId, manifest) {
   const hasNativeComponent = !!(render.reactNative?.component || render.component);
   if (hasNativeComponent) {
     return {
-      url: `/api/ui-plugins/${encodeURIComponent(pluginId)}/bundle.js`,
+      url: pluginBundleUrl(pluginId),
       source: injected ? "ignored-explicit" : "derived-default",
       ...injected && { ignored: injected }
     };
@@ -3591,6 +3661,7 @@ function useRemotePlugins(solutionId) {
 
 // src/index.ts
 init_plugins();
+init_bundleUrl();
 init_SurfaceDrawer();
 init_SurfaceCard();
 init_SurfaceFullscreen();
@@ -3664,6 +3735,7 @@ init_SurfaceDispatcher();
   listPlugins,
   nativePluginRegistry,
   neverObserved,
+  pluginBundleUrl,
   register,
   registerBundleModules,
   registerDeviceTools,