hyperclaw 5.1.9 → 5.2.1

package/dist/connector-CUlP4He3.js

@@ -0,0 +1,194 @@
+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/whatsapp/src/connector.ts
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "whatsapp-state.json");
+const GRAPH_API = "graph.facebook.com";
+const API_VERSION = "v18.0";
+function graphReq(token, method, endpoint, body) {
+	return new Promise((resolve, reject) => {
+		const payload = body ? JSON.stringify(body) : null;
+		const req = https.default.request({
+			hostname: GRAPH_API,
+			port: 443,
+			path: `/${API_VERSION}${endpoint}`,
+			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 = JSON.parse(data);
+					if (r.error) reject(new Error(`${r.error.code}: ${r.error.message}`));
+					else resolve(r);
+				} catch {
+					reject(new Error("Invalid JSON"));
+				}
+			});
+		});
+		req.on("error", reject);
+		if (payload) req.write(payload);
+		req.end();
+	});
+}
+var WhatsAppConnector = class extends events.EventEmitter {
+	config;
+	running = false;
+	constructor(config) {
+		super();
+		this.config = {
+			dmPolicy: "allowlist",
+			allowFrom: [],
+			approvedPairings: [],
+			pendingPairings: {},
+			...config
+		};
+	}
+	async connect() {
+		const info = await graphReq(this.config.accessToken, "GET", `/${this.config.phoneNumberId}`);
+		await this.loadState();
+		this.running = true;
+		console.log(chalk.default.green(`  🦅 WhatsApp: ${info.display_phone_number || this.config.phoneNumberId} connected`));
+		this.emit("connected", {
+			phoneNumberId: this.config.phoneNumberId,
+			number: info.display_phone_number
+		});
+	}
+	disconnect() {
+		this.running = false;
+	}
+	verifyWebhook(mode, token, challenge) {
+		if (mode === "subscribe" && token === this.config.verifyToken) return challenge;
+		return null;
+	}
+	async handleWebhook(body) {
+		let payload;
+		try {
+			payload = JSON.parse(body);
+		} catch {
+			return;
+		}
+		const entry = payload.entry?.[0];
+		const changes = entry?.changes?.[0];
+		const value = changes?.value;
+		if (!value?.messages) return;
+		for (const msg of value.messages) {
+			if (msg.type !== "text") continue;
+			const from = msg.from;
+			const text = msg.text?.body;
+			if (!text) continue;
+			await this.markRead(msg.id).catch(() => {});
+			const allowed = await this.checkDMPolicy(from, text);
+			if (!allowed) continue;
+			this.emit("message", {
+				id: msg.id,
+				channelId: "whatsapp",
+				from,
+				chatId: from,
+				text,
+				timestamp: new Date(parseInt(msg.timestamp) * 1e3).toISOString(),
+				isDM: true,
+				name: value.contacts?.[0]?.profile?.name
+			});
+		}
+	}
+	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: You are not on the 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!* You can now send messages.");
+				this.emit("pairing:approved", {
+					userId: from,
+					channelId: "whatsapp"
+				});
+				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, `🦅 HyperClaw Pairing\n\nCode: *${code}*\nAsk owner: hyperclaw pairing approve whatsapp ${code}`);
+			return false;
+		}
+		return false;
+	}
+	async sendMessage(to, text) {
+		await graphReq(this.config.accessToken, "POST", `/${this.config.phoneNumberId}/messages`, {
+			messaging_product: "whatsapp",
+			to,
+			type: "text",
+			text: {
+				body: text.slice(0, 4096),
+				preview_url: false
+			}
+		});
+	}
+	async markRead(messageId) {
+		await graphReq(this.config.accessToken, "POST", `/${this.config.phoneNumberId}/messages`, {
+			messaging_product: "whatsapp",
+			status: "read",
+			message_id: messageId
+		}).catch(() => {});
+	}
+	async sendTemplate(to, templateName, languageCode = "en_US") {
+		await graphReq(this.config.accessToken, "POST", `/${this.config.phoneNumberId}/messages`, {
+			messaging_product: "whatsapp",
+			to,
+			type: "template",
+			template: {
+				name: templateName,
+				language: { code: languageCode }
+			}
+		});
+	}
+	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.WhatsAppConnector = WhatsAppConnector;

package/dist/connector-CZg2I8Tn.js

