@cleocode/caamp 1.5.1 → 1.6.0

package/dist/index.d.ts

@@ -1,3 +1,7 @@
+type SkillsPrecedence = "vendor-only" | "agents-canonical" | "agents-first" | "agents-supported" | "vendor-global-agents-project";
+type HookEvent = "onSessionStart" | "onSessionEnd" | "onToolStart" | "onToolComplete" | "onFileChange" | "onError" | "onPromptSubmit" | "onResponseComplete";
+type SpawnMechanism = "native" | "mcp" | "cli" | "api";
+
 /**
  * SkillLibrary interface - SDK standard contract for skill libraries.
  *
@@ -186,11 +190,6 @@ interface SkillLibrary {
     getDispatchMatrix(): SkillLibraryDispatchMatrix;
 }
 
-/**
- * CAAMP - Central AI Agent Managed Packages
- * Core type definitions
- */
-
 /** @deprecated Use `SkillLibraryEntry` instead. */
 type CtSkillEntry = SkillLibraryEntry;
 /** @deprecated Use `SkillLibraryValidationResult` instead. */
@@ -265,6 +264,43 @@ interface DetectionConfig {
     /** Flatpak application ID (for `"flatpak"` method). */
     flatpakId?: string;
 }
+
+interface ProviderSkillsCapability {
+    /** Resolved global `.agents/skills` path, or `null` if unsupported. */
+    agentsGlobalPath: string | null;
+    /** Project-relative `.agents/skills` path, or `null` if unsupported. */
+    agentsProjectPath: string | null;
+    /** How this provider resolves skill file precedence. */
+    precedence: SkillsPrecedence;
+}
+interface ProviderHooksCapability {
+    /** Hook lifecycle events this provider supports. */
+    supported: HookEvent[];
+    /** Resolved path to hook configuration file, or `null`. */
+    hookConfigPath: string | null;
+    /** Format of the hook config file. */
+    hookFormat: "json" | "yaml" | "toml" | "javascript" | null;
+}
+interface ProviderSpawnCapability {
+    /** Whether the provider supports spawning subagents. */
+    supportsSubagents: boolean;
+    /** Whether subagents can be spawned programmatically. */
+    supportsProgrammaticSpawn: boolean;
+    /** Whether spawned agents can communicate with each other. */
+    supportsInterAgentComms: boolean;
+    /** Whether multiple agents can be spawned in parallel. */
+    supportsParallelSpawn: boolean;
+    /** Mechanism used for spawning. */
+    spawnMechanism: SpawnMechanism | null;
+}
+interface ProviderCapabilities {
+    /** Skills path resolution and precedence. */
+    skills: ProviderSkillsCapability;
+    /** Hook/lifecycle event support. */
+    hooks: ProviderHooksCapability;
+    /** Subagent spawn capabilities. */
+    spawn: ProviderSpawnCapability;
+}
 /**
  * Priority tier for a provider, used for sorting and default selection.
  *
@@ -337,6 +373,8 @@ interface Provider {
     status: ProviderStatus;
     /** Whether the provider is compatible with the Agent Skills standard. */
     agentSkillsCompatible: boolean;
