feat(capsule): auto-prune to bound disk usage of capsules cache

components/legacy/constants/constants.ts

@@ -393,6 +393,25 @@ export const CFG_USE_DATED_CAPSULES = 'use_dated_capsules';
 
 export const CFG_CACHE_LOCK_ONLY_CAPSULES = 'cache_lock_only_capsules';
 
+/**
+ * Soft size limit (in GB) for the global capsules dir. When exceeded, the auto-prune trigger
+ * runs an LRU eviction of aspect-version subdirs until the cache drops below this size.
+ */
+export const CFG_CAPSULES_MAX_SIZE_GB = 'capsules_max_size_gb';
+
+/**
+ * Age threshold (in days) for aspect-version and scope capsule pruning. Capsules whose
+ * last-used marker is older than this are considered stale and removed. Workspace capsules
+ * are deleted regardless of age.
+ */
+export const CFG_CAPSULES_MAX_AGE_DAYS = 'capsules_max_age_days';
+
+/**
+ * Whether the lazy auto-prune trigger runs in the background once per ~24h.
+ * Set to "false" to disable.
+ */
+export const CFG_CAPSULES_AUTO_PRUNE = 'capsules_auto_prune';
+
 export const CFG_PROXY = 'proxy';
 export const CFG_HTTPS_PROXY = 'https_proxy';
 export const CFG_PROXY_NO_PROXY = 'proxy.no_proxy';

scopes/component/isolator/index.ts

@@ -1,6 +1,13 @@
-export { CAPSULE_READY_FILE } from './isolator.main.runtime';
+export { CAPSULE_READY_FILE, CAPSULE_ORIGIN_FILE, CAPSULE_TRASH_DIR } from './isolator.main.runtime';
 export { Network } from './network';
 export { FsContainer, Capsule, ContainerExec } from './capsule';
-export type { IsolatorMain, IsolateComponentsOptions } from './isolator.main.runtime';
+export type {
+  IsolatorMain,
+  IsolateComponentsOptions,
+  CapsuleKind,
+  CapsuleOriginMarker,
+  PruneCapsulesOptions,
+  PruneCapsulesReport,
+} from './isolator.main.runtime';
 export { IsolatorAspect } from './isolator.aspect';
 export { default as CapsuleList } from './capsule-list';