hyperclaw 5.2.8 → 5.2.9

package/dist/connector-B_XkXm-j.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-BkY1I6gf.js

@@ -0,0 +1,189 @@
+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/msteams/src/connector.ts
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "msteams-state.json");
+let cachedToken = null;
+async function getBotToken(appId, appPassword) {
+	if (cachedToken && cachedToken.expiresAt > Date.now() + 6e4) return cachedToken.token;
+	return new Promise((resolve, reject) => {
+		const body = `grant_type=client_credentials&client_id=${encodeURIComponent(appId)}&client_secret=${encodeURIComponent(appPassword)}&scope=https%3A%2F%2Fapi.botframework.com%2F.default`;
+		const req = https.default.request({
+			hostname: "login.microsoftonline.com",
+			port: 443,
+			path: "/botframework.com/oauth2/v2.0/token",
+			method: "POST",
+			headers: {
+				"Content-Type": "application/x-www-form-urlencoded",
+				"Content-Length": Buffer.byteLength(body)
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const r = JSON.parse(data);
+					cachedToken = {
+						token: r.access_token,
+						expiresAt: Date.now() + r.expires_in * 1e3
+					};
+					resolve(r.access_token);
+				} catch {
+					reject(new Error("Token parse error"));
+				}
+			});
+		});
+		req.on("error", reject);
+		req.write(body);
+		req.end();
+	});
+}
+async function sendActivity(token, serviceUrl, conversationId, activity) {
+	const url = new URL(`${serviceUrl}v3/conversations/${conversationId}/activities`);
+	return new Promise((resolve, reject) => {
+		const payload = JSON.stringify(activity);
+		const req = https.default.request({
+			hostname: url.hostname,
+			port: 443,
+			path: url.pathname,
+			method: "POST",
+			headers: {
+				"Authorization": `Bearer ${token}`,
+				"Content-Type": "application/json",
+				"Content-Length": Buffer.byteLength(payload)
+			}
+		}, (res) => {
+			res.on("data", () => {});
+			res.on("end", resolve);
+		});
+		req.on("error", reject);
+		req.write(payload);
+		req.end();
+	});
+}
+var MSTeamsConnector = class extends events.EventEmitter {
+	config;
+	running = false;
+	constructor(config) {
+		super();
+		this.config = {
+			dmPolicy: "allowlist",
+			allowFrom: [],
+			approvedPairings: [],
+			pendingPairings: {},
+			...config
+		};
+	}
+	async connect() {
+		await getBotToken(this.config.appId, this.config.appPassword);
+		await this.loadState();
+		this.running = true;
+		console.log(chalk.default.green(`  🦅 MS Teams: Bot ${this.config.appId} connected`));
+		this.emit("connected", { appId: this.config.appId });
+	}
+	disconnect() {
+		this.running = false;
+	}
+	async handleWebhook(body) {
+		let activity;
+		try {
+			activity = JSON.parse(body);
+		} catch {
+			return;
+		}
+		if (activity.type !== "message") return;
+		const from = activity.from?.aadObjectId || activity.from?.id;
+		const text = activity.text?.replace(/<at>[^<]+<\/at>/g, "").trim();
+		const serviceUrl = activity.serviceUrl;
+		const conversationId = activity.conversation?.id;
+		if (!from || !text || !serviceUrl || !conversationId) return;
+		const allowed = await this.checkDMPolicy(from, text, serviceUrl, conversationId, activity);
+		if (!allowed) return;
+		this.emit("message", {
+			id: activity.id,
+			channelId: "msteams",
+			from,
+			chatId: conversationId,
+			fromName: activity.from?.name,
+			text,
+			timestamp: activity.timestamp || (/* @__PURE__ */ new Date()).toISOString(),
+			isDM: activity.conversation?.conversationType === "personal",
+			serviceUrl,
+			activity
+		});
+	}
+	async checkDMPolicy(from, text, serviceUrl, convId, activity) {
+		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.reply(serviceUrl, convId, activity, "🦅 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.reply(serviceUrl, convId, activity, "🦅 Paired!");
+				this.emit("pairing:approved", {
+					userId: from,
+					channelId: "msteams"
+				});
+				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.reply(serviceUrl, convId, activity, `🦅 Pairing code: ${code}\nApprove: hyperclaw pairing approve msteams ${code}`);
+			return false;
+		}
+		return false;
+	}
+	async reply(serviceUrl, conversationId, originalActivity, text) {
+		const token = await getBotToken(this.config.appId, this.config.appPassword);
+		await sendActivity(token, serviceUrl, conversationId, {
+			type: "message",
+			text: text.slice(0, 4e3),
+			replyToId: originalActivity.id,
+			from: { id: this.config.appId },
+			conversation: originalActivity.conversation,
+			recipient: originalActivity.from
+		});
+	}
+	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.MSTeamsConnector = MSTeamsConnector;