@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.
- package/dist/client-entry.js +5 -68
- package/dist/client-entry.js.map +3 -3
- package/dist/index.js +388 -239
- package/dist/index.js.map +5 -5
- package/package.json +3 -3
package/dist/client-entry.js
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
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
|
|
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=
|
|
17793
|
+
//# debugId=5BE83359F2AB3C2064756E2164756E21
|