@f2a/openclaw-adapter 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,248 @@
+/**
+ * F2A OpenClaw Connector - Core Types
+ */
+export interface OpenClawPlugin {
+    name: string;
+    version: string;
+    initialize(config: Record<string, unknown>): Promise<void>;
+    getTools(): Tool[];
+    shutdown?(): Promise<void>;
+    onEvent?(event: string, payload: unknown): Promise<void>;
+}
+export interface OpenClawPluginApi {
+    id: string;
+    name: string;
+    version?: string;
+    description?: string;
+    source: string;
+    config: Record<string, unknown>;
+    pluginConfig?: Record<string, unknown>;
+    runtime: {
+        version: string;
+        config: {
+            loadConfig: (path?: string) => Promise<Record<string, unknown>>;
+            writeConfigFile: (path: string, config: unknown) => Promise<void>;
+        };
+        system: {
+            enqueueSystemEvent: (event: string, payload?: unknown) => void;
+            requestHeartbeatNow: () => void;
+            runCommandWithTimeout: (command: string, timeoutMs: number) => Promise<{
+                stdout: string;
+                stderr: string;
+            }>;
+        };
+        media: {
+            loadWebMedia: (url: string) => Promise<Buffer>;
+            detectMime: (data: Buffer) => string;
+        };
+        tts: {
+            textToSpeechTelephony: (options: {
+                text: string;
+                cfg: unknown;
+            }) => Promise<{
+                audio: Buffer;
+                sampleRate: number;
+            }>;
+        };
+        stt: {
+            transcribeAudioFile: (options: {
+                filePath: string;
+                cfg: unknown;
+                mime?: string;
+            }) => Promise<{
+                text?: string;
+            }>;
+        };
+        logging: {
+            shouldLogVerbose: () => boolean;
+            getChildLogger: (bindings?: Record<string, unknown>) => unknown;
+        };
+    };
+    logger: {
+        debug?: (message: string) => void;
+        info: (message: string) => void;
+        warn: (message: string) => void;
+        error: (message: string) => void;
+    };
+    registerTool?: (tool: unknown, opts?: {
+        optional?: boolean;
+    }) => void;
+    registerService?: (service: {
+        id: string;
+        start: () => void | Promise<void>;
+        stop?: () => void | Promise<void>;
+    }) => void;
+}
+export interface Tool {
+    name: string;
+    description: string;
+    parameters: Record<string, ParameterSchema>;
+    handler: (params: any, context: SessionContext) => Promise<ToolResult>;
+}
+export interface ParameterSchema {
+    type: string;
+    description: string;
+    required?: boolean;
+    enum?: string[];
+}
+export interface SessionContext {
+    sessionId: string;
+    workspace: string;
+    toJSON(): Record<string, unknown>;
+}
+export interface ToolResult {
+    content: string;
+    data?: unknown;
+}
+export interface F2ANodeConfig {
+    nodePath: string;
+    controlPort: number;
+    controlToken: string;
+    p2pPort: number;
+    enableMDNS: boolean;
+    bootstrapPeers: string[];
+}
+export interface F2APluginConfig {
+    autoStart: boolean;
+    webhookPort: number;
+    agentName: string;
+    capabilities: string[];
+    f2aPath?: string;
+    controlPort?: number;
+    controlToken?: string;
+    p2pPort?: number;
+    enableMDNS?: boolean;
+    bootstrapPeers?: string[];
+    dataDir?: string;
+    maxQueuedTasks?: number;
+    reputation?: ReputationConfig;
+    security?: SecurityConfig;
+}
+export interface ReputationConfig {
+    enabled: boolean;
+    initialScore: number;
+    minScoreForService: number;
+    decayRate: number;
+}
+export interface SecurityConfig {
+    requireConfirmation: boolean;
+    whitelist: string[];
+    blacklist: string[];
+    maxTasksPerMinute: number;
+}
+export interface AgentInfo {
+    peerId: string;
+    displayName: string;
+    agentType: string;
+    version: string;
+    capabilities: AgentCapability[];
+    multiaddrs: string[];
+    lastSeen: number;
+    reputation?: number;
+}
+export interface AgentCapability {
+    name: string;
+    description: string;
+    tools?: string[];
+    parameters?: Record<string, ParameterSchema>;
+}
+export interface PeerInfo {
+    peerId: string;
+    agentInfo?: AgentInfo;
+    multiaddrs: string[];
+    connected: boolean;
+    reputation: number;
+    lastSeen: number;
+}
+export interface TaskRequest {
+    taskId: string;
+    taskType: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+    from: string;
+    timestamp: number;
+    timeout: number;
+}
+export interface TaskResponse {
+    taskId: string;
+    status: 'success' | 'error' | 'rejected' | 'timeout';
+    result?: unknown;
+    error?: string;
+    latency?: number;
+}
+export interface DelegateOptions {
+    peerId: string;
+    taskType: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+    timeout?: number;
+}
+export interface WebhookEvent {
+    type: 'discover' | 'delegate' | 'status' | 'reputation_update';
+    payload: unknown;
+    timestamp: number;
+    signature?: string;
+}
+export interface DiscoverWebhookPayload {
+    query: {
+        capability?: string;
+        minReputation?: number;
+    };
+    requester: string;
+}
+export interface DelegateWebhookPayload extends TaskRequest {
+}
+export interface Result<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+export interface ReputationEntry {
+    peerId: string;
+    score: number;
+    successfulTasks: number;
+    failedTasks: number;
+    totalTasks: number;
+    avgResponseTime: number;
+    lastInteraction: number;
+    history: ReputationEvent[];
+}
+export interface ReputationEvent {
+    type: 'task_success' | 'task_failure' | 'task_rejected' | 'timeout' | 'malicious';
+    taskId?: string;
+    delta: number;
+    timestamp: number;
+    reason?: string;
+}
+export interface TaskAnnouncement {
+    announcementId: string;
+    taskType: string;
+    description: string;
+    requiredCapabilities?: string[];
+    estimatedComplexity?: number;
+    reward?: number;
+    timeout: number;
+    from: string;
+    timestamp: number;
+    status: 'open' | 'claimed' | 'delegated' | 'expired';
+    claims?: TaskClaim[];
+}
+export interface TaskClaim {
+    claimId: string;
+    announcementId: string;
+    claimant: string;
+    claimantName?: string;
+    estimatedTime?: number;
+    confidence?: number;
+    timestamp: number;
+    status: 'pending' | 'accepted' | 'rejected';
+}
+export interface ClaimWebhookPayload {
+    announcementId: string;
+    claimId: string;
+    claimant: string;
+    claimantName?: string;
+    estimatedTime?: number;
+    confidence?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * F2A OpenClaw Connector - Core Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/webhook-server.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Webhook Server
+ * 接收 F2A Node 的事件通知
+ */
+import type { DiscoverWebhookPayload, DelegateWebhookPayload, AgentCapability } from './types.js';
+export interface WebhookHandler {
+    onDiscover(payload: DiscoverWebhookPayload): Promise<{
+        capabilities: AgentCapability[];
+        reputation?: number;
+    }>;
+    onDelegate(payload: DelegateWebhookPayload): Promise<{
+        accepted: boolean;
+        taskId: string;
+        reason?: string;
+    }>;
+    onStatus(): Promise<{
+        status: 'available' | 'busy' | 'offline';
+        load?: number;
+    }>;
+}
+export declare class WebhookServer {
+    private port;
+    private handler;
+    private server?;
+    constructor(port: number, handler: WebhookHandler);
+    /**
+     * 启动 Webhook 服务器
+     */
+    start(): Promise<void>;
+    /**
+     * 停止 Webhook 服务器
+     */
+    stop(): Promise<void>;
+    /**
+     * 处理 HTTP 请求
+     */
+    private handleRequest;
+    /**
+     * 解析请求体
+     */
+    private parseBody;
+    getUrl(): string;
+}
+//# sourceMappingURL=webhook-server.d.ts.map

package/dist/webhook-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-server.d.ts","sourceRoot":"","sources":["../src/webhook-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAEV,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;QACnD,YAAY,EAAE,eAAe,EAAE,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IAEH,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;QACnD,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IAEH,QAAQ,IAAI,OAAO,CAAC;QAClB,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;QACzC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAC,CAAkC;gBAErC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;IAKjD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B;;OAEG;YACW,aAAa;IAyD3B;;OAEG;IACH,OAAO,CAAC,SAAS;IAoBjB,MAAM,IAAI,MAAM;CAGjB"}

package/dist/webhook-server.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * Webhook Server
+ * 接收 F2A Node 的事件通知
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookServer = void 0;
+const http_1 = require("http");
+class WebhookServer {
+    port;
+    handler;
+    server;
+    constructor(port, handler) {
+        this.port = port;
+        this.handler = handler;
+    }
+    /**
+     * 启动 Webhook 服务器
+     */
+    async start() {
+        return new Promise((resolve, reject) => {
+            this.server = (0, http_1.createServer)(this.handleRequest.bind(this));
+            this.server.listen(this.port, () => {
+                console.log(`[F2A Webhook] 服务器启动在端口 ${this.port}`);
+                resolve();
+            });
+            this.server.on('error', (err) => {
+                reject(err);
+            });
+        });
+    }
+    /**
+     * 停止 Webhook 服务器
+     */
+    async stop() {
+        if (this.server) {
+            return new Promise((resolve) => {
+                this.server?.close(() => {
+                    console.log('[F2A Webhook] 服务器已停止');
+                    resolve();
+                });
+            });
+        }
+    }
+    /**
+     * 处理 HTTP 请求
+     */
+    async handleRequest(req, res) {
+        // 设置 CORS
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'POST, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+        if (req.method === 'OPTIONS') {
+            res.writeHead(200);
+            res.end();
+            return;
+        }
+        if (req.method !== 'POST') {
+            res.writeHead(405, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Method not allowed' }));
+            return;
+        }
+        try {
+            const body = await this.parseBody(req);
+            const event = body;
+            console.log(`[F2A Webhook] 收到事件: ${event.type}`);
+            let result;
+            switch (event.type) {
+                case 'discover':
+                    result = await this.handler.onDiscover(event.payload);
+                    break;
+                case 'delegate':
+                    result = await this.handler.onDelegate(event.payload);
+                    break;
+                case 'status':
+                    result = await this.handler.onStatus();
+                    break;
+                default:
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: `Unknown event type: ${event.type}` }));
+                    return;
+            }
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(result));
+        }
+        catch (error) {
+            console.error('[F2A Webhook] 处理错误:', error);
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                error: error instanceof Error ? error.message : 'Internal error'
+            }));
+        }
+    }
+    /**
+     * 解析请求体
+     */
+    parseBody(req) {
+        return new Promise((resolve, reject) => {
+            let body = '';
+            req.on('data', (chunk) => {
+                body += chunk.toString();
+            });
+            req.on('end', () => {
+                try {
+                    resolve(JSON.parse(body));
+                }
+                catch (e) {
+                    reject(new Error('Invalid JSON'));
+                }
+            });
+            req.on('error', reject);
+        });
+    }
+    getUrl() {
+        return `http://localhost:${this.port}/webhook`;
+    }
+}
+exports.WebhookServer = WebhookServer;
+//# sourceMappingURL=webhook-server.js.map

