@pulsemcp/air-provider-github 0.0.1 → 0.0.3

package/dist/github-provider.d.ts

@@ -7,9 +7,8 @@ export interface GitHubUri {
 }
 export interface GitHubProviderOptions {
     /**
-     * GitHub personal access token for authenticating API requests.
-     * Required for private repositories. Optional for public repos
-     * (unauthenticated requests have lower rate limits).
+     * GitHub personal access token for authenticating git clone.
+     * Required for private repositories. Optional for public repos.
      *
      * Can also be set via the AIR_GITHUB_TOKEN environment variable.
      */
@@ -23,21 +22,39 @@ export interface GitHubProviderOptions {
  */
 export declare function parseGitHubUri(uri: string): GitHubUri;
 /**
- * Get the local cache directory for GitHub content.
+ * Get the local cache directory for GitHub clones.
  */
 export declare function getCacheDir(): string;
 /**
- * GitHub catalog provider — resolves github:// URIs by fetching
- * file content from the GitHub REST API.
+ * Get the clone path for a specific owner/repo/ref combination.
+ */
+export declare function getClonePath(owner: string, repo: string, ref: string): string;
+/**
+ * GitHub catalog provider — resolves github:// URIs by cloning the
+ * repository locally (shallow clone) and reading files from the clone.
  *
- * Works without authentication for public repositories. Pass a token
- * (or set AIR_GITHUB_TOKEN) for private repos or higher rate limits.
+ * Clones are cached at ~/.air/cache/github/{owner}/{repo}/{ref}/.
+ * Subsequent resolves for the same repo+ref reuse the existing clone.
  */
 export declare class GitHubCatalogProvider implements CatalogProvider {
     scheme: string;
     private token;
     constructor(options?: GitHubProviderOptions);
     resolve(uri: string, _baseDir: string): Promise<Record<string, unknown>>;
-    private fetchFromGitHub;
+    /**
+     * Return the local clone directory for a given github:// URI.
+     * This allows loadAndMerge to resolve relative path/file fields
+     * in artifact entries to absolute paths within the clone.
+     */
+    resolveSourceDir(uri: string): string | undefined;
+    /**
+     * Ensure the repository is cloned locally. If the clone already exists,
+     * reuse it. Returns the path to the clone directory.
+     */
+    private ensureClone;
+    /**
+     * Build the clone URL, injecting token for authentication if available.
+     */
+    private buildCloneUrl;
 }
 //# sourceMappingURL=github-provider.d.ts.map

package/dist/github-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-provider.d.ts","sourceRoot":"","sources":["../src/github-provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAuBrD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,MAAM,SAAY;IAClB,OAAO,CAAC,KAAK,CAAqB;gBAEtB,OAAO,CAAC,EAAE,qBAAqB;IAIrC,OAAO,CACX,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAuBrB,eAAe;CAkD9B"}
+{"version":3,"file":"github-provider.d.ts","sourceRoot":"","sources":["../src/github-provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CA6BrD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7E;AAUD;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,MAAM,SAAY;IAClB,OAAO,CAAC,KAAK,CAAqB;gBAEtB,OAAO,CAAC,EAAE,qBAAqB;IAIrC,OAAO,CACX,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAmBnC;;;;OAIG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAiBjD;;;OAGG;IACH,OAAO,CAAC,WAAW;IAkCnB;;OAEG;IACH,OAAO,CAAC,aAAa;CAMtB"}

package/dist/github-provider.js

@@ -1,5 +1,21 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { resolve } from "path";
+import { execFileSync } from "child_process";
+import { existsSync, readFileSync } from "fs";
+import { resolve, dirname } from "path";
+/**
+ * Validate that a URI component contains only safe characters.
+ * Prevents path traversal and shell injection via owner/repo/ref values.
+ */
+function validateUriComponent(value, label) {
+    // Allow alphanumeric, hyphens, dots, underscores, forward slashes (for paths)
+    if (!/^[a-zA-Z0-9._\-/]+$/.test(value)) {
+        throw new Error(`Invalid ${label} in github:// URI: "${value}". ` +
+            `Only alphanumeric characters, hyphens, dots, underscores, and forward slashes are allowed.`);
+    }
+    // Prevent path traversal
+    if (value.includes("..")) {
+        throw new Error(`Invalid ${label} in github:// URI: "${value}". Path traversal ("..") is not allowed.`);
+    }
+}
 /**
  * Parse a github:// URI into its components.
  *
@@ -22,21 +38,41 @@ export function parseGitHubUri(uri) {
         ref = filePath.slice(atIndex + 1);
         filePath = filePath.slice(0, atIndex);
     }
+    // Validate all components to prevent shell injection and path traversal
+    validateUriComponent(owner, "owner");
+    validateUriComponent(repo, "repo");
+    if (ref)
+        validateUriComponent(ref, "ref");
+    validateUriComponent(filePath, "path");
     return { owner, repo, path: filePath, ref };
 }
 /**
- * Get the local cache directory for GitHub content.
+ * Get the local cache directory for GitHub clones.
  */
 export function getCacheDir() {
     const home = process.env.HOME || process.env.USERPROFILE || "~";
     return resolve(home, ".air", "cache", "github");
 }
 /**
- * GitHub catalog provider — resolves github:// URIs by fetching
- * file content from the GitHub REST API.
+ * Get the clone path for a specific owner/repo/ref combination.
+ */
+export function getClonePath(owner, repo, ref) {
+    return resolve(getCacheDir(), owner, repo, ref);
+}
+/**
+ * Redact tokens from a string to prevent leaking credentials in logs.
+ */
+function redactToken(text, token) {
+    if (!token)
+        return text;
+    return text.replaceAll(token, "***");
+}
+/**
+ * GitHub catalog provider — resolves github:// URIs by cloning the
+ * repository locally (shallow clone) and reading files from the clone.
  *
- * Works without authentication for public repositories. Pass a token
- * (or set AIR_GITHUB_TOKEN) for private repos or higher rate limits.
+ * Clones are cached at ~/.air/cache/github/{owner}/{repo}/{ref}/.
+ * Subsequent resolves for the same repo+ref reuse the existing clone.
  */
 export class GitHubCatalogProvider {
     scheme = "github";
@@ -47,58 +83,75 @@ export class GitHubCatalogProvider {
     async resolve(uri, _baseDir) {
         const parsed = parseGitHubUri(uri);
         const ref = parsed.ref || "HEAD";
-        const cacheDir = getCacheDir();
-        const cacheKey = `${parsed.owner}/${parsed.repo}/${ref}/${parsed.path}`;
-        const cachePath = resolve(cacheDir, cacheKey);
-        // Check cache first
-        if (existsSync(cachePath)) {
-            const content = readFileSync(cachePath, "utf-8");
-            return JSON.parse(content);
+        const cloneDir = this.ensureClone(parsed.owner, parsed.repo, ref);
+        const filePath = resolve(cloneDir, parsed.path);
+        if (!existsSync(filePath)) {
+            throw new Error(`File not found in cloned repository: ${parsed.path}\n` +
+                `  Repository: ${parsed.owner}/${parsed.repo}\n` +
+                `  Ref: ${ref}\n` +
+                `  Clone path: ${cloneDir}`);
         }
-        const content = await this.fetchFromGitHub(parsed);
-        // Write to cache
-        const cacheFileDir = resolve(cachePath, "..");
-        mkdirSync(cacheFileDir, { recursive: true });
-        writeFileSync(cachePath, content);
+        const content = readFileSync(filePath, "utf-8");
         return JSON.parse(content);
     }
-    async fetchFromGitHub(parsed) {
-        const repoSlug = `${parsed.owner}/${parsed.repo}`;
-        let url = `https://api.github.com/repos/${repoSlug}/contents/${parsed.path}`;
-        if (parsed.ref) {
-            url += `?ref=${encodeURIComponent(parsed.ref)}`;
+    /**
+     * Return the local clone directory for a given github:// URI.
+     * This allows loadAndMerge to resolve relative path/file fields
+     * in artifact entries to absolute paths within the clone.
+     */
+    resolveSourceDir(uri) {
+        const parsed = parseGitHubUri(uri);
+        const ref = parsed.ref || "HEAD";
+        const cloneDir = getClonePath(parsed.owner, parsed.repo, ref);
+        // Return the directory containing the resolved file within the clone,
+        // so relative paths in the artifact index resolve correctly.
+        const filePath = resolve(cloneDir, parsed.path);
+        const sourceDir = dirname(filePath);
+        // Only return if the clone already exists (resolve() should be called first)
+        if (existsSync(cloneDir)) {
+            return sourceDir;
         }
-        const headers = {
-            Accept: "application/vnd.github.v3+json",
-            "User-Agent": "air-provider-github",
-        };
-        if (this.token) {
-            headers["Authorization"] = `Bearer ${this.token}`;
+        return undefined;
+    }
+    /**
+     * Ensure the repository is cloned locally. If the clone already exists,
+     * reuse it. Returns the path to the clone directory.
+     */
+    ensureClone(owner, repo, ref) {
+        const cloneDir = getClonePath(owner, repo, ref);
+        if (existsSync(resolve(cloneDir, ".git"))) {
+            return cloneDir;
         }
-        let response;
+        const repoUrl = this.buildCloneUrl(owner, repo);
+        const publicUrl = `https://github.com/${owner}/${repo}.git`;
         try {
-            response = await fetch(url, { headers });
+            const args = ref === "HEAD"
+                ? ["clone", "--depth", "1", repoUrl, cloneDir]
+                : ["clone", "--depth", "1", "--branch", ref, repoUrl, cloneDir];
+            execFileSync("git", args, { stdio: "pipe", timeout: 60000 });
         }
         catch (err) {
-            throw new Error(`Network error fetching ${url}.\n` +
-                (err instanceof Error ? `  Error: ${err.message}` : ""));
-        }
-        if (!response.ok) {
-            const hint = response.status === 404
+            const rawMsg = err instanceof Error ? err.message : String(err);
+            const msg = redactToken(rawMsg, this.token);
+            const hint = msg.includes("Authentication failed") || msg.includes("could not read Username")
                 ? " (repository may be private — set AIR_GITHUB_TOKEN or pass token option)"
-                : response.status === 403
-                    ? " (rate limit exceeded — set AIR_GITHUB_TOKEN for higher limits)"
+                : msg.includes("not found")
+                    ? " (repository or ref not found)"
                     : "";
-            throw new Error(`GitHub API returned ${response.status} for ${url}${hint}\n` +
-                `  Repository: ${repoSlug}\n` +
-                `  Path: ${parsed.path}`);
+            throw new Error(`Failed to clone ${owner}/${repo} at ref "${ref}"${hint}\n` +
+                `  URL: ${publicUrl}\n` +
+                `  Error: ${msg}`);
         }
-        const data = (await response.json());
-        if (!data.content || data.encoding !== "base64") {
-            throw new Error(`Unexpected response format from GitHub API for ${url}.\n` +
-                `  Expected base64-encoded content, got encoding="${data.encoding}".`);
+        return cloneDir;
+    }
+    /**
+     * Build the clone URL, injecting token for authentication if available.
+     */
+    buildCloneUrl(owner, repo) {
+        if (this.token) {
+            return `https://${this.token}@github.com/${owner}/${repo}.git`;
         }
-        return Buffer.from(data.content, "base64").toString("utf-8");
+        return `https://github.com/${owner}/${repo}.git`;
     }
 }
 //# sourceMappingURL=github-provider.js.map

package/dist/github-provider.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import type { AirExtension } from "@pulsemcp/air-core";
-export { GitHubCatalogProvider, parseGitHubUri, getCacheDir } from "./github-provider.js";
+export { GitHubCatalogProvider, parseGitHubUri, getCacheDir, getClonePath } from "./github-provider.js";
 export type { GitHubUri, GitHubProviderOptions } from "./github-provider.js";
 declare const extension: AirExtension;
 export default extension;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,QAAA,MAAM,SAAS,EAAE,YAIhB,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACxG,YAAY,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,QAAA,MAAM,SAAS,EAAE,YAIhB,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 import { GitHubCatalogProvider } from "./github-provider.js";
-export { GitHubCatalogProvider, parseGitHubUri, getCacheDir } from "./github-provider.js";
+export { GitHubCatalogProvider, parseGitHubUri, getCacheDir, getClonePath } from "./github-provider.js";
 const extension = {
     name: "github",
     type: "provider",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG1F,MAAM,SAAS,GAAiB;IAC9B,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,IAAI,qBAAqB,EAAE;CACtC,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGxG,MAAM,SAAS,GAAiB;IAC9B,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,IAAI,qBAAqB,EAAE;CACtC,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pulsemcp/air-provider-github",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "publishConfig": {
     "access": "public"
   },
@@ -29,7 +29,7 @@
     "lint": "tsc --noEmit"
   },
   "dependencies": {
-    "@pulsemcp/air-core": "0.0.1"
+    "@pulsemcp/air-core": "0.0.3"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",