Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
export interface MobileModelOption {
id: string;
label: string;
description?: string;
efforts: string[];
effortDisplayNames: Record<string, string>;
defaultEffort: string | null;
supportsFastMode: boolean;
supportsUltrafastMode?: boolean;
/** Host-advertised catalog window when available; omitted by older Desktop versions. */
contextWindow?: number;
/** 区域门控后的新任务默认标记。 */
newSessionDefault?: ('claude-code' | 'codex' | 'pi')[];
}
export interface MobileChoiceOption {
id: string;
label: string;
description?: string;
}
export interface MobileAgentCapabilities {
availableModels: MobileModelOption[];
effortLevels: MobileChoiceOption[];
permissionModes: MobileChoiceOption[];
hasFastMode: boolean;
/** 计划模式一级开关能力(maker-core Capabilities.planMode.supported,#494 起替代 permissionMode='plan')。 */
planModeSupported: boolean;
/** desktop host 是否支持同一会话 Claude Code / Codex pending-intent 切换;旧 host 缺省 false。 */
supportsSessionAgentSwitch?: boolean;
/** host 是否支持创建 Orca Worker 时显式选择 Worker 权限;旧 host 缺省 false(不得开启协同)。 */
supportsOrcaWorkerPermissionMode?: boolean;
/** host 是否支持创建后修改 Orca Worker 的角色名/标识(update_worker);旧 host 缺省 false。 */
supportsOrcaWorkerUpdate?: boolean;
/**
* host 是否支持给 Orca Worker 单独指定 Agent 所在电脑(远程供应商,`agentDeviceId`);旧 host 缺省
* false:Worker 表单不列远程供应商、不发这个字段(旧 host 会静默丢掉)。
*/
supportsOrcaWorkerAgentDevice?: boolean;
/** host 是否在 set-model 内执行强制模型窗口保护;旧 host 缺省 false。 */
supportsModelWindowSwitchGuard?: boolean;
}
export interface MobileSessionRuntimeOptions {
modelOptions: MobileModelOption[];
currentModel: MobileModelOption | null;
effortOptions: MobileChoiceOption[];
permissionOptions: MobileChoiceOption[];
fastModeSupported: boolean;
/** 新协议:capabilities.planMode.supported 为真 → 走 maker:set-plan-mode;
* 老被控端(permissionModes 仍含 'plan')走 permissionMode 兼容路径,由页面判断。 */
planModeSupported: boolean;
capabilitiesLoaded: boolean;
}
export interface MobileRuntimeDraft {
model: string;
effort: string;
permissionMode: string;
fastMode: boolean | 'ultrafast';
}
/**
* 手机端的粗分类取值。**没有 `china`**:「中国」只由目录的 `group:'china'` 产生,而手机端
* 这条链上只有 model id(descriptor 不透传 group,见桌面 providerModels.toDescriptor),
* 拿不到该信号,所以国产模型在这里归入 `ungrouped`。这只影响跨厂商切换提示里显示的分类名,
* 不影响可选性与分组展示(手机端不按厂商分组)。
*/
export type MobileModelCategory = 'anthropic' | 'gpt' | 'gpt-budget' | 'google' | 'ungrouped';
export const MOBILE_MODEL_CATEGORY_LABEL: Record<MobileModelCategory, string> = {
anthropic: 'Anthropic',
gpt: 'GPT',
'gpt-budget': 'GPT 折扣',
google: 'Google',
ungrouped: '未分组',
};
export interface MobileModelSwitchConfirmation {
fromCategory: MobileModelCategory;
toCategory: MobileModelCategory;
fromLabel: string;
toLabel: string;
targetModelId: string;
title: string;
description: string;
}
/**
* 旧移动端兼容词表,与桌面 i18n `effortLevels.*` 的 zh-CN 值对齐。normalize 仍用它稳定
* capabilities 快照与旧消费者;模型选择器等用户可见入口再按当前语言覆盖已知档位。
* 未知档 id 不在词表内 → 保留被控端给的 displayName 原文。
*/
export const MOBILE_EFFORT_LABELS: Record<string, string> = {
minimal: '最小',
low: '低',
medium: '中',
high: '高',
xhigh: '超高',
max: '最高',
ultra: '极致',
};
const ENGLISH_COMPACT_EFFORT_LABELS: Record<string, string> = {
auto: 'Auto',
balanced: 'Balanced',
default: 'Default',
extrahigh: 'Extra',
high: 'High',
low: 'Low',
max: 'Max',
maximum: 'Max',
medium: 'Medium',
minimal: 'Minimal',
none: 'Off',
off: 'Off',
standard: 'Standard',
ultra: 'Ultra',
xhigh: 'Extra',
};
/**
* Windows、macOS 与移动端模型选择器共用的英文 effort 紧凑标签。
* 只压缩确实偏长的标准档位(Extra High → Extra、Maximum → Max),其余保留完整名称;
* 未知档位保留下发的完整显示名(没有显示名时保留完整 id),避免把 provider-specific
* 能力截成不可区分的短码。
*/
export function compactEnglishEffortLabel(effort: string, displayName?: string): string {
const normalizedEffort = effort.toLowerCase().replace(/[^a-z0-9]/g, '');
const standardLabel = ENGLISH_COMPACT_EFFORT_LABELS[normalizedEffort];
if (standardLabel) return standardLabel;
return displayName?.trim() || effort;
}
const FALLBACK_EFFORT_OPTIONS: MobileChoiceOption[] = [
{ id: 'low', label: MOBILE_EFFORT_LABELS.low },
{ id: 'medium', label: MOBILE_EFFORT_LABELS.medium },
{ id: 'high', label: MOBILE_EFFORT_LABELS.high },
];
const FALLBACK_PERMISSION_OPTIONS: MobileChoiceOption[] = [
{ id: 'default', label: 'default' },
{ id: 'ask', label: 'ask' },
{ id: 'acceptEdits', label: 'acceptEdits' },
{ id: 'plan', label: 'plan' },
{ id: 'bypassPermissions', label: 'bypassPermissions' },
];
export function normalizeMobileAgentCapabilities(value: unknown): MobileAgentCapabilities | null {
if (!isRecord(value)) return null;
const availableModels = Array.isArray(value.availableModels)
? value.availableModels.map(normalizeModelOption).filter((item): item is MobileModelOption => !!item)
: [];
const effortLevels = Array.isArray(value.effortLevels)
? value.effortLevels.map(normalizeChoiceOption).filter((item): item is MobileChoiceOption => !!item)
// 已知档 id 换中文词表名(被控端 displayName 是英文;新旧被控端在此统一)。
.map((item) => ({ ...item, label: MOBILE_EFFORT_LABELS[item.id] ?? item.label }))
: [];
const permissionModes = Array.isArray(value.permissionModes)
? value.permissionModes.map(normalizeChoiceOption).filter((item): item is MobileChoiceOption => !!item)
: [];
return {
availableModels,
effortLevels,
permissionModes,
hasFastMode: value.hasFastMode === true,
planModeSupported: isRecord(value.planMode) && value.planMode.supported === true,
supportsSessionAgentSwitch: value.supportsSessionAgentSwitch === true,
supportsModelWindowSwitchGuard: value.supportsModelWindowSwitchGuard === true,
supportsOrcaWorkerPermissionMode: value.supportsOrcaWorkerPermissionMode === true,
supportsOrcaWorkerUpdate: value.supportsOrcaWorkerUpdate === true,
supportsOrcaWorkerAgentDevice: value.supportsOrcaWorkerAgentDevice === true,
};
}
export function shouldBlockLegacyRemoteModelWindowSwitch(args: {
hostGuardSupported: boolean;
agentKind: string | null | undefined;
contextTokens: number | null | undefined;
currentContextWindow: number | null | undefined;
targetContextWindow: number | null | undefined;
}): boolean {
if (args.hostGuardSupported) return false;
if (args.agentKind === 'pi') return true;
const { contextTokens, currentContextWindow, targetContextWindow } = args;
const hasKnownWindows =
typeof currentContextWindow === 'number' &&
Number.isFinite(currentContextWindow) &&
currentContextWindow > 0 &&
typeof targetContextWindow === 'number' &&
Number.isFinite(targetContextWindow) &&
targetContextWindow > 0;
if (!hasKnownWindows) return true;
if (targetContextWindow >= currentContextWindow) return false;
if (
typeof contextTokens !== 'number' ||
!Number.isFinite(contextTokens) ||
contextTokens < 0
) {
return true;
}
return contextTokens / targetContextWindow >= 0.9;
}
export function buildSessionRuntimeOptions(
session: { model: string },
capabilities: MobileAgentCapabilities | null,
): MobileSessionRuntimeOptions {
const currentModel = capabilities?.availableModels.find((item) => item.id === session.model) ?? null;
const modelEfforts = currentModel?.efforts ?? null;
const effortMeta = new Map((capabilities?.effortLevels ?? []).map((item) => [item.id, item]));
const effortOptions = modelEfforts
? modelEfforts.map((id) => ({
id,
label: currentModel?.effortDisplayNames[id] ?? effortMeta.get(id)?.label ?? MOBILE_EFFORT_LABELS[id] ?? id,
description: effortMeta.get(id)?.description,
}))
: capabilities?.effortLevels.length
? capabilities.effortLevels
: FALLBACK_EFFORT_OPTIONS;
return {
modelOptions: capabilities?.availableModels ?? [],
currentModel,
effortOptions,
permissionOptions: capabilities?.permissionModes.length
? capabilities.permissionModes
: FALLBACK_PERMISSION_OPTIONS,
fastModeSupported: capabilities
? capabilities.hasFastMode && currentModel?.supportsFastMode === true
: true,
planModeSupported: capabilities?.planModeSupported === true,
capabilitiesLoaded: !!capabilities,
};
}
export function reconcileRuntimeDraftWithCapabilities<T extends MobileRuntimeDraft>(
draft: T,
capabilities: MobileAgentCapabilities | null,
): T {
if (!capabilities) return draft;
const currentModel = capabilities.availableModels.find((item) => item.id === draft.model)
?? (draft.model ? null : capabilities.availableModels[0])
?? null;
// 新模型可能已由 provider catalog 选中,但 capabilities 仍在同代刷新。
// descriptor 缺失期间保留整份显式草稿,不能套用第一项模型的 effort/fast 元数据。
if (!currentModel && draft.model) return draft;
const model = currentModel?.id ?? draft.model;
const runtime = buildSessionRuntimeOptions({ model }, capabilities);
const effortIds = new Set(runtime.effortOptions.map((item) => item.id));
const permissionIds = new Set(runtime.permissionOptions.map((item) => item.id));
const nextEffort = effortIds.size === 0
? ''
: effortIds.has(draft.effort)
? draft.effort
: currentModel?.defaultEffort && effortIds.has(currentModel.defaultEffort)
? currentModel.defaultEffort
: runtime.effortOptions[0]?.id ?? '';
const nextPermissionMode = permissionIds.size > 0 && !permissionIds.has(draft.permissionMode)
? runtime.permissionOptions[0]?.id ?? draft.permissionMode
: draft.permissionMode;
const nextFastMode = runtime.fastModeSupported && (draft.fastMode !== 'ultrafast' || currentModel?.supportsUltrafastMode === true) ? draft.fastMode : false;
if (
draft.model === model
&& draft.effort === nextEffort
&& draft.permissionMode === nextPermissionMode
&& draft.fastMode === nextFastMode
) {
return draft;
}
return {
...draft,
model,
effort: nextEffort,
permissionMode: nextPermissionMode,
fastMode: nextFastMode,
};
}
/**
* 手机端跨厂商切换提示用的粗分类(只服务 buildMobileModelSwitchConfirmation,不做展示分组)。
* 与桌面 `@cindy/model-providers` 的 `categorize` 同一取向:认不出厂商就落 `ungrouped`,不猜。
* 提示语会把分类名直接读给用户看(「X 和 Y 的消息格式可能不兼容」),猜错就是错的断言。
*
* 本包按设计零依赖(见 docs/dev-rules/architecture-invariants.md 的依赖方向),不能反向引用
* model-providers,故保持独立副本;改一侧记得同步另一侧。
*/
export function categorizeMobileModel(id: string): MobileModelCategory {
const lower = id.toLowerCase();
// 命名空间形态(anthropic/claude-opus-5、openai/gpt-5.5)与裸 id 都要认:目录下发的 id
// 本来就带命名空间,只认裸 id 会让整批模型掉进兜底分类。
const tail = lower.slice(lower.lastIndexOf('/') + 1);
if (lower.startsWith('claude-') || tail.startsWith('claude-')) return 'anthropic';
// 折扣路由必须判在 gpt 之前:`openai-codex/gpt-*` 与 `codex/gpt-5.5` 的尾段都是 gpt-*,
// 顺序反了会被认成 'gpt'。与桌面 `CODEX_GATEWAY_WIRE_PREFIXES` 保持同一组前缀。
if (
(lower.startsWith('openai-codex/') && lower.length > 'openai-codex/'.length) ||
(lower.startsWith('codex/') && lower.length > 'codex/'.length)
) return 'gpt-budget';
if (lower.startsWith('gpt-') || tail.startsWith('gpt-')) return 'gpt';
if (lower.startsWith('gemini-') || tail.startsWith('gemini-')) return 'google';
return 'ungrouped';
}
export function isMobileHistoryCompatibleModelSwitch(
from: MobileModelCategory,
to: MobileModelCategory,
): boolean {
return (
(from === 'gpt' && to === 'gpt-budget') ||
(from === 'gpt-budget' && to === 'gpt')
);
}
export function buildMobileModelSwitchConfirmation({
currentModelId,
messageCount,
targetModelId,
}: {
currentModelId: string;
messageCount: number;
targetModelId: string;
}): MobileModelSwitchConfirmation | null {
if (!currentModelId || !targetModelId || currentModelId === targetModelId || messageCount <= 0) {
return null;
}
const fromCategory = categorizeMobileModel(currentModelId);
const toCategory = categorizeMobileModel(targetModelId);
if (fromCategory === toCategory || isMobileHistoryCompatibleModelSwitch(fromCategory, toCategory)) {
return null;
}
const fromLabel = MOBILE_MODEL_CATEGORY_LABEL[fromCategory];
const toLabel = MOBILE_MODEL_CATEGORY_LABEL[toCategory];
return {
fromCategory,
toCategory,
fromLabel,
toLabel,
targetModelId,
title: `切换到 ${toLabel} 模型?`,
description: `这个任务已有历史消息。${fromLabel} 和 ${toLabel} 的消息格式可能不兼容,切换后旧上下文可能无法继续使用。`,
};
}
function normalizeModelOption(value: unknown): MobileModelOption | null {
if (!isRecord(value)) return null;
const id = readString(value.id);
if (!id) return null;
const effortDisplayNames = isRecord(value.effortDisplayNames)
? Object.fromEntries(Object.entries(value.effortDisplayNames).filter((entry): entry is [string, string] =>
typeof entry[1] === 'string',
))
: {};
const contextWindow =
typeof value.contextWindow === 'number' &&
Number.isFinite(value.contextWindow) &&
value.contextWindow > 0
? value.contextWindow
: undefined;
const newSessionDefault = Array.isArray(value.newSessionDefault)
? [...new Set(value.newSessionDefault.filter(
(item): item is 'claude-code' | 'codex' | 'pi' =>
item === 'claude-code' || item === 'codex' || item === 'pi',
))]
: [];
return {
id,
label: readString(value.displayName) ?? id,
description: readString(value.description) ?? undefined,
efforts: Array.isArray(value.efforts)
? value.efforts.filter((item): item is string => typeof item === 'string' && item.length > 0)
: [],
effortDisplayNames,
defaultEffort: readString(value.defaultEffort),
supportsFastMode: value.supportsFastMode === true,
supportsUltrafastMode: value.supportsUltrafastMode === true,
...(contextWindow ? { contextWindow } : {}),
...(newSessionDefault.length > 0 ? { newSessionDefault } : {}),
};
}
function normalizeChoiceOption(value: unknown): MobileChoiceOption | null {
if (!isRecord(value)) return null;
const id = readString(value.id);
if (!id) return null;
return {
id,
label: readString(value.displayName) ?? id,
description: readString(value.description) ?? undefined,
};
}
function readString(value: unknown): string | null {
return typeof value === 'string' && value.length > 0 ? value : null;
}
function isRecord(value: unknown): value is Record<string, unknown> {
return !!value && typeof value === 'object' && !Array.isArray(value);
}
/** false = Standard, true = Fast; the string extends existing saved preferences. */
export type FastMode = boolean | 'ultrafast';
/** Legacy databases store Standard/Fast as 0/1. Keep both values unchanged. */
export function fastModeToStorage(value: unknown): number {
return value === 'ultrafast' || value === 2 ? 2 : value === true || value === 1 ? 1 : 0;
}
export function fastModeFromStorage(value: unknown): FastMode {
return value === 2 ? 'ultrafast' : value === 1 || value === true;
}