package/dist/webhook-server.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,106 @@
+{
+  "id": "f2a-openclaw-adapter",
+  "name": "F2A OpenClaw Adapter",
+  "description": "OpenClaw adapter for F2A P2P Agent network",
+  "version": "0.2.0",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "f2aPath": {
+        "type": "string",
+        "description": "Path to F2A installation",
+        "default": "~/projects/F2A"
+      },
+      "autoStart": {
+        "type": "boolean",
+        "description": "Automatically start F2A node",
+        "default": true
+      },
+      "webhookPort": {
+        "type": "number",
+        "description": "Port for webhook server",
+        "default": 9002
+      },
+      "controlPort": {
+        "type": "number",
+        "description": "Port for F2A control API",
+        "default": 9001
+      },
+      "controlToken": {
+        "type": "string",
+        "description": "Auth token for F2A control API (auto-generated if not provided)",
+        "sensitive": true
+      },
+      "p2pPort": {
+        "type": "number",
+        "description": "Port for P2P network",
+        "default": 9000
+      },
+      "enableMDNS": {
+        "type": "boolean",
+        "description": "Enable mDNS discovery",
+        "default": true
+      },
+      "bootstrapPeers": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Bootstrap peer addresses",
+        "default": []
+      },
+      "agentName": {
+        "type": "string",
+        "description": "Display name for this agent",
+        "default": "OpenClaw Agent"
+      },
+      "capabilities": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Custom capabilities to advertise",
+        "default": []
+      },
+      "dataDir": {
+        "type": "string",
+        "description": "Directory for plugin data",
+        "default": "./f2a-data"
+      },
+      "maxQueuedTasks": {
+        "type": "number",
+        "description": "Maximum number of tasks to queue",
+        "default": 100
+      },
+      "reputation": {
+        "type": "object",
+        "properties": {
+          "enabled": { "type": "boolean", "default": true },
+          "initialScore": { "type": "number", "default": 50 },
+          "minScoreForService": { "type": "number", "default": 20 },
+          "decayRate": { "type": "number", "default": 0.01 }
+        }
+      },
+      "security": {
+        "type": "object",
+        "properties": {
+          "requireConfirmation": { "type": "boolean", "default": false },
+          "whitelist": { "type": "array", "items": { "type": "string" }, "default": [] },
+          "blacklist": { "type": "array", "items": { "type": "string" }, "default": [] },
+          "maxTasksPerMinute": { "type": "number", "default": 10 }
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "f2aPath": { "label": "F2A Path", "placeholder": "~/projects/F2A" },
+    "autoStart": { "label": "Auto Start F2A Node" },
+    "webhookPort": { "label": "Webhook Port" },
+    "controlPort": { "label": "Control Port" },
+    "controlToken": { "label": "Control Token", "sensitive": true },
+    "p2pPort": { "label": "P2P Port" },
+    "enableMDNS": { "label": "Enable mDNS Discovery" },
+    "bootstrapPeers": { "label": "Bootstrap Peers", "placeholder": ["/ip4/..."] },
+    "agentName": { "label": "Agent Display Name" },
+    "capabilities": { "label": "Custom Capabilities" },
+    "dataDir": { "label": "Data Directory" },
+    "maxQueuedTasks": { "label": "Max Queued Tasks" }
+  }
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@f2a/openclaw-adapter",
+  "version": "0.1.0",
+  "description": "OpenClaw adapter for F2A P2P Agent network",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "openclaw": {
+    "extensions": ["./dist/plugin.js"]
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "lint": "eslint src/**/*.ts"
+  },
+  "keywords": ["openclaw", "f2a", "p2p", "agent", "plugin"],
+  "author": "F2A Team",
+  "license": "MIT",
+  "dependencies": {
+    "@f2a/network": "file:../..",
+    "ws": "^8.16.0",
+    "node-fetch": "^3.3.2",
+    "zod": "^3.22.4",
+    "better-sqlite3": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/ws": "^8.5.10",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=1.0.0"
+  }
+}