@gemstack/connector-github 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Suleiman Shahbari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @gemstack/connector-github
+
+A GitHub connector for GemStack AI orchestration. Read and act on issues, pull requests, and repository files over the GitHub REST API. Built with [`@gemstack/connectors`](../connectors); the result is a standard `@gemstack/mcp` server.
+
+## Install
+
+```bash
+npm i @gemstack/connector-github @gemstack/connectors @gemstack/mcp
+```
+
+## Use
+
+```ts
+import { mountConnectors } from '@gemstack/connectors'
+import { Mcp } from '@gemstack/mcp'
+import github from '@gemstack/connector-github'
+
+const Server = mountConnectors([github], {
+  // A token with `repo` scope. A PAT or an OAuth bearer both work.
+  credentials: () => ({ token: process.env.GITHUB_TOKEN }),
+})
+
+Mcp.web('/mcp/github', Server)
+```
+
+Tools are exposed namespaced by connector id, e.g. `github_list-issues`.
+
+## Auth
+
+The connector declares `auth: { type: 'pat', env: 'GITHUB_TOKEN' }`. It only consumes a bearer token from `ctx.auth.token` — it does no OAuth handshake itself. To protect a web endpoint with OAuth 2.1, wrap it with `@gemstack/mcp`'s `oauth2McpMiddleware` + `registerOAuth2Metadata` and feed the verified token through the mount `credentials` option.
+
+## Tools
+
+| Tool | Kind | Description |
+|---|---|---|
+| `get-repo` | read | Repository metadata |
+| `list-issues` | read | Issues (excludes PRs) |
+| `get-issue` | read | One issue by number |
+| `list-pull-requests` | read | Pull requests |
+| `get-pull-request` | read | One PR by number |
+| `get-file` | read | File contents (base64-decoded) |
+| `search-issues` | read | Search issues/PRs (GitHub search syntax) |
+| `comment-on-issue` | write | Comment on an issue or PR |
+| `create-issue` | write | Open a new issue |
+
+Read tools are annotated `readOnly` so an agent can auto-approve them; write tools are not.
+
+Responses are slimmed to the fields an agent needs (no raw API envelopes) to keep token usage down.

package/dist/client.d.ts

@@ -0,0 +1,14 @@
+import type { ConnectorContext } from '@gemstack/connectors';
+/** Thrown when the GitHub API returns a non-2xx response. */
+export declare class GitHubError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+/**
+ * Minimal GitHub REST client over global `fetch`. The bearer token comes from
+ * the connector context (`ctx.auth.token`) — a PAT or an OAuth token; GitHub
+ * accepts either as `Authorization: Bearer`. No SDK dependency, so the connector
+ * stays light.
+ */
+export declare function gh<T = unknown>(ctx: ConnectorContext, method: string, path: string, body?: unknown): Promise<T>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAI5D,6DAA6D;AAC7D,qBAAa,WAAY,SAAQ,KAAK;IAE3B,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;GAKG;AACH,wBAAsB,EAAE,CAAC,CAAC,GAAG,OAAO,EAClC,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,CAAC,CAAC,CAyBZ"}

package/dist/client.js

