@leemat/atlas 2026.2.6-3

package/dist/plugin-sdk/config/types.agent-defaults.d.ts

@@ -0,0 +1,254 @@
+import type { ChannelId } from "../channels/plugins/types.js";
+import type { BlockStreamingChunkConfig, BlockStreamingCoalesceConfig, HumanDelayConfig, TypingMode } from "./types.base.js";
+import type { SandboxBrowserSettings, SandboxDockerSettings, SandboxPruneSettings } from "./types.sandbox.js";
+import type { MemorySearchConfig } from "./types.tools.js";
+export type AgentModelEntryConfig = {
+    alias?: string;
+    /** Provider-specific API parameters (e.g., GLM-4.7 thinking mode). */
+    params?: Record<string, unknown>;
+    /** Enable streaming for this model (default: true, false for Ollama to avoid SDK issue #1205). */
+    streaming?: boolean;
+};
+export type AgentModelListConfig = {
+    primary?: string;
+    fallbacks?: string[];
+};
+export type AgentContextPruningConfig = {
+    mode?: "off" | "cache-ttl";
+    /** TTL to consider cache expired (duration string, default unit: minutes). */
+    ttl?: string;
+    keepLastAssistants?: number;
+    softTrimRatio?: number;
+    hardClearRatio?: number;
+    minPrunableToolChars?: number;
+    tools?: {
+        allow?: string[];
+        deny?: string[];
+    };
+    softTrim?: {
+        maxChars?: number;
+        headChars?: number;
+        tailChars?: number;
+    };
+    hardClear?: {
+        enabled?: boolean;
+        placeholder?: string;
+    };
+};
+export type CliBackendConfig = {
+    /** CLI command to execute (absolute path or on PATH). */
+    command: string;
+    /** Base args applied to every invocation. */
+    args?: string[];
+    /** Output parsing mode (default: json). */
+    output?: "json" | "text" | "jsonl";
+    /** Output parsing mode when resuming a CLI session. */
+    resumeOutput?: "json" | "text" | "jsonl";
+    /** Prompt input mode (default: arg). */
+    input?: "arg" | "stdin";
+    /** Max prompt length for arg mode (if exceeded, stdin is used). */
+    maxPromptArgChars?: number;
+    /** Extra env vars injected for this CLI. */
+    env?: Record<string, string>;
+    /** Env vars to remove before launching this CLI. */
+    clearEnv?: string[];
+    /** Flag used to pass model id (e.g. --model). */
+    modelArg?: string;
+    /** Model aliases mapping (config model id → CLI model id). */
+    modelAliases?: Record<string, string>;
+    /** Flag used to pass session id (e.g. --session-id). */
+    sessionArg?: string;
+    /** Extra args used when resuming a session (use {sessionId} placeholder). */
+    sessionArgs?: string[];
+    /** Alternate args to use when resuming a session (use {sessionId} placeholder). */
+    resumeArgs?: string[];
+    /** When to pass session ids. */
+    sessionMode?: "always" | "existing" | "none";
+    /** JSON fields to read session id from (in order). */
+    sessionIdFields?: string[];
+    /** Flag used to pass system prompt. */
+    systemPromptArg?: string;
+    /** System prompt behavior (append vs replace). */
+    systemPromptMode?: "append" | "replace";
+    /** When to send system prompt. */
+    systemPromptWhen?: "first" | "always" | "never";
+    /** Flag used to pass image paths. */
+    imageArg?: string;
+    /** How to pass multiple images. */
+    imageMode?: "repeat" | "list";
+    /** Serialize runs for this CLI. */
+    serialize?: boolean;
+};
+export type AgentDefaultsConfig = {
+    /** Primary model and fallbacks (provider/model). */
+    model?: AgentModelListConfig;
+    /** Optional image-capable model and fallbacks (provider/model). */
+    imageModel?: AgentModelListConfig;
+    /** Model catalog with optional aliases (full provider/model keys). */
+    models?: Record<string, AgentModelEntryConfig>;
+    /** Agent working directory (preferred). Used as the default cwd for agent runs. */
+    workspace?: string;
+    /** Optional repository root for system prompt runtime line (overrides auto-detect). */
+    repoRoot?: string;
+    /** Skip bootstrap (BOOTSTRAP.md creation, etc.) for pre-configured deployments. */
+    skipBootstrap?: boolean;
+    /** Max chars for injected bootstrap files before truncation (default: 20000). */
+    bootstrapMaxChars?: number;
+    /** Optional IANA timezone for the user (used in system prompt; defaults to host timezone). */
+    userTimezone?: string;
+    /** Time format in system prompt: auto (OS preference), 12-hour, or 24-hour. */
+    timeFormat?: "auto" | "12" | "24";
+    /**
+     * Envelope timestamp timezone: "utc" (default), "local", "user", or an IANA timezone string.
+     */
+    envelopeTimezone?: string;
+    /**
+     * Include absolute timestamps in message envelopes ("on" | "off", default: "on").
+     */
+    envelopeTimestamp?: "on" | "off";
+    /**
+     * Include elapsed time in message envelopes ("on" | "off", default: "on").
+     */
+    envelopeElapsed?: "on" | "off";
+    /** Optional context window cap (used for runtime estimates + status %). */
+    contextTokens?: number;
+    /** Optional CLI backends for text-only fallback (claude-cli, etc.). */
+    cliBackends?: Record<string, CliBackendConfig>;
+    /** Opt-in: prune old tool results from the LLM context to reduce token usage. */
+    contextPruning?: AgentContextPruningConfig;
+    /** Compaction tuning and pre-compaction memory flush behavior. */
+    compaction?: AgentCompactionConfig;
+    /** Vector memory search configuration (per-agent overrides supported). */
+    memorySearch?: MemorySearchConfig;
+    /** Default thinking level when no /think directive is present. */
+    thinkingDefault?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    /** Default verbose level when no /verbose directive is present. */
+    verboseDefault?: "off" | "on" | "full";
+    /** Default elevated level when no /elevated directive is present. */
+    elevatedDefault?: "off" | "on" | "ask" | "full";
+    /** Default block streaming level when no override is present. */
+    blockStreamingDefault?: "off" | "on";
+    /**
+     * Block streaming boundary:
+     * - "text_end": end of each assistant text content block (before tool calls)
+     * - "message_end": end of the whole assistant message (may include tool blocks)
+     */
+    blockStreamingBreak?: "text_end" | "message_end";
+    /** Soft block chunking for streamed replies (min/max chars, prefer paragraph/newline). */
+    blockStreamingChunk?: BlockStreamingChunkConfig;
+    /**
+     * Block reply coalescing (merge streamed chunks before send).
+     * idleMs: wait time before flushing when idle.
+     */
+    blockStreamingCoalesce?: BlockStreamingCoalesceConfig;
+    /** Human-like delay between block replies. */
+    humanDelay?: HumanDelayConfig;
+    timeoutSeconds?: number;
+    /** Max inbound media size in MB for agent-visible attachments (text note or future image attach). */
+    mediaMaxMb?: number;
+    typingIntervalSeconds?: number;
+    /** Typing indicator start mode (never|instant|thinking|message). */
+    typingMode?: TypingMode;
+    /** Periodic background heartbeat runs. */
+    heartbeat?: {
+        /** Heartbeat interval (duration string, default unit: minutes; default: 30m). */
+        every?: string;
+        /** Optional active-hours window (local time); heartbeats run only inside this window. */
+        activeHours?: {
+            /** Start time (24h, HH:MM). Inclusive. */
+            start?: string;
+            /** End time (24h, HH:MM). Exclusive. Use "24:00" for end-of-day. */
+            end?: string;
+            /** Timezone for the window ("user", "local", or IANA TZ id). Default: "user". */
+            timezone?: string;
+        };
+        /** Heartbeat model override (provider/model). */
+        model?: string;
+        /** Session key for heartbeat runs ("main" or explicit session key). */
+        session?: string;
+        /** Delivery target ("last", "none", or a channel id). */
+        target?: "last" | "none" | ChannelId;
+        /** Optional delivery override (E.164 for WhatsApp, chat id for Telegram). */
+        to?: string;
+        /** Optional account id for multi-account channels. */
+        accountId?: string;
+        /** Override the heartbeat prompt body (default: "Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK."). */
+        prompt?: string;
+        /** Max chars allowed after HEARTBEAT_OK before delivery (default: 30). */
+        ackMaxChars?: number;
+        /**
+         * When enabled, deliver the model's reasoning payload for heartbeat runs (when available)
+         * as a separate message prefixed with `Reasoning:` (same as `/reasoning on`).
+         *
+         * Default: false (only the final heartbeat payload is delivered).
+         */
+        includeReasoning?: boolean;
+    };
+    /** Max concurrent agent runs across all conversations. Default: 1 (sequential). */
+    maxConcurrent?: number;
+    /** Sub-agent defaults (spawned via sessions_spawn). */
+    subagents?: {
+        /** Max concurrent sub-agent runs (global lane: "subagent"). Default: 1. */
+        maxConcurrent?: number;
+        /** Auto-archive sub-agent sessions after N minutes (default: 60). */
+        archiveAfterMinutes?: number;
+        /** Default model selection for spawned sub-agents (string or {primary,fallbacks}). */
+        model?: string | {
+            primary?: string;
+            fallbacks?: string[];
+        };
+        /** Default thinking level for spawned sub-agents (e.g. "off", "low", "medium", "high"). */
+        thinking?: string;
+    };
+    /** Optional sandbox settings for non-main sessions. */
+    sandbox?: {
+        /** Enable sandboxing for sessions. */
+        mode?: "off" | "non-main" | "all";
+        /**
+         * Agent workspace access inside the sandbox.
+         * - "none": do not mount the agent workspace into the container; use a sandbox workspace under workspaceRoot
+         * - "ro": mount the agent workspace read-only; disables write/edit tools
+         * - "rw": mount the agent workspace read/write; enables write/edit tools
+         */
+        workspaceAccess?: "none" | "ro" | "rw";
+        /**
+         * Session tools visibility for sandboxed sessions.
+         * - "spawned": only allow session tools to target sessions spawned from this session (default)
+         * - "all": allow session tools to target any session
+         */
+        sessionToolsVisibility?: "spawned" | "all";
+        /** Container/workspace scope for sandbox isolation. */
+        scope?: "session" | "agent" | "shared";
+        /** Legacy alias for scope ("session" when true, "shared" when false). */
+        perSession?: boolean;
+        /** Root directory for sandbox workspaces. */
+        workspaceRoot?: string;
+        /** Docker-specific sandbox settings. */
+        docker?: SandboxDockerSettings;
+        /** Optional sandboxed browser settings. */
+        browser?: SandboxBrowserSettings;
+        /** Auto-prune sandbox containers. */
+        prune?: SandboxPruneSettings;
+    };
+};
+export type AgentCompactionMode = "default" | "safeguard";
+export type AgentCompactionConfig = {
+    /** Compaction summarization mode. */
+    mode?: AgentCompactionMode;
+    /** Minimum reserve tokens enforced for Pi compaction (0 disables the floor). */
+    reserveTokensFloor?: number;
+    /** Max share of context window for history during safeguard pruning (0.1–0.9, default 0.5). */
+    maxHistoryShare?: number;
+    /** Pre-compaction memory flush (agentic turn). Default: enabled. */
+    memoryFlush?: AgentCompactionMemoryFlushConfig;
+};
+export type AgentCompactionMemoryFlushConfig = {
+    /** Enable the pre-compaction memory flush (default: true). */
+    enabled?: boolean;
+    /** Run the memory flush when context is within this many tokens of the compaction threshold. */
+    softThresholdTokens?: number;
+    /** User prompt used for the memory flush turn (NO_REPLY is enforced if missing). */
+    prompt?: string;
+    /** System prompt appended for the memory flush turn. */
+    systemPrompt?: string;
+};

