@cicctencent/agent-core 0.1.1 → 0.1.4

package/src/agent/types.ts

@@ -1,136 +0,0 @@
-// ============================================================
-// Agent Engine 类型定义
-// ============================================================
-
-import type { LLMProvider } from '../llm/types.ts';
-import type { ToolRegistry } from '../tool/registry.ts';
-import type { SkillManager } from '../skill/manager.ts';
-import type { SkillRouter } from '../skill/router.ts';
-import type { ContextManager } from '../context/manager.ts';
-import type { SecurityGuard } from '../security/guard.ts';
-import type { SessionContext } from '../types.ts';
-import type { Hook } from '../hooks/types.ts';
-import type { Middleware } from '../middleware/types.ts';
-
-/** 上下文卸载条目（工具结果摘要 + 原文引用，用于非破坏性压缩） */
-export interface OffloadEntry {
-  /** 唯一引用 ID，格式：{toolName}_{timestamp}_{hash} */
-  nodeId: string;
-  /** 工具名称 */
-  toolName: string;
-  /** 摘要标签内容（注入到上下文中的轻量摘要） */
-  summary: string;
-  /** 原文存储路径 */
-  filePath: string;
-  /** 创建时间（毫秒时间戳） */
-  createdAt: number;
-  /** 原文字符数 */
-  charCount: number;
-  /** 所属会话 ID */
-  sessionId: string;
-}
-
-/** 工具结果存储接口（超大结果写入文件，按需读取） */
-export interface ToolResultStore {
-  /** 写入工具结果，返回存储路径 */
-  write(callId: string, content: string): string;
-  /** 读取工具结果 */
-  read(callId: string): string | null;
-  /** 检查是否存在 */
-  has(callId: string): boolean;
-  /** 写入上下文卸载条目（content 为原文，entry.summary 为摘要标签），返回存储路径 */
-  writeOffload(entry: Omit<OffloadEntry, 'filePath'>, content: string): string;
-  /** 读取卸载条目的原文 */
-  readOffload(nodeId: string): string | null;
-  /** 列出指定会话的所有卸载条目 */
-  listOffloads(sessionId: string): OffloadEntry[];
-}
-
-/** LLM 重试策略配置 */
-export interface RetryPolicy {
-  /** 最大重试次数，默认 3 */
-  maxRetries?: number;
-  /** 首次重试延迟（毫秒），默认 1000 */
-  initialDelay?: number;
-  /** 最大延迟（毫秒），默认 30000 */
-  maxDelay?: number;
-  /** 退避因子（每次延迟乘以此值），默认 2 */
-  backoffFactor?: number;
-}
-
-/** AgentEngine 构造参数 */
-export interface AgentConfig {
-  /** 单次任务最大迭代轮次，默认 15 */
-  maxIterations?: number;
-  /** 消息历史上限（滑动窗口），默认 50 */
-  maxMessages?: number;
-  /** 单工具执行超时（毫秒），默认 30000 */
-  toolTimeout?: number;
-  /** LLM 推理超时（毫秒），默认 120000 */
-  llmTimeout?: number;
-  /** Agent 系统提示词基础模板 */
-  basePrompt?: string;
-  /** LLM Provider 实例 */
-  llmProvider: LLMProvider;
-  /** Tool Registry 实例 */
-  toolRegistry: ToolRegistry;
-  /** Skill Manager 实例（可选） */
-  skillManager?: SkillManager;
-  /** Skill Router 实例（可选） */
-  skillRouter?: SkillRouter;
-  /** Context Manager 实例 */
-  contextManager: ContextManager;
-  /** Security Guard 实例（可选） */
-  securityGuard?: SecurityGuard;
-  /** 默认工具列表（静态注入） */
-  defaultTools?: string[];
-  /** 上下文压缩配置 */
-  contextBudget?: {
-    /** 单条工具输出最大字符数，默认 8000 */
-    maxToolOutput?: number;
-    /** 历史消息数达到此阈值时触发压缩，默认 maxMessages * 0.8 */
-    compactThreshold?: number;
-    /** 上下文总 token 预算，超过此值触发智能压缩，默认 100000 */
-    maxContextTokens?: number;
-  };
-  /** 全局禁止的工具名列表（从 LLM 视野中移除） */
-  deniedTools?: string[];
-  /** 生命周期钩子列表 */
-  hooks?: Hook[];
-  /** 中间件管道（与 Hook 共存，提供更结构化的 before/after 生命周期） */
-  middleware?: Middleware[];
-  /** 工具发现模式：'full' 全量加载 schema，'summary' 渐进式摘要发现，默认 'full' */
-  toolDiscovery?: 'full' | 'summary';
-  /** 工具摘要模式下描述最大长度（字符数），默认 100 */
-  toolSummaryMaxDesc?: number;
-  /** LLM 调用重试策略（模型韧性） */
-  retryPolicy?: RetryPolicy;
-  /** 降级 LLM Provider（主 Provider 重试耗尽后切换） */
-  fallbackProvider?: LLMProvider;
-  /** 工具结果存储（超大结果写入文件，按需读取） */
-  toolResultStore?: ToolResultStore;
-  /** 数据获取类工具名列表（用于循环检测，默认 ['web_fetch', 'execute_command', 'write_file', 'append_file', 'run_script', 'read_file', 'read_tool_doc']） */
-  dataFetchTools?: string[];
-  /** 产出型工具名列表（有这些工具调用时不触发数据获取循环检测，默认 ['delegate_task', 'create_presentation', 'create_document', 'create_pdf', 'show_widget', 'save_artifact']） */
-  outputTools?: string[];
-}
-
-/** AgentEngine.run() 入参 */
-export interface RunOptions {
-  /** 会话 ID（同一会话共享上下文） */
-  sessionId: string;
-  /** 用户输入消息 */
-  message: string;
-  /** 显式指定 Skill ID（跳过路由） */
-  skillId?: string;
-  /** 额外注入的工具名称列表（动态注入） */
-  extraTools?: string[];
-  /** 会话上下文（上层传入） */
-  context?: SessionContext;
-  /** 中断信号（上层取消时使用） */
-  abortSignal?: AbortSignal;
-  /** 本次执行覆盖的 system prompt 片段（追加到 basePrompt 之后） */
-  systemPromptOverride?: string;
-  /** 扩展参数 */
-  options?: Record<string, unknown>;
-}

