comisai 1.0.14 → 1.0.16

package/node_modules/@comis/channels/dist/shared/typing-controller.d.ts

@@ -33,6 +33,13 @@
  *    text deltas from the model). Active generation keeps the indicator
  *    alive beyond the initial TTL window.
  *
+ * 6. **Internal TTL refresh (liveness watchdog)**: While active and not
+ *    sealed, an internal 30s interval calls resetTtl() unconditionally.
+ *    This is a belt-and-braces mechanism for long silences (extended
+ *    thinking, slow tools, inter-turn gaps). External refreshTtl() calls
+ *    from content signals remain the primary mechanism; this timer is
+ *    additive, not a replacement.
+ *
  * Typing failures are non-fatal: errors from `sendTyping` are caught
  * and logged but never propagated to the caller.
  *

package/node_modules/@comis/channels/dist/shared/typing-controller.js

@@ -34,6 +34,13 @@
  *    text deltas from the model). Active generation keeps the indicator
  *    alive beyond the initial TTL window.
  *
+ * 6. **Internal TTL refresh (liveness watchdog)**: While active and not
+ *    sealed, an internal 30s interval calls resetTtl() unconditionally.
+ *    This is a belt-and-braces mechanism for long silences (extended
+ *    thinking, slow tools, inter-turn gaps). External refreshTtl() calls
+ *    from content signals remain the primary mechanism; this timer is
+ *    additive, not a replacement.
+ *
  * Typing failures are non-fatal: errors from `sendTyping` are caught
  * and logged but never propagated to the caller.
  *
@@ -42,6 +49,11 @@
 // ---------------------------------------------------------------------------
 // Factory
 // ---------------------------------------------------------------------------
+/** Internal liveness refresh interval. MUST be strictly less than default
+ *  ttlMs (60_000) so an active, non-sealed controller cannot have its TTL
+ *  expire without an explicit stop() or circuit-breaker trip. Matches the
+ *  tool-active refresh cadence in execution-execute.ts for consistency. */
+const INTERNAL_TTL_REFRESH_MS = 30_000;
 /**
  * Create a typing controller that sends platform typing indicators at a
  * configurable refresh interval.
@@ -59,6 +71,7 @@ export function createTypingController(config, sendTyping, logger) {
     let consecutiveFailures = 0;
     let tickInFlight = false;
     let ttlTimer = null;
+    let ttlRefreshTimer = null;
     const threshold = config.circuitBreakerThreshold ?? 3;
     /** Fire-and-forget typing send with tick serialization and circuit breaker. */
     function doSendTyping(chatId) {
@@ -83,6 +96,10 @@ export function createTypingController(config, sendTyping, logger) {
                     clearTimeout(ttlTimer);
                     ttlTimer = null;
                 }
+                if (ttlRefreshTimer !== null) {
+                    clearInterval(ttlRefreshTimer);
+                    ttlRefreshTimer = null;
+                }
             }
             else {
                 logger?.warn({ err, chatId, hint: "Typing indicator delivery failed; non-blocking", errorKind: "platform" }, "Typing indicator send failed");
@@ -106,6 +123,10 @@ export function createTypingController(config, sendTyping, logger) {
                     clearInterval(timer);
                     timer = null;
                 }
+                if (ttlRefreshTimer !== null) {
+                    clearInterval(ttlRefreshTimer);
+                    ttlRefreshTimer = null;
+                }
             }
         }, config.ttlMs ?? 60_000);
     }
@@ -125,6 +146,14 @@ export function createTypingController(config, sendTyping, logger) {
             }, config.refreshMs);
             // Arm the TTL timer.
             resetTtl();
