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。

11.7 KB
Raw Blame
/**
 * deviceLinkDraftDefaults —— device-link 远程项目草稿的「选中模型默认值」解析(纯函数)。
 *
 * 背景:控制端为被控设备新建项目草稿时,要**全量镜像被控端当前 New Maker 草稿**
 * (model/effort/fast/permission/source),绝不取控制端本地草稿。被控端草稿值经隧道
 * `maker:get-new-maker-defaults` 拉到(可能为 null:旧版被控端无此 channel / 拉取失败),
 * 本函数把它**按被控端 capabilities 校准**后给出可直接 seed 的一组值;remoteDraft 为 null
 * 时回落纯 capabilities 默认(用户决策:旧版被控端回落被控端默认,绝不回落控制端本地)。
 *
 * 抽成纯函数(不依赖 React / IPC)是为了可在 node 直接单测 seed/clamp/fallback 三条路径
 * (规则 9:用代码而非 prompt 固化确定性;规则 14:main 外的高风险派生逻辑也补测)。
 *
 * 注:providerId(来源)这里**原样透传**——它的合法性(是否被控端已连来源 / 是否 offer 该
 * 模型)由 ChatInput 的 effectiveSourceId 统一校准(不在连接栏内即回落 nativeDefault),
 * 与「会话内切来源」同一口径,不在本函数重复一套。
 */

import {
  effectiveSourceIdForModel,
  getModel,
  type ProviderView,
} from '@cindy/model-providers';
import type { AgentCapabilities, AgentKind } from '@/hooks/useAgentCapabilities';
import type { Effort, PermissionMode } from '@/lib/userPreferences.types';

/** 被控端当前草稿的原始值(maker:get-new-maker-defaults 隧道返回;字段全可选)。 */
export interface RemoteDraftDefaults {
  model?: string;
  /** false = 被控端明确未在 New Maker picker 选过模型;undefined = 旧端未知。 */
  modelChosenByUser?: boolean;
  effort?: string | null;
  fastMode?: boolean | 'ultrafast';
  permissionMode?: string;
  providerId?: string | null;
  /**
   * 被控端「每个模型各自记忆」的 effort / fast。控制端在远程草稿里切到**非当前选中**模型时,
   * 按目标 model id 查这两张表还原被控端记的值;旧版被控端不回 → undefined → 回落该模型 capabilities 默认。
   */
  effortByModel?: Record<string, string>;
  fastModeByModel?: Record<string, boolean | 'ultrafast'>;
  /**
   * 被控端 providerModelMemory 全量快照;`${agent}:*` 是模型级全局预设,
   * `${agent}:${providerId}` 是旧 v2 兼容副本。device-link 草稿列表行据此镜像被控端预设;
   * 旧版被控端不回 → undefined → 控制端非选中行回落 capabilities 默认。
   */
  providerModelMemory?: Record<
    string,
    { effortByModel: Record<string, string>; fastByModel: Record<string, boolean | 'ultrafast'> }
  >;
  /**
   * 被控端「新建会话默认启用 worktree」勾选记忆(vendor 无关根字段)。控制端远程草稿
   * 据此播种 worktree chip 初始态;旧版被控端不回 → undefined → 按未勾选兜底。
   * 不参与 resolveDeviceLinkDraftDefaults 的 per-vendor 解析(消费方直接读)。
   */
  worktreeEnabled?: boolean;
}

/** 校准后可直接 seed 控制端草稿 holder 的一组值。 */
export interface DeviceLinkDraftSelection {
  model: string;
  effort: Effort | null;
  fastMode: boolean | 'ultrafast';
  /** 仍是被控端支持的权限档则带上;否则 undefined(由 ChatInput 回落自身默认)。 */
  permissionMode?: PermissionMode;
  /** 来源透传,合法性交 ChatInput 校准;null = 跟随被控端默认路由。 */
  providerId: string | null;
}

/**
 * 新设备或 Agent 始终需要 seed;同一目标的新默认可更新未编辑的草稿。
 * 仅能力刷新时,仍须被控端明确从未选过模型才重新选区域默认。
 */
