@detergent-software/atk 0.12.1-dev.2

package/build/lib/registry.js

@@ -0,0 +1,248 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { maxSatisfying, compare as semverCompare, valid as semverValid, validRange } from 'semver';
+import { getGitHubToken } from './auth.js';
+import { getCacheDir, loadConfig } from './config.js';
+import { fetchWithRetry } from './fetch-retry.js';
+import { buildGitHubContentsUrl, buildGitHubHeaders, getEffectiveBranch, GITHUB_ACCEPT_RAW } from './github.js';
+import { parseAndValidate, safeParseJson } from './parse-json.js';
+import { RegistrySchema, } from './schemas/registry.js';
+const REGISTRY_CACHE_FILE = 'registry.json';
+const DEFAULT_REGISTRY_PATH = 'registry.json';
+export class RegistryError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RegistryError';
+    }
+}
+/**
+ * Clear the registry cache.
+ */
+export async function clearCache() {
+    const config = await loadConfig();
+    const cacheDir = getCacheDir(config);
+    const cachePath = join(cacheDir, REGISTRY_CACHE_FILE);
+    if (existsSync(cachePath)) {
+        const { unlink } = await import('node:fs/promises');
+        await unlink(cachePath);
+    }
+}
+/**
+ * Fetch the registry, using cache when available and not expired.
+ */
+export async function fetchRegistry(options) {
+    const config = await loadConfig();
+    const cacheDir = getCacheDir(config);
+    const cachePath = join(cacheDir, REGISTRY_CACHE_FILE);
+    // Check cache unless force refresh
+    if (!options?.force && existsSync(cachePath)) {
+        const cached = await readCachedRegistry(cachePath, config.cacheTtlMinutes ?? 60);
+        if (cached) {
+            return cached;
+        }
+    }
+    // Fetch fresh from GitHub
+    const registry = await fetchRegistryFromGitHub(config.registryUrl, config.registryBranch);
+    // Write to cache
+    await writeCacheFile(cachePath, cacheDir, registry);
+    return registry;
+}
+/**
+ * Find an asset in the registry by name and resolve a specific version.
+ *
+ * Version resolution strategy:
+ * - If `version` is omitted or undefined, resolves to the `latest` version.
+ * - If `version` is an exact semver string (e.g. "1.2.3"), looks up that exact version.
+ * - If `version` is a semver range (e.g. "^1.0.0", ">=2.0.0"), resolves via `semver.maxSatisfying`.
+ *
+ * @param registry - The registry to search.
+ * @param name - Asset name to find.
+ * @param type - Optional asset type filter.
+ * @param version - Optional semver version or range. Defaults to the asset's `latest` version.
+ * @returns The resolved asset with version metadata, or undefined if not found.
+ */
+export function findAsset(registry, name, type, version) {
+    const asset = registry.assets.find((a) => a.name === name && (!type || a.type === type));
+    if (!asset) {
+        return undefined;
+    }
+    return resolveAssetVersion(asset, version);
+}
+/**
+ * Find a bundle in the registry by name.
+ */
+export function findBundle(registry, name) {
+    return (registry.bundles ?? []).find((b) => b.name === name);
+}
+/**
+ * Get all assets of a given type from the registry.
+ */
+export function getAssetsByType(registry, type) {
+    return registry.assets.filter((a) => a.type === type);
+}
+/**
+ * Get metadata about the registry cache file.
+ */
+export async function getCacheStatus() {
+    const config = await loadConfig();
+    const cacheDir = getCacheDir(config);
+    const cachePath = join(cacheDir, REGISTRY_CACHE_FILE);
+    const ttlMinutes = config.cacheTtlMinutes ?? 60;
+    if (!existsSync(cachePath)) {
+        return { ageMs: 0, exists: false, expired: false, path: cachePath, sizeBytes: 0, ttlMinutes };
+    }
+    const fileStat = await stat(cachePath);
+    const ageMs = Date.now() - fileStat.mtimeMs;
+    const expired = ageMs > ttlMinutes * 60 * 1000;
+    return { ageMs, exists: true, expired, path: cachePath, sizeBytes: fileStat.size, ttlMinutes };
+}
+/**
+ * Extract and sort versions from a resolved registry asset.
+ *
+ * @param asset - The registry asset to extract versions from.
+ * @returns An object with the sorted version list (newest first) and the latest version.
+ */
+export function getSortedVersions(asset) {
+    const versions = Object.keys(asset.versions).sort((a, b) => {
+        // Sort by semver descending (newest first)
+        const aValid = semverValid(a);
+        const bValid = semverValid(b);
+        if (aValid && bValid) {
+            return semverCompare(b, a);
+        }
+        return a.localeCompare(b);
+    });
+    return { latest: asset.latest, versions };
+}
+/**
+ * Check if an asset is deprecated.
+ */
+export function isDeprecated(registry, name, type) {
+    const entry = (registry.deprecated ?? []).find((d) => d.name === name && (!type || !d.type || d.type === type));
+    if (!entry) {
+        return { deprecated: false };
+    }
+    return {
+        deprecated: true,
+        reason: entry.reason,
+        replacement: entry.replacement,
+    };
+}
+/**
+ * Resolve a version against an asset's versions map.
+ *
+ * @param asset - The registry asset to resolve a version for.
+ * @param version - Optional semver version or range. Defaults to the asset's `latest` version.
+ * @returns The resolved asset with version metadata, or undefined if the version cannot be resolved.
+ */
+export function resolveAssetVersion(asset, version) {
+    const availableVersions = Object.keys(asset.versions);
+    // No versions available at all
+    if (availableVersions.length === 0) {
+        return undefined;
+    }
+    let resolvedVersion;
+    if (!version) {
+        // Default to the asset's declared latest version
+        resolvedVersion = asset.latest;
+    }
+    else if (semverValid(version)) {
+        // Exact version — check if it exists in the map
+        resolvedVersion = availableVersions.includes(version) ? version : undefined;
+    }
+    else if (validRange(version)) {
+        // Semver range — find the best matching version
+        resolvedVersion = maxSatisfying(availableVersions, version) ?? undefined;
+    }
+    else {
+        // Invalid version string
+        return undefined;
+    }
+    if (!resolvedVersion) {
+        return undefined;
+    }
+    const versionData = asset.versions[resolvedVersion];
+    if (!versionData) {
+        return undefined;
+    }
+    return { asset, version: resolvedVersion, versionData };
+}
+/**
+ * Fetch registry.json from the GitHub repo via the Contents API.
+ */
+async function fetchRegistryFromGitHub(registryUrl, registryBranch) {
+    if (registryUrl) {
+        return fetchRegistryFromUrl(registryUrl);
+    }
+    const token = await getGitHubToken();
+    const effectiveBranch = getEffectiveBranch(registryBranch);
+    const url = buildGitHubContentsUrl(DEFAULT_REGISTRY_PATH, effectiveBranch);
+    const response = await fetchWithRetry(url, {
+        headers: buildGitHubHeaders(token, GITHUB_ACCEPT_RAW),
+    });
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new RegistryError('Registry not found. The registry.json file may not exist yet in the repo.');
+        }
+        if (response.status === 401 || response.status === 403) {
+            throw new RegistryError('Authentication failed. Check your GitHub token or run `gh auth login`.');
+        }
+        throw new RegistryError(`Failed to fetch registry: HTTP ${response.status}`);
+    }
+    const raw = await response.text();
+    try {
+        return parseAndValidate(raw, RegistrySchema, 'Invalid registry data');
+    }
+    catch (err) {
+        throw new RegistryError(err.message);
+    }
+}
+/**
+ * Fetch registry from a custom URL (for custom registryUrl in config).
+ */
+async function fetchRegistryFromUrl(url) {
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new RegistryError(`Failed to fetch registry from ${url}: HTTP ${response.status}`);
+    }
+    const raw = await response.text();
+    try {
+        return parseAndValidate(raw, RegistrySchema, `Invalid registry data from ${url}`);
+    }
+    catch (err) {
+        throw new RegistryError(err.message);
+    }
+}
+/**
+ * Read the cached registry file if it exists and is not expired.
+ */
+async function readCachedRegistry(cachePath, ttlMinutes) {
+    try {
+        const fileStat = await stat(cachePath);
+        const ageMs = Date.now() - fileStat.mtimeMs;
+        const ttlMs = ttlMinutes * 60 * 1000;
+        if (ageMs > ttlMs) {
+            return null; // Cache expired
+        }
+        const raw = await readFile(cachePath, 'utf-8');
+        const result = safeParseJson(raw, RegistrySchema, 'Invalid cached registry');
+        if (!result.success) {
+            return null; // Invalid cache — re-fetch
+        }
+        return result.data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write registry data to the cache file.
+ */
+async function writeCacheFile(cachePath, cacheDir, registry) {
+    if (!existsSync(cacheDir)) {
+        await mkdir(cacheDir, { recursive: true });
+    }
+    await writeFile(cachePath, JSON.stringify(registry), 'utf-8');
+}
+//# sourceMappingURL=registry.js.map

package/build/lib/registry.js.map

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

package/build/lib/resolver.d.ts

@@ -0,0 +1,50 @@
+import type { Registry, RegistryAsset, RegistryAssetVersion, RegistryBundle } from './schemas/registry.js';
+export interface InstallPlan {
+    /** Ordered list of assets to install (dependencies first, then direct requests). */
+    entries: InstallPlanEntry[];
+    /** Total number of assets to install. */
+    totalCount: number;
+}
+export interface InstallPlanEntry {
+    asset: RegistryAsset;
+    /** Why this entry is in the plan (direct request or dependency of another asset). */
+    reason: 'dependency' | 'direct';
+    /** If reason is 'dependency', which asset required this one. */
+    requiredBy?: string;
+    /** The resolved semver version for this asset. */
+    version: string;
+    /** The version-specific metadata for the resolved version. */
+    versionData: RegistryAssetVersion;
+}
+export declare class ResolverError extends Error {
+    constructor(message: string);
+}
+/** Clear the resolver cache. Useful for testing and flows that need fresh resolution. */
+export declare function clearResolverCache(): void;
+/**
+ * Resolve all assets in a bundle into a single install plan.
+ * Extracts asset references from the bundle and delegates to resolveMultipleInstallPlans.
+ * Throws ResolverError if the bundle has no assets.
+ */
+export declare function resolveBundleInstallPlan(registry: Registry, bundle: RegistryBundle): InstallPlan;
+/**
+ * Resolve an asset and all its dependencies into a flat, ordered install plan.
+ * Dependencies are listed before the assets that depend on them.
+ * Detects circular dependencies and throws ResolverError.
+ *
+ * @param registry - The registry to search.
+ * @param assetName - Name of the asset to resolve.
+ * @param assetType - Optional asset type filter.
+ * @param assetVersion - Optional semver version or range. Defaults to the asset's `latest` version.
+ */
+export declare function resolveInstallPlan(registry: Registry, assetName: string, assetType?: string, assetVersion?: string): InstallPlan;
+/**
+ * Resolve multiple assets into a single install plan.
+ * Deduplicates shared dependencies.
+ */
+export declare function resolveMultipleInstallPlans(registry: Registry, assets: Array<{
+    name: string;
+    type?: string;
+    version?: string;
+}>): InstallPlan;
+//# sourceMappingURL=resolver.d.ts.map

package/build/lib/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/lib/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO3G,MAAM,WAAW,WAAW;IAC1B,oFAAoF;IACpF,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,qFAAqF;IACrF,MAAM,EAAE,YAAY,GAAG,QAAQ,CAAC;IAChC,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,WAAW,EAAE,oBAAoB,CAAC;CACnC;AAED,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAG,WAAW,CAUhG;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,WAAW,CAqBb;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/D,WAAW,CAab"}

package/build/lib/resolver.js

@@ -0,0 +1,110 @@
+import { findAsset } from './registry.js';
+/** Module-level cache for resolved install plans, keyed by registry version + asset type + asset name + version. */
+const resolverCache = new Map();
+export class ResolverError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ResolverError';
+    }
+}
+/** Clear the resolver cache. Useful for testing and flows that need fresh resolution. */
+export function clearResolverCache() {
+    resolverCache.clear();
+}
+/**
+ * Resolve all assets in a bundle into a single install plan.
+ * Extracts asset references from the bundle and delegates to resolveMultipleInstallPlans.
+ * Throws ResolverError if the bundle has no assets.
+ */
+export function resolveBundleInstallPlan(registry, bundle) {
+    const bundleAssets = bundle.assets ?? [];
+    if (bundleAssets.length === 0) {
+        throw new ResolverError(`Bundle "${bundle.name}" has no assets`);
+    }
+    const assets = bundleAssets.map(({ name, type, version }) => ({ name, type, version }));
+    return resolveMultipleInstallPlans(registry, assets);
+}
+/**
+ * Resolve an asset and all its dependencies into a flat, ordered install plan.
+ * Dependencies are listed before the assets that depend on them.
+ * Detects circular dependencies and throws ResolverError.
+ *
+ * @param registry - The registry to search.
+ * @param assetName - Name of the asset to resolve.
+ * @param assetType - Optional asset type filter.
+ * @param assetVersion - Optional semver version or range. Defaults to the asset's `latest` version.
+ */
+export function resolveInstallPlan(registry, assetName, assetType, assetVersion) {
+    const cacheKey = `${registry.version}:${assetType ?? ''}:${assetName}:${assetVersion ?? ''}`;
+    const cached = resolverCache.get(cacheKey);
+    if (cached) {
+        return structuredClone(cached);
+    }
+    const entries = [];
+    const resolved = new Set();
+    const visiting = new Set();
+    resolveAsset(registry, entries, resolved, visiting, assetName, assetType, assetVersion, 'direct');
+    const plan = {
+        entries,
+        totalCount: entries.length,
+    };
+    resolverCache.set(cacheKey, plan);
+    return structuredClone(plan);
+}
+/**
+ * Resolve multiple assets into a single install plan.
+ * Deduplicates shared dependencies.
+ */
+export function resolveMultipleInstallPlans(registry, assets) {
+    const entries = [];
+    const resolved = new Set();
+    const visiting = new Set();
+    for (const { name, type, version } of assets) {
+        resolveAsset(registry, entries, resolved, visiting, name, type, version, 'direct');
+    }
+    return {
+        entries,
+        totalCount: entries.length,
+    };
+}
+/**
+ * Shared recursive resolver that resolves a single asset and its dependencies
+ * into the provided entries array, using the given resolved/visiting sets for
+ * deduplication and circular dependency detection.
+ *
+ * Graph nodes are keyed as `type:name@version` for version-aware resolution.
+ */
+function resolveAsset(registry, entries, resolved, visiting, name, type, version, reason, requiredBy) {
+    const result = findAsset(registry, name, type, version);
+    if (!result) {
+        const typeHint = type ? ` (type: ${type})` : '';
+        const versionHint = version ? ` @${version}` : '';
+        throw new ResolverError(`Asset "${name}"${versionHint}${typeHint} not found in the registry` +
+            (requiredBy ? ` (required by "${requiredBy}")` : ''));
+    }
+    const key = `${result.asset.type}:${name}@${result.version}`;
+    // Already in the plan
+    if (resolved.has(key)) {
+        return;
+    }
+    // Circular dependency detection
+    if (visiting.has(key)) {
+        const chain = [...visiting, key].join(' → ');
+        throw new ResolverError(`Circular dependency detected: ${chain}`);
+    }
+    visiting.add(key);
+    // Resolve dependencies first (depth-first), passing their version ranges
+    for (const dep of result.versionData.dependencies ?? []) {
+        resolveAsset(registry, entries, resolved, visiting, dep.name, dep.type, dep.version, 'dependency', name);
+    }
+    visiting.delete(key);
+    resolved.add(key);
+    entries.push({
+        asset: result.asset,
+        reason,
+        requiredBy,
+        version: result.version,
+        versionData: result.versionData,
+    });
+}
+//# sourceMappingURL=resolver.js.map

