@pulsemcp/air-sdk 0.0.40 → 0.0.41

package/dist/auto-discovery.d.ts

@@ -0,0 +1,54 @@
+import { type DiscoveryResult, type DiscoveredCatalog, type DiscoveredLooseIndex, type DiscoveredAirJson } from "./discover-indexes.js";
+import { type EditAirJsonResult } from "./edit-air-json.js";
+export interface FindOfferableOptions {
+    /** Working directory to anchor discovery. Defaults to process.cwd(). */
+    cwd?: string;
+    /** Path to air.json. Defaults to AIR_CONFIG env or ~/.air/air.json. */
+    configPath?: string;
+    /** Override preferences path (for testing). */
+    preferencesPath?: string;
+}
+export interface OfferableDiscoveryResult {
+    /** The raw result from `discoverIndexes`. */
+    raw: DiscoveryResult;
+    /** Catalogs not yet in air.json and not dismissed. */
+    catalogs: DiscoveredCatalog[];
+    /** Loose indexes not yet in air.json and not dismissed. */
+    looseIndexes: DiscoveredLooseIndex[];
+    /** Nested air.json files not yet in air.json and not dismissed. */
+    airJsons: DiscoveredAirJson[];
+    /** True if there is anything to offer the user. */
+    hasOffers: boolean;
+    /**
+     * Resolved absolute path to the air.json we'll target on accept. Honors
+     * `options.configPath`, then `AIR_CONFIG`, then `~/.air/air.json`. Unlike
+     * `getAirJsonPath()`, this is populated even when the file does not yet
+     * exist so accept-flow scaffolding writes to the right location.
+     */
+    resolvedConfigPath: string;
+}
+/**
+ * Run discovery, drop anything already in `~/.air/air.json`, drop anything
+ * the user has asked AIR not to offer again. The caller decides what to do
+ * with the survivors (prompt, auto-accept, etc.).
+ */
+export declare function findOfferableIndexes(options?: FindOfferableOptions): OfferableDiscoveryResult;
+export interface AcceptDiscoveryOptions {
+    /** Override the air.json path. */
+    configPath?: string;
+}
+/**
+ * Accept all offers by writing them into air.json.
+ */
+export declare function acceptOffers(offers: OfferableDiscoveryResult, options?: AcceptDiscoveryOptions): EditAirJsonResult;
+export interface DismissDiscoveryOptions {
+    /** Override the preferences path (for testing). */
+    preferencesPath?: string;
+}
+/**
+ * Mark every current offer as dismissed so it is never surfaced again.
+ * Uses (repoRoot=anchor, indexPath=relative) granularity — new files added
+ * later still get offered.
+ */
+export declare function dismissOffers(offers: OfferableDiscoveryResult, options?: DismissDiscoveryOptions): void;
+//# sourceMappingURL=auto-discovery.d.ts.map

package/dist/auto-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-discovery.d.ts","sourceRoot":"","sources":["../src/auto-discovery.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,6CAA6C;IAC7C,GAAG,EAAE,eAAe,CAAC;IACrB,sDAAsD;IACtD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,2DAA2D;IAC3D,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,mEAAmE;IACnE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAYD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,wBAAwB,CA4C1B;AAED,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,iBAAiB,CAanB;AAED,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CAcN"}

package/dist/auto-discovery.js

