kagent-ts 0.1.0

package/dist/skills/file-skill-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-skill-loader.js","sourceRoot":"","sources":["../../src/skills/file-skill-loader.ts"],"names":[],"mappings":"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"}

package/dist/skills/index.d.ts

@@ -0,0 +1,4 @@
+export { SkillManager } from "./skill-manager";
+export { FileSkillLoader, parseFrontmatter, parseKeywords } from "./file-skill-loader";
+export type { Skill, SkillStatus } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvF,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseKeywords = exports.parseFrontmatter = exports.FileSkillLoader = exports.SkillManager = void 0;
+var skill_manager_1 = require("./skill-manager");
+Object.defineProperty(exports, "SkillManager", { enumerable: true, get: function () { return skill_manager_1.SkillManager; } });
+var file_skill_loader_1 = require("./file-skill-loader");
+Object.defineProperty(exports, "FileSkillLoader", { enumerable: true, get: function () { return file_skill_loader_1.FileSkillLoader; } });
+Object.defineProperty(exports, "parseFrontmatter", { enumerable: true, get: function () { return file_skill_loader_1.parseFrontmatter; } });
+Object.defineProperty(exports, "parseKeywords", { enumerable: true, get: function () { return file_skill_loader_1.parseKeywords; } });
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,yDAAuF;AAA9E,oHAAA,eAAe,OAAA;AAAE,qHAAA,gBAAgB,OAAA;AAAE,kHAAA,aAAa,OAAA"}

package/dist/skills/skill-manager.d.ts

@@ -0,0 +1,133 @@
+import { Skill, SkillStatus } from "./types";
+import { ToolRegistry } from "../tools/tool-registry";
+/**
+ * Manages skill registration, activation, and progressive disclosure.
+ *
+ * Skills are lightweight domain-specific capabilities that can be
+ * loaded into the agent's system prompt on demand. This keeps the
+ * core system prompt small while allowing deep expertise to be
+ * injected when needed.
+ *
+ * Activation strategies:
+ * 1. Keyword auto-detection — skills define keywords; user input
+ *    that matches triggers activation.
+ * 2. Manual activation — call `activate(name)` explicitly.
+ */
+export declare class SkillManager {
+    /** All registered skills (active or not), keyed by name. */
+    private registry;
+    /** Skills that are currently active. */
+    private activeSkills;
+    /** Timestamps for when each skill was activated. */
+    private activatedAt;
+    /** FileSkillLoaders for file-based skills, keyed by skill name. */
+    private fileLoaders;
+    /** File-based skills whose full content has been loaded from disk. */
+    private loadedFileSkills;
+    /** Reference to the ToolRegistry for registering/unregistering skill tools. */
+    private toolRegistry?;
+    /**
+     * @param toolRegistry Optional ToolRegistry — skills with tools
+     *                     will auto-register/unregister there.
+     */
+    constructor(toolRegistry?: ToolRegistry);
+    /**
+     * Bind a ToolRegistry so skill tools are managed automatically.
+     */
+    bindToolRegistry(registry: ToolRegistry): void;
+    /**
+     * Register one or more skills.
+     */
+    register(...skills: Skill[]): void;
+    /**
+     * Unregister a skill by name. Deactivates it first if active.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Register skills from a directory of SKILL.md files.
+     *
+     * Scans the directory, reads frontmatter from each SKILL.md, and
+     * registers metadata-only Skill objects. Full content (system prompt,
+     * reference docs, scripts) is loaded lazily on activation.
+     *
+     * @param dir Path to the skills directory.
+     * @returns Number of skills successfully registered.
+     */
+    registerFromDirectory(dir: string): number;
+    /**
+     * Check if a skill is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Get a registered skill by name.
+     */
+    get(name: string): Skill | undefined;
+    /**
+     * Get all registered skills.
+     */
+    getAll(): Skill[];
+    /**
+     * Activate a skill by name.
+     * - Appends its system prompt to the accumulated skill context.
+     * - Registers its tools (if a ToolRegistry is bound).
+     * - Returns true if the skill was newly activated.
+     */
+    activate(name: string): boolean;
+    /**
+     * Activate multiple skills at once.
+     */
+    activateMany(names: string[]): string[];
+    /**
+     * Deactivate a skill.
+     * - Unregisters its tools (if a ToolRegistry is bound).
+     */
+    deactivate(name: string): boolean;
+    /**
+     * Deactivate all active skills.
+     */
+    deactivateAll(): void;
+    /**
+     * Scan user input against unregistered (not yet active) skills.
+     * Activates any skill whose keywords match the input.
+     *
+     * @param input The user's input text.
+     * @returns Names of newly activated skills.
+     */
+    detectAndActivate(input: string): string[];
+    /**
+     * Build the accumulated system prompt content from all active skills.
+     * Each skill's prompt is wrapped in a named section for clarity.
+     *
+     * Returns an empty string if no skills are active.
+     */
+    buildSkillsPrompt(): string;
+    /**
+     * Build a lightweight list of available (unactivated) skill names
+     * for inclusion in the system prompt.
+     *
+     * This is what "progressive disclosure" means — the agent sees
+     * the names up front but the full instructions only load on activation.
+     */
+    buildAvailableSkillsHint(): string;
+    /**
+     * Check if a skill is currently active.
+     */
+    isActive(name: string): boolean;
+    /**
+     * Get names of all currently active skills.
+     */
+    getActiveSkillNames(): string[];
+    /**
+     * Get the number of active skills.
+     */
+    get activeCount(): number;
+    /**
+     * Get status for all registered skills.
+     */
+    getAllStatus(): SkillStatus[];
+    /**
+     * Get status for all active skills.
+     */
+    getActiveStatus(): SkillStatus[];
+}
+//# sourceMappingURL=skill-manager.d.ts.map

