hyperclaw 5.0.5 → 5.0.7

package/README.md

@@ -84,24 +84,72 @@ hyperclaw onboard --install-daemon
 
 The wizard walks you through: AI provider → model → channels → skills. Done.
 
+## ▶️ Running your bot
+
 ```bash
-# After setup, start your assistant
+# Step 1 — Start the daemon (runs in the background, bot becomes active on Telegram/Discord/etc.)
 hyperclaw daemon start
 
-# Interactive terminal chat (multi-turn, streams responses)
+# Step 2 — Open the TUI dashboard to see live status, channels, logs
+hyperclaw dashboard
+
+# Step 3 — Or chat directly from your terminal (no Telegram needed)
 hyperclaw chat
+```
+
+### How it works
+
+```
+hyperclaw daemon start
+        ↓
+   Gateway  (background process)
+        ↓
+   ┌─────────────┬──────────────┐
+   │  Telegram   │  Dashboard   │
+   │  Discord    │  hyperclaw   │
+   │  WhatsApp   │  dashboard   │
+   └─────────────┴──────────────┘
+```
+
+> **The daemon must be running** for the Telegram/Discord/WhatsApp bot to answer messages and for the TUI dashboard to show "ONLINE".  
+> On **Windows** the daemon runs via Task Scheduler (no WSL, no admin).  
+> On **Linux/macOS** with `--install-daemon` it uses systemd / launchd.
+
+### Without the daemon (foreground mode)
+
+If you haven't installed the daemon, run the bot in the foreground — the terminal stays open:
 
