openclaw-remote 0.3.0 → 0.4.0

package/dist/index.js

@@ -2783,9 +2783,47 @@ async function getBoardHealth(account) {
     }
   );
 }
+async function getTeam(account) {
+  return apiFetch(
+    buildUrl(account, "/api/v1/team"),
+    {
+      method: "GET",
+      headers: buildHeaders(account)
+    }
+  );
+}
 
 // src/realtime-listener.ts
 import { createClient } from "@supabase/supabase-js";
+var leaderTimers = /* @__PURE__ */ new Map();
+var LEADER_DEBOUNCE_MS = 6e4;
+var leaderRolesCache = [];
+var leaderRolesCacheTime = 0;
+var LEADER_CACHE_TTL = 5 * 6e4;
+async function fetchLeaderRoles(supabase, log) {
+  const now = Date.now();
+  if (now - leaderRolesCacheTime < LEADER_CACHE_TTL && leaderRolesCache.length > 0) {
+    return leaderRolesCache;
+  }
+  const { data: roles } = await supabase.from("project_roles").select("id").eq("is_leader", true);
+  if (!roles || roles.length === 0) {
+    leaderRolesCache = [];
+    leaderRolesCacheTime = now;
+    return [];
+  }
+  const roleIds = roles.map((r) => r.id);
+  const { data: assignments } = await supabase.from("agent_role_assignments").select("project_role_id, agent_id").in("project_role_id", roleIds);
+  const map = /* @__PURE__ */ new Map();
+  for (const a of assignments ?? []) {
+    const list = map.get(a.project_role_id) || [];
+    list.push(a.agent_id);
+    map.set(a.project_role_id, list);
+  }
+  leaderRolesCache = roleIds.map((id) => ({ roleId: id, agentIds: map.get(id) || [] }));
+  leaderRolesCacheTime = now;
+  log?.info?.(`Leader roles cache refreshed: ${leaderRolesCache.length} leader role(s)`);
+  return leaderRolesCache;
+}
 function connectRealtime(account, onEvent, onError, log) {
   const { supabaseUrl, supabaseKey } = account;
   if (!supabaseUrl || !supabaseKey) {
@@ -2810,6 +2848,7 @@ function connectRealtime(account, onEvent, onError, log) {
         const row = payload.new;
         if (row.agent_author_id && !row.author_id) {
           log?.info?.(`Skipping agent-authored comment on task ${row.task_id} (echo suppression)`);
+          scheduleLeaderNotification(row.task_id, row.agent_author_id, supabase, log);
           return;
         }
         const event = {
@@ -2845,11 +2884,49 @@ function connectRealtime(account, onEvent, onError, log) {
   return {
     unsubscribe: async () => {
       log?.info?.("Unsubscribing from Supabase Realtime...");
+      for (const timer of leaderTimers.values()) clearTimeout(timer);
+      leaderTimers.clear();
       await supabase.removeChannel(channel);
       log?.info?.("Realtime listener shut down cleanly.");
     }
   };
 }
+async function scheduleLeaderNotification(taskId, commentingAgentId, supabase, log) {
+  const existing = leaderTimers.get(taskId);
+  if (existing) clearTimeout(existing);
+  const timer = setTimeout(async () => {
+    leaderTimers.delete(taskId);
+    try {
+      const leaders = await fetchLeaderRoles(supabase, log);
+      if (leaders.length === 0) return;
+      const { data: task } = await supabase.from("tasks").select("id, title, assigned_role_id").eq("id", taskId).single();
+      if (!task) return;
+      for (const leader of leaders) {
+        if (task.assigned_role_id === leader.roleId) {
+          log?.info?.(`Skipping leader notification for task ${taskId} \u2014 assigned to leader role ${leader.roleId}`);
+          continue;
+        }
+        if (leader.agentIds.includes(commentingAgentId)) continue;
+        if (leader.agentIds.length === 0) continue;
+        const { error } = await supabase.from("task_comments").insert({
+          task_id: taskId,
+          author_id: null,
+          agent_author_id: null,
+          body: `\u{1F440} Activity on this task \u2014 leader review needed`
+        });
+        if (error) {
+          log?.warn?.(`Failed to insert leader notification for task ${taskId}: ${error.message}`);
+        } else {
+          log?.info?.(`Leader notification sent for task ${taskId}`);
+        }
+      }
+    } catch (err) {
+      log?.warn?.(`Leader notification error for task ${taskId}: ${err}`);
+    }
+  }, LEADER_DEBOUNCE_MS);
+  leaderTimers.set(taskId, timer);
+  log?.info?.(`Leader debounce timer set for task ${taskId} (60s)`);
+}
 
 // src/event-formatter.ts
 function formatEvent(event) {
@@ -3560,6 +3637,41 @@ function createRemotePlugin() {
               details: { ok: true, epic }
             };
           }
+        },
+        // 8. remote_list_team
+        {
+          name: "remote_list_team",
+          label: "List team members",
+          description: "List all team members (humans and agents) with their roles and @mention handles. Use to find who to tag in comments or assign tasks to.",
+          parameters: Type.Object({}),
+          execute: async (_toolCallId, _args) => {
+            const account = resolveAccount(cfg ?? {});
+            const result = await getTeam(account);
+            if (!result.ok) {
+              return {
+                content: [{ type: "text", text: `\u274C Failed to list team: ${result.error}` }],
+                details: { ok: false, error: result.error }
+              };
+            }
+            const { team, total, humans, agents } = result.data;
+            if (team.length === 0) {
+              return {
+                content: [{ type: "text", text: "\u{1F465} No team members found." }],
+                details: { ok: true, team: [] }
+              };
+            }
+            const lines = [`\u{1F465} **Team** (${total} members: ${humans} human, ${agents} agent)`, ""];
+            for (const m of team) {
+              const roles = m.project_roles.length > 0 ? m.project_roles.map((r) => r.name).join(", ") : "no role";
+              const me = m.is_me ? " \u2B50 (you)" : "";
+              const status = m.type === "agent" && m.status ? ` [${m.status}]` : "";
+              lines.push(`- **${m.name}** (${m.type}${status}) \u2014 ${roles} \u2014 mention: \`${m.mention}\`${me}`);
+            }
+            return {
+              content: [{ type: "text", text: lines.join("\n") }],
+              details: { ok: true, team, total, humans, agents }
+            };
+          }
         }
       ];
     }),
