deepseek-coder-agent-cli 1.0.25

package/dist/bin/selfTest.js

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+/**
+ * Self-Test Runner for AGI CLI
+ *
+ * Launches the CLI in a separate process and runs extensive tests
+ * to verify functionality works correctly in a real runtime environment.
+ *
+ * @license MIT
+ */
+import { spawn } from 'node:child_process';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ComposableMessageBuilder } from '../shell/composableMessage.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PROJECT_DIR = join(__dirname, '../..');
+// ANSI escape codes
+const COLORS = {
+    reset: '\x1b[0m',
+    green: '\x1b[32m',
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    cyan: '\x1b[36m',
+    dim: '\x1b[2m',
+    bold: '\x1b[1m',
+};
+/**
+ * Run all self-tests
+ */
+export async function runSelfTest() {
+    console.log(`\n${COLORS.bold}╔══════════════════════════════════════════════════════════╗${COLORS.reset}`);
+    console.log(`${COLORS.bold}║       AGI CLI SELF-TEST SUITE                            ║${COLORS.reset}`);
+    console.log(`${COLORS.bold}╚══════════════════════════════════════════════════════════╝${COLORS.reset}\n`);
+    const results = [];
+    // Phase 1: Unit tests (fast, in-process)
+    console.log(`${COLORS.cyan}▶ Phase 1: Unit Tests (in-process)${COLORS.reset}\n`);
+    results.push(...await runUnitTests());
+    // Phase 2: CLI launch tests (separate process)
+    console.log(`\n${COLORS.cyan}▶ Phase 2: CLI Runtime Tests (separate process)${COLORS.reset}\n`);
+    results.push(...await runCLITests());
+    // Phase 3: Integration tests (if time permits)
+    console.log(`\n${COLORS.cyan}▶ Phase 3: Integration Tests${COLORS.reset}\n`);
+    results.push(...await runIntegrationTests());
+    // Summary
+    printSummary(results);
+    return results.every(r => r.passed);
+}
+/**
+ * Run unit tests for core modules
+ */
+async function runUnitTests() {
+    const results = [];
+    // Test 1: ComposableMessageBuilder - Paste chips
+    results.push(await runTest('ComposableMessageBuilder: Paste chips', () => {
+        const builder = new ComposableMessageBuilder();
+        const code = 'function test() {\n  return true;\n}';
+        builder.addPaste(code);
+        const chips = builder.formatPasteChips();
+        if (!chips.includes('📝 Code'))
+            throw new Error(`Code not detected: ${chips}`);
+        if (!chips.includes('3L'))
+            throw new Error(`Line count wrong: ${chips}`);
+    }));
+    // Test 5: ComposableMessageBuilder - JSON detection
+    results.push(await runTest('ComposableMessageBuilder: JSON detection', () => {
+        const builder = new ComposableMessageBuilder();
+        builder.addPaste('{\n  "key": "value"\n}');
+        const chips = builder.formatPasteChips();
+        if (!chips.includes('📊 JSON'))
+            throw new Error(`JSON not detected: ${chips}`);
+    }));
+    return results;
+}
+/**
+ * Run CLI tests in separate process
+ */
+async function runCLITests() {
+    const results = [];
+    // Test 1: CLI starts successfully
+    results.push(await runTest('CLI: Starts without errors', async () => {
+        const ctx = await launchCLI();
+        try {
+            await waitForOutput(ctx, /agi|welcome|ready/i, 10000);
+        }
+        finally {
+            await stopCLI(ctx);
+        }
+    }));
+    // Test 2: CLI responds to /help
+    results.push(await runTest('CLI: /help command works', async () => {
+        const ctx = await launchCLI();
+        try {
+            await waitForOutput(ctx, /agi|welcome|ready/i, 10000);
+            ctx.cli?.stdin?.write('/help\n');
+            await waitForOutput(ctx, /command|help|available/i, 5000);
+        }
+        finally {
+            await stopCLI(ctx);
+        }
+    }));
+    // Test 3: CLI handles /clear command
+    results.push(await runTest('CLI: /clear command works', async () => {
+        const ctx = await launchCLI();
+        try {
+            await waitForOutput(ctx, /agi|welcome|ready/i, 10000);
+            ctx.cli?.stdin?.write('/clear\n');
+            await wait(500);
+            // Should not crash
+            if (ctx.errors.toLowerCase().includes('crash') || ctx.errors.toLowerCase().includes('fatal')) {
+                throw new Error(`CLI crashed on /clear: ${ctx.errors}`);
+            }
+        }
+        finally {
+            await stopCLI(ctx);
+        }
+    }));
+    // Test 4: CLI exits cleanly with /exit or Ctrl+D
+    results.push(await runTest('CLI: Graceful shutdown (Ctrl+C/D)', async () => {
+        const ctx = await launchCLI();
+        try {
+            await waitForOutput(ctx, /agi|welcome|ready/i, 10000);
+            // Send Ctrl+C followed by Ctrl+D for graceful shutdown
+            ctx.cli?.stdin?.write('\x03'); // Ctrl+C
+            await wait(300);
+            ctx.cli?.stdin?.write('\x04'); // Ctrl+D
+            // Wait for process to exit
+            await new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    // Force kill if graceful shutdown didn't work - this is acceptable
+                    ctx.cli?.kill('SIGTERM');
+                    resolve();
+                }, 3000);
+                ctx.cli?.on('exit', () => {
+                    clearTimeout(timeout);
+                    resolve();
+                });
+            });
+        }
+        finally {
+            // Already handled
+        }
+    }));
+    return results;
+}
+/**
+ * Run integration tests
+ */
+async function runIntegrationTests() {
+    const results = [];
+    // Test 1: Version flag works
+    results.push(await runTest('Integration: --version flag', async () => {
+        const result = await runCLICommand(['--version']);
+        if (!result.output.includes('agi-cli v')) {
+            throw new Error(`Version not shown: ${result.output}`);
+        }
+    }));
+    // Test 2: Help flag works
+    results.push(await runTest('Integration: --help flag', async () => {
+        const result = await runCLICommand(['--help']);
+        if (!result.output.includes('Usage:')) {
+            throw new Error(`Help not shown: ${result.output}`);
+        }
+    }));
+    // Test 3: Invalid flag handling
+    results.push(await runTest('Integration: Invalid flag handling', async () => {
+        // Should not crash on unknown flags (just pass them through or ignore)
+        const result = await runCLICommand(['--invalid-flag-xyz'], 3000);
+        // Just check it doesn't crash with unhandled exception
+        if (result.errors.includes('unhandled') || result.errors.includes('uncaught')) {
+            throw new Error(`Unhandled exception on invalid flag: ${result.errors}`);
+        }
+    }));
+    return results;
+}
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+async function runTest(name, fn) {
+    const start = Date.now();
+    try {
+        await fn();
+        const duration = Date.now() - start;
+        console.log(`  ${COLORS.green}✓${COLORS.reset} ${name} ${COLORS.dim}(${duration}ms)${COLORS.reset}`);
+        return { name, passed: true, duration };
+    }
+    catch (error) {
+        const duration = Date.now() - start;
+        const message = error instanceof Error ? error.message : String(error);
+        console.log(`  ${COLORS.red}✗${COLORS.reset} ${name} ${COLORS.dim}(${duration}ms)${COLORS.reset}`);
+        console.log(`    ${COLORS.red}${message}${COLORS.reset}`);
+        return { name, passed: false, duration, error: message };
+    }
+}
+async function launchCLI() {
+    const ctx = {
+        cli: null,
+        output: '',
+        errors: '',
+    };
+    const cliPath = join(PROJECT_DIR, 'dist/bin/agi.js');
+    ctx.cli = spawn('node', [cliPath], {
+        cwd: PROJECT_DIR,
+        env: {
+            ...process.env,
+            NO_COLOR: '1',
+            FORCE_COLOR: '0',
+            CI: '1',
+        },
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    ctx.cli.stdout?.on('data', (data) => {
+        ctx.output += data.toString();
+    });
+    ctx.cli.stderr?.on('data', (data) => {
+        ctx.errors += data.toString();
+    });
+    return ctx;
+}
+async function stopCLI(ctx) {
+    if (!ctx.cli)
+        return;
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            ctx.cli?.kill('SIGKILL');
+            resolve();
+        }, 3000);
+        ctx.cli.on('exit', () => {
+            clearTimeout(timeout);
+            resolve();
+        });
+        ctx.cli?.stdin?.write('\x03'); // Ctrl+C
+        setTimeout(() => {
+            ctx.cli?.stdin?.write('\x04'); // Ctrl+D
+        }, 500);
+    });
+}
+async function waitForOutput(ctx, pattern, timeout) {
+    const start = Date.now();
+    return new Promise((resolve, reject) => {
+        const check = () => {
+            if (pattern.test(ctx.output)) {
+                resolve();
+                return;
+            }
+            if (Date.now() - start > timeout) {
+                reject(new Error(`Timeout waiting for pattern ${pattern}. Output: ${ctx.output.slice(-500)}`));
+                return;
+            }
+            setTimeout(check, 100);
+        };
+        check();
+    });
+}
+async function wait(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+async function runCLICommand(args, timeout = 5000) {
+    return new Promise((resolve) => {
+        const cliPath = join(PROJECT_DIR, 'dist/bin/agi.js');
+        let output = '';
+        let errors = '';
+        const proc = spawn('node', [cliPath, ...args], {
+            cwd: PROJECT_DIR,
+            env: { ...process.env, NO_COLOR: '1' },
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const timer = setTimeout(() => {
+            proc.kill('SIGKILL');
+        }, timeout);
+        proc.stdout?.on('data', (data) => { output += data.toString(); });
+        proc.stderr?.on('data', (data) => { errors += data.toString(); });
+        proc.on('exit', (code) => {
+            clearTimeout(timer);
+            resolve({ output, errors, exitCode: code ?? 0 });
+        });
+    });
+}
+function printSummary(results) {
+    const passed = results.filter(r => r.passed).length;
+    const failed = results.filter(r => !r.passed).length;
+    const totalDuration = results.reduce((sum, r) => sum + r.duration, 0);
+    console.log(`\n${COLORS.bold}════════════════════════════════════════════════════════════${COLORS.reset}`);
+    console.log(`${COLORS.bold}  TEST SUMMARY${COLORS.reset}`);
+    console.log(`${COLORS.bold}════════════════════════════════════════════════════════════${COLORS.reset}`);
+    console.log(`  Total:    ${results.length}`);
+    console.log(`  ${COLORS.green}Passed:   ${passed}${COLORS.reset}`);
+    if (failed > 0) {
+        console.log(`  ${COLORS.red}Failed:   ${failed}${COLORS.reset}`);
+    }
+    console.log(`  Duration: ${(totalDuration / 1000).toFixed(2)}s`);
+    console.log();
+    if (failed === 0) {
+        console.log(`${COLORS.green}${COLORS.bold}  ✓ ALL TESTS PASSED${COLORS.reset}\n`);
+    }
+    else {
+        console.log(`${COLORS.red}${COLORS.bold}  ✗ SOME TESTS FAILED${COLORS.reset}`);
+        console.log(`\n  Failed tests:`);
+        for (const r of results.filter(r => !r.passed)) {
+            console.log(`    - ${r.name}: ${r.error}`);
+        }
+        console.log();
+    }
+}
+//# sourceMappingURL=selfTest.js.map

package/dist/bin/selfTest.js.map

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

package/dist/capabilities/baseCapability.d.ts

@@ -0,0 +1,72 @@
+/**
+ * BASE CAPABILITY MODULE - SHARED INFRASTRUCTURE FOR ALL CAPABILITIES
+ *
+ * Provides common utilities, patterns, and infrastructure for all capability modules
+ * to promote code reuse and maintain consistency across the codebase.
+ */
+import type { CapabilityContribution, CapabilityContext, CapabilityModule } from '../runtime/agentHost.js';
+import type { ToolSuite, ToolDefinition } from '../core/toolRuntime.js';
+export interface BaseCapabilityOptions {
+    /** Working directory for operations */
+    workingDir?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Enable evidence collection */
+    enableEvidence?: boolean;
+    /** Authorization level for operations */
+    authorization?: 'basic' | 'elevated' | 'military' | 'full';
+    /** Emergency override capability */
+    emergencyOverride?: boolean;
+}
+export interface OperationResult {
+    success: boolean;
+    timestamp: string;
+    operationId: string;
+    metadata: Record<string, any>;
+    evidence?: string[];
+    errors?: string[];
+}
+export interface EvidenceCollector {
+    collect(data: any, type: string): string;
+    save(fileName: string, content: any): string;
+    cleanup(olderThan?: number): void;
+}
+export interface SecurityContext {
+    hostname: string;
+    username: string;
+    platform: string;
+    architecture: string;
+    os: string;
+    userAgent?: string;
+}
+export declare class SharedUtilities {
+    static generateOperationId(prefix?: string): string;
+    static createEvidenceDir(baseDir: string, operationId: string): string;
+    static saveEvidence(evidenceDir: string, fileName: string, data: any): string;
+    static getSecurityContext(): SecurityContext;
+    static calculateChecksum(data: string | Buffer): string;
+    static validateAuthorization(current: string, required: string): boolean;
+    static createToolDefinition<T extends Record<string, unknown>>(name: string, description: string, parameters: any, handler: (args: T) => Promise<string> | string): ToolDefinition<T>;
+}
+export declare abstract class BaseCapabilityModule implements CapabilityModule {
+    abstract readonly id: string;
+    protected readonly options: BaseCapabilityOptions;
+    protected readonly utilities: SharedUtilities;
+    protected evidenceCollector: EvidenceCollector | null;
+    constructor(options?: BaseCapabilityOptions);
+    abstract create(context: CapabilityContext): Promise<CapabilityContribution>;
+    protected initializeEvidenceCollector(): void;
+    private cleanupOldFiles;
+    protected log(message: string, level?: 'debug' | 'info' | 'warn' | 'error'): void;
+    protected validateOperation(authorizationRequired?: string): boolean;
+    protected createOperationResult(success: boolean, operationId: string, metadata?: Record<string, any>, errors?: string[]): OperationResult;
+}
+export declare class ToolSuiteBuilder {
+    private tools;
+    private id;
+    private description;
+    constructor(id: string, description: string);
+    addTool<T extends Record<string, unknown>>(name: string, description: string, parameters: any, handler: (args: T) => Promise<string> | string): this;
+    build(): ToolSuite;
+}
+//# sourceMappingURL=baseCapability.d.ts.map

package/dist/capabilities/baseCapability.d.ts.map

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

package/dist/capabilities/baseCapability.js

@@ -0,0 +1,183 @@
+/**
+ * BASE CAPABILITY MODULE - SHARED INFRASTRUCTURE FOR ALL CAPABILITIES
+ *
+ * Provides common utilities, patterns, and infrastructure for all capability modules
+ * to promote code reuse and maintain consistency across the codebase.
+ */
+import crypto from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+// ============================================================================
+// SHARED UTILITIES
+// ============================================================================
+export class SharedUtilities {
+    static generateOperationId(prefix = 'op') {
+        const timestamp = Date.now();
+        const random = crypto.randomBytes(4).toString('hex');
+        return `${prefix}_${timestamp}_${random}`;
+    }
+    static createEvidenceDir(baseDir, operationId) {
+        const evidenceDir = path.join(baseDir, 'evidence', operationId);
+        if (!fs.existsSync(evidenceDir)) {
+            fs.mkdirSync(evidenceDir, { recursive: true });
+        }
+        return evidenceDir;
+    }
+    static saveEvidence(evidenceDir, fileName, data) {
+        const filePath = path.join(evidenceDir, fileName);
+        const content = typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+        fs.writeFileSync(filePath, content, 'utf8');
+        return filePath;
+    }
+    static getSecurityContext() {
+        return {
+            hostname: os.hostname(),
+            username: os.userInfo().username,
+            platform: os.platform(),
+            architecture: os.arch(),
+            os: os.type(),
+            userAgent: process.env['USER_AGENT'] || 'AGI-Core/1.0'
+        };
+    }
+    static calculateChecksum(data) {
+        return crypto.createHash('sha256').update(data).digest('hex');
+    }
+    static validateAuthorization(current, required) {
+        const levels = ['basic', 'elevated', 'military', 'full'];
+        const currentIndex = levels.indexOf(current);
+        const requiredIndex = levels.indexOf(required);
+        return currentIndex >= requiredIndex;
+    }
+    static createToolDefinition(name, description, parameters, handler) {
+        return {
+            name,
+            description,
+            parameters,
+            handler
+        };
+    }
+}
+// ============================================================================
+// BASE CAPABILITY CLASS
+// ============================================================================
+export class BaseCapabilityModule {
+    options;
+    utilities;
+    evidenceCollector = null;
+    constructor(options = {}) {
+        this.options = {
+            workingDir: process.cwd(),
+            debug: false,
+            enableEvidence: true,
+            authorization: 'basic',
+            emergencyOverride: false,
+            ...options
+        };
+        this.utilities = SharedUtilities;
+    }
+    initializeEvidenceCollector() {
+        if (this.options.enableEvidence) {
+            this.evidenceCollector = {
+                collect: (data, type) => {
+                    const evidenceDir = SharedUtilities.createEvidenceDir(this.options.workingDir, SharedUtilities.generateOperationId());
+                    const fileName = `${type}_${Date.now()}.json`;
+                    return SharedUtilities.saveEvidence(evidenceDir, fileName, data);
+                },
+                save: (fileName, content) => {
+                    const evidenceDir = SharedUtilities.createEvidenceDir(this.options.workingDir, 'misc');
+                    return SharedUtilities.saveEvidence(evidenceDir, fileName, content);
+                },
+                cleanup: (olderThan) => {
+                    const evidenceDir = path.join(this.options.workingDir, 'evidence');
+                    if (fs.existsSync(evidenceDir)) {
+                        const cutoff = olderThan || (Date.now() - 7 * 24 * 60 * 60 * 1000); // Default: 7 days
+                        this.cleanupOldFiles(evidenceDir, cutoff);
+                    }
+                }
+            };
+        }
+    }
+    cleanupOldFiles(dir, cutoff) {
+        try {
+            const files = fs.readdirSync(dir);
+            for (const file of files) {
+                const filePath = path.join(dir, file);
+                const stat = fs.statSync(filePath);
+                if (stat.isDirectory()) {
+                    this.cleanupOldFiles(filePath, cutoff);
+                }
+                else if (stat.mtimeMs < cutoff) {
+                    fs.unlinkSync(filePath);
+                }
+            }
+        }
+        catch (error) {
+            // Silent fail for cleanup operations
+        }
+    }
+    log(message, level = 'info') {
+        if (this.options.debug || level !== 'debug') {
+            const timestamp = new Date().toISOString();
+            const prefix = `[${timestamp}] [${level.toUpperCase()}] [${this.id}]`;
+            console.log(`${prefix} ${message}`);
+        }
+    }
+    validateOperation(authorizationRequired = 'basic') {
+        if (this.options.emergencyOverride) {
+            return true;
+        }
+        const isValid = SharedUtilities.validateAuthorization(this.options.authorization, authorizationRequired);
+        if (!isValid) {
+            this.log(`Authorization required: ${authorizationRequired}, current: ${this.options.authorization}`, 'warn');
+        }
+        return isValid;
+    }
+    createOperationResult(success, operationId, metadata = {}, errors = []) {
+        const result = {
+            success,
+            timestamp: new Date().toISOString(),
+            operationId,
+            metadata: {
+                ...metadata,
+                securityContext: SharedUtilities.getSecurityContext(),
+                capabilityId: this.id
+            },
+            errors: errors.length > 0 ? errors : undefined
+        };
+        if (this.evidenceCollector && success) {
+            try {
+                const evidencePath = this.evidenceCollector.collect(result, 'operation_result');
+                result.evidence = [evidencePath];
+            }
+            catch (error) {
+                // Evidence collection is optional
+            }
+        }
+        return result;
+    }
+}
+// ============================================================================
+// TOOL SUITE BUILDER
+// ============================================================================
+export class ToolSuiteBuilder {
+    tools = [];
+    id;
+    description;
+    constructor(id, description) {
+        this.id = id;
+        this.description = description;
+    }
+    addTool(name, description, parameters, handler) {
+        this.tools.push(SharedUtilities.createToolDefinition(name, description, parameters, handler));
+        return this;
+    }
+    build() {
+        return {
+            id: this.id,
+            description: this.description,
+            tools: this.tools
+        };
+    }
+}
+//# sourceMappingURL=baseCapability.js.map

package/dist/capabilities/baseCapability.js.map

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

package/dist/capabilities/bashCapability.d.ts

@@ -0,0 +1,13 @@
+import type { CapabilityContribution, CapabilityContext, CapabilityModule } from '../runtime/agentHost.js';
+export interface BashCapabilityOptions {
+    workingDir?: string;
+    id?: string;
+    description?: string;
+}
+export declare class BashCapabilityModule implements CapabilityModule {
+    readonly id = "capability.bash";
+    private readonly options;
+    constructor(options?: BashCapabilityOptions);
+    create(context: CapabilityContext): Promise<CapabilityContribution>;
+}
+//# sourceMappingURL=bashCapability.d.ts.map

package/dist/capabilities/bashCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bashCapability.d.ts","sourceRoot":"","sources":["../../src/capabilities/bashCapability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3G,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,QAAQ,CAAC,EAAE,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAEpC,OAAO,GAAE,qBAA0B;IAIzC,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAe1E"}

package/dist/capabilities/bashCapability.js

@@ -0,0 +1,24 @@
+import { createBashTools } from '../tools/bashTools.js';
+export class BashCapabilityModule {
+    id = 'capability.bash';
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async create(context) {
+        const workingDir = this.options.workingDir ?? context.workingDir;
+        return {
+            id: this.options.id ?? 'bash.tools.shell',
+            description: this.options.description ?? 'Shell execution with stdout/stderr summaries for reproducibility.',
+            toolSuite: {
+                id: 'bash',
+                description: 'Shell access',
+                tools: createBashTools(workingDir),
+            },
+            metadata: {
+                workingDir,
+            },
+        };
+    }
+}
+//# sourceMappingURL=bashCapability.js.map

package/dist/capabilities/bashCapability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bashCapability.js","sourceRoot":"","sources":["../../src/capabilities/bashCapability.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQxD,MAAM,OAAO,oBAAoB;IACtB,EAAE,GAAG,iBAAiB,CAAC;IACf,OAAO,CAAwB;IAEhD,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAA0B;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;QACjE,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,kBAAkB;YACzC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,mEAAmE;YAC5G,SAAS,EAAE;gBACT,EAAE,EAAE,MAAM;gBACV,WAAW,EAAE,cAAc;gBAC3B,KAAK,EAAE,eAAe,CAAC,UAAU,CAAC;aACnC;YACD,QAAQ,EAAE;gBACR,UAAU;aACX;SACF,CAAC;IACJ,CAAC;CACF"}