@xopcai/xopc 0.0.6 → 0.0.11

package/dist/src/chat-commands/builtins/config.js

@@ -0,0 +1,197 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { init_paths, resolveConfigPath } from "../../config/paths.js";
+import { ConfigSchema, init_schema } from "../../config/schema.js";
+import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
+import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
+import { resolveAllowlistMatchSimple } from "../../channels/security.js";
+import { commandRegistry } from "../registry.js";
+import { parseConfigValue } from "../config-value.js";
+import { getConfigValueAtPath, parseConfigPath, setConfigValueAtPath, unsetConfigValueAtPath } from "../config-paths.js";
+//#region src/chat-commands/builtins/config.ts
+init_schema();
+init_loader();
+init_paths();
+init_logger();
+init_session_key();
+const log = createLogger("ConfigCommand");
+const BLOCKED_WRITE_PATHS = new Set(["gateway.auth.token", "providers"]);
+function isBlockedPath(path) {
+	const joined = path.join(".");
+	for (const blocked of BLOCKED_WRITE_PATHS) if (joined === blocked || joined.startsWith(`${blocked}.`)) return true;
+	return false;
+}
+function redactConfigForDisplay(plain) {
+	if (plain.gateway && typeof plain.gateway === "object") {
+		const gw = plain.gateway;
+		if (gw.auth && typeof gw.auth === "object") gw.auth.token = "[redacted]";
+	}
+	if (plain.providers !== void 0) plain.providers = "[redacted]";
+}
+function senderMayWritePersistentConfig(ctx) {
+	const { source, senderId, isGroup, sessionKey } = ctx;
+	if (source !== "telegram" && source !== "weixin") return true;
+	const cfg = ctx.getConfig?.() ?? ctx.config;
+	if (source === "weixin") {
+		const wx = cfg.channels?.weixin;
+		if (!wx?.enabled) return false;
+		const accountId = parseSessionKey(sessionKey)?.accountId ?? "default";
+		let allowFrom = [];
+		if (wx.accounts && Object.keys(wx.accounts).length > 0) {
+			const acc = wx.accounts[accountId] ?? wx.accounts["default"];
+			if (!acc || acc.enabled === false) return false;
+			allowFrom = [...acc.allowFrom ?? []];
+		} else allowFrom = [...wx.allowFrom ?? []];
+		if (allowFrom.length === 0) return false;
+		return resolveAllowlistMatchSimple({
+			allowFrom,
+			senderId
+		}).allowed;
+	}
+	const tg = cfg.channels?.telegram;
+	if (!tg?.enabled) return false;
+	const accountId = parseSessionKey(sessionKey)?.accountId ?? "default";
+	let allowFrom = [];
+	let groupAllowFrom = [];
+	if (tg.accounts && Object.keys(tg.accounts).length > 0) {
+		const acc = tg.accounts[accountId] ?? tg.accounts["default"];
+		if (!acc || acc.enabled === false) return false;
+		allowFrom = [...acc.allowFrom ?? []];
+		groupAllowFrom = [...acc.groupAllowFrom ?? []];
+	} else {
+		allowFrom = [...tg.allowFrom ?? []];
+		groupAllowFrom = [...tg.groupAllowFrom ?? []];
+	}
+	const list = isGroup && groupAllowFrom.length > 0 ? groupAllowFrom : allowFrom;
+	if (list.length === 0) return false;
+	return resolveAllowlistMatchSimple({
+		allowFrom: list,
+		senderId
+	}).allowed;
+}
+const configCommand = {
+	id: "system.config",
+	name: "config",
+	aliases: ["cfg"],
+	description: "Show or update configuration. Usage: /config show [path] | /config set path=value | /config unset path",
+	category: "system",
+	scope: [
+		"global",
+		"private",
+		"group"
+	],
+	acceptsArgs: true,
+	examples: [
+		"/config show",
+		"/config show agents.defaults.model",
+		"/config set agents.defaults.model=anthropic/claude-opus-4-5",
+		"/config set agents.defaults.temperature=0.5",
+		"/config unset tts"
+	],
+	handler: async (ctx, args) => {
+		const parts = args.trim().split(/\s+/);
+		const action = parts[0]?.toLowerCase();
+		const rest = parts.slice(1).join(" ").trim();
+		if (!action || action === "show" || action === "get") {
+			const config = ctx.getConfig?.() ?? loadConfig(resolveConfigPath());
+			const plain = JSON.parse(JSON.stringify(config));
+			redactConfigForDisplay(plain);
+			if (rest) {
+				const parsed = parseConfigPath(rest);
+				if (!parsed.ok || !parsed.path) return {
+					content: `⚠️ ${parsed.error ?? "Invalid path."}`,
+					success: false
+				};
+				const value = getConfigValueAtPath(plain, parsed.path);
+				return { content: `⚙️ \`${rest}\`:\n\`\`\`json\n${JSON.stringify(value ?? null, null, 2)}\n\`\`\`` };
+			}
+			return { content: `⚙️ Current config:\n\`\`\`json\n${JSON.stringify(plain, null, 2)}\n\`\`\`` };
+		}
+		if (action === "set") {
+			if (!senderMayWritePersistentConfig(ctx)) return {
+				content: "⚠️ You are not allowed to change config from this chat surface.",
+				success: false
+			};
+			const eqIndex = rest.indexOf("=");
+			if (eqIndex <= 0) return {
+				content: "⚠️ Usage: /config set path=value",
+				success: false
+			};
+			const pathRaw = rest.slice(0, eqIndex).trim();
+			const valueRaw = rest.slice(eqIndex + 1);
+			const parsedPath = parseConfigPath(pathRaw);
+			if (!parsedPath.ok || !parsedPath.path) return {
+				content: `⚠️ ${parsedPath.error}`,
+				success: false
+			};
+			if (isBlockedPath(parsedPath.path)) return {
+				content: `⚠️ Path \`${pathRaw}\` cannot be modified via chat for security reasons.`,
+				success: false
+			};
+			const parsedValue = parseConfigValue(valueRaw);
+			if (parsedValue.ok === false) return {
+				content: `⚠️ ${parsedValue.error}`,
+				success: false
+			};
+			const currentConfig = loadConfig(resolveConfigPath());
+			setConfigValueAtPath(currentConfig, parsedPath.path, parsedValue.value);
+			const validated = ConfigSchema.safeParse(currentConfig);
+			if (!validated.success) {
+				const firstIssue = validated.error.issues[0];
+				return {
+					content: `⚠️ Config invalid after set (${firstIssue.path.join(".")}: ${firstIssue.message}). Change not saved.`,
+					success: false
+				};
+			}
+			await saveConfig(validated.data);
+			log.info({
+				path: pathRaw,
+				value: parsedValue.value
+			}, "Config updated via /config set");
+			return { content: `⚙️ Config updated: \`${pathRaw}\` = ${typeof parsedValue.value === "string" ? `"${parsedValue.value}"` : JSON.stringify(parsedValue.value)}` };
+		}
+		if (action === "unset") {
+			if (!senderMayWritePersistentConfig(ctx)) return {
+				content: "⚠️ You are not allowed to change config from this chat surface.",
+				success: false
+			};
+			if (!rest) return {
+				content: "⚠️ Usage: /config unset path",
+				success: false
+			};
+			const parsedPath = parseConfigPath(rest);
+			if (!parsedPath.ok || !parsedPath.path) return {
+				content: `⚠️ ${parsedPath.error}`,
+				success: false
+			};
+			if (isBlockedPath(parsedPath.path)) return {
+				content: `⚠️ Path \`${rest}\` cannot be modified via chat for security reasons.`,
+				success: false
+			};
+			const currentConfig = loadConfig(resolveConfigPath());
+			if (!unsetConfigValueAtPath(currentConfig, parsedPath.path)) return {
+				content: `⚙️ No config value found at \`${rest}\`.`,
+				success: false
+			};
+			const validated = ConfigSchema.safeParse(currentConfig);
+			if (!validated.success) {
+				const firstIssue = validated.error.issues[0];
+				return {
+					content: `⚠️ Config invalid after unset (${firstIssue.path.join(".")}: ${firstIssue.message}). Change not saved.`,
+					success: false
+				};
+			}
+			await saveConfig(validated.data);
+			log.info({ path: rest }, "Config key removed via /config unset");
+			return { content: `⚙️ Config updated: \`${rest}\` removed.` };
+		}
+		return { content: "⚙️ *Config Command*\n\n`/config show [path]` — view config (or a specific path)\n`/config set path=value` — update a config value\n`/config unset path` — remove a config key\n\nExamples:\n`/config show agents.defaults.model`\n`/config set agents.defaults.temperature=0.5`\n`/config set agents.defaults.thinkingDefault=medium`\n`/config unset tts`" };
+	}
+};
+function registerConfigCommand() {
+	commandRegistry.register(configCommand);
+}
+//#endregion
+export { registerConfigCommand };
+
+//# sourceMappingURL=config.js.map

