commanderclaw 1.1.3

package/dist/plugin/tools/task.ts

@@ -0,0 +1,254 @@
+/**
+ * commanderclaw_task tool
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { CommanderClawClient } from "../client";
+import type { ToolDefinition, Task } from "../types";
+
+export function createTaskTool(getClient: () => CommanderClawClient | null): ToolDefinition {
+  return {
+    name: "commanderclaw_task",
+    description: `Create, query, or manage tasks on the CommanderClaw cluster.
+
+Actions:
+- create: Create a new task with a name and optional description, priority, input, and target node
+- list: List all tasks in the cluster
+- get: Get details of a specific task by ID
+- abort: Abort a running task
+- pause: Pause a running task
+- resume: Resume a paused task
+
+Use this to coordinate work across multiple AI agents in the cluster.`,
+    parameters: Type.Object({
+      action: Type.Union([
+        Type.Literal("create"),
+        Type.Literal("list"),
+        Type.Literal("get"),
+        Type.Literal("abort"),
+        Type.Literal("pause"),
+        Type.Literal("resume"),
+      ]),
+      // Create parameters
+      name: Type.Optional(Type.String()),
+      description: Type.Optional(Type.String()),
+      priority: Type.Optional(
+        Type.Union([
+          Type.Literal("low"),
+          Type.Literal("normal"),
+          Type.Literal("high"),
+          Type.Literal("critical"),
+        ])
+      ),
+      input: Type.Optional(Type.Any()),
+      targetNodeId: Type.Optional(Type.String()),
+      maxRounds: Type.Optional(Type.Number()),
+      // Get/Abort/Pause/Resume parameters
+      taskId: Type.Optional(Type.String()),
+      reason: Type.Optional(Type.String()),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      const client = getClient();
+      if (!client?.isConnected()) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Not connected to CommanderClaw server. Check plugin configuration.",
+            },
+          ],
+        };
+      }
+
+      try {
+        switch (params.action) {
+          case "create": {
+            if (!params.name || typeof params.name !== "string") {
+              return {
+                content: [
+                  { type: "text" as const, text: "Error: 'name' is required for create action" },
+                ],
+              };
+            }
+            const task = await client.createTask({
+              name: params.name,
+              description: params.description as string | undefined,
+              priority: params.priority as "low" | "normal" | "high" | "critical" | undefined,
+              input: params.input,
+              targetNodeId: params.targetNodeId as string | undefined,
+              maxRounds: params.maxRounds as number | undefined,
+            });
+            return {
+              content: [
+                {
+                  type: "text" as const,
+                  text: `Task created successfully:\n\`\`\`json\n${JSON.stringify(task, null, 2)}\n\`\`\``,
+                },
+              ],
+            };
+          }
+
+          case "list": {
+            const tasks = await client.listTasks();
+            if (tasks.length === 0) {
+              return {
+                content: [{ type: "text" as const, text: "No tasks in the cluster." }],
+              };
+            }
+
+            let text = `## Tasks (${tasks.length})\n\n`;
+            for (const task of tasks) {
+              text += formatTaskSummary(task);
+            }
+            return { content: [{ type: "text" as const, text }] };
+          }
+
+          case "get": {
+            if (!params.taskId || typeof params.taskId !== "string") {
+              return {
+                content: [
+                  { type: "text" as const, text: "Error: 'taskId' is required for get action" },
+                ],
+              };
+            }
+            const task = await client.getTask(params.taskId);
+            return {
+              content: [
+                {
+                  type: "text" as const,
+                  text: formatTaskDetail(task),
+                },
+              ],
+            };
+          }
+
+          case "abort": {
+            if (!params.taskId || typeof params.taskId !== "string") {
+              return {
+                content: [
+                  { type: "text" as const, text: "Error: 'taskId' is required for abort action" },
+                ],
+              };
+            }
+            await client.abortTask(params.taskId, params.reason as string | undefined);
+            return {
+              content: [
+                { type: "text" as const, text: `Task ${params.taskId} has been aborted.` },
+              ],
+            };
+          }
+
+          case "pause": {
+            if (!params.taskId || typeof params.taskId !== "string") {
+              return {
+                content: [
+                  { type: "text" as const, text: "Error: 'taskId' is required for pause action" },
+                ],
+              };
+            }
+            await client.pauseTask(params.taskId);
+            return {
+              content: [
+                { type: "text" as const, text: `Task ${params.taskId} has been paused.` },
+              ],
+            };
+          }
+
+          case "resume": {
+            if (!params.taskId || typeof params.taskId !== "string") {
+              return {
+                content: [
+                  { type: "text" as const, text: "Error: 'taskId' is required for resume action" },
+                ],
+              };
+            }
+            await client.resumeTask(params.taskId);
+            return {
+              content: [
+                { type: "text" as const, text: `Task ${params.taskId} has been resumed.` },
+              ],
+            };
+          }
+
+          default:
+            return {
+              content: [
+                { type: "text" as const, text: `Unknown action: ${params.action}` },
+              ],
+            };
+        }
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Failed to execute task action: ${error instanceof Error ? error.message : String(error)}`,
+            },
+          ],
+        };
+      }
+    },
+  };
+}
+
+function formatTaskSummary(task: Task): string {
+  const statusEmoji = {
+    pending: "⏳",
+    assigned: "📋",
+    running: "▶️",
+    paused: "⏸️",
+    completed: "✅",
+    failed: "❌",
+    aborted: "🚫",
+  }[task.status] || "❓";
+
+  let text = `### ${task.name} (${task.id})\n`;
+  text += `- **Status:** ${statusEmoji} ${task.status}\n`;
+  text += `- **Priority:** ${task.priority}\n`;
+  text += `- **Progress:** ${task.progress}%\n`;
+  if (task.assignees?.length) {
+    text += `- **Assignees:** ${task.assignees.join(", ")}\n`;
+  }
+  text += "\n";
+  return text;
+}
+
+function formatTaskDetail(task: Task): string {
+  let text = `## Task: ${task.name}\n\n`;
+  text += `**ID:** ${task.id}\n`;
+  text += `**Status:** ${task.status}\n`;
+  text += `**Priority:** ${task.priority}\n`;
+  text += `**Progress:** ${task.progress}%\n`;
+  text += `**Rounds:** ${task.rounds}/${task.maxRounds}\n\n`;
+
+  if (task.description) {
+    text += `**Description:**\n${task.description}\n\n`;
+  }
+
+  if (task.creatorId) {
+    text += `**Creator:** ${task.creatorId}\n`;
+  }
+  if (task.commanderId) {
+    text += `**Commander:** ${task.commanderId}\n`;
+  }
+  if (task.assignees?.length) {
+    text += `**Assignees:** ${task.assignees.join(", ")}\n`;
+  }
+
+  text += `\n**Created:** ${task.createdAt}\n`;
+  text += `**Updated:** ${task.updatedAt}\n`;
+
+  if (task.input) {
+    text += `\n**Input:**\n\`\`\`json\n${JSON.stringify(task.input, null, 2)}\n\`\`\`\n`;
+  }
+
+  if (task.output) {
+    text += `\n**Output:**\n\`\`\`json\n${JSON.stringify(task.output, null, 2)}\n\`\`\`\n`;
+  }
+
+  if (task.error) {
+    text += `\n**Error:** ${task.error}\n`;
+  }
+
+  return text;
+}

package/dist/plugin/types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Type definitions for CommanderClaw plugin
+ */
+export interface CommanderClawConfig {
+    serverUrl: string;
+    token?: string;
+    deviceName: string;
+    autoConnect: boolean;
+    reconnect: {
+        enabled: boolean;
+        maxAttempts: number;
+        delayMs: number;
+    };
+}
+export interface Message {
+    type: string;
+    id: string;
+    from: string;
+    to?: string;
+    payload?: unknown;
+    timestamp: number;
+}
+export interface HelloPayload {
+    id: string;
+    name: string;
+    capabilities: string[];
+    token?: string;
+}
+export interface HelloAckPayload {
+    nodeId: string;
+    peers: PeerInfo[];
+    commanderId?: string;
+    error?: string;
+}
+export interface PeerInfo {
+    id: string;
+    name: string;
+    status: string;
+    role: string;
+    capabilities?: string[];
+    load: number;
+}
+export interface HeartbeatPayload {
+    status: string;
+    load: number;
+}
+export interface PeerUpdatePayload {
+    event: "join" | "leave" | "update";
+    node: PeerInfo;
+}
+export interface Task {
+    id: string;
+    name: string;
+    description?: string;
+    creatorId: string;
+    commanderId?: string;
+    assignees: string[];
+    status: TaskStatus;
+    priority: TaskPriority;
+    progress: number;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    input?: unknown;
+    output?: unknown;
+    error?: string;
+    rounds: number;
+    maxRounds: number;
+}
+export type TaskStatus = "pending" | "assigned" | "running" | "paused" | "completed" | "failed" | "aborted";
+export type TaskPriority = "low" | "normal" | "high" | "critical";
+export interface CreateTaskInput {
+    name: string;
+    description?: string;
+    priority?: TaskPriority;
+    input?: unknown;
+    targetNodeId?: string;
+    maxRounds?: number;
+}
+export interface TaskUpdatePayload {
+    taskId: string;
+    subTaskId?: string;
+    status?: string;
+    progress?: number;
+    message?: string;
+    data?: unknown;
+}
+export interface TaskResultPayload {
+    taskId: string;
+    subTaskId?: string;
+    status: string;
+    output?: unknown;
+    error?: string;
+    duration: number;
+}
+export type ClientEventType = "connected" | "disconnected" | "error" | "task_assign" | "peer_update" | "commander_change" | "chat";
+export interface ClientEvent {
+    type: ClientEventType;
+    data?: unknown;
+}
+export interface OpenClawApi {
+    getConfig: (pluginId: string) => CommanderClawConfig;
+    registerTool: (tool: ToolDefinition, options?: {
+        optional?: boolean;
+    }) => void;
+    registerCommand: (command: CommandDefinition) => void;
+    on: (event: string, handler: () => Promise<void>) => void;
+    logger: {
+        info: (message: string, data?: Record<string, unknown>) => void;
+        warn: (message: string, data?: Record<string, unknown>) => void;
+        error: (message: string, data?: Record<string, unknown>) => void;
+        debug: (message: string, data?: Record<string, unknown>) => void;
+    };
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: unknown;
+    execute: (id: string, params: Record<string, unknown>) => Promise<ToolResult>;
+}
+export interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    handler: () => Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugin/types.d.ts.map

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

