@angular/cli 22.2.1 → 22.3.0-next.0

package/src/commands/mcp/resources/best-practices.md

@@ -1,59 +0,0 @@
-You are an expert in TypeScript, Angular, and scalable web application development. You write functional, maintainable, performant, and accessible code following Angular and TypeScript best practices.
-
-## TypeScript Best Practices
-
-- Use strict type checking
-- Prefer type inference when the type is obvious
-- Avoid the `any` type; use `unknown` when type is uncertain
-
-## Angular Best Practices
-
-- Always use standalone components over NgModules
-- Must NOT set `standalone: true` inside Angular decorators. It's the default in Angular v20+.
-- Do NOT set `changeDetection: ChangeDetectionStrategy.OnPush` explicitly. `OnPush` is the default in Angular v22+.
-- Use signals for state management
-- Implement lazy loading for feature routes
-- Do NOT use the `@HostBinding` and `@HostListener` decorators. Put host bindings inside the `host` object of the `@Component` or `@Directive` decorator instead
-- Use `NgOptimizedImage` for all static images.
-  - `NgOptimizedImage` does not work for inline base64 images.
-
-## Accessibility Requirements
-
-- It MUST pass all AXE checks.
-- It MUST follow all WCAG AA minimums, including focus management, color contrast, and ARIA attributes.
-
-### Components
-
-- Keep components small and focused on a single responsibility
-- Use `input()` and `output()` functions instead of decorators
-- Use `model()` for two-way bound properties with `[(prop)]` syntax instead of pairing `input()` with `output()`
-- Use `computed()` for derived state
-- Use `linkedSignal()` for state derived from multiple reactive sources that must stay synchronized
-- Prefer inline templates for small components
-- Prefer Signal Forms (`@angular/forms/signals`) for new forms. They are stable in Angular v22+ and provide signal-based state, type-safe field access, and schema-based validation
-- When not using Signal Forms, prefer Reactive forms instead of Template-driven ones
-- Do NOT use `ngClass`, use `class` bindings instead
-- Do NOT use `ngStyle`, use `style` bindings instead
-- Do NOT import `CommonModule`, import only the directives and pipes the template uses, such as `AsyncPipe` or `DatePipe`
-- When using external templates/styles, use paths relative to the component TS file.
-
-## State Management
-
-- Use signals for local component state
-- Use `computed()` for derived state
-- Keep state transformations pure and predictable
-- Do NOT use `mutate` on signals, use `update` or `set` instead
-
-## Templates
-
-- Keep templates simple and avoid complex logic
-- Use native control flow (`@if`, `@for`, `@switch`) instead of `*ngIf`, `*ngFor`, `*ngSwitch`
-- Use the async pipe to handle observables
-- Do not assume globals like (`new Date()`) are available.
-
-## Services
-
-- Design services around a single responsibility
-- Use the `providedIn: 'root'` option for singleton services
-- Prefer the `@Service` decorator over `@Injectable({providedIn: 'root'})` for new singleton services (Angular v22+)
-- Use the `inject()` function instead of constructor injection

package/src/commands/mcp/resources/instructions.d.ts

