@le-space/ui 0.1.62 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@le-space/ui",
-  "version": "0.1.62",
+  "version": "0.2.0",
   "description": "Floating Aleph sponsor relay UI components for Svelte and React.",
   "license": "MIT",
   "type": "module",
@@ -36,8 +36,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@le-space/browser": "0.1.57",
-    "@le-space/core": "0.1.52",
+    "@le-space/browser": "0.2.0",
+    "@le-space/core": "0.2.0",
     "viem": "^2.38.5"
   },
   "peerDependencies": {

package/react/index.d.ts

@@ -190,6 +190,7 @@ type DeploymentProgressListener = (event: DeploymentProgressEvent) => void;
 type SponsorRelayHealthTone = 'ok' | 'caution' | 'error' | 'idle';
 interface SponsorRelayProps {
     libp2p?: unknown;
+    debug?: boolean;
     manifestUrl?: string;
     manifestJson?: string;
     sshPublicKey?: string;
@@ -297,16 +298,23 @@ declare class SponsorRelayController {
     private props;
     private progressEmitter;
     private runtimeCooldownByHash;
+    private runtimeDetailsByHash;
+    private debugEnabled;
+    private lastRuntimeReadyHash;
     constructor(props?: SponsorRelayProps);
     subscribeToDeploymentProgress(listener: DeploymentProgressListener): () => void;
     subscribe(subscriber: SponsorRelaySubscriber): () => void;
     getState(): SponsorRelayState;
+    updateProps(props: Partial<SponsorRelayProps>): void;
     private emit;
+    private trace;
     private patch;
     private emitProgress;
     private syncLatestDeploymentProgress;
     private canSkipRuntimeRefresh;
     private noteRuntimeRefreshResult;
+    private rememberRuntimeDetails;
+    private mergeRememberedRuntimeDetails;
     init(): Promise<void>;
     destroy(): void;
     setOpen(open: boolean): void;

package/react/index.js

@@ -1985,6 +1985,16 @@ function defaultState(props = {}) {
     deploymentProgress: IDLE_DEPLOYMENT_PROGRESS
   };
 }
+function isDebugEnabled(props) {
+  if (props.debug) {
+    return true;
+  }
+  try {
+    return globalThis.localStorage?.getItem("LE_SPACE_UI_DEBUG") === "1";
+  } catch {
+    return false;
+  }
+}
 async function sha256Hex(payload) {
   const digest = await globalThis.crypto.subtle.digest(
     "SHA-256",
@@ -2000,6 +2010,12 @@ function mappedPorts(execution) {
     })
   );
 }
+function runtimeMappedPorts(mappedPortsRecord) {
+  return Object.entries(mappedPortsRecord ?? {}).map(([port, mapping]) => ({
+    label: `${port}/${mapping.udp ? "udp" : "tcp"}`,
+    hostPort: mapping.host ?? null
+  }));
+}
 function rootfsHealth(args) {
   if (!args.manifestState.valid || !args.manifestState.manifest) {
     return {
@@ -2070,8 +2086,18 @@ async function inspectInstanceRuntime(args) {
     execution: null,
     error: null
   };
-  if (details.messageStatus !== "processed") {
-    return details;
+  const lookup = {
+    allocationFound: false,
+    allocationSource: null,
+    crnUrl: null,
+    webUrl: null,
+    executionPayloadFound: false,
+    executionLookupBlocked: false,
+    executionLookupRequestUrl: null,
+    executionLookupVersion: null
+  };
+  if (details.messageStatus === "rejected" || details.messageStatus === "removing") {
+    return { details, lookup };
   }
   try {
     const allocation = await args.client.fetchSchedulerAllocation(args.instance.item_hash) ?? (() => {
@@ -2086,26 +2112,35 @@ async function inspectInstanceRuntime(args) {
         period: null
       } : null;
     })();
+    lookup.allocationFound = Boolean(allocation);
+    lookup.allocationSource = allocation?.source ?? null;
     details.allocationSource = allocation?.source ?? null;
     details.crnUrl = allocation?.crnUrl ?? null;
     details.ipv6 = allocation?.vmIpv6 ?? null;
     details.webUrl = await args.client.fetch2n6WebAccessUrl(
       args.instance.item_hash
     );
+    lookup.crnUrl = details.crnUrl;
+    lookup.webUrl = details.webUrl;
     if (!allocation?.crnUrl) {
-      return details;
+      return { details, lookup };
     }
     const executionLookup = await args.client.fetchCrnExecutionMap(
       allocation.crnUrl
     );
+    lookup.executionLookupBlocked = executionLookup.blocked;
+    lookup.executionLookupRequestUrl = executionLookup.requestUrl ?? null;
+    lookup.executionLookupVersion = executionLookup.version ?? null;
     const executionPayload = executionLookup.payload?.[args.instance.item_hash];
+    lookup.executionPayloadFound = Boolean(executionPayload);
     if (!executionPayload) {
-      return details;
+      return { details, lookup };
     }
     const execution = normalizeExecution(executionPayload, allocation.crnUrl);
     if (!execution.networking.proxy_url && details.webUrl) {
       execution.networking.proxy_url = details.webUrl;
     }
+    details.messageStatus = "processed";
     details.execution = execution;
     details.hostIpv4 = execution.networking.host_ipv4 ?? execution.networking.ipv4 ?? null;
     details.ipv6 = execution.networking.ipv6_ip ?? execution.networking.ipv6 ?? details.ipv6;
@@ -2113,11 +2148,14 @@ async function inspectInstanceRuntime(args) {
     details.webUrl = execution.networking.proxy_url ?? details.webUrl;
     details.mappedPorts = mappedPorts(execution);
     details.sshCommand = buildSshCommand(details.hostIpv4, details.mappedPorts);
-    return details;
+    return { details, lookup };
   } catch (error) {
     return {
-      ...details,
-      error: error instanceof Error ? error.message : String(error)
+      details: {
+        ...details,
+        error: error instanceof Error ? error.message : String(error)
+      },
+      lookup
     };
   }
 }
@@ -2226,9 +2264,13 @@ var SponsorRelayController = class {
   props;
   progressEmitter = createDeploymentProgressEmitter();
   runtimeCooldownByHash = /* @__PURE__ */ new Map();
+  runtimeDetailsByHash = /* @__PURE__ */ new Map();
+  debugEnabled;
+  lastRuntimeReadyHash = null;
   constructor(props = {}) {
     this.props = props;
     this.state = defaultState(props);
+    this.debugEnabled = isDebugEnabled(props);
     this.client = createAlephBrowserClient({
       apiHost: props.apiHost,
       crnListUrl: props.crnListUrl,
@@ -2248,10 +2290,24 @@ var SponsorRelayController = class {
   getState() {
     return this.state;
   }
+  updateProps(props) {
+    this.props = { ...this.props, ...props };
+    this.debugEnabled = isDebugEnabled(this.props);
+  }
   emit() {
     const next = this.state;
     this.subscribers.forEach((subscriber) => subscriber(next));
   }
+  trace(message, data) {
+    if (!this.debugEnabled) {
+      return;
+    }
+    if (data === void 0) {
+      console.debug("[le-space/ui]", message);
+      return;
+    }
+    console.debug("[le-space/ui]", message, data);
+  }
   patch(patch) {
     this.state = {
       ...this.state,
@@ -2268,6 +2324,14 @@ var SponsorRelayController = class {
       ...event,
       timestamp: Date.now()
     };
+    this.trace(`progress:${nextEvent.stage}`, {
+      label: nextEvent.label,
+      progress: nextEvent.progress,
+      status: nextEvent.status,
+      itemHash: nextEvent.itemHash ?? null,
+      detail: nextEvent.detail ?? null,
+      error: nextEvent.error ?? null
+    });
     this.patch({
       deploymentProgress: nextEvent,
       statusText: event.error ?? event.detail ?? event.label,
@@ -2286,6 +2350,9 @@ var SponsorRelayController = class {
     if (!latest) {
       return;
     }
+    const currentProgress = this.state.deploymentProgress;
+    const currentProgressIsForLatestHash = currentProgress.itemHash === itemHash || currentProgress.itemHash == null && currentProgress.stage !== "idle" && currentProgress.stage !== "error";
+    const keepTerminalSuccess = this.lastRuntimeReadyHash === itemHash || currentProgressIsForLatestHash && currentProgress.stage === "completed" && currentProgress.status === "success";
     const status = latest.details.messageStatus;
     if (status === "rejected") {
       this.emitProgress({
@@ -2300,6 +2367,14 @@ var SponsorRelayController = class {
       return;
     }
     if (status !== "processed") {
+      if (keepTerminalSuccess) {
+        this.trace("progress:retain-completed", {
+          reason: "latest refresh still reports non-processed status",
+          itemHash,
+          status
+        });
+        return;
+      }
       const submittedAtMs = instanceTimestampMs(latest.instance);
       const pendingTooLong = submittedAtMs != null && Date.now() - submittedAtMs >= DEPLOYMENT_PENDING_WARNING_MS;
       this.emitProgress({
@@ -2313,6 +2388,13 @@ var SponsorRelayController = class {
       return;
     }
     if (!hasUsableRuntime(latest.details)) {
+      if (keepTerminalSuccess) {
+        this.trace("progress:retain-completed", {
+          reason: "latest refresh lacks runtime details after completed state",
+          itemHash
+        });
+        return;
+      }
       this.emitProgress({
         stage: "deployment-confirmed",
         label: "Waiting for runtime",
@@ -2359,8 +2441,42 @@ var SponsorRelayController = class {
       Date.now() + STALE_INSTANCE_ALLOCATION_COOLDOWN_MS
     );
   }
+  rememberRuntimeDetails(itemHash, details) {
+    if (!hasUsableRuntime(details)) {
+      return;
+    }
+    this.runtimeDetailsByHash.set(itemHash, {
+      ...details,
+      mappedPorts: [...details.mappedPorts]
+    });
+  }
+  mergeRememberedRuntimeDetails(itemHash, details) {
+    const remembered = this.runtimeDetailsByHash.get(itemHash);
+    if (!remembered) {
+      return details;
+    }
+    if (details.messageStatus === "processed" && hasUsableRuntime(details)) {
+      return details;
+    }
+    this.trace("runtime:retain-known-details", {
+      itemHash,
+      currentStatus: details.messageStatus,
+      rememberedStatus: remembered.messageStatus,
+      currentHasRuntime: hasUsableRuntime(details)
+    });
+    return {
+      ...details,
+      ...remembered,
+      error: details.error ?? remembered.error
+    };
+  }
   async init() {
+    this.trace("init:start", {
+      launcherMode: this.props.launcherMode ?? "floating",
+      manifestUrl: this.state.manifestUrl
+    });
     this.stopWalletWatch = watchWallet(() => {
+      this.trace("wallet:changed");
       void this.refreshWalletDerivedState();
     });
     await this.refresh();
@@ -2372,6 +2488,7 @@ var SponsorRelayController = class {
     }, RELAY_PING_INTERVAL_MS);
     await this.refreshRelayPing();
     this.patch({ ready: true });
+    this.trace("init:ready");
   }
   destroy() {
     if (this.refreshTimer) clearInterval(this.refreshTimer);
@@ -2472,6 +2589,11 @@ var SponsorRelayController = class {
     }
   }
   async refresh() {
+    this.trace("refresh:start", {
+      wallet: this.state.wallet.address,
+      manifestUrl: this.state.manifestUrl,
+      showInstances: this.state.showInstances
+    });
     this.patch({
       busy: { refreshing: true },
       errorText: null,
@@ -2497,29 +2619,58 @@ var SponsorRelayController = class {
         balance = nextBalance;
         instances = await Promise.all(
           rawInstances.map(async (instance) => {
-            const details = this.canSkipRuntimeRefresh(instance) ? {
-              messageStatus: String(
-                instance.status ?? (instance.confirmed ? "processed" : "pending")
-              ).toLowerCase(),
-              allocationSource: null,
-              crnUrl: null,
-              hostIpv4: null,
-              ipv6: null,
-              vmIpv4: null,
-              webUrl: null,
-              sshCommand: null,
-              mappedPorts: [],
-              execution: null,
-              error: null
+            const inspected = this.canSkipRuntimeRefresh(instance) ? {
+              details: {
+                messageStatus: String(
+                  instance.status ?? (instance.confirmed ? "processed" : "pending")
+                ).toLowerCase(),
+                allocationSource: null,
+                crnUrl: null,
+                hostIpv4: null,
+                ipv6: null,
+                vmIpv4: null,
+                webUrl: null,
+                sshCommand: null,
+                mappedPorts: [],
+                execution: null,
+                error: null
+              },
+              lookup: {
+                allocationFound: false,
+                allocationSource: null,
+                crnUrl: null,
+                webUrl: null,
+                executionPayloadFound: false,
+                executionLookupBlocked: false,
+                executionLookupRequestUrl: null,
+                executionLookupVersion: null
+              }
             } : await inspectInstanceRuntime({
               client: this.client,
               instance,
               crns
             });
-            this.noteRuntimeRefreshResult(instance, details);
+            const details = inspected.details;
+            const mergedDetails = this.mergeRememberedRuntimeDetails(
+              instance.item_hash,
+              details
+            );
+            if (this.debugEnabled && instance.item_hash === this.state.lastDeploymentHash) {
+              this.trace("runtime:inspect-result", {
+                itemHash: instance.item_hash,
+                messageStatus: details.messageStatus,
+                hostIpv4: details.hostIpv4,
+                vmIpv4: details.vmIpv4,
+                mappedPorts: details.mappedPorts,
+                error: details.error,
+                lookup: inspected.lookup
+              });
+            }
+            this.rememberRuntimeDetails(instance.item_hash, mergedDetails);
+            this.noteRuntimeRefreshResult(instance, mergedDetails);
             return {
               instance,
-              details
+              details: mergedDetails
             };
           })
         );
@@ -2556,9 +2707,15 @@ var SponsorRelayController = class {
         busy: { refreshing: false },
         statusText: "Relay sponsor data ready"
       });
+      this.trace("refresh:success", {
+        manifestValid: manifestState.valid,
+        rootfsVerified,
+        instances: instances.length
+      });
       this.recomputePricingSummary();
       this.syncLatestDeploymentProgress(instances);
     } catch (error) {
+      this.trace("refresh:error", error);
       this.patch({
         busy: { refreshing: false },
         errorText: error instanceof Error ? error.message : String(error),
@@ -2569,8 +2726,17 @@ var SponsorRelayController = class {
   async refreshRelayPing() {
     const relayPing = await pingPeer(this.props.libp2p);
     this.patch({ relayPing });
+    this.trace("libp2p:relay-ping", relayPing);
   }
   async deploy() {
+    this.trace("deploy:start", {
+      wallet: this.state.wallet.address,
+      instanceName: this.state.instanceName,
+      tierId: this.state.tierId,
+      selectedCrn: this.state.selectedCrn?.name ?? null,
+      manifestRootfsItemHash: this.state.manifest?.rootfsItemHash ?? null,
+      requiredPortForwards: this.state.manifest?.requiredPortForwards ?? []
+    });
     if (!this.state.wallet.address) {
       this.patch({ errorText: "Connect MetaMask before deploying." });
       return;
@@ -2635,6 +2801,8 @@ var SponsorRelayController = class {
         statusText: `Deployment submitted: ${result.itemHash}`,
         lastDeploymentHash: result.itemHash
       });
+      this.trace("deploy:broadcasted", result);
+      this.lastRuntimeReadyHash = null;
       const inspection = await waitForDeploymentResult2(result.itemHash, {
         rootfsRef: this.state.manifest.rootfsItemHash,
         apiHost: this.client.apiHost,
@@ -2680,6 +2848,7 @@ var SponsorRelayController = class {
           inspection.rejectionReason ?? `Deployment ${result.itemHash} stayed ${inspection.status} on Aleph.`
         );
       }
+      this.trace("deploy:aleph-processed", inspection);
       if ((this.state.manifest.requiredPortForwards?.length ?? 0) > 0) {
         this.emitProgress({
           stage: "refreshing-instances",
@@ -2699,8 +2868,18 @@ var SponsorRelayController = class {
           apiHost: this.client.apiHost,
           sync: true
         });
+        this.trace("deploy:port-forwards-published", {
+          itemHash: result.itemHash,
+          requiredPortForwards: this.state.manifest.requiredPortForwards
+        });
       }
       if (this.state.selectedCrn?.address) {
+        this.trace("deploy:notifying-crn", {
+          itemHash: result.itemHash,
+          crnName: this.state.selectedCrn.name,
+          crnHash: this.state.selectedCrn.hash,
+          crnUrl: this.state.selectedCrn.address
+        });
         await notifyCrnAllocationWithRetry({
           crnUrl: this.state.selectedCrn.address,
           itemHash: result.itemHash,
@@ -2753,6 +2932,21 @@ var SponsorRelayController = class {
           runtime.diagnostics?.reason ?? "Deployment was processed, but runtime networking never exposed mapped ports."
         );
       }
+      this.trace("deploy:runtime-ready", runtime);
+      this.lastRuntimeReadyHash = result.itemHash;
+      this.rememberRuntimeDetails(result.itemHash, {
+        messageStatus: "processed",
+        allocationSource: runtime.allocation?.source ?? null,
+        crnUrl: runtime.allocation?.crnUrl ?? runtime.execution?.crnUrl ?? null,
+        hostIpv4: runtime.hostIpv4 ?? null,
+        ipv6: runtime.ipv6 ?? null,
+        vmIpv4: runtime.execution?.networking?.ipv4_ip ?? null,
+        webUrl: runtime.webAccessUrl ?? runtime.proxyUrl ?? runtime.execution?.networking?.proxy_url ?? null,
+        sshCommand: runtime.sshCommand ?? null,
+        mappedPorts: runtime.execution != null ? mappedPorts(runtime.execution) : runtimeMappedPorts(runtime.mappedPorts),
+        execution: runtime.execution ?? null,
+        error: null
+      });
       this.patch({
         busy: { deploying: false }
       });
@@ -2766,6 +2960,7 @@ var SponsorRelayController = class {
       });
       await this.refresh();
     } catch (error) {
+      this.trace("deploy:error", error);
       this.patch({
         busy: { deploying: false },
         errorText: error instanceof Error ? error.message : String(error),
@@ -2781,6 +2976,7 @@ var SponsorRelayController = class {
     }
   }
   async deleteInstance(instanceHash) {
+    this.trace("delete:start", { instanceHash });
     if (!this.state.wallet.address) {
       this.patch({ errorText: "Connect MetaMask before deleting instances." });
       return;
@@ -2828,6 +3024,7 @@ var SponsorRelayController = class {
         detail: "Reloading current deployments."
       });
       await this.refresh();
+      this.trace("delete:submitted", { instanceHash });
       this.emitProgress({
         stage: "completed",
         label: "Delete completed",
@@ -2838,6 +3035,7 @@ var SponsorRelayController = class {
         error: null
       });
     } catch (error) {
+      this.trace("delete:error", error);
       this.patch({
         busy: { deletingInstanceHash: null },
         errorText: error instanceof Error ? error.message : String(error),
@@ -2858,8 +3056,8 @@ function useSponsorRelayController(props) {
     [
       props.apiHost,
       props.crnListUrl,
+      props.debug,
       props.instanceName,
-      props.libp2p,
       props.manifestJson,
       props.manifestUrl,
       props.openByDefault,
@@ -2869,6 +3067,12 @@ function useSponsorRelayController(props) {
       props.twoN6ApiHost
     ]
   );
+  useEffect(() => {
+    controller.updateProps({
+      libp2p: props.libp2p,
+      debug: props.debug
+    });
+  }, [controller, props.debug, props.libp2p]);
   useEffect(() => {
     void controller.init();
     return () => {

package/shared/index.d.ts

@@ -188,6 +188,7 @@ type DeploymentProgressListener = (event: DeploymentProgressEvent) => void;
 type SponsorRelayHealthTone = 'ok' | 'caution' | 'error' | 'idle';
 interface SponsorRelayProps {
     libp2p?: unknown;
+    debug?: boolean;
     manifestUrl?: string;
     manifestJson?: string;
     sshPublicKey?: string;
@@ -343,16 +344,23 @@ declare class SponsorRelayController {
     private props;
     private progressEmitter;
     private runtimeCooldownByHash;
+    private runtimeDetailsByHash;
+    private debugEnabled;
+    private lastRuntimeReadyHash;
     constructor(props?: SponsorRelayProps);
     subscribeToDeploymentProgress(listener: DeploymentProgressListener): () => void;
     subscribe(subscriber: SponsorRelaySubscriber): () => void;
     getState(): SponsorRelayState;
+    updateProps(props: Partial<SponsorRelayProps>): void;
     private emit;
+    private trace;
     private patch;
     private emitProgress;
     private syncLatestDeploymentProgress;
     private canSkipRuntimeRefresh;
     private noteRuntimeRefreshResult;
+    private rememberRuntimeDetails;
+    private mergeRememberedRuntimeDetails;
     init(): Promise<void>;
     destroy(): void;
     setOpen(open: boolean): void;

package/shared/index.js

@@ -1984,6 +1984,16 @@ function defaultState(props = {}) {
     deploymentProgress: IDLE_DEPLOYMENT_PROGRESS
   };
 }
+function isDebugEnabled(props) {
+  if (props.debug) {
+    return true;
+  }
+  try {
+    return globalThis.localStorage?.getItem("LE_SPACE_UI_DEBUG") === "1";
+  } catch {
+    return false;
+  }
+}
 async function sha256Hex(payload) {
   const digest = await globalThis.crypto.subtle.digest(
     "SHA-256",
@@ -1999,6 +2009,12 @@ function mappedPorts(execution) {
     })
   );
 }
+function runtimeMappedPorts(mappedPortsRecord) {
+  return Object.entries(mappedPortsRecord ?? {}).map(([port, mapping]) => ({
+    label: `${port}/${mapping.udp ? "udp" : "tcp"}`,
+    hostPort: mapping.host ?? null
+  }));
+}
 function rootfsHealth(args) {
   if (!args.manifestState.valid || !args.manifestState.manifest) {
     return {
@@ -2069,8 +2085,18 @@ async function inspectInstanceRuntime(args) {
     execution: null,
     error: null
   };
-  if (details.messageStatus !== "processed") {
-    return details;
+  const lookup = {
+    allocationFound: false,
+    allocationSource: null,
+    crnUrl: null,
+    webUrl: null,
+    executionPayloadFound: false,
+    executionLookupBlocked: false,
+    executionLookupRequestUrl: null,
+    executionLookupVersion: null
+  };
+  if (details.messageStatus === "rejected" || details.messageStatus === "removing") {
+    return { details, lookup };
   }
   try {
     const allocation = await args.client.fetchSchedulerAllocation(args.instance.item_hash) ?? (() => {
@@ -2085,26 +2111,35 @@ async function inspectInstanceRuntime(args) {
         period: null
       } : null;
     })();
+    lookup.allocationFound = Boolean(allocation);
+    lookup.allocationSource = allocation?.source ?? null;
     details.allocationSource = allocation?.source ?? null;
     details.crnUrl = allocation?.crnUrl ?? null;
     details.ipv6 = allocation?.vmIpv6 ?? null;
     details.webUrl = await args.client.fetch2n6WebAccessUrl(
       args.instance.item_hash
     );
+    lookup.crnUrl = details.crnUrl;
+    lookup.webUrl = details.webUrl;
     if (!allocation?.crnUrl) {
-      return details;
+      return { details, lookup };
     }
     const executionLookup = await args.client.fetchCrnExecutionMap(
       allocation.crnUrl
     );
+    lookup.executionLookupBlocked = executionLookup.blocked;
+    lookup.executionLookupRequestUrl = executionLookup.requestUrl ?? null;
+    lookup.executionLookupVersion = executionLookup.version ?? null;
     const executionPayload = executionLookup.payload?.[args.instance.item_hash];
+    lookup.executionPayloadFound = Boolean(executionPayload);
     if (!executionPayload) {
-      return details;
+      return { details, lookup };
     }
     const execution = normalizeExecution(executionPayload, allocation.crnUrl);
     if (!execution.networking.proxy_url && details.webUrl) {
       execution.networking.proxy_url = details.webUrl;
     }
+    details.messageStatus = "processed";
     details.execution = execution;
     details.hostIpv4 = execution.networking.host_ipv4 ?? execution.networking.ipv4 ?? null;
     details.ipv6 = execution.networking.ipv6_ip ?? execution.networking.ipv6 ?? details.ipv6;
@@ -2112,11 +2147,14 @@ async function inspectInstanceRuntime(args) {
     details.webUrl = execution.networking.proxy_url ?? details.webUrl;
     details.mappedPorts = mappedPorts(execution);
     details.sshCommand = buildSshCommand(details.hostIpv4, details.mappedPorts);
-    return details;
+    return { details, lookup };
   } catch (error) {
     return {
-      ...details,
-      error: error instanceof Error ? error.message : String(error)
+      details: {
+        ...details,
+        error: error instanceof Error ? error.message : String(error)
+      },
+      lookup
     };
   }
 }
@@ -2225,9 +2263,13 @@ var SponsorRelayController = class {
   props;
   progressEmitter = createDeploymentProgressEmitter();
   runtimeCooldownByHash = /* @__PURE__ */ new Map();
+  runtimeDetailsByHash = /* @__PURE__ */ new Map();
+  debugEnabled;
+  lastRuntimeReadyHash = null;
   constructor(props = {}) {
     this.props = props;
     this.state = defaultState(props);
+    this.debugEnabled = isDebugEnabled(props);
     this.client = createAlephBrowserClient({
       apiHost: props.apiHost,
       crnListUrl: props.crnListUrl,
@@ -2247,10 +2289,24 @@ var SponsorRelayController = class {
   getState() {
     return this.state;
   }
+  updateProps(props) {
+    this.props = { ...this.props, ...props };
+    this.debugEnabled = isDebugEnabled(this.props);
+  }
   emit() {
     const next = this.state;
     this.subscribers.forEach((subscriber) => subscriber(next));
   }
+  trace(message, data) {
+    if (!this.debugEnabled) {
+      return;
+    }
+    if (data === void 0) {
+      console.debug("[le-space/ui]", message);
+      return;
+    }
+    console.debug("[le-space/ui]", message, data);
+  }
   patch(patch) {
     this.state = {
       ...this.state,
@@ -2267,6 +2323,14 @@ var SponsorRelayController = class {
       ...event,
       timestamp: Date.now()
     };
+    this.trace(`progress:${nextEvent.stage}`, {
+      label: nextEvent.label,
+      progress: nextEvent.progress,
+      status: nextEvent.status,
+      itemHash: nextEvent.itemHash ?? null,
+      detail: nextEvent.detail ?? null,
+      error: nextEvent.error ?? null
+    });
     this.patch({
       deploymentProgress: nextEvent,
       statusText: event.error ?? event.detail ?? event.label,
@@ -2285,6 +2349,9 @@ var SponsorRelayController = class {
     if (!latest) {
       return;
     }
+    const currentProgress = this.state.deploymentProgress;
+    const currentProgressIsForLatestHash = currentProgress.itemHash === itemHash || currentProgress.itemHash == null && currentProgress.stage !== "idle" && currentProgress.stage !== "error";
+    const keepTerminalSuccess = this.lastRuntimeReadyHash === itemHash || currentProgressIsForLatestHash && currentProgress.stage === "completed" && currentProgress.status === "success";
     const status = latest.details.messageStatus;
     if (status === "rejected") {
       this.emitProgress({
@@ -2299,6 +2366,14 @@ var SponsorRelayController = class {
       return;
     }
     if (status !== "processed") {
+      if (keepTerminalSuccess) {
+        this.trace("progress:retain-completed", {
+          reason: "latest refresh still reports non-processed status",
+          itemHash,
+          status
+        });
+        return;
+      }
       const submittedAtMs = instanceTimestampMs(latest.instance);
       const pendingTooLong = submittedAtMs != null && Date.now() - submittedAtMs >= DEPLOYMENT_PENDING_WARNING_MS;
       this.emitProgress({
@@ -2312,6 +2387,13 @@ var SponsorRelayController = class {
       return;
     }
     if (!hasUsableRuntime(latest.details)) {
+      if (keepTerminalSuccess) {
+        this.trace("progress:retain-completed", {
+          reason: "latest refresh lacks runtime details after completed state",
+          itemHash
+        });
+        return;
+      }
       this.emitProgress({
         stage: "deployment-confirmed",
         label: "Waiting for runtime",
@@ -2358,8 +2440,42 @@ var SponsorRelayController = class {
       Date.now() + STALE_INSTANCE_ALLOCATION_COOLDOWN_MS
     );
   }
+  rememberRuntimeDetails(itemHash, details) {
+    if (!hasUsableRuntime(details)) {
+      return;
+    }
+    this.runtimeDetailsByHash.set(itemHash, {
+      ...details,
+      mappedPorts: [...details.mappedPorts]
+    });
+  }
+  mergeRememberedRuntimeDetails(itemHash, details) {
+    const remembered = this.runtimeDetailsByHash.get(itemHash);
+    if (!remembered) {
+      return details;
+    }
+    if (details.messageStatus === "processed" && hasUsableRuntime(details)) {
+      return details;
+    }
+    this.trace("runtime:retain-known-details", {
+      itemHash,
+      currentStatus: details.messageStatus,
+      rememberedStatus: remembered.messageStatus,
+      currentHasRuntime: hasUsableRuntime(details)
+    });
+    return {
+      ...details,
+      ...remembered,
+      error: details.error ?? remembered.error
+    };
+  }
   async init() {
+    this.trace("init:start", {
+      launcherMode: this.props.launcherMode ?? "floating",
+      manifestUrl: this.state.manifestUrl
+    });
     this.stopWalletWatch = watchWallet(() => {
+      this.trace("wallet:changed");
       void this.refreshWalletDerivedState();
     });
     await this.refresh();
@@ -2371,6 +2487,7 @@ var SponsorRelayController = class {
     }, RELAY_PING_INTERVAL_MS);
     await this.refreshRelayPing();
     this.patch({ ready: true });
+    this.trace("init:ready");
   }
   destroy() {
     if (this.refreshTimer) clearInterval(this.refreshTimer);
@@ -2471,6 +2588,11 @@ var SponsorRelayController = class {
     }
   }
   async refresh() {
+    this.trace("refresh:start", {
+      wallet: this.state.wallet.address,
+      manifestUrl: this.state.manifestUrl,
+      showInstances: this.state.showInstances
+    });
     this.patch({
       busy: { refreshing: true },
       errorText: null,
@@ -2496,29 +2618,58 @@ var SponsorRelayController = class {
         balance = nextBalance;
         instances = await Promise.all(
           rawInstances.map(async (instance) => {
-            const details = this.canSkipRuntimeRefresh(instance) ? {
-              messageStatus: String(
-                instance.status ?? (instance.confirmed ? "processed" : "pending")
-              ).toLowerCase(),
-              allocationSource: null,
-              crnUrl: null,
-              hostIpv4: null,
-              ipv6: null,
-              vmIpv4: null,
-              webUrl: null,
-              sshCommand: null,
-              mappedPorts: [],
-              execution: null,
-              error: null
+            const inspected = this.canSkipRuntimeRefresh(instance) ? {
+              details: {
+                messageStatus: String(
+                  instance.status ?? (instance.confirmed ? "processed" : "pending")
+                ).toLowerCase(),
+                allocationSource: null,
+                crnUrl: null,
+                hostIpv4: null,
+                ipv6: null,
+                vmIpv4: null,
+                webUrl: null,
+                sshCommand: null,
+                mappedPorts: [],
+                execution: null,
+                error: null
+              },
+              lookup: {
+                allocationFound: false,
+                allocationSource: null,
+                crnUrl: null,
+                webUrl: null,
+                executionPayloadFound: false,
+                executionLookupBlocked: false,
+                executionLookupRequestUrl: null,
+                executionLookupVersion: null
+              }
             } : await inspectInstanceRuntime({
               client: this.client,
               instance,
               crns
             });
-            this.noteRuntimeRefreshResult(instance, details);
+            const details = inspected.details;
+            const mergedDetails = this.mergeRememberedRuntimeDetails(
+              instance.item_hash,
+              details
+            );
+            if (this.debugEnabled && instance.item_hash === this.state.lastDeploymentHash) {
+              this.trace("runtime:inspect-result", {
+                itemHash: instance.item_hash,
+                messageStatus: details.messageStatus,
+                hostIpv4: details.hostIpv4,
+                vmIpv4: details.vmIpv4,
+                mappedPorts: details.mappedPorts,
+                error: details.error,
+                lookup: inspected.lookup
+              });
+            }
+            this.rememberRuntimeDetails(instance.item_hash, mergedDetails);
+            this.noteRuntimeRefreshResult(instance, mergedDetails);
             return {
               instance,
-              details
+              details: mergedDetails
             };
           })
         );
@@ -2555,9 +2706,15 @@ var SponsorRelayController = class {
         busy: { refreshing: false },
         statusText: "Relay sponsor data ready"
       });
+      this.trace("refresh:success", {
+        manifestValid: manifestState.valid,
+        rootfsVerified,
+        instances: instances.length
+      });
       this.recomputePricingSummary();
       this.syncLatestDeploymentProgress(instances);
     } catch (error) {
+      this.trace("refresh:error", error);
       this.patch({
         busy: { refreshing: false },
         errorText: error instanceof Error ? error.message : String(error),
@@ -2568,8 +2725,17 @@ var SponsorRelayController = class {
   async refreshRelayPing() {
     const relayPing = await pingPeer(this.props.libp2p);
     this.patch({ relayPing });
+    this.trace("libp2p:relay-ping", relayPing);
   }
   async deploy() {
+    this.trace("deploy:start", {
+      wallet: this.state.wallet.address,
+      instanceName: this.state.instanceName,
+      tierId: this.state.tierId,
+      selectedCrn: this.state.selectedCrn?.name ?? null,
+      manifestRootfsItemHash: this.state.manifest?.rootfsItemHash ?? null,
+      requiredPortForwards: this.state.manifest?.requiredPortForwards ?? []
+    });
     if (!this.state.wallet.address) {
       this.patch({ errorText: "Connect MetaMask before deploying." });
       return;
@@ -2634,6 +2800,8 @@ var SponsorRelayController = class {
         statusText: `Deployment submitted: ${result.itemHash}`,
         lastDeploymentHash: result.itemHash
       });
+      this.trace("deploy:broadcasted", result);
+      this.lastRuntimeReadyHash = null;
       const inspection = await waitForDeploymentResult2(result.itemHash, {
         rootfsRef: this.state.manifest.rootfsItemHash,
         apiHost: this.client.apiHost,
@@ -2679,6 +2847,7 @@ var SponsorRelayController = class {
           inspection.rejectionReason ?? `Deployment ${result.itemHash} stayed ${inspection.status} on Aleph.`
         );
       }
+      this.trace("deploy:aleph-processed", inspection);
       if ((this.state.manifest.requiredPortForwards?.length ?? 0) > 0) {
         this.emitProgress({
           stage: "refreshing-instances",
@@ -2698,8 +2867,18 @@ var SponsorRelayController = class {
           apiHost: this.client.apiHost,
           sync: true
         });
+        this.trace("deploy:port-forwards-published", {
+          itemHash: result.itemHash,
+          requiredPortForwards: this.state.manifest.requiredPortForwards
+        });
       }
       if (this.state.selectedCrn?.address) {
+        this.trace("deploy:notifying-crn", {
+          itemHash: result.itemHash,
+          crnName: this.state.selectedCrn.name,
+          crnHash: this.state.selectedCrn.hash,
+          crnUrl: this.state.selectedCrn.address
+        });
         await notifyCrnAllocationWithRetry({
           crnUrl: this.state.selectedCrn.address,
           itemHash: result.itemHash,
@@ -2752,6 +2931,21 @@ var SponsorRelayController = class {
           runtime.diagnostics?.reason ?? "Deployment was processed, but runtime networking never exposed mapped ports."
         );
       }
+      this.trace("deploy:runtime-ready", runtime);
+      this.lastRuntimeReadyHash = result.itemHash;
+      this.rememberRuntimeDetails(result.itemHash, {
+        messageStatus: "processed",
+        allocationSource: runtime.allocation?.source ?? null,
+        crnUrl: runtime.allocation?.crnUrl ?? runtime.execution?.crnUrl ?? null,
+        hostIpv4: runtime.hostIpv4 ?? null,
+        ipv6: runtime.ipv6 ?? null,
+        vmIpv4: runtime.execution?.networking?.ipv4_ip ?? null,
+        webUrl: runtime.webAccessUrl ?? runtime.proxyUrl ?? runtime.execution?.networking?.proxy_url ?? null,
+        sshCommand: runtime.sshCommand ?? null,
+        mappedPorts: runtime.execution != null ? mappedPorts(runtime.execution) : runtimeMappedPorts(runtime.mappedPorts),
+        execution: runtime.execution ?? null,
+        error: null
+      });
       this.patch({
         busy: { deploying: false }
       });
@@ -2765,6 +2959,7 @@ var SponsorRelayController = class {
       });
       await this.refresh();
     } catch (error) {
+      this.trace("deploy:error", error);
       this.patch({
         busy: { deploying: false },
         errorText: error instanceof Error ? error.message : String(error),
@@ -2780,6 +2975,7 @@ var SponsorRelayController = class {
     }
   }
   async deleteInstance(instanceHash) {
+    this.trace("delete:start", { instanceHash });
     if (!this.state.wallet.address) {
       this.patch({ errorText: "Connect MetaMask before deleting instances." });
       return;
@@ -2827,6 +3023,7 @@ var SponsorRelayController = class {
         detail: "Reloading current deployments."
       });
       await this.refresh();
+      this.trace("delete:submitted", { instanceHash });
       this.emitProgress({
         stage: "completed",
         label: "Delete completed",
@@ -2837,6 +3034,7 @@ var SponsorRelayController = class {
         error: null
       });
     } catch (error) {
+      this.trace("delete:error", error);
       this.patch({
         busy: { deletingInstanceHash: null },
         errorText: error instanceof Error ? error.message : String(error),