switchroom 0.19.40 → 0.19.42

package/dist/host-control/main.js

@@ -11116,6 +11116,7 @@ var init_schema = __esm(() => {
     auto_recall: exports_external.boolean().default(true).describe("Auto-search memories before each response"),
     file: exports_external.boolean().default(true).describe("Maintain a curated workspace MEMORY.md file (seeded once, " + "auto-loaded every turn). Set false for hindsight-only memory: " + "the file is not seeded or re-created, so once migrated into " + "Hindsight and deleted it stays gone. Recall + directives carry " + "the memory instead. Cascade: override (per-agent wins over default)."),
     isolation: exports_external.enum(["default", "strict"]).default("default").describe("strict = never shared cross-agent, default = eligible for reflect"),
+    profile: exports_external.string().optional().describe("Memory profile bank this agent's curated memory defaults key off — " + "the built-in disposition + observations_mission in PROFILE_MEMORY_DEFAULTS. " + "Decouples the memory profile from `extends` (the filesystem persona " + "profile), so an agent on `extends: default` can opt into the `coding` " + "memory bundle via `memory.profile: coding` without inheriting the coding " + "persona. Resolution: memory.profile → extends → DEFAULT_PROFILE (see " + "resolveMemoryProfile). Unset ⇒ byte-identical to keying off `extends`."),
     bank_mission: exports_external.string().optional().describe("Bank-level mission statement used during recall to contextualize " + "results. NOTE: this is an alias for the Hindsight engine's " + "`reflect_mission` field (verified live: switchroom's bank_mission " + "lands in `config.reflect_mission`). Prefer `reflect_mission` going " + "forward; `bank_mission` is retained for back-compat. If both are " + "set, `reflect_mission` wins. Cascade: override."),
     reflect_mission: exports_external.string().optional().describe("Mission/context steering Hindsight Reflect operations (the bank's " + "'who am I / what matters' framing applied during recall). The " + "engine-accurate name for what `bank_mission` sets. Cascade: override."),
     retain_mission: exports_external.string().optional().describe("Instructions for the fact extraction LLM during retain. Cascade: override."),
@@ -11409,6 +11410,8 @@ var init_schema = __esm(() => {
       provider: exports_external.string().min(1).optional().describe("Hindsight LLM provider (upstream `HINDSIGHT_API_LLM_PROVIDER`). " + "Defaults to `claude-code` (subscription-honest, broker-fed OAuth). " + "Any litellm-routable provider the upstream image supports is valid. " + "Serves as the GLOBAL default for every op absent a per-op override."),
       model: exports_external.string().min(1).optional().describe("Hindsight LLM model (upstream `HINDSIGHT_API_LLM_MODEL`). Defaults " + "to HINDSIGHT_DEFAULT_MODEL. Any model your LiteLLM proxy can route " + "is valid, e.g. `openrouter/z-ai/glm-5.2` when routing through the " + "fleet proxy. With provider=claude-code this value is ALSO exported " + "as `ANTHROPIC_MODEL` to the claude subprocess. Serves as the GLOBAL " + "default for every op absent a per-op override."),
       context_window: exports_external.number().int().positive().optional().describe("GLOBAL context window (tokens) of the backend serving hindsight's " + "LLM ops — the declared size switchroom derives every token budget " + "from. Set this to the real window of whatever you point " + "`hindsight.llm` at (e.g. 32768 for a llama.cpp slot launched with " + "`-c 65536 -np 2`, 131072 for a large-window OpenRouter model). " + "Absent → a per-provider default: 200000 for `claude-code`, a " + "conservative 32768 for everything else. Overflowing a local " + "backend's window does NOT error — llama.cpp context-shift silently " + "drops the system prompt and the model answers conversationally " + "with HTTP 200 — so this value is what makes the failure " + "detectable at setup time instead of never."),
+      base_url: exports_external.string().min(1).optional().describe("GLOBAL LLM base URL (upstream `HINDSIGHT_API_LLM_BASE_URL`). The " + "default endpoint every op inherits absent a per-op " + "`hindsight.llm.<op>.base_url`. Optional passthrough; unset → the " + "engine's provider default. When this points at host loopback the " + "hindsight container is forced onto host networking, same as a " + "per-op base URL, so the endpoint stays reachable (#3687)."),
+      api_key: exports_external.string().min(1).optional().describe("GLOBAL LLM API key (upstream `HINDSIGHT_API_LLM_API_KEY`). Literal " + "or `vault:` reference. The default credential every op inherits " + "absent a per-op `hindsight.llm.<op>.api_key`; the engine reads it as " + "a plain env fallback. Optional passthrough (#3687)."),
       retain: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `retain` LLM op (memory ingestion). Emits " + "`HINDSIGHT_API_RETAIN_LLM_*`. Absent → uses the global model/provider."),
       reflect: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `reflect` LLM op (synthesis / mental-model " + "refresh). Emits `HINDSIGHT_API_REFLECT_LLM_*`. Absent → uses global."),
       consolidation: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `consolidation` LLM op (background memory " + "merge). Emits `HINDSIGHT_API_CONSOLIDATION_LLM_*`. Absent → global.")
@@ -11545,6 +11548,7 @@ var init_schema = __esm(() => {
       auto_recall: exports_external.boolean().optional(),
       file: exports_external.boolean().optional(),
       isolation: exports_external.enum(["default", "strict"]).optional(),
+      profile: exports_external.string().optional(),
       directive_capture_nudge: exports_external.boolean().optional(),
       observation_scopes: ObservationScopesSchema,
       observation_scope_strategy: ObservationScopeStrategySchema,
@@ -11586,7 +11590,23 @@ var init_schema = __esm(() => {
         max_query_chars: exports_external.number().int().min(1).optional(),
         parallel: exports_external.boolean().optional(),
         additional_banks: exports_external.array(exports_external.string()).optional(),
-        sender_banks: exports_external.record(exports_external.string(), exports_external.string()).optional()
+        sender_banks: exports_external.record(exports_external.string(), exports_external.string()).optional(),
+        types: exports_external.array(exports_external.string()).optional(),
+        skip_trivial: exports_external.boolean().optional(),
+        topic_filter_mode: exports_external.enum(["soft-preamble", "hard-filter"]).optional()
+      }).optional(),
+      retain: exports_external.object({
+        every_n_turns: exports_external.number().int().min(1).optional(),
+        overlap_turns: exports_external.number().int().min(0).optional()
+      }).optional(),
+      bank_mission: exports_external.string().optional(),
+      reflect_mission: exports_external.string().optional(),
+      retain_mission: exports_external.string().optional(),
+      observations_mission: exports_external.string().optional(),
+      disposition: exports_external.object({
+        skepticism: exports_external.number().int().min(1).max(5).optional(),
+        literalism: exports_external.number().int().min(1).max(5).optional(),
+        empathy: exports_external.number().int().min(1).max(5).optional()
       }).optional()
     }).optional(),
     schedule: exports_external.array(ScheduleEntrySchema).optional(),
@@ -18753,11 +18773,11 @@ var init_protocol = __esm(() => {
     OkRevokeGrantResponseSchema,
     OkApprovalRequestResponseSchema,
     OkApprovalLookupResponseSchema,
+    OkApprovalConsumeRecordResponseSchema,
     OkApprovalConsumeResponseSchema,
     OkApprovalRevokeResponseSchema,
     OkApprovalListResponseSchema,
     OkApprovalRecordResponseSchema,
-    OkApprovalConsumeRecordResponseSchema,
     ErrorResponseSchema
   ]);
 });
@@ -21010,6 +21030,7 @@ function parsePendingRolloutMarker(raw) {
   if (o.allow_downgrade !== undefined && typeof o.allow_downgrade !== "boolean") {
     return null;
   }
+  const narrationIdValid = typeof o.narration_message_id === "number" && Number.isInteger(o.narration_message_id) && o.narration_message_id > 0;
   return {
     v: 1,
     request_id: o.request_id,
@@ -21017,6 +21038,7 @@ function parsePendingRolloutMarker(raw) {
     ...o.agents !== undefined ? { agents: o.agents } : {},
     ...o.skip_web !== undefined ? { skip_web: o.skip_web } : {},
     ...o.allow_downgrade !== undefined ? { allow_downgrade: o.allow_downgrade } : {},
+    ...narrationIdValid ? { narration_message_id: o.narration_message_id } : {},
     caller: caller.kind === "agent" ? { kind: "agent", name: caller.name } : { kind: "operator" },
     created_at: o.created_at,
     prior_hostd_version: o.prior_hostd_version
@@ -21320,7 +21342,7 @@ function allocateAgentUid(name) {
 }
 
 // src/build-info.ts
-var VERSION = "0.19.40";
+var VERSION = "0.19.42";
 
 // src/setup/hindsight-recall-tunables.ts
 var RECALL_DEADLINE_HEADROOM_SECONDS = 2;
@@ -30786,6 +30808,27 @@ class HostdServer {
       })
     };
   }
+  persistNarrationMessageId(requestId, messageId) {
+    try {
+      if (!Number.isInteger(messageId) || messageId <= 0)
+        return;
+      const markerPath = join13(this.hostdDirPath(), SELF_BUMP_MARKER_FILENAME);
+      if (!existsSync15(markerPath))
+        return;
+      const marker = parsePendingRolloutMarker(readFileSync11(markerPath, "utf8"));
+      if (!marker)
+        return;
+      if (marker.request_id !== requestId)
+        return;
+      const updated = {
+        ...marker,
+        narration_message_id: messageId
+      };
+      const tmp = `${markerPath}.tmp`;
+      writeFileSync6(tmp, encodePendingRolloutMarker(updated), { mode: 384 });
+      renameSync5(tmp, markerPath);
+    } catch {}
+  }
   async resumePendingSelfBumpRollout() {
     const markerPath = join13(this.hostdDirPath(), SELF_BUMP_MARKER_FILENAME);
     if (!existsSync15(markerPath))
@@ -30854,6 +30897,9 @@ class HostdServer {
       ...marker.skip_web ? { skip_web: true } : {},
       ...marker.allow_downgrade ? { allow_downgrade: true } : {}
     }, marker.request_id, caller, Date.now());
+    if (marker.narration_message_id !== undefined && caller.kind === "agent") {
+      this.rolloutNarrator?.seedPostedMessage?.(marker.request_id, caller.name, marker.narration_message_id);
+    }
     this.onRolloutPhase(entry, { phase: "self-bump-done", target: marker.pin });
   }
   async handleAgentStart(req, started) {
@@ -32672,28 +32718,49 @@ class LogTailRolloutNarrator {
       }
     }
   }
