@xopcai/xopc 0.0.27 → 0.0.28

package/dist/src/channels/weixin/index.js

@@ -1,6 +1,6 @@
 import { normalizeWeixinCronDeliveryTo, normalizeWeixinCronDeliveryToResolved, resolveWeixinAccountIdFromSessions } from "../../../extensions/weixin/src/delivery-to.js";
-import { WeixinChannelPlugin, weixinPlugin } from "../../../extensions/weixin/src/plugin.js";
 import { runWeixinQrLoginCli } from "../../../extensions/weixin/src/cli/qr-login.js";
+import { WeixinChannelPlugin, weixinPlugin } from "../../../extensions/weixin/src/plugin.js";
 import { getWeixinGatewayQrLoginStatus, startWeixinGatewayQrLogin } from "../../../extensions/weixin/src/cli/gateway-qr-login.js";
 import "../../../extensions/weixin/src/index.js";
 export { WeixinChannelPlugin, getWeixinGatewayQrLoginStatus, normalizeWeixinCronDeliveryTo, normalizeWeixinCronDeliveryToResolved, resolveWeixinAccountIdFromSessions, runWeixinQrLoginCli, startWeixinGatewayQrLogin, weixinPlugin };

package/dist/src/cli/agent-chat-log-level-preset.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Quieter defaults for `xopc agent -m` / `agent -i`: use `warn` when no log level
+ * env is set, so `info` chatter stays off the console in dev.
+ * This module must load before `../utils/logger.js` (imported from `cli/index.ts`).
+ */
+declare function argvHasAgentMessageOrInteractive(argv: string[]): boolean;
+declare const env: NodeJS.ProcessEnv;

package/dist/src/cli/agent-chat-log-level-preset.js

@@ -0,0 +1,22 @@
+//#region src/cli/agent-chat-log-level-preset.ts
+/**
+* Quieter defaults for `xopc agent -m` / `agent -i`: use `warn` when no log level
+* env is set, so `info` chatter stays off the console in dev.
+* This module must load before `../utils/logger.js` (imported from `cli/index.ts`).
+*/
+function argvHasAgentMessageOrInteractive(argv) {
+	const agentIndex = argv.findIndex((a) => a === "agent");
+	if (agentIndex < 0) return false;
+	for (let i = agentIndex + 1; i < argv.length; i++) {
+		const a = argv[i];
+		if (a === "-i" || a === "--interactive") return true;
+		if (a === "-m" || a === "--message") return true;
+	}
+	return false;
+}
+const env = process.env;
+if (!env.VITEST && !env.TEST && !env.XOPC_LOG_LEVEL && !env.LOG_LEVEL && !env.DEBUG && !process.argv.includes("--verbose") && !process.argv.includes("-v") && argvHasAgentMessageOrInteractive(process.argv)) env.XOPC_LOG_LEVEL = "warn";
+//#endregion
+export {};
+
+//# sourceMappingURL=agent-chat-log-level-preset.js.map

package/dist/src/cli/agent-chat-log-level-preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-chat-log-level-preset.js","names":[],"sources":["../../../src/cli/agent-chat-log-level-preset.ts"],"sourcesContent":["/**\n * Quieter defaults for `xopc agent -m` / `agent -i`: use `warn` when no log level\n * env is set, so `info` chatter stays off the console in dev.\n * This module must load before `../utils/logger.js` (imported from `cli/index.ts`).\n */\nfunction argvHasAgentMessageOrInteractive(argv: string[]): boolean {\n  const agentIndex = argv.findIndex((a) => a === 'agent');\n  if (agentIndex < 0) return false;\n  for (let i = agentIndex + 1; i < argv.length; i++) {\n    const a = argv[i];\n    if (a === '-i' || a === '--interactive') return true;\n    if (a === '-m' || a === '--message') return true;\n  }\n  return false;\n}\n\nconst env = process.env;\nif (\n  !env.VITEST &&\n  !env.TEST &&\n  !env.XOPC_LOG_LEVEL &&\n  !env.LOG_LEVEL &&\n  !env.DEBUG &&\n  !process.argv.includes('--verbose') &&\n  !process.argv.includes('-v') &&\n  argvHasAgentMessageOrInteractive(process.argv)\n) {\n  env.XOPC_LOG_LEVEL = 'warn';\n}\n"],"mappings":";;;;;;AAKA,SAAS,iCAAiC,MAAyB;CACjE,MAAM,aAAa,KAAK,WAAW,MAAM,MAAM,QAAQ;AACvD,KAAI,aAAa,EAAG,QAAO;AAC3B,MAAK,IAAI,IAAI,aAAa,GAAG,IAAI,KAAK,QAAQ,KAAK;EACjD,MAAM,IAAI,KAAK;AACf,MAAI,MAAM,QAAQ,MAAM,gBAAiB,QAAO;AAChD,MAAI,MAAM,QAAQ,MAAM,YAAa,QAAO;;AAE9C,QAAO;;AAGT,MAAM,MAAM,QAAQ;AACpB,IACE,CAAC,IAAI,UACL,CAAC,IAAI,QACL,CAAC,IAAI,kBACL,CAAC,IAAI,aACL,CAAC,IAAI,SACL,CAAC,QAAQ,KAAK,SAAS,YAAY,IACnC,CAAC,QAAQ,KAAK,SAAS,KAAK,IAC5B,iCAAiC,QAAQ,KAAK,CAE9C,KAAI,iBAAiB"}

package/dist/src/cli/commands/agent/interactive.js

@@ -1,5 +1,6 @@
 import { getSessionManager } from "../../utils/session.js";
 import { listSessions } from "./sessions.js";
