musonda 1.0.0

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

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

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

@@ -0,0 +1,4 @@
+import { ToolDefinition } from '../types.js';
+export declare const scheduleCreateTool: ToolDefinition;
+export declare const scheduleListTool: ToolDefinition;
+export declare const scheduleCancelTool: ToolDefinition;

package/dist/tools/builtin/scheduleTools.js

@@ -0,0 +1,156 @@
+export const scheduleCreateTool = {
+    name: 'schedule_create',
+    description: 'Schedule a one-time reminder/timer or a recurring cron job. Use this whenever the user asks to be reminded in the future (e.g. "in 30 minutes", "tomorrow at 9am") or wants a recurring schedule (e.g. "every day at 8am", "every Monday at 10am").',
+    parameters: {
+        type: 'object',
+        properties: {
+            title: {
+                type: 'string',
+                description: 'Short descriptive title for this schedule, e.g. "Drink Water", "Daily Tech Briefing".',
+            },
+            pattern: {
+                type: 'string',
+                description: 'Relative delay like "+30m", "+2h", "+1d", OR a standard 5-part cron expression like "0 9 * * *" (daily at 9am) or "0 9 * * 1-5" (weekdays).',
+            },
+            action_type: {
+                type: 'string',
+                enum: ['reminder', 'prompt'],
+                description: 'Use "reminder" for fixed reminder messages, or "prompt" if Musonda should dynamically generate a fresh response using memory/tools when triggered.',
+            },
+            content: {
+                type: 'string',
+                description: 'The reminder message to send, or the autonomous instruction prompt for Musonda to execute when triggered.',
+            },
+            channel: {
+                type: 'string',
+                enum: ['discord', 'slack', 'webhook'],
+                description: 'Target channel to deliver to. Defaults to current conversation channel.',
+            },
+            max_runs: {
+                type: 'number',
+                description: 'Optional maximum number of times to run (default 1 for relative timers).',
+            },
+        },
+        required: ['title', 'pattern', 'content'],
+    },
+    execute: async (args, context) => {
+        if (!context.scheduler) {
+            return { error: 'Scheduler is not enabled or available in this gateway context.' };
+        }
+        const channel = (args.channel || context.channel || 'slack');
+        const channelId = context.channelId || 'default';
+        const profile = context.memory.getProfile();
+        const timezone = profile.timezone || 'UTC';
+        try {
+            const job = context.scheduler.createJob({
+                title: args.title,
+                pattern: args.pattern,
+                timezone,
+                target: {
+                    channel,
+                    channelId,
+                    userId: context.userId,
+                    userName: context.userName,
+                    threadTs: context.threadTs,
+                },
+                action: {
+                    type: args.action_type || 'reminder',
+                    content: args.content,
+                },
+                maxRuns: args.max_runs,
+            });
+            return {
+                success: true,
+                jobId: job.id,
+                title: job.title,
+                type: job.type,
+                pattern: job.pattern,
+                timezone: job.timezone,
+                nextRunAt: job.nextRunAt || 'Immediately or uncalculated',
+                message: `Successfully scheduled "${job.title}"! Next execution scheduled for: ${job.nextRunAt || 'soon'}.`,
+            };
+        }
+        catch (err) {
+            return { error: `Failed to create schedule: ${err.message}` };
+        }
+    },
+};
+export const scheduleListTool = {
+    name: 'schedule_list',
+    description: 'List all currently active and scheduled cron jobs or timers in Musonda Gateway.',
+    parameters: {
+        type: 'object',
+        properties: {
+            status: {
+                type: 'string',
+                enum: ['active', 'completed', 'paused', 'all'],
+                description: 'Filter by job status (default "active").',
+            },
+        },
+    },
+    execute: async (args, context) => {
+        if (!context.scheduler) {
+            return { error: 'Scheduler is not enabled in this gateway context.' };
+        }
+        const filterStatus = args.status && args.status !== 'all' ? args.status : undefined;
+        const jobs = context.scheduler.listJobs(filterStatus ? { status: filterStatus } : undefined);
+        if (jobs.length === 0) {
+            return {
+                count: 0,
+                jobs: [],
+                message: 'No scheduled jobs found.',
+            };
+        }
+        return {
+            count: jobs.length,
+            jobs: jobs.map((j) => ({
+                id: j.id,
+                title: j.title,
+                type: j.type,
+                pattern: j.pattern,
+                actionType: j.action.type,
+                content: j.action.content,
+                channel: j.target.channel,
+                status: j.status,
+                runCount: j.runCount,
+                nextRunAt: j.nextRunAt || 'None',
+                lastRunAt: j.lastRunAt || 'Never',
+            })),
+        };
+    },
+};
+export const scheduleCancelTool = {
+    name: 'schedule_cancel',
+    description: 'Cancel or delete an active schedule, timer, or cron job by its ID or title.',
+    parameters: {
+        type: 'object',
+        properties: {
+            job_id: {
+                type: 'string',
+                description: 'The unique ID (e.g. "job_abc123") or exact title of the job to cancel.',
+            },
+        },
+        required: ['job_id'],
+    },
+    execute: async (args, context) => {
+        if (!context.scheduler) {
+            return { error: 'Scheduler is not enabled in this gateway context.' };
+        }
+        const jobs = context.scheduler.listJobs();
+        let target = jobs.find((j) => j.id === args.job_id);
+        if (!target) {
+            target = jobs.find((j) => j.title.toLowerCase() === args.job_id.toLowerCase());
+        }
+        if (!target) {
+            return { error: `Could not find any schedule matching "${args.job_id}".` };
+        }
+        const success = context.scheduler.cancelJob(target.id);
+        return {
+            success,
+            jobId: target.id,
+            title: target.title,
+            message: `Schedule "${target.title}" has been cancelled.`,
+        };
+    },
+};
+//# sourceMappingURL=scheduleTools.js.map

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

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

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

