hyperclaw 4.0.1 → 4.0.2

package/dist/mcp-loader-DSM5UiFG.js

@@ -0,0 +1,94 @@
+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 src/services/mcp-loader.ts
+async function getMCPConfig() {
+	try {
+		const cfg = await fs_extra.default.readJson(path.default.join(HC_DIR, "hyperclaw.json"));
+		const servers = cfg.mcp?.servers ?? [];
+		return Array.isArray(servers) ? servers : [];
+	} catch {
+		return [];
+	}
+}
+/** Load tools from all configured MCP servers. */
+async function loadMCPTools() {
+	const servers = await getMCPConfig();
+	if (servers.length === 0) return [];
+	let Client;
+	let StdioClientTransport;
+	let StreamableHTTPClientTransport;
+	try {
+		const sdk = await import("@modelcontextprotocol/sdk");
+		Client = sdk.Client;
+		StdioClientTransport = sdk.StdioClientTransport;
+		StreamableHTTPClientTransport = sdk.StreamableHTTPClientTransport;
+	} catch {
+		return [];
+	}
+	const tools = [];
+	for (const srv of servers) try {
+		const client = new Client({
+			name: "hyperclaw",
+			version: "4.0.2"
+		});
+		if (srv.url) {
+			const transport = new StreamableHTTPClientTransport(new URL(srv.url));
+			await client.connect(transport);
+		} else if (srv.command) {
+			const transport = new StdioClientTransport({
+				command: srv.command,
+				args: srv.args ?? []
+			});
+			await client.connect(transport);
+		} else continue;
+		const allTools = [];
+		let cursor;
+		do {
+			const res = await client.listTools?.({ cursor }) ?? {
+				tools: [],
+				nextCursor: void 0
+			};
+			allTools.push(...res.tools ?? []);
+			cursor = res.nextCursor;
+		} while (cursor);
+		for (const t of allTools) {
+			const toolName = t.name;
+			const mcpClient = client;
+			tools.push({
+				name: `mcp_${srv.name}_${toolName}`.replace(/[^a-z0-9_]/gi, "_"),
+				description: (t.description ?? toolName).slice(0, 500),
+				input_schema: t.inputSchema && typeof t.inputSchema === "object" && "type" in t.inputSchema && "properties" in t.inputSchema ? t.inputSchema : {
+					type: "object",
+					properties: {}
+				},
+				handler: async (input) => {
+					try {
+						const result = await mcpClient.callTool?.({
+							name: toolName,
+							arguments: input
+						});
+						const content = result?.content;
+						if (Array.isArray(content)) return content.map((c) => c?.text ?? JSON.stringify(c)).join("\n");
+						return typeof content === "string" ? content : JSON.stringify(result ?? {});
+					} catch (e) {
+						return `MCP error: ${e.message}`;
+					}
+				}
+			});
+		}
+	} catch (e) {
+		console.error(`[mcp] Failed to load ${srv.name}:`, e.message);
+	}
+	return tools;
+}
+var HC_DIR;
+var init_mcp_loader = require_chunk.__esm({ "src/services/mcp-loader.ts"() {
+	HC_DIR = path.default.join(os.default.homedir(), ".hyperclaw");
+} });
+
+//#endregion
+init_mcp_loader();
+exports.loadMCPTools = loadMCPTools;

package/dist/mcp-loader-j5ZLLw5O.js

