@depup/angular__cli 21.2.1-depup.1

package/src/commands/mcp/constants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @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
+ */
+export declare const k1 = "@angular/cli";
+export declare const at = "gv2tkIHTOiWtI6Su96LXLQ==";
+export declare const iv: Buffer<ArrayBuffer>;

package/src/commands/mcp/constants.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iv = exports.at = exports.k1 = void 0;
+exports.k1 = '@angular/cli';
+exports.at = 'gv2tkIHTOiWtI6Su96LXLQ==';
+exports.iv = Buffer.from([
+    0x97, 0xf4, 0x62, 0x95, 0x3e, 0x12, 0x76, 0x84, 0x8a, 0x09, 0x4a, 0xc9, 0xeb, 0xa2, 0x84, 0x69,
+]);
+//# sourceMappingURL=constants.js.map

package/src/commands/mcp/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["constants.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEU,QAAA,EAAE,GAAG,cAAc,CAAC;AACpB,QAAA,EAAE,GAAG,0BAA0B,CAAC;AAChC,QAAA,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAC5B,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC/F,CAAC,CAAC"}

package/src/commands/mcp/devserver.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @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
+ */
+import type { Host } from './host';
+export type BuildStatus = 'success' | 'failure' | 'unknown';
+/**
+ * An Angular development server managed by the MCP server.
+ */
+export interface Devserver {
+    /**
+     * Launches the dev server and returns immediately.
+     *
+     * Throws if this server is already running.
+     */
+    start(): void;
+    /**
+     * If the dev server is running, stops it.
+     */
+    stop(): void;
+    /**
+     * Gets all the server logs so far (stdout + stderr).
+     */
+    getServerLogs(): string[];
+    /**
+     * Gets all the server logs from the latest build.
+     */
+    getMostRecentBuild(): {
+        status: BuildStatus;
+        logs: string[];
+    };
+    /**
+     * Whether the dev server is currently being built, or is awaiting further changes.
+     */
+    isBuilding(): boolean;
+    /**
+     * `ng serve` port to use.
+     */
+    port: number;
+    /**
+     * The workspace path for this server.
+     */
+    workspacePath: string;
+    /**
+     * The project name for this server.
+     */
+    project: string;
+}
+/**
+ * A local Angular development server managed by the MCP server.
+ */
+export declare class LocalDevserver implements Devserver {
+    readonly host: Host;
+    readonly port: number;
+    readonly workspacePath: string;
+    readonly project: string;
+    private devserverProcess;
+    private serverLogs;
+    private buildInProgress;
+    private latestBuildLogStartIndex?;
+    private latestBuildStatus;
+    constructor({ host, port, workspacePath, project, }: {
+        host: Host;
+        port: number;
+        workspacePath: string;
+        project: string;
+    });
+    start(): void;
+    private addLog;
+    stop(): void;
+    getServerLogs(): string[];
+    getMostRecentBuild(): {
+        status: BuildStatus;
+        logs: string[];
+    };
+    isBuilding(): boolean;
+}
+export declare function getDevserverKey(workspacePath: string, projectName: string): string;
+export declare function createDevServerNotFoundError(devservers: Map<string, {
+    project: string;
+    workspacePath: string;
+}>): Error;

