@andrebuzeli/git-mcp 5.0.4 → 5.0.6

package/dist/utils/response-formatter.js

@@ -0,0 +1,378 @@
+"use strict";
+/**
+ * Response Formatter
+ *
+ * Utility for formatting consistent responses across all Git MCP tools.
+ * Provides standardized success/error response formats with metadata.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.responseFormatter = exports.ResponseFormatter = void 0;
+class ResponseFormatter {
+    defaultOptions = {
+        includeMetadata: true,
+        includeTimestamp: true,
+        includeExecutionTime: true,
+        maxDataSize: 10000, // 10KB
+        truncateData: true
+    };
+    /**
+     * Format successful response
+     */
+    success(data, metadata, options = {}) {
+        const mergedOptions = { ...this.defaultOptions, ...options };
+        // Process data size if needed
+        let processedData = data;
+        if (mergedOptions.truncateData && mergedOptions.maxDataSize) {
+            processedData = this.truncateDataIfNeeded(data, mergedOptions.maxDataSize);
+        }
+        const result = {
+            success: true,
+            data: processedData
+        };
+        if (mergedOptions.includeMetadata) {
+            result.metadata = {
+                operation: metadata.operation,
+                timestamp: mergedOptions.includeTimestamp ? new Date().toISOString() : '',
+                executionTime: mergedOptions.includeExecutionTime ? (metadata.executionTime || 0) : 0
+            };
+            if (metadata.provider)
+                result.metadata.provider = metadata.provider;
+            if (metadata.toolName)
+                result.metadata.toolName = metadata.toolName;
+            if (metadata.projectPath)
+                result.metadata.projectPath = metadata.projectPath;
+            if (metadata.repositoryName)
+                result.metadata.repositoryName = metadata.repositoryName;
+        }
+        return result;
+    }
+    /**
+     * Format error response
+     */
+    error(code, message, details, metadata, options = {}) {
+        const mergedOptions = { ...this.defaultOptions, ...options };
+        const result = {
+            success: false,
+            error: {
+                code,
+                message,
+                details,
+                suggestions: this.generateSuggestions(code, message, details)
+            }
+        };
+        // Add configuration guide for specific error types
+        const configGuide = this.generateConfigurationGuide(code, details);
+        if (configGuide) {
+            result.error.configurationGuide = configGuide;
+        }
+        if (mergedOptions.includeMetadata && metadata) {
+            result.metadata = {
+                operation: metadata.operation,
+                timestamp: mergedOptions.includeTimestamp ? new Date().toISOString() : '',
+                executionTime: mergedOptions.includeExecutionTime ? (metadata.executionTime || 0) : 0
+            };
+            if (metadata.provider)
+                result.metadata.provider = metadata.provider;
+            if (metadata.toolName)
+                result.metadata.toolName = metadata.toolName;
+            if (metadata.projectPath)
+                result.metadata.projectPath = metadata.projectPath;
+            if (metadata.repositoryName)
+                result.metadata.repositoryName = metadata.repositoryName;
+        }
+        return result;
+    }
+    /**
+     * Format validation error response
+     */
+    validationError(parameter, expectedFormat, actualValue, metadata) {
+        return this.error('VALIDATION_ERROR', `Invalid parameter: ${parameter}`, {
+            parameter,
+            expectedFormat,
+            actualValue,
+            example: this.generateParameterExample(parameter, expectedFormat)
+        }, metadata);
+    }
+    /**
+     * Format configuration error response
+     */
+    configurationError(missingConfig, provider, metadata) {
+        const providerText = provider ? ` for ${provider}` : '';
+        return this.error('CONFIGURATION_ERROR', `Missing required configuration${providerText}`, {
+            missingConfig,
+            provider
+        }, metadata);
+    }
+    /**
+     * Format Git error response
+     */
+    gitError(gitErrorType, gitMessage, command, metadata) {
+        return this.error(`GIT_${gitErrorType.toUpperCase()}`, `Git error: ${gitMessage}`, {
+            gitErrorType,
+            command,
+            workingDirectory: metadata?.projectPath
+        }, metadata);
+    }
+    /**
+     * Format provider error response
+     */
+    providerError(provider, apiError, statusCode, metadata) {
+        return this.error('PROVIDER_ERROR', `${provider} API error: ${apiError}`, {
+            provider,
+            statusCode,
+            apiError
+        }, metadata);
+    }
+    /**
+     * Format operation not supported error
+     */
+    operationNotSupported(operation, supportedOperations, toolName) {
+        return this.error('OPERATION_NOT_SUPPORTED', `Operation '${operation}' is not supported`, {
+            operation,
+            supportedOperations,
+            toolName
+        }, {
+            operation: 'validate_operation',
+            toolName
+        });
+    }
+    /**
+     * Format partial success response (for multi-provider operations)
+     */
+    partialSuccess(successResults, failedResults, metadata) {
+        const totalProviders = metadata.providers.length;
+        const successCount = successResults.length;
+        const failureCount = failedResults.length;
+        return {
+            success: successCount > 0, // Partial success if at least one succeeded
+            data: {
+                results: successResults,
+                summary: {
+                    total: totalProviders,
+                    successful: successCount,
+                    failed: failureCount,
+                    successRate: Math.round((successCount / totalProviders) * 100)
+                }
+            },
+            error: failureCount > 0 ? {
+                code: 'PARTIAL_FAILURE',
+                message: `${failureCount} out of ${totalProviders} providers failed`,
+                details: {
+                    failedResults,
+                    failedProviders: failedResults.map((r) => r.provider)
+                },
+                suggestions: [
+                    'Check failed provider configurations',
+                    'Verify network connectivity',
+                    'Review provider-specific error messages'
+                ]
+            } : undefined,
+            metadata: {
+                operation: metadata.operation,
+                timestamp: new Date().toISOString(),
+                executionTime: metadata.executionTime || 0,
+                toolName: metadata.toolName,
+                provider: metadata.providers.join(', ')
+            }
+        };
+    }
+    /**
+     * Format list response with pagination info
+     */
+    listResponse(items, pagination, metadata) {
+        const data = {
+            items,
+            count: items.length
+        };
+        if (pagination) {
+            data.pagination = pagination;
+        }
+        return this.success(data, metadata || { operation: 'list' });
+    }
+    /**
+     * Format status response
+     */
+    statusResponse(status, details, metadata) {
+        return this.success({
+            status,
+            details,
+            timestamp: new Date().toISOString()
+        }, metadata || { operation: 'status' });
+    }
+    /**
+     * Generate suggestions based on error code and message
+     */
+    generateSuggestions(code, message, details) {
+        const suggestions = [];
+        switch (code) {
+            case 'VALIDATION_ERROR':
+                suggestions.push('Check parameter format and try again');
+                suggestions.push('Refer to tool documentation for parameter examples');
+                break;
+            case 'CONFIGURATION_ERROR':
+                suggestions.push('Set required environment variables');
+                suggestions.push('Check configuration guide in error details');
+                break;
+            case 'GIT_NOT_A_REPOSITORY':
+                suggestions.push('Initialize Git repository with: git init');
+                suggestions.push('Ensure you are in the correct directory');
+                break;
+            case 'GIT_COMMAND_NOT_FOUND':
+                suggestions.push('Install Git from https://git-scm.com/');
+                suggestions.push('Ensure Git is in your system PATH');
+                break;
+            case 'PROVIDER_ERROR':
+                suggestions.push('Check API credentials and permissions');
+                suggestions.push('Verify network connectivity');
+                if (details?.statusCode === 401) {
+                    suggestions.push('Verify authentication token is valid');
+                }
+                if (details?.statusCode === 403) {
+                    suggestions.push('Check repository permissions');
+                }
+                if (details?.statusCode === 404) {
+                    suggestions.push('Verify repository exists and is accessible');
+                }
+                break;
+            case 'OPERATION_NOT_SUPPORTED':
+                suggestions.push('Use one of the supported operations listed in details');
+                suggestions.push('Check tool documentation for available operations');
+                break;
+            default:
+                suggestions.push('Check error details for more information');
+                suggestions.push('Retry the operation after addressing the issue');
+        }
+        return suggestions;
+    }
+    /**
+     * Generate configuration guide for specific errors
+     */
+    generateConfigurationGuide(code, details) {
+        if (code === 'CONFIGURATION_ERROR') {
+            const provider = details?.provider;
+            if (provider === 'github') {
+                return {
+                    requiredEnvVars: ['GITHUB_TOKEN', 'GITHUB_USERNAME'],
+                    exampleConfig: {
+                        GITHUB_TOKEN: 'ghp_xxxxxxxxxxxxxxxxxxxx',
+                        GITHUB_USERNAME: 'your-github-username'
+                    }
+                };
+            }
+            if (provider === 'gitea') {
+                return {
+                    requiredEnvVars: ['GITEA_URL', 'GITEA_TOKEN', 'GITEA_USERNAME'],
+                    exampleConfig: {
+                        GITEA_URL: 'https://gitea.example.com',
+                        GITEA_TOKEN: 'your-gitea-token',
+                        GITEA_USERNAME: 'your-gitea-username'
+                    }
+                };
+            }
+            // Multi-provider configuration
+            return {
+                requiredEnvVars: [
+                    'GITHUB_TOKEN', 'GITHUB_USERNAME',
+                    'GITEA_URL', 'GITEA_TOKEN', 'GITEA_USERNAME'
+                ],
+                exampleConfig: {
+                    github: {
+                        GITHUB_TOKEN: 'ghp_xxxxxxxxxxxxxxxxxxxx',
+                        GITHUB_USERNAME: 'your-github-username'
+                    },
+                    gitea: {
+                        GITEA_URL: 'https://gitea.example.com',
+                        GITEA_TOKEN: 'your-gitea-token',
+                        GITEA_USERNAME: 'your-gitea-username'
+                    }
+                }
+            };
+        }
+        return undefined;
+    }
+    /**
+     * Generate parameter example based on parameter name and expected format
+     */
+    generateParameterExample(parameter, expectedFormat) {
+        const examples = {
+            projectPath: '/path/to/your/project',
+            provider: 'github | gitea | both',
+            action: 'create | list | get | update | delete',
+            repositoryName: 'my-repository',
+            branchName: 'feature/new-feature',
+            commitMessage: 'Add new feature',
+            tagName: 'v1.0.0',
+            issueNumber: 123,
+            pullRequestNumber: 456,
+            fileName: 'src/index.ts',
+            content: 'file content here',
+            title: 'Issue or PR title',
+            description: 'Detailed description',
+            labels: ['bug', 'enhancement'],
+            assignees: ['username1', 'username2']
+        };
+        return examples[parameter] || `<${expectedFormat}>`;
+    }
+    /**
+     * Truncate data if it exceeds maximum size
+     */
+    truncateDataIfNeeded(data, maxSize) {
+        const dataString = JSON.stringify(data);
+        if (dataString.length <= maxSize) {
+            return data;
+        }
+        // If data is too large, truncate and add indicator
+        const truncatedString = dataString.substring(0, maxSize - 100);
+        try {
+            // Try to parse truncated JSON (might be invalid)
+            return JSON.parse(truncatedString);
+        }
+        catch {
+            // If truncated JSON is invalid, return summary
+            return {
+                _truncated: true,
+                _originalSize: dataString.length,
+                _maxSize: maxSize,
+                _summary: this.generateDataSummary(data),
+                _note: 'Data was truncated due to size limits'
+            };
+        }
+    }
+    /**
+     * Generate summary of data structure
+     */
+    generateDataSummary(data) {
+        if (Array.isArray(data)) {
+            return {
+                type: 'array',
+                length: data.length,
+                sampleItems: data.slice(0, 3),
+                hasMore: data.length > 3
+            };
+        }
+        if (typeof data === 'object' && data !== null) {
+            const keys = Object.keys(data);
+            const summary = {
+                type: 'object',
+                keys: keys.slice(0, 10),
+                hasMoreKeys: keys.length > 10
+            };
+            // Include sample values for first few keys
+            for (let i = 0; i < Math.min(3, keys.length); i++) {
+                const key = keys[i];
+                summary[key] = typeof data[key] === 'object'
+                    ? `[${typeof data[key]}]`
+                    : data[key];
+            }
+            return summary;
+        }
+        return {
+            type: typeof data,
+            value: String(data).substring(0, 100)
+        };
+    }
+}
+exports.ResponseFormatter = ResponseFormatter;
+// Export singleton instance
+exports.responseFormatter = new ResponseFormatter();
+//# sourceMappingURL=response-formatter.js.map

