@angular/cli 21.0.1 → 21.1.0-next.0

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

@@ -6,9 +6,6 @@
  * 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
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BEST_PRACTICES_TOOL = void 0;
 /**
@@ -21,7 +18,7 @@ exports.BEST_PRACTICES_TOOL = void 0;
  */
 const promises_1 = require("node:fs/promises");
 const node_module_1 = require("node:module");
-const node_path_1 = __importDefault(require("node:path"));
+const node_path_1 = require("node:path");
 const zod_1 = require("zod");
 const version_1 = require("../../../utilities/version");
 const tool_registry_1 = require("./tool-registry");
@@ -69,7 +66,7 @@ that **MUST** be followed for any task involving the creation, analysis, or modi
  * @returns A promise that resolves to the string content of the bundled markdown file.
  */
 async function getBundledBestPractices() {
-    return (0, promises_1.readFile)(node_path_1.default.join(__dirname, '..', 'resources', 'best-practices.md'), 'utf-8');
+    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
@@ -113,13 +110,13 @@ async function getVersionSpecificBestPractices(workspacePath, logger) {
         if (bestPracticesInfo &&
             bestPracticesInfo.format === 'markdown' &&
             typeof bestPracticesInfo.path === 'string') {
-            const packageDirectory = node_path_1.default.dirname(pkgJsonPath);
-            const guidePath = node_path_1.default.resolve(packageDirectory, bestPracticesInfo.path);
+            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 = node_path_1.default.relative(packageDirectory, guidePath);
-            if (relativePath.startsWith('..') || node_path_1.default.isAbsolute(relativePath)) {
+            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.');

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

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

package/src/commands/mcp/tools/build.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @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 Host } from '../host';
+import { type McpToolDeclaration } from './tool-registry';
+declare const buildToolInputSchema: z.ZodObject<{
+    project: z.ZodOptional<z.ZodString>;
+    configuration: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project?: string | undefined;
+    configuration?: string | undefined;
+}, {
+    project?: string | undefined;
+    configuration?: string | undefined;
+}>;
+export type BuildToolInput = z.infer<typeof buildToolInputSchema>;
+declare const buildToolOutputSchema: z.ZodObject<{
+    status: z.ZodEnum<["success", "failure"]>;
+    logs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "success" | "failure";
+    path?: string | undefined;
+    logs?: string[] | undefined;
+}, {
+    status: "success" | "failure";
+    path?: string | undefined;
+    logs?: string[] | undefined;
+}>;
+export type BuildToolOutput = z.infer<typeof buildToolOutputSchema>;
+export declare function runBuild(input: BuildToolInput, host: Host): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        status: "success" | "failure";
+        path?: string | undefined;
+        logs?: string[] | undefined;
+    };
+}>;
+export declare const BUILD_TOOL: McpToolDeclaration<typeof buildToolInputSchema.shape, typeof buildToolOutputSchema.shape>;
+export {};

package/src/commands/mcp/tools/build.js

@@ -0,0 +1,97 @@
+"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.BUILD_TOOL = void 0;
+exports.runBuild = runBuild;
+const zod_1 = require("zod");
+const host_1 = require("../host");
+const utils_1 = require("../utils");
+const tool_registry_1 = require("./tool-registry");
+const DEFAULT_CONFIGURATION = 'development';
+const buildStatusSchema = zod_1.z.enum(['success', 'failure']);
+const buildToolInputSchema = zod_1.z.object({
+    project: zod_1.z
+        .string()
+        .optional()
+        .describe('Which project to build in a monorepo context. If not provided, builds the default project.'),
+    configuration: zod_1.z
+        .string()
+        .optional()
+        .describe('Which build configuration to use. Defaults to "development".'),
+});
+const buildToolOutputSchema = zod_1.z.object({
+    status: buildStatusSchema.describe('Build status.'),
+    logs: zod_1.z.array(zod_1.z.string()).optional().describe('Output logs from `ng build`.'),
+    path: zod_1.z.string().optional().describe('The output location for the build, if successful.'),
+});
+async function runBuild(input, host) {
+    // Build "ng"'s command line.
+    const args = ['build'];
+    if (input.project) {
+        args.push(input.project);
+    }
+    args.push('-c', input.configuration ?? DEFAULT_CONFIGURATION);
+    let status = 'success';
+    let logs = [];
+    let outputPath;
+    try {
+        logs = (await host.runCommand('ng', args)).logs;
+    }
+    catch (e) {
+        status = 'failure';
+        if (e instanceof host_1.CommandError) {
+            logs = e.logs;
+        }
+        else if (e instanceof Error) {
+            logs = [e.message];
+        }
+        else {
+            logs = [String(e)];
+        }
+    }
+    for (const line of logs) {
+        const match = line.match(/Output location: (.*)/);
+        if (match) {
+            outputPath = match[1].trim();
+            break;
+        }
+    }
+    const structuredContent = {
+        status,
+        logs,
+        path: outputPath,
+    };
+    return (0, utils_1.createStructuredContentOutput)(structuredContent);
+}
+exports.BUILD_TOOL = (0, tool_registry_1.declareTool)({
+    name: 'build',
+    title: 'Build Tool',
+    description: `
+<Purpose>
+Perform a one-off, non-watched build using "ng build". Use this tool whenever the user wants to build an Angular project; this is similar to
+"ng build", but the tool is smarter about using the right configuration and collecting the output logs.
+</Purpose>
+<Use Cases>
+* Building an Angular project and getting build logs back.
+</Use Cases>
+<Operational Notes>
+* This tool runs "ng build" so it expects to run within an Angular workspace.
+* If you want a watched build which updates as files are changed, use "start_devserver" instead, which also serves the app.
+* You can provide a project instead of building the root one. The "list_projects" MCP tool could be used to obtain the list of projects.
+* This tool defaults to a development environment while a regular "ng build" defaults to a production environment. An unexpected build
+  failure might suggest the project is not configured for the requested environment.
+</Operational Notes>
+`,
+    isReadOnly: false,
+    isLocalOnly: true,
+    inputSchema: buildToolInputSchema.shape,
+    outputSchema: buildToolOutputSchema.shape,
+    factory: () => (input) => runBuild(input, host_1.LocalWorkspaceHost),
+});
+//# sourceMappingURL=build.js.map

package/src/commands/mcp/tools/build.js.map

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

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

@@ -0,0 +1,41 @@
+/**
+ * @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 Host } from '../../host';
+import { type McpToolContext, type McpToolDeclaration } from '../tool-registry';
+declare const startDevServerToolInputSchema: z.ZodObject<{
+    project: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project?: string | undefined;
+}, {
+    project?: string | undefined;
+}>;
+export type StartDevserverToolInput = z.infer<typeof startDevServerToolInputSchema>;
+declare const startDevServerToolOutputSchema: z.ZodObject<{
+    message: z.ZodString;
+    address: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    address?: string | undefined;
+}, {
+    message: string;
+    address?: string | undefined;
+}>;
+export type StartDevserverToolOutput = z.infer<typeof startDevServerToolOutputSchema>;
+export declare function startDevServer(input: StartDevserverToolInput, context: McpToolContext, host: Host): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        message: string;
+        address: string;
+    };
+}>;
+export declare const START_DEVSERVER_TOOL: McpToolDeclaration<typeof startDevServerToolInputSchema.shape, typeof startDevServerToolOutputSchema.shape>;
+export {};

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

@@ -0,0 +1,82 @@
+"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.START_DEVSERVER_TOOL = void 0;
+exports.startDevServer = startDevServer;
+const zod_1 = require("zod");
+const dev_server_1 = require("../../dev-server");
+const host_1 = require("../../host");
+const utils_1 = require("../../utils");
+const tool_registry_1 = require("../tool-registry");
+const startDevServerToolInputSchema = zod_1.z.object({
+    project: zod_1.z
+        .string()
+        .optional()
+        .describe('Which project to serve in a monorepo context. If not provided, serves the default project.'),
+});
+const startDevServerToolOutputSchema = 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, host) {
+    const projectKey = (0, dev_server_1.devServerKey)(input.project);
+    let devServer = context.devServers.get(projectKey);
+    if (devServer) {
+        return (0, utils_1.createStructuredContentOutput)({
+            message: `Development server for project '${projectKey}' is already running.`,
+            address: localhostAddress(devServer.port),
+        });
+    }
+    const port = await host.getAvailablePort();
+    devServer = new dev_server_1.LocalDevServer({ host, project: input.project, port });
+    devServer.start();
+    context.devServers.set(projectKey, devServer);
+    return (0, utils_1.createStructuredContentOutput)({
+        message: `Development server for project '${projectKey}' started and watching for workspace changes.`,
+        address: localhostAddress(port),
+    });
+}
+exports.START_DEVSERVER_TOOL = (0, tool_registry_1.declareTool)({
+    name: 'start_devserver',
+    title: 'Start Development Server',
+    description: `
+<Purpose>
+Starts the Angular development server ("ng serve") as a background process. Follow this up with "wait_for_devserver_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 "wait_for_devserver_build" tool to ensure it's alive. If there are any
+  build errors, "wait_for_devserver_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. "stop_devserver" wasn't called), after every time you make a
+  change to the workspace, re-run "wait_for_devserver_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 'stop_devserver' to gracefully shut down the server and access the full log output.
+</Operational Notes>
+`,
+    isReadOnly: true,
+    isLocalOnly: true,
+    inputSchema: startDevServerToolInputSchema.shape,
+    outputSchema: startDevServerToolOutputSchema.shape,
+    factory: (context) => (input) => {
+        return startDevServer(input, context, host_1.LocalWorkspaceHost);
+    },
+});
+//# sourceMappingURL=start-devserver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-devserver.js","sourceRoot":"","sources":["start-devserver.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAmCH,wCA0BC;AA3DD,6BAAwB;AACxB,iDAAgE;AAChE,qCAA2D;AAC3D,uCAA4D;AAC5D,oDAA6F;AAE7F,MAAM,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4FAA4F,CAC7F;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,CAClC,KAA8B,EAC9B,OAAuB,EACvB,IAAU;IAEV,MAAM,UAAU,GAAG,IAAA,yBAAY,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE/C,IAAI,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,IAAA,qCAA6B,EAAC;YACnC,OAAO,EAAE,mCAAmC,UAAU,uBAAuB;YAC7E,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAE3C,SAAS,GAAG,IAAI,2BAAc,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,SAAS,CAAC,KAAK,EAAE,CAAC;IAElB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAE9C,OAAO,IAAA,qCAA6B,EAAC;QACnC,OAAO,EAAE,mCAAmC,UAAU,+CAA+C;QACrG,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;;;;;;;;;;;;;;;;;;;CAmBd;IACC,UAAU,EAAE,IAAI;IAChB,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,EAAE,yBAAkB,CAAC,CAAC;IAC5D,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,49 @@
+/**
+ * @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 stopDevserverToolInputSchema: z.ZodObject<{
+    project: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project?: string | undefined;
+}, {
+    project?: string | undefined;
+}>;
+export type StopDevserverToolInput = z.infer<typeof stopDevserverToolInputSchema>;
+declare const stopDevserverToolOutputSchema: z.ZodObject<{
+    message: z.ZodString;
+    logs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    logs?: string[] | undefined;
+}, {
+    message: string;
+    logs?: string[] | undefined;
+}>;
+export type StopDevserverToolOutput = z.infer<typeof stopDevserverToolOutputSchema>;
+export declare function stopDevserver(input: StopDevserverToolInput, context: McpToolContext): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        message: string;
+        logs: undefined;
+    };
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        message: string;
+        logs: string[];
+    };
+};
+export declare const STOP_DEVSERVER_TOOL: McpToolDeclaration<typeof stopDevserverToolInputSchema.shape, typeof stopDevserverToolOutputSchema.shape>;
+export {};

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

@@ -0,0 +1,66 @@
+"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.STOP_DEVSERVER_TOOL = void 0;
+exports.stopDevserver = stopDevserver;
+const zod_1 = require("zod");
+const dev_server_1 = require("../../dev-server");
+const utils_1 = require("../../utils");
+const tool_registry_1 = require("../tool-registry");
+const stopDevserverToolInputSchema = zod_1.z.object({
+    project: zod_1.z
+        .string()
+        .optional()
+        .describe('Which project to stop serving in a monorepo context. If not provided, stops the default project server.'),
+});
+const stopDevserverToolOutputSchema = zod_1.z.object({
+    message: zod_1.z.string().describe('A message indicating the result of the operation.'),
+    logs: zod_1.z.array(zod_1.z.string()).optional().describe('The full logs from the dev server.'),
+});
+function stopDevserver(input, context) {
+    const projectKey = (0, dev_server_1.devServerKey)(input.project);
+    const devServer = context.devServers.get(projectKey);
+    if (!devServer) {
+        return (0, utils_1.createStructuredContentOutput)({
+            message: `Development server for project '${projectKey}' was not running.`,
+            logs: undefined,
+        });
+    }
+    devServer.stop();
+    context.devServers.delete(projectKey);
+    return (0, utils_1.createStructuredContentOutput)({
+        message: `Development server for project '${projectKey}' stopped.`,
+        logs: devServer.getServerLogs(),
+    });
+}
+exports.STOP_DEVSERVER_TOOL = (0, tool_registry_1.declareTool)({
+    name: 'stop_devserver',
+    title: 'Stop Development Server',
+    description: `
+<Purpose>
+Stops a running Angular development server ("ng serve") that was started with the "start_devserver" tool.
+</Purpose>
+<Use Cases>
+* **Stopping the Server:** Use this tool to terminate a running development server and retrieve the logs.
+</Use Cases>
+<Operational Notes>
+* This should be called to gracefully shut down the server and access the full log output.
+* This just sends a SIGTERM to the server and returns immediately; so the server might still be functional for a short
+  time after this is called. However note that this is not a blocker for starting a new devserver.
+</Operational Notes>
+`,
+    isReadOnly: true,
+    isLocalOnly: true,
+    inputSchema: stopDevserverToolInputSchema.shape,
+    outputSchema: stopDevserverToolOutputSchema.shape,
+    factory: (context) => (input) => {
+        return stopDevserver(input, context);
+    },
+});
+//# sourceMappingURL=stop-devserver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop-devserver.js","sourceRoot":"","sources":["stop-devserver.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAyBH,sCAkBC;AAzCD,6BAAwB;AACxB,iDAAgD;AAChD,uCAA4D;AAC5D,oDAA6F;AAE7F,MAAM,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yGAAyG,CAC1G;CACJ,CAAC,CAAC;AAIH,MAAM,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IACjF,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACpF,CAAC,CAAC;AAIH,SAAgB,aAAa,CAAC,KAA6B,EAAE,OAAuB;IAClF,MAAM,UAAU,GAAG,IAAA,yBAAY,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAErD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAA,qCAA6B,EAAC;YACnC,OAAO,EAAE,mCAAmC,UAAU,oBAAoB;YAC1E,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,IAAI,EAAE,CAAC;IACjB,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEtC,OAAO,IAAA,qCAA6B,EAAC;QACnC,OAAO,EAAE,mCAAmC,UAAU,YAAY;QAClE,IAAI,EAAE,SAAS,CAAC,aAAa,EAAE;KAChC,CAAC,CAAC;AACL,CAAC;AAEY,QAAA,mBAAmB,GAG5B,IAAA,2BAAW,EAAC;IACd,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,yBAAyB;IAChC,WAAW,EAAE;;;;;;;;;;;;CAYd;IACC,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,4BAA4B,CAAC,KAAK;IAC/C,YAAY,EAAE,6BAA6B,CAAC,KAAK;IACjD,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,OAAO,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;CACF,CAAC,CAAC"}

package/src/commands/mcp/tools/devserver/wait-for-devserver-build.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @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';
+/**
+ * How long to wait to give "ng serve" time to identify whether the watched workspace has changed.
+ */
+export declare const WATCH_DELAY = 1000;
+declare const waitForDevserverBuildToolInputSchema: z.ZodObject<{
+    project: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    project?: string | undefined;
+}, {
+    project?: string | undefined;
+    timeout?: number | undefined;
+}>;
+export type WaitForDevserverBuildToolInput = z.infer<typeof waitForDevserverBuildToolInputSchema>;
+declare const waitForDevserverBuildToolOutputSchema: z.ZodObject<{
+    status: z.ZodEnum<["success", "failure", "unknown", "timeout", "no_devserver_found"]>;
+    logs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: "success" | "timeout" | "failure" | "unknown" | "no_devserver_found";
+    logs?: string[] | undefined;
+}, {
+    status: "success" | "timeout" | "failure" | "unknown" | "no_devserver_found";
+    logs?: string[] | undefined;
+}>;
+export type WaitForDevserverBuildToolOutput = z.infer<typeof waitForDevserverBuildToolOutputSchema>;
+export declare function waitForDevserverBuild(input: WaitForDevserverBuildToolInput, context: McpToolContext): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        status: "success" | "timeout" | "failure" | "unknown" | "no_devserver_found";
+        logs?: string[] | undefined;
+    };
+}>;
+export declare const WAIT_FOR_DEVSERVER_BUILD_TOOL: McpToolDeclaration<typeof waitForDevserverBuildToolInputSchema.shape, typeof waitForDevserverBuildToolOutputSchema.shape>;
+export {};

