@monoes/monomindcli 1.11.12 → 1.11.14

package/dist/src/agents/trigger-scanner.js

@@ -0,0 +1,308 @@
+/**
+ * Trigger Scanner (Task 32)
+ *
+ * Scans task descriptions against compiled trigger patterns
+ * from agent frontmatter and returns matches.
+ *
+ * - Patterns are tested in descending priority order.
+ * - A `takeover` match short-circuits: only that agent is returned.
+ * - `inject` matches accumulate as additional candidates.
+ * - Invalid regex patterns are silently skipped.
+ */
+import { readFileSync, readdirSync, lstatSync, statSync, realpathSync } from 'fs';
+import { join, extname, resolve, sep } from 'path';
+export class TriggerScanner {
+    compiled = [];
+    patterns = [];
+    totalAgentsScanned = 0;
+    buildingIndex = false;
+    constructor(patterns = []) {
+        for (const p of patterns) {
+            this.compileAndAdd(p);
+        }
+        this.sortByPriority();
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    /**
+     * Test all patterns against `taskDescription` and return matches.
+     *
+     * Patterns are tested in descending priority order.
+     * If a `takeover` pattern matches, scanning stops immediately
+     * and only that agent is returned.
+     */
+    scan(taskDescription) {
+        const matches = [];
+        for (const { source, regex } of this.compiled) {
+            // Reset lastIndex in case the regex has the global flag
+            regex.lastIndex = 0;
+            const m = regex.exec(taskDescription);
+            if (!m)
+                continue;
+            const match = {
+                agentSlug: source.agentSlug,
+                pattern: source.pattern,
+                mode: source.mode,
+                matchedText: m[0],
+            };
+            if (source.mode === 'takeover') {
+                // Short-circuit: return only this agent
+                return [match];
+            }
+            matches.push(match);
+        }
+        return matches;
+    }
+    /**
+     * Build an index by scanning agent markdown files under `agentDir`.
+     *
+     * Reads each `.md` file, extracts YAML frontmatter, and looks for
+     * `triggers:` entries with `pattern`, `mode`, and optional `priority`.
+     */
+    buildIndex(agentDir, allowedRoot) {
+        if (this.buildingIndex) {
+            throw new Error('buildIndex is already running; concurrent invocations are not safe');
+        }
+        this.buildingIndex = true;
+        try {
+            return this._buildIndex(agentDir, allowedRoot);
+        }
+        finally {
+            this.buildingIndex = false;
+        }
+    }
+    _buildIndex(agentDir, allowedRoot) {
+        if (allowedRoot) {
+            let resolvedDir;
+            let resolvedRoot;
+            try {
+                resolvedDir = realpathSync(resolve(agentDir));
+            }
+            catch {
+                resolvedDir = resolve(agentDir);
+            }
+            try {
+                resolvedRoot = realpathSync(resolve(allowedRoot));
+            }
+            catch {
+                resolvedRoot = resolve(allowedRoot);
+            }
+            if (!resolvedDir.startsWith(resolvedRoot + sep) && resolvedDir !== resolvedRoot) {
+                throw new Error(`Agent directory escapes workspace: ${resolvedDir}`);
+            }
+        }
+        const mdFiles = this.collectMdFiles(agentDir);
+        this.patterns = [];
+        this.compiled = [];
+        this.totalAgentsScanned = mdFiles.length;
+        const MAX_AGENT_FILE_BYTES = 1 * 1024 * 1024;
+        for (const filePath of mdFiles) {
+            let content;
+            try {
+                if (statSync(filePath).size > MAX_AGENT_FILE_BYTES)
+                    continue;
+                content = readFileSync(filePath, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const slug = this.slugFromPath(filePath);
+            const triggers = this.extractTriggers(content, slug);
+            for (const t of triggers) {
+                this.compileAndAdd(t);
+            }
+        }
+        this.sortByPriority();
+        return {
+            patterns: [...this.patterns],
+            builtAt: new Date().toISOString(),
+            totalAgentsScanned: this.totalAgentsScanned,
+        };
+    }
+    /** Add a pattern to the index at runtime. */
+    addPattern(pattern) {
+        this.compileAndAdd(pattern);
+        this.sortByPriority();
+    }
+    /**
+     * Remove a specific pattern for an agent.
+     * Returns `true` if the pattern was found and removed.
+     */
+    removePattern(agentSlug, pattern) {
+        const idx = this.patterns.findIndex((p) => p.agentSlug === agentSlug && p.pattern === pattern);
+        if (idx === -1)
+            return false;
+        this.patterns.splice(idx, 1);
+        this.compiled.splice(idx, 1);
+        return true;
+    }
+    /** Return a snapshot of the current index. */
+    getIndex() {
+        return {
+            patterns: [...this.patterns],
+            builtAt: new Date().toISOString(),
+            totalAgentsScanned: this.totalAgentsScanned,
+        };
+    }
+    /** Number of compiled patterns. */
+    get size() {
+        return this.compiled.length;
+    }
+    // ---------------------------------------------------------------------------
+    // Internal helpers
+    // ---------------------------------------------------------------------------
+    compileAndAdd(pattern) {
+        if (pattern.pattern.length > 200)
+            return;
+        // Reject patterns with nested/repeated quantifiers (ReDoS vectors)
+        // Covers: (a+)+, (a|b+)+, (a?){n}, ((a)+)+, [a-z]+{n}
+        if (/(\(.*[+*?].*\)|[+*?]){2,}|\{[0-9,]+\}.*[+*?]|(\[[^\]]*\]|\.)[+*?][+*?]/.test(pattern.pattern))
+            return;
+        if (/\([^)]*([+*][^)]*){2,}\)/.test(pattern.pattern))
+            return;
+        try {
+            const regex = new RegExp(pattern.pattern, 'i');
+            this.patterns.push(pattern);
+            this.compiled.push({ source: pattern, regex });
+        }
+        catch {
+            // Invalid regex — skip silently
+        }
+    }
+    sortByPriority() {
+        // Sort both arrays in-sync by descending priority
+        const indexed = this.patterns.map((p, i) => ({ p, c: this.compiled[i], priority: p.priority }));
+        indexed.sort((a, b) => b.priority - a.priority);
+        this.patterns = indexed.map((x) => x.p);
+        this.compiled = indexed.map((x) => x.c);
+    }
+    /** Recursively collect `.md` files (symlinks skipped, visited inodes tracked). */
+    collectMdFiles(dir, visited = new Set()) {
+        const results = [];
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return results;
+        }
+        for (const entry of entries) {
+            const full = join(dir, entry);
+            let lstat;
+            try {
+                lstat = lstatSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (lstat.isSymbolicLink())
+                continue;
+            if (lstat.isDirectory()) {
+                if (visited.has(lstat.ino))
+                    continue;
+                visited.add(lstat.ino);
+                results.push(...this.collectMdFiles(full, visited));
+            }
+            else if (lstat.isFile() && extname(entry) === '.md') {
+                results.push(full);
+            }
+        }
+        return results;
+    }
+    /** Derive slug from filename. */
+    slugFromPath(filePath) {
+        const base = filePath.split('/').pop() ?? '';
+        return base
+            .replace(/\.md$/i, '')
+            .toLowerCase()
+            .replace(/\s+/g, '-')
+            .replace(/[^a-z0-9-]/g, '');
+    }
+    /**
+     * Extract trigger definitions from markdown frontmatter.
+     *
+     * Looks for a YAML block between `---` markers, then finds lines like:
+     *   - pattern: "\\b(auth|jwt)\\b"
+     *     mode: "inject"
+     *     priority: 10
+     */
+    extractTriggers(content, agentSlug) {
+        const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+        if (!fmMatch)
+            return [];
+        const block = fmMatch[1];
+        const triggers = [];
+        // Find trigger blocks: lines starting with "- pattern:" under a triggers: section
+        const lines = block.split('\n');
+        let inTriggers = false;
+        let currentTrigger = null;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Measure leading whitespace to distinguish top-level keys from nested props
+            const indent = line.length - line.trimStart().length;
+            if (trimmed === 'triggers:' || trimmed.startsWith('triggers:')) {
+                inTriggers = true;
+                continue;
+            }
+            // Exit triggers section when we hit a non-indented top-level key (indent 0)
+            if (inTriggers && indent === 0 && /^[a-zA-Z]/.test(trimmed)) {
+                inTriggers = false;
+                if (currentTrigger?.pattern) {
+                    triggers.push(this.finalizeTrigger(currentTrigger, agentSlug));
+                }
+                currentTrigger = null;
+                continue;
+            }
+            if (!inTriggers)
+                continue;
+            // New list item
+            if (trimmed.startsWith('- pattern:')) {
+                if (currentTrigger?.pattern) {
+                    triggers.push(this.finalizeTrigger(currentTrigger, agentSlug));
+                }
+                currentTrigger = {
+                    pattern: this.extractYamlValue(trimmed.replace(/^- pattern:\s*/, '')),
+                    agentSlug,
+                };
+            }
+            else if (currentTrigger && trimmed.startsWith('mode:')) {
+                const val = this.extractYamlValue(trimmed.replace(/^mode:\s*/, ''));
+                if (val === 'inject' || val === 'takeover') {
+                    currentTrigger.mode = val;
+                }
+            }
+            else if (currentTrigger && trimmed.startsWith('priority:')) {
+                const val = parseInt(trimmed.replace(/^priority:\s*/, ''), 10);
+                if (!isNaN(val)) {
+                    currentTrigger.priority = val;
+                }
+            }
+        }
+        // Flush last trigger
+        if (currentTrigger?.pattern) {
+            triggers.push(this.finalizeTrigger(currentTrigger, agentSlug));
+        }
+        return triggers;
+    }
+    finalizeTrigger(partial, agentSlug) {
+        return {
+            pattern: partial.pattern,
+            mode: partial.mode ?? 'inject',
+            priority: partial.priority ?? 0,
+            agentSlug,
+        };
+    }
+    extractYamlValue(raw) {
+        let v = raw.trim();
+        if (v.startsWith('"') && v.endsWith('"')) {
+            // YAML double-quoted: unescape \\ → \ so "\\b" becomes \b (word boundary)
+            v = v.slice(1, -1).replace(/\\\\/g, '\\');
+        }
+        else if (v.startsWith("'") && v.endsWith("'")) {
+            v = v.slice(1, -1);
+        }
+        return v;
+    }
+}
+//# sourceMappingURL=trigger-scanner.js.map

