volute 0.31.0 → 0.33.0

package/dist/{chunk-LX6T3GKQ.js → chunk-ALEF47VT.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   stateDir
-} from "./chunk-X62AXPR7.js";
+} from "./chunk-LRCG2JLP.js";
 
 // src/lib/file-sharing.ts
 import { randomBytes } from "crypto";

package/dist/{chunk-S2TZLSDH.js → chunk-C7I35G4R.js}

@@ -5,16 +5,18 @@ import {
 import {
   exec,
   gitExec
-} from "./chunk-57OKQMP3.js";
+} from "./chunk-KIEPMIM5.js";
 import {
   readGlobalConfig,
   writeGlobalConfig
-} from "./chunk-6QIUN46C.js";
+} from "./chunk-N432I7QH.js";
 import {
   getDb,
-  sharedSkills,
   voluteHome
-} from "./chunk-X62AXPR7.js";
+} from "./chunk-LRCG2JLP.js";
+import {
+  sharedSkills
+} from "./chunk-RPZZSXV3.js";
 
 // src/lib/skills.ts
 import { createHash } from "crypto";
@@ -32,7 +34,7 @@ import { basename, dirname, join, resolve } from "path";
 import { eq, sql } from "drizzle-orm";
 var VALID_SKILL_ID = /^[a-zA-Z0-9_-]+$/;
 var SEED_SKILLS = ["orientation", "memory"];