package/dist/plugin-sdk/config/types.agents.d.ts

@@ -0,0 +1,77 @@
+import type { AgentDefaultsConfig } from "./types.agent-defaults.js";
+import type { HumanDelayConfig, IdentityConfig } from "./types.base.js";
+import type { GroupChatConfig } from "./types.messages.js";
+import type { SandboxBrowserSettings, SandboxDockerSettings, SandboxPruneSettings } from "./types.sandbox.js";
+import type { AgentToolsConfig, MemorySearchConfig } from "./types.tools.js";
+export type AgentModelConfig = string | {
+    /** Primary model (provider/model). */
+    primary?: string;
+    /** Per-agent model fallbacks (provider/model). */
+    fallbacks?: string[];
+};
+export type AgentConfig = {
+    id: string;
+    default?: boolean;
+    name?: string;
+    workspace?: string;
+    agentDir?: string;
+    model?: AgentModelConfig;
+    /** Optional allowlist of skills for this agent (omit = all skills; empty = none). */
+    skills?: string[];
+    memorySearch?: MemorySearchConfig;
+    /** Human-like delay between block replies for this agent. */
+    humanDelay?: HumanDelayConfig;
+    /** Optional per-agent heartbeat overrides. */
+    heartbeat?: AgentDefaultsConfig["heartbeat"];
+    identity?: IdentityConfig;
+    groupChat?: GroupChatConfig;
+    subagents?: {
+        /** Allow spawning sub-agents under other agent ids. Use "*" to allow any. */
+        allowAgents?: string[];
+        /** Per-agent default model for spawned sub-agents (string or {primary,fallbacks}). */
+        model?: string | {
+            primary?: string;
+            fallbacks?: string[];
+        };
+    };
+    sandbox?: {
+        mode?: "off" | "non-main" | "all";
+        /** Agent workspace access inside the sandbox. */
+        workspaceAccess?: "none" | "ro" | "rw";
+        /**
+         * Session tools visibility for sandboxed sessions.
+         * - "spawned": only allow session tools to target sessions spawned from this session (default)
+         * - "all": allow session tools to target any session
+         */
+        sessionToolsVisibility?: "spawned" | "all";
+        /** Container/workspace scope for sandbox isolation. */
+        scope?: "session" | "agent" | "shared";
+        /** Legacy alias for scope ("session" when true, "shared" when false). */
+        perSession?: boolean;
+        workspaceRoot?: string;
+        /** Docker-specific sandbox overrides for this agent. */
+        docker?: SandboxDockerSettings;
+        /** Optional sandboxed browser overrides for this agent. */
+        browser?: SandboxBrowserSettings;
+        /** Auto-prune overrides for this agent. */
+        prune?: SandboxPruneSettings;
+    };
+    tools?: AgentToolsConfig;
+};
+export type AgentsConfig = {
+    defaults?: AgentDefaultsConfig;
+    list?: AgentConfig[];
+};
+export type AgentBinding = {
+    agentId: string;
+    match: {
+        channel: string;
+        accountId?: string;
+        peer?: {
+            kind: "dm" | "group" | "channel";
+            id: string;
+        };
+        guildId?: string;
+        teamId?: string;
+    };
+};

