volute 0.11.4 → 0.13.0

package/dist/{agent-2AQPI3QV.js → agent-HYX2ZTFM.js}

@@ -6,42 +6,42 @@ async function run(args) {
   const subcommand = args[0];
   switch (subcommand) {
     case "create":
-      await import("./create-VBZZNJOG.js").then((m) => m.run(args.slice(1)));
+      await import("./create-AAI52BC2.js").then((m) => m.run(args.slice(1)));
       break;
     case "start":
-      await import("./start-6YRS6FF6.js").then((m) => m.run(args.slice(1)));
+      await import("./start-54JXJ7VV.js").then((m) => m.run(args.slice(1)));
       break;
     case "stop":
-      await import("./stop-UQSNF4CG.js").then((m) => m.run(args.slice(1)));
+      await import("./stop-WXU42NWP.js").then((m) => m.run(args.slice(1)));
       break;
     case "restart":
-      await import("./restart-CCYM3MEC.js").then((m) => m.run(args.slice(1)));
+      await import("./restart-CMP63H6A.js").then((m) => m.run(args.slice(1)));
       break;
     case "delete":
-      await import("./delete-BOTVU4YO.js").then((m) => m.run(args.slice(1)));
+      await import("./delete-BJ3LNU2I.js").then((m) => m.run(args.slice(1)));
       break;
     case "list":
-      await import("./status-DFWM342I.js").then((m) => m.run(args.slice(1)));
+      await import("./status-PMMS4XUH.js").then((m) => m.run(args.slice(1)));
       break;
     case "status": {
       const rest = args.slice(1);
       if (!rest[0] && process.env.VOLUTE_AGENT) {
         rest.unshift(process.env.VOLUTE_AGENT);
       }
-      await import("./status-DFWM342I.js").then((m) => m.run(rest));
+      await import("./status-PMMS4XUH.js").then((m) => m.run(rest));
       break;
     }
     case "logs": {
       const rest = args.slice(1);
       const logsArgs = transformAgentFlag(rest);
-      await import("./logs-APWVWGNX.js").then((m) => m.run(logsArgs));
+      await import("./logs-KHBOS6IZ.js").then((m) => m.run(logsArgs));
       break;
     }
     case "upgrade":
-      await import("./upgrade-RSE4CZNE.js").then((m) => m.run(args.slice(1)));
+      await import("./upgrade-TEI7N6CQ.js").then((m) => m.run(args.slice(1)));
       break;
     case "import":
-      await import("./import-2BZUWT23.js").then((m) => m.run(args.slice(1)));
+      await import("./import-TKF67X4R.js").then((m) => m.run(args.slice(1)));
       break;
     case "--help":
     case "-h":

package/dist/{agent-manager-AZUDAKCP.js → agent-manager-HHBAAL2D.js}

@@ -3,10 +3,10 @@ import {
   AgentManager,
   getAgentManager,
   initAgentManager
-} from "./chunk-YTOPX4PB.js";
-import "./chunk-46S7YHUB.js";
-import "./chunk-QF22MYDJ.js";
-import "./chunk-DP2DX4WV.js";
+} from "./chunk-NQKKTRET.js";
+import "./chunk-BJDLYTPS.js";
+import "./chunk-EN3NHRQC.js";
+import "./chunk-ESTOWEG2.js";
 import "./chunk-K3NQKI34.js";
 export {
   AgentManager,

package/dist/{channel-2WHBRDTD.js → channel-72YET5JC.js}

@@ -7,8 +7,8 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-STOEJOJO.js";
-import "./chunk-DP2DX4WV.js";
+} from "./chunk-J3IHIXDB.js";
+import "./chunk-ESTOWEG2.js";
 import {
   getClient,
   urlOf

package/dist/{chunk-QF22MYDJ.js → chunk-BJDLYTPS.js}

@@ -2,7 +2,7 @@
 import {
   stateDir,
   voluteHome
-} from "./chunk-DP2DX4WV.js";
+} from "./chunk-ESTOWEG2.js";
 
 // src/lib/env.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";

package/dist/{chunk-46S7YHUB.js → chunk-EN3NHRQC.js}

@@ -1,12 +1,10 @@
 #!/usr/bin/env node
 import {
   validateAgentName
-} from "./chunk-DP2DX4WV.js";
+} from "./chunk-ESTOWEG2.js";
 
 // src/lib/isolation.ts
