@letta-ai/letta-code 0.32.12 → 0.32.13

package/scripts/stage-pypi-deps.mjs

@@ -0,0 +1,90 @@
+// Copy the locked runtime dependency closure, preserving Node's nested versions.
+// No dependency installation happens on the user's machine.
+import {
+  cpSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  realpathSync,
+} from "node:fs";
+import { dirname, join, resolve } from "node:path";
+
+const root = process.cwd();
+const app = resolve(process.argv[2]);
+// sharp-electron is only reachable under Electron, never our bundled Node.
+const roots = ["ws", "@vscode/ripgrep", "node-pty", "grammy"];
+
+function locate(name, from) {
+  for (let dir = from; ; dir = dirname(dir)) {
+    const candidate = join(dir, "node_modules", name);
+    if (existsSync(join(candidate, "package.json")))
+      return realpathSync(candidate);
+    if (dir === dirname(dir))
+      throw new Error(`Missing locked dependency ${name} from ${from}`);
+  }
+}
+function compatible(pkg) {
+  return (
+    (!pkg.os || pkg.os.includes(process.platform)) &&
+    (!pkg.cpu || pkg.cpu.includes(process.arch)) &&
+    (!pkg.libc || pkg.libc.includes("glibc"))
+  );
+}
+function copy(name, from, dest, ancestors = new Set()) {
+  const source = locate(name, from);
+  const pkg = JSON.parse(readFileSync(join(source, "package.json")));
+  if (!compatible(pkg)) return;
+  if (ancestors.has(source)) throw new Error(`Dependency cycle at ${source}`);
+  const target = join(dest, "node_modules", name);
+  mkdirSync(dirname(target), { recursive: true });
+  cpSync(source, target, {
+    recursive: true,
+    dereference: true,
+    filter: (path) =>
+      path === source ||
+      !["node_modules", ".git"].includes(
+        path.slice(source.length + 1).split(/[\\/]/)[0],
+      ),
+  });
+  const chain = new Set([...ancestors, source]);
+  const optional = pkg.optionalDependencies || {};
+  for (const dependency of Object.keys({ ...pkg.dependencies, ...optional })) {
+    try {
+      locate(dependency, source);
+    } catch (error) {
+      if (dependency in optional) continue;
+      throw error;
+    }
+    copy(dependency, source, target, chain);
+  }
+}
+for (const name of roots) copy(name, root, app);
+// Bun bundles Sharp JS but leaves its computed @img native requires unresolved.
+const sharp = locate("sharp", root);
+const sharpPackage = JSON.parse(readFileSync(join(sharp, "package.json")));
+for (const name of Object.keys(sharpPackage.optionalDependencies || {})) {
+  try {
+    locate(name, sharp);
+  } catch {
+    continue;
+  }
+  copy(name, sharp, app);
+}
+
+// Retain license notices for code in the JS bundle as well as external modules.
+function licenses(dir, destination) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const path = join(dir, entry.name);
+    if (entry.isDirectory() && entry.name !== ".bin")
+      licenses(path, join(destination, entry.name));
+    else if (
+      entry.isFile() &&
+      /^(licen[sc]e|copying|notice)([.-]|$)/i.test(entry.name)
+    ) {
+      mkdirSync(destination, { recursive: true });
+      cpSync(path, join(destination, entry.name));
+    }
+  }
+}
+licenses(join(root, "node_modules"), join(app, "third-party-licenses"));

package/skills/finding-agents/SKILL.md

@@ -30,6 +30,7 @@ letta agents list [options]
 | `--tags <tag1,tag2>` | Filter by tags (comma-separated) |
 | `--match-all-tags` | Require ALL tags (default: ANY) |
 | `--include-blocks` | Include agent.blocks in response |
+| `--shared` | List agents shared with the current user |
 | `--limit <n>` | Max results (default: 20) |
 
 ## Common Patterns
@@ -44,14 +45,17 @@ letta agents list --tags "origin:letta-code"
 
 This is useful when the user is looking for agents they've worked with in Letta Code CLI sessions.
 
-### Finding All Agents
+### Finding All Accessible Agents
 
-If the user has agents created outside Letta Code (via ADE, SDK, etc.), search without the tag filter:
+List agents owned by the current user, then list agents shared with them:
 
 ```bash
 letta agents list
+letta agents list --shared
 ```
 
+Use `--query <text>` with either command to search by name.
+
 ## Examples
 
 **List all agents (up to 20):**

package/skills/letta-guide/SKILL.md

@@ -34,7 +34,8 @@ helper below fetches the live index first, so you pick a URL that exists.
    The helper retrieves `https://docs.letta.com/llms.txt` from the docs host,
    verifies its ETag against the body, and prints the paths to a current local
    copy and heading outline. Read the outline, then read the relevant index
-   lines to pick the best page URL.
+   lines and their applicability labels to pick a page matching the user's
+   backend and interface (see below).
 3. **Fetch the specific page directly.** Pass the exact canonical URL from the
    index back to the same helper, for example:
 
@@ -43,7 +44,8 @@ helper below fetches the live index first, so you pick a URL that exists.
      --docs-url "https://docs.letta.com/configuration/models/index.md"
    ```
 
-   Read the returned docs path before running the helper for another URL. The
+   Read the returned docs path, including its frontmatter, before applying its
+   instructions or running the helper for another URL. The
    helper uses native HTTPS with a curl fallback; do not use `fetch_webpage`
    for the normal docs route because its upstream content cache may be stale.
    Cite the public doc URL so the user can go deeper.
@@ -53,6 +55,23 @@ helper below fetches the live index first, so you pick a URL that exists.
    give your best answer, and clearly mark it as possibly out of date with a
    link to https://docs.letta.com. Never silently fall back to memory.
 
+## Match documentation to the user's setup
+
+Read each page's `applies_to` frontmatter before using its instructions:
+
+```yaml
+applies_to:
+  backends: [cloud, local]
+  interfaces: [web, desktop, cli, sdk]
+```
+
+- **Backends describe agent state, not the computer running tools.** `cloud`
+  means Letta Cloud; `local` means a user-managed backend.
+- **Interfaces** refer to the user's current interface: chat.letta.com (`web`,
+  cloud-only), CLI, Desktop, or SDK.
+- Do NOT use context from files marked `status: legacy` unless providing
+  historical context.
+
 ## Inspect or change your model from the CLI
 
 - `letta model list [--byok | --hosted]` lists available models.