package/dist/src/chat-commands/builtins/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../../../src/chat-commands/builtins/config.ts"],"sourcesContent":["/**\n * /config — read and write persistent config (~/.xopc/xopc.json) from chat.\n */\n\nimport type { CommandDefinition, CommandContext } from '../types.js';\nimport { commandRegistry } from '../registry.js';\nimport { parseConfigValue } from '../config-value.js';\nimport {\n  parseConfigPath,\n  getConfigValueAtPath,\n  setConfigValueAtPath,\n  unsetConfigValueAtPath,\n} from '../config-paths.js';\nimport { ConfigSchema, type TelegramConfig, type WeixinConfig } from '../../config/schema.js';\nimport { loadConfig, saveConfig } from '../../config/loader.js';\nimport { resolveConfigPath } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { parseSessionKey } from '../../routing/session-key.js';\nimport { resolveAllowlistMatchSimple } from '../../channels/security.js';\n\nconst log = createLogger('ConfigCommand');\n\nconst BLOCKED_WRITE_PATHS = new Set(['gateway.auth.token', 'providers']);\n\nfunction isBlockedPath(path: string[]): boolean {\n  const joined = path.join('.');\n  for (const blocked of BLOCKED_WRITE_PATHS) {\n    if (joined === blocked || joined.startsWith(`${blocked}.`)) return true;\n  }\n  return false;\n}\n\nfunction redactConfigForDisplay(plain: Record<string, unknown>): void {\n  if (plain.gateway && typeof plain.gateway === 'object') {\n    const gw = plain.gateway as Record<string, unknown>;\n    if (gw.auth && typeof gw.auth === 'object') {\n      (gw.auth as Record<string, unknown>).token = '[redacted]';\n    }\n  }\n  if (plain.providers !== undefined) plain.providers = '[redacted]';\n}\n\nfunction senderMayWritePersistentConfig(ctx: CommandContext): boolean {\n  const { source, senderId, isGroup, sessionKey } = ctx;\n  if (source !== 'telegram' && source !== 'weixin') {\n    return true;\n  }\n\n  const cfg = ctx.getConfig?.() ?? ctx.config;\n\n  if (source === 'weixin') {\n    const wx = cfg.channels?.weixin as WeixinConfig | undefined;\n    if (!wx?.enabled) return false;\n    const parsed = parseSessionKey(sessionKey);\n    const accountId = parsed?.accountId ?? 'default';\n    let allowFrom: Array<string | number> = [];\n    if (wx.accounts && Object.keys(wx.accounts).length > 0) {\n      const acc = wx.accounts[accountId] ?? wx.accounts['default'];\n      if (!acc || acc.enabled === false) return false;\n      allowFrom = [...(acc.allowFrom ?? [])];\n    } else {\n      allowFrom = [...(wx.allowFrom ?? [])];\n    }\n    if (allowFrom.length === 0) return false;\n    return resolveAllowlistMatchSimple({ allowFrom, senderId }).allowed;\n  }\n\n  const tg = cfg.channels?.telegram as TelegramConfig | undefined;\n  if (!tg?.enabled) return false;\n  const parsed = parseSessionKey(sessionKey);\n  const accountId = parsed?.accountId ?? 'default';\n  let allowFrom: Array<string | number> = [];\n  let groupAllowFrom: Array<string | number> = [];\n  if (tg.accounts && Object.keys(tg.accounts).length > 0) {\n    const acc = tg.accounts[accountId] ?? tg.accounts['default'];\n    if (!acc || acc.enabled === false) return false;\n    allowFrom = [...(acc.allowFrom ?? [])];\n    groupAllowFrom = [...(acc.groupAllowFrom ?? [])];\n  } else {\n    allowFrom = [...(tg.allowFrom ?? [])];\n    groupAllowFrom = [...(tg.groupAllowFrom ?? [])];\n  }\n  const list = isGroup && groupAllowFrom.length > 0 ? groupAllowFrom : allowFrom;\n  if (list.length === 0) return false;\n  return resolveAllowlistMatchSimple({ allowFrom: list, senderId }).allowed;\n}\n\nconst configCommand: CommandDefinition = {\n  id: 'system.config',\n  name: 'config',\n  aliases: ['cfg'],\n  description:\n    'Show or update configuration. Usage: /config show [path] | /config set path=value | /config unset path',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: [\n    '/config show',\n    '/config show agents.defaults.model',\n    '/config set agents.defaults.model=anthropic/claude-opus-4-5',\n    '/config set agents.defaults.temperature=0.5',\n    '/config unset tts',\n  ],\n  handler: async (ctx: CommandContext, args: string) => {\n    const parts = args.trim().split(/\\s+/);\n    const action = parts[0]?.toLowerCase();\n    const rest = parts.slice(1).join(' ').trim();\n\n    if (!action || action === 'show' || action === 'get') {\n      const config = ctx.getConfig?.() ?? loadConfig(resolveConfigPath());\n      const plain = JSON.parse(JSON.stringify(config)) as Record<string, unknown>;\n      redactConfigForDisplay(plain);\n\n      if (rest) {\n        const parsed = parseConfigPath(rest);\n        if (!parsed.ok || !parsed.path) {\n          return { content: `⚠️ ${parsed.error ?? 'Invalid path.'}`, success: false };\n        }\n        const value = getConfigValueAtPath(plain, parsed.path);\n        const rendered = JSON.stringify(value ?? null, null, 2);\n        return { content: `⚙️ \\`${rest}\\`:\\n\\`\\`\\`json\\n${rendered}\\n\\`\\`\\`` };\n      }\n\n      const json = JSON.stringify(plain, null, 2);\n      return { content: `⚙️ Current config:\\n\\`\\`\\`json\\n${json}\\n\\`\\`\\`` };\n    }\n\n    if (action === 'set') {\n      if (!senderMayWritePersistentConfig(ctx)) {\n        return {\n          content: '⚠️ You are not allowed to change config from this chat surface.',\n          success: false,\n        };\n      }\n      const eqIndex = rest.indexOf('=');\n      if (eqIndex <= 0) {\n        return { content: '⚠️ Usage: /config set path=value', success: false };\n      }\n      const pathRaw = rest.slice(0, eqIndex).trim();\n      const valueRaw = rest.slice(eqIndex + 1);\n\n      const parsedPath = parseConfigPath(pathRaw);\n      if (!parsedPath.ok || !parsedPath.path) {\n        return { content: `⚠️ ${parsedPath.error}`, success: false };\n      }\n      if (isBlockedPath(parsedPath.path)) {\n        return {\n          content: `⚠️ Path \\`${pathRaw}\\` cannot be modified via chat for security reasons.`,\n          success: false,\n        };\n      }\n\n      const parsedValue = parseConfigValue(valueRaw);\n      if (parsedValue.ok === false) {\n        return { content: `⚠️ ${parsedValue.error}`, success: false };\n      }\n\n      const configPath = resolveConfigPath();\n      const currentConfig = loadConfig(configPath) as Record<string, unknown>;\n      setConfigValueAtPath(currentConfig, parsedPath.path, parsedValue.value);\n\n      const validated = ConfigSchema.safeParse(currentConfig);\n      if (!validated.success) {\n        const firstIssue = validated.error.issues[0];\n        const fieldPath = firstIssue.path.join('.');\n        return {\n          content: `⚠️ Config invalid after set (${fieldPath}: ${firstIssue.message}). Change not saved.`,\n          success: false,\n        };\n      }\n\n      await saveConfig(validated.data);\n      log.info({ path: pathRaw, value: parsedValue.value }, 'Config updated via /config set');\n\n      const valueLabel =\n        typeof parsedValue.value === 'string'\n          ? `\"${parsedValue.value}\"`\n          : JSON.stringify(parsedValue.value);\n      return { content: `⚙️ Config updated: \\`${pathRaw}\\` = ${valueLabel}` };\n    }\n\n    if (action === 'unset') {\n      if (!senderMayWritePersistentConfig(ctx)) {\n        return {\n          content: '⚠️ You are not allowed to change config from this chat surface.',\n          success: false,\n        };\n      }\n      if (!rest) {\n        return { content: '⚠️ Usage: /config unset path', success: false };\n      }\n      const parsedPath = parseConfigPath(rest);\n      if (!parsedPath.ok || !parsedPath.path) {\n        return { content: `⚠️ ${parsedPath.error}`, success: false };\n      }\n      if (isBlockedPath(parsedPath.path)) {\n        return {\n          content: `⚠️ Path \\`${rest}\\` cannot be modified via chat for security reasons.`,\n          success: false,\n        };\n      }\n\n      const configPath = resolveConfigPath();\n      const currentConfig = loadConfig(configPath) as Record<string, unknown>;\n      const removed = unsetConfigValueAtPath(currentConfig, parsedPath.path);\n      if (!removed) {\n        return { content: `⚙️ No config value found at \\`${rest}\\`.`, success: false };\n      }\n\n      const validated = ConfigSchema.safeParse(currentConfig);\n      if (!validated.success) {\n        const firstIssue = validated.error.issues[0];\n        const fieldPath = firstIssue.path.join('.');\n        return {\n          content: `⚠️ Config invalid after unset (${fieldPath}: ${firstIssue.message}). Change not saved.`,\n          success: false,\n        };\n      }\n\n      await saveConfig(validated.data);\n      log.info({ path: rest }, 'Config key removed via /config unset');\n      return { content: `⚙️ Config updated: \\`${rest}\\` removed.` };\n    }\n\n    return {\n      content:\n        '⚙️ *Config Command*\\n\\n' +\n        '`/config show [path]` — view config (or a specific path)\\n' +\n        '`/config set path=value` — update a config value\\n' +\n        '`/config unset path` — remove a config key\\n\\n' +\n        'Examples:\\n' +\n        '`/config show agents.defaults.model`\\n' +\n        '`/config set agents.defaults.temperature=0.5`\\n' +\n        '`/config set agents.defaults.thinkingDefault=medium`\\n' +\n        '`/config unset tts`',\n    };\n  },\n};\n\nexport function registerConfigCommand(): void {\n  commandRegistry.register(configCommand);\n}\n"],"mappings":"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"}

