hyperclaw 5.3.45 → 5.4.1

package/dist/sessions-tools-Bb_zF947.js

@@ -0,0 +1,95 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+
+//#region packages/core/src/agent/sessions-tools.ts
+function getSessionsTools(getServer, currentSessionId) {
+	return [
+		{
+			name: "sessions_list",
+			description: "List active WebSocket sessions connected to the gateway. Use to discover other agents or clients.",
+			input_schema: {
+				type: "object",
+				properties: {},
+				required: []
+			},
+			handler: async () => {
+				const server = getServer();
+				if (!server) return "Gateway not available (sessions tools only work when running in gateway).";
+				const list = server.getSessionsList?.() ?? [];
+				return JSON.stringify(list, null, 2);
+			}
+		},
+		{
+			name: "sessions_send",
+			description: "Send a message to another session. Use sessions_list to get session IDs.",
+			input_schema: {
+				type: "object",
+				properties: {
+					sessionId: {
+						type: "string",
+						description: "Target session ID from sessions_list"
+					},
+					content: {
+						type: "string",
+						description: "Message content to send"
+					}
+				},
+				required: ["sessionId", "content"]
+			},
+			handler: async (input) => {
+				const server = getServer();
+				if (!server) return "Gateway not available.";
+				const sessionId = input.sessionId;
+				const content = input.content;
+				const ok = server.sendToSession?.(sessionId, {
+					type: "chat:incoming",
+					content,
+					fromSession: currentSessionId ?? "unknown"
+				});
+				if (ok) return `Sent to session ${sessionId}.`;
+				return `Session ${sessionId} not found or disconnected.`;
+			}
+		},
+		{
+			name: "sessions_history",
+			description: "Get recent chat transcript for a session. Returns user/assistant turns.",
+			input_schema: {
+				type: "object",
+				properties: {
+					sessionId: {
+						type: "string",
+						description: "Session ID (use \"self\" for current session)"
+					},
+					limit: {
+						type: "string",
+						description: "Max turns to return (default 20)"
+					}
+				},
+				required: ["sessionId"]
+			},
+			handler: async (input) => {
+				const server = getServer();
+				if (!server) return "Gateway not available.";
+				const sid = input.sessionId === "self" ? currentSessionId : input.sessionId;
+				if (!sid) return "No current session.";
+				const limit = parseInt(input.limit || "20");
+				const history = server.getSessionHistory?.(sid, limit) ?? [];
+				return JSON.stringify(history, null, 2);
+			}
+		}
+	];
+}
+var init_sessions_tools = require_chunk.__esm({ "packages/core/src/agent/sessions-tools.ts"() {} });
+
+//#endregion
+Object.defineProperty(exports, 'getSessionsTools', {
+  enumerable: true,
+  get: function () {
+    return getSessionsTools;
+  }
+});
+Object.defineProperty(exports, 'init_sessions_tools', {
+  enumerable: true,
+  get: function () {
+    return init_sessions_tools;
+  }
+});

package/dist/sessions-tools-ClrKqLII.js

