hyperclaw 5.3.45 → 5.4.1

package/dist/env-resolve-NNM3F6Eo.js

@@ -0,0 +1,167 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+
+//#region src/infra/env-resolve.ts
+function resolveGatewayToken(authTokenFromConfig) {
+	return authTokenFromConfig || process.env.HYPERCLAW_GATEWAY_TOKEN || "";
+}
+function resolveProviderApiKey(cfg) {
+	if (!cfg) return "";
+	const key = cfg.provider?.apiKey;
+	if (key) return key;
+	const pid = cfg.provider?.providerId || "openrouter";
+	switch (pid) {
+		case "openrouter": return process.env.OPENROUTER_API_KEY || "";
+		case "anthropic": return process.env.ANTHROPIC_API_KEY || "";
+		case "openai": return process.env.OPENAI_API_KEY || "";
+		case "xai": return process.env.XAI_API_KEY || "";
+		case "google": return process.env.GOOGLE_AI_API_KEY || "";
+		case "opencode-go":
+		case "opencode-zen": return process.env.OPENCODE_API_KEY || "";
+		case "ollama": return process.env.OLLAMA_API_KEY || "";
+		case "custom": return "";
+		default: return process.env.OPENROUTER_API_KEY || process.env.ANTHROPIC_API_KEY || "";
+	}
+}
+/**
+
+* H-2: Resolve API key or OAuth access token (async).
+
+* Resolution order:
+
+*   1. cfg.provider.apiKey (in config file)
+
+*   2. CredentialsStore  (~/.hyperclaw/credentials/<providerId>.json)
+
+*   3. AuthStore         (~/.hyperclaw/auth.json providers map)
+
+*   4. Environment variables (per-provider mapping in resolveProviderApiKey)
+
+* Also handles authType === 'oauth' via the oauth-provider service.
+
+*/
+async function getProviderCredentialAsync(cfg) {
+	if (!cfg?.provider) return "";
+	if (cfg.provider.authType === "oauth") {
+		const { getProviderCredentialAsync: getOAuth } = await Promise.resolve().then(() => require("./oauth-provider-Bnul5A_Z.js"));
+		return getOAuth(cfg);
+	}
+	if (cfg.provider.apiKey) return cfg.provider.apiKey;
+	const pid = cfg.provider.providerId || "openrouter";
+	try {
+		const { CredentialsStore } = await Promise.resolve().then(() => require("./credentials-store-CR4WSDGl.js"));
+		const { getHyperClawDir } = await Promise.resolve().then(() => require("./paths-D-QecARF.js"));
+		const credStore = new CredentialsStore(getHyperClawDir());
+		const cred = await credStore.get(pid);
+		if (cred?.apiKey) return cred.apiKey;
+	} catch (e) {
+		if (process.env.DEBUG) console.error("[env-resolve] CredentialsStore:", e?.message);
+	}
+	try {
+		const { AuthStore } = await Promise.resolve().then(() => require("./device-auth-store-C1bCwXO2.js"));
+		const { getHyperClawDir } = await Promise.resolve().then(() => require("./paths-D-QecARF.js"));
+		const authStore = new AuthStore(getHyperClawDir());
+		const key = await authStore.getProviderKey(pid);
+		if (key) return key;
+	} catch (e) {
+		if (process.env.DEBUG) console.error("[env-resolve] AuthStore:", e?.message);
+	}
+	return resolveProviderApiKey(cfg);
+}
+/** Resolve Brave Search API key. Order: webSearch (provider=brave), skills.apiKeys.brave, BRAVE_API_KEY. */
+function resolveBraveApiKey(cfg) {
+	if (cfg?.webSearch?.provider === "brave" && cfg.webSearch.apiKey) return cfg.webSearch.apiKey;
+	const fromSkills = cfg?.skills?.apiKeys?.["brave"];
+	if (fromSkills) return fromSkills;
+	return process.env.BRAVE_API_KEY || "";
+}
+/** Resolve API key for a service (bug bounty, research apps, etc.). Config first, then env. */
+function resolveServiceApiKey(serviceId, cfg) {
+	const key = cfg?.skills?.apiKeys?.[serviceId];
+	if (key) return key;
+	const envKey = SERVICE_ENV[serviceId] || `${serviceId.toUpperCase().replace(/-/g, "_")}_API_KEY`;
+	return process.env[envKey] || process.env[envKey.replace(/-/g, "_")] || "";
+}
+function resolveChannelToken(channelId, tokenFromConfig) {
+	if (tokenFromConfig) return tokenFromConfig;
+	const envKey = CHANNEL_ENV[channelId] || `${channelId.toUpperCase().replace(/-/g, "_")}_BOT_TOKEN`;
+	return process.env[envKey] || process.env[`${channelId.toUpperCase()}_BOT_TOKEN`] || "";
+}
+/**
+
+* Returns a summary of active path environment overrides.
+
+* Useful for `hyperclaw health -v` and `hyperclaw status --all`.
+
+*/
+function resolvePathEnvOverrides() {
+	return {
+		...process.env.HYPERCLAW_HOME ? { hyperclawHome: process.env.HYPERCLAW_HOME } : {},
+		...process.env.HYPERCLAW_STATE_DIR ? { stateDir: process.env.HYPERCLAW_STATE_DIR } : {},
+		...process.env.HYPERCLAW_CONFIG_PATH ? { configPath: process.env.HYPERCLAW_CONFIG_PATH } : {},
+		...process.env.HYPERCLAW_GATEWAY_TOKEN ? { gatewayToken: "(set)" } : {}
+	};
+}
+var CHANNEL_ENV, SERVICE_ENV;
+var init_env_resolve = require_chunk.__esm({ "src/infra/env-resolve.ts"() {
+	CHANNEL_ENV = {
+		telegram: "TELEGRAM_BOT_TOKEN",
+		discord: "DISCORD_BOT_TOKEN",
+		slack: "SLACK_BOT_TOKEN"
+	};
+	SERVICE_ENV = {
+		hackerone: "HACKERONE_API_USERNAME",
+		"hackerone-token": "HACKERONE_API_TOKEN",
+		bugcrowd: "BUGCROWD_API_TOKEN",
+		synack: "SYNACK_API_TOKEN"
+	};
+} });
+
+//#endregion
+Object.defineProperty(exports, 'getProviderCredentialAsync', {
+  enumerable: true,
+  get: function () {
+    return getProviderCredentialAsync;
+  }
+});
+Object.defineProperty(exports, 'init_env_resolve', {
+  enumerable: true,
+  get: function () {
+    return init_env_resolve;
+  }
+});
+Object.defineProperty(exports, 'resolveBraveApiKey', {
+  enumerable: true,
+  get: function () {
+    return resolveBraveApiKey;
+  }
+});
+Object.defineProperty(exports, 'resolveChannelToken', {
+  enumerable: true,
+  get: function () {
+    return resolveChannelToken;
+  }
+});
+Object.defineProperty(exports, 'resolveGatewayToken', {
+  enumerable: true,
+  get: function () {
+    return resolveGatewayToken;
+  }
+});
+Object.defineProperty(exports, 'resolvePathEnvOverrides', {
+  enumerable: true,
+  get: function () {
+    return resolvePathEnvOverrides;
+  }
+});
+Object.defineProperty(exports, 'resolveProviderApiKey', {
+  enumerable: true,
+  get: function () {
+    return resolveProviderApiKey;
+  }
+});
+Object.defineProperty(exports, 'resolveServiceApiKey', {
+  enumerable: true,
+  get: function () {
+    return resolveServiceApiKey;
+  }
+});

