@agent-link/agent 0.1.338 → 0.1.340

package/dist/connection.js

@@ -1,4 +1,7 @@
 import WebSocket from 'ws';
+import { setCopilotProvider } from './runtime.js';
+import { dispatchCopilotRequest, resolveCopilotCommandResumeSessionId } from './copilot-request-dispatch.js';
+import { COPILOT_COMPACTION_POLICY } from './copilot-compaction-policy.js';
 import os from 'os';
 import path from 'path';
 import { performance } from 'perf_hooks';
@@ -29,12 +32,15 @@ const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
 const TEAM_SESSIONS_DIR = path.join(CONFIG_DIR, 'team-sessions');
 const LOOP_SESSIONS_DIR = path.join(CONFIG_DIR, 'loop-sessions');
-import { handleChat as claudeHandleChat, addSendFn, abort as abortClaude, abortAll as abortAllClaude, cancelExecution as claudeCancelExecution, handleUserAnswer, handleToolPermissionResponse, handleBtwQuestion, getConversation, getConversations, getIsCompacting, clearSessionId, evictByClaudeSessionId, rebindConversation, addOutputObserver, removeOutputObserver, addCloseObserver, removeCloseObserver, setOutputObserver, clearOutputObserver, setCloseObserver, clearCloseObserver, restartConversation, createPlaceholderConversation, getPendingQuestions, getPendingToolPermissions, setModel, addOnSessionStarted, getBackendType, setBackendType, isCopilotBackend, isCodexBackend, isPiBackend, isYeaftBackend, addCopilotSendFn, handleCopilotChat, cancelCopilotExecution, listCopilotSessionsPage, listAllCopilotSessionsPage, readCopilotSessionMessages, getCopilotSessionWorkDir, deleteCopilotSession, renameCopilotSession, moveCopilotSession, getCopilotConversation, getCopilotConversations, createCopilotPlaceholder, restartCopilotConversation, rebindCopilotConversation, cleanupAllCopilotConversations, copilotCapabilities, addCodexSendFn, handleCodexChat, cancelCodexExecution, listCodexSessionsPage, listAllCodexSessionsPage, readCodexSessionMessages, deleteCodexSession, renameCodexSession, moveCodexSession, getCodexConversation, getCodexConversations, createCodexPlaceholder, restartCodexConversation, rebindCodexConversation, cleanupAllCodexConversations, evictByCodexSessionId, codexCapabilities } from './runtime.js';
+import { handleChat as claudeHandleChat, addSendFn, abort as abortClaude, abortAll as abortAllClaude, cancelExecution as claudeCancelExecution, handleUserAnswer, handleToolPermissionResponse, handleBtwQuestion, getConversation, getConversations, getIsCompacting, clearSessionId, evictByClaudeSessionId, rebindConversation, addOutputObserver, removeOutputObserver, addCloseObserver, removeCloseObserver, setOutputObserver, clearOutputObserver, setCloseObserver, clearCloseObserver, restartConversation, createPlaceholderConversation, getPendingQuestions, getPendingToolPermissions, setModel, addOnSessionStarted, getBackendType, setBackendType, isCopilotBackend, isCodexBackend, isPiBackend, isYeaftBackend, addCopilotSendFn, handleCopilotChat, executeCopilotCommand, setCopilotPlanMode, startCopilotPlanImplementation, cancelCopilotExecution, readCopilotSessionMessages, readCopilotSessionMode, readCopilotSessionProvider, readCopilotSessionUsage, getCopilotSessionWorkDir, deleteCopilotSession, renameCopilotSession, moveCopilotSession, getCopilotConversation, getCopilotConversations, createCopilotPlaceholder, rebindCopilotConversation, getPendingCopilotDecisions, handleCopilotUserAnswer, cleanupAllCopilotConversations, copilotCapabilities, addCodexSendFn, handleCodexChat, cancelCodexExecution, listCodexSessionsPage, listAllCodexSessionsPage, readCodexSessionMessages, deleteCodexSession, renameCodexSession, moveCodexSession, getCodexConversation, getCodexConversations, createCodexPlaceholder, restartCodexConversation, rebindCodexConversation, cleanupAllCodexConversations, evictByCodexSessionId, codexCapabilities } from './runtime.js';
 import { addPiSendFn, cancelPiExecution, cleanupAllPiConversations, createPiPlaceholder, deletePiSession, evictByPiSessionId, getPiConversation, getPiConversations, getPiSessionWorkDir, handlePiChat, listAllPiSessionsPage, listPiSessionsPage, movePiSession, piCapabilities, readPiSessionMessages, rebindPiConversation, renamePiSession, restartPiConversation, } from './pi.js';
 import { addYeaftSendFn, cancelYeaftExecution, cleanupAllYeaftConversations, createYeaftPlaceholder, deleteYeaftSession, evictByYeaftSessionId, getYeaftConversation, getYeaftConversations, handleYeaftChat, handleYeaftUserAnswer, listAllYeaftSessionsPage, listYeaftSessionsPage, moveYeaftSession, readYeaftSessionMessages, rebindYeaftConversation, renameYeaftSession, restartYeaftConversation, } from './yeaft.js';
 import { DEFAULT_SESSION_LIST_LIMIT, LEGACY_SESSION_LIST_CAP, listSessions, listSessionsPageAsync, readSessionMessages, deleteSession, renameSession, moveSession, listAllRecentSessionsPage, getSessionCacheStats } from './history.js';
 import { discoverProviderCommands, providerCommandDiscoverers, } from './provider-command-discovery.js';
 import { providerCommandsMessage } from './provider-command-types.js';
