dlinkclaw-openclaw 2026.8.24-alpha.1

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

@@ -0,0 +1,391 @@
+/**
+ * OpenClaw Gateway API 类型定义
+ * 用于 duolian 插件中的 claw-services
+ */
+import { OpenClawConfig } from "openclaw/plugin-sdk";
+export interface ErrorShape {
+    code: string;
+    message: string;
+    details?: unknown;
+    retryable?: boolean;
+    retryAfterMs?: number;
+}
+export interface RequestFrame {
+    type: "req";
+    id: string;
+    method: string;
+    params?: unknown;
+}
+export interface ResponseFrame {
+    type: "res";
+    id: string;
+    ok: boolean;
+    payload?: unknown;
+    error?: ErrorShape;
+}
+export interface EventFrame {
+    type: "event";
+    event: string;
+    payload?: unknown;
+    seq?: number;
+    stateVersion?: number;
+}
+export interface AgentIdentity {
+    name?: string;
+    theme?: string;
+    emoji?: string;
+    avatar?: string;
+    avatarUrl?: string;
+}
+export interface AgentModelConfig {
+    primary?: string;
+    fallbacks?: string[];
+}
+export interface AgentInfo {
+    id: string;
+    name?: string;
+    identity?: AgentIdentity;
+    workspace?: string;
+    model?: AgentModelConfig;
+}
+export interface AgentsListResponse {
+    defaultId: string;
+    mainKey: string;
+    scope: "per-sender" | "global";
+    agents: AgentInfo[];
+}
+export interface AskAgentParams {
+    agentId: string;
+    message: string;
+    sessionKey: string;
+    deliver?: false;
+}
+export interface AskAgentReply {
+    runId: string;
+    stream: 'lifecycle' | 'assistant';
+    data: Record<string, any>;
+    sessionKey: string;
+    seq: number;
+    ts: number;
+    spawnedBy?: string;
+}
+export interface AgentCreateParams {
+    name: string;
+    workspace?: string;
+    emoji?: string;
+    avatar?: string;
+}
+export interface AgentCreateResponse {
+    ok: boolean;
+    agentId: string;
+    name: string;
+    workspace: string;
+}
+export interface AgentUpdateParams {
+    agentId: string;
+    name?: string;
+    workspace?: string;
+    model?: string;
+    avatar?: string;
+}
+export interface AgentUpdateResponse {
+    ok: boolean;
+    agentId: string;
+}
+export interface AgentDeleteParams {
+    agentId: string;
+    deleteFiles?: boolean;
+}
+export interface AgentDeleteResponse {
+    ok: boolean;
+}
+export interface CronState {
+    nextRunAtMs: number;
+    lastRunAtMs: number;
+    lastRunStatus: string;
+    lastStatus: string;
+    lastDurationMs: number;
+    lastError?: string;
+    lastDiagnosticSummary: string;
+    lastDiagnostics?: Record<string, any>;
+    lastDeliveryStatus: string;
+    lastFailureNotificationDeliveryStatus: string;
+    consecutiveErrors: number;
+    consecutiveSkipped: number;
+}
+export interface CronTask {
+    id: string;
+    name: string;
+    enabled: boolean;
+    deleteAfterRun: boolean;
+    createdAtMs: number;
+    schedule: {
+        kind: string;
+        expr: string;
+    };
+    sessionTarget: string;
+    wakeMode: string;
+    payload: {
+        kind: string;
+        message: string;
+    };
+    delivery: {
+        mode: string;
+        channel?: string;
+        to?: string;
+        bestEffort?: boolean;
+    };
+    updatedAtMs: number;
+    agentId: string;
+    state: CronState;
+}
+export interface CronAddParams {
+    name: string;
+    description?: string;
+    schedule: Record<string, unknown>;
+    payload: Record<string, unknown>;
+    delivery: Record<string, unknown>;
+    sessionTarget?: string;
+    wakeMode?: string;
+    enabled?: boolean;
+    deleteAfterRun?: boolean;
+}
+export interface CronAddResponse {
+    ok: boolean;
+}
+export interface CronListResponse {
+    jobs: CronTask[];
+    total: number;
+    offset: number;
+    limit: number;
+    hasMore: boolean;
+    nextOffset: number;
+}
+export interface CronRemoveParams {
+    jobId: string;
+}
+export interface CronRemoveResponse {
+    ok: boolean;
+}
+export interface CronUpdateParams {
+    jobId: string;
+    patch: {
+        name?: string;
+        description?: string;
+        schedule?: Record<string, unknown>;
+        payload?: Record<string, unknown>;
+        delivery?: Record<string, unknown>;
+        enabled?: boolean;
+        deleteAfterRun?: boolean;
+    };
+}
+export interface CronUpdateResponse {
+    ok: boolean;
+}
+export interface CronRunParams {
+    jobId: string;
+}
+export interface CronRunResponse {
+    ok: boolean;
+    runId?: string;
+}
+export interface HealthStatus {
+    status: "healthy" | "degraded" | "unhealthy";
+    version: string;
+    uptime: number;
+    agents: Record<string, {
+        status: string;
+    }>;
+    channels: Record<string, {
+        status: string;
+    }>;
+    memory?: {
+        used: number;
+        total: number;
+        percent: number;
+    };
+}
+export interface SystemStatus {
+    gateway: {
+        version: string;
+        uptime: number;
+        status: string;
+    };
+    memory: {
+        used: number;
+        total: number;
+        percent: number;
+    };
+    agents: {
+        total: number;
+        active: number;
+    };
+    channels: {
+        total: number;
+        connected: number;
+    };
+    models: {
+        primary: string;
+        provider: string;
+    };
+}
+export interface UsageStatus {
+    totalTokens: number;
+    totalCost: number;
+    todayTokens: number;
+    todayCost: number;
+    byModel: Record<string, {
+        tokens: number;
+        cost: number;
+        requests: number;
+    }>;
+    byAgent: Record<string, {
+        tokens: number;
+        cost: number;
+        requests: number;
+    }>;
+}
+export interface ClawServiceOptions {
+    cfg: OpenClawConfig;
+    channelId: string;
+    baseUrl: string;
+    gatewayUrl: string;
+    token?: string;
+}
+export interface AgentSummary {
+    id: string;
+    name: string;
+    emoji?: string;
+    model?: string;
+    workspace?: string;
+    fileCount: number;
+    lastActivity?: string;
+    sessionCount: number;
+}
+export interface TaskSummary {
+    id: string;
+    label: string;
+    schedule: string;
+    agentId: string;
+    agentName: string;
+    status: 'enabled' | 'disabled' | 'running';
+    nextRun?: string;
+    lastRun?: string;
+}
+export interface SystemSummary {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    version: string;
+    uptime: string;
+    agentCount: number;
+    channelCount: number;
+    memoryUsage: string;
+    totalTokens: number;
+    totalCost: number;
+}
+export interface CmdMessage {
+    requestId: string;
+    from?: string;
+    cmd: CmdType;
+    params?: Record<string, any>;
+    timestamp: number;
+}
+export interface CmdResponse {
+    requestId?: string;
+    success: boolean;
+    data?: any;
+    error?: string;
+    timestamp: number;
+}
+export interface CmdResult {
+    apiKey: string;
+    type: 'cmd' | 'event';
+    event?: EventType;
+    payload?: any;
+    agentBrand: 'openClaw';
+    timestamp: string | number;
+    timezone: string;
+}
+export type CmdType = 'agent.ask' | 'agent.list' | 'agent.create' | 'agent.update' | 'agent.delete' | 'agent.get' | 'agent.stop' | 'chat.abort' | 'task.list' | 'task.create' | 'task.update' | 'task.delete' | 'task.run' | 'status.health' | 'status.system' | 'status.usage' | 'models.list' | 'sessions.list' | 'sessions.get' | 'sessions.describe' | 'sessions.resolve' | 'sessions.create' | 'sessions.archive' | 'sessions.restore' | 'sessions.delete' | 'sessions.reset' | 'sessions.patch' | 'sessions.currentModel' | 'chat.history' | 'chat.trajectory' | 'skills.status' | 'skills.search' | 'skills.detail' | 'skills.install' | 'skills.update' | 'skills.securityVerdicts' | 'cancelMessage' | 'usage.cost' | 'sessions.usage' | 'sessions.usage.logs' | 'pairing.approve' | 'artifacts.list' | 'artifacts.get' | 'artifacts.download' | 'agents.files.list' | 'agents.files.get' | 'extCapabilities.status' | 'extCapabilities.check' | 'extCapabilities.install';
+export type ReadlineType = Extract<CmdType, 'chat.trajectory'>;
+export interface ClawMessage {
+    type: 'res' | 'event';
+    event?: 'health' | 'connect.challenge' | 'tick' | 'agent' | 'chat' | 'cron' | 'shutdown' | 'sessions.changed' | 'presence' | 'session.message' | 'heartbeat';
+    id: string;
+    ok: boolean;
+    payload: any;
+    error?: any;
+}
+export type EventType = 'onTick' | 'onHealth' | 'onHandshaked' | 'onConnectState' | 'onError' | 'onAgentReply' | 'onAgentChat' | 'onChatTrajectory' | 'onCron' | 'onShutdown' | 'onSessionsChanged' | 'onSkillInstalled' | 'onSkillInstalling' | 'onSkillError' | 'onPairingRequest' | 'onPairingResult';
+export type CmdParamsPatchSessionEntry = {
+    sessionKey: string;
+    provider?: string;
+    model: string;
+};
+export interface SkillInfo {
+    name: string;
+    version?: string;
+    description?: string;
+    enabled: boolean;
+    configured: boolean;
+    eligibility?: string;
+    missingRequirements?: string[];
+    configCheck?: Record<string, any>;
+    source?: string;
+    slug?: string;
+    author?: string;
+    installs?: number;
+    category?: string;
+}
+export interface SkillSearchParams {
+    query?: string;
+    limit?: number;
+}
+export interface SkillInstallParams {
+    slug: string;
+    version?: string;
+    force?: boolean;
+}
+/** 工件（Artifact）：Agent 在会话中操作文件产生的记录 */
+export interface ArtifactInfo {
+    id: string;
+    type: string;
+    action: string;
+    path?: string;
+    title?: string;
+    mimeType?: string;
+    size?: number;
+    displayed: boolean;
+    timestamp: number;
+    sessionKey: string;
+    runId?: string;
+}
+/** artifacts.list 返回 */
+export interface ArtifactsListResponse {
+    artifacts: ArtifactInfo[];
+    stats?: {
+        changedCount: number;
+        readCount: number;
+        artifactCount: number;
+        displayedCount: number;
+    };
+}
+/** artifacts.list / artifacts.get 参数 */
+export interface ArtifactsQuery {
+    sessionKey?: string;
+    runId?: string;
+    taskId?: string;
+}
+export interface ArtifactGetParams {
+    artifactId: string;
+}
+export interface ArtifactDownloadParams {
+    artifactId: string;
+}
+/** agents.files 参数 */
+export interface AgentFilesListParams {
+    agentId: string;
+}
+export interface AgentFilesGetParams {
+    agentId: string;
+    name: string;
+}