package/dist/env-resolve-dTjn-g8X.js

@@ -0,0 +1,11 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_env_resolve = require('./env-resolve-Bop7KbNq.js');
+
+require_env_resolve.init_env_resolve();
+exports.getProviderCredentialAsync = require_env_resolve.getProviderCredentialAsync;
+exports.resolveBraveApiKey = require_env_resolve.resolveBraveApiKey;
+exports.resolveChannelToken = require_env_resolve.resolveChannelToken;
+exports.resolveGatewayToken = require_env_resolve.resolveGatewayToken;
+exports.resolvePathEnvOverrides = require_env_resolve.resolvePathEnvOverrides;
+exports.resolveProviderApiKey = require_env_resolve.resolveProviderApiKey;
+exports.resolveServiceApiKey = require_env_resolve.resolveServiceApiKey;

package/dist/extraction-tools-Bh5F0ENP.js

@@ -0,0 +1,91 @@
+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"));
+
+//#region packages/core/src/agent/extraction-tools.ts
+function safeRequire(id) {
+	try {
+		return require(id);
+	} catch {
+		return null;
+	}
+}
+function getExtractionTools() {
+	return [{
+		name: "extract_pdf",
+		description: "Extract text and structure from a PDF file. Returns full text content. Use for documents, forms, reports.",
+		input_schema: {
+			type: "object",
+			properties: { path: {
+				type: "string",
+				description: "Path to PDF file (absolute or ~)"
+			} },
+			required: ["path"]
+		},
+		handler: async (input) => {
+			const filePath = input.path.replace(/^~/, os.default.homedir());
+			if (!await fs_extra.default.pathExists(filePath)) return `Error: File not found: ${filePath}`;
+			const pdfParse = safeRequire("pdf-parse");
+			if (!pdfParse) return "Error: pdf-parse not installed. Run: npm install pdf-parse";
+			try {
+				const buf = await fs_extra.default.readFile(filePath);
+				const data = await pdfParse(buf);
+				const text = (data.text || "").trim().slice(0, 5e4);
+				return `Pages: ${data.numpages || "?"}\n\n${text || "(no extractable text)"}`;
+			} catch (e) {
+				return `Error: ${e.message}`;
+			}
+		}
+	}, {
+		name: "extract_spreadsheet",
+		description: "Extract data from Excel (.xlsx, .xls) or CSV. Returns sheet names and cell content as structured text.",
+		input_schema: {
+			type: "object",
+			properties: { path: {
+				type: "string",
+				description: "Path to spreadsheet (xlsx, xls, csv)"
+			} },
+			required: ["path"]
+		},
+		handler: async (input) => {
+			const filePath = input.path.replace(/^~/, os.default.homedir());
+			if (!await fs_extra.default.pathExists(filePath)) return `Error: File not found: ${filePath}`;
+			const ext = path.default.extname(filePath).toLowerCase();
+			if (ext === ".csv") {
+				const content = await fs_extra.default.readFile(filePath, "utf8");
+				return content.slice(0, 5e4);
+			}
+			const XLSX = safeRequire("xlsx");
+			if (!XLSX) return "Error: xlsx not installed. Run: npm install xlsx";
+			try {
+				const buf = await fs_extra.default.readFile(filePath);
+				const wb = XLSX.read(buf, { type: "buffer" });
+				const parts = [];
+				for (const name of wb.SheetNames) {
+					const sheet = wb.Sheets[name];
+					const arr = XLSX.utils.sheet_to_csv(sheet);
+					parts.push(`Sheet: ${name}\n${arr.slice(0, 2e4)}`);
+				}
+				return parts.join("\n\n---\n\n").slice(0, 5e4);
+			} catch (e) {
+				return `Error: ${e.message}`;
+			}
+		}
+	}];
+}
+var init_extraction_tools = require_chunk.__esm({ "packages/core/src/agent/extraction-tools.ts"() {} });
+
+//#endregion
+Object.defineProperty(exports, 'getExtractionTools', {
+  enumerable: true,
+  get: function () {
+    return getExtractionTools;
+  }
+});
+Object.defineProperty(exports, 'init_extraction_tools', {
+  enumerable: true,
+  get: function () {
+    return init_extraction_tools;
+  }
+});