@@ -0,0 +1,2 @@
+import { ToolDefinition } from '../types.js';
+export declare const currentTimeTool: ToolDefinition;

package/dist/tools/builtin/timeTools.js

@@ -0,0 +1,41 @@
+export const currentTimeTool = {
+    name: 'current_time',
+    description: 'Get the current date, time, day of the week, and timezone information for the user and in UTC.',
+    parameters: {
+        type: 'object',
+        properties: {
+            timezone: {
+                type: 'string',
+                description: 'Optional IANA timezone string (e.g. "Africa/Lusaka", "America/New_York"). Defaults to user configured timezone.',
+            },
+        },
+    },
+    execute: async (args, context) => {
+        const profile = context.memory.getProfile();
+        const tz = args.timezone || profile.timezone || 'UTC';
+        const now = new Date();
+        try {
+            const userTime = new Intl.DateTimeFormat('en-US', {
+                timeZone: tz,
+                dateStyle: 'full',
+                timeStyle: 'long',
+            }).format(now);
+            const utcTime = now.toUTCString();
+            const iso = now.toISOString();
+            return {
+                iso,
+                userTimezone: tz,
+                userLocalTime: userTime,
+                utcTime,
+            };
+        }
+        catch {
+            return {
+                iso: now.toISOString(),
+                utcTime: now.toUTCString(),
+                error: `Could not parse timezone '${tz}', fallback to UTC.`,
+            };
+        }
+    },
+};
+//# sourceMappingURL=timeTools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeTools.js","sourceRoot":"","sources":["../../../src/tools/builtin/timeTools.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,gGAAgG;IAClG,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iHAAiH;aAC/H;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAA2B,EAAE,OAAO,EAAE,EAAE;QACtD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;gBAChD,QAAQ,EAAE,EAAE;gBACZ,SAAS,EAAE,MAAM;gBACjB,SAAS,EAAE,MAAM;aAClB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEf,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YAE9B,OAAO;gBACL,GAAG;gBACH,YAAY,EAAE,EAAE;gBAChB,aAAa,EAAE,QAAQ;gBACvB,OAAO;aACR,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE;gBACtB,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE;gBAC1B,KAAK,EAAE,6BAA6B,EAAE,qBAAqB;aAC5D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,12 @@
+import { ToolDefinition } from '../types.js';
+export declare function isPrivateOrRestrictedIp(ip: string): boolean;
+interface SafeNetworkTarget {
+    parsed: URL;
+    address: string;
+    family: 4 | 6;
+}
+export declare function resolveSafeUrl(rawUrl: string): Promise<SafeNetworkTarget>;
+export declare function assertSafeUrl(rawUrl: string): Promise<void>;
+export declare const webFetchTool: ToolDefinition;
+export declare const webSearchTool: ToolDefinition;
+export {};

