clawmatrix 0.1.0

package/src/tools/cluster-write.ts

@@ -0,0 +1,61 @@
+import type { AnyAgentTool } from "openclaw/plugin-sdk";
+import { getClusterRuntime } from "../cluster-service.ts";
+
+export function createClusterWriteTool(): AnyAgentTool {
+  return {
+    name: "cluster_write",
+    label: "Cluster Write",
+    description: "Write content to a file on a remote cluster node.",
+    parameters: {
+      type: "object",
+      properties: {
+        node: {
+          type: "string",
+          description: 'Target nodeId or "tags:<tag>"',
+        },
+        path: {
+          type: "string",
+          description: "Absolute file path to write",
+        },
+        content: {
+          type: "string",
+          description: "Content to write to the file",
+        },
+      },
+      required: ["node", "path", "content"],
+    },
+    async execute(_toolCallId, params) {
+      const { node, path, content } = params as {
+        node: string;
+        path: string;
+        content: string;
+      };
+
+      try {
+        const runtime = getClusterRuntime();
+        const result = await runtime.toolProxy.write(node, path, content);
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: result.success
+                ? `Successfully wrote to ${path} on ${node}`
+                : `Write failed on ${node}`,
+            },
+          ],
+          details: result,
+        };
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Write error: ${err instanceof Error ? err.message : String(err)}`,
+            },
+          ],
+          details: { error: true },
+        };
+      }
+    },
+  };
+}

package/src/types.ts

@@ -0,0 +1,197 @@
+// ── Cluster Frame (message envelope) ────────────────────────────────
+export interface ClusterFrame {
+  type: string;
+  id?: string;
+  from: string;
+  to?: string;
+  ttl?: number;
+  timestamp: number;
+  payload?: unknown;
+}
+
+// ── Auth messages ──────────────────────────────────────────────────
+export interface AuthChallenge extends ClusterFrame {
+  type: "auth_challenge";
+  payload: { nonce: string };
+}
+
+export interface AuthRequest extends ClusterFrame {
+  type: "auth";
+  payload: { nodeId: string; sig: string };
+}
+
+export interface AuthOk extends ClusterFrame {
+  type: "auth_ok";
+  payload: {
+    nodeId: string;
+    agents: AgentInfo[];
+    models: ModelInfo[];
+    tags: string[];
+  };
+}
+
+export interface AuthFail extends ClusterFrame {
+  type: "auth_fail";
+  payload: { reason: string };
+}
+
+// ── Peer discovery ─────────────────────────────────────────────────
+export interface PeerSync extends ClusterFrame {
+  type: "peer_sync";
+  payload: {
+    peers: PeerInfo[];
+  };
+}
+
+export interface PeerJoin extends ClusterFrame {
+  type: "peer_join";
+  payload: PeerInfo;
+}
+
+export interface PeerLeave extends ClusterFrame {
+  type: "peer_leave";
+  payload: { nodeId: string };
+}
+
+// ── Heartbeat ──────────────────────────────────────────────────────
+export interface Ping extends ClusterFrame {
+  type: "ping";
+}
+
+export interface Pong extends ClusterFrame {
+  type: "pong";
+}
+
+// ── Model proxy ────────────────────────────────────────────────────
+export interface ModelRequest extends ClusterFrame {
+  type: "model_req";
+  id: string;
+  payload: {
+    model: string;
+    messages: unknown[];
+    temperature?: number;
+    maxTokens?: number;
+    stream: boolean;
+  };
+}
+
+export interface ModelResponse extends ClusterFrame {
+  type: "model_res";
+  id: string;
+  payload: {
+    success: boolean;
+    content?: string;
+    usage?: { inputTokens: number; outputTokens: number };
+    error?: string;
+  };
+}
+
+export interface ModelStreamChunk extends ClusterFrame {
+  type: "model_stream";
+  id: string;
+  payload: {
+    delta: string;
+    done: boolean;
+    usage?: { inputTokens: number; outputTokens: number };
+  };
+}
+
+// ── Handoff ────────────────────────────────────────────────────────
+export interface HandoffRequest extends ClusterFrame {
+  type: "handoff_req";
+  id: string;
+  payload: {
+    target: string;
+    task: string;
+    context?: string;
+  };
+}
+
+export interface HandoffResponse extends ClusterFrame {
+  type: "handoff_res";
+  id: string;
+  payload: {
+    success: boolean;
+    nodeId?: string;
+    agent?: string;
+    result?: string;
+    error?: string;
+  };
+}
+
+// ── Send (one-way) ─────────────────────────────────────────────────
+export interface SendMessage extends ClusterFrame {
+  type: "send";
+  payload: {
+    target: string;
+    message: string;
+  };
+}
+
+// ── Tool proxy ─────────────────────────────────────────────────────
+export interface ToolProxyRequest extends ClusterFrame {
+  type: "tool_req";
+  id: string;
+  payload: {
+    tool: "exec" | "read" | "write" | "ls";
+    params: Record<string, unknown>;
+  };
+}
+
+export interface ToolProxyResponse extends ClusterFrame {
+  type: "tool_res";
+  id: string;
+  payload: {
+    success: boolean;
+    result?: Record<string, unknown>;
+    error?: string;
+  };
+}
+
+// ── Shared info types ──────────────────────────────────────────────
+export interface AgentInfo {
+  id: string;
+  description: string;
+  tags: string[];
+}
+
+export interface ModelInfo {
+  id: string;
+  provider: string;
+  description?: string;
+}
+
+export interface PeerInfo {
+  nodeId: string;
+  agents: AgentInfo[];
+  models: ModelInfo[];
+  tags: string[];
+  reachableVia?: string; // nodeId of the relay node
+}
+
+export interface NodeCapabilities {
+  nodeId: string;
+  agents: AgentInfo[];
+  models: ModelInfo[];
+  tags: string[];
+}
+
+// ── Union of all frame types ───────────────────────────────────────
+export type AnyClusterFrame =
+  | AuthChallenge
+  | AuthRequest
+  | AuthOk
+  | AuthFail
+  | PeerSync
+  | PeerJoin
+  | PeerLeave
+  | Ping
+  | Pong
+  | ModelRequest
+  | ModelResponse
+  | ModelStreamChunk
+  | HandoffRequest
+  | HandoffResponse
+  | SendMessage
+  | ToolProxyRequest
+  | ToolProxyResponse;