@cicctencent/agent-core 0.1.1

package/dist/context/types.d.ts

@@ -0,0 +1,39 @@
+import type { Message } from '../types.ts';
+export interface EnvInfo {
+    /** 操作系统信息，e.g. "Linux 5.15.0 x86_64" */
+    os: string;
+    /** 平台标识 */
+    platform: string;
+    /** 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>;
+}
+export interface BuildContextOptions {
+    /** 完整的系统提示词（由上层组装完成，core 不关心内容来源） */
+    systemPrompt: string;
+    /** 对话历史（由上层管理，core 仅负责插入到消息列表中） */
+    history?: Message[];
+    /** 用户当前输入 */
+    userMessage: string;
+    /** 额外系统提示片段（上层注入，追加到 systemPrompt 之后） */
+    extraSystemPrompt?: string;
+}
+/** 环境采集器接口（上层实现本地/远程采集） */
+export interface EnvCollector {
+    /** 采集当前环境信息 */
+    collect(): Promise<EnvInfo>;
+    /** 将 EnvInfo 格式化为可注入 system prompt 的文本 */
+    format(info: EnvInfo): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,WAAW,OAAO;IACtB,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAID,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,2BAA2B;AAC3B,MAAM,WAAW,YAAY;IAC3B,eAAe;IACf,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,0CAA0C;IAC1C,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;CAC/B"}

package/dist/hooks/types.d.ts

@@ -0,0 +1,47 @@
+import type { Message, TokenUsage } from '../types.ts';
+import type { ToolDefinition } from '../tool/types.ts';
+export type HookEvent = 'before_tool' | 'after_tool' | 'before_ll_call' | 'after_ll_call' | 'on_iteration_start' | 'on_error' | 'on_complete';
+/**
+ * Hook 处理器接收的上下文信息
+ * 不同事件携带不同的字段组合
+ */
+export interface HookContext {
+    sessionId: string;
+    iteration: number;
+    traceId?: string;
+    tool?: string;
+    args?: Record<string, unknown>;
+    result?: string;
+    isError?: boolean;
+    duration?: number;
+    messages?: Message[];
+    tools?: ToolDefinition[];
+    response?: Message;
+    error?: string;
+    recoverable?: boolean;
+    totalIterations?: number;
+    usage?: TokenUsage;
+}
+/**
+ * Hook 处理器的返回值
+ * 仅 before_tool 和 after_tool 的返回值有实际效果
+ */
+export interface HookResult {
+    /** before_tool: 阻止工具执行 */
+    block?: boolean;
+    /** block 时的原因（返回给 LLM） */
+    reason?: string;
+    /** before_tool: 修改工具参数（与原始 args 合并） */
+    modify?: Record<string, unknown>;
+    /** after_tool: 追加到工具结果末尾 */
+    inject?: string;
+}
+export interface Hook {
+    /** Hook 名称（用于日志和调试） */
+    name: string;
+    /** 监听的事件类型 */
+    event: HookEvent;
+    /** 处理器函数 */
+    handler: (ctx: HookContext) => Promise<HookResult | void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,YAAY,GACZ,gBAAgB,GAChB,eAAe,GACf,oBAAoB,GACpB,UAAU,GACV,aAAa,CAAC;AAIlB;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAID;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,IAAI;IACnB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY;IACZ,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC3D"}

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+export type { Message, MessageRole, ToolCall, AgentEvent, BaseEvent, ThinkingEvent, ToolCallEvent, ToolResultEvent, MessageEvent, DoneEvent, ErrorEvent, SteeringEvent, RetryEvent, AgentResult, AgentStatus, SessionContext, TokenUsage, ToolCallRecord, } from './types.ts';
+export { AgentEngine } from './agent/engine.ts';
+export { DEFAULT_COMPLEX_WORKFLOW_TEMPLATE, buildDebateInstructions, buildStructuredOutputInstruction, buildWorkflowDecisionMemory, formatDebateOutput, formatStructuredAgentOutput, formatWorkflowTemplateForPrompt, getWorkflowRoleStage, getWorkflowTemplate, parseDebateOutput, parseStructuredAgentOutput, wrapTaskWithWorkflowInstructions, } from './agent/workflow.ts';
+export type { StructuredAgentOutput, WorkflowCheckpoint, WorkflowDecisionLog, WorkflowRole, WorkflowStageTemplate, WorkflowTemplate, DebateOutput } from './agent/workflow.ts';
+export { HistoryManager } from './agent/history-manager.ts';
+export { LLMCaller } from './agent/llm-caller.ts';
+export { AgentToolExecutor } from './agent/tool-executor.ts';
+export type { AgentConfig, RunOptions, RetryPolicy, ToolResultStore, OffloadEntry } from './agent/types.ts';
+export type { LLMProvider, ModelConfig, ModelInfo, ChatParams, ChatResponse, ChatChunk, } from './llm/types.ts';
+export { OpenAIProvider } from './llm/openai-provider.ts';
+export { AnthropicProvider } from './llm/anthropic-provider.ts';
+export { OllamaProvider } from './llm/ollama-provider.ts';
+export { createLLMProvider, BUILTIN_PROVIDERS } from './llm/factory.ts';
+export type { BuiltinProvider } from './llm/factory.ts';
+export { ContextManager } from './context/manager.ts';
+export { LocalEnvCollector } from './context/collector.ts';
+export type { BuildContextOptions, EnvInfo, EnvCollector, } from './context/types.ts';
+export { SkillManager } from './skill/manager.ts';
+export { SkillRouter } from './skill/router.ts';
+export type { Skill, SkillManifest, SkillSource, RouteResult, RouteStrategy, MatchType, } from './skill/types.ts';
+export { ToolRegistry } from './tool/registry.ts';
+export { createDelegateTool } from './tool/delegate.ts';
+export type { SubAgentRunner } from './tool/delegate.ts';
+export type { ToolDefinition, ToolExecutor, ToolContext, SubAgentEventEmitter, WidgetEventEmitter, ArtifactEventEmitter, ArtifactData, RegisteredTool, ToolCategory, ShellExecutor, FileSystemExecutor, } from './tool/types.ts';
+export { registerMCPTools, MCP_TOOL_PREFIX, buildMCPToolName, sanitizeForToolName } from './mcp/client.ts';
+export { createMCPClient, registerTransport } from './mcp/factory.ts';
+export type { TransportFactory } from './mcp/factory.ts';
+export { MCPClientBase } from './mcp/base-client.ts';
+export { StdioMCPClient } from './mcp/stdio-client.ts';
+export { HttpMCPClient } from './mcp/http-client.ts';
+export { resolveProxyAgentForCategory, resolveProxyUrlForCategory, getSystemProxyUrl, clearSystemProxyCache, getWindowsSystemProxy, DEFAULT_PROXY_SETTINGS, } from './mcp/proxy-agent.ts';
+export type { ProxyMode, ProxyCategoryConfig, ProxySettings, } from './mcp/proxy-agent.ts';
+export type { MCPClient, MCPServerConfig, MCPTransport, } from './mcp/types.ts';
+export { SecurityGuard } from './security/guard.ts';
+export type { SanitizeResult, SecurityRule, SecurityPolicy, Severity, } from './security/types.ts';
+export type { Sandbox, SandboxConfig, SandboxManager, ScriptLanguage, } from './sandbox/types.ts';
+export { SANDBOX_BLOCKED_COMMANDS, SANDBOX_SAFE_ENV_KEYS, DEFAULT_SANDBOX_CONFIG } from './sandbox/types.ts';
+export type { Hook, HookEvent, HookContext, HookResult, } from './hooks/types.ts';
+export type { Middleware, MiddlewareContext, } from './middleware/types.ts';
+export type { MemoryEntry, MemoryLayer, MemoryServiceLike, } from './memory/types.ts';
+export { MemoryExtractor } from './memory/extractor.ts';
+export type { AtomFact, ExtractorOptions } from './memory/extractor.ts';
+export { SceneAggregator } from './memory/scene.ts';
+export type { SceneBlock, SceneAggregatorOptions } from './memory/scene.ts';
+export { PersonaGenerator } from './memory/persona.ts';
+export type { PersonaFacet, PersonaGeneratorOptions } from './memory/persona.ts';
+export { MemoryCheckpoint, getMemoryCheckpoint, resetMemoryCheckpoint } from './memory/checkpoint.ts';
+export type { CheckpointData } from './memory/checkpoint.ts';
+export { MemoryRecallEngine, formatRecallForPrompt } from './memory/recall.ts';
+export type { RecallResult, ScoredMemoryEntry, RecallOptions } from './memory/recall.ts';
+export { MemoryPipeline } from './memory/pipeline.ts';
+export type { PipelineOptions, PipelineResult } from './memory/pipeline.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/llm/anthropic-provider.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @file Anthropic Claude LLM Provider
+ * @description 实现 Anthropic Messages API，支持 Claude 系列模型，
+ *              内部自动完成 OpenAI 格式 ↔ Anthropic 格式的双向转换
+ */
+import type { LLMProvider, ModelConfig, ModelInfo, ChatParams, ChatResponse, ChatChunk } from './types.ts';
+export declare class AnthropicProvider implements LLMProvider {
+    private config;
+    constructor(config: ModelConfig);
+    getModel(): ModelInfo;
+    ping(): Promise<boolean>;
+    chat(params: ChatParams): Promise<ChatResponse>;
+    chatStream(params: ChatParams): AsyncGenerator<ChatChunk>;
+    /** 更新配置 */
+    updateConfig(updates: Partial<ModelConfig>): void;
+    /**
+     * 将 OpenAI 格式消息转换为 Anthropic 格式
+     * - system 消息提取为单独的 system 字段
+     * - tool 消息转换为 user 消息中的 tool_result 块
+     * - assistant 的 tool_calls 转换为 tool_use 块
+     */
+    private convertMessages;
+    private convertTools;
+    private buildRequestBody;
+    private parseResponse;
+    private doRequest;
+}
+//# sourceMappingURL=anthropic-provider.d.ts.map

package/dist/llm/anthropic-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../src/llm/anthropic-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA+C3G,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAAkE;gBAEpE,MAAM,EAAE,WAAW;IAY/B,QAAQ,IAAI,SAAS;IAUf,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAexB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IAa9C,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC;IAkIhE,WAAW;IACX,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAMjD;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAiEvB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,aAAa;YAwCP,SAAS;CA2BxB"}

package/dist/llm/factory.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @file LLM Provider 工厂
+ * @description 根据 ModelConfig.provider 自动创建对应的 LLMProvider 实例
+ *              支持 'openai' | 'anthropic' | 'ollama' 及任意 OpenAI 兼容供应商
+ */
+import type { ModelConfig, LLMProvider } from './types.ts';
+/** 已注册的供应商名称集合 */
+export declare const BUILTIN_PROVIDERS: readonly ["openai", "anthropic", "ollama"];
+export type BuiltinProvider = (typeof BUILTIN_PROVIDERS)[number];
+/**
+ * 根据 config.provider 创建对应的 LLMProvider
+ *
+ * - 'openai'        → OpenAIProvider
+ * - 'anthropic'     → AnthropicProvider
+ * - 'ollama'        → OllamaProvider
+ * - 其他任意字符串   → OpenAIProvider（OpenAI 兼容端点，如 DeepSeek / vLLM / Together 等）
+ */
+export declare function createLLMProvider(config: ModelConfig): LLMProvider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/llm/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/llm/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK3D,kBAAkB;AAClB,eAAO,MAAM,iBAAiB,4CAA6C,CAAC;AAC5E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAUlE"}

package/dist/llm/ollama-provider.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file Ollama LLM Provider
+ * @description 继承 OpenAIProvider，对接 Ollama 本地推理服务
+ *              Ollama 原生支持 OpenAI 兼容接口（/v1/chat/completions）
+ *              默认地址 http://localhost:11434/v1
+ */
+import type { ModelConfig, ModelInfo } from './types.ts';
+import { OpenAIProvider } from './openai-provider.ts';
+export declare class OllamaProvider extends OpenAIProvider {
+    constructor(config: ModelConfig);
+    getModel(): ModelInfo;
+}
+//# sourceMappingURL=ollama-provider.d.ts.map

package/dist/llm/ollama-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-provider.d.ts","sourceRoot":"","sources":["../../src/llm/ollama-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qBAAa,cAAe,SAAQ,cAAc;gBAEpC,MAAM,EAAE,WAAW;IAW/B,QAAQ,IAAI,SAAS;CAetB"}

package/dist/llm/openai-provider.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file OpenAI 兼容 LLM Provider
+ * @description 使用原生 fetch 实现，支持任意 OpenAI 兼容端点（OpenAI / DeepSeek / Ollama / vLLM 等）
+ */
+import type { LLMProvider, ModelConfig, ModelInfo, ChatParams, ChatResponse, ChatChunk } from './types.ts';
+export declare class OpenAIProvider implements LLMProvider {
+    protected config: Required<Pick<ModelConfig, 'provider' | 'model'>> & ModelConfig;
+    constructor(config: ModelConfig);
+    getModel(): ModelInfo;
+    ping(): Promise<boolean>;
+    chat(params: ChatParams): Promise<ChatResponse>;
+    chatStream(params: ChatParams): AsyncGenerator<ChatChunk>;
+    /** 更新配置（如 API Key 变更后） */
+    updateConfig(updates: Partial<ModelConfig>): void;
+    protected buildRequestBody(params: ChatParams, stream: boolean): Record<string, any>;
+    protected doRequest(body: Record<string, any>, signal?: AbortSignal): Promise<Response>;
+}
+//# sourceMappingURL=openai-provider.d.ts.map

package/dist/llm/openai-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../src/llm/openai-provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG3G,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC;gBAEtE,MAAM,EAAE,WAAW;IAY/B,QAAQ,IAAI,SAAS;IAUf,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAaxB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IAyB9C,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC;IAqEhE,0BAA0B;IAC1B,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAMjD,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;cAyBpE,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;CA2B9F"}

package/dist/llm/provider.d.ts

@@ -0,0 +1,7 @@
+export type { LLMProvider, ModelConfig, ModelInfo, ChatParams, ChatResponse, ChatChunk } from './types.ts';
+export { OpenAIProvider } from './openai-provider.ts';
+export { AnthropicProvider } from './anthropic-provider.ts';
+export { OllamaProvider } from './ollama-provider.ts';
+export { createLLMProvider, BUILTIN_PROVIDERS } from './factory.ts';
+export type { BuiltinProvider } from './factory.ts';
+//# sourceMappingURL=provider.d.ts.map

package/dist/llm/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/llm/provider.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG3G,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/llm/types.d.ts

@@ -0,0 +1,78 @@
+import type { Message, TokenUsage } from '../types.ts';
+import type { ToolDefinition } from '../tool/types.ts';
+import type { Dispatcher } from 'undici';
+export interface ModelConfig {
+    /** 供应商标识：'openai' | 'anthropic' | 'azure' | 'ollama' | 自定义 */
+    provider: string;
+    /** 模型名称 */
+    model: string;
+    /** API Key */
+    apiKey?: string;
+    /** API Base URL（自定义端点） */
+    baseUrl?: string;
+    /** 温度参数，默认 0.7 */
+    temperature?: number;
+    /** 最大输出 token 数 */
+    maxTokens?: number;
+    /** 请求超时（毫秒） */
+    timeout?: number;
+    /** 供应商特定参数透传 */
+    extra?: Record<string, unknown>;
+    /** 网络代理 dispatcher（运行时注入，不持久化） */
+    proxy?: Dispatcher;
+}
+export interface ModelInfo {
+    provider: string;
+    model: string;
+    contextWindow: number;
+    supportsTools: boolean;
+    supportsStreaming: boolean;
+}
+/** LLM 推理请求参数 */
+export interface ChatParams {
+    messages: Message[];
+    /** 可用工具列表（OpenAI Function Calling 格式） */
+    tools?: ToolDefinition[];
+    /** 工具调用策略 */
+    toolChoice?: 'auto' | 'none' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    /** 覆盖 ModelConfig 中的 temperature */
+    temperature?: number;
+    /** 覆盖 ModelConfig 中的 maxTokens */
+    maxTokens?: number;
+    /** 中止信号 */
+    abortSignal?: AbortSignal;
+}
+/** LLM 推理响应 */
+export interface ChatResponse {
+    choices: Array<{
+        message: Message;
+        /** 结束原因：'stop' | 'tool_calls' | 'length' | 'content_filter' */
+        finish_reason: string;
+    }>;
+    usage?: TokenUsage;
+}
+/** 流式响应片段 */
+export interface ChatChunk {
+    /** 增量内容 */
+    delta: Partial<Message>;
+    finish_reason?: string;
+    /** Token 使用统计（仅最后一个 chunk 可能包含） */
+    usage?: TokenUsage;
+}
+/** LLM 供应商统一接口 */
+export interface LLMProvider {
+    /** 非流式推理 */
+    chat(params: ChatParams): Promise<ChatResponse>;
+    /** 流式推理（返回 AsyncGenerator 逐片段推送） */
+    chatStream(params: ChatParams): AsyncGenerator<ChatChunk>;
+    /** 获取当前模型信息 */
+    getModel(): ModelInfo;
+    /** 测试连接是否正常 */
+    ping(): Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/llm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIzC,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kCAAkC;IAClC,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAID,iBAAiB;AACjB,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,yCAAyC;IACzC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAChF,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,eAAe;AACf,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,+DAA+D;QAC/D,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,aAAa;AACb,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAID,kBAAkB;AAClB,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhD,oCAAoC;IACpC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAE1D,eAAe;IACf,QAAQ,IAAI,SAAS,CAAC;IAEtB,eAAe;IACf,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B"}

package/dist/mcp/base-client.d.ts

@@ -0,0 +1,50 @@
+import type { MCPClient, MCPServerConfig } from './types.ts';
+import type { ToolDefinition } from '../tool/types.ts';
+/** JSON-RPC 请求 */
+interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/** JSON-RPC 响应 */
+interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * MCPClient 抽象基类
+ * 子类只需实现 send() 和 doConnect() / doDisconnect()
+ */
+export declare abstract class MCPClientBase implements MCPClient {
+    protected config: MCPServerConfig;
+    protected connected: boolean;
+    private requestId;
+    /** 等待响应的 Promise 队列：id → { resolve, reject, timer } */
+    private pending;
+    /** 建立物理连接 */
+    protected abstract doConnect(config: MCPServerConfig): Promise<void>;
+    /** 断开物理连接 */
+    protected abstract doDisconnect(): void;
+    /** 发送 JSON-RPC 消息到 MCP 服务端 */
+    protected abstract send(request: JsonRpcRequest): void;
+    connect(config: MCPServerConfig): Promise<void>;
+    listTools(): Promise<ToolDefinition[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<string>;
+    disconnect(): void;
+    isConnected(): boolean;
+    /** 发送 JSON-RPC 请求并等待响应 */
+    protected call(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /** 发送 JSON-RPC 通知（无 id，无响应） */
+    protected notify(method: string, params?: Record<string, unknown>): void;
+    /** 子类收到 JSON-RPC 响应时调用此方法 */
+    protected handleResponse(data: JsonRpcResponse): void;
+}
+export {};
+//# sourceMappingURL=base-client.d.ts.map

package/dist/mcp/base-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.d.ts","sourceRoot":"","sources":["../../src/mcp/base-client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,kBAAkB;AAClB,UAAU,cAAc;IACtB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,kBAAkB;AAClB,UAAU,eAAe;IACvB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAED;;;GAGG;AACH,8BAAsB,aAAc,YAAW,SAAS;IACtD,SAAS,CAAC,MAAM,EAAG,eAAe,CAAC;IACnC,SAAS,CAAC,SAAS,UAAS;IAC5B,OAAO,CAAC,SAAS,CAAK;IACtB,uDAAuD;IACvD,OAAO,CAAC,OAAO,CAIV;IAIL,aAAa;IACb,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpE,aAAa;IACb,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,IAAI;IAEvC,8BAA8B;IAC9B,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIhD,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IActC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAe5E,UAAU,IAAI,IAAI;IAWlB,WAAW,IAAI,OAAO;IAMtB,0BAA0B;IAC1B,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBlF,+BAA+B;IAC/B,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQxE,6BAA6B;IAC7B,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;CAatD"}

package/dist/mcp/client.d.ts

@@ -0,0 +1,27 @@
+import type { MCPClient } from './types.ts';
+import type { ToolRegistry } from '../tool/registry.ts';
+/** MCP 工具名前缀，用于与 builtin/skill 等工具区分 */
+export declare const MCP_TOOL_PREFIX = "mcp_";
+/**
+ * 将名称中的非安全字符替换为下划线，确保可安全用于工具名拼接
+ */
+export declare function sanitizeForToolName(name: string): string;
+/**
+ * 构建带命名空间的 MCP 工具名
+ *
+ * - 连接器工具：`mcp_{connectorId}_{serverName}_{toolName}`
+ * - 独立工具：`mcp_{serverName}_{toolName}`
+ *
+ * 命名空间从根源上解决多 MCP 服务器工具名冲突问题。
+ */
+export declare function buildMCPToolName(toolName: string, serverName: string, connectorId?: string): string;
+/**
+ * 将 MCP 服务的远程工具批量注册到 ToolRegistry
+ *
+ * 工具名自动添加命名空间前缀 `mcp_[{connectorId}_]{serverName}_{toolName}`，
+ * 避免多 MCP 服务器间工具名冲突。调用 MCP 服务时使用原始名字。
+ *
+ * @param connectorId 连接器 ID（公有 MCP 服务器传 undefined，连接器私有传连接器 ID）
+ */
+export declare function registerMCPTools(registry: ToolRegistry, mcpClient: MCPClient, serverName: string, connectorId?: string, serverId?: number | string): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/mcp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wCAAwC;AACxC,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAQnG;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/mcp/factory.d.ts

@@ -0,0 +1,16 @@
+import type { MCPClient, MCPServerConfig } from './types.ts';
+/** 自定义 transport 工厂函数签名 */
+export type TransportFactory = () => MCPClient;
+/**
+ * 注册自定义 transport 工厂
+ * 上层应用通过此方法扩展 core 层不内置的 transport 类型（如 api-bridge）
+ */
+export declare function registerTransport(transport: string, factory: TransportFactory): void;
+/**
+ * 根据 MCPServerConfig.transport 创建对应的 MCPClient 实例
+ *
+ * 内置支持：stdio / http / sse
+ * 自定义 transport：通过 registerTransport 注册后支持
+ */
+export declare function createMCPClient(config: MCPServerConfig): MCPClient;
+//# sourceMappingURL=factory.d.ts.map

package/dist/mcp/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/mcp/factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI7D,2BAA2B;AAC3B,MAAM,MAAM,gBAAgB,GAAG,MAAM,SAAS,CAAC;AAK/C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAGpF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAclE"}

package/dist/mcp/http-client.d.ts

@@ -0,0 +1,24 @@
+import { MCPClientBase } from './base-client.ts';
+import type { MCPServerConfig } from './types.ts';
+export declare class HttpMCPClient extends MCPClientBase {
+    private endpoint;
+    private sessionId?;
+    private dispatcher?;
+    /** 用户自定义请求头（如 Authorization） */
+    private customHeaders?;
+    /** 结构化鉴权配置 */
+    private authConfig?;
+    protected doConnect(config: MCPServerConfig): Promise<void>;
+    protected doDisconnect(): void;
+    /** 根据 auth 配置生成鉴权请求头 */
+    private buildAuthHeaders;
+    protected send(request: {
+        jsonrpc: string;
+        id: number;
+        method: string;
+        params?: Record<string, unknown>;
+    }): void;
+    /** 解析 SSE 文本块中的 JSON-RPC 响应 */
+    private parseSSE;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/mcp/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/mcp/http-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,gCAAgC;IAChC,OAAO,CAAC,aAAa,CAAC,CAAyB;IAC/C,cAAc;IACd,OAAO,CAAC,UAAU,CAAC,CAAiD;cAEpD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjE,SAAS,CAAC,YAAY,IAAI,IAAI;IAW9B,wBAAwB;IACxB,OAAO,CAAC,gBAAgB;IAkBxB,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAuEhH,+BAA+B;IAC/B,OAAO,CAAC,QAAQ;CAkBjB"}

package/dist/mcp/proxy-agent.d.ts

@@ -0,0 +1,49 @@
+import { type Dispatcher } from 'undici';
+/** 代理模式：system=系统代理, custom=自定义, direct=直连 */
+export type ProxyMode = 'system' | 'custom' | 'direct';
+/** 单分类代理配置 */
+export interface ProxyCategoryConfig {
+    mode: ProxyMode;
+    /** mode='custom' 时的代理 URL */
+    url?: string;
+}
+/** 分类代理设置（LLM / MCP / Fetch 各自独立） */
+export interface ProxySettings {
+    llm: ProxyCategoryConfig;
+    mcp: ProxyCategoryConfig;
+    fetch: ProxyCategoryConfig;
+}
+/** 默认代理设置：全部分类走系统代理 */
+export declare const DEFAULT_PROXY_SETTINGS: ProxySettings;
+/**
+ * 从 Windows 注册表读取系统代理配置
+ * 仅 Windows 平台生效，其他平台返回 undefined
+ * 结果缓存，避免重复查询注册表
+ */
+export declare function getWindowsSystemProxy(): string | undefined;
+/** 清除系统代理缓存（设置变更时可调用） */
+export declare function clearSystemProxyCache(): void;
+/**
+ * 获取系统代理 URL
+ * 优先级：环境变量 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY > macOS scutil > Windows 注册表
+ */
+export declare function getSystemProxyUrl(): string | undefined;
+/**
+ * 根据分类代理配置创建 dispatcher
+ *
+ * - `mode='system'`：自动检测系统代理（环境变量 + Windows 注册表）
+ * - `mode='custom'`：使用用户指定的代理 URL
+ * - `mode='direct'`：不走代理，返回 undefined
+ *
+ * @param category 分类代理配置
+ * @param label 日志标签（如 'LLM', 'MCP', 'Fetch'）
+ * @returns dispatcher 实例，无代理时返回 undefined
+ */
+export declare function resolveProxyAgentForCategory(category?: ProxyCategoryConfig, label?: string): Dispatcher | undefined;
+/**
+ * 获取分类代理的有效 URL（用于 axios 等不支持 undici Dispatcher 的场景）
+ *
+ * @returns 代理 URL 字符串，无代理时返回 undefined
+ */
+export declare function resolveProxyUrlForCategory(category?: ProxyCategoryConfig): string | undefined;
+//# sourceMappingURL=proxy-agent.d.ts.map

package/dist/mcp/proxy-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-agent.d.ts","sourceRoot":"","sources":["../../src/mcp/proxy-agent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAMrD,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvD,cAAc;AACd,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,mBAAmB,CAAC;IACzB,GAAG,EAAE,mBAAmB,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,uBAAuB;AACvB,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAkDF;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAkC1D;AAED,yBAAyB;AACzB,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAStD;AA2BD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,CAAC,EAAE,mBAAmB,EAC9B,KAAK,SAAU,GACd,UAAU,GAAG,SAAS,CAyBxB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAY7F"}

package/dist/mcp/stdio-client.d.ts

@@ -0,0 +1,16 @@
+import { MCPClientBase } from './base-client.ts';
+import type { MCPServerConfig } from './types.ts';
+export declare class StdioMCPClient extends MCPClientBase {
+    private process;
+    private buffer;
+    protected doConnect(config: MCPServerConfig): Promise<void>;
+    protected doDisconnect(): void;
+    protected send(request: {
+        jsonrpc: string;
+        id: number;
+        method: string;
+        params?: Record<string, unknown>;
+    }): void;
+    private flushBuffer;
+}
+//# sourceMappingURL=stdio-client.d.ts.map

package/dist/mcp/stdio-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-client.d.ts","sourceRoot":"","sources":["../../src/mcp/stdio-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,cAAe,SAAQ,aAAa;IAC/C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAM;cAEJ,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDjE,SAAS,CAAC,YAAY,IAAI,IAAI;IAQ9B,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAgBhH,OAAO,CAAC,WAAW;CAkBpB"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,60 @@
+import type { ToolDefinition } from '../tool/types.ts';
+import type { ProxyCategoryConfig } from './proxy-agent.ts';
+export type MCPTransport = 'stdio' | 'http' | 'sse' | 'streamableHttp' | (string & {});
+export interface MCPServerConfig {
+    name: string;
+    transport: MCPTransport;
+    /** stdio 模式：启动命令 */
+    command?: string;
+    /** stdio 模式：命令参数 */
+    args?: string[];
+    /** stdio 模式：环境变量 */
+    env?: Record<string, string>;
+    /** HTTP/SSE/StreamableHTTP 模式：服务端点 */
+    endpoint?: string;
+    /** HTTP/SSE/StreamableHTTP 模式：自定义请求头（如 Authorization） */
+    headers?: Record<string, string>;
+    /** HTTP/SSE/StreamableHTTP 模式：结构化鉴权配置（bearer/basic/apiKey/custom） */
+    auth?: {
+        type: 'bearer' | 'basic' | 'apiKey' | 'custom';
+        value: string;
+        name?: string;
+    };
+    /** 请求超时（毫秒） */
+    timeout?: number;
+    /** 自动重连配置 */
+    autoReconnect?: boolean | {
+        maxRetries?: number;
+        interval?: number;
+    };
+    /**
+     * 分类代理配置（支持 system / custom / direct 三种模式）
+     *
+     * 由上层应用（如 workspace settings）传入对应的 ProxyCategoryConfig，
+     * 客户端根据 mode 自动创建 dispatcher。
+     */
+    proxyCategory?: ProxyCategoryConfig;
+    /** 扩展配置（自定义 transport 的专属数据统一放在此处） */
+    extra?: Record<string, unknown>;
+}
+export interface MCPClient {
+    /** 连接 MCP 服务 */
+    connect(config: MCPServerConfig): Promise<void>;
+    /** 发现远程工具列表 */
+    listTools(): Promise<ToolDefinition[]>;
+    /** 调用远程工具 */
+    callTool(name: string, args: Record<string, unknown>): Promise<string>;
+    /** 发现远程资源列表（可选能力） */
+    listResources?(): Promise<Array<{
+        uri: string;
+        name: string;
+        description?: string;
+    }>>;
+    /** 读取远程资源（可选能力） */
+    readResource?(uri: string): Promise<string>;
+    /** 断开连接 */
+    disconnect(): void;
+    /** 连接状态 */
+    isConnected(): boolean;
+}
+//# sourceMappingURL=types.d.ts.map