@iowarp/clio-coder 0.3.9 → 0.4.1

package/dist/chunk-PNY46YEY.js

@@ -1,1581 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  MAX_TIMER_DELAY_MS
-} from "./chunk-FQ4SKYE4.js";
-import {
-  ACTIVE_AGENT_AUTOMATION_ROLES,
-  ACTIVE_ROUTING_POSTURES,
-  ACTIVE_ROUTING_ROLES,
-  COUNCIL_MEMBER_LABEL_PATTERN,
-  DEFAULT_SETTINGS,
-  THEME_NAMED_COLORS,
-  THINKING_LEVELS
-} from "./chunk-XDOQXGFO.js";
-import {
-  withStateFileLockSync
-} from "./chunk-IKCO5N3L.js";
-import {
-  require_dist
-} from "./chunk-APJ265NV.js";
-import {
-  clioConfigDir,
-  resolveClioDirs
-} from "./chunk-BNAZZHFG.js";
-import {
-  safeResourceWrite
-} from "./chunk-WEPFGWHJ.js";
-import {
-  __toESM,
-  init_esm_shims
-} from "./chunk-3R73A4XB.js";
-
-// src/core/config.ts
-init_esm_shims();
-var import_yaml = __toESM(require_dist(), 1);
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-function settingsPath() {
-  return join(clioConfigDir(), "settings.yaml");
-}
-function issuesKind(issues) {
-  return issues[0]?.kind ?? "schema";
-}
-function settingsRemedy(kind, path) {
-  if (kind === "unreadable") return `Restore read access to ${path}, then run \`clio-coder doctor\` to re-check.`;
-  if (kind === "syntax") return `Fix the YAML in ${path}, then run \`clio-coder doctor\` to re-check.`;
-  return `Fix the keys above in ${path}, then run \`clio-coder doctor\` to re-check.`;
-}
-function settingsRemedyInline(kind, path) {
-  if (kind === "unreadable") return `restore read access to ${path}`;
-  if (kind === "syntax") return `fix the YAML in ${path}`;
-  return `edit the named keys in ${path}`;
-}
-var SettingsValidationError = class extends Error {
-  issues;
-  /**
-   * The headline and the remedy both follow the failure kind. A file that
-   * cannot be read has no key at fault, so telling its reader to "fix the keys
-   * above" named a repair that does not exist for the problem they have.
-   */
-  constructor(issues) {
-    const path = join(resolveClioDirs().config, "settings.yaml");
-    const kind = issuesKind(issues);
-    const lines = kind === "schema" ? issues.map((issue) => `  ${issue.path}: ${issue.message}`) : issues.map((issue) => `  ${issue.message}`);
-    const headline = kind === "schema" ? "settings.yaml failed validation:" : "settings.yaml cannot be loaded:";
-    super(
-      `${headline}
-${lines.join("\n")}
-
-${settingsRemedy(kind, path)}
-\`clio-coder doctor --fix\` repairs directories and credential permissions; it never rewrites settings.
-To discard these settings and start from defaults instead, run \`clio-coder reset --config --force\`.`
-    );
-    this.name = "SettingsValidationError";
-    this.issues = issues;
-  }
-};
-function foldToOneLine(text) {
-  return text.replace(/\s*\n\s*/g, " ").trim();
-}
-function yamlErrorSummary(error) {
-  const raw = error instanceof Error ? error.message : String(error);
-  return (raw.split("\n")[0] ?? raw).trim().replace(/:$/u, "");
-}
-function settingsFailureHeadline(kind) {
-  if (kind === "unreadable") return "settings.yaml cannot be read";
-  if (kind === "syntax") return "settings.yaml is not valid YAML";
-  return "settings.yaml failed validation";
-}
-function formatSettingsIssues(issues) {
-  if (issues.length === 0) return "";
-  const path = join(resolveClioDirs().config, "settings.yaml");
-  const kind = issuesKind(issues);
-  const detail = kind === "schema" ? issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ") : issues.map((issue) => issue.message.replace(/^(?:invalid YAML|unreadable): /u, "")).join("; ");
-  const discard = "`clio-coder reset --config --force` to start from defaults";
-  return foldToOneLine(
-    `${settingsFailureHeadline(kind)}: ${settingsRemedyInline(kind, path)}, or ${discard}. ${detail}`
-  );
-}
-function formatSettingsFailure(error) {
-  if (error instanceof SettingsValidationError && error.issues.length > 0) return formatSettingsIssues(error.issues);
-  return foldToOneLine(error instanceof Error ? error.message : String(error));
-}
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function cloneValue(value) {
-  return structuredClone(value);
-}
-var Issues = class {
-  list = [];
-  add(path, message) {
-    this.list.push({ path, message });
-  }
-  unknownKeys(path, raw, known) {
-    const knownSet = new Set(known);
-    for (const key of Object.keys(raw)) {
-      if (!knownSet.has(key)) this.add(path ? `${path}.${key}` : key, "unknown key");
-    }
-  }
-};
-function expectString(issues, path, value) {
-  if (typeof value !== "string") {
-    issues.add(path, `expected a string, got ${describe(value)}`);
-    return void 0;
-  }
-  const trimmed = value.trim();
-  if (trimmed.length === 0) {
-    issues.add(path, "expected a non-empty string");
-    return void 0;
-  }
-  return trimmed;
-}
-function expectBoolean(issues, path, value) {
-  if (typeof value !== "boolean") {
-    issues.add(path, `expected a boolean, got ${describe(value)}`);
-    return void 0;
-  }
-  return value;
-}
-function expectNumber(issues, path, value, opts) {
-  if (typeof value !== "number" || !Number.isFinite(value)) {
-    issues.add(path, `expected a number, got ${describe(value)}`);
-    return void 0;
-  }
-  if (opts?.min !== void 0 && value < opts.min) {
-    issues.add(path, `expected a number >= ${opts.min}, got ${value}`);
-    return void 0;
-  }
-  if (opts?.max !== void 0 && value > opts.max) {
-    issues.add(path, `expected a number <= ${opts.max}, got ${value}`);
-    return void 0;
-  }
-  return value;
-}
-function expectInteger(issues, path, value, opts) {
-  if (typeof value !== "number" || !Number.isInteger(value)) {
-    issues.add(path, `expected an integer, got ${describe(value)}`);
-    return void 0;
-  }
-  if (opts?.min !== void 0 && value < opts.min) {
-    issues.add(path, `expected an integer >= ${opts.min}, got ${value}`);
-    return void 0;
-  }
-  if (opts?.max !== void 0 && value > opts.max) {
-    issues.add(path, `expected an integer <= ${opts.max}, got ${value}`);
-    return void 0;
-  }
-  return value;
-}
-function expectEnum(issues, path, value, allowed) {
-  if (typeof value === "string" && allowed.includes(value)) return value;
-  issues.add(path, `expected one of ${allowed.join(" | ")}, got ${describe(value)}`);
-  return void 0;
-}
-function expectStringArray(issues, path, value) {
-  if (!Array.isArray(value)) {
-    issues.add(path, `expected a list of strings, got ${describe(value)}`);
-    return void 0;
-  }
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (let i = 0; i < value.length; i += 1) {
-    const entry = expectString(issues, `${path}[${i}]`, value[i]);
-    if (entry === void 0) continue;
-    if (seen.has(entry)) continue;
-    seen.add(entry);
-    out.push(entry);
-  }
-  return out;
-}
-function expectStringRecord(issues, path, value) {
-  if (!isPlainObject(value)) {
-    issues.add(path, `expected a string map, got ${describe(value)}`);
-    return void 0;
-  }
-  const out = {};
-  for (const [key, raw] of Object.entries(value)) {
-    const entry = expectString(issues, `${path}.${key}`, raw);
-    if (entry !== void 0) out[key] = entry;
-  }
-  return out;
-}
-function describe(value) {
-  if (value === null) return "null";
-  if (Array.isArray(value)) return "a list";
-  if (typeof value === "object") return "a map";
-  if (typeof value === "string") return value.trim().length === 0 ? "an empty string" : JSON.stringify(value);
-  return String(value);
-}
-var TOOL_CALL_FORMATS = ["openai", "anthropic", "hermes", "llama3-json", "mistral", "qwen", "xml"];
-var THINKING_FORMATS = [
-  "qwen-chat-template",
-  "openrouter",
-  "zai",
-  "anthropic-extended",
-  "deepseek-r1",
-  "openai-codex",
-  "harmony"
-];
-var STRUCTURED_OUTPUTS = ["json-schema", "gbnf", "xgrammar", "none"];
-var AUTONOMY_LEVELS = ["read-only", "suggest", "auto-edit", "full-auto"];
-var TOOL_GOVERNANCE = ["clio-policy", "agent-managed", "deny-all"];
-function validateCapabilities(issues, path, value) {
-  if (!isPlainObject(value)) {
-    issues.add(path, `expected a map, got ${describe(value)}`);
-    return void 0;
-  }
-  issues.unknownKeys(path, value, [
-    "chat",
-    "tools",
-    "toolCallFormat",
-    "reasoning",
-    "thinkingFormat",
-    "structuredOutputs",
-    "vision",
-    "audio",
-    "embeddings",
-    "rerank",
-    "fim",
-    "contextWindow",
-    "maxTokens"
-  ]);
-  const out = {};
-  for (const key of ["chat", "tools", "reasoning", "vision", "audio", "embeddings", "rerank", "fim"]) {
-    if (key in value) {
-      const v = expectBoolean(issues, `${path}.${key}`, value[key]);
-      if (v !== void 0) out[key] = v;
-    }
-  }
-  if ("toolCallFormat" in value) {
-    const v = expectEnum(issues, `${path}.toolCallFormat`, value.toolCallFormat, TOOL_CALL_FORMATS);
-    if (v !== void 0) out.toolCallFormat = v;
-  }
-  if ("thinkingFormat" in value) {
-    const v = expectEnum(issues, `${path}.thinkingFormat`, value.thinkingFormat, THINKING_FORMATS);
-    if (v !== void 0) out.thinkingFormat = v;
-  }
-  if ("structuredOutputs" in value) {
-    const v = expectEnum(issues, `${path}.structuredOutputs`, value.structuredOutputs, STRUCTURED_OUTPUTS);
-    if (v !== void 0) out.structuredOutputs = v;
-  }
-  if ("contextWindow" in value) {
-    const v = expectInteger(issues, `${path}.contextWindow`, value.contextWindow, { min: 0 });
-    if (v !== void 0) out.contextWindow = v;
-  }
-  if ("maxTokens" in value) {
-    const v = expectInteger(issues, `${path}.maxTokens`, value.maxTokens, { min: 0 });
-    if (v !== void 0) out.maxTokens = v;
-  }
-  return Object.keys(out).length > 0 ? out : void 0;
-}
-function validateAuth(issues, path, value) {
-  if (!isPlainObject(value)) {
-    issues.add(path, `expected a map, got ${describe(value)}`);
-    return void 0;
-  }
-  issues.unknownKeys(path, value, ["apiKeyEnvVar", "apiKeyRef", "oauthProfile", "headers"]);
-  const out = {};
-  for (const key of ["apiKeyEnvVar", "apiKeyRef", "oauthProfile"]) {
-    if (key in value) {
-      const v = expectString(issues, `${path}.${key}`, value[key]);
-      if (v !== void 0) out[key] = v;
-    }
-  }
-  if ("headers" in value) {
-    const v = expectStringRecord(issues, `${path}.headers`, value.headers);
-    if (v !== void 0 && Object.keys(v).length > 0) out.headers = v;
-  }
-  return Object.keys(out).length > 0 ? out : void 0;
-}
-function validatePricing(issues, path, value) {
-  if (!isPlainObject(value)) {
-    issues.add(path, `expected a map, got ${describe(value)}`);
-    return void 0;
-  }
-  issues.unknownKeys(path, value, ["input", "output", "cacheRead", "cacheWrite"]);
-  const input = expectNumber(issues, `${path}.input`, value.input, { min: 0 });
-  const output = expectNumber(issues, `${path}.output`, value.output, { min: 0 });
-  if (input === void 0 || output === void 0) return void 0;
-  const out = { input, output };
-  if ("cacheRead" in value) {
-    const v = expectNumber(issues, `${path}.cacheRead`, value.cacheRead, { min: 0 });
-    if (v !== void 0) out.cacheRead = v;
-  }
-  if ("cacheWrite" in value) {
-    const v = expectNumber(issues, `${path}.cacheWrite`, value.cacheWrite, { min: 0 });
-    if (v !== void 0) out.cacheWrite = v;
-  }
-  return out;
-}
-function validateLmStudioSettings(issues, path, value) {
-  if (!isPlainObject(value)) {
-    issues.add(path, `expected a map, got ${describe(value)}`);
-    return void 0;
-  }
-  issues.unknownKeys(path, value, ["load", "request"]);
-  const out = {};
-  if ("load" in value) {
-    if (!isPlainObject(value.load)) {
-      issues.add(`${path}.load`, `expected a map, got ${describe(value.load)}`);
-    } else {
-      issues.unknownKeys(`${path}.load`, value.load, [
-        "contextLength",
-        "flashAttention",
-        "evalBatchSize",
-        "numExperts",
-        "offloadKvCacheToGpu"
-      ]);
-      const load = {};
-      for (const key of ["contextLength", "evalBatchSize", "numExperts"]) {
-        if (key in value.load) {
-          const parsed = expectInteger(issues, `${path}.load.${key}`, value.load[key], { min: 1 });
-          if (parsed !== void 0) load[key] = parsed;
-        }
-      }
-      for (const key of ["flashAttention", "offloadKvCacheToGpu"]) {
-        if (key in value.load) {
-          const parsed = expectBoolean(issues, `${path}.load.${key}`, value.load[key]);
-          if (parsed !== void 0) load[key] = parsed;
-        }
-      }
-      if (Object.keys(load).length > 0) out.load = load;
-    }
-  }
-  if ("request" in value) {
-    if (!isPlainObject(value.request)) {
-      issues.add(`${path}.request`, `expected a map, got ${describe(value.request)}`);
-    } else {
-      issues.unknownKeys(`${path}.request`, value.request, ["ttlSeconds", "draftModel", "reasoning"]);
-      const request = {};
-      if ("ttlSeconds" in value.request) {
-        const parsed = expectInteger(issues, `${path}.request.ttlSeconds`, value.request.ttlSeconds, { min: 1 });
-        if (parsed !== void 0) request.ttlSeconds = parsed;
-      }
-      if ("draftModel" in value.request) {
-        const parsed = expectString(issues, `${path}.request.draftModel`, value.request.draftModel);
-        if (parsed !== void 0) request.draftModel = parsed;
-      }
-      if ("reasoning" in value.request) {
-        const parsed = expectEnum(issues, `${path}.request.reasoning`, value.request.reasoning, [
-          "auto",
-          "off",
-          "on",
-          "low",
-          "medium",
-          "high"
-        ]);
-        if (parsed !== void 0) request.reasoning = parsed;
-      }
-      if (Object.keys(request).length > 0) out.request = request;
-    }
-  }
-  return Object.keys(out).length > 0 ? out : void 0;
-}
-function validateTarget(issues, path, value) {
-  if (!isPlainObject(value)) {
-    issues.add(path, `expected a map, got ${describe(value)}`);
-    return null;
-  }
-  issues.unknownKeys(path, value, [
-    "id",
-    "runtime",
-    "url",
-    "auth",
-    "defaultModel",
-    "wireModels",
-    "capabilities",
-    "lifecycle",
-    "gateway",
-    "pricing",
-    "lmstudio",
-    "maxConcurrentRequests"
-  ]);
-  const id = "id" in value ? expectString(issues, `${path}.id`, value.id) : void 0;
-  const runtime = "runtime" in value ? expectString(issues, `${path}.runtime`, value.runtime) : void 0;
-  if (!("id" in value)) issues.add(`${path}.id`, "required");
-  if (!("runtime" in value)) issues.add(`${path}.runtime`, "required");
-  if (id === void 0 || runtime === void 0) return null;
-  const target = { id, runtime };
-  if ("url" in value) {
-    const v = expectString(issues, `${path}.url`, value.url);
-    if (v !== void 0) target.url = v;
-  }
-  if ("auth" in value) {
-    const v = validateAuth(issues, `${path}.auth`, value.auth);
-    if (v !== void 0) target.auth = v;
-  }
-  if ("wireModels" in value) {
-    const v = expectStringArray(issues, `${path}.wireModels`, value.wireModels);
-    if (v !== void 0 && v.length > 0) target.wireModels = v;
-  }
-  if ("defaultModel" in value) {
-    const v = expectString(issues, `${path}.defaultModel`, value.defaultModel);
-    if (v !== void 0) target.defaultModel = v;
-  } else if (target.wireModels?.[0]) {
-    target.defaultModel = target.wireModels[0];
-  }
-  if ("capabilities" in value) {
-    const v = validateCapabilities(issues, `${path}.capabilities`, value.capabilities);
-    if (v !== void 0) target.capabilities = v;
-  }
-  if ("lifecycle" in value) {
-    const v = expectEnum(issues, `${path}.lifecycle`, value.lifecycle, ["user-managed", "clio-managed"]);
-    if (v !== void 0) target.lifecycle = v;
-  }
-  if ("gateway" in value) {
-    const v = expectBoolean(issues, `${path}.gateway`, value.gateway);
-    if (v !== void 0) target.gateway = v;
-  }
-  if ("pricing" in value) {
-    const v = validatePricing(issues, `${path}.pricing`, value.pricing);
-    if (v !== void 0) target.pricing = v;
-  }
-  if ("lmstudio" in value) {
-    const v = validateLmStudioSettings(issues, `${path}.lmstudio`, value.lmstudio);
-    if (v !== void 0) target.lmstudio = v;
-  }
-  if ("maxConcurrentRequests" in value) {
-    const v = expectInteger(issues, `${path}.maxConcurrentRequests`, value.maxConcurrentRequests, { min: 1 });
-    if (v !== void 0) target.maxConcurrentRequests = v;
-  }
-  return target;
-}
-function validateWorkerTarget(issues, path, value, defaults, targets, options) {
-  const out = cloneValue(defaults);
-  if (!isPlainObject(value)) {
-    issues.add(path, `expected a map, got ${describe(value)}`);
-    return out;
-  }
-  const allowNode = options?.nodeIds !== void 0;
-  issues.unknownKeys(
-    path,
-    value,
-    allowNode ? ["target", "model", "thinkingLevel", "node"] : ["target", "model", "thinkingLevel"]
-  );
-  if ("target" in value && value.target !== null) {
-    const v = expectString(issues, `${path}.target`, value.target);
-    if (v !== void 0) out.target = targets.some((entry) => entry.id === v) ? v : null;
-  }
-  if ("thinkingLevel" in value) {
-    const v = expectEnum(issues, `${path}.thinkingLevel`, value.thinkingLevel, THINKING_LEVELS);
-    if (v !== void 0) out.thinkingLevel = v;
-  }
-  if ("model" in value && value.model !== null) {
-    const v = expectString(issues, `${path}.model`, value.model);
-    if (v !== void 0) out.model = v;
-  }
-  if (allowNode && "node" in value && value.node !== null) {
-    const v = expectString(issues, `${path}.node`, value.node);
-    if (v !== void 0) {
-      const id = v.trim();
-      if (id.length > 0 && (id === "local" || options?.nodeIds?.has(id) === true)) out.node = id;
-    }
-  }
-  if (!out.target) {
-    out.model = null;
-  } else if (out.model === null) {
-    out.model = targets.find((entry) => entry.id === out.target)?.defaultModel ?? null;
-  }
-  return out;
-}
-function normalizeModelRefs(refs, targets) {
-  const byId = new Set(targets.map((target) => target.id));
-  const out = [];
-  for (const ref of refs) {
-    const [targetId, ...modelParts] = ref.split("/");
-    if (!targetId || !byId.has(targetId) || modelParts.length === 0) continue;
-    const model = modelParts.join("/").trim();
-    if (!model) continue;
-    const normalized = `${targetId}/${model}`;
-    if (!out.includes(normalized)) out.push(normalized);
-  }
-  return out;
-}
-function normalizeScope(refs) {
-  const out = [];
-  for (const ref of refs) {
-    const trimmed = ref.trim();
-    const [targetId] = trimmed.split("/");
-    if (!targetId) continue;
-    if (!out.includes(trimmed)) out.push(trimmed);
-  }
-  return out;
-}
-function validateDelegationAgent(issues, path, value, defaults, seen) {
-  if (!isPlainObject(value)) {
-    issues.add(path, `expected a map, got ${describe(value)}`);
-    return null;
-  }
-  issues.unknownKeys(path, value, [
-    "id",
-    "command",
-    "args",
-    "cwd",
-    "env",
-    "connectTimeoutMs",
-    "turnTimeoutMs",
-    "permissionTimeoutMs",
-    "stallTimeoutMs",
-    "toolGovernance",
-    "projectContext",
-    "labels"
-  ]);
-  const id = "id" in value ? expectString(issues, `${path}.id`, value.id) : void 0;
-  const command = "command" in value ? expectString(issues, `${path}.command`, value.command) : void 0;
-  if (!("id" in value)) issues.add(`${path}.id`, "required");
-  if (!("command" in value)) issues.add(`${path}.command`, "required");
-  if (id === void 0 || command === void 0) return null;
-  if (id === "auto") {
-    issues.add(`${path}.id`, "'auto' is reserved for coordinator-owned agent selection");
-    return null;
-  }
-  if (seen.has(id)) {
-    issues.add(`${path}.id`, `duplicate delegation agent id '${id}'`);
-    return null;
-  }
-  seen.add(id);
-  const agent = {
-    id,
-    command,
-    args: [],
-    connectTimeoutMs: defaults.connectTimeoutMs,
-    turnTimeoutMs: defaults.turnTimeoutMs,
-    permissionTimeoutMs: defaults.permissionTimeoutMs,
-    toolGovernance: defaults.toolGovernance
-  };
-  if ("args" in value) {
-    const v = expectStringArray(issues, `${path}.args`, value.args);
-    if (v !== void 0) agent.args = v;
-  }
-  for (const key of ["connectTimeoutMs", "turnTimeoutMs", "permissionTimeoutMs"]) {
-    if (key in value) {
-      const v = expectInteger(issues, `${path}.${key}`, value[key], { min: 1, max: MAX_TIMER_DELAY_MS });
-      if (v !== void 0) agent[key] = v;
-    }
-  }
-  if ("stallTimeoutMs" in value) {
-    const v = expectInteger(issues, `${path}.stallTimeoutMs`, value.stallTimeoutMs);
-    if (v !== void 0) agent.stallTimeoutMs = v;
-  }
-  if ("toolGovernance" in value) {
-    const v = expectEnum(issues, `${path}.toolGovernance`, value.toolGovernance, TOOL_GOVERNANCE);
-    if (v !== void 0) agent.toolGovernance = v;
-  }
-  if ("projectContext" in value) {
-    const v = expectEnum(issues, `${path}.projectContext`, value.projectContext, ["none", "bounded"]);
-    if (v !== void 0) agent.projectContext = v;
-  }
-  if ("cwd" in value) {
-    const v = expectString(issues, `${path}.cwd`, value.cwd);
-    if (v !== void 0) agent.cwd = v;
-  }
-  if ("env" in value) {
-    const v = expectStringRecord(issues, `${path}.env`, value.env);
-    if (v !== void 0 && Object.keys(v).length > 0) agent.env = v;
-  }
-  if ("labels" in value) {
-    const v = expectStringRecord(issues, `${path}.labels`, value.labels);
-    if (v !== void 0 && Object.keys(v).length > 0) agent.labels = v;
-  }
-  return agent;
-}
-function validateDelegation(issues, value) {
-  const out = cloneValue(DEFAULT_SETTINGS.delegation);
-  if (!isPlainObject(value)) {
-    issues.add("delegation", `expected a map, got ${describe(value)}`);
-    return out;
-  }
-  issues.unknownKeys("delegation", value, ["agents", "defaults"]);
-  if ("defaults" in value) {
-    if (!isPlainObject(value.defaults)) {
-      issues.add("delegation.defaults", `expected a map, got ${describe(value.defaults)}`);
-    } else {
-      issues.unknownKeys("delegation.defaults", value.defaults, [
-        "connectTimeoutMs",
-        "turnTimeoutMs",
-        "permissionTimeoutMs",
-        "toolGovernance"
-      ]);
-      for (const key of ["connectTimeoutMs", "turnTimeoutMs", "permissionTimeoutMs"]) {
-        if (key in value.defaults) {
-          const v = expectInteger(issues, `delegation.defaults.${key}`, value.defaults[key], {
-            min: 1,
-            max: MAX_TIMER_DELAY_MS
-          });
-          if (v !== void 0) out.defaults[key] = v;
-        }
-      }
-      if ("toolGovernance" in value.defaults) {
-        const v = expectEnum(issues, "delegation.defaults.toolGovernance", value.defaults.toolGovernance, TOOL_GOVERNANCE);
-        if (v !== void 0) out.defaults.toolGovernance = v;
-      }
-    }
-  }
-  if ("agents" in value) {
-    if (!Array.isArray(value.agents)) {
-      issues.add("delegation.agents", `expected a list, got ${describe(value.agents)}`);
-    } else {
-      const seen = /* @__PURE__ */ new Set();
-      out.agents = value.agents.map((entry, i) => validateDelegationAgent(issues, `delegation.agents[${i}]`, entry, out.defaults, seen)).filter((entry) => entry !== null);
-    }
-  }
-  return out;
-}
-function validateFleetNode(issues, path, value, seen) {
-  if (!isPlainObject(value)) {
-    issues.add(path, `expected a map, got ${describe(value)}`);
-    return null;
-  }
-  issues.unknownKeys(path, value, [
-    "id",
-    "host",
-    "user",
-    "port",
-    "identityFile",
-    "clioCoderEntry",
-    // Pre-0.3.1 spelling, still read.
-    "clioEntry",
-    "labels",
-    "maxWorkers",
-    "residency"
-  ]);
-  const id = "id" in value ? expectString(issues, `${path}.id`, value.id) : void 0;
-  const host = "host" in value ? expectString(issues, `${path}.host`, value.host) : void 0;
-  if (!("id" in value)) issues.add(`${path}.id`, "required");
-  if (!("host" in value)) issues.add(`${path}.host`, "required");
-  if (id === void 0 || host === void 0) return null;
-  const trimmedId = id.trim();
-  if (trimmedId.length === 0) {
-    issues.add(`${path}.id`, "must not be blank");
-    return null;
-  }
-  if (trimmedId === "local") {
-    issues.add(`${path}.id`, "'local' is reserved for the implicit local node");
-    return null;
-  }
-  if (seen.has(trimmedId)) {
-    issues.add(`${path}.id`, `duplicate fleet node id '${trimmedId}'`);
-    return null;
-  }
-  seen.add(trimmedId);
-  const node = { id: trimmedId, host, maxWorkers: 2 };
-  if ("user" in value) {
-    const v = expectString(issues, `${path}.user`, value.user);
-    if (v !== void 0) node.user = v;
-  }
-  if ("port" in value) {
-    const v = expectInteger(issues, `${path}.port`, value.port, { min: 1 });
-    if (v !== void 0) node.port = v;
-  }
-  if ("identityFile" in value) {
-    const v = expectString(issues, `${path}.identityFile`, value.identityFile);
-    if (v !== void 0) node.identityFile = v;
-  }
-  if ("clioEntry" in value) {
-    const v = expectString(issues, `${path}.clioEntry`, value.clioEntry);
-    if (v !== void 0) node.clioCoderEntry = v;
-  }
-  if ("clioCoderEntry" in value) {
-    const v = expectString(issues, `${path}.clioCoderEntry`, value.clioCoderEntry);
-    if (v !== void 0) node.clioCoderEntry = v;
-  }
-  if ("labels" in value) {
-    const v = expectStringArray(issues, `${path}.labels`, value.labels);
-    if (v !== void 0) node.labels = v;
-  }
-  if ("maxWorkers" in value) {
-    const v = expectInteger(issues, `${path}.maxWorkers`, value.maxWorkers, { min: 1 });
-    if (v !== void 0) node.maxWorkers = v;
-  }
-  if ("residency" in value) {
-    const v = expectEnum(issues, `${path}.residency`, value.residency, ["observe", "manage"]);
-    if (v !== void 0) node.residency = v;
-  }
-  return node;
-}
-function validateFleet(issues, value) {
-  const out = cloneValue(DEFAULT_SETTINGS.fleet);
-  if (!isPlainObject(value)) {
-    issues.add("fleet", `expected a map, got ${describe(value)}`);
-    return out;
-  }
-  issues.unknownKeys("fleet", value, ["nodes"]);
-  if ("nodes" in value) {
-    if (!Array.isArray(value.nodes)) {
-      issues.add("fleet.nodes", `expected a list, got ${describe(value.nodes)}`);
-    } else {
-      const seen = /* @__PURE__ */ new Set();
-      out.nodes = value.nodes.map((entry, i) => validateFleetNode(issues, `fleet.nodes[${i}]`, entry, seen)).filter((entry) => entry !== null);
-    }
-  }
-  return out;
-}
-function validateMemorySettings(issues, value) {
-  const out = cloneValue(DEFAULT_SETTINGS.memory);
-  if (!isPlainObject(value)) {
-    issues.add("memory", `expected a map, got ${describe(value)}`);
-    return out;
-  }
-  issues.unknownKeys("memory", value, ["intervention"]);
-  if (!("intervention" in value)) return out;
-  if (!isPlainObject(value.intervention)) {
-    issues.add("memory.intervention", `expected a map, got ${describe(value.intervention)}`);
-    return out;
-  }
-  const raw = value.intervention;
-  issues.unknownKeys("memory.intervention", raw, ["enabled", "everyNTools", "windowSteps", "maxTokens", "timeoutMs"]);
-  if ("enabled" in raw) {
-    const enabled = expectBoolean(issues, "memory.intervention.enabled", raw.enabled);
-    if (enabled !== void 0) out.intervention.enabled = enabled;
-  }
-  for (const key of ["everyNTools", "windowSteps", "maxTokens", "timeoutMs"]) {
-    if (!(key in raw)) continue;
-    const parsed = expectInteger(issues, `memory.intervention.${key}`, raw[key], {
-      min: key === "everyNTools" ? 2 : 1
-    });
-    if (parsed !== void 0) out.intervention[key] = parsed;
-  }
-  return out;
-}
-function validateWatchdogSettings(issues, value) {
-  const out = cloneValue(DEFAULT_SETTINGS.watchdog);
-  if (!isPlainObject(value)) {
-    issues.add("watchdog", `expected a map, got ${describe(value)}`);
-    return out;
-  }
-  issues.unknownKeys("watchdog", value, ["enabled", "target", "cadenceToolCalls"]);
-  if ("enabled" in value) {
-    const enabled = expectBoolean(issues, "watchdog.enabled", value.enabled);
-    if (enabled !== void 0) out.enabled = enabled;
-  }
-  if ("target" in value && value.target !== null) {
-    const target = expectString(issues, "watchdog.target", value.target);
-    if (target !== void 0) {
-      if (target.trim().length === 0) issues.add("watchdog.target", "expected a non-empty target id");
-      else out.target = target.trim();
-    }
-  }
-  if ("cadenceToolCalls" in value && value.cadenceToolCalls !== null) {
-    const cadence = expectInteger(issues, "watchdog.cadenceToolCalls", value.cadenceToolCalls, { min: 1 });
-    if (cadence !== void 0) out.cadenceToolCalls = cadence;
-  }
-  return out;
-}
-function validateKeybindings(issues, value) {
-  if (!isPlainObject(value)) {
-    issues.add("keybindings", `expected a map, got ${describe(value)}`);
-    return {};
-  }
-  const next = {};
-  for (const [rawKey, rawValue] of Object.entries(value)) {
-    const id = rawKey.trim();
-    if (!id) {
-      issues.add("keybindings", "empty keybinding id");
-      continue;
-    }
-    if (typeof rawValue === "string") {
-      const v = expectString(issues, `keybindings.${id}`, rawValue);
-      if (v !== void 0) next[id] = v;
-      continue;
-    }
-    if (Array.isArray(rawValue)) {
-      const v = expectStringArray(issues, `keybindings.${id}`, rawValue);
-      if (v !== void 0 && v.length > 0) next[id] = v;
-      continue;
-    }
-    issues.add(`keybindings.${id}`, `expected a string or list of strings, got ${describe(rawValue)}`);
-  }
-  return next;
-}
-var TOP_LEVEL_KEYS = [
-  "version",
-  // Accepted and ignored. Settings files generated before 0.3.1 carry an
-  // `identity:` line for a control nothing ever read; listing it here keeps
-  // those files loading without an unknown-key issue.
-  "identity",
-  "autonomy",
-  "targets",
-  "runtimePlugins",
-  "orchestrator",
-  "background",
-  "memory",
-  "watchdog",
-  "workers",
-  "fleet",
-  "routing",
-  "scope",
-  "modelSelector",
-  "budget",
-  "defaults",
-  "theme",
-  "terminal",
-  "skills",
-  "library",
-  "attribution",
-  "delegation",
-  "keybindings",
-  "compaction",
-  "context",
-  "prewarm",
-  "retry",
-  "guardrails"
-];
-function validateSettings(raw) {
-  const issues = new Issues();
-  const settings = cloneValue(DEFAULT_SETTINGS);
-  if (!isPlainObject(raw)) {
-    issues.add("(root)", `expected a map, got ${describe(raw)}`);
-    return { settings, issues: issues.list };
-  }
-  issues.unknownKeys("", raw, TOP_LEVEL_KEYS);
-  if ("version" in raw && raw.version !== 1) {
-    issues.add("version", `expected 1, got ${describe(raw.version)}`);
-  }
-  if ("autonomy" in raw) {
-    const v = expectEnum(issues, "autonomy", raw.autonomy, AUTONOMY_LEVELS);
-    if (v !== void 0) settings.autonomy = v;
-  }
-  if ("targets" in raw) {
-    if (!Array.isArray(raw.targets)) {
-      issues.add("targets", `expected a list, got ${describe(raw.targets)}`);
-    } else {
-      const seen = /* @__PURE__ */ new Set();
-      const out = [];
-      for (let i = 0; i < raw.targets.length; i += 1) {
-        const target = validateTarget(issues, `targets[${i}]`, raw.targets[i]);
-        if (!target) continue;
-        if (seen.has(target.id)) {
-          issues.add(`targets[${i}].id`, `duplicate target id '${target.id}'`);
-          continue;
-        }
-        seen.add(target.id);
-        out.push(target);
-      }
-      settings.targets = out;
-    }
-  }
-  if ("runtimePlugins" in raw) {
-    const v = expectStringArray(issues, "runtimePlugins", raw.runtimePlugins);
-    if (v !== void 0) settings.runtimePlugins = v;
-  }
-  if ("library" in raw) {
-    if (!isPlainObject(raw.library)) {
-      issues.add("library", `expected a map, got ${describe(raw.library)}`);
-    } else {
-      issues.unknownKeys("library", raw.library, ["catalog", "remote", "confirmedRemote", "sync"]);
-      for (const key of ["catalog", "remote", "confirmedRemote"]) {
-        const value = raw.library[key];
-        if (value === void 0) continue;
-        if (value !== null && typeof value !== "string")
-          issues.add(`library.${key}`, `expected a string or null, got ${describe(value)}`);
-        else settings.library[key] = value;
-      }
-      if (raw.library.sync !== void 0) {
-        if (typeof raw.library.sync !== "boolean")
-          issues.add("library.sync", `expected a boolean, got ${describe(raw.library.sync)}`);
-        else settings.library.sync = raw.library.sync;
-      }
-    }
-  }
-  if ("orchestrator" in raw) {
-    settings.orchestrator = validateWorkerTarget(
-      issues,
-      "orchestrator",
-      raw.orchestrator,
-      settings.orchestrator,
-      settings.targets
-    );
-  }
-  if ("background" in raw) {
-    settings.background = validateWorkerTarget(
-      issues,
-      "background",
-      raw.background,
-      settings.background,
-      settings.targets
-    );
-  }
-  if ("memory" in raw) settings.memory = validateMemorySettings(issues, raw.memory);
-  if ("watchdog" in raw) settings.watchdog = validateWatchdogSettings(issues, raw.watchdog);
-  if ("fleet" in raw) {
-    settings.fleet = validateFleet(issues, raw.fleet);
-  }
-  const fleetNodeIds = new Set(settings.fleet.nodes.map((node) => node.id));
-  if ("routing" in raw) {
-    if (!isPlainObject(raw.routing)) {
-      issues.add("routing", `expected a map, got ${describe(raw.routing)}`);
-    } else {
-      issues.unknownKeys("routing", raw.routing, ["activeRoles", "activePostures", "agentAutomation"]);
-      const activeRoles = expectStringArray(issues, "routing.activeRoles", raw.routing.activeRoles);
-      if (activeRoles !== void 0) {
-        const allowed = new Set(ACTIVE_ROUTING_ROLES);
-        const rawRoles = raw.routing.activeRoles;
-        const stringRoles = rawRoles.filter((role) => typeof role === "string");
-        const complete = activeRoles.length === rawRoles.length;
-        for (const role of activeRoles) {
-          if (!allowed.has(role)) issues.add("routing.activeRoles", `unsupported active role '${role}'`);
-        }
-        if (new Set(stringRoles).size !== stringRoles.length) {
-          issues.add("routing.activeRoles", "expected unique roles");
-        }
-        if (complete && activeRoles.every((role) => allowed.has(role))) {
-          settings.routing.activeRoles = activeRoles;
-        }
-      }
-      const activePostures = expectStringArray(issues, "routing.activePostures", raw.routing.activePostures);
-      if (activePostures !== void 0) {
-        const allowed = new Set(ACTIVE_ROUTING_POSTURES);
-        const rawPostures = raw.routing.activePostures;
-        const stringPostures = rawPostures.filter((posture) => typeof posture === "string");
-        const complete = activePostures.length === rawPostures.length;
-        for (const posture of activePostures) {
-          if (!allowed.has(posture)) issues.add("routing.activePostures", `unsupported active posture '${posture}'`);
-        }
-        if (new Set(stringPostures).size !== stringPostures.length) {
-          issues.add("routing.activePostures", "expected unique postures");
-        }
-        if (complete && activePostures.every((posture) => allowed.has(posture))) {
-          settings.routing.activePostures = activePostures;
-        }
-      }
-      if (!isPlainObject(raw.routing.agentAutomation)) {
-        issues.add("routing.agentAutomation", "expected a map");
-      } else {
-        const automation = raw.routing.agentAutomation;
-        issues.unknownKeys("routing.agentAutomation", automation, ["activeAgentRoles"]);
-        if (!Array.isArray(automation.activeAgentRoles)) {
-          issues.add("routing.agentAutomation.activeAgentRoles", "expected a list");
-        } else {
-          const pairs = [];
-          const seen = /* @__PURE__ */ new Set();
-          for (const [index, value] of automation.activeAgentRoles.entries()) {
-            const path = `routing.agentAutomation.activeAgentRoles[${index}]`;
-            if (!isPlainObject(value)) {
-              issues.add(path, "expected a map");
-              continue;
-            }
-            issues.unknownKeys(path, value, ["agentId", "executionRole"]);
-            const agentId = expectString(issues, `${path}.agentId`, value.agentId);
-            const executionRole = expectEnum(
-              issues,
-              `${path}.executionRole`,
-              value.executionRole,
-              ACTIVE_AGENT_AUTOMATION_ROLES
-            );
-            if (agentId === "auto") {
-              issues.add(`${path}.agentId`, "'auto' is reserved for coordinator-owned agent selection");
-            }
-            if (agentId === void 0 || agentId === "auto" || executionRole === void 0) continue;
-            const key = `${agentId}\0${executionRole}`;
-            if (seen.has(key)) {
-              issues.add(path, "duplicate agent and execution-role pair");
-              continue;
-            }
-            seen.add(key);
-            pairs.push({ agentId, executionRole });
-          }
-          if (pairs.length === automation.activeAgentRoles.length) {
-            settings.routing.agentAutomation.activeAgentRoles = pairs;
-          }
-        }
-      }
-    }
-  }
-  if ("workers" in raw) {
-    if (!isPlainObject(raw.workers)) {
-      issues.add("workers", `expected a map, got ${describe(raw.workers)}`);
-    } else {
-      issues.unknownKeys("workers", raw.workers, [
-        "default",
-        "profiles",
-        "rosters",
-        "agentBindings",
-        "maxRetries",
-        "onPermission",
-        "escalation",
-        "resilienceCooldownMs"
-      ]);
-      if ("default" in raw.workers) {
-        settings.workers.default = validateWorkerTarget(
-          issues,
-          "workers.default",
-          raw.workers.default,
-          settings.workers.default,
-          settings.targets,
-          { nodeIds: fleetNodeIds }
-        );
-      }
-      if ("profiles" in raw.workers) {
-        if (!isPlainObject(raw.workers.profiles)) {
-          issues.add("workers.profiles", `expected a map, got ${describe(raw.workers.profiles)}`);
-        } else {
-          const profiles = {};
-          for (const [rawName, rawProfile] of Object.entries(raw.workers.profiles)) {
-            const name = rawName.trim();
-            if (!name) {
-              issues.add("workers.profiles", "empty profile name");
-              continue;
-            }
-            const profile = validateWorkerTarget(
-              issues,
-              `workers.profiles.${name}`,
-              rawProfile,
-              DEFAULT_SETTINGS.workers.default,
-              settings.targets,
-              { nodeIds: fleetNodeIds }
-            );
-            if (!profile.target) continue;
-            profiles[name] = profile;
-          }
-          settings.workers.profiles = profiles;
-        }
-      }
-      if ("rosters" in raw.workers) {
-        if (!isPlainObject(raw.workers.rosters)) {
-          issues.add("workers.rosters", `expected a map, got ${describe(raw.workers.rosters)}`);
-        } else {
-          const rosters = {};
-          for (const [rawName, rawRoster] of Object.entries(raw.workers.rosters)) {
-            const name = rawName.trim();
-            const path = `workers.rosters.${name}`;
-            if (!name) {
-              issues.add("workers.rosters", "empty roster name");
-              continue;
-            }
-            if (!isPlainObject(rawRoster)) {
-              issues.add(path, `expected a map, got ${describe(rawRoster)}`);
-              continue;
-            }
-            issues.unknownKeys(path, rawRoster, ["members"]);
-            if (!Array.isArray(rawRoster.members)) {
-              issues.add(`${path}.members`, "expected a list");
-              continue;
-            }
-            if (rawRoster.members.length < 2 || rawRoster.members.length > 5) {
-              issues.add(`${path}.members`, "expected 2 to 5 members");
-            }
-            const members = [];
-            const labels = /* @__PURE__ */ new Set();
-            for (const [index, rawMember] of rawRoster.members.entries()) {
-              const memberPath = `${path}.members[${index}]`;
-              if (!isPlainObject(rawMember)) {
-                issues.add(memberPath, `expected a map, got ${describe(rawMember)}`);
-                continue;
-              }
-              issues.unknownKeys(memberPath, rawMember, ["label", "target", "model", "thinking", "color"]);
-              const label = expectString(issues, `${memberPath}.label`, rawMember.label);
-              const target = expectString(issues, `${memberPath}.target`, rawMember.target);
-              if (label !== void 0 && !COUNCIL_MEMBER_LABEL_PATTERN.test(label)) {
-                issues.add(`${memberPath}.label`, "expected [a-z][a-z0-9_-]{0,31}");
-              }
-              if (label !== void 0 && labels.has(label)) issues.add(`${memberPath}.label`, "duplicate label");
-              if (label !== void 0) labels.add(label);
-              if (target !== void 0 && !settings.targets.some((entry) => entry.id === target)) {
-                issues.add(`${memberPath}.target`, `unknown target '${target}'`);
-              }
-              const model = rawMember.model === void 0 ? void 0 : expectString(issues, `${memberPath}.model`, rawMember.model);
-              const thinking = rawMember.thinking === void 0 ? void 0 : expectEnum(issues, `${memberPath}.thinking`, rawMember.thinking, THINKING_LEVELS);
-              const color = rawMember.color === void 0 ? void 0 : expectString(issues, `${memberPath}.color`, rawMember.color);
-              if (color !== void 0 && !THEME_NAMED_COLORS.includes(color) && !/^#[0-9a-fA-F]{6}$/u.test(color)) {
-                issues.add(`${memberPath}.color`, "expected a theme named color or 6-digit hex color");
-              }
-              if (label === void 0 || target === void 0) continue;
-              members.push({
-                label,
-                target,
-                ...model ? { model } : {},
-                ...thinking ? { thinking } : {},
-                ...color ? { color } : {}
-              });
-            }
-            if (rawRoster.members.length >= 2 && rawRoster.members.length <= 5 && members.length === rawRoster.members.length)
-              rosters[name] = { members };
-          }
-          settings.workers.rosters = rosters;
-        }
-      }
-      if ("agentBindings" in raw.workers) {
-        if (!isPlainObject(raw.workers.agentBindings)) {
-          issues.add("workers.agentBindings", `expected a map, got ${describe(raw.workers.agentBindings)}`);
-        } else {
-          const agentBindings = {};
-          for (const [rawAgentId, rawProfileName] of Object.entries(raw.workers.agentBindings)) {
-            const agentId = rawAgentId.trim();
-            if (!agentId) {
-              issues.add("workers.agentBindings", "empty agent id");
-              continue;
-            }
-            if (agentId === "auto") {
-              issues.add("workers.agentBindings", "'auto' is reserved for coordinator-owned agent selection");
-              continue;
-            }
-            const profileName = expectString(issues, `workers.agentBindings.${agentId}`, rawProfileName);
-            if (profileName !== void 0) agentBindings[agentId] = profileName;
-          }
-          settings.workers.agentBindings = agentBindings;
-        }
-      }
-      if ("maxRetries" in raw.workers) {
-        const v = expectInteger(issues, "workers.maxRetries", raw.workers.maxRetries, { min: 0 });
-        if (v !== void 0) settings.workers.maxRetries = v;
-      }
-      if ("onPermission" in raw.workers) {
-        const v = expectEnum(issues, "workers.onPermission", raw.workers.onPermission, [
-          "deny",
-          "fail",
-          "escalate"
-        ]);
-        if (v !== void 0) settings.workers.onPermission = v;
-      }
-      if ("escalation" in raw.workers) {
-        if (!isPlainObject(raw.workers.escalation)) {
-          issues.add("workers.escalation", `expected a map, got ${describe(raw.workers.escalation)}`);
-        } else {
-          const base = settings.workers.escalation ?? DEFAULT_SETTINGS.workers.escalation;
-          const escalation = { timeoutMs: base?.timeoutMs ?? 12e4, fallback: base?.fallback ?? "deny" };
-          issues.unknownKeys("workers.escalation", raw.workers.escalation, ["timeoutMs", "fallback"]);
-          if ("timeoutMs" in raw.workers.escalation) {
-            const v = expectInteger(issues, "workers.escalation.timeoutMs", raw.workers.escalation.timeoutMs, {
-              min: 1
-            });
-            if (v !== void 0) escalation.timeoutMs = v;
-          }
-          if ("fallback" in raw.workers.escalation) {
-            const v = expectEnum(issues, "workers.escalation.fallback", raw.workers.escalation.fallback, [
-              "deny",
-              "fail"
-            ]);
-            if (v !== void 0) escalation.fallback = v;
-          }
-          settings.workers.escalation = escalation;
-        }
-      }
-      if ("resilienceCooldownMs" in raw.workers) {
-        const v = expectInteger(issues, "workers.resilienceCooldownMs", raw.workers.resilienceCooldownMs, { min: 0 });
-        if (v !== void 0) settings.workers.resilienceCooldownMs = v;
-      }
-    }
-  }
-  if ("scope" in raw) {
-    const v = expectStringArray(issues, "scope", raw.scope);
-    if (v !== void 0) settings.scope = normalizeScope(v);
-  }
-  if ("modelSelector" in raw) {
-    if (!isPlainObject(raw.modelSelector)) {
-      issues.add("modelSelector", `expected a map, got ${describe(raw.modelSelector)}`);
-    } else {
-      issues.unknownKeys("modelSelector", raw.modelSelector, ["favorites", "recentLimit"]);
-      if ("favorites" in raw.modelSelector) {
-        const v = expectStringArray(issues, "modelSelector.favorites", raw.modelSelector.favorites);
-        if (v !== void 0) settings.modelSelector.favorites = normalizeModelRefs(v, settings.targets);
-      }
-      if ("recentLimit" in raw.modelSelector) {
-        const v = expectInteger(issues, "modelSelector.recentLimit", raw.modelSelector.recentLimit, { min: 1 });
-        if (v !== void 0) settings.modelSelector.recentLimit = v;
-      }
-    }
-  }
-  if ("budget" in raw) {
-    if (!isPlainObject(raw.budget)) {
-      issues.add("budget", `expected a map, got ${describe(raw.budget)}`);
-    } else {
-      issues.unknownKeys("budget", raw.budget, ["sessionCeilingUsd", "concurrency"]);
-      if ("sessionCeilingUsd" in raw.budget) {
-        const v = expectNumber(issues, "budget.sessionCeilingUsd", raw.budget.sessionCeilingUsd, { min: 0 });
-        if (v !== void 0) settings.budget.sessionCeilingUsd = v;
-      }
-      if ("concurrency" in raw.budget) {
-        if (raw.budget.concurrency === "auto") {
-          settings.budget.concurrency = "auto";
-        } else {
-          const v = expectInteger(issues, "budget.concurrency", raw.budget.concurrency, { min: 1 });
-          if (v !== void 0) settings.budget.concurrency = v;
-        }
-      }
-    }
-  }
-  if ("defaults" in raw) {
-    if (!isPlainObject(raw.defaults)) {
-      issues.add("defaults", `expected a map, got ${describe(raw.defaults)}`);
-    } else {
-      issues.unknownKeys("defaults", raw.defaults, ["maxTokens"]);
-      if ("maxTokens" in raw.defaults) {
-        const v = expectInteger(issues, "defaults.maxTokens", raw.defaults.maxTokens, { min: 0 });
-        if (v !== void 0) settings.defaults.maxTokens = v;
-      }
-    }
-  }
-  if ("theme" in raw) {
-    const v = expectString(issues, "theme", raw.theme);
-    if (v !== void 0) settings.theme = v;
-  }
-  if ("terminal" in raw) {
-    if (!isPlainObject(raw.terminal)) {
-      issues.add("terminal", `expected a map, got ${describe(raw.terminal)}`);
-    } else {
-      issues.unknownKeys("terminal", raw.terminal, [
-        "showTerminalProgress",
-        "outputVerbosity",
-        "tuiMode",
-        "fullscreenScrollbar",
-        "smoothStreaming",
-        "notify"
-      ]);
-      if ("showTerminalProgress" in raw.terminal) {
-        const v = expectBoolean(issues, "terminal.showTerminalProgress", raw.terminal.showTerminalProgress);
-        if (v !== void 0) settings.terminal.showTerminalProgress = v;
-      }
-      if ("outputVerbosity" in raw.terminal) {
-        const v = expectString(issues, "terminal.outputVerbosity", raw.terminal.outputVerbosity);
-        if (v === "minimal" || v === "default" || v === "verbose") settings.terminal.outputVerbosity = v;
-        else if (v !== void 0) issues.add("terminal.outputVerbosity", "expected minimal, default, or verbose");
-      }
-      if ("tuiMode" in raw.terminal) {
-        const v = expectString(issues, "terminal.tuiMode", raw.terminal.tuiMode);
-        if (v === "regular" || v === "fullscreen") settings.terminal.tuiMode = v;
-        else if (v !== void 0) issues.add("terminal.tuiMode", "expected regular or fullscreen");
-      }
-      if ("fullscreenScrollbar" in raw.terminal) {
-        const v = expectString(issues, "terminal.fullscreenScrollbar", raw.terminal.fullscreenScrollbar);
-        if (v === "hidden" || v === "auto" || v === "always") settings.terminal.fullscreenScrollbar = v;
-        else if (v !== void 0) issues.add("terminal.fullscreenScrollbar", "expected hidden, auto, or always");
-      }
-      if ("smoothStreaming" in raw.terminal) {
-        const v = expectString(issues, "terminal.smoothStreaming", raw.terminal.smoothStreaming);
-        if (v === "off" || v === "auto" || v === "on") settings.terminal.smoothStreaming = v;
-        else if (v !== void 0) issues.add("terminal.smoothStreaming", "expected off, auto, or on");
-      }
-      if ("notify" in raw.terminal) {
-        const v = expectBoolean(issues, "terminal.notify", raw.terminal.notify);
-        if (v !== void 0) settings.terminal.notify = v;
-      }
-    }
-  }
-  if ("skills" in raw) {
-    if (!isPlainObject(raw.skills)) {
-      issues.add("skills", `expected a map, got ${describe(raw.skills)}`);
-    } else {
-      issues.unknownKeys("skills", raw.skills, ["trustProjectCompatRoots"]);
-      if ("trustProjectCompatRoots" in raw.skills) {
-        const v = expectBoolean(issues, "skills.trustProjectCompatRoots", raw.skills.trustProjectCompatRoots);
-        if (v !== void 0) settings.skills.trustProjectCompatRoots = v;
-      }
-    }
-  }
-  if ("attribution" in raw) {
-    if (!isPlainObject(raw.attribution)) {
-      issues.add("attribution", `expected a map, got ${describe(raw.attribution)}`);
-    } else {
-      issues.unknownKeys("attribution", raw.attribution, ["gitCommits"]);
-      if ("gitCommits" in raw.attribution) {
-        const v = expectBoolean(issues, "attribution.gitCommits", raw.attribution.gitCommits);
-        if (v !== void 0) settings.attribution.gitCommits = v;
-      }
-    }
-  }
-  if ("delegation" in raw) {
-    settings.delegation = validateDelegation(issues, raw.delegation);
-  }
-  if ("keybindings" in raw) {
-    settings.keybindings = validateKeybindings(issues, raw.keybindings);
-  }
-  if ("compaction" in raw) {
-    if (!isPlainObject(raw.compaction)) {
-      issues.add("compaction", `expected a map, got ${describe(raw.compaction)}`);
-    } else {
-      issues.unknownKeys("compaction", raw.compaction, ["auto", "threshold", "excludeLastTurns", "model", "systemPrompt"]);
-      if ("auto" in raw.compaction) {
-        const v = expectBoolean(issues, "compaction.auto", raw.compaction.auto);
-        if (v !== void 0) settings.compaction.auto = v;
-      }
-      if ("threshold" in raw.compaction) {
-        const v = expectNumber(issues, "compaction.threshold", raw.compaction.threshold, { min: 0, max: 1 });
-        if (v !== void 0) settings.compaction.threshold = v;
-      }
-      if ("excludeLastTurns" in raw.compaction) {
-        const v = expectInteger(issues, "compaction.excludeLastTurns", raw.compaction.excludeLastTurns, { min: 1 });
-        if (v !== void 0) settings.compaction.excludeLastTurns = v;
-      }
-      if ("model" in raw.compaction) {
-        const v = expectString(issues, "compaction.model", raw.compaction.model);
-        if (v !== void 0) settings.compaction.model = v;
-      }
-      if ("systemPrompt" in raw.compaction) {
-        const v = expectString(issues, "compaction.systemPrompt", raw.compaction.systemPrompt);
-        if (v !== void 0) settings.compaction.systemPrompt = v;
-      }
-    }
-  }
-  if ("context" in raw) {
-    if (!isPlainObject(raw.context)) {
-      issues.add("context", `expected a map, got ${describe(raw.context)}`);
-    } else {
-      issues.unknownKeys("context", raw.context, ["workingSet"]);
-      if ("workingSet" in raw.context) {
-        if (!isPlainObject(raw.context.workingSet)) {
-          issues.add("context.workingSet", `expected a map, got ${describe(raw.context.workingSet)}`);
-        } else {
-          const workingSet = raw.context.workingSet;
-          issues.unknownKeys("context.workingSet", workingSet, [
-            "enabled",
-            "policy",
-            "target",
-            "protectLastTurns",
-            "minEvictableTokens"
-          ]);
-          if ("enabled" in workingSet) {
-            const v = expectBoolean(issues, "context.workingSet.enabled", workingSet.enabled);
-            if (v !== void 0) settings.context.workingSet.enabled = v;
-          }
-          if ("policy" in workingSet) {
-            const v = expectEnum(issues, "context.workingSet.policy", workingSet.policy, [
-              "age-horizon",
-              "structural-v1"
-            ]);
-            if (v !== void 0) settings.context.workingSet.policy = v;
-          }
-          if ("target" in workingSet) {
-            const v = expectNumber(issues, "context.workingSet.target", workingSet.target);
-            if (v !== void 0 && (v <= 0 || v >= 1)) {
-              issues.add("context.workingSet.target", `expected a number > 0 and < 1, got ${v}`);
-            } else if (v !== void 0) {
-              settings.context.workingSet.target = v;
-            }
-          }
-          if ("protectLastTurns" in workingSet) {
-            const v = expectInteger(issues, "context.workingSet.protectLastTurns", workingSet.protectLastTurns, {
-              min: 1
-            });
-            if (v !== void 0) settings.context.workingSet.protectLastTurns = v;
-          }
-          if ("minEvictableTokens" in workingSet) {
-            const v = expectInteger(issues, "context.workingSet.minEvictableTokens", workingSet.minEvictableTokens, {
-              min: 0
-            });
-            if (v !== void 0) settings.context.workingSet.minEvictableTokens = v;
-          }
-        }
-      }
-    }
-  }
-  if ("prewarm" in raw) {
-    if (!isPlainObject(raw.prewarm)) {
-      issues.add("prewarm", `expected a map, got ${describe(raw.prewarm)}`);
-    } else {
-      issues.unknownKeys("prewarm", raw.prewarm, ["enabled"]);
-      if ("enabled" in raw.prewarm) {
-        const v = expectBoolean(issues, "prewarm.enabled", raw.prewarm.enabled);
-        if (v !== void 0) settings.prewarm.enabled = v;
-      }
-    }
-  }
-  if ("retry" in raw) {
-    if (!isPlainObject(raw.retry)) {
-      issues.add("retry", `expected a map, got ${describe(raw.retry)}`);
-    } else {
-      issues.unknownKeys("retry", raw.retry, ["enabled", "maxRetries", "baseDelayMs", "maxDelayMs", "streamStallMs"]);
-      if ("enabled" in raw.retry) {
-        const v = expectBoolean(issues, "retry.enabled", raw.retry.enabled);
-        if (v !== void 0) settings.retry.enabled = v;
-      }
-      for (const key of ["maxRetries", "baseDelayMs", "maxDelayMs", "streamStallMs"]) {
-        if (key in raw.retry) {
-          const v = expectInteger(issues, `retry.${key}`, raw.retry[key], { min: 0 });
-          if (v !== void 0) settings.retry[key] = v;
-        }
-      }
-    }
-  }
-  if ("guardrails" in raw) {
-    if (!isPlainObject(raw.guardrails)) {
-      issues.add("guardrails", `expected a map, got ${describe(raw.guardrails)}`);
-    } else {
-      const keys = [
-        "turnToolCallBudget",
-        "workerToolCallCap",
-        "maxDispatchRuns",
-        "readMaxBytes",
-        "observationTurnBudgetBytes",
-        "internalDispatchTimeoutMs"
-      ];
-      issues.unknownKeys("guardrails", raw.guardrails, keys);
-      for (const key of keys) {
-        if (key in raw.guardrails) {
-          const v = expectInteger(issues, `guardrails.${key}`, raw.guardrails[key], { min: 1 });
-          if (v !== void 0) settings.guardrails[key] = v;
-        }
-      }
-    }
-  }
-  return { settings, issues: issues.list };
-}
-function validateSettingsFile() {
-  const path = join(resolveClioDirs().config, "settings.yaml");
-  if (!existsSync(path)) return { settings: cloneValue(DEFAULT_SETTINGS), issues: [] };
-  let text;
-  try {
-    text = readFileSync(path, "utf8");
-  } catch (err) {
-    return {
-      settings: cloneValue(DEFAULT_SETTINGS),
-      issues: [
-        { path: "(root)", message: `unreadable: ${err instanceof Error ? err.message : String(err)}`, kind: "unreadable" }
-      ]
-    };
-  }
-  let parsed;
-  try {
-    parsed = (0, import_yaml.parse)(text);
-  } catch (err) {
-    return {
-      settings: cloneValue(DEFAULT_SETTINGS),
-      issues: [{ path: "(root)", message: `invalid YAML: ${yamlErrorSummary(err)}`, kind: "syntax" }]
-    };
-  }
-  return validateSettings(parsed);
-}
-function readSettings() {
-  const result = validateSettingsFile();
-  if (result.issues.length > 0) throw new SettingsValidationError(result.issues);
-  return result.settings;
-}
-function persistSettings(document) {
-  safeResourceWrite(settingsPath(), (0, import_yaml.stringify)(document), { encoding: "utf8", mode: 420 });
-}
-function readSavedDocument() {
-  const path = settingsPath();
-  if (!existsSync(path)) return {};
-  try {
-    return (0, import_yaml.parse)(readFileSync(path, "utf8")) ?? {};
-  } catch {
-    return {};
-  }
-}
-function applySettingsDelta(saved, before, after) {
-  if (!isPlainObject(before) || !isPlainObject(after)) return cloneValue(after);
-  const out = isPlainObject(saved) ? { ...saved } : {};
-  for (const [key, next] of Object.entries(after)) {
-    if (deepEquals(before[key], next)) continue;
-    out[key] = applySettingsDelta(out[key], before[key], next);
-  }
-  for (const key of Object.keys(out)) {
-    if (!(key in after)) delete out[key];
-  }
-  return out;
-}
-function deepEquals(a, b) {
-  if (a === b) return true;
-  if (Array.isArray(a) || Array.isArray(b)) {
-    if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
-    return a.every((entry, index) => deepEquals(entry, b[index]));
-  }
-  if (!isPlainObject(a) || !isPlainObject(b)) return false;
-  const keys = Object.keys(a);
-  if (keys.length !== Object.keys(b).length) return false;
-  return keys.every((key) => key in b && deepEquals(a[key], b[key]));
-}
-function updateSavedSettingsDocument(mutate, options = {}) {
-  withSettingsLock(() => {
-    readSettings();
-    const saved = readSavedDocument();
-    persistSettings(mutate(cloneValue(saved)));
-  }, options);
-}
-function withSettingsLock(fn, options = {}) {
-  return withStateFileLockSync(settingsPath(), fn, { timeoutMs: options.timeoutMs ?? 1e4 });
-}
-function updateSettings(mutate, options = {}) {
-  return withSettingsLock(() => {
-    const saved = readSavedDocument();
-    const current = readSettings();
-    const before = cloneValue(current);
-    const next = mutate(current) ?? current;
-    const revalidated = validateSettings(JSON.parse(JSON.stringify(next)));
-    if (revalidated.issues.length > 0) throw new SettingsValidationError(revalidated.issues);
-    persistSettings(applySettingsDelta(saved, before, revalidated.settings));
-    return revalidated.settings;
-  }, options);
-}
-function useTargetInSettings(settings, targetId, options = {}) {
-  const target = settings.targets.find((entry) => entry.id === targetId);
-  if (!target) return null;
-  const workerTarget = options.workerTargetId !== void 0 && options.workerTargetId !== target.id ? settings.targets.find((entry) => entry.id === options.workerTargetId) : target;
-  if (!workerTarget) return null;
-  const sharedModel = options.model ?? target.defaultModel ?? null;
-  settings.orchestrator.target = target.id;
-  settings.orchestrator.model = options.orchestratorModel ?? sharedModel;
-  settings.workers.default.target = workerTarget.id;
-  settings.workers.default.model = options.workerModel ?? (workerTarget === target ? sharedModel : workerTarget.defaultModel ?? null);
-  if (options.backgroundModel !== void 0) {
-    settings.background.target = target.id;
-    settings.background.model = options.backgroundModel;
-  }
-  return { workerTargetId: workerTarget.id };
-}
-function removeTargetFromSettings(settings, id) {
-  if (!settings.targets.some((entry) => entry.id === id)) return false;
-  settings.targets = settings.targets.filter((entry) => entry.id !== id);
-  if (settings.orchestrator.target === id) {
-    settings.orchestrator.target = null;
-    settings.orchestrator.model = null;
-  }
-  if (settings.background.target === id) {
-    settings.background.target = null;
-    settings.background.model = null;
-  }
-  if (settings.workers.default.target === id) {
-    settings.workers.default.target = null;
-    settings.workers.default.model = null;
-  }
-  for (const [name, profile] of Object.entries(settings.workers.profiles)) {
-    if (profile.target === id) delete settings.workers.profiles[name];
-  }
-  settings.scope = settings.scope.filter((entry) => entry.split("/")[0] !== id);
-  return true;
-}
-function setFleetProfileInSettings(settings, name, targetId, options = {}) {
-  const target = settings.targets.find((entry) => entry.id === targetId);
-  if (!target) return false;
-  const existing = settings.workers.profiles[name];
-  settings.workers.profiles[name] = {
-    target: target.id,
-    model: options.model ?? target.defaultModel ?? null,
-    thinkingLevel: options.thinkingLevel ?? existing?.thinkingLevel ?? "off"
-  };
-  return true;
-}
-function removeFleetProfileFromSettings(settings, name) {
-  delete settings.workers.profiles[name];
-  let removedBindings = 0;
-  for (const [agentId, profileName] of Object.entries(settings.workers.agentBindings)) {
-    if (profileName !== name) continue;
-    delete settings.workers.agentBindings[agentId];
-    removedBindings += 1;
-  }
-  return removedBindings;
-}
-function bindAgentProfileInSettings(settings, agentId, profileName) {
-  if (settings.delegation.agents.some((agent) => agent.id === agentId)) return false;
-  settings.workers.agentBindings[agentId] = profileName;
-  return true;
-}
-
-export {
-  settingsPath,
-  SettingsValidationError,
-  formatSettingsIssues,
-  formatSettingsFailure,
-  validateSettings,
-  validateSettingsFile,
-  readSettings,
-  applySettingsDelta,
-  updateSavedSettingsDocument,
-  updateSettings,
-  useTargetInSettings,
-  removeTargetFromSettings,
-  setFleetProfileInSettings,
-  removeFleetProfileFromSettings,
-  bindAgentProfileInSettings
-};
-//# sourceMappingURL=chunk-PNY46YEY.js.map