feat: recover detached agent runs

features/pitch/README.md

@@ -29,9 +29,13 @@ Until SlideX has durable projects, identity and conversation binding use
 `sessionStorage`: refresh can restore the matching server MotionDoc plus chat,
 while a new tab starts clean. The server exposes active-run discovery and the
 editor can replay a retained active run after refresh. The persisted cursor is
-recorded now, but Heddle remote v4.3 cannot seed a consumer with a nonzero
-cursor; add that generic capability in Heddle before relying on cursor-bounded
-refresh recovery instead of retained replay from sequence zero.
+recorded together with the run's base source revision. If retained replay has
+expired, the panel keeps the run detached and lets the user check its durable
+status. A completed result reuses the same source-revision policy as a live
+terminal: unchanged decks apply through the undo-aware path, while diverged
+decks stay pending for review. Heddle remote v4.3 still cannot seed a consumer
+with a nonzero cursor; add that generic capability in Heddle before relying on
+cursor-bounded refresh recovery instead of retained replay from sequence zero.
 
 ## Rollout flag
 
@@ -51,8 +55,9 @@ experience, and enable both for internal validation.
 Run `npm run test:agent:e2e:install` once, then `npm run test:agent:e2e` for the
 deterministic editor lifecycle regression. Playwright starts SlideX with the
 agent flag enabled and verifies multi-turn MotionDoc continuity, visible
-history after refresh, and conversation reset without erasing the deck. The
-same test runs in `.github/workflows/agent-regression.yml`. The route fixture in
+history after refresh, conversation reset without erasing the deck, and
+manual-edit-safe recovery after live replay expires. The same test runs in
+`.github/workflows/agent-regression.yml`. The route fixture in
 `tests/browser/agent-lifecycle.spec.ts` owns only deterministic HTTP/SSE test
 responses; it must not reimplement product session or Heddle run policy. The
 real server repository verifies those policies and route semantics separately.

features/pitch/infrastructure/slidexAgentPersistence.ts

@@ -7,7 +7,8 @@ const AgentProjectBindingSchema = z.object({
   projectId: z.string().min(1),
   sessionId: z.string().min(1),
   runId: z.string().min(1).optional(),
-  afterSequence: z.number().int().nonnegative().optional()
+  afterSequence: z.number().int().nonnegative().optional(),
+  baseSourceRevision: z.string().min(1).optional()
 });
 
 export type AgentProjectBinding = z.infer<typeof AgentProjectBindingSchema>;

features/pitch/infrastructure/slidexAgentProtocol.test.mts

@@ -68,15 +68,17 @@ test("keeps one project identity across refresh and rotates it for new or import
     projectId: first,
     sessionId: "session-1",
     runId: "run-1",
-    afterSequence: 4
+    afterSequence: 4,
+    baseSourceRevision: "revision-1"
   });
 
   assert.equal(refreshed, first);
   assert.deepEqual(readAgentProjectBinding(storage, first), {
     projectId: "project-1",
     sessionId: "session-1",
     runId: "run-1",
-    afterSequence: 4
+    afterSequence: 4,
+    baseSourceRevision: "revision-1"
   });
 
   const imported = rotateProjectInstanceId(storage, () => "project-2");

features/pitch/ui/agent/PitchAgentPanel.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { useEffect, useRef, useState, type FormEvent } from "react";
+import * as AlertDialog from "@radix-ui/react-alert-dialog";
 import { AlertTriangle, Bot, Check, RotateCcw, Send, Settings2, Square, Wrench, X } from "lucide-react";
 import type { AgentSession } from "@/features/pitch/domain/agentRun";
 import { usePitchAgent } from "@/features/pitch/ui/agent/usePitchAgent";
