@ddlqhd/agent-sdk 0.1.0

package/dist/index-RTPmFjMp.d.cts

@@ -0,0 +1,447 @@
+import { z } from 'zod';
+import { a7 as ToolExecutionPolicy, B as HookManager, c as ToolDefinition, T as ToolResult, ac as ToolSchema, X as SkillDefinition, W as SkillConfig, E as HooksSettings, a6 as ToolExecutionContext, w as CreateAskUserQuestionToolOptions } from './types-C0aX_Qdp.cjs';
+
+/**
+ * Tool 注册中心配置
+ */
+interface ToolRegistryConfig {
+    /** 用户基础路径，用于存储超长输出 */
+    userBasePath?: string;
+    /** 是否启用输出处理（默认 true） */
+    enableOutputHandler?: boolean;
+    /** 执行前校验（disallowed / allowedTools / canUseTool）；未设置则不限制 */
+    executionPolicy?: ToolExecutionPolicy;
+}
+/** 工具执行选项（Hook 上下文等） */
+interface ToolExecuteOptions {
+    toolCallId?: string;
+    projectDir?: string;
+    agentDepth?: number;
+}
+/**
+ * Tool 注册中心
+ */
+declare class ToolRegistry {
+    private tools;
+    private categories;
+    private outputHandler;
+    private hookManager;
+    private readonly executionPolicy;
+    constructor(config?: ToolRegistryConfig);
+    /**
+     * 工具名是否在 {@link ToolExecutionPolicy.disallowedTools} 中（无策略时为 false）。
+     */
+    isDisallowed(name: string): boolean;
+    /**
+     * `allowedTools` 未设置时视为全部自动批准；已设置时仅列表内自动批准。
+     */
+    private isAutoApproved;
+    private checkExecutionPolicy;
+    setHookManager(manager: HookManager | null): void;
+    getHookManager(): HookManager | null;
+    private buildHookContext;
+    /**
+     * 注册工具
+     */
+    register(tool: ToolDefinition): void;
+    /**
+     * 注册多个工具
+     */
+    registerMany(tools: ToolDefinition[]): void;
+    /**
+     * 注销工具
+     */
+    unregister(name: string): boolean;
+    /**
+     * 获取工具定义
+     */
+    get(name: string): ToolDefinition | undefined;
+    /**
+     * 获取所有工具定义
+     */
+    getAll(): ToolDefinition[];
+    /**
+     * 获取工具名称列表
+     */
+    getNames(): string[];
+    /**
+     * 检查工具是否存在
+     */
+    has(name: string): boolean;
+    /**
+     * 获取工具数量
+     */
+    get size(): number;
+    /**
+     * 执行工具
+     */
+    execute(name: string, args: unknown, options?: ToolExecuteOptions): Promise<ToolResult>;
+    /**
+     * 获取工具 Schema (用于模型调用)
+     */
+    toSchema(): ToolSchema[];
+    /**
+     * 清空所有工具
+     */
+    clear(): void;
+    /**
+     * 按类别注册工具
+     */
+    registerWithCategory(category: string, tool: ToolDefinition): void;
+    /**
+     * 获取类别下的工具
+     */
+    getByCategory(category: string): ToolDefinition[];
+    /**
+     * 获取所有类别
+     */
+    getCategories(): string[];
+    /**
+     * 过滤工具
+     */
+    filter(predicate: (tool: ToolDefinition) => boolean): ToolDefinition[];
+    /**
+     * 搜索工具
+     */
+    search(query: string): ToolDefinition[];
+    /**
+     * 导出工具配置
+     */
+    export(): Array<{
+        name: string;
+        description: string;
+        parameters: unknown;
+    }>;
+}
+/**
+ * 创建工具定义
+ */
+declare function createTool(config: {
+    name: string;
+    description: string;
+    parameters: z.ZodSchema;
+    handler: ToolDefinition['handler'];
+    isDangerous?: boolean;
+    category?: string;
+}): ToolDefinition;
+declare function getGlobalRegistry(): ToolRegistry;
+
+/**
+ * Skill 加载器配置
+ */
+interface SkillLoaderConfig {
+    /** 工作目录 */
+    cwd?: string;
+    /** 用户级基础路径 */
+    userBasePath?: string;
+    /** 文件过滤 */
+    filter?: (path: string) => boolean;
+}
+/**
+ * Skill 加载器
+ * Skill 只是一个指导书，不加载工具脚本
+ */
+declare class SkillLoader {
+    private config;
+    constructor(config?: SkillLoaderConfig);
+    /**
+     * 加载单个 Skill
+     */
+    load(skillPath: string): Promise<SkillDefinition>;
+    /**
+     * 从文件加载 Skill
+     */
+    private loadFromFile;
+    /**
+     * 从目录加载 Skill
+     */
+    private loadFromDirectory;
+    /**
+     * 加载目录下的所有 Skills
+     */
+    loadAll(dirPath: string): Promise<SkillDefinition[]>;
+    /**
+     * 检查文件是否存在
+     */
+    private hasFile;
+    /**
+     * 获取路径类型
+     */
+    private getPathType;
+}
+/**
+ * 创建 Skill 加载器
+ */
+declare function createSkillLoader(config?: SkillLoaderConfig): SkillLoader;
+
+/**
+ * Skill 注册中心
+ * Skill 只是一个指导书，不提供工具
+ */
+declare class SkillRegistry {
+    private skills;
+    private loader;
+    private workspaceRoot;
+    private userBasePath;
+    private skillConfig?;
+    constructor(config?: SkillLoaderConfig & {
+        userBasePath?: string;
+    });
+    /**
+     * 注册 Skill
+     */
+    register(skill: SkillDefinition): void;
+    /**
+     * 加载并注册 Skill
+     */
+    load(path: string): Promise<void>;
+    /**
+     * 加载目录下的所有 Skills
+     */
+    loadAll(dirPath: string): Promise<void>;
+    /**
+     * 注销 Skill
+     */
+    unregister(name: string): boolean;
+    /**
+     * 获取 Skill
+     */
+    get(name: string): SkillDefinition | undefined;
+    /**
+     * 获取所有 Skill
+     */
+    getAll(): SkillDefinition[];
+    /**
+     * 获取 Skill 名称列表
+     */
+    getNames(): string[];
+    /**
+     * 检查 Skill 是否存在
+     */
+    has(name: string): boolean;
+    /**
+     * 搜索 Skill
+     */
+    search(query: string): SkillDefinition[];
+    /**
+     * 按标签过滤
+     */
+    filterByTag(tag: string): SkillDefinition[];
+    /**
+     * 获取 Skill 数量
+     */
+    get size(): number;
+    /**
+     * 清空所有 Skill
+     */
+    clear(): void;
+    /**
+     * 导出 Skill 信息
+     */
+    export(): Array<{
+        name: string;
+        description: string;
+        version?: string;
+        path: string;
+    }>;
+    /**
+     * 获取所有 Skill 的元数据列表（用于 System Prompt）
+     */
+    getMetadataList(): Array<{
+        name: string;
+        description: string;
+        argumentHint?: string;
+    }>;
+    /**
+     * 获取用户可调用的 Skills
+     */
+    getUserInvocableSkills(): Array<{
+        name: string;
+        description: string;
+        argumentHint?: string;
+    }>;
+    /**
+     * 获取模型可自动调用的 Skills（用于注入到 system prompt）
+     */
+    getModelInvocableSkills(): Array<{
+        name: string;
+        description: string;
+    }>;
+    /**
+     * 获取格式化的 Skill 列表文本（用于 System Prompt）
+     */
+    getFormattedList(): string;
+    /**
+     * 根据名称获取 Skill 路径
+     */
+    getSkillPath(name: string): string | undefined;
+    /**
+     * 加载 Skill 全量内容
+     */
+    loadFullContent(name: string): Promise<string>;
+    /**
+     * 获取默认 skill 路径
+     */
+    private getDefaultPaths;
+    /**
+     * 初始化加载所有 Skills
+     * @param config Skill 配置
+     * @param additionalPaths 额外的 skill 路径（来自 AgentConfig.skills）
+     */
+    initialize(config?: SkillConfig, additionalPaths?: string[]): Promise<void>;
+}
+/**
+ * 创建 Skill 注册中心
+ */
+declare function createSkillRegistry(config?: SkillLoaderConfig): SkillRegistry;
+
+/**
+ * 将磁盘 settings.json 转为内部 HooksSettings（PascalCase → HookEventType）
+ */
+declare function parseHooksSettingsFile(raw: unknown): HooksSettings;
+/**
+ * 读取并解析项目级 `.claude/settings.json`
+ */
+declare function loadHooksSettingsFromProject(projectDir: string): Promise<HooksSettings>;
+/**
+ * 读取并解析用户级 `~/.claude/settings.json`
+ */
+declare function loadHooksSettingsFromUser(): Promise<HooksSettings>;
+
+/**
+ * Read 工具 - 读取文件内容
+ */
+declare const readFileTool: ToolDefinition;
+/**
+ * Write 工具 - 写入文件
+ */
+declare const writeFileTool: ToolDefinition;
+/**
+ * Edit 工具 - 精确编辑文件
+ */
+declare const editTool: ToolDefinition;
+/**
+ * Glob 工具 - 文件模式匹配
+ */
+declare const globTool: ToolDefinition;
+/**
+ * 获取所有文件系统工具
+ */
+declare function getFileSystemTools(): ToolDefinition[];
+
+/**
+ * Bash 工具 - 执行 shell 命令
+ */
+declare const bashTool: ToolDefinition;
+/**
+ * 获取所有 Shell 工具
+ */
+declare function getShellTools(): ToolDefinition[];
+
+/** Default cap on number of matching lines returned (each line counts as one match). */
+declare const DEFAULT_GREP_HEAD_LIMIT = 250;
+/** Max characters for a single match line in output (match-aware window, see {@link truncateMatchLineForDisplay}). */
+declare const MAX_LINE_LENGTH = 2000;
+/**
+ * Shorten a long line for Grep output while keeping the first regex match visible (not a fixed [0, MAX) slice).
+ * Context lines (when using `context` > 0) are not passed through this function.
+ */
+declare function truncateMatchLineForDisplay(line: string, regex: RegExp): string;
+declare const grepTool: ToolDefinition;
+/**
+ * 获取 Grep 工具
+ */
+declare function getGrepTools(): ToolDefinition[];
+
+/**
+ * WebFetch 工具 - 获取网页内容
+ */
+declare const webFetchTool: ToolDefinition;
+/**
+ * WebSearch 工具 - 网络搜索
+ */
+declare const webSearchTool: ToolDefinition;
+/**
+ * 获取所有 Web 工具
+ */
+declare function getWebTools(): ToolDefinition[];
+
+/**
+ * TaskCreate 工具 - 创建任务
+ */
+declare const taskCreateTool: ToolDefinition;
+/**
+ * TaskUpdate 工具 - 更新任务
+ */
+declare const taskUpdateTool: ToolDefinition;
+/**
+ * TaskList 工具 - 列出所有任务
+ */
+declare const taskListTool: ToolDefinition;
+/**
+ * 获取所有 Task 工具
+ */
+declare function getTaskTools(): ToolDefinition[];
+
+/**
+ * 创建 Skill 工具
+ */
+declare function createSkillTool(skillRegistry: SkillRegistry): ToolDefinition;
+/**
+ * 获取 Skill 相关工具
+ */
+declare function getSkillTools(skillRegistry: SkillRegistry): ToolDefinition[];
+
+declare const subagentRequestSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    subagent_type: z.ZodDefault<z.ZodEnum<["general-purpose", "explore"]>>;
+    allowed_tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    max_iterations: z.ZodOptional<z.ZodNumber>;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+    system_prompt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    subagent_type: "general-purpose" | "explore";
+    description?: string | undefined;
+    allowed_tools?: string[] | undefined;
+    max_iterations?: number | undefined;
+    timeout_ms?: number | undefined;
+    system_prompt?: string | undefined;
+}, {
+    prompt: string;
+    description?: string | undefined;
+    subagent_type?: "general-purpose" | "explore" | undefined;
+    allowed_tools?: string[] | undefined;
+    max_iterations?: number | undefined;
+    timeout_ms?: number | undefined;
+    system_prompt?: string | undefined;
+}>;
+type SubagentRequest = z.infer<typeof subagentRequestSchema>;
+interface SubagentRunner {
+    (request: SubagentRequest, context?: ToolExecutionContext): Promise<ToolResult>;
+}
+interface CreateAgentToolOptions {
+    runner: SubagentRunner;
+}
+/**
+ * Agent tool - delegates a task to a dedicated subagent run.
+ */
+declare function createAgentTool(options: CreateAgentToolOptions): ToolDefinition;
+declare const agentTool: ToolDefinition;
+declare function getSubagentTools(): ToolDefinition[];
+
+/**
+ * 获取所有内置工具
+ * @param skillRegistry - Skill注册中心，用于激活skill工具
+ * @param interactionOptions - 可选：AskUserQuestion 的 {@link CreateAskUserQuestionToolOptions}
+ */
+declare function getAllBuiltinTools(skillRegistry: SkillRegistry, interactionOptions?: CreateAskUserQuestionToolOptions): ToolDefinition[];
+/**
+ * 获取安全的内置工具 (不含危险操作)
+ * @param skillRegistry - Skill注册中心，用于激活skill工具
+ * @param interactionOptions - 可选：AskUserQuestion 的 {@link CreateAskUserQuestionToolOptions}
+ */
+declare function getSafeBuiltinTools(skillRegistry: SkillRegistry, interactionOptions?: CreateAskUserQuestionToolOptions): ToolDefinition[];
+
+export { loadHooksSettingsFromProject as A, loadHooksSettingsFromUser as B, type CreateAgentToolOptions as C, DEFAULT_GREP_HEAD_LIMIT as D, parseHooksSettingsFile as E, readFileTool as F, subagentRequestSchema as G, taskCreateTool as H, taskListTool as I, taskUpdateTool as J, truncateMatchLineForDisplay as K, webFetchTool as L, MAX_LINE_LENGTH as M, webSearchTool as N, writeFileTool as O, SkillRegistry as S, ToolRegistry as T, SkillLoader as a, type SkillLoaderConfig as b, type SubagentRequest as c, type SubagentRunner as d, type ToolExecuteOptions as e, type ToolRegistryConfig as f, agentTool as g, bashTool as h, createAgentTool as i, createSkillLoader as j, createSkillRegistry as k, createSkillTool as l, createTool as m, editTool as n, getAllBuiltinTools as o, getFileSystemTools as p, getGlobalRegistry as q, getGrepTools as r, getSafeBuiltinTools as s, getShellTools as t, getSkillTools as u, getSubagentTools as v, getTaskTools as w, getWebTools as x, globTool as y, grepTool as z };