@@ -0,0 +1,99 @@
+import { resolve } from "path";
+import { getDefaultAirJsonPath } from "@pulsemcp/air-core";
+import { discoverIndexes, } from "./discover-indexes.js";
+import { loadPreferences, isDismissed, addDismissed, } from "./preferences.js";
+import { addDiscoveredToAirJson, buildRegisteredChecker, } from "./edit-air-json.js";
+/**
+ * Resolve the target air.json path consistently across discovery and accept.
+ * `getAirJsonPath()` returns null for missing files, which loses the user's
+ * `AIR_CONFIG` preference on a first-time scaffold — so we do our own
+ * resolution that always returns a real path.
+ */
+function resolveTargetConfigPath(explicit) {
+    return explicit ?? process.env.AIR_CONFIG ?? getDefaultAirJsonPath();
+}
+/**
+ * Run discovery, drop anything already in `~/.air/air.json`, drop anything
+ * the user has asked AIR not to offer again. The caller decides what to do
+ * with the survivors (prompt, auto-accept, etc.).
+ */
+export function findOfferableIndexes(options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const resolvedConfigPath = resolveTargetConfigPath(options?.configPath);
+    const raw = discoverIndexes(cwd);
+    // buildRegisteredChecker tolerates a missing file (returns no-op), so we
+    // can pass the resolved path even if the air.json doesn't exist yet.
+    const registered = buildRegisteredChecker(resolvedConfigPath);
+    const prefs = loadPreferences(options?.preferencesPath);
+    const asDismissed = (indexPath) => ({
+        repoRoot: raw.anchor,
+        indexPath,
+    });
+    const catalogs = raw.catalogs.filter((c) => {
+        if (registered.catalog(c.path))
+            return false;
+        if (isDismissed(prefs, asDismissed(c.relPath)))
+            return false;
+        return true;
+    });
+    const looseIndexes = raw.looseIndexes.filter((l) => {
+        if (registered.loose(l.type, l.path))
+            return false;
+        if (isDismissed(prefs, asDismissed(l.relPath)))
+            return false;
+        return true;
+    });
+    const airJsons = raw.airJsons.filter((a) => {
+        if (registered.airJson(a.path))
+            return false;
+        if (isDismissed(prefs, asDismissed(a.relPath)))
+            return false;
+        return true;
+    });
+    return {
+        raw,
+        catalogs,
+        looseIndexes,
+        airJsons,
+        hasOffers: catalogs.length > 0 ||
+            looseIndexes.length > 0 ||
+            airJsons.length > 0,
+        resolvedConfigPath,
+    };
+}
+/**
+ * Accept all offers by writing them into air.json.
+ */
+export function acceptOffers(offers, options) {
+    // An explicit override wins; otherwise use the path the discovery already
+    // resolved. This preserves AIR_CONFIG even when the file didn't exist at
+    // discovery time and is about to be scaffolded.
+    const configPath = options?.configPath ?? offers.resolvedConfigPath;
+    return addDiscoveredToAirJson({
+        catalogs: offers.catalogs,
+        looseIndexes: offers.looseIndexes,
+        airJsons: offers.airJsons,
+    }, { path: configPath });
+}
+/**
+ * Mark every current offer as dismissed so it is never surfaced again.
+ * Uses (repoRoot=anchor, indexPath=relative) granularity — new files added
+ * later still get offered.
+ */
+export function dismissOffers(offers, options) {
+    const { anchor } = offers.raw;
+    const entries = [];
+    for (const c of offers.catalogs) {
+        entries.push({ repoRoot: resolve(anchor), indexPath: c.relPath });
+    }
+    for (const l of offers.looseIndexes) {
+        entries.push({ repoRoot: resolve(anchor), indexPath: l.relPath });
+    }
+    for (const a of offers.airJsons) {
+        entries.push({ repoRoot: resolve(anchor), indexPath: a.relPath });
+    }
+    if (entries.length === 0)
+        return;
+    addDismissed(entries, options?.preferencesPath);
+}
+//# sourceMappingURL=auto-discovery.js.map

package/dist/auto-discovery.js.map

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

package/dist/discover-indexes.d.ts

@@ -0,0 +1,72 @@
+/** Artifact-index types that map to a catalog layout directory. */
+declare const CATALOG_TYPES: readonly ["skills", "references", "mcp", "plugins", "roots", "hooks"];
+type CatalogType = (typeof CATALOG_TYPES)[number];
+export interface DiscoveredCatalog {
+    /** Absolute path to the catalog directory. */
+    path: string;
+    /** Path relative to the discovery anchor. */
+    relPath: string;
+    /** Artifact types found under the catalog that match the `<type>/<type>.json` layout. */
+    types: CatalogType[];
+    /** Count of entries per discovered type, for prompt summaries. */
+    entryCounts: Partial<Record<CatalogType, number>>;
+}
+export interface DiscoveredLooseIndex {
+    /** Artifact type inferred from the filename and/or `$schema`. */
+    type: CatalogType;
+    /** Absolute path to the index file. */
+    path: string;
+    /** Path relative to the discovery anchor. */
+    relPath: string;
+    /** Count of top-level entries in the index (excluding `$schema`). */
+    entryCount: number;
+}
+export interface DiscoveredAirJson {
+    /** Absolute path to the air.json file. */
+    path: string;
+    /** Path relative to the discovery anchor. */
+    relPath: string;
+}
+export interface DiscoveryResult {
+    /** Absolute path to the directory discovery was anchored at (git root or fallback). */
+    anchor: string;
+    /** Whether the anchor was determined via `git rev-parse` (true) or a cwd fallback (false). */
+    anchorIsGitRoot: boolean;
+    /** Catalog directories — `<anchor>/<type>/<type>.json` layouts. */
+    catalogs: DiscoveredCatalog[];
+    /** Bare artifact index files that are not part of a full catalog layout. */
+    looseIndexes: DiscoveredLooseIndex[];
+    /** Nested `air.json` files. */
+    airJsons: DiscoveredAirJson[];
+}
+export interface DiscoverIndexesOptions {
+    /** Maximum walk depth below the anchor. Default: 3. */
+    maxDepth?: number;
+    /** Override the skiplist. Default: common build/output dirs + node_modules/.git. */
+    skipDirs?: Set<string>;
+}
+/**
+ * Resolve the discovery anchor for a target directory.
+ * Returns the git root when inside a repo, otherwise the target itself.
+ */
+export declare function resolveAnchor(targetDir: string): {
+    anchor: string;
+    isGitRoot: boolean;
+};
+/**
+ * Discover AIR index files and `air.json` configs under `targetDir`.
+ *
+ * Anchor is the enclosing git root (via `git rev-parse --show-toplevel`)
+ * if one exists, else `targetDir` itself. Walks up to `maxDepth` levels
+ * deep, skipping `node_modules/`, `.git/`, build output dirs, and anything
+ * starting with `.`. Every candidate file is validated via filename-based
+ * schema detection plus optional `$schema` cross-check; unparseable or
+ * non-AIR JSON files are silently skipped.
+ *
+ * Files found via a catalog layout are excluded from `looseIndexes` — the
+ * catalog entry already covers them.
+ */
+export declare function discoverIndexes(targetDir: string, options?: DiscoverIndexesOptions): DiscoveryResult;
+export type { CatalogType };
+export { CATALOG_TYPES };
+//# sourceMappingURL=discover-indexes.d.ts.map

