volute 0.4.0 → 0.6.0

package/templates/agent-sdk/src/server.ts

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, renameSync } from "node:fs";
+import { existsSync, mkdirSync, renameSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { createAgent } from "./agent.js";
 import { createFileHandlerResolver } from "./lib/file-handler.js";
@@ -41,13 +41,19 @@ const agent = createAgent({
   onIdentityReload: async () => {
     log("server", "identity file changed — restarting to reload");
     await agent.waitForCommits();
+    // Signal daemon to restart immediately (bypasses crash backoff)
+    try {
+      writeFileSync(resolve(".volute/restart.json"), JSON.stringify({ action: "reload" }));
+    } catch (err) {
+      log("server", "failed to write restart signal:", err);
+    }
     server.close();
     process.exit(0);
   },
 });
 
 const router = createRouter({
-  configPath: resolve("home/.config/sessions.json"),
+  configPath: resolve("home/.config/routes.json"),
   agentHandler: agent.resolve,
   fileHandler: createFileHandlerResolver(resolve("home")),
 });

package/templates/agent-sdk/volute-template.json

@@ -4,6 +4,6 @@
     "biome.json.tmpl": "biome.json",
     "home/.config/volute.json.tmpl": "home/.config/volute.json"
   },
-  "substitute": ["package.json", ".init/SOUL.md"],
+  "substitute": ["package.json", ".init/SOUL.md", "home/.config/routes.json"],
   "skillsDir": "home/.claude/skills"
 }

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

@@ -0,0 +1,5 @@
+{
+  "gateUnmatched": true,
+  "rules": [{ "channel": "volute:*", "isDM": true, "session": "${channel}" }],
+  "default": "main"
+}

package/templates/pi/.init/AGENTS.md

@@ -23,7 +23,7 @@ See the **memory** skill for detailed guidance.
 
 ## Sessions
 
-- You may have **multiple named sessions** — each maintains its own conversation history. See `VOLUTE.md` for how to configure session routing via `.config/sessions.json`.
+- You may have **multiple named sessions** — each maintains its own conversation history. See `VOLUTE.md` for how to configure session routing via `.config/routes.json`.
 - Your conversation may be **resumed** from a previous session — orient yourself by reading recent daily logs if needed.
 - On a **fresh session**, read `MEMORY.md` and recent daily logs to remember where you left off.
 - On **compaction**, update today's daily log to preserve context before the conversation is trimmed.

package/templates/pi/src/agent.ts

@@ -11,6 +11,7 @@ import {
 } from "@mariozechner/pi-coding-agent";
 import { commitFileChange } from "./lib/auto-commit.js";
 import { log, logText, logThinking, logToolResult, logToolUse } from "./lib/logger.js";
