opclawtm 1.4.0

package/dist/core/utils/credentials-cleanup.js

@@ -0,0 +1,256 @@
+"use strict";
+/**
+ * Credentials Cleanup Utility
+ *
+ * 用于清理飞书配对文件和去重文件的工具函数
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCredentialsDir = getCredentialsDir;
+exports.getFeishuDedupDir = getFeishuDedupDir;
+exports.cleanupFeishuDedupForAgent = cleanupFeishuDedupForAgent;
+exports.cleanupFeishuCredentialsForAgent = cleanupFeishuCredentialsForAgent;
+exports.cleanupFeishuCredentialsForGroup = cleanupFeishuCredentialsForGroup;
+exports.cleanupAllFeishuCredentials = cleanupAllFeishuCredentials;
+exports.cleanupFeishuCredentialsForAgents = cleanupFeishuCredentialsForAgents;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const index_1 = require("./index");
+/**
+ * 获取凭证目录路径
+ */
+function getCredentialsDir() {
+    const openclawRoot = (0, index_1.getOpenClawRoot)();
+    if (openclawRoot) {
+        return path.join(openclawRoot, 'credentials');
+    }
+    return path.join(os.homedir(), '.openclaw', 'credentials');
+}
+/**
+ * 获取飞书去重目录路径
+ */
+function getFeishuDedupDir() {
+    const openclawRoot = (0, index_1.getOpenClawRoot)();
+    if (openclawRoot) {
+        return path.join(openclawRoot, 'feishu', 'dedup');
+    }
+    return path.join(os.homedir(), '.openclaw', 'feishu', 'dedup');
+}
+/**
+ * 清理指定 Agent 的飞书去重文件
+ *
+ * 删除文件：
+ * - feishu/dedup/{agentId}.json
+ *
+ * @param agentId Agent ID
+ * @returns 清理结果
+ */
+function cleanupFeishuDedupForAgent(agentId) {
+    const dedupDir = getFeishuDedupDir();
+    const deleted = [];
+    const failed = [];
+    if (!fs.existsSync(dedupDir)) {
+        return { deleted, failed };
+    }
+    // 要删除的文件
+    const fileName = `${agentId}.json`;
+    const filePath = path.join(dedupDir, fileName);
+    if (fs.existsSync(filePath)) {
+        try {
+            fs.unlinkSync(filePath);
+            deleted.push(fileName);
+            console.log(`[清理] 已删除去重文件: ${fileName}`);
+        }
+        catch (e) {
+            failed.push(fileName);
+            console.warn(`[清理] 删除去重文件失败: ${fileName}`, e);
+        }
+    }
+    return { deleted, failed };
+}
+/**
+ * 清理指定 Agent 的飞书配对文件
+ *
+ * 删除文件：
+ * - feishu-{agentId}-allowFrom.json
+ * - feishu/dedup/{agentId}.json
+ *
+ * @param agentId Agent ID
+ * @returns 清理结果
+ */
+function cleanupFeishuCredentialsForAgent(agentId) {
+    const credentialsDir = getCredentialsDir();
+    const deleted = [];
+    const failed = [];
+    if (!fs.existsSync(credentialsDir)) {
+        return { deleted, failed };
+    }
+    // 要删除的文件列表
+    const filesToDelete = [
+        `feishu-${agentId}-allowFrom.json`
+    ];
+    for (const fileName of filesToDelete) {
+        const filePath = path.join(credentialsDir, fileName);
+        if (fs.existsSync(filePath)) {
+            try {
+                fs.unlinkSync(filePath);
+                deleted.push(fileName);
+                console.log(`[清理] 已删除: ${fileName}`);
+            }
+            catch (e) {
+                failed.push(fileName);
+                console.warn(`[清理] 删除失败: ${fileName}`, e);
+            }
+        }
+    }
+    // 清理去重文件
+    const dedupResult = cleanupFeishuDedupForAgent(agentId);
+    deleted.push(...dedupResult.deleted.map(f => `dedup/${f}`));
+    failed.push(...dedupResult.failed.map(f => `dedup/${f}`));
+    return { deleted, failed };
+}
+/**
+ * 清理指定飞书群相关的配置
+ *
+ * 注意：群绑定信息主要在 openclaw.json 中
+ * 这里只清理可能存在的群相关凭证文件
+ *
+ * @param groupId 飞书群 ID
+ * @returns 清理结果
+ */
+function cleanupFeishuCredentialsForGroup(groupId) {
+    const credentialsDir = getCredentialsDir();
+    const deleted = [];
+    const failed = [];
+    // 群相关的凭证文件较少，主要是用户配对
+    // 群绑定信息在 openclaw.json 中，由调用者清理
+    return { deleted, failed };
+}
+/**
+ * 清理所有飞书配对文件
+ *
+ * 删除文件：
+ * - feishu-pairing.json
+ * - feishu-*-allowFrom.json
+ * - feishu-allowFrom.json
+ * - feishu/dedup/*.json
+ *
+ * @returns 清理结果
+ */
+function cleanupAllFeishuCredentials() {
+    const credentialsDir = getCredentialsDir();
+    const deleted = [];
+    const failed = [];
+    // 1. 清理凭证目录
+    if (fs.existsSync(credentialsDir)) {
+        // 要删除的文件模式
+        const patterns = [
+            'feishu-pairing.json',
+            /^feishu-.*-allowFrom\.json$/,
+            /^feishu-allowFrom\.json$/
+        ];
+        try {
+            const files = fs.readdirSync(credentialsDir);
+            for (const file of files) {
+                const shouldDelete = patterns.some(pattern => {
+                    if (typeof pattern === 'string') {
+                        return file === pattern;
+                    }
+                    return pattern.test(file);
+                });
+                if (shouldDelete) {
+                    const filePath = path.join(credentialsDir, file);
+                    try {
+                        fs.unlinkSync(filePath);
+                        deleted.push(file);
+                        console.log(`[清理] 已删除: ${file}`);
+                    }
+                    catch (e) {
+                        failed.push(file);
+                        console.warn(`[清理] 删除失败: ${file}`, e);
+                    }
+                }
+            }
+        }
+        catch (e) {
+            console.error(`[清理] 读取凭证目录失败:`, e);
+        }
+    }
+    // 2. 清理去重目录
+    const dedupDir = getFeishuDedupDir();
+    if (fs.existsSync(dedupDir)) {
+        try {
+            const files = fs.readdirSync(dedupDir);
+            for (const file of files) {
+                if (file.endsWith('.json')) {
+                    const filePath = path.join(dedupDir, file);
+                    try {
+                        fs.unlinkSync(filePath);
+                        deleted.push(`dedup/${file}`);
+                        console.log(`[清理] 已删除去重文件: ${file}`);
+                    }
+                    catch (e) {
+                        failed.push(`dedup/${file}`);
+                        console.warn(`[清理] 删除去重文件失败: ${file}`, e);
+                    }
+                }
+            }
+        }
+        catch (e) {
+            console.error(`[清理] 读取去重目录失败:`, e);
+        }
+    }
+    return { deleted, failed };
+}
+/**
+ * 清理指定账号列表的飞书配对文件
+ *
+ * 用于批量删除 Agent 时清理
+ *
+ * @param agentIds Agent ID 列表
+ * @returns 清理结果
+ */
+function cleanupFeishuCredentialsForAgents(agentIds) {
+    const allDeleted = [];
+    const allFailed = [];
+    for (const agentId of agentIds) {
+        const result = cleanupFeishuCredentialsForAgent(agentId);
+        allDeleted.push(...result.deleted);
+        allFailed.push(...result.failed);
+    }
+    return { deleted: allDeleted, failed: allFailed };
+}
+//# sourceMappingURL=credentials-cleanup.js.map

