feat: add settings-backed generic listen-only mode and invoke gating

Author: deanfluencebot

interface/src/api/client.ts

@@ -566,6 +566,10 @@ export interface BrowserSection {
 	evaluate_enabled: boolean;
 }
 
+export interface ChannelSection {
+	listen_only_mode: boolean;
+}
+
 export interface SandboxSection {
 	mode: "enabled" | "disabled";
 	writable_paths: string[];
@@ -584,6 +588,7 @@ export interface AgentConfigResponse {
 	coalesce: CoalesceSection;
 	memory_persistence: MemoryPersistenceSection;
 	browser: BrowserSection;
+	channel: ChannelSection;
 	discord: DiscordSection;
 	sandbox: SandboxSection;
 }
@@ -648,6 +653,10 @@ export interface BrowserUpdate {
 	evaluate_enabled?: boolean;
 }
 
+export interface ChannelUpdate {
+	listen_only_mode?: boolean;
+}
+
 export interface SandboxUpdate {
 	mode?: "enabled" | "disabled";
 	writable_paths?: string[];
@@ -666,6 +675,7 @@ export interface AgentConfigUpdateRequest {
 	coalesce?: CoalesceUpdate;
 	memory_persistence?: MemoryPersistenceUpdate;
 	browser?: BrowserUpdate;
+	channel?: ChannelUpdate;
 	discord?: DiscordUpdate;
 	sandbox?: SandboxUpdate;
 }

interface/src/routes/AgentConfig.tsx

@@ -15,7 +15,7 @@ function supportsAdaptiveThinking(modelId: string): boolean {
 		|| id.includes("sonnet-4-6") || id.includes("sonnet-4.6");
 }
 
-type SectionId = "soul" | "identity" | "user" | "routing" | "tuning" | "compaction" | "cortex" | "coalesce" | "memory" | "browser" | "sandbox";
+type SectionId = "soul" | "identity" | "user" | "routing" | "tuning" | "compaction" | "cortex" | "coalesce" | "memory" | "browser" | "channel" | "sandbox";
 
 const SECTIONS: {
 	id: SectionId;
@@ -34,6 +34,7 @@ const SECTIONS: {
 	{ id: "coalesce", label: "Coalesce", group: "config", description: "Message batching", detail: "When multiple messages arrive in quick succession, coalescing batches them into a single LLM turn. This prevents the agent from responding to each message individually in fast-moving conversations." },
 	{ id: "memory", label: "Memory Persistence", group: "config", description: "Auto-save interval", detail: "Spawns a silent background branch at regular intervals to recall existing memories and save new ones from the recent conversation. Runs without blocking the channel." },
 	{ id: "browser", label: "Browser", group: "config", description: "Chrome automation", detail: "Controls browser automation tools available to workers. When enabled, workers can navigate web pages, take screenshots, and interact with sites. JavaScript evaluation is a separate permission." },
+	{ id: "channel", label: "Channel Behavior", group: "config", description: "Reply behavior", detail: "Listen-only mode suppresses unsolicited replies in busy channels. The agent still responds to slash commands, @mentions, and replies to its own messages." },
 	{ id: "sandbox", label: "Sandbox", group: "config", description: "Process containment", detail: "OS-level filesystem containment for shell and exec tool subprocesses. When enabled, worker processes run inside a kernel-enforced sandbox (bubblewrap on Linux, sandbox-exec on macOS) with an allowlist-only filesystem — only system paths, the workspace, and explicitly configured extra paths are accessible." },
 ];
 
@@ -64,7 +65,7 @@ export function AgentConfig({ agentId }: AgentConfigProps) {
 	// Sync activeSection with URL search param
 	useEffect(() => {
 		if (search.tab) {
-			const validSections: SectionId[] = ["soul", "identity", "user", "routing", "tuning", "compaction", "cortex", "coalesce", "memory", "browser", "sandbox"];
+			const validSections: SectionId[] = ["soul", "identity", "user", "routing", "tuning", "compaction", "cortex", "coalesce", "memory", "browser", "channel", "sandbox"];
 			if (validSections.includes(search.tab as SectionId)) {
 				setActiveSection(search.tab as SectionId);
 			}
@@ -414,6 +415,7 @@ const SANDBOX_DEFAULTS = { mode: "enabled" as const, writable_paths: [] as strin
 function ConfigSectionEditor({ sectionId, label, description, detail, config, onDirtyChange, saveHandlerRef, onSave }: ConfigSectionEditorProps) {
 	type ConfigValues = Record<string, string | number | boolean | string[]>;
 	const sandbox = config.sandbox ?? SANDBOX_DEFAULTS;
+	const channel = config.channel ?? { listen_only_mode: false };
 	const [localValues, setLocalValues] = useState<ConfigValues>(() => {
 		// Initialize from config based on section
 		switch (sectionId) {
@@ -431,6 +433,8 @@ function ConfigSectionEditor({ sectionId, label, description, detail, config, on
 				return { ...config.memory_persistence } as ConfigValues;
 			case "browser":
 				return { ...config.browser } as ConfigValues;
+			case "channel":
+				return { ...channel } as ConfigValues;
 			case "sandbox":
 				return { mode: sandbox.mode, writable_paths: sandbox.writable_paths } as ConfigValues;
 			default:
@@ -469,6 +473,9 @@ function ConfigSectionEditor({ sectionId, label, description, detail, config, on
 				case "browser":
 					setLocalValues({ ...config.browser });
 					break;
+				case "channel":
+					setLocalValues({ ...channel });
+					break;
 				case "sandbox":
 					setLocalValues({ mode: sandbox.mode, writable_paths: sandbox.writable_paths });
 					break;
@@ -509,6 +516,9 @@ function ConfigSectionEditor({ sectionId, label, description, detail, config, on
 			case "browser":
 				setLocalValues({ ...config.browser });
 				break;
+			case "channel":
+				setLocalValues({ ...channel });
+				break;
 			case "sandbox":
 				setLocalValues({ mode: sandbox.mode, writable_paths: sandbox.writable_paths });
 				break;
@@ -852,6 +862,17 @@ function ConfigSectionEditor({ sectionId, label, description, detail, config, on
 						</div>
 					</div>
 				);
+			case "channel":
+				return (
+					<div className="grid gap-4">
+						<ConfigToggleField
+							label="Listen-Only Mode"
+							description="Only respond when explicitly invoked (slash command, @mention, or reply-to-bot)."
+							value={localValues.listen_only_mode as boolean}
+							onChange={(v) => handleChange("listen_only_mode", v)}
+						/>
+					</div>
+				);
 			default:
 				return null;
 		}