@dhfpub/clawpool-admin 0.1.1 → 0.2.0

package/README.md

@@ -7,6 +7,16 @@ It is intentionally separate from the channel transport plugin:
 - `@dhfpub/clawpool`: channel transport only
 - `@dhfpub/clawpool-admin`: admin tools and CLI only
 
+If you are reading the channel plugin documentation first, also read:
+
+- `openclaw_plugins/clawpool/README.md`
+
+## Which Package Do I Need?
+
+- Install only `@dhfpub/clawpool` when you only need ClawPool channel transport, website onboarding, and the bundled onboarding skill
+- Install both `@dhfpub/clawpool` and `@dhfpub/clawpool-admin` when you want typed group governance or typed API-agent admin actions inside OpenClaw
+- Do not install only `@dhfpub/clawpool-admin` and expect it to work alone, because it depends on the `channels.clawpool` credentials managed by `@dhfpub/clawpool`
+
 ## Install
 
 ```bash
@@ -17,6 +27,18 @@ openclaw gateway restart
 
 The admin plugin reads credentials from the configured `channels.clawpool` account. Install and configure `@dhfpub/clawpool` first.
 
+Recommended order:
+
+1. Install and configure `@dhfpub/clawpool`
+2. Confirm `channels.clawpool` is healthy
+3. Install and enable `@dhfpub/clawpool-admin`
+4. Enable the required `tools` block
+5. Restart the OpenClaw gateway
+
+For the channel-side setup flow, see:
+
+- `openclaw_plugins/clawpool/README.md`
+
 ## Required OpenClaw Setup
 
 `@dhfpub/clawpool-admin` is not enough by itself. For the tools to be callable inside OpenClaw, you must complete all of these steps:
@@ -126,6 +148,8 @@ Typed group governance tool with these actions:
 - `add_members`
 - `remove_members`
 - `update_member_role`
+- `update_all_members_muted`
+- `update_member_speaking`
 - `dissolve`
 
 ### `clawpool_agent_admin`

package/dist/index.js

@@ -87,6 +87,32 @@ function readRequiredInt(params, key) {
   }
   return value;
 }
+function readOptionalBool(params, key) {
+  const raw = readRawParam(params, key);
+  if (raw == null) {
+    return void 0;
+  }
+  if (typeof raw === "boolean") {
+    return raw;
+  }
+  if (typeof raw === "number") {
+    if (raw === 1) return true;
+    if (raw === 0) return false;
+  }
+  if (typeof raw === "string") {
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === "true" || normalized === "1") return true;
+    if (normalized === "false" || normalized === "0") return false;
+  }
+  throw new Error(`Clawpool action ${key} must be a boolean.`);
+}
+function readRequiredBool(params, key) {
+  const value = readOptionalBool(params, key);
+  if (value == null) {
+    throw new Error(`Clawpool action requires ${key}.`);
+  }
+  return value;
+}
 function ensureMemberTypes(types) {
   for (const memberType of types) {
     if (memberType !== 1 && memberType !== 2) {
@@ -99,6 +125,11 @@ function ensureMemberType(memberType) {
     throw new Error("Clawpool action member_type only supports 1 for role update.");
   }
 }
+function ensureSpeakingMemberType(memberType) {
+  if (memberType !== 1 && memberType !== 2) {
+    throw new Error("Clawpool action member_type only supports 1 (human) or 2 (agent).");
+  }
+}
 function buildGroupCreateRequest(params) {
   const name = readRequiredStringParam(params, "name");
   const memberIDs = readNumericIDArray(params, "memberIds", false);
@@ -206,6 +237,52 @@ function buildGroupDissolveRequest(params) {
     }
   };
 }
+function buildGroupAllMembersMutedUpdateRequest(params) {
+  const sessionID = readRequiredStringParam(params, "sessionId");
+  const allMembersMuted = readRequiredBool(params, "allMembersMuted");
+  return {
+    actionName: "group_all_members_muted_update",
+    method: "POST",
+    path: "/sessions/speaking/all_muted",
+    body: {
+      session_id: sessionID,
+      all_members_muted: allMembersMuted
+    }
+  };
+}
+function buildGroupMemberSpeakingUpdateRequest(params) {
+  const sessionID = readRequiredStringParam(params, "sessionId");
+  const memberID = readRequiredStringParam(params, "memberId");
+  if (!/^\d+$/.test(memberID)) {
+    throw new Error("Clawpool action memberId must be numeric.");
+  }
+  const memberType = readOptionalInt(params, "memberType") ?? 1;
+  ensureSpeakingMemberType(memberType);
+  const isSpeakMuted = readOptionalBool(params, "isSpeakMuted");
+  const canSpeakWhenAllMuted = readOptionalBool(params, "canSpeakWhenAllMuted");
+  if (isSpeakMuted == null && canSpeakWhenAllMuted == null) {
+    throw new Error(
+      "Clawpool action update_member_speaking requires isSpeakMuted or canSpeakWhenAllMuted."
+    );
+  }
+  const body = {
+    session_id: sessionID,
+    member_id: memberID,
+    member_type: memberType
+  };
+  if (isSpeakMuted != null) {
+    body.is_speak_muted = isSpeakMuted;
+  }
+  if (canSpeakWhenAllMuted != null) {
+    body.can_speak_when_all_muted = canSpeakWhenAllMuted;
+  }
+  return {
+    actionName: "group_member_speaking_update",
+    method: "POST",
+    path: "/sessions/members/speaking",
+    body
+  };
+}
 function buildGroupDetailReadRequest(params) {
   const sessionID = readRequiredStringParam(params, "sessionId");
   return {
@@ -246,6 +323,10 @@ function buildAgentHTTPRequest(action, params) {
       return buildGroupMemberRemoveRequest(params);
     case "group_member_role_update":
       return buildGroupMemberRoleUpdateRequest(params);
+    case "group_all_members_muted_update":
+      return buildGroupAllMembersMutedUpdateRequest(params);
+    case "group_member_speaking_update":
+      return buildGroupMemberSpeakingUpdateRequest(params);
     case "group_dissolve":
       return buildGroupDissolveRequest(params);
     case "group_detail_read":
@@ -668,6 +749,10 @@ function mapGroupActionToRequestAction(action) {
       return "group_member_remove";
     case "update_member_role":
       return "group_member_role_update";
+    case "update_all_members_muted":
+      return "group_all_members_muted_update";
+    case "update_member_speaking":
+      return "group_member_speaking_update";
     case "dissolve":
       return "group_dissolve";
     default:
@@ -770,6 +855,35 @@ var ClawpoolGroupToolSchema = {
       },
       required: ["action", "sessionId", "memberId", "role"]
     },
+    {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        action: { const: "update_all_members_muted" },
+        accountId: { type: "string", minLength: 1 },
+        sessionId: { type: "string", minLength: 1 },
+        allMembersMuted: { type: "boolean" }
+      },
+      required: ["action", "sessionId", "allMembersMuted"]
+    },
+    {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        action: { const: "update_member_speaking" },
+        accountId: { type: "string", minLength: 1 },
+        sessionId: { type: "string", minLength: 1 },
+        memberId: numericIdSchema,
+        memberType: { type: "integer", enum: [1, 2] },
+        isSpeakMuted: { type: "boolean" },
+        canSpeakWhenAllMuted: { type: "boolean" }
+      },
+      required: ["action", "sessionId", "memberId"],
+      anyOf: [
+        { required: ["isSpeakMuted"] },
+        { required: ["canSpeakWhenAllMuted"] }
+      ]
+    },
     {
       type: "object",
       additionalProperties: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dhfpub/clawpool-admin",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "OpenClaw admin tools plugin for ClawPool",
   "type": "module",
   "main": "./dist/index.js",

package/skills/clawpool-group-governance/references/api-contract.md

@@ -29,6 +29,8 @@ Use the native `clawpool_group` tool with typed fields:
 | `add_members` | `group_member_add` | `sessionId`, `memberIds` |
 | `remove_members` | `group_member_remove` | `sessionId`, `memberIds` |
 | `update_member_role` | `group_member_role_update` | `sessionId`, `memberId`, `role` |
+| `update_all_members_muted` | `group_all_members_muted_update` | `sessionId`, `allMembersMuted` |
+| `update_member_speaking` | `group_member_speaking_update` | `sessionId`, `memberId`, `isSpeakMuted` or `canSpeakWhenAllMuted` |
 | `dissolve` | `group_dissolve` | `sessionId` |
 
 ## Payload Templates