@pulsemcp/air-sdk 0.0.3

package/dist/adapter-registry.d.ts

@@ -0,0 +1,11 @@
+import type { AgentAdapter } from "@pulsemcp/air-core";
+/**
+ * Find an adapter by agent name.
+ * Returns null if the adapter package isn't installed.
+ */
+export declare function findAdapter(name: string): Promise<AgentAdapter | null>;
+/**
+ * List all available adapter names (installed packages only).
+ */
+export declare function listAvailableAdapters(): Promise<string[]>;
+//# sourceMappingURL=adapter-registry.d.ts.map

package/dist/adapter-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.d.ts","sourceRoot":"","sources":["../src/adapter-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,oBAAoB,CAAC;AAUrE;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAsB9B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAW/D"}

package/dist/adapter-registry.js

@@ -0,0 +1,52 @@
+/**
+ * Known adapter packages. The SDK tries to dynamically import each one.
+ * If the package is installed, its adapter is available. If not, it's skipped.
+ */
+const KNOWN_ADAPTERS = [
+    { name: "claude", packageName: "@pulsemcp/air-adapter-claude" },
+];
+/**
+ * Find an adapter by agent name.
+ * Returns null if the adapter package isn't installed.
+ */
+export async function findAdapter(name) {
+    // Check known adapters first
+    for (const known of KNOWN_ADAPTERS) {
+        if (known.name === name) {
+            try {
+                const mod = await import(known.packageName);
+                const ext = mod.default;
+                return ext?.adapter ?? null;
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    // Try convention-based package name: @pulsemcp/air-adapter-{name}
+    try {
+        const mod = await import(`@pulsemcp/air-adapter-${name}`);
+        const ext = mod.default;
+        return ext?.adapter ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all available adapter names (installed packages only).
+ */
+export async function listAvailableAdapters() {
+    const available = [];
+    for (const known of KNOWN_ADAPTERS) {
+        try {
+            await import(known.packageName);
+            available.push(known.name);
+        }
+        catch {
+            // Not installed
+        }
+    }
+    return available;
+}
+//# sourceMappingURL=adapter-registry.js.map

package/dist/adapter-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.js","sourceRoot":"","sources":["../src/adapter-registry.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,cAAc,GAA4C;IAC9D,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;CAChE,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY;IAEZ,6BAA6B;IAC7B,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAmC,CAAC;gBACpD,OAAO,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,OAAmC,CAAC;QACpD,OAAO,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAChC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { loadAirConfig, getDefaultAirJsonPath, getAirJsonPath, resolveArtifacts, mergeArtifacts, 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 { findAdapter, listAvailableAdapters } from "./adapter-registry.js";
+export { normalizeGitUrl, detectRoot } from "./root-detection.js";
+export { validateFile } from "./validate.js";
+export type { ValidateFileOptions, ValidateFileResult } from "./validate.js";
+export { initConfig } from "./init.js";
+export type { InitConfigOptions, InitConfigResult } from "./init.js";
+export { listArtifacts, VALID_ARTIFACT_TYPES } from "./list.js";
+export type { ArtifactType, ListArtifactsOptions, ListArtifactsResult } from "./list.js";
+export { startSession } from "./start.js";
+export type { StartSessionOptions, StartSessionResult } from "./start.js";
+export { prepareSession } from "./prepare.js";
+export type { PrepareSessionOptions, PrepareSessionResult, } from "./prepare.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,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"}

package/dist/index.js

@@ -0,0 +1,19 @@
+// Re-export everything from core for convenience
+export { 
+// Config resolution
+loadAirConfig, getDefaultAirJsonPath, getAirJsonPath, resolveArtifacts, mergeArtifacts, emptyArtifacts, 
+// Validation
+validateJson, 
+// Schemas
+getSchemasDir, getSchemaPath, loadSchema, detectSchemaType, detectSchemaFromValue, getAllSchemaTypes, isValidSchemaType, } from "@pulsemcp/air-core";
+// Adapter registry
+export { findAdapter, listAvailableAdapters } from "./adapter-registry.js";
+// Root detection
+export { normalizeGitUrl, detectRoot } from "./root-detection.js";
+// High-level operations
+export { validateFile } from "./validate.js";
+export { initConfig } from "./init.js";
+export { listArtifacts, VALID_ARTIFACT_TYPES } from "./list.js";
+export { startSession } from "./start.js";
+export { prepareSession } from "./prepare.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,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"}

package/dist/init.d.ts

@@ -0,0 +1,22 @@
+export interface InitConfigOptions {
+    /** Override the default air.json path (~/.air/air.json). */
+    path?: string;
+}
+export interface InitConfigResult {
+    /** Absolute path to the created air.json. */
+    airJsonPath: string;
+    /** Absolute path to the AIR config directory. */
+    airDir: string;
+    /** List of files in the config directory (relative to airDir). */
+    files: string[];
+}
+/**
+ * Initialize a new AIR configuration directory.
+ *
+ * Creates air.json and empty artifact index files at the specified
+ * path (defaults to ~/.air/).
+ *
+ * @throws Error if air.json already exists at the target path.
+ */
+export declare function initConfig(options?: InitConfigOptions): InitConfigResult;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CA8CxE"}

package/dist/init.js

@@ -0,0 +1,50 @@
+import { writeFileSync, existsSync, mkdirSync } from "fs";
+import { resolve, dirname } from "path";
+import { getDefaultAirJsonPath } from "@pulsemcp/air-core";
+/**
+ * Initialize a new AIR configuration directory.
+ *
+ * Creates air.json and empty artifact index files at the specified
+ * path (defaults to ~/.air/).
+ *
+ * @throws Error if air.json already exists at the target path.
+ */
+export function initConfig(options) {
+    const airJsonPath = options?.path ?? getDefaultAirJsonPath();
+    const airDir = dirname(airJsonPath);
+    if (existsSync(airJsonPath)) {
+        throw new Error(`${airJsonPath} already exists.`);
+    }
+    mkdirSync(airDir, { recursive: true });
+    const airJson = {
+        name: "my-config",
+        description: "",
+        skills: ["./skills/skills.json"],
+        references: ["./references/references.json"],
+        mcp: ["./mcp/mcp.json"],
+        plugins: ["./plugins/plugins.json"],
+        roots: ["./roots/roots.json"],
+        hooks: ["./hooks/hooks.json"],
+    };
+    const emptyIndex = () => "{}\n";
+    writeFileSync(airJsonPath, JSON.stringify(airJson, null, 2) + "\n");
+    const indexFiles = [
+        ["skills/skills.json", emptyIndex()],
+        ["references/references.json", emptyIndex()],
+        ["mcp/mcp.json", emptyIndex()],
+        ["plugins/plugins.json", emptyIndex()],
+        ["roots/roots.json", emptyIndex()],
+        ["hooks/hooks.json", emptyIndex()],
+    ];
+    const files = ["air.json"];
+    for (const [filename, content] of indexFiles) {
+        const filePath = resolve(airDir, filename);
+        mkdirSync(dirname(filePath), { recursive: true });
+        if (!existsSync(filePath)) {
+            writeFileSync(filePath, content);
+        }
+        files.push(filename);
+    }
+    return { airJsonPath, airDir, files };
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAgB3D;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,OAA2B;IACpD,MAAM,WAAW,GAAG,OAAO,EAAE,IAAI,IAAI,qBAAqB,EAAE,CAAC;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,GAAG,WAAW,kBAAkB,CAAC,CAAC;IACpD,CAAC;IAED,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,EAAE;QACf,MAAM,EAAE,CAAC,sBAAsB,CAAC;QAChC,UAAU,EAAE,CAAC,8BAA8B,CAAC;QAC5C,GAAG,EAAE,CAAC,gBAAgB,CAAC;QACvB,OAAO,EAAE,CAAC,wBAAwB,CAAC;QACnC,KAAK,EAAE,CAAC,oBAAoB,CAAC;QAC7B,KAAK,EAAE,CAAC,oBAAoB,CAAC;KAC9B,CAAC;IAEF,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;IAEhC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEpE,MAAM,UAAU,GAAuB;QACrC,CAAC,oBAAoB,EAAE,UAAU,EAAE,CAAC;QACpC,CAAC,4BAA4B,EAAE,UAAU,EAAE,CAAC;QAC5C,CAAC,cAAc,EAAE,UAAU,EAAE,CAAC;QAC9B,CAAC,sBAAsB,EAAE,UAAU,EAAE,CAAC;QACtC,CAAC,kBAAkB,EAAE,UAAU,EAAE,CAAC;QAClC,CAAC,kBAAkB,EAAE,UAAU,EAAE,CAAC;KACnC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC;IAE3B,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,UAAU,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3C,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/list.d.ts

@@ -0,0 +1,22 @@
+import { type ResolvedArtifacts } from "@pulsemcp/air-core";
+export type ArtifactType = "skills" | "mcp" | "plugins" | "roots" | "hooks" | "references";
+export declare const VALID_ARTIFACT_TYPES: readonly ArtifactType[];
+export interface ListArtifactsOptions {
+    /** Path to air.json. Uses AIR_CONFIG env or ~/.air/air.json if not set. */
+    config?: string;
+}
+export interface ListArtifactsResult {
+    /** The requested artifact type. */
+    type: ArtifactType;
+    /** Entries of the requested type, keyed by ID. */
+    entries: Record<string, unknown>;
+    /** The full resolved artifacts (for consumers that need cross-type access). */
+    artifacts: ResolvedArtifacts;
+}
+/**
+ * Resolve artifacts and return the entries for a specific artifact type.
+ *
+ * @throws Error if the artifact type is invalid.
+ */
+export declare function listArtifacts(type: string, options?: ListArtifactsOptions): Promise<ListArtifactsResult>;
+//# sourceMappingURL=list.d.ts.map

package/dist/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../src/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,KAAK,GACL,SAAS,GACT,OAAO,GACP,OAAO,GACP,YAAY,CAAC;AAEjB,eAAO,MAAM,oBAAoB,EAAE,SAAS,YAAY,EAO9C,CAAC;AAEX,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,+EAA+E;IAC/E,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAmB9B"}

package/dist/list.js

@@ -0,0 +1,30 @@
+import { getAirJsonPath, resolveArtifacts, emptyArtifacts, } from "@pulsemcp/air-core";
+export const VALID_ARTIFACT_TYPES = [
+    "skills",
+    "mcp",
+    "plugins",
+    "roots",
+    "hooks",
+    "references",
+];
+/**
+ * Resolve artifacts and return the entries for a specific artifact type.
+ *
+ * @throws Error if the artifact type is invalid.
+ */
+export async function listArtifacts(type, options) {
+    if (!VALID_ARTIFACT_TYPES.includes(type)) {
+        throw new Error(`Unknown artifact type "${type}". Valid types: ${VALID_ARTIFACT_TYPES.join(", ")}`);
+    }
+    const airJsonPath = options?.config || getAirJsonPath();
+    const artifacts = airJsonPath
+        ? await resolveArtifacts(airJsonPath)
+        : emptyArtifacts();
+    const artifactType = type;
+    return {
+        type: artifactType,
+        entries: artifacts[artifactType],
+        artifacts,
+    };
+}
+//# sourceMappingURL=list.js.map

package/dist/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../src/list.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,GAEf,MAAM,oBAAoB,CAAC;AAU5B,MAAM,CAAC,MAAM,oBAAoB,GAA4B;IAC3D,QAAQ;IACR,KAAK;IACL,SAAS;IACT,OAAO;IACP,OAAO;IACP,YAAY;CACJ,CAAC;AAgBX;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,OAA8B;IAE9B,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAoB,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,mBAAmB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,CAAC;IACxD,MAAM,SAAS,GAAG,WAAW;QAC3B,CAAC,CAAC,MAAM,gBAAgB,CAAC,WAAW,CAAC;QACrC,CAAC,CAAC,cAAc,EAAE,CAAC;IAErB,MAAM,YAAY,GAAG,IAAoB,CAAC;IAE1C,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,SAAS,CAAC,YAAY,CAAC;QAChC,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/prepare.d.ts

@@ -0,0 +1,33 @@
+import { type RootEntry, type PreparedSession } from "@pulsemcp/air-core";
+export interface PrepareSessionOptions {
+    /** Path to air.json. Uses AIR_CONFIG env or ~/.air/air.json if not set. */
+    config?: string;
+    /** Root to activate by name. Auto-detected from targetDir's git context if omitted. */
+    root?: string;
+    /** Target directory to prepare. Defaults to process.cwd(). */
+    target?: string;
+    /** Agent adapter name. Defaults to "claude". */
+    adapter?: string;
+    /** Skill IDs to activate (overrides root defaults). */
+    skills?: string[];
+    /** MCP server IDs to activate (overrides root defaults). */
+    mcpServers?: string[];
+}
+export interface PrepareSessionResult {
+    /** The prepared session result from the adapter. */
+    session: PreparedSession;
+    /** The auto-detected or specified root, if any. */
+    root?: RootEntry;
+    /** Whether the root was auto-detected (true) or explicitly specified (false/undefined). */
+    rootAutoDetected?: boolean;
+}
+/**
+ * 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.
+ *
+ * @throws Error if the adapter is not found, air.json is not found, or the specified root doesn't exist.
+ */
+export declare function prepareSession(options?: PrepareSessionOptions): Promise<PrepareSessionResult>;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/prepare.d.ts.map

@@ -0,0 +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;CACvB;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,CAoD/B"}

package/dist/prepare.js

@@ -0,0 +1,50 @@
+import { resolve } from "path";
+import { getAirJsonPath, resolveArtifacts, } from "@pulsemcp/air-core";
+import { findAdapter, listAvailableAdapters } from "./adapter-registry.js";
+import { detectRoot } from "./root-detection.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.
+ *
+ * @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 adapterName = options?.adapter ?? "claude";
+    const adapter = await findAdapter(adapterName);
+    if (!adapter) {
+        const available = await listAvailableAdapters();
+        const availableMsg = available.length > 0
+            ? `Available: ${available.join(", ")}`
+            : "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);
+    let root;
+    let rootAutoDetected = false;
+    if (options?.root) {
+        root = artifacts.roots[options.root];
+        if (!root) {
+            throw new Error(`Root "${options.root}" not found. Available roots: ${Object.keys(artifacts.roots).join(", ") || "(none)"}`);
+        }
+    }
+    else {
+        const targetDir = resolve(options?.target ?? process.cwd());
+        root = detectRoot(artifacts.roots, targetDir);
+        if (root) {
+            rootAutoDetected = true;
+        }
+    }
+    const session = await adapter.prepareSession(artifacts, options?.target ?? process.cwd(), {
+        root,
+        skillOverrides: options?.skills,
+        mcpServerOverrides: options?.mcpServers,
+    });
+    return { session, root, rootAutoDetected };
+}
+//# sourceMappingURL=prepare.js.map

package/dist/prepare.js.map

@@ -0,0 +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;AA0BjD;;;;;;;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;KACxC,CACF,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;AAC7C,CAAC"}

package/dist/root-detection.d.ts

@@ -0,0 +1,19 @@
+import type { RootEntry } from "@pulsemcp/air-core";
+/**
+ * Normalize a git remote URL to a comparable form: "github.com/owner/repo"
+ * Handles HTTPS, SSH (git@), and trailing .git.
+ */
+export declare function normalizeGitUrl(url: string): string;
+/**
+ * Detect which root matches the current git repository and subdirectory.
+ *
+ * Algorithm:
+ * 1. Get the git remote URL and relative subdirectory from targetDir
+ * 2. Normalize the URL and compare against all root URLs
+ * 3. Among roots with matching URLs, pick the best subdirectory match:
+ *    - Exact match (root.subdirectory === current subdirectory)
+ *    - Longest prefix match
+ *    - Root-level (no subdirectory / empty subdirectory)
+ */
+export declare function detectRoot(roots: Record<string, RootEntry>, targetDir: string): RootEntry | undefined;
+//# sourceMappingURL=root-detection.d.ts.map

package/dist/root-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-detection.d.ts","sourceRoot":"","sources":["../src/root-detection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkBnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAChC,SAAS,EAAE,MAAM,GAChB,SAAS,GAAG,SAAS,CAkEvB"}

package/dist/root-detection.js

@@ -0,0 +1,98 @@
+import { execSync } from "child_process";
+/**
+ * Normalize a git remote URL to a comparable form: "github.com/owner/repo"
+ * Handles HTTPS, SSH (git@), and trailing .git.
+ */
+export function normalizeGitUrl(url) {
+    let normalized = url.trim();
+    // SSH format: git@github.com:owner/repo.git → github.com/owner/repo
+    const sshMatch = normalized.match(/^git@([^:]+):(.+)$/);
+    if (sshMatch) {
+        normalized = `${sshMatch[1]}/${sshMatch[2]}`;
+    }
+    else {
+        // HTTPS format: https://github.com/owner/repo.git → github.com/owner/repo
+        normalized = normalized.replace(/^https?:\/\//, "");
+    }
+    // Strip trailing .git
+    normalized = normalized.replace(/\.git$/, "");
+    // Strip trailing slash
+    normalized = normalized.replace(/\/$/, "");
+    return normalized;
+}
+/**
+ * Detect which root matches the current git repository and subdirectory.
+ *
+ * Algorithm:
+ * 1. Get the git remote URL and relative subdirectory from targetDir
+ * 2. Normalize the URL and compare against all root URLs
+ * 3. Among roots with matching URLs, pick the best subdirectory match:
+ *    - Exact match (root.subdirectory === current subdirectory)
+ *    - Longest prefix match
+ *    - Root-level (no subdirectory / empty subdirectory)
+ */
+export function detectRoot(roots, targetDir) {
+    let remoteUrl;
+    let relativeDir;
+    try {
+        remoteUrl = execSync("git remote get-url origin", {
+            cwd: targetDir,
+            stdio: ["pipe", "pipe", "pipe"],
+            encoding: "utf-8",
+        }).trim();
+    }
+    catch {
+        // Not in a git repo or no remote — can't auto-detect
+        return undefined;
+    }
+    try {
+        relativeDir = execSync("git rev-parse --show-prefix", {
+            cwd: targetDir,
+            stdio: ["pipe", "pipe", "pipe"],
+            encoding: "utf-8",
+        }).trim();
+        // Remove trailing slash
+        relativeDir = relativeDir.replace(/\/$/, "");
+    }
+    catch {
+        relativeDir = "";
+    }
+    const normalizedRemote = normalizeGitUrl(remoteUrl);
+    // Find all roots whose URL matches this repo
+    const matchingRoots = [];
+    for (const root of Object.values(roots)) {
+        if (!root.url)
+            continue;
+        const normalizedRootUrl = normalizeGitUrl(root.url);
+        if (normalizedRemote === normalizedRootUrl) {
+            matchingRoots.push(root);
+        }
+    }
+    if (matchingRoots.length === 0)
+        return undefined;
+    // Find best subdirectory match
+    // Priority: exact match → longest prefix → root-level (no/empty subdirectory)
+    const rootSubdir = (r) => (r.subdirectory || "").replace(/\/$/, "");
+    // 1. Exact match
+    const exact = matchingRoots.find((r) => rootSubdir(r) === relativeDir);
+    if (exact)
+        return exact;
+    // 2. Longest prefix match (current dir is within root's subdirectory)
+    const prefixMatches = matchingRoots
+        .filter((r) => {
+        const sub = rootSubdir(r);
+        if (!sub)
+            return false;
+        return relativeDir.startsWith(sub + "/") || relativeDir === sub;
+    })
+        .sort((a, b) => rootSubdir(b).length - rootSubdir(a).length);
+    if (prefixMatches.length > 0)
+        return prefixMatches[0];
+    // 3. Root-level fallback (root with no subdirectory)
+    const rootLevel = matchingRoots.find((r) => !rootSubdir(r));
+    if (rootLevel)
+        return rootLevel;
+    // 4. Any matching root as last resort
+    return matchingRoots[0];
+}
+//# sourceMappingURL=root-detection.js.map

package/dist/root-detection.js.map

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

package/dist/start.d.ts

@@ -0,0 +1,33 @@
+import { type ResolvedArtifacts, type RootEntry, type AgentSessionConfig, type StartCommand } from "@pulsemcp/air-core";
+export interface StartSessionOptions {
+    /** Root to activate by name. */
+    root?: string;
+    /** Path to air.json. Uses AIR_CONFIG env or ~/.air/air.json if not set. */
+    config?: string;
+    /** Check whether the agent CLI is installed. Defaults to true. */
+    checkAvailability?: boolean;
+}
+export interface StartSessionResult {
+    /** The resolved artifacts. */
+    artifacts: ResolvedArtifacts;
+    /** The matched root, if any. */
+    root?: RootEntry;
+    /** The generated session config. */
+    sessionConfig: AgentSessionConfig;
+    /** Whether the agent CLI is available on PATH. Undefined if checkAvailability was false. */
+    agentAvailable: boolean | undefined;
+    /** The command to start the agent. */
+    startCommand: StartCommand;
+    /** The agent adapter display name. */
+    adapterDisplayName: string;
+}
+/**
+ * Prepare to start an agent session.
+ *
+ * Resolves artifacts, finds the adapter, generates config, checks availability,
+ * and builds the start command. Does NOT actually execute the agent.
+ *
+ * @throws Error if the adapter is not found or the specified root doesn't exist.
+ */
+export declare function startSession(agent: string, options?: StartSessionOptions): Promise<StartSessionResult>;
+//# sourceMappingURL=start.d.ts.map

package/dist/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,gCAAgC;IAChC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,oCAAoC;IACpC,aAAa,EAAE,kBAAkB,CAAC;IAClC,4FAA4F;IAC5F,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,sCAAsC;IACtC,YAAY,EAAE,YAAY,CAAC;IAC3B,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CA2C7B"}

package/dist/start.js

@@ -0,0 +1,46 @@
+import { getAirJsonPath, resolveArtifacts, emptyArtifacts, } from "@pulsemcp/air-core";
+import { findAdapter, listAvailableAdapters } from "./adapter-registry.js";
+/**
+ * Prepare to start an agent session.
+ *
+ * Resolves artifacts, finds the adapter, generates config, checks availability,
+ * and builds the start command. Does NOT actually execute the agent.
+ *
+ * @throws Error if the adapter is not found or the specified root doesn't exist.
+ */
+export async function startSession(agent, options) {
+    const adapter = await findAdapter(agent);
+    if (!adapter) {
+        const available = await listAvailableAdapters();
+        const availableMsg = available.length > 0
+            ? `Available: ${available.join(", ")}`
+            : "No adapters installed";
+        throw new Error(`No adapter found for "${agent}". ${availableMsg}.\n` +
+            `Install an adapter: npm install @pulsemcp/air-adapter-${agent}`);
+    }
+    const airJsonPath = options?.config || getAirJsonPath();
+    const artifacts = airJsonPath
+        ? await resolveArtifacts(airJsonPath)
+        : emptyArtifacts();
+    let root;
+    if (options?.root) {
+        root = artifacts.roots[options.root];
+        if (!root) {
+            throw new Error(`Root "${options.root}" not found. Available roots: ${Object.keys(artifacts.roots).join(", ") || "(none)"}`);
+        }
+    }
+    const sessionConfig = adapter.generateConfig(artifacts, root);
+    const agentAvailable = (options?.checkAvailability ?? true)
+        ? await adapter.isAvailable()
+        : undefined;
+    const startCommand = adapter.buildStartCommand(sessionConfig);
+    return {
+        artifacts,
+        root,
+        sessionConfig,
+        agentAvailable,
+        startCommand,
+        adapterDisplayName: adapter.displayName,
+    };
+}
+//# sourceMappingURL=start.js.map

package/dist/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,GAKf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AA0B3E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAa,EACb,OAA6B;IAE7B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;IACzC,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,KAAK,MAAM,YAAY,KAAK;YACnD,yDAAyD,KAAK,EAAE,CACnE,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,CAAC;IACxD,MAAM,SAAS,GAAG,WAAW;QAC3B,CAAC,CAAC,MAAM,gBAAgB,CAAC,WAAW,CAAC;QACrC,CAAC,CAAC,cAAc,EAAE,CAAC;IAErB,IAAI,IAA2B,CAAC;IAChC,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;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,iBAAiB,IAAI,IAAI,CAAC;QACzD,CAAC,CAAC,MAAM,OAAO,CAAC,WAAW,EAAE;QAC7B,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAE9D,OAAO;QACL,SAAS;QACT,IAAI;QACJ,aAAa;QACb,cAAc;QACd,YAAY;QACZ,kBAAkB,EAAE,OAAO,CAAC,WAAW;KACxC,CAAC;AACJ,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,27 @@
+import { type SchemaType, type ValidationResult } from "@pulsemcp/air-core";
+export interface ValidateFileOptions {
+    /** Override schema type detection. */
+    schema?: string;
+    /** Base directory for resolving relative file paths. Defaults to process.cwd(). */
+    cwd?: string;
+}
+export interface ValidateFileResult {
+    /** Whether the file is valid against the detected/specified schema. */
+    valid: boolean;
+    /** The schema type used for validation. */
+    schemaType: SchemaType;
+    /** Validation result from core (includes errors if invalid). */
+    validation: ValidationResult;
+}
+/**
+ * Validate a JSON file against its AIR schema.
+ *
+ * Schema detection order:
+ * 1. Explicit `options.schema` override
+ * 2. `$schema` field in the JSON content
+ * 3. Filename substring matching
+ *
+ * @throws Error if the file cannot be read/parsed, schema type is invalid, or schema cannot be detected.
+ */
+export declare function validateFile(file: string, options?: ValidateFileOptions): ValidateFileResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,2CAA2C;IAC3C,UAAU,EAAE,UAAU,CAAC;IACvB,gEAAgE;IAChE,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,kBAAkB,CAsDpB"}

package/dist/validate.js

@@ -0,0 +1,56 @@
+import { readFileSync } from "fs";
+import { resolve } from "path";
+import { detectSchemaType, detectSchemaFromValue, isValidSchemaType, validateJson, } from "@pulsemcp/air-core";
+/**
+ * Validate a JSON file against its AIR schema.
+ *
+ * Schema detection order:
+ * 1. Explicit `options.schema` override
+ * 2. `$schema` field in the JSON content
+ * 3. Filename substring matching
+ *
+ * @throws Error if the file cannot be read/parsed, schema type is invalid, or schema cannot be detected.
+ */
+export function validateFile(file, options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const filePath = resolve(cwd, file);
+    let data;
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        data = JSON.parse(content);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Unknown error";
+        throw new Error(`Could not read or parse "${file}": ${message}`);
+    }
+    // Determine schema type: explicit option > $schema in JSON > filename substring
+    let schemaType = null;
+    if (options?.schema) {
+        if (!isValidSchemaType(options.schema)) {
+            throw new Error(`Unknown schema type "${options.schema}". Valid types: air, skills, references, mcp, plugins, roots, hooks`);
+        }
+        schemaType = options.schema;
+    }
+    if (!schemaType &&
+        data &&
+        typeof data === "object" &&
+        !Array.isArray(data)) {
+        const schemaValue = data.$schema;
+        if (typeof schemaValue === "string") {
+            schemaType = detectSchemaFromValue(schemaValue);
+        }
+    }
+    if (!schemaType) {
+        schemaType = detectSchemaType(file);
+    }
+    if (!schemaType) {
+        throw new Error(`Could not detect schema type for "${file}". Specify a schema type explicitly.`);
+    }
+    const validation = validateJson(data, schemaType);
+    return {
+        valid: validation.valid,
+        schemaType,
+        validation,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAkB5B;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,OAA6B;IAE7B,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAEpC,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,MAAM,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,gFAAgF;IAChF,IAAI,UAAU,GAAsB,IAAI,CAAC;IAEzC,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,wBAAwB,OAAO,CAAC,MAAM,qEAAqE,CAC5G,CAAC;QACJ,CAAC;QACD,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,IACE,CAAC,UAAU;QACX,IAAI;QACJ,OAAO,IAAI,KAAK,QAAQ;QACxB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EACpB,CAAC;QACD,MAAM,WAAW,GAAI,IAAgC,CAAC,OAAO,CAAC;QAC9D,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpC,UAAU,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,qCAAqC,IAAI,sCAAsC,CAChF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAElD,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,UAAU;QACV,UAAU;KACX,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@pulsemcp/air-sdk",
+  "version": "0.0.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pulsemcp/air.git",
+    "directory": "packages/sdk"
+  },
+  "description": "AIR SDK — programmatic API for the Agent Infrastructure Repository framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@pulsemcp/air-core": "0.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}