@@ -0,0 +1,131 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+
+//#region packages/core/src/agent/sessions-tools.ts
+function getSessionsTools(getServer, currentSessionId) {
+	return [
+		{
+			name: "sessions_list",
+			description: "List active WebSocket sessions connected to the gateway. Use to discover other agents or clients.",
+			input_schema: {
+				type: "object",
+				properties: {},
+				required: []
+			},
+			handler: async () => {
+				const server = getServer();
+				if (!server) return "Gateway not available (sessions tools only work when running in gateway).";
+				const list = server.getSessionsList?.() ?? [];
+				return JSON.stringify(list, null, 2);
+			}
+		},
+		{
+			name: "sessions_send",
+			description: "Send a message to another session. Use sessions_list to get session IDs.",
+			input_schema: {
+				type: "object",
+				properties: {
+					sessionId: {
+						type: "string",
+						description: "Target session ID from sessions_list"
+					},
+					content: {
+						type: "string",
+						description: "Message content to send"
+					}
+				},
+				required: ["sessionId", "content"]
+			},
+			handler: async (input) => {
+				const server = getServer();
+				if (!server) return "Gateway not available.";
+				const sessionId = input.sessionId;
+				const content = input.content;
+				const ok = server.sendToSession?.(sessionId, {
+					type: "chat:incoming",
+					content,
+					fromSession: currentSessionId ?? "unknown"
+				});
+				if (ok) return `Sent to session ${sessionId}.`;
+				return `Session ${sessionId} not found or disconnected.`;
+			}
+		},
+		{
+			name: "sessions_history",
+			description: "Get recent chat transcript for a session. Returns user/assistant turns.",
+			input_schema: {
+				type: "object",
+				properties: {
+					sessionId: {
+						type: "string",
+						description: "Session ID (use \"self\" for current session)"
+					},
+					limit: {
+						type: "string",
+						description: "Max turns to return (default 20)"
+					}
+				},
+				required: ["sessionId"]
+			},
+			handler: async (input) => {
+				const server = getServer();
+				if (!server) return "Gateway not available.";
+				const sid = input.sessionId === "self" ? currentSessionId : input.sessionId;
+				if (!sid) return "No current session.";
+				const limit = parseInt(input.limit || "20");
+				const history = server.getSessionHistory?.(sid, limit) ?? [];
+				return JSON.stringify(history, null, 2);
+			}
+		},
+		{
+			name: "sessions_spawn",
+			description: "Spawn a child agent to handle a task. Returns the child session ID and result. Use for delegation and parallel work.",
+			input_schema: {
+				type: "object",
+				properties: {
+					prompt: {
+						type: "string",
+						description: "Task for the child agent"
+					},
+					model: {
+						type: "string",
+						description: "Model override (optional)"
+					},
+					workspace: {
+						type: "string",
+						description: "Workspace path for child (optional)"
+					}
+				},
+				required: ["prompt"]
+			},
+			handler: async (input) => {
+				const server = getServer();
+				if (!server) return "Gateway not available (sessions_spawn requires gateway context).";
+				const spawn = server.spawnChildAgent;
+				if (!spawn) return "sessions_spawn not supported by this gateway.";
+				const prompt = input.prompt;
+				const model = input.model || void 0;
+				const workspace = input.workspace || void 0;
+				const result = await spawn(prompt, {
+					model,
+					workspace
+				});
+				return JSON.stringify(result, null, 2);
+			}
+		}
+	];
+}
+var init_sessions_tools = require_chunk.__esm({ "packages/core/src/agent/sessions-tools.ts"() {} });
+
+//#endregion
+Object.defineProperty(exports, 'getSessionsTools', {
+  enumerable: true,
+  get: function () {
+    return getSessionsTools;
+  }
+});
+Object.defineProperty(exports, 'init_sessions_tools', {
+  enumerable: true,
+  get: function () {
+    return init_sessions_tools;
+  }
+});

package/dist/sessions-tools-DFe23ZDD.js

@@ -0,0 +1,5 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_sessions_tools = require('./sessions-tools-Bb_zF947.js');
+
+require_sessions_tools.init_sessions_tools();
+exports.getSessionsTools = require_sessions_tools.getSessionsTools;

package/dist/sessions-tools-JHSZ6Bns.js

@@ -0,0 +1,5 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_sessions_tools = require('./sessions-tools-ClrKqLII.js');
+
+require_sessions_tools.init_sessions_tools();
+exports.getSessionsTools = require_sessions_tools.getSessionsTools;

package/dist/sessions-tools-TsRdeFb7.js

