@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/store/catalog.js

@@ -0,0 +1,331 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+export const DEFAULT_STORE_CATALOG_URL = "https://hansjm10.github.io/Volt/store/catalog.json";
+const DEFAULT_STORE_CATALOG_FETCH_TIMEOUT_MS = 10000;
+const RESOURCE_TYPES = new Set(["extensions", "skills", "prompts", "themes"]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readRequiredString(record, key, errors) {
+    const value = record[key];
+    if (typeof value === "string" && value.trim()) {
+        return value;
+    }
+    errors.push(`${key} must be a non-empty string`);
+    return undefined;
+}
+function readOptionalString(record, key, errors) {
+    const value = record[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    errors.push(`${key} must be a string`);
+    return undefined;
+}
+function readOptionalBoolean(record, key, errors) {
+    const value = record[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === "boolean") {
+        return value;
+    }
+    errors.push(`${key} must be a boolean`);
+    return undefined;
+}
+function readOptionalStringArray(record, key, errors) {
+    const value = record[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Array.isArray(value) || !value.every((entry) => typeof entry === "string")) {
+        errors.push(`${key} must be an array of strings`);
+        return undefined;
+    }
+    return [...value];
+}
+function readOptionalResources(record, key, errors) {
+    const value = record[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Array.isArray(value)) {
+        errors.push(`${key} must be an array`);
+        return undefined;
+    }
+    const resources = [];
+    for (const entry of value) {
+        if (typeof entry !== "string" || !RESOURCE_TYPES.has(entry)) {
+            errors.push(`${key} contains an invalid resource type`);
+            return undefined;
+        }
+        resources.push(entry);
+    }
+    return resources;
+}
+function readOptionalCompatibility(record, key, errors) {
+    const value = record[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        errors.push(`${key} must be an object`);
+        return undefined;
+    }
+    const volt = readOptionalString(value, "volt", errors);
+    return volt === undefined ? {} : { volt };
+}
+function validateCatalogPackage(value, index) {
+    const errors = [];
+    if (!isRecord(value)) {
+        return { errors: [`packages[${index}] must be an object`] };
+    }
+    const id = readRequiredString(value, "id", errors);
+    const name = readRequiredString(value, "name", errors);
+    const description = readRequiredString(value, "description", errors);
+    const source = readRequiredString(value, "source", errors);
+    const repo = readOptionalString(value, "repo", errors);
+    const author = readOptionalString(value, "author", errors);
+    const license = readOptionalString(value, "license", errors);
+    const verified = readOptionalBoolean(value, "verified", errors);
+    const categories = readOptionalStringArray(value, "categories", errors);
+    const resources = readOptionalResources(value, "resources", errors);
+    const compatibility = readOptionalCompatibility(value, "compatibility", errors);
+    const image = readOptionalString(value, "image", errors);
+    const video = readOptionalString(value, "video", errors);
+    if (errors.length > 0 || !id || !name || !description || !source) {
+        return { errors };
+    }
+    const pkg = {
+        id,
+        name,
+        description,
+        source,
+        ...(repo !== undefined ? { repo } : {}),
+        ...(author !== undefined ? { author } : {}),
+        ...(license !== undefined ? { license } : {}),
+        ...(verified !== undefined ? { verified } : {}),
+        ...(categories !== undefined ? { categories } : {}),
+        ...(resources !== undefined ? { resources } : {}),
+        ...(compatibility !== undefined ? { compatibility } : {}),
+        ...(image !== undefined ? { image } : {}),
+        ...(video !== undefined ? { video } : {}),
+    };
+    return { pkg, errors: [] };
+}
+export function validateStoreCatalog(value) {
+    if (!isRecord(value)) {
+        throw new Error("Store catalog must be a JSON object");
+    }
+    if (value.schemaVersion !== 1) {
+        throw new Error("Store catalog schemaVersion must be 1");
+    }
+    if (!Array.isArray(value.packages)) {
+        throw new Error("Store catalog packages must be an array");
+    }
+    const warnings = [];
+    const packages = [];
+    const seenIds = new Set();
+    for (let index = 0; index < value.packages.length; index++) {
+        const result = validateCatalogPackage(value.packages[index], index);
+        if (!result.pkg) {
+            warnings.push(`Skipping invalid catalog package at index ${index}: ${result.errors.join("; ")}`);
+            continue;
+        }
+        if (seenIds.has(result.pkg.id)) {
+            warnings.push(`Skipping duplicate catalog package id "${result.pkg.id}" at index ${index}`);
+            continue;
+        }
+        seenIds.add(result.pkg.id);
+        packages.push(result.pkg);
+    }
+    return {
+        catalog: { schemaVersion: 1, packages },
+        warnings,
+    };
+}
+export function parseStoreCatalogJson(raw, label = "store catalog") {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to parse ${label}: ${message}`);
+    }
+    return validateStoreCatalog(parsed);
+}
+export function getStoreCatalogCachePath(agentDir, url = getDefaultCatalogUrl()) {
+    const cacheKey = createHash("sha256").update(url).digest("hex");
+    return join(agentDir, "store", "catalogs", `${cacheKey}.json`);
+}
+function isOfflineModeEnabled() {
+    const value = process.env.VOLT_OFFLINE;
+    if (!value)
+        return false;
+    return value === "1" || value.toLowerCase() === "true" || value.toLowerCase() === "yes";
+}
+function getDefaultCatalogUrl(url) {
+    return url ?? process.env.VOLT_STORE_CATALOG_URL ?? DEFAULT_STORE_CATALOG_URL;
+}
+function readCachedCatalog(agentDir, url) {
+    const cachePath = getStoreCatalogCachePath(agentDir, url);
+    if (!existsSync(cachePath)) {
+        return undefined;
+    }
+    const result = parseStoreCatalogJson(readFileSync(cachePath, "utf-8"), "cached store catalog");
+    return {
+        catalog: result.catalog,
+        source: "cache",
+        warnings: result.warnings,
+    };
+}
+function writeCachedCatalog(agentDir, url, raw) {
+    const cachePath = getStoreCatalogCachePath(agentDir, url);
+    mkdirSync(join(agentDir, "store", "catalogs"), { recursive: true, mode: 0o700 });
+    writeFileSync(cachePath, raw, "utf-8");
+}
+async function withCatalogFetchTimeout(timeoutMs, operation) {
+    const controller = new AbortController();
+    let timeout;
+    let timedOut = false;
+    const timeoutMessage = `Store catalog fetch timed out after ${timeoutMs}ms`;
+    try {
+        return await new Promise((resolve, reject) => {
+            timeout = setTimeout(() => {
+                timedOut = true;
+                controller.abort();
+                reject(new Error(timeoutMessage));
+            }, timeoutMs);
+            operation(controller.signal).then(resolve, reject);
+        });
+    }
+    catch (error) {
+        if (timedOut) {
+            throw new Error(timeoutMessage);
+        }
+        throw error;
+    }
+    finally {
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+    }
+}
+export async function loadDefaultStoreCatalog(options) {
+    const url = getDefaultCatalogUrl(options.url);
+    const offline = options.offline ?? isOfflineModeEnabled();
+    if (offline) {
+        try {
+            const cached = readCachedCatalog(options.agentDir, url);
+            if (cached) {
+                return {
+                    ...cached,
+                    warnings: ["Offline mode enabled; using cached store catalog.", ...cached.warnings],
+                };
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                catalog: { schemaVersion: 1, packages: [] },
+                source: "empty",
+                warnings: [`Offline mode enabled and cached store catalog is invalid: ${message}`],
+            };
+        }
+        return {
+            catalog: { schemaVersion: 1, packages: [] },
+            source: "empty",
+            warnings: ["Offline mode enabled and no cached store catalog is available."],
+        };
+    }
+    const fetcher = options.fetcher ?? ((input, init) => globalThis.fetch(input, init));
+    const timeoutMs = Math.max(1, Math.trunc(options.timeoutMs ?? DEFAULT_STORE_CATALOG_FETCH_TIMEOUT_MS));
+    try {
+        const { raw, result } = await withCatalogFetchTimeout(timeoutMs, async (signal) => {
+            const response = await fetcher(url, { signal });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}`);
+            }
+            const rawCatalog = await response.text();
+            return {
+                raw: rawCatalog,
+                result: parseStoreCatalogJson(rawCatalog, "remote store catalog"),
+            };
+        });
+        const warnings = [...result.warnings];
+        try {
+            writeCachedCatalog(options.agentDir, url, raw);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            warnings.push(`Failed to cache remote store catalog: ${message}`);
+        }
+        return {
+            catalog: result.catalog,
+            source: "remote",
+            warnings,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const cached = readCachedCatalog(options.agentDir, url);
+        if (cached) {
+            return {
+                ...cached,
+                warnings: [`Failed to load remote store catalog (${message}); using cached catalog.`, ...cached.warnings],
+            };
+        }
+        throw new Error(`Failed to load store catalog: ${message}`);
+    }
+}
+export function findCatalogPackage(catalog, id) {
+    return catalog.packages.find((pkg) => pkg.id === id);
+}
+export function searchCatalogPackages(catalog, query) {
+    const normalizedQuery = query?.trim().toLowerCase();
+    if (!normalizedQuery) {
+        return [...catalog.packages];
+    }
+    return catalog.packages.filter((pkg) => {
+        const fields = [pkg.id, pkg.name, pkg.description, ...(pkg.categories ?? [])];
+        return fields.some((field) => field.toLowerCase().includes(normalizedQuery));
+    });
+}
+function levenshteinDistance(left, right) {
+    const previous = new Array(right.length + 1);
+    const current = new Array(right.length + 1);
+    for (let index = 0; index <= right.length; index++) {
+        previous[index] = index;
+    }
+    for (let leftIndex = 1; leftIndex <= left.length; leftIndex++) {
+        current[0] = leftIndex;
+        for (let rightIndex = 1; rightIndex <= right.length; rightIndex++) {
+            const cost = left[leftIndex - 1] === right[rightIndex - 1] ? 0 : 1;
+            current[rightIndex] = Math.min(current[rightIndex - 1] + 1, previous[rightIndex] + 1, previous[rightIndex - 1] + cost);
+        }
+        for (let index = 0; index <= right.length; index++) {
+            previous[index] = current[index];
+        }
+    }
+    return previous[right.length] ?? 0;
+}
+export function suggestCatalogPackageIds(catalog, input, limit = 3) {
+    const normalizedInput = input.toLowerCase();
+    return catalog.packages
+        .map((pkg) => ({
+        id: pkg.id,
+        score: pkg.id.toLowerCase().includes(normalizedInput)
+            ? 0
+            : levenshteinDistance(normalizedInput, pkg.id.toLowerCase()),
+    }))
+        .filter((entry) => entry.score <= Math.max(2, Math.floor(normalizedInput.length / 2)))
+        .sort((left, right) => left.score - right.score || left.id.localeCompare(right.id))
+        .slice(0, limit)
+        .map((entry) => entry.id);
+}
+//# sourceMappingURL=catalog.js.map

