firebase-tools 14.15.1 → 14.15.2

package/lib/commands/dataconnect-sdk-generate.js

@@ -8,37 +8,41 @@ const projectUtils_1 = require("../projectUtils");
 const load_1 = require("../dataconnect/load");
 const logger_1 = require("../logger");
 const auth_1 = require("../auth");
+const utils_1 = require("../utils");
 exports.command = new command_1.Command("dataconnect:sdk:generate")
     .description("generate typed SDKs for your Data Connect connectors")
     .option("--watch", "watch for changes to your connector GQL files and regenerate your SDKs when updates occur")
     .action(async (options) => {
     const projectId = (0, projectUtils_1.needProjectId)(options);
     const serviceInfos = await (0, load_1.loadAll)(projectId, options.config);
-    for (const serviceInfo of serviceInfos) {
-        const configDir = serviceInfo.sourceDirectory;
-        const hasGeneratables = serviceInfo.connectorInfo.some((c) => {
-            var _a, _b, _c, _d;
-            return (((_a = c.connectorYaml.generate) === null || _a === void 0 ? void 0 : _a.javascriptSdk) ||
-                ((_b = c.connectorYaml.generate) === null || _b === void 0 ? void 0 : _b.kotlinSdk) ||
-                ((_c = c.connectorYaml.generate) === null || _c === void 0 ? void 0 : _c.swiftSdk) ||
-                ((_d = c.connectorYaml.generate) === null || _d === void 0 ? void 0 : _d.dartSdk));
+    const serviceInfosWithSDKs = serviceInfos.filter((serviceInfo) => serviceInfo.connectorInfo.some((c) => {
+        var _a, _b, _c, _d;
+        return (((_a = c.connectorYaml.generate) === null || _a === void 0 ? void 0 : _a.javascriptSdk) ||
+            ((_b = c.connectorYaml.generate) === null || _b === void 0 ? void 0 : _b.kotlinSdk) ||
+            ((_c = c.connectorYaml.generate) === null || _c === void 0 ? void 0 : _c.swiftSdk) ||
+            ((_d = c.connectorYaml.generate) === null || _d === void 0 ? void 0 : _d.dartSdk));
+    }));
+    if (!serviceInfosWithSDKs.length) {
+        logger_1.logger.warn("No generated SDKs have been declared in connector.yaml files.");
+        logger_1.logger.warn(`Run ${clc.bold("firebase init dataconnect:sdk")} to configure a generated SDK.`);
+        logger_1.logger.warn(`See https://firebase.google.com/docs/data-connect/web-sdk for more details of how to configure generated SDKs.`);
+        return;
+    }
+    async function generateSDK(serviceInfo) {
+        return dataconnectEmulator_1.DataConnectEmulator.generate({
+            configDir: serviceInfo.sourceDirectory,
+            watch: options.watch,
+            account: (0, auth_1.getProjectDefaultAccount)(options.projectRoot),
         });
-        if (!hasGeneratables) {
-            logger_1.logger.warn("No generated SDKs have been declared in connector.yaml files.");
-            logger_1.logger.warn(`Run ${clc.bold("firebase init dataconnect:sdk")} to configure a generated SDK.`);
-            logger_1.logger.warn(`See https://firebase.google.com/docs/data-connect/web-sdk for more details of how to configure generated SDKs.`);
-            return;
-        }
-        for (const conn of serviceInfo.connectorInfo) {
-            const account = (0, auth_1.getProjectDefaultAccount)(options.projectRoot);
-            const output = await dataconnectEmulator_1.DataConnectEmulator.generate({
-                configDir,
-                connectorId: conn.connectorYaml.connectorId,
-                watch: options.watch,
-                account,
-            });
-            logger_1.logger.info(output);
-            logger_1.logger.info(`Generated SDKs for ${conn.connectorYaml.connectorId}`);
+    }
+    if (options.watch) {
+        await Promise.race(serviceInfosWithSDKs.map(generateSDK));
+    }
+    else {
+        for (const s of serviceInfosWithSDKs) {
+            await generateSDK(s);
         }
+        const services = serviceInfosWithSDKs.map((s) => s.dataConnectYaml.serviceId).join(", ");
+        (0, utils_1.logLabeledSuccess)("dataconnect", `Successfully Generated SDKs for services: ${clc.bold(services)}`);
     }
 });

package/lib/deploy/functions/build.js

@@ -3,11 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.applyPrefix = exports.toBackend = exports.envWithTypes = exports.resolveBackend = exports.AllIngressSettings = exports.AllVpcEgressSettings = exports.AllFunctionsPlatforms = exports.isBlockingTriggered = exports.isTaskQueueTriggered = exports.isScheduleTriggered = exports.isEventTriggered = exports.isCallableTriggered = exports.isHttpsTriggered = exports.of = exports.empty = void 0;
 const backend = require("./backend");
 const proto = require("../../gcp/proto");
-const api = require("../../.../../api");
+const api = require("../../api");
 const params = require("./params");
 const error_1 = require("../../error");
 const functional_1 = require("../../functional");
-const env_1 = require("../../functions/env");
 const cel_1 = require("./cel");
 function empty() {
     return {
@@ -56,17 +55,7 @@ exports.AllIngressSettings = [
     "ALLOW_INTERNAL_AND_GCLB",
 ];
 async function resolveBackend(opts) {
-    let paramValues = {};
-    paramValues = await params.resolveParams(opts.build.params, opts.firebaseConfig, envWithTypes(opts.build.params, opts.userEnvs), opts.nonInteractive, opts.isEmulator);
-    const toWrite = {};
-    for (const paramName of Object.keys(paramValues)) {
-        const paramValue = paramValues[paramName];
-        if (Object.prototype.hasOwnProperty.call(opts.userEnvs, paramName) || paramValue.internal) {
-            continue;
-        }
-        toWrite[paramName] = paramValue.toString();
-    }
-    (0, env_1.writeUserEnvs)(toWrite, opts.userEnvOpt);
+    const paramValues = await params.resolveParams(opts.build.params, opts.firebaseConfig, envWithTypes(opts.build.params, opts.userEnvs), opts.nonInteractive, opts.isEmulator);
     return { backend: toBackend(opts.build, paramValues), envs: paramValues };
 }
 exports.resolveBackend = resolveBackend;

package/lib/deploy/functions/prepare.js

@@ -59,6 +59,7 @@ async function prepare(context, options, payload) {
     if (allowFunctionsConfig && checkAPIsEnabled[1]) {
         runtimeConfig = Object.assign(Object.assign({}, runtimeConfig), (await (0, prepareFunctionsUpload_1.getFunctionsConfig)(projectId)));
     }
+    context.hasRuntimeConfig = Object.keys(runtimeConfig).some((k) => k !== "firebase");
     const wantBuilds = await loadCodebases(context.config, options, firebaseConfig, runtimeConfig, context.filters);
     if (Object.values(wantBuilds).some((b) => b.extensions)) {
         const extContext = {};
@@ -83,11 +84,11 @@ async function prepare(context, options, payload) {
         const { backend: wantBackend, envs: resolvedEnvs } = await build.resolveBackend({
             build: wantBuild,
             firebaseConfig,
-            userEnvOpt,
             userEnvs,
             nonInteractive: options.nonInteractive,
             isEmulator: false,
         });
+        functionsEnv.writeResolvedParams(resolvedEnvs, userEnvs, userEnvOpt);
         let hasEnvsFromParams = false;
         wantBackend.environmentVariables = envs;
         for (const envName of Object.keys(resolvedEnvs)) {

package/lib/deploy/functions/runtimes/discovery/index.js

@@ -6,7 +6,7 @@ const fs = require("fs");
 const path = require("path");
 const yaml = require("yaml");
 const logger_1 = require("../../../../logger");
-const api = require("../../.../../../../api");
+const api = require("../../../../api");
 const v1alpha1 = require("./v1alpha1");
 const error_1 = require("../../../../error");
 const TIMEOUT_OVERRIDE_ENV_VAR = "FUNCTIONS_DISCOVERY_TIMEOUT";

package/lib/emulator/auth/operations.js

@@ -1512,7 +1512,16 @@ async function mfaSignInFinalize(state, reqBody) {
     (0, errors_1.assert)(sessionInfo, "MISSING_SESSION_INFO");
     const phoneNumber = verifyPhoneNumber(state, sessionInfo, code);
     let { user, signInProvider } = parsePendingCredential(state, reqBody.mfaPendingCredential);
-    const enrollment = (_b = user.mfaInfo) === null || _b === void 0 ? void 0 : _b.find((enrollment) => enrollment.unobfuscatedPhoneInfo === phoneNumber);
+    const enrollment = (_b = user.mfaInfo) === null || _b === void 0 ? void 0 : _b.find((enrollment) => {
+        if (enrollment.unobfuscatedPhoneInfo === phoneNumber) {
+            return true;
+        }
+        if (!!enrollment.unobfuscatedPhoneInfo &&
+            obfuscatePhoneNumber(enrollment.unobfuscatedPhoneInfo) === phoneNumber) {
+            return true;
+        }
+        return false;
+    });
     const { updates, extraClaims } = await fetchBlockingFunction(state, state_1.BlockingFunctionEvents.BEFORE_SIGN_IN, user, { signInMethod: signInProvider, signInSecondFactor: "phone" });
     user = state.updateUserByLocalId(user.localId, Object.assign(Object.assign({}, updates), { lastLoginAt: Date.now().toString() }));
     (0, errors_1.assert)(enrollment && enrollment.mfaEnrollmentId, "MFA_ENROLLMENT_NOT_FOUND");

package/lib/emulator/dataconnectEmulator.js

@@ -15,7 +15,6 @@ const emulatorLogger_1 = require("./emulatorLogger");
 const types_2 = require("../dataconnect/types");
 const portUtils_1 = require("./portUtils");
 const registry_1 = require("./registry");
-const logger_1 = require("../logger");
 const load_1 = require("../dataconnect/load");
 const pgliteServer_1 = require("./dataconnect/pgliteServer");
 const controller_1 = require("./controller");
@@ -156,33 +155,37 @@ class DataConnectEmulator {
     }
     static async generate(args) {
         const commandInfo = await (0, downloadableEmulators_1.downloadIfNecessary)(types_1.Emulators.DATACONNECT);
-        const cmd = [
-            "--logtostderr",
-            "-v=2",
-            "generate",
-            `--config_dir=${args.configDir}`,
-            `--connector_id=${args.connectorId}`,
-        ];
+        const cmd = ["--logtostderr", "-v=2", "sdk", "generate", `--config_dir=${args.configDir}`];
         if (args.watch) {
             cmd.push("--watch");
         }
         const env = await DataConnectEmulator.getEnv(args.account);
-        const res = childProcess.spawnSync(commandInfo.binary, cmd, { encoding: "utf-8", env });
-        if ((0, downloadableEmulators_1.isIncomaptibleArchError)(res.error)) {
-            throw new error_1.FirebaseError(`Unknown system error when running the Data Connect toolkit. ` +
-                `You may be able to fix this by installing Rosetta: ` +
-                `softwareupdate --install-rosetta`);
-        }
-        logger_1.logger.info(res.stderr);
-        if (res.error) {
-            throw new error_1.FirebaseError(`Error starting up Data Connect generate: ${res.error.message}`, {
-                original: res.error,
-            });
-        }
-        if (res.status !== 0) {
-            throw new error_1.FirebaseError(`Unable to generate your Data Connect SDKs (exit code ${res.status}): ${res.stderr}`);
-        }
-        return res.stdout;
+        return new Promise((resolve, reject) => {
+            try {
+                const proc = childProcess.spawn(commandInfo.binary, cmd, { stdio: "inherit", env });
+                proc.on("close", (code) => {
+                    if (code === 0) {
+                        resolve();
+                    }
+                    else {
+                        reject(new Error(`Command failed with exit code ${code}`));
+                    }
+                });
+                proc.on("error", (err) => {
+                    reject(err);
+                });
+            }
+            catch (e) {
+                if ((0, downloadableEmulators_1.isIncomaptibleArchError)(e)) {
+                    reject(new error_1.FirebaseError(`Unknown system error when running the Data Connect toolkit. ` +
+                        `You may be able to fix this by installing Rosetta: ` +
+                        `softwareupdate --install-rosetta`));
+                }
+                else {
+                    reject(e);
+                }
+            }
+        });
     }
     static async build(args) {
         var _a;

package/lib/emulator/functionsEmulator.js

@@ -341,11 +341,11 @@ class FunctionsEmulator {
             const resolution = await (0, build_1.resolveBackend)({
                 build: discoveredBuild,
                 firebaseConfig: JSON.parse(firebaseConfig),
-                userEnvOpt,
                 userEnvs,
                 nonInteractive: false,
                 isEmulator: true,
             });
+            functionsEnv.writeResolvedParams(resolution.envs, userEnvs, userEnvOpt);
             const discoveredBackend = resolution.backend;
             const endpoints = backend.allEndpoints(discoveredBackend);
             (0, functionsEmulatorShared_1.prepareEndpoints)(endpoints);

package/lib/emulator/hub.js

@@ -10,7 +10,6 @@ const types_1 = require("./types");
 const hubExport_1 = require("./hubExport");
 const registry_1 = require("./registry");
 const ExpressBasedEmulator_1 = require("./ExpressBasedEmulator");
-const vsCodeUtils_1 = require("../vsCodeUtils");
 const pkg = require("../../package.json");
 class EmulatorHub extends ExpressBasedEmulator_1.ExpressBasedEmulator {
     static readLocatorFile(projectId) {
@@ -20,9 +19,8 @@ class EmulatorHub extends ExpressBasedEmulator_1.ExpressBasedEmulator {
         }
         const data = fs.readFileSync(locatorPath, "utf8").toString();
         const locator = JSON.parse(data);
-        if (!(0, vsCodeUtils_1.isVSCodeExtension)() && locator.version !== this.CLI_VERSION) {
-            logger_1.logger.debug(`Found locator with mismatched version, ignoring: ${JSON.stringify(locator)}`);
-            return undefined;
+        if (locator.version !== this.CLI_VERSION) {
+            logger_1.logger.debug(`Found emulator locator with different version: ${JSON.stringify(locator)}, CLI_VERSION: ${this.CLI_VERSION}`);
         }
         return locator;
     }

package/lib/functions/env.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadFirebaseEnvs = exports.loadUserEnvs = exports.checkForDuplicateKeys = exports.writeUserEnvs = exports.hasUserEnvs = exports.parseStrict = exports.validateKey = exports.KeyValidationError = exports.parse = void 0;
+exports.writeResolvedParams = exports.loadFirebaseEnvs = exports.loadUserEnvs = exports.checkForDuplicateKeys = exports.writeUserEnvs = exports.hasUserEnvs = exports.parseStrict = exports.validateKey = exports.KeyValidationError = exports.parse = void 0;
 const clc = require("colorette");
 const fs = require("fs");
 const path = require("path");
@@ -250,3 +250,14 @@ function loadFirebaseEnvs(firebaseConfig, projectId) {
     };
 }
 exports.loadFirebaseEnvs = loadFirebaseEnvs;
+function writeResolvedParams(resolvedEnvs, userEnvs, userEnvOpt) {
+    const toWrite = {};
+    for (const paramName of Object.keys(resolvedEnvs)) {
+        const paramValue = resolvedEnvs[paramName];
+        if (!paramValue.internal && !Object.prototype.hasOwnProperty.call(userEnvs, paramName)) {
+            toWrite[paramName] = paramValue.toString();
+        }
+    }
+    writeUserEnvs(toWrite, userEnvOpt);
+}
+exports.writeResolvedParams = writeResolvedParams;

package/lib/init/features/dataconnect/sdk.js

@@ -153,7 +153,6 @@ async function actuateWithInfo(setup, config, info) {
     const account = (0, auth_1.getGlobalDefaultAccount)();
     await dataconnectEmulator_1.DataConnectEmulator.generate({
         configDir: connectorInfo.directory,
-        connectorId: connectorInfo.connectorYaml.connectorId,
         account,
     });
     (0, utils_1.logLabeledSuccess)("dataconnect", `Installed generated SDKs for ${clc.bold(apps.map((a) => (0, appFinder_1.appDescription)(a)).join(", "))}`);

package/lib/mcp/index.js

@@ -154,7 +154,7 @@ class FirebaseMcpServer {
         const emulators = await hubClient.getEmulators();
         const emulatorInfo = emulators[emulatorType];
         if (!emulatorInfo) {
-            throw Error("No Firestore Emulator found running. Make sure your project firebase.json file includes firestore and then rerun emulator using `firebase emulators:start` from your project directory.");
+            throw Error(`No ${emulatorType} Emulator found running. Make sure your project firebase.json file includes ${emulatorType} and then rerun emulator using \`firebase emulators:start\` from your project directory.`);
         }
         const host = emulatorInfo.host.includes(":") ? `[${emulatorInfo.host}]` : emulatorInfo.host;
         return `http://${host}:${emulatorInfo.port}`;

package/lib/mcp/prompts/core/deploy.js

@@ -83,7 +83,7 @@ Follow the steps below taking note of any user instructions provided above.
      Create \`firebase.json\ with an "apphosting" configuration, setting backendId to the app's name in package.json: \`{"apphosting": {"backendId": "<backendId>"}}\ 
   4b. If the app does NOT require SSR, configure Firebase Hosting:
     Create \`firebase.json\ with a "hosting" configuration. Add a \`{"hosting": {"predeploy": "<build_script>"}}\` config to build before deploying.
-5. Check if there is an active Firebase project for this environment (the \`firebase_get_environment\` tool may be helpful). If there is, proceed using that project. If there is not an active project, give the user two options: Use an existing Firebase project or Create a new one. Wait for their response before proceeding.
+5. Check if there is an active Firebase project for this environment (the \`firebase_get_environment\` tool may be helpful). If there is, provide the active project ID to the user and ask them if they want to proceed using that project. If there is not an active project, give the user two options: Provide an existing project ID or create a new project. Only use the list_projects tool on user request. Wait for their response before proceeding.
   5a. If the user chooses to use an existing Firebase project, the \`firebase_list_projects\` tool may be helpful. Set the selected project as the active project (the \`firebase_update_environment\` tool may be helpful).
   5b. If the user chooses to create a new project, use the \`firebase_create_project	\` tool. Then set the new project as the active project (the \`firebase_update_environment\` tool may be helpful).
 6. If firebase.json contains an "apphosting" configuration, check if a backend exists matching the provided backendId (the \`apphosting_list_backends\` tool may be helpful). 

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

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../../tool");
+const dataplane = require("../../../dataconnect/dataplaneClient");
+const load_1 = require("../../../dataconnect/load");
+const converter_1 = require("../../util/dataconnect/converter");
+const emulator_1 = require("../../util/dataconnect/emulator");
+exports.execute = (0, tool_1.tool)({
+    name: "execute",
+    description: "Executes a GraphQL operation against a Data Connect service or its emulator.",
+    inputSchema: zod_1.z.object({
+        query: zod_1.z.string().describe(`A Firebase Data Connect GraphQL query or mutation to execute.
+You can use the \`dataconnect_generate_operation\` tool to generate a query.
+Example Data Connect schema and example queries can be found in files ending in \`.graphql\` or \`.gql\`.
+`),
+        service_id: zod_1.z.string().optional()
+            .describe(`Data Connect Service ID to dis-ambulate if there are multiple.
+It's only necessary if there are multiple dataconnect sources in \`firebase.json\`.
+You can find candidate service_id in \`dataconnect.yaml\`
+`),
+        variables_json: zod_1.z
+            .string()
+            .optional()
+            .describe("GraphQL variables to pass into the query. MUST be a valid stringified JSON object."),
+        auth_token_json: zod_1.z
+            .string()
+            .optional()
+            .describe("Firebase Auth Token JWT to use in this query. MUST be a valid stringified JSON object." +
+            'Importantly, when executing queries with `@auth(level: USER)` or `auth.uid`, a valid Firebase Auth Token JWT with "sub" field is required. ' +
+            '"auth.uid" expression in the query evaluates to the value of "sub" field in Firebase Auth token.'),
+        use_emulator: zod_1.z
+            .boolean()
+            .default(false)
+            .describe("If true, target the DataConnect emulator. Run `firebase emulators:start` to start it"),
+    }),
+    annotations: {
+        title: "Execute Firebase Data Connect Query",
+    },
+    _meta: {
+        requiresProject: true,
+        requiresAuth: true,
+    },
+}, async ({ query, service_id, variables_json: unparsedVariables, use_emulator, auth_token_json: unparsedAuthToken, }, { projectId, config, host }) => {
+    const serviceInfo = await (0, load_1.pickService)(projectId, config, service_id || undefined);
+    let apiClient;
+    if (use_emulator) {
+        apiClient = await (0, emulator_1.getDataConnectEmulatorClient)(host);
+    }
+    else {
+        apiClient = dataplane.dataconnectDataplaneClient();
+    }
+    let executeGraphQL = dataplane.executeGraphQL;
+    if (query.startsWith("query")) {
+        executeGraphQL = dataplane.executeGraphQLRead;
+    }
+    const response = await executeGraphQL(apiClient, serviceInfo.serviceName, {
+        name: "",
+        query,
+        variables: (0, converter_1.parseVariables)(unparsedVariables),
+        extensions: {
+            impersonate: unparsedAuthToken
+                ? {
+                    authClaims: (0, converter_1.parseVariables)(unparsedAuthToken),
+                }
+                : undefined,
+        },
+    });
+    return (0, converter_1.graphqlResponseToToolResponse)(response.body);
+});

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

@@ -3,23 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.dataconnectTools = void 0;
 const generate_operation_1 = require("./generate_operation");
 const generate_schema_1 = require("./generate_schema");
-const list_services_1 = require("./list_services");
-const get_schema_1 = require("./get_schema");
-const get_connector_1 = require("./get_connector");
-const execute_graphql_1 = require("./execute_graphql");
-const execute_graphql_read_1 = require("./execute_graphql_read");
-const execute_query_1 = require("./execute_query");
-const execute_mutation_1 = require("./execute_mutation");
+const info_1 = require("./info");
 const compile_1 = require("./compile");
+const execute_1 = require("./execute");
 exports.dataconnectTools = [
     compile_1.compile,
-    list_services_1.list_services,
     generate_schema_1.generate_schema,
     generate_operation_1.generate_operation,
-    get_schema_1.get_schema,
-    get_connector_1.get_connectors,
-    execute_graphql_1.execute_graphql,
-    execute_graphql_read_1.execute_graphql_read,
-    execute_mutation_1.execute_mutation,
-    execute_query_1.execute_query,
+    info_1.info,
+    execute_1.execute,
 ];

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

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.info = void 0;
+const zod_1 = require("zod");
+const path = require("path");
+const tool_1 = require("../../tool");
+const util_1 = require("../../util");
+const client = require("../../../dataconnect/client");
+const load_1 = require("../../../dataconnect/load");
+const js_yaml_1 = require("js-yaml");
+const logger_1 = require("../../../logger");
+exports.info = (0, tool_1.tool)({
+    name: "info",
+    description: "Get information about the Firebase Data Connect local and deployed resources.",
+    inputSchema: zod_1.z.object({}),
+    annotations: {
+        title: "Get information about Firebase Data Connect",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresProject: false,
+        requiresAuth: false,
+    },
+}, async (_, { projectId, config }) => {
+    const localServiceInfos = await (0, load_1.loadAll)(projectId, config);
+    const serviceInfos = new Map();
+    for (const l of localServiceInfos) {
+        serviceInfos.set(`locations/${l.dataConnectYaml.location}/services/${l.dataConnectYaml.serviceId}`, { local: l });
+    }
+    if (projectId) {
+        try {
+            const [services, schemas, connectors] = await Promise.all([
+                client.listAllServices(projectId),
+                client.listSchemas(`projects/${projectId}/locations/-/services/-`),
+                client.listConnectors(`projects/${projectId}/locations/-/services/-`),
+            ]);
+            console.log(services, schemas, connectors);
+            for (const s of services) {
+                const k = s.name.split("/").slice(2, 6).join("/");
+                const st = serviceInfos.get(k) || {};
+                st.deployed = st.deployed || {};
+                st.deployed.service = s;
+                serviceInfos.set(k, st);
+            }
+            for (const s of schemas) {
+                const k = s.name.split("/").slice(2, 6).join("/");
+                const st = serviceInfos.get(k) || {};
+                st.deployed = st.deployed || {};
+                st.deployed.schemas = st.deployed.schemas || [];
+                st.deployed.schemas.push(s);
+                serviceInfos.set(k, st);
+            }
+            for (const s of connectors) {
+                const k = s.name.split("/").slice(2, 6).join("/");
+                const st = serviceInfos.get(k) || {};
+                st.deployed = st.deployed || {};
+                st.deployed.connectors = st.deployed.connectors || [];
+                st.deployed.connectors.push(s);
+                serviceInfos.set(k, st);
+            }
+        }
+        catch (e) {
+            logger_1.logger.debug("cannot fetch dataconnect resources in the backend", e);
+        }
+    }
+    const localServices = Array.from(serviceInfos.values()).filter((s) => s.local);
+    const remoteOnlyServices = Array.from(serviceInfos.values()).filter((s) => !s.local);
+    const output = [];
+    function includeDeployedServiceInfo(deployed) {
+        var _a, _b;
+        if ((_a = deployed.schemas) === null || _a === void 0 ? void 0 : _a.length) {
+            output.push(`### Schemas`);
+            for (const s of deployed.schemas) {
+                clearCCFEFields(s);
+                output.push((0, js_yaml_1.dump)(s));
+            }
+        }
+        if ((_b = deployed.connectors) === null || _b === void 0 ? void 0 : _b.length) {
+            output.push(`### Connectors`);
+            for (const c of deployed.connectors) {
+                clearCCFEFields(c);
+                output.push((0, js_yaml_1.dump)(c));
+            }
+        }
+    }
+    if (localServices.length) {
+        output.push(`# Local Data Connect Sources`);
+        for (const s of localServices) {
+            const local = s.local;
+            output.push((0, js_yaml_1.dump)(local.dataConnectYaml));
+            const schemaDir = path.join(local.sourceDirectory, local.dataConnectYaml.schema.source);
+            output.push(`You can find all of schema sources under ${schemaDir}/`);
+            if (s.deployed) {
+                output.push(`It's already deployed in the backend:\n`);
+                includeDeployedServiceInfo(s.deployed);
+            }
+        }
+    }
+    if (remoteOnlyServices.length) {
+        output.push(`# Data Connect Services in project ${projectId}`);
+        for (const s of remoteOnlyServices) {
+            if (s.deployed) {
+                includeDeployedServiceInfo(s.deployed);
+            }
+        }
+    }
+    output.push(`\n# What's next?`);
+    if (!localServices.length) {
+        output.push(`- There is no local Data Connect service in the local workspace. Consider use the \`firebase_init\` MCP tool to setup one.`);
+    }
+    output.push(`- You can use the \`dataconnect_compile\` tool to compile all local Data Connect schemas and query sources.`);
+    output.push(`- You run \`firebase deploy\` in command line to deploy the Data Connect schemas, connector and perform SQL migrations.`);
+    return (0, util_1.toContent)(output.join("\n"));
+});
+function clearCCFEFields(r) {
+    const fieldsToClear = ["updateTime", "uid", "etag"];
+    for (const k of fieldsToClear) {
+        delete r[k];
+    }
+}

package/lib/track.js

@@ -8,6 +8,19 @@ const configstore_1 = require("./configstore");
 const logger_1 = require("./logger");
 const env_1 = require("./env");
 const pkg = require("../package.json");
+function detectAIAgent() {
+    if (process.env.CODEX_SANDBOX)
+        return "codex_cli";
+    if (process.env.CLAUDECODE)
+        return "claude_code";
+    if (process.env.GEMINI_CLI)
+        return "gemini_cli";
+    if (process.env.CURSOR_AGENT)
+        return "cursor";
+    if (process.env.OPENCODE)
+        return "open_code";
+    return "unknown";
+}
 exports.GA4_PROPERTIES = {
     cli: {
         measurementId: process.env.FIREBASE_CLI_GA4_MEASUREMENT_ID || "G-PDN0QWHQJR",
@@ -45,6 +58,9 @@ const GA4_USER_PROPS = {
     is_firebase_studio: {
         value: (0, env_1.isFirebaseStudio)().toString(),
     },
+    ai_agent: {
+        value: detectAIAgent(),
+    },
 };
 async function trackGA4(eventName, params, duration = 1) {
     const session = cliSession();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-tools",
-  "version": "14.15.1",
+  "version": "14.15.2",
   "description": "Command-Line Interface for Firebase",
   "main": "./lib/index.js",
   "bin": {

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

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.execute_graphql = void 0;
-const zod_1 = require("zod");
-const tool_1 = require("../../tool");
-const dataplane = require("../../../dataconnect/dataplaneClient");
-const load_1 = require("../../../dataconnect/load");
-const converter_1 = require("../../util/dataconnect/converter");
-const emulator_1 = require("../../util/dataconnect/emulator");
-exports.execute_graphql = (0, tool_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, load_1.pickService)(projectId, config, service_id || undefined);
-    let apiClient;
-    if (use_emulator) {
-        apiClient = await (0, emulator_1.getDataConnectEmulatorClient)(host);
-    }
-    else {
-        apiClient = dataplane.dataconnectDataplaneClient();
-    }
-    const response = await dataplane.executeGraphQL(apiClient, serviceInfo.serviceName, {
-        name: "",
-        query,
-        variables: (0, converter_1.parseVariables)(unparsedVariables),
-    });
-    return (0, converter_1.graphqlResponseToToolResponse)(response.body);
-});

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

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.execute_graphql_read = void 0;
-const zod_1 = require("zod");
-const tool_1 = require("../../tool");
-const dataplane = require("../../../dataconnect/dataplaneClient");
-const load_1 = require("../../../dataconnect/load");
-const converter_1 = require("../../util/dataconnect/converter");
-const emulator_1 = require("../../util/dataconnect/emulator");
-exports.execute_graphql_read = (0, tool_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, load_1.pickService)(projectId, config, service_id || undefined);
-    let apiClient;
-    if (use_emulator) {
-        apiClient = await (0, emulator_1.getDataConnectEmulatorClient)(host);
-    }
-    else {
-        apiClient = dataplane.dataconnectDataplaneClient();
-    }
-    const response = await dataplane.executeGraphQLRead(apiClient, serviceInfo.serviceName, {
-        name: "",
-        query,
-        variables: (0, converter_1.parseVariables)(unparsedVariables),
-    });
-    return (0, converter_1.graphqlResponseToToolResponse)(response.body);
-});

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

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.execute_mutation = void 0;
-const zod_1 = require("zod");
-const tool_1 = require("../../tool");
-const util_1 = require("../../util");
-const dataplane = require("../../../dataconnect/dataplaneClient");
-const load_1 = require("../../../dataconnect/load");
-const converter_1 = require("../../util/dataconnect/converter");
-const emulator_1 = require("../../util/dataconnect/emulator");
-exports.execute_mutation = (0, tool_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, load_1.pickService)(projectId, config, service_id || undefined);
-    let apiClient;
-    if (!connector_id) {
-        if (serviceInfo.connectorInfo.length === 0) {
-            return (0, util_1.mcpError)(`Service ${serviceInfo.serviceName} has no connectors`, "NO_CONNECTORS_FOUND");
-        }
-        if (serviceInfo.connectorInfo.length > 1) {
-            return (0, util_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_1.getDataConnectEmulatorClient)(host);
-    }
-    else {
-        apiClient = dataplane.dataconnectDataplaneClient();
-    }
-    const response = await dataplane.executeGraphQLMutation(apiClient, connectorPath, {
-        operationName,
-        variables: (0, converter_1.parseVariables)(unparsedVariables),
-    });
-    return (0, converter_1.graphqlResponseToToolResponse)(response.body);
-});

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

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.execute_query = void 0;
-const zod_1 = require("zod");
-const tool_1 = require("../../tool");
-const util_1 = require("../../util");
-const dataplane = require("../../../dataconnect/dataplaneClient");
-const load_1 = require("../../../dataconnect/load");
-const converter_1 = require("../../util/dataconnect/converter");
-const emulator_1 = require("../../util/dataconnect/emulator");
-exports.execute_query = (0, tool_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, load_1.pickService)(projectId, config, service_id || undefined);
-    let apiClient;
-    if (!connector_id) {
-        if (serviceInfo.connectorInfo.length === 0) {
-            return (0, util_1.mcpError)(`Service ${serviceInfo.serviceName} has no connectors`, "NO_CONNECTORS_FOUND");
-        }
-        if (serviceInfo.connectorInfo.length > 1) {
-            return (0, util_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_1.getDataConnectEmulatorClient)(host);
-    }
-    else {
-        apiClient = dataplane.dataconnectDataplaneClient();
-    }
-    const response = await dataplane.executeGraphQLQuery(apiClient, connectorPath, {
-        operationName,
-        variables: (0, converter_1.parseVariables)(unparsedVariables),
-    });
-    return (0, converter_1.graphqlResponseToToolResponse)(response.body);
-});

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

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.get_connectors = void 0;
-const zod_1 = require("zod");
-const tool_1 = require("../../tool");
-const util_1 = require("../../util");
-const client = require("../../../dataconnect/client");
-const load_1 = require("../../../dataconnect/load");
-const converter_1 = require("../../util/dataconnect/converter");
-exports.get_connectors = (0, tool_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({
-        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."),
-    }),
-    annotations: {
-        title: "Get Data Connect Connectors",
-        readOnlyHint: true,
-    },
-    _meta: {
-        requiresProject: true,
-        requiresAuth: true,
-    },
-}, async ({ service_id }, { projectId, config }) => {
-    const serviceInfo = await (0, load_1.pickService)(projectId, config, service_id || undefined);
-    const connectors = await client.listConnectors(serviceInfo.serviceName, ["*"]);
-    return (0, util_1.toContent)(connectors.map(converter_1.connectorToText).join("\n\n"));
-});

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

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.get_schema = void 0;
-const zod_1 = require("zod");
-const tool_1 = require("../../tool");
-const util_1 = require("../../util");
-const client = require("../../../dataconnect/client");
-const load_1 = require("../../../dataconnect/load");
-const converter_1 = require("../../util/dataconnect/converter");
-exports.get_schema = (0, tool_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({
-        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."),
-    }),
-    annotations: {
-        title: "Get Data Connect Schemas",
-        readOnlyHint: true,
-    },
-    _meta: {
-        requiresProject: true,
-        requiresAuth: true,
-    },
-}, async ({ service_id }, { projectId, config }) => {
-    const serviceInfo = await (0, load_1.pickService)(projectId, config, service_id || undefined);
-    const schemas = await client.listSchemas(serviceInfo.serviceName, ["*"]);
-    return (0, util_1.toContent)(schemas === null || schemas === void 0 ? void 0 : schemas.map(converter_1.schemaToText).join("\n\n"));
-});

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

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.list_services = void 0;
-const zod_1 = require("zod");
-const tool_1 = require("../../tool");
-const util_1 = require("../../util");
-const client = require("../../../dataconnect/client");
-exports.list_services = (0, tool_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 Data Connect Services",
-        readOnlyHint: true,
-    },
-    _meta: {
-        requiresProject: true,
-        requiresAuth: true,
-    },
-}, async (_, { projectId }) => {
-    const services = await client.listAllServices(projectId);
-    return (0, util_1.toContent)(services, { format: "yaml" });
-});