@sideboard-ai/core 0.1.208 → 0.1.210

package/dist/{chunk-C5MNMITQ.js → chunk-AOQZZA3M.js}

@@ -8,9 +8,7 @@ import {
   adjustBrightsyTurnExit,
   allAdapters,
   applyAgentEvent,
-  applyTurnUsage,
   clipAgentEventForPaint,
-  contextTokens,
   finalizeParts,
   getAdapter,
   isBrightsyNdjsonLine,
@@ -25,9 +23,8 @@ import {
   partsToAssistantText,
   resolveQuotaFallbackAgent,
   stripBrightsyNdjsonNoise,
-  sumUsageList,
   toolDescription
-} from "./chunk-A6SOSLUV.js";
+} from "./chunk-YYELAUKP.js";
 import {
   SLACK_REPLY_FORMATTING,
   addWorkspace,
@@ -50,7 +47,7 @@ import {
   stageAbsolutePathsAsAttachments,
   stageBuffersAsAttachments,
   syncWorkspacesFromThreads
-} from "./chunk-HA4EZKFY.js";
+} from "./chunk-3S2LDD2F.js";
 import {
   addPrStackLayer,
   allocateTeamName,
@@ -100,7 +97,7 @@ import {
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath,
   worktreeSlugForTicket
-} from "./chunk-OP6CFVTB.js";
+} from "./chunk-ZZNZX2QW.js";
 import {
   ATTACHMENTS_DIR,
   DETACHED_JOBS_DIR,
@@ -134,19 +131,28 @@ import {
   turnFailChatText
 } from "./chunk-JZHRZ3DR.js";
 import {
+  HISTORY_CLEANUP_INTERVAL_HOURS_DEFAULT,
+  applyTurnUsage,
   assertOrchestratorCapableAgent,
+  autoCleanupHistoryEnabled,
   childEnvWithAppSettings,
   coerceOrchestratorAgent,
+  contextTokens,
   followUpBehavior,
   formatViewerContextDirective,
   formatViewerContextReminder,
   getIssueSource,
+  historyMaxCount,
+  historyMaxDays,
+  historyRetentionStubMessage,
   isAbleTimeConnected,
   isLinearConnected,
   isOrchestratorCapableAgent,
   isSecureFileEncrypted,
   loadAppSettings,
   orchestrationQuotaFallbackAgent,
+  planHistoryAgePurge,
+  planHistoryRetention,
   readSecureJson,
   resolveEffectiveIssueSource,
   resolveNewThreadOptions,
@@ -154,10 +160,11 @@ import {
   resolveVaultKey,
   resolveViewerProfileForRepo,
   saveAppSettings,
+  sumUsageList,
   updateAdvancedSettings,
   usageOnLimit,
   writeSecureJson
-} from "./chunk-Y4CF7LHH.js";
+} from "./chunk-L5CIEBLR.js";
 import {
   stripNestedElectronEnv
 } from "./chunk-4TR3HZFT.js";
@@ -182,7 +189,7 @@ import {
   updateThread,
   withThreadLock,
   writeThread
-} from "./chunk-7DKX5JLT.js";
+} from "./chunk-FGTPRMPS.js";
 import {
   appDataDir,
   findConventionSetup,
@@ -476,7 +483,7 @@ async function continueSourceThread(threadId, prompt) {
       await continueOnReply(threadId, prompt);
       return;
     }
-    const { getOrchestrator: getOrchestrator2 } = await import("./orchestrator-D4AQNF25.js");
+    const { getOrchestrator: getOrchestrator2 } = await import("./orchestrator-ZBUXJCII.js");
     await getOrchestrator2().send(threadId, prompt);
   } catch {
   }
@@ -810,9 +817,9 @@ async function spawnAgentTurn(thread, input, onEvent) {
       `Cannot spawn ${thread.agent}: thread ${thread.id} has no worktreePath`
     );
   }
