flashclaw 1.0.0

package/dist/paths.js

@@ -0,0 +1,127 @@
+/**
+ * FlashClaw Path Management Module
+ *
+ * Centralized path management for all FlashClaw directories and files.
+ * Uses ~/.flashclaw/ as the configuration root directory.
+ */
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { mkdirSync, existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+/**
+ * Get the FlashClaw home directory.
+ * Supports FLASHCLAW_HOME environment variable override.
+ *
+ * @returns The FlashClaw home directory path (~/.flashclaw or FLASHCLAW_HOME)
+ */
+export function getFlashClawHome() {
+    return process.env.FLASHCLAW_HOME || join(homedir(), '.flashclaw');
+}
+/**
+ * Path utility object containing all FlashClaw path functions.
+ */
+export const paths = {
+    /**
+     * Root directory (~/.flashclaw)
+     */
+    home() {
+        return getFlashClawHome();
+    },
+    /**
+     * Environment file path (~/.flashclaw/.env)
+     */
+    env() {
+        return join(getFlashClawHome(), '.env');
+    },
+    /**
+     * Config directory (~/.flashclaw/config)
+     */
+    config() {
+        return join(getFlashClawHome(), 'config');
+    },
+    /**
+     * Plugins configuration file (~/.flashclaw/config/plugins.json)
+     */
+    pluginsConfig() {
+        return join(getFlashClawHome(), 'config', 'plugins.json');
+    },
+    /**
+     * Data directory (~/.flashclaw/data)
+     */
+    data() {
+        return join(getFlashClawHome(), 'data');
+    },
+    /**
+     * Database file path (~/.flashclaw/data/flashclaw.db)
+     */
+    database() {
+        return join(getFlashClawHome(), 'data', 'flashclaw.db');
+    },
+    /**
+     * PID file path (~/.flashclaw/data/flashclaw.pid)
+     */
+    pidFile() {
+        return join(getFlashClawHome(), 'data', 'flashclaw.pid');
+    },
+    /**
+     * Logs directory (~/.flashclaw/logs)
+     */
+    logs() {
+        return join(getFlashClawHome(), 'logs');
+    },
+    /**
+     * Log file path (~/.flashclaw/logs/flashclaw.log)
+     */
+    logFile() {
+        return join(getFlashClawHome(), 'logs', 'flashclaw.log');
+    },
+    /**
+     * User plugins directory (~/.flashclaw/plugins)
+     */
+    userPlugins() {
+        return join(getFlashClawHome(), 'plugins');
+    },
+    /**
+     * Groups directory (~/.flashclaw/groups)
+     */
+    groups() {
+        return join(getFlashClawHome(), 'groups');
+    },
+};
+/**
+ * Get the built-in plugins directory.
+ * Returns the path relative to the current module (../plugins).
+ *
+ * @returns The built-in plugins directory path
+ */
+export function getBuiltinPluginsDir() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    return join(__dirname, '..', 'plugins');
+}
+/**
+ * Ensure all necessary directories exist.
+ * Creates the following directories if they don't exist:
+ * - ~/.flashclaw
+ * - ~/.flashclaw/config
+ * - ~/.flashclaw/data
+ * - ~/.flashclaw/logs
+ * - ~/.flashclaw/plugins
+ * - ~/.flashclaw/groups
+ */
+export function ensureDirectories() {
+    const directories = [
+        paths.home(),
+        paths.config(),
+        paths.data(),
+        paths.logs(),
+        paths.userPlugins(),
+        paths.groups(),
+    ];
+    for (const dir of directories) {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;;OAEG;IACH,IAAI;QACF,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,WAAW,GAAG;QAClB,KAAK,CAAC,IAAI,EAAE;QACZ,KAAK,CAAC,MAAM,EAAE;QACd,KAAK,CAAC,IAAI,EAAE;QACZ,KAAK,CAAC,IAAI,EAAE;QACZ,KAAK,CAAC,WAAW,EAAE;QACnB,KAAK,CAAC,MAAM,EAAE;KACf,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * FlashClaw 插件系统
+ * 统一导出入口
+ */
+export { PluginConfig, ToolContext, ToolResult, Message, MessageHandler, ToolSchema, PluginManifest, ToolPlugin, ChannelPlugin, Plugin, isToolPlugin, isChannelPlugin, } from './types.js';
+export { PluginManager, pluginManager } from './manager.js';
+export { loadFromDir, loadPlugin, reloadPlugin, watchPlugins, stopWatching, getLoadedPaths, } from './loader.js';
+export { PluginInfo, Registry, InstalledPluginMeta, getUserPluginsDir, getRegistry, updateRegistry, downloadPlugin, validatePlugin, installPlugin, uninstallPlugin, listInstalledPlugins, listAvailablePlugins, updatePlugin, showPluginInfo, printPluginList, } from './installer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,cAAc,EACd,UAAU,EACV,cAAc,EACd,UAAU,EACV,aAAa,EACb,MAAM,EACN,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG5D,OAAO,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,13 @@
+/**
+ * FlashClaw 插件系统
+ * 统一导出入口
+ */
+// 类型定义
+export { isToolPlugin, isChannelPlugin, } from './types.js';
+// 插件管理器
+export { PluginManager, pluginManager } from './manager.js';
+// 热加载器
+export { loadFromDir, loadPlugin, reloadPlugin, watchPlugins, stopWatching, getLoadedPaths, } from './loader.js';
+// 插件安装器
+export { getUserPluginsDir, getRegistry, updateRegistry, downloadPlugin, validatePlugin, installPlugin, uninstallPlugin, listInstalledPlugins, listAvailablePlugins, updatePlugin, showPluginInfo, printPluginList, } from './installer.js';
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO;AACP,OAAO,EAWL,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO;AACP,OAAO,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,QAAQ;AACR,OAAO,EAIL,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/plugins/installer.d.ts

@@ -0,0 +1,120 @@
+/**
+ * FlashClaw 插件安装器
+ * 支持从 GitHub 下载、安装、卸载和更新插件
+ */
+/**
+ * 插件信息（来自注册表）
+ */
+export interface PluginInfo {
+    name: string;
+    description: string;
+    type: 'tool' | 'channel' | 'system';
+    version: string;
+    author: string;
+    tags: string[];
+}
+/**
+ * 插件注册表
+ */
+export interface Registry {
+    $schema?: string;
+    version: string;
+    updated: string;
+    officialRepo?: string;
+    officialPluginsPath?: string;
+    plugins: Record<string, PluginInfo>;
+}
+/**
+ * 已安装插件的元数据
+ */
+export interface InstalledPluginMeta {
+    name: string;
+    version: string;
+    installedAt: string;
+    source: 'registry' | 'local' | 'github';
+    repo?: string;
+}
+/**
+ * 获取用户插件安装目录
+ */
+export declare function getUserPluginsDir(): string;
+/**
+ * 获取插件注册表（兼容旧接口）
+ * 现在从 GitHub API 动态获取
+ */
+export declare function getRegistry(forceRemote?: boolean): Promise<Registry>;
+/**
+ * 更新注册表（从远程）
+ */
+export declare function updateRegistry(): Promise<Registry>;
+/**
+ * 从 GitHub 下载插件
+ * 下载仓库的 ZIP 文件并解压
+ *
+ * @param repo GitHub 仓库路径 (如 "owner/repo")
+ * @param targetDir 目标目录
+ * @param branch 分支名 (默认 "main")
+ */
+export declare function downloadPlugin(repo: string, targetDir: string, branch?: string): Promise<void>;
+/**
+ * 验证插件结构
+ * 检查必要文件是否存在：plugin.json 或 package.json, index.ts 或 index.js
+ *
+ * @param pluginDir 插件目录
+ * @returns 验证结果
+ */
+export declare function validatePlugin(pluginDir: string): Promise<{
+    valid: boolean;
+    errors: string[];
+    manifest?: {
+        name: string;
+        version: string;
+        description?: string;
+        type?: string;
+    };
+}>;
+/**
+ * 安装插件
+ * 直接从 community-plugins 目录下载，无需预先检查注册表
+ *
+ * @param name 插件名称
+ * @returns 是否安装成功
+ */
+export declare function installPlugin(name: string): Promise<boolean>;
+/**
+ * 卸载插件
+ *
+ * @param name 插件名称
+ * @returns 是否卸载成功
+ */
+export declare function uninstallPlugin(name: string): Promise<boolean>;
+/**
+ * 列出已安装插件
+ *
+ * @returns 已安装插件列表
+ */
+export declare function listInstalledPlugins(): Promise<InstalledPluginMeta[]>;
+/**
+ * 列出可用插件（注册表中的插件）
+ *
+ * @returns 可用插件列表
+ */
+export declare function listAvailablePlugins(): Promise<PluginInfo[]>;
+/**
+ * 更新插件
+ *
+ * @param name 插件名称
+ * @returns 是否更新成功
+ */
+export declare function updatePlugin(name: string): Promise<boolean>;
+/**
+ * 显示插件详情
+ *
+ * @param name 插件名称
+ */
+export declare function showPluginInfo(name: string): Promise<void>;
+/**
+ * 列出插件（带格式化输出）
+ */
+export declare function printPluginList(): Promise<void>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/plugins/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/plugins/installer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwLH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACrC;AA4BD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAaD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAsJD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,WAAW,UAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgCxE;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,CAExD;AAMD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,SAAS,GACd,OAAO,CAAC,IAAI,CAAC,CAwEf;AAqDD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC,CA2ED;AA2GD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4ElE;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCpE;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAiC3E;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAQlE;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsGjE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDhE;AAMD;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAsCrD"}