@cleocode/caamp 1.6.0 → 1.7.0

package/dist/cli.js

@@ -78,7 +78,7 @@ import {
   tokenizeCriteriaValue,
   updateInstructionsSingleOperation,
   validateSkill
-} from "./chunk-N5E7BZM2.js";
+} from "./chunk-M6KHYT2D.js";
 
 // src/cli.ts
 import { Command } from "commander";

package/dist/index.d.ts

@@ -1824,6 +1824,61 @@ declare function getProviderCapabilities(idOrAlias: string): ProviderCapabilitie
  */
 declare function providerSupportsById(idOrAlias: string, capabilityPath: string): boolean;
 
+/**
+ * Central OS platform path resolution using env-paths.
+ *
+ * Provides OS-appropriate paths for CAAMP's global directories using
+ * XDG conventions on Linux, standard conventions on macOS/Windows.
+ * Results are cached for the process lifetime. Env vars take precedence.
+ *
+ * Platform path defaults:
+ *   data:   ~/.local/share/agents  | ~/Library/Application Support/agents | %LOCALAPPDATA%\agents\Data
+ *   config: ~/.config/agents       | ~/Library/Preferences/agents          | %APPDATA%\agents\Config
+ *   cache:  ~/.cache/agents        | ~/Library/Caches/agents               | %LOCALAPPDATA%\agents\Cache
+ *   log:    ~/.local/state/agents  | ~/Library/Logs/agents                 | %LOCALAPPDATA%\agents\Log
+ *   temp:   /tmp/<user>/agents     | /var/folders/.../agents               | %TEMP%\agents
+ *
+ * AGENTS_HOME env var overrides the data path for backward compatibility
+ * with existing ~/.agents installations.
+ */
+interface PlatformPaths {
+    /** User data dir. Override with AGENTS_HOME env var. */
+    data: string;
+    /** OS config dir (XDG_CONFIG_HOME / Library/Preferences / %APPDATA%). */
+    config: string;
+    /** OS cache dir. */
+    cache: string;
+    /** OS log dir. */
+    log: string;
+    /** OS temp dir. */
+    temp: string;
+}
+interface SystemInfo {
+    platform: NodeJS.Platform;
+    arch: string;
+    release: string;
+    hostname: string;
+    nodeVersion: string;
+    paths: PlatformPaths;
+}
+/**
+ * Get OS-appropriate paths for CAAMP's global directories.
+ * Cached after first call. AGENTS_HOME env var overrides the data path.
+ * Cache auto-invalidates when AGENTS_HOME changes (supports test isolation).
+ */
+declare function getPlatformPaths(): PlatformPaths;
+/**
+ * Get a cached system information snapshot.
+ * Captured once and reused for the process lifetime.
+ */
+declare function getSystemInfo(): SystemInfo;
+/**
+ * Invalidate the path and system info caches.
+ * Use in tests after mutating AGENTS_HOME env var.
+ * @internal
+ */
+declare function _resetPlatformPathsCache(): void;
+
 /**
  * Source URL/path classifier
  *
@@ -2988,4 +3043,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 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 HookEvent, type InferredLockData, 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 ProviderCapabilities, type ProviderHooksCapability, type ProviderPriority, type ProviderSkillsCapability, type ProviderSpawnCapability, 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 ReconcileOptions, type ReconcileResult, 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 SkillsPrecedence, type SourceType, type SpawnAdapter, type SpawnMechanism, type SpawnOptions, type SpawnResult, type TransportType, type ValidationIssue, type ValidationResult, applyMcpInstallWithPolicy, buildCleoProfile, buildInjectionContent, buildLibraryFromFiles, buildServerConfig, buildSkillsMap, catalog, checkAllInjections, checkAllSkillUpdates, checkCommandReachability, checkInjection, checkSkillUpdate, clearRegisteredLibrary, configureProviderGlobalAndProject, deepMerge, detectAllProviders, detectMcpConfigConflicts, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureDir, extractVersionTag, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllProviders, getCanonicalSkillsDir, getCommonHookEvents, getEffectiveSkillsPaths, getInstalledProviders, getInstructionFiles, getLastSelectedAgents, getLockFilePath, getNestedValue, getPlatformLocations, getProjectAgentsDir, getProvider, getProviderCapabilities, getProviderCount, getProvidersByHookEvent, getProvidersByInstructFile, getProvidersByPriority, getProvidersBySkillsPrecedence, getProvidersBySpawnCapability, getProvidersByStatus, getRegistryVersion, getSpawnCapableProviders, getTrackedMcpServers, getTrackedSkills, getTransform, groupByInstructFile, inferCleoLockData, inject, injectAll, installBatchWithRollback, installMcpServer, installMcpServerToAll, installSkill, isCleoSource, isMarketplaceScoped, isQuiet, isVerbose, listAgentsMcpServers, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeCleoChannel, normalizeRecommendationCriteria, parseEnvAssignments, parseInjectionContent, parseSkillFile, parseSource, providerSupports, providerSupportsById, rankSkills, readConfig, readLockFile, recommendSkills, reconcileCleoLock, recordMcpInstall, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpFromLock, removeMcpServer, removeSkill, removeSkillFromLock, resetDetectionCache, resolveAlias, resolveChannelFromServerName, resolveCleoServerName, resolveConfigPath, resolveProviderSkillsDirs, 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 HookEvent, type InferredLockData, 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 PlatformPaths, type Provider, type ProviderCapabilities, type ProviderHooksCapability, type ProviderPriority, type ProviderSkillsCapability, type ProviderSpawnCapability, 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 ReconcileOptions, type ReconcileResult, 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 SkillsPrecedence, type SourceType, type SpawnAdapter, type SpawnMechanism, type SpawnOptions, type SpawnResult, type SystemInfo, type TransportType, type ValidationIssue, type ValidationResult, _resetPlatformPathsCache, applyMcpInstallWithPolicy, buildCleoProfile, buildInjectionContent, buildLibraryFromFiles, buildServerConfig, buildSkillsMap, catalog, checkAllInjections, checkAllSkillUpdates, checkCommandReachability, checkInjection, checkSkillUpdate, clearRegisteredLibrary, configureProviderGlobalAndProject, deepMerge, detectAllProviders, detectMcpConfigConflicts, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureDir, extractVersionTag, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllProviders, getCanonicalSkillsDir, getCommonHookEvents, getEffectiveSkillsPaths, getInstalledProviders, getInstructionFiles, getLastSelectedAgents, getLockFilePath, getNestedValue, getPlatformLocations, getPlatformPaths, getProjectAgentsDir, getProvider, getProviderCapabilities, getProviderCount, getProvidersByHookEvent, getProvidersByInstructFile, getProvidersByPriority, getProvidersBySkillsPrecedence, getProvidersBySpawnCapability, getProvidersByStatus, getRegistryVersion, getSpawnCapableProviders, getSystemInfo, getTrackedMcpServers, getTrackedSkills, getTransform, groupByInstructFile, inferCleoLockData, inject, injectAll, installBatchWithRollback, installMcpServer, installMcpServerToAll, installSkill, isCleoSource, isMarketplaceScoped, isQuiet, isVerbose, listAgentsMcpServers, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeCleoChannel, normalizeRecommendationCriteria, parseEnvAssignments, parseInjectionContent, parseSkillFile, parseSource, providerSupports, providerSupportsById, rankSkills, readConfig, readLockFile, recommendSkills, reconcileCleoLock, recordMcpInstall, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpFromLock, removeMcpServer, removeSkill, removeSkillFromLock, resetDetectionCache, resolveAlias, resolveChannelFromServerName, resolveCleoServerName, resolveConfigPath, resolveProviderSkillsDirs, resolveRegistryTemplatePath, saveLastSelectedAgents, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setQuiet, setVerbose, toSarif, tokenizeCriteriaValue, updateInstructionsSingleOperation, validateRecommendationCriteria, validateSkill, writeConfig };

package/dist/index.js

@@ -1,6 +1,7 @@
 import {
   MarketplaceClient,
   RECOMMENDATION_ERROR_CODES,
+  _resetPlatformPathsCache,
   applyMcpInstallWithPolicy,
   buildCleoProfile,
   buildInjectionContent,
@@ -45,6 +46,7 @@ import {
   getLockFilePath,
   getNestedValue,
   getPlatformLocations,
+  getPlatformPaths,
   getProjectAgentsDir,
   getProvider,
   getProviderCapabilities,
@@ -57,6 +59,7 @@ import {
   getProvidersByStatus,
   getRegistryVersion,
   getSpawnCapableProviders,
+  getSystemInfo,
   getTrackedMcpServers,
   getTrackedSkills,
   getTransform,
@@ -121,10 +124,11 @@ import {
   validateRecommendationCriteria,
   validateSkill,
   writeConfig
-} from "./chunk-N5E7BZM2.js";
+} from "./chunk-M6KHYT2D.js";
 export {
   MarketplaceClient,
   RECOMMENDATION_ERROR_CODES,
+  _resetPlatformPathsCache,
   applyMcpInstallWithPolicy,
   buildCleoProfile,
   buildInjectionContent,
@@ -169,6 +173,7 @@ export {
   getLockFilePath,
   getNestedValue,
   getPlatformLocations,
+  getPlatformPaths,
   getProjectAgentsDir,
   getProvider,
   getProviderCapabilities,
@@ -181,6 +186,7 @@ export {
   getProvidersByStatus,
   getRegistryVersion,
   getSpawnCapableProviders,
+  getSystemInfo,
   getTrackedMcpServers,
   getTrackedSkills,
   getTransform,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/caamp",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Central AI Agent Managed Packages - unified provider registry and package manager for AI coding agents",
   "type": "module",
   "bin": {
@@ -60,6 +60,7 @@
     "@cleocode/lafs-protocol": "^1.4.1",
     "@iarna/toml": "^2.2.5",
     "commander": "^14.0.0",
+    "env-paths": "^4.0.0",
     "gray-matter": "^4.0.3",
     "js-yaml": "^4.1.0",
     "jsonc-parser": "^3.3.1",

package/providers/registry.json

@@ -132,6 +132,11 @@
           "agentsGlobalPath": "$HOME/.agents/skills",
           "agentsProjectPath": ".agents/skills"
         },
+        "hooks": {
+          "supported": ["onToolStart", "onToolComplete", "onSessionStart", "onSessionEnd"],
+          "hookConfigPath": null,
+          "hookFormat": "json"
+        },
         "spawn": {
           "supportsSubagents": true,
           "supportsProgrammaticSpawn": true,
@@ -172,6 +177,11 @@
           "agentsGlobalPath": "$HOME/.agents/skills",
           "agentsProjectPath": ".agents/skills"
         },
+        "hooks": {
+          "supported": ["onSessionStart", "onSessionEnd", "onToolStart", "onToolComplete", "onPromptSubmit", "onResponseComplete"],
+          "hookConfigPath": "$HOME/.gemini/settings.json",
+          "hookFormat": "json"
+        },
         "spawn": {
           "supportsSubagents": true,
           "supportsProgrammaticSpawn": true,
@@ -243,6 +253,11 @@
           "agentsGlobalPath": "$HOME/.agents/skills",
           "agentsProjectPath": ".agents/skills"
         },
+        "hooks": {
+          "supported": ["onToolStart", "onToolComplete", "onSessionStart", "onSessionEnd", "onPromptSubmit", "onResponseComplete"],
+          "hookConfigPath": null,
+          "hookFormat": "json"
+        },
         "spawn": {
           "supportsSubagents": true,
           "supportsProgrammaticSpawn": true,
@@ -301,7 +316,26 @@
       "supportsHeaders": true,
       "priority": "medium",
       "status": "active",
-      "agentSkillsCompatible": true
+      "agentSkillsCompatible": true,
+      "capabilities": {
+        "skills": {
+          "precedence": "vendor-only",
+          "agentsGlobalPath": null,
+          "agentsProjectPath": null
+        },
+        "hooks": {
+          "supported": ["onToolStart", "onToolComplete", "onPromptSubmit", "onResponseComplete"],
+          "hookConfigPath": null,
+          "hookFormat": "json"
+        },
+        "spawn": {
+          "supportsSubagents": false,
+          "supportsProgrammaticSpawn": false,
+          "supportsInterAgentComms": false,
+          "supportsParallelSpawn": false,
+          "spawnMechanism": null
+        }
+      }
     },
     "vscode": {
       "id": "vscode",