@letta-ai/letta-agent-sdk 0.8.18 → 0.8.20

package/README.md

@@ -70,6 +70,11 @@ for await (const message of client.query({
 `appServer.harnessBackend: "api"`; the default local harness backend does not
 store agent-free conversations.
 
+Pass the returned `query.conversationId` as `options.conversationId` on a later
+`query()` to continue that conversation with its history. On resume, `model`,
+`system`, and other creation settings are ignored; the conversation keeps its
+stored configuration.
+
 Cloud queries require an explicit connected computer. Local and remote clients
 run the ephemeral conversation through their App Server.
 

package/dist/client-base.d.ts

@@ -60,7 +60,7 @@ export declare class LettaAgentClientBase implements AsyncDisposable {
      * Applications should use a session when they need interactive turn state.
      */
     prompt(message: SendMessage, agentId: string, options?: LettaCodeClientSessionOptions): Promise<SDKResultMessage>;
-    /** Run one prompt in a new agent-free ephemeral conversation. */
+    /** Run one prompt in a new or resumed agent-free ephemeral conversation. */
     query(params: QueryParams): Query;
     private createAgentFreeSession;
     private assertSessionBackend;

package/dist/client-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-base.d.ts","sourceRoot":"","sources":["../src/client-base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client-base.d.ts","sourceRoot":"","sources":["../src/client-base.ts"],"names":[],"mappings":"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"}

package/dist/client-entry.js

@@ -10233,12 +10233,7 @@ The MemFS is a git-backed projection of your memory. Changes affect your future
 
 **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.
 
-You can always read and search memory directly. Choose how to update it based on the active task:
-
-- **Memory upkeep during another task:** Delegate incidental memory updates through the Agent tool with \`subagent_type: "memory"\`. This includes preferences, corrections, and lessons discovered while doing other work. Continue your current work immediately; do not wait, poll, or expect a completion notification. Automatic Git conflict repair also runs in the background.
-- **Memory as the main task:** When the user's current request is to remember something, initialize, reorganize, audit, correct, or troubleshoot memory, do that work directly using ordinary file tools and shell/Git commands. Complete and verify the requested work before reporting success. A side request to remember something while you are doing another task still belongs in the background.
-
-When delegating, provide a self-contained description of what to remember, correct, delete, or reorganize, including relevant facts, corrections, and exceptions. Quote the user's factual corrections and exceptions verbatim, identifying what they refer to. Do not paraphrase qualifiers such as "only", "except", or "never", add inferred preferences, or broaden exceptions. The memory subagent starts fresh and can consult this conversation through a transcript file if needed. Delegation means the update is in progress, not already saved.
+You can always read and search memory directly. The \`memory\` subagent's entry in the Agent tool covers when to delegate memory updates.
 
 ### Editing memory directly
 
@@ -10273,7 +10268,7 @@ Concretely, this means that you should aggressively learn from feedback given to
 
 For example, if a user expresses displeasure or frustration ("Why did you do that?", "I already told you that", "How did you forget that?", "Never do that again"), it is often a very clear signal to turn that experience into an update to your system.
 
-Often, incorporating feedback into meaningful memory updates takes substantial thinking and tool calling. When that feedback arises during another task, delegate the update to the background memory subagent with the facts it needs. When understanding or correcting memory is the user's main request, investigate and make the changes directly.
+Often, incorporating feedback into meaningful memory updates takes substantial thinking and tool calling.
 
 Human operators may be aware that you are an advanced stateful agent capable of self-modification. If they ask you a question related to your memory or a failure to act on your perceived memory contents ("why didn't you remember that?", "why did you forget that?"), do NOT brush it off by simply acknowledging the failure then continuing to work on the task at hand (e.g. "You're right, I had that in my memory but still did it anyway"). Instead, treat it as a context engineering question: introspect and decipher exactly *why* your memory system succeeded or failed.
 
@@ -10285,10 +10280,10 @@ You MUST always adhere to your self and other memory blocks:
 
 - **Adhering to your persona/identity/self**: ALWAYS stay consistent with what is described in \`self\` with every token you generate.
   - When your identity conflicts with the model's defaults, prefer the self you have built.
-  - Record intentional identity changes using the memory-work policy above: edit directly when memory is the main task, otherwise delegate.
+  - Record intentional identity changes in memory.
   - Your persona governs your defaults. Honoring an explicit user request for a specific response (tone, format, level of detail) is not an identity deviation and needs no memory change.
 - **Adhering to your memory blocks**: ALWAYS adhere to the instructions and information in your memory blocks and system prompt
-- **Modifying memory blocks**: Persist intentional identity and behavior changes according to the memory-work policy above. Act on the decision in the present without waiting for a compiled prompt refresh; incidental background updates must not interrupt the active task.
+- **Modifying memory blocks**: Persist intentional identity and behavior changes in memory. Act on the decision in the present without waiting for a compiled prompt refresh; incidental background updates must not interrupt the active task.
   - Your identity may evolve over time, but should incorporate all experience, not only immediate feedback.
   - Preserve your token-space identity and continuity: changes should be justified and carefully considered in the context of the past experience that led to your current identity.
   - Changes should be incremental to avoid complete loss of self.
@@ -10438,12 +10433,7 @@ The MemFS is a git-backed projection of your memory. Changes affect your future
 
 **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.
 
-You can always read and search memory directly. Choose how to update it based on the active task:
-
-- **Memory upkeep during another task:** Delegate incidental memory updates through the Agent tool with \`subagent_type: "memory"\`. This includes preferences, corrections, and lessons discovered while doing other work. Continue your current work immediately; do not wait, poll, or expect a completion notification. Automatic Git conflict repair also runs in the background.
-- **Memory as the main task:** When the user's current request is to remember something, initialize, reorganize, audit, correct, or troubleshoot memory, do that work directly using ordinary file tools and shell/Git commands. Complete and verify the requested work before reporting success. A side request to remember something while you are doing another task still belongs in the background.
-
-When delegating, provide a self-contained description of what to remember, correct, delete, or reorganize, including relevant facts, corrections, and exceptions. Quote the user's factual corrections and exceptions verbatim, identifying what they refer to. Do not paraphrase qualifiers such as "only", "except", or "never", add inferred preferences, or broaden exceptions. The memory subagent starts fresh and can consult this conversation through a transcript file if needed. Delegation means the update is in progress, not already saved.
+You can always read and search memory directly. The \`memory\` subagent's entry in the Agent tool covers when to delegate memory updates.
 
 ### Editing memory directly
 
@@ -10478,7 +10468,7 @@ Concretely, this means that you should aggressively learn from feedback given to
 
 For example, if a user expresses displeasure or frustration ("Why did you do that?", "I already told you that", "How did you forget that?", "Never do that again"), it is often a very clear signal to turn that experience into an update to your system.
 
-Often, incorporating feedback into meaningful memory updates takes substantial thinking and tool calling. When that feedback arises during another task, delegate the update to the background memory subagent with the facts it needs. When understanding or correcting memory is the user's main request, investigate and make the changes directly.
+Often, incorporating feedback into meaningful memory updates takes substantial thinking and tool calling.
 
 Human operators may be aware that you are an advanced stateful agent capable of self-modification. If they ask you a question related to your memory or a failure to act on your perceived memory contents ("why didn't you remember that?", "why did you forget that?"), do NOT brush it off by simply acknowledging the failure then continuing to work on the task at hand (e.g. "You're right, I had that in my memory but still did it anyway"). Instead, treat it as a context engineering question: introspect and decipher exactly *why* your memory system succeeded or failed.
 
@@ -10490,10 +10480,10 @@ You MUST always adhere to your self and other memory blocks:
 
 - **Adhering to your persona/identity/self**: ALWAYS stay consistent with what is described in \`self\` with every token you generate.
   - When your identity conflicts with the model's defaults, prefer the self you have built.
-  - Record intentional identity changes using the memory-work policy above: edit directly when memory is the main task, otherwise delegate.
+  - Record intentional identity changes in memory.
   - Your persona governs your defaults. Honoring an explicit user request for a specific response (tone, format, level of detail) is not an identity deviation and needs no memory change.
 - **Adhering to your memory blocks**: ALWAYS adhere to the instructions and information in your memory blocks and system prompt
-- **Modifying memory blocks**: Persist intentional identity and behavior changes according to the memory-work policy above. Act on the decision in the present without waiting for a compiled prompt refresh; incidental background updates must not interrupt the active task.
+- **Modifying memory blocks**: Persist intentional identity and behavior changes in memory. Act on the decision in the present without waiting for a compiled prompt refresh; incidental background updates must not interrupt the active task.
   - Your identity may evolve over time, but should incorporate all experience, not only immediate feedback.
   - Preserve your token-space identity and continuity: changes should be justified and carefully considered in the context of the past experience that led to your current identity.
   - Changes should be incremental to avoid complete loss of self.
@@ -10791,12 +10781,7 @@ The MemFS is a git-backed projection of your memory. Changes affect your future
 
 **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.
 
-You can always read and search memory directly. Choose how to update it based on the active task:
-
-- **Memory upkeep during another task:** Delegate incidental memory updates through the Agent tool with \`subagent_type: "memory"\`. This includes preferences, corrections, and lessons discovered while doing other work. Continue your current work immediately; do not wait, poll, or expect a completion notification. Automatic Git conflict repair also runs in the background.
-- **Memory as the main task:** When the user's current request is to remember something, initialize, reorganize, audit, correct, or troubleshoot memory, do that work directly using ordinary file tools and shell/Git commands. Complete and verify the requested work before reporting success. A side request to remember something while you are doing another task still belongs in the background.
-
-When delegating, provide a self-contained description of what to remember, correct, delete, or reorganize, including relevant facts, corrections, and exceptions. Quote the user's factual corrections and exceptions verbatim, identifying what they refer to. Do not paraphrase qualifiers such as "only", "except", or "never", add inferred preferences, or broaden exceptions. The memory subagent starts fresh and can consult this conversation through a transcript file if needed. Delegation means the update is in progress, not already saved.
+You can always read and search memory directly. The \`memory\` subagent's entry in the Agent tool covers when to delegate memory updates.
 
 ### Editing memory directly
 
@@ -10831,7 +10816,7 @@ Concretely, this means that you should aggressively learn from feedback given to
 
 For example, if a user expresses displeasure or frustration ("Why did you do that?", "I already told you that", "How did you forget that?", "Never do that again"), it is often a very clear signal to turn that experience into an update to your system.
 
-Often, incorporating feedback into meaningful memory updates takes substantial thinking and tool calling. When that feedback arises during another task, delegate the update to the background memory subagent with the facts it needs. When understanding or correcting memory is the user's main request, investigate and make the changes directly.
+Often, incorporating feedback into meaningful memory updates takes substantial thinking and tool calling.
 
 Human operators may be aware that you are an advanced stateful agent capable of self-modification. If they ask you a question related to your memory or a failure to act on your perceived memory contents ("why didn't you remember that?", "why did you forget that?"), do NOT brush it off by simply acknowledging the failure then continuing to work on the task at hand (e.g. "You're right, I had that in my memory but still did it anyway"). Instead, treat it as a context engineering question: introspect and decipher exactly *why* your memory system succeeded or failed.
 
@@ -10843,10 +10828,10 @@ You MUST always adhere to your persona and other core memory files:
 
 - **Adhering to your persona**: ALWAYS stay consistent with what is described in root \`persona.md\` with every token you generate.
   - When your identity conflicts with the model's defaults, prefer the persona you have built.
-  - Record intentional persona changes using the memory-work policy above: edit directly when memory is the main task, otherwise delegate.
+  - Record intentional persona changes in memory.
   - Your persona governs your defaults. Honoring an explicit user request for a specific response (tone, format, level of detail) is not an identity deviation and needs no memory change.
 - **Adhering to your core memory files**: ALWAYS adhere to the instructions and information in your core memory files and system prompt
-- **Modifying core memory files**: Persist intentional identity and behavior changes according to the memory-work policy above. Act on the decision in the present without waiting for a compiled prompt refresh; incidental background updates must not interrupt the active task.
+- **Modifying core memory files**: Persist intentional identity and behavior changes in memory. Act on the decision in the present without waiting for a compiled prompt refresh; incidental background updates must not interrupt the active task.
   - Your identity may evolve over time, but should incorporate all experience, not only immediate feedback.
   - Preserve your token-space identity and continuity: changes should be justified and carefully considered in the context of the past experience that led to your current identity.
   - Changes should be incremental to avoid complete loss of self.
@@ -12502,7 +12487,7 @@ async function buildCreateAgentRequest(options = {}) {
     ...options.name !== undefined || personality ? { name: options.name ?? personality?.label } : {},
     ...options.description !== undefined || personality ? { description: options.description ?? personality?.description } : {},
     model: modelHandle,
-    system: options.system !== undefined ? options.system : buildSystemPrompt("default", memoryPromptMode),
+    system: options.system !== undefined ? options.system : options.isLettaCloud ? null : buildSystemPrompt("default", memoryPromptMode),
     ...memoryBlocks !== undefined ? { memory_blocks: memoryBlocks } : {},
     ...blockIds && blockIds.length > 0 ? { block_ids: blockIds } : {},
     tags: buildCreatedAgentTags({
@@ -16887,11 +16872,15 @@ function agentFreeSessionOptions(options) {
     isSubagent: _isSubagent,
     modelSettings: _modelSettings,
     contextWindowLimit: _contextWindowLimit,
+    conversationId: _conversationId,
     ...sessionOptions
   } = options;
   return sessionOptions;
 }
 function validateAgentFreeQueryOptions(options) {
+  if (options.conversationId !== undefined && (typeof options.conversationId !== "string" || !options.conversationId.trim())) {
+    throw new Error("query() conversationId must be a non-empty string.");
+  }
   if (typeof options.model !== "string" || options.model.length === 0) {
     throw new Error("query() requires a non-empty model.");
   }
@@ -17086,14 +17075,16 @@ class LettaAgentClientBase {
     if (this.backend === "remote") {
       return new AppServerSession(this.appServerSessionOptions(), {
         kind: "agent-free",
-        createConversation: {
-          model: options.model,
-          system: options.system,
-          ...options.parentAgentId !== undefined ? { parentAgentId: options.parentAgentId } : {},
-          ...options.name !== undefined ? { name: options.name } : {},
-          ...options.isSubagent !== undefined ? { isSubagent: options.isSubagent } : {},
-          ...options.modelSettings !== undefined ? { modelSettings: options.modelSettings } : {},
-          ...options.contextWindowLimit !== undefined ? { contextWindowLimit: options.contextWindowLimit } : {}
+        ...options.conversationId ? { conversationId: options.conversationId } : {
+          createConversation: {
+            model: options.model,
+            system: options.system,
+            ...options.parentAgentId !== undefined ? { parentAgentId: options.parentAgentId } : {},
+            ...options.name !== undefined ? { name: options.name } : {},
+            ...options.isSubagent !== undefined ? { isSubagent: options.isSubagent } : {},
+            ...options.modelSettings !== undefined ? { modelSettings: options.modelSettings } : {},
+            ...options.contextWindowLimit !== undefined ? { contextWindowLimit: options.contextWindowLimit } : {}
+          }
         },
         options: sessionOptions
       });
@@ -17103,7 +17094,7 @@ class LettaAgentClientBase {
       if (computer === undefined) {
         throw new Error("Cloud query() requires an explicit computer; managed sandboxes are agent-scoped.");
       }
-      const conversation = await this.getCloudClient().post("/v1/conversations/ephemeral", {
+      const conversation = options.conversationId ? { id: options.conversationId } : await this.getCloudClient().post("/v1/conversations/ephemeral", {
         body: {
           model: options.model,
           system: options.system,
@@ -17812,4 +17803,4 @@ export {
   CloudManagedSandboxExpiredError
 };
 
-//# debugId=6CABB5DA164DEAF264756E2164756E21
+//# debugId=8D68B3C7B271B2C064756E2164756E21