@letta-ai/letta-code 0.13.3 → 0.13.4

package/README.md

@@ -16,7 +16,7 @@ npm install -g @letta-ai/letta-code
 Navigate to your project directory and run `letta` (see various command-line options [on the docs](https://docs.letta.com/letta-code/commands)). 
 
 > [!NOTE]
->  By default, Letta Code will connect to the [Letta Developer Platform](https://app.letta.com/) (includes a free tier), which you can connect to via OAuth or setting a `LETTA_API_KEY`. You can also connect it to a [self-hosted Letta server](https://docs.letta.com/letta-code/configuration#self-hosted-server) by setting `LETTA_BASE_URL`
+>  By default, Letta Code will connect to the [Letta API](https://app.letta.com/) (includes a free tier), which you can connect to via OAuth or setting a `LETTA_API_KEY`. You can also connect it to a [Docker server](https://docs.letta.com/letta-code/configuration#docker) by setting `LETTA_BASE_URL`
 
 ## Philosophy 
 Letta Code is built around long-lived agents that persist across sessions and improve with use. Rather than working in independent sessions, each session is tied to a persisted agent that learns.

package/letta.js

@@ -3065,7 +3065,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@letta-ai/letta-code",
-    version: "0.13.3",
+    version: "0.13.4",
     description: "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
     type: "module",
     bin: {
@@ -20010,7 +20010,7 @@ function buildSubagentArgs(type, config, model, userPrompt, existingAgentId, exi
     if (existingConversationId) {
       args.push("--conv", existingConversationId);
     } else if (existingAgentId) {
-      args.push("--agent", existingAgentId);
+      args.push("--agent", existingAgentId, "--new");
     }
     args.push("--no-skills");
   } else {
@@ -53584,11 +53584,7 @@ In headless mode, use:
   --conversation <id>  Resume a specific conversation by ID`);
     process.exit(1);
   }
-  if (values.new) {
-    console.error(`Error: --new has been renamed to --new-agent
-Usage: letta -p "..." --new-agent`);
-    process.exit(1);
-  }
+  const forceNewConversation = values.new ?? false;
   let agent = null;
   let specifiedAgentId = values.agent;
   let specifiedConversationId = values.conversation;
@@ -53643,6 +53639,16 @@ Usage: letta -p "..." --new-agent`);
       process.exit(1);
     }
   }
+  if (forceNewConversation) {
+    if (shouldContinue) {
+      console.error("Error: --new cannot be used with --continue");
+      process.exit(1);
+    }
+    if (specifiedConversationId) {
+      console.error("Error: --new cannot be used with --conversation");
+      process.exit(1);
+    }
+  }
   if (fromAfFile) {
     if (specifiedAgentId) {
       console.error("Error: --from-af cannot be used with --agent");
@@ -53873,26 +53879,24 @@ Usage: letta -p "..." --new-agent`);
           await client.conversations.retrieve(lastSession.conversationId);
           conversationId = lastSession.conversationId;
         } catch {
-          const conversation = await client.conversations.create({
-            agent_id: agent.id,
-            isolated_block_labels: isolatedBlockLabels
-          });
-          conversationId = conversation.id;
+          console.error(`Attempting to resume conversation ${lastSession.conversationId}, but conversation was not found.`);
+          console.error("Resume the default conversation with 'letta -p ...', view recent conversations with 'letta --resume', or start a new conversation with 'letta -p ... --new'.");
+          process.exit(1);
         }
       }
     } else {
-      const conversation = await client.conversations.create({
-        agent_id: agent.id,
-        isolated_block_labels: isolatedBlockLabels
-      });
-      conversationId = conversation.id;
+      console.error("No previous session found for this agent to resume.");
+      console.error("Resume the default conversation with 'letta -p ...', or start a new conversation with 'letta -p ... --new'.");
+      process.exit(1);
     }
-  } else {
+  } else if (forceNewConversation) {
     const conversation = await client.conversations.create({
       agent_id: agent.id,
       isolated_block_labels: isolatedBlockLabels
     });
     conversationId = conversation.id;
+  } else {
+    conversationId = "default";
   }
   markMilestone("HEADLESS_CONVERSATION_READY");
   if (!isSubagent) {
@@ -63076,22 +63080,14 @@ var init_registry = __esm(() => {
       }
     },
     "/clear": {
-      desc: "Start a new conversation (keep agent memory)",
+      desc: "Clear in-context messages",
       order: 18,
       handler: () => {
-        return "Starting new conversation...";
-      }
-    },
-    "/clear-messages": {
-      desc: "Reset all agent messages (destructive)",
-      order: 19,
-      hidden: true,
-      handler: () => {
-        return "Resetting agent messages...";
+        return "Clearing in-context messages...";
       }
     },
     "/new": {
-      desc: "Start a new conversation (same as /clear)",
+      desc: "Start a new conversation (keep agent memory)",
       order: 20,
       handler: () => {
         return "Starting new conversation...";
@@ -63292,7 +63288,6 @@ Location: ${keybindingsPath}`;
     },
     "/compact": {
       desc: "Summarize conversation history (compaction)",
-      hidden: true,
       handler: () => {
         return "Compacting conversation...";
       }
@@ -75673,7 +75668,13 @@ function App2({
         console.log(`[DEBUG] Header: resumedExistingConversation=${resumedExistingConversation}, messageHistory.length=${messageHistory.length}`);
       }
       const headerMessage = isResumingConversation ? `Resuming conversation with **${agentName2}**` : `Starting new conversation with **${agentName2}**`;
-      const commandHints = isPinned ? [
+      const commandHints = isResumingConversation ? [
+        "→ **/agents**    list all agents",
+        "→ **/resume**    browse all conversations",
+        "→ **/new**       start a new conversation",
+        "→ **/init**      initialize your agent's memory",
+        "→ **/remember**  teach your agent"
+      ] : isPinned ? [
         "→ **/agents**    list all agents",
         "→ **/resume**    resume a previous conversation",
         "→ **/memory**    view your agent's memory blocks",
@@ -76712,11 +76713,7 @@ ${newState.originalPrompt}`
     try {
       const client = await getClient2();
       const agent = await client.agents.retrieve(targetAgentId);
-      const newConversation = await client.conversations.create({
-        agent_id: targetAgentId,
-        isolated_block_labels: [...ISOLATED_BLOCK_LABELS]
-      });
-      const targetConversationId = newConversation.id;
+      const targetConversationId = "default";
       await updateProjectSettings({ lastAgent: targetAgentId });
       settingsManager.setLocalLastSession({ agentId: targetAgentId, conversationId: targetConversationId }, process.cwd());
       settingsManager.setGlobalLastSession({
@@ -76738,8 +76735,9 @@ ${newState.originalPrompt}`
       setConversationId(targetConversationId);
       const agentLabel = agent.name || targetAgentId;
       const successOutput = [
-        `Started a new conversation with **${agentLabel}**.`,
-        `⎿  Type /resume to resume a previous conversation`
+        `Resumed the default conversation with **${agentLabel}**.`,
+        `⎿  Type /resume to browse all conversations`,
+        `⎿  Type /new to start a new conversation`
       ].join(`
 `);
       const successItem = {
@@ -77444,7 +77442,7 @@ Type your task to begin the loop.`,
         }
         return { submitted: true };
       }
-      if (msg.trim() === "/clear" || msg.trim() === "/new") {
+      if (msg.trim() === "/new") {
         const cmdId2 = uid4("cmd");
         buffersRef.current.byId.set(cmdId2, {
           kind: "command",
@@ -77495,13 +77493,13 @@ Type your task to begin the loop.`,
         }
         return { submitted: true };
       }
-      if (msg.trim() === "/clear-messages") {
+      if (msg.trim() === "/clear") {
         const cmdId2 = uid4("cmd");
         buffersRef.current.byId.set(cmdId2, {
           kind: "command",
           id: cmdId2,
           input: msg,
-          output: "Resetting agent messages...",
+          output: "Clearing in-context messages...",
           phase: "running"
         });
         buffersRef.current.order.push(cmdId2);
@@ -80025,17 +80023,21 @@ Plan file path: ${planFilePath}`;
                     color: colors.link.url,
                     children: agentName && (settingsManager.getLocalPinnedAgents().includes(agentId) || settingsManager.getGlobalPinnedAgents().includes(agentId)) ? `letta -n "${agentName}"` : `letta --agent ${agentId}`
                   }, undefined, false, undefined, this),
-                  /* @__PURE__ */ jsx_dev_runtime61.jsxDEV(Text, {
-                    children: " "
-                  }, undefined, false, undefined, this),
-                  /* @__PURE__ */ jsx_dev_runtime61.jsxDEV(Text, {
-                    dimColor: true,
-                    children: "Resume this conversation with:"
-                  }, undefined, false, undefined, this),
-                  /* @__PURE__ */ jsx_dev_runtime61.jsxDEV(Text, {
-                    color: colors.link.url,
-                    children: `letta --conv ${conversationId}`
-                  }, undefined, false, undefined, this)
+                  conversationId !== "default" && /* @__PURE__ */ jsx_dev_runtime61.jsxDEV(jsx_dev_runtime61.Fragment, {
+                    children: [
+                      /* @__PURE__ */ jsx_dev_runtime61.jsxDEV(Text, {
+                        children: " "
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime61.jsxDEV(Text, {
+                        dimColor: true,
+                        children: "Resume this conversation with:"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime61.jsxDEV(Text, {
+                        color: colors.link.url,
+                        children: `letta --conv ${conversationId}`
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this)
                 ]
               }, undefined, true, undefined, this),
               /* @__PURE__ */ jsx_dev_runtime61.jsxDEV(Box_default, {
@@ -80934,6 +80936,10 @@ var init_release_notes = __esm(async () => {
   init_version();
   await init_settings_manager();
   releaseNotes = {
+    "0.13.4": `\uD83D\uDD04 **Letta Code 0.13.4: Back to the OG experience**
+→ Running **letta** now resumes your "default" conversation (instead of spawning a new one)
+→ Use **letta --new** if you want to create a new conversation for concurrent sessions
+→ Read more: https://docs.letta.com/letta-code/changelog#0134`,
     "0.13.0": `\uD83C\uDF81 **Letta Code 0.13.0: Introducing Conversations!**
 → Letta Code now starts a new conversation on each startup (memory is shared across all conversations)
 → Use **/resume** to switch conversations, or run **letta --continue** to continue an existing conversation
@@ -83807,10 +83813,11 @@ Letta Code is a general purpose CLI for interacting with Letta agents
 
 USAGE
   # interactive TUI
-  letta                 Resume from profile or create new agent (shows selector)
+  letta                 Resume default conversation (OG single-threaded experience)
+  letta --new           Create a new conversation (for concurrent sessions)
   letta --continue      Resume last session (agent + conversation) directly
   letta --resume        Open agent selector UI to pick agent/conversation
-  letta --new           Create a new agent directly (skip profile selector)
+  letta --new-agent     Create a new agent directly (skip profile selector)
   letta --agent <id>    Open a specific agent by ID
 
   # headless
@@ -83825,9 +83832,10 @@ OPTIONS
   --info                Show current directory, skills, and pinned agents
   --continue            Resume last session (agent + conversation) directly
   -r, --resume          Open agent selector UI after loading
-  --new                 Create new agent directly (skip profile selection)
-  --init-blocks <list>  Comma-separated memory blocks to initialize when using --new (e.g., "persona,skills")
-  --base-tools <list>   Comma-separated base tools to attach when using --new (e.g., "memory,web_search,conversation_search")
+  --new                 Create new conversation (for concurrent sessions)
+  --new-agent           Create new agent directly (skip profile selection)
+  --init-blocks <list>  Comma-separated memory blocks to initialize when using --new-agent (e.g., "persona,skills")
+  --base-tools <list>   Comma-separated base tools to attach when using --new-agent (e.g., "memory,web_search,conversation_search")
   -a, --agent <id>      Use a specific agent ID
   -n, --name <name>     Resume agent by name (from pinned agents, case-insensitive)
   -m, --model <id>      Model ID or handle (e.g., "opus-4.5" or "anthropic/claude-opus-4-5")
@@ -84118,11 +84126,7 @@ Note: Flags should use double dashes for full names (e.g., --yolo, not -yolo)`);
     }
     specifiedConversationId = "default";
   }
-  if (values.new) {
-    console.error(`Error: --new has been renamed to --new-agent
-Usage: letta --new-agent`);
-    process.exit(1);
-  }
+  const forceNewConversation = values.new ?? false;
   const initBlocksRaw = values["init-blocks"];
   const baseToolsRaw = values["base-tools"];
   let specifiedAgentId = values.agent ?? null;
@@ -84246,6 +84250,20 @@ Usage: letta --new-agent`);
       process.exit(1);
     }
   }
+  if (forceNewConversation) {
+    if (shouldContinue) {
+      console.error("Error: --new cannot be used with --continue");
+      process.exit(1);
+    }
+    if (specifiedConversationId) {
+      console.error("Error: --new cannot be used with --conversation");
+      process.exit(1);
+    }
+    if (shouldResume) {
+      console.error("Error: --new cannot be used with --resume");
+      process.exit(1);
+    }
+  }
   if (fromAfFile) {
     if (specifiedAgentId) {
       console.error("Error: --from-af cannot be used with --agent");
@@ -84856,11 +84874,9 @@ Error: ${message}`);
             }
           }
           if (!resumedSuccessfully) {
-            const conversation = await client.conversations.create({
-              agent_id: agent.id,
-              isolated_block_labels: [...ISOLATED_BLOCK_LABELS2]
-            });
-            conversationIdToUse = conversation.id;
+            console.error(`Attempting to resume conversation ${lastSession?.conversationId ?? "(unknown)"}, but conversation was not found.`);
+            console.error("Resume the default conversation with 'letta', view recent conversations with 'letta --resume', or start a new conversation with 'letta --new'.");
+            process.exit(1);
           }
         } else if (selectedConversationId) {
           try {
@@ -84877,12 +84893,19 @@ Error: ${message}`);
             }
             throw error;
           }
-        } else {
+        } else if (forceNewConversation) {
           const conversation = await client.conversations.create({
             agent_id: agent.id,
             isolated_block_labels: [...ISOLATED_BLOCK_LABELS2]
           });
           conversationIdToUse = conversation.id;
+        } else {
+          conversationIdToUse = "default";
+          setLoadingState("checking");
+          const freshAgent = await client.agents.retrieve(agent.id);
+          const data = await getResumeData(client, freshAgent, "default");
+          setResumeData(data);
+          setResumedExistingConversation(true);
         }
         const isSubagent = process.env.LETTA_CODE_AGENT_ROLE === "subagent";
         if (!isSubagent) {
@@ -85010,4 +85033,4 @@ Error during initialization: ${message}`);
 }
 main();
 
-//# debugId=A2D04DEC6336411264756E2164756E21
+//# debugId=C994E1F7CD4B4AD164756E2164756E21

package/package.json

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