package/build/lib/resolver.js.map

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

package/build/lib/schemas/adapter.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export declare const PlacementConfig: z.ZodObject<{
+    configFile: z.ZodOptional<z.ZodString>;
+    configKey: z.ZodOptional<z.ZodString>;
+    configMerge: z.ZodOptional<z.ZodBoolean>;
+    entrypointName: z.ZodOptional<z.ZodString>;
+    fileless: z.ZodOptional<z.ZodBoolean>;
+    path: z.ZodString;
+}, z.core.$strip>;
+export type PlacementConfig = z.infer<typeof PlacementConfig>;
+export declare const AdapterSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    configDetection: z.ZodArray<z.ZodString>;
+    displayName: z.ZodString;
+    placements: z.ZodRecord<z.ZodEnum<{
+        skill: "skill";
+        agent: "agent";
+        rule: "rule";
+        hook: "hook";
+        "memory-template": "memory-template";
+        "mcp-config": "mcp-config";
+    }> & z.core.$partial, z.ZodObject<{
+        configFile: z.ZodOptional<z.ZodString>;
+        configKey: z.ZodOptional<z.ZodString>;
+        configMerge: z.ZodOptional<z.ZodBoolean>;
+        entrypointName: z.ZodOptional<z.ZodString>;
+        fileless: z.ZodOptional<z.ZodBoolean>;
+        path: z.ZodString;
+    }, z.core.$strip>>;
+    tool: z.ZodString;
+}, z.core.$strip>;
+export type Adapter = z.infer<typeof AdapterSchema>;
+//# sourceMappingURL=adapter.d.ts.map

