blun-king-cli 9.1.392 → 9.1.394

package/LIESMICH.txt

@@ -20,6 +20,17 @@ Start
 Beide Startbefehle verwenden dieselbe Version, dasselbe Konto, dasselbe Modell
 und dieselben Befehle.
 
+king und king -c prüfen beim interaktiven Start auf eine neuere Version. Ist
+eine vorhanden, erscheint der sichtbare Dialog:
+
+  1. Jetzt aktualisieren
+  2. Überspringen
+  3. Auf den nächsten Release warten
+
+Es gibt keinen Download und keine Installation im Hintergrund. Nach einer
+gewählten Installation endet king; king -c setzt die letzte Sitzung mit der
+neuen Version fort.
+
 Standard-MCPs und Eingabesteuerung
 ---------------------------------
 Beim Start richtet BLUN King `agent-browser`, `blun-language-guard` und unter
@@ -315,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
@@ -414,15 +444,6 @@ zurückzufallen. Die globale Node-Installation des Systems wird nicht verändert
 OAuth, gespeicherte Anmeldedaten, Sitzungen und der Updatestatus bleiben
 unverändert.
 
-Aktualisieren
--------------
-
-  blun update
-
-`king update` und `upgrade` sind gleichwertig. Der Updater bleibt im installierten
-Stable- oder Next-Kanal, verhindert Rückstufungen und installiert nur eine zuvor
-aufgelöste exakte Paketversion.
-
 Beim ersten Start in der Konsole /login eingeben. Der Browser öffnet den
 BLUN-OAuth-Login.
 Ein API-Schlüssel wird weder abgefragt noch in die Konfiguration geschrieben.

package/README.md

@@ -35,6 +35,13 @@ an. Version, Konto, Modell und Befehle sind ansonsten identisch. Der Unterschied
 gilt nur für den laufenden Prozess; die gespeicherte
 Plugin-Konfiguration wird nicht umgeschrieben.
 
+`king` und `king -c` prüfen beim interaktiven Start, ob eine neuere Version
+vorliegt. Dann erscheint der sichtbare Dialog mit den Optionen jetzt
+aktualisieren, überspringen oder auf den nächsten Release warten. Im Hintergrund
+wird nichts heruntergeladen oder installiert. Nach einer gewählten Installation
+endet `king`; `king -c` setzt dagegen die letzte Sitzung mit der neuen Version
+fort.
+
 Telegram-Chats werden ohne manuell eingegebene IDs verbunden. In der Konsole
 erzeugt `/telegram:access connect` einen einmaligen Code. `/connect CODE` im
 gewünschten privaten Chat oder in einer Gruppe speichert Chat und Absender
@@ -331,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
@@ -416,10 +441,3 @@ unterstützte Laufzeit wie die TUI, statt auf eine ältere Systeminstallation
 zurückzufallen. Die globale Node-Installation des Systems wird nicht verändert.
 OAuth, gespeicherte Anmeldedaten, Sitzungen und der Updatestatus bleiben
 unverändert.
-
-## Aktualisieren
-
-`blun update`, `king update` und die jeweilige Variante `upgrade` verwenden
-denselben abgesicherten Updater. Er bleibt im installierten Stable- oder
-Next-Kanal, verhindert Rückstufungen und übergibt npm ausschließlich eine zuvor
-aufgelöste exakte Paketversion.

package/bin/blun.js

