@floless/app 0.25.1 → 0.25.2

package/dist/floless-server.cjs

@@ -52777,7 +52777,7 @@ function appVersion() {
   return resolveVersion({
     isSea: isSea2(),
     sqVersionXml: readSqVersionXml(),
-    define: true ? "0.25.1" : void 0,
+    define: true ? "0.25.2" : void 0,
     pkgVersion: readPkgVersion()
   });
 }
@@ -52787,7 +52787,7 @@ function resolveChannel(s) {
   return "dev";
 }
 function appChannel() {
-  return resolveChannel({ isSea: isSea2(), define: true ? "0.25.1" : void 0 });
+  return resolveChannel({ isSea: isSea2(), define: true ? "0.25.2" : void 0 });
 }
 
 // oauth-presets.ts
@@ -57665,11 +57665,29 @@ async function startServer() {
       throw err;
     }
   });
+  const installingAgents = /* @__PURE__ */ new Set();
+  let installQueue = Promise.resolve();
   app.post("/api/agents/install", async (req, reply) => {
     const id = req.body?.id;
     if (!id || typeof id !== "string") return reply.status(400).send({ ok: false, error: "id is required" });
-    const result = await aware.ensureAgentInstalled(id);
-    return { ok: true, id: result.installed ?? id };
+    if (installingAgents.has(id)) return reply.status(202).send({ ok: true, started: true });
+    installingAgents.add(id);
+    installQueue = installQueue.then(async () => {
+      let result;
+      try {
+        const res = await aware.ensureAgentInstalled(id);
+        result = { type: "agent-install-result", id, ok: true, installed: res.installed ?? id };
+      } catch (err) {
+        result = { type: "agent-install-result", id, ok: false, error: err instanceof Error ? err.message : String(err) };
+      } finally {
+        installingAgents.delete(id);
+      }
+      try {
+        broadcast(result);
+      } catch {
+      }
+    });
+    return reply.status(202).send({ ok: true, started: true });
   });
   app.get("/api/integrations", async () => {
     let integrations = listIntegrations();

package/dist/web/aware.js

@@ -3292,6 +3292,23 @@
         loadAgentCatalog().then(() => {
           if ($libModal && $libModal.classList.contains('show')) renderLibrary();
         }).catch(() => {});
+      } else if (m.type === 'agent-install-result') {
+        // A background `aware agent install` (from the Available tab) finished. Clear
+        // its in-flight state, then on success refresh so it drops out of Available and
+        // appears under Installed; on failure restore its Install button + surface why.
+        installingIds.delete(m.id);
+        if (m.ok) {
+          const a = availableCatalog.find((x) => x.id === m.id);
+          showToast(`Installed “${a && a.display_name ? a.display_name : m.id}” — find it in Installed`, 'ok');
+          loadAgentCatalog().then(() => {
+            if (!($libModal && $libModal.classList.contains('show'))) return;
+            renderAvailable();
+            if (libTab === 'installed') renderLibrary();
+          }).catch(() => {});
+        } else {
+          showToast(`Install failed: ${String(m.error || '').slice(0, 80)}`, 'err');
+          if ($libModal && $libModal.classList.contains('show')) renderAvailable();
+        }
       } else if (m.type === 'request-added' || m.type === 'requests-changed') {
         loadRequests();
         if (window.flolessPanels) window.flolessPanels.refreshPending(); // composer's "queued" line
@@ -3796,6 +3813,7 @@
   let availableLoading = false;     // a fetch is in flight (prevents a double-fetch race)
   let availableUnsupported = false; // CLI too old to know `agent catalog`
   let libTab = 'installed';
+  const installingIds = new Set(); // ids with an install in flight (server runs it async)
 
   async function loadAvailableAgents() {
     const { agents, unsupported } = await api('/api/agents/available');
@@ -3817,6 +3835,11 @@
     // renders "undefined command". (Numbers, so no escaping needed.)
     const cmds = Number(a.commands) || 0;
     const skills = Number(a.skills) || 0;
+    // The install runs server-side and can take a minute; the button persists its
+    // "Installing…" state across re-renders (search/tab-switch) via installingIds.
+    const installBtn = installingIds.has(a.id)
+      ? `<button class="lib-install" aria-busy="true" aria-label="Installing ${escapeAttr(a.display_name || a.id)}…" data-tip="Downloading from the registry — this can take a minute"><span class="rtn-spinner"></span></button>`
+      : `<button class="lib-install" data-install="${escapeAttr(a.id)}" aria-label="Install ${escapeAttr(a.display_name || a.id)}">Install</button>`;
     return `
       <div class="lib-card" data-agent="${escapeAttr(a.id)}">
         <div class="lib-item">
@@ -3825,7 +3848,7 @@
             <div class="meta">${cmds} command${cmds === 1 ? '' : 's'} · ${skills} skill${skills === 1 ? '' : 's'}</div>
             ${blurb}
           </div>
-          <button class="lib-install" data-install="${escapeAttr(a.id)}" aria-label="Install ${escapeAttr(a.display_name || a.id)}">Install</button>
+          ${installBtn}
         </div>
       </div>`;
   }
@@ -3896,29 +3919,28 @@
     });
   }
 
