tianxincode 1.0.0

package/dist/modules/skill/skills.manager.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Skill Manager
+ * 按照 skill-guide.md 规范实现
+ */
+import { Skill, AvailableSkill } from './skill.types.js';
+export declare class SkillsManager {
+    private skills;
+    private searchPaths;
+    private permissions;
+    private gitRoot;
+    constructor(cwd?: string);
+    private initSearchPaths;
+    private findGitRoot;
+    setPermissions(permissions: Record<string, 'allow' | 'deny' | 'ask'>): void;
+    loadAll(): Promise<void>;
+    private loadDir;
+    loadSkill(filePath: string): Promise<Skill | null>;
+    private parseSkill;
+    private validateName;
+    private checkPermission;
+    private matchPattern;
+    getSkill(name: string): Skill | undefined;
+    getAllSkills(): Skill[];
+    getAvailableSkills(): AvailableSkill[];
+    has(name: string): boolean;
+    getSearchPaths(): string[];
+    getGitRoot(): string | null;
+}
+export declare const skillsManager: SkillsManager;
+//# sourceMappingURL=skills.manager.d.ts.map

package/dist/modules/skill/skills.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.manager.d.ts","sourceRoot":"","sources":["../../../src/modules/skill/skills.manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,KAAK,EAAkC,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEzF,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,OAAO,CAAuB;gBAE1B,GAAG,CAAC,EAAE,MAAM;IAIxB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,WAAW;IAcnB,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,GAAG,IAAI;IAOrE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAQhB,OAAO;IAkBf,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IA+BxD,OAAO,CAAC,UAAU;IAyClB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,YAAY;IAMpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIzC,YAAY,IAAI,KAAK,EAAE;IAIvB,kBAAkB,IAAI,cAAc,EAAE;IAStC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,cAAc,IAAI,MAAM,EAAE;IAI1B,UAAU,IAAI,MAAM,GAAG,IAAI;CAG5B;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/modules/skill/skills.manager.js

