@cleocode/caamp 1.1.3 → 1.3.0

package/dist/index.d.ts

@@ -1651,10 +1651,9 @@ declare function isMarketplaceScoped(input: string): boolean;
 /**
  * Skill catalog - registry pattern for pluggable skill libraries.
  *
- * Projects register their skill library via registerSkillLibrary() or
- * registerSkillLibraryFromPath(). If no library is registered, CAAMP
- * attempts auto-discovery via CAAMP_SKILL_LIBRARY env var or the
- * canonical ~/.agents/skill-library/ location.
+ * Projects MUST register their skill library via registerSkillLibrary() or
+ * registerSkillLibraryFromPath(). CAAMP no longer auto-discovers from
+ * ~/.agents/skill-library/ - explicit registration is required.
  *
  * All public functions delegate to the registered SkillLibrary instance.
  */
@@ -1943,6 +1942,38 @@ declare function scanDirectory(dirPath: string): Promise<AuditResult[]>;
  */
 declare function toSarif(results: AuditResult[]): object;
 
+/**
+ * CLEO MCP channel profile helpers.
+ */
+
+type CleoChannel = "stable" | "beta" | "dev";
+interface CleoProfileBuildOptions {
+    channel: CleoChannel;
+    version?: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cleoDir?: string;
+}
+interface CleoProfileBuildResult {
+    channel: CleoChannel;
+    serverName: string;
+    config: McpServerConfig;
+    packageSpec?: string;
+}
+interface CommandReachability {
+    reachable: boolean;
+    method: "path" | "lookup";
+    detail: string;
+}
+declare function normalizeCleoChannel(value?: string): CleoChannel;
+declare function resolveCleoServerName(channel: CleoChannel): string;
+declare function resolveChannelFromServerName(serverName: string): CleoChannel | null;
+declare function buildCleoProfile(options: CleoProfileBuildOptions): CleoProfileBuildResult;
+declare function checkCommandReachability(command: string): CommandReachability;
+declare function parseEnvAssignments(values: string[]): Record<string, string>;
+declare function isCleoSource(source: string): boolean;
+
 /**
  * Per-agent MCP config transformations
  *
@@ -2213,7 +2244,7 @@ declare function getTrackedSkills(): Promise<Record<string, LockEntry>>;
  * Check if a skill has updates available by comparing the installed version
  * against the latest remote commit SHA.
  *
- * Only supports GitHub and GitLab sources. Returns `"unknown"` for local,
+ * Only supports GitHub, GitLab, and library (package-based) sources. Returns `"unknown"` for local,
  * package, or other source types.
  *
  * @param skillName - Name of the installed skill to check
@@ -2233,6 +2264,17 @@ declare function checkSkillUpdate(skillName: string): Promise<{
     latestVersion?: string;
     status: "up-to-date" | "update-available" | "unknown";
 }>;
+/**
+ * Check for updates across all tracked skills.
+ *
+ * @returns Object mapping skill names to their update status
+ */
+declare function checkAllSkillUpdates(): Promise<Record<string, {
+    hasUpdate: boolean;
+    currentVersion?: string;
+    latestVersion?: string;
+    status: "up-to-date" | "update-available" | "unknown";
+}>>;
 
 /**
  * Unified marketplace client
@@ -2671,4 +2713,4 @@ declare function isVerbose(): boolean;
  */
 declare function isQuiet(): boolean;
 
