@letta-ai/letta-code 0.30.26 → 0.30.27

package/dist/types/agent/turn-recovery-policy.d.ts

@@ -123,4 +123,37 @@ export declare function shouldAttemptApprovalRecovery(opts: {
     retries: number;
     maxRetries: number;
 }): boolean;
+export interface ChatGPTUsageLimitDetail {
+    planType: string | null;
+    /** Absolute reset time in ms since epoch, when the server reported one. */
+    resetsAt: number | null;
+}
+/**
+ * Best-effort parse of a ChatGPT usage-limit error detail string, e.g.
+ * `ChatGPT rate limit exceeded: {"error":{"type":"usage_limit_reached",
+ * "plan_type":"plus","resets_at":1700000000,"resets_in_seconds":3600}}`.
+ * Returns null unless the detail is a string containing
+ * `usage_limit_reached` (case-insensitive); reset fields are optional and
+ * parse failures degrade to `{ planType: null, resetsAt: null }`.
+ */
+export declare function parseChatGPTUsageLimitDetail(detail: unknown): ChatGPTUsageLimitDetail | null;
+export interface ChatGPTFailoverModelEntry {
+    handle: string;
+    providerType?: string;
+    providerCategory?: string;
+}
+/**
+ * Pick a sibling ChatGPT plan handle to fail over to when the current plan
+ * hits its usage limit. The current handle must itself resolve to a
+ * chatgpt_oauth BYOK model in `models` (otherwise returns null). Siblings
+ * share the same model suffix (after the first `/`) under a different
+ * provider prefix, are chatgpt_oauth + byok, and are not in
+ * `exhaustedProviders`. One sibling is chosen uniformly at random.
+ */
+export declare function selectChatGPTQuotaFailoverHandle(params: {
+    currentHandle: string;
+    models: ChatGPTFailoverModelEntry[];
+    exhaustedProviders: ReadonlySet<string>;
+    random?: () => number;
+}): string | null;
 //# sourceMappingURL=turn-recovery-policy.d.ts.map

package/dist/types/agent/turn-recovery-policy.d.ts.map

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

package/dist/types/tools/impl/apply-patch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-patch.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/apply-patch.ts"],"names":[],"mappings":"AAMA,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AA0CD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CA8E3B"}
+{"version":3,"file":"apply-patch.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/apply-patch.ts"],"names":[],"mappings":"AAMA,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AA0CD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CA+E3B"}

package/letta.js

@@ -5509,7 +5509,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@letta-ai/letta-code",
-    version: "0.30.26",
+    version: "0.30.27",
     description: "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
     type: "module",
     packageManager: "bun@1.3.10",
@@ -150499,6 +150499,7 @@ async function apply_patch(args) {
     throw new Error("No files were modified.");
   }
   const cwd = getCurrentWorkingDirectory();