@@ -3579,6 +3691,7 @@ function createRemotePlugin() {
         "- `remote_list_roles` \u2014 List project roles with vacancy info (find valid assigned_role_id values)",
         "- `remote_list_epics` \u2014 List epics with task counts (find valid epic_id values)",
         "- `remote_create_epic` \u2014 Create a new epic (name, description, color)",
+        "- `remote_list_team` \u2014 List all team members with roles and @mention handles",
         "",
         "**Task lifecycle**: todo \u2192 in_progress \u2192 review \u2192 done",
         "**Task types**: feature, task, bug",
@@ -3590,7 +3703,9 @@ function createRemotePlugin() {
         "- Move tasks to review when ready for review, done when complete",
         "- Keep task descriptions and comments clear and actionable",
         "- Use `remote_list_roles` before creating tasks to find valid role IDs for assignment",
-        "- Use `remote_list_epics` before creating tasks to find valid epic IDs for grouping"
+        "- Use `remote_list_epics` before creating tasks to find valid epic IDs for grouping",
+        "- Use `remote_list_team` to find teammates and their @mention handles for tagging in comments",
+        "- Tag team members with @name in comments when you need their input or want to delegate"
       ]
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-remote",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Remote project board channel plugin for OpenClaw",
   "type": "module",
   "main": "dist/index.js",