feat: add manual mode controls for context tools

Introduce configurable manual mode with command triggers so users can control prune, distill, and compress execution while preserving optional automatic strategies.

Author: Tarquinen

dcp.schema.json

@@ -56,6 +56,27 @@
                 "protectedTools": []
             }
         },
+        "manualMode": {
+            "type": "object",
+            "description": "Manual mode behavior for context management tools",
+            "additionalProperties": false,
+            "properties": {
+                "enabled": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Start new sessions with manual mode enabled"
+                },
+                "automaticStrategies": {
+                    "type": "boolean",
+                    "default": true,
+                    "description": "When manual mode is enabled, keep automatic deduplication/supersede/purge strategies running"
+                }
+            },
+            "default": {
+                "enabled": false,
+                "automaticStrategies": true
+            }
+        },
         "turnProtection": {
             "type": "object",
             "description": "Protect recent tool outputs from being pruned",

index.ts

@@ -18,7 +18,7 @@ const plugin: Plugin = (async (ctx) => {
     }
 
     const logger = new Logger(config.debug)
-    const state = createSessionState()
+    const state = createSessionState(config.manualMode.enabled)
 
     if (isSecureMode()) {
         configureClientAuth(ctx.client)

lib/commands/help.ts

@@ -16,16 +16,22 @@ export interface HelpCommandContext {
     messages: WithParts[]
 }
 
-function formatHelpMessage(): string {
+function formatHelpMessage(manualMode: boolean): string {
     const lines: string[] = []
 
     lines.push("╭───────────────────────────────────────────────────────────╮")
     lines.push("│                      DCP Commands                         │")
     lines.push("╰───────────────────────────────────────────────────────────╯")
     lines.push("")
+    lines.push(`  Manual mode:      ${manualMode ? "ON" : "OFF"}`)
+    lines.push("")
     lines.push("  /dcp context      Show token usage breakdown for current session")
     lines.push("  /dcp stats        Show DCP pruning statistics")
     lines.push("  /dcp sweep [n]    Prune tools since last user message, or last n tools")
+    lines.push("  /dcp manual [on|off]  Toggle manual mode or set explicit state")
+    lines.push("  /dcp prune        Trigger manual prune tool execution")
+    lines.push("  /dcp distill      Trigger manual distill tool execution")
+    lines.push("  /dcp compress     Trigger manual compress tool execution")
     lines.push("")
 
     return lines.join("\n")
@@ -34,7 +40,7 @@ function formatHelpMessage(): string {
 export async function handleHelpCommand(ctx: HelpCommandContext): Promise<void> {
     const { client, state, logger, sessionId, messages } = ctx
 
-    const message = formatHelpMessage()
+    const message = formatHelpMessage(state.manualMode)
 
     const params = getCurrentParams(state, messages, logger)
     await sendIgnoredMessage(client, sessionId, message, params, logger)

lib/config.ts

@@ -43,6 +43,11 @@ export interface Commands {
     protectedTools: string[]
 }
 
+export interface ManualModeConfig {
+    enabled: boolean
+    automaticStrategies: boolean
+}
+
 export interface SupersedeWrites {
     enabled: boolean
 }
@@ -64,6 +69,7 @@ export interface PluginConfig {
     pruneNotification: "off" | "minimal" | "detailed"
     pruneNotificationType: "chat" | "toast"
     commands: Commands
+    manualMode: ManualModeConfig
     turnProtection: TurnProtection
     protectedFilePatterns: string[]
     tools: Tools
@@ -102,6 +108,9 @@ export const VALID_CONFIG_KEYS = new Set([
     "commands",
     "commands.enabled",
     "commands.protectedTools",
+    "manualMode",
+    "manualMode.enabled",
+    "manualMode.automaticStrategies",
     "tools",
     "tools.settings",
     "tools.settings.nudgeEnabled",
@@ -263,6 +272,36 @@ export function validateConfigTypes(config: Record<string, any>): ValidationErro
         }
     }
 
+    // Manual mode validator
+    const manualMode = config.manualMode
+    if (manualMode !== undefined) {
+        if (typeof manualMode === "object") {
+            if (manualMode.enabled !== undefined && typeof manualMode.enabled !== "boolean") {
+                errors.push({
+                    key: "manualMode.enabled",
+                    expected: "boolean",
+                    actual: typeof manualMode.enabled,
+                })
+            }
+            if (
+                manualMode.automaticStrategies !== undefined &&
+                typeof manualMode.automaticStrategies !== "boolean"
+            ) {
+                errors.push({
+                    key: "manualMode.automaticStrategies",
+                    expected: "boolean",
+                    actual: typeof manualMode.automaticStrategies,
+                })
+            }
+        } else {
+            errors.push({
+                key: "manualMode",
+                expected: "{ enabled: boolean, automaticStrategies: boolean }",
+                actual: typeof manualMode,
+            })
+        }
+    }
+
     // Tools validators
     const tools = config.tools
     if (tools) {
@@ -529,6 +568,10 @@ const defaultConfig: PluginConfig = {
         enabled: true,
         protectedTools: [...DEFAULT_PROTECTED_TOOLS],
     },
+    manualMode: {
+        enabled: false,
+        automaticStrategies: true,
+    },
     turnProtection: {
         enabled: false,
         turns: 4,
@@ -747,13 +790,29 @@ function mergeCommands(
     }
 }
 
+function mergeManualMode(
+    base: PluginConfig["manualMode"],
+    override?: Partial<PluginConfig["manualMode"]>,
+): PluginConfig["manualMode"] {
+    if (override === undefined) return base
+
+    return {
+        enabled: override.enabled ?? base.enabled,
+        automaticStrategies: override.automaticStrategies ?? base.automaticStrategies,
+    }
+}
+
 function deepCloneConfig(config: PluginConfig): PluginConfig {
     return {
         ...config,
         commands: {
             enabled: config.commands.enabled,
             protectedTools: [...config.commands.protectedTools],
         },
+        manualMode: {
+            enabled: config.manualMode.enabled,
+            automaticStrategies: config.manualMode.automaticStrategies,
+        },
         turnProtection: { ...config.turnProtection },
         protectedFilePatterns: [...config.protectedFilePatterns],
         tools: {
@@ -812,6 +871,7 @@ export function getConfig(ctx: PluginInput): PluginConfig {
                 pruneNotificationType:
                     result.data.pruneNotificationType ?? config.pruneNotificationType,
                 commands: mergeCommands(config.commands, result.data.commands as any),
+                manualMode: mergeManualMode(config.manualMode, result.data.manualMode as any),
                 turnProtection: {
                     enabled: result.data.turnProtection?.enabled ?? config.turnProtection.enabled,
                     turns: result.data.turnProtection?.turns ?? config.turnProtection.turns,
@@ -857,6 +917,7 @@ export function getConfig(ctx: PluginInput): PluginConfig {
                 pruneNotificationType:
                     result.data.pruneNotificationType ?? config.pruneNotificationType,
                 commands: mergeCommands(config.commands, result.data.commands as any),
+                manualMode: mergeManualMode(config.manualMode, result.data.manualMode as any),
                 turnProtection: {
                     enabled: result.data.turnProtection?.enabled ?? config.turnProtection.enabled,
                     turns: result.data.turnProtection?.turns ?? config.turnProtection.turns,
@@ -899,6 +960,7 @@ export function getConfig(ctx: PluginInput): PluginConfig {
                 pruneNotificationType:
                     result.data.pruneNotificationType ?? config.pruneNotificationType,
                 commands: mergeCommands(config.commands, result.data.commands as any),
+                manualMode: mergeManualMode(config.manualMode, result.data.manualMode as any),
                 turnProtection: {
                     enabled: result.data.turnProtection?.enabled ?? config.turnProtection.enabled,
                     turns: result.data.turnProtection?.turns ?? config.turnProtection.turns,