@kernel.chat/kbot 3.58.0 → 3.59.0

package/dist/integrations/ableton-live.js

@@ -0,0 +1,239 @@
+/**
+ * ableton-live.ts — kbot ↔ Ableton Live via AbletonOSC (UDP)
+ *
+ * Provides full Ableton control:
+ *   - Transport (play, stop, tempo)
+ *   - Tracks (create, name, volume, pan, mute, solo)
+ *   - Devices (load any instrument/effect by name)
+ *   - Clips (create, add notes, fire, stop)
+ *   - Mixing (volume, sends)
+ *   - Exec (arbitrary Python inside Ableton's runtime)
+ *
+ * Requires AbletonOSC installed: kbot ableton setup
+ */
+import * as dgram from 'node:dgram';
+import { Buffer } from 'node:buffer';
+const OSC_SEND_PORT = 11000;
+const OSC_RECV_PORT = 11001;
+const OSC_HOST = '127.0.0.1';
+// ── OSC Protocol ────────────────────────────────────────────────────────
+function oscEncode(addr, ...args) {
+    let addrBuf = Buffer.from(addr + '\0');
+    while (addrBuf.length % 4)
+        addrBuf = Buffer.concat([addrBuf, Buffer.alloc(1)]);
+    let typetag = ',';
+    const argBufs = [];
+    for (const a of args) {
+        if (typeof a === 'number' && Number.isInteger(a)) {
+            typetag += 'i';
+            const b = Buffer.alloc(4);
+            b.writeInt32BE(a);
+            argBufs.push(b);
+        }
+        else if (typeof a === 'number') {
+            typetag += 'f';
+            const b = Buffer.alloc(4);
+            b.writeFloatBE(a);
+            argBufs.push(b);
+        }
+        else {
+            typetag += 's';
+            let sb = Buffer.from(a + '\0');
+            while (sb.length % 4)
+                sb = Buffer.concat([sb, Buffer.alloc(1)]);
+            argBufs.push(sb);
+        }
+    }
+    let ttBuf = Buffer.from(typetag + '\0');
+    while (ttBuf.length % 4)
+        ttBuf = Buffer.concat([ttBuf, Buffer.alloc(1)]);
+    return Buffer.concat([addrBuf, ttBuf, ...argBufs]);
+}
+function oscParse(data) {
+    const end = data.indexOf(0);
+    const address = data.subarray(0, end).toString();
+    let pos = end + 1;
+    while (pos % 4)
+        pos++;
+    const args = [];
+    if (pos < data.length && data[pos] === 0x2c) { // ','
+        const tagEnd = data.indexOf(0, pos);
+        const tags = data.subarray(pos + 1, tagEnd).toString();
+        pos = tagEnd + 1;
+        while (pos % 4)
+            pos++;
+        for (const t of tags) {
+            if (t === 'i') {
+                args.push(data.readInt32BE(pos));
+                pos += 4;
+            }
+            else if (t === 'f') {
+                args.push(Math.round(data.readFloatBE(pos) * 10000) / 10000);
+                pos += 4;
+            }
+            else if (t === 's') {
+                const sEnd = data.indexOf(0, pos);
+                args.push(data.subarray(pos, sEnd).toString());
+                pos = sEnd + 1;
+                while (pos % 4)
+                    pos++;
+            }
+        }
+    }
+    return { address, args };
+}
+// ── AbletonLive Client ──────────────────────────────────────────────────
+export class AbletonLive {
+    static instance = null;
+    socket = null;
+    connected = false;
+    static getInstance() {
+        if (!AbletonLive.instance) {
+            AbletonLive.instance = new AbletonLive();
+        }
+        return AbletonLive.instance;
+    }
+    async connect() {
+        if (this.connected && this.socket)
+            return true;
+        return new Promise((resolve) => {
+            this.socket = dgram.createSocket('udp4');
+            this.socket.bind(OSC_RECV_PORT, OSC_HOST, () => {
+                // Test connection with tempo query
+                this.query('/live/song/get/tempo')
+                    .then(r => {
+                    this.connected = r.args.length > 0;
+                    resolve(this.connected);
+                })
+                    .catch(() => {
+                    this.connected = false;
+                    resolve(false);
+                });
+            });
+            this.socket.on('error', () => {
+                this.connected = false;
+                resolve(false);
+            });
+            setTimeout(() => {
+                if (!this.connected)
+                    resolve(false);
+            }, 5000);
+        });
+    }
+    disconnect() {
+        this.socket?.close();
+        this.socket = null;
+        this.connected = false;
+    }
+    get isConnected() {
+        return this.connected;
+    }
+    /** Send OSC message, no response expected. */
+    send(addr, ...args) {
+        if (!this.socket)
+            return;
+        this.socket.send(oscEncode(addr, ...args), OSC_SEND_PORT, OSC_HOST);
+    }
+    /** Send OSC message and wait for response. */
+    async query(addr, ...args) {
+        return new Promise((resolve, reject) => {
+            if (!this.socket)
+                return reject(new Error('Not connected'));
+            // Flush pending messages
+            this.socket.removeAllListeners('message');
+            const timer = setTimeout(() => {
+                reject(new Error('Timeout'));
+            }, 10000);
+            this.socket.once('message', (msg) => {
+                clearTimeout(timer);
+                resolve(oscParse(msg));
+            });
+            this.socket.send(oscEncode(addr, ...args), OSC_SEND_PORT, OSC_HOST);
+        });
+    }
+    // ── Convenience Methods ─────────────────────────────────────────────
+    async getTempo() {
+        const r = await this.query('/live/song/get/tempo');
+        return r.args[0];
+    }
+    setTempo(bpm) {
+        this.send('/live/song/set/tempo', bpm);
+    }
+    play() { this.send('/live/song/start_playing'); }
+    stop() { this.send('/live/song/stop_playing'); }
+    async getTrackCount() {
+        const r = await this.query('/live/song/get/num_tracks');
+        return r.args[0];
+    }
+    async createMidiTrack(name) {
+        this.send('/live/song/create_midi_track', -1);
+        await new Promise(r => setTimeout(r, 400));
+        const count = await this.getTrackCount();
+        const trackIdx = count - 2;
+        this.send('/live/track/set/name', trackIdx, name);
+        return trackIdx;
+    }
+    async loadDevice(track, searchTerm) {
+        const r = await this.query('/live/track/load/device', track, searchTerm);
+        return r.args[1] || 'unknown';
+    }
+    setVolume(track, volume) {
+        this.send('/live/track/set/volume', track, volume);
+    }
+    async createClip(track, slot, length, name) {
+        this.send('/live/clip_slot/create_clip', track, slot, length);
+        await new Promise(r => setTimeout(r, 300));
+        this.send('/live/clip/set/name', track, slot, name);
+    }
+    addNote(track, slot, pitch, start, duration, velocity) {
+        this.send('/live/clip/add/notes', track, slot, pitch, start, duration, velocity, 0);
+    }
+    fireClip(track, slot) {
+        this.send('/live/clip_slot/fire', track, slot);
+    }
+    /** Execute arbitrary Python in Ableton's runtime. */
+    async exec(code) {
+        const r = await this.query('/live/exec', code);
+        return r.args[0] || '';
+    }
+    /** Delete all tracks for a clean slate. */
+    async clearAllTracks() {
+        const count = await this.getTrackCount();
+        for (let t = count - 2; t >= 0; t--) {
+            this.send('/live/song/delete_track', t);
+            await new Promise(r => setTimeout(r, 120));
+        }
+        await new Promise(r => setTimeout(r, 500));
+    }
+    /** Get all track names and devices. */
+    async getSessionInfo() {
+        const count = await this.getTrackCount();
+        const tracks = [];
+        for (let t = 0; t < count - 1; t++) {
+            const nameR = await this.query('/live/track/get/name', t);
+            const devR = await this.query('/live/track/get/devices/name', t);
+            tracks.push({
+                index: t,
+                name: nameR.args[1] || `Track ${t}`,
+                devices: devR.args.slice(1),
+            });
+        }
+        return tracks;
+    }
+}
+// ── Convenience export ──────────────────────────────────────────────────
+export async function ensureAbleton() {
+    const live = AbletonLive.getInstance();
+    if (live.isConnected)
+        return live;
+    const ok = await live.connect();
+    if (!ok) {
+        throw new Error('Cannot connect to Ableton Live via AbletonOSC.\n\n' +
+            'Make sure:\n' +
+            '1. Ableton Live is running\n' +
+            '2. AbletonOSC is enabled in Preferences > Link, Tempo & MIDI > Control Surface\n' +
+            '3. Run `kbot ableton setup` if AbletonOSC is not installed\n');
+    }
+    return live;
+}
+//# sourceMappingURL=ableton-live.js.map

