@letta-ai/letta-code 0.20.0 → 0.21.0

package/letta.js

@@ -3269,7 +3269,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@letta-ai/letta-code",
-    version: "0.20.0",
+    version: "0.21.0",
     description: "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
     type: "module",
     bin: {
@@ -53419,6 +53419,7 @@ function getShellEnv() {
   }
   if (convId) {
     env3.LETTA_CONVERSATION_ID = convId;
+    env3.CONVERSATION_ID = convId;
   }
   if (!env3.LETTA_API_KEY || !env3.LETTA_BASE_URL) {
     try {
@@ -69631,12 +69632,18 @@ async function executeTool(name, args, options) {
       }
       if (stdout) {
         for (let i = 0;i < stdout.length; i++) {
-          stdout[i] = scrubSecretsFromString(stdout[i]);
+          const line = stdout[i];
+          if (line !== undefined) {
+            stdout[i] = scrubSecretsFromString(line);
+          }
         }
       }
       if (stderr) {
         for (let i = 0;i < stderr.length; i++) {
-          stderr[i] = scrubSecretsFromString(stderr[i]);
+          const line = stderr[i];
+          if (line !== undefined) {
+            stderr[i] = scrubSecretsFromString(line);
+          }
         }
       }
     }
@@ -71886,7 +71893,7 @@ function emitSlashCommandEnd(socket, runtime, scope, fields) {
   };
   emitCanonicalMessageDelta(socket, runtime, endDelta, scope);
 }
-async function handleClearCommand(socket, conversationRuntime, opts) {
+async function handleClearCommand(_socket, conversationRuntime, opts) {
   const client = await getClient2();
   const agentId = conversationRuntime.agentId;
   if (!agentId) {
@@ -77977,7 +77984,7 @@ function getRelativeTime(dateStr) {
 }
 function buildAgentInfo(options) {
   try {
-    const { agentInfo, serverUrl } = options;
+    const { agentInfo, serverUrl, conversationId } = options;
     let actualServerUrl = LETTA_CLOUD_API_URL;
     try {
       const settings = settingsManager.getSettings();
@@ -78003,8 +78010,10 @@ function buildAgentInfo(options) {
     })();
     const memoryDirLine = showMemoryDir ? `
 - **Memory directory (also stored in \`MEMORY_DIR\` env var)**: \`${getMemoryFilesystemRoot(agentInfo.id)}\`` : "";
+    const convLine = conversationId ? `
+- **Conversation ID (also stored in \`CONVERSATION_ID\` env var)**: ${conversationId}` : "";
     return `${SYSTEM_REMINDER_OPEN} This is an automated message providing information about you.
-- **Agent ID (also stored in \`AGENT_ID\` env var)**: ${agentInfo.id}${memoryDirLine}
+- **Agent ID (also stored in \`AGENT_ID\` env var)**: ${agentInfo.id}${convLine}${memoryDirLine}
 - **Agent name**: ${agentInfo.name || "(unnamed)"} (the user can change this with /rename)
 - **Agent description**: ${agentInfo.description || "(no description)"} (the user can change this with /description)
 - **Last message**: ${lastRunInfo}
@@ -78449,7 +78458,8 @@ async function buildAgentInfoReminder(context3) {
       description: context3.agent.description,
       lastRunAt: context3.agent.lastRunAt
     },
-    serverUrl: context3.agent.serverUrl
+    serverUrl: context3.agent.serverUrl,
+    conversationId: context3.agent.conversationId
   });
   context3.state.hasSentAgentInfo = true;
   return reminder || null;
@@ -78728,7 +78738,8 @@ function buildListenReminderContext(params) {
       id: params.agentId,
       name: null,
       description: null,
-      lastRunAt: null
+      lastRunAt: null,
+      conversationId: params.conversationId
     },
     state: params.state,
     sessionContextReminderEnabled: true,
@@ -79265,6 +79276,7 @@ async function handleIncomingMessage(msg, socket, runtime, onStatusChange, conne
       try {
         const { parts: reminderParts } = await buildSharedReminderParts(buildListenReminderContext({
           agentId: agentId || "",
+          conversationId,
           state: runtime.reminderState,
           resolvePlanModeReminder: getPlanModeReminder,
           workingDirectory: turnWorkingDirectory
@@ -84587,7 +84599,8 @@ ${SYSTEM_REMINDER_CLOSE}
       id: agent.id,
       name: agent.name,
       description: agent.description,
-      lastRunAt: lastRunAt ?? null
+      lastRunAt: lastRunAt ?? null,
+      conversationId
     },
     state: sharedReminderState,
     sessionContextReminderEnabled: systemInfoReminderEnabled,
@@ -85867,7 +85880,8 @@ async function runBidirectionalMode(agent, conversationId, client, _outputFormat
             id: agent.id,
             name: agent.name,
             description: agent.description,
-            lastRunAt: lastRunAt ?? null
+            lastRunAt: lastRunAt ?? null,
+            conversationId
           },
           state: sharedReminderState,
           sessionContextReminderEnabled: systemInfoReminderEnabled,
@@ -119902,6 +119916,24 @@ async function warmMessageSearchCache(client) {
     body
   });
 }
+function isSearchRangeAvailable(range2, options) {
+  if (range2 === "agent")
+    return Boolean(options.agentId);
+  if (range2 === "conv")
+    return Boolean(options.conversationId);
+  return true;
+}
+function buildSearchTargetPlan(mode, range2, options) {
+  const availableRanges = SEARCH_RANGES.filter((candidateRange) => isSearchRangeAvailable(candidateRange, options));
+  const prefetch = [
+    ...SEARCH_MODES.filter((candidateMode) => candidateMode !== mode).map((candidateMode) => ({ mode: candidateMode, range: range2 })),
+    ...availableRanges.filter((candidateRange) => candidateRange !== range2).map((candidateRange) => ({ mode, range: candidateRange }))
+  ];
+  return {
+    primary: { mode, range: range2 },
+    prefetch
+  };
+}
 function formatLocalTime(dateStr) {
   if (!dateStr)
     return "";
@@ -120001,11 +120033,14 @@ function MessageSearch({
   const [selectedIndex, setSelectedIndex] = import_react79.useState(0);
   const [expandedMessage, setExpandedMessage] = import_react79.useState(null);
   const clientRef = import_react79.useRef(null);
+  const searchRequestIdRef = import_react79.useRef(0);
   const resultsCache = import_react79.useRef(new Map);
+  const pendingResultsCache = import_react79.useRef(new Map);
   import_react79.useEffect(() => {
     const warmCache = async () => {
       try {
         const client = await getClient2();
+        clientRef.current = client;
         await warmMessageSearchCache(client);
       } catch {}
     };
@@ -120029,73 +120064,81 @@ function MessageSearch({
     const searchResults = await client.post("/v1/messages/search", { body });
     return searchResults;
   }, [agentId, conversationId]);
+  const fetchAndCacheSearchResults = import_react79.useCallback(async (client, query, mode, range2) => {
+    const cacheKey = getCacheKey(query, mode, range2);
+    const cached = resultsCache.current.get(cacheKey);
+    if (cached) {
+      return cached;
+    }
+    const pending = pendingResultsCache.current.get(cacheKey);
+    if (pending) {
+      return pending;
+    }
+    if (!isSearchRangeAvailable(range2, { agentId, conversationId })) {
+      const emptyResults = [];
+      resultsCache.current.set(cacheKey, emptyResults);
+      return emptyResults;
+    }
+    const request = fetchSearchResults(client, query, mode, range2).then((searchResults) => {
+      resultsCache.current.set(cacheKey, searchResults);
+      return searchResults;
+    }).finally(() => {
+      pendingResultsCache.current.delete(cacheKey);
+    });
+    pendingResultsCache.current.set(cacheKey, request);
+    return request;
+  }, [agentId, conversationId, fetchSearchResults, getCacheKey]);
+  const prefetchSearchResults = import_react79.useCallback((query, mode, range2) => {
+    const { prefetch } = buildSearchTargetPlan(mode, range2, {
+      agentId,
+      conversationId
+    });
+    if (prefetch.length === 0) {
+      return;
+    }
+    (async () => {
+      try {
+        const client = clientRef.current || await getClient2();
+        clientRef.current = client;
+        await Promise.all(prefetch.map(({ mode: prefetchMode, range: prefetchRange }) => fetchAndCacheSearchResults(client, query, prefetchMode, prefetchRange).catch(() => [])));
+      } catch {}
+    })();
+  }, [agentId, conversationId, fetchAndCacheSearchResults]);
   const executeSearch = import_react79.useCallback(async (query, mode, range2) => {
     if (!query.trim())
       return;
     const cacheKey = getCacheKey(query, mode, range2);
+    const requestId = ++searchRequestIdRef.current;
     const cached = resultsCache.current.get(cacheKey);
+    setError(null);
     if (cached) {
+      setLoading(false);
       setResults(cached);
       setSelectedIndex(0);
+      prefetchSearchResults(query, mode, range2);
       return;
     }
     setLoading(true);
-    setError(null);
     try {
       const client = clientRef.current || await getClient2();
       clientRef.current = client;
-      const getOrFetch = (m, r2) => {
-        const key = getCacheKey(query, m, r2);
-        return resultsCache.current.get(key) ?? fetchSearchResults(client, query, m, r2);
-      };
-      const [
-        hybridAll,
-        vectorAll,
-        ftsAll,
-        hybridAgent,
-        vectorAgent,
-        ftsAgent,
-        hybridConv,
-        vectorConv,
-        ftsConv
-      ] = await Promise.all([
-        getOrFetch("hybrid", "all"),
-        getOrFetch("vector", "all"),
-        getOrFetch("fts", "all"),
-        agentId ? getOrFetch("hybrid", "agent") : Promise.resolve([]),
-        agentId ? getOrFetch("vector", "agent") : Promise.resolve([]),
-        agentId ? getOrFetch("fts", "agent") : Promise.resolve([]),
-        conversationId ? getOrFetch("hybrid", "conv") : Promise.resolve([]),
-        conversationId ? getOrFetch("vector", "conv") : Promise.resolve([]),
-        conversationId ? getOrFetch("fts", "conv") : Promise.resolve([])
-      ]);
-      resultsCache.current.set(getCacheKey(query, "hybrid", "all"), hybridAll);
-      resultsCache.current.set(getCacheKey(query, "vector", "all"), vectorAll);
-      resultsCache.current.set(getCacheKey(query, "fts", "all"), ftsAll);
-      if (agentId) {
-        resultsCache.current.set(getCacheKey(query, "hybrid", "agent"), hybridAgent);
-        resultsCache.current.set(getCacheKey(query, "vector", "agent"), vectorAgent);
-        resultsCache.current.set(getCacheKey(query, "fts", "agent"), ftsAgent);
-      }
-      if (conversationId) {
-        resultsCache.current.set(getCacheKey(query, "hybrid", "conv"), hybridConv);
-        resultsCache.current.set(getCacheKey(query, "vector", "conv"), vectorConv);
-        resultsCache.current.set(getCacheKey(query, "fts", "conv"), ftsConv);
-      }
-      const resultMap = {
-        hybrid: { all: hybridAll, agent: hybridAgent, conv: hybridConv },
-        vector: { all: vectorAll, agent: vectorAgent, conv: vectorConv },
-        fts: { all: ftsAll, agent: ftsAgent, conv: ftsConv }
-      };
-      setResults(resultMap[mode][range2]);
+      const primaryResults = await fetchAndCacheSearchResults(client, query, mode, range2);
+      if (searchRequestIdRef.current !== requestId) {
+        return;
+      }
+      setResults(primaryResults);
       setSelectedIndex(0);
+      setLoading(false);
+      prefetchSearchResults(query, mode, range2);
     } catch (err) {
+      if (searchRequestIdRef.current !== requestId) {
+        return;
+      }
       setError(err instanceof Error ? err.message : String(err));
       setResults([]);
-    } finally {
       setLoading(false);
     }
-  }, [fetchSearchResults, getCacheKey, agentId, conversationId]);
+  }, [fetchAndCacheSearchResults, getCacheKey, prefetchSearchResults]);
   const submitSearch = import_react79.useCallback(() => {
     if (searchInput.trim() && searchInput !== activeQuery) {
       setActiveQuery(searchInput);
@@ -135053,7 +135096,8 @@ ${SYSTEM_REMINDER_CLOSE}
         id: agentId,
         name: agentName,
         description: agentDescription,
-        lastRunAt: agentLastRunAt
+        lastRunAt: agentLastRunAt,
+        conversationId
       },
       state: sharedReminderStateRef.current,
       sessionContextReminderEnabled,
@@ -147488,4 +147532,4 @@ Error during initialization: ${message}`);
 }
 main();
 
-//# debugId=F7D039CC4FAF744E64756E2164756E21
+//# debugId=194DEEED08EA813D64756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
   "type": "module",
   "bin": {