lettactl 0.5.1 → 0.5.2
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/README.md +8 -72
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -15,20 +15,6 @@ A kubectl-style CLI for managing stateful Letta AI agent fleets with declarative
|
|
|
15
15
|
| `npm install -g lettactl` | `npm install lettactl` |
|
|
16
16
|
| Perfect for DevOps workflows | Perfect for SaaS platforms |
|
|
17
17
|
|
|
18
|
-
## Features
|
|
19
|
-
|
|
20
|
-
- 🚀 **Declarative Configuration** - Define agents in YAML, deploy with one command
|
|
21
|
-
- 🔄 **Smart Updates** - Only updates what actually changed, preserves conversation history
|
|
22
|
-
- 🎯 **Intelligent Change Detection** - Automatically detects file content changes, tool updates, and memory block modifications
|
|
23
|
-
- 🧠 **Fleet Management** - Deploy and manage multiple related agents together
|
|
24
|
-
- 💬 **Message Operations** - Send messages, stream responses, manage conversations
|
|
25
|
-
- 📦 **Resource Sharing** - Share memory blocks and tools across agents
|
|
26
|
-
- 🗑️ **Bulk Operations** - Pattern-based bulk delete with safety previews and shared resource preservation
|
|
27
|
-
- 🔧 **Tool And Documentation Discovery** - Auto-discover custom Python tools & all documents to be pushed to letta folders
|
|
28
|
-
- 📁 **Configurable Root Directory** - Use `--root` flag to specify custom base directory for file resolution
|
|
29
|
-
- 🛠️ **Programmatic SDK** - Use as a library for building multi-tenant applications
|
|
30
|
-
- ☁️ **Cloud Storage** - Supabase integration for fleet configurations and content
|
|
31
|
-
|
|
32
18
|
## Prerequisites
|
|
33
19
|
- Node.js 18+
|
|
34
20
|
- A running Letta server instance
|
|
@@ -213,10 +199,12 @@ lettactl delete-all agents --pattern "PROD.*" --force # Matches "prod-agent-1"
|
|
|
213
199
|
```
|
|
214
200
|
|
|
215
201
|
**What gets deleted:**
|
|
216
|
-
-
|
|
217
|
-
-
|
|
218
|
-
-
|
|
219
|
-
|
|
202
|
+
- Agent-specific memory blocks
|
|
203
|
+
- Agent-specific folders (if not shared)
|
|
204
|
+
- Associated conversation history
|
|
205
|
+
|
|
206
|
+
**What gets preserved:**
|
|
207
|
+
- Shared blocks and folders used by other agents
|
|
220
208
|
|
|
221
209
|
**Safety Features:**
|
|
222
210
|
- Always shows preview before deletion
|
|
@@ -267,21 +255,6 @@ lettactl messages my-agent # View conversation history
|
|
|
267
255
|
lettactl validate -f agents.yml # Check config syntax
|
|
268
256
|
```
|
|
269
257
|
|
|
270
|
-
### Remove Resources
|
|
271
|
-
```bash
|
|
272
|
-
# Delete single agent
|
|
273
|
-
lettactl delete agent my-agent --force # Delete agent
|
|
274
|
-
|
|
275
|
-
# Bulk delete with pattern matching
|
|
276
|
-
lettactl delete-all agents --pattern "test.*" --force # Delete all agents matching "test*"
|
|
277
|
-
lettactl delete-all agents --pattern "(dev|staging).*" # Complex regex patterns
|
|
278
|
-
lettactl delete-all agents --pattern ".*temp.*" # Match anywhere in name/ID
|
|
279
|
-
lettactl delete-all agents --force # Delete ALL agents (dangerous!)
|
|
280
|
-
|
|
281
|
-
# Preview what will be deleted (without --force)
|
|
282
|
-
lettactl delete-all agents --pattern "test.*" # Shows preview, asks for --force
|
|
283
|
-
```
|
|
284
|
-
|
|
285
258
|
---
|
|
286
259
|
|
|
287
260
|
# SDK Usage
|
|
@@ -563,7 +536,7 @@ vim agents.yml
|
|
|
563
536
|
|
|
564
537
|
# Deploy - only changed parts update
|
|
565
538
|
lettactl apply -f agents.yml
|
|
566
|
-
# Conversation history preserved
|
|
539
|
+
# Conversation history preserved
|
|
567
540
|
```
|
|
568
541
|
|
|
569
542
|
## Complete Configuration Reference
|
|
@@ -654,27 +627,6 @@ your-project/
|
|
|
654
627
|
|
|
655
628
|
## Advanced Features
|
|
656
629
|
|
|
657
|
-
### Fleet Cleanup Workflows
|
|
658
|
-
|
|
659
|
-
Common patterns for managing agent fleets at scale:
|
|
660
|
-
|
|
661
|
-
```bash
|
|
662
|
-
# Development workflow - clean up test agents after feature work
|
|
663
|
-
lettactl delete-all agents --pattern "feature-.*" --force
|
|
664
|
-
|
|
665
|
-
# Staging cleanup - remove old staging agents but keep current ones
|
|
666
|
-
lettactl delete-all agents --pattern "staging-old.*" --force
|
|
667
|
-
|
|
668
|
-
# Version cleanup - remove old versioned agents
|
|
669
|
-
lettactl delete-all agents --pattern ".*__v__2024.*" --force
|
|
670
|
-
|
|
671
|
-
# Emergency cleanup - remove all temporary/test agents
|
|
672
|
-
lettactl delete-all agents --pattern "(temp|test|debug).*" --force
|
|
673
|
-
|
|
674
|
-
# CI/CD cleanup - remove agents created by failed builds
|
|
675
|
-
lettactl delete-all agents --pattern ".*-pr-[0-9]+$" --force
|
|
676
|
-
```
|
|
677
|
-
|
|
678
630
|
### Environment Management
|
|
679
631
|
|
|
680
632
|
```bash
|
|
@@ -697,7 +649,7 @@ export SUPABASE_URL=https://your-project.supabase.co
|
|
|
697
649
|
export SUPABASE_ANON_KEY=sb_publishable_your_anon_key
|
|
698
650
|
```
|
|
699
651
|
|
|
700
|
-
|
|
652
|
+
**Important: Use the ANON key, not the service role key**
|
|
701
653
|
- Go to Supabase Dashboard > Settings > API
|
|
702
654
|
- Copy the "anon public" key (starts with `sb_publishable_...`)
|
|
703
655
|
- Do NOT use the "service role" key for lettactl
|
|
@@ -726,22 +678,6 @@ agents:
|
|
|
726
678
|
path: knowledge/company-info.md
|
|
727
679
|
```
|
|
728
680
|
|
|
729
|
-
### Update Workflows
|
|
730
|
-
|
|
731
|
-
```bash
|
|
732
|
-
# Edit your configuration
|
|
733
|
-
vim agents.yml
|
|
734
|
-
|
|
735
|
-
# Preview changes
|
|
736
|
-
lettactl apply -f agents.yml --dry-run
|
|
737
|
-
|
|
738
|
-
# Deploy changes - only modified agents get new versions
|
|
739
|
-
lettactl apply -f agents.yml
|
|
740
|
-
|
|
741
|
-
# Check what was created
|
|
742
|
-
lettactl get agents
|
|
743
|
-
```
|
|
744
|
-
|
|
745
681
|
## Implementation Notes
|
|
746
682
|
|
|
747
683
|
### Stateless Design
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lettactl",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.2",
|
|
4
4
|
"description": "kubectl-style CLI for managing Letta AI agent fleets",
|
|
5
5
|
"main": "dist/sdk.js",
|
|
6
6
|
"exports": {
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
},
|
|
13
13
|
"scripts": {
|
|
14
14
|
"build": "tsc",
|
|
15
|
+
"typecheck": "tsc --noEmit",
|
|
15
16
|
"start": "node dist/index.js",
|
|
16
17
|
"dev": "ts-node src/index.ts",
|
|
17
18
|
"test": "jest",
|