package/dist/plugin-sdk/config/types.approvals.d.ts

@@ -0,0 +1,26 @@
+export type ExecApprovalForwardingMode = "session" | "targets" | "both";
+export type ExecApprovalForwardTarget = {
+    /** Channel id (e.g. "discord", "slack", or plugin channel id). */
+    channel: string;
+    /** Destination id (channel id, user id, etc. depending on channel). */
+    to: string;
+    /** Optional account id for multi-account channels. */
+    accountId?: string;
+    /** Optional thread id to reply inside a thread. */
+    threadId?: string | number;
+};
+export type ExecApprovalForwardingConfig = {
+    /** Enable forwarding exec approvals to chat channels. Default: false. */
+    enabled?: boolean;
+    /** Delivery mode (session=origin chat, targets=config targets, both=both). Default: session. */
+    mode?: ExecApprovalForwardingMode;
+    /** Only forward approvals for these agent IDs. Omit = all agents. */
+    agentFilter?: string[];
+    /** Only forward approvals matching these session key patterns (substring or regex). */
+    sessionFilter?: string[];
+    /** Explicit delivery targets (used when mode includes targets). */
+    targets?: ExecApprovalForwardTarget[];
+};
+export type ApprovalsConfig = {
+    exec?: ExecApprovalForwardingConfig;
+};