package/dist/discover-indexes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-indexes.d.ts","sourceRoot":"","sources":["../src/discover-indexes.ts"],"names":[],"mappings":"AASA,mEAAmE;AACnE,QAAA,MAAM,aAAa,uEAOuC,CAAC;AAE3D,KAAK,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAkBlD,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,kEAAkE;IAClE,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,IAAI,EAAE,WAAW,CAAC;IAClB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,eAAe,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,4EAA4E;IAC5E,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,+BAA+B;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB,CAcA;AAqLD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,eAAe,CAmEjB;AAED,YAAY,EAAE,WAAW,EAAE,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/discover-indexes.js

@@ -0,0 +1,309 @@
+import { execFileSync } from "child_process";
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { resolve, relative, sep, basename } from "path";
+import { detectSchemaType, detectSchemaFromValue, } from "@pulsemcp/air-core";
+/** Artifact-index types that map to a catalog layout directory. */
+const CATALOG_TYPES = [
+    "skills",
+    "references",
+    "mcp",
+    "plugins",
+    "roots",
+    "hooks",
+];
+/** Directories never descended into during discovery. */
+const SKIP_DIRS = new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    "coverage",
+    ".next",
+    ".turbo",
+    "target",
+    "vendor",
+]);
+/** Maximum directory depth walked under the anchor (anchor itself is depth 0). */
+const MAX_DEPTH = 3;
+/**
+ * Resolve the discovery anchor for a target directory.
+ * Returns the git root when inside a repo, otherwise the target itself.
+ */
+export function resolveAnchor(targetDir) {
+    try {
+        const root = execFileSync("git", ["rev-parse", "--show-toplevel"], {
+            cwd: targetDir,
+            stdio: ["pipe", "pipe", "pipe"],
+            encoding: "utf-8",
+        }).trim();
+        if (root) {
+            return { anchor: resolve(root), isGitRoot: true };
+        }
+    }
+    catch {
+        // Not a git repo or git not installed — fall through.
+    }
+    return { anchor: resolve(targetDir), isGitRoot: false };
+}
+/**
+ * Read a JSON file and verify it is (a) parseable, (b) an object, and
+ * (c) plausibly an AIR artifact index of the expected type.
+ *
+ * Validation rules:
+ * - The file must parse as a JSON object (not array/primitive/null).
+ * - A missing `$schema` is allowed — filename-based detection is sufficient.
+ * - When `$schema` is present, it must resolve to the expected artifact type;
+ *   a contradictory or non-AIR schema causes the file to be skipped.
+ *
+ * Returns the parsed data when valid, or `null` to signal "skip this file".
+ */
+function readAndValidateIndex(filePath, expectedType) {
+    let content;
+    try {
+        content = readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    let data;
+    try {
+        data = JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+    if (typeof data !== "object" ||
+        data === null ||
+        Array.isArray(data)) {
+        return null;
+    }
+    const obj = data;
+    if (typeof obj.$schema === "string") {
+        const schemaType = detectSchemaFromValue(obj.$schema);
+        if (schemaType === null)
+            return null;
+        if (schemaType !== expectedType)
+            return null;
+    }
+    return obj;
+}
+/** Count top-level artifact entries in a validated index (excludes `$schema`). */
+function countEntries(data) {
+    let count = 0;
+    for (const key of Object.keys(data)) {
+        if (key === "$schema")
+            continue;
+        count++;
+    }
+    return count;
+}
+function readAirJson(filePath) {
+    let content;
+    try {
+        content = readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return false;
+    }
+    let data;
+    try {
+        data = JSON.parse(content);
+    }
+    catch {
+        return false;
+    }
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+        return false;
+    }
+    const obj = data;
+    if (typeof obj.name !== "string")
+        return false;
+    if (typeof obj.$schema === "string") {
+        const schemaType = detectSchemaFromValue(obj.$schema);
+        if (schemaType !== null && schemaType !== "air")
+            return false;
+    }
+    return true;
+}
+/**
+ * Walk `anchor` up to `maxDepth` levels, yielding all files that might be
+ * AIR index candidates. Skips hidden directories and the configured skiplist.
+ * Hidden files (e.g. `.somefile.json`) are skipped. `.claude/skills/` is
+ * intentionally NOT scanned — local `.claude/` skills are adapter-owned and
+ * not managed through AIR discovery.
+ */
+function* walkJsonFiles(anchor, maxDepth, skipDirs) {
+    function* recurse(dir, depth) {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const name = entry.name;
+            if (name.startsWith("."))
+                continue;
+            const full = resolve(dir, name);
+            if (entry.isDirectory()) {
+                if (skipDirs.has(name))
+                    continue;
+                if (depth + 1 > maxDepth)
+                    continue;
+                yield* recurse(full, depth + 1);
+            }
+            else if (entry.isFile()) {
+                if (name.endsWith(".json")) {
+                    yield full;
+                }
+            }
+        }
+    }
+    yield* recurse(anchor, 0);
+}
+/**
+ * Find catalog layouts under the anchor.
+ *
+ * A catalog is a directory D such that `D/<type>/<type>.json` exists for at
+ * least one of the six artifact types. The catalog's position is D itself
+ * (so `air.json`'s `catalogs[]` receives a single entry for D, not six
+ * per-type paths).
+ *
+ * Catalog detection is conservative — `D/skills/skills.json` must look like
+ * a valid AIR skills index (parseable JSON object with a matching `$schema`
+ * if declared) before D is considered a catalog.
+ */
+function findCatalogs(anchor) {
+    // Map of catalog absolute path → set of types detected under it.
+    const catalogs = new Map();
+    function tryCatalogAt(dirPath) {
+        if (catalogs.has(dirPath))
+            return;
+        const entryCounts = {};
+        const types = [];
+        for (const type of CATALOG_TYPES) {
+            const candidate = resolve(dirPath, type, `${type}.json`);
+            if (!existsSync(candidate))
+                continue;
+            const data = readAndValidateIndex(candidate, type);
+            if (!data)
+                continue;
+            types.push(type);
+            entryCounts[type] = countEntries(data);
+        }
+        if (types.length === 0)
+            return;
+        catalogs.set(dirPath, {
+            path: dirPath,
+            relPath: relative(anchor, dirPath) || ".",
+            types,
+            entryCounts,
+        });
+    }
+    // The anchor itself is always a candidate root.
+    tryCatalogAt(anchor);
+    // Also scan subdirectories one level deep — this catches layouts where the
+    // catalog lives under e.g. `config/` or `air/` rather than at the repo root.
+    let entries;
+    try {
+        entries = readdirSync(anchor, { withFileTypes: true });
+    }
+    catch {
+        return [...catalogs.values()];
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const name = entry.name;
+        if (name.startsWith("."))
+            continue;
+        if (SKIP_DIRS.has(name))
+            continue;
+        // Per-type directories like `skills/` are themselves part of a catalog
+        // *rooted at the anchor*, not a catalog on their own. They don't
+        // contain `<type>/<type>.json` layouts inside themselves anyway, so
+        // `tryCatalogAt` will quietly return. No special-case needed.
+        tryCatalogAt(resolve(anchor, name));
+    }
+    return [...catalogs.values()];
+}
+/**
+ * Discover AIR index files and `air.json` configs under `targetDir`.
+ *
+ * Anchor is the enclosing git root (via `git rev-parse --show-toplevel`)
+ * if one exists, else `targetDir` itself. Walks up to `maxDepth` levels
+ * deep, skipping `node_modules/`, `.git/`, build output dirs, and anything
+ * starting with `.`. Every candidate file is validated via filename-based
+ * schema detection plus optional `$schema` cross-check; unparseable or
+ * non-AIR JSON files are silently skipped.
+ *
+ * Files found via a catalog layout are excluded from `looseIndexes` — the
+ * catalog entry already covers them.
+ */
+export function discoverIndexes(targetDir, options) {
+    const { anchor, isGitRoot } = resolveAnchor(targetDir);
+    const maxDepth = options?.maxDepth ?? MAX_DEPTH;
+    const skipDirs = options?.skipDirs ?? SKIP_DIRS;
+    const catalogs = findCatalogs(anchor);
+    // Build a set of file paths already covered by a catalog so we don't
+    // double-count them as loose indexes.
+    const catalogCovered = new Set();
+    for (const cat of catalogs) {
+        for (const type of cat.types) {
+            catalogCovered.add(resolve(cat.path, type, `${type}.json`));
+        }
+    }
+    const looseIndexes = [];
+    const airJsons = [];
+    for (const file of walkJsonFiles(anchor, maxDepth, skipDirs)) {
+        if (catalogCovered.has(file))
+            continue;
+        const name = basename(file);
+        // End-with `.schema.json` is excluded by detectSchemaType.
+        const type = detectSchemaType(name);
+        if (!type)
+            continue;
+        if (type === "air") {
+            if (readAirJson(file)) {
+                airJsons.push({
+                    path: file,
+                    relPath: relative(anchor, file),
+                });
+            }
+            continue;
+        }
+        if (!CATALOG_TYPES.includes(type))
+            continue;
+        const data = readAndValidateIndex(file, type);
+        if (!data)
+            continue;
+        looseIndexes.push({
+            type: type,
+            path: file,
+            relPath: relative(anchor, file),
+            entryCount: countEntries(data),
+        });
+    }
+    // Stable ordering: shallowest first, then alphabetic. Makes test assertions
+    // deterministic and produces predictable prompt output.
+    const byPath = (a, b) => {
+        const da = a.relPath.split(sep).length;
+        const db = b.relPath.split(sep).length;
+        if (da !== db)
+            return da - db;
+        return a.relPath.localeCompare(b.relPath);
+    };
+    catalogs.sort(byPath);
+    looseIndexes.sort(byPath);
+    airJsons.sort(byPath);
+    return {
+        anchor,
+        anchorIsGitRoot: isGitRoot,
+        catalogs,
+        looseIndexes,
+        airJsons,
+    };
+}
+export { CATALOG_TYPES };
+//# sourceMappingURL=discover-indexes.js.map

