sf-aidev 1.0.2 → 1.0.3

package/lib/commands/aidev/add/agent.d.ts

@@ -0,0 +1,57 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Separator } from '@inquirer/prompts';
+import { type InstallResult, type AvailableArtifact } from '../../../services/artifactService.js';
+/**
+ * Result type for single agent installation
+ */
+export type AddAgentResult = InstallResult | AddAgentMultiResult;
+/**
+ * Result type for multiple agent installation (interactive mode)
+ */
+export type AddAgentMultiResult = {
+    installed: InstallResult[];
+    skipped: Array<{
+        name: string;
+    }>;
+    total: number;
+};
+/**
+ * Checkbox choice type for interactive selection
+ */
+type CheckboxChoice = {
+    name: string;
+    value: AvailableArtifact;
+};
+export default class AddAgent extends SfCommand<AddAgentResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly enableJsonFlag = true;
+    static readonly flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        source: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<AddAgentResult>;
+    /**
+     * Prompt user with a multi-select checkbox.
+     * Extracted for test stubbing.
+     */
+    protected promptCheckbox(message: string, choices: Array<CheckboxChoice | Separator>): Promise<AvailableArtifact[]>;
+    /**
+     * Install a single agent by name (non-interactive mode).
+     */
+    private installSingle;
+    /**
+     * Run interactive mode - show checkbox list of available agents.
+     */
+    private runInteractive;
+    /**
+     * Build checkbox choices from available artifacts.
+     */
+    private buildChoices;
+    /**
+     * Report installation results to the user.
+     */
+    private reportResults;
+}
+export {};

package/lib/commands/aidev/add/agent.js