package/dist/src/agents/trigger-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-scanner.js","sourceRoot":"","sources":["../../../src/agents/trigger-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAanD,MAAM,OAAO,cAAc;IACjB,QAAQ,GAAsB,EAAE,CAAC;IACjC,QAAQ,GAAqB,EAAE,CAAC;IAChC,kBAAkB,GAAG,CAAC,CAAC;IACvB,aAAa,GAAG,KAAK,CAAC;IAE9B,YAAY,WAA6B,EAAE;QACzC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E;;;;;;OAMG;IACH,IAAI,CAAC,eAAuB;QAC1B,MAAM,OAAO,GAAmB,EAAE,CAAC;QAEnC,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9C,wDAAwD;YACxD,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACtC,IAAI,CAAC,CAAC;gBAAE,SAAS;YAEjB,MAAM,KAAK,GAAiB;gBAC1B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;aAClB,CAAC;YAEF,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC/B,wCAAwC;gBACxC,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,QAAgB,EAAE,WAAoB;QAC/C,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,QAAgB,EAAE,WAAoB;QACxD,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,WAAmB,CAAC;YACxB,IAAI,YAAoB,CAAC;YACzB,IAAI,CAAC;gBAAC,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YAAC,CAAC;YACjG,IAAI,CAAC;gBAAC,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;YAAC,CAAC;YACzG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,YAAY,GAAG,GAAG,CAAC,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;gBAChF,MAAM,IAAI,KAAK,CAAC,sCAAsC,WAAW,EAAE,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;QAEzC,MAAM,oBAAoB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;QAC7C,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;YAC/B,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,oBAAoB;oBAAE,SAAS;gBAC7D,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACrD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,OAAO;YACL,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5B,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACjC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;SAC5C,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,UAAU,CAAC,OAAuB;QAChC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,SAAiB,EAAE,OAAe;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAC1D,CAAC;QACF,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAE7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8CAA8C;IAC9C,QAAQ;QACN,OAAO;YACL,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5B,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACjC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;SAC5C,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,8EAA8E;IAC9E,mBAAmB;IACnB,8EAA8E;IAEtE,aAAa,CAAC,OAAuB;QAC3C,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG;YAAE,OAAO;QACzC,mEAAmE;QACnE,sDAAsD;QACtD,IAAI,wEAAwE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO;QAC3G,IAAI,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO;QAE7D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IAEO,cAAc;QACpB,kDAAkD;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAChG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,kFAAkF;IAC1E,cAAc,CAAC,GAAW,EAAE,UAAU,IAAI,GAAG,EAAU;QAC7D,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC;YACV,IAAI,CAAC;gBACH,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,KAAK,CAAC,cAAc,EAAE;gBAAE,SAAS;YACrC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;oBAAE,SAAS;gBACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YACtD,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;gBACtD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,iCAAiC;IACzB,YAAY,CAAC,QAAgB;QACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAC7C,OAAO,IAAI;aACR,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;aACrB,WAAW,EAAE;aACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;aACpB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;OAOG;IACK,eAAe,CAAC,OAAe,EAAE,SAAiB;QACxD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAExB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,QAAQ,GAAqB,EAAE,CAAC;QAEtC,kFAAkF;QAClF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,cAAc,GAAmC,IAAI,CAAC;QAE1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,6EAA6E;YAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;YAErD,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/D,UAAU,GAAG,IAAI,CAAC;gBAClB,SAAS;YACX,CAAC;YAED,4EAA4E;YAC5E,IAAI,UAAU,IAAI,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5D,UAAU,GAAG,KAAK,CAAC;gBACnB,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;oBAC5B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;gBACjE,CAAC;gBACD,cAAc,GAAG,IAAI,CAAC;gBACtB,SAAS;YACX,CAAC;YAED,IAAI,CAAC,UAAU;gBAAE,SAAS;YAE1B,gBAAgB;YAChB,IAAI,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBACrC,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;oBAC5B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;gBACjE,CAAC;gBACD,cAAc,GAAG;oBACf,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;oBACrE,SAAS;iBACV,CAAC;YACJ,CAAC;iBAAM,IAAI,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzD,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;gBACpE,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;oBAC3C,cAAc,CAAC,IAAI,GAAG,GAAG,CAAC;gBAC5B,CAAC;YACH,CAAC;iBAAM,IAAI,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7D,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChB,cAAc,CAAC,QAAQ,GAAG,GAAG,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,eAAe,CAAC,OAAgC,EAAE,SAAiB;QACzE,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAQ;YACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,QAAQ;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;YAC/B,SAAS;SACV,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,GAAW;QAClC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACnB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,0EAA0E;YAC1E,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAChD,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

