@letta-ai/letta-code 0.27.26 → 0.27.27

package/letta.js

@@ -4672,7 +4672,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@letta-ai/letta-code",
-    version: "0.27.26",
+    version: "0.27.27",
     description: "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
     type: "module",
     packageManager: "bun@1.3.0",
@@ -424479,6 +424479,19 @@ var init_reflection_threshold_feedback = __esm(() => {
 });
 
 // src/cli/helpers/reflection-launcher.ts
+var exports_reflection_launcher = {};
+__export(exports_reflection_launcher, {
+  tryReserveReflectionLaunch: () => tryReserveReflectionLaunch,
+  shouldRunQueuedReflectionLaunch: () => shouldRunQueuedReflectionLaunch,
+  releaseReflectionLaunch: () => releaseReflectionLaunch,
+  queuePendingReflectionWorktreeReminders: () => queuePendingReflectionWorktreeReminders,
+  prepareReflectionMemoryWorktreeLaunch: () => prepareReflectionMemoryWorktreeLaunch,
+  launchReflectionSubagent: () => launchReflectionSubagent,
+  formatReflectionIntegrationReminder: () => formatReflectionIntegrationReminder,
+  finalizeReflectionMemoryWorktreeLaunch: () => finalizeReflectionMemoryWorktreeLaunch,
+  REFLECTION_AGENT_ID_WAIT_MS: () => REFLECTION_AGENT_ID_WAIT_MS,
+  AUTO_REFLECTION_DESCRIPTION: () => AUTO_REFLECTION_DESCRIPTION
+});
 function drainReflectionTelemetry() {
   telemetry.drain().catch((error54) => {
     debugWarn("telemetry", `Failed to flush reflection telemetry: ${error54 instanceof Error ? error54.message : String(error54)}`);
@@ -444764,6 +444777,37 @@ function trackListenerError3(errorType, error54, context3) {
     context: context3
   });
 }
+async function awaitMemoryPushBounded(commandName, agentId, memoryRoot) {
+  const { syncPendingMemoryCommitsAfterTurn: syncPendingMemoryCommitsAfterTurn2 } = await Promise.resolve().then(() => (init_memory_git(), exports_memory_git));
+  const syncPromise = syncPendingMemoryCommitsAfterTurn2(agentId, {
+    memoryDir: memoryRoot
+  });
+  const warnOnFailure = (result) => {
+    if (result.status === "push_failed" || result.status === "conflict") {
+      console.warn(`[${commandName}] push failed for ${agentId}: ${result.summary}`);
+    }
+  };
+  let timer;
+  const capPromise = new Promise((resolve31) => {
+    timer = setTimeout(() => resolve31("timed_out"), MEMORY_PUSH_AWAIT_CAP_MS);
+  });
+  try {
+    const result = await Promise.race([syncPromise, capPromise]);
+    if (result === "timed_out") {
+      console.warn(`[${commandName}] push still in flight after ${MEMORY_PUSH_AWAIT_CAP_MS}ms for ${agentId}; responding now, push continues in background`);
+      syncPromise.then(warnOnFailure).catch((err) => {
+        console.warn(`[${commandName}] background push failed for ${agentId}:`, err instanceof Error ? err.message : err);
+      });
+      return;
+    }
+    warnOnFailure(result);
+  } catch (err) {
+    console.warn(`[${commandName}] push failed for ${agentId}:`, err instanceof Error ? err.message : err);
+  } finally {
+    if (timer)
+      clearTimeout(timer);
+  }
+}
 async function handleListMemoryCommand(parsed, socket, safeSocketSend, overrides = {}) {
   try {
     const {
@@ -445215,12 +445259,7 @@ function handleMemoryProtocolCommand(parsed, context3) {
           ...memorySyncMode ? { syncMode: memorySyncMode } : {}
         });
         if (commitResult.committed && !memorySyncMode) {
-          const { syncPendingMemoryCommitsAfterTurn: syncPendingMemoryCommitsAfterTurn2 } = await Promise.resolve().then(() => (init_memory_git(), exports_memory_git));
-          syncPendingMemoryCommitsAfterTurn2(parsed.agent_id, {
-            memoryDir: memoryRoot
-          }).catch((err) => {
-            console.warn(`[write_memory_file] background push failed for ${parsed.agent_id}:`, err instanceof Error ? err.message : err);
-          });
+          await awaitMemoryPushBounded("write_memory_file", parsed.agent_id, memoryRoot);
         }
         if (commitResult.committed) {
           safeSocketSend(socket, {
@@ -445333,12 +445372,7 @@ function handleMemoryProtocolCommand(parsed, context3) {
           ...memorySyncMode ? { syncMode: memorySyncMode } : {}
         });
         if (commitResult.committed && !memorySyncMode) {
-          const { syncPendingMemoryCommitsAfterTurn: syncPendingMemoryCommitsAfterTurn2 } = await Promise.resolve().then(() => (init_memory_git(), exports_memory_git));
-          syncPendingMemoryCommitsAfterTurn2(parsed.agent_id, {
-            memoryDir: memoryRoot
-          }).catch((err) => {
-            console.warn(`[delete_memory_file] background push failed for ${parsed.agent_id}:`, err instanceof Error ? err.message : err);
-          });
+          await awaitMemoryPushBounded("delete_memory_file", parsed.agent_id, memoryRoot);
         }
         if (commitResult.committed) {
           safeSocketSend(socket, {
@@ -445366,7 +445400,7 @@ function handleMemoryProtocolCommand(parsed, context3) {
   }
   return false;
 }
-var WIKI_LINK_REGEX, IMAGE_MIME_BY_EXTENSION;
+var WIKI_LINK_REGEX, IMAGE_MIME_BY_EXTENSION, MEMORY_PUSH_AWAIT_CAP_MS = 8000;
 var init_memory6 = __esm(async () => {
   init_error_reporting();
   await init_protocol_inbound();
@@ -485078,7 +485112,7 @@ var init_ToolCallMessageRich = __esm(async () => {
       let shellSemanticKind = null;
       let hasShellDescription = false;
       if (!isQuestionTool(rawName)) {
-        const parseArgs14 = () => {
+        const parseArgs15 = () => {
           if (!argsText.trim()) {
             return { formatted: null, parseable: true };
           }
@@ -485092,7 +485126,7 @@ var init_ToolCallMessageRich = __esm(async () => {
             return { formatted: null, parseable: false };
           }
         };
-        const { formatted, parseable } = parseArgs14();
+        const { formatted, parseable } = parseArgs15();
         const argsComplete = parseable || line.phase === "running" || line.phase === "finished" || !isStreaming;
         if (!argsComplete) {
           args = "(…)";
@@ -487309,7 +487343,7 @@ function updateCommandResult(buffersRef, refreshDerived, cmdId, input, output, s
   buffersRef.current.byId.set(cmdId, line);
   refreshDerived();
 }
-function parseArgs14(msg) {
+function parseArgs15(msg) {
   return msg.trim().split(/\s+/).filter(Boolean);
 }
 function formatConnectUsage() {
@@ -487664,7 +487698,7 @@ ${formatBedrockUsage2()}`, false);
   }
 }
 async function handleConnect(ctx, msg) {
-  const parts = parseArgs14(msg);
+  const parts = parseArgs15(msg);
   const providerToken = parts[1];
   if (!providerToken) {
     addCommandResult(ctx.buffersRef, ctx.refreshDerived, msg, formatConnectUsage(), false);
@@ -526575,12 +526609,195 @@ async function runCronSubcommand(argv) {
   }
 }
 
+// src/cli/subcommands/dream.ts
+init_settings_manager();
+import { parseArgs as parseArgs7 } from "node:util";
+function printUsage5() {
+  console.log(`
+Usage:
+  letta dream [options]
+
+Run a memory reflection pass for an agent and wait for it to finish.
+
+Options:
+  --memory <agent-id>         Agent whose memory to refine (default:
+                              $LETTA_AGENT_ID, then the last-used agent)
+  --from <conv-id>            Conversation transcript to reflect on
+                              (default: the agent's primary "default" history)
+  --to <spec>                 Render target (reserved; not yet implemented)
+  --effort <level>            Reflection effort (reserved; not yet implemented)
+  --timeout <seconds>         Fail if the reflection pass has not completed
+                              in this many seconds (default: 1500)
+  -i, --instruction <text>    Additional instruction for the reflection pass
+  --json                      Emit machine-readable JSON output
+  -h, --help                  Show this help
+
+Notes:
+  - Requires the memory filesystem to be enabled for the agent.
+  - Processes conversation transcript content recorded since the last
+    successful reflection; exits 0 with no action when nothing is new.
+`.trim());
+}
+var DREAM_OPTIONS = {
+  help: { type: "boolean", short: "h" },
+  memory: { type: "string" },
+  from: { type: "string" },
+  to: { type: "string" },
+  effort: { type: "string" },
+  timeout: { type: "string" },
+  instruction: { type: "string", short: "i" },
+  json: { type: "boolean" }
+};
+var DEFAULT_TIMEOUT_SECONDS = 1500;
+function parseDreamArgs(argv) {
+  return parseArgs7({
+    args: argv,
+    options: DREAM_OPTIONS,
+    strict: true,
+    allowPositionals: true
+  });
+}
+function emitJson(payload) {
+  console.log(JSON.stringify(payload));
+}
+async function runDreamSubcommand(argv) {
+  let parsed;
+  try {
+    parsed = parseDreamArgs(argv);
+  } catch (error54) {
+    const message = error54 instanceof Error ? error54.message : String(error54);
+    console.error(`Error: ${message}`);
+    printUsage5();
+    return 1;
+  }
+  const [action3] = parsed.positionals;
+  if (parsed.values.help || action3 === "help") {
+    printUsage5();
+    return 0;
+  }
+  if (action3) {
+    console.error(`Unknown argument: ${action3}`);
+    printUsage5();
+    return 1;
+  }
+  const asJson = Boolean(parsed.values.json);
+  if (!asJson && (parsed.values.to || parsed.values.effort)) {
+    console.error("Note: --to and --effort are accepted but not yet implemented; ignoring.");
+  }
+  let timeoutSeconds = DEFAULT_TIMEOUT_SECONDS;
+  if (parsed.values.timeout) {
+    timeoutSeconds = Number.parseInt(parsed.values.timeout, 10);
+    if (!Number.isFinite(timeoutSeconds) || timeoutSeconds <= 0) {
+      console.error(`Error: Invalid --timeout "${parsed.values.timeout}"`);
+      return 1;
+    }
+  }
+  await settingsManager.initialize();
+  const agentId = parsed.values.memory || process.env.LETTA_AGENT_ID || settingsManager.getGlobalLastAgentId() || "";
+  if (!agentId) {
+    console.error("Missing agent id. Pass --memory <agent-id>, set LETTA_AGENT_ID, or run a session first.");
+    return 1;
+  }
+  if (!settingsManager.isMemfsEnabled(agentId)) {
+    if (asJson) {
+      emitJson({ launched: false, reason: "memfs_disabled", agentId });
+    } else {
+      console.error(`Memory filesystem is not enabled for ${agentId}. Nothing to do.`);
+    }
+    return 1;
+  }
+  const conversationId = parsed.values.from || "default";
+  const { launchReflectionSubagent: launchReflectionSubagent2 } = await Promise.resolve().then(() => (init_reflection_launcher(), exports_reflection_launcher));
+  let resolveCompletion;
+  const completion = new Promise((resolve31) => {
+    resolveCompletion = resolve31;
+  });
+  const result = await launchReflectionSubagent2({
+    agentId,
+    conversationId,
+    memfsEnabled: true,
+    triggerSource: "manual",
+    description: "Reflect on recent conversations",
+    instruction: parsed.values.instruction,
+    recompileByConversation: new Map,
+    recompileQueuedByConversation: new Set,
+    onCompletionMessage: (message, completionResult) => {
+      resolveCompletion({
+        success: completionResult.success,
+        error: completionResult.error,
+        message
+      });
+    },
+    feedbackContext: {
+      surface: "letta_code_cli"
+    }
+  });
+  if (!result.launched) {
+    if (asJson) {
+      emitJson({ launched: false, reason: result.reason, agentId });
+      return result.reason === "no_payload" ? 0 : 1;
+    }
+    switch (result.reason) {
+      case "no_payload":
+        console.log("No new transcript content to process.");
+        return 0;
+      case "already_active":
+        console.error("A reflection pass is already running for this agent.");
+        return 1;
+      case "memfs_disabled":
+        console.error(`Memory filesystem is not enabled for ${agentId}.`);
+        return 1;
+      default: {
+        const message = result.error instanceof Error ? result.error.message : String(result.error ?? "Unknown error");
+        console.error(`Failed to start reflection pass: ${message}`);
+        return 1;
+      }
+    }
+  }
+  if (!asJson) {
+    console.log(`Processing transcript: ${result.payloadPath}`);
+  }
+  let timedOut = false;
+  let timeoutHandle;
+  const timeout = new Promise((resolve31) => {
+    timeoutHandle = setTimeout(() => {
+      timedOut = true;
+      resolve31({
+        success: false,
+        error: "timeout",
+        message: `Reflection pass did not complete within ${timeoutSeconds}s.`
+      });
+    }, timeoutSeconds * 1000);
+  });
+  const outcome = await Promise.race([completion, timeout]);
+  if (timeoutHandle !== undefined) {
+    clearTimeout(timeoutHandle);
+  }
+  if (asJson) {
+    emitJson({
+      launched: true,
+      success: outcome.success,
+      message: outcome.message,
+      ...outcome.error ? { error: outcome.error } : {},
+      ...timedOut ? { timedOut: true } : {},
+      agentId,
+      conversationId,
+      transcriptPath: result.payloadPath
+    });
+  } else if (outcome.success) {
+    console.log(outcome.message);
+  } else {
+    console.error(outcome.message);
+  }
+  return outcome.success ? 0 : 1;
+}
+
 // src/cli/subcommands/environments.ts
 init_environments2();
 init_settings_manager();
 init_version();
-import { parseArgs as parseArgs7 } from "node:util";
-function printUsage5() {
+import { parseArgs as parseArgs8 } from "node:util";
+function printUsage6() {
   console.log(`
 Usage:
   letta environments list [options]
@@ -526654,7 +526871,7 @@ var ENVIRONMENTS_OPTIONS = {
   "online-only": { type: "boolean" }
 };
 function parseEnvironmentsArgs(argv) {
-  return parseArgs7({
+  return parseArgs8({
     args: argv,
     options: ENVIRONMENTS_OPTIONS,
     strict: true,
@@ -526668,17 +526885,17 @@ async function runEnvironmentsSubcommand(argv, deps = {}) {
   } catch (error54) {
     const message = error54 instanceof Error ? error54.message : String(error54);
     console.error(`Error: ${message}`);
-    printUsage5();
+    printUsage6();
     return 1;
   }
   const [action3] = parsed.positionals;
   if (parsed.values.help || !action3 || action3 === "help") {
-    printUsage5();
+    printUsage6();
     return 0;
   }
   if (action3 !== "list" && action3 !== "current") {
     console.error(`Unknown action: ${action3}`);
-    printUsage5();
+    printUsage6();
     return 1;
   }
   await (deps.initializeSettings ?? (() => settingsManager.initialize()))();
@@ -526737,7 +526954,7 @@ await __promiseAll([
 ]);
 var import_react33 = __toESM(require_react(), 1);
 import { hostname as hostname6 } from "node:os";
-import { parseArgs as parseArgs8 } from "node:util";
+import { parseArgs as parseArgs9 } from "node:util";
 import { MessageChannel as MessageChannel2 } from "node:worker_threads";
 
 // src/cli/components/ListenerStatusUI.tsx
@@ -527120,7 +527337,7 @@ function printListenUsage() {
 async function runListenSubcommand(argv) {
   let values2;
   try {
-    ({ values: values2 } = parseArgs8({
+    ({ values: values2 } = parseArgs9({
       args: argv,
       options: LISTEN_OPTIONS,
       strict: true,
@@ -527480,7 +527697,7 @@ async function runListenSubcommand(argv) {
 
 // src/cli/subcommands/local-backend.ts
 init_paths();
-import { parseArgs as parseArgs9 } from "node:util";
+import { parseArgs as parseArgs10 } from "node:util";
 
 // src/backend/local/transcript-migration.ts
 init_local_store();
@@ -527890,13 +528107,13 @@ var LOCAL_BACKEND_OPTIONS = {
   "dry-run": { type: "boolean" }
 };
 function parseLocalBackendArgs(argv) {
-  return parseArgs9({
+  return parseArgs10({
     args: argv,
     options: LOCAL_BACKEND_OPTIONS,
     strict: true
   });
 }
-function printUsage6() {
+function printUsage7() {
   console.log(`
 Usage:
   letta local-backend migrate-transcripts [--storage-dir <path>] [--dry-run]
@@ -527909,12 +528126,12 @@ before it is replaced.
 async function runLocalBackendSubcommand(argv) {
   const [command, ...rest3] = argv;
   if (!command || command === "help" || command === "--help" || command === "-h") {
-    printUsage6();
+    printUsage7();
     return command ? 0 : 1;
   }
   if (command !== "migrate-transcripts") {
     console.error(`Unknown local-backend command: ${command}`);
-    printUsage6();
+    printUsage7();
     return 1;
   }
   let parsed;
@@ -527923,11 +528140,11 @@ async function runLocalBackendSubcommand(argv) {
   } catch (error54) {
     const message = error54 instanceof Error ? error54.message : String(error54);
     console.error(`Error: ${message}`);
-    printUsage6();
+    printUsage7();
     return 1;
   }
   if (parsed.values.help) {
-    printUsage6();
+    printUsage7();
     return 0;
   }
   const storageDir = parsed.values["storage-dir"] ?? getLocalBackendStorageDir();
@@ -527946,7 +528163,7 @@ init_paths();
 import { cpSync, existsSync as existsSync49, mkdirSync as mkdirSync33, rmSync as rmSync10, statSync as statSync17 } from "node:fs";
 import { readdir as readdir12 } from "node:fs/promises";
 import { dirname as dirname27, join as join53 } from "node:path";
-import { parseArgs as parseArgs10 } from "node:util";
+import { parseArgs as parseArgs11 } from "node:util";
 
 // src/cli/subcommands/memory-tokens.ts
 init_system_prompt_size();
@@ -528027,7 +528244,7 @@ async function runMemoryTokensAction(options3) {
 }
 
 // src/cli/subcommands/memory.ts
-function printUsage7() {
+function printUsage8() {
   console.log(`
 Usage:
   letta memory status [--agent <id>]
@@ -528072,7 +528289,7 @@ var MEMORY_OPTIONS = {
   quiet: { type: "boolean" }
 };
 function parseMemoryArgs(argv) {
-  return parseArgs10({
+  return parseArgs11({
     args: argv,
     options: MEMORY_OPTIONS,
     strict: true,
@@ -528133,12 +528350,12 @@ async function runMemorySubcommand(argv) {
   } catch (error54) {
     const message = error54 instanceof Error ? error54.message : String(error54);
     console.error(`Error: ${message}`);
-    printUsage7();
+    printUsage8();
     return 1;
   }
   const [action3] = parsed.positionals;
   if (parsed.values.help || !action3 || action3 === "help") {
-    printUsage7();
+    printUsage8();
     return 0;
   }
   const agentId = getAgentId4(parsed.values.agent, parsed.values["agent-id"]);
@@ -528281,7 +528498,7 @@ async function runMemorySubcommand(argv) {
     return 1;
   }
   console.error(`Unknown action: ${action3}`);
-  printUsage7();
+  printUsage8();
   return 1;
 }
 
@@ -528291,8 +528508,8 @@ init_message_search();
 init_settings_manager();
 import { writeFile as writeFile15 } from "node:fs/promises";
 import { resolve as resolve31 } from "node:path";
-import { parseArgs as parseArgs11 } from "node:util";
-function printUsage8() {
+import { parseArgs as parseArgs12 } from "node:util";
+function printUsage9() {
   console.log(`
 Usage:
   letta messages search --query <text> [options]
@@ -528396,7 +528613,7 @@ var MESSAGES_OPTIONS = {
   output: { type: "string" }
 };
 function parseMessagesArgs(argv) {
-  return parseArgs11({
+  return parseArgs12({
     args: argv,
     options: MESSAGES_OPTIONS,
     strict: true,
@@ -528410,12 +528627,12 @@ async function runMessagesSubcommand(argv, deps = {}) {
   } catch (error54) {
     const message = error54 instanceof Error ? error54.message : String(error54);
     console.error(`Error: ${message}`);
-    printUsage8();
+    printUsage9();
     return 1;
   }
   const [action3] = parsed.positionals;
   if (parsed.values.help || !action3 || action3 === "help") {
-    printUsage8();
+    printUsage9();
     return 0;
   }
   try {
@@ -528657,7 +528874,7 @@ async function runMessagesSubcommand(argv, deps = {}) {
     return 1;
   }
   console.error(`Unknown action: ${action3}`);
-  printUsage8();
+  printUsage9();
   return 1;
 }
 
@@ -528665,7 +528882,7 @@ async function runMessagesSubcommand(argv, deps = {}) {
 init_memory_filesystem2();
 await init_mod_engine();
 import { dirname as dirname28, join as join55 } from "node:path";
-import { parseArgs as parseArgs12 } from "node:util";
+import { parseArgs as parseArgs13 } from "node:util";
 
 // src/mods/package-installer.ts
 init_file_extensions();
@@ -529680,7 +529897,7 @@ var MODS_PACKAGE_OPTIONS = {
   out: { type: "string" }
 };
 var RELOAD_HINT = "Run /reload in active sessions for changes to take effect.";
-function printUsage9() {
+function printUsage10() {
   console.log(`
 Usage:
   letta mods list [--agent <id>]
@@ -529697,7 +529914,7 @@ Options:
 `.trim());
 }
 function parseModsArgs(argv) {
-  return parseArgs12({
+  return parseArgs13({
     args: argv,
     options: MODS_OPTIONS,
     strict: true,
@@ -529705,7 +529922,7 @@ function parseModsArgs(argv) {
   });
 }
 function parseModsPackageArgs(argv) {
-  return parseArgs12({
+  return parseArgs13({
     args: argv,
     options: MODS_PACKAGE_OPTIONS,
     strict: true,
@@ -529803,16 +530020,16 @@ async function runList(argv, options3 = {}) {
     parsed = parseModsArgs(argv);
   } catch (error54) {
     console.error(`Error: ${error54 instanceof Error ? error54.message : String(error54)}`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   if (parsed.values.help) {
-    printUsage9();
+    printUsage10();
     return 0;
   }
   if (parsed.positionals.length > 0) {
     console.error(`Unexpected argument: ${parsed.positionals[0]}`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   const agentId = getExplicitAgentId(parsed.values);
@@ -529829,27 +530046,27 @@ async function runPackageMutation(action3, argv, options3 = {}) {
     parsed = parseModsArgs(argv);
   } catch (error54) {
     console.error(`Error: ${error54 instanceof Error ? error54.message : String(error54)}`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   if (parsed.values.help) {
-    printUsage9();
+    printUsage10();
     return 0;
   }
   if (getExplicitAgentId(parsed.values)) {
     console.error(`--agent is only supported for 'letta mods list'.`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   const [specifier, extra] = parsed.positionals;
   if (!specifier) {
     console.error(`Missing package specifier.`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   if (extra) {
     console.error(`Unexpected argument: ${extra}`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   try {
@@ -529875,27 +530092,27 @@ async function runPackageUpdate(argv, options3 = {}) {
     parsed = parseModsArgs(argv);
   } catch (error54) {
     console.error(`Error: ${error54 instanceof Error ? error54.message : String(error54)}`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   if (parsed.values.help) {
-    printUsage9();
+    printUsage10();
     return 0;
   }
   if (getExplicitAgentId(parsed.values)) {
     console.error(`--agent is not supported for 'letta mods update'.`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   const [specifier, extra] = parsed.positionals;
   if (!specifier) {
     console.error(`Missing package specifier.`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   if (extra) {
     console.error(`Unexpected argument: ${extra}`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   try {
@@ -529917,33 +530134,33 @@ async function runPackageScaffold(argv) {
     parsed = parseModsPackageArgs(argv);
   } catch (error54) {
     console.error(`Error: ${error54 instanceof Error ? error54.message : String(error54)}`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   if (parsed.values.help) {
-    printUsage9();
+    printUsage10();
     return 0;
   }
   if (getExplicitAgentId(parsed.values)) {
     console.error(`--agent is not supported for 'letta mods package'.`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   const [sourceFile, extra] = parsed.positionals;
   if (!sourceFile) {
     console.error(`Missing mod file.`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   if (extra) {
     console.error(`Unexpected argument: ${extra}`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   const packageName = parsed.values.name;
   if (typeof packageName !== "string" || !packageName.trim()) {
     console.error(`Missing required --name <package-name>.`);
-    printUsage9();
+    printUsage10();
     return 1;
   }
   try {
@@ -529965,7 +530182,7 @@ async function runPackageScaffold(argv) {
 async function runModsSubcommand(argv, options3 = {}) {
   const [action3, ...rest3] = argv;
   if (!action3 || action3 === "help" || action3 === "--help" || action3 === "-h") {
-    printUsage9();
+    printUsage10();
     return 0;
   }
   switch (action3) {
@@ -529981,7 +530198,7 @@ async function runModsSubcommand(argv, options3 = {}) {
       return runPackageMutation(action3, rest3, options3);
     default:
       console.error(`Unknown mods action: ${action3}`);
-      printUsage9();
+      printUsage10();
       return 1;
   }
 }
@@ -530019,7 +530236,7 @@ async function runSetup(options3 = {}) {
 
 // src/cli/subcommands/setup.ts
 init_settings_manager();
-function printUsage10() {
+function printUsage11() {
   console.log(`
 Usage:
   letta setup
@@ -530030,12 +530247,12 @@ Re-run the interactive setup menu to choose local mode or Login to Constellation
 async function runSetupSubcommand(argv) {
   const [arg, ...rest3] = argv;
   if (arg === "help" || arg === "--help" || arg === "-h") {
-    printUsage10();
+    printUsage11();
     return 0;
   }
   if (arg || rest3.length > 0) {
     console.error(`Unexpected arguments: ${[arg, ...rest3].filter(Boolean).join(" ")}`);
-    printUsage10();
+    printUsage11();
     return 1;
   }
   await settingsManager.initialize();
@@ -530056,14 +530273,14 @@ import {
 import { mkdir as mkdir13, readdir as readdir13 } from "node:fs/promises";
 import { tmpdir as tmpdir9 } from "node:os";
 import { basename as basename24, dirname as dirname29, join as join56, normalize as normalize5, resolve as resolve32, sep as sep6 } from "node:path";
-import { parseArgs as parseArgs13, TextDecoder as TextDecoder2, TextEncoder as TextEncoder2 } from "node:util";
+import { parseArgs as parseArgs14, TextDecoder as TextDecoder2, TextEncoder as TextEncoder2 } from "node:util";
 init_paths2();
 var HERMES_REPO_URL = "https://github.com/NousResearch/hermes-agent.git";
 var HERMES_OPTIONAL_SKILLS_DIR = "optional-skills";
 var MAX_DIRECT_SKILL_FILE_BYTES = 1024 * 1024;
 var CLAWHUB_API_BASE_URL = "https://clawhub.ai/api/v1";
 var activeAgentPromptStatus = null;
-function printUsage11() {
+function printUsage12() {
   console.log(`
 Usage:
   letta install <thing> [--agent <id> | -n <agent name>] [--force]
@@ -530097,7 +530314,7 @@ var SKILLS_OPTIONS = {
   force: { type: "boolean" }
 };
 function parseSkillsArgs(argv) {
-  return parseArgs13({
+  return parseArgs14({
     args: argv,
     options: SKILLS_OPTIONS,
     strict: true,
@@ -530745,17 +530962,17 @@ async function runInstall(argv, options3 = {}) {
     parsed = parseSkillsArgs(argv);
   } catch (error54) {
     console.error(`Error: ${error54 instanceof Error ? error54.message : String(error54)}`);
-    printUsage11();
+    printUsage12();
     return 1;
   }
   const [specifier] = parsed.positionals;
   if (parsed.values.help || !specifier || specifier === "help") {
-    printUsage11();
+    printUsage12();
     return 0;
   }
   if (parsed.positionals.length > 1) {
     console.error(`Unexpected argument: ${parsed.positionals[1]}`);
-    printUsage11();
+    printUsage12();
     return 1;
   }
   if (specifier.startsWith("npm:")) {
@@ -530846,16 +531063,16 @@ async function runList2(argv) {
     parsed = parseSkillsArgs(argv);
   } catch (error54) {
     console.error(`Error: ${error54 instanceof Error ? error54.message : String(error54)}`);
-    printUsage11();
+    printUsage12();
     return 1;
   }
   if (parsed.values.help) {
-    printUsage11();
+    printUsage12();
     return 0;
   }
   if (parsed.positionals.length > 0) {
     console.error(`Unexpected argument: ${parsed.positionals[0]}`);
-    printUsage11();
+    printUsage12();
     return 1;
   }
   try {
@@ -530876,17 +531093,17 @@ async function runDelete(argv) {
     parsed = parseSkillsArgs(argv);
   } catch (error54) {
     console.error(`Error: ${error54 instanceof Error ? error54.message : String(error54)}`);
-    printUsage11();
+    printUsage12();
     return 1;
   }
   const [skillName] = parsed.positionals;
   if (parsed.values.help || !skillName || skillName === "help") {
-    printUsage11();
+    printUsage12();
     return 0;
   }
   if (parsed.positionals.length > 1) {
     console.error(`Unexpected argument: ${parsed.positionals[1]}`);
-    printUsage11();
+    printUsage12();
     return 1;
   }
   const agentId = getExplicitAgentId2(parsed.values);
@@ -530926,11 +531143,11 @@ async function runSkillsSubcommand(argv) {
     case "help":
     case "--help":
     case "-h":
-      printUsage11();
+      printUsage12();
       return 0;
     default:
       console.error(`Unknown action: ${action3}`);
-      printUsage11();
+      printUsage12();
       return 1;
   }
 }
@@ -530952,6 +531169,7 @@ function subcommandNeedsEarlyBackendMode(command) {
     case "app-server":
     case "agents":
     case "connect":
+    case "dream":
     case "environments":
     case "envs":
     case "install":
@@ -531007,6 +531225,8 @@ async function runSubcommand(argv) {
       return runSkillsSubcommand(rest3);
     case "cron":
       return runCronSubcommand(rest3);
+    case "dream":
+      return runDreamSubcommand(rest3);
     case "channels":
       return runChannelsSubcommand(rest3);
     case "local-backend":
@@ -534387,4 +534607,4 @@ Error during initialization: ${message}`);
 }
 main2();
 
-//# debugId=FC52DBBEC943656E64756E2164756E21
+//# debugId=03505A9DA7A1B9DB64756E2164756E21

package/package.json

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