erosolar-cli 1.5.2 → 1.5.4

package/dist/bin/plugins/index.js

@@ -0,0 +1,113 @@
+/**
+ * Plugin System - Root Index
+ *
+ * Aggregates all plugin functionality for easy import.
+ *
+ * Principal Investigator: Bo Shang
+ * Framework: erosolar-cli
+ */
+// Re-export tool plugin system
+export { registerToolPlugin, unregisterToolPlugin, listRegisteredToolPlugins, instantiateToolPlugins, } from './tools/index.js';
+export { registerDefaultNodeToolPlugins } from './tools/nodeDefaults.js';
+// Track loaded plugins
+const loadedPlugins = new Map();
+/**
+ * Register a plugin as loaded
+ */
+export function markPluginLoaded(plugin) {
+    loadedPlugins.set(plugin.id, plugin);
+}
+/**
+ * Get a loaded plugin by ID
+ */
+export function getLoadedPlugin(id) {
+    return loadedPlugins.get(id);
+}
+/**
+ * List all loaded plugins
+ */
+export function listLoadedPlugins() {
+    return Array.from(loadedPlugins.values());
+}
+/**
+ * List available plugins (combines loaded + builtin)
+ */
+export function listAvailablePlugins() {
+    const available = new Set();
+    for (const id of BUILTIN_PLUGINS) {
+        available.add(id);
+    }
+    for (const id of loadedPlugins.keys()) {
+        available.add(id);
+    }
+    return Array.from(available);
+}
+/**
+ * Get all plugin tool suites
+ */
+export function getAllPluginToolSuites() {
+    return listLoadedPlugins().filter((p) => p.enabled);
+}
+/**
+ * Load a plugin by ID
+ */
+export async function loadPlugin(id) {
+    // Check if already loaded
+    const existing = loadedPlugins.get(id);
+    if (existing) {
+        return existing;
+    }
+    // Check if it's a builtin plugin
+    if (!BUILTIN_PLUGINS.includes(id)) {
+        return null;
+    }
+    // Create a loaded plugin entry
+    const plugin = {
+        id,
+        name: id.replace(/-/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase()),
+        version: '1.0.0',
+        enabled: true,
+    };
+    loadedPlugins.set(id, plugin);
+    return plugin;
+}
+/**
+ * Get plugin IDs from command line flags
+ */
+export function getPluginIdsFromFlags(flags) {
+    const ids = [];
+    for (const [flag, enabled] of Object.entries(flags)) {
+        if (enabled && BUILTIN_PLUGINS.includes(flag)) {
+            ids.push(flag);
+        }
+    }
+    return ids;
+}
+/**
+ * Builtin plugin identifiers
+ */
+export const BUILTIN_PLUGINS = [
+    'local-filesystem',
+    'local-bash',
+    'local-search',
+    'edit',
+    'glob',
+    'web',
+    'mcp',
+    'code-analysis',
+    'code-quality',
+    'dependency',
+    'development',
+    'enhanced-git',
+    'interaction',
+    'notebook',
+    'planning',
+    'refactoring',
+    'skills',
+    'task-management',
+    'testing',
+    'agent-spawning',
+    'local-repo-checks',
+    'cloud',
+    'email',
+];

package/dist/bin/plugins/providers/anthropic/index.js

@@ -0,0 +1,25 @@
+import { AnthropicMessagesProvider } from '../../../providers/anthropicProvider.js';
+import { registerProvider } from '../../../providers/providerFactory.js';
+let registered = false;
+export function registerAnthropicProviderPlugin() {
+    if (registered) {
+        return;
+    }
+    registerProvider('anthropic', (config) => {
+        const options = {
+            apiKey: requireEnv('ANTHROPIC_API_KEY'),
+            model: config.model,
+            ...(typeof config.temperature === 'number' ? { temperature: config.temperature } : {}),
+            ...(typeof config.maxTokens === 'number' ? { maxTokens: config.maxTokens } : {}),
+        };
+        return new AnthropicMessagesProvider(options);
+    });
+    registered = true;
+}
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new Error(`Missing required environment variable ${name}.`);
+    }
+    return value;
+}

