noormme 1.1.0 → 1.2.0

package/README.md

@@ -1,74 +1,83 @@
-![NOORMME: The Agentic Data Engine](/Users/bozoegg/.gemini/antigravity/brain/af239a4f-144c-41a9-b1c4-9d534b5243f8/noormme_hero_banner_1771742014638.png)
+# NOORMME: The Sovereign Agentic Data Engine
 
-# NOORMME: The Agentic Data Engine
+**NOORMME** is a sovereign persistence layer and cognitive operating system purpose-built for **Autonomous AI Agents**. It transcends legacy ORM patterns by providing a self-healing, evolutionary data infrastructure that functions as a high-fidelity extension of an agent's internal reasoning loop.
 
-**NOORMME** is a sovereign persistence layer and cognitive operating system designed for **Autonomous AI Agents**. It transcends legacy ORM patterns by providing a self-healing, evolutionary data infrastructure that functions as a high-fidelity extension of the agent's internal reasoning loop.
-
-[![Version](https://img.shields.io/npm/v/noormme.svg)](https://www.npmjs.com/package/noormme)
-[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![Cognitive](https://img.shields.io/badge/Intelligence-Autonomous_Governance-purple.svg)](./docs/agentic-intelligence.md)
-[![Evolution](https://img.shields.io/badge/Evolution-Ultra_Scale-blueviolet.svg)](./docs/ultra-scale-orchestration.md)
+[![Version](https://img.shields.io/npm/v/noormme.svg?style=flat-square&color=black)](https://www.npmjs.com/package/noormme)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square)](https://opensource.org/licenses/Apache-2.0)
+[![Storage](https://img.shields.io/badge/Storage-SQLite_%26_PostgreSQL-orange.svg?style=flat-square)](./docs/postgresql/POSTGRESQL_SUPPORT.md)
+[![Intelligence](https://img.shields.io/badge/Intelligence-Autonomous_Governance-purple.svg?style=flat-square)](./docs/agentic-intelligence.md)
+[![Scale](https://img.shields.io/badge/Scale-Ultra_Scale_Orchestration-blueviolet.svg?style=flat-square)](./docs/ultra-scale-orchestration.md)
 
 ---
 
-## 🧠 The Cognitive Loop
-
-NOORMME implements a closed-loop system where data is not merely "stored" but continuously distilled, questioned, and evolved. It turns your database into a living world model.
-
-```mermaid
-graph LR
-    A[Raw Ingestion] --> B{Distillation}
-    B --> C[Knowledge Base]
-    C --> D[Reasoning Engine]
-    D --> E[Action / Outcome]
-    E --> F{Reflection}
-    F -->|Success| G[Goal Reinforcement]
-    F -->|Failure| H[Strategic Mutation]
-    H --> B
-```
-
-### ✨ Advanced Orchestration
-- **🎭 Tiered Model Routing**: Optimize cost/performance by routing batch discovery to **Fast LLMs** and mutation logic to **Premium LLMs**.
-- **🔥 Predictive Pre-warming**: Background AI optimization of skills nearing promotion to eliminate cold-start latency.
-- **🌐 Goal Cross-Pollination**: Breakthroughs in individual persona mutations are automatically distilled into global **Systemic Best-Practices**.
-- **🌸 Bloom Filter Heuristics**: Ultra-scale knowledge de-duplication at 100x speed vs traditional DB hits.
+## 🏛️ The Sovereign Triad
 
----
+NOORMME is built on three architectural pillars that enable agents to move beyond simple storage into true cognitive autonomy.
 
-## 🧬 Evolutionary Infrastructure (DNA Inversion)
+### 1. 🧠 Cognitive Governance
+Turn your passive database into a living world model. NOORMME implements a closed-loop system where data is distilled, questioned, and evolved.
+- **Semantic Similarity**: Bigram engine for conflict detection.
+- **Curiosity Engine**: Bridges factual gaps and identifies anomalies.
+- **HiveLink**: Promotes local insights to global system wisdom.
 
-NOORMME allows agents to autonomously mutate their own structural DNA while maintaining 100% safety.
+### 2. 🧬 Evolutionary DNA
+Allow agents to autonomously mutate their own structural DNA while maintaining 100% safety.
+- **DNA Inversion**: Automatically generates inverse SQL for all autonomous DDL changes.
+- **Self-Healing Indexing**: Proactively optimizes schema based on observed query contexts.
+- **Strategic Mutation**: Sequential evolution loops with autonomous safety rollbacks.
 
-- **Dynamic DDL**: Agents can propose `CREATE TABLE`, `ADD COLUMN`, or `CREATE INDEX` mutations via the **Evolutionary Pilot**.
-- **Structural Rollback**: The **DNA Inverter** automatically generates inverse SQL for any DDL mutation to ensure safe structural experimentation.
-- **Meta-Meta Evolution**: A self-tuning system that modulates its own **Mutation Aggressiveness** and **Verification Windows** based on systemic success rates.
+### 3. 🚀 Ultra-Scale Orchestration
+Handle massive agentic workloads with high-throughput intelligence.
+- **Tiered Model Routing**: Route batch tasks to Fast LLMs and reasoning to Premium LLMs.
+- **Predictive Pre-warming**: Eliminates latency by optimizing skills in the background.
+- **Bloom Heuristics**: 100x faster fact de-duplication at the ingestion layer.
 
 ---
 
-## 🚥 Autonomous Governance
+## 🧠 The Cognitive Loop
 
-- **Self-Healing Indexing**: Proactively applies performance indexes based on the agent's own observation of "slow" query contexts.
-- **Conflict Resolution**: Scans cognitive rules for semantic overlaps and logical contradictions.
-- **Zombie Pruning**: Automatically identifies and removes deprecated or unused knowledge items.
-- **Z-Score Sensitivity**: Monitors for performance collapse (latency or success rate) and triggers emergency rollbacks.
+```mermaid
+graph TD
+    subgraph "Ingestion & Distillation"
+        A[Raw Ingestion] --> B{Bigram Distiller}
+    end
+    
+    subgraph "Internal Reasoning"
+        B --> C[Knowledge Base]
+        C --> D[Reasoning Engine]
+        D --> E[Action / Outcome]
+    end
+    
+    subgraph "Evolutionary Feedback"
+        E --> F{Cognitive Reflection}
+        F -->|Success| G[Goal Reinforcement]
+        F -->|Failure| H[DNA Inversion Reset]
+        H --> B
+        G --> I[HiveLink Promotion]
+        I --> B
+    end
+    
+    style B fill:#f9f,stroke:#333,stroke-width:2px
+    style D fill:#bbf,stroke:#333,stroke-width:2px
+    style F fill:#bfb,stroke:#333,stroke-width:2px
+```
 
 ---
 
-## 🚀 Getting Started
+## ⚡ Quick Start
 
 ### 1. Provision the Mind
-Initialize your database with a single line to provision 25+ agentic tables for goals, knowledge, episodes, and logic probes.
+Initialize a self-healing database in seconds. Supports SQLite (Local Cortex) and PostgreSQL (Neural Storage).
 
 ```typescript
 import { NOORMME } from 'noormme';
 
 const db = new NOORMME({
-  dialect: 'sqlite',
+  dialect: 'sqlite', // or 'postgresql'
   connection: { database: './mind.sqlite' },
   agentic: {
     llm: primaryModel,
-    llmFast: gpt4oMini,     // For high-throughput batching
-    llmPremium: claude35,  // For complex mutations
+    llmFast: gpt4oMini,
     enableSelfEvolution: true
   }
 });
@@ -76,7 +85,25 @@ const db = new NOORMME({
 await db.initialize();
 ```
 
-### 2. Strategic Interaction
+### 2. High-Fidelity Data Interaction
+Use the Django-style `objects` manager for sovereign data sifting.
+
+```typescript
+// Access a repository
+const agentRepo = db.getRepository('agents');
+
+// Chainable query logic
+const activeAgents = await agentRepo.objects
+  .filter({ status: 'active', is_verified: true })
+  .exclude({ type: 'temporary' })
+  .order_by('-last_active')
+  .limit(10)
+  .all();
+```
+
+### 3. Autonomous Evolution
+Challenge the system with new evidence and let it evolve.
+
 ```typescript
 const cortex = db.agent.cortex;
 
@@ -89,30 +116,22 @@ await cortex.knowledge.challengeKnowledge('SystemArch', 'New audit results.', 0.
 
 ---
 
-## 🗄 Dialect Power Matrix
-
-| Feature | SQLite (Edge) | PostgreSQL (Enterprise) |
-| :--- | :--- | :--- |
-| **Search** | `sqlite-vss` / Fallback | `pgvector` / FTS |
-| **Logic** | In-Process Atomicity | Multi-Tenant Governance |
-| **Evolution** | Sequential Snapshotting | Clustered Mutation |
-| **Throughput** | Sequential Direct | Bloom-Heuristic Parallel |
-
----
+![NOORMME Banner](./assets/noormme_hero_banner.png)
 
-## 📚 Explore the Documentation
-Dive into our deep-dive guides to unlock the full potential of NOORMME:
+## 📚 Deep Dive Documentation
+Explore our comprehensive guides to unlock the full potential of your agents:
 
-- [**Ultra-Scale Orchestration**](./docs/ultra-scale-orchestration.md)
-- [**Strategic Evolution Guides**](./docs/strategic-evolution.md)
-- [**Skill Lifecycle & DNA**](./docs/skill-lifecycle.md)
-- [**Sovereign Meta-Evolution**](./docs/meta-evolution.md)
-- [**Agentic Intelligence Deep-Dive**](./docs/agentic-intelligence.md)
+- [**Full Documentation Index**](./docs/README.md) – Start here for the complete guide.
+- [**Agentic Intelligence**](./docs/agentic-intelligence.md) – Cognitive rules and governance.
+- [**PostgreSQL Neural Storage**](./docs/postgresql/POSTGRESQL_SUPPORT.md) – Enterprise-grade scaling and `pgvector`.
+- [**Ultra-Scale Orchestration**](./docs/ultra-scale-orchestration.md) – Massive scale patterns.
+- [**Strategic Evolution**](./docs/strategic-evolution.md) – DNA inversion and mutation.
+- [**Skill Lifecycle**](./docs/skill-lifecycle.md) – How agents learn and grow.
 
 ---
 
-## 🤝 Community & Contribution
-NOORMME is an Apache 2.0 open-source project. We invite AI researchers and data engineers to contribute to the future of autonomous persistence.
+## 🤝 Community
+NOORMME is an Apache 2.0 open-source project. We invite researchers to contribute to the future of autonomous persistence.
 
 [Contribution Guide](CONTRIBUTING.md) | [Security Audit](SECURITY.md)
 

package/dist/cjs/agentic/ActionJournal.js

@@ -31,7 +31,7 @@ class ActionJournal {
             tool_name: toolName,
             arguments: JSON.stringify(args),
             status: 'pending',
-            created_at: new Date()
+            created_at: new Date(),
         })
             .returningAll()
             .executeTakeFirstOrThrow();
@@ -52,7 +52,7 @@ class ActionJournal {
             status,
             outcome,
             duration_ms: durationMs || null,
-            metadata: metadata ? JSON.stringify(metadata) : null
+            metadata: metadata ? JSON.stringify(metadata) : null,
         })
             .where('id', '=', actionId)
             .returningAll()
@@ -76,7 +76,7 @@ class ActionJournal {
             .where('session_id', '=', sessionId)
             .orderBy('created_at', 'asc')
             .execute();
-        return actions.map(a => this.parseAction(a));
+        return actions.map((a) => this.parseAction(a));
     }
     /**
      * Get actions by tool name across all sessions.
@@ -89,7 +89,7 @@ class ActionJournal {
             .orderBy('created_at', 'desc')
             .limit(limit)
             .execute();
-        return actions.map(a => this.parseAction(a));
+        return actions.map((a) => this.parseAction(a));
     }
     /**
      * Generate a report of tool failures.
@@ -100,7 +100,7 @@ class ActionJournal {
             .select([
             'tool_name',
             (eb) => eb.fn.count('id').as('failureCount'),
-            (eb) => eb.fn.max('created_at').as('lastFailure')
+            (eb) => eb.fn.max('created_at').as('lastFailure'),
         ])
             .where('status', '=', 'failure')
             .groupBy('tool_name')
@@ -109,7 +109,7 @@ class ActionJournal {
         return results.map((r) => ({
             toolName: r.tool_name,
             failureCount: Number(r.failureCount),
-            lastFailure: r.lastFailure
+            lastFailure: r.lastFailure,
         }));
     }
     parseAction(action) {
@@ -118,12 +118,16 @@ class ActionJournal {
             sessionId: action.session_id,
             messageId: action.message_id,
             toolName: action.tool_name,
-            arguments: typeof action.arguments === 'string' ? JSON.parse(action.arguments) : (action.arguments || {}),
+            arguments: typeof action.arguments === 'string'
+                ? JSON.parse(action.arguments)
+                : action.arguments || {},
             status: action.status,
             outcome: action.outcome,
             durationMs: action.duration_ms,
-            metadata: typeof action.metadata === 'string' ? JSON.parse(action.metadata) : (action.metadata || {}),
-            createdAt: new Date(action.created_at)
+            metadata: typeof action.metadata === 'string'
+                ? JSON.parse(action.metadata)
+                : action.metadata || {},
+            createdAt: new Date(action.created_at),
         };
     }
 }

package/dist/cjs/agentic/CapabilityManager.js

@@ -21,7 +21,7 @@ class CapabilityManager {
             rollbackThresholdZ: config.evolution?.rollbackThresholdZ ?? 2.5,
             enableHiveLink: config.evolution?.enableHiveLink ?? true,
             mutationAggressiveness: config.evolution?.mutationAggressiveness ?? 0.5,
-            maxSandboxSkills: config.evolution?.maxSandboxSkills ?? 5
+            maxSandboxSkills: config.evolution?.maxSandboxSkills ?? 5,
         };
     }
     get typedDb() {
@@ -44,8 +44,11 @@ class CapabilityManager {
                     .set({
                     description: description || existing.description,
                     status: existing.status || 'experimental',
-                    metadata: JSON.stringify({ ...JSON.parse(existing.metadata || '{}'), ...metadata }),
-                    updated_at: new Date()
+                    metadata: JSON.stringify({
+                        ...JSON.parse(existing.metadata || '{}'),
+                        ...metadata,
+                    }),
+                    updated_at: new Date(),
                 })
                     .where('id', '=', existing.id)
                     .returningAll()
@@ -60,9 +63,13 @@ class CapabilityManager {
                 description: description || null,
                 status: metadata.initialStatus || 'experimental',
                 reliability: 1.0,
-                metadata: JSON.stringify({ ...metadata, successCount: 0, totalCount: 0 }),
+                metadata: JSON.stringify({
+                    ...metadata,
+                    successCount: 0,
+                    totalCount: 0,
+                }),
                 created_at: new Date(),
-                updated_at: new Date()
+                updated_at: new Date(),
             })
                 .returningAll()
                 .executeTakeFirstOrThrow();
@@ -83,7 +90,9 @@ class CapabilityManager {
                 .executeTakeFirst();
             if (capability) {
                 const cap = capability;
-                const metadata = typeof cap.metadata === 'string' ? JSON.parse(cap.metadata) : (cap.metadata || {});
+                const metadata = typeof cap.metadata === 'string'
+                    ? JSON.parse(cap.metadata)
+                    : cap.metadata || {};
                 const totalCount = (metadata.totalCount || 0) + 1;
                 const successCount = (metadata.successCount || 0) + (success ? 1 : 0);
                 // Damped moving average: weight recent outcomes more but keep history
@@ -102,34 +111,39 @@ class CapabilityManager {
                 const windowSize = this.evolutionConfig.verificationWindow || 20;
                 const minSampleSize = Math.ceil(windowSize * 0.75);
                 // Fast-Track Promotion: 5 consecutive successes bypasses sample size
-                const isPromotable = (totalCount >= minSampleSize && winRate >= 0.8) || (streakSuccess >= 5);
+                const isPromotable = (totalCount >= minSampleSize && winRate >= 0.8) || streakSuccess >= 5;
                 // Early-Exit Rollback: 3 consecutive failures at the start immediately blacklists
                 const isCatastrophic = !success && failureStreak >= 3 && totalCount <= 5;
                 // Pass 6: Predictive Pre-warming Trigger
                 // If a skill is close to promotion, pre-warm its optimized description
                 const promoThreshold = Math.ceil(minSampleSize * 0.8);
-                const isNearingPromotion = (totalCount >= promoThreshold && winRate >= 0.8) || (streakSuccess === 4);
-                if (isNearingPromotion && newStatus === 'experimental' && this.cortex.skillSynthesizer) {
+                const isNearingPromotion = (totalCount >= promoThreshold && winRate >= 0.8) ||
+                    streakSuccess === 4;
+                if (isNearingPromotion &&
+                    newStatus === 'experimental' &&
+                    this.cortex.skillSynthesizer) {
                     // Trigger async background pre-warming
                     this.cortex.skillSynthesizer.preWarmSkill(name).catch(() => { });
                 }
                 // --- Production Hardening: Dynamic Performance Baselining ---
                 const historyAlpha = 0.05; // Slower moving average for baseline
                 const baseline = metadata.performanceBaseline ?? winRate;
-                const newBaseline = (baseline * (1 - historyAlpha)) + (winRate * historyAlpha);
+                const newBaseline = baseline * (1 - historyAlpha) + winRate * historyAlpha;
                 // Variance tracking for Z-score calculation
                 const variance = metadata.performanceVariance ?? 0.01;
                 const diff = winRate - baseline;
-                const newVariance = (variance * (1 - historyAlpha)) + (Math.pow(diff, 2) * historyAlpha);
+                const newVariance = variance * (1 - historyAlpha) + Math.pow(diff, 2) * historyAlpha;
                 const stdDev = Math.sqrt(newVariance);
                 // Z-Score: How many standard deviations is current performance from baseline?
                 const zScore = stdDev > 0 ? (winRate - baseline) / stdDev : 0;
                 // Promotion/Demotion Logic
-                if (isCatastrophic && (newStatus === 'experimental' || newStatus === 'sandbox')) {
+                if (isCatastrophic &&
+                    (newStatus === 'experimental' || newStatus === 'sandbox')) {
                     console.error(`[CapabilityManager] Skill '${name}' FAILED early-exit safety check (Streak: ${failureStreak}). Blacklisting immediately.`);
                     newStatus = 'blacklisted';
                 }
-                else if (isPromotable && (newStatus === 'experimental' || newStatus === 'sandbox')) {
+                else if (isPromotable &&
+                    (newStatus === 'experimental' || newStatus === 'sandbox')) {
                     console.log(`[CapabilityManager] Skill '${name}' PASSED fast-track verification (Streak: ${streakSuccess}, Rate: ${(winRate * 100).toFixed(1)}%). Promoting to Verified.`);
                     newStatus = 'verified';
                 }
@@ -160,9 +174,9 @@ class CapabilityManager {
                         failureStreak,
                         performanceBaseline: newBaseline,
                         performanceVariance: newVariance,
-                        lastOutcomeType: success ? 'success' : 'failure' // Categorization point
+                        lastOutcomeType: success ? 'success' : 'failure', // Categorization point
                     }),
-                    updated_at: new Date()
+                    updated_at: new Date(),
                 })
                     .where('id', '=', cap.id)
                     .execute();
@@ -191,10 +205,8 @@ class CapabilityManager {
         if (status) {
             query = query.where('status', '=', status);
         }
-        const list = await query
-            .orderBy('name', 'asc')
-            .execute();
-        return list.map(c => this.parseCapability(c));
+        const list = await query.orderBy('name', 'asc').execute();
+        return list.map((c) => this.parseCapability(c));
     }
     parseCapability(cap) {
         return {
@@ -204,9 +216,11 @@ class CapabilityManager {
             description: cap.description,
             status: cap.status || 'experimental',
             reliability: cap.reliability,
-            metadata: typeof cap.metadata === 'string' ? JSON.parse(cap.metadata) : (cap.metadata || {}),
+            metadata: typeof cap.metadata === 'string'
+                ? JSON.parse(cap.metadata)
+                : cap.metadata || {},
             createdAt: new Date(cap.created_at),
-            updatedAt: new Date(cap.updated_at)
+            updatedAt: new Date(cap.updated_at),
         };
     }
 }

package/dist/cjs/agentic/CognitiveRepository.js

@@ -20,16 +20,18 @@ class CognitiveRepository {
      */
     async triggerRules(operation, data) {
         // Check if rules table exists to avoid errors during initialization
-        const rulesTable = this.cortex.config.agentic?.rulesTable || this.cortex.config.rulesTable || 'agent_rules';
+        const rulesTable = this.cortex.config.agentic?.rulesTable ||
+            this.cortex.config.rulesTable ||
+            'agent_rules';
         const tables = await this.cortex.db.introspection.getTables();
-        if (!tables.some(t => t.name === rulesTable)) {
+        if (!tables.some((t) => t.name === rulesTable)) {
             return data;
         }
         const result = await this.cortex.rules.evaluateRules(this.table.name, operation, data);
         if (result.action === 'deny') {
             throw new NoormError_js_1.NoormError(`Operation ${operation} on ${this.table.name} denied: ${result.reason}`, {
                 operation: 'cognitive_rule_enforcement',
-                suggestion: 'Check agent rules or adjust policy'
+                suggestion: 'Check agent rules or adjust policy',
             });
         }
         if (result.action === 'audit') {
@@ -37,7 +39,7 @@ class CognitiveRepository {
         }
         if (result.action === 'mask' && result.ruleId) {
             const rules = await this.cortex.rules.getActiveRules(this.table.name, operation);
-            const rule = rules.find(r => r.id === result.ruleId);
+            const rule = rules.find((r) => r.id === result.ruleId);
             if (rule) {
                 return this.cortex.rules.applyMasking(data, rule);
             }
@@ -57,10 +59,18 @@ class CognitiveRepository {
         return await this.repository.delete(id);
     }
     // Delegate other methods to the internal repository
-    async findById(id) { return this.repository.findById(id); }
-    async findAll() { return this.repository.findAll(); }
-    async count() { return this.repository.count(); }
-    async exists(id) { return this.repository.exists(id); }
+    async findById(id) {
+        return this.repository.findById(id);
+    }
+    async findAll() {
+        return this.repository.findAll();
+    }
+    async count() {
+        return this.repository.count();
+    }
+    async exists(id) {
+        return this.repository.exists(id);
+    }
     // Dynamic method delegation via Proxy
     static createProxy(repository, table, cortex) {
         const cognitive = new CognitiveRepository(repository, table, cortex);
@@ -70,7 +80,7 @@ class CognitiveRepository {
                     return cognitive[prop];
                 }
                 return Reflect.get(target, prop, receiver);
-            }
+            },
         });
     }
 }

package/dist/cjs/agentic/ContextBuffer.js

@@ -52,7 +52,7 @@ class ContextBuffer {
             msg: m,
             index,
             isAnchor: !!m.metadata?.anchor,
-            tokens: this.estimateTokens(m.content)
+            tokens: this.estimateTokens(m.content),
         }));
         const sortedForSelection = [...scored].sort((a, b) => {
             if (a.isAnchor !== b.isAnchor)
@@ -60,15 +60,18 @@ class ContextBuffer {
             return b.index - a.index; // Recency tie-breaker
         });
         const selected = new Set();
-        let currentTokens = systemMessage ? this.estimateTokens(systemMessage.content) : 0;
+        let currentTokens = systemMessage
+            ? this.estimateTokens(systemMessage.content)
+            : 0;
         for (const item of sortedForSelection) {
-            if (selected.size < effectiveLimit && (currentTokens + item.tokens) <= tokenLimit) {
+            if (selected.size < effectiveLimit &&
+                currentTokens + item.tokens <= tokenLimit) {
                 selected.add(item.msg);
                 currentTokens += item.tokens;
             }
         }
         // Maintain temporal order
-        const result = this.messages.filter(m => m === systemMessage || selected.has(m));
+        const result = this.messages.filter((m) => m === systemMessage || selected.has(m));
         return result;
     }
     /**
@@ -76,14 +79,14 @@ class ContextBuffer {
      */
     toPromptString(limit) {
         return this.getWindow({ maxMessages: limit })
-            .map(m => `[${m.role.toUpperCase()}]: ${m.content}`)
+            .map((m) => `[${m.role.toUpperCase()}]: ${m.content}`)
             .join('\n\n');
     }
     /**
      * Helper to identify if the buffer is becoming too large.
      */
     shouldSummarize(tokenThreshold) {
-        const threshold = tokenThreshold || (this.maxTokens * 0.8);
+        const threshold = tokenThreshold || this.maxTokens * 0.8;
         return this.getTotalTokens() > threshold;
     }
     /**
@@ -94,7 +97,7 @@ class ContextBuffer {
             messageCount: this.messages.length,
             totalTokens: this.getTotalTokens(),
             maxTokens: this.maxTokens,
-            maxMessages: this.maxMessages
+            maxMessages: this.maxMessages,
         };
     }
     getTotalTokens() {
@@ -107,28 +110,37 @@ class ContextBuffer {
             const initialCount = this.messages.length;
             // Importance Trimming: Prefer keeping 'anchor' messages or high-priority messages
             // We sort a copy to determine which ones to keep, then reconstruct in temporal order
-            const otherMessages = systemMessage ? this.messages.slice(1) : this.messages;
+            const otherMessages = systemMessage
+                ? this.messages.slice(1)
+                : this.messages;
             // Heuristic for importance: anchors > assistant > user (user input is often redundant if reflected/anchored)
             const sortedByImportance = [...otherMessages].sort((a, b) => {
                 const aIsAnchor = a.metadata?.anchor ? 1 : 0;
                 const bIsAnchor = b.metadata?.anchor ? 1 : 0;
                 if (aIsAnchor !== bIsAnchor)
                     return bIsAnchor - aIsAnchor;
-                const rolePriority = { system: 3, assistant: 2, user: 1, action: 2 };
+                const rolePriority = {
+                    system: 3,
+                    assistant: 2,
+                    user: 1,
+                    action: 2,
+                };
                 return (rolePriority[b.role] || 0) - (rolePriority[a.role] || 0);
             });
             const toKeep = new Set(sortedByImportance.slice(0, this.maxMessages));
-            this.messages = this.messages.filter(m => m === systemMessage || toKeep.has(m));
+            this.messages = this.messages.filter((m) => m === systemMessage || toKeep.has(m));
             console.log(`[ContextBuffer] Importance Trimming: ${initialCount} -> ${this.messages.length} messages. preserved anchors and assistant reasoning.`);
         }
     }
     estimateTokens(content) {
         if (!content)
             return 0;
-        // More sophisticated heuristic: 
+        // More sophisticated heuristic:
         // - JSON/Code tends to have more tokens per character due to symbols.
         // - Natural language is ~4 chars per token.
-        const isStructured = content.startsWith('{') || content.startsWith('[') || content.includes('```');
+        const isStructured = content.startsWith('{') ||
+            content.startsWith('[') ||
+            content.includes('```');
         const ratio = isStructured ? 3 : 4;
         return Math.ceil(content.length / ratio);
     }

package/dist/cjs/agentic/Cortex.js

@@ -84,7 +84,9 @@ class Cortex {
         this.llmPremium = agenticConfig.llmPremium || this.llm;
         this.telemetry = new TelemetryOrchestrator_js_1.TelemetryOrchestrator(db, agenticConfig);
         this.sessions = new SessionManager_js_1.SessionManager(db, agenticConfig, this.telemetry);
-        this.buffer = new ContextBuffer_js_1.ContextBuffer({ maxMessages: agenticConfig.contextWindowSize });
+        this.buffer = new ContextBuffer_js_1.ContextBuffer({
+            maxMessages: agenticConfig.contextWindowSize,
+        });
         this.vectors = agenticConfig.vectorConfig
             ? new VectorIndexer_js_1.VectorIndexer(db, agenticConfig.vectorConfig, agenticConfig.memoriesTable)
             : null;
@@ -150,7 +152,9 @@ class Cortex {
         catch (err) {
             console.error('[Cortex] Soul-Searching loop failed:', err);
             // Telemetry: track failure
-            await this.telemetry.track('system', 'error', 'Self-iteration failed', { error: String(err) });
+            await this.telemetry.track('system', 'error', 'Self-iteration failed', {
+                error: String(err),
+            });
         }
     }
     /**
@@ -167,8 +171,11 @@ class Cortex {
     async recordInteraction(sessionId, role, content, options = {}) {
         const message = await this.sessions.addMessage(sessionId, role, content);
         // Telemetry: Track prompt and output
-        const type = role === 'user' ? 'prompt' : (role === 'assistant' ? 'output' : 'action');
-        await this.telemetry.track(sessionId, type, content, { role, messageId: message.id });
+        const type = role === 'user' ? 'prompt' : role === 'assistant' ? 'output' : 'action';
+        await this.telemetry.track(sessionId, type, content, {
+            role,
+            messageId: message.id,
+        });
         if (options.index && options.embedding && this.vectors) {
             await this.vectors.addMemory(content, options.embedding, sessionId);
         }

package/dist/cjs/agentic/EpisodicMemory.js

@@ -28,7 +28,7 @@ class EpisodicMemory {
             name,
             status: 'active',
             start_time: new Date(),
-            metadata: metadata ? JSON.stringify(metadata) : null
+            metadata: metadata ? JSON.stringify(metadata) : null,
         })
             .returningAll()
             .executeTakeFirstOrThrow();
@@ -54,7 +54,7 @@ class EpisodicMemory {
                 status: 'completed',
                 summary,
                 end_time: new Date(),
-                metadata: JSON.stringify(newMeta)
+                metadata: JSON.stringify(newMeta),
             })
                 .where('id', '=', episodeId)
                 .returningAll()
@@ -72,7 +72,7 @@ class EpisodicMemory {
             .where('session_id', '=', sessionId)
             .orderBy('start_time', 'desc')
             .execute();
-        return list.map(e => this.parseEpisode(e));
+        return list.map((e) => this.parseEpisode(e));
     }
     /**
      * Get recently completed episodes across all sessions.
@@ -85,7 +85,7 @@ class EpisodicMemory {
             .orderBy('end_time', 'desc')
             .limit(limit)
             .execute();
-        return list.map(e => this.parseEpisode(e));
+        return list.map((e) => this.parseEpisode(e));
     }
     parseEpisode(episode) {
         return {
@@ -96,7 +96,9 @@ class EpisodicMemory {
             status: episode.status,
             startTime: new Date(episode.start_time),
             endTime: episode.end_time ? new Date(episode.end_time) : undefined,
-            metadata: typeof episode.metadata === 'string' ? JSON.parse(episode.metadata) : (episode.metadata || {})
+            metadata: typeof episode.metadata === 'string'
+                ? JSON.parse(episode.metadata)
+                : episode.metadata || {},
         };
     }
 }