package/build/lib/schemas/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe;;;;;;;iBAkB1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;iBAMxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/build/lib/schemas/adapter.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { AssetType } from './manifest.js';
+export const PlacementConfig = z.object({
+    configFile: z.string().optional().describe('Config file to update for registration (e.g., settings.json)'),
+    configKey: z.string().optional().describe('Key path within the config file to update'),
+    configMerge: z
+        .boolean()
+        .optional()
+        .describe('When true, merge actual asset content into configFile[configKey] instead of writing a simple marker'),
+    entrypointName: z
+        .string()
+        .optional()
+        .describe('Fixed filename for the entrypoint when placed in a directory (e.g., "SKILL.md"). When set, path is treated as a directory template.'),
+    fileless: z
+        .boolean()
+        .optional()
+        .describe('When true, no standalone files are placed. Asset content is only used for config merging.'),
+    path: z.string().describe('File placement path template (supports {name} variable)'),
+});
+export const AdapterSchema = z.object({
+    $schema: z.string().optional().describe('JSON Schema reference for editor validation and autocomplete'),
+    configDetection: z.array(z.string()).describe('Paths/files that indicate this tool is in use (e.g., [".claude/"])'),
+    displayName: z.string().describe('Human-readable tool name'),
+    placements: z.partialRecord(AssetType, PlacementConfig).describe('File placement rules per asset type'),
+    tool: z.string().describe('Tool identifier (e.g., claude-code)'),
+});
+//# sourceMappingURL=adapter.js.map