package/dist/extraction-tools-BjzXD9LW.js

@@ -0,0 +1,5 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_extraction_tools = require('./extraction-tools-Bh5F0ENP.js');
+
+require_extraction_tools.init_extraction_tools();
+exports.getExtractionTools = require_extraction_tools.getExtractionTools;

package/dist/extraction-tools-D1lrDYhe.js

@@ -0,0 +1,5 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_extraction_tools = require('./extraction-tools-FBwtT2Bx.js');
+
+require_extraction_tools.init_extraction_tools();
+exports.getExtractionTools = require_extraction_tools.getExtractionTools;

package/dist/extraction-tools-FBwtT2Bx.js

@@ -0,0 +1,91 @@
+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"));
+
+//#region packages/core/src/agent/extraction-tools.ts
+function safeRequire(id) {
+	try {
+		return require(id);
+	} catch {
+		return null;
+	}
+}
+function getExtractionTools() {
+	return [{
+		name: "extract_pdf",
+		description: "Extract text and structure from a PDF file. Returns full text content. Use for documents, forms, reports.",
+		input_schema: {
+			type: "object",
+			properties: { path: {
+				type: "string",
+				description: "Path to PDF file (absolute or ~)"
+			} },
+			required: ["path"]
+		},
+		handler: async (input) => {
+			const filePath = input.path.replace(/^~/, os.default.homedir());
+			if (!await fs_extra.default.pathExists(filePath)) return `Error: File not found: ${filePath}`;
+			const pdfParse = safeRequire("pdf-parse");
+			if (!pdfParse) return "Error: pdf-parse not installed. Run: npm install pdf-parse";
+			try {
+				const buf = await fs_extra.default.readFile(filePath);
+				const data = await pdfParse(buf);
+				const text = (data.text || "").trim().slice(0, 5e4);
+				return `Pages: ${data.numpages || "?"}\n\n${text || "(no extractable text)"}`;
+			} catch (e) {
+				return `Error: ${e.message}`;
+			}
+		}
+	}, {
+		name: "extract_spreadsheet",
+		description: "Extract data from Excel (.xlsx, .xls) or CSV. Returns sheet names and cell content as structured text.",
+		input_schema: {
+			type: "object",
+			properties: { path: {
+				type: "string",
+				description: "Path to spreadsheet (xlsx, xls, csv)"
+			} },
+			required: ["path"]
+		},
+		handler: async (input) => {
+			const filePath = input.path.replace(/^~/, os.default.homedir());
+			if (!await fs_extra.default.pathExists(filePath)) return `Error: File not found: ${filePath}`;
+			const ext = path.default.extname(filePath).toLowerCase();
+			if (ext === ".csv") {
+				const content = await fs_extra.default.readFile(filePath, "utf8");
+				return content.slice(0, 5e4);
+			}
+			const XLSX = safeRequire("xlsx");
+			if (!XLSX) return "Error: xlsx not installed. Run: npm install xlsx";
+			try {
+				const buf = await fs_extra.default.readFile(filePath);
+				const wb = XLSX.read(buf, { type: "buffer" });
+				const parts = [];
+				for (const name of wb.SheetNames) {
+					const sheet = wb.Sheets[name];
+					const arr = XLSX.utils.sheet_to_csv(sheet);
+					parts.push(`Sheet: ${name}\n${arr.slice(0, 2e4)}`);
+				}
+				return parts.join("\n\n---\n\n").slice(0, 5e4);
+			} catch (e) {
+				return `Error: ${e.message}`;
+			}
+		}
+	}];
+}
+var init_extraction_tools = require_chunk.__esm({ "packages/core/src/agent/extraction-tools.ts"() {} });
+
+//#endregion
+Object.defineProperty(exports, 'getExtractionTools', {
+  enumerable: true,
+  get: function () {
+    return getExtractionTools;
+  }
+});
+Object.defineProperty(exports, 'init_extraction_tools', {
+  enumerable: true,
+  get: function () {
+    return init_extraction_tools;
+  }
+});