package/src/agent/workflow.ts

@@ -1,339 +0,0 @@
-// ============================================================
-// Agent Workflow — 多 Agent 工作流结构化产物与阶段辅助
-// ============================================================
-
-export type WorkflowRole =
-  | 'researcher'
-  | 'implementer'
-  | 'reviewer'
-  | 'critic'
-  | 'risk_checker'
-  | 'final_approver'
-  | 'bull_researcher'
-  | 'bear_researcher';
-
-export interface WorkflowStageTemplate {
-  id: string;
-  role: WorkflowRole;
-  title: string;
-  instruction: string;
-  requiredFor: 'complex' | 'high_risk';
-}
-
-export interface WorkflowTemplate {
-  id: string;
-  name: string;
-  description: string;
-  stages: WorkflowStageTemplate[];
-}
-
-export interface WorkflowDecisionLog {
-  task: string;
-  agentName: string;
-  role?: WorkflowRole | string;
-  stage: string;
-  recommendation: string;
-  confidence: number;
-  findings: string[];
-  risks: string[];
-  next_actions: string[];
-}
-
-export interface StructuredAgentOutput {
-  role?: WorkflowRole | string;
-  summary?: string;
-  findings: string[];
-  risks: string[];
-  recommendation: string;
-  confidence: number;
-  next_actions: string[];
-  rawContent?: string;
-}
-
-export interface WorkflowCheckpoint {
-  id: string;
-  stage: string;
-  agentName?: string;
-  status: 'started' | 'completed' | 'failed';
-  timestamp: number;
-  summary?: string;
-  /** 阶段恢复上下文（用于节点级续跑） */
-  context?: {
-    task: string;
-    priorOutputs: string[];
-    stageIndex: number;
-  };
-}
-
-/** 辩论输出结构（Bull/Bear Debate） */
-export interface DebateOutput {
-  topic: string;
-  bull_arguments: string[];
-  bear_arguments: string[];
-  synthesis: string;
-  unresolved_points: string[];
-  confidence: number;
-}
-
-const STRUCTURED_OUTPUT_SCHEMA = `{
-  "role": "researcher | implementer | reviewer | critic | risk_checker | final_approver",
-  "summary": "one short summary sentence",
-  "findings": ["verified facts or completed work"],
-  "risks": ["risks, gaps, blockers, or opposing views"],
-  "recommendation": "recommended decision or final answer",
-  "confidence": 0.0,
-  "next_actions": ["concrete follow-up actions"]
-}`;
-
-export const DEFAULT_COMPLEX_WORKFLOW_TEMPLATE: WorkflowTemplate = {
-  id: 'complex_task_balanced_review',
-  name: 'Balanced multi-agent review',
-  description: 'Analyze, propose, challenge, risk-check, and approve complex or high-impact tasks.',
-  stages: [
-    {
-      id: 'analyze',
-      role: 'researcher',
-      title: 'Analyze context',
-      instruction: 'Collect facts, constraints, existing implementation details, and unknowns before deciding.',
-      requiredFor: 'complex',
-    },
-    {
-      id: 'debate',
-      role: 'bull_researcher',
-      title: 'Bull vs Bear debate',
-      instruction: 'For high-risk decisions, run parallel bull (pro) and bear (con) arguments, then synthesize both perspectives before proceeding.',
-      requiredFor: 'high_risk',
-    },
-    {
-      id: 'implement',
-      role: 'implementer',
-      title: 'Propose or implement solution',
-      instruction: 'Turn the analysis into a concrete plan or implementation with clear tradeoffs.',
-      requiredFor: 'complex',
-    },
-    {
-      id: 'criticize',
-      role: 'critic',
-      title: 'Challenge assumptions',
-      instruction: 'Actively look for flaws, missing edge cases, and opposing evidence.',
-      requiredFor: 'high_risk',
-    },
-    {
-      id: 'risk-check',
-      role: 'risk_checker',
-      title: 'Check operational risks',
-      instruction: 'Assess safety, security, data integrity, reversibility, and user-impact risks.',
-      requiredFor: 'high_risk',
-    },
-    {
-      id: 'review',
-      role: 'reviewer',
-      title: 'Review final result',
-      instruction: 'Verify the result against the task, identify gaps, and recommend whether to finalize.',
-      requiredFor: 'complex',
-    },
-  ],
-};
-
-export function getWorkflowTemplate(id: string = DEFAULT_COMPLEX_WORKFLOW_TEMPLATE.id): WorkflowTemplate | undefined {
-  return id === DEFAULT_COMPLEX_WORKFLOW_TEMPLATE.id ? DEFAULT_COMPLEX_WORKFLOW_TEMPLATE : undefined;
-}
-
-export function getWorkflowRoleStage(role?: WorkflowRole | string): string {
-  switch (role) {
-    case 'implementer': return 'implement';
-    case 'reviewer': return 'review';
-    case 'critic': return 'criticize';
-    case 'risk_checker': return 'risk-check';
-    case 'final_approver': return 'approve';
-    case 'bull_researcher':
-    case 'bear_researcher': return 'debate';
-    case 'researcher':
-    default:
-      return 'analyze';
-  }
-}
-
-export function formatWorkflowTemplateForPrompt(template: WorkflowTemplate = DEFAULT_COMPLEX_WORKFLOW_TEMPLATE): string {
-  return template.stages
-    .map((stage, index) => `${index + 1}. ${stage.id} (${stage.role}) — ${stage.instruction}`)
-    .join('\n');
-}
-
-export function buildWorkflowDecisionMemory(log: WorkflowDecisionLog): string {
-  const lines = [
-    `Task: ${log.task}`,
-    `Agent: ${log.agentName}`,
-    `Role: ${log.role || 'unknown'}`,
-    `Stage: ${log.stage}`,
-    `Recommendation: ${log.recommendation}`,
-    `Confidence: ${clampConfidence(log.confidence).toFixed(2)}`,
-  ];
-
-  if (log.findings.length > 0) lines.push(`Findings: ${log.findings.join(' | ')}`);
-  if (log.risks.length > 0) lines.push(`Risks: ${log.risks.join(' | ')}`);
-  if (log.next_actions.length > 0) lines.push(`Next actions: ${log.next_actions.join(' | ')}`);
-
-  return lines.join('\n');
-}
-
-
-
-export function buildStructuredOutputInstruction(role?: WorkflowRole | string): string {
-  const roleLine = role ? `You are acting as workflow role: ${role}.` : 'Infer the most appropriate workflow role for this subtask.';
-  return `${roleLine}
-
-Return your final answer in two parts:
-1. A concise human-readable answer.
-2. A fenced JSON block named \`structured_agent_output\` that follows this schema exactly:
-\`\`\`structured_agent_output
-${STRUCTURED_OUTPUT_SCHEMA}
-\`\`\`
-
-Rules:
-- Keep findings and risks factual and concise.
-- Use confidence from 0 to 1.
-- Include risks even when the task succeeds.
-- Include next_actions even if the next action is only final approval.`;
-}
-
-export function wrapTaskWithWorkflowInstructions(task: string, role?: WorkflowRole | string): string {
-  return `${task}\n\n---\n${buildStructuredOutputInstruction(role)}`;
-}
-
-export function parseStructuredAgentOutput(content: string, fallbackRole?: WorkflowRole | string): StructuredAgentOutput {
-  const parsed = extractStructuredJson(content);
-  if (parsed) return normalizeStructuredOutput(parsed, content, fallbackRole);
-
-  return {
-    role: fallbackRole,
-    summary: firstNonEmptyLine(content),
-    findings: [content.trim()].filter(Boolean),
-    risks: [],
-    recommendation: content.trim() || 'No recommendation provided.',
-    confidence: 0.5,
-    next_actions: [],
-    rawContent: content,
-  };
-}
-
-export function formatStructuredAgentOutput(agentName: string, output: StructuredAgentOutput, iterations?: number, toolSummary: string[] = []): string {
-  const lines = [
-    `## Structured sub-agent result: ${agentName}`,
-    output.role ? `- role: ${output.role}` : '',
-    output.summary ? `- summary: ${output.summary}` : '',
-    `- confidence: ${clampConfidence(output.confidence).toFixed(2)}`,
-    '',
-    '### findings',
-    ...formatList(output.findings),
-    '',
-    '### risks',
-    ...formatList(output.risks),
-    '',
-    '### recommendation',
-    output.recommendation || 'No recommendation provided.',
-    '',
-    '### next_actions',
-    ...formatList(output.next_actions),
-  ].filter(line => line !== '');
-
-  if (typeof iterations === 'number' || toolSummary.length > 0) {
-    lines.push('', '---', `[Sub-agent ${agentName}: ${iterations ?? 0} iterations${toolSummary.length ? `, tools: ${toolSummary.join(', ')}` : ''}]`);
-  }
-
-  return lines.join('\n');
-}
-
-function extractStructuredJson(content: string): unknown | null {
-  const fenced = content.match(/```(?:structured_agent_output|json)?\s*([\s\S]*?)```/i);
-  const candidate = fenced?.[1]?.trim() || (content.trim().startsWith('{') ? content.trim() : '');
-  if (!candidate) return null;
-
-  try {
-    return JSON.parse(candidate);
-  } catch {
-    return null;
-  }
-}
-
-function normalizeStructuredOutput(value: unknown, rawContent: string, fallbackRole?: WorkflowRole | string): StructuredAgentOutput {
-  const obj = (value && typeof value === 'object' ? value : {}) as Record<string, unknown>;
-  return {
-    role: stringOrUndefined(obj.role) || fallbackRole,
-    summary: stringOrUndefined(obj.summary) || firstNonEmptyLine(rawContent),
-    findings: stringArray(obj.findings),
-    risks: stringArray(obj.risks),
-    recommendation: stringOrUndefined(obj.recommendation) || firstNonEmptyLine(rawContent) || 'No recommendation provided.',
-    confidence: clampConfidence(typeof obj.confidence === 'number' ? obj.confidence : Number(obj.confidence ?? 0.5)),
-    next_actions: stringArray(obj.next_actions),
-    rawContent,
-  };
-}
-
-function stringArray(value: unknown): string[] {
-  if (Array.isArray(value)) return value.map(item => String(item).trim()).filter(Boolean);
-  if (typeof value === 'string' && value.trim()) return [value.trim()];
-  return [];
-}
-
-function stringOrUndefined(value: unknown): string | undefined {
-  return typeof value === 'string' && value.trim() ? value.trim() : undefined;
-}
-
-function firstNonEmptyLine(content: string): string {
-  return content.split('\n').map(line => line.trim()).find(Boolean) || '';
-}
-
-export function buildDebateInstructions(topic: string, context?: string): { bull: string; bear: string } {
-  const contextBlock = context ? `\n\nContext:\n${context}` : '';
-  return {
-    bull: `You are the BULL (proponent) researcher in a structured debate.\n\nTopic: ${topic}${contextBlock}\n\nYour role:\n- Argue IN FAVOR of this proposal/decision\n- Present the strongest evidence, benefits, and opportunities\n- Identify advantages, competitive edges, and positive outcomes\n- Be specific with data and examples, not vague optimism\n\nReturn your arguments in the structured_agent_output format with findings = your pro arguments, risks = weaknesses in your own position (intellectual honesty), recommendation = your pro-decision stance.`,
-    bear: `You are the BEAR (opponent) researcher in a structured debate.\n\nTopic: ${topic}${contextBlock}\n\nYour role:\n- Argue AGAINST this proposal/decision\n- Present the strongest counter-evidence, risks, and opportunity costs\n- Identify failure modes, hidden assumptions, and negative externalities\n- Be specific with data and examples, not vague pessimism\n\nReturn your arguments in the structured_agent_output format with findings = your con arguments, risks = what could go wrong if we proceed, recommendation = your anti-decision stance.`,
-  };
-}
-
-export function formatDebateOutput(debate: DebateOutput): string {
-  const lines = [
-    `## Debate: ${debate.topic}`,
-    '',
-    '### Bull (Pro) Arguments',
-    ...debate.bull_arguments.map(a => `- ${a}`),
-    '',
-    '### Bear (Con) Arguments',
-    ...debate.bear_arguments.map(a => `- ${a}`),
-    '',
-    '### Synthesis',
-    debate.synthesis,
-    '',
-  ];
-  if (debate.unresolved_points.length > 0) {
-    lines.push('### Unresolved Points');
-    lines.push(...debate.unresolved_points.map(p => `- ${p}`));
-    lines.push('');
-  }
-  lines.push(`Confidence: ${debate.confidence.toFixed(2)}`);
-  return lines.join('\n');
-}
-
-export function parseDebateOutput(bullOutput: StructuredAgentOutput, bearOutput: StructuredAgentOutput, topic: string): DebateOutput {
-  return {
-    topic,
-    bull_arguments: bullOutput.findings,
-    bear_arguments: bearOutput.findings,
-    synthesis: `Bull recommends: ${bullOutput.recommendation} (confidence ${bullOutput.confidence.toFixed(2)}). Bear recommends: ${bearOutput.recommendation} (confidence ${bearOutput.confidence.toFixed(2)}).`,
-    unresolved_points: [
-      ...bullOutput.risks.map(r => `Bull acknowledges: ${r}`),
-      ...bearOutput.risks.map(r => `Bear warns: ${r}`),
-    ],
-    confidence: (bullOutput.confidence + bearOutput.confidence) / 2,
-  };
-}
-
-function clampConfidence(value: number): number {
-  if (!Number.isFinite(value)) return 0.5;
-  return Math.max(0, Math.min(1, value));
-}
-
-function formatList(items: string[]): string[] {
-  return items.length > 0 ? items.map(item => `- ${item}`) : ['- None'];
-}

