@f2a/openclaw-adapter 0.1.0

package/dist/plugin.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * F2A OpenClaw Adapter Plugin
+ * OpenClaw 插件标准入口
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskGuard = exports.AnnouncementQueue = exports.TaskQueue = exports.F2AOpenClawAdapter = void 0;
+exports.default = register;
+const connector_js_1 = require("./connector.js");
+/**
+ * OpenClaw 插件注册函数
+ * 这是 OpenClaw 加载插件时调用的入口
+ */
+async function register(api) {
+    const plugin = new connector_js_1.F2AOpenClawAdapter();
+    // 从 OpenClaw 配置中获取插件配置
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const pluginsConfig = api.config?.plugins;
+    const config = pluginsConfig?.entries?.['f2a-openclaw-adapter']?.config || {};
+    // 将 API 引用传递给插件（用于触发心跳等操作）
+    const fullConfig = {
+        ...config,
+        _api: api
+    };
+    // 初始化插件 - 等待完成后再注册工具
+    try {
+        await plugin.initialize(fullConfig);
+        api.logger?.info('[F2A Adapter] 初始化完成');
+    }
+    catch (error) {
+        api.logger?.error(`[F2A Adapter] 初始化失败: ${error.message}`);
+        // 清理已分配的资源，避免孤儿进程和端口占用
+        try {
+            api.logger?.info('[F2A Adapter] 正在清理资源...');
+            await plugin.shutdown?.();
+        }
+        catch (shutdownError) {
+            api.logger?.warn(`[F2A Adapter] 清理资源时出错: ${shutdownError.message}`);
+        }
+        // 抛出错误让 OpenClaw 知道插件加载失败
+        throw new Error(`F2A Adapter 初始化失败: ${error.message}`);
+    }
+    // 初始化完成后注册所有工具
+    // OpenClaw 的 registerTool 需要 execute 方法
+    const tools = plugin.getTools();
+    for (const tool of tools) {
+        api.registerTool?.({
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+            // OpenClaw 使用 execute 而不是 handler
+            async execute(_id, params) {
+                try {
+                    // 构造一个模拟的 SessionContext
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const workspace = api.config?.agents?.defaults?.workspace || '.';
+                    const mockContext = {
+                        sessionId: _id,
+                        workspace,
+                        toJSON: () => ({})
+                    };
+                    const result = await tool.handler(params, mockContext);
+                    // 将 ToolResult 转换为 OpenClaw 期望的格式
+                    if (typeof result === 'string') {
+                        return { content: [{ type: 'text', text: result }] };
+                    }
+                    if (result?.content) {
+                        return { content: [{ type: 'text', text: result.content }] };
+                    }
+                    return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+                }
+                catch (error) {
+                    api.logger?.error(`[F2A Adapter] 工具 ${tool.name} 执行失败: ${error.message}`);
+                    throw error;
+                }
+            }
+        });
+    }
+    // 注册后台服务（用于清理资源）
+    api.registerService?.({
+        id: 'f2a-adapter-service',
+        start: () => {
+            api.logger?.info('[F2A Adapter] 服务已启动');
+        },
+        stop: async () => {
+            api.logger?.info('[F2A Adapter] 正在停止服务...');
+            await plugin.shutdown?.();
+        }
+    });
+    api.logger?.info(`[F2A Adapter] 已注册 ${tools.length} 个工具`);
+}
+// 重新导出主要类，供外部使用
+var connector_js_2 = require("./connector.js");
+Object.defineProperty(exports, "F2AOpenClawAdapter", { enumerable: true, get: function () { return connector_js_2.F2AOpenClawAdapter; } });
+__exportStar(require("./types.js"), exports);
+var task_queue_js_1 = require("./task-queue.js");
+Object.defineProperty(exports, "TaskQueue", { enumerable: true, get: function () { return task_queue_js_1.TaskQueue; } });
+var announcement_queue_js_1 = require("./announcement-queue.js");
+Object.defineProperty(exports, "AnnouncementQueue", { enumerable: true, get: function () { return announcement_queue_js_1.AnnouncementQueue; } });
+var task_guard_js_1 = require("./task-guard.js");
+Object.defineProperty(exports, "TaskGuard", { enumerable: true, get: function () { return task_guard_js_1.TaskGuard; } });
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/reputation.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 信誉系统
+ * 管理 Peer 的信誉分数
+ */
+import type { ReputationEntry, ReputationConfig } from './types.js';
+export declare class ReputationSystem {
+    private config;
+    private entries;
+    private dataPath;
+    constructor(config: ReputationConfig, dataDir: string);
+    /**
+     * 获取 Peer 信誉
+     */
+    getReputation(peerId: string): ReputationEntry;
+    /**
+     * 记录任务成功
+     */
+    recordSuccess(peerId: string, taskId: string, latency: number): void;
+    /**
+     * 记录任务失败
+     */
+    recordFailure(peerId: string, taskId: string, reason?: string): void;
+    /**
+     * 记录任务拒绝
+     */
+    recordRejection(peerId: string, taskId: string, reason?: string): void;
+    /**
+     * 记录超时
+     */
+    recordTimeout(peerId: string, taskId: string): void;
+    /**
+     * 记录恶意行为
+     */
+    recordMalicious(peerId: string, reason: string): void;
+    /**
+     * 检查是否允许服务
+     */
+    isAllowed(peerId: string): boolean;
+    /**
+     * 获取所有信誉记录
+     */
+    getAllReputations(): ReputationEntry[];
+    /**
+     * 清理过期记录
+     */
+    cleanup(maxAgeDays?: number): void;
+    /**
+     * 获取高信誉节点
+     */
+    getHighReputationNodes(minScore: number): ReputationEntry[];
+    /**
+     * 创建默认条目
+     */
+    private createDefaultEntry;
+    /**
+     * 更新平均响应时间
+     */
+    private updateAvgResponseTime;
+    /**
+     * 修剪历史记录
+     */
+    private trimHistory;
+    /**
+     * 加载数据
+     */
+    private load;
+    /**
+     * 保存数据
+     */
+    private save;
+}
+//# sourceMappingURL=reputation.d.ts.map

