@kernel.chat/kbot 3.6.1 → 3.7.0

package/dist/skills-loader.js

@@ -0,0 +1,92 @@
+// Skills Loader — Auto-discover and load .md skill files
+//
+// Skill files are Markdown documents that inject domain knowledge, tool combinations,
+// and project-specific patterns into the agent's context. They're the kbot equivalent
+// of Copilot's "Agent Skills" or Cursor's "Rules for AI."
+//
+// Discovery locations (in priority order):
+//   1. ./.kbot/skills/*.md  — project-specific skills
+//   2. ~/.kbot/skills/*.md  — user global skills
+//
+// Token budget: 2000 tokens max (~8000 characters) to leave room for
+// repo map, learning context, and memory.
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { homedir } from 'node:os';
+const MAX_SKILL_TOKENS = 2000;
+const estimateTokens = (text) => Math.ceil(text.length / 4);
+/**
+ * Discover and load skill files from project and global directories.
+ * Returns formatted string ready to inject into system prompt.
+ */
+export function loadSkills(projectRoot) {
+    const skills = discoverSkillFiles(projectRoot);
+    if (skills.length === 0)
+        return '';
+    return formatSkillsForPrompt(skills);
+}
+/**
+ * Discover .md files from both project-local and global skill directories.
+ * Project skills take precedence (loaded first, consume token budget first).
+ */
+export function discoverSkillFiles(projectRoot) {
+    const locations = [
+        join(projectRoot, '.kbot', 'skills'), // Project-specific
+        join(homedir(), '.kbot', 'skills'), // User global
+    ];
+    const skills = [];
+    const seen = new Set(); // Deduplicate by filename
+    for (const dir of locations) {
+        if (!existsSync(dir))
+            continue;
+        try {
+            const files = readdirSync(dir)
+                .filter(f => f.endsWith('.md'))
+                .sort(); // Alphabetical for deterministic ordering
+            for (const file of files) {
+                if (seen.has(file))
+                    continue; // Project overrides global
+                seen.add(file);
+                try {
+                    const path = join(dir, file);
+                    const content = readFileSync(path, 'utf-8').trim();
+                    if (content.length === 0)
+                        continue;
+                    skills.push({
+                        name: basename(file, '.md'),
+                        path,
+                        content,
+                        tokens: estimateTokens(content),
+                    });
+                }
+                catch { /* permission denied, etc. */ }
+            }
+        }
+        catch { /* directory read error */ }
+    }
+    return skills;
+}
+/**
+ * Format skill files for prompt injection, respecting token budget.
+ */
+function formatSkillsForPrompt(skills, maxTokens = MAX_SKILL_TOKENS) {
+    const parts = [];
+    let currentTokens = 0;
+    for (const skill of skills) {
+        if (currentTokens + skill.tokens > maxTokens) {
+            // Try to fit a truncated version
+            const remaining = maxTokens - currentTokens;
+            if (remaining > 100) {
+                const truncated = skill.content.slice(0, remaining * 4) + '\n...(truncated)';
+                parts.push(`## Skill: ${skill.name}\n${truncated}`);
+            }
+            break;
+        }
+        parts.push(`## Skill: ${skill.name}\n${skill.content}`);
+        currentTokens += skill.tokens;
+    }
+    if (parts.length === 0)
+        return '';
+    return `\n\n[Custom Skills]\n${parts.join('\n---\n')}`;
+}
+//# sourceMappingURL=skills-loader.js.map

package/dist/skills-loader.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernel.chat/kbot",
-  "version": "3.6.1",
+  "version": "3.7.0",
   "description": "The only AI agent that builds its own tools. Self-evolving terminal AI: 290 tools, 23 agents, 20 providers. Runtime tool forging via forge_tool, Forge Registry for community tools, autopoietic health monitoring, immune self-audit agent. Cost-aware model routing, fallback chains, Bayesian skill routing. Embedded llama.cpp, MCP server, programmatic SDK. MIT.",
   "type": "module",
   "repository": {