praana 0.5.0

package/dist/skills/index.d.ts

@@ -0,0 +1,69 @@
+import type { SkillRecord, SkillsMetaFile, SkillIndexEntry, SkillRuntimeState, SkillRuntimeSnapshot, SkillTelemetryEvent, SkillsRuntimeConfig } from "./types.js";
+export declare function parseSkillMdContent(content: string, filePath: string): SkillRecord | null;
+export declare function parseSkillMdFile(filePath: string): SkillRecord | null;
+export declare function loadMergedSkillsMeta(cwd: string): SkillsMetaFile;
+export declare function discoverSkills(cwd: string, maxDepth?: number, _paths?: string[]): SkillRecord[];
+/** Metadata-only skill catalog for classic mode (no residency or BM25). */
+export declare function buildSkillMetadataCatalog(records: SkillRecord[]): string;
+export declare function buildBM25Index(skills: SkillRecord[], meta: SkillsMetaFile): SkillIndexEntry[];
+export interface MatchResult {
+    entry: SkillIndexEntry;
+    score: number;
+}
+/**
+ * Rank skills by relevance to user input using BM25 + synonym expansion + neighbor boost.
+ */
+export declare function rankSkills(index: SkillIndexEntry[], userInput: string, hotSkillIds: Set<string>, synonymMap?: Record<string, string[]>): MatchResult[];
+export declare class SkillRuntime {
+    private config;
+    private cwd;
+    private records;
+    private index;
+    private runtimeStates;
+    private turnCount;
+    private events;
+    private budgetBase;
+    private synonyms;
+    constructor(config: SkillsRuntimeConfig, cwd: string);
+    /** Parse a SKILL.md file. Returns null if invalid or missing required fields. */
+    static parseFile(filePath: string): SkillRecord | null;
+    initialize(): Promise<void>;
+    processUserInput(userInput: string): void;
+    endTurn(): void;
+    markSkillActive(skillId: string): void;
+    getSnapshot(tokenBudget: number): SkillRuntimeSnapshot;
+    /** Build the skills section for the compiled prompt. */
+    buildPromptSection(tokenBudget: number): string;
+    private getSectionContent;
+    private setResidency;
+    private demote;
+    private evict;
+    private hydrateSkill;
+    /** Load execution section (called when tool execution starts) */
+    hydrateExecution(id: string): void;
+    /** HOT skill IDs for the current turn. */
+    getHotSkillIds(): string[];
+    /** Load execution sections for all HOT skills (called when tool execution starts). */
+    hydrateExecutionForHotSkills(): void;
+    /** Load recovery sections for all HOT skills (called on tool failure). */
+    hydrateRecoveryForHotSkills(): void;
+    /** Load recovery section (called on failure) */
+    hydrateRecovery(id: string): void;
+    private computeTokenCost;
+    private getSkillsTokenBudget;
+    private enforceBudget;
+    /** Update the budget base (called each turn with compiler.token_budget). */
+    setBudgetBase(totalTokenBudget: number): void;
+    private emit;
+    drainEvents(): SkillTelemetryEvent[];
+    getEvents(): SkillTelemetryEvent[];
+    getIndex(): SkillIndexEntry[];
+    getRuntimeStates(): Map<string, SkillRuntimeState>;
+    getSkillCount(): number;
+    getResidencyCounts(): {
+        hot: number;
+        warm: number;
+        cold: number;
+    };
+    isEnabled(): boolean;
+}