package/dist/plugin-sdk/config/types.atlas.d.ts

@@ -0,0 +1,108 @@
+import type { AgentBinding, AgentsConfig } from "./types.agents.js";
+import type { ApprovalsConfig } from "./types.approvals.js";
+import type { AuthConfig } from "./types.auth.js";
+import type { DiagnosticsConfig, LoggingConfig, SessionConfig, WebConfig } from "./types.base.js";
+import type { BrowserConfig } from "./types.browser.js";
+import type { ChannelsConfig } from "./types.channels.js";
+import type { CronConfig } from "./types.cron.js";
+import type { CanvasHostConfig, DiscoveryConfig, GatewayConfig, TalkConfig } from "./types.gateway.js";
+import type { HooksConfig } from "./types.hooks.js";
+import type { MemoryConfig } from "./types.memory.js";
+import type { AudioConfig, BroadcastConfig, CommandsConfig, MessagesConfig } from "./types.messages.js";
+import type { ModelsConfig } from "./types.models.js";
+import type { NodeHostConfig } from "./types.node-host.js";
+import type { PluginsConfig } from "./types.plugins.js";
+import type { SkillsConfig } from "./types.skills.js";
+import type { ToolsConfig } from "./types.tools.js";
+export type AtlasConfig = {
+    meta?: {
+        /** Last Atlas version that wrote this config. */
+        lastTouchedVersion?: string;
+        /** ISO timestamp when this config was last written. */
+        lastTouchedAt?: string;
+    };
+    auth?: AuthConfig;
+    env?: {
+        /** Opt-in: import missing secrets from a login shell environment (exec `$SHELL -l -c 'env -0'`). */
+        shellEnv?: {
+            enabled?: boolean;
+            /** Timeout for the login shell exec (ms). Default: 15000. */
+            timeoutMs?: number;
+        };
+        /** Inline env vars to apply when not already present in the process env. */
+        vars?: Record<string, string>;
+        /** Sugar: allow env vars directly under env (string values only). */
+        [key: string]: string | Record<string, string> | {
+            enabled?: boolean;
+            timeoutMs?: number;
+        } | undefined;
+    };
+    wizard?: {
+        lastRunAt?: string;
+        lastRunVersion?: string;
+        lastRunCommit?: string;
+        lastRunCommand?: string;
+        lastRunMode?: "local" | "remote";
+    };
+    diagnostics?: DiagnosticsConfig;
+    logging?: LoggingConfig;
+    update?: {
+        /** Update channel for git + npm installs ("stable", "beta", or "dev"). */
+        channel?: "stable" | "beta" | "dev";
+        /** Check for updates on gateway start (npm installs only). */
+        checkOnStart?: boolean;
+    };
+    browser?: BrowserConfig;
+    ui?: {
+        /** Accent color for Atlas UI chrome (hex). */
+        seamColor?: string;
+        assistant?: {
+            /** Assistant display name for UI surfaces. */
+            name?: string;
+            /** Assistant avatar (emoji, short text, or image URL/data URI). */
+            avatar?: string;
+        };
+    };
+    skills?: SkillsConfig;
+    plugins?: PluginsConfig;
+    models?: ModelsConfig;
+    nodeHost?: NodeHostConfig;
+    agents?: AgentsConfig;
+    tools?: ToolsConfig;
+    bindings?: AgentBinding[];
+    broadcast?: BroadcastConfig;
+    audio?: AudioConfig;
+    messages?: MessagesConfig;
+    commands?: CommandsConfig;
+    approvals?: ApprovalsConfig;
+    session?: SessionConfig;
+    web?: WebConfig;
+    channels?: ChannelsConfig;
+    cron?: CronConfig;
+    hooks?: HooksConfig;
+    discovery?: DiscoveryConfig;
+    canvasHost?: CanvasHostConfig;
+    talk?: TalkConfig;
+    gateway?: GatewayConfig;
+    memory?: MemoryConfig;
+};
+export type ConfigValidationIssue = {
+    path: string;
+    message: string;
+};
+export type LegacyConfigIssue = {
+    path: string;
+    message: string;
+};
+export type ConfigFileSnapshot = {
+    path: string;
+    exists: boolean;
+    raw: string | null;
+    parsed: unknown;
+    valid: boolean;
+    config: AtlasConfig;
+    hash?: string;
+    issues: ConfigValidationIssue[];
+    warnings: ConfigValidationIssue[];
+    legacyIssues: LegacyConfigIssue[];
+};

