volute 0.31.0 → 0.33.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/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 {
@@ -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

@@ -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> },
 ) {

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-HR5JKIDG.js

@@ -1,222 +0,0 @@
-#!/usr/bin/env node
-import {
-  logger_default
-} from "./chunk-YUIHSKR6.js";
-import {
-  mindDir,
-  readRegistry,
-  voluteHome
-} from "./chunk-X62AXPR7.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();
-        }, 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,
-  invalidateCache,
-  getCachedSites,
-  getCachedRecentPages
-};

package/dist/down-TS4XQBA4.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-import {
-  run,
-  stopDaemon
-} from "./chunk-BNC43CSY.js";
-import "./chunk-SNVPRRT7.js";
-import "./chunk-57OKQMP3.js";
-import "./chunk-X62AXPR7.js";
-import "./chunk-K3NQKI34.js";
-export {
-  run,
-  stopDaemon
-};

package/dist/message-delivery-UJHCLVU4.js

@@ -1,30 +0,0 @@
-#!/usr/bin/env node
-import {
-  deliverMessage,
-  recordInbound,
-  resolveSleepAction,
-  tagRecentInbound,
-  tagUntaggedInbound
-} from "./chunk-BWKIHH7B.js";
-import "./chunk-FAHDKPEH.js";
-import "./chunk-DAXJKPHZ.js";
-import "./chunk-AAO77TZX.js";
-import "./chunk-NOWVQ7AL.js";
-import "./chunk-R5QJBZZG.js";
-import "./chunk-EKDWA7E4.js";
-import "./chunk-S2TZLSDH.js";
-import "./chunk-NV3TYNWX.js";
-import "./chunk-PNQCXLSV.js";
-import "./chunk-YUIHSKR6.js";
-import "./chunk-57OKQMP3.js";
-import "./chunk-6QIUN46C.js";
-import "./chunk-A6TUJJ3L.js";
-import "./chunk-X62AXPR7.js";
-import "./chunk-K3NQKI34.js";
-export {
-  deliverMessage,
-  recordInbound,
-  resolveSleepAction,
-  tagRecentInbound,
-  tagUntaggedInbound
-};

package/dist/mind-manager-IPA6DZXD.js

@@ -1,26 +0,0 @@
-#!/usr/bin/env node
-import {
-  MindManager,
-  getMindManager,
-  initMindManager
-} from "./chunk-BWKIHH7B.js";
-import "./chunk-FAHDKPEH.js";
-import "./chunk-DAXJKPHZ.js";
-import "./chunk-AAO77TZX.js";
-import "./chunk-NOWVQ7AL.js";
-import "./chunk-R5QJBZZG.js";
-import "./chunk-EKDWA7E4.js";
-import "./chunk-S2TZLSDH.js";
-import "./chunk-NV3TYNWX.js";
-import "./chunk-PNQCXLSV.js";
-import "./chunk-YUIHSKR6.js";
-import "./chunk-57OKQMP3.js";
-import "./chunk-6QIUN46C.js";
-import "./chunk-A6TUJJ3L.js";
-import "./chunk-X62AXPR7.js";
-import "./chunk-K3NQKI34.js";
-export {
-  MindManager,
-  getMindManager,
-  initMindManager
-};

package/dist/pages-watcher-72OVPRMH.js

@@ -1,22 +0,0 @@
-#!/usr/bin/env node
-import {
-  getCachedRecentPages,
-  getCachedSites,
-  invalidateCache,
-  startSystemWatcher,
-  startWatcher,
-  stopAllWatchers,
-  stopWatcher
-} from "./chunk-HR5JKIDG.js";
-import "./chunk-YUIHSKR6.js";
-import "./chunk-X62AXPR7.js";
-import "./chunk-K3NQKI34.js";
-export {
-  getCachedRecentPages,
-  getCachedSites,
-  invalidateCache,
-  startSystemWatcher,
-  startWatcher,
-  stopAllWatchers,
-  stopWatcher
-};

package/dist/skills/sessions/SKILL.md