-  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-5UUUNA4A.js");
+  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-LQZLTGFL.js");
   if (isGlobalThread2(thread)) {
-    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-WOTJQMD5.js");
+    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-GCITY3Q5.js");
     ensureGlobalCoordinatorCwd2(
       isOrchestratorThread(thread) ? { orchestratorThreadId: thread.id } : void 0
     );
@@ -2592,6 +2599,69 @@ function worktreeCleanupSettings() {
   };
 }
 
+// src/store/history-cleanup.ts
+function stripArchivedTranscript(thread) {
+  writeThread(
+    {
+      ...thread,
+      attachments: [],
+      pendingTurnAttachments: [],
+      messages: [historyRetentionStubMessage(thread)]
+    },
+    { touch: false }
+  );
+}
+function cleanupArchivedHistory(opts = {}) {
+  const settings = loadAppSettings();
+  if (!opts.force && opts.purgeOlderThanDays == null && !autoCleanupHistoryEnabled(settings)) {
+    return { stripped: [], purged: [] };
+  }
+  const archived = listThreads({ includeArchived: true }).filter((t) => t.status === "archived");
+  const nowMs = opts.nowMs ?? Date.now();
+  const plan = opts.purgeOlderThanDays != null ? { stripIds: [], purgeIds: planHistoryAgePurge(archived, opts.purgeOlderThanDays, nowMs) } : planHistoryRetention(archived, {
+    maxCount: opts.maxCount ?? historyMaxCount(settings),
+    maxDays: opts.maxDays ?? historyMaxDays(settings),
+    nowMs
+  });
+  const stripped = [];
+  const purged = [];
+  if (opts.dryRun) {
+    return { stripped: plan.stripIds, purged: plan.purgeIds };
+  }
+  for (const id of plan.stripIds) {
+    const thread = readThread(id);
+    if (!thread || thread.status !== "archived") continue;
+    try {
+      stripArchivedTranscript(thread);
+      stripped.push(id);
+    } catch {
+    }
+  }
+  for (const id of plan.purgeIds) {
+    const thread = readThread(id);
+    if (!thread || thread.status !== "archived") continue;
+    try {
+      deleteThreadRecord(id);
+      purged.push(id);
+    } catch {
+    }
+  }
+  if (stripped.length > 0 || purged.length > 0) {
+    updateAdvancedSettings({
+      historyLastCleanupAt: new Date(nowMs).toISOString()
+    });
+  }
+  return { stripped, purged };
+}
+function shouldRunHistoryCleanup(settings = loadAppSettings()) {
+  if (!autoCleanupHistoryEnabled(settings)) return false;
+  const intervalHours = settings.advanced.historyCleanupIntervalHours ?? HISTORY_CLEANUP_INTERVAL_HOURS_DEFAULT;
+  const last = settings.advanced.historyLastCleanupAt;
+  if (!last) return true;
+  const elapsed = Date.now() - Date.parse(last);
+  return Number.isFinite(elapsed) && elapsed >= intervalHours * 36e5;
+}
+
 // src/git/apply-into-main.ts
 import { execa as execa3 } from "execa";
 async function applyThreadIntoMain(thread, opts) {
@@ -3808,7 +3878,7 @@ async function createThread(input, _onSetupLine) {
   });
   await requireAgent(resolved.agent);
   if (input.cowboy) {
-    const { cowboyModeEnabled } = await import("./app-settings-GJ6KDYEF.js");
+    const { cowboyModeEnabled } = await import("./app-settings-2TN3WLZV.js");
     if (!cowboyModeEnabled()) {
       throw new Error(
         "Cowboy mode is off. Enable it in Settings \u2192 Advanced."
@@ -3866,7 +3936,7 @@ async function createThread(input, _onSetupLine) {
   let sourceIsFork = false;
   if (!input.cowboy && sourceType === "branch" && (!sourceRef || sourceRef === "HEAD" || sourceRef === "default")) {
     if (isAbleTimeConnected() && getIssueSource() === "abletime") {
-      const { ensureAbleTimeTask, issueAttachmentForAbleTimeTask } = await import("./abletime-I4IYZBKU.js");
+      const { ensureAbleTimeTask, issueAttachmentForAbleTimeTask } = await import("./abletime-GDZLZRMY.js");
       const task = await ensureAbleTimeTask({
         title: title?.trim() || "Untitled work",
         description: input.prompt?.trim() || void 0
@@ -3968,7 +4038,7 @@ async function createThread(input, _onSetupLine) {
   return readThread(thread.id) ?? thread;
 }
 async function listLinearIssues(agent, repoPath) {
-  const { getAdapter: getAdapter2 } = await import("./agents-CCS5IEBV.js");
+  const { getAdapter: getAdapter2 } = await import("./agents-IQZUN47D.js");
   await requireAgent(agent, { requireLinear: true });
   const adapter = getAdapter2(agent);
   if (!adapter.listLinearIssues) {
@@ -4414,7 +4484,7 @@ async function adoptThread(input) {
     messages: input.messages ?? []
   });
   writeThread(thread);
-  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-PZ36M7EQ.js");
+  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-2XW2DMRG.js");
   await ensureWorkspace2(repoPath);
   const { ensureWorktreeSideboardIgnored: ensureWorktreeSideboardIgnored2 } = await import("./worktree-exclude-X54WSOXM.js");
   await ensureWorktreeSideboardIgnored2(input.worktreePath);
@@ -7020,7 +7090,7 @@ function formatScheduledPrompt(name, prompt) {
 ${prompt}`;
 }
 async function defaultDeps() {
-  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-D4AQNF25.js");
+  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-ZBUXJCII.js");
   const orch = getOrchestrator2();
   return {
     findThread: (id) => findThreadByRef(id),
@@ -7290,12 +7360,18 @@ var Orchestrator = class {
           orphans: orphans.map((o) => ({ path: o.path, repoPath: o.repoPath }))
         });
       }
-      const { autoCleanupOrphansEnabled } = await import("./app-settings-GJ6KDYEF.js");
+      const { autoCleanupOrphansEnabled } = await import("./app-settings-2TN3WLZV.js");
       if (autoCleanupOrphansEnabled() && shouldRunWorktreeCleanup() && orphans.length > 0) {
         await cleanupOrphanWorktrees({ repoPaths });
       }
     } catch {
     }
+    try {
+      if (shouldRunHistoryCleanup()) {
+        cleanupArchivedHistory();
+      }
+    } catch {
+    }
     if (drainQueues) {
       this.adoptPersistedQueues();
     }
@@ -7582,7 +7658,7 @@ var Orchestrator = class {
     }
     await setup;
     if (skipSetup) return;
-    const { autoRunAfterSetupEnabled } = await import("./app-settings-GJ6KDYEF.js");
+    const { autoRunAfterSetupEnabled } = await import("./app-settings-2TN3WLZV.js");
     if (autoRunAfterSetupEnabled()) {
       try {
         await this.startDev(threadId);
@@ -7912,7 +7988,7 @@ var Orchestrator = class {
     }
     const isBrightsy = fresh.agent === "brightsy";
     const isOrchestration = isOrchestratorThread(fresh);
-    const { autoRenameBranchEnabled, getGithubGitAuthMode, gitBranchPrefixSetting } = await import("./app-settings-GJ6KDYEF.js");
+    const { autoRenameBranchEnabled, getGithubGitAuthMode, gitBranchPrefixSetting } = await import("./app-settings-2TN3WLZV.js");
     const gitAuthMode = getGithubGitAuthMode();
     const worktreeDirective = isBrightsy || isOrchestration ? null : formatWorktreeDirective(fresh, {
       githubSlug: await resolveGithubRepoSlug(fresh.worktreePath).catch(
@@ -8624,6 +8700,20 @@ var Orchestrator = class {
       repoPaths
     });
   }
+  /** Bound Settings → History. After archive always; reconcile is interval-gated. */
+  enforceHistoryRetention() {
+    try {
+      cleanupArchivedHistory();
+    } catch {
+    }
+  }
+  cleanupHistory(opts) {
+    return cleanupArchivedHistory({
+      dryRun: opts?.dryRun,
+      purgeOlderThanDays: opts?.purgeOlderThanDays,
+      force: opts?.force
+    });
+  }
   /**
    * Best-of-n / fanout: create N threads (one per agent) with the same prompt.
    */
@@ -8930,7 +9020,7 @@ var Orchestrator = class {
     if (!titled.userSetTitle && meta.title && titled.title !== meta.title) {
       updateThread(thread.id, { title: meta.title });
     }
-    const { autoArchiveOnMergeEnabled } = await import("./app-settings-GJ6KDYEF.js");
+    const { autoArchiveOnMergeEnabled } = await import("./app-settings-2TN3WLZV.js");
     const latest = this.requireThread(thread.id);
     if (!shouldAutoArchiveOnPrMerge({
       previousPrState: prevState || null,
@@ -9184,6 +9274,7 @@ var Orchestrator = class {
     if (isGlobalThread(thread)) {
       const archived2 = setStatus(thread.id, "archived");
       this.emit({ type: "status_changed", threadId: archived2.id, status: "archived" });
+      this.enforceHistoryRetention();
       return archived2;
     }
     const siblings = threadsSharingWorktree(thread.worktreePath).filter((t) => t.id !== thread.id);
@@ -9205,9 +9296,10 @@ var Orchestrator = class {
     }
     const archived = setStatus(thread.id, "archived");
     this.emit({ type: "status_changed", threadId: archived.id, status: "archived" });
+    this.enforceHistoryRetention();
     if (thread.repoPath && !isGlobalRepoPath(thread.repoPath)) {
       try {
-        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-PZ36M7EQ.js");
+        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-2XW2DMRG.js");
         await ensureWorkspace2(thread.repoPath);
       } catch {
       }
@@ -9234,7 +9326,7 @@ var Orchestrator = class {
           await runArchiveScript(thread.repoPath, thread.worktreePath);
         } catch {
         }
-        const { deleteBranchOnPurgeEnabled } = await import("./app-settings-GJ6KDYEF.js");
+        const { deleteBranchOnPurgeEnabled } = await import("./app-settings-2TN3WLZV.js");
         const deleteBranch = opts?.deleteBranch ?? deleteBranchOnPurgeEnabled();
         await removeWorktree(thread.repoPath, thread.worktreePath, {
           deleteBranch: deleteBranch ? thread.branchName : void 0
@@ -9261,7 +9353,7 @@ var Orchestrator = class {
           `Cowboy checkout missing: ${thread.worktreePath}. Re-add the project folder, then restore.`
         );
       }
-      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-NC4XQNQI.js");
+      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-5ZGWKKZ6.js");
       const slug = thread.worktreePath.split("/").pop();
       const dest = thread.worktreePath;
       await withRepoGitLock(thread.repoPath, async () => {
@@ -9371,7 +9463,7 @@ async function startOrchestration(opts) {
     sourceRef: "default",
     ...createOpts
   }).catch(async () => {
-    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-NC4XQNQI.js");
+    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-5ZGWKKZ6.js");
     const repo = await resolveRepoRoot2(repoPath);
     const def = await resolveDefaultBranch2(repo);
     return orch.createThread({
@@ -9381,7 +9473,7 @@ async function startOrchestration(opts) {
       repoPath: repo
     });
   });
-  const { updateThread: upd } = await import("./thread-store-ESZYZSVC.js");
+  const { updateThread: upd } = await import("./thread-store-KMZRQEPY.js");
   const updated = upd(thread.id, {
     sourceType: "orchestration",
     sourceRef: goal
@@ -9540,6 +9632,8 @@ export {
   cleanupOrphanWorktrees,
   shouldRunWorktreeCleanup,
   worktreeCleanupSettings,
+  cleanupArchivedHistory,
+  shouldRunHistoryCleanup,
   applyThreadIntoMain,
   cloneRepoIntoSideboard,
   mcpWaitForTurnTimeoutMs,

package/dist/{chunk-4EGK47WV.js → chunk-BTC2D6LS.js}

@@ -383,6 +383,167 @@ function normalizeVault(raw) {
   return out;
 }
 
+// src/agents/usage.ts
+function sumOptional(a, b) {
+  if (a == null && b == null) return void 0;
+  return (a ?? 0) + (b ?? 0);
+}
+function fromInclusiveInputUsage(opts) {
+  const totalInput = Number(opts.inputTokens) || 0;
+  const outputTokens = Number(opts.outputTokens) || 0;
+  const cached = Number(opts.cachedInputTokens) || 0;
+  if (!totalInput && !outputTokens) return null;
+  const cacheReadTokens = cached > 0 ? Math.min(cached, totalInput) : 0;
+  return {
+    inputTokens: Math.max(0, totalInput - cacheReadTokens),
+    outputTokens,
+    cacheReadTokens: cacheReadTokens || void 0
+  };
+}
+function requestOccupancy(u) {
+  return u.inputTokens + (u.cacheReadTokens ?? 0) + (u.cacheWriteTokens ?? 0);
+}
+function mergeUsage(a, b) {
+  return {
+    inputTokens: (a?.inputTokens ?? 0) + b.inputTokens,
+    outputTokens: (a?.outputTokens ?? 0) + b.outputTokens,
+    cacheReadTokens: sumOptional(a?.cacheReadTokens, b.cacheReadTokens),
+    cacheWriteTokens: sumOptional(a?.cacheWriteTokens, b.cacheWriteTokens),
+    costUsd: sumOptional(a?.costUsd, b.costUsd),
+    lastRequestTokens: b.lastRequestTokens ?? a?.lastRequestTokens
+  };
+}
+function sumUsageList(list) {
+  let acc = null;
+  for (const u of list) {
+    if (!u) continue;
+    acc = mergeUsage(acc, {
+      inputTokens: u.inputTokens,
+      outputTokens: u.outputTokens,
+      cacheReadTokens: u.cacheReadTokens,
+      cacheWriteTokens: u.cacheWriteTokens,
+      costUsd: u.costUsd
+    });
+  }
+  if (!acc) return null;
+  return {
+    inputTokens: acc.inputTokens,
+    outputTokens: acc.outputTokens,
+    ...acc.cacheReadTokens != null ? { cacheReadTokens: acc.cacheReadTokens } : {},
+    ...acc.cacheWriteTokens != null ? { cacheWriteTokens: acc.cacheWriteTokens } : {},
+    ...acc.costUsd != null ? { costUsd: acc.costUsd } : {}
+  };
+}
+function hasBilledTokens(u) {
+  return Boolean(
+    u.inputTokens || u.outputTokens || u.cacheReadTokens || u.cacheWriteTokens
+  );
+}
+function applyTurnUsage(current, incoming, scope = "request") {
+  if (scope === "turn") {
+    if (!hasBilledTokens(incoming) && current && incoming.costUsd != null) {
+      return { ...current, costUsd: incoming.costUsd };
+    }
+    return {
+      ...incoming,
+      costUsd: incoming.costUsd ?? current?.costUsd,
+      lastRequestTokens: current?.lastRequestTokens ?? requestOccupancy(incoming)
+    };
+  }
+  const merged = mergeUsage(current, incoming);
+  const occ = incoming.lastRequestTokens != null && incoming.lastRequestTokens > 0 ? incoming.lastRequestTokens : requestOccupancy(incoming);
+  return {
+    ...merged,
+    lastRequestTokens: occ > 0 ? occ : current?.lastRequestTokens ?? occ
+  };
+}
+function contextTokens(u) {
+  if (u.lastRequestTokens != null && u.lastRequestTokens > 0) return u.lastRequestTokens;
+  return requestOccupancy(u);
+}
+
+// src/store/history-retention.ts
+var HISTORY_MAX_COUNT_DEFAULT = 200;
+var HISTORY_MAX_COUNT_MIN = 1;
+var HISTORY_MAX_COUNT_MAX = 2e3;
+var HISTORY_MAX_DAYS_DEFAULT = 0;
+var HISTORY_MAX_DAYS_MAX = 3650;
+var HISTORY_CLEANUP_INTERVAL_HOURS_DEFAULT = 6;
+var HISTORY_DISCARDED_TEXT = "Transcript discarded by History retention.";
+function clampHistoryMaxCount(value) {
+  return Math.max(HISTORY_MAX_COUNT_MIN, Math.min(HISTORY_MAX_COUNT_MAX, Math.floor(value)));
+}
+function clampHistoryMaxDays(value) {
+  if (!Number.isFinite(value) || value <= 0) return 0;
+  return Math.min(HISTORY_MAX_DAYS_MAX, Math.floor(value));
+}
+function archivedUpdatedMs(thread) {
+  const stamped = thread.archivedAt ? Date.parse(thread.archivedAt) : NaN;
+  if (Number.isFinite(stamped)) return stamped;
+  const updated = Date.parse(thread.updatedAt);
+  if (Number.isFinite(updated)) return updated;
+  const created = Date.parse(thread.createdAt);
+  return Number.isFinite(created) ? created : 0;
+}
+function isHistoryRetentionStub(thread) {
+  if ((thread.attachments?.length ?? 0) > 0) return false;
+  const messages = thread.messages ?? [];
+  if (messages.length === 0) return true;
+  if (messages.length > 1) return false;
+  const only = messages[0];
+  if (only.parts?.length) return false;
+  if ((only.attachments?.length ?? 0) > 0) return false;
+  const text = (only.text ?? "").trim();
+  return text === "" || text === HISTORY_DISCARDED_TEXT;
+}
+function historyRetentionStubMessage(thread) {
+  const usage = sumUsageList((thread.messages ?? []).map((m) => m.usage));
+  return {
+    role: "summary",
+    text: HISTORY_DISCARDED_TEXT,
+    ts: thread.updatedAt,
+    ...usage ? { usage } : {}
+  };
+}
+function sortArchivedOldestFirst(threads) {
+  return [...threads].sort((a, b) => archivedUpdatedMs(a) - archivedUpdatedMs(b));
+}
+function planHistoryRetention(archived, thresholds = {}) {
+  const maxCount = clampHistoryMaxCount(thresholds.maxCount ?? HISTORY_MAX_COUNT_DEFAULT);
+  const maxDays = clampHistoryMaxDays(thresholds.maxDays ?? HISTORY_MAX_DAYS_DEFAULT);
+  const nowMs = thresholds.nowMs ?? Date.now();
+  const oldestFirst = sortArchivedOldestFirst(archived);
+  const expiredIds = /* @__PURE__ */ new Set();
+  if (maxDays > 0) {
+    const cutoff = nowMs - maxDays * 864e5;
+    for (const thread of oldestFirst) {
+      if (archivedUpdatedMs(thread) < cutoff) expiredIds.add(thread.id);
+    }
+  }
+  const remaining = oldestFirst.filter((t) => !expiredIds.has(t.id));
+  const overflow = remaining.length > maxCount ? remaining.slice(0, remaining.length - maxCount) : [];
+  const stripIds = [];
+  const purgeIds = [...expiredIds];
+  const seenPurge = new Set(purgeIds);
+  for (const thread of overflow) {
+    if (isHistoryRetentionStub(thread)) {
+      if (!seenPurge.has(thread.id)) {
+        seenPurge.add(thread.id);
+        purgeIds.push(thread.id);
+      }
+    } else {
+      stripIds.push(thread.id);
+    }
+  }
+  return { stripIds, purgeIds };
+}
+function planHistoryAgePurge(archived, olderThanDays, nowMs = Date.now()) {
+  const days = clampHistoryMaxDays(olderThanDays);
+  if (days <= 0) return [];
+  const cutoff = nowMs - days * 864e5;
+  return sortArchivedOldestFirst(archived).filter((t) => archivedUpdatedMs(t) < cutoff).map((t) => t.id);
+}
+
 // src/store/usage-on-limit.ts
 var USAGE_ON_LIMIT_VALUES = [
   "keep_going",
@@ -843,6 +1004,24 @@ function normalizeAdvanced(raw) {
   if (typeof source.autoCleanupOrphans === "boolean") {
     out.autoCleanupOrphans = source.autoCleanupOrphans;
   }
+  if (typeof source.autoCleanupHistory === "boolean") {
+    out.autoCleanupHistory = source.autoCleanupHistory;
+  }
+  if (typeof source.historyMaxCount === "number" && Number.isFinite(source.historyMaxCount)) {
+    out.historyMaxCount = clampHistoryMaxCount(source.historyMaxCount);
+  }
+  if (typeof source.historyMaxDays === "number" && Number.isFinite(source.historyMaxDays)) {
+    out.historyMaxDays = clampHistoryMaxDays(source.historyMaxDays);
+  }
+  if (typeof source.historyCleanupIntervalHours === "number" && Number.isFinite(source.historyCleanupIntervalHours)) {
+    out.historyCleanupIntervalHours = Math.max(
+      1,
+      Math.min(168, Math.floor(source.historyCleanupIntervalHours))
+    );
+  }
+  if (typeof source.historyLastCleanupAt === "string" && source.historyLastCleanupAt.trim()) {
+    out.historyLastCleanupAt = source.historyLastCleanupAt.trim();
+  }
   if (source.orchestrationQuotaOnLimit === "switch_agent" || source.orchestrationQuotaOnLimit === "wait_reset") {
     out.orchestrationQuotaOnLimit = source.orchestrationQuotaOnLimit;
   }
@@ -1748,6 +1927,24 @@ function updateAdvancedSettings(patch) {
   if (typeof patch.autoCleanupOrphans === "boolean") {
     advanced.autoCleanupOrphans = patch.autoCleanupOrphans;
   }
+  if (typeof patch.autoCleanupHistory === "boolean") {
+    advanced.autoCleanupHistory = patch.autoCleanupHistory;
+  }
+  if (typeof patch.historyMaxCount === "number" && Number.isFinite(patch.historyMaxCount)) {
+    advanced.historyMaxCount = clampHistoryMaxCount(patch.historyMaxCount);
+  }
+  if (typeof patch.historyMaxDays === "number" && Number.isFinite(patch.historyMaxDays)) {
+    advanced.historyMaxDays = clampHistoryMaxDays(patch.historyMaxDays);
+  }
+  if (typeof patch.historyCleanupIntervalHours === "number" && Number.isFinite(patch.historyCleanupIntervalHours)) {
+    advanced.historyCleanupIntervalHours = Math.max(
+      1,
+      Math.min(168, Math.floor(patch.historyCleanupIntervalHours))
+    );
+  }
+  if (typeof patch.historyLastCleanupAt === "string") {
+    advanced.historyLastCleanupAt = patch.historyLastCleanupAt;
+  }
   if (patch.orchestrationQuotaOnLimit === "switch_agent" || patch.orchestrationQuotaOnLimit === "wait_reset") {
     advanced.orchestrationQuotaOnLimit = patch.orchestrationQuotaOnLimit;
   }
@@ -1798,6 +1995,15 @@ function autoArchiveOnMergeEnabled(settings = loadAppSettings()) {
 function autoCleanupOrphansEnabled(settings = loadAppSettings()) {
   return Boolean(settings.advanced.autoCleanupOrphans);
 }
+function autoCleanupHistoryEnabled(settings = loadAppSettings()) {
+  return settings.advanced.autoCleanupHistory !== false;
+}
+function historyMaxCount(settings = loadAppSettings()) {
+  return clampHistoryMaxCount(settings.advanced.historyMaxCount ?? HISTORY_MAX_COUNT_DEFAULT);
+}
+function historyMaxDays(settings = loadAppSettings()) {
+  return clampHistoryMaxDays(settings.advanced.historyMaxDays ?? HISTORY_MAX_DAYS_DEFAULT);
+}
 function usageOnLimit(settings = loadAppSettings()) {
   return resolveUsageOnLimit(settings.advanced);
 }
@@ -1932,6 +2138,14 @@ export {
   formatWorkspaceProfileSuffix,
   formatViewerContextDirective,
   formatViewerContextReminder,
+  fromInclusiveInputUsage,
+  sumUsageList,
+  applyTurnUsage,
+  contextTokens,
+  HISTORY_CLEANUP_INTERVAL_HOURS_DEFAULT,
+  historyRetentionStubMessage,
+  planHistoryRetention,
+  planHistoryAgePurge,
   USAGE_ON_LIMIT_VALUES,
   isUsageOnLimit,
   resolveUsageOnLimit,
@@ -2001,6 +2215,9 @@ export {
   confirmClaudeUsageOverLimitEnabled,
   autoArchiveOnMergeEnabled,
   autoCleanupOrphansEnabled,
+  autoCleanupHistoryEnabled,
+  historyMaxCount,
+  historyMaxDays,
   usageOnLimit,
   orchestrationQuotaOnLimit,
   orchestrationQuotaFallbackAgent,

package/dist/{chunk-7DKX5JLT.js → chunk-FGTPRMPS.js}

@@ -1,3 +1,6 @@
+import {
+  cursorSdkStoreDir
+} from "./chunk-7J72QJOM.js";
 import {
   normalizeThinkingEffort
 } from "./chunk-77WWLBCI.js";
@@ -13,6 +16,7 @@ import {
   existsSync,
   readFileSync,
   renameSync,
+  rmSync,
   statSync,
   unlinkSync,
   writeFileSync,
@@ -52,7 +56,8 @@ function normalizeThread(raw) {
     userSetTitle: Boolean(raw.userSetTitle),
     activeRuns: Array.isArray(raw.activeRuns) ? raw.activeRuns : [],
     quotaResumeAt: raw.quotaResumeAt ?? null,
-    quotaContinuedFromId: raw.quotaContinuedFromId ?? null
+    quotaContinuedFromId: raw.quotaContinuedFromId ?? null,
+    archivedAt: typeof raw.archivedAt === "string" && raw.archivedAt.trim() ? raw.archivedAt.trim() : void 0
   };
 }
 function createEmptyThread(partial) {
@@ -87,6 +92,7 @@ function createEmptyThread(partial) {
     pendingTurnAttachments: partial.pendingTurnAttachments ?? [],
     createdAt: ts,
     updatedAt: ts,
+    archivedAt: typeof partial.archivedAt === "string" && partial.archivedAt.trim() ? partial.archivedAt.trim() : void 0,
     title: partial.title,
     sourceType: partial.sourceType,
     sourceRef: partial.sourceRef,
@@ -159,10 +165,10 @@ function readThread(id) {
   rememberThread(thread, mtimeMs);
   return thread;
 }
-function writeThread(thread) {
+function writeThread(thread, opts) {
   const path = threadFilePath(idPath(thread.id));
   const tmp = `${path}.${process.pid}.tmp`;
-  const next = { ...thread, updatedAt: nowIso() };
+  const next = opts?.touch === false ? { ...thread } : { ...thread, updatedAt: nowIso() };
   writeFileSync(tmp, JSON.stringify(next, null, 2), "utf8");
   renameSync(tmp, path);
   rememberThread(next, fileMtimeMs(path) ?? Date.now());
@@ -207,11 +213,20 @@ function deleteThreadRecord(id) {
     } catch {
     }
   }
+  try {
+    rmSync(cursorSdkStoreDir(id), { recursive: true, force: true });
+  } catch {
+  }
 }
 function updateThread(id, patch) {
   const current = readThread(id);
   if (!current) throw new Error(`Thread not found: ${id}`);
   const next = { ...current, ...patch, id: current.id, updatedAt: nowIso() };
+  if (next.status === "archived") {
+    next.archivedAt = typeof next.archivedAt === "string" && next.archivedAt.trim() || current.archivedAt || nowIso();
+  } else {
+    delete next.archivedAt;
+  }
   writeThread(next);
   return next;
 }