getPlatformPaths() | function | Get OS-appropriate paths for CAAMP’s global directories. |
getSystemInfo() | function | Get a cached system information snapshot. |
_resetPlatformPathsCache() | function | Invalidate the path and system info caches. Use in tests after mutating AGENT… |
getPlatformLocations() | function | Resolves platform-specific directory locations for the current OS. |
getAgentsHome() | function | Returns the global agents home directory path. |
getProjectAgentsDir() | function | Returns the project-local .agents directory path. |
resolveProjectPath() | function | Resolves a relative path against a project directory. |
getCanonicalSkillsDir() | function | Returns the canonical skills storage directory path. |
getLockFilePath() | function | Returns the path to the CAAMP lock file. |
getAgentsMcpDir() | function | Gets the MCP directory within the .agents/ standard structure. |
getAgentsMcpServersPath() | function | Gets the MCP servers.json path within the .agents/ standard structure. |
getAgentsInstructFile() | function | Gets the primary AGENTS.md instruction file path within .agents/. |
getAgentsConfigPath() | function | Gets the config.toml path within the .agents/ standard structure. |
getAgentsWikiDir() | function | Gets the wiki directory within the .agents/ standard structure. |
getAgentsSpecDir() | function | Gets the spec directory within the .agents/ standard structure. |
getAgentsLinksDir() | function | Gets the links directory within the .agents/ standard structure. |
resolveRegistryTemplatePath() | function | Resolves a registry template path by substituting platform variables. |
resolveProviderConfigPath() | function | Resolves the configuration file path for a provider at the given scope. |
resolvePreferredConfigScope() | function | Determines the preferred configuration scope for a provider. |
resolveProviderSkillsDir() | function | Resolves the skills directory path for a provider at the given scope. |
resolveProviderSkillsDirs() | function | Gets all target directories for skill installation based on provider precedence. |
resolveProviderProjectPath() | function | Resolves a provider’s project-level path against a project directory. |
resolveProvidersRegistryPath() | function | Locates the providers registry.json file by searching up from a start directory. |
normalizeSkillSubPath() | function | Normalizes a skill sub-path by cleaning separators and removing SKILL.md suffix. |
buildSkillSubPathCandidates() | function | Builds a list of candidate sub-paths for skill file resolution. |
getAllProviders() | function | Retrieve all registered providers with resolved platform paths. Providers ar… |
getProvider() | function | Look up a provider by its ID or any of its aliases. |
resolveAlias() | function | Resolve an alias to its canonical provider ID. If the input is already a can… |
getProvidersByPriority() | function | Filter providers by their priority tier. |
getPrimaryProvider() | function | Get the single primary harness provider, if any is registered. |
getProvidersByStatus() | function | Filter providers by their lifecycle status. |
getProvidersByInstructFile() | function | Filter providers that use a specific instruction file. Multiple providers of… |
getInstructionFiles() | function | Get the set of all unique instruction file names across all providers. |
getProviderCount() | function | Get the total number of registered providers. |
getRegistryVersion() | function | Get the semantic version string of the provider registry. |
getProvidersByHookEvent() | function | Filter providers that support a specific hook event. |
getCommonHookEvents() | function | Get hook events common to all specified providers. If providerIds is provide… |
providerSupports() | function | Check whether a provider supports a specific capability via dot-path query… |
getSpawnCapableProviders() | function | Filter providers that support spawning subagents. |
getProvidersBySpawnCapability() | function | Filter providers by a specific boolean spawn capability flag. |
resetRegistry() | function | Reset cached registry data, forcing a reload on next access. |
getProvidersBySkillsPrecedence() | function | Filter providers by their skills precedence value. |
getEffectiveSkillsPaths() | function | Get the effective skills paths for a provider, ordered by precedence. |
buildSkillsMap() | function | Build a full skills map for all providers. |
getProviderCapabilities() | function | Get capabilities for a provider by ID or alias. |
providerSupportsById() | function | Check if a provider supports a capability using ID/alias lookup. Convenience… |
buildInjectionContent() | function | Build injection content from a structured template. Produces a string suitab… |
parseInjectionContent() | function | Parse injection content back into template form. Lines starting with @ are… |
generateInjectionContent() | function | Generate a standard CAAMP injection block for instruction files. Produces ma… |
generateSkillsSection() | function | Generate a skills discovery section for instruction files. |
getInstructFile() | function | Get the correct instruction file name for a provider. |
groupByInstructFile() | function | Group providers by their instruction file name. Useful for determining which… |
checkInjection() | function | Check the status of a CAAMP injection block in an instruction file. Returns… |
inject() | function | Inject content into an instruction file between CAAMP markers. Behavior depe… |
removeInjection() | function | Remove the CAAMP injection block from an instruction file. If removing the b… |
checkAllInjections() | function | Check injection status across all providers’ instruction files. Deduplicates… |
injectAll() | function | Inject content into all providers’ instruction files. Deduplicates by file p… |
ensureProviderInstructionFile() | function | Ensure a provider’s instruction file exists with the correct CAAMP block. Th… |
ensureAllProviderInstructionFiles() | function | Ensure instruction files for multiple providers at once. Deduplicates by fil… |
setVerbose() | function | Enable or disable verbose (debug) logging mode. When enabled, debug messages… |
setQuiet() | function | Enable or disable quiet mode. When enabled, info and warning messages are su… |
debug() | function | Log a debug message to stderr when verbose mode is enabled. |
info() | function | Log an informational message to stdout. |
warn() | function | Log a warning message to stderr. |
error() | function | Log an error message to stderr. |
isVerbose() | function | Check if verbose (debug) logging is currently enabled. |
isQuiet() | function | Check if quiet mode is currently enabled. |
setHuman() | function | Enable or disable human-readable output mode. When enabled, commands output… |
isHuman() | function | Check if human-readable output mode is currently enabled. |
detectProvider() | function | Detect if a single provider is installed on the system. Checks each detectio… |
detectProjectProvider() | function | Detect if a provider has project-level config in the given directory. |
detectAllProviders() | function | Detect all registered providers and return their installation status. Runs d… |
getInstalledProviders() | function | Get only providers that are currently installed on the system. Convenience w… |
detectProjectProviders() | function | Detect all providers and enrich results with project-level presence. Extends… |
resetDetectionCache() | function | Reset the detection result cache, forcing fresh detection on next call. |
installToCanonical() | function | Copy skill files to the canonical location. |
installSkill() | function | Install a skill from a local path to the canonical location and link to agents. |
removeSkill() | function | Remove a skill from the canonical location and all agent symlinks. |
listCanonicalSkills() | function | List all skills installed in the canonical skills directory. |
selectProvidersByMinimumPriority() | function | Filters providers by minimum priority and returns them in deterministic tier… |
installBatchWithRollback() | function | Installs multiple skills across filtered providers with rollback. |
updateInstructionsSingleOperation() | function | Updates instruction files across providers as a single operation. |
resolveFormat() | function | Resolves output format based on flags and defaults. |
buildEnvelope() | function | Builds a standard LAFS envelope. |
emitError() | function | Emits a JSON error envelope to stderr and exits the process. |
emitJsonError() | function | Emits a JSON error envelope without exiting (for catch blocks). |
outputSuccess() | function | Outputs a successful LAFS envelope to stdout. |
handleFormatError() | function | Handles format resolution errors consistently. |
LAFSCommandError | class | Structured error class for LAFS-compliant command failures with error codes a… |
emitSuccess() | function | Emits a successful LAFS result envelope to stdout. |
emitError() | function | Emits a failed LAFS error envelope to stderr. |
runLafsCommand() | function | Runs an async action and emits the result as a LAFS success or error envelope. |
parsePriority() | function | Parses and validates a provider priority tier string. |
resolveProviders() | function | Resolves the set of target providers from CLI targeting options. |
readJsonFile() | function | Reads and parses a JSON file from disk. |
readSkillOperations() | function | Reads and validates a JSON file containing skill batch operations. |
readTextInput() | function | Reads text input from either inline content or a file path, enforcing mutual… |
registerAdvancedBatch() | function | Registers the advanced batch subcommand for rollback-capable batch install… |
registerAdvancedInstructions() | function | Registers the advanced instructions subcommand for single-operation instruc… |
registerAdvancedProviders() | function | Registers the advanced providers subcommand for selecting providers by prio… |
registerAdvancedCommands() | function | Registers the advanced command group with providers, batch, and instruction… |
deepMerge() | function | Deep merge two objects, with source values winning on conflict. Recursivel… |
setNestedValue() | function | Set a nested value using a dot-notation key path. |
getNestedValue() | function | Get a nested value from an object using a dot-notation key path. |
ensureDir() | function | Ensure that the parent directories of a file path exist. Creates directories… |
readJsonConfig() | function | Read and parse a JSON or JSONC config file. |
writeJsonConfig() | function | Write a server config entry to a JSON/JSONC file, preserving comments. |
removeJsonConfig() | function | Remove a server entry from a JSON/JSONC config file. |
readTomlConfig() | function | Read and parse a TOML config file. |
writeTomlConfig() | function | Write a server config entry to a TOML file. |
removeTomlConfig() | function | Remove a server entry from a TOML config file. |
readYamlConfig() | function | Read and parse a YAML config file. |
writeYamlConfig() | function | Write a server config entry to a YAML file. |
removeYamlConfig() | function | Remove a server entry from a YAML config file. |
readConfig() | function | Read and parse a config file in the specified format. Dispatches to the appr… |
writeConfig() | function | Write a server entry to a config file, preserving existing content. Dispatch… |
removeConfig() | function | Remove a server entry from a config file in the specified format. |
registerConfigCommand() | function | Registers the config command group with show and path subcommands for viewi… |
readLockFile() | function | Read and parse the CAAMP lock file from disk. |
writeLockFile() | function | Write the lock file atomically under a process lock guard. |
updateLockFile() | function | Safely read-modify-write the lock file under a process lock guard. |
getCaampVersion() | function | Retrieve the current CAAMP package version from the nearest package.json. |
registerDoctorCommand() | function | Registers the doctor command for diagnosing configuration issues and overal… |
registerInstructionsCheck() | function | Registers the instructions check subcommand for verifying injection status… |
registerInstructionsInject() | function | Registers the instructions inject subcommand for injecting instruction bloc… |
registerInstructionsUpdate() | function | Registers the instructions update subcommand for refreshing all instruction… |
registerInstructionsCommands() | function | Registers the instructions command group with inject, check, and update sub… |
resetHookMappings() | function | Reset the cached hook mappings data. |
getCanonicalEvent() | function | Get the canonical event definition (category, description, canBlock). |
getAllCanonicalEvents() | function | Get all canonical event definitions. |
getCanonicalEventsByCategory() | function | Get canonical events filtered by category. |
getProviderHookProfile() | function | Get the full hook profile for a provider. |
getMappedProviderIds() | function | Get all provider IDs that have hook mappings. |
toNative() | function | Translate a CAAMP canonical event name to the provider’s native name. |
toCanonical() | function | Translate a provider-native event name to the CAAMP canonical name. |
toNativeBatch() | function | Batch-translate multiple canonical events to native names for a provider. |
supportsHook() | function | Check if a provider supports a specific canonical hook event. |
getHookSupport() | function | Get full hook support details for a canonical event on a provider. |
getSupportedEvents() | function | Get all supported canonical events for a provider. |
getUnsupportedEvents() | function | Get all unsupported canonical events for a provider. |
getProvidersForEvent() | function | Get providers that support a specific canonical event. |
getCommonEvents() | function | Get canonical events common to all specified providers. |
getProviderSummary() | function | Get a summary of hook support for a provider. |
buildHookMatrix() | function | Build a cross-provider hook support matrix. |
getHookSystemType() | function | Get the hook system type for a provider. |
getHookConfigPath() | function | Get the resolved hook config path for a provider. |
getProviderOnlyEvents() | function | Get provider-only events (native events with no canonical mapping). |
translateToAll() | function | Translate a canonical event to native names across multiple providers. |
resolveNativeEvent() | function | Find the best canonical match for a native event name across all providers. |
getHookMappingsVersion() | function | Get the version of the hook mappings data. |
registerProvidersCommand() | function | Registers the providers command group with list, detect, show, skills-map,… |
getRulesByCategory() | function | Get audit rules filtered by category. |
getRulesBySeverity() | function | Get audit rules filtered by severity level. |
getCategories() | function | Get all unique rule categories. |
scanFile() | function | Scan a single file against security audit rules. |
scanDirectory() | function | Scan a directory of skills for security issues. |
toSarif() | function | Convert audit results to SARIF 2.1.0 format (Static Analysis Results Intercha… |
registerSkillsAudit() | function | Registers the skills audit subcommand for security scanning skill files. |
parseSource() | function | Parse and classify a source string into a typed ParsedSource. |
isMarketplaceScoped() | function | Check if a source string looks like a marketplace scoped name (@author/name). |
recordSkillInstall() | function | Record a skill installation in the lock file. |
removeSkillFromLock() | function | Remove a skill entry from the lock file. |
getTrackedSkills() | function | Get all skills tracked in the lock file. |
checkSkillUpdate() | function | Check if a skill has updates available by comparing the installed version aga… |
checkAllSkillUpdates() | function | Check for updates across all tracked skills. |
registerSkillsCheck() | function | Registers the skills check subcommand for checking available skill updates. |
NetworkError | class | Structured error for network failures with categorized kind. |
fetchWithTimeout() | function | Fetch a URL with an automatic timeout via AbortSignal.timeout. |
ensureOkResponse() | function | Assert that a Response has an OK status, throwing on failure. |
formatNetworkError() | function | Format a network error into a user-friendly message string. |
SkillsMPAdapter | class | Marketplace adapter for the agentskills.in API. |
SkillsShAdapter | class | Marketplace adapter for the skills.sh API. |
MarketplaceUnavailableError | class | Error thrown when all marketplace sources fail to respond. |
MarketplaceClient | class | Unified marketplace client that aggregates results from multiple marketplace… |
tokenizeCriteriaValue() | function | Splits a comma-separated criteria string into normalized tokens. |
validateRecommendationCriteria() | function | Validates recommendation criteria input for correctness and consistency. |
normalizeRecommendationCriteria() | function | Normalizes raw recommendation criteria into a consistent tokenized form. |
scoreSkillRecommendation() | function | Computes a recommendation score for a single skill against normalized criteria. |
recommendSkills() | function | Validates, normalizes, scores, and ranks a list of skills against criteria. |
formatSkillRecommendations() | function | Format skill recommendation results for display or serialization. |
searchSkills() | function | Search for skills via marketplace APIs. |
recommendSkills() | function | Search and rank skills based on query and recommendation criteria. |
registerSkillsFind() | function | Registers the skills find subcommand for searching marketplaces and recomme… |
registerSkillsInit() | function | Registers the skills init subcommand for scaffolding new SKILL.md templates. |
loadLibraryFromModule() | function | Load a SkillLibrary from a module (index.js) at the given root directory. |
buildLibraryFromFiles() | function | Build a SkillLibrary from raw files in a directory. |
registerSkillLibrary() | function | Registers a SkillLibrary instance directly as the active catalog. |
registerSkillLibraryFromPath() | function | Registers a skill library by loading it from a directory path. |
clearRegisteredLibrary() | function | Clears the registered skill library instance. |
isCatalogAvailable() | function | Checks whether a skill library is available for use. |
getSkills() | function | Returns all skill entries from the catalog. |
getManifest() | function | Returns the parsed skill library manifest. |
listSkills() | function | Lists all available skill names in the catalog. |
getSkill() | function | Gets skill metadata by name from the catalog. |
getSkillPath() | function | Resolves the absolute path to a skill’s SKILL.md file. |
getSkillDir() | function | Resolves the absolute path to a skill’s directory. |
readSkillContent() | function | Reads a skill’s SKILL.md content as a string. |
getCoreSkills() | function | Returns all skills marked as core in the catalog. |
getSkillsByCategory() | function | Returns skills filtered by category. |
getSkillDependencies() | function | Gets the direct dependency names for a skill. |
resolveDependencyTree() | function | Resolves the full dependency tree for a set of skill names. |
listProfiles() | function | Lists all available profile names in the catalog. |
getProfile() | function | Gets a profile definition by name from the catalog. |
resolveProfile() | function | Resolves a profile to its full skill list including inherited skills. |
listSharedResources() | function | Lists all available shared resource names in the catalog. |
getSharedResourcePath() | function | Gets the absolute path to a shared resource file. |
readSharedResource() | function | Reads a shared resource file’s content as a string. |
listProtocols() | function | Lists all available protocol names in the catalog. |
getProtocolPath() | function | Gets the absolute path to a protocol file. |
readProtocol() | function | Reads a protocol file’s content as a string. |
validateSkillFrontmatter() | function | Validates a single skill’s frontmatter against the schema. |
validateAll() | function | Validates all skills in the catalog and returns results per skill. |
getDispatchMatrix() | function | Gets the dispatch matrix from the skill library manifest. |
getVersion() | function | Returns the skill library version string. |
getLibraryRoot() | function | Returns the absolute path to the skill library root directory. |
parseSkillFile() | function | Parse a SKILL.md file and extract its frontmatter metadata. |
discoverSkill() | function | Discover a single skill at a given directory path. |
discoverSkills() | function | Scan a directory for skill subdirectories, each containing a SKILL.md file. |
discoverSkillsMulti() | function | Discover skills across multiple directories. |
cloneRepo() | function | Clone a GitHub repo to a temp directory. |
fetchRawFile() | function | Fetch a specific file from GitHub using the raw API. |
repoExists() | function | Check if a GitHub repo exists. |
cloneGitLabRepo() | function | Clone a GitLab repo to a temp directory. |
fetchGitLabRawFile() | function | Fetch a specific file from GitLab using the raw API. |
registerSkillsInstall() | function | Registers the skills install subcommand for installing skills from various… |
registerSkillsList() | function | Registers the skills list subcommand for listing installed skills. |
registerSkillsRemove() | function | Registers the skills remove subcommand for removing installed skills. |
registerSkillsUpdate() | function | Registers the skills update subcommand for updating all outdated skills. |
validateSkill() | function | Validate a SKILL.md file against the Agent Skills standard. |
registerSkillsValidate() | function | Registers the skills validate subcommand for validating SKILL.md file format. |
registerSkillsCommands() | function | Registers the skills command group with all skill management subcommands. |
isCaampOwnedSkill() | function | Check whether a skill name is reserved by CAAMP (ct-* prefix). |
checkSkillIntegrity() | function | Check the integrity of a single installed skill. |
checkAllSkillIntegrity() | function | Check integrity of all tracked skills. |
shouldOverrideSkill() | function | Resolve a skill name conflict where a user-installed skill collides with a CA… |
validateInstructionIntegrity() | function | Validate instruction file injection status across all providers. |
resolveCantImports() | function | Resolve *.cant references in instruction file content. Scans each line for… |
cantToMarkdown() | function | Convert a .cant file’s content to markdown equivalent. Parses the frontmatte… |
discoverWellKnown() | function | Discover skills from a well-known URL. |