@f2a/openclaw-f2a 0.2.24 → 0.3.0

package/dist/connector.d.ts

@@ -8,6 +8,19 @@
  * - 这种方式更简洁，避免了 HTTP + CLI 的复杂性
  */
 import type { OpenClawPlugin, OpenClawPluginApi, Tool, F2APluginConfig, AgentInfo } from './types.js';
+/**
+ * P1-6: 验证 PeerID 格式
+ * @param peerId - 待验证的 Peer ID
+ * @returns 是否为有效的 libp2p Peer ID 格式
+ */
+export declare function isValidPeerId(peerId: string | undefined | null): peerId is string;
+/** OpenClaw API Logger 类型 */
+export interface ApiLogger {
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    debug?(message: string, ...args: unknown[]): void;
+}
 /** 广播结果类型 */
 interface BroadcastResult {
     agent: string;
@@ -31,6 +44,13 @@ export declare class F2AOpenClawAdapter implements OpenClawPlugin {
     private _f2a?;
     private _toolHandlers?;
     private _claimHandlers?;
+    private _contactManager?;
+    private _handshakeProtocol?;
+    private _processedMessageHashes;
+    /** P1-3: 消息去重缓存最大条目数 */
+    private static readonly MAX_MESSAGE_HASH_CACHE_SIZE;
+    /** P1-3: 消息去重缓存条目最大存活时间（毫秒） */
+    private static readonly MESSAGE_HASH_TTL_MS;
     private config;
     private nodeConfig;
     private capabilities;
@@ -43,10 +63,39 @@ export declare class F2AOpenClawAdapter implements OpenClawPlugin {
     private get nodeManager();
     /**
      * 获取默认的 F2A 数据目录
-     * 优先级：workspace/.f2a > ~/.f2a（兼容旧版本）
-     * 注意：config.dataDir 的处理在 mergeConfig() 中，这里只处理未配置的情况
+     *
+     * 优先级：
+     * 1. config.dataDir（用户显式配置）
+     * 2. workspace/.f2a（agent workspace 目录）
+     * 3. ~/.f2a（兼容旧版本）
+     *
+     * 安全：
+     * - P0-1: 验证 workspace 路径，防止路径遍历攻击
+     * - P1-1: 优先检查 config.dataDir
      */
     private getDefaultDataDir;
+    /**
+     * P1-2, P1-5, P1-3: 检测是否为回声消息（避免循环）
+     *
+     * 使用多层验证策略：
+     * 1. 检查 metadata 中的特定标记（不仅仅是 type === 'reply'）
+     * 2. 检查消息来源可信度
+     * 3. 检查消息内容的特殊标记
+     * 4. P1-3: 基于消息内容哈希的去重机制（防止恶意绕过）
+     *
+     * @param msg - 接收到的消息
+     * @returns 是否为应该跳过的回声消息
+     */
+    private isEchoMessage;
+    /**
+     * P1-3: 计算消息内容哈希
+     * 用于基于内容的去重
+     */
+    private computeMessageHash;
+    /**
+     * P1-3: 清理过期的消息哈希缓存
+     */
+    private cleanupMessageHashCache;
     /**
      * 获取网络客户端（懒加载）
      * 新架构：直接使用 F2A 实例的方法，不再通过 HTTP
@@ -81,6 +130,15 @@ export declare class F2AOpenClawAdapter implements OpenClawPlugin {
      * 获取认领处理器（延迟初始化）
      */
     private get claimHandlers();
+    /**
+     * Issue #98: 获取联系人管理器（延迟初始化）
+     */
+    private get contactManager();
+    /**
+     * Issue #99: 获取握手协议处理器（延迟初始化）
+     * 依赖 F2A 实例和 ContactManager
+     */
+    private get handshakeProtocol();
     /**
      * 检查是否已初始化（用于判断是否需要启动服务）
      */
@@ -207,6 +265,30 @@ export declare class F2AOpenClawAdapter implements OpenClawPlugin {
      * 解析 Agent 引用（公共方法，供测试和外部调用）
      */
     resolveAgent(agentRef: string): Promise<AgentInfo | null>;
+    /**
+     * 处理通讯录工具
+     */
+    private handleContacts;
+    /**
+     * 处理分组管理工具
+     */
+    private handleContactGroups;
+    /**
+     * 处理好友请求工具
+     */
+    private handleFriendRequest;
+    /**
+     * 处理待处理请求工具
+     */
+    private handlePendingRequests;
+    /**
+     * 处理导出通讯录工具
+     */
+    private handleContactsExport;
+    /**
+     * 处理导入通讯录工具
+     */
+    private handleContactsImport;
     /**
      * 关闭插件，清理资源
      * 只清理已初始化的资源

package/dist/connector.d.ts.map

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