@cleocode/caamp 1.8.1 → 1.9.1

package/dist/chunk-TI6WOJDG.js

@@ -0,0 +1,276 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/core/platform-paths.ts
+import envPaths from "env-paths";
+import { arch, homedir, hostname, platform, release } from "os";
+import { isAbsolute, join, resolve } from "path";
+var APP_NAME = "agents";
+function resolveAgentsHomeOverride(value) {
+  if (value === void 0) return void 0;
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return void 0;
+  if (trimmed === "~") return homedir();
+  if (trimmed.startsWith("~/")) return join(homedir(), trimmed.slice(2));
+  if (isAbsolute(trimmed)) return resolve(trimmed);
+  return resolve(homedir(), trimmed);
+}
+var _paths = null;
+var _sysInfo = null;
+var _lastAgentsHome = void 0;
+function getPlatformPaths() {
+  const currentAgentsHome = process.env["AGENTS_HOME"];
+  if (_paths && currentAgentsHome !== _lastAgentsHome) {
+    _paths = null;
+    _sysInfo = null;
+  }
+  if (_paths) return _paths;
+  const ep = envPaths(APP_NAME, { suffix: "" });
+  _lastAgentsHome = currentAgentsHome;
+  _paths = {
+    data: resolveAgentsHomeOverride(currentAgentsHome) ?? ep.data,
+    config: ep.config,
+    cache: ep.cache,
+    log: ep.log,
+    temp: ep.temp
+  };
+  return _paths;
+}
+function getSystemInfo() {
+  if (_sysInfo) return _sysInfo;
+  const paths = getPlatformPaths();
+  _sysInfo = {
+    platform: platform(),
+    arch: arch(),
+    release: release(),
+    hostname: hostname(),
+    nodeVersion: process.version,
+    paths
+  };
+  return _sysInfo;
+}
+function _resetPlatformPathsCache() {
+  _paths = null;
+  _sysInfo = null;
+  _lastAgentsHome = void 0;
+}
+
+// src/core/paths/standard.ts
+import { existsSync } from "fs";
+import { homedir as homedir2 } from "os";
+import { dirname, join as join2 } from "path";
+function getPlatformLocations() {
+  const home = homedir2();
+  const platform2 = process.platform;
+  if (platform2 === "win32") {
+    const appData = process.env["APPDATA"] ?? join2(home, "AppData", "Roaming");
+    return {
+      home,
+      config: appData,
+      vscodeConfig: join2(appData, "Code", "User"),
+      zedConfig: join2(appData, "Zed"),
+      claudeDesktopConfig: join2(appData, "Claude"),
+      applications: []
+    };
+  }
+  if (platform2 === "darwin") {
+    const config2 = process.env["XDG_CONFIG_HOME"] ?? join2(home, ".config");
+    return {
+      home,
+      config: config2,
+      vscodeConfig: join2(home, "Library", "Application Support", "Code", "User"),
+      zedConfig: join2(home, "Library", "Application Support", "Zed"),
+      claudeDesktopConfig: join2(home, "Library", "Application Support", "Claude"),
+      applications: ["/Applications", join2(home, "Applications")]
+    };
+  }
+  const config = process.env["XDG_CONFIG_HOME"] ?? join2(home, ".config");
+  return {
+    home,
+    config,
+    vscodeConfig: join2(config, "Code", "User"),
+    zedConfig: join2(config, "zed"),
+    claudeDesktopConfig: join2(config, "Claude"),
+    applications: []
+  };
+}
+function getAgentsHome() {
+  return getPlatformPaths().data;
+}
+function getProjectAgentsDir(projectRoot = process.cwd()) {
+  return join2(projectRoot, ".agents");
+}
+function resolveProjectPath(relativePath, projectDir = process.cwd()) {
+  return join2(projectDir, relativePath);
+}
+function getCanonicalSkillsDir() {
+  return join2(getAgentsHome(), "skills");
+}
+function getLockFilePath() {
+  return join2(getAgentsHome(), ".caamp-lock.json");
+}
+function getAgentsMcpDir(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "mcp");
+  return join2(projectDir ?? process.cwd(), ".agents", "mcp");
+}
+function getAgentsMcpServersPath(scope = "global", projectDir) {
+  return join2(getAgentsMcpDir(scope, projectDir), "servers.json");
+}
+function getAgentsInstructFile(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "AGENTS.md");
+  return join2(projectDir ?? process.cwd(), ".agents", "AGENTS.md");
+}
+function getAgentsConfigPath(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "config.toml");
+  return join2(projectDir ?? process.cwd(), ".agents", "config.toml");
+}
+function getAgentsWikiDir(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "wiki");
+  return join2(projectDir ?? process.cwd(), ".agents", "wiki");
+}
+function getAgentsSpecDir(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "spec");
+  return join2(projectDir ?? process.cwd(), ".agents", "spec");
+}
+function getAgentsLinksDir(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "links");
+  return join2(projectDir ?? process.cwd(), ".agents", "links");
+}
+function resolveRegistryTemplatePath(template) {
+  const locations = getPlatformLocations();
+  return template.replace(/\$HOME/g, locations.home).replace(/\$CONFIG/g, locations.config).replace(/\$VSCODE_CONFIG/g, locations.vscodeConfig).replace(/\$ZED_CONFIG/g, locations.zedConfig).replace(/\$CLAUDE_DESKTOP_CONFIG/g, locations.claudeDesktopConfig).replace(/\$AGENTS_HOME/g, getAgentsHome());
+}
+function resolveProviderConfigPath(provider, scope, projectDir = process.cwd()) {
+  if (scope === "global") {
+    return provider.configPathGlobal;
+  }
+  if (!provider.configPathProject) {
+    return null;
+  }
+  return resolveProjectPath(provider.configPathProject, projectDir);
+}
+function resolvePreferredConfigScope(provider, useGlobalFlag) {
+  if (useGlobalFlag) {
+    return "global";
+  }
+  return provider.configPathProject ? "project" : "global";
+}
+function resolveProviderSkillsDir(provider, scope, projectDir = process.cwd()) {
+  if (scope === "global") {
+    return provider.pathSkills;
+  }
+  return resolveProjectPath(provider.pathProjectSkills, projectDir);
+}
+function resolveProviderSkillsDirs(provider, scope, projectDir = process.cwd()) {
+  const vendorPath = resolveProviderSkillsDir(provider, scope, projectDir);
+  const precedence = provider.capabilities?.skills?.precedence ?? "vendor-only";
+  const resolveAgentsPath = () => {
+    if (scope === "global") {
+      return provider.capabilities?.skills?.agentsGlobalPath ?? null;
+    }
+    const projectRelative = provider.capabilities?.skills?.agentsProjectPath ?? null;
+    return projectRelative ? join2(projectDir, projectRelative) : null;
+  };
+  switch (precedence) {
+    case "vendor-only":
+      return [vendorPath];
+    case "agents-canonical": {
+      const agentsPath = resolveAgentsPath();
+      return agentsPath ? [agentsPath] : [vendorPath];
+    }
+    case "agents-first": {
+      const agentsPath = resolveAgentsPath();
+      return agentsPath ? [agentsPath, vendorPath] : [vendorPath];
+    }
+    case "agents-supported": {
+      const agentsPath = resolveAgentsPath();
+      return agentsPath ? [vendorPath, agentsPath] : [vendorPath];
+    }
+    case "vendor-global-agents-project": {
+      if (scope === "global") {
+        return [vendorPath];
+      }
+      const agentsPath = resolveAgentsPath();
+      return agentsPath ? [agentsPath, vendorPath] : [vendorPath];
+    }
+    default:
+      return [vendorPath];
+  }
+}
+function resolveProviderProjectPath(provider, projectDir = process.cwd()) {
+  return resolveProjectPath(provider.pathProject, projectDir);
+}
+function resolveProvidersRegistryPath(startDir) {
+  const candidates = [
+    join2(startDir, "..", "..", "..", "providers", "registry.json"),
+    join2(startDir, "..", "providers", "registry.json")
+  ];
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  let current = startDir;
+  for (let i = 0; i < 8; i += 1) {
+    const candidate = join2(current, "providers", "registry.json");
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+    current = dirname(current);
+  }
+  throw new Error(`Cannot find providers/registry.json (searched from ${startDir})`);
+}
+function normalizeSkillSubPath(path) {
+  if (!path) return void 0;
+  const normalized = path.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/SKILL\.md$/i, "").trim();
+  return normalized.length > 0 ? normalized : void 0;
+}
+function buildSkillSubPathCandidates(marketplacePath, parsedPath) {
+  const candidates = [];
+  const base = normalizeSkillSubPath(marketplacePath);
+  const parsed = normalizeSkillSubPath(parsedPath);
+  if (base) candidates.push(base);
+  if (parsed) candidates.push(parsed);
+  const knownPrefixes = [".agents", ".claude"];
+  for (const value of [base, parsed]) {
+    if (!value || !value.startsWith("skills/")) continue;
+    for (const prefix of knownPrefixes) {
+      candidates.push(`${prefix}/${value}`);
+    }
+  }
+  if (candidates.length === 0) {
+    candidates.push(void 0);
+  }
+  return Array.from(new Set(candidates));
+}
+
+export {
+  __export,
+  getPlatformPaths,
+  getSystemInfo,
+  _resetPlatformPathsCache,
+  getPlatformLocations,
+  getAgentsHome,
+  getProjectAgentsDir,
+  getCanonicalSkillsDir,
+  getLockFilePath,
+  getAgentsMcpDir,
+  getAgentsMcpServersPath,
+  getAgentsInstructFile,
+  getAgentsConfigPath,
+  getAgentsWikiDir,
+  getAgentsSpecDir,
+  getAgentsLinksDir,
+  resolveRegistryTemplatePath,
+  resolveProviderConfigPath,
+  resolvePreferredConfigScope,
+  resolveProviderSkillsDir,
+  resolveProviderSkillsDirs,
+  resolveProviderProjectPath,
+  resolveProvidersRegistryPath,
+  buildSkillSubPathCandidates
+};
+//# sourceMappingURL=chunk-TI6WOJDG.js.map