-export { type AuditFinding, type AuditResult, type AuditRule, type AuditSeverity, type BatchInstallOptions, type BatchInstallResult, type CaampLockFile, type ConfigFormat, type ConflictPolicy, type CtDispatchMatrix, type CtManifest, type CtManifestSkill, type CtProfileDefinition, type CtSkillEntry, type CtValidationIssue, type CtValidationResult, type DetectionCacheOptions, type DetectionResult, type DualScopeConfigureOptions, type DualScopeConfigureResult, type GlobalOptions, type InjectionCheckResult, type InjectionStatus, type InjectionTemplate, type InstallResult, type InstructionUpdateSummary, type LockEntry, MarketplaceClient, type MarketplaceResult, type MarketplaceSearchResult, type MarketplaceSkill, type McpBatchOperation, type McpConflict, type McpConflictCode, type McpPlanApplyResult, type McpServerConfig, type McpServerEntry, type NormalizedRecommendationCriteria, type ParsedSource, type Provider, type ProviderPriority, type ProviderStatus, RECOMMENDATION_ERROR_CODES, type RankedSkillRecommendation, type RecommendSkillsResult, type RecommendationCriteriaInput, type RecommendationErrorCode, type RecommendationOptions, type RecommendationReason, type RecommendationReasonCode, type RecommendationScoreBreakdown, type RecommendationValidationIssue, type RecommendationValidationResult, type RecommendationWeights, type SkillBatchOperation, type SkillEntry, type SkillInstallResult, type SkillLibrary, type SkillLibraryDispatchMatrix, type SkillLibraryEntry, type SkillLibraryManifest, type SkillLibraryManifestSkill, type SkillLibraryProfile, type SkillLibraryValidationIssue, type SkillLibraryValidationResult, type SkillMetadata, type SourceType, type TransportType, type ValidationIssue, type ValidationResult, applyMcpInstallWithPolicy, buildInjectionContent, buildLibraryFromFiles, buildServerConfig, catalog, checkAllInjections, checkInjection, checkSkillUpdate, clearRegisteredLibrary, configureProviderGlobalAndProject, deepMerge, detectAllProviders, detectMcpConfigConflicts, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureDir, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllProviders, getCanonicalSkillsDir, getInstalledProviders, getInstructionFiles, getLastSelectedAgents, getLockFilePath, getNestedValue, getPlatformLocations, getProjectAgentsDir, getProvider, getProviderCount, getProvidersByInstructFile, getProvidersByPriority, getProvidersByStatus, getRegistryVersion, getTrackedMcpServers, getTrackedSkills, getTransform, groupByInstructFile, inject, injectAll, installBatchWithRollback, installMcpServer, installMcpServerToAll, installSkill, isMarketplaceScoped, isQuiet, isVerbose, listAgentsMcpServers, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeRecommendationCriteria, parseInjectionContent, parseSkillFile, parseSource, rankSkills, readConfig, readLockFile, recommendSkills, recordMcpInstall, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpFromLock, removeMcpServer, removeSkill, removeSkillFromLock, resetDetectionCache, resolveAlias, resolveConfigPath, resolveRegistryTemplatePath, saveLastSelectedAgents, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setQuiet, setVerbose, toSarif, tokenizeCriteriaValue, updateInstructionsSingleOperation, validateRecommendationCriteria, validateSkill, writeConfig };
+export { type AuditFinding, type AuditResult, type AuditRule, type AuditSeverity, type BatchInstallOptions, type BatchInstallResult, type CaampLockFile, type CleoChannel, type CleoProfileBuildResult, type ConfigFormat, type ConflictPolicy, type CtDispatchMatrix, type CtManifest, type CtManifestSkill, type CtProfileDefinition, type CtSkillEntry, type CtValidationIssue, type CtValidationResult, type DetectionCacheOptions, type DetectionResult, type DualScopeConfigureOptions, type DualScopeConfigureResult, type GlobalOptions, type InjectionCheckResult, type InjectionStatus, type InjectionTemplate, type InstallResult, type InstructionUpdateSummary, type LockEntry, MarketplaceClient, type MarketplaceResult, type MarketplaceSearchResult, type MarketplaceSkill, type McpBatchOperation, type McpConflict, type McpConflictCode, type McpPlanApplyResult, type McpServerConfig, type McpServerEntry, type NormalizedRecommendationCriteria, type ParsedSource, type Provider, type ProviderPriority, type ProviderStatus, RECOMMENDATION_ERROR_CODES, type RankedSkillRecommendation, type RecommendSkillsResult, type RecommendationCriteriaInput, type RecommendationErrorCode, type RecommendationOptions, type RecommendationReason, type RecommendationReasonCode, type RecommendationScoreBreakdown, type RecommendationValidationIssue, type RecommendationValidationResult, type RecommendationWeights, type SkillBatchOperation, type SkillEntry, type SkillInstallResult, type SkillLibrary, type SkillLibraryDispatchMatrix, type SkillLibraryEntry, type SkillLibraryManifest, type SkillLibraryManifestSkill, type SkillLibraryProfile, type SkillLibraryValidationIssue, type SkillLibraryValidationResult, type SkillMetadata, type SourceType, type TransportType, type ValidationIssue, type ValidationResult, applyMcpInstallWithPolicy, buildCleoProfile, buildInjectionContent, buildLibraryFromFiles, buildServerConfig, catalog, checkAllInjections, checkAllSkillUpdates, checkCommandReachability, checkInjection, checkSkillUpdate, clearRegisteredLibrary, configureProviderGlobalAndProject, deepMerge, detectAllProviders, detectMcpConfigConflicts, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureDir, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllProviders, getCanonicalSkillsDir, getInstalledProviders, getInstructionFiles, getLastSelectedAgents, getLockFilePath, getNestedValue, getPlatformLocations, getProjectAgentsDir, getProvider, getProviderCount, getProvidersByInstructFile, getProvidersByPriority, getProvidersByStatus, getRegistryVersion, getTrackedMcpServers, getTrackedSkills, getTransform, groupByInstructFile, inject, injectAll, installBatchWithRollback, installMcpServer, installMcpServerToAll, installSkill, isCleoSource, isMarketplaceScoped, isQuiet, isVerbose, listAgentsMcpServers, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeCleoChannel, normalizeRecommendationCriteria, parseEnvAssignments, parseInjectionContent, parseSkillFile, parseSource, rankSkills, readConfig, readLockFile, recommendSkills, recordMcpInstall, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpFromLock, removeMcpServer, removeSkill, removeSkillFromLock, resetDetectionCache, resolveAlias, resolveChannelFromServerName, resolveCleoServerName, resolveConfigPath, resolveRegistryTemplatePath, saveLastSelectedAgents, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setQuiet, setVerbose, toSarif, tokenizeCriteriaValue, updateInstructionsSingleOperation, validateRecommendationCriteria, validateSkill, writeConfig };