-var STANDARD_SKILLS = ["volute-mind", "memory", "sessions", "dreaming", "shared-files"];
+var STANDARD_SKILLS = ["volute-mind", "memory", "dreaming", "shared-files"];
 function getStandardSkillsWithExtensions() {
   const config = readGlobalConfig();
   if (config.defaultSkills) return [...config.defaultSkills];
@@ -42,7 +44,7 @@ async function initDefaultSkills() {
   const config = readGlobalConfig();
   let extensionSkills = [];
   try {
-    const { getExtensionStandardSkills } = await import("./extensions-NGEJI7JH.js");
+    const { getExtensionStandardSkills } = await import("./extensions-KYNTVTMO.js");
     extensionSkills = getExtensionStandardSkills();
   } catch (err) {
     logger_default.warn("failed to load extension standard skills during init", logger_default.errorData(err));
@@ -66,15 +68,43 @@ function sharedSkillsDir() {
 }
 function parseSkillMd(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
-  if (!match) return { name: "", description: "", npmDependencies: [] };
+  if (!match) return { name: "", description: "", npmDependencies: [], hooks: {}, bin: null };
   const frontmatter = match[1];
   const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
   const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
   const depsMatch = frontmatter.match(/^\s*npm-dependencies:\s*(.+)$/m);
+  const binMatch = frontmatter.match(/^\s*bin:\s*(.+)$/m);
+  const hooks = {};
+  const lines = frontmatter.split("\n");
+  let inHooks = false;
+  let hooksIndent = -1;
+  for (const line of lines) {
+    if (!line.trim()) continue;
+    const hooksStart = line.match(/^(\s+)hooks:\s*$/);
+    if (hooksStart) {
+      inHooks = true;
+      hooksIndent = hooksStart[1].length;
+      continue;
+    }
+    if (inHooks) {
+      const lineIndentMatch = line.match(/^(\s*)/);
+      const lineIndent = lineIndentMatch ? lineIndentMatch[1].length : 0;
+      if (lineIndent <= hooksIndent) {
+        inHooks = false;
+        continue;
+      }
+      const hookMatch = line.match(/^\s+([a-z0-9-]+):\s*(.+)$/);
+      if (hookMatch) {
+        hooks[hookMatch[1]] = hookMatch[2].trim();
+      }
+    }
+  }
   return {
     name: nameMatch?.[1].trim() ?? "",
     description: descMatch?.[1].trim() ?? "",
-    npmDependencies: depsMatch ? depsMatch[1].trim().split(/[\s,]+/).filter(Boolean) : []
+    npmDependencies: depsMatch ? depsMatch[1].trim().split(/[\s,]+/).filter(Boolean) : [],
+    hooks,
+    bin: binMatch?.[1].trim() ?? null
   };
 }
 async function listSharedSkills() {
@@ -128,8 +158,24 @@ async function removeSharedSkill(id) {
   const dir = join(sharedSkillsDir(), id);
   if (existsSync(dir)) rmSync(dir, { recursive: true });
 }
+var TEMPLATE_SKILLS_DIR = {
+  claude: ".claude/skills",
+  pi: ".pi/skills",
+  codex: ".agents/skills"
+};
 function mindSkillsDir(dir) {
-  return resolve(dir, "home", ".claude", "skills");
+  const home = resolve(dir, "home");
+  let subdir = TEMPLATE_SKILLS_DIR.claude;
+  if (existsSync(join(home, "AGENTS.md"))) {
+    subdir = TEMPLATE_SKILLS_DIR.codex;
+  } else if (existsSync(join(home, "MINDS.md"))) {
+    subdir = TEMPLATE_SKILLS_DIR.pi;
+  }
+  return resolve(home, subdir);
+}
+function relSkillsPath(dir) {
+  const home = resolve(dir, "home");
+  return join("home", mindSkillsDir(dir).slice(home.length + 1));
 }
 function readUpstream(skillDir) {
   const upstreamPath = join(skillDir, ".upstream.json");
@@ -172,12 +218,21 @@ async function installSkill(_mindName, dir, skillId) {
       }
     }
   }
+  if (existsSync(skillMdPath)) {
+    const { hooks, bin } = parseSkillMd(readFileSync(skillMdPath, "utf-8"));
+    installHookShims(dir, skillId, hooks);
+    if (bin) installBinShim(dir, skillId, bin);
+  }
   let installNotes = null;
   const installMdPath = join(destDir, "references", "INSTALL.md");
   if (existsSync(installMdPath)) {
     installNotes = readFileSync(installMdPath, "utf-8");
   }
-  await gitExec(["add", join("home", ".claude", "skills", skillId)], { cwd: dir });
+  await gitExec(["add", join(relSkillsPath(dir), skillId)], { cwd: dir });
+  await gitExec(["add", join("home", ".local", "hooks")], { cwd: dir }).catch(() => {
+  });
+  await gitExec(["add", join("home", ".local", "bin")], { cwd: dir }).catch(() => {
+  });
   if (npmInstalled.length > 0) {
     await gitExec(["add", "package.json", "package-lock.json"], { cwd: dir });
   }
@@ -190,7 +245,7 @@ async function installSkill(_mindName, dir, skillId) {
   };
   writeFileSync(join(destDir, ".upstream.json"), `${JSON.stringify(upstream, null, 2)}
 `);
-  await gitExec(["add", join("home", ".claude", "skills", skillId, ".upstream.json")], {
+  await gitExec(["add", join(relSkillsPath(dir), skillId, ".upstream.json")], {
     cwd: dir
   });
   await gitExec(["commit", "--amend", "--no-edit"], { cwd: dir });
@@ -200,8 +255,18 @@ async function uninstallSkill(_mindName, dir, skillId) {
   validateSkillId(skillId);
   const skillDir = join(mindSkillsDir(dir), skillId);
   if (!existsSync(skillDir)) throw new Error(`Skill not installed: ${skillId}`);
+  removeHookShims(dir, skillId);
+  const skillMdPath = join(skillDir, "SKILL.md");
+  if (existsSync(skillMdPath)) {
+    const { bin } = parseSkillMd(readFileSync(skillMdPath, "utf-8"));
+    if (bin) removeBinShim(dir, bin);
+  }
   rmSync(skillDir, { recursive: true });
-  await gitExec(["add", join("home", ".claude", "skills", skillId)], { cwd: dir });
+  await gitExec(["add", join(relSkillsPath(dir), skillId)], { cwd: dir });
+  await gitExec(["add", join("home", ".local", "hooks")], { cwd: dir }).catch(() => {
+  });
+  await gitExec(["add", join("home", ".local", "bin")], { cwd: dir }).catch(() => {
+  });
   await gitExec(["commit", "-m", `Uninstall skill: ${skillId}`], { cwd: dir });
 }
 async function updateSkill(_mindName, dir, skillId) {
@@ -217,7 +282,7 @@ async function updateSkill(_mindName, dir, skillId) {
   }
   const sourceDir = join(sharedSkillsDir(), upstream.source);
   if (!existsSync(sourceDir)) throw new Error(`Shared skill files missing: ${upstream.source}`);
-  const relSkillPath = join("home", ".claude", "skills", skillId);
+  const relSkillPath = join(relSkillsPath(dir), skillId);
   const currentFiles = listFilesRecursive(skillDir).filter((f) => f !== ".upstream.json");
   const newFiles = listFilesRecursive(sourceDir).filter((f) => f !== ".upstream.json");
   const allFiles = [.../* @__PURE__ */ new Set([...currentFiles, ...newFiles])];
@@ -241,7 +306,9 @@ async function updateSkill(_mindName, dir, skillId) {
         try {
           baseContent2 = await gitExec(
             ["show", `${upstream.baseCommit}:${join(relSkillPath, file)}`],
-            { cwd: dir }
+            {
+              cwd: dir
+            }
           );
         } catch {
           continue;
@@ -256,7 +323,9 @@ async function updateSkill(_mindName, dir, skillId) {
       try {
         baseContent = await gitExec(
           ["show", `${upstream.baseCommit}:${join(relSkillPath, file)}`],
-          { cwd: dir }
+          {
+            cwd: dir
+          }
         );
       } catch {
         baseContent = "";
@@ -352,6 +421,77 @@ async function publishSkill(mindName, dir, skillId) {
   if (!existsSync(skillMdPath)) throw new Error(`SKILL.md not found in ${skillId}`);
   return importSkillFromDir(skillDir, mindName);
 }
+function shimContent(skillId, scriptPath, skillsSubdir) {
+  const ext = scriptPath.split(".").pop() ?? "sh";
+  const skillScriptPath = `${skillsSubdir}/${skillId}/${scriptPath}`;
+  if (ext === "ts") {
+    return `#!/bin/bash
+exec node --import tsx ${skillScriptPath} "$@"
+`;
+  }
+  if (ext === "js") {
+    return `#!/bin/bash
+exec node ${skillScriptPath} "$@"
+`;
+  }
+  return `#!/bin/bash
+exec bash ${skillScriptPath} "$@"
+`;
+}
+function installHookShims(dir, skillId, hooks) {
+  const home = resolve(dir, "home");
+  const skillsSubdir = mindSkillsDir(dir).slice(home.length + 1);
+  for (const [event, scriptPath] of Object.entries(hooks)) {
+    const eventDir = join(dir, "home", ".local", "hooks", event);
+    mkdirSync(eventDir, { recursive: true });
+    const shimPath = join(eventDir, `50-${skillId}.sh`);
+    const content = shimContent(skillId, scriptPath, skillsSubdir);
+    writeFileSync(shimPath, content, { mode: 493 });
+  }
+}
+function removeHookShims(dir, skillId) {
+  const hooksBase = join(dir, "home", ".local", "hooks");
+  if (!existsSync(hooksBase)) return;
+  for (const eventDir of readdirSync(hooksBase, { withFileTypes: true })) {
+    if (!eventDir.isDirectory()) continue;
+    const shimPath = join(hooksBase, eventDir.name, `50-${skillId}.sh`);
+    if (existsSync(shimPath)) rmSync(shimPath);
+  }
+}
+function binShimContent(skillId, scriptPath, skillsSubdir) {
+  const skillScriptPath = `${skillsSubdir}/${skillId}/${scriptPath}`;
+  const ext = scriptPath.split(".").pop() ?? "sh";
+  if (ext === "ts") {
+    return `#!/bin/bash
+exec node --import tsx ${skillScriptPath} "$@"
+`;
+  }
+  if (ext === "js") {
+    return `#!/bin/bash
+exec node ${skillScriptPath} "$@"
+`;
+  }
+  return `#!/bin/bash
+exec bash ${skillScriptPath} "$@"
+`;
+}
+function binCommandName(scriptPath) {
+  return basename(scriptPath).replace(/\.[^.]+$/, "");
+}
+function installBinShim(dir, skillId, scriptPath) {
+  const home = resolve(dir, "home");
+  const skillsSubdir = mindSkillsDir(dir).slice(home.length + 1);
+  const binDir = join(dir, "home", ".local", "bin");
+  mkdirSync(binDir, { recursive: true });
+  const cmdName = binCommandName(scriptPath);
+  const shimPath = join(binDir, cmdName);
+  writeFileSync(shimPath, binShimContent(skillId, scriptPath, skillsSubdir), { mode: 493 });
+}
+function removeBinShim(dir, scriptPath) {
+  const cmdName = binCommandName(scriptPath);
+  const shimPath = join(dir, "home", ".local", "bin", cmdName);
+  if (existsSync(shimPath)) rmSync(shimPath);
+}
 function listFilesRecursive(dir, prefix = "") {
   const results = [];
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
@@ -420,16 +560,24 @@ export {
   getStandardSkillsWithExtensions,
   initDefaultSkills,
   sharedSkillsDir,
+  parseSkillMd,
   listSharedSkills,
   getSharedSkill,
   importSkillFromDir,
   removeSharedSkill,
+  mindSkillsDir,
+  readUpstream,
   installSkill,
   uninstallSkill,
   updateSkill,
   listMindSkills,
   publishSkill,
+  installHookShims,
+  removeHookShims,
+  installBinShim,
+  removeBinShim,
   listFilesRecursive,
+  findSkillsRoot,
   hashSkillDir,
   syncBuiltinSkills
 };

package/dist/{chunk-VGWJSNHS.js → chunk-G53F3JA4.js}

@@ -1,10 +1,5 @@
 #!/usr/bin/env node
 
-// src/lib/template-hash.ts
-import { createHash } from "crypto";
-import { existsSync as existsSync2, readFileSync as readFileSync2, rmSync as rmSync2 } from "fs";
-import { resolve as resolve2 } from "path";
-
 // src/lib/template.ts
 import {
   cpSync,
@@ -110,39 +105,10 @@ function listFiles(dir) {
   return results;
 }
 
-// src/lib/template-hash.ts
-var hashCache = /* @__PURE__ */ new Map();
-function computeTemplateHash(templateName) {
-  const cached = hashCache.get(templateName);
-  if (cached) return cached;
-  const templatesRoot = findTemplatesRoot();
-  const baseDir = resolve2(templatesRoot, "_base");
-  const templateDir = resolve2(templatesRoot, templateName);
-  if (!existsSync2(baseDir)) throw new Error(`Base template not found: ${baseDir}`);
-  if (!existsSync2(templateDir)) throw new Error(`Template not found: ${templateName}`);
-  const { composedDir } = composeTemplate(templatesRoot, templateName);
-  try {
-    const files = listFiles(composedDir).filter((f) => !f.startsWith(".init/") && !f.startsWith(".init\\")).sort();
-    const hash = createHash("sha256");
-    for (const file of files) {
-      const content = readFileSync2(resolve2(composedDir, file));
-      hash.update(file);
-      hash.update("\0");
-      hash.update(content);
-    }
-    const result = hash.digest("hex");
-    hashCache.set(templateName, result);
-    return result;
-  } finally {
-    rmSync2(composedDir, { recursive: true, force: true });
-  }
-}
-
 export {
   findTemplatesRoot,
   composeTemplate,
   copyTemplateToDir,
   applyInitFiles,
-  listFiles,
-  computeTemplateHash
+  listFiles
 };

package/dist/{chunk-A6TUJJ3L.js → chunk-G6BSYHPK.js}

@@ -6,11 +6,11 @@ function slugify(text) {
 }
 function buildVoluteSlug(opts) {
   if (opts.convType === "channel" && opts.convName) {
-    return `volute:#${opts.convName}`;
+    return `#${opts.convName}`;
   }
   const other = opts.participants.find((p) => p.username !== opts.mindUsername);
   const otherSlug = other ? slugify(other.username) : "";
-  return otherSlug ? `volute:@${otherSlug}` : `volute:${opts.conversationId}`;
+  return otherSlug ? `@${otherSlug}` : opts.conversationId;
 }
 
 export {

package/dist/{chunk-DAXJKPHZ.js → chunk-GY5HBI7A.js}

@@ -4,14 +4,14 @@ import {
 } from "./chunk-YUIHSKR6.js";
 import {
   readGlobalConfig
-} from "./chunk-6QIUN46C.js";
+} from "./chunk-N432I7QH.js";
 import {
   getBaseName,
   readRegistry,
   voluteHome,
   voluteSystemDir,
   voluteUserHome
-} from "./chunk-X62AXPR7.js";
+} from "./chunk-LRCG2JLP.js";
 
 // src/lib/sandbox.ts
 import { resolve } from "path";

package/dist/{chunk-BC3P3QCK.js → chunk-I5KY25PQ.js}

@@ -2,7 +2,7 @@
 import {
   mindDir,
   stateDir
-} from "./chunk-X62AXPR7.js";
+} from "./chunk-LRCG2JLP.js";
 
 // src/lib/archive.ts
 import { execFileSync } from "child_process";
@@ -91,12 +91,6 @@ function createExportArchive(options) {
       }
     }
   }
-  if (existsSync(state)) {
-    const channelsPath = resolve(state, "channels.json");
-    if (existsSync(channelsPath)) {
-      zip.addFile("state/channels.json", readFileSync(channelsPath));
-    }
-  }
   if (includeEnv && existsSync(state)) {
     const envPath = resolve(state, "env.json");
     if (existsSync(envPath)) {
@@ -184,14 +178,12 @@ function extractArchive(archivePath, destDir) {
     mkdirSync(resolve(destPath, ".."), { recursive: true });
     writeFileSync(destPath, entry.getData());
   }
-  const channelsJson = resolve(extractedStateDir, "channels.json");
   const envJson = resolve(extractedStateDir, "env.json");
   const historyJsonl = resolve(normalizedDestDir, "history.jsonl");
   const sessionsDir = resolve(normalizedDestDir, "sessions");
   return {
     manifest,
     mindDir: extractedMindDir,
-    channelsJson: existsSync(channelsJson) ? channelsJson : null,
     envJson: existsSync(envJson) ? envJson : null,
     historyJsonl: existsSync(historyJsonl) ? historyJsonl : null,
     sessionsDir: existsSync(sessionsDir) ? sessionsDir : null

package/dist/{chunk-BNC43CSY.js → chunk-JUKK7FPS.js}

@@ -5,10 +5,10 @@ import {
   pollHealthDown,
   readDaemonConfig,
   stopService
-} from "./chunk-SNVPRRT7.js";
+} from "./chunk-NNB4WIG7.js";
 import {
   voluteSystemDir
-} from "./chunk-X62AXPR7.js";
+} from "./chunk-LRCG2JLP.js";
 
 // src/commands/down.ts
 import { existsSync, readFileSync, unlinkSync } from "fs";

package/dist/{chunk-R5QJBZZG.js → chunk-JYVGHWEJ.js}

@@ -1,15 +1,17 @@
 #!/usr/bin/env node
 import {
   broadcast
-} from "./chunk-EKDWA7E4.js";
+} from "./chunk-KVK2DLWI.js";
+import {
+  getDb
+} from "./chunk-LRCG2JLP.js";
 import {
-  getDb,
   users
-} from "./chunk-X62AXPR7.js";
+} from "./chunk-RPZZSXV3.js";
 
 // src/lib/auth.ts
 import { compareSync, hashSync } from "bcryptjs";
-import { and, count, eq } from "drizzle-orm";
+import { and, count, eq, or } from "drizzle-orm";
 var userSelectFields = {
   id: users.id,
   username: users.username,
@@ -61,7 +63,12 @@ async function listUsersByType(userType) {
 }
 async function getOrCreateMindUser(mindName) {
   const db = await getDb();
-  const existing = await db.select(userSelectFields).from(users).where(and(eq(users.username, mindName), eq(users.user_type, "mind"))).get();
+  const existing = await db.select(userSelectFields).from(users).where(
+    and(
+      eq(users.username, mindName),
+      or(eq(users.user_type, "mind"), eq(users.user_type, "system"))
+    )
+  ).get();
   if (existing) return existing;
   try {
     const [result] = await db.insert(users).values({
@@ -72,10 +79,13 @@ async function getOrCreateMindUser(mindName) {
     }).returning(userSelectFields);
     return result;
   } catch (err) {
-    if (err instanceof Error && err.message.includes("UNIQUE constraint")) {
-      const retried = await db.select(userSelectFields).from(users).where(and(eq(users.username, mindName), eq(users.user_type, "mind"))).get();
-      if (retried) return retried;
-    }
+    const retried = await db.select(userSelectFields).from(users).where(
+      and(
+        eq(users.username, mindName),
+        or(eq(users.user_type, "mind"), eq(users.user_type, "system"))
+      )
+    ).get();
+    if (retried) return retried;
     throw err;
   }
 }
@@ -87,9 +97,9 @@ async function getOrCreateSystemUser() {
     const [result] = await db.insert(users).values({
       username: "volute",
       password_hash: "!system",
-      role: "user",
+      role: "system",
       user_type: "system",
-      display_name: "Volute"
+      display_name: "volute"
     }).returning(userSelectFields);
     return result;
   } catch (err) {

package/dist/chunk-KIEPMIM5.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import {
+  wrapForIsolation
+} from "./chunk-VH33ZWMW.js";
+
+// src/lib/exec.ts
+import { execFile as execFileCb, execFileSync, spawn } from "child_process";
+async function exec(cmd, args, options) {
+  const [wrappedCmd, wrappedArgs] = options?.mindName ? await wrapForIsolation(cmd, args, options.mindName) : [cmd, args];
+  return new Promise((resolve, reject) => {
+    execFileCb(
+      wrappedCmd,
+      wrappedArgs,
+      { cwd: options?.cwd, env: options?.env },
+      (err, stdout, stderr) => {
+        if (err) {
+          err.stderr = stderr;
+          err.stdout = stdout;
+          reject(err);
+        } else {
+          resolve(stdout);
+        }
+      }
+    );
+  });
+}
+function gitExec(args, options) {
+  const fullArgs = process.env.VOLUTE_ISOLATION === "user" ? ["-c", "safe.directory=*", ...args] : args;
+  return exec("git", fullArgs, options);
+}
+function resolveVoluteBin() {
+  try {
+    return execFileSync("which", ["volute"], { encoding: "utf-8" }).trim();
+  } catch {
+    throw new Error("Could not find volute binary on PATH");
+  }
+}
+async function execInherit(cmd, args, options) {
+  const [wrappedCmd, wrappedArgs] = options?.mindName ? await wrapForIsolation(cmd, args, options.mindName) : [cmd, args];
+  return new Promise((resolve, reject) => {
+    const child = spawn(wrappedCmd, wrappedArgs, {
+      cwd: options?.cwd,
+      env: options?.env,
+      stdio: "inherit"
+    });
+    child.on("error", reject);
+    child.on("close", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`${cmd} ${args.join(" ")} exited with code ${code}`));
+    });
+  });
+}
+
+export {
+  exec,
+  gitExec,
+  resolveVoluteBin,
+  execInherit
+};

package/dist/{chunk-EKDWA7E4.js → chunk-KVK2DLWI.js}

@@ -3,9 +3,11 @@ import {
   logger_default
 } from "./chunk-YUIHSKR6.js";
 import {
-  activity,
   getDb
-} from "./chunk-X62AXPR7.js";
+} from "./chunk-LRCG2JLP.js";
+import {
+  activity
+} from "./chunk-RPZZSXV3.js";
 
 // src/lib/events/activity-events.ts
 var subscribers = /* @__PURE__ */ new Set();
@@ -35,6 +37,7 @@ async function publish(event) {
   }
   const full = { ...event, id, created_at };
   notify(full);
+  return id;
 }
 function broadcast(event) {
   const created_at = event.created_at ?? (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").slice(0, 19);

package/dist/{chunk-AAO77TZX.js → chunk-LOEJ4HPQ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   publish
-} from "./chunk-EKDWA7E4.js";
+} from "./chunk-KVK2DLWI.js";
 import {
   logger_default
 } from "./chunk-YUIHSKR6.js";