@code4bug/jarvis-agent 1.0.2

package/dist/tools/index.js

@@ -0,0 +1,23 @@
+import { readFile } from './readFile.js';
+import { writeFile } from './writeFile.js';
+import { runCommand } from './runCommand.js';
+import { listDirectory } from './listDirectory.js';
+import { searchFiles } from './searchFiles.js';
+import { createSkill } from './createSkill.js';
+export { readFile, writeFile, runCommand, listDirectory, searchFiles, createSkill };
+/** 所有内置工具 */
+export const allTools = [readFile, writeFile, runCommand, listDirectory, searchFiles, createSkill];
+/** 按名称查找内置工具 */
+export function findTool(name) {
+    return allTools.find((t) => t.name === name);
+}
+// ===== 合并工具（内置 + 外部 Skills）=====
+import { getMergedTools, findMergedTool } from '../skills/index.js';
+/** 获取所有工具（内置 + 外部 skills），供 QueryEngine 使用 */
+export function getAllTools() {
+    return getMergedTools();
+}
+/** 按名称查找工具（内置 + 外部 skills） */
+export function findToolMerged(name) {
+    return findMergedTool(name);
+}

package/dist/tools/listDirectory.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from '../types/index.js';
+export declare const listDirectory: Tool;

package/dist/tools/listDirectory.js

@@ -0,0 +1,20 @@
+import fs from 'fs';
+export const listDirectory = {
+    name: 'list_directory',
+    description: '列出指定目录的文件和文件夹',
+    parameters: {
+        path: { type: 'string', description: '目录路径', required: true },
+    },
+    execute: async (args) => {
+        const dirPath = args.path || '.';
+        try {
+            const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+            return entries
+                .map((e) => (e.isDirectory() ? `[DIR] ${e.name}` : `      ${e.name}`))
+                .join('\n');
+        }
+        catch (e) {
+            throw new Error(`列出目录失败: ${e.message}`);
+        }
+    },
+};

package/dist/tools/readFile.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from '../types/index.js';
+export declare const readFile: Tool;

package/dist/tools/readFile.js

@@ -0,0 +1,17 @@
+import fs from 'fs';
+export const readFile = {
+    name: 'read_file',
+    description: '读取指定路径的文件内容',
+    parameters: {
+        path: { type: 'string', description: '文件路径', required: true },
+    },
+    execute: async (args) => {
+        const filePath = args.path;
+        try {
+            return fs.readFileSync(filePath, 'utf-8');
+        }
+        catch (e) {
+            throw new Error(`读取文件失败: ${e.message}`);
+        }
+    },
+};

package/dist/tools/runCommand.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from '../types/index.js';
+export declare const runCommand: Tool;

package/dist/tools/runCommand.js

@@ -0,0 +1,69 @@
+import { exec } from 'child_process';
+import { sanitizeOutput } from '../core/safeguard.js';
+/**
+ * 异步执行命令，不阻塞事件循环，保证 TUI 渲染正常
+ */
+function execAsync(command, options) {
+    return new Promise((resolve, reject) => {
+        exec(command, options, (error, stdout, stderr) => {
+            if (error) {
+                const parts = [];
+                if (stderr)
+                    parts.push(`[stderr] ${sanitizeOutput(String(stderr).trim())}`);
+                if (stdout)
+                    parts.push(`[stdout] ${sanitizeOutput(String(stdout).trim())}`);
+                if (error.code != null)
+                    parts.push(`[exit code] ${error.code}`);
+                if (parts.length === 0)
+                    parts.push(error.message);
+                reject(new Error(`命令执行失败:\n${parts.join('\n')}`));
+                return;
+            }
+            resolve(sanitizeOutput(String(stdout).trim()) || '(命令执行完成，无输出)');
+        });
+    });
+}
+export const runCommand = {
+    name: 'Bash',
+    description: '执行 Bash 命令并返回输出。调用格式: Bash(command)，例如 Bash(git status)、Bash(ls -la)',
+    parameters: {
+        command: { type: 'string', description: '要执行的 Bash 命令', required: true },
+    },
+    execute: async (args) => {
+        const command = args.command;
+        // 安全围栏拦截已在 query 层（executeTool）统一处理，此处仅负责执行 + 脱敏
+        return execAsync(command, {
+            encoding: 'utf-8',
+            timeout: 30000,
+            maxBuffer: 1024 * 1024,
+            env: sanitizeEnv(process.env),
+        });
+    },
+};
+/**
+ * 构造安全的子进程环境变量：
+ * 继承当前 env 但移除高危敏感变量，避免泄露到命令输出
+ */
+function sanitizeEnv(env) {
+    const SENSITIVE_KEYS = [
+        'AWS_SECRET_ACCESS_KEY',
+        'AWS_SESSION_TOKEN',
+        'GITHUB_TOKEN',
+        'GH_TOKEN',
+        'NPM_TOKEN',
+        'OPENAI_API_KEY',
+        'ANTHROPIC_API_KEY',
+        'DATABASE_URL',
+        'DB_PASSWORD',
+        'PRIVATE_KEY',
+        'SECRET_KEY',
+        'ENCRYPTION_KEY',
+    ];
+    const cleaned = { ...env };
+    for (const key of SENSITIVE_KEYS) {
+        if (cleaned[key]) {
+            cleaned[key] = '[REDACTED]';
+        }
+    }
+    return cleaned;
+}

