foundry-design-web-adapter 0.2.0-beta.3 → 0.2.0-beta.4

package/README.md

@@ -4,27 +4,51 @@ Foundry is a local-first precision design workbench for Codex, Cursor, and Claud
 
 ## Beta installation
 
-Foundry is distributed through npm, so testers do not need access to the private GitHub repository. From the project you want to inspect, run:
+Foundry is distributed through npm, so testers do not need GitHub access.
+
+### Recommended: let your coding agent install it
+
+Open the project in Codex, Cursor, or Claude Code and paste:
+
+```text
+Install Foundry for this project by running npx foundry-design@beta setup --yes. Check the result and tell me when I need to restart.
+```
+
+Setup detects the project and active coding agent, installs development-only instrumentation, configures the local agent connection, validates the integration, and records everything it owns for safe updates or removal.
+
+Restart the coding agent once, reopen the same project folder, and paste:
+
+```text
+Start Foundry for this project and keep listening for Apply with agent requests.
+```
+
+That is the normal workflow. Foundry starts the project when needed, opens an authenticated local preview, and shows **Agent is ready** before it allows an apply request.
+
+### Manual installation
+
+From the project you want to inspect, run:
 
 ```bash
 npx foundry-design@beta setup
 ```
 
-Setup detects the platform, framework, package manager, development command, and installed coding agents. It previews every file it will manage, adds development-only instrumentation for supported web frameworks, installs the Foundry skill for Codex, Cursor, or Claude Code, configures the selected MCP clients, and records a reversible install manifest.
-
-Restart the coding agent after setup, then ask:
+Then restart the coding agent, reopen the same project folder, and ask:
 
 ```text
-Start Foundry for this project.
+Start Foundry for this project and keep listening for Apply with agent requests.
 ```
 
-Then start a session with:
+You do not need to run a second terminal command when the agent starts Foundry for you. For a manual-only preview, run `npx foundry-design@beta start`, but Apply with agent still requires a restarted and actively listening coding agent.
+
+Update an existing installation with:
 
 ```bash
-npx foundry-design@beta start
+npx foundry-design@beta update
 ```
 
-Foundry reuses an available project server or starts the detected development command, launches the loopback runtime, and opens an authenticated visual preview. Remove only Foundry-managed integration with:
+The updater refreshes checksum-matched Foundry files, agent connections, and skill bundles. It preserves and reports files changed since setup, validates the project, and rolls back the update if Foundry introduces a TypeScript or lint failure. Restart the coding agent after updating.
+
+Remove only Foundry-managed integration with:
 
 ```bash
 npx foundry-design@beta uninstall

package/dist/adapter.js

@@ -1264,6 +1264,14 @@ var PANEL_CSS = `
   .review-overview .review-toolbar { position:static;z-index:auto;flex:none;padding:0;border:0;background:transparent;backdrop-filter:none; }
   .review-overview .review-toolbar button { height:28px;padding:0 8px;border-color:transparent;background:transparent;color:var(--fdc-muted);font-size:8px; }
   .review-overview .review-toolbar button:hover { color:var(--fdc-ink);background:var(--fdc-elevated);border-color:var(--fdc-line); }