package/dist/store/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/store/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,yBAAyB,GAAG,oDAAoD,CAAC;AAE9F,MAAM,sCAAsC,GAAG,KAAK,CAAC;AA2DrD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAoB,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEjG,SAAS,QAAQ,CAAC,KAAc,EAAoC;IACnE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAAA,CAC5E;AAED,SAAS,kBAAkB,CAAC,MAA+B,EAAE,GAAW,EAAE,MAAgB,EAAsB;IAC/G,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,6BAA6B,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,SAAS,kBAAkB,CAAC,MAA+B,EAAE,GAAW,EAAE,MAAgB,EAAsB;IAC/G,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,mBAAmB,CAAC,CAAC;IACvC,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,SAAS,mBAAmB,CAAC,MAA+B,EAAE,GAAW,EAAE,MAAgB,EAAuB;IACjH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,oBAAoB,CAAC,CAAC;IACxC,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,SAAS,uBAAuB,CAAC,MAA+B,EAAE,GAAW,EAAE,MAAgB,EAAwB;IACtH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;QACjF,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,8BAA8B,CAAC,CAAC;QAClD,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AAAA,CAClB;AAED,SAAS,qBAAqB,CAC7B,MAA+B,EAC/B,GAAW,EACX,MAAgB,EACkB;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,mBAAmB,CAAC,CAAC;QACvC,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAwB,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAA0B,CAAC,EAAE,CAAC;YAClF,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,oCAAoC,CAAC,CAAC;YACxD,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,KAA0B,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,SAAS,yBAAyB,CACjC,MAA+B,EAC/B,GAAW,EACX,MAAgB,EACgB;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,oBAAoB,CAAC,CAAC;QACxC,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AAAA,CAC1C;AAED,SAAS,sBAAsB,CAAC,KAAc,EAAE,KAAa,EAAmD;IAC/G,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,CAAC,YAAY,KAAK,qBAAqB,CAAC,EAAE,CAAC;IAC7D,CAAC;IAED,MAAM,EAAE,GAAG,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,uBAAuB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IACpE,MAAM,aAAa,GAAG,yBAAyB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEzD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC;QAClE,OAAO,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAwB;QAChC,EAAE;QACF,IAAI;QACJ,WAAW;QACX,MAAM;QACN,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzC,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAAA,CAC3B;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAgC;IAClF,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,6CAA6C,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjG,SAAS;QACV,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,0CAA0C,MAAM,CAAC,GAAG,CAAC,EAAE,cAAc,KAAK,EAAE,CAAC,CAAC;YAC5F,SAAS;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO;QACN,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,QAAQ,EAAE;QACvC,QAAQ;KACR,CAAC;AAAA,CACF;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW,EAAE,KAAK,GAAG,eAAe,EAAgC;IACzG,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACrC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAAA,CACpC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAgB,EAAE,GAAG,GAAG,oBAAoB,EAAE,EAAU;IAChG,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAC;AAAA,CAC/D;AAED,SAAS,oBAAoB,GAAY;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC;AAAA,CACxF;AAED,SAAS,oBAAoB,CAAC,GAAY,EAAU;IACnD,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,yBAAyB,CAAC;AAAA,CAC9E;AAED,SAAS,iBAAiB,CAAC,QAAgB,EAAE,GAAW,EAAsC;IAC7F,MAAM,SAAS,GAAG,wBAAwB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAC/F,OAAO;QACN,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,MAAM,CAAC,QAAQ;KACzB,CAAC;AAAA,CACF;AAED,SAAS,kBAAkB,CAAC,QAAgB,EAAE,GAAW,EAAE,GAAW,EAAQ;IAC7E,MAAM,SAAS,GAAG,wBAAwB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC1D,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAAA,CACvC;AAED,KAAK,UAAU,uBAAuB,CACrC,SAAiB,EACjB,SAA8C,EACjC;IACb,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,OAAkD,CAAC;IACvD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,cAAc,GAAG,uCAAuC,SAAS,IAAI,CAAC;IAE5E,IAAI,CAAC;QACJ,OAAO,MAAM,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;YAChD,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;gBAC1B,QAAQ,GAAG,IAAI,CAAC;gBAChB,UAAU,CAAC,KAAK,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;YAAA,CAClC,EAAE,SAAS,CAAC,CAAC;YACd,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAAA,CACnD,CAAC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACzB,IAAI,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;YAAS,CAAC;QACV,IAAI,OAAO,EAAE,CAAC;YACb,YAAY,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;AAAA,CACD;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,OAAuC,EACL;IAClC,MAAM,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,oBAAoB,EAAE,CAAC;IAC1D,IAAI,OAAO,EAAE,CAAC;QACb,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACxD,IAAI,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACN,GAAG,MAAM;oBACT,QAAQ,EAAE,CAAC,mDAAmD,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;iBACnF,CAAC;YACH,CAAC;QACF,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACN,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;gBAC3C,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,CAAC,6DAA6D,OAAO,EAAE,CAAC;aAClF,CAAC;QACH,CAAC;QACD,OAAO;YACN,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC3C,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,CAAC,gEAAgE,CAAC;SAC5E,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAwB,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACzG,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,IAAI,sCAAsC,CAAC,CAAC,CAAC;IACvG,IAAI,CAAC;QACJ,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,uBAAuB,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;YAClF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACzC,OAAO;gBACN,GAAG,EAAE,UAAU;gBACf,MAAM,EAAE,qBAAqB,CAAC,UAAU,EAAE,sBAAsB,CAAC;aACjE,CAAC;QAAA,CACF,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC;YACJ,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,QAAQ,CAAC,IAAI,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO;YACN,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,QAAQ;YAChB,QAAQ;SACR,CAAC;IACH,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACxD,IAAI,MAAM,EAAE,CAAC;YACZ,OAAO;gBACN,GAAG,MAAM;gBACT,QAAQ,EAAE,CAAC,wCAAwC,OAAO,0BAA0B,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;aACzG,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;AAAA,CACD;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAqB,EAAE,EAAU,EAAmC;IACtG,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAAA,CACrD;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAqB,EAAE,KAAc,EAAyB;IACnG,MAAM,eAAe,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpD,IAAI,CAAC,eAAe,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9E,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;IAAA,CAC7E,CAAC,CAAC;AAAA,CACH;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,KAAa,EAAU;IACjE,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAS,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,KAAK,CAAS,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;IACzB,CAAC;IACD,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;QAC/D,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;QACvB,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;YACnE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,CAC7B,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,EAC3B,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EACxB,QAAQ,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,CAC/B,CAAC;QACH,CAAC;QACD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACpD,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAAA,CACnC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAqB,EAAE,KAAa,EAAE,KAAK,GAAG,CAAC,EAAY;IACnG,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,OAAO,CAAC,QAAQ;SACrB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YACpD,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,mBAAmB,CAAC,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;KAC7D,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;SACrF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SAClF,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAAA,CAC3B","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport const DEFAULT_STORE_CATALOG_URL = \"https://hansjm10.github.io/Volt/store/catalog.json\";\n\nconst DEFAULT_STORE_CATALOG_FETCH_TIMEOUT_MS = 10000;\n\nexport type StoreResourceType = \"extensions\" | \"skills\" | \"prompts\" | \"themes\";\n\nexport interface StoreCatalog {\n\tschemaVersion: 1;\n\tpackages: StoreCatalogPackage[];\n}\n\nexport interface StoreCatalogPackage {\n\tid: string;\n\tname: string;\n\tdescription: string;\n\tsource: string;\n\trepo?: string;\n\tauthor?: string;\n\tlicense?: string;\n\tverified?: boolean;\n\tcategories?: string[];\n\tresources?: StoreResourceType[];\n\tcompatibility?: { volt?: string };\n\timage?: string;\n\tvideo?: string;\n}\n\nexport interface StoreCatalogValidationResult {\n\tcatalog: StoreCatalog;\n\twarnings: string[];\n}\n\nexport interface LoadStoreCatalogResult {\n\tcatalog: StoreCatalog;\n\tsource: \"remote\" | \"cache\" | \"empty\";\n\twarnings: string[];\n}\n\ninterface StoreCatalogFetchResponse {\n\tok: boolean;\n\tstatus: number;\n\ttext(): Promise<string>;\n}\n\ninterface StoreCatalogFetchOptions {\n\tsignal?: AbortSignal;\n}\n\nexport type StoreCatalogFetcher = (\n\turl: string,\n\toptions?: StoreCatalogFetchOptions,\n) => Promise<StoreCatalogFetchResponse>;\n\nexport interface LoadDefaultStoreCatalogOptions {\n\tagentDir: string;\n\turl?: string;\n\toffline?: boolean;\n\tfetcher?: StoreCatalogFetcher;\n\ttimeoutMs?: number;\n}\n\nconst RESOURCE_TYPES = new Set<StoreResourceType>([\"extensions\", \"skills\", \"prompts\", \"themes\"]);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction readRequiredString(record: Record<string, unknown>, key: string, errors: string[]): string | undefined {\n\tconst value = record[key];\n\tif (typeof value === \"string\" && value.trim()) {\n\t\treturn value;\n\t}\n\terrors.push(`${key} must be a non-empty string`);\n\treturn undefined;\n}\n\nfunction readOptionalString(record: Record<string, unknown>, key: string, errors: string[]): string | undefined {\n\tconst value = record[key];\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value === \"string\") {\n\t\treturn value;\n\t}\n\terrors.push(`${key} must be a string`);\n\treturn undefined;\n}\n\nfunction readOptionalBoolean(record: Record<string, unknown>, key: string, errors: string[]): boolean | undefined {\n\tconst value = record[key];\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value === \"boolean\") {\n\t\treturn value;\n\t}\n\terrors.push(`${key} must be a boolean`);\n\treturn undefined;\n}\n\nfunction readOptionalStringArray(record: Record<string, unknown>, key: string, errors: string[]): string[] | undefined {\n\tconst value = record[key];\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (!Array.isArray(value) || !value.every((entry) => typeof entry === \"string\")) {\n\t\terrors.push(`${key} must be an array of strings`);\n\t\treturn undefined;\n\t}\n\treturn [...value];\n}\n\nfunction readOptionalResources(\n\trecord: Record<string, unknown>,\n\tkey: string,\n\terrors: string[],\n): StoreResourceType[] | undefined {\n\tconst value = record[key];\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (!Array.isArray(value)) {\n\t\terrors.push(`${key} must be an array`);\n\t\treturn undefined;\n\t}\n\n\tconst resources: StoreResourceType[] = [];\n\tfor (const entry of value) {\n\t\tif (typeof entry !== \"string\" || !RESOURCE_TYPES.has(entry as StoreResourceType)) {\n\t\t\terrors.push(`${key} contains an invalid resource type`);\n\t\t\treturn undefined;\n\t\t}\n\t\tresources.push(entry as StoreResourceType);\n\t}\n\treturn resources;\n}\n\nfunction readOptionalCompatibility(\n\trecord: Record<string, unknown>,\n\tkey: string,\n\terrors: string[],\n): { volt?: string } | undefined {\n\tconst value = record[key];\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (!isRecord(value)) {\n\t\terrors.push(`${key} must be an object`);\n\t\treturn undefined;\n\t}\n\tconst volt = readOptionalString(value, \"volt\", errors);\n\treturn volt === undefined ? {} : { volt };\n}\n\nfunction validateCatalogPackage(value: unknown, index: number): { pkg?: StoreCatalogPackage; errors: string[] } {\n\tconst errors: string[] = [];\n\tif (!isRecord(value)) {\n\t\treturn { errors: [`packages[${index}] must be an object`] };\n\t}\n\n\tconst id = readRequiredString(value, \"id\", errors);\n\tconst name = readRequiredString(value, \"name\", errors);\n\tconst description = readRequiredString(value, \"description\", errors);\n\tconst source = readRequiredString(value, \"source\", errors);\n\tconst repo = readOptionalString(value, \"repo\", errors);\n\tconst author = readOptionalString(value, \"author\", errors);\n\tconst license = readOptionalString(value, \"license\", errors);\n\tconst verified = readOptionalBoolean(value, \"verified\", errors);\n\tconst categories = readOptionalStringArray(value, \"categories\", errors);\n\tconst resources = readOptionalResources(value, \"resources\", errors);\n\tconst compatibility = readOptionalCompatibility(value, \"compatibility\", errors);\n\tconst image = readOptionalString(value, \"image\", errors);\n\tconst video = readOptionalString(value, \"video\", errors);\n\n\tif (errors.length > 0 || !id || !name || !description || !source) {\n\t\treturn { errors };\n\t}\n\n\tconst pkg: StoreCatalogPackage = {\n\t\tid,\n\t\tname,\n\t\tdescription,\n\t\tsource,\n\t\t...(repo !== undefined ? { repo } : {}),\n\t\t...(author !== undefined ? { author } : {}),\n\t\t...(license !== undefined ? { license } : {}),\n\t\t...(verified !== undefined ? { verified } : {}),\n\t\t...(categories !== undefined ? { categories } : {}),\n\t\t...(resources !== undefined ? { resources } : {}),\n\t\t...(compatibility !== undefined ? { compatibility } : {}),\n\t\t...(image !== undefined ? { image } : {}),\n\t\t...(video !== undefined ? { video } : {}),\n\t};\n\treturn { pkg, errors: [] };\n}\n\nexport function validateStoreCatalog(value: unknown): StoreCatalogValidationResult {\n\tif (!isRecord(value)) {\n\t\tthrow new Error(\"Store catalog must be a JSON object\");\n\t}\n\tif (value.schemaVersion !== 1) {\n\t\tthrow new Error(\"Store catalog schemaVersion must be 1\");\n\t}\n\tif (!Array.isArray(value.packages)) {\n\t\tthrow new Error(\"Store catalog packages must be an array\");\n\t}\n\n\tconst warnings: string[] = [];\n\tconst packages: StoreCatalogPackage[] = [];\n\tconst seenIds = new Set<string>();\n\tfor (let index = 0; index < value.packages.length; index++) {\n\t\tconst result = validateCatalogPackage(value.packages[index], index);\n\t\tif (!result.pkg) {\n\t\t\twarnings.push(`Skipping invalid catalog package at index ${index}: ${result.errors.join(\"; \")}`);\n\t\t\tcontinue;\n\t\t}\n\t\tif (seenIds.has(result.pkg.id)) {\n\t\t\twarnings.push(`Skipping duplicate catalog package id \"${result.pkg.id}\" at index ${index}`);\n\t\t\tcontinue;\n\t\t}\n\t\tseenIds.add(result.pkg.id);\n\t\tpackages.push(result.pkg);\n\t}\n\n\treturn {\n\t\tcatalog: { schemaVersion: 1, packages },\n\t\twarnings,\n\t};\n}\n\nexport function parseStoreCatalogJson(raw: string, label = \"store catalog\"): StoreCatalogValidationResult {\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(raw) as unknown;\n\t} catch (error: unknown) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new Error(`Failed to parse ${label}: ${message}`);\n\t}\n\treturn validateStoreCatalog(parsed);\n}\n\nexport function getStoreCatalogCachePath(agentDir: string, url = getDefaultCatalogUrl()): string {\n\tconst cacheKey = createHash(\"sha256\").update(url).digest(\"hex\");\n\treturn join(agentDir, \"store\", \"catalogs\", `${cacheKey}.json`);\n}\n\nfunction isOfflineModeEnabled(): boolean {\n\tconst value = process.env.VOLT_OFFLINE;\n\tif (!value) return false;\n\treturn value === \"1\" || value.toLowerCase() === \"true\" || value.toLowerCase() === \"yes\";\n}\n\nfunction getDefaultCatalogUrl(url?: string): string {\n\treturn url ?? process.env.VOLT_STORE_CATALOG_URL ?? DEFAULT_STORE_CATALOG_URL;\n}\n\nfunction readCachedCatalog(agentDir: string, url: string): LoadStoreCatalogResult | undefined {\n\tconst cachePath = getStoreCatalogCachePath(agentDir, url);\n\tif (!existsSync(cachePath)) {\n\t\treturn undefined;\n\t}\n\n\tconst result = parseStoreCatalogJson(readFileSync(cachePath, \"utf-8\"), \"cached store catalog\");\n\treturn {\n\t\tcatalog: result.catalog,\n\t\tsource: \"cache\",\n\t\twarnings: result.warnings,\n\t};\n}\n\nfunction writeCachedCatalog(agentDir: string, url: string, raw: string): void {\n\tconst cachePath = getStoreCatalogCachePath(agentDir, url);\n\tmkdirSync(join(agentDir, \"store\", \"catalogs\"), { recursive: true, mode: 0o700 });\n\twriteFileSync(cachePath, raw, \"utf-8\");\n}\n\nasync function withCatalogFetchTimeout<T>(\n\ttimeoutMs: number,\n\toperation: (signal: AbortSignal) => Promise<T>,\n): Promise<T> {\n\tconst controller = new AbortController();\n\tlet timeout: ReturnType<typeof setTimeout> | undefined;\n\tlet timedOut = false;\n\tconst timeoutMessage = `Store catalog fetch timed out after ${timeoutMs}ms`;\n\n\ttry {\n\t\treturn await new Promise<T>((resolve, reject) => {\n\t\t\ttimeout = setTimeout(() => {\n\t\t\t\ttimedOut = true;\n\t\t\t\tcontroller.abort();\n\t\t\t\treject(new Error(timeoutMessage));\n\t\t\t}, timeoutMs);\n\t\t\toperation(controller.signal).then(resolve, reject);\n\t\t});\n\t} catch (error: unknown) {\n\t\tif (timedOut) {\n\t\t\tthrow new Error(timeoutMessage);\n\t\t}\n\t\tthrow error;\n\t} finally {\n\t\tif (timeout) {\n\t\t\tclearTimeout(timeout);\n\t\t}\n\t}\n}\n\nexport async function loadDefaultStoreCatalog(\n\toptions: LoadDefaultStoreCatalogOptions,\n): Promise<LoadStoreCatalogResult> {\n\tconst url = getDefaultCatalogUrl(options.url);\n\tconst offline = options.offline ?? isOfflineModeEnabled();\n\tif (offline) {\n\t\ttry {\n\t\t\tconst cached = readCachedCatalog(options.agentDir, url);\n\t\t\tif (cached) {\n\t\t\t\treturn {\n\t\t\t\t\t...cached,\n\t\t\t\t\twarnings: [\"Offline mode enabled; using cached store catalog.\", ...cached.warnings],\n\t\t\t\t};\n\t\t\t}\n\t\t} catch (error: unknown) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\treturn {\n\t\t\t\tcatalog: { schemaVersion: 1, packages: [] },\n\t\t\t\tsource: \"empty\",\n\t\t\t\twarnings: [`Offline mode enabled and cached store catalog is invalid: ${message}`],\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tcatalog: { schemaVersion: 1, packages: [] },\n\t\t\tsource: \"empty\",\n\t\t\twarnings: [\"Offline mode enabled and no cached store catalog is available.\"],\n\t\t};\n\t}\n\n\tconst fetcher: StoreCatalogFetcher = options.fetcher ?? ((input, init) => globalThis.fetch(input, init));\n\tconst timeoutMs = Math.max(1, Math.trunc(options.timeoutMs ?? DEFAULT_STORE_CATALOG_FETCH_TIMEOUT_MS));\n\ttry {\n\t\tconst { raw, result } = await withCatalogFetchTimeout(timeoutMs, async (signal) => {\n\t\t\tconst response = await fetcher(url, { signal });\n\t\t\tif (!response.ok) {\n\t\t\t\tthrow new Error(`HTTP ${response.status}`);\n\t\t\t}\n\t\t\tconst rawCatalog = await response.text();\n\t\t\treturn {\n\t\t\t\traw: rawCatalog,\n\t\t\t\tresult: parseStoreCatalogJson(rawCatalog, \"remote store catalog\"),\n\t\t\t};\n\t\t});\n\t\tconst warnings = [...result.warnings];\n\t\ttry {\n\t\t\twriteCachedCatalog(options.agentDir, url, raw);\n\t\t} catch (error: unknown) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\twarnings.push(`Failed to cache remote store catalog: ${message}`);\n\t\t}\n\t\treturn {\n\t\t\tcatalog: result.catalog,\n\t\t\tsource: \"remote\",\n\t\t\twarnings,\n\t\t};\n\t} catch (error: unknown) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tconst cached = readCachedCatalog(options.agentDir, url);\n\t\tif (cached) {\n\t\t\treturn {\n\t\t\t\t...cached,\n\t\t\t\twarnings: [`Failed to load remote store catalog (${message}); using cached catalog.`, ...cached.warnings],\n\t\t\t};\n\t\t}\n\t\tthrow new Error(`Failed to load store catalog: ${message}`);\n\t}\n}\n\nexport function findCatalogPackage(catalog: StoreCatalog, id: string): StoreCatalogPackage | undefined {\n\treturn catalog.packages.find((pkg) => pkg.id === id);\n}\n\nexport function searchCatalogPackages(catalog: StoreCatalog, query?: string): StoreCatalogPackage[] {\n\tconst normalizedQuery = query?.trim().toLowerCase();\n\tif (!normalizedQuery) {\n\t\treturn [...catalog.packages];\n\t}\n\n\treturn catalog.packages.filter((pkg) => {\n\t\tconst fields = [pkg.id, pkg.name, pkg.description, ...(pkg.categories ?? [])];\n\t\treturn fields.some((field) => field.toLowerCase().includes(normalizedQuery));\n\t});\n}\n\nfunction levenshteinDistance(left: string, right: string): number {\n\tconst previous = new Array<number>(right.length + 1);\n\tconst current = new Array<number>(right.length + 1);\n\tfor (let index = 0; index <= right.length; index++) {\n\t\tprevious[index] = index;\n\t}\n\tfor (let leftIndex = 1; leftIndex <= left.length; leftIndex++) {\n\t\tcurrent[0] = leftIndex;\n\t\tfor (let rightIndex = 1; rightIndex <= right.length; rightIndex++) {\n\t\t\tconst cost = left[leftIndex - 1] === right[rightIndex - 1] ? 0 : 1;\n\t\t\tcurrent[rightIndex] = Math.min(\n\t\t\t\tcurrent[rightIndex - 1] + 1,\n\t\t\t\tprevious[rightIndex] + 1,\n\t\t\t\tprevious[rightIndex - 1] + cost,\n\t\t\t);\n\t\t}\n\t\tfor (let index = 0; index <= right.length; index++) {\n\t\t\tprevious[index] = current[index];\n\t\t}\n\t}\n\treturn previous[right.length] ?? 0;\n}\n\nexport function suggestCatalogPackageIds(catalog: StoreCatalog, input: string, limit = 3): string[] {\n\tconst normalizedInput = input.toLowerCase();\n\treturn catalog.packages\n\t\t.map((pkg) => ({\n\t\t\tid: pkg.id,\n\t\t\tscore: pkg.id.toLowerCase().includes(normalizedInput)\n\t\t\t\t? 0\n\t\t\t\t: levenshteinDistance(normalizedInput, pkg.id.toLowerCase()),\n\t\t}))\n\t\t.filter((entry) => entry.score <= Math.max(2, Math.floor(normalizedInput.length / 2)))\n\t\t.sort((left, right) => left.score - right.score || left.id.localeCompare(right.id))\n\t\t.slice(0, limit)\n\t\t.map((entry) => entry.id);\n}\n"]}

