volute 0.30.1 → 0.32.0

package/templates/pi/.init/.config/routes.json

@@ -1,8 +1,8 @@
 {
   "gateUnmatched": true,
   "rules": [
-    { "channel": "volute:*", "isDM": true, "session": "${channel}" },
-    { "channel": "volute:*", "isDM": false, "session": "group-${channel}" }
+    { "channel": "*", "isDM": true, "session": "${channel}" },
+    { "channel": "*", "isDM": false, "session": "group-${channel}" }
   ],
   "sessions": {
     "group-*": { "batch": { "debounce": 20, "maxWait": 120, "triggers": ["@{{name}}"] } }

package/templates/pi/package.json.tmpl

@@ -9,7 +9,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@mariozechner/pi-coding-agent": "^0.51.0",
+    "@mariozechner/pi-coding-agent": "^0.58.1",
     "@sinclair/typebox": "^0.34.0",
     "tsx": "^4.0.0"
   },

package/templates/pi/src/agent.ts

@@ -10,11 +10,11 @@ import {
   SettingsManager,
 } from "@mariozechner/pi-coding-agent";
 import { extractImages, extractText } from "./lib/content.js";
-import { createEventHandler } from "./lib/event-handler.js";
+import { createEventHandler, emit } from "./lib/event-handler.js";
+import { runHooks } from "./lib/hook-loader.js";
 import { log } from "./lib/logger.js";
 import { createReplyInstructionsExtension } from "./lib/reply-instructions-extension.js";
 import { resolveModel } from "./lib/resolve-model.js";
-import { createSessionContextExtension } from "./lib/session-context-extension.js";
 import { loadPrompts, type SubagentConfig } from "./lib/startup.js";
 import { createSubagentExtension, type SubagentDefinition } from "./lib/subagents.js";
 import type {
@@ -64,7 +64,7 @@ export function createMind(options: {
   // Shared setup (created once)
   const modelStr = options.model || process.env.PI_MODEL || "anthropic:claude-sonnet-4-20250514";
   const model = resolveModel(modelStr);
-  const authStorage = new AuthStorage();
+  const authStorage = AuthStorage.create();
   const modelRegistry = new ModelRegistry(authStorage);
 
   // --- Subagents (config-driven) ---
@@ -109,6 +109,59 @@ export function createMind(options: {
       ? createSubagentExtension(subagents, { cwd: options.cwd, model, authStorage, modelRegistry })
       : undefined;
 
+  // --- Dynamic hook extension ---
+
+  const hooksDir = resolvePath(options.cwd, ".local/hooks");
+
+  function createDynamicHookExtension(session: PiSession): ExtensionFactory {
+    return (pi) => {
+      pi.on("before_agent_start", async () => {
+        try {
+          const result = await runHooks(hooksDir, "pre-prompt", {
+            event: "pre-prompt",
+            session: session.name,
+          });
+          if (result.additionalContext) {
+            emit(session, {
+              type: "context",
+              content: result.additionalContext,
+              metadata: { source: "dynamic:pre-prompt", ...result.metadata },
+            });
+            return {
+              message: {
+                customType: "dynamic-hook",
+                content: result.additionalContext,
+                display: true,
+              },
+            };
+          }
+        } catch (err) {
+          log("mind", "dynamic pre-prompt hook failed:", err);
+        }
+        return {};
+      });
+
+      pi.on("tool_execution_end", async (event: any) => {
+        try {
+          const result = await runHooks(hooksDir, "post-tool-use", {
+            event: "post-tool-use",
+            tool_name: event.toolName,
+            tool_input: event.args,
+          });
+          if (result.additionalContext) {
+            emit(session, {
+              type: "context",
+              content: result.additionalContext,
+              metadata: { source: "dynamic:post-tool-use", ...result.metadata },
+            });
+          }
+        } catch (err) {
+          log("mind", "dynamic post-tool-use hook failed:", err);
+        }
+      });
+    };
+  }
+
   // --- Session lifecycle ---
 
   function getOrCreateSession(name: string): PiSession {
@@ -189,12 +242,13 @@ export function createMind(options: {
       retry: { enabled: true, maxRetries: 3 },
     });
 
-    const sessionContextExtension = createSessionContextExtension({
-      currentSession: session.name,
-      mindDir: options.mindDir,
-    });
+    const replyInstructionsExtension = createReplyInstructionsExtension(
+      session.messageChannels,
+      emit,
+      session,
+    );
 
-    const replyInstructionsExtension = createReplyInstructionsExtension(session.messageChannels);
+    const dynamicHookExtension = createDynamicHookExtension(session);
 
     const resourceLoader = new DefaultResourceLoader({
       cwd: options.cwd,
@@ -202,9 +256,9 @@ export function createMind(options: {
       systemPrompt: options.systemPrompt,
       extensionFactories: [
         preCompactExtension,
-        sessionContextExtension,
         replyInstructionsExtension,
         ...(subagentExtension ? [subagentExtension] : []),
+        dynamicHookExtension,
       ],
     });
     await resourceLoader.reload();

package/templates/pi/src/lib/event-handler.ts

@@ -1,4 +1,4 @@
-import { commitFileChange } from "./auto-commit.js";
+import { flushFileChanges, trackFileChange } from "./auto-commit.js";
 import { daemonEmit, type EventType } from "./daemon-client.js";
 import { log, warn } from "./logger.js";
 import { filterEvent, loadTransparencyPreset } from "./transparency.js";
@@ -21,7 +21,7 @@ export type EventHandlerOptions = {
 // Loaded once at startup — mind restarts on config changes
 const preset = loadTransparencyPreset();
 
-function emit(
+export function emit(
   session: EventSession,
   event: { type: EventType; content?: string; metadata?: Record<string, unknown> },
 ) {
@@ -110,7 +110,7 @@ export function createEventHandler(session: EventSession, options: EventHandlerO
           const args = toolArgs.get(event.toolCallId);
           const filePath = (args as { path?: string })?.path;
           if (filePath) {
-            commitFileChange(filePath, options.cwd);
+            trackFileChange(filePath, options.cwd);
           }
         }
         toolArgs.delete(event.toolCallId);
@@ -158,7 +158,9 @@ export function createEventHandler(session: EventSession, options: EventHandlerO
         options.broadcast({ type: "done" });
         emit(session, { type: "done" });
         session.currentMessageId = undefined;
-        options.onTurnEnd?.();
+        flushFileChanges(options.cwd)
+          .then(() => options.onTurnEnd?.())
+          .catch((err) => log("mind", `session "${session.name}": flush/turn-end error:`, err));
       }
     } catch (err) {
       log("mind", `session "${session.name}": event handler error (${event?.type}):`, err);

package/templates/pi/src/lib/reply-instructions-extension.ts

@@ -1,27 +1,48 @@
 import type { ExtensionFactory } from "@mariozechner/pi-coding-agent";
+import type { EventSession } from "./event-handler.js";
+import { log } from "./logger.js";
 import { loadPrompts } from "./startup.js";
 
 export function createReplyInstructionsExtension(
   messageChannels: Map<string, string>,
+  emitContext?: (
+    session: EventSession,
+    event: { type: "context"; content: string; metadata: Record<string, unknown> },
+  ) => void,
+  session?: EventSession,
 ): ExtensionFactory {
   const prompts = loadPrompts();
   return (pi) => {
     let fired = false;
     pi.on("before_agent_start", () => {
-      if (fired) return {};
+      try {
+        if (fired) return {};
 
-      const channel = messageChannels.values().next().value;
-      if (!channel) return {};
+        const channel = messageChannels.values().next().value;
+        if (!channel) return {};
 
-      fired = true;
+        fired = true;
 
-      return {
-        message: {
-          customType: "reply-instructions",
-          content: prompts.reply_instructions.replace(/\$\{channel\}/g, channel),
-          display: true,
-        },
-      };
+        const content = prompts.reply_instructions.replace(/\$\{channel\}/g, channel);
+        if (emitContext && session) {
+          emitContext(session, {
+            type: "context",
+            content,
+            metadata: { source: "reply-instructions" },
+          });
+        }
+
+        return {
+          message: {
+            customType: "reply-instructions",
+            content,
+            display: true,
+          },
+        };
+      } catch (err) {
+        log("mind", "reply instructions extension failed:", err);
+        return {};
+      }
     });
   };
 }

package/dist/chunk-7D47T4RB.js

@@ -1,84 +0,0 @@
-#!/usr/bin/env node
-import {
-  voluteHome,
-  voluteSystemDir
-} from "./chunk-HHTXM4JT.js";
-
-// src/lib/setup.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { resolve } from "path";
-function configPath() {
-  return resolve(voluteSystemDir(), "config.json");
-}
-function readGlobalConfig() {
-  const path = configPath();
-  const legacyPath = resolve(voluteHome(), "config.json");
-  const effectivePath = existsSync(path) ? path : legacyPath;
-  if (!existsSync(effectivePath)) return {};
-  try {
-    return JSON.parse(readFileSync(effectivePath, "utf-8"));
-  } catch (err) {
-    console.error(`Failed to parse ${effectivePath}: ${err instanceof Error ? err.message : err}`);
-    return {};
-  }
-}
-function writeGlobalConfig(config) {
-  const path = configPath();
-  mkdirSync(voluteSystemDir(), { recursive: true });
-  writeFileSync(path, `${JSON.stringify(config, null, 2)}
-`);
-}
-function isSetupComplete() {
-  const config = readGlobalConfig();
-  return config.setup != null;
-}
-function migrateSetupConfig() {
-  const config = readGlobalConfig();
-  if (config.setup) return;
-  const home = voluteHome();
-  const systemDir = voluteSystemDir();
-  const registryPath = resolve(systemDir, "minds.json");
-  const legacyRegistryPath = resolve(home, "minds.json");
-  if (!existsSync(registryPath) && !existsSync(legacyRegistryPath)) return;
-  const isSystem = process.env.VOLUTE_ISOLATION === "user";
-  const mindsDir = process.env.VOLUTE_MINDS_DIR || resolve(home, "minds");
-  let hasService = false;
-  try {
-    if (process.platform === "darwin") {
-      const plistPath = resolve(
-        process.env.HOME || "",
-        "Library",
-        "LaunchAgents",
-        "com.volute.daemon.plist"
-      );
-      if (existsSync(plistPath)) hasService = true;
-    }
-    if (process.platform === "linux") {
-      if (existsSync("/etc/systemd/system/volute.service")) hasService = true;
-      const userUnit = resolve(
-        process.env.HOME || "",
-        ".config",
-        "systemd",
-        "user",
-        "volute.service"
-      );
-      if (existsSync(userUnit)) hasService = true;
-    }
-  } catch {
-  }
-  const setup = {
-    type: isSystem ? "system" : "local",
-    isolation: isSystem ? "user" : "none",
-    mindsDir,
-    service: hasService
-  };
-  writeGlobalConfig({ ...config, setup });
-}
-
-export {
-  configPath,
-  readGlobalConfig,
-  writeGlobalConfig,
-  isSetupComplete,
-  migrateSetupConfig
-};

package/dist/chunk-CVH6Y2YG.js

@@ -1,59 +0,0 @@
-#!/usr/bin/env node
-import {
-  wrapForIsolation
-} from "./chunk-G3GBKZGG.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-EFP3PE6C.js

@@ -1,232 +0,0 @@
-#!/usr/bin/env node
-import {
-  publish
-} from "./chunk-P27RV5WM.js";
-import {
-  logger_default
-} from "./chunk-YUIHSKR6.js";
-import {
-  mindDir,
-  readRegistry,
-  voluteHome
-} from "./chunk-HHTXM4JT.js";
-
-// src/lib/pages-watcher.ts
-import { existsSync, readdirSync, statSync, watch } from "fs";
-import { join, resolve } from "path";
-var watchers = /* @__PURE__ */ new Map();
-var homeWatchers = /* @__PURE__ */ new Map();
-var debounceTimers = /* @__PURE__ */ new Map();
-var sitesCache = null;
-var recentPagesCache = null;
-function startPagesWatcher(mindName, pagesDir) {
-  try {
-    const watcher = watch(pagesDir, { recursive: true }, (_eventType, filename) => {
-      if (!filename || !filename.endsWith(".html")) return;
-      const key = `${mindName}:${filename}`;
-      const existing = debounceTimers.get(key);
-      if (existing) clearTimeout(existing);
-      debounceTimers.set(
-        key,
-        setTimeout(() => {
-          debounceTimers.delete(key);
-          invalidateCache();
-          publish({
-            type: "page_updated",
-            mind: mindName,
-            summary: `${mindName} updated ${filename}`,
-            metadata: { file: filename }
-          }).catch(
-            (err) => logger_default.error("failed to publish page_updated activity", logger_default.errorData(err))
-          );
-        }, 100)
-      );
-    });
-    watchers.set(mindName, watcher);
-  } catch (err) {
-    logger_default.warn(`failed to start pages watcher for ${mindName}`, logger_default.errorData(err));
-  }
-}
-function startSystemWatcher() {
-  if (watchers.has("_system")) return;
-  const systemPagesDir = resolve(voluteHome(), "shared", "pages");
-  if (!existsSync(systemPagesDir)) return;
-  startPagesWatcher("_system", systemPagesDir);
-}
-function startWatcher(mindName) {
-  if (watchers.has(mindName)) return;
-  const pagesDir = resolve(mindDir(mindName), "home", "public", "pages");
-  if (existsSync(pagesDir)) {
-    startPagesWatcher(mindName, pagesDir);
-    return;
-  }
-  if (homeWatchers.has(mindName)) return;
-  const publicDir = resolve(mindDir(mindName), "home", "public");
-  if (!existsSync(publicDir)) return;
-  try {
-    const hw = watch(publicDir, (_eventType, filename) => {
-      if (filename !== "pages") return;
-      if (!existsSync(pagesDir)) return;
-      hw.close();
-      homeWatchers.delete(mindName);
-      invalidateCache();
-      startPagesWatcher(mindName, pagesDir);
-    });
-    homeWatchers.set(mindName, hw);
-  } catch (err) {
-    logger_default.warn(`failed to start home watcher for ${mindName}`, logger_default.errorData(err));
-  }
-}
-function stopWatcher(mindName) {
-  const watcher = watchers.get(mindName);
-  if (watcher) {
-    watcher.close();
-    watchers.delete(mindName);
-  }
-  const hw = homeWatchers.get(mindName);
-  if (hw) {
-    hw.close();
-    homeWatchers.delete(mindName);
-  }
-  for (const [key, timer] of debounceTimers) {
-    if (key.startsWith(`${mindName}:`)) {
-      clearTimeout(timer);
-      debounceTimers.delete(key);
-    }
-  }
-}
-function stopAllWatchers() {
-  for (const [, watcher] of watchers) {
-    watcher.close();
-  }
-  watchers.clear();
-  for (const [, hw] of homeWatchers) {
-    hw.close();
-  }
-  homeWatchers.clear();
-  for (const [, timer] of debounceTimers) {
-    clearTimeout(timer);
-  }
-  debounceTimers.clear();
-  invalidateCache();
-}
-function invalidateCache() {
-  sitesCache = null;
-  recentPagesCache = null;
-}
-function scanPagesDir(dir, urlPrefix) {
-  const pages = [];
-  let items;
-  try {
-    items = readdirSync(dir);
-  } catch {
-    return pages;
-  }
-  for (const item of items) {
-    if (item.startsWith(".")) continue;
-    const fullPath = resolve(dir, item);
-    try {
-      const s = statSync(fullPath);
-      if (s.isFile() && item.endsWith(".html")) {
-        pages.push({
-          file: item,
-          modified: s.mtime.toISOString(),
-          url: `${urlPrefix}/${item}`
-        });
-      } else if (s.isDirectory()) {
-        const indexPath = resolve(fullPath, "index.html");
-        if (existsSync(indexPath)) {
-          const indexStat = statSync(indexPath);
-          pages.push({
-            file: join(item, "index.html"),
-            modified: indexStat.mtime.toISOString(),
-            url: `${urlPrefix}/${item}/`
-          });
-        }
-      }
-    } catch {
-    }
-  }
-  pages.sort((a, b) => new Date(b.modified).getTime() - new Date(a.modified).getTime());
-  return pages;
-}
-async function buildSites() {
-  const sites = [];
-  const systemPagesDir = resolve(voluteHome(), "shared", "pages");
-  if (existsSync(systemPagesDir)) {
-    const systemPages = scanPagesDir(systemPagesDir, "/pages/_system");
-    if (systemPages.length > 0) {
-      sites.push({ name: "_system", label: "System", pages: systemPages });
-    }
-  }
-  const entries = await readRegistry();
-  for (const entry of [...entries].sort((a, b) => a.name.localeCompare(b.name))) {
-    const pagesDir = resolve(mindDir(entry.name), "home", "public", "pages");
-    if (!existsSync(pagesDir)) continue;
-    const mindPages = scanPagesDir(pagesDir, `/minds/${entry.name}/pages`);
-    if (mindPages.length > 0) {
-      sites.push({ name: entry.name, label: entry.name, pages: mindPages });
-    }
-  }
-  return sites;
-}
-async function buildRecentPages() {
-  const entries = await readRegistry();
-  const pages = [];
-  for (const entry of entries) {
-    const pagesDir = resolve(mindDir(entry.name), "home", "public", "pages");
-    if (!existsSync(pagesDir)) continue;
-    let items;
-    try {
-      items = readdirSync(pagesDir);
-    } catch {
-      continue;
-    }
-    for (const item of items) {
-      if (item.startsWith(".")) continue;
-      const fullPath = resolve(pagesDir, item);
-      try {
-        const s = statSync(fullPath);
-        if (s.isFile() && item.endsWith(".html")) {
-          pages.push({
-            mind: entry.name,
-            file: item,
-            modified: s.mtime.toISOString(),
-            url: `/minds/${entry.name}/pages/${item}`
-          });
-        } else if (s.isDirectory()) {
-          const indexPath = resolve(fullPath, "index.html");
-          if (existsSync(indexPath)) {
-            const indexStat = statSync(indexPath);
-            pages.push({
-              mind: entry.name,
-              file: join(item, "index.html"),
-              modified: indexStat.mtime.toISOString(),
-              url: `/minds/${entry.name}/pages/${item}/`
-            });
-          }
-        }
-      } catch {
-      }
-    }
-  }
-  pages.sort((a, b) => new Date(b.modified).getTime() - new Date(a.modified).getTime());
-  return pages.slice(0, 10);
-}
-async function getCachedSites() {
-  if (!sitesCache) sitesCache = await buildSites();
-  return sitesCache;
-}
-async function getCachedRecentPages() {
-  if (!recentPagesCache) recentPagesCache = await buildRecentPages();
-  return recentPagesCache;
-}
-
-export {
-  startSystemWatcher,
-  startWatcher,
-  stopWatcher,
-  stopAllWatchers,
-  getCachedSites,
-  getCachedRecentPages
-};