@xfxstudio/claworld 2026.4.14-testing.1 → 2026.4.16-testing.1

package/src/openclaw/runtime/tool-inventory.js

@@ -1,83 +0,0 @@
-export const CLAWORLD_TOOL_CONTRACT_VERSION = 'v1';
-
-export const CLAWORLD_CHAT_REQUEST_TOOL_NAMES = Object.freeze([
-  'claworld_request_chat',
-  'claworld_chat_inbox',
-]);
-
-export const CLAWORLD_ACCOUNT_TOOL_NAMES = Object.freeze([
-  'claworld_account',
-]);
-
-export const CLAWORLD_FEEDBACK_TOOL_NAMES = Object.freeze([
-  'claworld_submit_feedback',
-]);
-
-export const CLAWORLD_WORLD_TOOL_NAMES = Object.freeze([
-  'claworld_search_worlds',
-  'claworld_list_worlds',
-  'claworld_get_world_detail',
-  'claworld_join_world',
-  'claworld_search_world_members',
-  'claworld_get_candidate_feed',
-]);
-
-export const CLAWORLD_WORLD_ADMIN_PUBLIC_TOOL_NAMES = Object.freeze([
-  'claworld_create_world',
-  'claworld_manage_world',
-]);
-
-export const CLAWORLD_REGISTERED_TOOL_NAMES = Object.freeze([
-  ...CLAWORLD_ACCOUNT_TOOL_NAMES,
-  ...CLAWORLD_WORLD_TOOL_NAMES,
-  ...CLAWORLD_WORLD_ADMIN_PUBLIC_TOOL_NAMES,
-  ...CLAWORLD_CHAT_REQUEST_TOOL_NAMES,
-  ...CLAWORLD_FEEDBACK_TOOL_NAMES,
-]);
-
-export const CLAWORLD_PUBLIC_TOOL_NAMES = Object.freeze([
-  ...CLAWORLD_REGISTERED_TOOL_NAMES,
-]);
-
-export const CLAWORLD_MINIMAL_OPENCLAW_TOOL_NAMES = Object.freeze([
-  'session_status',
-]);
-
-export const CLAWORLD_READ_ONLY_OPENCLAW_TOOL_NAMES = Object.freeze([
-  'memory_search',
-  'memory_get',
-  'read',
-  'sessions_list',
-  'sessions_history',
-]);
-
-export const CLAWORLD_PLUGIN_SMOKE_REQUIRED_TOOL_NAMES = Object.freeze([
-  ...CLAWORLD_ACCOUNT_TOOL_NAMES,
-  ...CLAWORLD_WORLD_TOOL_NAMES,
-  ...CLAWORLD_WORLD_ADMIN_PUBLIC_TOOL_NAMES,
-  ...CLAWORLD_CHAT_REQUEST_TOOL_NAMES,
-  ...CLAWORLD_FEEDBACK_TOOL_NAMES,
-]);
-
-export const CLAWORLD_TOOL_PROFILES = Object.freeze({
-  minimal: Object.freeze([
-    ...CLAWORLD_PUBLIC_TOOL_NAMES,
-    ...CLAWORLD_MINIMAL_OPENCLAW_TOOL_NAMES,
-  ]),
-  default: Object.freeze([
-    ...CLAWORLD_PUBLIC_TOOL_NAMES,
-    ...CLAWORLD_MINIMAL_OPENCLAW_TOOL_NAMES,
-    ...CLAWORLD_READ_ONLY_OPENCLAW_TOOL_NAMES,
-  ]),
-  world: Object.freeze([
-    ...CLAWORLD_PUBLIC_TOOL_NAMES,
-    ...CLAWORLD_MINIMAL_OPENCLAW_TOOL_NAMES,
-    ...CLAWORLD_READ_ONLY_OPENCLAW_TOOL_NAMES,
-  ]),
-  full: Object.freeze([
-    ...CLAWORLD_PUBLIC_TOOL_NAMES,
-    ...CLAWORLD_MINIMAL_OPENCLAW_TOOL_NAMES,
-    ...CLAWORLD_READ_ONLY_OPENCLAW_TOOL_NAMES,
-    '*',
-  ]),
-});

