@comty.io/core 0.1.2 → 0.1.4

package/src/browser.js

@@ -1,6 +1,6 @@
 import { getComtyStyle } from "./style.js";
 import { createAnchorMatcher } from "./anchors.js";
-import { createScreenshotCapture, createColorMagnifier } from "./capture.js";
+import { createScreenshotCapture, createColorMagnifier, captureContext } from "./capture.js";
 import { createCommentThread } from "./comments.js";
 import { createMeasurements } from "./measurements.js";
 // Shared browser runtime. Both npm and the standalone CDN script use this file.
@@ -9,17 +9,7 @@ const instanceKey = Symbol.for("comty.sdk.instance");
 /** Initialize once per document; safe to import and call during server rendering. */
 export function initComty(options = {}) {
   if (typeof window === "undefined" || typeof document === "undefined") return Promise.resolve();
-  const isLocalSite = ["localhost", "127.0.0.1", "[::1]"].includes(window.location.hostname);
-  const agent = options.agent;
-  if (agent && (!isLocalSite || typeof agent.token !== "string" || !/^[a-f0-9]{64}$/.test(agent.token))) {
-    return Promise.reject(new TypeError("Comty: invalid local companion configuration"));
-  }
-  if (agent) {
-    try {
-      if (new URL(agent.url).origin !== window.location.origin) throw new Error();
-    } catch { return Promise.reject(new TypeError("Comty: companion must share the page origin")); }
-  }
-  const projectKey = options.projectKey || (agent ? "local" : undefined);
+  const projectKey = options.projectKey;
   const apiUrl = options.apiUrl || "http://localhost:4000";
   if (typeof projectKey !== "string" || !projectKey.trim()) {
     return Promise.reject(new TypeError("Comty: projectKey is required"));
@@ -31,14 +21,12 @@ export function initComty(options = {}) {
   if (!["http:", "https:"].includes(parsedApi.protocol)) {
     return Promise.reject(new TypeError("Comty: apiUrl must be an absolute HTTP(S) URL"));
   }
-  const configuration = JSON.stringify([projectKey, apiUrl, agent || null]);
+  const configuration = JSON.stringify([projectKey, apiUrl]);
   const existing = window[instanceKey];
   if (existing) {
     return existing.configuration === configuration ? existing.ready
       : Promise.reject(new Error("Comty: already initialized with different options"));
   }
-  const agentBridgeUrl = agent?.url;
-  const localOnly = Boolean(agent && !options.projectKey);
   const ready = new Promise((resolve, reject) => {
     const mount = () => {
       try { resolve(mountComty()); } catch (error) { reject(error); }
@@ -52,19 +40,10 @@ export function initComty(options = {}) {
 
   function mountComty() {
     let projectId = null;
-    let localTasks = [];
-    let localApprovals = [];
-    let agentPanelOpen = false;
-    let agentPanelSignature = "";
-    let agentPanelTransition = 0;
-    let agentConnectionError = "";
-    let agentActionError = "";
-    const agentPendingActions = new Set();
     const session = {
       mode: "off",
-      get comments() { return this.mode === "browse" || this.mode === "edit" || this.mode === "agent"; },
-      get edit() { return this.mode === "edit" || this.mode === "agent"; },
-      get agent() { return this.mode === "agent"; },
+      get comments() { return this.mode === "browse" || this.mode === "edit"; },
+      get edit() { return this.mode === "edit"; },
       get inspect() { return this.mode === "inspect"; },
     };
     const selectedStatusFilters = new Set();
@@ -78,21 +57,22 @@ export function initComty(options = {}) {
     const observedCommentTargets = new WeakSet();
     let sidepanelOpen = false;
     let canWrite = false;
+    let canManage = false;
+    let allowGuestComments = false;
     let loginUrl = "";
     let currentUser = null;
     let authStatus = "";
     let didCompleteSignIn = false;
     const tokenStorageKey = `comty:${projectKey}:token`;
+    const authReturnStorageKey = `comty:${projectKey}:auth-return`;
     let sdkToken = "";
     const activeHoverCommentIds = new Set();
-    /** @type {null | 'edit' | 'browse' | 'agent'} */
+    /** @type {null | 'edit' | 'browse'} */
     let sessionEntry = null;
     const placedPins = new Map();
-    const workingOutlines = new Map();
     const placementDiagnostics = new Map();
     let inspectedElement = null;
     let selectedElement = null;
-    let inspectExpanded = false;
     let measureAlt = false;
     let inspectDrag = null;
     let measuredRegion = null;
@@ -135,7 +115,6 @@ export function initComty(options = {}) {
     const root = document.createElement("div");
     root.id = "comty-root";
     document.body.appendChild(root);
-    if (agent) document.documentElement.classList.add("comty-agent-enabled");
 
     const style = document.createElement("style");
     style.innerHTML = getComtyStyle();
@@ -183,40 +162,20 @@ export function initComty(options = {}) {
     const inspectorBtn = toolButton("Inspect · Shift I", '<path d="M8 3H5a2 2 0 0 0-2 2v3m13-5h3a2 2 0 0 1 2 2v3M3 16v3a2 2 0 0 0 2 2h3m13-5v3a2 2 0 0 1-2 2h-3"/><path d="m9 9 8 4-4 1-1 4Z"/>', () => setSession("inspect"));
     const btn = toolButton("Comment · Shift C", '<path d="M21 11.5a8.4 8.4 0 0 1-.9 3.8 8.5 8.5 0 0 1-7.6 4.7 8.4 8.4 0 0 1-3.8-.9L3 21l1.9-5.7a8.4 8.4 0 0 1-.9-3.8 8.5 8.5 0 0 1 4.7-7.6A8.4 8.4 0 0 1 12.5 3h.5a8.5 8.5 0 0 1 8 8v.5Z"/>', () => {
       if (!canWrite) showAuthPrompt();
-      else if (session.agent || session.inspect || !isSessionActive()) startEditSession();
+      else if (session.inspect || !isSessionActive()) startEditSession();
       else if (!session.edit) setSession("edit", { entry: sessionEntry });
     });
     btn.id = "comty-toggle";
-    const agentBtn = isLocalSite
-      ? toolButton("Agent task · localhost only", '<path d="M8 7 3 12l5 5m8-10 5 5-5 5M14 4l-4 16"/>', () => {
-          startAgentSession();
-        })
-      : null;
     const divider = document.createElement("span");
     divider.className = "comty-tool-divider";
     toolbar.appendChild(divider);
     const commentTools = document.createElement("div");
     commentTools.className = "comty-tool-context";
     toolbar.appendChild(commentTools);
-    const agentTools = agentBtn ? document.createElement("div") : null;
-    if (agentTools) {
-      agentTools.className = "comty-tool-context";
-      agentTools.hidden = true;
-      toolbar.appendChild(agentTools);
-    }
-    const agentHistoryBtn = agentTools ? toolButton("Local agent history", '<path d="M3 12a9 9 0 1 0 3-6.7M3 4v4h4"/><path d="M12 7v5l3 2"/>', () => {
-      if (!agent) { showAgentBridgeError(); return; }
-      agentPanelOpen = !agentPanelOpen;
-      renderAgentPanel();
-    }) : null;
-    if (agentHistoryBtn) {
-      agentHistoryBtn.setAttribute("aria-expanded", "false");
-      agentTools.appendChild(agentHistoryBtn);
-    }
     const primaryTools = document.createElement("div");
     primaryTools.className = "comty-tool-primary";
     toolbar.insertBefore(primaryTools, browseBtn);
-    for (const button of [browseBtn, inspectorBtn, btn, agentBtn].filter(Boolean)) primaryTools.appendChild(button);
+    for (const button of [browseBtn, inspectorBtn, btn]) primaryTools.appendChild(button);
     const inspectorTools = document.createElement("div");
     inspectorTools.className = "comty-tool-context";
     inspectorTools.hidden = true;
@@ -795,6 +754,21 @@ export function initComty(options = {}) {
     const copyIcon = icon('<rect x="8" y="8" width="12" height="12" rx="2"/><path d="M16 8V6a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v8a2 2 0 0 0 2 2h2"/>');
     const checkIcon = icon('<path d="m5 12 4 4 10-10"/>');
     const copyFeedbackTimers = new WeakMap();
+    async function copyPropertyValue(button, feedback) {
+      clearTimeout(copyFeedbackTimers.get(button));
+      try {
+        await navigator.clipboard.writeText(button.dataset.copy);
+        if (!button.isConnected) return;
+        button.dataset.copied = "";
+        feedback.textContent = "Copied";
+        clearTimeout(copyFeedbackTimers.get(button));
+        copyFeedbackTimers.set(button, setTimeout(() => { delete button.dataset.copied; }, 1200));
+      } catch {
+        delete button.dataset.copied;
+        if (button.isConnected) feedback.textContent = "Clipboard unavailable — select the value to copy";
+      }
+    }
+
     function propertyRow(label, value, display = value) {
       const unavailable = value === "—";
       return `<div class="comty-property-row"><span>${label}</span><button type="button" data-copy="${escapeInspectorText(value)}" aria-label="Copy ${label}: ${escapeInspectorText(display)}" ${unavailable ? "disabled" : ""}><span>${escapeInspectorText(display)}</span>${unavailable ? "" : `<i class="comty-property-copy-icon" aria-hidden="true">${copyIcon}${checkIcon}</i>`}</button></div>`;
@@ -821,7 +795,7 @@ export function initComty(options = {}) {
       propertyPanel.setAttribute("aria-label", propertyKind === "color" ? "Recent colours" : "Recent typography");
       const recent = propertyKind === "color" ? recentColors : recentFonts;
       const details = propertyKind === "color" && expanded
-        ? `<div class="comty-property-detail"><div class="comty-property-rows">${propertyRow("HEX", propertySelection.hex)}${propertyRow("RGB", propertySelection.rgb)}${propertyRow("HSL", propertySelection.hsl)}${propertyRow("OKLCH", propertySelection.oklch)}${propertyRow("Token", propertySelection.token ? `var(${propertySelection.token})` : "—")}</div></div>`
+        ? `<div class="comty-property-detail"><div class="comty-property-rows">${propertyRow("HEX", propertySelection.hex)}${propertyRow("RGB", propertySelection.rgb)}${propertyRow("HSL", propertySelection.hsl)}${propertyRow("OKLCH", propertySelection.oklch)}${propertyRow("Token", propertySelection.token ? propertySelection.token.replace(/^--/, "") : "—", propertySelection.token || "—")}</div></div>`
         : propertyKind === "font" && expanded
           ? `<div class="comty-property-detail"><div class="comty-property-rows">${propertyRow("Family", propertySelection.family)}${propertyRow("Size", propertySelection.size)}${propertyRow("Weight", propertySelection.weight)}${propertyRow("Leading", propertySelection.leading)}${propertyRow("Tracking", propertySelection.tracking)}${propertyRow("Colour", propertySelection.color?.hex || "—")}${propertyRow("CSS", propertySelection.css, "All of the above")}</div></div>`
           : "";
@@ -937,18 +911,7 @@ export function initComty(options = {}) {
         renderPropertyPanel(true);
         propertyPanel.querySelector(`button[data-recent="${button.dataset.recent}"]`)?.focus({ preventScroll: true });
       } else if (button.dataset.copy != null && button.dataset.copy !== "—") {
-        clearTimeout(copyFeedbackTimers.get(button));
-        try {
-          await navigator.clipboard.writeText(button.dataset.copy);
-          if (!button.isConnected || propertyPanel.hidden) return;
-          button.dataset.copied = "";
-          propertyPanel.querySelector(".comty-property-feedback").textContent = `${button.getAttribute("aria-label").slice(5)} copied`;
-          clearTimeout(copyFeedbackTimers.get(button));
-          copyFeedbackTimers.set(button, setTimeout(() => { delete button.dataset.copied; }, 1200));
-        } catch {
-          delete button.dataset.copied;
-          if (button.isConnected && !propertyPanel.hidden) propertyPanel.querySelector(".comty-property-feedback").textContent = "Clipboard unavailable";
-        }
+        await copyPropertyValue(button, propertyPanel.querySelector(".comty-property-feedback"));
       }
     };
 
@@ -1065,50 +1028,6 @@ export function initComty(options = {}) {
     let toolbarMotionFrame = 0;
     let toolbarAnimations = [];
     const reducedMotion = matchMedia("(prefers-reduced-motion: reduce)");
-    let workingIndicatorTimer = 0;
-    function scheduleWorkingIndicators() {
-      if (workingIndicatorTimer || reducedMotion.matches || document.hidden) return;
-      workingIndicatorTimer = setTimeout(() => {
-        workingIndicatorTimer = 0;
-        if (!root.isConnected) return;
-        const indicators = root.querySelectorAll('.comty-working-indicator');
-        if (!indicators.length) return;
-        for (const indicator of indicators) {
-          const previous = Number(indicator.dataset.activeDots.split(',')[0]);
-          const first = (previous + 1 + Math.floor(Math.random() * 8)) % 9;
-          const second = (first + 1 + Math.floor(Math.random() * 8)) % 9;
-          indicator.dataset.activeDots = `${first},${second}`;
-          [...indicator.children].forEach((dot, index) => dot.toggleAttribute('data-active', index === first || index === second));
-        }
-        scheduleWorkingIndicators();
-      }, 600);
-    }
-    function createWorkingIndicator() {
-      const indicator = document.createElement('span');
-      indicator.className = 'comty-working-indicator';
-      indicator.setAttribute('aria-hidden', 'true');
-      indicator.dataset.activeDots = '3,5';
-      for (let index = 0; index < 9; index++) {
-        const dot = document.createElement('i');
-        dot.toggleAttribute('data-active', index === 3 || index === 5);
-        indicator.appendChild(dot);
-      }
-      scheduleWorkingIndicators();
-      return indicator;
-    }
-    function resetWorkingIndicators() {
-      clearTimeout(workingIndicatorTimer);
-      workingIndicatorTimer = 0;
-      if (reducedMotion.matches) {
-        for (const indicator of root.querySelectorAll('.comty-working-indicator')) {
-          indicator.dataset.activeDots = '3,5';
-          [...indicator.children].forEach((dot, index) => dot.toggleAttribute('data-active', index === 3 || index === 5));
-        }
-      }
-      if (root.querySelector('.comty-working-indicator')) scheduleWorkingIndicators();
-    }
-    reducedMotion.addEventListener('change', resetWorkingIndicators);
-    document.addEventListener('visibilitychange', resetWorkingIndicators);
     const clampToolbar = (value, size, viewport) => Math.max(8, Math.min(value, viewport - size - 8));
     function rememberToolbarPosition(left, top) {
       const width = toolbar.offsetWidth, height = toolbar.offsetHeight;
@@ -1221,7 +1140,7 @@ export function initComty(options = {}) {
 
     function prepareToolbarMotion() {
       if (toolbarMotionFrame) return;
-      const nodes = [toolbarSurface, dragHandle, primaryTools, commentTools, agentTools, inspectorTools].filter(Boolean);
+      const nodes = [toolbarSurface, dragHandle, primaryTools, commentTools, inspectorTools].filter(Boolean);
       // Move each group's background with its icons, including when interrupted.
       const before = new Map(nodes.filter(node => !node.hidden).map(node => [node, {
         rect: node.getBoundingClientRect(), opacity: getComputedStyle(node).opacity,
@@ -1464,7 +1383,7 @@ export function initComty(options = {}) {
         return;
       }
 
-      if ((session.edit && mode === "browse") || (session.agent && mode === "edit")) {
+      if (session.edit && mode === "browse") {
         closeBubbles();
       }
       const hadComments = session.comments;
@@ -1478,7 +1397,6 @@ export function initComty(options = {}) {
       } else {
         hideInspector();
       }
-      if (session.agent && sidepanelOpen) setSidepanelOpen(false);
       syncToolbar();
       ensureLiveTracking();
       if (renderComments || !hadComments) renderCachedComments();
@@ -1490,11 +1408,8 @@ export function initComty(options = {}) {
         : headers;
     }
 
-    function showAuthPrompt(forbidden = false) {
-      if (localOnly) {
-        showAgentBridgeError("Shared comments need a Comty project key. Use the Agent tool for local tasks without signing in.");
-        return;
-      }
+    function showAuthPrompt(forbidden = false, onReady = startEditSession) {
+      const guestAllowed = allowGuestComments;
       document.querySelector(".comty-auth-backdrop")?.remove();
       const opener = document.activeElement;
       const backdrop = document.createElement("div");
@@ -1505,12 +1420,23 @@ export function initComty(options = {}) {
             <span class="comty-auth-icon">${icon('<path d="M21 11.5a8.4 8.4 0 0 1-.9 3.8 8.5 8.5 0 0 1-7.6 4.7 8.4 8.4 0 0 1-3.8-.9L3 21l1.9-5.7a8.5 8.5 0 1 1 16.1-3.8Z"/>')}</span>
             <button type="button" class="comty-auth-close" data-comty-close aria-label="Close sign-in dialog">${icon('<path d="m6 6 12 12M6 18 18 6"/>')}</button>
           </div>
-          <h2 id="comty-auth-title">${forbidden ? "Project access required" : "Sign in to comment"}</h2>
-          <p id="comty-auth-description">${forbidden ? "This account is not a member of this project. Ask the project owner for an invite." : "Sign in to share feedback with your team and keep the conversation in one place."}</p>
-          <div class="comty-auth-actions">
-            <button type="button" data-comty-close>${forbidden ? "Close" : "Cancel"}</button>
-            ${forbidden ? "" : '<button type="button" class="comty-auth-primary" data-comty-login>Continue to sign in</button>'}
-          </div>
+          <h2 id="comty-auth-title">${guestAllowed ? "Leave a comment" : forbidden ? "Project access required" : "Sign in to comment"}</h2>
+          <p id="comty-auth-description">${guestAllowed ? "Continue with your name or sign in with Google." : forbidden ? "This account is not a member of this project. Ask the project owner for an invite." : "Sign in to share feedback with your team and keep the conversation in one place."}</p>
+          ${guestAllowed ? `
+            <form class="comty-guest-form">
+              <label for="comty-guest-name">Your name</label>
+              <input id="comty-guest-name" name="name" autocomplete="name" placeholder="Your name" maxlength="80" required aria-describedby="comty-guest-error" />
+              <p id="comty-guest-error" role="alert" hidden></p>
+              <div class="comty-auth-actions comty-guest-actions">
+                <button type="submit" class="comty-auth-primary" data-comty-guest>Continue</button>
+                <span class="comty-auth-or">or</span>
+                <button type="button" data-comty-login>Continue with Google</button>
+              </div>
+            </form>` : `
+            <div class="comty-auth-actions">
+              <button type="button" data-comty-close>${forbidden ? "Close" : "Cancel"}</button>
+              ${forbidden ? "" : '<button type="button" class="comty-auth-primary" data-comty-login>Continue to sign in</button>'}
+            </div>`}
         </div>`;
       const close = () => {
         backdrop.remove();
@@ -1521,11 +1447,12 @@ export function initComty(options = {}) {
         event.stopPropagation();
         if (event.key === "Escape") { event.preventDefault(); close(); }
         if (event.key === "Tab") {
-          const buttons = [...backdrop.querySelectorAll("button:not(:disabled)")];
+          const buttons = [...backdrop.querySelectorAll("button:not(:disabled), input:not(:disabled)")];
           if (!buttons.length) { event.preventDefault(); return; }
-          const first = buttons[0], last = buttons.at(-1);
-          if (event.shiftKey && document.activeElement === first) { event.preventDefault(); last.focus(); }
-          else if (!event.shiftKey && document.activeElement === last) { event.preventDefault(); first.focus(); }
+          event.preventDefault();
+          const index = buttons.indexOf(document.activeElement);
+          const next = (index + (event.shiftKey ? -1 : 1) + buttons.length) % buttons.length;
+          buttons[next].focus();
         }
       });
       const loginButton = backdrop.querySelector("[data-comty-login]");
@@ -1533,15 +1460,62 @@ export function initComty(options = {}) {
         loginButton.onclick = () => {
           loginButton.disabled = true;
           loginButton.innerText = "Connecting…";
-          backdrop.querySelectorAll("[data-comty-close]").forEach(button => { button.disabled = true; });
-          setTimeout(() => window.location.assign(loginUrl), 50);
+          backdrop.querySelectorAll("button, input").forEach(control => { control.disabled = true; });
+          try {
+            sessionStorage.setItem(authReturnStorageKey, JSON.stringify({
+              mode: onReady === startEditSession || session.mode === "off" ? "edit" : session.mode,
+              entry: sessionEntry,
+              sidepanelOpen,
+            }));
+          } catch { /* Resume in comment mode if browser storage is unavailable. */ }
+          const destination = new URL("/api/auth/sign-in/google", apiUrl);
+          destination.searchParams.set("callbackURL", loginUrl);
+          setTimeout(() => window.location.assign(guestAllowed ? destination.toString() : loginUrl), 50);
         };
       }
+      const guestForm = backdrop.querySelector(".comty-guest-form");
+      if (guestForm) guestForm.onsubmit = async event => {
+        event.preventDefault();
+        const nameInput = guestForm.querySelector("input");
+        const error = guestForm.querySelector("[role=alert]");
+        const name = nameInput.value.trim();
+        if (!name) { nameInput.focus(); return; }
+        const controls = [...backdrop.querySelectorAll("button, input")];
+        controls.forEach(control => { control.disabled = true; });
+        error.hidden = true;
+        const continueButton = guestForm.querySelector("[data-comty-guest]");
+        continueButton.textContent = "Connecting…";
+        try {
+          const response = await fetch(`${apiUrl}/api/sdk/guest`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ projectKey, name }),
+          });
+          const data = await response.json();
+          if (!response.ok) throw new Error(data.error || "Unable to continue. Please try again.");
+          sdkToken = data.token;
+          try { sessionStorage.setItem(tokenStorageKey, sdkToken); } catch { /* Keep the session in memory when browser storage is unavailable. */ }
+          currentUser = data.user;
+          canWrite = true;
+          canManage = false;
+          if (backdrop.isConnected) {
+            close();
+            onReady();
+          }
+        } catch (failure) {
+          if (!backdrop.isConnected) return;
+          error.textContent = failure.message || "Unable to connect. Please try again.";
+          error.hidden = false;
+          controls.forEach(control => { control.disabled = false; });
+          continueButton.textContent = "Continue";
+          nameInput.focus();
+        }
+      };
       backdrop.onclick = (event) => {
         if (event.target === backdrop) close();
       };
       root.appendChild(backdrop);
-      (loginButton || backdrop.querySelector("[data-comty-close]")).focus({ preventScroll: true });
+      (backdrop.querySelector("#comty-guest-name") || loginButton || backdrop.querySelector("[data-comty-close]")).focus({ preventScroll: true });
     }
 
     function formatBoxValue(value) {
@@ -1556,17 +1530,14 @@ export function initComty(options = {}) {
     }
 
     function syncToolbar() {
-      if (commentTools.hidden !== (session.inspect || session.agent) || inspectorTools.hidden !== !session.inspect || (agentTools && agentTools.hidden !== !session.agent)) prepareToolbarMotion();
+      if (commentTools.hidden !== session.inspect || inspectorTools.hidden !== !session.inspect) prepareToolbarMotion();
       root.classList.toggle("comty-active", session.comments || session.edit || sidepanelOpen || session.inspect);
       browseBtn.setAttribute("aria-pressed", String(!session.edit && !session.inspect));
       inspectorBtn.setAttribute("aria-pressed", String(session.inspect));
-      btn.setAttribute("aria-pressed", String(session.edit && !session.agent));
-      agentBtn?.setAttribute("aria-pressed", String(session.edit && session.agent));
-      commentTools.hidden = session.inspect || session.agent;
-      if (agentTools) agentTools.hidden = !session.agent;
+      btn.setAttribute("aria-pressed", String(session.edit));
+      commentTools.hidden = session.inspect;
       inspectorTools.hidden = !session.inspect;
       syncInspectorTools();
-      renderAgentPanel();
     }
 
     const inspectionLayer = document.createElement("div");
@@ -1741,7 +1712,8 @@ export function initComty(options = {}) {
       add("background", css.backgroundColor, (tokens.background.length > 0 || !["rgba(0, 0, 0, 0)", "rgb(255, 255, 255)"].includes(css.backgroundColor)));
       add("color", css.color);
       if (getElementOwnTextSignature(el)) {
-        add("font", `${css.fontSize} / ${css.fontWeight}`);
+        add("font-size", css.fontSize);
+        add("font-weight", css.fontWeight);
         add("font-family", css.fontFamily);
         add("line-height", css.lineHeight);
         add("letter-spacing", css.letterSpacing, css.letterSpacing !== "normal");
@@ -1925,7 +1897,7 @@ export function initComty(options = {}) {
         height: draftBubble.offsetHeight,
       };
       const pinBounds = draftPin?.getBoundingClientRect();
-      const signature = JSON.stringify([selector, rect, hoverRect, rows, !!selected, inspectExpanded, measureAlt, draftBounds, pinBounds, spacing]);
+      const signature = JSON.stringify([selector, rect, hoverRect, rows, !!selected, measureAlt, draftBounds, pinBounds, spacing, innerWidth, innerHeight]);
       if (signature === inspectionSignature) return;
       inspectionSignature = signature;
       inspectionLayer.replaceChildren();
@@ -1951,36 +1923,34 @@ export function initComty(options = {}) {
       const panel = document.createElement("div");
       panel.className = "comty-inspector";
       panel.setAttribute("aria-label", "Element properties");
-      if (selected) panel.dataset.selected = "";
-      const copyable = (value) => `<button type="button" title="Copy ${escapeInspectorText(value)}" data-copy="${escapeInspectorText(value)}">${escapeInspectorText(value)}</button>`;
-      const featured = new Set(["background", "color", "font", "font-family"]);
-      const visibleRows = inspectExpanded ? rows : selected ? [...rows.filter(([key]) => featured.has(key)), ...rows.filter(([key]) => !featured.has(key))].slice(0, 6) : rows.slice(0, 6);
-      panel.innerHTML = `<div class="comty-inspector-head">${copyable(selector)}${copyable(`${formatBoxValue(rect.width)} × ${formatBoxValue(rect.height)}`)}</div><div class="comty-inspector-details">${visibleRows.map(([key, value, tokens]) => {
-        const picker = key === "background" || key === "color" ? "color" : key === "font" || key === "font-family" ? "font" : "";
-        const valueButton = picker && selected
-          ? `<button type="button" class="comty-inspector-picker" data-picker="${picker}" data-property="${key}" aria-label="Open ${picker === "color" ? key + " colour" : "typography"} details">${picker === "color" ? '<span class="comty-inspector-swatch" aria-hidden="true"></span>' : ""}${escapeInspectorText(value)}</button>`
-          : copyable(value);
-        return `<div class="comty-inspector-row"><span>${key}</span><div class="comty-inspector-value">${tokens?.length ? `<div class="comty-inspector-tokens">${tokens.map(token => copyable(token)).join("")}</div>` : ""}${valueButton}</div></div>`;
-      }).join("")}</div>${rows.length > 6 && selected ? `<button type="button" class="comty-inspector-expand">${inspectExpanded ? "Show less" : `Show ${rows.length - 6} more`}</button>` : ""}`;
-      for (const button of panel.querySelectorAll('.comty-inspector-picker[data-picker="color"]')) {
-        button.querySelector(".comty-inspector-swatch").style.backgroundColor = getComputedStyle(target)[button.dataset.property === "background" ? "backgroundColor" : "color"];
+      if (selected || draftPreview) panel.dataset.selected = "";
+      const priority = ["background", "color", "font-family", "font-size", "font-weight", "margin", "line-height", "letter-spacing"];
+      const orderedRows = [...rows.filter(([key]) => priority.includes(key)).sort((a, b) => priority.indexOf(a[0]) - priority.indexOf(b[0])), ...rows.filter(([key]) => !priority.includes(key))];
+      const labels = { "font-family": "Font", "font-size": "Size", "font-weight": "Weight", "line-height": "Line height", "letter-spacing": "Spacing", "background": "Background", "color": "Color", "margin": "Margin" };
+      const cssProperty = key => ({ radius: "border-radius", background: "background-color" })[key] || key;
+      const copyValue = (value, tokens) => tokens?.length ? `var(${tokens[0]})` : value;
+      const allProperties = `${selector} {\n${rows.map(([key, value, tokens]) => `  ${cssProperty(key)}: ${copyValue(value, tokens)};`).join("\n")}\n}`;
+      const copyButton = (value, label) => `<button type="button" class="comty-inspector-copy" data-copy="${escapeInspectorText(value)}" aria-label="${escapeInspectorText(label)}" title="${escapeInspectorText(label)}"><i class="comty-property-copy-icon" aria-hidden="true">${copyIcon}${checkIcon}</i></button>`;
+      panel.innerHTML = `<div class="comty-inspector-head"><span class="comty-inspector-selector" dir="rtl" title="${escapeInspectorText(selector)}"><bdi dir="ltr">${escapeInspectorText(selector)}</bdi></span>${copyButton(allProperties, "Copy all properties")}</div><div class="comty-inspector-details">${orderedRows.map(([key, value, tokens]) => {
+        const label = labels[key] || key.replaceAll("-", " ").replace(/^./, c => c.toUpperCase());
+        const isColor = key === "background" || key === "color";
+        const picker = isColor ? "color" : key.startsWith("font-") || ["line-height", "letter-spacing"].includes(key) ? "font" : "";
+        const displayValue = isColor ? colorDetails(value)?.hex || value : value;
+        const valueMarkup = `${isColor ? '<span class="comty-inspector-swatch" aria-hidden="true"></span>' : ""}<span class="comty-inspector-text">${tokens?.length ? `<span class="comty-inspector-tokens">${tokens.map(escapeInspectorText).join(", ")}</span><span class="comty-inspector-secondary">${escapeInspectorText(displayValue)}</span>` : escapeInspectorText(displayValue)}</span>`;
+        const valueElement = picker && selected
+          ? `<button type="button" class="comty-inspector-value comty-inspector-picker" data-picker="${picker}" data-property="${key}" aria-label="Open ${isColor ? key + " colour" : "typography"} details">${valueMarkup}</button>`
+          : `<span class="comty-inspector-value" data-property="${key}">${valueMarkup}</span>`;
+        return `<div class="comty-inspector-row"><span class="comty-inspector-label">${label}</span>${valueElement}${copyButton(tokens?.length ? tokens[0].replace(/^--/, "") : value, `Copy ${label}`)}</div>`;
+      }).join("")}</div><span class="comty-property-feedback" role="status"></span>`;
+      for (const swatch of panel.querySelectorAll('.comty-inspector-swatch')) {
+        const key = swatch.parentElement.dataset.property;
+        swatch.style.backgroundColor = rows.find(([name]) => name === key)?.[1];
       }
       panel.onclick = async (event) => {
         const button = event.target.closest("button");
         if (!button) return;
-        if (button.classList.contains("comty-inspector-expand")) {
-          inspectExpanded = !inspectExpanded;
-          renderInspector();
-        } else if (button.dataset.picker) {
-          openPropertyPanel(button.dataset.picker, target, button.dataset.property, button);
-        } else {
-          try {
-            await navigator.clipboard.writeText(button.dataset.copy);
-            button.title = "Copied";
-          } catch {
-            button.title = "Clipboard unavailable — select the value to copy";
-          }
-        }
+        if (button.dataset.picker) openPropertyPanel(button.dataset.picker, target, button.dataset.property, button);
+        else await copyPropertyValue(button, panel.querySelector(".comty-property-feedback"));
       };
       inspectionLayer.appendChild(panel);
       const bounds = panel.getBoundingClientRect();
@@ -1998,8 +1968,24 @@ export function initComty(options = {}) {
         }
         return;
       }
-      panel.style.left = `${Math.max(8, Math.min(rect.left + rect.width / 2 - bounds.width / 2, innerWidth - bounds.width - 8))}px`;
-      panel.style.top = `${Math.max(8, Math.min(rect.bottom + 4 + bounds.height <= innerHeight ? rect.bottom + 4 : rect.top - bounds.height - 4, innerHeight - bounds.height - 8))}px`;
+      const inset = 8, gap = 12;
+      const clampX = x => Math.max(inset, Math.min(x, innerWidth - bounds.width - inset));
+      const clampY = y => Math.max(inset, Math.min(y, innerHeight - bounds.height - inset));
+      const x = clampX(rect.left), y = clampY(rect.top);
+      const candidates = [
+        { left: x, top: rect.bottom + gap },
+        { left: rect.right + gap, top: y },
+        { left: rect.left - bounds.width - gap, top: y },
+        { left: x, top: rect.top - bounds.height - gap },
+      ];
+      let position = candidates.find(({ left, top }) => left >= inset && top >= inset && left + bounds.width <= innerWidth - inset && top + bounds.height <= innerHeight - inset);
+      if (!position) {
+        // A viewport-sized target leaves no outside space; minimize the covered area.
+        const overlap = ({ left, top }) => Math.max(0, Math.min(left + bounds.width, rect.right) - Math.max(left, rect.left)) * Math.max(0, Math.min(top + bounds.height, rect.bottom) - Math.max(top, rect.top));
+        position = candidates.map(({ left, top }) => ({ left: clampX(left), top: clampY(top) })).sort((a, b) => overlap(a) - overlap(b))[0];
+      }
+      panel.style.left = `${position.left}px`;
+      panel.style.top = `${position.top}px`;
     }
 
     function endSession() {
@@ -2014,13 +2000,6 @@ export function initComty(options = {}) {
       setSession("edit", { renderComments: true });
     }
 
-    function startAgentSession() {
-      if (!isLocalSite) return;
-      if (session.agent) return;
-      closeBubbles();
-      setSession("agent", { renderComments: true });
-    }
-
     function toggleSidepanel() {
       if (sidepanelOpen) {
         setSidepanelOpen(false);
@@ -2044,7 +2023,7 @@ export function initComty(options = {}) {
         showAuthPrompt();
         return;
       }
-      if (session.agent || session.inspect || !isSessionActive()) {
+      if (session.inspect || !isSessionActive()) {
         startEditSession();
         return;
       }
@@ -2395,15 +2374,6 @@ export function initComty(options = {}) {
       return element;
     }
 
-    async function waitForCommentTargetReady(comment) {
-      const el = resolveCommentElement(comment);
-      if (!el) return false;
-
-      await waitForCustomElements(el);
-      await waitForPaint();
-      return true;
-    }
-
     function getDeviceContext() {
       const width = window.innerWidth;
       const height = window.innerHeight;
@@ -2478,125 +2448,44 @@ export function initComty(options = {}) {
       if (!session.edit || hadDraft) hideInspector();
       document
         .querySelectorAll(
-          ".comty-bubble, .comty-create-bubble, .comty-temp-pin, .comty-popover",
+          ".comty-bubble:not([data-comty-capture-keep]), .comty-create-bubble, .comty-temp-pin, .comty-popover",
         )
         .forEach((x) => x.remove());
     }
 
-    const { waitForPaint, waitForCustomElements, captureViewportScreenshot } = createScreenshotCapture();
-
-    async function buildCommentScreenshotFormData(payload) {
-      const formData = new FormData();
-
-      Object.entries(payload).forEach(([key, value]) => {
-        if (value === undefined || value === null) return;
-        formData.append(key, String(value));
-      });
-
-      try {
-        await waitForCommentTargetReady(payload);
-        const screenshot = await captureViewportScreenshot();
-        if (screenshot) {
-          const extension =
-            screenshot.blob.type === "image/svg+xml"
-              ? "svg"
-              : screenshot.blob.type === "image/jpeg"
-                ? "jpg"
-                : screenshot.blob.type === "image/png"
-                  ? "png"
-                  : "webp";
-          formData.append(
-            "screenshot",
-            screenshot.blob,
-            `comment.${extension}`,
-          );
-          formData.append("screenshotWidth", String(screenshot.width));
-          formData.append("screenshotHeight", String(screenshot.height));
-        }
-      } catch (error) {
-        console.error("Comty: screenshot capture failed", error);
-      }
-
-      return formData;
-    }
+    const { captureViewportScreenshot } = createScreenshotCapture({ apiUrl, projectKey, getHeaders: getSdkHeaders });
 
-    async function uploadCommentScreenshot(
-      commentId,
-      payload,
-      captureNodes = [],
-    ) {
+    async function uploadCommentScreenshot(comment, context, point) {
       try {
-        const formData = await buildCommentScreenshotFormData({
-          projectKey,
-          host: window.location.host,
-          ...payload,
-        });
-
-        captureNodes.forEach((node) => node.remove());
-
-        if (!formData.has("screenshot")) return;
-
+        const screenshot = await captureViewportScreenshot({ context, annotation: () => mountCaptureAnnotation(comment, point) });
+        if (!screenshot) return;
+        const formData = new FormData();
+        formData.append("projectKey", projectKey);
+        formData.append("screenshot", screenshot.blob, screenshot.blob.type === "image/jpeg" ? "comment.jpg" : "comment.png");
+        formData.append("screenshotWidth", String(screenshot.width));
+        formData.append("screenshotHeight", String(screenshot.height));
         const response = await fetch(
-          `${apiUrl}/api/comments/${encodeURIComponent(commentId)}/screenshot`,
-          {
-            method: "POST",
-            headers: getSdkHeaders(),
-            body: formData,
-          },
+          `${apiUrl}/api/comments/${encodeURIComponent(comment.id)}/screenshot`,
+          { method: "POST", headers: getSdkHeaders(), body: formData },
         );
-
-        if (!response.ok) {
-          console.error(
-            "Comty: screenshot upload failed",
-            await response.text(),
-          );
-          return;
-        }
-
-        await loadComments({ force: true });
+        if (!response.ok) throw new Error(`Screenshot upload failed (${response.status})`);
+        // Updating metadata must not redraw the page or interrupt a new draft.
+        const { screenshotUrl } = await response.json();
+        const cached = cachedComments.find(item => String(item.id) === String(comment.id));
+        if (cached) Object.assign(cached, {
+          screenshot_url: screenshotUrl,
+          screenshot_width: screenshot.width,
+          screenshot_height: screenshot.height,
+        });
       } catch (error) {
-        console.error("Comty: screenshot upload failed", error);
-        captureNodes.forEach((node) => node.remove());
+        console.warn("Comty: comment saved, screenshot unavailable", error);
       }
     }
 
-    function createCaptureAnnotation(pin, bubble, content) {
-      const capturePin = pin.cloneNode(false);
-      capturePin.dataset.comtyCaptureKeep = "true";
-      capturePin.classList.add("comty-capture-annotation");
-      capturePin.classList.remove("comty-temp-pin");
-      capturePin.style.display = "grid";
-      capturePin.style.pointerEvents = "none";
-      capturePin.style.animation = "none";
-      capturePin.style.opacity = "1";
-      capturePin.style.transform = "translate(-50%, -50%)";
-      setPinIcon(capturePin, currentUser || { name: "You" });
-
-      const captureBubble = document.createElement("div");
-      captureBubble.className =
-        "comty-bubble comty-hover-bubble comty-capture-annotation";
-      captureBubble.dataset.comtyCaptureKeep = "true";
-      captureBubble.style.left = bubble.style.left;
-      captureBubble.style.top = bubble.style.top;
-      captureBubble.style.display = "block";
-      captureBubble.style.pointerEvents = "none";
-      captureBubble.style.animation = "none";
-      captureBubble.style.opacity = "1";
-      captureBubble.style.transform = "none";
-
-      const contentEl = document.createElement("div");
-      contentEl.className = "comty-bubble-content";
-      contentEl.innerText = content;
-      captureBubble.appendChild(contentEl);
-
-      document.body.appendChild(capturePin);
-      document.body.appendChild(captureBubble);
-      return [capturePin, captureBubble];
-    }
-
     function addLocalComment(commentId, payload) {
       const comment = {
         id: commentId,
+        pending: commentId.startsWith("pending-"),
         project_id: projectId,
         domain: payload.host || window.location.host,
         page_path: payload.pagePath || window.location.pathname,
@@ -2604,6 +2493,7 @@ export function initComty(options = {}) {
         rel_x: payload.relX,
         rel_y: payload.relY,
         content: payload.content || "",
+        link_url: payload.linkUrl || null,
         created_at: new Date().toISOString(),
         dom_element: payload.domElement || null,
         viewport: payload.viewport || null,
@@ -2615,7 +2505,9 @@ export function initComty(options = {}) {
         screenshot_width: null,
         screenshot_height: null,
         anchor_context: payload.anchorContext || null,
-        author_user_id: currentUser?.id || null,
+        author_user_id: currentUser?.isGuest ? null : currentUser?.id || null,
+        guest_author_id: currentUser?.isGuest ? currentUser.id : null,
+        guest_author_name: currentUser?.isGuest ? currentUser.name : null,
         author_name: currentUser?.name || null,
         author_avatar_url: currentUser?.avatarUrl || null,
         replies: [],
@@ -2630,6 +2522,7 @@ export function initComty(options = {}) {
       ];
       renderSidepanelComments();
       void renderComments(cachedComments, { retry: false });
+      return comment;
     }
 
     function getCommentAuthorName(comment) {
@@ -2639,8 +2532,7 @@ export function initComty(options = {}) {
     function isOwnCommentEntry(entry) {
       return Boolean(
         currentUser?.id &&
-        entry?.author_user_id &&
-        entry.author_user_id === currentUser.id,
+        (currentUser.isGuest ? entry?.guest_author_id : entry?.author_user_id) === currentUser.id,
       );
     }
 
@@ -2716,7 +2608,7 @@ export function initComty(options = {}) {
 
     function createThreadItem(
       entry,
-      { showMore = isOwnCommentEntry(entry) } = {},
+      { showMore = isOwnCommentEntry(entry), showLink = true } = {},
     ) {
       const item = document.createElement("div");
       item.className = "comty-thread-item";
@@ -2751,15 +2643,51 @@ export function initComty(options = {}) {
 
       const content = document.createElement("div");
       content.className = "comty-bubble-content";
-      content.innerText = entry?.content || "";
+      renderCommentContent(content, entry?.content || "");
 
       body.appendChild(author);
       body.appendChild(content);
+      if (showLink && entry?.link_url) body.appendChild(createCommentLink(entry.link_url));
       item.appendChild(body);
 
       return { item, body, content, moreButton };
     }
 
+    function renderCommentContent(element, value) {
+      const content = String(value ?? "");
+      const nodes = [];
+      let previousEnd = 0;
+      for (const match of content.matchAll(/https?:\/\/[^\s<>"']+/gi)) {
+        const url = match[0].replace(/[.,!?;:]+$/, "");
+        if (!url) continue;
+        let parsed;
+        try { parsed = new URL(url); } catch { continue; }
+        if (!["http:", "https:"].includes(parsed.protocol) || !parsed.hostname) continue;
+        nodes.push(document.createTextNode(content.slice(previousEnd, match.index)));
+        const link = document.createElement("a");
+        link.href = url;
+        link.target = "_blank";
+        link.rel = "noopener noreferrer";
+        link.textContent = url;
+        nodes.push(link);
+        previousEnd = match.index + url.length;
+      }
+      nodes.push(document.createTextNode(content.slice(previousEnd)));
+      element.replaceChildren(...nodes);
+    }
+
+    function createCommentLink(url) {
+      const link = document.createElement("a");
+      link.className = "comty-comment-link";
+      link.href = url;
+      link.target = "_blank";
+      link.rel = "noopener noreferrer";
+      link.title = url;
+      link.setAttribute("aria-label", `Open attached link: ${url}`);
+      link.textContent = url;
+      return link;
+    }
+
     function setPinIcon(pin, comment = null) {
       if (comment) {
         pin.classList.add("comty-pin-with-avatar");
@@ -2776,6 +2704,54 @@ export function initComty(options = {}) {
       `;
     }
 
+    function createCommentPin(comment, x, y) {
+      const pin = document.createElement("button");
+      pin.className = "comty-pin";
+      pin.type = "button";
+      pin.style.left = `${x}px`;
+      pin.style.top = `${y}px`;
+      setPinIcon(pin, comment);
+      const statusDot = document.createElement("span");
+      statusDot.className = "comty-pin-status-dot";
+      applyStatusDot(statusDot, comment.status);
+      pin.appendChild(statusDot);
+      return pin;
+    }
+
+    function createCommentPreview(comment) {
+      const bubble = document.createElement("div");
+      bubble.className = "comty-bubble comty-hover-bubble";
+      const thread = document.createElement("div");
+      thread.className = "comty-thread";
+      thread.appendChild(createThreadItem(comment, { showMore: false, showLink: false }).item);
+      bubble.appendChild(thread);
+      return bubble;
+    }
+
+    function mountCaptureAnnotation(comment, { x, y }) {
+      const host = document.createElement("div");
+      host.dataset.comtyCaptureExclude = "";
+      host.setAttribute("aria-hidden", "true");
+      host.inert = true;
+      // Ancestor opacity hides measurement without changing the components'
+      // computed opacity. Nothing flashes or intercepts input during cloning.
+      Object.assign(host.style, { position: "fixed", inset: "0", opacity: "0", pointerEvents: "none" });
+      const pin = createCommentPin(comment, x, y);
+      const bubble = createCommentPreview(comment);
+      for (const element of [pin, bubble]) {
+        element.dataset.comtyCaptureKeep = "";
+        element.style.setProperty("animation", "none", "important");
+        element.style.setProperty("transition", "none", "important");
+        element.style.setProperty("pointer-events", "none", "important");
+      }
+      pin.style.display = "grid";
+      bubble.style.display = "block";
+      host.append(pin, bubble);
+      root.appendChild(host);
+      positionCommentBubble(bubble, x, y);
+      return { elements: [pin, bubble], dispose: () => host.remove() };
+    }
+
     function createCommentAuthor(comment) {
       const author = document.createElement("div");
       author.className = "comty-comment-author";
@@ -2819,74 +2795,126 @@ export function initComty(options = {}) {
 
       const textarea = document.createElement("textarea");
       textarea.className = "comty-create-textarea";
-      textarea.placeholder = payload.kind === "agent" ? "Describe the change for your agent" : "Add a comment";
+      textarea.placeholder = "Add a comment";
       textarea.setAttribute("aria-label", textarea.placeholder);
       textarea.rows = 1;
 
       const actions = document.createElement("div");
       actions.className = "comty-create-actions";
 
+      const linkBtn = document.createElement("button");
+      linkBtn.type = "button";
+      linkBtn.className = "comty-create-link-button";
+      linkBtn.setAttribute("aria-label", "Add link");
+      linkBtn.innerHTML = `
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+          <path d="M10 13a5 5 0 0 0 7.07 0l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/>
+          <path d="M14 11a5 5 0 0 0-7.07 0l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/>
+        </svg>
+      `;
+
+      const linkEditor = document.createElement("div");
+      linkEditor.className = "comty-create-link-editor";
+      linkEditor.inert = true;
+      linkEditor.setAttribute("aria-hidden", "true");
+      const linkInput = document.createElement("input");
+      linkInput.type = "url";
+      linkInput.placeholder = "Paste a link";
+      linkInput.setAttribute("aria-label", "Link URL");
+      const linkInsert = document.createElement("button");
+      linkInsert.type = "button";
+      linkInsert.textContent = "Add";
+      const linkCancel = document.createElement("button");
+      linkCancel.type = "button";
+      linkCancel.setAttribute("aria-label", "Cancel link");
+      linkCancel.textContent = "×";
+      const linkField = document.createElement("div");
+      linkField.className = "comty-create-link-field";
+      linkField.append(linkInput, linkCancel);
+      linkEditor.append(linkField, linkInsert);
+
+      const attachment = document.createElement("div");
+      attachment.className = "comty-create-attachment";
+      const attachmentLink = document.createElement("a");
+      attachmentLink.className = "comty-comment-link";
+      attachmentLink.target = "_blank";
+      attachmentLink.rel = "noopener noreferrer";
+      const removeAttachment = document.createElement("button");
+      removeAttachment.type = "button";
+      removeAttachment.setAttribute("aria-label", "Remove attached link");
+      removeAttachment.textContent = "×";
+      const attachmentChip = document.createElement("div");
+      attachmentChip.className = "comty-create-attachment-chip";
+      attachmentChip.append(attachmentLink, removeAttachment);
+      attachment.appendChild(attachmentChip);
+      let attachedLink = "";
+
       const submitBtn = document.createElement("button");
+      submitBtn.type = "button";
       submitBtn.className = "comty-btn-submit";
-      submitBtn.setAttribute("aria-label", payload.kind === "agent" ? "Send agent task" : "Post comment");
+      submitBtn.setAttribute("aria-label", "Post comment");
+      submitBtn.disabled = true;
       submitBtn.innerHTML = `
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
           <path d="M12 19V5M5 12l7-7 7 7"/>
         </svg>
       `;
 
+      const editorDraft = draftAnchor;
       const submit = async () => {
         const content = textarea.value.trim();
-        if (!content) return;
+        if (!content || textarea.disabled) return;
 
         submitBtn.disabled = true;
         textarea.disabled = true;
+        linkBtn.disabled = true;
 
-        if (payload.kind === "agent" && !agent) {
-          showAgentBridgeError(); submitBtn.disabled = false; textarea.disabled = false; return;
-        }
         payload.content = content;
+        payload.linkUrl = attachedLink || null;
         textarea.textContent = content;
 
+        const context = captureContext();
+        const point = getPinPoint(pin);
+        const pendingId = `pending-${crypto.randomUUID()}`;
+        // Paint the comment immediately. The network save never waits for capture work.
+        bubble.remove();
+        pin.remove();
+        if (draftAnchor === editorDraft) draftAnchor = null;
+        hideInspector();
+        addLocalComment(pendingId, payload);
         let post;
         try {
-          post = await fetch(payload.kind === "agent" ? `${agentBridgeUrl}/tasks` : `${apiUrl}/api/comments`, {
+          post = await fetch(`${apiUrl}/api/comments`, {
             method: "POST",
-            headers: payload.kind === "agent" ? agentHeaders() : getSdkHeaders({ "Content-Type": "application/json" }),
-            body: JSON.stringify(payload.kind === "agent" ? { ...payload, projectKey } : payload),
+            headers: getSdkHeaders({ "Content-Type": "application/json" }),
+            body: JSON.stringify(payload),
           });
+          if (!post.ok) throw new Error(`Comment save failed (${post.status})`);
+          const data = await post.json();
+          if (!data?.id) throw new Error("Comment save returned no ID");
+          cachedComments = cachedComments.filter(item => String(item.id) !== pendingId);
+          if (context.url === location.href) {
+            const comment = addLocalComment(String(data.id), payload);
+            // Start only after the save and immediate UI update; the capture yields to input.
+            void uploadCommentScreenshot(comment, context, point);
+          } else void loadComments({ force: true });
         } catch (error) {
           console.error("Comty: save failed", error);
-          if (payload.kind === "agent") showAgentBridgeError();
-          submitBtn.disabled = false;
-          textarea.disabled = false;
-          return;
-        }
-
-        if (!post.ok) {
-          console.error("Comty: save failed", await post.text());
-          if (payload.kind === "agent") showAgentBridgeError();
+          cachedComments = cachedComments.filter(item => String(item.id) !== pendingId);
+          renderSidepanelComments();
+          void renderComments(cachedComments, { retry: false });
+          // Keep the original editor and its text available for retry, including attachments.
+          if (!draftAnchor) draftAnchor = editorDraft;
+          root.append(pin, bubble);
           submitBtn.disabled = false;
           textarea.disabled = false;
-          return;
-        }
-
-        const data = await post.json();
-        const commentId = payload.kind === "agent" ? data?.task?.id : data?.id;
-        const captureNodes = commentId && payload.kind !== "agent"
-          ? createCaptureAnnotation(pin, bubble, content)
-          : [];
-        bubble.remove();
-        pin.remove();
-        draftAnchor = null;
-        hideInspector();
-        if (commentId) {
-          if (payload.kind === "agent") showAgentTaskToast(String(commentId));
-          else addLocalComment(String(commentId), payload);
-          void loadComments({ force: true });
-          if (payload.kind !== "agent") void uploadCommentScreenshot(String(commentId), payload, captureNodes);
-        } else {
-          void loadComments({ force: true });
+          linkBtn.disabled = false;
+          const errorMessage = document.createElement("p");
+          errorMessage.setAttribute("role", "alert");
+          errorMessage.textContent = "Comment not saved. Your draft is ready to retry.";
+          bubble.querySelector('[role="alert"]')?.remove();
+          bubble.append(errorMessage);
+          if (bubble.isConnected) textarea.focus();
         }
       };
 
@@ -2895,8 +2923,63 @@ export function initComty(options = {}) {
         submit();
       };
 
+      const closeLinkEditor = () => {
+        bubble.classList.remove("comty-create-link-open");
+        linkEditor.inert = true;
+        linkEditor.setAttribute("aria-hidden", "true");
+        linkInput.value = "";
+        linkInput.removeAttribute("aria-invalid");
+        linkInput.setCustomValidity("");
+        textarea.focus();
+      };
+      linkBtn.onclick = () => {
+        if (!bubble.classList.contains("comty-create-expanded")) return;
+        bubble.classList.add("comty-create-link-open");
+        linkEditor.inert = false;
+        linkEditor.setAttribute("aria-hidden", "false");
+        linkInput.focus();
+      };
+      linkCancel.onclick = closeLinkEditor;
+      linkInput.oninput = () => {
+        linkInput.removeAttribute("aria-invalid");
+        linkInput.setCustomValidity("");
+      };
+      linkInput.onkeydown = (event) => {
+        if (event.key === "Enter") { event.preventDefault(); linkInsert.click(); }
+        if (event.key === "Escape") { event.preventDefault(); closeLinkEditor(); }
+      };
+      linkInsert.onclick = () => {
+        const value = linkInput.value.trim();
+        const candidate = /^[a-z][a-z0-9+.-]*:/i.test(value) ? value : `https://${value}`;
+        let url;
+        try { url = new URL(candidate); } catch { /* Report below. */ }
+        if (!url || !["http:", "https:"].includes(url.protocol) || !url.hostname || url.username || url.password || /\s/.test(value) || String(url).length > 2048) {
+          linkInput.setAttribute("aria-invalid", "true");
+          linkInput.setCustomValidity("Enter a valid HTTP(S) URL.");
+          linkInput.reportValidity();
+          linkInput.focus();
+          return;
+        }
+        attachedLink = String(url);
+        attachmentLink.href = attachedLink;
+        attachmentLink.title = attachedLink;
+        attachmentLink.textContent = attachedLink;
+        bubble.classList.add("comty-create-has-attachment");
+        closeLinkEditor();
+        const point = getPinPoint(pin);
+        positionCommentBubble(bubble, point.x, point.y);
+        renderInspector();
+      };
+
+      removeAttachment.onclick = () => {
+        attachedLink = "";
+        bubble.classList.remove("comty-create-has-attachment");
+        textarea.focus();
+        textarea.oninput();
+      };
+
       textarea.onkeydown = (e) => {
-        if (e.key === "Enter" && !e.shiftKey) {
+        if (e.key === "Enter" && !e.shiftKey && !e.isComposing) {
           e.preventDefault();
           submit();
         }
@@ -2907,31 +2990,20 @@ export function initComty(options = {}) {
       };
 
       textarea.oninput = () => {
-        textarea.style.height = "24px";
-        const scrollHeight = textarea.scrollHeight;
-        textarea.style.height = scrollHeight + "px";
-
-        if (scrollHeight > 24) {
-          bubble.style.borderRadius = "16px";
-          bubble.style.alignItems = "flex-end";
-        } else {
-          bubble.style.borderRadius = "999px";
-          bubble.style.alignItems = "center";
-        }
-
-        if (textarea.value.trim().length > 0) {
-          submitBtn.classList.add("comty-btn-active");
-        } else {
-          submitBtn.classList.remove("comty-btn-active");
-        }
+        const expanded = textarea.value.length > 0 || Boolean(attachedLink);
+        bubble.classList.toggle("comty-create-expanded", expanded);
+        if (!expanded && bubble.classList.contains("comty-create-link-open")) closeLinkEditor();
+        submitBtn.disabled = !textarea.value.trim();
+        submitBtn.classList.toggle("comty-btn-active", !submitBtn.disabled);
         const point = getPinPoint(pin);
         positionCommentBubble(bubble, point.x, point.y);
         renderInspector();
       };
 
-      actions.appendChild(submitBtn);
+      actions.append(linkBtn, submitBtn, linkEditor);
 
       bubble.appendChild(textarea);
+      bubble.appendChild(attachment);
       bubble.appendChild(actions);
 
       root.appendChild(bubble);
@@ -2941,223 +3013,6 @@ export function initComty(options = {}) {
       setTimeout(() => textarea.focus(), 10);
     }
 
-    function agentHeaders() { return { "Content-Type": "application/json", "X-Comty-Token": agent?.token || "" }; }
-
-    function showAgentBridgeError(message = "Start your app with comty dev to use the local agent. Check the terminal if it is already running.") {
-      root.querySelectorAll(".comty-agent-task-toast").forEach((node) => node.remove());
-      const toast = document.createElement("div");
-      toast.className = "comty-auth-toast comty-agent-task-toast";
-      toast.setAttribute("role", "alert");
-      const issue = describeAgentError(message);
-      toast.textContent = issue.title + ". " + issue.description;
-      root.appendChild(toast);
-      setTimeout(() => toast.remove(), 5000);
-    }
-
-    function showAgentTaskToast() {
-      agentPanelOpen = true;
-      agentPanelSignature = "";
-      renderAgentPanel();
-    }
-
-    function describeAgentError(error) {
-      const raw = typeof error === 'string' ? error : JSON.stringify(error, null, 2) || 'Unknown error';
-      let value = error;
-      for (let depth = 0; depth < 8; depth++) {
-        if (typeof value === 'string') {
-          try { value = JSON.parse(value); continue; } catch {}
-          const start = value.indexOf('{'), end = value.lastIndexOf('}');
-          if (start >= 0 && end > start) { try { value = JSON.parse(value.slice(start, end + 1)); continue; } catch {} }
-          break;
-        }
-        if (!value || typeof value !== 'object') break;
-        value = value.error || value.message || value.cause || value.stderr || value;
-      }
-      const message = typeof value === 'string' ? value : '';
-      const source = raw + ' ' + message;
-      const agentName = /codex/i.test(source) ? 'Codex' : /claude/i.test(source) ? 'Claude Code' : /cursor/i.test(source) ? 'Cursor' : 'your coding agent';
-      let title, description;
-      if (/requires a newer version|upgrade.*latest|outdated|unsupported.*version/i.test(source)) {
-        title = 'Agent update required'; description = `Update ${agentName}, restart your local development session, then retry this task.`;
-      } else if (/insufficient_quota|quota exceeded|credit balance|billing|usage limit/i.test(source)) {
-        title = 'Usage limit reached'; description = 'Check your agent account’s usage allowance or billing, then retry when capacity is available.';
-      } else if (/rate.?limit|too many requests|\b429\b/i.test(source)) {
-        title = 'Too many requests'; description = 'The agent is temporarily rate limited. Wait a moment before retrying.';
-      } else if (/unauthorized|unauthenticated|authentication|not logged|sign.?in|log.?in|invalid.api.key|\b401\b/i.test(source)) {
-        title = 'Sign in to your agent'; description = `Open ${agentName} and sign in again, then retry this task.`;
-      } else if (/model.*(?:not found|does not exist|unavailable|not supported)|unsupported model|model_not_found/i.test(source)) {
-        title = 'Model unavailable'; description = 'Choose a model available to your agent account in the local Comty configuration, then restart and retry.';
-      } else if (/disconnected|ECONNREFUSED|ENOTFOUND|network|failed to fetch|development server stopped/i.test(source)) {
-        title = 'Connection lost'; description = 'Check that your local development server and coding agent are running. Reconnect before retrying; your task history is kept.';
-      } else if (/timed? ?out|timeout|exceeded.*minutes/i.test(source)) {
-        title = 'Task timed out'; description = 'Review any changes already made, then retry with a smaller, more specific request.';
-      } else if (/permission|denied|forbidden|\b403\b/i.test(source)) {
-        title = 'Permission needed'; description = 'Check the agent’s access to this project and any pending approval before retrying.';
-      } else if (/ENOENT|command not found|not installed|executable.*not found/i.test(source)) {
-        title = 'Agent not found'; description = `Install or configure ${agentName} in your local development environment, then restart and retry.`;
-      } else if (/completion was not verified/i.test(source)) {
-        title = 'Result needs checking'; description = 'The agent could not confirm completion. Review the changes before retrying.';
-      } else {
-        title = 'Task could not finish';
-        description = message && !/[{}]|\[object Object\]/.test(message) ? message.slice(0, 300) : 'The agent reported an unexpected error. Review the technical details and any changes before retrying.';
-      }
-      return { title, description, raw, message };
-    }
-
-    function renderAgentPanel() {
-      if (!agent) return;
-      let panel = root.querySelector(".comty-agent-panel");
-      if (!panel) {
-        panel = document.createElement("section");
-        panel.className = "comty-agent-panel";
-        panel.setAttribute("aria-label", "Local agent tasks");
-        panel.hidden = true;
-        // Keep the dock above inspection overlays and below the toolbar.
-        root.insertBefore(panel, toolbar);
-      }
-      const open = session.agent && agentPanelOpen;
-      if (open) {
-        if (panel.hidden) {
-          const rect = toolbar.getBoundingClientRect();
-          panel.dataset.side = rect.left + rect.width / 2 < innerWidth / 2 ? "left" : "right";
-          document.documentElement.dataset.comtyAgentSide = panel.dataset.side;
-          panel.dataset.closed = "";
-          panel.hidden = false;
-          panel.getBoundingClientRect();
-        }
-        if (panel.hasAttribute("data-closed")) { agentPanelTransition++; delete panel.dataset.closed; }
-      } else if (!panel.hidden && !panel.hasAttribute("data-closed")) {
-        const transition = ++agentPanelTransition;
-        panel.dataset.closed = "";
-        const finish = () => { if (transition === agentPanelTransition && panel.hasAttribute("data-closed")) panel.hidden = true; };
-        if (reducedMotion.matches) finish();
-        else setTimeout(finish, parseFloat(getComputedStyle(root).getPropertyValue("--comty-motion-duration")));
-      }
-      panel.inert = !open;
-      panel.setAttribute("aria-hidden", String(!open));
-      document.documentElement.classList.toggle("comty-agent-docked", open);
-      agentHistoryBtn?.setAttribute("aria-expanded", String(open));
-      agentHistoryBtn?.setAttribute("aria-pressed", String(open));
-      const signature = JSON.stringify([localTasks, localApprovals, agentConnectionError, agentActionError, agentPanelOpen]);
-      if (signature === agentPanelSignature) return;
-      agentPanelSignature = signature;
-      root.querySelector('.comty-agent-error-popover')?.remove();
-      const expanded = new Set([...panel.querySelectorAll('details[data-detail-key][open]')].map(node => node.dataset.detailKey));
-      const focusKey = panel.contains(document.activeElement) ? document.activeElement.dataset.focusKey : null;
-      const scrollTop = panel.querySelector('.comty-agent-panel-content')?.scrollTop || 0;
-      const node = (tag, className, text) => {
-        const element = document.createElement(tag);
-        if (className) element.className = className;
-        if (text != null) element.textContent = text;
-        return element;
-      };
-      const codeIcon = '<path d="m8 6-6 6 6 6m8-12 6 6-6 6m-3-15-2 18"/>';
-      const brand = () => { const element = node('span', 'comty-agent-brand'); element.innerHTML = icon(codeIcon); element.setAttribute('aria-hidden', 'true'); return element; };
-      panel.replaceChildren();
-      const header = node('header', 'comty-agent-panel-header');
-      const heading = node('div', 'comty-agent-heading');
-      heading.append(node('strong', '', 'Modifications'));
-      const toggle = node('button', 'comty-agent-action comty-agent-close'); toggle.type = 'button';
-      toggle.innerHTML = icon('<path d="m6 6 12 12M6 18 18 6"/>');
-      toggle.setAttribute('aria-label', 'Close local agent sidebar'); toggle.title = 'Close sidebar'; toggle.dataset.focusKey = 'close';
-      toggle.onclick = () => { agentPanelOpen = false; renderAgentPanel(); agentHistoryBtn?.focus({ preventScroll: true }); };
-      header.append(heading, toggle); panel.appendChild(header);
-      const content = node('div', 'comty-agent-panel-content'); panel.appendChild(content);
-      const technicalDetails = (parent, raw, key) => {
-        const details = node('details', 'comty-agent-details'); details.dataset.detailKey = key; details.open = expanded.has(key);
-        const summary = node('summary', '', 'Technical details'); summary.dataset.focusKey = 'details-' + key;
-        details.append(summary, node('pre', '', raw)); parent.appendChild(details);
-      };
-      const errorMessage = (parent, error, key) => {
-        const issue = describeAgentError(error);
-        const message = node('div', 'comty-agent-error');
-        message.append(node('strong', '', issue.title), node('p', '', issue.description));
-        parent.appendChild(message); technicalDetails(parent, issue.raw, key);
-      };
-      if (agentConnectionError || agentActionError) {
-        const banner = node('div', 'comty-agent-item comty-agent-banner'); banner.setAttribute('role', 'alert');
-        errorMessage(banner, agentConnectionError || agentActionError, 'connection'); content.appendChild(banner);
-      }
-      const action = (parent, label, path, input = {}, primary = false) => {
-        const button = node('button', 'comty-agent-action', label); button.type = 'button';
-        const key = path + JSON.stringify(input); button.dataset.focusKey = key;
-        button.disabled = agentPendingActions.has(key);
-        if (primary) button.dataset.primary = '';
-        button.onclick = async () => {
-          if (agentPendingActions.has(key)) return;
-          agentActionError = '';
-          agentPendingActions.add(key); button.disabled = true; button.textContent = 'Please wait…';
-          try {
-            const response = await fetch(`${agentBridgeUrl}/${path}`, { method: 'POST', headers: agentHeaders(), body: JSON.stringify(input) });
-            if (!response.ok) {
-              const body = await response.json().catch(() => null);
-              throw new Error(typeof body?.error === 'string' ? body.error : JSON.stringify(body?.error || { status: response.status, message: 'Request failed' }));
-            }
-            await loadComments({ force: true });
-          } catch (error) { agentActionError = error.message; }
-          finally { agentPendingActions.delete(key); agentPanelSignature = ''; renderAgentPanel(); }
-        };
-        parent.appendChild(button);
-      };
-      for (const approval of localApprovals) {
-        const section = node('div', 'comty-agent-item');
-        section.append(node('h3', '', 'Approval required'));
-        const task = localTasks.find(task => task.id === approval.taskId);
-        if (task) section.appendChild(node('p', '', task.content));
-        section.appendChild(node('p', '', 'Review this operation before allowing the agent to continue.'));
-        const operation = approval.details?.command || approval.details?.file_path || approval.details?.path;
-        if (typeof operation === 'string' || Array.isArray(operation)) section.appendChild(node('pre', '', Array.isArray(operation) ? operation.join(' ') : operation));
-        technicalDetails(section, JSON.stringify(approval.details ?? {}, null, 2), 'approval-' + approval.id);
-        const actions = node('div', 'comty-agent-actions');
-        action(actions, 'Allow once', `approvals/${approval.id}`, { allow: true }, true);
-        action(actions, 'Deny', `approvals/${approval.id}`, { allow: false });
-        section.appendChild(actions); content.appendChild(section);
-      }
-      const list = node('div', 'comty-agent-list'); content.appendChild(list);
-      const hideErrorPopover = () => root.querySelector('.comty-agent-error-popover')?.remove();
-      content.addEventListener('scroll', hideErrorPopover, { passive: true });
-      for (const [index, task] of [...localTasks].reverse().entries()) {
-        const failed = Boolean(task.error) || task.status === 'in_review';
-        const state = failed ? 'error' : task.status === 'done' ? 'success' : task.status === 'cancel' ? 'cancel' : 'working';
-        const row = node('div', 'comty-agent-row'); row.dataset.taskId = task.id;
-        const dot = state === 'working' ? createWorkingIndicator() : node('span', 'comty-agent-dot');
-        dot.dataset.status = state; dot.setAttribute('aria-hidden', 'true');
-        const name = node('span', 'comty-agent-row-name', task.content);
-        row.append(dot, name);
-        if (state === 'working') row.appendChild(node('span', 'comty-agent-row-state', task.status === 'todo' ? 'Starting' : 'Working'));
-        const actions = node('div', 'comty-agent-row-actions');
-        if (['in_review', 'cancel'].includes(task.status)) action(actions, 'Retry', `tasks/${task.id}/retry`);
-        if (['todo', 'in_progress'].includes(task.status)) action(actions, 'Cancel', `tasks/${task.id}/cancel`);
-        if (actions.childElementCount) row.appendChild(actions);
-        row.setAttribute('aria-label', `${task.content}, ${state === 'error' ? 'failed' : state === 'success' ? 'completed' : state === 'cancel' ? 'cancelled' : task.status === 'todo' ? 'starting' : 'working'}`);
-        if (failed) {
-          const tooltipId = `comty-agent-error-${index}`;
-          const showErrorPopover = () => {
-            hideErrorPopover();
-            const issue = describeAgentError(task.error || task.result?.summary || task.progress || 'Completion was not verified');
-            const popover = node('div', 'comty-agent-error-popover'); popover.id = tooltipId; popover.setAttribute('role', 'tooltip');
-            popover.append(node('strong', '', task.content), node('p', '', issue.message || issue.description));
-            root.appendChild(popover);
-            const rowRect = row.getBoundingClientRect();
-            const popoverRect = popover.getBoundingClientRect();
-            const left = panel.dataset.side === 'right' ? rowRect.left - popoverRect.width - 8 : rowRect.right + 8;
-            popover.style.left = `${Math.max(8, Math.min(left, innerWidth - popoverRect.width - 8))}px`;
-            popover.style.top = `${Math.max(8, Math.min(rowRect.top - 4, innerHeight - popoverRect.height - 8))}px`;
-          };
-          row.addEventListener('mouseenter', showErrorPopover);
-          row.addEventListener('mouseleave', hideErrorPopover);
-        }
-        list.appendChild(row);
-      }
-      if (!localTasks.length && !localApprovals.length) {
-        const empty = node('div', 'comty-agent-empty');
-        empty.append(brand(), node('strong', '', localTasks.length ? 'All caught up' : 'What shall we change?'), node('p', '', 'Point at an element on the page and describe the change you want.'));
-        content.appendChild(empty);
-      }
-      content.scrollTop = scrollTop;
-      if (focusKey && open) [...panel.querySelectorAll('[data-focus-key]')].find(element => element.dataset.focusKey === focusKey)?.focus({ preventScroll: true });
-    }
-
     function setSidepanelOpen(open) {
       sidepanelOpen = open;
       sidepanel.classList.toggle("comty-sidepanel-open", sidepanelOpen);
@@ -3211,7 +3066,6 @@ export function initComty(options = {}) {
           ? sidepanelSearch.value.trim().toLowerCase()
           : "";
       let list = cachedComments.filter((comment) => {
-        if (comment.local_agent || comment.kind === "agent") return false;
         if (
           search &&
           !`${comment.content ?? ""} ${getCommentLabel(comment)}`
@@ -3258,6 +3112,7 @@ export function initComty(options = {}) {
         const item = document.createElement("button");
         item.type = "button";
         item.className = "comty-sidepanel-item";
+        item.disabled = Boolean(comment.pending);
         item.innerHTML = `
         <span class="comty-sidepanel-item-status" aria-hidden="true"></span>
         <span class="comty-sidepanel-item-body">
@@ -3278,7 +3133,7 @@ export function initComty(options = {}) {
 
         const metaEl = item.querySelector(".comty-sidepanel-item-meta");
         if (metaEl instanceof HTMLElement) {
-          metaEl.innerText = `${comment.author_name || "Anonymous"} · ${getCommentLabel(comment)}`;
+          metaEl.innerText = `${comment.author_name || "Anonymous"} · ${comment.pending ? "Sending…" : getCommentLabel(comment)}`;
           metaEl.title = getCommentLabel(comment);
         }
 
@@ -3397,15 +3252,14 @@ export function initComty(options = {}) {
     createStatusFilters();
 
     async function updateCommentStatus(comment, status) {
-      if (comment?.local_agent || !projectId || !comment?.id) return false;
+      if (!projectId || !comment?.id) return false;
 
       let res;
       try {
-        const local = comment.local_agent === true;
-        res = await fetch(local ? `${agentBridgeUrl}/tasks/${encodeURIComponent(comment.id)}/status` : `${apiUrl}/api/comments/${comment.id}/status`, {
+        res = await fetch(`${apiUrl}/api/comments/${comment.id}/status`, {
           method: "POST",
-          headers: local ? { "Content-Type": "application/json" } : getSdkHeaders({ "Content-Type": "application/json" }),
-          body: JSON.stringify(local ? { status } : {
+          headers: getSdkHeaders({ "Content-Type": "application/json" }),
+          body: JSON.stringify({
             projectKey,
             host: window.location.host,
             status,
@@ -3422,7 +3276,7 @@ export function initComty(options = {}) {
       }
 
       const data = await res.json();
-      comment.status = getCommentStatus(data.task?.status ?? data.status).value;
+      comment.status = getCommentStatus(data.status).value;
       return comment.status;
     }
 
@@ -3610,11 +3464,13 @@ export function initComty(options = {}) {
     const openCommentThread = createCommentThread({
       root, apiUrl, projectKey, commentStatuses, selectedStatusFilters, placedPins,
       closeBubbles, getCommentStatus, updateCommentStatus, applyStatusDot,
-      renderSidepanelComments, applyStatusFilters, loadComments, createThreadItem,
+      renderSidepanelComments, applyStatusFilters, createThreadItem, renderCommentContent,
       isOwnCommentEntry, updateCommentContent, deleteSdkComment, getCommentId,
       updateReplyContent, deleteSdkReply, createCommentAvatar, getSdkHeaders,
       showAuthPrompt,
       get canWrite() { return canWrite; },
+      get canManage() { return canManage; },
+      get allowGuestComments() { return allowGuestComments; },
       get currentUser() { return currentUser; },
       get cachedComments() { return cachedComments; },
       set cachedComments(value) { cachedComments = value; },
@@ -3664,20 +3520,11 @@ export function initComty(options = {}) {
       const x = visibility.clientX;
       const y = visibility.clientY;
 
-      const pin = document.createElement("button");
-      pin.className = "comty-pin";
-      pin.type = "button";
+      const pin = createCommentPin(comment, x, y);
+      pin.disabled = Boolean(comment.pending);
       pin.dataset.status = getCommentStatus(comment.status).value;
-      if (comment.id) {
-        pin.dataset.commentId = String(comment.id);
-      }
-      pin.style.left = `${x}px`;
-      pin.style.top = `${y}px`;
-      setPinIcon(pin, comment);
-      const pinStatusDot = document.createElement("span");
-      pinStatusDot.className = "comty-pin-status-dot";
-      applyStatusDot(pinStatusDot, comment.status);
-      pin.appendChild(pinStatusDot);
+      if (comment.id) pin.dataset.commentId = String(comment.id);
+      const pinStatusDot = pin.querySelector(".comty-pin-status-dot");
       pin.setAttribute(
         "aria-label",
         `Afficher le commentaire, statut ${getCommentStatus(comment.status).label}`,
@@ -3719,32 +3566,14 @@ export function initComty(options = {}) {
           activeHoverCommentIds.add(commentId);
         }
 
-        const hoverBubble = document.createElement("div");
-        hoverBubble.className = "comty-bubble comty-hover-bubble";
+        const hoverBubble = createCommentPreview(comment);
         hoverBubble.style.left = `${x + 32}px`;
         hoverBubble.style.top = `${y - 17}px`;
-        hoverBubble.style.pointerEvents = "none";
         hoverBubble.dataset.hoverId = commentId;
 
-        const hoverThread = document.createElement("div");
-        hoverThread.className = "comty-thread";
-        const hoverItem = createThreadItem(comment, { showMore: false });
-        hoverThread.appendChild(hoverItem.item);
-        hoverBubble.appendChild(hoverThread);
-
         root.appendChild(hoverBubble);
 
-        requestAnimationFrame(() => {
-          if (x + 16 + hoverBubble.offsetWidth > window.innerWidth) {
-            hoverBubble.style.left = `${x - hoverBubble.offsetWidth - 24}px`;
-            hoverBubble.classList.add("comty-bubble-left");
-          }
-
-          const rect = hoverBubble.getBoundingClientRect();
-          if (rect.bottom > window.innerHeight) {
-            hoverBubble.style.top = `${y - rect.height - 16}px`;
-          }
-        });
+        requestAnimationFrame(() => positionCommentBubble(hoverBubble, x, y));
       };
 
       pin.onmouseleave = () => {
@@ -3839,12 +3668,15 @@ export function initComty(options = {}) {
     function reconcileComments(comments) {
       const previous = new Map(cachedComments.map(comment => [String(comment.id), comment]));
       cachedComments = comments
-        .filter(comment => comment.kind !== "agent" || comment.status !== "done")
+        .filter(comment => comment.kind !== "agent" && !comment.local_agent)
         .map(comment => Object.assign(previous.get(String(comment.id)) || {}, comment));
+      for (const comment of previous.values()) {
+        if (comment.pending && !cachedComments.some(item => item.id === comment.id)) cachedComments.push(comment);
+      }
     }
 
     async function loadComments({ force = false } = {}) {
-      if (!projectId && !agent) return;
+      if (!projectId) return;
       const pagePath = window.location.pathname;
       if (!force && cachedPagePath === pagePath) { await renderComments(cachedComments); return; }
       if (pendingCommentsLoad) {
@@ -3852,7 +3684,7 @@ export function initComty(options = {}) {
         if (!force) return;
       }
       pendingCommentsLoad = (async () => {
-        let comments = cachedPagePath === pagePath ? cachedComments.filter(comment => !comment.local_agent) : [];
+        let comments = cachedPagePath === pagePath ? cachedComments : [];
         if (projectId) {
           try {
             const url = new URL(`${apiUrl}/api/comments`);
@@ -3863,37 +3695,15 @@ export function initComty(options = {}) {
             if (Array.isArray(data.comments)) comments = data.comments;
           } catch (error) { console.error("Comty: list comments failed", error); }
         }
-        if (agent) {
-          try {
-            const res = await fetch(`${agentBridgeUrl}/tasks`, { headers: agentHeaders(), cache: "no-store" });
-            if (!res.ok) throw new Error("Local companion unavailable");
-            const data = await res.json();
-            if (Array.isArray(data.tasks)) localTasks = data.tasks;
-            if (Array.isArray(data.approvals)) localApprovals = data.approvals;
-            agentConnectionError = "";
-          } catch (error) {
-            agentConnectionError = "Local agent disconnected. Check the development server, then reload this page. Your task history is kept.";
-            console.error("Comty: local tasks failed", error);
-          }
-          comments.push(...localTasks.filter(task => task.page_path === pagePath && !["done", "cancel"].includes(task.status)));
-          renderAgentPanel();
-        }
         reconcileComments(comments);
         cachedPagePath = pagePath;
         renderSidepanelComments();
         await renderComments(cachedComments);
-        syncAgentWorkingOutlines();
         ensureLiveTracking();
       })();
       try { await pendingCommentsLoad; } finally { pendingCommentsLoad = null; }
     }
 
-    if (agent) {
-      setInterval(() => {
-        if (!pendingCommentsLoad && document.visibilityState === "visible") void loadComments({ force: true });
-      }, 2000);
-    }
-
     function getPinPoint(pin) {
       return { x: parseFloat(pin.style.left), y: parseFloat(pin.style.top) };
     }
@@ -3960,50 +3770,16 @@ export function initComty(options = {}) {
       }
     }
 
-    function syncAgentWorkingOutlines() {
-      const working = localTasks.filter(task => task.status === "in_progress" && task.page_path === window.location.pathname);
-      const ids = new Set(working.map(task => String(task.id)));
-      for (const [id, outline] of workingOutlines) {
-        if (ids.has(id)) continue;
-        outline.remove(); workingOutlines.delete(id);
-      }
-      const modal = getTopActiveModal();
-      for (const task of working) {
-        const id = String(task.id);
-        let outline = workingOutlines.get(id);
-        if (!outline) {
-          outline = document.createElement("div");
-          outline.className = "comty-agent-working";
-          outline.setAttribute("aria-label", "Agent working on this element");
-          const badge = document.createElement("span");
-          badge.className = "comty-agent-working-badge";
-          badge.append(createWorkingIndicator(), "Working");
-          outline.appendChild(badge); root.appendChild(outline);
-          workingOutlines.set(id, outline);
-        }
-        const target = resolveCommentElement(task);
-        const point = target && getVisibleAnchorPoint(target, Number(task.rel_x), Number(task.rel_y), modal);
-        outline.hidden = !point;
-        if (!point) continue;
-        const rect = target.getBoundingClientRect();
-        setMeasuredRect(outline, rect);
-        outline.toggleAttribute("data-badge-below", rect.top < 32);
-      }
-    }
-
     function onFrame() {
       if (motion.enabled) updateMotion();
       if (session.comments) syncCommentAnchors();
-      if (session.agent || workingOutlines.size || localTasks.some(task => task.status === "in_progress" && task.page_path === window.location.pathname)) {
-        syncAgentWorkingOutlines();
-      }
       if (session.inspect || session.edit || inspectionLayer.childNodes.length) renderInspector();
       if (session.inspect && rulersEnabled) renderRulers();
       if (session.inspect && rulersEnabled) measurements.render();
     }
 
     function ensureLiveTracking() {
-      const active = motion.enabled || session.inspect || session.edit || (session.comments && cachedComments.length > 0) || workingOutlines.size > 0;
+      const active = motion.enabled || session.inspect || session.edit || (session.comments && cachedComments.length > 0);
       if (!active || document.hidden) {
         if (liveFrame) cancelAnimationFrame(liveFrame);
         liveFrame = null;
@@ -4023,14 +3799,13 @@ export function initComty(options = {}) {
     syncOverlayHost();
 
     function renderCachedComments() {
-      if (!session.comments && !session.inspect && !session.edit && !workingOutlines.size) return;
+      if (!session.comments && !session.inspect && !session.edit) return;
       if (resizeRenderFrame) {
         window.cancelAnimationFrame(resizeRenderFrame);
       }
       resizeRenderFrame = window.requestAnimationFrame(() => {
         resizeRenderFrame = null;
         syncCommentAnchors();
-        syncAgentWorkingOutlines();
         renderInspector();
         ensureLiveTracking();
       });
@@ -4118,7 +3893,6 @@ export function initComty(options = {}) {
         hideInspector();
         return;
       }
-      if (inspectedElement !== target) inspectExpanded = selectedElement ? inspectExpanded : false;
       showInspector(target);
     }, true);
     document.documentElement.addEventListener("pointerleave", () => {
@@ -4175,7 +3949,6 @@ export function initComty(options = {}) {
           }
           measuredRegion = null;
           selectedElement = getAnchorElement(target);
-          inspectExpanded = false;
           showInspector(target);
           return;
         }
@@ -4211,12 +3984,11 @@ export function initComty(options = {}) {
         const y = e.clientY;
 
         const anchorContext = getAnchorContext(el);
-        if (session.agent && anchorContext) anchorContext.inspectedStyles = getInspectRows(el);
 
         const payload = {
           ...getDeviceContext(),
           projectId,
-          kind: session.agent ? "agent" : "comment",
+          kind: "comment",
           host: window.location.host,
           pagePath: window.location.pathname,
           selector: getSelector(el),
@@ -4316,7 +4088,6 @@ export function initComty(options = {}) {
     window.addEventListener("blur", () => { measureAlt = false; renderInspector(); });
 
     async function boot() {
-      if (localOnly) { await loadComments(); return; }
       const res = await fetch(`${apiUrl}/api/sdk/bootstrap`, {
         method: "POST",
         headers: getSdkHeaders({ "Content-Type": "application/json" }),
@@ -4329,20 +4100,32 @@ export function initComty(options = {}) {
 
       if (!res.ok) {
         console.error("Comty: bootstrap failed", await res.text());
-        if (agent) await loadComments();
         return;
       }
 
       const data = await res.json();
       projectId = data.projectId;
       canWrite = Boolean(data.canWrite);
+      canManage = Boolean(data.canManage ?? data.canWrite);
+      allowGuestComments = Boolean(data.allowGuestComments);
       currentUser = data.user || null;
       loginUrl = data.loginUrl || "";
 
       if (!canWrite && sdkToken) {
-        sessionStorage.removeItem(tokenStorageKey);
+        try { sessionStorage.removeItem(tokenStorageKey); } catch { /* Storage may be unavailable. */ }
         sdkToken = "";
       }
+      if (didCompleteSignIn || authStatus === "forbidden") {
+        let previousSession;
+        try {
+          previousSession = JSON.parse(sessionStorage.getItem(authReturnStorageKey) || "null");
+          sessionStorage.removeItem(authReturnStorageKey);
+        } catch { /* Fall back to the requested comment mode. */ }
+        const mode = canWrite && ["browse", "edit", "inspect"].includes(previousSession?.mode)
+          ? previousSession.mode : canWrite ? "edit" : "browse";
+        setSession(mode, { entry: previousSession?.entry || mode });
+        if (previousSession?.sidepanelOpen) setSidepanelOpen(true);
+      }
       if (authStatus === "forbidden") showAuthPrompt(true);
       if (canWrite && didCompleteSignIn) {
         const toast = document.createElement("div");
@@ -4365,34 +4148,19 @@ export function initComty(options = {}) {
         getDistanceSegments, getInspectRows, syncCommentAnchors,
         setInspectorMode(enabled) { setSession(enabled ? "inspect" : "off"); },
         startEditSession, startBrowseSession, endSession, showInspector,
-        motion, setMotionEnabled, updateMotion, describeAgentError,
-        previewAgent(tasks, approvals = [], error = "") {
-          localTasks = tasks;
-          localApprovals = approvals;
-          agentConnectionError = error;
-          startAgentSession();
-          agentPanelOpen = true;
-          agentPanelSignature = "";
-          renderAgentPanel();
-        },
+        motion, setMotionEnabled, updateMotion,
         seed(comments) {
           reconcileComments(comments);
           setSession(session.comments ? session.mode : "browse", { entry: sessionEntry, renderComments: true });
           return renderComments(cachedComments, { retry: false });
         },
-        seedAgentTasks(tasks) {
-          localTasks = tasks;
-          syncAgentWorkingOutlines();
-          ensureLiveTracking();
-        },
-        setCanWrite(value) { canWrite = value; },
+        setCanWrite(value) { canWrite = value; canManage = value; },
         invalidate() { anchorRevision += 1; },
       });
     }
 
     return boot().catch(error => {
       console.error("Comty: bootstrap failed", error);
-      if (agent) return loadComments();
     });
   }
 }