@letta-ai/letta-code 0.20.0 → 0.21.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.20.0",
+  "version": "0.21.1",
   "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
   "type": "module",
   "bin": {

package/skills/context_doctor/SKILL.md

@@ -32,8 +32,9 @@ Prompts that are compiled as part of the system prompt (contained in `system/`)
 
 Use the following script to evaluate the token usage of the system prompt: 
 ```bash
-bun scripts/estimate_system_tokens.ts --memory-dir "$MEMORY_DIR"
+npx tsx <SKILL_DIR>/scripts/estimate_system_tokens.ts --memory-dir "$MEMORY_DIR"
 ```
+Where `<SKILL_DIR>` is the Skill Directory shown when the skill was loaded (visible in the injection header).
 
 **Questions to ask**:
 - Do all these tokens need to be passed to the LLM on every turn, or can they be retrieved when needed through being part of external memory of my conversation history? 

package/skills/context_doctor/scripts/estimate_system_tokens.ts

@@ -1,10 +1,23 @@
-#!/usr/bin/env bun
+#!/usr/bin/env npx tsx
+/**
+ * Estimate token usage of system prompt memory files.
+ *
+ * Self-contained — no imports from the letta-code source tree.
+ *
+ * Usage:
+ *   npx tsx estimate_system_tokens.ts --memory-dir "$MEMORY_DIR"
+ *   npx tsx estimate_system_tokens.ts --memory-dir ~/.letta/agents/<id>/memory
+ */
 
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-import { getClient } from "../../../../agent/client";
-import { estimateTokens } from "../../../../cli/helpers/format";
-import { settingsManager } from "../../../../settings-manager";
+
+// Codex heuristic: ~4 bytes per token (codex-rs/core/src/truncate.rs APPROX_BYTES_PER_TOKEN = 4)
+const BYTES_PER_TOKEN = 4;
+
+function estimateTokens(text: string): number {
+  return Math.ceil(Buffer.byteLength(text, "utf8") / BYTES_PER_TOKEN);
+}
 
 type FileEstimate = {
   path: string;
@@ -13,7 +26,6 @@ type FileEstimate = {
 
 type ParsedArgs = {
   memoryDir?: string;
-  agentId?: string;
   top: number;
 };
 
@@ -27,11 +39,6 @@ function parseArgs(argv: string[]): ParsedArgs {
       i++;
       continue;
     }
-    if (arg === "--agent-id") {
-      parsed.agentId = argv[i + 1];
-      i++;
-      continue;
-    }
     if (arg === "--top") {
       const raw = argv[i + 1];
       const value = Number.parseInt(raw ?? "", 10);
@@ -63,9 +70,6 @@ function walkMarkdownFiles(dir: string): string[] {
     }
     const full = join(dir, entry.name);
     if (entry.isDirectory()) {
-      if (entry.name === ".git") {
-        continue;
-      }
       out.push(...walkMarkdownFiles(full));
       continue;
     }
@@ -77,70 +81,25 @@ function walkMarkdownFiles(dir: string): string[] {
   return out;
 }
 
-function inferAgentIdFromMemoryDir(memoryDir: string): string | null {
-  const parts = normalizePath(memoryDir).split("/");
-  for (let i = 0; i < parts.length - 1; i++) {
-    if (parts[i] === "agents" && parts[i + 1]?.startsWith("agent-")) {
-      return parts[i + 1];
-    }
-  }
-
-  const maybe = parts.at(-2);
-  return maybe?.startsWith("agent-") ? maybe : null;
-}
-
-async function resolveAgentId(
-  memoryDir: string,
-  cliAgentId?: string,
-): Promise<string> {
-  if (cliAgentId) {
-    return cliAgentId;
-  }
-
-  if (process.env.AGENT_ID) {
-    return process.env.AGENT_ID;
-  }
-
-  const inferred = inferAgentIdFromMemoryDir(memoryDir);
-  if (inferred) {
-    return inferred;
-  }
-
-  const fromSession = settingsManager.getEffectiveLastAgentId(process.cwd());
-  if (fromSession) {
-    return fromSession;
-  }
-
-  throw new Error(
-    "Unable to resolve agent ID. Pass --agent-id or set AGENT_ID.",
-  );
-}
-
 function formatNumber(value: number): string {
   return value.toLocaleString("en-US");
 }
 
-async function main(): Promise<number> {
-  await settingsManager.initialize();
-
+function main(): number {
   const args = parseArgs(process.argv.slice(2));
   const memoryDir = args.memoryDir || process.env.MEMORY_DIR;
 
   if (!memoryDir) {
-    throw new Error("Missing memory dir. Pass --memory-dir or set MEMORY_DIR.");
+    console.error("Missing memory dir. Pass --memory-dir or set MEMORY_DIR.");
+    return 1;
   }
 
   const systemDir = join(memoryDir, "system");
   if (!existsSync(systemDir)) {
-    throw new Error(`Missing system directory: ${systemDir}`);
+    console.error(`Missing system directory: ${systemDir}`);
+    return 1;
   }
 
-  const agentId = await resolveAgentId(memoryDir, args.agentId);
-
-  // Use the SDK auth path used by letta-code (OAuth + API key handling via getClient).
-  const client = await getClient();
-  await client.agents.retrieve(agentId);
-
   const files = walkMarkdownFiles(systemDir).sort();
   const rows: FileEstimate[] = [];
 
@@ -166,11 +125,4 @@ async function main(): Promise<number> {
   return 0;
 }
 
-main()
-  .then((code) => {
-    process.exit(code);
-  })
-  .catch((error: unknown) => {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  });
+process.exit(main());

package/skills/converting-mcps-to-skills/SKILL.md

@@ -25,23 +25,24 @@ Ask the user:
 
 **For HTTP servers:**
 ```bash
-npx tsx <skill-path>/scripts/mcp-http.ts <url> list-tools
+npx tsx <SKILL_DIR>/scripts/mcp-http.ts <url> list-tools
 
 # With auth header
-npx tsx <skill-path>/scripts/mcp-http.ts <url> --header "Authorization: Bearer KEY" list-tools
+npx tsx <SKILL_DIR>/scripts/mcp-http.ts <url> --header "Authorization: Bearer KEY" list-tools
 ```
+Where `<SKILL_DIR>` is the Skill Directory shown when the skill was loaded (visible in the injection header).
 
 **For stdio servers:**
 ```bash
 # First, install dependencies (one time)
-cd <skill-path>/scripts && npm install
+cd <SKILL_DIR>/scripts && npm install
 
 # Then connect
-npx tsx <skill-path>/scripts/mcp-stdio.ts "<command>" list-tools
+npx tsx <SKILL_DIR>/scripts/mcp-stdio.ts "<command>" list-tools
 
 # Examples
-npx tsx <skill-path>/scripts/mcp-stdio.ts "npx -y @modelcontextprotocol/server-filesystem ." list-tools
-npx tsx <skill-path>/scripts/mcp-stdio.ts "python server.py" list-tools
+npx tsx <SKILL_DIR>/scripts/mcp-stdio.ts "npx -y @modelcontextprotocol/server-filesystem ." list-tools
+npx tsx <SKILL_DIR>/scripts/mcp-stdio.ts "python server.py" list-tools
 ```
 
 ### Step 3: Explore available tools
@@ -113,7 +114,7 @@ Connects to MCP servers that run as subprocesses. Requires npm install first.
 
 ```bash
 # One-time setup
-cd <skill-path>/scripts && npm install
+cd <SKILL_DIR>/scripts && npm install
 
 npx tsx mcp-stdio.ts "<command>" [options] <action> [args]
 
@@ -163,7 +164,7 @@ Here are some well-known MCP servers:
 - Or `--env "API_KEY=xxx"` for stdio servers that need env vars
 
 **stdio "npm install" error:**
-- Run `cd <skill-path>/scripts && npm install` first
+- Run `cd <SKILL_DIR>/scripts && npm install` first
 - The stdio client requires the MCP SDK
 
 **Tool call fails:**

package/skills/creating-skills/SKILL.md

@@ -265,6 +265,7 @@ Usage:
 ```bash
 npx tsx <SKILL_DIR>/scripts/init-skill.ts <skill-name> --path <output-directory>
 ```
+Where `<SKILL_DIR>` is the Skill Directory shown when the skill was loaded (visible in the injection header).
 
 The script: