claude-use 11.19.0 → 11.20.0

package/dist/index.mjs

@@ -223,7 +223,7 @@ function isTimeZone(name) {
     return false;
   }
 }
-var 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 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";
@@ -433,10 +433,18 @@ var init_schema = __esm({
     PoolMemberSchema = z.union([z.string().min(1).regex(SELECTOR_RE), z.strictObject({ identity: z.string().min(1).regex(SELECTOR_RE), when: WhenSchema })]);
     POOL_PREFERENCES = ["score", "listed"];
     PoolPreferenceSchema = z.enum(POOL_PREFERENCES);
+    WHOLE_PERCENT_MAX = 100;
+    CompactAtUtilisationSchema = z.number().int().min(1).max(WHOLE_PERCENT_MAX);
     PoolSchema = z.strictObject({
       identities: 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: 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: 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 = z.strictObject({
       days: z.array(z.enum(WEEKDAYS)).min(1).refine((days) => new Set(days).size === days.length, "an anchor names each weekday at most once"),
@@ -2896,7 +2904,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>",
@@ -5480,10 +5488,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) {
@@ -5836,6 +5846,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 }
   });
@@ -6006,6 +6017,7 @@ function buildLayoutPaths(root) {
     usageAnchorsFile: path23.join(root, "usage", "anchors.json"),
     usageJobsFile: path23.join(root, "usage", "jobs.json"),
     jobLogsDir: path23.join(root, "logs", "jobs"),
+    superviseDir: path23.join(root, "supervise"),
     mcpPermissionsFile: path23.join(root, "mcp", "permissions.json")
   };
 }
@@ -7604,9 +7616,136 @@ var init_extraFlags = __esm({
   }
 });
 
+// src/usage/resumeContext.ts
+import path37 from "node:path";
+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 = path37.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 = path37.join(params.claudeHome, "projects", projectDirNameOf(params.cwd));
+  const file = target.kind === "id" ? path37.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 init_resumeContext = __esm({
+  "src/usage/resumeContext.ts"() {
+    "use strict";
+  }
+});
+
+// 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) {
@@ -7633,6 +7772,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 }
       });
@@ -7690,7 +7830,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";
@@ -7698,95 +7838,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
-import path37 from "node:path";
-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 = path37.join(params.claudeHome, "projects", projectDirNameOf(params.cwd));
-  let file;
-  if (target.kind === "id") {
-    file = path37.join(projectDir, `${target.id}.jsonl`);
-  } else {
-    let newestMs = -Infinity;
-    for (const name of fs13.readdir(projectDir)) {
-      if (!name.endsWith(".jsonl")) {
-        continue;
-      }
-      const candidate = path37.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 init_resumeContext = __esm({
-  "src/usage/resumeContext.ts"() {
-    "use strict";
-  }
-});
-
 // src/launcher/spawn.ts
 import os7 from "node:os";
 function childExitCode(result) {
@@ -7900,6 +7956,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.`);
@@ -8107,7 +8167,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 : path38.join(paths.identitiesDir, identityDecision.name);
   const decision = {
@@ -8219,6 +8279,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 ?? randomUUID4();
   const finalEnv = buildEnv({
     baseEnv: env,
     configDirEscapeHatch: configDirEscapeHatchApplies,
@@ -8228,7 +8289,7 @@ function prepareLaunch(params) {
     ...identityCredential === void 0 ? {} : { identityCredential },
     ...frontDoor === void 0 ? {} : { frontdoor: frontDoor },
     ...headroom === void 0 ? {} : { headroom },
-    sessionId: randomUUID4()
+    sessionId
   });
   const releases = [...headroom === void 0 || headroomPort === void 0 ? [] : [headroomPort.release], ...frontDoorRelease === void 0 ? [] : [frontDoorRelease]];
   const release = () => {
@@ -8236,7 +8297,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);
@@ -8293,6 +8354,7 @@ var init_launcher = __esm({
     init_identity();
     init_flags();
     init_extraFlags();
+    init_claudeSession();
     init_pool();
     init_resumeContext();
     init_lock();
@@ -12834,7 +12896,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);
   }
@@ -12843,14 +12922,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;
 }
@@ -14981,13 +15067,19 @@ var PoolMembersInputSchema = z24.array(z24.string().min(1)).min(1);
 var ConfigPoolAddInputSchema = z24.strictObject({
   name: z24.string().min(1),
   identities: PoolMembersInputSchema,
-  preference: z24.enum(POOL_PREFERENCES).optional()
+  preference: z24.enum(POOL_PREFERENCES).optional(),
+  resumeOnLimit: z24.boolean().optional(),
+  compactBeforeLimit: z24.boolean().optional(),
+  compactAtUtilisation: CompactAtUtilisationSchema.optional()
 });
 var ConfigPoolAddOutputSchema = storedMutationOutput("pool", "created", PoolSchema);
 var ConfigPoolSetInputSchema = z24.strictObject({
   name: z24.string().min(1),
   identities: PoolMembersInputSchema.optional(),
-  preference: z24.union([z24.enum(POOL_PREFERENCES), z24.literal(false)]).optional()
+  preference: z24.union([z24.enum(POOL_PREFERENCES), z24.literal(false)]).optional(),
+  resumeOnLimit: z24.boolean().optional(),
+  compactBeforeLimit: z24.boolean().optional(),
+  compactAtUtilisation: z24.union([CompactAtUtilisationSchema, z24.literal(false)]).optional()
 });
 var ConfigPoolSetOutputSchema = storedMutationOutput("pool", "updated", PoolSchema);
 var ConfigPoolRemoveInputSchema = z24.strictObject({ name: z24.string().min(1), confirm: RemovalConfirmationSchema });
@@ -15198,20 +15290,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 }) => {
@@ -18427,6 +18518,7 @@ export {
   buildRcSetPermissionModePayload,
   buildRcUserMessagePayload,
   carryOver,
+  changePool,
   checkReportHasWarnings,
   checkReportToJson,
   collectCheckReport,
@@ -18584,7 +18676,6 @@ export {
   setDefaultConfigProfile,
   setGlobalDefaultProfile,
   setIdentityCredential,
-  setPool,
   setProfileCategories,
   setProfileEntries,
   setProfileLaunchFlags,