Data Connect SDK generation with llmTools option does not support Enums

[mickeywu]

[REQUIRED] Environment info

firebase-tools:

14.11.2

Platform:

Ubuntu

[REQUIRED] Test case

firebase dataconnect:sdk:generate fails to generate the JSON file for tool consumption (using llmTools) if Enums are used in the schema.

Data Connect support for Enums was introduced recently. It works as intended in the app, just not with llmOptions.

Without llmOptions, firebase dataconnect:sdk:generate works with Enums and succeeds as intended.

[REQUIRED] Steps to reproduce

A simple test schema can be used (from the blog article):

enum Language {
  ENGLISH
  FRENCH
  SPANISH
  GERMAN
  JAPANESE
  "Languages not defined above"
  OTHER_LANGUAGES
}

type Movie
  @table {
  title: String! 
  genre: String 
  description: String 
  originalLanguage: Language! @default(value: ENGLISH)
  availableLanguages: [Language!]
}

Specify llmOptions in connector.yaml:

connectorId: default
generate:
  javascriptSdk:
    outputDir: ../../dataconnect-generated/js
    package: '@movies/dataconnect'
    packageJsonDir: ../..
    react: true
  llmTools:
    outputFile: ../../dataconnect-generated/tools.json

Run SDK generation:

➜ terminal git:(main) firebase dataconnect:sdk:generate
I0801 22:17:21.745622  131457 codegen.go:82] [connector "default" javascriptSdk] Generating sources into "/home/terminal/Projects/movies/dataconnect-generated/js"
I0801 22:17:21.784540  131457 codegen.go:82] [connector "default" llmTools] Generating sources into "/home/terminal/Projects/movies/dataconnect-generated/tools.json"
E0801 22:17:21.784579  131457 cmd.go:45] Failed to generate SDKs:
[connector "default" llmTools]: failed to generate sources:
Unsupported type for tool parameter: Enum

Error: Unable to generate your Data Connect SDKs (exit code 1): I0801 22:17:21.745622  131457 codegen.go:82] [connector "default" javascriptSdk] Generating sources into "/home/terminal/Projects/movies/dataconnect-generated/js"
I0801 22:17:21.784540  131457 codegen.go:82] [connector "default" llmTools] Generating sources into "/home/terminal/Projects/movies/dataconnect-generated/tools.json"
E0801 22:17:21.784579  131457 cmd.go:45] Failed to generate SDKs:
[connector "default" llmTools]: failed to generate sources:
Unsupported type for tool parameter: Enum

[REQUIRED] Expected behavior

firebase dataconnect:sdk:generate succeeds and generates the tools JSON with llmOptions defined when Enums are used.

[REQUIRED] Actual behavior

➜ terminal git:(main) firebase dataconnect:sdk:generate
I0801 22:17:21.745622  131457 codegen.go:82] [connector "default" javascriptSdk] Generating sources into "/home/terminal/Projects/movies/dataconnect-generated/js"
I0801 22:17:21.784540  131457 codegen.go:82] [connector "default" llmTools] Generating sources into "/home/terminal/Projects/movies/dataconnect-generated/tools.json"
E0801 22:17:21.784579  131457 cmd.go:45] Failed to generate SDKs:
[connector "default" llmTools]: failed to generate sources:
Unsupported type for tool parameter: Enum

Error: Unable to generate your Data Connect SDKs (exit code 1): I0801 22:17:21.745622  131457 codegen.go:82] [connector "default" javascriptSdk] Generating sources into "/home/terminal/Projects/movies/dataconnect-generated/js"
I0801 22:17:21.784540  131457 codegen.go:82] [connector "default" llmTools] Generating sources into "/home/terminal/Projects/movies/dataconnect-generated/tools.json"
E0801 22:17:21.784579  131457 cmd.go:45] Failed to generate SDKs:
[connector "default" llmTools]: failed to generate sources:
Unsupported type for tool parameter: Enum

[aalej]

Hey @mickeywu, thanks for the detailed report! I’m trying to reproduce this issue using firebase-tools v14.11.2, but so far, no errors are being raised when running firebase dataconnect:sdk:generate.

Using the information provided, I created this mcve. Could you let me know if I may be missing anything here to reproduce the issue? Also, could you try running firebase dataconnect:sdk:generate --debug then share the generated firebase-debug.log file with us? This should contain additional logs that would help point us in the right direction. Please remove any PIIs before sharing the contents.

[mickeywu]

Hi @aalej, thank you for taking a look!

I cloned your MCVE and it certainly runs fine as is. Upon additional investigation, it appears the problem only occurs if an Enum is used in a query parameter.

