agentdev 0.1.8 → 0.1.10

package/dist/chunk-TSASFMRF.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/types.ts"],"sourcesContent":["/**\r\n * 基础类型定义\r\n * 所有类型集中在这里，简单直观\r\n */\r\n\r\n// ========== 通知系统类型 ==========\r\n\r\n/**\r\n * 通知分类\r\n * - state: 覆盖式更新（如 LLM 字符计数）\r\n * - event: 追加式记录（如工具开始/完成）\r\n */\r\nexport type NotificationCategory = 'state' | 'event';\r\n\r\n/**\r\n * LLM 生成阶段\r\n */\r\nexport type LLMPhase = 'thinking' | 'content' | 'tool_calling';\r\n\r\n/**\r\n * 通知基础接口\r\n */\r\nexport interface Notification {\r\n  type: string;\r\n  category: NotificationCategory;\r\n  timestamp: number;\r\n  data: unknown;\r\n}\r\n\r\nexport type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error';\r\n\r\nexport type DebugLogDeliveryReason =\r\n  | 'hub'\r\n  | 'hub-unavailable'\r\n  | 'no-agent-context';\r\n\r\nexport interface DebugLogDelivery {\r\n  hub: boolean;\r\n  console: boolean;\r\n  reason: DebugLogDeliveryReason;\r\n}\r\n\r\nexport interface LogContextRef {\r\n  agentId?: string;\r\n  agentName?: string;\r\n  parentAgentId?: string;\r\n  callIndex?: number;\r\n  step?: number;\r\n  toolName?: string;\r\n  toolCallId?: string;\r\n  feature?: string;\r\n  lifecycle?: string;\r\n  hookMethod?: string;\r\n  hookKind?: 'forward' | 'reverse';\r\n  sourceFile?: string;\r\n  sourceLine?: number;\r\n  tags?: string[];\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport interface DebugLogEntry {\r\n  id: string;\r\n  timestamp: number;\r\n  level: LogLevel;\r\n  message: string;\r\n  namespace: string;\r\n  context: LogContextRef;\r\n  data?: unknown;\r\n  delivery: DebugLogDelivery;\r\n}\r\n\r\n/**\r\n * LLM 字符计数通知数据\r\n */\r\nexport interface LLMCharCountData {\r\n  charCount: number;\r\n  phase: LLMPhase;\r\n}\r\n\r\n/**\r\n * LLM 完成通知数据\r\n */\r\nexport interface LLMCompleteData {\r\n  totalChars: number;\r\n}\r\n\r\n/**\r\n * 工具开始通知数据\r\n */\r\nexport interface ToolStartData {\r\n  toolName: string;\r\n}\r\n\r\n/**\r\n * 工具完成通知数据\r\n */\r\nexport interface ToolCompleteData {\r\n  toolName: string;\r\n  success: boolean;\r\n  duration: number;\r\n}\r\n\r\n/**\r\n * 通知状态响应（GET /api/agents/:id/notification）\r\n */\r\nexport interface NotificationStateResponse {\r\n  state: Notification | null;\r\n  hasNewEvents: boolean;\r\n}\r\n\r\nexport interface AgentLogsResponse {\r\n  scope: 'current' | 'all';\r\n  currentAgentId: string | null;\r\n  selectedAgentId: string | null;\r\n  total: number;\r\n  logs: DebugLogEntry[];\r\n  truncation?: {\r\n    truncated: boolean;\r\n    appliedLimit?: number;\r\n    returnedCount: number;\r\n    availableCount: number;\r\n    nextOffset?: number;\r\n    reason?: string;\r\n    guidance?: string;\r\n  };\r\n  collectionPolicy: {\r\n    hubConnected: boolean;\r\n    includesOnlyHubDeliveredLogs: boolean;\r\n    fallbackBehavior: string;\r\n  };\r\n}\r\n\r\n/**\r\n * Agent 连接状态响应（GET /api/agents/:id/connection）\r\n */\r\nexport interface AgentConnectionResponse {\r\n  connected: boolean;\r\n}\r\n\r\n// ========== 消息类型 ==========\r\n\r\n// 消息角色（支持子代理 ID 作为消息来源）\r\nexport type MessageRole = 'system' | 'user' | 'assistant' | 'tool' | string;\r\n\r\n// 消息结构\r\nexport interface Message {\r\n  role: MessageRole;\r\n  content: string;\r\n  turn?: number;\r\n  toolCallId?: string;\r\n  toolCalls?: ToolCall[];\r\n  reasoning?: string; // 思考内容（GLM-4.7等模型的扩展字段）\r\n  thinkingBlocks?: ThinkingBlock[];\r\n}\r\n\r\nexport interface ThinkingBlock {\r\n  signature: string;\r\n  thinking: string;\r\n}\r\n\r\n// 工具调用\r\nexport interface ToolCall {\r\n  id: string;\r\n  name: string;\r\n  arguments: Record<string, any>;\r\n}\r\n\r\n/**\r\n * 统一用量格式（兼容 Anthropic 和 OpenAI）\r\n */\r\nexport interface UsageInfo {\r\n  /** 输入 token 数 */\r\n  inputTokens: number;\r\n  /** 输出 token 数 */\r\n  outputTokens: number;\r\n  /** 总 token 数 */\r\n  totalTokens: number;\r\n\r\n  // ========== Anthropic 特有（可选）==========\r\n  /** 创建缓存消耗的 token 数 */\r\n  cacheCreationTokens?: number;\r\n  /** 从缓存读取的 token 数 */\r\n  cacheReadTokens?: number;\r\n\r\n  // ========== OpenAI 特有（可选）==========\r\n  /** 推理 token 数 */\r\n  reasoningTokens?: number;\r\n  /** 音频 token 数 */\r\n  audioTokens?: number;\r\n}\r\n\r\n// LLM 响应\r\nexport interface LLMResponse {\r\n  content: string;\r\n  toolCalls?: ToolCall[];\r\n  reasoning?: string; // 思考内容（GLM-4.7等模型的扩展字段）\r\n  thinkingBlocks?: ThinkingBlock[];\r\n  /** 用量统计（可选） */\r\n  usage?: UsageInfo;\r\n}\r\n\r\n// ============= 渲染模板类型 =============\r\n/**\r\n * 渲染模板项\r\n * 可以是字符串模板或函数模板\r\n */\r\nexport type RenderTemplateItem =\r\n  | string                    // 字符串模板，使用 {{key}} 插值\r\n  | RenderTemplateFn;         // 函数模板，处理复杂逻辑\r\n\r\n/**\r\n * 渲染模板函数类型\r\n */\r\nexport type RenderTemplateFn = (data: Record<string, any>, success?: boolean) => string;\r\n\r\n/**\r\n * 内联渲染模板\r\n * 直接定义在工具中的渲染模板（无需引用预设模板）\r\n */\r\nexport interface InlineRenderTemplate {\r\n  call: RenderTemplateItem;\r\n  result: RenderTemplateItem;\r\n}\r\n\r\n// 工具渲染配置\r\nexport interface ToolRenderConfig {\r\n  /** 调用时的渲染模板（字符串引用或内联模板） */\r\n  call?: string | InlineRenderTemplate;\r\n  /** 结果时的渲染模板（字符串引用或内联模板） */\r\n  result?: string | InlineRenderTemplate;\r\n}\r\n\r\n// 工具定义\r\nexport interface Tool {\r\n  name: string;\r\n  description: string;\r\n  parameters?: Record<string, any>;\r\n  execute: (args: any, context?: any) => Promise<any>;\r\n  /** 可选：渲染配置 */\r\n  render?: ToolRenderConfig;\r\n}\r\n\r\n// LLM 接口 - 所有 LLM 适配器都需要实现这个\r\nexport interface LLMClient {\r\n  chat(messages: Message[], tools: Tool[]): Promise<LLMResponse>;\r\n}\r\n\r\n// 占位符上下文类型\r\nimport type { PlaceholderContext, TemplateSource } from '../template/types.js';\n\n// MCP 类型导入\nimport type { MCPConfig } from '../mcp/types.js';\nimport type { UsageStatsSnapshot } from './usage.js';\n\r\n// Agent 配置\r\nexport interface AgentConfig {\r\n  llm: LLMClient;\r\n  tools?: Tool[];\r\n  maxTurns?: number;\r\n  systemMessage?: string | TemplateSource;\r\n  name?: string;  // Agent 显示名称（用于调试）\r\n\r\n  // ========== Feature 系统 ==========\r\n  /**\r\n   * Feature 配置\r\n   *\r\n   * 新的声明式 Feature 注册方式\r\n   */\r\n  features?: {\r\n    /** 启用的 Feature 列表 */\r\n    enabled?: string[];\r\n    /** Feature 特定配置 */\r\n    [key: string]: unknown;\r\n  };\r\n}\r\n\r\n// 上下文中间件 - 用于处理消息数组\r\nexport type ContextMiddleware = (messages: Message[]) => Message[];\r\n\r\n// ============= 多 Agent 调试支持 =============\r\n\r\n/**\r\n * Agent 注册信息（Hub 端）\r\n */\r\nexport interface AgentInfo {\r\n  id: string;           // 唯一标识，如 \"agent-1\"\r\n  name: string;         // 显示名称\r\n  registeredAt: number; // 注册时间戳\r\n}\r\n\r\n/**\r\n * 工具元数据（用于前端渲染）\r\n */\r\nexport interface ToolMetadata {\r\n  name: string;\r\n  description: string;\r\n  render: {\r\n    call: string | InlineRenderTemplate;   // 模板名称或内联模板\r\n    result: string | InlineRenderTemplate; // 模板名称或内联模板\r\n    // 内联模板的可选直接存储（用于前端特殊标记）\r\n    inlineCall?: InlineRenderTemplate;\r\n    inlineResult?: InlineRenderTemplate;\r\n  };\r\n}\r\n\r\nexport interface HookSourceLocation {\r\n  file?: string;\r\n  line?: number;\r\n  column?: number;\r\n  display: string;\r\n}\r\n\r\nexport interface HookEntryMetadata {\r\n  order: number;\r\n  featureName: string;\r\n  methodName: string;\r\n  lifecycle: string;\r\n  kind: 'decision' | 'notify';\r\n  source?: HookSourceLocation;\r\n  description?: string;\r\n}\r\n\r\nexport interface HookLifecycleSnapshot {\r\n  lifecycle: string;\r\n  kind: 'decision' | 'notify';\r\n  entries: HookEntryMetadata[];\r\n}\r\n\r\nexport interface FeatureInspectorSnapshot {\r\n  name: string;\r\n  enabled: boolean;\r\n  status: 'enabled' | 'disabled' | 'partial';\r\n  hookCount: number;\r\n  toolCount: number;\r\n  enabledToolCount: number;\r\n  source?: string;\r\n  description?: string;\r\n  tools: Array<{\r\n    name: string;\r\n    description: string;\r\n    enabled: boolean;\r\n    renderCall?: string;\r\n    renderResult?: string;\r\n  }>;\r\n}\r\n\r\nexport interface HookInspectorSnapshot {\n  lifecycleOrder: string[];\n  features: FeatureInspectorSnapshot[];\n  hooks: HookLifecycleSnapshot[];\n}\n\nexport interface AgentContextMetrics {\n  messageCount: number;\n  charCount: number;\n  toolCallCount: number;\n  turnCount: number;\n}\n\nexport interface AgentOverviewSnapshot {\n  updatedAt: number;\n  context: AgentContextMetrics;\n  usageStats: UsageStatsSnapshot;\n}\n\r\n/**\r\n * Agent 会话数据（Worker 端）\r\n */\r\nexport interface AgentSession {\n  id: string;\n  name: string;\n  messages: Message[];\n  tools: ToolMetadata[];\n  createdAt: number;\r\n  lastActive: number;\r\n  // 项目根目录（用于定位模板文件）\r\n  projectRoot?: string;\r\n  // 通知系统扩展\r\n  currentState: Notification | null;\r\n  events: Notification[];\r\n  lastEventCount: number;\r\n  logs: DebugLogEntry[];\r\n  // 所属 UDS 客户端连接 ID（用于多进程输入响应路由）\r\n  clientId?: string;\r\n  // 内部：上次最后一条消息的签名（用于推送去重）\n  _lastMessageSig?: string;\n  hookInspector?: HookInspectorSnapshot;\n  overview?: AgentOverviewSnapshot;\n}\n\r\n/**\r\n * DebugHub IPC 消息类型（主进程 → Worker）\r\n * 使用 discriminated union 确保类型安全\r\n */\r\nexport type DebugHubIPCMessage =\n  | RegisterAgentMsg\n  | UpdateAgentInspectorMsg\n  | UpdateAgentOverviewMsg\n  | PushMessagesMsg\n  | RegisterToolsMsg\n  | SetCurrentAgentMsg\n  | UnregisterAgentMsg\n  | PushNotificationMsg\n  | RequestInputMsg\r\n  | StopMsg;\r\n\r\n/**\r\n * 注册新 Agent\r\n */\r\nexport interface RegisterAgentMsg {\n  type: 'register-agent';\n  agentId: string;\n  name: string;\n  createdAt: number;\n  projectRoot?: string; // 项目根目录，用于模板文件加载\r\n  featureTemplates?: Record<string, string>; // Feature 模板路径映射\n  hookInspector?: HookInspectorSnapshot;\n  overview?: AgentOverviewSnapshot;\n  activeInputRequest?: ActiveInputRequest; // 活跃的输入请求（用于重连后恢复）\n}\n\nexport interface UpdateAgentInspectorMsg {\n  type: 'update-agent-inspector';\n  agentId: string;\n  hookInspector: HookInspectorSnapshot;\n}\n\nexport interface UpdateAgentOverviewMsg {\n  type: 'update-agent-overview';\n  agentId: string;\n  overview: AgentOverviewSnapshot;\n}\n\r\n/**\r\n * 推送 Agent 消息\r\n */\r\nexport interface PushMessagesMsg {\r\n  type: 'push-messages';\r\n  agentId: string;\r\n  messages: Message[];\r\n}\r\n\r\n/**\r\n * 注册 Agent 工具\r\n */\r\nexport interface RegisterToolsMsg {\r\n  type: 'register-tools';\r\n  agentId: string;\r\n  tools: Tool[];\r\n}\r\n\r\n/**\r\n * 切换当前选中的 Agent\r\n */\r\nexport interface SetCurrentAgentMsg {\r\n  type: 'set-current-agent';\r\n  agentId: string;\r\n}\r\n\r\n/**\r\n * 活跃的输入请求（用于重连后恢复）\r\n */\r\nexport interface ActiveInputRequest {\r\n  requestId: string;\r\n  prompt: string;\r\n  placeholder?: string;\r\n  initialValue?: string;\r\n  actions?: UserInputAction[];\r\n  timestamp: number;\r\n}\r\n\r\n/**\r\n * 注销 Agent\r\n */\r\nexport interface UnregisterAgentMsg {\r\n  type: 'unregister-agent';\r\n  agentId: string;\r\n}\r\n\r\n/**\r\n * 停止 Worker\r\n */\r\nexport interface StopMsg {\r\n  type: 'stop';\r\n}\r\n\r\n/**\r\n * 推送通知\r\n */\r\nexport interface PushNotificationMsg {\r\n  type: 'push-notification';\r\n  agentId: string;\r\n  notification: Notification;\r\n}\r\n\r\n/**\r\n * 请求用户输入\r\n */\r\nexport interface RequestInputMsg {\r\n  type: 'request-input';\r\n  agentId: string;\r\n  requestId: string;\r\n  prompt: string;\r\n  timeout?: number;\r\n  placeholder?: string;\r\n  initialValue?: string;\r\n  actions?: UserInputAction[];\r\n}\r\n\r\n/**\r\n * 用户输入响应（Worker → Agent，通过 UDS）\r\n */\r\nexport interface InputResponseMsg {\r\n  type: 'input-response';\r\n  agentId: string;\r\n  requestId: string;\r\n  input: string;\r\n  response?: UserInputResponse;\r\n}\r\n\r\nexport interface UserInputAction {\r\n  id: string;\r\n  label: string;\r\n  kind?: 'rollback' | 'custom';\r\n  variant?: 'primary' | 'secondary' | 'danger';\r\n  payload?: Record<string, unknown>;\r\n}\r\n\r\nexport interface UserInputRequest {\r\n  prompt: string;\r\n  placeholder?: string;\r\n  initialValue?: string;\r\n  actions?: UserInputAction[];\r\n}\r\n\r\nexport interface UserInputResponse {\r\n  kind: 'text' | 'action';\r\n  text?: string;\r\n  actionId?: string;\r\n  payload?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Worker → 主进程 消息\r\n */\r\nexport type WorkerIPCMessage =\r\n  | ReadyMsg\r\n  | AgentSwitchedMsg\r\n  | InputResponseMsg;\r\n\r\n/**\r\n * Worker 就绪\r\n */\r\nexport interface ReadyMsg {\r\n  type: 'ready';\r\n}\r\n\r\n/**\r\n * Agent 切换确认\r\n */\r\nexport interface AgentSwitchedMsg {\r\n  type: 'agent-switched';\r\n  agentId: string;\r\n}\r\n\r\n// ========== 上下文管理类型 ==========\r\n/**\r\n * 消息标签枚举\r\n *\r\n * 用于快速分类和过滤消息，一条消息可能有多个标签\r\n */\r\nexport type MessageTag =\r\n  | 'user'           // 用户输入消息\r\n  | 'system'         // 系统消息\r\n  | 'assistant'      // LLM 响应消息\r\n  | 'tool-call'      // assistant 消息且包含 toolCalls\r\n  | 'tool-result'    // role === 'tool' 的工具执行结果\r\n  | 'sub-agent'      // 来自子代理的消息（与 assistant/tool-result 组合使用）\r\n  | 'reminder';      // Feature 注入的提醒消息（与 system 组合使用）\r\n\r\n/**\r\n * 解析结果结构\r\n *\r\n * 从消息 content 中提取的结构化信息\r\n */\r\nexport interface ParsedContent {\r\n  /** 从 content 提取的任务 ID（正则匹配 \"taskId\":\"xxx\"） */\r\n  taskIds: string[];\r\n  /** 从 content 提取的工具调用名称（从 toolCalls 或 content 解析） */\r\n  toolCalls: string[];\r\n  /** @ 提及的内容 */\r\n  mentions: string[];\r\n  /** 用户可继承扩展更多字段 */\r\n  [key: string]: any;\r\n}\r\n\r\n/**\r\n * 消息元数据\r\n *\r\n * 用于 addMessage() 的元数据参数\r\n */\r\nexport interface MessageMeta {\r\n  /** ReAct 循环轮次 */\r\n  turn: number;\r\n  /** 子代理 ID（子代理消息时填写） */\r\n  agentId?: string;\r\n  /** 来源 Feature（reminder 等消息时填写） */\r\n  source?: string;\r\n}\r\n\r\n/**\r\n * 扩展的消息结构\r\n *\r\n * 在原始 Message 基础上添加元数据\r\n * 不破坏现有 Message 类型，保证 LLM 调用兼容性\r\n */\r\nexport interface EnrichedMessage extends Message {\r\n  // === 元数据字段 ===\r\n\r\n  /** 唯一标识（用于索引关联） */\r\n  id: string;\r\n  /** 消息产生时间戳（毫秒） */\r\n  timestamp: number;\r\n  /** 所属 ReAct 循环轮次（从 0 开始） */\r\n  turn: number;\r\n  /** 全局消息序号（从 0 开始递增） */\r\n  sequence: number;\r\n  /** 来源 Agent ID（子代理消息） */\r\n  agentId?: string;\r\n  /** 来源 Feature（如 'todo-feature'，仅 reminder 等） */\r\n  source?: string;\r\n\r\n  // === 分类标签 ===\r\n\r\n  /** 消息分类标签（用于快速查询） */\r\n  tags: MessageTag[];\r\n\r\n  // === 解析结果 ===\r\n\r\n  /** 从 content 中提取的结构化信息 */\r\n  parsed: ParsedContent;\r\n}\r\n\r\n// ========== 生命周期类型 re-export ==========\r\n// 生命周期类型从 lifecycle.ts 导出，保持类型定义集中管理\r\nexport type {\r\n  AgentInitiateContext,\r\n  AgentDestroyContext,\r\n  CallStartContext,\r\n  CallFinishContext,\r\n  StepStartContext,\r\n  StepFinishedContext,\r\n  HookResult,\r\n  ToolContext,\r\n  ToolResult,\r\n} from './lifecycle.js';\r\n\r\n// ========== 决策上下文类型 ==========\r\n/**\r\n * 决策上下文（反向钩子参数）\r\n *\r\n * 所有决策上下文的联合类型\r\n */\r\nexport type DecisionContext =\r\n  | import('./lifecycle.js').AgentInitiateContext\r\n  | import('./lifecycle.js').AgentDestroyContext\r\n  | import('./lifecycle.js').CallStartContext\r\n  | import('./lifecycle.js').CallFinishContext\r\n  | import('./lifecycle.js').StepStartContext\r\n  | import('./lifecycle.js').StepFinishedContext\r\n  | import('./lifecycle.js').ToolContext\r\n  | import('./lifecycle.js').ToolResult\r\n  | import('./lifecycle.js').StepFinishDecisionContext\r\n  | import('./lifecycle.js').ToolFinishedDecisionContext;\r\n\r\n// ========== UDS 通信类型 ==========\r\n\r\n/**\r\n * UDS 配置\r\n */\r\nexport interface UDSConfig {\r\n  /** UDS 路径（默认自动检测平台） */\r\n  path?: string;\r\n  /** HTTP 端口（Web 界面） */\r\n  httpPort?: number;\r\n  /** 是否自动打开浏览器 */\r\n  openBrowser?: boolean;\r\n}\r\n\r\n/**\r\n * 平台检测后的 UDS 路径\r\n */\r\nexport function getDefaultUDSPath(): string {\r\n  if (process.platform === 'win32') {\r\n    return '\\\\\\\\.\\\\pipe\\\\agentdev-viewer';\r\n  }\r\n  return '/tmp/agentdev-viewer.sock';\r\n}\r\n"],"mappings":";AAorBO,SAAS,oBAA4B;AAC1C,MAAI,QAAQ,aAAa,SAAS;AAChC,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}