package/dist/reputation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation.d.ts","sourceRoot":"","sources":["../src/reputation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,eAAe,EAEf,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;IAMrD;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAO9C;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAoBpE;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAoBpE;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBtE;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAkBnD;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAiBrD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAOlC;;OAEG;IACH,iBAAiB,IAAI,eAAe,EAAE;IAItC;;OAEG;IACH,OAAO,CAAC,UAAU,GAAE,MAAW,GAAG,IAAI;IAYtC;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IAK3D;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,IAAI;IAcZ;;OAEG;IACH,OAAO,CAAC,IAAI;CAQb"}

package/dist/reputation.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * 信誉系统
+ * 管理 Peer 的信誉分数
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReputationSystem = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+class ReputationSystem {
+    config;
+    entries = new Map();
+    dataPath;
+    constructor(config, dataDir) {
+        this.config = config;
+        this.dataPath = (0, path_1.join)(dataDir, 'reputation.json');
+        this.load();
+    }
+    /**
+     * 获取 Peer 信誉
+     */
+    getReputation(peerId) {
+        if (!this.entries.has(peerId)) {
+            this.entries.set(peerId, this.createDefaultEntry(peerId));
+        }
+        return this.entries.get(peerId);
+    }
+    /**
+     * 记录任务成功
+     */
+    recordSuccess(peerId, taskId, latency) {
+        const entry = this.getReputation(peerId);
+        entry.successfulTasks++;
+        entry.totalTasks++;
+        entry.score = Math.min(100, entry.score + 10);
+        entry.avgResponseTime = this.updateAvgResponseTime(entry, latency);
+        entry.lastInteraction = Date.now();
+        entry.history.push({
+            type: 'task_success',
+            taskId,
+            delta: +10,
+            timestamp: Date.now()
+        });
+        this.trimHistory(entry);
+        this.save();
+    }
+    /**
+     * 记录任务失败
+     */
+    recordFailure(peerId, taskId, reason) {
+        const entry = this.getReputation(peerId);
+        entry.failedTasks++;
+        entry.totalTasks++;
+        entry.score = Math.max(0, entry.score - 20);
+        entry.lastInteraction = Date.now();
+        entry.history.push({
+            type: 'task_failure',
+            taskId,
+            delta: -20,
+            timestamp: Date.now(),
+            reason
+        });
+        this.trimHistory(entry);
+        this.save();
+    }
+    /**
+     * 记录任务拒绝
+     */
+    recordRejection(peerId, taskId, reason) {
+        const entry = this.getReputation(peerId);
+        entry.totalTasks++;
+        entry.score = Math.max(0, entry.score - 5);
+        entry.lastInteraction = Date.now();
+        entry.history.push({
+            type: 'task_rejected',
+            taskId,
+            delta: -5,
+            timestamp: Date.now(),
+            reason
+        });
+        this.trimHistory(entry);
+        this.save();
+    }
+    /**
+     * 记录超时
+     */
+    recordTimeout(peerId, taskId) {
+        const entry = this.getReputation(peerId);
+        entry.totalTasks++;
+        entry.score = Math.max(0, entry.score - 15);
+        entry.lastInteraction = Date.now();
+        entry.history.push({
+            type: 'timeout',
+            taskId,
+            delta: -15,
+            timestamp: Date.now()
+        });
+        this.trimHistory(entry);
+        this.save();
+    }
+    /**
+     * 记录恶意行为
+     */
+    recordMalicious(peerId, reason) {
+        const entry = this.getReputation(peerId);
+        entry.score = Math.max(0, entry.score - 50);
+        entry.lastInteraction = Date.now();
+        entry.history.push({
+            type: 'malicious',
+            delta: -50,
+            timestamp: Date.now(),
+            reason
+        });
+        this.trimHistory(entry);
+        this.save();
+    }
+    /**
+     * 检查是否允许服务
+     */
+    isAllowed(peerId) {
+        if (!this.config.enabled)
+            return true;
+        const entry = this.getReputation(peerId);
+        return entry.score >= this.config.minScoreForService;
+    }
+    /**
+     * 获取所有信誉记录
+     */
+    getAllReputations() {
+        return Array.from(this.entries.values());
+    }
+    /**
+     * 清理过期记录
+     */
+    cleanup(maxAgeDays = 30) {
+        const cutoff = Date.now() - (maxAgeDays * 24 * 60 * 60 * 1000);
+        for (const [peerId, entry] of this.entries) {
+            if (entry.lastInteraction < cutoff && entry.totalTasks === 0) {
+                this.entries.delete(peerId);
+            }
+        }
+        this.save();
+    }
+    /**
+     * 获取高信誉节点
+     */
+    getHighReputationNodes(minScore) {
+        return Array.from(this.entries.values())
+            .filter(entry => entry.score >= minScore);
+    }
+    /**
+     * 创建默认条目
+     */
+    createDefaultEntry(peerId) {
+        return {
+            peerId,
+            score: this.config.initialScore,
+            successfulTasks: 0,
+            failedTasks: 0,
+            totalTasks: 0,
+            avgResponseTime: 0,
+            lastInteraction: 0,
+            history: []
+        };
+    }
+    /**
+     * 更新平均响应时间
+     */
+    updateAvgResponseTime(entry, newLatency) {
+        if (entry.avgResponseTime === 0) {
+            return newLatency;
+        }
+        // 指数移动平均
+        return entry.avgResponseTime * 0.7 + newLatency * 0.3;
+    }
+    /**
+     * 修剪历史记录
+     */
+    trimHistory(entry, maxSize = 100) {
+        if (entry.history.length > maxSize) {
+            entry.history = entry.history.slice(-maxSize);
+        }
+    }
+    /**
+     * 加载数据
+     */
+    load() {
+        if ((0, fs_1.existsSync)(this.dataPath)) {
+            try {
+                const data = JSON.parse((0, fs_1.readFileSync)(this.dataPath, 'utf-8'));
+                for (const entry of data) {
+                    this.entries.set(entry.peerId, entry);
+                }
+                console.log(`[F2A Reputation] 加载了 ${this.entries.size} 条记录`);
+            }
+            catch (e) {
+                console.error('[F2A Reputation] 加载失败:', e);
+            }
+        }
+    }
+    /**
+     * 保存数据
+     */
+    save() {
+        try {
+            const data = Array.from(this.entries.values());
+            (0, fs_1.writeFileSync)(this.dataPath, JSON.stringify(data, null, 2));
+        }
+        catch (e) {
+            console.error('[F2A Reputation] 保存失败:', e);
+        }
+    }
+}
+exports.ReputationSystem = ReputationSystem;
+//# sourceMappingURL=reputation.js.map