+```bash
+# Run bot in foreground (Ctrl+C to stop)
+hyperclaw start
+
+# In a second terminal, open the dashboard
+hyperclaw dashboard
+```
+
+### Quick reference
+
+| I want to…                              | Command                    |
+|-----------------------------------------|----------------------------|
+| Start Telegram/Discord bot (background) | `hyperclaw daemon start`   |
+| Stop the bot                            | `hyperclaw daemon stop`    |
+| Check if running                        | `hyperclaw daemon status`  |
+| Open TUI dashboard                      | `hyperclaw dashboard`      |
+| Chat from terminal (no Telegram needed) | `hyperclaw chat`           |
+| Run in foreground (no daemon)           | `hyperclaw start`          |
+| Health check                            | `hyperclaw doctor`         |
+
+```bash
 # Send a single message (non-interactive)
 hyperclaw agent --message "What can you do?"
-
-# Health check
-hyperclaw doctor
 ```
 
 > **Windows**: No WSL2, no admin rights needed. The daemon uses Task Scheduler and runs as your account.
 
 > **Linux**: If you get an `EACCES: permission denied` error during `npm install -g`, see the [Linux install fix](#-linux-permission-fix) below.
 
+> **Emojis not showing?** See the [Terminal emoji fix](#-emojis-not-showing-in-terminal) below.
+
 <details>
 <summary>More install options</summary>
 
@@ -198,6 +246,65 @@ sudo npm install -g hyperclaw@latest
 
 </details>
 
+<details>
+<summary id="-emojis-not-showing-in-terminal">🎨 Emojis not showing in terminal (showing as ?? or □)</summary>
+
+HyperClaw uses emojis in its banner and wizard. If you see `??` or empty boxes, your terminal or font doesn't support emoji rendering.
+
+---
+
+### 🪟 Windows — CMD / PowerShell
+
+The old `cmd.exe` and classic PowerShell window do **not** support emoji.
+
+**Fix: Use Windows Terminal** (free, from Microsoft Store):
+
+1. Open **Microsoft Store** → search **"Windows Terminal"** → Install
+2. Open Windows Terminal → Settings → Profiles → Defaults → Appearance
+3. Set font to **Cascadia Code** (already included) or install [JetBrains Mono Nerd Font](https://www.nerdfonts.com/font-downloads)
+4. Run `hyperclaw onboard` from Windows Terminal — emojis will show correctly
+
+---
+
+### 🐧 Linux — XFCE / Konsole / other terminals
+
+Install the Google Noto emoji font:
+
+```bash
+# Debian / Ubuntu / Kali
+sudo apt install fonts-noto-color-emoji
+
+# Arch / Manjaro
+sudo pacman -S noto-fonts-emoji
+
+# Fedora / RHEL
+sudo dnf install google-noto-emoji-fonts
+```
+
+Then **restart your terminal** — emojis will appear.
+
+> If you use **XFCE Terminal**: go to Edit → Preferences → Appearance and set a font like **JetBrains Mono** or **DejaVu Sans Mono**.
+
+---
+
+### 🍎 macOS — Terminal.app
+
+macOS Terminal.app supports emoji out of the box on recent versions. If you still see `?`:
+
+1. Terminal → Settings → Profiles → Text → Change Font
+2. Set to **Menlo**, **SF Mono**, or any font from [Nerd Fonts](https://www.nerdfonts.com/)
+3. Alternatively, use **iTerm2** (free) which has full emoji support by default
+
+```bash
+brew install --cask iterm2
+```
+
+---
+
+> **Note**: If you prefer to keep using your current terminal without emoji, HyperClaw works perfectly — only the visual display is affected, not the functionality.
+
+</details>
+
 ---
 
 ## Channels
@@ -519,6 +626,7 @@ Example — ask the agent:
 "Create a note in Obsidian: Meeting notes..."
 "Add a card to my Trello board"
 "Set my 8Sleep to temperature 20 on the left side"
+
 "Get my GitHub password from 1Password"
 "Send an iMessage to +1234567890: I'll be late"
 "What's playing on my Sonos?"

package/dist/chat-C7Jwz6dG.js

@@ -0,0 +1,261 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+require('./browser-tools-JZ9ji6AW.js');
+require('./src-CGQjRI4N.js');
+const require_engine = require('./engine-hWJ1H1iP.js');
+require('./extraction-tools-Dg7AHS35.js');
+const require_inference = require('./inference-DhA8jpfH.js');
+require('./memory-auto-D-L2q21G.js');
+require('./orchestrator-TGesUBGZ.js');
+require('./pc-access-B0KocJNe.js');
+require('./session-store-DCTQIVur.js');
+require('./sessions-tools-BdlN6Pb6.js');
+require('./skill-loader-Wf3brNOj.js');
+require('./skill-runtime-Z8OhW4eX.js');
+require('./vision-tools-dwn9p4el.js');
+require('./website-watch-tools-B-jRAeTe.js');
+const require_src$1 = require('./src-3S81Pvdb.js');
+const chalk = require_chunk.__toESM(require("chalk"));
+const ora = require_chunk.__toESM(require("ora"));
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const readline = require_chunk.__toESM(require("readline"));
+
+//#region src/cli/chat.ts
+require_src$1.init_src();
+const DIVIDER = chalk.default.gray("  " + "─".repeat(56));
+function printHeader(model, sessionId) {
+	console.log();
+	console.log(DIVIDER);
+	console.log(chalk.default.bold.cyan("  🦅 HYPERCLAW CHAT"));
+	console.log(chalk.default.gray(`  Model: ${model}  ·  Session: ${sessionId}`));
+	console.log(DIVIDER);
+	console.log(chalk.default.gray("  Type your message and press Enter."));
+	console.log(chalk.default.gray("  Commands: /exit  /clear  /model  /skills  /help"));
+	console.log(DIVIDER);
+	console.log();
+}
+function printHelp() {
+	console.log();
+	console.log(chalk.default.bold("  Commands:"));
+	console.log(`  ${chalk.default.cyan("/exit")}    — quit the chat`);
+	console.log(`  ${chalk.default.cyan("/clear")}   — clear conversation history`);
+	console.log(`  ${chalk.default.cyan("/model")}   — show current model`);
+	console.log(`  ${chalk.default.cyan("/skills")}  — list installed skills + how to add more`);
+	console.log(`  ${chalk.default.cyan("/help")}    — show this help`);
+	console.log();
+	console.log(chalk.default.gray("  Tip: you can also tell the agent to install a skill:"));
+	console.log(chalk.default.gray("  \"Install the web-search skill\" or paste a clawhub.ai link"));
+	console.log();
+}
+async function printSkills() {
+	console.log();
+	try {
+		const { loadSkills } = await Promise.resolve().then(() => require("./skill-loader-B5oeliGu.js"));
+		const skills = await loadSkills();
+		if (skills.length === 0) console.log(chalk.default.gray("  No skills installed yet."));
+		else {
+			console.log(chalk.default.bold("  Installed skills:"));
+			for (const s of skills) {
+				console.log(`  ${chalk.default.cyan("•")} ${chalk.default.bold(s.title || s.id)} ${chalk.default.gray(`(${s.id})`)}`);
+				if (s.capabilities) console.log(chalk.default.gray(`    ${s.capabilities}`));
+			}
+		}
+	} catch {
+		console.log(chalk.default.gray("  Could not load skills list."));
+	}
+	console.log();
+	console.log(chalk.default.bold("  How to add a skill:"));
+	console.log(`  ${chalk.default.gray("1.")} Tell the agent: ${chalk.default.cyan("\"Install the web-search skill\"")}`);
+	console.log(`  ${chalk.default.gray("2.")} Paste a link: ${chalk.default.cyan("\"Install this: https://clawhub.ai/user/skill-name\"")}`);
+	console.log(`  ${chalk.default.gray("3.")} CLI (outside chat): ${chalk.default.cyan("hyperclaw skill install <name>")}`);
+	console.log(`  ${chalk.default.gray("4.")} Re-run wizard:      ${chalk.default.cyan("hyperclaw onboard")}`);
+	console.log();
+}
+function makeSessionId() {
+	return Math.random().toString(36).slice(2, 9);
+}
+async function runChat(opts) {
+	const cfg = await fs_extra.default.readJson(require_paths.getConfigPath()).catch(() => null);
+	if (!cfg) {
+		console.log(chalk.default.red("\n  No configuration found. Run: hyperclaw onboard\n"));
+		return;
+	}
+	const { getProviderCredentialAsync } = await Promise.resolve().then(() => require("./env-resolve-bDYssfih.js"));
+	const apiKey = await getProviderCredentialAsync(cfg).catch(() => null);
+	const isLocal = [
+		"local",
+		"ollama",
+		"lmstudio"
+	].includes(cfg?.provider?.providerId ?? "");
+	if (!apiKey && !isLocal) {
+		console.log(chalk.default.red("\n  No API key configured. Run: hyperclaw config set-key\n"));
+		return;
+	}
+	const { getProvider } = await Promise.resolve().then(() => require("./providers-DxiamZSL.js"));
+	const providerMeta = getProvider(cfg?.provider?.providerId ?? "");
+	const CUSTOM_IDS = new Set([
+		"groq",
+		"mistral",
+		"deepseek",
+		"perplexity",
+		"huggingface",
+		"ollama",
+		"lmstudio",
+		"local",
+		"xai",
+		"openai",
+		"google",
+		"minimax",
+		"moonshot",
+		"qwen",
+		"zai",
+		"litellm",
+		"cloudflare",
+		"copilot",
+		"vercel-ai",
+		"opencode-zen"
+	]);
+	const isAnthropicVariant = [
+		"anthropic",
+		"anthropic-oauth",
+		"anthropic-setup-token"
+	].includes(cfg?.provider?.providerId ?? "");
+	const provider = isAnthropicVariant ? "anthropic" : cfg?.provider?.providerId === "custom" || isLocal || CUSTOM_IDS.has(cfg?.provider?.providerId ?? "") ? "custom" : "openrouter";
+	const rawModel = opts.model || cfg?.provider?.modelId || "claude-sonnet-4-5";
+	const model = rawModel.startsWith("ollama/") ? rawModel.slice(7) : rawModel;
+	const resolvedBaseUrl = cfg?.provider?.baseUrl || providerMeta?.baseUrl || (isLocal ? "http://localhost:11434/v1" : void 0);
+	const THINKING_BUDGET = {
+		high: 1e4,
+		medium: 4e3,
+		low: 1e3,
+		none: 0
+	};
+	const thinkingBudget = THINKING_BUDGET[opts.thinking ?? "none"] ?? 0;
+	const maxTokens = thinkingBudget > 0 ? thinkingBudget + 4096 : 4096;
+	const context = await require_engine.loadWorkspaceContext(opts.workspace) + await require_engine.loadSkillsContext();
+	const tools = await require_engine.resolveTools({
+		config: cfg,
+		source: "cli",
+		elevated: true,
+		daemonMode: false
+	});
+	const engineOpts = {
+		model,
+		apiKey,
+		provider,
+		system: context || void 0,
+		tools,
+		maxTokens,
+		onToken: () => {},
+		...provider === "custom" ? { baseUrl: resolvedBaseUrl || "" } : {},
+		...thinkingBudget > 0 && model.includes("claude") ? { thinking: { budget_tokens: thinkingBudget } } : {}
+	};
+	const sessionId = opts.sessionId ?? makeSessionId();
+	const messages = [];
+	printHeader(rawModel, sessionId);
+	const rl = readline.default.createInterface({
+		input: process.stdin,
+		output: process.stdout,
+		terminal: true
+	});
+	rl.on("SIGINT", () => {
+		console.log(chalk.default.gray("\n\n  Bye!\n"));
+		rl.close();
+		process.exit(0);
+	});
+	await new Promise((resolve) => {
+		rl.on("close", resolve);
+		const prompt = () => {
+			rl.question(chalk.default.bold.green("  You › "), async (input) => {
+				const text = input.trim();
+				if (!text) {
+					prompt();
+					return;
+				}
+				if ([
+					"/exit",
+					"/quit",
+					"/bye",
+					"exit",
+					"quit",
+					"bye"
+				].includes(text.toLowerCase())) {
+					console.log(chalk.default.gray("\n  Bye!\n"));
+					rl.close();
+					process.exit(0);
+				}
+				if (text === "/help") {
+					printHelp();
+					prompt();
+					return;
+				}
+				if (text === "/skills") {
+					await printSkills();
+					prompt();
+					return;
+				}
+				if (text === "/model") {
+					console.log(chalk.default.gray(`\n  Model: ${rawModel}\n`));
+					prompt();
+					return;
+				}
+				if (text === "/clear") {
+					messages.length = 0;
+					console.log(chalk.default.gray("\n  Conversation cleared.\n"));
+					prompt();
+					return;
+				}
+				messages.push({
+					role: "user",
+					content: text
+				});
+				const spinner = (0, ora.default)({
+					text: chalk.default.gray("Thinking..."),
+					color: "cyan",
+					prefixText: "  "
+				}).start();
+				let responseText = "";
+				try {
+					const engine = new require_inference.InferenceEngine({
+						...engineOpts,
+						onToken: (token) => {
+							if (spinner.isSpinning) spinner.stop();
+							process.stdout.write(token);
+						},
+						onToolCall: (name) => {
+							if (spinner.isSpinning) spinner.stop();
+							console.log(chalk.default.gray(`\n  [tool: ${name}]`));
+						}
+					});
+					spinner.stop();
+					process.stdout.write(chalk.default.bold.blue("\n  Agent › "));
+					const result = await engine.run(messages);
+					responseText = result.text || "";
+					if (!responseText && !result.text) process.stdout.write(chalk.default.gray("(empty)"));
+					console.log("\n");
+					if (result.usage) console.log(chalk.default.gray(`  Tokens — in: ${result.usage.input}  out: ${result.usage.output}\n`));
+				} catch (e) {
+					spinner.stop();
+					responseText = `Error: ${e.message}`;
+					console.log(chalk.default.red(`\n  Error: ${e.message}\n`));
+				}
+				if (responseText) messages.push({
+					role: "assistant",
+					content: responseText
+				});
+				try {
+					const { AutoMemory } = await Promise.resolve().then(() => require("./memory-auto-DTcy5VBy.js"));
+					const mem = new AutoMemory({ extractEveryNTurns: 3 });
+					mem.addTurn("user", text);
+					if (responseText) mem.addTurn("assistant", responseText);
+					mem.extract().catch(() => {});
+				} catch {}
+				prompt();
+			});
+		};
+		prompt();
+	});
+}
+
+//#endregion
+exports.runChat = runChat;

package/dist/chat-CjZKt5Sa.js

@@ -0,0 +1,261 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+require('./browser-tools-JZ9ji6AW.js');
+require('./src-CGQjRI4N.js');
+const require_engine = require('./engine-DwMKOfwf.js');
+require('./extraction-tools-Dg7AHS35.js');
+const require_inference = require('./inference-DhA8jpfH.js');
+require('./memory-auto-D-L2q21G.js');
+require('./orchestrator-Dr-Kx8Sj.js');
+require('./pc-access-B0KocJNe.js');
+require('./session-store-DCTQIVur.js');
+require('./sessions-tools-BdlN6Pb6.js');
+require('./skill-loader-Wf3brNOj.js');
+require('./skill-runtime-BxRuz-SL.js');
+require('./vision-tools-dwn9p4el.js');
+require('./website-watch-tools-B-jRAeTe.js');
+const require_src$1 = require('./src-CcX1rZa1.js');
+const chalk = require_chunk.__toESM(require("chalk"));
+const ora = require_chunk.__toESM(require("ora"));
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const readline = require_chunk.__toESM(require("readline"));
+
+//#region src/cli/chat.ts
+require_src$1.init_src();
+const DIVIDER = chalk.default.gray("  " + "─".repeat(56));
+function printHeader(model, sessionId) {
+	console.log();
+	console.log(DIVIDER);
+	console.log(chalk.default.bold.cyan("  🦅 HYPERCLAW CHAT"));
+	console.log(chalk.default.gray(`  Model: ${model}  ·  Session: ${sessionId}`));
+	console.log(DIVIDER);
+	console.log(chalk.default.gray("  Type your message and press Enter."));
+	console.log(chalk.default.gray("  Commands: /exit  /clear  /model  /skills  /help"));
+	console.log(DIVIDER);
+	console.log();
+}
+function printHelp() {
+	console.log();
+	console.log(chalk.default.bold("  Commands:"));
+	console.log(`  ${chalk.default.cyan("/exit")}    — quit the chat`);
+	console.log(`  ${chalk.default.cyan("/clear")}   — clear conversation history`);
+	console.log(`  ${chalk.default.cyan("/model")}   — show current model`);
+	console.log(`  ${chalk.default.cyan("/skills")}  — list installed skills + how to add more`);
+	console.log(`  ${chalk.default.cyan("/help")}    — show this help`);
+	console.log();
+	console.log(chalk.default.gray("  Tip: you can also tell the agent to install a skill:"));
+	console.log(chalk.default.gray("  \"Install the web-search skill\" or paste a clawhub.ai link"));
+	console.log();
+}
+async function printSkills() {
+	console.log();
+	try {
+		const { loadSkills } = await Promise.resolve().then(() => require("./skill-loader-B5oeliGu.js"));
+		const skills = await loadSkills();
+		if (skills.length === 0) console.log(chalk.default.gray("  No skills installed yet."));
+		else {
+			console.log(chalk.default.bold("  Installed skills:"));
+			for (const s of skills) {
+				console.log(`  ${chalk.default.cyan("•")} ${chalk.default.bold(s.title || s.id)} ${chalk.default.gray(`(${s.id})`)}`);
+				if (s.capabilities) console.log(chalk.default.gray(`    ${s.capabilities}`));
+			}
+		}
+	} catch {
+		console.log(chalk.default.gray("  Could not load skills list."));
+	}
+	console.log();
+	console.log(chalk.default.bold("  How to add a skill:"));
+	console.log(`  ${chalk.default.gray("1.")} Tell the agent: ${chalk.default.cyan("\"Install the web-search skill\"")}`);
+	console.log(`  ${chalk.default.gray("2.")} Paste a link: ${chalk.default.cyan("\"Install this: https://clawhub.ai/user/skill-name\"")}`);
+	console.log(`  ${chalk.default.gray("3.")} CLI (outside chat): ${chalk.default.cyan("hyperclaw skill install <name>")}`);
+	console.log(`  ${chalk.default.gray("4.")} Re-run wizard:      ${chalk.default.cyan("hyperclaw onboard")}`);
+	console.log();
+}
+function makeSessionId() {
+	return Math.random().toString(36).slice(2, 9);
+}
+async function runChat(opts) {
+	const cfg = await fs_extra.default.readJson(require_paths.getConfigPath()).catch(() => null);
+	if (!cfg) {
+		console.log(chalk.default.red("\n  No configuration found. Run: hyperclaw onboard\n"));
+		return;
+	}
+	const { getProviderCredentialAsync } = await Promise.resolve().then(() => require("./env-resolve-bDYssfih.js"));
+	const apiKey = await getProviderCredentialAsync(cfg).catch(() => null);
+	const isLocal = [
+		"local",
+		"ollama",
+		"lmstudio"
+	].includes(cfg?.provider?.providerId ?? "");
+	if (!apiKey && !isLocal) {
+		console.log(chalk.default.red("\n  No API key configured. Run: hyperclaw config set-key\n"));
+		return;
+	}
+	const { getProvider } = await Promise.resolve().then(() => require("./providers-DxiamZSL.js"));
+	const providerMeta = getProvider(cfg?.provider?.providerId ?? "");
+	const CUSTOM_IDS = new Set([
+		"groq",
+		"mistral",
+		"deepseek",
+		"perplexity",
+		"huggingface",
+		"ollama",
+		"lmstudio",
+		"local",
+		"xai",
+		"openai",
+		"google",
+		"minimax",
+		"moonshot",
+		"qwen",
+		"zai",
+		"litellm",
+		"cloudflare",
+		"copilot",
+		"vercel-ai",
+		"opencode-zen"
+	]);
+	const isAnthropicVariant = [
+		"anthropic",
+		"anthropic-oauth",
+		"anthropic-setup-token"
+	].includes(cfg?.provider?.providerId ?? "");
+	const provider = isAnthropicVariant ? "anthropic" : cfg?.provider?.providerId === "custom" || isLocal || CUSTOM_IDS.has(cfg?.provider?.providerId ?? "") ? "custom" : "openrouter";
+	const rawModel = opts.model || cfg?.provider?.modelId || "claude-sonnet-4-5";
+	const model = rawModel.startsWith("ollama/") ? rawModel.slice(7) : rawModel;
+	const resolvedBaseUrl = cfg?.provider?.baseUrl || providerMeta?.baseUrl || (isLocal ? "http://localhost:11434/v1" : void 0);
+	const THINKING_BUDGET = {
+		high: 1e4,
+		medium: 4e3,
+		low: 1e3,
+		none: 0
+	};
+	const thinkingBudget = THINKING_BUDGET[opts.thinking ?? "none"] ?? 0;
+	const maxTokens = thinkingBudget > 0 ? thinkingBudget + 4096 : 4096;
+	const context = await require_engine.loadWorkspaceContext(opts.workspace) + await require_engine.loadSkillsContext();
+	const tools = await require_engine.resolveTools({
+		config: cfg,
+		source: "cli",
+		elevated: true,
+		daemonMode: false
+	});
+	const engineOpts = {
+		model,
+		apiKey,
+		provider,
+		system: context || void 0,
+		tools,
+		maxTokens,
+		onToken: () => {},
+		...provider === "custom" ? { baseUrl: resolvedBaseUrl || "" } : {},
+		...thinkingBudget > 0 && model.includes("claude") ? { thinking: { budget_tokens: thinkingBudget } } : {}
+	};
+	const sessionId = opts.sessionId ?? makeSessionId();
+	const messages = [];
+	printHeader(rawModel, sessionId);
+	const rl = readline.default.createInterface({
+		input: process.stdin,
+		output: process.stdout,
+		terminal: true
+	});
+	rl.on("SIGINT", () => {
+		console.log(chalk.default.gray("\n\n  Bye!\n"));
+		rl.close();
+		process.exit(0);
+	});
+	await new Promise((resolve) => {
+		rl.on("close", resolve);
+		const prompt = () => {
+			rl.question(chalk.default.bold.green("  You › "), async (input) => {
+				const text = input.trim();
+				if (!text) {
+					prompt();
+					return;
+				}
+				if ([
+					"/exit",
+					"/quit",
+					"/bye",
+					"exit",
+					"quit",
+					"bye"
+				].includes(text.toLowerCase())) {
+					console.log(chalk.default.gray("\n  Bye!\n"));
+					rl.close();
+					process.exit(0);
+				}
+				if (text === "/help") {
+					printHelp();
+					prompt();
+					return;
+				}
+				if (text === "/skills") {
+					await printSkills();
+					prompt();
+					return;
+				}
+				if (text === "/model") {
+					console.log(chalk.default.gray(`\n  Model: ${rawModel}\n`));
+					prompt();
+					return;
+				}
+				if (text === "/clear") {
+					messages.length = 0;
+					console.log(chalk.default.gray("\n  Conversation cleared.\n"));
+					prompt();
+					return;
+				}
+				messages.push({
+					role: "user",
+					content: text
+				});
+				const spinner = (0, ora.default)({
+					text: chalk.default.gray("Thinking..."),
+					color: "cyan",
+					prefixText: "  "
+				}).start();
+				let responseText = "";
+				try {
+					const engine = new require_inference.InferenceEngine({
+						...engineOpts,
+						onToken: (token) => {
+							if (spinner.isSpinning) spinner.stop();
+							process.stdout.write(token);
+						},
+						onToolCall: (name) => {
+							if (spinner.isSpinning) spinner.stop();
+							console.log(chalk.default.gray(`\n  [tool: ${name}]`));
+						}
+					});
+					spinner.stop();
+					process.stdout.write(chalk.default.bold.blue("\n  Agent › "));
+					const result = await engine.run(messages);
+					responseText = result.text || "";
+					if (!responseText && !result.text) process.stdout.write(chalk.default.gray("(empty)"));
+					console.log("\n");
+					if (result.usage) console.log(chalk.default.gray(`  Tokens — in: ${result.usage.input}  out: ${result.usage.output}\n`));
+				} catch (e) {
+					spinner.stop();
+					responseText = `Error: ${e.message}`;
+					console.log(chalk.default.red(`\n  Error: ${e.message}\n`));
+				}
+				if (responseText) messages.push({
+					role: "assistant",
+					content: responseText
+				});
+				try {
+					const { AutoMemory } = await Promise.resolve().then(() => require("./memory-auto-DTcy5VBy.js"));
+					const mem = new AutoMemory({ extractEveryNTurns: 3 });
+					mem.addTurn("user", text);
+					if (responseText) mem.addTurn("assistant", responseText);
+					mem.extract().catch(() => {});
+				} catch {}
+				prompt();
+			});
+		};
+		prompt();
+	});
+}
+
+//#endregion
+exports.runChat = runChat;