hyperclaw 4.0.1 → 5.0.0

package/dist/connector-BGjbBy69.js

@@ -0,0 +1,225 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const os = require_chunk.__toESM(require("os"));
+const child_process = require_chunk.__toESM(require("child_process"));
+const events = require_chunk.__toESM(require("events"));
+
+//#region extensions/imessage-native/src/connector.ts
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "imessage-native-state.json");
+const PAIRING_TTL_MS = 60 * 60 * 1e3;
+var IMessageNativeConnector = class extends events.EventEmitter {
+	config;
+	rpcProc = null;
+	running = false;
+	lastMessageTs = 0;
+	rpcSeq = 1;
+	pending = /* @__PURE__ */ new Map();
+	buf = "";
+	constructor(config = {}) {
+		super();
+		this.config = {
+			cliPath: config.cliPath || process.env.IMSG_PATH || "imsg",
+			dbPath: config.dbPath || path.default.join(os.default.homedir(), "Library", "Messages", "chat.db"),
+			dmPolicy: config.dmPolicy ?? "pairing",
+			allowFrom: config.allowFrom ?? [],
+			approvedPairings: config.approvedPairings ?? [],
+			pendingPairings: config.pendingPairings ?? {},
+			pendingPairingTs: config.pendingPairingTs ?? {}
+		};
+	}
+	async connect() {
+		if (process.platform !== "darwin") throw new Error("imessage-native is macOS only. For new deployments use BlueBubbles.");
+		await this.loadState();
+		this.running = true;
+		this.emit("connected", {});
+		this.startRpc();
+	}
+	startRpc() {
+		if (!this.running) return;
+		const bin = this.config.cliPath;
+		const args = ["rpc"];
+		if (this.config.dbPath) args.push("--db", this.config.dbPath);
+		this.rpcProc = (0, child_process.spawn)(bin, args, { stdio: [
+			"pipe",
+			"pipe",
+			"pipe"
+		] });
+		this.rpcProc.stdout?.on("data", (chunk) => {
+			this.buf += chunk.toString();
+			const lines = this.buf.split("\n");
+			this.buf = lines.pop() || "";
+			for (const line of lines) {
+				if (!line.trim()) continue;
+				try {
+					this.handleRpcLine(JSON.parse(line));
+				} catch {}
+			}
+		});
+		this.rpcProc.stderr?.on("data", () => {});
+		this.rpcProc.on("error", () => {});
+		this.rpcProc.on("exit", (code) => {
+			this.rpcProc = null;
+			this.buf = "";
+			for (const [, cb] of this.pending) cb.reject(new Error("imsg rpc exited"));
+			this.pending.clear();
+			if (this.running && code !== 0) setTimeout(() => this.startRpc(), 5e3);
+		});
+		this.rpcSend("messages.watch", {}).catch(() => {});
+	}
+	handleRpcLine(msg) {
+		if (!msg.id && msg.method === "message" && msg.params) {
+			this.onIncomingMessage(msg.params);
+			return;
+		}
+		if (msg.id != null) {
+			const cb = this.pending.get(msg.id);
+			if (!cb) return;
+			this.pending.delete(msg.id);
+			if (msg.error) cb.reject(new Error(msg.error.message));
+			else cb.resolve(msg.result);
+		}
+	}
+	onIncomingMessage(params) {
+		if (params.isFromMe) return;
+		const handle = params.handle?.address || params.sender || params.chatId || params.from;
+		const text = params.text || params.body || params.message;
+		if (!handle || !text) return;
+		const ts = params.dateCreated || params.timestamp || Date.now();
+		if (ts <= this.lastMessageTs) return;
+		this.lastMessageTs = ts;
+		this.saveState();
+		this.checkDMPolicyAndEmit(handle, text);
+	}
+	pruneExpiredCodes() {
+		const now = Date.now();
+		const ts = this.config.pendingPairingTs;
+		for (const code of Object.keys(ts)) if (now - ts[code] > PAIRING_TTL_MS) {
+			delete this.config.pendingPairings[code];
+			delete ts[code];
+		}
+	}
+	async checkDMPolicyAndEmit(from, text) {
+		if (this.config.dmPolicy === "disabled") return;
+		if (this.config.dmPolicy === "open") {
+			this.emit("message", {
+				chatId: from,
+				text
+			});
+			return;
+		}
+		if (this.config.dmPolicy === "allowlist") {
+			if (this.config.allowFrom.includes(from)) this.emit("message", {
+				chatId: from,
+				text
+			});
+			else await this.sendMessage(from, "HyperClaw: Not on allowlist.");
+			return;
+		}
+		this.pruneExpiredCodes();
+		if (this.config.approvedPairings.includes(from)) {
+			this.emit("message", {
+				chatId: from,
+				text
+			});
+			return;
+		}
+		const code = (text.trim().toUpperCase().match(/[A-Z0-9]{6}/) || [])[0];
+		if (code && this.config.pendingPairings[code]) {
+			this.config.approvedPairings.push(from);
+			delete this.config.pendingPairings[code];
+			delete this.config.pendingPairingTs[code];
+			await this.saveState();
+			await this.sendMessage(from, "Paired!");
+			this.emit("pairing:approved", {
+				userId: from,
+				channelId: "imessage-native"
+			});
+			this.emit("message", {
+				chatId: from,
+				text
+			});
+			return;
+		}
+		const newCode = Array.from({ length: 6 }, () => "ABCDEFGHJKLMNPQRSTUVWXYZ23456789"[Math.floor(Math.random() * 32)]).join("");
+		this.config.pendingPairings[newCode] = from;
+		this.config.pendingPairingTs[newCode] = Date.now();
+		await this.saveState();
+		await this.sendMessage(from, `Pairing code: ${newCode}\nApprove: hyperclaw pairing approve imessage-native ${newCode}\n(expires in 1 hour)`);
+	}
+	async sendMessage(chatId, text) {
+		const to = String(chatId).trim();
+		if (!to) return;
+		if (!this.rpcProc) throw new Error("imsg rpc not running");
+		await this.rpcSend("messages.send", {
+			to,
+			text
+		});
+	}
+	rpcSend(method, params) {
+		return new Promise((resolve, reject) => {
+			if (!this.rpcProc?.stdin) {
+				reject(new Error("imsg rpc stdin unavailable"));
+				return;
+			}
+			const id = this.rpcSeq++;
+			const req = {
+				jsonrpc: "2.0",
+				id,
+				method,
+				params
+			};
+			this.pending.set(id, {
+				resolve,
+				reject
+			});
+			this.rpcProc.stdin.write(JSON.stringify(req) + "\n");
+			const timer = setTimeout(() => {
+				if (this.pending.has(id)) {
+					this.pending.delete(id);
+					reject(new Error(`imsg rpc timeout for method ${method}`));
+				}
+			}, 15e3);
+			const orig = this.pending.get(id);
+			this.pending.set(id, {
+				resolve: (v) => {
+					clearTimeout(timer);
+					orig.resolve(v);
+				},
+				reject: (e) => {
+					clearTimeout(timer);
+					orig.reject(e);
+				}
+			});
+		});
+	}
+	disconnect() {
+		this.running = false;
+		this.rpcProc?.kill();
+		this.rpcProc = null;
+		this.buf = "";
+		for (const [, cb] of this.pending) cb.reject(new Error("disconnected"));
+		this.pending.clear();
+	}
+	async loadState() {
+		try {
+			const s = await fs_extra.default.readJson(STATE_FILE);
+			this.lastMessageTs = s.lastTs || 0;
+			if (s.p) this.config.pendingPairings = s.p;
+			if (s.a) this.config.approvedPairings = s.a;
+			if (s.pts) this.config.pendingPairingTs = s.pts;
+		} catch {}
+	}
+	async saveState() {
+		await fs_extra.default.ensureDir(path.default.dirname(STATE_FILE));
+		await fs_extra.default.writeJson(STATE_FILE, {
+			lastTs: this.lastMessageTs,
+			p: this.config.pendingPairings,
+			a: this.config.approvedPairings,
+			pts: this.config.pendingPairingTs
+		}, { spaces: 2 });
+	}
+};
+
+//#endregion
+exports.IMessageNativeConnector = IMessageNativeConnector;

