/**
 * Capability-map validation and activation-directive resolution.
 *
 * Extracted verbatim from `adapters/claude-code.ts`, which held the only
 * validating implementation, at the moment a second adapter (copilot) needed the
 * same behaviour. The one generalisation is that `resolveActivation` now takes
 * the platform id instead of hardcoding `'claude-code'` when reading
 * `native_mode_hint`.
 *
 * Note for anyone adding a third consumer: `adapters/codex.ts` has its own
 * `getCapabilityDirective`, which does NOT validate the map and emits no
 * warnings for a malformed one. It is deliberately left alone here — migrating it
 * would change codex's emitted warnings, which is a behaviour change, not an
 * extraction. Prefer this module for anything new.
 *
 * Requirements: copilot-platform-support/AC-24
 *
 * @module
 */
import type { CapabilityEntry, CapabilityMap, PhaseName, PlatformId, Skill } from '../core/types.js';
/**
 * Validate and sanitize a capability map. Returns a clean map with only valid
 * entries, or null if the map is entirely unusable. Emits warnings for problems.
 */
export declare function validateCapabilityMap(caps: CapabilityMap, warnings: string[]): Map<PhaseName, CapabilityEntry> | null;
/**
 * Derive the activation directive for a skill given the resolution precedence:
 *
 * 1. `skill.meta.native_mode_hint[platform]` → use it
 * 2. Capability map entry covering the skill's phase → its activation text
 * 3. Otherwise → null, meaning full structured guidance with no native reference
 */
export declare function resolveActivation(skill: Skill, platform: PlatformId, phaseMap: Map<PhaseName, CapabilityEntry> | null): string | null;
//# sourceMappingURL=capability-resolve.d.ts.map