@chrysb/alphaclaw 0.4.5 → 0.4.6-beta.1

package/README.md

@@ -3,7 +3,7 @@
 </p>
 <h1 align="center">AlphaClaw</h1>
 <p align="center">
-  <strong>The ops layer for OpenClaw. Deploy in minutes. Stay running for months.</strong><br>
+  <strong>The ultimate OpenClaw harness. Deploy in minutes. Stay running for months.</strong><br>
   <strong>Observability. Reliability. Agent discipline. Zero SSH rescue missions.</strong>
 </p>
 
@@ -13,7 +13,7 @@
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT" /></a>
 </p>
 
-<p align="center">AlphaClaw wraps <a href="https://github.com/openclaw/openclaw">OpenClaw</a> with a convenient setup wizard, self-healing watchdog, Git-backed rollback, and full browser-based observability. Ships with anti-drift prompt hardening to keep your agent disciplined, and simplifies integrations (e.g. Google Workspace, Telegram Topics) so you can manage everything from one UI instead of config files.</p>
+<p align="center">AlphaClaw wraps <a href="https://github.com/openclaw/openclaw">OpenClaw</a> with a convenient setup wizard, self-healing watchdog, Git-backed rollback, and full browser-based observability. Ships with anti-drift prompt hardening to keep your agent disciplined, and simplifies integrations (e.g. Google Workspace, Google Pub/Sub, Telegram Topics) so you can manage everything from one UI instead of config files.</p>
 
 <p align="center"><em>First deploy to first message in under five minutes.</em></p>
 
@@ -32,7 +32,8 @@
 - **Watchdog:** Crash detection, crash-loop recovery, auto-repair (`openclaw doctor --fix`), and Telegram/Discord notifications.
 - **Channel Orchestration:** Telegram and Discord bot pairing, credential sync, and a guided wizard for splitting Telegram into multi-threaded topic groups as your usage grows.
 - **Webhooks:** Named webhook endpoints with per-hook transform modules, request logging, and payload inspection.
-- **Google Workspace:** OAuth integration for Gmail, Calendar, Drive, Docs, Sheets, Tasks, Contacts, and Meet.
+- **Google Workspace:** OAuth integration for Gmail, Calendar, Drive, Docs, Sheets, Tasks, Contacts, and Meet, plus guided Gmail watch setup with Google Pub/Sub topic, subscription, and push endpoint handling.
+- **File Explorer:** Browser-based workspace explorer with file visibility, inline edits, diff view, and Git-aware sync for quick fixes without SSH.
 - **Prompt Hardening:** Ships anti-drift bootstrap prompts (`AGENTS.md`, `TOOLS.md`) injected into your agent's system prompt on every message — enforcing safe practices, commit discipline, and change summaries out of the box.
 - **Git Sync:** Automatic hourly commits of your OpenClaw workspace to GitHub with configurable cron schedule. Combined with prompt hardening, every agent action is version-controlled and auditable.
 - **Version Management:** In-place updates for both AlphaClaw and OpenClaw with changelog review and one-click apply.
@@ -81,13 +82,15 @@ CMD ["alphaclaw", "start"]
 
 ## Setup UI
 
-| Tab           | What it manages                                                                                            |
-| ------------- | ---------------------------------------------------------------------------------------------------------- |
-| **General**   | Gateway status, channel health, pending pairings, Google Workspace, repo sync schedule, OpenClaw dashboard |
-| **Watchdog**  | Health monitoring, crash-loop status, auto-repair toggle, notifications toggle, event log, live log tail   |
-| **Providers** | AI provider credentials (Anthropic, OpenAI, Gemini, Mistral, Voyage, Groq, Deepgram) and model selection   |
-| **Envars**    | Environment variables — view, edit, add — with gateway restart prompts                                     |
-| **Webhooks**  | Webhook endpoints, transform modules, request history, payload inspection                                  |
+| Tab           | What it manages                                                                                                 |
+| ------------- | --------------------------------------------------------------------------------------------------------------- |
+| **General**   | Gateway status, channel health, pending pairings, Google Workspace, repo sync schedule, OpenClaw dashboard      |
+| **Browse**    | File explorer for workspace visibility, inline edits, diff review, and Git-backed sync                          |
+| **Usage**     | Token summaries, per-session and per-agent cost and token breakdown                                             |
+| **Watchdog**  | Health monitoring, crash-loop status, auto-repair toggle, notifications toggle, event log, live log tail        |
+| **Providers** | AI provider credentials (Anthropic, OpenAI, Gemini, Mistral, Voyage, Groq, Deepgram) and model selection        |
+| **Envars**    | Environment variables — view, edit, add — with gateway restart prompts                                          |
+| **Webhooks**  | Webhook endpoints, transform modules, request history, payload inspection, including Gmail watch delivery flows |
 
 ## CLI
 