package/dist/index.js

@@ -2,11 +2,14 @@ import {
   MarketplaceClient,
   RECOMMENDATION_ERROR_CODES,
   applyMcpInstallWithPolicy,
+  buildCleoProfile,
   buildInjectionContent,
   buildLibraryFromFiles,
   buildServerConfig,
   catalog_exports,
   checkAllInjections,
+  checkAllSkillUpdates,
+  checkCommandReachability,
   checkInjection,
   checkSkillUpdate,
   clearRegisteredLibrary,
@@ -55,6 +58,7 @@ import {
   installMcpServer,
   installMcpServerToAll,
   installSkill,
+  isCleoSource,
   isMarketplaceScoped,
   isQuiet,
   isVerbose,
@@ -63,7 +67,9 @@ import {
   listCanonicalSkills,
   listMcpServers,
   loadLibraryFromModule,
+  normalizeCleoChannel,
   normalizeRecommendationCriteria,
+  parseEnvAssignments,
   parseInjectionContent,
   parseSkillFile,
   parseSource,
@@ -83,6 +89,8 @@ import {
   removeSkillFromLock,
   resetDetectionCache,
   resolveAlias,
+  resolveChannelFromServerName,
+  resolveCleoServerName,
   resolveConfigPath,
   resolveRegistryTemplatePath,
   saveLastSelectedAgents,
@@ -99,16 +107,19 @@ import {
   validateRecommendationCriteria,
   validateSkill,
   writeConfig
-} from "./chunk-7YV3KXEJ.js";
+} from "./chunk-O2YG5HT7.js";
 export {
   MarketplaceClient,
   RECOMMENDATION_ERROR_CODES,
   applyMcpInstallWithPolicy,
+  buildCleoProfile,
   buildInjectionContent,
   buildLibraryFromFiles,
   buildServerConfig,
   catalog_exports as catalog,
   checkAllInjections,
+  checkAllSkillUpdates,
+  checkCommandReachability,
   checkInjection,
   checkSkillUpdate,
   clearRegisteredLibrary,
@@ -157,6 +168,7 @@ export {
   installMcpServer,
   installMcpServerToAll,
   installSkill,
+  isCleoSource,
   isMarketplaceScoped,
   isQuiet,
   isVerbose,
@@ -165,7 +177,9 @@ export {
   listCanonicalSkills,
   listMcpServers,
   loadLibraryFromModule,
+  normalizeCleoChannel,
   normalizeRecommendationCriteria,
+  parseEnvAssignments,
   parseInjectionContent,
   parseSkillFile,
   parseSource,
@@ -185,6 +199,8 @@ export {
   removeSkillFromLock,
   resetDetectionCache,
   resolveAlias,
+  resolveChannelFromServerName,
+  resolveCleoServerName,
   resolveConfigPath,
   resolveRegistryTemplatePath,
   saveLastSelectedAgents,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/caamp",
-  "version": "1.1.3",
+  "version": "1.3.0",
   "description": "Central AI Agent Managed Packages - unified provider registry and package manager for AI coding agents",
   "type": "module",
   "bin": {