+  freshState(agentName, target) {
+    return {
+      agentName,
+      lastAppliedSeq: -1,
+      messageId: null,
+      posting: false,
+      postAttempts: 0,
+      postFailed: false,
+      render: { target },
+      agents: [],
+      singletons: initialSingletons(),
+      frozen: false,
+      timer: null,
+      pendingEditAfterPost: false
+    };
+  }
   ensureState(entry) {
     let st = this.states.get(entry.request_id);
     if (!st) {
       const agentName = entry.caller.kind === "agent" ? entry.caller.name : "";
-      st = {
-        agentName,
-        lastAppliedSeq: -1,
-        messageId: null,
-        posting: false,
-        postAttempts: 0,
-        postFailed: false,
-        render: { target: entry.pin ?? "" },
-        agents: [],
-        singletons: initialSingletons(),
-        frozen: false,
-        timer: null,
-        pendingEditAfterPost: false
-      };
+      st = this.freshState(agentName, entry.pin ?? "");
       this.states.set(entry.request_id, st);
     }
     return st;
   }
+  seedPostedMessage(requestId, agentName, messageId) {
+    const existing = this.states.get(requestId);
+    if (existing) {
+      if (existing.messageId === null) {
+        existing.messageId = messageId;
+        existing.posting = false;
+        existing.postFailed = false;
+        if (existing.postAttempts < 1)
+          existing.postAttempts = 1;
+        existing.pendingEditAfterPost = false;
+      }
+      return;
+    }
+    const st = this.freshState(agentName, "");
+    st.messageId = messageId;
+    st.postAttempts = 1;
+    this.states.set(requestId, st);
+  }
   scheduleRenderOrPost(requestId) {
     const st = this.states.get(requestId);
     if (!st)
@@ -32734,6 +32801,11 @@ class LogTailRolloutNarrator {
       }
       st.messageId = mid;
       st.postFailed = false;
+      try {
+        this.opts.onMessageId?.(requestId, mid);
+      } catch (e) {
+        this.opts.log?.(`onMessageId sink threw (non-fatal): ${e.message}`);
+      }
       if (st.pendingEditAfterPost) {
         st.pendingEditAfterPost = false;
         this.flush(requestId, false);
@@ -33378,8 +33450,11 @@ async function main() {
     resolveGatewaySocket,
     log: (m) => process.stderr.write(`hostd: rollout-narration — ${m}
 `)
-  }), { log: (m) => process.stderr.write(`hostd: rollout-narration — ${m}
-`) });
+  }), {
+    log: (m) => process.stderr.write(`hostd: rollout-narration — ${m}
+`),
+    onMessageId: (rid, mid) => server?.persistNarrationMessageId(rid, mid)
+  });
   const server = new HostdServer({
     homeDir: homedir8(),
     agentUids,

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

@@ -4407,11 +4407,11 @@ var init_protocol = __esm(() => {
     OkRevokeGrantResponseSchema,
     OkApprovalRequestResponseSchema,
     OkApprovalLookupResponseSchema,
+    OkApprovalConsumeRecordResponseSchema,
     OkApprovalConsumeResponseSchema,
     OkApprovalRevokeResponseSchema,
     OkApprovalListResponseSchema,
     OkApprovalRecordResponseSchema,
-    OkApprovalConsumeRecordResponseSchema,
     ErrorResponseSchema
   ]);
 });