@@ -0,0 +1,95 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+
+//#region packages/core/src/agent/sessions-tools.ts
+function getSessionsTools(getServer, currentSessionId) {
+	return [
+		{
+			name: "sessions_list",
+			description: "List active WebSocket sessions connected to the gateway. Use to discover other agents or clients.",
+			input_schema: {
+				type: "object",
+				properties: {},
+				required: []
+			},
+			handler: async () => {
+				const server = getServer();
+				if (!server) return "Gateway not available (sessions tools only work when running in gateway).";
+				const list = server.getSessionsList?.() ?? [];
+				return JSON.stringify(list, null, 2);
+			}
+		},
+		{
+			name: "sessions_send",
+			description: "Send a message to another session. Use sessions_list to get session IDs.",
+			input_schema: {
+				type: "object",
+				properties: {
+					sessionId: {
+						type: "string",
+						description: "Target session ID from sessions_list"
+					},
+					content: {
+						type: "string",
+						description: "Message content to send"
+					}
+				},
+				required: ["sessionId", "content"]
+			},
+			handler: async (input) => {
+				const server = getServer();
+				if (!server) return "Gateway not available.";
+				const sessionId = input.sessionId;
+				const content = input.content;
+				const ok = server.sendToSession?.(sessionId, {
+					type: "chat:incoming",
+					content,
+					fromSession: currentSessionId ?? "unknown"
+				});
+				if (ok) return `Sent to session ${sessionId}.`;
+				return `Session ${sessionId} not found or disconnected.`;
+			}
+		},
+		{
+			name: "sessions_history",
+			description: "Get recent chat transcript for a session. Returns user/assistant turns.",
+			input_schema: {
+				type: "object",
+				properties: {
+					sessionId: {
+						type: "string",
+						description: "Session ID (use \"self\" for current session)"
+					},
+					limit: {
+						type: "string",
+						description: "Max turns to return (default 20)"
+					}
+				},
+				required: ["sessionId"]
+			},
+			handler: async (input) => {
+				const server = getServer();
+				if (!server) return "Gateway not available.";
+				const sid = input.sessionId === "self" ? currentSessionId : input.sessionId;
+				if (!sid) return "No current session.";
+				const limit = parseInt(input.limit || "20");
+				const history = server.getSessionHistory?.(sid, limit) ?? [];
+				return JSON.stringify(history, null, 2);
+			}
+		}
+	];
+}
+var init_sessions_tools = require_chunk.__esm({ "packages/core/src/agent/sessions-tools.ts"() {} });
+
+//#endregion
+Object.defineProperty(exports, 'getSessionsTools', {
+  enumerable: true,
+  get: function () {
+    return getSessionsTools;
+  }
+});
+Object.defineProperty(exports, 'init_sessions_tools', {
+  enumerable: true,
+  get: function () {
+    return init_sessions_tools;
+  }
+});

package/dist/sessions-tools-nYP3Agfs.js

@@ -0,0 +1,5 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const require_sessions_tools = require('./sessions-tools-BAZnoQLp.js');
+
+require_sessions_tools.init_sessions_tools();
+exports.getSessionsTools = require_sessions_tools.getSessionsTools;

package/dist/skill-loader-9jg876RH.js

