Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* 手机端 Orca 协同(桌面 Lead/worker 团队)消息识别与卡片建模 —— 纯 mobile render 层。
*
* 聚焦的"Lead 会话"在消息流里有两类协同消息需要识别并渲染成卡片(否则会糊一坨原始 JSON / 生硬的
* tool 名给用户看):
* - **派活**:Lead 调用 `create_worker` / `create_workers` / `send_to_worker`(tool_use)给 worker 派活。
* - **回报**:worker 的 `send_to_lead` 落库成一条 `role==='user'` 消息,content 是
* `{"orcaSource":"worker","content":"…"}` 的 JSON(DB 持久化格式)。
*
* Worker 会话里还有 Lead 发来的消息(`send_to_worker` / 建 worker 的初始任务),落库同样是
* `{"orcaSource":"lead","content":"…"}`;两种互发消息都建模成卡片,原始 JSON 绝不展示。
*
* 这里只做"识别 + 抽取展示文案",真正渲染在 MessageRenderer 的 OrcaCollabCard。匹配 tool 名沿用
* 共享层 `isOrcaCommunicationTool` 的归一化约定(`mcp__X__Y` → `mcp:X:Y`),兼容裸名与 MCP 前缀名。
*/
import { i18n } from '@/i18n';
import { orcaMessageTitle } from '@/session/messageSourceLabels';
export interface OrcaCollabCard {
/**
* dispatch = Lead 会话里的派活 tool;report = worker 发给 Lead 的消息;
* lead = Lead 发给 worker 的消息(在 worker 会话里)。用于卡片视觉/标题区分。
*/
variant: 'dispatch' | 'report' | 'lead';
/** 卡片标题,如 "派活给 Worker frontend" / "来自 Worker「frontend」的消息"。 */
title: string;
/** 卡片正文:派活的任务摘要 / 回报的正文内容。 */
body: string;
}
function normalizeToolName(toolName: string): string {
return toolName.replace(/^mcp__/, 'mcp:').replace(/__/g, ':');
}
/** 识别 Lead 派活类 tool:单建、批量新建与追加派活。 */
export function classifyOrcaDispatchTool(toolName: string): 'create' | 'create-batch' | 'send' | null {
const normalized = normalizeToolName(toolName);
if (normalized === 'create_worker' || normalized.endsWith(':create_worker')) return 'create';
if (normalized === 'create_workers' || normalized.endsWith(':create_workers')) return 'create-batch';
if (normalized === 'send_to_worker' || normalized.endsWith(':send_to_worker')) return 'send';
return null;
}
/** 从派活 tool_use 的输入里抽出"派活给谁 + 任务摘要",建模成 dispatch 卡片;非派活 tool 返回 null。 */
export function buildOrcaDispatchCard(toolName: string, input: unknown): OrcaCollabCard | null {
const kind = classifyOrcaDispatchTool(toolName);
if (!kind) return null;
const record = readRecord(input);
if (kind === 'create-batch') {
const workers = Array.isArray(record?.workers) ? record.workers : [];
const summaries = workers.map((value, index) => {
const worker = readRecord(value);
const label = readString(worker?.label) ?? readString(worker?.role) ?? `worker ${index + 1}`;
const task = readString(worker?.initial_task);
return task ? i18n.t('interaction.collab.dispatchSummaryItem', { label, task }) : label;
});
return {
variant: 'dispatch',
title: workers.length > 0
? i18n.t('interaction.collab.batchTitle', { count: workers.length })
: i18n.t('interaction.collab.batchTitleGeneric'),
body: summaries.length > 0 ? summaries.join('\n') : i18n.t('interaction.collab.batchBodyFallback'),
};
}
if (kind === 'create') {
const label = readString(record?.label);
const role = readString(record?.role);
const agent = readString(record?.agent);
const task = readString(record?.initial_task);
const who = label ?? role ?? 'worker';
const meta = [role, agent].filter(Boolean).join(' · ');
return {
variant: 'dispatch',
title: i18n.t('interaction.collab.dispatchTitle', { who }),
body: task ?? (meta ? i18n.t('interaction.collab.dispatchRole', { meta }) : i18n.t('interaction.collab.dispatchBodyFallback')),
};
}
// send_to_worker:只有 target_session_id + message,没有 label,标题用通用文案。
const message = readString(record?.message);
const target = readString(record?.target_session_id);
return {
variant: 'dispatch',
title: i18n.t('interaction.collab.sendTitle'),
body: message ?? (target ? `→ ${target}` : i18n.t('interaction.collab.sendBodyFallback')),
};
}
/**
* 解析落库的 Orca 互发消息(user 消息 content = `{orcaSource:'lead'|'worker',content}`)。
* worker → report 卡片(标题带主机盖章的 worker 角色 `origin.senderLabel`),lead → lead 卡片。
* **解析失败 / 非该格式一律返回 null**,由调用方回退普通文本,绝不把原始 JSON 糊给用户看。
*/
export function parseOrcaPersistedMessage(
content: unknown,
senderLabel?: string,
): OrcaCollabCard | null {
const record = parseMaybeJsonObject(content);
if (!record || (record.orcaSource !== 'worker' && record.orcaSource !== 'lead')) return null;
const body = readString(record.content);
return {
variant: record.orcaSource === 'lead' ? 'lead' : 'report',
title: orcaMessageTitle(record.orcaSource, senderLabel),
body: body ?? i18n.t('interaction.collab.emptyMessageBody'),
};
}
/** 落库 Orca 消息的来源方向;非 Orca 格式返回 null。排队气泡据此选择标题。 */
export function readOrcaPersistedSource(content: unknown): 'lead' | 'worker' | null {
const record = parseMaybeJsonObject(content);
return record?.orcaSource === 'lead' || record?.orcaSource === 'worker' ? record.orcaSource : null;
}
function readRecord(value: unknown): Record<string, unknown> | null {
return value && typeof value === 'object' && !Array.isArray(value)
? value as Record<string, unknown>
: null;
}
function parseMaybeJsonObject(value: unknown): Record<string, unknown> | null {
if (typeof value === 'string') {
try {
return readRecord(JSON.parse(value));
} catch {
return null;
}
}
return readRecord(value);
}
function readString(value: unknown): string | null {
return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null;
}