package/dist/tools/searchFiles.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from '../types/index.js';
+export declare const searchFiles: Tool;

package/dist/tools/searchFiles.js

@@ -0,0 +1,45 @@
+import fs from 'fs';
+import path from 'path';
+export const searchFiles = {
+    name: 'search_files',
+    description: '在指定目录中搜索包含关键词的文件',
+    parameters: {
+        path: { type: 'string', description: '搜索目录', required: true },
+        pattern: { type: 'string', description: '搜索关键词', required: true },
+    },
+    execute: async (args) => {
+        const dirPath = args.path || '.';
+        const pattern = args.pattern;
+        const results = [];
+        function walk(dir) {
+            try {
+                const entries = fs.readdirSync(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const full = path.join(dir, entry.name);
+                    if (entry.name.startsWith('.') || entry.name === 'node_modules')
+                        continue;
+                    if (entry.isDirectory()) {
+                        walk(full);
+                    }
+                    else {
+                        try {
+                            const content = fs.readFileSync(full, 'utf-8');
+                            const lines = content.split('\n');
+                            for (let i = 0; i < lines.length; i++) {
+                                if (lines[i].includes(pattern)) {
+                                    results.push(`${full}:${i + 1}: ${lines[i].trim()}`);
+                                }
+                            }
+                        }
+                        catch { /* skip binary */ }
+                    }
+                }
+            }
+            catch { /* skip inaccessible */ }
+        }
+        walk(dirPath);
+        return results.length > 0
+            ? results.slice(0, 50).join('\n')
+            : `未找到包含 "${pattern}" 的文件`;
+    },
+};

package/dist/tools/writeFile.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from '../types/index.js';
+export declare const writeFile: Tool;

package/dist/tools/writeFile.js

@@ -0,0 +1,42 @@
+import fs from 'fs';
+import path from 'path';
+import { detectSensitiveContent } from '../core/safeguard.js';
+export const writeFile = {
+    name: 'write_file',
+    description: '写入内容到指定文件',
+    parameters: {
+        path: { type: 'string', description: '文件路径', required: true },
+        content: { type: 'string', description: '文件内容', required: true },
+    },
+    execute: async (args) => {
+        const filePath = args.path;
+        const content = args.content;
+        // ===== 安全围栏：检测硬编码敏感信息 =====
+        const findings = detectSensitiveContent(content);
+        if (findings.length > 0) {
+            const warning = `检测到文件中包含疑似敏感信息: ${findings.join(', ')}\n` +
+                '建议使用环境变量替代硬编码。文件仍将写入，但请注意安全风险。';
+            // 仍然写入，但在结果中附带警告
+            try {
+                const dir = path.dirname(filePath);
+                if (!fs.existsSync(dir))
+                    fs.mkdirSync(dir, { recursive: true });
+                fs.writeFileSync(filePath, content, 'utf-8');
+                return `文件已写入: ${filePath}\n${warning}`;
+            }
+            catch (e) {
+                throw new Error(`写入文件失败: ${e.message}`);
+            }
+        }
+        try {
+            const dir = path.dirname(filePath);
+            if (!fs.existsSync(dir))
+                fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(filePath, content, 'utf-8');
+            return `文件已写入: ${filePath}`;
+        }
+        catch (e) {
+            throw new Error(`写入文件失败: ${e.message}`);
+        }
+    },
+};

