dexto 1.5.6 → 1.5.7

package/dist/cli/commands/plugin.js

@@ -0,0 +1,376 @@
+/**
+ * Plugin CLI Command Handlers
+ *
+ * Handles CLI commands for plugin management:
+ * - dexto plugin list
+ * - dexto plugin install --path <path>
+ * - dexto plugin uninstall <name>
+ * - dexto plugin validate [path]
+ */
+import { z } from 'zod';
+import chalk from 'chalk';
+import { listInstalledPlugins, installPluginFromPath, uninstallPlugin, validatePluginDirectory, 
+// Marketplace
+addMarketplace, removeMarketplace, updateMarketplace, listMarketplaces, listAllMarketplacePlugins, installPluginFromMarketplace, } from '@dexto/agent-management';
+// === Schema Definitions ===
+const PluginListCommandSchema = z
+    .object({
+    verbose: z.boolean().default(false).describe('Show detailed plugin information'),
+})
+    .strict();
+const PluginInstallCommandSchema = z
+    .object({
+    path: z.string().min(1).describe('Path to the plugin directory'),
+    scope: z.enum(['user', 'project', 'local']).default('user').describe('Installation scope'),
+    force: z.boolean().default(false).describe('Force overwrite if already installed'),
+})
+    .strict();
+const PluginUninstallCommandSchema = z
+    .object({
+    name: z.string().min(1).describe('Name of the plugin to uninstall'),
+})
+    .strict();
+const PluginValidateCommandSchema = z
+    .object({
+    path: z.string().default('.').describe('Path to the plugin directory to validate'),
+})
+    .strict();
+// === Marketplace Command Schemas ===
+const MarketplaceAddCommandSchema = z
+    .object({
+    source: z
+        .string()
+        .min(1)
+        .describe('Marketplace source (owner/repo, git URL, or local path)'),
+    name: z.string().optional().describe('Custom name for the marketplace'),
+})
+    .strict();
+const MarketplaceRemoveCommandSchema = z
+    .object({
+    name: z.string().min(1).describe('Name of the marketplace to remove'),
+})
+    .strict();
+const MarketplaceUpdateCommandSchema = z
+    .object({
+    name: z.string().optional().describe('Name of the marketplace to update (all if omitted)'),
+})
+    .strict();
+const MarketplaceListCommandSchema = z
+    .object({
+    verbose: z.boolean().default(false).describe('Show detailed marketplace information'),
+})
+    .strict();
+const MarketplaceInstallCommandSchema = z
+    .object({
+    plugin: z.string().min(1).describe('Plugin spec: name or name@marketplace'),
+    scope: z.enum(['user', 'project', 'local']).default('user').describe('Installation scope'),
+    force: z.boolean().default(false).describe('Force reinstall if already exists'),
+})
+    .strict();
+// === Command Handlers ===
+/**
+ * Handles the `dexto plugin list` command.
+ * Lists all installed plugins managed by Dexto.
+ */
+export async function handlePluginListCommand(options) {
+    const validated = PluginListCommandSchema.parse(options);
+    const plugins = listInstalledPlugins();
+    if (plugins.length === 0) {
+        console.log(chalk.yellow('No plugins installed.'));
+        console.log('');
+        console.log('Install a plugin with:');
+        console.log(chalk.cyan('  dexto plugin install --path <path-to-plugin>'));
+        return;
+    }
+    console.log(chalk.bold(`Installed Plugins (${plugins.length}):`));
+    console.log('');
+    for (const plugin of plugins) {
+        const sourceLabel = getSourceLabel(plugin.source);
+        const scopeLabel = plugin.scope ? ` [${plugin.scope}]` : '';
+        console.log(`  ${chalk.green(plugin.name)}${chalk.dim('@' + (plugin.version || 'unknown'))} ${sourceLabel}${scopeLabel}`);
+        if (validated.verbose) {
+            if (plugin.description) {
+                console.log(chalk.dim(`    ${plugin.description}`));
+            }
+            console.log(chalk.dim(`    Path: ${plugin.path}`));
+            if (plugin.installedAt) {
+                const date = new Date(plugin.installedAt).toLocaleDateString();
+                console.log(chalk.dim(`    Installed: ${date}`));
+            }
+        }
+    }
+    console.log('');
+}
+/**
+ * Handles the `dexto plugin install --path <path>` command.
+ * Installs a plugin from a local directory.
+ */
+export async function handlePluginInstallCommand(options) {
+    const validated = PluginInstallCommandSchema.parse(options);
+    console.log(chalk.cyan(`Installing plugin from ${validated.path}...`));
+    console.log('');
+    const result = await installPluginFromPath(validated.path, {
+        scope: validated.scope,
+        force: validated.force,
+    });
+    // Show warnings
+    if (result.warnings.length > 0) {
+        console.log(chalk.yellow('Warnings:'));
+        for (const warning of result.warnings) {
+            console.log(chalk.yellow(`  - ${warning}`));
+        }
+        console.log('');
+    }
+    console.log(chalk.green(`Successfully installed plugin '${result.pluginName}'`));
+    console.log(chalk.dim(`  Path: ${result.installPath}`));
+    console.log('');
+}
+/**
+ * Handles the `dexto plugin uninstall <name>` command.
+ * Uninstalls a plugin by name.
+ */
+export async function handlePluginUninstallCommand(options) {
+    const validated = PluginUninstallCommandSchema.parse(options);
+    console.log(chalk.cyan(`Uninstalling plugin '${validated.name}'...`));
+    const result = await uninstallPlugin(validated.name);
+    console.log(chalk.green(`Successfully uninstalled plugin '${validated.name}'`));
+    if (result.removedPath) {
+        console.log(chalk.dim(`  Removed: ${result.removedPath}`));
+    }
+    console.log('');
+}
+/**
+ * Handles the `dexto plugin validate [path]` command.
+ * Validates a plugin directory structure and manifest.
+ */
+export async function handlePluginValidateCommand(options) {
+    const validated = PluginValidateCommandSchema.parse(options);
+    console.log(chalk.cyan(`Validating plugin at ${validated.path}...`));
+    console.log('');
+    const result = validatePluginDirectory(validated.path);
+    if (result.valid) {
+        console.log(chalk.green('Plugin is valid!'));
+        console.log('');
+        if (result.manifest) {
+            console.log(chalk.bold('Manifest:'));
+            console.log(`  Name: ${chalk.green(result.manifest.name)}`);
+            if (result.manifest.description) {
+                console.log(`  Description: ${result.manifest.description}`);
+            }
+            if (result.manifest.version) {
+                console.log(`  Version: ${result.manifest.version}`);
+            }
+            console.log('');
+        }
+    }
+    else {
+        console.log(chalk.red('Plugin validation failed!'));
+        console.log('');
+    }
+    // Show errors
+    if (result.errors.length > 0) {
+        console.log(chalk.red('Errors:'));
+        for (const error of result.errors) {
+            console.log(chalk.red(`  - ${error}`));
+        }
+        console.log('');
+    }
+    // Show warnings
+    if (result.warnings.length > 0) {
+        console.log(chalk.yellow('Warnings:'));
+        for (const warning of result.warnings) {
+            console.log(chalk.yellow(`  - ${warning}`));
+        }
+        console.log('');
+    }
+    // Exit with error code if invalid
+    if (!result.valid) {
+        const errorDetails = result.errors.length > 0 ? `: ${result.errors.join(', ')}` : '';
+        throw new Error(`Plugin validation failed${errorDetails}`);
+    }
+}
+// === Marketplace Command Handlers ===
+/**
+ * Handles the `dexto plugin marketplace add <source>` command.
+ * Adds a new marketplace from GitHub, git URL, or local path.
+ */
+export async function handleMarketplaceAddCommand(options) {
+    const validated = MarketplaceAddCommandSchema.parse(options);
+    console.log(chalk.cyan(`Adding marketplace from ${validated.source}...`));
+    console.log('');
+    const result = await addMarketplace(validated.source, {
+        name: validated.name,
+    });
+    // Show warnings
+    if (result.warnings.length > 0) {
+        console.log(chalk.yellow('Warnings:'));
+        for (const warning of result.warnings) {
+            console.log(chalk.yellow(`  - ${warning}`));
+        }
+        console.log('');
+    }
+    console.log(chalk.green(`Successfully added marketplace '${result.name}'`));
+    console.log(chalk.dim(`  Plugins found: ${result.pluginCount}`));
+    console.log('');
+}
+/**
+ * Handles the `dexto plugin marketplace remove <name>` command.
+ * Removes a registered marketplace.
+ */
+export async function handleMarketplaceRemoveCommand(options) {
+    const validated = MarketplaceRemoveCommandSchema.parse(options);
+    console.log(chalk.cyan(`Removing marketplace '${validated.name}'...`));
+    await removeMarketplace(validated.name);
+    console.log(chalk.green(`Successfully removed marketplace '${validated.name}'`));
+    console.log('');
+}
+/**
+ * Handles the `dexto plugin marketplace update [name]` command.
+ * Updates marketplace(s) by pulling latest from git.
+ */
+export async function handleMarketplaceUpdateCommand(options) {
+    const validated = MarketplaceUpdateCommandSchema.parse(options);
+    if (validated.name) {
+        console.log(chalk.cyan(`Updating marketplace '${validated.name}'...`));
+    }
+    else {
+        console.log(chalk.cyan('Updating all marketplaces...'));
+    }
+    console.log('');
+    const results = await updateMarketplace(validated.name);
+    for (const result of results) {
+        if (result.hasChanges) {
+            console.log(chalk.green(`✓ ${result.name}: Updated`));
+            if (result.previousSha && result.newSha) {
+                console.log(chalk.dim(`    ${result.previousSha.substring(0, 8)} → ${result.newSha.substring(0, 8)}`));
+            }
+        }
+        else {
+            console.log(chalk.dim(`○ ${result.name}: Already up to date`));
+        }
+        // Show warnings
+        if (result.warnings.length > 0) {
+            for (const warning of result.warnings) {
+                console.log(chalk.yellow(`  - ${warning}`));
+            }
+        }
+    }
+    console.log('');
+}
+/**
+ * Handles the `dexto plugin marketplace list` command.
+ * Lists all registered marketplaces.
+ */
+export async function handleMarketplaceListCommand(options) {
+    const validated = MarketplaceListCommandSchema.parse(options);
+    const marketplaces = listMarketplaces();
+    if (marketplaces.length === 0) {
+        console.log(chalk.yellow('No marketplaces registered.'));
+        console.log('');
+        console.log('Add a marketplace with:');
+        console.log(chalk.cyan('  dexto plugin marketplace add <owner/repo>'));
+        console.log('');
+        console.log('Examples:');
+        console.log(chalk.dim('  dexto plugin marketplace add anthropics/claude-plugins-official'));
+        console.log(chalk.dim('  dexto plugin marketplace add https://github.com/user/plugins.git'));
+        console.log(chalk.dim('  dexto plugin marketplace add ~/my-local-plugins'));
+        return;
+    }
+    console.log(chalk.bold(`Registered Marketplaces (${marketplaces.length}):`));
+    console.log('');
+    for (const marketplace of marketplaces) {
+        const sourceType = chalk.dim(`[${marketplace.source.type}]`);
+        console.log(`  ${chalk.green(marketplace.name)} ${sourceType}`);
+        if (validated.verbose) {
+            console.log(chalk.dim(`    Source: ${marketplace.source.value}`));
+            console.log(chalk.dim(`    Path: ${marketplace.installLocation}`));
+            if (marketplace.lastUpdated) {
+                const date = new Date(marketplace.lastUpdated).toLocaleDateString();
+                console.log(chalk.dim(`    Updated: ${date}`));
+            }
+        }
+    }
+    console.log('');
+}
+/**
+ * Handles the `dexto plugin marketplace plugins [name]` command.
+ * Lists plugins available in marketplaces.
+ */
+export async function handleMarketplacePluginsCommand(options) {
+    const plugins = listAllMarketplacePlugins();
+    // Filter by marketplace if specified
+    const filtered = options.marketplace
+        ? plugins.filter((plugin) => plugin.marketplace.toLowerCase() === options.marketplace?.toLowerCase())
+        : plugins;
+    if (filtered.length === 0) {
+        if (options.marketplace) {
+            console.log(chalk.yellow(`No plugins found in marketplace '${options.marketplace}'.`));
+        }
+        else {
+            console.log(chalk.yellow('No plugins found in any marketplace.'));
+            console.log('');
+            console.log('Make sure you have marketplaces registered:');
+            console.log(chalk.cyan('  dexto plugin marketplace list'));
+        }
+        return;
+    }
+    console.log(chalk.bold(`Available Plugins (${filtered.length}):`));
+    console.log('');
+    // Group by marketplace
+    const byMarketplace = new Map();
+    for (const plugin of filtered) {
+        const list = byMarketplace.get(plugin.marketplace) || [];
+        list.push(plugin);
+        byMarketplace.set(plugin.marketplace, list);
+    }
+    for (const [marketplace, marketplacePlugins] of byMarketplace) {
+        console.log(chalk.cyan(`  ${marketplace}:`));
+        for (const plugin of marketplacePlugins) {
+            const version = plugin.version ? chalk.dim(`@${plugin.version}`) : '';
+            const category = plugin.category ? chalk.dim(` [${plugin.category}]`) : '';
+            console.log(`    ${chalk.green(plugin.name)}${version}${category}`);
+            if (options.verbose && plugin.description) {
+                console.log(chalk.dim(`      ${plugin.description}`));
+            }
+        }
+        console.log('');
+    }
+    console.log('Install a plugin with:');
+    console.log(chalk.cyan('  dexto plugin marketplace install <name>@<marketplace>'));
+    console.log('');
+}
+/**
+ * Handles the `dexto plugin marketplace install <plugin>` command.
+ * Installs a plugin from a registered marketplace.
+ */
+export async function handleMarketplaceInstallCommand(options) {
+    const validated = MarketplaceInstallCommandSchema.parse(options);
+    console.log(chalk.cyan(`Installing plugin '${validated.plugin}' from marketplace...`));
+    console.log('');
+    const result = await installPluginFromMarketplace(validated.plugin, {
+        scope: validated.scope,
+        force: validated.force,
+    });
+    // Show warnings
+    if (result.warnings.length > 0) {
+        console.log(chalk.yellow('Warnings:'));
+        for (const warning of result.warnings) {
+            console.log(chalk.yellow(`  - ${warning}`));
+        }
+        console.log('');
+    }
+    console.log(chalk.green(`Successfully installed plugin '${result.pluginName}'`));
+    console.log(chalk.dim(`  Marketplace: ${result.marketplace}`));
+    console.log(chalk.dim(`  Path: ${result.installPath}`));
+    if (result.gitCommitSha) {
+        console.log(chalk.dim(`  Version: ${result.gitCommitSha.substring(0, 8)}`));
+    }
+    console.log('');
+}
+// === Helper Functions ===
+/**
+ * Gets a display label for the plugin source.
+ */
+function getSourceLabel(_source) {
+    return chalk.blue('(dexto)');
+}

