@kernel.chat/kbot 2.20.4 → 2.22.0

package/dist/strange-loops.js

@@ -0,0 +1,199 @@
+// K:BOT Strange Loops — Self-Referential Cognition
+//
+// Based on Douglas Hofstadter's Strange Loops (GEB, 1979; I Am a Strange Loop, 2007):
+// Consciousness arises from a "strange loop" — a self-referential cycle where
+// a system at one level of abstraction can refer to and modify itself at
+// another level. The "I" emerges from tangled hierarchies.
+//
+// For kbot: detect when the agent is reasoning about its own reasoning,
+// when tool outputs change the agent's understanding of itself, and
+// when hierarchical levels collapse into self-reference.
+//
+// This is the meta-cognition layer — kbot watching kbot think.
+//
+// References:
+//   - Hofstadter, D.R. (1979). Gödel, Escher, Bach: An Eternal Golden Braid.
+//   - Hofstadter, D.R. (2007). I Am a Strange Loop.
+//   - Hofstadter, D.R. & Dennett, D.C. (1981). The Mind's I.
+/** Patterns that indicate self-referential reasoning */
+const SELF_REFERENCE_PATTERNS = [
+    // Agent reasoning about its own capabilities
+    /\b(i can|i cannot|i don't know|my (abilities|capabilities|tools|limitations))\b/i,
+    // Agent reasoning about its own reasoning
+    /\b(my (reasoning|approach|strategy|analysis)|i (think|believe|predict|expect) (that )?i)\b/i,
+    // Agent modifying its own behavior
+    /\b(i (should|will|need to) (change|adjust|modify|update) (my|the) (approach|strategy))\b/i,
+    // Agent evaluating its own output
+    /\b(my (previous|last|earlier) (response|output|answer)|let me (reconsider|rethink|re-evaluate))\b/i,
+    // Meta-level: reasoning about the system
+    /\b(this (tool|agent|system)|the (agent|system) (is|should|can))\b/i,
+];
+/** Patterns indicating tangled hierarchies */
+const TANGLE_PATTERNS = [
+    // Tool result changes tool selection
+    { pattern: /tool.*(result|output).*(change|select|choose).*tool/i, levels: ['tool-execution', 'tool-selection'] },
+    // Output modifies the prompt that generated it
+    { pattern: /\b(update|modify|change).*(prompt|instruction|system)/i, levels: ['output', 'input'] },
+    // Agent evaluates the agent
+    { pattern: /\b(evaluate|assess|audit|test).*(agent|kbot|itself)/i, levels: ['evaluator', 'evaluated'] },
+    // Code that modifies the code
+    { pattern: /\b(self|auto).*(modify|evolve|improve|upgrade|update)/i, levels: ['code', 'meta-code'] },
+];
+/**
+ * Strange Loop Detector — monitors self-referential cognition
+ * and meta-cognitive depth.
+ *
+ * When kbot reasons about its own reasoning, that's a strange loop.
+ * When kbot modifies its own behavior based on self-evaluation,
+ * that's a tangled hierarchy. This module makes those moments visible.
+ */
+export class StrangeLoopDetector {
+    selfReferences = [];
+    tangledHierarchies = [];
+    metaDepth = 0;
+    selfModelAccuracy = 0.5;
+    // Track what the agent "thinks it's doing" vs. what it's actually doing
+    declaredIntents = [];
+    actualActions = [];
+    /**
+     * Analyze a message or response for self-referential content.
+     * Returns any self-references found.
+     */
+    analyze(content, source) {
+        if (source === 'user')
+            return [];
+        const found = [];
+        for (const pattern of SELF_REFERENCE_PATTERNS) {
+            if (pattern.test(content)) {
+                const sourceLevel = this.metaDepth === 0 ? 'task' :
+                    this.metaDepth === 1 ? 'reasoning' :
+                        this.metaDepth === 2 ? 'meta-reasoning' : 'self-model';
+                // Self-reference goes one level up
+                const targetLevel = sourceLevel === 'task' ? 'reasoning' :
+                    sourceLevel === 'reasoning' ? 'meta-reasoning' : 'self-model';
+                const ref = {
+                    sourceLevel,
+                    targetLevel,
+                    description: content.slice(0, 100),
+                    isStrangeLoop: sourceLevel !== 'task', // Only strange if crossing hierarchy
+                    timestamp: Date.now(),
+                };
+                found.push(ref);
+                this.selfReferences.push(ref);
+            }
+        }
+        // Update meta-depth
+        if (found.length > 0) {
+            this.metaDepth = Math.min(3, this.metaDepth + 1);
+        }
+        else {
+            this.metaDepth = Math.max(0, this.metaDepth - 1);
+        }
+        // Check for tangled hierarchies
+        for (const tangle of TANGLE_PATTERNS) {
+            if (tangle.pattern.test(content)) {
+                this.tangledHierarchies.push({
+                    levels: tangle.levels,
+                    description: content.slice(0, 100),
+                    depth: this.metaDepth,
+                });
+            }
+        }
+        return found;
+    }
+    /**
+     * Record what the agent says it intends to do.
+     * Used to measure self-model accuracy.
+     */
+    recordIntent(intent) {
+        this.declaredIntents.push(intent.toLowerCase());
+        if (this.declaredIntents.length > 20)
+            this.declaredIntents.shift();
+    }
+    /**
+     * Record what the agent actually did.
+     */
+    recordAction(action) {
+        this.actualActions.push(action.toLowerCase());
+        if (this.actualActions.length > 20)
+            this.actualActions.shift();
+        // Update self-model accuracy
+        this.updateSelfModelAccuracy();
+    }
+    /**
+     * Compute how well the agent knows itself.
+     * Compares declared intents to actual actions.
+     */
+    updateSelfModelAccuracy() {
+        if (this.declaredIntents.length === 0 || this.actualActions.length === 0)
+            return;
+        const n = Math.min(this.declaredIntents.length, this.actualActions.length);
+        let matches = 0;
+        for (let i = 0; i < n; i++) {
+            const intentWords = new Set(this.declaredIntents[this.declaredIntents.length - 1 - i]?.split(/\s+/) || []);
+            const actionWords = new Set(this.actualActions[this.actualActions.length - 1 - i]?.split(/\s+/) || []);
+            if (intentWords.size === 0 || actionWords.size === 0)
+                continue;
+            const overlap = [...intentWords].filter(w => actionWords.has(w)).length;
+            if (overlap / Math.max(intentWords.size, actionWords.size) > 0.3) {
+                matches++;
+            }
+        }
+        this.selfModelAccuracy = n > 0 ? matches / n : 0.5;
+    }
+    /**
+     * Is the agent currently in a strange loop?
+     * Returns true if meta-depth >= 2 (reasoning about reasoning).
+     */
+    inStrangeLoop() {
+        return this.metaDepth >= 2;
+    }
+    /**
+     * Should the agent break out of self-reference and return to task?
+     * Too much meta-reasoning is as bad as too little.
+     */
+    shouldGroundItself() {
+        // If stuck in deep self-reference for too long
+        if (this.metaDepth >= 3)
+            return true;
+        // If recent self-references are circular (same pattern repeating)
+        const recent = this.selfReferences.slice(-5);
+        if (recent.length >= 5) {
+            const descriptions = recent.map(r => r.description);
+            const unique = new Set(descriptions);
+            if (unique.size <= 2)
+                return true; // Stuck in a loop
+        }
+        return false;
+    }
+    /**
+     * Get the grounding prompt — inject into the agent when it needs
+     * to break out of self-referential spirals.
+     */
+    getGroundingPrompt() {
+        return 'Focus on the concrete task at hand. What specific action should you take next? Avoid reasoning about your own reasoning — just act.';
+    }
+    /** Get full meta-cognitive state */
+    getState() {
+        const recentRefs = this.selfReferences.slice(-20);
+        const strangeLoops = recentRefs.filter(r => r.isStrangeLoop).length;
+        return {
+            isSelfReferential: this.metaDepth >= 1,
+            metaDepth: this.metaDepth,
+            strangeLoopsDetected: strangeLoops,
+            tangledHierarchies: this.tangledHierarchies.slice(-5),
+            selfModelAccuracy: this.selfModelAccuracy,
+            isReflective: this.metaDepth >= 2,
+        };
+    }
+    /** Reset for new conversation */
+    reset() {
+        this.selfReferences = [];
+        this.tangledHierarchies = [];
+        this.metaDepth = 0;
+        this.selfModelAccuracy = 0.5;
+        this.declaredIntents = [];
+        this.actualActions = [];
+    }
+}
+//# sourceMappingURL=strange-loops.js.map

package/dist/strange-loops.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kernel.chat/kbot",
-  "version": "2.20.4",
-  "description": "Universal AI agent for your terminal. 11 specialist agents, 214 tools, 20 providers. Embedded llama.cpp engine — runs GGUF models directly, no Ollama needed. Audit any repo, share conversations, contribute to open source. CSV/data tools, VFX, research, containers. Self-evolving, learns your patterns.",
+  "version": "2.22.0",
+  "description": "Universal AI agent for your terminal. 22 specialist agents, 223 tools, 20 providers. Embedded llama.cpp engine — runs GGUF models directly, no Ollama needed. Audit any repo, share conversations, contribute to open source. CSV/data tools, VFX, research, containers. Self-evolving, learns your patterns.",
   "type": "module",
   "repository": {
     "type": "git",