feat(gql): introduce LLM-based generator for queries

[tk-o]

In order to test this new feature:

1. Include ANTHROPIC_API_KEY in apps/ensadmin/.env.local file if you have it (but it's optional)
2. Start ENSAdmin service (i.e. pnpm -F ensadmin dev)
3. Go to https://adminensnodeio-git-feat-gql-query-llm-generator-namehash.vercel.app/gql/api?gqlApiUrl=https://api.alpha.ensnode.io/ponder&prompt=latest%20domain%20names%20ending%20with%20.eth
4. Observe response:

{
  "generateQueryDto": {
    "prompt": "latest domain names ending with .eth",
    "gqlApiUrl": "https://api.alpha.ensnode.io/ponder"
  },
  "generatedQuery": {
    "query": "query ($limit: Int, $orderBy: String, $orderDirection: String, $where: domainFilter) {\n  domains(\n    limit: $limit\n    orderBy: $orderBy\n    orderDirection: $orderDirection\n    where: $where\n  ) {\n    items {\n      createdAt\n      id\n      labelName\n      name\n      owner {\n        id\n      }\n      registration {\n        expiryDate\n        registrationDate\n      }\n    }\n    pageInfo {\n      endCursor\n      hasNextPage\n    }\n    totalCount\n  }\n}",
    "variables": {
      "limit": 10,
      "orderBy": "createdAt",
      "orderDirection": "desc",
      "where": {
        "name_ends_with": ".eth"
      }
    }
  }
}

[changeset-bot]

🦋 Changeset detected

Latest commit: 8446b68

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 10 packages

Name	Type
ensadmin	Minor
ensindexer	Minor
ensrainbow	Minor
@ensnode/ens-deployments	Minor
@ensnode/utils	Minor
@ensnode/ensrainbow-sdk	Minor
@ensnode/ponder-metadata	Minor
@ensnode/ponder-schema	Minor
@ensnode/ponder-subgraph	Minor
@ensnode/shared-configs	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
admin.ensnode.io	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 24, 2025 1:10pm
ensnode.io	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 24, 2025 1:10pm
ensrainbow.io	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 24, 2025 1:10pm

[lightwalker-eth]

Interesting. This seems to suggest to me that this package assumes it is always used by a stateful backend and not in a stateless / serverless backend like we are in ENSAdmin.

[lightwalker-eth]

Seems we should give an example below this of the expected JSON format?

[tk-o]

@djstrong what do you think about it?

[djstrong]

The example is in the lib prompt:

Provide your response in the following JSON format:
{
  "query": "The generated GraphQL query",
  "variables": { "key": "value" }
}

Example:
{
  "query": "query($id: ID!) { user(id: $id) { id name email } }",
  "variables": { "id": "123" }
}

Do not include any additional text or formatting outside of this JSON object.

[danstarns]

The lib prompts most of this, but extra can't hurt 🫡

[danstarns]

hey @tk-o

Thanks for the integration, it looks like the lib fit in nicely. We do have the alpha tag, your feedback and usage can really help us get to a stable position for the community. Feel free to open issues on gqlpt and or reach out directly ✌️

[danstarns]

Our anthropic Adapter is not passing through the options and hardcoded on a specific model - sorry about that, I made something on our end to track that:

• Anthropic adapter options rocket-connect/gqlpt#174