+import { createSessionContextExtension } from "./lib/session-context-extension.js";
 import type {
   HandlerMeta,
   HandlerResolver,
@@ -32,8 +33,10 @@ type PiSession = {
   currentMessageId?: string;
 };
 
-const DEFAULT_COMPACTION_MESSAGE =
-  "Your conversation is approaching its context limit. Please update today's journal entry to preserve important context before the conversation is compacted.";
+function defaultCompactionMessage(): string {
+  const today = new Date().toISOString().slice(0, 10);
+  return `Context is getting long — compaction is about to summarize this conversation. Before that happens, save anything important to files (MEMORY.md, memory/journal/${today}.md, etc.) since those survive compaction. Focus on: decisions made, open tasks, and anything you'd need to pick up where you left off.`;
+}
 
 function resolveModel(modelStr: string) {
   const [provider, ...rest] = modelStr.split(":");
@@ -75,7 +78,7 @@ export function createAgent(options: {
   compactionMessage?: string;
 }): { resolve: HandlerResolver } {
   const sessions = new Map<string, PiSession>();
-  const compactionMessage = options.compactionMessage ?? DEFAULT_COMPACTION_MESSAGE;
+  const compactionMessage = options.compactionMessage ?? defaultCompactionMessage();
 
   // Shared setup (created once)
   const modelStr = options.model || process.env.PI_MODEL || "anthropic:claude-sonnet-4-20250514";
@@ -135,11 +138,16 @@ export function createAgent(options: {
       retry: { enabled: true, maxRetries: 3 },
     });
 
+    const sessionContextExtension = createSessionContextExtension({
+      currentSession: session.name,
+      cwd: options.cwd,
+    });
+
     const resourceLoader = new DefaultResourceLoader({
       cwd: options.cwd,
       settingsManager,
       systemPrompt: options.systemPrompt,
-      extensionFactories: [preCompactExtension],
+      extensionFactories: [preCompactExtension, sessionContextExtension],
     });
     await resourceLoader.reload();
 

package/templates/pi/src/lib/session-context-extension.ts

@@ -0,0 +1,33 @@
+import { resolve } from "node:path";
+import type { ExtensionFactory } from "@mariozechner/pi-coding-agent";
+import { getSessionUpdates, resolvePiJsonl } from "./session-monitor.js";
+
+export function createSessionContextExtension(options: {
+  currentSession: string;
+  cwd: string;
+}): ExtensionFactory {
+  return (pi) => {
+    pi.on("before_agent_start", () => {
+      try {
+        const sessionsDir = resolve(options.cwd, ".volute/pi-sessions");
+        const summary = getSessionUpdates({
+          currentSession: options.currentSession,
+          sessionsDir,
+          cursorFile: resolve(options.cwd, ".volute/session-cursors.json"),
+          jsonlResolver: (name) => resolvePiJsonl(sessionsDir, name),
+          format: "pi",
+        });
+        if (!summary) return {};
+        return {
+          message: {
+            customType: "session-update",
+            content: summary,
+            display: true,
+          },
+        };
+      } catch {
+        return {};
+      }
+    });
+  };
+}

package/templates/pi/src/server.ts

@@ -29,7 +29,7 @@ const agent = createAgent({
 });
 
 const router = createRouter({
-  configPath: resolve("home/.config/sessions.json"),
+  configPath: resolve("home/.config/routes.json"),
   agentHandler: agent.resolve,
   fileHandler: createFileHandlerResolver(resolve("home")),
 });

package/templates/pi/volute-template.json

@@ -4,6 +4,6 @@
     "biome.json.tmpl": "biome.json",
     "home/.config/volute.json.tmpl": "home/.config/volute.json"
   },
-  "substitute": ["package.json", ".init/SOUL.md"],
+  "substitute": ["package.json", ".init/SOUL.md", "home/.config/routes.json"],
   "skillsDir": "home/.claude/skills"
 }

package/dist/channel-DQ6UY7QB.js

@@ -1,67 +0,0 @@
-#!/usr/bin/env node
-import {
-  resolveAgentName
-} from "./chunk-VRVVQIYY.js";
-import {
-  getChannelDriver
-} from "./chunk-5OCWMTVS.js";
-import {
-  loadMergedEnv
-} from "./chunk-DNOXHLE5.js";
-import {
-  parseArgs
-} from "./chunk-D424ZQGI.js";
-import {
-  resolveAgent
-} from "./chunk-3C2XR4IY.js";
-import "./chunk-K3NQKI34.js";
-
-// src/commands/channel.ts
-async function run(args) {
-  const { positional, flags } = parseArgs(args, {
-    agent: { type: "string" },
-    limit: { type: "number" }
-  });
-  const subcommand = positional[0];
-  const uri = positional[1];
-  const message = positional[2];
-  if (!subcommand || !uri || subcommand === "send" && !message) {
-    console.error(`Usage:
-  volute channel read <channel-uri> [--limit N] [--agent <name>]
-  volute channel send <channel-uri> "<message>" [--agent <name>]`);
-    process.exit(1);
-  }
-  const agentName = resolveAgentName(flags);
-  const colonIdx = uri.indexOf(":");
-  if (colonIdx === -1) {
-    console.error(`Invalid channel URI: ${uri} (expected format: platform:id)`);
-    process.exit(1);
-  }
-  const platform = uri.slice(0, colonIdx);
-  const channelId = uri.slice(colonIdx + 1);
-  const driver = getChannelDriver(platform);
-  if (!driver) {
-    console.error(`No channel driver for platform: ${platform}`);
-    process.exit(1);
-  }
-  const { dir } = resolveAgent(agentName);
-  const env = loadMergedEnv(dir);
-  try {
-    if (subcommand === "read") {
-      const limit = flags.limit ?? 20;
-      const output = await driver.read(env, channelId, limit);
-      console.log(output);
-    } else if (subcommand === "send") {
-      await driver.send(env, channelId, message);
-    } else {
-      console.error(`Unknown subcommand: ${subcommand}`);
-      process.exit(1);
-    }
-  } catch (err) {
-    console.error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
-  }
-}
-export {
-  run
-};

package/dist/chunk-5OCWMTVS.js

@@ -1,152 +0,0 @@
-#!/usr/bin/env node
-import {
-  __export
-} from "./chunk-K3NQKI34.js";
-
-// src/lib/channels/discord.ts
-var discord_exports = {};
-__export(discord_exports, {
-  read: () => read,
-  send: () => send
-});
-var API_BASE = "https://discord.com/api/v10";
-function requireToken(env) {
-  const token = env.DISCORD_TOKEN;
-  if (!token) throw new Error("DISCORD_TOKEN not set");
-  return token;
-}
-async function read(env, channelId, limit) {
-  const token = requireToken(env);
-  const res = await fetch(`${API_BASE}/channels/${channelId}/messages?limit=${limit}`, {
-    headers: { Authorization: `Bot ${token}` }
-  });
-  if (!res.ok) {
-    throw new Error(`Discord API error: ${res.status} ${res.statusText}`);
-  }
-  const messages = await res.json();
-  return messages.reverse().map((m) => `${m.author.username}: ${m.content}`).join("\n");
-}
-async function send(env, channelId, message) {
-  const token = requireToken(env);
-  const res = await fetch(`${API_BASE}/channels/${channelId}/messages`, {
-    method: "POST",
-    headers: {
-      Authorization: `Bot ${token}`,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({ content: message })
-  });
-  if (!res.ok) {
-    throw new Error(`Discord API error: ${res.status} ${res.statusText}`);
-  }
-}
-
-// src/lib/channels/slack.ts
-var slack_exports = {};
-__export(slack_exports, {
-  read: () => read2,
-  send: () => send2
-});
-var API_BASE2 = "https://slack.com/api";
-function requireToken2(env) {
-  const token = env.SLACK_BOT_TOKEN;
-  if (!token) throw new Error("SLACK_BOT_TOKEN not set");
-  return token;
-}
-async function slackApi(token, method, body) {
-  const res = await fetch(`${API_BASE2}/${method}`, {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify(body)
-  });
-  if (!res.ok) {
-    throw new Error(`Slack API HTTP error: ${res.status} ${res.statusText}`);
-  }
-  const data = await res.json();
-  if (!data.ok) {
-    throw new Error(`Slack API error: ${data.error}`);
-  }
-  return data;
-}
-async function read2(env, channelId, limit) {
-  const token = requireToken2(env);
-  const data = await slackApi(token, "conversations.history", {
-    channel: channelId,
-    limit
-  });
-  return data.messages.reverse().map((m) => `${m.user ?? m.bot_id ?? "unknown"}: ${m.text}`).join("\n");
-}
-async function send2(env, channelId, message) {
-  const token = requireToken2(env);
-  await slackApi(token, "chat.postMessage", {
-    channel: channelId,
-    text: message
-  });
-}
-
-// src/lib/channels/telegram.ts
-var telegram_exports = {};
-__export(telegram_exports, {
-  read: () => read3,
-  send: () => send3
-});
-var API_BASE3 = "https://api.telegram.org";
-function requireToken3(env) {
-  const token = env.TELEGRAM_BOT_TOKEN;
-  if (!token) throw new Error("TELEGRAM_BOT_TOKEN not set");
-  return token;
-}
-async function read3(_env, _channelId, _limit) {
-  throw new Error(
-    "Telegram Bot API does not support reading chat history. Use volute channel send instead."
-  );
-}
-async function send3(env, chatId, message) {
-  const token = requireToken3(env);
-  const res = await fetch(`${API_BASE3}/bot${token}/sendMessage`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ chat_id: chatId, text: message })
-  });
-  if (!res.ok) {
-    const body = await res.text().catch(() => "");
-    throw new Error(`Telegram API error: ${res.status} ${body}`);
-  }
-}
-
-// src/lib/channels.ts
-var CHANNELS = {
-  web: { name: "web", displayName: "Web UI", showToolCalls: true },
-  discord: {
-    name: "discord",
-    displayName: "Discord",
-    showToolCalls: false,
-    driver: discord_exports
-  },
-  slack: {
-    name: "slack",
-    displayName: "Slack",
-    showToolCalls: false,
-    driver: slack_exports
-  },
-  telegram: {
-    name: "telegram",
-    displayName: "Telegram",
-    showToolCalls: false,
-    driver: telegram_exports
-  },
-  cli: { name: "cli", displayName: "CLI", showToolCalls: true },
-  agent: { name: "agent", displayName: "Agent", showToolCalls: true },
-  system: { name: "system", displayName: "System", showToolCalls: false }
-};
-function getChannelDriver(platform) {
-  return CHANNELS[platform]?.driver ?? null;
-}
-
-export {
-  CHANNELS,
-  getChannelDriver
-};

