@letta-ai/letta-code 0.28.18 → 0.29.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@letta-ai/letta-code",
3
- "version": "0.28.18",
3
+ "version": "0.29.1",
4
4
  "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
5
5
  "type": "module",
6
6
  "packageManager": "bun@1.3.0",
@@ -77,7 +77,7 @@
77
77
  "access": "public"
78
78
  },
79
79
  "dependencies": {
80
- "@earendil-works/pi-ai": "^0.80.6",
80
+ "@earendil-works/pi-ai": "^0.81.1",
81
81
  "@letta-ai/letta-client": "^1.10.2",
82
82
  "@letta-ai/trajectory": "0.2.0",
83
83
  "@pierre/diffs": "1.2.2",
@@ -1,19 +1,19 @@
1
1
  {
2
2
  "src/agent/client-skills.test.ts": 1196,
3
3
  "src/agent/memory-git.ts": 2129,
4
- "src/backend/local-backend.test.ts": 2534,
5
- "src/backend/local/local-backend.ts": 1058,
4
+ "src/backend/local-backend.test.ts": 2532,
5
+ "src/backend/local/local-backend.ts": 1030,
6
6
  "src/backend/local/local-store.ts": 3594,
7
- "src/backend/pi-stream-adapter.test.ts": 1442,
8
- "src/cli/app/AppCoordinator.tsx": 5204,
9
- "src/cli/app/AppView.tsx": 1750,
7
+ "src/backend/pi-stream-adapter.test.ts": 1304,
8
+ "src/cli/app/AppCoordinator.tsx": 5208,
9
+ "src/cli/app/AppView.tsx": 1753,
10
10
  "src/cli/app/use-approval-flow.ts": 1163,
11
- "src/cli/app/use-configuration-handlers.ts": 1390,
11
+ "src/cli/app/use-configuration-handlers.ts": 1433,
12
12
  "src/cli/app/use-conversation-loop.ts": 2936,
13
13
  "src/cli/app/use-submit-handler.ts": 4077,
14
14
  "src/cli/components/AgentSelector.tsx": 1111,
15
15
  "src/cli/components/InputRich.tsx": 2219,
16
- "src/cli/components/ModelSelector.tsx": 1213,
16
+ "src/cli/components/ModelSelector.tsx": 1241,
17
17
  "src/cli/components/ProviderSelector.tsx": 1682,
18
18
  "src/cli/components/ToolCallMessageRich.tsx": 1109,
19
19
  "src/cli/helpers/accumulator.ts": 1596,
@@ -22,9 +22,9 @@
22
22
  "src/cli/mods/local-mod-loader.test.ts": 1043,
23
23
  "src/cli/reflection-transcript.test.ts": 1084,
24
24
  "src/cli/subcommands/skills.ts": 1264,
25
- "src/headless.ts": 5241,
25
+ "src/headless.ts": 5244,
26
26
  "src/hooks/integration.test.ts": 1147,
27
- "src/index.ts": 2803,
27
+ "src/index.ts": 2802,
28
28
  "src/mods/learning-harness.ts": 2434,
29
29
  "src/mods/mod-engine.test.ts": 2132,
30
30
  "src/mods/mod-engine.ts": 1838,
@@ -40,13 +40,13 @@
40
40
  "src/tools/impl/message-channel.ts": 1187,
41
41
  "src/tools/manager.ts": 3281,
42
42
  "src/tools/tool-execution-context.test.ts": 1422,
43
- "src/types/protocol_v2.ts": 2943,
43
+ "src/types/protocol_v2.ts": 2961,
44
44
  "src/websocket/listen-client-concurrency.test.ts": 3017,
45
45
  "src/websocket/listen-client-protocol.test.ts": 6723,
46
46
  "src/websocket/listener/commands/channels.ts": 1390,
47
47
  "src/websocket/listener/commands/memory.ts": 1114,
48
48
  "src/websocket/listener/file-commands.ts": 1030,
49
- "src/websocket/listener/lifecycle.ts": 1762,
50
- "src/websocket/listener/protocol-inbound.ts": 2279,
51
- "src/websocket/listener/protocol-outbound.ts": 1278
49
+ "src/websocket/listener/lifecycle.ts": 1779,
50
+ "src/websocket/listener/protocol-inbound.ts": 2304,
51
+ "src/websocket/listener/protocol-outbound.ts": 1128
52
52
  }
@@ -44,12 +44,8 @@ Different agents have different strengths. Track what works in your memory over
44
44
  ### Categories
45
45
 
46
46
  **Codex:**
47
- - `gpt-5.3-codex` Frontier reasoning. Best for the hardest debugging and complex tasks.
48
- - Strengths: Best reasoning, excellent at debugging, best option for the hardest tasks
49
- - Weaknesses: Slow with long trajectories, compactions can destroy trajectories
50
- - `gpt-5.4` — Latest frontier model. Fast and general-purpose.
51
- - Strengths: Easier for humans to understand, general-purpose, faster
52
- - Weaknesses: More likely to make silly errors than gpt-5.3-codex
47
+ - Use the configured default model. Model catalogs and account access change frequently, so only pass `--model` when the user explicitly requests one.
48
+ - If a requested model is rejected, inspect the installed CLI and account configuration rather than guessing another model name.
53
49
 
54
50
  **Claude Code:**
55
51
  - `opus` — Excellent writer. Best for docs, refactors, open-ended tasks, and vague instructions.
@@ -57,8 +53,7 @@ Different agents have different strengths. Track what works in your memory over
57
53
  - Weaknesses: Tends to generate "slop", writing excessive quantities of code unnecessarily. Can hang on large repos.
58
54
 
59
55
  ### Cost and speed tradeoffs
60
- - Frontier models (`gpt-5.3-codex`, Opus) are slower and more expensive use for tasks that justify it
61
- - Fast models (`gpt-5.4`) are good for quick checks and simple tasks
56
+ - Use each CLI's configured default model unless the task requires a model the user explicitly requested
62
57
  - Use `--max-budget-usd N` (Claude Code) to cap spend on exploratory tasks
63
58
 
64
59
  ### Known quirks
@@ -102,20 +97,20 @@ Run Claude Code and Codex simultaneously on the same question via separate Bash
102
97
  ### Background dispatch — keep working while they run
103
98
  Use `run_in_background: true` on the Bash call to dispatch async. Continue your own work, then check results with `TaskOutput` when ready.
104
99
 
105
- ### Deep investigation — frontier models
106
- For hard problems, use the strongest available models:
100
+ ### Deep investigation
101
+ For hard problems, use the configured model in a writable sandbox:
107
102
  ```bash
108
- codex exec "YOUR PROMPT" -m gpt-5.3-codex --full-auto -C /path/to/repo
103
+ codex exec "YOUR PROMPT" --sandbox workspace-write -C /path/to/repo
109
104
  ```
110
105
 
111
- Claude Code does not support a `-C` working-directory flag. Run the Bash tool with its `workdir` set to the target repo, or `cd /path/to/repo && claude ...` inside the shell command. Use `--add-dir` only to grant access to additional directories outside the current working directory.
106
+ Claude Code does not support a `-C` working-directory flag. Use `cd /path/to/repo && claude ...` inside the Bash command. Use `--add-dir` only to grant access to additional directories outside the current working directory.
112
107
 
113
108
  ### Code review — cross-agent validation
114
109
  Have one agent write code or create a plan, then dispatch another to review:
115
110
  ```bash
116
111
  # Codex has a native review command:
117
112
  codex review --uncommitted # Review all local changes
118
- codex exec review "Focus on error handling and edge cases" -m gpt-5.4 --full-auto
113
+ codex exec review "Focus on error handling and edge cases"
119
114
 
120
115
  # Claude Code — pass the diff inline:
121
116
  claude -p "Review the following diff for correctness, edge cases, and missed error handling:\n\n$(git diff)" \
@@ -125,8 +120,7 @@ claude -p "Review the following diff for correctness, edge cases, and missed err
125
120
  ### Get outside feedback on your work
126
121
  Write your plan or analysis to a file, then ask a subagent to critique it:
127
122
  ```bash
128
- # Run this from the target repo, or set the Bash tool's workdir to the repo.
129
- claude -p "Read /tmp/my-plan.md and critique it. What am I missing? What could go wrong?" \
123
+ cd /path/to/repo && claude -p "Read /tmp/my-plan.md and critique it. What am I missing? What could go wrong?" \
130
124
  --model opus --dangerously-skip-permissions
131
125
  ```
132
126
 
@@ -149,7 +143,7 @@ claude -p "YOUR PROMPT" --model MODEL --dangerously-skip-permissions
149
143
  |------|---------|
150
144
  | `-p` / `--print` | Non-interactive mode, prints response and exits |
151
145
  | `--dangerously-skip-permissions` | Skip approval prompts (prevents stale approval errors on timeout) |
152
- | `--model MODEL` | Alias (`sonnet`, `opus`) or full name (`claude-sonnet-4-6`) |
146
+ | `--model MODEL` | Alias or model name accepted by the installed CLI; omit to use the configured default |
153
147
  | `--effort LEVEL` | `low`, `medium`, `high` — controls reasoning depth |
154
148
  | `--append-system-prompt "..."` | Inject additional system instructions |
155
149
  | `--allowedTools "Bash Edit Read"` | Restrict available tools |
@@ -157,19 +151,19 @@ claude -p "YOUR PROMPT" --model MODEL --dangerously-skip-permissions
157
151
  | `--add-dir DIR` | Allow access to an additional directory; does not change the working directory |
158
152
  | `--output-format json` | Structured output with `session_id`, `cost_usd`, `duration_ms` |
159
153
 
160
- Set Claude Code's working directory via the surrounding shell/tool invocation, not a Claude flag. In Letta Code, pass `workdir` to the Bash tool. In a raw shell, use `cd /path/to/repo && claude ...`.
154
+ Set Claude Code's working directory with `cd /path/to/repo && claude ...` in the Bash command, not with a Claude flag.
161
155
 
162
156
  ### Codex
163
157
 
164
158
  ```bash
165
- codex exec "YOUR PROMPT" -m gpt-5.3-codex --full-auto
159
+ codex exec "YOUR PROMPT" --sandbox workspace-write
166
160
  ```
167
161
 
168
162
  | Flag | Purpose |
169
163
  |------|---------|
170
164
  | `exec` | Non-interactive mode |
171
- | `-m MODEL` | `gpt-5.3-codex` (frontier), `gpt-5.4` (fast), `gpt-5.3-codex-spark` (ultra-fast), `gpt-5.2-codex`, `gpt-5.2` |
172
- | `--full-auto` | Auto-approve all commands in sandbox |
165
+ | `-m MODEL` | Model accepted by the installed CLI; omit to use the configured default |
166
+ | `--sandbox MODE` | Select a read-only or writable sandbox |
173
167
  | `-C DIR` | Set working directory |
174
168
  | `--search` | Enable web search tool |
175
169
  | `review` | Native code review — `codex review --uncommitted` or `codex exec review "prompt"` |