blun-king-cli 9.1.393 → 9.1.394

package/LIESMICH.txt

@@ -326,6 +326,25 @@ Nachweisbare Arbeitsabläufe
 
 Alle Befehle funktionieren identisch mit `king`.
 
+Gemeinsamer kognitiver Speicherkern (optional)
+------------------------------------------------
+
+Ohne zusätzliche Konfiguration bleibt der bisherige lokale SQLite-Speicher
+aktiv. Betreiber können einen gemeinsamen, portalneutralen Speicherkern
+ausdrücklich über BLUN_COGNITIVE_MEMORY_ADAPTER_MODULE wählen. Der Wert muss
+auf eine absolute, kanonische CommonJS-Datei zeigen.
+
+Das Modul exportiert synchron createCognitiveMemoryAdapter(context) und liefert
+einen Adapter mit Vertragsversion 6. Relative Pfade, symbolische Verknüpfungen,
+asynchrone Fabriken und abweichende Vertragsversionen werden geschlossen
+abgewiesen. Der Adapter erhält nur die Vertragsversion, das Profilverzeichnis
+sowie Mandanten-, Agenten- und Anzeigenamen. Zugangsdaten werden nicht
+übergeben.
+
+Damit kann derselbe geprüfte Ereignisstrom über CLI und Portale hinweg gelesen,
+korrigiert und zurückgezogen werden. Ohne den optionalen Anbieter entstehen
+keine neuen Netzwerkzugriffe und keine Verhaltensänderung.
+
 Medienerzeugung
 ---------------
 Für Medienaufträge bleiben GenerateImage, GenerateVideo, GenerateSpeech und

package/README.md

@@ -338,6 +338,24 @@ Version 9.1.0 enthält sieben zusätzliche, getrennt nutzbare Befehlsgruppen:
 
 Sie stehen unter `blun` und `king` identisch zur Verfügung.
 
+## Gemeinsamer kognitiver Speicherkern (optional)
+
+Ohne zusätzliche Konfiguration bleibt der bisherige lokale SQLite-Speicher
+aktiv. Betreiber können einen gemeinsamen, portalneutralen Speicherkern
+ausdrücklich über `BLUN_COGNITIVE_MEMORY_ADAPTER_MODULE` wählen. Der Wert muss
+auf eine absolute, kanonische CommonJS-Datei zeigen.
+
+Das Modul exportiert synchron `createCognitiveMemoryAdapter(context)` und
+liefert einen Adapter mit Vertragsversion 6. Relative Pfade, symbolische
+Verknüpfungen, asynchrone Fabriken und abweichende Vertragsversionen werden
+geschlossen abgewiesen. Der Adapter erhält nur die Vertragsversion, das
+Profilverzeichnis sowie Mandanten-, Agenten- und Anzeigenamen. Zugangsdaten
+werden nicht übergeben.
+
+Damit kann derselbe geprüfte Ereignisstrom über CLI und Portale hinweg gelesen,
+korrigiert und zurückgezogen werden. Ohne den optionalen Anbieter entstehen
+keine neuen Netzwerkzugriffe und keine Verhaltensänderung.
+
 ## Medienerzeugung
 
 Für Medienaufträge bleiben `GenerateImage`, `GenerateVideo`, `GenerateSpeech` und

package/bin/cognitive-memory-provider.cjs

