kagent-ts 0.1.3 → 0.1.5

package/dist/memory/memory-manager.js

@@ -0,0 +1,334 @@
+"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.MemoryManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const boundaries_1 = require("../security/boundaries");
+// ─── Limits ──────────────────────────────────────────────────────────────────
+const MAX_INDEX_LINES = 200;
+const MAX_INDEX_BYTES = 25 * 1024; // 25 KB
+// ─── MemoryManager ────────────────────────────────────────────────────────────
+/**
+ * Long-term memory manager (index + individual files).
+ *
+ * Storage layout:
+ * ```
+ * .memory/
+ *   MEMORY.md          ← index (200 lines + 25 KB dual limit)
+ *   <name>.md          ← individual memory files with frontmatter
+ * ```
+ *
+ * Usage:
+ * ```ts
+ * const mem = new MemoryManager({ storageDir: ".memory" });
+ * mem.add({ name: "use-kebab-case", description: "File naming convention",
+ *           type: "rule", content: "...why and when..." });
+ * // Later: inject into system prompt
+ * const hint = mem.buildPromptHint();
+ * ```
+ */
+class MemoryManager {
+    index = [];
+    storageDir;
+    indexFile;
+    lastLoadedMtime = 0;
+    constructor(storageDir) {
+        this.storageDir = path.resolve(storageDir ?? ".memory");
+        this.indexFile = path.join(this.storageDir, "MEMORY.md");
+        this.ensureDir();
+        this.loadIndex();
+    }
+    // ─── Write ──────────────────────────────────────────────────────────────
+    /**
+     * Add or update a memory entry.
+     *
+     * If a memory with the same `name` already exists it is overwritten.
+     * When the index exceeds the 200-line / 25 KB limit, the oldest entries
+     * are silently removed to make room.
+     */
+    add(memory) {
+        // Write individual file
+        const filePath = this.memoryPath(memory.name);
+        const fileContent = this.formatFile(memory);
+        fs.writeFileSync(filePath, fileContent, "utf-8");
+        // Update in-memory index (upsert)
+        const existing = this.index.findIndex((e) => e.name === memory.name);
+        const entry = {
+            name: memory.name,
+            description: memory.description,
+            type: memory.type,
+        };
+        if (existing >= 0) {
+            this.index[existing] = entry;
+        }
+        else {
+            this.index.push(entry);
+        }
+        // Prune oldest if over limits
+        this.pruneIfNeeded();
+        this.persistIndex();
+    }
+    /**
+     * Remove a memory by name.
+     */
+    remove(name) {
+        const idx = this.index.findIndex((e) => e.name === name);
+        if (idx === -1)
+            return false;
+        try {
+            fs.unlinkSync(this.memoryPath(name));
+        }
+        catch { /* already gone */ }
+        this.index.splice(idx, 1);
+        this.persistIndex();
+        return true;
+    }
+    // ─── Read ───────────────────────────────────────────────────────────────
+    /**
+     * Check if a memory exists by name.
+     */
+    has(name) {
+        return this.index.some((e) => e.name === name);
+    }
+    /**
+     * Get a single memory by name (loads full content from disk).
+     */
+    get(name) {
+        const entry = this.index.find((e) => e.name === name);
+        if (!entry)
+            return null;
+        return this.loadFile(name);
+    }
+    /**
+     * Get all memories (loads full content from disk).
+     */
+    getAll() {
+        const results = [];
+        for (const e of this.index) {
+            const m = this.loadFile(e.name);
+            if (m)
+                results.push(m);
+        }
+        return results;
+    }
+    /**
+     * Get memories by type.
+     */
+    getByType(type) {
+        return this.getAll().filter((m) => m.type === type);
+    }
+    /**
+     * Total number of memories.
+     */
+    get count() {
+        return this.index.length;
+    }
+    // ─── Prompt Injection ───────────────────────────────────────────────────
+    /**
+     * Build a compact system-prompt hint listing memory names + type badges.
+     *
+     * Full content is loaded on demand via the `recall` tool, keeping the
+     * system prompt lean. Each line is ~50 chars so the full index of 200
+     * entries stays under ~2500 tokens.
+     *
+     * The content is LLM-generated (via the `remember` tool), so it is
+     * wrapped with {@link wrapUntrusted} boundary markers and scanned for
+     * prompt-injection signatures before being returned. This prevents
+     * the LLM from accidentally poisoning its own system prompt via
+     * memory names.
+     */
+    buildPromptHint() {
+        if (this.index.length === 0)
+            return "";
+        const names = this.index.map((e) => `- ${e.name} (\`${e.type}\`)`);
+        const body = "## Long-Term Memories (" +
+            this.index.length +
+            " entries — use the `recall` tool to load full content)\n" +
+            names.join("\n");
+        // Scan for prompt-injection signatures in LLM-generated content.
+        // Memory names and descriptions are authored by the LLM via the
+        // `remember` tool — they could contain injection text that would
+        // poison future runs when re-injected into the system prompt.
+        const patterns = (0, boundaries_1.detectInjectionSignatures)(body);
+        const warning = (0, boundaries_1.buildInjectionWarning)(patterns, "memory index");
+        // Wrap as untrusted data (LLM-authored, not user-authored)
+        const wrapped = (0, boundaries_1.wrapUntrusted)("memory-index", body);
+        return "\n\n" + warning + wrapped;
+    }
+    /**
+     * Re-read the MEMORY.md index from disk if it was modified since the
+     * last load. Returns true when a reload occurred.
+     *
+     * Individual memory files are NOT reloaded — the index is lightweight,
+     * and full memory content is fetched on demand via the `recall` tool.
+     */
+    reloadIfChanged() {
+        try {
+            const stat = fs.statSync(this.indexFile);
+            if (stat.mtimeMs === this.lastLoadedMtime)
+                return false;
+            this.lastLoadedMtime = stat.mtimeMs;
+            const raw = fs.readFileSync(this.indexFile, "utf-8");
+            this.index = this.parseIndex(raw);
+            return true;
+        }
+        catch {
+            this.lastLoadedMtime = 0;
+            this.index = [];
+            return true; // file was deleted — prompt needs updating
+        }
+    }
+    // ─── Persistence ────────────────────────────────────────────────────────
+    memoryPath(name) {
+        return path.join(this.storageDir, `${name}.md`);
+    }
+    ensureDir() {
+        if (!fs.existsSync(this.storageDir)) {
+            fs.mkdirSync(this.storageDir, { recursive: true });
+        }
+    }
+    formatFile(memory) {
+        return [
+            "---",
+            `name: ${memory.name}`,
+            `description: ${memory.description}`,
+            `type: ${memory.type}`,
+            "---",
+            "",
+            memory.content,
+        ].join("\n");
+    }
+    loadFile(name) {
+        try {
+            const raw = fs.readFileSync(this.memoryPath(name), "utf-8");
+            return this.parseFile(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    parseFile(raw) {
+        const match = raw.match(/^---\n([\s\S]*?)\n---\n\n([\s\S]*)$/);
+        if (!match)
+            return null;
+        const frontmatter = {};
+        for (const line of match[1].split("\n")) {
+            const kv = line.match(/^(\w+):\s*(.+)$/);
+            if (kv)
+                frontmatter[kv[1]] = kv[2];
+        }
+        const name = frontmatter["name"];
+        const description = frontmatter["description"];
+        const type = frontmatter["type"];
+        const content = match[2];
+        if (!name || !description || !type)
+            return null;
+        if (type !== "rule" && type !== "project")
+            return null;
+        return { name, description, type, content };
+    }
+    // ─── Index Persistence ──────────────────────────────────────────────────
+    persistIndex() {
+        const lines = [];
+        for (const e of this.index) {
+            const line = `- [${e.name}](${e.name}.md) — ${e.description}`;
+            lines.push(line);
+        }
+        const content = lines.join("\n") + (lines.length > 0 ? "\n" : "");
+        fs.writeFileSync(this.indexFile, content, "utf-8");
+    }
+    loadIndex() {
+        try {
+            const stat = fs.statSync(this.indexFile);
+            this.lastLoadedMtime = stat.mtimeMs;
+            const raw = fs.readFileSync(this.indexFile, "utf-8");
+            this.index = this.parseIndex(raw);
+        }
+        catch {
+            this.lastLoadedMtime = 0;
+            this.index = [];
+        }
+    }
+    parseIndex(raw) {
+        const entries = [];
+        const lines = raw.split("\n");
+        for (const line of lines) {
+            const match = line.match(/^- \[(.+?)\]\((.+?)\.md\) — (.+)$/);
+            if (!match)
+                continue;
+            const name = match[1];
+            const description = match[3];
+            // Infer type from the individual file (fallback to "project" if unreadable)
+            const type = this.inferType(name);
+            entries.push({ name, description, type });
+        }
+        return entries;
+    }
+    inferType(name) {
+        const m = this.loadFile(name);
+        return m?.type ?? "project";
+    }
+    // ─── Limit Enforcement ──────────────────────────────────────────────────
+    /**
+     * Silently remove the oldest entries until both the line and byte limits
+     * are satisfied. Index entries are ordered oldest-first, so we shift from
+     * the front until the computed index content fits.
+     */
+    pruneIfNeeded() {
+        let raw = this.buildIndexContent();
+        let lines = raw.split("\n").length;
+        let bytes = Buffer.byteLength(raw, "utf-8");
+        while (this.index.length > 0 && (lines > MAX_INDEX_LINES || bytes > MAX_INDEX_BYTES)) {
+            const removed = this.index.pop();
+            try {
+                fs.unlinkSync(this.memoryPath(removed.name));
+            }
+            catch { /* ok */ }
+            raw = this.buildIndexContent();
+            lines = raw.split("\n").length;
+            bytes = Buffer.byteLength(raw, "utf-8");
+        }
+    }
+    buildIndexContent() {
+        const lines = [];
+        for (const e of this.index) {
+            lines.push(`- [${e.name}](${e.name}.md) — ${e.description}`);
+        }
+        return lines.join("\n") + (lines.length > 0 ? "\n" : "");
+    }
+}
+exports.MemoryManager = MemoryManager;
+//# sourceMappingURL=memory-manager.js.map

package/dist/memory/memory-manager.js.map

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

package/dist/messages/types.d.ts

@@ -27,5 +27,7 @@ export interface MessageData {
     name?: string;
     tool_call_id?: string;
     tool_calls?: ToolCall[];
+    /** Unix timestamp in milliseconds when the message was recorded. */
+    timestamp?: number;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/messages/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,IAAI;IACd,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/messages/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,IAAI;IACd,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/orchestrator/index.d.ts

@@ -0,0 +1,5 @@
+export { OrchestratorAgent } from "./orchestrator-agent";
+export type { OrchestratorAgentConfig } from "./orchestrator-agent";
+export type { TaskNode, TaskNodeStatus, TaskGraph, OrchestrationPlan, SynthesisResult, AdaptResult, OrchestratorSessionState, } from "./orchestrator-types";
+export { parseDecomposeResponse, parseSynthesizeResponse, parseAdaptResponse, buildDecomposePrompt, buildSynthesizePrompt, buildAdaptPrompt, } from "./orchestrator-response";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestrator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC"}

package/dist/orchestrator/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAdaptPrompt = exports.buildSynthesizePrompt = exports.buildDecomposePrompt = exports.parseAdaptResponse = exports.parseSynthesizeResponse = exports.parseDecomposeResponse = exports.OrchestratorAgent = void 0;
+var orchestrator_agent_1 = require("./orchestrator-agent");
+Object.defineProperty(exports, "OrchestratorAgent", { enumerable: true, get: function () { return orchestrator_agent_1.OrchestratorAgent; } });
+var orchestrator_response_1 = require("./orchestrator-response");
+Object.defineProperty(exports, "parseDecomposeResponse", { enumerable: true, get: function () { return orchestrator_response_1.parseDecomposeResponse; } });
+Object.defineProperty(exports, "parseSynthesizeResponse", { enumerable: true, get: function () { return orchestrator_response_1.parseSynthesizeResponse; } });
+Object.defineProperty(exports, "parseAdaptResponse", { enumerable: true, get: function () { return orchestrator_response_1.parseAdaptResponse; } });
+Object.defineProperty(exports, "buildDecomposePrompt", { enumerable: true, get: function () { return orchestrator_response_1.buildDecomposePrompt; } });
+Object.defineProperty(exports, "buildSynthesizePrompt", { enumerable: true, get: function () { return orchestrator_response_1.buildSynthesizePrompt; } });
+Object.defineProperty(exports, "buildAdaptPrompt", { enumerable: true, get: function () { return orchestrator_response_1.buildAdaptPrompt; } });
+//# sourceMappingURL=index.js.map

package/dist/orchestrator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestrator/index.ts"],"names":[],"mappings":";;;AAAA,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAW1B,iEAOiC;AAN/B,+HAAA,sBAAsB,OAAA;AACtB,gIAAA,uBAAuB,OAAA;AACvB,2HAAA,kBAAkB,OAAA;AAClB,6HAAA,oBAAoB,OAAA;AACpB,8HAAA,qBAAqB,OAAA;AACrB,yHAAA,gBAAgB,OAAA"}

package/dist/orchestrator/json-extractor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared JSON extraction utility.
+ *
+ * Extracts a JSON object string from LLM output that may contain markdown
+ * fences, surrounding prose, or minor formatting issues.
+ *
+ * This is a copy of the logic in src/core/response-schema.ts kept here to
+ * avoid a circular dependency (response-schema.ts imports system-prompt
+ * fragments that the orchestrator does not need).
+ */
+/**
+ * Try to extract a JSON object from a string that may contain
+ * markdown, extra text, malformed newlines, or other noise.
+ *
+ * Returns the JSON string if found, or null.
+ */
+export declare function extractJSON(text: string): string | null;
+//# sourceMappingURL=json-extractor.d.ts.map

package/dist/orchestrator/json-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-extractor.d.ts","sourceRoot":"","sources":["../../src/orchestrator/json-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBvD"}

package/dist/orchestrator/json-extractor.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Shared JSON extraction utility.
+ *
+ * Extracts a JSON object string from LLM output that may contain markdown
+ * fences, surrounding prose, or minor formatting issues.
+ *
+ * This is a copy of the logic in src/core/response-schema.ts kept here to
+ * avoid a circular dependency (response-schema.ts imports system-prompt
+ * fragments that the orchestrator does not need).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractJSON = extractJSON;
+/**
+ * Try to extract a JSON object from a string that may contain
+ * markdown, extra text, malformed newlines, or other noise.
+ *
+ * Returns the JSON string if found, or null.
+ */
+function extractJSON(text) {
+    if (!text)
+        return null;
+    // Try with progressively more aggressive cleanup
+    const variants = [
+        text.trim(),
+        cleanupJSON(text.trim()),
+        text.trim().replace(/\n/g, " ").replace(/\r/g, ""),
+    ];
+    // De-duplicate variants
+    const seen = new Set();
+    const uniqueVariants = variants.filter((v) => {
+        if (seen.has(v))
+            return false;
+        seen.add(v);
+        return true;
+    });
+    for (const variant of uniqueVariants) {
+        const result = tryExtractJSON(variant);
+        if (result)
+            return result;
+    }
+    return null;
+}
+function tryExtractJSON(text) {
+    if (isValidJSON(text))
+        return text;
+    // Try extracting from markdown code blocks: ```json ... ```
+    const blockMatch = text.match(/```(?:json)?\s*(\{[\s\S]*?\})\s*```/);
+    if (blockMatch && isValidJSON(blockMatch[1]))
+        return blockMatch[1];
+    // Try finding the first { ... } with balanced braces
+    const braceStart = text.indexOf("{");
+    if (braceStart >= 0) {
+        const fromBrace = text.slice(braceStart);
+        const result = extractBalancedBraces(fromBrace);
+        if (result)
+            return result;
+    }
+    return null;
+}
+function extractBalancedBraces(text) {
+    let depth = 0;
+    let inString = false;
+    let escapeNext = false;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (inString) {
+            if (escapeNext) {
+                escapeNext = false;
+            }
+            else if (ch === "\\") {
+                escapeNext = true;
+            }
+            else if (ch === '"') {
+                inString = false;
+            }
+        }
+        else {
+            if (ch === '"') {
+                inString = true;
+                escapeNext = false;
+            }
+            else if (ch === "{") {
+                depth++;
+            }
+            else if (ch === "}") {
+                depth--;
+                if (depth === 0) {
+                    const candidate = text.slice(0, i + 1);
+                    if (isValidJSON(candidate))
+                        return candidate;
+                    break;
+                }
+            }
+        }
+    }
+    return null;
+}
+function cleanupJSON(text) {
+    return text.replace(/\r\n/g, "\n").replace(/\r/g, "");
+}
+function isValidJSON(text) {
+    try {
+        JSON.parse(text);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=json-extractor.js.map

package/dist/orchestrator/json-extractor.js.map

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