@@ -121,14 +124,14 @@ graph TD
 
 The built-in watchdog monitors gateway health and recovers from failures automatically.
 
-| Capability                  | Details                                                        |
-| --------------------------- | -------------------------------------------------------------- |
-| **Health checks**           | Periodic `openclaw health` with configurable interval          |
-| **Crash detection**         | Listens for gateway exit events                                |
-| **Crash-loop detection**    | Threshold-based (default: 3 crashes in 300s)                   |
-| **Auto-repair**             | Runs `openclaw doctor --fix --yes`, relaunches gateway         |
-| **Notifications**           | Telegram and Discord alerts for crashes, repairs, and recovery |
-| **Event log**               | SQLite-backed incident history with API and UI access          |
+| Capability               | Details                                                        |
+| ------------------------ | -------------------------------------------------------------- |
+| **Health checks**        | Periodic `openclaw health` with configurable interval          |
+| **Crash detection**      | Listens for gateway exit events                                |
+| **Crash-loop detection** | Threshold-based (default: 3 crashes in 300s)                   |
+| **Auto-repair**          | Runs `openclaw doctor --fix --yes`, relaunches gateway         |
+| **Notifications**        | Telegram and Discord alerts for crashes, repairs, and recovery |
+| **Event log**            | SQLite-backed incident history with API and UI access          |
 
 ## Environment Variables
 

package/lib/public/css/theme.css

@@ -53,6 +53,14 @@ body::before {
   color: var(--text-muted);
 }
 
+.ac-small-heading {
+  font-size: 11px;
+  font-weight: 500;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--text-muted);
+}
+
 /* Shared collapsible history rows (incidents, webhook requests). */
 .ac-history-list {
   display: flex;
@@ -398,6 +406,22 @@ textarea:focus {
   }
 }
 