@@ -0,0 +1,92 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const {
+  COGNITIVE_MEMORY_ADAPTER_VERSION,
+  assertCognitiveMemoryAdapter,
+} = require('./cognitive-memory-adapter.cjs');
+
+const PROVIDER_ENV = 'BLUN_COGNITIVE_MEMORY_ADAPTER_MODULE';
+const SAFE_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u;
+
+function fail(code) {
+  const error = new Error(code);
+  error.code = code;
+  throw error;
+}
+
+function canonicalFile(input) {
+  const configured = String(input ?? '').trim();
+  if (!configured || !path.isAbsolute(configured)) fail('COGNITIVE_MEMORY_PROVIDER_PATH_INVALID');
+  const resolved = path.resolve(configured);
+  let stat;
+  let canonical;
+  try {
+    stat = fs.lstatSync(resolved);
+    canonical = fs.realpathSync(resolved);
+  } catch {
+    fail('COGNITIVE_MEMORY_PROVIDER_PATH_INVALID');
+  }
+  if (!stat.isFile() || stat.isSymbolicLink()
+      || path.normalize(canonical).toLowerCase() !== path.normalize(resolved).toLowerCase()) {
+    fail('COGNITIVE_MEMORY_PROVIDER_PATH_INVALID');
+  }
+  return canonical;
+}
+
+function boundedContext({ home, tenantId, agentId, agentName }) {
+  const tenant = String(tenantId ?? '').trim();
+  const agent = String(agentId ?? '').trim();
+  const name = String(agentName ?? '').trim();
+  let canonicalHome;
+  try {
+    const stat = fs.lstatSync(path.resolve(String(home ?? '')));
+    canonicalHome = fs.realpathSync(path.resolve(String(home ?? '')));
+    if (!stat.isDirectory() || stat.isSymbolicLink()) fail('COGNITIVE_MEMORY_PROVIDER_CONTEXT_INVALID');
+  } catch (error) {
+    if (error?.code === 'COGNITIVE_MEMORY_PROVIDER_CONTEXT_INVALID') throw error;
+    fail('COGNITIVE_MEMORY_PROVIDER_CONTEXT_INVALID');
+  }
+  if (!SAFE_ID_RE.test(tenant) || !SAFE_ID_RE.test(agent) || !name || name.length > 128
+      || /[\u0000-\u001f\u007f]/u.test(name)) {
+    fail('COGNITIVE_MEMORY_PROVIDER_CONTEXT_INVALID');
+  }
+  return Object.freeze({
+    contractVersion: COGNITIVE_MEMORY_ADAPTER_VERSION,
+    home: canonicalHome,
+    tenantId: tenant,
+    agentId: agent,
+    agentName: name,
+  });
+}
+
+function loadConfiguredCognitiveMemoryAdapter({
+  modulePath,
+  env = process.env,
+  home,
+  tenantId,
+  agentId,
+  agentName,
+} = {}) {
+  const configured = modulePath === undefined ? env?.[PROVIDER_ENV] : modulePath;
+  if (!String(configured ?? '').trim()) return undefined;
+  const providerPath = canonicalFile(configured);
+  const provider = require(providerPath);
+  if (!provider || typeof provider.createCognitiveMemoryAdapter !== 'function') {
+    fail('COGNITIVE_MEMORY_PROVIDER_FACTORY_REQUIRED');
+  }
+  const adapter = provider.createCognitiveMemoryAdapter(boundedContext({
+    home,
+    tenantId,
+    agentId,
+    agentName,
+  }));
+  if (adapter && typeof adapter.then === 'function') fail('COGNITIVE_MEMORY_PROVIDER_ASYNC_UNSUPPORTED');
+  return assertCognitiveMemoryAdapter(adapter);
+}
+
+module.exports = {
+  PROVIDER_ENV,
+  loadConfiguredCognitiveMemoryAdapter,
+};

package/bin/cognitive-turn-lifecycle.cjs

@@ -4,6 +4,7 @@ const crypto = require('node:crypto');
 const fs = require('node:fs');
 const path = require('node:path');
 const { openCognitiveMemoryAdapter } = require('./cognitive-memory-adapter.cjs');
+const { loadConfiguredCognitiveMemoryAdapter } = require('./cognitive-memory-provider.cjs');
 const { buildCognitiveContextProjection } = require('./cognitive-context-projection.cjs');
 const { buildCognitiveFocusProjection } = require('./cognitive-focus-projection.cjs');
 const { authorizeAttentionCandidate } = require('./cognitive-attention-runtime.cjs');
@@ -521,6 +522,7 @@ function createRuntimeCognitiveTurnLifecycle({
   agentId,
   runtimeId,
   memoryAdapter,
+  memoryAdapterModule,
   now,
 } = {}) {
   const resolvedHome = String(home ?? '').trim();
@@ -537,12 +539,25 @@ function createRuntimeCognitiveTurnLifecycle({
     agentId: explicitAgent || manifestIdentity?.agentId || '',
   };
   const hasSharedIdentity = Boolean(identity.tenantId && identity.agentId);
+  const resolvedTenantId = hasSharedIdentity
+    ? identity.tenantId : digestId('home', [resolvedHome.toLowerCase()]);
+  const resolvedAgentId = hasSharedIdentity
+    ? identity.agentId : digestId('agent', [resolvedAgent.toLowerCase()]);
+  const resolvedMemoryAdapter = memoryAdapter === undefined
+    ? loadConfiguredCognitiveMemoryAdapter({
+      modulePath: memoryAdapterModule,
+      home: resolvedHome,
+      tenantId: resolvedTenantId,
+      agentId: resolvedAgentId,
+      agentName: resolvedAgent,
+    })
+    : memoryAdapter;
   return createCognitiveTurnLifecycle({
     home: resolvedHome,
-    tenantId: hasSharedIdentity ? identity.tenantId : digestId('home', [resolvedHome.toLowerCase()]),
-    agentId: hasSharedIdentity ? identity.agentId : digestId('agent', [resolvedAgent.toLowerCase()]),
+    tenantId: resolvedTenantId,
+    agentId: resolvedAgentId,
     runtimeId,
-    memoryAdapter,
+    memoryAdapter: resolvedMemoryAdapter,
     now,
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blun-king-cli",
-  "version": "9.1.393",
+  "version": "9.1.394",
   "description": "BLUN CLI - your own AI agent with a Telegram channel. Get it done. With BLUN.",
   "license": "MIT",
   "bin": {