@@ -0,0 +1,168 @@
+/*
+ * Copyright (c) 2024, Yury Bondarau
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ */
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages, SfError } from '@salesforce/core';
+import { ArtifactService } from '../../../services/artifactService.js';
+import { AiDevConfig } from '../../../config/aiDevConfig.js';
+import { isInteractive, promptCheckboxGeneric, CHECKBOX_THEME } from '../../../ui/interactivePrompts.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('sf-aidev', 'aidev.add.agent');
+export default class AddAgent extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static enableJsonFlag = true;
+    static flags = {
+        name: Flags.string({
+            char: 'n',
+            summary: messages.getMessage('flags.name.summary'),
+            required: false,
+        }),
+        source: Flags.string({
+            char: 's',
+            summary: messages.getMessage('flags.source.summary'),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AddAgent);
+        const globalConfig = await AiDevConfig.create({ isGlobal: true });
+        const localConfig = await AiDevConfig.create({ isGlobal: false });
+        const service = new ArtifactService(globalConfig, localConfig, process.cwd());
+        // If name is provided, install directly (non-interactive mode)
+        if (flags.name) {
+            return this.installSingle(service, flags.name, flags.source);
+        }
+        // Interactive mode - name not provided
+        if (!isInteractive()) {
+            throw new SfError(messages.getMessage('error.NonInteractive'), 'NonInteractiveError', [
+                messages.getMessage('error.NonInteractiveActions'),
+            ]);
+        }
+        return this.runInteractive(service, flags.source);
+    }
+    /**
+     * Prompt user with a multi-select checkbox.
+     * Extracted for test stubbing.
+     */
+    // eslint-disable-next-line class-methods-use-this
+    async promptCheckbox(message, choices) {
+        return promptCheckboxGeneric({
+            message,
+            choices,
+            pageSize: 15,
+            theme: CHECKBOX_THEME,
+        });
+    }
+    /**
+     * Install a single agent by name (non-interactive mode).
+     */
+    async installSingle(service, name, source) {
+        const result = await service.install(name, { type: 'agent', source });
+        if (!result.success) {
+            throw new SfError(messages.getMessage('error.InstallFailed', [name, result.error ?? 'Unknown error']), 'InstallError');
+        }
+        this.log(messages.getMessage('info.AgentInstalled', [result.artifact, result.installedPath]));
+        return result;
+    }
+    /**
+     * Run interactive mode - show checkbox list of available agents.
+     */
+    async runInteractive(service, source) {
+        // Ensure a tool is configured
+        const tool = service.getActiveTool();
+        if (!tool) {
+            throw new SfError(messages.getMessage('error.NoTool'), 'NoToolError', [
+                messages.getMessage('error.NoToolActions'),
+            ]);
+        }
+        // Fetch available artifacts filtered to agents only
+        this.spinner.start(messages.getMessage('info.Fetching'));
+        const available = await service.listAvailable({ source, type: 'agent' });
+        this.spinner.stop();
+        // Filter out already installed
+        const notInstalled = available.filter((a) => !a.installed);
+        if (available.length === 0) {
+            this.log(messages.getMessage('info.NoArtifacts'));
+            return { installed: [], skipped: [], total: 0 };
+        }
+        if (notInstalled.length === 0) {
+            this.log(messages.getMessage('info.AllInstalled'));
+            return { installed: [], skipped: [], total: 0 };
+        }
+        // Build choices
+        const choices = this.buildChoices(notInstalled);
+        // Prompt user to select agents
+        const selected = await this.promptCheckbox(messages.getMessage('prompt.Select'), choices);
+        if (selected.length === 0) {
+            this.log(messages.getMessage('info.NoneSelected'));
+            return { installed: [], skipped: [], total: 0 };
+        }
+        // Install selected agents
+        const installed = [];
+        const skipped = [];
+        this.spinner.start(messages.getMessage('info.Installing', [selected.length.toString()]));
+        for (const artifact of selected) {
+            // Double-check if agent was installed in the meantime
+            if (service.isInstalled(artifact.name, 'agent')) {
+                skipped.push({ name: artifact.name });
+                continue;
+            }
+            // eslint-disable-next-line no-await-in-loop
+            const result = await service.install(artifact.name, {
+                type: 'agent',
+                source: artifact.source,
+            });
+            installed.push(result);
+        }
+        this.spinner.stop();
+        // Report results
+        this.reportResults(installed, skipped);
+        return {
+            installed,
+            skipped,
+            total: selected.length,
+        };
+    }
+    /**
+     * Build checkbox choices from available artifacts.
+     */
+    // eslint-disable-next-line class-methods-use-this
+    buildChoices(artifacts) {
+        return artifacts.map((artifact) => {
+            const displayName = artifact.description ? `${artifact.name} - ${artifact.description}` : artifact.name;
+            return {
+                name: displayName,
+                value: artifact,
+            };
+        });
+    }
+    /**
+     * Report installation results to the user.
+     */
+    reportResults(installed, skipped) {
+        const successful = installed.filter((r) => r.success);
+        const failed = installed.filter((r) => !r.success);
+        if (successful.length > 0) {
+            this.log(messages.getMessage('info.Installed', [successful.length.toString()]));
+            for (const result of successful) {
+                this.log(`  - ${result.artifact} -> ${result.installedPath}`);
+            }
+        }
+        if (skipped.length > 0) {
+            this.log(messages.getMessage('info.Skipped', [skipped.length.toString()]));
+            for (const item of skipped) {
+                this.log(`  - ${item.name}`);
+            }
+        }
+        if (failed.length > 0) {
+            this.warn(messages.getMessage('warning.Failed', [failed.length.toString()]));
+            for (const result of failed) {
+                this.log(`  - ${result.artifact}: ${result.error ?? 'Unknown error'}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=agent.js.map

package/lib/commands/aidev/add/agent.js.map

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

package/lib/commands/aidev/add/command.d.ts

@@ -0,0 +1,57 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Separator } from '@inquirer/prompts';
+import { type InstallResult, type AvailableArtifact } from '../../../services/artifactService.js';
+/**
+ * Result type for single command installation
+ */
+export type AddCommandResult = InstallResult | AddCommandMultiResult;
+/**
+ * Result type for multiple command installation (interactive mode)
+ */
+export type AddCommandMultiResult = {
+    installed: InstallResult[];
+    skipped: Array<{
+        name: string;
+    }>;
+    total: number;
+};
+/**
+ * Checkbox choice type for interactive selection
+ */
+type CheckboxChoice = {
+    name: string;
+    value: AvailableArtifact;
+};
+export default class AddCommand extends SfCommand<AddCommandResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly enableJsonFlag = true;
+    static readonly flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        source: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<AddCommandResult>;
+    /**
+     * Prompt user with a multi-select checkbox.
+     * Extracted for test stubbing.
+     */
+    protected promptCheckbox(message: string, choices: Array<CheckboxChoice | Separator>): Promise<AvailableArtifact[]>;
+    /**
+     * Install a single command by name (non-interactive mode).
+     */
+    private installSingle;
+    /**
+     * Run interactive mode - show checkbox list of available commands.
+     */
+    private runInteractive;
+    /**
+     * Build checkbox choices from available artifacts.
+     */
+    private buildChoices;
+    /**
+     * Report installation results to the user.
+     */
+    private reportResults;
+}
+export {};

package/lib/commands/aidev/add/command.js

@@ -0,0 +1,168 @@
+/*
+ * Copyright (c) 2024, Yury Bondarau
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ */
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages, SfError } from '@salesforce/core';
+import { ArtifactService } from '../../../services/artifactService.js';
+import { AiDevConfig } from '../../../config/aiDevConfig.js';
+import { isInteractive, promptCheckboxGeneric, CHECKBOX_THEME } from '../../../ui/interactivePrompts.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('sf-aidev', 'aidev.add.command');
+export default class AddCommand extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static enableJsonFlag = true;
+    static flags = {
+        name: Flags.string({
+            char: 'n',
+            summary: messages.getMessage('flags.name.summary'),
+            required: false,
+        }),
+        source: Flags.string({
+            char: 's',
+            summary: messages.getMessage('flags.source.summary'),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AddCommand);
+        const globalConfig = await AiDevConfig.create({ isGlobal: true });
+        const localConfig = await AiDevConfig.create({ isGlobal: false });
+        const service = new ArtifactService(globalConfig, localConfig, process.cwd());
+        // If name is provided, install directly (non-interactive mode)
+        if (flags.name) {
+            return this.installSingle(service, flags.name, flags.source);
+        }
+        // Interactive mode - name not provided
+        if (!isInteractive()) {
+            throw new SfError(messages.getMessage('error.NonInteractive'), 'NonInteractiveError', [
+                messages.getMessage('error.NonInteractiveActions'),
+            ]);
+        }
+        return this.runInteractive(service, flags.source);
+    }
+    /**
+     * Prompt user with a multi-select checkbox.
+     * Extracted for test stubbing.
+     */
+    // eslint-disable-next-line class-methods-use-this
+    async promptCheckbox(message, choices) {
+        return promptCheckboxGeneric({
+            message,
+            choices,
+            pageSize: 15,
+            theme: CHECKBOX_THEME,
+        });
+    }
+    /**
+     * Install a single command by name (non-interactive mode).
+     */
+    async installSingle(service, name, source) {
+        const result = await service.install(name, { type: 'command', source });
+        if (!result.success) {
+            throw new SfError(messages.getMessage('error.InstallFailed', [name, result.error ?? 'Unknown error']), 'InstallError');
+        }
+        this.log(messages.getMessage('info.CommandInstalled', [result.artifact, result.installedPath]));
+        return result;
+    }
+    /**
+     * Run interactive mode - show checkbox list of available commands.
+     */
+    async runInteractive(service, source) {
+        // Ensure a tool is configured
+        const tool = service.getActiveTool();
+        if (!tool) {
+            throw new SfError(messages.getMessage('error.NoTool'), 'NoToolError', [
+                messages.getMessage('error.NoToolActions'),
+            ]);
+        }
+        // Fetch available artifacts filtered to commands only
+        this.spinner.start(messages.getMessage('info.Fetching'));
+        const available = await service.listAvailable({ source, type: 'command' });
+        this.spinner.stop();
+        // Filter out already installed
+        const notInstalled = available.filter((a) => !a.installed);
+        if (available.length === 0) {
+            this.log(messages.getMessage('info.NoArtifacts'));
+            return { installed: [], skipped: [], total: 0 };
+        }
+        if (notInstalled.length === 0) {
+            this.log(messages.getMessage('info.AllInstalled'));
+            return { installed: [], skipped: [], total: 0 };
+        }
+        // Build choices
+        const choices = this.buildChoices(notInstalled);
+        // Prompt user to select commands
+        const selected = await this.promptCheckbox(messages.getMessage('prompt.Select'), choices);
+        if (selected.length === 0) {
+            this.log(messages.getMessage('info.NoneSelected'));
+            return { installed: [], skipped: [], total: 0 };
+        }
+        // Install selected commands
+        const installed = [];
+        const skipped = [];
+        this.spinner.start(messages.getMessage('info.Installing', [selected.length.toString()]));
+        for (const artifact of selected) {
+            // Double-check if command was installed in the meantime
+            if (service.isInstalled(artifact.name, 'command')) {
+                skipped.push({ name: artifact.name });
+                continue;
+            }
+            // eslint-disable-next-line no-await-in-loop
+            const result = await service.install(artifact.name, {
+                type: 'command',
+                source: artifact.source,
+            });
+            installed.push(result);
+        }
+        this.spinner.stop();
+        // Report results
+        this.reportResults(installed, skipped);
+        return {
+            installed,
+            skipped,
+            total: selected.length,
+        };
+    }
+    /**
+     * Build checkbox choices from available artifacts.
+     */
+    // eslint-disable-next-line class-methods-use-this
+    buildChoices(artifacts) {
+        return artifacts.map((artifact) => {
+            const displayName = artifact.description ? `${artifact.name} - ${artifact.description}` : artifact.name;
+            return {
+                name: displayName,
+                value: artifact,
+            };
+        });
+    }
+    /**
+     * Report installation results to the user.
+     */
+    reportResults(installed, skipped) {
+        const successful = installed.filter((r) => r.success);
+        const failed = installed.filter((r) => !r.success);
+        if (successful.length > 0) {
+            this.log(messages.getMessage('info.Installed', [successful.length.toString()]));
+            for (const result of successful) {
+                this.log(`  - ${result.artifact} -> ${result.installedPath}`);
+            }
+        }
+        if (skipped.length > 0) {
+            this.log(messages.getMessage('info.Skipped', [skipped.length.toString()]));
+            for (const item of skipped) {
+                this.log(`  - ${item.name}`);
+            }
+        }
+        if (failed.length > 0) {
+            this.warn(messages.getMessage('warning.Failed', [failed.length.toString()]));
+            for (const result of failed) {
+                this.log(`  - ${result.artifact}: ${result.error ?? 'Unknown error'}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=command.js.map

package/lib/commands/aidev/add/command.js.map

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

package/lib/commands/aidev/add/prompt.d.ts

@@ -0,0 +1,57 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Separator } from '@inquirer/prompts';
+import { type InstallResult, type AvailableArtifact } from '../../../services/artifactService.js';
+/**
+ * Result type for single prompt installation
+ */
+export type AddPromptResult = InstallResult | AddPromptMultiResult;
+/**
+ * Result type for multiple prompt installation (interactive mode)
+ */
+export type AddPromptMultiResult = {
+    installed: InstallResult[];
+    skipped: Array<{
+        name: string;
+    }>;
+    total: number;
+};
+/**
+ * Checkbox choice type for interactive selection
+ */
+type CheckboxChoice = {
+    name: string;
+    value: AvailableArtifact;
+};
+export default class AddPrompt extends SfCommand<AddPromptResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly enableJsonFlag = true;
+    static readonly flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        source: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<AddPromptResult>;
+    /**
+     * Prompt user with a multi-select checkbox.
+     * Extracted for test stubbing.
+     */
+    protected promptCheckbox(message: string, choices: Array<CheckboxChoice | Separator>): Promise<AvailableArtifact[]>;
+    /**
+     * Install a single prompt by name (non-interactive mode).
+     */
+    private installSingle;
+    /**
+     * Run interactive mode - show checkbox list of available prompts.
+     */
+    private runInteractive;
+    /**
+     * Build checkbox choices from available artifacts.
+     */
+    private buildChoices;
+    /**
+     * Report installation results to the user.
+     */
+    private reportResults;
+}
+export {};