+    /** Provider capabilities for skills, hooks, and spawn. Always populated at runtime. */
+    capabilities: ProviderCapabilities;
 }
 /**
  * Canonical MCP server configuration.
@@ -791,6 +829,56 @@ interface GlobalOptions {
     quiet?: boolean;
 }
 
+/**
+ * Spawn adapter interface for provider-neutral subagent orchestration.
+ *
+ * This is an interface-only module — no concrete implementations yet.
+ * CLEO will consume this interface to build provider-specific adapters.
+ */
+
+/**
+ * Options for spawning a subagent.
+ */
+interface SpawnOptions {
+    /** The prompt or instruction to give the spawned agent. */
+    prompt: string;
+    /** Model to use for the spawned agent. */
+    model?: string;
+    /** Tools to make available to the spawned agent. */
+    tools?: string[];
+    /** Timeout in milliseconds for the spawned agent. */
+    timeout?: number;
+    /** Whether to isolate the spawned agent (e.g. in a worktree). */
+    isolate?: boolean;
+}
+/**
+ * Result from a spawn operation.
+ */
+interface SpawnResult {
+    /** Unique identifier for the spawned agent instance. */
+    instanceId: string;
+    /** Current status of the spawned agent. */
+    status: "running" | "completed" | "failed";
+    /** Output produced by the spawned agent. */
+    output?: string;
+}
+/**
+ * Provider-neutral interface for spawning and managing subagents.
+ *
+ * Concrete implementations will be provider-specific (e.g. ClaudeCodeSpawnAdapter,
+ * CodexSpawnAdapter) and registered by CLEO's orchestration layer.
+ */
+interface SpawnAdapter {
+    /** Check if a provider supports spawning via this adapter. */
+    canSpawn(provider: Provider): boolean;
+    /** Spawn a new subagent for the given provider. */
+    spawn(provider: Provider, options: SpawnOptions): Promise<SpawnResult>;
+    /** List currently running subagent instances. */
+    listRunning(provider: Provider): Promise<SpawnResult[]>;
+    /** Terminate a running subagent instance. */
+    terminate(provider: Provider, instanceId: string): Promise<void>;
+}
+
 /**
  * Provider auto-detection engine
  *
@@ -1411,6 +1499,84 @@ interface DualScopeConfigureResult {
  */
 declare function configureProviderGlobalAndProject(provider: Provider, options: DualScopeConfigureOptions): Promise<DualScopeConfigureResult>;
 
+type PathScope = "project" | "global";
+interface PlatformLocations {
+    home: string;
+    config: string;
+    vscodeConfig: string;
+    zedConfig: string;
+    claudeDesktopConfig: string;
+    applications: string[];
+}
+declare function getPlatformLocations(): PlatformLocations;
+declare function getAgentsHome(): string;
+declare function getProjectAgentsDir(projectRoot?: string): string;
+declare function getCanonicalSkillsDir(): string;
+declare function getLockFilePath(): string;
+/**
+ * Get the MCP directory within `.agents/`.
+ *
+ * @param scope - `"global"` for `~/.agents/mcp/`, `"project"` for `<project>/.agents/mcp/`
+ * @param projectDir - Project root (defaults to `process.cwd()`)
+ */
+declare function getAgentsMcpDir(scope?: PathScope, projectDir?: string): string;
+/**
+ * Get the MCP servers.json path within `.agents/`.
+ *
+ * Per the `.agents/` standard (Section 9), this is the canonical MCP
+ * server registry that should be checked before legacy per-provider configs.
+ *
+ * @param scope - `"global"` for `~/.agents/mcp/servers.json`, `"project"` for `<project>/.agents/mcp/servers.json`
+ * @param projectDir - Project root (defaults to `process.cwd()`)
+ */
+declare function getAgentsMcpServersPath(scope?: PathScope, projectDir?: string): string;
+/**
+ * Get the primary AGENTS.md instruction file path within `.agents/`.
+ *
+ * @param scope - `"global"` for `~/.agents/AGENTS.md`, `"project"` for `<project>/.agents/AGENTS.md`
+ * @param projectDir - Project root (defaults to `process.cwd()`)
+ */
+declare function getAgentsInstructFile(scope?: PathScope, projectDir?: string): string;
+/**
+ * Get the config.toml path within `.agents/`.
+ *
+ * @param scope - `"global"` for `~/.agents/config.toml`, `"project"` for `<project>/.agents/config.toml`
+ * @param projectDir - Project root (defaults to `process.cwd()`)
+ */
+declare function getAgentsConfigPath(scope?: PathScope, projectDir?: string): string;
+/**
+ * Get the wiki directory within `.agents/`.
+ *
+ * @param scope - `"global"` or `"project"`
+ * @param projectDir - Project root (defaults to `process.cwd()`)
+ */
+declare function getAgentsWikiDir(scope?: PathScope, projectDir?: string): string;
+/**
+ * Get the spec directory within `.agents/`.
+ *
+ * @param scope - `"global"` or `"project"`
+ * @param projectDir - Project root (defaults to `process.cwd()`)
+ */
+declare function getAgentsSpecDir(scope?: PathScope, projectDir?: string): string;
+/**
+ * Get the links directory within `.agents/`.
+ *
+ * @param scope - `"global"` or `"project"`
+ * @param projectDir - Project root (defaults to `process.cwd()`)
+ */
+declare function getAgentsLinksDir(scope?: PathScope, projectDir?: string): string;
+declare function resolveRegistryTemplatePath(template: string): string;
+/**
+ * Get ALL target directories for skill installation based on the provider's
+ * skills precedence setting.
+ *
+ * @param provider - Provider to resolve paths for
+ * @param scope - Whether to resolve global or project paths
+ * @param projectDir - Project directory for project-scope resolution
+ * @returns Array of target directories for symlink creation
+ */
+declare function resolveProviderSkillsDirs(provider: Provider, scope: PathScope, projectDir?: string): string[];
+
 /**
  * Provider registry loader
  *
@@ -1534,74 +1700,129 @@ declare function getProviderCount(): number;
  * ```
  */
 declare function getRegistryVersion(): string;
