@abot-ai/runtime 1.5.0 → 1.7.0

package/dist/src/web-ui/app/components/system-host/rendering.js

@@ -1,5 +1,7 @@
 import { escapeHtml } from "../../lib/text-format.js";
-import { renderMacPermissionGuide } from "./macos-permissions.js";
+import { renderWindowsStoreSetup, windowsStorePanelIsAvailable } from "./windows-store-setup.js";
+import { renderConnectionCard, renderComputerMetadata } from "./connection-card.js";
+import { macPermissionSummary, renderMacPermissionPreparation } from "./macos-permission-rendering.js";
 import {
   renderMacSetupAction,
   renderMacSetupNotice,
@@ -17,128 +19,139 @@ function pairedCompanionIsOffline(snapshot) {
   if (!snapshot?.paired) return false;
   return snapshot.connected === false;
 }
+function hasDirectAccess(snapshot) {
+  return ["native", "wsl_interop"].includes(snapshot?.readiness?.route);
+}
 function connectionStatus(snapshot, statusUnavailable, busy) {
   if (statusUnavailable) return "Status unavailable";
-  if (busy || !snapshot) return "Checking this computer…";
-  if (hostSetupIsReady(snapshot)) return "Ready";
+  if (busy || !snapshot) return "Checking";
+  if (hostSetupIsReady(snapshot)) return snapshot.identity?.os === "macos" ? "Connected" : "Ready";
   if (pairedCompanionIsOffline(snapshot)) return "Paired · offline";
   if (hostCompanionUpdateRequired(snapshot)) return "Update needed";
   if (snapshot.connected) return "Computer access unavailable";
   if (snapshot?.readiness?.directAccessReady) return "Direct access available";
-  return "Setup needed";
+  return "Not connected";
 }
 function hostAccessIsAvailable(snapshot, supported, statusUnavailable, busy) {
   if (!supported || statusUnavailable || busy) return false;
   return hostSetupIsReady(snapshot);
 }
 function readyDescription(snapshot) {
-  if (["native", "wsl_interop"].includes(snapshot?.readiness?.route))
+  if (hasDirectAccess(snapshot))
     return "Direct commands are available. No extra installation is needed for direct commands.";
-  return "Your computer is connected for system tools and ABot Spark. Background collection starts only when you enable it.";
-}
-function renderIdentity(snapshot) {
-  const identity = snapshot?.identity || {};
-  const fields = [
-    ["Computer", identity.name],
-    ["Operating system", identity.os],
-    ["User", identity.user],
-    ["Computer ID", snapshot?.hostId],
-  ];
-  return `<dl class="system-host-identity">${fields
-    .filter(([, value]) => typeof value === "string" && value.length > 0)
-    .map(
-      ([label, value]) =>
-        `<div><dt>${escapeHtml(label)}</dt><dd>${escapeHtml(value)}</dd></div>`,
-    )
-    .join("")}</dl>`;
+  return "You can use computer tools from your ABot chat. Permissions and Spark collection are managed separately.";
+}
+function connectionTitle({ snapshot, supported, statusUnavailable, busy }) {
+  if (!supported) return "Computer connection unavailable";
+  if (statusUnavailable) return "Check your computer connection";
+  if (busy || !snapshot) return "Checking this computer…";
+  if (hostSetupIsReady(snapshot)) return hasDirectAccess(snapshot) ? "Direct computer access is ready" : "Your computer is ready";
+  if (pairedCompanionIsOffline(snapshot)) return "Your computer is offline";
+  if (hostCompanionUpdateRequired(snapshot)) return "Update your computer connection";
+  if (snapshot.connected) return "Check your computer connection";
+  const platforms = snapshot.readiness?.platforms || [];
+  if (platforms.length === 1 && platforms[0] === "macos") return "Connect your Mac";
+  if (platforms.length === 1 && platforms[0] === "linux") return "Connect your Linux computer";
+  return "Connect your computer";
+}
+function connectionDescription({ snapshot, supported, statusUnavailable, busy }) {
+  if (!supported) return "Computer access setup requires the local Runtime backend.";
+  if (statusUnavailable) return "The current connection status could not be checked. Refresh to try again.";
+  if (busy || !snapshot) return "Waiting for the current connection status…";
+  if (hostSetupIsReady(snapshot)) return readyDescription(snapshot);
+  if (pairedCompanionIsOffline(snapshot)) return "Reconnect Companion on this computer. Your saved connection is still available.";
+  if (hostCompanionUpdateRequired(snapshot)) return "Update Companion, then return here to check the connection.";
+  return "Connect this computer to use its apps and desktop tools from ABot.";
 }
 function renderSetupActions(snapshot, disabled) {
   if (hostSetupIsReady(snapshot)) return "";
   const platforms = snapshot?.readiness?.platforms || [];
-  const setupLabels = {
-    windows: "Set up Windows access",
-    linux: "Set up Linux access",
-  };
-  const updateLabels = {
-    windows: "Update Windows connection",
-    linux: "Update Linux connection",
-  };
-  const labels = hostCompanionUpdateRequired(snapshot)
-    ? updateLabels
-    : setupLabels;
-  return (
-    renderMacSetupAction(snapshot, disabled) +
-    platforms
-      .filter((platform) => Object.hasOwn(labels, platform))
-      .map(
-        (platform) =>
-          `<button type="button" data-system-host-install="${platform}" ${disabled ? "disabled" : ""}>${labels[platform]}</button>`,
-      )
-      .join("")
-  );
-}
-function hasInstallablePlatform(snapshot) {
+  const setupLabels = { linux: "Set up Linux access" };
+  const updateLabels = { linux: "Update Linux connection" };
+  const labels = hostCompanionUpdateRequired(snapshot) ? updateLabels : setupLabels;
+  return renderMacSetupAction(snapshot, disabled) + platforms
+    .filter((platform) => Object.hasOwn(labels, platform))
+    .map((platform) => `<button type="button" class="system-host-card-primary" data-system-host-install="${platform}" ${disabled ? "disabled" : ""}>${labels[platform]}</button>`).join("");
+}
+function hasDownloadablePlatform(snapshot) {
   if (hostSetupIsReady(snapshot)) return false;
-  return (
-    snapshot?.readiness?.platforms?.some((platform) =>
-      ["windows", "linux"].includes(platform),
-    ) === true
-  );
+  return snapshot?.readiness?.platforms?.includes("linux") === true;
 }
 function setupDownloadHasExpired(downloaded) {
   if (!downloaded?.expiresAt) return false;
   return Date.parse(downloaded.expiresAt) <= Date.now();
 }
-export function renderSystemHostConnection(input) {
-  const content = renderConnectionDetails(input);
-  if (!input.compact) return content;
-  const { snapshot, supported, statusUnavailable, busy, managementOpen } = input;
-  const available = hostAccessIsAvailable(snapshot, supported, statusUnavailable, busy);
-  const status = supported ? connectionStatus(snapshot, statusUnavailable, busy) : "Unavailable";
-  return `<details class="system-host-compact" data-system-host-management ${managementOpen ? "open" : ""}>
-    <summary class="system-host-summary">
-      <span class="system-host-summary-title">Computer access</span>
-      <span class="system-host-status" role="status" data-tone="${available ? "ready" : "unavailable"}"><span class="system-host-status-dot" aria-hidden="true"></span>${escapeHtml(status)}</span>
-      <span class="system-host-summary-name">${escapeHtml(snapshot?.identity?.name || "")}</span>
-      <span class="system-host-summary-action" aria-hidden="true"><span>⌄</span></span>
-    </summary>
-    <div class="system-host-management-body">${content}</div>
+function shouldShowSetupReadinessNote(snapshot) {
+  if (hostSetupIsReady(snapshot)) return false;
+  const platforms = snapshot?.readiness?.platforms || [];
+  if (platforms.length === 1 && platforms[0] === "windows") return false;
+  return Boolean(snapshot?.readiness?.message);
+}
+function renderSetupDownload(downloaded) {
+  if (!downloaded) return "";
+  const expired = setupDownloadHasExpired(downloaded);
+  return `<div class="system-host-download"><p><strong>Downloaded:</strong> ${escapeHtml(downloaded.filename)}</p><p>${expired ? "Setup download expired. Download setup again." : "Open this file to continue. A download alone does not mean access is ready."}</p>${downloaded.expiresAt && !expired ? `<p class="system-host-note">Open before ${escapeHtml(new Date(downloaded.expiresAt).toLocaleTimeString())}.</p>` : ""}</div>`;
+}
+function renderOtherPlatformSetup({ snapshot, busy, manualMac, downloaded }) {
+  const actions = renderSetupActions(snapshot, busy);
+  const download = renderSetupDownload(downloaded);
+  const instructions = renderMacConnectionInstructions(manualMac);
+  if (!actions && !download && !instructions) return "";
+  return `<div class="system-host-card-other">${renderMacSetupNotice(snapshot)}${instructions}${download}${hasDownloadablePlatform(snapshot) ? "<p>Download setup for the computer hosting ABot, then open the downloaded file. Follow any permission prompts shown by your operating system.</p>" : ""}${actions ? `<div class="system-host-actions">${actions}</div>` : ""}</div>`;
+}
+function connectedCardHidesPermissions(input) {
+  if (!input.snapshot?.connected || !canRenderCompactConnection(input)) return false;
+  if (input.managementOpen || input.macPermissionError || input.nativeMacPermissionError) return false;
+  return true;
+}
+function renderPermissionDetails(input) {
+  if (!input.supported || connectedCardHidesPermissions(input)) return "";
+  const content = renderMacPermissionPreparation(input);
+  if (!content || !input.compact) return content;
+  const summary = macPermissionSummary(input.snapshot, input.macPermissions, input.nativeMacPermissions);
+  const open = input.managementOpen || input.macPermissionError || input.nativeMacPermissionError;
+  return `<details class="system-host-permission-details" data-system-host-management ${open ? "open" : ""}>
+    <summary>Mac permissions<span class="system-host-summary-permissions">${escapeHtml(summary)}</span></summary>
+    ${content}
   </details>`;
 }
-
-function renderConnectionDetails({
-  snapshot,
-  supported,
-  busy,
-  error,
-  message,
-  statusUnavailable,
-  downloaded,
-  manualMac,
-}) {
-  const ready = hostSetupIsReady(snapshot);
-  const available = hostAccessIsAvailable(
-    snapshot,
-    supported,
-    statusUnavailable,
-    busy,
-  );
-  const restart = snapshot?.readiness?.restartRequired === true;
-  return `<section class="system-host-panel" aria-label="Connected computer" aria-busy="${busy ? "true" : "false"}">
-    <div class="system-host-heading"><div><h2>Computer access</h2><p>One connection for computer tools and ABot Spark.</p></div><button type="button" data-system-host-refresh ${busy || !supported ? "disabled" : ""}>Refresh status</button></div>
-    <p class="system-host-note">Shared by all environments and compatible plugins in this ABot installation. Tool approvals and ABot Spark collection are controlled separately.</p>
-    <p class="system-host-status" role="status" data-tone="${available ? "ready" : "unavailable"}"><span class="system-host-status-dot" aria-hidden="true"></span><span>${supported ? connectionStatus(snapshot, statusUnavailable, busy) : "Computer access setup requires the local Runtime backend."}</span></p>
-    ${ready && !statusUnavailable && !busy ? `<p>${readyDescription(snapshot)}</p>` : ""}
-    ${renderIdentity(snapshot)}
-    ${supported ? renderMacPermissionGuide(snapshot) : ""}
-    ${supported ? renderMacSetupNotice(snapshot) : ""}
-    ${supported ? renderMacConnectionInstructions(manualMac) : ""}
-    ${!ready && snapshot?.readiness?.message ? `<p class="system-host-note">${escapeHtml(snapshot.readiness.message)}</p>` : ""}
-    ${hasInstallablePlatform(snapshot) && supported ? "<p>Download setup for the computer hosting ABot, then open the downloaded file. It checks prerequisites and connects automatically. Follow any permission prompts shown by your operating system.</p>" : ""}
-    ${restart ? '<p class="system-host-restart" role="note">Opening the setup file enables Windows access and automatically restarts the selected WSL distribution. This interrupts its services and conversations. Finish active work before opening the setup file.</p>' : ""}
-    ${downloaded ? `<div class="system-host-download"><p><strong>Downloaded:</strong> ${escapeHtml(downloaded.filename)}</p><p>${setupDownloadHasExpired(downloaded) ? "Setup download expired. Download setup again." : "Open this file to continue. A download alone does not mean access is ready."}</p>${downloaded.expiresAt && !setupDownloadHasExpired(downloaded) ? `<p class="system-host-note">Open before ${escapeHtml(new Date(downloaded.expiresAt).toLocaleTimeString())}.</p>` : ""}</div>` : ""}
-    <div class="${error ? "error-text" : "system-host-note"}" role="${error ? "alert" : "status"}" aria-live="polite">${escapeHtml(error || message || "")}</div>
-    ${snapshot?.paired ? '<p class="system-host-note">Unpairing disconnects this companion. To reconnect, run Computer access setup again. Saved insights are kept.</p>' : ""}
-    <div class="system-host-actions">${supported ? renderSetupActions(snapshot, busy) : ""}${snapshot?.paired ? `<button type="button" data-system-host-revoke ${busy ? "disabled" : ""}>Unpair computer</button>` : ""}</div>
-  </section>`;
+function canRenderCompactConnection(input) {
+  if (!input.compact) return false;
+  if (!hostAccessIsAvailable(input.snapshot, input.supported, input.statusUnavailable, input.busy)) return false;
+  if (input.error || input.message) return false;
+  if (input.downloaded || input.manualMac) return false;
+  return true;
+}
+export function renderSystemHostConnection(input) {
+  if (input.supported && windowsStorePanelIsAvailable(input.snapshot)) {
+    return renderWindowsStoreSetup({
+      snapshot: input.snapshot, invitation: input.windowsStoreInvitation,
+      attempt: input.windowsStoreAttempt, disabled: input.busy,
+      statusUnavailable: input.statusUnavailable, error: input.error, message: input.message,
+      compact: input.compact,
+      otherSetup: renderOtherPlatformSetup(input),
+    });
+  }
+  const ready = hostAccessIsAvailable(input.snapshot, input.supported, input.statusUnavailable, input.busy);
+  const compact = canRenderCompactConnection(input);
+  const permissions = renderPermissionDetails(input);
+  const metadata = renderComputerMetadata(input.snapshot, input.busy || !input.supported);
+  const snapshot = input.snapshot;
+  const setup = input.supported ? renderSetupActions(snapshot, input.busy) : "";
+  const refresh = '<button type="button" class="system-host-card-secondary" data-system-host-refresh' +
+    (input.busy || !input.supported ? " disabled" : "") + '>Refresh status</button>';
+  return renderConnectionCard({
+    title: connectionTitle(input), status: input.supported ? connectionStatus(snapshot, input.statusUnavailable, input.busy) : "Unavailable",
+    ready, compact, disabled: input.busy, metadata,
+    description: connectionDescription(input),
+    actions: setup + refresh,
+    error: input.error, message: input.message,
+    details: compact ? permissions : `
+      ${input.supported ? renderMacSetupNotice(snapshot) + renderMacConnectionInstructions(input.manualMac) : ""}
+      ${shouldShowSetupReadinessNote(snapshot) ? `<p class="system-host-note">${escapeHtml(snapshot.readiness.message)}</p>` : ""}
+      ${hasDownloadablePlatform(snapshot) && input.supported ? "<p class=\"system-host-note\">Download setup for the computer hosting ABot, then open the downloaded file. It checks prerequisites and connects automatically. Follow any permission prompts shown by your operating system.</p>" : ""}
+      ${renderSetupDownload(input.downloaded)}
+      ${permissions}
+    `,
+  });
 }

package/dist/src/web-ui/app/components/system-host/windows-store-setup.js

@@ -0,0 +1,293 @@
+import { escapeHtml } from "../../lib/text-format.js";
+import { renderConnectionCard, renderComputerMetadata } from "./connection-card.js";
+
+const companionStoreUrl = "https://apps.microsoft.com/detail/9PK2FDQQLQS9";
+
+export function windowsStoreSetupIsAvailable(snapshot) {
+  const readiness = snapshot?.readiness;
+  if (readiness?.ready === true) return false;
+  if (!readiness?.platforms?.includes("windows")) return false;
+  if (readiness.restartRequired === true) return false;
+  return ["setup_required", "companion"].includes(readiness.route);
+}
+
+export function windowsStorePanelIsAvailable(snapshot) {
+  if (windowsStoreSetupIsAvailable(snapshot)) return true;
+  if (snapshot?.readiness?.restartRequired === true) return false;
+  if (snapshot?.readiness?.route !== "companion") return false;
+  if (snapshot.readiness.ready !== true) return false;
+  return snapshot.identity?.os === "windows";
+}
+
+function windowsCompanionCanReconnect(snapshot) {
+  if (!windowsStoreSetupIsAvailable(snapshot)) return false;
+  if (snapshot?.paired !== true) return false;
+  return snapshot.connected === false;
+}
+
+function hasConfirmedUnpairedConnection(snapshot) {
+  if (snapshot?.ok === false) return false;
+  if (snapshot?.paired !== false) return false;
+  return snapshot.connected === false;
+}
+
+function storeInvitationIsCurrent(invitation) {
+  if (!invitation) return false;
+  return Date.parse(invitation.expiresAt) > Date.now();
+}
+
+function storeRepairConfirmationIsCurrent(snapshot, attempt) {
+  if (!windowsCompanionCanReconnect(snapshot)) return false;
+  return attempt?.phase === "confirm-repair";
+}
+
+function storeConnectionStage(snapshot, invitation, attempt) {
+  if (snapshot?.readiness?.ready === true) return "ready";
+  if (attempt?.phase === "repairing") return "repairing";
+  if (storeRepairConfirmationIsCurrent(snapshot, attempt)) return "confirm-repair";
+  if (windowsCompanionCanReconnect(snapshot)) return "reconnect";
+  if (attempt?.expiresAt && Date.parse(attempt.expiresAt) <= Date.now()) return "expired";
+  if (attempt?.phase === "preparing") return "preparing";
+  if (attempt?.phase === "waiting") return "waiting";
+  if (storeInvitationIsCurrent(invitation)) return "open";
+  if (attempt?.phase === "expired") return "expired";
+  return "start";
+}
+
+function connectionButton(label, disabled, secondary = false) {
+  return `<button type="button" class="system-host-card-${secondary ? "secondary" : "primary"}" data-system-host-store-connect ${disabled ? "disabled" : ""}>${label}</button>`;
+}
+
+function companionLaunchLink(invitation, secondary = false) {
+  return `<a class="system-host-card-${secondary ? "secondary" : "primary"}" href="${escapeHtml(invitation.launchUrl)}" data-system-host-store-launch rel="noreferrer">${secondary ? "Open Companion again" : "Open Companion"}</a>`;
+}
+
+function connectionStageContent(stage, snapshot, invitation, disabled) {
+  if (stage === "ready") return {
+    status: "Connected", step: "Your computer is ready", copy: "You can use computer tools from your ABot chat.",
+  };
+  if (stage === "reconnect") return {
+    status: "Offline", step: "Your computer is offline", copy: `Open Companion on ${snapshot?.identity?.name || "your computer"} to reconnect.`,
+    action: `<a class="system-host-card-primary" href="abot-companion://open" data-system-host-store-open-existing rel="noreferrer">Open Companion</a><button type="button" class="system-host-card-secondary" data-system-host-store-repair ${disabled ? "disabled" : ""}>Set up again</button>`,
+    help: "Removed the connection in Companion? Choose Set up again.",
+  };
+  if (stage === "confirm-repair") return {
+    status: "Confirm reset", step: "Set up this computer again?", copy: "The previous connection will be removed. You’ll approve a new connection in Companion.",
+    action: `<button type="button" class="system-host-card-primary" data-system-host-store-repair-confirm ${disabled ? "disabled" : ""}>Continue</button><button type="button" class="system-host-card-secondary" data-system-host-store-repair-cancel ${disabled ? "disabled" : ""}>Cancel</button>`,
+    help: "Your conversations and saved insights will be kept.",
+  };
+  if (stage === "repairing") return {
+    status: "Preparing", step: "Setting up this computer again", copy: "Removing the previous connection before preparing your new connection…",
+    action: '<button type="button" class="system-host-card-primary" disabled>Preparing connection…</button>',
+  };
+  if (stage === "preparing") return {
+    status: "Preparing", step: "Connect your Windows computer", copy: "Preparing your connection…",
+    action: connectionButton("Preparing connection…", true),
+  };
+  if (stage === "open") return {
+    status: "Waiting for you", step: "Approve the connection in Companion", copy: "Open the app and check the ABot address. This page will confirm when your computer is connected.",
+    action: companionLaunchLink(invitation),
+    help: "Your browser may ask permission to open the app.",
+  };
+  if (stage === "waiting") return {
+    status: "Waiting for approval", step: "Approve the connection in Companion", copy: "Check the ABot address and approve the connection in the app. This page will confirm when your computer is connected.",
+    help: "If Companion did not open, use the option below.",
+    action: storeInvitationIsCurrent(invitation)
+      ? companionLaunchLink(invitation, true)
+      : connectionButton("Start connection again", disabled, true),
+  };
+  if (stage === "expired") return {
+    status: "Expired", step: "Connection link expired", copy: "Connect again to get a fresh invitation.",
+    action: connectionButton("Connect again", disabled),
+  };
+  const update = snapshot?.readiness?.companionUpdateRequired === true;
+  return {
+    status: update ? "Update needed" : "Not connected",
+    step: update ? "Update Companion" : "Connect your Windows computer",
+    copy: update ? "Update Companion from Microsoft Store, then return here to reconnect."
+      : "Companion lets ABot work with files, apps and desktop tools on this computer.",
+    action: `<a class="system-host-card-primary" href="${companionStoreUrl}" target="_blank" rel="noopener noreferrer"><svg class="system-host-store-icon" width="18" height="18" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M4 7h16v14H4ZM8 7V5a4 4 0 0 1 8 0v2" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linejoin="round"/><path d="M8 10h3v3H8Zm5 0h3v3h-3Zm-5 5h3v3H8Zm5 0h3v3h-3Z" fill="currentColor"/></svg><span>${update ? "Update in Microsoft Store" : "Install from Microsoft Store"}</span></a>${connectionButton(update ? "I already updated it" : "I already have it", disabled, true)}`,
+    help: update ? "Your saved connection is kept during an update." : "Install once from Microsoft Store, then return here to connect.",
+  };
+}
+
+function storeConnectionDisplayContent(stage, snapshot, invitation, disabled, statusUnavailable) {
+  if (statusUnavailable) return {
+    status: "Status unavailable", step: "Check your computer connection",
+    copy: "The current connection status could not be checked. Refresh to try again.",
+  };
+  if (disabled && stage === "ready") return {
+    status: "Checking", step: "Checking your computer connection",
+    copy: "Waiting for the current connection status…",
+  };
+  return connectionStageContent(stage, snapshot, invitation, disabled);
+}
+
+function shouldRenderReadyWindowsSummary(compact, ready, error, message, otherSetup) {
+  if (!compact || !ready) return false;
+  if (error || message || otherSetup) return false;
+  return true;
+}
+
+export function renderWindowsStoreSetup({ snapshot, invitation, attempt, disabled, statusUnavailable, error, message, compact, otherSetup = "" }) {
+  if (!windowsStorePanelIsAvailable(snapshot)) return "";
+  const stage = storeConnectionStage(snapshot, invitation, attempt);
+  const content = storeConnectionDisplayContent(stage, snapshot, invitation, disabled, statusUnavailable);
+  const ready = stage === "ready" && !statusUnavailable && !disabled;
+  const summary = shouldRenderReadyWindowsSummary(compact, ready, error, message, otherSetup);
+  const refresh = statusUnavailable || error ? '<button type="button" class="system-host-card-secondary" data-system-host-refresh' + (disabled ? " disabled" : "") + '>Refresh status</button>' : "";
+  return renderConnectionCard({
+    title: content.step, status: content.status, ready, disabled,
+    compact: summary,
+    description: content.copy, actions: content.action, help: content.help, error, message,
+    metadata: ["ready", "reconnect"].includes(stage) ? renderComputerMetadata(snapshot, disabled) : "",
+    details: summary ? "" : (ready ? '<p class="system-host-card-access-note">Computer actions follow your permission settings. Spark collection is managed separately.</p>' : "") + refresh + otherSetup,
+    attributes: `data-system-host-store-setup data-system-host-store-stage="${stage}"`,
+  });
+}
+
+function readStoreInvitation(receipt) {
+  if (!storeInvitationIsCurrent(receipt)) throw new Error("store_invitation_expired");
+  const launch = new URL(receipt.launchUrl);
+  if (launch.protocol !== "abot-companion:") throw new Error("store_invitation_invalid");
+  if (launch.hostname !== "connect") throw new Error("store_invitation_invalid");
+  if (launch.username || launch.password || launch.port || launch.hash) throw new Error("store_invitation_invalid");
+  if (launch.pathname !== "" && launch.pathname !== "/") throw new Error("store_invitation_invalid");
+  if (!/^[A-Za-z0-9_-]+$/.test(launch.searchParams.get("invitation") || "")) throw new Error("store_invitation_invalid");
+  if (receipt.storeUrl !== companionStoreUrl) throw new Error("store_invitation_invalid");
+  return { launchUrl: launch.href, expiresAt: receipt.expiresAt };
+}
+
+/** The invitation exists only on the active surface, until readiness or expiry. */
+export function createWindowsStoreConnectionActions({
+  state,
+  requestStoreConnection,
+  revokeConnection,
+  receiveUnpairedConnection,
+  canInstallOnPlatform,
+  beginRequest,
+  finishRequest,
+  isCurrentResponse,
+  getSurfaceRevision,
+  getEnvironmentId = () => "",
+  isVisible,
+  notify,
+  scheduleExpiration = setTimeout,
+  cancelExpiration = clearTimeout,
+}) {
+  let expirationTimer;
+  function clear({ preserveWaiting = false } = {}) {
+    if (expirationTimer !== undefined) cancelExpiration(expirationTimer);
+    expirationTimer = undefined;
+    if (state.windowsStoreInvitation) state.message = "";
+    state.windowsStoreInvitation = null;
+    if (preserveWaiting && state.windowsStoreAttempt?.phase === "waiting") return;
+    state.windowsStoreAttempt = null;
+  }
+  function canApplyStoreResponse(operation, surface, environment) {
+    if (!isCurrentResponse(operation)) return false;
+    if (surface !== getSurfaceRevision()) return false;
+    if (environment !== getEnvironmentId()) return false;
+    return isVisible();
+  }
+  function receiveStoreInvitation(receipt) {
+    state.windowsStoreInvitation = readStoreInvitation(receipt);
+    state.windowsStoreAttempt = { phase: "open", expiresAt: receipt.expiresAt };
+    state.downloaded = null;
+    state.manualMac = null;
+    state.message = "";
+    expirationTimer = scheduleExpiration(() => {
+      clear();
+      state.windowsStoreAttempt = { phase: "expired" };
+      notify();
+    }, Date.parse(receipt.expiresAt) - Date.now());
+  }
+  async function connectWindowsStore() {
+    if (typeof requestStoreConnection !== "function") return false;
+    if (!canInstallOnPlatform("windows")) return false;
+    if (!windowsStoreSetupIsAvailable(state.snapshot)) return false;
+    if (windowsCompanionCanReconnect(state.snapshot)) return false;
+    if (storeInvitationIsCurrent(state.windowsStoreInvitation)) return false;
+    clear();
+    const operation = beginRequest();
+    const surface = getSurfaceRevision();
+    const environment = getEnvironmentId();
+    state.windowsStoreAttempt = { phase: "preparing" };
+    notify();
+    try {
+      const receipt = await requestStoreConnection();
+      if (!canApplyStoreResponse(operation, surface, environment)) return false;
+      receiveStoreInvitation(receipt);
+      return true;
+    } catch {
+      if (!canApplyStoreResponse(operation, surface, environment)) return false;
+      clear();
+      state.actionError = "The Companion connection link could not be created. Refresh status and try again.";
+      return false;
+    } finally {
+      finishRequest(operation);
+    }
+  }
+  function canRepairWindowsPairing() {
+    if (!canInstallOnPlatform("windows")) return false;
+    return windowsCompanionCanReconnect(state.snapshot);
+  }
+  function beginWindowsStoreRepair() {
+    if (!canRepairWindowsPairing()) return false;
+    clear();
+    state.windowsStoreAttempt = { phase: "confirm-repair" };
+    state.actionError = "";
+    notify();
+    return true;
+  }
+  function cancelWindowsStoreRepair() {
+    if (state.busy) return false;
+    if (state.windowsStoreAttempt?.phase !== "confirm-repair") return false;
+    clear();
+    notify();
+    return true;
+  }
+  async function confirmWindowsStoreRepair() {
+    if (!canRepairWindowsPairing()) return false;
+    if (state.windowsStoreAttempt?.phase !== "confirm-repair") return false;
+    if (typeof revokeConnection !== "function" || typeof requestStoreConnection !== "function") return false;
+    const operation = beginRequest();
+    const surface = getSurfaceRevision();
+    const environment = getEnvironmentId();
+    state.windowsStoreAttempt = { phase: "repairing" };
+    notify();
+    let revoked = false;
+    try {
+      const snapshot = await revokeConnection();
+      if (!canApplyStoreResponse(operation, surface, environment)) return false;
+      if (!hasConfirmedUnpairedConnection(snapshot)) throw new Error("unpair_not_confirmed");
+      receiveUnpairedConnection(snapshot);
+      revoked = true;
+      if (!windowsStoreSetupIsAvailable(snapshot)) throw new Error("store_setup_unavailable");
+      state.windowsStoreAttempt = { phase: "preparing" };
+      state.message = "";
+      notify();
+      const receipt = await requestStoreConnection();
+      if (!canApplyStoreResponse(operation, surface, environment)) return false;
+      receiveStoreInvitation(receipt);
+      return true;
+    } catch {
+      if (!canApplyStoreResponse(operation, surface, environment)) return false;
+      clear();
+      state.message = "";
+      state.actionError = revoked
+        ? "The previous pairing was removed, but a new connection link could not be created. Connect again to continue."
+        : "The previous pairing could not be removed. No new connection was created. Refresh status and try again.";
+      return false;
+    } finally {
+      finishRequest(operation);
+    }
+  }
+  function markLaunchRequested() {
+    if (!storeInvitationIsCurrent(state.windowsStoreInvitation)) return;
+    state.windowsStoreAttempt = { phase: "waiting", expiresAt: state.windowsStoreInvitation.expiresAt };
+    // Leave the anchor intact until the browser has dispatched its native protocol.
+    setTimeout(notify, 0);
+  }
+  return { connectWindowsStore, beginWindowsStoreRepair, cancelWindowsStoreRepair, confirmWindowsStoreRepair, markLaunchRequested, clear };
+}