+            // Belt-and-braces liveness watchdog: refresh the TTL on a fixed cadence so
+            // the indicator survives long silences (extended thinking, slow tools,
+            // inter-turn gaps) even when no external signal calls refreshTtl().
+            ttlRefreshTimer = setInterval(() => {
+                if (active && !sealed) {
+                    resetTtl();
+                }
+            }, INTERNAL_TTL_REFRESH_MS);
         },
         stop() {
             active = false;
@@ -137,6 +166,10 @@ export function createTypingController(config, sendTyping, logger) {
                 clearTimeout(ttlTimer);
                 ttlTimer = null;
             }
+            if (ttlRefreshTimer !== null) {
+                clearInterval(ttlRefreshTimer);
+                ttlRefreshTimer = null;
+            }
         },
         refreshTtl() {
             if (!active || sealed)

package/node_modules/@comis/channels/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@comis/channels",
   "private": true,
-  "version": "1.0.14",
+  "version": "1.0.16",
   "author": "Moshe Anconina",
   "license": "Apache-2.0",
   "description": "Chat platform adapters — Discord, Telegram, Slack, WhatsApp, Signal, iMessage, IRC, LINE",

package/node_modules/@comis/cli/dist/commands/daemon.js

@@ -12,7 +12,9 @@
 import { execFile, spawn } from "node:child_process";
 import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync, openSync } from "node:fs";
 import * as os from "node:os";
+import { createInterface } from "node:readline";
 import { promisify } from "node:util";
+import chalk from "chalk";
 import { safePath } from "@comis/core";
 import { withClient } from "../client/rpc-client.js";
 import { success, error, info, warn } from "../output/format.js";
@@ -23,6 +25,63 @@ const PID_FILE = safePath(COMIS_DIR, "daemon.pid");
 const LOG_FILE = safePath(COMIS_DIR, "daemon.log");
 /** Max time to wait for daemon gateway to become ready (ms). */
 const READY_TIMEOUT_MS = 15_000;