package/dist/core/utils/credentials-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials-cleanup.js","sourceRoot":"","sources":["../../../src/core/utils/credentials-cleanup.ts"],"names":[],"mappings":"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"}

package/dist/core/utils/index.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Utility Functions Module
+ */
+/**
+ * Generate task ID
+ * Format: task_YYYYMMDD_random_string
+ */
+export declare function generateTaskId(): string;
+/**
+ * Generate increment task ID (v1.1.3)
+ * Format: {base_task_id}_{increment_index}
+ * Example: task_20260321_abc12345_001
+ *
+ * @param baseTaskId - The base task ID
+ * @param incrementIndex - The increment index (1, 2, 3...)
+ */
+export declare function generateIncrementTaskId(baseTaskId: string, incrementIndex: number): string;
+/**
+ * Generate stage ID (v1.1.7)
+ * Format: stage_{task_id}_{sequence}
+ * Example: stage_task_20260321_abc12345_1
+ *
+ * @param taskId - The task ID
+ * @param sequence - The stage sequence (1, 2, 3...)
+ */
+export declare function generateStageId(taskId: string, sequence: number): string;
+/**
+ * Parse task ID to get base task ID and increment index (v1.1.3)
+ *
+ * @param taskId - The task ID to parse
+ * @returns { baseTaskId, incrementIndex } or null if not an increment task
+ */
+export declare function parseTaskId(taskId: string): {
+    baseTaskId: string;
+    incrementIndex: number;
+} | null;
+/**
+ * Check if task is an increment task (v1.1.3)
+ */
+export declare function isIncrementTask(taskId: string): boolean;
+/**
+ * Get base task ID from increment task ID (v1.1.3)
+ */
+export declare function getBaseTaskId(taskId: string): string | null;
+/**
+ * Generate node ID
+ * Format: node_random_string
+ */
+export declare function generateNodeId(): string;
+/**
+ * Generate Agent ID
+ * Format: agent_random_string
+ */
+export declare function generateAgentId(): string;
+/**
+ * Generate document ID
+ * Format: doc_random_string
+ */
+export declare function generateDocId(): string;
+/**
+ * Generate department ID
+ * Format: dept_random_string
+ */
+export declare function generateDeptId(): string;
+/**
+ * Generate job ID
+ * Format: job_random_string
+ */
+export declare function generateJobId(): string;
+/**
+ * Generate skill pack ID
+ * Format: skill_random_string
+ */
+export declare function generateSkillPackId(): string;
+/**
+ * Generate message ID
+ * Format: msg_random_string
+ */
+export declare function generateMessageId(): string;
+/**
+ * Get current ISO timestamp string
+ */
+export declare function getCurrentTimestamp(): string;
+/**
+ * Format date to YYYY-MM-DD format
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Format datetime to YYYY-MM-DD HH:mm:ss format
+ */
+export declare function formatDateTime(date: Date): string;
+/**
+ * Safe parse JSON, return default value on failure
+ */
+export declare function safeJsonParse<T>(json: string | null, defaultValue: T): T;
+/**
+ * Safe stringify JSON
+ */
+export declare function safeJsonStringify(obj: unknown): string;
+/**
+ * Validate if directory is a valid OpenClaw root
+ * Must have openclaw.json file
+ */
+export declare function isValidOpenClawRoot(dirPath: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Set OpenClaw root directory
+ * Will validate if directory is valid
+ */
+export declare function setOpenClawRoot(dirPath: string): {
+    success: boolean;
+    error?: string;
+};
+/**
+ * Get current OpenClaw root directory
+ */
+export declare function getOpenClawRoot(): string;
+/**
+ * Check if custom OpenClaw root is set
+ */
+export declare function hasCustomOpenClawRoot(): boolean;
+/**
+ * Reset to default OpenClaw root directory
+ */
+export declare function resetOpenClawRoot(): void;
+/**
+ * Get team directory (business data storage)
+ */
+export declare function getTeamRoot(): string;
+/**
+ * Get database path
+ */
+export declare function getDatabasePath(): string;
+/**
+ * Get task directory
+ */
+export declare function getTaskDir(taskId: string): string;
+/**
+ * Get role flow template directory
+ */
+export declare function getFlowsDir(): string;
+/**
+ * Get agent workspace directory
+ * Official standard: ~/.openclaw/workspace-<agentId>
+ */
+export declare function getAgentWorkspace(agentId: string): string;
+/**
+ * Get agent directory
+ * Official standard: ~/.openclaw/agents/<agentId>/agent
+ * Used for storing auth-profiles.json, models.json, etc.
+ */
+export declare function getAgentDir(agentId: string): string;
+/**
+ * Get agent sessions storage directory
+ * Official standard: ~/.openclaw/agents/<agentId>/sessions
+ */
+export declare function getAgentSessionsDir(agentId: string): string;
+/**
+ * Get openclaw.json config file path
+ */
+export declare function getOpenClawJsonPath(): string;
+/**
+ * Get credentials directory
+ * Official standard: ~/.openclaw/credentials
+ * Used for storing channel authentication info
+ */
+export declare function getCredentialsDir(): string;
+/**
+ * Get Feishu credentials directory
+ * Official standard: ~/.openclaw/credentials/feishu/<accountId>
+ */
+export declare function getFeishuCredentialsDir(accountId?: string): string;
+/**
+ * Get agent's auth-profiles.json path
+ * Official standard: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
+ */
+export declare function getAuthProfilesPath(agentId: string): string;
+/**
+ * Get agent's models.json path
+ * Official standard: ~/.openclaw/agents/<agentId>/agent/models.json
+ */
+export declare function getModelsJsonPath(agentId: string): string;
+/**
+ * Validate ID format
+ */
+export declare function isValidId(id: string): boolean;
+/**
+ * Validate role type
+ */
+export declare function isValidRole(role: string): boolean;
+/**
+ * Validate task status
+ */
+export declare function isValidTaskStatus(status: string): boolean;
+/**
+ * Validate node status
+ */
+export declare function isValidNodeStatus(status: string): boolean;
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Simple log output
+ */
+export declare function log(level: LogLevel, message: string, ...args: unknown[]): void;
+export declare const logger: {
+    debug: (message: string, ...args: unknown[]) => void;
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+};
+export * from './template-generator';
+export * from './agent-guide-generator';
+export * from './credentials-cleanup';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"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"}