hyperclaw 5.2.5 → 5.2.6

package/dist/memory-auto-Cs6XiIxb.js

@@ -0,0 +1,306 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const chalk = require_chunk.__toESM(require("chalk"));
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const os = require_chunk.__toESM(require("os"));
+
+//#region packages/core/src/agent/memory-auto.ts
+function isSensitive(text) {
+	return SENSITIVE_PATTERNS.some((p) => p.test(text));
+}
+function extractFactsLocally(turns) {
+	const facts = [];
+	const userMessages = turns.filter((t) => t.role === "user").map((t) => t.content);
+	for (const msg of userMessages) {
+		if (isSensitive(msg)) continue;
+		for (const pattern of PREFERENCE_PATTERNS) {
+			const m = msg.match(pattern);
+			if (m?.[1] && m[1].length > 4) facts.push({
+				fact: `User preference: ${m[1].trim()}`,
+				category: "preference",
+				confidence: "high"
+			});
+		}
+		for (const pattern of IDENTITY_PATTERNS) {
+			const m = msg.match(pattern);
+			if (m?.[1] && m[1].length > 2) facts.push({
+				fact: `About user: ${m[1].trim()}`,
+				category: "identity",
+				confidence: "high"
+			});
+		}
+		for (const pattern of GOAL_PATTERNS) {
+			const m = msg.match(pattern);
+			if (m?.[1] && m[1].length > 8) facts.push({
+				fact: `User goal: ${m[1].trim()}`,
+				category: "goal",
+				confidence: "medium"
+			});
+		}
+	}
+	const seen = /* @__PURE__ */ new Set();
+	return facts.filter((f) => {
+		const key = f.fact.toLowerCase().slice(0, 40);
+		if (seen.has(key)) return false;
+		seen.add(key);
+		return true;
+	});
+}
+async function readMemory() {
+	try {
+		return await fs_extra.default.readFile(MEMORY_FILE, "utf8");
+	} catch {
+		return "";
+	}
+}
+async function appendMemory(facts) {
+	if (facts.length === 0) return 0;
+	const existing = await readMemory();
+	const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+	let added = 0;
+	const newLines = [];
+	const addedFacts = [];
+	for (const f of facts) {
+		if (existing.toLowerCase().includes(f.fact.toLowerCase().slice(0, 30))) continue;
+		newLines.push(`- ${today} [${f.category}] ${f.fact}`);
+		addedFacts.push(f);
+		added++;
+	}
+	if (newLines.length === 0) return 0;
+	await fs_extra.default.ensureDir(HC_DIR);
+	if (!await fs_extra.default.pathExists(MEMORY_FILE)) await fs_extra.default.writeFile(MEMORY_FILE, "# HyperClaw Memory\n\n");
+	await fs_extra.default.appendFile(MEMORY_FILE, "\n" + newLines.join("\n") + "\n");
+	try {
+		const { onMemoryAppended } = await Promise.resolve().then(() => require("./memory-integration-_NOy60Fj.js"));
+		await onMemoryAppended(addedFacts.map((f) => ({ fact: f.fact })));
+	} catch {}
+	return added;
+}
+async function saveMemoryDirect(text) {
+	await fs_extra.default.ensureDir(HC_DIR);
+	if (!await fs_extra.default.pathExists(MEMORY_FILE)) await fs_extra.default.writeFile(MEMORY_FILE, "# HyperClaw Memory\n\n");
+	const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+	await fs_extra.default.appendFile(MEMORY_FILE, `\n- ${today} ${text}\n`);
+	try {
+		const { onMemoryAppended } = await Promise.resolve().then(() => require("./memory-integration-_NOy60Fj.js"));
+		await onMemoryAppended([{ fact: text }]);
+	} catch {}
+}
+async function extractFactsWithAI(turns, inferenceOpts) {
+	const totalText = turns.map((t) => t.content).join(" ");
+	if (totalText.length < 100) return [];
+	const localFacts = extractFactsLocally(turns);
+	const hasPersonalContext = /\b(I|my|me|mine|myself)\b/i.test(totalText);
+	if (!hasPersonalContext) return localFacts;
+	try {
+		const { InferenceEngine } = await Promise.resolve().then(() => require("./inference-DQiqWbqu.js"));
+		const engine = new InferenceEngine({
+			model: inferenceOpts.model,
+			apiKey: inferenceOpts.apiKey,
+			provider: inferenceOpts.provider,
+			maxTokens: 512,
+			tools: []
+		});
+		const conversationSummary = turns.slice(-6).map((t) => `${t.role === "user" ? "User" : "AI"}: ${t.content.slice(0, 300)}`).join("\n");
+		const result = await engine.run([{
+			role: "user",
+			content: `Extract ONLY concrete, reusable facts about the USER from this conversation. 
+Skip: passwords, API keys, one-off questions, assistant responses.
+Include: name, job, preferences, ongoing projects, locations, recurring tasks.
+
+Conversation:
+${conversationSummary}
+
+Respond with a JSON array of strings, each a short fact starting with "User".
+If nothing worth saving, respond: []
+Example: ["User's name is Alex", "User prefers TypeScript over JavaScript", "User is building a SaaS app"]`
+		}]);
+		const clean = result.text.replace(/```json|```/g, "").trim();
+		const aiFactStrings = JSON.parse(clean);
+		const allFacts = [...localFacts];
+		const existingFactText = localFacts.map((f) => f.fact.toLowerCase());
+		for (const factStr of aiFactStrings) {
+			if (!factStr || factStr.length < 5) continue;
+			if (isSensitive(factStr)) continue;
+			if (existingFactText.some((e) => e.includes(factStr.toLowerCase().slice(0, 20)))) continue;
+			const cat = /prefer|like|hate|always|never|don't/i.test(factStr) ? "preference" : /goal|want|trying|working on|building/i.test(factStr) ? "goal" : /name|job|work|role|from|based/i.test(factStr) ? "identity" : "context";
+			allFacts.push({
+				fact: factStr,
+				category: cat,
+				confidence: "medium"
+			});
+		}
+		return allFacts;
+	} catch {
+		return localFacts;
+	}
+}
+async function showMemory() {
+	const content = await readMemory();
+	if (!content.trim()) {
+		console.log(chalk.default.gray("\n  🧠 MEMORY.md is empty\n"));
+		return;
+	}
+	console.log(chalk.default.bold.cyan("\n  🧠 MEMORY\n"));
+	const lines = content.split("\n").filter((l) => l.trim());
+	for (const line of lines) if (line.startsWith("#")) console.log(chalk.default.bold.white(line));
+	else if (line.startsWith("-")) {
+		const parts = line.match(/^-\s+(\S+)\s+\[(\w+)\]\s+(.+)$/);
+		if (parts) {
+			const [, date, cat, fact] = parts;
+			const catColor = cat === "preference" ? chalk.default.cyan : cat === "identity" ? chalk.default.yellow : cat === "goal" ? chalk.default.green : chalk.default.gray;
+			console.log(`  ${chalk.default.gray(date)} ${catColor(`[${cat}]`)} ${fact}`);
+		} else console.log(`  ${line}`);
+	}
+	console.log();
+}
+async function clearMemory() {
+	await fs_extra.default.writeFile(MEMORY_FILE, "# HyperClaw Memory\n\n");
+	console.log(chalk.default.green("  ✅ Memory cleared\n"));
+}
+async function searchMemory(query) {
+	const content = await readMemory();
+	const lines = content.split("\n").filter((l) => l.toLowerCase().includes(query.toLowerCase()));
+	if (lines.length === 0) {
+		console.log(chalk.default.gray(`  No memories found for: "${query}"\n`));
+		return;
+	}
+	console.log(chalk.default.bold.cyan(`\n  🔍 Memory search: "${query}"\n`));
+	for (const line of lines) console.log(`  ${line}`);
+	console.log();
+}
+var HC_DIR, MEMORY_FILE, SOUL_FILE, PREFERENCE_PATTERNS, IDENTITY_PATTERNS, GOAL_PATTERNS, SENSITIVE_PATTERNS, AutoMemory;
+var init_memory_auto = require_chunk.__esm({ "packages/core/src/agent/memory-auto.ts"() {
+	HC_DIR = path.default.join(os.default.homedir(), ".hyperclaw");
+	MEMORY_FILE = path.default.join(HC_DIR, "MEMORY.md");
+	SOUL_FILE = path.default.join(HC_DIR, "SOUL.md");
+	PREFERENCE_PATTERNS = [
+		/i (?:prefer|like|love|hate|dislike|always|never)\s+(.{5,80})/i,
+		/(?:my favorite|my preferred)\s+(.{5,80})/i,
+		/(?:please )?always\s+((?:use|do|write|respond|answer|format|reply)\s+.{5,60})/i,
+		/don'?t (?:ever )?(.{5,60})/i,
+		/(?:i want you to always)\s+(.{5,80})/i
+	];
+	IDENTITY_PATTERNS = [
+		/(?:my name is|i'?m called|call me)\s+([A-ZΑ-Ωa-zα-ω][a-zα-ω]{1,30})/i,
+		/i(?:'m| am) (?:a |an )?([A-Za-zΑ-Ωα-ω][\w\s]{3,40}?)(?:\.|,|$)/i,
+		/i work (?:at|for|as)\s+(.{5,60})/i,
+		/i(?:'m| am) (?:from|in|based in)\s+(.{3,40})/i,
+		/my (?:job|role|position|title) is\s+(.{5,60})/i
+	];
+	GOAL_PATTERNS = [
+		/i(?:'m| am) (?:working on|building|creating|developing)\s+(.{10,100})/i,
+		/i want to\s+(.{10,100})/i,
+		/my goal is (?:to\s+)?(.{10,100})/i,
+		/i'?m trying to\s+(.{10,100})/i
+	];
+	SENSITIVE_PATTERNS = [
+		/password/i,
+		/passwd/i,
+		/secret key/i,
+		/api.?key/i,
+		/credit.?card/i,
+		/\b\d{4}[\s-]\d{4}[\s-]\d{4}[\s-]\d{4}\b/,
+		/ssn|social security/i,
+		/\b\d{3}-\d{2}-\d{4}\b/
+	];
+	AutoMemory = class {
+		turns = [];
+		turnsSinceLastExtract = 0;
+		extractEveryNTurns;
+		useAI;
+		aiOpts;
+		constructor(opts = {}) {
+			this.extractEveryNTurns = opts.extractEveryNTurns ?? 4;
+			this.useAI = opts.useAI ?? false;
+			this.aiOpts = opts.aiOpts;
+		}
+		addTurn(role, content) {
+			this.turns.push({
+				role,
+				content,
+				timestamp: (/* @__PURE__ */ new Date()).toISOString()
+			});
+			this.turnsSinceLastExtract++;
+		}
+		async maybeExtract() {
+			if (this.turnsSinceLastExtract < this.extractEveryNTurns) return 0;
+			this.turnsSinceLastExtract = 0;
+			return this.extract();
+		}
+		async extract() {
+			const facts = this.useAI && this.aiOpts ? await extractFactsWithAI(this.turns, this.aiOpts) : extractFactsLocally(this.turns);
+			const saved = await appendMemory(facts);
+			if (saved > 0) console.log(chalk.default.gray(`  🧠 Auto-saved ${saved} fact${saved === 1 ? "" : "s"} to MEMORY.md`));
+			return saved;
+		}
+		clearTurns() {
+			this.turns = [];
+		}
+		getTurns() {
+			return [...this.turns];
+		}
+	};
+} });
+
+//#endregion
+Object.defineProperty(exports, 'AutoMemory', {
+  enumerable: true,
+  get: function () {
+    return AutoMemory;
+  }
+});
+Object.defineProperty(exports, 'appendMemory', {
+  enumerable: true,
+  get: function () {
+    return appendMemory;
+  }
+});
+Object.defineProperty(exports, 'clearMemory', {
+  enumerable: true,
+  get: function () {
+    return clearMemory;
+  }
+});
+Object.defineProperty(exports, 'extractFactsLocally', {
+  enumerable: true,
+  get: function () {
+    return extractFactsLocally;
+  }
+});
+Object.defineProperty(exports, 'extractFactsWithAI', {
+  enumerable: true,
+  get: function () {
+    return extractFactsWithAI;
+  }
+});
+Object.defineProperty(exports, 'init_memory_auto', {
+  enumerable: true,
+  get: function () {
+    return init_memory_auto;
+  }
+});
+Object.defineProperty(exports, 'readMemory', {
+  enumerable: true,
+  get: function () {
+    return readMemory;
+  }
+});
+Object.defineProperty(exports, 'saveMemoryDirect', {
+  enumerable: true,
+  get: function () {
+    return saveMemoryDirect;
+  }
+});
+Object.defineProperty(exports, 'searchMemory', {
+  enumerable: true,
+  get: function () {
+    return searchMemory;
+  }
+});
+Object.defineProperty(exports, 'showMemory', {
+  enumerable: true,
+  get: function () {
+    return showMemory;
+  }
+});

package/dist/node-4_wJsNEN.js

@@ -0,0 +1,226 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.js');
+const chalk = require_chunk.__toESM(require("chalk"));
+const inquirer = require_chunk.__toESM(require("inquirer"));
+const ora = require_chunk.__toESM(require("ora"));
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const os = require_chunk.__toESM(require("os"));
+
+//#region src/commands/node.ts
+require_paths$1.init_paths();
+const getNodesFile = () => path.default.join(require_paths.getHyperClawDir(), "nodes.json");
+async function loadNodes() {
+	try {
+		return await fs_extra.default.readJson(getNodesFile());
+	} catch {
+		return [];
+	}
+}
+async function saveNodes(nodes) {
+	const nodesFile = getNodesFile();
+	await fs_extra.default.ensureDir(path.default.dirname(nodesFile));
+	await fs_extra.default.writeJson(nodesFile, nodes, { spaces: 2 });
+}
+const TYPE_EMOJI = {
+	local: "💻",
+	remote: "🖥️",
+	android: "📱",
+	raspberrypi: "🍓",
+	docker: "🐳",
+	vm: "☁️"
+};
+const STATUS_COLOR = {
+	online: chalk.default.green,
+	offline: chalk.default.red,
+	unknown: chalk.default.gray,
+	degraded: chalk.default.yellow
+};
+async function nodeList() {
+	const nodes = await loadNodes();
+	console.log(chalk.default.bold.cyan("\n  📱 HYPERCLAW NODES\n"));
+	console.log(`  ${chalk.default.green("●")} ${chalk.default.white("Local (this machine)".padEnd(22))} ${chalk.default.cyan("[local]")}  ${chalk.default.green("online")}`);
+	console.log(`    ${chalk.default.gray(`Node.js ${process.version}  ${os.default.platform()} ${os.default.arch()}  port 18789`)}`);
+	console.log();
+	if (nodes.length === 0) {
+		console.log(chalk.default.gray("  No additional nodes registered."));
+		console.log(chalk.default.gray("  Add a remote node: hyperclaw node add\n"));
+		return;
+	}
+	for (const node of nodes) {
+		const dot = STATUS_COLOR[node.status]("●");
+		const emoji = TYPE_EMOJI[node.type];
+		const status = STATUS_COLOR[node.status](node.status);
+		console.log(`  ${dot} ${chalk.default.white(node.name.padEnd(22))} ${chalk.default.cyan(`[${node.type}]`)}  ${status}`);
+		if (node.host) console.log(`    ${chalk.default.gray(`${node.host}:${node.port || 18789}`)}`);
+		if (node.androidDeviceId) console.log(`    ${chalk.default.gray(`adb: ${node.androidDeviceId}`)}`);
+		if (node.capabilities.length > 0) console.log(`    ${chalk.default.gray("caps:")} ${node.capabilities.join(", ")}`);
+		if (node.lastSeenAt) {
+			const ago = Math.round((Date.now() - new Date(node.lastSeenAt).getTime()) / 1e3 / 60);
+			console.log(`    ${chalk.default.gray(`last seen: ${ago}m ago`)}`);
+		}
+		console.log();
+	}
+}
+async function nodeAdd() {
+	console.log(chalk.default.bold.cyan("\n  ➕ ADD NODE\n"));
+	const { type } = await inquirer.default.prompt([{
+		type: "list",
+		name: "type",
+		message: "Node type:",
+		choices: [
+			{
+				name: "🖥️  Remote server (SSH)",
+				value: "remote"
+			},
+			{
+				name: "📱  Android device (ADB)",
+				value: "android"
+			},
+			{
+				name: "🍓  Raspberry Pi",
+				value: "raspberrypi"
+			},
+			{
+				name: "🐳  Docker container",
+				value: "docker"
+			},
+			{
+				name: "☁️  VM / cloud instance",
+				value: "vm"
+			}
+		]
+	}]);
+	const { name } = await inquirer.default.prompt([{
+		type: "input",
+		name: "name",
+		message: "Node name:",
+		validate: (v) => !!v.trim() || "Required"
+	}]);
+	let extras = {};
+	if (type === "android") {
+		const { deviceId } = await inquirer.default.prompt([{
+			type: "input",
+			name: "deviceId",
+			message: "ADB device ID (run: adb devices):",
+			validate: (v) => !!v.trim() || "Required"
+		}]);
+		extras.androidDeviceId = deviceId;
+		extras.capabilities = ["channel:host", "always-on"];
+	} else {
+		const { host, port } = await inquirer.default.prompt([{
+			type: "input",
+			name: "host",
+			message: "Hostname or IP:",
+			validate: (v) => !!v.trim() || "Required"
+		}, {
+			type: "number",
+			name: "port",
+			message: "Gateway port:",
+			default: 18789
+		}]);
+		const { caps } = await inquirer.default.prompt([{
+			type: "checkbox",
+			name: "caps",
+			message: "Capabilities:",
+			choices: [
+				{
+					name: "Run agent inference",
+					value: "agent:run",
+					checked: true
+				},
+				{
+					name: "Host channel connections",
+					value: "channel:host"
+				},
+				{
+					name: "Execute code",
+					value: "code:execute"
+				},
+				{
+					name: "GPU acceleration",
+					value: "gpu"
+				},
+				{
+					name: "Always-on (24/7)",
+					value: "always-on"
+				}
+			]
+		}]);
+		extras = {
+			host,
+			port,
+			capabilities: caps
+		};
+	}
+	const node = {
+		id: name.toLowerCase().replace(/\s+/g, "-"),
+		name,
+		type,
+		status: "unknown",
+		addedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		capabilities: extras.capabilities || [],
+		...extras
+	};
+	const nodes = await loadNodes();
+	nodes.push(node);
+	await saveNodes(nodes);
+	console.log(chalk.default.green(`\n  ✔  Node added: ${name}`));
+	console.log(chalk.default.gray("  Run: hyperclaw node probe   to test the connection\n"));
+}
+async function nodeProbe(id) {
+	const nodes = await loadNodes();
+	const targets = id ? nodes.filter((n) => n.id === id) : nodes;
+	console.log(chalk.default.bold.cyan("\n  🔍 PROBING NODES\n"));
+	console.log(`  ${chalk.default.cyan("○")} Local...`);
+	await new Promise((r) => setTimeout(r, 300));
+	console.log(`  ${chalk.default.green("✔")} Local — online (${os.default.platform()} ${os.default.arch()})\n`);
+	for (const node of targets) {
+		const spinner = (0, ora.default)(`  Probing ${node.name} (${node.host || node.androidDeviceId || node.type})...`).start();
+		await new Promise((r) => setTimeout(r, 1e3));
+		try {
+			if (node.host) {
+				const axios = (await import("axios")).default;
+				const res = await axios.get(`http://${node.host}:${node.port || 18789}/api/status`, { timeout: 3e3 });
+				node.status = "online";
+				node.version = res.data?.version;
+				node.lastSeenAt = (/* @__PURE__ */ new Date()).toISOString();
+				spinner.succeed(`${node.name} — online${node.version ? ` (v${node.version})` : ""}`);
+			} else if (node.type === "android") {
+				const { exec } = await import("child_process");
+				const { promisify } = await import("util");
+				const execAsync = promisify(exec);
+				await execAsync(`adb -s ${node.androidDeviceId} shell echo ok`);
+				node.status = "online";
+				node.lastSeenAt = (/* @__PURE__ */ new Date()).toISOString();
+				spinner.succeed(`${node.name} — online (ADB connected)`);
+			} else {
+				node.status = "unknown";
+				spinner.warn(`${node.name} — probe not supported for ${node.type}`);
+			}
+		} catch {
+			node.status = "offline";
+			spinner.fail(`${node.name} — offline / unreachable`);
+		}
+		console.log();
+	}
+	await saveNodes(nodes);
+}
+async function nodeRemove(id) {
+	const nodes = await loadNodes();
+	const idx = nodes.findIndex((n) => n.id === id);
+	if (idx === -1) {
+		console.log(chalk.default.red(`\n  ✖  Node not found: ${id}\n`));
+		return;
+	}
+	nodes.splice(idx, 1);
+	await saveNodes(nodes);
+	console.log(chalk.default.green(`\n  ✔  Node removed: ${id}\n`));
+}
+
+//#endregion
+exports.nodeAdd = nodeAdd;
+exports.nodeList = nodeList;
+exports.nodeProbe = nodeProbe;
+exports.nodeRemove = nodeRemove;

package/dist/oauth-flow-CJ7dFXKT.js

@@ -0,0 +1,148 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const crypto = require_chunk.__toESM(require("crypto"));
+const http = require_chunk.__toESM(require("http"));
+
+//#region src/services/oauth-flow.ts
+const REDIRECT_PORT = 38789;
+const REDIRECT_PATH = "/oauth/callback";
+const PROVIDERS = {
+	google: {
+		authorize_url: "https://accounts.google.com/o/oauth2/v2/auth",
+		token_url: "https://oauth2.googleapis.com/token",
+		scopes: [
+			"openid",
+			"email",
+			"profile",
+			"https://www.googleapis.com/auth/aiplatform"
+		],
+		client_id: process.env.GOOGLE_OAUTH_CLIENT_ID || "",
+		client_secret: process.env.GOOGLE_OAUTH_CLIENT_SECRET
+	},
+	"google-gmail": {
+		authorize_url: "https://accounts.google.com/o/oauth2/v2/auth",
+		token_url: "https://oauth2.googleapis.com/token",
+		scopes: [
+			"openid",
+			"email",
+			"profile",
+			"https://www.googleapis.com/auth/gmail.modify",
+			"https://mail.google.com/"
+		],
+		client_id: process.env.GOOGLE_OAUTH_CLIENT_ID || "",
+		client_secret: process.env.GOOGLE_OAUTH_CLIENT_SECRET
+	},
+	microsoft: {
+		authorize_url: "https://login.microsoftonline.com/common/oauth2/v2.0/authorize",
+		token_url: "https://login.microsoftonline.com/common/oauth2/v2.0/token",
+		scopes: [
+			"openid",
+			"profile",
+			"offline_access",
+			"https://cognitiveservices.azure.com/.default"
+		],
+		client_id: process.env.AZURE_OAUTH_CLIENT_ID || process.env.MICROSOFT_OAUTH_CLIENT_ID || "",
+		client_secret: process.env.AZURE_OAUTH_CLIENT_SECRET || process.env.MICROSOFT_OAUTH_CLIENT_SECRET
+	}
+};
+async function runOAuthFlow(providerId, opts) {
+	const cfg = PROVIDERS[providerId];
+	if (!cfg) throw new Error(`OAuth provider "${providerId}" not configured. Supported: google, google-gmail (Gmail Pub/Sub), microsoft. Anthropic/OpenAI: use "hyperclaw auth add" (API keys) or "hyperclaw auth setup-token anthropic" for Claude Pro/Max.`);
+	const clientId = opts?.clientId || cfg.client_id || process.env.OAUTH_CLIENT_ID;
+	const clientSecret = opts?.clientSecret || cfg.client_secret || process.env.OAUTH_CLIENT_SECRET;
+	const scopes = opts?.scopes || cfg.scopes;
+	if (!clientId) {
+		const hint = providerId === "google" ? "Set GOOGLE_OAUTH_CLIENT_ID or OAUTH_CLIENT_ID. Create at: https://console.cloud.google.com/apis/credentials" : providerId === "microsoft" ? "Set AZURE_OAUTH_CLIENT_ID. Create at: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade" : "Set OAUTH_CLIENT_ID or pass --client-id";
+		throw new Error(`OAuth client_id required. ${hint}`);
+	}
+	const codeVerifier = crypto.default.randomBytes(32).toString("base64url");
+	const codeChallenge = crypto.default.createHash("sha256").update(codeVerifier).digest("base64url");
+	const authParams = new URLSearchParams({
+		client_id: clientId,
+		redirect_uri: `http://127.0.0.1:${REDIRECT_PORT}${REDIRECT_PATH}`,
+		response_type: "code",
+		scope: scopes.join(" "),
+		code_challenge: codeChallenge,
+		code_challenge_method: "S256",
+		access_type: "offline",
+		prompt: "consent"
+	});
+	const authUrl = `${cfg.authorize_url}?${authParams}`;
+	return new Promise((resolve, reject) => {
+		const server = http.default.createServer(async (req, res) => {
+			const url = new URL(req.url || "/", `http://127.0.0.1`);
+			if (url.pathname !== REDIRECT_PATH) {
+				res.writeHead(404);
+				res.end("Not found");
+				return;
+			}
+			const code = url.searchParams.get("code");
+			const error = url.searchParams.get("error");
+			res.setHeader("Content-Type", "text/html; charset=utf-8");
+			if (error) {
+				const safeError = String(error).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+				res.writeHead(400);
+				res.end(`<h1>OAuth error</h1><p>${safeError}</p><p>You can close this tab.</p>`);
+				server.close();
+				reject(new Error(`OAuth error: ${error}`));
+				return;
+			}
+			if (!code) {
+				res.writeHead(400);
+				res.end("<h1>No code received</h1><p>You can close this tab.</p>");
+				server.close();
+				reject(new Error("No authorization code received"));
+				return;
+			}
+			const body = new URLSearchParams({
+				grant_type: "authorization_code",
+				code,
+				redirect_uri: `http://127.0.0.1:${REDIRECT_PORT}${REDIRECT_PATH}`,
+				code_verifier: codeVerifier
+			});
+			if (clientSecret) body.set("client_secret", clientSecret);
+			body.set("client_id", clientId);
+			try {
+				const tokenRes = await fetch(cfg.token_url, {
+					method: "POST",
+					headers: { "Content-Type": "application/x-www-form-urlencoded" },
+					body: body.toString()
+				});
+				const tokenData = await tokenRes.json();
+				if (tokenData.error) {
+					res.writeHead(400);
+					res.end(`<h1>Token error</h1><p>${tokenData.error}</p><p>You can close this tab.</p>`);
+					server.close();
+					reject(new Error(tokenData.error_description || tokenData.error));
+					return;
+				}
+				res.writeHead(200);
+				res.end("<h1>Success!</h1><p>HyperClaw has received your tokens. You can close this tab and return to the terminal.</p>");
+				server.close();
+				resolve({
+					access_token: tokenData.access_token,
+					refresh_token: tokenData.refresh_token,
+					expires_in: tokenData.expires_in
+				});
+			} catch (e) {
+				res.writeHead(500);
+				res.end(`<h1>Error</h1><p>${e.message}</p><p>You can close this tab.</p>`);
+				server.close();
+				reject(e);
+			}
+		});
+		server.listen(REDIRECT_PORT, "127.0.0.1", () => {
+			try {
+				const { exec } = require("child_process");
+				const opener = process.platform === "win32" ? `start "" "${authUrl}"` : (process.platform === "darwin" ? "open" : "xdg-open") + ` "${authUrl}"`;
+				exec(opener);
+			} catch {}
+		});
+		server.on("error", (err) => {
+			server.close();
+			reject(err);
+		});
+	});
+}
+
+//#endregion
+exports.runOAuthFlow = runOAuthFlow;