comisai 1.0.36 → 1.0.40

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

@@ -1,2500 +0,0 @@
-import { z } from "zod";
-/**
- * Model selection configuration schemas.
- *
- * Owns budget limits, circuit breaker thresholds, model route overrides,
- * 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>;
-/**
- * Per-agent model route overrides.
- *
- * Maps task types to specific model identifiers. The `default` key
- * falls back to the agent's top-level `model` field when not set.
- * Additional named routes (e.g. "summarization", "classification")
- * allow task-specific model selection.
- *
- * Uses .catchall(z.string()) for extensibility -- any string key maps
- * to a model identifier string.
- */
-export declare const ModelRoutesSchema: z.ZodDefault<z.ZodObject<{
-    default: z.ZodOptional<z.ZodString>;
-}, z.core.$catchall<z.ZodString>>>;
-/**
- * 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>;
-/**
- * Schema for an auth profile entry (key name + provider association).
- *
- * Each profile maps a SecretManager key name to a provider, enabling
- * 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>;
-/**
- * Model failover configuration schema.
- *
- * Controls automatic model failover behavior, auth profile rotation
- * 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>;
-/**
- * Valid operation type keys for model resolution.
- *
- * Named ModelOperationType (not OperationType) to avoid collision with
- * the existing OperationType in packages/daemon/src/observability/latency-recorder.ts.
- */
-export type ModelOperationType = "interactive" | "cron" | "heartbeat" | "subagent" | "compaction" | "taskExtraction" | "condensation";
-/**
- * Per-operation model entry: groups model override and timeout for a single
- * operation type.
- *
- * Both fields are optional. When model is unset, the resolver uses provider-family
- * 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>;
-/**
- * Per-operation model override configuration.
- *
- * Each operation type has an optional entry with model and timeout fields.
- * "interactive" is intentionally excluded -- it always uses the agent's
- * primary model.
- *
- * When no entries are set (default: {}), the resolver uses provider-family
- * smart defaults for automatic model tiering.
- */
-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>>;
-export type BudgetConfig = z.infer<typeof BudgetConfigSchema>;
-export type CircuitBreakerConfig = z.infer<typeof CircuitBreakerConfigSchema>;
-export type ToolRetryBreakerConfig = z.infer<typeof ToolRetryBreakerConfigSchema>;
-export type ModelRoutes = z.infer<typeof ModelRoutesSchema>;
-export type FallbackModel = z.infer<typeof FallbackModelSchema>;
-export type AuthProfileEntry = z.infer<typeof AuthProfileSchema>;
-export type ModelFailoverConfig = z.infer<typeof ModelFailoverConfigSchema>;
-export type PromptTimeoutConfig = z.infer<typeof PromptTimeoutConfigSchema>;
-export type OperationModels = z.infer<typeof OperationModelsSchema>;
-/**
- * Session lifecycle configuration schemas.
- *
- * Owns session reset policy, DM scope isolation, pruning of oversized
- * tool results, and per-agent compaction thresholds.
- */
-/**
- * Per-session-type reset policy override.
- * 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>;
-/**
- * Session reset policy configuration.
- * 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>>;
-}, z.core.$strict>;
-/**
- * DM scope configuration for session key isolation granularity.
- *
- * Controls how DM (direct message) conversations are scoped:
- * - "main": all DMs share a single session (userId="main", channelId="dm")
- * - "per-peer": one session per peer across all channels
- * - "per-channel-peer": one session per channel+peer (default)
- * - "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>;
-/**
- * Session pruning configuration for in-memory tool result trimming.
- *
- * Controls how oversized tool results are trimmed before each LLM call.
- * 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>;
-/**
- * Session compaction configuration.
- *
- * Controls when pre-compaction memory flushes and hard compaction triggers
- * fire, based on context window usage ratios. The flushModel option allows
- * 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>;
-export type ResetPolicyOverride = z.infer<typeof ResetPolicyOverrideSchema>;
-export type DmScopeConfig = z.infer<typeof DmScopeConfigSchema>;
-export type PruningConfig = z.infer<typeof PruningConfigSchema>;
-export type SessionCompactionConfig = z.infer<typeof SessionCompactionConfigSchema>;
-/**
- * Context engine configuration schema.
- *
- * Controls the context engine operating in either **pipeline** mode
- * (sequential layer composition: thinking cleaner, history window,
- * dead content evictor, observation masker, LLM compaction, rehydration)
- * or **DAG** mode (graph-based context management with leaf/condensed
- * nodes, incremental recall, and annotation-driven eviction).
- *
- * All fields have sensible defaults so an empty `{}` is always valid.
- * The flat schema validates all fields regardless of the active `version`
- * to prevent invalid saved configurations.
- *
- * Only top-level settings are exposed to users; internal budget
- * components (safety margin, output reserve, rot buffer) are
- * controlled by constants in @comis/agent.
- *
- * @module
- */
-/** 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>;
-export type ContextEngineConfig = z.infer<typeof ContextEngineConfigSchema>;
-/**
- * Context guard configuration schemas.
- *
- * ContextPruningConfigSchema -- progressive context pruning layer settings
- * (soft-trim at ratio threshold, hard-clear at higher ratio).
- *
- * SourceGateConfigSchema -- HTTP source gate layer settings
- * (byte cap and hidden HTML stripping).
- */
-/** 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>;
-export type SourceGateConfig = z.infer<typeof SourceGateConfigSchema>;
-/**
- * Agent configuration schema.
- *
- * Defines agent identity, model selection, execution limits,
- * workspace paths, and per-agent feature configuration.
- */
-/** 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";
-        external: "external";
-    }>>>;
-}, z.core.$strict>;
-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";
-        low: "low";
-        medium: "medium";
-        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>>;
-}, z.core.$strict>;
-export type AgentConfig = z.infer<typeof AgentConfigSchema>;
-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>>;
-        deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$strict>;
-export type HeartbeatTarget = z.infer<typeof HeartbeatTargetSchema>;
-export type PerAgentHeartbeatConfig = z.infer<typeof PerAgentHeartbeatConfigSchema>;
-/** 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>>;
-            deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-/** Per-agent configuration: extends AgentConfigSchema with skills, scheduler, session, concurrency. */
-export declare const PerAgentConfigSchema: z.ZodObject<{
-    name: z.ZodDefault<z.ZodString>;
-    model: z.ZodDefault<z.ZodString>;
-    provider: z.ZodDefault<z.ZodString>;
-    maxSteps: z.ZodDefault<z.ZodNumber>;
-    thinkingLevel: z.ZodOptional<z.ZodEnum<{
-        minimal: "minimal";
-        off: "off";
-        low: "low";
-        medium: "medium";
-        high: "high";
-        xhigh: "xhigh";
-    }>>;
-    maxTokens: z.ZodOptional<z.ZodNumber>;
-    temperature: z.ZodOptional<z.ZodNumber>;
-    cacheRetention: z.ZodDefault<z.ZodEnum<{
-        none: "none";
-        short: "short";
-        long: "long";
-    }>>;
-    cacheRetentionOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
-        none: "none";
-        short: "short";
-        long: "long";
-    }>>>;
-    adaptiveCacheRetention: z.ZodDefault<z.ZodBoolean>;
-    cacheBreakpointStrategy: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        "multi-zone": "multi-zone";
-        single: "single";
-    }>>;
-    advancedCacheOptimization: z.ZodDefault<z.ZodObject<{
-        enableRecentZonePromotion: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    geminiCache: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        maxActiveCaches: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strict>>;
-    enforceFinalTag: z.ZodDefault<z.ZodBoolean>;
-    fastMode: z.ZodDefault<z.ZodBoolean>;
-    storeCompletions: z.ZodDefault<z.ZodBoolean>;
-    maxContextChars: z.ZodDefault<z.ZodNumber>;
-    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<{
-        profile: z.ZodDefault<z.ZodEnum<{
-            full: "full";
-            specialist: "specialist";
-        }>>;
-    }, z.core.$strict>>;
-    workspacePath: z.ZodOptional<z.ZodString>;
-    modelRoutes: z.ZodDefault<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";
-            external: "external";
-        }>>>;
-    }, 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<{
-        minimal: "minimal";
-        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>>;
-    skills: z.ZodOptional<z.ZodObject<{
-        discoveryPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        builtinTools: z.ZodDefault<z.ZodObject<{
-            read: z.ZodDefault<z.ZodBoolean>;
-            write: z.ZodDefault<z.ZodBoolean>;
-            edit: z.ZodDefault<z.ZodBoolean>;
-            notebookEdit: z.ZodDefault<z.ZodBoolean>;
-            grep: z.ZodDefault<z.ZodBoolean>;
-            find: z.ZodDefault<z.ZodBoolean>;
-            ls: z.ZodDefault<z.ZodBoolean>;
-            exec: z.ZodDefault<z.ZodBoolean>;
-            process: z.ZodDefault<z.ZodBoolean>;
-            webSearch: z.ZodDefault<z.ZodBoolean>;
-            webFetch: z.ZodDefault<z.ZodBoolean>;
-            browser: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strict>>;
-        toolPolicy: z.ZodDefault<z.ZodObject<{
-            profile: z.ZodDefault<z.ZodEnum<{
-                minimal: "minimal";
-                coding: "coding";
-                messaging: "messaging";
-                supervisor: "supervisor";
-                full: "full";
-            }>>;
-            allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strict>>;
-        promptSkills: z.ZodDefault<z.ZodObject<{
-            maxBodyLength: z.ZodDefault<z.ZodNumber>;
-            enableDynamicContext: z.ZodDefault<z.ZodBoolean>;
-            maxAutoInject: z.ZodDefault<z.ZodNumber>;
-            allowedSkills: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            deniedSkills: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strict>>;
-        runtimeEligibility: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strict>>;
-        contentScanning: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-            blockOnCritical: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strict>>;
-        execSandbox: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodEnum<{
-                never: "never";
-                always: "always";
-            }>>;
-            readOnlyAllowPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strict>>;
-        toolDiscovery: z.ZodDefault<z.ZodObject<{
-            minBm25Score: z.ZodDefault<z.ZodNumber>;
-            minHybridScore: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strict>>;
-        watchEnabled: z.ZodDefault<z.ZodBoolean>;
-        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>>;
-                deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            }, z.core.$strip>>;
-        }, z.core.$strict>>;
-    }, 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<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        maxPerHour: z.ZodDefault<z.ZodNumber>;
-        dedupeWindowMs: z.ZodDefault<z.ZodNumber>;
-        primaryChannel: z.ZodOptional<z.ZodObject<{
-            channelType: z.ZodString;
-            channelId: z.ZodString;
-        }, z.core.$strict>>;
-        maxChainDepth: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strict>>;
-    verbosity: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        defaultLevel: z.ZodDefault<z.ZodEnum<{
-            auto: "auto";
-            terse: "terse";
-            concise: "concise";
-            standard: "standard";
-            detailed: "detailed";
-        }>>;
-        threadLevel: z.ZodOptional<z.ZodEnum<{
-            auto: "auto";
-            terse: "terse";
-            concise: "concise";
-            standard: "standard";
-            detailed: "detailed";
-        }>>;
-        overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-            level: z.ZodOptional<z.ZodEnum<{
-                auto: "auto";
-                terse: "terse";
-                concise: "concise";
-                standard: "standard";
-                detailed: "detailed";
-            }>>;
-            maxResponseChars: z.ZodOptional<z.ZodNumber>;
-            useMarkdown: z.ZodOptional<z.ZodBoolean>;
-            allowCodeBlocks: z.ZodOptional<z.ZodBoolean>;
-        }, 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<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        autoBackgroundMs: z.ZodDefault<z.ZodNumber>;
-        maxPerAgent: z.ZodDefault<z.ZodNumber>;
-        maxTotal: z.ZodDefault<z.ZodNumber>;
-        maxBackgroundDurationMs: z.ZodDefault<z.ZodNumber>;
-        excludeTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        maxBackgroundHops: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strict>>;
-    memoryReview: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        schedule: z.ZodDefault<z.ZodString>;
-        minMessages: z.ZodDefault<z.ZodNumber>;
-        maxSessionsPerRun: z.ZodDefault<z.ZodNumber>;
-        maxReviewTokens: z.ZodDefault<z.ZodNumber>;
-        dedupThreshold: z.ZodDefault<z.ZodNumber>;
-        autoTags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strict>>;
-    oauthProfiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-}, z.core.$strict>;
-/** Agents map: keyed by agent ID string to per-agent configuration. */
-export declare const AgentsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
-    name: z.ZodDefault<z.ZodString>;
-    model: z.ZodDefault<z.ZodString>;
-    provider: z.ZodDefault<z.ZodString>;
-    maxSteps: z.ZodDefault<z.ZodNumber>;
-    thinkingLevel: z.ZodOptional<z.ZodEnum<{
-        minimal: "minimal";
-        off: "off";
-        low: "low";
-        medium: "medium";
-        high: "high";
-        xhigh: "xhigh";
-    }>>;
-    maxTokens: z.ZodOptional<z.ZodNumber>;
-    temperature: z.ZodOptional<z.ZodNumber>;
-    cacheRetention: z.ZodDefault<z.ZodEnum<{
-        none: "none";
-        short: "short";
-        long: "long";
-    }>>;
-    cacheRetentionOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
-        none: "none";
-        short: "short";
-        long: "long";
-    }>>>;
-    adaptiveCacheRetention: z.ZodDefault<z.ZodBoolean>;
-    cacheBreakpointStrategy: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        "multi-zone": "multi-zone";
-        single: "single";
-    }>>;
-    advancedCacheOptimization: z.ZodDefault<z.ZodObject<{
-        enableRecentZonePromotion: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    geminiCache: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        maxActiveCaches: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strict>>;
-    enforceFinalTag: z.ZodDefault<z.ZodBoolean>;
-    fastMode: z.ZodDefault<z.ZodBoolean>;
-    storeCompletions: z.ZodDefault<z.ZodBoolean>;
-    maxContextChars: z.ZodDefault<z.ZodNumber>;
-    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<{
-        profile: z.ZodDefault<z.ZodEnum<{
-            full: "full";
-            specialist: "specialist";
-        }>>;
-    }, z.core.$strict>>;
-    workspacePath: z.ZodOptional<z.ZodString>;
-    modelRoutes: z.ZodDefault<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";
-            external: "external";
-        }>>>;
-    }, 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<{
-        minimal: "minimal";
-        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>>;
-    skills: z.ZodOptional<z.ZodObject<{
-        discoveryPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        builtinTools: z.ZodDefault<z.ZodObject<{
-            read: z.ZodDefault<z.ZodBoolean>;
-            write: z.ZodDefault<z.ZodBoolean>;
-            edit: z.ZodDefault<z.ZodBoolean>;
-            notebookEdit: z.ZodDefault<z.ZodBoolean>;
-            grep: z.ZodDefault<z.ZodBoolean>;
-            find: z.ZodDefault<z.ZodBoolean>;
-            ls: z.ZodDefault<z.ZodBoolean>;
-            exec: z.ZodDefault<z.ZodBoolean>;
-            process: z.ZodDefault<z.ZodBoolean>;
-            webSearch: z.ZodDefault<z.ZodBoolean>;
-            webFetch: z.ZodDefault<z.ZodBoolean>;
-            browser: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strict>>;
-        toolPolicy: z.ZodDefault<z.ZodObject<{
-            profile: z.ZodDefault<z.ZodEnum<{
-                minimal: "minimal";
-                coding: "coding";
-                messaging: "messaging";
-                supervisor: "supervisor";
-                full: "full";
-            }>>;
-            allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strict>>;
-        promptSkills: z.ZodDefault<z.ZodObject<{
-            maxBodyLength: z.ZodDefault<z.ZodNumber>;
-            enableDynamicContext: z.ZodDefault<z.ZodBoolean>;
-            maxAutoInject: z.ZodDefault<z.ZodNumber>;
-            allowedSkills: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            deniedSkills: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strict>>;
-        runtimeEligibility: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strict>>;
-        contentScanning: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-            blockOnCritical: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strict>>;
-        execSandbox: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodEnum<{
-                never: "never";
-                always: "always";
-            }>>;
-            readOnlyAllowPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strict>>;
-        toolDiscovery: z.ZodDefault<z.ZodObject<{
-            minBm25Score: z.ZodDefault<z.ZodNumber>;
-            minHybridScore: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strict>>;
-        watchEnabled: z.ZodDefault<z.ZodBoolean>;
-        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>>;
-                deny: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            }, z.core.$strip>>;
-        }, z.core.$strict>>;
-    }, 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<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        maxPerHour: z.ZodDefault<z.ZodNumber>;
-        dedupeWindowMs: z.ZodDefault<z.ZodNumber>;
-        primaryChannel: z.ZodOptional<z.ZodObject<{
-            channelType: z.ZodString;
-            channelId: z.ZodString;
-        }, z.core.$strict>>;
-        maxChainDepth: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strict>>;
-    verbosity: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        defaultLevel: z.ZodDefault<z.ZodEnum<{
-            auto: "auto";
-            terse: "terse";
-            concise: "concise";
-            standard: "standard";
-            detailed: "detailed";
-        }>>;
-        threadLevel: z.ZodOptional<z.ZodEnum<{
-            auto: "auto";
-            terse: "terse";
-            concise: "concise";
-            standard: "standard";
-            detailed: "detailed";
-        }>>;
-        overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-            level: z.ZodOptional<z.ZodEnum<{
-                auto: "auto";
-                terse: "terse";
-                concise: "concise";
-                standard: "standard";
-                detailed: "detailed";
-            }>>;
-            maxResponseChars: z.ZodOptional<z.ZodNumber>;
-            useMarkdown: z.ZodOptional<z.ZodBoolean>;
-            allowCodeBlocks: z.ZodOptional<z.ZodBoolean>;
-        }, 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<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        autoBackgroundMs: z.ZodDefault<z.ZodNumber>;
-        maxPerAgent: z.ZodDefault<z.ZodNumber>;
-        maxTotal: z.ZodDefault<z.ZodNumber>;
-        maxBackgroundDurationMs: z.ZodDefault<z.ZodNumber>;
-        excludeTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        maxBackgroundHops: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strict>>;
-    memoryReview: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        schedule: z.ZodDefault<z.ZodString>;
-        minMessages: z.ZodDefault<z.ZodNumber>;
-        maxSessionsPerRun: z.ZodDefault<z.ZodNumber>;
-        maxReviewTokens: z.ZodDefault<z.ZodNumber>;
-        dedupThreshold: z.ZodDefault<z.ZodNumber>;
-        autoTags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strict>>;
-    oauthProfiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-}, z.core.$strict>>;
-export type PerAgentConfig = z.infer<typeof PerAgentConfigSchema>;
-export type PerAgentSchedulerConfig = z.infer<typeof PerAgentSchedulerConfigSchema>;
-export type PerAgentCronConfig = z.infer<typeof PerAgentCronConfigSchema>;