axon-code 2.4.0

package/dist/web/server/checkpoint-manager.js

@@ -0,0 +1,359 @@
+/**
+ * WebUI 文件检查点管理器
+ * 提供文件快照保存和恢复功能
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { createHash } from 'crypto';
+import { randomUUID } from 'crypto';
+/**
+ * 检查点管理器
+ */
+export class CheckpointManager {
+    checkpoints;
+    storageDir;
+    constructor(storageDir) {
+        this.checkpoints = new Map();
+        this.storageDir = storageDir || path.join(os.homedir(), '.axon', 'checkpoints');
+        // 确保存储目录存在
+        this.ensureStorageDir();
+        // 加载已有的检查点
+        this.loadCheckpoints();
+    }
+    /**
+     * 确保存储目录存在
+     */
+    ensureStorageDir() {
+        if (!fs.existsSync(this.storageDir)) {
+            fs.mkdirSync(this.storageDir, { recursive: true });
+        }
+    }
+    /**
+     * 加载所有检查点
+     */
+    loadCheckpoints() {
+        try {
+            const files = fs.readdirSync(this.storageDir);
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                try {
+                    const filePath = path.join(this.storageDir, file);
+                    const content = fs.readFileSync(filePath, 'utf-8');
+                    const checkpoint = JSON.parse(content);
+                    // 转换 timestamp 为 Date 对象
+                    checkpoint.timestamp = new Date(checkpoint.timestamp);
+                    this.checkpoints.set(checkpoint.id, checkpoint);
+                }
+                catch (error) {
+                    console.error(`[CheckpointManager] Failed to load checkpoint ${file}:`, error);
+                }
+            }
+            console.log(`[CheckpointManager] Loaded ${this.checkpoints.size} checkpoints`);
+        }
+        catch (error) {
+            console.error('[CheckpointManager] Failed to load checkpoints directory:', error);
+        }
+    }
+    /**
+     * 保存检查点到磁盘
+     */
+    saveCheckpointToDisk(checkpoint) {
+        const filePath = path.join(this.storageDir, `${checkpoint.id}.json`);
+        fs.writeFileSync(filePath, JSON.stringify(checkpoint, null, 2), 'utf-8');
+    }
+    /**
+     * 从磁盘删除检查点
+     */
+    deleteCheckpointFromDisk(id) {
+        const filePath = path.join(this.storageDir, `${id}.json`);
+        if (fs.existsSync(filePath)) {
+            fs.unlinkSync(filePath);
+        }
+    }
+    /**
+     * 计算文件内容的哈希值
+     */
+    calculateHash(content) {
+        return createHash('sha256').update(content).digest('hex');
+    }
+    /**
+     * 读取文件内容
+     */
+    readFile(filePath) {
+        try {
+            const absolutePath = path.resolve(filePath);
+            if (!fs.existsSync(absolutePath)) {
+                console.warn(`[CheckpointManager] File does not exist: ${absolutePath}`);
+                return null;
+            }
+            const content = fs.readFileSync(absolutePath, 'utf-8');
+            const hash = this.calculateHash(content);
+            const stats = fs.statSync(absolutePath);
+            return {
+                path: absolutePath,
+                content,
+                hash,
+                size: content.length,
+                mtime: stats.mtimeMs,
+            };
+        }
+        catch (error) {
+            console.error(`[CheckpointManager] Failed to read file ${filePath}:`, error);
+            return null;
+        }
+    }
+    /**
+     * 创建检查点
+     */
+    async createCheckpoint(description, filePaths, workingDirectory, metadata) {
+        const id = randomUUID();
+        const files = [];
+        // 读取所有文件
+        for (const filePath of filePaths) {
+            const file = this.readFile(filePath);
+            if (file) {
+                files.push(file);
+            }
+        }
+        if (files.length === 0) {
+            throw new Error('No valid files available to create checkpoint');
+        }
+        const checkpoint = {
+            id,
+            timestamp: new Date(),
+            description,
+            files,
+            workingDirectory: workingDirectory || process.cwd(),
+            metadata,
+        };
+        // 保存到内存和磁盘
+        this.checkpoints.set(id, checkpoint);
+        this.saveCheckpointToDisk(checkpoint);
+        console.log(`[CheckpointManager] Created checkpoint: ${id} (${files.length} files)`);
+        return checkpoint;
+    }
+    /**
+     * 列出所有检查点
+     */
+    listCheckpoints(options) {
+        let checkpoints = Array.from(this.checkpoints.values());
+        // 排序
+        const sortBy = options?.sortBy || 'timestamp';
+        const sortOrder = options?.sortOrder || 'desc';
+        checkpoints.sort((a, b) => {
+            let comparison = 0;
+            if (sortBy === 'timestamp') {
+                comparison = a.timestamp.getTime() - b.timestamp.getTime();
+            }
+            else if (sortBy === 'description') {
+                comparison = a.description.localeCompare(b.description);
+            }
+            return sortOrder === 'asc' ? comparison : -comparison;
+        });
+        // 限制数量
+        if (options?.limit) {
+            checkpoints = checkpoints.slice(0, options.limit);
+        }
+        return checkpoints;
+    }
+    /**
+     * 获取检查点
+     */
+    getCheckpoint(id) {
+        return this.checkpoints.get(id);
+    }
+    /**
+     * 恢复检查点
+     */
+    async restoreCheckpoint(id, options) {
+        const checkpoint = this.checkpoints.get(id);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint ${id} does not exist`);
+        }
+        const restored = [];
+        const failed = [];
+        const errors = [];
+        // 如果是 dry run，只返回将要恢复的文件列表
+        if (options?.dryRun) {
+            return {
+                success: true,
+                restored: checkpoint.files.map(f => f.path),
+                failed: [],
+                errors: [],
+            };
+        }
+        // 恢复每个文件
+        for (const file of checkpoint.files) {
+            try {
+                const dir = path.dirname(file.path);
+                // 确保目录存在
+                if (!fs.existsSync(dir)) {
+                    fs.mkdirSync(dir, { recursive: true });
+                }
+                // 备份当前文件（如果存在且未跳过备份）
+                if (!options?.skipBackup && fs.existsSync(file.path)) {
+                    const backupPath = `${file.path}.backup-${Date.now()}`;
+                    fs.copyFileSync(file.path, backupPath);
+                }
+                // 写入检查点内容
+                fs.writeFileSync(file.path, file.content, 'utf-8');
+                restored.push(file.path);
+                console.log(`[CheckpointManager] Restoring file: ${file.path}`);
+            }
+            catch (error) {
+                console.error(`[CheckpointManager] Failed to restore file ${file.path}:`, error);
+                failed.push(file.path);
+                errors.push({
+                    path: file.path,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        const success = failed.length === 0;
+        console.log(`[CheckpointManager] Restore checkpoint ${id}: ` +
+            `${restored.length}/${checkpoint.files.length} files succeeded`);
+        return {
+            success,
+            restored,
+            failed,
+            errors,
+        };
+    }
+    /**
+     * 删除检查点
+     */
+    deleteCheckpoint(id) {
+        const checkpoint = this.checkpoints.get(id);
+        if (!checkpoint) {
+            return false;
+        }
+        this.checkpoints.delete(id);
+        this.deleteCheckpointFromDisk(id);
+        console.log(`[CheckpointManager] Deleted checkpoint: ${id}`);
+        return true;
+    }
+    /**
+     * 清除所有检查点
+     */
+    clearCheckpoints() {
+        const count = this.checkpoints.size;
+        // 删除所有检查点文件
+        for (const id of this.checkpoints.keys()) {
+            this.deleteCheckpointFromDisk(id);
+        }
+        this.checkpoints.clear();
+        console.log(`[CheckpointManager] Cleared all checkpoints: ${count}`);
+        return count;
+    }
+    /**
+     * 比较检查点与当前文件状态
+     */
+    async diffCheckpoint(id) {
+        const checkpoint = this.checkpoints.get(id);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint ${id} does not exist`);
+        }
+        const diffs = [];
+        for (const checkpointFile of checkpoint.files) {
+            try {
+                if (!fs.existsSync(checkpointFile.path)) {
+                    // 文件已被删除
+                    diffs.push({
+                        path: checkpointFile.path,
+                        type: 'removed',
+                        checkpointContent: checkpointFile.content,
+                    });
+                    continue;
+                }
+                const currentContent = fs.readFileSync(checkpointFile.path, 'utf-8');
+                const currentHash = this.calculateHash(currentContent);
+                if (currentHash === checkpointFile.hash) {
+                    // 文件未改变
+                    diffs.push({
+                        path: checkpointFile.path,
+                        type: 'unchanged',
+                    });
+                }
+                else {
+                    // 文件已修改
+                    diffs.push({
+                        path: checkpointFile.path,
+                        type: 'modified',
+                        checkpointContent: checkpointFile.content,
+                        currentContent,
+                        diff: this.createSimpleDiff(checkpointFile.content, currentContent),
+                    });
+                }
+            }
+            catch (error) {
+                console.error(`[CheckpointManager] Failed to compare file ${checkpointFile.path}:`, error);
+            }
+        }
+        return diffs;
+    }
+    /**
+     * 创建简单的文本差异
+     */
+    createSimpleDiff(oldContent, newContent) {
+        const oldLines = oldContent.split('\n');
+        const newLines = newContent.split('\n');
+        let diff = '';
+        const maxLines = Math.max(oldLines.length, newLines.length);
+        for (let i = 0; i < maxLines; i++) {
+            const oldLine = oldLines[i];
+            const newLine = newLines[i];
+            if (oldLine === newLine) {
+                diff += `  ${oldLine || ''}\n`;
+            }
+            else if (oldLine === undefined) {
+                diff += `+ ${newLine || ''}\n`;
+            }
+            else if (newLine === undefined) {
+                diff += `- ${oldLine || ''}\n`;
+            }
+            else {
+                diff += `- ${oldLine}\n`;
+                diff += `+ ${newLine}\n`;
+            }
+        }
+        return diff;
+    }
+    /**
+     * 获取存储目录路径
+     */
+    getStorageDir() {
+        return this.storageDir;
+    }
+    /**
+     * 获取检查点统计信息
+     */
+    getStats() {
+        const checkpoints = Array.from(this.checkpoints.values());
+        const stats = {
+            total: checkpoints.length,
+            totalFiles: 0,
+            totalSize: 0,
+            oldest: undefined,
+            newest: undefined,
+        };
+        if (checkpoints.length === 0) {
+            return stats;
+        }
+        for (const checkpoint of checkpoints) {
+            stats.totalFiles += checkpoint.files.length;
+            for (const file of checkpoint.files) {
+                stats.totalSize += file.size;
+            }
+            if (!stats.oldest || checkpoint.timestamp < stats.oldest) {
+                stats.oldest = checkpoint.timestamp;
+            }
+            if (!stats.newest || checkpoint.timestamp > stats.newest) {
+                stats.newest = checkpoint.timestamp;
+            }
+        }
+        return stats;
+    }
+}
+//# sourceMappingURL=checkpoint-manager.js.map

