@f2a/openclaw-f2a 0.3.3 → 0.3.4

package/dist/F2ACore.d.ts

@@ -0,0 +1,227 @@
+/**
+ * F2A 核心生命周期管理
+ *
+ * 负责 F2A 插件的初始化、启用和关闭。
+ * 从 connector.ts 拆分（Issue #106），遵循单一职责原则。
+ *
+ * Phase 3 扩展：支持 Daemon 模式
+ * - embedded: 直接创建 F2A 实例（默认）
+ * - daemon: 通过 F2AClient 连接到独立 Daemon
+ *
+ * @module F2ACore
+ */
+import type { ApiLogger, F2APluginConfig, F2ANodeConfig, OpenClawPluginApi, AgentCapability } from './types.js';
+import { WebhookServer } from './webhook-server.js';
+import { WebhookPusher } from './webhook-pusher.js';
+import { F2A } from '@f2a/network';
+import { F2AClient } from './f2a-client.js';
+import type { F2AComponentRegistry } from './F2AComponentRegistry.js';
+import type { WebhookHandler } from './webhook-server.js';
+/**
+ * 运行模式
+ */
+export type F2ARunMode = 'embedded' | 'daemon';
+/**
+ * 核心生命周期配置
+ */
+export interface CoreLifecycleConfig {
+    /** 插件配置 */
+    pluginConfig: F2APluginConfig;
+    /** 节点配置 */
+    nodeConfig: F2ANodeConfig;
+    /** OpenClaw API */
+    api?: OpenClawPluginApi;
+    /** Logger */
+    logger?: ApiLogger;
+}
+/**
+ * 核心生命周期状态
+ */
+export interface CoreLifecycleState {
+    /** 是否已初始化 */
+    initialized: boolean;
+    /** F2A 实例 (embedded 模式) */
+    f2a?: F2A;
+    /** F2A 客户端 (daemon 模式) */
+    f2aClient?: F2AClient;
+    /** 运行模式 */
+    runMode: F2ARunMode;
+    /** F2A 启动时间 */
+    f2aStartTime?: number;
+    /** Webhook 服务器 */
+    webhookServer?: WebhookServer;
+    /** Webhook 推送器 */
+    webhookPusher?: WebhookPusher;
+    /** 轮询定时器 */
+    pollTimer?: NodeJS.Timeout;
+    /** 能力列表 */
+    capabilities: AgentCapability[];
+}
+/**
+ * 消息回调（用于处理 P2P 消息）
+ */
+export interface MessageCallback {
+    (msg: {
+        from: string;
+        content: string;
+        metadata?: Record<string, unknown>;
+        messageId: string;
+    }): Promise<void>;
+}
+/**
+ * F2A 核心生命周期管理器
+ *
+ * 功能：
+ * 1. 初始化配置和基本组件
+ * 2. 启动 F2A 实例和 Webhook 服务器
+ * 3. 处理清理和关闭
+ */
+export declare class F2ACore {
+    private config;
+    private nodeConfig;
+    private api?;
+    private logger?;
+    private state;
+    private onMessageCallback?;
+    private componentRegistry?;
+    constructor(config: CoreLifecycleConfig);
+    /**
+     * 获取插件配置
+     */
+    getConfig(): F2APluginConfig;
+    /**
+     * 获取节点配置
+     */
+    getNodeConfig(): F2ANodeConfig;
+    /**
+     * 获取 OpenClaw API
+     */
+    getApi(): OpenClawPluginApi | undefined;
+    /**
+     * 获取 Logger
+     */
+    getLogger(): ApiLogger | undefined;
+    /**
+     * 更新 Logger
+     */
+    updateLogger(logger: ApiLogger | undefined): void;
+    /**
+     * 设置组件注册器引用
+     */
+    setComponentRegistry(registry: F2AComponentRegistry): void;
+    /**
+     * 检查是否已初始化
+     */
+    isInitialized(): boolean;
+    /**
+     * 获取 F2A 实例
+     */
+    getF2A(): F2A | undefined;
+    /**
+     * 获取 F2A 客户端（daemon 模式）
+     */
+    getF2AClient(): F2AClient | undefined;
+    /**
+     * 获取运行模式
+     */
+    getRunMode(): F2ARunMode;
+    /**
+     * 是否为 Daemon 模式
+     */
+    isDaemonMode(): boolean;
+    /**
+     * 获取 F2A 状态
+     */
+    getF2AStatus(): {
+        running: boolean;
+        peerId?: string;
+        uptime?: number;
+        mode: F2ARunMode;
+    };
+    /**
+     * 获取能力列表
+     */
+    getCapabilities(): AgentCapability[];
+    /**
+     * 获取 Webhook 服务器 URL
+     */
+    getWebhookUrl(): string | undefined;
+    /**
+     * 初始化插件（延迟模式）
+     *
+     * 只保存配置，不打开任何资源。
+     * TaskQueue/WebhookServer 在首次访问时才初始化。
+     */
+    initialize(rawConfig: Record<string, unknown> & {
+        _api?: OpenClawPluginApi;
+    }): Promise<void>;
+    /**
+     * 启用适配器
+     *
+     * 根据配置选择运行模式：
+     * - embedded: 直接创建 F2A 实例（默认）
+     * - daemon: 通过 F2AClient 连接到独立 Daemon
+     *
+     * @param webhookHandler - Webhook 处理器
+     * @param onMessage - P2P 消息回调
+     */
+    enable(webhookHandler: WebhookHandler, onMessage: MessageCallback): Promise<void>;
+    /**
+     * 确定运行模式
+     */
+    private determineRunMode;
+    /**
+     * 启动 Daemon 模式
+     */
+    private startDaemonMode;
+    /**
+     * 尝试启动本地 Daemon
+     */
+    private tryStartLocalDaemon;
+    /**
+     * 启动 Daemon 消息轮询
+     */
+    private startDaemonMessagePolling;
+    /**
+     * 启动 Embedded 模式
+     */
+    private startEmbeddedMode;
+    /**
+     * 创建并启动 F2A 实例
+     */
+    private startF2AInstance;
+    /**
+     * 启动 Webhook 服务器
+     */
+    private startWebhookServer;
+    /**
+     * 启动兜底轮询
+     */
+    private startFallbackPolling;
+    /**
+     * 重置超时的 processing 任务
+     */
+    private resetTimedOutProcessingTasks;
+    /**
+     * 注册清理处理器
+     */
+    private registerCleanupHandlers;
+    /**
+     * 关闭所有资源
+     */
+    shutdown(): Promise<void>;
+    /**
+     * 获取数据目录
+     */
+    private getDataDir;
+    /**
+     * 获取 Webhook 推送器
+     */
+    getWebhookPusher(): WebhookPusher | undefined;
+    /**
+     * 触发心跳（用于通知 OpenClaw 有新任务）
+     */
+    requestHeartbeat(): void;
+}
+export default F2ACore;
+//# sourceMappingURL=F2ACore.d.ts.map

package/dist/F2ACore.d.ts.map

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