@pulsemcp/air-sdk 0.0.6 → 0.0.10

package/dist/extension-loader.d.ts

@@ -0,0 +1,23 @@
+import type { AirExtension } from "@pulsemcp/air-core";
+export interface LoadedExtensions {
+    /** Extensions that provide an adapter */
+    adapters: AirExtension[];
+    /** Extensions that provide a provider */
+    providers: AirExtension[];
+    /** Extensions that provide a transform (in declaration order) */
+    transforms: AirExtension[];
+    /** All loaded extensions in declaration order */
+    all: AirExtension[];
+}
+/**
+ * Load extensions from the `extensions` array in air.json.
+ *
+ * Each entry is either an npm package name or a local path (starting
+ * with `./`, `../`, or `/`). The default export of each module must be
+ * either an `AirExtension` object or a bare transform function.
+ *
+ * Extensions are loaded sequentially in declaration order because
+ * order matters for transforms.
+ */
+export declare function loadExtensions(extensions: string[], airJsonDir: string): Promise<LoadedExtensions>;
+//# sourceMappingURL=extension-loader.d.ts.map

package/dist/extension-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-loader.d.ts","sourceRoot":"","sources":["../src/extension-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,oBAAoB,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,yCAAyC;IACzC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,iEAAiE;IACjE,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,iDAAiD;IACjD,GAAG,EAAE,YAAY,EAAE,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAiB3B"}

package/dist/extension-loader.js