+// ---------- Log formatting ----------
+const PINO_LEVELS = {
+    10: { label: "TRACE", color: chalk.gray },
+    20: { label: "DEBUG", color: chalk.gray },
+    30: { label: "INFO", color: chalk.cyan },
+    40: { label: "WARN", color: chalk.yellow },
+    50: { label: "ERROR", color: chalk.red },
+    60: { label: "FATAL", color: chalk.bgRed.white },
+};
+const PINO_META_KEYS = new Set([
+    "level", "time", "pid", "hostname", "name", "msg", "module",
+    "levelValue", "instanceId",
+]);
+function formatPinoLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("{"))
+        return line;
+    let record;
+    try {
+        record = JSON.parse(trimmed);
+    }
+    catch {
+        return line;
+    }
+    if (typeof record["level"] !== "number" && typeof record["level"] !== "string")
+        return line;
+    const levelNum = typeof record["level"] === "number"
+        ? record["level"]
+        : ({ trace: 10, debug: 20, info: 30, warn: 40, error: 50, fatal: 60 }[record["level"]] ?? 30);
+    const levelInfo = PINO_LEVELS[levelNum] ?? { label: String(record["level"]), color: chalk.white };
+    const time = record["time"]
+        ? new Date(record["time"]).toLocaleTimeString()
+        : "";
+    const mod = record["module"] ? `[${record["module"]}]` : "";
+    const msg = record["msg"] ?? "";
+    const extra = {};
+    for (const [k, v] of Object.entries(record)) {
+        if (!PINO_META_KEYS.has(k))
+            extra[k] = v;
+    }
+    const extraStr = Object.keys(extra).length > 0
+        ? chalk.gray(` ${JSON.stringify(extra)}`)
+        : "";
+    return `${chalk.dim(time)} ${levelInfo.color(levelInfo.label.padEnd(5))} ${chalk.blue(mod)} ${msg}${extraStr}`;
+}
+function formatLogOutput(raw) {
+    return raw
+        .split("\n")
+        .map((line) => (line.trim() ? formatPinoLine(line) : line))
+        .join("\n");
+}
+function pipeFormatted(child) {
+    if (!child.stdout)
+        return;
+    const rl = createInterface({ input: child.stdout });
+    rl.on("line", (line) => console.log(formatPinoLine(line)));
+}
 /** Interval between readiness polls (ms). */
 const READY_POLL_MS = 500;
 /**
@@ -533,40 +592,48 @@ async function handleDaemonLogs(options) {
     }
 }
 async function streamSystemdLogs(scope, options) {
-    const jArgs = ["--unit=comis", "--no-pager", `-n${options.lines}`];
+    const jArgs = ["--unit=comis", "--no-pager", `-n${options.lines}`, "--output=cat"];
     if (scope === "systemd-user")
         jArgs.push("--user");
     if (options.follow)
         jArgs.push("--follow");
     if (options.follow) {
-        const child = spawn("journalctl", jArgs, { stdio: "inherit" });
-        child.on("error", (err) => {
-            error(`Failed to read logs: ${err.message}`);
-            process.exit(1);
-        });
+        if (options.raw) {
+            const child = spawn("journalctl", jArgs, { stdio: "inherit" });
+            child.on("error", (err) => {
+                error(`Failed to read logs: ${err.message}`);
+                process.exit(1);
+            });
+        }
+        else {
+            const child = spawn("journalctl", jArgs, { stdio: ["ignore", "pipe", "inherit"] });
+            child.on("error", (err) => {
+                error(`Failed to read logs: ${err.message}`);
+                process.exit(1);
+            });
+            pipeFormatted(child);
+        }
         return;
     }
-    // Try journalctl directly first (works when user is in systemd-journal group),
-    // then fall back to sudo for system-scope journals.
-    try {
-        const { stdout } = await exec("journalctl", jArgs, { timeout: 10_000 });
+    const printOutput = (stdout) => {
         if (stdout.trim()) {
-            console.log(stdout);
+            console.log(options.raw ? stdout : formatLogOutput(stdout));
         }
         else {
             info("No logs found");
         }
+    };
+    // Try journalctl directly first (works when user is in systemd-journal group),
+    // then fall back to sudo for system-scope journals.
+    try {
+        const { stdout } = await exec("journalctl", jArgs, { timeout: 10_000 });
+        printOutput(stdout);
     }
     catch {
         // eslint-disable-next-line no-restricted-syntax -- CLI bootstrap before SecretManager
         if (scope === "systemd" && process.getuid?.() !== 0) {
             const { stdout } = await exec("sudo", ["journalctl", ...jArgs], { timeout: 10_000 });
-            if (stdout.trim()) {
-                console.log(stdout);
-            }
-            else {
-                info("No logs found");
-            }
+            printOutput(stdout);
         }
         else {
             throw new Error("Failed to read journal logs");
@@ -577,11 +644,21 @@ function streamPm2Logs(options) {
     const args = ["logs", "comis", "--lines", options.lines];
     if (!options.follow)
         args.push("--nostream");
-    const child = spawn("pm2", args, { stdio: "inherit" });
-    child.on("error", (err) => {
-        error(`Failed to read logs: ${err.message}`);
-        process.exit(1);
-    });
+    if (options.raw) {
+        const child = spawn("pm2", args, { stdio: "inherit" });
+        child.on("error", (err) => {
+            error(`Failed to read logs: ${err.message}`);
+            process.exit(1);
+        });
+    }
+    else {
+        const child = spawn("pm2", args, { stdio: ["ignore", "pipe", "inherit"] });
+        child.on("error", (err) => {
+            error(`Failed to read logs: ${err.message}`);
+            process.exit(1);
+        });
+        pipeFormatted(child);
+    }
 }
 async function streamDirectLogs(options) {
     // eslint-disable-next-line no-restricted-syntax -- CLI bootstrap before SecretManager
@@ -594,16 +671,26 @@ async function streamDirectLogs(options) {
     const args = ["-n", options.lines, logPath];
     if (options.follow) {
         args.unshift("-f");
-        const child = spawn("tail", args, { stdio: "inherit" });
-        child.on("error", (err) => {
-            error(`Failed to read logs: ${err.message}`);
-            process.exit(1);
-        });
+        if (options.raw) {
+            const child = spawn("tail", args, { stdio: "inherit" });
+            child.on("error", (err) => {
+                error(`Failed to read logs: ${err.message}`);
+                process.exit(1);
+            });
+        }
+        else {
+            const child = spawn("tail", args, { stdio: ["ignore", "pipe", "inherit"] });
+            child.on("error", (err) => {
+                error(`Failed to read logs: ${err.message}`);
+                process.exit(1);
+            });
+            pipeFormatted(child);
+        }
         return;
     }
     const { stdout } = await exec("tail", args, { timeout: 5_000 });
     if (stdout.trim()) {
-        console.log(stdout);
+        console.log(options.raw ? stdout : formatLogOutput(stdout));
     }
     else {
         info("No logs found");
@@ -634,5 +721,6 @@ export function registerDaemonCommand(program) {
         .description("Show daemon logs")
         .option("-f, --follow", "Follow log output")
         .option("-n, --lines <n>", "Number of lines to show", "50")
+        .option("--raw", "Show raw JSON output without formatting")
         .action(handleDaemonLogs);
 }

package/node_modules/@comis/cli/dist/doctor/checks/channel-health.js

@@ -8,12 +8,12 @@
  *
  * @module
  */
