musonda 1.0.0

package/dist/plugins/skills/skillTools.js

@@ -0,0 +1,195 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { logger } from '../../utils/logger.js';
+import { createSanitizedChildEnv } from '../../security/childProcessEnv.js';
+export class SkillToolFactory {
+    /**
+     * Creates the built-in skill tools bound to a getter that returns current active skills.
+     */
+    static createTools(getSkills) {
+        const listTool = {
+            name: 'skill_list',
+            description: 'List all available Agent Skills installed via plugins. Returns skill names, descriptions, and capabilities.',
+            parameters: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            execute: async () => {
+                const skills = getSkills();
+                if (skills.length === 0) {
+                    return {
+                        skillsCount: 0,
+                        skills: [],
+                        message: 'No plugin skills currently loaded.',
+                    };
+                }
+                return {
+                    skillsCount: skills.length,
+                    skills: skills.map((s) => ({
+                        name: s.name,
+                        description: s.description,
+                        plugin: s.pluginName,
+                        scripts: s.scripts,
+                        references: s.references,
+                        assets: s.assets,
+                    })),
+                };
+            },
+        };
+        const readTool = {
+            name: 'skill_read',
+            description: 'Read the full instructions and documentation for a specific Agent Skill. Use this when you need detailed procedures to perform a skill task.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    skill_name: {
+                        type: 'string',
+                        description: 'The name of the skill to read.',
+                    },
+                    include_reference: {
+                        type: 'string',
+                        description: 'Optional name of a reference file inside the skill (e.g. "REFERENCE.md").',
+                    },
+                },
+                required: ['skill_name'],
+            },
+            execute: async (args) => {
+                const skills = getSkills();
+                const skill = skills.find((s) => s.name === args.skill_name);
+                if (!skill) {
+                    return {
+                        error: `Skill "${args.skill_name}" not found. Use "skill_list" to see available skills.`,
+                    };
+                }
+                const response = {
+                    name: skill.name,
+                    plugin: skill.pluginName,
+                    description: skill.description,
+                    frontmatter: skill.frontmatter,
+                    instructions: skill.body,
+                    scripts: skill.scripts,
+                    references: skill.references,
+                };
+                if (args.include_reference) {
+                    const refPath = path.join(skill.skillDir, 'references', args.include_reference);
+                    const resolved = path.resolve(refPath);
+                    if (resolved.startsWith(skill.skillDir) && fs.existsSync(resolved)) {
+                        try {
+                            response.referenceContent = fs.readFileSync(resolved, 'utf8');
+                        }
+                        catch (err) {
+                            response.referenceError = `Could not read reference: ${err.message}`;
+                        }
+                    }
+                    else {
+                        response.referenceError = `Reference file "${args.include_reference}" not found or escapes skill boundary.`;
+                    }
+                }
+                return response;
+            },
+        };
+        const runScriptTool = {
+            name: 'skill_run_script',
+            description: 'Run an executable script bundled with an Agent Skill from its scripts/ directory.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    skill_name: {
+                        type: 'string',
+                        description: 'The name of the skill containing the script.',
+                    },
+                    script_name: {
+                        type: 'string',
+                        description: 'The file name of the script in the skill\'s scripts/ folder.',
+                    },
+                    args: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Optional command line arguments to pass to the script.',
+                    },
+                },
+                required: ['skill_name', 'script_name'],
+            },
+            execute: async (args, context) => {
+                const skills = getSkills();
+                const skill = skills.find((s) => s.name === args.skill_name);
+                if (!skill) {
+                    return {
+                        error: `Skill "${args.skill_name}" not found.`,
+                    };
+                }
+                const scriptsDir = path.join(skill.skillDir, 'scripts');
+                const scriptPath = path.join(scriptsDir, args.script_name);
+                const resolvedScript = path.resolve(scriptPath);
+                // Enforce lexical and canonical containment, including symlink escapes.
+                const scriptsRoot = path.resolve(scriptsDir);
+                const relativeScript = path.relative(scriptsRoot, resolvedScript);
+                if (relativeScript.startsWith('..') || path.isAbsolute(relativeScript) || !fs.existsSync(resolvedScript)) {
+                    return {
+                        error: `Script "${args.script_name}" not found in skill "${args.skill_name}".`,
+                    };
+                }
+                let canonicalScript;
+                try {
+                    const canonicalRoot = fs.realpathSync(scriptsRoot);
+                    canonicalScript = fs.realpathSync(resolvedScript);
+                    const canonicalRelative = path.relative(canonicalRoot, canonicalScript);
+                    if (canonicalRelative.startsWith('..') || path.isAbsolute(canonicalRelative) || !fs.statSync(canonicalScript).isFile()) {
+                        return { error: `Script "${args.script_name}" escapes skill "${args.skill_name}" or is not a file.` };
+                    }
+                }
+                catch {
+                    return { error: `Script "${args.script_name}" could not be safely resolved.` };
+                }
+                const scriptArgs = args.args || [];
+                const isWindows = process.platform === 'win32';
+                // Select runner
+                let command = canonicalScript;
+                let finalArgs = scriptArgs;
+                if (canonicalScript.endsWith('.js') || canonicalScript.endsWith('.mjs') || canonicalScript.endsWith('.cjs')) {
+                    command = process.execPath;
+                    finalArgs = [canonicalScript, ...scriptArgs];
+                }
+                else if (canonicalScript.endsWith('.py')) {
+                    command = isWindows ? 'python' : 'python3';
+                    finalArgs = [canonicalScript, ...scriptArgs];
+                }
+                else if (canonicalScript.endsWith('.sh')) {
+                    command = 'bash';
+                    finalArgs = [canonicalScript, ...scriptArgs];
+                }
+                logger.info(`[Skill: ${args.skill_name}] Running script "${path.basename(canonicalScript)}" with ${scriptArgs.length} argument(s).`);
+                return new Promise((resolve) => {
+                    execFile(command, finalArgs, {
+                        cwd: skill.skillDir,
+                        timeout: 30000,
+                        maxBuffer: 2 * 1024 * 1024,
+                        env: createSanitizedChildEnv(process.env, {
+                            SKILL_NAME: skill.name,
+                            SKILL_DIR: skill.skillDir,
+                        }),
+                    }, (err, stdout, stderr) => {
+                        if (err) {
+                            resolve({
+                                error: `Script execution error: ${err.message}`,
+                                stdout: stdout ? stdout.trim() : '',
+                                stderr: stderr ? stderr.trim() : '',
+                            });
+                        }
+                        else {
+                            resolve({
+                                stdout: stdout ? stdout.trim() : '',
+                                stderr: stderr ? stderr.trim() : '',
+                                exitCode: 0,
+                            });
+                        }
+                    });
+                });
+            },
+        };
+        return [listTool, readTool, runScriptTool];
+    }
+}
+//# sourceMappingURL=skillTools.js.map