package/dist/tools/builtin/webTools.js

@@ -0,0 +1,325 @@
+import net from 'node:net';
+import dns from 'node:dns/promises';
+import http from 'node:http';
+import https from 'node:https';
+import { Buffer } from 'node:buffer';
+export function isPrivateOrRestrictedIp(ip) {
+    // Normalize IPv4-mapped IPv6 (::ffff:127.0.0.1)
+    if (ip.startsWith('::ffff:')) {
+        ip = ip.substring(7);
+    }
+    const family = net.isIP(ip);
+    if (family === 4) {
+        const parts = ip.split('.').map(Number);
+        if (parts.length !== 4 || parts.some((p) => isNaN(p) || p < 0 || p > 255)) {
+            return true; // invalid IP -> treat as restricted
+        }
+        const [a, b] = parts;
+        // 0.0.0.0/8 (current network)
+        if (a === 0)
+            return true;
+        // 127.0.0.0/8 (loopback)
+        if (a === 127)
+            return true;
+        // 10.0.0.0/8 (private)
+        if (a === 10)
+            return true;
+        // 172.16.0.0/12 (private: 172.16.0.0 - 172.31.255.255)
+        if (a === 172 && b >= 16 && b <= 31)
+            return true;
+        // 192.168.0.0/16 (private)
+        if (a === 192 && b === 168)
+            return true;
+        // 169.254.0.0/16 (link-local, cloud metadata)
+        if (a === 169 && b === 254)
+            return true;
+        // 100.64.0.0/10 (carrier-grade NAT: 100.64.0.0 - 100.127.255.255)
+        if (a === 100 && b >= 64 && b <= 127)
+            return true;
+        // 224.0.0.0/4 (multicast)
+        if (a >= 224 && a <= 239)
+            return true;
+        // 240.0.0.0/4 & broadcast (255.255.255.255)
+        if (a >= 240)
+            return true;
+        return false;
+    }
+    if (family === 6) {
+        const norm = ip.toLowerCase();
+        // Loopback
+        if (norm === '::1' || norm === '0:0:0:0:0:0:0:1')
+            return true;
+        // Unspecified
+        if (norm === '::' || norm === '0:0:0:0:0:0:0:0')
+            return true;
+        // Link-local: fe80::/10 (fe8, fe9, fea, feb)
+        if (norm.startsWith('fe8') || norm.startsWith('fe9') || norm.startsWith('fea') || norm.startsWith('feb'))
+            return true;
+        // Unique Local: fc00::/7 (fc, fd)
+        if (norm.startsWith('fc') || norm.startsWith('fd'))
+            return true;
+        // Multicast: ff00::/8
+        if (norm.startsWith('ff'))
+            return true;
+        return false;
+    }
+    return true; // Not a recognized IP, treat as unsafe
+}
+export async function resolveSafeUrl(rawUrl) {
+    let parsed;
+    try {
+        parsed = new URL(rawUrl);
+    }
+    catch {
+        throw new Error(`Invalid URL provided: "${rawUrl}"`);
+    }
+    if (!['http:', 'https:'].includes(parsed.protocol)) {
+        throw new Error('Only HTTP and HTTPS URLs are supported.');
+    }
+    const hostname = parsed.hostname.toLowerCase().replace(/^\[|\]$/g, '');
+    // Common localhost keywords
+    if (hostname === 'localhost' ||
+        hostname.endsWith('.localhost') ||
+        hostname.endsWith('.local') ||
+        hostname === '0.0.0.0') {
+        throw new Error(`Access to local address "${parsed.hostname}" is blocked for security (SSRF prevention).`);
+    }
+    // If hostname is directly an IP address
+    if (net.isIP(hostname)) {
+        if (isPrivateOrRestrictedIp(hostname)) {
+            throw new Error(`Access to private or restricted IP "${hostname}" is blocked for security (SSRF prevention).`);
+        }
+        return { parsed, address: hostname, family: net.isIP(hostname) };
+    }
+    // Resolve hostname via DNS
+    try {
+        const records = await dns.lookup(hostname, { all: true });
+        if (!records || records.length === 0) {
+            throw new Error(`No DNS records found for host "${hostname}"`);
+        }
+        for (const record of records) {
+            if (isPrivateOrRestrictedIp(record.address)) {
+                throw new Error(`Domain "${hostname}" resolved to restricted IP "${record.address}" (SSRF prevention).`);
+            }
+        }
+        const selected = records.find((record) => record.family === 4) || records[0];
+        return { parsed, address: selected.address, family: selected.family };
+    }
+    catch (err) {
+        if (err.message?.includes('SSRF prevention') || err.message?.includes('restricted IP')) {
+            throw err;
+        }
+        throw new Error(`DNS resolution failed for host "${hostname}": ${err.message}`);
+    }
+}
+export async function assertSafeUrl(rawUrl) {
+    await resolveSafeUrl(rawUrl);
+}
+async function fetchPinned(rawUrl, maxBodyBytes, timeoutMs) {
+    const target = await resolveSafeUrl(rawUrl);
+    const transport = target.parsed.protocol === 'https:' ? https : http;
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const request = transport.request(target.parsed, {
+            method: 'GET',
+            headers: {
+                'User-Agent': 'MusondaAgent/1.0 (Autonomous AI Companion; +https://musonda.ai)',
+                Accept: 'text/html,application/xhtml+xml,application/json,text/plain;q=0.9,*/*;q=0.8',
+                'Accept-Encoding': 'identity',
+            },
+            // Pin the connection to the address that passed validation. This closes the
+            // DNS-rebinding gap between validation and the outbound connection.
+            lookup: ((_hostname, options, callback) => {
+                if (typeof options === 'object' && options.all) {
+                    callback(null, [{ address: target.address, family: target.family }]);
+                }
+                else {
+                    callback(null, target.address, target.family);
+                }
+            }),
+        }, (response) => {
+            const chunks = [];
+            let totalBytes = 0;
+            let truncated = false;
+            response.on('data', (chunk) => {
+                if (truncated)
+                    return;
+                const buffer = Buffer.from(chunk);
+                const remaining = maxBodyBytes - totalBytes;
+                if (buffer.length > remaining) {
+                    if (remaining > 0)
+                        chunks.push(buffer.subarray(0, remaining));
+                    totalBytes = maxBodyBytes;
+                    truncated = true;
+                    finish();
+                    response.destroy();
+                    return;
+                }
+                chunks.push(buffer);
+                totalBytes += buffer.length;
+            });
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(totalTimer);
+                resolve({
+                    status: response.statusCode || 0,
+                    statusText: response.statusMessage || '',
+                    headers: response.headers,
+                    body: Buffer.concat(chunks),
+                    truncated,
+                });
+            };
+            response.once('end', finish);
+            response.once('close', () => {
+                if (truncated)
+                    finish();
+            });
+            response.once('error', (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(totalTimer);
+                reject(error);
+            });
+        });
+        const totalTimer = setTimeout(() => request.destroy(new Error(`Request timed out after ${timeoutMs}ms.`)), timeoutMs);
+        request.once('error', (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(totalTimer);
+            reject(error);
+        });
+        request.end();
+    });
+}
+export const webFetchTool = {
+    name: 'web_fetch',
+    description: 'Fetch content from a public web URL and convert the HTML/text into clean readable text for research or analysis.',
+    parameters: {
+        type: 'object',
+        properties: {
+            url: {
+                type: 'string',
+                description: 'The full HTTP or HTTPS URL to fetch content from.',
+            },
+        },
+        required: ['url'],
+    },
+    execute: async (args) => {
+        try {
+            let currentUrl = args.url;
+            let redirectCount = 0;
+            const MAX_REDIRECTS = 5;
+            const MAX_BODY_BYTES = 2 * 1024 * 1024; // 2 MB limit to prevent memory exhaustion
+            let res = null;
+            while (true) {
+                const response = await fetchPinned(currentUrl, MAX_BODY_BYTES, 10000);
+                // Explicitly inspect and validate HTTP redirects (301, 302, 303, 307, 308)
+                if ([301, 302, 303, 307, 308].includes(response.status)) {
+                    const location = response.headers.location;
+                    if (!location) {
+                        return { error: `Redirect response (HTTP ${response.status}) missing Location header.` };
+                    }
+                    redirectCount++;
+                    if (redirectCount > MAX_REDIRECTS) {
+                        return { error: `Too many redirects (exceeded maximum of ${MAX_REDIRECTS}).` };
+                    }
+                    currentUrl = new URL(location, currentUrl).toString();
+                    continue;
+                }
+                res = response;
+                break;
+            }
+            if (res.status < 200 || res.status >= 300) {
+                return { error: `HTTP ${res.status}: ${res.statusText}` };
+            }
+            const contentType = res.headers['content-type'] || '';
+            const text = res.body.toString('utf-8');
+            if (contentType.includes('application/json')) {
+                return { url: args.url, type: 'json', data: JSON.parse(text), truncated: res.truncated };
+            }
+            // Simple HTML-to-text extraction
+            const cleanText = text
+                .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+                .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '')
+                .replace(/<noscript\b[^<]*(?:(?!<\/noscript>)<[^<]*)*<\/noscript>/gi, '')
+                .replace(/<[^>]+>/g, ' ')
+                .replace(/&nbsp;/g, ' ')
+                .replace(/&amp;/g, '&')
+                .replace(/&lt;/g, '<')
+                .replace(/&gt;/g, '>')
+                .replace(/&quot;/g, '"')
+                .replace(/\s+/g, ' ')
+                .trim();
+            const truncated = cleanText.length > 5000 ? cleanText.substring(0, 5000) + '... [truncated]' : cleanText;
+            return {
+                url: args.url,
+                content: truncated,
+                characters: cleanText.length,
+                truncatedBySizeLimit: res.truncated,
+            };
+        }
+        catch (err) {
+            return { error: `Failed to fetch URL: ${err.message}` };
+        }
+    },
+};
+export const webSearchTool = {
+    name: 'web_search',
+    description: 'Search the web using DuckDuckGo Instant API / search engine for up-to-date topics, news, documentation, or facts.',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query to look up on the web.',
+            },
+        },
+        required: ['query'],
+    },
+    execute: async (args) => {
+        try {
+            const endpoint = `https://api.duckduckgo.com/?q=${encodeURIComponent(args.query)}&format=json&no_html=1&skip_disambig=1`;
+            const res = await fetch(endpoint, {
+                headers: {
+                    'User-Agent': 'MusondaAgent/1.0',
+                },
+            });
+            if (!res.ok) {
+                return { error: `Search API failed with status ${res.status}` };
+            }
+            const data = await res.json();
+            const results = [];
+            if (data.AbstractText) {
+                results.push({
+                    title: data.Heading || 'Overview',
+                    snippet: data.AbstractText,
+                    url: data.AbstractURL,
+                });
+            }
+            if (Array.isArray(data.RelatedTopics)) {
+                for (const topic of data.RelatedTopics.slice(0, 5)) {
+                    if (topic.Text) {
+                        results.push({
+                            title: topic.FirstURL ? topic.FirstURL.split('/').pop() || 'Topic' : 'Topic',
+                            snippet: topic.Text,
+                            url: topic.FirstURL,
+                        });
+                    }
+                }
+            }
+            return {
+                query: args.query,
+                count: results.length,
+                results: results.length > 0 ? results : [{ snippet: `No instant answer found for "${args.query}". Try web_fetch for direct pages.` }],
+            };
+        }
+        catch (err) {
+            return { error: `Web search error: ${err.message}` };
+        }
+    },
+};
+//# sourceMappingURL=webTools.js.map

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

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,15 @@
+import { ToolDefinition, ToolContext, OpenAIFunctionToolSchema } from './types.js';
+export declare class ToolRegistry {
+    private tools;
+    constructor();
+    private registerDefaults;
+    register(tool: ToolDefinition): void;
+    unregister(name: string): boolean;
+    get(name: string): ToolDefinition | undefined;
+    getAll(): ToolDefinition[];
+    getOpenAITools(): OpenAIFunctionToolSchema[];
+    executeTool(name: string, rawArgs: string | Record<string, any>, context: ToolContext): Promise<{
+        output: string;
+        isError?: boolean;
+    }>;
+}