+  verifyNoDuplicatePaths(cwd, operations);
   const affected = { added: [], modified: [], deleted: [] };
   for (const op of operations) {
     if (op.kind === "add") {
@@ -150761,6 +150762,17 @@ function assertPatchPath(patchPath, operation) {
 function resolvePatchPath(cwd, patchPath) {
   return path7.isAbsolute(patchPath) ? patchPath : path7.resolve(cwd, patchPath);
 }
+function verifyNoDuplicatePaths(cwd, operations) {
+  const seen = new Set;
+  for (const op of operations) {
+    const patchPath = op.kind === "update" ? op.fromPath : op.path;
+    const resolved = resolvePatchPath(cwd, patchPath);
+    if (seen.has(resolved)) {
+      throw new Error(`multiple operations target ${patchPath}`);
+    }
+    seen.add(resolved);
+  }
+}
 async function deriveNewContentsFromChunks(absolutePath, filePathForErrors, chunks) {
   let originalContents = "";
   try {
@@ -182861,7 +182873,71 @@ function rebuildInputWithFreshDenials(currentInput, serverApprovals, denialReaso
 function shouldAttemptApprovalRecovery(opts) {
   return opts.approvalPendingDetected && opts.retries < opts.maxRetries;
 }
-var INVALID_TOOL_CALL_IDS_FRAGMENT = "invalid tool call ids", APPROVAL_PENDING_DETAIL_FRAGMENT = "waiting for approval", CONVERSATION_BUSY_DETAIL_FRAGMENTS, CONVERSATION_BUSY_RUN_ID_PATTERN, EMPTY_RESPONSE_DETAIL_FRAGMENT = "empty content in", RETRYABLE_PROVIDER_DETAIL_PATTERNS, NON_RETRYABLE_PROVIDER_DETAIL_PATTERNS, NON_RETRYABLE_RUN_ERROR_TYPES, NON_RETRYABLE_429_REASONS, NON_RETRYABLE_QUOTA_DETAIL_PATTERNS, NON_RETRYABLE_4XX_PATTERN, RETRYABLE_429_PATTERN, DEFAULT_TRANSIENT_RETRY_BASE_DELAY_MS = 1000, CLOUDFLARE_EDGE_52X_RETRY_BASE_DELAY_MS = 5000, CONVERSATION_BUSY_RETRY_BASE_DELAY_MS = 1e4, EMPTY_RESPONSE_RETRY_BASE_DELAY_MS = 500, STALE_APPROVAL_RECOVERY_DENIAL_REASON = "The agent harness automatically closed this stale pending tool call to recover from a client/server state desync: the server was still waiting on a result for it, but the harness had no matching tool execution in flight and no result was ever recorded. It was not denied by the user or a permissions policy. Re-issue the tool call if you still need it.";
+function parseChatGPTUsageLimitDetail(detail) {
+  if (typeof detail !== "string")
+    return null;
+  if (!detail.toLowerCase().includes(CHATGPT_USAGE_LIMIT_FRAGMENT)) {
+    return null;
+  }
+  const fallback = { planType: null, resetsAt: null };
+  const jsonStart = detail.indexOf("{");
+  const jsonEnd = detail.lastIndexOf("}");
+  if (jsonStart === -1 || jsonEnd <= jsonStart)
+    return fallback;
+  let parsed;
+  try {
+    parsed = JSON.parse(detail.slice(jsonStart, jsonEnd + 1));
+  } catch {
+    return fallback;
+  }
+  if (typeof parsed !== "object" || parsed === null)
+    return fallback;
+  const errorField = parsed.error;
+  const errorObj = typeof errorField === "object" && errorField !== null ? errorField : parsed;
+  const planType = typeof errorObj.plan_type === "string" && errorObj.plan_type.length > 0 ? errorObj.plan_type : null;
+  let resetsAt = null;
+  if (typeof errorObj.resets_at === "number" && errorObj.resets_at > 0) {
+    resetsAt = errorObj.resets_at * 1000;
+  } else if (typeof errorObj.resets_in_seconds === "number" && errorObj.resets_in_seconds > 0) {
+    resetsAt = Date.now() + errorObj.resets_in_seconds * 1000;
+  }
+  return { planType, resetsAt };
+}
+function isChatGPTByokModel(model) {
+  return model.providerType === CHATGPT_OAUTH_PROVIDER_TYPE2 && model.providerCategory === BYOK_PROVIDER_CATEGORY;
+}
+function selectChatGPTQuotaFailoverHandle(params) {
+  const { currentHandle, models: models3, exhaustedProviders } = params;
+  const random = params.random ?? Math.random;
+  const slashIndex = currentHandle.indexOf("/");
+  if (slashIndex <= 0)
+    return null;
+  const currentProvider = currentHandle.slice(0, slashIndex);
+  const modelSuffix = currentHandle.slice(slashIndex + 1);
+  if (!modelSuffix)
+    return null;
+  const currentEntry = models3.find((m2) => m2.handle === currentHandle);
+  if (!currentEntry || !isChatGPTByokModel(currentEntry))
+    return null;
+  const candidates2 = models3.filter((m2) => {
+    if (!isChatGPTByokModel(m2))
+      return false;
+    const idx = m2.handle.indexOf("/");
+    if (idx <= 0)
+      return false;
+    const provider = m2.handle.slice(0, idx);
+    if (provider === currentProvider)
+      return false;
+    if (exhaustedProviders.has(provider))
+      return false;
+    return m2.handle.slice(idx + 1) === modelSuffix;
+  });
+  if (candidates2.length === 0)
+    return null;
+  const index = Math.min(Math.floor(random() * candidates2.length), candidates2.length - 1);
+  return candidates2[index]?.handle ?? null;
+}
+var INVALID_TOOL_CALL_IDS_FRAGMENT = "invalid tool call ids", APPROVAL_PENDING_DETAIL_FRAGMENT = "waiting for approval", CONVERSATION_BUSY_DETAIL_FRAGMENTS, CONVERSATION_BUSY_RUN_ID_PATTERN, EMPTY_RESPONSE_DETAIL_FRAGMENT = "empty content in", RETRYABLE_PROVIDER_DETAIL_PATTERNS, NON_RETRYABLE_PROVIDER_DETAIL_PATTERNS, NON_RETRYABLE_RUN_ERROR_TYPES, NON_RETRYABLE_429_REASONS, NON_RETRYABLE_QUOTA_DETAIL_PATTERNS, NON_RETRYABLE_4XX_PATTERN, RETRYABLE_429_PATTERN, DEFAULT_TRANSIENT_RETRY_BASE_DELAY_MS = 1000, CLOUDFLARE_EDGE_52X_RETRY_BASE_DELAY_MS = 5000, CONVERSATION_BUSY_RETRY_BASE_DELAY_MS = 1e4, EMPTY_RESPONSE_RETRY_BASE_DELAY_MS = 500, STALE_APPROVAL_RECOVERY_DENIAL_REASON = "The agent harness automatically closed this stale pending tool call to recover from a client/server state desync: the server was still waiting on a result for it, but the harness had no matching tool execution in flight and no result was ever recorded. It was not denied by the user or a permissions policy. Re-issue the tool call if you still need it.", CHATGPT_USAGE_LIMIT_FRAGMENT = "usage_limit_reached", CHATGPT_OAUTH_PROVIDER_TYPE2 = "chatgpt_oauth", BYOK_PROVIDER_CATEGORY = "byok";
 var init_turn_recovery_policy = __esm(() => {
   init_error_formatter();
   init_zai_errors();
@@ -457811,6 +457887,96 @@ var init_approval_recovery = __esm(() => {
   init_turn_recovery_policy();
 });
 
+// src/agent/chatgpt-plan-rotation.ts
+function providerFromHandle(handle2) {
+  const idx = handle2.indexOf("/");
+  return idx > 0 ? handle2.slice(0, idx) : null;
+}
+function isChatGPTByokHandleInModels(handle2, models3) {
+  const entry = models3.find((m4) => m4.handle === handle2);
+  return entry?.providerType === "chatgpt_oauth" && entry?.providerCategory === "byok";
+}
+async function resolveAgentModelHandle2(agentId) {
+  try {
+    const agent2 = await getBackend().retrieveAgent(agentId);
+    const record5 = agent2;
+    if (typeof record5.model === "string" && record5.model.length > 0) {
+      return record5.model;
+    }
+    return resolveModelHandleFromLlmConfig(record5.llm_config);
+  } catch {
+    return null;
+  }
+}
+async function rotateChatGPTPlanOnQuotaLimit(params) {
+  const { agentId, detail } = params;
+  const parsedDetail = parseChatGPTUsageLimitDetail(detail);
+  if (!parsedDetail)
+    return null;
+  let models3 = getCachedAvailableModels();
+  if (!models3) {
+    try {
+      await getAvailableModelHandles();
+      models3 = getCachedAvailableModels();
+    } catch {
+      return null;
+    }
+  }
+  if (!models3)
+    return null;
+  let currentHandle = params.currentHandle;
+  if (!currentHandle || !isChatGPTByokHandleInModels(currentHandle, models3)) {
+    currentHandle = await resolveAgentModelHandle2(agentId);
+  }
+  if (!currentHandle || !isChatGPTByokHandleInModels(currentHandle, models3)) {
+    return null;
+  }
+  const fromProvider = providerFromHandle(currentHandle);
+  if (!fromProvider)
+    return null;
+  exhaustedProviders.add(fromProvider);
+  const toHandle = selectChatGPTQuotaFailoverHandle({
+    currentHandle,
+    models: models3,
+    exhaustedProviders
+  });
+  if (!toHandle)
+    return null;
+  const toProvider = providerFromHandle(toHandle);
+  if (!toProvider)
+    return null;
+  try {
+    await updateAgentLLMConfig(agentId, toHandle, {
+      provider_type: "chatgpt_oauth"
+    });
+  } catch {
+    return null;
+  }
+  return {
+    fromProvider,
+    toProvider,
+    toHandle,
+    resetsAt: parsedDetail.resetsAt
+  };
+}
+function formatPlanRotationNotice(params) {
+  const { fromProvider, toProvider, resetsAt } = params;
+  const resetSuffix = resetsAt !== null ? ` (resets ${new Date(resetsAt).toLocaleTimeString([], {
+    hour: "numeric",
+    minute: "2-digit"
+  })})` : "";
+  return `${fromProvider} hit its usage limit${resetSuffix} — switched to ${toProvider}`;
+}
+var CHATGPT_PLAN_ROTATION_MAX_SWAPS_PER_TURN = 3, exhaustedProviders;
+var init_chatgpt_plan_rotation = __esm(() => {
+  init_available_models();
+  init_model_handles();
+  init_modify();
+  init_turn_recovery_policy();
+  init_backend2();
+  exhaustedProviders = new Set;
+});
+
 // src/websocket/listener/skill-injection.ts
 function injectQueuedSkillContent(messages, context3) {
   const skillContents = consumeQueuedSkillContent();
@@ -462811,7 +462977,7 @@ async function handleIncomingMessageInner(msg, socket, runtime, onStatusChange,
   const normalizedAgentId = normalizeCwdAgentId(agentId);
   const turnWorkingDirectory = getConversationWorkingDirectory(runtime.listener, normalizedAgentId, conversationId);
   const turnPermissionModeState = getOrCreateConversationPermissionModeStateRef(runtime.listener, normalizedAgentId, conversationId);
-  let postStopApprovalRecoveryRetries = 0, llmApiErrorRetries = 0, emptyResponseRetries = 0, lastApprovalContinuationAccepted = false, activeDequeuedBatchId = dequeuedBatchId;
+  let postStopApprovalRecoveryRetries = 0, llmApiErrorRetries = 0, emptyResponseRetries = 0, chatgptPlanSwaps = 0, lastApprovalContinuationAccepted = false, activeDequeuedBatchId = dequeuedBatchId;
   const msgRunIds = [];
   let lastExecutionResults = null;
   let lastExecutingToolCallIds = [];
@@ -463181,6 +463347,51 @@ async function handleIncomingMessageInner(msg, socket, runtime, onStatusChange,
           turnToolContextId = getStreamToolContextId(stream12);
           continue;
         }
+        if (chatgptPlanSwaps < CHATGPT_PLAN_ROTATION_MAX_SWAPS_PER_TURN) {
+          const rotation = await rotateChatGPTPlanOnQuotaLimit({
+            agentId,
+            currentHandle: null,
+            detail: errorDetail2
+          });
+          if (rotation) {
+            chatgptPlanSwaps += 1;
+            emitRecoverableRetryNotice(socket, runtime, {
+              kind: "transient_provider_retry",
+              message: formatPlanRotationNotice(rotation),
+              reason: "llm_api_error",
+              attempt: chatgptPlanSwaps,
+              maxAttempts: CHATGPT_PLAN_ROTATION_MAX_SWAPS_PER_TURN,
+              delayMs: 0,
+              runId: lastRunId || undefined,
+              agentId,
+              conversationId
+            });
+            if (turnAbortSignal.aborted) {
+              throw new Error("Cancelled by user");
+            }
+            turnInput = refreshTurnInputOtidsForNewRequest(turnInput);
+            setTurnLoopStatus(runtime, turnLease, "SENDING_API_REQUEST", {
+              agent_id: agentId,
+              conversation_id: conversationId
+            });
+            const retryInputWithSkillContent = injectQueuedSkillContent(turnInput.messages, { socket, runtime, agentId, conversationId });
+            const retrySendResult = await turnInputSender.send(retryInputWithSkillContent);
+            turnInput = updateTurnInputMessagesPreservingOtids(turnInput, retryInputWithSkillContent);
+            const retryStream = turnInputSender.accept(retrySendResult);
+            if (!retryStream) {
+              return;
+            }
+            stream12 = retryStream;
+            pendingNormalizationInterruptedToolCallIds = [];
+            markAwaitingAcceptedApprovalContinuationRunId(runtime, turnLease, turnInput.messages);
+            setTurnLoopStatus(runtime, turnLease, "PROCESSING_API_RESPONSE", {
+              agent_id: agentId,
+              conversation_id: conversationId
+            });
+            turnToolContextId = getStreamToolContextId(stream12);
+            continue;
+          }
+        }
         const retriable = await isRetriablePostStopError(stopReason || "error", lastRunId, errorDetail2);
         if (finishIfInterrupted(lastRunId || runtime.activeRunId)) {
           break;
@@ -463464,6 +463675,7 @@ async function handleIncomingMessageInner(msg, socket, runtime, onStatusChange,
 }
 var init_turn = __esm(async () => {
   init_approval_recovery();
+  init_chatgpt_plan_rotation();
   init_check_approval();
   init_turn_recovery_policy();
   init_backend2();
@@ -485848,6 +486060,9 @@ function isAssistantMessage2(message) {
 function isUserMessage(message) {
   return message.message_type === "user_message";
 }
+function isTaskNotificationMessage(message) {
+  return extractMessageText(message).trimStart().startsWith("<task-notification>");
+}
 function messageRunId(message) {
   if (!message)
     return null;
@@ -485884,8 +486099,9 @@ async function waitForEnvironmentAssistantMessage(params) {
         return sequenceId !== null && sequenceId > anchorSequenceId;
       });
       const nextUserSequenceId = newerMessages.reduce((closest, message) => {
-        if (!isUserMessage(message))
+        if (!isUserMessage(message) || isTaskNotificationMessage(message)) {
           return closest;
+        }
         const sequenceId = messageSequenceId(message);
         if (sequenceId === null)
           return closest;
@@ -497557,7 +497773,7 @@ var init_mcp_client = __esm(() => {
   init_streamableHttp();
   DEFAULT_CLIENT_INFO = {
     name: "letta-code",
-    version: "0.30.26"
+    version: "0.30.27"
   };
 });
 
@@ -499949,6 +500165,7 @@ ${loadedContents.join(`
   let llmApiErrorRetries = 0;
   let emptyResponseRetries = 0;
   let conversationBusyRetries = 0;
+  let chatgptPlanSwaps = 0;
   markMilestone("HEADLESS_FIRST_STREAM_START");
   measureSinceMilestone("headless-setup-total", "HEADLESS_CLIENT_READY");
   const checkMaxTurns = async () => {
@@ -500215,6 +500432,7 @@ ${loadedContents.join(`
         llmApiErrorRetries = 0;
         emptyResponseRetries = 0;
         conversationBusyRetries = 0;
+        chatgptPlanSwaps = 0;
         const continueMessage = await emitHeadlessTurnEnd({
           agent: agent2,
           conversationId,
@@ -500315,6 +500533,34 @@ ${loadedContents.join(`
         }
       }
       const detailFromRun = await fetchRunErrorDetail(lastRunId);
+      if (chatgptPlanSwaps < CHATGPT_PLAN_ROTATION_MAX_SWAPS_PER_TURN) {
+        const rotation = await rotateChatGPTPlanOnQuotaLimit({
+          agentId: agent2.id,
+          currentHandle: null,
+          detail: detailFromRun ?? latestErrorText
+        });
+        if (rotation) {
+          chatgptPlanSwaps += 1;
+          const rotationMessage = formatPlanRotationNotice(rotation);
+          if (outputFormat === "stream-json") {
+            const retryMsg = {
+              type: "retry",
+              reason: "llm_api_error",
+              attempt: chatgptPlanSwaps,
+              max_attempts: CHATGPT_PLAN_ROTATION_MAX_SWAPS_PER_TURN,
+              delay_ms: 0,
+              run_id: lastRunId ?? undefined,
+              session_id: sessionId,
+              uuid: `retry-${lastRunId || randomUUID35()}`
+            };
+            writeWireMessage(retryMsg);
+          } else {
+            console.error(rotationMessage);
+          }
+          currentInput = refreshInputOtidsForNewRequest(currentInput);
+          continue;
+        }
+      }
       if (stopReason === "llm_api_error") {
         if (llmApiErrorRetries < LLM_API_ERROR_MAX_RETRIES2) {
           const attempt2 = llmApiErrorRetries + 1;
@@ -501686,6 +501932,7 @@ var init_headless = __esm(async () => {
   init_subagent_stdout_failure();
   init_approval_recovery();
   init_bootstrap_handler();
+  init_chatgpt_plan_rotation();
   init_client_skills();
   init_context();
   init_create5();
@@ -547536,6 +547783,7 @@ function useConversationLoop(ctx) {
     buffersRef,
     clearApprovalToolContext,
     closeTrajectorySegment,
+    chatgptPlanSwapsRef,
     consumeQueuedMessages,
     queueModeRef,
     contextTrackerRef,
@@ -547767,6 +548015,7 @@ function useConversationLoop(ctx) {
       emptyResponseRetriesRef.current = 0;
       conversationBusyRetriesRef.current = 0;
       quotaAutoSwapAttemptedRef.current = false;
+      chatgptPlanSwapsRef.current = 0;
     }
     let currentRunId;
     let preserveTranscriptStartForApproval = false;
@@ -548731,6 +548980,27 @@ ${feedback}
           buffersRef.current.interrupted = false;
           continue;
         }
+        if (chatgptPlanSwapsRef.current < CHATGPT_PLAN_ROTATION_MAX_SWAPS_PER_TURN) {
+          const rotation = await rotateChatGPTPlanOnQuotaLimit({
+            agentId: agentIdRef.current,
+            currentHandle: currentModelId,
+            detail: detailFromRun ?? fallbackError
+          });
+          if (rotation) {
+            chatgptPlanSwapsRef.current += 1;
+            const statusId = uid("status");
+            buffersRef.current.byId.set(statusId, {
+              kind: "status",
+              id: statusId,
+              lines: [formatPlanRotationNotice(rotation)]
+            });
+            buffersRef.current.order.push(statusId);
+            refreshDerived();
+            currentInput = refreshInputOtidsForNewRequest(currentInput);
+            buffersRef.current.interrupted = false;
+            continue;
+          }
+        }
         const autoSwapOnQuotaLimitEnabled = settingsManager.getSetting("autoSwapOnQuotaLimit") !== false;
         const supportsHostedAutoQuotaFallback = !getBackend().capabilities.localModelCatalog;
         const isQuotaLimit = isQuotaLimitErrorDetail(detailFromRun ?? fallbackError);
@@ -549012,6 +549282,7 @@ var init_use_conversation_loop = __esm(async () => {
   init_error();
   init_approval_recovery();
   init_available_models();
+  init_chatgpt_plan_rotation();
   init_check_approval();
   init_model();
   init_prompt_assets();
@@ -557857,6 +558128,7 @@ function App2({
   const llmApiErrorRetriesRef = import_react121.useRef(0);
   const quotaAutoSwapAttemptedRef = import_react121.useRef(false);
   const emptyResponseRetriesRef = import_react121.useRef(0);
+  const chatgptPlanSwapsRef = import_react121.useRef(0);
   const conversationBusyRetriesRef = import_react121.useRef(0);
   const [queueDisplay, setQueueDisplay] = import_react121.useState([]);
   const tuiQueueRef = import_react121.useRef(null);
@@ -559345,6 +559617,7 @@ Memory may be stale. Try running: git -C ${getScopedMemoryFilesystemRoot(agentId
     autoAllowedExecutionRef,
     buffersRef,
     clearApprovalToolContext,
+    chatgptPlanSwapsRef,
     closeTrajectorySegment,
     consumeQueuedMessages,
     queueModeRef,
@@ -564456,4 +564729,4 @@ function registerBunOAuthFlows() {
 registerBunOAuthFlows();
 await init_src5().then(() => exports_src2);
 
-//# debugId=BBC1C9C009AB28B764756E2164756E21
+//# debugId=995B0F0DB5D2C58C64756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.30.26",
+  "version": "0.30.27",
   "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
   "type": "module",
   "packageManager": "bun@1.3.10",

package/scripts/source-file-size-baseline.json

@@ -5,11 +5,11 @@
   "src/backend/local/local-backend.ts": 1014,
   "src/backend/local/local-store.ts": 3459,
   "src/backend/pi-stream-adapter.test.ts": 1304,
-  "src/cli/app/AppCoordinator.tsx": 5186,
+  "src/cli/app/AppCoordinator.tsx": 5189,
   "src/cli/app/AppView.tsx": 1735,
   "src/cli/app/use-approval-flow.ts": 1163,
   "src/cli/app/use-configuration-handlers.ts": 1421,
-  "src/cli/app/use-conversation-loop.ts": 2871,
+  "src/cli/app/use-conversation-loop.ts": 2912,
   "src/cli/app/use-submit-handler.ts": 4077,
   "src/cli/components/AgentSelector.tsx": 1104,
   "src/cli/components/InputRich.tsx": 2225,
@@ -21,7 +21,7 @@
   "src/cli/mods/local-mod-loader.test.ts": 1043,
   "src/cli/reflection-transcript.test.ts": 1084,
   "src/cli/subcommands/skills.ts": 1264,
-  "src/headless.ts": 4953,
+  "src/headless.ts": 4994,
   "src/hooks/integration.test.ts": 1147,
   "src/index.ts": 2775,
   "src/mods/learning-harness.ts": 2434,
@@ -44,5 +44,6 @@
   "src/websocket/listener/file-commands.ts": 1053,
   "src/websocket/listener/lifecycle.ts": 1048,
   "src/websocket/listener/protocol-inbound.ts": 2242,
-  "src/websocket/listener/protocol-outbound.ts": 1070
+  "src/websocket/listener/protocol-outbound.ts": 1070,
+  "src/websocket/listener/turn.ts": 1058
 }