package/dist/types/index.d.ts

@@ -0,0 +1,86 @@
+export type MessageStatus = 'pending' | 'success' | 'error' | 'aborted';
+export type MessageType = 'user' | 'reasoning' | 'tool_exec' | 'file_op' | 'thinking' | 'system' | 'network' | 'error';
+export interface Message {
+    id: string;
+    type: MessageType;
+    status: MessageStatus;
+    content: string;
+    timestamp: number;
+    /** 耗时 ms */
+    duration?: number;
+    /** token 统计 */
+    tokenCount?: number;
+    /** 首 token 延时 ms */
+    firstTokenLatency?: number;
+    /** 平均每秒 token 数 */
+    tokensPerSecond?: number;
+    /** 工具调用相关 */
+    toolName?: string;
+    toolArgs?: Record<string, unknown>;
+    toolResult?: string;
+    /** 大模型思考过程，仅本地展示，不带入上下文 */
+    think?: string;
+    /** 中断提示文案，仅 aborted 状态时使用 */
+    abortHint?: string;
+}
+export type ContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+};
+export interface LoopState {
+    iteration: number;
+    maxIterations: number;
+    isRunning: boolean;
+    aborted: boolean;
+}
+export interface ToolParameter {
+    type: string;
+    description: string;
+    required?: boolean;
+}
+export interface Tool {
+    name: string;
+    description: string;
+    parameters: Record<string, ToolParameter>;
+    execute: (args: Record<string, unknown>) => Promise<string>;
+}
+export interface Session {
+    id: string;
+    messages: Message[];
+    createdAt: number;
+    updatedAt: number;
+    totalTokens: number;
+    totalCost: number;
+    /** 会话摘要（首条用户消息截取），用于 /resume 列表展示 */
+    summary?: string;
+}
+export interface LLMServiceConfig {
+    apiKey?: string;
+    model?: string;
+    maxTokens?: number;
+}
+export interface StreamCallbacks {
+    onText: (text: string) => void;
+    /** 大模型思考过程（reasoning_content），仅本地展示 */
+    onThinking?: (text: string) => void;
+    onToolUse: (id: string, name: string, input: Record<string, unknown>) => void;
+    onComplete: () => void;
+    onError: (error: Error) => void;
+}
+/** 可中断信号，用于取消正在进行的 LLM 流式请求 */
+export interface AbortSignal {
+    aborted: boolean;
+}
+export interface TranscriptMessage {
+    role: 'user' | 'assistant' | 'tool_result';
+    content: string | ContentBlock[];
+    toolUseId?: string;
+}
+export interface LLMService {
+    streamMessage: (transcript: TranscriptMessage[], tools: Tool[], callbacks: StreamCallbacks, abortSignal?: AbortSignal) => Promise<void>;
+}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+// ===== 消息系统 =====
+export {};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@code4bug/jarvis-agent",
+  "version": "1.0.2",
+  "description": "基于 React + TypeScript + Ink 构建的命令行智能体交互界面",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "jarvis": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && cp src/agents/*.md dist/agents/",
+    "prepack": "npm run build",
+    "start": "tsx src/cli.ts",
+    "dev": "tsx src/cli.ts",
+    "test": "npm run build"
+  },
+  "dependencies": {
+    "ink": "^5.1.0",
+    "ink-spinner": "^5.0.0",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "react": "^18.3.1",
+    "uuid": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.18",
+    "@types/uuid": "^10.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "license": "MIT",
+  "author": "Code4Bug",
+  "homepage": "https://github.com/Code4Bug/jarvis#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Code4Bug/jarvis.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Code4Bug/jarvis/issues"
+  },
+  "keywords": [
+    "cli",
+    "agent",
+    "ai",
+    "chatbot",
+    "ink",
+    "react",
+    "typescript",
+    "terminal"
+  ]
+}