@useconductor/conductor 1.0.0

package/dist/plugins/builtin/docker.js

@@ -0,0 +1,436 @@
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+const execFileAsync = promisify(execFile);
+export class DockerPlugin {
+    name = 'docker';
+    description = 'Docker container, image, volume, and network management';
+    version = '1.0.0';
+    async initialize(_conductor) { }
+    isConfigured() {
+        return true;
+    }
+    async docker(args) {
+        try {
+            const { stdout, stderr } = await execFileAsync('docker', args, { timeout: 30000 });
+            return { stdout: stdout.trim(), stderr: stderr.trim() };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`Docker command failed: ${msg}`);
+        }
+    }
+    getTools() {
+        return [
+            {
+                name: 'docker_containers',
+                description: 'List Docker containers. Use --all to include stopped containers.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        all: { type: 'boolean', description: 'Include stopped containers', default: false },
+                        filters: { type: 'string', description: 'Docker filter flags (e.g. "status=running")' },
+                    },
+                },
+                handler: async (input) => {
+                    const args = ['ps', '--format', '{{json .}}'];
+                    if (input.all)
+                        args.push('-a');
+                    if (input.filters)
+                        args.push('--filter', input.filters);
+                    const { stdout } = await this.docker(args);
+                    if (!stdout)
+                        return { containers: [] };
+                    return {
+                        containers: stdout
+                            .split('\n')
+                            .map((line) => {
+                            try {
+                                return JSON.parse(line);
+                            }
+                            catch {
+                                return null;
+                            }
+                        })
+                            .filter((c) => c !== null),
+                    };
+                },
+            },
+            {
+                name: 'docker_container_logs',
+                description: 'Get logs from a Docker container',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        container: { type: 'string', description: 'Container name or ID' },
+                        tail: { type: 'number', description: 'Number of lines from end', default: 100 },
+                    },
+                    required: ['container'],
+                },
+                handler: async (input) => {
+                    const args = ['logs', '--tail', String(input.tail ?? 100), input.container];
+                    const { stdout, stderr } = await this.docker(args);
+                    return { container: input.container, logs: stdout || stderr };
+                },
+            },
+            {
+                name: 'docker_container_action',
+                description: 'Start, stop, restart, pause, unpause, or kill a Docker container',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        container: { type: 'string', description: 'Container name or ID' },
+                        action: {
+                            type: 'string',
+                            enum: ['start', 'stop', 'restart', 'pause', 'unpause', 'kill', 'remove'],
+                            description: 'Action to perform',
+                        },
+                    },
+                    required: ['container', 'action'],
+                },
+                handler: async (input) => {
+                    const args = [input.action, input.container];
+                    if (input.action === 'remove')
+                        args.push('-f');
+                    await this.docker(args);
+                    return { container: input.container, action: input.action, status: 'success' };
+                },
+            },
+            {
+                name: 'docker_images',
+                description: 'List Docker images',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+                handler: async () => {
+                    const { stdout } = await this.docker(['images', '--format', '{{json .}}']);
+                    if (!stdout)
+                        return { images: [] };
+                    return {
+                        images: stdout
+                            .split('\n')
+                            .map((line) => {
+                            try {
+                                return JSON.parse(line);
+                            }
+                            catch {
+                                return null;
+                            }
+                        })
+                            .filter((c) => c !== null),
+                    };
+                },
+            },
+            {
+                name: 'docker_pull',
+                description: 'Pull a Docker image',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        image: { type: 'string', description: 'Image name (e.g. "nginx:latest")' },
+                    },
+                    required: ['image'],
+                },
+                handler: async (input) => {
+                    const { stdout } = await this.docker(['pull', input.image]);
+                    return { image: input.image, result: stdout };
+                },
+            },
+            {
+                name: 'docker_run',
+                description: 'Run a Docker container. Requires approval for security.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        image: { type: 'string', description: 'Image to run' },
+                        name: { type: 'string', description: 'Container name' },
+                        ports: { type: 'array', items: { type: 'string' }, description: 'Port mappings (e.g. ["8080:80"])' },
+                        env: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Environment variables (e.g. ["KEY=value"])',
+                        },
+                        volumes: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Volume mounts (e.g. ["/host:/container"])',
+                        },
+                        detach: { type: 'boolean', description: 'Run in background', default: true },
+                        command: { type: 'string', description: 'Command to run inside container' },
+                    },
+                    required: ['image'],
+                },
+                handler: async (input) => {
+                    const args = ['run'];
+                    if (input.name)
+                        args.push('--name', input.name);
+                    if (input.detach)
+                        args.push('-d');
+                    if (input.ports)
+                        for (const p of input.ports)
+                            args.push('-p', p);
+                    if (input.env)
+                        for (const e of input.env)
+                            args.push('-e', e);
+                    if (input.volumes)
+                        for (const v of input.volumes)
+                            args.push('-v', v);
+                    args.push(input.image);
+                    if (input.command)
+                        args.push(input.command);
+                    const { stdout } = await this.docker(args);
+                    return { image: input.image, container_id: stdout.trim() };
+                },
+                requiresApproval: true,
+            },
+            {
+                name: 'docker_volumes',
+                description: 'List Docker volumes',
+                inputSchema: { type: 'object', properties: {} },
+                handler: async () => {
+                    const { stdout } = await this.docker(['volume', 'ls', '--format', '{{json .}}']);
+                    if (!stdout)
+                        return { volumes: [] };
+                    return {
+                        volumes: stdout
+                            .split('\n')
+                            .map((line) => {
+                            try {
+                                return JSON.parse(line);
+                            }
+                            catch {
+                                return null;
+                            }
+                        })
+                            .filter((c) => c !== null),
+                    };
+                },
+            },
+            {
+                name: 'docker_networks',
+                description: 'List Docker networks',
+                inputSchema: { type: 'object', properties: {} },
+                handler: async () => {
+                    const { stdout } = await this.docker(['network', 'ls', '--format', '{{json .}}']);
+                    if (!stdout)
+                        return { networks: [] };
+                    return {
+                        networks: stdout
+                            .split('\n')
+                            .map((line) => {
+                            try {
+                                return JSON.parse(line);
+                            }
+                            catch {
+                                return null;
+                            }
+                        })
+                            .filter((c) => c !== null),
+                    };
+                },
+            },
+            {
+                name: 'docker_stats',
+                description: 'Get resource usage stats for running containers',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        container: { type: 'string', description: 'Specific container (omit for all)' },
+                    },
+                },
+                handler: async (input) => {
+                    const args = ['stats', '--no-stream', '--format', '{{json .}}'];
+                    if (input.container)
+                        args.push(input.container);
+                    const { stdout } = await this.docker(args);
+                    if (!stdout)
+                        return { stats: [] };
+                    return {
+                        stats: stdout
+                            .split('\n')
+                            .map((line) => {
+                            try {
+                                return JSON.parse(line);
+                            }
+                            catch {
+                                return null;
+                            }
+                        })
+                            .filter((c) => c !== null),
+                    };
+                },
+            },
+            {
+                name: 'docker_build',
+                description: 'Build a Docker image from a Dockerfile',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        context: { type: 'string', description: 'Build context path (directory containing Dockerfile)' },
+                        tag: { type: 'string', description: 'Image tag (e.g. "myapp:latest")' },
+                        dockerfile: { type: 'string', description: 'Path to Dockerfile if not in context root' },
+                        build_args: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Build arguments (e.g. ["VERSION=1.0"])',
+                        },
+                        no_cache: { type: 'boolean', description: 'Disable build cache', default: false },
+                    },
+                    required: ['context', 'tag'],
+                },
+                requiresApproval: true,
+                handler: async (input) => {
+                    const args = ['build', '-t', input.tag];
+                    if (input.dockerfile)
+                        args.push('-f', input.dockerfile);
+                    if (input.no_cache)
+                        args.push('--no-cache');
+                    if (input.build_args)
+                        for (const a of input.build_args)
+                            args.push('--build-arg', a);
+                    args.push(input.context);
+                    const { stdout, stderr } = await this.docker(args);
+                    return { tag: input.tag, output: stdout || stderr };
+                },
+            },
+            {
+                name: 'docker_push',
+                description: 'Push a Docker image to a registry',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        image: { type: 'string', description: 'Image name and tag to push (e.g. "registry.io/myapp:latest")' },
+                    },
+                    required: ['image'],
+                },
+                requiresApproval: true,
+                handler: async (input) => {
+                    const { stdout, stderr } = await this.docker(['push', input.image]);
+                    return { image: input.image, result: stdout || stderr };
+                },
+            },
+            {
+                name: 'docker_network_ls',
+                description: 'List Docker networks',
+                inputSchema: { type: 'object', properties: {} },
+                handler: async () => {
+                    const { stdout } = await this.docker(['network', 'ls', '--format', '{{json .}}']);
+                    if (!stdout)
+                        return { networks: [] };
+                    return {
+                        networks: stdout
+                            .split('\n')
+                            .map((line) => {
+                            try {
+                                return JSON.parse(line);
+                            }
+                            catch {
+                                return null;
+                            }
+                        })
+                            .filter((c) => c !== null),
+                    };
+                },
+            },
+            {
+                name: 'docker_volume_ls',
+                description: 'List Docker volumes',
+                inputSchema: { type: 'object', properties: {} },
+                handler: async () => {
+                    const { stdout } = await this.docker(['volume', 'ls', '--format', '{{json .}}']);
+                    if (!stdout)
+                        return { volumes: [] };
+                    return {
+                        volumes: stdout
+                            .split('\n')
+                            .map((line) => {
+                            try {
+                                return JSON.parse(line);
+                            }
+                            catch {
+                                return null;
+                            }
+                        })
+                            .filter((c) => c !== null),
+                    };
+                },
+            },
+            {
+                name: 'docker_compose_up',
+                description: 'Start services defined in a docker-compose file',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        project_dir: { type: 'string', description: 'Directory containing docker-compose.yml' },
+                        services: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Specific services to start (omit for all)',
+                        },
+                        detach: { type: 'boolean', description: 'Run in background', default: true },
+                        build: { type: 'boolean', description: 'Build images before starting', default: false },
+                    },
+                    required: ['project_dir'],
+                },
+                requiresApproval: true,
+                handler: async (input) => {
+                    const args = ['compose', '-f', `${input.project_dir}/docker-compose.yml`, 'up'];
+                    if (input.detach ?? true)
+                        args.push('-d');
+                    if (input.build)
+                        args.push('--build');
+                    if (input.services?.length)
+                        args.push(...input.services);
+                    const { stdout, stderr } = await this.docker(args);
+                    return { project_dir: input.project_dir, result: stdout || stderr };
+                },
+            },
+            {
+                name: 'docker_compose_down',
+                description: 'Stop and remove services defined in a docker-compose file',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        project_dir: { type: 'string', description: 'Directory containing docker-compose.yml' },
+                        volumes: { type: 'boolean', description: 'Also remove named volumes', default: false },
+                    },
+                    required: ['project_dir'],
+                },
+                requiresApproval: true,
+                handler: async (input) => {
+                    const args = ['compose', '-f', `${input.project_dir}/docker-compose.yml`, 'down'];
+                    if (input.volumes)
+                        args.push('-v');
+                    const { stdout, stderr } = await this.docker(args);
+                    return { project_dir: input.project_dir, result: stdout || stderr };
+                },
+            },
+            {
+                name: 'docker_exec',
+                description: 'Execute a command inside a running container',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        container: { type: 'string', description: 'Container name or ID' },
+                        command: { type: 'string', description: 'Command to run (e.g. "ls /app")' },
+                        user: { type: 'string', description: 'Run as this user (optional)' },
+                    },
+                    required: ['container', 'command'],
+                },
+                requiresApproval: true,
+                handler: async (input) => {
+                    const args = ['exec'];
+                    if (input.user)
+                        args.push('-u', input.user);
+                    args.push(input.container);
+                    // Split command string safely
+                    const parts = input.command.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/g) ?? [input.command];
+                    args.push(...parts);
+                    const { stdout, stderr } = await this.docker(args);
+                    return { container: input.container, command: input.command, output: stdout || stderr };
+                },
+            },
+        ];
+    }
+}
+//# sourceMappingURL=docker.js.map