@@ -46,15 +47,6 @@ export function PitchAgentPanel({
     void agent.submit(nextMessage, llmApiKey);
   }
 
-  function handleResetConversation(): void {
-    if (!window.confirm(
-      "Start a new conversation? The current deck stays open, but this chat history will be removed."
-    )) {
-      return;
-    }
-    void agent.resetConversation();
-  }
-
   return (
     <aside
       aria-label="SlideX agent"
@@ -66,7 +58,9 @@ export function PitchAgentPanel({
           <div>
             <h2 className="text-sm font-semibold text-white">SlideX Agent</h2>
             <p className="text-xs text-neutral-500">
-              {agent.isHydrating
+              {agent.isCheckingStatus
+                ? "Checking status…"
+                : agent.isHydrating
                 ? "Restoring…"
                 : agent.status === "reconnecting"
                   ? "Reconnecting…"
@@ -104,15 +98,55 @@ export function PitchAgentPanel({
           <p className="mt-2 text-xs leading-5 text-neutral-500">
             The key is sent only to your configured SlideX agent server and is not stored by this editor.
           </p>
-          <button
-            className="mt-4 flex h-11 w-full items-center justify-center gap-2 rounded-md border border-white/[0.12] px-3 text-sm font-medium text-neutral-200 hover:bg-white/[0.06] disabled:cursor-not-allowed disabled:opacity-40 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
-            disabled={!agent.canReset || agent.isResetting}
-            onClick={handleResetConversation}
-            type="button"
-          >
-            <RotateCcw aria-hidden="true" size={15} />
-            {agent.isResetting ? "Starting new conversation…" : "New conversation"}
-          </button>
+          <AlertDialog.Root>
+            <AlertDialog.Trigger asChild>
+              <button
+                className="mt-4 flex h-11 w-full items-center justify-center gap-2 rounded-md border border-white/[0.12] px-3 text-sm font-medium text-neutral-200 hover:bg-white/[0.06] disabled:cursor-not-allowed disabled:opacity-40 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
+                disabled={!agent.canReset || agent.isCheckingStatus || agent.isResetting}
+                type="button"
+              >
+                <RotateCcw aria-hidden="true" size={15} />
+                {agent.isResetting ? "Starting new conversation…" : "New conversation"}
+              </button>
+            </AlertDialog.Trigger>
+            <AlertDialog.Portal>
+              <AlertDialog.Overlay className="fixed inset-0 z-50 bg-black/70" />
+              <AlertDialog.Content
+                className="fixed top-1/2 z-50 mx-auto max-w-md -translate-y-1/2 overflow-y-auto border border-white/[0.12] bg-[#18181b] p-5 shadow-xl focus:outline-none"
+                style={{
+                  left: "max(1rem, env(safe-area-inset-left))",
+                  right: "max(1rem, env(safe-area-inset-right))",
+                  maxHeight: "calc(100dvh - max(1rem, env(safe-area-inset-top)) - max(1rem, env(safe-area-inset-bottom)))"
+                }}
+              >
+                <AlertDialog.Title className="text-balance text-base font-semibold text-white">
+                  Start a new conversation?
+                </AlertDialog.Title>
+                <AlertDialog.Description className="mt-2 text-pretty text-sm leading-6 text-neutral-400">
+                  The current deck stays open, but this chat history will be permanently removed.
+                </AlertDialog.Description>
+                <div className="mt-5 flex flex-col-reverse gap-2 sm:flex-row sm:justify-end">
+                  <AlertDialog.Cancel asChild>
+                    <button
+                      className="h-11 rounded-md border border-white/[0.16] px-4 text-sm font-medium text-white hover:bg-white/[0.06] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
+                      type="button"
+                    >
+                      Keep conversation
+                    </button>
+                  </AlertDialog.Cancel>
+                  <AlertDialog.Action asChild>
+                    <button
+                      className="h-11 rounded-md bg-red-500 px-4 text-sm font-semibold text-white hover:bg-red-400 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-red-300"
+                      onClick={() => void agent.resetConversation()}
+                      type="button"
+                    >
+                      New conversation
+                    </button>
+                  </AlertDialog.Action>
+                </div>
+              </AlertDialog.Content>
+            </AlertDialog.Portal>
+          </AlertDialog.Root>
         </div>
       )}
 
@@ -127,6 +161,22 @@ export function PitchAgentPanel({
             {agent.notice}
           </p>
         )}
+        {agent.status === "detached" && (
+          <div className="mb-4 border border-white/[0.12] bg-white/[0.04] p-3">
+            <p className="text-pretty text-xs leading-5 text-neutral-300">
+              Live updates expired. Check the durable conversation to see whether the run finished.
+            </p>
+            <button
+              className="mt-3 flex h-11 w-full items-center justify-center gap-2 rounded-md border border-white/[0.16] px-3 text-sm font-medium text-white hover:bg-white/[0.06] disabled:cursor-wait disabled:opacity-50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
+              disabled={agent.isCheckingStatus}
+              onClick={() => void agent.checkRunStatus()}
+              type="button"
+            >
+              <RotateCcw aria-hidden="true" size={15} />
+              {agent.isCheckingStatus ? "Checking status…" : "Check status"}
+            </button>
+          </div>
+        )}
         {agent.messages.length === 0 ? (
           <div className="border border-dashed border-white/[0.12] p-4">
             <p className="text-sm font-medium text-white">Edit this deck conversationally</p>
@@ -209,7 +259,8 @@ export function PitchAgentPanel({
           <p className="text-xs text-neutral-600">Uses the current MotionDoc as its base</p>
           {agent.isRunning ? (
             <button
-              className="flex h-11 items-center gap-2 rounded-md border border-white/[0.16] px-4 text-sm font-medium text-white hover:bg-white/[0.06] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
+              className="flex h-11 items-center gap-2 rounded-md border border-white/[0.16] px-4 text-sm font-medium text-white hover:bg-white/[0.06] disabled:cursor-wait disabled:opacity-50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
+              disabled={agent.isCheckingStatus}
               onClick={() => void agent.cancel()}
               type="button"
             >