@@ -1,9 +0,0 @@
-/**
- * @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 { McpServer } from '@modelcontextprotocol/server';
-export declare function registerInstructionsResource(server: McpServer): void;

package/src/commands/mcp/resources/instructions.js

@@ -1,26 +0,0 @@
-"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.registerInstructionsResource = registerInstructionsResource;
-const promises_1 = require("node:fs/promises");
-const node_path_1 = require("node:path");
-function registerInstructionsResource(server) {
-    server.registerResource('instructions', 'instructions://best-practices', {
-        title: 'Angular Best Practices and Code Generation Guide',
-        description: "A comprehensive guide detailing Angular's best practices for code generation and development." +
-            ' This guide should be used as a reference by an LLM to ensure any generated code' +
-            ' adheres to modern Angular standards, including the use of standalone components,' +
-            ' typed forms, modern control flow syntax, and other current conventions.',
-        mimeType: 'text/markdown',
-    }, async () => {
-        const text = await (0, promises_1.readFile)((0, node_path_1.join)(__dirname, 'best-practices.md'), 'utf-8');
-        return { contents: [{ uri: 'instructions://best-practices', text }] };
-    });
-}
-//# sourceMappingURL=instructions.js.map

package/src/commands/mcp/resources/instructions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["instructions.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAMH,oEAmBC;AAtBD,+CAA4C;AAC5C,yCAAiC;AAEjC,SAAgB,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,gBAAgB,CACrB,cAAc,EACd,+BAA+B,EAC/B;QACE,KAAK,EAAE,kDAAkD;QACzD,WAAW,EACT,+FAA+F;YAC/F,kFAAkF;YAClF,mFAAmF;YACnF,0EAA0E;QAC5E,QAAQ,EAAE,eAAe;KAC1B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,IAAA,mBAAQ,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC,CAAC;QAE3E,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,+BAA+B,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACxE,CAAC,CACF,CAAC;AACJ,CAAC"}

package/src/commands/mcp/shared-options.d.ts

@@ -1,12 +0,0 @@
-/**
- * @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 { z } from 'zod';
-export declare const workspaceAndProjectOptions: {
-    workspace: z.ZodOptional<z.ZodString>;
-    project: z.ZodOptional<z.ZodString>;
-};

package/src/commands/mcp/shared-options.js

@@ -1,22 +0,0 @@
-"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.workspaceAndProjectOptions = void 0;
-const zod_1 = require("zod");
-exports.workspaceAndProjectOptions = {
-    workspace: zod_1.z
-        .string()
-        .optional()
-        .describe('The path to the workspace directory (containing angular.json). If not provided, uses the current directory.'),
-    project: zod_1.z
-        .string()
-        .optional()
-        .describe('Which project to target in a monorepo context. If not provided, targets the default project.'),
-};
-//# sourceMappingURL=shared-options.js.map

package/src/commands/mcp/shared-options.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"shared-options.js","sourceRoot":"","sources":["shared-options.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,6BAAwB;AAEX,QAAA,0BAA0B,GAAG;IACxC,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6GAA6G,CAC9G;IACH,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,8FAA8F,CAC/F;CACJ,CAAC"}

package/src/commands/mcp/tools/ai-tutor.d.ts

@@ -1,12 +0,0 @@
-/**
- * @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 AI_TUTOR_TOOL: import("./tool-registry").McpToolDeclaration<Readonly<{
-    [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
-}>, Readonly<{
-    [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
-}>>;

package/src/commands/mcp/tools/ai-tutor.js

@@ -1,59 +0,0 @@
-"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.AI_TUTOR_TOOL = void 0;
-const promises_1 = require("node:fs/promises");
-const node_path_1 = require("node:path");
-const tool_registry_1 = require("./tool-registry");
-exports.AI_TUTOR_TOOL = (0, tool_registry_1.declareTool)({
-    name: 'ai_tutor',
-    title: 'Start Angular AI Tutor',
-    description: `
-<Purpose>
-Loads the core instructions, curriculum, and persona for the Angular AI Tutor.
-This tool acts as a RAG (Retrieval-Augmented Generation) source, effectively
-reprogramming the assistant to become a specialized Angular tutor by providing it
-with a new core identity and knowledge base.
-</Purpose>
-<Use Cases>
-* The user asks to start a guided, step-by-step tutorial for learning Angular (e.g., "teach me Angular," "start the tutorial").
-* The user asks to resume a previous tutoring session.
-</Use Cases>
-<Operational Notes>
-* The text returned by this tool is a new set of instructions and rules for you, the LLM. It is NOT meant to be displayed to the user.
-* After invoking this tool, you MUST adopt the persona of the Angular AI Tutor and follow the curriculum provided in the text.
-* Be aware that the tutor persona supports special user commands, such as "skip this section," "show the table of contents,"
-  or "set my experience level to beginner." The curriculum text will provide the full details on how to handle these.
-* Your subsequent responses should be governed by these new instructions, leading the user through the "Smart Recipe Box"
-  application tutorial.
-* As the tutor, you will use your other tools to access the user's project files to verify their solutions as instructed by the curriculum.
-</Operational Notes>
-`,
-    isReadOnly: true,
-    isLocalOnly: true,
-    factory: () => {
-        let aiTutorText;
-        return async () => {
-            aiTutorText ??= await (0, promises_1.readFile)((0, node_path_1.join)(__dirname, '../resources/ai-tutor.md'), 'utf-8');
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: aiTutorText,
-                        annotations: {
-                            audience: ['assistant'],
-                            priority: 1.0,
-                        },
-                    },
-                ],
-            };
-        };
-    },
-});
-//# sourceMappingURL=ai-tutor.js.map

package/src/commands/mcp/tools/ai-tutor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-tutor.js","sourceRoot":"","sources":["ai-tutor.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,+CAA4C;AAC5C,yCAAiC;AACjC,mDAA8C;AAEjC,QAAA,aAAa,GAAG,IAAA,2BAAW,EAAC;IACvC,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;CAoBd;IACC,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,GAAG,EAAE;QACZ,IAAI,WAAmB,CAAC;QAExB,OAAO,KAAK,IAAI,EAAE;YAChB,WAAW,KAAK,MAAM,IAAA,mBAAQ,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,0BAA0B,CAAC,EAAE,OAAO,CAAC,CAAC;YAErF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,WAAW;wBACjB,WAAW,EAAE;4BACX,QAAQ,EAAE,CAAC,WAAW,CAAC;4BACvB,QAAQ,EAAE,GAAG;yBACd;qBACF;iBACF;aACF,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/src/commands/mcp/tools/best-practices.d.ts

@@ -1,13 +0,0 @@
-/**
- * @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 { z } from 'zod';
-export declare const BEST_PRACTICES_TOOL: import("./tool-registry").McpToolDeclaration<{
-    workspacePath: z.ZodOptional<z.ZodString>;
-}, Readonly<{
-    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-}>>;

package/src/commands/mcp/tools/best-practices.js

@@ -1,196 +0,0 @@
-"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.BEST_PRACTICES_TOOL = void 0;
-/**
- * @fileoverview
- * This file defines the `get_best_practices` MCP tool. The tool is designed to be version-aware,
- * dynamically resolving the best practices guide from the user's installed version of
- * `@angular/core`. It achieves this by reading a custom `angular` metadata block in the
- * framework's `package.json`. If this resolution fails, it gracefully falls back to a generic
- * guide bundled with the Angular CLI.
- */
-const promises_1 = require("node:fs/promises");
-const node_module_1 = require("node:module");
-const node_path_1 = require("node:path");
-const zod_1 = require("zod");
-const version_1 = require("../../../utilities/version");
-const workspace_utils_1 = require("../workspace-utils");
-const tool_registry_1 = require("./tool-registry");
-const bestPracticesInputSchema = zod_1.z.object({
-    workspacePath: zod_1.z
-        .string()
-        .optional()
-        .describe('Absolute path to the angular.json workspace directory (obtained via list_projects). ' +
-        'If omitted, returns the generic best practices guide.'),
-});
-exports.BEST_PRACTICES_TOOL = (0, tool_registry_1.declareTool)({
-    name: 'get_best_practices',
-    title: 'Get Angular Coding Best Practices Guide',
-    description: `
-<Purpose>
-Retrieves the official Angular Best Practices Guide. This guide contains the essential rules and conventions
-that must be followed for any task involving the creation, analysis, or modification of Angular code.
-</Purpose>
-<Use Cases>
-* Mandatory first step before writing or modifying Angular code to ensure modern framework standards.
-* Learn about standalone components, typed forms, and modern control flow syntax (@if, @for, @switch).
-* Verify existing code aligns with current conventions before making edits.
-</Use Cases>
-<Operational Notes>
-* Provide the 'workspacePath' argument (obtained via 'list_projects') to load the version-specific
-  guide matching the project's Angular framework.
-* Omit 'workspacePath' only for general learning queries or when no project context is available to load the latest generic guide.
-</Operational Notes>`,
-    inputSchema: bestPracticesInputSchema.shape,
-    isReadOnly: true,
-    isLocalOnly: true,
-    factory: createBestPracticesHandler,
-});
-/**
- * Retrieves the content of the generic best practices guide that is bundled with the CLI.
- * This serves as a fallback when a version-specific guide cannot be found.
- * @returns A promise that resolves to the string content of the bundled markdown file.
- */
-async function getBundledBestPractices() {
-    return (0, promises_1.readFile)((0, node_path_1.join)(__dirname, '../resources/best-practices.md'), 'utf-8');
-}
-/**
- * Attempts to find and read a version-specific best practices guide from the user's installed
- * version of `@angular/core`. It looks for a custom `angular` metadata property in the
- * framework's `package.json` to locate the guide.
- *
- * @example A sample `package.json` `angular` field:
- * ```json
- * {
- *   "angular": {
- *     "bestPractices": {
- *       "format": "markdown",
- *       "path": "./resources/best-practices.md"
- *     }
- *   }
- * }
- * ```
- *
- * @param workspacePath The absolute path to the user's `angular.json` file.
- * @param logger The MCP tool context logger for reporting warnings.
- * @param server The MCP server context, used to enforce the client's declared roots.
- * @returns A promise that resolves to an object containing the guide's content and source,
- *     or `undefined` if the guide could not be resolved.
- */
-async function getVersionSpecificBestPractices(workspacePath, logger, server) {
-    if (server) {
-        let isAllowed;
-        try {
-            isAllowed = await (0, workspace_utils_1.isAllowedWorkspacePath)(server, workspacePath);
-        }
-        catch (e) {
-            logger.warn(`Failed to verify workspace path '${workspacePath}': ` +
-                `${e instanceof Error ? e.message : e}. Falling back to the bundled guide.`);
-            return undefined;
-        }
-        if (!isAllowed) {
-            throw new Error(`Workspace path is outside the allowed MCP roots: ${workspacePath}. ` +
-                "You can use 'list_projects' to find available workspaces.");
-        }
-    }
-    // 1. Resolve the path to package.json
-    let pkgJsonPath;
-    try {
-        const workspaceRequire = (0, node_module_1.createRequire)(workspacePath);
-        pkgJsonPath = workspaceRequire.resolve('@angular/core/package.json');
-    }
-    catch (e) {
-        logger.warn(`Could not resolve '@angular/core/package.json' from '${workspacePath}'. ` +
-            'Is Angular installed in this project? Falling back to the bundled guide.');
-        return undefined;
-    }
-    // 2. Read and parse package.json, then find and read the guide.
-    try {
-        const pkgJsonContent = await (0, promises_1.readFile)(pkgJsonPath, 'utf-8');
-        const pkgJson = JSON.parse(pkgJsonContent);
-        const bestPracticesInfo = pkgJson['angular']?.bestPractices;
-        if (bestPracticesInfo &&
-            bestPracticesInfo.format === 'markdown' &&
-            typeof bestPracticesInfo.path === 'string') {
-            const packageDirectory = (0, node_path_1.dirname)(pkgJsonPath);
-            const guidePath = (0, node_path_1.resolve)(packageDirectory, bestPracticesInfo.path);
-            // Ensure the resolved guide path is within the package boundary.
-            // Uses path.relative to create a cross-platform, case-insensitive check.
-            // If the relative path starts with '..' or is absolute, it is a traversal attempt.
-            const relativePath = (0, node_path_1.relative)(packageDirectory, guidePath);
-            if (relativePath.startsWith('..') || (0, node_path_1.isAbsolute)(relativePath)) {
-                logger.warn(`Detected a potential path traversal attempt in '${pkgJsonPath}'. ` +
-                    `The path '${bestPracticesInfo.path}' escapes the package boundary. ` +
-                    'Falling back to the bundled guide.');
-                return undefined;
-            }
-            // Check the file size to prevent reading a very large file.
-            const stats = await (0, promises_1.stat)(guidePath);
-            if (stats.size > 1024 * 1024) {
-                // 1MB
-                logger.warn(`The best practices guide at '${guidePath}' is larger than 1MB (${stats.size} bytes). ` +
-                    'This is unexpected and the file will not be read. Falling back to the bundled guide.');
-                return undefined;
-            }
-            const content = await (0, promises_1.readFile)(guidePath, 'utf-8');
-            const source = `framework version ${pkgJson.version}`;
-            return { content, source };
-        }
-        else {
-            logger.warn(`Did not find valid 'angular.bestPractices' metadata in '${pkgJsonPath}'. ` +
-                'Falling back to the bundled guide.');
-        }
-    }
-    catch (e) {
-        logger.warn(`Failed to read or parse version-specific best practices referenced in '${pkgJsonPath}': ${e instanceof Error ? e.message : e}. Falling back to the bundled guide.`);
-    }
-    return undefined;
-}
-/**
- * Creates the handler function for the `get_best_practices` tool.
- * The handler orchestrates the process of first attempting to get a version-specific guide
- * and then falling back to the bundled guide if necessary.
- * @param context The MCP tool context, containing the logger.
- * @returns An async function that serves as the tool's executor.
- */
-function createBestPracticesHandler({ logger, server }) {
-    let bundledBestPractices;
-    return async (input) => {
-        let content;
-        let source;
-        // First, try to get the version-specific guide.
-        if (input.workspacePath) {
-            const versionSpecific = await getVersionSpecificBestPractices(input.workspacePath, logger, server);
-            if (versionSpecific) {
-                content = versionSpecific.content;
-                source = versionSpecific.source;
-            }
-        }
-        // If the version-specific guide was not found for any reason, fall back to the bundled version.
-        if (content === undefined) {
-            content = await (bundledBestPractices ??= getBundledBestPractices());
-            source = `bundled (CLI v${version_1.VERSION.full})`;
-        }
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: content,
-                    annotations: {
-                        audience: ['assistant'],
-                        priority: 0.9,
-                        source,
-                    },
-                },
-            ],
-        };
-    };
-}
-//# sourceMappingURL=best-practices.js.map

