@xopcai/xopcbot 0.1.0

package/dist/agent/skills/config.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Skill Configuration Manager
+ *
+ * Handles skill-specific configuration and environment variables.
+ * Inspired by openclaw's skills config system
+ */
+import type { SkillConfig, SkillsConfig, Skill } from './types.js';
+/**
+ * Resolve skill configuration from multiple sources
+ *
+ * Priority (highest to lowest):
+ * 1. Environment variable overrides (XOPCBOT_SKILL_<NAME>_<KEY>)
+ * 2. Config file entries
+ * 3. Skill defaults
+ */
+export declare function resolveSkillConfig(skill: Skill, skillsConfig?: SkillsConfig): SkillConfig;
+/**
+ * Apply environment variable overrides to a skill's environment
+ */
+export declare function applySkillEnvOverrides(skill: Skill, baseEnv?: Record<string, string>, skillConfig?: SkillConfig): Record<string, string>;
+/**
+ * Get the effective environment for a skill
+ */
+export declare function getSkillEnvironment(skill: Skill, skillsConfig?: SkillsConfig): Record<string, string>;
+/**
+ * Skill configuration file manager
+ */
+export interface SkillConfigFile {
+    /** Path to the config file */
+    configPath: string;
+    /** Load configuration */
+    load: () => SkillsConfig;
+    /** Save configuration */
+    save: (config: SkillsConfig) => void;
+    /** Get skill-specific config */
+    getSkillConfig: (skillName: string) => SkillConfig | undefined;
+    /** Update skill configuration */
+    updateSkillConfig: (skillName: string, config: Partial<SkillConfig>) => void;
+    /** Enable/disable a skill */
+    setSkillEnabled: (skillName: string, enabled: boolean) => void;
+    /** Set skill API key */
+    setSkillApiKey: (skillName: string, apiKey: string) => void;
+}
+/**
+ * Create a skill configuration file manager
+ */
+export declare function createSkillConfigManager(configDir: string): SkillConfigFile;
+/**
+ * Check if a skill is enabled
+ */
+export declare function isSkillEnabled(skill: Skill, skillsConfig?: SkillsConfig): boolean;
+/**
+ * Validate skill configuration
+ */
+export declare function validateSkillConfig(config: SkillsConfig): {
+    valid: boolean;
+    errors: string[];
+};

package/dist/agent/skills/config.js