-
-type PathScope = "project" | "global";
-interface PlatformLocations {
-    home: string;
-    config: string;
-    vscodeConfig: string;
-    zedConfig: string;
-    claudeDesktopConfig: string;
-    applications: string[];
-}
-declare function getPlatformLocations(): PlatformLocations;
-declare function getAgentsHome(): string;
-declare function getProjectAgentsDir(projectRoot?: string): string;
-declare function getCanonicalSkillsDir(): string;
-declare function getLockFilePath(): string;
 /**
- * Get the MCP directory within `.agents/`.
+ * Filter providers that support a specific hook event.
  *
- * @param scope - `"global"` for `~/.agents/mcp/`, `"project"` for `<project>/.agents/mcp/`
- * @param projectDir - Project root (defaults to `process.cwd()`)
+ * @param event - Hook event to filter by (e.g. `"onToolComplete"`)
+ * @returns Array of providers whose hooks capability includes the given event
+ *
+ * @example
+ * ```typescript
+ * const providers = getProvidersByHookEvent("onToolComplete");
+ * ```
  */
-declare function getAgentsMcpDir(scope?: PathScope, projectDir?: string): string;
+declare function getProvidersByHookEvent(event: HookEvent): Provider[];
 /**
- * Get the MCP servers.json path within `.agents/`.
+ * Get hook events common to all specified providers.
  *
- * Per the `.agents/` standard (Section 9), this is the canonical MCP
- * server registry that should be checked before legacy per-provider configs.
+ * If providerIds is provided, returns the intersection of their supported events.
+ * If providerIds is undefined or empty, uses all providers.
  *
- * @param scope - `"global"` for `~/.agents/mcp/servers.json`, `"project"` for `<project>/.agents/mcp/servers.json`
- * @param projectDir - Project root (defaults to `process.cwd()`)
+ * @param providerIds - Optional array of provider IDs to intersect
+ * @returns Array of hook events supported by ALL specified providers
+ *
+ * @example
+ * ```typescript
+ * const common = getCommonHookEvents(["claude-code", "gemini-cli"]);
+ * ```
  */
-declare function getAgentsMcpServersPath(scope?: PathScope, projectDir?: string): string;
+declare function getCommonHookEvents(providerIds?: string[]): HookEvent[];
 /**
- * Get the primary AGENTS.md instruction file path within `.agents/`.
+ * Check whether a provider supports a specific capability via dot-path query.
  *
- * @param scope - `"global"` for `~/.agents/AGENTS.md`, `"project"` for `<project>/.agents/AGENTS.md`
- * @param projectDir - Project root (defaults to `process.cwd()`)
+ * The dot-path addresses a value inside `provider.capabilities`. For boolean
+ * fields the provider "supports" the capability when the value is `true`.
+ * For non-boolean fields the provider "supports" it when the value is neither
+ * `null` nor `undefined` (and, for arrays, non-empty).
+ *
+ * @param provider - Provider to inspect
+ * @param dotPath  - Dot-delimited capability path (e.g. `"spawn.supportsSubagents"`, `"hooks.supported"`)
+ * @returns `true` when the provider has the specified capability
+ *
+ * @example
+ * ```typescript
+ * const claude = getProvider("claude-code");
+ * providerSupports(claude!, "spawn.supportsSubagents"); // true
+ * ```
  */