package/dist/store/inspector.d.ts

@@ -0,0 +1,36 @@
+import type { StoreResourceType } from "./catalog.ts";
+export interface StoreVoltManifest {
+    extensions?: string[];
+    skills?: string[];
+    prompts?: string[];
+    themes?: string[];
+    image?: string;
+    video?: string;
+}
+export interface StorePackageInspection {
+    source: string;
+    packageName?: string;
+    packageVersion?: string;
+    packageDescription?: string;
+    packageLicense?: string;
+    packageRepository?: string;
+    voltManifest?: StoreVoltManifest;
+    discoveredResources: Record<StoreResourceType, string[]>;
+    dependencies: Record<string, string>;
+    peerDependencies: Record<string, string>;
+    optionalDependencies: Record<string, string>;
+    scripts: Record<string, string>;
+    warnings: string[];
+}
+export interface InspectStorePackageOptions {
+    source: string;
+    cwd: string;
+    npmCommand?: string[];
+}
+interface InspectionDiscoveryOptions {
+    localFallbackExtension?: boolean;
+}
+export declare function inspectPackageDirectory(source: string, root: string, initialWarnings?: string[], discoveryOptions?: InspectionDiscoveryOptions): StorePackageInspection;
+export declare function inspectStorePackage(options: InspectStorePackageOptions): Promise<StorePackageInspection>;
+export {};
+//# sourceMappingURL=inspector.d.ts.map