@@ -0,0 +1,212 @@
+/**
+ * Skill Configuration Manager
+ *
+ * Handles skill-specific configuration and environment variables.
+ * Inspired by openclaw's skills config system
+ */
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('SkillConfig');
+/**
+ * Resolve skill configuration from multiple sources
+ *
+ * Priority (highest to lowest):
+ * 1. Environment variable overrides (XOPCBOT_SKILL_<NAME>_<KEY>)
+ * 2. Config file entries
+ * 3. Skill defaults
+ */
+export function resolveSkillConfig(skill, skillsConfig) {
+    const config = {};
+    // Start with config file entries
+    const entryConfig = skillsConfig?.entries?.[skill.name];
+    if (entryConfig) {
+        config.enabled = entryConfig.enabled;
+        config.apiKey = entryConfig.apiKey;
+        config.env = entryConfig.env ? { ...entryConfig.env } : undefined;
+        config.config = entryConfig.config ? { ...entryConfig.config } : undefined;
+    }
+    // Apply environment variable overrides
+    const envPrefix = `XOPCBOT_SKILL_${skill.name.toUpperCase().replace(/-/g, '_')}`;
+    // Check for enabled override
+    const enabledEnv = process.env[`${envPrefix}_ENABLED`];
+    if (enabledEnv !== undefined) {
+        config.enabled = enabledEnv.toLowerCase() === 'true' || enabledEnv === '1';
+    }
+    // Check for API key override
+    const apiKeyEnv = process.env[`${envPrefix}_API_KEY`];
+    if (apiKeyEnv) {
+        config.apiKey = apiKeyEnv;
+    }
+    // Check for environment variable overrides
+    for (const [key, value] of Object.entries(process.env)) {
+        if (key.startsWith(`${envPrefix}_ENV_`)) {
+            const envKey = key.slice(`${envPrefix}_ENV_`.length);
+            if (!config.env) {
+                config.env = {};
+            }
+            config.env[envKey] = value;
+        }
+    }
+    return config;
+}
+/**
+ * Apply environment variable overrides to a skill's environment
+ */
+export function applySkillEnvOverrides(skill, baseEnv = {}, skillConfig) {
+    const env = { ...baseEnv };
+    // Apply config env
+    if (skillConfig?.env) {
+        for (const [key, value] of Object.entries(skillConfig.env)) {
+            env[key] = value;
+        }
+    }
+    // Apply environment variable overrides
+    const envPrefix = `XOPCBOT_SKILL_${skill.name.toUpperCase().replace(/-/g, '_')}`;
+    for (const [key, value] of Object.entries(process.env)) {
+        if (key.startsWith(`${envPrefix}_ENV_`)) {
+            const envKey = key.slice(`${envPrefix}_ENV_`.length);
+            env[envKey] = value;
+        }
+    }
+    return env;
+}
+/**
+ * Get the effective environment for a skill
+ */
+export function getSkillEnvironment(skill, skillsConfig) {
+    const config = resolveSkillConfig(skill, skillsConfig);
+    return applySkillEnvOverrides(skill, process.env, config);
+}
+/**
+ * Create a skill configuration file manager
+ */
+export function createSkillConfigManager(configDir) {
+    const configPath = join(configDir, 'skills.json');
+    function loadConfig() {
+        if (!existsSync(configPath)) {
+            return {};
+        }
+        try {
+            const content = readFileSync(configPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (err) {
+            log.warn({ error: err }, 'Failed to load skills config, using defaults');
+            return {};
+        }
+    }
+    function saveConfig(config) {
+        try {
+            writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+            log.info('Saved skills config');
+        }
+        catch (err) {
+            log.error({ error: err }, 'Failed to save skills config');
+        }
+    }
+    return {
+        configPath,
+        load: loadConfig,
+        save: saveConfig,
+        getSkillConfig: (skillName) => {
+            const config = loadConfig();
+            return config.entries?.[skillName];
+        },
+        updateSkillConfig: (skillName, updates) => {
+            const config = loadConfig();
+            if (!config.entries) {
+                config.entries = {};
+            }
+            const existing = config.entries[skillName] || {};
+            config.entries[skillName] = {
+                ...existing,
+                ...updates,
+            };
+            saveConfig(config);
+        },
+        setSkillEnabled: (skillName, enabled) => {
+            const config = loadConfig();
+            if (!config.entries) {
+                config.entries = {};
+            }
+            const existing = config.entries[skillName] || {};
+            config.entries[skillName] = {
+                ...existing,
+                enabled,
+            };
+            saveConfig(config);
+            log.info({ skillName, enabled }, 'Updated skill enabled state');
+        },
+        setSkillApiKey: (skillName, apiKey) => {
+            const config = loadConfig();
+            if (!config.entries) {
+                config.entries = {};
+            }
+            const existing = config.entries[skillName] || {};
+            config.entries[skillName] = {
+                ...existing,
+                apiKey,
+            };
+            saveConfig(config);
+            log.info({ skillName }, 'Updated skill API key');
+        },
+    };
+}
+/**
+ * Check if a skill is enabled
+ */
+export function isSkillEnabled(skill, skillsConfig) {
+    const config = resolveSkillConfig(skill, skillsConfig);
+    // Explicitly disabled
+    if (config.enabled === false) {
+        return false;
+    }
+    // Check if skill has requirements that are not met
+    const requires = skill.metadata.requires || skill.metadata.openclaw?.requires;
+    if (requires?.bins) {
+        const { hasBinary } = require('./installer.js');
+        for (const bin of requires.bins) {
+            if (!hasBinary(bin)) {
+                log.debug({ skill: skill.name, bin }, 'Skill requirement not met');
+                return false;
+            }
+        }
+    }
+    return true;
+}
+/**
+ * Validate skill configuration
+ */
+export function validateSkillConfig(config) {
+    const errors = [];
+    // Validate limits
+    const limits = config.limits;
+    if (limits) {
+        if (limits.maxCandidatesPerRoot !== undefined && limits.maxCandidatesPerRoot < 1) {
+            errors.push('limits.maxCandidatesPerRoot must be at least 1');
+        }
+        if (limits.maxSkillsLoadedPerSource !== undefined && limits.maxSkillsLoadedPerSource < 1) {
+            errors.push('limits.maxSkillsLoadedPerSource must be at least 1');
+        }
+        if (limits.maxSkillsInPrompt !== undefined && limits.maxSkillsInPrompt < 1) {
+            errors.push('limits.maxSkillsInPrompt must be at least 1');
+        }
+    }
+    // Validate entries
+    if (config.entries) {
+        for (const [skillName, skillConfig] of Object.entries(config.entries)) {
+            if (skillConfig.apiKey && typeof skillConfig.apiKey !== 'string') {
+                errors.push(`entries.${skillName}.apiKey must be a string`);
+            }
+            if (skillConfig.env && typeof skillConfig.env !== 'object') {
+                errors.push(`entries.${skillName}.env must be an object`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/agent/skills/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/agent/skills/config.ts"],"names":[],"mappings":"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"}

package/dist/agent/skills/index.d.ts

@@ -0,0 +1,25 @@
+import type { Skill, SkillDiagnostic, LoadSkillsResult, SkillConfig } from './types.js';
+export declare function loadSkills(options: {
+    workspaceDir?: string;
+    globalDir?: string;
+    builtinDir?: string;
+    extraDirs?: string[];
+}): LoadSkillsResult;
+export interface SkillLoader {
+    init: (workspace: string, builtin: string | null) => LoadSkillsResult;
+    load: () => LoadSkillsResult;
+    reload: () => LoadSkillsResult;
+    getSkills: () => Skill[];
+    getPrompt: () => string;
+    getDiagnostics: () => SkillDiagnostic[];
+    getLastLoadTime: () => number;
+    getSkillByName: (name: string) => Skill | undefined;
+    getEnabledSkills: (config?: Record<string, SkillConfig>) => Skill[];
+}
+export declare function createSkillLoader(): SkillLoader;
+export type { Skill, SkillMetadata, SkillConfig, SkillInstallSpec, SkillInstallResult, SkillInstallRequest, LoadSkillsResult, SkillDiagnostic, SkillSnapshot, } from './types.js';
+export { installSkill, findInstallSpec, hasBinary, getDefaultInstallerPreferences, type InstallerPreferences, type InstallContext, } from './installer.js';
+export { scanSkillDirectory, formatScanSummary, collectSkillInstallWarnings, type ScanSummary, type SecurityFinding, type Severity, } from './scanner.js';
+export { resolveSkillConfig, applySkillEnvOverrides, getSkillEnvironment, createSkillConfigManager, isSkillEnabled, validateSkillConfig, type SkillConfigFile, } from './config.js';
+export { createSkillWatcher, createWatcherFromLoader, type SkillWatcher, type SkillWatcherOptions, } from './watcher.js';
+export { SkillTestFramework, SkillTestRunner, formatTestResults, formatTestResultsJson, formatTestResultsTap, type TestResult, type TestStatus, type SkillTestReport, type TestOptions, type TestRunnerOptions, } from './test-framework.js';

package/dist/agent/skills/index.js

@@ -0,0 +1,349 @@
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { basename, dirname, join, relative, sep } from 'path';
+import { parseFrontmatter } from '../../utils/frontmatter.js';
+import { DEFAULT_BASE_DIR } from '../../config/paths.js';
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('SkillLoader');
+const IGNORE_FILES = ['.gitignore', '.ignore', '.fdignore'];
+function toPosixPath(p) {
+    return p.split(sep).join('/');
+}
+function prefixIgnorePattern(line, prefix) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    if (trimmed.startsWith('#') && !trimmed.startsWith('\\#'))
+        return null;
+    let pattern = line;
+    let negated = false;
+    if (pattern.startsWith('!')) {
+        negated = true;
+        pattern = pattern.slice(1);
+    }
+    else if (pattern.startsWith('\\!')) {
+        pattern = pattern.slice(1);
+    }
+    if (pattern.startsWith('/')) {
+        pattern = pattern.slice(1);
+    }
+    const prefixed = prefix ? `${prefix}${pattern}` : pattern;
+    return negated ? `!${prefixed}` : prefixed;
+}
+function loadIgnoreRules(dir, rootDir) {
+    const ignoredPaths = new Set();
+    const relativeDir = relative(rootDir, dir);
+    const prefix = relativeDir ? `${toPosixPath(relativeDir)}/` : '';
+    for (const filename of IGNORE_FILES) {
+        const ignorePath = join(dir, filename);
+        if (!existsSync(ignorePath))
+            continue;
+        try {
+            const content = readFileSync(ignorePath, 'utf-8');
+            for (const line of content.split(/\r?\n/)) {
+                const pattern = prefixIgnorePattern(line, prefix);
+                if (pattern) {
+                    const fullPattern = pattern.startsWith('!')
+                        ? `!${prefix}${pattern.slice(1)}`
+                        : `${prefix}${pattern}`;
+                    ignoredPaths.add(fullPattern);
+                }
+            }
+        }
+        catch { }
+    }
+    return ignoredPaths;
+}
+function shouldIgnore(path, ignoredPaths) {
+    for (const pattern of ignoredPaths) {
+        if (pattern.startsWith('!')) {
+            const positive = pattern.slice(1);
+            if (path === positive || path.startsWith(`${positive}/`)) {
+                return false;
+            }
+        }
+        else {
+            if (path === pattern || path.startsWith(`${pattern}/`)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function escapeXml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+function formatSkillXml(skill) {
+    const emoji = skill.metadata.emoji || skill.metadata.openclaw?.emoji || '';
+    const emojiStr = emoji ? `${emoji} ` : '';
+    return [
+        '  <skill>',
+        `    <name>${escapeXml(skill.name)}</name>`,
+        `    <description>${emojiStr}${escapeXml(skill.description)}</description>`,
+        `    <location>${escapeXml(skill.filePath)}</location>`,
+        '  </skill>',
+    ].join('\n');
+}
+function formatSkillsForPrompt(skills) {
+    const visibleSkills = skills.filter(s => !s.disableModelInvocation);
+    if (visibleSkills.length === 0)
+        return '';
+    const lines = [
+        '\n\n<available_skills>',
+        'Skills are folders of instructions, scripts, and resources.',
+        'Use the read tool to load a skill\'s file when the task matches its description.',
+        '',
+    ];
+    for (const skill of visibleSkills) {
+        lines.push(formatSkillXml(skill));
+    }
+    lines.push('</available_skills>');
+    return lines.join('\n');
+}
+function discoverSkills(dir, source) {
+    const skills = [];
+    if (!existsSync(dir))
+        return skills;
+    function scan(currentDir, currentIgnoredPaths) {
+        try {
+            const entries = readdirSync(currentDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.name.startsWith('.') || entry.name === 'node_modules')
+                    continue;
+                const fullPath = join(currentDir, entry.name);
+                const relPath = toPosixPath(relative(dir, fullPath));
+                if (shouldIgnore(relPath, currentIgnoredPaths))
+                    continue;
+                if (entry.isDirectory()) {
+                    const skillMdPath = join(fullPath, 'SKILL.md');
+                    const skillRelPath = `${relPath}/`;
+                    const subIgnoredPaths = new Set(currentIgnoredPaths);
+                    const subIgnoreFile = join(fullPath, '.gitignore');
+                    if (existsSync(subIgnoreFile)) {
+                        const subRules = loadIgnoreRules(fullPath, dir);
+                        for (const rule of subRules) {
+                            subIgnoredPaths.add(`${skillRelPath}${rule}`);
+                        }
+                    }
+                    if (existsSync(skillMdPath) && !shouldIgnore(skillRelPath, currentIgnoredPaths)) {
+                        const skill = loadSkillFromFile(skillMdPath, source);
+                        if (skill)
+                            skills.push(skill);
+                    }
+                    scan(fullPath, subIgnoredPaths);
+                }
+            }
+        }
+        catch { }
+    }
+    scan(dir, loadIgnoreRules(dir, dir));
+    return skills;
+}
+function parseSkillMetadata(frontmatter) {
+    // Support both direct metadata and openclaw-compatible nested metadata
+    const metadata = {
+        name: frontmatter.name || '',
+        description: frontmatter.description || '',
+        emoji: frontmatter.emoji || undefined,
+        homepage: frontmatter.homepage || undefined,
+        os: frontmatter.os || undefined,
+        requires: frontmatter.requires || undefined,
+        install: frontmatter.install || undefined,
+    };
+    // Support openclaw-compatible nested metadata
+    const openclawMeta = frontmatter.metadata;
+    if (openclawMeta?.openclaw) {
+        const oc = openclawMeta.openclaw;
+        metadata.openclaw = {
+            emoji: oc.emoji || undefined,
+            requires: oc.requires || undefined,
+            install: oc.install || undefined,
+            os: oc.os || undefined,
+        };
+        // Merge openclaw metadata if direct metadata is missing
+        if (!metadata.emoji && metadata.openclaw.emoji) {
+            metadata.emoji = metadata.openclaw.emoji;
+        }
+        if (!metadata.requires && metadata.openclaw.requires) {
+            metadata.requires = metadata.openclaw.requires;
+        }
+        if (!metadata.install && metadata.openclaw.install) {
+            metadata.install = metadata.openclaw.install;
+        }
+        if (!metadata.os && metadata.openclaw.os) {
+            metadata.os = metadata.openclaw.os;
+        }
+    }
+    return metadata;
+}
+function loadSkillFromFile(filePath, source) {
+    try {
+        const rawContent = readFileSync(filePath, 'utf-8');
+        const { frontmatter, content } = parseFrontmatter(rawContent);
+        const skillDir = dirname(filePath);
+        const parentDirName = basename(skillDir);
+        const name = frontmatter.name || parentDirName;
+        const description = frontmatter.description;
+        if (!description?.trim())
+            return null;
+        const metadata = parseSkillMetadata(frontmatter);
+        return {
+            name,
+            description: description.trim(),
+            filePath,
+            baseDir: skillDir,
+            source,
+            disableModelInvocation: frontmatter['disable-model-invocation'] === true,
+            metadata,
+            content,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function loadSkills(options) {
+    const { workspaceDir, builtinDir, extraDirs = [] } = options;
+    const skillMap = new Map();
+    const diagnostics = [];
+    if (builtinDir) {
+        for (const skill of discoverSkills(builtinDir, 'builtin')) {
+            const existing = skillMap.get(skill.name);
+            if (existing) {
+                diagnostics.push({
+                    type: 'collision',
+                    skillName: skill.name,
+                    message: `Skill "${skill.name}" collision: ${existing.source} overrides ${skill.source}`,
+                    path: skill.filePath,
+                });
+            }
+            else {
+                skillMap.set(skill.name, skill);
+            }
+        }
+    }
+    const globalDirs = [
+        options.globalDir,
+        join(DEFAULT_BASE_DIR, 'skills'),
+        join(process.env.HOME || '', '.agents', 'skills'),
+    ].filter((d) => !!d && existsSync(d));
+    for (const dir of globalDirs) {
+        for (const skill of discoverSkills(dir, 'global')) {
+            const existing = skillMap.get(skill.name);
+            if (existing) {
+                diagnostics.push({
+                    type: 'collision',
+                    skillName: skill.name,
+                    message: `Skill "${skill.name}" collision: ${existing.source} overrides ${skill.source}`,
+                    path: skill.filePath,
+                });
+            }
+            else {
+                skillMap.set(skill.name, skill);
+            }
+        }
+    }
+    if (workspaceDir) {
+        const workspaceSkills = discoverSkills(join(workspaceDir, 'skills'), 'workspace');
+        for (const skill of workspaceSkills) {
+            const existing = skillMap.get(skill.name);
+            if (existing) {
+                diagnostics.push({
+                    type: 'collision',
+                    skillName: skill.name,
+                    message: `Skill "${skill.name}" collision: ${skill.source} overrides ${existing.source}`,
+                    path: skill.filePath,
+                });
+            }
+            skillMap.set(skill.name, skill);
+        }
+    }
+    // Scan extra directories
+    for (const extraDir of extraDirs) {
+        if (existsSync(extraDir)) {
+            for (const skill of discoverSkills(extraDir, 'global')) {
+                const existing = skillMap.get(skill.name);
+                if (existing) {
+                    diagnostics.push({
+                        type: 'collision',
+                        skillName: skill.name,
+                        message: `Skill "${skill.name}" collision: ${existing.source} overrides ${skill.source}`,
+                        path: skill.filePath,
+                    });
+                }
+                else {
+                    skillMap.set(skill.name, skill);
+                }
+            }
+        }
+    }
+    return {
+        skills: Array.from(skillMap.values()),
+        prompt: formatSkillsForPrompt(Array.from(skillMap.values())),
+        diagnostics,
+    };
+}
+export function createSkillLoader() {
+    let cachedSkills = [];
+    let cachedPrompt = '';
+    let cachedDiagnostics = [];
+    let lastLoadTime = 0;
+    let workspaceDir;
+    let builtinDir;
+    let extraDirs = [];
+    function updateCache(result) {
+        cachedSkills = result.skills;
+        cachedPrompt = result.prompt;
+        cachedDiagnostics = result.diagnostics;
+        lastLoadTime = Date.now();
+        return result;
+    }
+    return {
+        init: (workspace, builtin) => {
+            workspaceDir = workspace;
+            builtinDir = builtin || undefined;
+            return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));
+        },
+        load: () => {
+            return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));
+        },
+        reload: () => {
+            log.info('Reloading skills');
+            return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));
+        },
+        getSkills: () => cachedSkills,
+        getPrompt: () => cachedPrompt,
+        getDiagnostics: () => cachedDiagnostics,
+        getLastLoadTime: () => lastLoadTime,
+        getSkillByName: (name) => {
+            return cachedSkills.find(s => s.name === name);
+        },
+        getEnabledSkills: (config) => {
+            if (!config) {
+                return cachedSkills.filter(s => !s.disableModelInvocation);
+            }
+            return cachedSkills.filter(skill => {
+                const skillConfig = config[skill.name];
+                if (skillConfig?.enabled === false) {
+                    return false;
+                }
+                return !skill.disableModelInvocation;
+            });
+        },
+    };
+}
+// Re-export installer
+export { installSkill, findInstallSpec, hasBinary, getDefaultInstallerPreferences, } from './installer.js';
+// Re-export scanner
+export { scanSkillDirectory, formatScanSummary, collectSkillInstallWarnings, } from './scanner.js';
+// Re-export config manager
+export { resolveSkillConfig, applySkillEnvOverrides, getSkillEnvironment, createSkillConfigManager, isSkillEnabled, validateSkillConfig, } from './config.js';
+// Re-export watcher
+export { createSkillWatcher, createWatcherFromLoader, } from './watcher.js';
+// Re-export test framework
+export { SkillTestFramework, SkillTestRunner, formatTestResults, formatTestResultsJson, formatTestResultsTap, } from './test-framework.js';
+//# sourceMappingURL=index.js.map