+@keyframes acStatusDotPulseInfo {
+  0%,
+  100% {
+    transform: scale(1);
+    box-shadow:
+      0 0 0 0 rgba(34, 211, 238, 0.16),
+      0 0 5px rgba(34, 211, 238, 0.22);
+  }
+  50% {
+    transform: scale(1.08);
+    box-shadow:
+      0 0 0 3px rgba(34, 211, 238, 0.1),
+      0 0 9px rgba(34, 211, 238, 0.34);
+  }
+}
+
 .ac-status-dot {
   width: 8px;
   height: 8px;
@@ -409,6 +433,11 @@ textarea:focus {
   animation: acStatusDotPulse 2.6s ease-in-out infinite;
 }
 
+.ac-status-dot--info {
+  background: #22d3ee;
+  animation: acStatusDotPulseInfo 2.6s ease-in-out infinite;
+}
+
 .ac-status-dot--healthy-offset {
   animation-delay: 0.95s;
 }

package/lib/public/js/app.js

@@ -20,6 +20,7 @@ import {
   fetchRestartStatus,
   restartGateway,
   fetchWatchdogStatus,
+  fetchDoctorStatus,
   triggerWatchdogRepair,
   updateOpenclaw,
 } from "./lib/api.js";
@@ -44,6 +45,8 @@ import { WatchdogTab } from "./components/watchdog-tab.js";
 import { FileViewer } from "./components/file-viewer/index.js";
 import { AppSidebar } from "./components/sidebar.js";
 import { UsageTab } from "./components/usage-tab/index.js";
+import { DoctorTab } from "./components/doctor/index.js";
+import { GeneralDoctorWarning } from "./components/doctor/general-warning.js";
 import { readUiSettings, writeUiSettings } from "./lib/ui-settings.js";
 const html = htm.bind(h);
 const kDefaultUiTab = "general";
@@ -52,6 +55,8 @@ const kSidebarMinWidthPx = 180;
 const kSidebarMaxWidthPx = 460;
 const kBrowseLastPathUiSettingKey = "browseLastPath";
 const kLastMenuRouteUiSettingKey = "lastMenuRoute";
+const kDoctorWarningDismissedUntilUiSettingKey = "doctorWarningDismissedUntilMs";
+const kOneWeekMs = 7 * 24 * 60 * 60 * 1000;
 const kBrowseRestartRequiredRules = [
   { type: "file", path: "openclaw.json" },
   { type: "directory", path: "hooks/transforms" },
@@ -121,6 +126,8 @@ const RouteRedirect = ({ to }) => {
 const GeneralTab = ({
   statusData = null,
   watchdogData = null,
+  doctorStatusData = null,
+  doctorWarningDismissedUntilMs = 0,
   onRefreshStatuses = () => {},
   onSwitchTab,
   onNavigate,
@@ -133,11 +140,13 @@ const GeneralTab = ({
   onOpenclawVersionActionComplete = () => {},
   onOpenclawUpdate,
   onRestartRequired = () => {},
+  onDismissDoctorWarning = () => {},
 }) => {
   const [dashboardLoading, setDashboardLoading] = useState(false);
   const [repairingWatchdog, setRepairingWatchdog] = useState(false);
   const status = statusData;
   const watchdogStatus = watchdogData;
+  const doctorStatus = doctorStatusData;
   const gatewayStatus = status?.gateway ?? null;
   const channels = status?.channels ?? null;
   const repo = status?.repo || null;
@@ -297,6 +306,12 @@ const GeneralTab = ({
         onOpenclawVersionActionComplete=${onOpenclawVersionActionComplete}
         onOpenclawUpdate=${onOpenclawUpdate}
       />
+      <${GeneralDoctorWarning}
+        doctorStatus=${doctorStatus}
+        dismissedUntilMs=${doctorWarningDismissedUntilMs}
+        onOpenDoctor=${() => onSwitchTab("doctor")}
+        onDismiss=${onDismissDoctorWarning}
+      />
       <${Channels} channels=${channels} onSwitchTab=${onSwitchTab} onNavigate=${onNavigate} />
       <${Pairings}
         pending=${pending}
@@ -446,6 +461,10 @@ const App = () => {
     }
     return `/${kDefaultUiTab}`;
   });
+  const [doctorWarningDismissedUntilMs, setDoctorWarningDismissedUntilMs] = useState(() => {
+    const settings = readUiSettings();
+    return Number(settings[kDoctorWarningDismissedUntilUiSettingKey] || 0);
+  });
   const [isResizingSidebar, setIsResizingSidebar] = useState(false);
   const [browsePreviewPath, setBrowsePreviewPath] = useState("");
   const [mobileSidebarOpen, setMobileSidebarOpen] = useState(false);
@@ -464,13 +483,18 @@ const App = () => {
   const sharedWatchdogPoll = usePolling(fetchWatchdogStatus, statusPollCadenceMs, {
     enabled: onboarded === true,
   });
+  const sharedDoctorPoll = usePolling(fetchDoctorStatus, statusPollCadenceMs, {
+    enabled: onboarded === true,
+  });
   const sharedStatus = sharedStatusPoll.data || null;
   const sharedWatchdogStatus = sharedWatchdogPoll.data?.status || null;
+  const sharedDoctorStatus = sharedDoctorPoll.data?.status || null;
   const isAnyRestartRequired = restartRequired || browseRestartRequired;
   const refreshSharedStatuses = useCallback(() => {
     sharedStatusPoll.refresh();
     sharedWatchdogPoll.refresh();
-  }, [sharedStatusPoll.refresh, sharedWatchdogPoll.refresh]);
+    sharedDoctorPoll.refresh();
+  }, [sharedStatusPoll.refresh, sharedWatchdogPoll.refresh, sharedDoctorPoll.refresh]);
 
   const closeMenu = useCallback((e) => {
     if (menuRef.current && !menuRef.current.contains(e.target)) {
@@ -762,6 +786,7 @@ const App = () => {
       items: [
         { id: "watchdog", label: "Watchdog" },
         { id: "usage", label: "Usage" },
+        { id: "doctor", label: "Doctor" },
       ],
     },
     {
@@ -810,6 +835,8 @@ const App = () => {
     ? "watchdog"
     : location.startsWith("/usage")
     ? "usage"
+    : location.startsWith("/doctor")
+    ? "doctor"
     : location.startsWith("/envars")
     ? "envars"
     : location.startsWith("/webhooks")
@@ -882,8 +909,9 @@ const App = () => {
     settings.sidebarWidthPx = sidebarWidthPx;
     settings[kBrowseLastPathUiSettingKey] = lastBrowsePath;
     settings[kLastMenuRouteUiSettingKey] = lastMenuRoute;
+    settings[kDoctorWarningDismissedUntilUiSettingKey] = doctorWarningDismissedUntilMs;
     writeUiSettings(settings);
-  }, [sidebarWidthPx, lastBrowsePath, lastMenuRoute]);
+  }, [sidebarWidthPx, lastBrowsePath, lastMenuRoute, doctorWarningDismissedUntilMs]);
 
   const resizeSidebarWithClientX = useCallback((clientX) => {
     const shellElement = appShellRef.current;
@@ -1039,6 +1067,8 @@ const App = () => {
                 <${GeneralTab}
                   statusData=${sharedStatus}
                   watchdogData=${sharedWatchdogStatus}
+                  doctorStatusData=${sharedDoctorStatus}
+                  doctorWarningDismissedUntilMs=${doctorWarningDismissedUntilMs}
                   onRefreshStatuses=${refreshSharedStatuses}
                   onSwitchTab=${(nextTab) => setLocation(`/${nextTab}`)}
                   onNavigate=${navigateToSubScreen}
@@ -1051,6 +1081,8 @@ const App = () => {
                   onOpenclawVersionActionComplete=${handleOpenclawVersionActionComplete}
                   onOpenclawUpdate=${handleOpenclawUpdate}
                   onRestartRequired=${setRestartRequired}
+                  onDismissDoctorWarning=${() =>
+                    setDoctorWarningDismissedUntilMs(Date.now() + kOneWeekMs)}
                 />
               </div>
             </div>
@@ -1104,6 +1136,13 @@ const App = () => {
                         />
                       </div>
                     </${Route}>
+                    <${Route} path="/doctor">
+                      <div class="pt-4">
+                        <${DoctorTab}
+                          isActive=${location === "/doctor"}
+                        />
+                      </div>
+                    </${Route}>
                     <${Route} path="/envars">
                       <div class="pt-4">
                         <${Envars} onRestartRequired=${setRestartRequired} />

package/lib/public/js/components/badge.js

@@ -8,6 +8,10 @@ const kToneClasses = {
   warning: "bg-yellow-500/10 text-yellow-500",
   danger: "bg-red-500/10 text-red-400",
   neutral: "bg-gray-500/10 text-gray-400",
+  info: "bg-blue-500/10 text-blue-400",
+  accent: "bg-purple-500/10 text-purple-400",
+  cyan: "bg-cyan-500/10 text-cyan-400",
+  secondary: "bg-indigo-500/10 text-indigo-300",
 };
 
 export const Badge = ({ tone = "neutral", children }) => html`

package/lib/public/js/components/doctor/findings-list.js

@@ -0,0 +1,195 @@
+import { h } from "https://esm.sh/preact";
+import htm from "https://esm.sh/htm";
+import { Badge } from "../badge.js";
+import { ActionButton } from "../action-button.js";
+import {
+  formatDoctorCategory,
+  getDoctorCategoryTone,
+  getDoctorPriorityTone,
+} from "./helpers.js";
+
+const html = htm.bind(h);
+
+const renderEvidenceLine = (item = {}) => {
+  if (item?.path) return item.path;
+  if (item?.text) return item.text;
+  return JSON.stringify(item);
+};
+
+export const DoctorFindingsList = ({
+  cards = [],
+  busyCardId = 0,
+  onAskAgentFix = () => {},
+  onUpdateStatus = () => {},
+  showRunMeta = false,
+  hideEmptyState = false,
+}) => {
+  return html`
+    <div class="space-y-4">
+      ${cards.length
+        ? html`
+            <div class="space-y-3">
+              ${cards.map(
+                (card) => html`
+                  <div class="bg-surface border border-border rounded-xl p-4 space-y-3">
+                    <div class="space-y-2">
+                      <div class="flex flex-wrap items-start justify-between gap-3">
+                        <div class="space-y-2 min-w-0">
+                          <div class="flex flex-wrap items-center gap-2">
+                            <${Badge} tone=${getDoctorPriorityTone(card.priority)}>
+                              ${card.priority}
+                            </${Badge}>
+                            <h3 class="text-sm font-semibold text-gray-100">
+                              ${card.title}
+                            </h3>
+                          </div>
+                          <div class="flex flex-wrap items-center gap-2">
+                            <${Badge} tone=${getDoctorCategoryTone(card.category)}>
+                              ${formatDoctorCategory(card.category)}
+                            </${Badge}>
+                            ${
+                              showRunMeta
+                                ? html`
+                                    <span class="text-xs text-gray-600"
+                                      >Run #${card.runId}</span
+                                    >
+                                  `
+                                : null
+                            }
+                          </div>
+                        </div>
+                      </div>
+                      ${
+                        card.summary
+                          ? html`<p
+                              class="text-xs text-gray-300 leading-5 pt-1"
+                            >
+                              ${card.summary}
+                            </p>`
+                          : null
+                      }
+                    </div>
+                    <details class="group rounded-lg border border-border bg-black/20">
+                      <summary class="list-none cursor-pointer px-3 py-2.5 text-xs text-gray-400 group-open:border-b group-open:border-border">
+                        <span class="inline-flex items-center gap-2">
+                          <span
+                            class="inline-block text-gray-500 transition-transform duration-200 group-open:rotate-90"
+                            aria-hidden="true"
+                            >▸</span
+                          >
+                          <span>Show recommendation and details</span>
+                        </span>
+                      </summary>
+                      <div class="p-3 space-y-3">
+                        <div>
+                          <div class="ac-small-heading">
+                            Recommendation
+                          </div>
+                          <p class="text-xs text-gray-200 mt-1 leading-5">
+                            ${card.recommendation}
+                          </p>
+                        </div>
+                        ${
+                          Array.isArray(card.targetPaths) &&
+                          card.targetPaths.length
+                            ? html`
+                                <div>
+                                  <div class="ac-small-heading">
+                                    Target paths
+                                  </div>
+                                  <div class="mt-1 flex flex-wrap gap-1.5">
+                                    ${card.targetPaths.map(
+                                      (targetPath) => html`
+                                        <span
+                                          class="text-[11px] px-2 py-1 rounded-md bg-black/30 border border-border font-mono text-gray-300"
+                                        >
+                                          ${targetPath}
+                                        </span>
+                                      `,
+                                    )}
+                                  </div>
+                                </div>
+                              `
+                            : null
+                        }
+                        ${
+                          Array.isArray(card.evidence) && card.evidence.length
+                            ? html`
+                                <div>
+                                  <div class="ac-small-heading">Evidence</div>
+                                  <div class="mt-1 space-y-1">
+                                    ${card.evidence.map(
+                                      (item) => html`
+                                        <div class="text-xs text-gray-400">
+                                          ${renderEvidenceLine(item)}
+                                        </div>
+                                      `,
+                                    )}
+                                  </div>
+                                </div>
+                              `
+                            : null
+                        }
+                      </div>
+                    </details>
+                    <div class="flex flex-wrap gap-2">
+                      <${ActionButton}
+                        onClick=${() => onAskAgentFix(card)}
+                        loading=${busyCardId === card.id}
+                        tone="primary"
+                        idleLabel="Ask agent to fix"
+                        loadingLabel="Sending..."
+                      />
+                      ${
+                        card.status !== "fixed"
+                          ? html`
+                              <${ActionButton}
+                                onClick=${() => onUpdateStatus(card, "fixed")}
+                                tone="secondary"
+                                idleLabel="Mark fixed"
+                              />
+                            `
+                          : html`
+                              <${ActionButton}
+                                onClick=${() => onUpdateStatus(card, "open")}
+                                tone="secondary"
+                                idleLabel="Reopen"
+                              />
+                            `
+                      }
+                      ${
+                        card.status !== "dismissed"
+                          ? html`
+                              <${ActionButton}
+                                onClick=${() =>
+                                  onUpdateStatus(card, "dismissed")}
+                                tone="ghost"
+                                idleLabel="Dismiss"
+                              />
+                            `
+                          : html`
+                              <${ActionButton}
+                                onClick=${() => onUpdateStatus(card, "open")}
+                                tone="ghost"
+                                idleLabel="Restore"
+                              />
+                            `
+                      }
+                    </div>
+                  </div>
+                `,
+              )}
+            </div>
+          `
+        : hideEmptyState
+          ? null
+          : html`
+              <div class="ac-surface-inset rounded-xl p-4 space-y-1.5">
+                <p class="text-xs text-gray-300 leading-5">
+                  No findings currently for this selection.
+                </p>
+              </div>
+            `}
+    </div>
+  `;
+};

package/lib/public/js/components/doctor/fix-card-modal.js

@@ -0,0 +1,186 @@
+import { h } from "https://esm.sh/preact";
+import { useEffect, useMemo, useState } from "https://esm.sh/preact/hooks";
+import htm from "https://esm.sh/htm";
+import { ModalShell } from "../modal-shell.js";
+import { ActionButton } from "../action-button.js";
+import { Badge } from "../badge.js";
+import {
+  fetchAgentSessions,
+  sendDoctorCardFix,
+  updateDoctorCardStatus,
+} from "../../lib/api.js";
+import { showToast } from "../toast.js";
+import { getDoctorPriorityTone } from "./helpers.js";
+
+const html = htm.bind(h);
+
+export const DoctorFixCardModal = ({
+  visible = false,
+  card = null,
+  onClose = () => {},
+  onComplete = () => {},
+}) => {
+  const [sessions, setSessions] = useState([]);
+  const [selectedSessionKey, setSelectedSessionKey] = useState("");
+  const [loadingSessions, setLoadingSessions] = useState(false);
+  const [sending, setSending] = useState(false);
+  const [loadError, setLoadError] = useState("");
+  const [promptText, setPromptText] = useState("");
+
+  useEffect(() => {
+    if (!visible) return;
+    setPromptText(String(card?.fixPrompt || ""));
+  }, [visible, card?.fixPrompt, card?.id]);
+
+  useEffect(() => {
+    if (!visible) return;
+    let active = true;
+    const loadSessions = async () => {
+      try {
+        setLoadingSessions(true);
+        setLoadError("");
+        const data = await fetchAgentSessions();
+        if (!active) return;
+        const nextSessions = Array.isArray(data?.sessions) ? data.sessions : [];
+        setSessions(nextSessions);
+        const preferredSession =
+          nextSessions.find((sessionRow) => {
+            const key = String(sessionRow?.key || "").toLowerCase();
+            return key === "agent:main:main";
+          }) ||
+          nextSessions.find((sessionRow) => {
+            const key = String(sessionRow?.key || "").toLowerCase();
+            return key.includes(":direct:") || key.includes(":group:");
+          }) ||
+          nextSessions[0] ||
+          null;
+        setSelectedSessionKey(String(preferredSession?.key || ""));
+      } catch (error) {
+        if (!active) return;
+        setSessions([]);
+        setSelectedSessionKey("");
+        setLoadError(error.message || "Could not load agent sessions");
+      } finally {
+        if (active) setLoadingSessions(false);
+      }
+    };
+    loadSessions();
+    return () => {
+      active = false;
+    };
+  }, [visible, card?.id]);
+
+  const selectedSession = useMemo(
+    () =>
+      sessions.find(
+        (sessionRow) => String(sessionRow?.key || "") === selectedSessionKey,
+      ) || null,
+    [sessions, selectedSessionKey],
+  );
+
+  const handleSend = async () => {
+    if (!card?.id || sending) return;
+    try {
+      setSending(true);
+      await sendDoctorCardFix({
+        cardId: card.id,
+        sessionId: selectedSession?.sessionId || "",
+        replyChannel: selectedSession?.replyChannel || "",
+        replyTo: selectedSession?.replyTo || "",
+        prompt: promptText,
+      });
+      try {
+        await updateDoctorCardStatus({ cardId: card.id, status: "fixed" });
+        showToast("Doctor fix request sent and finding marked fixed", "success");
+      } catch (statusError) {
+        showToast(
+          statusError.message || "Doctor fix request sent, but could not mark the finding fixed",
+          "warning",
+        );
+      }
+      onComplete();
+      onClose();
+    } catch (error) {
+      showToast(error.message || "Could not send Doctor fix request", "error");
+    } finally {
+      setSending(false);
+    }
+  };
+
+  return html`
+    <${ModalShell}
+      visible=${visible}
+      onClose=${onClose}
+      panelClassName="bg-modal border border-border rounded-xl p-5 max-w-lg w-full space-y-4"
+    >
+      <div class="space-y-1">
+        <h2 class="text-base font-semibold">Ask agent to fix</h2>
+        <p class="text-sm text-gray-400">
+          Send this Doctor finding to one of your agent sessions as a focused fix request.
+        </p>
+      </div>
+      <div class="ac-surface-inset p-3 space-y-1">
+        <div class="flex items-center gap-2 min-w-0">
+          <${Badge} tone=${getDoctorPriorityTone(card?.priority || "P2")}>
+            ${card?.priority || "P2"}
+          </${Badge}>
+          <div class="text-sm font-semibold text-gray-200 leading-5 min-w-0">
+            ${card?.title || "Doctor finding"}
+          </div>
+        </div>
+        <div class="text-xs text-gray-400">${card?.recommendation || ""}</div>
+      </div>
+      <div class="space-y-2">
+        <label class="text-xs text-gray-500">Send to session</label>
+        <select
+          value=${selectedSessionKey}
+          onChange=${(event) => setSelectedSessionKey(String(event.currentTarget?.value || ""))}
+          disabled=${loadingSessions || sending}
+          class="w-full bg-black/30 border border-border rounded-lg px-3 py-2 text-xs text-gray-200 focus:border-gray-500"
+        >
+          ${sessions.map(
+            (sessionRow) => html`
+              <option value=${String(sessionRow?.key || "")}>
+                ${String(sessionRow?.label || sessionRow?.key || "Session")}
+              </option>
+            `,
+          )}
+        </select>
+        ${
+          loadingSessions
+            ? html`<div class="text-xs text-gray-500">Loading sessions...</div>`
+            : null
+        }
+        ${loadError ? html`<div class="text-xs text-red-400">${loadError}</div>` : null}
+      </div>
+      <div class="space-y-2">
+        <label class="text-xs text-gray-500">Instructions</label>
+        <textarea
+          value=${promptText}
+          onInput=${(event) => setPromptText(String(event.currentTarget?.value || ""))}
+          disabled=${sending}
+          rows="8"
+          class="w-full bg-black/30 border border-border rounded-lg px-3 py-2 text-xs text-gray-200 focus:border-gray-500 font-mono leading-5"
+        ></textarea>
+      </div>
+      <div class="flex items-center justify-end gap-2">
+        <${ActionButton}
+          onClick=${onClose}
+          disabled=${sending}
+          tone="secondary"
+          size="md"
+          idleLabel="Cancel"
+        />
+        <${ActionButton}
+          onClick=${handleSend}
+          disabled=${!selectedSession || loadingSessions || !!loadError || !String(promptText || "").trim()}
+          loading=${sending}
+          tone="primary"
+          size="md"
+          idleLabel="Send fix request"
+          loadingLabel="Sending..."
+        />
+      </div>
+    </${ModalShell}>
+  `;
+};