hyperclaw 5.0.1 → 5.0.2

package/dist/connector-B4jeCULG.js

@@ -0,0 +1,305 @@
+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/synology-chat/src/connector.ts
+function resolveAllowedIds(raw, envVal) {
+	if (Array.isArray(raw) && raw.length) return raw;
+	if (typeof raw === "string" && raw.trim()) return raw.split(",").map((s) => s.trim()).filter(Boolean);
+	if (envVal) return envVal.split(",").map((s) => s.trim()).filter(Boolean);
+	return [];
+}
+function resolveAccount(id, raw, state) {
+	const token = raw.token || process.env["SYNOLOGY_CHAT_TOKEN"] || "";
+	const incomingUrl = raw.incomingUrl || process.env["SYNOLOGY_CHAT_INCOMING_URL"] || "";
+	const allowedUserIds = resolveAllowedIds(raw.allowedUserIds, process.env["SYNOLOGY_ALLOWED_USER_IDS"]);
+	const rateLimitPerMinute = raw.rateLimitPerMinute ?? (process.env["SYNOLOGY_RATE_LIMIT"] ? parseInt(process.env["SYNOLOGY_RATE_LIMIT"], 10) : 30);
+	return {
+		id,
+		name: raw.name ?? process.env["OPENCLAW_BOT_NAME"] ?? id,
+		token,
+		incomingUrl,
+		webhookPath: raw.webhookPath ?? "/webhook/synology",
+		dmPolicy: raw.dmPolicy ?? "allowlist",
+		allowedUserIds,
+		rateLimitPerMinute,
+		allowInsecureSsl: raw.allowInsecureSsl ?? false,
+		approvedPairings: state.approved,
+		pendingPairings: state.pending
+	};
+}
+var RateLimiter = class {
+	windows = /* @__PURE__ */ new Map();
+	constructor(limitPerMinute) {
+		this.limitPerMinute = limitPerMinute;
+	}
+	allow(senderId) {
+		if (this.limitPerMinute <= 0) return true;
+		const now = Date.now();
+		const cutoff = now - 6e4;
+		const timestamps = (this.windows.get(senderId) ?? []).filter((t) => t > cutoff);
+		if (timestamps.length >= this.limitPerMinute) return false;
+		timestamps.push(now);
+		this.windows.set(senderId, timestamps);
+		return true;
+	}
+};
+function postToSynology(incomingUrl, text, userId, allowInsecureSsl = false) {
+	return new Promise((resolve, reject) => {
+		const u = new URL(incomingUrl);
+		const isHttps = u.protocol === "https:";
+		const mod = isHttps ? https.default : http.default;
+		const payloadObj = { text };
+		if (userId) payloadObj.user_ids = [parseInt(userId, 10)].filter((n) => !isNaN(n));
+		const encoded = `payload=${encodeURIComponent(JSON.stringify(payloadObj))}`;
+		const options = {
+			hostname: u.hostname,
+			port: u.port || (isHttps ? 443 : 80),
+			path: u.pathname + u.search,
+			method: "POST",
+			headers: {
+				"Content-Type": "application/x-www-form-urlencoded",
+				"Content-Length": Buffer.byteLength(encoded)
+			}
+		};
+		if (isHttps && allowInsecureSsl) options.rejectUnauthorized = false;
+		const req = (isHttps ? https.default : http.default).request(options, (res) => {
+			res.resume();
+			res.on("end", resolve);
+		});
+		req.on("error", reject);
+		req.write(encoded);
+		req.end();
+	});
+}
+const STATE_DIR = path.default.join(os.default.homedir(), ".hyperclaw");
+var SingleAccountConnector = class extends events.EventEmitter {
+	acc;
+	rateLimiter;
+	constructor(acc) {
+		super();
+		this.acc = acc;
+		this.rateLimiter = new RateLimiter(acc.rateLimitPerMinute);
+	}
+	validate() {
+		const { dmPolicy, allowedUserIds, token, incomingUrl } = this.acc;
+		if (!token) throw new Error(`Synology Chat[${this.acc.id}]: 'token' is required (set SYNOLOGY_CHAT_TOKEN or config)`);
+		if (!incomingUrl) throw new Error(`Synology Chat[${this.acc.id}]: 'incomingUrl' is required`);
+		if (dmPolicy === "allowlist" && allowedUserIds.length === 0) throw new Error(`Synology Chat[${this.acc.id}]: dmPolicy="allowlist" requires at least one allowedUserId. Use dmPolicy="open" to allow all senders.`);
+	}
+	async handleWebhook(body) {
+		let params;
+		try {
+			params = new URLSearchParams(body);
+		} catch {
+			return {
+				status: 400,
+				body: "Bad Request"
+			};
+		}
+		const inboundToken = params.get("token");
+		if (inboundToken !== this.acc.token) {
+			console.log(chalk.default.yellow(`  ⚠ Synology Chat[${this.acc.id}]: invalid token`));
+			return {
+				status: 403,
+				body: "Forbidden"
+			};
+		}
+		const text = (params.get("text") ?? "").trim();
+		const userId = params.get("user_id") ?? "";
+		const username = params.get("username") ?? userId;
+		const channelId = params.get("channel_id") ?? "";
+		const timestamp = params.get("timestamp") ?? String(Date.now());
+		if (!text || !userId) return {
+			status: 200,
+			body: "{}"
+		};
+		if (!this.rateLimiter.allow(userId)) {
+			console.log(chalk.default.gray(`  synology-chat[${this.acc.id}]: rate-limited sender ${userId}`));
+			return {
+				status: 429,
+				body: "Too Many Requests"
+			};
+		}
+		const allowed = await this._checkPolicy(userId, channelId, text);
+		if (!allowed) return {
+			status: 200,
+			body: "{}"
+		};
+		const msg = {
+			accountId: this.acc.id,
+			id: `syno-${timestamp}-${Math.random().toString(36).slice(2, 7)}`,
+			from: username,
+			userId,
+			chatId: userId,
+			text,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		this.emit("message", msg);
+		return {
+			status: 200,
+			body: "{}"
+		};
+	}
+	async _checkPolicy(userId, channelId, text) {
+		const acc = this.acc;
+		if (acc.dmPolicy === "disabled") return false;
+		if (acc.dmPolicy === "open") return true;
+		if (acc.dmPolicy === "allowlist") {
+			if (acc.allowedUserIds.includes(userId)) return true;
+			console.log(chalk.default.gray(`  synology-chat[${acc.id}]: drop sender ${userId} (dmPolicy=allowlist)`));
+			return false;
+		}
+		if (acc.dmPolicy === "pairing") {
+			if (acc.approvedPairings.includes(userId)) return true;
+			const upper = text.trim().toUpperCase();
+			if (acc.pendingPairings[upper] === userId) {
+				acc.approvedPairings.push(userId);
+				delete acc.pendingPairings[upper];
+				await this._saveState();
+				await this.sendMessage(userId, "🦅 Paired! You can now send messages to the assistant.");
+				this.emit("pairing:approved", {
+					accountId: acc.id,
+					userId
+				});
+				return true;
+			}
+			const code = Array.from({ length: 6 }, () => "ABCDEFGHJKLMNPQRSTUVWXYZ23456789"[Math.floor(Math.random() * 32)]).join("");
+			acc.pendingPairings[code] = userId;
+			await this._saveState();
+			await this.sendMessage(userId, `🦅 Pairing required. Your code: \`${code}\`\nApprove: hyperclaw pairing approve synology-chat ${code}`);
+			return false;
+		}
+		return false;
+	}
+	async sendMessage(userId, text) {
+		try {
+			await postToSynology(this.acc.incomingUrl, text, userId, this.acc.allowInsecureSsl);
+		} catch (e) {
+			console.log(chalk.default.yellow(`  ⚠ Synology Chat[${this.acc.id}] send error: ${e.message}`));
+		}
+	}
+	/** Resolve outbound target. Accepts: numeric ID, "synology-chat:<id>", "user:<id>" */
+	resolveTarget(target) {
+		if (target.startsWith("synology-chat:")) return target.slice(14);
+		if (target.startsWith("user:")) return target.slice(5);
+		return target;
+	}
+	approvePairing(code) {
+		const upper = code.toUpperCase();
+		if (!this.acc.pendingPairings[upper]) return false;
+		this.acc.approvedPairings.push(this.acc.pendingPairings[upper]);
+		delete this.acc.pendingPairings[upper];
+		this._saveState();
+		return true;
+	}
+	listPendingPairings() {
+		return { ...this.acc.pendingPairings };
+	}
+	_stateFile() {
+		return path.default.join(STATE_DIR, `synology-chat-state-${this.acc.id}.json`);
+	}
+	async loadState() {
+		try {
+			const s = await fs_extra.default.readJson(this._stateFile());
+			if (Array.isArray(s.approvedPairings)) this.acc.approvedPairings = s.approvedPairings;
+			if (s.pendingPairings && typeof s.pendingPairings === "object") this.acc.pendingPairings = s.pendingPairings;
+		} catch {}
+	}
+	async _saveState() {
+		await fs_extra.default.ensureDir(STATE_DIR);
+		await fs_extra.default.writeJson(this._stateFile(), {
+			approvedPairings: this.acc.approvedPairings,
+			pendingPairings: this.acc.pendingPairings
+		}, { spaces: 2 });
+	}
+};
+var SynologyChatConnector = class extends events.EventEmitter {
+	accounts = /* @__PURE__ */ new Map();
+	/** webhookPath → accountId index for fast routing */
+	pathIndex = /* @__PURE__ */ new Map();
+	rawConfig;
+	constructor(config) {
+		super();
+		this.rawConfig = config;
+	}
+	async connect() {
+		const cfg = this.rawConfig;
+		const accountDefs = cfg.accounts ?? { default: cfg };
+		for (const [id, rawAcc] of Object.entries(accountDefs)) {
+			const merged = {
+				...cfg,
+				...rawAcc
+			};
+			const state = {
+				approved: cfg.approvedPairings ?? [],
+				pending: cfg.pendingPairings ?? {}
+			};
+			const acc = resolveAccount(id, merged, state);
+			const conn = new SingleAccountConnector(acc);
+			try {
+				conn.validate();
+			} catch (e) {
+				console.log(chalk.default.red(`  ✗ ${e.message} — account skipped`));
+				continue;
+			}
+			await conn.loadState();
+			conn.on("message", (msg) => this.emit("message", msg));
+			conn.on("pairing:approved", (info) => this.emit("pairing:approved", info));
+			this.accounts.set(id, conn);
+			this.pathIndex.set(acc.webhookPath, id);
+			console.log(chalk.default.green(`  🦅 Synology Chat[${id}]: ready — inbound path ${acc.webhookPath}`));
+		}
+		this.emit("connected", { accountIds: Array.from(this.accounts.keys()) });
+	}
+	disconnect() {
+		this.accounts.clear();
+		this.pathIndex.clear();
+	}
+	/** Called by the gateway's HTTP server for inbound POST requests. */
+	async handleWebhook(requestPath, body) {
+		const accountId = this.pathIndex.get(requestPath);
+		if (!accountId) return {
+			status: 404,
+			body: "Not Found"
+		};
+		return this._acc(accountId).handleWebhook(body);
+	}
+	/** Returns all registered webhook paths (for gateway route registration). */
+	getWebhookPaths() {
+		return Array.from(this.pathIndex.keys());
+	}
+	_acc(accountId = "default") {
+		const conn = this.accounts.get(accountId);
+		if (!conn) throw new Error(`Synology Chat: account '${accountId}' not found`);
+		return conn;
+	}
+	async sendMessage(userId, text, accountId) {
+		const conn = this._acc(accountId);
+		const resolved = conn.resolveTarget(userId);
+		return conn.sendMessage(resolved, text);
+	}
+	resolveTarget(target, accountId) {
+		return this._acc(accountId).resolveTarget(target);
+	}
+	approvePairing(code, accountId) {
+		return this._acc(accountId).approvePairing(code);
+	}
+	listPendingPairings(accountId) {
+		return this._acc(accountId).listPendingPairings();
+	}
+	getAccountIds() {
+		return Array.from(this.accounts.keys());
+	}
+	isRunning() {
+		return this.accounts.size > 0;
+	}
+};
+
+//#endregion
+exports.SynologyChatConnector = SynologyChatConnector;

package/dist/connector-B7qngfkT.js

@@ -0,0 +1,286 @@
+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 net = require_chunk.__toESM(require("net"));
+const events = require_chunk.__toESM(require("events"));
+const tls = require_chunk.__toESM(require("tls"));
+
+//#region extensions/email/src/connector.ts
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "email-state.json");
+var IMAPClient = class {
+	sock = null;
+	buffer = "";
+	tag = 0;
+	pendingCallbacks = /* @__PURE__ */ new Map();
+	async connect(host, port, username, password) {
+		await new Promise((resolve, reject) => {
+			this.sock = tls.default.connect({
+				host,
+				port,
+				rejectUnauthorized: true
+			}, () => resolve());
+			this.sock.on("error", reject);
+			this.sock.on("data", (chunk) => {
+				this.buffer += chunk.toString();
+				this.processBuffer();
+			});
+		});
+		await this.waitForUntagged("OK");
+		await this.command(`LOGIN "${this.escapeQuoted(username)}" "${this.escapeQuoted(password)}"`);
+	}
+	disconnect() {
+		this.sock?.end();
+		this.sock = null;
+	}
+	async selectFolder(folder) {
+		const resp = await this.command(`SELECT "${folder}"`);
+		const existsMatch = resp.match(/\* (\d+) EXISTS/);
+		const unseenMatch = resp.match(/UNSEEN (\d+)/);
+		return {
+			exists: existsMatch ? parseInt(existsMatch[1]) : 0,
+			unseen: unseenMatch ? parseInt(unseenMatch[1]) : 0
+		};
+	}
+	async searchUnseen() {
+		const resp = await this.command("SEARCH UNSEEN");
+		const match = resp.match(/\* SEARCH ([\d ]+)/);
+		if (!match || !match[1].trim()) return [];
+		return match[1].trim().split(" ").map(Number).filter(Boolean);
+	}
+	async fetchEmail(uid) {
+		const resp = await this.command(`FETCH ${uid} (RFC822.HEADER BODY[TEXT])`);
+		const fromMatch = resp.match(/^From:\s*(.+)$/im);
+		const subjectMatch = resp.match(/^Subject:\s*(.+)$/im);
+		const msgIdMatch = resp.match(/^Message-ID:\s*(.+)$/im);
+		const bodyMatch = resp.match(/BODY\[TEXT\] \{(\d+)\}([\s\S]+?)(?:\* \d+ FETCH|\w+ OK)/);
+		if (!fromMatch) return null;
+		const body = bodyMatch ? decodeQP(bodyMatch[2].trim()) : "";
+		return {
+			from: fromMatch[1].trim(),
+			subject: decodeHeader(subjectMatch ? subjectMatch[1].trim() : "(no subject)"),
+			body: body.slice(0, 4e3),
+			messageId: msgIdMatch ? msgIdMatch[1].trim() : ""
+		};
+	}
+	async markSeen(uid) {
+		await this.command(`STORE ${uid} +FLAGS (\\Seen)`);
+	}
+	async command(cmd) {
+		const tag = `HC${++this.tag}`;
+		return new Promise((resolve, reject) => {
+			this.pendingCallbacks.set(tag, resolve);
+			this.sock?.write(`${tag} ${cmd}\r\n`);
+			setTimeout(() => {
+				this.pendingCallbacks.delete(tag);
+				reject(new Error(`IMAP timeout: ${tag} ${cmd.slice(0, 30)}`));
+			}, 15e3);
+		});
+	}
+	async waitForUntagged(keyword) {
+		await new Promise((resolve) => {
+			const check = () => {
+				if (this.buffer.includes(`* ${keyword}`) || this.buffer.includes(`OK ${keyword}`)) resolve();
+				else setTimeout(check, 100);
+			};
+			setTimeout(check, 100);
+		});
+	}
+	processBuffer() {
+		const lines = this.buffer.split("\r\n");
+		this.buffer = lines.pop() || "";
+		for (const line of lines) {
+			const tagMatch = line.match(/^(HC\d+) (OK|NO|BAD)/);
+			if (tagMatch) {
+				const cb = this.pendingCallbacks.get(tagMatch[1]);
+				if (cb) {
+					this.pendingCallbacks.delete(tagMatch[1]);
+					cb(this.buffer + line);
+				}
+			}
+		}
+	}
+	escapeQuoted(s) {
+		return s.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+	}
+};
+var SMTPClient = class {
+	async send(config, to, subject, body) {
+		return new Promise((resolve, reject) => {
+			const sock = net.default.createConnection(config.smtpPort, config.smtpHost);
+			let buf = "";
+			let tlsSock = null;
+			let upgraded = false;
+			let authenticated = false;
+			const write = (s) => {
+				const target = tlsSock || sock;
+				target.write(s + "\r\n");
+			};
+			const onData = (chunk) => {
+				buf += chunk.toString();
+				const lines = buf.split("\r\n");
+				buf = lines.pop() || "";
+				for (const line of lines) {
+					const code = parseInt(line.slice(0, 3));
+					if (line.startsWith("220") && !upgraded) write(`EHLO hyperclaw.ai`);
+					else if (line.includes("250") && line.includes("STARTTLS") && !upgraded) write("STARTTLS");
+					else if (line.startsWith("220") && !upgraded) {
+						upgraded = true;
+						tlsSock = tls.default.connect({
+							socket: sock,
+							servername: config.smtpHost
+						});
+						tlsSock.on("data", onData);
+						tlsSock.on("error", reject);
+						write(`EHLO hyperclaw.ai`);
+					} else if (line.startsWith("250") && upgraded && !authenticated) write(`AUTH LOGIN`);
+					else if (line.startsWith("334") && !authenticated) {
+						const b64user = Buffer.from(config.username).toString("base64");
+						const b64pass = Buffer.from(config.password).toString("base64");
+						if (line.includes("VXNlcm5hbWU")) write(b64user);
+						else {
+							write(b64pass);
+							authenticated = true;
+						}
+					} else if (line.startsWith("235")) write(`MAIL FROM:<${config.username}>`);
+					else if (line.startsWith("250") && authenticated) if (buf.includes("RCPT") || !buf) write(`RCPT TO:<${to}>`);
+					else write(`DATA`);
+					else if (line.startsWith("354")) {
+						const date = (/* @__PURE__ */ new Date()).toUTCString();
+						const msg = `From: ${config.username}\r\nTo: ${to}\r\nSubject: ${subject}\r\nDate: ${date}\r\nContent-Type: text/plain; charset=utf-8\r\n\r\n` + body + "\r\n.";
+						write(msg);
+					} else if (line.startsWith("250") && buf.includes(".")) write("QUIT");
+					else if (line.startsWith("221")) {
+						sock.destroy();
+						resolve();
+					} else if (code >= 400) {
+						sock.destroy();
+						reject(new Error(`SMTP error: ${line}`));
+					}
+				}
+			};
+			sock.on("data", onData);
+			sock.on("error", reject);
+			sock.setTimeout(15e3, () => {
+				sock.destroy();
+				reject(new Error("SMTP timeout"));
+			});
+		});
+	}
+};
+function decodeQP(text) {
+	return text.replace(/=\r\n/g, "").replace(/=([0-9A-F]{2})/gi, (_, hex) => String.fromCharCode(parseInt(hex, 16)));
+}
+function decodeHeader(text) {
+	return text.replace(/=\?UTF-8\?[BQ]\?([^?]+)\?=/gi, (_, enc) => {
+		try {
+			return Buffer.from(enc, "base64").toString("utf8");
+		} catch {
+			return enc;
+		}
+	});
+}
+function extractEmail(from) {
+	const match = from.match(/<([^>]+)>/) || from.match(/[\w.+-]+@[\w-]+\.[a-z]{2,}/i);
+	return match ? match[1] || match[0] : from;
+}
+var EmailConnector = class extends events.EventEmitter {
+	config;
+	pollTimer = null;
+	running = false;
+	lastSeenUid = 0;
+	smtp = new SMTPClient();
+	constructor(config) {
+		super();
+		this.config = {
+			imapPort: 993,
+			smtpPort: 587,
+			pollIntervalMs: 3e4,
+			inboxFolder: "INBOX",
+			markAsRead: true,
+			subjectPrefix: "",
+			fromAllowlist: [],
+			...config
+		};
+	}
+	async connect() {
+		await this.loadState();
+		const imap = new IMAPClient();
+		await imap.connect(this.config.imapHost, this.config.imapPort, this.config.username, this.config.password);
+		const { exists } = await imap.selectFolder(this.config.inboxFolder);
+		imap.disconnect();
+		console.log(chalk.default.green(`  🦅 Email: ${this.config.username} — ${exists} messages in inbox`));
+		this.running = true;
+		this.emit("connected", { username: this.config.username });
+		this.startPolling();
+	}
+	disconnect() {
+		this.running = false;
+		if (this.pollTimer) clearInterval(this.pollTimer);
+	}
+	startPolling() {
+		this.poll();
+		this.pollTimer = setInterval(() => this.poll(), this.config.pollIntervalMs);
+	}
+	/** Trigger immediate poll (e.g. from Gmail Pub/Sub webhook) */
+	triggerPoll() {
+		if (this.running) this.poll();
+	}
+	async poll() {
+		if (!this.running) return;
+		const imap = new IMAPClient();
+		try {
+			await imap.connect(this.config.imapHost, this.config.imapPort, this.config.username, this.config.password);
+			await imap.selectFolder(this.config.inboxFolder);
+			const unseenUids = await imap.searchUnseen();
+			const newUids = unseenUids.filter((uid) => uid > this.lastSeenUid);
+			for (const uid of newUids) {
+				const email = await imap.fetchEmail(uid);
+				if (!email) continue;
+				const fromAddr = extractEmail(email.from);
+				if (this.config.subjectPrefix && !email.subject.startsWith(this.config.subjectPrefix)) continue;
+				if (this.config.fromAllowlist.length > 0 && !this.config.fromAllowlist.includes(fromAddr)) continue;
+				if (this.config.markAsRead) await imap.markSeen(uid);
+				this.lastSeenUid = Math.max(this.lastSeenUid, uid);
+				await this.saveState();
+				this.emit("message", {
+					id: email.messageId || String(uid),
+					channelId: "email",
+					from: fromAddr,
+					chatId: fromAddr,
+					text: `Subject: ${email.subject}\n\n${email.body}`,
+					timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+					isDM: true
+				});
+			}
+		} catch (err) {
+			if (this.running) console.log(chalk.default.yellow(`  ⚠  Email poll error: ${err.message}`));
+		} finally {
+			imap.disconnect();
+		}
+	}
+	async sendMessage(to, text, subject) {
+		await this.smtp.send(this.config, to, subject || `🦅 HyperClaw`, text);
+	}
+	async reply(to, originalSubject, text) {
+		const replySubject = originalSubject.startsWith("Re: ") ? originalSubject : `Re: ${originalSubject}`;
+		await this.sendMessage(to, text, replySubject);
+	}
+	async loadState() {
+		try {
+			const s = await fs_extra.default.readJson(STATE_FILE);
+			this.lastSeenUid = s.lastSeenUid || 0;
+		} catch {}
+	}
+	async saveState() {
+		await fs_extra.default.ensureDir(path.default.dirname(STATE_FILE));
+		await fs_extra.default.writeJson(STATE_FILE, { lastSeenUid: this.lastSeenUid }, { spaces: 2 });
+	}
+	isRunning() {
+		return this.running;
+	}
+};
+
+//#endregion
+exports.EmailConnector = EmailConnector;