package/dist/web/server/checkpoint-manager.js.map

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

package/dist/web/server/connectors/index.d.ts

@@ -0,0 +1,115 @@
+/**
+ * OAuth Connector Manager
+ * 管理 OAuth 连接器的配置、认证和状态
+ */
+import type { ConnectorClientConfig, ConnectorStatus } from './types.js';
+export declare class ConnectorManager {
+    private settingsPath;
+    private pendingStates;
+    private lastReadFailed;
+    constructor();
+    /**
+     * 读取 settings.json
+     */
+    private readSettings;
+    /**
+     * 写入 settings.json
+     */
+    private writeSettings;
+    /**
+     * 清理过期的 OAuth state（超过 5 分钟）
+     */
+    private cleanExpiredStates;
+    /**
+     * 列出所有连接器状态
+     */
+    listConnectors(): ConnectorStatus[];
+    /**
+     * 解析 provider 的运行时 authType
+     * 双模式 provider（如 Slack 同时有 oauth 和 credentials）根据 settings.json 动态判断：
+     *  - connectorClients 中有 OAuth clientId/clientSecret → 'oauth'
+     *  - 否则 → 'credentials'（显示表单让用户填）
+     */
+    private resolveAuthType;
+    /**
+     * 获取单个连接器状态
+     */
+    getConnector(id: string): ConnectorStatus | null;
+    /**
+     * 获取客户端配置
+     * 统一从 settings.json connectorClients 读取
+     */
+    getClientConfig(id: string): ConnectorClientConfig | null;
+    /**
+     * 保存客户端配置
+     */
+    setClientConfig(id: string, config: ConnectorClientConfig): void;
+    /**
+     * 凭据直连（不走 OAuth 弹窗，如钉钉）
+     * 保存凭据 → 创建 connector 记录 → 注册 MCP
+     */
+    directConnect(id: string, credentials: ConnectorClientConfig): string;
+    /**
+     * MCP 远程 OAuth 连接（通过 mcp-remote 代理，如 Notion/Slack/Linear/Jira）
+     * 无需凭据，直接注册 MCP Server。OAuth 由 mcp-remote 在首次连接时自动弹窗处理。
+     */
+    mcpOAuthConnect(id: string): string;
+    /**
+     * 启动 OAuth 流程
+     */
+    startOAuth(id: string, redirectBase: string): {
+        authUrl: string;
+        state: string;
+    };
+    /**
+     * 处理 OAuth 回调
+     */
+    handleCallback(code: string, state: string, redirectBase: string): Promise<string>;
+    /**
+     * 用 code 换取 access token
+     */
+    private exchangeCodeForToken;
+    /**
+     * 获取用户信息
+     */
+    private fetchUserInfo;
+    /**
+     * 断开连接
+     */
+    disconnect(id: string): void;
+    /**
+     * 刷新 Token（如果需要）
+     * GitHub OAuth token 无过期时间，直接返回 true
+     * Google OAuth token 距过期 < 5 分钟时用 refreshToken 刷新
+     */
+    refreshTokenIfNeeded(connectorId: string): Promise<boolean>;
+    /**
+     * 获取 MCP Server 配置（用于注册 MCP Server）
+     */
+    getMcpServerConfig(connectorId: string): {
+        name: string;
+        config: any;
+    } | null;
+    /**
+     * 为 Google Workspace MCP 预写 token 文件
+     * 路径: ~/.config/google-workspace-mcp/tokens.json
+     * 这样 MCP 启动时直接用已有 token，不需要再次 OAuth
+     */
+    writeGoogleMcpTokenFile(connectorId: string): void;
+    /**
+     * 清理 Google Workspace MCP token 文件
+     */
+    cleanGoogleMcpTokenFile(): void;
+    /**
+     * 注册 MCP Server 到 settings.json
+     * 在 handleCallback 成功后调用
+     */
+    registerMcpInSettings(connectorId: string): void;
+    /**
+     * 从 settings.json 中注销 MCP Server
+     * 在 disconnect 时调用
+     */
+    unregisterMcpFromSettings(connectorId: string): void;
+}
+export declare const connectorManager: ConnectorManager;
+//# sourceMappingURL=index.d.ts.map

package/dist/web/server/connectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/web/server/connectors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAGV,qBAAqB,EACrB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAUpB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,cAAc,CAAS;;IAM/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,cAAc,IAAI,eAAe,EAAE;IA8DnC;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAKhD;;;OAGG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IASzD;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAchE;;;OAGG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,GAAG,MAAM;IAgCrE;;;OAGG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IA4BnC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IA6DhF;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2DxF;;OAEG;YACW,oBAAoB;IA+FlC;;OAEG;YACW,aAAa;IAsD3B;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAkC5B;;;;OAIG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuEjE;;OAEG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI;IA0F7E;;;;OAIG;IACH,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IA2ClD;;OAEG;IACH,uBAAuB,IAAI,IAAI;IAY/B;;;OAGG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAchD;;;OAGG;IACH,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;CAWrD;AAGD,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}