@@ -0,0 +1,94 @@
+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 src/services/mcp-loader.ts
+async function getMCPConfig() {
+	try {
+		const cfg = await fs_extra.default.readJson(path.default.join(HC_DIR, "hyperclaw.json"));
+		const servers = cfg.mcp?.servers ?? [];
+		return Array.isArray(servers) ? servers : [];
+	} catch {
+		return [];
+	}
+}
+/** Load tools from all configured MCP servers. */
+async function loadMCPTools() {
+	const servers = await getMCPConfig();
+	if (servers.length === 0) return [];
+	let Client;
+	let StdioClientTransport;
+	let StreamableHTTPClientTransport;
+	try {
+		const sdk = await import("@modelcontextprotocol/sdk");
+		Client = sdk.Client;
+		StdioClientTransport = sdk.StdioClientTransport;
+		StreamableHTTPClientTransport = sdk.StreamableHTTPClientTransport;
+	} catch {
+		return [];
+	}
+	const tools = [];
+	for (const srv of servers) try {
+		const client = new Client({
+			name: "hyperclaw",
+			version: "4.0.2"
+		});
+		if (srv.url) {
+			const transport = new StreamableHTTPClientTransport(new URL(srv.url));
+			await client.connect(transport);
+		} else if (srv.command) {
+			const transport = new StdioClientTransport({
+				command: srv.command,
+				args: srv.args ?? []
+			});
+			await client.connect(transport);
+		} else continue;
+		const allTools = [];
+		let cursor;
+		do {
+			const res = await client.listTools?.({ cursor }) ?? {
+				tools: [],
+				nextCursor: void 0
+			};
+			allTools.push(...res.tools ?? []);
+			cursor = res.nextCursor;
+		} while (cursor);
+		for (const t of allTools) {
+			const toolName = t.name;
+			const mcpClient = client;
+			tools.push({
+				name: `mcp_${srv.name}_${toolName}`.replace(/[^a-z0-9_]/gi, "_"),
+				description: (t.description ?? toolName).slice(0, 500),
+				input_schema: t.inputSchema && typeof t.inputSchema === "object" && "type" in t.inputSchema && "properties" in t.inputSchema ? t.inputSchema : {
+					type: "object",
+					properties: {}
+				},
+				handler: async (input) => {
+					try {
+						const result = await mcpClient.callTool?.({
+							name: toolName,
+							arguments: input
+						});
+						const content = result?.content;
+						if (Array.isArray(content)) return content.map((c) => c?.text ?? JSON.stringify(c)).join("\n");
+						return typeof content === "string" ? content : JSON.stringify(result ?? {});
+					} catch (e) {
+						return `MCP error: ${e.message}`;
+					}
+				}
+			});
+		}
+	} catch (e) {
+		console.error(`[mcp] Failed to load ${srv.name}:`, e.message);
+	}
+	return tools;
+}
+var HC_DIR;
+var init_mcp_loader = require_chunk.__esm({ "src/services/mcp-loader.ts"() {
+	HC_DIR = path.default.join(os.default.homedir(), ".hyperclaw");
+} });
+
+//#endregion
+init_mcp_loader();
+exports.loadMCPTools = loadMCPTools;

package/dist/memory-BI1kPkAN.js

@@ -0,0 +1,4 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_memory = require('./memory-BVFGkxxK.js');
+
+exports.initWorkspaceFiles = require_memory.initWorkspaceFiles;

package/dist/memory-BVFGkxxK.js