package/dist/plugins/skills/skillTools.js.map

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

package/dist/plugins/skills/types.d.ts

@@ -0,0 +1,25 @@
+export interface SkillFrontmatter {
+    name: string;
+    description: string;
+    license?: string;
+    compatibility?: string;
+    metadata?: Record<string, string>;
+    'allowed-tools'?: string;
+}
+export interface AgentSkill {
+    name: string;
+    description: string;
+    pluginName: string;
+    skillDir: string;
+    skillFile: string;
+    frontmatter: SkillFrontmatter;
+    body: string;
+    scripts: string[];
+    references: string[];
+    assets: string[];
+}
+export interface SkillValidationResult {
+    valid: boolean;
+    skill?: AgentSkill;
+    errors: string[];
+}

package/dist/plugins/skills/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/skills/types.ts"],"names":[],"mappings":""}

package/dist/plugins/types.d.ts

@@ -0,0 +1,30 @@
+export interface PluginAuthor {
+    name?: string;
+    email?: string;
+    url?: string;
+}
+export interface PluginManifest {
+    $schema: string;
+    name: string;
+    version?: string;
+    description?: string;
+    author?: PluginAuthor;
+    homepage?: string;
+    repository?: string;
+    license?: string;
+    keywords?: string[];
+    extensions?: Record<string, any>;
+    [key: string]: any;
+}
+export interface ManifestValidationResult {
+    valid: boolean;
+    manifest?: PluginManifest;
+    errors: string[];
+    warnings: string[];
+}
+export interface PluginPackage {
+    name: string;
+    rootDir: string;
+    dataDir: string;
+    manifest: PluginManifest;
+}

package/dist/plugins/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":""}

package/dist/scheduler/scheduler.d.ts

