vscode-apollo 2.5.6 → 2.6.0

package/sampleWorkspace/connectors-community/connectors/anthropic/Dockerfile

@@ -0,0 +1,5 @@
+FROM ghcr.io/apollographql/router:v2.2.0
+
+COPY router.yaml /config.yaml
+
+CMD ["--config", "/config.yaml"]

package/sampleWorkspace/connectors-community/connectors/anthropic/README

@@ -0,0 +1,61 @@
+# Anthropic REST Connector
+
+This connector currently covers the [Messages](https://docs.anthropic.com/en/api/messages) in the [Anthropic API](https://docs.anthropic.com/en/api/getting-started).
+
+## Prerequisites
+
+To use the connector, you need a [Anthropic API token](https://console.anthropic.com/settings/keys).
+
+## Getting started 
+
+1. If you haven't already, [create a new graph in GraphOS](https://www.apollographql.com/docs/graphos/get-started/guides/rest#step-1-set-up-your-graphql-api). Once you get to the **Set up your local development environment** modal in the [Create a graph](https://www.apollographql.com/docs/graphos/get-started/guides/rest#create-a-graph) section:
+    - Copy the `supergraph.yaml` and `router.yaml` files from this folder instead of the `supergraph.yaml` provided by the modal.
+    - Instead of downloading the example schema provided by the modal, copy the schema file from this fodler that you want to use.
+1. Grab your Anthropic API key and set it as an environment variable for your terminal:
+
+    ```
+    export ANTHROPIC_API_KEY=....
+    ```
+
+2. Run `rover dev` to start the local development session:
+
+    ```
+    APOLLO_KEY=service:My-Graph-s1ff1u:•••••••••••••••••••••• \
+      APOLLO_GRAPH_REF=My-Graph-s1ff1u@main \
+      rover dev --supergraph-config supergraph.yaml --router-config router.yaml
+    ```
+
+You’re all set! Open up http://localhost:4000 to query your graph using Apollo Sandbox.
+
+### Adding to an existing graph in GraphOS
+
+To add these connectors to an existing graph, publish the schema files to your graph ref using `rover subgraph publish`:
+
+```
+APOLLO_KEY=service:My-Graph-s1ff1u:•••••••••••••••••••••• \
+  rover subgraph publish My-Graph-s1ff1u@main --name messages --schema messages.graphql --routing-url http://messages
+```
+
+## Additional Setup for VS Code Task runner
+
+Edit your `.vscode/settings.json` to include the following keys:
+
+```
+{
+  "terminal.integrated.profiles.osx": {
+    "graphos": {
+      "path": "zsh",
+      "args": ["-l"],
+      "env": {
+        "ANTHROPIC_API_KEY": "",
+        "APOLLO_KEY": "",
+        ...
+      }
+    }
+  },
+  "terminal.integrated.defaultProfile.osx": "graphos"
+}
+```
+
+Once you've set this up, you can execute the `Tasks: Run Task` command in VS Code to run the `rover dev` task.
+Alternatively, you can open a new terminal window in VS Code with the `graphos` profile, then run `rover dev --supergraph-config supergraph.yaml --router-config router.yaml`.

package/sampleWorkspace/connectors-community/connectors/anthropic/messages.graphql

@@ -0,0 +1,258 @@
+extend schema
+  @link(
+    url: "https://specs.apollo.dev/federation/v2.10"
+    import: ["@key", "@requires", "@shareable"]
+  )
+  @link(
+    url: "https://specs.apollo.dev/connect/v0.2"
+    import: ["@source", "@connect"]
+  )
+  @source(
+    name: "anthropic"
+    http: {
+      baseURL: "https://api.anthropic.com/v1/"
+      headers: [
+        { name: "x-api-key", value: "{$config.apiKey}" }
+        { name: "anthropic-version", value: "2023-06-01" }
+      ]
+    }
+  )
+
+type ContentBlock {
+  text: String
+  type: String
+  id: ID
+  name: String
+  input: JSON
+}
+enum ContentBlockType {
+  TEXT
+  TOOL
+}
+type Message {
+  id: ID!
+  model: String
+  content: [ContentBlock]
+  role: MessageRole
+  stopReason: String
+  stopSequence: [String]
+  usage: TokenUsage
+  metadata: Metadata
+}
+input MessageInput {
+  content: String
+  role: MessageRole
+}
+enum MessageRole {
+  USER
+  ASSISTANT
+}
+type Metadata {
+  userId: ID
+}
+input MetadataInput {
+  userId: ID
+}
+type Model {
+  id: ID!
+  name: String
+  createdAt: String
+}
+type Mutation {
+  createMessage(
+    messages: [MessageInput]!
+    "The model that will complete your prompt."
+    model: String = "claude-3-7-sonnet-20250219"
+    "The maximum number of tokens to generate before stopping."
+    max_tokens: Int = 1024
+    options: MessageOptionsInput
+  ): Message
+    @connect(
+      #https://docs.anthropic.com/en/api/messages
+      source: "anthropic"
+      http: {
+        POST: "/messages"
+        body: """
+        model: $args.model
+        max_tokens: $args.max_tokens
+        messages: $args.messages {
+          role: role->match(
+            ['USER','user'],
+            ['ASSISTANT','assistant']
+          )
+          content
+        }
+        metadata: $args.options.metadata {
+          user_id: userId
+        }
+        stop_sequences: $args.options.stopSequences
+        system: $args.options.systemPrompt
+        temperature: $args.options.temperature
+        thinking: $args.options.thinking {
+          type: type->match(
+            ['DISABLED', 'disabled'],
+            ['ENABLED', 'enabled']
+          )
+          budget_tokens: budgetTokens
+        }
+        tool_choice: $args.options.toolChoice {
+          type: type->match(
+            ['NONE', 'none'],
+            ['TOOL', 'tool'],
+            ['ANY', 'any'],
+            ['AUTO', 'auto']
+          )
+          disable_parallel_tool_use: disableParallelToolUse
+          name
+        }
+        tools: $args.options.tools {
+          name
+          description
+          input_schema: inputSchema
+        }
+        """
+      }
+      selection: """
+      id
+      model
+      role: role->match(
+        ['user','USER'],
+        ['assistant','ASSISTANT']
+      )
+      content {
+        type: type->match(
+          ['text','TEXT'],
+          ['tool','TOOL']
+        )
+        text
+        id
+        name
+        input
+      }
+      stopReason: stop_reason
+      stopSequence: stop_sequence
+      usage {
+        inputTokens: input_tokens
+        outputTokens: output_tokens
+        cacheReadInputTokens: cache_read_input_tokens
+        cacheCreationInputTokens: cache_creation_input_tokens
+      }
+      metadata {
+        userId: user_id
+      }
+      """
+    )
+}
+input MessageOptionsInput {
+  "An object describing metadata about the request."
+  metadata: MetadataInput
+  """
+  If you want the model to stop generating when it encounters custom strings of text, you can use the stop_sequences parameter. If the model encounters one of the custom sequences, the response stop_reason value will be "stop_sequence" and the response stop_sequence value will contain the matched stop sequence.
+  """
+  stopSequences: [String]
+  "A system prompt is a way of providing context and instructions to Claude, such as specifying a particular goal or role."
+  systemPrompt: String
+  "Amount of randomness injected into the response. Ranges from 0.0 to 1.0."
+  temperature: Float = 1.0
+  """
+  Configuration for enabling Claude's extended thinking.
+
+  When enabled, responses include thinking content blocks showing Claude's thinking process before the final answer. Requires a minimum budget of 1,024 tokens and counts towards your max_tokens limit.
+  """
+  thinking: ThinkingInput
+  "How the model should use the provided tools. The model can use a specific tool, any available tool, decide by itself, or not use tools at all."
+  toolChoice: ToolChoiceInput
+  "Definitions of tools that the model may use."
+  tools: [ToolInput]
+  "Only sample from the top K options for each subsequent token. Recommended for advanced use cases only. You usually only need to use temperature."
+  topK: Float
+  """
+  Use nucleus sampling.
+  In nucleus sampling, we compute the cumulative distribution over all the options for each subsequent token in decreasing probability order and cut it off once it reaches a particular probability specified by top_p. You should either alter temperature or top_p, but not both.
+
+  Recommended for advanced use cases only. You usually only need to use temperature. Required range: 0 < x < 1.
+  """
+  topP: Float
+}
+type Query {
+  countTokens(
+    messages: [MessageInput]!
+    model: String = "claude-3-7-sonnet-20250219"
+  ): Int
+    @connect(
+      #https://docs.anthropic.com/en/api/messages-count-tokens
+      source: "anthropic"
+      http: {
+        POST: "/messages/count_tokens"
+        body: """
+        model: $args.model
+        messages: $args.messages {
+          role: role->match(
+            ['USER','user'],
+            ['ASSISTANT','assistant']
+          )
+          content
+        }
+        """
+      }
+      selection: """
+      $.input_tokens
+      """
+    )
+  model(id: String!): Model
+    @connect(
+      #https://docs.anthropic.com/en/api/models
+      source: "anthropic"
+      http: { GET: "/models/$args.id" }
+      selection: """
+      id
+      name
+      createdAt: created_at
+      """
+    )
+  models: [Model]
+    @connect(
+      #https://docs.anthropic.com/en/api/models-list
+      source: "anthropic"
+      http: { GET: "/models" }
+      selection: """
+      id
+      name
+      createdAt: created_at
+      """
+    )
+}
+input ThinkingInput {
+  type: ThinkingType = DISABLED
+  "Determines how many tokens Claude can use for its internal reasoning process. Larger budgets can enable more thorough analysis for complex problems, improving response quality. Must be ≥1024 and less than max_tokens"
+  budgetTokens: Int = 1024
+}
+type TokenUsage @shareable {
+  inputTokens: Int
+  cacheReadInputTokens: Int
+  cacheCreationInputTokens: Int
+  outputTokens: Int
+}
+enum ThinkingType {
+  DISABLED
+  ENABLED
+}
+input ToolChoiceInput {
+  type: ToolChoiceType = NONE
+  "Whether to disable parallel tool use."
+  disableParallelToolUse: Boolean = false
+  "The name of the tool to use."
+  name: String
+}
+enum ToolChoiceType {
+  NONE
+  TOOL
+  ANY
+  AUTO
+}
+input ToolInput {
+  name: String
+  description: String
+  inputSchema: JSON
+}
+scalar JSON

package/sampleWorkspace/connectors-community/connectors/anthropic/router.yaml

@@ -0,0 +1,18 @@
+supergraph:
+  listen: 0.0.0.0:${env.PORT:-4000}
+
+headers:
+  all:
+    request:
+      - propagate:
+          matching: .*
+telemetry:
+  instrumentation:
+    spans: 
+      mode: spec_compliant
+
+connectors:
+  sources:
+    messages.anthropic:
+      $config:
+        apiKey: ${env.ANTHROPOIC_API_KEY}

package/sampleWorkspace/connectors-community/connectors/anthropic/supergraph.yaml

@@ -0,0 +1,6 @@
+federation_version: =2.11.0
+subgraphs:
+  messages:
+    routing_url: http://messages
+    schema:
+      file: messages.graphql

package/sampleWorkspace/connectors-community/connectors/apollo-ecomm-simple/README

@@ -0,0 +1,3 @@
+# Apollo EComm connector
+
+This is based on the [Apollo getting started guide](https://www.apollographql.com/docs/graphos/get-started/guides/rest#step-2-connect-rest-apis) connector and is used for free API access to learn.

package/sampleWorkspace/connectors-community/connectors/apollo-ecomm-simple/connector.graphql

@@ -0,0 +1,38 @@
+
+# These are the necessary federation and connector directives you will be using
+extend schema
+  @link(
+    url: "https://specs.apollo.dev/federation/v2.10"
+    import: ["@key"]
+  )
+  @link(
+    url: "https://specs.apollo.dev/connect/v0.2"
+    import: ["@connect", "@source"]
+  )
+# A @source directive defines a shared data source for multiple connectors.
+  @source(
+    name: "ecomm"
+    http: { baseURL: "https://ecommerce.demo-api.apollo.dev/" }
+  )
+
+type Product {
+  id: ID!
+  name: String
+  description: String
+}
+
+type Query {
+  products: [Product]
+    # A @connect directive defines the API data source of a GraphQL schema field.
+    @connect(
+      source: "ecomm"
+      http: { GET: "/products" }
+      selection: """
+      $.products {
+        id
+        name
+        description
+      }
+      """
+    )
+}

package/sampleWorkspace/connectors-community/connectors/apollo-ecomm-simple/router.yaml

@@ -0,0 +1,18 @@
+supergraph:
+  listen: 0.0.0.0:${env.PORT:-4000}
+
+headers:
+  all:
+    request:
+      - propagate:
+          matching: .*
+telemetry:
+  instrumentation:
+    spans: 
+      mode: spec_compliant
+
+# connectors:
+#   subgraphs:
+#     connector:
+#       $config:
+#         apiKey: ${env.API_KEY}

package/sampleWorkspace/connectors-community/connectors/apollo-ecomm-simple/supergraph.yaml

@@ -0,0 +1,6 @@
+federation_version: =2.11.0
+subgraphs:
+  connector:
+    routing_url: http://connector
+    schema:
+      file: connector.graphql

package/sampleWorkspace/connectors-community/connectors/apple/README

@@ -0,0 +1,36 @@
+# Apple App Store Connect API REST Connector
+
+This connector currently covers the App object with builds and price points in the App Store Connect API. To use this, you'll need to add a `API_KEY` in your environment variables then running `rover` or the `router` with the config files in this folder. 
+
+## Additional Setup for VS Code Task runner
+
+Edit your `.vscode/settings.json` to include the Strapi specific keys
+
+```
+{
+  "terminal.integrated.profiles.osx": {
+    "graphos": {
+      "path": "zsh",
+      "args": ["-l"],
+      "env": { 
+        "API_KEY": "",
+        "APOLLO_KEY": "",
+        ...
+      }
+    }
+  },
+  "terminal.integrated.defaultProfile.osx": "graphos"
+}
+
+```
+
+Then you can execute the "Tasks: Run Task" command in VS code to execute the `rover dev` task or simply open a new terminal window in vscode with the `graphos` profile, then you can simply run `rover dev --supergraph-config supergraph.yaml --router-config router.yaml`.
+
+## Contributing
+
+The following schema modules need to be:
+
+1. A schema designed for that portion of the rest API as a new `.graphql` file
+2. Additions to the `router.yaml` and `supergraph.yaml` files
+
+There are various modules that can be implemented and can be found in the [documentation navigation](https://developer.apple.com/documentation/) bar

package/sampleWorkspace/connectors-community/connectors/apple/app-store-connect.graphql

@@ -0,0 +1,100 @@
+extend schema
+  @link(
+    url: "https://specs.apollo.dev/federation/v2.10"
+    import: ["@key", "@requires"]
+  )
+  @link(
+    url: "https://specs.apollo.dev/connect/v0.2"
+    import: ["@source", "@connect"]
+  )
+  @source(
+    name: "connect-api"
+    http: {
+      # https://developer.apple.com/documentation/appstoreconnectapi
+      # https://developer.apple.com/sample-code/app-store-connect/app-store-connect-openapi-specification.zip
+      baseURL: "https://api.appstoreconnect.apple.com/v1"
+      headers: [{ name: "Authorization", value: "Bearer {$config.apiKey}" }]
+    }
+  )
+
+type App {
+  id: ID!
+  name: String
+  bundleId: String
+  sku: String
+  builds: [Build]
+    @connect(
+      source: "connect-api"
+      http: { GET: "/apps/{$this.id}/builds" }
+      selection: """
+      $.data {
+        id
+        $.attributes {
+          version
+          expired
+          minOsVersion
+        }
+      }
+      """
+    )
+  pricePoints: [AppPricePoint]
+    @connect(
+      source: "connect-api"
+      http: { GET: "/apps/{$this.id}/appPricePoints" }
+      selection: """
+      $.data {
+        id
+        $.attributes {
+          customerPrice
+          proceeds
+        }
+      }
+      """
+    )
+}
+
+type AppPricePoint {
+  id: ID!
+  customerPrice: String
+  proceeds: String
+}
+
+type Build {
+  id: ID!
+  expired: Boolean
+  version: String
+  minOsVersion: String
+}
+
+type Query {
+  apps: [App]
+    @connect(
+      source: "connect-api"
+      http: { GET: "/apps" }
+      selection: """
+      $.data {
+        id
+        $.attributes {
+          name
+          bundleId
+          sku
+        }
+      }
+      """
+    )
+  app(id: ID!): App
+    @connect(
+      source: "connect-api"
+      http: { GET: "/apps/{$args.id}" }
+      selection: """
+      $.data {
+        id
+        $.attributes {
+          name
+          bundleId
+          sku
+        }
+      }
+      """
+    )
+}

package/sampleWorkspace/connectors-community/connectors/apple/router.yaml

@@ -0,0 +1,18 @@
+supergraph:
+  listen: 0.0.0.0:${env.PORT:-4000}
+
+headers:
+  all:
+    request:
+      - propagate:
+          matching: .*
+telemetry:
+  instrumentation:
+    spans: 
+      mode: spec_compliant
+
+connectors:
+  subgraphs:
+    app-store-connect:
+      $config:
+        apiKey: ${env.API_KEY}

package/sampleWorkspace/connectors-community/connectors/apple/supergraph.yaml

@@ -0,0 +1,6 @@
+federation_version: =2.11.0
+subgraphs:
+  app-store-connect:
+    routing_url: http://app-store-connect
+    schema:
+      file: app-store-connect.graphql