@@ -325,55 +325,40 @@ async function connectExistingRuntimeLease(timeoutMs = 3_000) {
 }
 
 async function main() {
-  const explicitUpdateRequest = process.argv.length === 3
-    && /^(?:update|upgrade)$/iu.test(process.argv[2] || '');
-  let noticeResult = await acquireNoticeLease();
-  let runtimeResult;
-  try {
-    if (explicitUpdateRequest) {
-      runtimeResult = await connectExistingRuntimeLease(750);
-      if (!runtimeResult.acquired) {
-        runtimeResult = undefined;
-        if (!noticeResult.acquired || !await installLeaseIsClear()) {
-          process.stderr.write('Der geschuetzte BLUN-Start ist gerade nicht verfuegbar.\n');
-          process.exitCode = 1;
-          return;
-        }
-      }
-    } else {
-      const installClear = await installLeaseIsClear();
-      if (!installClear || !noticeResult.acquired) {
-        runtimeResult = await connectExistingRuntimeLease();
-        if (!runtimeResult.acquired && !installClear) {
-          if (!await installLeaseIsClear()) {
-            process.stderr.write('Der geschuetzte BLUN-Start ist gerade nicht verfuegbar.\n');
-            process.exitCode = 1;
-            return;
-          }
-          runtimeResult = undefined;
-        }
-        if (!runtimeResult?.acquired && !noticeResult.acquired) {
-          noticeResult = await acquireNoticeLease();
-          if (!noticeResult.acquired) {
-            process.stderr.write('Der geschuetzte BLUN-Start ist gerade nicht verfuegbar.\n');
-            process.exitCode = 1;
-            return;
-          }
-        }
-      }
-    }
+	let noticeResult = await acquireNoticeLease();
+	let runtimeResult;
+	try {
+		const installClear = await installLeaseIsClear();
+		if (!installClear || !noticeResult.acquired) {
+			runtimeResult = await connectExistingRuntimeLease();
+			if (!runtimeResult.acquired && !installClear) {
+				if (!await installLeaseIsClear()) {
+					process.stderr.write('Der geschuetzte BLUN-Start ist gerade nicht verfuegbar.\n');
+					process.exitCode = 1;
+					return;
+				}
+				runtimeResult = undefined;
+			}
+			if (!runtimeResult?.acquired && !noticeResult.acquired) {
+				noticeResult = await acquireNoticeLease();
+				if (!noticeResult.acquired) {
+					process.stderr.write('Der geschuetzte BLUN-Start ist gerade nicht verfuegbar.\n');
+					process.exitCode = 1;
+					return;
+				}
+			}
+		}
     noticeResult.lease?.assertOwned();
     runtimeResult?.lease?.assertOwned();
     const { runLauncher } = require('./launcher-runtime');
     noticeResult.lease?.assertOwned();
     runtimeResult?.lease?.assertOwned();
     const filename = path.basename(__filename).toLowerCase();
-    await runLauncher({
-      mode: filename.startsWith('king') ? 'king' : 'blun',
-      noticeLease: noticeResult.lease,
-      runtimeLease: runtimeResult?.lease,
-      skipUpdateNotice: runtimeResult?.acquired === true || !noticeResult.acquired,
-    });
+		await runLauncher({
+			mode: filename.startsWith('king') ? 'king' : 'blun',
+			noticeLease: noticeResult.lease,
+			runtimeLease: runtimeResult?.lease,
+		});
   } finally {
     await runtimeResult?.lease?.release();
     await noticeResult.lease?.release();

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/bin/core-bootstrap.js

@@ -5,7 +5,6 @@ const path = require('node:path');
 const { pathToFileURL } = require('node:url');
 
 const { acquireSharedRuntimeLease } = require('./update-lease');
-const { RUNTIME_READY_MESSAGE } = require('./running-update.cjs');
 
 const CORE_LOADED_MESSAGE = 'blun-core-bootstrap-loaded';
 
@@ -46,4 +45,4 @@ if (require.main === module) {
   });
 }
 
-module.exports = { CORE_LOADED_MESSAGE, RUNTIME_READY_MESSAGE, runCoreBootstrap };
+module.exports = { CORE_LOADED_MESSAGE, runCoreBootstrap };

package/bin/king.js

@@ -325,55 +325,40 @@ async function connectExistingRuntimeLease(timeoutMs = 3_000) {
 }
 
 async function main() {
-  const explicitUpdateRequest = process.argv.length === 3
-    && /^(?:update|upgrade)$/iu.test(process.argv[2] || '');
-  let noticeResult = await acquireNoticeLease();
-  let runtimeResult;
-  try {
-    if (explicitUpdateRequest) {
-      runtimeResult = await connectExistingRuntimeLease(750);
-      if (!runtimeResult.acquired) {
-        runtimeResult = undefined;
-        if (!noticeResult.acquired || !await installLeaseIsClear()) {
-          process.stderr.write('Der geschuetzte BLUN-Start ist gerade nicht verfuegbar.\n');
-          process.exitCode = 1;
-          return;
-        }
-      }
-    } else {
-      const installClear = await installLeaseIsClear();
-      if (!installClear || !noticeResult.acquired) {
-        runtimeResult = await connectExistingRuntimeLease();
-        if (!runtimeResult.acquired && !installClear) {
-          if (!await installLeaseIsClear()) {
-            process.stderr.write('Der geschuetzte BLUN-Start ist gerade nicht verfuegbar.\n');
-            process.exitCode = 1;
-            return;
-          }
-          runtimeResult = undefined;
-        }
-        if (!runtimeResult?.acquired && !noticeResult.acquired) {
-          noticeResult = await acquireNoticeLease();
-          if (!noticeResult.acquired) {
-            process.stderr.write('Der geschuetzte BLUN-Start ist gerade nicht verfuegbar.\n');
-            process.exitCode = 1;
-            return;
-          }
-        }
-      }
-    }
+	let noticeResult = await acquireNoticeLease();
+	let runtimeResult;
+	try {
+		const installClear = await installLeaseIsClear();
+		if (!installClear || !noticeResult.acquired) {
+			runtimeResult = await connectExistingRuntimeLease();
+			if (!runtimeResult.acquired && !installClear) {
+				if (!await installLeaseIsClear()) {
+					process.stderr.write('Der geschuetzte BLUN-Start ist gerade nicht verfuegbar.\n');
+					process.exitCode = 1;
+					return;
+				}
+				runtimeResult = undefined;
+			}
+			if (!runtimeResult?.acquired && !noticeResult.acquired) {
+				noticeResult = await acquireNoticeLease();
+				if (!noticeResult.acquired) {
+					process.stderr.write('Der geschuetzte BLUN-Start ist gerade nicht verfuegbar.\n');
+					process.exitCode = 1;
+					return;
+				}
+			}
+		}
     noticeResult.lease?.assertOwned();
     runtimeResult?.lease?.assertOwned();
     const { runLauncher } = require('./launcher-runtime');
     noticeResult.lease?.assertOwned();
     runtimeResult?.lease?.assertOwned();
     const filename = path.basename(__filename).toLowerCase();
-    await runLauncher({
-      mode: filename.startsWith('king') ? 'king' : 'blun',
-      noticeLease: noticeResult.lease,
-      runtimeLease: runtimeResult?.lease,
-      skipUpdateNotice: runtimeResult?.acquired === true || !noticeResult.acquired,
-    });
+		await runLauncher({
+			mode: filename.startsWith('king') ? 'king' : 'blun',
+			noticeLease: noticeResult.lease,
+			runtimeLease: runtimeResult?.lease,
+		});
   } finally {
     await runtimeResult?.lease?.release();
     await noticeResult.lease?.release();