package/dist/chunk-TI6WOJDG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/platform-paths.ts","../src/core/paths/standard.ts"],"sourcesContent":["/**\n * Central OS platform path resolution using env-paths.\n *\n * Provides OS-appropriate paths for CAAMP's global directories using\n * XDG conventions on Linux, standard conventions on macOS/Windows.\n * Results are cached for the process lifetime. Env vars take precedence.\n *\n * Platform path defaults:\n *   data:   ~/.local/share/agents  | ~/Library/Application Support/agents | %LOCALAPPDATA%\\agents\\Data\n *   config: ~/.config/agents       | ~/Library/Preferences/agents          | %APPDATA%\\agents\\Config\n *   cache:  ~/.cache/agents        | ~/Library/Caches/agents               | %LOCALAPPDATA%\\agents\\Cache\n *   log:    ~/.local/state/agents  | ~/Library/Logs/agents                 | %LOCALAPPDATA%\\agents\\Log\n *   temp:   /tmp/<user>/agents     | /var/folders/.../agents               | %TEMP%\\agents\n *\n * AGENTS_HOME env var overrides the data path for backward compatibility\n * with existing ~/.agents installations.\n */\n\nimport envPaths from 'env-paths';\nimport { arch, homedir, hostname, platform, release } from 'node:os';\nimport { isAbsolute, join, resolve } from 'node:path';\n\nconst APP_NAME = 'agents';\n\n/**\n * Normalize an AGENTS_HOME env var value to an absolute path.\n * Returns undefined when the value is absent, empty, or whitespace-only\n * (callers should fall back to the OS default in that case).\n */\nfunction resolveAgentsHomeOverride(value: string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  const trimmed = value.trim();\n  if (trimmed.length === 0) return undefined;\n  if (trimmed === '~') return homedir();\n  if (trimmed.startsWith('~/')) return join(homedir(), trimmed.slice(2));\n  if (isAbsolute(trimmed)) return resolve(trimmed);\n  return resolve(homedir(), trimmed);\n}\n\n/**\n * OS-appropriate directory paths for CAAMP's global storage.\n *\n * @public\n */\nexport interface PlatformPaths {\n  /** User data dir. Override with AGENTS_HOME env var. */\n  data: string;\n  /** OS config dir (XDG_CONFIG_HOME / Library/Preferences / %APPDATA%). */\n  config: string;\n  /** OS cache dir. */\n  cache: string;\n  /** OS log dir. */\n  log: string;\n  /** OS temp dir. */\n  temp: string;\n}\n\n/**\n * Snapshot of the current system environment and resolved platform paths.\n *\n * @public\n */\nexport interface SystemInfo {\n  /** Operating system platform identifier. */\n  platform: NodeJS.Platform;\n  /** CPU architecture (e.g. `\"x64\"`, `\"arm64\"`). */\n  arch: string;\n  /** OS kernel release version string. */\n  release: string;\n  /** Machine hostname. */\n  hostname: string;\n  /** Node.js version string (e.g. `\"v20.11.0\"`). */\n  nodeVersion: string;\n  /** Resolved platform directory paths. */\n  paths: PlatformPaths;\n}\n\nlet _paths: PlatformPaths | null = null;\nlet _sysInfo: SystemInfo | null = null;\nlet _lastAgentsHome: string | undefined = undefined;\n\n/**\n * Get OS-appropriate paths for CAAMP's global directories.\n *\n * @remarks\n * Cached after first call. The `AGENTS_HOME` env var overrides the data path\n * for backward compatibility with existing `~/.agents` installations. The\n * cache auto-invalidates when `AGENTS_HOME` changes (supports test isolation).\n *\n * @returns Resolved platform paths\n *\n * @example\n * ```typescript\n * const paths = getPlatformPaths();\n * console.log(paths.data); // e.g. \"/home/user/.local/share/agents\"\n * ```\n *\n * @public\n */\nexport function getPlatformPaths(): PlatformPaths {\n  const currentAgentsHome = process.env['AGENTS_HOME'];\n\n  // Invalidate if AGENTS_HOME changed since last cache build\n  if (_paths && currentAgentsHome !== _lastAgentsHome) {\n    _paths = null;\n    _sysInfo = null;\n  }\n\n  if (_paths) return _paths;\n\n  const ep = envPaths(APP_NAME, { suffix: '' });\n  _lastAgentsHome = currentAgentsHome;\n\n  _paths = {\n    data: resolveAgentsHomeOverride(currentAgentsHome) ?? ep.data,\n    config: ep.config,\n    cache: ep.cache,\n    log: ep.log,\n    temp: ep.temp,\n  };\n\n  return _paths;\n}\n\n/**\n * Get a cached system information snapshot.\n *\n * @remarks\n * Captured once and reused for the process lifetime. Includes platform,\n * architecture, hostname, Node version, and resolved paths.\n *\n * @returns Cached system info object\n *\n * @example\n * ```typescript\n * const info = getSystemInfo();\n * console.log(`Running on ${info.platform}/${info.arch}`);\n * ```\n *\n * @public\n */\nexport function getSystemInfo(): SystemInfo {\n  if (_sysInfo) return _sysInfo;\n\n  const paths = getPlatformPaths();\n\n  _sysInfo = {\n    platform: platform(),\n    arch: arch(),\n    release: release(),\n    hostname: hostname(),\n    nodeVersion: process.version,\n    paths,\n  };\n\n  return _sysInfo;\n}\n\n/**\n * Invalidate the path and system info caches.\n * Use in tests after mutating AGENTS_HOME env var.\n * @internal\n */\nexport function _resetPlatformPathsCache(): void {\n  _paths = null;\n  _sysInfo = null;\n  _lastAgentsHome = undefined;\n}\n","import { existsSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport type { Provider } from \"../../types.js\";\nimport { getPlatformPaths } from \"../platform-paths.js\";\n\n/**\n * Scope for path resolution, either global (user home) or project-local.\n *\n * @remarks\n * Global scope resolves paths under the user's home directory (e.g., `~/.agents/`).\n * Project scope resolves paths relative to the project root (e.g., `<project>/.agents/`).\n *\n * @public\n */\nexport type PathScope = \"project\" | \"global\";\n\n/**\n * Platform-specific directory locations for agent configuration.\n *\n * @remarks\n * Provides resolved paths for the current operating system, accounting for\n * platform differences in config directory locations (XDG on Linux, Library on macOS,\n * AppData on Windows).\n *\n * @public\n */\nexport interface PlatformLocations {\n  /** The user's home directory path. */\n  home: string;\n  /** The platform-specific configuration directory. */\n  config: string;\n  /** The VS Code user settings directory. */\n  vscodeConfig: string;\n  /** The Zed editor configuration directory. */\n  zedConfig: string;\n  /** The Claude Desktop application configuration directory. */\n  claudeDesktopConfig: string;\n  /** List of application directories (macOS only). */\n  applications: string[];\n}\n\n/**\n * Resolves platform-specific directory locations for the current OS.\n *\n * @remarks\n * Detects the current platform and returns appropriate paths for configuration,\n * editor settings, and application directories. Uses `XDG_CONFIG_HOME` on Linux\n * and macOS when available, falls back to conventional defaults. On Windows,\n * uses `APPDATA` or defaults to `~/AppData/Roaming`.\n *\n * @returns Platform-specific directory locations\n *\n * @example\n * ```typescript\n * const locations = getPlatformLocations();\n * console.log(locations.config); // e.g., \"/home/user/.config\"\n * ```\n *\n * @public\n */\nexport function getPlatformLocations(): PlatformLocations {\n  const home = homedir();\n  const platform = process.platform;\n\n  if (platform === \"win32\") {\n    const appData = process.env[\"APPDATA\"] ?? join(home, \"AppData\", \"Roaming\");\n    return {\n      home,\n      config: appData,\n      vscodeConfig: join(appData, \"Code\", \"User\"),\n      zedConfig: join(appData, \"Zed\"),\n      claudeDesktopConfig: join(appData, \"Claude\"),\n      applications: [],\n    };\n  }\n\n  if (platform === \"darwin\") {\n    const config = process.env[\"XDG_CONFIG_HOME\"] ?? join(home, \".config\");\n    return {\n      home,\n      config,\n      vscodeConfig: join(home, \"Library\", \"Application Support\", \"Code\", \"User\"),\n      zedConfig: join(home, \"Library\", \"Application Support\", \"Zed\"),\n      claudeDesktopConfig: join(home, \"Library\", \"Application Support\", \"Claude\"),\n      applications: [\"/Applications\", join(home, \"Applications\")],\n    };\n  }\n\n  const config = process.env[\"XDG_CONFIG_HOME\"] ?? join(home, \".config\");\n  return {\n    home,\n    config,\n    vscodeConfig: join(config, \"Code\", \"User\"),\n    zedConfig: join(config, \"zed\"),\n    claudeDesktopConfig: join(config, \"Claude\"),\n    applications: [],\n  };\n}\n\n/**\n * Returns the global agents home directory path.\n *\n * @remarks\n * Delegates to the platform paths module to resolve the data directory\n * for the current operating system. This is the root for global agent\n * configuration such as canonical skills and lock files.\n *\n * @returns The absolute path to the global agents home directory\n *\n * @example\n * ```typescript\n * const home = getAgentsHome();\n * // e.g., \"/home/user/.local/share/caamp\"\n * ```\n *\n * @public\n */\nexport function getAgentsHome(): string {\n  return getPlatformPaths().data;\n}\n\n/**\n * Returns the project-local `.agents` directory path.\n *\n * @remarks\n * Joins the project root with `.agents` to produce the conventional\n * project-scoped agent configuration directory.\n *\n * @param projectRoot - The project root directory, defaults to `process.cwd()`\n * @returns The absolute path to the project's `.agents` directory\n *\n * @example\n * ```typescript\n * const dir = getProjectAgentsDir(\"/home/user/my-project\");\n * // returns \"/home/user/my-project/.agents\"\n * ```\n *\n * @public\n */\nexport function getProjectAgentsDir(projectRoot = process.cwd()): string {\n  return join(projectRoot, \".agents\");\n}\n\n/**\n * Resolves a relative path against a project directory.\n *\n * @remarks\n * A simple path join utility that combines the project directory with\n * the given relative path to produce an absolute path.\n *\n * @param relativePath - The relative path to resolve\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved absolute path\n *\n * @example\n * ```typescript\n * const path = resolveProjectPath(\".agents/config.toml\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/config.toml\"\n * ```\n *\n * @public\n */\nexport function resolveProjectPath(relativePath: string, projectDir = process.cwd()): string {\n  return join(projectDir, relativePath);\n}\n\n/**\n * Returns the canonical skills storage directory path.\n *\n * @remarks\n * Skills are stored once in this canonical directory and symlinked into\n * provider-specific locations. This is the single source of truth for\n * installed skill files.\n *\n * @returns The absolute path to the canonical skills directory\n *\n * @example\n * ```typescript\n * const dir = getCanonicalSkillsDir();\n * // e.g., \"/home/user/.local/share/caamp/skills\"\n * ```\n *\n * @public\n */\nexport function getCanonicalSkillsDir(): string {\n  return join(getAgentsHome(), \"skills\");\n}\n\n/**\n * Returns the path to the CAAMP lock file.\n *\n * @remarks\n * The lock file tracks installed skills and their versions to enable\n * deterministic reinstallation and conflict detection.\n *\n * @returns The absolute path to the `.caamp-lock.json` file\n *\n * @example\n * ```typescript\n * const lockPath = getLockFilePath();\n * // e.g., \"/home/user/.local/share/caamp/.caamp-lock.json\"\n * ```\n *\n * @public\n */\nexport function getLockFilePath(): string {\n  return join(getAgentsHome(), \".caamp-lock.json\");\n}\n\n// ── .agents/ Standard Directory Structure ────────────────────────────\n\n/**\n * Gets the MCP directory within the `.agents/` standard structure.\n *\n * @remarks\n * Resolves the MCP configuration directory based on scope. Global scope\n * points to `~/.agents/mcp/`, while project scope points to\n * `<project>/.agents/mcp/`.\n *\n * @param scope - `\"global\"` for `~/.agents/mcp/`, `\"project\"` for `<project>/.agents/mcp/`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the MCP directory\n *\n * @example\n * ```typescript\n * const globalMcp = getAgentsMcpDir(\"global\");\n * const projectMcp = getAgentsMcpDir(\"project\", \"/home/user/project\");\n * ```\n *\n * @public\n */\nexport function getAgentsMcpDir(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"mcp\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"mcp\");\n}\n\n/**\n * Gets the MCP servers.json path within the `.agents/` standard structure.\n *\n * @remarks\n * Per the `.agents/` standard (Section 9), this is the canonical MCP\n * server registry that should be checked before legacy per-provider configs.\n *\n * @param scope - `\"global\"` for `~/.agents/mcp/servers.json`, `\"project\"` for `<project>/.agents/mcp/servers.json`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the `servers.json` file\n *\n * @example\n * ```typescript\n * const serversPath = getAgentsMcpServersPath(\"global\");\n * // e.g., \"/home/user/.agents/mcp/servers.json\"\n * ```\n *\n * @public\n */\nexport function getAgentsMcpServersPath(scope: PathScope = \"global\", projectDir?: string): string {\n  return join(getAgentsMcpDir(scope, projectDir), \"servers.json\");\n}\n\n/**\n * Gets the primary AGENTS.md instruction file path within `.agents/`.\n *\n * @remarks\n * Returns the path to the AGENTS.md file for the given scope. This is the\n * standard instruction file that agents read for project or global guidance.\n *\n * @param scope - `\"global\"` for `~/.agents/AGENTS.md`, `\"project\"` for `<project>/.agents/AGENTS.md`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the AGENTS.md file\n *\n * @example\n * ```typescript\n * const agentsFile = getAgentsInstructFile(\"project\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/AGENTS.md\"\n * ```\n *\n * @public\n */\nexport function getAgentsInstructFile(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"AGENTS.md\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"AGENTS.md\");\n}\n\n/**\n * Gets the config.toml path within the `.agents/` standard structure.\n *\n * @remarks\n * Returns the path to the TOML configuration file for agent settings.\n * Global scope points to `~/.agents/config.toml`, project scope points\n * to `<project>/.agents/config.toml`.\n *\n * @param scope - `\"global\"` for `~/.agents/config.toml`, `\"project\"` for `<project>/.agents/config.toml`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the config.toml file\n *\n * @example\n * ```typescript\n * const configPath = getAgentsConfigPath(\"global\");\n * // e.g., \"/home/user/.agents/config.toml\"\n * ```\n *\n * @public\n */\nexport function getAgentsConfigPath(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"config.toml\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"config.toml\");\n}\n\n/**\n * Gets the wiki directory within the `.agents/` standard structure.\n *\n * @remarks\n * The wiki directory stores markdown documentation files that agents\n * can reference for project or global knowledge.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the wiki directory\n *\n * @example\n * ```typescript\n * const wikiDir = getAgentsWikiDir(\"project\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/wiki\"\n * ```\n *\n * @public\n */\nexport function getAgentsWikiDir(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"wiki\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"wiki\");\n}\n\n/**\n * Gets the spec directory within the `.agents/` standard structure.\n *\n * @remarks\n * The spec directory stores specification files used by agents for\n * project architecture and design reference.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the spec directory\n *\n * @example\n * ```typescript\n * const specDir = getAgentsSpecDir(\"global\");\n * // e.g., \"/home/user/.agents/spec\"\n * ```\n *\n * @public\n */\nexport function getAgentsSpecDir(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"spec\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"spec\");\n}\n\n/**\n * Gets the links directory within the `.agents/` standard structure.\n *\n * @remarks\n * The links directory stores symlinks or references to external resources\n * that agents can follow for additional context.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the links directory\n *\n * @example\n * ```typescript\n * const linksDir = getAgentsLinksDir(\"project\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/links\"\n * ```\n *\n * @public\n */\nexport function getAgentsLinksDir(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"links\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"links\");\n}\n\n/**\n * Resolves a registry template path by substituting platform variables.\n *\n * @remarks\n * Replaces template variables like `$HOME`, `$CONFIG`, `$VSCODE_CONFIG`,\n * `$ZED_CONFIG`, `$CLAUDE_DESKTOP_CONFIG`, and `$AGENTS_HOME` with their\n * actual platform-specific values. Used to resolve paths from the provider\n * registry JSON.\n *\n * @param template - The template string containing `$VARIABLE` placeholders\n * @returns The resolved absolute path with all variables expanded\n *\n * @example\n * ```typescript\n * const path = resolveRegistryTemplatePath(\"$HOME/.config/claude/settings.json\");\n * // e.g., \"/home/user/.config/claude/settings.json\"\n * ```\n *\n * @public\n */\nexport function resolveRegistryTemplatePath(template: string): string {\n  const locations = getPlatformLocations();\n  return template\n    .replace(/\\$HOME/g, locations.home)\n    .replace(/\\$CONFIG/g, locations.config)\n    .replace(/\\$VSCODE_CONFIG/g, locations.vscodeConfig)\n    .replace(/\\$ZED_CONFIG/g, locations.zedConfig)\n    .replace(/\\$CLAUDE_DESKTOP_CONFIG/g, locations.claudeDesktopConfig)\n    .replace(/\\$AGENTS_HOME/g, getAgentsHome());\n}\n\n/**\n * Resolves the configuration file path for a provider at the given scope.\n *\n * @remarks\n * For global scope, returns the provider's `configPathGlobal` directly.\n * For project scope, joins the project directory with the provider's\n * `configPathProject`. Returns null if the provider has no project-scoped\n * config path defined.\n *\n * @param provider - The provider whose config path to resolve\n * @param scope - Whether to resolve global or project config path\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved config file path, or null if unavailable for the given scope\n *\n * @example\n * ```typescript\n * const configPath = resolveProviderConfigPath(provider, \"project\", \"/home/user/project\");\n * if (configPath) {\n *   console.log(\"Config at:\", configPath);\n * }\n * ```\n *\n * @public\n */\nexport function resolveProviderConfigPath(\n  provider: Provider,\n  scope: PathScope,\n  projectDir = process.cwd(),\n): string | null {\n  if (scope === \"global\") {\n    return provider.configPathGlobal;\n  }\n  if (!provider.configPathProject) {\n    return null;\n  }\n  return resolveProjectPath(provider.configPathProject, projectDir);\n}\n\n/**\n * Determines the preferred configuration scope for a provider.\n *\n * @remarks\n * If the global flag is explicitly set, always returns `\"global\"`. Otherwise,\n * returns `\"project\"` if the provider supports project-scoped configuration,\n * or `\"global\"` as a fallback.\n *\n * @param provider - The provider to determine scope for\n * @param useGlobalFlag - Optional flag to force global scope\n * @returns The preferred path scope for configuration\n *\n * @example\n * ```typescript\n * const scope = resolvePreferredConfigScope(provider, false);\n * // returns \"project\" if provider has configPathProject, otherwise \"global\"\n * ```\n *\n * @public\n */\nexport function resolvePreferredConfigScope(provider: Provider, useGlobalFlag?: boolean): PathScope {\n  if (useGlobalFlag) {\n    return \"global\";\n  }\n  return provider.configPathProject ? \"project\" : \"global\";\n}\n\n/**\n * Resolves the skills directory path for a provider at the given scope.\n *\n * @remarks\n * For global scope, returns the provider's `pathSkills` directly.\n * For project scope, joins the project directory with the provider's\n * `pathProjectSkills` relative path.\n *\n * @param provider - The provider whose skills directory to resolve\n * @param scope - Whether to resolve global or project skills path\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved skills directory path\n *\n * @example\n * ```typescript\n * const skillsDir = resolveProviderSkillsDir(provider, \"global\");\n * // e.g., \"/home/user/.claude/skills\"\n * ```\n *\n * @public\n */\nexport function resolveProviderSkillsDir(\n  provider: Provider,\n  scope: PathScope,\n  projectDir = process.cwd(),\n): string {\n  if (scope === \"global\") {\n    return provider.pathSkills;\n  }\n  return resolveProjectPath(provider.pathProjectSkills, projectDir);\n}\n\n/**\n * Gets all target directories for skill installation based on provider precedence.\n *\n * @remarks\n * Resolves one or more skill directories based on the provider's skills\n * precedence setting. The precedence determines whether vendor-only, agents-canonical,\n * agents-first, agents-supported, or vendor-global-agents-project strategies are used.\n * Falls back to the vendor path when the agents path is not configured.\n *\n * @param provider - Provider to resolve paths for\n * @param scope - Whether to resolve global or project paths\n * @param projectDir - Project directory for project-scope resolution\n * @returns Array of target directories for symlink creation\n *\n * @example\n * ```typescript\n * const dirs = resolveProviderSkillsDirs(provider, \"project\", \"/home/user/project\");\n * for (const dir of dirs) {\n *   console.log(\"Install skill to:\", dir);\n * }\n * ```\n *\n * @public\n */\nexport function resolveProviderSkillsDirs(\n  provider: Provider,\n  scope: PathScope,\n  projectDir = process.cwd(),\n): string[] {\n  const vendorPath = resolveProviderSkillsDir(provider, scope, projectDir);\n  const precedence = provider.capabilities?.skills?.precedence ?? \"vendor-only\";\n\n  const resolveAgentsPath = (): string | null => {\n    if (scope === \"global\") {\n      return provider.capabilities?.skills?.agentsGlobalPath ?? null;\n    }\n    const projectRelative = provider.capabilities?.skills?.agentsProjectPath ?? null;\n    return projectRelative ? join(projectDir, projectRelative) : null;\n  };\n\n  switch (precedence) {\n    case \"vendor-only\":\n      return [vendorPath];\n\n    case \"agents-canonical\": {\n      const agentsPath = resolveAgentsPath();\n      return agentsPath ? [agentsPath] : [vendorPath];\n    }\n\n    case \"agents-first\": {\n      const agentsPath = resolveAgentsPath();\n      return agentsPath ? [agentsPath, vendorPath] : [vendorPath];\n    }\n\n    case \"agents-supported\": {\n      const agentsPath = resolveAgentsPath();\n      return agentsPath ? [vendorPath, agentsPath] : [vendorPath];\n    }\n\n    case \"vendor-global-agents-project\": {\n      if (scope === \"global\") {\n        return [vendorPath];\n      }\n      const agentsPath = resolveAgentsPath();\n      return agentsPath ? [agentsPath, vendorPath] : [vendorPath];\n    }\n\n    default:\n      return [vendorPath];\n  }\n}\n\n/**\n * Resolves a provider's project-level path against a project directory.\n *\n * @remarks\n * Joins the project directory with the provider's `pathProject` relative path\n * to produce an absolute path for project-scoped provider configuration.\n *\n * @param provider - The provider whose project path to resolve\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved absolute path for the provider's project directory\n *\n * @example\n * ```typescript\n * const projectPath = resolveProviderProjectPath(provider, \"/home/user/project\");\n * // e.g., \"/home/user/project/.claude\"\n * ```\n *\n * @public\n */\nexport function resolveProviderProjectPath(provider: Provider, projectDir = process.cwd()): string {\n  return resolveProjectPath(provider.pathProject, projectDir);\n}\n\n/**\n * Locates the providers registry.json file by searching up from a start directory.\n *\n * @remarks\n * First checks common relative locations (3 levels up and 1 level up),\n * then walks up to 8 parent directories looking for `providers/registry.json`.\n * Throws if the registry file cannot be found.\n *\n * @param startDir - The directory to start searching from\n * @returns The absolute path to the found `providers/registry.json` file\n * @throws Error if `providers/registry.json` cannot be found within 8 parent levels\n *\n * @example\n * ```typescript\n * const registryPath = resolveProvidersRegistryPath(__dirname);\n * // e.g., \"/home/user/caamp/providers/registry.json\"\n * ```\n *\n * @public\n */\nexport function resolveProvidersRegistryPath(startDir: string): string {\n  const candidates = [\n    join(startDir, \"..\", \"..\", \"..\", \"providers\", \"registry.json\"),\n    join(startDir, \"..\", \"providers\", \"registry.json\"),\n  ];\n\n  for (const candidate of candidates) {\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  let current = startDir;\n  for (let i = 0; i < 8; i += 1) {\n    const candidate = join(current, \"providers\", \"registry.json\");\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n    current = dirname(current);\n  }\n\n  throw new Error(`Cannot find providers/registry.json (searched from ${startDir})`);\n}\n\n/**\n * Normalizes a skill sub-path by cleaning separators and removing SKILL.md suffix.\n *\n * @remarks\n * Converts backslashes to forward slashes, strips leading slashes and\n * trailing `/SKILL.md`, and trims whitespace. Returns undefined for\n * empty or falsy inputs.\n *\n * @param path - The raw skill sub-path to normalize\n * @returns The normalized path, or undefined if the input is empty or falsy\n *\n * @example\n * ```typescript\n * const normalized = normalizeSkillSubPath(\"skills/my-skill/SKILL.md\");\n * // returns \"skills/my-skill\"\n * ```\n *\n * @public\n */\nexport function normalizeSkillSubPath(path: string | undefined): string | undefined {\n  if (!path) return undefined;\n  const normalized = path.replace(/\\\\/g, \"/\").replace(/^\\/+/, \"\").replace(/\\/SKILL\\.md$/i, \"\").trim();\n  return normalized.length > 0 ? normalized : undefined;\n}\n\n/**\n * Builds a list of candidate sub-paths for skill file resolution.\n *\n * @remarks\n * Normalizes both the marketplace and parsed paths, then generates additional\n * candidates by prepending known prefixes (`.agents`, `.claude`) to paths\n * starting with `skills/`. Returns a deduplicated list of candidates, with\n * an undefined entry as fallback if no candidates are found.\n *\n * @param marketplacePath - The sub-path from the marketplace listing\n * @param parsedPath - The sub-path parsed from the source URL\n * @returns A deduplicated array of candidate sub-paths\n *\n * @example\n * ```typescript\n * const candidates = buildSkillSubPathCandidates(\"skills/my-skill\", undefined);\n * // returns [\"skills/my-skill\", \".agents/skills/my-skill\", \".claude/skills/my-skill\"]\n * ```\n *\n * @public\n */\nexport function buildSkillSubPathCandidates(\n  marketplacePath: string | undefined,\n  parsedPath: string | undefined,\n): (string | undefined)[] {\n  const candidates: (string | undefined)[] = [];\n  const base = normalizeSkillSubPath(marketplacePath);\n  const parsed = normalizeSkillSubPath(parsedPath);\n\n  if (base) candidates.push(base);\n  if (parsed) candidates.push(parsed);\n\n  const knownPrefixes = [\".agents\", \".claude\"];\n  for (const value of [base, parsed]) {\n    if (!value || !value.startsWith(\"skills/\")) continue;\n    for (const prefix of knownPrefixes) {\n      candidates.push(`${prefix}/${value}`);\n    }\n  }\n\n  if (candidates.length === 0) {\n    candidates.push(undefined);\n  }\n\n  return Array.from(new Set(candidates));\n}\n"],"mappings":"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","names":["homedir","join","homedir","platform","join","config"]}

package/dist/{chunk-LDTYDQGR.js → chunk-ZF4W3K5H.js}

@@ -1,19 +1,21 @@
+import {
+  getAllProviders,
+  groupByInstructFile,
+  injectAll
+} from "./chunk-O7IVK5JY.js";
 import {
   __export,
   getAgentsConfigPath,
   getAgentsHome,
   getAgentsMcpDir,
   getAgentsMcpServersPath,
-  getAllProviders,
   getCanonicalSkillsDir,
   getLockFilePath,
   getPlatformLocations,
-  groupByInstructFile,
-  injectAll,
   resolveProviderConfigPath,
   resolveProviderProjectPath,
   resolveProviderSkillsDirs
-} from "./chunk-CPHF5IM4.js";
+} from "./chunk-TI6WOJDG.js";
 
 // src/core/formats/utils.ts
 function deepMerge(target, source) {
@@ -1752,8 +1754,11 @@ function isMarketplaceScoped(input) {
 // src/core/network/fetch.ts
 var DEFAULT_FETCH_TIMEOUT_MS = 1e4;
 var NetworkError = class extends Error {
+  /** Classification of the failure. */
   kind;
+  /** URL that was being fetched. */
   url;
+  /** HTTP status code (only present for `"http"` kind). */
   status;
   constructor(message, kind, url, status) {
     super(message);
@@ -1823,7 +1828,15 @@ function toResult(skill) {
   };
 }
 var SkillsMPAdapter = class {
+  /** The marketplace identifier used in search results. */
   name = "agentskills.in";
+  /**
+   * Search for skills by query string.
+   *
+   * @param query - Search query to match against skill names and descriptions.
+   * @param limit - Maximum number of results to return.
+   * @returns Array of marketplace results sorted by stars.
+   */
   async search(query, limit = 20) {
     const params = new URLSearchParams({
       search: query,
@@ -1835,6 +1848,12 @@ var SkillsMPAdapter = class {
     const data = await response.json();
     return data.skills.map(toResult);
   }
+  /**
+   * Look up a specific skill by its scoped name.
+   *
+   * @param scopedName - The scoped skill name (e.g. `"@author/skill-name"`).
+   * @returns The matching marketplace result, or `null` if not found.
+   */
   async getSkill(scopedName) {
     const parts = parseScopedName(scopedName);
     const searchTerms = parts ? [parts.name, `${parts.author} ${parts.name}`, scopedName] : [scopedName];
@@ -1877,7 +1896,15 @@ function toResult2(skill) {
   };
 }
 var SkillsShAdapter = class {
+  /** The marketplace identifier used in search results. */
   name = "skills.sh";
+  /**
+   * Search for skills by query string.
+   *
+   * @param query - Search query to match against skill names.
+   * @param limit - Maximum number of results to return.
+   * @returns Array of marketplace results.
+   */
   async search(query, limit = 20) {
     const params = new URLSearchParams({
       q: query,
@@ -1888,6 +1915,12 @@ var SkillsShAdapter = class {
     const data = await response.json();
     return data.results.map(toResult2);
   }
+  /**
+   * Look up a specific skill by its scoped name.
+   *
+   * @param scopedName - The scoped skill name (e.g. `"@author/skill-name"`).
+   * @returns The matching marketplace result, or `null` if not found.
+   */
   async getSkill(scopedName) {
     const results = await this.search(scopedName, 5);
     return results.find((r) => r.scopedName === scopedName) ?? null;
@@ -1896,6 +1929,7 @@ var SkillsShAdapter = class {
 
 // src/core/marketplace/client.ts
 var MarketplaceUnavailableError = class extends Error {
+  /** Per-adapter failure messages. */
   details;
   constructor(message, details) {
     super(message);
@@ -1904,6 +1938,7 @@ var MarketplaceUnavailableError = class extends Error {
   }
 };
 var MarketplaceClient = class {
+  /** Configured marketplace adapters. */
   adapters;
   /**
    * Create a new marketplace client.
@@ -3570,4 +3605,4 @@ export {
   toSarif,
   validateSkill
 };
-//# sourceMappingURL=chunk-LDTYDQGR.js.map
+//# sourceMappingURL=chunk-ZF4W3K5H.js.map