package/dist/connector-BO2SRzfG.js

@@ -0,0 +1,218 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const chalk = require_chunk.__toESM(require("chalk"));
+const events = require_chunk.__toESM(require("events"));
+const irc = require_chunk.__toESM(require("irc"));
+
+//#region extensions/irc/src/connector.ts
+function resolveEnvConfig(cfg) {
+	return {
+		server: cfg.server || process.env["IRC_HOST"] || "",
+		port: cfg.port ?? (process.env["IRC_PORT"] ? parseInt(process.env["IRC_PORT"], 10) : void 0),
+		tls: cfg.tls ?? (process.env["IRC_TLS"] === "true" || process.env["IRC_TLS"] === "1"),
+		nick: cfg.nick || process.env["IRC_NICK"] || "hyperclaw-bot",
+		username: cfg.username || process.env["IRC_USERNAME"],
+		realname: cfg.realname || process.env["IRC_REALNAME"],
+		password: cfg.password || process.env["IRC_PASSWORD"],
+		channels: cfg.channels?.length ? cfg.channels : process.env["IRC_CHANNELS"]?.split(",").map((c) => c.trim()).filter(Boolean) ?? [],
+		nickserv: cfg.nickserv ?? (process.env["IRC_NICKSERV_PASSWORD"] ? {
+			enabled: true,
+			service: "NickServ",
+			password: process.env["IRC_NICKSERV_PASSWORD"],
+			registerEmail: process.env["IRC_NICKSERV_REGISTER_EMAIL"]
+		} : void 0),
+		dmPolicy: cfg.dmPolicy ?? "pairing",
+		allowFrom: cfg.allowFrom ?? [],
+		groupPolicy: cfg.groupPolicy ?? "allowlist",
+		groupAllowFrom: cfg.groupAllowFrom ?? [],
+		groups: cfg.groups ?? {},
+		dangerouslyAllowNameMatching: cfg.dangerouslyAllowNameMatching ?? false
+	};
+}
+/** Match a sender (nick!user@host or bare nick) against an allowFrom entry. */
+function matchSender(sender, pattern, allowBareNick) {
+	if (pattern === "*") return true;
+	if (pattern.startsWith("id:")) {
+		const id = pattern.slice(3);
+		return sender === id || sender.startsWith(id + "!");
+	}
+	if (pattern === sender) return true;
+	if (allowBareNick) {
+		const nick = sender.split("!")[0];
+		return nick === pattern;
+	}
+	return false;
+}
+function senderAllowed(sender, allowList, allowBareNick) {
+	if (!allowList.length) return false;
+	return allowList.some((p) => matchSender(sender, p, allowBareNick));
+}
+/** Return the first matching ToolsBySender policy for a sender. */
+function resolveToolsBySender(sender, toolsBySender, allowBareNick) {
+	for (const [pattern, policy] of Object.entries(toolsBySender)) {
+		const pat = pattern.startsWith("id:") ? pattern : `id:${pattern}`;
+		if (matchSender(sender, pat === "id:*" ? "*" : pat, allowBareNick)) return policy;
+	}
+	return void 0;
+}
+/** Resolve effective tool policy for a sender in a channel. */
+function resolveToolPolicy(sender, channelCfg, allowBareNick) {
+	if (!channelCfg) return void 0;
+	if (channelCfg.toolsBySender) {
+		const byS = resolveToolsBySender(sender, channelCfg.toolsBySender, allowBareNick);
+		if (byS) return byS;
+	}
+	return channelCfg.tools;
+}
+/** Find the best group config for a channel name. */
+function getGroupConfig(channel, groups) {
+	return groups[channel] ?? groups["*"];
+}
+var IrcConnector = class extends events.EventEmitter {
+	client = null;
+	config;
+	constructor(rawConfig) {
+		super();
+		this.config = resolveEnvConfig(rawConfig);
+	}
+	async connect() {
+		return new Promise((resolve, reject) => {
+			const cfg = this.config;
+			const useTls = cfg.tls ?? false;
+			const port = cfg.port ?? (useTls ? 6697 : 6667);
+			const channels = (cfg.channels ?? []).map((c) => c.startsWith("#") ? c : `#${c}`);
+			this.client = new irc.default.Client(cfg.server, cfg.nick, {
+				port,
+				secure: useTls,
+				channels,
+				userName: cfg.username ?? cfg.nick,
+				realName: cfg.realname ?? "HyperClaw IRC Bot",
+				password: cfg.password,
+				autoConnect: true,
+				debug: false,
+				showErrors: true,
+				stripColors: true
+			});
+			this.client.on("registered", () => {
+				console.log(chalk.default.green(`  🦅 IRC: ${cfg.nick} on ${cfg.server}:${port}${useTls ? " (TLS)" : ""} connected`));
+				this._handleNickServ();
+				this.emit("connected", {
+					server: cfg.server,
+					nick: cfg.nick,
+					port,
+					tls: useTls
+				});
+				resolve();
+			});
+			this.client.on("error", (err) => {
+				console.log(chalk.default.yellow(`  ⚠ IRC error: ${err.message}`));
+				reject(err);
+			});
+			this.client.on("message", (from, to, message) => {
+				const isChannel = to.startsWith("#");
+				if (isChannel) this._handleChannelMessage(from, to, message);
+				else this._handleDm(from, message);
+			});
+			this.client.on("pm", (from, message) => {
+				this._handleDm(from, message);
+			});
+		});
+	}
+	_handleNickServ() {
+		const ns = this.config.nickserv;
+		if (!ns?.enabled) return;
+		const service = ns.service ?? "NickServ";
+		const nsPassword = ns.password ?? process.env["IRC_NICKSERV_PASSWORD"];
+		if (ns.register && ns.registerEmail) {
+			console.log(chalk.default.gray(`  IRC NickServ: attempting REGISTER`));
+			this.client.say(service, `REGISTER ${nsPassword} ${ns.registerEmail}`);
+		} else if (nsPassword) {
+			console.log(chalk.default.gray(`  IRC NickServ: identifying`));
+			this.client.say(service, `IDENTIFY ${nsPassword}`);
+		}
+	}
+	_handleChannelMessage(from, channel, message) {
+		const cfg = this.config;
+		const text = message.trim();
+		if (!text) return;
+		const groupCfg = getGroupConfig(channel, cfg.groups ?? {});
+		if (cfg.groupPolicy === "allowlist") {
+			const defined = cfg.groups && (cfg.groups[channel] !== void 0 || cfg.groups["*"] !== void 0);
+			if (!defined) {
+				console.log(chalk.default.gray(`  irc: drop channel ${channel} (groupPolicy=allowlist, not in groups)`));
+				return;
+			}
+		}
+		const allowBareNick = cfg.dangerouslyAllowNameMatching ?? false;
+		const perChannelAllow = groupCfg?.allowFrom ?? [];
+		const globalGroupAllow = cfg.groupAllowFrom ?? [];
+		const effectiveAllow = perChannelAllow.length ? perChannelAllow : globalGroupAllow;
+		if (effectiveAllow.length && !senderAllowed(from, effectiveAllow, allowBareNick)) {
+			console.log(chalk.default.gray(`  irc: drop group sender ${from} (policy=allowlist)`));
+			return;
+		}
+		const requireMention = groupCfg?.requireMention ?? true;
+		if (requireMention) {
+			const mentionPatterns = [
+				cfg.nick,
+				`${cfg.nick}:`,
+				`@${cfg.nick}`,
+				`${cfg.nick},`
+			];
+			const mentioned = mentionPatterns.some((p) => text.toLowerCase().startsWith(p.toLowerCase()));
+			if (!mentioned) {
+				console.log(chalk.default.gray(`  irc: drop channel ${channel} (missing-mention)`));
+				return;
+			}
+		}
+		const toolPolicy = resolveToolPolicy(from, groupCfg, allowBareNick);
+		const payload = {
+			chatId: channel,
+			text,
+			from,
+			to: channel,
+			isChannel: true,
+			...toolPolicy ? { toolPolicy } : {}
+		};
+		this.emit("message", payload);
+	}
+	_handleDm(from, message) {
+		const cfg = this.config;
+		const text = message.trim();
+		if (!text) return;
+		if (cfg.dmPolicy === "none") return;
+		if (cfg.dmPolicy === "allowlist") {
+			const allowBareNick = cfg.dangerouslyAllowNameMatching ?? false;
+			const allowList = cfg.allowFrom ?? [];
+			if (!senderAllowed(from, allowList, allowBareNick)) {
+				console.log(chalk.default.gray(`  irc: drop DM from ${from} (dmPolicy=allowlist)`));
+				return;
+			}
+		}
+		const payload = {
+			chatId: from,
+			text,
+			from,
+			to: from,
+			isChannel: false
+		};
+		this.emit("message", payload);
+	}
+	async sendMessage(chatId, text) {
+		if (!this.client) throw new Error("IRC not connected");
+		const lines = text.split("\n").filter(Boolean);
+		for (const line of lines) this.client.say(chatId, line);
+	}
+	async disconnect() {
+		if (this.client) {
+			this.client.disconnect();
+			this.client = null;
+		}
+	}
+	getToolPolicy(sender, channel) {
+		const groupCfg = getGroupConfig(channel, this.config.groups ?? {});
+		return resolveToolPolicy(sender, groupCfg, this.config.dangerouslyAllowNameMatching ?? false);
+	}
+};
+
+//#endregion
+exports.IrcConnector = IrcConnector;

