fix(ai-constructs): support no input graphql query tools

[atierian]

Problem

• the toolConfiguration.graphqlRequestInputDescriptor.selectionSet in the conversation handler event payload should be a string to support nested selection sets. e.g.

{ 
  items {
    id
    name
    activeCart {
      customerId
      id
      items {
        name
        price
      }
    }
    orderHistory {
      items {
        customerId
        id
        items {
          name
          price
        }
      }
    }
  }
}

• input-less GraphQL queries are valid tools, but currently don't work because we wrap all generated input strings in parentheses even if they're empty. This results in a tool definition like this:

toolDefinition: {
  name: 'foo',
  description: 'foo description',
  inputSchema: {
    json: {},
  },
  graphqlRequestInputDescriptor: {
    queryName: 'foo',
    selectionSet: 'bar baz
    propertyTypes: {},
  },
}

generating this query:

query ToolQuery() {
  foo() {
     bar baz
  }
}

which is invalid GraphQL. It should be generating this:

- query ToolQuery() {
-  foo() {
+ query ToolQuery {
+ foo {
     bar baz
  }
}

Issue number, if available:

Changes

• toolConfiguration.graphqlRequestInputDescriptor.selectionSet is now a string instead of string[].
• input-less GraphQL query tools now generate queries without enclosing ().
• GraphQL types in propertyTypes will include ! if they're required so the lambda doesn't have to handle appending the ! based on the required array in the json schema.

Corresponding docs PR, if applicable:

Validation

Checklist

• If this PR includes a functional change to the runtime behavior of the code, I have added or updated automated test coverage for this change.
• If this PR requires a change to the Project Architecture README, I have included that update in this PR.
• If this PR requires a docs update, I have linked to that docs PR above.
• If this PR modifies E2E tests, makes changes to resource provisioning, or makes SDK calls, I have run the PR checks with the run-e2e label set.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[changeset-bot]

🦋 Changeset detected

Latest commit: 6fe941b

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

This PR includes changesets to release 2 packages

Name	Type
@aws-amplify/ai-constructs	Patch
@aws-amplify/backend-ai	Patch

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

[sobolk]

LGTM.

I'll enable e2e tests on this PR to see if they pass.

[sobolk]

Can you check why this file shows large diff and regenerate this is such a way that it doesnt?

This might be happening if you have this configured https://docs.github.com/en/get-started/getting-started-with-git/configuring-git-to-handle-line-endings .

[atierian]

Thanks for the reference. Addressed in f242254