@ddlqhd/agent-sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,664 @@
+import { S as StorageConfig, M as Message, a as SessionInfo, b as StorageAdapter, T as ToolResult, c as ToolDefinition, A as AgentConfig, d as SystemPrompt, e as StreamEvent, f as AgentResult, g as MCPServerConfig, h as SessionTokenUsage, i as TokenUsage, j as StreamChunk, P as ParsedSkill, k as MemoryConfig } from './types-C0aX_Qdp.js';
+export { l as AgentCallbacks, m as AskUserQuestionAnswer, n as AskUserQuestionItem, o as AskUserQuestionResolver, p as AssistantMessage, C as CLIConfig, q as CanUseToolCallback, r as ChatOptions, s as CommandHookConfig, t as CompletionResult, u as ContentPart, v as ContextManagerConfig, w as CreateAskUserQuestionToolOptions, F as FlatCommandHookEntry, x as FunctionHook, H as HookContext, y as HookEventType, z as HookGroupConfig, B as HookManager, D as HookResult, E as HooksSettings, G as HooksSettingsFile, I as ImageContent, J as MCPOptions, K as MCPPromptArgument, L as MCPResourceContent, N as MessageRole, O as ModelAdapter, Q as ModelCapabilities, R as ModelParams, U as RunOptions, V as SessionListOptions, W as SkillConfig, X as SkillDefinition, Y as SkillMetadata, Z as SkillOptions, _ as StreamChunkType, $ as StreamEventAnnotations, a0 as StreamEventType, a1 as SystemMessage, a2 as SystemPromptConfig, a3 as TextContent, a4 as ThinkingContent, a5 as ToolCall, a6 as ToolExecutionContext, a7 as ToolExecutionPolicy, a8 as ToolHandler, a9 as ToolListOptions, aa as ToolMessage, ab as ToolResultMetadata, ac as ToolSchema, ad as UserMessage, ae as buildHookEnv, af as createAskUserQuestionTool, ag as createFunctionHook, ah as formatAnswerSummary, ai as formatAskUserQuestionPrompt, aj as getInteractionTools, ak as matchTool, al as mergeCommandHookLayers, am as questionTool } from './types-C0aX_Qdp.js';
+import { T as ToolRegistry, S as SkillRegistry } from './index-DPsZ1zat.js';
+export { C as CreateAgentToolOptions, D as DEFAULT_GREP_HEAD_LIMIT, M as MAX_LINE_LENGTH, a as SkillLoader, b as SkillLoaderConfig, c as SubagentRequest, d as SubagentRunner, e as ToolExecuteOptions, f as ToolRegistryConfig, g as agentTool, h as bashTool, i as createAgentTool, j as createSkillLoader, k as createSkillRegistry, l as createSkillTool, m as createTool, n as editTool, o as getAllBuiltinTools, p as getFileSystemTools, q as getGlobalRegistry, r as getGrepTools, s as getSafeBuiltinTools, t as getShellTools, u as getSkillTools, v as getSubagentTools, w as getTaskTools, x as getWebTools, y as globTool, z as grepTool, A as loadHooksSettingsFromProject, B as loadHooksSettingsFromUser, E as parseHooksSettingsFile, F as readFileTool, G as subagentRequestSchema, H as taskCreateTool, I as taskListTool, J as taskUpdateTool, K as truncateMatchLineForDisplay, L as webFetchTool, N as webSearchTool, O as writeFileTool } from './index-DPsZ1zat.js';
+export { AnthropicAdapter, AnthropicConfig, CreateModelConfig, ModelProvider, OllamaAdapter, OllamaConfig, OpenAIAdapter, OpenAIConfig, createAnthropic, createModel, createOllama, createOpenAI } from './models/index.js';
+import 'zod';
+
+/**
+ * 会话管理器配置
+ */
+interface SessionManagerConfig extends StorageConfig {
+    /** 存储路径 */
+    basePath?: string;
+}
+/**
+ * 会话管理器
+ */
+declare class SessionManager {
+    private storage;
+    private currentSessionId;
+    constructor(config?: SessionManagerConfig);
+    /**
+     * 获取当前会话 ID
+     */
+    get sessionId(): string | null;
+    /**
+     * 创建新会话
+     */
+    createSession(sessionId?: string): string;
+    /**
+     * 恢复会话
+     */
+    resumeSession(sessionId: string): Promise<Message[]>;
+    /**
+     * 保存消息到当前会话
+     */
+    saveMessages(messages: Message[]): Promise<void>;
+    /**
+     * 加载当前会话消息
+     */
+    loadMessages(): Promise<Message[]>;
+    /**
+     * 追加消息
+     */
+    appendMessage(message: Message): Promise<void>;
+    /**
+     * 列出所有会话
+     */
+    listSessions(): Promise<SessionInfo[]>;
+    /**
+     * 删除会话
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * 检查会话是否存在
+     */
+    sessionExists(sessionId: string): Promise<boolean>;
+    /**
+     * 获取会话信息
+     */
+    getSessionInfo(sessionId: string): Promise<SessionInfo | null>;
+    /**
+     * 清空当前会话
+     */
+    clearCurrentSession(): Promise<void>;
+    /**
+     * 获取底层存储适配器
+     */
+    getStorage(): StorageAdapter;
+}
+/**
+ * 创建会话管理器
+ */
+declare function createSessionManager(config?: StorageConfig): SessionManager;
+
+interface StdioMCPConfig {
+    name: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+interface HttpMCPConfig {
+    name: string;
+    url: string;
+    headers?: Record<string, string>;
+}
+type MCPClientConfig = StdioMCPConfig | HttpMCPConfig;
+interface MCPTool {
+    name: string;
+    description?: string;
+    inputSchema: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+}
+interface MCPResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+interface MCPPrompt {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+interface PromptMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+declare class MCPClient {
+    private client;
+    private transport;
+    private _name;
+    private _connected;
+    private _tools;
+    private _serverInfo?;
+    constructor(config: MCPClientConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    listTools(): Promise<MCPTool[]>;
+    callTool(name: string, args: unknown): Promise<ToolResult>;
+    listResources(): Promise<MCPResource[]>;
+    readResource(uri: string): Promise<string>;
+    listPrompts(): Promise<MCPPrompt[]>;
+    getPrompt(name: string, args?: Record<string, string>): Promise<PromptMessage[]>;
+    toToolDefinitions(): ToolDefinition[];
+    private convertSchema;
+    get name(): string;
+    get connected(): boolean;
+    get serverInfo(): {
+        name: string;
+        version: string;
+    } | undefined;
+    get tools(): MCPTool[];
+}
+declare function createMCPClient(config: MCPClientConfig): MCPClient;
+
+declare class MCPAdapter {
+    private clients;
+    private toolMap;
+    addServer(config: MCPClientConfig): Promise<void>;
+    removeServer(name: string): Promise<void>;
+    getToolDefinitions(): ToolDefinition[];
+    executeTool(fullName: string, args: unknown): Promise<ToolResult>;
+    getClient(name: string): MCPClient | undefined;
+    getServerNames(): string[];
+    isConnected(name: string): boolean;
+    disconnectAll(): Promise<void>;
+    listAllTools(): Promise<Map<string, MCPTool[]>>;
+    listAllResources(): Promise<Map<string, Awaited<ReturnType<MCPClient['listResources']>>>>;
+    get size(): number;
+}
+declare function createMCPAdapter(): MCPAdapter;
+
+/**
+ * 流式执行选项
+ */
+interface StreamOptions {
+    sessionId?: string;
+    systemPrompt?: SystemPrompt;
+    signal?: AbortSignal;
+    /** Pass through to {@link ModelParams.includeRawStreamEvents} (e.g. Anthropic `providerRaw` on chunks). */
+    includeRawStreamEvents?: boolean;
+}
+/**
+ * Agent 类
+ * 核心执行引擎，管理对话循环和工具调用
+ */
+declare class Agent {
+    private config;
+    private toolRegistry;
+    private sessionManager;
+    private messages;
+    private mcpAdapter;
+    private skillRegistry;
+    private initPromise;
+    private contextManager;
+    private hookDiscoverPromise;
+    private agentDepth;
+    private activeSubagentRuns;
+    private sessionUsage;
+    constructor(config: AgentConfig);
+    /**
+     * 注册内置 + 自定义工具，或仅 {@link AgentConfig.exclusiveTools}。
+     */
+    private registerInitialTools;
+    /**
+     * 异步初始化（skills 和 MCP）
+     */
+    private initializeAsync;
+    /**
+     * 等待初始化完成
+     * CLI 应在开始交互前调用此方法
+     */
+    waitForInit(): Promise<void>;
+    /**
+     * 初始化 MCP 服务器
+     */
+    private initializeMCP;
+    private annotateStreamEvent;
+    private static createEmptySessionUsage;
+    private resetSessionState;
+    /**
+     * 构建系统提示词
+     * 处理默认提示词、替换模式、追加模式
+     */
+    private buildSystemPrompt;
+    /**
+     * 流式执行
+     */
+    stream(input: string, options?: StreamOptions): AsyncIterable<StreamEvent>;
+    /**
+     * 非流式执行
+     */
+    run(input: string, options?: StreamOptions): Promise<AgentResult>;
+    /**
+     * 注册工具
+     */
+    registerTool(tool: Parameters<ToolRegistry['register']>[0]): void;
+    /**
+     * 注册多个工具
+     */
+    registerTools(tools: Parameters<ToolRegistry['registerMany']>[0]): void;
+    /**
+     * 获取工具注册中心
+     */
+    getToolRegistry(): ToolRegistry;
+    /**
+     * 获取会话管理器
+     */
+    getSessionManager(): SessionManager;
+    /**
+     * 加载 Skill
+     */
+    loadSkill(path: string): Promise<void>;
+    /**
+     * 获取 Skill 注册中心
+     */
+    getSkillRegistry(): SkillRegistry;
+    /**
+     * 处理用户输入，检测并处理 skill 调用
+     * @param input 用户输入
+     * @returns 处理结果
+     */
+    processInput(input: string): Promise<{
+        invoked: boolean;
+        skillName?: string;
+        prompt: string;
+    }>;
+    /**
+     * 调用 skill 并返回处理后的 prompt
+     * @param name Skill 名称
+     * @param args 参数字符串
+     * @returns 处理后的 prompt
+     */
+    invokeSkill(name: string, args?: string): Promise<string>;
+    /**
+     * 解析 skill 调用格式
+     * 格式: /skill-name [args]
+     * @param input 用户输入
+     * @returns 解析结果或 null
+     */
+    private parseSkillInvocation;
+    /**
+     * 连接 MCP 服务器
+     */
+    connectMCP(config: MCPServerConfig): Promise<void>;
+    /**
+     * 断开指定 MCP 服务器
+     */
+    disconnectMCP(name: string): Promise<void>;
+    /**
+     * 断开所有 MCP 服务器
+     */
+    disconnectAllMCP(): Promise<void>;
+    /**
+     * 获取 MCP 适配器
+     */
+    getMCPAdapter(): MCPAdapter | null;
+    /**
+     * 销毁 Agent，清理资源
+     */
+    destroy(): Promise<void>;
+    /**
+     * 获取消息历史
+     */
+    getMessages(): Message[];
+    /**
+     * 清空消息历史
+     */
+    clearMessages(): void;
+    /**
+     * 设置系统提示 (运行时替换)
+     */
+    setSystemPrompt(prompt: SystemPrompt): void;
+    /**
+     * 追加系统提示内容
+     */
+    appendSystemPrompt(additionalContent: string): void;
+    /**
+     * 获取当前系统提示内容
+     */
+    getSystemPrompt(): string | undefined;
+    /**
+     * 手动触发上下文压缩
+     */
+    compressContext(): Promise<{
+        messageCount: number;
+        stats: {
+            originalMessageCount: number;
+            compressedMessageCount: number;
+            durationMs: number;
+        };
+    }>;
+    /**
+     * 获取上下文状态
+     */
+    getContextStatus(): {
+        used: number;
+        usable: number;
+        needsCompaction: boolean;
+        compressCount: number;
+    } | null;
+    /**
+     * 获取会话累计 Token 使用量
+     */
+    getSessionUsage(): SessionTokenUsage;
+    /**
+     * 检查并执行上下文压缩
+     * @returns 压缩事件数组（可能为空）
+     */
+    private checkContextCompression;
+    private getSubagentConfig;
+    private resolveSubagentTools;
+    private runSubagent;
+    /**
+     * 获取默认系统提示词
+     */
+    static getDefaultSystemPrompt(): string;
+    /**
+     * 执行工具调用
+     */
+    private executeTools;
+}
+/**
+ * 创建 Agent 实例
+ */
+declare function createAgent(config: AgentConfig): Agent;
+
+/**
+ * Agent SDK 默认系统提示词
+ *
+ * 占位符说明：
+ * - {{SKILL_LIST}}: 会被运行时注入的skill列表替换
+ */
+declare const DEFAULT_SYSTEM_PROMPT = "You are an AI assistant powered by the Agent SDK. You can help users with various tasks by using your built-in tools and capabilities.\n\n## Core Capabilities\n\n### Tools\nYou have access to a set of tools that allow you to:\n- **File Operations**: read, write, list, delete files and directories\n- **Code Execution**: run shell commands, Python scripts, Node.js code\n- **Web Access**: make HTTP requests, fetch webpages, download files\n- **Custom Tools**: additional tools registered by the user or skills\n\nWhen to use tools:\n- Use tools when the task requires real-world actions (file I/O, computation, API calls)\n- Prefer reading files before modifying them\n- Use the simplest tool that gets the job done\n- Run multiple independent tool calls in parallel when possible\n\n**Prefer dedicated tools over Bash:** Do not use `Bash` to do work that has a first-class tool. This keeps actions reviewable and consistent.\n- **Read** for file contents \u2014 not `cat`, `head`, `tail`, or `sed` to print files\n- **Write** to create or overwrite files \u2014 not shell redirection or heredocs\n- **Edit** for targeted file changes \u2014 not `sed`, `awk`, or ad-hoc scripts to patch files\n- **Glob** to find paths by pattern \u2014 not `find` or `ls` for discovery\n- **Grep** to search file contents \u2014 not `grep` or `rg` in the shell (built-in line-by-line regex search; correct integration)\n- **WebFetch** / **WebSearch** when the task needs HTTP or web search (when configured)\n\nReserve **Bash** for real shell needs: `git`, package managers, build commands, compilers, and other operations that require a shell or are not covered above.\n\n### Skills\nSkills are instruction guides for specialized tasks. When activated, you receive the skill's full content including any referenced file paths.\n\n{{SKILL_LIST}}\n\n**Usage:**\n- **Listing skills**: When the user asks about available skills (e.g., \"what skills do you have\", \"\u4F60\u6709\u54EA\u4E9B\u6280\u80FD\", \"list your skills\") \u2192 Simply describe the skills listed above. Do NOT activate any skill.\n- **Activating skills**: When the user has a specific task that matches a skill's purpose \u2192 Call `Skill` with the skill name, then follow the returned instructions.\n- After activation, use the provided Base Path to read any referenced files.\n\n### Sessions\n- Conversations are persisted in sessions\n- Use session IDs to maintain context across multiple interactions\n- Previous messages provide important context for current tasks\n\n## Task Execution Principles\n\n1. **Plan First for Complex Tasks**: For multi-step tasks, you MUST call `TaskCreate` BEFORE any other tool. Do NOT skip this step.\n2. **Be Direct**: Go straight to the point. Try the simplest approach first.\n3. **Be Concise**: If you can say it in one sentence, don't use three.\n4. **Read Before Modify**: Always understand existing code before changing it.\n5. **No Over-Engineering**: Only make changes directly requested or clearly necessary.\n6. **Prefer Edit Over Create**: Modify existing files rather than creating new ones when appropriate.\n7. **Handle Errors Gracefully**: Report errors clearly with actionable suggestions.\n\n## Task Management with Todo List\n\n**MANDATORY**: For multi-step tasks, call `TaskCreate` FIRST.\n\n**Workflow:**\n1. Receive complex task -> call `TaskCreate` immediately\n2. Start first task (in_progress) -> complete -> mark completed\n3. Move to next task -> repeat\n4. Cancel tasks that become irrelevant\n\n**Example:**\nUser: \"Open Google, search X, summarize results, open first link, extract info\"\n-> Multi-step task detected -> call `TaskCreate` FIRST, then execute.\n\n## Output Format\n\n- Lead with the answer or action, not the reasoning\n- Skip filler words and unnecessary preamble\n- Use code blocks with language hints for code\n- Structure longer responses with headers and lists\n- Reference file paths with line numbers when relevant (e.g., `src/index.ts:42`)\n\n## Security Guidelines\n\n- Do not introduce security vulnerabilities (injection, XSS, etc.)\n- Validate user inputs at boundaries\n- Do not execute untrusted code without sandboxing\n- Respect file system permissions and access controls\n\n### High-risk actions (confirm with the user first)\n\nThere is no automatic approval UI: **ask in the conversation** (or use `AskUserQuestion`) before proceeding when an action is destructive, hard to reverse, or affects others. Examples:\n- Deleting files or branches, dropping data, `rm -rf`, overwriting uncommitted work\n- Hard-to-reverse git: force-push, `reset --hard`, rewriting published history, amending shared commits\n- Actions visible outside this machine: pushing code, opening/closing/commenting on PRs or issues, sending messages, posting to external services, changing shared CI/CD or cloud permissions\n- Broad dependency or infrastructure changes (e.g. major version bumps, lockfile rewrites) when impact is unclear\n\nDefault to explaining what you intend and getting explicit agreement unless the user already directed that exact action.\n\n## Tool hooks\n\nWhen hooks are configured (e.g. PreToolUse), a tool call may be **blocked** or its **inputs adjusted** before execution. If a tool fails with a message indicating a hook blocked or rejected the call, **do not** retry the identical tool call unchanged \u2014 read the reason, change your approach, or ask the user. Treat hook feedback as binding policy from the environment.\n\n## Interaction Style\n\n- Be helpful and proactive\n- Ask clarifying questions when instructions are ambiguous\n- Provide suggestions when you see opportunities for improvement\n- Acknowledge limitations honestly\n- Maintain a professional, friendly tone";
+
+/**
+ * Same directory as {@link Agent} session storage: `<userBase>/.claude/sessions`.
+ */
+declare function getSessionStoragePath(userBasePath?: string): string;
+/**
+ * Most recently updated session id from JSONL storage, or `undefined` if none.
+ */
+declare function getLatestSessionId(userBasePath?: string): Promise<string | undefined>;
+
+/**
+ * JSONL 文件存储配置
+ */
+interface JsonlStorageConfig {
+    basePath?: string;
+}
+/**
+ * JSONL 文件存储实现
+ * 每个会话一个 .jsonl 文件，每行一条消息
+ */
+declare class JsonlStorage implements StorageAdapter {
+    private basePath;
+    constructor(config?: JsonlStorageConfig);
+    /**
+     * 获取会话文件路径
+     */
+    private getFilePath;
+    /**
+     * 获取元数据文件路径
+     */
+    private getMetaFilePath;
+    /**
+     * 确保目录存在
+     */
+    private ensureDir;
+    /**
+     * 保存消息（追加模式）
+     */
+    save(sessionId: string, messages: Message[]): Promise<void>;
+    /**
+     * 加载消息
+     */
+    load(sessionId: string): Promise<Message[]>;
+    /**
+     * 列出所有会话
+     */
+    list(): Promise<SessionInfo[]>;
+    /**
+     * 删除会话
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * 检查会话是否存在
+     */
+    exists(sessionId: string): Promise<boolean>;
+    /**
+     * 清空所有会话
+     */
+    clear(): Promise<void>;
+    /**
+     * 获取会话统计
+     */
+    getStats(sessionId: string): Promise<{
+        messageCount: number;
+        createdAt: number;
+        updatedAt: number;
+        size: number;
+    } | null>;
+}
+/**
+ * 创建 JSONL 存储
+ */
+declare function createJsonlStorage(config?: JsonlStorageConfig): JsonlStorage;
+
+/**
+ * 内存存储实现
+ * 用于测试或临时会话，重启后数据丢失
+ */
+declare class MemoryStorage implements StorageAdapter {
+    private sessions;
+    private metadata;
+    /**
+     * 保存消息
+     */
+    save(sessionId: string, messages: Message[]): Promise<void>;
+    /**
+     * 加载消息
+     */
+    load(sessionId: string): Promise<Message[]>;
+    /**
+     * 列出所有会话
+     */
+    list(): Promise<SessionInfo[]>;
+    /**
+     * 删除会话
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * 检查会话是否存在
+     */
+    exists(sessionId: string): Promise<boolean>;
+    /**
+     * 清空所有会话
+     */
+    clear(): Promise<void>;
+    /**
+     * 获取会话数量
+     */
+    get size(): number;
+    /**
+     * 导出所有数据
+     */
+    export(): Record<string, Message[]>;
+    /**
+     * 导入数据
+     */
+    import(data: Record<string, Message[]>): void;
+}
+/**
+ * 创建内存存储
+ */
+declare function createMemoryStorage(): MemoryStorage;
+
+/**
+ * 存储工厂函数
+ */
+declare function createStorage(config?: StorageConfig & {
+    basePath?: string;
+}): StorageAdapter;
+
+/**
+ * Agent 流类
+ * 实现 AsyncIterable 接口，支持 for await...of 遍历
+ */
+declare class AgentStream implements AsyncIterable<StreamEvent> {
+    private events;
+    private resolvers;
+    private isEnded;
+    private error;
+    private abortController;
+    constructor();
+    /**
+     * 实现 AsyncIterable 接口
+     */
+    [Symbol.asyncIterator](): AsyncIterator<StreamEvent>;
+    /**
+     * 推送事件
+     */
+    push(event: StreamEvent): void;
+    /**
+     * 结束流
+     */
+    end(usage?: TokenUsage): void;
+    /**
+     * Marks the stream complete without pushing an event. Use when the producer already emitted a terminal `{ type: 'end' }` and iterators must unblock.
+     */
+    finalize(): void;
+    /**
+     * 抛出错误
+     */
+    throwError(error: Error): void;
+    /**
+     * 中止流
+     */
+    abort(): void;
+    /**
+     * 获取中止信号
+     */
+    get signal(): AbortSignal;
+    /**
+     * 合并多个流
+     */
+    static merge(...streams: AgentStream[]): AgentStream;
+    /**
+     * 转换为数组
+     */
+    toArray(): Promise<StreamEvent[]>;
+    /**
+     * 收集文本内容
+     */
+    collectText(): Promise<string>;
+    /**
+     * 过滤事件
+     */
+    filter(predicate: (event: StreamEvent) => boolean): AgentStream;
+    /**
+     * 转换事件
+     */
+    map<T>(transform: (event: StreamEvent) => T): AsyncIterable<T>;
+}
+/**
+ * 创建 Agent 流
+ */
+declare function createStream(): AgentStream;
+/**
+ * 从 AsyncIterable 创建 Agent 流
+ */
+declare function fromAsyncIterable(iterable: AsyncIterable<StreamEvent>): AgentStream;
+
+interface StreamChunkProcessorOptions {
+    /** Emit `text_start` / `text_end` around assistant text deltas (Claude-style content blocks). Default true. */
+    emitTextBoundaries?: boolean;
+}
+/**
+ * Stateful conversion from model `StreamChunk` to normalized `StreamEvent`s.
+ * Used by `Agent` so streaming tool JSON and text blocks behave consistently.
+ */
+declare class StreamChunkProcessor {
+    private currentToolCall;
+    private lastUsage;
+    private inTextBlock;
+    private readonly emitTextBoundaries;
+    constructor(options?: StreamChunkProcessorOptions);
+    processChunk(chunk: StreamChunk): StreamEvent[];
+    /** End open text block and finalize any in-progress streamed tool call. */
+    flush(): StreamEvent[];
+    getUsage(): TokenUsage | undefined;
+    private finalizeStreamingToolCall;
+    private safeParseJSON;
+}
+
+/**
+ * 解析 SKILL.md 文件
+ * 格式：
+ * ---
+ * name: skill-name
+ * description: "Skill description"
+ * version: "1.0.0"
+ * ---
+ *
+ * # Instructions
+ * ...
+ */
+declare function parseSkillMd(content: string): ParsedSkill;
+
+/**
+ * MemoryManager handles the loading of long-term memory files
+ * (CLAUDE.md) from user home directory and workspace root.
+ */
+declare class MemoryManager {
+    private workspaceRoot;
+    private userBasePath;
+    private config;
+    constructor(workspaceRoot?: string, config?: MemoryConfig, userBasePath?: string);
+    /**
+     * Loads memory content from both user home ({userBasePath}/.claude/CLAUDE.md)
+     * and workspace root (./CLAUDE.md).
+     * @returns Combined memory content wrapped in system-minder tags
+     */
+    loadMemory(): string;
+    /**
+     * Checks if memory files exist.
+     * @returns Object indicating existence of each memory file type
+     */
+    checkMemoryFiles(): {
+        userHome: boolean;
+        workspace: boolean;
+    };
+}
+
+/**
+ * MCP 配置文件格式 (Claude Desktop 兼容)
+ */
+interface MCPConfigFile {
+    mcpServers: {
+        [name: string]: {
+            /** 命令 (stdio transport) */
+            command?: string;
+            /** 命令参数 */
+            args?: string[];
+            /** 环境变量 */
+            env?: Record<string, string>;
+            /** URL (HTTP transport) */
+            url?: string;
+            /** HTTP headers */
+            headers?: Record<string, string>;
+        };
+    };
+}
+/**
+ * MCP 配置加载结果
+ */
+interface MCPConfigLoadResult {
+    servers: MCPServerConfig[];
+    /** 主配置文件路径 */
+    configPath?: string;
+    /** 所有加载的配置文件路径 */
+    configPaths?: string[];
+}
+/**
+ * 加载 MCP 配置
+ * @param configPath 可选的配置文件路径，如未提供则自动加载用户目录和工作目录配置
+ * @param startDir 搜索起始目录，默认为当前工作目录
+ * @param userBasePath 用户级基础路径，默认 ~ (homedir)
+ */
+declare function loadMCPConfig(configPath?: string, startDir?: string, userBasePath?: string): MCPConfigLoadResult;
+/**
+ * 验证 MCP 配置
+ */
+declare function validateMCPConfig(config: MCPConfigFile): string[];
+
+export { Agent, AgentConfig, AgentResult, AgentStream, DEFAULT_SYSTEM_PROMPT, type HttpMCPConfig, JsonlStorage, MCPAdapter, MCPClient, type MCPClientConfig, type MCPConfigFile, type MCPConfigLoadResult, type MCPPrompt, type MCPResource, MCPServerConfig, type MCPTool, MemoryConfig, MemoryManager, MemoryStorage, Message, ParsedSkill, type PromptMessage, SessionInfo, SessionManager, SessionTokenUsage, SkillRegistry, type StdioMCPConfig, StorageAdapter, StorageConfig, StreamChunk, StreamChunkProcessor, type StreamChunkProcessorOptions, StreamEvent, type StreamOptions, SystemPrompt, TokenUsage, ToolDefinition, ToolRegistry, ToolResult, createAgent, createJsonlStorage, createMCPAdapter, createMCPClient, createMemoryStorage, createSessionManager, createStorage, createStream, fromAsyncIterable, getLatestSessionId, getSessionStoragePath, loadMCPConfig, parseSkillMd, validateMCPConfig };