-declare function getAgentsInstructFile(scope?: PathScope, projectDir?: string): string;
+declare function providerSupports(provider: Provider, dotPath: string): boolean;
 /**
- * Get the config.toml path within `.agents/`.
+ * Filter providers that support spawning subagents.
  *
- * @param scope - `"global"` for `~/.agents/config.toml`, `"project"` for `<project>/.agents/config.toml`
- * @param projectDir - Project root (defaults to `process.cwd()`)
+ * @returns Array of providers where `capabilities.spawn.supportsSubagents === true`
+ *
+ * @example
+ * ```typescript
+ * const spawnCapable = getSpawnCapableProviders();
+ * ```
  */
-declare function getAgentsConfigPath(scope?: PathScope, projectDir?: string): string;
+declare function getSpawnCapableProviders(): Provider[];
 /**
- * Get the wiki directory within `.agents/`.
+ * Filter providers by a specific boolean spawn capability flag.
  *
- * @param scope - `"global"` or `"project"`
- * @param projectDir - Project root (defaults to `process.cwd()`)
+ * @param flag - One of the four boolean flags on {@link ProviderSpawnCapability}
+ *              (`"supportsSubagents"`, `"supportsProgrammaticSpawn"`,
+ *               `"supportsInterAgentComms"`, `"supportsParallelSpawn"`)
+ * @returns Array of providers where the specified flag is `true`
+ *
+ * @example
+ * ```typescript
+ * const parallel = getProvidersBySpawnCapability("supportsParallelSpawn");
+ * ```
  */
-declare function getAgentsWikiDir(scope?: PathScope, projectDir?: string): string;
+declare function getProvidersBySpawnCapability(flag: keyof Omit<ProviderSpawnCapability, "spawnMechanism">): Provider[];
 /**
- * Get the spec directory within `.agents/`.
+ * Filter providers by their skills precedence value.
  *
- * @param scope - `"global"` or `"project"`
- * @param projectDir - Project root (defaults to `process.cwd()`)
+ * @param precedence - Skills precedence to filter by
+ * @returns Array of providers matching the given precedence
  */
-declare function getAgentsSpecDir(scope?: PathScope, projectDir?: string): string;
+declare function getProvidersBySkillsPrecedence(precedence: SkillsPrecedence): Provider[];
 /**
- * Get the links directory within `.agents/`.
+ * Get the effective skills paths for a provider, ordered by precedence.
  *
- * @param scope - `"global"` or `"project"`
- * @param projectDir - Project root (defaults to `process.cwd()`)
+ * @param provider - Provider to resolve paths for
+ * @param scope - Whether to resolve global or project paths
+ * @param projectDir - Project directory for project-scope resolution
+ * @returns Ordered array of paths with source and scope metadata
  */