package/dist/discover-indexes.js.map

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

package/dist/edit-air-json.d.ts

@@ -0,0 +1,62 @@
+import type { DiscoveredCatalog, DiscoveredLooseIndex, DiscoveredAirJson, CatalogType } from "./discover-indexes.js";
+/** Shape of the entries we write — loose indexes get a type, catalogs get the catalogs[] slot. */
+export interface AirJsonAddition {
+    kind: "catalog" | "loose" | "airJson";
+    /** Path or URI string written to air.json. */
+    value: string;
+    /** For loose/airJson entries, the artifact type slot the value was written to. */
+    type?: CatalogType;
+    /** Short human-readable summary used by the acceptance output. */
+    label: string;
+}
+export interface EditAirJsonOptions {
+    /** Override the default air.json path. */
+    path?: string;
+    /** Entries already persisted into air.json become no-ops. Default: true. */
+    idempotent?: boolean;
+}
+export interface EditAirJsonResult {
+    /** Absolute path to the air.json that was read/written. */
+    airJsonPath: string;
+    /** Entries that were newly added. */
+    added: AirJsonAddition[];
+    /** Entries that were already present and therefore skipped. */
+    skipped: AirJsonAddition[];
+    /** True if the scaffold was created because no air.json existed. */
+    createdScaffold: boolean;
+}
+/**
+ * Check whether `candidate` (an absolute path or URI) is already present in the
+ * given list of air.json entries. Performs path normalization so absolute,
+ * `./relative`, and `../relative` forms of the same file all collide.
+ */
+export declare function entryAlreadyListed(candidateAbsOrUri: string, list: string[] | undefined, airJsonDir: string): boolean;
+export interface AddDiscoveredEntries {
+    catalogs?: DiscoveredCatalog[];
+    looseIndexes?: DiscoveredLooseIndex[];
+    airJsons?: DiscoveredAirJson[];
+}
+/**
+ * Add discovered entries to the user's air.json.
+ *
+ * Catalogs go into `catalogs[]`. Loose indexes go into the matching per-type
+ * array (`skills[]`, `mcp[]`, …). Nested `air.json` files land in
+ * `catalogs[]` because they describe a full composition at their location —
+ * the user can further edit the reference later. All additions are
+ * idempotent: an entry already present in air.json is not duplicated.
+ *
+ * If the target air.json does not exist, a minimal scaffold is written
+ * (no local index files — for a full workspace scaffold use `initConfig`).
+ */
+export declare function addDiscoveredToAirJson(entries: AddDiscoveredEntries, options?: EditAirJsonOptions): EditAirJsonResult;
+/**
+ * Inspect whether a discovered candidate is already registered in air.json.
+ * Used by the discovery filter to drop items that are already composed.
+ */
+export interface RegisteredChecker {
+    catalog(absPath: string): boolean;
+    loose(type: CatalogType, absPath: string): boolean;
+    airJson(absPath: string): boolean;
+}
+export declare function buildRegisteredChecker(airJsonPath: string | null): RegisteredChecker;
+//# sourceMappingURL=edit-air-json.d.ts.map