export function shouldReseedDeviceLinkDraftDefaults(input: {
  currentSeedKey: string | null;
  nextSeedKey: string;
  capabilitiesChanged: boolean;
  defaultsChanged?: boolean;
  controllerTouched: boolean;
  remoteModelChosenByUser: boolean | undefined;
}): boolean {
  if (input.currentSeedKey !== input.nextSeedKey) return true;
  return (
    !input.controllerTouched && (input.defaultsChanged === true
      || (input.capabilitiesChanged && input.remoteModelChosenByUser === false))
  );
}

/** worktree 勾选镜像的一帧输入:当前草稿目标设备 + 当时的远端草稿快照(按引用比较)。 */
export interface DeviceLinkWorktreeEnabledFrame {
  deviceId: string | null;
  remoteDraftState: {
    status: 'idle' | 'loading' | 'ready' | 'error';
    value: Pick<RemoteDraftDefaults, 'worktreeEnabled'> | null;
  };
}

/**
 * device-link 草稿的 worktree 勾选 = 被控端勾选记忆的镜像。返回要写入的勾选值,
 * null = 保持当前显示不变。
 *
 *   - 切设备:先回到默认未勾选;若这一帧的快照对象仍是上一帧那份(属于上一台设备),
 *     不得用它播种新设备,等新设备自己的快照到达。
 *   - 切设备时同一批更新里就带来了新设备快照(设备域浏览器 inline 拉取后直接 seed,
 *     且会跳过 hook 的再次拉取):必须立刻采用,否则此后再无快照变化能把勾选恢复,
 *     被控端已勾选 worktree 却静默按普通会话建在默认分支上。
 *   - 同设备:快照 ready 且带明确 boolean 才采用;缺字段 / 拉取中保留最后镜像。
 */
export function resolveDeviceLinkWorktreeEnabled(
  previous: DeviceLinkWorktreeEnabledFrame | null,
  current: DeviceLinkWorktreeEnabledFrame,
): boolean | null {
  const deviceChanged = !previous || previous.deviceId !== current.deviceId;
  const snapshotFromPreviousDevice =
    deviceChanged && previous?.remoteDraftState === current.remoteDraftState;
  const remotePreference =
    current.remoteDraftState.status === 'ready'
      ? current.remoteDraftState.value?.worktreeEnabled
      : undefined;
  if (!snapshotFromPreviousDevice && typeof remotePreference === 'boolean') {
    return remotePreference;
  }
  return deviceChanged ? false : null;
}

/**
 * 把被控端草稿值(或 null=回落)按被控端 capabilities 校准成可 seed 的选择。
 *   - model:要解析的模型 = targetModel(用户在草稿里切模型)优先,否则 remoteDraft.model(初始 seed);
 *     该 id 在被控端清单内则用它,否则被控端 availableModels[0]。
 *   - 传 agentKind(New Maker 正式路径)时,effort/fast 优先读 `${agent}:*` 全局模型预设——首页
 *     没有运行中会话,当前显示模型也不受保护。兼容调用未传 agentKind 时保留旧顺序:
 *       · 当前模型 → 草稿激活值 remoteDraft.effort / remoteDraft.fastMode;
 *       · 其它模型 → per-model 记忆 effortByModel[id] / fastModeByModel[id]。
 *     最终 effort 仍按目标模型 efforts 校验(不支持则落 defaultEffort);fast 仍按 agent×模型 能力门控。
 *   - permissionMode:被控端支持该档才带,否则 undefined(非按模型记)。
 *   - providerId:原样透传(下游 clamp;非按模型记)。
 * capabilities.availableModels 为空(理论不该发生)→ 退化返回安全兜底。
 */