+import { copilotCapabilityService } from './copilot-capability-service.js';
+import { mergeCopilotCapabilities } from './copilot-capabilities.js';
+const copilotCapabilityRequests = new Map();
 import { claudeCapabilities, yeaftCapabilities } from './backends/types.js';
 import { createSessionSearchHandler } from './session-search-handler.js';
 import { formatSessionExport, isSessionExportFormat } from './session-export.js';
@@ -47,6 +53,7 @@ import { initScheduler, getRunningExecutions, } from './scheduler.js';
 import { handleWebUpgradeMessage } from './web-upgrade.js';
 import { refreshRuntimeLaunchSpecDeviceName } from './upgrade-launch-spec.js';
 import { getAgentRuntimeInfo } from './runtime-info.js';
+import { listCopilotSessionsPageAsync, listAllCopilotSessionsPageAsync } from './runtime.js';
 let tunnelHandler = null;
 let terminalManager = null;
 const RECONNECT_BASE_DELAY = 1000;
@@ -103,6 +110,9 @@ function capabilitiesForBackend(backend, providerId) {
     })();
     if (!providerId)
         return capabilities;
+    if (backend === 'copilot' && ['copilot', 'agency-copilot'].includes(providerId)) {
+        capabilities.copilotOptions.catalog = mergeCopilotCapabilities(providerId);
+    }
     return {
         ...capabilities,
         commands: {
@@ -638,10 +648,13 @@ function deduped(key, fn) {
     });
     inflightHandlers.set(key, run());
 }