package/build/lib/schemas/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/lib/schemas/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IAC1G,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACtF,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,qGAAqG,CAAC;IAClH,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qIAAqI,CACtI;IACH,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,2FAA2F,CAAC;IACxG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;CACrF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACvG,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IACnH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC5D,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACvG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACjE,CAAC,CAAC"}

package/build/lib/schemas/bundle.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export declare const BundleAssetRef: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        skill: "skill";
+        agent: "agent";
+        rule: "rule";
+        hook: "hook";
+        "memory-template": "memory-template";
+        "mcp-config": "mcp-config";
+    }>;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BundleAssetRef = z.infer<typeof BundleAssetRef>;
+export declare const BundleSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    assets: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            skill: "skill";
+            agent: "agent";
+            rule: "rule";
+            hook: "hook";
+            "memory-template": "memory-template";
+            "mcp-config": "mcp-config";
+        }>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    author: z.ZodString;
+    description: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    name: z.ZodString;
+    setupInstructions: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    version: z.ZodString;
+}, z.core.$strip>;
+export type Bundle = z.infer<typeof BundleSchema>;
+//# sourceMappingURL=bundle.d.ts.map

package/build/lib/schemas/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,cAAc;;;;;;;;;;;iBAIzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;iBAUvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/build/lib/schemas/bundle.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { AssetType } from './manifest.js';
+export const BundleAssetRef = z.object({
+    name: z.string().describe('Asset name'),
+    type: AssetType.describe('Asset type'),
+    version: z.string().optional().describe('Pinned version (latest if omitted)'),
+});
+export const BundleSchema = z.object({
+    $schema: z.string().optional().describe('JSON Schema reference for editor validation and autocomplete'),
+    assets: z.array(BundleAssetRef).min(1).describe('Assets included in this bundle'),
+    author: z.string().describe('Author name or identifier'),
+    description: z.string().describe('What this bundle provides'),
+    metadata: z.record(z.string(), z.unknown()).optional().describe('Arbitrary additional metadata'),
+    name: z.string().describe('Unique bundle name (kebab-case)'),
+    setupInstructions: z.string().optional().describe('Post-install setup instructions (markdown)'),
+    tags: z.array(z.string()).optional().describe('Searchable tags'),
+    version: z.string().describe('Semver version string'),
+});
+//# sourceMappingURL=bundle.js.map

