opkg 0.9.0 → 0.9.2

package/packages/core/dist/utils/git-url-parser.js

@@ -0,0 +1,113 @@
+import { ValidationError } from './errors.js';
+/**
+ * Normalize a Git URL for consistent hashing.
+ * - Converts to lowercase
+ * - Removes .git suffix
+ * - Normalizes GitHub SSH to HTTPS format
+ */
+export function normalizeGitUrl(url) {
+    let normalized = url.toLowerCase().trim();
+    // Remove .git suffix
+    if (normalized.endsWith('.git')) {
+        normalized = normalized.slice(0, -4);
+    }
+    // Normalize GitHub SSH to HTTPS
+    if (normalized.startsWith('git@github.com:')) {
+        normalized = normalized.replace('git@github.com:', 'https://github.com/');
+    }
+    // Normalize other SSH formats
+    if (normalized.startsWith('git@')) {
+        // git@gitlab.com:owner/repo → https://gitlab.com/owner/repo
+        normalized = normalized.replace(/^git@([^:]+):/, 'https://$1/');
+    }
+    // Remove trailing slashes
+    normalized = normalized.replace(/\/$/, '');
+    return normalized;
+}
+/**
+ * Parse a Git URL into its components.
+ * Supports various formats:
+ * - https://github.com/owner/repo.git
+ * - git@github.com:owner/repo.git
+ * - https://gitlab.com/group/subgroup/repo.git
+ * - ssh://git@bitbucket.org/owner/repo.git
+ */
+export function parseGitUrl(url) {
+    const normalized = normalizeGitUrl(url);
+    // Try HTTPS format first
+    const httpsMatch = normalized.match(/^https?:\/\/([^\/]+)\/(.+?)\/([^\/]+?)(?:\.git)?$/);
+    if (httpsMatch) {
+        const [, host, owner, repo] = httpsMatch;
+        return {
+            host,
+            owner,
+            repo,
+            protocol: 'https',
+            normalized
+        };
+    }
+    // Try SSH format (already normalized to https above, but handle edge cases)
+    const sshMatch = normalized.match(/^(?:ssh:\/\/)?git@([^:\/]+)[:\\/](.+?)\/([^\/]+?)(?:\.git)?$/);
+    if (sshMatch) {
+        const [, host, owner, repo] = sshMatch;
+        return {
+            host,
+            owner,
+            repo,
+            protocol: 'ssh',
+            normalized: `https://${host}/${owner}/${repo}` // Normalize for consistency
+        };
+    }
+    // Try git:// protocol
+    const gitMatch = normalized.match(/^git:\/\/([^\/]+)\/(.+?)\/([^\/]+?)(?:\.git)?$/);
+    if (gitMatch) {
+        const [, host, owner, repo] = gitMatch;
+        return {
+            host,
+            owner,
+            repo,
+            protocol: 'git',
+            normalized: `https://${host}/${owner}/${repo}`
+        };
+    }
+    throw new ValidationError(`Unable to parse Git URL: ${url}. Expected format: https://host/owner/repo.git or git@host:owner/repo.git`);
+}
+/**
+ * Extract GitHub metadata from a Git URL.
+ * Returns null if the URL is not a GitHub URL.
+ */
+export function extractGitHubInfo(url) {
+    try {
+        const parsed = parseGitUrl(url);
+        // Only handle github.com
+        if (parsed.host !== 'github.com') {
+            return null;
+        }
+        return {
+            username: parsed.owner,
+            repo: parsed.repo
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a URL is a GitHub URL.
+ */
+export function isGitHubUrl(url) {
+    return extractGitHubInfo(url) !== null;
+}
+/**
+ * Sanitize a Git ref name for use in filesystem paths.
+ * Converts slashes and other problematic characters to hyphens.
+ *
+ * Examples:
+ * - main → main
+ * - feature/new-thing → feature-new-thing
+ * - v1.0.0 → v1.0.0
+ */
+export function sanitizeRefName(ref) {
+    return ref.replace(/[\/\\:]/g, '-');
+}
+//# sourceMappingURL=git-url-parser.js.map

package/packages/core/dist/utils/git-url-parser.js.map

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

package/packages/core/dist/utils/hash-utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Hash Utilities Module
+ * Utility functions for content hashing and comparison
+ */
+/**
+ * Calculate hash of file content using xxhash3
+ */
+export declare function calculateFileHash(content: string): Promise<string>;
+/**
+ * Calculate hash of file content synchronously (for simple cases)
+ * Note: This is less performant but useful when async operations aren't needed
+ */
+export declare function calculateFileHashSync(content: string): string;
+//# sourceMappingURL=hash-utils.d.ts.map

package/packages/core/dist/utils/hash-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-utils.d.ts","sourceRoot":"","sources":["../../src/utils/hash-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASxE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAc7D"}

package/packages/core/dist/utils/hash-utils.js

@@ -0,0 +1,40 @@
+/**
+ * Hash Utilities Module
+ * Utility functions for content hashing and comparison
+ */
+import { xxhash3 } from 'hash-wasm';
+import { logger } from './logger.js';
+/**
+ * Calculate hash of file content using xxhash3
+ */
+export async function calculateFileHash(content) {
+    try {
+        return await xxhash3(content);
+    }
+    catch (error) {
+        logger.warn(`Failed to calculate hash for content: ${error}`);
+        // Return a fallback hash based on content length and first/last chars
+        const fallback = `${content.length}-${content.charAt(0)}-${content.charAt(content.length - 1)}`;
+        return fallback;
+    }
+}
+/**
+ * Calculate hash of file content synchronously (for simple cases)
+ * Note: This is less performant but useful when async operations aren't needed
+ */
+export function calculateFileHashSync(content) {
+    try {
+        // For sync operations, we'll use a simple hash based on content characteristics
+        // In a real implementation, you might use a sync hash library
+        const length = content.length;
+        const firstChar = content.charCodeAt(0) || 0;
+        const lastChar = content.charCodeAt(content.length - 1) || 0;
+        // Simple hash combining length and character codes
+        return `${length}-${firstChar}-${lastChar}`;
+    }
+    catch (error) {
+        logger.warn(`Failed to calculate sync hash for content: ${error}`);
+        return `fallback-${content.length}`;
+    }
+}
+//# sourceMappingURL=hash-utils.js.map

package/packages/core/dist/utils/hash-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-utils.js","sourceRoot":"","sources":["../../src/utils/hash-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,yCAAyC,KAAK,EAAE,CAAC,CAAC;QAC9D,sEAAsE;QACtE,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QAChG,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,IAAI,CAAC;QACH,gFAAgF;QAChF,8DAA8D;QAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QAE7D,mDAAmD;QACnD,OAAO,GAAG,MAAM,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,8CAA8C,KAAK,EAAE,CAAC,CAAC;QACnE,OAAO,YAAY,OAAO,CAAC,MAAM,EAAE,CAAC;IACtC,CAAC;AACH,CAAC"}

package/packages/core/dist/utils/home-directory.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Home Directory Utilities
+ *
+ * Centralized module for all home directory operations.
+ * Handles path resolution, comparison, and display normalization.
+ */
+/**
+ * Get the home directory path.
+ *
+ * @returns Absolute path to the user's home directory
+ */
+export declare function getHomeDirectory(): string;
+/**
+ * Check if a path equals the home directory.
+ *
+ * Handles path normalization to ensure accurate comparison.
+ *
+ * @param path - Path to check
+ * @returns True if path is the home directory
+ */
+export declare function isHomeDirectory(path: string): boolean;
+/**
+ * Convert home directory path to tilde notation for display.
+ *
+ * Only converts if the path is exactly the home directory or
+ * a subdirectory of it. Other paths are returned unchanged.
+ *
+ * @param path - Absolute path to normalize
+ * @returns Path with ~/ prefix if applicable, otherwise original path
+ */
+export declare function normalizePathWithTilde(path: string): string;
+/**
+ * Expand tilde notation to full home directory path.
+ *
+ * Used for path comparison in flow conditions and path resolution.
+ *
+ * @param path - Path that may start with ~/
+ * @returns Path with ~/ expanded to home directory
+ */
+export declare function expandTilde(path: string): string;
+//# sourceMappingURL=home-directory.d.ts.map

package/packages/core/dist/utils/home-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-directory.d.ts","sourceRoot":"","sources":["../../src/utils/home-directory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiB3D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUhD"}

package/packages/core/dist/utils/home-directory.js

@@ -0,0 +1,71 @@
+/**
+ * Home Directory Utilities
+ *
+ * Centralized module for all home directory operations.
+ * Handles path resolution, comparison, and display normalization.
+ */
+import { homedir } from 'os';
+import { resolve, normalize } from 'path';
+/**
+ * Get the home directory path.
+ *
+ * @returns Absolute path to the user's home directory
+ */
+export function getHomeDirectory() {
+    return homedir();
+}
+/**
+ * Check if a path equals the home directory.
+ *
+ * Handles path normalization to ensure accurate comparison.
+ *
+ * @param path - Path to check
+ * @returns True if path is the home directory
+ */
+export function isHomeDirectory(path) {
+    const normalizedPath = normalize(resolve(path));
+    const normalizedHome = normalize(getHomeDirectory());
+    return normalizedPath === normalizedHome;
+}
+/**
+ * Convert home directory path to tilde notation for display.
+ *
+ * Only converts if the path is exactly the home directory or
+ * a subdirectory of it. Other paths are returned unchanged.
+ *
+ * @param path - Absolute path to normalize
+ * @returns Path with ~/ prefix if applicable, otherwise original path
+ */
+export function normalizePathWithTilde(path) {
+    const normalizedPath = normalize(resolve(path));
+    const homeDir = getHomeDirectory();
+    const normalizedHome = normalize(homeDir);
+    // Exact match - return ~/
+    if (normalizedPath === normalizedHome) {
+        return '~/';
+    }
+    // Subdirectory of home - replace prefix
+    if (normalizedPath.startsWith(normalizedHome + '/')) {
+        return '~/' + normalizedPath.slice(normalizedHome.length + 1);
+    }
+    // Not in home directory - return as-is
+    return normalizedPath;
+}
+/**
+ * Expand tilde notation to full home directory path.
+ *
+ * Used for path comparison in flow conditions and path resolution.
+ *
+ * @param path - Path that may start with ~/
+ * @returns Path with ~/ expanded to home directory
+ */
+export function expandTilde(path) {
+    if (path === '~' || path === '~/') {
+        return getHomeDirectory();
+    }
+    if (path.startsWith('~/')) {
+        return resolve(getHomeDirectory(), path.slice(2));
+    }
+    return path;
+}
+//# sourceMappingURL=home-directory.js.map

package/packages/core/dist/utils/home-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-directory.js","sourceRoot":"","sources":["../../src/utils/home-directory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,SAAS,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACrD,OAAO,cAAc,KAAK,cAAc,CAAC;AAC3C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAE1C,0BAA0B;IAC1B,IAAI,cAAc,KAAK,cAAc,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,IAAI,cAAc,CAAC,UAAU,CAAC,cAAc,GAAG,GAAG,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,uCAAuC;IACvC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClC,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,gBAAgB,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/packages/core/dist/utils/ini.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Lightweight INI file parser/writer for credentials file
+ * Handles sections, key-value pairs, and comments
+ */
+export interface IniSection {
+    [key: string]: string;
+}
+export interface IniFile {
+    [section: string]: IniSection;
+}
+/**
+ * Parse INI file content into structured object
+ */
+export declare function parseIni(content: string): IniFile;
+/**
+ * Convert structured object back to INI format
+ */
+export declare function stringifyIni(data: IniFile): string;
+/**
+ * Read and parse INI file
+ */
+export declare function readIniFile(filePath: string): Promise<IniFile>;
+/**
+ * Write INI file with proper permissions
+ */
+export declare function writeIniFile(filePath: string, data: IniFile): Promise<void>;
+/**
+ * Get a specific value from INI file
+ */
+export declare function getIniValue(data: IniFile, section: string, key: string): string | undefined;
+/**
+ * Set a specific value in INI file data
+ */
+export declare function setIniValue(data: IniFile, section: string, key: string, value: string): void;
+/**
+ * Remove a section from INI file data
+ */
+export declare function removeIniSection(data: IniFile, section: string): void;
+/**
+ * Check if a section exists in INI file data
+ */
+export declare function hasIniSection(data: IniFile, section: string): boolean;
+//# sourceMappingURL=ini.d.ts.map

package/packages/core/dist/utils/ini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ini.d.ts","sourceRoot":"","sources":["../../src/utils/ini.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA0CjD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAgBlD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAapE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAajF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE3F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAK5F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAErE"}

package/packages/core/dist/utils/ini.js

@@ -0,0 +1,120 @@
+import { readFile, writeFile, chmod } from 'fs/promises';
+import { exists } from './fs.js';
+import { logger } from './logger.js';
+/**
+ * Parse INI file content into structured object
+ */
+export function parseIni(content) {
+    const result = {};
+    let currentSection = '';
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip empty lines and comments
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+        // Section header [section]
+        if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+            currentSection = trimmed.slice(1, -1);
+            if (!result[currentSection]) {
+                result[currentSection] = {};
+            }
+            continue;
+        }
+        // Key-value pair
+        const equalIndex = trimmed.indexOf('=');
+        if (equalIndex > 0) {
+            const key = trimmed.slice(0, equalIndex).trim();
+            const value = trimmed.slice(equalIndex + 1).trim();
+            if (currentSection) {
+                result[currentSection][key] = value;
+            }
+            else {
+                // Handle key-value pairs without section (treat as default section)
+                if (!result['default']) {
+                    result['default'] = {};
+                }
+                result['default'][key] = value;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Convert structured object back to INI format
+ */
+export function stringifyIni(data) {
+    const lines = [];
+    for (const [sectionName, section] of Object.entries(data)) {
+        if (Object.keys(section).length > 0) {
+            lines.push(`[${sectionName}]`);
+            for (const [key, value] of Object.entries(section)) {
+                lines.push(`${key} = ${value}`);
+            }
+            lines.push(''); // Empty line between sections
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Read and parse INI file
+ */
+export async function readIniFile(filePath) {
+    try {
+        if (!(await exists(filePath))) {
+            logger.debug(`INI file not found: ${filePath}`);
+            return {};
+        }
+        const content = await readFile(filePath, 'utf-8');
+        return parseIni(content);
+    }
+    catch (error) {
+        logger.error(`Failed to read INI file: ${filePath}`, { error });
+        throw new Error(`Failed to read INI file: ${error}`);
+    }
+}
+/**
+ * Write INI file with proper permissions
+ */
+export async function writeIniFile(filePath, data) {
+    try {
+        const content = stringifyIni(data);
+        await writeFile(filePath, content, 'utf-8');
+        // Set secure permissions (600) for credentials file
+        await chmod(filePath, 0o600);
+        logger.debug(`INI file written: ${filePath}`);
+    }
+    catch (error) {
+        logger.error(`Failed to write INI file: ${filePath}`, { error });
+        throw new Error(`Failed to write INI file: ${error}`);
+    }
+}
+/**
+ * Get a specific value from INI file
+ */
+export function getIniValue(data, section, key) {
+    return data[section]?.[key];
+}
+/**
+ * Set a specific value in INI file data
+ */
+export function setIniValue(data, section, key, value) {
+    if (!data[section]) {
+        data[section] = {};
+    }
+    data[section][key] = value;
+}
+/**
+ * Remove a section from INI file data
+ */
+export function removeIniSection(data, section) {
+    delete data[section];
+}
+/**
+ * Check if a section exists in INI file data
+ */
+export function hasIniSection(data, section) {
+    return section in data && Object.keys(data[section]).length > 0;
+}
+//# sourceMappingURL=ini.js.map

package/packages/core/dist/utils/ini.js.map

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

package/packages/core/dist/utils/install-error-messages.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Phase 6: Enhanced error messages for resource installation.
+ *
+ * Provides helpful, actionable error messages with suggestions
+ * for common failure scenarios.
+ */
+/**
+ * Format an error message for when no pattern matches a resource path.
+ * Provides helpful suggestions based on the path structure.
+ *
+ * @param resourcePath - The path that didn't match
+ * @param platformsConfig - Platforms configuration for pattern extraction
+ * @returns Formatted error message with suggestions
+ */
+export declare function formatNoPatternMatchError(resourcePath: string, platformsConfig: any): string;
+/**
+ * Format an error message for when a resource is not found.
+ *
+ * @param resourceName - Name of the resource
+ * @param resourceType - Type of resource (agent, skill, etc.)
+ * @param availableResources - List of available resources (if any)
+ * @returns Formatted error message
+ */
+export declare function formatResourceNotFoundError(resourceName: string, resourceType: 'agent' | 'skill' | 'plugin', availableResources?: string[]): string;
+/**
+ * Format an error message for version specification on sub-paths.
+ *
+ * @param input - The invalid input string
+ * @returns Formatted error message with correct syntax
+ */
+export declare function formatVersionOnSubPathError(input: string): string;
+//# sourceMappingURL=install-error-messages.d.ts.map

package/packages/core/dist/utils/install-error-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-error-messages.d.ts","sourceRoot":"","sources":["../../src/utils/install-error-messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,GAAG,GACnB,MAAM,CA4DR;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,EAC1C,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAC5B,MAAM,CAwBR;AAsDD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA+BjE"}