Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* edit-last-message: 编辑最后一条 user 消息的提交编排。
*
* 语义 = 完整 rewind(对话裁剪 + 文件回滚,两端 agent 与现有 Rewind 按钮同一条
* IPC 链路)+ 立即用编辑后的文本重发。与 Rewind 的"预填 composer 草稿"分支的
* 区别只在最后一步:不落草稿,直接 send。
*
* 步骤(顺序有讲究):
* 1. rewindCommit — 后端软删 target 及其之后的消息、重置 token、Claude 设
* pendingRewindTo(下一次 send 触发三件套重启)。await 返回时 DB 事务已完成。
* 2. emitSessionPatch — sidebar 镜像 token 归零 / sdkSessionId 可能变化。
* 3. dropMessagesFromClientId — 内存里按同一软删语义裁掉旧段(不走
* reloadMessages 的"清空 + 异步重拉",避免和乐观气泡竞态闪烁)。
* 4. sendMessage — 用 rewindCommit 返回的 session 行里的 model / effort /
* permissionMode(选择器改动是 server-first 持久化,行值即当前值)重发;
* 原消息附件经 buildRewindDraftAttachments 原样重建。
*
* 失败面:
* - 第 1 步抛错(SESSION_RUNNING / NO_LIVE_QUERY 等)→ 整体未发生,调用方保持
* 编辑态让用户重试。
* - 重发入队失败(远端错误等)→ rewind 已 commit、旧消息已软删,编辑
* 文本**不能丢**:落 composer 草稿兜底(saveDraft 非 silent,已挂载的
* ChatInput 会收到通知立即回填),与 Rewind 按钮的"预填输入框"UX 收敛到
* 同一条路。store 侧的 error banner 由 sendMessage 内部错误处理负责。
*/
import { ApiError } from '@/lib/httpClient';
import { rewindCommit as rewindCommitService } from '@/lib/sessionService';
// origin-aware 传输:device-link 远程会话的消息在被控端 DB,直连本机
// messageService.list 会查到空库(bot review 指出)。listMessagesFor 与
// rewind/重发链路的 makerApiFor 同一路由语义:本机直查,远程走隧道。
import { listMessagesFor } from '@/lib/makerTransport';
import { makerChatStore } from '@/lib/makerChatStore';
import { emitPatch as emitSessionPatch } from '@/lib/sessionsBus';
import {
saveDraft as saveComposerDraft,
plainTextToTiptapDoc,
} from '@/lib/composerDraftStore';
import { parseChatQuoteSegments } from '@/lib/chatQuotes';
import { quoteSegmentsToComposerDocument } from '@/lib/composerQuoteDocument';
import type { JSONContent } from '@tiptap/core';
import { expandGhostCommand } from '@/cindy-brain/ghostCommand';
import { filterGhostsForWorkdir } from '@/cindy-brain/ghostWorkdirFilter';
import {
buildRewindDraftAttachments,
dropMissingAnnotationSources,
hasRestorableAnnotationSources,
type RewindDraftImage,
} from '@/lib/rewindDraftAttachments';
import type { AttachedFile } from '@/lib/fileTypes';
import type { FileRef, PastedTextRange, SlashCommandRange } from '@/lib/imageRef';
import type { Session } from '@/lib/ccAgent.types';
import type { AgentInputReference } from '../../shared/agentInputQueue';
export interface CommitEditAndResendOptions {
sessionId: string;
/** clientId of the last user message being edited (rewind target). */
clientId: string;
/** Edited text to resend. May be empty when attachments exist. */
text: string;
/** Original message attachments — re-sent as-is (v1 不支持编辑态增删附件). */
images?: readonly RewindDraftImage[];
files?: readonly FileRef[];
/** Fallback workingDir (UserMessage prop) — session 行缺失时兜底。 */
fallbackWorkingDir: string;
/**
* 原消息带「选中引用」编码标志时重发同样携带——正文内引用块的解析以该
* 标志门控,丢掉会让 markdown blockquote 退回普通文本展示。
*/
quotesEncoded?: boolean;
/** 原消息语义引用 range;只有编辑框确认可见文本未改变时才传入。 */
agentReferences?: AgentInputReference[];
/** 原消息长粘贴 range;只有编辑框确认文本未改变时才传入。 */
pastedTextRanges?: PastedTextRange[];
/** 原消息 slash range;undefined 表示缺少显式 range,空数组表示明确无 slash。 */
slashCommandRanges?: SlashCommandRange[];
/** Bound from conversation-only preview so commit cannot restore files. */
allowFileRestore?: boolean;
}
/** 依赖注入口 — 单测用内存假件替换,生产走默认实现。 */
export interface CommitEditAndResendDeps {
rewindCommit: (
sessionId: string,
clientId: string,
opts?: { allowFileRestore?: boolean },
) => Promise<Session>;
emitPatch: typeof emitSessionPatch;
dropMessagesFromClientId: (sessionId: string, clientId: string) => void;
sendMessage: typeof makerChatStore.sendMessage;
/** 重发入队失败时的正文兜底:编辑文档 + 附件落 composer 草稿。 */
saveDraftFallback: (
sessionId: string,
document: JSONContent | null,
attachments: AttachedFile[],
) => void;
/** 会话是否有排队中的未派发消息(pendingQueue 非空)。 */
hasPendingQueue: (sessionId: string) => boolean;
/** DB 真值:会话最新一条 user 消息的 clientId(无则 null)。 */
fetchLatestUserMessageClientId: (sessionId: string) => Promise<string | null>;
/**
* ghost-summon-card:重发前的"发送期展开"(意识 $指令 硬指令追加段)。
* 编辑框预填的是剥离机器追加段后的正文(UserMessage 侧),这里在 send
* 之前按当前已装意识重新展开——与 ChatInput 的发送语义对齐(含目录级
* 禁用同判,workingDir 与重发落点同源);fallback 草稿走未展开文本
* (草稿重发时 ChatInput 会再展开,避免叠双份指令)。
* 可选:单测缺省时用默认实现(jsdom 无 electronAPI 时安全退化为原文)。
*/
expandForSend?: (text: string, workingDir?: string | null) => string;
}
/** 默认发送期展开:读本机已装意识列表(按 workingDir 滤目录级禁用);
* 任何异常安全退化为原文。 */
function defaultExpandForSend(text: string, workingDir?: string | null): string {
try {
const ghosts = window.electronAPI?.ghosts?.listSync?.().ghosts ?? [];
return expandGhostCommand(text, filterGhostsForWorkdir(ghosts, workingDir));
} catch {
return text;
}
}
const defaultDeps: CommitEditAndResendDeps = {
// requireLatestUser: main 侧权威版"最新校验"——renderer 的 DB 预查(下方
// fetchLatestUserMessageClientId)到 IPC 落地之间存在 TOCTOU 窗口(自动化 /
// goal runner / 第二控制端可能追加新 user 消息),main 在 SDK 副作用前与软删
// 事务前各校验一次,超越则抛 REWIND_TARGET_NOT_LATEST。
rewindCommit: (sessionId, clientId, opts) =>
rewindCommitService(sessionId, clientId, {
requireLatestUser: true,
...(opts?.allowFileRestore === false ? { allowFileRestore: false } : {}),
}),
emitPatch: emitSessionPatch,
dropMessagesFromClientId: (sessionId, clientId) =>
makerChatStore.dropMessagesFromClientId(sessionId, clientId),
sendMessage: (...args) => makerChatStore.sendMessage(...args),
saveDraftFallback: (sessionId, document, attachments) =>
saveComposerDraft(sessionId, {
text: document,
attachments,
}),
hasPendingQueue: (sessionId) =>
makerChatStore.getSnapshot(sessionId).pendingQueue.length > 0,
fetchLatestUserMessageClientId: (sessionId) => fetchLatestUserMessageClientIdViaDb(sessionId),
expandForSend: defaultExpandForSend,
};
type LatestUserRow = {
id: string;
clientId: string;
role: string;
createdAt: number | string;
};
const rowTs = (v: number | string): number => (typeof v === 'number' ? v : Date.parse(v));
/**
* DB 真值:会话最新一条 user 消息的 clientId。
*
* 必须**向老页翻页**而不是只看最新 50 条(bot review 指出的回归):工具密集的
* 长 turn 会往 messages 表持久化远超 50 行的 tool_use/tool_result/thinking 行,
* 最新一页可能一条 user 都没有——只查一页会把合法的"编辑真实最后一条"误判为
* EDIT_NOT_LAST_MESSAGE 拒掉(与首条误判分页 bug 同构,方向相反)。
* 页序从新到旧,首个含 user 行的页里按 (createdAt, id) 取最大者即全局最新。
* 安全上限 40 页(2000 行)防病态数据下的无界扫描,翻尽仍无 user 行 → null
* (调用方 fail-closed,会话根本没有 user 消息时本就不该有编辑入口)。
*/
export async function fetchLatestUserMessageClientIdViaDb(
sessionId: string,
): Promise<string | null> {
const PAGE_SIZE = 50;
const MAX_PAGES = 40;
let before: string | undefined;
for (let page = 0; page < MAX_PAGES; page++) {
const rows = (await listMessagesFor(sessionId, {
limit: PAGE_SIZE,
...(before ? { before } : {}),
})) as LatestUserRow[];
if (rows.length === 0) return null;
let latestUser: LatestUserRow | null = null;
let oldest: LatestUserRow = rows[0];
for (const row of rows) {
if (
rowTs(row.createdAt) < rowTs(oldest.createdAt) ||
(rowTs(row.createdAt) === rowTs(oldest.createdAt) && row.id < oldest.id)
) {
oldest = row;
}
if (row.role !== 'user') continue;
if (
!latestUser ||
rowTs(row.createdAt) > rowTs(latestUser.createdAt) ||
(rowTs(row.createdAt) === rowTs(latestUser.createdAt) && row.id > latestUser.id)
) {
latestUser = row;
}
}
if (latestUser) return latestUser.clientId;
if (rows.length < PAGE_SIZE) return null;
before = oldest.id;
}
return null;
}
export async function commitEditAndResend(
opts: CommitEditAndResendOptions,
deps: CommitEditAndResendDeps = defaultDeps,
): Promise<boolean> {
// 带可再编辑标注的历史图:原图已被清理的退回烧录图(否则重发时无法重新烧录)。
const images =
opts.images && hasRestorableAnnotationSources(opts.images)
? await dropMissingAnnotationSources(opts.images)
: opts.images;
const attachments = buildRewindDraftAttachments({
images,
files: opts.files,
});
// 空文本 + 无附件的重发会被 sendMessage 静默 no-op,那样就变成"只回退没重发"
// ——语义上是 Rewind 而不是编辑。在 commit 之前拦下,由 UI 层禁用发送按钮兜底。
if (!opts.text.trim() && attachments.length === 0) {
throw new Error('edit-last-message: refusing to resend empty message');
}
// 队列硬守卫(UserMessage.handleEdit 的入口 toast 是第一道,这里防 mid-edit
// 竞态):paused 队列非空时重发会追加到队尾——排在 N 条针对旧上下文写的陈旧
// 消息之后,Continue 后重放顺序反转、且 enqueue 成功会让草稿兜底误判"已派发"。
// 在 rewindCommit 之前拦下,整体未发生,编辑态原样保留。
if (deps.hasPendingQueue(opts.sessionId)) {
throw new ApiError('EDIT_QUEUE_NOT_EMPTY', 0, 'pending queue is not empty');
}
// 最后一条真值硬守卫(bot review P2,实为数据丢弃级风险):renderer 的
// isLastUserMessage 基于**已加载切片**判定——搜索/深链跳转的中间窗口期,
// 切片最后一条可能不是会话真实最后一条,此时 rewind 会把窗口之外更新的
// 轮次一并软删。提交前用一次 DB 查询核对真值,不一致 fail-closed 拦下
// (查询失败同样中止——宁可让用户重试,不冒静默丢轮次的风险)。
const latestUserClientId = await deps.fetchLatestUserMessageClientId(opts.sessionId);
if (latestUserClientId !== opts.clientId) {
throw new ApiError('EDIT_NOT_LAST_MESSAGE', 0, 'target is no longer the latest user message');
}
const session =
opts.allowFileRestore === false
? await deps.rewindCommit(opts.sessionId, opts.clientId, { allowFileRestore: false })
: await deps.rewindCommit(opts.sessionId, opts.clientId);
deps.emitPatch(opts.sessionId, {
sdkSessionId: session.sdkSessionId,
contextTokens: 0,
contextWindow: 0,
updatedAt: session.updatedAt,
userSendAt: session.userSendAt,
});
deps.dropMessagesFromClientId(opts.sessionId, opts.clientId);
// 意识发送期展开只作用于"发出去的文本";opts.text(用户编辑原文)继续用于
// 下方 fallback 草稿——草稿重发经 ChatInput 再展开,不叠双份指令。
const dispatched = await deps.sendMessage(
opts.sessionId,
(deps.expandForSend ?? defaultExpandForSend)(opts.text, session.workingDir ?? opts.fallbackWorkingDir ?? null),
session.model,
session.effort,
session.permissionMode,
session.workingDir ?? opts.fallbackWorkingDir,
attachments.length > 0 ? attachments : undefined,
undefined,
opts.quotesEncoded ||
opts.agentReferences?.length ||
opts.pastedTextRanges?.length ||
opts.slashCommandRanges !== undefined
? {
...(opts.quotesEncoded ? { quotesEncoded: true } : {}),
...(opts.agentReferences?.length ? { agentReferences: opts.agentReferences } : {}),
...(opts.pastedTextRanges?.length ? { pastedTextRanges: opts.pastedTextRanges } : {}),
...(opts.slashCommandRanges !== undefined ? { slashCommandRanges: opts.slashCommandRanges } : {}),
}
: undefined,
);
if (!dispatched) {
// rewind 已 commit(旧消息已软删)但重发没送达:文本落草稿,用户在输入框
// 找回可重发。错误提示由 sendMessage 内部写入 store 的 error banner。
const document = opts.quotesEncoded
? quoteSegmentsToComposerDocument(parseChatQuoteSegments(opts.text))
: opts.text.trim()
? plainTextToTiptapDoc(opts.text)
: null;
deps.saveDraftFallback(opts.sessionId, document, attachments);
return false;
}
return true;
}
/** 重试节奏(编辑自动停止场景专用,见 commitEditAndResendWithRunningRetry)。 */
export interface RunningRetryOptions {
/** SESSION_RUNNING 时的额外重试次数(不含首次)。默认见 RUNNING_RETRY_DEFAULTS。 */
attempts?: number;
/** 每次重试间隔 ms。默认见 RUNNING_RETRY_DEFAULTS。 */
delayMs?: number;
/** 可注入的 sleep(测试用假时钟)。 */
sleep?: (ms: number) => Promise<void>;
}
/**
* 默认重试预算 ≈ 15s(20 × 750ms),与 UserMessageEditBox 的
* STOP_WAIT_TIMEOUT_MS 同量级——这不是巧合而是契约:stopSession 会**乐观**
* 清掉 renderer 的 isStreaming(bot review 指出),EditBox 的"等 idle 再提交"
* 等待机制因此几乎总被跳过,慢停止(远端会话 / 长工具调用收尾)的整个窗口
* 实际由这里的 SESSION_RUNNING 重试独自扛。空闲路径零额外延迟(只在
* SESSION_RUNNING 时才睡)。
*/
export const RUNNING_RETRY_DEFAULTS = { attempts: 20, delayMs: 750 } as const;
const defaultSleep = (ms: number): Promise<void> => new Promise((r) => setTimeout(r, ms));
/**
* edit-last-message(运行中编辑):带 SESSION_RUNNING 重试的提交。
*
* 点编辑会自动 stop 当前 turn,发送侧先等 renderer 的 isStreaming 翻 false 再
* 调本函数;但 renderer 状态与 main 侧 isTurnRunning 守卫之间仍有毫秒级尾差
* (stop 的 done 事件 fan-out 先于 turnInFlight 清理到达是可能的),所以对
* SESSION_RUNNING 做有限次短间隔重试,把这段尾差确定性地消化掉,而不是把
* 偶发失败甩给用户重点一次。其它错误码不重试,原样抛出。
*/
export async function commitEditAndResendWithRunningRetry(
opts: CommitEditAndResendOptions,
deps: CommitEditAndResendDeps = defaultDeps,
retry: RunningRetryOptions = {},
): Promise<boolean> {
const attempts = retry.attempts ?? RUNNING_RETRY_DEFAULTS.attempts;
const delayMs = retry.delayMs ?? RUNNING_RETRY_DEFAULTS.delayMs;
const sleep = retry.sleep ?? defaultSleep;
for (let attempt = 0; ; attempt++) {
try {
return await commitEditAndResend(opts, deps);
} catch (err) {
const isRunning = err instanceof ApiError && err.code === 'SESSION_RUNNING';
if (!isRunning || attempt >= attempts) throw err;
await sleep(delayMs);
}
}
}