agenr 0.8.2 → 0.8.3

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.8.3]
+
+### Fixed
+- setup: custom model aliases (gpt-4.1-nano, gpt-4.1-mini) now appear in
+  the model picker when using openai-api-key auth (issue #136)
+- setup: revert hint null-normalization regression (details?.name ?? undefined)
+- setup: warn user when empty credential is entered during key rotation
+- setup: note that updated credential is saved but not re-validated
+- setup: openai-api-key now prioritizes gpt-4.1-nano, gpt-4.1-mini, and
+  gpt-5-nano in preferred model selection, and adds gpt-5-nano alias
+  resolution for OpenAI model lookup
+- setup: reconfigure now offers to update stored API key even when existing
+  credential is valid (issue #13)
+- embeddings: EmbeddingCache is now bounded with LRU eviction (default
+  max 5000 entries) to prevent unbounded heap growth during large ingests
+  (issue #57)
+- embeddings: EmbeddingCache constructor throws RangeError for maxSize < 1
+
 ## [0.8.2] - 2026-02-22
 
 ### Added

package/README.md

@@ -12,7 +12,7 @@ One local database. Your memory stays on your machine.
 
 AGENR uses embeddings to make your memory searchable. The best setup we've found: an **OpenAI API key** with `text-embedding-3-small`. Embeddings cost fractions of a penny per operation - a full ingestion of 100+ session transcripts runs about $0.10 total.
 
-AGENR also supports **OpenAI Pro subscriptions** and **Anthropic Claude subscriptions** (no API key needed) for the LLM extraction step. But for the best balance of speed, accuracy, and cost, we recommend `gpt-4o-mini` with an API key. `agenr setup` walks you through all of this.
+AGENR also supports **OpenAI Pro subscriptions** and **Anthropic Claude subscriptions** (no API key needed) for the LLM extraction step. But for the best balance of speed, accuracy, and cost, we recommend `gpt-4.1-nano` with an API key. `agenr setup` walks you through all of this.
 
 ```bash
 export OPENAI_API_KEY=sk-...  # for embeddings + extraction

package/dist/cli-main.js

@@ -43,7 +43,8 @@ var MODEL_ALIASES = {
     "gpt-codex": "gpt-5.2-codex",
     "gpt-4.1-nano": "openai/gpt-4.1-nano",
     "gpt-4.1-mini": "openai/gpt-4.1-mini",
-    "gpt-4.1": "openai/gpt-4.1"
+    "gpt-4.1": "openai/gpt-4.1",
+    "gpt-5-nano": "openai/gpt-5-nano"
   },
   "openai-codex": {
     codex: "gpt-5.3-codex",
@@ -138,7 +139,7 @@ var AUTH_METHOD_DEFINITIONS = [
     provider: "openai",
     title: "OpenAI -- API key",
     setupDescription: "Standard API key from platform.openai.com. Pay per token.",
-    preferredModels: ["gpt-4o", "openai/gpt-4.1-nano", "gpt-4o-mini"]
+    preferredModels: ["gpt-4.1-nano", "gpt-4.1-mini", "gpt-5-nano"]
   }
 ];
 var AUTH_METHOD_SET = new Set(AUTH_METHOD_DEFINITIONS.map((item) => item.id));
@@ -4533,12 +4534,75 @@ async function retireEntries(opts) {
 
 // src/embeddings/cache.ts
 var EmbeddingCache = class {
-  embeddings = /* @__PURE__ */ new Map();
+  maxSize;
+  map = /* @__PURE__ */ new Map();
+  head = null;
+  // most recently used key
+  tail = null;
+  // least recently used key
+  constructor(maxSize = 5e3) {
+    if (!(maxSize >= 1)) {
+      throw new RangeError(`EmbeddingCache maxSize must be at least 1. Received: ${String(maxSize)}.`);
+    }
+    this.maxSize = maxSize;
+  }
   get(text2) {
-    return this.embeddings.get(text2);
+    const node = this.map.get(text2);
+    if (!node) return void 0;
+    this.moveToHead(text2, node);
+    return node.value;
   }
   set(text2, embedding) {
-    this.embeddings.set(text2, embedding);
+    if (this.map.has(text2)) {
+      const node2 = this.map.get(text2);
+      node2.value = embedding;
+      this.moveToHead(text2, node2);
+      return;
+    }
+    if (this.map.size >= this.maxSize) {
+      this.evictTail();
+    }
+    const node = { value: embedding, prev: null, next: this.head };
+    this.map.set(text2, node);
+    if (this.head !== null) {
+      this.map.get(this.head).prev = text2;
+    }
+    this.head = text2;
+    if (this.tail === null) {
+      this.tail = text2;
+    }
+  }
+  get size() {
+    return this.map.size;
+  }
+  moveToHead(key, node) {
+    if (this.head === key) return;
+    if (node.prev !== null) {
+      this.map.get(node.prev).next = node.next;
+    }
+    if (node.next !== null) {
+      this.map.get(node.next).prev = node.prev;
+    } else {
+      this.tail = node.prev;
+    }
+    node.prev = null;
+    node.next = this.head;
+    if (this.head !== null) {
+      this.map.get(this.head).prev = key;
+    }
+    this.head = key;
+  }
+  evictTail() {
+    if (this.tail === null) return;
+    const tailKey = this.tail;
+    const tailNode = this.map.get(tailKey);
+    this.tail = tailNode.prev;
+    if (this.tail !== null) {
+      this.map.get(this.tail).next = null;
+    } else {
+      this.head = null;
+    }
+    this.map.delete(tailKey);
   }
 };
 
@@ -18131,7 +18195,14 @@ function promptToEnterCredential(auth) {
 function modelChoicesForAuth(auth, provider) {
   const definition = getAuthMethodDefinition(auth);
   const allModels = getModels(provider).map((model) => model.id);
-  const preferred = definition.preferredModels.filter((modelId) => allModels.includes(modelId));
+  const preferred = definition.preferredModels.filter((modelId) => {
+    try {
+      resolveModel(provider, modelId);
+      return true;
+    } catch {
+      return false;
+    }
+  });
   const fallback = allModels.filter((modelId) => !preferred.includes(modelId));
   if (provider === "openai") {
     const prioritizedFallback = fallback.filter(
@@ -18194,9 +18265,9 @@ async function runSetup(env = process.env) {
     storedCredentials: working.credentials,
     env
   });
+  const credentialKey = credentialKeyForAuth(auth);
   if (!probe.available) {
     clack11.log.warn(probe.guidance);
-    const credentialKey = credentialKeyForAuth(auth);
     if (credentialKey) {
       const shouldEnterNow = await clack11.confirm({
         message: "Enter the credential now?",
@@ -18225,6 +18296,36 @@ async function runSetup(env = process.env) {
         }
       }
     }
+  } else if (existing && credentialKey) {
+    const updateKey = await clack11.confirm({
+      message: "Update stored credential?",
+      initialValue: false
+    });
+    if (clack11.isCancel(updateKey)) {
+      clack11.cancel("Setup cancelled.");
+      return;
+    }
+    if (updateKey) {
+      const entered = await clack11.password({
+        message: promptToEnterCredential(auth)
+      });
+      if (clack11.isCancel(entered)) {
+        clack11.cancel("Setup cancelled.");
+        return;
+      }
+      const normalized = entered.trim();
+      if (normalized) {
+        working = setStoredCredential(working, credentialKey, normalized);
+        probe = probeCredentials({
+          auth,
+          storedCredentials: working.credentials,
+          env
+        });
+        clack11.log.info("Credential updated.");
+      } else {
+        clack11.log.warn("Credential not updated - empty input.");
+      }
+    }
   }
   const modelChoices = modelChoicesForAuth(auth, provider);
   if (modelChoices.length === 0) {

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "agenr",
   "name": "agenr Memory",
   "description": "Local memory layer - injects agenr context at session start",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "skills": [
     "skills"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenr",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "openclaw": {
     "extensions": [
       "dist/openclaw-plugin/index.js"