@@ -4556,6 +4556,7 @@ var init_schema = __esm(() => {
     auto_recall: exports_external.boolean().default(true).describe("Auto-search memories before each response"),
     file: exports_external.boolean().default(true).describe("Maintain a curated workspace MEMORY.md file (seeded once, " + "auto-loaded every turn). Set false for hindsight-only memory: " + "the file is not seeded or re-created, so once migrated into " + "Hindsight and deleted it stays gone. Recall + directives carry " + "the memory instead. Cascade: override (per-agent wins over default)."),
     isolation: exports_external.enum(["default", "strict"]).default("default").describe("strict = never shared cross-agent, default = eligible for reflect"),
+    profile: exports_external.string().optional().describe("Memory profile bank this agent's curated memory defaults key off — " + "the built-in disposition + observations_mission in PROFILE_MEMORY_DEFAULTS. " + "Decouples the memory profile from `extends` (the filesystem persona " + "profile), so an agent on `extends: default` can opt into the `coding` " + "memory bundle via `memory.profile: coding` without inheriting the coding " + "persona. Resolution: memory.profile → extends → DEFAULT_PROFILE (see " + "resolveMemoryProfile). Unset ⇒ byte-identical to keying off `extends`."),
     bank_mission: exports_external.string().optional().describe("Bank-level mission statement used during recall to contextualize " + "results. NOTE: this is an alias for the Hindsight engine's " + "`reflect_mission` field (verified live: switchroom's bank_mission " + "lands in `config.reflect_mission`). Prefer `reflect_mission` going " + "forward; `bank_mission` is retained for back-compat. If both are " + "set, `reflect_mission` wins. Cascade: override."),
     reflect_mission: exports_external.string().optional().describe("Mission/context steering Hindsight Reflect operations (the bank's " + "'who am I / what matters' framing applied during recall). The " + "engine-accurate name for what `bank_mission` sets. Cascade: override."),
     retain_mission: exports_external.string().optional().describe("Instructions for the fact extraction LLM during retain. Cascade: override."),
@@ -4849,6 +4850,8 @@ var init_schema = __esm(() => {
       provider: exports_external.string().min(1).optional().describe("Hindsight LLM provider (upstream `HINDSIGHT_API_LLM_PROVIDER`). " + "Defaults to `claude-code` (subscription-honest, broker-fed OAuth). " + "Any litellm-routable provider the upstream image supports is valid. " + "Serves as the GLOBAL default for every op absent a per-op override."),
       model: exports_external.string().min(1).optional().describe("Hindsight LLM model (upstream `HINDSIGHT_API_LLM_MODEL`). Defaults " + "to HINDSIGHT_DEFAULT_MODEL. Any model your LiteLLM proxy can route " + "is valid, e.g. `openrouter/z-ai/glm-5.2` when routing through the " + "fleet proxy. With provider=claude-code this value is ALSO exported " + "as `ANTHROPIC_MODEL` to the claude subprocess. Serves as the GLOBAL " + "default for every op absent a per-op override."),
       context_window: exports_external.number().int().positive().optional().describe("GLOBAL context window (tokens) of the backend serving hindsight's " + "LLM ops — the declared size switchroom derives every token budget " + "from. Set this to the real window of whatever you point " + "`hindsight.llm` at (e.g. 32768 for a llama.cpp slot launched with " + "`-c 65536 -np 2`, 131072 for a large-window OpenRouter model). " + "Absent → a per-provider default: 200000 for `claude-code`, a " + "conservative 32768 for everything else. Overflowing a local " + "backend's window does NOT error — llama.cpp context-shift silently " + "drops the system prompt and the model answers conversationally " + "with HTTP 200 — so this value is what makes the failure " + "detectable at setup time instead of never."),
+      base_url: exports_external.string().min(1).optional().describe("GLOBAL LLM base URL (upstream `HINDSIGHT_API_LLM_BASE_URL`). The " + "default endpoint every op inherits absent a per-op " + "`hindsight.llm.<op>.base_url`. Optional passthrough; unset → the " + "engine's provider default. When this points at host loopback the " + "hindsight container is forced onto host networking, same as a " + "per-op base URL, so the endpoint stays reachable (#3687)."),
+      api_key: exports_external.string().min(1).optional().describe("GLOBAL LLM API key (upstream `HINDSIGHT_API_LLM_API_KEY`). Literal " + "or `vault:` reference. The default credential every op inherits " + "absent a per-op `hindsight.llm.<op>.api_key`; the engine reads it as " + "a plain env fallback. Optional passthrough (#3687)."),
       retain: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `retain` LLM op (memory ingestion). Emits " + "`HINDSIGHT_API_RETAIN_LLM_*`. Absent → uses the global model/provider."),
       reflect: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `reflect` LLM op (synthesis / mental-model " + "refresh). Emits `HINDSIGHT_API_REFLECT_LLM_*`. Absent → uses global."),
       consolidation: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `consolidation` LLM op (background memory " + "merge). Emits `HINDSIGHT_API_CONSOLIDATION_LLM_*`. Absent → global.")
@@ -4985,6 +4988,7 @@ var init_schema = __esm(() => {
       auto_recall: exports_external.boolean().optional(),
       file: exports_external.boolean().optional(),
       isolation: exports_external.enum(["default", "strict"]).optional(),
+      profile: exports_external.string().optional(),
       directive_capture_nudge: exports_external.boolean().optional(),
       observation_scopes: ObservationScopesSchema,
       observation_scope_strategy: ObservationScopeStrategySchema,
@@ -5026,7 +5030,23 @@ var init_schema = __esm(() => {
         max_query_chars: exports_external.number().int().min(1).optional(),
         parallel: exports_external.boolean().optional(),
         additional_banks: exports_external.array(exports_external.string()).optional(),
-        sender_banks: exports_external.record(exports_external.string(), exports_external.string()).optional()
+        sender_banks: exports_external.record(exports_external.string(), exports_external.string()).optional(),
+        types: exports_external.array(exports_external.string()).optional(),
+        skip_trivial: exports_external.boolean().optional(),
+        topic_filter_mode: exports_external.enum(["soft-preamble", "hard-filter"]).optional()
+      }).optional(),
+      retain: exports_external.object({
+        every_n_turns: exports_external.number().int().min(1).optional(),
+        overlap_turns: exports_external.number().int().min(0).optional()
+      }).optional(),
+      bank_mission: exports_external.string().optional(),
+      reflect_mission: exports_external.string().optional(),
+      retain_mission: exports_external.string().optional(),
+      observations_mission: exports_external.string().optional(),
+      disposition: exports_external.object({
+        skepticism: exports_external.number().int().min(1).max(5).optional(),
+        literalism: exports_external.number().int().min(1).max(5).optional(),
+        empathy: exports_external.number().int().min(1).max(5).optional()
       }).optional()
     }).optional(),
     schedule: exports_external.array(ScheduleEntrySchema).optional(),

package/dist/vault/broker/server.js

@@ -4152,6 +4152,7 @@ var init_schema = __esm(() => {
     auto_recall: exports_external.boolean().default(true).describe("Auto-search memories before each response"),
     file: exports_external.boolean().default(true).describe("Maintain a curated workspace MEMORY.md file (seeded once, " + "auto-loaded every turn). Set false for hindsight-only memory: " + "the file is not seeded or re-created, so once migrated into " + "Hindsight and deleted it stays gone. Recall + directives carry " + "the memory instead. Cascade: override (per-agent wins over default)."),
     isolation: exports_external.enum(["default", "strict"]).default("default").describe("strict = never shared cross-agent, default = eligible for reflect"),
+    profile: exports_external.string().optional().describe("Memory profile bank this agent's curated memory defaults key off — " + "the built-in disposition + observations_mission in PROFILE_MEMORY_DEFAULTS. " + "Decouples the memory profile from `extends` (the filesystem persona " + "profile), so an agent on `extends: default` can opt into the `coding` " + "memory bundle via `memory.profile: coding` without inheriting the coding " + "persona. Resolution: memory.profile → extends → DEFAULT_PROFILE (see " + "resolveMemoryProfile). Unset ⇒ byte-identical to keying off `extends`."),
     bank_mission: exports_external.string().optional().describe("Bank-level mission statement used during recall to contextualize " + "results. NOTE: this is an alias for the Hindsight engine's " + "`reflect_mission` field (verified live: switchroom's bank_mission " + "lands in `config.reflect_mission`). Prefer `reflect_mission` going " + "forward; `bank_mission` is retained for back-compat. If both are " + "set, `reflect_mission` wins. Cascade: override."),
     reflect_mission: exports_external.string().optional().describe("Mission/context steering Hindsight Reflect operations (the bank's " + "'who am I / what matters' framing applied during recall). The " + "engine-accurate name for what `bank_mission` sets. Cascade: override."),
     retain_mission: exports_external.string().optional().describe("Instructions for the fact extraction LLM during retain. Cascade: override."),
@@ -4445,6 +4446,8 @@ var init_schema = __esm(() => {
       provider: exports_external.string().min(1).optional().describe("Hindsight LLM provider (upstream `HINDSIGHT_API_LLM_PROVIDER`). " + "Defaults to `claude-code` (subscription-honest, broker-fed OAuth). " + "Any litellm-routable provider the upstream image supports is valid. " + "Serves as the GLOBAL default for every op absent a per-op override."),
       model: exports_external.string().min(1).optional().describe("Hindsight LLM model (upstream `HINDSIGHT_API_LLM_MODEL`). Defaults " + "to HINDSIGHT_DEFAULT_MODEL. Any model your LiteLLM proxy can route " + "is valid, e.g. `openrouter/z-ai/glm-5.2` when routing through the " + "fleet proxy. With provider=claude-code this value is ALSO exported " + "as `ANTHROPIC_MODEL` to the claude subprocess. Serves as the GLOBAL " + "default for every op absent a per-op override."),
       context_window: exports_external.number().int().positive().optional().describe("GLOBAL context window (tokens) of the backend serving hindsight's " + "LLM ops — the declared size switchroom derives every token budget " + "from. Set this to the real window of whatever you point " + "`hindsight.llm` at (e.g. 32768 for a llama.cpp slot launched with " + "`-c 65536 -np 2`, 131072 for a large-window OpenRouter model). " + "Absent → a per-provider default: 200000 for `claude-code`, a " + "conservative 32768 for everything else. Overflowing a local " + "backend's window does NOT error — llama.cpp context-shift silently " + "drops the system prompt and the model answers conversationally " + "with HTTP 200 — so this value is what makes the failure " + "detectable at setup time instead of never."),
+      base_url: exports_external.string().min(1).optional().describe("GLOBAL LLM base URL (upstream `HINDSIGHT_API_LLM_BASE_URL`). The " + "default endpoint every op inherits absent a per-op " + "`hindsight.llm.<op>.base_url`. Optional passthrough; unset → the " + "engine's provider default. When this points at host loopback the " + "hindsight container is forced onto host networking, same as a " + "per-op base URL, so the endpoint stays reachable (#3687)."),
+      api_key: exports_external.string().min(1).optional().describe("GLOBAL LLM API key (upstream `HINDSIGHT_API_LLM_API_KEY`). Literal " + "or `vault:` reference. The default credential every op inherits " + "absent a per-op `hindsight.llm.<op>.api_key`; the engine reads it as " + "a plain env fallback. Optional passthrough (#3687)."),
       retain: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `retain` LLM op (memory ingestion). Emits " + "`HINDSIGHT_API_RETAIN_LLM_*`. Absent → uses the global model/provider."),
       reflect: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `reflect` LLM op (synthesis / mental-model " + "refresh). Emits `HINDSIGHT_API_REFLECT_LLM_*`. Absent → uses global."),
       consolidation: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `consolidation` LLM op (background memory " + "merge). Emits `HINDSIGHT_API_CONSOLIDATION_LLM_*`. Absent → global.")
@@ -4581,6 +4584,7 @@ var init_schema = __esm(() => {
       auto_recall: exports_external.boolean().optional(),
       file: exports_external.boolean().optional(),
       isolation: exports_external.enum(["default", "strict"]).optional(),
+      profile: exports_external.string().optional(),
       directive_capture_nudge: exports_external.boolean().optional(),
       observation_scopes: ObservationScopesSchema,
       observation_scope_strategy: ObservationScopeStrategySchema,
@@ -4622,7 +4626,23 @@ var init_schema = __esm(() => {
         max_query_chars: exports_external.number().int().min(1).optional(),
         parallel: exports_external.boolean().optional(),
         additional_banks: exports_external.array(exports_external.string()).optional(),
-        sender_banks: exports_external.record(exports_external.string(), exports_external.string()).optional()
+        sender_banks: exports_external.record(exports_external.string(), exports_external.string()).optional(),
+        types: exports_external.array(exports_external.string()).optional(),
+        skip_trivial: exports_external.boolean().optional(),
+        topic_filter_mode: exports_external.enum(["soft-preamble", "hard-filter"]).optional()
+      }).optional(),
+      retain: exports_external.object({
+        every_n_turns: exports_external.number().int().min(1).optional(),
+        overlap_turns: exports_external.number().int().min(0).optional()
+      }).optional(),
+      bank_mission: exports_external.string().optional(),
+      reflect_mission: exports_external.string().optional(),
+      retain_mission: exports_external.string().optional(),
+      observations_mission: exports_external.string().optional(),
+      disposition: exports_external.object({
+        skepticism: exports_external.number().int().min(1).max(5).optional(),
+        literalism: exports_external.number().int().min(1).max(5).optional(),
+        empathy: exports_external.number().int().min(1).max(5).optional()
       }).optional()
     }).optional(),
     schedule: exports_external.array(ScheduleEntrySchema).optional(),
@@ -19406,11 +19426,11 @@ var init_protocol = __esm(() => {
     OkRevokeGrantResponseSchema,
     OkApprovalRequestResponseSchema,
     OkApprovalLookupResponseSchema,
+    OkApprovalConsumeRecordResponseSchema,
     OkApprovalConsumeResponseSchema,
     OkApprovalRevokeResponseSchema,
     OkApprovalListResponseSchema,
     OkApprovalRecordResponseSchema,
-    OkApprovalConsumeRecordResponseSchema,
     ErrorResponseSchema
   ]);
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "switchroom",
   "//version": "NOT the release version — source of truth is the git tag, resolved by scripts/build.mjs:resolveVersion() (see CLAUDE.md > Standard release process). This field is stale by design and only the Layer-4 dev/non-tag fallback for build.mjs + src/cli/resolve-version.ts; do NOT bump it expecting a release to pick it up. npm-pack tarball naming needs a real version — do that as an UNCOMMITTED pack-time bump (see release step 6), never a committed one.",
-  "version": "0.19.40",
+  "version": "0.19.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": {

package/telegram-plugin/bridge/bridge.ts

@@ -268,7 +268,7 @@ const TOOL_SCHEMAS = [
   {
     name: 'send_checklist',
     description:
-      'Send a native Telegram checklist (interactive task list) to a chat. Users can tick tasks directly in the Telegram app. Returns the message_id of the created checklist. The bot is notified when tasks are ticked — these arrive as channel events with kind="checklist_task_changed". Limit: 30 tasks per checklist.',
+      'Send a checklist (task list) to a chat. Native interactive Telegram checklists require a Business-account connection, which most deployments do not have — in that normal case the checklist is sent as a formatted TEXT message (bold title + ✅/⬜ task lines) and the result carries degraded:"text": tasks are NOT tappable, and you tick them yourself via update_checklist (task ids are 1..N in send order). With a Business connection configured, the checklist is sent natively and tick events arrive as channel events with kind="checklist_task_changed". Returns JSON with message_id and mode. Limit: 30 tasks.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -357,7 +357,7 @@ const TOOL_SCHEMAS = [
   {
     name: 'update_checklist',
     description:
-      'Patch an existing native Telegram checklist. Supports updating the title, adding new tasks, removing tasks, or marking tasks done/undone. Tasks with an id target existing items; tasks without an id are appended. Preserves existing task ids across edits.',
+      'Patch a checklist previously sent with send_checklist: update the title, append tasks, or mark tasks done/undone. Tasks with an id target existing items (ids are 1..N in send order for text-mode checklists); tasks without an id are appended. Removal is not supported. The edit re-renders in the mode the checklist was sent in (text for most deployments). Returns JSON { ok, ... }; after a gateway restart the stored task state may be gone — then it returns ok:false with reason "unknown_checklist" unless you pass a full replacement (title + every task\'s text).',
     inputSchema: {
       type: 'object',
       properties: {

package/telegram-plugin/dist/bridge/bridge.js

@@ -25241,7 +25241,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: "send_checklist",
-    description: 'Send a native Telegram checklist (interactive task list) to a chat. Users can tick tasks directly in the Telegram app. Returns the message_id of the created checklist. The bot is notified when tasks are ticked \u2014 these arrive as channel events with kind="checklist_task_changed". Limit: 30 tasks per checklist.',
+    description: 'Send a checklist (task list) to a chat. Native interactive Telegram checklists require a Business-account connection, which most deployments do not have \u2014 in that normal case the checklist is sent as a formatted TEXT message (bold title + \u2705/\u2B1C task lines) and the result carries degraded:"text": tasks are NOT tappable, and you tick them yourself via update_checklist (task ids are 1..N in send order). With a Business connection configured, the checklist is sent natively and tick events arrive as channel events with kind="checklist_task_changed". Returns JSON with message_id and mode. Limit: 30 tasks.',
     inputSchema: {
       type: "object",
       properties: {
@@ -25326,7 +25326,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: "update_checklist",
-    description: "Patch an existing native Telegram checklist. Supports updating the title, adding new tasks, removing tasks, or marking tasks done/undone. Tasks with an id target existing items; tasks without an id are appended. Preserves existing task ids across edits.",
+    description: `Patch a checklist previously sent with send_checklist: update the title, append tasks, or mark tasks done/undone. Tasks with an id target existing items (ids are 1..N in send order for text-mode checklists); tasks without an id are appended. Removal is not supported. The edit re-renders in the mode the checklist was sent in (text for most deployments). Returns JSON { ok, ... }; after a gateway restart the stored task state may be gone \u2014 then it returns ok:false with reason "unknown_checklist" unless you pass a full replacement (title + every task's text).`,
     inputSchema: {
       type: "object",
       properties: {