package/dist/integrations/ableton-live.js.map

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

package/dist/integrations/ableton-osc-installer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ableton-osc-installer.ts — Install and patch AbletonOSC for kbot control
+ *
+ * Installs AbletonOSC remote script into Ableton's User Library,
+ * patches it with kbot extensions (device loading, Python exec),
+ * and provides setup instructions.
+ *
+ * Usage: kbot ableton setup
+ */
+export declare function installAbletonOSC(): Promise<string>;
+export declare function isAbletonOSCInstalled(): boolean;
+export declare function isKbotPatched(): boolean;
+//# sourceMappingURL=ableton-osc-installer.d.ts.map

package/dist/integrations/ableton-osc-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ableton-osc-installer.d.ts","sourceRoot":"","sources":["../../src/integrations/ableton-osc-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6GH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CA+EzD;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAG/C;AAED,wBAAgB,aAAa,IAAI,OAAO,CAKvC"}

package/dist/integrations/ableton-osc-installer.js

@@ -0,0 +1,190 @@
+/**
+ * ableton-osc-installer.ts — Install and patch AbletonOSC for kbot control
+ *
+ * Installs AbletonOSC remote script into Ableton's User Library,
+ * patches it with kbot extensions (device loading, Python exec),
+ * and provides setup instructions.
+ *
+ * Usage: kbot ableton setup
+ */
+import { execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+const REPO_URL = 'https://github.com/ideoforms/AbletonOSC.git';
+function getAbletonUserLibrary() {
+    const home = os.homedir();
+    return path.join(home, 'Music', 'Ableton', 'User Library', 'Remote Scripts', 'AbletonOSC');
+}
+function getAbletonPrefsDir() {
+    const home = os.homedir();
+    const prefsBase = path.join(home, 'Library', 'Preferences', 'Ableton');
+    if (!fs.existsSync(prefsBase))
+        return [];
+    return fs.readdirSync(prefsBase)
+        .filter(d => d.startsWith('Live'))
+        .map(d => path.join(prefsBase, d))
+        .sort()
+        .reverse();
+}
+/**
+ * The kbot patch for AbletonOSC's song.py — adds device loading via browser API.
+ */
+const DEVICE_LOADER_PATCH = `
+        #--------------------------------------------------------------------------------
+        # kbot: Load device onto track by browser search
+        # /live/track/load/device <track_index> <search_term>
+        #--------------------------------------------------------------------------------
+        def track_load_device(params):
+            try:
+                track_index = int(params[0])
+                search_term = str(params[1]).lower()
+                track = self.song.tracks[track_index]
+                self.song.view.selected_track = track
+                browser = self.manager.application.browser
+
+                found = None
+                def search_recursive(item, term, depth=0):
+                    nonlocal found
+                    if found or depth > 5: return
+                    try:
+                        for child in item.children:
+                            if term in child.name.lower():
+                                if child.is_loadable:
+                                    src = str(child.source) if hasattr(child, 'source') else ''
+                                    if 'UAD' not in src:
+                                        found = child
+                                        return
+                                search_recursive(child, term, depth + 1)
+                            else:
+                                search_recursive(child, term, depth + 1)
+                    except: pass
+
+                for root in [browser.plugins, browser.instruments, browser.audio_effects,
+                             browser.midi_effects, browser.max_for_live, browser.drums]:
+                    try:
+                        search_recursive(root, search_term)
+                        if found: break
+                    except: continue
+
+                if found:
+                    browser.load_item(found)
+                    self.logger.info("kbot: Loaded device: %s" % found.name)
+                    return (1, found.name)
+                else:
+                    return (0, "not found")
+            except Exception as e:
+                return (0, str(e))
+        self.osc_server.add_handler("/live/track/load/device", track_load_device)
+`;
+/**
+ * The kbot patch for AbletonOSC's device.py — adds Python exec for deep control.
+ */
+const EXEC_PATCH = `
+        #--------------------------------------------------------------------------------
+        # kbot: Execute Python in Ableton's runtime
+        # /live/exec <code_string>
+        #--------------------------------------------------------------------------------
+        def live_exec(params):
+            code = str(params[0])
+            try:
+                result = eval(code, {
+                    'song': self.song,
+                    'app': self.manager.application,
+                    'Live': __import__('Live'),
+                    'tracks': self.song.tracks,
+                })
+                return (str(result),)
+            except SyntaxError:
+                local_vars = {
+                    'song': self.song,
+                    'app': self.manager.application,
+                    'Live': __import__('Live'),
+                    'tracks': self.song.tracks,
+                    '_result': None,
+                }
+                exec(code, local_vars)
+                return (str(local_vars.get('_result', 'ok')),)
+            except Exception as e:
+                return ("ERROR: " + str(e),)
+        self.osc_server.add_handler("/live/exec", live_exec)
+`;
+export async function installAbletonOSC() {
+    const destDir = getAbletonUserLibrary();
+    const tmpDir = path.join(os.tmpdir(), 'kbot-abletonosc');
+    const lines = [];
+    const log = (msg) => { lines.push(msg); console.log(msg); };
+    log('Installing AbletonOSC for kbot...');
+    // Clone or update
+    if (fs.existsSync(tmpDir)) {
+        fs.rmSync(tmpDir, { recursive: true });
+    }
+    try {
+        execSync(`git clone --depth 1 ${REPO_URL} "${tmpDir}"`, { stdio: 'pipe' });
+        log('  Cloned AbletonOSC');
+    }
+    catch {
+        log('  ERROR: Could not clone AbletonOSC. Check internet connection.');
+        return lines.join('\n');
+    }
+    // Apply kbot patches
+    const songPy = path.join(tmpDir, 'abletonosc', 'song.py');
+    const devicePy = path.join(tmpDir, 'abletonosc', 'device.py');
+    if (fs.existsSync(songPy)) {
+        let content = fs.readFileSync(songPy, 'utf8');
+        // Insert device loader before Scene properties section
+        content = content.replace('        # Callbacks for Song: Scene properties', DEVICE_LOADER_PATCH + '\n        # Callbacks for Song: Scene properties');
+        fs.writeFileSync(songPy, content);
+        log('  Patched song.py with device loader');
+    }
+    if (fs.existsSync(devicePy)) {
+        let content = fs.readFileSync(devicePy, 'utf8');
+        // Append exec handler at the end of init_api
+        const lastHandler = content.lastIndexOf('self.osc_server.add_handler');
+        if (lastHandler !== -1) {
+            const insertPos = content.indexOf('\n', lastHandler) + 1;
+            content = content.slice(0, insertPos) + EXEC_PATCH + content.slice(insertPos);
+        }
+        fs.writeFileSync(devicePy, content);
+        log('  Patched device.py with exec handler');
+    }
+    // Copy to Ableton User Library
+    const parentDir = path.dirname(destDir);
+    if (!fs.existsSync(parentDir)) {
+        fs.mkdirSync(parentDir, { recursive: true });
+    }
+    if (fs.existsSync(destDir)) {
+        fs.rmSync(destDir, { recursive: true });
+    }
+    fs.cpSync(tmpDir, destDir, { recursive: true });
+    log(`  Installed to ${destDir}`);
+    // Clean up
+    fs.rmSync(tmpDir, { recursive: true });
+    log('');
+    log('AbletonOSC installed with kbot extensions.');
+    log('');
+    log('To activate:');
+    log('  1. Open Ableton Live');
+    log('  2. Preferences (Cmd+,) > Link, Tempo & MIDI');
+    log('  3. Set a Control Surface to "AbletonOSC"');
+    log('  4. Close Preferences');
+    log('');
+    log('kbot commands available after activation:');
+    log('  kbot ableton status     — Check connection');
+    log('  kbot ableton session    — Build a session from a prompt');
+    log('  kbot ableton load       — Load any device onto a track');
+    log('  kbot ableton preset     — Create Serum 2 presets');
+    return lines.join('\n');
+}
+export function isAbletonOSCInstalled() {
+    const destDir = getAbletonUserLibrary();
+    return fs.existsSync(path.join(destDir, '__init__.py'));
+}
+export function isKbotPatched() {
+    const songPy = path.join(getAbletonUserLibrary(), 'abletonosc', 'song.py');
+    if (!fs.existsSync(songPy))
+        return false;
+    const content = fs.readFileSync(songPy, 'utf8');
+    return content.includes('track_load_device');
+}
+//# sourceMappingURL=ableton-osc-installer.js.map

package/dist/integrations/ableton-osc-installer.js.map

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

package/dist/learning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"learning.d.ts","sourceRoot":"","sources":["../src/learning.ts"],"names":[],"mappings":"AAiEA,mFAAmF;AACnF,wBAAgB,kBAAkB,IAAI,IAAI,CA+BzC;AAOD,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAA;CACvB;AAmBD,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAUzD;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAgCjE;AAED,kCAAkC;AAClC,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,GAAE,MAAU,GACtB,IAAI,CA8BN;AAED,8BAA8B;AAC9B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAQ1D;AAQD,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB;AAID,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,GAAG,cAAc,EAAE,CAoCvF;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CA4BtE;AAMD,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,aAAa,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAA;IAC9C,4CAA4C;IAC5C,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAA;IAC3B,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAiBD,wBAAgB,UAAU,IAAI,WAAW,CAExC;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,IAAI,CAsCP;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAQD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2C5D;AAKD,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,QAAQ,IAAI,aAAa,CAiBxC;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAWpD;AAOD,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,QAAQ,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;IAChE,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,uDAAuD;IACvD,MAAM,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,CAAA;IAChD,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc;IACd,OAAO,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAID,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAc,CAAC,UAAU,CAAU,EAAE,MAAM,GAAE,cAAc,CAAC,QAAQ,CAAiB,GAAG,IAAI,CAsC7I;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,GAAG,cAAc,EAAE,CAgCvF;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CA6CrF;AAMD,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAA;IACnB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAID,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAyBjF;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAU,GAAG,UAAU,EAAE,CAkBrF;AAMD,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IACZ,qBAAqB;IACrB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,yCAAyC;IACzC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAA;CACrB;AAID,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAOlE;AAED,iCAAiC;AACjC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IACrD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GAAG,IAAI,CA0CP;AAKD,uEAAuE;AAGvE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAkF9E;AAMD,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,EAAE,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,IAAI,CA6BN;AAWD,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAUD,uFAAuF;AACvF,wBAAgB,SAAS,IAAI;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB,CA+HA;AAED,yEAAyE;AACzE,wBAAgB,eAAe,IAAI,OAAO,CAMzC;AAED,mCAAmC;AACnC,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAGD,wBAAgB,gBAAgB,IAAI,aAAa,GAAG;IAClD,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB,CAYA"}
+{"version":3,"file":"learning.d.ts","sourceRoot":"","sources":["../src/learning.ts"],"names":[],"mappings":"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"}

