@stackmemoryai/stackmemory 0.5.3 → 0.5.5

package/dist/skills/api-discovery.js

@@ -0,0 +1,349 @@
+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";
+import { getAPISkill } from "./api-skill.js";
+const API_PATTERNS = [
+  // Direct API URLs
+  {
+    pattern: /https?:\/\/api\.([a-z0-9-]+)\.(com|io|dev|app|co)/,
+    nameGroup: 1
+  },
+  // REST API paths in docs
+  { pattern: /https?:\/\/([a-z0-9-]+)\.com\/api/, nameGroup: 1 },
+  // Developer docs
+  { pattern: /https?:\/\/developer\.([a-z0-9-]+)\.com/, nameGroup: 1 },
+  // Docs subdomains
+  { pattern: /https?:\/\/docs\.([a-z0-9-]+)\.(com|io|dev)/, nameGroup: 1 }
+];
+const KNOWN_SPECS = {
+  github: "https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json",
+  stripe: "https://raw.githubusercontent.com/stripe/openapi/master/openapi/spec3.json",
+  twilio: "https://raw.githubusercontent.com/twilio/twilio-oai/main/spec/json/twilio_api_v2010.json",
+  slack: "https://api.slack.com/specs/openapi/v2/slack_web.json",
+  discord: "https://raw.githubusercontent.com/discord/discord-api-spec/main/specs/openapi.json",
+  openai: "https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml",
+  anthropic: "https://raw.githubusercontent.com/anthropics/anthropic-sdk-python/main/openapi.json",
+  linear: "https://api.linear.app/graphql",
+  // GraphQL, not REST
+  notion: "https://raw.githubusercontent.com/NotionX/notion-sdk-js/main/openapi.json",
+  vercel: "https://openapi.vercel.sh/",
+  cloudflare: "https://raw.githubusercontent.com/cloudflare/api-schemas/main/openapi.json",
+  // Google Cloud Platform - uses Google Discovery format
+  gcp: "https://www.googleapis.com/discovery/v1/apis",
+  "gcp-compute": "https://compute.googleapis.com/$discovery/rest?version=v1",
+  "gcp-storage": "https://storage.googleapis.com/$discovery/rest?version=v1",
+  "gcp-run": "https://run.googleapis.com/$discovery/rest?version=v2",
+  "gcp-functions": "https://cloudfunctions.googleapis.com/$discovery/rest?version=v2",
+  "gcp-bigquery": "https://bigquery.googleapis.com/$discovery/rest?version=v2",
+  "gcp-aiplatform": "https://aiplatform.googleapis.com/$discovery/rest?version=v1",
+  // Railway - GraphQL API
+  railway: "https://backboard.railway.com/graphql/v2"
+  // GraphQL endpoint
+};
+const KNOWN_BASES = {
+  github: "https://api.github.com",
+  stripe: "https://api.stripe.com",
+  twilio: "https://api.twilio.com",
+  slack: "https://slack.com/api",
+  discord: "https://discord.com/api",
+  openai: "https://api.openai.com",
+  anthropic: "https://api.anthropic.com",
+  linear: "https://api.linear.app",
+  notion: "https://api.notion.com",
+  vercel: "https://api.vercel.com",
+  cloudflare: "https://api.cloudflare.com",
+  // Google Cloud Platform
+  gcp: "https://www.googleapis.com",
+  "gcp-compute": "https://compute.googleapis.com",
+  "gcp-storage": "https://storage.googleapis.com",
+  "gcp-run": "https://run.googleapis.com",
+  "gcp-functions": "https://cloudfunctions.googleapis.com",
+  "gcp-bigquery": "https://bigquery.googleapis.com",
+  "gcp-aiplatform": "https://aiplatform.googleapis.com",
+  // Railway (GraphQL)
+  railway: "https://backboard.railway.com/graphql/v2"
+};
+const API_TYPES = {
+  railway: "graphql",
+  linear: "graphql",
+  gcp: "google-discovery",
+  "gcp-compute": "google-discovery",
+  "gcp-storage": "google-discovery",
+  "gcp-run": "google-discovery",
+  "gcp-functions": "google-discovery",
+  "gcp-bigquery": "google-discovery",
+  "gcp-aiplatform": "google-discovery"
+};
+class APIDiscoverySkill {
+  discoveryLog;
+  discoveredAPIs = /* @__PURE__ */ new Map();
+  constructor() {
+    this.discoveryLog = path.join(
+      os.homedir(),
+      ".stackmemory",
+      "api-discovery.log"
+    );
+  }
+  /**
+   * Analyze a URL for potential API endpoints
+   */
+  analyzeUrl(url) {
+    if (url.includes("googleapis.com")) {
+      const gcpMatch = url.match(/https?:\/\/([a-z]+)\.googleapis\.com/);
+      if (gcpMatch) {
+        const service = gcpMatch[1];
+        const name = `gcp-${service}`;
+        return {
+          name,
+          baseUrl: `https://${service}.googleapis.com`,
+          specUrl: KNOWN_SPECS[name] || `https://${service}.googleapis.com/$discovery/rest?version=v1`,
+          source: "known",
+          confidence: 0.95,
+          apiType: "google-discovery"
+        };
+      }
+    }
+    if (url.includes("railway.com") || url.includes("railway.app")) {
+      return {
+        name: "railway",
+        baseUrl: KNOWN_BASES["railway"],
+        specUrl: KNOWN_SPECS["railway"],
+        source: "known",
+        confidence: 0.95,
+        apiType: "graphql"
+      };
+    }
+    for (const [name, baseUrl] of Object.entries(KNOWN_BASES)) {
+      if (url.includes(name) || url.includes(baseUrl)) {
+        return {
+          name,
+          baseUrl,
+          specUrl: KNOWN_SPECS[name],
+          source: "known",
+          confidence: 0.95,
+          apiType: API_TYPES[name] || "rest"
+        };
+      }
+    }
+    for (const { pattern, nameGroup } of API_PATTERNS) {
+      const match = url.match(pattern);
+      if (match) {
+        const name = match[nameGroup].toLowerCase();
+        const baseUrl = this.inferBaseUrl(url, name);
+        return {
+          name,
+          baseUrl,
+          source: "inferred",
+          confidence: 0.7,
+          apiType: "rest"
+        };
+      }
+    }
+    return null;
+  }
+  /**
+   * Infer base URL from a discovered URL
+   */
+  inferBaseUrl(url, name) {
+    const patterns = [
+      `https://api.${name}.com`,
+      `https://api.${name}.io`,
+      `https://${name}.com/api`
+    ];
+    try {
+      const urlObj = new URL(url);
+      if (urlObj.hostname.startsWith("api.")) {
+        return `${urlObj.protocol}//${urlObj.hostname}`;
+      }
+      if (urlObj.pathname.includes("/api")) {
+        return `${urlObj.protocol}//${urlObj.hostname}/api`;
+      }
+      return `${urlObj.protocol}//${urlObj.hostname}`;
+    } catch {
+      return patterns[0];
+    }
+  }
+  /**
+   * Try to discover OpenAPI spec for a service
+   */
+  async discoverSpec(name, baseUrl) {
+    if (KNOWN_SPECS[name]) {
+      return KNOWN_SPECS[name];
+    }
+    const specPaths = [
+      "/openapi.json",
+      "/openapi.yaml",
+      "/swagger.json",
+      "/swagger.yaml",
+      "/api-docs",
+      "/v1/openapi.json",
+      "/v2/openapi.json",
+      "/docs/openapi.json",
+      "/.well-known/openapi.json"
+    ];
+    for (const specPath of specPaths) {
+      const specUrl = `${baseUrl}${specPath}`;
+      try {
+        execSync(`curl -sI --max-time 2 "${specUrl}" | grep -q "200 OK"`, {
+          stdio: "pipe"
+        });
+        return specUrl;
+      } catch {
+      }
+    }
+    return null;
+  }
+  /**
+   * Process a URL and auto-register if it's an API
+   */
+  async processUrl(url, autoRegister = true) {
+    const discovered = this.analyzeUrl(url);
+    if (!discovered) {
+      return null;
+    }
+    if (this.discoveredAPIs.has(discovered.name)) {
+      return this.discoveredAPIs.get(discovered.name);
+    }
+    if (!discovered.specUrl && discovered.source !== "known") {
+      try {
+        discovered.specUrl = await this.discoverSpec(discovered.name, discovered.baseUrl) || void 0;
+      } catch {
+      }
+    }
+    this.discoveredAPIs.set(discovered.name, discovered);
+    this.logDiscovery(discovered, url);
+    if (autoRegister && discovered.confidence >= 0.7) {
+      await this.registerAPI(discovered);
+    }
+    return discovered;
+  }
+  /**
+   * Register a discovered API
+   */
+  async registerAPI(api) {
+    const skill = getAPISkill();
+    try {
+      const result = await skill.add(api.name, api.baseUrl, {
+        spec: api.specUrl
+      });
+      if (result.success) {
+        logger.info(`Auto-registered API: ${api.name}`);
+        return true;
+      }
+    } catch (error) {
+      logger.warn(`Failed to auto-register API ${api.name}:`, error);
+    }
+    return false;
+  }
+  /**
+   * Log discovery for debugging
+   */
+  logDiscovery(api, sourceUrl) {
+    const entry = {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      api,
+      sourceUrl
+    };
+    try {
+      const dir = path.dirname(this.discoveryLog);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+      fs.appendFileSync(this.discoveryLog, JSON.stringify(entry) + "\n");
+    } catch (error) {
+      logger.warn("Failed to log API discovery:", error);
+    }
+  }
+  /**
+   * Get all discovered APIs
+   */
+  getDiscoveredAPIs() {
+    return Array.from(this.discoveredAPIs.values());
+  }
+  /**
+   * Suggest API registration based on recent activity
+   */
+  async suggestFromContext(recentUrls) {
+    const result = {
+      discovered: [],
+      registered: [],
+      skipped: []
+    };
+    for (const url of recentUrls) {
+      const discovered = await this.processUrl(url, false);
+      if (discovered) {
+        result.discovered.push(discovered);
+        const skill = getAPISkill();
+        const listResult = await skill.list();
+        const existingAPIs = listResult.data || [];
+        if (existingAPIs.some((api) => api.name === discovered.name)) {
+          result.skipped.push(discovered.name);
+        } else if (discovered.confidence >= 0.7) {
+          const registered = await this.registerAPI(discovered);
+          if (registered) {
+            result.registered.push(discovered.name);
+          }
+        }
+      }
+    }
+    return result;
+  }
+  /**
+   * Get help text
+   */
+  getHelp() {
+    const restAPIs = Object.keys(KNOWN_SPECS).filter(
+      (s) => !API_TYPES[s] || API_TYPES[s] === "rest"
+    );
+    const graphqlAPIs = Object.keys(KNOWN_SPECS).filter(
+      (s) => API_TYPES[s] === "graphql"
+    );
+    const gcpAPIs = Object.keys(KNOWN_SPECS).filter(
+      (s) => API_TYPES[s] === "google-discovery"
+    );
+    return `
+API Auto-Discovery
+
+Automatically detects and registers APIs when you browse documentation.
+
+REST APIs (OpenAPI specs):
+${restAPIs.map((s) => `  - ${s}`).join("\n")}
+
+GraphQL APIs:
+${graphqlAPIs.map((s) => `  - ${s}`).join("\n")}
+
+Google Cloud Platform (Discovery format):
+${gcpAPIs.map((s) => `  - ${s}`).join("\n")}
+
+How It Works:
+1. Monitors URLs you access during development
+2. Identifies API documentation and endpoints
+3. Finds OpenAPI specs automatically
+4. Registers APIs for easy access via /api exec
+
+Usage:
+  # Check if a URL is a known API
+  stackmemory api discover <url>
+
+  # List discovered APIs
+  stackmemory api discovered
+
+  # Register all discovered APIs
+  stackmemory api register-discovered
+`;
+  }
+}
+let discoveryInstance = null;
+function getAPIDiscovery() {
+  if (!discoveryInstance) {
+    discoveryInstance = new APIDiscoverySkill();
+  }
+  return discoveryInstance;
+}
+export {
+  APIDiscoverySkill,
+  getAPIDiscovery
+};
+//# sourceMappingURL=api-discovery.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/skills/api-discovery.ts"],
+  "sourcesContent": ["/**\n * API Auto-Discovery Skill\n *\n * Automatically detects API endpoints and OpenAPI specs when Claude\n * reads documentation or API URLs, then registers them for easy access.\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 { getAPISkill } from './api-skill.js';\n\n// Common API documentation patterns\nconst API_PATTERNS = [\n  // Direct API URLs\n  {\n    pattern: /https?:\\/\\/api\\.([a-z0-9-]+)\\.(com|io|dev|app|co)/,\n    nameGroup: 1,\n  },\n  // REST API paths in docs\n  { pattern: /https?:\\/\\/([a-z0-9-]+)\\.com\\/api/, nameGroup: 1 },\n  // Developer docs\n  { pattern: /https?:\\/\\/developer\\.([a-z0-9-]+)\\.com/, nameGroup: 1 },\n  // Docs subdomains\n  { pattern: /https?:\\/\\/docs\\.([a-z0-9-]+)\\.(com|io|dev)/, nameGroup: 1 },\n];\n\n// Known OpenAPI spec locations for popular services\nconst KNOWN_SPECS: Record<string, string> = {\n  github:\n    'https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json',\n  stripe:\n    'https://raw.githubusercontent.com/stripe/openapi/master/openapi/spec3.json',\n  twilio:\n    'https://raw.githubusercontent.com/twilio/twilio-oai/main/spec/json/twilio_api_v2010.json',\n  slack: 'https://api.slack.com/specs/openapi/v2/slack_web.json',\n  discord:\n    'https://raw.githubusercontent.com/discord/discord-api-spec/main/specs/openapi.json',\n  openai:\n    'https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml',\n  anthropic:\n    'https://raw.githubusercontent.com/anthropics/anthropic-sdk-python/main/openapi.json',\n  linear: 'https://api.linear.app/graphql', // GraphQL, not REST\n  notion:\n    'https://raw.githubusercontent.com/NotionX/notion-sdk-js/main/openapi.json',\n  vercel: 'https://openapi.vercel.sh/',\n  cloudflare:\n    'https://raw.githubusercontent.com/cloudflare/api-schemas/main/openapi.json',\n  // Google Cloud Platform - uses Google Discovery format\n  gcp: 'https://www.googleapis.com/discovery/v1/apis',\n  'gcp-compute': 'https://compute.googleapis.com/$discovery/rest?version=v1',\n  'gcp-storage': 'https://storage.googleapis.com/$discovery/rest?version=v1',\n  'gcp-run': 'https://run.googleapis.com/$discovery/rest?version=v2',\n  'gcp-functions':\n    'https://cloudfunctions.googleapis.com/$discovery/rest?version=v2',\n  'gcp-bigquery': 'https://bigquery.googleapis.com/$discovery/rest?version=v2',\n  'gcp-aiplatform':\n    'https://aiplatform.googleapis.com/$discovery/rest?version=v1',\n  // Railway - GraphQL API\n  railway: 'https://backboard.railway.com/graphql/v2', // GraphQL endpoint\n};\n\n// Known base URLs for popular services\nconst KNOWN_BASES: Record<string, string> = {\n  github: 'https://api.github.com',\n  stripe: 'https://api.stripe.com',\n  twilio: 'https://api.twilio.com',\n  slack: 'https://slack.com/api',\n  discord: 'https://discord.com/api',\n  openai: 'https://api.openai.com',\n  anthropic: 'https://api.anthropic.com',\n  linear: 'https://api.linear.app',\n  notion: 'https://api.notion.com',\n  vercel: 'https://api.vercel.com',\n  cloudflare: 'https://api.cloudflare.com',\n  // Google Cloud Platform\n  gcp: 'https://www.googleapis.com',\n  'gcp-compute': 'https://compute.googleapis.com',\n  'gcp-storage': 'https://storage.googleapis.com',\n  'gcp-run': 'https://run.googleapis.com',\n  'gcp-functions': 'https://cloudfunctions.googleapis.com',\n  'gcp-bigquery': 'https://bigquery.googleapis.com',\n  'gcp-aiplatform': 'https://aiplatform.googleapis.com',\n  // Railway (GraphQL)\n  railway: 'https://backboard.railway.com/graphql/v2',\n};\n\n// API types for special handling\nconst API_TYPES: Record<string, 'rest' | 'graphql' | 'google-discovery'> = {\n  railway: 'graphql',\n  linear: 'graphql',\n  gcp: 'google-discovery',\n  'gcp-compute': 'google-discovery',\n  'gcp-storage': 'google-discovery',\n  'gcp-run': 'google-discovery',\n  'gcp-functions': 'google-discovery',\n  'gcp-bigquery': 'google-discovery',\n  'gcp-aiplatform': 'google-discovery',\n};\n\nexport interface DiscoveredAPI {\n  name: string;\n  baseUrl: string;\n  specUrl?: string;\n  source: 'url' | 'docs' | 'known' | 'inferred';\n  confidence: number; // 0-1\n  apiType?: 'rest' | 'graphql' | 'google-discovery';\n}\n\nexport interface DiscoveryResult {\n  discovered: DiscoveredAPI[];\n  registered: string[];\n  skipped: string[];\n}\n\nexport class APIDiscoverySkill {\n  private discoveryLog: string;\n  private discoveredAPIs: Map<string, DiscoveredAPI> = new Map();\n\n  constructor() {\n    this.discoveryLog = path.join(\n      os.homedir(),\n      '.stackmemory',\n      'api-discovery.log'\n    );\n  }\n\n  /**\n   * Analyze a URL for potential API endpoints\n   */\n  analyzeUrl(url: string): DiscoveredAPI | null {\n    // Check for GCP URLs first (special pattern)\n    if (url.includes('googleapis.com')) {\n      const gcpMatch = url.match(/https?:\\/\\/([a-z]+)\\.googleapis\\.com/);\n      if (gcpMatch) {\n        const service = gcpMatch[1];\n        const name = `gcp-${service}`;\n        return {\n          name,\n          baseUrl: `https://${service}.googleapis.com`,\n          specUrl:\n            KNOWN_SPECS[name] ||\n            `https://${service}.googleapis.com/$discovery/rest?version=v1`,\n          source: 'known',\n          confidence: 0.95,\n          apiType: 'google-discovery',\n        };\n      }\n    }\n\n    // Check for Railway\n    if (url.includes('railway.com') || url.includes('railway.app')) {\n      return {\n        name: 'railway',\n        baseUrl: KNOWN_BASES['railway'],\n        specUrl: KNOWN_SPECS['railway'],\n        source: 'known',\n        confidence: 0.95,\n        apiType: 'graphql',\n      };\n    }\n\n    // Check if it's a known service\n    for (const [name, baseUrl] of Object.entries(KNOWN_BASES)) {\n      if (url.includes(name) || url.includes(baseUrl)) {\n        return {\n          name,\n          baseUrl,\n          specUrl: KNOWN_SPECS[name],\n          source: 'known',\n          confidence: 0.95,\n          apiType: API_TYPES[name] || 'rest',\n        };\n      }\n    }\n\n    // Try to match API patterns\n    for (const { pattern, nameGroup } of API_PATTERNS) {\n      const match = url.match(pattern);\n      if (match) {\n        const name = match[nameGroup].toLowerCase();\n        const baseUrl = this.inferBaseUrl(url, name);\n\n        return {\n          name,\n          baseUrl,\n          source: 'inferred',\n          confidence: 0.7,\n          apiType: 'rest',\n        };\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Infer base URL from a discovered URL\n   */\n  private inferBaseUrl(url: string, name: string): string {\n    // Try common patterns\n    const patterns = [\n      `https://api.${name}.com`,\n      `https://api.${name}.io`,\n      `https://${name}.com/api`,\n    ];\n\n    // Extract domain from URL\n    try {\n      const urlObj = new URL(url);\n      if (urlObj.hostname.startsWith('api.')) {\n        return `${urlObj.protocol}//${urlObj.hostname}`;\n      }\n      if (urlObj.pathname.includes('/api')) {\n        return `${urlObj.protocol}//${urlObj.hostname}/api`;\n      }\n      return `${urlObj.protocol}//${urlObj.hostname}`;\n    } catch {\n      return patterns[0];\n    }\n  }\n\n  /**\n   * Try to discover OpenAPI spec for a service\n   */\n  async discoverSpec(name: string, baseUrl: string): Promise<string | null> {\n    // Check known specs first\n    if (KNOWN_SPECS[name]) {\n      return KNOWN_SPECS[name];\n    }\n\n    // Try common spec locations\n    const specPaths = [\n      '/openapi.json',\n      '/openapi.yaml',\n      '/swagger.json',\n      '/swagger.yaml',\n      '/api-docs',\n      '/v1/openapi.json',\n      '/v2/openapi.json',\n      '/docs/openapi.json',\n      '/.well-known/openapi.json',\n    ];\n\n    for (const specPath of specPaths) {\n      const specUrl = `${baseUrl}${specPath}`;\n      try {\n        // Quick HEAD request to check if spec exists\n        execSync(`curl -sI --max-time 2 \"${specUrl}\" | grep -q \"200 OK\"`, {\n          stdio: 'pipe',\n        });\n        return specUrl;\n      } catch {\n        // Spec not found at this location\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Process a URL and auto-register if it's an API\n   */\n  async processUrl(\n    url: string,\n    autoRegister: boolean = true\n  ): Promise<DiscoveredAPI | null> {\n    const discovered = this.analyzeUrl(url);\n\n    if (!discovered) {\n      return null;\n    }\n\n    // Check if already discovered\n    if (this.discoveredAPIs.has(discovered.name)) {\n      return this.discoveredAPIs.get(discovered.name)!;\n    }\n\n    // Only probe for spec if it's not a known service (known services already have spec URLs)\n    if (!discovered.specUrl && discovered.source !== 'known') {\n      // Try to find OpenAPI spec (with timeout protection)\n      try {\n        discovered.specUrl =\n          (await this.discoverSpec(discovered.name, discovered.baseUrl)) ||\n          undefined;\n      } catch {\n        // Spec discovery failed, continue without\n      }\n    }\n\n    this.discoveredAPIs.set(discovered.name, discovered);\n    this.logDiscovery(discovered, url);\n\n    // Auto-register if enabled and confidence is high enough\n    if (autoRegister && discovered.confidence >= 0.7) {\n      await this.registerAPI(discovered);\n    }\n\n    return discovered;\n  }\n\n  /**\n   * Register a discovered API\n   */\n  async registerAPI(api: DiscoveredAPI): Promise<boolean> {\n    const skill = getAPISkill();\n\n    try {\n      const result = await skill.add(api.name, api.baseUrl, {\n        spec: api.specUrl,\n      });\n\n      if (result.success) {\n        logger.info(`Auto-registered API: ${api.name}`);\n        return true;\n      }\n    } catch (error) {\n      logger.warn(`Failed to auto-register API ${api.name}:`, error);\n    }\n\n    return false;\n  }\n\n  /**\n   * Log discovery for debugging\n   */\n  private logDiscovery(api: DiscoveredAPI, sourceUrl: string): void {\n    const entry = {\n      timestamp: new Date().toISOString(),\n      api,\n      sourceUrl,\n    };\n\n    try {\n      const dir = path.dirname(this.discoveryLog);\n      if (!fs.existsSync(dir)) {\n        fs.mkdirSync(dir, { recursive: true });\n      }\n\n      fs.appendFileSync(this.discoveryLog, JSON.stringify(entry) + '\\n');\n    } catch (error) {\n      logger.warn('Failed to log API discovery:', error);\n    }\n  }\n\n  /**\n   * Get all discovered APIs\n   */\n  getDiscoveredAPIs(): DiscoveredAPI[] {\n    return Array.from(this.discoveredAPIs.values());\n  }\n\n  /**\n   * Suggest API registration based on recent activity\n   */\n  async suggestFromContext(recentUrls: string[]): Promise<DiscoveryResult> {\n    const result: DiscoveryResult = {\n      discovered: [],\n      registered: [],\n      skipped: [],\n    };\n\n    for (const url of recentUrls) {\n      const discovered = await this.processUrl(url, false);\n\n      if (discovered) {\n        result.discovered.push(discovered);\n\n        // Check if already registered\n        const skill = getAPISkill();\n        const listResult = await skill.list();\n        const existingAPIs = (listResult.data as Array<{ name: string }>) || [];\n\n        if (existingAPIs.some((api) => api.name === discovered.name)) {\n          result.skipped.push(discovered.name);\n        } else if (discovered.confidence >= 0.7) {\n          const registered = await this.registerAPI(discovered);\n          if (registered) {\n            result.registered.push(discovered.name);\n          }\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Get help text\n   */\n  getHelp(): string {\n    const restAPIs = Object.keys(KNOWN_SPECS).filter(\n      (s) => !API_TYPES[s] || API_TYPES[s] === 'rest'\n    );\n    const graphqlAPIs = Object.keys(KNOWN_SPECS).filter(\n      (s) => API_TYPES[s] === 'graphql'\n    );\n    const gcpAPIs = Object.keys(KNOWN_SPECS).filter(\n      (s) => API_TYPES[s] === 'google-discovery'\n    );\n\n    return `\nAPI Auto-Discovery\n\nAutomatically detects and registers APIs when you browse documentation.\n\nREST APIs (OpenAPI specs):\n${restAPIs.map((s) => `  - ${s}`).join('\\n')}\n\nGraphQL APIs:\n${graphqlAPIs.map((s) => `  - ${s}`).join('\\n')}\n\nGoogle Cloud Platform (Discovery format):\n${gcpAPIs.map((s) => `  - ${s}`).join('\\n')}\n\nHow It Works:\n1. Monitors URLs you access during development\n2. Identifies API documentation and endpoints\n3. Finds OpenAPI specs automatically\n4. Registers APIs for easy access via /api exec\n\nUsage:\n  # Check if a URL is a known API\n  stackmemory api discover <url>\n\n  # List discovered APIs\n  stackmemory api discovered\n\n  # Register all discovered APIs\n  stackmemory api register-discovered\n`;\n  }\n}\n\n// Singleton instance\nlet discoveryInstance: APIDiscoverySkill | null = null;\n\nexport function getAPIDiscovery(): APIDiscoverySkill {\n  if (!discoveryInstance) {\n    discoveryInstance = new APIDiscoverySkill();\n  }\n  return discoveryInstance;\n}\n"],
+  "mappings": "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",
+  "names": []
+}