package/dist/skills/skill-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manager.d.ts","sourceRoot":"","sources":["../../src/skills/skill-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IACvB,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAiC;IAEjD,wCAAwC;IACxC,OAAO,CAAC,YAAY,CAAiC;IAErD,oDAAoD;IACpD,OAAO,CAAC,WAAW,CAAgC;IAEnD,mEAAmE;IACnE,OAAO,CAAC,WAAW,CAA2C;IAE9D,sEAAsE;IACtE,OAAO,CAAC,gBAAgB,CAA0B;IAElD,+EAA+E;IAC/E,OAAO,CAAC,YAAY,CAAC,CAAe;IAEpC;;;OAGG;gBACS,YAAY,CAAC,EAAE,YAAY;IAIvC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAM9C;;OAEG;IACH,QAAQ,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IASlC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOjC;;;;;;;;;OASG;IACH,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IA6B1C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC;;OAEG;IACH,MAAM,IAAI,KAAK,EAAE;IAMjB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IA2C/B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAcvC;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAkBjC;;OAEG;IACH,aAAa,IAAI,IAAI;IASrB;;;;;;OAMG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IA2B1C;;;;;OAKG;IACH,iBAAiB,IAAI,MAAM;IAW3B;;;;;;OAMG;IACH,wBAAwB,IAAI,MAAM;IAgBlC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,YAAY,IAAI,WAAW,EAAE;IAY7B;;OAEG;IACH,eAAe,IAAI,WAAW,EAAE;CAGjC"}