package/dist/src/chat-commands/builtins/context.d.ts

@@ -0,0 +1,4 @@
+/**
+ * /context — inspect approximate prompt/context budget (config + transcript stats).
+ */
+export declare function registerContextCommands(): void;

package/dist/src/chat-commands/builtins/context.js

@@ -0,0 +1,44 @@
+import { commandRegistry } from "../registry.js";
+//#region src/chat-commands/builtins/context.ts
+function parseMode(args) {
+	const w = args.trim().split(/\s+/)[0]?.toLowerCase();
+	if (w === "detail" || w === "json" || w === "list") return w;
+	return "list";
+}
+const contextCommand = {
+	id: "session.context",
+	name: "context",
+	description: "Show context budget and config snapshot (list | detail | json)",
+	category: "session",
+	scope: [
+		"global",
+		"private",
+		"group"
+	],
+	acceptsArgs: true,
+	examples: [
+		"/context",
+		"/context detail",
+		"/context json"
+	],
+	handler: async (ctx, args) => {
+		await ctx.setTyping(true);
+		const mode = parseMode(args);
+		const text = await ctx.agentContextReport?.(mode);
+		if (text === void 0) return {
+			content: "⚠️ Context report is not available here.",
+			success: false
+		};
+		return {
+			content: text,
+			success: true
+		};
+	}
+};
+function registerContextCommands() {
+	commandRegistry.register(contextCommand);
+}
+//#endregion
+export { registerContextCommands };
+
+//# sourceMappingURL=context.js.map