package/dist/bin/plugins/providers/deepseek/index.js

@@ -0,0 +1,24 @@
+import { OpenAIChatCompletionsProvider } from '../../../providers/openaiChatCompletionsProvider.js';
+import { registerProvider } from '../../../providers/providerFactory.js';
+let registered = false;
+export function registerDeepSeekProviderPlugin() {
+    if (registered) {
+        return;
+    }
+    registerProvider('deepseek', (config) => {
+        return new OpenAIChatCompletionsProvider({
+            apiKey: requireEnv('DEEPSEEK_API_KEY'),
+            model: config.model,
+            baseURL: 'https://api.deepseek.com',
+            providerId: 'deepseek',
+        });
+    });
+    registered = true;
+}
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new Error(`Missing required environment variable ${name}.`);
+    }
+    return value;
+}

package/dist/bin/plugins/providers/google/index.js

@@ -0,0 +1,26 @@
+import { GoogleGenAIProvider } from '../../../providers/googleProvider.js';
+import { registerProvider } from '../../../providers/providerFactory.js';
+let registered = false;
+export function registerGoogleProviderPlugin() {
+    if (registered) {
+        return;
+    }
+    registerProvider('google', (config) => {
+        const options = {
+            apiKey: requireEnv('GEMINI_API_KEY'),
+            model: config.model,
+            providerId: 'google',
+            ...(typeof config.temperature === 'number' ? { temperature: config.temperature } : {}),
+            ...(typeof config.maxTokens === 'number' ? { maxOutputTokens: config.maxTokens } : {}),
+        };
+        return new GoogleGenAIProvider(options);
+    });
+    registered = true;
+}
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new Error(`Missing required environment variable ${name}.`);
+    }
+    return value;
+}

package/dist/bin/plugins/providers/index.js

@@ -0,0 +1,19 @@
+import { registerOpenAIProviderPlugin } from './openai/index.js';
+import { registerAnthropicProviderPlugin } from './anthropic/index.js';
+import { registerDeepSeekProviderPlugin } from './deepseek/index.js';
+import { registerXaiProviderPlugin } from './xai/index.js';
+import { registerGoogleProviderPlugin } from './google/index.js';
+import { registerOllamaProviderPlugin } from './ollama/index.js';
+let defaultsRegistered = false;
+export function registerDefaultProviderPlugins() {
+    if (defaultsRegistered) {
+        return;
+    }
+    registerOpenAIProviderPlugin();
+    registerAnthropicProviderPlugin();
+    registerDeepSeekProviderPlugin();
+    registerXaiProviderPlugin();
+    registerGoogleProviderPlugin();
+    registerOllamaProviderPlugin();
+    defaultsRegistered = true;
+}

package/dist/bin/plugins/providers/ollama/index.js