package/dist/src/agents/version-diff.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Agent Version Diff Utility (Task 29)
+ *
+ * Computes a simple unified-style diff between two content strings.
+ */
+export interface LineDiffResult {
+    additions: number;
+    deletions: number;
+    hunks: string;
+}
+/**
+ * Compute a unified diff between two content strings.
+ *
+ * Uses a simple line-by-line LCS-based approach to produce
+ * addition/deletion counts and a unified-style hunk string.
+ */
+export declare function computeUnifiedDiff(oldContent: string, newContent: string): LineDiffResult;
+//# sourceMappingURL=version-diff.d.ts.map

package/dist/src/agents/version-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-diff.d.ts","sourceRoot":"","sources":["../../../src/agents/version-diff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,cAAc,CA0DhB"}

package/dist/src/agents/version-diff.js

@@ -0,0 +1,64 @@
+/**
+ * Agent Version Diff Utility (Task 29)
+ *
+ * Computes a simple unified-style diff between two content strings.
+ */
+/**
+ * Compute a unified diff between two content strings.
+ *
+ * Uses a simple line-by-line LCS-based approach to produce
+ * addition/deletion counts and a unified-style hunk string.
+ */
+export function computeUnifiedDiff(oldContent, newContent) {
+    const oldLines = oldContent.split('\n');
+    const newLines = newContent.split('\n');
+    // Simple LCS to find common subsequence
+    const m = oldLines.length;
+    const n = newLines.length;
+    // Build LCS table
+    const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (oldLines[i - 1] === newLines[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+            }
+        }
+    }
+    // Backtrack to produce diff lines
+    const diffLines = [];
+    let additions = 0;
+    let deletions = 0;
+    let i = m;
+    let j = n;
+    const result = [];
+    while (i > 0 || j > 0) {
+        if (i > 0 && j > 0 && oldLines[i - 1] === newLines[j - 1]) {
+            result.push({ type: ' ', line: oldLines[i - 1] });
+            i--;
+            j--;
+        }
+        else if (j > 0 && (i === 0 || dp[i][j - 1] >= dp[i - 1][j])) {
+            result.push({ type: '+', line: newLines[j - 1] });
+            additions++;
+            j--;
+        }
+        else {
+            result.push({ type: '-', line: oldLines[i - 1] });
+            deletions++;
+            i--;
+        }
+    }
+    result.reverse();
+    for (const entry of result) {
+        diffLines.push(`${entry.type} ${entry.line}`);
+    }
+    return {
+        additions,
+        deletions,
+        hunks: diffLines.join('\n'),
+    };
+}
+//# sourceMappingURL=version-diff.js.map

