@botcord/daemon 0.2.28 → 0.2.29

package/dist/agent-workspace.d.ts

@@ -54,6 +54,14 @@ export declare function ensureAgentHermesWorkspace(agentId: string, opts?: {
     hermesHome: string;
     hermesWorkspace: string;
 };
+/**
+ * Seed BotCord's bundled Hermes skills into a user-owned Hermes profile used
+ * by attach mode. Unlike `ensureAgentHermesWorkspace({ attached: true })`,
+ * this intentionally writes only the managed `botcord*` skill directories
+ * under the profile's `skills/` directory; it does not touch `.env`,
+ * `config.yaml`, sessions, or any user-authored skills.
+ */
+export declare function ensureAttachedHermesProfileSkills(profileHome: string): void;
 /**
  * Idempotently create the agent's home / workspace / state directories and
  * seed the workspace Markdown files. Existing files are never overwritten —

package/dist/agent-workspace.js

@@ -334,8 +334,8 @@ export function ensureAgentHermesWorkspace(agentId, opts = {}) {
     // Attach mode: HERMES_HOME points at the user's `~/.hermes/profiles/<n>/`
     // so we MUST NOT touch the per-agent isolated home. The cwd
     // (`hermesWorkspace`) is still ours and `prepareTurn` writes AGENTS.md
-    // there — that's the only thing the daemon is allowed to author when
-    // attached to a user-owned profile.
+    // there. Profile-owned skill seeding is handled separately by
+    // `ensureAttachedHermesProfileSkills`.
     if (opts.attached) {
         return { hermesHome, hermesWorkspace };
     }
@@ -420,6 +420,16 @@ function seedCodexSkills(codexHome) {
 function seedHermesAgentSkills(hermesHome) {
     copyBundledSkills(path.join(hermesHome, "skills"));
 }
+/**
+ * Seed BotCord's bundled Hermes skills into a user-owned Hermes profile used
+ * by attach mode. Unlike `ensureAgentHermesWorkspace({ attached: true })`,
+ * this intentionally writes only the managed `botcord*` skill directories
+ * under the profile's `skills/` directory; it does not touch `.env`,
+ * `config.yaml`, sessions, or any user-authored skills.
+ */
+export function ensureAttachedHermesProfileSkills(profileHome) {
+    seedHermesAgentSkills(profileHome);
+}
 /**
  * Idempotently create the agent's home / workspace / state directories and
  * seed the workspace Markdown files. Existing files are never overwritten —

package/dist/gateway/runtimes/hermes-agent.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import path from "node:path";
-import { agentHermesHomeDir, agentHermesWorkspaceDir, ensureAgentHermesWorkspace, } from "../../agent-workspace.js";
+import { agentHermesHomeDir, agentHermesWorkspaceDir, ensureAttachedHermesProfileSkills, ensureAgentHermesWorkspace, } from "../../agent-workspace.js";
 import { buildCliEnv } from "../cli-resolver.js";
 import { AcpRuntimeAdapter, } from "./acp-stream.js";
 import { firstExistingPath, readCommandVersion, resolveCommandOnPath, resolveHomePath, } from "./probe.js";
@@ -234,9 +234,10 @@ export class HermesAgentAdapter extends AcpRuntimeAdapter {
         };
         // Attach mode: BotCord agent shares a hermes profile (state.db /
         // sessions / skills / .env) with the user's command-line `hermes`. In
-        // this mode we DO NOT seed a private home — the profile is wholly owned
-        // by the user, and AGENTS.md is written under the per-agent
-        // hermes-workspace cwd (NOT into the profile root) by `prepareTurn`.
+        // this mode we DO NOT seed a private home — AGENTS.md is written under
+        // the per-agent hermes-workspace cwd (NOT into the profile root) by
+        // `prepareTurn`, while bundled BotCord skills are installed into the
+        // attached profile's `skills/` directory so hermes can discover them.
         if (opts.hermesProfile) {
             env.HERMES_HOME = hermesProfileHomeDir(opts.hermesProfile);
         }
@@ -262,6 +263,9 @@ export class HermesAgentAdapter extends AcpRuntimeAdapter {
         const { hermesWorkspace } = ensureAgentHermesWorkspace(opts.accountId, {
             attached: !!opts.hermesProfile,
         });
+        if (opts.hermesProfile) {
+            ensureAttachedHermesProfileSkills(hermesProfileHomeDir(opts.hermesProfile));
+        }
         const target = path.join(hermesWorkspace, "AGENTS.md");
         const tmp = path.join(hermesWorkspace, `.AGENTS.md.${process.pid}.tmp`);
         mkdirSync(hermesWorkspace, { recursive: true, mode: 0o700 });

package/dist/provision.js

@@ -10,7 +10,7 @@ import path from "node:path";
 import { BotCordClient, CONTROL_FRAME_TYPES, defaultCredentialsFile, derivePublicKey, loadStoredCredentials, writeCredentialsFile, } from "@botcord/protocol-core";
 import { loadConfig, resolveConfiguredAgentIds, saveConfig, } from "./config.js";
 import { BOTCORD_CHANNEL_TYPE, buildManagedRoutes, prepareGatewayProfile, } from "./daemon-config-map.js";
-import { agentHomeDir, agentStateDir, agentWorkspaceDir, applyAgentIdentity, ensureAgentWorkspace, } from "./agent-workspace.js";
+import { agentHomeDir, agentStateDir, agentWorkspaceDir, applyAgentIdentity, ensureAttachedHermesProfileSkills, ensureAgentWorkspace, } from "./agent-workspace.js";
 import { detectRuntimes, getAdapterModule } from "./adapters/runtimes.js";
 import { hermesProfileHomeDir, isValidHermesProfileName, listHermesProfiles, } from "./gateway/runtimes/hermes-agent.js";
 import { log as daemonLog } from "./log.js";
@@ -285,6 +285,9 @@ async function installLocalAgent(credentials, ctx) {
             keyId: credentials.keyId,
             savedAt: credentials.savedAt,
         });
+        if (credentials.runtime === "hermes-agent" && credentials.hermesProfile) {
+            ensureAttachedHermesProfileSkills(hermesProfileHomeDir(credentials.hermesProfile));
+        }
     }
     catch (err) {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botcord/daemon",
-  "version": "0.2.28",
+  "version": "0.2.29",
   "description": "BotCord local daemon — bridges Hub inbox push to local Claude Code / Codex / Gemini CLIs",
   "type": "module",
   "bin": {

package/src/__tests__/agent-workspace.test.ts

@@ -18,6 +18,7 @@ import {
   agentStateDir,
   agentWorkspaceDir,
   applyAgentIdentity,
+  ensureAttachedHermesProfileSkills,
   ensureAgentCodexHome,
   ensureAgentHermesWorkspace,
   ensureAgentWorkspace,
@@ -150,6 +151,23 @@ describe("ensureAgentWorkspace", () => {
     expect(reseeded).toContain("name: botcord");
   });
 
+  it("seeds bundled skills into an attached Hermes profile without creating private home state", () => {
+    const profileHome = path.join(tmpHome, ".hermes", "profiles", "coder");
+    mkdirSync(profileHome, { recursive: true });
+
+    const { hermesHome, hermesWorkspace } = ensureAgentHermesWorkspace("ag_hermes_attach", {
+      attached: true,
+    });
+    ensureAttachedHermesProfileSkills(profileHome);
+
+    expect(existsSync(path.join(profileHome, "skills", "botcord", "SKILL.md"))).toBe(true);
+    expect(existsSync(path.join(profileHome, "skills", "botcord-user-guide", "SKILL.md"))).toBe(
+      true,
+    );
+    expect(existsSync(hermesWorkspace)).toBe(true);
+    expect(existsSync(hermesHome)).toBe(false);
+  });
+
   it("does not overwrite a user-modified memory.md on a second call", () => {
     ensureAgentWorkspace("ag_keep", {});
     const memoryPath = path.join(agentWorkspaceDir("ag_keep"), "memory.md");

package/src/__tests__/provision.test.ts

@@ -1527,6 +1527,11 @@ describe("provision_agent hermes profile attach", () => {
       >;
       expect(saved.hermesProfile).toBe("coder");
       expect(saved.runtime).toBe("hermes-agent");
+      expect(
+        fs.existsSync(
+          nodePath.join(tmp, ".hermes", "profiles", "coder", "skills", "botcord", "SKILL.md"),
+        ),
+      ).toBe(true);
     });
   });
 

package/src/agent-workspace.ts

@@ -370,8 +370,8 @@ export function ensureAgentHermesWorkspace(
   // Attach mode: HERMES_HOME points at the user's `~/.hermes/profiles/<n>/`
   // so we MUST NOT touch the per-agent isolated home. The cwd
   // (`hermesWorkspace`) is still ours and `prepareTurn` writes AGENTS.md
-  // there — that's the only thing the daemon is allowed to author when
-  // attached to a user-owned profile.
+  // there. Profile-owned skill seeding is handled separately by
+  // `ensureAttachedHermesProfileSkills`.
   if (opts.attached) {
     return { hermesHome, hermesWorkspace };
   }
@@ -462,6 +462,17 @@ function seedHermesAgentSkills(hermesHome: string): void {
   copyBundledSkills(path.join(hermesHome, "skills"));
 }
 
+/**
+ * Seed BotCord's bundled Hermes skills into a user-owned Hermes profile used
+ * by attach mode. Unlike `ensureAgentHermesWorkspace({ attached: true })`,
+ * this intentionally writes only the managed `botcord*` skill directories
+ * under the profile's `skills/` directory; it does not touch `.env`,
+ * `config.yaml`, sessions, or any user-authored skills.
+ */
+export function ensureAttachedHermesProfileSkills(profileHome: string): void {
+  seedHermesAgentSkills(profileHome);
+}
+
 /**
  * Idempotently create the agent's home / workspace / state directories and
  * seed the workspace Markdown files. Existing files are never overwritten —

package/src/gateway/runtimes/hermes-agent.ts

@@ -4,6 +4,7 @@ import path from "node:path";
 import {
   agentHermesHomeDir,
   agentHermesWorkspaceDir,
+  ensureAttachedHermesProfileSkills,
   ensureAgentHermesWorkspace,
 } from "../../agent-workspace.js";
 import { buildCliEnv } from "../cli-resolver.js";
@@ -277,9 +278,10 @@ export class HermesAgentAdapter extends AcpRuntimeAdapter {
     };
     // Attach mode: BotCord agent shares a hermes profile (state.db /
     // sessions / skills / .env) with the user's command-line `hermes`. In
-    // this mode we DO NOT seed a private home — the profile is wholly owned
-    // by the user, and AGENTS.md is written under the per-agent
-    // hermes-workspace cwd (NOT into the profile root) by `prepareTurn`.
+    // this mode we DO NOT seed a private home — AGENTS.md is written under
+    // the per-agent hermes-workspace cwd (NOT into the profile root) by
+    // `prepareTurn`, while bundled BotCord skills are installed into the
+    // attached profile's `skills/` directory so hermes can discover them.
     if (opts.hermesProfile) {
       env.HERMES_HOME = hermesProfileHomeDir(opts.hermesProfile);
     } else if (opts.accountId) {
@@ -304,6 +306,9 @@ export class HermesAgentAdapter extends AcpRuntimeAdapter {
     const { hermesWorkspace } = ensureAgentHermesWorkspace(opts.accountId, {
       attached: !!opts.hermesProfile,
     });
+    if (opts.hermesProfile) {
+      ensureAttachedHermesProfileSkills(hermesProfileHomeDir(opts.hermesProfile));
+    }
     const target = path.join(hermesWorkspace, "AGENTS.md");
     const tmp = path.join(hermesWorkspace, `.AGENTS.md.${process.pid}.tmp`);
     mkdirSync(hermesWorkspace, { recursive: true, mode: 0o700 });

package/src/provision.ts

@@ -52,6 +52,7 @@ import {
   agentStateDir,
   agentWorkspaceDir,
   applyAgentIdentity,
+  ensureAttachedHermesProfileSkills,
   ensureAgentWorkspace,
 } from "./agent-workspace.js";
 import { detectRuntimes, getAdapterModule } from "./adapters/runtimes.js";
@@ -431,6 +432,9 @@ async function installLocalAgent(
       keyId: credentials.keyId,
       savedAt: credentials.savedAt,
     });
+    if (credentials.runtime === "hermes-agent" && credentials.hermesProfile) {
+      ensureAttachedHermesProfileSkills(hermesProfileHomeDir(credentials.hermesProfile));
+    }
   } catch (err) {
     try {
       unlinkSync(credentialsFile);