@wingman-ai/gateway 0.3.1 → 0.4.0

package/dist/cli/core/agentInvoker.d.ts

@@ -1,4 +1,5 @@
 import type { WingmanAgentConfig } from "@/agent/config/agentConfig.js";
+import { type MCPProxyConfig } from "@/agent/config/mcpClientManager.js";
 import { type TerminalSessionManager } from "@/agent/tools/terminal_session_manager.js";
 import type { WingmanAgent } from "@/types/agents.js";
 import type { Logger } from "../../logger.js";
@@ -14,6 +15,7 @@ export interface AgentInvokerOptions {
     terminalSessionManager?: TerminalSessionManager;
     workdir?: string | null;
     defaultOutputDir?: string | null;
+    mcpProxyConfig?: MCPProxyConfig;
 }
 export interface InvokeAgentOptions {
     signal?: AbortSignal;
@@ -149,6 +151,7 @@ export declare class AgentInvoker {
     private terminalSessionManager;
     private workdir;
     private defaultOutputDir;
+    private mcpProxyConfig;
     constructor(options: AgentInvokerOptions);
     findAllAgents(): WingmanAgentConfig[];
     /**

package/dist/cli/core/agentInvoker.js

@@ -296,7 +296,8 @@ class AgentInvoker {
             if (mcpConfigs.length > 0) {
                 this.logger.debug("Initializing MCP client for agent invocation");
                 this.mcpManager = new MCPClientManager(mcpConfigs, this.logger, {
-                    executionWorkspace
+                    executionWorkspace,
+                    proxyConfig: this.mcpProxyConfig
                 });
                 await this.mcpManager.initialize();
                 const mcpTools = await this.mcpManager.getTools();
@@ -551,6 +552,7 @@ class AgentInvoker {
         _define_property(this, "terminalSessionManager", void 0);
         _define_property(this, "workdir", null);
         _define_property(this, "defaultOutputDir", null);
+        _define_property(this, "mcpProxyConfig", void 0);
         this.outputManager = options.outputManager;
         this.logger = options.logger;
         this.workspace = options.workspace || process.cwd();
@@ -559,6 +561,7 @@ class AgentInvoker {
         this.terminalSessionManager = options.terminalSessionManager || getSharedTerminalSessionManager();
         this.workdir = options.workdir || null;
         this.defaultOutputDir = options.defaultOutputDir || null;
+        this.mcpProxyConfig = options.mcpProxyConfig;
         const configLoader = new WingmanConfigLoader(this.configDir, this.workspace);
         this.wingmanConfig = configLoader.loadConfig();
         this.loader = new AgentLoader(this.configDir, this.workspace, this.wingmanConfig);

package/dist/cli/services/skillRepository.cjs

@@ -39,8 +39,8 @@ function _define_property(obj, key, value) {
 }
 const logger = (0, external_logger_cjs_namespaceObject.createLogger)();
 class SkillRepository {
-    async fetch(path) {
-        const url = `${this.baseUrl}${path}`;
+    async fetchGitHub(path) {
+        const url = `${this.githubBaseUrl}${path}`;
         const headers = {
             Accept: "application/vnd.github.v3+json",
             "User-Agent": "wingman-cli"
@@ -62,29 +62,33 @@ class SkillRepository {
     }
     async listAvailableSkills() {
         try {
-            const contents = await this.fetch(`/repos/${this.owner}/${this.repo}/contents/skills`);
-            const skills = [];
-            for (const item of contents)if ("dir" === item.type) try {
-                const metadata = await this.getSkillMetadata(item.name);
-                skills.push({
-                    name: item.name,
-                    description: metadata.description || "No description",
-                    path: item.path,
-                    metadata
-                });
-            } catch (error) {
-                logger.warn(`Could not read skill ${item.name}`, error instanceof Error ? error.message : String(error));
-            }
-            return skills;
+            if ("clawhub" === this.provider) return await this.listSkillsFromClawhub();
+            return await this.listSkillsFromGitHub();
         } catch (error) {
             if (error instanceof Error) throw new Error(`Failed to list skills: ${error.message}`);
             throw error;
         }
     }
+    async fetchJson(url, options) {
+        const response = await fetch(url, {
+            headers: options?.headers
+        });
+        if (!response.ok) throw new Error(`HTTP ${response.status} ${response.statusText}`);
+        return await response.json();
+    }
+    async fetchBinary(url, options) {
+        const response = await fetch(url, {
+            headers: options?.headers
+        });
+        if (!response.ok) throw new Error(`HTTP ${response.status} ${response.statusText}`);
+        const arrayBuffer = await response.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    }
     async getSkillMetadata(skillName) {
+        if ("clawhub" === this.provider) return await this.getClawhubSkillMetadata(skillName);
         try {
             const skillMdPath = `/repos/${this.owner}/${this.repo}/contents/skills/${skillName}/SKILL.md`;
-            const skillMd = await this.fetch(skillMdPath);
+            const skillMd = await this.fetchGitHub(skillMdPath);
             if ("file" !== skillMd.type || !skillMd.content) throw new Error("SKILL.md not found or invalid");
             const content = Buffer.from(skillMd.content, "base64").toString("utf-8");
             const metadata = this.parseSkillMetadata(content);
@@ -94,6 +98,35 @@ class SkillRepository {
             throw error;
         }
     }
+    async getClawhubSkillMetadata(skillName) {
+        try {
+            const detail = await this.fetchJson(`${this.clawhubBaseUrl}/api/v1/skills/${encodeURIComponent(skillName)}`, {
+                headers: {
+                    Accept: "application/json",
+                    "User-Agent": "wingman-cli"
+                }
+            });
+            const slug = detail.skill?.slug?.trim() || skillName.trim();
+            const description = detail.skill?.summary?.trim() || detail.skill?.displayName?.trim() || "No description";
+            const nameRegex = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+            if (!nameRegex.test(slug)) throw new Error(`Invalid skill name '${slug}': must be lowercase alphanumeric with hyphens only`);
+            return {
+                name: slug,
+                description,
+                metadata: {
+                    ...detail.latestVersion?.version ? {
+                        version: detail.latestVersion.version
+                    } : {},
+                    ...detail.owner?.handle ? {
+                        owner: detail.owner.handle
+                    } : {}
+                }
+            };
+        } catch (error) {
+            if (error instanceof Error) throw new Error(`Failed to fetch skill metadata for ${skillName}: ${error.message}`);
+            throw error;
+        }
+    }
     parseSkillMetadata(content) {
         const frontmatterRegex = /^---\s*\n([\s\S]*?)\n---/;
         const match = content.match(frontmatterRegex);
@@ -134,6 +167,7 @@ class SkillRepository {
         return metadata;
     }
     async downloadSkill(skillName) {
+        if ("clawhub" === this.provider) return await this.downloadSkillFromClawhub(skillName);
         try {
             const files = new Map();
             await this.downloadDirectory(`skills/${skillName}`, files, skillName);
@@ -143,14 +177,51 @@ class SkillRepository {
             throw error;
         }
     }
+    async downloadSkillFromClawhub(skillName) {
+        try {
+            const detail = await this.fetchJson(`${this.clawhubBaseUrl}/api/v1/skills/${encodeURIComponent(skillName)}`, {
+                headers: {
+                    Accept: "application/json",
+                    "User-Agent": "wingman-cli"
+                }
+            });
+            const slug = detail.skill?.slug || skillName;
+            const version = detail.latestVersion?.version;
+            if (!version) throw new Error("No latest version available");
+            const filesResponse = await this.fetchJson(`${this.clawhubBaseUrl}/api/v1/skills/${encodeURIComponent(slug)}/versions/${encodeURIComponent(version)}`, {
+                headers: {
+                    Accept: "application/json",
+                    "User-Agent": "wingman-cli"
+                }
+            });
+            const files = filesResponse.version?.files || [];
+            const output = new Map();
+            for (const file of files){
+                const fileUrl = new URL(`${this.clawhubBaseUrl}/api/v1/skills/${encodeURIComponent(slug)}/file`);
+                fileUrl.searchParams.set("path", file.path);
+                fileUrl.searchParams.set("version", version);
+                const content = await this.fetchBinary(fileUrl.toString(), {
+                    headers: {
+                        Accept: "text/plain, application/octet-stream",
+                        "User-Agent": "wingman-cli"
+                    }
+                });
+                output.set(file.path, content);
+            }
+            return output;
+        } catch (error) {
+            if (error instanceof Error) throw new Error(`Failed to download skill ${skillName}: ${error.message}`);
+            throw error;
+        }
+    }
     async downloadDirectory(path, files, skillName) {
-        const contents = await this.fetch(`/repos/${this.owner}/${this.repo}/contents/${path}`);
+        const contents = await this.fetchGitHub(`/repos/${this.owner}/${this.repo}/contents/${path}`);
         for (const item of contents)if ("file" === item.type) if (item.content) {
             const content = Buffer.from(item.content, "base64");
             const relativePath = item.path.replace(`skills/${skillName}/`, "");
             files.set(relativePath, content);
         } else {
-            const fileData = await this.fetch(item.url.replace(this.baseUrl, ""));
+            const fileData = await this.fetchGitHub(item.url.replace(this.githubBaseUrl, ""));
             if (fileData.content && "base64" === fileData.encoding) {
                 const content = Buffer.from(fileData.content, "base64");
                 const relativePath = item.path.replace(`skills/${skillName}/`, "");
@@ -159,14 +230,61 @@ class SkillRepository {
         }
         else if ("dir" === item.type) await this.downloadDirectory(item.path, files, skillName);
     }
+    async listSkillsFromClawhub() {
+        const allSkills = [];
+        let cursor = null;
+        do {
+            const url = new URL(`${this.clawhubBaseUrl}/api/v1/skills`);
+            url.searchParams.set("sort", "downloads");
+            url.searchParams.set("limit", "100");
+            if (cursor) url.searchParams.set("cursor", cursor);
+            const response = await this.fetchJson(url.toString(), {
+                headers: {
+                    Accept: "application/json",
+                    "User-Agent": "wingman-cli"
+                }
+            });
+            for (const item of response.items || [])allSkills.push({
+                name: item.slug,
+                description: item.summary?.trim() || item.displayName?.trim() || "No description",
+                path: item.slug,
+                metadata: {
+                    name: item.slug,
+                    description: item.summary?.trim() || item.displayName?.trim() || "No description"
+                }
+            });
+            cursor = response.nextCursor || null;
+        }while (cursor);
+        return allSkills;
+    }
+    async listSkillsFromGitHub() {
+        const contents = await this.fetchGitHub(`/repos/${this.owner}/${this.repo}/contents/skills`);
+        const skills = [];
+        for (const item of contents)if ("dir" === item.type) try {
+            const metadata = await this.getSkillMetadata(item.name);
+            skills.push({
+                name: item.name,
+                description: metadata.description || "No description",
+                path: item.path,
+                metadata
+            });
+        } catch (error) {
+            logger.warn(`Could not read skill ${item.name}`, error instanceof Error ? error.message : String(error));
+        }
+        return skills;
+    }
     constructor(options = {}){
-        _define_property(this, "baseUrl", "https://api.github.com");
+        _define_property(this, "githubBaseUrl", "https://api.github.com");
         _define_property(this, "owner", void 0);
         _define_property(this, "repo", void 0);
         _define_property(this, "token", void 0);
+        _define_property(this, "provider", void 0);
+        _define_property(this, "clawhubBaseUrl", void 0);
+        this.provider = options.provider || "github";
         this.owner = options.repositoryOwner || "anthropics";
         this.repo = options.repositoryName || "skills";
         this.token = options.githubToken || process.env.GITHUB_TOKEN || void 0;
+        this.clawhubBaseUrl = (options.clawhubBaseUrl || "https://clawhub.ai").replace(/\/+$/, "");
     }
 }
 exports.SkillRepository = __webpack_exports__.SkillRepository;

package/dist/cli/services/skillRepository.d.ts

@@ -3,23 +3,28 @@ import type { SkillInfo, SkillMetadata, SkillRepositoryOptions } from "../types/
  * GitHub API client for interacting with the skills repository
  */
 export declare class SkillRepository {
-    private readonly baseUrl;
+    private readonly githubBaseUrl;
     private readonly owner;
     private readonly repo;
     private readonly token?;
+    private readonly provider;
+    private readonly clawhubBaseUrl;
     constructor(options?: SkillRepositoryOptions);
     /**
      * Fetch data from GitHub API
      */
-    private fetch;
+    private fetchGitHub;
     /**
      * List available skills from the repository
      */
     listAvailableSkills(): Promise<SkillInfo[]>;
+    private fetchJson;
+    private fetchBinary;
     /**
      * Get skill metadata by fetching and parsing SKILL.md
      */
     getSkillMetadata(skillName: string): Promise<SkillMetadata>;
+    private getClawhubSkillMetadata;
     /**
      * Parse SKILL.md content to extract YAML frontmatter
      */
@@ -28,8 +33,11 @@ export declare class SkillRepository {
      * Download all files for a skill
      */
     downloadSkill(skillName: string): Promise<Map<string, string | Buffer>>;
+    private downloadSkillFromClawhub;
     /**
      * Recursively download all files in a directory
      */
     private downloadDirectory;
+    private listSkillsFromClawhub;
+    private listSkillsFromGitHub;
 }

package/dist/cli/services/skillRepository.js

@@ -11,8 +11,8 @@ function _define_property(obj, key, value) {
 }
 const logger = createLogger();
 class SkillRepository {
-    async fetch(path) {
-        const url = `${this.baseUrl}${path}`;
+    async fetchGitHub(path) {
+        const url = `${this.githubBaseUrl}${path}`;
         const headers = {
             Accept: "application/vnd.github.v3+json",
             "User-Agent": "wingman-cli"
@@ -34,29 +34,33 @@ class SkillRepository {
     }
     async listAvailableSkills() {
         try {
-            const contents = await this.fetch(`/repos/${this.owner}/${this.repo}/contents/skills`);
-            const skills = [];
-            for (const item of contents)if ("dir" === item.type) try {
-                const metadata = await this.getSkillMetadata(item.name);
-                skills.push({
-                    name: item.name,
-                    description: metadata.description || "No description",
-                    path: item.path,
-                    metadata
-                });
-            } catch (error) {
-                logger.warn(`Could not read skill ${item.name}`, error instanceof Error ? error.message : String(error));
-            }
-            return skills;
+            if ("clawhub" === this.provider) return await this.listSkillsFromClawhub();
+            return await this.listSkillsFromGitHub();
         } catch (error) {
             if (error instanceof Error) throw new Error(`Failed to list skills: ${error.message}`);
             throw error;
         }
     }
+    async fetchJson(url, options) {
+        const response = await fetch(url, {
+            headers: options?.headers
+        });
+        if (!response.ok) throw new Error(`HTTP ${response.status} ${response.statusText}`);
+        return await response.json();
+    }
+    async fetchBinary(url, options) {
+        const response = await fetch(url, {
+            headers: options?.headers
+        });
+        if (!response.ok) throw new Error(`HTTP ${response.status} ${response.statusText}`);
+        const arrayBuffer = await response.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    }
     async getSkillMetadata(skillName) {
+        if ("clawhub" === this.provider) return await this.getClawhubSkillMetadata(skillName);
         try {
             const skillMdPath = `/repos/${this.owner}/${this.repo}/contents/skills/${skillName}/SKILL.md`;
-            const skillMd = await this.fetch(skillMdPath);
+            const skillMd = await this.fetchGitHub(skillMdPath);
             if ("file" !== skillMd.type || !skillMd.content) throw new Error("SKILL.md not found or invalid");
             const content = Buffer.from(skillMd.content, "base64").toString("utf-8");
             const metadata = this.parseSkillMetadata(content);
@@ -66,6 +70,35 @@ class SkillRepository {
             throw error;
         }
     }
+    async getClawhubSkillMetadata(skillName) {
+        try {
+            const detail = await this.fetchJson(`${this.clawhubBaseUrl}/api/v1/skills/${encodeURIComponent(skillName)}`, {
+                headers: {
+                    Accept: "application/json",
+                    "User-Agent": "wingman-cli"
+                }
+            });
+            const slug = detail.skill?.slug?.trim() || skillName.trim();
+            const description = detail.skill?.summary?.trim() || detail.skill?.displayName?.trim() || "No description";
+            const nameRegex = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+            if (!nameRegex.test(slug)) throw new Error(`Invalid skill name '${slug}': must be lowercase alphanumeric with hyphens only`);
+            return {
+                name: slug,
+                description,
+                metadata: {
+                    ...detail.latestVersion?.version ? {
+                        version: detail.latestVersion.version
+                    } : {},
+                    ...detail.owner?.handle ? {
+                        owner: detail.owner.handle
+                    } : {}
+                }
+            };
+        } catch (error) {
+            if (error instanceof Error) throw new Error(`Failed to fetch skill metadata for ${skillName}: ${error.message}`);
+            throw error;
+        }
+    }
     parseSkillMetadata(content) {
         const frontmatterRegex = /^---\s*\n([\s\S]*?)\n---/;
         const match = content.match(frontmatterRegex);
@@ -106,6 +139,7 @@ class SkillRepository {
         return metadata;
     }
     async downloadSkill(skillName) {
+        if ("clawhub" === this.provider) return await this.downloadSkillFromClawhub(skillName);
         try {
             const files = new Map();
             await this.downloadDirectory(`skills/${skillName}`, files, skillName);
@@ -115,14 +149,51 @@ class SkillRepository {
             throw error;
         }
     }
+    async downloadSkillFromClawhub(skillName) {
+        try {
+            const detail = await this.fetchJson(`${this.clawhubBaseUrl}/api/v1/skills/${encodeURIComponent(skillName)}`, {
+                headers: {
+                    Accept: "application/json",
+                    "User-Agent": "wingman-cli"
+                }
+            });
+            const slug = detail.skill?.slug || skillName;
+            const version = detail.latestVersion?.version;
+            if (!version) throw new Error("No latest version available");
+            const filesResponse = await this.fetchJson(`${this.clawhubBaseUrl}/api/v1/skills/${encodeURIComponent(slug)}/versions/${encodeURIComponent(version)}`, {
+                headers: {
+                    Accept: "application/json",
+                    "User-Agent": "wingman-cli"
+                }
+            });
+            const files = filesResponse.version?.files || [];
+            const output = new Map();
+            for (const file of files){
+                const fileUrl = new URL(`${this.clawhubBaseUrl}/api/v1/skills/${encodeURIComponent(slug)}/file`);
+                fileUrl.searchParams.set("path", file.path);
+                fileUrl.searchParams.set("version", version);
+                const content = await this.fetchBinary(fileUrl.toString(), {
+                    headers: {
+                        Accept: "text/plain, application/octet-stream",
+                        "User-Agent": "wingman-cli"
+                    }
+                });
+                output.set(file.path, content);
+            }
+            return output;
+        } catch (error) {
+            if (error instanceof Error) throw new Error(`Failed to download skill ${skillName}: ${error.message}`);
+            throw error;
+        }
+    }
     async downloadDirectory(path, files, skillName) {
-        const contents = await this.fetch(`/repos/${this.owner}/${this.repo}/contents/${path}`);
+        const contents = await this.fetchGitHub(`/repos/${this.owner}/${this.repo}/contents/${path}`);
         for (const item of contents)if ("file" === item.type) if (item.content) {
             const content = Buffer.from(item.content, "base64");
             const relativePath = item.path.replace(`skills/${skillName}/`, "");
             files.set(relativePath, content);
         } else {
-            const fileData = await this.fetch(item.url.replace(this.baseUrl, ""));
+            const fileData = await this.fetchGitHub(item.url.replace(this.githubBaseUrl, ""));
             if (fileData.content && "base64" === fileData.encoding) {
                 const content = Buffer.from(fileData.content, "base64");
                 const relativePath = item.path.replace(`skills/${skillName}/`, "");
@@ -131,14 +202,61 @@ class SkillRepository {
         }
         else if ("dir" === item.type) await this.downloadDirectory(item.path, files, skillName);
     }
+    async listSkillsFromClawhub() {
+        const allSkills = [];
+        let cursor = null;
+        do {
+            const url = new URL(`${this.clawhubBaseUrl}/api/v1/skills`);
+            url.searchParams.set("sort", "downloads");
+            url.searchParams.set("limit", "100");
+            if (cursor) url.searchParams.set("cursor", cursor);
+            const response = await this.fetchJson(url.toString(), {
+                headers: {
+                    Accept: "application/json",
+                    "User-Agent": "wingman-cli"
+                }
+            });
+            for (const item of response.items || [])allSkills.push({
+                name: item.slug,
+                description: item.summary?.trim() || item.displayName?.trim() || "No description",
+                path: item.slug,
+                metadata: {
+                    name: item.slug,
+                    description: item.summary?.trim() || item.displayName?.trim() || "No description"
+                }
+            });
+            cursor = response.nextCursor || null;
+        }while (cursor);
+        return allSkills;
+    }
+    async listSkillsFromGitHub() {
+        const contents = await this.fetchGitHub(`/repos/${this.owner}/${this.repo}/contents/skills`);
+        const skills = [];
+        for (const item of contents)if ("dir" === item.type) try {
+            const metadata = await this.getSkillMetadata(item.name);
+            skills.push({
+                name: item.name,
+                description: metadata.description || "No description",
+                path: item.path,
+                metadata
+            });
+        } catch (error) {
+            logger.warn(`Could not read skill ${item.name}`, error instanceof Error ? error.message : String(error));
+        }
+        return skills;
+    }
     constructor(options = {}){
-        _define_property(this, "baseUrl", "https://api.github.com");
+        _define_property(this, "githubBaseUrl", "https://api.github.com");
         _define_property(this, "owner", void 0);
         _define_property(this, "repo", void 0);
         _define_property(this, "token", void 0);
+        _define_property(this, "provider", void 0);
+        _define_property(this, "clawhubBaseUrl", void 0);
+        this.provider = options.provider || "github";
         this.owner = options.repositoryOwner || "anthropics";
         this.repo = options.repositoryName || "skills";
         this.token = options.githubToken || process.env.GITHUB_TOKEN || void 0;
+        this.clawhubBaseUrl = (options.clawhubBaseUrl || "https://clawhub.ai").replace(/\/+$/, "");
     }
 }
 export { SkillRepository };