hyperclaw 4.0.1 → 4.0.2

package/dist/connector-Dbvb1Cj9.js

@@ -0,0 +1,280 @@
+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"));
+const https = require_chunk.__toESM(require("https"));
+const events = require_chunk.__toESM(require("events"));
+
+//#region extensions/telegram/src/connector.ts
+function tgDownloadFile(token, filePath) {
+	return new Promise((resolve, reject) => {
+		const req = https.default.request({
+			hostname: "api.telegram.org",
+			port: 443,
+			path: `/file/bot${token}/${filePath}`,
+			method: "GET"
+		}, (res) => {
+			const chunks = [];
+			res.on("data", (c) => chunks.push(c));
+			res.on("end", () => resolve(Buffer.concat(chunks)));
+		});
+		req.on("error", reject);
+		req.setTimeout(3e4, () => {
+			req.destroy();
+			reject(new Error("Download timeout"));
+		});
+		req.end();
+	});
+}
+function tgRequest(token, method, body) {
+	return new Promise((resolve, reject) => {
+		const payload = body ? JSON.stringify(body) : null;
+		const req = https.default.request({
+			hostname: "api.telegram.org",
+			port: 443,
+			path: `/bot${token}/${method}`,
+			method: payload ? "POST" : "GET",
+			headers: payload ? {
+				"Content-Type": "application/json",
+				"Content-Length": Buffer.byteLength(payload)
+			} : {}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const r = JSON.parse(data);
+					if (r.ok) resolve(r.result);
+					else reject(new Error(r.description || "Telegram API error"));
+				} catch {
+					reject(new Error("Invalid JSON"));
+				}
+			});
+		});
+		req.on("error", reject);
+		req.setTimeout(35e3, () => {
+			req.destroy();
+			reject(new Error("Timeout"));
+		});
+		if (payload) req.write(payload);
+		req.end();
+	});
+}
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "telegram-state.json");
+function sleep(ms) {
+	return new Promise((r) => setTimeout(r, ms));
+}
+function generateCode() {
+	const chars = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
+	return Array.from({ length: 6 }, () => chars[Math.floor(Math.random() * chars.length)]).join("");
+}
+function chunkText(text, max) {
+	if (text.length <= max) return [text];
+	const chunks = [];
+	let i = 0;
+	while (i < text.length) {
+		let end = Math.min(i + max, text.length);
+		if (end < text.length) {
+			const nl = text.lastIndexOf("\n", end);
+			if (nl > i) end = nl + 1;
+		}
+		chunks.push(text.slice(i, end));
+		i = end;
+	}
+	return chunks;
+}
+var TelegramConnector = class extends events.EventEmitter {
+	token;
+	config;
+	offset = 0;
+	running = false;
+	botInfo = null;
+	constructor(token, config) {
+		super();
+		this.token = token;
+		this.config = {
+			token,
+			dmPolicy: "allowlist",
+			allowFrom: [],
+			pendingPairings: {},
+			approvedPairings: [],
+			...config
+		};
+	}
+	async connect() {
+		this.botInfo = await tgRequest(this.token, "getMe");
+		console.log(chalk.default.green(`  🦅 Telegram: @${this.botInfo?.username} connected`));
+		await this.loadState();
+		this.running = true;
+		this.pollLoop();
+		this.emit("connected", this.botInfo);
+	}
+	async disconnect() {
+		this.running = false;
+		await this.saveState();
+	}
+	async pollLoop() {
+		while (this.running) try {
+			const updates = await tgRequest(this.token, "getUpdates", {
+				offset: this.offset,
+				timeout: 30,
+				allowed_updates: ["message"]
+			});
+			for (const u of updates) {
+				this.offset = u.update_id + 1;
+				await this.handleUpdate(u).catch((e) => console.log(chalk.default.yellow(`  ⚠  ${e.message}`)));
+			}
+		} catch (e) {
+			if (this.running) {
+				console.log(chalk.default.yellow(`  ⚠  Telegram poll: ${e.message}`));
+				await sleep(5e3);
+			}
+		}
+	}
+	async handleUpdate(u) {
+		const msg = u.message || u.edited_message;
+		if (!msg) return;
+		const text = msg.text?.trim() || "";
+		if (!text && !msg.voice) return;
+		const userId = String(msg.from?.id || "");
+		const isDM = msg.chat.type === "private";
+		const isGroup = msg.chat.type === "group" || msg.chat.type === "supergroup";
+		if (isDM && !await this.checkDMPolicy(userId, msg.chat.id, text || "[voice note]")) return;
+		let finalText = text || "[voice note]";
+		if (isGroup) {
+			const groupAllowFrom = this.config.groupAllowFrom ?? [];
+			if (groupAllowFrom.length > 0 && !groupAllowFrom.includes(String(msg.chat.id))) return;
+			const activation = this.config.groupActivation ?? "mention";
+			if (activation === "mention") {
+				const botUsername = this.botInfo?.username ? `@${this.botInfo.username}`.toLowerCase() : "";
+				const mentioned = botUsername && text.toLowerCase().includes(botUsername);
+				const isReplyToBot = msg.reply_to_message?.from?.is_bot && msg.reply_to_message.from.id === this.botInfo?.id;
+				if (!mentioned && !isReplyToBot) return;
+				if (mentioned && botUsername) finalText = text.replace(new RegExp(botUsername, "gi"), "").trim() || finalText;
+			}
+		}
+		let audioPath;
+		if (msg?.voice?.file_id) try {
+			const file = await tgRequest(this.token, "getFile", { file_id: msg.voice.file_id });
+			const buf = await tgDownloadFile(this.token, file.file_path);
+			const ext = (file.file_path || "").split(".").pop() || "oga";
+			const tmp = path.default.join(os.default.tmpdir(), `hyperclaw-tg-voice-${msg.message_id}.${ext}`);
+			await fs_extra.default.writeFile(tmp, buf);
+			audioPath = tmp;
+		} catch (e) {
+			console.log(chalk.default.yellow(`  ⚠  Telegram voice download failed: ${e.message}`));
+		}
+		this.emit("message", {
+			id: String(msg.message_id),
+			channelId: "telegram",
+			from: userId,
+			fromUsername: msg.from?.username,
+			chatId: msg.chat.id,
+			text: finalText,
+			audioPath,
+			timestamp: new Date(msg.date * 1e3).toISOString(),
+			isDM
+		});
+	}
+	async checkDMPolicy(userId, chatId, text) {
+		if (this.config.dmPolicy === "none") return false;
+		if (this.config.dmPolicy === "open") return true;
+		if (this.config.dmPolicy === "allowlist") {
+			if (this.config.allowFrom.includes(userId)) return true;
+			await this.sendMessage(chatId, `🦅 *HyperClaw*\n\nYou are not on the allowlist.`);
+			return false;
+		}
+		if (this.config.dmPolicy === "pairing") {
+			if (this.config.approvedPairings.includes(userId)) return true;
+			const upper = text.trim().toUpperCase();
+			if (this.config.pendingPairings[upper]) {
+				this.config.approvedPairings.push(userId);
+				delete this.config.pendingPairings[upper];
+				await this.saveState();
+				await this.sendMessage(chatId, `🦅 *Paired!* You can now send messages.`);
+				this.emit("pairing:approved", {
+					userId,
+					channelId: "telegram"
+				});
+				return true;
+			}
+			const code = generateCode();
+			this.config.pendingPairings[code] = userId;
+			await this.saveState();
+			await this.sendMessage(chatId, `🦅 *HyperClaw Pairing*\n\nSend the owner this code:\n\`${code}\`\n\nApprove with:\n\`hyperclaw pairing approve telegram ${code}\``);
+			console.log(chalk.default.cyan(`  🦅 Telegram pairing from ${userId} — code: ${code}`));
+			return false;
+		}
+		return false;
+	}
+	async sendMessage(chatId, text, opts = {}) {
+		const chunks = chunkText(text, 4096);
+		let last = null;
+		for (const chunk of chunks) last = await tgRequest(this.token, "sendMessage", {
+			chat_id: chatId,
+			text: chunk,
+			parse_mode: opts.parse_mode || "Markdown",
+			disable_web_page_preview: opts.disable_web_page_preview ?? true,
+			...opts.reply_to_message_id ? { reply_to_message_id: opts.reply_to_message_id } : {}
+		});
+		return last;
+	}
+	async sendTyping(chatId) {
+		await tgRequest(this.token, "sendChatAction", {
+			chat_id: chatId,
+			action: "typing"
+		}).catch(() => {});
+	}
+	approvePairing(code) {
+		const upper = code.toUpperCase();
+		if (!this.config.pendingPairings[upper]) return false;
+		const userId = this.config.pendingPairings[upper];
+		this.config.approvedPairings.push(userId);
+		delete this.config.pendingPairings[upper];
+		this.saveState();
+		return true;
+	}
+	addToAllowlist(userId) {
+		if (!this.config.allowFrom.includes(userId)) {
+			this.config.allowFrom.push(userId);
+			this.saveState();
+		}
+	}
+	listPendingPairings() {
+		return Object.entries(this.config.pendingPairings).map(([code, userId]) => ({
+			code,
+			userId
+		}));
+	}
+	handleWebhookPayload(body) {
+		try {
+			this.handleUpdate(JSON.parse(body));
+		} catch {}
+	}
+	async loadState() {
+		try {
+			const s = await fs_extra.default.readJson(STATE_FILE);
+			this.offset = s.offset || 0;
+			if (s.pendingPairings) this.config.pendingPairings = s.pendingPairings;
+			if (s.approvedPairings) this.config.approvedPairings = s.approvedPairings;
+		} catch {}
+	}
+	async saveState() {
+		await fs_extra.default.ensureDir(path.default.dirname(STATE_FILE));
+		await fs_extra.default.writeJson(STATE_FILE, {
+			offset: this.offset,
+			pendingPairings: this.config.pendingPairings,
+			approvedPairings: this.config.approvedPairings
+		}, { spaces: 2 });
+	}
+	isRunning() {
+		return this.running;
+	}
+	getBotInfo() {
+		return this.botInfo;
+	}
+};
+
+//#endregion
+exports.TelegramConnector = TelegramConnector;