package/dist/plugins/builtin/docker.js.map

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

package/dist/plugins/builtin/fun.d.ts

@@ -0,0 +1,11 @@
+import { Plugin, PluginTool } from '../manager.js';
+import { Conductor } from '../../core/conductor.js';
+export declare class FunPlugin implements Plugin {
+    name: string;
+    description: string;
+    version: string;
+    initialize(_conductor: Conductor): Promise<void>;
+    isConfigured(): boolean;
+    getTools(): PluginTool[];
+}
+//# sourceMappingURL=fun.d.ts.map

package/dist/plugins/builtin/fun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fun.d.ts","sourceRoot":"","sources":["../../../src/plugins/builtin/fun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,qBAAa,SAAU,YAAW,MAAM;IACtC,IAAI,SAAS;IACb,WAAW,SAAwD;IACnE,OAAO,SAAW;IAEZ,UAAU,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IACtD,YAAY,IAAI,OAAO;IAIvB,QAAQ,IAAI,UAAU,EAAE;CAwGzB"}

package/dist/plugins/builtin/fun.js

@@ -0,0 +1,114 @@
+export class FunPlugin {
+    name = 'fun';
+    description = 'Jokes, cat facts, trivia, random numbers, and more';
+    version = '1.0.0';
+    async initialize(_conductor) { }
+    isConfigured() {
+        return true;
+    }
+    getTools() {
+        return [
+            {
+                name: 'fun_joke',
+                description: 'Get a random joke',
+                inputSchema: { type: 'object', properties: {} },
+                handler: async () => {
+                    const res = await fetch('https://official-joke-api.appspot.com/random_joke');
+                    return await res.json();
+                },
+            },
+            {
+                name: 'fun_cat_fact',
+                description: 'Get a random cat fact',
+                inputSchema: { type: 'object', properties: {} },
+                handler: async () => {
+                    const res = await fetch('https://catfact.ninja/fact');
+                    return await res.json();
+                },
+            },
+            {
+                name: 'fun_trivia',
+                description: 'Get a random trivia question',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        difficulty: { type: 'string', description: 'easy, medium, or hard', default: 'medium' },
+                    },
+                },
+                handler: async (input) => {
+                    const diff = input.difficulty || 'medium';
+                    const res = await fetch(`https://opentdb.com/api.php?amount=1&difficulty=${diff}&type=multiple`);
+                    const data = (await res.json());
+                    if (!data.results?.length)
+                        return { error: 'No trivia found' };
+                    const q = data.results[0];
+                    const answers = [...q.incorrect_answers, q.correct_answer].sort(() => Math.random() - 0.5);
+                    return {
+                        category: q.category,
+                        difficulty: q.difficulty,
+                        question: q.question.replace(/&[^;]+;/g, (m) => {
+                            const map = {
+                                '&': '&',
+                                '&lt;': '<',
+                                '&gt;': '>',
+                                '&quot;': '"',
+                                '&#039;': "'",
+                            };
+                            return map[m] || m;
+                        }),
+                        answers,
+                        correct: q.correct_answer,
+                    };
+                },
+            },
+            {
+                name: 'fun_random_number',
+                description: 'Generate a random number in a range',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        min: { type: 'number', description: 'Minimum value', default: 1 },
+                        max: { type: 'number', description: 'Maximum value', default: 100 },
+                    },
+                },
+                handler: async (input) => {
+                    const min = input.min ?? 1;
+                    const max = input.max ?? 100;
+                    return { min, max, result: Math.floor(Math.random() * (max - min + 1)) + min };
+                },
+            },
+            {
+                name: 'fun_quote',
+                description: 'Get an inspirational quote',
+                inputSchema: { type: 'object', properties: {} },
+                handler: async () => {
+                    // Built-in quotes — zero latency, no dead API dependencies
+                    const quotes = [
+                        { quote: 'The best way to predict the future is to create it.', author: 'Peter Drucker' },
+                        { quote: "Code is like humor. When you have to explain it, it's bad.", author: 'Cory House' },
+                        { quote: 'First, solve the problem. Then, write the code.', author: 'John Johnson' },
+                        {
+                            quote: 'Any fool can write code that a computer can understand. Good programmers write code that humans can understand.',
+                            author: 'Martin Fowler',
+                        },
+                        {
+                            quote: 'Programs must be written for people to read, and only incidentally for machines to execute.',
+                            author: 'Harold Abelson',
+                        },
+                        { quote: 'Simplicity is the soul of efficiency.', author: 'Austin Freeman' },
+                        { quote: 'Make it work, make it right, make it fast.', author: 'Kent Beck' },
+                        { quote: 'Talk is cheap. Show me the code.', author: 'Linus Torvalds' },
+                        { quote: 'In order to be irreplaceable, one must always be different.', author: 'Coco Chanel' },
+                        { quote: 'The secret of getting ahead is getting started.', author: 'Mark Twain' },
+                        { quote: "It always seems impossible until it's done.", author: 'Nelson Mandela' },
+                        { quote: "Whether you think you can or you think you can't, you're right.", author: 'Henry Ford' },
+                        { quote: 'The only way to do great work is to love what you do.', author: 'Steve Jobs' },
+                        { quote: 'Stay hungry, stay foolish.', author: 'Steve Jobs' },
+                    ];
+                    return quotes[Math.floor(Math.random() * quotes.length)];
+                },
+            },
+        ];
+    }
+}
+//# sourceMappingURL=fun.js.map

