Recreate deleted worktrees from their branch on restore

Archiving a Paseo-owned worktree deletes its directory, so reopening its
agent previously dead-ended even after the workspace record came back —
there was no folder to return to.

Restore now recreates the worktree at its original path from the kept
branch (the branch is never deleted on archive), re-points the same
workspace record, and clears archivedAt — preserving the workspaceId so
the agent stays linked. The directory is recreated before the un-archive
so the reconciler can't re-archive it for a missing directory. A deleted
or already-checked-out branch surfaces a typed failure and leaves the
workspace archived.

Gated behind a worktreeRestore capability flag; older hosts get an
explicit "update your host" state instead of a misleading failure.

packages/app/src/utils/navigate-to-agent/index.ts

@@ -7,8 +7,10 @@ import { navigateToPreparedWorkspaceTab } from "@/utils/workspace-navigation";
 export type { NavigateToAgentInput } from "./resolve";
 
 // Clears the transient restoring state if the daemon resolves refreshAgent without
-// re-emitting a workspace_update (the directory-gone case), so the gate never spins forever.
-const RESTORE_TIMEOUT_MS = 7000;
+// re-emitting a workspace_update (the directory-gone case), so the gate never spins
+// forever. Recreating a worktree can require a git fetch, so the budget is generous
+// to avoid flashing a false "failed" on a capable daemon doing slow real work.
+const RESTORE_TIMEOUT_MS = 30000;
 
 function restoreArchivedWorkspace(serverId: string, agentId: string, workspaceId: string): void {
   const snapshot = getHostRuntimeStore().getSnapshot(serverId);
@@ -33,6 +35,15 @@ function restoreArchivedWorkspace(serverId: string, agentId: string, workspaceId
     return;
   }
 
+  // COMPAT(worktreeRestore): added in v0.1.98, drop the gate when floor >= v0.1.98
+  // Single capability read for restore. An old daemon recreates nothing on
+  // refresh_agent, so a gone directory would spin then flash a misleading
+  // "couldn't restore". Surface an explicit "update your host" state instead.
+  if (session?.serverInfo?.features?.worktreeRestore !== true) {
+    store.setWorkspaceRestoreStatus(serverId, workspaceId, "needs-host-upgrade");
+    return;
+  }
+
   store.setWorkspaceRestoreStatus(serverId, workspaceId, "restoring");
   // The reducer guards "failed" so a late timeout after the descriptor lands is a no-op.
   setTimeout(

packages/app/src/utils/navigate-to-agent/restore-archived-workspace.test.ts

@@ -27,15 +27,21 @@ const SERVER_ID = "server-1";
 const AGENT_ID = "agent-1";
 const WORKSPACE_ID = "workspace-1";
 
-function status(): "restoring" | "failed" | null {
+function status(): "restoring" | "failed" | "needs-host-upgrade" | null {
   return (
     useSessionStore.getState().sessions[SERVER_ID]?.restoringWorkspaces.get(WORKSPACE_ID) ?? null
   );
 }
 
-function seedArchivedAgent(): void {
+function seedArchivedAgent(options?: { worktreeRestore?: boolean }): void {
   const store = useSessionStore.getState();
   store.initializeSession(SERVER_ID, null as unknown as DaemonClient);
+  store.updateSessionServerInfo(SERVER_ID, {
+    serverId: SERVER_ID,
+    hostname: "host",
+    version: "0.1.98",
+    features: { worktreeRestore: options?.worktreeRestore ?? true },
+  } as unknown as Parameters<typeof store.updateSessionServerInfo>[1]);
   store.setAgents(SERVER_ID, (prev) => {
     const next = new Map(prev);
     next.set(AGENT_ID, {
@@ -133,10 +139,21 @@ describe("restoreArchivedWorkspace via navigateToAgent", () => {
     await Promise.resolve();
     expect(status()).toBe("restoring");
 
-    await vi.advanceTimersByTimeAsync(7000);
+    await vi.advanceTimersByTimeAsync(30000);
     expect(status()).toBe("failed");
   });
 
+  it("marks the workspace needs-host-upgrade without refreshing when the daemon lacks worktreeRestore", () => {
+    useSessionStore.getState().clearSession(SERVER_ID);
+    seedArchivedAgent({ worktreeRestore: false });
+    refreshAgent.mockImplementation(() => new Promise(() => {}));
+
+    trigger();
+
+    expect(refreshAgent).not.toHaveBeenCalled();
+    expect(status()).toBe("needs-host-upgrade");
+  });
+
   it("is a no-op when the workspace descriptor is already present", () => {
     refreshAgent.mockImplementation(() => new Promise(() => {}));
     useSessionStore.getState().mergeWorkspaces(SERVER_ID, [