package/dist/edit-air-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-air-json.d.ts","sourceRoot":"","sources":["../src/edit-air-json.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAc/B,kGAAkG;AAClG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACtC,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,+DAA+D;IAC/D,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,oEAAoE;IACpE,eAAe,EAAE,OAAO,CAAC;CAC1B;AA2DD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,EAC1B,UAAU,EAAE,MAAM,GACjB,OAAO,CAYT;AA+CD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,iBAAiB,CAkFnB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACnD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,iBAAiB,CAiCnB"}

package/dist/edit-air-json.js

@@ -0,0 +1,227 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { resolve, dirname, relative, isAbsolute } from "path";
+import { getDefaultAirJsonPath } from "@pulsemcp/air-core";
+const SCHEMA_BASE_URL = "https://raw.githubusercontent.com/pulsemcp/air/main/schemas";
+const CATALOG_TYPES = [
+    "skills",
+    "references",
+    "mcp",
+    "plugins",
+    "roots",
+    "hooks",
+];
+function loadOrScaffold(airJsonPath) {
+    if (!existsSync(airJsonPath)) {
+        mkdirSync(dirname(airJsonPath), { recursive: true });
+        const scaffold = {
+            $schema: `${SCHEMA_BASE_URL}/air.schema.json`,
+            name: "my-config",
+            description: "Personal AIR configuration",
+        };
+        return { data: scaffold, created: true };
+    }
+    const raw = readFileSync(airJsonPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new Error(`${airJsonPath} is not a JSON object — refusing to edit.`);
+    }
+    return { data: parsed, created: false };
+}
+/**
+ * Normalize a path string for comparison against air.json entries. Entries
+ * in air.json may be:
+ * - absolute (`/abs/path/to/skills.json`)
+ * - relative to the air.json directory (`./skills/skills.json`, `../foo/skills.json`)
+ * - a URI (`github://…`) — passed through untouched
+ *
+ * We compare by absolute path when possible so "./skills/skills.json" and its
+ * fully-resolved absolute twin are recognized as the same entry.
+ */
+function normalizeToAbsolute(entry, airJsonDir) {
+    if (/^[a-zA-Z][a-zA-Z0-9+\-.]*:\/\//.test(entry))
+        return entry;
+    if (isAbsolute(entry))
+        return resolve(entry);
+    return resolve(airJsonDir, entry);
+}
+/**
+ * Check whether `candidate` (an absolute path or URI) is already present in the
+ * given list of air.json entries. Performs path normalization so absolute,
+ * `./relative`, and `../relative` forms of the same file all collide.
+ */
+export function entryAlreadyListed(candidateAbsOrUri, list, airJsonDir) {
+    if (!list || list.length === 0)
+        return false;
+    const isUri = /^[a-zA-Z][a-zA-Z0-9+\-.]*:\/\//.test(candidateAbsOrUri);
+    if (isUri) {
+        return list.includes(candidateAbsOrUri);
+    }
+    const candidateAbs = resolve(candidateAbsOrUri);
+    for (const entry of list) {
+        const normalized = normalizeToAbsolute(entry, airJsonDir);
+        if (normalized === candidateAbs)
+            return true;
+    }
+    return false;
+}
+/**
+ * Produce the relative path written to air.json for an absolute target.
+ *
+ * We emit `./` or `../`-prefixed relative paths for targets that live under
+ * or above the air.json directory respectively. Targets on an entirely
+ * different volume (uncommon) fall back to the absolute path.
+ */
+function toAirJsonRelPath(absTarget, airJsonDir) {
+    const rel = relative(airJsonDir, absTarget);
+    if (!rel)
+        return "./";
+    if (rel.startsWith(".."))
+        return rel;
+    if (isAbsolute(rel))
+        return rel;
+    return "./" + rel;
+}
+/**
+ * Return all artifact-type entry arrays that are already present in the
+ * air.json, defaulting each to `[]` if absent so callers can push without
+ * pre-existence checks.
+ */
+function ensureArray(data, key) {
+    if (!data[key])
+        data[key] = [];
+    return data[key];
+}
+function formatLabel(kind, target, type) {
+    if (kind === "catalog")
+        return `catalog '${target}'`;
+    if (kind === "airJson")
+        return `air.json '${target}'`;
+    return `${type} '${target}'`;
+}
+/**
+ * Add discovered entries to the user's air.json.
+ *
+ * Catalogs go into `catalogs[]`. Loose indexes go into the matching per-type
+ * array (`skills[]`, `mcp[]`, …). Nested `air.json` files land in
+ * `catalogs[]` because they describe a full composition at their location —
+ * the user can further edit the reference later. All additions are
+ * idempotent: an entry already present in air.json is not duplicated.
+ *
+ * If the target air.json does not exist, a minimal scaffold is written
+ * (no local index files — for a full workspace scaffold use `initConfig`).
+ */
+export function addDiscoveredToAirJson(entries, options) {
+    const airJsonPath = options?.path ?? getDefaultAirJsonPath();
+    const airJsonDir = dirname(resolve(airJsonPath));
+    const { data, created } = loadOrScaffold(airJsonPath);
+    const added = [];
+    const skipped = [];
+    for (const catalog of entries.catalogs ?? []) {
+        const value = toAirJsonRelPath(catalog.path, airJsonDir);
+        const list = ensureArray(data, "catalogs");
+        if (entryAlreadyListed(catalog.path, list, airJsonDir)) {
+            skipped.push({
+                kind: "catalog",
+                value,
+                label: formatLabel("catalog", value),
+            });
+            continue;
+        }
+        list.push(value);
+        added.push({
+            kind: "catalog",
+            value,
+            label: formatLabel("catalog", value),
+        });
+    }
+    for (const airJson of entries.airJsons ?? []) {
+        // A nested air.json is semantically a catalog reference — the directory
+        // containing it typically follows the standard layout.
+        const catalogDir = dirname(airJson.path);
+        const value = toAirJsonRelPath(catalogDir, airJsonDir);
+        const list = ensureArray(data, "catalogs");
+        if (entryAlreadyListed(catalogDir, list, airJsonDir)) {
+            skipped.push({
+                kind: "airJson",
+                value,
+                label: formatLabel("airJson", value),
+            });
+            continue;
+        }
+        list.push(value);
+        added.push({
+            kind: "airJson",
+            value,
+            label: formatLabel("airJson", value),
+        });
+    }
+    for (const loose of entries.looseIndexes ?? []) {
+        if (!CATALOG_TYPES.includes(loose.type))
+            continue;
+        const value = toAirJsonRelPath(loose.path, airJsonDir);
+        const list = ensureArray(data, loose.type);
+        if (entryAlreadyListed(loose.path, list, airJsonDir)) {
+            skipped.push({
+                kind: "loose",
+                value,
+                type: loose.type,
+                label: formatLabel("loose", value, loose.type),
+            });
+            continue;
+        }
+        list.push(value);
+        added.push({
+            kind: "loose",
+            value,
+            type: loose.type,
+            label: formatLabel("loose", value, loose.type),
+        });
+    }
+    if (added.length > 0 || created) {
+        mkdirSync(dirname(airJsonPath), { recursive: true });
+        writeFileSync(airJsonPath, JSON.stringify(data, null, 2) + "\n");
+    }
+    return {
+        airJsonPath,
+        added,
+        skipped,
+        createdScaffold: created,
+    };
+}
+export function buildRegisteredChecker(airJsonPath) {
+    if (!airJsonPath || !existsSync(airJsonPath)) {
+        return {
+            catalog: () => false,
+            loose: () => false,
+            airJson: () => false,
+        };
+    }
+    let data;
+    try {
+        data = JSON.parse(readFileSync(airJsonPath, "utf-8"));
+    }
+    catch {
+        return {
+            catalog: () => false,
+            loose: () => false,
+            airJson: () => false,
+        };
+    }
+    const airJsonDir = dirname(resolve(airJsonPath));
+    return {
+        catalog(absPath) {
+            return entryAlreadyListed(absPath, data.catalogs, airJsonDir);
+        },
+        loose(type, absPath) {
+            const list = data[type];
+            if (entryAlreadyListed(absPath, list, airJsonDir))
+                return true;
+            return entryAlreadyListed(absPath, data.catalogs, airJsonDir);
+        },
+        airJson(absPath) {
+            const catalogDir = dirname(absPath);
+            return entryAlreadyListed(catalogDir, data.catalogs, airJsonDir);
+        },
+    };
+}
+//# sourceMappingURL=edit-air-json.js.map

package/dist/edit-air-json.js.map

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

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, CacheFreshnessWarning, CacheRefreshResult, AirExtension, PrepareTransform, PluginEmitter, BuildMarketplaceOptions, BuiltPlugin, BuiltMarketplace, McpConfig, TransformContext, ExtensionCliOption, AgentSessionConfig, StartCommand, PrepareSessionOptions as CorePrepareSessionOptions, PreparedSession, LocalArtifacts, LocalSkillEntry, ValidationResult, ValidationError, ResolveOptions, SchemaType, } from "@pulsemcp/air-core";
+export { loadAirConfig, getDefaultAirJsonPath, getAirJsonPath, resolveArtifacts, mergeArtifacts, expandPlugins, emptyArtifacts, validateJson, getSchemasDir, getSchemaPath, loadSchema, detectSchemaType, detectSchemaFromValue, getAllSchemaTypes, isValidSchemaType, MANIFEST_VERSION, getDefaultAirHome, getManifestPath, loadManifest, writeManifest, buildManifest, diffManifest, } from "@pulsemcp/air-core";
+export type { AirConfig, ResolvedArtifacts, SkillEntry, ReferenceEntry, McpOAuthConfig, McpServerEntry, PluginAuthor, PluginEntry, RootEntry, HookEntry, AgentAdapter, CatalogProvider, CacheFreshnessWarning, CacheRefreshResult, AirExtension, PrepareTransform, PluginEmitter, BuildMarketplaceOptions, BuiltPlugin, BuiltMarketplace, McpConfig, TransformContext, ExtensionCliOption, AgentSessionConfig, StartCommand, PrepareSessionOptions as CorePrepareSessionOptions, PreparedSession, LocalArtifacts, LocalSkillEntry, ValidationResult, ValidationError, ResolveOptions, SchemaType, Manifest, ManifestSelection, ManifestDiff, } from "@pulsemcp/air-core";
 export { findAdapter, listAvailableAdapters, type FindAdapterOptions, } from "./adapter-registry.js";
 export { normalizeGitUrl, detectRoot } from "./root-detection.js";
 export { validateFile } from "./validate.js";