package/dist/cli/commands/setup.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 declare const SetupCommandSchema: z.ZodEffects<z.ZodObject<{
-    provider: z.ZodOptional<z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere", "openrouter", "litellm", "glama", "vertex", "bedrock", "local", "ollama"]>>;
+    provider: z.ZodOptional<z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere", "minimax", "glm", "openrouter", "litellm", "glama", "vertex", "bedrock", "local", "ollama", "dexto"]>>;
     model: z.ZodOptional<z.ZodString>;
     defaultAgent: z.ZodDefault<z.ZodString>;
     interactive: z.ZodDefault<z.ZodBoolean>;
@@ -8,31 +8,31 @@ declare const SetupCommandSchema: z.ZodEffects<z.ZodObject<{
     quickStart: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     interactive: boolean;
-    defaultAgent: string;
     force: boolean;
+    defaultAgent: string;
     quickStart: boolean;
-    provider?: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
+    provider?: "dexto" | "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
     model?: string | undefined;
 }, {
     interactive?: boolean | undefined;
-    provider?: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
+    provider?: "dexto" | "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
     model?: string | undefined;
-    defaultAgent?: string | undefined;
     force?: boolean | undefined;
+    defaultAgent?: string | undefined;
     quickStart?: boolean | undefined;
 }>, {
     interactive: boolean;
-    defaultAgent: string;
     force: boolean;
+    defaultAgent: string;
     quickStart: boolean;
-    provider?: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
+    provider?: "dexto" | "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
     model?: string | undefined;
 }, {
     interactive?: boolean | undefined;
-    provider?: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
+    provider?: "dexto" | "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
     model?: string | undefined;
-    defaultAgent?: string | undefined;
     force?: boolean | undefined;
+    defaultAgent?: string | undefined;
     quickStart?: boolean | undefined;
 }>;
 export type CLISetupOptions = z.output<typeof SetupCommandSchema>;

package/dist/cli/commands/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2CxB,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0ClB,CAAC;AAEP,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAClE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAsHtE;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC9F"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8CxB,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0ClB,CAAC;AAEP,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAClE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAsHtE;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC9F"}