@xopcai/xopc 0.0.27 → 0.0.29

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",

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

@@ -1 +1 @@
-{"version":3,"file":"onboard.js","names":["runModelSetup","runChannelOnboard"],"sources":["../../../../src/cli/commands/onboard.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { join } from 'path';\nimport { input, select, confirm } from '@inquirer/prompts';\nimport { saveConfig } from '../../config/index.js';\nimport { register, formatExamples } from '../registry.js';\nimport type { CLIContext } from '../registry.js';\nimport type { Config } from '../../config/schema.js';\nimport { setupModel as runModelSetup } from './onboard/model.js';\nimport { colors } from '../utils/colors.js';\nimport { acquireGatewayLock, GatewayLockError } from '../../gateway/lock.js';\nimport { setupChannels as runChannelOnboard, getChannelConfigurators } from './onboard/channels/index.js';\nimport { seedMainAgentBootstrap } from '../../agent/context/workspace-seed.js';\nimport { initWorkspace } from '../utils/init-workspace.js';\n\nfunction isInteractive(): boolean {\n  return process.stdin.isTTY && process.stdout.isTTY;\n}\n\nasync function setupNonInteractive(_configPath: string, existingConfig: Config): Promise<Config> {\n  console.log('\\n🤖 AI Model Configuration (Non-Interactive Mode)\\n');\n  console.log('Current config:', JSON.stringify(existingConfig.agents?.defaults?.model, null, 2));\n  console.log('\\n💡 To configure in interactive mode, run: xopc onboard');\n  console.log('💡 Or set up manually in:', _configPath);\n  return existingConfig;\n}\n\nfunction createOnboardCommand(ctx: CLIContext): Command {\n  const cmd = new Command('onboard')\n    .description('Interactive setup wizard for xopc')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc onboard              # Full interactive setup',\n        'xopc onboard --model      # Configure LLM model only',\n        'xopc onboard --channels   # Configure channels only',\n        'xopc onboard --gateway    # Configure gateway only',\n      ])\n    )\n    .option('--model', 'Configure LLM provider and model')\n    .option('--channels', 'Configure messaging channels')\n    .option('--gateway', 'Configure gateway WebUI')\n    .option('--all', 'Configure everything (default)')\n    .action(async (options) => {\n      try {\n        await runOnboard(options, ctx);\n      } catch (error: unknown) {\n        const err = error as { name?: string; code?: string };\n        if (err?.name === 'ExitPromptError' || err?.code === 'EXIT_PROMPT') {\n          console.log('\\n\\n👋 Setup cancelled.');\n          process.exit(0);\n        }\n        throw error;\n      }\n    });\n\n  return cmd;\n}\n\nasync function runOnboard(\n  options: { model?: boolean; channels?: boolean; gateway?: boolean; all?: boolean },\n  ctx: CLIContext\n): Promise<void> {\n  console.log(colors.cyan('\\n🚀 Welcome to xopc setup!\\n'));\n  console.log('═'.repeat(50));\n\n  const workspacePath = ctx.workspacePath;\n  const configPath = ctx.configPath;\n\n  const initResult = await initWorkspace({ configPath, workspacePath });\n  let config = initResult.config;\n\n  // Determine what to configure based on options\n  const doModel = options.model || options.all || (!options.channels && !options.gateway);\n  const doChannels = options.channels || options.all || (!options.model && !options.gateway);\n  const doGateway = options.gateway || options.all || (!options.model && !options.channels);\n  const runFullWizard = !options.model && !options.channels && !options.gateway;\n\n  if (!isInteractive()) {\n    // Non-interactive mode\n    if (doModel) {\n      config = await setupNonInteractive(configPath, config);\n    }\n    if (doChannels) {\n      console.log('\\n💬 Channels Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure channels, edit the config file manually.');\n    }\n    if (doGateway) {\n      console.log('\\n🌐 Gateway Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure gateway, edit the config file manually.');\n    }\n  } else {\n    // Interactive mode\n    if (doModel) {\n      config = await runModelSetup(config, ctx);\n    }\n\n    if (doChannels) {\n      const channelIds = getChannelConfigurators().map(c => c.id);\n      console.log(colors.gray(`\\nChannel onboarding: ${channelIds.join(', ')}\\n`));\n      config = await runChannelOnboard(config);\n    }\n\n    if (doGateway) {\n      config = await setupGateway(config);\n    }\n  }\n\n  // Save config once at the end\n  await saveConfig(config as Config, configPath);\n\n  seedMainAgentBootstrap(config as Config);\n\n  console.log('\\n' + '═'.repeat(50));\n  console.log('\\n🎉 Setup Complete!\\n');\n\n  const gatewayAuth = (config as any)?.gateway?.auth;\n  const gatewayConfigured =\n    gatewayAuth?.mode === 'token' &&\n    typeof gatewayAuth?.token === 'string' &&\n    gatewayAuth.token.length > 0;\n  const host = (config as any)?.gateway?.host || '0.0.0.0';\n  const port = (config as any)?.gateway?.port ?? 18790;\n  const displayHost = host === '0.0.0.0' ? 'localhost' : host;\n  const gwToken = gatewayConfigured ? (gatewayAuth.token as string) : undefined;\n\n  const showGatewaySummary = Boolean(gatewayConfigured && gwToken && (doGateway || runFullWizard));\n\n  if (showGatewaySummary && gwToken) {\n    const webuiUrl = `http://${displayHost}:${port}?token=${gwToken}`;\n    console.log('🌐 Web console (browser) — start here');\n    console.log(`   Open: http://${displayHost}:${port}`);\n    console.log(`   Token: ${gwToken.slice(0, 8)}...${gwToken.slice(-8)}`);\n    console.log('   Bookmark link (token is saved in the browser when you open it):');\n    console.log(`   ${webuiUrl}`);\n    console.log('');\n  }\n\n  if (runFullWizard) {\n    console.log('🚀 Next steps:');\n    if (gatewayConfigured) {\n      console.log('  1. Open the Web console in your browser (URL above; start the gateway below if needed)');\n      console.log('  2. Or chat in the terminal: xopc agent -i');\n      console.log('  3. Optional: read BOOTSTRAP.md in your workspace for workspace tips');\n    } else {\n      console.log('  1. Chat in the terminal: xopc agent -i');\n      console.log('  2. Optional: add the Web console: xopc onboard --gateway');\n      console.log('  3. Optional: read BOOTSTRAP.md in your workspace');\n    }\n    console.log('');\n  } else if (doGateway && gatewayConfigured) {\n    console.log('🚀 Next step:');\n    console.log('  Start the gateway if it is not running, then open the Web console URL above.');\n    console.log('');\n  }\n\n  console.log('📝 Usage:');\n  console.log('  xopc agent -m \"Hello\"    # Chat with AI');\n  console.log('  xopc agent -i            # Interactive mode');\n  console.log('  xopc models list         # List models');\n  console.log('  xopc auth list           # View authentication');\n\n  console.log('\\n📁 Files:');\n  console.log('  Config:', configPath);\n  console.log('  Workspace:', workspacePath);\n  if (runFullWizard) {\n    console.log('  Bootstrap:', join(workspacePath, 'BOOTSTRAP.md'));\n  }\n\n  if (showGatewaySummary) {\n    await startGatewayNow(config as Config, ctx);\n  }\n\n  process.exit(0);\n}\n\nasync function startGatewayNow(config: Config, ctx: CLIContext): Promise<void> {\n  const host = (config as any)?.gateway?.host || '0.0.0.0';\n  const port = (config as any)?.gateway?.port || 18790;\n  const displayHost = host === '0.0.0.0' ? 'localhost' : host;\n\n  let isRunning = false;\n  try {\n    const lock = await acquireGatewayLock(ctx.configPath, { timeoutMs: 100, port });\n    await lock.release();\n  } catch (err) {\n    if (err instanceof GatewayLockError) {\n      isRunning = true;\n    }\n  }\n\n  if (isRunning) {\n    console.log('\\n🌐 Gateway is already running!');\n    console.log(`   URL: http://${displayHost}:${port}`);\n    console.log('');\n    console.log('📝 To apply the new configuration, restart gateway:');\n    console.log('   xopc gateway restart');\n  } else {\n    if (isInteractive()) {\n      const shouldStart = await confirm({\n        message: 'Start Gateway WebUI now (background mode)?',\n        default: true,\n      });\n\n      if (shouldStart) {\n        console.log('\\n🚀 Starting Gateway WebUI in background...');\n        console.log('');\n\n        const { spawn } = await import('child_process');\n        const args = [\n          ...process.execArgv,\n          ...process.argv.slice(1).filter(arg => !arg.includes('onboard') && arg !== '--quick'),\n          'gateway',\n          '--background',\n          '--host', host,\n          '--port', String(port),\n        ];\n\n        const child = spawn(process.execPath, args, {\n          detached: true,\n          stdio: 'ignore',\n          env: process.env,\n        });\n\n        child.unref();\n\n        await new Promise(resolve => setTimeout(resolve, 500));\n\n        if (child.pid && !child.killed) {\n          console.log('✅ Gateway started in background');\n          console.log(`   PID: ${child.pid}`);\n          console.log(`   URL: http://${displayHost}:${port}`);\n          const token = (config as any)?.gateway?.auth?.token;\n          if (token) {\n            console.log(`   Token: ${token.slice(0, 8)}...${token.slice(-8)}`);\n          }\n        } else {\n          console.log('⚠️  Failed to start gateway automatically.');\n          console.log('   You can start it manually with:');\n          console.log(`   xopc gateway --background`);\n        }\n      } else {\n        console.log('\\n⏭️  Skipping gateway startup.');\n        console.log('   You can start it later with:');\n        console.log(`   xopc gateway --background`);\n      }\n    } else {\n      console.log('\\n🚀 Gateway is configured but not running.');\n      console.log('');\n      console.log('📝 To start the gateway in background:');\n      console.log(`   xopc gateway --background`);\n      console.log('');\n      console.log('📝 To start in foreground (development mode):');\n      console.log(`   pnpm run dev -- gateway --host ${host} --port ${port}`);\n    }\n  }\n\n  console.log('');\n  console.log('📚 Other useful commands:');\n  console.log('   xopc gateway status    # Check gateway status');\n  console.log('   xopc gateway stop      # Stop gateway');\n  console.log('   xopc gateway restart   # Restart gateway');\n  console.log('   xopc gateway logs      # View logs');\n}\n\nasync function setupGateway(config: Config): Promise<Config> {\n  console.log(colors.cyan('\\n🌐 Step 4: Gateway WebUI\\n'));\n\n  const enableGateway = await confirm({\n    message: 'Enable Gateway WebUI?',\n    default: true,\n  });\n\n  if (!enableGateway) {\n    console.log('ℹ️  Gateway skipped.');\n    return config;\n  }\n\n  const host = await select({\n    message: 'Bind address:',\n    choices: [\n      { name: 'Localhost only (127.0.0.1)', value: '127.0.0.1' },\n      { name: 'All interfaces (0.0.0.0)', value: '0.0.0.0' },\n    ],\n    default: '0.0.0.0',\n  });\n\n  const portInput = await input({\n    message: 'Port:',\n    default: '18790',\n    validate: (input) => {\n      const port = parseInt(input, 10);\n      return !isNaN(port) && port > 0 && port < 65536 || 'Invalid port number';\n    },\n  });\n\n  const port = parseInt(portInput, 10);\n\n  const authMode = await select({\n    message: 'Authentication:',\n    choices: [\n      { name: 'Token (recommended)', value: 'token' },\n      { name: 'None (local only)', value: 'none' },\n    ],\n    default: 'token',\n  });\n\n  let token: string | undefined;\n  if (authMode === 'token') {\n    const existingToken = (config as any)?.gateway?.auth?.token;\n    if (existingToken) {\n      const reuse = await confirm({\n        message: 'Use existing token?',\n        default: true,\n      });\n      if (reuse) {\n        token = existingToken;\n      }\n    }\n\n    if (!token) {\n      const crypto = await import('crypto');\n      token = crypto.randomBytes(24).toString('hex');\n      console.log(`\\n🔑 Generated token: ${token.slice(0, 8)}...${token.slice(-8)}`);\n    }\n  }\n\n  (config as any).gateway = (config as any).gateway || {};\n  (config as any).gateway.host = host;\n  (config as any).gateway.port = port;\n  (config as any).gateway.auth = {\n    mode: authMode,\n    ...(token ? { token } : {}),\n  };\n\n  console.log('✅ Gateway configuration saved.\\n');\n\n  return config;\n}\n\nregister({\n  id: 'onboard',\n  name: 'onboard',\n  description: 'Interactive setup wizard',\n  factory: createOnboardCommand,\n  metadata: {\n    category: 'setup',\n    examples: [\n      'xopc onboard',\n      'xopc onboard --model',\n      'xopc onboard --channels',\n    ],\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"onboard.js","names":["runModelSetup","runChannelOnboard"],"sources":["../../../../src/cli/commands/onboard.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { join } from 'path';\nimport { select } from '@inquirer/prompts';\nimport { saveConfig } from '../../config/index.js';\nimport { register, formatExamples } from '../registry.js';\nimport type { CLIContext } from '../registry.js';\nimport type { Config } from '../../config/schema.js';\nimport { setupModel as runModelSetup } from './onboard/model.js';\nimport { colors } from '../utils/colors.js';\nimport { acquireGatewayLock, GatewayLockError } from '../../gateway/lock.js';\nimport { setupChannels as runChannelOnboard, getChannelConfigurators } from './onboard/channels/index.js';\nimport { seedMainAgentBootstrap } from '../../agent/context/workspace-seed.js';\nimport { initWorkspace } from '../utils/init-workspace.js';\nimport { ConfigSchema } from '../../config/schema.js';\nimport { isWeixinOnboardConfigured } from '../../../extensions/weixin/src/adapters/onboard-cli.js';\n\nfunction isInteractive(): boolean {\n  return process.stdin.isTTY && process.stdout.isTTY;\n}\n\nasync function setupNonInteractive(_configPath: string, existingConfig: Config): Promise<Config> {\n  console.log('\\n🤖 AI Model Configuration (Non-Interactive Mode)\\n');\n  console.log('Current config:', JSON.stringify(existingConfig.agents?.defaults?.model, null, 2));\n  console.log('\\n💡 To configure in interactive mode, run: xopc onboard');\n  console.log('💡 Or set up manually in:', _configPath);\n  return existingConfig;\n}\n\nfunction createOnboardCommand(ctx: CLIContext): Command {\n  const cmd = new Command('onboard')\n    .description('Interactive setup wizard for xopc (gateway uses schema defaults)')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc onboard              # Full interactive setup',\n        'xopc onboard --model      # Configure LLM model only',\n        'xopc onboard --channels   # Configure channels (incl. Weixin QR)',\n        'xopc onboard --gateway    # Apply default gateway settings (quiet)',\n      ])\n    )\n    .option('--model', 'Configure LLM provider and model')\n    .option('--channels', 'Configure messaging channels')\n    .option('--gateway', 'Configure gateway WebUI')\n    .option('--all', 'Configure everything (default)')\n    .action(async (options) => {\n      try {\n        await runOnboard(options, ctx);\n      } catch (error: unknown) {\n        const err = error as { name?: string; code?: string };\n        if (err?.name === 'ExitPromptError' || err?.code === 'EXIT_PROMPT') {\n          console.log('\\n\\n👋 Setup cancelled.');\n          process.exit(0);\n        }\n        throw error;\n      }\n    });\n\n  return cmd;\n}\n\ntype OnboardOptions = {\n  model?: boolean;\n  channels?: boolean;\n  gateway?: boolean;\n  all?: boolean;\n};\n\nasync function runOnboard(\n  options: OnboardOptions,\n  ctx: CLIContext\n): Promise<void> {\n  console.log(colors.cyan('\\n🚀 Welcome to xopc setup!\\n'));\n  console.log('═'.repeat(50));\n\n  const workspacePath = ctx.workspacePath;\n  const configPath = ctx.configPath;\n\n  const initResult = await initWorkspace({ configPath, workspacePath });\n  let config = initResult.config;\n\n  // Determine what to configure based on options\n  const doModel = options.model || options.all || (!options.channels && !options.gateway);\n  const doChannels = options.channels || options.all || (!options.model && !options.gateway);\n  const doGateway = options.gateway || options.all || (!options.model && !options.channels);\n  const runFullWizard = !options.model && !options.channels && !options.gateway;\n  /** Any setup step besides the unified launch prompt ran in interactive flow. */\n  const didConfigurableSteps = doModel || doChannels || doGateway;\n\n  if (!isInteractive()) {\n    // Non-interactive mode\n    if (doModel) {\n      config = await setupNonInteractive(configPath, config);\n    }\n    if (doChannels) {\n      console.log('\\n💬 Channels Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure channels, edit the config file manually.');\n    }\n    if (doGateway) {\n      console.log('\\n🌐 Gateway Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure gateway, edit the config file manually.');\n    }\n  } else {\n    // Interactive mode\n    if (doModel) {\n      config = await runModelSetup(config, ctx);\n    }\n\n    if (doChannels) {\n      const channelIds = getChannelConfigurators().map(c => c.id);\n      console.log(colors.gray(`\\nChannel onboarding: ${channelIds.join(', ')}\\n`));\n      config = await runChannelOnboard(config);\n    }\n\n    if (doGateway) {\n      config = await setupGateway(config);\n    }\n  }\n\n  // Save config once at the end\n  await saveConfig(config as Config, configPath);\n\n  seedMainAgentBootstrap(config as Config);\n\n  console.log('\\n' + '═'.repeat(50));\n  console.log('\\n🎉 Setup Complete!\\n');\n\n  const gatewayAuth = (config as any)?.gateway?.auth;\n  const gatewayConfigured =\n    gatewayAuth?.mode === 'token' &&\n    typeof gatewayAuth?.token === 'string' &&\n    gatewayAuth.token.length > 0;\n  const host = (config as any)?.gateway?.host || '0.0.0.0';\n  const port = (config as any)?.gateway?.port ?? 18790;\n  const displayHost = host === '0.0.0.0' ? 'localhost' : host;\n  const gwToken = gatewayConfigured ? (gatewayAuth.token as string) : undefined;\n\n  const showGatewaySummary = Boolean(gatewayConfigured && gwToken && (doGateway || runFullWizard));\n\n  if (showGatewaySummary && gwToken) {\n    const webuiUrl = `http://${displayHost}:${port}?token=${gwToken}`;\n    console.log('🌐 Web console (browser) — start here');\n    console.log(`   Open: http://${displayHost}:${port}`);\n    console.log(`   Token: ${gwToken.slice(0, 8)}...${gwToken.slice(-8)}`);\n    console.log('   Bookmark link (token is saved in the browser when you open it):');\n    console.log(`   ${webuiUrl}`);\n    console.log('');\n  }\n\n  if (runFullWizard) {\n    console.log('🚀 Next steps:');\n    if (gatewayConfigured) {\n      console.log('  1. Choose how to launch below (gateway or terminal UI)');\n      console.log('  2. Or chat with: xopc agent -i');\n      console.log('  3. Optional: read BOOTSTRAP.md in your workspace for workspace tips');\n    } else {\n      console.log('  1. Chat in the terminal: xopc agent -i');\n      console.log('  2. Optional: add the Web console: xopc onboard --gateway');\n      console.log('  3. Optional: read BOOTSTRAP.md in your workspace');\n    }\n    console.log('');\n  } else if (doGateway && gatewayConfigured) {\n    console.log('🚀 Next step:');\n    console.log('  Start the gateway if it is not running, then open the Web console URL above.');\n    console.log('');\n  }\n\n  console.log('📝 Usage:');\n  console.log('  xopc agent -m \"Hello\"    # Chat with AI');\n  console.log('  xopc agent -i            # Interactive mode');\n  console.log('  xopc models list         # List models');\n  console.log('  xopc auth list           # View authentication');\n\n  console.log('\\n📁 Files:');\n  console.log('  Config:', configPath);\n  console.log('  Workspace:', workspacePath);\n  if (runFullWizard) {\n    console.log('  Bootstrap:', join(workspacePath, 'BOOTSTRAP.md'));\n  }\n\n  if (isInteractive() && didConfigurableSteps) {\n    await promptLaunchAfterOnboard(config as Config, ctx, { doChannels });\n  }\n\n  process.exit(0);\n}\n\nasync function startGatewayInBackground(config: Config, ctx: CLIContext): Promise<void> {\n  const host = (config as { gateway?: { host?: string } }).gateway?.host ?? '127.0.0.1';\n  const port = (config as { gateway?: { port?: number } }).gateway?.port ?? 18790;\n  const displayHost = host === '0.0.0.0' ? 'localhost' : host;\n\n  let isRunning = false;\n  try {\n    const lock = await acquireGatewayLock(ctx.configPath, { timeoutMs: 100, port });\n    await lock.release();\n  } catch (err) {\n    if (err instanceof GatewayLockError) {\n      isRunning = true;\n    }\n  }\n\n  if (isRunning) {\n    console.log('\\n🌐 Gateway is already running!');\n    console.log(`   URL: http://${displayHost}:${port}`);\n    console.log('');\n    console.log('📝 To apply the new configuration, restart gateway:');\n    console.log('   xopc gateway restart');\n  } else {\n    console.log('\\n🚀 Starting Gateway WebUI in background...');\n    console.log('');\n\n    const { spawn } = await import('child_process');\n    const args = [\n      ...process.execArgv,\n      ...process.argv.slice(1).filter((arg) => !arg.includes('onboard') && arg !== '--quick'),\n      'gateway',\n      '--background',\n      '--host',\n      host,\n      '--port',\n      String(port),\n    ];\n\n    const child = spawn(process.execPath, args, {\n      detached: true,\n      stdio: 'ignore',\n      env: process.env,\n    });\n\n    child.unref();\n\n    await new Promise((resolve) => setTimeout(resolve, 500));\n\n    if (child.pid && !child.killed) {\n      console.log('✅ Gateway started in background');\n      console.log(`   PID: ${child.pid}`);\n      console.log(`   URL: http://${displayHost}:${port}`);\n      const token = (config as { gateway?: { auth?: { token?: string } } }).gateway?.auth?.token;\n      if (token) {\n        console.log(`   Token: ${token.slice(0, 8)}...${token.slice(-8)}`);\n      }\n    } else {\n      console.log('⚠️  Failed to start gateway automatically.');\n      console.log('   Start manually with:');\n      console.log('   xopc gateway --background');\n    }\n  }\n\n  console.log('');\n  console.log('📚 Useful commands:');\n  console.log('   xopc gateway status    # Check gateway status');\n  console.log('   xopc gateway stop      # Stop gateway');\n  console.log('   xopc gateway restart   # Restart gateway');\n  console.log('   xopc gateway logs      # View logs');\n}\n\nasync function promptLaunchAfterOnboard(\n  config: Config,\n  ctx: CLIContext,\n  flags: { doChannels: boolean },\n): Promise<void> {\n  console.log('');\n  const choice = await select<'tui' | 'gateway' | 'none'>({\n    message: 'How do you want to launch xopc now?',\n    choices: [\n      {\n        value: 'tui',\n        name: 'Terminal UI (embedded)',\n        description: 'xopc tui --local — no gateway process required',\n      },\n      {\n        value: 'gateway',\n        name: 'Gateway WebUI (background)',\n        description: 'Start the HTTP gateway for the browser console',\n      },\n      {\n        value: 'none',\n        name: 'Exit — I will start manually',\n        description: 'Finish setup without starting a runtime',\n      },\n    ],\n    default: 'tui',\n  });\n\n  if (choice === 'gateway') {\n    await startGatewayInBackground(config, ctx);\n    return;\n  }\n\n  if (choice === 'tui') {\n    if (flags.doChannels && !isWeixinOnboardConfigured(config)) {\n      console.log(\n        colors.gray(\n          '\\n💡 Weixin is not logged in yet. When ready run: xopc channels login --channel weixin\\n',\n        ),\n      );\n    }\n    const { runTui } = await import('../../tui/tui.js');\n    await runTui({ local: true });\n    return;\n  }\n\n  console.log('\\n⏭️  You can start later:');\n  console.log('   xopc gateway --background');\n  console.log('   xopc tui --local');\n}\n\nasync function setupGateway(config: Config): Promise<Config> {\n  console.log(colors.cyan('\\n🌐 Gateway WebUI\\n'));\n  console.log(\n    colors.gray(\n      'Applying defaults from config schema (127.0.0.1:18790, token auth; token generated if missing).\\n',\n    ),\n  );\n\n  const gw = config.gateway ?? {};\n  const { randomBytes } = await import('node:crypto');\n  const authMode = gw.auth?.mode === 'none' ? ('none' as const) : ('token' as const);\n  const token =\n    authMode === 'token'\n      ? typeof gw.auth?.token === 'string' && gw.auth.token.length > 0\n        ? gw.auth.token\n        : randomBytes(24).toString('hex')\n      : undefined;\n\n  const merged: Config = {\n    ...config,\n    gateway: {\n      ...gw,\n      host: gw.host ?? '127.0.0.1',\n      port: gw.port ?? 18790,\n      auth:\n        authMode === 'none'\n          ? { mode: 'none' as const }\n          : { mode: 'token' as const, token: token! },\n    },\n  };\n\n  const parsed = ConfigSchema.parse(merged);\n  console.log('✅ Gateway defaults applied.\\n');\n  return parsed;\n}\n\nregister({\n  id: 'onboard',\n  name: 'onboard',\n  description: 'Interactive setup wizard',\n  factory: createOnboardCommand,\n  metadata: {\n    category: 'setup',\n    examples: ['xopc onboard', 'xopc onboard --model', 'xopc onboard --channels'],\n  },\n});\n"],"mappings":"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"}

package/dist/src/cli/commands/tui.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,40 @@
+import { formatExamples, register } from "../registry.js";
+import { Command } from "commander";
+//#region src/cli/commands/tui.ts
+function createTuiCommand(_ctx) {
+	return new Command("tui").description("Interactive terminal UI (pi-tui)").addHelpText("after", formatExamples([
+		"xopc tui                                    # Connect to local gateway (default)",
+		"xopc tui --local                            # Embedded mode, no gateway needed",
+		"xopc tui --url http://host:3120 --token xxx # Connect to remote gateway",
+		"xopc tui -s telegram:dm:123456              # Resume a session",
+		"xopc tui -m \"Summarize my inbox\"            # Send a message on launch"
+	])).option("--url <url>", "Gateway URL (default: http://localhost:3120)").option("--token <token>", "Gateway bearer token").option("-s, --session <key>", "Session key to resume").option("-m, --message <text>", "Send a message on launch").option("--local", "Run in embedded mode (no gateway required)").option("--thinking <level>", "Thinking level override").action(async (options) => {
+		const { runTui } = await import("../../tui/tui.js");
+		await runTui({
+			url: typeof options.url === "string" ? options.url : void 0,
+			token: typeof options.token === "string" ? options.token : void 0,
+			session: typeof options.session === "string" ? options.session : void 0,
+			message: typeof options.message === "string" ? options.message : void 0,
+			local: options.local === true,
+			thinking: typeof options.thinking === "string" ? options.thinking : void 0
+		});
+	});
+}
+register({
+	id: "tui",
+	name: "tui",
+	description: "Interactive terminal UI (pi-tui)",
+	factory: createTuiCommand,
+	metadata: {
+		category: "runtime",
+		examples: [
+			"xopc tui",
+			"xopc tui --local",
+			"xopc tui --url http://host:3120"
+		]
+	}
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=tui.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","names":[],"sources":["../../../../src/cli/commands/tui.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { register, formatExamples, type CLIContext } from '../registry.js';\n\nfunction createTuiCommand(_ctx: CLIContext): Command {\n  const cmd = new Command('tui')\n    .description('Interactive terminal UI (pi-tui)')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc tui                                    # Connect to local gateway (default)',\n        'xopc tui --local                            # Embedded mode, no gateway needed',\n        'xopc tui --url http://host:3120 --token xxx # Connect to remote gateway',\n        'xopc tui -s telegram:dm:123456              # Resume a session',\n        'xopc tui -m \"Summarize my inbox\"            # Send a message on launch',\n      ]),\n    )\n    .option('--url <url>', 'Gateway URL (default: http://localhost:3120)')\n    .option('--token <token>', 'Gateway bearer token')\n    .option('-s, --session <key>', 'Session key to resume')\n    .option('-m, --message <text>', 'Send a message on launch')\n    .option('--local', 'Run in embedded mode (no gateway required)')\n    .option('--thinking <level>', 'Thinking level override')\n    .action(async (options: Record<string, string | boolean | undefined>) => {\n      const { runTui } = await import('../../tui/tui.js');\n      await runTui({\n        url: typeof options.url === 'string' ? options.url : undefined,\n        token: typeof options.token === 'string' ? options.token : undefined,\n        session: typeof options.session === 'string' ? options.session : undefined,\n        message: typeof options.message === 'string' ? options.message : undefined,\n        local: options.local === true,\n        thinking: typeof options.thinking === 'string' ? options.thinking : undefined,\n      });\n    });\n\n  return cmd;\n}\n\nregister({\n  id: 'tui',\n  name: 'tui',\n  description: 'Interactive terminal UI (pi-tui)',\n  factory: createTuiCommand,\n  metadata: {\n    category: 'runtime',\n    examples: [\n      'xopc tui',\n      'xopc tui --local',\n      'xopc tui --url http://host:3120',\n    ],\n  },\n});\n"],"mappings":";;;AAIA,SAAS,iBAAiB,MAA2B;AA+BnD,QA9BY,IAAI,QAAQ,MAAM,CAC3B,YAAY,mCAAmC,CAC/C,YACC,SACA,eAAe;EACb;EACA;EACA;EACA;EACA;EACD,CAAC,CACH,CACA,OAAO,eAAe,+CAA+C,CACrE,OAAO,mBAAmB,uBAAuB,CACjD,OAAO,uBAAuB,wBAAwB,CACtD,OAAO,wBAAwB,2BAA2B,CAC1D,OAAO,WAAW,6CAA6C,CAC/D,OAAO,sBAAsB,0BAA0B,CACvD,OAAO,OAAO,YAA0D;EACvE,MAAM,EAAE,WAAW,MAAM,OAAO;AAChC,QAAM,OAAO;GACX,KAAK,OAAO,QAAQ,QAAQ,WAAW,QAAQ,MAAM,KAAA;GACrD,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ,KAAA;GAC3D,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,OAAO,QAAQ,UAAU;GACzB,UAAU,OAAO,QAAQ,aAAa,WAAW,QAAQ,WAAW,KAAA;GACrE,CAAC;GAGI;;AAGZ,SAAS;CACP,IAAI;CACJ,MAAM;CACN,aAAa;CACb,SAAS;CACT,UAAU;EACR,UAAU;EACV,UAAU;GACR;GACA;GACA;GACD;EACF;CACF,CAAC"}

package/dist/src/cli/index.d.ts

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
+import './agent-chat-log-level-preset.js';
 import { type CLIContext } from './registry.js';
 import './commands/setup.js';
 import './commands/onboard.js';
 import './commands/agent.js';
+import './commands/tui.js';
 import './commands/gateway.js';
 import './commands/session.js';
 import './commands/cron.js';

package/dist/src/cli/index.js

@@ -2,11 +2,13 @@
 import { version } from "../../package.js";
 import { flushAndClose } from "../utils/logger/shutdown.js";
 import { init_logger } from "../utils/logger.js";
+import "./agent-chat-log-level-preset.js";
 import { createDefaultContext, registry } from "./registry.js";
 import { registerExtensionCliCommands } from "./bootstrap-extensions.js";
 import "./commands/setup.js";
 import "./commands/onboard.js";
 import "./commands/agent.js";
+import "./commands/tui.js";
 import "./commands/gateway.js";
 import "./commands/session.js";
 import "./commands/cron.js";
@@ -31,15 +33,17 @@ function getContextWithOpts(argv = process.argv) {
 const LONG_RUNNING_COMMANDS = new Set([
 	"gateway",
 	"agent",
+	"tui",
 	"extension:dev"
 ]);
 const program = new Command().name("xopc").description("Ultra-Lightweight Personal AI Assistant").version(version).option("--verbose", "Enable verbose logging", false).option("--config <path>", "Config file path").option("--workspace <path>", "Workspace directory");
 program.hook("preAction", (thisCommand) => {
 	parsedOpts = thisCommand.opts();
 });
-program.hook("postAction", async (thisCommand) => {
-	const args = thisCommand.args;
-	const subCommandName = args.length > 0 ? args[0] : thisCommand.name();
+program.hook("postAction", async (_hookOwner, actionCommand) => {
+	const cmd = actionCommand ?? program;
+	const args = cmd.args;
+	const subCommandName = args.length > 0 ? args[0] : cmd.name();
 	if (LONG_RUNNING_COMMANDS.has(subCommandName)) {
 		if (subCommandName === "agent") {
 			if (!(process.argv.includes("-i") || process.argv.includes("--interactive"))) {