package/dist/fileFromPath-CodL6KXh.js

@@ -0,0 +1,85 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_node_domexception$1 = require('./node-domexception-v89b0Nwz.js');
+const require_isFile = require('./isFile-CSxoSB8X.js');
+const path = require_chunk.__toESM(require("path"));
+const fs = require_chunk.__toESM(require("fs"));
+
+//#region node_modules/formdata-node/lib/esm/isPlainObject.js
+const getType = (value) => Object.prototype.toString.call(value).slice(8, -1).toLowerCase();
+function isPlainObject(value) {
+	if (getType(value) !== "object") return false;
+	const pp = Object.getPrototypeOf(value);
+	if (pp === null || pp === void 0) return true;
+	const Ctor = pp.constructor && pp.constructor.toString();
+	return Ctor === Object.toString();
+}
+var isPlainObject_default = isPlainObject;
+
+//#endregion
+//#region node_modules/formdata-node/lib/esm/fileFromPath.js
+var import_node_domexception = require_chunk.__toESM(require_node_domexception$1.require_node_domexception(), 1);
+var __classPrivateFieldSet = void 0 && (void 0).__classPrivateFieldSet || function(receiver, state, value, kind, f) {
+	if (kind === "m") throw new TypeError("Private method is not writable");
+	if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+	if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+	return kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value), value;
+};
+var __classPrivateFieldGet = void 0 && (void 0).__classPrivateFieldGet || function(receiver, state, kind, f) {
+	if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+	if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+	return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _FileFromPath_path, _FileFromPath_start;
+const MESSAGE = "The requested file could not be read, typically due to permission problems that have occurred after a reference to a file was acquired.";
+var FileFromPath = class FileFromPath {
+	constructor(input) {
+		_FileFromPath_path.set(this, void 0);
+		_FileFromPath_start.set(this, void 0);
+		__classPrivateFieldSet(this, _FileFromPath_path, input.path, "f");
+		__classPrivateFieldSet(this, _FileFromPath_start, input.start || 0, "f");
+		this.name = (0, path.basename)(__classPrivateFieldGet(this, _FileFromPath_path, "f"));
+		this.size = input.size;
+		this.lastModified = input.lastModified;
+	}
+	slice(start, end) {
+		return new FileFromPath({
+			path: __classPrivateFieldGet(this, _FileFromPath_path, "f"),
+			lastModified: this.lastModified,
+			size: end - start,
+			start
+		});
+	}
+	async *stream() {
+		const { mtimeMs } = await fs.promises.stat(__classPrivateFieldGet(this, _FileFromPath_path, "f"));
+		if (mtimeMs > this.lastModified) throw new import_node_domexception.default(MESSAGE, "NotReadableError");
+		if (this.size) yield* (0, fs.createReadStream)(__classPrivateFieldGet(this, _FileFromPath_path, "f"), {
+			start: __classPrivateFieldGet(this, _FileFromPath_start, "f"),
+			end: __classPrivateFieldGet(this, _FileFromPath_start, "f") + this.size - 1
+		});
+	}
+	get [(_FileFromPath_path = /* @__PURE__ */ new WeakMap(), _FileFromPath_start = /* @__PURE__ */ new WeakMap(), Symbol.toStringTag)]() {
+		return "File";
+	}
+};
+function createFileFromPath(path$1, { mtimeMs, size }, filenameOrOptions, options = {}) {
+	let filename;
+	if (isPlainObject_default(filenameOrOptions)) [options, filename] = [filenameOrOptions, void 0];
+	else filename = filenameOrOptions;
+	const file = new FileFromPath({
+		path: path$1,
+		size,
+		lastModified: mtimeMs
+	});
+	if (!filename) filename = file.name;
+	return new require_isFile.File([file], filename, {
+		...options,
+		lastModified: file.lastModified
+	});
+}
+async function fileFromPath(path$1, filenameOrOptions, options) {
+	const stats = await fs.promises.stat(path$1);
+	return createFileFromPath(path$1, stats, filenameOrOptions, options);
+}
+
+//#endregion
+exports.fileFromPath = fileFromPath;

package/dist/gmail-watch-setup--eQ8raeb.js

@@ -0,0 +1,42 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.js');
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+
+//#region src/commands/gmail-watch-setup.ts
+require_paths$1.init_paths();
+async function getGmailAccessToken() {
+	const hcDir = require_paths.getHyperClawDir();
+	const paths = [path.default.join(hcDir, "oauth-google-gmail.json"), path.default.join(hcDir, "oauth-google.json")];
+	for (const p of paths) {
+		if (!await fs_extra.default.pathExists(p)) continue;
+		const data = await fs_extra.default.readJson(p);
+		if (data.access_token) return data.access_token;
+	}
+	throw new Error("No Gmail OAuth token found. Run: hyperclaw auth oauth google-gmail");
+}
+async function setupGmailWatch(opts) {
+	const token = await getGmailAccessToken();
+	const body = JSON.stringify({
+		topicName: opts.topicName,
+		labelIds: opts.labelIds || ["INBOX"],
+		labelFilterBehavior: "INCLUDE"
+	});
+	const res = await fetch("https://gmail.googleapis.com/gmail/v1/users/me/watch", {
+		method: "POST",
+		headers: {
+			Authorization: `Bearer ${token}`,
+			"Content-Type": "application/json"
+		},
+		body
+	});
+	if (!res.ok) {
+		const err = await res.text();
+		throw new Error(`Gmail API error ${res.status}: ${err}`);
+	}
+	return res.json();
+}
+
+//#endregion
+exports.setupGmailWatch = setupGmailWatch;

package/dist/gmail-watch-setup-9t14gy1B.js

@@ -0,0 +1,42 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.js');
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+
+//#region src/commands/gmail-watch-setup.ts
+require_paths$1.init_paths();
+async function getGmailAccessToken() {
+	const hcDir = require_paths.getHyperClawDir();
+	const paths = [path.default.join(hcDir, "oauth-google-gmail.json"), path.default.join(hcDir, "oauth-google.json")];
+	for (const p of paths) {
+		if (!await fs_extra.default.pathExists(p)) continue;
+		const data = await fs_extra.default.readJson(p);
+		if (data.access_token) return data.access_token;
+	}
+	throw new Error("No Gmail OAuth token found. Run: hyperclaw auth oauth google-gmail");
+}
+async function setupGmailWatch(opts) {
+	const token = await getGmailAccessToken();
+	const body = JSON.stringify({
+		topicName: opts.topicName,
+		labelIds: opts.labelIds || ["INBOX"],
+		labelFilterBehavior: "INCLUDE"
+	});
+	const res = await fetch("https://gmail.googleapis.com/gmail/v1/users/me/watch", {
+		method: "POST",
+		headers: {
+			Authorization: `Bearer ${token}`,
+			"Content-Type": "application/json"
+		},
+		body
+	});
+	if (!res.ok) {
+		const err = await res.text();
+		throw new Error(`Gmail API error ${res.status}: ${err}`);
+	}
+	return res.json();
+}
+
+//#endregion
+exports.setupGmailWatch = setupGmailWatch;

package/dist/gmail-watch-setup-B9fx_OLg.js

@@ -0,0 +1,42 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.js');
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+
+//#region src/commands/gmail-watch-setup.ts
+require_paths$1.init_paths();
+async function getGmailAccessToken() {
+	const hcDir = require_paths.getHyperClawDir();
+	const paths = [path.default.join(hcDir, "oauth-google-gmail.json"), path.default.join(hcDir, "oauth-google.json")];
+	for (const p of paths) {
+		if (!await fs_extra.default.pathExists(p)) continue;
+		const data = await fs_extra.default.readJson(p);
+		if (data.access_token) return data.access_token;
+	}
+	throw new Error("No Gmail OAuth token found. Run: hyperclaw auth oauth google-gmail");
+}
+async function setupGmailWatch(opts) {
+	const token = await getGmailAccessToken();
+	const body = JSON.stringify({
+		topicName: opts.topicName,
+		labelIds: opts.labelIds || ["INBOX"],
+		labelFilterBehavior: "INCLUDE"
+	});
+	const res = await fetch("https://gmail.googleapis.com/gmail/v1/users/me/watch", {
+		method: "POST",
+		headers: {
+			Authorization: `Bearer ${token}`,
+			"Content-Type": "application/json"
+		},
+		body
+	});
+	if (!res.ok) {
+		const err = await res.text();
+		throw new Error(`Gmail API error ${res.status}: ${err}`);
+	}
+	return res.json();
+}
+
+//#endregion
+exports.setupGmailWatch = setupGmailWatch;

package/dist/gmail-watch-setup-DP3kDRx1.js

@@ -0,0 +1,42 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.js');
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+
+//#region src/commands/gmail-watch-setup.ts
+require_paths$1.init_paths();
+async function getGmailAccessToken() {
+	const hcDir = require_paths.getHyperClawDir();
+	const paths = [path.default.join(hcDir, "oauth-google-gmail.json"), path.default.join(hcDir, "oauth-google.json")];
+	for (const p of paths) {
+		if (!await fs_extra.default.pathExists(p)) continue;
+		const data = await fs_extra.default.readJson(p);
+		if (data.access_token) return data.access_token;
+	}
+	throw new Error("No Gmail OAuth token found. Run: hyperclaw auth oauth google-gmail");
+}
+async function setupGmailWatch(opts) {
+	const token = await getGmailAccessToken();
+	const body = JSON.stringify({
+		topicName: opts.topicName,
+		labelIds: opts.labelIds || ["INBOX"],
+		labelFilterBehavior: "INCLUDE"
+	});
+	const res = await fetch("https://gmail.googleapis.com/gmail/v1/users/me/watch", {
+		method: "POST",
+		headers: {
+			Authorization: `Bearer ${token}`,
+			"Content-Type": "application/json"
+		},
+		body
+	});
+	if (!res.ok) {
+		const err = await res.text();
+		throw new Error(`Gmail API error ${res.status}: ${err}`);
+	}
+	return res.json();
+}
+
+//#endregion
+exports.setupGmailWatch = setupGmailWatch;