@pulsemcp/air-core 0.0.1

package/README.md

@@ -0,0 +1,60 @@
+# @pulsemcp/air-core
+
+Core package for the [AIR](https://github.com/pulsemcp/air) framework. Provides config resolution, validation, JSON schemas, and extension interfaces.
+
+## Installation
+
+```bash
+npm install @pulsemcp/air-core
+```
+
+## Usage
+
+```typescript
+import {
+  resolveArtifacts,
+  validateJson,
+  mergeArtifacts,
+  emptyArtifacts,
+} from "@pulsemcp/air-core";
+
+// Resolve all artifacts from an air.json file
+const artifacts = await resolveArtifacts("~/.air/air.json");
+
+// Validate a JSON file against its AIR schema
+const result = validateJson(data, "skills");
+
+// Merge two artifact sets (later wins for matching IDs)
+const merged = mergeArtifacts(base, override);
+```
+
+### With a Catalog Provider (remote URIs)
+
+```typescript
+import { resolveArtifacts } from "@pulsemcp/air-core";
+import { GitHubCatalogProvider } from "@pulsemcp/air-provider-github";
+
+const artifacts = await resolveArtifacts("./air.json", {
+  providers: [new GitHubCatalogProvider()],
+});
+```
+
+## What's in this package
+
+- **Config resolution** — `resolveArtifacts()`, `loadAirConfig()`, `mergeArtifacts()`, `emptyArtifacts()`
+- **Validation** — `validateJson()` using AJV against AIR JSON Schemas
+- **Schema utilities** — `loadSchema()`, `detectSchemaType()`, `detectSchemaFromValue()`
+- **All artifact types** — `SkillEntry`, `McpServerEntry`, `RootEntry`, `ReferenceEntry`, `PluginEntry`, `HookEntry`
+- **Extension interfaces** — `AgentAdapter`, `CatalogProvider`, `SecretResolver`, `AirExtension`
+- **Session types** — `AgentSessionConfig`, `StartCommand`, `PrepareSessionOptions`, `PreparedSession`
+
+## Extension Interfaces
+
+Core defines four extension points that other packages implement:
+
+| Interface | Purpose | Example |
+|-----------|---------|---------|
+| `AgentAdapter` | Translate AIR config for a specific agent | `@pulsemcp/air-adapter-claude` |
+| `CatalogProvider` | Resolve remote URIs in air.json | `@pulsemcp/air-provider-github` |
+| `SecretResolver` | Resolve `${VAR}` interpolation | Custom vault integrations |
+| `AirExtension` | Extension metadata for CLI discovery | All extension packages |

package/dist/config.d.ts

@@ -0,0 +1,27 @@
+import type { AirConfig, ResolvedArtifacts, CatalogProvider } from "./types.js";
+export declare function loadAirConfig(airJsonPath: string): AirConfig;
+/**
+ * Default path to the user-level air.json.
+ */
+export declare function getDefaultAirJsonPath(): string;
+/**
+ * Get the air.json path, respecting AIR_CONFIG env var override.
+ * Returns null if the file doesn't exist.
+ */
+export declare function getAirJsonPath(): string | null;
+export interface ResolveOptions {
+    /** Catalog providers for resolving remote URIs (github://, s3://, etc.) */
+    providers?: CatalogProvider[];
+}
+/**
+ * Resolve all artifacts from an air.json file.
+ * Each artifact property is an array of paths; files merge in order.
+ * Remote URIs are delegated to the matching CatalogProvider.
+ */
+export declare function resolveArtifacts(airJsonPath: string, options?: ResolveOptions): Promise<ResolvedArtifacts>;
+/**
+ * Merge two resolved artifact sets. Override wins for matching IDs.
+ */
+export declare function mergeArtifacts(base: ResolvedArtifacts, override: ResolvedArtifacts): ResolvedArtifacts;
+export declare function emptyArtifacts(): ResolvedArtifacts;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EAOjB,eAAe,EAChB,MAAM,YAAY,CAAC;AAiEpB,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAG5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAG9C;AAED,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAqC5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,iBAAiB,GAC1B,iBAAiB,CASnB;AAED,wBAAgB,cAAc,IAAI,iBAAiB,CASlD"}

package/dist/config.js

@@ -0,0 +1,112 @@
+import { readFileSync, existsSync } from "fs";
+import { resolve, dirname } from "path";
+function loadJsonFile(filePath) {
+    if (!existsSync(filePath)) {
+        return {};
+    }
+    const content = readFileSync(filePath, "utf-8");
+    return JSON.parse(content);
+}
+function stripSchema(data) {
+    const { $schema, ...rest } = data;
+    return rest;
+}
+/**
+ * Check if a path string contains a URI scheme (e.g., "github://", "s3://").
+ */
+function getScheme(path) {
+    const match = path.match(/^([a-zA-Z][a-zA-Z0-9+\-.]*):\/\//);
+    if (!match)
+        return null;
+    const scheme = match[1].toLowerCase();
+    // "file" scheme is handled as local filesystem, not a provider
+    if (scheme === "file")
+        return null;
+    return scheme;
+}
+/**
+ * Load and merge entries from an array of index file paths.
+ * Local paths are resolved relative to baseDir.
+ * URI paths (with schemes) are delegated to the matching CatalogProvider.
+ */
+async function loadAndMerge(paths, baseDir, providers) {
+    let merged = {};
+    for (const p of paths) {
+        const scheme = getScheme(p);
+        let data;
+        if (scheme) {
+            const provider = providers.find((prov) => prov.scheme === scheme);
+            if (!provider) {
+                throw new Error(`No catalog provider registered for scheme "${scheme}://" (path: ${p}). ` +
+                    `Install an extension that handles this scheme.`);
+            }
+            data = await provider.resolve(p, baseDir);
+        }
+        else {
+            data = loadJsonFile(resolve(baseDir, p));
+        }
+        const entries = stripSchema(data);
+        merged = { ...merged, ...entries };
+    }
+    return merged;
+}
+export function loadAirConfig(airJsonPath) {
+    const content = readFileSync(airJsonPath, "utf-8");
+    return JSON.parse(content);
+}
+/**
+ * Default path to the user-level air.json.
+ */
+export function getDefaultAirJsonPath() {
+    return resolve(process.env.HOME || process.env.USERPROFILE || "~", ".air", "air.json");
+}
+/**
+ * Get the air.json path, respecting AIR_CONFIG env var override.
+ * Returns null if the file doesn't exist.
+ */
+export function getAirJsonPath() {
+    const path = process.env.AIR_CONFIG || getDefaultAirJsonPath();
+    return existsSync(path) ? path : null;
+}
+/**
+ * Resolve all artifacts from an air.json file.
+ * Each artifact property is an array of paths; files merge in order.
+ * Remote URIs are delegated to the matching CatalogProvider.
+ */
+export async function resolveArtifacts(airJsonPath, options) {
+    const airConfig = loadAirConfig(airJsonPath);
+    const baseDir = dirname(resolve(airJsonPath));
+    const providers = options?.providers || [];
+    return {
+        skills: await loadAndMerge(airConfig.skills || [], baseDir, providers),
+        references: await loadAndMerge(airConfig.references || [], baseDir, providers),
+        mcp: await loadAndMerge(airConfig.mcp || [], baseDir, providers),
+        plugins: await loadAndMerge(airConfig.plugins || [], baseDir, providers),
+        roots: await loadAndMerge(airConfig.roots || [], baseDir, providers),
+        hooks: await loadAndMerge(airConfig.hooks || [], baseDir, providers),
+    };
+}
+/**
+ * Merge two resolved artifact sets. Override wins for matching IDs.
+ */
+export function mergeArtifacts(base, override) {
+    return {
+        skills: { ...base.skills, ...override.skills },
+        references: { ...base.references, ...override.references },
+        mcp: { ...base.mcp, ...override.mcp },
+        plugins: { ...base.plugins, ...override.plugins },
+        roots: { ...base.roots, ...override.roots },
+        hooks: { ...base.hooks, ...override.hooks },
+    };
+}
+export function emptyArtifacts() {
+    return {
+        skills: {},
+        references: {},
+        mcp: {},
+        plugins: {},
+        roots: {},
+        hooks: {},
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { AirConfig, ResolvedArtifacts, SkillEntry, ReferenceEntry, McpOAuthConfig, McpServerEntry, PluginEntry, RootEntry, HookEntry, } from "./types.js";
+export type { AgentAdapter, CatalogProvider, SecretResolver, AirExtension, AgentSessionConfig, StartCommand, PrepareSessionOptions, PreparedSession, } from "./types.js";
+export { loadAirConfig, getDefaultAirJsonPath, getAirJsonPath, resolveArtifacts, mergeArtifacts, emptyArtifacts, } from "./config.js";
+export type { ResolveOptions } from "./config.js";
+export { validateJson } from "./validator.js";
+export type { ValidationResult, ValidationError } from "./validator.js";
+export { getSchemasDir, getSchemaPath, loadSchema, detectSchemaType, detectSchemaFromValue, getAllSchemaTypes, isValidSchemaType, } from "./schemas.js";
+export type { SchemaType } from "./schemas.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,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Config resolution
+export { loadAirConfig, getDefaultAirJsonPath, getAirJsonPath, resolveArtifacts, mergeArtifacts, emptyArtifacts, } from "./config.js";
+// Validation
+export { validateJson } from "./validator.js";
+// Schemas
+export { getSchemasDir, getSchemaPath, loadSchema, detectSchemaType, detectSchemaFromValue, getAllSchemaTypes, isValidSchemaType, } from "./schemas.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":"AAyBA,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,UAAU;AACV,OAAO,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,12 @@
+export type SchemaType = "air" | "skills" | "references" | "mcp" | "plugins" | "roots" | "hooks";
+export declare function getSchemasDir(): string;
+export declare function getSchemaPath(type: SchemaType): string;
+export declare function loadSchema(type: SchemaType): object;
+export declare function detectSchemaType(filename: string): SchemaType | null;
+/**
+ * Detect schema type from a $schema value in JSON content.
+ */
+export declare function detectSchemaFromValue(schemaValue: string): SchemaType | null;
+export declare function getAllSchemaTypes(): SchemaType[];
+export declare function isValidSchemaType(type: string): type is SchemaType;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAgCA,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,QAAQ,GACR,YAAY,GACZ,KAAK,GACL,SAAS,GACT,OAAO,GACP,OAAO,CAAC;AAuBZ,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEtD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAInD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAQpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAQ5E;AAED,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CAEhD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,UAAU,CAElE"}

package/dist/schemas.js

@@ -0,0 +1,84 @@
+import { readFileSync, existsSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Resolve the schemas directory.
+ * In development: ../schemas (relative to src/)
+ * In published package: ../schemas (copied by prepare script)
+ * Fallback: ../../schemas (monorepo root)
+ */
+function findSchemasDir() {
+    // Check sibling of dist/ or src/ (published package or local dev)
+    const localSchemas = resolve(__dirname, "../schemas");
+    if (existsSync(localSchemas)) {
+        return localSchemas;
+    }
+    // Fallback: monorepo root schemas/
+    const monorepoSchemas = resolve(__dirname, "../../../schemas");
+    if (existsSync(monorepoSchemas)) {
+        return monorepoSchemas;
+    }
+    throw new Error("Could not find AIR schemas directory. Checked:\n" +
+        `  ${localSchemas}\n` +
+        `  ${monorepoSchemas}`);
+}
+const schemasDir = findSchemasDir();
+const SCHEMA_FILES = {
+    air: "air.schema.json",
+    skills: "skills.schema.json",
+    references: "references.schema.json",
+    mcp: "mcp.schema.json",
+    plugins: "plugins.schema.json",
+    roots: "roots.schema.json",
+    hooks: "hooks.schema.json",
+};
+// Substrings to match against filenames (checked in order, longest first to avoid false matches)
+const SCHEMA_SUBSTRINGS = [
+    ["references", "references"],
+    ["plugins", "plugins"],
+    ["skills", "skills"],
+    ["roots", "roots"],
+    ["hooks", "hooks"],
+    ["mcp", "mcp"],
+    ["air", "air"],
+];
+export function getSchemasDir() {
+    return schemasDir;
+}
+export function getSchemaPath(type) {
+    return resolve(schemasDir, SCHEMA_FILES[type]);
+}
+export function loadSchema(type) {
+    const schemaPath = getSchemaPath(type);
+    const content = readFileSync(schemaPath, "utf-8");
+    return JSON.parse(content);
+}
+export function detectSchemaType(filename) {
+    const basename = (filename.split("/").pop() || filename).toLowerCase();
+    for (const [substring, type] of SCHEMA_SUBSTRINGS) {
+        if (basename.includes(substring)) {
+            return type;
+        }
+    }
+    return null;
+}
+/**
+ * Detect schema type from a $schema value in JSON content.
+ */
+export function detectSchemaFromValue(schemaValue) {
+    const lower = schemaValue.toLowerCase();
+    for (const type of getAllSchemaTypes()) {
+        if (lower.includes(SCHEMA_FILES[type])) {
+            return type;
+        }
+    }
+    return null;
+}
+export function getAllSchemaTypes() {
+    return Object.keys(SCHEMA_FILES);
+}
+export function isValidSchemaType(type) {
+    return type in SCHEMA_FILES;
+}
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,SAAS,cAAc;IACrB,kEAAkE;IAClE,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,mCAAmC;IACnC,MAAM,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAC/D,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,kDAAkD;QAChD,KAAK,YAAY,IAAI;QACrB,KAAK,eAAe,EAAE,CACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;AAWpC,MAAM,YAAY,GAA+B;IAC/C,GAAG,EAAE,iBAAiB;IACtB,MAAM,EAAE,oBAAoB;IAC5B,UAAU,EAAE,wBAAwB;IACpC,GAAG,EAAE,iBAAiB;IACtB,OAAO,EAAE,qBAAqB;IAC9B,KAAK,EAAE,mBAAmB;IAC1B,KAAK,EAAE,mBAAmB;CAC3B,CAAC;AAEF,iGAAiG;AACjG,MAAM,iBAAiB,GAA2B;IAChD,CAAC,YAAY,EAAE,YAAY,CAAC;IAC5B,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACpB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,KAAK,EAAE,KAAK,CAAC;IACd,CAAC,KAAK,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAgB;IAC5C,OAAO,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACvE,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAClD,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,CAAiB,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,IAAI,YAAY,CAAC;AAC9B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,175 @@
+export interface AirConfig {
+    name: string;
+    description?: string;
+    skills?: string[];
+    references?: string[];
+    mcp?: string[];
+    plugins?: string[];
+    roots?: string[];
+    hooks?: string[];
+}
+export interface ResolvedArtifacts {
+    skills: Record<string, SkillEntry>;
+    references: Record<string, ReferenceEntry>;
+    mcp: Record<string, McpServerEntry>;
+    plugins: Record<string, PluginEntry>;
+    roots: Record<string, RootEntry>;
+    hooks: Record<string, HookEntry>;
+}
+export interface SkillEntry {
+    id: string;
+    title?: string;
+    description: string;
+    path: string;
+    references?: string[];
+}
+export interface ReferenceEntry {
+    id: string;
+    title?: string;
+    description: string;
+    file: string;
+}
+export interface McpOAuthConfig {
+    clientId?: string;
+    scopes?: string[];
+    redirectUri?: string;
+}
+export interface McpServerEntry {
+    title?: string;
+    description?: string;
+    type: "stdio" | "sse" | "streamable-http";
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+    oauth?: McpOAuthConfig;
+}
+export interface PluginEntry {
+    id: string;
+    title?: string;
+    description: string;
+    type: "command";
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    timeout_seconds?: number;
+}
+export interface RootEntry {
+    name: string;
+    display_name?: string;
+    description: string;
+    url?: string;
+    default_branch?: string;
+    subdirectory?: string;
+    default_mcp_servers?: string[];
+    default_skills?: string[];
+    default_plugins?: string[];
+    default_hooks?: string[];
+    user_invocable?: boolean;
+    default_stop_condition?: string;
+}
+export interface HookEntry {
+    id: string;
+    title?: string;
+    description: string;
+    event: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    timeout_seconds?: number;
+    matcher?: string;
+}
+/**
+ * Agent Adapter — translates AIR artifacts into agent-specific config
+ * and knows how to start the agent process.
+ *
+ * Implementations: @pulsemcp/air-adapter-claude, etc.
+ */
+export interface AgentAdapter {
+    /** Unique name for this adapter (e.g., "claude", "opencode") */
+    name: string;
+    /** Human-readable display name (e.g., "Claude Code") */
+    displayName: string;
+    /** Check if the agent CLI is installed and available */
+    isAvailable(): Promise<boolean>;
+    /** Translate resolved AIR artifacts into agent-specific session config */
+    generateConfig(artifacts: ResolvedArtifacts, root?: RootEntry, workDir?: string): AgentSessionConfig;
+    /** Build the shell command to start the agent */
+    buildStartCommand(config: AgentSessionConfig): StartCommand;
+    /**
+     * Prepare a working directory for an agent session.
+     * Writes all files the agent needs: MCP config, skills, hooks, plugins.
+     * This is the single entry point for session setup — the adapter owns
+     * the full "make this directory ready for my agent" contract.
+     */
+    prepareSession(artifacts: ResolvedArtifacts, targetDir: string, options?: PrepareSessionOptions): Promise<PreparedSession>;
+}
+export interface PrepareSessionOptions {
+    /** Root to filter artifacts by (uses root's default_* arrays) */
+    root?: RootEntry;
+    /** Secret resolvers for ${VAR} interpolation in MCP configs */
+    secretResolvers?: SecretResolver[];
+}
+export interface PreparedSession {
+    /** Paths to config files written (e.g., ".mcp.json") */
+    configFiles: string[];
+    /** Paths to skill directories created */
+    skillPaths: string[];
+    /** The command to start the agent in the prepared directory */
+    startCommand: StartCommand;
+}
+/**
+ * Catalog Provider — resolves remote artifact index URIs.
+ *
+ * Core handles local filesystem paths (no scheme or file://).
+ * Providers handle other schemes: github://, s3://, https://, etc.
+ *
+ * Implementations: @pulsemcp/air-provider-github, etc.
+ */
+export interface CatalogProvider {
+    /** URI scheme this provider handles (e.g., "github", "s3") */
+    scheme: string;
+    /** Resolve a URI to parsed JSON content */
+    resolve(uri: string, baseDir: string): Promise<Record<string, unknown>>;
+}
+/**
+ * Secret Resolver — resolves ${VAR} interpolation in config values.
+ *
+ * Adapters accept an array of SecretResolver instances and try them
+ * in order. Extensions can implement resolvers for process.env,
+ * 1Password, Vault, AWS Secrets Manager, etc.
+ */
+export interface SecretResolver {
+    /** Unique name for this resolver (e.g., "env", "1password") */
+    name: string;
+    /** Resolve a key to its secret value. Returns undefined if not found. */
+    resolve(key: string): Promise<string | undefined>;
+}
+/**
+ * Extension metadata — the shape every AIR extension package default-exports.
+ * Used by the CLI for adapter/provider discovery.
+ */
+export interface AirExtension {
+    name: string;
+    type: "adapter" | "provider" | "secret-resolver";
+    adapter?: AgentAdapter;
+    provider?: CatalogProvider;
+    secretResolver?: SecretResolver;
+}
+export interface AgentSessionConfig {
+    agent: string;
+    mcpConfig?: Record<string, unknown>;
+    pluginConfigs?: Record<string, unknown>[];
+    hookConfigs?: Record<string, unknown>[];
+    skillPaths?: string[];
+    workDir?: string;
+    env?: Record<string, string>;
+}
+export interface StartCommand {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// Artifact types — the data shapes for all AIR artifact indexes
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gEAAgE;AAChE,+DAA+D"}

package/dist/validator.d.ts

@@ -0,0 +1,11 @@
+import { type SchemaType } from "./schemas.js";
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+}
+export declare function validateJson(data: unknown, schemaType: SchemaType): ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,UAAU,GACrB,gBAAgB,CAkBlB"}

package/dist/validator.js

@@ -0,0 +1,19 @@
+import Ajv from "ajv";
+import addFormats from "ajv-formats";
+import { loadSchema } from "./schemas.js";
+export function validateJson(data, schemaType) {
+    const ajv = new Ajv({ allErrors: true, strict: false });
+    addFormats(ajv);
+    const schema = loadSchema(schemaType);
+    const validate = ajv.compile(schema);
+    const valid = validate(data);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validate.errors || []).map((err) => ({
+        path: err.instancePath || "/",
+        message: err.message || "Unknown validation error",
+    }));
+    return { valid: false, errors };
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAmB,MAAM,cAAc,CAAC;AAY3D,MAAM,UAAU,YAAY,CAC1B,IAAa,EACb,UAAsB;IAEtB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,UAAU,CAAC,GAAG,CAAC,CAAC;IAEhB,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE7B,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAsB,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACtE,IAAI,EAAE,GAAG,CAAC,YAAY,IAAI,GAAG;QAC7B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,0BAA0B;KACnD,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@pulsemcp/air-core",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pulsemcp/air.git",
+    "directory": "packages/core"
+  },
+  "description": "AIR core — config resolution, validation, schemas, and extension interfaces",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "schemas/"
+  ],
+  "scripts": {
+    "build": "npm run copy-schemas && tsc",
+    "copy-schemas": "cp -r ../../schemas ./schemas",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepare": "npm run copy-schemas"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}