@@ -0,0 +1,182 @@
+/**
+ * Skill Manager
+ * 按照 skill-guide.md 规范实现
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'js-yaml';
+export class SkillsManager {
+    constructor(cwd) {
+        this.skills = new Map();
+        this.searchPaths = [];
+        this.permissions = [];
+        this.gitRoot = null;
+        this.initSearchPaths(cwd || process.cwd());
+    }
+    initSearchPaths(cwd) {
+        const home = process.env.HOME || process.env.USERPROFILE || '';
+        this.gitRoot = this.findGitRoot(cwd);
+        const basePath = this.gitRoot || cwd;
+        this.searchPaths = [
+            path.join(basePath, '.txcode', 'skills'),
+            path.join(basePath, '.claude', 'skills'),
+            path.join(basePath, '.agents', 'skills'),
+            path.join(home, '.txcode', 'skills'),
+            path.join(home, '.claude', 'skills'),
+            path.join(home, '.agents', 'skills'),
+        ];
+    }
+    findGitRoot(startPath) {
+        let currentPath = startPath;
+        while (currentPath !== path.dirname(currentPath)) {
+            const gitPath = path.join(currentPath, '.git');
+            if (fs.existsSync(gitPath)) {
+                return currentPath;
+            }
+            currentPath = path.dirname(currentPath);
+        }
+        return null;
+    }
+    setPermissions(permissions) {
+        this.permissions = Object.entries(permissions).map(([pattern, action]) => ({
+            pattern,
+            action,
+        }));
+    }
+    async loadAll() {
+        this.skills.clear();
+        for (const searchPath of this.searchPaths) {
+            await this.loadDir(searchPath);
+        }
+    }
+    async loadDir(dir) {
+        if (!fs.existsSync(dir))
+            return;
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const skillPath = path.join(dir, entry.name, 'SKILL.md');
+                    if (fs.existsSync(skillPath)) {
+                        await this.loadSkill(skillPath);
+                    }
+                }
+            }
+        }
+        catch {
+            // 忽略无权访问的目录
+        }
+    }
+    async loadSkill(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const skill = this.parseSkill(content, filePath);
+            if (skill) {
+                if (!this.validateName(skill.name)) {
+                    console.warn(`Invalid skill name: ${skill.name} in ${filePath}`);
+                    return null;
+                }
+                const dirName = path.basename(path.dirname(filePath));
+                if (skill.name !== dirName) {
+                    console.warn(`Skill name "${skill.name}" does not match directory name "${dirName}"`);
+                    return null;
+                }
+                const permission = this.checkPermission(skill.name);
+                if (permission === 'deny') {
+                    return null;
+                }
+                this.skills.set(skill.name, skill);
+            }
+            return skill;
+        }
+        catch (e) {
+            console.warn(`Failed to load skill from ${filePath}:`, e);
+            return null;
+        }
+    }
+    parseSkill(content, filePath) {
+        const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+        if (!frontmatterMatch) {
+            const dirName = path.basename(path.dirname(filePath));
+            return {
+                name: dirName,
+                description: content.substring(0, 1024),
+                content: content,
+                rawContent: content,
+                filePath,
+            };
+        }
+        const frontmatterStr = frontmatterMatch[1];
+        const rawContent = frontmatterMatch[2].trim();
+        try {
+            const metadata = yaml.load(frontmatterStr);
+            if (!metadata.name) {
+                console.warn(`Skill missing name in ${filePath}`);
+                return null;
+            }
+            return {
+                name: metadata.name,
+                description: metadata.description || '',
+                license: metadata.license,
+                compatibility: metadata.compatibility,
+                metadata: metadata.metadata,
+                content: content,
+                rawContent: rawContent,
+                filePath,
+            };
+        }
+        catch (e) {
+            console.warn(`Failed to parse frontmatter in ${filePath}:`, e);
+            return null;
+        }
+    }
+    validateName(name) {
+        if (!name || name.length > 64)
+            return false;
+        if (name.startsWith('-') || name.endsWith('-'))
+            return false;
+        if (name.includes('--'))
+            return false;
+        const regex = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+        return regex.test(name);
+    }
+    checkPermission(name) {
+        for (const perm of this.permissions) {
+            if (this.matchPattern(name, perm.pattern)) {
+                return perm.action;
+            }
+        }
+        return 'allow';
+    }
+    matchPattern(name, pattern) {
+        if (pattern === '*')
+            return true;
+        const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+        return regex.test(name);
+    }
+    getSkill(name) {
+        return this.skills.get(name);
+    }
+    getAllSkills() {
+        return Array.from(this.skills.values());
+    }
+    getAvailableSkills() {
+        return this.getAllSkills()
+            .filter(skill => this.checkPermission(skill.name) !== 'deny')
+            .map(s => ({
+            name: s.name,
+            description: s.description,
+        }));
+    }
+    has(name) {
+        return this.skills.has(name);
+    }
+    getSearchPaths() {
+        return [...this.searchPaths];
+    }
+    getGitRoot() {
+        return this.gitRoot;
+    }
+}
+export const skillsManager = new SkillsManager();
+//# sourceMappingURL=skills.manager.js.map

package/dist/modules/skill/skills.manager.js.map

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

package/dist/modules/tools/builtin/bash.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '../tool.types.js';
+export declare const bashTool: Tool;
+//# sourceMappingURL=bash.d.ts.map

package/dist/modules/tools/builtin/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/builtin/bash.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAA2B,MAAM,kBAAkB,CAAA;AAyBhE,eAAO,MAAM,QAAQ,EAAE,IA4GtB,CAAA"}

package/dist/modules/tools/builtin/bash.js

@@ -0,0 +1,124 @@
+import { spawn } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+const DEFAULT_TIMEOUT = 120000;
+const MAX_BYTES = 50 * 1024;
+const MAX_LINES = 2000;
+function getShell() {
+    if (process.platform === 'win32') {
+        const gitPath = spawn('where', ['git'], { shell: true }).stdout.toString().trim();
+        if (gitPath) {
+            const bashPath = path.join(path.dirname(gitPath), '..', 'bin', 'bash.exe');
+            try {
+                if (fs.statSync(bashPath).isFile()) {
+                    return bashPath;
+                }
+            }
+            catch { }
+        }
+        return process.env.COMSPEC || 'cmd.exe';
+    }
+    return process.env.SHELL || '/bin/sh';
+}
+export const bashTool = {
+    name: 'bash',
+    description: '', // 从 description.txt 加载
+    parameters: {
+        type: 'object',
+        properties: {
+            command: {
+                type: 'string',
+                description: '要执行的命令'
+            },
+            workdir: {
+                type: 'string',
+                description: '工作目录（可选，默认为当前目录）'
+            },
+            timeout: {
+                type: 'number',
+                description: '超时时间，毫秒（可选，默认 120000 = 2分钟）'
+            }
+        },
+        required: ['command']
+    },
+    execute: async (params, context) => {
+        const { command, workdir, timeout = DEFAULT_TIMEOUT } = params;
+        const cwd = workdir || context.workDir || process.cwd();
+        let output = '';
+        let exited = false;
+        const shell = getShell();
+        const isWindows = process.platform === 'win32';
+        const shellArg = isWindows && shell.endsWith('bash.exe') ? shell : undefined;
+        const proc = spawn(command, {
+            shell: shellArg || shell,
+            cwd,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: isWindows
+        });
+        const killTree = () => {
+            if (process.platform === 'win32' && proc.pid) {
+                spawn('taskkill', ['/pid', String(proc.pid), '/f', '/t'], { stdio: 'ignore', windowsHide: true });
+            }
+            else if (proc.pid) {
+                try {
+                    process.kill(-proc.pid, 'SIGTERM');
+                }
+                catch {
+                    proc.kill('SIGTERM');
+                }
+            }
+        };
+        proc.stdout?.on('data', (chunk) => {
+            output += chunk.toString();
+            if (output.length > MAX_BYTES) {
+                output = output.slice(0, MAX_BYTES) + '\n\n[output truncated - exceeded ' + MAX_BYTES + ' bytes]';
+                killTree();
+            }
+        });
+        proc.stderr?.on('data', (chunk) => {
+            output += chunk.toString();
+        });
+        const abortHandler = () => {
+            killTree();
+        };
+        context.abortSignal?.addEventListener('abort', abortHandler);
+        const timeoutTimer = setTimeout(() => {
+            output += '\n\n[command timed out after ' + timeout + 'ms]';
+            killTree();
+        }, timeout);
+        try {
+            await new Promise((resolve, reject) => {
+                proc.on('exit', (code) => {
+                    exited = true;
+                    clearTimeout(timeoutTimer);
+                    context.abortSignal?.removeEventListener('abort', abortHandler);
+                    resolve();
+                });
+                proc.on('error', (err) => {
+                    exited = true;
+                    clearTimeout(timeoutTimer);
+                    context.abortSignal?.removeEventListener('abort', abortHandler);
+                    reject(err);
+                });
+            });
+        }
+        catch (err) {
+            return {
+                success: false,
+                output,
+                error: err.message
+            };
+        }
+        const lines = output.split('\n').length;
+        if (lines > MAX_LINES) {
+            const truncated = output.split('\n').slice(0, MAX_LINES).join('\n');
+            output = truncated + '\n\n[output truncated - exceeded ' + MAX_LINES + ' lines]';
+        }
+        return {
+            success: true,
+            output: output || '命令执行成功（无输出）',
+            metadata: { exitCode: proc.exitCode }
+        };
+    }
+};
+//# sourceMappingURL=bash.js.map

package/dist/modules/tools/builtin/bash.js.map

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

package/dist/modules/tools/builtin/bash.tool.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Bash 命令执行工具
+ */
+import { Tool } from '../tool.types.js';
+export declare const bashTool: Tool;
+//# sourceMappingURL=bash.tool.d.ts.map