package/dist/plugins/builtin/fun.js.map

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

package/dist/plugins/builtin/gcal.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Google Calendar Plugin
+ *
+ * Read, create, update, and delete calendar events.
+ * Requires Google OAuth — stores access token as google / access_token.
+ *
+ * Scopes needed:
+ *   https://www.googleapis.com/auth/calendar
+ *   https://www.googleapis.com/auth/calendar.events
+ */
+import { Plugin, PluginTool } from '../manager.js';
+import { Conductor } from '../../core/conductor.js';
+export declare class GoogleCalendarPlugin implements Plugin {
+    name: string;
+    description: string;
+    version: string;
+    configSchema: {
+        fields: {
+            key: string;
+            label: string;
+            type: "password";
+            required: boolean;
+            secret: boolean;
+            service: string;
+            description: string;
+        }[];
+    };
+    private keychain;
+    initialize(conductor: Conductor): Promise<void>;
+    isConfigured(): boolean;
+    getContext(): Promise<string | null>;
+    private getToken;
+    private calFetch;
+    /** Format a GCal event for output */
+    private formatEvent;
+    getTools(): PluginTool[];
+}
+//# sourceMappingURL=gcal.d.ts.map

package/dist/plugins/builtin/gcal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcal.d.ts","sourceRoot":"","sources":["../../../src/plugins/builtin/gcal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAKpD,qBAAa,oBAAqB,YAAW,MAAM;IACjD,IAAI,SAAU;IACd,WAAW,SAAoE;IAC/E,OAAO,SAAW;IAElB,YAAY;;;;;;;;;;MAYV;IAEF,OAAO,CAAC,QAAQ,CAAY;IAEtB,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,YAAY,IAAI,OAAO;IAIjB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAkB5B,QAAQ;YAMR,QAAQ;IAmBtB,qCAAqC;IACrC,OAAO,CAAC,WAAW;IAmBnB,QAAQ,IAAI,UAAU,EAAE;CAmMzB"}