package/src/commands/mcp/devserver.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalDevserver = void 0;
+exports.getDevserverKey = getDevserverKey;
+exports.createDevServerNotFoundError = createDevServerNotFoundError;
+// Log messages that we want to catch to identify the build status.
+const BUILD_SUCCEEDED_MESSAGE = 'Application bundle generation complete.';
+const BUILD_FAILED_MESSAGE = 'Application bundle generation failed.';
+const WAITING_FOR_CHANGES_MESSAGE = 'Watch mode enabled. Watching for file changes...';
+const CHANGES_DETECTED_START_MESSAGE = '❯ Changes detected. Rebuilding...';
+const CHANGES_DETECTED_SUCCESS_MESSAGE = '✔ Changes detected. Rebuilding...';
+const BUILD_START_MESSAGES = [CHANGES_DETECTED_START_MESSAGE];
+const BUILD_END_MESSAGES = [
+    BUILD_SUCCEEDED_MESSAGE,
+    BUILD_FAILED_MESSAGE,
+    WAITING_FOR_CHANGES_MESSAGE,
+    CHANGES_DETECTED_SUCCESS_MESSAGE,
+];
+/**
+ * A local Angular development server managed by the MCP server.
+ */
+class LocalDevserver {
+    host;
+    port;
+    workspacePath;
+    project;
+    devserverProcess = null;
+    serverLogs = [];
+    buildInProgress = false;
+    latestBuildLogStartIndex = undefined;
+    latestBuildStatus = 'unknown';
+    constructor({ host, port, workspacePath, project, }) {
+        this.host = host;
+        this.port = port;
+        this.workspacePath = workspacePath;
+        this.project = project;
+    }
+    start() {
+        if (this.devserverProcess) {
+            throw Error('Dev server already started.');
+        }
+        const args = ['serve'];
+        if (this.project) {
+            args.push(this.project);
+        }
+        args.push(`--port=${this.port}`);
+        this.devserverProcess = this.host.spawn('ng', args, {
+            stdio: 'pipe',
+            cwd: this.workspacePath,
+        });
+        this.devserverProcess.stdout?.on('data', (data) => {
+            this.addLog(data.toString());
+        });
+        this.devserverProcess.stderr?.on('data', (data) => {
+            this.addLog(data.toString());
+        });
+        this.devserverProcess.stderr?.on('close', () => {
+            this.stop();
+        });
+        this.buildInProgress = true;
+    }
+    addLog(log) {
+        this.serverLogs.push(log);
+        if (BUILD_START_MESSAGES.some((message) => log.startsWith(message))) {
+            this.buildInProgress = true;
+            this.latestBuildLogStartIndex = this.serverLogs.length - 1;
+        }
+        else if (BUILD_END_MESSAGES.some((message) => log.startsWith(message))) {
+            this.buildInProgress = false;
+            // We consider everything except a specific failure message to be a success.
+            this.latestBuildStatus = log.startsWith(BUILD_FAILED_MESSAGE) ? 'failure' : 'success';
+        }
+    }
+    stop() {
+        this.devserverProcess?.kill();
+        this.devserverProcess = null;
+    }
+    getServerLogs() {
+        return [...this.serverLogs];
+    }
+    getMostRecentBuild() {
+        return {
+            status: this.latestBuildStatus,
+            logs: this.serverLogs.slice(this.latestBuildLogStartIndex),
+        };
+    }
+    isBuilding() {
+        return this.buildInProgress;
+    }
+}
+exports.LocalDevserver = LocalDevserver;
+function getDevserverKey(workspacePath, projectName) {
+    return `${workspacePath}:${projectName}`;
+}
+function createDevServerNotFoundError(devservers) {
+    if (devservers.size === 0) {
+        return new Error('No development servers are currently running.');
+    }
+    const runningServers = Array.from(devservers.values())
+        .map((server) => `- Project '${server.project}' in workspace path '${server.workspacePath}'`)
+        .join('\n');
+    return new Error(`Dev server not found. Currently running servers:\n${runningServers}\n` +
+        'Please provide the correct workspace and project arguments.');
+}
+//# sourceMappingURL=devserver.js.map

package/src/commands/mcp/devserver.js.map

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

