musonda 1.0.0

package/dist/agent/harness.js

@@ -0,0 +1,215 @@
+import { SystemPromptBuilder } from './systemPrompt.js';
+import { logger } from '../utils/logger.js';
+export class AgentHarness {
+    config;
+    memory;
+    tools;
+    client;
+    maxToolIterations = 8;
+    scheduler;
+    pluginManager;
+    constructor(config, memory, tools, client, scheduler, pluginManager) {
+        this.config = config;
+        this.memory = memory;
+        this.tools = tools;
+        this.client = client;
+        this.scheduler = scheduler;
+        this.pluginManager = pluginManager;
+    }
+    setScheduler(scheduler) {
+        this.scheduler = scheduler;
+    }
+    getScheduler() {
+        return this.scheduler;
+    }
+    setPluginManager(pluginManager) {
+        this.pluginManager = pluginManager;
+    }
+    getPluginManager() {
+        return this.pluginManager;
+    }
+    getMemoryManager() {
+        return this.memory;
+    }
+    getToolRegistry() {
+        return this.tools;
+    }
+    getClient() {
+        return this.client;
+    }
+    formatToolStatus(name) {
+        const lower = name.toLowerCase();
+        if (lower.includes('search') || lower.includes('google') || lower.includes('bing')) {
+            return 'Searching the web…';
+        }
+        return `Running \`${name}\`…`;
+    }
+    formatToolReviewStatus(name, output) {
+        const lower = name.toLowerCase();
+        if (lower.includes('search')) {
+            try {
+                const parsed = JSON.parse(output);
+                if (Array.isArray(parsed)) {
+                    return `Reviewing ${parsed.length} results…`;
+                }
+                if (parsed && Array.isArray(parsed.results)) {
+                    return `Reviewing ${parsed.results.length} results…`;
+                }
+            }
+            catch { }
+            return 'Reviewing results…';
+        }
+        return null;
+    }
+    async processMessage(input) {
+        const { sessionId, channel, channelId, userId, userName, threadTs, messageText, scheduler } = input;
+        const activeScheduler = scheduler || this.scheduler;
+        const assistantName = this.config.assistant.customName || this.config.assistant.name || 'Musonda';
+        logger.agent(`Processing message from ${userName || userId} on [${channel}]: "${messageText.substring(0, 60)}${messageText.length > 60 ? '...' : ''}"`);
+        const emitEvent = async (event) => {
+            if (input.onEvent) {
+                try {
+                    await input.onEvent(event);
+                }
+                catch (cbErr) {
+                    logger.debug('Error in onEvent callback:', cbErr);
+                }
+            }
+            if (event.type === 'output.delta' && input.onStreamDelta) {
+                try {
+                    await input.onStreamDelta(event.text);
+                }
+                catch (cbErr) {
+                    logger.debug('Error in onStreamDelta callback:', cbErr);
+                }
+            }
+        };
+        try {
+            await emitEvent({ type: 'run.started' });
+            await emitEvent({ type: 'status', text: 'Thinking…' });
+            // 1. Fetch user profile
+            const profile = this.memory.getProfile();
+            // 2. Auto-recall relevant long-term memories based on the user's message
+            const recalledMemories = this.memory.searchMemories(messageText, this.config.memory.autoRecallTopK);
+            if (recalledMemories.length > 0) {
+                logger.memory(`Auto-recalled ${recalledMemories.length} relevant memories for query`);
+            }
+            // 3. Build dynamic system prompt
+            const availableSkills = this.pluginManager?.getAllSkills ? this.pluginManager.getAllSkills() : [];
+            const instructions = SystemPromptBuilder.build(this.config, profile, recalledMemories, { channel, userName: userName || profile.name }, availableSkills);
+            // 4. Retrieve recent short-term session messages
+            const recentHistory = this.memory.getRecentSessionMessages(sessionId, this.config.memory.maxShortTermHistory);
+            // 5. Construct input items for OpenAI Responses API
+            const inputItems = [];
+            // Add recent conversation history as easy input messages
+            for (const msg of recentHistory) {
+                if (msg.role === 'user' || msg.role === 'assistant') {
+                    inputItems.push({
+                        role: msg.role,
+                        content: msg.content,
+                        type: 'message',
+                    });
+                }
+            }
+            // Add current user message
+            inputItems.push({
+                role: 'user',
+                content: messageText,
+                type: 'message',
+            });
+            // Record user message in session memory
+            this.memory.appendSessionMessage(sessionId, {
+                role: 'user',
+                content: messageText,
+            }, channel, userId, userName);
+            // 6. Multi-turn Agent Reasoning & Tool Loop
+            const openAiTools = this.tools.getOpenAITools();
+            let totalToolCalls = 0;
+            let finalReplyText = '';
+            let iterations = 0;
+            while (iterations < this.maxToolIterations) {
+                iterations++;
+                await emitEvent({ type: 'status', text: 'Thinking…' });
+                const modelResponse = await this.client.generate({
+                    instructions,
+                    input: inputItems,
+                    tools: openAiTools,
+                    onDelta: async (delta) => {
+                        await emitEvent({ type: 'output.delta', text: delta });
+                    },
+                    onReasoningSummaryDelta: async (delta) => {
+                        await emitEvent({ type: 'reasoning.summary.delta', text: delta });
+                    },
+                });
+                if (modelResponse.text) {
+                    finalReplyText = modelResponse.text;
+                }
+                // If no tool calls were requested, we are done
+                if (!modelResponse.toolCalls || modelResponse.toolCalls.length === 0) {
+                    break;
+                }
+                // Execute tool calls
+                totalToolCalls += modelResponse.toolCalls.length;
+                logger.agent(`Executing ${modelResponse.toolCalls.length} tool call(s) in turn ${iterations}`);
+                for (const call of modelResponse.toolCalls) {
+                    // Append model's tool call to input items
+                    inputItems.push({
+                        type: 'function_call',
+                        call_id: call.callId,
+                        name: call.name,
+                        arguments: call.arguments,
+                    });
+                    const toolStatus = this.formatToolStatus(call.name);
+                    await emitEvent({ type: 'status', text: toolStatus });
+                    await emitEvent({ type: 'tool.started', name: call.name });
+                    // Execute tool with context
+                    const execResult = await this.tools.executeTool(call.name, call.arguments, {
+                        sessionId,
+                        channel,
+                        channelId,
+                        userId,
+                        userName,
+                        threadTs,
+                        memory: this.memory,
+                        config: this.config,
+                        scheduler: activeScheduler,
+                        pluginManager: this.pluginManager,
+                        toolRegistry: this.tools,
+                    });
+                    await emitEvent({ type: 'tool.completed', name: call.name });
+                    const reviewStatus = this.formatToolReviewStatus(call.name, execResult.output);
+                    if (reviewStatus) {
+                        await emitEvent({ type: 'status', text: reviewStatus });
+                    }
+                    // Append tool output item to input items
+                    inputItems.push({
+                        type: 'function_call_output',
+                        call_id: call.callId,
+                        output: execResult.output,
+                    });
+                }
+            }
+            // Fallback if no text was produced
+            if (!finalReplyText.trim()) {
+                finalReplyText = `I have completed processing your request with ${totalToolCalls} action(s).`;
+            }
+            // Record assistant's reply in short-term session memory
+            this.memory.appendSessionMessage(sessionId, {
+                role: 'assistant',
+                content: finalReplyText,
+            }, channel, userId, userName);
+            await emitEvent({ type: 'run.completed', text: finalReplyText });
+            logger.agent(`Replied with ${finalReplyText.length} characters (tools used: ${totalToolCalls})`);
+            return {
+                replyText: finalReplyText,
+                toolCallsCount: totalToolCalls,
+                sessionId,
+            };
+        }
+        catch (err) {
+            await emitEvent({ type: 'run.failed', message: err.message || 'Run failed' });
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=harness.js.map

package/dist/agent/harness.js.map

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

package/dist/agent/openaiResponsesClient.d.ts

@@ -0,0 +1,35 @@
+import { ModelConfig } from '../config/types.js';
+import { OpenAIFunctionToolSchema } from '../tools/types.js';
+export interface ExtractedToolCall {
+    callId: string;
+    name: string;
+    arguments: string;
+}
+export interface ModelResponseResult {
+    text: string;
+    toolCalls: ExtractedToolCall[];
+    rawOutput: any[];
+}
+export declare class OpenAIResponsesClient {
+    private client;
+    private model;
+    private temperature?;
+    private maxOutputTokens;
+    private readinessCache;
+    private reasoningEffort?;
+    constructor(config: ModelConfig);
+    getModelName(): string;
+    /** Verify that the configured credential can access the configured model. */
+    checkReadiness(cacheMs?: number): Promise<{
+        ready: boolean;
+        reason?: string;
+    }>;
+    private supportsTemperature;
+    generate(params: {
+        instructions: string;
+        input: any[];
+        tools?: OpenAIFunctionToolSchema[];
+        onDelta?: (delta: string) => void | Promise<void>;
+        onReasoningSummaryDelta?: (delta: string) => void | Promise<void>;
+    }): Promise<ModelResponseResult>;
+}

package/dist/agent/openaiResponsesClient.js

@@ -0,0 +1,250 @@
+import OpenAI from 'openai';
+import { logger } from '../utils/logger.js';
+export class OpenAIResponsesClient {
+    client;
+    model;
+    temperature;
+    maxOutputTokens;
+    readinessCache = null;
+    reasoningEffort;
+    constructor(config) {
+        this.model = config.model || 'gpt-5.6-luna';
+        this.temperature = config.temperature;
+        this.maxOutputTokens = config.maxOutputTokens ?? 4096;
+        this.reasoningEffort = config.reasoningEffort;
+        this.client = new OpenAI({
+            apiKey: config.apiKey,
+            baseURL: config.baseUrl || undefined,
+        });
+    }
+    getModelName() {
+        return this.model;
+    }
+    /** Verify that the configured credential can access the configured model. */
+    async checkReadiness(cacheMs = 30000) {
+        const now = Date.now();
+        if (this.readinessCache && now - this.readinessCache.checkedAt < cacheMs) {
+            return { ready: this.readinessCache.ready, reason: this.readinessCache.reason };
+        }
+        try {
+            await this.client.models.retrieve(this.model, { timeout: 4000, maxRetries: 0 });
+            this.readinessCache = { checkedAt: now, ready: true };
+        }
+        catch (err) {
+            const reason = err?.status === 401 || err?.status === 403
+                ? 'credentials_rejected'
+                : err?.status === 404
+                    ? 'model_unavailable'
+                    : 'provider_unreachable';
+            this.readinessCache = { checkedAt: now, ready: false, reason };
+        }
+        return { ready: this.readinessCache.ready, reason: this.readinessCache.reason };
+    }
+    supportsTemperature(model) {
+        const m = model.toLowerCase();
+        // gpt-5.6 family and reasoning models (o1, o3, o4) do not support temperature in Responses API
+        if (m.startsWith('gpt-5.6'))
+            return false;
+        if (m.startsWith('o1') || m.startsWith('o3') || m.startsWith('o4'))
+            return false;
+        return true;
+    }
+    async generate(params) {
+        logger.debug(`Calling OpenAI Responses API with model "${this.model}", ${params.input.length} input items...`);
+        const requestPayload = {
+            model: this.model,
+            instructions: params.instructions,
+            input: params.input,
+            max_output_tokens: this.maxOutputTokens,
+        };
+        if (this.reasoningEffort) {
+            requestPayload.reasoning = {
+                effort: this.reasoningEffort,
+                summary: 'auto',
+            };
+        }
+        if (this.temperature !== undefined && this.supportsTemperature(this.model)) {
+            requestPayload.temperature = this.temperature;
+        }
+        if (params.tools && params.tools.length > 0) {
+            requestPayload.tools = params.tools;
+        }
+        if (params.onDelta || params.onReasoningSummaryDelta) {
+            let stream;
+            try {
+                stream = await this.client.responses.create({
+                    ...requestPayload,
+                    stream: true,
+                });
+            }
+            catch (err) {
+                const isTempError = err?.status === 400 &&
+                    (err?.message?.includes('temperature') || err?.param === 'temperature' || err?.error?.param === 'temperature');
+                const isReasoningError = err?.status === 400 &&
+                    (err?.message?.includes('reasoning') || err?.param === 'reasoning' || err?.error?.param === 'reasoning');
+                if (isTempError && requestPayload.temperature !== undefined) {
+                    logger.debug(`Model "${this.model}" does not support temperature parameter. Retrying without temperature...`);
+                    delete requestPayload.temperature;
+                    stream = await this.client.responses.create({
+                        ...requestPayload,
+                        stream: true,
+                    });
+                }
+                else if (isReasoningError && requestPayload.reasoning !== undefined) {
+                    logger.debug(`Model "${this.model}" does not support reasoning parameter. Retrying without reasoning...`);
+                    delete requestPayload.reasoning;
+                    stream = await this.client.responses.create({
+                        ...requestPayload,
+                        stream: true,
+                    });
+                }
+                else {
+                    logger.error(`OpenAI Responses API error (${this.model}):`, err.message || err);
+                    if (err.status === 401 || (err.message && err.message.includes('API key'))) {
+                        throw new Error(`OpenAI Authentication Error: Your API key is invalid or not provided. Run 'npm run onboard' to configure a valid API key.`);
+                    }
+                    throw err;
+                }
+            }
+            let accumulatedText = '';
+            let completedResponse = null;
+            for await (const event of stream) {
+                if (event.type === 'response.output_text.delta') {
+                    const delta = event.delta || '';
+                    if (delta) {
+                        accumulatedText += delta;
+                        if (params.onDelta) {
+                            try {
+                                await params.onDelta(delta);
+                            }
+                            catch (cbErr) {
+                                logger.debug('Error in onDelta streaming callback:', cbErr);
+                            }
+                        }
+                    }
+                }
+                else if (event.type === 'response.reasoning_summary_text.delta') {
+                    const delta = event.delta || '';
+                    if (delta && params.onReasoningSummaryDelta) {
+                        try {
+                            await params.onReasoningSummaryDelta(delta);
+                        }
+                        catch (cbErr) {
+                            logger.debug('Error in onReasoningSummaryDelta streaming callback:', cbErr);
+                        }
+                    }
+                }
+                else if (event.type === 'response.completed') {
+                    completedResponse = event.response;
+                }
+            }
+            const toolCalls = [];
+            let text = accumulatedText;
+            if (completedResponse) {
+                if (typeof completedResponse.output_text === 'string' && completedResponse.output_text.trim()) {
+                    text = completedResponse.output_text;
+                }
+                if (Array.isArray(completedResponse.output)) {
+                    for (const item of completedResponse.output) {
+                        if (item.type === 'message') {
+                            const msgItem = item;
+                            if (Array.isArray(msgItem.content)) {
+                                for (const c of msgItem.content) {
+                                    if (c.type === 'text' || c.type === 'output_text') {
+                                        if (!text.includes(c.text)) {
+                                            text += (text ? '\n' : '') + c.text;
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                        else if (item.type === 'function_call') {
+                            const call = item;
+                            toolCalls.push({
+                                callId: call.call_id || call.id || `call_${Date.now()}_${Math.random().toString(36).substring(2, 7)}`,
+                                name: call.name,
+                                arguments: typeof call.arguments === 'string' ? call.arguments : JSON.stringify(call.arguments || {}),
+                            });
+                        }
+                    }
+                }
+                return {
+                    text: text.trim(),
+                    toolCalls,
+                    rawOutput: completedResponse.output || [],
+                };
+            }
+            return {
+                text: accumulatedText.trim(),
+                toolCalls,
+                rawOutput: [],
+            };
+        }
+        let response;
+        try {
+            response = await this.client.responses.create(requestPayload);
+        }
+        catch (err) {
+            // Automatic recovery: if model rejected 'temperature' or 'reasoning', retry without it
+            const isTempError = err?.status === 400 &&
+                (err?.message?.includes('temperature') || err?.param === 'temperature' || err?.error?.param === 'temperature');
+            const isReasoningError = err?.status === 400 &&
+                (err?.message?.includes('reasoning') || err?.param === 'reasoning' || err?.error?.param === 'reasoning');
+            if (isTempError && requestPayload.temperature !== undefined) {
+                logger.debug(`Model "${this.model}" does not support temperature parameter. Retrying without temperature...`);
+                delete requestPayload.temperature;
+                response = await this.client.responses.create(requestPayload);
+            }
+            else if (isReasoningError && requestPayload.reasoning !== undefined) {
+                logger.debug(`Model "${this.model}" does not support reasoning parameter. Retrying without reasoning...`);
+                delete requestPayload.reasoning;
+                response = await this.client.responses.create(requestPayload);
+            }
+            else {
+                logger.error(`OpenAI Responses API error (${this.model}):`, err.message || err);
+                // Graceful diagnostic for invalid/missing API key
+                if (err.status === 401 || (err.message && err.message.includes('API key'))) {
+                    throw new Error(`OpenAI Authentication Error: Your API key is invalid or not provided. Run 'npm run onboard' to configure a valid API key.`);
+                }
+                throw err;
+            }
+        }
+        let text = '';
+        const toolCalls = [];
+        // If SDK populated output_text convenience property
+        if (typeof response.output_text === 'string' && response.output_text.trim()) {
+            text = response.output_text;
+        }
+        // Process output items
+        if (Array.isArray(response.output)) {
+            for (const item of response.output) {
+                if (item.type === 'message') {
+                    const msgItem = item;
+                    if (Array.isArray(msgItem.content)) {
+                        for (const c of msgItem.content) {
+                            if (c.type === 'text' || c.type === 'output_text') {
+                                if (!text.includes(c.text)) {
+                                    text += (text ? '\n' : '') + c.text;
+                                }
+                            }
+                        }
+                    }
+                }
+                else if (item.type === 'function_call') {
+                    const call = item;
+                    toolCalls.push({
+                        callId: call.call_id || call.id || `call_${Date.now()}_${Math.random().toString(36).substring(2, 7)}`,
+                        name: call.name,
+                        arguments: typeof call.arguments === 'string' ? call.arguments : JSON.stringify(call.arguments || {}),
+                    });
+                }
+            }
+        }
+        return {
+            text: text.trim(),
+            toolCalls,
+            rawOutput: response.output || [],
+        };
+    }
+}
+//# sourceMappingURL=openaiResponsesClient.js.map

package/dist/agent/openaiResponsesClient.js.map

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

package/dist/agent/systemPrompt.d.ts

@@ -0,0 +1,9 @@
+import { MusondaConfig } from '../config/types.js';
+import { UserMemoryProfile, MemoryItem } from '../memory/types.js';
+import { AgentSkill } from '../plugins/skills/types.js';
+export declare class SystemPromptBuilder {
+    static build(config: MusondaConfig, profile: UserMemoryProfile, recalledMemories: MemoryItem[] | undefined, contextInfo: {
+        channel: string;
+        userName?: string;
+    }, availableSkills?: AgentSkill[]): string;
+}

package/dist/agent/systemPrompt.js

@@ -0,0 +1,100 @@
+export class SystemPromptBuilder {
+    static build(config, profile, recalledMemories = [], contextInfo, availableSkills = []) {
+        const assistantName = profile.assistantCustomName || config.assistant.customName || config.assistant.name || 'Musonda';
+        const now = new Date();
+        const userTimezone = profile.timezone || 'UTC';
+        let formattedLocalTime;
+        try {
+            formattedLocalTime = new Intl.DateTimeFormat('en-US', {
+                timeZone: userTimezone,
+                dateStyle: 'full',
+                timeStyle: 'long',
+            }).format(now);
+        }
+        catch {
+            formattedLocalTime = now.toUTCString();
+        }
+        const memorySection = recalledMemories.length > 0
+            ? `\n## Relevant Recalled Memories from Past Interactions:\n${recalledMemories
+                .map((m, idx) => `${idx + 1}. [${m.category.toUpperCase()}] ${m.content} (tags: ${m.tags.join(', ')})`)
+                .join('\n')}\n`
+            : '';
+        const skillsSection = availableSkills && availableSkills.length > 0
+            ? `\n## Available Agent Skills:
+You have access to specialized Agent Skills installed via plugins. You can inspect all available skills with 'skill_list', read full instructions for any skill with 'skill_read', or run bundled skill scripts with 'skill_run_script'.
+${availableSkills.map((s, idx) => `${idx + 1}. **${s.name}** (from plugin "${s.pluginName}"): ${s.description}`).join('\n')}\n`
+            : '';
+        const profileBio = profile.bio ? `\n- User Background: ${profile.bio}` : '';
+        const profileInterests = profile.interests && profile.interests.length > 0
+            ? `\n- User Interests: ${profile.interests.join(', ')}`
+            : '';
+        const profileNotes = profile.notes ? `\n- User Notes: ${profile.notes}` : '';
+        return `You are ${assistantName}, a personal autonomous AI companion and agent harness.
+You are running continuously inside the Musonda Gateway, bridging the user through channels like Discord.
+
+## Core Identity & Persona:
+- Name: ${assistantName}
+- Role: ${config.assistant.title || 'Personal Autonomous AI Companion'}
+- Personality: ${config.assistant.tone || 'Empathetic, intelligent, proactive, practical, and highly capable'}
+- Running On: OpenAI Responses API using model "${config.model.model}" (efficiency & agentic tier)
+- Active Channel: ${contextInfo.channel.toUpperCase()}
+
+## User Profile:
+- User's Name: ${profile.name} (Address them respectfully and naturally)
+- Channel User Handle: ${contextInfo.userName || profile.name}
+- User Timezone: ${userTimezone}
+- Current Local Time: ${formattedLocalTime}${profileBio}${profileInterests}${profileNotes}
+- Communication Style: ${profile.communicationStyle}
+${memorySection}${skillsSection}
+## Operational Directives:
+1. Memory Awareness: You have persistent memory. When the user tells you about themselves, their projects, preferences, or important facts, use the 'memory_store' tool to persist it.
+2. Self-Correction & Learning: If the user corrects you or updates their preferences, update the profile using 'update_user_profile' or store a new memory item.
+3. Tool Usage:
+   - Use 'current_time' when timing, dates, or schedule planning matters.
+   - Use 'memory_recall' if you need to search past conversations or stored notes.
+   - Use 'calculate' for precise mathematical expressions.
+   - Use 'web_search' or 'web_fetch' when looking up recent information, links, or documentation.
+   - Use 'note_save', 'note_read', 'note_list' to manage personal notes, drafts, or task lists.
+   - Use 'skill_list' and 'skill_read' to inspect and load Agent Skills, and 'skill_run_script' to execute bundled skill scripts.
+   - Agent Plugins Ecosystem (v1.0.0 Standard: https://agent-plugins.org/):
+     You are an expert on portable Agent Plugins conforming to the Agent Plugins 1.0.0 specification (https://agent-plugins.org):
+     * Standard Architecture: A plugin package is a self-contained directory containing:
+       1. 'plugin.json': Canonical root manifest with "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name" (1-64 lowercase alphanumeric chars with single hyphens or dots, e.g. "acme-tools"), "version", "description", "author", "license", "keywords", and client "extensions".
+       2. 'skills/': Fixed directory for Agent Skills. Each immediate child directory contains a 'SKILL.md' file with YAML frontmatter (name matching directory, description) and instructions, plus optional 'scripts/' and 'references/'.
+       3. 'mcp.json': Fixed root MCP configuration with "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json" and "mcpServers" ('stdio', 'streamable-http', or 'sse'). Stdio subprocesses receive isolated environment variables 'PLUGIN_ROOT' and persistent writable 'PLUGIN_DATA', with \${PLUGIN_ROOT} and \${PLUGIN_DATA} placeholder expansions in args/env/cwd.
+     * Finding Plugins:
+       - Use 'plugin_find' to search for plugins both locally and across the ecosystem.
+       - Official & Ecosystem Catalogs: https://agent-plugins.org, GitHub organization 'agentplugins' (e.g. 'agentplugins/agent-plugins-example'), GitHub topic 'agent-plugin', and npm keyword 'agent-plugin'.
+       - Use 'web_search' or 'web_fetch' to research plugins, compatible clients, and specifications.
+     * Adding & Installing Plugins:
+       - Use 'plugin_install' to install plugins from a Git repo URL (e.g. 'https://github.com/agentplugins/agent-plugins-example.git', 'agentplugins/agent-plugins-example'), a local directory path, or an npm package. Musonda validates conformance, installs package dependencies, and immediately activates skills and MCP tools in live runtime without restarting the server.
+       - Use 'plugin_create' to scaffold custom plugins with valid manifests, skills, and MCP definitions.
+     * Inspecting & Using Plugins:
+       - Use 'plugin_list' to list all currently active plugins, skills, and MCP tools in the Gateway runtime.
+       - Use 'plugin_info' to inspect detailed manifest metadata, skill instruction summaries, and server configurations for any plugin.
+       - To use skills: inspect with 'skill_list', load instructions with 'skill_read', and run bundled scripts with 'skill_run_script'.
+       - To use MCP tools: invoke bridged MCP tools (prefixed with 'mcp_*') directly from your tool registry.
+     * Removing & Managing Plugins:
+       - Use 'plugin_remove' to unload and uninstall a plugin. It cleanly terminates active MCP subprocesses, deregisters bridged tools, removes skills, and deletes plugin files (with optional purge of persistent data).
+       - Use 'plugin_reload' to refresh plugins from disk without restarting the Gateway.
+   - Use MCP (Model Context Protocol) tools (named 'mcp_*') to interact with connected MCP server capabilities.
+   - Use File Tools to inspect and manipulate files in the user-permitted workspace:
+     * 'file_read' to read file contents or paginate line ranges.
+     * 'file_write' to create or overwrite files (parent directories auto-created).
+     * 'file_edit' to perform precise search-and-replace text edits.
+     * 'file_append' to append text to files.
+     * 'file_list' to browse directory trees.
+     * 'file_info' to inspect file/directory metadata and permissions.
+     * 'directory_create' to create directories.
+     * 'file_search' to find files matching glob patterns or names.
+     * 'file_grep' to search text across files.
+     * 'file_delete' to delete files or directories.
+     Filesystem Sandboxing & Guardrails: You operate under strict filesystem sandboxing. You may only access paths explicitly permitted by the user in configuration. Path traversals (e.g. '../'), symlink escapes, and sensitive files (like '.env', private keys, credentials) are strictly forbidden and guarded. If a path is blocked, explain the security boundary to the user.
+4. Channel Formatting: You are communicating via ${contextInfo.channel.toUpperCase()}. Make your messages readable, utilize Markdown headings, bullet points, and code blocks where appropriate. Keep responses engaging and avoid needless boilerplate.
+5. Scheduling & Autonomous Cronjobs: You have built-in autonomous scheduling capabilities via the Gateway. When the user asks you to remind them in the future (e.g. "in 20 minutes", "tomorrow at 9am") or asks for recurring cron tasks (e.g. "every morning at 8am send tech news", "every Monday at 9am send task summary"), use 'schedule_create'. Set action_type to 'reminder' for simple reminder notes, or 'prompt' if you should autonomously generate dynamic content when triggered. Use 'schedule_list' to check active schedules and 'schedule_cancel' to cancel them.
+
+${config.assistant.systemInstructions || ''}
+`.trim();
+    }
+}
+//# sourceMappingURL=systemPrompt.js.map