@pulsemcp/air-sdk 0.0.23 → 0.0.24

package/dist/update.d.ts

@@ -10,10 +10,12 @@ export interface UpdateProviderCachesResult {
 /**
  * Refresh all provider caches.
  *
- * Loads extensions from air.json, finds providers that implement
- * refreshCache(), and calls them. Returns structured results.
+ * Discovers providers in two ways:
+ * 1. From air.json extensions (if air.json exists)
+ * 2. By scanning ~/.air/cache/ for known provider cache directories
  *
- * @throws Error if air.json is not found.
+ * This ensures cached data is refreshed even when the provider isn't
+ * explicitly listed in air.json's extensions array.
  */
 export declare function updateProviderCaches(options?: UpdateProviderCachesOptions): Promise<UpdateProviderCachesResult>;
 //# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,2BAA2B;IAC1C,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,0BAA0B,CAAC,CAsBrC"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,kBAAkB,EAGxB,MAAM,oBAAoB,CAAC;AAY5B,MAAM,WAAW,2BAA2B;IAC1C,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;CAC/C;AAqED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,0BAA0B,CAAC,CA6CrC"}

package/dist/update.js

@@ -1,28 +1,129 @@
-import { dirname, resolve } from "path";
-import { loadAirConfig, getAirJsonPath, } from "@pulsemcp/air-core";
+import { createRequire } from "module";
+import { existsSync, readdirSync } from "fs";
+import { dirname, join, resolve } from "path";
+import { pathToFileURL } from "url";
+import { loadAirConfig, getAirJsonPath, getDefaultAirJsonPath, } from "@pulsemcp/air-core";
 import { loadExtensions } from "./extension-loader.js";
+import { resolveEsmEntry } from "./esm-resolve.js";
+/**
+ * Known provider packages, keyed by their cache directory name (scheme).
+ * Used to auto-discover providers when air.json doesn't list them.
+ */
+const KNOWN_PROVIDERS = {
+    github: "@pulsemcp/air-provider-github",
+};
+/**
+ * Get the AIR cache root directory (~/.air/cache).
+ * Derived from getDefaultAirJsonPath() to stay in sync with core's
+ * notion of the AIR home directory.
+ */
+function getCacheRoot() {
+    return resolve(dirname(getDefaultAirJsonPath()), "cache");
+}
+/**
+ * Scan ~/.air/cache/ for subdirectories, each representing a provider scheme
+ * that has cached data on disk.
+ */
+function discoverCachedSchemes() {
+    const cacheRoot = getCacheRoot();
+    if (!existsSync(cacheRoot))
+        return [];
+    try {
+        return readdirSync(cacheRoot, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Try to load a provider extension by package name, searching the given
+ * directories for the installed package. Handles CJS, ESM-only, and
+ * standard Node resolution.
+ */
+async function tryLoadProvider(packageName, searchDirs) {
+    for (const dir of searchDirs) {
+        try {
+            const req = createRequire(join(dir, "__placeholder.js"));
+            const resolved = req.resolve(packageName);
+            const mod = await import(pathToFileURL(resolved).href);
+            return mod.default?.provider ?? null;
+        }
+        catch (err) {
+            const code = err?.code;
+            if (code === "ERR_PACKAGE_PATH_NOT_EXPORTED") {
+                const esmEntry = resolveEsmEntry(packageName, dir);
+                if (esmEntry) {
+                    try {
+                        const mod = await import(pathToFileURL(esmEntry).href);
+                        return mod.default?.provider ?? null;
+                    }
+                    catch {
+                        // Fall through to next directory
+                    }
+                }
+            }
+            // Not found in this directory, try next
+        }
+    }
+    // Fall back to standard Node resolution
+    try {
+        const mod = await import(packageName);
+        return mod.default?.provider ?? null;
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Refresh all provider caches.
  *
- * Loads extensions from air.json, finds providers that implement
- * refreshCache(), and calls them. Returns structured results.
+ * Discovers providers in two ways:
+ * 1. From air.json extensions (if air.json exists)
+ * 2. By scanning ~/.air/cache/ for known provider cache directories
  *
- * @throws Error if air.json is not found.
+ * This ensures cached data is refreshed even when the provider isn't
+ * explicitly listed in air.json's extensions array.
  */
 export async function updateProviderCaches(options) {
     const airJsonPath = options?.config ?? getAirJsonPath();
-    if (!airJsonPath) {
-        throw new Error("No air.json found. Specify a config path or set AIR_CONFIG env var.");
+    const providers = new Map();
+    let airJsonDir = null;
+    // Load providers from air.json extensions if available
+    if (airJsonPath) {
+        airJsonDir = dirname(resolve(airJsonPath));
+        const airConfig = loadAirConfig(airJsonPath);
+        const loaded = await loadExtensions(airConfig.extensions || [], airJsonDir);
+        for (const ext of loaded.providers) {
+            const provider = ext.provider;
+            providers.set(provider.scheme, provider);
+        }
+    }
+    // Discover additional providers from cache directory
+    const cachedSchemes = discoverCachedSchemes();
+    for (const scheme of cachedSchemes) {
+        if (providers.has(scheme))
+            continue;
+        const packageName = KNOWN_PROVIDERS[scheme];
+        if (!packageName)
+            continue;
+        const searchDirs = [];
+        if (airJsonDir)
+            searchDirs.push(airJsonDir);
+        const defaultAirDir = dirname(getDefaultAirJsonPath());
+        if (defaultAirDir !== airJsonDir)
+            searchDirs.push(defaultAirDir);
+        const provider = await tryLoadProvider(packageName, searchDirs);
+        if (provider?.refreshCache) {
+            providers.set(scheme, provider);
+        }
     }
-    const airJsonDir = dirname(resolve(airJsonPath));
-    const airConfig = loadAirConfig(airJsonPath);
-    const loaded = await loadExtensions(airConfig.extensions || [], airJsonDir);
     const results = {};
-    for (const ext of loaded.providers) {
-        const provider = ext.provider;
+    for (const [scheme, provider] of providers) {
         if (!provider.refreshCache)
             continue;
-        results[provider.scheme] = await provider.refreshCache();
+        results[scheme] = await provider.refreshCache();
     }
     return { results };
 }

package/dist/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EACL,aAAa,EACb,cAAc,GAEf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAYvD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAqC;IAErC,MAAM,WAAW,GAAG,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,CAAC;IACxD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,UAAU,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;IAE5E,MAAM,OAAO,GAAyC,EAAE,CAAC;IAEzD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAS,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,YAAY;YAAE,SAAS;QAErC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;IAC3D,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EACL,aAAa,EACb,cAAc,EACd,qBAAqB,GAItB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;GAGG;AACH,MAAM,eAAe,GAA2B;IAC9C,MAAM,EAAE,+BAA+B;CACxC,CAAC;AAYF;;;;GAIG;AACH,SAAS,YAAY;IACnB,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB;IAC5B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACnD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,eAAe,CAC5B,WAAmB,EACnB,UAAoB;IAEpB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;YACvD,OAAQ,GAAG,CAAC,OAAwB,EAAE,QAAQ,IAAI,IAAI,CAAC;QACzD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,IAAI,GAAI,GAA6B,EAAE,IAAI,CAAC;YAClD,IAAI,IAAI,KAAK,+BAA+B,EAAE,CAAC;gBAC7C,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;gBACnD,IAAI,QAAQ,EAAE,CAAC;oBACb,IAAI,CAAC;wBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;wBACvD,OAAQ,GAAG,CAAC,OAAwB,EAAE,QAAQ,IAAI,IAAI,CAAC;oBACzD,CAAC;oBAAC,MAAM,CAAC;wBACP,iCAAiC;oBACnC,CAAC;gBACH,CAAC;YACH,CAAC;YACD,wCAAwC;QAC1C,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QACtC,OAAQ,GAAG,CAAC,OAAwB,EAAE,QAAQ,IAAI,IAAI,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAqC;IAErC,MAAM,WAAW,GAAG,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,CAAC;IAExD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IACrD,IAAI,UAAU,GAAkB,IAAI,CAAC;IAErC,uDAAuD;IACvD,IAAI,WAAW,EAAE,CAAC;QAChB,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,UAAU,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;QAE5E,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAS,CAAC;YAC/B,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,MAAM,aAAa,GAAG,qBAAqB,EAAE,CAAC;IAC9C,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QAEpC,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,WAAW;YAAE,SAAS;QAE3B,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,IAAI,UAAU;YAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;QACvD,IAAI,aAAa,KAAK,UAAU;YAAE,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEjE,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAChE,IAAI,QAAQ,EAAE,YAAY,EAAE,CAAC;YAC3B,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAyC,EAAE,CAAC;IAEzD,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;QAC3C,IAAI,CAAC,QAAQ,CAAC,YAAY;YAAE,SAAS;QACrC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;IAClD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/package.json

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