package/build/lib/schemas/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../../src/lib/schemas/bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;IACvC,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAC9E,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACvG,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACjF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACxD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAChG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC5D,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC/F,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;CACtD,CAAC,CAAC"}

package/build/lib/schemas/config.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const ConfigSchema: z.ZodObject<{
+    cacheDir: z.ZodOptional<z.ZodString>;
+    cacheTtlMinutes: z.ZodOptional<z.ZodNumber>;
+    defaultTool: z.ZodOptional<z.ZodString>;
+    githubToken: z.ZodOptional<z.ZodString>;
+    registryBranch: z.ZodOptional<z.ZodString>;
+    registryUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare const DEFAULT_CONFIG: Config;
+//# sourceMappingURL=config.d.ts.map

package/build/lib/schemas/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY;;;;;;;iBAOvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc,EAAE,MAG5B,CAAC"}

package/build/lib/schemas/config.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const ConfigSchema = z.object({
+    cacheDir: z.string().optional().describe('Override cache directory (defaults to ~/.atk/cache/)'),
+    cacheTtlMinutes: z.number().optional().describe('Cache TTL in minutes for registry data'),
+    defaultTool: z.string().optional().describe('Default tool when --tool is not specified'),
+    githubToken: z.string().optional().describe('GitHub token override (defaults to gh auth token)'),
+    registryBranch: z.string().optional().describe('Override registry branch for GitHub API calls (defaults to main)'),
+    registryUrl: z.string().optional().describe('Override registry URL (defaults to GitHub repo)'),
+});
+export const DEFAULT_CONFIG = {
+    cacheTtlMinutes: 60,
+    defaultTool: 'claude-code',
+};
+//# sourceMappingURL=config.js.map

package/build/lib/schemas/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/lib/schemas/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IAChG,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACzF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACxF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAChG,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;IAClH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;CAC/F,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAW;IACpC,eAAe,EAAE,EAAE;IACnB,WAAW,EAAE,aAAa;CAC3B,CAAC"}

package/build/lib/schemas/index.d.ts

@@ -0,0 +1,7 @@
+export { type Adapter, AdapterSchema, PlacementConfig } from './adapter.js';
+export { type Bundle, BundleAssetRef, BundleSchema } from './bundle.js';
+export { type Config, ConfigSchema, DEFAULT_CONFIG } from './config.js';
+export { InstalledAsset, InstalledFile, type Lockfile, LockfileSchema } from './lockfile.js';
+export { AssetDependency, AssetType, type Manifest, ManifestSchema, SecurityBlock, ToolCompatibility, TrustLevel, } from './manifest.js';
+export { DeprecatedEntry, type Registry, RegistryAsset, type RegistryAssetVersion, RegistryAssetVersionSchema, RegistryAssetVersionsMapSchema, RegistryBundle, RegistrySchema, } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/build/lib/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,EAAE,KAAK,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,KAAK,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE7F,OAAO,EACL,eAAe,EACf,SAAS,EACT,KAAK,QAAQ,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,QAAQ,EACb,aAAa,EACb,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC"}

package/build/lib/schemas/index.js

@@ -0,0 +1,7 @@
+export { AdapterSchema, PlacementConfig } from './adapter.js';
+export { BundleAssetRef, BundleSchema } from './bundle.js';
+export { ConfigSchema, DEFAULT_CONFIG } from './config.js';
+export { InstalledAsset, InstalledFile, LockfileSchema } from './lockfile.js';
+export { AssetDependency, AssetType, ManifestSchema, SecurityBlock, ToolCompatibility, TrustLevel, } from './manifest.js';
+export { DeprecatedEntry, RegistryAsset, RegistryAssetVersionSchema, RegistryAssetVersionsMapSchema, RegistryBundle, RegistrySchema, } from './registry.js';
+//# sourceMappingURL=index.js.map

package/build/lib/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,EAAe,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAe,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAiB,cAAc,EAAE,MAAM,eAAe,CAAC;AAE7F,OAAO,EACL,eAAe,EACf,SAAS,EAET,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EAEf,aAAa,EAEb,0BAA0B,EAC1B,8BAA8B,EAC9B,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC"}