switchroom 0.20.7 → 0.20.9

package/dist/agent-scheduler/index.js

@@ -12004,6 +12004,29 @@ var OverlayDocSchema = exports_external.object({
 // src/config/overlay-loader.ts
 var OVERLAY_SOURCE = Symbol.for("switchroom.config.overlay-source");
 var OVERLAY_TITLE = Symbol.for("switchroom.config.overlay-title");
+var OVERLAY_READ_FAILURES = Symbol.for("switchroom.config.overlay-read-failures");
+function recordReadFailure(agentCfg, failure) {
+  const node = agentCfg;
+  const existing = node[OVERLAY_READ_FAILURES];
+  if (Array.isArray(existing)) {
+    existing.push(failure);
+    return;
+  }
+  Object.defineProperty(agentCfg, OVERLAY_READ_FAILURES, {
+    value: [failure],
+    enumerable: false,
+    configurable: true,
+    writable: false
+  });
+}
+function overlayReadFailures(config, agent, source) {
+  const agentCfg = config.agents?.[agent];
+  if (!agentCfg)
+    return [];
+  const list = agentCfg[OVERLAY_READ_FAILURES];
+  const all = Array.isArray(list) ? list : [];
+  return source ? all.filter((f) => f.source === source) : all;
+}
 function deriveOverlayTitle(raw, fileName) {
   const titleFromComment = raw.match(/^#[^\S\n]*name:[^\S\n]*(\S.*?)[^\S\n]*$/m)?.[1];
   if (titleFromComment)
@@ -12013,17 +12036,39 @@ function deriveOverlayTitle(raw, fileName) {
     return;
   return base.length > 0 ? base : undefined;
 }
+function readOverlayFile(agentName, file, agentCfg, warnings, source) {
+  try {
+    return readFileSync(file, "utf-8");
+  } catch (err) {
+    const code = err.code;
+    if (code === "ENOENT")
+      return;
+    const w = {
+      agent: agentName,
+      file,
+      reason: `read error: ${err.message}`,
+      code: code ?? "EUNKNOWN"
+    };
+    recordReadFailure(agentCfg, { file, code: w.code, source });
+    warnings.push(w);
+    console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${file}': ${w.reason}`);
+    return;
+  }
+}
 function overlayDirFor(agentName, subdir) {
   const base = resolveDualPath(`~/.switchroom/agents/${agentName}/${subdir}`);
   return resolve2(base);
 }
-function listYamlFiles(dir) {
+function listYamlFiles(dir, onUnreadableDir) {
   if (!existsSync2(dir))
     return [];
   let entries;
   try {
     entries = readdirSync(dir);
-  } catch {
+  } catch (err) {
+    const code = err.code;
+    if (code !== "ENOENT")
+      onUnreadableDir?.(code ?? "EUNKNOWN");
     return [];
   }
   const out = [];
@@ -12061,12 +12106,24 @@ function applyAgentOverlays(config) {
   for (const [agentName, agentCfg] of Object.entries(agents)) {
     try {
       const scheduleDir = overlayDirFor(agentName, "schedule.d");
-      const files = listYamlFiles(scheduleDir);
+      const files = listYamlFiles(scheduleDir, (code) => {
+        const w = {
+          agent: agentName,
+          file: scheduleDir,
+          reason: `read error: cannot list overlay directory (${code})`,
+          code
+        };
+        recordReadFailure(agentCfg, { file: scheduleDir, code, source: "schedule" });
+        warnings.push(w);
+        console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${scheduleDir}': ${w.reason}`);
+      });
       if (files.length > 0) {
         const merged = [...agentCfg.schedule ?? []];
         for (const file of files) {
+          const raw = readOverlayFile(agentName, file, agentCfg, warnings, "schedule");
+          if (raw === undefined)
+            continue;
           try {
-            const raw = readFileSync(file, "utf-8");
             const parsed = $parse(raw);
             const doc = OverlayDocSchema.parse(parsed);
             const title = deriveOverlayTitle(raw, basename(file));
@@ -12101,13 +12158,25 @@ function applyAgentOverlays(config) {
     }
     try {
       const skillsDir = overlayDirFor(agentName, "skills.d");
-      const skillFiles = listYamlFiles(skillsDir);
+      const skillFiles = listYamlFiles(skillsDir, (code) => {
+        const w = {
+          agent: agentName,
+          file: skillsDir,
+          reason: `read error: cannot list overlay directory (${code})`,
+          code
+        };
+        recordReadFailure(agentCfg, { file: skillsDir, code, source: "skills" });
+        warnings.push(w);
+        console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${skillsDir}': ${w.reason}`);
+      });
       if (skillFiles.length === 0) {} else {
         const merged = [...agentCfg.skills ?? []];
         const seen = new Set(merged);
         for (const file of skillFiles) {
+          const raw = readOverlayFile(agentName, file, agentCfg, warnings, "skills");
+          if (raw === undefined)
+            continue;
           try {
-            const raw = readFileSync(file, "utf-8");
             const parsed = $parse(raw);
             const doc = OverlayDocSchema.parse(parsed);
             for (const skillName of doc.skills ?? []) {
@@ -13975,7 +14044,8 @@ var MarkThrottledRequestSchema = exports_external.object({
   v: exports_external.literal(PROTOCOL_VERSION),
   op: exports_external.literal("mark-throttled"),
   id: exports_external.string().min(1),
-  until: exports_external.number().int().positive()
+  until: exports_external.number().int().positive(),
+  probeOnly: exports_external.boolean().optional()
 });
 var RefreshAccountRequestSchema = exports_external.object({
   v: exports_external.literal(PROTOCOL_VERSION),
@@ -14392,12 +14462,13 @@ class AuthBrokerClient {
     const data = await this.send(req);
     return data;
   }
-  async markThrottled(until) {
+  async markThrottled(until, probeOnly = false) {
     const data = await this.send({
       v: PROTOCOL_VERSION,
       id: randomUUID(),
       op: "mark-throttled",
-      until
+      until,
+      ...probeOnly ? { probeOnly: true } : {}
     });
     return data;
   }
@@ -15264,6 +15335,17 @@ function createScheduleReloader(opts) {
     }
   };
 }
+function formatReadFailures(failures) {
+  return failures.map((f) => `${f.file} (${f.code})`).join(", ") + " — fix ownership/mode so the agent uid can read the file " + "(a root-euid writer leaves cron overlays root-owned 0600; " + "`switchroom apply` / a reconcile ownership sweep heals this)";
+}
+function loadAgentEntriesStrict(configPath, agentName) {
+  const config = loadConfig(configPath);
+  const failures = overlayReadFailures(config, agentName, "schedule");
+  if (failures.length > 0) {
+    throw new Error(`schedule.d overlay unreadable — refusing a reload that may be ` + `missing entries: ${formatReadFailures(failures)}`);
+  }
+  return collectScheduleEntries(config).filter((e) => e.agent === agentName);
+}
 function resolveReloadPollMs(env) {
   const raw = Number.parseInt(env.SWITCHROOM_SCHEDULER_RELOAD_POLL_MS ?? "", 10);
   return Number.isFinite(raw) && raw >= 1000 ? raw : 30000;
@@ -15303,6 +15385,11 @@ async function main() {
   const config = loadConfig(configPath);
   const allEntries = collectScheduleEntries(config);
   const entries = allEntries.filter((e) => e.agent === agentName);
+  const bootReadFailures = overlayReadFailures(config, agentName, "schedule");
+  if (bootReadFailures.length > 0) {
+    process.stderr.write(`agent-scheduler: ${agentName} WARNING: ${bootReadFailures.length} ` + `schedule.d overlay file(s) unreadable at boot — their cron entries ` + `are NOT registered: ${formatReadFailures(bootReadFailures)}
+`);
+  }
   const channel = resolveChannelTarget(config, agentName);
   if (channel === null) {
     process.stderr.write(`agent-scheduler: ${agentName} has no resolvable chat target ` + `(missing telegram.forum_chat_id) — exiting
@@ -15519,15 +15606,24 @@ Briefly and plainly tell the user these scheduled runs did not ` + "happen so th
   let reloader;
   let reloadTimer;
   if (isHotReloadEnabled(process.env)) {
+    let lastReloadError;
     reloader = createScheduleReloader({
-      loadEntries: () => collectScheduleEntries(loadConfig(configPath)).filter((e) => e.agent === agentName),
+      loadEntries: () => loadAgentEntriesStrict(configPath, agentName),
       register: registerForEntries,
       initialTasks: tasks,
       initialEntries: entries,
-      log: (m) => process.stdout.write(`agent-scheduler: ${agentName} ${m}
-`),
-      onError: (e) => process.stderr.write(`agent-scheduler: ${agentName} reload skipped (config error, keeping current schedule): ${e.message}
-`)
+      log: (m) => {
+        lastReloadError = undefined;
+        process.stdout.write(`agent-scheduler: ${agentName} ${m}
+`);
+      },
+      onError: (e) => {
+        if (e.message === lastReloadError)
+          return;
+        lastReloadError = e.message;
+        process.stderr.write(`agent-scheduler: ${agentName} reload skipped (config error, keeping current schedule): ${e.message}
+`);
+      }
     });
     reloadTimer = setInterval(() => reloader.tick(), resolveReloadPollMs(process.env));
   }
@@ -15560,6 +15656,7 @@ export {
   registerAgentSchedule,
   recoverPendingEscalations,
   main,
+  loadAgentEntriesStrict,
   isHotReloadEnabled,
   ipcDispatcher,
   createScheduleReloader

package/dist/auth-broker/index.js

@@ -12030,6 +12030,20 @@ var init_overlay_schema = __esm(() => {
 // src/config/overlay-loader.ts
 import { existsSync as existsSync2, readFileSync, readdirSync, statSync } from "node:fs";
 import { basename, resolve as resolve2 } from "node:path";
+function recordReadFailure(agentCfg, failure) {
+  const node = agentCfg;
+  const existing = node[OVERLAY_READ_FAILURES];
+  if (Array.isArray(existing)) {
+    existing.push(failure);
+    return;
+  }
+  Object.defineProperty(agentCfg, OVERLAY_READ_FAILURES, {
+    value: [failure],
+    enumerable: false,
+    configurable: true,
+    writable: false
+  });
+}
 function deriveOverlayTitle(raw, fileName) {
   const titleFromComment = raw.match(/^#[^\S\n]*name:[^\S\n]*(\S.*?)[^\S\n]*$/m)?.[1];
   if (titleFromComment)
@@ -12039,17 +12053,39 @@ function deriveOverlayTitle(raw, fileName) {
     return;
   return base.length > 0 ? base : undefined;
 }
+function readOverlayFile(agentName, file, agentCfg, warnings, source) {
+  try {
+    return readFileSync(file, "utf-8");
+  } catch (err) {
+    const code = err.code;
+    if (code === "ENOENT")
+      return;
+    const w = {
+      agent: agentName,
+      file,
+      reason: `read error: ${err.message}`,
+      code: code ?? "EUNKNOWN"
+    };
+    recordReadFailure(agentCfg, { file, code: w.code, source });
+    warnings.push(w);
+    console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${file}': ${w.reason}`);
+    return;
+  }
+}
 function overlayDirFor(agentName, subdir) {
   const base = resolveDualPath(`~/.switchroom/agents/${agentName}/${subdir}`);
   return resolve2(base);
 }
-function listYamlFiles(dir) {
+function listYamlFiles(dir, onUnreadableDir) {
   if (!existsSync2(dir))
     return [];
   let entries;
   try {
     entries = readdirSync(dir);
-  } catch {
+  } catch (err) {
+    const code = err.code;
+    if (code !== "ENOENT")
+      onUnreadableDir?.(code ?? "EUNKNOWN");
     return [];
   }
   const out = [];
@@ -12087,12 +12123,24 @@ function applyAgentOverlays(config) {
   for (const [agentName, agentCfg] of Object.entries(agents)) {
     try {
       const scheduleDir = overlayDirFor(agentName, "schedule.d");
-      const files = listYamlFiles(scheduleDir);
+      const files = listYamlFiles(scheduleDir, (code) => {
+        const w = {
+          agent: agentName,
+          file: scheduleDir,
+          reason: `read error: cannot list overlay directory (${code})`,
+          code
+        };
+        recordReadFailure(agentCfg, { file: scheduleDir, code, source: "schedule" });
+        warnings.push(w);
+        console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${scheduleDir}': ${w.reason}`);
+      });
       if (files.length > 0) {
         const merged = [...agentCfg.schedule ?? []];
         for (const file of files) {
+          const raw = readOverlayFile(agentName, file, agentCfg, warnings, "schedule");
+          if (raw === undefined)
+            continue;
           try {
-            const raw = readFileSync(file, "utf-8");
             const parsed = import_yaml.parse(raw);
             const doc = OverlayDocSchema.parse(parsed);
             const title = deriveOverlayTitle(raw, basename(file));
@@ -12127,13 +12175,25 @@ function applyAgentOverlays(config) {
     }
     try {
       const skillsDir = overlayDirFor(agentName, "skills.d");
-      const skillFiles = listYamlFiles(skillsDir);
+      const skillFiles = listYamlFiles(skillsDir, (code) => {
+        const w = {
+          agent: agentName,
+          file: skillsDir,
+          reason: `read error: cannot list overlay directory (${code})`,
+          code
+        };
+        recordReadFailure(agentCfg, { file: skillsDir, code, source: "skills" });
+        warnings.push(w);
+        console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${skillsDir}': ${w.reason}`);
+      });
       if (skillFiles.length === 0) {} else {
         const merged = [...agentCfg.skills ?? []];
         const seen = new Set(merged);
         for (const file of skillFiles) {
+          const raw = readOverlayFile(agentName, file, agentCfg, warnings, "skills");
+          if (raw === undefined)
+            continue;
           try {
-            const raw = readFileSync(file, "utf-8");
             const parsed = import_yaml.parse(raw);
             const doc = OverlayDocSchema.parse(parsed);
             for (const skillName of doc.skills ?? []) {
@@ -12161,7 +12221,7 @@ function applyAgentOverlays(config) {
   }
   return { config, warnings };
 }
-var import_yaml, OVERLAY_SOURCE, OVERLAY_TITLE;
+var import_yaml, OVERLAY_SOURCE, OVERLAY_TITLE, OVERLAY_READ_FAILURES;
 var init_overlay_loader = __esm(() => {
   init_zod();
   init_overlay_schema();
@@ -12169,6 +12229,7 @@ var init_overlay_loader = __esm(() => {
   import_yaml = __toESM(require_dist(), 1);
   OVERLAY_SOURCE = Symbol.for("switchroom.config.overlay-source");
   OVERLAY_TITLE = Symbol.for("switchroom.config.overlay-title");
+  OVERLAY_READ_FAILURES = Symbol.for("switchroom.config.overlay-read-failures");
 });
 
 // src/config/merge.ts
@@ -21225,7 +21286,8 @@ var MarkThrottledRequestSchema = exports_external.object({
   v: exports_external.literal(PROTOCOL_VERSION),
   op: exports_external.literal("mark-throttled"),
   id: exports_external.string().min(1),
-  until: exports_external.number().int().positive()
+  until: exports_external.number().int().positive(),
+  probeOnly: exports_external.boolean().optional()
 });
 var RefreshAccountRequestSchema = exports_external.object({
   v: exports_external.literal(PROTOCOL_VERSION),
@@ -21507,8 +21569,8 @@ var AUTH_BROKER_ROOT2 = "/run/switchroom/auth-broker";
 var REFRESH_TICK_INTERVAL_MS = 60 * 1000;
 var MARK_EXHAUSTED_DEFAULT_MS = 5 * 60 * 60 * 1000;
 var MARK_THROTTLED_MAX_MS = 30 * 60 * 1000;
-var THROTTLE_ESCALATION_HITS = 3;
 var THROTTLE_ESCALATION_WINDOW_MS = 10 * 60 * 1000;
+var THROTTLE_ESCALATION_PROBE_MIN_INTERVAL_MS = 60 * 1000;
 var MARK_THROTTLED_MIN_INTERVAL_MS = 5 * 1000;
 var MARK_CORROBORATION_PROBE_DELAY_MS = 90 * 1000;
 var AUDIT_ROTATE_BYTES = 10 * 1024 * 1024;
@@ -21602,6 +21664,7 @@ class AuthBroker {
   externalSpendCache = null;
   externalSpendInFlight = null;
   probeInFlight = new Map;
+  lastEscalationProbeAt = {};
   shaIndex = {};
   thresholdViolations = {};
   notificationClaims = {};
@@ -21986,7 +22049,7 @@ class AuthBroker {
           await this.opMarkExhausted(socket, reqId, identity, req.until);
           break;
         case "mark-throttled":
-          await this.opMarkThrottled(socket, reqId, identity, req.until);
+          await this.opMarkThrottled(socket, reqId, identity, req.until, req.probeOnly);
           break;
         case "refresh-account": {
           const provider = req.provider ?? "anthropic";
@@ -22818,7 +22881,7 @@ class AuthBroker {
     this.audit({ op: "mark-exhausted", identity, account, accountKind: "claude", ok: true });
     socket.write(encodeSuccess(id, { account, rolled, rolledTo }));
   }
-  async opMarkThrottled(socket, id, identity, until) {
+  async opMarkThrottled(socket, id, identity, until, probeOnly = false) {
     const account = this.callerAccount(identity);
     if (!account) {
       this.audit({ op: "mark-throttled", identity, accountKind: "claude", ok: false, error: "no-active-account" });
@@ -22826,6 +22889,17 @@ class AuthBroker {
       return;
     }
     const now = this.now();
+    if (probeOnly) {
+      const { escalated: escalated2, rolledTo: rolledTo2 } = await this.maybeEscalateThrottle(account, identity, now);
+      this.audit({ op: "mark-throttled", identity, account, accountKind: "claude", ok: true });
+      socket.write(encodeSuccess(id, {
+        account,
+        throttled_until: this.quota[account]?.throttled_until ?? 0,
+        escalated: escalated2,
+        rolledTo: escalated2 ? rolledTo2 : null
+      }));
+      return;
+    }
     const throttledUntil = Math.min(Math.max(until, now + 1000), now + MARK_THROTTLED_MAX_MS);
     const entry = this.quota[account] ?? {};
     const priorHits = entry.throttle_hits ?? [];
@@ -22847,31 +22921,19 @@ class AuthBroker {
     }
     const hits = priorHits.filter((t) => now - t < THROTTLE_ESCALATION_WINDOW_MS);
     hits.push(now);
-    const escalate = hits.length >= THROTTLE_ESCALATION_HITS;
     this.quota[account] = {
       ...entry,
       throttled_until: throttledUntil,
-      throttle_hits: escalate ? [] : hits
+      throttle_hits: hits
     };
     this.persistQuota();
     this.audit({ op: "mark-throttled", identity, account, accountKind: "claude", ok: true });
-    process.stdout.write(`auth-broker: mark-throttled ${account} until ${new Date(throttledUntil).toISOString()} ` + `(hit ${hits.length}/${THROTTLE_ESCALATION_HITS} in window)
-`);
-    let escalated = false;
-    let rolledTo = null;
-    if (escalate) {
-      const probe = await this.probeThrottleEscalation(account);
-      if (probe.exhausted) {
-        escalated = true;
-        process.stdout.write(`auth-broker: throttle-escalation probe corroborates wall on ${account} — mark-exhausted + roll
-`);
-        this.audit({ op: "mark-exhausted", identity, account, accountKind: "claude", ok: true, reason: "throttle-escalation" });
-        const roll = await this.markExhaustedAndRoll(account, probe.until ?? undefined, identity);
-        rolledTo = roll.rolledTo;
-      } else {
-        process.stdout.write(`auth-broker: throttle-escalation probe on ${account} did NOT corroborate a wall — staying throttled
+    process.stdout.write(`auth-broker: mark-throttled ${account} until ${new Date(throttledUntil).toISOString()} ` + `(hit ${hits.length} in window)
 `);
-      }
+    const { escalated, rolledTo } = await this.maybeEscalateThrottle(account, identity, now);
+    if (escalated) {
+      this.quota[account] = { ...this.quota[account], throttle_hits: [] };
+      this.persistQuota();
     }
     socket.write(encodeSuccess(id, {
       account,
@@ -22880,6 +22942,27 @@ class AuthBroker {
       rolledTo: escalated ? rolledTo : null
     }));
   }
+  async maybeEscalateThrottle(account, identity, now) {
+    const lastProbeAt = this.lastEscalationProbeAt[account];
+    const probeAllowed = lastProbeAt === undefined || now - lastProbeAt >= THROTTLE_ESCALATION_PROBE_MIN_INTERVAL_MS;
+    if (!probeAllowed) {
+      process.stdout.write(`auth-broker: throttle-escalation probe on ${account} rate-bounded — skipped
+`);
+      return { escalated: false, rolledTo: null };
+    }
+    this.lastEscalationProbeAt[account] = now;
+    const probe = await this.probeThrottleEscalation(account);
+    if (!probe.exhausted) {
+      process.stdout.write(`auth-broker: throttle-escalation probe on ${account} did NOT corroborate a wall — staying put
+`);
+      return { escalated: false, rolledTo: null };
+    }
+    process.stdout.write(`auth-broker: throttle-escalation probe corroborates wall on ${account} — mark-exhausted + roll
+`);
+    this.audit({ op: "mark-exhausted", identity, account, accountKind: "claude", ok: true, reason: "throttle-escalation" });
+    const roll = await this.markExhaustedAndRoll(account, probe.until ?? undefined, identity);
+    return { escalated: true, rolledTo: roll.rolledTo };
+  }
   async probeThrottleEscalation(account) {
     const creds = readAccountCredentials(account, this.home);
     const token = creds?.claudeAiOauth?.accessToken;
@@ -22887,7 +22970,7 @@ class AuthBroker {
       return { exhausted: false, until: null };
     let result;
     try {
-      result = await this.fetchQuotaImpl({ accessToken: token });
+      result = await this.probeQuotaSingleFlight(account, token);
     } catch (err) {
       this.logErr(`throttle-escalation probe ${account}: ${err.message}`);
       return { exhausted: false, until: null };

package/dist/cli/autoaccept-poll.js

@@ -4958,7 +4958,8 @@ var MarkThrottledRequestSchema = exports_external.object({
   v: exports_external.literal(PROTOCOL_VERSION),
   op: exports_external.literal("mark-throttled"),
   id: exports_external.string().min(1),
-  until: exports_external.number().int().positive()
+  until: exports_external.number().int().positive(),
+  probeOnly: exports_external.boolean().optional()
 });
 var RefreshAccountRequestSchema = exports_external.object({
   v: exports_external.literal(PROTOCOL_VERSION),
@@ -5375,12 +5376,13 @@ class AuthBrokerClient {
     const data = await this.send(req);
     return data;
   }
-  async markThrottled(until) {
+  async markThrottled(until, probeOnly = false) {
     const data = await this.send({
       v: PROTOCOL_VERSION,
       id: randomUUID2(),
       op: "mark-throttled",
-      until
+      until,
+      ...probeOnly ? { probeOnly: true } : {}
     });
     return data;
   }

package/dist/cli/drive-write-pretool.mjs

@@ -4034,7 +4034,8 @@ var init_protocol = __esm(() => {
     v: exports_external.literal(PROTOCOL_VERSION),
     op: exports_external.literal("mark-throttled"),
     id: exports_external.string().min(1),
-    until: exports_external.number().int().positive()
+    until: exports_external.number().int().positive(),
+    probeOnly: exports_external.boolean().optional()
   });
   RefreshAccountRequestSchema = exports_external.object({
     v: exports_external.literal(PROTOCOL_VERSION),
@@ -4430,12 +4431,13 @@ class AuthBrokerClient {
     const data = await this.send(req);
     return data;
   }
-  async markThrottled(until) {
+  async markThrottled(until, probeOnly = false) {
     const data = await this.send({
       v: PROTOCOL_VERSION,
       id: randomUUID(),
       op: "mark-throttled",
-      until
+      until,
+      ...probeOnly ? { probeOnly: true } : {}
     });
     return data;
   }

package/dist/cli/ms-365-write-pretool.mjs

@@ -4036,7 +4036,8 @@ var init_protocol = __esm(() => {
     v: exports_external.literal(PROTOCOL_VERSION),
     op: exports_external.literal("mark-throttled"),
     id: exports_external.string().min(1),
-    until: exports_external.number().int().positive()
+    until: exports_external.number().int().positive(),
+    probeOnly: exports_external.boolean().optional()
   });
   RefreshAccountRequestSchema = exports_external.object({
     v: exports_external.literal(PROTOCOL_VERSION),
@@ -4432,12 +4433,13 @@ class AuthBrokerClient {
     const data = await this.send(req);
     return data;
   }
-  async markThrottled(until) {
+  async markThrottled(until, probeOnly = false) {
     const data = await this.send({
       v: PROTOCOL_VERSION,
       id: randomUUID(),
       op: "mark-throttled",
-      until
+      until,
+      ...probeOnly ? { probeOnly: true } : {}
     });
     return data;
   }

package/dist/cli/notion-write-pretool.mjs

@@ -12767,6 +12767,21 @@ var OverlayDocSchema = exports_external.object({
 // src/config/overlay-loader.ts
 var OVERLAY_SOURCE = Symbol.for("switchroom.config.overlay-source");
 var OVERLAY_TITLE = Symbol.for("switchroom.config.overlay-title");
+var OVERLAY_READ_FAILURES = Symbol.for("switchroom.config.overlay-read-failures");
+function recordReadFailure(agentCfg, failure) {
+  const node = agentCfg;
+  const existing = node[OVERLAY_READ_FAILURES];
+  if (Array.isArray(existing)) {
+    existing.push(failure);
+    return;
+  }
+  Object.defineProperty(agentCfg, OVERLAY_READ_FAILURES, {
+    value: [failure],
+    enumerable: false,
+    configurable: true,
+    writable: false
+  });
+}
 function deriveOverlayTitle(raw, fileName) {
   const titleFromComment = raw.match(/^#[^\S\n]*name:[^\S\n]*(\S.*?)[^\S\n]*$/m)?.[1];
   if (titleFromComment)
@@ -12776,17 +12791,39 @@ function deriveOverlayTitle(raw, fileName) {
     return;
   return base.length > 0 ? base : undefined;
 }
+function readOverlayFile(agentName, file, agentCfg, warnings, source) {
+  try {
+    return readFileSync(file, "utf-8");
+  } catch (err) {
+    const code = err.code;
+    if (code === "ENOENT")
+      return;
+    const w = {
+      agent: agentName,
+      file,
+      reason: `read error: ${err.message}`,
+      code: code ?? "EUNKNOWN"
+    };
+    recordReadFailure(agentCfg, { file, code: w.code, source });
+    warnings.push(w);
+    console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${file}': ${w.reason}`);
+    return;
+  }
+}
 function overlayDirFor(agentName, subdir) {
   const base = resolveDualPath(`~/.switchroom/agents/${agentName}/${subdir}`);
   return resolve2(base);
 }
-function listYamlFiles(dir) {
+function listYamlFiles(dir, onUnreadableDir) {
   if (!existsSync2(dir))
     return [];
   let entries;
   try {
     entries = readdirSync(dir);
-  } catch {
+  } catch (err) {
+    const code = err.code;
+    if (code !== "ENOENT")
+      onUnreadableDir?.(code ?? "EUNKNOWN");
     return [];
   }
   const out = [];
@@ -12824,12 +12861,24 @@ function applyAgentOverlays(config) {
   for (const [agentName, agentCfg] of Object.entries(agents)) {
     try {
       const scheduleDir = overlayDirFor(agentName, "schedule.d");
-      const files = listYamlFiles(scheduleDir);
+      const files = listYamlFiles(scheduleDir, (code) => {
+        const w = {
+          agent: agentName,
+          file: scheduleDir,
+          reason: `read error: cannot list overlay directory (${code})`,
+          code
+        };
+        recordReadFailure(agentCfg, { file: scheduleDir, code, source: "schedule" });
+        warnings.push(w);
+        console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${scheduleDir}': ${w.reason}`);
+      });
       if (files.length > 0) {
         const merged = [...agentCfg.schedule ?? []];
         for (const file of files) {
+          const raw = readOverlayFile(agentName, file, agentCfg, warnings, "schedule");
+          if (raw === undefined)
+            continue;
           try {
-            const raw = readFileSync(file, "utf-8");
             const parsed = $parse(raw);
             const doc = OverlayDocSchema.parse(parsed);
             const title = deriveOverlayTitle(raw, basename(file));
@@ -12864,13 +12913,25 @@ function applyAgentOverlays(config) {
     }
     try {
       const skillsDir = overlayDirFor(agentName, "skills.d");
-      const skillFiles = listYamlFiles(skillsDir);
+      const skillFiles = listYamlFiles(skillsDir, (code) => {
+        const w = {
+          agent: agentName,
+          file: skillsDir,
+          reason: `read error: cannot list overlay directory (${code})`,
+          code
+        };
+        recordReadFailure(agentCfg, { file: skillsDir, code, source: "skills" });
+        warnings.push(w);
+        console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${skillsDir}': ${w.reason}`);
+      });
       if (skillFiles.length === 0) {} else {
         const merged = [...agentCfg.skills ?? []];
         const seen = new Set(merged);
         for (const file of skillFiles) {
+          const raw = readOverlayFile(agentName, file, agentCfg, warnings, "skills");
+          if (raw === undefined)
+            continue;
           try {
-            const raw = readFileSync(file, "utf-8");
             const parsed = $parse(raw);
             const doc = OverlayDocSchema.parse(parsed);
             for (const skillName of doc.skills ?? []) {