package/dist/connector-BOlqjXWP.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 crypto = require_chunk.__toESM(require("crypto"));
+const https = require_chunk.__toESM(require("https"));
+const events = require_chunk.__toESM(require("events"));
+
+//#region extensions/viber/src/connector.ts
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "viber-state.json");
+function viberReq(token, endpoint, body) {
+	return new Promise((resolve, reject) => {
+		const payload = JSON.stringify(body);
+		const req = https.default.request({
+			hostname: "chatapi.viber.com",
+			port: 443,
+			path: `/pa${endpoint}`,
+			method: "POST",
+			headers: {
+				"X-Viber-Auth-Token": 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.status !== 0) reject(new Error(r.status_message));
+					else resolve(r);
+				} catch {
+					reject(new Error("Invalid JSON"));
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(payload);
+		req.end();
+	});
+}
+var ViberConnector = class extends events.EventEmitter {
+	config;
+	running = false;
+	constructor(config) {
+		super();
+		this.config = {
+			dmPolicy: "allowlist",
+			allowFrom: [],
+			approvedPairings: [],
+			pendingPairings: {},
+			...config
+		};
+	}
+	async connect() {
+		await viberReq(this.config.authToken, "/set_webhook", {
+			url: this.config.webhookUrl,
+			event_types: [
+				"delivered",
+				"seen",
+				"failed",
+				"subscribed",
+				"unsubscribed",
+				"conversation_started"
+			],
+			send_name: true
+		});
+		const info = await viberReq(this.config.authToken, "/get_account_info", {});
+		await this.loadState();
+		this.running = true;
+		console.log(chalk.default.green(`  🦅 Viber: ${info.name || this.config.botName} connected`));
+		this.emit("connected", { name: info.name });
+	}
+	disconnect() {
+		this.running = false;
+	}
+	verifySignature(body, signature) {
+		const expected = crypto.default.createHmac("sha256", this.config.authToken).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("  ⚠  Viber: invalid signature"));
+			return;
+		}
+		let payload;
+		try {
+			payload = JSON.parse(body);
+		} catch {
+			return;
+		}
+		if (payload.event === "message") {
+			const userId = payload.sender?.id;
+			const text = payload.message?.text;
+			if (!userId || !text) return;
+			const allowed = await this.checkDMPolicy(userId, text);
+			if (!allowed) return;
+			this.emit("message", {
+				id: payload.message_token?.toString(),
+				channelId: "viber",
+				from: userId,
+				chatId: userId,
+				text,
+				senderName: payload.sender?.name,
+				timestamp: new Date(payload.timestamp).toISOString(),
+				isDM: true
+			});
+		}
+		if (payload.event === "conversation_started") await this.sendMessage(payload.user?.id, `🦅 Hi ${payload.user?.name || "there"}! I'm HyperClaw.`);
+	}
+	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: "viber"
+				});
+				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 viber ${code}`);
+			return false;
+		}
+		return false;
+	}
+	async sendMessage(userId, text) {
+		await viberReq(this.config.authToken, "/send_message", {
+			receiver: userId,
+			type: "text",
+			sender: { name: this.config.botName },
+			text: text.slice(0, 7e3)
+		});
+	}
+	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.ViberConnector = ViberConnector;