package/dist/chunk-ZHCE4DPY.js

@@ -1,110 +0,0 @@
-#!/usr/bin/env node
-
-// src/lib/format-tool.ts
-function summarizeTool(name, input) {
-  if (input && typeof input === "object") {
-    const args = input;
-    const val = args.path ?? args.command ?? args.query ?? args.url;
-    if (typeof val === "string") {
-      const brief = val.length > 60 ? `${val.slice(0, 57)}...` : val;
-      return `[${name} ${brief}]`;
-    }
-  }
-  return `[${name}]`;
-}
-function collectPart(event) {
-  if (event.type === "text") return event.content ?? "";
-  if (event.type === "tool_use") return summarizeTool(event.name ?? "", event.input);
-  return null;
-}
-
-// src/lib/log-buffer.ts
-var LogBuffer = class {
-  entries = [];
-  maxSize = 1e3;
-  subscribers = /* @__PURE__ */ new Set();
-  append(entry) {
-    this.entries.push(entry);
-    if (this.entries.length > this.maxSize) {
-      this.entries.shift();
-    }
-    for (const sub of this.subscribers) {
-      sub(entry);
-    }
-  }
-  getEntries() {
-    return [...this.entries];
-  }
-  subscribe(fn) {
-    this.subscribers.add(fn);
-    return () => this.subscribers.delete(fn);
-  }
-};
-var logBuffer = new LogBuffer();
-
-// src/lib/logger.ts
-function write(level, msg, data) {
-  const entry = {
-    level,
-    msg,
-    ts: (/* @__PURE__ */ new Date()).toISOString(),
-    ...data ? { data } : {}
-  };
-  const line = JSON.stringify(entry);
-  process.stderr.write(`${line}
-`);
-  logBuffer.append(entry);
-}
-var log = {
-  info: (msg, data) => write("info", msg, data),
-  warn: (msg, data) => write("warn", msg, data),
-  error: (msg, data) => write("error", msg, data)
-};
-var logger_default = log;
-
-// src/lib/ndjson.ts
-var MAX_BUFFER_SIZE = 1e6;
-async function* readNdjson(body) {
-  const reader = body.getReader();
-  const decoder = new TextDecoder();
-  let buffer = "";
-  try {
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      buffer += decoder.decode(value, { stream: true });
-      if (buffer.length > MAX_BUFFER_SIZE) {
-        logger_default.warn("ndjson: buffer exceeded 1MB, resetting");
-        buffer = "";
-        continue;
-      }
-      const lines = buffer.split("\n");
-      buffer = lines.pop() || "";
-      for (const line of lines) {
-        if (!line.trim()) continue;
-        try {
-          yield JSON.parse(line);
-        } catch {
-          logger_default.warn("ndjson: skipping invalid line", { line: line.slice(0, 100) });
-        }
-      }
-    }
-    if (buffer.trim()) {
-      try {
-        yield JSON.parse(buffer);
-      } catch {
-        logger_default.warn("ndjson: skipping invalid line", { line: buffer.slice(0, 100) });
-      }
-    }
-  } finally {
-    reader.releaseLock();
-  }
-}
-
-export {
-  summarizeTool,
-  collectPart,
-  logBuffer,
-  logger_default,
-  readNdjson
-};