@@ -0,0 +1,270 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const chalk = require_chunk.__toESM(require("chalk"));
+const ora = require_chunk.__toESM(require("ora"));
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const os = require_chunk.__toESM(require("os"));
+
+//#region src/agents/memory.ts
+var MemoryManager = class {
+	baseDir;
+	agentsFile;
+	memoryFile;
+	logFile;
+	constructor(workspaceDir) {
+		this.baseDir = workspaceDir || path.default.join(os.default.homedir(), ".hyperclaw");
+		this.agentsFile = path.default.join(this.baseDir, "AGENTS.md");
+		this.memoryFile = path.default.join(this.baseDir, "MEMORY.md");
+		this.logFile = path.default.join(this.baseDir, "logs", `${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.md`);
+	}
+	async init(identity) {
+		await fs_extra.default.ensureDir(this.baseDir);
+		await fs_extra.default.ensureDir(path.default.join(this.baseDir, "logs"));
+		const spinner = (0, ora.default)("Initializing memory and agent identity...").start();
+		await this.writeAgentsMd(identity);
+		await this.writeMemoryMd(identity);
+		await this.initDailyLog();
+		spinner.succeed("AGENTS.md, MEMORY.md and daily log created");
+		console.log(chalk.default.gray(`   📁 Workspace: ${this.baseDir}`));
+		console.log(chalk.default.gray(`   📄 AGENTS.md: ${this.agentsFile}`));
+		console.log(chalk.default.gray(`   🧠 MEMORY.md: ${this.memoryFile}`));
+		console.log();
+	}
+	async writeAgentsMd(id) {
+		const content = `# AGENTS.md — HyperClaw Global Agent Rules
+> Generated: ${(/* @__PURE__ */ new Date()).toISOString()}
+> This file is read by ALL sessions and subagents.
+
+## Identity
+- **Agent Name:** ${id.agentName}
+- **User Name:** ${id.userName}
+- **Personality:** ${id.personality}
+- **Language:** ${id.language}
+
+## Global Rules
+${id.rules.map((r, i) => `${i + 1}. ${r}`).join("\n")}
+
+## Subagent Hierarchy
+- Parent: HyperClaw Core
+- Children: Channel Agents (Telegram, Discord, etc.)
+- All subagents MUST inherit these rules
+- No subagent may override global safety rules
+
+## Memory Protocol
+- Write significant events to MEMORY.md
+- Log daily interactions to logs/YYYY-MM-DD.md
+- Always read AGENTS.md at session start
+
+## Safety Boundaries
+- Never reveal the auth token
+- Never execute code outside the sandbox skill
+- Always ask for confirmation before irreversible actions
+- Refuse requests that violate user privacy
+
+## Cross-Session Persistence
+- Session state is stored in ~/.hyperclaw/sessions/
+- Use memory tools to recall past interactions
+`;
+		await fs_extra.default.writeFile(this.agentsFile, content, "utf8");
+	}
+	async writeMemoryMd(id) {
+		const content = `# MEMORY.md — HyperClaw Persistent Memory
+> Initialized: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+## User Profile
+- Name: ${id.userName}
+- Preferred language: ${id.language}
+- Agent alias: ${id.agentName}
+
+## Session History
+*(Populated automatically during sessions)*
+
+## Key Facts
+*(Write important information here for future sessions)*
+
+## Reminders
+*(Active reminders are listed here)*
+`;
+		await fs_extra.default.writeFile(this.memoryFile, content, "utf8");
+	}
+	async initDailyLog() {
+		const today = (/* @__PURE__ */ new Date()).toLocaleDateString("en-US", {
+			weekday: "long",
+			year: "numeric",
+			month: "long",
+			day: "numeric"
+		});
+		const content = `# Daily Log — ${today}
+
+## Sessions
+- ${(/* @__PURE__ */ new Date()).toLocaleTimeString()} — Session initialized
+
+## Notes
+`;
+		await fs_extra.default.ensureDir(path.default.dirname(this.logFile));
+		await fs_extra.default.writeFile(this.logFile, content, "utf8");
+	}
+	async appendRule(rule) {
+		const spinner = (0, ora.default)("Writing rule to AGENTS.md...").start();
+		const content = await fs_extra.default.readFile(this.agentsFile, "utf8");
+		const updated = content.replace("*(Populated automatically during sessions)*", `*(Populated automatically during sessions)*\n\n### Added Rule\n- ${rule}`);
+		await fs_extra.default.writeFile(this.agentsFile, updated, "utf8");
+		spinner.succeed(`Rule added to AGENTS.md`);
+	}
+	async addMemory(fact) {
+		const spinner = (0, ora.default)("Writing to MEMORY.md...").start();
+		const content = await fs_extra.default.readFile(this.memoryFile, "utf8");
+		const entry = `\n- [${(/* @__PURE__ */ new Date()).toISOString()}] ${fact}`;
+		const updated = content.replace("*(Write important information here for future sessions)*", `*(Write important information here for future sessions)*${entry}`);
+		await fs_extra.default.writeFile(this.memoryFile, updated, "utf8");
+		spinner.succeed(`Memory updated`);
+	}
+	async load() {
+		try {
+			const agents = await fs_extra.default.readFile(this.agentsFile, "utf8");
+			const memory = await fs_extra.default.readFile(this.memoryFile, "utf8");
+			return {
+				agents,
+				memory
+			};
+		} catch {
+			return null;
+		}
+	}
+	getBaseDir() {
+		return this.baseDir;
+	}
+};
+async function initWorkspaceFiles(identity, workspaceDir) {
+	const files = {
+		"SOUL.md": generateSoul(identity),
+		"USER.md": generateUser(identity),
+		"TOOLS.md": generateTools(),
+		"HEARTBEAT.md": generateHeartbeat(),
+		"BOOTSTRAP.md": generateBootstrap(identity)
+	};
+	await fs_extra.default.ensureDir(workspaceDir);
+	for (const [fname, content] of Object.entries(files)) {
+		const fpath = path.default.join(workspaceDir, fname);
+		if (!await fs_extra.default.pathExists(fpath)) await fs_extra.default.writeFile(fpath, content, "utf8");
+	}
+}
+function generateSoul(id) {
+	return `# SOUL.md — Agent Personality & Values
+> Generated: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+## Core Identity
+- **Name:** ${id.agentName}
+- **Personality:** ${id.personality}
+- **Primary language:** ${id.language}
+
+## Values
+- Honesty over flattery
+- Brevity — get to the point
+- Respect autonomy — suggest, never demand
+- Always confirm before irreversible actions
+
+## Boundaries
+- Never reveal gateway tokens or API keys
+- Always ask confirmation before destructive actions
+- Never claim to be human when sincerely asked
+`;
+}
+function generateUser(id) {
+	return `# USER.md — About the Person I Work For
+> Generated: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+## Identity
+- **Name:** ${id.userName}
+- **Preferred language:** ${id.language}
+
+## Communication Preferences
+- Tone: casual
+- Response length: auto
+
+## What I'm Working On
+*(Update this regularly — agent uses it for context)*
+
+## My Stack
+*(Add your tools here)*
+
+## Do NOT do these things
+- Pad responses with unnecessary filler
+
+## Always do these things
+- Respond in ${id.language} unless I write in another language
+`;
+}
+function generateTools() {
+	return `# TOOLS.md — Available Skills & Tools
+> Generated: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+## Active Skills
+| ID | Name | Status |
+|----|------|--------|
+| reminders | Smart Reminders | ✅ enabled |
+| translator | Real-time Translator | ✅ enabled |
+
+## Add More Skills
+\`\`\`
+hyperclaw hub         # Browse available skills
+hyperclaw hub --install web-search
+\`\`\`
+
+## MCP Servers
+No MCP servers configured. Add with: \`hyperclaw mcp add\`
+`;
+}
+function generateHeartbeat() {
+	return `# HEARTBEAT.md — System Health Log
+> Initialized: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+Auto-written by the gateway-health hook every 5 minutes.
+Enable with: \`hyperclaw hooks enable gateway-health\`
+
+## Last Status
+Pending first heartbeat...
+`;
+}
+function generateBootstrap(id) {
+	return `# BOOTSTRAP.md β€” Fast Start Context
+> Generated: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+## Mission
+Help ${id.userName} move the current task forward with minimal setup friction.
+
+## First Tasks
+1. Read AGENTS.md, USER.md, TOOLS.md, and MEMORY.md if present.
+2. Confirm the current repo / project shape before editing anything.
+3. Prefer the smallest change that unblocks progress.
+
+## Environment
+- Agent: ${id.agentName}
+- User: ${id.userName}
+- Language: ${id.language}
+
+## Current Constraints
+- Ask before irreversible actions.
+- Keep secrets out of workspace markdown files.
+- Update docs when behavior changes.
+
+## Definition Of Done
+- Requested change is implemented.
+- Relevant checks or verifications are run when available.
+- Important follow-up risks are documented briefly.
+`;
+}
+
+//#endregion
+Object.defineProperty(exports, 'MemoryManager', {
+  enumerable: true,
+  get: function () {
+    return MemoryManager;
+  }
+});
+Object.defineProperty(exports, 'initWorkspaceFiles', {
+  enumerable: true,
+  get: function () {
+    return initWorkspaceFiles;
+  }
+});