-declare function getAgentsLinksDir(scope?: PathScope, projectDir?: string): string;
-declare function resolveRegistryTemplatePath(template: string): string;
+declare function getEffectiveSkillsPaths(provider: Provider, scope: PathScope, projectDir?: string): Array<{
+    path: string;
+    source: string;
+    scope: string;
+}>;
+/**
+ * Build a full skills map for all providers.
+ *
+ * @returns Array of skills map entries with provider ID, tool name, precedence, and paths
+ */
+declare function buildSkillsMap(): Array<{
+    providerId: string;
+    toolName: string;
+    precedence: SkillsPrecedence;
+    paths: {
+        global: string | null;
+        project: string | null;
+    };
+}>;
+/**
+ * Get capabilities for a provider by ID or alias.
+ *
+ * @param idOrAlias - Provider ID or alias
+ * @returns The provider's capabilities, or undefined if not found
+ */
+declare function getProviderCapabilities(idOrAlias: string): ProviderCapabilities | undefined;
+/**
+ * Check if a provider supports a capability using ID/alias lookup.
+ *
+ * Convenience wrapper that resolves the provider first, then delegates
+ * to the provider-level {@link providerSupports}.
+ *
+ * @param idOrAlias - Provider ID or alias
+ * @param capabilityPath - Dot-path into capabilities (e.g. "spawn.supportsSubagents")
+ * @returns true if the provider supports the capability, false otherwise
+ */
+declare function providerSupportsById(idOrAlias: string, capabilityPath: string): boolean;
 
 /**
  * Source URL/path classifier
@@ -2767,4 +2988,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 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 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 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 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, extractVersionTag, 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, inferCleoLockData, 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, reconcileCleoLock, 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 };
+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 };

package/dist/index.js

@@ -6,6 +6,7 @@ import {
   buildInjectionContent,
   buildLibraryFromFiles,
   buildServerConfig,
+  buildSkillsMap,
   catalog_exports,
   checkAllInjections,
   checkAllSkillUpdates,
@@ -36,6 +37,8 @@ import {
   getAgentsWikiDir,
   getAllProviders,
   getCanonicalSkillsDir,
+  getCommonHookEvents,
+  getEffectiveSkillsPaths,
   getInstalledProviders,
   getInstructionFiles,
   getLastSelectedAgents,
@@ -44,11 +47,16 @@ import {
   getPlatformLocations,
   getProjectAgentsDir,
   getProvider,
+  getProviderCapabilities,
   getProviderCount,
+  getProvidersByHookEvent,
   getProvidersByInstructFile,
   getProvidersByPriority,
+  getProvidersBySkillsPrecedence,
+  getProvidersBySpawnCapability,
   getProvidersByStatus,
   getRegistryVersion,
+  getSpawnCapableProviders,
   getTrackedMcpServers,
   getTrackedSkills,
   getTransform,
@@ -75,6 +83,8 @@ import {
   parseInjectionContent,
   parseSkillFile,
   parseSource,
+  providerSupports,
+  providerSupportsById,
   rankSkills,
   readConfig,
   readLockFile,
@@ -95,6 +105,7 @@ import {
   resolveChannelFromServerName,
   resolveCleoServerName,
   resolveConfigPath,
+  resolveProviderSkillsDirs,
   resolveRegistryTemplatePath,
   saveLastSelectedAgents,
   scanDirectory,
@@ -110,7 +121,7 @@ import {
   validateRecommendationCriteria,
   validateSkill,
   writeConfig
-} from "./chunk-ZEXRZTQX.js";
+} from "./chunk-N5E7BZM2.js";
 export {
   MarketplaceClient,
   RECOMMENDATION_ERROR_CODES,
@@ -119,6 +130,7 @@ export {
   buildInjectionContent,
   buildLibraryFromFiles,
   buildServerConfig,
+  buildSkillsMap,
   catalog_exports as catalog,
   checkAllInjections,
   checkAllSkillUpdates,
@@ -149,6 +161,8 @@ export {
   getAgentsWikiDir,
   getAllProviders,
   getCanonicalSkillsDir,
+  getCommonHookEvents,
+  getEffectiveSkillsPaths,
   getInstalledProviders,
   getInstructionFiles,
   getLastSelectedAgents,
@@ -157,11 +171,16 @@ export {
   getPlatformLocations,
   getProjectAgentsDir,
   getProvider,
+  getProviderCapabilities,
   getProviderCount,
+  getProvidersByHookEvent,
   getProvidersByInstructFile,
   getProvidersByPriority,
+  getProvidersBySkillsPrecedence,
+  getProvidersBySpawnCapability,
   getProvidersByStatus,
   getRegistryVersion,
+  getSpawnCapableProviders,
   getTrackedMcpServers,
   getTrackedSkills,
   getTransform,
@@ -188,6 +207,8 @@ export {
   parseInjectionContent,
   parseSkillFile,
   parseSource,
+  providerSupports,
+  providerSupportsById,
   rankSkills,
   readConfig,
   readLockFile,
@@ -208,6 +229,7 @@ export {
   resolveChannelFromServerName,
   resolveCleoServerName,
   resolveConfigPath,
+  resolveProviderSkillsDirs,
   resolveRegistryTemplatePath,
   saveLastSelectedAgents,
   scanDirectory,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/caamp",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "description": "Central AI Agent Managed Packages - unified provider registry and package manager for AI coding agents",
   "type": "module",
   "bin": {
@@ -31,6 +31,7 @@
     "lint:fix": "biome lint --write src tests",
     "docs:api": "typedoc",
     "docs:api:check": "typedoc --emit none",
+    "research": "tsx scripts/provider-research.ts",
     "prepublishOnly": "npm run build"
   },
   "keywords": [