twinclaw 1.1.1 → 1.1.2

package/dist/services/auto-configurer.js

@@ -0,0 +1,591 @@
+import { readConfig, writeConfig } from '../config/config-loader.js';
+import { logThought } from '../utils/logger.js';
+import { writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import * as path from 'path';
+import { getWorkspaceDir } from '../config/workspace.js';
+const KNOWN_SERVICES = {
+    slack: {
+        name: 'slack',
+        displayName: 'Slack',
+        description: 'Team messaging and collaboration',
+        authType: 'api_key',
+        docsUrl: 'https://api.slack.com/docs',
+        envVars: ['SLACK_BOT_TOKEN', 'SLACK_SIGNING_SECRET'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Slack integration' },
+            botToken: { type: 'string', required: true, description: 'Bot User OAuth Token' },
+            signingSecret: { type: 'string', required: true, description: 'Signing Secret' },
+            defaultChannel: { type: 'string', required: false, description: 'Default channel for notifications' }
+        },
+        steps: [
+            '1. Go to https://api.slack.com/apps',
+            '2. Click "Create New App" → "From scratch"',
+            '3. Name your app and select workspace',
+            '4. Go to "OAuth & Permissions"',
+            '5. Add scopes: chat:write, channels:read, users:read',
+            '6. Click "Install to Workspace"',
+            '7. Copy the "Bot User OAuth Token" (starts with xoxb-)'
+        ]
+    },
+    discord: {
+        name: 'discord',
+        displayName: 'Discord',
+        description: 'Chat platform for communities',
+        authType: 'api_key',
+        docsUrl: 'https://discord.com/developers/docs/intro',
+        envVars: ['DISCORD_BOT_TOKEN', 'DISCORD_GUILD_ID'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Discord integration' },
+            botToken: { type: 'string', required: true, description: 'Bot Token' },
+            guildId: { type: 'string', required: false, description: 'Server ID' }
+        },
+        steps: [
+            '1. Go to https://discord.com/developers/applications',
+            '2. Click "New Application"',
+            '3. Go to "Bot" section and create bot',
+            '4. Enable "Message Content Intent"',
+            '5. Go to "OAuth2" → "URL Generator"',
+            '6. Select scopes: bot, applications.commands',
+            '7. Copy the generated URL and invite bot'
+        ]
+    },
+    notion: {
+        name: 'notion',
+        displayName: 'Notion',
+        description: 'All-in-one workspace for notes and docs',
+        authType: 'api_key',
+        docsUrl: 'https://developers.notion.com/',
+        envVars: ['NOTION_API_KEY', 'NOTION_DATABASE_ID'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Notion integration' },
+            apiKey: { type: 'string', required: true, description: 'Internal Integration Token' },
+            databaseId: { type: 'string', required: false, description: 'Database ID for pages' }
+        },
+        steps: [
+            '1. Go to https://www.notion.so/my-integrations',
+            '2. Click "+ New integration"',
+            '3. Name your integration and submit',
+            '4. Copy "Internal Integration Token"',
+            '5. Open the database/page you want to access',
+            '6. Click "..." → "Connect to" → select your integration'
+        ]
+    },
+    github: {
+        name: 'github',
+        displayName: 'GitHub',
+        description: 'Code hosting and version control',
+        authType: 'api_key',
+        docsUrl: 'https://docs.github.com/en/rest',
+        envVars: ['GITHUB_TOKEN', 'GITHUB_REPO'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable GitHub integration' },
+            token: { type: 'string', required: true, description: 'Personal Access Token' },
+            repo: { type: 'string', required: false, description: 'Repository (owner/repo)' }
+        },
+        steps: [
+            '1. Go to https://github.com/settings/tokens',
+            '2. Click "Generate new token (classic)"',
+            '3. Select scopes: repo, workflow, read:user',
+            '4. Generate and copy token'
+        ]
+    },
+    jira: {
+        name: 'jira',
+        displayName: 'Jira',
+        description: 'Project and issue tracking',
+        authType: 'basic',
+        docsUrl: 'https://developer.atlassian.com/cloud/jira/',
+        envVars: ['JIRA_DOMAIN', 'JIRA_EMAIL', 'JIRA_API_TOKEN'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Jira integration' },
+            domain: { type: 'string', required: true, description: 'Your domain.atlassian.net' },
+            email: { type: 'string', required: true, description: 'Your email' },
+            apiToken: { type: 'string', required: true, description: 'API Token' }
+        },
+        steps: [
+            '1. Go to https://id.atlassian.com/manage-profile/security/api-tokens',
+            '2. Click "Create API token"',
+            '3. Label it and copy the token',
+            '4. Your email is your Atlassian account email'
+        ]
+    },
+    linear: {
+        name: 'linear',
+        displayName: 'Linear',
+        description: 'Issue tracking for software teams',
+        authType: 'api_key',
+        docsUrl: 'https://developers.linear.app/',
+        envVars: ['LINEAR_API_KEY', 'LINEAR_TEAM_ID'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Linear integration' },
+            apiKey: { type: 'string', required: true, description: 'API Key' },
+            teamId: { type: 'string', required: false, description: 'Team ID' }
+        },
+        steps: [
+            '1. Go to https://linear.app/settings/api',
+            '2. Click "Create API key"',
+            '3. Name it and copy the key'
+        ]
+    },
+    notioncalendar: {
+        name: 'notioncalendar',
+        displayName: 'Notion Calendar',
+        description: 'Calendar synced with Notion',
+        authType: 'api_key',
+        docsUrl: 'https://developers.notion.com/',
+        envVars: ['NOTION_API_KEY'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable calendar sync' },
+            calendarId: { type: 'string', required: false, description: 'Calendar ID' }
+        },
+        steps: [
+            '1. Create a Notion database with calendar properties',
+            '2. Get API key from https://www.notion.so/my-integrations',
+            '3. Share the database with the integration'
+        ]
+    },
+    spotify: {
+        name: 'spotify',
+        displayName: 'Spotify',
+        description: 'Music streaming and control',
+        authType: 'oauth',
+        docsUrl: 'https://developer.spotify.com/',
+        envVars: ['SPOTIFY_CLIENT_ID', 'SPOTIFY_CLIENT_SECRET'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Spotify control' },
+            clientId: { type: 'string', required: true, description: 'Client ID' },
+            clientSecret: { type: 'string', required: true, description: 'Client Secret' }
+        },
+        steps: [
+            '1. Go to https://developer.spotify.com/dashboard',
+            '2. Create new app',
+            '3. Add redirect URI: http://localhost:8888/callback',
+            '4. Copy Client ID and Client Secret'
+        ]
+    },
+    openweather: {
+        name: 'openweather',
+        displayName: 'OpenWeather',
+        description: 'Weather data and forecasts',
+        authType: 'api_key',
+        docsUrl: 'https://openweathermap.org/api',
+        envVars: ['OPENWEATHER_API_KEY'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable weather' },
+            apiKey: { type: 'string', required: true, description: 'API Key' }
+        },
+        steps: [
+            '1. Go to https://openweathermap.org/api',
+            '2. Sign up for free account',
+            '3. Go to "API Keys" and copy your key'
+        ]
+    },
+    twilio: {
+        name: 'twilio',
+        displayName: 'Twilio',
+        description: 'SMS, Voice and Messaging',
+        authType: 'api_key',
+        docsUrl: 'https://www.twilio.com/docs',
+        envVars: ['TWILIO_ACCOUNT_SID', 'TWILIO_AUTH_TOKEN', 'TWILIO_PHONE_NUMBER'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Twilio' },
+            accountSid: { type: 'string', required: true, description: 'Account SID' },
+            authToken: { type: 'string', required: true, description: 'Auth Token' },
+            phoneNumber: { type: 'string', required: true, description: 'Phone Number' }
+        },
+        steps: [
+            '1. Go to https://www.twilio.com/console',
+            '2. Get Account SID and Auth Token',
+            '3. Get a phone number from "Phone Numbers"'
+        ]
+    },
+    gmail: {
+        name: 'gmail',
+        displayName: 'Gmail',
+        description: 'Email via Google Gmail',
+        authType: 'oauth',
+        docsUrl: 'https://developers.google.com/gmail/api',
+        envVars: ['GMAIL_CLIENT_ID', 'GMAIL_CLIENT_SECRET'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Gmail' },
+            clientId: { type: 'string', required: true, description: 'OAuth Client ID' },
+            clientSecret: { type: 'string', required: true, description: 'OAuth Client Secret' }
+        },
+        steps: [
+            '1. Go to https://console.cloud.google.com/apis/credentials',
+            '2. Create OAuth 2.0 Client ID',
+            '3. Set redirect URI: http://localhost:3000/oauth/callback',
+            '4. Copy Client ID and Client Secret'
+        ]
+    },
+    googlecalendar: {
+        name: 'googlecalendar',
+        displayName: 'Google Calendar',
+        description: 'Calendar via Google Calendar API',
+        authType: 'oauth',
+        docsUrl: 'https://developers.google.com/calendar',
+        envVars: ['GCAL_CLIENT_ID', 'GCAL_CLIENT_SECRET'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Google Calendar' },
+            clientId: { type: 'string', required: true, description: 'OAuth Client ID' },
+            clientSecret: { type: 'string', required: true, description: 'OAuth Client Secret' }
+        },
+        steps: [
+            '1. Go to https://console.cloud.google.com/apis/credentials',
+            '2. Create OAuth 2.0 Client ID for Calendar API',
+            '3. Copy Client ID and Secret'
+        ]
+    },
+    postgresql: {
+        name: 'postgresql',
+        displayName: 'PostgreSQL',
+        description: 'Database - PostgreSQL',
+        authType: 'basic',
+        docsUrl: 'https://www.postgresql.org/docs/',
+        envVars: ['PG_HOST', 'PG_USER', 'PG_PASSWORD', 'PG_DATABASE'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable PostgreSQL' },
+            host: { type: 'string', required: true, description: 'Database host' },
+            port: { type: 'number', required: false, description: 'Port (default: 5432)' },
+            user: { type: 'string', required: true, description: 'Database user' },
+            password: { type: 'string', required: true, description: 'Database password' },
+            database: { type: 'string', required: true, description: 'Database name' }
+        },
+        steps: [
+            '1. Install PostgreSQL: https://www.postgresql.org/download/',
+            '2. Create a database and user',
+            '3. Note connection details'
+        ]
+    },
+    mysql: {
+        name: 'mysql',
+        displayName: 'MySQL',
+        description: 'Database - MySQL/MariaDB',
+        authType: 'basic',
+        docsUrl: 'https://dev.mysql.com/doc/',
+        envVars: ['MYSQL_HOST', 'MYSQL_USER', 'MYSQL_PASSWORD', 'MYSQL_DATABASE'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable MySQL' },
+            host: { type: 'string', required: true, description: 'Database host' },
+            port: { type: 'number', required: false, description: 'Port (default: 3306)' },
+            user: { type: 'string', required: true, description: 'Database user' },
+            password: { type: 'string', required: true, description: 'Database password' },
+            database: { type: 'string', required: true, description: 'Database name' }
+        },
+        steps: [
+            '1. Install MySQL or MariaDB',
+            '2. Create a database and user',
+            '3. Note connection details'
+        ]
+    },
+    mongodb: {
+        name: 'mongodb',
+        displayName: 'MongoDB',
+        description: 'NoSQL Database - MongoDB',
+        authType: 'api_key',
+        docsUrl: 'https://docs.mongodb.com/',
+        envVars: ['MONGO_URI', 'MONGO_DB'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable MongoDB' },
+            uri: { type: 'string', required: true, description: 'Connection URI' },
+            database: { type: 'string', required: false, description: 'Database name' }
+        },
+        steps: [
+            '1. Install MongoDB or use MongoDB Atlas',
+            '2. Get connection URI',
+            '3. Create database if needed'
+        ]
+    },
+    redis: {
+        name: 'redis',
+        displayName: 'Redis',
+        description: 'In-memory cache and message broker',
+        authType: 'none',
+        docsUrl: 'https://redis.io/docs/',
+        envVars: ['REDIS_HOST', 'REDIS_PORT'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Redis' },
+            host: { type: 'string', required: true, description: 'Redis host' },
+            port: { type: 'number', required: false, description: 'Port (default: 6379)' },
+            password: { type: 'string', required: false, description: 'Redis password (if auth enabled)' }
+        },
+        steps: [
+            '1. Install Redis: https://redis.io/download',
+            '2. Start redis-server',
+            '3. Note host and port'
+        ]
+    },
+    s3: {
+        name: 's3',
+        displayName: 'AWS S3',
+        description: 'Cloud storage - Amazon S3',
+        authType: 'api_key',
+        docsUrl: 'https://docs.aws.amazon.com/s3/',
+        envVars: ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY', 'AWS_REGION', 'AWS_BUCKET'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable S3' },
+            accessKeyId: { type: 'string', required: true, description: 'AWS Access Key' },
+            secretAccessKey: { type: 'string', required: true, description: 'AWS Secret Key' },
+            region: { type: 'string', required: true, description: 'AWS Region' },
+            bucket: { type: 'string', required: true, description: 'S3 Bucket name' }
+        },
+        steps: [
+            '1. Go to AWS Console → IAM → Users',
+            '2. Create user with S3 permissions',
+            '3. Copy Access Key ID and Secret Access Key',
+            '4. Note bucket name and region'
+        ]
+    },
+    azureblob: {
+        name: 'azureblob',
+        displayName: 'Azure Blob Storage',
+        description: 'Cloud storage - Microsoft Azure',
+        authType: 'api_key',
+        docsUrl: 'https://docs.microsoft.com/en-us/azure/storage/',
+        envVars: ['AZURE_STORAGE_ACCOUNT', 'AZURE_STORAGE_KEY', 'AZURE_CONTAINER'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Azure Blob' },
+            accountName: { type: 'string', required: true, description: 'Storage Account Name' },
+            accountKey: { type: 'string', required: true, description: 'Storage Account Key' },
+            container: { type: 'string', required: true, description: 'Container name' }
+        },
+        steps: [
+            '1. Go to Azure Portal → Storage Accounts',
+            '2. Create or select storage account',
+            '3. Go to "Access keys" and copy',
+            '4. Create a blob container'
+        ]
+    },
+    dropbox: {
+        name: 'dropbox',
+        displayName: 'Dropbox',
+        description: 'Cloud storage - Dropbox',
+        authType: 'oauth',
+        docsUrl: 'https://www.dropbox.com/developers',
+        envVars: ['DROPBOX_APP_KEY', 'DROPBOX_APP_SECRET'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Dropbox' },
+            appKey: { type: 'string', required: true, description: 'App Key' },
+            appSecret: { type: 'string', required: true, description: 'App Secret' }
+        },
+        steps: [
+            '1. Go to https://www.dropbox.com/developers/apps',
+            '2. Create app → Scoped access → Full Dropbox',
+            '3. Add redirect URI',
+            '4. Copy App Key and Secret'
+        ]
+    },
+    sendgrid: {
+        name: 'sendgrid',
+        displayName: 'SendGrid',
+        description: 'Email delivery service',
+        authType: 'api_key',
+        docsUrl: 'https://docs.sendgrid.com/',
+        envVars: ['SENDGRID_API_KEY'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable SendGrid' },
+            apiKey: { type: 'string', required: true, description: 'API Key' },
+            fromEmail: { type: 'string', required: true, description: 'Verified sender email' }
+        },
+        steps: [
+            '1. Go to https://sendgrid.com/',
+            '2. Sign up and verify sender',
+            '3. Go to API Keys → Create API Key',
+            '4. Copy the API key'
+        ]
+    },
+    stripe: {
+        name: 'stripe',
+        displayName: 'Stripe',
+        description: 'Payment processing',
+        authType: 'api_key',
+        docsUrl: 'https://stripe.com/docs',
+        envVars: ['STRIPE_SECRET_KEY', 'STRIPE_WEBHOOK_SECRET'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Stripe' },
+            secretKey: { type: 'string', required: true, description: 'Secret Key' },
+            webhookSecret: { type: 'string', required: false, description: 'Webhook Secret' }
+        },
+        steps: [
+            '1. Go to https://dashboard.stripe.com/apikeys',
+            '2. Copy Secret Key (starts with sk_)',
+            '3. For webhooks: go to Webhooks → Add endpoint'
+        ]
+    },
+    anthropic: {
+        name: 'anthropic',
+        displayName: 'Anthropic Claude',
+        description: 'AI Models - Claude',
+        authType: 'api_key',
+        docsUrl: 'https://docs.anthropic.com/',
+        envVars: ['ANTHROPIC_API_KEY'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Anthropic' },
+            apiKey: { type: 'string', required: true, description: 'API Key' }
+        },
+        steps: [
+            '1. Go to https://console.anthropic.com/',
+            '2. Sign up and verify account',
+            '3. Go to API Keys → Create Key',
+            '4. Copy the API key'
+        ]
+    },
+    openai: {
+        name: 'openai',
+        displayName: 'OpenAI',
+        description: 'AI Models - GPT',
+        authType: 'api_key',
+        docsUrl: 'https://platform.openai.com/docs',
+        envVars: ['OPENAI_API_KEY'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable OpenAI' },
+            apiKey: { type: 'string', required: true, description: 'API Key' }
+        },
+        steps: [
+            '1. Go to https://platform.openai.com/api-keys',
+            '2. Create new secret key',
+            '3. Copy the API key'
+        ]
+    },
+    modal: {
+        name: 'modal',
+        displayName: 'Modal',
+        description: 'AI Models - Modal Direct',
+        authType: 'api_key',
+        docsUrl: 'https://modal.com/docs',
+        envVars: ['MODAL_API_KEY'],
+        configSchema: {
+            enabled: { type: 'boolean', required: true, description: 'Enable Modal' },
+            apiKey: { type: 'string', required: true, description: 'API Key' }
+        },
+        steps: [
+            '1. Go to https://modal.com/',
+            '2. Sign up and get API key',
+            '3. Copy from Account Settings'
+        ]
+    }
+};
+class AutoConfigurer {
+    #workspaceDir;
+    #logsDir;
+    constructor() {
+        this.#workspaceDir = '';
+        this.#logsDir = '';
+    }
+    async initialize() {
+        this.#workspaceDir = getWorkspaceDir();
+        this.#logsDir = path.join(this.#workspaceDir, 'auto-config-logs');
+        if (!existsSync(this.#logsDir)) {
+            await mkdir(this.#logsDir, { recursive: true });
+        }
+        void logThought('[AutoConfigurer] Initialized');
+    }
+    listKnownServices() {
+        return Object.values(KNOWN_SERVICES);
+    }
+    getServiceConfig(serviceName) {
+        return KNOWN_SERVICES[serviceName.toLowerCase()];
+    }
+    async fetchDocsAndConfig(serviceName) {
+        const service = KNOWN_SERVICES[serviceName.toLowerCase()];
+        if (!service) {
+            return {
+                config: {},
+                steps: [`Unknown service: ${serviceName}`]
+            };
+        }
+        void logThought(`[AutoConfigurer] Fetching docs for ${serviceName}...`);
+        const config = {
+            enabled: false
+        };
+        for (const [key, schema] of Object.entries(service.configSchema)) {
+            if (key !== 'enabled') {
+                config[key] = '';
+            }
+        }
+        return {
+            config,
+            steps: service.steps
+        };
+    }
+    async saveServiceConfig(serviceName, config) {
+        const service = KNOWN_SERVICES[serviceName.toLowerCase()];
+        if (!service) {
+            return {
+                success: false,
+                service: serviceName,
+                message: `Unknown service: ${serviceName}`
+            };
+        }
+        try {
+            const currentConfig = await readConfig();
+            const integrationConfig = {
+                ...currentConfig.integration || {},
+                [service.name]: config
+            };
+            await writeConfig({
+                ...currentConfig,
+                integration: integrationConfig
+            });
+            await this.#logConfiguration(serviceName, config, 'success');
+            void logThought(`[AutoConfigurer] Saved config for ${serviceName}`);
+            return {
+                success: true,
+                service: serviceName,
+                config,
+                message: `Successfully configured ${service.displayName}`,
+                nextSteps: [
+                    `Restart TwinClaw to activate ${service.displayName}`,
+                    `Test with: twinclaw channels test ${service.name}`
+                ]
+            };
+        }
+        catch (err) {
+            await this.#logConfiguration(serviceName, config, 'failed', err);
+            return {
+                success: false,
+                service: serviceName,
+                message: err instanceof Error ? err.message : String(err)
+            };
+        }
+    }
+    async #logConfiguration(service, config, status, error) {
+        const logFile = path.join(this.#logsDir, `${service}_${Date.now()}.json`);
+        const log = {
+            service,
+            config: { ...config, apiKey: config['apiKey'] ? '***' : undefined },
+            status,
+            error: error?.toString(),
+            timestamp: new Date().toISOString()
+        };
+        await writeFile(logFile, JSON.stringify(log, null, 2), 'utf-8');
+    }
+    async checkConfigurationHealth() {
+        const health = {};
+        for (const [name, service] of Object.entries(KNOWN_SERVICES)) {
+            const issues = [];
+            for (const [key, schema] of Object.entries(service.configSchema)) {
+                if (schema.required && key !== 'enabled') {
+                    issues.push(`Missing required: ${key}`);
+                }
+            }
+            health[name] = {
+                configured: issues.length === 0,
+                issues
+            };
+        }
+        return health;
+    }
+}
+let autoConfigurer = null;
+export function getAutoConfigurer() {
+    if (!autoConfigurer) {
+        autoConfigurer = new AutoConfigurer();
+    }
+    return autoConfigurer;
+}
+export async function initializeAutoConfigurer() {
+    const configurer = getAutoConfigurer();
+    await configurer.initialize();
+}