package/dist/plugin-sdk/config/types.auth.d.ts

@@ -0,0 +1,28 @@
+export type AuthProfileConfig = {
+    provider: string;
+    /**
+     * Credential type expected in auth-profiles.json for this profile id.
+     * - api_key: static provider API key
+     * - oauth: refreshable OAuth credentials (access+refresh+expires)
+     * - token: static bearer-style token (optionally expiring; no refresh)
+     */
+    mode: "api_key" | "oauth" | "token";
+    email?: string;
+};
+export type AuthConfig = {
+    profiles?: Record<string, AuthProfileConfig>;
+    order?: Record<string, string[]>;
+    cooldowns?: {
+        /** Default billing backoff (hours). Default: 5. */
+        billingBackoffHours?: number;
+        /** Optional per-provider billing backoff (hours). */
+        billingBackoffHoursByProvider?: Record<string, number>;
+        /** Billing backoff cap (hours). Default: 24. */
+        billingMaxHours?: number;
+        /**
+         * Failure window for backoff counters (hours). If no failures occur within
+         * this window, counters reset. Default: 24.
+         */
+        failureWindowHours?: number;
+    };
+};

package/dist/plugin-sdk/config/types.base.d.ts

@@ -0,0 +1,149 @@
+import type { NormalizedChatType } from "../channels/chat-type.js";
+export type ReplyMode = "text" | "command";
+export type TypingMode = "never" | "instant" | "thinking" | "message";
+export type SessionScope = "per-sender" | "global";
+export type DmScope = "main" | "per-peer" | "per-channel-peer" | "per-account-channel-peer";
+export type ReplyToMode = "off" | "first" | "all";
+export type GroupPolicy = "open" | "disabled" | "allowlist";
+export type DmPolicy = "pairing" | "allowlist" | "open" | "disabled";
+export type OutboundRetryConfig = {
+    /** Max retry attempts for outbound requests (default: 3). */
+    attempts?: number;
+    /** Minimum retry delay in ms (default: 300-500ms depending on provider). */
+    minDelayMs?: number;
+    /** Maximum retry delay cap in ms (default: 30000). */
+    maxDelayMs?: number;
+    /** Jitter factor (0-1) applied to delays (default: 0.1). */
+    jitter?: number;
+};
+export type BlockStreamingCoalesceConfig = {
+    minChars?: number;
+    maxChars?: number;
+    idleMs?: number;
+};
+export type BlockStreamingChunkConfig = {
+    minChars?: number;
+    maxChars?: number;
+    breakPreference?: "paragraph" | "newline" | "sentence";
+};
+export type MarkdownTableMode = "off" | "bullets" | "code";
+export type MarkdownConfig = {
+    /** Table rendering mode (off|bullets|code). */
+    tables?: MarkdownTableMode;
+};
+export type HumanDelayConfig = {
+    /** Delay style for block replies (off|natural|custom). */
+    mode?: "off" | "natural" | "custom";
+    /** Minimum delay in milliseconds (default: 800). */
+    minMs?: number;
+    /** Maximum delay in milliseconds (default: 2500). */
+    maxMs?: number;
+};
+export type SessionSendPolicyAction = "allow" | "deny";
+export type SessionSendPolicyMatch = {
+    channel?: string;
+    chatType?: NormalizedChatType;
+    keyPrefix?: string;
+};
+export type SessionSendPolicyRule = {
+    action: SessionSendPolicyAction;
+    match?: SessionSendPolicyMatch;
+};
+export type SessionSendPolicyConfig = {
+    default?: SessionSendPolicyAction;
+    rules?: SessionSendPolicyRule[];
+};
+export type SessionResetMode = "daily" | "idle";
+export type SessionResetConfig = {
+    mode?: SessionResetMode;
+    /** Local hour (0-23) for the daily reset boundary. */
+    atHour?: number;
+    /** Sliding idle window (minutes). When set with daily mode, whichever expires first wins. */
+    idleMinutes?: number;
+};
+export type SessionResetByTypeConfig = {
+    dm?: SessionResetConfig;
+    group?: SessionResetConfig;
+    thread?: SessionResetConfig;
+};
+export type SessionConfig = {
+    scope?: SessionScope;
+    /** DM session scoping (default: "main"). */
+    dmScope?: DmScope;
+    /** Map platform-prefixed identities (e.g. "telegram:123") to canonical DM peers. */
+    identityLinks?: Record<string, string[]>;
+    resetTriggers?: string[];
+    idleMinutes?: number;
+    reset?: SessionResetConfig;
+    resetByType?: SessionResetByTypeConfig;
+    /** Channel-specific reset overrides (e.g. { discord: { mode: "idle", idleMinutes: 10080 } }). */
+    resetByChannel?: Record<string, SessionResetConfig>;
+    store?: string;
+    typingIntervalSeconds?: number;
+    typingMode?: TypingMode;
+    mainKey?: string;
+    sendPolicy?: SessionSendPolicyConfig;
+    agentToAgent?: {
+        /** Max ping-pong turns between requester/target (0–5). Default: 5. */
+        maxPingPongTurns?: number;
+    };
+};
+export type LoggingConfig = {
+    level?: "silent" | "fatal" | "error" | "warn" | "info" | "debug" | "trace";
+    file?: string;
+    consoleLevel?: "silent" | "fatal" | "error" | "warn" | "info" | "debug" | "trace";
+    consoleStyle?: "pretty" | "compact" | "json";
+    /** Redact sensitive tokens in tool summaries. Default: "tools". */
+    redactSensitive?: "off" | "tools";
+    /** Regex patterns used to redact sensitive tokens (defaults apply when unset). */
+    redactPatterns?: string[];
+};
+export type DiagnosticsOtelConfig = {
+    enabled?: boolean;
+    endpoint?: string;
+    protocol?: "http/protobuf" | "grpc";
+    headers?: Record<string, string>;
+    serviceName?: string;
+    traces?: boolean;
+    metrics?: boolean;
+    logs?: boolean;
+    /** Trace sample rate (0.0 - 1.0). */
+    sampleRate?: number;
+    /** Metric export interval (ms). */
+    flushIntervalMs?: number;
+};
+export type DiagnosticsCacheTraceConfig = {
+    enabled?: boolean;
+    filePath?: string;
+    includeMessages?: boolean;
+    includePrompt?: boolean;
+    includeSystem?: boolean;
+};
+export type DiagnosticsConfig = {
+    enabled?: boolean;
+    /** Optional ad-hoc diagnostics flags (e.g. "telegram.http"). */
+    flags?: string[];
+    otel?: DiagnosticsOtelConfig;
+    cacheTrace?: DiagnosticsCacheTraceConfig;
+};
+export type WebReconnectConfig = {
+    initialMs?: number;
+    maxMs?: number;
+    factor?: number;
+    jitter?: number;
+    maxAttempts?: number;
+};
+export type WebConfig = {
+    /** If false, do not start the WhatsApp web provider. Default: true. */
+    enabled?: boolean;
+    heartbeatSeconds?: number;
+    reconnect?: WebReconnectConfig;
+};
+export type AgentElevatedAllowFromConfig = Partial<Record<string, Array<string | number>>>;
+export type IdentityConfig = {
+    name?: string;
+    theme?: string;
+    emoji?: string;
+    /** Avatar image: workspace-relative path, http(s) URL, or data URI. */
+    avatar?: string;
+};