@@ -28,4 +28,12 @@ export { updateProviderCaches } from "./update.js";
 export type { UpdateProviderCachesOptions, UpdateProviderCachesResult, } from "./update.js";
 export { checkProviderFreshness } from "./cache-freshness.js";
 export { findUnresolvedVars, findUnresolvedHookVars, validateNoUnresolvedVars, unresolvedVarsMessage, } from "./validate-config.js";
+export { discoverIndexes, resolveAnchor, CATALOG_TYPES, } from "./discover-indexes.js";
+export type { DiscoveryResult, DiscoveredCatalog, DiscoveredLooseIndex, DiscoveredAirJson, DiscoverIndexesOptions, CatalogType, } from "./discover-indexes.js";
+export { loadPreferences, savePreferences, addDismissed, isDismissed, getDefaultPreferencesPath, } from "./preferences.js";
+export type { AirPreferences, DismissedDiscovery } from "./preferences.js";
+export { addDiscoveredToAirJson, buildRegisteredChecker, entryAlreadyListed, } from "./edit-air-json.js";
+export type { AirJsonAddition, EditAirJsonOptions, EditAirJsonResult, AddDiscoveredEntries, RegisteredChecker, } from "./edit-air-json.js";
+export { findOfferableIndexes, acceptOffers, dismissOffers, } from "./auto-discovery.js";
+export type { FindOfferableOptions, OfferableDiscoveryResult, AcceptDiscoveryOptions, DismissDiscoveryOptions, } from "./auto-discovery.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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -5,7 +5,9 @@ loadAirConfig, getDefaultAirJsonPath, getAirJsonPath, resolveArtifacts, mergeArt
 // Validation
 validateJson, 
 // Schemas
