musonda 1.0.0

package/dist/tools/builtin/memoryTools.js

@@ -0,0 +1,123 @@
+export const memoryStoreTool = {
+    name: 'memory_store',
+    description: 'Store an important fact, personal preference, goal, or piece of knowledge about the user or project into Musonda long-term persistent memory.',
+    parameters: {
+        type: 'object',
+        properties: {
+            content: {
+                type: 'string',
+                description: 'The fact, insight, or preference to remember for future conversations.',
+            },
+            category: {
+                type: 'string',
+                enum: ['fact', 'preference', 'project', 'goal', 'note', 'general'],
+                description: 'The category of the memory.',
+            },
+            tags: {
+                type: 'string',
+                description: 'Comma-separated list of keywords or tags for quick search, e.g. "python, coding, preference".',
+            },
+        },
+        required: ['content'],
+    },
+    execute: async (args, context) => {
+        const category = args.category || 'general';
+        const tags = args.tags ? args.tags.split(',').map((t) => t.trim()) : [];
+        const item = context.memory.addMemory(args.content, category, tags);
+        return {
+            success: true,
+            message: `Successfully remembered [${category}]: "${args.content}"`,
+            memoryId: item.id,
+        };
+    },
+};
+export const memoryRecallTool = {
+    name: 'memory_recall',
+    description: 'Search Musonda persistent long-term memory for facts, preferences, past topics, or user details matching a query.',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search query or keywords to look up in persistent memory.',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of memories to return (default 5).',
+            },
+        },
+        required: ['query'],
+    },
+    execute: async (args, context) => {
+        const limit = args.limit || 5;
+        const items = context.memory.searchMemories(args.query, limit);
+        if (!items.length) {
+            return {
+                found: 0,
+                memories: [],
+                message: `No memories found matching "${args.query}".`,
+            };
+        }
+        return {
+            found: items.length,
+            memories: items.map((m) => ({
+                id: m.id,
+                category: m.category,
+                content: m.content,
+                tags: m.tags,
+                savedAt: m.createdAt,
+            })),
+        };
+    },
+};
+export const updateUserProfileTool = {
+    name: 'update_user_profile',
+    description: 'Update the structured profile details about the user, such as their name, profession/bio, interests, or communication preferences.',
+    parameters: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'User preferred name.',
+            },
+            bio: {
+                type: 'string',
+                description: 'Short summary of the user, their role, and background.',
+            },
+            interests: {
+                type: 'string',
+                description: 'Comma-separated list of user interests, hobbies, or domains.',
+            },
+            communicationStyle: {
+                type: 'string',
+                enum: ['concise', 'detailed', 'friendly', 'technical'],
+                description: 'Preferred conversational tone and response style.',
+            },
+            notes: {
+                type: 'string',
+                description: 'Special instructions or persistent notes regarding how the user likes to work.',
+            },
+        },
+    },
+    execute: async (args, context) => {
+        const updates = {};
+        if (args.name)
+            updates.name = args.name;
+        if (args.bio)
+            updates.bio = args.bio;
+        if (args.communicationStyle)
+            updates.communicationStyle = args.communicationStyle;
+        if (args.notes)
+            updates.notes = args.notes;
+        if (args.interests) {
+            updates.interests = args.interests.split(',').map((s) => s.trim());
+        }
+        const updated = context.memory.updateProfile(updates);
+        return {
+            success: true,
+            message: 'User profile updated successfully.',
+            profile: updated,
+        };
+    },
+};
+//# sourceMappingURL=memoryTools.js.map

package/dist/tools/builtin/memoryTools.js.map

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

package/dist/tools/builtin/noteTools.d.ts

@@ -0,0 +1,4 @@
+import { ToolDefinition } from '../types.js';
+export declare const noteSaveTool: ToolDefinition;
+export declare const noteReadTool: ToolDefinition;
+export declare const noteListTool: ToolDefinition;

package/dist/tools/builtin/noteTools.js

