agenr 0.9.78 → 0.9.79

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.9.79] - 2026-03-08
+
+### Fixed
+
+- Fixed OpenClaw session-start memory index observability so startup logs now distinguish successful empty loads from timeout, invalid-response, and error states instead of collapsing them all into `0 projects`.
+- Fixed the OpenClaw session-start core recall debug log to report configured `coreProjects` truthfully rather than mislabeling config length as "active projects".
+- Fixed OpenClaw session-start fallback recovery for newer TUI session keys such as `agent:main:tui-<uuid>` by allowing degraded same-family TUI predecessor acceptance when the current session identity resolves `family=tui` but cannot recover a stable lane.
+- Preserved strict lane matching for explicit predecessors and known-lane fallback cases, while keeping cross-family fallback candidates ineligible.
+- Added regression coverage for memory-index load result typing, session-start memory-index availability logging, markdown omission on unavailable index states, truthful core-project log wording, unknown-lane TUI fallback acceptance, alternate same-family TUI lane acceptance, cross-family rejection, and the new-key debug logging path.
+
 ## [0.9.78] - 2026-03-08
 
 ### Fixed

package/dist/openclaw-plugin/index.js

@@ -642,6 +642,7 @@ import { fileURLToPath } from "url";
 
 // src/openclaw-plugin/memory-index.ts
 var MEMORY_INDEX_TIMEOUT_MS = 1e4;
