linkshell-cli 0.3.13 → 0.3.15

package/dist/cli/src/runtime/acp/agent-workspace.js

@@ -13,9 +13,43 @@ const PERMISSION_TIMEOUT_MS = 5 * 60_000;
 const MAX_TIMELINE_ITEMS = 200;
 const MAX_SNAPSHOT_ITEMS = 80;
 const MAX_SNAPSHOT_TEXT_BYTES = 128 * 1024;
+const MAX_DELTA_EVENTS = 500;
+const HISTORY_PAGE_MAX_ITEMS = 500;
 function id(prefix) {
     return `${prefix}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
 }
+function clampHistoryCursor(value, fallback, max) {
+    if (!value)
+        return fallback;
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed))
+        return fallback;
+    return Math.max(0, Math.min(max, parsed));
+}
+function appServerText(value) {
+    if (typeof value === "string") {
+        const text = value.trim();
+        return text || undefined;
+    }
+    if (Array.isArray(value)) {
+        const text = value
+            .map((part) => appServerText(part))
+            .filter(Boolean)
+            .join("\n")
+            .trim();
+        return text || undefined;
+    }
+    const record = asRecord(value);
+    if (!record)
+        return undefined;
+    if (typeof record.text === "string")
+        return appServerText(record.text);
+    if (typeof record.content === "string")
+        return appServerText(record.content);
+    if (typeof record.message === "string")
+        return appServerText(record.message);
+    return appServerText(record.content ?? record.message ?? record.parts);
+}
 function stringify(value) {
     if (typeof value === "string")
         return value;
@@ -1119,15 +1153,33 @@ function parseRemoteSessions(value) {
             createdAt: parseTimestamp(source.createdAt ?? source.created_at),
             lastActivityAt: parseTimestamp(source.lastActivityAt ?? source.updatedAt ?? source.modifiedAt ?? source.lastModified ?? source.updated_at),
             archived: typeof source.archived === "boolean" ? source.archived : undefined,
+            status: normalizeAgentStatus(firstString(source, ["status", "state", "phase"])),
+            runningTurnId: firstString(source, ["runningTurnId", "running_turn_id", "turnId", "activeTurnId"]),
         });
     }
     return result;
 }
+function normalizeAgentStatus(value) {
+    if (!value)
+        return undefined;
+    const normalized = value.toLowerCase();
+    if (normalized === "running" || normalized === "in_progress" || normalized === "busy")
+        return "running";
+    if (normalized === "waiting_permission" || normalized === "waiting" || normalized === "blocked")
+        return "waiting_permission";
+    if (normalized === "error" || normalized === "failed")
+        return "error";
+    if (normalized === "idle" || normalized === "completed" || normalized === "done")
+        return "idle";
+    return undefined;
+}
 export class AgentWorkspaceProxy {
     input;
     clients = new Map();
     agentProtocols = new Map();
     providerCapabilities = new Map();
+    providerCapabilityErrors = new Map();
+    capabilitiesRevision = 0;
     initialized = false;
     status = "unavailable";
     error;
@@ -1137,6 +1189,8 @@ export class AgentWorkspaceProxy {
     conversations = new Map();
     conversationByAgentSessionId = new Map();
     timelines = new Map();
+    conversationRevisions = new Map();
+    revisionEvents = new Map();
     toolOutputBuffers = new Map();
     pendingPermissions = new Map();
     permissionWaiters = new Map();
@@ -1166,7 +1220,7 @@ export class AgentWorkspaceProxy {
                 this.input.send(createEnvelope({
                     type: "agent.v2.conversation.list.result",
                     hostDeviceId: this.input.hostDeviceId,
-                    payload: { conversations },
+                    payload: { conversations: conversations.map((conversation) => this.conversationSnapshot(conversation)) },
                 }));
                 break;
             }
@@ -1175,6 +1229,16 @@ export class AgentWorkspaceProxy {
                 this.sendSnapshot(payload.conversationId);
                 break;
             }
+            case "agent.v2.history.request": {
+                const payload = parseTypedPayload("agent.v2.history.request", envelope.payload);
+                await this.sendHistoryPage(payload);
+                break;
+            }
+            case "agent.v2.delta.request": {
+                const payload = parseTypedPayload("agent.v2.delta.request", envelope.payload);
+                this.sendDelta(payload);
+                break;
+            }
             case "agent.v2.prompt": {
                 const payload = parseTypedPayload("agent.v2.prompt", envelope.payload);
                 await this.sendPrompt(payload);
@@ -1334,10 +1398,13 @@ export class AgentWorkspaceProxy {
         try {
             const result = await listModels.call(client);
             const runtimeCapabilities = parseModelListCapabilities(result);
-            if (runtimeCapabilities)
+            if (runtimeCapabilities) {
                 this.providerCapabilities.set(provider, runtimeCapabilities);
+                this.providerCapabilityErrors.delete(provider);
+            }
         }
         catch (error) {
+            this.providerCapabilityErrors.set(provider, error instanceof Error ? error.message : String(error));
             if (this.input.verbose) {
                 process.stderr.write(`[agent:v2] model/list failed for ${provider}: ${error instanceof Error ? error.message : String(error)}\n`);
             }
@@ -1377,14 +1444,21 @@ export class AgentWorkspaceProxy {
                 reasoningEffort: existing?.reasoningEffort,
                 permissionMode: existing?.permissionMode,
                 collaborationMode: existing?.collaborationMode,
-                status: existing?.status ?? "idle",
+                status: remote.status ?? existing?.status ?? "idle",
                 archived: remote.archived ?? existing?.archived ?? false,
+                timelineRevision: existing?.timelineRevision ?? this.getRevision(conversationId),
+                historyComplete: existing?.historyComplete ?? false,
+                runningTurnId: remote.runningTurnId ?? this.currentTurnIds.get(conversationId),
+                source: "device",
+                canonical: true,
                 lastMessagePreview: existing?.lastMessagePreview,
                 lastActivityAt: remote.lastActivityAt ?? existing?.lastActivityAt ?? now,
                 createdAt: remote.createdAt ?? existing?.createdAt ?? now,
             };
             this.conversations.set(conversation.id, conversation);
             this.conversationByAgentSessionId.set(agentSessionId, conversation.id);
+            if (remote.runningTurnId)
+                this.rememberTurnConversationId(conversation.id, remote.runningTurnId);
             this.timelines.set(conversation.id, this.timelines.get(conversation.id) ?? []);
         }
     }
@@ -1394,6 +1468,7 @@ export class AgentWorkspaceProxy {
             const protocol = this.agentProtocols.get(provider);
             const runtimeCapabilities = this.providerCapabilities.get(provider);
             const enabled = Boolean(client);
+            const hasRuntimeModels = Boolean(runtimeCapabilities?.models?.length);
             const supportsImages = enabled && protocolSupportsImages(protocol);
             const isClaudeFallback = protocol === "claude-stream-json";
             const supportsPermission = enabled && !isClaudeFallback;
@@ -1405,12 +1480,15 @@ export class AgentWorkspaceProxy {
                 label: providerLabel(provider),
                 enabled,
                 reason: enabled ? undefined : `${providerLabel(provider)} 未安装或启动失败`,
+                providerProtocol: protocol,
                 supportsImages,
                 supportsPermission,
                 supportsPlan: enabled,
                 supportsCancel: enabled,
                 models: runtimeCapabilities?.models ?? [{ id: "default", label: "默认模型" }],
                 defaultModel: runtimeCapabilities?.defaultModel,
+                modelsSource: hasRuntimeModels ? "runtime" : enabled ? "fallback" : "unavailable",
+                modelListError: this.providerCapabilityErrors.get(provider),
                 reasoningEfforts: supportsReasoningEffort
                     ? runtimeCapabilities?.reasoningEfforts ?? (provider === "claude" ? [...CLAUDE_REASONING_EFFORTS] : [...ALL_REASONING_EFFORTS])
                     : [],
@@ -1439,6 +1517,7 @@ export class AgentWorkspaceProxy {
                 providers,
                 protocolVersion: 1,
                 workspaceProtocolVersion: 2,
+                capabilitiesRevision: ++this.capabilitiesRevision,
                 error: anyEnabled ? undefined : "没有可用的 Agent provider。请安装 Claude Code 或 Codex CLI。",
                 supportsSessionList: anyEnabled,
                 supportsSessionLoad: anyEnabled,
@@ -1462,12 +1541,18 @@ export class AgentWorkspaceProxy {
             }
             this.hydrateStoredTimeline(existingConversation);
             this.activeConversationId = existingConversation.id;
+            const snapshot = this.latestSnapshot(existingConversation.id);
             this.input.send(createEnvelope({
                 type: "agent.v2.conversation.opened",
                 hostDeviceId: this.input.hostDeviceId,
                 payload: {
-                    conversation: existingConversation,
-                    snapshot: snapshotTimelineItems(this.timelines.get(existingConversation.id) ?? []),
+                    conversation: this.conversationSnapshot(existingConversation),
+                    snapshot: snapshot.items,
+                    revision: this.getRevision(existingConversation.id),
+                    cursor: snapshot.cursor,
+                    hasMore: snapshot.hasMore,
+                    source: "device-history",
+                    canonical: true,
                 },
             }));
             return existingConversation;
@@ -1502,6 +1587,11 @@ export class AgentWorkspaceProxy {
                 collaborationMode: payload.collaborationMode ?? existingConversation?.collaborationMode,
                 status: "idle",
                 archived: existingConversation?.archived ?? false,
+                timelineRevision: existingConversation?.timelineRevision ?? this.getRevision(conversationId),
+                historyComplete: existingConversation?.historyComplete ?? false,
+                runningTurnId: this.currentTurnIds.get(conversationId),
+                source: "device",
+                canonical: true,
                 lastMessagePreview: existingConversation?.status === "error" ? undefined : existingConversation?.lastMessagePreview,
                 lastActivityAt: now,
                 createdAt: existingConversation?.createdAt ?? now,
@@ -1511,10 +1601,19 @@ export class AgentWorkspaceProxy {
             this.activeConversationId = conversation.id;
             this.timelines.set(conversation.id, this.timelines.get(conversation.id) ?? []);
             this.hydrateStoredTimeline(conversation);
+            const snapshot = this.latestSnapshot(conversation.id);
             this.input.send(createEnvelope({
                 type: "agent.v2.conversation.opened",
                 hostDeviceId: this.input.hostDeviceId,
-                payload: { conversation, snapshot: snapshotTimelineItems(this.timelines.get(conversation.id) ?? []) },
+                payload: {
+                    conversation: this.conversationSnapshot(conversation),
+                    snapshot: snapshot.items,
+                    revision: this.getRevision(conversation.id),
+                    cursor: snapshot.cursor,
+                    hasMore: snapshot.hasMore,
+                    source: "device-history",
+                    canonical: true,
+                },
             }));
             return conversation;
         }
@@ -1537,6 +1636,10 @@ export class AgentWorkspaceProxy {
             collaborationMode: payload.collaborationMode,
             status: "error",
             archived: false,
+            timelineRevision: this.getRevision(fallbackId),
+            historyComplete: false,
+            source: "device",
+            canonical: true,
             lastMessagePreview: message,
             lastActivityAt: now,
             createdAt: now,
@@ -1553,7 +1656,14 @@ export class AgentWorkspaceProxy {
         this.input.send(createEnvelope({
             type: "agent.v2.conversation.opened",
             hostDeviceId: this.input.hostDeviceId,
-            payload: { conversation, snapshot: snapshotTimelineItems(this.timelines.get(conversation.id) ?? []) },
+            payload: {
+                conversation: this.conversationSnapshot(conversation),
+                snapshot: snapshotTimelineItems(this.timelines.get(conversation.id) ?? []),
+                revision: this.getRevision(conversation.id),
+                hasMore: false,
+                source: "device",
+                canonical: true,
+            },
         }));
         return conversation;
     }
@@ -2510,6 +2620,14 @@ export class AgentWorkspaceProxy {
                 this.permissionWaiters.delete(requestId);
                 this.permissionSources.delete(requestId);
                 resolve(formatPermissionResponse(source, "cancelled", "cancelled"));
+                this.markPermission(conversationId, requestId, {
+                    permissionOutcome: "cancelled",
+                    optionId: "cancelled",
+                    permissionLive: false,
+                    permissionPending: false,
+                    permissionExpired: true,
+                    permissionError: "等待授权超时",
+                });
                 this.updateConversationStatus(conversationId, "idle");
             }, PERMISSION_TIMEOUT_MS);
             this.permissionWaiters.set(requestId, { resolve, timer });
@@ -2539,6 +2657,8 @@ export class AgentWorkspaceProxy {
         this.markPermission(payload.conversationId, payload.requestId, {
             permissionOutcome: payload.outcome,
             optionId: selectedOptionId,
+            permissionLive: false,
+            permissionExpired: false,
             permissionError: undefined,
             permissionPending: false,
         });
@@ -2585,6 +2705,209 @@ export class AgentWorkspaceProxy {
             updatedAt: Date.now(),
         });
     }
+    getRevision(conversationId) {
+        return this.conversationRevisions.get(conversationId) ??
+            this.conversations.get(conversationId)?.timelineRevision ??
+            0;
+    }
+    setRevisionFloor(conversationId, revision) {
+        const nextRevision = Math.max(this.getRevision(conversationId), revision);
+        this.conversationRevisions.set(conversationId, nextRevision);
+        const conversation = this.conversations.get(conversationId);
+        if (conversation) {
+            conversation.timelineRevision = nextRevision;
+            conversation.runningTurnId = this.currentTurnIds.get(conversationId);
+        }
+        return nextRevision;
+    }
+    conversationSnapshot(conversation) {
+        return {
+            ...conversation,
+            timelineRevision: this.getRevision(conversation.id),
+            historyComplete: conversation.historyComplete ?? false,
+            runningTurnId: this.currentTurnIds.get(conversation.id),
+            source: conversation.source ?? "device",
+            canonical: conversation.canonical ?? true,
+        };
+    }
+    annotateTimelineItem(item, revision, source) {
+        return {
+            ...item,
+            revision: revision ?? item.revision,
+            source: item.source ?? source,
+            canonical: item.canonical ?? true,
+        };
+    }
+    recordRevisionEvent(conversationId, change) {
+        const revision = this.getRevision(conversationId) + 1;
+        this.conversationRevisions.set(conversationId, revision);
+        const conversation = this.conversations.get(conversationId);
+        if (conversation) {
+            conversation.timelineRevision = revision;
+            conversation.runningTurnId = this.currentTurnIds.get(conversationId);
+        }
+        const event = {
+            revision,
+            item: change.item ? this.annotateTimelineItem(change.item, revision, "device-live") : undefined,
+            conversation: change.conversation ? this.conversationSnapshot(change.conversation) : undefined,
+        };
+        const events = this.revisionEvents.get(conversationId) ?? [];
+        events.push(event);
+        if (events.length > MAX_DELTA_EVENTS) {
+            events.splice(0, events.length - MAX_DELTA_EVENTS);
+        }
+        this.revisionEvents.set(conversationId, events);
+        return event;
+    }
+    storedTimeline(conversation, maxItems = HISTORY_PAGE_MAX_ITEMS) {
+        if (!conversation.agentSessionId)
+            return [];
+        const result = conversation.provider === "codex"
+            ? loadCodexStoredTimeline(conversation.agentSessionId, conversation.id, conversation.cwd || this.input.cwd, { maxItems })
+            : conversation.provider === "claude"
+                ? loadClaudeStoredTimeline(conversation.agentSessionId, conversation.id, { maxItems })
+                : { items: [] };
+        return result.items
+            .sort((a, b) => a.createdAt - b.createdAt)
+            .map((item, index) => this.annotateTimelineItem(item, index + 1, "device-history"));
+    }
+    canonicalTimeline(conversation, maxItems = HISTORY_PAGE_MAX_ITEMS) {
+        const merged = new Map();
+        for (const item of this.storedTimeline(conversation, maxItems)) {
+            merged.set(item.id, item);
+        }
+        for (const item of this.timelines.get(conversation.id) ?? []) {
+            merged.set(item.id, this.annotateTimelineItem(item, item.revision, item.source ?? "device-live"));
+        }
+        const items = [...merged.values()]
+            .sort((a, b) => a.createdAt - b.createdAt)
+            .slice(-maxItems);
+        this.setRevisionFloor(conversation.id, Math.max(this.getRevision(conversation.id), items.length));
+        return items;
+    }
+    async appServerTimeline(conversation, maxItems = HISTORY_PAGE_MAX_ITEMS) {
+        if (conversation.provider !== "codex" || !conversation.agentSessionId)
+            return [];
+        if (this.protocolForProvider(conversation.provider) !== "codex-app-server")
+            return [];
+        const client = this.clientForProvider(conversation.provider);
+        const listTurns = client?.listTurns;
+        if (typeof listTurns !== "function")
+            return [];
+        try {
+            const result = await listTurns.call(client, { sessionId: conversation.agentSessionId, limit: maxItems });
+            return this.timelineFromAppServerTurns(conversation.id, conversation.agentSessionId, result);
+        }
+        catch (error) {
+            if (this.input.verbose) {
+                process.stderr.write(`[agent:v2] thread/turns/list failed: ${error instanceof Error ? error.message : String(error)}\n`);
+            }
+            return [];
+        }
+    }
+    timelineFromAppServerTurns(conversationId, agentSessionId, value) {
+        const raw = asRecord(value);
+        const turns = Array.isArray(value) ? value :
+            Array.isArray(raw?.turns) ? raw.turns :
+                Array.isArray(raw?.items) ? raw.items :
+                    Array.isArray(raw?.entries) ? raw.entries :
+                        [];
+        const items = [];
+        turns.forEach((entry, index) => {
+            const turn = asRecord(entry);
+            if (!turn)
+                return;
+            const turnId = firstString(turn, ["id", "turnId", "turn_id"]) ?? `turn-${index + 1}`;
+            const createdAt = parseTimestamp(turn.createdAt ?? turn.created_at ?? turn.startedAt ?? turn.started_at) ?? Date.now() + index;
+            const updatedAt = parseTimestamp(turn.updatedAt ?? turn.updated_at ?? turn.completedAt ?? turn.completed_at);
+            const userText = appServerText(turn.input ?? turn.prompt ?? turn.user ?? turn.userMessage ?? turn.request);
+            if (userText) {
+                items.push({
+                    id: `app-server:${agentSessionId}:${turnId}:user`,
+                    conversationId,
+                    type: "message",
+                    kind: "chat",
+                    turnId,
+                    role: "user",
+                    content: [{ type: "text", text: userText }],
+                    text: userText,
+                    createdAt,
+                    updatedAt,
+                    metadata: { source: "app-server", provider: "codex" },
+                });
+            }
+            const assistantText = appServerText(turn.output ?? turn.response ?? turn.assistant ?? turn.assistantMessage ?? turn.result);
+            if (assistantText) {
+                items.push({
+                    id: `app-server:${agentSessionId}:${turnId}:assistant`,
+                    conversationId,
+                    type: "message",
+                    kind: "chat",
+                    turnId,
+                    role: "assistant",
+                    content: [{ type: "text", text: assistantText }],
+                    text: assistantText,
+                    createdAt: updatedAt ?? createdAt + 1,
+                    updatedAt,
+                    metadata: { source: "app-server", provider: "codex" },
+                });
+            }
+            const nestedItems = Array.isArray(turn.items) ? turn.items : Array.isArray(turn.messages) ? turn.messages : [];
+            for (const nested of nestedItems) {
+                const nestedRecord = asRecord(nested);
+                if (!nestedRecord)
+                    continue;
+                const text = appServerText(nestedRecord.content ?? nestedRecord.text ?? nestedRecord.message);
+                const role = nestedRecord.role === "user" || nestedRecord.role === "assistant" || nestedRecord.role === "system"
+                    ? nestedRecord.role
+                    : undefined;
+                if (!text || !role)
+                    continue;
+                const itemId = firstString(nestedRecord, ["id", "itemId", "messageId"]) ?? `${role}-${items.length + 1}`;
+                items.push({
+                    id: `app-server:${agentSessionId}:${turnId}:${itemId}`,
+                    conversationId,
+                    type: "message",
+                    kind: "chat",
+                    turnId,
+                    itemId,
+                    role,
+                    content: [{ type: "text", text }],
+                    text,
+                    createdAt: parseTimestamp(nestedRecord.createdAt ?? nestedRecord.created_at) ?? createdAt + items.length,
+                    updatedAt: parseTimestamp(nestedRecord.updatedAt ?? nestedRecord.updated_at),
+                    metadata: { source: "app-server", provider: "codex" },
+                });
+            }
+        });
+        return items
+            .sort((a, b) => a.createdAt - b.createdAt)
+            .map((item, index) => this.annotateTimelineItem(item, index + 1, "app-server"));
+    }
+    mergeCanonicalTimelineItems(items, maxItems) {
+        const byKey = new Map();
+        for (const item of items.sort((a, b) => a.createdAt - b.createdAt)) {
+            const key = item.type === "message" && item.role && item.text
+                ? `${item.role}:${item.text.replace(/\s+/g, " ").trim().slice(0, 500)}`
+                : item.id;
+            const existing = byKey.get(key);
+            if (!existing || item.source === "app-server" || (item.updatedAt ?? item.createdAt) >= (existing.updatedAt ?? existing.createdAt)) {
+                byKey.set(key, item);
+            }
+        }
+        return [...byKey.values()]
+            .sort((a, b) => a.createdAt - b.createdAt)
+            .slice(-maxItems);
+    }
+    latestSnapshot(conversationId) {
+        const timeline = this.timelines.get(conversationId) ?? [];
+        const start = Math.max(0, timeline.length - MAX_SNAPSHOT_ITEMS);
+        return {
+            items: timeline.slice(start).map((item) => snapshotTimelineItem(item)),
+            cursor: start > 0 ? String(start) : undefined,
+            hasMore: start > 0,
+        };
+    }
     addItem(conversationId, item) {
         this.rememberItemConversationId(conversationId, item);
         const timeline = this.timelines.get(conversationId) ?? [];
@@ -2702,6 +3025,17 @@ export class AgentWorkspaceProxy {
         this.timelines.set(newId, [...mergedTimeline.values()]
             .sort((a, b) => a.createdAt - b.createdAt)
             .slice(-MAX_TIMELINE_ITEMS));
+        const oldRevision = this.conversationRevisions.get(oldId) ?? 0;
+        if (oldRevision > 0) {
+            this.conversationRevisions.delete(oldId);
+            this.setRevisionFloor(newId, oldRevision);
+        }
+        const oldEvents = this.revisionEvents.get(oldId);
+        if (oldEvents) {
+            this.revisionEvents.delete(oldId);
+            const existingEvents = this.revisionEvents.get(newId) ?? [];
+            this.revisionEvents.set(newId, [...existingEvents, ...oldEvents].slice(-MAX_DELTA_EVENTS));
+        }
         for (const [agentSessionId, conversationId] of this.conversationByAgentSessionId) {
             if (conversationId === oldId) {
                 this.conversationByAgentSessionId.set(agentSessionId, newId);
@@ -2735,17 +3069,47 @@ export class AgentWorkspaceProxy {
     }
     emitItem(conversationId, item) {
         const conversation = this.conversations.get(conversationId);
+        const itemSnapshot = snapshotTimelineItem(item, { stripImages: false });
+        const event = this.recordRevisionEvent(conversationId, { conversation, item: itemSnapshot });
         this.input.send(createEnvelope({
             type: "agent.v2.event",
             hostDeviceId: this.input.hostDeviceId,
-            payload: { conversationId, conversation, item: snapshotTimelineItem(item, { stripImages: false }) },
+            payload: {
+                conversationId,
+                conversation: event.conversation,
+                item: event.item,
+                revision: event.revision,
+                source: "device-live",
+                canonical: true,
+            },
         }));
     }
     emitConversation(conversation) {
+        const event = this.recordRevisionEvent(conversation.id, { conversation });
         this.input.send(createEnvelope({
             type: "agent.v2.event",
             hostDeviceId: this.input.hostDeviceId,
-            payload: { conversationId: conversation.id, conversation },
+            payload: {
+                conversationId: conversation.id,
+                conversation: event.conversation,
+                revision: event.revision,
+                source: "device-live",
+                canonical: true,
+            },
+        }));
+        this.input.send(createEnvelope({
+            type: "agent.v2.running_state",
+            hostDeviceId: this.input.hostDeviceId,
+            payload: {
+                conversationId: conversation.id,
+                status: conversation.status,
+                runningTurnId: this.currentTurnIds.get(conversation.id),
+                revision: event.revision,
+                error: conversation.status === "error" ? conversation.lastMessagePreview : undefined,
+                updatedAt: conversation.lastActivityAt,
+                source: "device-live",
+                canonical: true,
+            },
         }));
     }
     emitStatus(conversationId, status, text) {
@@ -2789,17 +3153,126 @@ export class AgentWorkspaceProxy {
             if (conversation)
                 this.hydrateStoredTimeline(conversation);
         }
-        const conversations = [...this.conversations.values()];
-        const items = conversationId
-            ? snapshotTimelineItems(this.timelines.get(conversationId) ?? [])
-            : [];
+        const conversations = [...this.conversations.values()].map((conversation) => this.conversationSnapshot(conversation));
+        const snapshot = conversationId ? this.latestSnapshot(conversationId) : { items: [], cursor: undefined, hasMore: false };
         this.input.send(createEnvelope({
             type: "agent.v2.snapshot",
             hostDeviceId: this.input.hostDeviceId,
             payload: {
                 conversations,
                 activeConversationId: this.activeConversationId,
-                items,
+                items: snapshot.items,
+                revision: conversationId ? this.getRevision(conversationId) : undefined,
+                cursor: snapshot.cursor,
+                hasMore: snapshot.hasMore,
+                source: "device-history",
+                canonical: true,
+            },
+        }));
+    }
+    async sendHistoryPage(payload) {
+        const conversation = this.conversations.get(payload.conversationId);
+        if (!conversation)
+            return;
+        const limit = Math.min(Math.max(payload.limit ?? MAX_SNAPSHOT_ITEMS, 1), 200);
+        const items = this.mergeCanonicalTimelineItems([
+            ...this.canonicalTimeline(conversation, HISTORY_PAGE_MAX_ITEMS),
+            ...await this.appServerTimeline(conversation, HISTORY_PAGE_MAX_ITEMS),
+        ], HISTORY_PAGE_MAX_ITEMS);
+        this.timelines.set(conversation.id, items.slice(-MAX_TIMELINE_ITEMS).map((item) => this.annotateTimelineItem(item, item.revision, item.source ?? "device-history")));
+        for (const item of this.timelines.get(conversation.id) ?? []) {
+            this.rememberItemConversationId(conversation.id, item);
+        }
+        const direction = payload.direction ?? "older";
+        let page;
+        let cursor;
+        let hasMore = false;
+        if (direction === "newer") {
+            const start = clampHistoryCursor(payload.cursor, 0, items.length);
+            const end = Math.min(items.length, start + limit);
+            page = items.slice(start, end);
+            hasMore = end < items.length;
+            cursor = hasMore ? String(end) : undefined;
+        }
+        else {
+            const end = clampHistoryCursor(payload.cursor, items.length, items.length);
+            const start = Math.max(0, end - limit);
+            page = items.slice(start, end);
+            hasMore = start > 0;
+            cursor = hasMore ? String(start) : undefined;
+        }
+        conversation.historyComplete = !hasMore;
+        const revision = this.setRevisionFloor(conversation.id, Math.max(this.getRevision(conversation.id), items.length));
+        this.input.send(createEnvelope({
+            type: "agent.v2.history.page",
+            hostDeviceId: this.input.hostDeviceId,
+            payload: {
+                conversationId: conversation.id,
+                conversation: this.conversationSnapshot(conversation),
+                items: page.map((item) => snapshotTimelineItem(item)),
+                revision,
+                cursor,
+                hasMore,
+                source: "device-history",
+                canonical: true,
+            },
+        }));
+    }
+    sendDelta(payload) {
+        const conversation = this.conversations.get(payload.conversationId);
+        if (!conversation)
+            return;
+        this.hydrateStoredTimeline(conversation);
+        const sinceRevision = payload.sinceRevision ?? 0;
+        const limit = Math.min(Math.max(payload.limit ?? 100, 1), 500);
+        const events = this.revisionEvents.get(conversation.id) ?? [];
+        const oldestAvailable = events[0]?.revision ?? this.getRevision(conversation.id);
+        const newestRevision = this.getRevision(conversation.id);
+        const reset = sinceRevision > 0 &&
+            (sinceRevision > newestRevision ||
+                (sinceRevision < newestRevision &&
+                    (events.length === 0 || sinceRevision < oldestAvailable - 1)));
+        if (reset) {
+            const snapshot = this.latestSnapshot(conversation.id);
+            this.input.send(createEnvelope({
+                type: "agent.v2.delta",
+                hostDeviceId: this.input.hostDeviceId,
+                payload: {
+                    conversationId: conversation.id,
+                    conversation: this.conversationSnapshot(conversation),
+                    items: snapshot.items,
+                    sinceRevision,
+                    revision: newestRevision,
+                    reset: true,
+                    cursor: snapshot.cursor,
+                    hasMore: snapshot.hasMore,
+                    source: "device-history",
+                    canonical: true,
+                },
+            }));
+            return;
+        }
+        const changed = events
+            .filter((event) => event.revision > sinceRevision)
+            .slice(-limit);
+        const itemsById = new Map();
+        for (const event of changed) {
+            if (event.item)
+                itemsById.set(event.item.id, event.item);
+        }
+        this.input.send(createEnvelope({
+            type: "agent.v2.delta",
+            hostDeviceId: this.input.hostDeviceId,
+            payload: {
+                conversationId: conversation.id,
+                conversation: this.conversationSnapshot(conversation),
+                items: [...itemsById.values()].map((item) => snapshotTimelineItem(item)),
+                sinceRevision,
+                revision: newestRevision,
+                reset: false,
+                hasMore: changed.length === limit && events.some((event) => event.revision > sinceRevision && event.revision < changed[0].revision),
+                source: "device-live",
+                canonical: true,
             },
         }));
     }
@@ -2807,21 +3280,23 @@ export class AgentWorkspaceProxy {
         if (!conversation.agentSessionId)
             return;
         const existing = this.timelines.get(conversation.id) ?? [];
-        if (existing.length > 0)
+        if (existing.length > 0) {
+            this.setRevisionFloor(conversation.id, Math.max(existing.length, ...existing.map((item) => item.revision ?? 0)));
             return;
-        const result = conversation.provider === "codex"
-            ? loadCodexStoredTimeline(conversation.agentSessionId, conversation.id, conversation.cwd || this.input.cwd)
-            : conversation.provider === "claude"
-                ? loadClaudeStoredTimeline(conversation.agentSessionId, conversation.id)
-                : { items: [] };
-        if (result.items.length === 0)
+        }
+        const stored = this.storedTimeline(conversation, MAX_TIMELINE_ITEMS);
+        conversation.historyComplete = stored.length <= MAX_SNAPSHOT_ITEMS;
+        if (stored.length === 0) {
+            this.setRevisionFloor(conversation.id, this.getRevision(conversation.id));
             return;
-        const items = result.items
+        }
+        const items = stored
             .sort((a, b) => a.createdAt - b.createdAt)
             .slice(-MAX_TIMELINE_ITEMS);
         this.timelines.set(conversation.id, items);
         for (const item of items)
             this.rememberItemConversationId(conversation.id, item);
+        this.setRevisionFloor(conversation.id, Math.max(items.length, ...items.map((item) => item.revision ?? 0)));
         const lastMessage = [...items].reverse().find((item) => item.text?.trim());
         if (lastMessage?.text && !conversation.lastMessagePreview) {
             conversation.lastMessagePreview = previewText(lastMessage.text);
@@ -2890,6 +3365,9 @@ export class AgentWorkspaceProxy {
     rememberTurnConversationId(conversationId, turnId) {
         this.currentTurnIds.set(conversationId, turnId);
         this.turnConversationIds.set(turnId, conversationId);
+        const conversation = this.conversations.get(conversationId);
+        if (conversation)
+            conversation.runningTurnId = turnId;
     }
     forgetCurrentTurn(conversationId, turnId) {
         const currentTurnId = this.currentTurnIds.get(conversationId);
@@ -2898,6 +3376,9 @@ export class AgentWorkspaceProxy {
             this.turnConversationIds.delete(turnId);
         if (currentTurnId && currentTurnId !== turnId)
             this.turnConversationIds.delete(currentTurnId);
+        const conversation = this.conversations.get(conversationId);
+        if (conversation)
+            conversation.runningTurnId = undefined;
     }
     rememberItemConversationId(conversationId, item) {
         const keys = [
@@ -2937,28 +3418,51 @@ export class AgentWorkspaceProxy {
     }
     cancelPendingPermissions(conversationId) {
         for (const [requestId, waiter] of this.permissionWaiters) {
+            const ownerConversationId = this.conversationIdForPermissionRequest(requestId);
+            if (conversationId && ownerConversationId && ownerConversationId !== conversationId)
+                continue;
             clearTimeout(waiter.timer);
             waiter.resolve(formatPermissionResponse(this.permissionSources.get(requestId), "cancelled", "cancelled"));
+            if (ownerConversationId) {
+                this.markPermission(ownerConversationId, requestId, {
+                    permissionOutcome: "cancelled",
+                    optionId: "cancelled",
+                    permissionLive: false,
+                    permissionPending: false,
+                    permissionExpired: false,
+                    permissionError: "已停止",
+                });
+            }
+            this.permissionWaiters.delete(requestId);
             this.pendingPermissions.delete(requestId);
             this.permissionSources.delete(requestId);
         }
-        this.permissionWaiters.clear();
         for (const [requestId, waiter] of this.structuredInputWaiters) {
+            const pending = this.pendingStructuredInputs.get(requestId);
+            if (conversationId && pending?.conversationId && pending.conversationId !== conversationId)
+                continue;
             clearTimeout(waiter.timer);
             waiter.resolve(formatStructuredInputResponse({}));
-            const pending = this.pendingStructuredInputs.get(requestId);
             if (pending) {
                 this.markStructuredInput(pending.conversationId, requestId, {
                     inputPending: false,
                     inputError: "已停止",
                 });
             }
+            this.structuredInputWaiters.delete(requestId);
             this.pendingStructuredInputs.delete(requestId);
         }
-        this.structuredInputWaiters.clear();
         if (conversationId)
             this.updateConversationStatus(conversationId, "idle");
     }
+    conversationIdForPermissionRequest(requestId) {
+        for (const [conversationId, timeline] of this.timelines) {
+            if (timeline.some((item) => item.type === "permission" && item.permission?.requestId === requestId)) {
+                return conversationId;
+            }
+        }
+        return undefined;
+    }
     extractSessionId(value) {
         const raw = asRecord(value);
         if (!raw)