@markus-global/cli 0.4.21 → 0.4.22

package/dist/markus.mjs

@@ -3566,7 +3566,7 @@ function buildManifest(type, raw) {
   if (type === "agent") {
     const agentRaw = raw.agent ?? raw;
     base.agent = {
-      roleName: agentRaw.roleName ?? raw.roleName ?? "developer",
+      roleName: agentRaw.roleName || raw.roleName || void 0,
       agentRole: agentRaw.agentRole ?? raw.agentRole ?? "worker",
       llmProvider: agentRaw.llmProvider || raw.llmProvider || void 0,
       llmModel: agentRaw.llmModel || raw.llmModel || void 0,
@@ -3585,7 +3585,7 @@ function buildManifest(type, raw) {
       members: rawMembers.map((m) => ({
         name: m.name ?? "Agent",
         role: m.role ?? "worker",
-        roleName: m.roleName ?? "developer",
+        roleName: m.roleName || void 0,
         count: m.count ?? 1,
         skills: toArr(m.skills).length > 0 ? toArr(m.skills) : void 0
       }))
@@ -3652,8 +3652,8 @@ function validateManifest(m) {
     errors.push("version must be semver (e.g. 1.0.0)");
   if (o.type === "agent" && o.agent) {
     const a = o.agent;
-    if (!a.roleName || typeof a.roleName !== "string")
-      errors.push("agent.roleName is required");
+    if (a.roleName !== void 0 && typeof a.roleName !== "string")
+      errors.push("agent.roleName must be a string if provided");
   }
   if (o.type === "team" && o.team) {
     const t = o.team;
@@ -3662,10 +3662,12 @@ function validateManifest(m) {
   }
   return errors;
 }
-function kebab(s) {
+function kebab(s, fallback) {
   const result = s.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "").replace(/^-+|-+$/g, "");
   if (result)
     return result;
+  if (fallback)
+    return fallback;
   let hash = 0;
   for (let i = 0; i < s.length; i++)
     hash = (hash << 5) - hash + s.charCodeAt(i) | 0;
@@ -4409,6 +4411,7 @@ __export(dist_exports, {
   getTextContent: () => getTextContent,
   isPlaceholder: () => isPlaceholder,
   isValidTaskTransition: () => isValidTaskTransition,
+  kebab: () => kebab,
   loadConfig: () => loadConfig,
   manifestFilename: () => manifestFilename,
   msgId: () => msgId,
@@ -45193,6 +45196,7 @@ ${notification.stdoutTail}`);
           });
         });
         const roleFilePath = join10(this.dataDir, "role", "ROLE.md");
+        const heartbeatFilePath = join10(this.dataDir, "role", "HEARTBEAT.md");
         this.toolHooks.register({
           name: "role-auto-reload",
           after: async (ctx) => {
@@ -45202,6 +45206,10 @@ ${notification.stdoutTail}`);
                 log17.info("Agent modified its own ROLE.md \u2014 reloading role definition");
                 this.reloadRole();
               }
+              if (targetPath === heartbeatFilePath || targetPath.endsWith("/role/HEARTBEAT.md")) {
+                log17.info("Agent modified its own HEARTBEAT.md \u2014 reloading heartbeat checklist");
+                this.reloadHeartbeat();
+              }
             }
           }
         });
@@ -45710,6 +45718,25 @@ ${notification.stdoutTail}`);
           log17.warn(`Failed to reload role for agent ${this.config.name}`, { error: String(err) });
         }
       }
+      /**
+       * Reload the agent's heartbeat checklist from its HEARTBEAT.md file on disk.
+       * Called when the agent modifies its own HEARTBEAT.md via file_edit/file_write.
+       */
+      reloadHeartbeat() {
+        const heartbeatFile = join10(this.dataDir, "role", "HEARTBEAT.md");
+        if (!existsSync15(heartbeatFile))
+          return;
+        try {
+          const content = readFileSync10(heartbeatFile, "utf-8");
+          this.role = {
+            ...this.role,
+            heartbeatChecklist: content
+          };
+          log17.info(`Heartbeat checklist reloaded from disk for agent ${this.config.name}`);
+        } catch (err) {
+          log17.warn(`Failed to reload heartbeat for agent ${this.config.name}`, { error: String(err) });
+        }
+      }
       /**
        * Start a fresh conversation session, discarding the current in-memory session context.
        * Called when the user explicitly starts a "New Chat".
@@ -48627,6 +48654,10 @@ ${todayLog.slice(0, HEARTBEAT_DAILY_LOG_CHARS)}
           '- Check existing skills first: `discover_tools({ mode: "list_skills" })` and `builder_list`.',
           "- To update an existing skill: edit files in `~/.markus/builder-artifacts/skills/{name}/`, bump version, re-install with `builder_install`.",
           "",
+          "**Direct self-evolution** (simplest and most impactful):",
+          "- **Update ROLE.md** \u2014 When you discover a behavioral rule, working style, or guiding principle that should always apply, append it to your ROLE.md via `file_edit`. ROLE.md is loaded into every conversation, so changes take effect immediately. Read first, then append. No need to accumulate 3 insights \u2014 even a single validated lesson can warrant a role update if it is fundamental.",
+          "- **Update HEARTBEAT.md** \u2014 When you realize your patrol routine should include a new recurring check (or remove an obsolete one), modify your HEARTBEAT.md via `file_edit`. This is your personal checklist \u2014 customize it to match your actual responsibilities. Changes take effect at the next heartbeat.",
+          "",
           "**Decision guide \u2014 where does this insight go?**",
           "| Observation type | Action |",
           "|---|---|",
@@ -48634,7 +48665,8 @@ ${todayLog.slice(0, HEARTBEAT_DAILY_LOG_CHARS)}
           '| Tool tip or preference | `memory_save` with tags: `["insight", "tool:<name>"]` |',
           '| Multi-step repeatable workflow | `memory_update_longterm({ section: "procedures", mode: "patch" })` |',
           "| Practice worth sharing with the team | Create skill via **skill-building**, then install with `builder_install` |",
-          "| 3+ related insights \u2192 behavioral rule | Update ROLE.md (read first, append, log change) |",
+          "| Behavioral rule or guiding principle | Update ROLE.md (`file_read` \u2192 `file_edit` to append) |",
+          "| New recurring check for your patrol | Update HEARTBEAT.md (`file_read` \u2192 `file_edit`) |",
           "",
           "Quality bar: Only record insights that are **specific**, **actionable**, and **non-obvious**.",
           "Skip if nothing meaningful happened since last heartbeat."
@@ -48662,7 +48694,8 @@ ${todayLog.slice(0, HEARTBEAT_DAILY_LOG_CHARS)}
           "- Tasks with `executionRound > 1` required revision \u2014 your initial approach had issues.",
           "- A high revision rate (>30%) suggests your knowledge is not being applied effectively.",
           "- Check: does your MEMORY.md knowledge actually cover the failure patterns you see?",
-          "- If you keep making the same type of mistake, escalate: save as insight \u2192 add to MEMORY.md \u2192 update ROLE.md."
+          "- If you keep making the same type of mistake, escalate: save as insight \u2192 add to MEMORY.md \u2192 update ROLE.md or HEARTBEAT.md.",
+          "- Consider: would a ROLE.md rule or a HEARTBEAT.md check have prevented any recent failures?"
         ].join("\n");
         const prompt = [
           "[HEARTBEAT CHECK-IN]",
@@ -53209,24 +53242,39 @@ Priority: ${delegation.priority}`, envelope.from, { name: envelope.from, role: "
         if (!request.name?.trim())
           throw new Error("Agent name is required");
         const id = agentId();
-        const role = this.roleLoader.loadRole(request.roleName);
+        const roleName = request.roleName || "custom";
+        const isCustomRole = roleName === "custom";
+        const role = isCustomRole ? {
+          id: generateId("role"),
+          name: request.name,
+          description: "",
+          category: "custom",
+          systemPrompt: `# ${request.name}
+
+You are ${request.name}.`,
+          defaultSkills: [],
+          heartbeatChecklist: "",
+          defaultPolicies: [],
+          builtIn: false
+        } : this.roleLoader.loadRole(roleName);
         const agentDataDir = join13(this.dataDir, id);
         mkdirSync12(agentDataDir, { recursive: true });
         const agentRoleDir = join13(agentDataDir, "role");
         mkdirSync12(agentRoleDir, { recursive: true });
-        const templateDir = this.roleLoader.resolveTemplateDir(request.roleName);
-        if (templateDir) {
-          for (const file of ["ROLE.md", "HEARTBEAT.md", "POLICIES.md", "CONTEXT.md"]) {
-            const src = join13(templateDir, file);
-            if (existsSync18(src))
-              copyFileSync(src, join13(agentRoleDir, file));
+        if (!isCustomRole && !request.skipTemplateCopy) {
+          const templateDir = this.roleLoader.resolveTemplateDir(roleName);
+          if (templateDir) {
+            for (const file of ["ROLE.md", "HEARTBEAT.md", "POLICIES.md", "CONTEXT.md"]) {
+              const src = join13(templateDir, file);
+              if (existsSync18(src))
+                copyFileSync(src, join13(agentRoleDir, file));
+            }
           }
         }
         const config = {
           id,
           name: request.name,
-          // Store the template folder name so agents can be restored on restart
-          roleId: request.roleName,
+          roleId: roleName,
           orgId: request.orgId ?? "default",
           teamId: request.teamId,
           agentRole: request.agentRole ?? "worker",
@@ -53742,6 +53790,20 @@ Known issues: ${knownIssues}` : ""}`
         let role;
         if (existsSync18(join13(agentRoleDir, "ROLE.md"))) {
           role = this.roleLoader.loadRole(agentRoleDir);
+        } else if (row.roleId === "custom") {
+          role = {
+            id: generateId("role"),
+            name: row.name,
+            description: "",
+            category: "custom",
+            systemPrompt: `# ${row.name}
+
+You are ${row.name}.`,
+            defaultSkills: [],
+            heartbeatChecklist: "",
+            defaultPolicies: [],
+            builtIn: false
+          };
         } else {
           role = (() => {
             try {
@@ -58049,7 +58111,7 @@ var init_registry = __esm({
       skills = /* @__PURE__ */ new Map();
       aliases = /* @__PURE__ */ new Map();
       static normalize(s) {
-        return s.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+        return kebab(s);
       }
       register(skill) {
         const name = skill.manifest.name;
@@ -59794,15 +59856,17 @@ var init_org_service = __esm({
           }
         }
         this.refreshIdentityContextsForOrg(request.orgId);
-        try {
-          await this.agentManager.startAgent(agent.id);
-          log50.info(`Agent onboarded: ${request.name} (auto-started)`, {
-            orgId: request.orgId,
-            agentId: agent.id,
-            agentRole: request.agentRole ?? "worker"
-          });
-        } catch (error) {
-          log50.warn(`Agent created but auto-start failed: ${request.name}`, { error: String(error) });
+        if (!request.skipAutoStart) {
+          try {
+            await this.agentManager.startAgent(agent.id);
+            log50.info(`Agent onboarded: ${request.name} (auto-started)`, {
+              orgId: request.orgId,
+              agentId: agent.id,
+              agentRole: request.agentRole ?? "worker"
+            });
+          } catch (error) {
+            log50.warn(`Agent created but auto-start failed: ${request.name}`, { error: String(error) });
+          }
         }
         return agent;
       }
@@ -60125,9 +60189,9 @@ var init_org_service = __esm({
         const roleNames = this.listAvailableRoles();
         if (roleNames.length > 0) {
           parts.push("");
-          parts.push("## Available Role Templates (live from system)");
+          parts.push("## Built-in Role Templates (for reference only)");
           parts.push("");
-          parts.push("The `roleName` field must be one of:");
+          parts.push("These templates are available for reading as **reference** when writing custom ROLE.md files. You do NOT need to set `roleName` \u2014 the agent's identity is fully defined by its ROLE.md.");
           parts.push("");
           for (const r of roleNames) {
             parts.push(`- \`${r}\``);
@@ -60135,9 +60199,9 @@ var init_org_service = __esm({
           const templateDirs = this.roleLoader.getTemplateDirs();
           if (templateDirs.length > 0) {
             parts.push("");
-            parts.push("**Tip**: You can read existing role templates for reference when writing custom ROLE.md files.");
+            parts.push("**Tip**: Read existing templates for inspiration when writing custom ROLE.md files.");
             parts.push(`Use \`file_read\` to inspect any template, e.g.: \`file_read("${templateDirs[0]}/developer/ROLE.md")\``);
-            parts.push("This is especially useful for understanding the level of detail and workflow guidance expected in a good ROLE.md.");
+            parts.push("This is useful for understanding the level of detail and workflow guidance expected in a good ROLE.md.");
           }
         }
         parts.push("");
@@ -62714,7 +62778,11 @@ Action: ${guidance}` : ""
           "",
           'Save each lesson using `memory_save` with tags `["lesson", ...]`.',
           'If it is a repeatable multi-step procedure, promote to SOP via `memory_update_longterm({ section: "sops", mode: "patch" })`.',
-          "If the best practice would benefit other agents on the team, create a shareable skill via **skill-building** and install it with `builder_install`."
+          "If the best practice would benefit other agents on the team, create a shareable skill via **skill-building** and install it with `builder_install`.",
+          "",
+          "**Direct self-evolution** \u2014 consider the simplest, most impactful options:",
+          "- If this lesson reveals a behavioral rule that should always guide your work, append it to your ROLE.md via `file_edit`.",
+          "- If you should be checking for this class of issue regularly, add a check to your HEARTBEAT.md via `file_edit`."
         ].join("\n") : [
           "[SELF-EVOLUTION \u2014 Post-Task Reflection (Success)]",
           "",
@@ -62731,6 +62799,11 @@ Action: ${guidance}` : ""
           'If you identify a meaningful insight, save it using `memory_save` with tags `["lesson", "best-practice", ...]`.',
           'If it is a multi-step workflow, promote to SOP via `memory_update_longterm({ section: "sops", mode: "patch" })`.',
           "If worth sharing with the team, create a skill via **skill-building** and install with `builder_install`.",
+          "",
+          "**Direct self-evolution** \u2014 consider the simplest, most impactful options:",
+          "- If this success reveals a guiding principle or working style worth keeping, append it to your ROLE.md via `file_edit`.",
+          "- If there is a periodic check that would help maintain this quality, add it to your HEARTBEAT.md via `file_edit`.",
+          "",
           "If nothing noteworthy stands out, it is fine to skip saving."
         ].join("\n");
         void agent.sendMessage(prompt, void 0, void 0, {
@@ -63413,7 +63486,7 @@ ${task.description}`;
 
 // ../org-manager/dist/builder-service.js
 import { join as join21 } from "node:path";
-import { readdirSync as readdirSync8, readFileSync as readFileSync19, existsSync as existsSync25, writeFileSync as writeFileSync14, mkdirSync as mkdirSync17, copyFileSync as copyFileSync2, statSync as statSync4 } from "node:fs";
+import { readdirSync as readdirSync8, readFileSync as readFileSync19, existsSync as existsSync25, writeFileSync as writeFileSync14, mkdirSync as mkdirSync17, copyFileSync as copyFileSync2, statSync as statSync4, cpSync as cpSync2 } from "node:fs";
 import { homedir as homedir12 } from "node:os";
 var log52, FS_HELPER, BuilderService;
 var init_builder_service = __esm({
@@ -63497,17 +63570,17 @@ var init_builder_service = __esm({
       async installAgent(artDir, manifest, mfName, artifactName) {
         const agentManager = this.orgService.getAgentManager();
         const agentName = manifest.displayName ?? manifest.name ?? artifactName;
-        const knownRoles = this.orgService.listAvailableRoles();
-        const requestedRole = manifest.agent?.roleName ?? "developer";
-        const roleName = knownRoles.includes(requestedRole) ? requestedRole : "developer";
+        const hasCustomRole = existsSync25(join21(artDir, "ROLE.md"));
         const skills = manifest.dependencies?.skills ?? [];
         const agentRole = manifest.agent?.agentRole ?? "worker";
         const agent = await this.orgService.hireAgent({
           name: agentName,
-          roleName,
+          roleName: manifest.agent?.roleName || (hasCustomRole ? "custom" : "developer"),
           orgId: "default",
           agentRole,
-          skills
+          skills,
+          skipAutoStart: true,
+          skipTemplateCopy: hasCustomRole
         });
         const agentRoleDir = join21(agentManager.getDataDir(), agent.id, "role");
         mkdirSync17(agentRoleDir, { recursive: true });
@@ -63547,38 +63620,42 @@ var init_builder_service = __esm({
         const norms = existsSync25(normsPath) ? readFileSync19(normsPath, "utf-8") : "";
         this.orgService.ensureTeamDataDir(team.id, announcements, norms);
         const members = manifest.team?.members ?? [];
-        const knownRoles = this.orgService.listAvailableRoles();
         const createdAgents = [];
+        const usedMemberDirs = /* @__PURE__ */ new Set();
         for (const member of members) {
           const count = member.count ?? 1;
           const memberRole = member.role ?? "worker";
           const memberName = member.name ?? "Agent";
-          const roleName = knownRoles.includes(member.roleName) ? member.roleName : "developer";
           const memberSkills = member.skills ?? [];
-          const memberSlug = memberName.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
-          const memberFilesDir = join21(artDir, "members", memberSlug);
+          const memberFilesDir = this.findMemberDir(artDir, memberName, usedMemberDirs);
+          const hasCustomRole = !!memberFilesDir && existsSync25(join21(memberFilesDir, "ROLE.md"));
+          if (memberFilesDir)
+            usedMemberDirs.add(memberFilesDir);
+          log52.info("installTeam: member lookup", { memberName, memberFilesDir, hasCustomRole });
           for (let i = 0; i < count; i++) {
             const displayName = count > 1 ? `${memberName} ${i + 1}` : memberName;
             const agent = await this.orgService.hireAgent({
               name: displayName,
-              roleName,
+              roleName: member.roleName || (hasCustomRole ? "custom" : "developer"),
               orgId: "default",
               teamId: team.id,
               agentRole: memberRole,
-              skills: memberSkills.length > 0 ? memberSkills : void 0
+              skills: memberSkills.length > 0 ? memberSkills : void 0,
+              skipAutoStart: true,
+              skipTemplateCopy: hasCustomRole
             });
             const agentRoleDir = join21(agentManager.getDataDir(), agent.id, "role");
             mkdirSync17(agentRoleDir, { recursive: true });
-            if (existsSync25(memberFilesDir)) {
+            if (memberFilesDir && existsSync25(memberFilesDir)) {
               for (const fname of readdirSync8(memberFilesDir)) {
                 const srcFile = join21(memberFilesDir, fname);
                 if (statSync4(srcFile).isFile()) {
                   copyFileSync2(srcFile, join21(agentRoleDir, fname));
                 }
               }
-              agent.reloadRole();
             }
             writeFileSync14(join21(agentRoleDir, ".role-origin.json"), JSON.stringify({ customRole: true, source: "builder-artifact", artifact: artifactName, artifactType: "team" }));
+            agent.reloadRole();
             if (memberRole === "manager") {
               await this.orgService.updateTeam(team.id, { managerId: agent.id, managerType: "agent" });
             }
@@ -63591,13 +63668,56 @@ var init_builder_service = __esm({
           installed: { team: { id: team.id, name: teamName }, agents: createdAgents }
         };
       }
+      /**
+       * Find the member directory under artDir/members/ by trying multiple slug strategies.
+       * Returns the absolute path to the member directory, or null if not found.
+       */
+      findMemberDir(artDir, memberName, usedDirs) {
+        const membersBase = join21(artDir, "members");
+        if (!existsSync25(membersBase))
+          return null;
+        const slug = kebab(memberName, "agent");
+        const exact = join21(membersBase, slug);
+        if (existsSync25(exact) && !usedDirs.has(exact))
+          return exact;
+        try {
+          for (const entry of readdirSync8(membersBase, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+              continue;
+            const candidateDir = join21(membersBase, entry.name);
+            if (usedDirs.has(candidateDir))
+              continue;
+            const rolePath = join21(candidateDir, "ROLE.md");
+            if (!existsSync25(rolePath))
+              continue;
+            try {
+              const content = readFileSync19(rolePath, "utf-8");
+              const title = content.match(/^#\s+(.+)$/m)?.[1]?.trim();
+              if (title && title.toLowerCase() === memberName.toLowerCase())
+                return candidateDir;
+            } catch {
+            }
+          }
+        } catch {
+        }
+        try {
+          const remaining = readdirSync8(membersBase, { withFileTypes: true }).filter((e) => e.isDirectory() && !usedDirs.has(join21(membersBase, e.name)));
+          if (remaining.length === 1)
+            return join21(membersBase, remaining[0].name);
+        } catch {
+        }
+        return null;
+      }
       async installSkill(artDir, manifest, artifactName) {
         const skillDir = join21(homedir12(), ".markus", "skills", artifactName);
         mkdirSync17(skillDir, { recursive: true });
         for (const fname of readdirSync8(artDir)) {
           const srcFile = join21(artDir, fname);
+          const destFile = join21(skillDir, fname);
           if (statSync4(srcFile).isFile()) {
-            copyFileSync2(srcFile, join21(skillDir, fname));
+            copyFileSync2(srcFile, destFile);
+          } else if (statSync4(srcFile).isDirectory()) {
+            cpSync2(srcFile, destFile, { recursive: true });
           }
         }
         if (this.skillRegistry) {
@@ -64876,7 +64996,7 @@ var init_api_server = __esm({
               throw new Error(`Hub download failed: ${res.status}`);
             const data = await res.json();
             const name = data.name;
-            const slug = name.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+            const slug = kebab(name, "hub-pkg");
             const mode = data.itemType === "team" ? "team" : data.itemType === "skill" ? "skill" : "agent";
             const typeDir = mode === "agent" ? "agents" : mode === "team" ? "teams" : "skills";
             const artDir = join23(homedir14(), ".markus", "builder-artifacts", typeDir, slug);
@@ -65705,13 +65825,9 @@ var init_api_server = __esm({
             this.json(res, 400, { error: "name is required" });
             return;
           }
-          if (!roleName?.trim()) {
-            this.json(res, 400, { error: "roleName is required" });
-            return;
-          }
           const agent = await this.orgService.hireAgent({
             name: agentName,
-            roleName,
+            roleName: roleName?.trim() || void 0,
             orgId: body["orgId"] ?? "default",
             teamId: body["teamId"],
             skills: body["skills"],
@@ -66685,7 +66801,7 @@ var init_api_server = __esm({
                 const roleDir = this.resolveAgentRoleDir(agent);
                 if (!roleDir)
                   continue;
-                const slug = agent.config.name.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "") || agentId2;
+                const slug = kebab(agent.config.name, agentId2);
                 for (const fname of roleFileNames) {
                   const fpath = join23(roleDir, fname);
                   if (existsSync27(fpath)) {
@@ -68363,7 +68479,7 @@ EXPLANATION_END`;
               const rawMembers = Array.isArray(artifact.team?.members) ? artifact.team.members : Array.isArray(artifact.members) ? artifact.members : [];
               for (const m of rawMembers) {
                 const mName = m.name ?? "Agent";
-                const slug = mName.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "") || "agent";
+                const slug = kebab(mName, "agent");
                 const memberDir = join23(artDir, "members", slug);
                 const roleContent = m.roleContent || m.role_md;
                 const policiesContent = m.policiesContent || m.policies_md;
@@ -69168,11 +69284,18 @@ EXPLANATION_END`;
               "Content-Type": "application/json",
               "Authorization": `Bearer ${hubToken}`
             };
-            const hubRes = await fetch(`${hubUrl}/api/items`, {
+            let hubRes = await fetch(`${hubUrl}/api/items`, {
               method: "POST",
               headers,
-              body: JSON.stringify(body["payload"])
+              body: JSON.stringify(body["payload"]),
+              redirect: "manual"
             });
+            if (hubRes.status >= 300 && hubRes.status < 400) {
+              const location = hubRes.headers.get("location");
+              if (location) {
+                hubRes = await fetch(location, { method: "POST", headers, body: JSON.stringify(body["payload"]), redirect: "manual" });
+              }
+            }
             const hubData = await hubRes.json();
             this.json(res, hubRes.status, hubData);
           } catch (err) {
@@ -69180,6 +69303,43 @@ EXPLANATION_END`;
           }
           return;
         }
+        if (path.startsWith("/api/hub/")) {
+          const hubPath = path.slice("/api/hub".length);
+          const reqUrl = new URL(req.url, `http://${req.headers.host}`);
+          const hubTargetUrl = `${this.hubUrl}/api${hubPath}${reqUrl.search}`;
+          const proxyHeaders = { "Content-Type": "application/json" };
+          const authHeader = req.headers["authorization"];
+          if (authHeader)
+            proxyHeaders["Authorization"] = authHeader;
+          try {
+            let body;
+            if (req.method === "POST" || req.method === "PUT" || req.method === "PATCH") {
+              body = JSON.stringify(await this.readBody(req));
+            }
+            let hubRes = await fetch(hubTargetUrl, {
+              method: req.method,
+              headers: proxyHeaders,
+              body,
+              redirect: "manual"
+            });
+            if (hubRes.status >= 300 && hubRes.status < 400) {
+              const location = hubRes.headers.get("location");
+              if (location) {
+                hubRes = await fetch(location, {
+                  method: req.method,
+                  headers: proxyHeaders,
+                  body,
+                  redirect: "manual"
+                });
+              }
+            }
+            const data = await hubRes.json();
+            this.json(res, hubRes.status, data);
+          } catch (err) {
+            this.json(res, 502, { error: `Hub request failed: ${String(err)}` });
+          }
+          return;
+        }
         if (path === "/api/settings/hub" && req.method === "GET") {
           this.json(res, 200, { hubUrl: this.hubUrl });
           return;
@@ -77725,7 +77885,7 @@ var init_startupProgress = __esm({
 
 // src/connector-service.ts
 import { resolve as resolve15, join as join28, dirname as dirname8 } from "node:path";
-import { existsSync as existsSync31, readFileSync as readFileSync23, writeFileSync as writeFileSync18, mkdirSync as mkdirSync24, readdirSync as readdirSync12, cpSync as cpSync2 } from "node:fs";
+import { existsSync as existsSync31, readFileSync as readFileSync23, writeFileSync as writeFileSync18, mkdirSync as mkdirSync24, readdirSync as readdirSync12, cpSync as cpSync3 } from "node:fs";
 import { homedir as homedir18 } from "node:os";
 import { execSync as execSync4 } from "node:child_process";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
@@ -77856,7 +78016,7 @@ function installSkillTemplate(connector) {
     mkdirSync24(targetDir, { recursive: true });
   }
   try {
-    cpSync2(sourceDir, targetDir, { recursive: true });
+    cpSync3(sourceDir, targetDir, { recursive: true });
     return true;
   } catch {
     return false;
@@ -77906,7 +78066,7 @@ __export(init_exports, {
   registerInitCommand: () => registerInitCommand
 });
 import { resolve as resolve16 } from "node:path";
-import { readFileSync as readFileSync24, existsSync as existsSync32, cpSync as cpSync3 } from "node:fs";
+import { readFileSync as readFileSync24, existsSync as existsSync32, cpSync as cpSync4 } from "node:fs";
 import { homedir as homedir19 } from "node:os";
 function registerInitCommand(program2) {
   program2.command("init").description("Setup wizard: configure LLM provider, API keys, and server settings").option("--force", "Overwrite existing configuration").option("--non-interactive", "Run without prompts (use env vars or --import-from)").option("--provider <name>", "LLM provider (anthropic/openai/google/minimax/siliconflow/zai/ollama)").option("--api-key <key>", "LLM API key").option("--port <port>", "API server port", "8056").option("--import-from <platform>", "Import LLM config from an installed agent platform (e.g. openclaw, hermes)").option("--auto-connect", "Auto-connect detected agent platforms after init").action(async (opts) => {
@@ -78195,7 +78355,7 @@ async function quickInit(options) {
   if (builtinTemplatesDir && existsSync32(builtinTemplatesDir) && !existsSync32(userTemplatesDir)) {
     const builtinRoot = resolve16(builtinTemplatesDir, "..");
     mkdirSync26(userTemplatesDir, { recursive: true });
-    cpSync3(builtinRoot, userTemplatesDir, { recursive: true });
+    cpSync4(builtinRoot, userTemplatesDir, { recursive: true });
     console.log(`  Copied templates to ${userTemplatesDir}`);
   }
   const devRoleDir = pathJoin(userTemplatesDir || pathJoin(process.cwd(), "templates"), "roles", "developer");