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.
Files changed (2) hide show
  1. package/README.md +8 -72
  2. 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
- - Agent-specific memory blocks
217
- - Agent-specific folders (if not shared)
218
- - Associated conversation history
219
- - ❌ Shared blocks and folders (preserved)
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
- **⚠️ Important: Use the ANON key, not the service role key**
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.1",
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",