hyperclaw 5.2.1 → 5.2.2

package/README.md

@@ -1,3 +1,4 @@
+<a name="top"></a>
 <div align="center">
   <img src="assets/icon.png" width="140" alt="HyperClaw">
   <h1>🦅 HyperClaw</h1>
@@ -34,6 +35,28 @@
 
 ---
 
+## 📋 Table of Contents
+
+| | |
+|---|---|
+| [Why HyperClaw?](#why-hyperclaw) | [Use cases](#use-cases) |
+| [Screenshots](#screenshots) | [🚀 Get started in 60 seconds](#-get-started-in-60-seconds) |
+| [▶️ Running your bot](#️-running-your-bot) | [Channels](#channels) |
+| [Architecture](#architecture) | [AI Models](#ai-models) |
+| [Channels](#channels) | [Configuration](#configuration) |
+| [Security defaults](#security-defaults) | [Features](#features) |
+| [Apps (optional)](#apps-optional) | [Integrations (Skills & Tools)](#integrations-skills--tools) |
+| [Agent-to-Agent](#agent-to-agent-sessions-tools) | [Terminal chat](#terminal-chat-hyperclaw-chat) |
+| [Chat commands](#chat-commands) | [SkillHub](#skillhub) |
+| [HyperClaw Bot commands](#hyperclaw-bot-commands) | [From source](#from-source) |
+| [Docker](#docker) | [Monorepo structure](#monorepo-structure) |
+| [Documentation](#documentation) | [Contributing](#contributing) |
+| [Roadmap](#roadmap) | [Changelog](#changelog) |
+| [Community](#community) | [License](#license) |
+
+<div align="right"><a href="#top">▲ Back to top</a></div>
+---
+
 ## Why HyperClaw?
 
 | Feature | HyperClaw | Cloud assistants | Self-hosted alternatives |
@@ -51,6 +74,7 @@
 | One-command wizard (`hyperclaw onboard`) | ✅ | — | ❌ |
 | OSINT / Ethical hacking mode (`hyperclaw osint`) | ✅ | ❌ | ❌ |
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Use cases
@@ -66,6 +90,129 @@
 
 > HyperClaw runs **locally on your machine** — your data, your keys, your control.
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
+
+---
+
+## Screenshots
+
+### Main banner (`hyperclaw`)
+
+<div align="center">
+  <img src="assets/screenshot-banner.png" width="700" alt="HyperClaw main banner with quick actions">
+</div>
+
+---
+
+### Setup wizard — start (`hyperclaw onboard`)
+
+<div align="center">
+  <img src="assets/screenshot-onboard-start.png" width="700" alt="HyperClaw onboard wizard start">
+</div>
+
+---
+
+### Setup wizard — AI providers
+
+<div align="center">
+  <img src="assets/screenshot-onboard-providers.png" width="700" alt="HyperClaw onboard AI provider selection">
+</div>
+
+---
+
+### Setup wizard — API key step
+
+<div align="center">
+  <img src="assets/screenshot-onboard-apikey.png" width="700" alt="HyperClaw onboard API key entry">
+</div>
+
+---
+
+### Daemon install mode (`hyperclaw onboard --install-daemon`)
+
+<div align="center">
+  <img src="assets/screenshot-onboard-daemon.png" width="700" alt="HyperClaw daemon install mode">
+</div>
+
+---
+
+### Security notice
+
+<div align="center">
+  <img src="assets/screenshot-security-notice.png" width="700" alt="HyperClaw security notice screen">
+</div>
+
+---
+
+### Theme selection
+
+<div align="center">
+  <img src="assets/screenshot-theme-select.png" width="700" alt="HyperClaw color theme selector">
+</div>
+
+---
+
+### Gateway Dashboard (`hyperclaw dashboard`)
+
+<div align="center">
+  <img src="assets/screenshot-dashboard.png" width="700" alt="HyperClaw Gateway Dashboard TUI">
+</div>
+
+> Live status, active channels, installed skills, and logs. Press `[d]` daemon · `[h]` hub · `[g]` gateway · `[m]` memory · `[q]` quit.
+
+---
+
+### Terminal chat (`hyperclaw chat`)
+
+<div align="center">
+  <img src="assets/screenshot-chat.png" width="700" alt="HyperClaw terminal chat interface">
+</div>
+
+---
+
+### All commands (`hyperclaw --help`)
+
+<div align="center">
+  <img src="assets/screenshot-help.png" width="700" alt="HyperClaw --help output showing all commands">
+</div>
+
+---
+
+### System status (`hyperclaw status`)
+
+<div align="center">
+  <img src="assets/screenshot-status.png" width="700" alt="HyperClaw status output">
+</div>
+
+---
+
+### Health check (`hyperclaw health`)
+
+<div align="center">
+  <img src="assets/screenshot-health.png" width="700" alt="HyperClaw health check output">
+</div>
+
+---
+
+### Security tools (`hyperclaw security`)
+
+<div align="center">
+  <img src="assets/screenshot-security.png" width="700" alt="HyperClaw security tools">
+</div>
+
+---
+
+### OSINT / Ethical Hacking mode (`hyperclaw osint`)
+
+<div align="center">
+  <img src="assets/screenshot-osint.png" width="700" alt="HyperClaw OSINT mode with recon, bugbounty, pentest workflows">
+</div>
+
+> Passive recon, bug bounty, pentest, digital footprint — all from your terminal.  
+> For authorized security research only.
+
+<div align="right"><a href="#top">▲ Back to top</a></div>
+
 ---
 
 ## 🚀 Get started in 60 seconds
@@ -305,6 +452,7 @@ brew install --cask iterm2
 
 </details>
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Channels
@@ -350,6 +498,7 @@ Add a channel:
 hyperclaw channels add telegram
 ```
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Architecture
@@ -374,6 +523,7 @@ Google Chat / Matrix / IRC / Mattermost / Teams / Nostr / WebChat
   OpenAI…)
 ```
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## AI Models
@@ -401,6 +551,7 @@ HyperClaw supports 20+ providers. Pick one in the wizard or set `provider.provid
 | **LM Studio** | `lmstudio` | Local models — enable local server |
 | **Custom** | `custom` | Any OpenAI-compatible `/chat/completions` |
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Configuration
@@ -475,6 +626,7 @@ Isolate DM sessions per channel/peer (useful when multiple people share one gate
 }
 ```
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Security defaults
@@ -499,6 +651,7 @@ hyperclaw security audit --json    # machine-readable output
 
 Full guide: [docs/security.md](docs/security.md)
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Features
@@ -520,6 +673,7 @@ Full guide: [docs/security.md](docs/security.md)
 - **Docker** — sandboxed agent execution, browser tools with Puppeteer
 - **Tailscale** — Serve/Funnel for remote access without port forwarding
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Apps (optional)
@@ -545,6 +699,7 @@ The Gateway alone delivers a great experience. Apps add extra features:
 - Camera, screen capture, device commands
 - Notifications, contacts, calendar, photos
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Development channels
@@ -563,6 +718,7 @@ hyperclaw update --channel dev      # moving head of main
 | `beta` | `beta` | Prerelease — new features, may have rough edges |
 | `dev` | `dev` | Latest main branch (when published) |
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Integrations (Skills & Tools)
@@ -678,6 +834,7 @@ OP_SERVICE_ACCOUNT_TOKEN=ops_xxxx
 
 All keys are stored locally in `~/.hyperclaw/.env` — never sent anywhere except the respective service.
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Agent-to-Agent (sessions tools)
@@ -695,6 +852,7 @@ Example — ask the agent:
 "List all connected sessions and send a briefing to the first one"
 ```
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Terminal chat (`hyperclaw chat`)
@@ -720,6 +878,7 @@ hyperclaw chat --model claude-opus-4-6  # override model
 
 Responses stream token-by-token as they are generated. The full conversation history is kept for the entire session (true multi-turn context).
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Chat commands
@@ -818,6 +977,7 @@ The agent can create fully custom skills on demand:
 
 Skills are saved to `~/.hyperclaw/workspace/skills/{id}/` and loaded on the next message.
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## HyperClaw Bot commands
@@ -857,6 +1017,7 @@ node dist/run-main.js onboard
 npm run gateway:watch
 ```
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Docker
@@ -889,6 +1050,7 @@ docker compose --profile full up -d
 
 See [`docker-compose.yml`](docker-compose.yml) and [`env.example`](env.example) for all options.
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Monorepo structure
@@ -927,6 +1089,7 @@ hyperclaw/
 └── docs/                   # Full documentation
 ```
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Documentation
@@ -978,6 +1141,49 @@ hyperclaw/
 | Troubleshooting | [docs/troubleshooting.md](docs/troubleshooting.md) |
 | Contributing | [docs/contributing.md](docs/contributing.md) |
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
+
+---
+
+## Roadmap
+
+> See [ROADMAP.md](ROADMAP.md) for the full plan.
+
+| Status | Feature |
+|--------|---------|
+| ✅ Done | 28+ messaging channels |
+| ✅ Done | Config hot-reload |
+| ✅ Done | MCP (Model Context Protocol) |
+| ✅ Done | OSINT / Ethical hacking mode |
+| ✅ Done | Docker sandboxing |
+| ✅ Done | TUI dashboard |
+| ✅ Done | macOS / iOS / Android companion apps |
+| 🔄 In progress | Web UI (browser-based dashboard) |
+| 🔄 In progress | Skill marketplace (HyperClaw Hub) |
+| 📅 Planned | Voice-first mode (always-on mic) |
+| 📅 Planned | Multi-agent collaboration |
+| 📅 Planned | Fine-tuned HyperClaw model |
+| 📅 Planned | One-click cloud deploy (Railway / Render) |
+
+<div align="right"><a href="#top">▲ Back to top</a></div>
+
+---
+
+## Changelog
+
+> Full history in [CHANGELOG.md](CHANGELOG.md).
+
+| Version | Highlights |
+|---------|-----------|
+| **v5.2.1** | Fix postinstall BOM, clean package-lock, nav links in all docs |
+| **v5.2.0** | MCP custom servers, OSINT mode, Tlon/Urbit integration |
+| **v5.1.0** | Config hot-reload, trustedProxies, session.dmScope, Google Chat guide |
+| **v5.0.7** | Groq model IDs fix, Cohere/HuggingFace baseUrl corrections |
+| **v5.0.0** | Major rewrite — monorepo, tsdown bundler, 20+ AI providers |
+| **v4.0.0** | Initial public release |
+
+<div align="right"><a href="#top">▲ Back to top</a></div>
+
 ---
 
 ## Contributing
@@ -987,6 +1193,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. AI/vibe-coded PRs welcome
 Found a bug? [Open an issue](https://github.com/mylo-2001/hyperclaw/issues/new/choose).  
 Found a vulnerability? Email [securityhyperclaw.ai@gmail.com](mailto:securityhyperclaw.ai@gmail.com) — we respond within 48 h.
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## Community
@@ -997,6 +1204,22 @@ Found a vulnerability? Email [securityhyperclaw.ai@gmail.com](mailto:securityhyp
 | 🐛 **Bug reports** | [GitHub Issues](https://github.com/mylo-2001/hyperclaw/issues) — templates for bugs & features |
 | 🔒 **Security** | [SECURITY.md](SECURITY.md) — responsible disclosure |
 
+### Contributors
+
+<a href="https://github.com/mylo-2001/hyperclaw/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=mylo-2001/hyperclaw" alt="Contributors" />
+</a>
+
+### Star History
+
+<a href="https://star-history.com/#mylo-2001/hyperclaw&Date">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=mylo-2001/hyperclaw&type=Date&theme=dark" />
+    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=mylo-2001/hyperclaw&type=Date" />
+    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=mylo-2001/hyperclaw&type=Date" />
+  </picture>
+</a>
+
 ---
 
 <div align="center">
@@ -1007,6 +1230,7 @@ Found a vulnerability? Email [securityhyperclaw.ai@gmail.com](mailto:securityhyp
 
 </div>
 
+<div align="right"><a href="#top">▲ Back to top</a></div>
 ---
 
 ## License

package/dist/chat-R_NuOa1v.js

@@ -0,0 +1,324 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+require('./browser-tools-Btu_vB2d.js');
+require('./src-CbTAVbeI.js');
+const require_engine = require('./engine-DJSfl_Hc.js');
+require('./extraction-tools-BX5HGgko.js');
+const require_inference = require('./inference-C2HOfRf8.js');
+require('./memory-auto-CSUt3aas.js');
+require('./orchestrator-C9I6EVhh.js');
+require('./pc-access-D5k6dAfU.js');
+require('./session-store-Bx7lBD_a.js');
+require('./sessions-tools-DVSejkNU.js');
+require('./skill-loader-99egKAGN.js');
+require('./skill-runtime-BGNtPD_L.js');
+require('./vision-tools-DnUjpQhI.js');
+require('./website-watch-tools-Oxf8Mv4j.js');
+const require_src$1 = require('./src-zUHOCQgl.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 [id]  /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("/model <id>")}      — switch model (e.g. /model claude-sonnet-4-5)`);
+	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-DwbmjEDa.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 (e) {
+		console.log(chalk.default.gray("  Could not load skills list."));
+		console.log(chalk.default.gray(`  ${(e?.message || String(e)).slice(0, 80)}`));
+		console.log(chalk.default.gray("  Run: hyperclaw doctor  or  hyperclaw hub  to check setup."));
+	}
+	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.\n"));
+		console.log(chalk.default.gray("  Chat works without the gateway. Run: hyperclaw onboard\n"));
+		return;
+	}
+	const { getProviderCredentialAsync } = await Promise.resolve().then(() => require("./env-resolve-CC_po9t5.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.\n"));
+		console.log(chalk.default.gray("  Chat uses your AI provider directly (no gateway needed). Run: hyperclaw config set-key\n"));
+		return;
+	}
+	const { getProvider } = await Promise.resolve().then(() => require("./providers-CFQC39vg.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";
+	let 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 = [];
+	let autoMem = null;
+	try {
+		const { AutoMemory } = await Promise.resolve().then(() => require("./memory-auto-D_mPVYqI.js"));
+		autoMem = new AutoMemory({ extractEveryNTurns: 3 });
+	} catch {}
+	printHeader(rawModel, sessionId);
+	try {
+		const { maybeShowUpdateNotice } = await Promise.resolve().then(() => require("./update-check-CaHNCDqe.js"));
+		maybeShowUpdateNotice();
+	} catch {}
+	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" || text.startsWith("/model ")) {
+					const newModelArg = text.slice(7).trim().replace(/^<|>$/g, "");
+					if (newModelArg) {
+						rawModel = newModelArg;
+						engineOpts.model = rawModel.startsWith("ollama/") ? rawModel.slice(7) : rawModel;
+						console.log(chalk.default.green(`\n  ✔ Model switched to: ${chalk.default.bold(rawModel)}\n`));
+					} else if (providerMeta?.models?.length) {
+						rl.pause();
+						try {
+							const inquirer = (await import("inquirer")).default;
+							const defaultIdx = Math.max(0, providerMeta.models.findIndex((m) => m.id === rawModel));
+							const { selected } = await inquirer.prompt([{
+								type: "list",
+								name: "selected",
+								message: chalk.default.cyan("Select model") + chalk.default.gray(" (↑↓ arrows, Enter to confirm):"),
+								choices: providerMeta.models.map((m) => ({
+									name: `${m.id}  ${chalk.default.gray(m.name)}`,
+									value: m.id,
+									short: m.id
+								})),
+								default: defaultIdx,
+								prefix: "  "
+							}]);
+							rawModel = selected;
+							engineOpts.model = rawModel.startsWith("ollama/") ? rawModel.slice(7) : rawModel;
+							console.log(chalk.default.green(`\n  ✔ Model switched to: ${chalk.default.bold(rawModel)}\n`));
+						} catch {
+							console.log(chalk.default.gray("\n  Selection failed. Use: /model <model-id>  (e.g. claude-sonnet-4-5)\n"));
+						} finally {
+							rl.resume();
+						}
+					} else {
+						console.log(chalk.default.gray(`\n  Current model: ${chalk.default.bold(rawModel)}`));
+						console.log(chalk.default.gray("  Use: /model <model-id>\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 {
+					let prefixPrinted = false;
+					const engine = new require_inference.InferenceEngine({
+						...engineOpts,
+						onToken: (token) => {
+							if (spinner.isSpinning) spinner.stop();
+							if (!prefixPrinted) {
+								process.stdout.write(chalk.default.bold.blue("\n  Agent › "));
+								prefixPrinted = true;
+							}
+							process.stdout.write(token);
+						},
+						onToolCall: (name) => {
+							if (spinner.isSpinning) spinner.stop();
+							console.log(chalk.default.gray(`\n  [tool: ${name}]`));
+							prefixPrinted = false;
+						}
+					});
+					const result = await engine.run(messages);
+					responseText = result.text || "";
+					spinner.stop();
+					if (!prefixPrinted) {
+						process.stdout.write(chalk.default.bold.blue("\n  Agent › "));
+						process.stdout.write(responseText || chalk.default.gray("(empty — try rephrasing or check model/tools)"));
+					} else if (!responseText) process.stdout.write(chalk.default.gray("(empty — try rephrasing or check model/tools)"));
+					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();
+					const msg = e?.message || String(e);
+					responseText = `Error: ${msg}`;
+					console.log(chalk.default.red(`\n  Error: ${msg}\n`));
+					const hint = (() => {
+						if (/401|unauthorized|invalid.*key|authentication/i.test(msg)) return "Check API key: hyperclaw config set-key";
+						if (/429|rate.?limit|quota/i.test(msg)) return "Rate limited. Wait a moment and retry.";
+						if (/500|503|service.?unavailable/i.test(msg)) return "Provider temporarily down. Try again later.";
+						if (/network|ECONNREFUSED|ETIMEDOUT|fetch failed/i.test(msg)) return "Network error. Check connection and base URL.";
+						if (/model|not found|invalid model/i.test(msg)) return "Try: /model <id> to switch model.";
+						return "Run: hyperclaw doctor  for setup checks.";
+					})();
+					console.log(chalk.default.gray(`  ${hint}\n`));
+				}
+				if (responseText) messages.push({
+					role: "assistant",
+					content: responseText
+				});
+				if (autoMem) {
+					autoMem.addTurn("user", text);
+					if (responseText) autoMem.addTurn("assistant", responseText);
+					autoMem.extract().catch(() => {});
+				}
+				prompt();
+			});
+		};
+		prompt();
+	});
+}
+
+//#endregion
+exports.runChat = runChat;