package/src/commands/mcp/tools/devserver/wait-for-devserver-build.js

@@ -0,0 +1,100 @@
+"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.WAIT_FOR_DEVSERVER_BUILD_TOOL = exports.WATCH_DELAY = void 0;
+exports.waitForDevserverBuild = waitForDevserverBuild;
+const zod_1 = require("zod");
+const dev_server_1 = require("../../dev-server");
+const utils_1 = require("../../utils");
+const tool_registry_1 = require("../tool-registry");
+/**
+ * How long to wait to give "ng serve" time to identify whether the watched workspace has changed.
+ */
+exports.WATCH_DELAY = 1000;
+/**
+ * Default timeout for waiting for the build to complete.
+ */
+const DEFAULT_TIMEOUT = 180_000; // In milliseconds
+const waitForDevserverBuildToolInputSchema = zod_1.z.object({
+    project: zod_1.z
+        .string()
+        .optional()
+        .describe('Which project to wait for in a monorepo context. If not provided, waits for the default project server.'),
+    timeout: zod_1.z
+        .number()
+        .default(DEFAULT_TIMEOUT)
+        .describe(`The maximum time to wait for the build to complete, in milliseconds. This can't be lower than ${exports.WATCH_DELAY}.`),
+});
+const waitForDevserverBuildToolOutputSchema = zod_1.z.object({
+    status: zod_1.z
+        .enum(['success', 'failure', 'unknown', 'timeout', 'no_devserver_found'])
+        .describe("The status of the build if it's complete, or a status indicating why the wait operation failed."),
+    logs: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('The logs from the most recent build, if one exists.'),
+});
+function wait(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function waitForDevserverBuild(input, context) {
+    const projectKey = (0, dev_server_1.devServerKey)(input.project);
+    const devServer = context.devServers.get(projectKey);
+    const deadline = Date.now() + input.timeout;
+    if (!devServer) {
+        return (0, utils_1.createStructuredContentOutput)({
+            status: 'no_devserver_found',
+        });
+    }
+    await wait(exports.WATCH_DELAY);
+    while (devServer.isBuilding()) {
+        if (Date.now() > deadline) {
+            return (0, utils_1.createStructuredContentOutput)({
+                status: 'timeout',
+            });
+        }
+        await wait(exports.WATCH_DELAY);
+    }
+    return (0, utils_1.createStructuredContentOutput)({
+        ...devServer.getMostRecentBuild(),
+    });
+}
+exports.WAIT_FOR_DEVSERVER_BUILD_TOOL = (0, tool_registry_1.declareTool)({
+    name: 'wait_for_devserver_build',
+    title: 'Wait for Devserver Build',
+    description: `
+<Purpose>
+Waits for a dev server that was started with the "start_devserver" tool to complete its build, then reports the build logs from its most
+recent build.
+</Purpose>
+<Use Cases>
+* **Waiting for a build:** As long as a devserver is alive ("start_devserver" was called for this project and "stop_devserver" wasn't
+  called yet), then if you're making a file change and want to ensure it was successfully built, call this tool instead of any other build
+  tool or command. When it retuns you'll get build logs back **and** you'll know the user's devserver is up-to-date with the latest changes.
+</Use Cases>
+<Operational Notes>
+* This tool expects that a dev server was launched on the same project with the "start_devserver" tool, otherwise a "no_devserver_found"
+  status will be returned.
+* This tool will block until the build is complete or the timeout is reached. If you expect a long build process, consider increasing the
+  timeout. Timeouts on initial run (right after "start_devserver" calls) or after a big change are not necessarily indicative of an error.
+* If you encountered a timeout and it might be reasonable, just call this tool again.
+* If the dev server is not building, it will return quickly, with the logs from the last build.
+* A 'no_devserver_found' status can indicate the underlying server was stopped for some reason. Try first to call the "start_devserver"
+  tool again, before giving up.
+</Operational Notes>
+`,
+    isReadOnly: true,
+    isLocalOnly: true,
+    inputSchema: waitForDevserverBuildToolInputSchema.shape,
+    outputSchema: waitForDevserverBuildToolOutputSchema.shape,
+    factory: (context) => (input) => {
+        return waitForDevserverBuild(input, context);
+    },
+});
+//# sourceMappingURL=wait-for-devserver-build.js.map

package/src/commands/mcp/tools/devserver/wait-for-devserver-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-devserver-build.js","sourceRoot":"","sources":["wait-for-devserver-build.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAoDH,sDA2BC;AA7ED,6BAAwB;AACxB,iDAAgD;AAChD,uCAA4D;AAC5D,oDAA6F;AAE7F;;GAEG;AACU,QAAA,WAAW,GAAG,IAAI,CAAC;AAEhC;;GAEG;AACH,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,kBAAkB;AAEnD,MAAM,oCAAoC,GAAG,OAAC,CAAC,MAAM,CAAC;IACpD,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yGAAyG,CAC1G;IACH,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,OAAO,CAAC,eAAe,CAAC;SACxB,QAAQ,CACP,iGAAiG,mBAAW,GAAG,CAChH;CACJ,CAAC,CAAC;AAIH,MAAM,qCAAqC,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,MAAM,EAAE,OAAC;SACN,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;SACxE,QAAQ,CACP,iGAAiG,CAClG;IACH,IAAI,EAAE,OAAC;SACJ,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;CACnE,CAAC,CAAC;AAIH,SAAS,IAAI,CAAC,EAAU;IACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAEM,KAAK,UAAU,qBAAqB,CACzC,KAAqC,EACrC,OAAuB;IAEvB,MAAM,UAAU,GAAG,IAAA,yBAAY,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;IAE5C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAA,qCAA6B,EAAkC;YACpE,MAAM,EAAE,oBAAoB;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,CAAC,mBAAW,CAAC,CAAC;IACxB,OAAO,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC1B,OAAO,IAAA,qCAA6B,EAAkC;gBACpE,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,IAAI,CAAC,mBAAW,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,IAAA,qCAA6B,EAAkC;QACpE,GAAG,SAAS,CAAC,kBAAkB,EAAE;KAClC,CAAC,CAAC;AACL,CAAC;AAEY,QAAA,6BAA6B,GAGtC,IAAA,2BAAW,EAAC;IACd,IAAI,EAAE,0BAA0B;IAChC,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;CAoBd;IACC,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,oCAAoC,CAAC,KAAK;IACvD,YAAY,EAAE,qCAAqC,CAAC,KAAK;IACzD,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,OAAO,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC,CAAC"}