package/dist/skills/skill-manager.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillManager = void 0;
+const file_skill_loader_1 = require("./file-skill-loader");
+/**
+ * Manages skill registration, activation, and progressive disclosure.
+ *
+ * Skills are lightweight domain-specific capabilities that can be
+ * loaded into the agent's system prompt on demand. This keeps the
+ * core system prompt small while allowing deep expertise to be
+ * injected when needed.
+ *
+ * Activation strategies:
+ * 1. Keyword auto-detection — skills define keywords; user input
+ *    that matches triggers activation.
+ * 2. Manual activation — call `activate(name)` explicitly.
+ */
+class SkillManager {
+    /** All registered skills (active or not), keyed by name. */
+    registry = new Map();
+    /** Skills that are currently active. */
+    activeSkills = new Map();
+    /** Timestamps for when each skill was activated. */
+    activatedAt = new Map();
+    /** FileSkillLoaders for file-based skills, keyed by skill name. */
+    fileLoaders = new Map();
+    /** File-based skills whose full content has been loaded from disk. */
+    loadedFileSkills = new Set();
+    /** Reference to the ToolRegistry for registering/unregistering skill tools. */
+    toolRegistry;
+    /**
+     * @param toolRegistry Optional ToolRegistry — skills with tools
+     *                     will auto-register/unregister there.
+     */
+    constructor(toolRegistry) {
+        this.toolRegistry = toolRegistry;
+    }
+    /**
+     * Bind a ToolRegistry so skill tools are managed automatically.
+     */
+    bindToolRegistry(registry) {
+        this.toolRegistry = registry;
+    }
+    // ─── Registration ────────────────────────────────────────────────────
+    /**
+     * Register one or more skills.
+     */
+    register(...skills) {
+        for (const skill of skills) {
+            if (this.registry.has(skill.name)) {
+                throw new Error(`Skill "${skill.name}" is already registered.`);
+            }
+            this.registry.set(skill.name, skill);
+        }
+    }
+    /**
+     * Unregister a skill by name. Deactivates it first if active.
+     */
+    unregister(name) {
+        if (this.activeSkills.has(name)) {
+            this.deactivate(name);
+        }
+        return this.registry.delete(name);
+    }
+    /**
+     * Register skills from a directory of SKILL.md files.
+     *
+     * Scans the directory, reads frontmatter from each SKILL.md, and
+     * registers metadata-only Skill objects. Full content (system prompt,
+     * reference docs, scripts) is loaded lazily on activation.
+     *
+     * @param dir Path to the skills directory.
+     * @returns Number of skills successfully registered.
+     */
+    registerFromDirectory(dir) {
+        const loader = new file_skill_loader_1.FileSkillLoader(dir);
+        const scanned = loader.scan();
+        let count = 0;
+        for (const skill of scanned) {
+            if (this.registry.has(skill.name)) {
+                console.warn(`[Skills] Skipping "${skill.name}": already registered (duplicate name).`);
+                continue;
+            }
+            this.registry.set(skill.name, skill);
+            this.fileLoaders.set(skill.name, loader);
+            count++;
+        }
+        if (count > 0) {
+            console.log(`[Skills] Registered ${count} file-based skill(s) from ${dir}` +
+                (scanned.length !== count
+                    ? ` (${scanned.length - count} skipped)`
+                    : ""));
+        }
+        return count;
+    }
+    /**
+     * Check if a skill is registered.
+     */
+    has(name) {
+        return this.registry.has(name);
+    }
+    /**
+     * Get a registered skill by name.
+     */
+    get(name) {
+        return this.registry.get(name);
+    }
+    /**
+     * Get all registered skills.
+     */
+    getAll() {
+        return Array.from(this.registry.values());
+    }
+    // ─── Activation / Deactivation ───────────────────────────────────────
+    /**
+     * Activate a skill by name.
+     * - Appends its system prompt to the accumulated skill context.
+     * - Registers its tools (if a ToolRegistry is bound).
+     * - Returns true if the skill was newly activated.
+     */
+    activate(name) {
+        const skill = this.registry.get(name);
+        if (!skill) {
+            throw new Error(`Unknown skill: "${name}". Available: ${Array.from(this.registry.keys()).join(", ")}`);
+        }
+        if (this.activeSkills.has(name)) {
+            return false; // Already active
+        }
+        // Lazy-load file-based skills: populate systemPrompt and tools from disk
+        const loader = this.fileLoaders.get(name);
+        if (loader && !this.loadedFileSkills.has(name)) {
+            try {
+                skill.systemPrompt = loader.loadSystemPrompt(name);
+                skill.tools = loader.loadScriptsAsTools(name);
+                this.loadedFileSkills.add(name);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                throw new Error(`Failed to load skill "${name}" from disk: ${message}`);
+            }
+        }
+        this.activeSkills.set(name, skill);
+        this.activatedAt.set(name, new Date());
+        // Register skill tools if we have a registry
+        if (this.toolRegistry && skill.tools) {
+            for (const tool of skill.tools) {
+                try {
+                    this.toolRegistry.register(tool);
+                }
+                catch {
+                    // Tool already registered — skip
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Activate multiple skills at once.
+     */
+    activateMany(names) {
+        const activated = [];
+        for (const name of names) {
+            try {
+                if (this.activate(name)) {
+                    activated.push(name);
+                }
+            }
+            catch {
+                // Skip unknown skills
+            }
+        }
+        return activated;
+    }
+    /**
+     * Deactivate a skill.
+     * - Unregisters its tools (if a ToolRegistry is bound).
+     */
+    deactivate(name) {
+        const skill = this.activeSkills.get(name);
+        if (!skill)
+            return false;
+        // Unregister skill tools
+        if (this.toolRegistry && skill.tools) {
+            for (const tool of skill.tools) {
+                this.toolRegistry.remove(tool.name);
+            }
+        }
+        this.activeSkills.delete(name);
+        this.activatedAt.delete(name);
+        // Allow re-activation to reload from disk if the skill files changed
+        this.loadedFileSkills.delete(name);
+        return true;
+    }
+    /**
+     * Deactivate all active skills.
+     */
+    deactivateAll() {
+        const names = Array.from(this.activeSkills.keys());
+        for (const name of names) {
+            this.deactivate(name);
+        }
+    }
+    // ─── Auto-Detection ──────────────────────────────────────────────────
+    /**
+     * Scan user input against unregistered (not yet active) skills.
+     * Activates any skill whose keywords match the input.
+     *
+     * @param input The user's input text.
+     * @returns Names of newly activated skills.
+     */
+    detectAndActivate(input) {
+        const lowerInput = input.toLowerCase();
+        const activated = [];
+        for (const skill of this.registry.values()) {
+            // Skip already-active skills
+            if (this.activeSkills.has(skill.name))
+                continue;
+            // Skip skills without keywords
+            if (!skill.keywords || skill.keywords.length === 0)
+                continue;
+            // Check each keyword
+            for (const keyword of skill.keywords) {
+                if (lowerInput.includes(keyword.toLowerCase())) {
+                    if (this.activate(skill.name)) {
+                        activated.push(skill.name);
+                    }
+                    break; // One match is enough per skill
+                }
+            }
+        }
+        return activated;
+    }
+    // ─── System Prompt Assembly ──────────────────────────────────────────
+    /**
+     * Build the accumulated system prompt content from all active skills.
+     * Each skill's prompt is wrapped in a named section for clarity.
+     *
+     * Returns an empty string if no skills are active.
+     */
+    buildSkillsPrompt() {
+        const active = Array.from(this.activeSkills.values());
+        if (active.length === 0)
+            return "";
+        const sections = [];
+        for (const skill of active) {
+            sections.push(`[Skill: ${skill.name}]\n${skill.systemPrompt}`);
+        }
+        return "\n\n" + sections.join("\n\n");
+    }
+    /**
+     * Build a lightweight list of available (unactivated) skill names
+     * for inclusion in the system prompt.
+     *
+     * This is what "progressive disclosure" means — the agent sees
+     * the names up front but the full instructions only load on activation.
+     */
+    buildAvailableSkillsHint() {
+        const available = [];
+        for (const skill of this.registry.values()) {
+            if (!this.activeSkills.has(skill.name)) {
+                available.push(`${skill.name}: ${skill.description}`);
+            }
+        }
+        if (available.length === 0)
+            return "";
+        return ("\n\nAvailable skills (they activate automatically when needed, or you can explicitly request one):\n" +
+            available.map((line) => `  - ${line}`).join("\n"));
+    }
+    // ─── Query ───────────────────────────────────────────────────────────
+    /**
+     * Check if a skill is currently active.
+     */
+    isActive(name) {
+        return this.activeSkills.has(name);
+    }
+    /**
+     * Get names of all currently active skills.
+     */
+    getActiveSkillNames() {
+        return Array.from(this.activeSkills.keys());
+    }
+    /**
+     * Get the number of active skills.
+     */
+    get activeCount() {
+        return this.activeSkills.size;
+    }
+    /**
+     * Get status for all registered skills.
+     */
+    getAllStatus() {
+        return Array.from(this.registry.values()).map((skill) => {
+            const active = this.activeSkills.has(skill.name);
+            return {
+                name: skill.name,
+                description: skill.description,
+                active,
+                loadedAt: this.activatedAt.get(skill.name),
+            };
+        });
+    }
+    /**
+     * Get status for all active skills.
+     */
+    getActiveStatus() {
+        return this.getAllStatus().filter((s) => s.active);
+    }
+}
+exports.SkillManager = SkillManager;
+//# sourceMappingURL=skill-manager.js.map

package/dist/skills/skill-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manager.js","sourceRoot":"","sources":["../../src/skills/skill-manager.ts"],"names":[],"mappings":"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"}

package/dist/skills/types.d.ts

@@ -0,0 +1,42 @@
+import { Tool } from "../tools/types";
+/**
+ * A Skill is a reusable capability that can be loaded into the agent's
+ * system prompt on demand (progressive disclosure).
+ *
+ * Each skill carries:
+ * - A system prompt fragment with instructions for the LLM
+ * - Optional tools the skill needs
+ * - Optional keywords that trigger automatic activation
+ */
+export interface Skill {
+    /** Unique identifier for this skill. */
+    name: string;
+    /** Human-readable description (shown to the LLM or caller). */
+    description: string;
+    /**
+     * System prompt content injected into the agent's system message
+     * when this skill is activated.
+     */
+    systemPrompt: string;
+    /**
+     * Optional keywords for auto-detection.
+     * When user input contains any of these, the skill is activated automatically.
+     */
+    keywords?: string[];
+    /**
+     * Optional tools that this skill provides.
+     * These are registered when the skill activates and unregistered on deactivation.
+     */
+    tools?: Tool[];
+}
+/**
+ * Status of a skill within the SkillManager.
+ */
+export interface SkillStatus {
+    name: string;
+    description: string;
+    active: boolean;
+    loadedAt?: Date;
+    keywordMatch?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,WAAW,KAAK;IACpB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/skills/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":""}

package/dist/tools/builtin/edit-file.d.ts

@@ -0,0 +1,12 @@
+import { Tool } from "../types";
+/**
+ * Edit a file by finding and replacing exact text.
+ *
+ * Parameters:
+ * - file_path  (required): Absolute path to the file to edit.
+ * - old_string (required): The exact text to find (must match exactly).
+ * - new_string (required): The replacement text.
+ * - replace_all (optional): Replace all occurrences (default: false).
+ */
+export declare const EditFileTool: Tool;
+//# sourceMappingURL=edit-file.d.ts.map

package/dist/tools/builtin/edit-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/edit-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,IA0F1B,CAAC"}