-import { CHANNEL_ENV_KEYS } from "../../wizard/flow-types.js";
+import { CHANNEL_ENV_KEYS } from "../../wizard/index.js";
 const CATEGORY = "channels";
 /**
  * Map of channel types to their required credential environment variable names.
  *
- * Sourced from the shared CHANNEL_ENV_KEYS constant in flow-types.
+ * Sourced from the shared CHANNEL_ENV_KEYS constant in the wizard module.
  * These are format checks only -- we verify the credential appears to be
  * a non-empty string, not that it's a valid API key.
  */

package/node_modules/@comis/cli/dist/wizard/index.d.ts

@@ -6,9 +6,8 @@
  * init command, tests, future phases) imports from this single entry
  * point rather than reaching into individual wizard files.
  *
- * Legacy wizard files (flow-types.ts, quickstart-flow.ts, manual-flow.ts)
- * are NOT re-exported here -- they remain for backward compatibility
- * but are not part of the new wizard architecture.
+ * Legacy wizard files (flow-types.ts, quickstart-flow.ts, manual-flow.ts,
+ * config-writer.ts) were removed -- superseded by the step-based architecture.
  *
  * @module
  */

package/node_modules/@comis/cli/dist/wizard/index.js

@@ -7,9 +7,8 @@
  * init command, tests, future phases) imports from this single entry
  * point rather than reaching into individual wizard files.
  *
- * Legacy wizard files (flow-types.ts, quickstart-flow.ts, manual-flow.ts)
- * are NOT re-exported here -- they remain for backward compatibility
- * but are not part of the new wizard architecture.
+ * Legacy wizard files (flow-types.ts, quickstart-flow.ts, manual-flow.ts,
+ * config-writer.ts) were removed -- superseded by the step-based architecture.
  *
  * @module
  */

package/node_modules/@comis/cli/dist/wizard/steps/10-write-config.js

