@letta-ai/letta-code 0.30.8 → 0.30.9

package/package.json

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

package/scripts/dev.cjs

@@ -4,7 +4,6 @@ const { spawn } = require('node:child_process');
 
 const env = { ...process.env };
 if (!env.LETTA_DEBUG) env.LETTA_DEBUG = '1';
-if (!env.LETTA_RESPONSES_WS) env.LETTA_RESPONSES_WS = '1';
 
 const bunArgs = [
   '--loader=.md:text',
@@ -32,4 +31,4 @@ child.on('exit', (code, signal) => {
     return;
   }
   process.exit(code ?? 0);
-});
+});

package/scripts/source-file-size-baseline.json

@@ -3,7 +3,7 @@
   "src/agent/memory-git.ts": 2128,
   "src/backend/local-backend.test.ts": 2532,
   "src/backend/local/local-backend.ts": 1014,
-  "src/backend/local/local-store.ts": 3594,
+  "src/backend/local/local-store.ts": 3598,
   "src/backend/pi-stream-adapter.test.ts": 1304,
   "src/cli/app/AppCoordinator.tsx": 5188,
   "src/cli/app/AppView.tsx": 1735,
@@ -16,17 +16,17 @@
   "src/cli/components/ModelSelector.tsx": 1259,
   "src/cli/components/ProviderSelector.tsx": 1692,
   "src/cli/components/ToolCallMessageRich.tsx": 1109,
-  "src/cli/helpers/accumulator.ts": 1596,
+  "src/cli/helpers/accumulator.ts": 1600,
   "src/cli/helpers/reflection-transcript.ts": 1956,
   "src/cli/mods/local-mod-loader.test.ts": 1043,
   "src/cli/reflection-transcript.test.ts": 1084,
   "src/cli/subcommands/skills.ts": 1264,
-  "src/headless.ts": 5237,
+  "src/headless.ts": 5253,
   "src/hooks/integration.test.ts": 1147,
   "src/index.ts": 2773,
   "src/mods/learning-harness.ts": 2434,
   "src/mods/mod-engine.test.ts": 2153,
-  "src/mods/mod-engine.ts": 1847,
+  "src/mods/mod-engine.ts": 1841,
   "src/mods/package-installer.test.ts": 1248,
   "src/mods/package-installer.ts": 1201,
   "src/mods/package-registry.ts": 1033,
@@ -39,12 +39,13 @@
   "src/tools/impl/enter-worktree.ts": 1260,
   "src/tools/manager.ts": 3080,
   "src/tools/tool-execution-context.test.ts": 1138,
-  "src/types/protocol_v2.ts": 2912,
+  "src/types/protocol_v2.ts": 2911,
   "src/websocket/listen-client-concurrency.test.ts": 2686,
-  "src/websocket/listen-client-protocol.test.ts": 5827,
+  "src/websocket/listen-client-protocol.test.ts": 5820,
   "src/websocket/listener/commands/memory.ts": 1114,
   "src/websocket/listener/file-commands.ts": 1053,
   "src/websocket/listener/lifecycle.ts": 1051,
-  "src/websocket/listener/protocol-inbound.ts": 2262,
-  "src/websocket/listener/protocol-outbound.ts": 1085
+  "src/websocket/listener/protocol-inbound.ts": 2264,
+  "src/websocket/listener/protocol-outbound.ts": 1085,
+  "src/websocket/listener/turn.ts": 1010
 }

package/scripts/test-home-preload.ts

@@ -0,0 +1,66 @@
+import { afterAll } from "bun:test";
+import { mkdtempSync, rmSync } from "node:fs";
+import { createRequire } from "node:module";
+import { basename, isAbsolute, join, relative, resolve } from "node:path";
+
+const require = createRequire(import.meta.url);
+const os = require("node:os") as typeof import("node:os");
+const originalHome = resolve(os.homedir());
+const configuredTestHome = process.env.LETTA_TEST_HOME?.trim();
+const testHome = configuredTestHome
+  ? resolve(configuredTestHome)
+  : mkdtempSync(join(os.tmpdir(), "letta-code-test-home-"));
+
+if (testHome === originalHome) {
+  throw new Error("LETTA_TEST_HOME must not be the operator home directory");
+}
+
+const filesystemEnvKeys = [
+  "LETTA_ARTIFACTS_DIR",
+  "LETTA_CODE_DEV_BACKEND_DIR",
+  "LETTA_DEBUG_FILE",
+  "LETTA_HOME",
+  "LETTA_LISTENER_PERF_FILE",
+  "LETTA_LOCAL_BACKEND_DIR",
+  "LETTA_MEMORY_DIR",
+  "LETTA_MODEL_CATALOG_CACHE_DIR",
+  "LETTA_TRANSCRIPT_ROOT",
+  "LETTA_TUI_PERF_FILE",
+  "MEMORY_DIR",
+  "WEZTERM_CONFIG_FILE",
+  "XDG_CONFIG_HOME",
+] as const;
+
+function isWithin(path: string, root: string): boolean {
+  const child = relative(root, path);
+  return child === "" || (!child.startsWith("..") && !isAbsolute(child));
+}
+
+for (const key of filesystemEnvKeys) {
+  const value = process.env[key]?.trim();
+  if (!value || !isAbsolute(value)) continue;
+  const absolute = resolve(value);
+  if (!isWithin(absolute, originalHome)) continue;
+  process.env[key] = join(testHome, relative(originalHome, absolute));
+}
+
+process.env.LETTA_TEST_HOME = testHome;
+process.env.HOME = testHome;
+process.env.USERPROFILE = testHome;
+process.env.LETTA_TEST_SECRETS_SERVICE_PREFIX = `letta-code-test-${process.pid}-${basename(testHome)}`;
+process.env.LETTA_CODE_TELEM ??= "0";
+
+// Bun resolves os.homedir() before preloads run. Patch the shared built-in
+// module so both ESM and CommonJS consumers use the disposable home. This is a
+// direct module update rather than a Bun test mock, so mock.restore() in an
+// unrelated suite cannot remove the filesystem boundary. Child processes use
+// the redirected environment before their runtimes initialize.
+os.homedir = () => testHome;
+
+if (!configuredTestHome) {
+  const cleanup = () => {
+    rmSync(testHome, { recursive: true, force: true });
+  };
+  afterAll(cleanup);
+  process.once("exit", cleanup);
+}

package/skills/creating-mods/references/ui.md

@@ -10,7 +10,17 @@ For UI that belongs to a larger command/event mod, also read `architecture.md` f
 letta.capabilities.ui.panels
 ```
 
-- `panels`: text blocks placed around the input bar (the only mod UI surface). Desktop/listener disables panel UI.
+- `panels`: TUI-only local UI, including text panels around the input bar and persistent transcript notifications. Desktop/listener disables this capability.
+
+## Persistent transcript notifications
+
+Use `letta.ui.notify(message)` for a durable TUI-only event line such as a model auto-swap or background-work completion. It uses the same transcript visual as `Dreamed; no durable memory changes were needed.` and is not sent to the model or added to agent context. Guard calls with `letta.capabilities.ui.panels`; Desktop/listener cannot render them.
+
+```ts
+if (letta.capabilities.ui.panels) {
+  letta.ui.notify("The fallback model is now active.");
+}
+```
 
 ## Panels