@letta-ai/letta-agent-sdk 0.6.0 → 0.6.2

package/dist/client-entry.js

@@ -3177,36 +3177,6 @@ function appServerSocketOptions(authToken) {
   }
   return { headers: { Authorization: `Bearer ${token}` } };
 }
-function sameRuntime(a, b) {
-  return a?.agent_id === b.agent_id && a?.conversation_id === b.conversation_id;
-}
-function isWaitingLoopStatus(message) {
-  return message.loop_status.status === "WAITING_ON_INPUT";
-}
-function isWaitingOnApprovalLoopStatus(message) {
-  return message.loop_status.status === "WAITING_ON_APPROVAL";
-}
-function streamDeltaRunId(message) {
-  const runId = message.delta.run_id;
-  return typeof runId === "string" ? runId : null;
-}
-function streamDeltaMessageType(message) {
-  const messageType = message.delta.message_type;
-  return typeof messageType === "string" ? messageType : null;
-}
-function streamDeltaStopReason(message) {
-  const stopReason = message.delta.stop_reason;
-  return typeof stopReason === "string" ? stopReason : null;
-}
-function streamDeltaErrorMessage(message) {
-  const delta = message.delta;
-  const apiMessage = delta.api_error?.message ?? delta.api_error?.detail;
-  if (typeof apiMessage === "string" && apiMessage.length > 0)
-    return apiMessage;
-  if (typeof delta.message === "string" && delta.message.length > 0)
-    return delta.message;
-  return "App-server turn failed";
-}
 
 class AppServerClient {
   socket;
@@ -3217,7 +3187,6 @@ class AppServerClient {
   messageHandlers = new Set;
   sendHandlers = new Set;
   disconnectHandlers = new Set;
-  activeTurnRuntimes = new Set;
   explicitlyClosed = false;
   disconnectNotified = false;
   nextRequestNumber = 0;
@@ -3400,111 +3369,15 @@ class AppServerClient {
   input(command) {
     this.send({ type: "input", ...command });
   }
-  runTurn(command, options = {}) {
-    const runtimeKey = `${command.runtime.agent_id}/${command.runtime.conversation_id}`;
-    if (this.activeTurnRuntimes.has(runtimeKey)) {
-      return Promise.reject(new Error(`A turn is already in flight for ${runtimeKey}`));
-    }
-    this.activeTurnRuntimes.add(runtimeKey);
-    const timeoutMs = options.timeoutMs ?? this.requestTimeoutMs;
-    const commandWithIds = this.withClientMessageIds(command);
-    const runIds = new Set;
-    let observedTurnEvidence = false;
-    let observedRequiresApprovalStop = false;
-    return new Promise((resolve, reject) => {
-      const timeout = setTimeout(() => {
-        cleanup();
-        reject(new Error(`Timed out waiting for app-server turn on ${command.runtime.agent_id}/${command.runtime.conversation_id}`));
-      }, timeoutMs);
-      const cleanup = () => {
-        clearTimeout(timeout);
-        this.activeTurnRuntimes.delete(runtimeKey);
-        offMessage();
-      };
-      const finish = (completedBy, terminalMessage, stopReason) => {
-        cleanup();
-        resolve({
-          runtime: command.runtime,
-          stopReason,
-          runIds: [...runIds],
-          clientMessageIds: commandWithIds.clientMessageIds,
-          completedBy,
-          terminalMessage
-        });
-      };
-      const fail = (error) => {
-        cleanup();
-        reject(error);
-      };
-      const offMessage = this.onMessage((message) => {
-        if (!sameRuntime(message.runtime, command.runtime)) {
-          return;
-        }
-        if (message.type === "stream_delta") {
-          observedTurnEvidence = true;
-          const runId = streamDeltaRunId(message);
-          if (runId)
-            runIds.add(runId);
-          const messageType = streamDeltaMessageType(message);
-          if (messageType === "loop_error" || messageType === "error_message") {
-            fail(new Error(streamDeltaErrorMessage(message)));
-            return;
-          }
-          if (messageType === "stop_reason") {
-            const stopReason = streamDeltaStopReason(message);
-            if (stopReason === "requires_approval") {
-              observedRequiresApprovalStop = true;
-              return;
-            }
-            finish("stop_reason", message, stopReason);
-          }
-          return;
-        }
-        if (message.type === "update_loop_status") {
-          const hadTurnEvidenceBeforeLoopStatus = observedTurnEvidence || observedRequiresApprovalStop;
-          if (!hadTurnEvidenceBeforeLoopStatus && (isWaitingOnApprovalLoopStatus(message) || options.allowLoopStatusFallback === true && isWaitingLoopStatus(message))) {
-            return;
-          }
-          for (const runId of message.loop_status.active_run_ids) {
-            observedTurnEvidence = true;
-            runIds.add(runId);
-          }
-          if (hadTurnEvidenceBeforeLoopStatus && isWaitingOnApprovalLoopStatus(message)) {
-            finish("loop_status_waiting_on_approval", message, "requires_approval");
-            return;
-          }
-          if (options.allowLoopStatusFallback === true && hadTurnEvidenceBeforeLoopStatus && isWaitingLoopStatus(message)) {
-            finish("loop_status_waiting_fallback", message, null);
-          }
-        }
-      });
-      try {
-        this.input(commandWithIds.command);
-      } catch (error) {
-        fail(error instanceof Error ? error : new Error(String(error)));
-      }
-    });
-  }
-  withClientMessageIds(command) {
-    if (command.payload.kind !== "create_message") {
-      return { command, clientMessageIds: [] };
-    }
-    const clientMessageIds = [];
-    const messages = command.payload.messages.map((message) => {
-      if (message.role !== "user")
-        return message;
-      const existing = message.client_message_id;
-      const clientMessageId = typeof existing === "string" && existing.length > 0 ? existing : this.nextRequestId("client-message");
-      clientMessageIds.push(clientMessageId);
-      return { ...message, client_message_id: clientMessageId };
+  submitInput(command, options = {}) {
+    return this.request({
+      type: "input",
+      request_id: command.request_id ?? this.nextRequestId("input"),
+      ...command
+    }, {
+      ...options,
+      predicate: (message) => message.type === "input_accepted"
     });
-    return {
-      command: {
-        ...command,
-        payload: { ...command.payload, messages }
-      },
-      clientMessageIds
-    };
   }
   handleMessage(event, channel) {
     const message = parseProtocolMessage(event);
@@ -6438,6 +6311,73 @@ var models_default = {
         parallel_tool_calls: true
       }
     },
+    {
+      id: "opus-5",
+      handle: "anthropic/claude-opus-5",
+      label: "Opus 5",
+      description: "Opus 5 (high reasoning)",
+      updateArgs: {
+        context_window: 200000,
+        max_output_tokens: 128000,
+        enable_reasoner: true,
+        reasoning_effort: "high",
+        parallel_tool_calls: true
+      }
+    },
+    {
+      id: "opus-5-low",
+      handle: "anthropic/claude-opus-5",
+      label: "Opus 5",
+      description: "Opus 5 (low reasoning)",
+      updateArgs: {
+        context_window: 200000,
+        max_output_tokens: 128000,
+        enable_reasoner: true,
+        reasoning_effort: "low",
+        max_reasoning_tokens: 4000,
+        parallel_tool_calls: true
+      }
+    },
+    {
+      id: "opus-5-medium",
+      handle: "anthropic/claude-opus-5",
+      label: "Opus 5",
+      description: "Opus 5 (med reasoning)",
+      updateArgs: {
+        context_window: 200000,
+        max_output_tokens: 128000,
+        enable_reasoner: true,
+        reasoning_effort: "medium",
+        max_reasoning_tokens: 12000,
+        parallel_tool_calls: true
+      }
+    },
+    {
+      id: "opus-5-xhigh",
+      handle: "anthropic/claude-opus-5",
+      label: "Opus 5",
+      description: "Opus 5 (extra-high reasoning)",
+      updateArgs: {
+        context_window: 200000,
+        max_output_tokens: 128000,
+        enable_reasoner: true,
+        reasoning_effort: "xhigh",
+        parallel_tool_calls: true
+      }
+    },
+    {
+      id: "opus-5-max",
+      handle: "anthropic/claude-opus-5",
+      label: "Opus 5",
+      description: "Opus 5 (max reasoning)",
+      updateArgs: {
+        context_window: 200000,
+        max_output_tokens: 128000,
+        enable_reasoner: true,
+        reasoning_effort: "max",
+        parallel_tool_calls: true
+      }
+    },
     {
       id: "opus",
       handle: "anthropic/claude-opus-4-8",
@@ -6712,7 +6652,7 @@ var models_default = {
       id: "sonnet-5-xhigh",
       handle: "anthropic/claude-sonnet-5",
       label: "Sonnet 5",
-      description: "Sonnet 5 (max reasoning)",
+      description: "Sonnet 5 (extra-high reasoning)",
       updateArgs: {
         context_window: 1e6,
         max_output_tokens: 128000,
@@ -6721,6 +6661,19 @@ var models_default = {
         parallel_tool_calls: true
       }
     },
+    {
+      id: "sonnet-5-max",
+      handle: "anthropic/claude-sonnet-5",
+      label: "Sonnet 5",
+      description: "Sonnet 5 (max reasoning)",
+      updateArgs: {
+        context_window: 1e6,
+        max_output_tokens: 128000,
+        reasoning_effort: "max",
+        enable_reasoner: true,
+        parallel_tool_calls: true
+      }
+    },
     {
       id: "sonnet-4.6",
       handle: "anthropic/claude-sonnet-4-6",
@@ -8271,7 +8224,6 @@ var models_default = {
   ]
 };
 var models = models_default.models;
-var MODEL_PRESETS = models;
 function resolveModel(modelIdentifier) {
   const byId = models.find((m) => m.id === modelIdentifier);
   if (byId)
@@ -8499,75 +8451,128 @@ function buildPersonalityMemoryBlocks(personalityId, defaultMemoryBlocks, enviro
 }
 var LETTA_CODE_AGENT_TYPE = "letta_v1_agent";
 var DEFAULT_CREATED_AGENT_BASE_TOOLS = ["web_search", "fetch_webpage"];
-async function buildCreateAgentRequestForPersonality(params) {
-  const { personalityId, name, description, model, extraTags } = params;
-  const personality = getPersonalityOption(personalityId);
-  const modelIdentifier = model ?? personality.defaultModel;
+function mergeMemoryBlocks(base, overrides) {
+  const blocks = base.map((block) => ({ ...block }));
+  for (const override of overrides ?? []) {
+    const index = blocks.findIndex((block) => block.label === override.label);
+    if (index >= 0) {
+      blocks[index] = { ...override };
+    } else {
+      blocks.push({ ...override });
+    }
+  }
+  return blocks;
+}
+async function buildCreateAgentRequest(options = {}) {
+  const personality = options.personalityId ? getPersonalityOption(options.personalityId) : undefined;
+  const modelIdentifier = options.model ?? personality?.defaultModel;
   const modelHandle = modelIdentifier ? resolveModel(modelIdentifier) : getDefaultModel();
   if (!modelHandle) {
     throw new Error(`Unknown model: ${modelIdentifier}`);
   }
-  const defaultMemoryBlocks = await getDefaultMemoryBlocks();
+  if (!options.isSubagent && options.enableMemfs !== undefined && options.memoryPromptMode !== undefined && options.enableMemfs !== (options.memoryPromptMode !== "standard")) {
+    throw new Error("enableMemfs and memoryPromptMode must describe the same memory mode");
+  }
+  const enableMemfs = options.isSubagent ? false : options.enableMemfs ?? options.memoryPromptMode !== "standard";
+  const memoryPromptMode = options.isSubagent ? "standard" : options.memoryPromptMode ?? (enableMemfs ? "memfs" : "standard");
+  const personalityTags = options.personalityId ? getPersonalityCreationTags(options.personalityId) : [];
+  const personalityBlocks = options.personalityId ? buildPersonalityMemoryBlocks(options.personalityId, await getDefaultMemoryBlocks()) : [];
+  const memoryBlocks = options.isSubagent ? undefined : options.personalityId || options.memoryBlocks !== undefined ? mergeMemoryBlocks(personalityBlocks, options.memoryBlocks) : undefined;
+  const blockIds = options.isSubagent ? undefined : options.blockIds;
   return {
     agent_type: LETTA_CODE_AGENT_TYPE,
-    name: name ?? personality.label,
-    description: description ?? personality.description,
+    ...options.name !== undefined || personality ? { name: options.name ?? personality?.label } : {},
+    ...options.description !== undefined || personality ? { description: options.description ?? personality?.description } : {},
     model: modelHandle,
-    system: buildSystemPrompt("default", "memfs"),
-    memory_blocks: buildPersonalityMemoryBlocks(personalityId, defaultMemoryBlocks),
+    system: options.system ?? buildSystemPrompt("default", memoryPromptMode),
+    ...memoryBlocks !== undefined ? { memory_blocks: memoryBlocks } : {},
+    ...blockIds && blockIds.length > 0 ? { block_ids: blockIds } : {},
     tags: buildCreatedAgentTags({
-      enableMemfs: true,
-      tags: [
-        ...getPersonalityCreationTags(personalityId),
-        ...extraTags ?? []
-      ]
+      enableMemfs,
+      isSubagent: options.isSubagent,
+      tags: [...personalityTags, ...options.extraTags ?? []]
     }),
-    tools: [...DEFAULT_CREATED_AGENT_BASE_TOOLS],
+    tools: [...options.baseTools ?? DEFAULT_CREATED_AGENT_BASE_TOOLS],
     include_base_tools: false,
     include_base_tool_rules: false,
     initial_message_sequence: [],
-    parallel_tool_calls: true,
-    compaction_settings: { model: DEFAULT_SUMMARIZATION_MODEL }
+    parallel_tool_calls: options.parallelToolCalls ?? true,
+    compaction_settings: {
+      model: options.compactionModel ?? DEFAULT_SUMMARIZATION_MODEL
+    },
+    ...options.embedding !== undefined ? { embedding: options.embedding } : {},
+    ...options.isSubagent ? { hidden: true } : options.hidden !== undefined ? { hidden: options.hidden } : {}
   };
 }
 
 // src/agent-creation.ts
-var DEFAULT_MODEL_ID = "auto";
-var DEFAULT_SUMMARIZATION_MODEL2 = "letta/auto";
-function resolveModel2(modelIdentifier) {
-  const preset = MODEL_PRESETS.find((model) => model.id === modelIdentifier || model.handle === modelIdentifier);
-  if (preset)
-    return preset.handle;
-  if (modelIdentifier.includes("/"))
-    return modelIdentifier;
-  throw new Error(`Unknown model: ${modelIdentifier}`);
+function isPresetSystemPrompt(value) {
+  return [
+    "default",
+    "letta-claude",
+    "letta-codex",
+    "letta-gemini",
+    "claude",
+    "codex",
+    "gemini"
+  ].includes(value);
 }
-async function buildInitialAgentBody(options) {
-  if (options.personality !== undefined) {
-    return {
-      ...await buildCreateAgentRequestForPersonality({
-        personalityId: options.personality,
-        ...options.name !== undefined ? { name: options.name } : {},
-        ...options.description !== undefined ? { description: options.description } : {},
-        ...options.model !== undefined ? { model: options.model } : {},
-        ...options.tags !== undefined ? { extraTags: options.tags } : {}
-      })
-    };
+function assertCreateAgentOptionsSupported(options) {
+  if (options.allowedTools !== undefined || options.disallowedTools !== undefined) {
+    throw new Error("App-server createAgent() does not yet support allowedTools/disallowedTools.");
+  }
+  if (options.canUseTool !== undefined) {
+    throw new Error("App-server createAgent() does not yet support canUseTool callbacks.");
+  }
+  if (options.systemInfoReminder !== undefined) {
+    throw new Error("App-server createAgent() does not yet support systemInfoReminder overrides.");
+  }
+  if (options.dreaming?.behavior !== undefined) {
+    throw new Error("App-server createAgent() does not yet support dreaming.behavior overrides.");
   }
-  return {
-    agent_type: LETTA_CODE_AGENT_TYPE,
-    ...options.name !== undefined ? { name: options.name } : {},
-    ...options.description !== undefined ? { description: options.description } : {},
-    model: resolveModel2(options.model ?? DEFAULT_MODEL_ID),
-    system: buildSystemPrompt("default", "memfs"),
-    tags: buildCreatedAgentTags({
-      enableMemfs: true,
-      tags: options.tags ?? []
-    }),
-    initial_message_sequence: [],
-    parallel_tool_calls: true,
-    compaction_settings: { model: DEFAULT_SUMMARIZATION_MODEL2 }
-  };
+}
+async function createAgentBody(options) {
+  assertCreateAgentOptionsSupported(options);
+  let system;
+  if (options.systemPrompt !== undefined) {
+    if (typeof options.systemPrompt !== "string" || isPresetSystemPrompt(options.systemPrompt)) {
+      throw new Error("createAgent() does not yet support system prompt presets for this backend.");
+    }
+    system = options.systemPrompt;
+  }
+  const memoryBlocks = [];
+  const blockIds = [];
+  for (const item of options.memory ?? []) {
+    if (typeof item === "string") {
+      throw new Error("App-server createAgent() does not yet support memory preset names.");
+    }
+    if ("blockId" in item) {
+      blockIds.push(item.blockId);
+    } else {
+      memoryBlocks.push({ ...item });
+    }
+  }
+  if (options.persona !== undefined) {
+    memoryBlocks.push({ label: "persona", value: options.persona });
+  }
+  if (options.human !== undefined) {
+    memoryBlocks.push({ label: "human", value: options.human });
+  }
+  const hasMemoryConfiguration = options.memory !== undefined || options.persona !== undefined || options.human !== undefined;
+  return buildCreateAgentRequest({
+    personalityId: options.personality,
+    name: options.name,
+    description: options.description,
+    model: options.model,
+    system,
+    memoryBlocks: hasMemoryConfiguration ? memoryBlocks : undefined,
+    blockIds,
+    extraTags: options.tags,
+    enableMemfs: options.memfs ?? true,
+    baseTools: options.baseTools,
+    embedding: options.embedding,
+    hidden: options.hidden
+  });
 }
 
 // src/interactiveToolPolicy.ts
@@ -8856,7 +8861,7 @@ function firstToolReturn(delta) {
   }
   return;
 }
-function sameRuntime2(message, runtime) {
+function sameRuntime(message, runtime) {
   const msgRuntime = message.runtime;
   if (msgRuntime) {
     return msgRuntime.agent_id === runtime.agent_id && msgRuntime.conversation_id === runtime.conversation_id;
@@ -8875,10 +8880,10 @@ function streamDeltaRecord(message) {
   const delta = message.delta;
   return delta && typeof delta === "object" && !Array.isArray(delta) ? delta : null;
 }
-function streamDeltaMessageType2(delta) {
+function streamDeltaMessageType(delta) {
   return typeof delta.message_type === "string" ? delta.message_type : undefined;
 }
-function streamDeltaRunId2(delta) {
+function streamDeltaRunId(delta) {
   return typeof delta.run_id === "string" ? delta.run_id : undefined;
 }
 function streamDeltaOtid(delta) {
@@ -8887,7 +8892,7 @@ function streamDeltaOtid(delta) {
 function streamDeltaSeqId(delta) {
   return typeof delta.seq_id === "number" ? delta.seq_id : undefined;
 }
-function streamDeltaStopReason2(delta) {
+function streamDeltaStopReason(delta) {
   return typeof delta.stop_reason === "string" ? delta.stop_reason : undefined;
 }
 function loopStatusRecord(message) {
@@ -9110,7 +9115,7 @@ class RemoteTurnCoordinator {
       this.activeTurn.abortRequested = true;
   }
   handleProtocolMessage(message, runtime) {
-    if (!sameRuntime2(message, runtime))
+    if (!sameRuntime(message, runtime))
       return;
     const statusRecord = deviceStatusRecord(message);
     if (statusRecord) {
@@ -9137,7 +9142,7 @@ class RemoteTurnCoordinator {
     const active = this.activateNextTurnFromProtocol();
     if (active) {
       active.observedTurnEvidence = true;
-      const runId = streamDeltaRunId2(delta);
+      const runId = streamDeltaRunId(delta);
       if (runId)
         active.runIds.add(runId);
     }
@@ -9156,6 +9161,24 @@ class RemoteTurnCoordinator {
       this.streamResolvers.push(resolve);
     });
   }
+  closeWithError(detail) {
+    if (this.closed)
+      return;
+    const active = this.activeTurn;
+    if (active) {
+      this.failTurn(active, detail);
+    } else {
+      this.enqueue({
+        type: "error",
+        message: detail,
+        errorCode: "error",
+        stopReason: "error",
+        errorDetail: detail,
+        recoverable: false
+      });
+    }
+    this.close();
+  }
   close() {
     if (this.closed)
       return;
@@ -9273,9 +9296,9 @@ class RemoteTurnCoordinator {
     const active = this.activeTurn;
     if (!active)
       return;
-    const messageType = streamDeltaMessageType2(delta);
+    const messageType = streamDeltaMessageType(delta);
     if (messageType === "stop_reason") {
-      const stopReason = streamDeltaStopReason2(delta) ?? null;
+      const stopReason = streamDeltaStopReason(delta) ?? null;
       if (stopReason === "requires_approval") {
         active.observedRequiresApprovalStop = true;
         return;
@@ -9469,6 +9492,7 @@ class RemoteClientSessionCore {
   requestTimeoutMs;
   initializePromise = null;
   removeMessageHandler = null;
+  detachTransportDisconnect = null;
   turns;
   toolNames;
   deviceStatusListeners = new Set;
@@ -9543,6 +9567,8 @@ class RemoteClientSessionCore {
   cleanupFailedInitialize() {
     this.removeMessageHandler?.();
     this.removeMessageHandler = null;
+    this.detachTransportDisconnect?.();
+    this.detachTransportDisconnect = null;
     this.controller?.close();
     this.controller = null;
     this.onCoreClose();
@@ -9573,7 +9599,7 @@ class RemoteClientSessionCore {
       throw error;
     }
   }
-  async runTurn(message, _options = {}) {
+  async sendAndWaitForResult(message) {
     if (this.turns.hasInFlightTurn()) {
       throw new Error(`A turn is already in flight for this ${this.label} session. Use send() and stream() to let the listener queue messages.`);
     }
@@ -9830,6 +9856,8 @@ class RemoteClientSessionCore {
     this.closed = true;
     this.removeMessageHandler?.();
     this.removeMessageHandler = null;
+    this.detachTransportDisconnect?.();
+    this.detachTransportDisconnect = null;
     this.turns.close();
     for (const cancel of [...this.deviceStatusRefreshCancels]) {
       cancel(new Error(`Session closed while waiting for ${this.label} device status`));
@@ -9890,6 +9918,15 @@ class RemoteClientSessionCore {
     }, { predicate: (message) => message.type === "update_toolset_response" });
     ensureSuccess(response, "Failed to update toolset");
   }
+  watchTransportDisconnect(client) {
+    this.detachTransportDisconnect?.();
+    this.detachTransportDisconnect = client.onDisconnect(() => {
+      if (this.closed)
+        return;
+      this.turns.closeWithError(`The ${this.label} connection closed unexpectedly; resume the conversation to continue.`);
+      this.close();
+    });
+  }
   async afterRuntimeInitialized() {}
   async beforeTurn() {}
   onCoreClose() {}
@@ -10011,111 +10048,6 @@ function agentToolNames(agent) {
     return typeof name === "string" && name.length > 0 ? [name] : [];
   });
 }
-function isPresetSystemPrompt(value) {
-  return [
-    "default",
-    "letta-claude",
-    "letta-codex",
-    "letta-gemini",
-    "claude",
-    "codex",
-    "gemini"
-  ].includes(value);
-}
-function assertRemoteCreateAgentOptionsSupported(options) {
-  if (options.allowedTools !== undefined || options.disallowedTools !== undefined) {
-    throw new Error("App-server createAgent() does not yet support allowedTools/disallowedTools.");
-  }
-  if (options.canUseTool !== undefined) {
-    throw new Error("App-server createAgent() does not yet support canUseTool callbacks.");
-  }
-  if (options.systemInfoReminder !== undefined) {
-    throw new Error("App-server createAgent() does not yet support systemInfoReminder overrides.");
-  }
-  if (options.dreaming?.behavior !== undefined) {
-    throw new Error("App-server createAgent() does not yet support dreaming.behavior overrides.");
-  }
-}
-function normalizeMemoryBlock(block) {
-  const normalized = { ...block };
-  if (normalized.value === undefined && typeof normalized.content === "string") {
-    normalized.value = normalized.content;
-  }
-  return normalized;
-}
-function upsertMemoryBlock(blocks, block) {
-  const label = block.label;
-  if (typeof label === "string") {
-    const existingIndex = blocks.findIndex((candidate) => candidate.label === label);
-    if (existingIndex >= 0) {
-      blocks[existingIndex] = block;
-      return;
-    }
-  }
-  blocks.push(block);
-}
-async function createAgentBody(options, settings = {}) {
-  assertRemoteCreateAgentOptionsSupported(options);
-  const includeOriginTag = settings.includeSdkOriginTag ?? true;
-  const body = await buildInitialAgentBody(options);
-  if (Array.isArray(body.tags)) {
-    body.tags = body.tags.filter((tag) => (includeOriginTag || tag !== LETTA_CODE_ORIGIN_TAG) && (options.memfs !== false || tag !== GIT_MEMORY_ENABLED_TAG));
-  }
-  if (options.embedding !== undefined)
-    body.embedding = options.embedding;
-  if (options.hidden !== undefined)
-    body.hidden = options.hidden;
-  if (options.baseTools === undefined) {
-    delete body.tools;
-    delete body.include_base_tools;
-    delete body.include_base_tool_rules;
-  } else {
-    body.tools = options.baseTools;
-    body.include_base_tools = false;
-    body.include_base_tool_rules = false;
-  }
-  if (options.systemPrompt === undefined) {
-    if (options.memfs === false) {
-      body.system = buildSystemPrompt("default", "standard");
-    }
-  } else {
-    if (typeof options.systemPrompt === "string") {
-      if (isPresetSystemPrompt(options.systemPrompt)) {
-        throw new Error("createAgent() does not yet support system prompt presets for this backend.");
-      }
-      body.system = options.systemPrompt;
-    } else {
-      throw new Error("createAgent() does not yet support system prompt preset objects for this backend.");
-    }
-  }
-  const hasMemoryConfiguration = Array.isArray(body.memory_blocks) || options.memory !== undefined || options.persona !== undefined || options.human !== undefined;
-  const memoryBlocks = Array.isArray(body.memory_blocks) ? body.memory_blocks.filter((block) => block !== null && typeof block === "object").map((block) => ({ ...block })) : [];
-  const blockIds = [];
-  for (const item of options.memory ?? []) {
-    if (typeof item === "string") {
-      throw new Error("App-server createAgent() does not yet support memory preset names.");
-    }
-    if ("blockId" in item) {
-      blockIds.push(item.blockId);
-    } else {
-      upsertMemoryBlock(memoryBlocks, normalizeMemoryBlock(item));
-    }
-  }
-  if (options.persona !== undefined) {
-    upsertMemoryBlock(memoryBlocks, {
-      label: "persona",
-      value: options.persona
-    });
-  }
-  if (options.human !== undefined) {
-    upsertMemoryBlock(memoryBlocks, { label: "human", value: options.human });
-  }
-  if (hasMemoryConfiguration)
-    body.memory_blocks = memoryBlocks;
-  if (blockIds.length > 0)
-    body.block_ids = blockIds;
-  return body;
-}
 function externalToolGroups(tools) {
   if (!tools || tools.length === 0)
     return;
@@ -10494,6 +10426,7 @@ class AppServerSession extends RemoteClientSessionCore {
       if (!response.success || !response.runtime) {
         throw new Error(response.error ?? "Failed to start app-server runtime");
       }
+      this.watchTransportDisconnect(client);
       const tools = agentToolNames(response.agent);
       const skillSources = options.skillSources;
       const clientToolset = "toolset" in options ? options.toolset : undefined;
@@ -10576,9 +10509,7 @@ class AppServerSession extends RemoteClientSessionCore {
       command.external_tools = groups;
     if (this.mode.kind === "create-agent") {
       command.create_agent = {
-        body: await createAgentBody(this.mode.options, {
-          includeSdkOriginTag: this.remoteOptions.includeSdkOriginTag
-        }),
+        body: await createAgentBody(this.mode.options),
         pin_global: this.remoteOptions.pinGlobalAgent ?? this.mode.options.hidden !== true,
         ...this.mode.options.memfs === false ? { memfs: false } : {}
       };
@@ -10649,6 +10580,16 @@ function cloudModelEntry(raw) {
 function isNotFound(error) {
   return error instanceof APIError && error.status === 404;
 }
+function toOrderRelativeCursors(query) {
+  if ((query.order ?? "desc") !== "desc")
+    return query;
+  const { before, after, ...rest } = query;
+  return {
+    ...rest,
+    ...after != null ? { before: after } : {},
+    ...before != null ? { after: before } : {}
+  };
+}
 
 class CloudManagementTransport {
   client;
@@ -10724,7 +10665,7 @@ class CloudManagementTransport {
     return this.client.conversations.update(conversationId, body);
   }
   async listConversationMessages(conversationId, query) {
-    const page = await this.client.conversations.messages.list(conversationId, query);
+    const page = await this.client.conversations.messages.list(conversationId, toOrderRelativeCursors(query));
     return { messages: page.items };
   }
 }
@@ -11263,6 +11204,7 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
       if (!response.success || !response.runtime) {
         throw new Error(response.error ?? "Failed to start Cloud status runtime");
       }
+      this.watchTransportDisconnect(client);
       const tools = agentToolNames(response.agent);
       const skillSources = options.skillSources;
       const clientToolset = "toolset" in options ? options.toolset : undefined;
@@ -11808,14 +11750,6 @@ function getBlockLabels(memory) {
     return null;
   }).filter((label) => label !== null);
 }
-function validateApprovalRecoveryOptions(options) {
-  if (options.maxApprovalRecoveryAttempts !== undefined && (!Number.isInteger(options.maxApprovalRecoveryAttempts) || options.maxApprovalRecoveryAttempts < 0)) {
-    throw new Error("Invalid maxApprovalRecoveryAttempts. Expected a non-negative integer.");
-  }
-  if (options.approvalRecoveryTimeoutMs !== undefined && (!Number.isInteger(options.approvalRecoveryTimeoutMs) || options.approvalRecoveryTimeoutMs <= 0)) {
-    throw new Error("Invalid approvalRecoveryTimeoutMs. Expected a positive integer.");
-  }
-}
 function validateRemovedSessionOptions(options) {
   const removedOptions = options;
   if (removedOptions.systemPrompt !== undefined) {
@@ -11928,7 +11862,6 @@ function validateCreateSessionOptions(options) {
   validateMcpServers(options.mcpServers);
   validateReasoningEffort(options.reasoningEffort);
   validateDreamingOptions(options.dreaming);
-  validateApprovalRecoveryOptions(options);
   validateRemovedSessionOptions(options);
 }
 function validateCreateAgentOptions(options) {
@@ -12136,7 +12069,7 @@ class LettaAgentClientBase {
   async prompt(message, agentId, options = {}) {
     const session = this.createSession(agentId, options);
     try {
-      return await session.runTurn(message);
+      return await session.sendAndWaitForResult(message);
     } finally {
       session.close();
     }
@@ -12354,4 +12287,4 @@ export {
   CloudManagedSandboxExpiredError
 };
 
-//# debugId=FE3D4D568E602DA664756E2164756E21
+//# debugId=B03015C0FF639CFA64756E2164756E21