-  async function installAgent(id, btn) {
-    const label = btn.getAttribute('aria-label') || `Install ${id}`;
+  // Kick off an install. The server runs `aware agent install` asynchronously (it can
+  // take a minute — it downloads from the registry) and reports completion over SSE
+  // (`agent-install-result`), so we DON'T await it here — that's what made the button
+  // look hung. We flip the card to "Installing…" and let the SSE handler finish it.
+  function installAgent(id, btn) {
+    if (installingIds.has(id)) return; // already in flight (server dedupes too)
+    installingIds.add(id);
     const a = availableCatalog.find((x) => x.id === id);
-    btn.setAttribute('aria-busy', 'true');
-    btn.setAttribute('aria-label', label.replace(/^Install/, 'Installing') + '…');
-    btn.innerHTML = '<span class="rtn-spinner"></span>';
-    try {
-      await api('/api/agents/install', { method: 'POST', body: JSON.stringify({ id }) });
-    } catch (e) {
-      btn.removeAttribute('aria-busy');
-      btn.setAttribute('aria-label', label);
-      btn.textContent = 'Install';
-      reportErr(e);
-      return;
+    const nice = a && a.display_name ? a.display_name : id;
+    if (btn) { // immediate feedback before the next render
+      btn.setAttribute('aria-busy', 'true');
+      btn.setAttribute('aria-label', `Installing ${nice}…`);
+      btn.removeAttribute('data-install'); // a stray re-wire can't re-trigger it
+      btn.innerHTML = '<span class="rtn-spinner"></span>';
     }
-    // Installed now — signal success BEFORE the catalog refresh so a transient refresh
-    // failure can't swallow the confirmation of an install that already succeeded.
-    showToast(`Installed “${a && a.display_name ? a.display_name : id}” — find it in Installed`, 'ok');
-    // Refresh the Installed catalog (footer count + Installed tab) best-effort, then
-    // re-render Available so the now-installed agent drops out (= not-yet-installed).
-    try { await loadAgentCatalog(); } catch (e) { console.warn('post-install catalog refresh failed', e); }
-    renderAvailable();
-    if (libTab === 'installed') renderLibrary();
+    showToast(`Installing “${nice}” — this can take a minute or two`, 'info');
+    api('/api/agents/install', { method: 'POST', body: JSON.stringify({ id }) })
+      .catch((e) => { // the START failed (bad id / server) — completion errors arrive via SSE
+        installingIds.delete(id);
+        if ($libModal && $libModal.classList.contains('show')) renderAvailable();
+        reportErr(e);
+      });
   }
 
   function switchLibTab(tab) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floless/app",
-  "version": "0.25.1",
+  "version": "0.25.2",
   "type": "module",
   "description": "Thin localhost host for floless.app — serves web/ and shells the aware CLI. No engine, no LLM.",
   "bin": {