package/dist/create-ILVOG75A.js

@@ -1,79 +0,0 @@
-#!/usr/bin/env node
-import {
-  applyInitFiles,
-  composeTemplate,
-  copyTemplateToDir,
-  findTemplatesRoot
-} from "./chunk-GSPKUPKU.js";
-import {
-  exec,
-  execInherit
-} from "./chunk-5SKQ6J7T.js";
-import {
-  parseArgs
-} from "./chunk-D424ZQGI.js";
-import {
-  chownAgentDir,
-  createAgentUser,
-  ensureVoluteGroup
-} from "./chunk-SOZA2TLP.js";
-import {
-  addAgent,
-  agentDir,
-  ensureVoluteHome,
-  nextPort
-} from "./chunk-3C2XR4IY.js";
-import "./chunk-K3NQKI34.js";
-
-// src/commands/create.ts
-import { existsSync, rmSync } from "fs";
-async function run(args) {
-  const { positional, flags } = parseArgs(args, {
-    template: { type: "string" }
-  });
-  const name = positional[0];
-  const template = flags.template ?? "agent-sdk";
-  if (!name) {
-    console.error("Usage: volute create <name> [--template <name>]");
-    process.exit(1);
-  }
-  ensureVoluteHome();
-  const dest = agentDir(name);
-  if (existsSync(dest)) {
-    console.error(`Agent already exists: ${name}`);
-    process.exit(1);
-  }
-  const templatesRoot = findTemplatesRoot();
-  const { composedDir, manifest } = composeTemplate(templatesRoot, template);
-  try {
-    copyTemplateToDir(composedDir, dest, name, manifest);
-    applyInitFiles(dest);
-  } finally {
-    rmSync(composedDir, { recursive: true, force: true });
-  }
-  const port = nextPort();
-  addAgent(name, port);
-  console.log("Installing dependencies...");
-  await execInherit("npm", ["install"], { cwd: dest });
-  try {
-    await exec("git", ["init"], { cwd: dest });
-    await exec("git", ["add", "-A"], { cwd: dest });
-    await exec("git", ["commit", "-m", "initial commit"], { cwd: dest });
-  } catch {
-    console.warn(
-      "\nWarning: git init failed (git may not be installed or configured).",
-      "\nThe agent will work, but forking/variants won't be available.",
-      "\nTo fix: install git and run `git config --global user.name` / `git config --global user.email`"
-    );
-  }
-  ensureVoluteGroup();
-  createAgentUser(name);
-  chownAgentDir(dest, name);
-  console.log(`
-Created agent: ${name} (port ${port})`);
-  console.log(`
-  volute start ${name}`);
-}
-export {
-  run
-};