package/dist/learning.js

@@ -8,6 +8,12 @@
 // 3. USER PROFILE — Learn user preferences, style, and common workflows
 //
 // Everything persists to ~/.kbot/memory/ as JSON files.
+//
+// CONCURRENCY NOTE: Module-level state (patterns, solutions, profile, etc.) is
+// intentionally shared across concurrent requests in `kbot serve` mode — learning
+// data is cumulative and global. All mutation functions are synchronous, so they
+// cannot interleave in Node.js's single-threaded event loop. The debounced saveJSON
+// writer coalesces concurrent writes. selfTrain() uses a guard to prevent overlapping runs.
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { existsSync, readFileSync, writeFileSync, writeFile, mkdirSync } from 'node:fs';
@@ -704,8 +710,22 @@ let trainingLog = loadJSON(TRAINING_FILE, {
     insightsSynthesized: 0,
     patternsOptimized: 0,
 });
+/** Guard to prevent overlapping selfTrain runs in serve mode */
+let selfTrainRunning = false;
 /** Run self-training: prune stale knowledge, optimize patterns, synthesize insights */
 export function selfTrain() {
+    if (selfTrainRunning) {
+        return { pruned: 0, optimized: 0, synthesized: 0, summary: 'Self-training already in progress — skipped.' };
+    }
+    selfTrainRunning = true;
+    try {
+        return selfTrainInner();
+    }
+    finally {
+        selfTrainRunning = false;
+    }
+}
+function selfTrainInner() {
     let pruned = 0;
     let optimized = 0;
     let synthesized = 0;