kagent-ts 0.1.3 → 0.1.5

package/dist/skills/skill-manager.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SkillManager = void 0;
 const file_skill_loader_1 = require("./file-skill-loader");
+const logger_1 = require("../logging/logger");
+const boundaries_1 = require("../security/boundaries");
 /**
  * Manages skill registration, activation, and progressive disclosure.
  *
@@ -10,12 +12,17 @@ const file_skill_loader_1 = require("./file-skill-loader");
  * 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.
+ * Workflow:
+ * 1. Skills are registered from a directory (metadata only: name, description, keywords)
+ * 2. `buildAvailableSkillsHint()` lists all available skills in the system prompt
+ * 3. LLM decides which skill to use → `activate(name)` loads the full content
+ * 4. `buildSkillsPrompt()` includes the active skill's full system prompt
  */
 class SkillManager {
+    logger;
+    constructor(logger) {
+        this.logger = logger ?? new logger_1.ConsoleLogger();
+    }
     /** All registered skills (active or not), keyed by name. */
     registry = new Map();
     /** Skills that are currently active. */
@@ -26,32 +33,16 @@ class SkillManager {
     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 a skill object directly (programmatic registration).
+     * Used when skills are defined in code rather than loaded from disk.
      */
-    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);
+    register(skill) {
+        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.
@@ -60,6 +51,7 @@ class SkillManager {
         if (this.activeSkills.has(name)) {
             this.deactivate(name);
         }
+        this.fileLoaders.delete(name);
         return this.registry.delete(name);
     }
     /**
@@ -73,12 +65,12 @@ class SkillManager {
      * @returns Number of skills successfully registered.
      */
     registerFromDirectory(dir) {
-        const loader = new file_skill_loader_1.FileSkillLoader(dir);
+        const loader = new file_skill_loader_1.FileSkillLoader(dir, this.logger);
         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).`);
+                this.logger.warn("Skills", `Skipping "${skill.name}": already registered (duplicate name).`);
                 continue;
             }
             this.registry.set(skill.name, skill);
@@ -86,13 +78,36 @@ class SkillManager {
             count++;
         }
         if (count > 0) {
-            console.log(`[Skills] Registered ${count} file-based skill(s) from ${dir}` +
+            this.logger.info("Skills", `Registered ${count} file-based skill(s) from ${dir}` +
                 (scanned.length !== count
                     ? ` (${scanned.length - count} skipped)`
                     : ""));
         }
         return count;
     }
+    /**
+     * Re-scan the skills directory for new SKILL.md files.
+     *
+     * Safe to call at the start of each run — only registers skills that
+     * haven't been registered yet. Already-registered skills are left as-is.
+     *
+     * @param dir Path to the skills directory.
+     * @returns Names of newly registered skills (empty if nothing changed).
+     */
+    reloadFromDirectory(dir) {
+        const before = new Set(this.registry.keys());
+        this.registerFromDirectory(dir);
+        const after = new Set(this.registry.keys());
+        const added = [];
+        for (const name of after) {
+            if (!before.has(name))
+                added.push(name);
+        }
+        if (added.length > 0) {
+            this.logger.info("Skills", `Picked up ${added.length} new skill(s): ${added.join(", ")}`);
+        }
+        return added;
+    }
     /**
      * Check if a skill is registered.
      */
@@ -114,8 +129,7 @@ class SkillManager {
     // ─── Activation / Deactivation ───────────────────────────────────────
     /**
      * Activate a skill by name.
-     * - Appends its system prompt to the accumulated skill context.
-     * - Registers its tools (if a ToolRegistry is bound).
+     * - Lazy-loads the full system prompt from disk (if file-based).
      * - Returns true if the skill was newly activated.
      */
     activate(name) {
@@ -126,12 +140,11 @@ class SkillManager {
         if (this.activeSkills.has(name)) {
             return false; // Already active
         }
-        // Lazy-load file-based skills: populate systemPrompt and tools from disk
+        // Lazy-load file-based skills: populate systemPrompt 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) {
@@ -141,17 +154,6 @@ class SkillManager {
         }
         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;
     }
     /**
@@ -173,18 +175,11 @@ class SkillManager {
     }
     /**
      * 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
@@ -200,36 +195,6 @@ class SkillManager {
             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.
@@ -243,9 +208,16 @@ class SkillManager {
             return "";
         const sections = [];
         for (const skill of active) {
-            sections.push(`[Skill: ${skill.name}]\n${skill.systemPrompt}`);
+            sections.push(`[Skill: ${skill.name}]\n${skill.systemPrompt ?? ""}`);
         }
-        return "\n\n" + sections.join("\n\n");
+        const body = sections.join("\n\n");
+        // Scan for prompt-injection signatures in user-authored skill content
+        const patterns = (0, boundaries_1.detectInjectionSignatures)(body);
+        const warning = (0, boundaries_1.buildUserContentInjectionWarning)(patterns, "skills");
+        // Wrap with user-authored boundary markers (skills are user-authored files,
+        // same risk profile as project rules)
+        const wrapped = (0, boundaries_1.wrapUserAuthored)("Active Skills", body);
+        return "\n\n" + warning + wrapped;
     }
     /**
      * Build a lightweight list of available (unactivated) skill names
@@ -263,8 +235,14 @@ class SkillManager {
         }
         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"));
+        const body = "Available skills (use the `skill` tool to activate them when needed):\n" +
+            available.map((line) => `  - ${line}`).join("\n");
+        // Scan for prompt-injection signatures in skill names/descriptions
+        const patterns = (0, boundaries_1.detectInjectionSignatures)(body);
+        const warning = (0, boundaries_1.buildUserContentInjectionWarning)(patterns, "skill descriptions");
+        // Wrap with user-authored boundary markers
+        const wrapped = (0, boundaries_1.wrapUserAuthored)("Available Skills", body);
+        return "\n\n" + warning + wrapped;
     }
     // ─── Query ───────────────────────────────────────────────────────────
     /**

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

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

@@ -1,12 +1,10 @@
-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
+ * Each skill carries a system prompt fragment with instructions for the LLM.
+ * Activation is LLM-driven — the agent calls the `skill` tool to load a skill
+ * when it determines one is needed.
  */
 export interface Skill {
     /** Unique identifier for this skill. */
@@ -17,17 +15,7 @@ export interface Skill {
      * 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[];
+    systemPrompt?: string;
 }
 /**
  * Status of a skill within the SkillManager.

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

@@ -1 +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;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,KAAK;IACpB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;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;CACjB"}

package/dist/subagent/index.d.ts

@@ -0,0 +1,4 @@
+export { SubAgentManager } from "./subagent-manager";
+export { SubAgentLoader } from "./subagent-loader";
+export type { SubAgentDefinition, SubAgentStatus, SubAgentResult, } from "./subagent-types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/subagent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC"}

package/dist/subagent/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAgentLoader = exports.SubAgentManager = void 0;
+var subagent_manager_1 = require("./subagent-manager");
+Object.defineProperty(exports, "SubAgentManager", { enumerable: true, get: function () { return subagent_manager_1.SubAgentManager; } });
+var subagent_loader_1 = require("./subagent-loader");
+Object.defineProperty(exports, "SubAgentLoader", { enumerable: true, get: function () { return subagent_loader_1.SubAgentLoader; } });
+//# sourceMappingURL=index.js.map

package/dist/subagent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/subagent/index.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}

package/dist/subagent/subagent-loader.d.ts

@@ -0,0 +1,53 @@
+import { SubAgentDefinition } from "./subagent-types";
+import { Logger } from "../logging/logger";
+/**
+ * Loads sub-agent definitions from a directory of AGENT.md files.
+ *
+ * Expected directory structure:
+ * ```
+ * subagents/
+ * ├── <agent-name>/
+ * │   └── AGENT.md       # Frontmatter (metadata) + body (system prompt)
+ * ├── <another-agent>/
+ * │   └── AGENT.md
+ * ```
+ *
+ * The AGENT.md format:
+ * ```markdown
+ * ---
+ * name: code-reviewer
+ * description: Reviews code for bugs and style issues
+ * tools: read_file, grep_search, glob_search
+ * skills: code-review
+ * ---
+ * You are a code review specialist...
+ * ```
+ */
+export declare class SubAgentLoader {
+    private directory;
+    private agentFileName;
+    private logger;
+    /**
+     * @param directory      Path to the sub-agents root directory.
+     * @param agentFileName  The markdown filename to look for (default: "AGENT.md").
+     * @param logger         Logger instance (defaults to ConsoleLogger).
+     */
+    constructor(directory: string, agentFileName?: string, logger?: Logger);
+    /**
+     * Get the root directory path.
+     */
+    getDirectory(): string;
+    /**
+     * Scan the directory and return SubAgentDefinition objects for each
+     * subdirectory that contains a valid AGENT.md file.
+     *
+     * Subdirectories without an AGENT.md or without a `name` in frontmatter
+     * are skipped with a warning.
+     */
+    scan(): SubAgentDefinition[];
+    /**
+     * Load a single sub-agent definition by name (the subdirectory name).
+     */
+    loadDefinition(dirName: string): SubAgentDefinition | null;
+}
+//# sourceMappingURL=subagent-loader.d.ts.map

package/dist/subagent/subagent-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-loader.d.ts","sourceRoot":"","sources":["../../src/subagent/subagent-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAiB,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;gBACS,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAMtE;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;OAMG;IACH,IAAI,IAAI,kBAAkB,EAAE;IAuB5B;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;CAoC3D"}

package/dist/subagent/subagent-loader.js

@@ -0,0 +1,155 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAgentLoader = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const file_skill_loader_1 = require("../skills/file-skill-loader");
+const logger_1 = require("../logging/logger");
+/**
+ * Loads sub-agent definitions from a directory of AGENT.md files.
+ *
+ * Expected directory structure:
+ * ```
+ * subagents/
+ * ├── <agent-name>/
+ * │   └── AGENT.md       # Frontmatter (metadata) + body (system prompt)
+ * ├── <another-agent>/
+ * │   └── AGENT.md
+ * ```
+ *
+ * The AGENT.md format:
+ * ```markdown
+ * ---
+ * name: code-reviewer
+ * description: Reviews code for bugs and style issues
+ * tools: read_file, grep_search, glob_search
+ * skills: code-review
+ * ---
+ * You are a code review specialist...
+ * ```
+ */
+class SubAgentLoader {
+    directory;
+    agentFileName;
+    logger;
+    /**
+     * @param directory      Path to the sub-agents root directory.
+     * @param agentFileName  The markdown filename to look for (default: "AGENT.md").
+     * @param logger         Logger instance (defaults to ConsoleLogger).
+     */
+    constructor(directory, agentFileName, logger) {
+        this.directory = path.resolve(directory);
+        this.agentFileName = agentFileName ?? "AGENT.md";
+        this.logger = logger ?? new logger_1.ConsoleLogger();
+    }
+    /**
+     * Get the root directory path.
+     */
+    getDirectory() {
+        return this.directory;
+    }
+    /**
+     * Scan the directory and return SubAgentDefinition objects for each
+     * subdirectory that contains a valid AGENT.md file.
+     *
+     * Subdirectories without an AGENT.md or without a `name` in frontmatter
+     * are skipped with a warning.
+     */
+    scan() {
+        const definitions = [];
+        let entries;
+        try {
+            entries = fs.readdirSync(this.directory, { withFileTypes: true });
+        }
+        catch {
+            return [];
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith("."))
+                continue;
+            const def = this.loadDefinition(entry.name);
+            if (def) {
+                definitions.push(def);
+            }
+        }
+        return definitions;
+    }
+    /**
+     * Load a single sub-agent definition by name (the subdirectory name).
+     */
+    loadDefinition(dirName) {
+        const agentPath = path.join(this.directory, dirName, this.agentFileName);
+        let raw;
+        try {
+            raw = fs.readFileSync(agentPath, "utf-8");
+        }
+        catch {
+            this.logger.warn("SubAgent", `Skipping "${dirName}": no ${this.agentFileName} found.`);
+            return null;
+        }
+        const { frontmatter, body } = (0, file_skill_loader_1.parseFrontmatter)(raw);
+        const name = frontmatter.name?.trim();
+        if (!name) {
+            this.logger.warn("SubAgent", `Skipping "${dirName}": no "name" in frontmatter.`);
+            return null;
+        }
+        const tools = parseCsvList(frontmatter.tools);
+        const skills = parseCsvList(frontmatter.skills);
+        return {
+            name,
+            description: frontmatter.description?.trim() ?? "",
+            systemPrompt: body,
+            tools,
+            skills,
+        };
+    }
+}
+exports.SubAgentLoader = SubAgentLoader;
+/**
+ * Parse a comma-separated string into a string array.
+ * Returns empty array for empty/absent input.
+ */
+function parseCsvList(raw) {
+    if (!raw)
+        return [];
+    return raw
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=subagent-loader.js.map

package/dist/subagent/subagent-loader.js.map

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