@@ -0,0 +1,160 @@
+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/skill-loader.ts
+/** Validate skill id and content (manifest checks). */
+function validateSkill(id, content) {
+	const errors = [];
+	if (!id || id.length > 64) errors.push("id must be 1–64 characters");
+	else if (!ID_REGEX.test(id)) errors.push("id must be lowercase alphanumeric with only - or _");
+	const trimmed = (content || "").trim();
+	if (!trimmed) errors.push("content is empty");
+	if (trimmed.length > MAX_SKILL_CONTENT_SIZE) errors.push(`content exceeds ${MAX_SKILL_CONTENT_SIZE} characters`);
+	return {
+		valid: errors.length === 0,
+		errors
+	};
+}
+/** Extract manifest (title, version) from content. */
+function extractManifest(content) {
+	const titleMatch = content.match(/^#\s+(.+)$/m);
+	const versionMatch = content.match(/^(?:version|Version):\s*(\S+)/m);
+	return {
+		title: titleMatch ? titleMatch[1].trim().slice(0, 120) : void 0,
+		version: versionMatch ? versionMatch[1].trim().slice(0, 32) : void 0
+	};
+}
+async function runBeforeLoad() {
+	for (const h of lifecycleHooks) if (h.onBeforeLoad) await Promise.resolve(h.onBeforeLoad());
+}
+async function runAfterLoad(skills) {
+	for (const h of lifecycleHooks) if (h.onAfterLoad) await Promise.resolve(h.onAfterLoad(skills));
+}
+async function runUnload(skills) {
+	for (const h of lifecycleHooks) if (h.onUnload) await Promise.resolve(h.onUnload(skills));
+}
+function extractCapabilities(content) {
+	const capMatch = content.match(/## Capabilities?\s*\n+([\s\S]*?)(?=\n## |\n# |$)/i);
+	if (capMatch) return capMatch[1].trim().slice(0, 200);
+	const firstPara = content.replace(/^#.*\n+/, "").split(/\n\n/)[0]?.trim();
+	return firstPara ? firstPara.slice(0, 200) : "";
+}
+async function loadSkills(opts) {
+	await runBeforeLoad();
+	const skills = [];
+	for (const base of [BUNDLED_SKILLS, WORKSPACE_SKILLS]) {
+		if (!await fs_extra.default.pathExists(base)) continue;
+		const dirs = await fs_extra.default.readdir(base);
+		for (const id of dirs) {
+			const skillPath = path.default.join(base, id, "SKILL.md");
+			if (!await fs_extra.default.pathExists(skillPath)) continue;
+			const content = await fs_extra.default.readFile(skillPath, "utf8");
+			if (skills.some((s) => s.id === id)) continue;
+			if (!opts?.skipValidation) {
+				const v = validateSkill(id, content);
+				if (!v.valid) continue;
+			}
+			const manifest = extractManifest(content);
+			skills.push({
+				id,
+				path: skillPath,
+				content,
+				capabilities: extractCapabilities(content),
+				title: manifest.title,
+				version: manifest.version
+			});
+		}
+	}
+	lastLoaded = skills;
+	await runAfterLoad(skills);
+	return skills;
+}
+/** Unload current skills (run onUnload), then load again. */
+async function reloadSkills() {
+	await runUnload(lastLoaded);
+	return loadSkills();
+}
+function buildSkillsContext(skills) {
+	if (skills.length === 0) return "";
+	const capabilityList = skills.filter((s) => s.capabilities).map((s) => `- ${s.id}: ${s.capabilities}`).join("\n");
+	const header = capabilityList ? `\nCapability summary:\n${capabilityList}\n\n` : "";
+	const blocks = skills.map((s) => `## Skill: ${s.id}\n\n${s.content}`).join("\n\n---\n\n");
+	return `\n\n# Loaded Skills\n${header}${blocks}\n`;
+}
+/** Capability discovery: return id + summary for each loaded skill. */
+function getSkillCapabilities(skills) {
+	return skills.filter((s) => s.capabilities).map((s) => ({
+		id: s.id,
+		capabilities: s.capabilities
+	}));
+}
+/** Create or overwrite a skill from agent (self-writing skills). */
+async function writeSkill(skillId, opts) {
+	const id = skillId.replace(/[^a-z0-9-_]/gi, "-").toLowerCase() || "unnamed-skill";
+	const dir = path.default.join(WORKSPACE_SKILLS, id);
+	await fs_extra.default.ensureDir(dir);
+	const header = opts.name || id ? `# ${opts.name || id}\n\n${opts.description ? `> ${opts.description}\n\n` : ""}` : "";
+	const full = header + opts.content.trim();
+	await fs_extra.default.writeFile(path.default.join(dir, "SKILL.md"), full, "utf8");
+	return {
+		path: path.default.join(dir, "SKILL.md"),
+		id,
+		dir
+	};
+}
+var HC_DIR, BUNDLED_SKILLS, WORKSPACE_SKILLS, MAX_SKILL_CONTENT_SIZE, ID_REGEX, lifecycleHooks, lastLoaded;
+var init_skill_loader = require_chunk.__esm({ "packages/core/src/agent/skill-loader.ts"() {
+	HC_DIR = path.default.join(os.default.homedir(), ".hyperclaw");
+	BUNDLED_SKILLS = path.default.join(__dirname, "..", "skills");
+	WORKSPACE_SKILLS = path.default.join(HC_DIR, "workspace", "skills");
+	MAX_SKILL_CONTENT_SIZE = 2e5;
+	ID_REGEX = /^[a-z0-9][a-z0-9-_]*$/;
+	lifecycleHooks = [];
+	lastLoaded = [];
+} });
+
+//#endregion
+Object.defineProperty(exports, 'buildSkillsContext', {
+  enumerable: true,
+  get: function () {
+    return buildSkillsContext;
+  }
+});
+Object.defineProperty(exports, 'getSkillCapabilities', {
+  enumerable: true,
+  get: function () {
+    return getSkillCapabilities;
+  }
+});
+Object.defineProperty(exports, 'init_skill_loader', {
+  enumerable: true,
+  get: function () {
+    return init_skill_loader;
+  }
+});
+Object.defineProperty(exports, 'loadSkills', {
+  enumerable: true,
+  get: function () {
+    return loadSkills;
+  }
+});
+Object.defineProperty(exports, 'reloadSkills', {
+  enumerable: true,
+  get: function () {
+    return reloadSkills;
+  }
+});
+Object.defineProperty(exports, 'validateSkill', {
+  enumerable: true,
+  get: function () {
+    return validateSkill;
+  }
+});
+Object.defineProperty(exports, 'writeSkill', {
+  enumerable: true,
+  get: function () {
+    return writeSkill;
+  }
+});

package/dist/skill-loader-CM4KWQ7_.js

@@ -0,0 +1,160 @@
+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/skill-loader.ts
+/** Validate skill id and content (manifest checks). */
+function validateSkill(id, content) {
+	const errors = [];
+	if (!id || id.length > 64) errors.push("id must be 1–64 characters");
+	else if (!ID_REGEX.test(id)) errors.push("id must be lowercase alphanumeric with only - or _");
+	const trimmed = (content || "").trim();
+	if (!trimmed) errors.push("content is empty");
+	if (trimmed.length > MAX_SKILL_CONTENT_SIZE) errors.push(`content exceeds ${MAX_SKILL_CONTENT_SIZE} characters`);
+	return {
+		valid: errors.length === 0,
+		errors
+	};
+}
+/** Extract manifest (title, version) from content. */
+function extractManifest(content) {
+	const titleMatch = content.match(/^#\s+(.+)$/m);
+	const versionMatch = content.match(/^(?:version|Version):\s*(\S+)/m);
+	return {
+		title: titleMatch ? titleMatch[1].trim().slice(0, 120) : void 0,
+		version: versionMatch ? versionMatch[1].trim().slice(0, 32) : void 0
+	};
+}
+async function runBeforeLoad() {
+	for (const h of lifecycleHooks) if (h.onBeforeLoad) await Promise.resolve(h.onBeforeLoad());
+}
+async function runAfterLoad(skills) {
+	for (const h of lifecycleHooks) if (h.onAfterLoad) await Promise.resolve(h.onAfterLoad(skills));
+}
+async function runUnload(skills) {
+	for (const h of lifecycleHooks) if (h.onUnload) await Promise.resolve(h.onUnload(skills));
+}
+function extractCapabilities(content) {
+	const capMatch = content.match(/## Capabilities?\s*\n+([\s\S]*?)(?=\n## |\n# |$)/i);
+	if (capMatch) return capMatch[1].trim().slice(0, 200);
+	const firstPara = content.replace(/^#.*\n+/, "").split(/\n\n/)[0]?.trim();
+	return firstPara ? firstPara.slice(0, 200) : "";
+}
+async function loadSkills(opts) {
+	await runBeforeLoad();
+	const skills = [];
+	for (const base of [BUNDLED_SKILLS, WORKSPACE_SKILLS]) {
+		if (!await fs_extra.default.pathExists(base)) continue;
+		const dirs = await fs_extra.default.readdir(base);
+		for (const id of dirs) {
+			const skillPath = path.default.join(base, id, "SKILL.md");
+			if (!await fs_extra.default.pathExists(skillPath)) continue;
+			const content = await fs_extra.default.readFile(skillPath, "utf8");
+			if (skills.some((s) => s.id === id)) continue;
+			if (!opts?.skipValidation) {
+				const v = validateSkill(id, content);
+				if (!v.valid) continue;
+			}
+			const manifest = extractManifest(content);
+			skills.push({
+				id,
+				path: skillPath,
+				content,
+				capabilities: extractCapabilities(content),
+				title: manifest.title,
+				version: manifest.version
+			});
+		}
+	}
+	lastLoaded = skills;
+	await runAfterLoad(skills);
+	return skills;
+}
+/** Unload current skills (run onUnload), then load again. */
+async function reloadSkills() {
+	await runUnload(lastLoaded);
+	return loadSkills();
+}
+function buildSkillsContext(skills) {
+	if (skills.length === 0) return "";
+	const capabilityList = skills.filter((s) => s.capabilities).map((s) => `- ${s.id}: ${s.capabilities}`).join("\n");
+	const header = capabilityList ? `\nCapability summary:\n${capabilityList}\n\n` : "";
+	const blocks = skills.map((s) => `## Skill: ${s.id}\n\n${s.content}`).join("\n\n---\n\n");
+	return `\n\n# Loaded Skills\n${header}${blocks}\n`;
+}
+/** Capability discovery: return id + summary for each loaded skill. */
+function getSkillCapabilities(skills) {
+	return skills.filter((s) => s.capabilities).map((s) => ({
+		id: s.id,
+		capabilities: s.capabilities
+	}));
+}
+/** Create or overwrite a skill from agent (self-writing skills). */
+async function writeSkill(skillId, opts) {
+	const id = skillId.replace(/[^a-z0-9-_]/gi, "-").toLowerCase() || "unnamed-skill";
+	const dir = path.default.join(WORKSPACE_SKILLS, id);
+	await fs_extra.default.ensureDir(dir);
+	const header = opts.name || id ? `# ${opts.name || id}\n\n${opts.description ? `> ${opts.description}\n\n` : ""}` : "";
+	const full = header + opts.content.trim();
+	await fs_extra.default.writeFile(path.default.join(dir, "SKILL.md"), full, "utf8");
+	return {
+		path: path.default.join(dir, "SKILL.md"),
+		id,
+		dir
+	};
+}
+var HC_DIR, BUNDLED_SKILLS, WORKSPACE_SKILLS, MAX_SKILL_CONTENT_SIZE, ID_REGEX, lifecycleHooks, lastLoaded;
+var init_skill_loader = require_chunk.__esm({ "packages/core/src/agent/skill-loader.ts"() {
+	HC_DIR = path.default.join(os.default.homedir(), ".hyperclaw");
+	BUNDLED_SKILLS = path.default.join(__dirname, "..", "skills");
+	WORKSPACE_SKILLS = path.default.join(HC_DIR, "workspace", "skills");
+	MAX_SKILL_CONTENT_SIZE = 2e5;
+	ID_REGEX = /^[a-z0-9][a-z0-9-_]*$/;
+	lifecycleHooks = [];
+	lastLoaded = [];
+} });
+
+//#endregion
+Object.defineProperty(exports, 'buildSkillsContext', {
+  enumerable: true,
+  get: function () {
+    return buildSkillsContext;
+  }
+});
+Object.defineProperty(exports, 'getSkillCapabilities', {
+  enumerable: true,
+  get: function () {
+    return getSkillCapabilities;
+  }
+});
+Object.defineProperty(exports, 'init_skill_loader', {
+  enumerable: true,
+  get: function () {
+    return init_skill_loader;
+  }
+});
+Object.defineProperty(exports, 'loadSkills', {
+  enumerable: true,
+  get: function () {
+    return loadSkills;
+  }
+});
+Object.defineProperty(exports, 'reloadSkills', {
+  enumerable: true,
+  get: function () {
+    return reloadSkills;
+  }
+});
+Object.defineProperty(exports, 'validateSkill', {
+  enumerable: true,
+  get: function () {
+    return validateSkill;
+  }
+});
+Object.defineProperty(exports, 'writeSkill', {
+  enumerable: true,
+  get: function () {
+    return writeSkill;
+  }
+});