package/dist/connector-DcZdQcgR.js

@@ -0,0 +1,173 @@
+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"));
+const crypto = require_chunk.__toESM(require("crypto"));
+const https = require_chunk.__toESM(require("https"));
+const events = require_chunk.__toESM(require("events"));
+
+//#region extensions/messenger/src/connector.ts
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "messenger-state.json");
+function fbReq(token, endpoint, body) {
+	return new Promise((resolve, reject) => {
+		const payload = JSON.stringify(body);
+		const req = https.default.request({
+			hostname: "graph.facebook.com",
+			port: 443,
+			path: `/v18.0${endpoint}`,
+			method: "POST",
+			headers: {
+				"Authorization": `Bearer ${token}`,
+				"Content-Type": "application/json",
+				"Content-Length": Buffer.byteLength(payload)
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const r = JSON.parse(data);
+					if (r.error) reject(new Error(r.error.message));
+					else resolve(r);
+				} catch {
+					reject(new Error("Invalid JSON"));
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(payload);
+		req.end();
+	});
+}
+var MessengerConnector = class extends events.EventEmitter {
+	config;
+	running = false;
+	processedIds = /* @__PURE__ */ new Set();
+	constructor(config) {
+		super();
+		this.config = {
+			dmPolicy: "allowlist",
+			allowFrom: [],
+			approvedPairings: [],
+			pendingPairings: {},
+			...config
+		};
+	}
+	async connect() {
+		await this.loadState();
+		this.running = true;
+		console.log(chalk.default.green(`  🦅 Messenger: page ${this.config.pageId} connected`));
+		this.emit("connected", { pageId: this.config.pageId });
+	}
+	disconnect() {
+		this.running = false;
+	}
+	verifyWebhook(mode, token, challenge) {
+		return mode === "subscribe" && token === this.config.verifyToken ? challenge : null;
+	}
+	verifySignature(body, signature) {
+		const expected = "sha256=" + crypto.default.createHmac("sha256", this.config.appSecret).update(body).digest("hex");
+		try {
+			return crypto.default.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
+		} catch {
+			return false;
+		}
+	}
+	async handleWebhook(body, signature) {
+		if (signature && !this.verifySignature(body, signature)) {
+			console.log(chalk.default.yellow("  ⚠  Messenger: invalid signature"));
+			return;
+		}
+		let payload;
+		try {
+			payload = JSON.parse(body);
+		} catch {
+			return;
+		}
+		for (const entry of payload.entry || []) for (const messaging of entry.messaging || []) {
+			if (!messaging.message || messaging.message.is_echo) continue;
+			const msgId = messaging.message.mid;
+			if (this.processedIds.has(msgId)) continue;
+			this.processedIds.add(msgId);
+			const senderId = messaging.sender.id;
+			const text = messaging.message.text;
+			if (!text) continue;
+			const allowed = await this.checkDMPolicy(senderId, text);
+			if (!allowed) continue;
+			this.emit("message", {
+				id: msgId,
+				channelId: "messenger",
+				from: senderId,
+				chatId: senderId,
+				text,
+				timestamp: new Date(messaging.timestamp).toISOString(),
+				isDM: true
+			});
+		}
+	}
+	async checkDMPolicy(from, text) {
+		if (this.config.dmPolicy === "none") return false;
+		if (this.config.dmPolicy === "open") return true;
+		if (this.config.dmPolicy === "allowlist") {
+			if (this.config.allowFrom.includes(from)) return true;
+			await this.sendMessage(from, "🦅 HyperClaw: Not on allowlist.");
+			return false;
+		}
+		if (this.config.dmPolicy === "pairing") {
+			if (this.config.approvedPairings.includes(from)) return true;
+			const upper = text.trim().toUpperCase();
+			if (this.config.pendingPairings[upper]) {
+				this.config.approvedPairings.push(from);
+				delete this.config.pendingPairings[upper];
+				await this.saveState();
+				await this.sendMessage(from, "🦅 Paired!");
+				this.emit("pairing:approved", {
+					userId: from,
+					channelId: "messenger"
+				});
+				return true;
+			}
+			const code = Array.from({ length: 6 }, () => "ABCDEFGHJKLMNPQRSTUVWXYZ23456789"[Math.floor(Math.random() * 32)]).join("");
+			this.config.pendingPairings[code] = from;
+			await this.saveState();
+			await this.sendMessage(from, `🦅 Pairing code: ${code}\nApprove: hyperclaw pairing approve messenger ${code}`);
+			return false;
+		}
+		return false;
+	}
+	async sendMessage(recipientId, text) {
+		await fbReq(this.config.pageAccessToken, "/me/messages", {
+			recipient: { id: recipientId },
+			message: { text: text.slice(0, 2e3) }
+		});
+	}
+	approvePairing(code) {
+		const upper = code.toUpperCase();
+		if (!this.config.pendingPairings[upper]) return false;
+		this.config.approvedPairings.push(this.config.pendingPairings[upper]);
+		delete this.config.pendingPairings[upper];
+		this.saveState();
+		return true;
+	}
+	async loadState() {
+		try {
+			const s = await fs_extra.default.readJson(STATE_FILE);
+			if (s.p) this.config.pendingPairings = s.p;
+			if (s.a) this.config.approvedPairings = s.a;
+		} catch {}
+	}
+	async saveState() {
+		await fs_extra.default.ensureDir(path.default.dirname(STATE_FILE));
+		await fs_extra.default.writeJson(STATE_FILE, {
+			p: this.config.pendingPairings,
+			a: this.config.approvedPairings
+		}, { spaces: 2 });
+	}
+	isRunning() {
+		return this.running;
+	}
+};
+
+//#endregion
+exports.MessengerConnector = MessengerConnector;

package/dist/connector-DxKL8VvZ.js

@@ -0,0 +1,182 @@
+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"));
+const http = require_chunk.__toESM(require("http"));
+const https = require_chunk.__toESM(require("https"));
+const events = require_chunk.__toESM(require("events"));
+
+//#region extensions/mattermost/src/connector.ts
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "mattermost-state.json");
+function mattermostApi(serverUrl, token, method, path$2, body) {
+	return new Promise((resolve, reject) => {
+		const base = serverUrl.startsWith("https") ? serverUrl : `https://${serverUrl.replace(/^https?:\/\//, "")}`;
+		const url = new URL(path$2.startsWith("/") ? path$2 : "/" + path$2, base);
+		const payload = body ? JSON.stringify(body) : null;
+		const client = url.protocol === "https:" ? https.default : http.default;
+		const req = client.request({
+			hostname: url.hostname,
+			port: url.port || (url.protocol === "https:" ? 443 : 80),
+			path: url.pathname,
+			method,
+			headers: {
+				"Authorization": `Bearer ${token}`,
+				...payload ? {
+					"Content-Type": "application/json",
+					"Content-Length": Buffer.byteLength(payload)
+				} : {}
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const r = data ? JSON.parse(data) : {};
+					const ok = res.statusCode && res.statusCode >= 200 && res.statusCode < 300;
+					if (ok) resolve(r);
+					else reject(new Error(r.message || r.error || `HTTP ${res.statusCode}`));
+				} catch (e) {
+					reject(e || new Error("Parse error"));
+				}
+			});
+		});
+		req.on("error", reject);
+		if (payload) req.write(payload);
+		req.end();
+	});
+}
+var MattermostConnector = class extends events.EventEmitter {
+	config;
+	running = false;
+	constructor(config) {
+		super();
+		this.config = {
+			dmPolicy: "allowlist",
+			allowFrom: [],
+			approvedPairings: [],
+			pendingPairings: {},
+			...config
+		};
+	}
+	async connect() {
+		const base = this.config.serverUrl.replace(/\/$/, "");
+		await mattermostApi(base, this.config.token, "GET", "/api/v4/users/me");
+		await this.loadState();
+		this.running = true;
+		console.log(chalk.default.green(`  🦅 Mattermost: connected to ${base}`));
+		this.emit("connected", { serverUrl: base });
+	}
+	disconnect() {
+		this.running = false;
+	}
+	/** Parse outgoing webhook payload (form-urlencoded or JSON) */
+	async handleWebhook(body, _opts) {
+		let params;
+		const trimmed = (body || "").trim();
+		if (trimmed.startsWith("{")) try {
+			params = JSON.parse(trimmed);
+		} catch {
+			return;
+		}
+		else {
+			params = {};
+			for (const pair of body.split("&")) {
+				const eq = pair.indexOf("=");
+				const k = eq >= 0 ? decodeURIComponent(pair.slice(0, eq).replace(/\+/g, " ")) : decodeURIComponent(pair.replace(/\+/g, " "));
+				const v = eq >= 0 ? decodeURIComponent((pair.slice(eq + 1) || "").replace(/\+/g, " ")) : "";
+				if (k) params[k] = v;
+			}
+		}
+		const token = params.token;
+		if (token !== this.config.webhookToken) {
+			console.log(chalk.default.yellow("  ⚠  Mattermost: invalid webhook token"));
+			return;
+		}
+		const channelId = params.channel_id;
+		const userId = params.user_id;
+		const userName = params.user_name || "";
+		let text = (params.text || "").trim();
+		const triggerWord = params.trigger_word || "";
+		if (triggerWord && text.startsWith(triggerWord)) text = text.slice(triggerWord.length).trim();
+		if (!channelId || !userId || !text) return;
+		const allowed = await this.checkDMPolicy(userId, text, channelId);
+		if (!allowed) return;
+		this.emit("message", {
+			id: params.post_id || `${channelId}-${Date.now()}`,
+			channelId: "mattermost",
+			from: userId,
+			chatId: channelId,
+			text,
+			timestamp: params.timestamp ? new Date(parseInt(params.timestamp) * 1e3).toISOString() : (/* @__PURE__ */ new Date()).toISOString(),
+			isDM: false,
+			userName
+		});
+	}
+	async checkDMPolicy(userId, text, channelId) {
+		if (this.config.dmPolicy === "none") return false;
+		if (this.config.dmPolicy === "open") return true;
+		if (this.config.dmPolicy === "allowlist") {
+			if (this.config.allowFrom.includes(userId)) return true;
+			await this.sendMessage(channelId, "🦅 HyperClaw: Not on allowlist.");
+			return false;
+		}
+		if (this.config.dmPolicy === "pairing") {
+			if (this.config.approvedPairings.includes(userId)) return true;
+			const upper = text.trim().toUpperCase();
+			if (this.config.pendingPairings[upper]) {
+				this.config.approvedPairings.push(userId);
+				delete this.config.pendingPairings[upper];
+				await this.saveState();
+				await this.sendMessage(channelId, "🦅 Paired!");
+				this.emit("pairing:approved", {
+					userId,
+					channelId: "mattermost"
+				});
+				return true;
+			}
+			const code = Array.from({ length: 6 }, () => "ABCDEFGHJKLMNPQRSTUVWXYZ23456789"[Math.floor(Math.random() * 32)]).join("");
+			this.config.pendingPairings[code] = userId;
+			await this.saveState();
+			await this.sendMessage(channelId, `🦅 Pairing code: ${code}\nApprove: hyperclaw pairing approve mattermost ${code}`);
+			return false;
+		}
+		return false;
+	}
+	async sendMessage(channelId, text) {
+		const base = this.config.serverUrl.replace(/\/$/, "");
+		const chunks = text.match(/.{1,4000}/gs) || [text];
+		for (const chunk of chunks) await mattermostApi(base, this.config.token, "POST", "/api/v4/posts", {
+			channel_id: channelId,
+			message: chunk.slice(0, 16383)
+		});
+	}
+	approvePairing(code) {
+		const upper = code.toUpperCase();
+		if (!this.config.pendingPairings[upper]) return false;
+		this.config.approvedPairings.push(this.config.pendingPairings[upper]);
+		delete this.config.pendingPairings[upper];
+		this.saveState();
+		return true;
+	}
+	async loadState() {
+		try {
+			const s = await fs_extra.default.readJson(STATE_FILE);
+			if (s.pendingPairings) this.config.pendingPairings = s.pendingPairings;
+			if (s.approvedPairings) this.config.approvedPairings = s.approvedPairings;
+		} catch {}
+	}
+	async saveState() {
+		await fs_extra.default.ensureDir(path.default.dirname(STATE_FILE));
+		await fs_extra.default.writeJson(STATE_FILE, {
+			pendingPairings: this.config.pendingPairings,
+			approvedPairings: this.config.approvedPairings
+		}, { spaces: 2 });
+	}
+	isRunning() {
+		return this.running;
+	}
+};
+
+//#endregion
+exports.MattermostConnector = MattermostConnector;