switchroom 0.15.41 → 0.15.42

package/dist/agent-scheduler/index.js

@@ -11114,7 +11114,8 @@ var SubagentSchema = exports_external.object({
 var SessionSchema = exports_external.object({
   max_idle: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '2h', '30m')").optional().describe("Start a fresh session if the previous one has been idle " + "longer than this duration. Examples: '2h', '30m', '7200s'."),
   max_turns: exports_external.number().int().positive().optional().describe("Start a fresh session if the previous one has more user " + "turns than this. Useful for preventing context bloat on " + "long-running agents."),
-  max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context.")
+  max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context."),
+  idle_clear_after: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '3h', '90m')").optional().describe("Auto-run /clear (wipe the working context) after the live " + "session has been idle this long. Defaults to '3h' when unset " + "(on by default); set '0s' to disable. Long-term memory lives " + "in Hindsight, so a clear loses only the in-session thread.")
 }).optional();
 var SessionContinuitySchema = exports_external.object({
   enabled: exports_external.boolean().optional().describe("Master switch for the session-handoff briefing (default true)."),

package/dist/auth-broker/index.js

@@ -11114,7 +11114,8 @@ var SubagentSchema = exports_external.object({
 var SessionSchema = exports_external.object({
   max_idle: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '2h', '30m')").optional().describe("Start a fresh session if the previous one has been idle " + "longer than this duration. Examples: '2h', '30m', '7200s'."),
   max_turns: exports_external.number().int().positive().optional().describe("Start a fresh session if the previous one has more user " + "turns than this. Useful for preventing context bloat on " + "long-running agents."),
-  max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context.")
+  max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context."),
+  idle_clear_after: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '3h', '90m')").optional().describe("Auto-run /clear (wipe the working context) after the live " + "session has been idle this long. Defaults to '3h' when unset " + "(on by default); set '0s' to disable. Long-term memory lives " + "in Hindsight, so a clear loses only the in-session thread.")
 }).optional();
 var SessionContinuitySchema = exports_external.object({
   enabled: exports_external.boolean().optional().describe("Master switch for the session-handoff briefing (default true)."),

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

@@ -11862,7 +11862,8 @@ var SubagentSchema = exports_external.object({
 var SessionSchema = exports_external.object({
   max_idle: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '2h', '30m')").optional().describe("Start a fresh session if the previous one has been idle " + "longer than this duration. Examples: '2h', '30m', '7200s'."),
   max_turns: exports_external.number().int().positive().optional().describe("Start a fresh session if the previous one has more user " + "turns than this. Useful for preventing context bloat on " + "long-running agents."),
-  max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context.")
+  max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context."),
+  idle_clear_after: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '3h', '90m')").optional().describe("Auto-run /clear (wipe the working context) after the live " + "session has been idle this long. Defaults to '3h' when unset " + "(on by default); set '0s' to disable. Long-term memory lives " + "in Hindsight, so a clear loses only the in-session thread.")
 }).optional();
 var SessionContinuitySchema = exports_external.object({
   enabled: exports_external.boolean().optional().describe("Master switch for the session-handoff briefing (default true)."),

package/dist/cli/switchroom.js

@@ -13678,7 +13678,8 @@ var init_schema = __esm(() => {
   SessionSchema = exports_external.object({
     max_idle: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '2h', '30m')").optional().describe("Start a fresh session if the previous one has been idle " + "longer than this duration. Examples: '2h', '30m', '7200s'."),
     max_turns: exports_external.number().int().positive().optional().describe("Start a fresh session if the previous one has more user " + "turns than this. Useful for preventing context bloat on " + "long-running agents."),
-    max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context.")
+    max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context."),
+    idle_clear_after: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '3h', '90m')").optional().describe("Auto-run /clear (wipe the working context) after the live " + "session has been idle this long. Defaults to '3h' when unset " + "(on by default); set '0s' to disable. Long-term memory lives " + "in Hindsight, so a clear loses only the in-session thread.")
   }).optional();
   SessionContinuitySchema = exports_external.object({
     enabled: exports_external.boolean().optional().describe("Master switch for the session-handoff briefing (default true)."),
@@ -31678,6 +31679,46 @@ async function runMcpSecretChecks(config, deps = {}) {
   return results;
 }
 
+// src/cli/doctor-context.ts
+function fmtK(n) {
+  return n >= 1000 ? `${(n / 1000).toFixed(n >= 1e4 ? 0 : 1)}k` : `${n}`;
+}
+function contextRow(agent, read) {
+  const name = `context:${agent}`;
+  if (read.kind === "absent") {
+    return { name, status: "skip", detail: "no snapshot yet (agent idle since boot, or stopped)" };
+  }
+  if (read.kind === "unreadable") {
+    return { name, status: "skip", detail: read.msg };
+  }
+  const s = read.snapshot;
+  if (s.state === "unknown") {
+    return { name, status: "skip", detail: "occupancy not yet measured" };
+  }
+  if (s.cap == null || s.pct == null) {
+    return { name, status: "ok", detail: `${fmtK(s.occupancy)} tok (no cap \u2014 native compaction)` };
+  }
+  const pctLabel = `${Math.round(s.pct * 100)}%`;
+  const detail = `${fmtK(s.occupancy)}/${fmtK(s.cap)} (${pctLabel})`;
+  if (s.state === "tight") {
+    return {
+      name,
+      status: "warn",
+      detail: `${detail} \u2014 tight; a /compact is near`,
+      fix: `Working context is ${pctLabel} of the cap. Normal if mid-large-task (it compacts automatically); if persistent, consider raising session.max_context_tokens or trimming this agent's tool/prose surface.`
+    };
+  }
+  return { name, status: "ok", detail };
+}
+async function runContextChecks(config, deps = {}) {
+  const agents = Object.keys(config.agents ?? {});
+  if (agents.length === 0)
+    return [];
+  const read = deps.readSnapshot ?? (async () => ({ kind: "absent" }));
+  const results = await Promise.all(agents.sort().map(async (a) => contextRow(a, await read(a))));
+  return results;
+}
+
 // src/cli/doctor-credentials-migration.ts
 import {
   existsSync as realExistsSync5,
@@ -34082,6 +34123,24 @@ function registerDoctorCommand(program3) {
         title: "MCP Connections (auth)",
         results: await runMcpSecretChecks(config, { vaultAclReader })
       },
+      {
+        title: "Context Headroom",
+        results: await runContextChecks(config, {
+          readSnapshot: async (agent) => {
+            try {
+              const { execFileSync: execFileSync19 } = await import("node:child_process");
+              const out = execFileSync19("docker", ["exec", `switchroom-${agent}`, "cat", "/state/agent/context-occupancy.json"], { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"], timeout: 5000 });
+              return { kind: "ok", snapshot: JSON.parse(out) };
+            } catch (err) {
+              const msg = err.message ?? String(err);
+              if (/No such|cannot|not running|exited|No such container/i.test(msg)) {
+                return { kind: "absent" };
+              }
+              return { kind: "unreadable", msg: `snapshot read failed: ${msg}` };
+            }
+          }
+        })
+      },
       { title: "MFF Skill", results: await checkMff(passphrase, vaultPath, config) },
       { title: "Webkite", results: runWebkiteChecks(config) },
       { title: "Cron Session", results: runCronSessionChecks(config) }
@@ -50708,8 +50767,8 @@ import { existsSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 
 // src/build-info.ts
-var VERSION = "0.15.41";
-var COMMIT_SHA = "01f41098";
+var VERSION = "0.15.42";
+var COMMIT_SHA = "2c7e12da";
 
 // src/cli/resolve-version.ts
 function readPackageVersion() {
@@ -68965,6 +69024,29 @@ function stopHindsight() {
     execFileSync16("docker", ["rm", "switchroom-hindsight"], { stdio: "pipe" });
   } catch {}
 }
+function pullHindsightImage() {
+  execFileSync16("docker", ["pull", HINDSIGHT_IMAGE], { stdio: "inherit" });
+}
+function getRunningHindsightPorts() {
+  const readPort = (containerPort) => {
+    try {
+      const out = execFileSync16("docker", ["port", "switchroom-hindsight", `${containerPort}/tcp`], { stdio: "pipe", encoding: "utf-8" });
+      const m = out.split(`
+`).map((l) => l.trim()).find((l) => l.length > 0);
+      if (!m)
+        return null;
+      const port = Number(m.slice(m.lastIndexOf(":") + 1));
+      return Number.isInteger(port) && port > 0 ? port : null;
+    } catch {
+      return null;
+    }
+  };
+  const apiPort = readPort(HINDSIGHT_DEFAULT_API_PORT);
+  if (apiPort === null)
+    return null;
+  const uiPort = readPort(HINDSIGHT_DEFAULT_UI_PORT) ?? (apiPort === HINDSIGHT_DEFAULT_API_PORT ? HINDSIGHT_DEFAULT_UI_PORT : 19999);
+  return { apiPort, uiPort };
+}
 function getHindsightStatus() {
   try {
     const output = execFileSync16("docker", ["ps", "-a", "--filter", "name=switchroom-hindsight", "--format", "{{.Status}}"], { stdio: "pipe", encoding: "utf-8" });
@@ -69195,7 +69277,7 @@ Cross-agent reflection plan
     }
     console.log();
   }));
-  memory.command("setup").description("Manage the Hindsight Docker container").option("--stop", "Stop and remove the Hindsight container").option("--status", "Show Hindsight container status").option("--provider <provider>", "LLM provider (ollama, openai, anthropic)").action(async (opts) => {
+  memory.command("setup").description("Manage the Hindsight Docker container").option("--stop", "Stop and remove the Hindsight container").option("--status", "Show Hindsight container status").option("--recreate", "Pull the latest image and recreate the container (reusing its current port). Used by `switchroom update` to keep the hindsight singleton current.").option("--provider <provider>", "LLM provider (ollama, openai, anthropic)").action(async (opts) => {
     if (opts.status) {
       if (!isDockerAvailable()) {
         console.log(source_default.red("  Docker is not available."));
@@ -69236,24 +69318,41 @@ Cross-agent reflection plan
 `));
       process.exit(1);
     }
-    if (isHindsightRunning()) {
+    const recreate = opts.recreate === true;
+    const reusePorts = recreate ? getRunningHindsightPorts() : null;
+    if (isHindsightRunning() && !recreate) {
       console.log(source_default.green(`
   Hindsight container is already running (switchroom-hindsight).
 `));
       return;
     }
+    if (recreate) {
+      console.log(source_default.gray("  Pulling latest Hindsight image..."));
+      try {
+        pullHindsightImage();
+      } catch (err) {
+        console.error(source_default.red(`
+  Failed to pull Hindsight image: ${err.message}
+`));
+        process.exit(1);
+      }
+    }
     if (isHindsightContainerExists()) {
-      console.log(source_default.gray("  Removing stopped switchroom-hindsight container..."));
+      console.log(source_default.gray("  Removing existing switchroom-hindsight container..."));
       stopHindsight();
     }
     let ports;
-    try {
-      ports = await pickHindsightPorts();
-    } catch (err) {
-      console.error(source_default.red(`
+    if (reusePorts) {
+      ports = reusePorts;
+    } else {
+      try {
+        ports = await pickHindsightPorts();
+      } catch (err) {
+        console.error(source_default.red(`
   ${err.message}
 `));
-      process.exit(1);
+        process.exit(1);
+      }
     }
     if (ports.apiPort !== HINDSIGHT_DEFAULT_API_PORT) {
       console.log(source_default.yellow(`  Port ${HINDSIGHT_DEFAULT_API_PORT} is already in use; ` + `using ${ports.apiPort}/${ports.uiPort} instead.`));
@@ -74629,6 +74728,17 @@ var DASHBOARD_CACHE_TTL = {
   approvals: 15000,
   grants: 15000
 };
+function readContextOccupancy(agentsDir, name) {
+  try {
+    const raw = readFileSync44(resolve28(agentsDir, name, "context-occupancy.json"), "utf-8");
+    const s = JSON.parse(raw);
+    if (typeof s?.occupancy !== "number")
+      return null;
+    return s;
+  } catch {
+    return null;
+  }
+}
 function readLastTurnAt(agentsDir, name) {
   try {
     const db = openTurnsDb(resolve28(agentsDir, name));
@@ -74663,6 +74773,7 @@ async function cachedFleetStatus(now, fetchImpl = fetchFleetStatusViaHostd) {
 }
 async function handleGetAgents(config, deps = {}) {
   const readLastTurn = deps.readLastTurn ?? readLastTurnAt;
+  const readContext = deps.readContext ?? readContextOccupancy;
   const statuses = getAllAgentStatuses(config);
   const authStatuses = getAllAuthStatuses(config);
   const agentsDir = resolveAgentsDir(config);
@@ -74695,7 +74806,8 @@ async function handleGetAgents(config, deps = {}) {
         expiresAt: auth?.expiresAt
       },
       memoryCollection: collection,
-      lastTurnAt: readLastTurn(agentsDir, name)
+      lastTurnAt: readLastTurn(agentsDir, name),
+      context: readContext(agentsDir, name)
     });
   }
   return agents;
@@ -78047,6 +78159,26 @@ function planUpdate(opts) {
         throw new Error("switchroom webd install failed");
     }
   });
+  let memoryBackendHindsight;
+  if (typeof opts.memoryBackendHindsight === "boolean") {
+    memoryBackendHindsight = opts.memoryBackendHindsight;
+  } else {
+    try {
+      memoryBackendHindsight = loadConfig().memory?.backend === "hindsight";
+    } catch {
+      memoryBackendHindsight = false;
+    }
+  }
+  steps.push({
+    name: "refresh-hindsight",
+    description: "switchroom memory setup --recreate \u2014 pull latest hindsight image + recreate the memory singleton (standalone container, reusing its current port)",
+    skipReason: !memoryBackendHindsight ? "memory.backend is not hindsight \u2014 no hindsight singleton to refresh" : opts.skipImages ? "--skip-images flag set" : undefined,
+    run: () => {
+      const r = runner(process.execPath, [scriptPath, "memory", "setup", "--recreate"]);
+      if (r.status !== 0)
+        throw new Error("switchroom memory setup --recreate failed");
+    }
+  });
   steps.push({
     name: "sync-bundled-skills",
     description: "Sync shipped skills/ to ~/.switchroom/skills/_bundled/ (host-stable pool dir).",

package/dist/cli/ui/index.html

@@ -122,6 +122,15 @@
 
     .meta-item span { color: var(--text); }
 
+    /* Context-headroom gauge (RFC context-headroom-surface). */
+    .ctx-gauge { display: inline-flex; align-items: center; gap: 0.4rem; }
+    .ctx-text { color: var(--text); font-variant-numeric: tabular-nums; }
+    .ctx-bar {
+      display: inline-block; width: 48px; height: 6px; border-radius: 3px;
+      background: var(--bg-dim, rgba(255,255,255,0.12)); overflow: hidden;
+    }
+    .ctx-fill { display: block; height: 100%; border-radius: 3px; }
+
     .scope-toggle {
       cursor: pointer;
       color: var(--text);
@@ -1659,6 +1668,27 @@
       return 'inactive';
     }
 
+    // Context-headroom gauge (RFC context-headroom-surface): occupancy/cap
+    // with a fill bar, amber when tight (≥80%). '—' when no snapshot yet.
+    function fmtTok(n) {
+      return n >= 1000 ? (n / 1000).toFixed(n >= 10000 ? 0 : 1) + 'k' : String(n);
+    }
+    function formatContext(ctx) {
+      if (!ctx || ctx.state === 'unknown' || typeof ctx.occupancy !== 'number') {
+        return '<span style="color:var(--text-dim)">—</span>';
+      }
+      if (ctx.cap == null || ctx.pct == null) {
+        return `<span>${fmtTok(ctx.occupancy)} <span style="color:var(--text-dim)">(no cap)</span></span>`;
+      }
+      const pct = Math.max(0, Math.min(1, ctx.pct));
+      const tight = ctx.state === 'tight';
+      const col = tight ? 'var(--amber, #d99)' : 'var(--green)';
+      return `<span class="ctx-gauge" title="${fmtTok(ctx.occupancy)} / ${fmtTok(ctx.cap)} tokens — ${Math.round(pct * 100)}% of cap${tight ? ' (tight — /compact near)' : ''}">`
+        + `<span class="ctx-text">${fmtTok(ctx.occupancy)}/${fmtTok(ctx.cap)} (${Math.round(pct * 100)}%)</span>`
+        + `<span class="ctx-bar"><span class="ctx-fill" style="width:${(pct * 100).toFixed(0)}%;background:${col}"></span></span>`
+        + `</span>`;
+    }
+
     function formatUptime(timestamp) {
       if (!timestamp) return '--';
       const d = new Date(timestamp);
@@ -1693,6 +1723,7 @@
             <div class="meta-item"><label>Uptime </label><span>${formatUptime(a.uptime)}</span></div>
             <div class="meta-item"><label>Mem </label><span>${a.memory || '--'}</span></div>
             <div class="meta-item"><label>Last turn </label><span>${a.lastTurnAt ? formatTimestamp(a.lastTurnAt) : '—'}</span></div>
+            <div class="meta-item meta-context"><label>Context </label>${formatContext(a.context)}</div>
             <div class="meta-item"><label>Profile </label><span>${escapeHtml(a.extends)}</span></div>
             <div class="meta-item"><label>Auth </label><span>${a.auth.authenticated ? '✓' : '✗'}</span></div>
             <div class="meta-item"><label>Account </label><span>${a.primaryAccount ? escapeHtml(a.primaryAccount) : '<span style="color:var(--text-dim)">default</span>'}</span></div>

package/dist/host-control/main.js

@@ -13849,7 +13849,8 @@ var SubagentSchema = exports_external.object({
 var SessionSchema = exports_external.object({
   max_idle: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '2h', '30m')").optional().describe("Start a fresh session if the previous one has been idle " + "longer than this duration. Examples: '2h', '30m', '7200s'."),
   max_turns: exports_external.number().int().positive().optional().describe("Start a fresh session if the previous one has more user " + "turns than this. Useful for preventing context bloat on " + "long-running agents."),
-  max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context.")
+  max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context."),
+  idle_clear_after: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '3h', '90m')").optional().describe("Auto-run /clear (wipe the working context) after the live " + "session has been idle this long. Defaults to '3h' when unset " + "(on by default); set '0s' to disable. Long-term memory lives " + "in Hindsight, so a clear loses only the in-session thread.")
 }).optional();
 var SessionContinuitySchema = exports_external.object({
   enabled: exports_external.boolean().optional().describe("Master switch for the session-handoff briefing (default true)."),

package/dist/vault/approvals/kernel-server.js

@@ -11457,7 +11457,8 @@ var init_schema = __esm(() => {
   SessionSchema = exports_external.object({
     max_idle: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '2h', '30m')").optional().describe("Start a fresh session if the previous one has been idle " + "longer than this duration. Examples: '2h', '30m', '7200s'."),
     max_turns: exports_external.number().int().positive().optional().describe("Start a fresh session if the previous one has more user " + "turns than this. Useful for preventing context bloat on " + "long-running agents."),
-    max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context.")
+    max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context."),
+    idle_clear_after: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '3h', '90m')").optional().describe("Auto-run /clear (wipe the working context) after the live " + "session has been idle this long. Defaults to '3h' when unset " + "(on by default); set '0s' to disable. Long-term memory lives " + "in Hindsight, so a clear loses only the in-session thread.")
   }).optional();
   SessionContinuitySchema = exports_external.object({
     enabled: exports_external.boolean().optional().describe("Master switch for the session-handoff briefing (default true)."),

package/dist/vault/broker/server.js

@@ -11457,7 +11457,8 @@ var init_schema = __esm(() => {
   SessionSchema = exports_external.object({
     max_idle: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '2h', '30m')").optional().describe("Start a fresh session if the previous one has been idle " + "longer than this duration. Examples: '2h', '30m', '7200s'."),
     max_turns: exports_external.number().int().positive().optional().describe("Start a fresh session if the previous one has more user " + "turns than this. Useful for preventing context bloat on " + "long-running agents."),
-    max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context.")
+    max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context."),
+    idle_clear_after: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '3h', '90m')").optional().describe("Auto-run /clear (wipe the working context) after the live " + "session has been idle this long. Defaults to '3h' when unset " + "(on by default); set '0s' to disable. Long-term memory lives " + "in Hindsight, so a clear loses only the in-session thread.")
   }).optional();
   SessionContinuitySchema = exports_external.object({
     enabled: exports_external.boolean().optional().describe("Master switch for the session-handoff briefing (default true)."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "switchroom",
-  "version": "0.15.41",
+  "version": "0.15.42",
   "description": "Run Claude Code 24/7 on your Claude Pro/Max subscription over Telegram. Open-source alternative to OpenClaw and NanoClaw — no API keys.",
   "type": "module",
   "bin": {