Add GraphQL query execution support to GitHub client

- Add graphql() method to GitHub interface in prompt_template.d.ts
- Implement graphql() method in GitHubClient class with proper error handling
- Add test case for GraphQL functionality in githubclient.test.ts
- Update GitHub documentation with GraphQL usage examples
- Support TypeScript generics for type-safe results

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Author: Copilot

docs/src/content/docs/reference/scripts/github.mdx

@@ -216,6 +216,83 @@ const releases = await github.listReleases()
 console.log(releases)
 ```
 
+## GraphQL Queries
+
+Execute GraphQL queries against the GitHub API using the `graphql` method. This provides access to GitHub's full GraphQL API v4, which often allows more efficient data retrieval than REST APIs.
+
+```js
+// Basic repository information
+const query = `
+  query($owner: String!, $name: String!) {
+    repository(owner: $owner, name: $name) {
+      name
+      description
+      stargazerCount
+      forkCount
+      primaryLanguage {
+        name
+        color
+      }
+    }
+  }
+`
+
+const result = await github.graphql(query, {
+  owner: "microsoft",
+  name: "genaiscript"
+})
+
+console.log(result.repository)
+```
+
+You can also query multiple data points in a single request:
+
+```js
+// Get issues and pull requests together
+const complexQuery = `
+  query($owner: String!, $name: String!) {
+    repository(owner: $owner, name: $name) {
+      issues(first: 5, states: OPEN) {
+        nodes {
+          number
+          title
+          author { login }
+        }
+      }
+      pullRequests(first: 5, states: OPEN) {
+        nodes {
+          number
+          title
+          author { login }
+        }
+      }
+    }
+  }
+`
+
+const data = await github.graphql(complexQuery, {
+  owner: "microsoft", 
+  name: "genaiscript"
+})
+
+console.log("Open Issues:", data.repository.issues.nodes)
+console.log("Open PRs:", data.repository.pullRequests.nodes)
+```
+
+The GraphQL method supports TypeScript generics for type safety:
+
+```js
+interface RepositoryData {
+  repository: {
+    name: string
+    stargazerCount: number
+  }
+}
+
+const result = await github.graphql<RepositoryData>(query, variables)
+// result is now properly typed
+```
+
 ## Octokit access
 
 Utilize [octokit](https://www.npmjs.com/package/octokit) to access the full GitHub APIs.

packages/core/src/githubclient.test.ts

@@ -134,4 +134,34 @@ describe("GitHubClient", async () => {
         assert(resolved.files[0].content)
         assert.strictEqual(resolved.files[0].type, "image/jpeg")
     })
+
+    await test("graphql() executes GraphQL query", async () => {
+        // Test with a simple GraphQL query to get repository information
+        const query = `
+            query($owner: String!, $name: String!) {
+                repository(owner: $owner, name: $name) {
+                    name
+                    description
+                    stargazerCount
+                }
+            }
+        `
+        const info = await client.info()
+        const variables = {
+            owner: info.owner,
+            name: info.repo
+        }
+        
+        const result = await client.graphql<{
+            repository: {
+                name: string
+                description: string
+                stargazerCount: number
+            }
+        }>(query, variables)
+        
+        assert(result.repository)
+        assert(result.repository.name === info.repo)
+        assert(typeof result.repository.stargazerCount === "number")
+    })
 })

packages/core/src/githubclient.ts

@@ -1661,6 +1661,21 @@ export class GitHubClient implements GitHub {
         }
         return res
     }
+
+    async graphql<T = any>(query: string, variables?: Record<string, any>): Promise<T> {
+        const { client } = await this.api()
+        dbg(`executing GraphQL query: ${query.slice(0, 100)}...`)
+        dbg(`GraphQL variables: %O`, variables)
+        
+        try {
+            const result = await client.graphql<T>(query, variables)
+            dbg(`GraphQL query executed successfully`)
+            return result
+        } catch (error) {
+            dbg(`GraphQL query failed: %O`, error)
+            throw error
+        }
+    }
 }
 
 function parseJobLog(text: string) {

packages/core/src/types/prompt_template.d.ts

@@ -3875,6 +3875,13 @@ interface GitHub {
      */
     resolveAssetUrl(url: string): Promise<string | undefined>
 
+    /**
+     * Executes a GraphQL query against the GitHub API
+     * @param query The GraphQL query string
+     * @param variables Optional variables for the query
+     */
+    graphql<T = any>(query: string, variables?: Record<string, any>): Promise<T>
+
     /**
      * Gets the underlying Octokit client
      */