clawmatrix 0.1.15 → 0.1.16

package/src/tools/cluster-tool.ts

@@ -6,10 +6,7 @@ export function createClusterToolTool(): AnyAgentTool {
     name: "cluster_tool",
     label: "Cluster Tool",
     description:
-      "Invoke any OpenClaw tool on a remote cluster node. " +
-      "Supports all tools available on the remote node (exec, read, write, edit, " +
-      "web_search, web_fetch, browser, process, etc.). " +
-      "Use nodeId or 'tags:<tag>' to specify the target.",
+      "Invoke any OpenClaw tool on a remote cluster node. Use nodeId or 'tags:<tag>' to specify the target.",
     parameters: {
       type: "object",
       properties: {
@@ -19,7 +16,7 @@ export function createClusterToolTool(): AnyAgentTool {
         },
         tool: {
           type: "string",
-          description: "Tool name to invoke (e.g. exec, read, write, edit, web_search, web_fetch, browser, process)",
+          description: "Tool name to invoke on the remote node",
         },
         args: {
           type: "object",

package/src/types.ts

@@ -24,6 +24,7 @@ export interface AuthRequest extends ClusterFrame {
     models?: ModelInfo[];
     tags?: string[];
     deviceInfo?: DeviceInfo;
+    toolProxy?: ToolProxyInfo;
   };
 }
 
@@ -35,6 +36,7 @@ export interface AuthOk extends ClusterFrame {
     models: ModelInfo[];
     tags: string[];
     deviceInfo?: DeviceInfo;
+    toolProxy?: ToolProxyInfo;
   };
 }
 
@@ -44,10 +46,27 @@ export interface AuthFail extends ClusterFrame {
 }
 
 // ── Peer discovery ─────────────────────────────────────────────────
+export interface SatelliteContext {
+  nodeId: string;
+  ssid?: string;
+  ip?: string;
+  router?: string;
+  cellular: boolean;
+  country?: string;
+  tools?: string[];
+  ts: number;
+  // Extended context
+  battery?: number; // 0-100
+  charging?: boolean;
+  platform?: string; // "ios" | "macos"
+  location?: string; // user-defined location name from WiFi mapping
+}
+
 export interface PeerSync extends ClusterFrame {
   type: "peer_sync";
   payload: {
     peers: PeerInfo[];
+    satellites?: SatelliteContext[];
   };
 }
 
@@ -113,6 +132,14 @@ export interface ModelStreamChunk extends ClusterFrame {
 }
 
 // ── Handoff ────────────────────────────────────────────────────────
+export type HandoffStatus = "working" | "input_required" | "completed" | "failed" | "canceled";
+
+export interface Artifact {
+  name: string;
+  mimeType: string;
+  data: string; // text content or base64-encoded binary
+}
+
 export interface HandoffRequest extends ClusterFrame {
   type: "handoff_req";
   id: string;
@@ -129,6 +156,7 @@ export interface HandoffStreamChunk extends ClusterFrame {
   payload: {
     delta: string;
     done: boolean;
+    artifacts?: Artifact[];
   };
 }
 
@@ -141,6 +169,48 @@ export interface HandoffResponse extends ClusterFrame {
     agent?: string;
     result?: string;
     error?: string;
+    artifacts?: Artifact[];
+    inputRequired?: boolean;
+    handoffId?: string;
+  };
+}
+
+export interface HandoffCancel extends ClusterFrame {
+  type: "handoff_cancel";
+  id: string;
+  payload?: unknown;
+}
+
+export interface HandoffStatusQuery extends ClusterFrame {
+  type: "handoff_status";
+  id: string;
+  payload?: unknown;
+}
+
+export interface HandoffStatusResponse extends ClusterFrame {
+  type: "handoff_status_res";
+  id: string;
+  payload: {
+    status: HandoffStatus;
+    nodeId: string;
+    agent: string;
+    elapsedMs: number;
+  };
+}
+
+export interface HandoffInputRequired extends ClusterFrame {
+  type: "handoff_input_required";
+  id: string;
+  payload: {
+    message: string;
+  };
+}
+
+export interface HandoffInput extends ClusterFrame {
+  type: "handoff_input";
+  id: string;
+  payload: {
+    message: string;
   };
 }
 
@@ -213,6 +283,12 @@ export interface ModelInfo {
   compat?: ModelCompatInfo;
 }
 
+export interface ToolProxyInfo {
+  enabled: boolean;
+  allow: string[];
+  deny: string[];
+}
+
 export interface PeerInfo {
   nodeId: string;
   agents: AgentInfo[];
@@ -221,6 +297,7 @@ export interface PeerInfo {
   reachableVia?: string; // nodeId of the relay node
   directPeers?: string[]; // nodeIds this node has direct connections to
   deviceInfo?: DeviceInfo; // system/hardware info
+  toolProxy?: ToolProxyInfo;
 }
 
 export interface NodeCapabilities {
@@ -229,6 +306,17 @@ export interface NodeCapabilities {
   models: ModelInfo[];
   tags: string[];
   deviceInfo?: DeviceInfo;
+  toolProxy?: ToolProxyInfo;
+}
+
+// ── Ingested events (from Shortcuts automations, etc.) ────────────
+export interface IngestedEvent {
+  id: string;
+  source: string;      // e.g. "shortcuts", "iphone-14", "surge"
+  type: string;        // e.g. "message_received", "call_missed", "location_changed"
+  data: Record<string, unknown>;
+  ts: number;          // ingestion timestamp
+  consumed: boolean;   // whether an agent has consumed this event
 }
 
 // ── Union of all frame types ───────────────────────────────────────
@@ -248,6 +336,11 @@ export type AnyClusterFrame =
   | HandoffRequest
   | HandoffStreamChunk
   | HandoffResponse
+  | HandoffCancel
+  | HandoffStatusQuery
+  | HandoffStatusResponse
   | SendMessage
+  | HandoffInputRequired
+  | HandoffInput
   | ToolProxyRequest
   | ToolProxyResponse;