package/src/commands/mcp/host.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @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
+ */
+import { ChildProcess } from 'node:child_process';
+import { Stats } from 'node:fs';
+/**
+ * An error thrown when a command fails to execute.
+ */
+export declare class CommandError extends Error {
+    readonly logs: string[];
+    readonly code: number | null;
+    constructor(message: string, logs: string[], code: number | null);
+}
+/**
+ * An abstraction layer for operating-system or file-system operations.
+ */
+export interface Host {
+    /**
+     * Gets the stats of a file or directory.
+     * @param path The path to the file or directory.
+     * @returns A promise that resolves to the stats.
+     */
+    stat(path: string): Promise<Stats>;
+    /**
+     * Checks if a path exists on the file system.
+     * @param path The path to check.
+     * @returns A boolean indicating whether the path exists.
+     */
+    existsSync(path: string): boolean;
+    /**
+     * Reads a file and returns its content.
+     * @param path The path to the file.
+     * @param encoding The encoding to use.
+     * @returns A promise that resolves to the file content.
+     */
+    readFile(path: string, encoding: 'utf-8'): Promise<string>;
+    /**
+     * Finds files matching a glob pattern.
+     * @param pattern The glob pattern.
+     * @param options Options for the glob search.
+     * @returns An async iterable of file entries.
+     */
+    glob(pattern: string, options: {
+        cwd: string;
+    }): AsyncIterable<{
+        name: string;
+        parentPath: string;
+        isFile(): boolean;
+    }>;
+    /**
+     * Resolves a module request from a given path.
+     * @param request The module request to resolve.
+     * @param from The path from which to resolve the request.
+     * @returns The resolved module path.
+     */
+    resolveModule(request: string, from: string): string;
+    /**
+     * Spawns a child process and returns a promise that resolves with the process's
+     * output or rejects with a structured error.
+     * @param command The command to run.
+     * @param args The arguments to pass to the command.
+     * @param options Options for the child process.
+     * @returns A promise that resolves with the standard output and standard error of the command.
+     */
+    runCommand(command: string, args: readonly string[], options?: {
+        timeout?: number;
+        stdio?: 'pipe' | 'ignore';
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<{
+        logs: string[];
+    }>;
+    /**
+     * Spawns a long-running child process and returns the `ChildProcess` object.
+     * @param command The command to run.
+     * @param args The arguments to pass to the command.
+     * @param options Options for the child process.
+     * @returns The spawned `ChildProcess` instance.
+     */
+    spawn(command: string, args: readonly string[], options?: {
+        stdio?: 'pipe' | 'ignore';
+        cwd?: string;
+        env?: Record<string, string>;
+    }): ChildProcess;
+    /**
+     * Finds an available TCP port on the system.
+     */
+    getAvailablePort(): Promise<number>;
+}
+/**
+ * A concrete implementation of the `Host` interface that runs on a local workspace.
+ */
+export declare const LocalWorkspaceHost: Host;

package/src/commands/mcp/host.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalWorkspaceHost = exports.CommandError = void 0;
+/**
+ * @fileoverview
+ * This file defines an abstraction layer for operating-system or file-system operations, such as
+ * command execution. This allows for easier testing by enabling the injection of mock or
+ * test-specific implementations.
+ */
+const fs_1 = require("fs");
+const node_child_process_1 = require("node:child_process");
+const promises_1 = require("node:fs/promises");
+const node_module_1 = require("node:module");
+const node_net_1 = require("node:net");
+/**
+ * An error thrown when a command fails to execute.
+ */
+class CommandError extends Error {
+    logs;
+    code;
+    constructor(message, logs, code) {
+        super(message);
+        this.logs = logs;
+        this.code = code;
+    }
+}
+exports.CommandError = CommandError;
+/**
+ * A concrete implementation of the `Host` interface that runs on a local workspace.
+ */
+exports.LocalWorkspaceHost = {
+    stat: promises_1.stat,
+    existsSync: fs_1.existsSync,
+    readFile: promises_1.readFile,
+    glob: function (pattern, options) {
+        return (0, promises_1.glob)(pattern, { ...options, withFileTypes: true });
+    },
+    resolveModule(request, from) {
+        return (0, node_module_1.createRequire)(from).resolve(request);
+    },
+    runCommand: async (command, args, options = {}) => {
+        const signal = options.timeout ? AbortSignal.timeout(options.timeout) : undefined;
+        return new Promise((resolve, reject) => {
+            const childProcess = (0, node_child_process_1.spawn)(command, args, {
+                shell: false,
+                stdio: options.stdio ?? 'pipe',
+                signal,
+                cwd: options.cwd,
+                env: {
+                    ...process.env,
+                    ...options.env,
+                },
+            });
+            const logs = [];
+            childProcess.stdout?.on('data', (data) => logs.push(data.toString()));
+            childProcess.stderr?.on('data', (data) => logs.push(data.toString()));
+            childProcess.on('close', (code) => {
+                if (code === 0) {
+                    resolve({ logs });
+                }
+                else {
+                    const message = `Process exited with code ${code}.`;
+                    reject(new CommandError(message, logs, code));
+                }
+            });
+            childProcess.on('error', (err) => {
+                if (err.name === 'AbortError') {
+                    const message = `Process timed out.`;
+                    reject(new CommandError(message, logs, null));
+                    return;
+                }
+                const message = `Process failed with error: ${err.message}`;
+                reject(new CommandError(message, logs, null));
+            });
+        });
+    },
+    spawn(command, args, options = {}) {
+        return (0, node_child_process_1.spawn)(command, args, {
+            shell: false,
+            stdio: options.stdio ?? 'pipe',
+            cwd: options.cwd,
+            env: {
+                ...process.env,
+                ...options.env,
+            },
+        });
+    },
+    getAvailablePort() {
+        return new Promise((resolve, reject) => {
+            // Create a new temporary server from Node's net library.
+            const server = (0, node_net_1.createServer)();
+            server.once('error', (err) => {
+                reject(err);
+            });
+            // Listen on port 0 to let the OS assign an available port.
+            server.listen(0, () => {
+                const address = server.address();
+                // Ensure address is an object with a port property.
+                if (address && typeof address === 'object') {
+                    const port = address.port;
+                    server.close();
+                    resolve(port);
+                }
+                else {
+                    reject(new Error('Unable to retrieve address information from server.'));
+                }
+            });
+        });
+    },
+};
+//# sourceMappingURL=host.js.map

package/src/commands/mcp/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["host.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;GAKG;AAEH,2BAAkD;AAClD,2DAAyD;AAEzD,+CAAoF;AACpF,6CAA4C;AAC5C,uCAAwC;AAExC;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IAGnB;IACA;IAHlB,YACE,OAAe,EACC,IAAc,EACd,IAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAU;QACd,SAAI,GAAJ,IAAI,CAAe;IAGrC,CAAC;CACF;AARD,oCAQC;AAyFD;;GAEG;AACU,QAAA,kBAAkB,GAAS;IACtC,IAAI,EAAJ,eAAI;IAEJ,UAAU,EAAE,eAAc;IAE1B,QAAQ,EAAE,mBAAY;IAEtB,IAAI,EAAE,UACJ,OAAe,EACf,OAAwB;QAExB,OAAO,IAAA,eAAQ,EAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,aAAa,CAAC,OAAe,EAAE,IAAY;QACzC,OAAO,IAAA,2BAAa,EAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,UAAU,EAAE,KAAK,EACf,OAAe,EACf,IAAuB,EACvB,UAKI,EAAE,EACuB,EAAE;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAElF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,YAAY,GAAG,IAAA,0BAAK,EAAC,OAAO,EAAE,IAAI,EAAE;gBACxC,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM;gBAC9B,MAAM;gBACN,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,GAAG,EAAE;oBACH,GAAG,OAAO,CAAC,GAAG;oBACd,GAAG,OAAO,CAAC,GAAG;iBACf;aACF,CAAC,CAAC;YAEH,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YACtE,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YAEtE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBAChC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACN,MAAM,OAAO,GAAG,4BAA4B,IAAI,GAAG,CAAC;oBACpD,MAAM,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBAC9B,MAAM,OAAO,GAAG,oBAAoB,CAAC;oBACrC,MAAM,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;oBAE9C,OAAO;gBACT,CAAC;gBACD,MAAM,OAAO,GAAG,8BAA8B,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC5D,MAAM,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CACH,OAAe,EACf,IAAuB,EACvB,UAII,EAAE;QAEN,OAAO,IAAA,0BAAK,EAAC,OAAO,EAAE,IAAI,EAAE;YAC1B,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM;YAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,GAAG,OAAO,CAAC,GAAG;aACf;SACF,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,yDAAyD;YACzD,MAAM,MAAM,GAAG,IAAA,uBAAY,GAAE,CAAC;YAE9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAY,EAAE,EAAE;gBACpC,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;YAEH,2DAA2D;YAC3D,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE;gBACpB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;gBAEjC,oDAAoD;gBACpD,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;oBAE1B,MAAM,CAAC,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC,CAAC;gBAC3E,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/src/commands/mcp/mcp-server.d.ts

@@ -0,0 +1,192 @@
+/**
+ * @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
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AngularWorkspace } from '../../utilities/config';
+import { type AnyMcpToolDeclaration } from './tools/tool-registry';
+/**
+ * The set of tools that are available but not enabled by default.
+ * These tools are considered experimental and may have limitations.
+ */
+export declare const EXPERIMENTAL_TOOLS: readonly [import("./tools/tool-registry").McpToolDeclaration<{
+    configuration: import("zod").ZodOptional<import("zod").ZodString>;
+    workspace: import("zod").ZodOptional<import("zod").ZodString>;
+    project: import("zod").ZodOptional<import("zod").ZodString>;
+}, {
+    status: import("zod").ZodEnum<{
+        success: "success";
+        failure: "failure";
+    }>;
+    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    path: import("zod").ZodOptional<import("zod").ZodString>;
+}>, import("./tools/tool-registry").McpToolDeclaration<{
+    workspace: import("zod").ZodOptional<import("zod").ZodString>;
+    project: import("zod").ZodOptional<import("zod").ZodString>;
+}, {
+    status: import("zod").ZodEnum<{
+        success: "success";
+        failure: "failure";
+    }>;
+    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+}>, import("./tools/tool-registry").McpToolDeclaration<{
+    transformations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+        [x: string]: string;
+    }>>>;
+    path: import("zod").ZodOptional<import("zod").ZodString>;
+    workspace: import("zod").ZodOptional<import("zod").ZodString>;
+    project: import("zod").ZodOptional<import("zod").ZodString>;
+}, {
+    instructions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+}>, import("./tools/tool-registry").McpToolDeclaration<{
+    filter: import("zod").ZodOptional<import("zod").ZodString>;
+    workspace: import("zod").ZodOptional<import("zod").ZodString>;
+    project: import("zod").ZodOptional<import("zod").ZodString>;
+}, {
+    status: import("zod").ZodEnum<{
+        success: "success";
+        failure: "failure";
+    }>;
+    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+}>, ...(import("./tools/tool-registry").McpToolDeclaration<{
+    workspace: import("zod").ZodOptional<import("zod").ZodString>;
+    project: import("zod").ZodOptional<import("zod").ZodString>;
+}, {
+    message: import("zod").ZodString;
+    address: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("./tools/tool-registry").McpToolDeclaration<{
+    workspace: import("zod").ZodOptional<import("zod").ZodString>;
+    project: import("zod").ZodOptional<import("zod").ZodString>;
+}, {
+    message: import("zod").ZodString;
+    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+}> | import("./tools/tool-registry").McpToolDeclaration<{
+    timeout: import("zod").ZodDefault<import("zod").ZodNumber>;
+    workspace: import("zod").ZodOptional<import("zod").ZodString>;
+    project: import("zod").ZodOptional<import("zod").ZodString>;
+}, {
+    status: import("zod").ZodEnum<{
+        success: "success";
+        timeout: "timeout";
+        failure: "failure";
+        unknown: "unknown";
+    }>;
+    logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+}>)[]];
+/**
+ * Experimental tools that are grouped together under a single name.
+ *
+ * Used for enabling them as a group.
+ */
+export declare const EXPERIMENTAL_TOOL_GROUPS: {
+    all: readonly [import("./tools/tool-registry").McpToolDeclaration<{
+        configuration: import("zod").ZodOptional<import("zod").ZodString>;
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
+        project: import("zod").ZodOptional<import("zod").ZodString>;
+    }, {
+        status: import("zod").ZodEnum<{
+            success: "success";
+            failure: "failure";
+        }>;
+        logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        path: import("zod").ZodOptional<import("zod").ZodString>;
+    }>, import("./tools/tool-registry").McpToolDeclaration<{
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
+        project: import("zod").ZodOptional<import("zod").ZodString>;
+    }, {
+        status: import("zod").ZodEnum<{
+            success: "success";
+            failure: "failure";
+        }>;
+        logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }>, import("./tools/tool-registry").McpToolDeclaration<{
+        transformations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+            [x: string]: string;
+        }>>>;
+        path: import("zod").ZodOptional<import("zod").ZodString>;
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
+        project: import("zod").ZodOptional<import("zod").ZodString>;
+    }, {
+        instructions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }>, import("./tools/tool-registry").McpToolDeclaration<{
+        filter: import("zod").ZodOptional<import("zod").ZodString>;
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
+        project: import("zod").ZodOptional<import("zod").ZodString>;
+    }, {
+        status: import("zod").ZodEnum<{
+            success: "success";
+            failure: "failure";
+        }>;
+        logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }>, ...(import("./tools/tool-registry").McpToolDeclaration<{
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
+        project: import("zod").ZodOptional<import("zod").ZodString>;
+    }, {
+        message: import("zod").ZodString;
+        address: import("zod").ZodOptional<import("zod").ZodString>;
+    }> | import("./tools/tool-registry").McpToolDeclaration<{
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
+        project: import("zod").ZodOptional<import("zod").ZodString>;
+    }, {
+        message: import("zod").ZodString;
+        logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }> | import("./tools/tool-registry").McpToolDeclaration<{
+        timeout: import("zod").ZodDefault<import("zod").ZodNumber>;
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
+        project: import("zod").ZodOptional<import("zod").ZodString>;
+    }, {
+        status: import("zod").ZodEnum<{
+            success: "success";
+            timeout: "timeout";
+            failure: "failure";
+            unknown: "unknown";
+        }>;
+        logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }>)[]];
+    devserver: (import("./tools/tool-registry").McpToolDeclaration<{
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
+        project: import("zod").ZodOptional<import("zod").ZodString>;
+    }, {
+        message: import("zod").ZodString;
+        address: import("zod").ZodOptional<import("zod").ZodString>;
+    }> | import("./tools/tool-registry").McpToolDeclaration<{
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
+        project: import("zod").ZodOptional<import("zod").ZodString>;
+    }, {
+        message: import("zod").ZodString;
+        logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }> | import("./tools/tool-registry").McpToolDeclaration<{
+        timeout: import("zod").ZodDefault<import("zod").ZodNumber>;
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
+        project: import("zod").ZodOptional<import("zod").ZodString>;
+    }, {
+        status: import("zod").ZodEnum<{
+            success: "success";
+            timeout: "timeout";
+            failure: "failure";
+            unknown: "unknown";
+        }>;
+        logs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }>)[];
+};
+export declare function createMcpServer(options: {
+    workspace?: AngularWorkspace;
+    readOnly?: boolean;
+    localOnly?: boolean;
+    experimentalTools?: string[];
+}, logger: {
+    warn(text: string): void;
+}): Promise<McpServer>;
+export declare function assembleToolDeclarations(stableDeclarations: readonly AnyMcpToolDeclaration[], experimentalDeclarations: readonly AnyMcpToolDeclaration[], options: {
+    readOnly?: boolean;
+    localOnly?: boolean;
+    experimentalTools?: string[];
+    logger: {
+        warn(text: string): void;
+    };
+}): AnyMcpToolDeclaration[];