package/dist/src/chat-commands/builtins/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../../src/chat-commands/builtins/context.ts"],"sourcesContent":["/**\n * /context — inspect approximate prompt/context budget (config + transcript stats).\n */\n\nimport type { CommandDefinition, CommandContext } from '../types.js';\nimport { commandRegistry } from '../registry.js';\n\nfunction parseMode(args: string): 'list' | 'detail' | 'json' {\n  const w = args.trim().split(/\\s+/)[0]?.toLowerCase();\n  if (w === 'detail' || w === 'json' || w === 'list') return w;\n  return 'list';\n}\n\nconst contextCommand: CommandDefinition = {\n  id: 'session.context',\n  name: 'context',\n  description: 'Show context budget and config snapshot (list | detail | json)',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/context', '/context detail', '/context json'],\n  handler: async (ctx: CommandContext, args: string) => {\n    await ctx.setTyping(true);\n    const mode = parseMode(args);\n    const text = await ctx.agentContextReport?.(mode);\n    if (text === undefined) {\n      return { content: '⚠️ Context report is not available here.', success: false };\n    }\n    return { content: text, success: true };\n  },\n};\n\nexport function registerContextCommands(): void {\n  commandRegistry.register(contextCommand);\n}\n"],"mappings":";;AAOA,SAAS,UAAU,MAA0C;CAC3D,MAAM,IAAI,KAAK,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,aAAa;AACpD,KAAI,MAAM,YAAY,MAAM,UAAU,MAAM,OAAQ,QAAO;AAC3D,QAAO;;AAGT,MAAM,iBAAoC;CACxC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,aAAa;CACb,UAAU;EAAC;EAAY;EAAmB;EAAgB;CAC1D,SAAS,OAAO,KAAqB,SAAiB;AACpD,QAAM,IAAI,UAAU,KAAK;EACzB,MAAM,OAAO,UAAU,KAAK;EAC5B,MAAM,OAAO,MAAM,IAAI,qBAAqB,KAAK;AACjD,MAAI,SAAS,KAAA,EACX,QAAO;GAAE,SAAS;GAA4C,SAAS;GAAO;AAEhF,SAAO;GAAE,SAAS;GAAM,SAAS;GAAM;;CAE1C;AAED,SAAgB,0BAAgC;AAC9C,iBAAgB,SAAS,eAAe"}

package/dist/src/chat-commands/builtins/session.js

@@ -107,6 +107,114 @@ const abortCommand = {
 		};
 	}
 };
