openclaw-remote 0.2.1 → 0.3.1

package/dist/index.js

@@ -2746,6 +2746,52 @@ async function getHeartbeat(account) {
     }
   );
 }
+async function listRoles(account) {
+  return apiFetch(
+    buildUrl(account, "/api/v1/roles"),
+    {
+      method: "GET",
+      headers: buildHeaders(account)
+    }
+  );
+}
+async function listEpics(account) {
+  return apiFetch(
+    buildUrl(account, "/api/v1/epics"),
+    {
+      method: "GET",
+      headers: buildHeaders(account)
+    }
+  );
+}
+async function createEpic(account, epic) {
+  return apiFetch(
+    buildUrl(account, "/api/v1/epics"),
+    {
+      method: "POST",
+      headers: buildHeaders(account),
+      body: JSON.stringify(epic)
+    }
+  );
+}
+async function getBoardHealth(account) {
+  return apiFetch(
+    buildUrl(account, "/api/v1/board/health"),
+    {
+      method: "GET",
+      headers: buildHeaders(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";
@@ -3205,6 +3251,9 @@ function createRemotePlugin() {
             }),
             assigned_role_id: Type.Optional(
               Type.String({ description: "Role ID to assign the task to" })
+            ),
+            epic_id: Type.Optional(
+              Type.String({ description: "Epic ID to group the task under" })
             )
           }),
           execute: async (_toolCallId, args) => {
@@ -3214,7 +3263,8 @@ function createRemotePlugin() {
               description: args.description,
               type: args.type,
               priority: args.priority,
-              assigned_role_id: args.assigned_role_id
+              assigned_role_id: args.assigned_role_id,
+              epic_id: args.epic_id
             });
             if (!result.ok) {
               return {
@@ -3241,7 +3291,7 @@ function createRemotePlugin() {
         {
           name: "remote_update_task",
           label: "Update a task on the Remote project board",
-          description: "Update an existing task on the Remote project board. Specify the task_id and any fields to change: status (todo/in_progress/review/done), priority, assigned_to, title, or description.",
+          description: "Update an existing task on the Remote project board. Specify the task_id and any fields to change: status (todo/in_progress/review/done), priority, assigned_to, title, description, type, epic_id, or assigned_role_id.",
           parameters: Type.Object({
             task_id: Type.String({ description: "ID of the task to update" }),
             status: optionalStringEnum(["todo", "in_progress", "review", "done"], {
@@ -3254,7 +3304,16 @@ function createRemotePlugin() {
               Type.String({ description: "User or role to assign the task to" })
             ),
             title: Type.Optional(Type.String({ description: "New task title" })),
-            description: Type.Optional(Type.String({ description: "New task description" }))
+            description: Type.Optional(Type.String({ description: "New task description" })),
+            type: optionalStringEnum(["feature", "task", "bug"], {
+              description: "New type: feature, task, or bug"
+            }),
+            epic_id: Type.Optional(
+              Type.String({ description: "Epic ID to group the task under (or null to remove)" })
+            ),
+            assigned_role_id: Type.Optional(
+              Type.String({ description: "Role ID to assign the task to" })
+            )
           }),
           execute: async (_toolCallId, args) => {
             const account = resolveAccount(cfg ?? {});
@@ -3344,27 +3403,205 @@ function createRemotePlugin() {
           parameters: Type.Object({}),
           execute: async (_toolCallId, _args) => {
             const account = resolveAccount(cfg ?? {});
-            const result = await getHeartbeat(account);
+            const result = await getBoardHealth(account);
             if (!result.ok) {
+              const legacyResult = await getHeartbeat(account);
+              if (!legacyResult.ok) {
+                return {
+                  content: [{ type: "text", text: `\u274C Failed to get board health: ${result.error}` }],
+                  details: { ok: false, error: result.error }
+                };
+              }
+              const h2 = legacyResult.data;
+              const text = [
+                `\u{1F4CA} **Board Health Summary** (legacy)`,
+                "",
+                `- **Pending tasks**: ${h2.pending_tasks}`,
+                `- **In progress**: ${h2.in_progress_tasks}`,
+                `- **Unassigned**: ${h2.unassigned_tasks}`,
+                `- **Activity (24h)**: ${h2.recent_activity_24h}`,
+                `- **My roles**: ${h2.my_roles?.join(", ") || "none"}`
+              ].join("\n");
               return {
-                content: [{ type: "text", text: `\u274C Failed to get board health: ${result.error}` }],
-                details: { ok: false, error: result.error }
+                content: [{ type: "text", text }],
+                details: { ok: true, heartbeat: h2 }
               };
             }
             const h = result.data;
-            const text = [
-              `\u{1F4CA} **Board Health Summary**`,
+            const s = h.stats;
+            const lines = [
+              `\u{1F4CA} **Board Health \u2014 ${h.project.name}**`,
               "",
-              `- **Pending tasks**: ${h.pending_tasks}`,
-              `- **In progress**: ${h.in_progress_tasks}`,
-              `- **Unassigned**: ${h.unassigned_tasks}`,
-              `- **Activity (24h)**: ${h.recent_activity_24h}`,
-              `- **My roles**: ${h.my_roles?.join(", ") || "none"}`,
-              `- **Checked at**: ${h.checked_at}`
-            ].join("\n");
+              `**Tasks** (${s.total_tasks} total):`,
+              `  todo: ${s.by_status.todo} | in_progress: ${s.by_status.in_progress} | review: ${s.by_status.review} | done: ${s.by_status.done}`,
+              `  unassigned: ${s.unassigned}`,
+              "",
+              `**By priority**: urgent: ${s.by_priority.urgent} | high: ${s.by_priority.high} | medium: ${s.by_priority.medium} | low: ${s.by_priority.low}`
+            ];
+            if (h.epics.length > 0) {
+              lines.push("", "**Epics**:");
+              for (const e of h.epics) {
+                lines.push(`  - ${e.name} (${e.task_count} tasks)`);
+              }
+            }
+            if (h.roles.length > 0) {
+              lines.push("", "**Roles**:");
+              for (const r of h.roles) {
+                const assignee = r.assigned_to ? `${r.assigned_to.type}: ${r.assigned_to.name}` : "vacant";
+                lines.push(`  - ${r.name} [${r.category}] \u2192 ${assignee}`);
+              }
+            }
+            if (h.recent_activity.length > 0) {
+              lines.push("", `**Recent activity** (last ${h.recent_activity.length}):`);
+              for (const a of h.recent_activity.slice(0, 5)) {
+                const meta = a.metadata;
+                lines.push(`  - ${a.action}: ${meta?.title || a.target_id} (${a.actor_type})`);
+              }
+            }
+            return {
+              content: [{ type: "text", text: lines.join("\n") }],
+              details: { ok: true, health: h }
+            };
+          }
+        },
+        // 5. remote_list_roles
+        {
+          name: "remote_list_roles",
+          label: "List project roles",
+          description: "List project roles with assignment info. Use to find valid assigned_role_id values for task creation.",
+          parameters: Type.Object({}),
+          execute: async (_toolCallId, _args) => {
+            const account = resolveAccount(cfg ?? {});
+            const result = await listRoles(account);
+            if (!result.ok) {
+              return {
+                content: [{ type: "text", text: `\u274C Failed to list roles: ${result.error}` }],
+                details: { ok: false, error: result.error }
+              };
+            }
+            const roles = result.data.roles;
+            if (roles.length === 0) {
+              return {
+                content: [{ type: "text", text: "\u{1F4CB} No roles configured for this project." }],
+                details: { ok: true, roles: [] }
+              };
+            }
+            const lines = [`\u{1F465} **${roles.length} role(s):**`, ""];
+            for (const r of roles) {
+              const assignee = r.assigned_to ? `${r.assigned_to.type}: ${r.assigned_to.name}` : "\u{1F534} vacant";
+              const mine = r.is_mine ? " \u2B50" : "";
+              lines.push(`- **${r.name}** [${r.category}] \u2192 ${assignee}${mine} (id: ${r.id})`);
+            }
+            return {
+              content: [{ type: "text", text: lines.join("\n") }],
+              details: { ok: true, roles }
+            };
+          }
+        },
+        // 6. remote_list_epics
+        {
+          name: "remote_list_epics",
+          label: "List epics",
+          description: "List epics for the project. Use to find valid epic_id values for task grouping.",
+          parameters: Type.Object({}),
+          execute: async (_toolCallId, _args) => {
+            const account = resolveAccount(cfg ?? {});
+            const result = await listEpics(account);
+            if (!result.ok) {
+              return {
+                content: [{ type: "text", text: `\u274C Failed to list epics: ${result.error}` }],
+                details: { ok: false, error: result.error }
+              };
+            }
+            const epics = result.data.epics;
+            if (epics.length === 0) {
+              return {
+                content: [{ type: "text", text: "\u{1F4CB} No epics found. Use `remote_create_epic` to create one." }],
+                details: { ok: true, epics: [] }
+              };
+            }
+            const lines = [`\u{1F4E6} **${epics.length} epic(s):**`, ""];
+            for (const e of epics) {
+              lines.push(`- **${e.name}** (${e.task_count ?? 0} tasks) (id: ${e.id})`);
+              if (e.description) {
+                const desc = e.description.length > 80 ? e.description.slice(0, 80) + "\u2026" : e.description;
+                lines.push(`  ${desc}`);
+              }
+            }
+            return {
+              content: [{ type: "text", text: lines.join("\n") }],
+              details: { ok: true, epics }
+            };
+          }
+        },
+        // 7. remote_create_epic
+        {
+          name: "remote_create_epic",
+          label: "Create an epic",
+          description: "Create a new epic on the Remote project board. Specify name, and optionally description and color.",
+          parameters: Type.Object({
+            name: Type.String({ description: "Epic name" }),
+            description: Type.Optional(Type.String({ description: "Epic description" })),
+            color: Type.Optional(Type.String({ description: "Epic color (hex, e.g. #6366f1)" }))
+          }),
+          execute: async (_toolCallId, args) => {
+            const account = resolveAccount(cfg ?? {});
+            const result = await createEpic(account, {
+              name: args.name,
+              description: args.description,
+              color: args.color
+            });
+            if (!result.ok) {
+              return {
+                content: [{ type: "text", text: `\u274C Failed to create epic: ${result.error}` }],
+                details: { ok: false, error: result.error }
+              };
+            }
+            const epic = result.data.epic;
+            const text = [
+              `\u2705 Epic created!`,
+              `- **Name**: ${epic.name}`,
+              `- **ID**: ${epic.id}`,
+              epic.color ? `- **Color**: ${epic.color}` : null
+            ].filter(Boolean).join("\n");
             return {
               content: [{ type: "text", text }],
-              details: { ok: true, heartbeat: h }
+              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 }
             };
           }
         }
@@ -3379,10 +3616,14 @@ function createRemotePlugin() {
         "**Replying**: When you reply to a task notification, your reply is posted as a comment on that task.",
         "",
         "**Available tools**:",
-        "- `remote_create_task` \u2014 Create a new task (specify title, type, priority, etc.)",
-        "- `remote_update_task` \u2014 Update a task (change status, priority, assignment, etc.)",
+        "- `remote_create_task` \u2014 Create a new task (title, type, priority, assigned_role_id, epic_id)",
+        "- `remote_update_task` \u2014 Update a task (status, priority, title, description, type, epic_id, assigned_role_id)",
         "- `remote_list_tasks` \u2014 List/filter tasks on the board",
-        "- `remote_board_health` \u2014 Get board health stats (pending, in-progress, unassigned counts)",
+        "- `remote_board_health` \u2014 Get board health stats (task counts, epics, roles, recent activity)",
+        "- `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",
@@ -3392,7 +3633,11 @@ function createRemotePlugin() {
         "- When assigned a task, acknowledge it and move to in_progress",
         "- Use comments to communicate progress and blockers",
         "- Move tasks to review when ready for review, done when complete",
-        "- Keep task descriptions and comments clear and actionable"
+        "- 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_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.2.1",
+  "version": "0.3.1",
   "description": "Remote project board channel plugin for OpenClaw",
   "type": "module",
   "main": "dist/index.js",