dcp.schema.json

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "$id": "https://raw.githubusercontent.com/ranxianglei/opencode-acp/master/dcp.schema.json",
    "title": "ACP Plugin Configuration",
    "description": "Configuration schema for the OpenCode Agent Context Pruning plugin",
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "$schema": {
            "type": "string",
            "description": "JSON Schema reference for IDE autocomplete"
        },
        "enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable or disable the DCP plugin"
        },
        "autoUpdate": {
            "type": "boolean",
            "default": true,
            "description": "Automatically update npm-installed DCP when a newer npm latest version is available. Version-locked plugin specs are not updated."
        },
        "debug": {
            "type": "boolean",
            "default": false,
            "description": "Enable full debug logging (overrides logLevel)"
        },
        "logLevel": {
            "type": "string",
            "enum": ["debug", "info", "warn", "error", "silent"],
            "default": "info",
            "description": "Log verbosity: decision-level events (info) are written by default. debug adds per-message detail; warn/error/silent reduce output."
        },
        "storagePath": {
            "type": "string",
            "description": "Directory where per-session state files are persisted. Absolute paths are used as-is; ~/... expands against the home directory; relative paths resolve against the project directory. Unset: $XDG_DATA_HOME/opencode/storage/plugin/acp (default)."
        },
        "pruneNotification": {
            "type": "string",
            "enum": [
                "off",
                "minimal",
                "detailed"
            ],
            "default": "off",
            "description": "Level of notification shown when context management occurs"
        },
        "pruneNotificationType": {
            "type": "string",
            "enum": [
                "chat",
                "toast"
            ],
            "default": "toast",
            "description": "Where to display notifications (chat deprecated, falls back to toast)"
        },
        "commands": {
            "type": "object",
            "description": "Configuration for DCP slash commands (/dcp)",
            "additionalProperties": false,
            "properties": {
                "enabled": {
                    "type": "boolean",
                    "default": true,
                    "description": "Enable DCP slash commands (/dcp)"
                },
                "protectedTools": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "default": [],
                    "description": "Additional tool names or wildcard patterns to protect from pruning via commands. Supports glob wildcards: * matches any characters, ? matches a single character (e.g., \"mcp_*\", \"my_tool_?\")"
                }
            },
            "default": {
                "enabled": true,
                "protectedTools": []
            }
        },
        "allowSubAgents": {
            "type": "boolean",
            "default": true,
            "description": "Allow ACP processing in subagent sessions. When true, subagent sessions get full compression/nudge capabilities. (Moved from experimental in v1.14.13; old experimental.allowSubAgents still read for backward compat.)"
        },
        "experimental": {
            "type": "object",
            "description": "Experimental settings that may change in future releases",
            "additionalProperties": false,
            "properties": {
                "allowSubAgents": {
                    "type": "boolean",
                    "default": false,
                    "description": "[DEPRECATED — use top-level allowSubAgents] Allow ACP processing in subagent sessions. Kept for backward compat; top-level takes priority."
                },
                "customPrompts": {
                    "type": "boolean",
                    "default": false,
                    "description": "Enable user-editable prompt overrides under dcp-prompts directories"
                }
            },
            "default": {
                "customPrompts": false
            }
        },
        "protectedFilePatterns": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "default": [],
            "description": "Glob patterns for files that should be protected from pruning (e.g., '**/*.config.ts')"
        },
        "compress": {
            "type": "object",
            "description": "Configuration for the unified compress tool",
            "additionalProperties": false,
            "properties": {
                "permission": {
                    "type": "string",
                    "enum": [
                        "ask",
                        "allow",
                        "deny"
                    ],
                    "default": "allow",
                    "description": "Permission mode (deny disables the tool)"
                },
                "showCompression": {
                    "type": "boolean",
                    "default": false,
                    "description": "Show compression summaries in notifications"
                },
                "summaryBuffer": {
                    "type": "boolean",
                    "default": true,
                    "description": "When enabled, active summary tokens extend the effective maxContextLimit used for context-limit nudges."
                },
                "maxContextLimit": {
                    "description": "Soft upper threshold. Above this, DCP keeps sending strong compression nudges (based on nudgeFrequency), so the model is pushed to compress. Accepts number or \"X%\" of the model context window.",
                    "default": 100000,
                    "oneOf": [
                        {
                            "type": "number"
                        },
                        {
                            "type": "string",
                            "pattern": "^\\d+(?:\\.\\d+)?%$"
                        }
                    ]
                },
                "minContextLimit": {
                    "description": "[DEPRECATED — scheduled for removal; growth nudges (minNudgeContextPercent) are the maintained floor] Soft lower threshold for reminder nudges. Below this, turn/iteration reminders are off (compression is less likely). At or above this, reminders are on. Still honored until removed. Accepts number or \"X%\" of the model context window.",
                    "default": 50000,
                    "oneOf": [
                        {
                            "type": "number"
                        },
                        {
                            "type": "string",
                            "pattern": "^\\d+(?:\\.\\d+)?%$"
                        }
                    ]
                },
                "modelMaxLimits": {
                    "description": "Per-model override for maxContextLimit by exact provider/model key. If set, this takes priority over the global maxContextLimit.",
                    "type": "object",
                    "additionalProperties": {
                        "oneOf": [
                            {
                                "type": "number"
                            },
                            {
                                "type": "string",
                                "pattern": "^\\d+(?:\\.\\d+)?%$"
                            }
                        ]
                    }
                },
                "modelMinLimits": {
                    "description": "[DEPRECATED — overrides the deprecated minContextLimit; will be removed alongside it] Per-model override for minContextLimit by exact provider/model key. If set, this takes priority over the global minContextLimit.",
                    "type": "object",
                    "additionalProperties": {
                        "oneOf": [
                            {
                                "type": "number"
                            },
                            {
                                "type": "string",
                                "pattern": "^\\d+(?:\\.\\d+)?%$"
                            }
                        ]
                    }
                },
                "nudgeFrequency": {
                    "type": "number",
                    "default": 5,
                    "minimum": 1,
                    "description": "How often the context-limit nudge fires when above maxContextLimit (1 = every fetch, 5 = every 5th fetch)"
                },
                "iterationNudgeThreshold": {
                    "type": "number",
                    "default": 15,
                    "minimum": 1,
                    "description": "How many messages to wait after a user message before adding compression reminders."
                },
                "nudgeForce": {
                    "type": "string",
                    "enum": [
                        "strong",
                        "soft"
                    ],
                    "default": "soft",
                    "description": "Controls how likely compression is after user messages. 'strong' is more likely, 'soft' is less likely."
                },
                "protectedTools": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "default": ["skill", "compress"],
                    "description": "Tool names or wildcard patterns to hard-exclude from compression ranges. The root default is [\"skill\", \"compress\"]; an explicit array replaces the inherited policy. Use [] to allow all tool outputs to compress. Supports glob wildcards: * matches any characters, ? matches a single character (e.g., \"mcp_*\", \"my_tool_?\")"
                },
                "protectTags": {
                    "type": "boolean",
                    "default": false,
                    "description": "Preserve text wrapped in <protect>...</protect> when compressed"
                },
                "protectUserMessages": {
                    "type": "boolean",
                    "default": false,
                    "description": "When enabled, your messages are never lost during compression"
                },
                "minNudgeContextPercent": {
                    "type": "number",
                    "default": 5,
                    "minimum": 0,
                    "description": "Minimum context usage percent for growth-triggered nudges; growth nudges below this floor are suppressed (0 disables the floor)"
                },
                "providers": {
                    "type": "object",
                    "description": "Nested per-provider / per-model overrides for every tunable compress field (issue #344). Field-wise cascade: providers[p].models[m] > providers[p] > the global compress value. Unset fields never clear shallower values; 0 is an explicit value (e.g. disable a floor). Unknown provider/model ids fall back to the global value. Not overridable here: permission (session-level), minContextLimit/modelMinLimits (deprecated), modelMaxLimits (flat map), and this providers map itself. maxContextLimit set here takes precedence over modelMaxLimits.",
                    "additionalProperties": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                            "maxContextLimit": {
                                "oneOf": [
                                    {
                                        "type": "number"
                                    },
                                    {
                                        "type": "string",
                                        "pattern": "^\\d+(?:\\.\\d+)?%$"
                                    }
                                ],
                                "description": "Override for the soft upper threshold. Precedence when set here: nested override > modelMaxLimits flat map > global value."
                            },
                            "emergencyThresholdPercent": {
                                "type": [
                                    "number",
                                    "string"
                                ],
                                "description": "Override for the emergency threshold (absolute tokens or percentage string)."
                            },
                            "minNudgeContextPercent": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 100,
                                "description": "Growth-nudge floor percent, resolved against the active model's context window (0 disables the floor)."
                            },
                            "nudgeFrequency": {
                                "type": "number",
                                "minimum": 1,
                                "description": "Override for the context-limit nudge frequency."
                            },
                            "iterationNudgeThreshold": {
                                "type": "number",
                                "minimum": 1,
                                "description": "Override for the iteration nudge threshold."
                            },
                            "toolOutputNudgeThreshold": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Override for the tool-output nudge threshold (absolute tokens)."
                            },
                            "nudgeGrowthTokens": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Override for the per-message nudge growth threshold (absolute tokens)."
                            },
                            "minNudgeGrowthRatio": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 1,
                                "description": "Override for the growth ratio (× nudgeGrowthTokens)."
                            },
                            "minNudgeGrowthFloor": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Override for the absolute growth floor (tokens)."
                            },
                            "nudgeForce": {
                                "type": "string",
                                "enum": [
                                    "strong",
                                    "soft"
                                ],
                                "description": "Override for the nudge force mode."
                            },
                            "protectedTools": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                },
                                "description": "Override for protected tool patterns (replaces the inherited list)."
                            },
                            "showCompression": {
                                "type": "boolean",
                                "description": "Override for showing compression summaries in notifications."
                            },
                            "summaryBuffer": {
                                "type": "boolean",
                                "description": "Override for counting active summary tokens toward the effective maxContextLimit."
                            },
                            "protectTags": {
                                "type": "boolean",
                                "description": "Override for <protect> tag preservation."
                            },
                            "protectUserMessages": {
                                "type": "boolean",
                                "description": "Override for user-message protection."
                            },
                            "maxSummaryLengthHard": {
                                "type": "number",
                                "minimum": 1,
                                "description": "Override for the hard summary length limit (chars)."
                            },
                            "minCompressRange": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Override for the minimum compressible range (chars)."
                            },
                            "maxVisibleSegments": {
                                "type": "number",
                                "minimum": 1,
                                "description": "Override for the max disjoint visible segments shown."
                            },
                            "keepEmbedMaxChars": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Override for the max embedded-content chars kept in summaries."
                            },
                            "lastSegmentSoftBlock": {
                                "type": "boolean",
                                "description": "Override for the recent-message protection master switch."
                            },
                            "preserveRecentMessages": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Override for the protected recent-message count."
                            },
                            "preserveRecentTokens": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Override for the protected recent-token window."
                            },
                            "preserveLastUserMessage": {
                                "type": "boolean",
                                "description": "Override for protecting the most recent user message."
                            },
                            "reasoning": {
                                "type": "object",
                                "description": "Field-wise override of the nested compress.reasoning config (#368). Only set fields override; unset fields inherit the global value.",
                                "properties": {
                                    "drop": {
                                        "type": "boolean",
                                        "description": "Override for the master switch."
                                    },
                                    "threshold": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "description": "Override for the single-thinking size gate (chars)."
                                    }
                                }
                            },
                            "models": {
                                "type": "object",
                                "description": "Per-model overrides by model id (highest precedence)",
                                "additionalProperties": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "properties": {
                                        "maxContextLimit": {
                                            "oneOf": [
                                                {
                                                    "type": "number"
                                                },
                                                {
                                                    "type": "string",
                                                    "pattern": "^\\d+(?:\\.\\d+)?%$"
                                                }
                                            ],
                                            "description": "Override for the soft upper threshold. Precedence when set here: nested override > modelMaxLimits flat map > global value."
                                        },
                                        "emergencyThresholdPercent": {
                                            "type": [
                                                "number",
                                                "string"
                                            ],
                                            "description": "Override for the emergency threshold (absolute tokens or percentage string)."
                                        },
                                        "minNudgeContextPercent": {
                                            "type": "number",
                                            "minimum": 0,
                                            "maximum": 100,
                                            "description": "Growth-nudge floor percent, resolved against the active model's context window (0 disables the floor)."
                                        },
                                        "nudgeFrequency": {
                                            "type": "number",
                                            "minimum": 1,
                                            "description": "Override for the context-limit nudge frequency."
                                        },
                                        "iterationNudgeThreshold": {
                                            "type": "number",
                                            "minimum": 1,
                                            "description": "Override for the iteration nudge threshold."
                                        },
                                        "toolOutputNudgeThreshold": {
                                            "type": "number",
                                            "minimum": 0,
                                            "description": "Override for the tool-output nudge threshold (absolute tokens)."
                                        },
                                        "nudgeGrowthTokens": {
                                            "type": "number",
                                            "minimum": 0,
                                            "description": "Override for the per-message nudge growth threshold (absolute tokens)."
                                        },
                                        "minNudgeGrowthRatio": {
                                            "type": "number",
                                            "minimum": 0,
                                            "maximum": 1,
                                            "description": "Override for the growth ratio (× nudgeGrowthTokens)."
                                        },
                                        "minNudgeGrowthFloor": {
                                            "type": "number",
                                            "minimum": 0,
                                            "description": "Override for the absolute growth floor (tokens)."
                                        },
                                        "nudgeForce": {
                                            "type": "string",
                                            "enum": [
                                                "strong",
                                                "soft"
                                            ],
                                            "description": "Override for the nudge force mode."
                                        },
                                        "protectedTools": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            },
                                            "description": "Override for protected tool patterns (replaces the inherited list)."
                                        },
                                        "showCompression": {
                                            "type": "boolean",
                                            "description": "Override for showing compression summaries in notifications."
                                        },
                                        "summaryBuffer": {
                                            "type": "boolean",
                                            "description": "Override for counting active summary tokens toward the effective maxContextLimit."
                                        },
                                        "protectTags": {
                                            "type": "boolean",
                                            "description": "Override for <protect> tag preservation."
                                        },
                                        "protectUserMessages": {
                                            "type": "boolean",
                                            "description": "Override for user-message protection."
                                        },
                                        "maxSummaryLengthHard": {
                                            "type": "number",
                                            "minimum": 1,
                                            "description": "Override for the hard summary length limit (chars)."
                                        },
                                        "minCompressRange": {
                                            "type": "number",
                                            "minimum": 0,
                                            "description": "Override for the minimum compressible range (chars)."
                                        },
                                        "maxVisibleSegments": {
                                            "type": "number",
                                            "minimum": 1,
                                            "description": "Override for the max disjoint visible segments shown."
                                        },
                                        "keepEmbedMaxChars": {
                                            "type": "number",
                                            "minimum": 0,
                                            "description": "Override for the max embedded-content chars kept in summaries."
                                        },
                                        "lastSegmentSoftBlock": {
                                            "type": "boolean",
                                            "description": "Override for the recent-message protection master switch."
                                        },
                                        "preserveRecentMessages": {
                                            "type": "number",
                                            "minimum": 0,
                                            "description": "Override for the protected recent-message count."
                                        },
                                        "preserveRecentTokens": {
                                            "type": "number",
                                            "minimum": 0,
                                            "description": "Override for the protected recent-token window."
                                        },
                                        "preserveLastUserMessage": {
                                            "type": "boolean",
                                            "description": "Override for protecting the most recent user message."
                                        },
                                        "reasoning": {
                                            "type": "object",
                                            "description": "Field-wise override of the nested compress.reasoning config (#368); model-level wins over provider-level, field by field.",
                                            "properties": {
                                                "drop": {
                                                    "type": "boolean",
                                                    "description": "Override for the master switch."
                                                },
                                                "threshold": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "description": "Override for the single-thinking size gate (chars)."
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "maxSummaryLengthHard": {
                    "type": "number",
                    "default": 20000,
                    "minimum": 1,
                    "description": "Hard limit for summary length in characters"
                },
                "maxVisibleSegments": {
                    "type": "number",
                    "default": 50,
                    "minimum": 1,
                    "description": "Maximum number of disjoint visible-id segments to show the model. When visible messages span more segments (due to compression holes), only the largest tool-bearing/high-token segments are shown, with a '+N omitted' note. Prevents the model from picking compressed-away refs."
                },
                "nudgeGrowthTokens": {
                    "type": "number",
                    "description": "Token growth required between per-message nudges (absolute, not percentage). Shows Tips only after context grows by this many tokens. If unset, fixed default 50000 (uniform for all models). Also drives T2/T3 tier triggers and the growthFloor anti-thrash gate (0.45 × this value)."
                },
                "toolOutputNudgeThreshold": {
                    "type": "number",
                    "description": "Tool-output token growth required before the tool-output accumulation reminder fires (absolute, not percentage). If unset, default follows nudgeGrowthTokens (fixed default 50000). Was hardcoded to 5000 — fired ~10x too often on large-context models (issue #18)."
                },
                "minCompressRange": {
                    "type": "number",
                    "default": 5000,
                    "minimum": 0,
                    "description": "Minimum compressible content (in characters) required for a compression to proceed. Below this threshold, the compress tool rejects the request to avoid overhead exceeding savings. Count excludes protected content."
                },
                "minNudgeGrowthRatio": {
                    "type": "number",
                    "default": 0.45,
                    "minimum": 0,
                    "maximum": 1,
                    "description": "Fraction of nudgeGrowthTokens that must accumulate before a compress nudge fires. Combined with minNudgeGrowthFloor: growthFloor = max(minNudgeGrowthFloor, minNudgeGrowthRatio × nudgeGrowthTokens). Only bypassed when context usage >= emergencyThresholdPercent."
                },
                "minNudgeGrowthFloor": {
                    "type": "number",
                    "default": 5000,
                    "minimum": 0,
                    "description": "Absolute floor for nudge growth threshold (in tokens). Prevents small-context models from having an excessively low growth floor. See minNudgeGrowthRatio."
                },
                "emergencyThresholdPercent": {
                    "type": ["number", "string"],
                    "default": "98%",
                    "description": "Context usage threshold at which the growth floor is bypassed and nudges fire unconditionally (emergency override). Accepts absolute token count or percentage string (e.g. \"98%\")."
                },
                "lastSegmentSoftBlock": {
                    "type": "boolean",
                    "default": true,
                    "description": "Master switch for recent-message protection. When false, all protection (preserveRecentMessages, preserveRecentTokens, preserveLastUserMessage) is disabled."
                },
                "preserveRecentMessages": {
                    "type": "number",
                    "default": 20,
                    "minimum": 0,
                    "description": "Minimum number of recent messages always protected from compression, regardless of nudge recommendation."
                },
                "preserveRecentTokens": {
                    "type": "number",
                    "default": 20000,
                    "minimum": 0,
                    "description": "Minimum token window of recent messages always protected from compression. The protection zone is the union of preserveRecentMessages count and preserveRecentTokens window."
                },
                "preserveLastUserMessage": {
                    "type": "boolean",
                    "default": true,
                    "description": "Always protect the most recent user message from compression."
                },
                "reasoning": {
                    "type": "object",
                    "description": "[#368] Config for dropping oversized reasoning from closed-turn compress tool calls. compress calls are hard-exempt from compression (Bug 39), so their thinking rides along every request as an unreclaimable floor. Only messages strictly BEFORE the last genuine user message are touched; only messages whose total reasoning length EXCEEDS threshold are dropped. Merged field-wise across config layers and the provider/model cascade.",
                    "properties": {
                        "drop": {
                            "type": "boolean",
                            "default": true,
                            "description": "Master switch for the drop pass."
                        },
                        "threshold": {
                            "type": "integer",
                            "default": 2048,
                            "minimum": 0,
                            "description": "Single-thinking size gate (chars): a closed-turn compress message's total reasoning length must exceed this to be dropped. Small thinkings are kept (not accumulated across messages). 0 drops any non-empty reasoning."
                        }
                    }
                }
            },
            "default": {
                "permission": "allow",
                "showCompression": false,
                "summaryBuffer": true,
                "maxContextLimit": 100000,
                "minContextLimit": 50000,
                "nudgeFrequency": 5,
                "iterationNudgeThreshold": 15,
                "nudgeForce": "soft",
                "protectedTools": ["skill", "compress"],
                "protectTags": false,
                "protectUserMessages": false,
                "minNudgeContextPercent": 5,
                "maxSummaryLengthHard": 20000,
                "maxVisibleSegments": 50,
                "minCompressRange": 5000,
                "minNudgeGrowthRatio": 0.45,
                "minNudgeGrowthFloor": 5000,
                "emergencyThresholdPercent": "98%",
                "lastSegmentSoftBlock": true,
                "preserveRecentMessages": 20,
                "preserveRecentTokens": 20000,
                "preserveLastUserMessage": true,
                "reasoning": {
                    "drop": true,
                    "threshold": 2048
                }
            }
        },
        "gc": {
            "type": "object",
            "description": "Garbage collection and batch cleanup configuration",
            "additionalProperties": false,
            "properties": {
                "algorithm": {
                    "type": "string",
                    "enum": [
                        "truncate"
                    ],
                    "default": "truncate"
                },
                "promotionThreshold": {
                    "type": "number",
                    "default": 5
                },
                "maxBlockAge": {
                    "type": "number",
                    "default": 15
                },
                "maxOldGenSummaryLength": {
                    "type": "number",
                    "default": 3000
                },
                "majorGcThresholdPercent": {
                    "default": "100%",
                    "oneOf": [
                        {
                            "type": "number"
                        },
                        {
                            "type": "string",
                            "pattern": "^\\d+(?:\\.\\d+)?%$"
                        }
                    ]
                },
                "batchCleanup": {
                    "type": "object",
                    "description": "Three-tier batch merge-cleanup thresholds for blocks marked via mark_block. Accepts number or \"X%\" of model context window.",
                    "additionalProperties": false,
                    "properties": {
                        "lowThreshold": {
                            "default": "60%",
                            "description": "Nudge tier: at/above this usage, a reminder to merge marked blocks is injected.",
                            "oneOf": [
                                {
                                    "type": "number"
                                },
                                {
                                    "type": "string",
                                    "pattern": "^\\d+(?:\\.\\d+)?%$"
                                }
                            ]
                        },
                        "highThreshold": {
                            "default": "75%",
                            "description": "Auto merge tier: at/above this usage, all marked blocks are merge-compressed into one.",
                            "oneOf": [
                                {
                                    "type": "number"
                                },
                                {
                                    "type": "string",
                                    "pattern": "^\\d+(?:\\.\\d+)?%$"
                                }
                            ]
                        },
                        "forceThreshold": {
                            "default": "90%",
                            "description": "Force merge tier: at/above this usage, all old-gen blocks are merged regardless of marks.",
                            "oneOf": [
                                {
                                    "type": "number"
                                },
                                {
                                    "type": "string",
                                    "pattern": "^\\d+(?:\\.\\d+)?%$"
                                }
                            ]
                        }
                    }
                }
            }
        },
        "qualityGate": {
            "type": "object",
            "description": "Post-compression quality evaluation. Non-blocking: failures only emit logger.warn; the compression result is already committed. Pluggable via the QualityGate interface — future algorithms (including external API judges) can be added without changing pipeline wiring.",
            "additionalProperties": false,
            "properties": {
                "enabled": {
                    "type": "boolean",
                    "default": false,
                    "description": "Enable post-compression quality gate evaluation. Off by default for one release of burn-in."
                },
                "algorithm": {
                    "type": "string",
                    "default": "rouge-recall-v1",
                    "description": "Name of the registered QualityGate algorithm to run."
                },
                "algorithms": {
                    "type": "object",
                    "description": "Per-algorithm config map. Keyed by algorithm name. Unknown algorithms ignored.",
                    "additionalProperties": true,
                    "properties": {
                        "rouge-recall-v1": {
                            "type": "object",
                            "description": "Two-layer gate: L1 length/retention floor, L2 ROUGE-1 F1 AND top-20 keyword recall.",
                            "additionalProperties": false,
                            "properties": {
                                "layer1MinChars": {
                                    "type": "number",
                                    "default": 200,
                                    "minimum": 1,
                                    "description": "Hard floor on summary length. Below this, L1 fails regardless of other metrics."
                                },
                                "layer1MinRetentionPct": {
                                    "type": "number",
                                    "default": 1.0,
                                    "minimum": 0,
                                    "description": "Minimum retention = (summaryLen / (compressedTokens * 4)) * 100. Catches catastrophic retention failures (<1%) with 0% FPR."
                                },
                                "layer2MaxRougeF1": {
                                    "type": "number",
                                    "default": 0.05,
                                    "minimum": 0,
                                    "description": "L2 fails (combined with top20Recall via AND) when ROUGE-1 F1 is below this threshold."
                                },
                                "layer2MaxTop20Recall": {
                                    "type": "number",
                                    "default": 0.20,
                                    "minimum": 0,
                                    "description": "L2 fails (combined with rougeF1 via AND) when top-20 keyword recall is below this threshold."
                                }
                            }
                        }
                    }
                }
            },
            "default": {
                "enabled": false,
                "algorithm": "rouge-recall-v1",
                "algorithms": {
                    "rouge-recall-v1": {
                        "layer1MinChars": 200,
                        "layer1MinRetentionPct": 1.0,
                        "layer2MaxRougeF1": 0.05,
                        "layer2MaxTop20Recall": 0.20
                    }
                }
            }
        },
        "messageFilters": {
            "type": "object",
            "description": "Pluggable message filter system for cleaning up third-party (e.g. OMO) injected messages that accumulate duplicates.",
            "additionalProperties": false,
            "properties": {
                "enabled": {
                    "type": "boolean",
                    "default": true,
                    "description": "Master switch for all message filters."
                },
                "filters": {
                    "type": "object",
                    "description": "Per-filter config map. Keyed by filter name. Each filter can be individually enabled/disabled.",
                    "additionalProperties": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                            "enabled": {
                                "type": "boolean",
                                "default": true,
                                "description": "Enable or disable this specific filter."
                            },
                            "keepLast": {
                                "type": "integer",
                                "minimum": 1,
                                "description": "Override how many of the most recent matches to keep for keepLastOnly filters."
                            }
                        }
                    }
                }
            },
            "default": {
                "enabled": true
            }
        }
    }
}