qwenproxy-cli 1.0.25 → 1.0.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qwenproxy-cli",
-  "version": "1.0.25",
+  "version": "1.0.26",
   "description": "High-performance OpenAI & Anthropic compatible API gateway for Qwen with multi-account rotation, interactive TUI, and resilient tool calling.",
   "main": "src/index.ts",
   "bin": {
@@ -24,8 +24,8 @@
     "reset": "npx tsx src/reset-cooldowns.ts",
     "purge": "npx tsx src/delete-chats.ts",
     "test": "npm run test:mock && npm run test:live",
-    "test:mock": "tsx --test --test-concurrency=1 --env-file=.env.test src/tests/account-concurrency.test.ts src/tests/concurrency-latest-wins.test.ts src/tests/mutex.test.ts src/tests/context-truncation.test.ts src/tests/streaming-thinking-summary.test.ts src/tests/tool-call-guard.test.ts src/tests/utils-logger-full.test.ts src/tests/logger-toolcall-errors.test.ts src/tests/logger-toolcall-disabled.test.ts src/tests/utils-json-full.test.ts src/tests/utils-session-guard-full.test.ts src/tests/core-logic-full.test.ts src/tests/core-logic-accounts.test.ts src/tests/chat-validation-full.test.ts src/tests/chat-logic-full.test.ts src/tests/account-stickiness.test.ts src/tests/accounts-security.test.ts src/tests/advanced.test.ts src/tests/auth-playwright.test.ts src/tests/captcha-solver.test.ts src/tests/cache-scan-regex.test.ts src/tests/chat-cleanup.test.ts src/tests/chromium-args.test.ts src/tests/config-current.test.ts src/tests/context-meter.test.ts src/tests/concurrency.test.ts src/tests/delta.test.ts src/tests/fingerprint.test.ts src/tests/human-behavior.test.ts src/tests/index.test.ts src/tests/json-recovery.test.ts src/tests/jsonFix.test.ts src/tests/memory-cache.test.ts src/tests/model-alias.test.ts src/tests/model-registry-thinking.test.ts src/tests/models-endpoint.test.ts src/tests/multimodal.test.ts src/tests/oss-upload.test.ts src/tests/parser.test.ts src/tests/personalization-flow.test.ts src/tests/personalization-required.test.ts src/tests/retry-policy.test.ts src/tests/rotation.test.ts src/tests/server-lifecycle.test.ts src/tests/session-keeper.test.ts src/tests/session-state.test.ts src/tests/single-account-mode.test.ts src/tests/stream-retry.test.ts src/tests/tool-calls-endpoint.test.ts src/tests/tool-instructions-cache.test.ts src/tests/session-id.test.ts src/tests/watchdog-ram.test.ts src/tests/tool-recovery-t1t2.test.ts src/tests/abort-silent-t4.test.ts src/tests/t3-close-tag-escape.test.ts src/tests/t5-tool-cap.test.ts src/tests/logger-redaction.test.ts src/tests/stall-timeout-retryable.test.ts src/tests/t6-missing-quote-array-close.test.ts src/tests/watchdog-rss.test.ts src/tests/logical-thread-batch.test.ts src/tests/chat-pool-style.test.ts src/tests/queue-wait-cap.test.ts src/tests/context-eviction-order.test.ts src/tests/chat-in-progress-settle.test.ts src/tests/stream-lock-leak.test.ts src/tests/stream-semaphore.test.ts src/tests/waf-isolation.test.ts src/tests/legacy-completions.test.ts src/tests/response-format.test.ts src/tests/cors-headers.test.ts src/tests/stream-lock-terminal-cancel.test.ts src/tests/parser-truncated-tool-call.test.ts src/tests/metrics-prometheus.test.ts src/tests/context-death-cleanup.test.ts src/tests/personalization-direct-fetch.test.ts src/tests/completion-headers-parity.test.ts src/tests/parallel-escape-repro.test.ts src/tests/chat-in-progress-scale-cost.test.ts src/tests/temp-chat-mode.test.ts src/tests/profile-reset.test.ts src/tests/error-classification.test.ts src/tests/quota-cooldown.test.ts src/tests/account-ready-gate.test.ts src/tests/tool-cap-notice.test.ts src/tests/interaction-flows.test.ts src/tests/headers-gate-cooldown-fallback.test.ts src/tests/unwrapped-tool-calls.test.ts src/tests/anthropic.test.ts src/tests/sync-clients.test.ts src/tests/cli.test.ts src/tests/paths.test.ts src/tests/tool-manifest.test.ts src/tests/tui.test.ts src/tests/personalization-deadline.test.ts",
-    "test:mock:fast": "tsx --test --test-concurrency=2 --env-file=.env.test src/tests/account-concurrency.test.ts src/tests/concurrency-latest-wins.test.ts src/tests/mutex.test.ts src/tests/context-truncation.test.ts src/tests/streaming-thinking-summary.test.ts src/tests/tool-call-guard.test.ts src/tests/utils-logger-full.test.ts src/tests/logger-toolcall-errors.test.ts src/tests/logger-toolcall-disabled.test.ts src/tests/utils-json-full.test.ts src/tests/utils-session-guard-full.test.ts src/tests/core-logic-full.test.ts src/tests/core-logic-accounts.test.ts src/tests/chat-validation-full.test.ts src/tests/chat-logic-full.test.ts src/tests/account-stickiness.test.ts src/tests/accounts-security.test.ts src/tests/advanced.test.ts src/tests/auth-playwright.test.ts src/tests/captcha-solver.test.ts src/tests/cache-scan-regex.test.ts src/tests/chat-cleanup.test.ts src/tests/chromium-args.test.ts src/tests/config-current.test.ts src/tests/context-meter.test.ts src/tests/concurrency.test.ts src/tests/delta.test.ts src/tests/fingerprint.test.ts src/tests/human-behavior.test.ts src/tests/index.test.ts src/tests/json-recovery.test.ts src/tests/jsonFix.test.ts src/tests/memory-cache.test.ts src/tests/model-alias.test.ts src/tests/model-registry-thinking.test.ts src/tests/models-endpoint.test.ts src/tests/multimodal.test.ts src/tests/oss-upload.test.ts src/tests/parser.test.ts src/tests/personalization-flow.test.ts src/tests/personalization-required.test.ts src/tests/retry-policy.test.ts src/tests/rotation.test.ts src/tests/server-lifecycle.test.ts src/tests/session-keeper.test.ts src/tests/session-state.test.ts src/tests/single-account-mode.test.ts src/tests/stream-retry.test.ts src/tests/tool-calls-endpoint.test.ts src/tests/tool-instructions-cache.test.ts src/tests/session-id.test.ts src/tests/watchdog-ram.test.ts src/tests/tool-recovery-t1t2.test.ts src/tests/abort-silent-t4.test.ts src/tests/t3-close-tag-escape.test.ts src/tests/t5-tool-cap.test.ts src/tests/logger-redaction.test.ts src/tests/stall-timeout-retryable.test.ts src/tests/t6-missing-quote-array-close.test.ts src/tests/watchdog-rss.test.ts src/tests/logical-thread-batch.test.ts src/tests/chat-pool-style.test.ts src/tests/queue-wait-cap.test.ts src/tests/context-eviction-order.test.ts src/tests/chat-in-progress-settle.test.ts src/tests/stream-lock-leak.test.ts src/tests/stream-semaphore.test.ts src/tests/waf-isolation.test.ts src/tests/legacy-completions.test.ts src/tests/response-format.test.ts src/tests/cors-headers.test.ts src/tests/stream-lock-terminal-cancel.test.ts src/tests/parser-truncated-tool-call.test.ts src/tests/metrics-prometheus.test.ts src/tests/context-death-cleanup.test.ts src/tests/personalization-direct-fetch.test.ts src/tests/completion-headers-parity.test.ts src/tests/parallel-escape-repro.test.ts src/tests/chat-in-progress-scale-cost.test.ts src/tests/temp-chat-mode.test.ts src/tests/profile-reset.test.ts src/tests/error-classification.test.ts src/tests/quota-cooldown.test.ts src/tests/account-ready-gate.test.ts src/tests/tool-cap-notice.test.ts src/tests/interaction-flows.test.ts src/tests/headers-gate-cooldown-fallback.test.ts src/tests/unwrapped-tool-calls.test.ts src/tests/anthropic.test.ts src/tests/sync-clients.test.ts src/tests/cli.test.ts src/tests/paths.test.ts src/tests/tool-manifest.test.ts src/tests/tui.test.ts src/tests/personalization-deadline.test.ts",
+    "test:mock": "tsx --test --test-concurrency=1 --env-file=.env.test src/tests/account-concurrency.test.ts src/tests/concurrency-latest-wins.test.ts src/tests/mutex.test.ts src/tests/context-truncation.test.ts src/tests/streaming-thinking-summary.test.ts src/tests/tool-call-guard.test.ts src/tests/utils-logger-full.test.ts src/tests/logger-toolcall-errors.test.ts src/tests/logger-toolcall-disabled.test.ts src/tests/utils-json-full.test.ts src/tests/utils-session-guard-full.test.ts src/tests/core-logic-full.test.ts src/tests/core-logic-accounts.test.ts src/tests/chat-validation-full.test.ts src/tests/chat-logic-full.test.ts src/tests/account-stickiness.test.ts src/tests/accounts-security.test.ts src/tests/advanced.test.ts src/tests/auth-playwright.test.ts src/tests/captcha-solver.test.ts src/tests/cache-scan-regex.test.ts src/tests/chat-cleanup.test.ts src/tests/chat-cleanup-auto.test.ts src/tests/chromium-args.test.ts src/tests/config-current.test.ts src/tests/context-meter.test.ts src/tests/concurrency.test.ts src/tests/delta.test.ts src/tests/fingerprint.test.ts src/tests/human-behavior.test.ts src/tests/index.test.ts src/tests/json-recovery.test.ts src/tests/jsonFix.test.ts src/tests/memory-cache.test.ts src/tests/model-alias.test.ts src/tests/model-registry-thinking.test.ts src/tests/models-endpoint.test.ts src/tests/multimodal.test.ts src/tests/oss-upload.test.ts src/tests/parser.test.ts src/tests/personalization-flow.test.ts src/tests/personalization-required.test.ts src/tests/retry-policy.test.ts src/tests/rotation.test.ts src/tests/server-lifecycle.test.ts src/tests/session-keeper.test.ts src/tests/session-state.test.ts src/tests/single-account-mode.test.ts src/tests/stream-retry.test.ts src/tests/tool-calls-endpoint.test.ts src/tests/tool-instructions-cache.test.ts src/tests/session-id.test.ts src/tests/watchdog-ram.test.ts src/tests/tool-recovery-t1t2.test.ts src/tests/abort-silent-t4.test.ts src/tests/t3-close-tag-escape.test.ts src/tests/t5-tool-cap.test.ts src/tests/logger-redaction.test.ts src/tests/stall-timeout-retryable.test.ts src/tests/t6-missing-quote-array-close.test.ts src/tests/watchdog-rss.test.ts src/tests/logical-thread-batch.test.ts src/tests/chat-pool-style.test.ts src/tests/queue-wait-cap.test.ts src/tests/context-eviction-order.test.ts src/tests/chat-in-progress-settle.test.ts src/tests/stream-lock-leak.test.ts src/tests/stream-semaphore.test.ts src/tests/waf-isolation.test.ts src/tests/legacy-completions.test.ts src/tests/response-format.test.ts src/tests/cors-headers.test.ts src/tests/stream-lock-terminal-cancel.test.ts src/tests/parser-truncated-tool-call.test.ts src/tests/metrics-prometheus.test.ts src/tests/context-death-cleanup.test.ts src/tests/personalization-direct-fetch.test.ts src/tests/completion-headers-parity.test.ts src/tests/parallel-escape-repro.test.ts src/tests/chat-in-progress-scale-cost.test.ts src/tests/temp-chat-mode.test.ts src/tests/profile-reset.test.ts src/tests/error-classification.test.ts src/tests/quota-cooldown.test.ts src/tests/account-ready-gate.test.ts src/tests/tool-cap-notice.test.ts src/tests/interaction-flows.test.ts src/tests/headers-gate-cooldown-fallback.test.ts src/tests/unwrapped-tool-calls.test.ts src/tests/anthropic.test.ts src/tests/sync-clients.test.ts src/tests/cli.test.ts src/tests/paths.test.ts src/tests/tool-manifest.test.ts src/tests/tui.test.ts src/tests/personalization-deadline.test.ts",
+    "test:mock:fast": "tsx --test --test-concurrency=2 --env-file=.env.test src/tests/account-concurrency.test.ts src/tests/concurrency-latest-wins.test.ts src/tests/mutex.test.ts src/tests/context-truncation.test.ts src/tests/streaming-thinking-summary.test.ts src/tests/tool-call-guard.test.ts src/tests/utils-logger-full.test.ts src/tests/logger-toolcall-errors.test.ts src/tests/logger-toolcall-disabled.test.ts src/tests/utils-json-full.test.ts src/tests/utils-session-guard-full.test.ts src/tests/core-logic-full.test.ts src/tests/core-logic-accounts.test.ts src/tests/chat-validation-full.test.ts src/tests/chat-logic-full.test.ts src/tests/account-stickiness.test.ts src/tests/accounts-security.test.ts src/tests/advanced.test.ts src/tests/auth-playwright.test.ts src/tests/captcha-solver.test.ts src/tests/cache-scan-regex.test.ts src/tests/chat-cleanup.test.ts src/tests/chat-cleanup-auto.test.ts src/tests/chromium-args.test.ts src/tests/config-current.test.ts src/tests/context-meter.test.ts src/tests/concurrency.test.ts src/tests/delta.test.ts src/tests/fingerprint.test.ts src/tests/human-behavior.test.ts src/tests/index.test.ts src/tests/json-recovery.test.ts src/tests/jsonFix.test.ts src/tests/memory-cache.test.ts src/tests/model-alias.test.ts src/tests/model-registry-thinking.test.ts src/tests/models-endpoint.test.ts src/tests/multimodal.test.ts src/tests/oss-upload.test.ts src/tests/parser.test.ts src/tests/personalization-flow.test.ts src/tests/personalization-required.test.ts src/tests/retry-policy.test.ts src/tests/rotation.test.ts src/tests/server-lifecycle.test.ts src/tests/session-keeper.test.ts src/tests/session-state.test.ts src/tests/single-account-mode.test.ts src/tests/stream-retry.test.ts src/tests/tool-calls-endpoint.test.ts src/tests/tool-instructions-cache.test.ts src/tests/session-id.test.ts src/tests/watchdog-ram.test.ts src/tests/tool-recovery-t1t2.test.ts src/tests/abort-silent-t4.test.ts src/tests/t3-close-tag-escape.test.ts src/tests/t5-tool-cap.test.ts src/tests/logger-redaction.test.ts src/tests/stall-timeout-retryable.test.ts src/tests/t6-missing-quote-array-close.test.ts src/tests/watchdog-rss.test.ts src/tests/logical-thread-batch.test.ts src/tests/chat-pool-style.test.ts src/tests/queue-wait-cap.test.ts src/tests/context-eviction-order.test.ts src/tests/chat-in-progress-settle.test.ts src/tests/stream-lock-leak.test.ts src/tests/stream-semaphore.test.ts src/tests/waf-isolation.test.ts src/tests/legacy-completions.test.ts src/tests/response-format.test.ts src/tests/cors-headers.test.ts src/tests/stream-lock-terminal-cancel.test.ts src/tests/parser-truncated-tool-call.test.ts src/tests/metrics-prometheus.test.ts src/tests/context-death-cleanup.test.ts src/tests/personalization-direct-fetch.test.ts src/tests/completion-headers-parity.test.ts src/tests/parallel-escape-repro.test.ts src/tests/chat-in-progress-scale-cost.test.ts src/tests/temp-chat-mode.test.ts src/tests/profile-reset.test.ts src/tests/error-classification.test.ts src/tests/quota-cooldown.test.ts src/tests/account-ready-gate.test.ts src/tests/tool-cap-notice.test.ts src/tests/interaction-flows.test.ts src/tests/headers-gate-cooldown-fallback.test.ts src/tests/unwrapped-tool-calls.test.ts src/tests/anthropic.test.ts src/tests/sync-clients.test.ts src/tests/cli.test.ts src/tests/paths.test.ts src/tests/tool-manifest.test.ts src/tests/tui.test.ts src/tests/personalization-deadline.test.ts",
     "test:live": "tsx --test src/tests/concurrentChat.test.ts src/tests/agenticStress.test.ts",
     "benchmark:proxy": "npx tsx src/benchmarks/proxy-baseline.ts",
     "typecheck": "tsc --noEmit"

package/src/api/server.ts

@@ -814,6 +814,9 @@ export async function startServer(options?: {
       await import("../core/account-concurrency.ts");
     startLeaseSweepTimer();
 
+    const { scheduleStartupChatCleanup } =
+      await import("../services/chat-cleanup.ts");
+    scheduleStartupChatCleanup();
     const serverInstance = serve({
       fetch: app.fetch,
       port: config.server.port,

package/src/core/config.ts

@@ -161,7 +161,9 @@ const envSchema = z
     CONTEXT_METER_WINDOW_TOKENS: z.string().default("0"),
     CONTEXT_METER_REPORT_USAGE: z.string().default("true"),
     DELETE_ALL_CHATS_ON_SHUTDOWN: z.string().default("false"),
-    // Keep idle account pages alive (subtlePageActivity + occasional reload).
+    AUTO_CLEAN_CHATS_ON_STARTUP: z.string().default("true"),
+    AUTO_CLEAN_ORPHAN_CHATS: z.string().default("true"),
+    AUTO_CLEAN_CHAT_MAX_AGE_HOURS: z.string().default("24"),
     // The Baxia WAF scores live page behavior (pointer/scroll events, open
     // session) — an account whose page sits frozen for minutes returns a low
     // trust score and gets TMD-challenged on the next request. On by default;
@@ -367,7 +369,12 @@ export const config = {
       parseInt(env.QWEN_MAX_PERSONALIZATION_BYTES),
     ),
     deleteAllChatsOnShutdown: env.DELETE_ALL_CHATS_ON_SHUTDOWN === "true",
-    /** Send the captured bx-ua/bx-umidtoken headers (real client does NOT). */
+    autoCleanChatsOnStartup: env.AUTO_CLEAN_CHATS_ON_STARTUP !== "false",
+    autoCleanOrphanChats: env.AUTO_CLEAN_ORPHAN_CHATS !== "false",
+    autoCleanChatMaxAgeHours: Math.max(
+      1,
+      parseInt(env.AUTO_CLEAN_CHAT_MAX_AGE_HOURS) || 24,
+    ),
     sendBxUa: env.QWEN_SEND_BX_UA === "true",
     /** Deployed web bundle version sent as the `version` API header. */
     webVersion: env.QWEN_WEB_VERSION,

package/src/routes/chat/account.ts

@@ -36,6 +36,7 @@ import {
 } from "../../core/account-concurrency.ts";
 import { isAuthMockEnabled } from "../../services/auth-playwright.ts";
 import { isPlaywrightInitialized, refreshHeaders } from "../../services/playwright.ts";
+import { enqueueOrphanChatDeletion } from "../../services/chat-cleanup.ts";
 import {
 	clearAllSessionsForAccount,
 	createQwenStream,
@@ -1720,12 +1721,15 @@ async function tryCreateStreamWithRetry(
 				// Do NOT persist sticky binding until create succeeds — premature empty
 				// chatSessionId writes make subsequent turns rotate/lose context.
 				if (params.useThreadNative) {
+					const abandonedChatId = params.existingThread?.chatSessionId;
+					if (abandonedChatId) {
+						enqueueOrphanChatDeletion(currentAccountId, abandonedChatId, policy.reason);
+					}
 					params.existingThread = null;
 					params.finalPrompt = params.fullPrompt;
 					params.messageCount = params.fullMessageCount ?? params.messageCount;
 					params.forceNewChat = true;
 				}
-
 				await new Promise((resolve) =>
 					setTimeout(
 						resolve,
@@ -1749,12 +1753,15 @@ async function tryCreateStreamWithRetry(
 			console.warn(
 				`🔄 [Chat] Forcing new chat/full context | reason=${policy.reason}`,
 			);
+			const abandonedChatId = params.existingThread?.chatSessionId;
+			if (abandonedChatId) {
+				enqueueOrphanChatDeletion(currentAccountId, abandonedChatId, policy.reason);
+			}
 			params.existingThread = null;
 			params.finalPrompt = params.fullPrompt;
 			params.messageCount = params.fullMessageCount ?? params.messageCount;
 			params.forceNewChat = true;
 		}
-
 		// Drop files on retry for invalid_input to isolate file-related errors
 		if (policy.dropFiles && params.allFiles.length > 0) {
 			console.warn(

package/src/services/chat-cleanup.ts

@@ -3,14 +3,24 @@ import {
   loadAccounts,
   type QwenAccount,
 } from "../core/accounts.ts";
-import { deleteAllQwenChats } from "./qwen.ts";
+import {
+  deleteAllQwenChats,
+  deleteSingleQwenChat,
+  fetchRemoteQwenChats,
+} from "./qwen.ts";
 import {
   initPlaywrightForAccount,
   isPlaywrightInitialized,
   closeAllPlaywright,
+  getActivePlaywrightAccountIds,
 } from "./playwright.ts";
 import { isAuthMockEnabled } from "./auth-playwright.ts";
-import { maskEmail } from "../core/logger.ts";
+import { maskEmail, logger } from "../core/logger.ts";
+import { config } from "../core/config.ts";
+import { isAccountBusy } from "../core/account-concurrency.ts";
+import { isChatSessionActive } from "./qwen-thread-state.ts";
+import { sleep } from "./human-behavior.ts";
+
 export interface DeleteChatsResult {
   attempted: number;
   succeeded: number;
@@ -109,10 +119,169 @@ export async function deleteChatsForConfiguredAccounts(keepBrowserOpen = false):
       });
     }
   }
-
   return {
     attempted: accounts.length,
     succeeded,
     mode: "accounts",
   };
 }
+
+interface OrphanChatEntry {
+  accountId: string;
+  chatId: string;
+  reason: string;
+  enqueuedAt: number;
+}
+
+const orphanChatQueue: OrphanChatEntry[] = [];
+let isProcessingQueue = false;
+
+export function getOrphanQueueLengthForTests(): number {
+  return orphanChatQueue.length;
+}
+
+/**
+ * Enqueues an abandoned/orphan chat for asynchronous deletion in background.
+ * Never blocks the calling request and never deletes a chat actively in use.
+ */
+export function enqueueOrphanChatDeletion(
+  accountId: string,
+  chatId: string,
+  reason = "orphan",
+): void {
+  if (!config.qwen.autoCleanOrphanChats || !accountId || !chatId) return;
+  if (orphanChatQueue.some((e) => e.accountId === accountId && e.chatId === chatId)) {
+    return;
+  }
+  orphanChatQueue.push({
+    accountId,
+    chatId,
+    reason,
+    enqueuedAt: Date.now(),
+  });
+
+  if (!isProcessingQueue) {
+    const timer = setTimeout(() => {
+      void processOrphanChatQueue().catch(() => {});
+    }, 1_000);
+    timer.unref?.();
+  }
+}
+
+async function processOrphanChatQueue(): Promise<void> {
+  if (isProcessingQueue) return;
+  isProcessingQueue = true;
+  try {
+    while (orphanChatQueue.length > 0) {
+      const entry = orphanChatQueue[0];
+
+      // Never delete a chat that is currently actively bound to an ongoing session
+      if (isChatSessionActive(entry.chatId)) {
+        orphanChatQueue.shift();
+        continue;
+      }
+
+      // If the account is actively serving a stream, postpone deletion
+      if (!isAuthMockEnabled() && isAccountBusy(entry.accountId)) {
+        await sleep(2_000);
+        continue;
+      }
+
+      try {
+        const ok = await deleteSingleQwenChat(entry.accountId, entry.chatId);
+        if (ok) {
+          logger.debug("[ChatCleanup] Deleted orphan chat", {
+            accountId: entry.accountId,
+            chatId: entry.chatId,
+            reason: entry.reason,
+          });
+        }
+      } catch (err) {
+        logger.debug("[ChatCleanup] Failed to delete orphan chat", {
+          accountId: entry.accountId,
+          chatId: entry.chatId,
+          error: err instanceof Error ? err.message : String(err),
+        });
+      }
+
+      orphanChatQueue.shift();
+      if (orphanChatQueue.length > 0) {
+        await sleep(300);
+      }
+    }
+  } finally {
+    isProcessingQueue = false;
+  }
+}
+
+export async function drainOrphanChatQueueForTests(): Promise<void> {
+  await processOrphanChatQueue();
+}
+
+/**
+ * Scan an account's remote chat list and delete chats older than maxAgeHours,
+ * skipping any chat that is currently actively bound to a session.
+ */
+export async function cleanOldChatsForAccount(
+  accountId: string,
+  maxAgeHours = config.qwen.autoCleanChatMaxAgeHours,
+): Promise<number> {
+  try {
+    const chats = await fetchRemoteQwenChats(accountId);
+    if (!Array.isArray(chats) || chats.length === 0) return 0;
+
+    const maxAgeMs = maxAgeHours * 60 * 60 * 1000;
+    const now = Date.now();
+    let cleaned = 0;
+
+    for (const chat of chats) {
+      if (!chat?.id) continue;
+      if (isChatSessionActive(chat.id)) continue;
+
+      const updatedMs =
+        typeof chat.updated_at === "number"
+          ? (chat.updated_at > 1e11 ? chat.updated_at : chat.updated_at * 1000)
+          : new Date(chat.updated_at).getTime();
+
+      if (now - updatedMs >= maxAgeMs) {
+        const ok = await deleteSingleQwenChat(accountId, chat.id);
+        if (ok) {
+          cleaned++;
+          await sleep(300);
+        }
+      }
+    }
+
+    if (cleaned > 0) {
+      console.log(
+        `🧹 [ChatCleanup] Remotely cleaned ${cleaned} old chat(s) (> ${maxAgeHours}h) for account ${accountId}`,
+      );
+    }
+    return cleaned;
+  } catch (error) {
+    logger.debug("[ChatCleanup] cleanOldChatsForAccount error", {
+      accountId,
+      error: error instanceof Error ? error.message : String(error),
+    });
+    return 0;
+  }
+}
+
+/**
+ * Startup hook: runs 15s after startup in the background, cleaning old chats
+ * for active accounts without holding up the server or user requests.
+ */
+export function scheduleStartupChatCleanup(): void {
+  if (!config.qwen.autoCleanChatsOnStartup || isAuthMockEnabled()) return;
+
+  const timer = setTimeout(async () => {
+    try {
+      const activeIds = getActivePlaywrightAccountIds();
+      for (const accountId of activeIds) {
+        await cleanOldChatsForAccount(accountId);
+        await sleep(1_000);
+      }
+    } catch {}
+  }, 15_000);
+  timer.unref?.();
+}

package/src/services/qwen-thread-state.ts

@@ -376,6 +376,43 @@ export function clearAllSessionsForAccount(accountId: string): void {
   );
 }
 
+/**
+ * Returns true if a chatSessionId is currently actively bound to any non-expired session.
+ * Prevents auto-cleanup routines from deleting conversations currently in use.
+ */
+export function isChatSessionActive(chatId: string): boolean {
+  if (!chatId) return false;
+  const now = Date.now();
+  for (const entry of logicalThreadStates.values()) {
+    if (entry.chatSessionId === chatId && now - entry.timestamp <= SESSION_TTL_MS) {
+      return true;
+    }
+  }
+  const sessionEntry = sessionStates.get(chatId);
+  if (sessionEntry && now - sessionEntry.timestamp <= SESSION_TTL_MS) {
+    return true;
+  }
+  return false;
+}
+
+/**
+ * Invalidate and remove all local cached/database records for a given chatId.
+ */
+export function removeSessionByChatId(chatId: string): void {
+  if (!chatId) return;
+  sessionStates.delete(chatId);
+  for (const [key, entry] of logicalThreadStates.entries()) {
+    if (entry.chatSessionId === chatId) {
+      logicalThreadStates.delete(key);
+      logicalThreadDirty.delete(key);
+    }
+  }
+  try {
+    const db = getDatabase();
+    db.prepare("DELETE FROM logical_thread_states WHERE chat_session_id = ?").run(chatId);
+  } catch {}
+}
+
 export function getSessionParent(
   sessionId: string,
   accountId?: string,

package/src/services/qwen.ts

@@ -53,6 +53,8 @@ export {
   updateSessionParent,
   invalidateLogicalThreadParent,
   clearAllSessionsForAccount,
+  removeSessionByChatId,
+  isChatSessionActive,
   getSessionParent,
 } from "./qwen-thread-state.ts";
 export type { LogicalThreadEntry } from "./qwen-thread-state.ts";
@@ -74,6 +76,8 @@ import {
 } from "./qwen-errors.ts";
 import {
   clearAllSessionsForAccount,
+  removeSessionByChatId,
+  isChatSessionActive,
   getSessionParent,
   updateSessionParent,
 } from "./qwen-thread-state.ts";
@@ -1977,6 +1981,112 @@ export async function deleteAllQwenChats(accountId?: string): Promise<boolean> {
   return true;
 }
 
+export interface RemoteQwenChat {
+  id: string;
+  title: string;
+  updated_at: number | string;
+  created_at: number | string;
+}
+
+/**
+ * Deletes a single chat session by ID on Qwen Web.
+ */
+export async function deleteSingleQwenChat(
+  accountId: string | undefined,
+  chatId: string,
+): Promise<boolean> {
+  if (!chatId) return false;
+
+  if (isAuthMockEnabled()) {
+    const url = qwenUrl(`/api/v2/chats/${encodeURIComponent(chatId)}`);
+    const response = await fetch(url, {
+      method: "DELETE",
+    });
+    removeSessionByChatId(chatId);
+    return response.ok;
+  }
+
+  const requestHeaders: Record<string, string> = {
+    source: "web",
+    version: "0.2.89",
+    timezone: new Date().toString().split(" (")[0],
+    "x-request-id": crypto.randomUUID(),
+    Referer: qwenUrl(`/c/${encodeURIComponent(chatId)}`),
+  };
+
+  try {
+    const response = await requestQwenTextInBrowser(
+      accountId,
+      "DELETE",
+      `/api/v2/chats/${encodeURIComponent(chatId)}`,
+      requestHeaders,
+      undefined,
+      { referrer: qwenUrl(`/c/${encodeURIComponent(chatId)}`), noMutexRecovery: true },
+    );
+
+    const { json: parsed } = await readJsonTextResponse(response, {
+      strict: false,
+    });
+
+    const success = response.ok && parsed?.success === true && parsed?.data?.status === true;
+    if (success) {
+      removeSessionByChatId(chatId);
+    }
+    return success;
+  } catch (error) {
+    logger.debug("[Qwen] deleteSingleQwenChat failed", {
+      accountId,
+      chatId,
+      error: error instanceof Error ? error.message : String(error),
+    });
+    return false;
+  }
+}
+
+/**
+ * Fetch remote chat list from Qwen Web.
+ */
+export async function fetchRemoteQwenChats(
+  accountId?: string,
+): Promise<RemoteQwenChat[]> {
+  if (isAuthMockEnabled()) {
+    try {
+      const response = await fetch(qwenUrl("/api/v2/chats/?page=1&exclude_project=true"));
+      const json: any = await response.json().catch(() => null);
+      if (json?.success && Array.isArray(json.data)) {
+        return json.data;
+      }
+    } catch {}
+    return [];
+  }
+
+  const requestHeaders: Record<string, string> = {
+    version: "0.2.89",
+    timezone: new Date().toString().split(" (")[0],
+    "x-request-id": crypto.randomUUID(),
+    Referer: qwenUrl("/settings/chats"),
+  };
+
+  try {
+    const response = await requestQwenTextInBrowser(
+      accountId,
+      "GET",
+      "/api/v2/chats/?page=1&exclude_project=true",
+      requestHeaders,
+      undefined,
+      { referrer: qwenUrl("/settings/chats"), noMutexRecovery: true },
+    );
+    if (!response.ok) return [];
+    const json: any = await response.json().catch(() => null);
+    if (json?.success && Array.isArray(json.data)) {
+      return json.data;
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
+
 export async function fetchQwenModels(
   accountId?: string,
 ): Promise<PublicQwenModel[]> {