noormme 1.2.4 → 1.2.5

package/dist/cjs/agentic/CapabilityManager.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CapabilityManager = void 0;
+const db_utils_js_1 = require("./util/db-utils.js");
 /**
  * CapabilityManager tracks the skills (tools) available to an agent
  * and their historical reliability.
@@ -88,18 +89,13 @@ class CapabilityManager {
      */
     async reportOutcome(name, success, trxOrDb = this.db) {
         const runner = async (trx) => {
-            let query = trx
+            const baseQuery = trx
                 .selectFrom(this.capabilitiesTable)
                 .selectAll()
                 .where('name', '=', name)
                 .orderBy('updated_at', 'desc');
-            // PRODUCTION HARDENING: Lock row to prevent RMW race (Skip for SQLite)
-            const executor = trx.getExecutor();
-            const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-            if (!adapterName.toLowerCase().includes('sqlite')) {
-                query = query.forUpdate();
-            }
-            const capability = await query.executeTakeFirst();
+            const capability = await (0, db_utils_js_1.withLock)(baseQuery, trx)
+                .executeTakeFirst();
             if (capability) {
                 const cap = capability;
                 const metadata = typeof cap.metadata === 'string'

package/dist/cjs/agentic/EpisodicMemory.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EpisodicMemory = void 0;
+const db_utils_js_1 = require("./util/db-utils.js");
 /**
  * EpisodicMemory groups interactions into semantic chunks (episodes),
  * allowing agents to recall specific scenarios and their outcomes.
@@ -39,11 +40,11 @@ class EpisodicMemory {
      */
     async completeEpisode(episodeId, summary, metadata) {
         return await this.db.transaction().execute(async (trx) => {
-            const existing = await trx
+            const query = trx
                 .selectFrom(this.episodesTable)
                 .selectAll()
-                .where('id', '=', episodeId)
-                .forUpdate() // Audit Phase 12: Atomic completion lock
+                .where('id', '=', episodeId);
+            const existing = await (0, db_utils_js_1.withLock)(query, trx) // Audit Phase 12: Atomic completion lock
                 .executeTakeFirst();
             if (!existing)
                 throw new Error(`Episode with ID ${episodeId} not found`);

package/dist/cjs/agentic/PersonaManager.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PersonaManager = void 0;
+const db_utils_js_1 = require("./util/db-utils.js");
 /**
  * PersonaManager handles persistent agent identities that bridge multiple sessions.
  */
@@ -21,17 +22,12 @@ class PersonaManager {
      */
     async upsertPersona(name, options = {}, trxOrDb = this.db) {
         const runner = async (trx) => {
-            let query = trx
+            const baseQuery = trx
                 .selectFrom(this.personasTable)
                 .selectAll()
                 .where('name', '=', name);
-            // Audit Phase 13: Atomic identity lock (Skip for SQLite)
-            const executor = trx.getExecutor();
-            const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-            if (!adapterName.toLowerCase().includes('sqlite')) {
-                query = query.forUpdate();
-            }
-            const existing = await query.executeTakeFirst();
+            const existing = await (0, db_utils_js_1.withLock)(baseQuery, trx)
+                .executeTakeFirst();
             const values = {
                 name,
                 role: options.role || null,

package/dist/cjs/agentic/PolicyEnforcer.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PolicyEnforcer = void 0;
+const db_utils_js_1 = require("./util/db-utils.js");
 /**
  * PolicyEnforcer stores and validates agent autonomous guardrails,
  * such as budgets, safety constraints, and privacy rules.
@@ -25,16 +26,12 @@ class PolicyEnforcer {
      */
     async definePolicy(name, type, definition, isEnabled = true, trxOrDb = this.db) {
         const runner = async (trx) => {
-            let query = trx
+            const query = trx
                 .selectFrom(this.policiesTable)
                 .select('id')
                 .where('name', '=', name);
-            const executor = trx.getExecutor();
-            const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-            if (!adapterName.toLowerCase().includes('sqlite')) {
-                query = query.forUpdate();
-            }
-            const existing = await query.executeTakeFirst();
+            const existing = await (0, db_utils_js_1.withLock)(query, trx)
+                .executeTakeFirst();
             if (existing) {
                 const updated = await trx
                     .updateTable(this.policiesTable)

package/dist/cjs/agentic/ResourceMonitor.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResourceMonitor = void 0;
+const sql_js_1 = require("../raw-builder/sql.js");
 /**
  * ResourceMonitor tracks token usage and costs across sessions.
  */
@@ -100,7 +101,7 @@ class ResourceMonitor {
             .select([
             'model_name',
             (eb) => eb.fn
-                .sum(eb('input_tokens', '+', 'output_tokens'))
+                .sum((0, sql_js_1.sql) `input_tokens + output_tokens`)
                 .as('totalTokens'),
             (eb) => eb.fn.sum('cost').as('totalCost'),
         ])

package/dist/cjs/agentic/SessionManager.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SessionManager = void 0;
+const db_utils_js_1 = require("./util/db-utils.js");
 /**
  * SessionManager handles the lifecycle of agentic sessions, including
  * message history, goal tracking, and memory persistence.
@@ -134,12 +135,12 @@ class SessionManager {
     async upsertGoal(sessionId, description, options = {}) {
         const { status = 'pending', priority = 0, parentId, metadata } = options;
         return await this.db.transaction().execute(async (trx) => {
-            const existing = await trx
+            const query = trx
                 .selectFrom(this.goalsTable)
                 .selectAll()
                 .where('session_id', '=', sessionId)
-                .where('description', '=', description)
-                .forUpdate() // Audit Phase 13: Atomic goal lock
+                .where('description', '=', description);
+            const existing = await (0, db_utils_js_1.withLock)(query, trx) // Audit Phase 13: Atomic goal lock
                 .executeTakeFirst();
             if (existing) {
                 const updated = await trx
@@ -210,11 +211,11 @@ class SessionManager {
         // We avoid the Read-Modify-Write race condition by letting the DB handle the merge
         // or by using a strict transaction if the DB doesn't support JSON patching natively.
         const updated = await this.db.transaction().execute(async (trx) => {
-            const message = await trx
+            const query = trx
                 .selectFrom(this.messagesTable)
                 .select('metadata')
-                .where('id', '=', messageId)
-                .forUpdate() // Lock the row for the duration of the transaction
+                .where('id', '=', messageId);
+            const message = await (0, db_utils_js_1.withLock)(query, trx) // Lock the row for the duration of the transaction
                 .executeTakeFirstOrThrow();
             const metadata = typeof message.metadata === 'string'
                 ? JSON.parse(message.metadata)

package/dist/cjs/agentic/improvement/AblationEngine.d.ts

@@ -14,10 +14,6 @@ export declare class AblationEngine {
     private linksTable;
     constructor(db: Kysely<any>, cortex: Cortex, config?: AgenticConfig);
     private get typedDb();
-    /**
-     * Helper to apply forUpdate only where supported (Skip for SQLite)
-     */
-    private withLock;
     /**
      * Identify "Zombies": Items that have never been retrieved/hit and are old.
      */

package/dist/cjs/agentic/improvement/AblationEngine.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AblationEngine = void 0;
+const db_utils_js_1 = require("../util/db-utils.js");
 /**
  * AblationEngine identifies and removes unused or redundant data
  * to keep the agent's context window and database lean.
@@ -23,17 +24,6 @@ class AblationEngine {
     get typedDb() {
         return this.db;
     }
-    /**
-     * Helper to apply forUpdate only where supported (Skip for SQLite)
-     */
-    withLock(query, trx) {
-        const executor = trx.getExecutor();
-        const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-        if (adapterName.toLowerCase().includes('sqlite')) {
-            return query;
-        }
-        return query.forUpdate();
-    }
     /**
      * Identify "Zombies": Items that have never been retrieved/hit and are old.
      */
@@ -55,7 +45,7 @@ class AblationEngine {
                 .where('id', 'not in', (eb) => eb.selectFrom(this.linksTable).select('source_id'))
                 .where('id', 'not in', (eb) => eb.selectFrom(this.linksTable).select('target_id'))
                 .limit(500); // Audit Phase 9: Batch limit
-            const knowledgeToPrune = await this.withLock(query, trx).execute();
+            const knowledgeToPrune = await (0, db_utils_js_1.withLock)(query, trx).execute();
             if (knowledgeToPrune.length > 0) {
                 const candidates = knowledgeToPrune.map((k) => this.cortex.knowledge['parseKnowledge'](k));
                 const idsToDelete = [];
@@ -151,7 +141,7 @@ class AblationEngine {
                 .selectFrom(this.knowledgeTable)
                 .selectAll()
                 .where('id', '=', id);
-            const item = (await this.withLock(query, trx).executeTakeFirst());
+            const item = (await (0, db_utils_js_1.withLock)(query, trx).executeTakeFirst());
             if (!item)
                 return false;
             const metadata = typeof item.metadata === 'string'
@@ -194,7 +184,7 @@ class AblationEngine {
                 .selectFrom(this.knowledgeTable)
                 .selectAll()
                 .where('id', '=', id);
-            const item = (await this.withLock(query, t).executeTakeFirst());
+            const item = (await (0, db_utils_js_1.withLock)(query, t).executeTakeFirst());
             if (!item)
                 return false;
             const metadata = typeof item.metadata === 'string'

package/dist/cjs/agentic/improvement/ActionRefiner.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActionRefiner = void 0;
+const db_utils_js_1 = require("../util/db-utils.js");
 /**
  * ActionRefiner analyzes the ActionJournal to find patterns in failures
  * and suggests new CognitiveRules to improve agent performance.
@@ -73,18 +74,13 @@ class ActionRefiner {
         // Audit Phase 19: Atomic rule proposal via transaction + existence check
         const runner = async (trx) => {
             const rulesTable = this.cortex.config.rulesTable || 'agent_rules';
-            let query = trx
+            const query = trx
                 .selectFrom(rulesTable)
                 .select('id')
                 .where('table_name', '=', 'agent_actions')
                 .where('operation', '=', 'insert')
                 .where('metadata', 'like', `%\"targetTool\":\"${toolName}\"%`);
-            const executor = trx.getExecutor();
-            const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-            if (!adapterName.toLowerCase().includes('sqlite')) {
-                query = query.forUpdate();
-            }
-            const existing = await query.executeTakeFirst();
+            const existing = await (0, db_utils_js_1.withLock)(query, trx).executeTakeFirst();
             if (!existing) {
                 console.log(`[ActionRefiner] Proposing reflection rule for tool: ${toolName}`);
                 await this.cortex.rules.defineRule('agent_actions', 'insert', 'audit', {

package/dist/cjs/agentic/improvement/ConflictResolver.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConflictResolver = void 0;
 const similarity_js_1 = require("../../util/similarity.js");
+const db_utils_js_1 = require("../util/db-utils.js");
 /**
  * ConflictResolver identifies and resolves logical inconsistencies
  * in the agent's cognitive rules and behavior policies.
@@ -85,14 +86,14 @@ class ConflictResolver {
     async resolveConflict(tableName, operation) {
         console.log(`[ConflictResolver] Resolving conflict for ${tableName}:${operation}`);
         return await this.db.transaction().execute(async (trx) => {
-            const rules = (await trx
+            const query = trx
                 .selectFrom(this.rulesTable)
                 .selectAll()
                 .where('table_name', '=', tableName)
                 .where('operation', '=', operation)
                 .where('is_enabled', '=', true)
-                .orderBy('created_at', 'desc')
-                .forUpdate() // Audit Phase 10: Atomic resolution lock
+                .orderBy('created_at', 'desc');
+            const rules = (await (0, db_utils_js_1.withLock)(query, trx) // Audit Phase 10: Atomic resolution lock
                 .execute());
             if (rules.length <= 1)
                 return;

package/dist/cjs/agentic/improvement/GoalArchitect.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GoalArchitect = void 0;
 const similarity_js_1 = require("../../util/similarity.js");
+const db_utils_js_1 = require("../util/db-utils.js");
 /**
  * GoalArchitect enables agents to autonomously deconstruct complex
  * objectives into manageable sub-goals.
@@ -26,11 +27,11 @@ class GoalArchitect {
         return await this.db.transaction().execute(async (trx) => {
             // 1. Audit Phase 9: Circular Dependency Protection inside transaction
             await this.detectCircularDependency(goalId, new Set(), trx);
-            const goal = (await trx
+            const query = trx
                 .selectFrom(this.goalsTable)
                 .selectAll()
-                .where('id', '=', goalId)
-                .forUpdate() // Audit Phase 9: Atomic acquisition
+                .where('id', '=', goalId);
+            const goal = (await (0, db_utils_js_1.withLock)(query, trx) // Audit Phase 9: Atomic acquisition
                 .executeTakeFirst());
             if (!goal)
                 throw new Error(`Goal ${goalId} not found`);
@@ -101,11 +102,11 @@ class GoalArchitect {
         const sortedIds = [...goalIds].sort((a, b) => String(a).localeCompare(String(b)));
         await this.db.transaction().execute(async (trx) => {
             // Pre-lock all rows in deterministic order
-            await trx
+            const query = trx
                 .selectFrom(this.goalsTable)
                 .select('id')
-                .where('id', 'in', sortedIds)
-                .forUpdate()
+                .where('id', 'in', sortedIds);
+            await (0, db_utils_js_1.withLock)(query, trx)
                 .execute();
             for (let i = 0; i < goalIds.length; i++) {
                 await trx
@@ -121,11 +122,11 @@ class GoalArchitect {
      */
     async markGoalAs(goalId, status, outcome) {
         return await this.db.transaction().execute(async (trx) => {
-            const goal = (await trx
+            const query = trx
                 .selectFrom(this.goalsTable)
                 .selectAll()
-                .where('id', '=', goalId)
-                .forUpdate() // Audit Phase 9: Atomic status/meta update
+                .where('id', '=', goalId);
+            const goal = (await (0, db_utils_js_1.withLock)(query, trx) // Audit Phase 9: Atomic status/meta update
                 .executeTakeFirst());
             if (!goal)
                 throw new Error(`Goal ${goalId} not found`);

package/dist/cjs/agentic/improvement/KnowledgeDistiller.js

@@ -5,6 +5,7 @@ const FactDistiller_js_1 = require("./distillation/FactDistiller.js");
 const ConflictChallenger_js_1 = require("./distillation/ConflictChallenger.js");
 const RelationshipArchitect_js_1 = require("./distillation/RelationshipArchitect.js");
 const KnowledgeConsolidator_js_1 = require("./distillation/KnowledgeConsolidator.js");
+const db_utils_js_1 = require("../util/db-utils.js");
 /**
  * KnowledgeDistiller extracts structured "KnowledgeItems" from longtail history,
  * allowing agents to build a permanent, queryable knowledge base.
@@ -106,11 +107,11 @@ class KnowledgeDistiller {
      */
     async recordHit(id) {
         await this.db.transaction().execute(async (trx) => {
-            const existing = await trx
+            const query = trx
                 .selectFrom(this.knowledgeTable)
                 .select(['id', 'entity', 'metadata'])
-                .where('id', '=', id)
-                .forUpdate()
+                .where('id', '=', id);
+            const existing = await (0, db_utils_js_1.withLock)(query, trx)
                 .executeTakeFirst();
             if (!existing)
                 return;

package/dist/cjs/agentic/improvement/SelfTestRegistry.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SelfTestRegistry = void 0;
+const db_utils_js_1 = require("../util/db-utils.js");
 /**
  * SelfTestRegistry allows agents to self-register verification probes
  * that ensure autonomous changes don't violate core logic.
@@ -57,16 +58,11 @@ class SelfTestRegistry {
                 results.push({ name: probe.name, success });
                 const updateRunner = async (trx) => {
                     // Audit Phase 13: Lock row before updating last_status
-                    let query = trx
+                    const query = trx
                         .selectFrom('agent_logic_probes')
                         .select('id')
                         .where('id', '=', probe.id);
-                    const executor = trx.getExecutor();
-                    const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-                    if (!adapterName.toLowerCase().includes('sqlite')) {
-                        query = query.forUpdate();
-                    }
-                    await query.executeTakeFirst();
+                    await (0, db_utils_js_1.withLock)(query, trx).executeTakeFirst();
                     await trx
                         .updateTable('agent_logic_probes')
                         .set({

package/dist/cjs/agentic/improvement/governance/PersonaAuditor.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PersonaAuditor = void 0;
+const db_utils_js_1 = require("../../util/db-utils.js");
 class PersonaAuditor {
     async audit(ctx) {
         const issues = [];
@@ -43,17 +44,12 @@ class PersonaAuditor {
         console.warn(`[PersonaAuditor] QUARANTINING Persona ${id}: ${reason}`);
         // Use the provided transaction or start a new one to ensure atomicity
         const runner = async (trx) => {
-            let query = trx
+            const query = trx
                 .selectFrom(ctx.personasTable)
                 .selectAll()
                 .where('id', '=', id);
-            // Audit Phase 16: Exclusive lock for containment (Skip for SQLite)
-            const executor = trx.getExecutor();
-            const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-            if (!adapterName.toLowerCase().includes('sqlite')) {
-                query = query.forUpdate();
-            }
-            const persona = await query.executeTakeFirst();
+            const persona = await (0, db_utils_js_1.withLock)(query, trx)
+                .executeTakeFirst();
             if (persona) {
                 const metadata = typeof persona.metadata === 'string'
                     ? JSON.parse(persona.metadata)

package/dist/cjs/agentic/improvement/hive/KnowledgePromoter.js

@@ -1,17 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KnowledgePromoter = void 0;
+const db_utils_js_1 = require("../../util/db-utils.js");
 class KnowledgePromoter {
     async promote(db, cortex, config, knowledgeTable, item) {
         return await db.transaction().execute(async (trx) => {
             // Check if a global version already exists
-            const existingGlobal = await trx
+            const query = trx
                 .selectFrom(knowledgeTable)
                 .selectAll()
                 .where('entity', '=', item.entity)
                 .where('fact', '=', item.fact)
-                .where('source_session_id', 'is', null)
-                .forUpdate() // Prevent concurrent promotion duplication
+                .where('source_session_id', 'is', null);
+            const existingGlobal = await (0, db_utils_js_1.withLock)(query, trx) // Prevent concurrent promotion duplication
                 .executeTakeFirst();
             if (existingGlobal) {
                 // Reinforce existing global knowledge

package/dist/cjs/agentic/improvement/hive/SkillPropagator.js

@@ -54,7 +54,7 @@ class SkillPropagator {
                         .execute();
                 }
             });
-            broadcastCount += variants.length;
+            broadcastCount++;
         }
         // 2. Blacklisted Skill Propagation (Immune Prophet)
         const blacklisted = await cortex.capabilities.getCapabilities('blacklisted');

package/dist/cjs/agentic/util/db-utils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Utility function to apply a "FOR UPDATE" lock only where supported (Not in SQLite)
+ */
+export declare function withLock(query: any, trx: any): any;

package/dist/cjs/agentic/util/db-utils.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withLock = withLock;
+/**
+ * Utility function to apply a "FOR UPDATE" lock only where supported (Not in SQLite)
+ */
+function withLock(query, trx) {
+    if (!trx || typeof trx.getExecutor !== 'function') {
+        // If we're using a mock or a version of Kysely without getExecutor
+        // we default to no lock to prevent failures in tests
+        return query;
+    }
+    try {
+        const executor = trx.getExecutor();
+        const adapterName = executor?.adapter?.constructor?.name ||
+            executor?.dialect?.constructor?.name ||
+            '';
+        if (adapterName.toLowerCase().includes('sqlite')) {
+            return query;
+        }
+    }
+    catch (error) {
+        // Fallback if execution fails for some reason
+        return query;
+    }
+    return query.forUpdate();
+}

package/dist/cjs/helpers/agent-schema.js

@@ -119,6 +119,7 @@ class AgentSchemaHelper {
             .addColumn('tool_name', 'text', (col) => col.notNull())
             .addColumn('arguments', 'text', (col) => col.notNull())
             .addColumn('outcome', 'text')
+            .addColumn('error', 'text')
             .addColumn('status', 'text', (col) => col.notNull().defaultTo('pending'))
             .addColumn('duration_ms', 'integer')
             .addColumn('metadata', 'text')

package/dist/cjs/testing/test-utils.js

@@ -94,6 +94,8 @@ async function setupTestSchema(db) {
         .on('comments')
         .column('user_id')
         .execute();
+    // Initialize agent schema
+    await db.agent.schema.initializeSchema();
     // Initialize NOORMME to discover the schema
     // Temporarily enable warnings to see discovery errors
     const originalWarn = console.warn;

package/dist/esm/agentic/CapabilityManager.js

@@ -1,4 +1,5 @@
 /// <reference types="./CapabilityManager.d.ts" />
+import { withLock } from './util/db-utils.js';
 /**
  * CapabilityManager tracks the skills (tools) available to an agent
  * and their historical reliability.
@@ -86,18 +87,13 @@ export class CapabilityManager {
      */
     async reportOutcome(name, success, trxOrDb = this.db) {
         const runner = async (trx) => {
-            let query = trx
+            const baseQuery = trx
                 .selectFrom(this.capabilitiesTable)
                 .selectAll()
                 .where('name', '=', name)
                 .orderBy('updated_at', 'desc');
-            // PRODUCTION HARDENING: Lock row to prevent RMW race (Skip for SQLite)
-            const executor = trx.getExecutor();
-            const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-            if (!adapterName.toLowerCase().includes('sqlite')) {
-                query = query.forUpdate();
-            }
-            const capability = await query.executeTakeFirst();
+            const capability = await withLock(baseQuery, trx)
+                .executeTakeFirst();
             if (capability) {
                 const cap = capability;
                 const metadata = typeof cap.metadata === 'string'

package/dist/esm/agentic/EpisodicMemory.js

@@ -1,4 +1,5 @@
 /// <reference types="./EpisodicMemory.d.ts" />
+import { withLock } from './util/db-utils.js';
 /**
  * EpisodicMemory groups interactions into semantic chunks (episodes),
  * allowing agents to recall specific scenarios and their outcomes.
@@ -37,11 +38,11 @@ export class EpisodicMemory {
      */
     async completeEpisode(episodeId, summary, metadata) {
         return await this.db.transaction().execute(async (trx) => {
-            const existing = await trx
+            const query = trx
                 .selectFrom(this.episodesTable)
                 .selectAll()
-                .where('id', '=', episodeId)
-                .forUpdate() // Audit Phase 12: Atomic completion lock
+                .where('id', '=', episodeId);
+            const existing = await withLock(query, trx) // Audit Phase 12: Atomic completion lock
                 .executeTakeFirst();
             if (!existing)
                 throw new Error(`Episode with ID ${episodeId} not found`);

package/dist/esm/agentic/PersonaManager.js

@@ -1,4 +1,5 @@
 /// <reference types="./PersonaManager.d.ts" />
+import { withLock } from './util/db-utils.js';
 /**
  * PersonaManager handles persistent agent identities that bridge multiple sessions.
  */
@@ -19,17 +20,12 @@ export class PersonaManager {
      */
     async upsertPersona(name, options = {}, trxOrDb = this.db) {
         const runner = async (trx) => {
-            let query = trx
+            const baseQuery = trx
                 .selectFrom(this.personasTable)
                 .selectAll()
                 .where('name', '=', name);
-            // Audit Phase 13: Atomic identity lock (Skip for SQLite)
-            const executor = trx.getExecutor();
-            const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-            if (!adapterName.toLowerCase().includes('sqlite')) {
-                query = query.forUpdate();
-            }
-            const existing = await query.executeTakeFirst();
+            const existing = await withLock(baseQuery, trx)
+                .executeTakeFirst();
             const values = {
                 name,
                 role: options.role || null,

package/dist/esm/agentic/PolicyEnforcer.js

@@ -1,4 +1,5 @@
 /// <reference types="./PolicyEnforcer.d.ts" />
+import { withLock } from './util/db-utils.js';
 /**
  * PolicyEnforcer stores and validates agent autonomous guardrails,
  * such as budgets, safety constraints, and privacy rules.
@@ -23,16 +24,12 @@ export class PolicyEnforcer {
      */
     async definePolicy(name, type, definition, isEnabled = true, trxOrDb = this.db) {
         const runner = async (trx) => {
-            let query = trx
+            const query = trx
                 .selectFrom(this.policiesTable)
                 .select('id')
                 .where('name', '=', name);
-            const executor = trx.getExecutor();
-            const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-            if (!adapterName.toLowerCase().includes('sqlite')) {
-                query = query.forUpdate();
-            }
-            const existing = await query.executeTakeFirst();
+            const existing = await withLock(query, trx)
+                .executeTakeFirst();
             if (existing) {
                 const updated = await trx
                     .updateTable(this.policiesTable)

package/dist/esm/agentic/ResourceMonitor.js

@@ -1,4 +1,5 @@
 /// <reference types="./ResourceMonitor.d.ts" />
+import { sql } from '../raw-builder/sql.js';
 /**
  * ResourceMonitor tracks token usage and costs across sessions.
  */
@@ -98,7 +99,7 @@ export class ResourceMonitor {
             .select([
             'model_name',
             (eb) => eb.fn
-                .sum(eb('input_tokens', '+', 'output_tokens'))
+                .sum(sql `input_tokens + output_tokens`)
                 .as('totalTokens'),
             (eb) => eb.fn.sum('cost').as('totalCost'),
         ])

package/dist/esm/agentic/SessionManager.js

@@ -1,4 +1,5 @@
 /// <reference types="./SessionManager.d.ts" />
+import { withLock } from './util/db-utils.js';
 /**
  * SessionManager handles the lifecycle of agentic sessions, including
  * message history, goal tracking, and memory persistence.
@@ -132,12 +133,12 @@ export class SessionManager {
     async upsertGoal(sessionId, description, options = {}) {
         const { status = 'pending', priority = 0, parentId, metadata } = options;
         return await this.db.transaction().execute(async (trx) => {
-            const existing = await trx
+            const query = trx
                 .selectFrom(this.goalsTable)
                 .selectAll()
                 .where('session_id', '=', sessionId)
-                .where('description', '=', description)
-                .forUpdate() // Audit Phase 13: Atomic goal lock
+                .where('description', '=', description);
+            const existing = await withLock(query, trx) // Audit Phase 13: Atomic goal lock
                 .executeTakeFirst();
             if (existing) {
                 const updated = await trx
@@ -208,11 +209,11 @@ export class SessionManager {
         // We avoid the Read-Modify-Write race condition by letting the DB handle the merge
         // or by using a strict transaction if the DB doesn't support JSON patching natively.
         const updated = await this.db.transaction().execute(async (trx) => {
-            const message = await trx
+            const query = trx
                 .selectFrom(this.messagesTable)
                 .select('metadata')
-                .where('id', '=', messageId)
-                .forUpdate() // Lock the row for the duration of the transaction
+                .where('id', '=', messageId);
+            const message = await withLock(query, trx) // Lock the row for the duration of the transaction
                 .executeTakeFirstOrThrow();
             const metadata = typeof message.metadata === 'string'
                 ? JSON.parse(message.metadata)

package/dist/esm/agentic/improvement/AblationEngine.d.ts

@@ -14,10 +14,6 @@ export declare class AblationEngine {
     private linksTable;
     constructor(db: Kysely<any>, cortex: Cortex, config?: AgenticConfig);
     private get typedDb();
-    /**
-     * Helper to apply forUpdate only where supported (Skip for SQLite)
-     */
-    private withLock;
     /**
      * Identify "Zombies": Items that have never been retrieved/hit and are old.
      */

package/dist/esm/agentic/improvement/AblationEngine.js

@@ -1,4 +1,5 @@
 /// <reference types="./AblationEngine.d.ts" />
+import { withLock } from '../util/db-utils.js';
 /**
  * AblationEngine identifies and removes unused or redundant data
  * to keep the agent's context window and database lean.
@@ -21,17 +22,6 @@ export class AblationEngine {
     get typedDb() {
         return this.db;
     }
-    /**
-     * Helper to apply forUpdate only where supported (Skip for SQLite)
-     */
-    withLock(query, trx) {
-        const executor = trx.getExecutor();
-        const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-        if (adapterName.toLowerCase().includes('sqlite')) {
-            return query;
-        }
-        return query.forUpdate();
-    }
     /**
      * Identify "Zombies": Items that have never been retrieved/hit and are old.
      */
@@ -53,7 +43,7 @@ export class AblationEngine {
                 .where('id', 'not in', (eb) => eb.selectFrom(this.linksTable).select('source_id'))
                 .where('id', 'not in', (eb) => eb.selectFrom(this.linksTable).select('target_id'))
                 .limit(500); // Audit Phase 9: Batch limit
-            const knowledgeToPrune = await this.withLock(query, trx).execute();
+            const knowledgeToPrune = await withLock(query, trx).execute();
             if (knowledgeToPrune.length > 0) {
                 const candidates = knowledgeToPrune.map((k) => this.cortex.knowledge['parseKnowledge'](k));
                 const idsToDelete = [];
@@ -149,7 +139,7 @@ export class AblationEngine {
                 .selectFrom(this.knowledgeTable)
                 .selectAll()
                 .where('id', '=', id);
-            const item = (await this.withLock(query, trx).executeTakeFirst());
+            const item = (await withLock(query, trx).executeTakeFirst());
             if (!item)
                 return false;
             const metadata = typeof item.metadata === 'string'
@@ -192,7 +182,7 @@ export class AblationEngine {
                 .selectFrom(this.knowledgeTable)
                 .selectAll()
                 .where('id', '=', id);
-            const item = (await this.withLock(query, t).executeTakeFirst());
+            const item = (await withLock(query, t).executeTakeFirst());
             if (!item)
                 return false;
             const metadata = typeof item.metadata === 'string'

package/dist/esm/agentic/improvement/ActionRefiner.js

@@ -1,4 +1,5 @@
 /// <reference types="./ActionRefiner.d.ts" />
+import { withLock } from '../util/db-utils.js';
 /**
  * ActionRefiner analyzes the ActionJournal to find patterns in failures
  * and suggests new CognitiveRules to improve agent performance.
@@ -71,18 +72,13 @@ export class ActionRefiner {
         // Audit Phase 19: Atomic rule proposal via transaction + existence check
         const runner = async (trx) => {
             const rulesTable = this.cortex.config.rulesTable || 'agent_rules';
-            let query = trx
+            const query = trx
                 .selectFrom(rulesTable)
                 .select('id')
                 .where('table_name', '=', 'agent_actions')
                 .where('operation', '=', 'insert')
                 .where('metadata', 'like', `%\"targetTool\":\"${toolName}\"%`);
-            const executor = trx.getExecutor();
-            const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-            if (!adapterName.toLowerCase().includes('sqlite')) {
-                query = query.forUpdate();
-            }
-            const existing = await query.executeTakeFirst();
+            const existing = await withLock(query, trx).executeTakeFirst();
             if (!existing) {
                 console.log(`[ActionRefiner] Proposing reflection rule for tool: ${toolName}`);
                 await this.cortex.rules.defineRule('agent_actions', 'insert', 'audit', {

package/dist/esm/agentic/improvement/ConflictResolver.js

@@ -1,5 +1,6 @@
 /// <reference types="./ConflictResolver.d.ts" />
 import { calculateSimilarity } from '../../util/similarity.js';
+import { withLock } from '../util/db-utils.js';
 /**
  * ConflictResolver identifies and resolves logical inconsistencies
  * in the agent's cognitive rules and behavior policies.
@@ -83,14 +84,14 @@ export class ConflictResolver {
     async resolveConflict(tableName, operation) {
         console.log(`[ConflictResolver] Resolving conflict for ${tableName}:${operation}`);
         return await this.db.transaction().execute(async (trx) => {
-            const rules = (await trx
+            const query = trx
                 .selectFrom(this.rulesTable)
                 .selectAll()
                 .where('table_name', '=', tableName)
                 .where('operation', '=', operation)
                 .where('is_enabled', '=', true)
-                .orderBy('created_at', 'desc')
-                .forUpdate() // Audit Phase 10: Atomic resolution lock
+                .orderBy('created_at', 'desc');
+            const rules = (await withLock(query, trx) // Audit Phase 10: Atomic resolution lock
                 .execute());
             if (rules.length <= 1)
                 return;

package/dist/esm/agentic/improvement/GoalArchitect.js

@@ -1,5 +1,6 @@
 /// <reference types="./GoalArchitect.d.ts" />
 import { calculateSimilarity } from '../../util/similarity.js';
+import { withLock } from '../util/db-utils.js';
 /**
  * GoalArchitect enables agents to autonomously deconstruct complex
  * objectives into manageable sub-goals.
@@ -24,11 +25,11 @@ export class GoalArchitect {
         return await this.db.transaction().execute(async (trx) => {
             // 1. Audit Phase 9: Circular Dependency Protection inside transaction
             await this.detectCircularDependency(goalId, new Set(), trx);
-            const goal = (await trx
+            const query = trx
                 .selectFrom(this.goalsTable)
                 .selectAll()
-                .where('id', '=', goalId)
-                .forUpdate() // Audit Phase 9: Atomic acquisition
+                .where('id', '=', goalId);
+            const goal = (await withLock(query, trx) // Audit Phase 9: Atomic acquisition
                 .executeTakeFirst());
             if (!goal)
                 throw new Error(`Goal ${goalId} not found`);
@@ -99,11 +100,11 @@ export class GoalArchitect {
         const sortedIds = [...goalIds].sort((a, b) => String(a).localeCompare(String(b)));
         await this.db.transaction().execute(async (trx) => {
             // Pre-lock all rows in deterministic order
-            await trx
+            const query = trx
                 .selectFrom(this.goalsTable)
                 .select('id')
-                .where('id', 'in', sortedIds)
-                .forUpdate()
+                .where('id', 'in', sortedIds);
+            await withLock(query, trx)
                 .execute();
             for (let i = 0; i < goalIds.length; i++) {
                 await trx
@@ -119,11 +120,11 @@ export class GoalArchitect {
      */
     async markGoalAs(goalId, status, outcome) {
         return await this.db.transaction().execute(async (trx) => {
-            const goal = (await trx
+            const query = trx
                 .selectFrom(this.goalsTable)
                 .selectAll()
-                .where('id', '=', goalId)
-                .forUpdate() // Audit Phase 9: Atomic status/meta update
+                .where('id', '=', goalId);
+            const goal = (await withLock(query, trx) // Audit Phase 9: Atomic status/meta update
                 .executeTakeFirst());
             if (!goal)
                 throw new Error(`Goal ${goalId} not found`);

package/dist/esm/agentic/improvement/KnowledgeDistiller.js

@@ -3,6 +3,7 @@ import { FactDistiller } from './distillation/FactDistiller.js';
 import { ConflictChallenger } from './distillation/ConflictChallenger.js';
 import { RelationshipArchitect } from './distillation/RelationshipArchitect.js';
 import { KnowledgeConsolidator } from './distillation/KnowledgeConsolidator.js';
+import { withLock } from '../util/db-utils.js';
 /**
  * KnowledgeDistiller extracts structured "KnowledgeItems" from longtail history,
  * allowing agents to build a permanent, queryable knowledge base.
@@ -104,11 +105,11 @@ export class KnowledgeDistiller {
      */
     async recordHit(id) {
         await this.db.transaction().execute(async (trx) => {
-            const existing = await trx
+            const query = trx
                 .selectFrom(this.knowledgeTable)
                 .select(['id', 'entity', 'metadata'])
-                .where('id', '=', id)
-                .forUpdate()
+                .where('id', '=', id);
+            const existing = await withLock(query, trx)
                 .executeTakeFirst();
             if (!existing)
                 return;

package/dist/esm/agentic/improvement/SelfTestRegistry.js

@@ -1,4 +1,5 @@
 /// <reference types="./SelfTestRegistry.d.ts" />
+import { withLock } from '../util/db-utils.js';
 /**
  * SelfTestRegistry allows agents to self-register verification probes
  * that ensure autonomous changes don't violate core logic.
@@ -55,16 +56,11 @@ export class SelfTestRegistry {
                 results.push({ name: probe.name, success });
                 const updateRunner = async (trx) => {
                     // Audit Phase 13: Lock row before updating last_status
-                    let query = trx
+                    const query = trx
                         .selectFrom('agent_logic_probes')
                         .select('id')
                         .where('id', '=', probe.id);
-                    const executor = trx.getExecutor();
-                    const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-                    if (!adapterName.toLowerCase().includes('sqlite')) {
-                        query = query.forUpdate();
-                    }
-                    await query.executeTakeFirst();
+                    await withLock(query, trx).executeTakeFirst();
                     await trx
                         .updateTable('agent_logic_probes')
                         .set({

package/dist/esm/agentic/improvement/governance/PersonaAuditor.js

@@ -1,4 +1,5 @@
 /// <reference types="./PersonaAuditor.d.ts" />
+import { withLock } from '../../util/db-utils.js';
 export class PersonaAuditor {
     async audit(ctx) {
         const issues = [];
@@ -41,17 +42,12 @@ export class PersonaAuditor {
         console.warn(`[PersonaAuditor] QUARANTINING Persona ${id}: ${reason}`);
         // Use the provided transaction or start a new one to ensure atomicity
         const runner = async (trx) => {
-            let query = trx
+            const query = trx
                 .selectFrom(ctx.personasTable)
                 .selectAll()
                 .where('id', '=', id);
-            // Audit Phase 16: Exclusive lock for containment (Skip for SQLite)
-            const executor = trx.getExecutor();
-            const adapterName = executor?.adapter?.constructor?.name || executor?.dialect?.constructor?.name || '';
-            if (!adapterName.toLowerCase().includes('sqlite')) {
-                query = query.forUpdate();
-            }
-            const persona = await query.executeTakeFirst();
+            const persona = await withLock(query, trx)
+                .executeTakeFirst();
             if (persona) {
                 const metadata = typeof persona.metadata === 'string'
                     ? JSON.parse(persona.metadata)

package/dist/esm/agentic/improvement/hive/KnowledgePromoter.js

@@ -1,15 +1,16 @@
 /// <reference types="./KnowledgePromoter.d.ts" />
+import { withLock } from '../../util/db-utils.js';
 export class KnowledgePromoter {
     async promote(db, cortex, config, knowledgeTable, item) {
         return await db.transaction().execute(async (trx) => {
             // Check if a global version already exists
-            const existingGlobal = await trx
+            const query = trx
                 .selectFrom(knowledgeTable)
                 .selectAll()
                 .where('entity', '=', item.entity)
                 .where('fact', '=', item.fact)
-                .where('source_session_id', 'is', null)
-                .forUpdate() // Prevent concurrent promotion duplication
+                .where('source_session_id', 'is', null);
+            const existingGlobal = await withLock(query, trx) // Prevent concurrent promotion duplication
                 .executeTakeFirst();
             if (existingGlobal) {
                 // Reinforce existing global knowledge

package/dist/esm/agentic/improvement/hive/SkillPropagator.js

@@ -52,7 +52,7 @@ export class SkillPropagator {
                         .execute();
                 }
             });
-            broadcastCount += variants.length;
+            broadcastCount++;
         }
         // 2. Blacklisted Skill Propagation (Immune Prophet)
         const blacklisted = await cortex.capabilities.getCapabilities('blacklisted');

package/dist/esm/agentic/util/db-utils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Utility function to apply a "FOR UPDATE" lock only where supported (Not in SQLite)
+ */
+export declare function withLock(query: any, trx: any): any;

package/dist/esm/agentic/util/db-utils.js

@@ -0,0 +1,25 @@
+/// <reference types="./db-utils.d.ts" />
+/**
+ * Utility function to apply a "FOR UPDATE" lock only where supported (Not in SQLite)
+ */
+export function withLock(query, trx) {
+    if (!trx || typeof trx.getExecutor !== 'function') {
+        // If we're using a mock or a version of Kysely without getExecutor
+        // we default to no lock to prevent failures in tests
+        return query;
+    }
+    try {
+        const executor = trx.getExecutor();
+        const adapterName = executor?.adapter?.constructor?.name ||
+            executor?.dialect?.constructor?.name ||
+            '';
+        if (adapterName.toLowerCase().includes('sqlite')) {
+            return query;
+        }
+    }
+    catch (error) {
+        // Fallback if execution fails for some reason
+        return query;
+    }
+    return query.forUpdate();
+}

package/dist/esm/helpers/agent-schema.js

@@ -117,6 +117,7 @@ export class AgentSchemaHelper {
             .addColumn('tool_name', 'text', (col) => col.notNull())
             .addColumn('arguments', 'text', (col) => col.notNull())
             .addColumn('outcome', 'text')
+            .addColumn('error', 'text')
             .addColumn('status', 'text', (col) => col.notNull().defaultTo('pending'))
             .addColumn('duration_ms', 'integer')
             .addColumn('metadata', 'text')

package/dist/esm/testing/test-utils.js

@@ -89,6 +89,8 @@ export async function setupTestSchema(db) {
         .on('comments')
         .column('user_id')
         .execute();
+    // Initialize agent schema
+    await db.agent.schema.initializeSchema();
     // Initialize NOORMME to discover the schema
     // Temporarily enable warnings to see discovery errors
     const originalWarn = console.warn;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "noormme",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "NOORMME - The Agentic Data Engine. High-fidelity persistence and cognitive governance for Autonomous AI Agents.",
   "repository": {
     "type": "git",