firebase-tools 14.3.0 → 14.4.0

package/lib/mcp/tools/dataconnect/converter.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sourceToText = exports.connectorToText = exports.schemaToText = void 0;
+exports.parseVariables = exports.graphqlResponseToToolResponse = exports.sourceToText = exports.connectorToText = exports.schemaToText = void 0;
 const js_yaml_1 = require("js-yaml");
+const types_1 = require("../../../dataconnect/types");
+const util_1 = require("../../util");
 function schemaToText(s) {
     return ((0, js_yaml_1.dump)({
         name: s.name,
@@ -31,3 +33,30 @@ function sourceToText(s) {
     return output;
 }
 exports.sourceToText = sourceToText;
+function graphqlResponseToToolResponse(g) {
+    var _a;
+    if ((0, types_1.isGraphQLResponse)(g)) {
+        const isError = ((_a = g.errors) === null || _a === void 0 ? void 0 : _a.length) > 0;
+        const contentString = `${isError ? "A GraphQL error occurred while executing the operation:" : ""}${JSON.stringify(g, null, 2)}`;
+        return {
+            isError,
+            content: [{ type: "text", text: contentString }],
+        };
+    }
+    else {
+        return (0, util_1.mcpError)(JSON.stringify(g, null, 2));
+    }
+}
+exports.graphqlResponseToToolResponse = graphqlResponseToToolResponse;
+function parseVariables(unparsedVariables) {
+    try {
+        const variables = JSON.parse(unparsedVariables || "{}");
+        if (typeof variables !== "object")
+            throw new Error("not an object");
+        return variables;
+    }
+    catch (e) {
+        throw new Error("Provided variables string `" + unparsedVariables + "` is not valid JSON.");
+    }
+}
+exports.parseVariables = parseVariables;

package/lib/mcp/tools/dataconnect/emulator.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDataConnectEmulatorClient = void 0;
+const types_js_1 = require("../../../emulator/types.js");
+const apiv2_js_1 = require("../../../apiv2.js");
+const dataplaneClient_js_1 = require("../../../dataconnect/dataplaneClient.js");
+function formatEndpoint(emulatorInfo) {
+    const host = emulatorInfo.host.includes(":") ? `[${emulatorInfo.host}]` : emulatorInfo.host;
+    return {
+        host: emulatorInfo.host,
+        port: emulatorInfo.port,
+        url: `http://${host}:${emulatorInfo.port}`,
+    };
+}
+async function getDataConnectEmulatorClient(hubClient) {
+    if (!hubClient) {
+        throw Error("Emulator Hub not found or is not running. Please ensure the emulator is started, you can start the Data Connect emualtor by running `firebase emulators:start --only dataconnect`.");
+    }
+    const emulators = await hubClient.getEmulators();
+    const dcEmulatorInfo = emulators[types_js_1.Emulators.DATACONNECT];
+    if (!dcEmulatorInfo) {
+        throw Error("No Data Connect Emulator found running, you can start the emualtor by running `firebase emulators:start --only dataconnect`.");
+    }
+    const emulatorDetails = formatEndpoint(dcEmulatorInfo);
+    const apiClient = new apiv2_js_1.Client({
+        urlPrefix: emulatorDetails.url,
+        apiVersion: dataplaneClient_js_1.DATACONNECT_API_VERSION,
+        auth: false,
+    });
+    return apiClient;
+}
+exports.getDataConnectEmulatorClient = getDataConnectEmulatorClient;

package/lib/mcp/tools/dataconnect/execute_graphql.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute_graphql = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const dataplane = require("../../../dataconnect/dataplaneClient.js");
+const fileUtils_js_1 = require("../../../dataconnect/fileUtils.js");
+const converter_js_1 = require("./converter.js");
+const emulator_js_1 = require("./emulator.js");
+exports.execute_graphql = (0, tool_js_1.tool)({
+    name: "execute_graphql",
+    description: "Executes an arbitrary GraphQL against a Data Connect service or its emulator.",
+    inputSchema: zod_1.z.object({
+        query: zod_1.z.string().describe("A GraphQL query or mutation to execute against the service"),
+        service_id: zod_1.z
+            .string()
+            .nullable()
+            .describe("The Firebase Data Connect service ID to look for. If there is only one service defined in firebase.json, this can be omitted and that will be used."),
+        variables: zod_1.z
+            .string()
+            .optional()
+            .describe("A stringified JSON object containing variables for the operation. MUST be valid JSON."),
+        use_emulator: zod_1.z.boolean().default(false).describe("Target the DataConnect emulator if true."),
+    }),
+    annotations: {
+        title: "Execute GraphQL Operation",
+        readOnlyHint: false,
+    },
+    _meta: {
+        requiresProject: true,
+        requiresAuth: true,
+    },
+}, async ({ query, service_id, variables: unparsedVariables, use_emulator }, { projectId, config, host }) => {
+    const serviceInfo = await (0, fileUtils_js_1.pickService)(projectId, config, service_id || undefined);
+    let apiClient;
+    if (use_emulator) {
+        apiClient = await (0, emulator_js_1.getDataConnectEmulatorClient)(await host.getEmulatorHubClient());
+    }
+    else {
+        apiClient = dataplane.dataconnectDataplaneClient();
+    }
+    const response = await dataplane.executeGraphQL(apiClient, serviceInfo.serviceName, {
+        name: "",
+        query,
+        variables: (0, converter_js_1.parseVariables)(unparsedVariables),
+    });
+    return (0, converter_js_1.graphqlResponseToToolResponse)(response.body);
+});

package/lib/mcp/tools/dataconnect/execute_graphql_read.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute_graphql_read = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const dataplane = require("../../../dataconnect/dataplaneClient.js");
+const fileUtils_js_1 = require("../../../dataconnect/fileUtils.js");
+const converter_js_1 = require("./converter.js");
+const emulator_js_1 = require("./emulator.js");
+exports.execute_graphql_read = (0, tool_js_1.tool)({
+    name: "execute_graphql_read",
+    description: "Executes an arbitrary GraphQL query against a Data Connect service or its emulator. Cannot write data.",
+    inputSchema: zod_1.z.object({
+        query: zod_1.z.string().describe("A GraphQL query to execute against the service"),
+        service_id: zod_1.z
+            .string()
+            .nullable()
+            .describe("The Firebase Data Connect service ID to look for. If there is only one service defined in firebase.json, this can be omitted and that will be used."),
+        variables: zod_1.z
+            .string()
+            .optional()
+            .describe("A stringified JSON object containing variables for the operation. MUST be valid JSON."),
+        use_emulator: zod_1.z.boolean().default(false).describe("Target the DataConnect emulator if true."),
+    }),
+    annotations: {
+        title: "Execute Data Connect GraphQL Query",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresProject: true,
+        requiresAuth: true,
+    },
+}, async ({ query, service_id, variables: unparsedVariables, use_emulator }, { projectId, config, host }) => {
+    const serviceInfo = await (0, fileUtils_js_1.pickService)(projectId, config, service_id || undefined);
+    let apiClient;
+    if (use_emulator) {
+        apiClient = await (0, emulator_js_1.getDataConnectEmulatorClient)(await host.getEmulatorHubClient());
+    }
+    else {
+        apiClient = dataplane.dataconnectDataplaneClient();
+    }
+    const response = await dataplane.executeGraphQLRead(apiClient, serviceInfo.serviceName, {
+        name: "",
+        query,
+        variables: (0, converter_js_1.parseVariables)(unparsedVariables),
+    });
+    return (0, converter_js_1.graphqlResponseToToolResponse)(response.body);
+});

package/lib/mcp/tools/dataconnect/execute_mutation.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute_mutation = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const dataplane = require("../../../dataconnect/dataplaneClient.js");
+const fileUtils_js_1 = require("../../../dataconnect/fileUtils.js");
+const converter_js_1 = require("./converter.js");
+const emulator_js_1 = require("./emulator.js");
+exports.execute_mutation = (0, tool_js_1.tool)({
+    name: "execute_mutation",
+    description: "Executes a deployed Data Connect mutation against a service or its emulator. Can read and write data.",
+    inputSchema: zod_1.z.object({
+        operationName: zod_1.z.string().describe("The name of the deployed operation you want to execute"),
+        service_id: zod_1.z
+            .string()
+            .nullable()
+            .describe("The Firebase Data Connect service ID to look for. If there is only one service defined in firebase.json, this can be omitted and that will be used."),
+        connector_id: zod_1.z
+            .string()
+            .nullable()
+            .describe("The Firebase Data Connect connector ID to look for. If there is only one connector defined in dataconnect.yaml, this can be omitted and that will be used."),
+        variables: zod_1.z
+            .string()
+            .optional()
+            .describe("A stringified JSON object containing the variables needed to execute the operation. The value MUST be able to be parsed as a JSON object."),
+        use_emulator: zod_1.z.boolean().default(false).describe("Target the DataConnect emulator if true."),
+    }),
+    annotations: {
+        title: "Execute Data Connect Connector Mutation",
+        readOnlyHint: false,
+    },
+    _meta: {
+        requiresProject: true,
+        requiresAuth: true,
+    },
+}, async ({ operationName, service_id, connector_id, variables: unparsedVariables, use_emulator }, { projectId, config, host }) => {
+    const serviceInfo = await (0, fileUtils_js_1.pickService)(projectId, config, service_id || undefined);
+    let apiClient;
+    if (!connector_id) {
+        if (serviceInfo.connectorInfo.length === 0) {
+            return (0, util_js_1.mcpError)(`Service ${serviceInfo.serviceName} has no connectors`, "NO_CONNECTORS_FOUND");
+        }
+        if (serviceInfo.connectorInfo.length > 1) {
+            return (0, util_js_1.mcpError)(`Service ${serviceInfo.serviceName} has more than one connector. Please use the connector_id argument to specify which connector this operation is part of.`, "MULTIPLE_CONNECTORS_FOUND");
+        }
+        connector_id = serviceInfo.connectorInfo[0].connectorYaml.connectorId;
+    }
+    const connectorPath = `${serviceInfo.serviceName}/connectors/${connector_id}`;
+    if (use_emulator) {
+        apiClient = await (0, emulator_js_1.getDataConnectEmulatorClient)(await host.getEmulatorHubClient());
+    }
+    else {
+        apiClient = dataplane.dataconnectDataplaneClient();
+    }
+    const response = await dataplane.executeGraphQLMutation(apiClient, connectorPath, {
+        operationName,
+        variables: (0, converter_js_1.parseVariables)(unparsedVariables),
+    });
+    return (0, converter_js_1.graphqlResponseToToolResponse)(response.body);
+});

package/lib/mcp/tools/dataconnect/execute_query.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute_query = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const dataplane = require("../../../dataconnect/dataplaneClient.js");
+const fileUtils_js_1 = require("../../../dataconnect/fileUtils.js");
+const converter_js_1 = require("./converter.js");
+const emulator_js_1 = require("./emulator.js");
+exports.execute_query = (0, tool_js_1.tool)({
+    name: "execute_query",
+    description: "Executes a deployed Data Connect query against a service or its emulator. Cannot write any data.",
+    inputSchema: zod_1.z.object({
+        operationName: zod_1.z.string().describe("The name of the deployed operation you want to execute"),
+        service_id: zod_1.z
+            .string()
+            .nullable()
+            .describe("The Firebase Data Connect service ID to look for. If there is only one service defined in firebase.json, this can be omitted and that will be used."),
+        connector_id: zod_1.z
+            .string()
+            .nullable()
+            .describe("The Firebase Data Connect connector ID to look for. If there is only one connector defined in dataconnect.yaml, this can be omitted and that will be used."),
+        variables: zod_1.z
+            .string()
+            .optional()
+            .describe("A stringified JSON object containing the variables needed to execute the operation. The value MUST be able to be parsed as a JSON object."),
+        use_emulator: zod_1.z.boolean().default(false).describe("Target the DataConnect emulator if true."),
+    }),
+    annotations: {
+        title: "Executes a deployed Data Connect query.",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresProject: true,
+        requiresAuth: true,
+    },
+}, async ({ operationName, service_id, connector_id, variables: unparsedVariables, use_emulator }, { projectId, config, host }) => {
+    const serviceInfo = await (0, fileUtils_js_1.pickService)(projectId, config, service_id || undefined);
+    let apiClient;
+    if (!connector_id) {
+        if (serviceInfo.connectorInfo.length === 0) {
+            return (0, util_js_1.mcpError)(`Service ${serviceInfo.serviceName} has no connectors`, "NO_CONNECTORS_FOUND");
+        }
+        if (serviceInfo.connectorInfo.length > 1) {
+            return (0, util_js_1.mcpError)(`Service ${serviceInfo.serviceName} has more than one connector. Please use the connector_id argument to specify which connector this operation is part of.`, "MULTIPLE_CONNECTORS_FOUND");
+        }
+        connector_id = serviceInfo.connectorInfo[0].connectorYaml.connectorId;
+    }
+    const connectorPath = `${serviceInfo.serviceName}/connectors/${connector_id}`;
+    if (use_emulator) {
+        apiClient = await (0, emulator_js_1.getDataConnectEmulatorClient)(await host.getEmulatorHubClient());
+    }
+    else {
+        apiClient = dataplane.dataconnectDataplaneClient();
+    }
+    const response = await dataplane.executeGraphQLQuery(apiClient, connectorPath, {
+        operationName,
+        variables: (0, converter_js_1.parseVariables)(unparsedVariables),
+    });
+    return (0, converter_js_1.graphqlResponseToToolResponse)(response.body);
+});

package/lib/mcp/tools/dataconnect/{generate_dataconnect_operation.js → generate_operation.js}

@@ -1,33 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generate_dataconnect_operation = void 0;
+exports.generate_operation = void 0;
 const zod_1 = require("zod");
 const tool_js_1 = require("../../tool.js");
 const util_js_1 = require("../../util.js");
 const fdcExperience_js_1 = require("../../../gif/fdcExperience.js");
 const fileUtils_js_1 = require("../../../dataconnect/fileUtils.js");
-exports.generate_dataconnect_operation = (0, tool_js_1.tool)({
-    name: "generate_dataconnect_operation",
+exports.generate_operation = (0, tool_js_1.tool)({
+    name: "generate_operation",
     description: "Generates a single Firebase Data Connect query or mutation based on the currently deployed schema and the provided prompt.",
     inputSchema: zod_1.z.object({
         prompt: zod_1.z
             .string()
-            .describe("Write the prompt like you're talking to a person, describe the task you're trying to accomplish and give details that are specific to the users requst"),
-        serviceId: zod_1.z
+            .describe("Write the prompt like you're talking to a person, describe the task you're trying to accomplish and give details that are specific to the users request"),
+        service_id: zod_1.z
             .string()
             .nullish()
-            .describe("Optional: Uses the serviceId from the firebase.json file if nothing provided. The serviceId of the deployed Firebase resource."),
+            .describe("Optional: Uses the service ID from the firebase.json file if nothing provided. The service ID of the deployed Firebase resource."),
     }),
     annotations: {
-        title: "Generate a Firebase Data Connect Operation on a deployed Firebase Data Connect Schema.",
+        title: "Generate Data Connect Operation",
         readOnlyHint: true,
     },
     _meta: {
         requiresProject: true,
         requiresAuth: true,
     },
-}, async ({ prompt, serviceId }, { projectId, config }) => {
-    const serviceInfo = await (0, fileUtils_js_1.pickService)(projectId, config, serviceId || undefined);
+}, async ({ prompt, service_id }, { projectId, config }) => {
+    const serviceInfo = await (0, fileUtils_js_1.pickService)(projectId, config, service_id || undefined);
     const schema = await (0, fdcExperience_js_1.generateOperation)(prompt, serviceInfo.serviceName, projectId);
     return (0, util_js_1.toContent)(schema);
 });

package/lib/mcp/tools/dataconnect/{generate_dataconnect_schema.js → generate_schema.js}

@@ -1,18 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generate_dataconnect_schema = void 0;
+exports.generate_schema = void 0;
 const zod_1 = require("zod");
 const tool_js_1 = require("../../tool.js");
 const util_js_1 = require("../../util.js");
 const fdcExperience_js_1 = require("../../../gif/fdcExperience.js");
-exports.generate_dataconnect_schema = (0, tool_js_1.tool)({
-    name: "generate_dataconnect_schema",
+exports.generate_schema = (0, tool_js_1.tool)({
+    name: "generate_schema",
     description: "Generates a Firebase Data Connect Schema based on the users description of an app.",
     inputSchema: zod_1.z.object({
         prompt: zod_1.z.string().describe("A description of an app that you are interested in building"),
     }),
     annotations: {
-        title: "Generate a Firebase Data Connect Schema for a new Firebase project.",
+        title: "Generate Data Connect Schema",
         readOnlyHint: true,
     },
     _meta: {

package/lib/mcp/tools/dataconnect/{get_dataconnect_connector.js → get_connector.js}

@@ -1,31 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.get_dataconnect_connector = void 0;
+exports.get_connectors = void 0;
 const zod_1 = require("zod");
 const tool_js_1 = require("../../tool.js");
 const util_js_1 = require("../../util.js");
-const client = require("../../../dataconnect/client");
+const client = require("../../../dataconnect/client.js");
 const fileUtils_js_1 = require("../../../dataconnect/fileUtils.js");
 const converter_js_1 = require("./converter.js");
-exports.get_dataconnect_connector = (0, tool_js_1.tool)({
-    name: "get_dataconnect_connector",
+exports.get_connectors = (0, tool_js_1.tool)({
+    name: "get_connectors",
     description: "Get the Firebase Data Connect Connectors in the project, which includes the pre-defined GraphQL queries accessible to client SDKs.",
     inputSchema: zod_1.z.object({
-        serviceId: zod_1.z
+        service_id: zod_1.z
             .string()
             .nullable()
-            .describe("The Firebase Data Connect service ID to look for. By default, it would pick the the service ID project directory."),
+            .describe("The Firebase Data Connect service ID to look for. If there is only one service defined in firebase.json, this can be omitted and that will be used."),
     }),
     annotations: {
-        title: "Obtain the Firebase Data Connect Connectors that's available in the backend",
+        title: "Get Data Connect Connectors",
         readOnlyHint: true,
     },
     _meta: {
         requiresProject: true,
         requiresAuth: true,
     },
-}, async ({ serviceId }, { projectId, config }) => {
-    const serviceInfo = await (0, fileUtils_js_1.pickService)(projectId, config, serviceId || undefined);
+}, async ({ service_id }, { projectId, config }) => {
+    const serviceInfo = await (0, fileUtils_js_1.pickService)(projectId, config, service_id || undefined);
     const connectors = await client.listConnectors(serviceInfo.serviceName, ["*"]);
     return (0, util_js_1.toContent)(connectors.map(converter_js_1.connectorToText).join("\n\n"));
 });

package/lib/mcp/tools/dataconnect/{get_dataconnect_schema.js → get_schema.js}

@@ -1,31 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.get_dataconnect_schema = void 0;
+exports.get_schema = void 0;
 const zod_1 = require("zod");
 const tool_js_1 = require("../../tool.js");
 const util_js_1 = require("../../util.js");
-const client = require("../../../dataconnect/client");
+const client = require("../../../dataconnect/client.js");
 const fileUtils_js_1 = require("../../../dataconnect/fileUtils.js");
 const converter_js_1 = require("./converter.js");
-exports.get_dataconnect_schema = (0, tool_js_1.tool)({
-    name: "get_dataconnect_schema",
-    description: "List the Firebase Data Connect Schema in the project, which includes Cloud SQL data sources and the GraphQL Schema describing what tables are available.",
+exports.get_schema = (0, tool_js_1.tool)({
+    name: "get_schema",
+    description: "Retrieve information about the Firebase Data Connect Schema in the project, including Cloud SQL data sources and the GraphQL Schema describing the data model.",
     inputSchema: zod_1.z.object({
-        serviceId: zod_1.z
+        service_id: zod_1.z
             .string()
             .nullable()
-            .describe("The Firebase Data Connect service ID to look for. By default, it would pick the the service ID project directory."),
+            .describe("The Firebase Data Connect service ID to look for. If there is only one service defined in firebase.json, this can be omitted and that will be used."),
     }),
     annotations: {
-        title: "Obtain the Firebase Data Connect Schemas that's available in the backend",
+        title: "Get Data Connect Schemas",
         readOnlyHint: true,
     },
     _meta: {
         requiresProject: true,
         requiresAuth: true,
     },
-}, async ({ serviceId }, { projectId, config }) => {
-    const serviceInfo = await (0, fileUtils_js_1.pickService)(projectId, config, serviceId || undefined);
+}, async ({ service_id }, { projectId, config }) => {
+    const serviceInfo = await (0, fileUtils_js_1.pickService)(projectId, config, service_id || undefined);
     const schemas = await client.listSchemas(serviceInfo.serviceName, ["*"]);
     return (0, util_js_1.toContent)(schemas === null || schemas === void 0 ? void 0 : schemas.map(converter_js_1.schemaToText).join("\n\n"));
 });

package/lib/mcp/tools/dataconnect/index.js

@@ -1,15 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dataconnectTools = void 0;
-const generate_dataconnect_operation_js_1 = require("./generate_dataconnect_operation.js");
-const generate_dataconnect_schema_js_1 = require("./generate_dataconnect_schema.js");
-const list_dataconnect_services_js_1 = require("./list_dataconnect_services.js");
-const get_dataconnect_schema_js_1 = require("./get_dataconnect_schema.js");
-const get_dataconnect_connector_js_1 = require("./get_dataconnect_connector.js");
+const list_services_js_1 = require("./list_services.js");
+const get_schema_js_1 = require("./get_schema.js");
+const get_connector_js_1 = require("./get_connector.js");
+const execute_graphql_js_1 = require("./execute_graphql.js");
+const execute_graphql_read_js_1 = require("./execute_graphql_read.js");
+const execute_query_js_1 = require("./execute_query.js");
+const execute_mutation_js_1 = require("./execute_mutation.js");
 exports.dataconnectTools = [
-    list_dataconnect_services_js_1.list_dataconnect_services,
-    generate_dataconnect_schema_js_1.generate_dataconnect_schema,
-    generate_dataconnect_operation_js_1.generate_dataconnect_operation,
-    get_dataconnect_schema_js_1.get_dataconnect_schema,
-    get_dataconnect_connector_js_1.get_dataconnect_connector,
+    list_services_js_1.list_services,
+    get_schema_js_1.get_schema,
+    get_connector_js_1.get_connectors,
+    execute_graphql_js_1.execute_graphql,
+    execute_graphql_read_js_1.execute_graphql_read,
+    execute_mutation_js_1.execute_mutation,
+    execute_query_js_1.execute_query,
 ];

package/lib/mcp/tools/dataconnect/{list_dataconnect_services.js → list_services.js}

@@ -1,16 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.list_dataconnect_services = void 0;
+exports.list_services = void 0;
 const zod_1 = require("zod");
 const tool_js_1 = require("../../tool.js");
 const util_js_1 = require("../../util.js");
-const client = require("../../../dataconnect/client");
-exports.list_dataconnect_services = (0, tool_js_1.tool)({
-    name: "list_dataconnect_services",
+const client = require("../../../dataconnect/client.js");
+exports.list_services = (0, tool_js_1.tool)({
+    name: "list_services",
     description: "List the Firebase Data Connect services available in the current project.",
     inputSchema: zod_1.z.object({}),
     annotations: {
-        title: "List the Firebase Data Connect Services that's available in the backend",
+        title: "List Data Connect Services",
         readOnlyHint: true,
     },
     _meta: {

package/lib/mcp/tools/firestore/converter.js

@@ -1,7 +1,53 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.firestoreDocumentToJson = void 0;
+exports.firestoreDocumentToJson = exports.convertInputToValue = void 0;
 const logger_1 = require("../../../logger");
+function convertInputToValue(inputValue) {
+    if (inputValue === null) {
+        return { nullValue: null };
+    }
+    else if (typeof inputValue === "boolean") {
+        return { booleanValue: inputValue };
+    }
+    else if (typeof inputValue === "number") {
+        if (Number.isInteger(inputValue)) {
+            return { integerValue: inputValue.toString() };
+        }
+        else {
+            return { doubleValue: inputValue };
+        }
+    }
+    else if (typeof inputValue === "string") {
+        return { stringValue: inputValue };
+    }
+    else if (Array.isArray(inputValue)) {
+        const arrayValue = {
+            values: inputValue.map((item) => convertInputToValue(item)),
+        };
+        return { arrayValue: arrayValue };
+    }
+    else if (typeof inputValue === "object") {
+        if (inputValue.hasOwnProperty("latitude") &&
+            typeof inputValue.latitude === "number" &&
+            inputValue.hasOwnProperty("longitude") &&
+            typeof inputValue.longitude === "number") {
+            return { geoPointValue: inputValue };
+        }
+        const mapValue = {
+            fields: {},
+        };
+        for (const key in inputValue) {
+            if (Object.prototype.hasOwnProperty.call(inputValue, key)) {
+                if (mapValue.fields) {
+                    mapValue.fields[key] = convertInputToValue(inputValue[key]);
+                }
+            }
+        }
+        return { mapValue: mapValue };
+    }
+    return { nullValue: null };
+}
+exports.convertInputToValue = convertInputToValue;
 function firestoreValueToJson(firestoreValue) {
     var _a, _b;
     if ("nullValue" in firestoreValue)

package/lib/mcp/tools/firestore/delete_document.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delete_document = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const firestore_js_1 = require("../../../gcp/firestore.js");
+const delete_js_1 = require("../../../firestore/delete.js");
+exports.delete_document = (0, tool_js_1.tool)({
+    name: "delete_document",
+    description: "Deletes a Firestore documents from a database in the current project by full document paths. Use this if you know the exact path of a document.",
+    inputSchema: zod_1.z.object({
+        path: zod_1.z
+            .string()
+            .describe("A document path (e.g. `collectionName/documentId` or `parentCollection/parentDocument/collectionName/documentId`)"),
+    }),
+    annotations: {
+        title: "Delete Firestore document",
+        destructiveHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: true,
+    },
+}, async ({ path }, { projectId }) => {
+    const { documents, missing } = await (0, firestore_js_1.getDocuments)(projectId, [path]);
+    if (missing.length > 0 && documents && documents.length === 0) {
+        return (0, util_js_1.mcpError)(`None of the specified documents were found in project '${projectId}'`);
+    }
+    const firestoreDelete = new delete_js_1.FirestoreDelete(projectId, path, { databaseId: "(default)" });
+    await firestoreDelete.execute();
+    const { documents: postDeleteDocuments, missing: postDeleteMissing } = await (0, firestore_js_1.getDocuments)(projectId, [path]);
+    if (postDeleteMissing.length > 0 && postDeleteDocuments.length === 0) {
+        return (0, util_js_1.toContent)(`Successfully removed document located at : ${path}`);
+    }
+    return (0, util_js_1.mcpError)(`Failed to remove document located at : ${path}`);
+});

package/lib/mcp/tools/firestore/{get_firestore_documents.js → get_documents.js}

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.get_firestore_documents = void 0;
+exports.get_documents = void 0;
 const zod_1 = require("zod");
 const tool_js_1 = require("../../tool.js");
 const util_js_1 = require("../../util.js");
 const firestore_js_1 = require("../../../gcp/firestore.js");
 const converter_js_1 = require("./converter.js");
-exports.get_firestore_documents = (0, tool_js_1.tool)({
-    name: "get_firestore_documents",
+exports.get_documents = (0, tool_js_1.tool)({
+    name: "get_documents",
     description: "Retrieves one or more Firestore documents from a database in the current project by full document paths. Use this if you know the exact path of a document.",
     inputSchema: zod_1.z.object({
         paths: zod_1.z

package/lib/mcp/tools/firestore/index.js

@@ -1,11 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.firestoreTools = void 0;
-const get_firestore_documents_1 = require("./get_firestore_documents");
-const get_firestore_rules_1 = require("./get_firestore_rules");
-const list_firestore_collections_1 = require("./list_firestore_collections");
+const delete_document_1 = require("./delete_document");
+const get_documents_1 = require("./get_documents");
+const list_collections_1 = require("./list_collections");
+const query_collection_1 = require("./query_collection");
+const validate_rules_1 = require("../rules/validate_rules");
+const get_rules_1 = require("../rules/get_rules");
 exports.firestoreTools = [
-    list_firestore_collections_1.list_firestore_collections,
-    get_firestore_documents_1.get_firestore_documents,
-    get_firestore_rules_1.get_firestore_rules,
+    delete_document_1.delete_document,
+    get_documents_1.get_documents,
+    list_collections_1.list_collections,
+    query_collection_1.query_collection,
+    (0, get_rules_1.getRulesTool)("Firestore", "cloud.firestore"),
+    (0, validate_rules_1.validateRulesTool)("Firestore"),
 ];