dlinkclaw-openclaw 2026.8.24-alpha.1

package/dist/src/services/services.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Claw-Services 主服务接口
+ * 为 duolian 插件提供 OpenClaw API 封装
+ */
+import EventEmitter from 'events';
+import { ClawServiceOptions, CmdMessage, CmdResponse } from './types.js';
+import { PluginLogger } from 'openclaw/plugin-sdk';
+/**
+ * Claw-Services 主类
+ * 处理 CMD 消息并调用相应的 OpenClaw API
+ */
+export declare class ClawServices extends EventEmitter {
+    private client;
+    private readonly options;
+    private isInitialized;
+    private readonly logger;
+    constructor(options: ClawServiceOptions, logger: PluginLogger);
+    log(msg: string, type: 'info' | 'warn' | 'error' | 'debug'): void;
+    /**
+     * 初始化服务
+     */
+    initialize(): Promise<boolean>;
+    /**
+     * 检查服务是否已初始化
+     */
+    isReady(): boolean;
+    /**
+     * 处理 CMD 消息
+     */
+    handleCmdMessage(cmdMessage: CmdMessage): Promise<CmdResponse>;
+    private handleAskAgent;
+    /**
+     * 更新
+     * @param agentId
+     * @param userId
+     */
+    private handleUpdateSessionModel;
+    /**
+     * 查询当前会话的模型覆盖（用于 ChatPage 恢复选中状态）
+     */
+    private handleCurrentSessionModel;
+    private handleAgentList;
+    private handleAgentCreate;
+    private handleAgentUpdate;
+    private handleAgentDelete;
+    private handleAgentGet;
+    private handleTaskList;
+    private handleTaskCreate;
+    private handleTaskUpdate;
+    private handleTaskDelete;
+    private handleTaskRun;
+    private handleStatusHealth;
+    private handleStatusSystem;
+    private handleStatusUsage;
+    private handleListModels;
+    private handleSessionList;
+    private handleSessionGet;
+    private handleSessionsDescribe;
+    private handleSessionsResolve;
+    /**
+     * 创建新会话
+     * sessionKey: agent:<agentId>:<channelId>-<suffix>:<chatType>:<userId>
+     * 例: agent:main:workrelay-00001:direct:I35916630580137984
+     */
+    private handleSessionCreate;
+    /**
+     * 归档会话
+     * 入参: { sessionKey }
+     * - sessionKey: 完整的 sessionKey，如 "agent:main:workrelay-00001:direct:i35916630580137984"
+     */
+    private handleSessionArchive;
+    /**
+     * 恢复（取消归档）会话
+     * 入参: { sessionKey }
+     * - sessionKey: 完整的 sessionKey
+     */
+    private handleSessionRestore;
+    /**
+     * 删除会话
+     * 入参: { sessionKey, deleteFiles? }
+     * - sessionKey:  完整的 sessionKey
+     * - deleteFiles: 是否同时删除会话相关文件（可选，默认 false）
+     */
+    private handleSessionDelete;
+    private handleSessionReset;
+    private handleChatHistories;
+    private handleSkillsStatus;
+    private handleSkillsSearch;
+    private handleSkillDetail;
+    private handleSkillInstall;
+    private handleSkillUpdate;
+    private handleSkillsSecurityVerdicts;
+    private handleUsageCost;
+    private handleSessionsUsage;
+    private handleSessionsUsageLogs;
+    /**
+     * 取消当前Agent执行，通过Gateway /queue interrupt 中断活跃run
+     */
+    private handleCancelMessage;
+    /**
+     * 强制停止当前Agent run（/stop，比 /queue interrupt 更快）
+     * 新增 cmd 通道 agent.stop 指令
+     */
+    private handleStopAgent;
+    private handlChatAbout;
+    private handleApprove;
+    /** artifacts.list - 列出会话工件 */
+    handleArtifactsList(cmdMessage: CmdMessage): Promise<any>;
+    /** artifacts.get - 获取单个工件详情 */
+    handleArtifactsGet(cmdMessage: CmdMessage): Promise<any>;
+    /** artifacts.download - 下载工件 */
+    handleArtifactsDownload(cmdMessage: CmdMessage): Promise<any>;
+    /** agents.files.list - 列出 Agent 工作区文件 */
+    handleAgentFilesList(cmdMessage: CmdMessage): Promise<any>;
+    /** agents.files.get - 获取工作区文件内容 */
+    handleAgentFilesGet(cmdMessage: CmdMessage): Promise<any>;
+    /**
+     * extCapabilities.status - 查询扩展能力安装状态
+     * params: { name: 'workrelay-speak' | 'workrelay-transcribe' }
+     * 执行 ext_capabilities/<name>/status.sh，返回 JSON 供客户端展示
+     */
+    handleExtCapabilityStatus(params: Record<string, any>): Promise<any>;
+    /**
+     * 2026-08-10 检测指定扩展能力的安装进程是否真实在跑（存活检测）
+     * 注意：不能用 pgrep -f "...install.sh" —— 该命令经 bash -c 执行时，bash 进程
+     * 自身命令行包含 install.sh 字符串，pgrep 会永远自匹配，导致 installing 恒为 true。
+     * 改用 ps + grep 方括号技巧（grep 自身命令行不含字面 install.sh，不会自匹配）。
+     */
+    private isExtCapabilityInstalling;
+    /**
+     * extCapabilities.check - 检查扩展能力安装前置条件
+     * params: { name: 'workrelay-speak' | 'workrelay-transcribe' }
+     * 读取 ext_capabilities/<name>/manifest.json，逐条执行 requirements[].check（shell 表达式），
+     * exit 0 = 条件满足。返回每条条件是否满足，客户端据此展示"安装条件"清单。
+     * 2026-08-11 新增：通用适配——每个能力自带前置条件清单，用户安装前即可看到环境是否满足。
+     */
+    handleExtCapabilityCheck(params: Record<string, any>): Promise<any>;
+    /**
+     * extCapabilities.install - 安装扩展能力（长任务，后台执行）
+     * params: { name: 'workrelay-speak' | 'workrelay-transcribe' }
+     * install.sh 可能需要 5-15 分钟（下载模型），后台 spawn 立即返回"已开始"，
+     * 客户端通过轮询 extCapabilities.status 感知进度
+     */
+    handleExtCapabilityInstall(params: Record<string, any>): Promise<any>;
+    /**
+     * 2026-08-10 读取日志文件尾部内容（供安装失败报错）
+     */
+    private readLogTail;
+    private formatUptime;
+    cleanup(): void;
+}
+export default ClawServices;