package/src/context/collector.ts

@@ -1,59 +0,0 @@
-// ============================================================
-// EnvCollector — 默认本地环境采集实现
-// ============================================================
-
-import * as os from 'os';
-import type { EnvInfo, EnvCollector as IEnvCollector } from './types.ts';
-
-/**
- * 默认本地环境采集器
- * 采集当前机器的 OS、CPU、内存、Shell 等信息
- * 上层可替换为远程采集实现（如 SSH 采集）
- */
-export class LocalEnvCollector implements IEnvCollector {
-  async collect(): Promise<EnvInfo> {
-    const platform = os.platform();
-    const hostname = os.hostname();
-    const user = os.userInfo().username;
-    const cpuCores = os.cpus().length;
-    const totalMem = os.totalmem();
-    const freeMem = os.freemem();
-
-    return {
-      os: `${os.type()} ${os.release()} ${os.arch()}`,
-      platform,
-      cpuCores,
-      memory: `${this.formatBytes(totalMem)} total, ${this.formatBytes(freeMem)} available`,
-      disk: 'N/A', // 磁盘信息需要 shell 命令采集，此处留空
-      shell: process.env.SHELL || process.env.COMSPEC || '/bin/sh',
-      hostname,
-      user,
-    };
-  }
-
-  format(info: EnvInfo): string {
-    const lines: string[] = [
-      `- OS: ${info.os}`,
-      `- Platform: ${info.platform}`,
-      `- CPU Cores: ${info.cpuCores}`,
-      `- Memory: ${info.memory}`,
-      `- Disk: ${info.disk}`,
-      `- Shell: ${info.shell}`,
-    ];
-    if (info.hostname) lines.push(`- Hostname: ${info.hostname}`);
-    if (info.user) lines.push(`- User: ${info.user}`);
-    if (info.custom) {
-      for (const [key, value] of Object.entries(info.custom)) {
-        lines.push(`- ${key}: ${value}`);
-      }
-    }
-    return lines.join('\n');
-  }
-
-  private formatBytes(bytes: number): string {
-    const gb = bytes / (1024 * 1024 * 1024);
-    if (gb >= 1) return `${gb.toFixed(1)}G`;
-    const mb = bytes / (1024 * 1024);
-    return `${mb.toFixed(0)}M`;
-  }
-}

