clawmatrix 0.1.14 → 0.1.16

package/src/tools/cluster-handoff.ts

@@ -37,6 +37,18 @@ export function createClusterHandoffTool(): AnyAgentTool {
         const runtime = getClusterRuntime();
         const result = await runtime.handoffManager.handoff(target, task, context);
 
+        if (result.inputRequired) {
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: `Remote agent needs more information before continuing.\n\nHandoff ID: ${result.handoffId}\nQuestion: ${result.result}\n\nUse cluster_handoff_reply tool to respond.`,
+              },
+            ],
+            details: result,
+          };
+        }
+
         if (!result.success) {
           return {
             content: [

package/src/tools/cluster-peers.ts

@@ -6,7 +6,7 @@ export function createClusterPeersTool(): AnyAgentTool {
     name: "cluster_peers",
     label: "Cluster Peers",
     description:
-      "List all reachable peers in the cluster, their agents, available models, and connection status.",
+      "List all reachable peers in the cluster, their agents, models, tools, and connection status.",
     parameters: {
       type: "object",
       properties: {},
@@ -26,10 +26,26 @@ export function createClusterPeersTool(): AnyAgentTool {
             provider: m.provider,
           })),
           tags: entry.tags,
+          tools: entry.toolProxy?.enabled ? (entry.toolProxy.allow ?? []) : [],
           status: entry.connection?.isOpen ? "connected" : "unreachable",
           latencyMs: entry.latencyMs,
         }));
 
+        // Include satellite nodes
+        const satellites = runtime.webHandler?.getSatelliteContexts() ?? runtime.peerManager.satelliteContexts;
+        for (const sat of satellites) {
+          if (Date.now() - sat.ts >= 600_000) continue;
+          peers.push({
+            nodeId: sat.nodeId,
+            agents: [],
+            models: [],
+            tags: [],
+            tools: sat.tools ?? [],
+            status: "satellite",
+            latencyMs: undefined,
+          });
+        }
+
         return {
           content: [
             {

package/src/tools/cluster-send.ts

@@ -6,9 +6,7 @@ export function createClusterSendTool(): AnyAgentTool {
     name: "cluster_send",
     label: "Cluster Send",
     description:
-      "Send a one-way message to another agent in the cluster. " +
-      "The message is injected into the target agent's session as an inbound message. " +
-      "Does not wait for a response.",
+      "Send a one-way message to a remote agent. Does not wait for a response.",
     parameters: {
       type: "object",
       properties: {

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

@@ -23,6 +23,8 @@ export interface AuthRequest extends ClusterFrame {
     agents?: AgentInfo[];
     models?: ModelInfo[];
     tags?: string[];
+    deviceInfo?: DeviceInfo;
+    toolProxy?: ToolProxyInfo;
   };
 }
 
@@ -33,6 +35,8 @@ export interface AuthOk extends ClusterFrame {
     agents: AgentInfo[];
     models: ModelInfo[];
     tags: string[];
+    deviceInfo?: DeviceInfo;
+    toolProxy?: ToolProxyInfo;
   };
 }
 
@@ -42,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[];
   };
 }
 
@@ -74,6 +95,8 @@ export interface ModelRequest extends ClusterFrame {
   id: string;
   payload: {
     model: string;
+    provider?: string;
+    api?: string;
     messages: unknown[];
     temperature?: number;
     maxTokens?: number;
@@ -87,6 +110,9 @@ export interface ModelResponse extends ClusterFrame {
   payload: {
     success: boolean;
     content?: string;
+    /** Full message object from upstream (choices[0].message or responses output).
+     *  Carries tool_calls, refusal, etc. that `content` alone cannot represent. */
+    message?: unknown;
     usage?: { inputTokens: number; outputTokens: number };
     error?: string;
   };
@@ -97,12 +123,23 @@ export interface ModelStreamChunk extends ClusterFrame {
   id: string;
   payload: {
     delta: string;
+    /** Full delta object from upstream (choices[0].delta).
+     *  Carries tool_calls chunks that `delta` string cannot represent. */
+    deltaObj?: unknown;
     done: boolean;
     usage?: { inputTokens: number; outputTokens: number };
   };
 }
 
 // ── 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;
@@ -119,6 +156,7 @@ export interface HandoffStreamChunk extends ClusterFrame {
   payload: {
     delta: string;
     done: boolean;
+    artifacts?: Artifact[];
   };
 }
 
@@ -131,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;
   };
 }
 
@@ -163,6 +243,17 @@ export interface ToolProxyResponse extends ClusterFrame {
   };
 }
 
+// ── Device info ───────────────────────────────────────────────────
+export interface DeviceInfo {
+  os: string; // e.g. "Darwin 24.6.0", "Linux 6.1.0"
+  arch: string; // e.g. "arm64", "x64"
+  cpuModel: string; // e.g. "Apple M1 Pro"
+  cpuCores: number; // logical CPU cores
+  totalMemoryMB: number; // total system memory in MB
+  hostname: string; // machine hostname
+  openclawVersion?: string; // e.g. "2026.3.7"
+}
+
 // ── Shared info types ──────────────────────────────────────────────
 export interface AgentInfo {
   id: string;
@@ -192,12 +283,21 @@ export interface ModelInfo {
   compat?: ModelCompatInfo;
 }
 
+export interface ToolProxyInfo {
+  enabled: boolean;
+  allow: string[];
+  deny: string[];
+}
+
 export interface PeerInfo {
   nodeId: string;
   agents: AgentInfo[];
   models: ModelInfo[];
   tags: string[];
   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 {
@@ -205,6 +305,18 @@ export interface NodeCapabilities {
   agents: AgentInfo[];
   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 ───────────────────────────────────────
@@ -224,6 +336,11 @@ export type AnyClusterFrame =
   | HandoffRequest
   | HandoffStreamChunk
   | HandoffResponse
+  | HandoffCancel
+  | HandoffStatusQuery
+  | HandoffStatusResponse
   | SendMessage
+  | HandoffInputRequired
+  | HandoffInput
   | ToolProxyRequest
   | ToolProxyResponse;