@@ -1,49 +0,0 @@
----
-name: Sessions
-description: This skill should be used when checking activity in other sessions, reading session logs, understanding cross-session context, or investigating what happened in another session. Covers "session activity", "other sessions", "session reader", "session log", "cross-session", "what happened in discord", "check session".
----
-
-# Cross-Session Awareness
-
-You can have multiple concurrent sessions (main, discord, email, etc.), each with its own conversation history stored as a JSONL file.
-
-## Automatic Updates
-
-When a message arrives, you automatically receive a brief summary of new activity in other sessions (if any). This appears as a `[Session Activity]` block showing what happened since your last check.
-
-## Listing Sessions
-
-To see which sessions are active:
-
-```sh
-ls ../.mind/sessions/       # claude template
-ls ../.mind/pi-sessions/    # pi template
-```
-
-## Reading a Session Log
-
-For a detailed view of what happened in another session, run the session reader script:
-
-```sh
-npx tsx .config/scripts/session-reader.ts <session-name> [--lines N]
-```
-
-- `session-name`: The session to inspect (e.g., `discord`, `main`, `email`)
-- `--lines N`: Number of recent entries to show (default: 50)
-
-### Output Format
-
-The reader shows a chronological log with:
-- **User messages**: Full text of what was sent
-- **Assistant text**: Full text of your responses
-- **Tool uses**: `[ToolName primary-arg]` format (e.g., `[Edit home/MEMORY.md]`, `[Bash npm test]`)
-- **Timestamps** on each entry
-
-Thinking blocks, tool result content, and metadata entries are omitted for readability.
-
-## When to Use This
-
-- When you receive a `[Session Activity]` summary and want more detail
-- When you want to understand what happened in another session before responding
-- When coordinating work across multiple sessions
-- When a user references something from a different channel

package/dist/sleep-manager-TPS6OGCA.js

@@ -1,30 +0,0 @@
-#!/usr/bin/env node
-import {
-  SleepManager,
-  getSleepManager,
-  getSleepManagerIfReady,
-  initSleepManager,
-  matchesGlob
-} from "./chunk-BWKIHH7B.js";
-import "./chunk-FAHDKPEH.js";
-import "./chunk-DAXJKPHZ.js";
-import "./chunk-AAO77TZX.js";
-import "./chunk-NOWVQ7AL.js";
-import "./chunk-R5QJBZZG.js";
-import "./chunk-EKDWA7E4.js";
-import "./chunk-S2TZLSDH.js";
-import "./chunk-NV3TYNWX.js";
-import "./chunk-PNQCXLSV.js";
-import "./chunk-YUIHSKR6.js";
-import "./chunk-57OKQMP3.js";
-import "./chunk-6QIUN46C.js";
-import "./chunk-A6TUJJ3L.js";
-import "./chunk-X62AXPR7.js";
-import "./chunk-K3NQKI34.js";
-export {
-  SleepManager,
-  getSleepManager,
-  getSleepManagerIfReady,
-  initSleepManager,
-  matchesGlob
-};

package/dist/system-chat-B43GIXQU.js

@@ -1,30 +0,0 @@
-#!/usr/bin/env node
-import {
-  ensureSystemDM,
-  generateSystemReply,
-  resetSystemDMCache,
-  sendSystemMessage,
-  sendSystemMessageDirect
-} from "./chunk-BWKIHH7B.js";
-import "./chunk-FAHDKPEH.js";
-import "./chunk-DAXJKPHZ.js";
-import "./chunk-AAO77TZX.js";
-import "./chunk-NOWVQ7AL.js";
-import "./chunk-R5QJBZZG.js";
-import "./chunk-EKDWA7E4.js";
-import "./chunk-S2TZLSDH.js";
-import "./chunk-NV3TYNWX.js";
-import "./chunk-PNQCXLSV.js";
-import "./chunk-YUIHSKR6.js";
-import "./chunk-57OKQMP3.js";
-import "./chunk-6QIUN46C.js";
-import "./chunk-A6TUJJ3L.js";
-import "./chunk-X62AXPR7.js";
-import "./chunk-K3NQKI34.js";
-export {
-  ensureSystemDM,
-  generateSystemReply,
-  resetSystemDMCache,
-  sendSystemMessage,
-  sendSystemMessageDirect
-};

package/dist/up-TDXEP3VA.js

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-import {
-  run
-} from "./chunk-HDKY4TWU.js";
-import "./chunk-SNVPRRT7.js";
-import "./chunk-57OKQMP3.js";
-import {
-  readGlobalConfig
-} from "./chunk-6QIUN46C.js";
-import "./chunk-D424ZQGI.js";
-import "./chunk-X62AXPR7.js";
-import "./chunk-K3NQKI34.js";
-export {
-  readGlobalConfig,
-  run
-};