@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/dist/types/types/protocol_v2.d.ts +10 -0
- package/dist/types/types/protocol_v2.d.ts.map +1 -1
- package/letta.js +128912 -152141
- package/package.json +2 -2
- package/scripts/source-file-size-baseline.json +13 -13
- package/skills/dispatching-coding-agents/SKILL.md +14 -20
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@letta-ai/letta-code",
|
|
3
|
-
"version": "0.
|
|
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
|
+
"@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":
|
|
5
|
-
"src/backend/local/local-backend.ts":
|
|
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":
|
|
8
|
-
"src/cli/app/AppCoordinator.tsx":
|
|
9
|
-
"src/cli/app/AppView.tsx":
|
|
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":
|
|
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":
|
|
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":
|
|
25
|
+
"src/headless.ts": 5244,
|
|
26
26
|
"src/hooks/integration.test.ts": 1147,
|
|
27
|
-
"src/index.ts":
|
|
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":
|
|
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":
|
|
50
|
-
"src/websocket/listener/protocol-inbound.ts":
|
|
51
|
-
"src/websocket/listener/protocol-outbound.ts":
|
|
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
|
-
-
|
|
48
|
-
|
|
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
|
-
-
|
|
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
|
|
106
|
-
For hard problems, use the
|
|
100
|
+
### Deep investigation
|
|
101
|
+
For hard problems, use the configured model in a writable sandbox:
|
|
107
102
|
```bash
|
|
108
|
-
codex exec "YOUR PROMPT"
|
|
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.
|
|
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"
|
|
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
|
-
|
|
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
|
|
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
|
|
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"
|
|
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` |
|
|
172
|
-
| `--
|
|
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"` |
|