@letta-ai/letta-code 0.30.25 → 0.30.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.30.25",
+  "version": "0.30.27",
   "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
   "type": "module",
   "packageManager": "bun@1.3.10",
@@ -34,6 +34,8 @@
     "dist/gateway-core.js.map",
     "dist/channels-slack.js",
     "dist/channels-slack.js.map",
+    "dist/channels-telegram.js",
+    "dist/channels-telegram.js.map",
     "dist/types",
     "docs"
   ],
@@ -97,6 +99,12 @@
       "browser": "./dist/channels-slack.js",
       "import": "./dist/channels-slack.js",
       "default": "./dist/channels-slack.js"
+    },
+    "./channels/telegram": {
+      "types": "./dist/types/channels-telegram.d.ts",
+      "browser": "./dist/channels-telegram.js",
+      "import": "./dist/channels-telegram.js",
+      "default": "./dist/channels-telegram.js"
     }
   },
   "repository": {
@@ -212,6 +220,9 @@
       "channels/slack": [
         "./dist/types/channels-slack.d.ts"
       ],
+      "channels/telegram": [
+        "./dist/types/channels-telegram.d.ts"
+      ],
       "protocol": [
         "./dist/types/types/protocol.d.ts"
       ]

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

@@ -5,11 +5,11 @@
   "src/backend/local/local-backend.ts": 1014,
   "src/backend/local/local-store.ts": 3459,
   "src/backend/pi-stream-adapter.test.ts": 1304,
-  "src/cli/app/AppCoordinator.tsx": 5188,
+  "src/cli/app/AppCoordinator.tsx": 5189,
   "src/cli/app/AppView.tsx": 1735,
   "src/cli/app/use-approval-flow.ts": 1163,
   "src/cli/app/use-configuration-handlers.ts": 1421,
-  "src/cli/app/use-conversation-loop.ts": 2936,
+  "src/cli/app/use-conversation-loop.ts": 2912,
   "src/cli/app/use-submit-handler.ts": 4077,
   "src/cli/components/AgentSelector.tsx": 1104,
   "src/cli/components/InputRich.tsx": 2225,
@@ -21,7 +21,7 @@
   "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": 5042,
+  "src/headless.ts": 4994,
   "src/hooks/integration.test.ts": 1147,
   "src/index.ts": 2775,
   "src/mods/learning-harness.ts": 2434,
@@ -45,5 +45,5 @@
   "src/websocket/listener/lifecycle.ts": 1048,
   "src/websocket/listener/protocol-inbound.ts": 2242,
   "src/websocket/listener/protocol-outbound.ts": 1070,
-  "src/websocket/listener/turn.ts": 1009
+  "src/websocket/listener/turn.ts": 1058
 }

package/skills/teleporting-between-environments/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: teleporting-between-environments
-description: Moves the current agent conversation to Cloud or a Cloud-registered remote environment while coordinating machine-local files and setup. Use when the user says "let's continue this task on cloud", asks to continue or move work on another connected computer, wants to teleport between environments, or needs to upload or download artifacts before a handoff.
+description: Moves the current agent conversation to Cloud, Desktop Local, or another Cloud-registered environment while coordinating machine-local files and setup. Use when the user says "let's continue this task on cloud", asks to continue or move work on another connected computer, wants to teleport between environments, or needs to upload or download artifacts before a handoff.
 ---
 
 # Teleporting Between Environments
@@ -19,17 +19,16 @@ Teleport the current agent and conversation without losing conversational memory
 ```bash
 letta teleport list
 letta teleport cloud
+letta teleport local
 letta teleport <environment>
 ```
 
-- `list`: show accessible online remote targets. Desktop Local is excluded.
+- `list`: show accessible online Cloud-registered targets.
 - `cloud`: create or resume this conversation’s managed Cloud sandbox.
+- `local`: target the one online Letta Desktop environment. Desktop Remote Access must be enabled. If several Desktop environments are online, use `list` and target one explicitly.
 - `<environment>`: target a listed remote environment by its friendly selector.
 
-Teleport cannot target Desktop Local yet. Once the conversation runs in Cloud,
-the agent cannot programmatically return to Desktop Local. The user can still
-switch manually with Desktop's environment picker. Do not run or recommend
-`letta teleport back`.
+Do not run or recommend `letta teleport back`; return to Desktop with `local`.
 
 Transfer files with the existing sandbox commands:
 
@@ -80,9 +79,24 @@ If the command reports an offline, stale, unsupported, same-source, or startup e
 
 ### Return to Desktop Local
 
-The agent cannot initiate this transition. Retain the next local action and ask
-the user to select Local from Desktop's environment picker. After continuation
-locally, resume the task from the retained context.
+1. Retain the next local action and any setup the Desktop environment needs.
+2. Confirm Desktop is open with Remote Access enabled. If more than one Desktop environment is online, use `letta teleport list` and choose one explicitly.
+3. As the final action, run:
+
+   ```bash
+   letta teleport local
+   ```
+
+### Run a separate headless turn on an environment
+
+Use `--environment` when a separate headless invocation, rather than the current conversation handoff, should execute on Cloud or another online environment:
+
+```bash
+letta -p --conversation <id> --environment cloud "<prompt>"
+letta -p --conversation <id> --environment <name|device-id|connection-id> "<prompt>"
+```
+
+This routes that headless message only. Use `letta teleport ...` to move the currently executing conversation.
 
 ### Continue on another connected computer