@@ -0,0 +1,25 @@
+import { ScheduleJob, CreateScheduleInput } from './types.js';
+export type JobTriggerCallback = (job: ScheduleJob) => Promise<void>;
+export declare class MusondaScheduler {
+    private storage;
+    private cronInstances;
+    private triggerCallback?;
+    private running;
+    private defaultTimezone;
+    constructor(dataDir: string, defaultTimezone?: string);
+    onTrigger(callback: JobTriggerCallback): void;
+    isRunning(): boolean;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    listJobs(filter?: {
+        status?: string;
+        channel?: string;
+    }): ScheduleJob[];
+    getJob(id: string): ScheduleJob | undefined;
+    createJob(input: CreateScheduleInput): ScheduleJob;
+    cancelJob(id: string): boolean;
+    deleteJob(id: string): boolean;
+    private scheduleCronInstance;
+    private executeJob;
+    private updateJobInStorage;
+}

package/dist/scheduler/scheduler.js

@@ -0,0 +1,239 @@
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { Cron } from 'croner';
+import { JsonStorage } from '../memory/storage.js';
+import { logger } from '../utils/logger.js';
+export class MusondaScheduler {
+    storage;
+    cronInstances = new Map();
+    triggerCallback;
+    running = false;
+    defaultTimezone;
+    constructor(dataDir, defaultTimezone = 'UTC') {
+        const schedulesDir = path.join(dataDir, 'schedules');
+        this.storage = new JsonStorage(path.join(schedulesDir, 'jobs.json'));
+        this.defaultTimezone = defaultTimezone;
+    }
+    onTrigger(callback) {
+        this.triggerCallback = callback;
+    }
+    isRunning() {
+        return this.running;
+    }
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        const jobs = this.storage.read([]);
+        let scheduledCount = 0;
+        for (const job of jobs) {
+            if (job.status === 'active') {
+                const scheduled = this.scheduleCronInstance(job);
+                if (scheduled)
+                    scheduledCount++;
+            }
+        }
+        logger.info(`Scheduler started. Loaded ${jobs.length} job(s), ${scheduledCount} active.`);
+    }
+    async stop() {
+        this.running = false;
+        for (const [id, cron] of this.cronInstances.entries()) {
+            cron.stop();
+        }
+        this.cronInstances.clear();
+        logger.info('Scheduler stopped.');
+    }
+    listJobs(filter) {
+        const jobs = this.storage.read([]);
+        return jobs.filter((job) => {
+            if (filter?.status && job.status !== filter.status)
+                return false;
+            if (filter?.channel && job.target.channel !== filter.channel)
+                return false;
+            return true;
+        });
+    }
+    getJob(id) {
+        const jobs = this.storage.read([]);
+        return jobs.find((j) => j.id === id);
+    }
+    createJob(input) {
+        const jobs = this.storage.read([]);
+        const now = new Date();
+        let jobType = input.type || 'cron';
+        let targetPattern = input.pattern.trim();
+        let maxRuns = input.maxRuns;
+        // Handle relative duration syntax (e.g. "+30m", "+2h", "+1d", "+45s")
+        const relativeMatch = targetPattern.match(/^\+(\d+)\s*(s|m|h|d|sec|min|hour|day)s?$/i);
+        if (relativeMatch) {
+            const amount = parseInt(relativeMatch[1], 10);
+            const unit = relativeMatch[2].toLowerCase();
+            let ms = 0;
+            if (unit.startsWith('s'))
+                ms = amount * 1000;
+            else if (unit.startsWith('m'))
+                ms = amount * 60 * 1000;
+            else if (unit.startsWith('h'))
+                ms = amount * 3600 * 1000;
+            else if (unit.startsWith('d'))
+                ms = amount * 86400 * 1000;
+            const runDate = new Date(now.getTime() + ms);
+            targetPattern = runDate.toISOString();
+            jobType = 'once';
+            maxRuns = 1;
+        }
+        else if (!isNaN(Date.parse(targetPattern)) && !targetPattern.includes('*')) {
+            // Looks like an ISO date or timestamp
+            jobType = 'once';
+            maxRuns = 1;
+        }
+        const timezone = input.timezone || this.defaultTimezone;
+        const id = `job_${crypto.randomBytes(4).toString('hex')}`;
+        const newJob = {
+            id,
+            title: input.title,
+            type: jobType,
+            pattern: targetPattern,
+            timezone,
+            target: input.target,
+            action: input.action,
+            createdAt: now.toISOString(),
+            runCount: 0,
+            maxRuns,
+            status: 'active',
+        };
+        // Attempt to calculate nextRunAt
+        try {
+            const testCron = new Cron(newJob.pattern, {
+                timezone: newJob.timezone,
+                maxRuns: newJob.maxRuns,
+            });
+            const nextDate = testCron.nextRun();
+            newJob.nextRunAt = nextDate ? nextDate.toISOString() : undefined;
+            testCron.stop();
+        }
+        catch (err) {
+            throw new Error(`Invalid schedule pattern or cron expression "${input.pattern}": ${err.message}`);
+        }
+        jobs.push(newJob);
+        this.storage.write(jobs);
+        if (this.running) {
+            this.scheduleCronInstance(newJob);
+        }
+        logger.info(`Created schedule "${newJob.title}" [${newJob.type}] next run: ${newJob.nextRunAt || 'none'}`);
+        return newJob;
+    }
+    cancelJob(id) {
+        const jobs = this.storage.read([]);
+        const jobIndex = jobs.findIndex((j) => j.id === id);
+        if (jobIndex === -1)
+            return false;
+        // Stop runtime instance
+        const cron = this.cronInstances.get(id);
+        if (cron) {
+            cron.stop();
+            this.cronInstances.delete(id);
+        }
+        jobs[jobIndex].status = 'completed';
+        jobs[jobIndex].nextRunAt = undefined;
+        this.storage.write(jobs);
+        logger.info(`Cancelled schedule job id: ${id}`);
+        return true;
+    }
+    deleteJob(id) {
+        const jobs = this.storage.read([]);
+        const initialLen = jobs.length;
+        const filtered = jobs.filter((j) => j.id !== id);
+        if (filtered.length === initialLen)
+            return false;
+        const cron = this.cronInstances.get(id);
+        if (cron) {
+            cron.stop();
+            this.cronInstances.delete(id);
+        }
+        this.storage.write(filtered);
+        logger.info(`Deleted schedule job id: ${id}`);
+        return true;
+    }
+    scheduleCronInstance(job) {
+        if (job.status !== 'active')
+            return false;
+        // Stop existing if any
+        const existing = this.cronInstances.get(job.id);
+        if (existing) {
+            existing.stop();
+            this.cronInstances.delete(job.id);
+        }
+        try {
+            const cron = new Cron(job.pattern, {
+                timezone: job.timezone,
+                maxRuns: job.maxRuns ? job.maxRuns - job.runCount : undefined,
+            }, async () => {
+                await this.executeJob(job.id);
+            });
+            const nextDate = cron.nextRun();
+            if (!nextDate) {
+                // No future runs remaining
+                job.status = 'completed';
+                job.nextRunAt = undefined;
+                this.updateJobInStorage(job);
+                return false;
+            }
+            job.nextRunAt = nextDate.toISOString();
+            this.updateJobInStorage(job);
+            this.cronInstances.set(job.id, cron);
+            return true;
+        }
+        catch (err) {
+            logger.error(`Failed to schedule job "${job.title}" (${job.id}):`, err.message);
+            job.status = 'error';
+            job.lastError = err.message;
+            this.updateJobInStorage(job);
+            return false;
+        }
+    }
+    async executeJob(jobId) {
+        const job = this.getJob(jobId);
+        if (!job || job.status !== 'active')
+            return;
+        logger.info(`⏰ Triggering schedule: "${job.title}" (type: ${job.type})`);
+        const now = new Date();
+        job.lastRunAt = now.toISOString();
+        job.runCount += 1;
+        try {
+            if (this.triggerCallback) {
+                await this.triggerCallback(job);
+            }
+            // Check if job completed
+            const cron = this.cronInstances.get(job.id);
+            const nextDate = cron?.nextRun();
+            if (!nextDate || (job.maxRuns && job.runCount >= job.maxRuns) || job.type === 'once') {
+                job.status = 'completed';
+                job.nextRunAt = undefined;
+                if (cron) {
+                    cron.stop();
+                    this.cronInstances.delete(job.id);
+                }
+            }
+            else {
+                job.nextRunAt = nextDate.toISOString();
+            }
+        }
+        catch (err) {
+            logger.error(`Error executing schedule job "${job.title}":`, err);
+            job.lastError = err.message || 'Execution error';
+        }
+        finally {
+            this.updateJobInStorage(job);
+        }
+    }
+    updateJobInStorage(updatedJob) {
+        const jobs = this.storage.read([]);
+        const idx = jobs.findIndex((j) => j.id === updatedJob.id);
+        if (idx !== -1) {
+            jobs[idx] = updatedJob;
+            this.storage.write(jobs);
+        }
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler/scheduler.js.map

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

package/dist/scheduler/types.d.ts

@@ -0,0 +1,39 @@
+export type ScheduleType = 'cron' | 'once';
+export type ScheduleStatus = 'active' | 'completed' | 'paused' | 'error';
+export type ScheduleActionType = 'prompt' | 'reminder';
+export interface ScheduleTarget {
+    channel: 'discord' | 'slack' | 'webhook' | 'cli';
+    channelId: string;
+    userId: string;
+    userName?: string;
+    threadTs?: string;
+}
+export interface ScheduleAction {
+    type: ScheduleActionType;
+    content: string;
+}
+export interface ScheduleJob {
+    id: string;
+    title: string;
+    type: ScheduleType;
+    pattern: string;
+    timezone: string;
+    target: ScheduleTarget;
+    action: ScheduleAction;
+    createdAt: string;
+    lastRunAt?: string;
+    nextRunAt?: string;
+    runCount: number;
+    maxRuns?: number;
+    status: ScheduleStatus;
+    lastError?: string;
+}
+export interface CreateScheduleInput {
+    title: string;
+    type?: ScheduleType;
+    pattern: string;
+    timezone?: string;
+    target: ScheduleTarget;
+    action: ScheduleAction;
+    maxRuns?: number;
+}

package/dist/scheduler/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scheduler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scheduler/types.ts"],"names":[],"mappings":""}

package/dist/security/childProcessEnv.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Builds a minimal environment for untrusted plugin child processes.
+ * Extra values are explicit capabilities granted by the caller.
+ */
+export declare function createSanitizedChildEnv(source?: NodeJS.ProcessEnv, extra?: Record<string, string>): Record<string, string>;

package/dist/security/childProcessEnv.js

@@ -0,0 +1,42 @@
+const SAFE_SYSTEM_ENV_KEYS = new Set([
+    'PATH',
+    'PATHEXT',
+    'SYSTEMROOT',
+    'WINDIR',
+    'COMSPEC',
+    'TEMP',
+    'TMP',
+    'HOME',
+    'HOMEPATH',
+    'HOMEDRIVE',
+    'USERPROFILE',
+    'APPDATA',
+    'LOCALAPPDATA',
+    'LANG',
+    'LANGUAGE',
+    'LC_ALL',
+    'LC_CTYPE',
+    'SHELL',
+    'TERM',
+    'NODE_PATH',
+    'NODE_ENV',
+]);
+const SECRET_NAME_FRAGMENTS = ['KEY', 'TOKEN', 'SECRET', 'PASSWORD', 'CREDENTIAL'];
+/**
+ * Builds a minimal environment for untrusted plugin child processes.
+ * Extra values are explicit capabilities granted by the caller.
+ */
+export function createSanitizedChildEnv(source = process.env, extra = {}) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (!value)
+            continue;
+        const upperKey = key.toUpperCase();
+        if (SECRET_NAME_FRAGMENTS.some((fragment) => upperKey.includes(fragment)))
+            continue;
+        if (SAFE_SYSTEM_ENV_KEYS.has(upperKey))
+            sanitized[key] = value;
+    }
+    return { ...sanitized, ...extra };
+}
+//# sourceMappingURL=childProcessEnv.js.map

package/dist/security/childProcessEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"childProcessEnv.js","sourceRoot":"","sources":["../../src/security/childProcessEnv.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,MAAM;IACN,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,MAAM;IACN,KAAK;IACL,MAAM;IACN,UAAU;IACV,WAAW;IACX,aAAa;IACb,SAAS;IACT,cAAc;IACd,MAAM;IACN,UAAU;IACV,QAAQ;IACR,UAAU;IACV,OAAO;IACP,MAAM;IACN,WAAW;IACX,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAEnF;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAM,GAAsB,OAAO,CAAC,GAAG,EACvC,KAAK,GAA2B,EAAE;IAElC,MAAM,SAAS,GAA2B,EAAE,CAAC;IAE7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACnC,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAAE,SAAS;QACpF,IAAI,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACjE,CAAC;IAED,OAAO,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;AACpC,CAAC"}