package/src/context/manager.ts

@@ -1,40 +0,0 @@
-// ============================================================
-// ContextManager — 消息构建器
-// ============================================================
-
-import type { Message } from '../types.ts';
-import type { BuildContextOptions } from './types.ts';
-
-/**
- * 消息构建器（纯函数式，无状态）
- *
- * 仅负责将上层传入的 systemPrompt + history + userMessage 组装为 LLM 请求消息列表。
- * 不关心 prompt 内容来源（环境、终端、Skill 等），不维护历史。
- */
-export class ContextManager {
-
-  /**
-   * 构建完整的 LLM 请求消息列表
-   * 组装顺序：system prompt → extra prompt → history → user message
-   */
-  buildMessages(options: BuildContextOptions): Message[] {
-    const messages: Message[] = [];
-
-    // ① 系统提示词（上层已组装完成）
-    let systemPrompt = options.systemPrompt;
-    if (options.extraSystemPrompt) {
-      systemPrompt += `\n\n${options.extraSystemPrompt}`;
-    }
-    messages.push({ role: 'system', content: systemPrompt });
-
-    // ② 对话历史（上层通过 history 参数传入）
-    if (options.history?.length) {
-      messages.push(...options.history);
-    }
-
-    // ③ 当前用户输入
-    messages.push({ role: 'user', content: options.userMessage });
-
-    return messages;
-  }
-}