@@ -17,7 +17,7 @@ import { updateState, heading, success as themeSuccess, PROVIDER_ENV_KEYS, CHANN
 /**
  * Get a sensible default model for a provider.
  *
- * Matches the defaults in the existing config-writer.ts.
+ * Matches the defaults used by the wizard.
  */
 function getDefaultModel(provider) {
     if (!provider)

package/node_modules/@comis/cli/dist/wizard/types.d.ts

@@ -1,8 +1,7 @@
 /**
  * Foundational types and constants for the init wizard redesign.
  *
- * Replaces the role of flow-types.ts with a richer type system
- * that supports the full wizard architecture: immutable state
+ * Core type system for the wizard architecture: immutable state
  * accumulation, structured validation, and multi-flow support.
  *
  * @module

package/node_modules/@comis/cli/dist/wizard/types.js

@@ -2,8 +2,7 @@
 /**
  * Foundational types and constants for the init wizard redesign.
  *
- * Replaces the role of flow-types.ts with a richer type system
- * that supports the full wizard architecture: immutable state
+ * Core type system for the wizard architecture: immutable state
  * accumulation, structured validation, and multi-flow support.
  *
  * @module

package/node_modules/@comis/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@comis/cli",
   "private": true,
-  "version": "1.0.14",
+  "version": "1.0.16",
   "author": "Moshe Anconina",
   "license": "Apache-2.0",
   "description": "Command-line interface for the Comis AI agent platform",

package/node_modules/@comis/core/dist/config/schema-agent.d.ts

@@ -550,9 +550,9 @@ export declare const BootstrapConfigSchema: z.ZodObject<{
     maxChars: z.ZodDefault<z.ZodNumber>;
     /** System prompt verbosity mode: full (all sections), minimal (sub-agents), none (identity only) */
     promptMode: z.ZodDefault<z.ZodEnum<{
-        minimal: "minimal";
-        full: "full";
         none: "none";
+        full: "full";
+        minimal: "minimal";
     }>>;
     /** When true, USER.md is excluded from bootstrap context in group chat sessions (privacy). Default: true. */
     groupChatFiltering: z.ZodDefault<z.ZodBoolean>;
@@ -737,6 +737,10 @@ export declare const AgentConfigSchema: z.ZodObject<{
         "multi-zone": "multi-zone";
         single: "single";
     }>>;
+    /** Advanced cache optimization options for interactive sessions. */
+    advancedCacheOptimization: z.ZodDefault<z.ZodObject<{
+        enableRecentZonePromotion: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
     /** Gemini explicit cache configuration (CachedContent lifecycle). */
     geminiCache: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -822,9 +826,9 @@ export declare const AgentConfigSchema: z.ZodObject<{
         maxChars: z.ZodDefault<z.ZodNumber>;
         /** System prompt verbosity mode: full (all sections), minimal (sub-agents), none (identity only) */
         promptMode: z.ZodDefault<z.ZodEnum<{
-            minimal: "minimal";
-            full: "full";
             none: "none";
+            full: "full";
+            minimal: "minimal";
         }>>;
         /** When true, USER.md is excluded from bootstrap context in group chat sessions (privacy). Default: true. */
         groupChatFiltering: z.ZodDefault<z.ZodBoolean>;
@@ -987,6 +991,17 @@ export declare const PerAgentHeartbeatConfigSchema: z.ZodObject<{
     alertCooldownMs: z.ZodOptional<z.ZodNumber>;
     /** Override stuck detection timeout in ms (per-agent) */
     staleMs: z.ZodOptional<z.ZodNumber>;
+    /** Per-agent heartbeat tool policy override -- matches AgentConfig.toolPolicy shape.
+     *
+     *  Resolution order: heartbeat.toolPolicy > agentConfig.toolPolicy > passthrough.
+     *  Opt-in: omitting this field preserves the agent's interactive tool set for
+     *  heartbeat ticks. Use `{ profile: "heartbeat-minimal" }` for the conservative
+     *  preset in `packages/skills/src/policy/tool-policy.ts`. */
+    toolPolicy: z.ZodOptional<z.ZodObject<{
+        profile: z.ZodDefault<z.ZodString>;
+        allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
 }, z.core.$strict>;
 export type HeartbeatTarget = z.infer<typeof HeartbeatTargetSchema>;
 export type PerAgentHeartbeatConfig = z.infer<typeof PerAgentHeartbeatConfigSchema>;
@@ -1046,6 +1061,17 @@ export declare const PerAgentSchedulerConfigSchema: z.ZodObject<{
         alertCooldownMs: z.ZodOptional<z.ZodNumber>;
         /** Override stuck detection timeout in ms (per-agent) */
         staleMs: z.ZodOptional<z.ZodNumber>;
+        /** Per-agent heartbeat tool policy override -- matches AgentConfig.toolPolicy shape.
+         *
+         *  Resolution order: heartbeat.toolPolicy > agentConfig.toolPolicy > passthrough.
+         *  Opt-in: omitting this field preserves the agent's interactive tool set for
+         *  heartbeat ticks. Use `{ profile: "heartbeat-minimal" }` for the conservative
+         *  preset in `packages/skills/src/policy/tool-policy.ts`. */
+        toolPolicy: z.ZodOptional<z.ZodObject<{
+            profile: z.ZodDefault<z.ZodString>;
+            allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 /** Per-agent configuration: extends AgentConfigSchema with skills, scheduler, session, concurrency. */
@@ -1080,6 +1106,9 @@ export declare const PerAgentConfigSchema: z.ZodObject<{
         "multi-zone": "multi-zone";
         single: "single";
     }>>;
+    advancedCacheOptimization: z.ZodDefault<z.ZodObject<{
+        enableRecentZonePromotion: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
     geminiCache: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         maxActiveCaches: z.ZodDefault<z.ZodNumber>;
@@ -1150,9 +1179,9 @@ export declare const PerAgentConfigSchema: z.ZodObject<{
         maxChars: z.ZodDefault<z.ZodNumber>;
         /** System prompt verbosity mode: full (all sections), minimal (sub-agents), none (identity only) */
         promptMode: z.ZodDefault<z.ZodEnum<{
-            minimal: "minimal";
-            full: "full";
             none: "none";
+            full: "full";
+            minimal: "minimal";
         }>>;
         /** When true, USER.md is excluded from bootstrap context in group chat sessions (privacy). Default: true. */
         groupChatFiltering: z.ZodDefault<z.ZodBoolean>;
@@ -1259,11 +1288,11 @@ export declare const PerAgentConfigSchema: z.ZodObject<{
         }, z.core.$strict>>;
         toolPolicy: z.ZodDefault<z.ZodObject<{
             profile: z.ZodDefault<z.ZodEnum<{
+                full: "full";
                 minimal: "minimal";
                 coding: "coding";
                 messaging: "messaging";
                 supervisor: "supervisor";
-                full: "full";
             }>>;
             allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
             deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -1351,6 +1380,17 @@ export declare const PerAgentConfigSchema: z.ZodObject<{
             alertCooldownMs: z.ZodOptional<z.ZodNumber>;
             /** Override stuck detection timeout in ms (per-agent) */
             staleMs: z.ZodOptional<z.ZodNumber>;
+            /** Per-agent heartbeat tool policy override -- matches AgentConfig.toolPolicy shape.
+             *
+             *  Resolution order: heartbeat.toolPolicy > agentConfig.toolPolicy > passthrough.
+             *  Opt-in: omitting this field preserves the agent's interactive tool set for
+             *  heartbeat ticks. Use `{ profile: "heartbeat-minimal" }` for the conservative
+             *  preset in `packages/skills/src/policy/tool-policy.ts`. */
+            toolPolicy: z.ZodOptional<z.ZodObject<{
+                profile: z.ZodDefault<z.ZodString>;
+                allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
     session: z.ZodOptional<z.ZodObject<{
@@ -1740,6 +1780,9 @@ export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         "multi-zone": "multi-zone";
         single: "single";
     }>>;
+    advancedCacheOptimization: z.ZodDefault<z.ZodObject<{
+        enableRecentZonePromotion: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
     geminiCache: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         maxActiveCaches: z.ZodDefault<z.ZodNumber>;
@@ -1810,9 +1853,9 @@ export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         maxChars: z.ZodDefault<z.ZodNumber>;
         /** System prompt verbosity mode: full (all sections), minimal (sub-agents), none (identity only) */
         promptMode: z.ZodDefault<z.ZodEnum<{
-            minimal: "minimal";
-            full: "full";
             none: "none";
+            full: "full";
+            minimal: "minimal";
         }>>;
         /** When true, USER.md is excluded from bootstrap context in group chat sessions (privacy). Default: true. */
         groupChatFiltering: z.ZodDefault<z.ZodBoolean>;
@@ -1919,11 +1962,11 @@ export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         }, z.core.$strict>>;
         toolPolicy: z.ZodDefault<z.ZodObject<{
             profile: z.ZodDefault<z.ZodEnum<{
+                full: "full";
                 minimal: "minimal";
                 coding: "coding";
                 messaging: "messaging";
                 supervisor: "supervisor";
-                full: "full";
             }>>;
             allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
             deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -2011,6 +2054,17 @@ export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
             alertCooldownMs: z.ZodOptional<z.ZodNumber>;
             /** Override stuck detection timeout in ms (per-agent) */
             staleMs: z.ZodOptional<z.ZodNumber>;
+            /** Per-agent heartbeat tool policy override -- matches AgentConfig.toolPolicy shape.
+             *
+             *  Resolution order: heartbeat.toolPolicy > agentConfig.toolPolicy > passthrough.
+             *  Opt-in: omitting this field preserves the agent's interactive tool set for
+             *  heartbeat ticks. Use `{ profile: "heartbeat-minimal" }` for the conservative
+             *  preset in `packages/skills/src/policy/tool-policy.ts`. */
+            toolPolicy: z.ZodOptional<z.ZodObject<{
+                profile: z.ZodDefault<z.ZodString>;
+                allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
     session: z.ZodOptional<z.ZodObject<{

package/node_modules/@comis/core/dist/config/schema-agent.js

@@ -574,6 +574,14 @@ export const AgentConfigSchema = z.strictObject({
      *  'auto' resolves to 'single' for direct Anthropic and 'multi-zone' for Bedrock/Vertex.
      *  'multi-zone' places breakpoints across system, tools, and messages. */
     cacheBreakpointStrategy: z.enum(["auto", "multi-zone", "single"]).default("single"),
+    /** Advanced cache optimization options for interactive sessions. */
+    advancedCacheOptimization: z.object({
+        /** When true, the recent-zone message breakpoint may be promoted from
+         *  "short" (5m) to "long" (1h) TTL when observed inter-turn gaps
+         *  consistently exceed 5 minutes. Prevents repeated cache rewrite costs
+         *  in slow-cadence channels like Telegram. Default: true. */
+        enableRecentZonePromotion: z.boolean().default(true),
+    }).default(() => ({ enableRecentZonePromotion: true })),
     /** Gemini explicit cache configuration (CachedContent lifecycle). */
     geminiCache: GeminiCacheConfigSchema.default(() => GeminiCacheConfigSchema.parse({})),
     /** When true, only content inside <final> blocks reaches users (streaming + non-streaming). Default: false. */
@@ -674,6 +682,17 @@ export const PerAgentHeartbeatConfigSchema = z.strictObject({
     alertCooldownMs: z.number().int().positive().optional(),
     /** Override stuck detection timeout in ms (per-agent) */
     staleMs: z.number().int().positive().optional(),
+    /** Per-agent heartbeat tool policy override -- matches AgentConfig.toolPolicy shape.
+     *
+     *  Resolution order: heartbeat.toolPolicy > agentConfig.toolPolicy > passthrough.
+     *  Opt-in: omitting this field preserves the agent's interactive tool set for
+     *  heartbeat ticks. Use `{ profile: "heartbeat-minimal" }` for the conservative
+     *  preset in `packages/skills/src/policy/tool-policy.ts`. */
+    toolPolicy: z.object({
+        profile: z.string().default("full"),
+        allow: z.array(z.string()).default([]),
+        deny: z.array(z.string()).default([]),
+    }).optional(),
 });
 /** Per-agent scheduler configuration (wraps cron and heartbeat settings). */
 export const PerAgentSchedulerConfigSchema = z.strictObject({

package/node_modules/@comis/core/dist/config/schema-skills.d.ts

@@ -23,7 +23,14 @@ export declare const PromptSkillsConfigSchema: z.ZodObject<{
  * per-deployment without a rebuild.
  */
 declare const ToolDiscoverySchema: z.ZodObject<{
-    /** Minimum BM25 score to consider a match (BM25-only mode). Default 0.8. */
+    /** Minimum BM25 score as FRACTION OF TOP MATCH (0..1). Default 0.8.
+     *  As of 2026-04-23, BM25 scores are normalized to [0, 1] before this floor
+     *  applies, matching the semantics of minHybridScore. A value of 0.8 means
+     *  "return only tools scoring >= 80% of the top match". Values > 1.0 fail
+     *  validation at config load (stale raw-score overrides would produce zero
+     *  matches under the new normalized semantics; fail-fast surfaces the
+     *  error immediately per AGENTS.md §3.4). See design §5.6:
+     *  .planning/design/discover-tools-bm25-fallback-fix.md */
     minBm25Score: z.ZodDefault<z.ZodNumber>;
     /** Minimum combined score (0..1 normalized) for hybrid mode. Default 0.35. */
     minHybridScore: z.ZodDefault<z.ZodNumber>;
@@ -115,7 +122,14 @@ export declare const SkillsConfigSchema: z.ZodObject<{
     }, z.core.$strict>>;
     /** discover_tools score-floor thresholds (BM25 + hybrid). */
     toolDiscovery: z.ZodDefault<z.ZodObject<{
-        /** Minimum BM25 score to consider a match (BM25-only mode). Default 0.8. */
+        /** Minimum BM25 score as FRACTION OF TOP MATCH (0..1). Default 0.8.
+         *  As of 2026-04-23, BM25 scores are normalized to [0, 1] before this floor
+         *  applies, matching the semantics of minHybridScore. A value of 0.8 means
+         *  "return only tools scoring >= 80% of the top match". Values > 1.0 fail
+         *  validation at config load (stale raw-score overrides would produce zero
+         *  matches under the new normalized semantics; fail-fast surfaces the
+         *  error immediately per AGENTS.md §3.4). See design §5.6:
+         *  .planning/design/discover-tools-bm25-fallback-fix.md */
         minBm25Score: z.ZodDefault<z.ZodNumber>;
         /** Minimum combined score (0..1 normalized) for hybrid mode. Default 0.35. */
         minHybridScore: z.ZodDefault<z.ZodNumber>;

package/node_modules/@comis/core/dist/config/schema-skills.js

@@ -93,8 +93,15 @@ const ExecSandboxSchema = z.strictObject({
  * per-deployment without a rebuild.
  */
 const ToolDiscoverySchema = z.strictObject({
-    /** Minimum BM25 score to consider a match (BM25-only mode). Default 0.8. */
-    minBm25Score: z.number().min(0).default(0.8),
+    /** Minimum BM25 score as FRACTION OF TOP MATCH (0..1). Default 0.8.
+     *  As of 2026-04-23, BM25 scores are normalized to [0, 1] before this floor
+     *  applies, matching the semantics of minHybridScore. A value of 0.8 means
+     *  "return only tools scoring >= 80% of the top match". Values > 1.0 fail
+     *  validation at config load (stale raw-score overrides would produce zero
+     *  matches under the new normalized semantics; fail-fast surfaces the
+     *  error immediately per AGENTS.md §3.4). See design §5.6:
+     *  .planning/design/discover-tools-bm25-fallback-fix.md */
+    minBm25Score: z.number().min(0).max(1).default(0.8),
     /** Minimum combined score (0..1 normalized) for hybrid mode. Default 0.35. */
     minHybridScore: z.number().min(0).max(1).default(0.35),
 });