export function resolveDeviceLinkDraftDefaults(
  capabilities: AgentCapabilities,
  remoteDraft: RemoteDraftDefaults | null,
  targetModel?: string,
  agentKind?: AgentKind,
  providers?: ProviderView[],
): DeviceLinkDraftSelection {
  const models = capabilities.availableModels;
  const providerId = remoteDraft?.providerId ?? null;
  const permissionMode = pickPermissionMode(capabilities, remoteDraft?.permissionMode);

  // 要解析哪个模型:控制端本次显式 targetModel(切模型)永远优先。初始 seed 只有在**新端明确
  // 回传未选过模型**时才采用区域目录默认;旧端缺字段时保守保留 remoteDraft.model,避免
  // 把无法识别的历史显式选择覆盖掉。每个 Agent 只接受自己的 v3 默认标记。
  const markedDefault = agentKind
    ? models
        .map((model, index) => ({ model, index }))
        .filter(
          ({ model }) =>
            model.defaultEnabled !== false &&
            (model.newSessionDefault?.includes(agentKind) ?? false),
        )
        .sort(
          (a, b) =>
            (a.model.sortOrder ?? Number.MAX_SAFE_INTEGER) -
              (b.model.sortOrder ?? Number.MAX_SAFE_INTEGER) || a.index - b.index,
        )[0]?.model.id
    : undefined;
  const wantedModelId =
    targetModel ??
    (remoteDraft?.modelChosenByUser === false && providerId === null
      ? (markedDefault ?? remoteDraft.model)
      : remoteDraft?.model);

  if (models.length === 0) {
    return {
      model: wantedModelId ?? '',
      effort: (remoteDraft?.effort as Effort | null | undefined) ?? 'high',
      fastMode: false,
      permissionMode,
      providerId,
    };
  }

  const chosen = models.find((m) => m.id === wantedModelId) ?? models[0];
  const selectedProviderId =
    agentKind && providers?.length
      ? remoteDraft?.providerId ??
        effectiveSourceIdForModel(providers, null, chosen.id, agentKind)
      : null;
  const selectedProvider = selectedProviderId
    ? providers?.find((provider) => provider.id === selectedProviderId)
    : undefined;
  const providerModel = selectedProvider && agentKind
    ? getModel(selectedProvider, chosen.id, agentKind)
    : undefined;
  // capabilities.availableModels is a cross-provider union. If the selected source has
  // its own entry, its effort table is authoritative; otherwise keep the flat snapshot
  // for old hosts that do not expose provider catalogs.
  const effortModel = providerModel ?? chosen;
  const globalPreset = agentKind ? remoteDraft?.providerModelMemory?.[`${agentKind}:*`] : undefined;
  const providerPreset =
    agentKind && providerId
      ? remoteDraft?.providerModelMemory?.[`${agentKind}:${providerId}`]
      : undefined;
  // 解析的是不是被控端当前选中模型:是 → 草稿激活值;否 → per-model 记忆(切模型还原)。
  const isActiveModel = chosen.id === remoteDraft?.model;
  // 新建草稿没有 live 会话需要保护:全局模型预设存在时,即使是首页当前显示模型也优先采用。
  // agentKind 缺失时保留旧调用方语义,方便旧测试 / 兼容入口逐步迁移。
  // 新快照写 `${agent}:*` 权威槽;旧快照仍可能只有 `${agent}:${providerId}` 来源副本 —— 全局优先,
  // 来源兜底(两处 doc 都这么承诺,实现必须同序,否则同模型换来源就换回旧档位)。
  const wantedEffort = (globalPreset?.effortByModel[chosen.id] ??
    providerPreset?.effortByModel[chosen.id] ??
    (isActiveModel ? remoteDraft?.effort : remoteDraft?.effortByModel?.[chosen.id])) as
    Effort | undefined;
  const presetFast =
    globalPreset?.fastByModel[chosen.id] ?? providerPreset?.fastByModel[chosen.id];
  const wantedFast =
    presetFast ??
    (isActiveModel
      ? (remoteDraft?.fastMode ?? false)
      : (remoteDraft?.fastModeByModel?.[chosen.id] ?? false));
  const supportedEfforts = effortModel.efforts as readonly string[];

  const effort: Effort | null =
    supportedEfforts.length === 0
      ? effortModel.effortsUnknown === false
        ? null
        : wantedEffort ?? effortModel.defaultEffort ?? 'high'
      : wantedEffort && supportedEfforts.includes(wantedEffort)
        ? wantedEffort
        : (effortModel.defaultEffort ?? supportedEfforts[0] ?? wantedEffort ?? 'high');
  const fastMode = capabilities.hasFastMode && chosen.supportsFastMode && (wantedFast !== 'ultrafast' || chosen.supportsUltrafastMode === true) ? wantedFast : false;

  return { model: chosen.id, effort, fastMode, permissionMode, providerId };
}

/** 被控端草稿权限档仍在被控端支持列表里则带上,否则 undefined(ChatInput 回落自身默认)。 */
function pickPermissionMode(
  capabilities: AgentCapabilities,
  raw: string | undefined,
): PermissionMode | undefined {
  if (!raw) return undefined;
  return capabilities.permissionModes.some((p) => p.id === raw)
    ? (raw as PermissionMode)
    : undefined;
}