@@ -0,0 +1,59 @@
+import { OpenAIChatCompletionsProvider } from '../../../providers/openaiChatCompletionsProvider.js';
+import { registerProvider } from '../../../providers/providerFactory.js';
+let registered = false;
+/**
+ * Register Ollama provider plugin.
+ *
+ * Ollama provides an OpenAI-compatible API, so we can reuse the OpenAI provider
+ * with a custom base URL. By default, Ollama runs on http://localhost:11434.
+ */
+export function registerOllamaProviderPlugin() {
+    if (registered) {
+        return;
+    }
+    registerProvider('ollama', (config) => {
+        const baseURL = process.env['OLLAMA_BASE_URL'] || 'http://localhost:11434/v1';
+        const options = {
+            apiKey: 'ollama', // Ollama doesn't require an API key for local instances
+            model: config.model,
+            providerId: 'ollama',
+            baseURL,
+            ...(typeof config.temperature === 'number' ? { temperature: config.temperature } : {}),
+            ...(typeof config.maxTokens === 'number' ? { maxTokens: config.maxTokens } : {}),
+        };
+        return new OpenAIChatCompletionsProvider(options);
+    });
+    registered = true;
+}
+/**
+ * Query available models from local Ollama instance.
+ * Returns an array of model names that are currently available.
+ */
+export async function getAvailableOllamaModels(baseURL = 'http://localhost:11434') {
+    try {
+        const response = await fetch(`${baseURL}/api/tags`);
+        if (!response.ok) {
+            return [];
+        }
+        const data = (await response.json());
+        return data.models?.map((m) => m.name) ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Check if Ollama is running and accessible.
+ */
+export async function isOllamaAvailable(baseURL = 'http://localhost:11434') {
+    try {
+        const response = await fetch(`${baseURL}/api/tags`, {
+            method: 'GET',
+            signal: AbortSignal.timeout(2000), // 2 second timeout
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/bin/plugins/providers/openai/index.js

@@ -0,0 +1,26 @@
+import { OpenAIResponsesProvider } from '../../../providers/openaiResponsesProvider.js';
+import { registerProvider } from '../../../providers/providerFactory.js';
+let registered = false;
+export function registerOpenAIProviderPlugin(providerId = 'openai') {
+    if (registered) {
+        return;
+    }
+    registerProvider(providerId, (config) => {
+        const options = {
+            apiKey: requireEnv('OPENAI_API_KEY'),
+            model: config.model,
+            providerId,
+            ...(config.reasoningEffort ? { reasoningEffort: config.reasoningEffort } : {}),
+            ...(config.textVerbosity ? { textVerbosity: config.textVerbosity } : {}),
+        };
+        return new OpenAIResponsesProvider(options);
+    });
+    registered = true;
+}
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new Error(`Missing required environment variable ${name}.`);
+    }
+    return value;
+}

package/dist/bin/plugins/providers/xai/index.js

@@ -0,0 +1,24 @@
+import { OpenAIChatCompletionsProvider } from '../../../providers/openaiChatCompletionsProvider.js';
+import { registerProvider } from '../../../providers/providerFactory.js';
+let registered = false;
+export function registerXaiProviderPlugin() {
+    if (registered) {
+        return;
+    }
+    registerProvider('xai', (config) => {
+        return new OpenAIChatCompletionsProvider({
+            apiKey: requireEnv('XAI_API_KEY'),
+            model: config.model,
+            baseURL: 'https://api.x.ai/v1',
+            providerId: 'xai',
+        });
+    });
+    registered = true;
+}
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new Error(`Missing required environment variable ${name}.`);
+    }
+    return value;
+}

package/dist/bin/plugins/tools/agentSpawning/agentSpawningPlugin.js

@@ -0,0 +1,8 @@
+import { AgentSpawningCapabilityModule } from '../../../capabilities/agentSpawningCapability.js';
+export function createAgentSpawningToolPlugin() {
+    return {
+        id: 'tool.agent-spawning',
+        targets: ['node', 'cloud'],
+        create: () => new AgentSpawningCapabilityModule(),
+    };
+}

package/dist/bin/plugins/tools/bash/localBashPlugin.js

@@ -0,0 +1,13 @@
+import { BashCapabilityModule } from '../../../capabilities/bashCapability.js';
+export function createLocalBashToolPlugin() {
+    return {
+        id: 'tool.bash.local',
+        description: 'Local bash execution with sandbox awareness.',
+        targets: ['node', 'cloud'],
+        create: (context) => {
+            return new BashCapabilityModule({
+                workingDir: context.workingDir,
+            });
+        },
+    };
+}

package/dist/bin/plugins/tools/checks/localRepoChecksPlugin.js

@@ -0,0 +1,13 @@
+import { RepoChecksCapabilityModule } from '../../../capabilities/repoChecksCapability.js';
+export function createLocalRepoChecksPlugin() {
+    return {
+        id: 'tool.repo-checks.local',
+        description: 'Run npm-based repo checks (test/build/lint) in the sandboxed workspace.',
+        targets: ['node', 'cloud'],
+        create: (context) => {
+            return new RepoChecksCapabilityModule({
+                workingDir: context.workingDir,
+            });
+        },
+    };
+}

package/dist/bin/plugins/tools/cloud/cloudPlugin.js

@@ -0,0 +1,13 @@
+import { CloudCapabilityModule } from '../../../capabilities/cloudCapability.js';
+export function createCloudToolPlugin() {
+    return {
+        id: 'tool.cloud.deployment',
+        description: 'Multi-cloud deployment tools with auto-detection and auto-fix for Firebase, Aliyun, AWS, GCP, Azure, Vercel, Netlify, Cloudflare, and more.',
+        targets: ['node', 'cloud'],
+        create: (context) => {
+            return new CloudCapabilityModule({
+                workingDir: context.workingDir,
+            });
+        },
+    };
+}

package/dist/bin/plugins/tools/codeAnalysis/codeAnalysisPlugin.js

@@ -0,0 +1,13 @@
+import { CodeAnalysisCapabilityModule } from '../../../capabilities/codeAnalysisCapability.js';
+export function createCodeAnalysisToolPlugin() {
+    return {
+        id: 'tool.code-analysis.structural',
+        description: 'Advanced code structure analysis, dependency tracking, and complexity metrics.',
+        targets: ['node'],
+        create: async (context) => {
+            return new CodeAnalysisCapabilityModule({
+                workingDir: context.workingDir,
+            });
+        },
+    };
+}

package/dist/bin/plugins/tools/codeQuality/codeQualityPlugin.js

@@ -0,0 +1,13 @@
+import { CodeQualityCapabilityModule } from '../../../capabilities/codeQualityCapability.js';
+export function createCodeQualityToolPlugin() {
+    return {
+        id: 'tool.code-quality.linting',
+        description: 'Code quality helpers (lint orchestration, rule inspection, maintainability checks).',
+        targets: ['node'],
+        create: async (context) => {
+            return new CodeQualityCapabilityModule({
+                workingDir: context.workingDir,
+            });
+        },
+    };
+}

package/dist/bin/plugins/tools/dependency/dependencyPlugin.js

@@ -0,0 +1,11 @@
+import { DependencySecurityCapabilityModule } from '../../../capabilities/dependencySecurityCapability.js';
+export function createDependencyToolPlugin() {
+    return {
+        id: 'tool.dependency.security',
+        description: 'Dependency analysis, lockfile insights, and npm audit orchestration.',
+        targets: ['node'],
+        create: async (context) => new DependencySecurityCapabilityModule({
+            workingDir: context.workingDir,
+        }),
+    };
+}

package/dist/bin/plugins/tools/development/devPlugin.js

@@ -0,0 +1,13 @@
+import { DevCapabilityModule } from '../../../capabilities/devCapability.js';
+export function createDevToolPlugin() {
+    return {
+        id: 'tool.development.workflow',
+        description: 'Development workflow tools for testing, building, and dependency management.',
+        targets: ['node'],
+        create: async (context) => {
+            return new DevCapabilityModule({
+                workingDir: context.workingDir,
+            });
+        },
+    };
+}

package/dist/bin/plugins/tools/edit/editPlugin.js

@@ -0,0 +1,14 @@
+import { EditCapabilityModule } from '../../../capabilities/editCapability.js';
+/**
+ * Edit Tool Plugin
+ *
+ * Registers the Edit capability for surgical file modifications.
+ * Available in node and cloud runtimes.
+ */
+export function createEditToolPlugin() {
+    return {
+        id: 'tool.edit',
+        targets: ['node', 'cloud'],
+        create: () => new EditCapabilityModule(),
+    };
+}

package/dist/bin/plugins/tools/email/emailPlugin.js

@@ -0,0 +1,11 @@
+import { EmailCapabilityModule } from '../../../capabilities/emailCapability.js';
+export function createEmailToolPlugin() {
+    return {
+        id: 'tool.email.smtp',
+        description: 'Email sending tools via SMTP with support for Gmail, Outlook, and custom providers.',
+        targets: ['node', 'cloud'],
+        create: (_context) => {
+            return new EmailCapabilityModule({});
+        },
+    };
+}

package/dist/bin/plugins/tools/enhancedGit/enhancedGitPlugin.js

@@ -0,0 +1,8 @@
+import { EnhancedGitCapabilityModule } from '../../../capabilities/enhancedGitCapability.js';
+export function createEnhancedGitToolPlugin() {
+    return {
+        id: 'tool.enhanced-git',
+        targets: ['node', 'cloud'],
+        create: () => new EnhancedGitCapabilityModule(),
+    };
+}

package/dist/bin/plugins/tools/filesystem/localFilesystemPlugin.js

@@ -0,0 +1,13 @@
+import { FilesystemCapabilityModule } from '../../../capabilities/filesystemCapability.js';
+export function createLocalFilesystemToolPlugin() {
+    return {
+        id: 'tool.filesystem.local',
+        description: 'Local file system access for Node/Cloud runtimes.',
+        targets: ['node', 'cloud'],
+        create: (context) => {
+            return new FilesystemCapabilityModule({
+                workingDir: context.workingDir,
+            });
+        },
+    };
+}

package/dist/bin/plugins/tools/glob/globPlugin.js

@@ -0,0 +1,14 @@
+import { GlobCapabilityModule } from '../../../capabilities/globCapability.js';
+/**
+ * Glob Tool Plugin
+ *
+ * Registers fast file pattern matching capabilities.
+ * Available in node and cloud runtimes.
+ */
+export function createGlobToolPlugin() {
+    return {
+        id: 'tool.glob',
+        targets: ['node', 'cloud'],
+        create: () => new GlobCapabilityModule(),
+    };
+}

package/dist/bin/plugins/tools/index.js

@@ -0,0 +1,2 @@
+export { registerToolPlugin, unregisterToolPlugin, listRegisteredToolPlugins, instantiateToolPlugins, } from './registry.js';
+export { registerDefaultNodeToolPlugins } from './nodeDefaults.js';

package/dist/bin/plugins/tools/interaction/interactionPlugin.js

@@ -0,0 +1,11 @@
+import { InteractionCapabilityModule } from '../../../capabilities/interactionCapability.js';
+export function createInteractionToolPlugin() {
+    return {
+        id: 'tool.interaction.local',
+        description: 'Interactive question and clarification tools for gathering user preferences.',
+        targets: ['node', 'cloud'],
+        create: (_context) => {
+            return new InteractionCapabilityModule({});
+        },
+    };
+}

package/dist/bin/plugins/tools/learn/learnPlugin.js

@@ -0,0 +1,13 @@
+import { LearnCapabilityModule } from '../../../capabilities/learnCapability.js';
+export function createLearnToolPlugin() {
+    return {
+        id: 'tool.learn.exploration',
+        description: 'Core codebase exploration and learning tools for understanding project structure, patterns, and conventions without external APIs.',
+        targets: ['node', 'cloud'],
+        create: async (context) => {
+            return new LearnCapabilityModule({
+                workingDir: context.workingDir,
+            });
+        },
+    };
+}

package/dist/bin/plugins/tools/mcp/mcpPlugin.js

@@ -0,0 +1,8 @@
+import { McpCapabilityModule } from '../../../capabilities/mcpCapability.js';
+export function createMcpToolPlugin() {
+    return {
+        id: 'tool.mcp.bridge',
+        targets: ['node'],
+        create: () => new McpCapabilityModule(),
+    };
+}

package/dist/bin/plugins/tools/nodeDefaults.js

@@ -0,0 +1,56 @@
+import { registerToolPlugin } from './registry.js';
+import { createLocalFilesystemToolPlugin } from './filesystem/localFilesystemPlugin.js';
+import { createEditToolPlugin } from './edit/editPlugin.js';
+import { createNotebookToolPlugin } from './notebook/notebookPlugin.js';
+import { createLocalSearchToolPlugin } from './search/localSearchPlugin.js';
+import { createGlobToolPlugin } from './glob/globPlugin.js';
+import { createLocalBashToolPlugin } from './bash/localBashPlugin.js';
+import { createLocalRepoChecksPlugin } from './checks/localRepoChecksPlugin.js';
+import { createCodeAnalysisToolPlugin } from './codeAnalysis/codeAnalysisPlugin.js';
+import { createDevToolPlugin } from './development/devPlugin.js';
+import { createCodeQualityToolPlugin } from './codeQuality/codeQualityPlugin.js';
+import { createRefactoringToolPlugin } from './refactoring/refactoringPlugin.js';
+import { createDependencyToolPlugin } from './dependency/dependencyPlugin.js';
+import { createTestingToolPlugin } from './testing/testingPlugin.js';
+import { createTaskManagementToolPlugin } from './taskManagement/taskManagementPlugin.js';
+import { createPlanningToolPlugin } from './planning/planningPlugin.js';
+import { createInteractionToolPlugin } from './interaction/interactionPlugin.js';
+import { createWebToolPlugin } from './web/webPlugin.js';
+import { createAgentSpawningToolPlugin } from './agentSpawning/agentSpawningPlugin.js';
+import { createEnhancedGitToolPlugin } from './enhancedGit/enhancedGitPlugin.js';
+import { createSkillToolPlugin } from './skills/skillPlugin.js';
+import { createMcpToolPlugin } from './mcp/mcpPlugin.js';
+import { createLearnToolPlugin } from './learn/learnPlugin.js';
+import { createEmailToolPlugin } from './email/emailPlugin.js';
+import { createCloudToolPlugin } from './cloud/cloudPlugin.js';
+let registered = false;
+export function registerDefaultNodeToolPlugins() {
+    if (registered) {
+        return;
+    }
+    registerToolPlugin(createLocalFilesystemToolPlugin());
+    registerToolPlugin(createEditToolPlugin());
+    registerToolPlugin(createNotebookToolPlugin());
+    registerToolPlugin(createLocalSearchToolPlugin());
+    registerToolPlugin(createGlobToolPlugin());
+    registerToolPlugin(createLearnToolPlugin());
+    registerToolPlugin(createLocalBashToolPlugin());
+    registerToolPlugin(createLocalRepoChecksPlugin());
+    registerToolPlugin(createCodeAnalysisToolPlugin());
+    registerToolPlugin(createDevToolPlugin());
+    registerToolPlugin(createCodeQualityToolPlugin());
+    registerToolPlugin(createRefactoringToolPlugin());
+    registerToolPlugin(createDependencyToolPlugin());
+    registerToolPlugin(createTestingToolPlugin());
+    registerToolPlugin(createTaskManagementToolPlugin());
+    registerToolPlugin(createPlanningToolPlugin());
+    registerToolPlugin(createInteractionToolPlugin());
+    registerToolPlugin(createWebToolPlugin());
+    registerToolPlugin(createAgentSpawningToolPlugin());
+    registerToolPlugin(createEnhancedGitToolPlugin());
+    registerToolPlugin(createSkillToolPlugin());
+    registerToolPlugin(createMcpToolPlugin());
+    registerToolPlugin(createEmailToolPlugin());
+    registerToolPlugin(createCloudToolPlugin());
+    registered = true;
+}

package/dist/bin/plugins/tools/notebook/notebookPlugin.js

@@ -0,0 +1,14 @@
+import { NotebookCapabilityModule } from '../../../capabilities/notebookCapability.js';
+/**
+ * Notebook Tool Plugin
+ *
+ * Registers Jupyter notebook editing capabilities.
+ * Available in node and cloud runtimes.
+ */
+export function createNotebookToolPlugin() {
+    return {
+        id: 'tool.notebook',
+        targets: ['node', 'cloud'],
+        create: () => new NotebookCapabilityModule(),
+    };
+}

package/dist/bin/plugins/tools/planning/planningPlugin.js

@@ -0,0 +1,14 @@
+import { PlanningCapabilityModule } from '../../../capabilities/planningCapability.js';
+/**
+ * Planning Tool Plugin
+ *
+ * Registers workflow planning capabilities.
+ * Available in node and cloud runtimes.
+ */
+export function createPlanningToolPlugin() {
+    return {
+        id: 'tool.planning',
+        targets: ['node', 'cloud'],
+        create: () => new PlanningCapabilityModule(),
+    };
+}

package/dist/bin/plugins/tools/refactoring/refactoringPlugin.js

@@ -0,0 +1,11 @@
+import { RefactoringCapabilityModule } from '../../../capabilities/refactoringCapability.js';
+export function createRefactoringToolPlugin() {
+    return {
+        id: 'tool.refactoring.assistant',
+        description: 'Refactoring intelligence (hotspot detection, impact studies, plan generation).',
+        targets: ['node'],
+        create: async (context) => new RefactoringCapabilityModule({
+            workingDir: context.workingDir,
+        }),
+    };
+}