@@ -0,0 +1,41 @@
+const API = 'https://api.github.com';
+/** Thrown when the GitHub API returns a non-2xx response. */
+export class GitHubError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'GitHubError';
+    }
+}
+/**
+ * Minimal GitHub REST client over global `fetch`. The bearer token comes from
+ * the connector context (`ctx.auth.token`) — a PAT or an OAuth token; GitHub
+ * accepts either as `Authorization: Bearer`. No SDK dependency, so the connector
+ * stays light.
+ */
+export async function gh(ctx, method, path, body) {
+    const token = ctx.auth.token;
+    if (!token) {
+        throw new GitHubError(401, 'no GitHub token available — set GITHUB_TOKEN or provide one via the mount `credentials` option');
+    }
+    const res = await fetch(`${API}${path}`, {
+        method,
+        headers: {
+            Authorization: `Bearer ${token}`,
+            Accept: 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28',
+            'User-Agent': 'gemstack-connector-github',
+            ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+        },
+        ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+    });
+    if (!res.ok) {
+        const detail = await res.text().catch(() => '');
+        throw new GitHubError(res.status, `${method} ${path} -> ${res.status} ${res.statusText}${detail ? `: ${detail}` : ''}`);
+    }
+    if (res.status === 204)
+        return undefined;
+    return (await res.json());
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,GAAG,GAAG,wBAAwB,CAAA;AAEpC,6DAA6D;AAC7D,MAAM,OAAO,WAAY,SAAQ,KAAK;IAE3B;IADT,YACS,MAAc,EACrB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAA;QAHP,WAAM,GAAN,MAAM,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;IAC3B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,EAAE,CACtB,GAAqB,EACrB,MAAc,EACd,IAAY,EACZ,IAAc;IAEd,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAA;IAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CACnB,GAAG,EACH,gGAAgG,CACjG,CAAA;IACH,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,EAAE,EAAE;QACvC,MAAM;QACN,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,KAAK,EAAE;YAChC,MAAM,EAAE,6BAA6B;YACrC,sBAAsB,EAAE,YAAY;YACpC,YAAY,EAAE,2BAA2B;YACzC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE;QACD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9D,CAAC,CAAA;IACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAC/C,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,IAAI,IAAI,OAAO,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACzH,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAc,CAAA;IAC7C,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAA;AAChC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { GitHubError } from './client.js';
+/**
+ * GitHub connector: read and act on issues, pull requests, and repo files.
+ *
+ * Auth is a token with `repo` scope. Declared as `pat` (set `GITHUB_TOKEN`),
+ * but an OAuth bearer works identically — the orchestrator supplies whichever
+ * via the mount `credentials` option.
+ */
+declare const _default: import("@gemstack/connectors").Connector;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAkCzC;;;;;;GAMG;;AACH,wBAmKE"}

package/dist/index.js

@@ -0,0 +1,174 @@
+import { defineConnector } from '@gemstack/connectors';
+import { z } from 'zod';
+import { gh } from './client.js';
+export { GitHubError } from './client.js';
+const repo = { owner: z.string().min(1), repo: z.string().min(1) };
+const enc = encodeURIComponent;
+/** Slim an API issue (or PR-as-issue) down to the fields an agent needs. */
+function slimIssue(i) {
+    return {
+        number: i.number,
+        title: i.title,
+        state: i.state,
+        author: i.user?.login,
+        labels: Array.isArray(i.labels) ? i.labels.map((l) => (typeof l === 'string' ? l : l?.name)) : [],
+        comments: i.comments,
+        isPullRequest: i.pull_request != null,
+        url: i.html_url,
+    };
+}
+function slimPull(p) {
+    return {
+        number: p.number,
+        title: p.title,
+        state: p.state,
+        draft: p.draft,
+        author: p.user?.login,
+        head: p.head?.ref,
+        base: p.base?.ref,
+        merged: p.merged,
+        mergeable: p.mergeable,
+        url: p.html_url,
+    };
+}
+/**
+ * GitHub connector: read and act on issues, pull requests, and repo files.
+ *
+ * Auth is a token with `repo` scope. Declared as `pat` (set `GITHUB_TOKEN`),
+ * but an OAuth bearer works identically — the orchestrator supplies whichever
+ * via the mount `credentials` option.
+ */
+export default defineConnector({
+    id: 'github',
+    name: 'GitHub',
+    instructions: 'Read and act on GitHub issues, pull requests, and repository files.',
+    auth: { type: 'pat', env: 'GITHUB_TOKEN', description: 'GitHub token with `repo` scope (PAT or OAuth bearer)' },
+    tools: [
+        {
+            name: 'get-repo',
+            description: 'Get metadata for a repository.',
+            schema: z.object({ ...repo }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const r = await gh(ctx, 'GET', `/repos/${enc(input.owner)}/${enc(input.repo)}`);
+                return {
+                    fullName: r.full_name,
+                    description: r.description,
+                    private: r.private,
+                    defaultBranch: r.default_branch,
+                    stars: r.stargazers_count,
+                    openIssues: r.open_issues_count,
+                    url: r.html_url,
+                };
+            },
+        },
+        {
+            name: 'list-issues',
+            description: 'List issues in a repository (newest first). Excludes pull requests.',
+            schema: z.object({
+                ...repo,
+                state: z.enum(['open', 'closed', 'all']).optional(),
+                limit: z.number().int().min(1).max(100).optional(),
+            }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const q = new URLSearchParams({ state: input.state ?? 'open', per_page: String(input.limit ?? 30) });
+                const issues = await gh(ctx, 'GET', `/repos/${enc(input.owner)}/${enc(input.repo)}/issues?${q}`);
+                return issues.filter((i) => i.pull_request == null).map(slimIssue);
+            },
+        },
+        {
+            name: 'get-issue',
+            description: 'Get a single issue by number.',
+            schema: z.object({ ...repo, number: z.number().int().positive() }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const i = await gh(ctx, 'GET', `/repos/${enc(input.owner)}/${enc(input.repo)}/issues/${input.number}`);
+                return { ...slimIssue(i), body: i.body };
+            },
+        },
+        {
+            name: 'list-pull-requests',
+            description: 'List pull requests in a repository.',
+            schema: z.object({
+                ...repo,
+                state: z.enum(['open', 'closed', 'all']).optional(),
+                limit: z.number().int().min(1).max(100).optional(),
+            }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const q = new URLSearchParams({ state: input.state ?? 'open', per_page: String(input.limit ?? 30) });
+                const pulls = await gh(ctx, 'GET', `/repos/${enc(input.owner)}/${enc(input.repo)}/pulls?${q}`);
+                return pulls.map(slimPull);
+            },
+        },
+        {
+            name: 'get-pull-request',
+            description: 'Get a single pull request by number.',
+            schema: z.object({ ...repo, number: z.number().int().positive() }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const p = await gh(ctx, 'GET', `/repos/${enc(input.owner)}/${enc(input.repo)}/pulls/${input.number}`);
+                return { ...slimPull(p), body: p.body, additions: p.additions, deletions: p.deletions, changedFiles: p.changed_files };
+            },
+        },
+        {
+            name: 'get-file',
+            description: 'Read the contents of a file in a repository.',
+            schema: z.object({ ...repo, path: z.string().min(1), ref: z.string().optional() }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const q = input.ref ? `?ref=${enc(input.ref)}` : '';
+                const f = await gh(ctx, 'GET', `/repos/${enc(input.owner)}/${enc(input.repo)}/contents/${input.path.split('/').map(enc).join('/')}${q}`);
+                if (Array.isArray(f))
+                    return { error: `path "${input.path}" is a directory, not a file` };
+                const content = f.encoding === 'base64' && typeof f.content === 'string'
+                    ? Buffer.from(f.content, 'base64').toString('utf8')
+                    : f.content;
+                return { path: f.path, size: f.size, sha: f.sha, content };
+            },
+        },
+        {
+            name: 'search-issues',
+            description: 'Search issues and pull requests across GitHub with a query (GitHub search syntax).',
+            schema: z.object({ query: z.string().min(1), limit: z.number().int().min(1).max(100).optional() }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const q = new URLSearchParams({ q: input.query, per_page: String(input.limit ?? 20) });
+                const res = await gh(ctx, 'GET', `/search/issues?${q}`);
+                return { totalCount: res.total_count, items: res.items.map(slimIssue) };
+            },
+        },
+        {
+            name: 'comment-on-issue',
+            description: 'Add a comment to an issue or pull request.',
+            schema: z.object({ ...repo, number: z.number().int().positive(), body: z.string().min(1) }),
+            annotations: { openWorld: true },
+            handle: async (input, ctx) => {
+                const c = await gh(ctx, 'POST', `/repos/${enc(input.owner)}/${enc(input.repo)}/issues/${input.number}/comments`, { body: input.body });
+                return { id: c.id, url: c.html_url };
+            },
+        },
+        {
+            name: 'create-issue',
+            description: 'Open a new issue in a repository.',
+            schema: z.object({
+                ...repo,
+                title: z.string().min(1),
+                body: z.string().optional(),
+                labels: z.array(z.string()).optional(),
+            }),
+            annotations: { openWorld: true },
+            handle: async (input, ctx) => {
+                const payload = { title: input.title };
+                if (input.body != null)
+                    payload.body = input.body;
+                if (input.labels != null)
+                    payload.labels = input.labels;
+                const i = await gh(ctx, 'POST', `/repos/${enc(input.owner)}/${enc(input.repo)}/issues`, payload);
+                return { number: i.number, url: i.html_url };
+            },
+        },
+    ],
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@gemstack/connector-github",
+  "version": "0.1.0",
+  "description": "GitHub connector for GemStack AI orchestration: read and act on issues, pull requests, and repo files over the GitHub REST API. Built with @gemstack/connectors.",
+  "keywords": [
+    "mcp",
+    "connector",
+    "github",
+    "ai",
+    "agents",
+    "orchestration",
+    "gemstack"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/gemstack-land/gemstack/tree/main/packages/connector-github#readme",
+  "bugs": {
+    "url": "https://github.com/gemstack-land/gemstack/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gemstack-land/gemstack",
+    "directory": "packages/connector-github"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "zod": "^4.0.0",
+    "@gemstack/connectors": "^0.1.0",
+    "@gemstack/mcp": "^0.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "reflect-metadata": "^0.2.0",
+    "typescript": "^5.4.0"
+  },
+  "author": "Suleiman Shahbari",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "tsc -p tsconfig.test.json && cd dist-test && node --test",
+    "clean": "rm -rf dist dist-test"
+  }
+}