package/src/openclaw/runtime/world-membership-helper.js

@@ -1,320 +0,0 @@
-import { resolveClaworldRuntimeConfig } from '../plugin/config-schema.js';
-import { buildRuntimeAuthHeaders } from '../plugin/account-identity.js';
-import { createRuntimeBoundaryError } from '../../lib/runtime-errors.js';
-import { extractBackendErrorContext } from './backend-error-context.js';
-
-function normalizeText(value, fallback = null) {
-  if (value == null) return fallback;
-  const normalized = String(value).trim();
-  return normalized || fallback;
-}
-
-function normalizeOptionalBoolean(value, fallback = null) {
-  if (typeof value === 'boolean') return value;
-  return fallback;
-}
-
-function normalizeWorldRole(worldRole, fallback = null) {
-  const normalized = normalizeText(worldRole, fallback);
-  return ['owner', 'member'].includes(normalized) ? normalized : fallback;
-}
-
-function normalizeManagedWorldMembership(payload = {}) {
-  return {
-    membershipId: normalizeText(payload.membershipId, null),
-    worldId: normalizeText(payload.worldId, null),
-    displayName: normalizeText(payload.displayName, null),
-    worldContextText: normalizeText(payload.worldContextText, null),
-    ownerAgentId: normalizeText(payload.ownerAgentId, null),
-    enabled: normalizeOptionalBoolean(payload.enabled, null),
-    worldStatus: normalizeText(payload.worldStatus, null),
-    worldRole: normalizeWorldRole(payload.worldRole, null),
-    membershipStatus: normalizeText(payload.membershipStatus, null),
-    participantContextText: normalizeText(payload.participantContextText, null),
-    joinedAt: normalizeText(payload.joinedAt, null),
-    updatedAt: normalizeText(payload.updatedAt, null),
-    nextAction: normalizeText(payload.nextAction, null),
-  };
-}
-
-function normalizeMembershipList(payload = {}) {
-  return {
-    items: Array.isArray(payload.items)
-      ? payload.items.map((item) => normalizeManagedWorldMembership(item))
-      : [],
-    nextAction: normalizeText(payload.nextAction, null),
-  };
-}
-
-async function fetchJson(fetchImpl, url, init = {}) {
-  let response;
-  try {
-    response = await fetchImpl(url, init);
-  } catch (error) {
-    throw createRuntimeBoundaryError({
-      code: 'relay_fetch_failed',
-      category: 'transport',
-      status: 502,
-      message: `fetch failed: ${error?.message || String(error)}`,
-      publicMessage: 'relay fetch failed',
-      recoverable: true,
-      context: {
-        fetchUrl: url,
-        fetchMethod: init?.method || 'GET',
-      },
-      cause: error,
-    });
-  }
-  let body = null;
-  try {
-    body = await response.json();
-  } catch {
-    body = null;
-  }
-  return { ok: response.ok, status: response.status, body };
-}
-
-function normalizeRelayHttpBaseUrl(serverUrl) {
-  const parsed = new URL(serverUrl);
-  if (parsed.protocol === 'ws:') parsed.protocol = 'http:';
-  if (parsed.protocol === 'wss:') parsed.protocol = 'https:';
-  parsed.pathname = '';
-  parsed.search = '';
-  parsed.hash = '';
-  return parsed.toString().replace(/\/$/, '');
-}
-
-function inferHttpErrorCategory(status) {
-  if (status === 401) return 'auth';
-  if (status === 403) return 'policy';
-  if (status === 404) return 'input';
-  if (status === 409) return 'conflict';
-  if (status >= 400 && status < 500) return 'input';
-  return 'runtime';
-}
-
-function createWorldMembershipHttpError(action, response, { accountId = null, worldId = null } = {}) {
-  const backendCode = normalizeText(response?.body?.error, null);
-  const backendMessage = normalizeText(response?.body?.message, `claworld world membership ${action} failed`);
-
-  return createRuntimeBoundaryError({
-    code: backendCode || `claworld_world_membership_${action}_failed`,
-    category: inferHttpErrorCategory(response?.status),
-    status: response?.status ?? 500,
-    message: `claworld world membership ${action} failed: ${response?.status ?? 500}`,
-    publicMessage: backendMessage,
-    recoverable: Number(response?.status) >= 400 && Number(response?.status) < 500,
-    context: {
-      action: `world_membership_${action}`,
-      accountId,
-      ...(worldId ? { worldId } : {}),
-      httpStatus: response?.status ?? 500,
-      ...extractBackendErrorContext(response?.body),
-    },
-  });
-}
-
-export async function fetchWorldMemberships({
-  cfg = {},
-  accountId = null,
-  runtimeConfig = null,
-  agentId = null,
-  status = null,
-  includeInactive = false,
-  includeDisabled = true,
-  fetchImpl,
-  logger = console,
-} = {}) {
-  if (typeof fetchImpl !== 'function') {
-    throw new Error('fetch is unavailable for claworld world membership helper');
-  }
-
-  const resolvedAgentId = normalizeText(agentId, null);
-  if (!resolvedAgentId) {
-    throw new Error('claworld world membership helper requires agentId');
-  }
-
-  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
-  const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
-  const requestUrl = new URL(`${baseUrl}/v1/world-memberships`);
-  requestUrl.searchParams.set('agentId', resolvedAgentId);
-  if (normalizeText(status, null)) requestUrl.searchParams.set('status', normalizeText(status, null));
-  if (includeInactive) requestUrl.searchParams.set('includeInactive', 'true');
-  requestUrl.searchParams.set('includeDisabled', includeDisabled ? 'true' : 'false');
-  const result = await fetchJson(fetchImpl, requestUrl.toString(), {
-    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
-      accept: 'application/json',
-      ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
-    }),
-  });
-
-  if (!result.ok) {
-    logger.error?.('[claworld:membership] world memberships fetch failed', {
-      status: result.status,
-      accountId: resolvedRuntimeConfig.accountId || accountId || null,
-      body: result.body,
-    });
-    throw createWorldMembershipHttpError('list', result, {
-      accountId: resolvedRuntimeConfig.accountId || accountId || null,
-    });
-  }
-
-  return normalizeMembershipList(result.body);
-}
-
-export async function fetchWorldMembership({
-  cfg = {},
-  accountId = null,
-  runtimeConfig = null,
-  agentId = null,
-  worldId = null,
-  includeDisabled = true,
-  fetchImpl,
-  logger = console,
-} = {}) {
-  if (typeof fetchImpl !== 'function') {
-    throw new Error('fetch is unavailable for claworld world membership helper');
-  }
-
-  const resolvedAgentId = normalizeText(agentId, null);
-  if (!resolvedAgentId) {
-    throw new Error('claworld world membership helper requires agentId');
-  }
-  const resolvedWorldId = normalizeText(worldId, null);
-  if (!resolvedWorldId) {
-    throw new Error('claworld world membership helper requires worldId');
-  }
-
-  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
-  const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
-  const requestUrl = new URL(`${baseUrl}/v1/worlds/${encodeURIComponent(resolvedWorldId)}/membership`);
-  requestUrl.searchParams.set('agentId', resolvedAgentId);
-  requestUrl.searchParams.set('includeDisabled', includeDisabled ? 'true' : 'false');
-  const result = await fetchJson(fetchImpl, requestUrl.toString(), {
-    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
-      accept: 'application/json',
-      ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
-    }),
-  });
-
-  if (!result.ok) {
-    logger.error?.('[claworld:membership] world membership fetch failed', {
-      status: result.status,
-      worldId: resolvedWorldId,
-      accountId: resolvedRuntimeConfig.accountId || accountId || null,
-      body: result.body,
-    });
-    throw createWorldMembershipHttpError('get', result, {
-      accountId: resolvedRuntimeConfig.accountId || accountId || null,
-      worldId: resolvedWorldId,
-    });
-  }
-
-  return normalizeManagedWorldMembership(result.body);
-}
-
-export async function updateWorldMembershipProfile({
-  cfg = {},
-  accountId = null,
-  runtimeConfig = null,
-  agentId = null,
-  worldId = null,
-  participantContextText = null,
-  fetchImpl,
-  logger = console,
-} = {}) {
-  if (typeof fetchImpl !== 'function') {
-    throw new Error('fetch is unavailable for claworld world membership helper');
-  }
-
-  const resolvedAgentId = normalizeText(agentId, null);
-  if (!resolvedAgentId) {
-    throw new Error('claworld world membership helper requires agentId');
-  }
-  const resolvedWorldId = normalizeText(worldId, null);
-  if (!resolvedWorldId) {
-    throw new Error('claworld world membership helper requires worldId');
-  }
-
-  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
-  const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
-  const result = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds/${encodeURIComponent(resolvedWorldId)}/membership`, {
-    method: 'PATCH',
-    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
-      accept: 'application/json',
-      'content-type': 'application/json',
-      ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
-    }),
-    body: JSON.stringify({
-      agentId: resolvedAgentId,
-      participantContextText: normalizeText(participantContextText, null),
-    }),
-  });
-
-  if (!result.ok) {
-    logger.error?.('[claworld:membership] world membership profile update failed', {
-      status: result.status,
-      worldId: resolvedWorldId,
-      accountId: resolvedRuntimeConfig.accountId || accountId || null,
-      body: result.body,
-    });
-    throw createWorldMembershipHttpError('update_profile', result, {
-      accountId: resolvedRuntimeConfig.accountId || accountId || null,
-      worldId: resolvedWorldId,
-    });
-  }
-
-  return normalizeManagedWorldMembership(result.body);
-}
-
-export async function leaveWorldMembership({
-  cfg = {},
-  accountId = null,
-  runtimeConfig = null,
-  agentId = null,
-  worldId = null,
-  fetchImpl,
-  logger = console,
-} = {}) {
-  if (typeof fetchImpl !== 'function') {
-    throw new Error('fetch is unavailable for claworld world membership helper');
-  }
-
-  const resolvedAgentId = normalizeText(agentId, null);
-  if (!resolvedAgentId) {
-    throw new Error('claworld world membership helper requires agentId');
-  }
-  const resolvedWorldId = normalizeText(worldId, null);
-  if (!resolvedWorldId) {
-    throw new Error('claworld world membership helper requires worldId');
-  }
-
-  const resolvedRuntimeConfig = runtimeConfig || resolveClaworldRuntimeConfig(cfg, accountId);
-  const baseUrl = normalizeRelayHttpBaseUrl(resolvedRuntimeConfig.serverUrl);
-  const result = await fetchJson(fetchImpl, `${baseUrl}/v1/worlds/${encodeURIComponent(resolvedWorldId)}/membership/leave`, {
-    method: 'POST',
-    headers: buildRuntimeAuthHeaders(resolvedRuntimeConfig, {
-      accept: 'application/json',
-      'content-type': 'application/json',
-      ...(resolvedRuntimeConfig.apiKey ? { 'x-api-key': resolvedRuntimeConfig.apiKey } : {}),
-    }),
-    body: JSON.stringify({
-      agentId: resolvedAgentId,
-    }),
-  });
-
-  if (!result.ok) {
-    logger.error?.('[claworld:membership] world membership leave failed', {
-      status: result.status,
-      worldId: resolvedWorldId,
-      accountId: resolvedRuntimeConfig.accountId || accountId || null,
-      body: result.body,
-    });
-    throw createWorldMembershipHttpError('leave', result, {
-      accountId: resolvedRuntimeConfig.accountId || accountId || null,
-      worldId: resolvedWorldId,
-    });
-  }
-
-  return normalizeManagedWorldMembership(result.body);
-}