-getSchemasDir, getSchemaPath, loadSchema, detectSchemaType, detectSchemaFromValue, getAllSchemaTypes, isValidSchemaType, } from "@pulsemcp/air-core";
+getSchemasDir, getSchemaPath, loadSchema, detectSchemaType, detectSchemaFromValue, getAllSchemaTypes, isValidSchemaType, 
+// Manifest
+MANIFEST_VERSION, getDefaultAirHome, getManifestPath, loadManifest, writeManifest, buildManifest, diffManifest, } from "@pulsemcp/air-core";
 // Adapter registry
 export { findAdapter, listAvailableAdapters, } from "./adapter-registry.js";
 // Root detection
@@ -31,4 +33,12 @@ export { updateProviderCaches } from "./update.js";
 export { checkProviderFreshness } from "./cache-freshness.js";
 // Config validation
 export { findUnresolvedVars, findUnresolvedHookVars, validateNoUnresolvedVars, unresolvedVarsMessage, } from "./validate-config.js";
+// Repo-level index discovery (for `air start` / `air prepare` auto-registration)
+export { discoverIndexes, resolveAnchor, CATALOG_TYPES, } from "./discover-indexes.js";
+// User preferences (auto-discovery dismiss-set lives here)
+export { loadPreferences, savePreferences, addDismissed, isDismissed, getDefaultPreferencesPath, } from "./preferences.js";
+// air.json editing (adds discovered entries)
+export { addDiscoveredToAirJson, buildRegisteredChecker, entryAlreadyListed, } from "./edit-air-json.js";
+// Auto-discovery orchestration (used by `air start` / `air prepare`)
+export { findOfferableIndexes, acceptOffers, dismissOffers, } from "./auto-discovery.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;AA4C5B,mBAAmB;AACnB,OAAO,EACL,WAAW,EACX,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAE/B,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;AAOvC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AASjF,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAM5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,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,4BAA4B;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAMnD,2BAA2B;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,oBAAoB;AACpB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,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;AACjB,WAAW;AACX,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAC;AAgD5B,mBAAmB;AACnB,OAAO,EACL,WAAW,EACX,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAE/B,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;AAOvC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AASjF,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAM5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,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,4BAA4B;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAMnD,2BAA2B;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,oBAAoB;AACpB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,iFAAiF;AACjF,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,uBAAuB,CAAC;AAU/B,2DAA2D;AAC3D,OAAO,EACL,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,EACX,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,6CAA6C;AAC7C,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAS5B,qEAAqE;AACrE,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,aAAa,GACd,MAAM,qBAAqB,CAAC"}