package/src/context/types.ts

@@ -1,51 +0,0 @@
-// ============================================================
-// Context Manager 类型定义
-// ============================================================
-
-import type { Message } from '../types.ts';
-
-// ---- EnvInfo — 环境信息 ----
-
-export interface EnvInfo {
-  /** 操作系统信息，e.g. "Linux 5.15.0 x86_64" */
-  os: string;
-  /** 平台标识 */
-  platform: string; // 'linux' | 'darwin' | 'win32'
-  /** CPU 核心数 */
-  cpuCores: number;
-  /** 内存信息，e.g. "16G total, 8G available" */
-  memory: string;
-  /** 磁盘信息，e.g. "/dev/sda1 50G 80%" */
-  disk: string;
-  /** Shell 路径，e.g. "/bin/bash" */
-  shell: string;
-  /** 主机名 */
-  hostname?: string;
-  /** 当前用户 */
-  user?: string;
-  /** 自定义扩展（如 Docker 版本、K8s 版本等） */
-  custom?: Record<string, string>;
-}
-
-// ---- BuildContextOptions — 上下文构建参数 ----
-
-export interface BuildContextOptions {
-  /** 完整的系统提示词（由上层组装完成，core 不关心内容来源） */
-  systemPrompt: string;
-  /** 对话历史（由上层管理，core 仅负责插入到消息列表中） */
-  history?: Message[];
-  /** 用户当前输入 */
-  userMessage: string;
-  /** 额外系统提示片段（上层注入，追加到 systemPrompt 之后） */
-  extraSystemPrompt?: string;
-}
-
-// ---- EnvCollector — 环境采集接口 ----
-
-/** 环境采集器接口（上层实现本地/远程采集） */
-export interface EnvCollector {
-  /** 采集当前环境信息 */
-  collect(): Promise<EnvInfo>;
-  /** 将 EnvInfo 格式化为可注入 system prompt 的文本 */
-  format(info: EnvInfo): string;
-}