@angular/cli 21.1.0-next.0 → 21.1.0-next.2

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * @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<{
+    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/{start-devserver.js → devserver-start.js}

@@ -7,20 +7,19 @@
  * 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;
+exports.DEVSERVER_START_TOOL = void 0;
+exports.startDevserver = startDevserver;
 const zod_1 = require("zod");
-const dev_server_1 = require("../../dev-server");
-const host_1 = require("../../host");
+const devserver_1 = require("../../devserver");
 const utils_1 = require("../../utils");
 const tool_registry_1 = require("../tool-registry");
-const startDevServerToolInputSchema = zod_1.z.object({
+const devserverStartToolInputSchema = 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({
+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()
@@ -30,53 +29,53 @@ const startDevServerToolOutputSchema = zod_1.z.object({
 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) {
+async function startDevserver(input, context) {
+    const projectKey = (0, devserver_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),
+            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);
+    const port = await context.host.getAvailablePort();
+    devserver = new devserver_1.LocalDevserver({ host: context.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',
+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 "wait_for_devserver_build" to wait until
+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 "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
+* **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 'stop_devserver' to gracefully shut down the server and access the full log output.
+* Use 'devserver/stop' to gracefully shut down the server and access the full log output.
 </Operational Notes>
 `,
     isReadOnly: true,
     isLocalOnly: true,
-    inputSchema: startDevServerToolInputSchema.shape,
-    outputSchema: startDevServerToolOutputSchema.shape,
+    inputSchema: devserverStartToolInputSchema.shape,
+    outputSchema: devserverStartToolOutputSchema.shape,
     factory: (context) => (input) => {
-        return startDevServer(input, context, host_1.LocalWorkspaceHost);
+        return startDevserver(input, context);
     },
 });
-//# sourceMappingURL=start-devserver.js.map
+//# sourceMappingURL=devserver-start.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"devserver-start.js","sourceRoot":"","sources":["devserver-start.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAkCH,wCAsBC;AAtDD,6BAAwB;AACxB,+CAA+D;AAC/D,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,CAAC,KAA8B,EAAE,OAAuB;IAC1F,MAAM,UAAU,GAAG,IAAA,wBAAY,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,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAEnD,SAAS,GAAG,IAAI,0BAAc,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,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,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * @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<{
+    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): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        message: string;
+        logs: undefined;
+    };
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        message: string;
+        logs: string[];
+    };
+};
+export declare const DEVSERVER_STOP_TOOL: McpToolDeclaration<typeof devserverStopToolInputSchema.shape, typeof devserverStopToolOutputSchema.shape>;
+export {};

package/src/commands/mcp/tools/devserver/{stop-devserver.js → devserver-stop.js}

@@ -7,25 +7,25 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STOP_DEVSERVER_TOOL = void 0;
+exports.DEVSERVER_STOP_TOOL = void 0;
 exports.stopDevserver = stopDevserver;
 const zod_1 = require("zod");
-const dev_server_1 = require("../../dev-server");
+const devserver_1 = require("../../devserver");
 const utils_1 = require("../../utils");
 const tool_registry_1 = require("../tool-registry");
-const stopDevserverToolInputSchema = zod_1.z.object({
+const devserverStopToolInputSchema = 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({
+const devserverStopToolOutputSchema = 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);
+    const projectKey = (0, devserver_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.`,
@@ -33,18 +33,18 @@ function stopDevserver(input, context) {
         });
     }
     devServer.stop();
-    context.devServers.delete(projectKey);
+    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',
+exports.DEVSERVER_STOP_TOOL = (0, tool_registry_1.declareTool)({
+    name: 'devserver/stop',
     title: 'Stop Development Server',
     description: `
 <Purpose>
-Stops a running Angular development server ("ng serve") that was started with the "start_devserver" tool.
+Stops a running Angular development server ("ng serve") that was started with the "devserver/start" tool.
 </Purpose>
 <Use Cases>
 * **Stopping the Server:** Use this tool to terminate a running development server and retrieve the logs.
@@ -57,10 +57,10 @@ Stops a running Angular development server ("ng serve") that was started with th
 `,
     isReadOnly: true,
     isLocalOnly: true,
-    inputSchema: stopDevserverToolInputSchema.shape,
-    outputSchema: stopDevserverToolOutputSchema.shape,
+    inputSchema: devserverStopToolInputSchema.shape,
+    outputSchema: devserverStopToolOutputSchema.shape,
     factory: (context) => (input) => {
         return stopDevserver(input, context);
     },
 });
-//# sourceMappingURL=stop-devserver.js.map
+//# sourceMappingURL=devserver-stop.js.map

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

@@ -1 +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"}
+{"version":3,"file":"devserver-stop.js","sourceRoot":"","sources":["devserver-stop.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAyBH,sCAkBC;AAzCD,6BAAwB;AACxB,+CAA+C;AAC/C,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,wBAAY,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/devserver-wait-for-build.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 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 devserverWaitForBuildToolInputSchema: z.ZodObject<{
+    project: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type DevserverWaitForBuildToolInput = z.infer<typeof devserverWaitForBuildToolInputSchema>;
+declare const devserverWaitForBuildToolOutputSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        success: "success";
+        timeout: "timeout";
+        failure: "failure";
+        unknown: "unknown";
+        no_devserver_found: "no_devserver_found";
+    }>;
+    logs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type DevserverWaitForBuildToolOutput = z.infer<typeof devserverWaitForBuildToolOutputSchema>;
+export declare function waitForDevserverBuild(input: DevserverWaitForBuildToolInput, context: McpToolContext): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        status: "success" | "timeout" | "failure" | "unknown" | "no_devserver_found";
+        logs?: string[] | undefined;
+    };
+}>;
+export declare const DEVSERVER_WAIT_FOR_BUILD_TOOL: McpToolDeclaration<typeof devserverWaitForBuildToolInputSchema.shape, typeof devserverWaitForBuildToolOutputSchema.shape>;
+export {};

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

@@ -7,10 +7,10 @@
  * 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.DEVSERVER_WAIT_FOR_BUILD_TOOL = exports.WATCH_DELAY = void 0;
 exports.waitForDevserverBuild = waitForDevserverBuild;
 const zod_1 = require("zod");
-const dev_server_1 = require("../../dev-server");
+const devserver_1 = require("../../devserver");
 const utils_1 = require("../../utils");
 const tool_registry_1 = require("../tool-registry");
 /**
@@ -21,7 +21,7 @@ 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({
+const devserverWaitForBuildToolInputSchema = zod_1.z.object({
     project: zod_1.z
         .string()
         .optional()
@@ -31,7 +31,7 @@ const waitForDevserverBuildToolInputSchema = zod_1.z.object({
         .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({
+const devserverWaitForBuildToolOutputSchema = 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."),
@@ -44,8 +44,8 @@ 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 projectKey = (0, devserver_1.devserverKey)(input.project);
+    const devServer = context.devservers.get(projectKey);
     const deadline = Date.now() + input.timeout;
     if (!devServer) {
         return (0, utils_1.createStructuredContentOutput)({
@@ -65,36 +65,36 @@ async function waitForDevserverBuild(input, context) {
         ...devServer.getMostRecentBuild(),
     });
 }
-exports.WAIT_FOR_DEVSERVER_BUILD_TOOL = (0, tool_registry_1.declareTool)({
-    name: 'wait_for_devserver_build',
+exports.DEVSERVER_WAIT_FOR_BUILD_TOOL = (0, tool_registry_1.declareTool)({
+    name: 'devserver/wait_for_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
+Waits for a dev server that was started with the "devserver/start" 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
+* **Waiting for a build:** As long as a devserver is alive ("devserver/start" was called for this project and "devserver_stop" 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"
+* This tool expects that a dev server was launched on the same project with the "devserver/start" 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.
+  timeout. Timeouts on initial run (right after "devserver/start" 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"
+* A 'no_devserver_found' status can indicate the underlying server was stopped for some reason. Try first to call the "devserver/start"
   tool again, before giving up.
 </Operational Notes>
 `,
     isReadOnly: true,
     isLocalOnly: true,
-    inputSchema: waitForDevserverBuildToolInputSchema.shape,
-    outputSchema: waitForDevserverBuildToolOutputSchema.shape,
+    inputSchema: devserverWaitForBuildToolInputSchema.shape,
+    outputSchema: devserverWaitForBuildToolOutputSchema.shape,
     factory: (context) => (input) => {
         return waitForDevserverBuild(input, context);
     },
 });
-//# sourceMappingURL=wait-for-devserver-build.js.map
+//# sourceMappingURL=devserver-wait-for-build.js.map

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

@@ -1 +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"}
+{"version":3,"file":"devserver-wait-for-build.js","sourceRoot":"","sources":["devserver-wait-for-build.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAoDH,sDA2BC;AA7ED,6BAAwB;AACxB,+CAA+C;AAC/C,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,wBAAY,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"}

package/src/commands/mcp/tools/doc-search.d.ts

@@ -17,15 +17,5 @@ export declare const DOC_SEARCH_TOOL: import("./tool-registry").McpToolDeclarati
         breadcrumb: z.ZodString;
         url: z.ZodString;
         content: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        title: string;
-        breadcrumb: string;
-        url: string;
-        content?: string | undefined;
-    }, {
-        title: string;
-        breadcrumb: string;
-        url: string;
-        content?: string | undefined;
-    }>, "many">;
+    }, z.core.$strip>>;
 }>;

package/src/commands/mcp/tools/examples/database-discovery.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @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 { McpToolContext } from '../tool-registry';
+/**
+ * Attempts to find version-specific example databases from the user's installed
+ * versions of known Angular packages. It looks for a custom `angular` metadata property in each
+ * package's `package.json` to locate the database.
+ *
+ * @example A sample `package.json` `angular` field:
+ * ```json
+ * {
+ *   "angular": {
+ *     "examples": {
+ *       "format": "sqlite",
+ *       "path": "./resources/code-examples.db"
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @param workspacePath The absolute path to the user's `angular.json` file.
+ * @param logger The MCP tool context logger for reporting warnings.
+ * @param host The host interface for file system and module resolution operations.
+ * @returns A promise that resolves to an array of objects, each containing a database path and source.
+ */
+export declare function getVersionSpecificExampleDatabases(workspacePath: string, logger: McpToolContext['logger'], host: McpToolContext['host']): Promise<{
+    dbPath: string;
+    source: string;
+}[]>;

package/src/commands/mcp/tools/examples/database-discovery.js

@@ -0,0 +1,87 @@
+"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.getVersionSpecificExampleDatabases = getVersionSpecificExampleDatabases;
+const node_path_1 = require("node:path");
+/**
+ * A list of known Angular packages that may contain example databases.
+ * The tool will attempt to resolve and load example databases from these packages.
+ */
+const KNOWN_EXAMPLE_PACKAGES = ['@angular/core', '@angular/aria', '@angular/forms'];
+/**
+ * Attempts to find version-specific example databases from the user's installed
+ * versions of known Angular packages. It looks for a custom `angular` metadata property in each
+ * package's `package.json` to locate the database.
+ *
+ * @example A sample `package.json` `angular` field:
+ * ```json
+ * {
+ *   "angular": {
+ *     "examples": {
+ *       "format": "sqlite",
+ *       "path": "./resources/code-examples.db"
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @param workspacePath The absolute path to the user's `angular.json` file.
+ * @param logger The MCP tool context logger for reporting warnings.
+ * @param host The host interface for file system and module resolution operations.
+ * @returns A promise that resolves to an array of objects, each containing a database path and source.
+ */
+async function getVersionSpecificExampleDatabases(workspacePath, logger, host) {
+    const databases = [];
+    for (const packageName of KNOWN_EXAMPLE_PACKAGES) {
+        // 1. Resolve the path to package.json
+        let pkgJsonPath;
+        try {
+            pkgJsonPath = host.resolveModule(`${packageName}/package.json`, workspacePath);
+        }
+        catch (e) {
+            // This is not a warning because the user may not have all known packages installed.
+            continue;
+        }
+        // 2. Read and parse package.json, then find the database.
+        try {
+            const pkgJsonContent = await host.readFile(pkgJsonPath, 'utf-8');
+            const pkgJson = JSON.parse(pkgJsonContent);
+            const examplesInfo = pkgJson['angular']?.examples;
+            if (examplesInfo &&
+                examplesInfo.format === 'sqlite' &&
+                typeof examplesInfo.path === 'string') {
+                const packageDirectory = (0, node_path_1.dirname)(pkgJsonPath);
+                const dbPath = (0, node_path_1.resolve)(packageDirectory, examplesInfo.path);
+                // Ensure the resolved database path is within the package boundary.
+                const relativePath = (0, node_path_1.relative)(packageDirectory, dbPath);
+                if (relativePath.startsWith('..') || (0, node_path_1.isAbsolute)(relativePath)) {
+                    logger.warn(`Detected a potential path traversal attempt in '${pkgJsonPath}'. ` +
+                        `The path '${examplesInfo.path}' escapes the package boundary. ` +
+                        'This database will be skipped.');
+                    continue;
+                }
+                // Check the file size to prevent reading a very large file.
+                const stats = await host.stat(dbPath);
+                if (stats.size > 10 * 1024 * 1024) {
+                    // 10MB
+                    logger.warn(`The example database at '${dbPath}' is larger than 10MB (${stats.size} bytes). ` +
+                        'This is unexpected and the file will not be used.');
+                    continue;
+                }
+                const source = `package ${packageName}@${pkgJson.version}`;
+                databases.push({ dbPath, source });
+            }
+        }
+        catch (e) {
+            logger.warn(`Failed to read or parse version-specific examples metadata referenced in '${pkgJsonPath}': ${e instanceof Error ? e.message : e}.`);
+        }
+    }
+    return databases;
+}
+//# sourceMappingURL=database-discovery.js.map

package/src/commands/mcp/tools/examples/database-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-discovery.js","sourceRoot":"","sources":["database-discovery.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAiCH,gFAkEC;AAjGD,yCAAmE;AAGnE;;;GAGG;AACH,MAAM,sBAAsB,GAAG,CAAC,eAAe,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,KAAK,UAAU,kCAAkC,CACtD,aAAqB,EACrB,MAAgC,EAChC,IAA4B;IAE5B,MAAM,SAAS,GAAyC,EAAE,CAAC;IAE3D,KAAK,MAAM,WAAW,IAAI,sBAAsB,EAAE,CAAC;QACjD,sCAAsC;QACtC,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,WAAW,eAAe,EAAE,aAAa,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,oFAAoF;YACpF,SAAS;QACX,CAAC;QAED,0DAA0D;QAC1D,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;YAElD,IACE,YAAY;gBACZ,YAAY,CAAC,MAAM,KAAK,QAAQ;gBAChC,OAAO,YAAY,CAAC,IAAI,KAAK,QAAQ,EACrC,CAAC;gBACD,MAAM,gBAAgB,GAAG,IAAA,mBAAO,EAAC,WAAW,CAAC,CAAC;gBAC9C,MAAM,MAAM,GAAG,IAAA,mBAAO,EAAC,gBAAgB,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;gBAE5D,oEAAoE;gBACpE,MAAM,YAAY,GAAG,IAAA,oBAAQ,EAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;gBACxD,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAA,sBAAU,EAAC,YAAY,CAAC,EAAE,CAAC;oBAC9D,MAAM,CAAC,IAAI,CACT,mDAAmD,WAAW,KAAK;wBACjE,aAAa,YAAY,CAAC,IAAI,kCAAkC;wBAChE,gCAAgC,CACnC,CAAC;oBACF,SAAS;gBACX,CAAC;gBAED,4DAA4D;gBAC5D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACtC,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;oBAClC,OAAO;oBACP,MAAM,CAAC,IAAI,CACT,4BAA4B,MAAM,0BAA0B,KAAK,CAAC,IAAI,WAAW;wBAC/E,mDAAmD,CACtD,CAAC;oBACF,SAAS;gBACX,CAAC;gBAED,MAAM,MAAM,GAAG,WAAW,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC3D,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CACT,6EAA6E,WAAW,MACtF,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CACnC,GAAG,CACJ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/src/commands/mcp/tools/examples/database.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @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 { DatabaseSync } from 'node:sqlite';
+import type { FindExampleInput } from './schemas';
+/**
+ * Validates the schema version of the example database.
+ *
+ * @param db The database connection to validate.
+ * @param dbSource A string identifying the source of the database (e.g., 'bundled' or a version number).
+ * @throws An error if the schema version is missing or incompatible.
+ */
+export declare function validateDatabaseSchema(db: DatabaseSync, dbSource: string): void;
+export declare function queryDatabase(dbs: DatabaseSync[], input: FindExampleInput): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        examples: {
+            title: string;
+            summary: string;
+            keywords: string[];
+            required_packages: string[];
+            related_concepts: string[];
+            related_tools: string[];
+            content: string;
+            snippet: string;
+        }[];
+    };
+};