package/dist/preferences.d.ts

@@ -0,0 +1,31 @@
+export interface DismissedDiscovery {
+    /** Absolute path to the discovery anchor at the time of dismissal. */
+    repoRoot: string;
+    /** Path relative to `repoRoot` for the specific index file dismissed. */
+    indexPath: string;
+}
+export interface AirPreferences {
+    $schema?: string;
+    autoDiscovery?: {
+        dismissed?: DismissedDiscovery[];
+    };
+}
+/** Default location: `~/.air/preferences.json`, sibling to `air.json`. */
+export declare function getDefaultPreferencesPath(): string;
+/**
+ * Read the preferences file. Returns a structurally complete default when the
+ * file is missing or malformed so callers never need to null-check.
+ */
+export declare function loadPreferences(path?: string): AirPreferences;
+/** Write preferences to disk with 2-space indentation and trailing newline. */
+export declare function savePreferences(prefs: AirPreferences, path?: string): void;
+/**
+ * Add one or more (repoRoot, indexPath) entries to the dismissed-set.
+ * Idempotent — entries already present are not duplicated.
+ */
+export declare function addDismissed(entries: DismissedDiscovery[], path?: string): AirPreferences;
+/**
+ * True if the given (repoRoot, indexPath) pair is in the dismissed-set.
+ */
+export declare function isDismissed(prefs: AirPreferences, entry: DismissedDiscovery): boolean;
+//# sourceMappingURL=preferences.d.ts.map

package/dist/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../src/preferences.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE;QACd,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;KAClC,CAAC;CACH;AAED,0EAA0E;AAC1E,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AASD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CA4B7D;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAI1E;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,kBAAkB,EAAE,EAC7B,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CAYhB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAKT"}

package/dist/preferences.js.map

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

package/package.json

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