+const compactCommand = {
+	id: "session.compact",
+	name: "compact",
+	description: "Compact session history (LLM summary + keep recent turns) to save context",
+	category: "session",
+	scope: [
+		"global",
+		"private",
+		"group"
+	],
+	acceptsArgs: true,
+	examples: ["/compact", "/compact focus on API design"],
+	handler: async (ctx, args) => {
+		await ctx.setTyping(true);
+		const instructions = args.trim() || void 0;
+		const result = await ctx.compactSession?.({
+			instructions,
+			force: true
+		});
+		if (result === null || result === void 0) return {
+			content: "⚠️ Session compaction is not available in this environment.",
+			success: false
+		};
+		if (!result.compacted) return {
+			content: "ℹ️ Nothing to compact yet. Need at least two messages, or the session is already small.\nTip: add optional focus text, e.g. `/compact emphasize decisions about auth`.",
+			success: true
+		};
+		const preview = result.summary && result.summary.length > 600 ? `${result.summary.slice(0, 600)}…` : result.summary || "";
+		return {
+			content: `🗜️ *Session compacted*\n\nTokens (approx): ${result.tokensBefore} → ${result.tokensAfter}\n\n` + (preview ? `*Summary:*\n${preview}` : ""),
+			success: true
+		};
+	}
+};
+const btwCommand = {
+	id: "session.btw",
+	name: "btw",
+	aliases: ["aside"],
+	description: "Ask a side question without adding to the session transcript",
+	category: "session",
+	scope: [
+		"global",
+		"private",
+		"group"
+	],
+	acceptsArgs: true,
+	examples: ["/btw What does that error code mean?", "/aside Summarize the last topic in one line"],
+	handler: async (ctx, args) => {
+		await ctx.setTyping(true);
+		const q = args.trim();
+		if (!q) return {
+			content: "💬 *Side question*\n\nUsage: `/btw <question>`\nAnswers use your current chat as background only; the reply is not saved to the session.",
+			success: true
+		};
+		const out = await ctx.btwQuery?.(q);
+		if (!out) return {
+			content: "⚠️ /btw is not available here.",
+			success: false
+		};
+		if (out.error) return {
+			content: `⚠️ ${out.error}`,
+			success: false
+		};
+		return {
+			content: `💬 *BTW*\n\n${out.text}`,
+			success: true
+		};
+	}
+};
+const exportSessionCommand = {
+	id: "session.export",
+	name: "export-session",
+	aliases: ["export"],
+	description: "Export this session to workspace exports/ (markdown, html, or json)",
+	category: "session",
+	scope: [
+		"global",
+		"private",
+		"group"
+	],
+	acceptsArgs: true,
+	examples: [
+		"/export-session",
+		"/export-session html",
+		"/export json"
+	],
+	handler: async (ctx, args) => {
+		await ctx.setTyping(true);
+		const raw = args.trim().toLowerCase();
+		const fmt = raw === "json" || raw === "html" || raw === "markdown" ? raw : "markdown";
+		if (!ctx.exportSessionToWorkspace) return {
+			content: "⚠️ Export is not available in this environment.",
+			success: false
+		};
+		try {
+			const { path } = await ctx.exportSessionToWorkspace(fmt);
+			return {
+				content: `📄 Exported (${fmt}) to:\n\`${path}\``,
+				success: true
+			};
+		} catch (e) {
+			return {
+				content: `⚠️ Export failed: ${e instanceof Error ? e.message : String(e)}`,
+				success: false
+			};
+		}
+	}
+};
 const archiveCommand = {
 	id: "session.archive",
 	name: "archive",
@@ -131,6 +239,9 @@ function registerSessionCommands() {
 	commandRegistry.register(listCommand);
 	commandRegistry.register(clearCommand);
 	commandRegistry.register(abortCommand);
+	commandRegistry.register(compactCommand);
+	commandRegistry.register(btwCommand);
+	commandRegistry.register(exportSessionCommand);
 	commandRegistry.register(archiveCommand);
 }
 //#endregion

package/dist/src/chat-commands/builtins/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","names":[],"sources":["../../../../src/chat-commands/builtins/session.ts"],"sourcesContent":["/**\n * Session Commands\n * \n * Built-in commands for session management:\n * - /new - Start a new session\n * - /list - List all sessions\n * - /switch - Switch to a different session\n * - /clear - Clear current session without archiving\n * - /abort - Cancel in-flight assistant reply (generation / streaming)\n */\n\nimport type { CommandDefinition, CommandContext, UIComponent } from '../types.js';\nimport { commandRegistry } from '../registry.js';\nimport { getSessionDisplayName } from '../session-key.js';\n\nconst newCommand: CommandDefinition = {\n  id: 'session.new',\n  name: 'new',\n  aliases: ['reset', 'restart'],\n  description: 'Start a new session (archive current)',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n    \n    await ctx.clearSession();\n    \n    // Note: clearSession already sends confirmation message\n    return {\n      content: '',\n      success: true,\n    };\n  },\n};\n\nconst listCommand: CommandDefinition = {\n  id: 'session.list',\n  name: 'list',\n  aliases: ['sessions'],\n  description: 'List all your sessions',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n    \n    const sessions = await ctx.listSessions();\n    \n    if (sessions.length === 0) {\n      return {\n        content: '📋 No sessions found.',\n        success: true,\n      };\n    }\n    \n    // Sort by updatedAt desc\n    sessions.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());\n    \n    // Build text response\n    const lines = sessions.slice(0, 10).map(s => {\n      const indicator = s.isActive ? '▶️' : '  ';\n      const name = getSessionDisplayName(s.key);\n      const date = s.updatedAt.toLocaleDateString();\n      return `${indicator} ${name}\\n   ${s.messageCount} messages · ${date}`;\n    });\n    \n    const content = '📋 Your Sessions:\\n\\n' + lines.join('\\n\\n');\n    \n    // Create UI component if supported\n    if (ctx.supports('buttons')) {\n      const component: UIComponent = {\n        type: 'session-list',\n        sessions: sessions.slice(0, 5).map(s => ({\n          ...s,\n          name: getSessionDisplayName(s.key),\n        })),\n        currentSession: ctx.sessionKey,\n      };\n      \n      return {\n        content,\n        success: true,\n        components: [component],\n      };\n    }\n    \n    return {\n      content,\n      success: true,\n    };\n  },\n};\n\nconst clearCommand: CommandDefinition = {\n  id: 'session.clear',\n  name: 'clear',\n  description: 'Clear current session without archiving',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n    \n    // Just delete without archiving\n    const messages = await ctx.getSession();\n    await ctx.clearSession();\n    \n    return {\n      content: `🗑️ Session cleared. ${messages.length} messages deleted.`,\n      success: true,\n    };\n  },\n};\n\nconst abortCommand: CommandDefinition = {\n  id: 'session.abort',\n  name: 'abort',\n  aliases: ['stop', 'cancel'],\n  description: 'Stop the current assistant reply (in-flight generation or stream)',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    if (!ctx.abortCurrentTurn) {\n      return {\n        content: 'Abort is not available in this environment.',\n        success: false,\n      };\n    }\n    await ctx.abortCurrentTurn();\n    return {\n      content: '⏹️ Current reply cancelled.',\n      success: true,\n    };\n  },\n};\n\nconst archiveCommand: CommandDefinition = {\n  id: 'session.archive',\n  name: 'archive',\n  description: 'Archive current session',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n    \n    await ctx.archiveSession();\n    \n    return {\n      content: '📦 Current session has been archived.',\n      success: true,\n    };\n  },\n};\n\n// Register all session commands\nexport function registerSessionCommands(): void {\n  commandRegistry.register(newCommand);\n  commandRegistry.register(listCommand);\n  commandRegistry.register(clearCommand);\n  commandRegistry.register(abortCommand);\n  commandRegistry.register(archiveCommand);\n}\n"],"mappings":";;;AAeA,MAAM,aAAgC;CACpC,IAAI;CACJ,MAAM;CACN,SAAS,CAAC,SAAS,UAAU;CAC7B,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,SAAS,OAAO,QAAwB;AACtC,QAAM,IAAI,UAAU,KAAK;AAEzB,QAAM,IAAI,cAAc;AAGxB,SAAO;GACL,SAAS;GACT,SAAS;GACV;;CAEJ;AAED,MAAM,cAAiC;CACrC,IAAI;CACJ,MAAM;CACN,SAAS,CAAC,WAAW;CACrB,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,SAAS,OAAO,QAAwB;AACtC,QAAM,IAAI,UAAU,KAAK;EAEzB,MAAM,WAAW,MAAM,IAAI,cAAc;AAEzC,MAAI,SAAS,WAAW,EACtB,QAAO;GACL,SAAS;GACT,SAAS;GACV;AAIH,WAAS,MAAM,GAAG,MAAM,EAAE,UAAU,SAAS,GAAG,EAAE,UAAU,SAAS,CAAC;EAUtE,MAAM,UAAU,0BAPF,SAAS,MAAM,GAAG,GAAG,CAAC,KAAI,MAAK;GAC3C,MAAM,YAAY,EAAE,WAAW,OAAO;GACtC,MAAM,OAAO,sBAAsB,EAAE,IAAI;GACzC,MAAM,OAAO,EAAE,UAAU,oBAAoB;AAC7C,UAAO,GAAG,UAAU,GAAG,KAAK,OAAO,EAAE,aAAa,cAAc;IAChE,CAE8C,KAAK,OAAO;AAG5D,MAAI,IAAI,SAAS,UAAU,CAUzB,QAAO;GACL;GACA,SAAS;GACT,YAAY,CAZiB;IAC7B,MAAM;IACN,UAAU,SAAS,MAAM,GAAG,EAAE,CAAC,KAAI,OAAM;KACvC,GAAG;KACH,MAAM,sBAAsB,EAAE,IAAI;KACnC,EAAE;IACH,gBAAgB,IAAI;IACrB,CAKwB;GACxB;AAGH,SAAO;GACL;GACA,SAAS;GACV;;CAEJ;AAED,MAAM,eAAkC;CACtC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,SAAS,OAAO,QAAwB;AACtC,QAAM,IAAI,UAAU,KAAK;EAGzB,MAAM,WAAW,MAAM,IAAI,YAAY;AACvC,QAAM,IAAI,cAAc;AAExB,SAAO;GACL,SAAS,wBAAwB,SAAS,OAAO;GACjD,SAAS;GACV;;CAEJ;AAED,MAAM,eAAkC;CACtC,IAAI;CACJ,MAAM;CACN,SAAS,CAAC,QAAQ,SAAS;CAC3B,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,SAAS,OAAO,QAAwB;AACtC,MAAI,CAAC,IAAI,iBACP,QAAO;GACL,SAAS;GACT,SAAS;GACV;AAEH,QAAM,IAAI,kBAAkB;AAC5B,SAAO;GACL,SAAS;GACT,SAAS;GACV;;CAEJ;AAED,MAAM,iBAAoC;CACxC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAU;CACV,OAAO;EAAC;EAAU;EAAW;EAAQ;CACrC,SAAS,OAAO,QAAwB;AACtC,QAAM,IAAI,UAAU,KAAK;AAEzB,QAAM,IAAI,gBAAgB;AAE1B,SAAO;GACL,SAAS;GACT,SAAS;GACV;;CAEJ;AAGD,SAAgB,0BAAgC;AAC9C,iBAAgB,SAAS,WAAW;AACpC,iBAAgB,SAAS,YAAY;AACrC,iBAAgB,SAAS,aAAa;AACtC,iBAAgB,SAAS,aAAa;AACtC,iBAAgB,SAAS,eAAe"}
+{"version":3,"file":"session.js","names":[],"sources":["../../../../src/chat-commands/builtins/session.ts"],"sourcesContent":["/**\n * Session Commands\n * \n * Built-in commands for session management:\n * - /new - Start a new session\n * - /list - List all sessions\n * - /switch - Switch to a different session\n * - /clear - Clear current session without archiving\n * - /abort - Cancel in-flight assistant reply (generation / streaming)\n */\n\nimport type { CommandDefinition, CommandContext, UIComponent } from '../types.js';\nimport { commandRegistry } from '../registry.js';\nimport { getSessionDisplayName } from '../session-key.js';\n\nconst newCommand: CommandDefinition = {\n  id: 'session.new',\n  name: 'new',\n  aliases: ['reset', 'restart'],\n  description: 'Start a new session (archive current)',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n    \n    await ctx.clearSession();\n    \n    // Note: clearSession already sends confirmation message\n    return {\n      content: '',\n      success: true,\n    };\n  },\n};\n\nconst listCommand: CommandDefinition = {\n  id: 'session.list',\n  name: 'list',\n  aliases: ['sessions'],\n  description: 'List all your sessions',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n    \n    const sessions = await ctx.listSessions();\n    \n    if (sessions.length === 0) {\n      return {\n        content: '📋 No sessions found.',\n        success: true,\n      };\n    }\n    \n    // Sort by updatedAt desc\n    sessions.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());\n    \n    // Build text response\n    const lines = sessions.slice(0, 10).map(s => {\n      const indicator = s.isActive ? '▶️' : '  ';\n      const name = getSessionDisplayName(s.key);\n      const date = s.updatedAt.toLocaleDateString();\n      return `${indicator} ${name}\\n   ${s.messageCount} messages · ${date}`;\n    });\n    \n    const content = '📋 Your Sessions:\\n\\n' + lines.join('\\n\\n');\n    \n    // Create UI component if supported\n    if (ctx.supports('buttons')) {\n      const component: UIComponent = {\n        type: 'session-list',\n        sessions: sessions.slice(0, 5).map(s => ({\n          ...s,\n          name: getSessionDisplayName(s.key),\n        })),\n        currentSession: ctx.sessionKey,\n      };\n      \n      return {\n        content,\n        success: true,\n        components: [component],\n      };\n    }\n    \n    return {\n      content,\n      success: true,\n    };\n  },\n};\n\nconst clearCommand: CommandDefinition = {\n  id: 'session.clear',\n  name: 'clear',\n  description: 'Clear current session without archiving',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n    \n    // Just delete without archiving\n    const messages = await ctx.getSession();\n    await ctx.clearSession();\n    \n    return {\n      content: `🗑️ Session cleared. ${messages.length} messages deleted.`,\n      success: true,\n    };\n  },\n};\n\nconst abortCommand: CommandDefinition = {\n  id: 'session.abort',\n  name: 'abort',\n  aliases: ['stop', 'cancel'],\n  description: 'Stop the current assistant reply (in-flight generation or stream)',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    if (!ctx.abortCurrentTurn) {\n      return {\n        content: 'Abort is not available in this environment.',\n        success: false,\n      };\n    }\n    await ctx.abortCurrentTurn();\n    return {\n      content: '⏹️ Current reply cancelled.',\n      success: true,\n    };\n  },\n};\n\nconst compactCommand: CommandDefinition = {\n  id: 'session.compact',\n  name: 'compact',\n  description: 'Compact session history (LLM summary + keep recent turns) to save context',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/compact', '/compact focus on API design'],\n  handler: async (ctx: CommandContext, args: string) => {\n    await ctx.setTyping(true);\n    const instructions = args.trim() || undefined;\n    const result = await ctx.compactSession?.({ instructions, force: true });\n    if (result === null || result === undefined) {\n      return {\n        content: '⚠️ Session compaction is not available in this environment.',\n        success: false,\n      };\n    }\n    if (!result.compacted) {\n      return {\n        content:\n          'ℹ️ Nothing to compact yet. Need at least two messages, or the session is already small.\\n' +\n          'Tip: add optional focus text, e.g. `/compact emphasize decisions about auth`.',\n        success: true,\n      };\n    }\n    const preview =\n      result.summary && result.summary.length > 600\n        ? `${result.summary.slice(0, 600)}…`\n        : result.summary || '';\n    return {\n      content:\n        `🗜️ *Session compacted*\\n\\n` +\n        `Tokens (approx): ${result.tokensBefore} → ${result.tokensAfter}\\n\\n` +\n        (preview ? `*Summary:*\\n${preview}` : ''),\n      success: true,\n    };\n  },\n};\n\nconst btwCommand: CommandDefinition = {\n  id: 'session.btw',\n  name: 'btw',\n  aliases: ['aside'],\n  description: 'Ask a side question without adding to the session transcript',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/btw What does that error code mean?', '/aside Summarize the last topic in one line'],\n  handler: async (ctx: CommandContext, args: string) => {\n    await ctx.setTyping(true);\n    const q = args.trim();\n    if (!q) {\n      return {\n        content:\n          '💬 *Side question*\\n\\n' +\n          'Usage: `/btw <question>`\\n' +\n          'Answers use your current chat as background only; the reply is not saved to the session.',\n        success: true,\n      };\n    }\n    const out = await ctx.btwQuery?.(q);\n    if (!out) {\n      return { content: '⚠️ /btw is not available here.', success: false };\n    }\n    if (out.error) {\n      return { content: `⚠️ ${out.error}`, success: false };\n    }\n    return { content: `💬 *BTW*\\n\\n${out.text}`, success: true };\n  },\n};\n\nconst exportSessionCommand: CommandDefinition = {\n  id: 'session.export',\n  name: 'export-session',\n  aliases: ['export'],\n  description: 'Export this session to workspace exports/ (markdown, html, or json)',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/export-session', '/export-session html', '/export json'],\n  handler: async (ctx: CommandContext, args: string) => {\n    await ctx.setTyping(true);\n    const raw = args.trim().toLowerCase();\n    const fmt =\n      raw === 'json' || raw === 'html' || raw === 'markdown'\n        ? (raw as 'json' | 'html' | 'markdown')\n        : 'markdown';\n    if (!ctx.exportSessionToWorkspace) {\n      return { content: '⚠️ Export is not available in this environment.', success: false };\n    }\n    try {\n      const { path } = await ctx.exportSessionToWorkspace(fmt);\n      return {\n        content: `📄 Exported (${fmt}) to:\\n\\`${path}\\``,\n        success: true,\n      };\n    } catch (e) {\n      const em = e instanceof Error ? e.message : String(e);\n      return { content: `⚠️ Export failed: ${em}`, success: false };\n    }\n  },\n};\n\nconst archiveCommand: CommandDefinition = {\n  id: 'session.archive',\n  name: 'archive',\n  description: 'Archive current session',\n  category: 'session',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n    \n    await ctx.archiveSession();\n    \n    return {\n      content: '📦 Current session has been archived.',\n      success: true,\n    };\n  },\n};\n\n// Register all session commands\nexport function registerSessionCommands(): void {\n  commandRegistry.register(newCommand);\n  commandRegistry.register(listCommand);\n  commandRegistry.register(clearCommand);\n  commandRegistry.register(abortCommand);\n  commandRegistry.register(compactCommand);\n  commandRegistry.register(btwCommand);\n  commandRegistry.register(exportSessionCommand);\n  commandRegistry.register(archiveCommand);\n}\n"],"mappings":"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"}

package/dist/src/chat-commands/builtins/thinking.js

@@ -1,6 +1,19 @@
+import { applyConfigOverrides, setConfigOverride } from "../../config/runtime-overrides.js";
 import { formatThinkingLevels, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel } from "../../agent/transcript/thinking-types.js";
 import { commandRegistry } from "../registry.js";
 //#region src/chat-commands/builtins/thinking.ts
+function effectiveAgentDefaults(ctx) {
+	return applyConfigOverrides(ctx.getConfig?.() ?? ctx.config).agents?.defaults;
+}
+async function stripSessionAgentFields(store, sessionKey, fields) {
+	if (!store) return;
+	const existing = await store.get(sessionKey);
+	if (!existing) return;
+	const next = { ...existing };
+	for (const f of fields) delete next[f];
+	if (Object.keys(next).filter((k) => k !== "updatedAt").length === 0) await store.delete(sessionKey);
+	else await store.set(sessionKey, next);
+}
 const thinkCommand = {
 	id: "agent.think",
 	name: "think",
@@ -20,9 +33,8 @@ const thinkCommand = {
 	],
 	handler: async (ctx, args) => {
 		await ctx.setTyping(true);
-		const extendedCtx = ctx;
 		if (!args.trim()) return {
-			content: `🧠 *Thinking Level*\n\nCurrent: *${await extendedCtx.getThinkingLevel?.() || ctx.getConfig()?.agents?.defaults?.thinkingDefault || "default"}*\n\nAvailable levels:\n• off - No thinking\n• minimal - Minimal thinking\n• low - Low thinking\n• medium - Medium thinking (default)\n• high - High thinking\n• xhigh - Extra high (certain models)\n• adaptive - Auto-adjust based on task\n\nUsage: /think <level>\nExample: /think high`,
+			content: `🧠 *Thinking Level*\n\nCurrent: *${(await ctx.getThinkingLevel?.() ?? effectiveAgentDefaults(ctx)?.thinkingDefault) || "default"}*\n\nAvailable levels:\n• off - No thinking\n• minimal - Minimal thinking\n• low - Low thinking\n• medium - Medium thinking (default)\n• high - High thinking\n• xhigh - Extra high (certain models)\n• adaptive - Auto-adjust based on task\n\nUsage: /think <level>\nExample: /think high`,
 			success: true
 		};
 		const level = normalizeThinkLevel(args.trim());
@@ -30,7 +42,13 @@ const thinkCommand = {
 			content: `❌ Invalid thinking level: ${args}\n\nAvailable levels: ${formatThinkingLevels()}\n\nUsage: /think <level>\nExample: /think high`,
 			success: false
 		};
-		if (ctx.setThinkingLevel) await ctx.setThinkingLevel(level);
+		setConfigOverride([
+			"agents",
+			"defaults",
+			"thinkingDefault"
+		], level);
+		await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ["thinkingLevel"]);
+		ctx.syncAgentThinkingLevel?.(level);
 		return {
 			content: `🧠 *Thinking Level Set*\n\nLevel: *${level}*\n${{
 				off: "No thinking",
@@ -40,7 +58,7 @@ const thinkCommand = {
 				high: "High thinking effort",
 				xhigh: "Extra high thinking effort",
 				adaptive: "Auto-adjust based on task complexity"
-			}[level]}\n\nThis setting will apply to your next message.`,
+			}[level]}\n\nApplies for this gateway process (until restart). Persists only if you use /config set.`,
 			success: true
 		};
 	}
@@ -64,10 +82,8 @@ const reasoningCommand = {
 	],
 	handler: async (ctx, args) => {
 		await ctx.setTyping(true);
-		const extendedCtx = ctx;
-		const configStore = extendedCtx.getSessionConfigStore?.();
 		if (!args.trim()) return {
-			content: `💭 *Reasoning Visibility*\n\nCurrent: *${await extendedCtx.getReasoningLevel?.() || ctx.getConfig()?.agents?.defaults?.reasoningDefault || "default"}*\n\nAvailable modes:\n• off - Hide reasoning\n• on - Show reasoning after completion\n• stream - Stream reasoning in real-time\n\nUsage: /reasoning <mode>\nExample: /reasoning stream`,
+			content: `💭 *Reasoning Visibility*\n\nCurrent: *${(await ctx.getReasoningLevel?.() ?? effectiveAgentDefaults(ctx)?.reasoningDefault) || "default"}*\n\nAvailable modes:\n• off - Hide reasoning\n• on - Show reasoning after completion\n• stream - Stream reasoning in real-time\n\nUsage: /reasoning <mode>\nExample: /reasoning stream`,
 			success: true
 		};
 		const level = normalizeReasoningLevel(args.trim());
@@ -75,13 +91,18 @@ const reasoningCommand = {
 			content: `❌ Invalid reasoning mode: ${args}\n\nAvailable modes: off, on, stream\n\nUsage: /reasoning <mode>\nExample: /reasoning stream`,
 			success: false
 		};
-		if (configStore) await configStore.update(ctx.sessionKey, { reasoningLevel: level });
+		setConfigOverride([
+			"agents",
+			"defaults",
+			"reasoningDefault"
+		], level);
+		await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ["reasoningLevel"]);
 		return {
 			content: `💭 *Reasoning Visibility Set*\n\nMode: *${level}*\n${{
 				off: "Hide reasoning from user",
 				on: "Show reasoning after completion",
 				stream: "Stream reasoning in real-time"
-			}[level]}\n\nThis setting will apply to your next message.`,
+			}[level]}\n\nApplies for this gateway process (until restart). Persists only if you use /config set.`,
 			success: true
 		};
 	}