package/dist/reputation.js.map

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

package/dist/task-guard.d.ts

@@ -0,0 +1,77 @@
+/**
+ * F2A Task Guard
+ * 轻量级任务安全检查和评审
+ */
+import type { TaskRequest, TaskAnnouncement, ReputationEntry } from './types.js';
+export interface TaskGuardRule {
+    id: string;
+    name: string;
+    description: string;
+    enabled: boolean;
+    severity: 'info' | 'warn' | 'block';
+    check: (task: TaskRequest | TaskAnnouncement, context: TaskGuardContext) => TaskGuardResult;
+}
+export interface TaskGuardContext {
+    requesterReputation?: ReputationEntry;
+    isWhitelisted: boolean;
+    isBlacklisted: boolean;
+    recentTaskCount: number;
+    config: TaskGuardConfig;
+}
+export interface TaskGuardConfig {
+    enabled: boolean;
+    requireConfirmationForDangerous: boolean;
+    maxTasksPerMinute: number;
+    blockedKeywords: string[];
+    dangerousPatterns: RegExp[];
+    minReputationForDangerous: number;
+}
+export interface TaskGuardResult {
+    passed: boolean;
+    severity: 'info' | 'warn' | 'block';
+    ruleId: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface TaskGuardReport {
+    taskId: string;
+    passed: boolean;
+    results: TaskGuardResult[];
+    warnings: TaskGuardResult[];
+    blocks: TaskGuardResult[];
+    requiresConfirmation: boolean;
+    timestamp: number;
+}
+export declare const DEFAULT_TASK_GUARD_CONFIG: TaskGuardConfig;
+export declare class TaskGuard {
+    private config;
+    private rules;
+    private recentTasks;
+    constructor(config?: Partial<TaskGuardConfig>);
+    /**
+     * 检查任务
+     */
+    check(task: TaskRequest | TaskAnnouncement, context?: Partial<TaskGuardContext>): TaskGuardReport;
+    /**
+     * 快速检查（只返回是否通过）
+     */
+    quickCheck(task: TaskRequest | TaskAnnouncement, context?: Partial<TaskGuardContext>): boolean;
+    /**
+     * 添加自定义规则
+     */
+    addRule(rule: TaskGuardRule): void;
+    /**
+     * 启用/禁用规则
+     */
+    setRuleEnabled(ruleId: string, enabled: boolean): void;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<TaskGuardConfig>): void;
+    private createDefaultRules;
+    private isDangerousTask;
+    private getRecentTaskCount;
+    private recordTask;
+}
+export declare const taskGuard: TaskGuard;
+//# sourceMappingURL=task-guard.d.ts.map

package/dist/task-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-guard.d.ts","sourceRoot":"","sources":["../src/task-guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,KAAK,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,KAAK,eAAe,CAAC;CAC7F;AAED,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,CAAC,EAAE,eAAe,CAAC;IACtC,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B,EAAE,OAAO,CAAC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,eAAO,MAAM,yBAAyB,EAAE,eAoBvC,CAAC;AAEF,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,WAAW,CAAoC;gBAE3C,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAKjD;;OAEG;IACH,KAAK,CACH,IAAI,EAAE,WAAW,GAAG,gBAAgB,EACpC,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACtC,eAAe;IAkDlB;;OAEG;IACH,UAAU,CACR,IAAI,EAAE,WAAW,GAAG,gBAAgB,EACpC,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAClC,OAAO;IAKV;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAIlC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAOtD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAMpD,OAAO,CAAC,kBAAkB;IA+M1B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,UAAU;CAKnB;AAGD,eAAO,MAAM,SAAS,WAAkB,CAAC"}