Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

15.9 KB
Raw Blame
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;
}