rol-websocket-channel 1.4.2 → 1.4.8

package/dist/src/admin/methods/agents-extended.js

@@ -1,251 +1,251 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { pathExists, readJsonFile, writeJsonFile } from '../lib/fs.js';
-import { JsonRpcException, JSON_RPC_ERRORS } from '../jsonrpc.js';
-const ALLOWED_AGENT_UPDATES = {
-    'name': true,
-    'workspace': true,
-    'agentDir': true,
-    'model.primary': true,
-    'skills': true,
-    'tools.profile': true,
-    'behavior': true,
-};
-export const listAgents = async (_params, context) => {
-    const configPath = path.join(context.openclawRoot, 'openclaw.json');
-    const config = await loadConfig(context.openclawRoot);
-    const items = normalizeAgentList(config);
-    return {
-        sourceConfigFile: configPath,
-        count: items.length,
-        items
-    };
-};
-export const createAgent = async (params, context) => {
-    const objectParams = expectObject(params);
-    const rawAgentId = typeof objectParams.agentId === 'string'
-        ? objectParams.agentId
-        : typeof objectParams.id === 'string'
-            ? objectParams.id
-            : undefined;
-    const agentId = sanitizeAgentId(expectString(rawAgentId, 'agentId'));
-    const configPath = path.join(context.openclawRoot, 'openclaw.json');
-    const config = await loadConfig(context.openclawRoot);
-    const agents = ensureAgentList(config);
-    if (findNamedAgent(agents, agentId)) {
-        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, `Agent already exists: ${agentId}`);
-    }
-    const workspace = typeof objectParams.workspace === 'string' && objectParams.workspace.trim().length > 0
-        ? objectParams.workspace.trim()
-        : path.join(context.openclawRoot, 'workspace', agentId);
-    const agentDir = typeof objectParams.agentDir === 'string' && objectParams.agentDir.trim().length > 0
-        ? objectParams.agentDir.trim()
-        : path.join(context.openclawRoot, 'agents', agentId, 'agent');
-    const created = {
-        id: agentId,
-        name: typeof objectParams.name === 'string' && objectParams.name.trim().length > 0
-            ? objectParams.name.trim()
-            : agentId,
-        workspace,
-        agentDir
-    };
-    const modelPrimary = typeof objectParams.modelPrimary === 'string' && objectParams.modelPrimary.trim().length > 0
-        ? objectParams.modelPrimary.trim()
-        : null;
-    const modelProvider = typeof objectParams.modelProvider === 'string' && objectParams.modelProvider.trim().length > 0
-        ? objectParams.modelProvider.trim()
-        : null;
-    if (modelPrimary) {
-        const inferredProvider = inferProviderFromPrimaryModel(modelPrimary);
-        if (modelProvider && modelProvider !== inferredProvider) {
-            throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'modelProvider does not match modelPrimary');
-        }
-        created.model = { ...(created.model ?? {}), primary: modelPrimary };
-    }
-    else if (modelProvider) {
-        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'modelProvider cannot be set without modelPrimary; provider is derived from model.primary');
-    }
-    if (Array.isArray(objectParams.skills)) {
-        created.skills = objectParams.skills.filter((item) => typeof item === 'string');
-    }
-    if (typeof objectParams.toolsProfile === 'string' && objectParams.toolsProfile.trim().length > 0) {
-        created.tools = { ...(created.tools ?? {}), profile: objectParams.toolsProfile.trim() };
-    }
-    if (isObject(objectParams.behavior)) {
-        created.behavior = objectParams.behavior;
-    }
-    agents.push(created);
-    await fs.mkdir(workspace, { recursive: true });
-    await fs.mkdir(agentDir, { recursive: true });
-    await writeJsonFile(configPath, config);
-    return {
-        success: true,
-        configFile: configPath,
-        created
-    };
-};
-export const deleteAgent = async (params, context) => {
-    const objectParams = expectObject(params);
-    const rawAgentId = typeof objectParams.agentId === 'string'
-        ? objectParams.agentId
-        : typeof objectParams.id === 'string'
-            ? objectParams.id
-            : undefined;
-    const agentId = sanitizeAgentId(expectString(rawAgentId, 'agentId'));
-    const purgeFiles = objectParams.purgeFiles === true;
-    const configPath = path.join(context.openclawRoot, 'openclaw.json');
-    const config = await loadConfig(context.openclawRoot);
-    const agents = ensureAgentList(config);
-    const index = agents.findIndex((agent) => isMatchingAgent(agent, agentId));
-    if (index === -1) {
-        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, `Agent not found: ${agentId}`);
-    }
-    const [removed] = agents.splice(index, 1);
-    await writeJsonFile(configPath, config);
-    const removedPaths = [];
-    if (purgeFiles) {
-        const workspaceRoot = path.normalize(path.join(context.openclawRoot, 'workspace'));
-        const agentsRoot = path.normalize(path.join(context.openclawRoot, 'agents'));
-        const purgeCandidates = [
-            typeof removed.workspace === 'string' ? removed.workspace : null,
-            typeof removed.agentDir === 'string' ? path.dirname(removed.agentDir) : null
-        ].filter((value) => Boolean(value));
-        for (const candidate of purgeCandidates) {
-            const normalized = path.normalize(candidate);
-            const insideWorkspace = normalized === workspaceRoot || normalized.startsWith(`${workspaceRoot}${path.sep}`);
-            const insideAgents = normalized === agentsRoot || normalized.startsWith(`${agentsRoot}${path.sep}`);
-            if (!insideWorkspace && !insideAgents) {
-                continue;
-            }
-            if (await pathExists(candidate)) {
-                await fs.rm(candidate, { recursive: true, force: true });
-                removedPaths.push(candidate);
-            }
-        }
-    }
-    return {
-        success: true,
-        configFile: configPath,
-        removed,
-        purgeFiles,
-        removedPaths
-    };
-};
-export const updateAgent = async (params, context) => {
-    const objectParams = isObject(params) ? params : {};
-    const updates = isObject(objectParams.updates) ? objectParams.updates : null;
-    const rawAgentId = typeof objectParams.agentId === 'string'
-        ? objectParams.agentId
-        : typeof objectParams.agentName === 'string'
-            ? objectParams.agentName
-            : typeof objectParams.id === 'string'
-                ? objectParams.id
-                : 'defaults';
-    const agentId = typeof rawAgentId === 'string' && rawAgentId !== 'defaults'
-        ? sanitizeAgentId(rawAgentId)
-        : rawAgentId;
-    if (!updates) {
-        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'Missing required parameter: updates (object with field paths and values)');
-    }
-    const configPath = path.join(context.openclawRoot, 'openclaw.json');
-    const config = await loadConfig(context.openclawRoot);
-    const target = resolveAgentTarget(config, agentId);
-    const changes = [];
-    for (const [fieldPath, value] of Object.entries(updates)) {
-        if (fieldPath === 'model.provider') {
-            throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'model.provider is derived from model.primary and cannot be updated directly');
-        }
-        if (!ALLOWED_AGENT_UPDATES[fieldPath]) {
-            throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, `Field not allowed for update: ${fieldPath}. Allowed fields: ${Object.keys(ALLOWED_AGENT_UPDATES).join(', ')}`);
-        }
-        setNestedValue(target, fieldPath, value);
-        changes.push(`Updated ${fieldPath} to: ${JSON.stringify(value)}`);
-    }
-    await writeJsonFile(configPath, config);
-    return {
-        success: true,
-        configFile: configPath,
-        agentId,
-        changes,
-        updatedConfig: target
-    };
-};
-function setNestedValue(obj, pathExpression, value) {
-    const keys = pathExpression.split('.');
-    let current = obj;
-    for (let index = 0; index < keys.length - 1; index += 1) {
-        const key = keys[index];
-        if (!current[key] || typeof current[key] !== 'object') {
-            current[key] = {};
-        }
-        current = current[key];
-    }
-    current[keys[keys.length - 1]] = value;
-}
-function inferProviderFromPrimaryModel(primary) {
-    const separatorIndex = primary.indexOf('/');
-    return separatorIndex > 0 ? primary.slice(0, separatorIndex) : null;
-}
-function isObject(value) {
-    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-function expectObject(value) {
-    if (!value || Array.isArray(value) || typeof value !== 'object') {
-        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'Params must be an object');
-    }
-    return value;
-}
-function expectString(value, fieldName) {
-    if (typeof value !== 'string' || value.trim().length === 0) {
-        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, `Field '${fieldName}' must be a non-empty string`);
-    }
-    return value.trim();
-}
-async function loadConfig(openclawRoot) {
-    return await readJsonFile(path.join(openclawRoot, 'openclaw.json'));
-}
-function ensureAgentList(config) {
-    if (!config.agents)
-        config.agents = {};
-    if (!Array.isArray(config.agents.list))
-        config.agents.list = [];
-    return config.agents.list;
-}
-function normalizeAgentList(config) {
-    const defaults = {
-        id: 'defaults',
-        name: 'defaults',
-        ...(config.agents?.defaults ?? {})
-    };
-    const named = Array.isArray(config.agents?.list) ? config.agents.list : [];
-    return [defaults, ...named];
-}
-function resolveAgentTarget(config, agentName) {
-    if (agentName === 'defaults') {
-        if (!config.agents)
-            config.agents = {};
-        if (!config.agents.defaults)
-            config.agents.defaults = {};
-        return config.agents.defaults;
-    }
-    const agents = ensureAgentList(config);
-    const found = findNamedAgent(agents, agentName);
-    if (!found) {
-        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, `Agent not found: ${agentName}`);
-    }
-    return found;
-}
-function findNamedAgent(agents, agentName) {
-    return agents.find((agent) => isMatchingAgent(agent, agentName)) ?? null;
-}
-function isMatchingAgent(agent, agentName) {
-    return agent.id === agentName || agent.name === agentName;
-}
-function sanitizeAgentId(value) {
-    return value
-        .trim()
-        .replace(/[^a-zA-Z0-9._-]+/g, '-')
-        .replace(/-+/g, '-')
-        .replace(/^-|-$/g, '')
-        .toLowerCase();
-}
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { pathExists, readJsonFile, writeJsonFile } from '../lib/fs.js';
+import { JsonRpcException, JSON_RPC_ERRORS } from '../jsonrpc.js';
+const ALLOWED_AGENT_UPDATES = {
+    'name': true,
+    'workspace': true,
+    'agentDir': true,
+    'model.primary': true,
+    'skills': true,
+    'tools.profile': true,
+    'behavior': true,
+};
+export const listAgents = async (_params, context) => {
+    const configPath = path.join(context.openclawRoot, 'openclaw.json');
+    const config = await loadConfig(context.openclawRoot);
+    const items = normalizeAgentList(config);
+    return {
+        sourceConfigFile: configPath,
+        count: items.length,
+        items
+    };
+};
+export const createAgent = async (params, context) => {
+    const objectParams = expectObject(params);
+    const rawAgentId = typeof objectParams.agentId === 'string'
+        ? objectParams.agentId
+        : typeof objectParams.id === 'string'
+            ? objectParams.id
+            : undefined;
+    const agentId = sanitizeAgentId(expectString(rawAgentId, 'agentId'));
+    const configPath = path.join(context.openclawRoot, 'openclaw.json');
+    const config = await loadConfig(context.openclawRoot);
+    const agents = ensureAgentList(config);
+    if (findNamedAgent(agents, agentId)) {
+        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, `Agent already exists: ${agentId}`);
+    }
+    const workspace = typeof objectParams.workspace === 'string' && objectParams.workspace.trim().length > 0
+        ? objectParams.workspace.trim()
+        : path.join(context.openclawRoot, 'workspace', agentId);
+    const agentDir = typeof objectParams.agentDir === 'string' && objectParams.agentDir.trim().length > 0
+        ? objectParams.agentDir.trim()
+        : path.join(context.openclawRoot, 'agents', agentId, 'agent');
+    const created = {
+        id: agentId,
+        name: typeof objectParams.name === 'string' && objectParams.name.trim().length > 0
+            ? objectParams.name.trim()
+            : agentId,
+        workspace,
+        agentDir
+    };
+    const modelPrimary = typeof objectParams.modelPrimary === 'string' && objectParams.modelPrimary.trim().length > 0
+        ? objectParams.modelPrimary.trim()
+        : null;
+    const modelProvider = typeof objectParams.modelProvider === 'string' && objectParams.modelProvider.trim().length > 0
+        ? objectParams.modelProvider.trim()
+        : null;
+    if (modelPrimary) {
+        const inferredProvider = inferProviderFromPrimaryModel(modelPrimary);
+        if (modelProvider && modelProvider !== inferredProvider) {
+            throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'modelProvider does not match modelPrimary');
+        }
+        created.model = { ...(created.model ?? {}), primary: modelPrimary };
+    }
+    else if (modelProvider) {
+        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'modelProvider cannot be set without modelPrimary; provider is derived from model.primary');
+    }
+    if (Array.isArray(objectParams.skills)) {
+        created.skills = objectParams.skills.filter((item) => typeof item === 'string');
+    }
+    if (typeof objectParams.toolsProfile === 'string' && objectParams.toolsProfile.trim().length > 0) {
+        created.tools = { ...(created.tools ?? {}), profile: objectParams.toolsProfile.trim() };
+    }
+    if (isObject(objectParams.behavior)) {
+        created.behavior = objectParams.behavior;
+    }
+    agents.push(created);
+    await fs.mkdir(workspace, { recursive: true });
+    await fs.mkdir(agentDir, { recursive: true });
+    await writeJsonFile(configPath, config);
+    return {
+        success: true,
+        configFile: configPath,
+        created
+    };
+};
+export const deleteAgent = async (params, context) => {
+    const objectParams = expectObject(params);
+    const rawAgentId = typeof objectParams.agentId === 'string'
+        ? objectParams.agentId
+        : typeof objectParams.id === 'string'
+            ? objectParams.id
+            : undefined;
+    const agentId = sanitizeAgentId(expectString(rawAgentId, 'agentId'));
+    const purgeFiles = objectParams.purgeFiles === true;
+    const configPath = path.join(context.openclawRoot, 'openclaw.json');
+    const config = await loadConfig(context.openclawRoot);
+    const agents = ensureAgentList(config);
+    const index = agents.findIndex((agent) => isMatchingAgent(agent, agentId));
+    if (index === -1) {
+        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, `Agent not found: ${agentId}`);
+    }
+    const [removed] = agents.splice(index, 1);
+    await writeJsonFile(configPath, config);
+    const removedPaths = [];
+    if (purgeFiles) {
+        const workspaceRoot = path.normalize(path.join(context.openclawRoot, 'workspace'));
+        const agentsRoot = path.normalize(path.join(context.openclawRoot, 'agents'));
+        const purgeCandidates = [
+            typeof removed.workspace === 'string' ? removed.workspace : null,
+            typeof removed.agentDir === 'string' ? path.dirname(removed.agentDir) : null
+        ].filter((value) => Boolean(value));
+        for (const candidate of purgeCandidates) {
+            const normalized = path.normalize(candidate);
+            const insideWorkspace = normalized === workspaceRoot || normalized.startsWith(`${workspaceRoot}${path.sep}`);
+            const insideAgents = normalized === agentsRoot || normalized.startsWith(`${agentsRoot}${path.sep}`);
+            if (!insideWorkspace && !insideAgents) {
+                continue;
+            }
+            if (await pathExists(candidate)) {
+                await fs.rm(candidate, { recursive: true, force: true });
+                removedPaths.push(candidate);
+            }
+        }
+    }
+    return {
+        success: true,
+        configFile: configPath,
+        removed,
+        purgeFiles,
+        removedPaths
+    };
+};
+export const updateAgent = async (params, context) => {
+    const objectParams = isObject(params) ? params : {};
+    const updates = isObject(objectParams.updates) ? objectParams.updates : null;
+    const rawAgentId = typeof objectParams.agentId === 'string'
+        ? objectParams.agentId
+        : typeof objectParams.agentName === 'string'
+            ? objectParams.agentName
+            : typeof objectParams.id === 'string'
+                ? objectParams.id
+                : 'defaults';
+    const agentId = typeof rawAgentId === 'string' && rawAgentId !== 'defaults'
+        ? sanitizeAgentId(rawAgentId)
+        : rawAgentId;
+    if (!updates) {
+        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'Missing required parameter: updates (object with field paths and values)');
+    }
+    const configPath = path.join(context.openclawRoot, 'openclaw.json');
+    const config = await loadConfig(context.openclawRoot);
+    const target = resolveAgentTarget(config, agentId);
+    const changes = [];
+    for (const [fieldPath, value] of Object.entries(updates)) {
+        if (fieldPath === 'model.provider') {
+            throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'model.provider is derived from model.primary and cannot be updated directly');
+        }
+        if (!ALLOWED_AGENT_UPDATES[fieldPath]) {
+            throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, `Field not allowed for update: ${fieldPath}. Allowed fields: ${Object.keys(ALLOWED_AGENT_UPDATES).join(', ')}`);
+        }
+        setNestedValue(target, fieldPath, value);
+        changes.push(`Updated ${fieldPath} to: ${JSON.stringify(value)}`);
+    }
+    await writeJsonFile(configPath, config);
+    return {
+        success: true,
+        configFile: configPath,
+        agentId,
+        changes,
+        updatedConfig: target
+    };
+};
+function setNestedValue(obj, pathExpression, value) {
+    const keys = pathExpression.split('.');
+    let current = obj;
+    for (let index = 0; index < keys.length - 1; index += 1) {
+        const key = keys[index];
+        if (!current[key] || typeof current[key] !== 'object') {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    current[keys[keys.length - 1]] = value;
+}
+function inferProviderFromPrimaryModel(primary) {
+    const separatorIndex = primary.indexOf('/');
+    return separatorIndex > 0 ? primary.slice(0, separatorIndex) : null;
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function expectObject(value) {
+    if (!value || Array.isArray(value) || typeof value !== 'object') {
+        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'Params must be an object');
+    }
+    return value;
+}
+function expectString(value, fieldName) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, `Field '${fieldName}' must be a non-empty string`);
+    }
+    return value.trim();
+}
+async function loadConfig(openclawRoot) {
+    return await readJsonFile(path.join(openclawRoot, 'openclaw.json'));
+}
+function ensureAgentList(config) {
+    if (!config.agents)
+        config.agents = {};
+    if (!Array.isArray(config.agents.list))
+        config.agents.list = [];
+    return config.agents.list;
+}
+function normalizeAgentList(config) {
+    const defaults = {
+        id: 'defaults',
+        name: 'defaults',
+        ...(config.agents?.defaults ?? {})
+    };
+    const named = Array.isArray(config.agents?.list) ? config.agents.list : [];
+    return [defaults, ...named];
+}
+function resolveAgentTarget(config, agentName) {
+    if (agentName === 'defaults') {
+        if (!config.agents)
+            config.agents = {};
+        if (!config.agents.defaults)
+            config.agents.defaults = {};
+        return config.agents.defaults;
+    }
+    const agents = ensureAgentList(config);
+    const found = findNamedAgent(agents, agentName);
+    if (!found) {
+        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, `Agent not found: ${agentName}`);
+    }
+    return found;
+}
+function findNamedAgent(agents, agentName) {
+    return agents.find((agent) => isMatchingAgent(agent, agentName)) ?? null;
+}
+function isMatchingAgent(agent, agentName) {
+    return agent.id === agentName || agent.name === agentName;
+}
+function sanitizeAgentId(value) {
+    return value
+        .trim()
+        .replace(/[^a-zA-Z0-9._-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .toLowerCase();
+}