-import { execFile, execFileSync } from "child_process";
-import { promisify } from "util";
-var execFileAsync = promisify(execFile);
+import { execFileSync } from "child_process";
 function isIsolationEnabled() {
   return process.env.VOLUTE_ISOLATION === "user";
 }
@@ -29,7 +27,7 @@ function ensureVoluteGroup(opts) {
     }
   }
 }
-function createAgentUser(name) {
+function createAgentUser(name, homeDir) {
   if (!isIsolationEnabled()) return;
   const user = agentUserName(name);
   try {
@@ -38,7 +36,10 @@ function createAgentUser(name) {
   } catch {
   }
   try {
-    execFileSync("useradd", ["-r", "-M", "-G", "volute", "-s", "/usr/sbin/nologin", user], {
+    const args = ["-r", "-M", "-G", "volute", "-s", "/usr/sbin/nologin"];
+    if (homeDir) args.push("-d", homeDir);
+    args.push(user);
+    execFileSync("useradd", args, {
       stdio: ["ignore", "ignore", "pipe"]
     });
   } catch (err) {
@@ -54,18 +55,11 @@ function deleteAgentUser(name) {
   } catch {
   }
 }
-async function getAgentUserIds(name) {
-  const user = agentUserName(name);
-  const { stdout: uidStr } = await execFileAsync("id", ["-u", user]);
-  const { stdout: gidStr } = await execFileAsync("id", ["-g", user]);
-  return { uid: parseInt(uidStr.trim(), 10), gid: parseInt(gidStr.trim(), 10) };
-}
-async function applyIsolation(spawnOpts, agentName) {
-  if (!isIsolationEnabled()) return;
+function wrapForIsolation(cmd, args, agentName) {
+  if (!isIsolationEnabled()) return [cmd, args];
   const baseName = agentName.split("@", 2)[0];
-  const { uid, gid } = await getAgentUserIds(baseName);
-  spawnOpts.uid = uid;
-  spawnOpts.gid = gid;
+  const user = agentUserName(baseName);
+  return ["runuser", ["-u", user, "--", cmd, ...args]];
 }
 function chownAgentDir(dir, name) {
   if (!isIsolationEnabled()) return;
@@ -89,7 +83,6 @@ export {
   ensureVoluteGroup,
   createAgentUser,
   deleteAgentUser,
-  getAgentUserIds,
-  applyIsolation,
+  wrapForIsolation,
   chownAgentDir
 };

package/dist/{chunk-DP2DX4WV.js → chunk-ESTOWEG2.js}

@@ -28,7 +28,7 @@ function readRegistry() {
   if (!existsSync(registryPath)) return [];
   try {
     const entries = JSON.parse(readFileSync(registryPath, "utf-8"));
-    return entries.map((e) => ({ ...e, running: e.running ?? false }));
+    return entries.map((e) => ({ ...e, running: e.running ?? false, stage: e.stage ?? "mind" }));
   } catch {
     return [];
   }
@@ -52,12 +52,12 @@ function validateAgentName(name) {
   }
   return null;
 }
-function addAgent(name, port) {
+function addAgent(name, port, stage) {
   const err = validateAgentName(name);
   if (err) throw new Error(err);
   const entries = readRegistry();
   const filtered = entries.filter((e) => e.name !== name);
-  filtered.push({ name, port, created: (/* @__PURE__ */ new Date()).toISOString(), running: false });
+  filtered.push({ name, port, created: (/* @__PURE__ */ new Date()).toISOString(), running: false, stage });
   writeRegistry(filtered);
 }
 function removeAgent(name) {
@@ -72,6 +72,14 @@ function setAgentRunning(name, running) {
     writeRegistry(entries);
   }
 }
+function setAgentStage(name, stage) {
+  const entries = readRegistry();
+  const entry = entries.find((e) => e.name === name);
+  if (entry) {
+    entry.stage = stage;
+    writeRegistry(entries);
+  }
+}
 function findAgent(name) {
   return readRegistry().find((e) => e.name === name);
 }
@@ -237,6 +245,7 @@ export {
   addAgent,
   removeAgent,
   setAgentRunning,
+  setAgentStage,
   findAgent,
   agentDir,
   stateDir,

package/dist/{chunk-N6MLQ26B.js → chunk-GPZCPGV3.js}

@@ -1,12 +1,21 @@
 #!/usr/bin/env node
 import {
   stateDir
-} from "./chunk-DP2DX4WV.js";
+} from "./chunk-ESTOWEG2.js";
 
 // src/lib/slugify.ts
 function slugify(text) {
   return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
 }
+function buildVoluteSlug(opts) {
+  const isDM = opts.participants.length === 2;
+  if (isDM) {
+    const other = opts.participants.find((p) => p.username !== opts.agentUsername);
+    const otherSlug = other ? slugify(other.username) : "";
+    return otherSlug ? `volute:@${otherSlug}` : `volute:${opts.conversationId}`;
+  }
+  return opts.convTitle ? `volute:${slugify(opts.convTitle)}` : `volute:${opts.conversationId}`;
+}
 
 // src/connectors/sdk.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -148,6 +157,7 @@ function resolveChannelId(agentName, slug) {
 
 export {
   slugify,
+  buildVoluteSlug,
   loadEnv,
   loadFollowedChannels,
   splitMessage,

package/dist/{chunk-ZKNBD5P3.js → chunk-IELXXS7E.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   execInherit
-} from "./chunk-WTJI3JVR.js";
+} from "./chunk-VRAOTXDF.js";
 import {
   voluteHome
-} from "./chunk-DP2DX4WV.js";
+} from "./chunk-ESTOWEG2.js";
 
 // src/lib/service-mode.ts
 import { execFileSync } from "child_process";

package/dist/{chunk-STOEJOJO.js → chunk-J3IHIXDB.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   voluteHome
-} from "./chunk-DP2DX4WV.js";
+} from "./chunk-ESTOWEG2.js";
 
 // src/lib/daemon-client.ts
 import { existsSync, readFileSync } from "fs";

package/dist/{chunk-R3VB7NF5.js → chunk-KYHC7LHS.js}

@@ -3,7 +3,7 @@ import {
   agentEnvPath,
   readEnv,
   writeEnv
-} from "./chunk-QF22MYDJ.js";
+} from "./chunk-BJDLYTPS.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
@@ -43,7 +43,7 @@ async function run(args) {
     template: { type: "string" }
   });
   const wsDir = resolveWorkspace(positional[0]);
-  const { daemonFetch } = await import("./daemon-client-P44NU3KU.js");
+  const { daemonFetch } = await import("./daemon-client-WXN43USO.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   const res = await daemonFetch(urlOf(client.api.agents.import.$url()), {

package/dist/{chunk-YY2QX2J6.js → chunk-LG4ROCHN.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   voluteHome
-} from "./chunk-DP2DX4WV.js";
+} from "./chunk-ESTOWEG2.js";
 
 // src/lib/update-check.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";

package/dist/{chunk-YTOPX4PB.js → chunk-NQKKTRET.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import {
-  applyIsolation,
-  chownAgentDir,
-  isIsolationEnabled
-} from "./chunk-46S7YHUB.js";
 import {
   loadMergedEnv
-} from "./chunk-QF22MYDJ.js";
+} from "./chunk-BJDLYTPS.js";
+import {
+  chownAgentDir,
+  isIsolationEnabled,
+  wrapForIsolation
+} from "./chunk-EN3NHRQC.js";
 import {
   agentDir,
   findAgent,
@@ -15,11 +15,11 @@ import {
   setVariantRunning,
   stateDir,
   voluteHome
-} from "./chunk-DP2DX4WV.js";
+} from "./chunk-ESTOWEG2.js";
 
 // src/lib/agent-manager.ts
 import { execFile, spawn } from "child_process";
-import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
+import { chmodSync, existsSync as existsSync3, mkdirSync, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
 import { resolve } from "path";
 import { promisify } from "util";
 
@@ -188,7 +188,13 @@ var AgentManager = class {
     const logsDir = resolve(agentStateDir, "logs");
     mkdirSync(logsDir, { recursive: true });
     if (isIsolationEnabled()) {
-      chownAgentDir(agentStateDir, baseName);
+      try {
+        chownAgentDir(agentStateDir, baseName);
+      } catch (err) {
+        throw new Error(
+          `Cannot start agent ${name}: failed to set ownership on state directory ${agentStateDir}: ${err instanceof Error ? err.message : err}`
+        );
+      }
     }
     const logStream = new RotatingLog(resolve(logsDir, "agent.log"));
     const agentEnv = loadMergedEnv(name);
@@ -200,43 +206,24 @@ var AgentManager = class {
       VOLUTE_AGENT_DIR: dir,
       VOLUTE_AGENT_PORT: String(port)
     };
-    if (isIsolationEnabled() && process.env.CLAUDE_CONFIG_DIR) {
-      const agentClaudeDir = resolve(dir, ".claude");
-      try {
-        mkdirSync(agentClaudeDir, { recursive: true });
-      } catch (err) {
-        throw new Error(
-          `Cannot start agent ${name}: failed to create config directory at ${agentClaudeDir}: ${err instanceof Error ? err.message : err}`
-        );
-      }
-      const sharedCreds = resolve(process.env.CLAUDE_CONFIG_DIR, ".credentials.json");
-      const agentCreds = resolve(agentClaudeDir, ".credentials.json");
-      if (existsSync3(sharedCreds)) {
-        try {
-          writeFileSync2(agentCreds, readFileSync2(sharedCreds));
-        } catch (err) {
-          throw new Error(
-            `Cannot start agent ${name}: failed to copy credentials to ${agentClaudeDir}: ${err instanceof Error ? err.message : err}`
-          );
-        }
-      } else {
-        console.warn(
-          `[daemon] shared credentials not found at ${sharedCreds} for agent ${name}. Copy ~/.claude/.credentials.json to ${process.env.CLAUDE_CONFIG_DIR}/.credentials.json or set ANTHROPIC_API_KEY in the agent's environment.`
-        );
+    if (isIsolationEnabled()) {
+      env.HOME = resolve(dir, "home");
+      if (process.env.CLAUDE_CONFIG_DIR) {
+        const projectsDir = resolve(process.env.CLAUDE_CONFIG_DIR, "projects");
+        mkdirSync(projectsDir, { recursive: true });
+        chmodSync(projectsDir, 1528);
       }
-      const baseName2 = name.split("@", 2)[0];
-      chownAgentDir(agentClaudeDir, baseName2);
-      env.CLAUDE_CONFIG_DIR = agentClaudeDir;
     }
     const tsxBin = resolve(dir, "node_modules", ".bin", "tsx");
+    const tsxArgs = ["src/server.ts", "--port", String(port)];
+    const [spawnCmd, spawnArgs] = wrapForIsolation(tsxBin, tsxArgs, name);
     const spawnOpts = {
       cwd: dir,
       stdio: ["ignore", "pipe", "pipe"],
       detached: true,
       env
     };
-    await applyIsolation(spawnOpts, name);
-    const child = spawn(tsxBin, ["src/server.ts", "--port", String(port)], spawnOpts);
+    const child = spawn(spawnCmd, spawnArgs, spawnOpts);
     this.agents.set(name, { child, port });
     child.stdout?.pipe(logStream);
     child.stderr?.pipe(logStream);
@@ -299,6 +286,10 @@ var AgentManager = class {
     const parts = [];
     if (context.type === "merge" || context.type === "merged") {
       parts.push(`[system] Variant "${context.name}" has been merged and you have been restarted.`);
+    } else if (context.type === "sprouted") {
+      parts.push(
+        "[system] You've sprouted. You now have full agent capabilities \u2014 connectors, schedules, variants, and the complete volute CLI. Check your new skills for details."
+      );
     } else {
       parts.push("[system] You have been restarted.");
     }

package/dist/{chunk-D5EVQTGJ.js → chunk-PEQQ7MRI.js}

@@ -4,13 +4,13 @@ import {
   modeLabel,
   pollHealth,
   startService
-} from "./chunk-ZKNBD5P3.js";
+} from "./chunk-IELXXS7E.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   voluteHome
-} from "./chunk-DP2DX4WV.js";
+} from "./chunk-ESTOWEG2.js";
 
 // src/commands/up.ts
 import { spawn } from "child_process";

package/dist/{chunk-LIPPXNIE.js → chunk-PTK3GBCG.js}

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 import {
+  buildVoluteSlug,
   resolveChannelId,
   slugify,
   splitMessage,
   writeChannelEntry
-} from "./chunk-N6MLQ26B.js";
+} from "./chunk-GPZCPGV3.js";
 import {
   voluteHome
-} from "./chunk-DP2DX4WV.js";
+} from "./chunk-ESTOWEG2.js";
 import {
   __export
 } from "./chunk-K3NQKI34.js";
@@ -452,26 +453,33 @@ async function listConversations4(env) {
   const convs = await res.json();
   const results = [];
   for (const conv of convs) {
-    let participantCount;
+    let participants = [];
     try {
       const pRes = await fetch(
         `${url}/api/agents/${encodeURIComponent(agentName)}/conversations/${encodeURIComponent(conv.id)}/participants`,
         { headers }
       );
       if (pRes.ok) {
-        const participants = await pRes.json();
-        participantCount = participants.length;
+        participants = await pRes.json();
+      } else {
+        console.error(`[volute] failed to fetch participants for ${conv.id}: HTTP ${pRes.status}`);
       }
     } catch (err) {
       console.error(`[volute] failed to fetch participants for ${conv.id}:`, err);
     }
-    const slug = conv.title ? `volute:${slugify(conv.title)}` : `volute:${conv.id}`;
+    const isDM = participants.length === 2;
+    const slug = buildVoluteSlug({
+      participants,
+      agentUsername: agentName,
+      convTitle: conv.title,
+      conversationId: conv.id
+    });
     results.push({
       id: slug,
       platformId: conv.id,
       name: conv.title ?? "(untitled)",
-      type: participantCount === 2 ? "dm" : "group",
-      participantCount
+      type: isDM ? "dm" : "group",
+      participantCount: participants.length
     });
   }
   return results;
@@ -510,16 +518,7 @@ async function createConversation4(env, participants, name) {
     throw new Error(data.error ?? `Failed to create conversation: ${res.status}`);
   }
   const conv = await res.json();
-  const slug = name ? `volute:${slugify(name)}` : `volute:${conv.id}`;
-  if (agentName) {
-    writeChannelEntry(agentName, slug, {
-      platformId: conv.id,
-      platform: "volute",
-      name: name ?? participants.join(", "),
-      type: participants.length <= 1 ? "dm" : "group"
-    });
-  }
-  return slug;
+  return `volute:${conv.id}`;
 }
 
 // src/lib/channels.ts

package/dist/{chunk-RGWADNLT.js → chunk-RH3XLDY2.js}

@@ -5,10 +5,10 @@ import {
   pollHealthDown,
   readDaemonConfig,
   stopService
-} from "./chunk-ZKNBD5P3.js";
+} from "./chunk-IELXXS7E.js";
 import {
   voluteHome
-} from "./chunk-DP2DX4WV.js";
+} from "./chunk-ESTOWEG2.js";
 
 // src/commands/down.ts
 import { existsSync, readFileSync, unlinkSync } from "fs";

package/dist/{chunk-WTJI3JVR.js → chunk-VRAOTXDF.js}

@@ -1,13 +1,17 @@
 #!/usr/bin/env node
+import {
+  wrapForIsolation
+} from "./chunk-EN3NHRQC.js";
 
 // src/lib/exec.ts
 import { execFile as execFileCb, execFileSync, spawn } from "child_process";
 function exec(cmd, args, options) {
+  const [wrappedCmd, wrappedArgs] = options?.agentName ? wrapForIsolation(cmd, args, options.agentName) : [cmd, args];
   return new Promise((resolve, reject) => {
     execFileCb(
-      cmd,
-      args,
-      { cwd: options?.cwd, uid: options?.uid, gid: options?.gid, env: options?.env },
+      wrappedCmd,
+      wrappedArgs,
+      { cwd: options?.cwd, env: options?.env },
       (err, stdout, stderr) => {
         if (err) {
           err.stderr = stderr;
@@ -31,11 +35,10 @@ function resolveVoluteBin() {
   }
 }
 function execInherit(cmd, args, options) {
+  const [wrappedCmd, wrappedArgs] = options?.agentName ? wrapForIsolation(cmd, args, options.agentName) : [cmd, args];
   return new Promise((resolve, reject) => {
-    const child = spawn(cmd, args, {
+    const child = spawn(wrappedCmd, wrappedArgs, {
       cwd: options?.cwd,
-      uid: options?.uid,
-      gid: options?.gid,
       env: options?.env,
       stdio: "inherit"
     });

package/dist/chunk-XUA3JUFK.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+
+// src/lib/template.ts
+import {
+  cpSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  renameSync,
+  rmSync,
+  statSync,
+  writeFileSync
+} from "fs";
+import { tmpdir } from "os";
+import { dirname, join, relative, resolve } from "path";
+function findTemplatesRoot() {
+  let dir = dirname(new URL(import.meta.url).pathname);
+  for (let i = 0; i < 5; i++) {
+    const candidate = resolve(dir, "templates");
+    if (existsSync(resolve(candidate, "_base"))) return candidate;
+    dir = dirname(dir);
+  }
+  console.error(
+    "Templates directory not found. Searched up from:",
+    dirname(new URL(import.meta.url).pathname)
+  );
+  process.exit(1);
+}
+function composeTemplate(templatesRoot, templateName) {
+  const baseDir = resolve(templatesRoot, "_base");
+  const templateDir = resolve(templatesRoot, templateName);
+  if (!existsSync(baseDir)) {
+    console.error("Base template not found:", baseDir);
+    process.exit(1);
+  }
+  if (!existsSync(templateDir)) {
+    console.error(`Template not found: ${templateName}`);
+    process.exit(1);
+  }
+  const composedDir = resolve(tmpdir(), `volute-template-${Date.now()}`);
+  mkdirSync(composedDir, { recursive: true });
+  cpSync(baseDir, composedDir, { recursive: true });
+  for (const file of listFiles(templateDir)) {
+    const src = resolve(templateDir, file);
+    const dest = resolve(composedDir, file);
+    mkdirSync(dirname(dest), { recursive: true });
+    cpSync(src, dest);
+  }
+  const manifestPath = resolve(composedDir, "volute-template.json");
+  if (!existsSync(manifestPath)) {
+    rmSync(composedDir, { recursive: true, force: true });
+    console.error(`Template manifest not found: ${templateName}/volute-template.json`);
+    process.exit(1);
+  }
+  const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+  const skillsSrc = resolve(composedDir, "_skills");
+  if (existsSync(skillsSrc)) {
+    const skillsDest = resolve(composedDir, manifest.skillsDir);
+    mkdirSync(skillsDest, { recursive: true });
+    cpSync(skillsSrc, skillsDest, { recursive: true });
+    rmSync(skillsSrc, { recursive: true, force: true });
+  }
+  rmSync(manifestPath);
+  return { composedDir, manifest };
+}
+function copyTemplateToDir(composedDir, destDir, agentName, manifest) {
+  cpSync(composedDir, destDir, { recursive: true });
+  for (const [from, to] of Object.entries(manifest.rename)) {
+    const fromPath = resolve(destDir, from);
+    if (existsSync(fromPath)) {
+      renameSync(fromPath, resolve(destDir, to));
+    }
+  }
+  for (const file of manifest.substitute) {
+    const path = resolve(destDir, file);
+    if (existsSync(path)) {
+      const content = readFileSync(path, "utf-8");
+      writeFileSync(path, content.replaceAll("{{name}}", agentName));
+    }
+  }
+}
+function applyInitFiles(destDir) {
+  const initDir = resolve(destDir, ".init");
+  if (!existsSync(initDir)) return;
+  const homeDir = resolve(destDir, "home");
+  for (const file of listFiles(initDir)) {
+    const src = resolve(initDir, file);
+    const dest = resolve(homeDir, file);
+    const parent = dirname(dest);
+    if (!existsSync(parent)) {
+      mkdirSync(parent, { recursive: true });
+    }
+    cpSync(src, dest);
+  }
+  rmSync(initDir, { recursive: true, force: true });
+}
+function listFiles(dir) {
+  const results = [];
+  function walk(current) {
+    for (const entry of readdirSync(current)) {
+      const full = join(current, entry);
+      if (statSync(full).isDirectory()) {
+        if (entry === ".git") continue;
+        walk(full);
+      } else {
+        results.push(relative(dir, full));
+      }
+    }
+  }
+  walk(dir);
+  return results;
+}
+
+export {
+  findTemplatesRoot,
+  composeTemplate,
+  copyTemplateToDir,
+  applyInitFiles,
+  listFiles
+};