claude-use 11.19.0 → 11.20.0

package/dist/index.cjs

@@ -242,7 +242,7 @@ function isTimeZone(name) {
     return false;
   }
 }
-var import_node_path2, import_zod, import_trilean, CATEGORY_NAMES, OVERRIDABLE_CATEGORIES, CategoryMapSchema, DURATION_RE, DurationSchema, WhenConditionObjectSchema, WhenSchema, EntryValueSchema, ENTRY_KEY_RE, EntriesSchema, LaunchSchema, CREDENTIAL_TARGETS, PROVIDER_CREDENTIAL_TARGETS, CREDENTIAL_TARGET_VARS, ArgvSchema, CommandSourceOptions, EnvCredentialSourceSchema, FileCredentialSourceSchema, CommandCredentialSourceSchema, OpCredentialSourceSchema, KeychainCredentialSourceSchema, LiteralCredentialSourceSchema, CredentialSourceSchema, RemoteCredentialSourceSchema, CREDENTIAL_CACHE_STORES, CredentialCacheSchema, CredentialSchema, ProviderCredentialSchema, RESERVED_PROVIDER_ENV_KEYS, ProviderEnvSchema, PROVIDER_KINDS, ANTIGRAVITY_MODES, ANTIGRAVITY_EFFORTS, ANTIGRAVITY_DEFAULT_MODE, ANTIGRAVITY_DEFAULT_TIER_MODELS, AntigravityModelTargetSchema, AntigravityProviderConfigSchema, CODEX_EFFORTS, CODEX_LOGINS, CODEX_DEFAULT_TIER_MODELS, CodexProviderConfigSchema, ProviderRouteSchema, HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema, ProviderSchema, ConfigProfileSchema, POOL_SELECTOR_PREFIX, POOL_NAME_PATTERN, IDENTITY_NAME_PATTERN, PoolNameSchema, SELECTOR_RE, IdentitySelectorSchema, PoolMemberSchema, POOL_PREFERENCES, PoolPreferenceSchema, PoolSchema, WEEKDAYS, AnchorSchema, JOB_WINDOWS, JobTriggerSchema, JobTargetSchema, JobSchema, DirectoryRuleSchema, DirectoryRulesSchema, PortableConfigSchema, HEADROOM_MODES, HEADROOM_CCR_MODES, HEADROOM_ROLLOUT_CHANNELS, INTERCEPT_CHANNELS, READ_MATURATION_CHANNELS, HeadroomGlobalConfigObjectSchema, HeadroomGlobalConfigSchema, HEADROOM_DEFAULT_SOURCE, HEADROOM_DEFAULT_IDLE_SHUTDOWN_MINUTES, FrontDoorGlobalConfigSchema, UPDATE_MODES, UpdateGlobalConfigSchema, GlobalConfigSchema, IdentitySchema, CategoryClassificationSchema, CategoryClassificationOverlaySchema, SHIPPED_CATEGORY_DEFAULTS;
+var import_node_path2, import_zod, import_trilean, CATEGORY_NAMES, OVERRIDABLE_CATEGORIES, CategoryMapSchema, DURATION_RE, DurationSchema, WhenConditionObjectSchema, WhenSchema, EntryValueSchema, ENTRY_KEY_RE, EntriesSchema, LaunchSchema, CREDENTIAL_TARGETS, PROVIDER_CREDENTIAL_TARGETS, CREDENTIAL_TARGET_VARS, ArgvSchema, CommandSourceOptions, EnvCredentialSourceSchema, FileCredentialSourceSchema, CommandCredentialSourceSchema, OpCredentialSourceSchema, KeychainCredentialSourceSchema, LiteralCredentialSourceSchema, CredentialSourceSchema, RemoteCredentialSourceSchema, CREDENTIAL_CACHE_STORES, CredentialCacheSchema, CredentialSchema, ProviderCredentialSchema, RESERVED_PROVIDER_ENV_KEYS, ProviderEnvSchema, PROVIDER_KINDS, ANTIGRAVITY_MODES, ANTIGRAVITY_EFFORTS, ANTIGRAVITY_DEFAULT_MODE, ANTIGRAVITY_DEFAULT_TIER_MODELS, AntigravityModelTargetSchema, AntigravityProviderConfigSchema, CODEX_EFFORTS, CODEX_LOGINS, CODEX_DEFAULT_TIER_MODELS, CodexProviderConfigSchema, ProviderRouteSchema, HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema, ProviderSchema, ConfigProfileSchema, POOL_SELECTOR_PREFIX, POOL_NAME_PATTERN, IDENTITY_NAME_PATTERN, PoolNameSchema, SELECTOR_RE, IdentitySelectorSchema, PoolMemberSchema, POOL_PREFERENCES, PoolPreferenceSchema, WHOLE_PERCENT_MAX, CompactAtUtilisationSchema, PoolSchema, WEEKDAYS, AnchorSchema, JOB_WINDOWS, JobTriggerSchema, JobTargetSchema, JobSchema, DirectoryRuleSchema, DirectoryRulesSchema, PortableConfigSchema, HEADROOM_MODES, HEADROOM_CCR_MODES, HEADROOM_ROLLOUT_CHANNELS, INTERCEPT_CHANNELS, READ_MATURATION_CHANNELS, HeadroomGlobalConfigObjectSchema, HeadroomGlobalConfigSchema, HEADROOM_DEFAULT_SOURCE, HEADROOM_DEFAULT_IDLE_SHUTDOWN_MINUTES, FrontDoorGlobalConfigSchema, UPDATE_MODES, UpdateGlobalConfigSchema, GlobalConfigSchema, IdentitySchema, CategoryClassificationSchema, CategoryClassificationOverlaySchema, SHIPPED_CATEGORY_DEFAULTS;
 var init_schema = __esm({
   "src/config/schema.ts"() {
     "use strict";
@@ -455,10 +455,18 @@ var init_schema = __esm({
     PoolMemberSchema = import_zod.z.union([import_zod.z.string().min(1).regex(SELECTOR_RE), import_zod.z.strictObject({ identity: import_zod.z.string().min(1).regex(SELECTOR_RE), when: WhenSchema })]);
     POOL_PREFERENCES = ["score", "listed"];
     PoolPreferenceSchema = import_zod.z.enum(POOL_PREFERENCES);
+    WHOLE_PERCENT_MAX = 100;
+    CompactAtUtilisationSchema = import_zod.z.number().int().min(1).max(WHOLE_PERCENT_MAX);
     PoolSchema = import_zod.z.strictObject({
       identities: import_zod.z.array(PoolMemberSchema).min(1).refine((members) => new Set(members.map(poolMemberIdentity)).size === members.length, { message: "pool members must be unique" }),
-      preference: PoolPreferenceSchema.optional()
-    });
+      preference: PoolPreferenceSchema.optional(),
+      /** Whether an interactive launch from this pool keeps going when its identity runs out of quota: the launcher moves the session to the next member and resumes the conversation there. Absent means false. */
+      resumeOnLimit: import_zod.z.boolean().optional(),
+      /** Whether a supervised session's context is compacted before its identity's quota is spent, so the resume on the next member writes a small context instead of a large one. Needs `resumeOnLimit`. Absent means false. */
+      compactBeforeLimit: import_zod.z.boolean().optional(),
+      /** The share of a quota window, in whole percent, at which sessions are compacted. Absent means the launcher decides from what compacting every session on the member would cost against what its five-hour window has left. Needs `compactBeforeLimit`. */
+      compactAtUtilisation: CompactAtUtilisationSchema.optional()
+    }).refine((pool) => pool.compactBeforeLimit !== true || pool.resumeOnLimit === true, { message: "compactBeforeLimit needs resumeOnLimit, since a session that is not moved has no cold cache to avoid", path: ["compactBeforeLimit"] }).refine((pool) => pool.compactAtUtilisation === void 0 || pool.compactBeforeLimit === true, { message: "compactAtUtilisation needs compactBeforeLimit", path: ["compactAtUtilisation"] });
     WEEKDAYS = ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
     AnchorSchema = import_zod.z.strictObject({
       days: import_zod.z.array(import_zod.z.enum(WEEKDAYS)).min(1).refine((days) => new Set(days).size === days.length, "an anchor names each weekday at most once"),
@@ -2920,7 +2928,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.19.0",
+      version: "11.20.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -5506,10 +5514,12 @@ function rankPool(input) {
     const warmHere = sticky2?.identity === candidate.identity && nowMs - Date.parse(sticky2.at) <= PROMPT_CACHE_TTL_MS;
     if (input.resuming && input.resumeContextTokens !== void 0 && fiveHour !== void 0 && !warmHere) {
       const perToken = utilisationPerBilledToken(assessment.member.records);
-      const cost = perToken === void 0 ? void 0 : input.resumeContextTokens * perToken;
+      const committed = input.committedContextTokens?.[candidate.identity] ?? 0;
+      const cost = perToken === void 0 ? void 0 : (input.resumeContextTokens + committed) * perToken;
       if (cost !== void 0 && cost > fiveHour.remaining) {
         dryAfterMs.push(0);
-        drySpots.push(`resuming a ${String(input.resumeContextTokens)}-token conversation here would cost about ${percent(cost)} of the 5h window, which has ${percent(fiveHour.remaining)} left`);
+        const alongside = committed === 0 ? "" : ` (with ${String(committed)} tokens of other conversations already moving here)`;
+        drySpots.push(`resuming a ${String(input.resumeContextTokens)}-token conversation here${alongside} would cost about ${percent(cost)} of the 5h window, which has ${percent(fiveHour.remaining)} left`);
       }
     }
     if (drySpots.length === 0) {
@@ -5860,6 +5870,7 @@ function rankNamedPool(input, poolName, stack, sticky) {
     nowMs: input.nowMs,
     resuming: input.resuming,
     ...input.resumeContextTokens === void 0 ? {} : { resumeContextTokens: input.resumeContextTokens },
+    ...input.committedContextTokens === void 0 ? {} : { committedContextTokens: input.committedContextTokens },
     ...sticky === void 0 ? {} : { sticky },
     ...pool.preference === void 0 ? {} : { preference: pool.preference }
   });
@@ -6029,6 +6040,7 @@ function buildLayoutPaths(root) {
     usageAnchorsFile: import_node_path23.default.join(root, "usage", "anchors.json"),
     usageJobsFile: import_node_path23.default.join(root, "usage", "jobs.json"),
     jobLogsDir: import_node_path23.default.join(root, "logs", "jobs"),
+    superviseDir: import_node_path23.default.join(root, "supervise"),
     mcpPermissionsFile: import_node_path23.default.join(root, "mcp", "permissions.json")
   };
 }
@@ -7631,9 +7643,137 @@ var init_extraFlags = __esm({
   }
 });
 
+// src/usage/resumeContext.ts
+function projectDirNameOf(cwd) {
+  return cwd.replace(/[^A-Za-z0-9]/g, "-");
+}
+function resumeTargetOf(passthrough) {
+  const end = passthrough.indexOf("--");
+  const tokens = end === -1 ? passthrough : passthrough.slice(0, end);
+  for (const [index, token] of tokens.entries()) {
+    if (token === "--continue" || token === "-c") {
+      return { kind: "latest" };
+    }
+    if (token === "--resume" || token === "-r") {
+      const next = tokens[index + 1];
+      return next === void 0 || next.startsWith("-") ? void 0 : { kind: "id", id: next };
+    }
+    if (token.startsWith("--resume=")) {
+      const id = token.slice("--resume=".length);
+      return id === "" ? void 0 : { kind: "id", id };
+    }
+  }
+  return void 0;
+}
+function countOf(usage, key) {
+  const value = key in usage ? Reflect.get(usage, key) : void 0;
+  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : 0;
+}
+function contextTokensOfTranscript(text) {
+  const lines = text.split("\n");
+  for (let index = lines.length - 1; index >= 0; index -= 1) {
+    const line = lines[index];
+    if (line === void 0 || line === "") {
+      continue;
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (typeof parsed !== "object" || parsed === null || !("type" in parsed) || parsed.type !== "assistant" || !("message" in parsed)) {
+      continue;
+    }
+    const { message } = parsed;
+    if (typeof message !== "object" || message === null || !("usage" in message) || typeof message.usage !== "object" || message.usage === null) {
+      continue;
+    }
+    const { usage } = message;
+    return countOf(usage, "input_tokens") + countOf(usage, "cache_read_input_tokens") + countOf(usage, "cache_creation_input_tokens");
+  }
+  return void 0;
+}
+function newestTranscript(fs13, projectDir) {
+  let newest;
+  let newestMs = -Infinity;
+  for (const name of fs13.readdir(projectDir)) {
+    if (!name.endsWith(".jsonl")) {
+      continue;
+    }
+    const candidate = import_node_path37.default.join(projectDir, name);
+    const stat = fs13.lstat(candidate);
+    if (stat?.kind === "file" && stat.mtimeMs > newestMs) {
+      newestMs = stat.mtimeMs;
+      newest = candidate;
+    }
+  }
+  return newest;
+}
+function resumedContextTokens(fs13, params) {
+  const target = resumeTargetOf(params.passthrough);
+  if (target === void 0) {
+    return void 0;
+  }
+  const projectDir = import_node_path37.default.join(params.claudeHome, "projects", projectDirNameOf(params.cwd));
+  const file = target.kind === "id" ? import_node_path37.default.join(projectDir, `${target.id}.jsonl`) : newestTranscript(fs13, projectDir);
+  const text = file === void 0 ? void 0 : fs13.readFileUtf8(file);
+  return text === void 0 ? void 0 : contextTokensOfTranscript(text);
+}
+var import_node_path37;
+var init_resumeContext = __esm({
+  "src/usage/resumeContext.ts"() {
+    "use strict";
+    import_node_path37 = __toESM(require("node:path"), 1);
+  }
+});
+
+// src/launcher/claudeSession.ts
+function isFlag(token) {
+  return token?.startsWith("-") === true;
+}
+function withConversation(passthrough, conversation, id) {
+  const end = passthrough.indexOf(TERMINATOR2);
+  const head = end === -1 ? passthrough : passthrough.slice(0, end);
+  const tail = end === -1 ? [] : passthrough.slice(end);
+  const kept = [];
+  for (let index = 0; index < head.length; index += 1) {
+    const token = head[index];
+    if (token === void 0 || CONTINUE_FLAGS.has(token) || token.startsWith("--resume=") || token.startsWith("--session-id=")) {
+      continue;
+    }
+    if (VALUED_CONVERSATION_FLAGS.has(token)) {
+      if (!isFlag(head[index + 1]) && head[index + 1] !== void 0) {
+        index += 1;
+      }
+      continue;
+    }
+    kept.push(token);
+  }
+  return [...kept, conversation === "start" ? "--session-id" : "--resume", id, ...tail];
+}
+function withSupervision(passthrough, supervised) {
+  const conversation = supervised.conversation === "as-given" ? passthrough : withConversation(passthrough, supervised.conversation, supervised.sessionId);
+  if (supervised.settings === void 0) {
+    return conversation;
+  }
+  const end = conversation.indexOf(TERMINATOR2);
+  return end === -1 ? [...conversation, "--settings", supervised.settings] : [...conversation.slice(0, end), "--settings", supervised.settings, ...conversation.slice(end)];
+}
+var TERMINATOR2, VALUED_CONVERSATION_FLAGS, CONTINUE_FLAGS;
+var init_claudeSession = __esm({
+  "src/launcher/claudeSession.ts"() {
+    "use strict";
+    init_resumeContext();
+    TERMINATOR2 = "--";
+    VALUED_CONVERSATION_FLAGS = /* @__PURE__ */ new Set(["--resume", "-r", "--session-id"]);
+    CONTINUE_FLAGS = /* @__PURE__ */ new Set(["--continue", "-c"]);
+  }
+});
+
 // src/launcher/pool.ts
 function isResuming(passthrough) {
-  const end = passthrough.indexOf(TERMINATOR2);
+  const end = passthrough.indexOf(TERMINATOR3);
   return (end === -1 ? passthrough : passthrough.slice(0, end)).some((token) => RESUME_FLAGS.has(token));
 }
 function resolvePoolLaunch(params) {
@@ -7660,6 +7800,7 @@ function resolvePoolLaunch(params) {
         nowMs,
         resuming,
         ...params.resumeContextTokens === void 0 ? {} : { resumeContextTokens: params.resumeContextTokens },
+        ...params.committedContextTokens === void 0 ? {} : { committedContextTokens: params.committedContextTokens },
         identityExists: (name) => loadIdentity(params.paths.identitiesDir, name, params.fs) !== void 0,
         ...stickyRead.sticky === void 0 ? {} : { sticky: stickyRead.sticky }
       });
@@ -7717,7 +7858,7 @@ function resolvePoolLaunch(params) {
     params.sleep(Math.max(earliestReturn.atMs - nowMs, 0));
   }
 }
-var RESUME_FLAGS, TERMINATOR2, REASONS_LOGGED;
+var RESUME_FLAGS, TERMINATOR3, REASONS_LOGGED;
 var init_pool = __esm({
   "src/launcher/pool.ts"() {
     "use strict";
@@ -7725,96 +7866,11 @@ var init_pool = __esm({
     init_preflight();
     init_poolPick();
     RESUME_FLAGS = /* @__PURE__ */ new Set(["--continue", "-c", "--resume", "-r"]);
-    TERMINATOR2 = "--";
+    TERMINATOR3 = "--";
     REASONS_LOGGED = 3;
   }
 });
 
-// src/usage/resumeContext.ts
-function projectDirNameOf(cwd) {
-  return cwd.replace(/[^A-Za-z0-9]/g, "-");
-}
-function resumeTargetOf(passthrough) {
-  const end = passthrough.indexOf("--");
-  const tokens = end === -1 ? passthrough : passthrough.slice(0, end);
-  for (const [index, token] of tokens.entries()) {
-    if (token === "--continue" || token === "-c") {
-      return { kind: "latest" };
-    }
-    if (token === "--resume" || token === "-r") {
-      const next = tokens[index + 1];
-      return next === void 0 || next.startsWith("-") ? void 0 : { kind: "id", id: next };
-    }
-    if (token.startsWith("--resume=")) {
-      const id = token.slice("--resume=".length);
-      return id === "" ? void 0 : { kind: "id", id };
-    }
-  }
-  return void 0;
-}
-function countOf(usage, key) {
-  const value = key in usage ? Reflect.get(usage, key) : void 0;
-  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : 0;
-}
-function contextTokensOfTranscript(text) {
-  const lines = text.split("\n");
-  for (let index = lines.length - 1; index >= 0; index -= 1) {
-    const line = lines[index];
-    if (line === void 0 || line === "") {
-      continue;
-    }
-    let parsed;
-    try {
-      parsed = JSON.parse(line);
-    } catch {
-      continue;
-    }
-    if (typeof parsed !== "object" || parsed === null || !("type" in parsed) || parsed.type !== "assistant" || !("message" in parsed)) {
-      continue;
-    }
-    const { message } = parsed;
-    if (typeof message !== "object" || message === null || !("usage" in message) || typeof message.usage !== "object" || message.usage === null) {
-      continue;
-    }
-    const { usage } = message;
-    return countOf(usage, "input_tokens") + countOf(usage, "cache_read_input_tokens") + countOf(usage, "cache_creation_input_tokens");
-  }
-  return void 0;
-}
-function resumedContextTokens(fs13, params) {
-  const target = resumeTargetOf(params.passthrough);
-  if (target === void 0) {
-    return void 0;
-  }
-  const projectDir = import_node_path37.default.join(params.claudeHome, "projects", projectDirNameOf(params.cwd));
-  let file;
-  if (target.kind === "id") {
-    file = import_node_path37.default.join(projectDir, `${target.id}.jsonl`);
-  } else {
-    let newestMs = -Infinity;
-    for (const name of fs13.readdir(projectDir)) {
-      if (!name.endsWith(".jsonl")) {
-        continue;
-      }
-      const candidate = import_node_path37.default.join(projectDir, name);
-      const stat = fs13.lstat(candidate);
-      if (stat?.kind === "file" && stat.mtimeMs > newestMs) {
-        newestMs = stat.mtimeMs;
-        file = candidate;
-      }
-    }
-  }
-  const text = file === void 0 ? void 0 : fs13.readFileUtf8(file);
-  return text === void 0 ? void 0 : contextTokensOfTranscript(text);
-}
-var import_node_path37;
-var init_resumeContext = __esm({
-  "src/usage/resumeContext.ts"() {
-    "use strict";
-    import_node_path37 = __toESM(require("node:path"), 1);
-  }
-});
-
 // src/launcher/spawn.ts
 function childExitCode(result) {
   if (result.status !== null) {
@@ -7926,6 +7982,10 @@ function pickFromPool(decided, params, parsedArgv, readOnly) {
   if (decided.pool === void 0) {
     return { identityDecision: decided };
   }
+  if (params.supervised?.member !== void 0) {
+    const reasons = ["resumed here by the supervising launcher after the previous member ran out of quota"];
+    return { identityDecision: { ...decided, name: params.supervised.member }, poolExplanation: `pool ${decided.pool}: ${reasons.join("; ")}`, poolPick: { name: decided.pool, reasons } };
+  }
   const farmRuntime = params.farm;
   if (farmRuntime === void 0) {
     log.error(`agent-shim: pool "${decided.pool}" was selected, but this launcher has no farm wired to read usage and pick a member with.`);
@@ -8133,7 +8193,7 @@ function decideLaunch(params, readOnly) {
   const args = buildArgv({
     toolFlags: buildFlagArgs(flags),
     extraFlags: splitExtraFlags(env.CLAUDE_EXTRA_FLAGS),
-    passthrough: parsedArgv.rest
+    passthrough: params.supervised === void 0 ? parsedArgv.rest : withSupervision(parsedArgv.rest, params.supervised)
   });
   const configDir = configDirEscapeHatchApplies || identityDecision.name === void 0 ? env.CLAUDE_CONFIG_DIR : import_node_path38.default.join(paths.identitiesDir, identityDecision.name);
   const decision = {
@@ -8245,6 +8305,7 @@ function prepareLaunch(params) {
     log.info(`agent-shim: routing through the front door on 127.0.0.1:${String(frontDoor.port)}${resolvedProvider === void 0 ? ` (OAuth via the door's CONNECT surface on 127.0.0.1:${String(frontDoor.connectPort)}, usage recorded)` : ` (provider ${resolvedProvider.name})`}`);
   }
   const frontDoorRelease = frontDoor === void 0 ? void 0 : frontDoorPort?.release;
+  const sessionId = params.supervised?.sessionId ?? (0, import_node_crypto10.randomUUID)();
   const finalEnv = buildEnv({
     baseEnv: env,
     configDirEscapeHatch: configDirEscapeHatchApplies,
@@ -8254,7 +8315,7 @@ function prepareLaunch(params) {
     ...identityCredential === void 0 ? {} : { identityCredential },
     ...frontDoor === void 0 ? {} : { frontdoor: frontDoor },
     ...headroom === void 0 ? {} : { headroom },
-    sessionId: (0, import_node_crypto10.randomUUID)()
+    sessionId
   });
   const releases = [...headroom === void 0 || headroomPort === void 0 ? [] : [headroomPort.release], ...frontDoorRelease === void 0 ? [] : [frontDoorRelease]];
   const release = () => {
@@ -8262,7 +8323,7 @@ function prepareLaunch(params) {
       registered();
     }
   };
-  return { bin: decided.bin, args: finalArgv, env: finalEnv, release, markChildStarted: updateCheck.markChildStarted, decision };
+  return { bin: decided.bin, args: finalArgv, env: finalEnv, sessionId, release, markChildStarted: updateCheck.markChildStarted, decision };
 }
 function resolveLaunch(params) {
   const decided = decideLaunch(params, true);
@@ -8322,6 +8383,7 @@ var init_launcher = __esm({
     init_identity();
     init_flags();
     init_extraFlags();
+    init_claudeSession();
     init_pool();
     init_resumeContext();
     init_lock();
@@ -9164,6 +9226,7 @@ __export(index_exports, {
   buildRcSetPermissionModePayload: () => buildRcSetPermissionModePayload,
   buildRcUserMessagePayload: () => buildRcUserMessagePayload,
   carryOver: () => carryOver,
+  changePool: () => changePool,
   checkReportHasWarnings: () => checkReportHasWarnings,
   checkReportToJson: () => checkReportToJson,
   collectCheckReport: () => collectCheckReport,
@@ -9321,7 +9384,6 @@ __export(index_exports, {
   setDefaultConfigProfile: () => setDefaultConfigProfile,
   setGlobalDefaultProfile: () => setGlobalDefaultProfile,
   setIdentityCredential: () => setIdentityCredential,
-  setPool: () => setPool,
   setProfileCategories: () => setProfileCategories,
   setProfileEntries: () => setProfileEntries,
   setProfileLaunchFlags: () => setProfileLaunchFlags,
@@ -13247,7 +13309,24 @@ function validateMembers(pools, name, members) {
     throw new UsageError(`Member "pool:${cycle[1] ?? name}" would make pool "${name}" reach itself: ${cycle.join(" -> ")}. A pool cannot nest itself, directly or through another pool.`);
   }
 }
-function addPool(paths, name, identities, preference) {
+function requireConsistent(name, pool) {
+  const parsed = PoolSchema.safeParse(pool);
+  if (!parsed.success) {
+    throw new UsageError(`Pool "${name}": ${parsed.error.issues.map((issue) => issue.message).join("; ")}.`);
+  }
+}
+function poolPolicyOf(policy) {
+  return {
+    ...policy.preference === void 0 ? {} : { preference: policy.preference },
+    ...policy.resumeOnLimit === true ? { resumeOnLimit: true } : {},
+    ...policy.compactBeforeLimit === true ? { compactBeforeLimit: true } : {},
+    ...policy.compactAtUtilisation === void 0 ? {} : { compactAtUtilisation: policy.compactAtUtilisation }
+  };
+}
+function isPoolChange(change) {
+  return change.identities !== void 0 || change.preference !== void 0 || change.resumeOnLimit !== void 0 || change.compactBeforeLimit !== void 0 || change.compactAtUtilisation !== void 0;
+}
+function addPool(paths, name, identities, policy = {}) {
   if (!PoolNameSchema.safeParse(name).success) {
     throw new InvalidPoolNameError(name);
   }
@@ -13256,14 +13335,21 @@ function addPool(paths, name, identities, preference) {
     throw new PoolAlreadyExistsError(name);
   }
   validateMembers(pools, name, identities);
-  const pool = { identities: [...identities], ...preference === void 0 ? {} : { preference } };
+  const pool = { identities: [...identities], ...poolPolicyOf(policy) };
+  requireConsistent(name, pool);
   writePools(paths, { ...pools, [name]: pool });
   return pool;
 }
-function setPool(paths, name, identities, preference) {
-  requirePool(paths, name);
+function changePool(paths, name, change) {
+  const existing = requirePool(paths, name);
+  const identities = change.identities ?? existing.identities;
   validateMembers(readPools(paths), name, identities);
-  const pool = { identities: [...identities], ...preference === void 0 ? {} : { preference } };
+  const preference = change.preference === void 0 ? existing.preference : change.preference === false ? void 0 : change.preference;
+  const resumeOnLimit = change.resumeOnLimit ?? existing.resumeOnLimit;
+  const compactBeforeLimit = change.compactBeforeLimit ?? existing.compactBeforeLimit;
+  const compactAtUtilisation = change.compactAtUtilisation === void 0 ? existing.compactAtUtilisation : change.compactAtUtilisation === false ? void 0 : change.compactAtUtilisation;
+  const pool = { identities: [...identities], ...poolPolicyOf({ preference, resumeOnLimit, compactBeforeLimit, compactAtUtilisation }) };
+  requireConsistent(name, pool);
   writePools(paths, { ...readPools(paths), [name]: pool });
   return pool;
 }
@@ -15394,13 +15480,19 @@ var PoolMembersInputSchema = import_zod24.z.array(import_zod24.z.string().min(1)
 var ConfigPoolAddInputSchema = import_zod24.z.strictObject({
   name: import_zod24.z.string().min(1),
   identities: PoolMembersInputSchema,
-  preference: import_zod24.z.enum(POOL_PREFERENCES).optional()
+  preference: import_zod24.z.enum(POOL_PREFERENCES).optional(),
+  resumeOnLimit: import_zod24.z.boolean().optional(),
+  compactBeforeLimit: import_zod24.z.boolean().optional(),
+  compactAtUtilisation: CompactAtUtilisationSchema.optional()
 });
 var ConfigPoolAddOutputSchema = storedMutationOutput("pool", "created", PoolSchema);
 var ConfigPoolSetInputSchema = import_zod24.z.strictObject({
   name: import_zod24.z.string().min(1),
   identities: PoolMembersInputSchema.optional(),
-  preference: import_zod24.z.union([import_zod24.z.enum(POOL_PREFERENCES), import_zod24.z.literal(false)]).optional()
+  preference: import_zod24.z.union([import_zod24.z.enum(POOL_PREFERENCES), import_zod24.z.literal(false)]).optional(),
+  resumeOnLimit: import_zod24.z.boolean().optional(),
+  compactBeforeLimit: import_zod24.z.boolean().optional(),
+  compactAtUtilisation: import_zod24.z.union([CompactAtUtilisationSchema, import_zod24.z.literal(false)]).optional()
 });
 var ConfigPoolSetOutputSchema = storedMutationOutput("pool", "updated", PoolSchema);
 var ConfigPoolRemoveInputSchema = import_zod24.z.strictObject({ name: import_zod24.z.string().min(1), confirm: RemovalConfirmationSchema });
@@ -15611,20 +15703,19 @@ function createConfigApiRouter(deps) {
         add: route("/rest/config/pool/add", "Define a pool").input(ConfigPoolAddInputSchema).output(ConfigPoolAddOutputSchema).handler(
           ({ input }) => guarded(() => {
             requireIdentityNames(paths, input.identities);
-            const created = addPool(paths, input.name, input.identities, input.preference);
+            const created = addPool(paths, input.name, input.identities, { preference: input.preference, resumeOnLimit: input.resumeOnLimit, compactBeforeLimit: input.compactBeforeLimit, compactAtUtilisation: input.compactAtUtilisation });
             return { action: "created", kind: "pool", name: input.name, value: created };
           })
         ),
-        set: route("/rest/config/pool/set", "Replace a pool's members, its preference or both").input(ConfigPoolSetInputSchema).output(ConfigPoolSetOutputSchema).handler(
+        set: route("/rest/config/pool/set", "Replace a pool's members, change its preference or whether it resumes on a spent quota").input(ConfigPoolSetInputSchema).output(ConfigPoolSetOutputSchema).handler(
           ({ input }) => guarded(() => {
-            requireChange(input.identities !== void 0 || input.preference !== void 0, "identities or preference");
-            const existing = requirePool(paths, input.name);
+            const change = { identities: input.identities, preference: input.preference, resumeOnLimit: input.resumeOnLimit, compactBeforeLimit: input.compactBeforeLimit, compactAtUtilisation: input.compactAtUtilisation };
+            requireChange(isPoolChange(change), "identities, preference, resumeOnLimit, compactBeforeLimit or compactAtUtilisation");
+            requirePool(paths, input.name);
             if (input.identities !== void 0) {
               requireIdentityNames(paths, input.identities);
             }
-            const members = input.identities ?? existing.identities;
-            const preference = input.preference === void 0 ? existing.preference : input.preference === false ? void 0 : input.preference;
-            return { action: "updated", kind: "pool", name: input.name, value: setPool(paths, input.name, members, preference) };
+            return { action: "updated", kind: "pool", name: input.name, value: changePool(paths, input.name, change) };
           })
         ),
         remove: route("/rest/config/pool/remove", "Delete a pool").input(ConfigPoolRemoveInputSchema).output(ConfigPoolRemoveOutputSchema).handler(({ input }) => {
@@ -18841,6 +18932,7 @@ init_ownCli();
   buildRcSetPermissionModePayload,
   buildRcUserMessagePayload,
   carryOver,
+  changePool,
   checkReportHasWarnings,
   checkReportToJson,
   collectCheckReport,
@@ -18998,7 +19090,6 @@ init_ownCli();
   setDefaultConfigProfile,
   setGlobalDefaultProfile,
   setIdentityCredential,
-  setPool,
   setProfileCategories,
   setProfileEntries,
   setProfileLaunchFlags,