Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* 会话尾部收尾提示(error-tail / interrupted)的纯判定模型 —— 对齐桌面
* CCAgentSessionView 的 errorTailMsg / interruptedFromSession 两套 banner 语义,
* 手机端渲染由 SessionTailBanner 组件承担,本模块只做可单测的状态推导。
*
* 两种语义(互斥,error-tail 优先):
* - error-tail:会话尾部停在未忽略的 role='error' 持久化行(桌面进程重启后
* live 报错只剩这条历史行)。reason=app-exit-interrupted(旧版补写的中断
* 标记行)→「继续任务」;普通失败行 →「重试」。
* - interrupted:session 双时间戳驱动的「疑似中断」(activeTurnStartedAt >
* max(lastTurnEndedAt, clearedAt),桌面 sessionActiveTurn.ts 同款判定)。
*
* 抑制条件对齐桌面(漏一条就会出现双红条 / 对同一错误重复续跑):
* - live 错误(projection.error)在场 → InlineQueueSection 的错误框独家承载;
* - 凭证切换等待(credentialSwitchWait)→ 等待横幅优先;
* - 会话跑起来(isSessionStreaming)→ 任务已推进;
* - 续跑指令已在 pendingQueue(精确匹配两条共享常量,不用前缀——其它 UI
* trigger 并不推进失败 turn,前缀匹配会误抑制,桌面 review P2)→ 已点过。
*/
import {
APP_EXIT_INTERRUPTED_REASON,
CONTINUE_AFTER_APP_EXIT_PROMPT,
CONTINUE_AFTER_ERROR_PROMPT,
} from '@cindy/maker-shared/synthetic-trigger';
import {
messageContentToPreview,
sortMessagesByCreatedAt,
} from '@cindy/maker-shared/message-normalize';
import type { InputProjection, QueuedRemoteMessage, RemoteMessage, RemoteSession } from '@/session/types';
import {
describeNonRetryableAgentError,
localizeAgentError,
requiresAgentErrorConfigurationChange,
localizeUnclassifiedAgentError,
unclassifiedAgentErrorI18nKey,
parseMobileToolLoopErrorDetails,
type MobileToolLoopErrorDetails,
} from '@/session/agentErrorI18n';
export interface SessionTailErrorBanner {
kind: 'error-tail';
/** 错误行 clientId:忽略(dismiss)与本地隐藏态都按它归属。 */
clientId: string;
/** 本地化展示文案;未知错误的技术原文放入 rawError。 */
text: string;
rawError?: string;
/** 错误行的稳定 reason key,供诊断提示带上。 */
reason?: string | null;
summaryKey?: string;
/** 主按钮语义:中断标记行 →「继续任务」;普通失败行 →「重试」。 */
continueKind: 'interrupted' | 'error';
/**
* false = 不显示主按钮(agent 未鉴权类错误:凭证在被控电脑上,手机端重试
* 必撞同一失败;对齐桌面 ErrorBanner 的 401 hide-Retry 门控的核心语义)。
*/
retryable: boolean;
}
export interface SessionTailInterruptedBanner {
kind: 'interrupted';
}
export type SessionTailBannerState = SessionTailErrorBanner | SessionTailInterruptedBanner | null;
export interface ResolveSessionTailBannerInput {
messages: readonly RemoteMessage[];
session: Pick<RemoteSession, 'activeTurnStartedAt' | 'lastTurnEndedAt' | 'clearedAt' | 'source'> | null;
projection: Pick<InputProjection, 'error' | 'credentialSwitchWait'>;
isSessionStreaming: boolean;
/**
* 在途续跑(pendingQueue **加** settling 窗口里存在续跑指令项)——由调用方用
* isContinuationQueueItem 对两个集合统一计算后传入。**单点判定**:调用方释放
* 「重试」本地隐藏的信号必须与本抑制条件是同一个值,两处各算一遍曾让
* settling-only 状态下 hidden 已释放而抑制不生效,banner 重现可重复续跑
* (review P1 第五轮收敛,model 不再自己扫队列)。
*/
continuationInFlight: boolean;
/** 当前任务元数据已在本 relay 连接代完成权威同步。只门控双时间戳中断推断。 */
sessionMetadataSyncedForConnection: boolean;
/** interrupted 已被本视图操作过(继续/忽略)或本窗口内会话跑起来过 → 熄灭。 */
interruptAcked: boolean;
/**
* 本视图内已点过「忽略」的错误行(乐观隐藏,持久化 dismiss 由调用方发起;调用方
* 同时让这些行的错误卡回流消息流)。「重试」不进此集合——点击窗口由 busy 态挡住,
* enqueue 成功后在途续跑接管抑制,取消续跑时 banner 自动恢复。
*/
hiddenErrorClientIds: ReadonlySet<string>;
}
/**
* 队列 / settling 项是否是续跑指令(精确匹配两条共享常量,不用前缀——其它 UI
* trigger 并不推进失败 turn,前缀匹配会误抑制)。调用方对 pendingQueue 与
* settlingQueueItems 的并集计算 continuationInFlight 用。
*/
export function isContinuationQueueItem(item: Pick<QueuedRemoteMessage, 'text'>): boolean {
return item.text === CONTINUE_AFTER_APP_EXIT_PROMPT || item.text === CONTINUE_AFTER_ERROR_PROMPT;
}
export function resolveSessionTailBanner(input: ResolveSessionTailBannerInput): SessionTailBannerState {
const { projection } = input;
if (projection.error) return null;
if (projection.credentialSwitchWait) return null;
if (input.isSessionStreaming) return null;
if (input.continuationInFlight) return null;
const tail = findErrorTailMessage(input.messages);
if (tail && !input.hiddenErrorClientIds.has(tail.clientId)) {
const nonRetryableGuidance = describeNonRetryableAgentError(tail.text);
const agentErrorGuidance = localizeAgentError(tail.reason, tail.toolLoop);
return {
kind: 'error-tail',
clientId: tail.clientId,
text: nonRetryableGuidance ?? agentErrorGuidance ?? localizeUnclassifiedAgentError(tail.text, input.session?.source),
rawError: tail.text,
reason: tail.reason,
...(!nonRetryableGuidance && !agentErrorGuidance ? { summaryKey: unclassifiedAgentErrorI18nKey(tail.text, input.session?.source) } : {}),
continueKind: tail.reason === APP_EXIT_INTERRUPTED_REASON ? 'interrupted' : 'error',
retryable: nonRetryableGuidance === null && !requiresAgentErrorConfigurationChange(tail.text),
};
}
// 历史中断行优先;无 error-tail 才轮到 session 双时间戳判定(对齐桌面互斥渲染)。
if (tail) return null;
// 连接恢复或首次打开时,store 可能先呈现上一代的 activeTurnStartedAt / lastTurnEndedAt。
// 在本代 session 元数据完成同步前,这两个时间戳不能证明任务真的中断;持久 error-tail
// 已在上面独立处理,不受此门影响。
if (!input.sessionMetadataSyncedForConnection) return null;
if (input.interruptAcked || !input.session) return null;
const started = input.session.activeTurnStartedAt ?? null;
if (!started) return null;
const ended = input.session.lastTurnEndedAt ?? 0;
const cleared = input.session.clearedAt ? Date.parse(input.session.clearedAt) : 0;
if (started > ended && started > cleared) return { kind: 'interrupted' };
return null;
}
interface ErrorTailMessage {
clientId: string;
text: string;
reason: string | null;
toolLoop: MobileToolLoopErrorDetails | null;
}
/**
* 消息流去重用:尾部未忽略 error 行的 clientId。命中时该行由 SessionTailBanner
* 独家承载,render items 里滤掉对应错误卡(对齐桌面 MessageStream 对尾部未忽略
* error 行返回 null);dismissed / 有后续消息时判定不命中,错误卡自然回流消息流。
* 与 banner 的可见性抑制(streaming / 续跑已排队等)无关——桌面同款语义。
*/
export function findErrorTailClientId(messages: readonly RemoteMessage[]): string | null {
return findErrorTailMessage(messages)?.clientId ?? null;
}
/**
* 会话尾部未忽略的 role='error' 行。跳过手机本地追加的 system 卡(/pwd、/context
* 等 `mobile-system-` 前缀行):它们挂在错误行之后不代表任务被推进;其余任何角色
* 的更新消息都算推进,判定不命中(与桌面「最后一条」语义一致)。
*/
function findErrorTailMessage(messages: readonly RemoteMessage[]): ErrorTailMessage | null {
const sorted = sortMessagesByCreatedAt(messages);
for (let index = sorted.length - 1; index >= 0; index--) {
const message = sorted[index];
if (message.clientId?.startsWith('mobile-system-')) continue;
if (message.role !== 'error') return null;
const content = parseRecord(message.content);
if (content?.dismissed === true) return null;
const rawText = typeof content?.message === 'string'
? content.message
: messageContentToPreview(message.content);
return {
clientId: message.clientId,
text: rawText,
reason: typeof content?.reason === 'string' ? content.reason : null,
toolLoop: parseMobileToolLoopErrorDetails(content?.toolLoop),
};
}
return null;
}
function parseRecord(content: unknown): Record<string, unknown> | null {
if (content && typeof content === 'object' && !Array.isArray(content)) {
return content as Record<string, unknown>;
}
if (typeof content === 'string') {
try {
const parsed = JSON.parse(content) as unknown;
if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
return parsed as Record<string, unknown>;
}
} catch {
/* 非 JSON 原文,按无结构处理 */
}
}
return null;
}