package/dist/src/services/types.js

@@ -0,0 +1,5 @@
+/**
+ * OpenClaw Gateway API 类型定义
+ * 用于 duolian 插件中的 claw-services
+ */
+export {};

package/dist/src/services/ws-client.d.ts

@@ -0,0 +1,174 @@
+import { AgentsListResponse, AgentCreateParams, AgentCreateResponse, AgentUpdateParams, AgentUpdateResponse, AgentDeleteParams, AgentDeleteResponse, CronAddParams, CronAddResponse, CronListResponse, CronRemoveParams, CronRemoveResponse, CronUpdateParams, CronUpdateResponse, CronRunParams, CronRunResponse, HealthStatus, SystemStatus, UsageStatus, AskAgentParams } from './types.js';
+import EventEmitter from 'events';
+/**
+ * OpenClaw Gateway WebSocket 客户端
+ * 用于 duolian 插件内部调用 OpenClaw API
+ */
+export declare class WSClient extends EventEmitter {
+    private ws;
+    private readonly gatewayUrl;
+    private token?;
+    private readonly callbacks;
+    private messageId;
+    private isConnected;
+    private isHandshaked;
+    private readonly deviceConfig;
+    constructor(options: {
+        gatewayUrl: string;
+        token?: string;
+    });
+    private log;
+    /**
+     * 连接到 OpenClaw Gateway
+     */
+    connect(): Promise<void>;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 检查是否已连接
+     */
+    isReady(): boolean;
+    askAgent(params: AskAgentParams): Promise<any>;
+    /**
+     * 列出所有 Agents
+     */
+    listAgents(): Promise<AgentsListResponse>;
+    /**
+     * 创建新的 Agent
+     */
+    createAgent(params: AgentCreateParams): Promise<AgentCreateResponse>;
+    /**
+     * 更新 Agent 信息
+     */
+    updateAgent(params: AgentUpdateParams): Promise<AgentUpdateResponse>;
+    /**
+     * 删除 Agent
+     */
+    deleteAgent(params: AgentDeleteParams): Promise<AgentDeleteResponse>;
+    /**
+     * 添加定时任务
+     */
+    addCronTask(params: CronAddParams): Promise<CronAddResponse>;
+    /**
+     * 列出所有定时任务
+     */
+    listCronTasks({ limit, offset }: {
+        limit: number;
+        offset: number;
+    }): Promise<CronListResponse>;
+    /**
+     * 更新定时任务
+     */
+    updateCronTask(params: CronUpdateParams): Promise<CronUpdateResponse>;
+    /**
+     * 删除定时任务
+     */
+    removeCronTask(params: CronRemoveParams): Promise<CronRemoveResponse>;
+    /**
+     * 运行定时任务
+     */
+    runCronTask(params: CronRunParams): Promise<CronRunResponse>;
+    /**
+     * 获取健康状态
+     */
+    getHealthStatus(): Promise<HealthStatus>;
+    /**
+     * 获取系统状态
+     */
+    getSystemStatus(): Promise<SystemStatus>;
+    /**
+     * 获取使用情况统计
+     */
+    getUsageStatus(): Promise<UsageStatus>;
+    listModels(): Promise<any>;
+    sessionsList(params: Record<string, unknown>): Promise<any>;
+    sessionsGet(params: Record<string, unknown>): Promise<any>;
+    sessionsDescribe(params: Record<string, string>): Promise<any>;
+    sessionsResolve(params: Record<string, unknown>): Promise<any>;
+    sessionReset(params: Record<string, string>): Promise<any>;
+    chatHistories(params: Record<string, string>): Promise<any>;
+    listSkills(agentId?: string): Promise<any>;
+    searchSkills(params: {
+        query?: string;
+        limit?: number;
+    }): Promise<any>;
+    getSkillDetail(slug: string): Promise<any>;
+    installSkill(slug: string, version?: string): Promise<any>;
+    updateSkillConfig(skillKey: string, enabled: boolean): Promise<any>;
+    /**
+     * 取消当前Session的Agent执行
+     * 发送 /queue interrupt 到Gateway中断活跃run
+     * @param channelId 频道ID（如 dlink），由services层传入，避免硬编码
+     * @param chatType 会话类型 direct | group，由WorkRelay客户端传入
+     */
+    /**
+     * 创建新会话
+     * @param params.key - 完整的 sessionKey
+     */
+    sessionsCreate(params: {
+        key: string;
+    }): Promise<any>;
+    /**
+     * 更新会话元数据（归档/恢复等）
+     * @param params.key - sessionKey
+     * @param params.patch - 要更新的字段，如 { archived: true }
+     */
+    sessionsPatch(params: {
+        key: string;
+        patch: Record<string, unknown>;
+    }): Promise<any>;
+    /**
+     * 删除会话
+     * @param params.key - sessionKey
+     * @param params.deleteFiles - 是否同时删除会话相关文件(貌似不支持该参数)
+     */
+    sessionsDelete(params: {
+        key: string;
+    }): Promise<any>;
+    /** 订阅会话变更事件（需在握手成功后调用） */
+    subscribeSessions(): Promise<any>;
+    cancelSession({ sessionKey }: {
+        sessionKey: string;
+    }): Promise<any>;
+    /**
+     * 发送 /stop 到Gateway，强制中止活跃run（比 /queue interrupt 更快）
+     * 对应 cmd 通道 agent.stop 指令
+     */
+    stopSession({ sessionKey }: {
+        sessionKey: string;
+    }): Promise<any>;
+    chatAbort(params: {
+        sessionKey: string;
+        runId: string;
+    }): Promise<any>;
+    getSkillSecurityVerdicts(agentId?: string): Promise<any>;
+    getUsageCost(params: Record<string, unknown>): Promise<any>;
+    getSessionsUsage(params: Record<string, unknown>): Promise<any>;
+    getSessionsUsageLogs(params: Record<string, unknown>): Promise<any>;
+    artifactsList(params: any): Promise<any>;
+    artifactsGet(params: any): Promise<any>;
+    artifactsDownload(params: any): Promise<any>;
+    /** 列出 Agent 工作区文件（agents.files.list） */
+    agentFilesList(agentId: string): Promise<any>;
+    /** 获取 Agent 工作区文件内容（agents.files.get） */
+    agentFilesGet(agentId: string, filePath: string): Promise<any>;
+    /** 跳过 Gateway RPC，直接用 Node.js fs 读取 agent 工作区文件内容
+     *  2026-07-31 base64 fix：文本文件 utf-8，二进制文件 base64 编码避免损坏 */
+    agentFilesGetLocal(agentId: string, filePath: string): Promise<any>;
+    /** 根据扩展名判断是否文本文件 */
+    private isTextFile;
+    /** 跳过 Gateway RPC，直接用 Node.js fs 递归扫描 agent 工作区目录 */
+    agentFilesListLocal(agentId: string): Promise<any>;
+    /** 根据 agentId 推断 workspace 目录路径 */
+    private resolveWorkspaceDir;
+    /** 递归扫描工作区目录，跳过隐藏目录（.git, .clawhub, .openclaw 等） */
+    private scanWorkspaceDir;
+    private send;
+    private sendHandshake;
+    private sendRequest;
+    private handleMessage;
+    private generateId;
+}
+export default WSClient;