-export function send(msg) {
+export function send(msg, expectedSocket) {
+    if (expectedSocket !== undefined && state.ws !== expectedSocket)
+        return;
     if (state.ws && state.ws.readyState === WebSocket.OPEN) {
         sendQueue = sendQueue.then(async () => {
-            if (!state.ws || state.ws.readyState !== WebSocket.OPEN)
+            if (!state.ws || state.ws.readyState !== WebSocket.OPEN
+                || (expectedSocket !== undefined && state.ws !== expectedSocket))
                 return;
             let payload = msg;
             // Don't E2E-encrypt messages the server must inspect (it only decrypts
@@ -662,6 +675,8 @@ export function send(msg) {
             if (state.e2eKey && state.e2eNegotiated && !skipE2E.includes(msg.type)) {
                 payload = await e2eEncrypt(msg, state.e2eKey);
             }
+            if (expectedSocket !== undefined && state.ws !== expectedSocket)
+                return;
             return encryptAndSend(state.ws, payload, state.sessionKey);
         }).catch((err) => {
             console.error(`[AgentLink] send() failed for ${msg.type}:`, err.message);
@@ -981,17 +996,48 @@ function handleServerMessage(msg) {
             }
             else if (isCopilotBackend()) {
                 const copilotMsg = msg;
-                handleCopilotChat(chatConvId || '', copilotMsg.prompt, chatDir, {
+                void dispatchCopilotRequest({ conversationId: chatConvId || '', providerId: effectiveProviderId }, () => handleCopilotChat(chatConvId || '', copilotMsg.prompt, chatDir, {
                     resumeSessionId: chatOptions.resumeSessionId,
                     providerId: effectiveProviderId,
                     copilotOptions: copilotMsg.copilotOptions,
-                }, copilotMsg.files);
+                    forkSourceSessionId: copilotMsg.forkSourceSessionId,
+                }, copilotMsg.files), send, () => getCopilotConversation(chatConvId || '')?.turnActive === true);
             }
             else {
                 claudeHandleChat(chatConvId, msg.prompt, chatDir, chatOptions, msg.files);
             }
             break;
         }
+        case 'get_copilot_capabilities': {
+            const m = msg;
+            if (typeof m.requestId !== 'string' || !m.requestId || m.requestId.length > 200)
+                break;
+            if (m.cancel) {
+                copilotCapabilityRequests.get(m.requestId)?.abort();
+                break;
+            }
+            if (!['copilot', 'agency-copilot'].includes(m.providerId) || copilotCapabilityRequests.has(m.requestId))
+                break;
+            const scope = { providerId: m.providerId, workDir: path.resolve(m.workDir || state.workDir) };
+            const controller = new AbortController();
+            copilotCapabilityRequests.set(m.requestId, controller);
+            send({ type: 'copilot_capabilities', requestId: m.requestId, providerId: m.providerId,
+                workDir: scope.workDir, loading: true, catalog: copilotCapabilityService.snapshot(scope) });
+            void copilotCapabilityService.query(scope, controller.signal).then(catalog => {
+                if (!controller.signal.aborted)
+                    send({ type: 'copilot_capabilities', requestId: m.requestId,
+                        providerId: m.providerId, workDir: scope.workDir, loading: false, catalog });
+            }).catch(error => {
+                if (!controller.signal.aborted)
+                    send({ type: 'copilot_capabilities', requestId: m.requestId,
+                        providerId: m.providerId, workDir: scope.workDir, loading: false,
+                        catalog: { ...copilotCapabilityService.snapshot(scope), error: String(error) } });
+            }).finally(() => {
+                if (copilotCapabilityRequests.get(m.requestId) === controller)
+                    copilotCapabilityRequests.delete(m.requestId);
+            });
+            break;
+        }
         case 'get_provider_commands': {
             const m = msg;
             if (typeof m.requestId !== 'string' || !m.requestId.trim()
@@ -1014,6 +1060,7 @@ function handleServerMessage(msg) {
                 providerId: m.providerId,
                 conversationId: m.conversationId,
                 workDir: path.resolve(m.workDir),
+                ...(m.copilotOptions ? { copilotOptions: m.copilotOptions } : {}),
             };
             void discoverProviderCommands(scope)
                 .then(result => send(providerCommandsMessage(scope, result)))
@@ -1023,6 +1070,32 @@ function handleServerMessage(msg) {
             })));
             break;
         }
+        case 'execute_provider_command': {
+            const m = msg;
+            const conversation = m.conversationId
+                ? getCopilotConversation(m.conversationId)
+                : undefined;
+            const providerId = m.providerId || conversation?.providerId || 'copilot';
+            const command = m.command?.trim().toLowerCase();
+            if (!m.conversationId
+                || getBackendTypeForProvider(providerId) !== 'copilot'
+                || !['compact', 'plan', 'goal'].includes(command || '')) {
+                send({
+                    type: 'error',
+                    conversationId: m.conversationId,
+                    message: 'Invalid Copilot provider command request',
+                });
+                break;
+            }
+            const workDir = path.resolve(m.workDir || conversation?.workDir || state.workDir);
+            const conversationId = m.conversationId;
+            void dispatchCopilotRequest({ conversationId, providerId }, () => executeCopilotCommand(conversationId, command, typeof m.input === 'string' ? m.input : '', workDir, {
+                providerId,
+                resumeSessionId: resolveCopilotCommandResumeSessionId(m.resumeSessionId, conversation),
+                copilotOptions: m.copilotOptions,
+            }), send, () => getCopilotConversation(conversationId)?.turnActive === true);
+            break;
+        }
         case 'cancel_execution':
             {
                 const conversationId = msg.conversationId || '';
@@ -1174,18 +1247,7 @@ function handleServerMessage(msg) {
                 });
             }
             else if (recentBackend === 'copilot') {
-                const page = listAllCopilotSessionsPage({ limit: m.limit, cursor: m.cursor });
-                console.log(`[AgentLink] → recent_sessions_list (${page.sessions.length} copilot sessions) hasMore=${page.hasMore}`);
-                send({
-                    type: 'recent_sessions_list',
-                    sessions: page.sessions,
-                    hasMore: page.hasMore,
-                    nextCursor: page.nextCursor,
-                    indexState: page.indexState,
-                    ...(m.mode ? { mode: m.mode } : {}),
-                    ...(m.requestId ? { requestId: m.requestId } : {}),
-                    ...(m.providerId ? { providerId: m.providerId } : {}),
-                });
+                void handleListRecentCopilotSessions(m);
             }
             else {
                 handleListRecentSessions(m);
@@ -1418,6 +1480,10 @@ function handleServerMessage(msg) {
             }
             // Route to copilot backend
             if (resumeBackend === 'copilot') {
+                const liveOwner = [...getCopilotConversations().values()].find(conv => conv.copilotSessionId === m.claudeSessionId || conv.lastCopilotSessionId === m.claudeSessionId);
+                const resumeProviderId = liveOwner?.providerId || readCopilotSessionProvider(m.claudeSessionId)
+                    || m.providerId
+                    || 'copilot';
                 // Copilot rewrites workspace.yaml using the cwd of each resume process.
                 // Recover the persisted cwd before creating a placeholder so a reconnect
                 // that omits workDir cannot silently move the session to the agent cwd.
@@ -1426,35 +1492,101 @@ function handleServerMessage(msg) {
                     || state.workDir;
                 // Rebind running copilot process to new conversationId (handles page refresh)
                 if (convId) {
+                    const existing = getCopilotConversation(convId);
+                    const boundSession = existing?.copilotSessionId || existing?.lastCopilotSessionId;
+                    if (existing && (boundSession || existing.turnActive) && boundSession !== m.claudeSessionId) {
+                        send({ type: 'error', operation: 'resume_conversation', conversationId: convId,
+                            providerId: resumeProviderId, claudeSessionId: m.claudeSessionId,
+                            message: 'Copilot conversation/session mismatch. Reopen the intended conversation.' });
+                        break;
+                    }
                     rebindCopilotConversation(m.claudeSessionId, convId);
                 }
                 // Create a copilot placeholder so follow-up chats auto-resume
                 if (convId) {
-                    createCopilotPlaceholder(convId, { providerId: m.providerId || 'copilot' });
+                    createCopilotPlaceholder(convId, { providerId: resumeProviderId });
                     const placeholder = getCopilotConversation(convId);
                     if (placeholder) {
+                        placeholder.providerId = resumeProviderId;
                         placeholder.copilotSessionId = m.claudeSessionId;
                         placeholder.workDir = resolvedWorkDir;
                     }
                 }
                 const history = readCopilotSessionMessages(resolvedWorkDir, m.claudeSessionId);
+                const persistedCopilotMode = readCopilotSessionMode(m.claudeSessionId);
+                const persistedCopilotUsage = readCopilotSessionUsage(m.claudeSessionId);
                 // Check if this session has an active copilot process running
                 const copilotState = getCopilotConversation(convId || '');
-                const isCopilotProcessing = !!(copilotState?.turnActive && copilotState?.child);
+                // A live persistent Runtime can be newer than events.jsonl while the
+                // Provider is flushing its final usage checkpoint. Do not replace its
+                // authoritative in-memory value merely because the page was reopened.
+                const restoredCopilotUsage = copilotState?.lastUsage || persistedCopilotUsage;
+                const isCopilotProcessing = !!copilotState?.turnActive;
+                if (copilotState && !isCopilotProcessing) {
+                    copilotState.copilotMode = persistedCopilotMode;
+                    copilotState.planMode = persistedCopilotMode === 'plan';
+                    copilotState.planModePending = persistedCopilotMode === 'plan';
+                    copilotState.lastUsage = restoredCopilotUsage;
+                    copilotState.configuration = restoredCopilotUsage?.configuration;
+                    copilotState.model = restoredCopilotUsage?.configuration?.requested.model || restoredCopilotUsage?.model || null;
+                    const requestedContext = restoredCopilotUsage?.configuration?.requested.context || restoredCopilotUsage?.contextTier;
+                    const requestedEffort = restoredCopilotUsage?.configuration?.requested.effort || restoredCopilotUsage?.reasoningEffort;
+                    copilotState.contextTier = requestedContext === 'default' || requestedContext === 'long_context'
+                        ? requestedContext
+                        : null;
+                    copilotState.reasoningEffort = [
+                        'none', 'low', 'medium', 'high', 'xhigh', 'max',
+                    ].includes(requestedEffort || '')
+                        ? requestedEffort
+                        : null;
+                    copilotState.autoCompactionPending = !!restoredCopilotUsage
+                        && Number.isFinite(restoredCopilotUsage.contextTokens)
+                        && Number.isFinite(restoredCopilotUsage.contextWindow)
+                        && Number(restoredCopilotUsage.contextWindow) > 0
+                        && Number(restoredCopilotUsage.contextTokens) / Number(restoredCopilotUsage.contextWindow) >= COPILOT_COMPACTION_POLICY.preRequest;
+                }
                 console.log(`[AgentLink] → conversation_resumed (${history.length} copilot messages, session ${m.claudeSessionId.slice(0, 8)})`);
                 send({
                     type: 'conversation_resumed',
                     conversationId: convId,
                     claudeSessionId: m.claudeSessionId,
                     history,
-                    isCompacting: false,
+                    isCompacting: copilotState?.isCompacting || false,
+                    compactions: [...(copilotState?.compactionRecords?.values() || [])].slice(-8),
                     isProcessing: isCopilotProcessing,
-                    planMode: false,
+                    turnId: copilotState?.turnId,
+                    stateVersion: copilotState?.stateVersion,
+                    planMode: copilotState?.planMode ?? (persistedCopilotMode === 'plan'),
+                    copilotMode: copilotState?.copilotMode || persistedCopilotMode,
                     permissionMode: 'normal',
                     workDir: resolvedWorkDir,
+                    providerId: resumeProviderId,
+                    ...(restoredCopilotUsage ? { usage: restoredCopilotUsage } : {}),
                     ...(typeof m.scrollToMessageIdx === 'number' ? { scrollToMessageIdx: m.scrollToMessageIdx } : {}),
                     ...(m.searchQuery ? { searchQuery: m.searchQuery } : {}),
                 });
+                // Seed the resolved history Provider's offline capabilities without
+                // creating a metadata Runtime just because history was opened.
+                send({ type: 'backend_info', conversationId: convId, backend: 'copilot', providerId: resumeProviderId,
+                    capabilities: capabilitiesForBackend('copilot', resumeProviderId) });
+                if (convId && isCopilotProcessing) {
+                    for (const pending of getPendingCopilotDecisions(convId)) {
+                        send({
+                            type: 'backend_event',
+                            conversationId: convId,
+                            providerId: pending.providerId,
+                            claudeSessionId: pending.sessionId,
+                            turnId: copilotState?.turnId,
+                            stateVersion: copilotState?.stateVersion,
+                            event: {
+                                type: 'user_input_requested',
+                                session: { backendType: 'copilot', backendSessionId: pending.sessionId },
+                                requestId: pending.requestId,
+                                request: pending.request,
+                            },
+                        });
+                    }
+                }
                 break;
             }
             if (!convId) {
@@ -1553,10 +1685,22 @@ function handleServerMessage(msg) {
         }
         case 'ask_user_answer': {
             const m = msg;
-            if (isYeaftBackend())
+            const copilotConversation = m.conversationId
+                ? getCopilotConversation(m.conversationId)
+                : undefined;
+            if (copilotConversation
+                || (m.providerId && getBackendTypeForProvider(m.providerId) === 'copilot')) {
+                handleCopilotUserAnswer(m.requestId, m.answers, {
+                    conversationId: m.conversationId,
+                    providerId: m.providerId,
+                });
+            }
+            else if (isYeaftBackend()) {
                 handleYeaftUserAnswer(m.requestId, m.answers, { conversationId: m.conversationId });
-            else
+            }
+            else {
                 handleUserAnswer(m.requestId, m.answers);
+            }
             break;
         }
         case 'delete_session': {
@@ -1621,9 +1765,19 @@ function handleServerMessage(msg) {
                 handleListCodexSessionsFn(dir);
             }
             else if (sessionBackend === 'copilot') {
-                const ok = deleteCopilotSession(dir, m.sessionId);
-                console.log(`[AgentLink] delete copilot session ${m.sessionId}: ${ok}`);
-                handleListCopilotSessionsFn(dir);
+                void deleteCopilotSession(dir, m.sessionId).then(ok => {
+                    console.log(`[AgentLink] delete copilot session ${m.sessionId}: ${ok}`);
+                    if (ok)
+                        send({ type: 'session_deleted', sessionId: m.sessionId, providerId: m.providerId, workDir: dir });
+                    else
+                        send({ type: 'error', operation: 'delete_session', sessionId: m.sessionId,
+                            message: 'Session not found or could not be deleted.' });
+                    handleListCopilotSessionsFn(dir);
+                }).catch(error => {
+                    send({ type: 'error', operation: 'delete_session', sessionId: m.sessionId,
+                        message: String(error.message || error) });
+                    handleListCopilotSessionsFn(dir);
+                });
             }
             else {
                 handleDeleteSession(m.sessionId, dir);
@@ -1856,10 +2010,12 @@ function handleServerMessage(msg) {
                 const sessionId = conv.claudeSessionId ?? conv.copilotSessionId ?? conv.codexSessionId ?? conv.yeaftSessionId ?? conv.piSessionId ?? null;
                 if (conv.turnActive) {
                     active.push({
+                        providerId: conv.providerId, workDir: conv.workDir,
                         conversationId: convId,
                         claudeSessionId: sessionId,
                         isProcessing: true,
                         isCompacting: !!conv.isCompacting,
+                        ...(conv.compactionRecords ? { compactions: [...conv.compactionRecords.values()].slice(-8) } : {}),
                         turnId: conv.turnId,
                         stateVersion: conv.stateVersion,
                     });
@@ -1868,12 +2024,14 @@ function handleServerMessage(msg) {
                     // Include idle but resumable conversations so other tabs can
                     // learn the backend session ID for multi-device continuity.
                     active.push({
+                        providerId: conv.providerId, workDir: conv.workDir,
                         conversationId: convId,
                         claudeSessionId: sessionId,
                         isProcessing: false,
                         isCompacting: false,
                         turnId: conv.turnId,
                         stateVersion: conv.stateVersion,
+                        ...(conv.compactionRecords ? { compactions: [...conv.compactionRecords.values()].slice(-8) } : {}),
                     });
                 }
             };
@@ -1917,12 +2075,14 @@ function handleServerMessage(msg) {
                 const status = isProc ? (isComp ? 'compacting' : 'processing') : 'idle';
                 return {
                     type: 'turn_status',
+                    providerId: conv.providerId, workDir: conv.workDir,
                     conversationId: convId,
                     claudeSessionId: conv.claudeSessionId ?? conv.copilotSessionId ?? conv.codexSessionId ?? conv.yeaftSessionId ?? conv.piSessionId ?? null,
                     turnId: conv.turnId,
                     status,
                     isProcessing: isProc,
                     isCompacting: isComp,
+                    ...(conv.compactionRecords ? { compactions: [...conv.compactionRecords.values()].slice(-8) } : {}),
                     stateVersion: conv.stateVersion,
                 };
             };
@@ -2114,8 +2274,26 @@ function handleServerMessage(msg) {
             break;
         }
         case 'set_plan_mode': {
-            const { enabled, conversationId } = msg;
+            const { enabled, conversationId, providerId, workDir, copilotOptions, resumeSessionId } = msg;
             console.log(`[AgentLink] set_plan_mode: enabled=${enabled}, conversationId=${conversationId}`);
+            const copilotConversation = conversationId
+                ? getCopilotConversation(conversationId)
+                : undefined;
+            const effectiveProviderId = providerId || copilotConversation?.providerId;
+            if (conversationId
+                && (copilotConversation
+                    || (effectiveProviderId && getBackendTypeForProvider(effectiveProviderId) === 'copilot')
+                    || isCopilotBackend())) {
+                void setCopilotPlanMode(conversationId, enabled, path.resolve(workDir || copilotConversation?.workDir || state.workDir), effectiveProviderId || 'copilot', copilotOptions, resumeSessionId).catch(error => {
+                    send({
+                        type: 'error',
+                        conversationId,
+                        message: error instanceof Error ? error.message : String(error),
+                    });
+                    send({ type: 'plan_mode_changed', enabled: !enabled, conversationId });
+                });
+                break;
+            }
             const conv = getConversation(conversationId);
             if (conv) {
                 // Restart with new mode
@@ -2131,6 +2309,34 @@ function handleServerMessage(msg) {
             send({ type: 'plan_mode_changed', enabled, conversationId });
             break;
         }
+        case 'start_plan_implementation': {
+            const { conversationId, planId, providerId, workDir, claudeSessionId, prompt, copilotOptions } = msg;
+            if (!conversationId || !planId) {
+                send({ type: 'error', conversationId, message: 'Invalid Plan implementation request' });
+                break;
+            }
+            void startCopilotPlanImplementation(conversationId, planId, path.resolve(workDir || state.workDir), { providerId, resumeSessionId: claudeSessionId, prompt, copilotOptions }).catch(error => {
+                send({
+                    type: 'backend_event',
+                    conversationId,
+                    providerId,
+                    claudeSessionId,
+                    event: {
+                        type: 'plan_implementation_status',
+                        session: { backendType: 'copilot', backendSessionId: claudeSessionId || '' },
+                        planId,
+                        status: 'failed',
+                        message: error instanceof Error ? error.message : String(error),
+                    },
+                });
+                send({
+                    type: 'error',
+                    conversationId,
+                    message: error instanceof Error ? error.message : String(error),
+                });
+            });
+            break;
+        }
         case 'set_permission_mode': {
             const { mode, conversationId } = msg;
             console.log(`[AgentLink] set_permission_mode: mode=${mode}, conversationId=${conversationId}`);
@@ -2189,7 +2395,7 @@ function handleServerMessage(msg) {
             break;
         }
         case 'set_provider': {
-            const { providerId, conversationId } = msg;
+            let { providerId, conversationId, resumeSessionId, workDir, restoreOnly } = msg;
             console.log(`[AgentLink] set_provider: providerId=${providerId}, conversationId=${conversationId}`);
             // Detect backend type change
             const newBackendType = getBackendTypeForProvider(providerId);
@@ -2202,6 +2408,9 @@ function handleServerMessage(msg) {
                 // are routed to background via the web's backgroundRouting handler.
                 setBackendType(newBackendType);
                 console.log(`[AgentLink] Backend switched: ${oldBackendType} → ${newBackendType}`);
+                if (newBackendType === 'copilot' && conversationId) {
+                    providerId = setCopilotProvider(conversationId, providerId, { resumeSessionId, workDir, restoreOnly });
+                }
             }
             else if (oldBackendType === 'yeaft') {
                 const existingYeaftConv = conversationId ? getYeaftConversation(conversationId) : undefined;
@@ -2250,19 +2459,8 @@ function handleServerMessage(msg) {
             else if (oldBackendType === 'copilot') {
                 // Same backend (copilot): provider sync during reconnect must not
                 // restart an active subprocess.
-                const existingCopilotConv = conversationId ? getCopilotConversation(conversationId) : undefined;
-                if (existingCopilotConv?.turnActive) {
-                    existingCopilotConv.providerId = providerId;
-                }
-                else if (conversationId && existingCopilotConv) {
-                    const result = restartCopilotConversation(conversationId, { providerId });
-                    if (result.wasTurnActive) {
-                        send({ type: 'execution_cancelled', conversationId });
-                    }
-                }
-                else if (conversationId) {
-                    createCopilotPlaceholder(conversationId, { providerId });
-                }
+                if (conversationId)
+                    providerId = setCopilotProvider(conversationId, providerId, { resumeSessionId, workDir, restoreOnly });
             }
             else {
                 // Same backend (claude): reconnect provider sync must not interrupt
@@ -2281,7 +2479,7 @@ function handleServerMessage(msg) {
                     createPlaceholderConversation(conversationId, { providerId });
                 }
             }
-            send({ type: 'provider_changed', providerId, conversationId });
+            send({ type: 'provider_changed', providerId, conversationId, ...(restoreOnly ? { restoreOnly: true } : {}) });
             // Capabilities are provider-scoped: wrappers and custom providers can
             // share a backend while exposing different command discovery behavior.
             send({
@@ -2847,18 +3045,24 @@ async function handleListSessions(dir, options = {}) {
         });
     }
 }
-function handleListCopilotSessionsFn(dir, options = {}) {
+async function handleListCopilotSessionsFn(dir, options = {}) {
+    const requestSocket = state.ws;
+    const backend = getBackendType();
+    const stillCurrent = () => state.ws === requestSocket && (!!options.providerId || getBackendType() === backend);
+    const startedAt = performance.now();
     try {
         const page = options.legacy
-            ? { ...listCopilotSessionsPage(dir, { limit: Number.POSITIVE_INFINITY }), hasMore: false }
-            : listCopilotSessionsPage(dir, {
+            ? { ...await listCopilotSessionsPageAsync(dir, { limit: Number.POSITIVE_INFINITY }), hasMore: false }
+            : await listCopilotSessionsPageAsync(dir, {
                 limit: options.limit ?? DEFAULT_SESSION_LIST_LIMIT,
                 cursor: options.cursor,
             });
         if (options.legacy && page.sessions.length > LEGACY_SESSION_LIST_CAP) {
             page.sessions = page.sessions.slice(0, LEGACY_SESSION_LIST_CAP);
         }
-        console.log(`[AgentLink] → sessions_list (${page.sessions.length} copilot sessions for ${dir}) hasMore=${page.hasMore}`);
+        if (!stillCurrent())
+            return;
+        console.log(`[AgentLink] → sessions_list (${page.sessions.length} copilot sessions for ${dir}) hasMore=${page.hasMore} durationMs=${Math.round(performance.now() - startedAt)}`);
         send({
             type: 'sessions_list',
             sessions: page.sessions,
@@ -2869,10 +3073,12 @@ function handleListCopilotSessionsFn(dir, options = {}) {
             ...(options.mode ? { mode: options.mode } : {}),
             ...(options.requestId ? { requestId: options.requestId } : {}),
             ...(options.providerId ? { providerId: options.providerId } : {}),
-        });
+        }, requestSocket);
     }
     catch (err) {
         console.error(`[AgentLink] listCopilotSessions failed:`, err);
+        if (!stillCurrent())
+            return;
         send({
             type: 'sessions_list',
             sessions: [],
@@ -2883,7 +3089,32 @@ function handleListCopilotSessionsFn(dir, options = {}) {
             ...(options.mode ? { mode: options.mode } : {}),
             ...(options.requestId ? { requestId: options.requestId } : {}),
             ...(options.providerId ? { providerId: options.providerId } : {}),
-        });
+        }, requestSocket);
+    }
+}
+async function handleListRecentCopilotSessions(options) {
+    const requestSocket = state.ws;
+    const backend = getBackendType();
+    const stillCurrent = () => state.ws === requestSocket && (!!options.providerId || getBackendType() === backend);
+    const envelope = {
+        type: 'recent_sessions_list',
+        ...(options.mode ? { mode: options.mode } : {}),
+        ...(options.requestId ? { requestId: options.requestId } : {}),
+        ...(options.providerId ? { providerId: options.providerId } : {}),
+    };
+    const startedAt = performance.now();
+    try {
+        const page = await listAllCopilotSessionsPageAsync({ limit: options.limit, cursor: options.cursor });
+        if (!stillCurrent())
+            return;
+        console.log(`[AgentLink] → recent_sessions_list (${page.sessions.length} copilot sessions) hasMore=${page.hasMore} durationMs=${Math.round(performance.now() - startedAt)}`);
+        send({ ...envelope, ...page }, requestSocket);
+    }
+    catch (error) {
+        console.error('[AgentLink] listAllCopilotSessions failed:', error);
+        if (stillCurrent())
+            send({ ...envelope, sessions: [], hasMore: false, indexState: 'ready',
+                error: error instanceof Error ? error.message : String(error) }, requestSocket);
     }
 }
 function handleListCodexSessionsFn(dir, options = {}) {