package/dist/send-3U6OTKG7.js

@@ -1,57 +0,0 @@
-#!/usr/bin/env node
-import {
-  readNdjson,
-  summarizeTool
-} from "./chunk-ZHCE4DPY.js";
-import {
-  daemonFetch
-} from "./chunk-YGFIWIOF.js";
-import "./chunk-3C2XR4IY.js";
-import "./chunk-K3NQKI34.js";
-
-// src/commands/send.ts
-import { userInfo } from "os";
-async function run(args) {
-  const name = args[0];
-  const message = args[1];
-  if (!name || !message) {
-    console.error('Usage: volute send <name> "<message>"');
-    process.exit(1);
-  }
-  const agentSelf = process.env.VOLUTE_AGENT;
-  const sender = agentSelf || userInfo().username;
-  const channel = agentSelf ? "agent" : "cli";
-  const res = await daemonFetch(`/api/agents/${encodeURIComponent(name)}/message`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      content: [{ type: "text", text: message }],
-      channel,
-      sender
-    })
-  });
-  if (!res.ok) {
-    const data = await res.json();
-    console.error(data.error ?? `Failed to send message: ${res.status}`);
-    process.exit(1);
-  }
-  if (!res.body) {
-    console.error("No response body");
-    process.exit(1);
-  }
-  for await (const event of readNdjson(res.body)) {
-    if (event.type === "text") {
-      process.stdout.write(event.content);
-    } else if (event.type === "tool_use") {
-      process.stderr.write(`${summarizeTool(event.name, event.input)}
-`);
-    }
-    if (event.type === "done") {
-      break;
-    }
-  }
-  process.stdout.write("\n");
-}
-export {
-  run
-};