If I add this query to queries.gql in the MCVE, firebase dataconnect:sdk:generate will then fail:

query FilterMovies($originalLanguage: Language) @auth(level: PUBLIC) {
  movies(where: { originalLanguage: { eq: $originalLanguage } }) {
    id
    originalLanguage
    availableLanguages
  }
}

Here's the output:

➜  issues-8929 git:(main) ✗ firebase dataconnect:sdk:generate --debug
[2025-08-04T17:58:20.734Z] defaultcredentials: writing to file /home/xyz/.config/firebase/xyz_application_default_credentials.json
I0804 10:58:20.753008  158279 codegen.go:82] [connector "default" javascriptSdk] Generating sources into "/home/xyz/Projects/issues-8929/dataconnect-generated/js"
I0804 10:58:20.756978  158279 codegen.go:82] [connector "default" llmTools] Generating sources into "/home/xyz/Projects/issues-8929/dataconnect-generated/tools.json"
E0804 10:58:20.756998  158279 cmd.go:45] Failed to generate SDKs:
[connector "default" llmTools]: failed to generate sources:
Unsupported type for tool parameter: Enum

Error: Unable to generate your Data Connect SDKs (exit code 1): I0804 10:58:20.753008  158279 codegen.go:82] [connector "default" javascriptSdk] Generating sources into "/home/xyz/Projects/issues-8929/dataconnect-generated/js"
I0804 10:58:20.756978  158279 codegen.go:82] [connector "default" llmTools] Generating sources into "/home/xyz/Projects/issues-8929/dataconnect-generated/tools.json"
E0804 10:58:20.756998  158279 cmd.go:45] Failed to generate SDKs:
[connector "default" llmTools]: failed to generate sources:
Unsupported type for tool parameter: Enum

Here's firebase-debug.log:

[debug] [2025-08-04T17:58:20.622Z] ----------------------------------------------------------------------
[debug] [2025-08-04T17:58:20.623Z] Command:       /home/xyz/.nvm/versions/node/v22.14.0/bin/node /home/xyz/.nvm/versions/node/v22.14.0/bin/firebase dataconnect:sdk:generate --debug
[debug] [2025-08-04T17:58:20.623Z] CLI Version:   14.11.2
[debug] [2025-08-04T17:58:20.623Z] Platform:      linux
[debug] [2025-08-04T17:58:20.623Z] Node Version:  v22.14.0
[debug] [2025-08-04T17:58:20.623Z] Time:          Mon Aug 04 2025 10:58:20 GMT-0700 (Pacific Daylight Time)
[debug] [2025-08-04T17:58:20.623Z] ----------------------------------------------------------------------
[debug] 
[debug] [2025-08-04T17:58:20.734Z] defaultcredentials: writing to file /home/xyz/.config/firebase/xyz_application_default_credentials.json
[info] I0804 10:58:20.753008  158279 codegen.go:82] [connector "default" javascriptSdk] Generating sources into "/home/xyz/Projects/issues-8929/dataconnect-generated/js"
I0804 10:58:20.756978  158279 codegen.go:82] [connector "default" llmTools] Generating sources into "/home/xyz/Projects/issues-8929/dataconnect-generated/tools.json"
E0804 10:58:20.756998  158279 cmd.go:45] Failed to generate SDKs:
[connector "default" llmTools]: failed to generate sources:
Unsupported type for tool parameter: Enum

[error] 
[error] Error: Unable to generate your Data Connect SDKs (exit code 1): I0804 10:58:20.753008  158279 codegen.go:82] [connector "default" javascriptSdk] Generating sources into "/home/xyz/Projects/issues-8929/dataconnect-generated/js"
I0804 10:58:20.756978  158279 codegen.go:82] [connector "default" llmTools] Generating sources into "/home/xyz/Projects/issues-8929/dataconnect-generated/tools.json"
E0804 10:58:20.756998  158279 cmd.go:45] Failed to generate SDKs:
[connector "default" llmTools]: failed to generate sources:
Unsupported type for tool parameter: Enum

[aalej]

Thanks @mickeywu for trying that out! I am now able to reproduce the issue. I'll raise this to our engineering team and mark this as reproducible.

Sharing the updated mcve

[stephenarosaj]

Hey there @mickeywu thanks for the bug report and thank you @aalej for raising it to the eng team!

A fix should be coming in the next release (likely tomorrow) - I'll update this thread when that happens :-)

[stephenarosaj]

@mickeywu fix has been released in firebase-tools/pull/8948!