package/dist/modules/tools/builtin/bash.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.tool.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/builtin/bash.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,eAAO,MAAM,QAAQ,EAAE,IAqDtB,CAAC"}

package/dist/modules/tools/builtin/bash.tool.js

@@ -0,0 +1,52 @@
+/**
+ * Bash 命令执行工具
+ */
+import { execSync } from 'child_process';
+export const bashTool = {
+    name: 'execute_bash',
+    description: '执行 shell 命令。支持 git、npm、ls 等常见命令。',
+    parameters: {
+        type: 'object',
+        properties: {
+            command: {
+                type: 'string',
+                description: '要执行的命令',
+            },
+            workdir: {
+                type: 'string',
+                description: '工作目录（可选）',
+            },
+            timeout: {
+                type: 'number',
+                description: '超时时间（毫秒，可选，默认 120000）',
+            },
+        },
+        required: ['command'],
+    },
+    execute: async (params) => {
+        const { command, workdir, timeout = 120000 } = params;
+        const forbidden = ['rm -rf /', 'sudo', 'chmod 777', '> /dev/sd'];
+        if (forbidden.some(f => command.includes(f))) {
+            return `错误: 禁止执行的命令`;
+        }
+        try {
+            const result = execSync(command, {
+                cwd: workdir,
+                timeout,
+                encoding: 'utf-8',
+                maxBuffer: 10 * 1024 * 1024,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return result.trim() || '命令执行成功（无输出）';
+        }
+        catch (error) {
+            const stderr = error.stderr?.toString() || '';
+            const stdout = error.stdout?.toString() || '';
+            if (stderr) {
+                return `命令执行错误:\n${stderr}`;
+            }
+            return `错误: ${error.message}`;
+        }
+    },
+};
+//# sourceMappingURL=bash.tool.js.map

package/dist/modules/tools/builtin/bash.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.tool.js","sourceRoot":"","sources":["../../../../src/modules/tools/builtin/bash.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,kCAAkC;IAC/C,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,QAAQ;aACtB;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,UAAU;aACxB;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uBAAuB;aACrC;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,OAAO,EAAE,KAAK,EAAE,MAIf,EAAmB,EAAE;QACpB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;QAEtD,MAAM,SAAS,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QACjE,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE;gBAC/B,GAAG,EAAE,OAAO;gBACZ,OAAO;gBACP,QAAQ,EAAE,OAAO;gBACjB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;gBAC3B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,aAAa,CAAC;QACxC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAE9C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,YAAY,MAAM,EAAE,CAAC;YAC9B,CAAC;YACD,OAAO,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/modules/tools/builtin/bash.txt

@@ -0,0 +1,81 @@
+在持久化 shell 会话中执行 bash 命令，支持可选超时，确保正确的处理和安全措施。
+
+所有命令默认在 ${directory} 执行。如需在其他目录运行命令，使用 `workdir` 参数。**禁止使用 `cd <目录> && <命令>` 模式**，应该使用 `workdir` 参数代替。
+
+**重要**：此工具仅用于终端操作如 git、npm、docker 等。**禁止**用于文件操作（读取、写入、编辑、搜索文件）——请使用专用工具。
+
+## 执行前验证
+
+1. **目录验证**：
+   - 如果命令会创建新目录或文件，先用 `ls` 验证父目录存在
+   - 例如：运行 "mkdir foo/bar" 前，先用 `ls foo` 确认 "foo" 存在
+
+2. **命令执行**：
+   - 包含空格的路径必须用双引号包裹
+   - 正确示例：`mkdir "/Users/name/My Documents"`
+   - 错误示例：`mkdir /Users/name/My Documents`（会失败）
+   - 确保正确引用后执行命令
+
+## 使用说明
+
+- `command` 参数是必需的
+- 可选超时时间（毫秒），默认 120000ms（2分钟）
+- 请用 5-10 个字写清楚命令作用的描述
+- 如果输出超过 ${maxLines} 行或 ${maxBytes} 字节，会被截断并保存到文件
+- 可以用 Read 的 offset/limit 读取特定部分，或用 Grep 搜索全部内容
+- **禁止**使用 `head`、`tail` 等命令限制输出
+
+**禁止使用 bash 执行以下操作**，请使用专用工具：
+- 文件搜索：用 Glob（不用 find 或 ls）
+- 内容搜索：用 Grep（不用 grep 或 rg）
+- 读取文件：用 Read（不用 cat/head/tail）
+- 编辑文件：用 Edit（不用 sed/awk）
+- 写入文件：用 Write（不用 echo >/cat <<EOF）
+- 输出文本：直接输出（不用 echo/printf）
+
+**多命令执行**：
+- 独立命令可以并行执行多个 Bash 调用
+- 顺序依赖的命令用 `&&` 链接（如 `git add . && git commit -m "message" && git push`）
+- 不关心前置结果时用 `;` 分隔
+- **禁止**使用换行符分隔命令（在引号字符串中除外）
+
+## Git 提交规范
+
+**何时创建提交**：只有用户明确要求时才创建提交。不确定时先询问。
+
+**Git 安全协议**：
+- 禁止强制推送（push --force）或硬重置
+- 禁止跳过 hooks（--no-verify、--no-gpg-sign 等）
+- 禁止强制推送到 main/master
+- 禁止 `git commit --amend`，**仅当**同时满足以下条件时才可使用：
+  (1) 用户明确要求，或提交成功但 pre-commit hook 自动修改了文件
+  (2) HEAD 提交是由你创建的（验证：`git log -1 --format='%an %ae'`）
+  (3) 提交**尚未**推送到远程（验证：`git status` 显示 "Your branch is ahead"）
+- **关键**：如果提交失败或被 hook 拒绝，**禁止 amend**——修复问题后创建新提交
+- **关键**：如果已推送到远程，**禁止 amend**（除非用户明确要求，需要 force push）
+
+**创建提交的步骤**：
+1. 并行执行 `git status`、`git diff`、`git log` 查看状态和提交风格
+2. 分析所有变更内容，起草 1-2 句话的提交信息（聚焦"为什么"而非"做了什么"）
+3. 并行执行：添加文件到暂存区 → 创建提交 → 运行 `git status` 验证
+4. 如果提交失败，修复问题后创建新提交（不要 amend）
+
+**注意事项**：
+- 禁止使用交互式 git 命令（如 `git rebase -i` 或 `git add -i`）
+- 除非用户明确要求，不要推送到远程
+- 没有变更时不创建空提交
+
+## 创建 Pull Request
+
+使用 Bash 工具的 `gh` 命令处理所有 GitHub 相关任务（issues、PRs、checks、releases）。收到 GitHub URL 时用 gh 命令获取所需信息。
+
+**创建 PR 的步骤**：
+1. 并行执行了解当前分支状态：`git status`、`git diff`、`git log` 和 `git diff [base-branch]...HEAD`
+2. 分析所有将包含在 PR 中的变更（不是只有最新提交，是**所有**提交），起草 PR 摘要
+3. 并行执行：需要时创建新分支 → 需要时推送 → 使用 `gh pr create` 创建 PR
+
+**注意**：不要使用 TodoWrite 或 Task 工具。完成后返回 PR URL。
+
+## 其他常用操作
+
+- 查看 PR 评论：`gh api repos/foo/bar/pulls/123/comments`

package/dist/modules/tools/builtin/code_search.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '../tool.types.js';
+export declare const codeSearchTool: Tool;
+//# sourceMappingURL=code_search.d.ts.map

package/dist/modules/tools/builtin/code_search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code_search.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/builtin/code_search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAA2B,MAAM,kBAAkB,CAAA;AAkChE,eAAO,MAAM,cAAc,EAAE,IAiF5B,CAAA"}

package/dist/modules/tools/builtin/code_search.js

@@ -0,0 +1,85 @@
+const API_CONFIG = {
+    BASE_URL: 'https://mcp.exa.ai',
+    ENDPOINTS: {
+        CONTEXT: '/mcp',
+    },
+    DEFAULT_TOKENS: 5000,
+    TIMEOUT: 30000,
+};
+export const codeSearchTool = {
+    name: 'code_search',
+    description: '',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: '搜索查询字符串，用于查找 APIs、库和 SDK 的相关上下文。例如：React useState hook examples、Python pandas dataframe filtering、Express.js middleware'
+            },
+            tokens: {
+                type: 'number',
+                description: '返回的 token 数量（可选，1000-50000，默认 5000）。根据需要调整上下文量 - 特定问题用较低值，全面文档用较高值'
+            }
+        },
+        required: ['query']
+    },
+    execute: async (params, context) => {
+        const codeRequest = {
+            jsonrpc: '2.0',
+            id: 1,
+            method: 'tools/call',
+            params: {
+                name: 'get_code_context_exa',
+                arguments: {
+                    query: params.query,
+                    tokensNum: params.tokens || API_CONFIG.DEFAULT_TOKENS,
+                },
+            },
+        };
+        const timeoutTimer = setTimeout(() => {
+            throw new Error('Code search request timed out');
+        }, API_CONFIG.TIMEOUT);
+        try {
+            const response = await fetch(`${API_CONFIG.BASE_URL}${API_CONFIG.ENDPOINTS.CONTEXT}`, {
+                method: 'POST',
+                headers: {
+                    accept: 'application/json, text/event-stream',
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(codeRequest),
+                signal: context.abortSignal,
+            });
+            clearTimeout(timeoutTimer);
+            if (!response.ok) {
+                const errorText = await response.text();
+                return { success: false, output: '', error: `Code search error (${response.status}): ${errorText}` };
+            }
+            const responseText = await response.text();
+            const lines = responseText.split('\n');
+            for (const line of lines) {
+                if (line.startsWith('data: ')) {
+                    const data = JSON.parse(line.substring(6));
+                    if (data.result && data.result.content && data.result.content.length > 0) {
+                        return {
+                            success: true,
+                            output: data.result.content[0].text,
+                            metadata: { query: params.query, tokens: params.tokens || API_CONFIG.DEFAULT_TOKENS },
+                        };
+                    }
+                }
+            }
+            return {
+                success: true,
+                output: '未找到代码片段或文档。请尝试其他查询，或更具体地说明库/框架名称。',
+            };
+        }
+        catch (err) {
+            clearTimeout(timeoutTimer);
+            if (err.message === 'Code search request timed out') {
+                return { success: false, output: '', error: '代码搜索请求超时' };
+            }
+            return { success: false, output: '', error: err.message };
+        }
+    }
+};
+//# sourceMappingURL=code_search.js.map