+var MEMORY_INDEX_TIMEOUT = /* @__PURE__ */ Symbol("memory-index-timeout");
 function normalizeDate(value) {
   const raw = typeof value === "string" ? value.trim() : "";
   if (!raw) {
@@ -693,9 +694,16 @@ function parseMemoryIndex(value) {
 }
 async function runMemoryIndex(_agenrPath, dbPath) {
   try {
-    return await withTimeout(loadMemoryIndex(dbPath), MEMORY_INDEX_TIMEOUT_MS);
-  } catch {
-    return null;
+    const result = await withTimeout(loadMemoryIndex(dbPath), MEMORY_INDEX_TIMEOUT_MS);
+    if (result === MEMORY_INDEX_TIMEOUT) {
+      return { status: "timeout" };
+    }
+    return result;
+  } catch (error) {
+    return {
+      status: "error",
+      error: toErrorMessage(error)
+    };
   }
 }
 async function loadMemoryIndex(dbPath) {
@@ -703,14 +711,24 @@ async function loadMemoryIndex(dbPath) {
     index: true,
     dbPath
   });
-  return result.mode === "index" ? parseMemoryIndex(result.indexPayload) : null;
+  if (result.mode !== "index") {
+    return { status: "invalid" };
+  }
+  const index = parseMemoryIndex(result.indexPayload);
+  if (!index) {
+    return { status: "invalid" };
+  }
+  return {
+    status: "ok",
+    index
+  };
 }
 async function withTimeout(promise, timeoutMs) {
   let timer;
   try {
     return await new Promise((resolve, reject) => {
       timer = setTimeout(() => {
-        resolve(null);
+        resolve(MEMORY_INDEX_TIMEOUT);
       }, timeoutMs);
       promise.then(resolve).catch(reject);
     });
@@ -2806,15 +2824,17 @@ function resolveSessionFamilyPolicy(currentFamily, predecessorFamily, options) {
   const normalizedPredecessorFamily = normalizePolicyFamily(predecessorFamily);
   const sameKnownFamily = currentFamily !== "unknown" && normalizedPredecessorFamily !== "unknown" && normalizedPredecessorFamily === currentFamily;
   const webchatLaneIdentityAvailable = sameKnownFamily && currentFamily === "webchat" && normalizedPredecessorFamily === "webchat" && (hasStableLaneIdentity(currentFamily, options?.currentLaneId) || hasStableLaneIdentity(normalizedPredecessorFamily, options?.predecessorLaneId));
-  const laneContinuityRequired = sameKnownFamily && (requiresStrictLaneScopedContinuity(currentFamily) || requiresStrictLaneScopedContinuity(normalizedPredecessorFamily) || webchatLaneIdentityAvailable);
-  const laneContinuityConfirmed = laneContinuityRequired ? options?.laneContinuityConfirmed === true : sameKnownFamily;
-  const predecessorContinuityEligible = sameKnownFamily && laneContinuityConfirmed;
+  const degradedLaneFallbackUsed = sameKnownFamily && options?.degradedSameFamilyFallbackAllowed === true;
+  const laneContinuityRequired = !degradedLaneFallbackUsed && sameKnownFamily && (requiresStrictLaneScopedContinuity(currentFamily) || requiresStrictLaneScopedContinuity(normalizedPredecessorFamily) || webchatLaneIdentityAvailable);
+  const laneContinuityConfirmed = degradedLaneFallbackUsed ? true : laneContinuityRequired ? options?.laneContinuityConfirmed === true : sameKnownFamily;
+  const predecessorContinuityEligible = sameKnownFamily && (degradedLaneFallbackUsed || laneContinuityConfirmed);
   return {
     currentFamily,
     predecessorFamily: normalizedPredecessorFamily,
     laneContinuityRequired,
     laneContinuityConfirmed,
     predecessorContinuityEligible,
+    degradedLaneFallbackUsed,
     startupHandoffBrowseEntriesAllowed: predecessorContinuityEligible,
     sessionProjectInheritanceAllowed: predecessorContinuityEligible,
     clearedSessionProjectInheritanceAllowed: predecessorContinuityEligible
@@ -3968,8 +3988,14 @@ function isFallbackLaneContinuityConfirmed(currentIdentity, predecessorFamily, p
   }
   return currentIdentity.laneId === predecessorLaneId;
 }
+function shouldAllowDegradedTuiFallback(currentIdentity, predecessorFamily) {
+  return currentIdentity.family === "tui" && predecessorFamily === "tui" && !currentIdentity.laneId;
+}
 function describeContinuityDecisionReason(currentFamily, predecessorFamily, currentLaneId, predecessorLaneId, policy) {
   if (policy.predecessorContinuityEligible) {
+    if (policy.degradedLaneFallbackUsed) {
+      return "same-family continuity accepted (tui degraded fallback: current lane unknown)";
+    }
     if (currentFamily === "webchat" && predecessorFamily === "webchat" && !policy.laneContinuityRequired) {
       return "same-family continuity accepted (webchat single-lane runtime)";
     }
@@ -4224,6 +4250,10 @@ async function resolveSessionContinuity(event, ctx, sessionsDir, logger, debug,
         currentIdentity,
         predecessorFamilySignal.family,
         predecessorLaneSignal.laneId
+      ),
+      degradedSameFamilyFallbackAllowed: shouldAllowDegradedTuiFallback(
+        currentIdentity,
+        predecessorFamilySignal.family
       )
     });
     const predecessorIdentity = {
@@ -4563,6 +4593,24 @@ function diversifySessionStartBrowseCandidates(browseResult, limit = SESSION_STA
 // src/openclaw-plugin/hooks/before-prompt-build-session-start-recall.ts
 var SESSION_START_BROWSE_SINCE = "30d";
 var sessionStartLog3 = createLogger("session-start");
+function formatConfiguredCoreProjects(coreProjects) {
+  return `[${coreProjects.join(",")}]`;
+}
+function describeMemoryIndexResult(result) {
+  if (!result) {
+    return "memory index unavailable: unknown failure";
+  }
+  switch (result.status) {
+    case "ok":
+      return `memory index loaded: ${result.index.projects.length} projects`;
+    case "timeout":
+      return "memory index unavailable: timeout";
+    case "error":
+      return `memory index unavailable: ${result.error}`;
+    case "invalid":
+      return "memory index unavailable: invalid response";
+  }
+}
 async function fetchSessionStartRecallData(currentSessionProjectKey, params) {
   const coreProjects = params.config?.coreProjects ?? [];
   const sessionStartBrowseProject = await resolveSessionStartBrowseProject(
@@ -4606,17 +4654,17 @@ async function fetchSessionStartRecallData(currentSessionProjectKey, params) {
   const coreResult = coreSettled.status === "fulfilled" ? coreSettled.value : null;
   const browseResult = browseSettled.status === "fulfilled" ? browseSettled.value : null;
   const memoryIndexResult = memoryIndexSettled.status === "fulfilled" ? memoryIndexSettled.value : null;
-  const memoryIndexMarkdown = memoryIndexResult ? formatMemoryIndex(memoryIndexResult) : void 0;
+  const memoryIndexMarkdown = memoryIndexResult?.status === "ok" ? formatMemoryIndex(memoryIndexResult.index) : void 0;
   debugLog(
     params.debug,
     "session-start",
-    `core recall returned ${coreResult?.results.length ?? 0} entries (${coreProjects.length} active projects)`
+    `core recall returned ${coreResult?.results.length ?? 0} entries (configured coreProjects=${formatConfiguredCoreProjects(coreProjects)})`
   );
   debugLog(params.debug, "session-start", `browse returned ${browseResult?.results.length ?? 0} entries`);
   debugLog(
     params.debug,
     "session-start",
-    `memory index returned ${memoryIndexResult?.projects.length ?? 0} projects`
+    describeMemoryIndexResult(memoryIndexResult)
   );
   return {
     coreResult,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenr",
-  "version": "0.9.78",
+  "version": "0.9.79",
   "openclaw": {
     "extensions": [
       "dist/openclaw-plugin/index.js"
@@ -11,6 +11,19 @@
   "bin": {
     "agenr": "dist/cli.js"
   },
+  "scripts": {
+    "build": "tsup src/cli.ts src/cli-main.ts src/openclaw-plugin/index.ts --format esm --dts --clean",
+    "check": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test",
+    "dev": "tsup src/cli.ts src/cli-main.ts --format esm --watch",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "verify:dist": "node scripts/verify-dist.js",
+    "prepack": "pnpm build && pnpm verify:dist"
+  },
   "dependencies": {
     "@clack/prompts": "^1.0.1",
     "@libsql/client": "^0.17.0",
@@ -59,16 +72,9 @@
     "README.md"
   ],
   "author": "agenr-ai",
-  "scripts": {
-    "build": "tsup src/cli.ts src/cli-main.ts src/openclaw-plugin/index.ts --format esm --dts --clean",
-    "check": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test",
-    "dev": "tsup src/cli.ts src/cli-main.ts --format esm --watch",
-    "lint": "eslint .",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "verify:dist": "node scripts/verify-dist.js"
+  "pnpm": {
+    "overrides": {
+      "fast-xml-parser": "^5.3.6"
+    }
   }
-}
+}