@@ -0,0 +1,350 @@
+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/line/src/connector.ts
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "line-state.json");
+const TEXT_CHUNK = 5e3;
+const DEFAULT_MEDIA_MAX_MB = 10;
+function lineReq(token, endpoint, body) {
+	return new Promise((resolve, reject) => {
+		const payload = JSON.stringify(body);
+		const req = https.default.request({
+			hostname: "api.line.me",
+			port: 443,
+			path: 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 {
+					resolve(JSON.parse(data));
+				} catch {
+					resolve({});
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(payload);
+		req.end();
+	});
+}
+/** Start the LINE loading indicator for a chat. */
+function lineLoadingIndicator(token, chatId) {
+	return lineReq(token, "/v2/bot/chat/loading/start", {
+		chatId,
+		loadingSeconds: 20
+	}).catch(() => {});
+}
+/**
+* Strip markdown for plain-text delivery.
+* Code blocks and tables are converted to Flex cards when channelData allows;
+* for plain-text paths they become preformatted text.
+*/
+function stripMarkdown(text) {
+	return text.replace(/```[\s\S]*?```/g, (m) => m.replace(/```\w*\n?/g, "").trim()).replace(/`([^`]+)`/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/\*\*(.+?)\*\*/g, "$1").replace(/\*(.+?)\*/g, "$1").replace(/~~(.+?)~~/g, "$1").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/^\s*[-*+]\s+/gm, "• ").replace(/^\s*\d+\.\s+/gm, (m) => m.trimStart());
+}
+function buildQuickReply(items) {
+	return { items: items.slice(0, 13).map((label) => ({
+		type: "action",
+		action: {
+			type: "message",
+			label: label.slice(0, 20),
+			text: label
+		}
+	})) };
+}
+function buildMessages(text, channelData) {
+	const msgs = [];
+	const plain = stripMarkdown(text);
+	const qr = channelData?.quickReplies?.length ? buildQuickReply(channelData.quickReplies) : void 0;
+	if (channelData?.location) {
+		const loc = channelData.location;
+		msgs.push({
+			type: "location",
+			title: loc.title,
+			address: loc.address,
+			latitude: loc.latitude,
+			longitude: loc.longitude
+		});
+	}
+	if (channelData?.flexMessage) {
+		msgs.push({
+			type: "flex",
+			altText: channelData.flexMessage.altText,
+			contents: channelData.flexMessage.contents,
+			...qr ? { quickReply: qr } : {}
+		});
+		return msgs;
+	}
+	if (channelData?.templateMessage) {
+		const t = channelData.templateMessage;
+		msgs.push({
+			type: "template",
+			altText: t.text,
+			template: {
+				type: "confirm",
+				text: t.text,
+				actions: [{
+					type: "postback",
+					label: t.confirmLabel,
+					data: t.confirmData
+				}, {
+					type: "postback",
+					label: t.cancelLabel,
+					data: t.cancelData
+				}]
+			},
+			...qr ? { quickReply: qr } : {}
+		});
+		return msgs;
+	}
+	const chunks = chunkText(plain);
+	chunks.forEach((chunk, i) => {
+		const isLast = i === chunks.length - 1;
+		msgs.push({
+			type: "text",
+			text: chunk,
+			...isLast && qr ? { quickReply: qr } : {}
+		});
+	});
+	return msgs;
+}
+function chunkText(text) {
+	const chunks = [];
+	for (let i = 0; i < text.length; i += TEXT_CHUNK) chunks.push(text.slice(i, i + TEXT_CHUNK));
+	return chunks.length ? chunks : [""];
+}
+var LINEConnector = class extends events.EventEmitter {
+	config;
+	running = false;
+	_token = "";
+	_secret = "";
+	constructor(config) {
+		super();
+		this.config = {
+			dmPolicy: "pairing",
+			allowFrom: [],
+			groupPolicy: "allowlist",
+			groupAllowFrom: [],
+			approvedPairings: [],
+			pendingPairings: {},
+			mediaMaxMb: DEFAULT_MEDIA_MAX_MB,
+			...config
+		};
+	}
+	/** Resolve token and secret (inline value takes priority over file). */
+	async resolveCredentials() {
+		this._token = this.config.channelAccessToken || (this.config.tokenFile ? (await fs_extra.default.readFile(this.config.tokenFile, "utf8")).trim() : "");
+		this._secret = this.config.channelSecret || (this.config.secretFile ? (await fs_extra.default.readFile(this.config.secretFile, "utf8")).trim() : "");
+		if (!this._token || !this._secret) throw new Error("LINE: channelAccessToken and channelSecret are required (or set tokenFile/secretFile).");
+	}
+	async connect() {
+		await this.resolveCredentials();
+		await this.loadState();
+		this.running = true;
+		const wPath = this.config.webhookPath || "/line/webhook";
+		console.log(chalk.default.green(`  🟩 LINE: connected (webhook mode — ${wPath})`));
+		this.emit("connected", {});
+	}
+	disconnect() {
+		this.running = false;
+	}
+	verifySignature(rawBody, signature) {
+		const expected = crypto.default.createHmac("sha256", this._secret).update(rawBody).digest("base64");
+		try {
+			return crypto.default.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
+		} catch {
+			return false;
+		}
+	}
+	async handleWebhook(rawBody, signature) {
+		if (!this.verifySignature(rawBody, signature)) {
+			console.log(chalk.default.yellow("  ⚠  LINE: invalid signature — check channelSecret"));
+			return;
+		}
+		let payload;
+		try {
+			payload = JSON.parse(rawBody);
+		} catch {
+			return;
+		}
+		for (const event of payload.events || []) await this.handleEvent(event);
+	}
+	async handleEvent(event) {
+		const src = event.source || {};
+		const sourceType = src.type || "user";
+		const userId = src.userId || "";
+		const groupId = src.groupId || src.roomId || "";
+		const replyToken = event.replyToken || "";
+		const isGroup = sourceType === "group" || sourceType === "room";
+		if (event.type === "postback") {
+			const data = event.postback?.data || "";
+			if (!data || !userId) return;
+			if (isGroup) {
+				if (!this.isGroupAllowed(groupId, userId)) return;
+			} else if (!await this.checkDMPolicy(userId, data, replyToken)) return;
+			this.emit("message", {
+				channelId: "line",
+				chatId: isGroup ? groupId : userId,
+				from: userId,
+				text: data,
+				replyToken,
+				isDM: !isGroup
+			});
+			return;
+		}
+		if (event.type !== "message") return;
+		const msgType = event.message?.type || "";
+		const messageId = event.message?.id || "";
+		let text = "";
+		switch (msgType) {
+			case "text":
+				text = event.message.text || "";
+				break;
+			case "location":
+				text = [
+					event.message.title,
+					event.message.address,
+					`${event.message.latitude},${event.message.longitude}`
+				].filter(Boolean).join(" | ");
+				break;
+			case "sticker":
+				text = `[sticker:${event.message.packageId}/${event.message.stickerId}]`;
+				break;
+			case "image":
+			case "video":
+			case "audio":
+			case "file": {
+				const maxBytes = (this.config.mediaMaxMb ?? DEFAULT_MEDIA_MAX_MB) * 1024 * 1024;
+				const contentUrl = `/v2/bot/message/${messageId}/content`;
+				text = `[${msgType}:${contentUrl} max:${maxBytes}b]`;
+				break;
+			}
+			default: return;
+		}
+		if (!userId || !text) return;
+		if (isGroup) {
+			if (!this.isGroupAllowed(groupId, userId)) return;
+			lineLoadingIndicator(this._token, groupId);
+			this.emit("message", {
+				channelId: "line",
+				chatId: groupId,
+				from: userId,
+				text,
+				replyToken,
+				isDM: false
+			});
+		} else {
+			const allowed = await this.checkDMPolicy(userId, text, replyToken);
+			if (!allowed) return;
+			lineLoadingIndicator(this._token, userId);
+			this.emit("message", {
+				channelId: "line",
+				chatId: userId,
+				from: userId,
+				text,
+				replyToken,
+				isDM: true,
+				timestamp: new Date(event.timestamp).toISOString()
+			});
+		}
+	}
+	isGroupAllowed(groupId, userId) {
+		if (this.config.groupPolicy === "disabled") return false;
+		if (this.config.groupPolicy === "open") return true;
+		const perGroup = this.config.groups?.[groupId]?.allowFrom;
+		const list = perGroup ?? this.config.groupAllowFrom;
+		return list.includes(userId) || list.includes(groupId);
+	}
+	async checkDMPolicy(from, text, replyToken) {
+		switch (this.config.dmPolicy) {
+			case "disabled": return false;
+			case "open": return true;
+			case "allowlist":
+				if (this.config.allowFrom.includes(from)) return true;
+				await this.replyMessage(replyToken, "HyperClaw: Not on allowlist.");
+				return false;
+			case "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.replyMessage(replyToken, "Paired!");
+					this.emit("pairing:approved", {
+						userId: from,
+						channelId: "line"
+					});
+					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.replyMessage(replyToken, `Pairing code: ${code}\nApprove: hyperclaw pairing approve line ${code}`);
+				return false;
+			}
+			default: return false;
+		}
+	}
+	async replyMessage(replyToken, text, channelData) {
+		const messages = buildMessages(text, channelData).slice(0, 5);
+		await lineReq(this._token, "/v2/bot/message/reply", {
+			replyToken,
+			messages
+		});
+	}
+	async pushMessage(to, text, channelData) {
+		const messages = buildMessages(text, channelData).slice(0, 5);
+		await lineReq(this._token, "/v2/bot/message/push", {
+			to,
+			messages
+		});
+	}
+	/** Unified send — uses replyToken when available, falls back to push. */
+	async sendMessage(chatId, text, replyToken, channelData) {
+		const id = String(chatId);
+		if (replyToken) await this.replyMessage(replyToken, text, channelData);
+		else await this.pushMessage(id, text, channelData);
+	}
+	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.LINEConnector = LINEConnector;