musonda 1.0.0

package/dist/memory/storage.js

@@ -0,0 +1,187 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export class JsonStorage {
+    filePath;
+    maxBackups = 10;
+    constructor(filePath) {
+        this.filePath = path.resolve(filePath);
+        this.ensureDirectory();
+    }
+    ensureDirectory() {
+        const dir = path.dirname(this.filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    acquireLock(timeoutMs = 5000) {
+        const lockPath = `${this.filePath}.lock`;
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            try {
+                const fd = fs.openSync(lockPath, 'wx');
+                fs.writeSync(fd, `${process.pid}\n${Date.now()}`);
+                fs.closeSync(fd);
+                return true;
+            }
+            catch (err) {
+                if (err.code === 'EEXIST') {
+                    // Check for stale lock (> 10 seconds old)
+                    try {
+                        const stat = fs.statSync(lockPath);
+                        if (Date.now() - stat.mtimeMs > 10000) {
+                            fs.unlinkSync(lockPath);
+                            continue;
+                        }
+                    }
+                    catch { }
+                    // Short backoff
+                    const waitStart = Date.now();
+                    while (Date.now() - waitStart < 25) {
+                        // busy spin wait 25ms
+                    }
+                }
+                else {
+                    return false;
+                }
+            }
+        }
+        return false;
+    }
+    releaseLock() {
+        const lockPath = `${this.filePath}.lock`;
+        try {
+            if (fs.existsSync(lockPath)) {
+                fs.unlinkSync(lockPath);
+            }
+        }
+        catch { }
+    }
+    exists() {
+        return fs.existsSync(this.filePath);
+    }
+    read(defaultValue) {
+        if (!this.exists()) {
+            return defaultValue;
+        }
+        const raw = fs.readFileSync(this.filePath, 'utf-8');
+        if (!raw.trim()) {
+            return defaultValue;
+        }
+        try {
+            return JSON.parse(raw);
+        }
+        catch (err) {
+            const corruptBackupPath = `${this.filePath}.corrupt.${Date.now()}.bak`;
+            try {
+                fs.copyFileSync(this.filePath, corruptBackupPath);
+                console.error(`[STORAGE CRITICAL] Corrupted JSON detected in "${this.filePath}". Backed up original to "${corruptBackupPath}". Error: ${err.message}`);
+            }
+            catch (backupErr) {
+                console.error(`[STORAGE CRITICAL] Failed to create backup of corrupted file "${this.filePath}": ${backupErr.message}`);
+            }
+            return defaultValue;
+        }
+    }
+    write(data) {
+        this.ensureDirectory();
+        this.acquireLock();
+        const tempPath = `${this.filePath}.tmp.${Date.now()}`;
+        try {
+            const serialized = JSON.stringify(data, null, 2);
+            fs.writeFileSync(tempPath, serialized, 'utf-8');
+            // Keep latest pre-write backup if the file already exists
+            if (fs.existsSync(this.filePath)) {
+                try {
+                    fs.copyFileSync(this.filePath, `${this.filePath}.bak`);
+                }
+                catch { }
+            }
+            fs.renameSync(tempPath, this.filePath);
+        }
+        catch (err) {
+            if (fs.existsSync(tempPath)) {
+                try {
+                    fs.unlinkSync(tempPath);
+                }
+                catch { }
+            }
+            throw err;
+        }
+        finally {
+            this.releaseLock();
+        }
+    }
+    /**
+     * Creates an explicit snapshot backup of the current storage file in a .backups subdirectory.
+     * Automatically enforces rotation to retain the latest configured number of backups.
+     */
+    createBackup(tag) {
+        if (!this.exists())
+            return null;
+        const backupDir = path.join(path.dirname(this.filePath), '.backups');
+        if (!fs.existsSync(backupDir)) {
+            fs.mkdirSync(backupDir, { recursive: true });
+        }
+        const baseName = path.basename(this.filePath, '.json');
+        const timestamp = Date.now();
+        const backupFileName = `${baseName}.${tag || timestamp}.bak.json`;
+        const destination = path.join(backupDir, backupFileName);
+        try {
+            fs.copyFileSync(this.filePath, destination);
+            // Rotate older backups
+            const files = fs
+                .readdirSync(backupDir)
+                .filter((f) => f.startsWith(`${baseName}.`) && f.endsWith('.bak.json'))
+                .map((f) => ({
+                name: f,
+                path: path.join(backupDir, f),
+                time: fs.statSync(path.join(backupDir, f)).mtimeMs,
+            }))
+                .sort((a, b) => b.time - a.time);
+            if (files.length > this.maxBackups) {
+                for (const file of files.slice(this.maxBackups)) {
+                    try {
+                        fs.unlinkSync(file.path);
+                    }
+                    catch { }
+                }
+            }
+            return destination;
+        }
+        catch (err) {
+            console.error(`[STORAGE] Failed to create backup for "${this.filePath}": ${err.message}`);
+            return null;
+        }
+    }
+    /**
+     * Lists all existing backups for this storage instance, newest first.
+     */
+    listBackups() {
+        const backupDir = path.join(path.dirname(this.filePath), '.backups');
+        if (!fs.existsSync(backupDir))
+            return [];
+        const baseName = path.basename(this.filePath, '.json');
+        return fs
+            .readdirSync(backupDir)
+            .filter((f) => f.startsWith(`${baseName}.`) && f.endsWith('.bak.json'))
+            .map((f) => path.join(backupDir, f))
+            .sort((a, b) => fs.statSync(b).mtimeMs - fs.statSync(a).mtimeMs);
+    }
+    /**
+     * Restores data from the specified backup or the latest backup available.
+     */
+    restoreBackup(backupPath) {
+        const target = backupPath || this.listBackups()[0];
+        if (!target || !fs.existsSync(target))
+            return false;
+        try {
+            this.ensureDirectory();
+            fs.copyFileSync(target, this.filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/memory/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/memory/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,OAAO,WAAW;IACd,QAAQ,CAAS;IACjB,UAAU,GAAW,EAAE,CAAC;IAEhC,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAEO,eAAe;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,SAAS,GAAW,IAAI;QAC1C,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,QAAQ,OAAO,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBACvC,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAClD,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACjB,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC1B,0CAA0C;oBAC1C,IAAI,CAAC;wBACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;wBACnC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;4BACtC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;4BACxB,SAAS;wBACX,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC,CAAA,CAAC;oBACV,gBAAgB;oBAChB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,EAAE,EAAE,CAAC;wBACnC,sBAAsB;oBACxB,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,WAAW;QACjB,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,QAAQ,OAAO,CAAC;QACzC,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAEM,MAAM;QACX,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAEM,IAAI,CAAC,YAAe;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAChB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,iBAAiB,GAAG,GAAG,IAAI,CAAC,QAAQ,YAAY,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;YACvE,IAAI,CAAC;gBACH,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;gBAClD,OAAO,CAAC,KAAK,CACX,kDAAkD,IAAI,CAAC,QAAQ,6BAA6B,iBAAiB,aAAa,GAAG,CAAC,OAAO,EAAE,CACxI,CAAC;YACJ,CAAC;YAAC,OAAO,SAAc,EAAE,CAAC;gBACxB,OAAO,CAAC,KAAK,CACX,iEAAiE,IAAI,CAAC,QAAQ,MAAM,SAAS,CAAC,OAAO,EAAE,CACxG,CAAC;YACJ,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAO;QAClB,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACjD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAEhD,0DAA0D;YAC1D,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,MAAM,CAAC,CAAC;gBACzD,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;YACZ,CAAC;YAED,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAC1B,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;YACZ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,YAAY,CAAC,GAAY;QAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;QACrE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,GAAG,QAAQ,IAAI,GAAG,IAAI,SAAS,WAAW,CAAC;QAClE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAEzD,IAAI,CAAC;YACH,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAE5C,uBAAuB;YACvB,MAAM,KAAK,GAAG,EAAE;iBACb,WAAW,CAAC,SAAS,CAAC;iBACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;iBACtE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACX,IAAI,EAAE,CAAC;gBACP,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC7B,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;aACnD,CAAC,CAAC;iBACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;YAEnC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;gBACnC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;oBAChD,IAAI,CAAC;wBACH,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC3B,CAAC;oBAAC,MAAM,CAAC,CAAA,CAAC;gBACZ,CAAC;YACH,CAAC;YAED,OAAO,WAAW,CAAC;QACrB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,0CAA0C,IAAI,CAAC,QAAQ,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1F,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACI,WAAW;QAChB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;QACrE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,EAAE;aACN,WAAW,CAAC,SAAS,CAAC;aACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;aACtE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;aACnC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,UAAmB;QACtC,MAAM,MAAM,GAAG,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QACpD,IAAI,CAAC;YACH,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/memory/types.d.ts

@@ -0,0 +1,43 @@
+export type MemoryCategory = 'fact' | 'preference' | 'project' | 'goal' | 'note' | 'general';
+export interface MemoryItem {
+    id: string;
+    category: MemoryCategory;
+    content: string;
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+    accessCount: number;
+}
+export interface UserMemoryProfile {
+    name: string;
+    assistantCustomName: string;
+    bio: string;
+    interests: string[];
+    timezone: string;
+    communicationStyle: 'concise' | 'detailed' | 'friendly' | 'technical';
+    notes: string;
+    customInstructions: string;
+    updatedAt: string;
+}
+export interface SessionMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+    toolCallId?: string;
+    name?: string;
+    timestamp: string;
+}
+export interface SessionRecord {
+    sessionId: string;
+    channel: string;
+    userId: string;
+    userName?: string;
+    createdAt: string;
+    updatedAt: string;
+    messages: SessionMessage[];
+}

package/dist/memory/types.js

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

package/dist/memory/types.js.map

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

package/dist/plugins/manifest.d.ts

@@ -0,0 +1,23 @@
+import { ManifestValidationResult } from './types.js';
+export declare const AGENT_PLUGINS_SCHEMA_V1 = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
+export declare class ManifestValidator {
+    /**
+     * Validates a plugin name according to Agent Plugins 1.0.0 Section 5.5:
+     * - 1 to 64 characters
+     * - Lowercase alphanumeric characters, hyphens, and periods only
+     * - First and last characters must be alphanumeric
+     * - No consecutive hyphens (--) and no consecutive periods (..)
+     */
+    static validatePluginName(name: string): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Validates an in-memory manifest object against Agent Plugins 1.0.0 specification.
+     */
+    static validate(data: unknown): ManifestValidationResult;
+    /**
+     * Loads and validates a plugin manifest from a given plugin root directory.
+     */
+    static loadFromDirectory(pluginDir: string): ManifestValidationResult;
+}

package/dist/plugins/manifest.js

@@ -0,0 +1,185 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export const AGENT_PLUGINS_SCHEMA_V1 = 'https://agent-plugins.org/schemas/1.0.0/plugin.schema.json';
+const PERMITTED_TOP_LEVEL_FIELDS = new Set([
+    '$schema',
+    'name',
+    'version',
+    'description',
+    'author',
+    'homepage',
+    'repository',
+    'license',
+    'keywords',
+    'extensions',
+]);
+export class ManifestValidator {
+    /**
+     * Validates a plugin name according to Agent Plugins 1.0.0 Section 5.5:
+     * - 1 to 64 characters
+     * - Lowercase alphanumeric characters, hyphens, and periods only
+     * - First and last characters must be alphanumeric
+     * - No consecutive hyphens (--) and no consecutive periods (..)
+     */
+    static validatePluginName(name) {
+        if (typeof name !== 'string') {
+            return { valid: false, error: 'Plugin name must be a string.' };
+        }
+        if (name.length < 1 || name.length > 64) {
+            return { valid: false, error: `Plugin name must be 1-64 characters (got ${name.length}).` };
+        }
+        if (name.includes('--')) {
+            return { valid: false, error: 'Plugin name must not contain consecutive hyphens ("--").' };
+        }
+        if (name.includes('..')) {
+            return { valid: false, error: 'Plugin name must not contain consecutive periods ("..").' };
+        }
+        // Check characters and start/end alphanumeric
+        const nameRegex = /^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/;
+        if (!nameRegex.test(name)) {
+            return {
+                valid: false,
+                error: 'Plugin name must contain only lowercase alphanumeric characters, hyphens, and periods, and start/end with an alphanumeric character.',
+            };
+        }
+        return { valid: true };
+    }
+    /**
+     * Validates an in-memory manifest object against Agent Plugins 1.0.0 specification.
+     */
+    static validate(data) {
+        const errors = [];
+        const warnings = [];
+        if (!data || typeof data !== 'object' || Array.isArray(data)) {
+            return {
+                valid: false,
+                errors: ['plugin.json must be a JSON object.'],
+                warnings,
+            };
+        }
+        const obj = data;
+        // 1. Required $schema field
+        if (!obj.$schema || typeof obj.$schema !== 'string') {
+            errors.push('Manifest missing required string field "$schema".');
+        }
+        else if (obj.$schema !== AGENT_PLUGINS_SCHEMA_V1) {
+            errors.push(`Unsupported or invalid $schema: "${obj.$schema}". Musonda supports "${AGENT_PLUGINS_SCHEMA_V1}".`);
+        }
+        // 2. Required name field
+        if (obj.name === undefined || obj.name === null) {
+            errors.push('Manifest missing required string field "name".');
+        }
+        else {
+            const nameCheck = this.validatePluginName(obj.name);
+            if (!nameCheck.valid) {
+                errors.push(nameCheck.error);
+            }
+        }
+        // 3. Metadata fields
+        if (obj.version !== undefined && typeof obj.version !== 'string') {
+            errors.push('"version" field must be a string.');
+        }
+        if (obj.description !== undefined && typeof obj.description !== 'string') {
+            errors.push('"description" field must be a string.');
+        }
+        if (obj.homepage !== undefined && typeof obj.homepage !== 'string') {
+            errors.push('"homepage" field must be a string.');
+        }
+        if (obj.repository !== undefined && typeof obj.repository !== 'string') {
+            errors.push('"repository" field must be a string.');
+        }
+        if (obj.license !== undefined && typeof obj.license !== 'string') {
+            errors.push('"license" field must be a string.');
+        }
+        if (obj.keywords !== undefined) {
+            if (!Array.isArray(obj.keywords) || obj.keywords.some((k) => typeof k !== 'string')) {
+                errors.push('"keywords" field must be an array of strings.');
+            }
+        }
+        // Author field: may only contain 'name', 'email', 'url' string fields
+        if (obj.author !== undefined) {
+            if (typeof obj.author !== 'object' || obj.author === null || Array.isArray(obj.author)) {
+                errors.push('"author" field must be an object.');
+            }
+            else {
+                const allowedAuthorFields = new Set(['name', 'email', 'url']);
+                for (const [key, val] of Object.entries(obj.author)) {
+                    if (!allowedAuthorFields.has(key)) {
+                        errors.push(`"author" object contains forbidden property "${key}". Only name, email, url are allowed.`);
+                    }
+                    else if (typeof val !== 'string') {
+                        errors.push(`"author.${key}" must be a string.`);
+                    }
+                }
+            }
+        }
+        // Non-fatal: check unknown top-level fields
+        for (const key of Object.keys(obj)) {
+            if (!PERMITTED_TOP_LEVEL_FIELDS.has(key)) {
+                warnings.push(`Unknown top-level field "${key}" in plugin.json is ignored per specification.`);
+            }
+        }
+        // Non-fatal: check extensions
+        if (obj.extensions !== undefined) {
+            if (typeof obj.extensions !== 'object' || obj.extensions === null || Array.isArray(obj.extensions)) {
+                warnings.push('Field "extensions" is not an object; ignoring extensions per specification.');
+            }
+        }
+        if (errors.length > 0) {
+            return { valid: false, errors, warnings };
+        }
+        return {
+            valid: true,
+            manifest: obj,
+            errors: [],
+            warnings,
+        };
+    }
+    /**
+     * Loads and validates a plugin manifest from a given plugin root directory.
+     */
+    static loadFromDirectory(pluginDir) {
+        const resolvedRoot = path.resolve(pluginDir);
+        const manifestPath = path.join(resolvedRoot, 'plugin.json');
+        // Enforce filesystem containment
+        const resolvedManifestPath = path.resolve(manifestPath);
+        if (!resolvedManifestPath.startsWith(resolvedRoot)) {
+            return {
+                valid: false,
+                errors: [`plugin.json path escapes plugin root: "${manifestPath}"`],
+                warnings: [],
+            };
+        }
+        if (!fs.existsSync(resolvedManifestPath)) {
+            return {
+                valid: false,
+                errors: [`No plugin.json found in plugin root: "${resolvedRoot}"`],
+                warnings: [],
+            };
+        }
+        let fileContent;
+        try {
+            fileContent = fs.readFileSync(resolvedManifestPath, 'utf8');
+        }
+        catch (err) {
+            return {
+                valid: false,
+                errors: [`Failed to read plugin.json: ${err.message}`],
+                warnings: [],
+            };
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(fileContent);
+        }
+        catch (err) {
+            return {
+                valid: false,
+                errors: [`plugin.json is not valid JSON: ${err.message}`],
+                warnings: [],
+            };
+        }
+        return this.validate(parsed);
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/plugins/manifest.js.map

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

package/dist/plugins/mcp/mcpBridge.d.ts

@@ -0,0 +1,31 @@
+import { ToolDefinition } from '../../tools/types.js';
+import { ToolRegistry } from '../../tools/registry.js';
+import { ResolvedMcpServer } from './types.js';
+import { McpClientInterface } from './mcpClient.js';
+export interface ActiveMcpServer {
+    server: ResolvedMcpServer;
+    client: McpClientInterface;
+    tools: ToolDefinition[];
+}
+export declare class McpBridge {
+    private activeServers;
+    /**
+     * Sanitizes names into valid OpenAI function tool names:
+     * 1-64 characters matching ^[a-zA-Z0-9_-]+$
+     */
+    static sanitizeToolName(name: string): string;
+    /**
+     * Connects to a resolved MCP server, lists its tools, and registers them in Musonda's ToolRegistry.
+     * If the server fails to connect or list tools, logs warning and skips it without failing other components.
+     */
+    registerServer(server: ResolvedMcpServer, registry: ToolRegistry): Promise<boolean>;
+    getActiveServers(): ActiveMcpServer[];
+    /**
+     * Gracefully disconnects and unregisters all MCP servers and their bridged tools for a given plugin.
+     */
+    unregisterServersForPlugin(pluginName: string, registry?: ToolRegistry): Promise<void>;
+    /**
+     * Gracefully shuts down all active MCP servers (terminates stdio subprocesses).
+     */
+    shutdown(): Promise<void>;
+}

package/dist/plugins/mcp/mcpBridge.js

@@ -0,0 +1,115 @@
+import { McpStdioClient, McpHttpClient } from './mcpClient.js';
+import { logger } from '../../utils/logger.js';
+export class McpBridge {
+    activeServers = [];
+    /**
+     * Sanitizes names into valid OpenAI function tool names:
+     * 1-64 characters matching ^[a-zA-Z0-9_-]+$
+     */
+    static sanitizeToolName(name) {
+        const sanitized = name.replace(/[^a-zA-Z0-9_-]/g, '_');
+        return sanitized.substring(0, 64);
+    }
+    /**
+     * Connects to a resolved MCP server, lists its tools, and registers them in Musonda's ToolRegistry.
+     * If the server fails to connect or list tools, logs warning and skips it without failing other components.
+     */
+    async registerServer(server, registry) {
+        logger.info(`[MCP Bridge] Connecting to server "${server.name}" (plugin: "${server.pluginName}", type: "${server.config.type}")...`);
+        let client;
+        if (server.config.type === 'stdio') {
+            client = new McpStdioClient(server);
+        }
+        else {
+            client = new McpHttpClient(server);
+        }
+        try {
+            await client.connect();
+        }
+        catch (err) {
+            logger.warn(`[MCP Bridge] Failed to connect to server "${server.name}" in plugin "${server.pluginName}": ${err.message}. Skipping server.`);
+            return false;
+        }
+        let mcpTools = [];
+        try {
+            mcpTools = await client.listTools();
+        }
+        catch (err) {
+            logger.warn(`[MCP Bridge] Failed to list tools from server "${server.name}": ${err.message}. Skipping server.`);
+            await client.close();
+            return false;
+        }
+        const registeredTools = [];
+        for (const tool of mcpTools) {
+            const bridgeToolName = McpBridge.sanitizeToolName(`mcp_${server.pluginName}_${server.name}_${tool.name}`);
+            // Normalize parameters schema
+            const paramsSchema = {
+                type: 'object',
+                properties: (tool.inputSchema && tool.inputSchema.properties) || {},
+                required: (tool.inputSchema && tool.inputSchema.required) || [],
+            };
+            const toolDef = {
+                name: bridgeToolName,
+                description: `[MCP Plugin: ${server.pluginName} / Server: ${server.name}] ${tool.description || tool.name}`,
+                parameters: paramsSchema,
+                execute: async (args) => {
+                    logger.tool(bridgeToolName, JSON.stringify(args).substring(0, 100));
+                    const result = await client.callTool(tool.name, args);
+                    if (result.isError) {
+                        return { error: result.output || 'MCP tool execution reported an error.' };
+                    }
+                    return result.output;
+                },
+            };
+            registry.register(toolDef);
+            registeredTools.push(toolDef);
+            logger.info(`[MCP Bridge] Registered bridged tool: "${bridgeToolName}"`);
+        }
+        this.activeServers.push({
+            server,
+            client,
+            tools: registeredTools,
+        });
+        return true;
+    }
+    getActiveServers() {
+        return this.activeServers;
+    }
+    /**
+     * Gracefully disconnects and unregisters all MCP servers and their bridged tools for a given plugin.
+     */
+    async unregisterServersForPlugin(pluginName, registry) {
+        const serversToClose = this.activeServers.filter((s) => s.server.pluginName === pluginName);
+        this.activeServers = this.activeServers.filter((s) => s.server.pluginName !== pluginName);
+        for (const active of serversToClose) {
+            if (registry) {
+                for (const tool of active.tools) {
+                    registry.unregister(tool.name);
+                    logger.info(`[MCP Bridge] Unregistered bridged tool: "${tool.name}"`);
+                }
+            }
+            try {
+                await active.client.close();
+            }
+            catch (err) {
+                logger.warn(`Error closing MCP server "${active.server.name}": ${err.message}`);
+            }
+        }
+    }
+    /**
+     * Gracefully shuts down all active MCP servers (terminates stdio subprocesses).
+     */
+    async shutdown() {
+        logger.info(`[MCP Bridge] Shutting down ${this.activeServers.length} active MCP server(s)...`);
+        for (const active of this.activeServers) {
+            try {
+                await active.client.close();
+            }
+            catch (err) {
+                logger.warn(`Error closing MCP server "${active.server.name}": ${err.message}`);
+            }
+        }
+        this.activeServers = [];
+    }
+}
+//# sourceMappingURL=mcpBridge.js.map

package/dist/plugins/mcp/mcpBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpBridge.js","sourceRoot":"","sources":["../../../src/plugins/mcp/mcpBridge.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAQ/C,MAAM,OAAO,SAAS;IACZ,aAAa,GAAsB,EAAE,CAAC;IAE9C;;;OAGG;IACI,MAAM,CAAC,gBAAgB,CAAC,IAAY;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QACvD,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,cAAc,CACzB,MAAyB,EACzB,QAAsB;QAEtB,MAAM,CAAC,IAAI,CACT,sCAAsC,MAAM,CAAC,IAAI,eAAe,MAAM,CAAC,UAAU,aAAa,MAAM,CAAC,MAAM,CAAC,IAAI,OAAO,CACxH,CAAC;QAEF,IAAI,MAA0B,CAAC;QAC/B,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACnC,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CACT,6CAA6C,MAAM,CAAC,IAAI,gBAAgB,MAAM,CAAC,UAAU,MAAM,GAAG,CAAC,OAAO,oBAAoB,CAC/H,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,QAAQ,GAAoB,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QACtC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CACT,kDAAkD,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,oBAAoB,CACnG,CAAC;YACF,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,eAAe,GAAqB,EAAE,CAAC;QAE7C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,cAAc,GAAG,SAAS,CAAC,gBAAgB,CAC/C,OAAO,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CACvD,CAAC;YAEF,8BAA8B;YAC9B,MAAM,YAAY,GAAyB;gBACzC,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,EAAE;gBACnE,QAAQ,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE;aAChE,CAAC;YAEF,MAAM,OAAO,GAAmB;gBAC9B,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,gBAAgB,MAAM,CAAC,UAAU,cAAc,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,EAAE;gBAC3G,UAAU,EAAE,YAAY;gBACxB,OAAO,EAAE,KAAK,EAAE,IAAyB,EAAE,EAAE;oBAC3C,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;oBACpE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACtD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;wBACnB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,IAAI,uCAAuC,EAAE,CAAC;oBAC7E,CAAC;oBACD,OAAO,MAAM,CAAC,MAAM,CAAC;gBACvB,CAAC;aACF,CAAC;YAEF,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3B,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,0CAA0C,cAAc,GAAG,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;YACtB,MAAM;YACN,MAAM;YACN,KAAK,EAAE,eAAe;SACvB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,gBAAgB;QACrB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,0BAA0B,CACrC,UAAkB,EAClB,QAAuB;QAEvB,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QAC5F,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QAE1F,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;YACpC,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAChC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC/B,MAAM,CAAC,IAAI,CAAC,4CAA4C,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC9B,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,MAAM,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ;QACnB,MAAM,CAAC,IAAI,CAAC,8BAA8B,IAAI,CAAC,aAAa,CAAC,MAAM,0BAA0B,CAAC,CAAC;QAC/F,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC9B,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,MAAM,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dist/plugins/mcp/mcpClient.d.ts

@@ -0,0 +1,43 @@
+import { ResolvedMcpServer, McpToolSchema } from './types.js';
+export interface McpClientInterface {
+    connect(): Promise<void>;
+    listTools(): Promise<McpToolSchema[]>;
+    callTool(name: string, args: Record<string, any>): Promise<{
+        output: string;
+        isError?: boolean;
+    }>;
+    close(): Promise<void>;
+}
+export declare class McpStdioClient implements McpClientInterface {
+    private server;
+    private child;
+    private pendingRequests;
+    private nextRequestId;
+    private isConnected;
+    constructor(server: ResolvedMcpServer);
+    connect(): Promise<void>;
+    private handleMessage;
+    sendRequest(method: string, params?: any, timeoutMs?: number): Promise<any>;
+    sendNotification(method: string, params?: any): void;
+    listTools(): Promise<McpToolSchema[]>;
+    callTool(name: string, args: Record<string, any>): Promise<{
+        output: string;
+        isError?: boolean;
+    }>;
+    close(): Promise<void>;
+}
+export declare class McpHttpClient implements McpClientInterface {
+    private server;
+    private url;
+    private headers;
+    private nextRequestId;
+    constructor(server: ResolvedMcpServer);
+    connect(): Promise<void>;
+    private sendRequest;
+    listTools(): Promise<McpToolSchema[]>;
+    callTool(name: string, args: Record<string, any>): Promise<{
+        output: string;
+        isError?: boolean;
+    }>;
+    close(): Promise<void>;
+}