package/dist/modules/tools/builtin/code_search.js.map

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

package/dist/modules/tools/builtin/code_search.txt

@@ -0,0 +1,18 @@
+使用 Exa Code API 搜索编程相关的代码和上下文。
+
+**功能**：
+- 为任何编程任务提供最高质量和最新鲜的上下文
+- 提供库、SDK 和 API 的全面代码示例、文档和 API 参考
+- 用于任何编程相关问题
+- 优化用于查找特定编程模式和解决方案
+
+**使用说明**：
+- 可调整的 token 数量（1000-50000）用于聚焦或全面的结果
+- 默认 5000 tokens 为大多数查询提供平衡的上下文
+- 特定问题用较低值，全面文档用较高值
+- 支持关于框架、库、API 和编程概念的查询
+
+**示例**：
+- 'React useState hook examples'
+- 'Python pandas dataframe filtering'
+- 'Express.js middleware'

package/dist/modules/tools/builtin/edit-file.tool.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 文件编辑工具
+ */
+import { Tool } from '../tool.types.js';
+export declare const editFileTool: Tool;
+//# sourceMappingURL=edit-file.tool.d.ts.map

package/dist/modules/tools/builtin/edit-file.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file.tool.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/builtin/edit-file.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,eAAO,MAAM,YAAY,EAAE,IA4D1B,CAAC"}