@@ -0,0 +1,91 @@
+import path from 'node:path';
+import fs from 'node:fs';
+function getNotesDir(dataDir) {
+    const dir = path.join(dataDir, 'notes');
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+export const noteSaveTool = {
+    name: 'note_save',
+    description: 'Save or update a personal note, draft, or document for the user.',
+    parameters: {
+        type: 'object',
+        properties: {
+            title: {
+                type: 'string',
+                description: 'The title/name of the note (alphanumeric, hyphens, underscores).',
+            },
+            content: {
+                type: 'string',
+                description: 'The full text or markdown content of the note.',
+            },
+        },
+        required: ['title', 'content'],
+    },
+    execute: async (args, context) => {
+        const safeTitle = args.title.replace(/[^a-zA-Z0-9_-]/g, '_').toLowerCase();
+        const notesDir = getNotesDir(context.config.memory.storageDir);
+        const filePath = path.join(notesDir, `${safeTitle}.md`);
+        fs.writeFileSync(filePath, args.content, 'utf-8');
+        return {
+            success: true,
+            title: args.title,
+            savedPath: filePath,
+            bytes: Buffer.byteLength(args.content, 'utf-8'),
+        };
+    },
+};
+export const noteReadTool = {
+    name: 'note_read',
+    description: 'Read the content of an existing personal note by title.',
+    parameters: {
+        type: 'object',
+        properties: {
+            title: {
+                type: 'string',
+                description: 'The title or filename of the note to read.',
+            },
+        },
+        required: ['title'],
+    },
+    execute: async (args, context) => {
+        const safeTitle = args.title.replace(/[^a-zA-Z0-9_-]/g, '_').toLowerCase();
+        const notesDir = getNotesDir(context.config.memory.storageDir);
+        const filePath = path.join(notesDir, `${safeTitle}.md`);
+        if (!fs.existsSync(filePath)) {
+            return { error: `Note "${args.title}" does not exist.` };
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return {
+            title: args.title,
+            content,
+        };
+    },
+};
+export const noteListTool = {
+    name: 'note_list',
+    description: 'List all existing saved notes for the user.',
+    parameters: {
+        type: 'object',
+        properties: {},
+    },
+    execute: async (_args, context) => {
+        const notesDir = getNotesDir(context.config.memory.storageDir);
+        const files = fs.readdirSync(notesDir).filter((f) => f.endsWith('.md'));
+        const notes = files.map((file) => {
+            const stats = fs.statSync(path.join(notesDir, file));
+            return {
+                title: file.replace(/\.md$/, ''),
+                sizeBytes: stats.size,
+                modifiedAt: stats.mtime.toISOString(),
+            };
+        });
+        return {
+            total: notes.length,
+            notes,
+        };
+    },
+};
+//# sourceMappingURL=noteTools.js.map

package/dist/tools/builtin/noteTools.js.map

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

package/dist/tools/builtin/pluginTools.d.ts

@@ -0,0 +1,29 @@
+import { ToolDefinition } from '../types.js';
+/**
+ * Tool for creating and instantly loading a new Agent Plugin into the live runtime.
+ */
+export declare const pluginCreateTool: ToolDefinition;
+/**
+ * Tool for reloading plugins from disk into the live gateway runtime.
+ */
+export declare const pluginReloadTool: ToolDefinition;
+/**
+ * Tool for listing all currently loaded plugins and their capabilities in the runtime.
+ */
+export declare const pluginListTool: ToolDefinition;
+/**
+ * Tool for installing an Agent Plugin from a local path, Git repo, or npm package into the live runtime.
+ */
+export declare const pluginInstallTool: ToolDefinition;
+/**
+ * Tool for safely removing and uninstalling an Agent Plugin from live runtime and disk.
+ */
+export declare const pluginRemoveTool: ToolDefinition;
+/**
+ * Tool for finding and searching Agent Plugins locally and across the ecosystem.
+ */
+export declare const pluginFindTool: ToolDefinition;
+/**
+ * Tool for inspecting detailed plugin manifest metadata, skills, and MCP configuration.
+ */
+export declare const pluginInfoTool: ToolDefinition;

package/dist/tools/builtin/pluginTools.js

@@ -0,0 +1,406 @@
+/**
+ * Tool for creating and instantly loading a new Agent Plugin into the live runtime.
+ */
+export const pluginCreateTool = {
+    name: 'plugin_create',
+    description: 'Creates and installs a new Agent Plugin with a valid manifest (plugin.json), optional skills (SKILL.md), and optional MCP server configuration, then immediately activates it in the live Musonda Gateway runtime without requiring a server restart.',
+    parameters: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Plugin identifier name (lowercase alphanumeric with single hyphens, 1-64 chars, e.g. "github-tools", "weather-service").',
+            },
+            description: {
+                type: 'string',
+                description: 'Clear description of what capabilities and skills the plugin provides.',
+            },
+            version: {
+                type: 'string',
+                description: 'Semantic version of the plugin (default: "1.0.0").',
+            },
+            skills: {
+                type: 'array',
+                description: 'Optional list of Agent Skills to scaffold inside the plugin package.',
+                items: {
+                    type: 'object',
+                },
+            },
+            mcp: {
+                type: 'object',
+                description: 'Optional Model Context Protocol (MCP) server definitions with stdio or http commands.',
+            },
+            targetDir: {
+                type: 'string',
+                description: 'Optional custom target directory (defaults to "./plugins/<name>").',
+            },
+        },
+        required: ['name', 'description'],
+    },
+    execute: async (args, context) => {
+        if (!context.pluginManager || !context.toolRegistry) {
+            return {
+                error: 'Plugin subsystem is not available in the current execution context.',
+            };
+        }
+        const { name, description, version, skills, mcp, targetDir } = args;
+        if (!name || typeof name !== 'string') {
+            return { error: 'Missing or invalid "name" parameter.' };
+        }
+        if (!description || typeof description !== 'string') {
+            return { error: 'Missing or invalid "description" parameter.' };
+        }
+        const result = await context.pluginManager.createAndLoadPlugin({
+            name,
+            description,
+            version: version || '1.0.0',
+            skills,
+            mcp,
+            targetDir,
+        }, context.toolRegistry);
+        if (!result.success) {
+            return {
+                success: false,
+                error: result.error || 'Unknown error occurred during plugin creation.',
+            };
+        }
+        return {
+            success: true,
+            message: `Plugin "${name}" created and loaded into Musonda runtime successfully!`,
+            plugin: {
+                name: result.plugin?.name,
+                rootDir: result.plugin?.rootDir,
+                dataDir: result.plugin?.dataDir,
+                version: result.plugin?.manifest.version,
+            },
+            skillsLoaded: result.skillsLoaded,
+            toolsRegistered: result.toolsRegistered,
+        };
+    },
+};
+/**
+ * Tool for reloading plugins from disk into the live gateway runtime.
+ */
+export const pluginReloadTool = {
+    name: 'plugin_reload',
+    description: 'Reloads plugins from disk into the live Musonda Gateway runtime without restarting the server. Can reload a specific plugin by name or all configured plugins.',
+    parameters: {
+        type: 'object',
+        properties: {
+            pluginName: {
+                type: 'string',
+                description: 'Name of the specific plugin to reload. If omitted or set to "all", all plugins are re-scanned and reloaded.',
+            },
+        },
+    },
+    execute: async (args, context) => {
+        if (!context.pluginManager || !context.toolRegistry) {
+            return {
+                error: 'Plugin subsystem is not available in the current execution context.',
+            };
+        }
+        const pluginName = args.pluginName?.trim();
+        if (pluginName && pluginName.toLowerCase() !== 'all') {
+            const reloaded = await context.pluginManager.reloadPlugin(pluginName, context.toolRegistry);
+            if (!reloaded) {
+                return {
+                    success: false,
+                    error: `Could not reload plugin "${pluginName}". Ensure the directory and valid plugin.json exist.`,
+                };
+            }
+            const pluginSkills = context.pluginManager
+                .getAllSkills()
+                .filter((s) => s.pluginName === pluginName);
+            const activeMcpServers = context.pluginManager
+                .getMcpBridge()
+                .getActiveServers()
+                .filter((s) => s.server.pluginName === pluginName);
+            const tools = activeMcpServers.flatMap((s) => s.tools.map((t) => t.name));
+            return {
+                success: true,
+                message: `Plugin "${pluginName}" reloaded successfully!`,
+                plugin: {
+                    name: reloaded.name,
+                    rootDir: reloaded.rootDir,
+                    version: reloaded.manifest.version,
+                },
+                skills: pluginSkills.map((s) => s.name),
+                tools,
+            };
+        }
+        const summary = await context.pluginManager.reloadAll(context.toolRegistry);
+        return {
+            success: true,
+            message: `All plugins reloaded into runtime.`,
+            pluginsLoaded: summary.loaded,
+            skillsLoaded: summary.skills,
+            mcpServersConnected: summary.mcpServers,
+        };
+    },
+};
+/**
+ * Tool for listing all currently loaded plugins and their capabilities in the runtime.
+ */
+export const pluginListTool = {
+    name: 'plugin_list',
+    description: 'Lists all currently loaded Agent Plugins in the Musonda Gateway runtime, including their versions, directory paths, skills, and active MCP servers and tools.',
+    parameters: {
+        type: 'object',
+        properties: {},
+    },
+    execute: async (_args, context) => {
+        if (!context.pluginManager) {
+            return {
+                error: 'Plugin subsystem is not available in the current execution context.',
+            };
+        }
+        const plugins = context.pluginManager.getAllPlugins();
+        const skills = context.pluginManager.getAllSkills();
+        const mcpServers = context.pluginManager.getMcpBridge().getActiveServers();
+        return {
+            totalPlugins: plugins.length,
+            totalSkills: skills.length,
+            totalMcpServers: mcpServers.length,
+            plugins: plugins.map((p) => {
+                const pluginSkills = skills
+                    .filter((s) => s.pluginName === p.name)
+                    .map((s) => ({
+                    name: s.name,
+                    description: s.description,
+                }));
+                const servers = mcpServers
+                    .filter((s) => s.server.pluginName === p.name)
+                    .map((s) => ({
+                    name: s.server.name,
+                    type: s.server.config.type,
+                    tools: s.tools.map((t) => t.name),
+                }));
+                return {
+                    name: p.name,
+                    version: p.manifest.version || '1.0.0',
+                    description: p.manifest.description || '',
+                    rootDir: p.rootDir,
+                    dataDir: p.dataDir,
+                    skills: pluginSkills,
+                    mcpServers: servers,
+                };
+            }),
+        };
+    },
+};
+/**
+ * Tool for installing an Agent Plugin from a local path, Git repo, or npm package into the live runtime.
+ */
+export const pluginInstallTool = {
+    name: 'plugin_install',
+    description: 'Installs and instantly activates an Agent Plugin from a local directory path, Git repository URL (e.g. GitHub URL or "owner/repo" shorthand), or package into the live Musonda Gateway runtime without restarting the server. Validates conformance with the Agent Plugins 1.0.0 standard (https://agent-plugins.org), installs dependencies if needed, and registers skills and MCP tools.',
+    parameters: {
+        type: 'object',
+        properties: {
+            source: {
+                type: 'string',
+                description: 'Source location: local directory path (e.g. "./my-plugin"), Git repository URL (e.g. "https://github.com/agentplugins/agent-plugins-example.git"), or GitHub shorthand (e.g. "agentplugins/agent-plugins-example").',
+            },
+            name: {
+                type: 'string',
+                description: 'Optional custom name for the installed plugin package.',
+            },
+            installDependencies: {
+                type: 'boolean',
+                description: 'Whether to automatically install production dependencies via npm if package.json is present (default: true).',
+            },
+            targetDir: {
+                type: 'string',
+                description: 'Optional custom installation directory path.',
+            },
+        },
+        required: ['source'],
+    },
+    execute: async (args, context) => {
+        if (!context.pluginManager || !context.toolRegistry) {
+            return {
+                error: 'Plugin subsystem is not available in the current execution context.',
+            };
+        }
+        const { source, name, installDependencies, targetDir } = args;
+        if (!source || typeof source !== 'string') {
+            return { error: 'Missing or invalid "source" parameter.' };
+        }
+        const result = await context.pluginManager.installPlugin({
+            source,
+            name,
+            installDependencies: installDependencies !== false,
+            targetDir,
+        }, context.toolRegistry);
+        if (!result.success) {
+            return {
+                success: false,
+                error: result.error || 'Unknown error occurred during plugin installation.',
+            };
+        }
+        return {
+            success: true,
+            message: `Plugin "${result.plugin?.name}" installed and activated in Musonda Gateway runtime successfully!`,
+            plugin: {
+                name: result.plugin?.name,
+                rootDir: result.plugin?.rootDir,
+                dataDir: result.plugin?.dataDir,
+                version: result.plugin?.manifest.version,
+            },
+            skillsLoaded: result.skillsLoaded,
+            toolsRegistered: result.toolsRegistered,
+            installedPath: result.installedPath,
+        };
+    },
+};
+/**
+ * Tool for safely removing and uninstalling an Agent Plugin from live runtime and disk.
+ */
+export const pluginRemoveTool = {
+    name: 'plugin_remove',
+    description: 'Unloads and removes an Agent Plugin from the live Musonda Gateway runtime without restarting the server. Gracefully terminates its active MCP subprocesses, deregisters bridged MCP tools, removes its skills, and deletes its files from disk (with optional purge of persistent data).',
+    parameters: {
+        type: 'object',
+        properties: {
+            pluginName: {
+                type: 'string',
+                description: 'Name of the plugin to remove and unload.',
+            },
+            deleteFiles: {
+                type: 'boolean',
+                description: 'Whether to delete the plugin package files from disk (default: true). Set false to only unload from runtime.',
+            },
+            purgeData: {
+                type: 'boolean',
+                description: 'Whether to also delete the persistent data directory (PLUGIN_DATA) in data/plugin_data/<name> (default: false).',
+            },
+        },
+        required: ['pluginName'],
+    },
+    execute: async (args, context) => {
+        if (!context.pluginManager || !context.toolRegistry) {
+            return {
+                error: 'Plugin subsystem is not available in the current execution context.',
+            };
+        }
+        const { pluginName, deleteFiles, purgeData } = args;
+        if (!pluginName || typeof pluginName !== 'string') {
+            return { error: 'Missing or invalid "pluginName" parameter.' };
+        }
+        const result = await context.pluginManager.removePlugin({
+            pluginName,
+            deleteFiles: deleteFiles !== false,
+            purgeData: purgeData === true,
+        }, context.toolRegistry);
+        if (!result.success) {
+            return {
+                success: false,
+                error: result.error || `Could not remove plugin "${pluginName}".`,
+            };
+        }
+        return {
+            success: true,
+            message: `Plugin "${pluginName}" removed successfully from Musonda runtime!`,
+            pluginName: result.pluginName,
+            unloadedFromRuntime: result.unloaded,
+            deletedFilesFromDisk: result.deletedFiles,
+            purgedDataDirectory: result.purgedData,
+            skillsRemoved: result.skillsRemoved,
+            toolsUnregistered: result.toolsUnregistered,
+        };
+    },
+};
+/**
+ * Tool for finding and searching Agent Plugins locally and across the ecosystem.
+ */
+export const pluginFindTool = {
+    name: 'plugin_find',
+    description: 'Searches and discovers Agent Plugins locally on disk and across the ecosystem (including official agent-plugins.org repositories, GitHub topic "agent-plugin", and npm). Use this to find plugins that provide specific skills, integrations, or MCP tools.',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Keywords, topics, or capabilities to search for (e.g. "calculator", "github", "database", "weather", "search").',
+            },
+            source: {
+                type: 'string',
+                description: 'Search scope: "all" (default: local and remote), "local" (only on disk), or "remote" (ecosystem repositories).',
+                enum: ['all', 'local', 'remote'],
+            },
+        },
+    },
+    execute: async (args, context) => {
+        if (!context.pluginManager) {
+            return {
+                error: 'Plugin subsystem is not available in the current execution context.',
+            };
+        }
+        const { query, source } = args;
+        const result = await context.pluginManager.findPlugins({
+            query,
+            source: source || 'all',
+        });
+        return {
+            success: true,
+            query: result.query,
+            totalFound: result.totalFound,
+            localPlugins: result.local,
+            remotePlugins: result.remote,
+            help: 'To install any plugin, use "plugin_install" with its repository URL or local path. To learn how to create your own, inspect "plugin_create" or read the create-plugin skill.',
+        };
+    },
+};
+/**
+ * Tool for inspecting detailed plugin manifest metadata, skills, and MCP configuration.
+ */
+export const pluginInfoTool = {
+    name: 'plugin_info',
+    description: 'Inspects detailed metadata, manifest configuration, discovered skills (with instructions summary), and MCP servers for a specific Agent Plugin (either active in runtime or located on disk).',
+    parameters: {
+        type: 'object',
+        properties: {
+            pluginName: {
+                type: 'string',
+                description: 'Name or directory path of the plugin to inspect.',
+            },
+        },
+        required: ['pluginName'],
+    },
+    execute: async (args, context) => {
+        if (!context.pluginManager) {
+            return {
+                error: 'Plugin subsystem is not available in the current execution context.',
+            };
+        }
+        const pluginName = args.pluginName?.trim();
+        if (!pluginName) {
+            return { error: 'Missing or invalid "pluginName" parameter.' };
+        }
+        const info = context.pluginManager.getPluginInfo(pluginName);
+        if (!info.found) {
+            return {
+                success: false,
+                error: info.error || `Plugin "${pluginName}" could not be found.`,
+            };
+        }
+        return {
+            success: true,
+            name: info.manifest?.name || pluginName,
+            isLoaded: info.isLoaded,
+            version: info.manifest?.version || '1.0.0',
+            description: info.manifest?.description || '',
+            author: info.manifest?.author,
+            license: info.manifest?.license,
+            homepage: info.manifest?.homepage,
+            repository: info.manifest?.repository,
+            keywords: info.manifest?.keywords || [],
+            rootDir: info.rootDir,
+            dataDir: info.dataDir,
+            skills: info.skills,
+            mcpServers: info.mcpServers,
+            activeTools: info.activeTools || [],
+        };
+    },
+};
+//# sourceMappingURL=pluginTools.js.map