package/dist/store/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../src/store/inspector.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IACjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAqBD,UAAU,0BAA0B;IACnC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACjC;AA+kBD,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,eAAe,GAAE,MAAM,EAAO,EAC9B,gBAAgB,CAAC,EAAE,0BAA0B,GAC3C,sBAAsB,CAwBxB;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgB9G","sourcesContent":["import type { ChildProcessByStdio } from \"node:child_process\";\nimport { type Dirent, existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, type Stats, statSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { basename, dirname, join, relative, resolve, sep } from \"node:path\";\nimport type { Readable } from \"node:stream\";\nimport { globSync } from \"glob\";\nimport { minimatch } from \"minimatch\";\nimport { spawnProcess } from \"../utils/child-process.ts\";\nimport { parseGitUrl } from \"../utils/git.ts\";\nimport { addIgnoreRules, createIgnoreMatcher, type IgnoreMatcher } from \"../utils/ignore-files.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { getSubprocessEnv } from \"../utils/process-env.ts\";\nimport type { StoreResourceType } from \"./catalog.ts\";\n\nexport interface StoreVoltManifest {\n\textensions?: string[];\n\tskills?: string[];\n\tprompts?: string[];\n\tthemes?: string[];\n\timage?: string;\n\tvideo?: string;\n}\n\nexport interface StorePackageInspection {\n\tsource: string;\n\tpackageName?: string;\n\tpackageVersion?: string;\n\tpackageDescription?: string;\n\tpackageLicense?: string;\n\tpackageRepository?: string;\n\tvoltManifest?: StoreVoltManifest;\n\tdiscoveredResources: Record<StoreResourceType, string[]>;\n\tdependencies: Record<string, string>;\n\tpeerDependencies: Record<string, string>;\n\toptionalDependencies: Record<string, string>;\n\tscripts: Record<string, string>;\n\twarnings: string[];\n}\n\nexport interface InspectStorePackageOptions {\n\tsource: string;\n\tcwd: string;\n\tnpmCommand?: string[];\n}\n\ninterface CommandCaptureOptions {\n\tcwd?: string;\n\ttimeoutMs?: number;\n\tenv?: Record<string, string>;\n}\n\ninterface PackageJsonData {\n\tname?: string;\n\tversion?: string;\n\tdescription?: string;\n\tlicense?: string;\n\trepository?: string;\n\tvoltManifest?: StoreVoltManifest;\n\tdependencies: Record<string, string>;\n\tpeerDependencies: Record<string, string>;\n\toptionalDependencies: Record<string, string>;\n\tscripts: Record<string, string>;\n}\n\ninterface InspectionDiscoveryOptions {\n\tlocalFallbackExtension?: boolean;\n}\n\nconst RESOURCE_TYPES: StoreResourceType[] = [\"extensions\", \"skills\", \"prompts\", \"themes\"];\nconst EMPTY_RESOURCES: Record<StoreResourceType, string[]> = {\n\textensions: [],\n\tskills: [],\n\tprompts: [],\n\tthemes: [],\n};\nconst FILE_PATTERNS: Record<StoreResourceType, RegExp> = {\n\textensions: /\\.(ts|js)$/,\n\tskills: /\\.md$/,\n\tprompts: /\\.md$/,\n\tthemes: /\\.json$/,\n};\nconst COMMAND_TIMEOUT_MS = 30000;\n\nfunction toPosixPath(path: string): string {\n\treturn path.split(sep).join(\"/\");\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction readString(value: unknown): string | undefined {\n\treturn typeof value === \"string\" ? value : undefined;\n}\n\nfunction readStringArray(value: unknown): string[] | undefined {\n\tif (!Array.isArray(value) || !value.every((entry) => typeof entry === \"string\")) {\n\t\treturn undefined;\n\t}\n\treturn [...value];\n}\n\nfunction readStringRecord(value: unknown): Record<string, string> {\n\tif (!isRecord(value)) {\n\t\treturn {};\n\t}\n\tconst result: Record<string, string> = {};\n\tfor (const [key, entry] of Object.entries(value)) {\n\t\tif (typeof entry === \"string\") {\n\t\t\tresult[key] = entry;\n\t\t}\n\t}\n\treturn result;\n}\n\nfunction readRepository(value: unknown): string | undefined {\n\tif (typeof value === \"string\") {\n\t\treturn value;\n\t}\n\tif (isRecord(value)) {\n\t\treturn readString(value.url);\n\t}\n\treturn undefined;\n}\n\nfunction readLicense(value: unknown): string | undefined {\n\tif (typeof value === \"string\") {\n\t\treturn value;\n\t}\n\tif (isRecord(value)) {\n\t\treturn readString(value.type);\n\t}\n\treturn undefined;\n}\n\nfunction readVoltManifest(value: unknown): StoreVoltManifest | undefined {\n\tif (!value) {\n\t\treturn undefined;\n\t}\n\tif (!isRecord(value)) {\n\t\treturn {};\n\t}\n\tconst manifest: StoreVoltManifest = {};\n\tconst extensions = readStringArray(value.extensions);\n\tconst skills = readStringArray(value.skills);\n\tconst prompts = readStringArray(value.prompts);\n\tconst themes = readStringArray(value.themes);\n\tconst image = readString(value.image);\n\tconst video = readString(value.video);\n\tif (extensions !== undefined) manifest.extensions = extensions;\n\tif (skills !== undefined) manifest.skills = skills;\n\tif (prompts !== undefined) manifest.prompts = prompts;\n\tif (themes !== undefined) manifest.themes = themes;\n\tif (image !== undefined) manifest.image = image;\n\tif (video !== undefined) manifest.video = video;\n\treturn manifest;\n}\n\nfunction readPackageJsonData(value: unknown): PackageJsonData {\n\tif (!isRecord(value)) {\n\t\treturn {\n\t\t\tdependencies: {},\n\t\t\tpeerDependencies: {},\n\t\t\toptionalDependencies: {},\n\t\t\tscripts: {},\n\t\t};\n\t}\n\treturn {\n\t\tname: readString(value.name),\n\t\tversion: readString(value.version),\n\t\tdescription: readString(value.description),\n\t\tlicense: readLicense(value.license),\n\t\trepository: readRepository(value.repository),\n\t\tvoltManifest: readVoltManifest(value.volt),\n\t\tdependencies: readStringRecord(value.dependencies),\n\t\tpeerDependencies: readStringRecord(value.peerDependencies),\n\t\toptionalDependencies: readStringRecord(value.optionalDependencies),\n\t\tscripts: readStringRecord(value.scripts),\n\t};\n}\n\nfunction readPackageJsonFile(packageJsonPath: string): PackageJsonData {\n\tconst parsed = JSON.parse(readFileSync(packageJsonPath, \"utf-8\")) as unknown;\n\treturn readPackageJsonData(parsed);\n}\n\nfunction isDirectory(path: string): boolean {\n\ttry {\n\t\treturn statSync(path).isDirectory();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction statIfExists(path: string): Stats | undefined {\n\ttry {\n\t\treturn statSync(path);\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction getDirentKind(entry: Dirent, fullPath: string): { isDirectory: boolean; isFile: boolean } | undefined {\n\tif (!entry.isSymbolicLink()) {\n\t\treturn { isDirectory: entry.isDirectory(), isFile: entry.isFile() };\n\t}\n\tconst stats = statIfExists(fullPath);\n\tif (!stats) {\n\t\treturn undefined;\n\t}\n\treturn { isDirectory: stats.isDirectory(), isFile: stats.isFile() };\n}\n\nfunction collectSkillResourceFiles(dir: string, root = dir, ignoreMatcher?: IgnoreMatcher): string[] {\n\tif (!existsSync(dir)) {\n\t\treturn [];\n\t}\n\n\tconst ig = ignoreMatcher ?? createIgnoreMatcher();\n\taddIgnoreRules(ig, dir, root);\n\tconst entries = readdirSync(dir, { withFileTypes: true });\n\tfor (const entry of entries) {\n\t\tconst fullPath = join(dir, entry.name);\n\t\tconst kind = getDirentKind(entry, fullPath);\n\t\tif (!kind) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst relPath = toPosixPath(relative(root, fullPath));\n\t\tif (entry.name === \"SKILL.md\" && kind.isFile && !ig.ignores(relPath)) {\n\t\t\treturn [fullPath];\n\t\t}\n\t}\n\n\tconst files: string[] = [];\n\tfor (const entry of entries) {\n\t\tif (entry.name.startsWith(\".\") || entry.name === \"node_modules\") {\n\t\t\tcontinue;\n\t\t}\n\t\tconst fullPath = join(dir, entry.name);\n\t\tconst kind = getDirentKind(entry, fullPath);\n\t\tif (!kind) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst relPath = toPosixPath(relative(root, fullPath));\n\t\tif (kind.isDirectory) {\n\t\t\tif (ig.ignores(`${relPath}/`)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tfiles.push(...collectSkillResourceFiles(fullPath, root, ig));\n\t\t} else if (dir === root && kind.isFile && FILE_PATTERNS.skills.test(entry.name) && !ig.ignores(relPath)) {\n\t\t\tfiles.push(fullPath);\n\t\t}\n\t}\n\treturn files;\n}\n\nfunction collectResourceFiles(\n\tdir: string,\n\tresourceType: StoreResourceType,\n\troot = dir,\n\tignoreMatcher?: IgnoreMatcher,\n): string[] {\n\tif (resourceType === \"extensions\") {\n\t\treturn collectConventionalExtensionFiles(dir);\n\t}\n\tif (resourceType === \"skills\") {\n\t\treturn collectSkillResourceFiles(dir);\n\t}\n\tif (!existsSync(dir)) {\n\t\treturn [];\n\t}\n\n\tconst ig = ignoreMatcher ?? createIgnoreMatcher();\n\taddIgnoreRules(ig, dir, root);\n\tconst files: string[] = [];\n\tfor (const entry of readdirSync(dir, { withFileTypes: true })) {\n\t\tif (entry.name.startsWith(\".\") || entry.name === \"node_modules\") {\n\t\t\tcontinue;\n\t\t}\n\t\tconst fullPath = join(dir, entry.name);\n\t\tconst kind = getDirentKind(entry, fullPath);\n\t\tif (!kind) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst relPath = toPosixPath(relative(root, fullPath));\n\t\tconst ignorePath = kind.isDirectory ? `${relPath}/` : relPath;\n\t\tif (ig.ignores(ignorePath)) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (kind.isDirectory) {\n\t\t\tfiles.push(...collectResourceFiles(fullPath, resourceType, root, ig));\n\t\t} else if (kind.isFile && FILE_PATTERNS[resourceType].test(entry.name)) {\n\t\t\tfiles.push(fullPath);\n\t\t}\n\t}\n\treturn files;\n}\n\nfunction readVoltManifestFile(packageJsonPath: string): StoreVoltManifest | undefined {\n\ttry {\n\t\treturn readPackageJsonFile(packageJsonPath).voltManifest;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction resolveConventionalExtensionEntries(dir: string): string[] | undefined {\n\tconst packageJsonPath = join(dir, \"package.json\");\n\tif (existsSync(packageJsonPath)) {\n\t\tconst manifest = readVoltManifestFile(packageJsonPath);\n\t\tif (manifest?.extensions?.length) {\n\t\t\tconst entries = manifest.extensions.map((entry) => resolve(dir, entry)).filter((entry) => existsSync(entry));\n\t\t\tif (entries.length > 0) {\n\t\t\t\treturn entries;\n\t\t\t}\n\t\t}\n\t}\n\n\tconst indexTs = join(dir, \"index.ts\");\n\tconst indexJs = join(dir, \"index.js\");\n\tif (existsSync(indexTs)) {\n\t\treturn [indexTs];\n\t}\n\tif (existsSync(indexJs)) {\n\t\treturn [indexJs];\n\t}\n\treturn undefined;\n}\n\nfunction collectConventionalExtensionFiles(dir: string): string[] {\n\tif (!existsSync(dir)) {\n\t\treturn [];\n\t}\n\n\tconst rootEntries = resolveConventionalExtensionEntries(dir);\n\tif (rootEntries) {\n\t\treturn rootEntries;\n\t}\n\n\tconst ig = createIgnoreMatcher();\n\taddIgnoreRules(ig, dir, dir);\n\tconst files: string[] = [];\n\tfor (const entry of readdirSync(dir, { withFileTypes: true })) {\n\t\tif (entry.name.startsWith(\".\") || entry.name === \"node_modules\") {\n\t\t\tcontinue;\n\t\t}\n\t\tconst fullPath = join(dir, entry.name);\n\t\tconst kind = getDirentKind(entry, fullPath);\n\t\tif (!kind) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst relPath = toPosixPath(relative(dir, fullPath));\n\t\tconst ignorePath = kind.isDirectory ? `${relPath}/` : relPath;\n\t\tif (ig.ignores(ignorePath)) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (kind.isDirectory) {\n\t\t\tconst resolvedEntries = resolveConventionalExtensionEntries(fullPath);\n\t\t\tif (resolvedEntries) {\n\t\t\t\tfiles.push(...resolvedEntries);\n\t\t\t}\n\t\t} else if (kind.isFile && FILE_PATTERNS.extensions.test(entry.name)) {\n\t\t\tfiles.push(fullPath);\n\t\t}\n\t}\n\treturn files;\n}\n\nfunction collectFilesFromPaths(paths: string[], resourceType: StoreResourceType): string[] {\n\tconst files: string[] = [];\n\tfor (const path of paths) {\n\t\tconst stats = statIfExists(path);\n\t\tif (!stats) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (stats.isDirectory()) {\n\t\t\tfiles.push(...collectResourceFiles(path, resourceType));\n\t\t} else if (stats.isFile()) {\n\t\t\tfiles.push(path);\n\t\t}\n\t}\n\treturn files;\n}\n\nfunction hasGlobPattern(entry: string): boolean {\n\treturn entry.includes(\"*\") || entry.includes(\"?\");\n}\n\nfunction isOverridePattern(entry: string): boolean {\n\treturn entry.startsWith(\"!\") || entry.startsWith(\"+\") || entry.startsWith(\"-\");\n}\n\nfunction matchesAnyPattern(filePath: string, patterns: string[], baseDir: string): boolean {\n\tconst rel = toPosixPath(relative(baseDir, filePath));\n\tconst name = basename(filePath);\n\tconst filePathPosix = toPosixPath(filePath);\n\tconst isSkillFile = name === \"SKILL.md\";\n\tconst parentDir = isSkillFile ? dirname(filePath) : undefined;\n\tconst parentRel = isSkillFile ? toPosixPath(relative(baseDir, parentDir!)) : undefined;\n\tconst parentName = isSkillFile ? basename(parentDir!) : undefined;\n\tconst parentDirPosix = isSkillFile ? toPosixPath(parentDir!) : undefined;\n\n\treturn patterns.some((pattern) => {\n\t\tconst normalizedPattern = toPosixPath(pattern);\n\t\tif (\n\t\t\tminimatch(rel, normalizedPattern) ||\n\t\t\tminimatch(name, normalizedPattern) ||\n\t\t\tminimatch(filePathPosix, normalizedPattern)\n\t\t) {\n\t\t\treturn true;\n\t\t}\n\t\tif (!isSkillFile) return false;\n\t\treturn (\n\t\t\tminimatch(parentRel!, normalizedPattern) ||\n\t\t\tminimatch(parentName!, normalizedPattern) ||\n\t\t\tminimatch(parentDirPosix!, normalizedPattern)\n\t\t);\n\t});\n}\n\nfunction normalizeExactPattern(pattern: string): string {\n\tconst normalized = pattern.startsWith(\"./\") || pattern.startsWith(\".\\\\\") ? pattern.slice(2) : pattern;\n\treturn toPosixPath(normalized);\n}\n\nfunction matchesAnyExactPattern(filePath: string, patterns: string[], baseDir: string): boolean {\n\tif (patterns.length === 0) return false;\n\tconst rel = toPosixPath(relative(baseDir, filePath));\n\tconst name = basename(filePath);\n\tconst filePathPosix = toPosixPath(filePath);\n\tconst isSkillFile = name === \"SKILL.md\";\n\tconst parentDir = isSkillFile ? dirname(filePath) : undefined;\n\tconst parentRel = isSkillFile ? toPosixPath(relative(baseDir, parentDir!)) : undefined;\n\tconst parentDirPosix = isSkillFile ? toPosixPath(parentDir!) : undefined;\n\n\treturn patterns.some((pattern) => {\n\t\tconst normalized = normalizeExactPattern(pattern);\n\t\tif (normalized === rel || normalized === filePathPosix) {\n\t\t\treturn true;\n\t\t}\n\t\tif (!isSkillFile) return false;\n\t\treturn normalized === parentRel || normalized === parentDirPosix;\n\t});\n}\n\nfunction applyManifestPatterns(allFiles: string[], entries: string[], baseDir: string): Set<string> {\n\tconst includes: string[] = [];\n\tconst excludes: string[] = [];\n\tconst forceIncludes: string[] = [];\n\tconst forceExcludes: string[] = [];\n\n\tfor (const entry of entries) {\n\t\tif (entry.startsWith(\"+\")) {\n\t\t\tforceIncludes.push(entry.slice(1));\n\t\t} else if (entry.startsWith(\"-\")) {\n\t\t\tforceExcludes.push(entry.slice(1));\n\t\t} else if (entry.startsWith(\"!\")) {\n\t\t\texcludes.push(entry.slice(1));\n\t\t} else {\n\t\t\tincludes.push(entry);\n\t\t}\n\t}\n\n\tlet result =\n\t\tincludes.length === 0 ? [...allFiles] : allFiles.filter((file) => matchesAnyPattern(file, includes, baseDir));\n\tif (excludes.length > 0) {\n\t\tresult = result.filter((file) => !matchesAnyPattern(file, excludes, baseDir));\n\t}\n\tif (forceIncludes.length > 0) {\n\t\tfor (const file of allFiles) {\n\t\t\tif (!result.includes(file) && matchesAnyExactPattern(file, forceIncludes, baseDir)) {\n\t\t\t\tresult.push(file);\n\t\t\t}\n\t\t}\n\t}\n\tif (forceExcludes.length > 0) {\n\t\tresult = result.filter((file) => !matchesAnyExactPattern(file, forceExcludes, baseDir));\n\t}\n\treturn new Set(result);\n}\n\nfunction collectManifestFiles(root: string, entries: string[], resourceType: StoreResourceType): string[] {\n\tconst sourceEntries = entries.filter((entry) => !isOverridePattern(entry));\n\tconst resolved = sourceEntries.flatMap((entry) => {\n\t\tif (!hasGlobPattern(entry)) {\n\t\t\treturn [resolve(root, entry)];\n\t\t}\n\t\treturn globSync(entry, {\n\t\t\tcwd: root,\n\t\t\tabsolute: true,\n\t\t\tdot: false,\n\t\t\tnodir: false,\n\t\t}).map((match) => resolve(match));\n\t});\n\tconst files = collectFilesFromPaths(resolved, resourceType);\n\tconst overridePatterns = entries.filter(isOverridePattern);\n\tconst enabled = applyManifestPatterns(files, overridePatterns, root);\n\treturn files.filter((file) => enabled.has(file));\n}\n\nfunction toRelativeResourcePath(root: string, path: string): string {\n\treturn toPosixPath(relative(root, path)) || \".\";\n}\n\nfunction discoverResources(\n\troot: string,\n\tvoltManifest?: StoreVoltManifest,\n\toptions: InspectionDiscoveryOptions = {},\n): Record<StoreResourceType, string[]> {\n\tconst discovered = structuredClone(EMPTY_RESOURCES);\n\tif (voltManifest) {\n\t\tfor (const resourceType of RESOURCE_TYPES) {\n\t\t\tconst entries = voltManifest[resourceType];\n\t\t\tdiscovered[resourceType] = entries\n\t\t\t\t? collectManifestFiles(root, entries, resourceType).map((path) => toRelativeResourcePath(root, path))\n\t\t\t\t: [];\n\t\t}\n\t\treturn discovered;\n\t}\n\n\tlet hasAnyResourcePath = false;\n\tfor (const resourceType of RESOURCE_TYPES) {\n\t\tconst dir = join(root, resourceType);\n\t\tif (existsSync(dir)) {\n\t\t\thasAnyResourcePath = true;\n\t\t}\n\t\tdiscovered[resourceType] = isDirectory(dir)\n\t\t\t? collectResourceFiles(dir, resourceType).map((path) => toRelativeResourcePath(root, path))\n\t\t\t: [];\n\t}\n\tif (options.localFallbackExtension && !hasAnyResourcePath) {\n\t\tconst stats = statIfExists(root);\n\t\tif (stats?.isDirectory() || stats?.isFile()) {\n\t\t\tdiscovered.extensions = [toRelativeResourcePath(root, root)];\n\t\t}\n\t}\n\treturn discovered;\n}\n\nfunction buildInspection(\n\tsource: string,\n\tpkg: PackageJsonData,\n\troot: string | undefined,\n\twarnings: string[],\n\tdiscoveryOptions?: InspectionDiscoveryOptions,\n) {\n\tconst inspection: StorePackageInspection = {\n\t\tsource,\n\t\t...(pkg.name !== undefined ? { packageName: pkg.name } : {}),\n\t\t...(pkg.version !== undefined ? { packageVersion: pkg.version } : {}),\n\t\t...(pkg.description !== undefined ? { packageDescription: pkg.description } : {}),\n\t\t...(pkg.license !== undefined ? { packageLicense: pkg.license } : {}),\n\t\t...(pkg.repository !== undefined ? { packageRepository: pkg.repository } : {}),\n\t\t...(pkg.voltManifest !== undefined ? { voltManifest: pkg.voltManifest } : {}),\n\t\tdiscoveredResources: root\n\t\t\t? discoverResources(root, pkg.voltManifest, discoveryOptions)\n\t\t\t: structuredClone(EMPTY_RESOURCES),\n\t\tdependencies: pkg.dependencies,\n\t\tpeerDependencies: pkg.peerDependencies,\n\t\toptionalDependencies: pkg.optionalDependencies,\n\t\tscripts: pkg.scripts,\n\t\twarnings,\n\t};\n\treturn inspection;\n}\n\nfunction getNpmCommand(npmCommand?: string[]): { command: string; args: string[] } {\n\tif (!npmCommand || npmCommand.length === 0) {\n\t\treturn { command: \"npm\", args: [] };\n\t}\n\tconst [command, ...args] = npmCommand;\n\tif (!command) {\n\t\tthrow new Error(\"Invalid npmCommand: first array entry must be a non-empty command\");\n\t}\n\treturn { command, args };\n}\n\nfunction runCommandCapture(command: string, args: string[], options: CommandCaptureOptions = {}): Promise<string> {\n\treturn new Promise((resolvePromise, reject) => {\n\t\tconst baseEnv = getSubprocessEnv();\n\t\tconst child = spawnProcess(command, args, {\n\t\t\tcwd: options.cwd,\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t\tenv: options.env ? { ...baseEnv, ...options.env } : baseEnv,\n\t\t}) as ChildProcessByStdio<null, Readable, Readable>;\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet timedOut = false;\n\t\tconst timeout = setTimeout(() => {\n\t\t\ttimedOut = true;\n\t\t\tchild.kill();\n\t\t}, options.timeoutMs ?? COMMAND_TIMEOUT_MS);\n\t\tchild.stdout.on(\"data\", (data) => {\n\t\t\tstdout += data.toString();\n\t\t});\n\t\tchild.stderr.on(\"data\", (data) => {\n\t\t\tstderr += data.toString();\n\t\t});\n\t\tchild.once(\"error\", (error) => {\n\t\t\tclearTimeout(timeout);\n\t\t\treject(error);\n\t\t});\n\t\tchild.once(\"close\", (code, signal) => {\n\t\t\tclearTimeout(timeout);\n\t\t\tif (timedOut) {\n\t\t\t\treject(new Error(`${command} ${args.join(\" \")} timed out`));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (code === 0) {\n\t\t\t\tresolvePromise(stdout.trim());\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst status = code === null ? `signal ${signal ?? \"unknown\"}` : `code ${code}`;\n\t\t\treject(new Error(`${command} ${args.join(\" \")} failed with ${status}: ${stderr || stdout}`));\n\t\t});\n\t});\n}\n\nasync function runCommand(command: string, args: string[], options: CommandCaptureOptions = {}): Promise<void> {\n\tawait runCommandCapture(command, args, options);\n}\n\nasync function inspectNpmPackage(options: InspectStorePackageOptions): Promise<StorePackageInspection> {\n\tconst spec = options.source.slice(\"npm:\".length).trim();\n\tconst npmCommand = getNpmCommand(options.npmCommand);\n\tconst output = await runCommandCapture(npmCommand.command, [...npmCommand.args, \"view\", spec, \"--json\"], {\n\t\tcwd: options.cwd,\n\t});\n\tconst parsed = JSON.parse(output) as unknown;\n\tconst manifest = Array.isArray(parsed) ? parsed[parsed.length - 1] : parsed;\n\tconst pkg = readPackageJsonData(manifest);\n\tconst warnings = [\"npm inspection uses registry metadata only; exact package files are resolved during install.\"];\n\treturn buildInspection(options.source, pkg, undefined, warnings);\n}\n\nasync function inspectGitPackage(options: InspectStorePackageOptions): Promise<StorePackageInspection> {\n\tconst parsed = parseGitUrl(options.source);\n\tif (!parsed) {\n\t\tthrow new Error(`Invalid git store source: ${options.source}`);\n\t}\n\tconst tempRoot = mkdtempSync(join(tmpdir(), \"volt-store-inspect-\"));\n\tconst checkoutDir = join(tempRoot, \"repo\");\n\ttry {\n\t\tawait runCommand(\"git\", [\"clone\", parsed.repo, checkoutDir], {\n\t\t\tenv: { GIT_TERMINAL_PROMPT: \"0\" },\n\t\t});\n\t\tif (parsed.ref) {\n\t\t\tawait runCommand(\"git\", [\"checkout\", parsed.ref], { cwd: checkoutDir });\n\t\t}\n\t\treturn inspectPackageDirectory(options.source, checkoutDir, [\n\t\t\t\"Inspected git metadata without installing dependencies or loading extension code.\",\n\t\t]);\n\t} finally {\n\t\trmSync(tempRoot, { recursive: true, force: true });\n\t}\n}\n\nexport function inspectPackageDirectory(\n\tsource: string,\n\troot: string,\n\tinitialWarnings: string[] = [],\n\tdiscoveryOptions?: InspectionDiscoveryOptions,\n): StorePackageInspection {\n\tconst packageJsonPath = join(root, \"package.json\");\n\tif (!existsSync(packageJsonPath)) {\n\t\treturn buildInspection(\n\t\t\tsource,\n\t\t\treadPackageJsonData({}),\n\t\t\troot,\n\t\t\t[`No package.json found at ${root}.`, ...initialWarnings],\n\t\t\tdiscoveryOptions,\n\t\t);\n\t}\n\ttry {\n\t\tconst pkg = readPackageJsonFile(packageJsonPath);\n\t\treturn buildInspection(source, pkg, root, initialWarnings, discoveryOptions);\n\t} catch (error: unknown) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\treturn buildInspection(\n\t\t\tsource,\n\t\t\treadPackageJsonData({}),\n\t\t\troot,\n\t\t\t[`Failed to read package metadata: ${message}`, ...initialWarnings],\n\t\t\tdiscoveryOptions,\n\t\t);\n\t}\n}\n\nexport async function inspectStorePackage(options: InspectStorePackageOptions): Promise<StorePackageInspection> {\n\tif (options.source.startsWith(\"npm:\")) {\n\t\treturn inspectNpmPackage(options);\n\t}\n\n\tif (parseGitUrl(options.source)) {\n\t\treturn inspectGitPackage(options);\n\t}\n\n\tconst root = resolvePath(options.source, options.cwd, { trim: true });\n\treturn inspectPackageDirectory(\n\t\toptions.source,\n\t\troot,\n\t\t[\"Local package paths are not reproducible and are inspected directly from disk.\"],\n\t\t{ localFallbackExtension: true },\n\t);\n}\n"]}