+  .review-agent { display:grid;grid-template-columns:8px minmax(0,1fr) auto;align-items:center;gap:12px;margin:12px 16px 0;padding:12px;border:1px solid var(--fdc-line);border-radius:8px;background:var(--fdc-paper); }
+  .review-agent>i { width:8px;height:8px;border-radius:50%;background:#d16d51; }
+  .review-agent.connected>i { background:#2ca67f;box-shadow:0 0 0 4px rgb(44 166 127 / 12%); }
+  .review-agent strong,.review-agent span { display:block; }
+  .review-agent strong { font-size:12px;font-weight:600; }
+  .review-agent span { margin-top:4px;color:var(--fdc-muted);font-size:12px;line-height:1.45; }
+  .review-agent button { height:32px;padding:0 12px;border:1px solid var(--fdc-line);border-radius:8px;background:var(--fdc-elevated);color:var(--fdc-ink);font-size:12px;cursor:pointer; }
+  .review-agent button:hover { border-color:var(--fdc-muted); }
   .change-tray .review-group { border-right:0;border-bottom:1px solid var(--fdc-line); }
   .change-tray .review-group-title { position:sticky;top:52px;z-index:2;min-height:40px;padding:0 12px;background:rgb(28 28 31 / 98%); }
   .review-group-title .included-count { font-size:8px; }
@@ -2081,6 +2089,7 @@ function installFoundryInspector(options = {}) {
   let selectedControls = [];
   let resizeObserver;
   let activeReviewPayload = null;
+  let activeAgentPresence = { connected: false, presence: null };
   const reviewDraftKey = `__foundry_review_draft:${sessionId || "local"}`;
   let reviewDraft = (() => {
     try {
@@ -3394,8 +3403,29 @@ function installFoundryInspector(options = {}) {
       const count = group.querySelector(".included-count");
       if (count) count.textContent = `${included} included`;
     });
-    applyButton.textContent = selectedCount ? `Apply ${selectedCount} with agent` : "Apply with agent";
-    applyButton.disabled = selectedCount === 0;
+    applyButton.textContent = !activeAgentPresence.connected ? "Connect agent to apply" : selectedCount ? `Apply ${selectedCount} with agent` : "Apply with agent";
+    applyButton.disabled = selectedCount === 0 || !activeAgentPresence.connected;
+  }
+  function agentConnectionMarkup() {
+    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` : "Connect your coding agent"}</strong><span>${activeAgentPresence.connected ? "Apply requests will be claimed automatically while this agent keeps listening." : "In the same project, ask your agent to start Foundry and keep listening for Apply requests."}</span></div>${activeAgentPresence.connected ? "" : "<button data-copy-agent-listener>Copy instruction</button>"}</div>`;
+  }
+  function updateAgentConnection() {
+    const current = reviewBody.querySelector(".review-agent");
+    if (!current) {
+      updateReviewSelection();
+      return;
+    }
+    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");
+    });
+    updateReviewSelection();
   }
   function renderReviewList(changes) {
     const groups = /* @__PURE__ */ new Map();
@@ -3409,7 +3439,7 @@ function installFoundryInspector(options = {}) {
     const unresolvedCount = changes.filter(
       (change) => change.confidence === "unresolved" || change.mappingCandidates?.length > 1 && !change.selectedMappingId
     ).length;
-    reviewBody.innerHTML = changes.length || rejectedCount ? `<div class="review-overview"><div class="review-summary" data-unresolved="${unresolvedCount}" aria-live="polite"><strong>Preparing review\u2026</strong><span>Only included, exactly mapped changes will be sent to your agent.</span></div><div class="review-toolbar"><button data-review-compare>Compare</button><button data-review-approve-exact>Include all</button><button data-review-toggle-rejected>${reviewShowRejected ? "Hide removed" : rejectedCount ? `${rejectedCount} removed` : "Removed"}</button></div></div>${[
+    reviewBody.innerHTML = changes.length || rejectedCount ? `<div class="review-overview"><div class="review-summary" data-unresolved="${unresolvedCount}" aria-live="polite"><strong>Preparing review\u2026</strong><span>Only included, exactly mapped changes will be sent to your agent.</span></div><div class="review-toolbar"><button data-review-compare>Compare</button><button data-review-approve-exact>Include all</button><button data-review-toggle-rejected>${reviewShowRejected ? "Hide removed" : rejectedCount ? `${rejectedCount} removed` : "Removed"}</button></div></div>${agentConnectionMarkup()}${[
       ...groups.values()
     ].map((group) => {
       const target = group[0].target;
@@ -3443,6 +3473,12 @@ function installFoundryInspector(options = {}) {
     reviewCancel.dataset.action = "back";
     reviewCancel.textContent = "Back";
     renderIcons(reviewBody);
+    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.querySelectorAll("[data-review-change]").forEach(
       (field) => field.addEventListener("change", () => {
         reviewDraft.selections[field.dataset.reviewChange] = field.checked;
@@ -3668,7 +3704,11 @@ function installFoundryInspector(options = {}) {
   async function refreshReview() {
     if (!workspaceState.reviewOpen || !sessionId || !token) return;
     try {
-      const payload = await sessionRequest();
+      const [payload, presence] = await Promise.all([
+        sessionRequest(),
+        sessionRequest("/agent-presence")
+      ]);
+      activeAgentPresence = presence;
       const latestRun = payload.applyRuns?.at(-1);
       const runNeedsRefresh = latestRun && [
         "queued",
@@ -3681,6 +3721,7 @@ function installFoundryInspector(options = {}) {
       ].includes(latestRun.state);
       if (applyButton.dataset.action === "apply" && !runNeedsRefresh) {
         activeReviewPayload = payload;
+        updateAgentConnection();
         return;
       }
       renderReviewPayload(payload);
@@ -3702,7 +3743,12 @@ function installFoundryInspector(options = {}) {
     workspaceState = updateWorkspace(workspaceState, { type: "set-review", open: true });
     reviewTakeover.hidden = false;
     outline.hidden = true;
-    renderReviewPayload(await sessionRequest());
+    const [payload, presence] = await Promise.all([
+      sessionRequest(),
+      sessionRequest("/agent-presence")
+    ]);
+    activeAgentPresence = presence;
+    renderReviewPayload(payload);
     requestAnimationFrame(() => {
       reviewBody.scrollTop = reviewScrollTop;
       shadow.querySelector(".review-back")?.focus();
@@ -3743,6 +3789,12 @@ function installFoundryInspector(options = {}) {
     );
     applyButton.disabled = true;
     try {
+      activeAgentPresence = await sessionRequest("/agent-presence");
+      if (!activeAgentPresence.connected) {
+        updateAgentConnection();
+        showToast("No coding agent is listening yet");
+        return;
+      }
       const payload = await sessionRequest("/apply-runs", {
         method: "POST",
         body: JSON.stringify({

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6DA,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;AA6+BD,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,uBAA4B,GACpC,0BAA0B,CAqvK5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6DA,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;AAq/BD,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,uBAA4B,GACpC,0BAA0B,CA4yK5B"}

package/package.json

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