@@ -105,13 +126,16 @@ const verboseCommand = {
 	],
 	handler: async (ctx, args) => {
 		await ctx.setTyping(true);
-		const extendedCtx = ctx;
-		const configStore = extendedCtx.getSessionConfigStore?.();
 		if (!args.trim()) {
-			const newLevel = (await extendedCtx.getVerboseLevel?.() || ctx.getConfig()?.agents?.defaults?.verboseDefault) === "on" ? "off" : "on";
-			if (configStore) await configStore.update(ctx.sessionKey, { verboseLevel: newLevel });
+			const newLevel = (await ctx.getVerboseLevel?.() ?? effectiveAgentDefaults(ctx)?.verboseDefault) === "on" ? "off" : "on";
+			setConfigOverride([
+				"agents",
+				"defaults",
+				"verboseDefault"
+			], newLevel);
+			await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ["verboseLevel"]);
 			return {
-				content: `📝 *Verbose Mode*\n\nMode: *${newLevel}*\n\n${newLevel === "on" ? "Verbose output enabled for next message." : "Verbose output disabled."}`,
+				content: `📝 *Verbose Mode*\n\nMode: *${newLevel}*\n\n${newLevel === "on" ? "Verbose output enabled (process lifetime)." : "Verbose output disabled (process lifetime)."}`,
 				success: true
 			};
 		}