package/dist/src/agents/version-diff.js.map

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

package/dist/src/agents/version-store.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Agent Version Store (Task 29)
+ *
+ * JSONL-based append-only storage for agent definition versions.
+ * Supports save, list, get, rollback, and diff operations.
+ */
+import type { AgentVersionRecord, DiffResult } from '../../../shared/src/types/agent-version.js';
+/**
+ * JSONL-based agent version store.
+ *
+ * Each slug's versions are stored in `<dirPath>/versions.jsonl`, one JSON
+ * object per line.  Rollback rewrites the file to update `isCurrent` flags.
+ */
+export declare class AgentVersionStore {
+    private readonly dirPath;
+    private readonly filePath;
+    constructor(dirPath: string);
+    private readAll;
+    private writeAll;
+    /**
+     * Save a new version for the given agent slug.
+     *
+     * Computes a SHA-256 hash of the content, marks all previous versions for
+     * the same slug as non-current, and appends the new record.
+     */
+    saveVersion(slug: string, content: string, version: string, changelog: string, opts?: {
+        deprecated?: boolean;
+        deprecatedBy?: string;
+        capturedBy?: string;
+    }): AgentVersionRecord;
+    /**
+     * List all versions for a slug, sorted by capturedAt DESC (newest first).
+     * Uses insertion order (line index) as a stable tiebreaker.
+     */
+    listVersions(slug: string): AgentVersionRecord[];
+    /**
+     * Get the current active version for a slug, or null.
+     */
+    getCurrent(slug: string): AgentVersionRecord | null;
+    /**
+     * Get a specific version by slug and semver string, or null.
+     */
+    getVersion(slug: string, version: string): AgentVersionRecord | null;
+    /**
+     * Roll back to a specific version.
+     *
+     * Marks the target version as current and all others for that slug as
+     * non-current.  Rewrites the JSONL file.
+     *
+     * @throws Error if the target version does not exist.
+     */
+    rollback(slug: string, toVersion: string): AgentVersionRecord;
+    /**
+     * Compute a line-level diff between two versions of the same agent.
+     *
+     * @throws Error if either version does not exist.
+     */
+    diff(slug: string, fromVersion: string, toVersion: string): DiffResult;
+}
+//# sourceMappingURL=version-store.d.ts.map

package/dist/src/agents/version-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-store.d.ts","sourceRoot":"","sources":["../../../src/agents/version-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,4CAA4C,CAAC;AAsDjG;;;;;GAKG;AACH,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEL,OAAO,EAAE,MAAM;IAW5C,OAAO,CAAC,OAAO;IAmCf,OAAO,CAAC,QAAQ;IAWhB;;;;;OAKG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;QACJ,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KAChB,GACL,kBAAkB;IAoCrB;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAchD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAgBnD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAQpE;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB;IAyB7D;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU;CA4BvE"}