@@ -0,0 +1,70 @@
+import { resolve } from "path";
+import { pathToFileURL } from "url";
+/**
+ * Load extensions from the `extensions` array in air.json.
+ *
+ * Each entry is either an npm package name or a local path (starting
+ * with `./`, `../`, or `/`). The default export of each module must be
+ * either an `AirExtension` object or a bare transform function.
+ *
+ * Extensions are loaded sequentially in declaration order because
+ * order matters for transforms.
+ */
+export async function loadExtensions(extensions, airJsonDir) {
+    const result = {
+        adapters: [],
+        providers: [],
+        transforms: [],
+        all: [],
+    };
+    for (const specifier of extensions) {
+        const ext = await loadSingleExtension(specifier, airJsonDir);
+        result.all.push(ext);
+        if (ext.adapter)
+            result.adapters.push(ext);
+        if (ext.provider)
+            result.providers.push(ext);
+        if (ext.transform)
+            result.transforms.push(ext);
+    }
+    return result;
+}
+async function loadSingleExtension(specifier, airJsonDir) {
+    let mod;
+    try {
+        if (specifier.startsWith("./") ||
+            specifier.startsWith("../") ||
+            specifier.startsWith("/")) {
+            const absPath = resolve(airJsonDir, specifier);
+            const fileUrl = pathToFileURL(absPath).href;
+            mod = await import(fileUrl);
+        }
+        else {
+            mod = await import(specifier);
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to load extension "${specifier}": ${message}`);
+    }
+    const defaultExport = mod.default;
+    // Bare function → shorthand for a transform-only extension
+    if (typeof defaultExport === "function") {
+        return {
+            name: specifier,
+            transform: {
+                transform: defaultExport,
+            },
+        };
+    }
+    if (!defaultExport || typeof defaultExport !== "object") {
+        throw new Error(`Extension "${specifier}" does not have a valid default export. ` +
+            `Expected an AirExtension object or a transform function.`);
+    }
+    const ext = defaultExport;
+    if (!ext.name || typeof ext.name !== "string") {
+        throw new Error(`Extension "${specifier}" is missing a required "name" field.`);
+    }
+    return ext;
+}
+//# sourceMappingURL=extension-loader.js.map

package/dist/extension-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-loader.js","sourceRoot":"","sources":["../src/extension-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAcpC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAoB,EACpB,UAAkB;IAElB,MAAM,MAAM,GAAqB;QAC/B,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,EAAE;QACd,GAAG,EAAE,EAAE;KACR,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAC7D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,GAAG,CAAC,OAAO;YAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,GAAG,CAAC,QAAQ;YAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,GAAG,CAAC,SAAS;YAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,SAAiB,EACjB,UAAkB;IAElB,IAAI,GAA4B,CAAC;IAEjC,IAAI,CAAC;QACH,IACE,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC;YAC1B,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC;YAC3B,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EACzB,CAAC;YACD,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;YAC5C,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CACb,6BAA6B,SAAS,MAAM,OAAO,EAAE,CACtD,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC;IAElC,2DAA2D;IAC3D,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;QACxC,OAAO;YACL,IAAI,EAAE,SAAS;YACf,SAAS,EAAE;gBACT,SAAS,EAAE,aAA8C;aAC1D;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,cAAc,SAAS,0CAA0C;YAC/D,0DAA0D,CAC7D,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,aAA6B,CAAC;IAC1C,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,cAAc,SAAS,uCAAuC,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { loadAirConfig, getDefaultAirJsonPath, getAirJsonPath, resolveArtifacts, mergeArtifacts, expandPlugins, emptyArtifacts, validateJson, getSchemasDir, getSchemaPath, loadSchema, detectSchemaType, detectSchemaFromValue, getAllSchemaTypes, isValidSchemaType, } from "@pulsemcp/air-core";
-export type { AirConfig, ResolvedArtifacts, SkillEntry, ReferenceEntry, McpOAuthConfig, McpServerEntry, PluginAuthor, PluginEntry, RootEntry, HookEntry, AgentAdapter, CatalogProvider, SecretResolver, AirExtension, AgentSessionConfig, StartCommand, PrepareSessionOptions as CorePrepareSessionOptions, PreparedSession, ValidationResult, ValidationError, ResolveOptions, SchemaType, } from "@pulsemcp/air-core";
+export type { AirConfig, ResolvedArtifacts, SkillEntry, ReferenceEntry, McpOAuthConfig, McpServerEntry, PluginAuthor, PluginEntry, RootEntry, HookEntry, AgentAdapter, CatalogProvider, AirExtension, PrepareTransform, McpConfig, TransformContext, ExtensionCliOption, AgentSessionConfig, StartCommand, PrepareSessionOptions as CorePrepareSessionOptions, PreparedSession, ValidationResult, ValidationError, ResolveOptions, SchemaType, } from "@pulsemcp/air-core";
 export { findAdapter, listAvailableAdapters } from "./adapter-registry.js";
 export { normalizeGitUrl, detectRoot } from "./root-detection.js";
 export { validateFile } from "./validate.js";
@@ -12,4 +12,11 @@ export { startSession } from "./start.js";
 export type { StartSessionOptions, StartSessionResult } from "./start.js";
 export { prepareSession } from "./prepare.js";
 export type { PrepareSessionOptions, PrepareSessionResult, } from "./prepare.js";
+export { installExtensions } from "./install.js";
+export type { InstallExtensionsOptions, InstallExtensionsResult, } from "./install.js";
+export { loadExtensions } from "./extension-loader.js";
+export type { LoadedExtensions } from "./extension-loader.js";
+export { runTransforms } from "./transform-runner.js";
+export type { RunTransformsOptions } from "./transform-runner.js";
+export { findUnresolvedVars, validateNoUnresolvedVars, unresolvedVarsMessage, } from "./validate-config.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc,EAEd,YAAY,EAEZ,aAAa,EACb,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAEV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,SAAS,EACT,SAAS,EAET,YAAY,EACZ,eAAe,EACf,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,IAAI,yBAAyB,EAClD,eAAe,EAEf,gBAAgB,EAChB,eAAe,EAEf,cAAc,EAEd,UAAU,GACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEzF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc,EAEd,YAAY,EAEZ,aAAa,EACb,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAEV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,SAAS,EACT,SAAS,EAET,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,IAAI,yBAAyB,EAClD,eAAe,EAEf,gBAAgB,EAChB,eAAe,EAEf,cAAc,EAEd,UAAU,GACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEzF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EACV,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -16,4 +16,12 @@ export { initConfig } from "./init.js";
 export { listArtifacts, VALID_ARTIFACT_TYPES } from "./list.js";
 export { startSession } from "./start.js";
 export { prepareSession } from "./prepare.js";
+// Extension installer
+export { installExtensions } from "./install.js";
+// Extension loader
+export { loadExtensions } from "./extension-loader.js";
+// Transform runner
+export { runTransforms } from "./transform-runner.js";
+// Config validation
+export { findUnresolvedVars, validateNoUnresolvedVars, unresolvedVarsMessage, } from "./validate-config.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO;AACL,oBAAoB;AACpB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc;AACd,aAAa;AACb,YAAY;AACZ,UAAU;AACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAiC5B,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE3E,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAElE,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO;AACL,oBAAoB;AACpB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc;AACd,aAAa;AACb,YAAY;AACZ,UAAU;AACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAoC5B,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE3E,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAElE,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C,sBAAsB;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAMjD,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,mBAAmB;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,oBAAoB;AACpB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,28 @@
+export interface InstallExtensionsOptions {
+    /** Path to air.json. Uses AIR_CONFIG env or ~/.air/air.json if not set. */
+    config?: string;
+    /** npm install prefix (--prefix). Defaults to the directory containing air.json. */
+    prefix?: string;
+}
+export interface InstallExtensionsResult {
+    /** Extensions that were already installed. */
+    alreadyInstalled: string[];
+    /** Extensions that were installed by this call. */
+    installed: string[];
+    /** Extensions that were skipped (local paths, not npm packages). */
+    skipped: string[];
+}
+/**
+ * Install missing extensions declared in air.json.
+ *
+ * Reads the `extensions` array from air.json, checks which npm packages
+ * are already present in node_modules, and installs any missing ones
+ * using `npm install` with the specified prefix.
+ *
+ * Local path extensions (starting with ./, ../, or /) are skipped since
+ * they don't need npm installation.
+ *
+ * @throws Error if air.json is not found, or if npm install fails.
+ */
+export declare function installExtensions(options?: InstallExtensionsOptions): Promise<InstallExtensionsResult>;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mDAAmD;IACnD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oEAAoE;IACpE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAkFD;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,uBAAuB,CAAC,CA4DlC"}

package/dist/install.js

@@ -0,0 +1,134 @@
+import { resolve, dirname, join } from "path";
+import { existsSync } from "fs";
+import { execFile } from "child_process";
+import { loadAirConfig, getAirJsonPath } from "@pulsemcp/air-core";
+/**
+ * Strip a version suffix from an npm specifier for node_modules lookup.
+ * E.g., "@scope/pkg@1.2.3" → "@scope/pkg", "pkg@^2.0.0" → "pkg".
+ * Bare specifiers without a version are returned unchanged.
+ */
+function stripVersion(specifier) {
+    // Scoped: @scope/name@version → split on the second @
+    if (specifier.startsWith("@")) {
+        const slashIdx = specifier.indexOf("/");
+        if (slashIdx !== -1) {
+            const afterSlash = specifier.slice(slashIdx + 1);
+            const atIdx = afterSlash.indexOf("@");
+            if (atIdx !== -1) {
+                return specifier.slice(0, slashIdx + 1 + atIdx);
+            }
+        }
+        return specifier;
+    }
+    // Unscoped: name@version → split on first @
+    const atIdx = specifier.indexOf("@");
+    if (atIdx > 0) {
+        return specifier.slice(0, atIdx);
+    }
+    return specifier;
+}
+/**
+ * Check if an npm package is installed under a given prefix.
+ *
+ * Checks for the package directory in `<prefix>/node_modules/<name>`.
+ * Strips version suffixes from the specifier before checking.
+ * This works for both CJS and ESM-only packages, unlike `require.resolve`
+ * which fails for packages that only export `import` conditions.
+ */
+function isPackageInstalled(specifier, prefix) {
+    const name = stripVersion(specifier);
+    return existsSync(join(prefix, "node_modules", name));
+}
+/**
+ * Check if an extension specifier is a local path (not an npm package).
+ */
+function isLocalPath(specifier) {
+    return (specifier.startsWith("./") ||
+        specifier.startsWith("../") ||
+        specifier.startsWith("/"));
+}
+/**
+ * Run `npm install` asynchronously and return a promise.
+ */
+function npmInstall(args) {
+    return new Promise((resolve, reject) => {
+        execFile("npm", ["install", ...args], { stdio: "pipe" }, (err, stdout, stderr) => {
+            if (err) {
+                reject(Object.assign(err, {
+                    stdout: stdout?.toString() ?? "",
+                    stderr: stderr?.toString() ?? "",
+                }));
+            }
+            else {
+                resolve({
+                    stdout: stdout?.toString() ?? "",
+                    stderr: stderr?.toString() ?? "",
+                });
+            }
+        });
+    });
+}
+/**
+ * Install missing extensions declared in air.json.
+ *
+ * Reads the `extensions` array from air.json, checks which npm packages
+ * are already present in node_modules, and installs any missing ones
+ * using `npm install` with the specified prefix.
+ *
+ * Local path extensions (starting with ./, ../, or /) are skipped since
+ * they don't need npm installation.
+ *
+ * @throws Error if air.json is not found, or if npm install fails.
+ */
+export async function installExtensions(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 airConfig = loadAirConfig(airJsonPath);
+    const extensions = airConfig.extensions || [];
+    if (extensions.length === 0) {
+        return { alreadyInstalled: [], installed: [], skipped: [] };
+    }
+    const prefix = options?.prefix
+        ? resolve(options.prefix)
+        : dirname(resolve(airJsonPath));
+    const alreadyInstalled = [];
+    const toInstall = [];
+    const skipped = [];
+    const seen = new Set();
+    for (const specifier of extensions) {
+        if (typeof specifier !== "string")
+            continue;
+        if (seen.has(specifier))
+            continue;
+        seen.add(specifier);
+        if (isLocalPath(specifier)) {
+            skipped.push(specifier);
+            continue;
+        }
+        if (isPackageInstalled(specifier, prefix)) {
+            alreadyInstalled.push(specifier);
+        }
+        else {
+            toInstall.push(specifier);
+        }
+    }
+    if (toInstall.length > 0) {
+        try {
+            await npmInstall(["--prefix", prefix, ...toInstall]);
+        }
+        catch (err) {
+            const stderr = err instanceof Error && "stderr" in err
+                ? String(err.stderr)
+                : "";
+            throw new Error(`npm install failed for: ${toInstall.join(", ")}${stderr ? `\n${stderr}` : ""}`);
+        }
+    }
+    return {
+        alreadyInstalled,
+        installed: toInstall,
+        skipped,
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/prepare.d.ts

@@ -1,4 +1,5 @@
 import { type RootEntry, type PreparedSession } from "@pulsemcp/air-core";
+import { type LoadedExtensions } from "./extension-loader.js";
 export interface PrepareSessionOptions {
     /** Path to air.json. Uses AIR_CONFIG env or ~/.air/air.json if not set. */
     config?: string;
@@ -17,6 +18,23 @@ export interface PrepareSessionOptions {
      * Orchestrators that manage subagent composition externally should set this.
      */
     skipSubagentMerge?: boolean;
+    /**
+     * Parsed CLI option values contributed by extensions.
+     * Passed through to transforms via TransformContext.options.
+     */
+    extensionOptions?: Record<string, unknown>;
+    /**
+     * Skip the final validation that checks for unresolved ${VAR} patterns.
+     * Use when partial resolution is intentional (e.g., orchestrators that
+     * resolve remaining variables themselves).
+     */
+    skipValidation?: boolean;
+    /**
+     * Pre-loaded extensions. When provided, the SDK skips loading extensions
+     * from air.json — useful when the CLI has already loaded them to discover
+     * contributed CLI options.
+     */
+    extensions?: LoadedExtensions;
 }
 export interface PrepareSessionResult {
     /** The prepared session result from the adapter. */
@@ -29,8 +47,9 @@ export interface PrepareSessionResult {
 /**
  * Prepare a target directory for an agent session.
  *
- * Resolves artifacts, finds/auto-detects the root, and delegates to the adapter's
- * prepareSession() to write .mcp.json, inject skills, etc.
+ * Loads extensions from air.json, resolves artifacts (using providers from
+ * extensions), delegates to the adapter's prepareSession() to write .mcp.json
+ * and inject skills, then runs transforms in declaration order.
  *
  * @throws Error if the adapter is not found, air.json is not found, or the specified root doesn't exist.
  */

package/dist/prepare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../src/prepare.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAI5B,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,OAAO,EAAE,eAAe,CAAC;IACzB,mDAAmD;IACnD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAqD/B"}
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../src/prepare.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAS9E,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,OAAO,EAAE,eAAe,CAAC;IACzB,mDAAmD;IACnD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAsG/B"}

package/dist/prepare.js

@@ -1,18 +1,42 @@
-import { resolve } from "path";
-import { getAirJsonPath, resolveArtifacts, } from "@pulsemcp/air-core";
+import { resolve, dirname } from "path";
+import { loadAirConfig, getAirJsonPath, resolveArtifacts, } from "@pulsemcp/air-core";
 import { findAdapter, listAvailableAdapters } from "./adapter-registry.js";
 import { detectRoot } from "./root-detection.js";
+import { loadExtensions } from "./extension-loader.js";
+import { runTransforms } from "./transform-runner.js";
+import { readFileSync } from "fs";
+import { findUnresolvedVars, unresolvedVarsMessage, } from "./validate-config.js";
 /**
  * Prepare a target directory for an agent session.
  *
- * Resolves artifacts, finds/auto-detects the root, and delegates to the adapter's
- * prepareSession() to write .mcp.json, inject skills, etc.
+ * Loads extensions from air.json, resolves artifacts (using providers from
+ * extensions), delegates to the adapter's prepareSession() to write .mcp.json
+ * and inject skills, then runs transforms in declaration order.
  *
  * @throws Error if the adapter is not found, air.json is not found, or the specified root doesn't exist.
  */
 export async function prepareSession(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.");
+    }
+    // Use pre-loaded extensions or load from air.json
+    let loaded;
+    if (options?.extensions) {
+        loaded = options.extensions;
+    }
+    else {
+        const airConfig = loadAirConfig(airJsonPath);
+        const airJsonDir = dirname(resolve(airJsonPath));
+        loaded = await loadExtensions(airConfig.extensions || [], airJsonDir);
+    }
+    // Find adapter: prefer extension-provided, fall back to registry
     const adapterName = options?.adapter ?? "claude";
-    const adapter = await findAdapter(adapterName);
+    let adapter = loaded.adapters.find((ext) => ext.adapter?.name === adapterName)?.adapter ??
+        null;
+    if (!adapter) {
+        adapter = await findAdapter(adapterName);
+    }
     if (!adapter) {
         const available = await listAvailableAdapters();
         const availableMsg = available.length > 0
@@ -20,11 +44,12 @@ export async function prepareSession(options) {
             : "No adapters installed";
         throw new Error(`No adapter found for "${adapterName}". ${availableMsg}.`);
     }
-    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 artifacts = await resolveArtifacts(airJsonPath);
+    // Extract providers from extensions and resolve artifacts
+    const providers = loaded.providers
+        .map((ext) => ext.provider)
+        .filter(Boolean);
+    const artifacts = await resolveArtifacts(airJsonPath, { providers });
+    // Detect or validate root
     let root;
     let rootAutoDetected = false;
     if (options?.root) {
@@ -40,12 +65,33 @@ export async function prepareSession(options) {
             rootAutoDetected = true;
         }
     }
+    // Adapter writes .mcp.json and injects skills (no secret resolution)
     const session = await adapter.prepareSession(artifacts, options?.target ?? process.cwd(), {
         root,
         skillOverrides: options?.skills,
         mcpServerOverrides: options?.mcpServers,
         skipSubagentMerge: options?.skipSubagentMerge,
     });
+    // Run transforms in extension-list order on the written .mcp.json
+    const mcpConfigPath = session.configFiles.find((f) => f.endsWith(".mcp.json"));
+    if (loaded.transforms.length > 0 && mcpConfigPath) {
+        await runTransforms({
+            transforms: loaded.transforms,
+            mcpConfigPath,
+            targetDir: options?.target ?? process.cwd(),
+            root,
+            artifacts,
+            extensionOptions: options?.extensionOptions ?? {},
+        });
+    }
+    // Final validation: ensure no unresolved ${VAR} patterns remain
+    if (!options?.skipValidation && mcpConfigPath) {
+        const config = JSON.parse(readFileSync(mcpConfigPath, "utf-8"));
+        const unresolved = findUnresolvedVars(config);
+        if (unresolved.length > 0) {
+            throw new Error(unresolvedVarsMessage(mcpConfigPath, unresolved));
+        }
+    }
     return { session, root, rootAutoDetected };
 }
 //# sourceMappingURL=prepare.js.map

package/dist/prepare.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepare.js","sourceRoot":"","sources":["../src/prepare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,gBAAgB,GAGjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AA+BjD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA+B;IAE/B,MAAM,WAAW,GAAG,OAAO,EAAE,OAAO,IAAI,QAAQ,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAChD,MAAM,YAAY,GAChB,SAAS,CAAC,MAAM,GAAG,CAAC;YAClB,CAAC,CAAC,cAAc,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACtC,CAAC,CAAC,uBAAuB,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,yBAAyB,WAAW,MAAM,YAAY,GAAG,CAC1D,CAAC;IACJ,CAAC;IAED,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,SAAS,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEtD,IAAI,IAA2B,CAAC;IAChC,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAE7B,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,SAAS,OAAO,CAAC,IAAI,iCAAiC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAC5G,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5D,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC9C,IAAI,IAAI,EAAE,CAAC;YACT,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,cAAc,CAC1C,SAAS,EACT,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,EAChC;QACE,IAAI;QACJ,cAAc,EAAE,OAAO,EAAE,MAAM;QAC/B,kBAAkB,EAAE,OAAO,EAAE,UAAU;QACvC,iBAAiB,EAAE,OAAO,EAAE,iBAAiB;KAC9C,CACF,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"prepare.js","sourceRoot":"","sources":["../src/prepare.ts"],"names":[],"mappings":"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"}

package/dist/transform-runner.d.ts

@@ -0,0 +1,24 @@
+import type { AirExtension, ResolvedArtifacts, RootEntry } from "@pulsemcp/air-core";
+export interface RunTransformsOptions {
+    /** Extensions that provide transforms, in declaration order */
+    transforms: AirExtension[];
+    /** Path to the .mcp.json file to transform */
+    mcpConfigPath: string;
+    /** Target directory being prepared */
+    targetDir: string;
+    /** Root being activated */
+    root?: RootEntry;
+    /** Full resolved artifacts */
+    artifacts: ResolvedArtifacts;
+    /** Parsed CLI option values contributed by extensions */
+    extensionOptions: Record<string, unknown>;
+}
+/**
+ * Run transforms sequentially on the written .mcp.json file.
+ *
+ * Reads the current file, pipes it through each transform in
+ * declaration order, and writes the final result back.
+ * No-op if there are no transforms.
+ */
+export declare function runTransforms(opts: RunTransformsOptions): Promise<void>;
+//# sourceMappingURL=transform-runner.d.ts.map

package/dist/transform-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-runner.d.ts","sourceRoot":"","sources":["../src/transform-runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,8BAA8B;IAC9B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B7E"}

package/dist/transform-runner.js

@@ -0,0 +1,28 @@
+import { readFileSync, writeFileSync } from "fs";
+/**
+ * Run transforms sequentially on the written .mcp.json file.
+ *
+ * Reads the current file, pipes it through each transform in
+ * declaration order, and writes the final result back.
+ * No-op if there are no transforms.
+ */
+export async function runTransforms(opts) {
+    const { transforms, mcpConfigPath, targetDir, root, artifacts, extensionOptions, } = opts;
+    if (transforms.length === 0)
+        return;
+    let config = JSON.parse(readFileSync(mcpConfigPath, "utf-8"));
+    const context = {
+        targetDir,
+        root,
+        artifacts,
+        options: extensionOptions,
+        mcpConfigPath,
+    };
+    for (const ext of transforms) {
+        if (!ext.transform)
+            continue;
+        config = await ext.transform.transform(config, context);
+    }
+    writeFileSync(mcpConfigPath, JSON.stringify(config, null, 2) + "\n");
+}
+//# sourceMappingURL=transform-runner.js.map

package/dist/transform-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-runner.js","sourceRoot":"","sources":["../src/transform-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAwBjD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA0B;IAC5D,MAAM,EACJ,UAAU,EACV,aAAa,EACb,SAAS,EACT,IAAI,EACJ,SAAS,EACT,gBAAgB,GACjB,GAAG,IAAI,CAAC;IAET,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEpC,IAAI,MAAM,GAAc,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzE,MAAM,OAAO,GAAqB;QAChC,SAAS;QACT,IAAI;QACJ,SAAS;QACT,OAAO,EAAE,gBAAgB;QACzB,aAAa;KACd,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,SAAS;YAAE,SAAS;QAC7B,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACvE,CAAC"}

package/dist/validate-config.d.ts

@@ -0,0 +1,15 @@
+import type { McpConfig } from "@pulsemcp/air-core";
+/**
+ * Find all unresolved ${VAR} patterns in an MCP config.
+ * Recursively walks all string values in the entire config object.
+ */
+export declare function findUnresolvedVars(config: McpConfig): string[];
+/**
+ * Validate that no unresolved ${VAR} patterns remain in the .mcp.json file.
+ * This is a final validation step that runs after all transforms complete.
+ *
+ * @throws Error listing all unresolved variables if any are found.
+ */
+export declare function validateNoUnresolvedVars(mcpConfigPath: string): void;
+export declare function unresolvedVarsMessage(mcpConfigPath: string, unresolved: string[]): string;
+//# sourceMappingURL=validate-config.d.ts.map

package/dist/validate-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.d.ts","sourceRoot":"","sources":["../src/validate-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAIpD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,CAM9D;AAwBD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAQpE;AAED,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,CAKR"}

package/dist/validate-config.js

@@ -0,0 +1,52 @@
+import { readFileSync } from "fs";
+const ENV_VAR_PATTERN = /\$\{([^}]+)\}/g;
+/**
+ * Find all unresolved ${VAR} patterns in an MCP config.
+ * Recursively walks all string values in the entire config object.
+ */
+export function findUnresolvedVars(config) {
+    const vars = new Set();
+    if (config.mcpServers) {
+        walkValue(config.mcpServers, vars);
+    }
+    return [...vars];
+}
+function walkValue(value, vars) {
+    if (typeof value === "string") {
+        let match;
+        ENV_VAR_PATTERN.lastIndex = 0;
+        while ((match = ENV_VAR_PATTERN.exec(value)) !== null) {
+            vars.add(match[1]);
+        }
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            walkValue(item, vars);
+        }
+        return;
+    }
+    if (value !== null && typeof value === "object") {
+        for (const v of Object.values(value)) {
+            walkValue(v, vars);
+        }
+    }
+}
+/**
+ * Validate that no unresolved ${VAR} patterns remain in the .mcp.json file.
+ * This is a final validation step that runs after all transforms complete.
+ *
+ * @throws Error listing all unresolved variables if any are found.
+ */
+export function validateNoUnresolvedVars(mcpConfigPath) {
+    const config = JSON.parse(readFileSync(mcpConfigPath, "utf-8"));
+    const unresolved = findUnresolvedVars(config);
+    if (unresolved.length > 0) {
+        throw new Error(unresolvedVarsMessage(mcpConfigPath, unresolved));
+    }
+}
+export function unresolvedVarsMessage(mcpConfigPath, unresolved) {
+    return (`Unresolved variable${unresolved.length === 1 ? "" : "s"} in ${mcpConfigPath}: ${unresolved.map((v) => `\${${v}}`).join(", ")}. ` +
+        `Ensure all variables are provided via environment or a secrets transform.`);
+}
+//# sourceMappingURL=validate-config.js.map

package/dist/validate-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.js","sourceRoot":"","sources":["../src/validate-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAGlC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,IAAiB;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC;QACV,eAAe,CAAC,SAAS,GAAG,CAAC,CAAC;QAC9B,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,EAAE,CAAC;YAChE,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,aAAqB;IAC5D,MAAM,MAAM,GAAc,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,qBAAqB,CAAC,aAAa,EAAE,UAAU,CAAC,CACjD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,UAAoB;IAEpB,OAAO,CACL,sBAAsB,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACjI,2EAA2E,CAC5E,CAAC;AACJ,CAAC"}

package/package.json

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