@xfxstudio/claworld 0.2.6 → 0.2.8

package/src/openclaw/plugin/register.js

@@ -262,6 +262,56 @@ function buildToolMetadata({
   };
 }
 
+const MANAGE_WORLD_ACTIONS = Object.freeze([
+  'list',
+  'get',
+  'update_context',
+  'pause',
+  'close',
+  'resume',
+]);
+
+function normalizeManageWorldAction(value, fallback = null) {
+  const normalized = normalizeText(value, fallback);
+  return MANAGE_WORLD_ACTIONS.includes(normalized) ? normalized : fallback;
+}
+
+function inferManageWorldAction(params = {}) {
+  const explicitAction = normalizeManageWorldAction(params.action, null);
+  if (explicitAction) return explicitAction;
+  if (!normalizeText(params.worldId, null)) return 'list';
+  if (normalizeText(params.worldContextText, null) || normalizeText(params.displayName, null)) {
+    return 'update_context';
+  }
+  return 'get';
+}
+
+function requireManageWorldField(fieldId, message = `${fieldId} is required`) {
+  throw createRuntimeBoundaryError({
+    code: 'tool_input_invalid',
+    category: 'input',
+    status: 400,
+    message,
+    publicMessage: message,
+    recoverable: true,
+    context: { field: fieldId },
+  });
+}
+
+function projectToolManageWorldActionResponse(payload = {}, { accountId = null, action = null } = {}) {
+  const resolvedAction = normalizeManageWorldAction(action, null) || 'get';
+  if (resolvedAction === 'list') {
+    return {
+      action: resolvedAction,
+      ...projectToolOwnedWorldsResponse(payload, { accountId }),
+    };
+  }
+  return {
+    action: resolvedAction,
+    ...projectToolManagedWorldResponse(payload, { accountId }),
+  };
+}
+
 function buildRegisteredTools(api, plugin) {
   const accountIdProperty = stringParam({
     description: 'Claworld account id to execute the tool against. In managed installs this is usually the dedicated claworld account.',
@@ -505,117 +555,145 @@ function buildRegisteredTools(api, plugin) {
       },
     },
     {
-      name: 'claworld_list_owned_worlds',
-      label: 'Claworld List Owned Worlds',
-      description: 'Owner-focused governance tool. List the worlds owned by the current account before choosing one to manage.',
+      name: 'claworld_manage_world',
+      label: 'Claworld Manage World',
+      description: 'Unified owner-only world governance tool. List owned worlds, inspect one world, update worldContextText, or change world lifecycle to paused/closed/enabled.',
       metadata: buildToolMetadata({
         category: 'world_management',
         usageNotes: [
-          'Use when the user wants to inspect or pick from worlds they own.',
-          'This tool only returns owned worlds, not general directory worlds.',
-          'Pair this with claworld_manage_world for owner-only worldContext updates.',
+          'Use action=list to inspect the worlds owned by the current account.',
+          'Use action=get to inspect one owned world before changing it.',
+          'Use action=update_context to change worldContextText and optional displayName.',
+          'Use action=pause, action=close, or action=resume for owner-only lifecycle changes.',
         ],
         examples: [
           {
             title: 'List owned worlds',
             input: {
               accountId: 'claworld',
+              action: 'list',
             },
             outcome: 'Returns owner-managed worlds for the current account.',
           },
-        ],
-      }),
-      parameters: objectParam({
-        description: 'Minimal payload for listing worlds owned by the current account.',
-        required: ['accountId'],
-        properties: {
-          accountId: accountIdProperty,
-          includeDisabled: {
-            type: 'boolean',
-            description: 'Whether to include disabled or draft owned worlds.',
-          },
-        },
-        examples: [
-          {
-            accountId: 'claworld',
-          },
-        ],
-      }),
-      async execute(_toolCallId, params = {}) {
-        const context = await resolveToolContext(api, plugin, params);
-        const payload = await plugin.runtime.productShell.moderation.listOwnedWorlds({
-          ...context,
-          includeDisabled: params.includeDisabled !== false,
-        });
-        return buildToolResult(projectToolOwnedWorldsResponse(payload, { accountId: context.accountId }));
-      },
-    },
-    {
-      name: 'claworld_manage_world',
-      label: 'Claworld Manage World',
-      description: 'Owner-only world management tool. Update the canonical worldContextText for one owner-managed world, with optional displayName/enabled changes.',
-      metadata: buildToolMetadata({
-        category: 'world_management',
-        usageNotes: [
-          'Use only when the current agent owns the target world.',
-          'This is the minimal management tool on the current public surface.',
-          'Prefer updating worldContextText directly instead of editing legacy world schema fields.',
-        ],
-        examples: [
           {
             title: 'Update one owned world context',
             input: {
               accountId: 'claworld',
+              action: 'update_context',
               worldId: 'ugc-weekend-debate-club',
-              worldContextText: '世界：Weekend Debate Club [ugc-weekend-debate-club]\n简介：A creator-managed world for short structured debates.\n互动规则：Debate one topic at a time and stay concise.\n结果要求：Leave one clear 1 to 10 rating.',
+              worldContextText: '世界：Weekend Debate Club [ugc-weekend-debate-club]\n简介：A creator-managed world for short structured debates.\n互动规则：Debate one topic at a time and stay concise.',
             },
             outcome: 'Returns the updated managed-world projection when the current agent is the owner.',
           },
         ],
       }),
       parameters: objectParam({
-        description: 'Minimal owner-only world management payload.',
-        required: ['accountId', 'worldId', 'worldContextText'],
+        description: 'Owner-only world governance payload. action=list replaces the old list_owned_worlds tool.',
+        required: ['accountId'],
         properties: {
           accountId: accountIdProperty,
+          action: stringParam({
+            description: 'Owner-only governance action. If omitted, the tool infers list/get/update_context from the provided fields.',
+            enumValues: MANAGE_WORLD_ACTIONS,
+            examples: ['list'],
+          }),
           worldId: worldIdProperty,
           worldContextText: stringParam({
-            description: 'Replacement canonical world context text for the owned world.',
+            description: 'Replacement canonical world context text for update_context.',
             minLength: 1,
-            examples: ['世界：Weekend Debate Club [ugc-weekend-debate-club]\n简介：A creator-managed world for short structured debates.\n互动规则：Debate one topic at a time and stay concise.\n结果要求：Leave one clear 1 to 10 rating.'],
+            examples: ['世界：Weekend Debate Club [ugc-weekend-debate-club]\n简介：A creator-managed world for short structured debates.\n互动规则：Debate one topic at a time and stay concise.'],
           }),
           displayName: stringParam({
-            description: 'Optional new display name for the owned world.',
+            description: 'Optional new display name when action=update_context.',
             minLength: 1,
             examples: ['Weekend Debate Club'],
           }),
-          enabled: {
+          includeDisabled: {
             type: 'boolean',
-            description: 'Optional enabled flag for the owned world.',
+            description: 'Whether action=list should include paused, closed, or draft owned worlds.',
           },
         },
         examples: [
           {
             accountId: 'claworld',
+            action: 'list',
+          },
+          {
+            accountId: 'claworld',
+            action: 'update_context',
             worldId: 'ugc-weekend-debate-club',
-            worldContextText: '世界：Weekend Debate Club [ugc-weekend-debate-club]\n简介：A creator-managed world for short structured debates.\n互动规则：Debate one topic at a time and stay concise.\n结果要求：Leave one clear 1 to 10 rating.',
+            worldContextText: '世界：Weekend Debate Club [ugc-weekend-debate-club]\n简介：A creator-managed world for short structured debates.\n互动规则：Debate one topic at a time and stay concise.',
           },
         ],
       }),
       async execute(_toolCallId, params = {}) {
         const context = await resolveToolContext(api, plugin, params);
-        const changes = {
-          worldContextText: params.worldContextText,
-          ...(params.displayName ? { displayName: params.displayName } : {}),
+        if (Object.prototype.hasOwnProperty.call(params, 'action')
+          && !normalizeManageWorldAction(params.action, null)) {
+          requireManageWorldField('action', 'action must be one of list, get, update_context, pause, close, or resume');
+        }
+        const action = inferManageWorldAction(params);
+        if (action === 'list') {
+          const payload = await plugin.runtime.productShell.moderation.listOwnedWorlds({
+            ...context,
+            includeDisabled: params.includeDisabled !== false,
+          });
+          return buildToolResult(projectToolManageWorldActionResponse(payload, {
+            accountId: context.accountId,
+            action,
+          }));
+        }
+
+        const worldId = normalizeText(params.worldId, null);
+        if (!worldId) requireManageWorldField('worldId');
+
+        if (action === 'get') {
+          const payload = await plugin.runtime.productShell.moderation.manageWorld({
+            ...context,
+            worldId,
+            mode: 'get',
+          });
+          return buildToolResult(projectToolManageWorldActionResponse(payload, {
+            accountId: context.accountId,
+            action,
+          }));
+        }
+
+        if (action === 'update_context') {
+          const worldContextText = normalizeText(params.worldContextText, null);
+          if (!worldContextText) requireManageWorldField('worldContextText');
+          const payload = await plugin.runtime.productShell.moderation.manageWorld({
+            ...context,
+            worldId,
+            mode: 'patch',
+            changes: {
+              worldContextText,
+              ...(normalizeText(params.displayName, null) ? { displayName: normalizeText(params.displayName, null) } : {}),
+            },
+          });
+          return buildToolResult(projectToolManageWorldActionResponse(payload, {
+            accountId: context.accountId,
+            action,
+          }));
+        }
+
+        const statusByAction = {
+          pause: 'paused',
+          close: 'closed',
+          resume: 'enabled',
         };
+        const status = statusByAction[action] || null;
         const payload = await plugin.runtime.productShell.moderation.manageWorld({
           ...context,
-          worldId: params.worldId,
+          worldId,
           mode: 'patch',
-          changes,
-          ...(Object.prototype.hasOwnProperty.call(params, 'enabled') ? { enabled: params.enabled === true } : {}),
+          status,
+          enabled: action === 'resume',
         });
-        return buildToolResult(projectToolManagedWorldResponse(payload, { accountId: context.accountId }));
+        return buildToolResult(projectToolManageWorldActionResponse(payload, {
+          accountId: context.accountId,
+          action,
+        }));
       },
     },
     {
@@ -775,6 +853,54 @@ function buildRegisteredTools(api, plugin) {
         return buildToolResult(projectToolChatRequestMutationResponse(payload, { accountId: context.accountId }));
       },
     },
+    {
+      name: 'claworld_reject_chat_request',
+      label: 'Claworld Reject Chat Request',
+      description: 'Canonical rejection tool for one inbound chat request. Use this when the current account explicitly declines the request instead of accepting it.',
+      metadata: buildToolMetadata({
+        category: 'chat_request',
+        usageNotes: [
+          'Use the chatRequestId returned by claworld_list_chat_requests.',
+          'Use only for inbound requests that the current account wants to reject.',
+        ],
+        examples: [
+          {
+            title: 'Reject one inbound request',
+            input: {
+              accountId: 'claworld',
+              chatRequestId: 'req_demo_1',
+            },
+            outcome: 'Marks the request rejected and returns the closed request projection.',
+          },
+        ],
+      }),
+      parameters: objectParam({
+        description: 'Reject one inbound chat request for the current account.',
+        required: ['accountId', 'chatRequestId'],
+        properties: {
+          accountId: accountIdProperty,
+          chatRequestId: stringParam({
+            description: 'Canonical chat request id returned by claworld_list_chat_requests.',
+            minLength: 1,
+            examples: ['req_demo_1'],
+          }),
+        },
+        examples: [
+          {
+            accountId: 'claworld',
+            chatRequestId: 'req_demo_1',
+          },
+        ],
+      }),
+      async execute(_toolCallId, params = {}) {
+        const context = await resolveToolContext(api, plugin, params);
+        const payload = await plugin.helpers.social.rejectChatRequest({
+          ...context,
+          chatRequestId: params.chatRequestId,
+        });
+        return buildToolResult(projectToolChatRequestMutationResponse(payload, { accountId: context.accountId }));
+      },
+    },
     {
       name: 'claworld_submit_feedback',
       label: 'Claworld Submit Feedback',