foundry-design-web-adapter 0.2.0-beta.6 → 0.2.0-beta.7

package/README.md

@@ -6,7 +6,7 @@ Foundry is a local-first precision design workbench for Codex, Cursor, and Claud
 
 Foundry is distributed through npm, so testers do not need GitHub access.
 
-> **Current public beta:** `0.2.0-beta.6`. Install Foundry with the `@beta` tag. The unqualified npm `latest` tag still points to an earlier beta and is not the current testing channel.
+> **Current public beta:** `0.2.0-beta.7`. Install Foundry with the `@beta` tag. The unqualified npm `latest` tag still points to an earlier beta and is not the current testing channel.
 
 Full documentation is available at [withfoundry.ai](https://withfoundry.ai).
 
@@ -96,7 +96,9 @@ Foundry remains local-first. Installing the plugin does not create an account, e
 - Persistent, coalescing change ledger with JSON and consolidated prompt export
 - Compact in-preview review with editable approved batches and unresolved-target blocking
 - Persistent Apply with agent runs across Codex, Cursor, and Claude Code through MCP
+- Leased agent handoffs that safely return abandoned or interrupted claims to the queue
 - Live source, rebuild, validation, retry, and rendered-verification progress
+- Rendered verification that resumes after refresh and does not depend on Review remaining open
 - Local MCP bridge for agent access
 - Debug adapters for web, SwiftUI, and React Native on iOS Simulator
 - Verification records that compare requested and rendered values

package/dist/adapter.js

@@ -1399,6 +1399,7 @@ var PANEL_CSS = `
   .property-control input,.property-control select,.compact-control input,.compact-control select { height:36px;font-size:12px;font-weight:400; }
   .control-field .unit-select { width:44px;padding-right:24px!important;background-position:right 8px center!important; }
   .section-grid { gap:8px;padding:0 16px 16px; }
+  .inspector-category[data-category="position"]>.category-body>.property-section>.section-grid { padding-top:12px; }
   @media (max-width:680px){.panel,.layers-panel{width:auto}.panel-resizer{display:none}.change-tray{right:8px;bottom:8px;left:auto;width:calc(100vw - 16px)}.review-takeover{padding:8px}.review-modal{width:calc(100vw - 16px);height:calc(100vh - 16px);border-radius:12px}.review-modal .review-actions{grid-template-columns:84px 1fr}.panel.change-summary-visible .inspector-scroll{padding-bottom:60px}}
   @media (prefers-reduced-motion:reduce){*{transition-duration:.01ms!important}.layer-row.entering,.layer-branch{animation:none!important}}
 `;
@@ -2122,6 +2123,7 @@ function installFoundryInspector(options = {}) {
   let reviewShowRejected = false;
   const collapsedReviewGroups = /* @__PURE__ */ new Set();
   let reviewPoll;
+  let sessionPoll;
   let lastReviewTrigger = null;
   let reviewScrollTop = 0;
   let reviewSuspended = false;
@@ -2514,7 +2516,8 @@ function installFoundryInspector(options = {}) {
         (change) => change.status !== "rejected" && String(change.before) !== String(change.after)
       );
       recordedChangeCount = activeChanges.length;
-      latestApplyState = payload.applyRuns?.at(-1)?.state ?? "none";
+      const latestRun = payload.applyRuns?.at(-1);
+      latestApplyState = latestRun?.state ?? "none";
       updateChangeCount(activeChanges.length, activeChanges.at(-1));
       completeOnboardingStep("setup");
       if (activeAgentPresence.connected) completeOnboardingStep("agent");
@@ -2524,6 +2527,7 @@ function installFoundryInspector(options = {}) {
       renderOnboardingChecklist();
       setSessionStatus("live");
       if (!libraryPanel.hidden) renderDesignMemory();
+      if (latestRun?.state === "verifying") maybeVerifyRun(latestRun);
       if (changeSet.changes.length === 0 && !hydratedOnce) {
         showToast("Click any element. Shift-click builds a selection.");
       }
@@ -2537,7 +2541,11 @@ function installFoundryInspector(options = {}) {
     }
   }
   void hydrateSession();
-  const healthPoll = setInterval(() => void hydrateSession(), 5e3);
+  function startSessionPolling() {
+    clearInterval(sessionPoll);
+    sessionPoll = setInterval(() => void hydrateSession(), 5e3);
+  }
+  startSessionPolling();
   function showToast(message) {
     const toast = shadow.querySelector(".toast");
     toast.textContent = message;
@@ -3520,6 +3528,12 @@ function installFoundryInspector(options = {}) {
     const agentName = activeAgentPresence.presence?.agent?.name;
     return `<div class="review-agent ${activeAgentPresence.connected ? "connected" : "disconnected"}" aria-live="polite"><i></i><div><strong>${activeAgentPresence.connected ? `${escapeHtml(agentName ?? "Coding agent")} is ready` : "Agent currently offline"}</strong><span>${activeAgentPresence.connected ? "Apply requests will be claimed automatically while this agent keeps listening." : "You can queue this batch now. Codex, Cursor, or Claude Code will claim it when the Foundry listener reconnects."}</span></div>${activeAgentPresence.connected ? "" : "<button data-copy-agent-listener>Copy reconnect instruction</button>"}</div>`;
   }
+  function copyAgentListenerInstruction() {
+    void navigator.clipboard.writeText(
+      "Start Foundry for this project and keep listening for Apply with agent requests."
+    );
+    showToast("Agent instruction copied");
+  }
   function updateAgentConnection() {
     const current = reviewBody.querySelector(".review-agent");
     if (!current) {
@@ -3529,12 +3543,7 @@ function installFoundryInspector(options = {}) {
     const replacement = document.createElement("div");
     replacement.innerHTML = agentConnectionMarkup();
     current.replaceWith(replacement.firstElementChild);
-    reviewBody.querySelector("[data-copy-agent-listener]")?.addEventListener("click", () => {
-      void navigator.clipboard.writeText(
-        "Start Foundry for this project and keep listening for Apply with agent requests."
-      );
-      showToast("Agent instruction copied");
-    });
+    reviewBody.querySelector("[data-copy-agent-listener]")?.addEventListener("click", copyAgentListenerInstruction);
     updateReviewSelection();
   }
   function renderReviewList(changes) {
@@ -3700,7 +3709,7 @@ function installFoundryInspector(options = {}) {
   }
   const runStateLabels = {
     queued: "Queued for agent",
-    claimed: "Agent connected",
+    claimed: "Handoff received",
     applying: "Applying source changes",
     rebuilding: "Rebuilding and checking",
     verifying: "Verifying rendered values",
@@ -3709,6 +3718,19 @@ function installFoundryInspector(options = {}) {
     failed: "Apply failed",
     cancelled: "Apply cancelled"
   };
+  function maybeVerifyRun(run) {
+    if (run.state !== "verifying" || verifyingRuns.has(run.id)) return;
+    const reloadKey = "__foundry_verifying_run";
+    if (sessionStorage.getItem(reloadKey) !== run.id) {
+      sessionStorage.setItem(reloadKey, run.id);
+      location.reload();
+      return;
+    }
+    verifyingRuns.add(run.id);
+    void verify(run.changeIds, run.id).then(() => sessionStorage.removeItem(reloadKey)).catch((error) => {
+      showToast(error instanceof Error ? error.message : "Rendered verification was interrupted");
+    }).finally(() => verifyingRuns.delete(run.id));
+  }
   function captureVerifiedRun(run) {
     if (run.state !== "passed" || capturedBaselineRuns.has(run.id)) return;
     const changes = (activeReviewPayload?.changeSet?.changes ?? []).filter(
@@ -3748,13 +3770,13 @@ function installFoundryInspector(options = {}) {
     const attention = ["needs_attention", "failed"].includes(run.state);
     const passed = run.state === "passed";
     const active = ["queued", "claimed", "applying", "rebuilding", "verifying"].includes(run.state);
-    const latestMessage = run.state === "queued" ? "The reviewed changes are queued. Keep your coding agent active, or ask it to apply your reviewed Foundry changes." : run.messages.at(-1)?.message ?? run.error ?? "Apply run created.";
+    const latestMessage = run.state === "queued" ? run.requeueCount > 0 ? "The previous agent did not begin source work, so Foundry safely returned this batch to the queue." : "The reviewed changes are queued and ready for an active coding agent." : run.state === "claimed" ? activeAgentPresence.connected ? "The agent received this batch. Waiting for source work to begin." : "The agent disconnected before source work began. Foundry will return this batch to the queue shortly." : run.messages.at(-1)?.message ?? run.error ?? "Apply run created.";
     latestApplyState = run.state;
     if (run.state === "passed") completeOnboardingStep("apply");
     captureVerifiedRun(run);
     reviewCount.textContent = `Attempt ${run.attempts}`;
     reviewBody.innerHTML = `<div class="run-summary"><div class="run-state"><i class="${passed ? "passed" : attention ? "attention" : active ? "active" : ""}"></i><strong>${escapeHtml(runStateLabels[run.state] ?? run.state)}</strong></div><p>${escapeHtml(latestMessage)}</p></div><div class="run-steps">${run.messages.map(
-      (message, index) => `<div class="run-step"><span>${String(index + 1).padStart(2, "0")}</span><div><strong>${escapeHtml(runStateLabels[message.state] ?? message.state)}</strong><p>${escapeHtml(message.state === "queued" ? "Ready for the active coding agent to claim." : message.message)}</p></div></div>`
+      (message, index) => `<div class="run-step"><span>${String(index + 1).padStart(2, "0")}</span><div><strong>${escapeHtml(runStateLabels[message.state] ?? message.state)}</strong><p>${escapeHtml(message.message)}</p></div></div>`
     ).join(
       ""
     )}</div>${run.changedFiles.length ? `<div class="run-files"><strong>Changed files</strong>${run.changedFiles.map((file) => `<code>${escapeHtml(file)}</code>`).join("")}</div>` : ""}${run.validationResults.length ? `<div class="result-list">${run.validationResults.map((result) => `<div class="result-row ${result.passed ? "pass" : "fail"}"><span>${result.passed ? "Passed" : "Failed"} \xB7 ${escapeHtml(result.name)}</span><span>${escapeHtml(result.summary ?? "")}</span></div>`).join("")}</div>` : ""}${run.verificationResults.length ? `<div class="result-list">${run.verificationResults.map((result) => `<div class="result-row ${result.passed ? "pass" : "fail"}"><span>${result.passed ? "Matched" : "Mismatch"} \xB7 ${escapeHtml(result.property)}</span><span>${escapeHtml(reviewValue(result.requested))} \u2192 ${escapeHtml(reviewValue(result.rendered))}</span></div>`).join("")}</div>` : ""}`;
@@ -3762,6 +3784,10 @@ function installFoundryInspector(options = {}) {
       applyButton.dataset.action = "retry";
       applyButton.textContent = "Retry with agent";
       applyButton.disabled = false;
+    } else if (["queued", "claimed"].includes(run.state) && !activeAgentPresence.connected) {
+      applyButton.dataset.action = "reconnect";
+      applyButton.textContent = "Reconnect agent";
+      applyButton.disabled = false;
     } else {
       applyButton.dataset.action = "status";
       applyButton.textContent = passed ? "Verified" : active ? runStateLabels[run.state] ?? run.state : "Run complete";
@@ -3769,19 +3795,7 @@ function installFoundryInspector(options = {}) {
     }
     reviewCancel.dataset.action = active ? "cancel" : "back";
     reviewCancel.textContent = active ? "Cancel" : "Back";
-    if (run.state === "verifying" && !verifyingRuns.has(run.id)) {
-      const reloadKey = "__foundry_verifying_run";
-      if (sessionStorage.getItem(reloadKey) !== run.id) {
-        sessionStorage.setItem(reloadKey, run.id);
-        location.reload();
-        return;
-      }
-      verifyingRuns.add(run.id);
-      void verify(run.changeIds, run.id).finally(() => {
-        verifyingRuns.delete(run.id);
-        sessionStorage.removeItem(reloadKey);
-      });
-    }
+    maybeVerifyRun(run);
   }
   function renderReviewPayload(payload) {
     const preservedScrollTop = reviewBody.scrollTop || reviewScrollTop;
@@ -3868,7 +3882,8 @@ function installFoundryInspector(options = {}) {
       shadow.querySelector(".review-back")?.focus();
     });
     clearInterval(reviewPoll);
-    clearInterval(healthPoll);
+    clearInterval(sessionPoll);
+    sessionPoll = void 0;
     reviewPoll = setInterval(() => void refreshReview(), 1e3);
   }
   function closeReview(restoreFocus = true) {
@@ -3877,6 +3892,7 @@ function installFoundryInspector(options = {}) {
     reviewTakeover.hidden = true;
     clearInterval(reviewPoll);
     reviewPoll = void 0;
+    startSessionPolling();
     updateOutline();
     if (restoreFocus) lastReviewTrigger?.focus();
   }
@@ -6394,6 +6410,7 @@ function installFoundryInspector(options = {}) {
   applyButton.addEventListener("click", () => {
     if (applyButton.dataset.action === "apply") void submitReviewedRun();
     if (applyButton.dataset.action === "retry") void retryRun();
+    if (applyButton.dataset.action === "reconnect") copyAgentListenerInstruction();
   });
   function handleGlobalShortcuts(event) {
     if (workspaceState.reviewOpen && event.key === "Tab") {
@@ -6505,6 +6522,7 @@ function installFoundryInspector(options = {}) {
     systemDarkTheme.removeEventListener("change", handleSystemThemeChange);
     document.removeEventListener("pointerdown", handleInterfaceThemeDismiss, true);
     clearInterval(reviewPoll);
+    clearInterval(sessionPoll);
     document.removeEventListener("click", handlePointer, true);
     document.removeEventListener("dblclick", handleTextEdit, true);
     document.removeEventListener("pointermove", handleSelectionHover, true);

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA8DA,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,IAAI,IAAI,CAAC;IAChB,cAAc,IAAI,IAAI,CAAC;IACvB,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AAu/BD,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,uBAA4B,GACpC,0BAA0B,CAm9K5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA8DA,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,IAAI,IAAI,CAAC;IAChB,cAAc,IAAI,IAAI,CAAC;IACvB,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AAw/BD,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,uBAA4B,GACpC,0BAA0B,CA++K5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foundry-design-web-adapter",
-  "version": "0.2.0-beta.6",
+  "version": "0.2.0-beta.7",
   "description": "Development-only browser inspector for Foundry",
   "type": "module",
   "main": "dist/adapter.js",