Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* remoteSessionHandoff —— 远程建会话**成功之后**的交接收尾(device-link)。
* ---------------------------------------------------------------------------
* 被控端 `maker:create-session` 返回 sessionId 的那一刻就是**提交点**:对端会话已经真的建出来了。
* 此后这 4 步必须按序做完,而且任何一步失败都**不许**把流程退化成「创建失败」—— 用户会照着提示
* 再点一次,于是对端多出第二个会话,第一个空着永久滞留。
*
* 抽成一处的原因(#807 review 的结构性教训):这段收尾原先在「发送」与「新建目标」两条路径上
* 逐字重复,而它的三条不变量分别是被三轮 review 逐个抓出来补上的 ——
*
* ① **先钉归属,再回流**。回流失败时镜像里没有这条会话,`getSessionDeviceId` 返回 undefined,
* `makerApiFor` 就把首条消息发给**本机** maker。钉子只影响 origin 判定,会话进列表仍等权威快照。
* ② **补一条临时行**。origin 钉子只解决「路由到哪」;交接还有第二道门槛 —— SessionView 的
* delayed-create effect 要求 `session` 非空**且** `workingDir` 非空才 consumePending。会话行
* 只有权威快照能带来,回流失败时那条消息就一直不发;`gave-up` 里的永久错误(老被控端没把
* `local-db:sessions:list` 放进 allowlist / REMOTE_DISABLED)更是**永远**不会有快照,消息永久
* 躺着不发,而草稿下面已经被清掉了。
* ③ **回流走 refreshRemoteDeviceSessions,且失败只 warn**。它不抛(瞬态错误退避重试 ~6.75s,
* 覆盖被控端冷启动)、认 snapshot epoch(不覆盖更新的快照)、有界快照按 merge 落库(手写
* `sessions:list` 会把 200 行上限的窗口当权威 replace,把窗口外已缓存的会话连标题叠加层一起清掉)。
*
* 三条各自都曾**只在一条路径上**被修好过 —— 两处逐字重复的代码,漏改一处不会有任何编译或测试信号。
* 收敛成一个函数后,「远程建会话之后该做什么」只有一个答案;将来第三条创建路径(例如侧边栏直建)
* 直接调它就自动带齐这三条不变量。
*/
import { refreshRemoteDeviceSessions } from '@/features/device-link/refreshRemoteSessions';
import { remoteProjectsStore } from '@/features/device-link/remoteProjectsStore';
import { createLogger } from '@/lib/logger';
import { markSessionStarting } from '@/lib/sessionStartingStore';
import { buildProvisionalRemoteSession, type DeviceLinkCreateArgs } from './deviceLinkCreateArgs';
const log = createLogger('remoteSessionHandoff');
export interface RemoteSessionHandoffParams {
deviceId: string;
/** 展示名(回流落库时用);调用方已按 `?? deviceId` 兜底。 */
deviceName: string;
/** 被控端 create 响应里的会话 id —— 到手即提交点。 */
remoteSessionId: string;
/**
* 被控端**真正分配**的运行目录(create 响应的 `workDir`)。缺省时跳过临时行 —— 编不出
* 一个可信的运行目录,而 delayed-create 的门槛正是它非空;此时只能依赖权威快照。
*/
workDir?: string;
/** 刚提交给被控端的那份 args:临时行的 model / effort / permission / workspaceKind 都以它为准。 */
createArgs: DeviceLinkCreateArgs;
/** 当前时刻 ISO 串;由调用方注入便于单测固定时间。 */
nowIso: string;
/** 日志前缀,用于区分是哪条创建路径(如 'draft send' / 'draft goal')。 */
logTag: string;
/**
* 首条会由调用方直接交给发件队列、且调用方负责在未受理 / 投递失败时撤回
* (remoteProjectsStore.clearPendingFirstSend)。只有这时才登记侧栏「首条已发出」标记;
* 交给 SessionView 的交接(协同 / 斜杠命令 / 新建目标)失败分支不在调用方手里,不登记。
*/
markFirstSend?: boolean;
}
/**
* 钉归属 → 补临时行 → 触发回流。**同步返回、不抛**:调用方到这一步已经过了提交点。
*
* 为什么是同步的(Codex review 第 33 轮 P1):这个函数原来 `await` 回流才返回,于是调用方要等它
* 结束才 `setPending` / `setPendingGoal` 并 navigate。而 refreshRemoteDeviceSessions 对瞬态错误
* 会退避重试,窗口最长约 6.75 秒 —— 应用在这段时间里被关掉,对端**已经**有了那个新会话,而用户
* 的首条消息(或目标弹窗里刚写的内容)还没被记录下来。用户重开后再试一次,对端就多出第二个会话,
* 第一个空着永久滞留;建目标那条还会连同只存在于弹窗里的编辑一起丢。
*
* 而交接**本来就不需要等权威快照** —— 上面第 ② 步补的临时行正是为此存在的(它带着对端真正分配的
* workDir,足够 SessionView 的 delayed-create effect 完成 consumePending)。所以回流改为
* fire-and-forget:先把用户的工作登记好、导航过去,镜像慢一拍无所谓。
*/
export function commitRemoteSessionHandoff(p: RemoteSessionHandoffParams): void {
// ① 归属先落地:回流失败时它是首条消息能路由到对端的唯一依据。
remoteProjectsStore.pinSessionOrigin(p.deviceId, p.remoteSessionId);
// 刚提交的远程任务在对端 isRunning 回流前先按运行中排序,避免先沉底再跳顶。
markSessionStarting(p.remoteSessionId);
// 首条已进入发送链路:被控端收下之前的列表回流里 userSendAt 仍为空,不能让会话先掉进
// 项目外的草稿区再跳回项目。必须先于临时行与回流登记。
if (p.markFirstSend) remoteProjectsStore.setPendingFirstSend(p.remoteSessionId, p.nowIso);
// ② 临时行:让 SessionView 的 delayed-create 交接不必等权威快照。
if (p.workDir) {
remoteProjectsStore.mergeDeviceSessions(p.deviceId, p.deviceName, [
buildProvisionalRemoteSession({
sessionId: p.remoteSessionId,
workDir: p.workDir,
args: p.createArgs,
nowIso: p.nowIso,
}),
]);
}
// ③ 权威快照回流:**不等它**(见上)。失败只记日志 —— sessions:created push 还会触发一次
// 防抖重拉,不能因为镜像慢一拍就影响交接。refreshRemoteDeviceSessions 本身不抛,
// catch 只是防御它未来变成会抛的形态。
void refreshRemoteDeviceSessions(p.deviceId, p.deviceName)
.then((refreshResult) => {
if (refreshResult !== 'ok') {
log.warn(`[${p.logTag}] remote sessions refresh after create`, refreshResult);
}
})
.catch((err) => {
log.warn(`[${p.logTag}] remote sessions refresh after create threw`, err);
});
}