/** * Skill Runtime — Resolução centralizada, progressive disclosure em 3 níveis, * cache com hash SHA-256 e rastreabilidade completa (proveniência) de skills. * * Estágios rastreados por execução de nó: * candidate -> selected -> resolved -> loaded -> injected -> validated (+ dropped) */ export type SkillDisclosureLevel = 'metadata' | 'instructions' | 'references'; export type SkillSelectionReason = 'node-contract' | 'domain-policy' | 'task-relevance' | 'primary-fallback'; export type SkillDropReason = 'budget-cap' | 'low-relevance' | 'not-found' | 'duplicate' | 'invalid-path'; export interface LoadedSkillEntry { alias: string; canonicalName: string; version: string; category: string; description: string; path: string; sourceCatalog: 'v2' | 'v1' | 'generated' | 'agent-skill'; sha256: string; level: SkillDisclosureLevel; selectionReason: SkillSelectionReason; injectedText: string; tokens: number; lines: number; truncated: boolean; omittedSections: string[]; referencesLoaded: string[]; } export interface DroppedSkillEntry { alias: string; reason: SkillDropReason; detail?: string; } export interface SkillProvenanceReport { candidates: string[]; selected: Array<{ alias: string; reason: SkillSelectionReason; score: number; }>; resolved: Array<{ alias: string; canonicalName: string; path: string; sourceCatalog: LoadedSkillEntry['sourceCatalog']; }>; loaded: Array<{ alias: string; canonicalName: string; version: string; sha256: string; level: SkillDisclosureLevel; }>; injected: Array<{ alias: string; canonicalName: string; tokens: number; lines: number; truncated: boolean; omittedSections: string[]; }>; validated: Array<{ alias: string; passed: boolean; note?: string; }>; dropped: DroppedSkillEntry[]; totalTokensInjected: number; } /** * Pontua a relevância de uma skill candidata contra uma tarefa usando: * 1) match direto nos tokens do slug da skill; * 2) vocabulário de domínio (`DOMAIN_SKILL_SYNONYMS`); * 3) prefix matching (ex.: "migracao" <-> "migration", "autenticacao" <-> "auth"). */ export declare function scoreSkillRelevance(skillAlias: string, taskTokens: Set, normalizedTask: string): number; /** * Seleciona cirurgicamente até `maxSkills` (default 8) a partir de uma lista * de candidatas. * * Quando `explicitSkills` é informado (ex.: skills declaradas diretamente no * nó do grafo pelo Planner/Commander), elas têm prioridade máxima (`node-contract`) * e NUNCA são descartadas por falta de match literal no prompt do usuário. */ export declare function selectRelevantSkillsWithProvenance(candidates: string[], task: string, maxSkills?: number, explicitSkills?: string[]): { selected: Array<{ alias: string; reason: SkillSelectionReason; score: number; }>; dropped: DroppedSkillEntry[]; }; export declare class SkillRuntime { private readonly opts; constructor(opts: { cwd: string; baseDir: string; maxSkills?: number; maxLinesPerSkill?: number; defaultLevel?: SkillDisclosureLevel; }); /** * Carrega uma única skill no nível de progressive disclosure solicitado * (`metadata` | `instructions` | `references`). */ loadSkill(alias: string, level?: SkillDisclosureLevel, opts?: { maxLines?: number; loadReferences?: boolean; }): LoadedSkillEntry | undefined; /** * Executa o pipeline completo de seleção, resolução, carregamento progressivo * e compilação de skills com relatório estruturado de proveniência. */ compileSkills(params: { candidates: string[]; explicitSkills?: string[]; task: string; level?: SkillDisclosureLevel; maxSkills?: number; maxLinesPerSkill?: number; loadReferences?: boolean; }): { loadedSkills: LoadedSkillEntry[]; provenance: SkillProvenanceReport; renderedPromptBlock: string; }; } //# sourceMappingURL=runtime.d.ts.map