hyperclaw 4.0.1 → 4.0.2

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;

package/dist/connector-BP8zsbP8.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 crypto = require_chunk.__toESM(require("crypto"));
+const https = require_chunk.__toESM(require("https"));
+const events = require_chunk.__toESM(require("events"));
+
+//#region extensions/sms/src/connector.ts
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "sms-state.json");
+function twilioRequest(accountSid, authToken, method, endpoint, body) {
+	return new Promise((resolve, reject) => {
+		const auth = Buffer.from(`${accountSid}:${authToken}`).toString("base64");
+		const payload = body ? Object.entries(body).map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join("&") : null;
+		const req = https.default.request({
+			hostname: "api.twilio.com",
+			port: 443,
+			path: `/2010-04-01/Accounts/${accountSid}${endpoint}.json`,
+			method,
+			headers: {
+				"Authorization": `Basic ${auth}`,
+				...payload ? {
+					"Content-Type": "application/x-www-form-urlencoded",
+					"Content-Length": Buffer.byteLength(payload)
+				} : {}
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const r = JSON.parse(data);
+					if (res.statusCode && res.statusCode >= 400) reject(new Error(r.message || `Twilio ${res.statusCode}`));
+					else resolve(r);
+				} catch {
+					reject(new Error("Invalid JSON"));
+				}
+			});
+		});
+		req.on("error", reject);
+		if (payload) req.write(payload);
+		req.end();
+	});
+}
+var SMSConnector = class extends events.EventEmitter {
+	config;
+	running = false;
+	constructor(config) {
+		super();
+		this.config = {
+			dmPolicy: "allowlist",
+			allowFrom: [],
+			approvedPairings: [],
+			pendingPairings: {},
+			...config
+		};
+	}
+	async connect() {
+		await twilioRequest(this.config.accountSid, this.config.authToken, "GET", "");
+		await this.loadState();
+		this.running = true;
+		console.log(chalk.default.green(`  🦅 SMS: ${this.config.fromNumber} connected via Twilio`));
+		this.emit("connected", { number: this.config.fromNumber });
+	}
+	disconnect() {
+		this.running = false;
+	}
+	async handleWebhook(body, twilioSignature, webhookUrl) {
+		const params = Object.fromEntries(body.split("&").map((p) => {
+			const [k, v] = p.split("=");
+			return [decodeURIComponent(k), decodeURIComponent(v || "").replace(/\+/g, " ")];
+		}));
+		const from = params.From;
+		const text = params.Body;
+		const messageSid = params.MessageSid;
+		if (!from || !text) return;
+		if (twilioSignature && !this.verifySignature(body, twilioSignature, webhookUrl)) {
+			console.log(chalk.default.yellow("  ⚠  SMS: invalid Twilio signature"));
+			return;
+		}
+		const allowed = await this.checkDMPolicy(from, text);
+		if (!allowed) return;
+		this.emit("message", {
+			id: messageSid,
+			channelId: "sms",
+			from,
+			chatId: from,
+			text,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			isDM: true
+		});
+	}
+	verifySignature(body, signature, url) {
+		const params = Object.fromEntries(body.split("&").map((p) => {
+			const [k, v] = p.split("=");
+			return [decodeURIComponent(k), decodeURIComponent(v || "").replace(/\+/g, " ")];
+		}));
+		const sortedParams = Object.keys(params).sort().map((k) => `${k}${params[k]}`).join("");
+		const expected = crypto.default.createHmac("sha1", this.config.authToken).update(url + sortedParams).digest("base64");
+		try {
+			return crypto.default.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
+		} catch {
+			return false;
+		}
+	}
+	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, "🦅 HyperClaw: Paired! You can now send messages.");
+				this.emit("pairing:approved", {
+					userId: from,
+					channelId: "sms"
+				});
+				return true;
+			}
+			const code = this.generateCode();
+			this.config.pendingPairings[code] = from;
+			await this.saveState();
+			await this.sendMessage(from, `🦅 HyperClaw Pairing: send this code to the owner: ${code}\nThey can approve with: hyperclaw pairing approve sms ${code}`);
+			return false;
+		}
+		return false;
+	}
+	async sendMessage(to, text) {
+		await twilioRequest(this.config.accountSid, this.config.authToken, "POST", "/Messages", {
+			From: this.config.fromNumber,
+			To: to,
+			Body: text.slice(0, 1600)
+		});
+	}
+	async getStatus(messageSid) {
+		const r = await twilioRequest(this.config.accountSid, this.config.authToken, "GET", `/Messages/${messageSid}`);
+		return r.status;
+	}
+	async broadcast(numbers, text) {
+		for (const num of numbers) await this.sendMessage(num, text).catch((e) => console.log(chalk.default.yellow(`  ⚠  SMS broadcast failed to ${num}: ${e.message}`)));
+	}
+	generateCode() {
+		const chars = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
+		return Array.from({ length: 6 }, () => chars[Math.floor(Math.random() * chars.length)]).join("");
+	}
+	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;
+	}
+	addToAllowlist(number) {
+		if (!this.config.allowFrom.includes(number)) {
+			this.config.allowFrom.push(number);
+			this.saveState();
+		}
+	}
+	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.SMSConnector = SMSConnector;

package/dist/connector-BPoSevxp.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;