package/dist/utils/response-formatter.js.map

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

package/dist/utils/retry.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Simple retry helper with exponential backoff.
+ */
+export interface RetryOptions {
+    retries?: number;
+    factor?: number;
+    minTimeout?: number;
+    maxTimeout?: number;
+    retryOn?: (err: any) => boolean;
+}
+export declare function retry<T>(fn: () => Promise<T>, opts?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;CACjC;AAED,wBAAsB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CA0BxF"}

package/dist/utils/retry.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retry = retry;
+async function retry(fn, opts = {}) {
+    const retries = typeof opts.retries === 'number' ? opts.retries : 3;
+    const factor = opts.factor || 2;
+    const minTimeout = opts.minTimeout || 200;
+    const maxTimeout = opts.maxTimeout || 5000;
+    const retryOn = opts.retryOn || ((err) => true);
+    let attempt = 0;
+    let lastError = null;
+    while (attempt <= retries) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+            if (attempt === retries || !retryOn(err)) {
+                break;
+            }
+            const wait = Math.min(maxTimeout, Math.round(minTimeout * Math.pow(factor, attempt)));
+            await new Promise((resolve) => setTimeout(resolve, wait));
+            attempt += 1;
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":";;AAWA,sBA0BC;AA1BM,KAAK,UAAU,KAAK,CAAI,EAAoB,EAAE,OAAqB,EAAE;IAC1E,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAErD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,SAAS,GAAQ,IAAI,CAAC;IAE1B,OAAO,OAAO,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAG,CAAC;YAChB,IAAI,OAAO,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM;YACR,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YACtF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/dist/utils/terminal-controller.d.ts

@@ -1,145 +1,79 @@
 /**
- * Controller para execução de comandos no terminal
- * Fornece interface padronizada para executar comandos Git e outros
+ * Terminal Controller
+ *
+ * Handles terminal command execution with proper error handling,
+ * timeout management, and cross-platform compatibility.
  */
-export interface TerminalCommand {
+export interface CommandResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    executionTime: number;
     command: string;
-    is_background: boolean;
-    explanation: string;
 }
-export interface TerminalResult {
-    exitCode: number;
-    output: string;
-    error: string;
+export interface CommandOptions {
+    cwd?: string;
+    timeout?: number;
+    env?: Record<string, string>;
+    shell?: boolean;
+    encoding?: BufferEncoding;
 }
-/**
- * Executa um comando no terminal
- *
- * @param params Parâmetros do comando
- * @returns Promise com resultado da execução
- */
-export declare function runTerminalCmd(params: TerminalCommand & {
-    projectPath?: string;
-}): Promise<TerminalResult>;
-/**
- * Executa comando Git usando GitOperations - 100% auto-suficiente
- *
- * @param gitCommand Comando Git a executar
- * @param projectPath Caminho do projeto
- * @param explanation Explicação do comando
- * @returns Promise com resultado
- */
-export declare function runGitCommand(gitCommand: string, projectPath: string, explanation: string): Promise<TerminalResult>;
-/**
- * Verifica se um diretório é um repositório Git - 100% auto-suficiente
- *
- * @param projectPath Caminho do projeto
- * @returns Promise<boolean>
- */
-export declare function isGitRepository(projectPath: string): Promise<boolean>;
-/**
- * Obtém status do repositório Git - 100% auto-suficiente
- *
- * @param projectPath Caminho do projeto
- * @returns Promise<TerminalResult>
- */
-export declare function getGitStatus(projectPath: string): Promise<TerminalResult>;
-/**
- * Adiciona arquivos ao stage - 100% auto-suficiente
- *
- * @param projectPath Caminho do projeto
- * @param files Arquivos específicos ou '.' para todos
- * @returns Promise<TerminalResult>
- */
-export declare function gitAdd(projectPath: string, files?: string): Promise<TerminalResult>;
-/**
- * Faz commit dos arquivos staged - 100% auto-suficiente
- *
- * @param projectPath Caminho do projeto
- * @param message Mensagem do commit
- * @returns Promise<TerminalResult>
- */
-export declare function gitCommit(projectPath: string, message: string): Promise<TerminalResult>;
-/**
- * Faz push para o repositório remoto - 100% auto-suficiente
- *
- * @param projectPath Caminho do projeto
- * @param branch Branch para fazer push
- * @param remote Remote (padrão: origin)
- * @returns Promise<TerminalResult>
- */
-export declare function gitPush(projectPath: string, branch?: string, remote?: string): Promise<TerminalResult>;
-/**
- * Faz pull do repositório remoto - 100% auto-suficiente
- *
- * @param projectPath Caminho do projeto
- * @param branch Branch para fazer pull
- * @param remote Remote (padrão: origin)
- * @returns Promise<TerminalResult>
- */
-export declare function gitPull(projectPath: string, branch?: string, remote?: string): Promise<TerminalResult>;
-/**
- * Inicializa um repositório Git
- *
- * @param projectPath Caminho do projeto
- * @param branch Branch inicial (padrão: main)
- * @returns Promise<TerminalResult>
- */
-export declare function gitInit(projectPath: string, branch?: string): Promise<TerminalResult>;
-/**
- * Obtém o branch atual
- *
- * @param projectPath Caminho do projeto
- * @returns Promise<string>
- */
-export declare function getCurrentBranch(projectPath: string): Promise<string>;
-/**
- * Obtém os remotes configurados
- *
- * @param projectPath Caminho do projeto
- * @returns Promise<string>
- */
-export declare function getRemotes(projectPath: string): Promise<string>;
-/**
- * Obtém o último commit
- *
- * @param projectPath Caminho do projeto
- * @returns Promise<string>
- */
-export declare function getLastCommit(projectPath: string): Promise<string>;
-/**
- * Obtém o log do Git
- *
- * @param projectPath Caminho do projeto
- * @param options Opções do git log
- * @returns Promise<string>
- */
-export declare function getGitLog(projectPath: string, options?: string[]): Promise<string>;
-/**
- * Obtém o histórico de um arquivo específico
- *
- * @param projectPath Caminho do projeto
- * @param filePath Caminho do arquivo
- * @param options Opções do git log
- * @returns Promise<string>
- */
-export declare function getFileHistory(projectPath: string, filePath: string, options?: string[]): Promise<string>;
-/**
- * Obtém o histórico de uma branch
- *
- * @param projectPath Caminho do projeto
- * @param branch Branch para análise
- * @param options Opções do git log
- * @returns Promise<string>
- */
-export declare function getBranchHistory(projectPath: string, branch: string, options?: string[]): Promise<string>;
-/**
- * Adiciona um remote
- *
- * @param projectPath Caminho do projeto
- * @param name Nome do remote
- * @param url URL do remote
- * @returns Promise<TerminalResult>
- */
-export declare function addRemote(projectPath: string, name: string, url: string): Promise<TerminalResult>;
+export declare class TerminalController {
+    private defaultTimeout;
+    private defaultOptions;
+    /**
+     * Execute command with promise-based interface
+     */
+    executeCommand(command: string, args?: string[], options?: CommandOptions): Promise<CommandResult>;
+    /**
+     * Execute command in specific directory
+     */
+    executeInDirectory(directory: string, command: string, args?: string[], options?: CommandOptions): Promise<CommandResult>;
+    /**
+     * Check if command exists in system PATH
+     */
+    commandExists(command: string): Promise<boolean>;
+    /**
+     * Get current working directory
+     */
+    getCurrentDirectory(): string;
+    /**
+     * Change working directory for subsequent commands
+     */
+    setWorkingDirectory(directory: string): void;
+    /**
+     * Execute multiple commands in sequence
+     */
+    executeSequence(commands: Array<{
+        command: string;
+        args?: string[];
+        options?: CommandOptions;
+    }>, stopOnError?: boolean): Promise<CommandResult[]>;
+    /**
+     * Execute command with real-time output streaming
+     */
+    executeWithStreaming(command: string, args?: string[], options?: CommandOptions & {
+        onStdout?: (data: string) => void;
+        onStderr?: (data: string) => void;
+    }): Promise<CommandResult>;
+    /**
+     * Search for text in files using grep or findstr
+     */
+    searchInFiles(directory: string, query: string, options?: {
+        caseSensitive?: boolean;
+        filePattern?: string;
+        maxResults?: number;
+    }): Promise<CommandResult>;
+    /**
+     * Validate directory exists and is accessible
+     */
+    validateDirectory(directory: string): Promise<{
+        exists: boolean;
+        accessible: boolean;
+        isDirectory: boolean;
+        error?: string;
+    }>;
+}
+export declare const terminalController: TerminalController;
 //# sourceMappingURL=terminal-controller.d.ts.map