@ddlqhd/agent-sdk 0.1.0

package/dist/types-C0aX_Qdp.d.cts

@@ -0,0 +1,917 @@
+import { z } from 'zod';
+
+/**
+ * Hook 事件类型（运行时）
+ */
+type HookEventType = 'preToolUse' | 'postToolUse' | 'postToolUseFailure';
+/**
+ * Hook 执行上下文
+ */
+interface HookContext {
+    eventType: HookEventType;
+    toolName: string;
+    /** 已校验的工具参数 */
+    toolInput: Record<string, unknown>;
+    toolCallId?: string;
+    timestamp: number;
+    projectDir?: string;
+    /** PostToolUse：handler 返回的原始结果（未经 outputHandler） */
+    toolResultRaw?: ToolResult;
+    /** PostToolUse：将返回给调用方的最终结果 */
+    toolResultFinal?: ToolResult;
+    /** PostToolUseFailure */
+    errorMessage?: string;
+    failureKind?: 'validation' | 'handler_throw' | 'tool_error';
+}
+/**
+ * PreToolUse 阶段 Hook 执行结果
+ */
+interface HookResult {
+    allowed: boolean;
+    reason?: string;
+    updatedInput?: Record<string, unknown>;
+}
+/**
+ * JavaScript 函数 Hook（代码设置方式）
+ */
+interface FunctionHook {
+    id: string;
+    event: HookEventType;
+    matcher?: string;
+    handler: (context: HookContext) => Promise<HookResult | void>;
+    description?: string;
+}
+/**
+ * Shell 命令 Hook 配置（配置文件解析后）
+ */
+interface CommandHookConfig {
+    id?: string;
+    type: 'command';
+    command: string;
+    timeout?: number;
+    async?: boolean;
+}
+interface HookGroupConfig {
+    matcher?: string;
+    hooks: CommandHookConfig[];
+}
+/**
+ * 配置文件解析后的设置（内部）
+ */
+interface HooksSettings {
+    disableAllHooks?: boolean;
+    hooks: Record<HookEventType, HookGroupConfig[]>;
+}
+/** 磁盘 JSON（hooks 下为 PascalCase 键） */
+interface HooksSettingsFile {
+    disableAllHooks?: boolean;
+    hooks?: {
+        PreToolUse?: HookGroupConfig[];
+        PostToolUse?: HookGroupConfig[];
+        PostToolUseFailure?: HookGroupConfig[];
+    };
+}
+
+/** 扁平化的文件 command hook（含 matcher） */
+interface FlatCommandHookEntry {
+    matcher?: string;
+    hook: CommandHookConfig;
+}
+/**
+ * matcher 为 JavaScript 正则源码（不含定界符）
+ */
+declare function matchTool(toolName: string, matcher?: string): boolean;
+declare function buildHookEnv(context: HookContext): NodeJS.ProcessEnv;
+/**
+ * 合并项目层与用户层 command hook（§6.3）
+ */
+declare function mergeCommandHookLayers(project: HookGroupConfig[], user: HookGroupConfig[]): FlatCommandHookEntry[];
+declare class HookManager {
+    private runtimeEnabled;
+    private mergedDisableAll;
+    private mergedHooks;
+    private functionHooks;
+    private projectHooks;
+    private userHooks;
+    private emptySettings;
+    private rebuildMerged;
+    private shouldRunHooks;
+    private getHooksForEvent;
+    private getFunctionHooksForEvent;
+    private runCommandHook;
+    private fireAsyncCommandHook;
+    private runFunctionHookSafe;
+    register(hook: FunctionHook): void;
+    unregister(id: string): boolean;
+    loadProjectConfig(projectDir: string): Promise<void>;
+    loadUserConfig(): Promise<void>;
+    discoverAndLoad(projectDir?: string): Promise<void>;
+    setEnabled(enabled: boolean): void;
+    isEnabled(): boolean;
+    executePreToolUse(context: HookContext): Promise<HookResult>;
+    executePostToolUse(context: HookContext): Promise<void>;
+    executePostToolUseFailure(context: HookContext): Promise<void>;
+    static create(): HookManager;
+}
+declare function createFunctionHook(config: {
+    id: string;
+    event: HookEventType;
+    matcher?: string;
+    description?: string;
+    handler: (context: HookContext) => Promise<HookResult | void>;
+}): FunctionHook;
+
+declare const questionsSchema: z.ZodObject<{
+    questions: z.ZodArray<z.ZodObject<{
+        question: z.ZodString;
+        header: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            label: string;
+        }, {
+            description: string;
+            label: string;
+        }>, "many">;
+        multiSelect: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect: boolean;
+    }, {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    questions: {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect: boolean;
+    }[];
+}, {
+    questions: {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect?: boolean | undefined;
+    }[];
+}>;
+type AskUserQuestionItem = z.infer<typeof questionsSchema>['questions'][number];
+type AskUserQuestionAnswer = {
+    questionIndex: number;
+    selectedLabels: string[];
+    otherText?: string;
+};
+/**
+ * Host-provided implementation: CLI (TTY), web UI (WebSocket), tests, etc.
+ */
+type AskUserQuestionResolver = (questions: AskUserQuestionItem[]) => Promise<AskUserQuestionAnswer[]>;
+/**
+ * Format questions for display (static fallback body).
+ */
+declare function formatAskUserQuestionPrompt(questions: AskUserQuestionItem[]): string;
+declare function formatAnswerSummary(questions: AskUserQuestionItem[], answers: AskUserQuestionAnswer[]): string;
+interface CreateAskUserQuestionToolOptions {
+    /**
+     * When set, collects answers interactively. When omitted, the tool returns only formatted questions (non-blocking).
+     */
+    resolve?: AskUserQuestionResolver;
+}
+/**
+ * AskUserQuestion — interactive behavior is entirely determined by {@link CreateAskUserQuestionToolOptions.resolve}.
+ */
+declare function createAskUserQuestionTool(options?: CreateAskUserQuestionToolOptions): ToolDefinition;
+declare const questionTool: ToolDefinition;
+/**
+ * Interaction tools (AskUserQuestion).
+ */
+declare function getInteractionTools(options?: CreateAskUserQuestionToolOptions): ToolDefinition[];
+
+/**
+ * 压缩器接口
+ */
+interface Compressor {
+    /** 压缩名称 (用于日志) */
+    name: string;
+    /**
+     * 执行压缩
+     * @param messages 原始消息列表
+     * @param targetTokens 目标 token 数
+     * @returns 压缩后的消息列表
+     */
+    compress(messages: Message[], targetTokens: number): Promise<Message[]>;
+}
+
+/**
+ * 文本内容部分
+ */
+interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * 思考内容部分 (用于支持 extended thinking)
+ */
+interface ThinkingContent {
+    type: 'thinking';
+    thinking: string;
+    signature?: string;
+}
+/**
+ * 图片内容部分
+ */
+interface ImageContent {
+    type: 'image';
+    imageUrl: string;
+    mimeType?: string;
+}
+/**
+ * 内容部分联合类型
+ */
+type ContentPart = TextContent | ThinkingContent | ImageContent;
+/**
+ * 工具调用
+ */
+interface ToolCall {
+    id: string;
+    name: string;
+    arguments: unknown;
+}
+/**
+ * 消息角色
+ */
+type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+/**
+ * 消息
+ */
+interface Message {
+    role: MessageRole;
+    content: string | ContentPart[];
+    toolCalls?: ToolCall[];
+    toolCallId?: string;
+    name?: string;
+    timestamp?: number;
+}
+/**
+ * 系统消息
+ */
+interface SystemMessage extends Message {
+    role: 'system';
+    content: string;
+}
+/**
+ * 用户消息
+ */
+interface UserMessage extends Message {
+    role: 'user';
+    content: string | ContentPart[];
+}
+/**
+ * 助手消息
+ */
+interface AssistantMessage extends Message {
+    role: 'assistant';
+    content: string;
+    toolCalls?: ToolCall[];
+}
+/**
+ * 工具结果消息
+ */
+interface ToolMessage extends Message {
+    role: 'tool';
+    content: string;
+    toolCallId: string;
+}
+/**
+ * 模型参数
+ */
+interface ModelParams {
+    messages: Message[];
+    tools?: ToolDefinition[];
+    temperature?: number;
+    maxTokens?: number;
+    stopSequences?: string[];
+    signal?: AbortSignal;
+    /**
+     * When true, adapters may attach `providerRaw` on each {@link StreamChunk} (e.g. Anthropic SSE JSON object).
+     */
+    includeRawStreamEvents?: boolean;
+}
+/**
+ * 流式块类型
+ */
+type StreamChunkType = 'text' | 'tool_call' | 'tool_call_start' | 'tool_call_delta' | 'tool_call_end' | 'thinking' | 'error' | 'done' | 'metadata';
+/**
+ * 流式块
+ */
+interface StreamChunk {
+    type: StreamChunkType;
+    content?: string;
+    toolCall?: ToolCall;
+    toolCallId?: string;
+    error?: Error;
+    metadata?: Record<string, unknown>;
+    /** When `type === 'metadata'`, distinguishes prompt vs completion usage timing (e.g. Anthropic). */
+    usagePhase?: 'input' | 'output';
+    signature?: string;
+    /** Raw provider streaming payload when {@link ModelParams.includeRawStreamEvents} is enabled */
+    providerRaw?: unknown;
+}
+/**
+ * 完成结果
+ */
+interface CompletionResult {
+    content: string;
+    /** Ollama extended thinking trace (when using thinking-capable models). */
+    thinking?: string;
+    toolCalls?: ToolCall[];
+    usage?: TokenUsage;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Token 使用统计
+ */
+interface TokenUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+/**
+ * 会话 Token 使用统计
+ *
+ * 关键区分：
+ * - contextTokens: 当前上下文大小 (最近一次 API 返回的 input_tokens，用于压缩判断)
+ * - inputTokens: 累计输入消耗
+ * - outputTokens: 累计输出消耗
+ * - totalTokens: 累计总消耗 (inputTokens + outputTokens)
+ */
+interface SessionTokenUsage {
+    /** 当前上下文 tokens (最近一次 API 返回的 input_tokens，用于压缩判断) */
+    contextTokens: number;
+    /** 累计输入 tokens */
+    inputTokens: number;
+    /** 累计输出 tokens */
+    outputTokens: number;
+    /** 累计缓存读取 tokens */
+    cacheReadTokens: number;
+    /** 累计缓存写入 tokens */
+    cacheWriteTokens: number;
+    /** 累计总 tokens (inputTokens + outputTokens) */
+    totalTokens: number;
+}
+/**
+ * 模型能力描述
+ */
+interface ModelCapabilities {
+    /** 上下文窗口长度 (tokens) */
+    contextLength: number;
+    /** 最大输出 token 数 */
+    maxOutputTokens?: number;
+}
+/**
+ * 模型适配器接口
+ */
+interface ModelAdapter {
+    /** 模型名称 */
+    name: string;
+    /** 模型能力 (可选) */
+    capabilities?: ModelCapabilities;
+    /** 流式生成 */
+    stream(params: ModelParams): AsyncIterable<StreamChunk>;
+    /** 完整生成 */
+    complete(params: ModelParams): Promise<CompletionResult>;
+}
+/**
+ * 工具结果元数据
+ */
+interface ToolResultMetadata {
+    /** 是否被截断 */
+    truncated?: boolean;
+    /** 原始内容长度 */
+    originalLength?: number;
+    /** 原始行数 */
+    originalLineCount?: number;
+    /** 显示的行数 */
+    displayedLineCount?: number;
+    /** 完整内容保存路径 */
+    storagePath?: string;
+    /** 行数统计 */
+    lineCount?: number;
+    /** 其他自定义字段 */
+    [key: string]: unknown;
+}
+/**
+ * 工具结果
+ */
+interface ToolResult {
+    content: string;
+    isError?: boolean;
+    metadata?: ToolResultMetadata;
+}
+/**
+ * Tool 执行上下文
+ */
+interface ToolExecutionContext {
+    /** 工具调用 ID */
+    toolCallId?: string;
+    /** Agent 配置的工作目录 */
+    projectDir?: string;
+    /** 当前 agent 深度（根 agent 为 0） */
+    agentDepth?: number;
+}
+/**
+ * 工具处理函数
+ */
+type ToolHandler = (args: any, context?: ToolExecutionContext) => Promise<ToolResult>;
+/**
+ * 工具定义
+ */
+interface ToolDefinition {
+    /** 工具名称 */
+    name: string;
+    /** 工具描述 */
+    description: string;
+    /** 参数 Schema (Zod) */
+    parameters: z.ZodSchema;
+    /** 处理函数 */
+    handler: ToolHandler;
+    /** 是否危险操作 */
+    isDangerous?: boolean;
+    /** 工具分类 (e.g., "filesystem", "shell", "web", "planning") */
+    category?: string;
+}
+/**
+ * 工具 Schema (用于模型调用)
+ */
+interface ToolSchema {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/**
+ * 会话信息
+ */
+interface SessionInfo {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    messageCount: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 存储配置
+ */
+interface StorageConfig {
+    type: 'jsonl' | 'memory';
+}
+/**
+ * 存储适配器接口
+ */
+interface StorageAdapter {
+    /** 保存消息 */
+    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>;
+}
+/**
+ * 流式事件类型
+ */
+type StreamEventType = 'text_delta' | 'text_start' | 'text_end' | 'tool_call' | 'tool_call_start' | 'tool_call_delta' | 'tool_call_end' | 'tool_result' | 'tool_error' | 'thinking' | 'start' | 'end' | 'model_usage' | 'session_summary' | 'context_compressed';
+/**
+ * Optional fields on any stream event (observability, Claude-style correlation).
+ */
+interface StreamEventAnnotations {
+    streamEventId?: string;
+    /** Agent model-call iteration (0-based) when produced by {@link Agent.stream} */
+    iteration?: number;
+    /**
+     * Current session id when {@link Agent.stream} annotates events (including `session_summary`).
+     * Not duplicated on the `session_summary` variant payload; use this field for correlation.
+     */
+    sessionId?: string;
+}
+/**
+ * 流式事件
+ */
+type StreamEvent = ({
+    type: 'start';
+    timestamp: number;
+} | {
+    type: 'text_start';
+    content?: string;
+} | {
+    type: 'text_delta';
+    content: string;
+} | {
+    type: 'text_end';
+    content?: string;
+} | {
+    type: 'tool_call_start';
+    id: string;
+    name: string;
+} | {
+    type: 'tool_call_delta';
+    id: string;
+    arguments: string;
+} | {
+    type: 'tool_call';
+    id: string;
+    name: string;
+    arguments: unknown;
+} | {
+    type: 'tool_call_end';
+    id: string;
+} | {
+    type: 'tool_result';
+    toolCallId: string;
+    result: string;
+} | {
+    type: 'tool_error';
+    toolCallId: string;
+    error: Error;
+} | {
+    type: 'thinking';
+    content: string;
+    signature?: string;
+} | {
+    type: 'model_usage';
+    usage: TokenUsage;
+    /** Present when the provider distinguishes prompt vs completion usage timing (e.g. Anthropic). */
+    phase?: 'input' | 'output';
+} | {
+    type: 'session_summary';
+    /** Authoritative cumulative usage for the completed run (prefer over end.usage when both exist). */
+    usage: TokenUsage;
+    iterations: number;
+} | {
+    type: 'end';
+    timestamp: number;
+    /**
+     * Optional usage (e.g. aborted mid-stream). When a session_summary event was emitted, use its usage for totals.
+     */
+    usage?: TokenUsage;
+    /** Omitted or `complete` = normal completion */
+    reason?: 'complete' | 'aborted' | 'error';
+    error?: Error;
+    partialContent?: string;
+} | {
+    type: 'context_compressed';
+    stats: {
+        originalMessageCount: number;
+        compressedMessageCount: number;
+        durationMs: number;
+    };
+}) & StreamEventAnnotations;
+/**
+ * MCP 服务器配置
+ */
+interface MCPServerConfig {
+    /** 服务器名称 */
+    name: string;
+    /** 传输类型 */
+    transport: 'stdio' | 'http';
+    /** stdio 配置 */
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    /** HTTP 配置 */
+    url?: string;
+    headers?: Record<string, string>;
+}
+/**
+ * MCP 资源内容
+ */
+interface MCPResourceContent {
+    uri: string;
+    mimeType?: string;
+    text?: string;
+    blob?: string;
+}
+/**
+ * MCP Prompt 参数
+ */
+interface MCPPromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+/**
+ * Skill 元数据
+ */
+interface SkillMetadata {
+    /** Skill 名称 */
+    name: string;
+    /** 描述 */
+    description: string;
+    /** 版本 */
+    version?: string;
+    /** 作者 */
+    author?: string;
+    /** 依赖的 Skills */
+    dependencies?: string[];
+    /** 标签 */
+    tags?: string[];
+    /** 参数提示，显示在自动补全中，如 "[filename]" */
+    argumentHint?: string;
+    /** 禁止模型自动调用此 skill，只能通过 /skill-name 手动调用 */
+    disableModelInvocation?: boolean;
+    /** 是否在 / 菜单中显示，默认 true */
+    userInvocable?: boolean;
+}
+/**
+ * Skill 定义
+ * Skill 只是一个指导书，不提供工具
+ */
+interface SkillDefinition {
+    /** 元数据 */
+    metadata: SkillMetadata;
+    /** 文件路径 */
+    path: string;
+    /** 指令内容 */
+    instructions: string;
+}
+/**
+ * Skill 解析结果
+ */
+interface ParsedSkill {
+    metadata: SkillMetadata;
+    content: string;
+}
+/**
+ * 系统提示配置
+ */
+interface SystemPromptConfig {
+    /** 提示内容 */
+    content: string;
+    /** 模式: 'replace' 替换默认提示词, 'append' 追加到默认提示词 */
+    mode?: 'replace' | 'append';
+    /** 是否包含环境信息，默认 true */
+    includeEnvironment?: boolean;
+}
+/**
+ * 系统提示类型 - 支持字符串或配置对象
+ */
+type SystemPrompt = string | SystemPromptConfig;
+/**
+ * 上下文管理配置
+ */
+interface ContextManagerConfig {
+    /** 上下文窗口大小 (从模型 capabilities 自动获取) */
+    contextLength?: number;
+    /** 最大输出 token 数 (从模型 capabilities 自动获取) */
+    maxOutputTokens?: number;
+    /** 压缩预留空间 (tokens), 默认 min(20000, maxOutputTokens) */
+    reserved?: number;
+    /** 自定义压缩器 */
+    compressor?: Compressor;
+    /** 是否启用 prune (清理旧工具输出), 默认 true */
+    prune?: boolean;
+    /** prune 触发阈值 (tokens), 默认 20000 */
+    pruneMinimum?: number;
+    /** prune 保护范围 (最近 N tokens 的工具输出不清理), 默认 40000 */
+    pruneProtect?: number;
+}
+/**
+ * 非自动批准的工具在调用前回调；返回 true 表示允许执行（与 Claude Agent SDK 的 canUseTool 概念对齐）。
+ */
+type CanUseToolCallback = (toolName: string, input: Record<string, unknown>) => boolean | Promise<boolean>;
+/**
+ * {@link ToolRegistry} 可选执行策略（与 {@link AgentConfig} 中 allowedTools / disallowedTools / canUseTool 对应）。
+ */
+interface ToolExecutionPolicy {
+    disallowedTools?: string[];
+    /**
+     * 与 {@link AgentConfig.allowedTools} 相同。若设为**空数组** `[]`，则没有任何工具自动批准，每次执行均需 {@link canUseTool} 放行（未配置则拒绝）。
+     */
+    allowedTools?: string[];
+    canUseTool?: CanUseToolCallback;
+}
+/**
+ * Agent 配置
+ */
+interface AgentConfig {
+    /** 模型适配器 */
+    model: ModelAdapter;
+    /** 系统提示 (字符串或配置对象) */
+    systemPrompt?: SystemPrompt;
+    /**
+     * 追加到默认内置工具（及 MCP）之后的自定义工具；同名会覆盖内置定义。
+     * 与 {@link exclusiveTools} 互斥：若设置了 `exclusiveTools`，则忽略本字段。
+     */
+    tools?: ToolDefinition[];
+    /**
+     * 自动批准的工具名列表（与注册名一致）。命中的调用直接执行，无需 {@link canUseTool}。
+     * 未列出的工具仍可对模型可见；其调用需经 `canUseTool`（若配置），否则拒绝。
+     * **未设置**时保持兼容：所有非 {@link disallowedTools} 工具均视为自动批准。
+     * **空数组** `[]` 表示无任何自动批准：所有工具调用均需 `canUseTool` 放行，未配置 `canUseTool` 则全部拒绝。
+     */
+    allowedTools?: string[];
+    /**
+     * 禁止的工具名：不注册、不纳入模型工具列表、不可执行（内置 / MCP / 自定义均按注册名生效）。
+     */
+    disallowedTools?: string[];
+    /**
+     * 当工具不在 {@link allowedTools} 中（且 `allowedTools` 已配置）时调用；返回 true 则执行。
+     */
+    canUseTool?: CanUseToolCallback;
+    /**
+     * 仅注册此处列出的工具（用于子 Agent 等排他场景），不合并默认内置，不追加 {@link tools}。
+     * 仍应用 {@link disallowedTools} 过滤。
+     */
+    exclusiveTools?: ToolDefinition[];
+    /**
+     * AskUserQuestion 交互解析（CLI / Web 等实现）。未设置时该工具仅返回题面、不阻塞。
+     */
+    askUserQuestion?: AskUserQuestionResolver;
+    /** Skill 路径列表 */
+    skills?: string[];
+    /** MCP 服务器配置 */
+    mcpServers?: MCPServerConfig[];
+    /** 用户级基础路径，默认 ~ (homedir)，用于定位 .claude/ 目录 */
+    userBasePath?: string;
+    /** 存储配置 */
+    storage?: StorageConfig;
+    /** 最大迭代次数 */
+    maxIterations?: number;
+    /** 温度 */
+    temperature?: number;
+    /** 最大 Token 数 */
+    maxTokens?: number;
+    /** 是否启用流式 */
+    streaming?: boolean;
+    /** 会话 ID (用于恢复会话) */
+    sessionId?: string;
+    /** 回调函数 */
+    callbacks?: AgentCallbacks;
+    /** 是否启用长期记忆 */
+    memory?: boolean;
+    /** 记忆配置 */
+    memoryConfig?: MemoryConfig;
+    /** Skill 加载配置 */
+    skillConfig?: SkillConfig;
+    /** 上下文管理配置 */
+    contextManagement?: boolean | ContextManagerConfig;
+    /** 工作目录，默认 process.cwd() */
+    cwd?: string;
+    /** 是否注入环境信息到 system prompt，默认 true */
+    includeEnvironment?: boolean;
+    /** 工具 Hook 管理器（与配置文件合并规则见文档） */
+    hookManager?: HookManager;
+    /**
+     * 解析项目级 `.claude/settings.json` 的目录；设置后将在 Agent 初始化时加载 Hook 配置
+     */
+    hookConfigDir?: string;
+    /** Subagent 工具行为配置 */
+    subagent?: {
+        /** 是否启用 Agent 工具，默认 true */
+        enabled?: boolean;
+        /** 子代理最大深度，默认 1（禁止嵌套） */
+        maxDepth?: number;
+        /** 并发子代理上限，默认 5 */
+        maxParallel?: number;
+        /** 子代理默认超时（毫秒），默认 120000 */
+        timeoutMs?: number;
+        /** 是否允许子代理使用危险工具，默认 false */
+        allowDangerousTools?: boolean;
+        /** 子代理默认允许工具列表（为空时自动使用安全工具） */
+        defaultAllowedTools?: string[];
+    };
+}
+/**
+ * 记忆配置选项
+ */
+interface MemoryConfig {
+    /** 工作空间记忆文件路径 */
+    workspacePath?: string;
+}
+/**
+ * Skill 加载配置选项
+ */
+interface SkillConfig {
+    /** 是否启用默认路径加载，默认 true */
+    autoLoad?: boolean;
+    /** 工作空间 skills 路径，默认 ./.claude/skills/ */
+    workspacePath?: string;
+    /** 额外的 skills 路径列表 */
+    additionalPaths?: string[];
+}
+/**
+ * Agent 回调
+ */
+interface AgentCallbacks {
+    /** 流式事件回调 */
+    onEvent?: (event: StreamEvent) => void;
+    /** 工具执行前回调 */
+    beforeToolCall?: (toolCall: ToolCall) => Promise<boolean | void>;
+    /** 工具执行后回调 */
+    afterToolCall?: (toolCall: ToolCall, result: ToolResult) => void;
+    /** 错误回调 */
+    onError?: (error: Error) => void;
+}
+/**
+ * Agent 执行结果
+ */
+interface AgentResult {
+    /** 最终内容 */
+    content: string;
+    /** 工具调用历史 */
+    toolCalls?: Array<{
+        name: string;
+        arguments: unknown;
+        result: string;
+    }>;
+    /** Token 使用 */
+    usage?: TokenUsage;
+    /** 会话 ID */
+    sessionId: string;
+    /** 迭代次数 */
+    iterations: number;
+}
+/**
+ * CLI 配置
+ */
+interface CLIConfig {
+    /** 模型 */
+    model?: string;
+    /** API Key */
+    apiKey?: string;
+    /** 基础 URL */
+    baseUrl?: string;
+    /** 模型名称 */
+    modelName?: string;
+    /** 温度 */
+    temperature?: number;
+    /** 最大 Token */
+    maxTokens?: number;
+    /** 输出格式 */
+    output?: 'text' | 'json' | 'markdown';
+    /** 是否流式 */
+    stream?: boolean;
+    /** 会话 ID */
+    session?: string;
+    /** 恢复最近一次会话（CLI chat/run） */
+    resume?: boolean;
+    /** 详细输出 */
+    verbose?: boolean;
+    /** MCP 配置文件路径 */
+    mcpConfig?: string;
+    /** 用户级基础路径，默认 ~ (homedir) */
+    userBasePath?: string;
+    /** 工作目录 */
+    cwd?: string;
+    /**
+     * Ollama `/api/chat` `think` option (boolean or GPT-OSS level).
+     * Used only when `-m`/`--model` is `ollama`.
+     */
+    ollamaThink?: boolean | 'low' | 'medium' | 'high';
+}
+/**
+ * CLI 命令选项
+ */
+interface ChatOptions extends CLIConfig {
+    systemPrompt?: string;
+    tools?: string[];
+}
+interface RunOptions extends CLIConfig {
+    file?: string;
+    files?: string[];
+}
+interface ToolListOptions {
+    format?: 'table' | 'json';
+}
+interface SessionListOptions {
+    format?: 'table' | 'json';
+    limit?: number;
+}
+interface MCPOptions {
+    name?: string;
+}
+interface SkillOptions {
+    path?: string;
+}
+
+export { type StreamEventAnnotations as $, type AgentConfig as A, HookManager as B, type CLIConfig as C, type HookResult as D, type HooksSettings as E, type FlatCommandHookEntry as F, type HooksSettingsFile as G, type HookContext as H, type ImageContent as I, type MCPOptions as J, type MCPPromptArgument as K, type MCPResourceContent as L, type Message as M, type MessageRole as N, type ModelAdapter as O, type ParsedSkill as P, type ModelCapabilities as Q, type ModelParams as R, type StorageConfig as S, type ToolResult as T, type RunOptions as U, type SessionListOptions as V, type SkillConfig as W, type SkillDefinition as X, type SkillMetadata as Y, type SkillOptions as Z, type StreamChunkType as _, type SessionInfo as a, type StreamEventType as a0, type SystemMessage as a1, type SystemPromptConfig as a2, type TextContent as a3, type ThinkingContent as a4, type ToolCall as a5, type ToolExecutionContext as a6, type ToolExecutionPolicy as a7, type ToolHandler as a8, type ToolListOptions as a9, type ToolMessage as aa, type ToolResultMetadata as ab, type ToolSchema as ac, type UserMessage as ad, buildHookEnv as ae, createAskUserQuestionTool as af, createFunctionHook as ag, formatAnswerSummary as ah, formatAskUserQuestionPrompt as ai, getInteractionTools as aj, matchTool as ak, mergeCommandHookLayers as al, questionTool as am, type StorageAdapter as b, type ToolDefinition as c, type SystemPrompt as d, type StreamEvent as e, type AgentResult as f, type MCPServerConfig as g, type SessionTokenUsage as h, type TokenUsage as i, type StreamChunk as j, type MemoryConfig as k, type AgentCallbacks as l, type AskUserQuestionAnswer as m, type AskUserQuestionItem as n, type AskUserQuestionResolver as o, type AssistantMessage as p, type CanUseToolCallback as q, type ChatOptions as r, type CommandHookConfig as s, type CompletionResult as t, type ContentPart as u, type ContextManagerConfig as v, type CreateAskUserQuestionToolOptions as w, type FunctionHook as x, type HookEventType as y, type HookGroupConfig as z };