package/openclaw.plugin.json

@@ -0,0 +1,51 @@
+{
+  "id": "commanderclaw",
+  "name": "CommanderClaw",
+  "description": "Connect to CommanderClaw coordination server as a node for multi-agent task coordination",
+  "version": "1.1.3",
+  "channels": ["commanderclaw"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "serverUrl": {
+        "type": "string",
+        "description": "CommanderClaw server WebSocket URL",
+        "default": "ws://127.0.0.1:19739/ws"
+      },
+      "token": {
+        "type": "string",
+        "description": "Authentication token for the CommanderClaw server"
+      },
+      "deviceName": {
+        "type": "string",
+        "description": "Node name to register with the cluster",
+        "default": "OpenClaw Agent"
+      },
+      "autoConnect": {
+        "type": "boolean",
+        "description": "Automatically connect to server on gateway start",
+        "default": true
+      },
+      "reconnect": {
+        "type": "object",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": true
+          },
+          "maxAttempts": {
+            "type": "number",
+            "default": 10
+          },
+          "delayMs": {
+            "type": "number",
+            "default": 5000
+          }
+        }
+      }
+    },
+    "required": ["serverUrl"]
+  },
+  "skills": ["./dist/plugin/skills/commanderclaw"]
+}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "commanderclaw",
+  "version": "1.1.3",
+  "description": "Multi-device Agent Coordination Framework - CLI and OpenClaw/QClaw Plugin",
+  "type": "module",
+  "bin": {
+    "commanderclaw": "./bin/commanderclaw.cjs"
+  },
+  "main": "./dist/plugin/index.cjs",
+  "module": "./dist/plugin/index.mjs",
+  "types": "./dist/plugin/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/plugin/index.mjs",
+      "require": "./dist/plugin/index.cjs",
+      "types": "./dist/plugin/index.d.ts"
+    }
+  },
+  "files": [
+    "bin",
+    "dist",
+    "binaries",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "npm run build:cli && npm run build:plugin",
+    "build:cli": "tsc -p tsconfig.cli.json",
+    "build:plugin": "rollup -c rollup.plugin.config.mjs && npm run copy-assets",
+    "copy-assets": "cp -r src/plugin/skills dist/plugin/ && cp -r src/plugin/tools dist/plugin/",
+    "dev": "tsc -p tsconfig.cli.json --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "openclaw",
+    "qclaw",
+    "plugin",
+    "commanderclaw",
+    "multi-agent",
+    "coordination",
+    "distributed"
+  ],
+  "author": "DarrenHoo",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.1.0"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.32.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.2",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.0",
+    "rollup": "^4.59.0",
+    "typescript": "^5.0.0"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/plugin/index.mjs"
+    ],
+    "channel": {
+      "id": "commanderclaw",
+      "label": "CommanderClaw",
+      "selectionLabel": "CommanderClaw Multi-Agent",
+      "detailLabel": "CommanderClaw Multi-Agent Coordination",
+      "blurb": "Connect to CommanderClaw coordination server for multi-agent task coordination",
+      "order": 100
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/commander-claw/commander-claw.git",
+    "directory": "packages/commanderclaw"
+  },
+  "homepage": "https://github.com/commander-claw/commander-claw#readme",
+  "bugs": {
+    "url": "https://github.com/commander-claw/commander-claw/issues"
+  }
+}