comisai 1.0.36 → 1.0.37

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

@@ -6,32 +6,20 @@ import { z } from "zod";
  * fallback model entries, auth profile rotation, and failover configuration.
  */
 export declare const BudgetConfigSchema: z.ZodObject<{
-    /** Max tokens per single execution */
     perExecution: z.ZodDefault<z.ZodNumber>;
-    /** Max tokens per hour (rolling window) */
     perHour: z.ZodDefault<z.ZodNumber>;
-    /** Max tokens per day (rolling window) */
     perDay: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const CircuitBreakerConfigSchema: z.ZodObject<{
-    /** Number of consecutive failures before opening circuit */
     failureThreshold: z.ZodDefault<z.ZodNumber>;
-    /** Milliseconds to wait before attempting recovery */
     resetTimeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Milliseconds for half-open probe timeout */
     halfOpenTimeoutMs: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const ToolRetryBreakerConfigSchema: z.ZodObject<{
-    /** Enable tool retry circuit breaker. Default: true. */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Max consecutive failures for same tool+args before blocking. Default: 3. */
     maxConsecutiveFailures: z.ZodDefault<z.ZodNumber>;
-    /** Max total failures for a tool name (any args) before blocking all calls. Default: 5. */
     maxToolFailures: z.ZodDefault<z.ZodNumber>;
-    /** Suggest alternative tools in block reason. Default: true. */
     suggestAlternatives: z.ZodDefault<z.ZodBoolean>;
-    /** Max consecutive same-error-class failures (any args) before blocking. Default: 2.
-     *  Stricter than args-based because same error + different args = stronger stuck signal. */
     maxConsecutiveErrorPatterns: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /**
@@ -52,9 +40,7 @@ export declare const ModelRoutesSchema: z.ZodDefault<z.ZodObject<{
  * Schema for a single fallback model entry (provider + modelId pair).
  */
 export declare const FallbackModelSchema: z.ZodObject<{
-    /** LLM provider (e.g. "anthropic", "openai") */
     provider: z.ZodString;
-    /** Model identifier at the provider */
     modelId: z.ZodString;
 }, z.core.$strict>;
 /**
@@ -64,9 +50,7 @@ export declare const FallbackModelSchema: z.ZodObject<{
  * multiple API keys per provider for rotation during rate limiting.
  */
 export declare const AuthProfileSchema: z.ZodObject<{
-    /** Key name in SecretManager (e.g. "ANTHROPIC_API_KEY_2") */
     keyName: z.ZodString;
-    /** Provider this key belongs to (e.g. "anthropic") */
     provider: z.ZodString;
 }, z.core.$strict>;
 /**
@@ -76,35 +60,22 @@ export declare const AuthProfileSchema: z.ZodObject<{
  * with exponential cooldowns, and model allowlisting.
  */
 export declare const ModelFailoverConfigSchema: z.ZodObject<{
-    /** Ordered list of fallback models to try when primary fails */
     fallbackModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** LLM provider (e.g. "anthropic", "openai") */
         provider: z.ZodString;
-        /** Model identifier at the provider */
         modelId: z.ZodString;
     }, z.core.$strict>>>;
-    /** Per-provider API key profiles for auth rotation */
     authProfiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Key name in SecretManager (e.g. "ANTHROPIC_API_KEY_2") */
         keyName: z.ZodString;
-        /** Provider this key belongs to (e.g. "anthropic") */
         provider: z.ZodString;
     }, z.core.$strict>>>;
-    /** Model allowlist (empty = allow all models) */
     allowedModels: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Maximum total attempts across all models/keys */
     maxAttempts: z.ZodDefault<z.ZodNumber>;
-    /** Initial cooldown duration in milliseconds (1 min) */
     cooldownInitialMs: z.ZodDefault<z.ZodNumber>;
-    /** Exponential cooldown multiplier */
     cooldownMultiplier: z.ZodDefault<z.ZodNumber>;
-    /** Maximum cooldown duration in milliseconds (1 hr) */
     cooldownCapMs: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const PromptTimeoutConfigSchema: z.ZodObject<{
-    /** Wall-clock timeout for primary prompt calls in milliseconds. Default: 180s. */
     promptTimeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Wall-clock timeout for retry prompt calls in milliseconds. Default: 60s. */
     retryPromptTimeoutMs: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /**
@@ -122,9 +93,7 @@ export type ModelOperationType = "interactive" | "cron" | "heartbeat" | "subagen
  * smart defaults. When timeout is unset, per-operation timeout defaults apply.
  */
 export declare const OperationModelEntrySchema: z.ZodObject<{
-    /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
     model: z.ZodOptional<z.ZodString>;
-    /** Timeout override in milliseconds for this operation type. */
     timeout: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export type OperationModelEntry = z.infer<typeof OperationModelEntrySchema>;
@@ -140,39 +109,27 @@ export type OperationModelEntry = z.infer<typeof OperationModelEntrySchema>;
  */
 export declare const OperationModelsSchema: z.ZodDefault<z.ZodObject<{
     cron: z.ZodOptional<z.ZodObject<{
-        /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
         model: z.ZodOptional<z.ZodString>;
-        /** Timeout override in milliseconds for this operation type. */
         timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     heartbeat: z.ZodOptional<z.ZodObject<{
-        /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
         model: z.ZodOptional<z.ZodString>;
-        /** Timeout override in milliseconds for this operation type. */
         timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     subagent: z.ZodOptional<z.ZodObject<{
-        /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
         model: z.ZodOptional<z.ZodString>;
-        /** Timeout override in milliseconds for this operation type. */
         timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     compaction: z.ZodOptional<z.ZodObject<{
-        /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
         model: z.ZodOptional<z.ZodString>;
-        /** Timeout override in milliseconds for this operation type. */
         timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     taskExtraction: z.ZodOptional<z.ZodObject<{
-        /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
         model: z.ZodOptional<z.ZodString>;
-        /** Timeout override in milliseconds for this operation type. */
         timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     condensation: z.ZodOptional<z.ZodObject<{
-        /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
         model: z.ZodOptional<z.ZodString>;
-        /** Timeout override in milliseconds for this operation type. */
         timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strict>>;
@@ -196,18 +153,14 @@ export type OperationModels = z.infer<typeof OperationModelsSchema>;
  * All fields are optional -- omitted fields inherit from the parent policy.
  */
 export declare const ResetPolicyOverrideSchema: z.ZodObject<{
-    /** Override reset mode for this session type */
     mode: z.ZodOptional<z.ZodEnum<{
         daily: "daily";
         idle: "idle";
         hybrid: "hybrid";
         none: "none";
     }>>;
-    /** Override daily reset hour (0-23) */
     dailyResetHour: z.ZodOptional<z.ZodNumber>;
-    /** Override IANA timezone for daily reset */
     dailyResetTimezone: z.ZodOptional<z.ZodString>;
-    /** Override idle timeout in milliseconds */
     idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 /**
@@ -215,68 +168,49 @@ export declare const ResetPolicyOverrideSchema: z.ZodObject<{
  * Controls automatic session expiry via daily, idle, or hybrid modes.
  */
 export declare const SessionResetPolicySchema: z.ZodObject<{
-    /** Reset mode: daily, idle, hybrid (first-to-expire), or none (disabled) */
     mode: z.ZodDefault<z.ZodEnum<{
         daily: "daily";
         idle: "idle";
         hybrid: "hybrid";
         none: "none";
     }>>;
-    /** Hour of day for daily reset (0-23, default 4 = 4 AM) */
     dailyResetHour: z.ZodDefault<z.ZodNumber>;
-    /** IANA timezone for daily reset (empty string = system local) */
     dailyResetTimezone: z.ZodDefault<z.ZodString>;
-    /** Idle timeout in milliseconds (default 4 hours = 14_400_000) */
     idleTimeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Sweep interval in milliseconds (how often to check sessions, default 5 min) */
     sweepIntervalMs: z.ZodDefault<z.ZodNumber>;
-    /** Phrases that trigger immediate session reset when sent as a message */
     resetTriggers: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Per-session-type overrides (dm, group, thread) */
     perType: z.ZodDefault<z.ZodObject<{
         dm: z.ZodOptional<z.ZodObject<{
-            /** Override reset mode for this session type */
             mode: z.ZodOptional<z.ZodEnum<{
                 daily: "daily";
                 idle: "idle";
                 hybrid: "hybrid";
                 none: "none";
             }>>;
-            /** Override daily reset hour (0-23) */
             dailyResetHour: z.ZodOptional<z.ZodNumber>;
-            /** Override IANA timezone for daily reset */
             dailyResetTimezone: z.ZodOptional<z.ZodString>;
-            /** Override idle timeout in milliseconds */
             idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         group: z.ZodOptional<z.ZodObject<{
-            /** Override reset mode for this session type */
             mode: z.ZodOptional<z.ZodEnum<{
                 daily: "daily";
                 idle: "idle";
                 hybrid: "hybrid";
                 none: "none";
             }>>;
-            /** Override daily reset hour (0-23) */
             dailyResetHour: z.ZodOptional<z.ZodNumber>;
-            /** Override IANA timezone for daily reset */
             dailyResetTimezone: z.ZodOptional<z.ZodString>;
-            /** Override idle timeout in milliseconds */
             idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         thread: z.ZodOptional<z.ZodObject<{
-            /** Override reset mode for this session type */
             mode: z.ZodOptional<z.ZodEnum<{
                 daily: "daily";
                 idle: "idle";
                 hybrid: "hybrid";
                 none: "none";
             }>>;
-            /** Override daily reset hour (0-23) */
             dailyResetHour: z.ZodOptional<z.ZodNumber>;
-            /** Override IANA timezone for daily reset */
             dailyResetTimezone: z.ZodOptional<z.ZodString>;
-            /** Override idle timeout in milliseconds */
             idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
@@ -291,16 +225,13 @@ export declare const SessionResetPolicySchema: z.ZodObject<{
  * - "per-account-channel-peer": includes bot account identifier in channel for multi-bot isolation
  */
 export declare const DmScopeConfigSchema: z.ZodObject<{
-    /** DM scope mode controlling session isolation granularity */
     mode: z.ZodDefault<z.ZodEnum<{
         main: "main";
         "per-peer": "per-peer";
         "per-channel-peer": "per-channel-peer";
         "per-account-channel-peer": "per-account-channel-peer";
     }>>;
-    /** Prepend agent:<agentId>: to session keys for multi-agent isolation */
     agentPrefix: z.ZodDefault<z.ZodBoolean>;
-    /** Append :thread:<threadId> to session keys for forum/thread isolation */
     threadIsolation: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 /**
@@ -310,23 +241,14 @@ export declare const DmScopeConfigSchema: z.ZodObject<{
  * Pruning operates on copies only -- persisted session data is never affected.
  */
 export declare const PruningConfigSchema: z.ZodObject<{
-    /** Enable session pruning of oversized tool results */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Character threshold above which tool results are soft-trimmed (head + tail with marker) */
     softTrimThresholdChars: z.ZodDefault<z.ZodNumber>;
-    /** Character threshold above which tool results are hard-cleared (entire content replaced) */
     hardClearThresholdChars: z.ZodDefault<z.ZodNumber>;
-    /** Number of characters to preserve at the start of a soft-trimmed result */
     preserveHeadChars: z.ZodDefault<z.ZodNumber>;
-    /** Number of characters to preserve at the end of a soft-trimmed result */
     preserveTailChars: z.ZodDefault<z.ZodNumber>;
-    /** Tools whose results are eligible for pruning (empty = all tools eligible) */
     pruneableTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Tools whose results are never pruned (takes precedence over pruneableTools) */
     protectedTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Protect tool results containing image content blocks from pruning */
     protectImageBlocks: z.ZodDefault<z.ZodBoolean>;
-    /** Number of recent messages (from end of array) exempt from pruning */
     preserveRecentCount: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /**
@@ -337,23 +259,14 @@ export declare const PruningConfigSchema: z.ZodObject<{
  * using a cheaper model for memory extraction.
  */
 export declare const SessionCompactionConfigSchema: z.ZodObject<{
-    /** Fraction of maxContextChars at which soft flush triggers (memory extraction only) */
     softThresholdRatio: z.ZodDefault<z.ZodNumber>;
-    /** Fraction of maxContextChars at which hard compaction triggers (flush + trim) */
     hardThresholdRatio: z.ZodDefault<z.ZodNumber>;
-    /** Model to use for memory extraction during flush (defaults to cheap model) */
     flushModel: z.ZodOptional<z.ZodString>;
-    /** Max characters per summarization chunk. Default: 50_000. */
     chunkMaxChars: z.ZodDefault<z.ZodNumber>;
-    /** Number of overlap messages between chunks. Default: 2. */
     chunkOverlapMessages: z.ZodDefault<z.ZodNumber>;
-    /** Whether to merge chunk summaries via LLM. Default: true. */
     chunkMergeSummaries: z.ZodDefault<z.ZodBoolean>;
-    /** Tokens reserved for summary during SDK auto-compaction. Default: 16384. */
     reserveTokens: z.ZodDefault<z.ZodNumber>;
-    /** Tokens worth of recent messages to keep after SDK auto-compaction. Default: 32768. */
     keepRecentTokens: z.ZodDefault<z.ZodNumber>;
-    /** AGENTS.md section names to re-inject after compaction. */
     postCompactionSections: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type SessionResetPolicyConfig = z.infer<typeof SessionResetPolicySchema>;
@@ -382,99 +295,46 @@ export type SessionCompactionConfig = z.infer<typeof SessionCompactionConfigSche
  */
 /** Context engine configuration (per-agent). */
 export declare const ContextEngineConfigSchema: z.ZodObject<{
-    /** Master toggle for the context engine pipeline (enabled by default). */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Operating mode: "pipeline" for sequential layer composition, "dag" for graph-based context management. */
     version: z.ZodDefault<z.ZodEnum<{
         pipeline: "pipeline";
         dag: "dag";
     }>>;
-    /** Number of recent assistant turns that retain thinking blocks (older turns get stripped). */
     thinkingKeepTurns: z.ZodDefault<z.ZodNumber>;
-    /** Idle gap (ms) above which signed thinking state is treated as drifted and
-     *  scrubbed pre-send to avoid provider replay-rejection. Default 30 min —
-     *  below long-TTL caches and below the 74-min production incident gap. Also
-     *  triggers on model id / provider / api change (those checks are
-     *  unconditional regardless of this idle threshold). Range: 1 min .. 24 h. */
     replayDriftIdleMs: z.ZodDefault<z.ZodNumber>;
-    /** Model for LLM compaction in "provider:modelId" format. Empty string
-     *  (the default) triggers runtime resolution against the agent's primary
-     *  provider via pi-ai catalog (fast-tier cost model). Avoids pinning a
-     *  hardcoded Anthropic literal that goes stale on pi-ai upgrades and
-     *  cross-routes background ops to Claude when primary is OpenRouter/Google/etc. */
     compactionModel: z.ZodDefault<z.ZodString>;
-    /** Minimum age (in tool result positions) before content is eligible for dead content eviction. */
     evictionMinAge: z.ZodDefault<z.ZodNumber>;
-    /** Number of recent user turns to keep in context (default 15). */
     historyTurns: z.ZodDefault<z.ZodNumber>;
-    /** Per-agent or per-channel-type turn count overrides (e.g., { dm: 10, "trader-1": 30 }). */
     historyTurnOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    /** Number of most recent tool uses that retain full content (older ones are masked). */
     observationKeepWindow: z.ZodDefault<z.ZodNumber>;
-    /** Character threshold before observation masking activates (below this, masking is skipped). */
     observationTriggerChars: z.ZodDefault<z.ZodNumber>;
-    /** Character threshold below which observation masking deactivates (hysteresis). */
     observationDeactivationChars: z.ZodDefault<z.ZodNumber>;
-    /** Keep window for ephemeral-tier tools (web_search, brave_search, web_fetch, link_reader, fetch_url). Shorter than observationKeepWindow. Default: 10. */
     ephemeralKeepWindow: z.ZodDefault<z.ZodNumber>;
-    /** Turns to wait before re-triggering LLM compaction after a successful compaction. */
     compactionCooldownTurns: z.ZodDefault<z.ZodNumber>;
-    /** Number of user-turn cycles at the head of conversation to preserve during
-     *  LLM compaction for cache prefix stability. 0 = old behavior
-     *  (summarize everything, keep tail only). */
     compactionPrefixAnchorTurns: z.ZodDefault<z.ZodNumber>;
-    /** Output escalation configuration: auto-retry with higher output budget on max_tokens truncation. */
     outputEscalation: z.ZodDefault<z.ZodObject<{
-        /** Master toggle for output escalation. When false, max_tokens truncation is not retried. */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Escalated max output tokens for the retry attempt. Must be between 4096 and 128000. */
         escalatedMaxTokens: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Number of most recent turns always included verbatim in DAG context. */
     freshTailTurns: z.ZodDefault<z.ZodNumber>;
-    /** Context utilization fraction that triggers DAG compaction (0.1 to 0.95). */
     contextThreshold: z.ZodDefault<z.ZodNumber>;
-    /** Minimum fan-out for leaf nodes in the DAG. */
     leafMinFanout: z.ZodDefault<z.ZodNumber>;
-    /** Minimum fan-out for condensed (non-leaf) nodes in the DAG. */
     condensedMinFanout: z.ZodDefault<z.ZodNumber>;
-    /** Hard minimum fan-out for condensed nodes (lowest allowed). */
     condensedMinFanoutHard: z.ZodDefault<z.ZodNumber>;
-    /** Maximum depth for incremental DAG rebuilds (-1 = full rebuild). */
     incrementalMaxDepth: z.ZodDefault<z.ZodNumber>;
-    /** Token budget for leaf node chunks in the DAG. */
     leafChunkTokens: z.ZodDefault<z.ZodNumber>;
-    /** Target token size for leaf node summaries. */
     leafTargetTokens: z.ZodDefault<z.ZodNumber>;
-    /** Target token size for condensed node summaries. */
     condensedTargetTokens: z.ZodDefault<z.ZodNumber>;
-    /** Maximum tokens for expanded context retrieval. */
     maxExpandTokens: z.ZodDefault<z.ZodNumber>;
-    /** Maximum recall operations per day per agent. */
     maxRecallsPerDay: z.ZodDefault<z.ZodNumber>;
-    /** Timeout for recall operations in milliseconds. */
     recallTimeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Token threshold above which a file is considered "large" for DAG processing. */
     largeFileTokenThreshold: z.ZodDefault<z.ZodNumber>;
-    /** Number of most recent annotations retained in DAG mode (analogous to observationKeepWindow). */
     annotationKeepWindow: z.ZodDefault<z.ZodNumber>;
-    /** Character threshold before annotation eviction activates in DAG mode. */
     annotationTriggerChars: z.ZodDefault<z.ZodNumber>;
-    /** Optional model override for DAG summary generation in "provider:modelId" format. */
     summaryModel: z.ZodOptional<z.ZodString>;
-    /** Optional provider override for DAG summary generation. */
     summaryProvider: z.ZodOptional<z.ZodString>;
-    /** Post-batch continuation handler: when the LLM emits an empty final
-     *  turn after a successful tool batch, fire a directive followUp with
-     *  multi-shot retry. Replaces the legacy SEP one-shot completeness nudge
-     *  (whose enforcement role was superseded; SEP plan extraction + step
-     *  counting remain intact for observability). */
     postBatchContinuation: z.ZodDefault<z.ZodObject<{
-        /** Master toggle. When false, handler returns
-         *  {recovered: false, outcome: "disabled"} without calling followUp. */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum directive followUp attempts before falling through to L3
-         *  synthesis. 0 = disabled. */
         maxRetries: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
@@ -490,24 +350,16 @@ export type ContextEngineConfig = z.infer<typeof ContextEngineConfigSchema>;
  */
 /** Progressive context pruning configuration (per-agent). */
 export declare const ContextPruningConfigSchema: z.ZodObject<{
-    /** Master toggle for progressive context pruning */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Context ratio at which soft-trim begins (head+tail preservation) */
     softTrimRatio: z.ZodDefault<z.ZodNumber>;
-    /** Context ratio at which hard-clear begins (full placeholder replacement) */
     hardClearRatio: z.ZodDefault<z.ZodNumber>;
-    /** Number of recent assistant messages to protect from pruning */
     keepLastAssistants: z.ZodDefault<z.ZodNumber>;
-    /** Minimum tool result size in characters eligible for soft-trim */
     minPrunableToolChars: z.ZodDefault<z.ZodNumber>;
-    /** Tool names never pruned (strings in config, converted to RegExp patterns at runtime by consumer) */
     protectedTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 /** Source gate configuration for HTTP response size and sanitization (per-agent). */
 export declare const SourceGateConfigSchema: z.ZodObject<{
-    /** Default byte cap for HTTP responses (matches DEFAULT_SOURCE_PROFILES.web_fetch.maxResponseBytes) */
     maxResponseBytes: z.ZodDefault<z.ZodNumber>;
-    /** Whether to strip hidden HTML before extraction */
     stripHiddenHtml: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export type ContextPruningConfig = z.infer<typeof ContextPruningConfigSchema>;
@@ -520,46 +372,29 @@ export type SourceGateConfig = z.infer<typeof SourceGateConfigSchema>;
  */
 /** Routing binding: maps channel/peer/guild patterns to a specific agent. */
 export declare const RoutingBindingSchema: z.ZodObject<{
-    /** Channel type to match (e.g. "telegram", "discord") */
     channelType: z.ZodOptional<z.ZodString>;
-    /** Channel identifier to match */
     channelId: z.ZodOptional<z.ZodString>;
-    /** Peer (user) identifier to match */
     peerId: z.ZodOptional<z.ZodString>;
-    /** Guild (server/group) identifier to match */
     guildId: z.ZodOptional<z.ZodString>;
-    /** Agent ID to route to when this binding matches */
     agentId: z.ZodString;
 }, z.core.$strict>;
 /** Routing configuration for multi-agent dispatch. */
 export declare const RoutingConfigSchema: z.ZodObject<{
-    /** Agent ID to use when no routing binding matches */
     defaultAgentId: z.ZodDefault<z.ZodString>;
-    /** Ordered list of routing bindings (first match wins) */
     bindings: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Channel type to match (e.g. "telegram", "discord") */
         channelType: z.ZodOptional<z.ZodString>;
-        /** Channel identifier to match */
         channelId: z.ZodOptional<z.ZodString>;
-        /** Peer (user) identifier to match */
         peerId: z.ZodOptional<z.ZodString>;
-        /** Guild (server/group) identifier to match */
         guildId: z.ZodOptional<z.ZodString>;
-        /** Agent ID to route to when this binding matches */
         agentId: z.ZodString;
     }, z.core.$strict>>>;
 }, z.core.$strict>;
 /** RAG (Retrieval-Augmented Generation) configuration for automatic memory retrieval before LLM calls. */
 export declare const RagConfigSchema: z.ZodObject<{
-    /** Enable automatic memory retrieval before LLM calls */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Maximum number of memory results to retrieve */
     maxResults: z.ZodDefault<z.ZodNumber>;
-    /** Maximum characters of memory context to inject into system prompt */
     maxContextChars: z.ZodDefault<z.ZodNumber>;
-    /** Minimum RRF score threshold (0-1) to include a memory result */
     minScore: z.ZodDefault<z.ZodNumber>;
-    /** Trust levels to include in retrieval (external excluded by default for security) */
     includeTrustLevels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
         system: "system";
         learned: "learned";
@@ -569,146 +404,102 @@ export declare const RagConfigSchema: z.ZodObject<{
 export type RagConfig = z.infer<typeof RagConfigSchema>;
 /** Bootstrap configuration for workspace file injection into system prompts. */
 export declare const BootstrapConfigSchema: z.ZodObject<{
-    /** Per-file character limit for workspace files injected into system prompt */
     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";
     }>>;
-    /** When true, USER.md is excluded from bootstrap context in group chat sessions (privacy). Default: true. */
     groupChatFiltering: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export type BootstrapConfig = z.infer<typeof BootstrapConfigSchema>;
 /** Per-agent concurrency limits (maxConcurrentRuns controls session serialization). */
 export declare const ConcurrencyConfigSchema: z.ZodObject<{
-    /** Maximum concurrent agent runs for this agent (default: 4) */
     maxConcurrentRuns: z.ZodDefault<z.ZodNumber>;
-    /** Maximum queued messages per session before overflow (default: 50) */
     maxQueuedPerSession: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export type ConcurrencyConfig = z.infer<typeof ConcurrencyConfigSchema>;
 /** Target channel for a broadcast group delivery. */
 export declare const BroadcastTargetSchema: z.ZodObject<{
-    /** Channel type (e.g., "telegram", "discord", "slack") */
     channelType: z.ZodString;
-    /** Channel identifier within the platform */
     channelId: z.ZodString;
-    /** Chat/conversation identifier within the channel */
     chatId: z.ZodString;
 }, z.core.$strict>;
 /** Broadcast group for simultaneous multi-channel message delivery. */
 export declare const BroadcastGroupSchema: z.ZodObject<{
-    /** Unique group identifier (referenced in broadcast tool calls) */
     id: z.ZodString;
-    /** Human-readable group name */
     name: z.ZodDefault<z.ZodString>;
-    /** Channel targets for simultaneous delivery */
     targets: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Channel type (e.g., "telegram", "discord", "slack") */
         channelType: z.ZodString;
-        /** Channel identifier within the platform */
         channelId: z.ZodString;
-        /** Chat/conversation identifier within the channel */
         chatId: z.ZodString;
     }, z.core.$strict>>>;
-    /** Whether this broadcast group is active */
     enabled: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export type BroadcastTarget = z.infer<typeof BroadcastTargetSchema>;
 export type BroadcastGroup = z.infer<typeof BroadcastGroupSchema>;
 /** Elevated reply mode: routes messages to different models based on sender trust level. */
 export declare const ElevatedReplyConfigSchema: z.ZodObject<{
-    /** Enable trust-based model/prompt routing */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Map of trust level name to model route name (from modelRoutes) */
     trustModelRoutes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-    /** Map of trust level name to system prompt section override text */
     trustPromptOverrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-    /** Default trust level for unknown senders */
     defaultTrustLevel: z.ZodDefault<z.ZodString>;
-    /** Per-sender trust level overrides (senderId -> trust level name) */
     senderTrustMap: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strict>;
 export type ElevatedReplyConfig = z.infer<typeof ElevatedReplyConfigSchema>;
 /** Per-agent JSONL trace configuration (disabled by default). */
 export declare const TracingConfigSchema: z.ZodObject<{
-    /** Enable per-LLM-call JSONL trace files */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Output directory for JSONL trace files. Supports ~ expansion. Default: ~/.comis/traces */
     outputDir: z.ZodDefault<z.ZodString>;
 }, z.core.$strict>;
 export type TracingConfig = z.infer<typeof TracingConfigSchema>;
 /** SDK retry configuration: controls exponential backoff for transient errors (429, 5xx).
  *  The SDK handles retry internally; this schema configures its behavior per-agent. */
 export declare const SdkRetryConfigSchema: z.ZodObject<{
-    /** Enable SDK-native retry with exponential backoff */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Maximum number of retry attempts for transient errors (5 retries = 6 total attempts) */
     maxRetries: z.ZodDefault<z.ZodNumber>;
-    /** Base delay in milliseconds before first retry (4s base with exponential backoff: 4s, 8s, 16s, 32s, 60s capped) */
     baseDelayMs: z.ZodDefault<z.ZodNumber>;
-    /** Maximum delay cap in milliseconds between retries */
     maxDelayMs: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export type SdkRetryConfig = z.infer<typeof SdkRetryConfigSchema>;
 /** Context window guard configuration: percent-based warn/block thresholds. */
 export declare const ContextGuardConfigSchema: z.ZodObject<{
-    /** Enable context window guard checks during execution */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Warn when context usage reaches this percent (0-100). Default: 80. */
     warnPercent: z.ZodDefault<z.ZodNumber>;
-    /** Block (abort) execution when context usage reaches this percent (0-100). Default: 95. */
     blockPercent: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export type ContextGuardConfig = z.infer<typeof ContextGuardConfigSchema>;
 /** Tool lifecycle management: per-turn usage tracking and automatic demotion of unused tools. */
 export declare const ToolLifecycleConfigSchema: z.ZodObject<{
-    /** Whether tool lifecycle management is enabled. When false, no usage tracking or demotion occurs. */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Number of turns of non-use before a tool is demoted (schema-stripped). */
     demotionThreshold: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export type ToolLifecycleConfig = z.infer<typeof ToolLifecycleConfigSchema>;
 /** Deferred tools configuration: operator control over tool deferral behavior per-agent. */
 export declare const DeferredToolsConfigSchema: z.ZodObject<{
-    /** Deferral mode: "always" defers all non-core tools, "auto" uses rule+budget heuristics, "never" disables deferral. */
     mode: z.ZodDefault<z.ZodEnum<{
         never: "never";
         always: "always";
         auto: "auto";
     }>>;
-    /** Tool names that must never be deferred (force-loaded into active context). Glob patterns NOT supported -- exact names only. */
     neverDefer: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Tool names that must always be deferred (force-deferred regardless of rules). Glob patterns NOT supported -- exact names only. */
     alwaysDefer: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type DeferredToolsConfig = z.infer<typeof DeferredToolsConfigSchema>;
 /** Silent Execution Planner (SEP) configuration: in-memory checklist system for multi-step task tracking. */
 export declare const SepConfigSchema: z.ZodObject<{
-    /** Enable/disable SEP. Default: true. */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Minimum estimated steps to activate planning (below this threshold, overhead isn't worth it). */
     minSteps: z.ZodDefault<z.ZodNumber>;
-    /** Whether to inject a verification nudge when all steps complete. Default: true. */
     verificationNudge: z.ZodDefault<z.ZodBoolean>;
-    /** Maximum plan steps to track (prevents runaway extraction on vague requests). */
     maxSteps: z.ZodDefault<z.ZodNumber>;
-    /** Whether to include progress in user-visible response. Default: false. */
     userVisibleProgress: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export type SepConfig = z.infer<typeof SepConfigSchema>;
 export declare const AgentConfigSchema: z.ZodObject<{
-    /** Display name for the agent */
     name: z.ZodDefault<z.ZodString>;
-    /** LLM model identifier — "default" resolves via models.defaultModel (e.g. "claude-sonnet-4-5-20250929") */
     model: z.ZodDefault<z.ZodString>;
-    /** LLM provider — "default" resolves via models.defaultProvider (e.g. "anthropic", "openai") */
     provider: z.ZodDefault<z.ZodString>;
-    /** Maximum reasoning steps per execution */
     maxSteps: z.ZodDefault<z.ZodNumber>;
-    /** SDK thinking level override (off/minimal/low/medium/high/xhigh). Optional -- only overrides when set. */
     thinkingLevel: z.ZodOptional<z.ZodEnum<{
         minimal: "minimal";
         off: "off";
@@ -717,231 +508,136 @@ export declare const AgentConfigSchema: z.ZodObject<{
         high: "high";
         xhigh: "xhigh";
     }>>;
-    /** SDK max tokens override. Optional -- only overrides when set. */
     maxTokens: z.ZodOptional<z.ZodNumber>;
-    /** SDK temperature override (0-2). Optional -- only overrides when set. */
     temperature: z.ZodOptional<z.ZodNumber>;
-    /**
-     * Prompt cache retention hint (none/short/long). Default: "long".
-     *
-     * Anthropic: Controls cache_control TTL marker injection.
-     * - "none": no caching markers added
-     * - "short": 5-minute ephemeral TTL (all Anthropic providers)
-     * - "long": 1-hour TTL on api.anthropic.com; Bedrock and Vertex silently fall back to 5-minute TTL
-     *
-     * Gemini: This field is NOT used for Gemini explicit caching (CachedContent API).
-     * Gemini cache TTL is controlled by geminiCache config and the GeminiCacheManager's
-     * ttlSeconds parameter (default: 3600s). Active sessions get TTL refresh at 50% interval.
-     * The cacheRetention value has no effect on Gemini providers.
-     */
     cacheRetention: z.ZodDefault<z.ZodEnum<{
         none: "none";
         short: "short";
         long: "long";
     }>>;
-    /** Per-model family cache retention overrides. Keys are model ID prefixes
-     *  (e.g., "claude-haiku", "claude-sonnet-4-6"). Longest-prefix-first matching.
-     *  Overrides the agent-level cacheRetention for matching models.
-     *  Set a model family to "none" to disable caching for debugging/testing. */
     cacheRetentionOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
         none: "none";
         short: "short";
         long: "long";
     }>>>;
-    /** When true, use adaptive cache retention (cold-start "short" -> "long" after N turns).
-     *  When false, use static retention from cacheRetention field.
-     *  Default: true -- adaptive retention saves ~$4/MTok on cold-start Opus calls. */
     adaptiveCacheRetention: z.ZodDefault<z.ZodBoolean>;
-    /** Cache breakpoint strategy. 'single' (default) minimizes KV page waste.
-     *  'auto' resolves to 'single' for direct Anthropic and 'multi-zone' for Bedrock/Vertex.
-     *  'multi-zone' places breakpoints across system, tools, and messages. */
     cacheBreakpointStrategy: z.ZodDefault<z.ZodEnum<{
         auto: "auto";
         "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>;
         maxActiveCaches: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** When true, only content inside <final> blocks reaches users (streaming + non-streaming). Default: false. */
     enforceFinalTag: z.ZodDefault<z.ZodBoolean>;
-    /** When true, enables fast/cheap model routing for simple requests. Default: false. */
     fastMode: z.ZodDefault<z.ZodBoolean>;
-    /** When true, OpenAI store: true is injected for completions storage. Default: false (privacy). */
     storeCompletions: z.ZodDefault<z.ZodBoolean>;
-    /** Maximum total characters for context window. Default: 100_000 (~25k tokens). */
     maxContextChars: z.ZodDefault<z.ZodNumber>;
-    /** Maximum characters per tool result before truncation. Default: 50_000. */
     maxToolResultChars: z.ZodDefault<z.ZodNumber>;
-    /** Minimum number of recent messages to always preserve during compaction. Default: 4. */
     preserveRecent: z.ZodDefault<z.ZodNumber>;
-    /** Token budget limits */
     budgets: z.ZodDefault<z.ZodObject<{
-        /** Max tokens per single execution */
         perExecution: z.ZodDefault<z.ZodNumber>;
-        /** Max tokens per hour (rolling window) */
         perHour: z.ZodDefault<z.ZodNumber>;
-        /** Max tokens per day (rolling window) */
         perDay: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Circuit breaker for provider failures */
     circuitBreaker: z.ZodDefault<z.ZodObject<{
-        /** Number of consecutive failures before opening circuit */
         failureThreshold: z.ZodDefault<z.ZodNumber>;
-        /** Milliseconds to wait before attempting recovery */
         resetTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Milliseconds for half-open probe timeout */
         halfOpenTimeoutMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Tool retry circuit breaker for blocking repeatedly-failing tools. */
     toolRetryBreaker: z.ZodDefault<z.ZodObject<{
-        /** Enable tool retry circuit breaker. Default: true. */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Max consecutive failures for same tool+args before blocking. Default: 3. */
         maxConsecutiveFailures: z.ZodDefault<z.ZodNumber>;
-        /** Max total failures for a tool name (any args) before blocking all calls. Default: 5. */
         maxToolFailures: z.ZodDefault<z.ZodNumber>;
-        /** Suggest alternative tools in block reason. Default: true. */
         suggestAlternatives: z.ZodDefault<z.ZodBoolean>;
-        /** Max consecutive same-error-class failures (any args) before blocking. Default: 2.
-         *  Stricter than args-based because same error + different args = stronger stuck signal. */
         maxConsecutiveErrorPatterns: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Workspace profile and settings */
     workspace: z.ZodDefault<z.ZodObject<{
         profile: z.ZodDefault<z.ZodEnum<{
             full: "full";
             specialist: "specialist";
         }>>;
     }, z.core.$strict>>;
-    /** Path to agent workspace directory containing identity files */
     workspacePath: z.ZodOptional<z.ZodString>;
-    /** Per-task model route overrides */
     modelRoutes: z.ZodDefault<z.ZodObject<{
         default: z.ZodOptional<z.ZodString>;
     }, z.core.$catchall<z.ZodString>>>;
-    /** RAG (Retrieval-Augmented Generation) memory context settings */
     rag: z.ZodDefault<z.ZodObject<{
-        /** Enable automatic memory retrieval before LLM calls */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum number of memory results to retrieve */
         maxResults: z.ZodDefault<z.ZodNumber>;
-        /** Maximum characters of memory context to inject into system prompt */
         maxContextChars: z.ZodDefault<z.ZodNumber>;
-        /** Minimum RRF score threshold (0-1) to include a memory result */
         minScore: z.ZodDefault<z.ZodNumber>;
-        /** Trust levels to include in retrieval (external excluded by default for security) */
         includeTrustLevels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
             system: "system";
             learned: "learned";
             external: "external";
         }>>>;
     }, z.core.$strict>>;
-    /** Bootstrap workspace file injection settings */
     bootstrap: z.ZodDefault<z.ZodObject<{
-        /** Per-file character limit for workspace files injected into system prompt */
         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";
         }>>;
-        /** When true, USER.md is excluded from bootstrap context in group chat sessions (privacy). Default: true. */
         groupChatFiltering: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
-    /** Reaction frequency mode: minimal (1 per 5-10 exchanges) or extensive (react freely). Omit to disable reaction guidance. */
     reactionLevel: z.ZodOptional<z.ZodEnum<{
         minimal: "minimal";
         extensive: "extensive";
     }>>;
-    /** Model failover and auth rotation settings */
     modelFailover: z.ZodDefault<z.ZodObject<{
-        /** Ordered list of fallback models to try when primary fails */
         fallbackModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** LLM provider (e.g. "anthropic", "openai") */
             provider: z.ZodString;
-            /** Model identifier at the provider */
             modelId: z.ZodString;
         }, z.core.$strict>>>;
-        /** Per-provider API key profiles for auth rotation */
         authProfiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Key name in SecretManager (e.g. "ANTHROPIC_API_KEY_2") */
             keyName: z.ZodString;
-            /** Provider this key belongs to (e.g. "anthropic") */
             provider: z.ZodString;
         }, z.core.$strict>>>;
-        /** Model allowlist (empty = allow all models) */
         allowedModels: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Maximum total attempts across all models/keys */
         maxAttempts: z.ZodDefault<z.ZodNumber>;
-        /** Initial cooldown duration in milliseconds (1 min) */
         cooldownInitialMs: z.ZodDefault<z.ZodNumber>;
-        /** Exponential cooldown multiplier */
         cooldownMultiplier: z.ZodDefault<z.ZodNumber>;
-        /** Maximum cooldown duration in milliseconds (1 hr) */
         cooldownCapMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** SDK retry configuration (exponential backoff for 429/5xx transient errors) */
     sdkRetry: z.ZodDefault<z.ZodObject<{
-        /** Enable SDK-native retry with exponential backoff */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum number of retry attempts for transient errors (5 retries = 6 total attempts) */
         maxRetries: z.ZodDefault<z.ZodNumber>;
-        /** Base delay in milliseconds before first retry (4s base with exponential backoff: 4s, 8s, 16s, 32s, 60s capped) */
         baseDelayMs: z.ZodDefault<z.ZodNumber>;
-        /** Maximum delay cap in milliseconds between retries */
         maxDelayMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Prompt timeout configuration (wall-clock timeouts for LLM calls) */
     promptTimeout: z.ZodDefault<z.ZodObject<{
-        /** Wall-clock timeout for primary prompt calls in milliseconds. Default: 180s. */
         promptTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Wall-clock timeout for retry prompt calls in milliseconds. Default: 60s. */
         retryPromptTimeoutMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Per-operation model override configuration (model tiering). */
     operationModels: z.ZodDefault<z.ZodObject<{
         cron: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         heartbeat: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         subagent: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         compaction: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         taskExtraction: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         condensation: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
@@ -951,75 +647,41 @@ export type RoutingBinding = z.infer<typeof RoutingBindingSchema>;
 export type RoutingConfig = z.infer<typeof RoutingConfigSchema>;
 /** Per-agent cron configuration (enabled defaults to true). */
 export declare const PerAgentCronConfigSchema: z.ZodObject<{
-    /** Enable cron job scheduling for this agent */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Maximum concurrent cron job runs for this agent */
     maxConcurrentRuns: z.ZodDefault<z.ZodNumber>;
-    /** Default timezone for cron expressions (empty = UTC) */
     defaultTimezone: z.ZodDefault<z.ZodString>;
-    /** Maximum number of cron jobs allowed for this agent (0 = unlimited) */
     maxJobs: z.ZodDefault<z.ZodNumber>;
-    /** Maximum consecutive errors before auto-suspending a cron job (0 = never suspend). Per-agent override. */
     maxConsecutiveErrors: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /** Per-agent heartbeat delivery target (which channel to send heartbeat notifications to). */
 export declare const HeartbeatTargetSchema: z.ZodObject<{
-    /** Channel type (e.g., "telegram", "discord") */
     channelType: z.ZodString;
-    /** Channel identifier within the platform */
     channelId: z.ZodString;
-    /** Chat/conversation identifier */
     chatId: z.ZodString;
-    /** Whether this target is a DM conversation (for DM delivery policy) */
     isDm: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 /** Per-agent heartbeat config: all fields optional (inherit from global scheduler.heartbeat). */
 export declare const PerAgentHeartbeatConfigSchema: z.ZodObject<{
-    /** Override heartbeat enabled state for this agent */
     enabled: z.ZodOptional<z.ZodBoolean>;
-    /** Override heartbeat interval in milliseconds */
     intervalMs: z.ZodOptional<z.ZodNumber>;
-    /** Override show OK status */
     showOk: z.ZodOptional<z.ZodBoolean>;
-    /** Override show alerts */
     showAlerts: z.ZodOptional<z.ZodBoolean>;
-    /** Delivery target channel for this agent's heartbeat notifications */
     target: z.ZodOptional<z.ZodObject<{
-        /** Channel type (e.g., "telegram", "discord") */
         channelType: z.ZodString;
-        /** Channel identifier within the platform */
         channelId: z.ZodString;
-        /** Chat/conversation identifier */
         chatId: z.ZodString;
-        /** Whether this target is a DM conversation (for DM delivery policy) */
         isDm: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
-    /** Custom heartbeat prompt for this agent */
     prompt: z.ZodOptional<z.ZodString>;
-    /** Session key for heartbeat conversation isolation */
     session: z.ZodOptional<z.ZodString>;
-    /** Whether heartbeat alerts can be delivered to DM conversations (default: true) */
     allowDm: z.ZodOptional<z.ZodBoolean>;
-    /** When true, heartbeat bootstrap context includes ONLY HEARTBEAT.md (cost optimization) */
     lightContext: z.ZodOptional<z.ZodBoolean>;
-    /** Maximum characters for soft acknowledgment threshold (default applied in scheduler, not schema) */
     ackMaxChars: z.ZodOptional<z.ZodNumber>;
-    /** Prefix to strip from LLM responses before delivery */
     responsePrefix: z.ZodOptional<z.ZodString>;
-    /** Whether to suppress delivery of HEARTBEAT_OK-only responses from cron triggers (default applied in scheduler) */
     skipHeartbeatOnlyDelivery: z.ZodOptional<z.ZodBoolean>;
-    /** Override consecutive failure threshold for alerting (per-agent) */
     alertThreshold: z.ZodOptional<z.ZodNumber>;
-    /** Override alert cooldown period in ms (per-agent) */
     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>>;
@@ -1030,66 +692,34 @@ export type HeartbeatTarget = z.infer<typeof HeartbeatTargetSchema>;
 export type PerAgentHeartbeatConfig = z.infer<typeof PerAgentHeartbeatConfigSchema>;
 /** Per-agent scheduler configuration (wraps cron and heartbeat settings). */
 export declare const PerAgentSchedulerConfigSchema: z.ZodObject<{
-    /** Per-agent cron configuration */
     cron: z.ZodDefault<z.ZodObject<{
-        /** Enable cron job scheduling for this agent */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum concurrent cron job runs for this agent */
         maxConcurrentRuns: z.ZodDefault<z.ZodNumber>;
-        /** Default timezone for cron expressions (empty = UTC) */
         defaultTimezone: z.ZodDefault<z.ZodString>;
-        /** Maximum number of cron jobs allowed for this agent (0 = unlimited) */
         maxJobs: z.ZodDefault<z.ZodNumber>;
-        /** Maximum consecutive errors before auto-suspending a cron job (0 = never suspend). Per-agent override. */
         maxConsecutiveErrors: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Per-agent heartbeat configuration (optional -- inherits from global scheduler.heartbeat) */
     heartbeat: z.ZodOptional<z.ZodObject<{
-        /** Override heartbeat enabled state for this agent */
         enabled: z.ZodOptional<z.ZodBoolean>;
-        /** Override heartbeat interval in milliseconds */
         intervalMs: z.ZodOptional<z.ZodNumber>;
-        /** Override show OK status */
         showOk: z.ZodOptional<z.ZodBoolean>;
-        /** Override show alerts */
         showAlerts: z.ZodOptional<z.ZodBoolean>;
-        /** Delivery target channel for this agent's heartbeat notifications */
         target: z.ZodOptional<z.ZodObject<{
-            /** Channel type (e.g., "telegram", "discord") */
             channelType: z.ZodString;
-            /** Channel identifier within the platform */
             channelId: z.ZodString;
-            /** Chat/conversation identifier */
             chatId: z.ZodString;
-            /** Whether this target is a DM conversation (for DM delivery policy) */
             isDm: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
-        /** Custom heartbeat prompt for this agent */
         prompt: z.ZodOptional<z.ZodString>;
-        /** Session key for heartbeat conversation isolation */
         session: z.ZodOptional<z.ZodString>;
-        /** Whether heartbeat alerts can be delivered to DM conversations (default: true) */
         allowDm: z.ZodOptional<z.ZodBoolean>;
-        /** When true, heartbeat bootstrap context includes ONLY HEARTBEAT.md (cost optimization) */
         lightContext: z.ZodOptional<z.ZodBoolean>;
-        /** Maximum characters for soft acknowledgment threshold (default applied in scheduler, not schema) */
         ackMaxChars: z.ZodOptional<z.ZodNumber>;
-        /** Prefix to strip from LLM responses before delivery */
         responsePrefix: z.ZodOptional<z.ZodString>;
-        /** Whether to suppress delivery of HEARTBEAT_OK-only responses from cron triggers (default applied in scheduler) */
         skipHeartbeatOnlyDelivery: z.ZodOptional<z.ZodBoolean>;
-        /** Override consecutive failure threshold for alerting (per-agent) */
         alertThreshold: z.ZodOptional<z.ZodNumber>;
-        /** Override alert cooldown period in ms (per-agent) */
         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>>;
@@ -1143,32 +773,20 @@ export declare const PerAgentConfigSchema: z.ZodObject<{
     maxToolResultChars: z.ZodDefault<z.ZodNumber>;
     preserveRecent: z.ZodDefault<z.ZodNumber>;
     budgets: z.ZodDefault<z.ZodObject<{
-        /** Max tokens per single execution */
         perExecution: z.ZodDefault<z.ZodNumber>;
-        /** Max tokens per hour (rolling window) */
         perHour: z.ZodDefault<z.ZodNumber>;
-        /** Max tokens per day (rolling window) */
         perDay: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     circuitBreaker: z.ZodDefault<z.ZodObject<{
-        /** Number of consecutive failures before opening circuit */
         failureThreshold: z.ZodDefault<z.ZodNumber>;
-        /** Milliseconds to wait before attempting recovery */
         resetTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Milliseconds for half-open probe timeout */
         halfOpenTimeoutMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     toolRetryBreaker: z.ZodDefault<z.ZodObject<{
-        /** Enable tool retry circuit breaker. Default: true. */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Max consecutive failures for same tool+args before blocking. Default: 3. */
         maxConsecutiveFailures: z.ZodDefault<z.ZodNumber>;
-        /** Max total failures for a tool name (any args) before blocking all calls. Default: 5. */
         maxToolFailures: z.ZodDefault<z.ZodNumber>;
-        /** Suggest alternative tools in block reason. Default: true. */
         suggestAlternatives: z.ZodDefault<z.ZodBoolean>;
-        /** Max consecutive same-error-class failures (any args) before blocking. Default: 2.
-         *  Stricter than args-based because same error + different args = stronger stuck signal. */
         maxConsecutiveErrorPatterns: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     workspace: z.ZodDefault<z.ZodObject<{
@@ -1182,15 +800,10 @@ export declare const PerAgentConfigSchema: z.ZodObject<{
         default: z.ZodOptional<z.ZodString>;
     }, z.core.$catchall<z.ZodString>>>;
     rag: z.ZodDefault<z.ZodObject<{
-        /** Enable automatic memory retrieval before LLM calls */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum number of memory results to retrieve */
         maxResults: z.ZodDefault<z.ZodNumber>;
-        /** Maximum characters of memory context to inject into system prompt */
         maxContextChars: z.ZodDefault<z.ZodNumber>;
-        /** Minimum RRF score threshold (0-1) to include a memory result */
         minScore: z.ZodDefault<z.ZodNumber>;
-        /** Trust levels to include in retrieval (external excluded by default for security) */
         includeTrustLevels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
             system: "system";
             learned: "learned";
@@ -1198,15 +811,12 @@ export declare const PerAgentConfigSchema: z.ZodObject<{
         }>>>;
     }, z.core.$strict>>;
     bootstrap: z.ZodDefault<z.ZodObject<{
-        /** Per-file character limit for workspace files injected into system prompt */
         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";
         }>>;
-        /** When true, USER.md is excluded from bootstrap context in group chat sessions (privacy). Default: true. */
         groupChatFiltering: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
     reactionLevel: z.ZodOptional<z.ZodEnum<{
@@ -1214,82 +824,53 @@ export declare const PerAgentConfigSchema: z.ZodObject<{
         extensive: "extensive";
     }>>;
     modelFailover: z.ZodDefault<z.ZodObject<{
-        /** Ordered list of fallback models to try when primary fails */
         fallbackModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** LLM provider (e.g. "anthropic", "openai") */
             provider: z.ZodString;
-            /** Model identifier at the provider */
             modelId: z.ZodString;
         }, z.core.$strict>>>;
-        /** Per-provider API key profiles for auth rotation */
         authProfiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Key name in SecretManager (e.g. "ANTHROPIC_API_KEY_2") */
             keyName: z.ZodString;
-            /** Provider this key belongs to (e.g. "anthropic") */
             provider: z.ZodString;
         }, z.core.$strict>>>;
-        /** Model allowlist (empty = allow all models) */
         allowedModels: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Maximum total attempts across all models/keys */
         maxAttempts: z.ZodDefault<z.ZodNumber>;
-        /** Initial cooldown duration in milliseconds (1 min) */
         cooldownInitialMs: z.ZodDefault<z.ZodNumber>;
-        /** Exponential cooldown multiplier */
         cooldownMultiplier: z.ZodDefault<z.ZodNumber>;
-        /** Maximum cooldown duration in milliseconds (1 hr) */
         cooldownCapMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     sdkRetry: z.ZodDefault<z.ZodObject<{
-        /** Enable SDK-native retry with exponential backoff */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum number of retry attempts for transient errors (5 retries = 6 total attempts) */
         maxRetries: z.ZodDefault<z.ZodNumber>;
-        /** Base delay in milliseconds before first retry (4s base with exponential backoff: 4s, 8s, 16s, 32s, 60s capped) */
         baseDelayMs: z.ZodDefault<z.ZodNumber>;
-        /** Maximum delay cap in milliseconds between retries */
         maxDelayMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     promptTimeout: z.ZodDefault<z.ZodObject<{
-        /** Wall-clock timeout for primary prompt calls in milliseconds. Default: 180s. */
         promptTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Wall-clock timeout for retry prompt calls in milliseconds. Default: 60s. */
         retryPromptTimeoutMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     operationModels: z.ZodDefault<z.ZodObject<{
         cron: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         heartbeat: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         subagent: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         compaction: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         taskExtraction: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         condensation: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
@@ -1349,66 +930,34 @@ export declare const PerAgentConfigSchema: z.ZodObject<{
         watchDebounceMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     scheduler: z.ZodOptional<z.ZodObject<{
-        /** Per-agent cron configuration */
         cron: z.ZodDefault<z.ZodObject<{
-            /** Enable cron job scheduling for this agent */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Maximum concurrent cron job runs for this agent */
             maxConcurrentRuns: z.ZodDefault<z.ZodNumber>;
-            /** Default timezone for cron expressions (empty = UTC) */
             defaultTimezone: z.ZodDefault<z.ZodString>;
-            /** Maximum number of cron jobs allowed for this agent (0 = unlimited) */
             maxJobs: z.ZodDefault<z.ZodNumber>;
-            /** Maximum consecutive errors before auto-suspending a cron job (0 = never suspend). Per-agent override. */
             maxConsecutiveErrors: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
-        /** Per-agent heartbeat configuration (optional -- inherits from global scheduler.heartbeat) */
         heartbeat: z.ZodOptional<z.ZodObject<{
-            /** Override heartbeat enabled state for this agent */
             enabled: z.ZodOptional<z.ZodBoolean>;
-            /** Override heartbeat interval in milliseconds */
             intervalMs: z.ZodOptional<z.ZodNumber>;
-            /** Override show OK status */
             showOk: z.ZodOptional<z.ZodBoolean>;
-            /** Override show alerts */
             showAlerts: z.ZodOptional<z.ZodBoolean>;
-            /** Delivery target channel for this agent's heartbeat notifications */
             target: z.ZodOptional<z.ZodObject<{
-                /** Channel type (e.g., "telegram", "discord") */
                 channelType: z.ZodString;
-                /** Channel identifier within the platform */
                 channelId: z.ZodString;
-                /** Chat/conversation identifier */
                 chatId: z.ZodString;
-                /** Whether this target is a DM conversation (for DM delivery policy) */
                 isDm: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strict>>;
-            /** Custom heartbeat prompt for this agent */
             prompt: z.ZodOptional<z.ZodString>;
-            /** Session key for heartbeat conversation isolation */
             session: z.ZodOptional<z.ZodString>;
-            /** Whether heartbeat alerts can be delivered to DM conversations (default: true) */
             allowDm: z.ZodOptional<z.ZodBoolean>;
-            /** When true, heartbeat bootstrap context includes ONLY HEARTBEAT.md (cost optimization) */
             lightContext: z.ZodOptional<z.ZodBoolean>;
-            /** Maximum characters for soft acknowledgment threshold (default applied in scheduler, not schema) */
             ackMaxChars: z.ZodOptional<z.ZodNumber>;
-            /** Prefix to strip from LLM responses before delivery */
             responsePrefix: z.ZodOptional<z.ZodString>;
-            /** Whether to suppress delivery of HEARTBEAT_OK-only responses from cron triggers (default applied in scheduler) */
             skipHeartbeatOnlyDelivery: z.ZodOptional<z.ZodBoolean>;
-            /** Override consecutive failure threshold for alerting (per-agent) */
             alertThreshold: z.ZodOptional<z.ZodNumber>;
-            /** Override alert cooldown period in ms (per-agent) */
             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>>;
@@ -1418,311 +967,184 @@ export declare const PerAgentConfigSchema: z.ZodObject<{
     }, z.core.$strict>>;
     session: z.ZodOptional<z.ZodObject<{
         resetPolicy: z.ZodOptional<z.ZodObject<{
-            /** Reset mode: daily, idle, hybrid (first-to-expire), or none (disabled) */
             mode: z.ZodDefault<z.ZodEnum<{
                 daily: "daily";
                 idle: "idle";
                 hybrid: "hybrid";
                 none: "none";
             }>>;
-            /** Hour of day for daily reset (0-23, default 4 = 4 AM) */
             dailyResetHour: z.ZodDefault<z.ZodNumber>;
-            /** IANA timezone for daily reset (empty string = system local) */
             dailyResetTimezone: z.ZodDefault<z.ZodString>;
-            /** Idle timeout in milliseconds (default 4 hours = 14_400_000) */
             idleTimeoutMs: z.ZodDefault<z.ZodNumber>;
-            /** Sweep interval in milliseconds (how often to check sessions, default 5 min) */
             sweepIntervalMs: z.ZodDefault<z.ZodNumber>;
-            /** Phrases that trigger immediate session reset when sent as a message */
             resetTriggers: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            /** Per-session-type overrides (dm, group, thread) */
             perType: z.ZodDefault<z.ZodObject<{
                 dm: z.ZodOptional<z.ZodObject<{
-                    /** Override reset mode for this session type */
                     mode: z.ZodOptional<z.ZodEnum<{
                         daily: "daily";
                         idle: "idle";
                         hybrid: "hybrid";
                         none: "none";
                     }>>;
-                    /** Override daily reset hour (0-23) */
                     dailyResetHour: z.ZodOptional<z.ZodNumber>;
-                    /** Override IANA timezone for daily reset */
                     dailyResetTimezone: z.ZodOptional<z.ZodString>;
-                    /** Override idle timeout in milliseconds */
                     idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strict>>;
                 group: z.ZodOptional<z.ZodObject<{
-                    /** Override reset mode for this session type */
                     mode: z.ZodOptional<z.ZodEnum<{
                         daily: "daily";
                         idle: "idle";
                         hybrid: "hybrid";
                         none: "none";
                     }>>;
-                    /** Override daily reset hour (0-23) */
                     dailyResetHour: z.ZodOptional<z.ZodNumber>;
-                    /** Override IANA timezone for daily reset */
                     dailyResetTimezone: z.ZodOptional<z.ZodString>;
-                    /** Override idle timeout in milliseconds */
                     idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strict>>;
                 thread: z.ZodOptional<z.ZodObject<{
-                    /** Override reset mode for this session type */
                     mode: z.ZodOptional<z.ZodEnum<{
                         daily: "daily";
                         idle: "idle";
                         hybrid: "hybrid";
                         none: "none";
                     }>>;
-                    /** Override daily reset hour (0-23) */
                     dailyResetHour: z.ZodOptional<z.ZodNumber>;
-                    /** Override IANA timezone for daily reset */
                     dailyResetTimezone: z.ZodOptional<z.ZodString>;
-                    /** Override idle timeout in milliseconds */
                     idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strict>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
         dmScope: z.ZodOptional<z.ZodObject<{
-            /** DM scope mode controlling session isolation granularity */
             mode: z.ZodDefault<z.ZodEnum<{
                 main: "main";
                 "per-peer": "per-peer";
                 "per-channel-peer": "per-channel-peer";
                 "per-account-channel-peer": "per-account-channel-peer";
             }>>;
-            /** Prepend agent:<agentId>: to session keys for multi-agent isolation */
             agentPrefix: z.ZodDefault<z.ZodBoolean>;
-            /** Append :thread:<threadId> to session keys for forum/thread isolation */
             threadIsolation: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strict>>;
         pruning: z.ZodOptional<z.ZodObject<{
-            /** Enable session pruning of oversized tool results */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Character threshold above which tool results are soft-trimmed (head + tail with marker) */
             softTrimThresholdChars: z.ZodDefault<z.ZodNumber>;
-            /** Character threshold above which tool results are hard-cleared (entire content replaced) */
             hardClearThresholdChars: z.ZodDefault<z.ZodNumber>;
-            /** Number of characters to preserve at the start of a soft-trimmed result */
             preserveHeadChars: z.ZodDefault<z.ZodNumber>;
-            /** Number of characters to preserve at the end of a soft-trimmed result */
             preserveTailChars: z.ZodDefault<z.ZodNumber>;
-            /** Tools whose results are eligible for pruning (empty = all tools eligible) */
             pruneableTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            /** Tools whose results are never pruned (takes precedence over pruneableTools) */
             protectedTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            /** Protect tool results containing image content blocks from pruning */
             protectImageBlocks: z.ZodDefault<z.ZodBoolean>;
-            /** Number of recent messages (from end of array) exempt from pruning */
             preserveRecentCount: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
         compaction: z.ZodOptional<z.ZodObject<{
-            /** Fraction of maxContextChars at which soft flush triggers (memory extraction only) */
             softThresholdRatio: z.ZodDefault<z.ZodNumber>;
-            /** Fraction of maxContextChars at which hard compaction triggers (flush + trim) */
             hardThresholdRatio: z.ZodDefault<z.ZodNumber>;
-            /** Model to use for memory extraction during flush (defaults to cheap model) */
             flushModel: z.ZodOptional<z.ZodString>;
-            /** Max characters per summarization chunk. Default: 50_000. */
             chunkMaxChars: z.ZodDefault<z.ZodNumber>;
-            /** Number of overlap messages between chunks. Default: 2. */
             chunkOverlapMessages: z.ZodDefault<z.ZodNumber>;
-            /** Whether to merge chunk summaries via LLM. Default: true. */
             chunkMergeSummaries: z.ZodDefault<z.ZodBoolean>;
-            /** Tokens reserved for summary during SDK auto-compaction. Default: 16384. */
             reserveTokens: z.ZodDefault<z.ZodNumber>;
-            /** Tokens worth of recent messages to keep after SDK auto-compaction. Default: 32768. */
             keepRecentTokens: z.ZodDefault<z.ZodNumber>;
-            /** AGENTS.md section names to re-inject after compaction. */
             postCompactionSections: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
     concurrency: z.ZodDefault<z.ZodObject<{
-        /** Maximum concurrent agent runs for this agent (default: 4) */
         maxConcurrentRuns: z.ZodDefault<z.ZodNumber>;
-        /** Maximum queued messages per session before overflow (default: 50) */
         maxQueuedPerSession: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     broadcastGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Unique group identifier (referenced in broadcast tool calls) */
         id: z.ZodString;
-        /** Human-readable group name */
         name: z.ZodDefault<z.ZodString>;
-        /** Channel targets for simultaneous delivery */
         targets: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Channel type (e.g., "telegram", "discord", "slack") */
             channelType: z.ZodString;
-            /** Channel identifier within the platform */
             channelId: z.ZodString;
-            /** Chat/conversation identifier within the channel */
             chatId: z.ZodString;
         }, z.core.$strict>>>;
-        /** Whether this broadcast group is active */
         enabled: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>>;
     elevatedReply: z.ZodDefault<z.ZodObject<{
-        /** Enable trust-based model/prompt routing */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Map of trust level name to model route name (from modelRoutes) */
         trustModelRoutes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-        /** Map of trust level name to system prompt section override text */
         trustPromptOverrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-        /** Default trust level for unknown senders */
         defaultTrustLevel: z.ZodDefault<z.ZodString>;
-        /** Per-sender trust level overrides (senderId -> trust level name) */
         senderTrustMap: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strict>>;
     tracing: z.ZodDefault<z.ZodObject<{
-        /** Enable per-LLM-call JSONL trace files */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Output directory for JSONL trace files. Supports ~ expansion. Default: ~/.comis/traces */
         outputDir: z.ZodDefault<z.ZodString>;
     }, z.core.$strict>>;
     secrets: z.ZodOptional<z.ZodObject<{
         allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
     contextGuard: z.ZodDefault<z.ZodObject<{
-        /** Enable context window guard checks during execution */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Warn when context usage reaches this percent (0-100). Default: 80. */
         warnPercent: z.ZodDefault<z.ZodNumber>;
-        /** Block (abort) execution when context usage reaches this percent (0-100). Default: 95. */
         blockPercent: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     contextPruning: z.ZodOptional<z.ZodObject<{
-        /** Master toggle for progressive context pruning */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Context ratio at which soft-trim begins (head+tail preservation) */
         softTrimRatio: z.ZodDefault<z.ZodNumber>;
-        /** Context ratio at which hard-clear begins (full placeholder replacement) */
         hardClearRatio: z.ZodDefault<z.ZodNumber>;
-        /** Number of recent assistant messages to protect from pruning */
         keepLastAssistants: z.ZodDefault<z.ZodNumber>;
-        /** Minimum tool result size in characters eligible for soft-trim */
         minPrunableToolChars: z.ZodDefault<z.ZodNumber>;
-        /** Tool names never pruned (strings in config, converted to RegExp patterns at runtime by consumer) */
         protectedTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
     contextEngine: z.ZodOptional<z.ZodObject<{
-        /** Master toggle for the context engine pipeline (enabled by default). */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Operating mode: "pipeline" for sequential layer composition, "dag" for graph-based context management. */
         version: z.ZodDefault<z.ZodEnum<{
             pipeline: "pipeline";
             dag: "dag";
         }>>;
-        /** Number of recent assistant turns that retain thinking blocks (older turns get stripped). */
         thinkingKeepTurns: z.ZodDefault<z.ZodNumber>;
-        /** Idle gap (ms) above which signed thinking state is treated as drifted and
-         *  scrubbed pre-send to avoid provider replay-rejection. Default 30 min —
-         *  below long-TTL caches and below the 74-min production incident gap. Also
-         *  triggers on model id / provider / api change (those checks are
-         *  unconditional regardless of this idle threshold). Range: 1 min .. 24 h. */
         replayDriftIdleMs: z.ZodDefault<z.ZodNumber>;
-        /** Model for LLM compaction in "provider:modelId" format. Empty string
-         *  (the default) triggers runtime resolution against the agent's primary
-         *  provider via pi-ai catalog (fast-tier cost model). Avoids pinning a
-         *  hardcoded Anthropic literal that goes stale on pi-ai upgrades and
-         *  cross-routes background ops to Claude when primary is OpenRouter/Google/etc. */
         compactionModel: z.ZodDefault<z.ZodString>;
-        /** Minimum age (in tool result positions) before content is eligible for dead content eviction. */
         evictionMinAge: z.ZodDefault<z.ZodNumber>;
-        /** Number of recent user turns to keep in context (default 15). */
         historyTurns: z.ZodDefault<z.ZodNumber>;
-        /** Per-agent or per-channel-type turn count overrides (e.g., { dm: 10, "trader-1": 30 }). */
         historyTurnOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        /** Number of most recent tool uses that retain full content (older ones are masked). */
         observationKeepWindow: z.ZodDefault<z.ZodNumber>;
-        /** Character threshold before observation masking activates (below this, masking is skipped). */
         observationTriggerChars: z.ZodDefault<z.ZodNumber>;
-        /** Character threshold below which observation masking deactivates (hysteresis). */
         observationDeactivationChars: z.ZodDefault<z.ZodNumber>;
-        /** Keep window for ephemeral-tier tools (web_search, brave_search, web_fetch, link_reader, fetch_url). Shorter than observationKeepWindow. Default: 10. */
         ephemeralKeepWindow: z.ZodDefault<z.ZodNumber>;
-        /** Turns to wait before re-triggering LLM compaction after a successful compaction. */
         compactionCooldownTurns: z.ZodDefault<z.ZodNumber>;
-        /** Number of user-turn cycles at the head of conversation to preserve during
-         *  LLM compaction for cache prefix stability. 0 = old behavior
-         *  (summarize everything, keep tail only). */
         compactionPrefixAnchorTurns: z.ZodDefault<z.ZodNumber>;
-        /** Output escalation configuration: auto-retry with higher output budget on max_tokens truncation. */
         outputEscalation: z.ZodDefault<z.ZodObject<{
-            /** Master toggle for output escalation. When false, max_tokens truncation is not retried. */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Escalated max output tokens for the retry attempt. Must be between 4096 and 128000. */
             escalatedMaxTokens: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
-        /** Number of most recent turns always included verbatim in DAG context. */
         freshTailTurns: z.ZodDefault<z.ZodNumber>;
-        /** Context utilization fraction that triggers DAG compaction (0.1 to 0.95). */
         contextThreshold: z.ZodDefault<z.ZodNumber>;
-        /** Minimum fan-out for leaf nodes in the DAG. */
         leafMinFanout: z.ZodDefault<z.ZodNumber>;
-        /** Minimum fan-out for condensed (non-leaf) nodes in the DAG. */
         condensedMinFanout: z.ZodDefault<z.ZodNumber>;
-        /** Hard minimum fan-out for condensed nodes (lowest allowed). */
         condensedMinFanoutHard: z.ZodDefault<z.ZodNumber>;
-        /** Maximum depth for incremental DAG rebuilds (-1 = full rebuild). */
         incrementalMaxDepth: z.ZodDefault<z.ZodNumber>;
-        /** Token budget for leaf node chunks in the DAG. */
         leafChunkTokens: z.ZodDefault<z.ZodNumber>;
-        /** Target token size for leaf node summaries. */
         leafTargetTokens: z.ZodDefault<z.ZodNumber>;
-        /** Target token size for condensed node summaries. */
         condensedTargetTokens: z.ZodDefault<z.ZodNumber>;
-        /** Maximum tokens for expanded context retrieval. */
         maxExpandTokens: z.ZodDefault<z.ZodNumber>;
-        /** Maximum recall operations per day per agent. */
         maxRecallsPerDay: z.ZodDefault<z.ZodNumber>;
-        /** Timeout for recall operations in milliseconds. */
         recallTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Token threshold above which a file is considered "large" for DAG processing. */
         largeFileTokenThreshold: z.ZodDefault<z.ZodNumber>;
-        /** Number of most recent annotations retained in DAG mode (analogous to observationKeepWindow). */
         annotationKeepWindow: z.ZodDefault<z.ZodNumber>;
-        /** Character threshold before annotation eviction activates in DAG mode. */
         annotationTriggerChars: z.ZodDefault<z.ZodNumber>;
-        /** Optional model override for DAG summary generation in "provider:modelId" format. */
         summaryModel: z.ZodOptional<z.ZodString>;
-        /** Optional provider override for DAG summary generation. */
         summaryProvider: z.ZodOptional<z.ZodString>;
-        /** Post-batch continuation handler: when the LLM emits an empty final
-         *  turn after a successful tool batch, fire a directive followUp with
-         *  multi-shot retry. Replaces the legacy SEP one-shot completeness nudge
-         *  (whose enforcement role was superseded; SEP plan extraction + step
-         *  counting remain intact for observability). */
         postBatchContinuation: z.ZodDefault<z.ZodObject<{
-            /** Master toggle. When false, handler returns
-             *  {recovered: false, outcome: "disabled"} without calling followUp. */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Maximum directive followUp attempts before falling through to L3
-             *  synthesis. 0 = disabled. */
             maxRetries: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
     sourceGate: z.ZodOptional<z.ZodObject<{
-        /** Default byte cap for HTTP responses (matches DEFAULT_SOURCE_PROFILES.web_fetch.maxResponseBytes) */
         maxResponseBytes: z.ZodDefault<z.ZodNumber>;
-        /** Whether to strip hidden HTML before extraction */
         stripHiddenHtml: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
     toolLifecycle: z.ZodDefault<z.ZodObject<{
-        /** Whether tool lifecycle management is enabled. When false, no usage tracking or demotion occurs. */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Number of turns of non-use before a tool is demoted (schema-stripped). */
         demotionThreshold: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     sep: z.ZodOptional<z.ZodObject<{
-        /** Enable/disable SEP. Default: true. */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Minimum estimated steps to activate planning (below this threshold, overhead isn't worth it). */
         minSteps: z.ZodDefault<z.ZodNumber>;
-        /** Whether to inject a verification nudge when all steps complete. Default: true. */
         verificationNudge: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum plan steps to track (prevents runaway extraction on vague requests). */
         maxSteps: z.ZodDefault<z.ZodNumber>;
-        /** Whether to include progress in user-visible response. Default: false. */
         userVisibleProgress: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
     notification: z.ZodOptional<z.ZodObject<{
@@ -1765,15 +1187,12 @@ export declare const PerAgentConfigSchema: z.ZodObject<{
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
     deferredTools: z.ZodOptional<z.ZodObject<{
-        /** Deferral mode: "always" defers all non-core tools, "auto" uses rule+budget heuristics, "never" disables deferral. */
         mode: z.ZodDefault<z.ZodEnum<{
             never: "never";
             always: "always";
             auto: "auto";
         }>>;
-        /** Tool names that must never be deferred (force-loaded into active context). Glob patterns NOT supported -- exact names only. */
         neverDefer: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Tool names that must always be deferred (force-deferred regardless of rules). Glob patterns NOT supported -- exact names only. */
         alwaysDefer: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
     backgroundTasks: z.ZodOptional<z.ZodObject<{
@@ -1842,32 +1261,20 @@ export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
     maxToolResultChars: z.ZodDefault<z.ZodNumber>;
     preserveRecent: z.ZodDefault<z.ZodNumber>;
     budgets: z.ZodDefault<z.ZodObject<{
-        /** Max tokens per single execution */
         perExecution: z.ZodDefault<z.ZodNumber>;
-        /** Max tokens per hour (rolling window) */
         perHour: z.ZodDefault<z.ZodNumber>;
-        /** Max tokens per day (rolling window) */
         perDay: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     circuitBreaker: z.ZodDefault<z.ZodObject<{
-        /** Number of consecutive failures before opening circuit */
         failureThreshold: z.ZodDefault<z.ZodNumber>;
-        /** Milliseconds to wait before attempting recovery */
         resetTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Milliseconds for half-open probe timeout */
         halfOpenTimeoutMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     toolRetryBreaker: z.ZodDefault<z.ZodObject<{
-        /** Enable tool retry circuit breaker. Default: true. */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Max consecutive failures for same tool+args before blocking. Default: 3. */
         maxConsecutiveFailures: z.ZodDefault<z.ZodNumber>;
-        /** Max total failures for a tool name (any args) before blocking all calls. Default: 5. */
         maxToolFailures: z.ZodDefault<z.ZodNumber>;
-        /** Suggest alternative tools in block reason. Default: true. */
         suggestAlternatives: z.ZodDefault<z.ZodBoolean>;
-        /** Max consecutive same-error-class failures (any args) before blocking. Default: 2.
-         *  Stricter than args-based because same error + different args = stronger stuck signal. */
         maxConsecutiveErrorPatterns: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     workspace: z.ZodDefault<z.ZodObject<{
@@ -1881,15 +1288,10 @@ export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         default: z.ZodOptional<z.ZodString>;
     }, z.core.$catchall<z.ZodString>>>;
     rag: z.ZodDefault<z.ZodObject<{
-        /** Enable automatic memory retrieval before LLM calls */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum number of memory results to retrieve */
         maxResults: z.ZodDefault<z.ZodNumber>;
-        /** Maximum characters of memory context to inject into system prompt */
         maxContextChars: z.ZodDefault<z.ZodNumber>;
-        /** Minimum RRF score threshold (0-1) to include a memory result */
         minScore: z.ZodDefault<z.ZodNumber>;
-        /** Trust levels to include in retrieval (external excluded by default for security) */
         includeTrustLevels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
             system: "system";
             learned: "learned";
@@ -1897,15 +1299,12 @@ export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         }>>>;
     }, z.core.$strict>>;
     bootstrap: z.ZodDefault<z.ZodObject<{
-        /** Per-file character limit for workspace files injected into system prompt */
         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";
         }>>;
-        /** When true, USER.md is excluded from bootstrap context in group chat sessions (privacy). Default: true. */
         groupChatFiltering: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
     reactionLevel: z.ZodOptional<z.ZodEnum<{
@@ -1913,82 +1312,53 @@ export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         extensive: "extensive";
     }>>;
     modelFailover: z.ZodDefault<z.ZodObject<{
-        /** Ordered list of fallback models to try when primary fails */
         fallbackModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** LLM provider (e.g. "anthropic", "openai") */
             provider: z.ZodString;
-            /** Model identifier at the provider */
             modelId: z.ZodString;
         }, z.core.$strict>>>;
-        /** Per-provider API key profiles for auth rotation */
         authProfiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Key name in SecretManager (e.g. "ANTHROPIC_API_KEY_2") */
             keyName: z.ZodString;
-            /** Provider this key belongs to (e.g. "anthropic") */
             provider: z.ZodString;
         }, z.core.$strict>>>;
-        /** Model allowlist (empty = allow all models) */
         allowedModels: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Maximum total attempts across all models/keys */
         maxAttempts: z.ZodDefault<z.ZodNumber>;
-        /** Initial cooldown duration in milliseconds (1 min) */
         cooldownInitialMs: z.ZodDefault<z.ZodNumber>;
-        /** Exponential cooldown multiplier */
         cooldownMultiplier: z.ZodDefault<z.ZodNumber>;
-        /** Maximum cooldown duration in milliseconds (1 hr) */
         cooldownCapMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     sdkRetry: z.ZodDefault<z.ZodObject<{
-        /** Enable SDK-native retry with exponential backoff */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum number of retry attempts for transient errors (5 retries = 6 total attempts) */
         maxRetries: z.ZodDefault<z.ZodNumber>;
-        /** Base delay in milliseconds before first retry (4s base with exponential backoff: 4s, 8s, 16s, 32s, 60s capped) */
         baseDelayMs: z.ZodDefault<z.ZodNumber>;
-        /** Maximum delay cap in milliseconds between retries */
         maxDelayMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     promptTimeout: z.ZodDefault<z.ZodObject<{
-        /** Wall-clock timeout for primary prompt calls in milliseconds. Default: 180s. */
         promptTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Wall-clock timeout for retry prompt calls in milliseconds. Default: 60s. */
         retryPromptTimeoutMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     operationModels: z.ZodDefault<z.ZodObject<{
         cron: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         heartbeat: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         subagent: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         compaction: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         taskExtraction: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
         condensation: z.ZodOptional<z.ZodObject<{
-            /** Model override in "provider:modelId" format, or "primary" to use agent's primary model. */
             model: z.ZodOptional<z.ZodString>;
-            /** Timeout override in milliseconds for this operation type. */
             timeout: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
@@ -2048,66 +1418,34 @@ export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         watchDebounceMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     scheduler: z.ZodOptional<z.ZodObject<{
-        /** Per-agent cron configuration */
         cron: z.ZodDefault<z.ZodObject<{
-            /** Enable cron job scheduling for this agent */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Maximum concurrent cron job runs for this agent */
             maxConcurrentRuns: z.ZodDefault<z.ZodNumber>;
-            /** Default timezone for cron expressions (empty = UTC) */
             defaultTimezone: z.ZodDefault<z.ZodString>;
-            /** Maximum number of cron jobs allowed for this agent (0 = unlimited) */
             maxJobs: z.ZodDefault<z.ZodNumber>;
-            /** Maximum consecutive errors before auto-suspending a cron job (0 = never suspend). Per-agent override. */
             maxConsecutiveErrors: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
-        /** Per-agent heartbeat configuration (optional -- inherits from global scheduler.heartbeat) */
         heartbeat: z.ZodOptional<z.ZodObject<{
-            /** Override heartbeat enabled state for this agent */
             enabled: z.ZodOptional<z.ZodBoolean>;
-            /** Override heartbeat interval in milliseconds */
             intervalMs: z.ZodOptional<z.ZodNumber>;
-            /** Override show OK status */
             showOk: z.ZodOptional<z.ZodBoolean>;
-            /** Override show alerts */
             showAlerts: z.ZodOptional<z.ZodBoolean>;
-            /** Delivery target channel for this agent's heartbeat notifications */
             target: z.ZodOptional<z.ZodObject<{
-                /** Channel type (e.g., "telegram", "discord") */
                 channelType: z.ZodString;
-                /** Channel identifier within the platform */
                 channelId: z.ZodString;
-                /** Chat/conversation identifier */
                 chatId: z.ZodString;
-                /** Whether this target is a DM conversation (for DM delivery policy) */
                 isDm: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strict>>;
-            /** Custom heartbeat prompt for this agent */
             prompt: z.ZodOptional<z.ZodString>;
-            /** Session key for heartbeat conversation isolation */
             session: z.ZodOptional<z.ZodString>;
-            /** Whether heartbeat alerts can be delivered to DM conversations (default: true) */
             allowDm: z.ZodOptional<z.ZodBoolean>;
-            /** When true, heartbeat bootstrap context includes ONLY HEARTBEAT.md (cost optimization) */
             lightContext: z.ZodOptional<z.ZodBoolean>;
-            /** Maximum characters for soft acknowledgment threshold (default applied in scheduler, not schema) */
             ackMaxChars: z.ZodOptional<z.ZodNumber>;
-            /** Prefix to strip from LLM responses before delivery */
             responsePrefix: z.ZodOptional<z.ZodString>;
-            /** Whether to suppress delivery of HEARTBEAT_OK-only responses from cron triggers (default applied in scheduler) */
             skipHeartbeatOnlyDelivery: z.ZodOptional<z.ZodBoolean>;
-            /** Override consecutive failure threshold for alerting (per-agent) */
             alertThreshold: z.ZodOptional<z.ZodNumber>;
-            /** Override alert cooldown period in ms (per-agent) */
             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>>;
@@ -2117,311 +1455,184 @@ export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
     }, z.core.$strict>>;
     session: z.ZodOptional<z.ZodObject<{
         resetPolicy: z.ZodOptional<z.ZodObject<{
-            /** Reset mode: daily, idle, hybrid (first-to-expire), or none (disabled) */
             mode: z.ZodDefault<z.ZodEnum<{
                 daily: "daily";
                 idle: "idle";
                 hybrid: "hybrid";
                 none: "none";
             }>>;
-            /** Hour of day for daily reset (0-23, default 4 = 4 AM) */
             dailyResetHour: z.ZodDefault<z.ZodNumber>;
-            /** IANA timezone for daily reset (empty string = system local) */
             dailyResetTimezone: z.ZodDefault<z.ZodString>;
-            /** Idle timeout in milliseconds (default 4 hours = 14_400_000) */
             idleTimeoutMs: z.ZodDefault<z.ZodNumber>;
-            /** Sweep interval in milliseconds (how often to check sessions, default 5 min) */
             sweepIntervalMs: z.ZodDefault<z.ZodNumber>;
-            /** Phrases that trigger immediate session reset when sent as a message */
             resetTriggers: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            /** Per-session-type overrides (dm, group, thread) */
             perType: z.ZodDefault<z.ZodObject<{
                 dm: z.ZodOptional<z.ZodObject<{
-                    /** Override reset mode for this session type */
                     mode: z.ZodOptional<z.ZodEnum<{
                         daily: "daily";
                         idle: "idle";
                         hybrid: "hybrid";
                         none: "none";
                     }>>;
-                    /** Override daily reset hour (0-23) */
                     dailyResetHour: z.ZodOptional<z.ZodNumber>;
-                    /** Override IANA timezone for daily reset */
                     dailyResetTimezone: z.ZodOptional<z.ZodString>;
-                    /** Override idle timeout in milliseconds */
                     idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strict>>;
                 group: z.ZodOptional<z.ZodObject<{
-                    /** Override reset mode for this session type */
                     mode: z.ZodOptional<z.ZodEnum<{
                         daily: "daily";
                         idle: "idle";
                         hybrid: "hybrid";
                         none: "none";
                     }>>;
-                    /** Override daily reset hour (0-23) */
                     dailyResetHour: z.ZodOptional<z.ZodNumber>;
-                    /** Override IANA timezone for daily reset */
                     dailyResetTimezone: z.ZodOptional<z.ZodString>;
-                    /** Override idle timeout in milliseconds */
                     idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strict>>;
                 thread: z.ZodOptional<z.ZodObject<{
-                    /** Override reset mode for this session type */
                     mode: z.ZodOptional<z.ZodEnum<{
                         daily: "daily";
                         idle: "idle";
                         hybrid: "hybrid";
                         none: "none";
                     }>>;
-                    /** Override daily reset hour (0-23) */
                     dailyResetHour: z.ZodOptional<z.ZodNumber>;
-                    /** Override IANA timezone for daily reset */
                     dailyResetTimezone: z.ZodOptional<z.ZodString>;
-                    /** Override idle timeout in milliseconds */
                     idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strict>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
         dmScope: z.ZodOptional<z.ZodObject<{
-            /** DM scope mode controlling session isolation granularity */
             mode: z.ZodDefault<z.ZodEnum<{
                 main: "main";
                 "per-peer": "per-peer";
                 "per-channel-peer": "per-channel-peer";
                 "per-account-channel-peer": "per-account-channel-peer";
             }>>;
-            /** Prepend agent:<agentId>: to session keys for multi-agent isolation */
             agentPrefix: z.ZodDefault<z.ZodBoolean>;
-            /** Append :thread:<threadId> to session keys for forum/thread isolation */
             threadIsolation: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strict>>;
         pruning: z.ZodOptional<z.ZodObject<{
-            /** Enable session pruning of oversized tool results */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Character threshold above which tool results are soft-trimmed (head + tail with marker) */
             softTrimThresholdChars: z.ZodDefault<z.ZodNumber>;
-            /** Character threshold above which tool results are hard-cleared (entire content replaced) */
             hardClearThresholdChars: z.ZodDefault<z.ZodNumber>;
-            /** Number of characters to preserve at the start of a soft-trimmed result */
             preserveHeadChars: z.ZodDefault<z.ZodNumber>;
-            /** Number of characters to preserve at the end of a soft-trimmed result */
             preserveTailChars: z.ZodDefault<z.ZodNumber>;
-            /** Tools whose results are eligible for pruning (empty = all tools eligible) */
             pruneableTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            /** Tools whose results are never pruned (takes precedence over pruneableTools) */
             protectedTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            /** Protect tool results containing image content blocks from pruning */
             protectImageBlocks: z.ZodDefault<z.ZodBoolean>;
-            /** Number of recent messages (from end of array) exempt from pruning */
             preserveRecentCount: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
         compaction: z.ZodOptional<z.ZodObject<{
-            /** Fraction of maxContextChars at which soft flush triggers (memory extraction only) */
             softThresholdRatio: z.ZodDefault<z.ZodNumber>;
-            /** Fraction of maxContextChars at which hard compaction triggers (flush + trim) */
             hardThresholdRatio: z.ZodDefault<z.ZodNumber>;
-            /** Model to use for memory extraction during flush (defaults to cheap model) */
             flushModel: z.ZodOptional<z.ZodString>;
-            /** Max characters per summarization chunk. Default: 50_000. */
             chunkMaxChars: z.ZodDefault<z.ZodNumber>;
-            /** Number of overlap messages between chunks. Default: 2. */
             chunkOverlapMessages: z.ZodDefault<z.ZodNumber>;
-            /** Whether to merge chunk summaries via LLM. Default: true. */
             chunkMergeSummaries: z.ZodDefault<z.ZodBoolean>;
-            /** Tokens reserved for summary during SDK auto-compaction. Default: 16384. */
             reserveTokens: z.ZodDefault<z.ZodNumber>;
-            /** Tokens worth of recent messages to keep after SDK auto-compaction. Default: 32768. */
             keepRecentTokens: z.ZodDefault<z.ZodNumber>;
-            /** AGENTS.md section names to re-inject after compaction. */
             postCompactionSections: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
     concurrency: z.ZodDefault<z.ZodObject<{
-        /** Maximum concurrent agent runs for this agent (default: 4) */
         maxConcurrentRuns: z.ZodDefault<z.ZodNumber>;
-        /** Maximum queued messages per session before overflow (default: 50) */
         maxQueuedPerSession: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     broadcastGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Unique group identifier (referenced in broadcast tool calls) */
         id: z.ZodString;
-        /** Human-readable group name */
         name: z.ZodDefault<z.ZodString>;
-        /** Channel targets for simultaneous delivery */
         targets: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Channel type (e.g., "telegram", "discord", "slack") */
             channelType: z.ZodString;
-            /** Channel identifier within the platform */
             channelId: z.ZodString;
-            /** Chat/conversation identifier within the channel */
             chatId: z.ZodString;
         }, z.core.$strict>>>;
-        /** Whether this broadcast group is active */
         enabled: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>>;
     elevatedReply: z.ZodDefault<z.ZodObject<{
-        /** Enable trust-based model/prompt routing */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Map of trust level name to model route name (from modelRoutes) */
         trustModelRoutes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-        /** Map of trust level name to system prompt section override text */
         trustPromptOverrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-        /** Default trust level for unknown senders */
         defaultTrustLevel: z.ZodDefault<z.ZodString>;
-        /** Per-sender trust level overrides (senderId -> trust level name) */
         senderTrustMap: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strict>>;
     tracing: z.ZodDefault<z.ZodObject<{
-        /** Enable per-LLM-call JSONL trace files */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Output directory for JSONL trace files. Supports ~ expansion. Default: ~/.comis/traces */
         outputDir: z.ZodDefault<z.ZodString>;
     }, z.core.$strict>>;
     secrets: z.ZodOptional<z.ZodObject<{
         allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
     contextGuard: z.ZodDefault<z.ZodObject<{
-        /** Enable context window guard checks during execution */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Warn when context usage reaches this percent (0-100). Default: 80. */
         warnPercent: z.ZodDefault<z.ZodNumber>;
-        /** Block (abort) execution when context usage reaches this percent (0-100). Default: 95. */
         blockPercent: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     contextPruning: z.ZodOptional<z.ZodObject<{
-        /** Master toggle for progressive context pruning */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Context ratio at which soft-trim begins (head+tail preservation) */
         softTrimRatio: z.ZodDefault<z.ZodNumber>;
-        /** Context ratio at which hard-clear begins (full placeholder replacement) */
         hardClearRatio: z.ZodDefault<z.ZodNumber>;
-        /** Number of recent assistant messages to protect from pruning */
         keepLastAssistants: z.ZodDefault<z.ZodNumber>;
-        /** Minimum tool result size in characters eligible for soft-trim */
         minPrunableToolChars: z.ZodDefault<z.ZodNumber>;
-        /** Tool names never pruned (strings in config, converted to RegExp patterns at runtime by consumer) */
         protectedTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
     contextEngine: z.ZodOptional<z.ZodObject<{
-        /** Master toggle for the context engine pipeline (enabled by default). */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Operating mode: "pipeline" for sequential layer composition, "dag" for graph-based context management. */
         version: z.ZodDefault<z.ZodEnum<{
             pipeline: "pipeline";
             dag: "dag";
         }>>;
-        /** Number of recent assistant turns that retain thinking blocks (older turns get stripped). */
         thinkingKeepTurns: z.ZodDefault<z.ZodNumber>;
-        /** Idle gap (ms) above which signed thinking state is treated as drifted and
-         *  scrubbed pre-send to avoid provider replay-rejection. Default 30 min —
-         *  below long-TTL caches and below the 74-min production incident gap. Also
-         *  triggers on model id / provider / api change (those checks are
-         *  unconditional regardless of this idle threshold). Range: 1 min .. 24 h. */
         replayDriftIdleMs: z.ZodDefault<z.ZodNumber>;
-        /** Model for LLM compaction in "provider:modelId" format. Empty string
-         *  (the default) triggers runtime resolution against the agent's primary
-         *  provider via pi-ai catalog (fast-tier cost model). Avoids pinning a
-         *  hardcoded Anthropic literal that goes stale on pi-ai upgrades and
-         *  cross-routes background ops to Claude when primary is OpenRouter/Google/etc. */
         compactionModel: z.ZodDefault<z.ZodString>;
-        /** Minimum age (in tool result positions) before content is eligible for dead content eviction. */
         evictionMinAge: z.ZodDefault<z.ZodNumber>;
-        /** Number of recent user turns to keep in context (default 15). */
         historyTurns: z.ZodDefault<z.ZodNumber>;
-        /** Per-agent or per-channel-type turn count overrides (e.g., { dm: 10, "trader-1": 30 }). */
         historyTurnOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        /** Number of most recent tool uses that retain full content (older ones are masked). */
         observationKeepWindow: z.ZodDefault<z.ZodNumber>;
-        /** Character threshold before observation masking activates (below this, masking is skipped). */
         observationTriggerChars: z.ZodDefault<z.ZodNumber>;
-        /** Character threshold below which observation masking deactivates (hysteresis). */
         observationDeactivationChars: z.ZodDefault<z.ZodNumber>;
-        /** Keep window for ephemeral-tier tools (web_search, brave_search, web_fetch, link_reader, fetch_url). Shorter than observationKeepWindow. Default: 10. */
         ephemeralKeepWindow: z.ZodDefault<z.ZodNumber>;
-        /** Turns to wait before re-triggering LLM compaction after a successful compaction. */
         compactionCooldownTurns: z.ZodDefault<z.ZodNumber>;
-        /** Number of user-turn cycles at the head of conversation to preserve during
-         *  LLM compaction for cache prefix stability. 0 = old behavior
-         *  (summarize everything, keep tail only). */
         compactionPrefixAnchorTurns: z.ZodDefault<z.ZodNumber>;
-        /** Output escalation configuration: auto-retry with higher output budget on max_tokens truncation. */
         outputEscalation: z.ZodDefault<z.ZodObject<{
-            /** Master toggle for output escalation. When false, max_tokens truncation is not retried. */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Escalated max output tokens for the retry attempt. Must be between 4096 and 128000. */
             escalatedMaxTokens: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
-        /** Number of most recent turns always included verbatim in DAG context. */
         freshTailTurns: z.ZodDefault<z.ZodNumber>;
-        /** Context utilization fraction that triggers DAG compaction (0.1 to 0.95). */
         contextThreshold: z.ZodDefault<z.ZodNumber>;
-        /** Minimum fan-out for leaf nodes in the DAG. */
         leafMinFanout: z.ZodDefault<z.ZodNumber>;
-        /** Minimum fan-out for condensed (non-leaf) nodes in the DAG. */
         condensedMinFanout: z.ZodDefault<z.ZodNumber>;
-        /** Hard minimum fan-out for condensed nodes (lowest allowed). */
         condensedMinFanoutHard: z.ZodDefault<z.ZodNumber>;
-        /** Maximum depth for incremental DAG rebuilds (-1 = full rebuild). */
         incrementalMaxDepth: z.ZodDefault<z.ZodNumber>;
-        /** Token budget for leaf node chunks in the DAG. */
         leafChunkTokens: z.ZodDefault<z.ZodNumber>;
-        /** Target token size for leaf node summaries. */
         leafTargetTokens: z.ZodDefault<z.ZodNumber>;
-        /** Target token size for condensed node summaries. */
         condensedTargetTokens: z.ZodDefault<z.ZodNumber>;
-        /** Maximum tokens for expanded context retrieval. */
         maxExpandTokens: z.ZodDefault<z.ZodNumber>;
-        /** Maximum recall operations per day per agent. */
         maxRecallsPerDay: z.ZodDefault<z.ZodNumber>;
-        /** Timeout for recall operations in milliseconds. */
         recallTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Token threshold above which a file is considered "large" for DAG processing. */
         largeFileTokenThreshold: z.ZodDefault<z.ZodNumber>;
-        /** Number of most recent annotations retained in DAG mode (analogous to observationKeepWindow). */
         annotationKeepWindow: z.ZodDefault<z.ZodNumber>;
-        /** Character threshold before annotation eviction activates in DAG mode. */
         annotationTriggerChars: z.ZodDefault<z.ZodNumber>;
-        /** Optional model override for DAG summary generation in "provider:modelId" format. */
         summaryModel: z.ZodOptional<z.ZodString>;
-        /** Optional provider override for DAG summary generation. */
         summaryProvider: z.ZodOptional<z.ZodString>;
-        /** Post-batch continuation handler: when the LLM emits an empty final
-         *  turn after a successful tool batch, fire a directive followUp with
-         *  multi-shot retry. Replaces the legacy SEP one-shot completeness nudge
-         *  (whose enforcement role was superseded; SEP plan extraction + step
-         *  counting remain intact for observability). */
         postBatchContinuation: z.ZodDefault<z.ZodObject<{
-            /** Master toggle. When false, handler returns
-             *  {recovered: false, outcome: "disabled"} without calling followUp. */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Maximum directive followUp attempts before falling through to L3
-             *  synthesis. 0 = disabled. */
             maxRetries: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
     sourceGate: z.ZodOptional<z.ZodObject<{
-        /** Default byte cap for HTTP responses (matches DEFAULT_SOURCE_PROFILES.web_fetch.maxResponseBytes) */
         maxResponseBytes: z.ZodDefault<z.ZodNumber>;
-        /** Whether to strip hidden HTML before extraction */
         stripHiddenHtml: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
     toolLifecycle: z.ZodDefault<z.ZodObject<{
-        /** Whether tool lifecycle management is enabled. When false, no usage tracking or demotion occurs. */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Number of turns of non-use before a tool is demoted (schema-stripped). */
         demotionThreshold: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
     sep: z.ZodOptional<z.ZodObject<{
-        /** Enable/disable SEP. Default: true. */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Minimum estimated steps to activate planning (below this threshold, overhead isn't worth it). */
         minSteps: z.ZodDefault<z.ZodNumber>;
-        /** Whether to inject a verification nudge when all steps complete. Default: true. */
         verificationNudge: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum plan steps to track (prevents runaway extraction on vague requests). */
         maxSteps: z.ZodDefault<z.ZodNumber>;
-        /** Whether to include progress in user-visible response. Default: false. */
         userVisibleProgress: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
     notification: z.ZodOptional<z.ZodObject<{
@@ -2464,15 +1675,12 @@ export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
     deferredTools: z.ZodOptional<z.ZodObject<{
-        /** Deferral mode: "always" defers all non-core tools, "auto" uses rule+budget heuristics, "never" disables deferral. */
         mode: z.ZodDefault<z.ZodEnum<{
             never: "never";
             always: "always";
             auto: "auto";
         }>>;
-        /** Tool names that must never be deferred (force-loaded into active context). Glob patterns NOT supported -- exact names only. */
         neverDefer: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Tool names that must always be deferred (force-deferred regardless of rules). Glob patterns NOT supported -- exact names only. */
         alwaysDefer: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
     backgroundTasks: z.ZodOptional<z.ZodObject<{