package/src/commands/mcp/tools/best-practices.js.map

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

package/src/commands/mcp/tools/devserver/devserver-start.d.ts

@@ -1,32 +0,0 @@
-/**
- * @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 { z } from 'zod';
-import { type McpToolContext, type McpToolDeclaration } from '../tool-registry';
-declare const devserverStartToolInputSchema: z.ZodObject<{
-    port: z.ZodOptional<z.ZodNumber>;
-    workspace: z.ZodOptional<z.ZodString>;
-    project: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type DevserverStartToolInput = z.infer<typeof devserverStartToolInputSchema>;
-declare const devserverStartToolOutputSchema: z.ZodObject<{
-    message: z.ZodString;
-    address: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type DevserverStartToolOutput = z.infer<typeof devserverStartToolOutputSchema>;
-export declare function startDevserver(input: DevserverStartToolInput, context: McpToolContext): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: {
-        message: string;
-        address: string;
-    };
-}>;
-export declare const DEVSERVER_START_TOOL: McpToolDeclaration<typeof devserverStartToolInputSchema.shape, typeof devserverStartToolOutputSchema.shape>;
-export {};

package/src/commands/mcp/tools/devserver/devserver-start.js

@@ -1,110 +0,0 @@
-"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.DEVSERVER_START_TOOL = void 0;
-exports.startDevserver = startDevserver;
-const zod_1 = require("zod");
-const devserver_1 = require("../../devserver");
-const shared_options_1 = require("../../shared-options");
-const utils_1 = require("../../utils");
-const workspace_utils_1 = require("../../workspace-utils");
-const tool_registry_1 = require("../tool-registry");
-const devserverStartToolInputSchema = zod_1.z.object({
-    ...shared_options_1.workspaceAndProjectOptions,
-    port: zod_1.z
-        .number()
-        .optional()
-        .describe('The port number to run the server on. If not provided, a random available port will be chosen. ' +
-        'It is recommended to reuse port numbers across calls within the same workspace to maintain consistency.'),
-});
-const devserverStartToolOutputSchema = zod_1.z.object({
-    message: zod_1.z.string().describe('A message indicating the result of the operation.'),
-    address: zod_1.z
-        .string()
-        .optional()
-        .describe('If the operation was successful, this is the HTTP address that the server can be found at.'),
-});
-function localhostAddress(port) {
-    return `http://localhost:${port}/`;
-}
-async function startDevserver(input, context) {
-    const { workspacePath, projectName } = await (0, workspace_utils_1.resolveWorkspaceAndProject)({
-        host: context.host,
-        server: context.server,
-        workspacePathInput: input.workspace,
-        projectNameInput: input.project,
-        mcpWorkspace: context.workspace,
-    });
-    const key = (0, devserver_1.getDevserverKey)(workspacePath, projectName);
-    let devserver = context.devservers.get(key);
-    if (devserver) {
-        return (0, utils_1.createStructuredContentOutput)({
-            message: `Development server for project '${projectName}' is already running.`,
-            address: localhostAddress(devserver.port),
-        });
-    }
-    let port;
-    if (input.port) {
-        if (!(await context.host.isPortAvailable(input.port))) {
-            throw new Error(`Port ${input.port} is unavailable. Try calling this tool again without the 'port' parameter to auto-assign a free port.`);
-        }
-        port = input.port;
-    }
-    else {
-        port = await context.host.getAvailablePort();
-    }
-    devserver = new devserver_1.LocalDevserver({
-        host: context.host,
-        project: projectName,
-        port,
-        workspacePath,
-    });
-    devserver.start();
-    context.devservers.set(key, devserver);
-    return (0, utils_1.createStructuredContentOutput)({
-        message: `Development server for project '${projectName}' started and watching for workspace changes.`,
-        address: localhostAddress(port),
-    });
-}
-exports.DEVSERVER_START_TOOL = (0, tool_registry_1.declareTool)({
-    name: 'devserver_start',
-    title: 'Start Development Server',
-    description: `
-<Purpose>
-Starts the Angular development server ("ng serve") as a background process. Follow this up with "devserver_wait_for_build" to wait until
-the first build completes.
-</Purpose>
-<Use Cases>
-* **Starting the Server:** Use this tool to begin serving the application. The tool will return immediately while the server runs in the
-  background.
-* **Get Initial Build Logs:** Once a dev server has started, use the "devserver_wait_for_build" tool to ensure it's alive. If there are any
-  build errors, "devserver_wait_for_build" would provide them back and you can give them to the user or rely on them to propose a fix.
-* **Get Updated Build Logs:** Important: as long as a devserver is alive (i.e. "devserver_stop" wasn't called), after every time you
-  make a change to the workspace, re-run "devserver_wait_for_build" to see whether the change was successfully built and wait for the
-  devserver to be updated.
-</Use Cases>
-<Operational Notes>
-* This tool manages development servers by itself. It maintains at most a single dev server instance for each project in the monorepo.
-* This is an asynchronous operation. Subsequent commands can be ran while the server is active.
-* Use 'devserver_stop' to gracefully shut down the server and access the full log output.
-* **Keeping the Server Alive**: It is often better to keep the server alive between tool calls if you expect the user to request more
-  changes or run more tests, as it saves time on restarts and maintains the file watcher state. You must still call
-  'devserver_wait_for_build' after every change to see whether the change was successfully built and be sure that the app was updated.
-* **Consistent Ports**: If making multiple calls, it is recommended to reuse the port you got from the first call for subsequent ones.
-</Operational Notes>
-`,
-    isReadOnly: false,
-    isLocalOnly: true,
-    inputSchema: devserverStartToolInputSchema.shape,
-    outputSchema: devserverStartToolOutputSchema.shape,
-    factory: (context) => (input) => {
-        return startDevserver(input, context);
-    },
-});
-//# sourceMappingURL=devserver-start.js.map

package/src/commands/mcp/tools/devserver/devserver-start.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"devserver-start.js","sourceRoot":"","sources":["devserver-start.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAsCH,wCA6CC;AAjFD,6BAAwB;AACxB,+CAAkE;AAClE,yDAAkE;AAClE,uCAA4D;AAC5D,2DAAmE;AACnE,oDAA6F;AAE7F,MAAM,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,GAAG,2CAA0B;IAC7B,IAAI,EAAE,OAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iGAAiG;QAC/F,yGAAyG,CAC5G;CACJ,CAAC,CAAC;AAIH,MAAM,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IACjF,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4FAA4F,CAC7F;CACJ,CAAC,CAAC;AAIH,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,oBAAoB,IAAI,GAAG,CAAC;AACrC,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,KAA8B,EAAE,OAAuB;IAC1F,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,MAAM,IAAA,4CAA0B,EAAC;QACtE,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,kBAAkB,EAAE,KAAK,CAAC,SAAS;QACnC,gBAAgB,EAAE,KAAK,CAAC,OAAO;QAC/B,YAAY,EAAE,OAAO,CAAC,SAAS;KAChC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAA,2BAAe,EAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAExD,IAAI,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,IAAA,qCAA6B,EAAC;YACnC,OAAO,EAAE,mCAAmC,WAAW,uBAAuB;YAC9E,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAY,CAAC;IACjB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CACb,QAAQ,KAAK,CAAC,IAAI,uGAAuG,CAC1H,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC/C,CAAC;IAED,SAAS,GAAG,IAAI,0BAAc,CAAC;QAC7B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,WAAW;QACpB,IAAI;QACJ,aAAa;KACd,CAAC,CAAC;IACH,SAAS,CAAC,KAAK,EAAE,CAAC;IAElB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAEvC,OAAO,IAAA,qCAA6B,EAAC;QACnC,OAAO,EAAE,mCAAmC,WAAW,+CAA+C;QACtG,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC;KAChC,CAAC,CAAC;AACL,CAAC;AAEY,QAAA,oBAAoB,GAG7B,IAAA,2BAAW,EAAC;IACd,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;CAuBd;IACC,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,6BAA6B,CAAC,KAAK;IAChD,YAAY,EAAE,8BAA8B,CAAC,KAAK;IAClD,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,OAAO,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC"}

package/src/commands/mcp/tools/devserver/devserver-stop.d.ts

@@ -1,31 +0,0 @@
-/**
- * @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 { z } from 'zod';
-import { type McpToolContext, type McpToolDeclaration } from '../tool-registry';
-declare const devserverStopToolInputSchema: z.ZodObject<{
-    workspace: z.ZodOptional<z.ZodString>;
-    project: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type DevserverStopToolInput = z.infer<typeof devserverStopToolInputSchema>;
-declare const devserverStopToolOutputSchema: z.ZodObject<{
-    message: z.ZodString;
-    logs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export type DevserverStopToolOutput = z.infer<typeof devserverStopToolOutputSchema>;
-export declare function stopDevserver(input: DevserverStopToolInput, context: McpToolContext): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: {
-        message: string;
-        logs: string[];
-    };
-}>;
-export declare const DEVSERVER_STOP_TOOL: McpToolDeclaration<typeof devserverStopToolInputSchema.shape, typeof devserverStopToolOutputSchema.shape>;
-export {};