+import { renderStreamToTerminal } from "./stream-renderer.js";
 //#region src/cli/commands/agent/interactive.ts
 /**
 * Start interactive chat mode
@@ -41,8 +42,9 @@ async function startInteractiveChat(agent, options) {
 			rl.close();
 			return;
 		}
-		const response = await agent.processDirect(input, sessionKey);
-		console.log("\n🤖:", response);
+		rl.pause();
+		await renderStreamToTerminal(agent, input, sessionKey);
+		rl.resume();
 		rl.prompt();
 	});
 	rl.on("close", async () => {

package/dist/src/cli/commands/agent/interactive.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.js","names":[],"sources":["../../../../../src/cli/commands/agent/interactive.ts"],"sourcesContent":["/**\n * Interactive chat mode for agent command\n */\n\nimport type { Interface as _Interface } from 'readline';\nimport type { AgentService } from '../../../agent/index.js';\nimport { getSessionManager } from '../../utils/session.js';\nimport { listSessions } from './sessions.js';\n\nexport interface InteractiveOptions {\n  workspace: string;\n  sessionKey: string;\n  continuingSession: boolean;\n}\n\n/**\n * Start interactive chat mode\n */\nexport async function startInteractiveChat(\n  agent: AgentService,\n  options: InteractiveOptions\n): Promise<void> {\n  const { sessionKey: initialSessionKey, continuingSession } = options;\n  \n  let sessionKey = initialSessionKey;\n\n  if (continuingSession) {\n    console.log('🧠 Interactive chat mode - Continuing session\\n');\n  } else {\n    console.log('🧠 Interactive chat mode (Ctrl+C to exit)\\n');\n  }\n\n  const readline = await import('readline');\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n    terminal: true,\n  });\n\n  rl.on('line', async (input) => {\n    const trimmed = input.trim();\n    \n    // Handle special commands\n    if (trimmed === ':sessions' || trimmed === ':list') {\n      rl.pause();\n      await listSessions();\n      rl.resume();\n      rl.prompt();\n      return;\n    }\n    \n    if (trimmed.startsWith(':session ')) {\n      const newSessionKey = trimmed.slice(9).trim();\n      const manager = await getSessionManager();\n      const session = await manager.getSessionMetadata(newSessionKey);\n      if (session) {\n        sessionKey = newSessionKey;\n        console.log(`🔄 Switched to session: ${sessionKey}\\n`);\n      } else {\n        console.log(`❌ Session not found: ${newSessionKey}\\n`);\n      }\n      rl.prompt();\n      return;\n    }\n\n    if (trimmed === ':help') {\n      printHelp();\n      rl.prompt();\n      return;\n    }\n\n    if (trimmed === ':quit' || trimmed === ':exit') {\n      rl.close();\n      return;\n    }\n\n    const response = await agent.processDirect(input, sessionKey);\n    console.log('\\n🤖:', response);\n    rl.prompt();\n  });\n\n  rl.on('close', async () => {\n    console.log('\\n👋 Goodbye!');\n    process.exit(0);\n  });\n\n  rl.setPrompt('You: ');\n  rl.prompt();\n}\n\nfunction printHelp(): void {\n  console.log(`\n📖 Available commands:\n  :sessions, :list    - List available sessions\n  :session <key>     - Switch to another session\n  :quit, :exit       - Exit interactive mode\n  :help              - Show this help\n`);\n}\n"],"mappings":";;;;;;AAkBA,eAAsB,qBACpB,OACA,SACe;CACf,MAAM,EAAE,YAAY,mBAAmB,sBAAsB;CAE7D,IAAI,aAAa;AAEjB,KAAI,kBACF,SAAQ,IAAI,kDAAkD;KAE9D,SAAQ,IAAI,8CAA8C;CAI5D,MAAM,MAAK,MADY,OAAO,aACV,gBAAgB;EAClC,OAAO,QAAQ;EACf,QAAQ,QAAQ;EAChB,UAAU;EACX,CAAC;AAEF,IAAG,GAAG,QAAQ,OAAO,UAAU;EAC7B,MAAM,UAAU,MAAM,MAAM;AAG5B,MAAI,YAAY,eAAe,YAAY,SAAS;AAClD,MAAG,OAAO;AACV,SAAM,cAAc;AACpB,MAAG,QAAQ;AACX,MAAG,QAAQ;AACX;;AAGF,MAAI,QAAQ,WAAW,YAAY,EAAE;GACnC,MAAM,gBAAgB,QAAQ,MAAM,EAAE,CAAC,MAAM;AAG7C,OAAI,OADkB,MADA,mBAAmB,EACX,mBAAmB,cAAc,EAClD;AACX,iBAAa;AACb,YAAQ,IAAI,2BAA2B,WAAW,IAAI;SAEtD,SAAQ,IAAI,wBAAwB,cAAc,IAAI;AAExD,MAAG,QAAQ;AACX;;AAGF,MAAI,YAAY,SAAS;AACvB,cAAW;AACX,MAAG,QAAQ;AACX;;AAGF,MAAI,YAAY,WAAW,YAAY,SAAS;AAC9C,MAAG,OAAO;AACV;;EAGF,MAAM,WAAW,MAAM,MAAM,cAAc,OAAO,WAAW;AAC7D,UAAQ,IAAI,SAAS,SAAS;AAC9B,KAAG,QAAQ;GACX;AAEF,IAAG,GAAG,SAAS,YAAY;AACzB,UAAQ,IAAI,gBAAgB;AAC5B,UAAQ,KAAK,EAAE;GACf;AAEF,IAAG,UAAU,QAAQ;AACrB,IAAG,QAAQ;;AAGb,SAAS,YAAkB;AACzB,SAAQ,IAAI;;;;;;EAMZ"}
+{"version":3,"file":"interactive.js","names":[],"sources":["../../../../../src/cli/commands/agent/interactive.ts"],"sourcesContent":["/**\n * Interactive chat mode for agent command\n */\n\nimport type { Interface as _Interface } from 'readline';\nimport type { AgentService } from '../../../agent/index.js';\nimport { getSessionManager } from '../../utils/session.js';\nimport { listSessions } from './sessions.js';\nimport { renderStreamToTerminal } from './stream-renderer.js';\n\nexport interface InteractiveOptions {\n  workspace: string;\n  sessionKey: string;\n  continuingSession: boolean;\n}\n\n/**\n * Start interactive chat mode\n */\nexport async function startInteractiveChat(\n  agent: AgentService,\n  options: InteractiveOptions\n): Promise<void> {\n  const { sessionKey: initialSessionKey, continuingSession } = options;\n  \n  let sessionKey = initialSessionKey;\n\n  if (continuingSession) {\n    console.log('🧠 Interactive chat mode - Continuing session\\n');\n  } else {\n    console.log('🧠 Interactive chat mode (Ctrl+C to exit)\\n');\n  }\n\n  const readline = await import('readline');\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n    terminal: true,\n  });\n\n  rl.on('line', async (input) => {\n    const trimmed = input.trim();\n    \n    // Handle special commands\n    if (trimmed === ':sessions' || trimmed === ':list') {\n      rl.pause();\n      await listSessions();\n      rl.resume();\n      rl.prompt();\n      return;\n    }\n    \n    if (trimmed.startsWith(':session ')) {\n      const newSessionKey = trimmed.slice(9).trim();\n      const manager = await getSessionManager();\n      const session = await manager.getSessionMetadata(newSessionKey);\n      if (session) {\n        sessionKey = newSessionKey;\n        console.log(`🔄 Switched to session: ${sessionKey}\\n`);\n      } else {\n        console.log(`❌ Session not found: ${newSessionKey}\\n`);\n      }\n      rl.prompt();\n      return;\n    }\n\n    if (trimmed === ':help') {\n      printHelp();\n      rl.prompt();\n      return;\n    }\n\n    if (trimmed === ':quit' || trimmed === ':exit') {\n      rl.close();\n      return;\n    }\n\n    rl.pause();\n    await renderStreamToTerminal(agent, input, sessionKey);\n    rl.resume();\n    rl.prompt();\n  });\n\n  rl.on('close', async () => {\n    console.log('\\n👋 Goodbye!');\n    process.exit(0);\n  });\n\n  rl.setPrompt('You: ');\n  rl.prompt();\n}\n\nfunction printHelp(): void {\n  console.log(`\n📖 Available commands:\n  :sessions, :list    - List available sessions\n  :session <key>     - Switch to another session\n  :quit, :exit       - Exit interactive mode\n  :help              - Show this help\n`);\n}\n"],"mappings":";;;;;;;AAmBA,eAAsB,qBACpB,OACA,SACe;CACf,MAAM,EAAE,YAAY,mBAAmB,sBAAsB;CAE7D,IAAI,aAAa;AAEjB,KAAI,kBACF,SAAQ,IAAI,kDAAkD;KAE9D,SAAQ,IAAI,8CAA8C;CAI5D,MAAM,MAAK,MADY,OAAO,aACV,gBAAgB;EAClC,OAAO,QAAQ;EACf,QAAQ,QAAQ;EAChB,UAAU;EACX,CAAC;AAEF,IAAG,GAAG,QAAQ,OAAO,UAAU;EAC7B,MAAM,UAAU,MAAM,MAAM;AAG5B,MAAI,YAAY,eAAe,YAAY,SAAS;AAClD,MAAG,OAAO;AACV,SAAM,cAAc;AACpB,MAAG,QAAQ;AACX,MAAG,QAAQ;AACX;;AAGF,MAAI,QAAQ,WAAW,YAAY,EAAE;GACnC,MAAM,gBAAgB,QAAQ,MAAM,EAAE,CAAC,MAAM;AAG7C,OAAI,OADkB,MADA,mBAAmB,EACX,mBAAmB,cAAc,EAClD;AACX,iBAAa;AACb,YAAQ,IAAI,2BAA2B,WAAW,IAAI;SAEtD,SAAQ,IAAI,wBAAwB,cAAc,IAAI;AAExD,MAAG,QAAQ;AACX;;AAGF,MAAI,YAAY,SAAS;AACvB,cAAW;AACX,MAAG,QAAQ;AACX;;AAGF,MAAI,YAAY,WAAW,YAAY,SAAS;AAC9C,MAAG,OAAO;AACV;;AAGF,KAAG,OAAO;AACV,QAAM,uBAAuB,OAAO,OAAO,WAAW;AACtD,KAAG,QAAQ;AACX,KAAG,QAAQ;GACX;AAEF,IAAG,GAAG,SAAS,YAAY;AACzB,UAAQ,IAAI,gBAAgB;AAC5B,UAAQ,KAAK,EAAE;GACf;AAEF,IAAG,UAAU,QAAQ;AACrB,IAAG,QAAQ;;AAGb,SAAS,YAAkB;AACzB,SAAQ,IAAI;;;;;;EAMZ"}

package/dist/src/cli/commands/agent/stream-renderer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CLI stream renderer for agent events
+ *
+ * Consumes processDirectStreaming events and renders thinking,
+ * tool calls, and response tokens to the terminal in real time.
+ */
+import type { AgentService } from '../../../agent/index.js';
+/**
+ * Consume the processDirectStreaming async generator and render
+ * thinking / tool-call / response tokens to stdout.
+ *
+ * Returns the final aggregated response text.
+ */
+export declare function renderStreamToTerminal(agent: AgentService, message: string, sessionKey: string): Promise<string>;

package/dist/src/cli/commands/agent/stream-renderer.js

@@ -0,0 +1,99 @@
+import { prependEnvelopeTimestamp } from "../../../channels/envelope-timestamp.js";
+//#region src/cli/commands/agent/stream-renderer.ts
+/** Styled labels for terminal output */
+const STYLE = {
+	dim: "\x1B[2m",
+	reset: "\x1B[0m",
+	cyan: "\x1B[36m",
+	yellow: "\x1B[33m",
+	green: "\x1B[32m",
+	red: "\x1B[31m",
+	bold: "\x1B[1m",
+	magenta: "\x1B[35m"
+};
+function formatToolArgs(args) {
+	if (!args || typeof args !== "object") return "";
+	const entries = Object.entries(args);
+	if (entries.length === 0) return "";
+	return entries.map(([key, value]) => {
+		const stringValue = typeof value === "string" ? value : JSON.stringify(value);
+		return `${key}=${stringValue.length > 80 ? stringValue.slice(0, 77) + "..." : stringValue}`;
+	}).join(", ");
+}
+/**
+* Consume the processDirectStreaming async generator and render
+* thinking / tool-call / response tokens to stdout.
+*
+* Returns the final aggregated response text.
+*/
+async function renderStreamToTerminal(agent, message, sessionKey) {
+	const stamped = message.trimStart().startsWith("/") ? message : prependEnvelopeTimestamp(message);
+	const stream = agent.processDirectStreaming(stamped, sessionKey);
+	let responseText = "";
+	let isFirstToken = true;
+	let isInThinking = false;
+	let hasThinking = false;
+	for await (const event of stream) switch (event.type) {
+		case "thinking": {
+			const content = event.content;
+			if (event.status === "started") {
+				isInThinking = true;
+				hasThinking = true;
+				process.stdout.write(`\n${STYLE.dim}${STYLE.magenta}💭 Thinking...${STYLE.reset}\n`);
+				break;
+			}
+			if (content) {
+				if (!hasThinking) {
+					isInThinking = true;
+					hasThinking = true;
+					process.stdout.write(`\n${STYLE.dim}${STYLE.magenta}💭 Thinking...${STYLE.reset}\n`);
+				}
+				process.stdout.write(`${STYLE.dim}${content}${STYLE.reset}`);
+			}
+			break;
+		}
+		case "tool_start": {
+			const toolName = event.toolName;
+			const args = event.args;
+			if (isInThinking) {
+				isInThinking = false;
+				process.stdout.write("\n");
+			}
+			const argsStr = formatToolArgs(args);
+			process.stdout.write(`\n${STYLE.cyan}🔧 Tool: ${STYLE.bold}${toolName}${STYLE.reset}` + (argsStr ? `${STYLE.dim} (${argsStr})${STYLE.reset}` : "") + "\n");
+			break;
+		}
+		case "tool_end": {
+			const toolName = event.toolName;
+			if (event.isError) process.stdout.write(`${STYLE.red}   ✗ ${toolName} failed${STYLE.reset}\n`);
+			else process.stdout.write(`${STYLE.green}   ✓ ${toolName} done${STYLE.reset}\n`);
+			break;
+		}
+		case "token": {
+			const content = event.content;
+			if (!content) break;
+			if (isInThinking) {
+				isInThinking = false;
+				process.stdout.write("\n");
+			}
+			if (isFirstToken) {
+				process.stdout.write("\n🤖: ");
+				isFirstToken = false;
+			}
+			process.stdout.write(content);
+			responseText += content;
+			break;
+		}
+		case "message_end":
+			if (!isFirstToken) process.stdout.write("\n");
+			break;
+		case "progress": break;
+		default: break;
+	}
+	if (isFirstToken && !hasThinking) process.stdout.write("\n🤖: (no response)\n");
+	return responseText;
+}
+//#endregion
+export { renderStreamToTerminal };
+
+//# sourceMappingURL=stream-renderer.js.map

package/dist/src/cli/commands/agent/stream-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-renderer.js","names":[],"sources":["../../../../../src/cli/commands/agent/stream-renderer.ts"],"sourcesContent":["/**\n * CLI stream renderer for agent events\n *\n * Consumes processDirectStreaming events and renders thinking,\n * tool calls, and response tokens to the terminal in real time.\n */\n\nimport type { AgentService } from '../../../agent/index.js';\nimport { prependEnvelopeTimestamp } from '../../../channels/envelope-timestamp.js';\n\n/** Styled labels for terminal output */\nconst STYLE = {\n  dim: '\\x1b[2m',\n  reset: '\\x1b[0m',\n  cyan: '\\x1b[36m',\n  yellow: '\\x1b[33m',\n  green: '\\x1b[32m',\n  red: '\\x1b[31m',\n  bold: '\\x1b[1m',\n  magenta: '\\x1b[35m',\n};\n\nfunction formatToolArgs(args: unknown): string {\n  if (!args || typeof args !== 'object') return '';\n  const entries = Object.entries(args as Record<string, unknown>);\n  if (entries.length === 0) return '';\n  const parts = entries.map(([key, value]) => {\n    const stringValue = typeof value === 'string' ? value : JSON.stringify(value);\n    const truncated = stringValue.length > 80 ? stringValue.slice(0, 77) + '...' : stringValue;\n    return `${key}=${truncated}`;\n  });\n  return parts.join(', ');\n}\n\n/**\n * Consume the processDirectStreaming async generator and render\n * thinking / tool-call / response tokens to stdout.\n *\n * Returns the final aggregated response text.\n */\nexport async function renderStreamToTerminal(\n  agent: AgentService,\n  message: string,\n  sessionKey: string,\n): Promise<string> {\n  // Prepend envelope timestamp so the model knows the current date/time,\n  // matching the behavior of channel pipelines and webchat gateway.\n  // Skip for slash commands — parseSlashCommand requires lines starting with '/'.\n  const stamped = message.trimStart().startsWith('/')\n    ? message\n    : prependEnvelopeTimestamp(message);\n  const stream = agent.processDirectStreaming(stamped, sessionKey);\n\n  let responseText = '';\n  let isFirstToken = true;\n  let isInThinking = false;\n  let hasThinking = false;\n\n  for await (const event of stream) {\n    switch (event.type) {\n      case 'thinking': {\n        const content = event.content as string | undefined;\n        const status = event.status as string | undefined;\n\n        if (status === 'started') {\n          // Thinking phase started\n          isInThinking = true;\n          hasThinking = true;\n          process.stdout.write(`\\n${STYLE.dim}${STYLE.magenta}💭 Thinking...${STYLE.reset}\\n`);\n          break;\n        }\n\n        if (content) {\n          if (!hasThinking) {\n            isInThinking = true;\n            hasThinking = true;\n            process.stdout.write(`\\n${STYLE.dim}${STYLE.magenta}💭 Thinking...${STYLE.reset}\\n`);\n          }\n          process.stdout.write(`${STYLE.dim}${content}${STYLE.reset}`);\n        }\n        break;\n      }\n\n      case 'tool_start': {\n        const toolName = event.toolName as string;\n        const args = event.args;\n\n        // Close thinking section if open\n        if (isInThinking) {\n          isInThinking = false;\n          process.stdout.write('\\n');\n        }\n\n        const argsStr = formatToolArgs(args);\n        process.stdout.write(\n          `\\n${STYLE.cyan}🔧 Tool: ${STYLE.bold}${toolName}${STYLE.reset}` +\n          (argsStr ? `${STYLE.dim} (${argsStr})${STYLE.reset}` : '') +\n          '\\n',\n        );\n        break;\n      }\n\n      case 'tool_end': {\n        const toolName = event.toolName as string;\n        const isError = event.isError as boolean;\n\n        if (isError) {\n          process.stdout.write(`${STYLE.red}   ✗ ${toolName} failed${STYLE.reset}\\n`);\n        } else {\n          process.stdout.write(`${STYLE.green}   ✓ ${toolName} done${STYLE.reset}\\n`);\n        }\n        break;\n      }\n\n      case 'token': {\n        const content = event.content as string;\n        if (!content) break;\n\n        // Close thinking section if open\n        if (isInThinking) {\n          isInThinking = false;\n          process.stdout.write('\\n');\n        }\n\n        if (isFirstToken) {\n          process.stdout.write('\\n🤖: ');\n          isFirstToken = false;\n        }\n        process.stdout.write(content);\n        responseText += content;\n        break;\n      }\n\n      case 'message_end': {\n        // Ensure newline after streaming response\n        if (!isFirstToken) {\n          process.stdout.write('\\n');\n        }\n        break;\n      }\n\n      case 'progress': {\n        // Optionally show progress updates (e.g. \"Thinking...\")\n        break;\n      }\n\n      default:\n        break;\n    }\n  }\n\n  // If no tokens were streamed, print empty line\n  if (isFirstToken && !hasThinking) {\n    process.stdout.write('\\n🤖: (no response)\\n');\n  }\n\n  return responseText;\n}\n"],"mappings":";;;AAWA,MAAM,QAAQ;CACZ,KAAK;CACL,OAAO;CACP,MAAM;CACN,QAAQ;CACR,OAAO;CACP,KAAK;CACL,MAAM;CACN,SAAS;CACV;AAED,SAAS,eAAe,MAAuB;AAC7C,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;CAC9C,MAAM,UAAU,OAAO,QAAQ,KAAgC;AAC/D,KAAI,QAAQ,WAAW,EAAG,QAAO;AAMjC,QALc,QAAQ,KAAK,CAAC,KAAK,WAAW;EAC1C,MAAM,cAAc,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,MAAM;AAE7E,SAAO,GAAG,IAAI,GADI,YAAY,SAAS,KAAK,YAAY,MAAM,GAAG,GAAG,GAAG,QAAQ;GAGrE,CAAC,KAAK,KAAK;;;;;;;;AASzB,eAAsB,uBACpB,OACA,SACA,YACiB;CAIjB,MAAM,UAAU,QAAQ,WAAW,CAAC,WAAW,IAAI,GAC/C,UACA,yBAAyB,QAAQ;CACrC,MAAM,SAAS,MAAM,uBAAuB,SAAS,WAAW;CAEhE,IAAI,eAAe;CACnB,IAAI,eAAe;CACnB,IAAI,eAAe;CACnB,IAAI,cAAc;AAElB,YAAW,MAAM,SAAS,OACxB,SAAQ,MAAM,MAAd;EACE,KAAK,YAAY;GACf,MAAM,UAAU,MAAM;AAGtB,OAFe,MAAM,WAEN,WAAW;AAExB,mBAAe;AACf,kBAAc;AACd,YAAQ,OAAO,MAAM,KAAK,MAAM,MAAM,MAAM,QAAQ,gBAAgB,MAAM,MAAM,IAAI;AACpF;;AAGF,OAAI,SAAS;AACX,QAAI,CAAC,aAAa;AAChB,oBAAe;AACf,mBAAc;AACd,aAAQ,OAAO,MAAM,KAAK,MAAM,MAAM,MAAM,QAAQ,gBAAgB,MAAM,MAAM,IAAI;;AAEtF,YAAQ,OAAO,MAAM,GAAG,MAAM,MAAM,UAAU,MAAM,QAAQ;;AAE9D;;EAGF,KAAK,cAAc;GACjB,MAAM,WAAW,MAAM;GACvB,MAAM,OAAO,MAAM;AAGnB,OAAI,cAAc;AAChB,mBAAe;AACf,YAAQ,OAAO,MAAM,KAAK;;GAG5B,MAAM,UAAU,eAAe,KAAK;AACpC,WAAQ,OAAO,MACb,KAAK,MAAM,KAAK,WAAW,MAAM,OAAO,WAAW,MAAM,WACxD,UAAU,GAAG,MAAM,IAAI,IAAI,QAAQ,GAAG,MAAM,UAAU,MACvD,KACD;AACD;;EAGF,KAAK,YAAY;GACf,MAAM,WAAW,MAAM;AAGvB,OAFgB,MAAM,QAGpB,SAAQ,OAAO,MAAM,GAAG,MAAM,IAAI,OAAO,SAAS,SAAS,MAAM,MAAM,IAAI;OAE3E,SAAQ,OAAO,MAAM,GAAG,MAAM,MAAM,OAAO,SAAS,OAAO,MAAM,MAAM,IAAI;AAE7E;;EAGF,KAAK,SAAS;GACZ,MAAM,UAAU,MAAM;AACtB,OAAI,CAAC,QAAS;AAGd,OAAI,cAAc;AAChB,mBAAe;AACf,YAAQ,OAAO,MAAM,KAAK;;AAG5B,OAAI,cAAc;AAChB,YAAQ,OAAO,MAAM,SAAS;AAC9B,mBAAe;;AAEjB,WAAQ,OAAO,MAAM,QAAQ;AAC7B,mBAAgB;AAChB;;EAGF,KAAK;AAEH,OAAI,CAAC,aACH,SAAQ,OAAO,MAAM,KAAK;AAE5B;EAGF,KAAK,WAEH;EAGF,QACE;;AAKN,KAAI,gBAAgB,CAAC,YACnB,SAAQ,OAAO,MAAM,wBAAwB;AAG/C,QAAO"}

package/dist/src/cli/commands/agent.js

@@ -11,6 +11,7 @@ import "../../agent/index.js";
 import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
 import { listSessions } from "./agent/sessions.js";
+import { renderStreamToTerminal } from "./agent/stream-renderer.js";
 import { startInteractiveChat } from "./agent/interactive.js";
 import { getContextWithOpts } from "../index.js";
 import { join } from "path";
@@ -111,8 +112,7 @@ function createAgentCommand(_ctx) {
 		if (options.message) {
 			const oneShotModel = options.model?.trim();
 			if (oneShotModel) await agent.switchModelForSession(sessionKey, oneShotModel);
-			const response = await agent.processDirect(options.message, sessionKey);
-			console.log("\n🤖:", response);
+			await renderStreamToTerminal(agent, options.message, sessionKey);
 			if (oneShotModel) await agent.resetSessionModelToAgentDefault(sessionKey);
 			await shutdown();
 		} else if (options.interactive) {

package/dist/src/cli/commands/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","names":[],"sources":["../../../../src/cli/commands/agent.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { AgentService } from '../../agent/index.js';\nimport { loadConfig, getWorkspacePath } from '../../config/index.js';\nimport { MessageBus, MessageBusShutdownError } from '../../infra/bus/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { register, formatExamples, type CLIContext } from '../registry.js';\nimport { getContextWithOpts } from '../index.js';\nimport { ExtensionLoader } from '../../extensions/index.js';\nimport { join } from 'path';\nimport { listSessions } from './agent/sessions.js';\nimport { startInteractiveChat } from './agent/interactive.js';\n\nconst log = createLogger('AgentCommand');\n\ninterface AgentCommandOptions {\n  message?: string;\n  model?: string;\n  interactive?: boolean;\n  session?: string;\n  list?: boolean;\n}\n\nfunction createAgentCommand(_ctx: CLIContext): Command {\n  const cmd = new Command('agent')\n    .description('Chat with the AI agent')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc agent -m \"Hello\"                       # Single message',\n        'xopc agent --model demo/demo-chat-7b -m \"Hi\"  # Override model for one shot',\n        'xopc agent -i                                # Interactive chat mode',\n        'xopc agent -i --session telegram:dm:123456  # Continue existing session',\n        'xopc agent --list                            # List available sessions',\n      ])\n    )\n    .option('--model <id>', 'Model ref for this run (e.g. demo/demo-chat-7b, anthropic/claude-sonnet-4-5)')\n    .option('-m, --message <text>', 'Single message to send')\n    .option('-i, --interactive', 'Interactive chat mode')\n    .option('-s, --session <key>', 'Continue an existing session (use --list to see available sessions)')\n    .option('-l, --list', 'List available sessions and exit')\n    .action(async (options: AgentCommandOptions) => {\n      const ctx = getContextWithOpts();\n      const config = loadConfig(ctx.configPath);\n      const workspace = getWorkspacePath(config) || ctx.workspacePath;\n\n      // Handle --list option\n      if (options.list) {\n        await listSessions();\n        return;\n      }\n\n      const modelConfig = config.agents?.defaults?.model;\n      const modelFromConfig = typeof modelConfig === 'string' ? modelConfig : modelConfig?.primary;\n      const modelId = (options.model?.trim() || modelFromConfig) as string | undefined;\n      const bus = new MessageBus();\n\n      if (ctx.isVerbose) {\n        log.info({ model: modelId, workspace, session: options.session }, 'Starting agent');\n      }\n\n      // Validate session key if provided\n      let sessionKey = options.session || 'cli:direct';\n      if (options.session) {\n        const { getSessionManager } = await import('../utils/session.js');\n        const manager = await getSessionManager();\n        const session = await manager.getSessionMetadata(options.session);\n        if (!session) {\n          console.error(`❌ Session not found: ${options.session}`);\n          console.log('Use --list to see available sessions.');\n          process.exit(1);\n        }\n        console.log(`📂 Continuing session: ${options.session} (${session.messageCount} messages)\\n`);\n      }\n\n      // Initialize extension loader (manifest-first activation: env, channels, model, extensions.*)\n      let extensionLoader: ExtensionLoader | null = null;\n      try {\n        extensionLoader = new ExtensionLoader({\n          workspaceDir: workspace,\n          extensionsDir: join(workspace, '.extensions'),\n        });\n        extensionLoader.setConfig(config as Parameters<ExtensionLoader['setConfig']>[0]);\n        extensionLoader.setRuntimeContext({ bus });\n        await extensionLoader.loadByActivationPlan();\n        const n = extensionLoader.getRegistry().extensions.size;\n        if (n > 0) {\n          log.info({ count: n }, 'Extensions loaded');\n        }\n      } catch (error) {\n        const em = error instanceof Error ? error.message : String(error);\n        log.warn({ err: error, errorMessage: em }, `CLI agent: failed to load extensions: ${em}`);\n      }\n\n      const { createCliReadlineClarifyRequestFn } = await import('../../agent/tools/cli-clarify.js');\n\n      const agent = new AgentService(bus, {\n        workspace,\n        model: modelId,\n        config,\n        extensionRegistry: extensionLoader?.getRegistry(),\n        gatewayClarify: {\n          requestClarification: createCliReadlineClarifyRequestFn(),\n        },\n      });\n\n      // Start agent service in background\n      agent.start().catch((err) => {\n        const em = err instanceof Error ? err.message : String(err);\n        log.error({ err, errorMessage: em }, `CLI agent service exited: ${em}`);\n      });\n\n      // Start outbound message processor for CLI mode\n      let running = true;\n      const _outboundProcessor = (async () => {\n        while (running) {\n          try {\n            const msg = await bus.consumeOutbound();\n            console.log(`\\n📤 [${msg.channel}] ${msg.chat_id}: ${msg.content.slice(0, 100)}...`);\n          } catch (error) {\n            if (error instanceof MessageBusShutdownError) {\n              break;\n            }\n            const em = error instanceof Error ? error.message : String(error);\n            log.error({ err: error, errorMessage: em }, `CLI outbound processor failed: ${em}`);\n            await new Promise((resolve) => setTimeout(resolve, 1000));\n          }\n        }\n      })();\n\n      const shutdown = async () => {\n        running = false;\n        bus.shutdown();\n        await agent.stop();\n      };\n\n      process.on('SIGINT', shutdown);\n      process.on('SIGTERM', shutdown);\n\n      if (options.message) {\n        const oneShotModel = options.model?.trim();\n        if (oneShotModel) {\n          await agent.switchModelForSession(sessionKey, oneShotModel);\n        }\n        const response = await agent.processDirect(options.message, sessionKey);\n        console.log('\\n🤖:', response);\n        if (oneShotModel) {\n          await agent.resetSessionModelToAgentDefault(sessionKey);\n        }\n        await shutdown();\n      } else if (options.interactive) {\n        const interactiveModel = options.model?.trim();\n        if (interactiveModel) {\n          await agent.switchModelForSession(sessionKey, interactiveModel);\n        }\n        await startInteractiveChat(agent, {\n          workspace,\n          sessionKey,\n          continuingSession: !!options.session,\n        });\n      } else {\n        await shutdown();\n        cmd.help();\n      }\n    });\n\n  return cmd;\n}\n\nregister({\n  id: 'agent',\n  name: 'agent',\n  description: 'Chat with the AI agent',\n  factory: createAgentCommand,\n  metadata: {\n    category: 'runtime',\n    examples: [\n      'xopc agent -m \"Hello\"',\n      'xopc agent --model demo/demo-chat-7b -m \"Hello demo!\"',\n      'xopc agent -i',\n    ],\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"agent.js","names":[],"sources":["../../../../src/cli/commands/agent.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { AgentService } from '../../agent/index.js';\nimport { loadConfig, getWorkspacePath } from '../../config/index.js';\nimport { MessageBus, MessageBusShutdownError } from '../../infra/bus/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { register, formatExamples, type CLIContext } from '../registry.js';\nimport { getContextWithOpts } from '../index.js';\nimport { ExtensionLoader } from '../../extensions/index.js';\nimport { join } from 'path';\nimport { listSessions } from './agent/sessions.js';\nimport { startInteractiveChat } from './agent/interactive.js';\nimport { renderStreamToTerminal } from './agent/stream-renderer.js';\n\nconst log = createLogger('AgentCommand');\n\ninterface AgentCommandOptions {\n  message?: string;\n  model?: string;\n  interactive?: boolean;\n  session?: string;\n  list?: boolean;\n}\n\nfunction createAgentCommand(_ctx: CLIContext): Command {\n  const cmd = new Command('agent')\n    .description('Chat with the AI agent')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc agent -m \"Hello\"                       # Single message',\n        'xopc agent --model demo/demo-chat-7b -m \"Hi\"  # Override model for one shot',\n        'xopc agent -i                                # Interactive chat mode',\n        'xopc agent -i --session telegram:dm:123456  # Continue existing session',\n        'xopc agent --list                            # List available sessions',\n      ])\n    )\n    .option('--model <id>', 'Model ref for this run (e.g. demo/demo-chat-7b, anthropic/claude-sonnet-4-5)')\n    .option('-m, --message <text>', 'Single message to send')\n    .option('-i, --interactive', 'Interactive chat mode')\n    .option('-s, --session <key>', 'Continue an existing session (use --list to see available sessions)')\n    .option('-l, --list', 'List available sessions and exit')\n    .action(async (options: AgentCommandOptions) => {\n      const ctx = getContextWithOpts();\n      const config = loadConfig(ctx.configPath);\n      const workspace = getWorkspacePath(config) || ctx.workspacePath;\n\n      // Handle --list option\n      if (options.list) {\n        await listSessions();\n        return;\n      }\n\n      const modelConfig = config.agents?.defaults?.model;\n      const modelFromConfig = typeof modelConfig === 'string' ? modelConfig : modelConfig?.primary;\n      const modelId = (options.model?.trim() || modelFromConfig) as string | undefined;\n      const bus = new MessageBus();\n\n      if (ctx.isVerbose) {\n        log.info({ model: modelId, workspace, session: options.session }, 'Starting agent');\n      }\n\n      // Validate session key if provided\n      let sessionKey = options.session || 'cli:direct';\n      if (options.session) {\n        const { getSessionManager } = await import('../utils/session.js');\n        const manager = await getSessionManager();\n        const session = await manager.getSessionMetadata(options.session);\n        if (!session) {\n          console.error(`❌ Session not found: ${options.session}`);\n          console.log('Use --list to see available sessions.');\n          process.exit(1);\n        }\n        console.log(`📂 Continuing session: ${options.session} (${session.messageCount} messages)\\n`);\n      }\n\n      // Initialize extension loader (manifest-first activation: env, channels, model, extensions.*)\n      let extensionLoader: ExtensionLoader | null = null;\n      try {\n        extensionLoader = new ExtensionLoader({\n          workspaceDir: workspace,\n          extensionsDir: join(workspace, '.extensions'),\n        });\n        extensionLoader.setConfig(config as Parameters<ExtensionLoader['setConfig']>[0]);\n        extensionLoader.setRuntimeContext({ bus });\n        await extensionLoader.loadByActivationPlan();\n        const n = extensionLoader.getRegistry().extensions.size;\n        if (n > 0) {\n          log.info({ count: n }, 'Extensions loaded');\n        }\n      } catch (error) {\n        const em = error instanceof Error ? error.message : String(error);\n        log.warn({ err: error, errorMessage: em }, `CLI agent: failed to load extensions: ${em}`);\n      }\n\n      const { createCliReadlineClarifyRequestFn } = await import('../../agent/tools/cli-clarify.js');\n\n      const agent = new AgentService(bus, {\n        workspace,\n        model: modelId,\n        config,\n        extensionRegistry: extensionLoader?.getRegistry(),\n        gatewayClarify: {\n          requestClarification: createCliReadlineClarifyRequestFn(),\n        },\n      });\n\n      // Start agent service in background\n      agent.start().catch((err) => {\n        const em = err instanceof Error ? err.message : String(err);\n        log.error({ err, errorMessage: em }, `CLI agent service exited: ${em}`);\n      });\n\n      // Start outbound message processor for CLI mode\n      let running = true;\n      const _outboundProcessor = (async () => {\n        while (running) {\n          try {\n            const msg = await bus.consumeOutbound();\n            console.log(`\\n📤 [${msg.channel}] ${msg.chat_id}: ${msg.content.slice(0, 100)}...`);\n          } catch (error) {\n            if (error instanceof MessageBusShutdownError) {\n              break;\n            }\n            const em = error instanceof Error ? error.message : String(error);\n            log.error({ err: error, errorMessage: em }, `CLI outbound processor failed: ${em}`);\n            await new Promise((resolve) => setTimeout(resolve, 1000));\n          }\n        }\n      })();\n\n      const shutdown = async () => {\n        running = false;\n        bus.shutdown();\n        await agent.stop();\n      };\n\n      process.on('SIGINT', shutdown);\n      process.on('SIGTERM', shutdown);\n\n      if (options.message) {\n        const oneShotModel = options.model?.trim();\n        if (oneShotModel) {\n          await agent.switchModelForSession(sessionKey, oneShotModel);\n        }\n        await renderStreamToTerminal(agent, options.message, sessionKey);\n        if (oneShotModel) {\n          await agent.resetSessionModelToAgentDefault(sessionKey);\n        }\n        await shutdown();\n      } else if (options.interactive) {\n        const interactiveModel = options.model?.trim();\n        if (interactiveModel) {\n          await agent.switchModelForSession(sessionKey, interactiveModel);\n        }\n        await startInteractiveChat(agent, {\n          workspace,\n          sessionKey,\n          continuingSession: !!options.session,\n        });\n      } else {\n        await shutdown();\n        cmd.help();\n      }\n    });\n\n  return cmd;\n}\n\nregister({\n  id: 'agent',\n  name: 'agent',\n  description: 'Chat with the AI agent',\n  factory: createAgentCommand,\n  metadata: {\n    category: 'runtime',\n    examples: [\n      'xopc agent -m \"Hello\"',\n      'xopc agent --model demo/demo-chat-7b -m \"Hello demo!\"',\n      'xopc agent -i',\n    ],\n  },\n});\n"],"mappings":"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"}

package/dist/src/cli/commands/onboard.js

@@ -1,4 +1,6 @@
+import { ConfigSchema, init_schema } from "../../config/schema.js";
 import { saveConfig } from "../../config/loader.js";
+import { isWeixinOnboardConfigured } from "../../../extensions/weixin/src/adapters/onboard-cli.js";
 import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
 import { seedMainAgentBootstrap } from "../../agent/context/workspace-seed.js";
@@ -9,9 +11,10 @@ import { GatewayLockError, acquireGatewayLock } from "../../gateway/lock.js";
 import { getChannelConfigurators } from "./onboard/channels/registry.js";
 import { setupChannels } from "./onboard/channels/index.js";
 import { join } from "path";
-import { confirm, input, select } from "@inquirer/prompts";
+import { select } from "@inquirer/prompts";
 import { Command } from "commander";
 //#region src/cli/commands/onboard.ts
+init_schema();
 function isInteractive() {
 	return process.stdin.isTTY && process.stdout.isTTY;
 }
@@ -23,11 +26,11 @@ async function setupNonInteractive(_configPath, existingConfig) {
 	return existingConfig;
 }
 function createOnboardCommand(ctx) {
-	return new Command("onboard").description("Interactive setup wizard for xopc").addHelpText("after", formatExamples([
+	return new Command("onboard").description("Interactive setup wizard for xopc (gateway uses schema defaults)").addHelpText("after", formatExamples([
 		"xopc onboard              # Full interactive setup",
 		"xopc onboard --model      # Configure LLM model only",
-		"xopc onboard --channels   # Configure channels only",
-		"xopc onboard --gateway    # Configure gateway only"
+		"xopc onboard --channels   # Configure channels (incl. Weixin QR)",
+		"xopc onboard --gateway    # Apply default gateway settings (quiet)"
 	])).option("--model", "Configure LLM provider and model").option("--channels", "Configure messaging channels").option("--gateway", "Configure gateway WebUI").option("--all", "Configure everything (default)").action(async (options) => {
 		try {
 			await runOnboard(options, ctx);
@@ -54,6 +57,8 @@ async function runOnboard(options, ctx) {
 	const doChannels = options.channels || options.all || !options.model && !options.gateway;
 	const doGateway = options.gateway || options.all || !options.model && !options.channels;
 	const runFullWizard = !options.model && !options.channels && !options.gateway;
+	/** Any setup step besides the unified launch prompt ran in interactive flow. */
+	const didConfigurableSteps = doModel || doChannels || doGateway;
 	if (!isInteractive()) {
 		if (doModel) config = await setupNonInteractive(configPath, config);
 		if (doChannels) {
@@ -83,8 +88,7 @@ async function runOnboard(options, ctx) {
 	const port = config?.gateway?.port ?? 18790;
 	const displayHost = host === "0.0.0.0" ? "localhost" : host;
 	const gwToken = gatewayConfigured ? gatewayAuth.token : void 0;
-	const showGatewaySummary = Boolean(gatewayConfigured && gwToken && (doGateway || runFullWizard));
-	if (showGatewaySummary && gwToken) {
+	if (Boolean(gatewayConfigured && gwToken && (doGateway || runFullWizard)) && gwToken) {
 		const webuiUrl = `http://${displayHost}:${port}?token=${gwToken}`;
 		console.log("🌐 Web console (browser) — start here");
 		console.log(`   Open: http://${displayHost}:${port}`);
@@ -96,8 +100,8 @@ async function runOnboard(options, ctx) {
 	if (runFullWizard) {
 		console.log("🚀 Next steps:");
 		if (gatewayConfigured) {
-			console.log("  1. Open the Web console in your browser (URL above; start the gateway below if needed)");
-			console.log("  2. Or chat in the terminal: xopc agent -i");
+			console.log("  1. Choose how to launch below (gateway or terminal UI)");
+			console.log("  2. Or chat with: xopc agent -i");
 			console.log("  3. Optional: read BOOTSTRAP.md in your workspace for workspace tips");
 		} else {
 			console.log("  1. Chat in the terminal: xopc agent -i");
@@ -119,12 +123,12 @@ async function runOnboard(options, ctx) {
 	console.log("  Config:", configPath);
 	console.log("  Workspace:", workspacePath);
 	if (runFullWizard) console.log("  Bootstrap:", join(workspacePath, "BOOTSTRAP.md"));
-	if (showGatewaySummary) await startGatewayNow(config, ctx);
+	if (isInteractive() && didConfigurableSteps) await promptLaunchAfterOnboard(config, ctx, { doChannels });
 	process.exit(0);
 }
-async function startGatewayNow(config, ctx) {
-	const host = config?.gateway?.host || "0.0.0.0";
-	const port = config?.gateway?.port || 18790;
+async function startGatewayInBackground(config, ctx) {
+	const host = config.gateway?.host ?? "127.0.0.1";
+	const port = config.gateway?.port ?? 18790;
 	const displayHost = host === "0.0.0.0" ? "localhost" : host;
 	let isRunning = false;
 	try {
@@ -141,10 +145,7 @@ async function startGatewayNow(config, ctx) {
 		console.log("");
 		console.log("📝 To apply the new configuration, restart gateway:");
 		console.log("   xopc gateway restart");
-	} else if (isInteractive()) if (await confirm({
-		message: "Start Gateway WebUI now (background mode)?",
-		default: true
-	})) {
+	} else {
 		console.log("\n🚀 Starting Gateway WebUI in background...");
 		console.log("");
 		const { spawn } = await import("child_process");
@@ -169,97 +170,80 @@ async function startGatewayNow(config, ctx) {
 			console.log("✅ Gateway started in background");
 			console.log(`   PID: ${child.pid}`);
 			console.log(`   URL: http://${displayHost}:${port}`);
-			const token = config?.gateway?.auth?.token;
+			const token = config.gateway?.auth?.token;
 			if (token) console.log(`   Token: ${token.slice(0, 8)}...${token.slice(-8)}`);
 		} else {
 			console.log("⚠️  Failed to start gateway automatically.");
-			console.log("   You can start it manually with:");
-			console.log(`   xopc gateway --background`);
+			console.log("   Start manually with:");
+			console.log("   xopc gateway --background");
 		}
-	} else {
-		console.log("\n⏭️  Skipping gateway startup.");
-		console.log("   You can start it later with:");
-		console.log(`   xopc gateway --background`);
-	}
-	else {
-		console.log("\n🚀 Gateway is configured but not running.");
-		console.log("");
-		console.log("📝 To start the gateway in background:");
-		console.log(`   xopc gateway --background`);
-		console.log("");
-		console.log("📝 To start in foreground (development mode):");
-		console.log(`   pnpm run dev -- gateway --host ${host} --port ${port}`);
 	}
 	console.log("");
-	console.log("📚 Other useful commands:");
+	console.log("📚 Useful commands:");
 	console.log("   xopc gateway status    # Check gateway status");
 	console.log("   xopc gateway stop      # Stop gateway");
 	console.log("   xopc gateway restart   # Restart gateway");
 	console.log("   xopc gateway logs      # View logs");
 }
-async function setupGateway(config) {
-	console.log(colors.cyan("\n🌐 Step 4: Gateway WebUI\n"));
-	if (!await confirm({
-		message: "Enable Gateway WebUI?",
-		default: true
-	})) {
-		console.log("ℹ️  Gateway skipped.");
-		return config;
-	}
-	const host = await select({
-		message: "Bind address:",
-		choices: [{
-			name: "Localhost only (127.0.0.1)",
-			value: "127.0.0.1"
-		}, {
-			name: "All interfaces (0.0.0.0)",
-			value: "0.0.0.0"
-		}],
-		default: "0.0.0.0"
-	});
-	const portInput = await input({
-		message: "Port:",
-		default: "18790",
-		validate: (input) => {
-			const port = parseInt(input, 10);
-			return !isNaN(port) && port > 0 && port < 65536 || "Invalid port number";
-		}
-	});
-	const port = parseInt(portInput, 10);
-	const authMode = await select({
-		message: "Authentication:",
-		choices: [{
-			name: "Token (recommended)",
-			value: "token"
-		}, {
-			name: "None (local only)",
-			value: "none"
-		}],
-		default: "token"
+async function promptLaunchAfterOnboard(config, ctx, flags) {
+	console.log("");
+	const choice = await select({
+		message: "How do you want to launch xopc now?",
+		choices: [
+			{
+				value: "tui",
+				name: "Terminal UI (embedded)",
+				description: "xopc tui --local — no gateway process required"
+			},
+			{
+				value: "gateway",
+				name: "Gateway WebUI (background)",
+				description: "Start the HTTP gateway for the browser console"
+			},
+			{
+				value: "none",
+				name: "Exit — I will start manually",
+				description: "Finish setup without starting a runtime"
+			}
+		],
+		default: "tui"
 	});
-	let token;
-	if (authMode === "token") {
-		const existingToken = config?.gateway?.auth?.token;
-		if (existingToken) {
-			if (await confirm({
-				message: "Use existing token?",
-				default: true
-			})) token = existingToken;
-		}
-		if (!token) {
-			token = (await import("crypto")).randomBytes(24).toString("hex");
-			console.log(`\n🔑 Generated token: ${token.slice(0, 8)}...${token.slice(-8)}`);
-		}
+	if (choice === "gateway") {
+		await startGatewayInBackground(config, ctx);
+		return;
 	}
-	config.gateway = config.gateway || {};
-	config.gateway.host = host;
-	config.gateway.port = port;
-	config.gateway.auth = {
-		mode: authMode,
-		...token ? { token } : {}
+	if (choice === "tui") {
+		if (flags.doChannels && !isWeixinOnboardConfigured(config)) console.log(colors.gray("\n💡 Weixin is not logged in yet. When ready run: xopc channels login --channel weixin\n"));
+		const { runTui } = await import("../../tui/tui.js");
+		await runTui({ local: true });
+		return;
+	}
+	console.log("\n⏭️  You can start later:");
+	console.log("   xopc gateway --background");
+	console.log("   xopc tui --local");
+}
+async function setupGateway(config) {
+	console.log(colors.cyan("\n🌐 Gateway WebUI\n"));
+	console.log(colors.gray("Applying defaults from config schema (127.0.0.1:18790, token auth; token generated if missing).\n"));
+	const gw = config.gateway ?? {};
+	const { randomBytes } = await import("node:crypto");
+	const authMode = gw.auth?.mode === "none" ? "none" : "token";
+	const token = authMode === "token" ? typeof gw.auth?.token === "string" && gw.auth.token.length > 0 ? gw.auth.token : randomBytes(24).toString("hex") : void 0;
+	const merged = {
+		...config,
+		gateway: {
+			...gw,
+			host: gw.host ?? "127.0.0.1",
+			port: gw.port ?? 18790,
+			auth: authMode === "none" ? { mode: "none" } : {
+				mode: "token",
+				token
+			}
+		}
 	};
-	console.log("✅ Gateway configuration saved.\n");
-	return config;
+	const parsed = ConfigSchema.parse(merged);
+	console.log("✅ Gateway defaults applied.\n");
+	return parsed;
 }
 register({
 	id: "onboard",