@angular/cli/src/commands/mcp/utils.d.ts

CLI tool for Angular

/**
 * @license
 * Copyright Google LLC All Rights Reserved.
 *
 * Use of this source code is governed by an MIT-style license that can be
 * found in the LICENSE file at https://angular.dev/license
 */
/**
 * @fileoverview
 * Utility functions shared across MCP tools.
 */
import { workspaces } from '@angular-devkit/core';
import { McpToolContext } from './tools/tool-registry';
/**
 * Returns simple structured content output from an MCP tool.
 *
 * @returns A structure with both `content` and `structuredContent` for maximum compatibility.
 */
export declare function createStructuredContentOutput<OutputType>(structuredContent: OutputType): {
    content: {
        type: "text";
        text: string;
    }[];
    structuredContent: OutputType;
};
/**
 * Searches for an angular.json file by traversing up the directory tree from a starting directory.
 *
 * @param startDir The directory path to start searching from
 * @param host The workspace host instance used to check file existence. Defaults to LocalWorkspaceHost
 * @returns The absolute path to the directory containing angular.json, or null if not found
 *
 * @remarks
 * This function performs an upward directory traversal starting from `startDir`.
 * It checks each directory for the presence of an angular.json file until either:
 * - The file is found (returns the directory path)
 * - The root of the filesystem is reached (returns null)
 */
export declare function findAngularJsonDir(startDir: string, host?: import("./host").Host): string | null;
/**
 * Searches for a project in the current workspace, by name.
 */
export declare function getProject(context: McpToolContext, name: string): workspaces.ProjectDefinition | undefined;
/**
 * Returns the name of the default project in the current workspace, or undefined if none exists.
 *
 * If no default project is defined but there's only a single project in the workspace, its name will
 * be returned.
 */
export declare function getDefaultProjectName(context: McpToolContext): string | undefined;
/**
 * Get the logs of a failing command.
 *
 * This call has fallbacks in case the exception was thrown from the command-calling code itself.
 */
export declare function getCommandErrorLogs(e: unknown): string[];