@f2a/openclaw-f2a 0.2.20

package/dist/tool-handlers.d.ts

@@ -0,0 +1,158 @@
+/**
+ * F2A OpenClaw Connector - Tool Handlers
+ * 工具处理器模块 - 处理 f2a_discover, f2a_delegate 等工具
+ */
+import type { SessionContext, ToolResult } from './types.js';
+import type { F2AOpenClawAdapter } from './connector.js';
+import type { RiskFlag } from '@f2a/network';
+/**
+ * 工具处理器参数类型
+ */
+export interface ToolHandlerParams {
+    discover: {
+        capability?: string;
+        min_reputation?: number;
+    };
+    delegate: {
+        agent: string;
+        task: string;
+        context?: string;
+        timeout?: number;
+    };
+    broadcast: {
+        capability: string;
+        task: string;
+        min_responses?: number;
+    };
+    reputation: {
+        action: string;
+        peer_id?: string;
+    };
+    pollTasks: {
+        limit?: number;
+        status?: 'pending' | 'processing' | 'completed' | 'failed';
+    };
+    submitResult: {
+        task_id: string;
+        result: string;
+        status: 'success' | 'error';
+    };
+    estimateTask: {
+        task_type: string;
+        description: string;
+        required_capabilities?: string[];
+    };
+    reviewTask: {
+        task_id: string;
+        workload: number;
+        value: number;
+        risk_flags?: RiskFlag[];
+        comment?: string;
+    };
+    getReviews: {
+        task_id: string;
+    };
+    getCapabilities: {
+        peer_id?: string;
+        agent_name?: string;
+    };
+}
+/**
+ * 任务评估结果
+ */
+export interface TaskEstimation {
+    /** 工作量 (0-100) */
+    workload: number;
+    /** 复杂度 (1-10) */
+    complexity: number;
+    /** 预估时间（毫秒） */
+    estimated_time_ms: number;
+    /** 置信度 (0-1) */
+    confidence: number;
+}
+/**
+ * 工具处理器类
+ * 包含所有核心工具的处理逻辑
+ */
+export declare class ToolHandlers {
+    private adapter;
+    constructor(adapter: F2AOpenClawAdapter);
+    /**
+     * 处理 f2a_discover 工具
+     * 发现 F2A 网络中的 Agents
+     */
+    handleDiscover(params: ToolHandlerParams['discover'], context: SessionContext): Promise<ToolResult>;
+    /**
+     * 处理 f2a_delegate 工具
+     * 委托任务给特定 Agent
+     */
+    handleDelegate(params: ToolHandlerParams['delegate'], context: SessionContext): Promise<ToolResult>;
+    /**
+     * 处理 f2a_broadcast 工具
+     * 广播任务给所有具备某能力的 Agents
+     */
+    handleBroadcast(params: ToolHandlerParams['broadcast'], context: SessionContext): Promise<ToolResult>;
+    /**
+     * 处理 f2a_status 工具
+     * 查看网络状态
+     */
+    handleStatus(params: {}, context: SessionContext): Promise<ToolResult>;
+    /**
+     * 处理 f2a_reputation 工具
+     * 查看或管理 Peer 信誉
+     */
+    handleReputation(params: ToolHandlerParams['reputation'], context: SessionContext): Promise<ToolResult>;
+    /**
+     * 处理 f2a_poll_tasks 工具
+     * 查询任务队列
+     */
+    handlePollTasks(params: ToolHandlerParams['pollTasks'], context: SessionContext): Promise<ToolResult>;
+    /**
+     * 处理 f2a_submit_result 工具
+     * 提交任务结果
+     */
+    handleSubmitResult(params: ToolHandlerParams['submitResult'], context: SessionContext): Promise<ToolResult>;
+    /**
+     * 处理 f2a_task_stats 工具
+     * 查看任务队列统计
+     */
+    handleTaskStats(params: {}, context: SessionContext): Promise<ToolResult>;
+    /**
+     * 解析 Agent 引用
+     */
+    private resolveAgent;
+    /**
+     * 格式化广播结果
+     */
+    private formatBroadcastResults;
+    /**
+     * 处理 f2a_estimate_task 工具
+     * 评估任务成本
+     */
+    handleEstimateTask(params: ToolHandlerParams['estimateTask'], context: SessionContext): Promise<ToolResult>;
+    /**
+     * 处理 f2a_review_task 工具
+     * 作为评审者评审任务
+     */
+    handleReviewTask(params: ToolHandlerParams['reviewTask'], context: SessionContext): Promise<ToolResult>;
+    /**
+     * 处理 f2a_get_reviews 工具
+     * 获取任务的评审结果
+     */
+    handleGetReviews(params: ToolHandlerParams['getReviews'], context: SessionContext): Promise<ToolResult>;
+    /**
+     * 处理 f2a_get_capabilities 工具
+     * 获取指定 Agent 的能力列表
+     */
+    handleGetCapabilities(params: ToolHandlerParams['getCapabilities'], context: SessionContext): Promise<ToolResult>;
+    /**
+     * 估算任务复杂度
+     * 基于任务类型、描述和所需能力进行估算
+     */
+    private estimateTaskComplexity;
+    /**
+     * 格式化持续时间
+     */
+    private formatDuration;
+}
+//# sourceMappingURL=tool-handlers.d.ts.map

package/dist/tool-handlers.d.ts.map

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