hyperclaw 5.1.9 → 5.2.1

package/dist/memory-B47nvgOq.js

@@ -0,0 +1,271 @@
+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, only) {
+	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)) {
+		if (only && !only.some((sel) => fname.startsWith(sel))) continue;
+		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;
+  }
+});

package/dist/memory-D-Py-cz5.js

@@ -0,0 +1,273 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_paths = require('./paths-AIyBxIzm.js');
+const require_paths$1 = require('./paths-DPovhojT.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"));
+
+//#region src/agents/memory.ts
+require_paths$1.init_paths();
+var MemoryManager = class {
+	baseDir;
+	agentsFile;
+	memoryFile;
+	logFile;
+	constructor(workspaceDir) {
+		this.baseDir = workspaceDir || require_paths.getHyperClawDir();
+		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, only) {
+	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)) {
+		if (only && !only.some((sel) => fname.startsWith(sel))) continue;
+		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;
+  }
+});

package/dist/memory-D991eoj7.js

@@ -0,0 +1,6 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+require('./paths-AIyBxIzm.js');
+require('./paths-DPovhojT.js');
+const require_memory = require('./memory-D-Py-cz5.js');
+
+exports.initWorkspaceFiles = require_memory.initWorkspaceFiles;

package/dist/memory-DoQoaHjo.js

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

package/dist/memory-auto-5aBZQJQY.js

@@ -0,0 +1,5 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_memory_auto = require('./memory-auto-BTeOoLsb.js');
+
+require_memory_auto.init_memory_auto();
+exports.AutoMemory = require_memory_auto.AutoMemory;