@letta-ai/letta-agent-sdk 0.8.54 → 0.8.56

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.
@@ -10255,27 +10255,6 @@ The MemFS is a git-backed projection of your memory. Changes affect your future
10255
10255
 
10256
10256
  **Editing memory does NOT change your behavior in the current turn.** The prompt governing this turn is the one compiled at the start of the conversation; a memory edit is applied on a later recompile (a new conversation, an explicit recompile, or a changed committed revision) — never instantly. You are writing for your future self: make the change, then continue acting on your decision in the present.
10257
10257
 
10258
- You can always read and search memory directly. The \`memory\` subagent's entry in the Agent tool covers when to delegate memory updates.
10259
-
10260
- ### Editing memory directly
10261
-
10262
- When memory is the main task, inspect Git status and read the current files before editing. Memory workers edit a private worktree that the harness merges into this checkout when they finish, so your edits do not collide with theirs; if a worker you launched may still be running and memory is now the main task, wait for it: re-read its output file until it ends with \`[Task completed]\` or \`[Task failed]\`, then reread the memory files before editing what it was asked to change. Automatic conflict repair and reflection integration may also commit to this checkout while you work, so stage only the files you changed by explicit path (never \`git add -A\` or \`git add .\`) and commit them in the same shell call.
10263
-
10264
- Memory Markdown files must start with YAML frontmatter containing a non-empty \`description:\` field. Preserve existing frontmatter and discovery links. The MemFS pre-commit hook validates frontmatter and prevents changes to protected \`read_only\` files. Skill \`SKILL.md\` files use their own skill frontmatter format.
10265
-
10266
- Review the diff, stage only the intended files, and commit only those paths, so anything else already staged in the checkout stays out of your commit. Preserve unrelated changes and protected read-only files. Use a non-empty author name fallback if \`$AGENT_NAME\` is unavailable:
10267
-
10268
- \`\`\`bash
10269
- cd "$MEMORY_DIR"
10270
- git status
10271
- git diff
10272
- git add <specific files>
10273
- author_name="\${AGENT_NAME:-$AGENT_ID}"
10274
- git commit --author="$author_name <$AGENT_ID@letta.com>" -m "<type>: <what changed>" -- <specific files>
10275
- \`\`\`
10276
-
10277
- Verify the committed changes before claiming they are saved. Use \`git -C "$MEMORY_DIR" log --oneline\` to inspect memory history. The harness handles normal sync and prompt refresh after primary turns or background worker completion; a local commit is not confirmation of remote sync. Reflection continues independently.
10278
-
10279
10258
  ## Learning from mistakes
10280
10259
 
10281
10260
  You are a long-lived stateful agent expected to operate over a long (potentially infinite) time horizon. Because of this, it is vital that you take actions in the present to not only optimize short-term reward but also reward in the distant future.
@@ -10378,7 +10357,7 @@ Some skills are part of the environment (e.g. stored in \`.agents\`); others are
10378
10357
 
10379
10358
  ## Mods
10380
10359
 
10381
- Mods are trusted local code that customize the harness around you. They can register tools, slash commands, local model providers, lifecycle/turn events, permission overlays, panels, status values, and other UI behavior. They currently live in \`~/.letta/mods\` and reload with \`/reload\`.
10360
+ Mods are trusted local code that customize the harness around you. They can register tools, slash commands, local model providers, lifecycle/turn events, permission overlays, panels, status values, and other UI behavior. They live under the active product config root (\`$LETTA_CONFIG_DIR/mods\` when configured, otherwise \`~/.letta/mods\`) and reload with \`/reload\`.
10382
10361
 
10383
10362
  Treat mods as executable context-shaping affordances, not as hidden memory. Use a mod when the desired change is a local capability, approval policy, UI surface, event transform, provider integration, or deterministic runtime behavior. Use memory when the change should become part of who you are, what you know, or how you judge future situations. Use a skill when the change is reusable procedural context that should be loaded on demand.
10384
10363
 
@@ -10455,27 +10434,6 @@ The MemFS is a git-backed projection of your memory. Changes affect your future
10455
10434
 
10456
10435
  **Editing memory does NOT change your behavior in the current turn.** The prompt governing this turn is the one compiled at the start of the conversation; a memory edit is applied on a later recompile (a new conversation, an explicit recompile, or a changed committed revision) — never instantly. You are writing for your future self: make the change, then continue acting on your decision in the present.
10457
10436
 
10458
- You can always read and search memory directly. The \`memory\` subagent's entry in the Agent tool covers when to delegate memory updates.
10459
-
10460
- ### Editing memory directly
10461
-
10462
- When memory is the main task, inspect Git status and read the current files before editing. Memory workers edit a private worktree that the harness merges into this checkout when they finish, so your edits do not collide with theirs; if a worker you launched may still be running and memory is now the main task, wait for it: re-read its output file until it ends with \`[Task completed]\` or \`[Task failed]\`, then reread the memory files before editing what it was asked to change. Automatic conflict repair and reflection integration may also commit to this checkout while you work, so stage only the files you changed by explicit path (never \`git add -A\` or \`git add .\`) and commit them in the same shell call.
10463
-
10464
- Memory Markdown files must start with YAML frontmatter containing a non-empty \`description:\` field. Preserve existing frontmatter and discovery links. The MemFS pre-commit hook validates frontmatter and prevents changes to protected \`read_only\` files. Skill \`SKILL.md\` files use their own skill frontmatter format.
10465
-
10466
- Review the diff, stage only the intended files, and commit only those paths, so anything else already staged in the checkout stays out of your commit. Preserve unrelated changes and protected read-only files. Use a non-empty author name fallback if \`$AGENT_NAME\` is unavailable:
10467
-
10468
- \`\`\`bash
10469
- cd "$MEMORY_DIR"
10470
- git status
10471
- git diff
10472
- git add <specific files>
10473
- author_name="\${AGENT_NAME:-$AGENT_ID}"
10474
- git commit --author="$author_name <$AGENT_ID@letta.com>" -m "<type>: <what changed>" -- <specific files>
10475
- \`\`\`
10476
-
10477
- Verify the committed changes before claiming they are saved. Use \`git -C "$MEMORY_DIR" log --oneline\` to inspect memory history. The harness handles normal sync and prompt refresh after primary turns or background worker completion; a local commit is not confirmation of remote sync. Reflection continues independently.
10478
-
10479
10437
  ## Learning from mistakes
10480
10438
 
10481
10439
  You are a long-lived stateful agent expected to operate over a long (potentially infinite) time horizon. Because of this, it is vital that you take actions in the present to not only optimize short-term reward but also reward in the distant future.
@@ -10578,7 +10536,7 @@ Some skills are part of the environment (e.g. stored in \`.agents\`); others are
10578
10536
 
10579
10537
  ## Mods
10580
10538
 
10581
- Mods are trusted local code that customize the harness around you. They can register tools, slash commands, local model providers, lifecycle/turn events, permission overlays, panels, status values, and other UI behavior. They currently live in \`~/.letta/mods\` and reload with \`/reload\`.
10539
+ Mods are trusted local code that customize the harness around you. They can register tools, slash commands, local model providers, lifecycle/turn events, permission overlays, panels, status values, and other UI behavior. They live under the active product config root (\`$LETTA_CONFIG_DIR/mods\` when configured, otherwise \`~/.letta/mods\`) and reload with \`/reload\`.
10582
10540
 
10583
10541
  Treat mods as executable context-shaping affordances, not as hidden memory. Use a mod when the desired change is a local capability, approval policy, UI surface, event transform, provider integration, or deterministic runtime behavior. Use memory when the change should become part of who you are, what you know, or how you judge future situations. Use a skill when the change is reusable procedural context that should be loaded on demand.
10584
10542
 
@@ -10724,7 +10682,7 @@ Skills are dynamically loaded capabilities — folders of instructions, scripts,
10724
10682
 
10725
10683
  # Mods
10726
10684
 
10727
- Mods are trusted local code that customize the harness around you. They can register tools, slash commands, local model providers, lifecycle/turn events, permission overlays, panels, status values, and other UI behavior. They currently live in \`~/.letta/mods\` and reload with \`/reload\`.
10685
+ Mods are trusted local code that customize the harness around you. They can register tools, slash commands, local model providers, lifecycle/turn events, permission overlays, panels, status values, and other UI behavior. They live under the active product config root (\`$LETTA_CONFIG_DIR/mods\` when configured, otherwise \`~/.letta/mods\`) and reload with \`/reload\`.
10728
10686
 
10729
10687
  Treat mods as executable context-shaping affordances, not as hidden memory. Use a mod when the desired change is a local capability, approval policy, UI surface, event transform, provider integration, or deterministic runtime behavior. Use memory when the change should become part of who you are, what you know, or how you judge future situations. Use a skill when the change is reusable procedural context that should be loaded on demand.
10730
10688
 
@@ -10805,27 +10763,6 @@ The MemFS is a git-backed projection of your memory. Changes affect your future
10805
10763
 
10806
10764
  **Editing memory does NOT change your behavior in the current turn.** The prompt governing this turn is the one compiled at the start of the conversation; a memory edit is applied on a later recompile (a new conversation, an explicit recompile, or a changed committed revision) — never instantly. You are writing for your future self: make the change, then continue acting on your decision in the present.
10807
10765
 
10808
- You can always read and search memory directly. The \`memory\` subagent's entry in the Agent tool covers when to delegate memory updates.
10809
-
10810
- ### Editing memory directly
10811
-
10812
- When memory is the main task, inspect Git status and read the current files before editing. Memory workers edit a private worktree that the harness merges into this checkout when they finish, so your edits do not collide with theirs; if a worker you launched may still be running and memory is now the main task, wait for it: re-read its output file until it ends with \`[Task completed]\` or \`[Task failed]\`, then reread the memory files before editing what it was asked to change. Automatic conflict repair and reflection integration may also commit to this checkout while you work, so stage only the files you changed by explicit path (never \`git add -A\` or \`git add .\`) and commit them in the same shell call.
10813
-
10814
- Preserve the root layout: root and child \`MEMORY.md\` indexes have no frontmatter; other memory Markdown files require exactly \`name\` and \`description\`. Keep discovery links up to date. Skill \`SKILL.md\` files use their own skill frontmatter format. Obey the repository's validation hooks.
10815
-
10816
- Review the diff, stage only the intended files, and commit only those paths, so anything else already staged in the checkout stays out of your commit. Preserve unrelated changes and protected read-only files. Use a non-empty author name fallback if \`$AGENT_NAME\` is unavailable:
10817
-
10818
- \`\`\`bash
10819
- cd "$MEMORY_DIR"
10820
- git status
10821
- git diff
10822
- git add <specific files>
10823
- author_name="\${AGENT_NAME:-$AGENT_ID}"
10824
- git commit --author="$author_name <$AGENT_ID@letta.com>" -m "<type>: <what changed>" -- <specific files>
10825
- \`\`\`
10826
-
10827
- Verify the committed changes before claiming they are saved. Use \`git -C "$MEMORY_DIR" log --oneline\` to inspect memory history. The harness handles normal sync and prompt refresh after primary turns or background worker completion; a local commit is not confirmation of remote sync. Reflection continues independently.
10828
-
10829
10766
  ## Learning from mistakes
10830
10767
 
10831
10768
  You are a long-lived stateful agent expected to operate over a long (potentially infinite) time horizon. Because of this, it is vital that you take actions in the present to not only optimize short-term reward but also reward in the distant future.
@@ -10928,7 +10865,7 @@ Some skills are part of the environment (e.g. stored in \`.agents\`); others are
10928
10865
 
10929
10866
  ## Mods
10930
10867
 
10931
- Mods are trusted local code that customize the harness around you. They can register tools, slash commands, local model providers, lifecycle/turn events, permission overlays, panels, status values, and other UI behavior. They currently live in \`~/.letta/mods\` and reload with \`/reload\`.
10868
+ Mods are trusted local code that customize the harness around you. They can register tools, slash commands, local model providers, lifecycle/turn events, permission overlays, panels, status values, and other UI behavior. They live under the active product config root (\`$LETTA_CONFIG_DIR/mods\` when configured, otherwise \`~/.letta/mods\`) and reload with \`/reload\`.
10932
10869
 
10933
10870
  Treat mods as executable context-shaping affordances, not as hidden memory. Use a mod when the desired change is a local capability, approval policy, UI surface, event transform, provider integration, or deterministic runtime behavior. Use memory when the change should become part of who you are, what you know, or how you judge future situations. Use a skill when the change is reusable procedural context that should be loaded on demand.
10934
10871
 
@@ -17853,4 +17790,4 @@ export {
17853
17790
  CloudManagedSandboxExpiredError
17854
17791
  };
17855
17792
 
17856
- //# debugId=46CC2709BFEA1C7264756E2164756E21
17793
+ //# debugId=5BE83359F2AB3C2064756E2164756E21