@stackmemoryai/stackmemory 0.5.4 → 0.5.5

package/dist/skills/api-skill.js

@@ -0,0 +1,471 @@
+import { execSync } from "child_process";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import { logger } from "../core/monitoring/logger.js";
+class APISkill {
+  registryPath;
+  restishConfigPath;
+  registry;
+  constructor() {
+    this.registryPath = path.join(
+      os.homedir(),
+      ".stackmemory",
+      "api-registry.json"
+    );
+    this.restishConfigPath = process.platform === "darwin" ? path.join(
+      os.homedir(),
+      "Library",
+      "Application Support",
+      "restish",
+      "apis.json"
+    ) : path.join(os.homedir(), ".config", "restish", "apis.json");
+    this.registry = this.loadRegistry();
+  }
+  loadRegistry() {
+    try {
+      if (fs.existsSync(this.registryPath)) {
+        return JSON.parse(fs.readFileSync(this.registryPath, "utf-8"));
+      }
+    } catch (error) {
+      logger.warn("Failed to load API registry:", error);
+    }
+    return { apis: {}, version: "1.0.0" };
+  }
+  saveRegistry() {
+    const dir = path.dirname(this.registryPath);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(this.registryPath, JSON.stringify(this.registry, null, 2));
+  }
+  /**
+   * Load restish config
+   */
+  loadRestishConfig() {
+    try {
+      if (fs.existsSync(this.restishConfigPath)) {
+        return JSON.parse(fs.readFileSync(this.restishConfigPath, "utf-8"));
+      }
+    } catch (error) {
+      logger.warn("Failed to load restish config:", error);
+    }
+    return {};
+  }
+  /**
+   * Save restish config
+   */
+  saveRestishConfig(config) {
+    const dir = path.dirname(this.restishConfigPath);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(this.restishConfigPath, JSON.stringify(config, null, 2));
+  }
+  /**
+   * Check if restish is installed
+   */
+  checkRestish() {
+    try {
+      execSync("which restish", { stdio: "pipe" });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Add/register a new API
+   */
+  async add(name, baseUrl, options) {
+    if (!this.checkRestish()) {
+      return {
+        success: false,
+        message: "restish not installed. Run: brew install restish"
+      };
+    }
+    try {
+      const restishConfig = this.loadRestishConfig();
+      const apiConfig = {
+        base: baseUrl
+      };
+      if (options?.spec) {
+        apiConfig.spec_files = [options.spec];
+      }
+      if (options?.authType === "api-key" && options?.envVar) {
+        apiConfig.profiles = {
+          default: {
+            headers: {
+              [options.headerName || "Authorization"]: `$${options.envVar}`
+            }
+          }
+        };
+      }
+      restishConfig[name] = apiConfig;
+      this.saveRestishConfig(restishConfig);
+      const config = {
+        name,
+        baseUrl,
+        specUrl: options?.spec,
+        authType: options?.authType || "none",
+        authConfig: {
+          headerName: options?.headerName || "Authorization",
+          envVar: options?.envVar
+        },
+        registeredAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      if (options?.spec) {
+        config.specUrl = options.spec;
+      }
+      this.registry.apis[name] = config;
+      this.saveRegistry();
+      return {
+        success: true,
+        message: `API '${name}' registered successfully`,
+        data: {
+          name,
+          baseUrl,
+          authType: config.authType,
+          operations: config.operations?.length || "auto-discovered"
+        }
+      };
+    } catch (error) {
+      logger.error("Failed to add API:", error);
+      return {
+        success: false,
+        message: `Failed to register API: ${error.message}`
+      };
+    }
+  }
+  /**
+   * Discover available operations for an API
+   */
+  discoverOperations(apiName) {
+    try {
+      const output = execSync(`restish ${apiName} --help 2>&1`, {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      const operations = [];
+      const lines = output.split("\n");
+      let inCommands = false;
+      for (const line of lines) {
+        if (line.includes("Available Commands:")) {
+          inCommands = true;
+          continue;
+        }
+        if (inCommands && line.trim()) {
+          const match = line.match(/^\s+(\S+)/);
+          if (match && !line.includes("help")) {
+            operations.push(match[1]);
+          }
+        }
+        if (inCommands && line.includes("Flags:")) {
+          break;
+        }
+      }
+      return operations;
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * List registered APIs
+   */
+  async list() {
+    const apis = Object.values(this.registry.apis);
+    if (apis.length === 0) {
+      return {
+        success: true,
+        message: "No APIs registered. Use /api add <name> <url> to register one.",
+        data: []
+      };
+    }
+    return {
+      success: true,
+      message: `${apis.length} API(s) registered`,
+      data: apis.map((api) => ({
+        name: api.name,
+        baseUrl: api.baseUrl,
+        authType: api.authType,
+        operations: api.operations?.length || "unknown",
+        registeredAt: api.registeredAt
+      }))
+    };
+  }
+  /**
+   * Show details for a specific API
+   */
+  async describe(apiName, operation) {
+    const api = this.registry.apis[apiName];
+    if (!api) {
+      try {
+        const output = execSync(`restish api show ${apiName}`, {
+          encoding: "utf-8",
+          stdio: ["pipe", "pipe", "pipe"]
+        });
+        return {
+          success: true,
+          message: `API '${apiName}' (from restish config)`,
+          data: { raw: output }
+        };
+      } catch {
+        return {
+          success: false,
+          message: `API '${apiName}' not found`
+        };
+      }
+    }
+    if (operation) {
+      try {
+        const output = execSync(`restish ${apiName} ${operation} --help`, {
+          encoding: "utf-8",
+          stdio: ["pipe", "pipe", "pipe"]
+        });
+        return {
+          success: true,
+          message: `Operation: ${apiName}.${operation}`,
+          data: {
+            operation,
+            help: output
+          }
+        };
+      } catch {
+        return {
+          success: false,
+          message: `Operation '${operation}' not found for API '${apiName}'`
+        };
+      }
+    }
+    const operations = this.discoverOperations(apiName);
+    api.operations = operations;
+    this.saveRegistry();
+    return {
+      success: true,
+      message: `API: ${apiName}`,
+      data: {
+        ...api,
+        operations
+      }
+    };
+  }
+  /**
+   * Execute an API operation
+   */
+  async exec(apiName, operation, params, options) {
+    if (!this.checkRestish()) {
+      return {
+        success: false,
+        message: "restish not installed. Run: brew install restish"
+      };
+    }
+    const api = this.registry.apis[apiName];
+    if (!api) {
+      return {
+        success: false,
+        message: `API '${apiName}' not registered. Use /api add first.`
+      };
+    }
+    const urlPath = operation.startsWith("/") ? operation : `/${operation}`;
+    const fullUrl = `${api.baseUrl}${urlPath}`;
+    const args = ["get", fullUrl];
+    if (options?.raw) {
+      args.push("--rsh-raw");
+    }
+    if (options?.filter) {
+      args.push("--rsh-filter", options.filter);
+    }
+    if (api?.authConfig?.envVar) {
+      const token = process.env[api.authConfig.envVar];
+      if (token) {
+        const headerName = api.authConfig.headerName || "Authorization";
+        args.push("-H", `${headerName}:${token}`);
+      }
+    }
+    if (options?.headers) {
+      for (const [key, value] of Object.entries(options.headers)) {
+        args.push("-H", `${key}:${value}`);
+      }
+    }
+    if (params) {
+      for (const [key, value] of Object.entries(params)) {
+        args.push("-q", `${key}=${String(value)}`);
+      }
+    }
+    args.push("-o", "json");
+    try {
+      logger.info(`Executing: restish ${args.join(" ")}`);
+      const output = execSync(`restish ${args.join(" ")}`, {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"],
+        env: process.env
+      });
+      let data;
+      try {
+        data = JSON.parse(output);
+      } catch {
+        data = output;
+      }
+      return {
+        success: true,
+        message: `${apiName} ${operation} executed`,
+        data
+      };
+    } catch (error) {
+      const stderr = error.stderr?.toString() || error.message;
+      logger.error(`API exec failed:`, stderr);
+      return {
+        success: false,
+        message: `API call failed: ${stderr}`
+      };
+    }
+  }
+  /**
+   * Configure authentication for an API
+   */
+  async auth(apiName, options) {
+    const api = this.registry.apis[apiName];
+    if (!api) {
+      return {
+        success: false,
+        message: `API '${apiName}' not registered. Use /api add first.`
+      };
+    }
+    if (options.token) {
+      const envVar = options.envVar || `${apiName.toUpperCase()}_API_KEY`;
+      process.env[envVar] = options.token;
+      api.authType = "api-key";
+      api.authConfig = {
+        ...api.authConfig,
+        envVar
+      };
+      this.saveRegistry();
+      return {
+        success: true,
+        message: `Auth configured for '${apiName}'. Token stored in ${envVar}`,
+        data: { envVar }
+      };
+    }
+    if (options.oauth) {
+      try {
+        const scopeArg = options.scopes ? `--scopes=${options.scopes.join(",")}` : "";
+        execSync(`restish api configure ${apiName} --auth=oauth2 ${scopeArg}`, {
+          stdio: "inherit"
+        });
+        api.authType = "oauth2";
+        this.saveRegistry();
+        return {
+          success: true,
+          message: `OAuth2 configured for '${apiName}'`
+        };
+      } catch (error) {
+        return {
+          success: false,
+          message: `OAuth setup failed: ${error.message}`
+        };
+      }
+    }
+    return {
+      success: false,
+      message: "Specify --token or --oauth"
+    };
+  }
+  /**
+   * Remove an API
+   */
+  async remove(apiName) {
+    if (!this.registry.apis[apiName]) {
+      return {
+        success: false,
+        message: `API '${apiName}' not found`
+      };
+    }
+    delete this.registry.apis[apiName];
+    this.saveRegistry();
+    return {
+      success: true,
+      message: `API '${apiName}' removed`
+    };
+  }
+  /**
+   * Sync API spec (refresh operations)
+   */
+  async sync(apiName) {
+    if (!this.checkRestish()) {
+      return {
+        success: false,
+        message: "restish not installed. Run: brew install restish"
+      };
+    }
+    try {
+      execSync(`restish api sync ${apiName}`, { stdio: "pipe" });
+      const operations = this.discoverOperations(apiName);
+      if (this.registry.apis[apiName]) {
+        this.registry.apis[apiName].operations = operations;
+        this.saveRegistry();
+      }
+      return {
+        success: true,
+        message: `API '${apiName}' synced`,
+        data: { operations }
+      };
+    } catch (error) {
+      return {
+        success: false,
+        message: `Sync failed: ${error.message}`
+      };
+    }
+  }
+  /**
+   * Get help for the API skill
+   */
+  getHelp() {
+    return `
+/api - OpenAPI-based API access via Restish
+
+Commands:
+  /api add <name> <url> [--spec <url>] [--auth-type api-key|oauth2]
+      Register a new API
+
+  /api list
+      List all registered APIs
+
+  /api describe <name> [operation]
+      Show API details or specific operation
+
+  /api exec <name> <operation> [--param value...]
+      Execute an API operation
+
+  /api auth <name> --token <token> [--env-var NAME]
+      Configure API authentication
+
+  /api auth <name> --oauth [--scopes scope1,scope2]
+      Configure OAuth2 authentication
+
+  /api sync <name>
+      Refresh API operations from spec
+
+  /api remove <name>
+      Remove a registered API
+
+Examples:
+  /api add github https://api.github.com --spec https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json
+  /api auth github --token "$GITHUB_TOKEN"
+  /api exec github repos list-for-user --username octocat
+  /api exec github issues list --owner microsoft --repo vscode --state open
+
+Built on restish (https://rest.sh) for automatic OpenAPI discovery.
+`;
+  }
+}
+let apiSkillInstance = null;
+function getAPISkill() {
+  if (!apiSkillInstance) {
+    apiSkillInstance = new APISkill();
+  }
+  return apiSkillInstance;
+}
+export {
+  APISkill,
+  getAPISkill
+};
+//# sourceMappingURL=api-skill.js.map

package/dist/skills/api-skill.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/skills/api-skill.ts"],
+  "sourcesContent": ["/**\n * API Skill - OpenAPI-based API access via Restish\n *\n * Wraps the restish CLI to provide zero-code API integration\n * based on OpenAPI specifications.\n */\n\nimport { execSync } from 'child_process';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport { logger } from '../core/monitoring/logger.js';\nimport type { SkillResult } from './claude-skills.js';\n\nexport interface APIConfig {\n  name: string;\n  baseUrl: string;\n  specUrl?: string;\n  authType: 'none' | 'api-key' | 'oauth2' | 'basic';\n  authConfig?: {\n    headerName?: string;\n    queryParam?: string;\n    envVar?: string;\n  };\n  registeredAt: string;\n  operations?: string[];\n}\n\nexport interface APIRegistry {\n  apis: Record<string, APIConfig>;\n  version: string;\n}\n\nexport class APISkill {\n  private registryPath: string;\n  private restishConfigPath: string;\n  private registry: APIRegistry;\n\n  constructor() {\n    this.registryPath = path.join(\n      os.homedir(),\n      '.stackmemory',\n      'api-registry.json'\n    );\n    // Platform-specific restish config path\n    // Mac: ~/Library/Application Support/restish/apis.json\n    // Linux: ~/.config/restish/apis.json\n    // Windows: %AppData%/restish/apis.json\n    this.restishConfigPath =\n      process.platform === 'darwin'\n        ? path.join(\n            os.homedir(),\n            'Library',\n            'Application Support',\n            'restish',\n            'apis.json'\n          )\n        : path.join(os.homedir(), '.config', 'restish', 'apis.json');\n    this.registry = this.loadRegistry();\n  }\n\n  private loadRegistry(): APIRegistry {\n    try {\n      if (fs.existsSync(this.registryPath)) {\n        return JSON.parse(fs.readFileSync(this.registryPath, 'utf-8'));\n      }\n    } catch (error) {\n      logger.warn('Failed to load API registry:', error);\n    }\n    return { apis: {}, version: '1.0.0' };\n  }\n\n  private saveRegistry(): void {\n    const dir = path.dirname(this.registryPath);\n    if (!fs.existsSync(dir)) {\n      fs.mkdirSync(dir, { recursive: true });\n    }\n    fs.writeFileSync(this.registryPath, JSON.stringify(this.registry, null, 2));\n  }\n\n  /**\n   * Load restish config\n   */\n  private loadRestishConfig(): Record<string, unknown> {\n    try {\n      if (fs.existsSync(this.restishConfigPath)) {\n        return JSON.parse(fs.readFileSync(this.restishConfigPath, 'utf-8'));\n      }\n    } catch (error) {\n      logger.warn('Failed to load restish config:', error);\n    }\n    return {};\n  }\n\n  /**\n   * Save restish config\n   */\n  private saveRestishConfig(config: Record<string, unknown>): void {\n    const dir = path.dirname(this.restishConfigPath);\n    if (!fs.existsSync(dir)) {\n      fs.mkdirSync(dir, { recursive: true });\n    }\n    fs.writeFileSync(this.restishConfigPath, JSON.stringify(config, null, 2));\n  }\n\n  /**\n   * Check if restish is installed\n   */\n  private checkRestish(): boolean {\n    try {\n      execSync('which restish', { stdio: 'pipe' });\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Add/register a new API\n   */\n  async add(\n    name: string,\n    baseUrl: string,\n    options?: {\n      spec?: string;\n      authType?: 'none' | 'api-key' | 'oauth2' | 'basic';\n      headerName?: string;\n      envVar?: string;\n    }\n  ): Promise<SkillResult> {\n    if (!this.checkRestish()) {\n      return {\n        success: false,\n        message: 'restish not installed. Run: brew install restish',\n      };\n    }\n\n    try {\n      // Configure restish for this API by writing directly to config\n      const restishConfig = this.loadRestishConfig();\n\n      // Build restish API config\n      const apiConfig: Record<string, unknown> = {\n        base: baseUrl,\n      };\n\n      // Add spec URL if provided for auto-discovery\n      if (options?.spec) {\n        apiConfig.spec_files = [options.spec];\n      }\n\n      // Add auth config based on type\n      if (options?.authType === 'api-key' && options?.envVar) {\n        apiConfig.profiles = {\n          default: {\n            headers: {\n              [options.headerName || 'Authorization']: `$${options.envVar}`,\n            },\n          },\n        };\n      }\n\n      restishConfig[name] = apiConfig;\n      this.saveRestishConfig(restishConfig);\n\n      // Store in our registry\n      const config: APIConfig = {\n        name,\n        baseUrl,\n        specUrl: options?.spec,\n        authType: options?.authType || 'none',\n        authConfig: {\n          headerName: options?.headerName || 'Authorization',\n          envVar: options?.envVar,\n        },\n        registeredAt: new Date().toISOString(),\n      };\n\n      // Skip sync during add - it can be slow due to network requests\n      // Users can manually sync with: stackmemory api sync <name>\n      if (options?.spec) {\n        config.specUrl = options.spec;\n      }\n\n      this.registry.apis[name] = config;\n      this.saveRegistry();\n\n      return {\n        success: true,\n        message: `API '${name}' registered successfully`,\n        data: {\n          name,\n          baseUrl,\n          authType: config.authType,\n          operations: config.operations?.length || 'auto-discovered',\n        },\n      };\n    } catch (error) {\n      logger.error('Failed to add API:', error);\n      return {\n        success: false,\n        message: `Failed to register API: ${error.message}`,\n      };\n    }\n  }\n\n  /**\n   * Discover available operations for an API\n   */\n  private discoverOperations(apiName: string): string[] {\n    try {\n      const output = execSync(`restish ${apiName} --help 2>&1`, {\n        encoding: 'utf-8',\n        stdio: ['pipe', 'pipe', 'pipe'],\n      });\n\n      // Parse operations from help output\n      const operations: string[] = [];\n      const lines = output.split('\\n');\n      let inCommands = false;\n\n      for (const line of lines) {\n        if (line.includes('Available Commands:')) {\n          inCommands = true;\n          continue;\n        }\n        if (inCommands && line.trim()) {\n          const match = line.match(/^\\s+(\\S+)/);\n          if (match && !line.includes('help')) {\n            operations.push(match[1]);\n          }\n        }\n        if (inCommands && line.includes('Flags:')) {\n          break;\n        }\n      }\n\n      return operations;\n    } catch {\n      return [];\n    }\n  }\n\n  /**\n   * List registered APIs\n   */\n  async list(): Promise<SkillResult> {\n    const apis = Object.values(this.registry.apis);\n\n    if (apis.length === 0) {\n      return {\n        success: true,\n        message:\n          'No APIs registered. Use /api add <name> <url> to register one.',\n        data: [],\n      };\n    }\n\n    return {\n      success: true,\n      message: `${apis.length} API(s) registered`,\n      data: apis.map((api) => ({\n        name: api.name,\n        baseUrl: api.baseUrl,\n        authType: api.authType,\n        operations: api.operations?.length || 'unknown',\n        registeredAt: api.registeredAt,\n      })),\n    };\n  }\n\n  /**\n   * Show details for a specific API\n   */\n  async describe(apiName: string, operation?: string): Promise<SkillResult> {\n    const api = this.registry.apis[apiName];\n\n    if (!api) {\n      // Try to get info directly from restish\n      try {\n        const output = execSync(`restish api show ${apiName}`, {\n          encoding: 'utf-8',\n          stdio: ['pipe', 'pipe', 'pipe'],\n        });\n\n        return {\n          success: true,\n          message: `API '${apiName}' (from restish config)`,\n          data: { raw: output },\n        };\n      } catch {\n        return {\n          success: false,\n          message: `API '${apiName}' not found`,\n        };\n      }\n    }\n\n    if (operation) {\n      // Get specific operation details\n      try {\n        const output = execSync(`restish ${apiName} ${operation} --help`, {\n          encoding: 'utf-8',\n          stdio: ['pipe', 'pipe', 'pipe'],\n        });\n\n        return {\n          success: true,\n          message: `Operation: ${apiName}.${operation}`,\n          data: {\n            operation,\n            help: output,\n          },\n        };\n      } catch {\n        return {\n          success: false,\n          message: `Operation '${operation}' not found for API '${apiName}'`,\n        };\n      }\n    }\n\n    // Get all operations\n    const operations = this.discoverOperations(apiName);\n    api.operations = operations;\n    this.saveRegistry();\n\n    return {\n      success: true,\n      message: `API: ${apiName}`,\n      data: {\n        ...api,\n        operations,\n      },\n    };\n  }\n\n  /**\n   * Execute an API operation\n   */\n  async exec(\n    apiName: string,\n    operation: string,\n    params?: Record<string, unknown>,\n    options?: {\n      raw?: boolean;\n      filter?: string;\n      headers?: Record<string, string>;\n    }\n  ): Promise<SkillResult> {\n    if (!this.checkRestish()) {\n      return {\n        success: false,\n        message: 'restish not installed. Run: brew install restish',\n      };\n    }\n\n    const api = this.registry.apis[apiName];\n    if (!api) {\n      return {\n        success: false,\n        message: `API '${apiName}' not registered. Use /api add first.`,\n      };\n    }\n\n    // Build the URL path from operation\n    // e.g., \"repos/owner/repo\" or \"/repos/owner/repo\"\n    const urlPath = operation.startsWith('/') ? operation : `/${operation}`;\n    const fullUrl = `${api.baseUrl}${urlPath}`;\n\n    // Build command using direct URL (more reliable than API names)\n    const args: string[] = ['get', fullUrl];\n\n    // Add options\n    if (options?.raw) {\n      args.push('--rsh-raw');\n    }\n    if (options?.filter) {\n      args.push('--rsh-filter', options.filter);\n    }\n\n    // Add headers (including auth)\n    if (api?.authConfig?.envVar) {\n      const token = process.env[api.authConfig.envVar];\n      if (token) {\n        const headerName = api.authConfig.headerName || 'Authorization';\n        args.push('-H', `${headerName}:${token}`);\n      }\n    }\n\n    if (options?.headers) {\n      for (const [key, value] of Object.entries(options.headers)) {\n        args.push('-H', `${key}:${value}`);\n      }\n    }\n\n    // Add query parameters\n    if (params) {\n      for (const [key, value] of Object.entries(params)) {\n        args.push('-q', `${key}=${String(value)}`);\n      }\n    }\n\n    // Output as JSON\n    args.push('-o', 'json');\n\n    try {\n      logger.info(`Executing: restish ${args.join(' ')}`);\n\n      const output = execSync(`restish ${args.join(' ')}`, {\n        encoding: 'utf-8',\n        stdio: ['pipe', 'pipe', 'pipe'],\n        env: process.env,\n      });\n\n      // Try to parse as JSON\n      let data: unknown;\n      try {\n        data = JSON.parse(output);\n      } catch {\n        data = output;\n      }\n\n      return {\n        success: true,\n        message: `${apiName} ${operation} executed`,\n        data,\n      };\n    } catch (error) {\n      const stderr = error.stderr?.toString() || error.message;\n      logger.error(`API exec failed:`, stderr);\n\n      return {\n        success: false,\n        message: `API call failed: ${stderr}`,\n      };\n    }\n  }\n\n  /**\n   * Configure authentication for an API\n   */\n  async auth(\n    apiName: string,\n    options: {\n      token?: string;\n      envVar?: string;\n      oauth?: boolean;\n      scopes?: string[];\n    }\n  ): Promise<SkillResult> {\n    const api = this.registry.apis[apiName];\n\n    if (!api) {\n      return {\n        success: false,\n        message: `API '${apiName}' not registered. Use /api add first.`,\n      };\n    }\n\n    if (options.token) {\n      // Store token in env var (don't save to disk for security)\n      const envVar = options.envVar || `${apiName.toUpperCase()}_API_KEY`;\n      process.env[envVar] = options.token;\n\n      api.authType = 'api-key';\n      api.authConfig = {\n        ...api.authConfig,\n        envVar,\n      };\n      this.saveRegistry();\n\n      return {\n        success: true,\n        message: `Auth configured for '${apiName}'. Token stored in ${envVar}`,\n        data: { envVar },\n      };\n    }\n\n    if (options.oauth) {\n      // Use restish's OAuth flow\n      try {\n        const scopeArg = options.scopes\n          ? `--scopes=${options.scopes.join(',')}`\n          : '';\n        execSync(`restish api configure ${apiName} --auth=oauth2 ${scopeArg}`, {\n          stdio: 'inherit',\n        });\n\n        api.authType = 'oauth2';\n        this.saveRegistry();\n\n        return {\n          success: true,\n          message: `OAuth2 configured for '${apiName}'`,\n        };\n      } catch (error) {\n        return {\n          success: false,\n          message: `OAuth setup failed: ${error.message}`,\n        };\n      }\n    }\n\n    return {\n      success: false,\n      message: 'Specify --token or --oauth',\n    };\n  }\n\n  /**\n   * Remove an API\n   */\n  async remove(apiName: string): Promise<SkillResult> {\n    if (!this.registry.apis[apiName]) {\n      return {\n        success: false,\n        message: `API '${apiName}' not found`,\n      };\n    }\n\n    delete this.registry.apis[apiName];\n    this.saveRegistry();\n\n    return {\n      success: true,\n      message: `API '${apiName}' removed`,\n    };\n  }\n\n  /**\n   * Sync API spec (refresh operations)\n   */\n  async sync(apiName: string): Promise<SkillResult> {\n    if (!this.checkRestish()) {\n      return {\n        success: false,\n        message: 'restish not installed. Run: brew install restish',\n      };\n    }\n\n    try {\n      execSync(`restish api sync ${apiName}`, { stdio: 'pipe' });\n\n      const operations = this.discoverOperations(apiName);\n\n      if (this.registry.apis[apiName]) {\n        this.registry.apis[apiName].operations = operations;\n        this.saveRegistry();\n      }\n\n      return {\n        success: true,\n        message: `API '${apiName}' synced`,\n        data: { operations },\n      };\n    } catch (error) {\n      return {\n        success: false,\n        message: `Sync failed: ${error.message}`,\n      };\n    }\n  }\n\n  /**\n   * Get help for the API skill\n   */\n  getHelp(): string {\n    return `\n/api - OpenAPI-based API access via Restish\n\nCommands:\n  /api add <name> <url> [--spec <url>] [--auth-type api-key|oauth2]\n      Register a new API\n\n  /api list\n      List all registered APIs\n\n  /api describe <name> [operation]\n      Show API details or specific operation\n\n  /api exec <name> <operation> [--param value...]\n      Execute an API operation\n\n  /api auth <name> --token <token> [--env-var NAME]\n      Configure API authentication\n\n  /api auth <name> --oauth [--scopes scope1,scope2]\n      Configure OAuth2 authentication\n\n  /api sync <name>\n      Refresh API operations from spec\n\n  /api remove <name>\n      Remove a registered API\n\nExamples:\n  /api add github https://api.github.com --spec https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json\n  /api auth github --token \"$GITHUB_TOKEN\"\n  /api exec github repos list-for-user --username octocat\n  /api exec github issues list --owner microsoft --repo vscode --state open\n\nBuilt on restish (https://rest.sh) for automatic OpenAPI discovery.\n`;\n  }\n}\n\n// Singleton instance\nlet apiSkillInstance: APISkill | null = null;\n\nexport function getAPISkill(): APISkill {\n  if (!apiSkillInstance) {\n    apiSkillInstance = new APISkill();\n  }\n  return apiSkillInstance;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/skills/claude-skills.js

@@ -5,6 +5,7 @@ import {
 import {
   RecursiveAgentOrchestrator
 } from "./recursive-agent-orchestrator.js";
+import { getAPISkill } from "./api-skill.js";
 import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
@@ -604,6 +605,7 @@ class ClaudeSkillsManager {
     this.handoffSkill = new HandoffSkill(context);
     this.checkpointSkill = new CheckpointSkill(context);
     this.archaeologistSkill = new ArchaeologistSkill(context);
+    this.apiSkill = getAPISkill();
     import("./dashboard-launcher.js").then((module) => {
       this.dashboardLauncher = new module.DashboardLauncherSkill();
       logger.info("Dashboard launcher initialized (manual launch required)");
@@ -649,6 +651,7 @@ class ClaudeSkillsManager {
   dashboardLauncher;
   repoIngestionSkill = null;
   rlmOrchestrator = null;
+  apiSkill;
   async executeSkill(skillName, args, options) {
     switch (skillName) {
       case "handoff":
@@ -848,6 +851,49 @@ class ClaudeSkillsManager {
             message: `RLM execution failed: ${error.message}`
           };
         }
+      case "api":
+        const apiCmd = args[0];
+        switch (apiCmd) {
+          case "add":
+            return this.apiSkill.add(args[1], args[2], {
+              spec: options?.spec,
+              authType: options?.authType,
+              headerName: options?.headerName,
+              envVar: options?.envVar
+            });
+          case "list":
+            return this.apiSkill.list();
+          case "describe":
+            return this.apiSkill.describe(args[1], args[2]);
+          case "exec":
+            const execParams = {};
+            for (let i = 3; i < args.length; i += 2) {
+              if (args[i] && args[i + 1]) {
+                execParams[args[i].replace("--", "")] = args[i + 1];
+              }
+            }
+            return this.apiSkill.exec(args[1], args[2], execParams, {
+              raw: options?.raw,
+              filter: options?.filter
+            });
+          case "auth":
+            return this.apiSkill.auth(args[1], {
+              token: options?.token,
+              envVar: options?.envVar,
+              oauth: options?.oauth,
+              scopes: options?.scopes?.split(",")
+            });
+          case "sync":
+            return this.apiSkill.sync(args[1]);
+          case "remove":
+            return this.apiSkill.remove(args[1]);
+          case "help":
+          default:
+            return {
+              success: true,
+              message: this.apiSkill.getHelp()
+            };
+        }
       default:
         return {
           success: false,
@@ -856,7 +902,7 @@ class ClaudeSkillsManager {
     }
   }
   getAvailableSkills() {
-    const skills = ["handoff", "checkpoint", "dig", "dashboard"];
+    const skills = ["handoff", "checkpoint", "dig", "dashboard", "api"];
     if (this.repoIngestionSkill) {
       skills.push("repo");
     }
@@ -995,6 +1041,8 @@ Examples:
 /rlm "Generate comprehensive tests for the API endpoints" --test-mode integration
 /rlm "Review and improve code quality" --review-stages 5 --quality-threshold 0.95
 `;
+      case "api":
+        return this.apiSkill.getHelp();
       default:
         return `Unknown skill: ${skillName}`;
     }