@@ -120,13 +144,18 @@ const verboseCommand = {
 			content: `❌ Invalid verbose mode: ${args}\n\nAvailable modes: off, on, full\n\nUsage: /verbose [mode]\nExample: /verbose on`,
 			success: false
 		};
-		if (configStore) await configStore.update(ctx.sessionKey, { verboseLevel: level });
+		setConfigOverride([
+			"agents",
+			"defaults",
+			"verboseDefault"
+		], level);
+		await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ["verboseLevel"]);
 		return {
 			content: `📝 *Verbose Mode Set*\n\nMode: *${level}*\n${{
 				off: "Minimal output",
 				on: "Normal verbose output",
 				full: "Full verbose output with all details"
-			}[level]}`,
+			}[level]}\n\nApplies for this gateway process (until restart). Persists only if you use /config set.`,
 			success: true
 		};
 	}
@@ -143,12 +172,11 @@ const enhancedStatusCommand = {
 	],
 	handler: async (ctx) => {
 		await ctx.setTyping(true);
-		const extendedCtx = ctx;
-		const config = ctx.getConfig();
+		const defaults = effectiveAgentDefaults(ctx);
 		const currentModel = ctx.getCurrentModel();
-		const thinkingLevel = await extendedCtx.getThinkingLevel?.() || config.agents?.defaults?.thinkingDefault;
-		const reasoningLevel = await extendedCtx.getReasoningLevel?.() || config.agents?.defaults?.reasoningDefault;
-		const verboseLevel = await extendedCtx.getVerboseLevel?.() || config.agents?.defaults?.verboseDefault;
+		const thinkingLevel = await ctx.getThinkingLevel?.() ?? defaults?.thinkingDefault;
+		const reasoningLevel = await ctx.getReasoningLevel?.() ?? defaults?.reasoningDefault;
+		const verboseLevel = await ctx.getVerboseLevel?.() ?? defaults?.verboseDefault;
 		const usage = await ctx.getUsage();
 		return {
 			content: [