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。

5.9 KB
Raw Blame
export type ImDefaultAgentKind = 'claude-code' | 'codex' | 'pi';
export type ImDefaultPermissionMode =
  'ask' | 'default' | 'acceptEdits' | 'plan' | 'auto' | 'bypassPermissions';
export type ImDefaultEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'ultra';
/**
 * IM channel scopes that keep independent new-conversation routing preferences.
 * 'telegram' 指个人 Telegram bot(main/im/telegram);官方 Telegram hook 通道
 * 刻意读 global(channel=undefined, 见 hook-control/session-runner.ts), 不落
 * 在这个键上 — 两者互不影响。
 */
export type ImDefaultSettingsChannel =
  'feishu' | 'slack' | 'discord' | 'wechat' | 'telegram' | 'dingtalk' | 'wecom';

export interface ImDefaultAgentSettings {
  /** Agent 所在电脑;share:<id> 表示分享供应商,缺省为本机。 */
  agentDeviceId?: string | null;
  providerId: string | null;
  /** Empty means automatic selection from the current catalog, never a wire model ID. */
  model: string;
  effort: ImDefaultEffort;
}

export type ImDefaultAgentSettingsMap = Record<ImDefaultAgentKind, ImDefaultAgentSettings>;

export interface ImDefaultSettings {
  agentKind: ImDefaultAgentKind;
  permissionMode: ImDefaultPermissionMode;
  /**
   * **群里新建会话**统一用的权限档(当前仅 feishu 消费) —— 群/话题里 @bot 开
   * 新话题、群里 `/new`、群里 `/ctr` 全部以它为准, 不再各自继承上面那条
   * `permissionMode`(那条只管私聊)。群 lane 判定在 feishu adapter 的
   * `sessions.permissionModeFor`, /ctr 建会话另有一处(cardActionHandler)。
   *
   * 群上下文含成员可控内容, 默认 'auto'(自动审批)保留操作确认; 用户可在渠道
   * 设置里改成 'bypassPermissions'(完全访问) → 群护栏取缔, 直接执行。选到
   * 'acceptEdits' 等与强确认策略互斥的档位时群轮次会被拒绝, 由错误路径的私聊
   * 引导卡兜底切回。
   *
   * **不看「用户有没有手动改过」**: 默认值本身就是群里的判据(产品裁决 —— 群里
   * 的事只看这一行), 私聊那条设成完全访问不会顺带放开群。
   */
  groupPermissionMode: ImDefaultPermissionMode;
  agents: ImDefaultAgentSettingsMap;
}

export type ImDefaultSettingsPatch = Omit<Partial<ImDefaultSettings>, 'agents'> & {
  agents?: Partial<ImDefaultAgentSettingsMap>;
};

export interface ImDefaultSettingsState extends ImDefaultSettings {
  /** Read-only projection flag. The model shown is resolved; persisted automatic models remain empty. */
  automaticModel?: boolean;
  isCustomized: boolean;
  customizedKeys: string[];
  defaults: ImDefaultSettings;
}

export const IM_DEFAULT_SETTINGS: ImDefaultSettings = {
  agentKind: 'claude-code',
  permissionMode: 'auto',
  groupPermissionMode: 'auto',
  agents: {
    'claude-code': {
      providerId: null,
      model: '',
      effort: 'high',
    },
    codex: {
      providerId: null,
      model: '',
      effort: 'high',
    },
    // Empty defaults follow the common new-task policy; explicit selections stay fixed.
    pi: {
      providerId: null,
      model: '',
      effort: 'high',
    },
  },
};

export const IM_DEFAULT_SETTINGS_CHANNELS: readonly ImDefaultSettingsChannel[] = [
  'feishu',
  'slack',
  'discord',
  'wechat',
  'telegram',
  'dingtalk',
  'wecom',
];

export const IM_DEFAULT_EFFORT_OVERRIDES: Readonly<Partial<Record<string, ImDefaultEffort>>> = {
  'claude-opus-4-8': 'xhigh',
  'codex/gpt-5.5': 'high',
};

const AGENT_KINDS = new Set<ImDefaultAgentKind>(['claude-code', 'codex', 'pi']);
const EFFORTS = new Set<ImDefaultEffort>([
  'minimal',
  'low',
  'medium',
  'high',
  'xhigh',
  'max',
  'ultra',
]);
const PERMISSION_MODES = new Set<ImDefaultPermissionMode>([
  'ask',
  'default',
  'acceptEdits',
  'plan',
  'auto',
  'bypassPermissions',
]);

export const WECHAT_UNSUPPORTED_PERMISSION_MODES: readonly ImDefaultPermissionMode[] = [
  'acceptEdits',
  'bypassPermissions',
];

/**
 * 渠道对**任何消息**都挂 turnPermissionPolicy 的清单(与 main 侧 adapter 的
 * turnPermissionPolicy / turnPermissionPolicyFor 事实对齐):这些渠道把
 * 工具确认渲染成渠道文本提示,要求所选 Agent 声明 turnPermissionPolicy
 * capability。Pi 未声明该 capability,在这些渠道的任何权限模式下都不可用
 * (fail-closed);Claude Code / Codex 声明了,仅在个别权限模式不可用。
 *
 * 目前只有个人微信(WechatIM.turnPermissionPolicy)对每次 dispatch
 * 无条件挂 policy;Telegram / 钉钉的 turnPermissionPolicyFor 仅在群聊
 * (event.speaker 存在)时挂载,主人私聊不挂 → Pi 在私聊可用,设置 UI 不区分
 * 群聊/私聊,不能整体警告。新增渠道时先确认其 policy 挂载是否无条件。
 */
export const UNCONDITIONAL_TURN_POLICY_CHANNELS: readonly ImDefaultSettingsChannel[] = ['wechat'];

export function isUnconditionalTurnPolicyChannel(channel: ImDefaultSettingsChannel): boolean {
  return UNCONDITIONAL_TURN_POLICY_CHANNELS.includes(channel);
}

export function isImDefaultAgentKind(value: unknown): value is ImDefaultAgentKind {
  return typeof value === 'string' && AGENT_KINDS.has(value as ImDefaultAgentKind);
}

export function isImDefaultEffort(value: unknown): value is ImDefaultEffort {
  return typeof value === 'string' && EFFORTS.has(value as ImDefaultEffort);
}

export function isImDefaultPermissionMode(value: unknown): value is ImDefaultPermissionMode {
  return typeof value === 'string' && PERMISSION_MODES.has(value as ImDefaultPermissionMode);
}

export function isWechatUnsupportedPermissionMode(
  value: unknown,
): value is ImDefaultPermissionMode {
  return isImDefaultPermissionMode(value) && WECHAT_UNSUPPORTED_PERMISSION_MODES.includes(value);
}

export function isImDefaultSettingsChannel(value: unknown): value is ImDefaultSettingsChannel {
  return (
    typeof value === 'string' &&
    IM_DEFAULT_SETTINGS_CHANNELS.includes(value as ImDefaultSettingsChannel)
  );
}