@hashicorp/kits 0.1.0

package/dist/discovery/local-fetcher.js

@@ -0,0 +1,100 @@
+/**
+ * Local fetcher for handling local path sources.
+ *
+ * Validates that local paths exist and are accessible.
+ */
+import fs from "node:fs/promises";
+import { parseSource, SourceParseError } from "./source-parser.js";
+/**
+ * Error thrown when local path operations fail.
+ */
+export class LocalFetchError extends Error {
+    localSource;
+    localCause;
+    constructor(message, source, cause) {
+        super(message);
+        this.name = "LocalFetchError";
+        this.localSource = source;
+        if (cause) {
+            this.localCause = cause;
+        }
+    }
+}
+/**
+ * Local fetcher implementation for local path sources.
+ */
+export class LocalFetcher {
+    /**
+     * Check if this fetcher can handle the given source.
+     *
+     * Handles local paths: ./path, ../path, /absolute/path, ~/path
+     */
+    canHandle(source) {
+        try {
+            const descriptor = parseSource(source);
+            return descriptor.type === "local";
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Fetch (validate) a local path.
+     *
+     * @param source - Local path (e.g., "./my-kits" or "/absolute/path")
+     * @returns Fetch result with local path (no cleanup needed)
+     * @throws LocalFetchError if the path does not exist or is not accessible
+     */
+    async fetch(source) {
+        let descriptor;
+        try {
+            const parsed = parseSource(source);
+            if (parsed.type !== "local") {
+                throw new SourceParseError("Not a local source", source);
+            }
+            descriptor = parsed;
+        }
+        catch (error) {
+            throw new LocalFetchError(`Failed to parse source: ${source}`, source, error instanceof Error ? error : undefined);
+        }
+        // Check if path exists
+        try {
+            const stats = await fs.stat(descriptor.path);
+            if (!stats.isDirectory()) {
+                throw new LocalFetchError(`Path is not a directory: ${descriptor.path}`, source);
+            }
+        }
+        catch (error) {
+            if (error instanceof LocalFetchError) {
+                throw error;
+            }
+            const nodeError = error;
+            if (nodeError.code === "ENOENT") {
+                throw new LocalFetchError(`Path does not exist: ${descriptor.path}`, source, error instanceof Error ? error : undefined);
+            }
+            if (nodeError.code === "EACCES") {
+                throw new LocalFetchError(`Permission denied: ${descriptor.path}`, source, error instanceof Error ? error : undefined);
+            }
+            throw new LocalFetchError(`Failed to access path: ${descriptor.path}`, source, error instanceof Error ? error : undefined);
+        }
+        // Check for read access
+        try {
+            await fs.access(descriptor.path, fs.constants.R_OK);
+        }
+        catch (error) {
+            throw new LocalFetchError(`Cannot read directory: ${descriptor.path}`, source, error instanceof Error ? error : undefined);
+        }
+        // Return result (no cleanup needed for local paths)
+        return {
+            localPath: descriptor.path,
+            // No cleanup function for local paths
+        };
+    }
+}
+/**
+ * Create a local fetcher.
+ */
+export function createLocalFetcher() {
+    return new LocalFetcher();
+}
+//# sourceMappingURL=local-fetcher.js.map

package/dist/discovery/local-fetcher.js.map

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

package/dist/discovery/source-parser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Source parser for kit repository sources.
+ *
+ * Parses GitHub shorthand (org/repo, org/repo@ref) and local paths.
+ */
+import type { SourceDescriptor } from "./types.js";
+/**
+ * Error thrown when source parsing fails.
+ */
+export declare class SourceParseError extends Error {
+    readonly source: string;
+    constructor(message: string, source: string);
+}
+/**
+ * Parse a source string into a typed source descriptor.
+ *
+ * Supported formats:
+ * - GitHub shorthand: org/repo, org/repo@ref
+ * - Local paths: ./path, ../path, /absolute/path, ~/path
+ *
+ * @param source - The source string to parse
+ * @returns Parsed source descriptor
+ * @throws SourceParseError if the source format is not recognized
+ */
+export declare function parseSource(source: string): SourceDescriptor;
+/**
+ * Format a source descriptor back to a string.
+ *
+ * @param descriptor - The source descriptor to format
+ * @returns Formatted source string
+ */
+export declare function formatSource(descriptor: SourceDescriptor): string;
+//# sourceMappingURL=source-parser.d.ts.map

package/dist/discovery/source-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-parser.d.ts","sourceRoot":"","sources":["../../src/discovery/source-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAA6B,MAAM,YAAY,CAAC;AAQ9E;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,MAAM,EAAE,MAAM;gBAD9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM;CAKjC;AAmFD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CA+B5D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAOjE"}

package/dist/discovery/source-parser.js

@@ -0,0 +1,136 @@
+/**
+ * Source parser for kit repository sources.
+ *
+ * Parses GitHub shorthand (org/repo, org/repo@ref) and local paths.
+ */
+import path from "node:path";
+/**
+ * GitHub shorthand pattern: org/repo or org/repo@ref
+ * Does NOT match URLs (http://, https://, git://)
+ */
+const GITHUB_SHORTHAND_PATTERN = /^([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+)(?:@(.+))?$/;
+/**
+ * Error thrown when source parsing fails.
+ */
+export class SourceParseError extends Error {
+    source;
+    constructor(message, source) {
+        super(message);
+        this.source = source;
+        this.name = "SourceParseError";
+    }
+}
+/**
+ * Check if a string looks like a local path.
+ *
+ * Local paths start with:
+ * - ./ (relative)
+ * - ../ (parent relative)
+ * - / (absolute)
+ * - ~ (home directory)
+ */
+function isLocalPath(source) {
+    return (source.startsWith("./") ||
+        source.startsWith("../") ||
+        source.startsWith("/") ||
+        source.startsWith("~"));
+}
+/**
+ * Check if a string looks like a URL.
+ */
+function isUrl(source) {
+    return (source.startsWith("http://") ||
+        source.startsWith("https://") ||
+        source.startsWith("git://") ||
+        source.startsWith("ssh://"));
+}
+/**
+ * Parse a GitHub shorthand source.
+ *
+ * @param source - GitHub shorthand (e.g., "example-org/kits@v1.0.0")
+ * @returns Parsed GitHub source descriptor
+ * @throws SourceParseError if the source is not valid GitHub shorthand
+ */
+function parseGitHubShorthand(source) {
+    const match = source.match(GITHUB_SHORTHAND_PATTERN);
+    if (!match) {
+        throw new SourceParseError(`Invalid GitHub shorthand: ${source}`, source);
+    }
+    const [, owner, repo, ref] = match;
+    const result = {
+        type: "github",
+        owner: owner,
+        repo: repo,
+    };
+    if (ref) {
+        result.ref = ref;
+    }
+    return result;
+}
+/**
+ * Parse a local path source.
+ *
+ * @param source - Local path (e.g., "./my-kits" or "/absolute/path")
+ * @returns Parsed local source descriptor
+ */
+function parseLocalPath(source) {
+    let resolvedPath;
+    if (source.startsWith("~")) {
+        // Expand home directory
+        const home = process.env["HOME"] || process.env["USERPROFILE"] || "";
+        resolvedPath = path.resolve(source.replace(/^~/, home));
+    }
+    else {
+        resolvedPath = path.resolve(source);
+    }
+    return {
+        type: "local",
+        path: resolvedPath,
+    };
+}
+/**
+ * Parse a source string into a typed source descriptor.
+ *
+ * Supported formats:
+ * - GitHub shorthand: org/repo, org/repo@ref
+ * - Local paths: ./path, ../path, /absolute/path, ~/path
+ *
+ * @param source - The source string to parse
+ * @returns Parsed source descriptor
+ * @throws SourceParseError if the source format is not recognized
+ */
+export function parseSource(source) {
+    if (!source || source.trim() === "") {
+        throw new SourceParseError("Source cannot be empty", source);
+    }
+    const trimmed = source.trim();
+    // Check for URLs (not supported in initial release)
+    if (isUrl(trimmed)) {
+        throw new SourceParseError("URL sources are not supported. Use GitHub shorthand (org/repo) or local paths instead.", source);
+    }
+    // Check for local paths first (they might contain slashes)
+    if (isLocalPath(trimmed)) {
+        return parseLocalPath(trimmed);
+    }
+    // Try GitHub shorthand
+    if (GITHUB_SHORTHAND_PATTERN.test(trimmed)) {
+        return parseGitHubShorthand(trimmed);
+    }
+    // Unknown format
+    throw new SourceParseError(`Unrecognized source format: ${source}. ` +
+        "Expected GitHub shorthand (org/repo) or local path (./path).", source);
+}
+/**
+ * Format a source descriptor back to a string.
+ *
+ * @param descriptor - The source descriptor to format
+ * @returns Formatted source string
+ */
+export function formatSource(descriptor) {
+    if (descriptor.type === "github") {
+        const base = `${descriptor.owner}/${descriptor.repo}`;
+        return descriptor.ref ? `${base}@${descriptor.ref}` : base;
+    }
+    return descriptor.path;
+}
+//# sourceMappingURL=source-parser.js.map

package/dist/discovery/source-parser.js.map

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

package/dist/discovery/types.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Discovery type definitions.
+ *
+ * These types support source fetching and kit discovery from repositories.
+ */
+import type { PrimitiveType, KitManifest, KitRegistry, PrimitivesRegistry } from "../core/types.js";
+/**
+ * Source types supported by the installer.
+ */
+export type SourceType = "github" | "local";
+/**
+ * Parsed GitHub source.
+ */
+export interface GitHubSource {
+    type: "github";
+    owner: string;
+    repo: string;
+    ref?: string;
+}
+/**
+ * Parsed local source.
+ */
+export interface LocalSource {
+    type: "local";
+    path: string;
+}
+/**
+ * Parsed source descriptor.
+ */
+export type SourceDescriptor = GitHubSource | LocalSource;
+/**
+ * Type guard for GitHub sources.
+ */
+export declare function isGitHubSource(source: SourceDescriptor): source is GitHubSource;
+/**
+ * Type guard for local sources.
+ */
+export declare function isLocalSource(source: SourceDescriptor): source is LocalSource;
+/**
+ * Result of fetching a source.
+ */
+export interface FetchResult {
+    localPath: string;
+    cleanup?: () => Promise<void>;
+}
+/**
+ * Primitive counts for a kit.
+ */
+export interface PrimitiveCounts {
+    commands: number;
+    skills: number;
+    subagents: number;
+    mcp: number;
+    hooks: number;
+}
+/**
+ * Discovered kit with computed metadata.
+ */
+export interface DiscoveredKit {
+    name: string;
+    path: string;
+    manifest: KitManifest;
+    requiredPrimitives: PrimitiveType[];
+    primitiveCounts: PrimitiveCounts;
+}
+/**
+ * Repository metadata inferred from kits.json or structure.
+ */
+export interface RepositoryMetadata {
+    name: string;
+    description?: string;
+    version?: string;
+    owner?: {
+        name: string;
+        url?: string;
+    };
+}
+/**
+ * Result of kit discovery.
+ */
+export interface KitDiscoveryResult {
+    source: string;
+    localPath: string;
+    repository: RepositoryMetadata;
+    registry?: KitRegistry;
+    primitivesRegistry?: PrimitivesRegistry;
+    kits: DiscoveredKit[];
+    errors: DiscoveryError[];
+}
+/**
+ * Error during kit discovery.
+ */
+export interface DiscoveryError {
+    type: "invalid-manifest" | "missing-file" | "parse-error" | "validation-error";
+    path?: string;
+    message: string;
+}
+/**
+ * Source fetcher interface.
+ */
+export interface SourceFetcher {
+    /**
+     * Check if this fetcher can handle the given source.
+     */
+    canHandle(source: string): boolean;
+    /**
+     * Fetch the source to a local directory.
+     */
+    fetch(source: string): Promise<FetchResult>;
+}
+/**
+ * Detected harness information.
+ */
+export interface DetectedHarness {
+    name: string;
+    displayName: string;
+    detected: boolean;
+    version?: string;
+    configPath?: string;
+    installationPaths: {
+        commands: string;
+        skills: string;
+        subagents?: string;
+        hooks?: string;
+    };
+    supportedPrimitives: PrimitiveType[];
+}
+/**
+ * Compatibility information for a kit against a harness.
+ */
+export interface KitCompatibility {
+    harness: string;
+    compatible: boolean;
+    missingPrimitives: PrimitiveType[];
+    experimentalPrimitives: PrimitiveType[];
+}
+/**
+ * Compatibility matrix for a kit across all harnesses.
+ */
+export interface CompatibilityMatrix {
+    kit: string;
+    requiredPrimitives: PrimitiveType[];
+    harnesses: KitCompatibility[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/discovery/types.d.ts.map

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

package/dist/discovery/types.js

@@ -0,0 +1,18 @@
+/**
+ * Discovery type definitions.
+ *
+ * These types support source fetching and kit discovery from repositories.
+ */
+/**
+ * Type guard for GitHub sources.
+ */
+export function isGitHubSource(source) {
+    return source.type === "github";
+}
+/**
+ * Type guard for local sources.
+ */
+export function isLocalSource(source) {
+    return source.type === "local";
+}
+//# sourceMappingURL=types.js.map

package/dist/discovery/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/discovery/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgCH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAwB;IACpD,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC;AACjC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @hashicorp/kits
+ *
+ * Install AI agent kits into your favorite coding assistants.
+ */
+export * from "./core/types.js";
+export * from "./adapters/types.js";
+export * from "./adapters/index.js";
+export * from "./manifest/types.js";
+export * from "./resolution/types.js";
+export * from "./discovery/types.js";
+export * from "./cli/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @hashicorp/kits
+ *
+ * Install AI agent kits into your favorite coding assistants.
+ */
+// Core types
+export * from "./core/types.js";
+// Adapter types and implementations
+export * from "./adapters/types.js";
+export * from "./adapters/index.js";
+// Manifest types
+export * from "./manifest/types.js";
+// Resolution types
+export * from "./resolution/types.js";
+// Discovery types
+export * from "./discovery/types.js";
+// CLI types
+export * from "./cli/types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,aAAa;AACb,cAAc,iBAAiB,CAAC;AAEhC,oCAAoC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AAEpC,iBAAiB;AACjB,cAAc,qBAAqB,CAAC;AAEpC,mBAAmB;AACnB,cAAc,uBAAuB,CAAC;AAEtC,kBAAkB;AAClB,cAAc,sBAAsB,CAAC;AAErC,YAAY;AACZ,cAAc,gBAAgB,CAAC"}

package/dist/manifest/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Manifest module for the kit installer.
+ *
+ * This module handles reading, writing, and managing the installation manifest
+ * that tracks installed kits and primitives across harnesses.
+ */
+import type { HarnessName, InstallationScope, ResolvedPrimitive, KitManifest } from "../core/types.js";
+import type { InstalledKit } from "./types.js";
+export type { InstalledPrimitive, InstalledKit, HarnessInstallation, InstallationManifest, UpgradeCheck, UpgradeSummary, } from "./types.js";
+export { MANIFEST_VERSION, GLOBAL_MANIFEST_PATH, PROJECT_MANIFEST_DIR, PROJECT_MANIFEST_FILENAME, createEmptyManifest, } from "./types.js";
+export { readManifest, getOrCreateManifest, ManifestReadError } from "./read.js";
+export { writeManifest, ManifestWriteError } from "./write.js";
+export { getManifestPathForScope, getManifestDirForScope } from "./write.js";
+export { checkForUpgrades, checkForUpgradesInScope, createUpgradeSummary, } from "./upgrade-check.js";
+export { expandPath, getManifestPath, getManifestDir, ensureManifestDir, } from "./utils.js";
+/**
+ * Record a kit installation in the manifest.
+ *
+ * @param harness - The harness name
+ * @param kit - The kit manifest
+ * @param primitives - The resolved primitives that were installed
+ * @param source - The source repository
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ */
+export declare function recordInstallation(harness: HarnessName, kit: KitManifest, primitives: ResolvedPrimitive[], source: string, scope?: InstallationScope, projectRoot?: string): Promise<void>;
+/**
+ * Remove a kit installation from the manifest.
+ *
+ * @param harness - The harness name
+ * @param kitName - The kit name to remove
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The removed kit info or null if not found
+ */
+export declare function removeInstallation(harness: HarnessName, kitName: string, scope?: InstallationScope, projectRoot?: string): Promise<InstalledKit | null>;
+/**
+ * Get all installed kits, optionally filtered by harness.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @param harness - Optional harness name to filter by
+ * @returns Array of installed kit info with harness context
+ */
+export declare function getInstalledKits(scope?: InstallationScope, projectRoot?: string, harness?: HarnessName): Promise<Array<{
+    harness: HarnessName;
+    kitName: string;
+    kit: InstalledKit;
+}>>;
+/**
+ * Check if a kit is installed in any harness.
+ *
+ * @param kitName - The kit name to check
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns True if the kit is installed somewhere
+ */
+export declare function isKitInstalled(kitName: string, scope?: InstallationScope, projectRoot?: string): Promise<boolean>;
+/**
+ * Check if a kit is installed in a specific harness.
+ *
+ * @param harness - The harness name
+ * @param kitName - The kit name to check
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns True if the kit is installed in the harness
+ */
+export declare function isKitInstalledInHarness(harness: HarnessName, kitName: string, scope?: InstallationScope, projectRoot?: string): Promise<boolean>;
+/**
+ * Get a specific installed kit.
+ *
+ * @param harness - The harness name
+ * @param kitName - The kit name
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The installed kit or null if not found
+ */
+export declare function getInstalledKit(harness: HarnessName, kitName: string, scope?: InstallationScope, projectRoot?: string): Promise<InstalledKit | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/manifest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,YAAY,CAAC;AAKnE,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGjF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAG/D,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG7E,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,UAAU,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CA8Cf;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA0B9B;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAyB9E;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAY9B"}