volute 0.39.0 → 0.40.1

package/templates/_base/src/lib/volute-server.ts

@@ -120,12 +120,17 @@ export type ContextInfo = {
   systemPrompt: number;
 };
 
+export type { ContextBlock, ContextMessage, ContextMessages } from "./context-breakdown.js";
+
+import type { ContextMessages } from "./context-breakdown.js";
+
 export function createVoluteServer(options: {
   router: Router;
   port: number;
   name: string;
   version: string;
   getContextInfo?: () => ContextInfo | Promise<ContextInfo>;
+  getContextMessages?: () => ContextMessages | Promise<ContextMessages>;
 }): Server {
   const { router, port, name, version } = options;
 
@@ -162,6 +167,24 @@ export function createVoluteServer(options: {
       return;
     }
 
+    if (req.method === "GET" && url.pathname === "/context/messages") {
+      if (!options.getContextMessages) {
+        res.writeHead(404);
+        res.end("Not Found");
+        return;
+      }
+      try {
+        const messages = await options.getContextMessages();
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(JSON.stringify(messages));
+      } catch (err) {
+        log("server", "error in /context/messages:", err);
+        res.writeHead(500);
+        res.end("Internal Server Error");
+      }
+      return;
+    }
+
     if (req.method === "POST" && url.pathname === "/message") {
       try {
         const body = JSON.parse(await readBody(req)) as VoluteRequest;

package/templates/claude/package.json.tmpl

@@ -9,13 +9,13 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.89",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.185",
     "@anthropic-ai/tokenizer": "^0.0.4",
-    "tsx": "^4.21.0"
+    "tsx": "^4.22.4"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.10",
-    "@types/node": "^25.5.0",
-    "typescript": "^6.0.2"
+    "@biomejs/biome": "2.5.0",
+    "@types/node": "^26.0.0",
+    "typescript": "^6.0.3"
   }
 }

package/templates/claude/src/agent.ts

@@ -8,7 +8,9 @@ import {
   countSkillDescriptionTokens,
   countSystemPromptTokens,
   findClaudeSessionFile,
-  parseClaudeSessionJSONL,
+  processClaudeSession,
+  readSdkInstructions,
+  readSkillDescriptions,
 } from "./lib/context-breakdown.js";
 import { daemonEmit } from "./lib/daemon-client.js";
 import { runHooks } from "./lib/hook-loader.js";
@@ -30,7 +32,7 @@ import type {
   VoluteContentPart,
   VoluteEvent,
 } from "./lib/types.js";
-import type { ContextInfo } from "./lib/volute-server.js";
+import type { ContextInfo, ContextMessages } from "./lib/volute-server.js";
 
 type Session = {
   name: string;
@@ -60,6 +62,7 @@ export function createMind(options: {
   resolve: HandlerResolver;
   waitForCommits: () => Promise<void>;
   getContextInfo: () => ContextInfo;
+  getContextMessages: () => ContextMessages;
 } {
   const autoCommit = createAutoCommitHook(options.cwd);
   const identityReload = createIdentityReloadHook(options.cwd);
@@ -369,6 +372,17 @@ export function createMind(options: {
         });
       }
 
+      /**
+       * Tell the daemon this turn failed so it can record a notice for the mind's next
+       * successful turn. Awaited before emitDone so the daemon flags the session errored
+       * (and thus won't mark notices delivered) before the done arrives.
+       */
+      async function emitError(err: unknown) {
+        await daemonEmit({ type: "error", session: session.name, content: String(err) }).catch(
+          (e) => log("mind", `session "${session.name}": failed to emit error to daemon:`, e),
+        );
+      }
+
       async function runStream(resume?: string) {
         const q = createStream(session, streamAbort, preCompact.hook, resume);
         session.currentQuery = q;
@@ -428,11 +442,13 @@ export function createMind(options: {
             await runStream();
           } catch (retryErr) {
             log("mind", `session "${session.name}": stream consumer error:`, retryErr);
+            await emitError(retryErr);
             emitDone();
             sessions.delete(session.name);
           }
         } else {
           log("mind", `session "${session.name}": stream consumer error:`, err);
+          await emitError(err);
           emitDone();
           sessions.delete(session.name);
         }
@@ -543,26 +559,24 @@ export function createMind(options: {
   const claudeMdTokens = countSdkInstructionTokens(options.cwd);
   const skillDescTokens = countSkillDescriptionTokens([resolvePath(options.cwd, ".claude/skills")]);
 
+  function processSession(sessionName: string) {
+    const sessionId = sessionStore.load(sessionName);
+    const jsonlPath = sessionId ? findClaudeSessionFile(options.cwd, sessionId) : null;
+    return jsonlPath
+      ? processClaudeSession(jsonlPath, systemPromptTokens, claudeMdTokens, skillDescTokens)
+      : null;
+  }
+
   function getContextInfo(): ContextInfo {
     return {
       sessions: Array.from(sessions.values()).map((s) => {
         try {
-          const sessionId = sessionStore.load(s.name);
-          const jsonlPath = sessionId ? findClaudeSessionFile(options.cwd, sessionId) : null;
-          const parsed = jsonlPath
-            ? parseClaudeSessionJSONL(
-                jsonlPath,
-                systemPromptTokens,
-                claudeMdTokens,
-                skillDescTokens,
-              )
-            : null;
-
+          const result = processSession(s.name);
           return {
             name: s.name,
-            contextTokens: parsed?.contextTokens ?? s.contextTokens,
+            contextTokens: result?.parsed?.contextTokens ?? s.contextTokens,
             contextWindow: maxContextTokens,
-            breakdown: parsed?.breakdown,
+            breakdown: result?.parsed?.breakdown,
           };
         } catch (err) {
           log("mind", `failed to get context breakdown for session "${s.name}":`, err);
@@ -573,5 +587,29 @@ export function createMind(options: {
     };
   }
 
-  return { resolve, waitForCommits: autoCommit.waitForCommits, getContextInfo };
+  function getContextMessages(): ContextMessages {
+    const skillsDir = resolvePath(options.cwd, ".claude/skills");
+    return {
+      preamble: {
+        systemPrompt: options.systemPrompt,
+        sdkInstructions: readSdkInstructions(options.cwd),
+        skillDescriptions: readSkillDescriptions([skillsDir]),
+      },
+      sessions: Array.from(sessions.values()).map((s) => {
+        try {
+          const result = processSession(s.name);
+          return { name: s.name, messages: result?.messages ?? [] };
+        } catch (err) {
+          log("mind", `failed to extract messages for session "${s.name}":`, err);
+          return { name: s.name, messages: [] };
+        }
+      }),
+    };
+  }
+
+  // Pre-warm the main session so the SDK subprocess starts immediately
+  // instead of waiting for the first message (which adds minutes of latency).
+  getOrCreateSession("main");
+
+  return { resolve, waitForCommits: autoCommit.waitForCommits, getContextInfo, getContextMessages };
 }

package/templates/claude/src/server.ts

@@ -53,6 +53,7 @@ const server = createVoluteServer({
   name: pkg.name,
   version: pkg.version,
   getContextInfo: mind.getContextInfo,
+  getContextMessages: mind.getContextMessages,
 });
 
 server.listen(port, () => {

package/templates/codex/package.json.tmpl

@@ -10,12 +10,12 @@
   },
   "dependencies": {
     "@anthropic-ai/tokenizer": "^0.0.4",
-    "@openai/codex-sdk": "^0.115.0",
-    "tsx": "^4.21.0"
+    "@openai/codex-sdk": "^0.141.0",
+    "tsx": "^4.22.4"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.10",
-    "@types/node": "^25.5.0",
-    "typescript": "^6.0.2"
+    "@biomejs/biome": "2.5.0",
+    "@types/node": "^26.0.0",
+    "typescript": "^6.0.3"
   }
 }

package/templates/codex/src/agent.ts

@@ -8,7 +8,9 @@ import {
   countSkillDescriptionTokens,
   countSystemPromptTokens,
   findCodexSessionFile,
-  parseCodexSessionJSONL,
+  processCodexSession,
+  readSdkInstructions,
+  readSkillDescriptions,
 } from "./lib/context-breakdown.js";
 import { daemonEmit, daemonRestart, type EventType } from "./lib/daemon-client.js";
 import { runHooks } from "./lib/hook-loader.js";
@@ -24,7 +26,7 @@ import type {
   VoluteContentPart,
   VoluteEvent,
 } from "./lib/types.js";
-import type { ContextInfo } from "./lib/volute-server.js";
+import type { ContextInfo, ContextMessages } from "./lib/volute-server.js";
 
 /** Minimal interface for a Codex SDK thread — typed to the methods we actually use */
 type CodexThread = {
@@ -73,7 +75,11 @@ export function createMind(options: {
   model?: string;
   reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh";
   maxContextTokens?: number;
-}): { resolve: HandlerResolver; getContextInfo: () => ContextInfo } {
+}): {
+  resolve: HandlerResolver;
+  getContextInfo: () => ContextInfo;
+  getContextMessages: () => ContextMessages;
+} {
   const sessions = new Map<string, CodexSession>();
   const prompts = loadPrompts();
   const maxContextTokens = options.maxContextTokens;
@@ -599,21 +605,24 @@ export function createMind(options: {
   const claudeMdTokens = countSdkInstructionTokens(options.cwd);
   const skillDescTokens = countSkillDescriptionTokens([resolvePath(options.cwd, ".agents/skills")]);
 
+  function processSession(sessionName: string) {
+    const threadId = sessionStore.load(sessionName);
+    const jsonlPath = threadId ? findCodexSessionFile(threadId, options.mindDir) : null;
+    return jsonlPath
+      ? processCodexSession(jsonlPath, systemPromptTokens, claudeMdTokens, skillDescTokens)
+      : null;
+  }
+
   function getContextInfo(): ContextInfo {
     return {
       sessions: Array.from(sessions.values()).map((s) => {
         try {
-          const threadId = sessionStore.load(s.name);
-          const jsonlPath = threadId ? findCodexSessionFile(threadId) : null;
-          const parsed = jsonlPath
-            ? parseCodexSessionJSONL(jsonlPath, systemPromptTokens, claudeMdTokens, skillDescTokens)
-            : null;
-
+          const result = processSession(s.name);
           return {
             name: s.name,
-            contextTokens: parsed?.contextTokens ?? s.cumulativeInputTokens,
+            contextTokens: result?.parsed?.contextTokens ?? s.cumulativeInputTokens,
             contextWindow: maxContextTokens,
-            breakdown: parsed?.breakdown,
+            breakdown: result?.parsed?.breakdown,
           };
         } catch (err) {
           log("mind", `failed to get context breakdown for session "${s.name}":`, err);
@@ -628,5 +637,29 @@ export function createMind(options: {
     };
   }
 
-  return { resolve, getContextInfo };
+  function getContextMessages(): ContextMessages {
+    const skillsDir = resolvePath(options.cwd, ".agents/skills");
+    return {
+      preamble: {
+        systemPrompt: options.systemPrompt,
+        sdkInstructions: readSdkInstructions(options.cwd),
+        skillDescriptions: readSkillDescriptions([skillsDir]),
+      },
+      sessions: Array.from(sessions.values()).map((s) => {
+        try {
+          const result = processSession(s.name);
+          return { name: s.name, messages: result?.messages ?? [] };
+        } catch (err) {
+          log("mind", `failed to extract messages for session "${s.name}":`, err);
+          return { name: s.name, messages: [] };
+        }
+      }),
+    };
+  }
+
+  // Pre-warm the main session so the thread is created immediately
+  // instead of waiting for the first message.
+  getOrCreateSession("main");
+
+  return { resolve, getContextInfo, getContextMessages };
 }

package/templates/codex/src/server.ts

@@ -45,6 +45,7 @@ const server = createVoluteServer({
   name: pkg.name,
   version: pkg.version,
   getContextInfo: mind.getContextInfo,
+  getContextMessages: mind.getContextMessages,
 });
 
 server.listen(port, async () => {

package/templates/pi/package.json.tmpl

@@ -10,13 +10,13 @@
   },
   "dependencies": {
     "@anthropic-ai/tokenizer": "^0.0.4",
-    "@mariozechner/pi-coding-agent": "^0.64.0",
-    "@sinclair/typebox": "^0.34.0",
-    "tsx": "^4.21.0"
+    "@mariozechner/pi-coding-agent": "^0.73.1",
+    "@sinclair/typebox": "^0.34.49",
+    "tsx": "^4.22.4"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.10",
-    "@types/node": "^25.5.0",
-    "typescript": "^6.0.2"
+    "@biomejs/biome": "2.5.0",
+    "@types/node": "^26.0.0",
+    "typescript": "^6.0.3"
   }
 }

package/templates/pi/src/agent.ts

@@ -1,10 +1,11 @@
-import { readFileSync } from "node:fs";
+import { readFileSync, watchFile } from "node:fs";
 import { resolve as resolvePath } from "node:path";
 import {
   AuthStorage,
   createAgentSession,
   DefaultResourceLoader,
   type ExtensionFactory,
+  getAgentDir,
   ModelRegistry,
   SessionManager,
   SettingsManager,
@@ -15,8 +16,11 @@ import {
   countSkillDescriptionTokens,
   countSystemPromptTokens,
   findPiSessionFile,
-  parsePiSessionJSONL,
+  processPiSession,
+  readSdkInstructions,
+  readSkillDescriptions,
 } from "./lib/context-breakdown.js";
+import { daemonEmit } from "./lib/daemon-client.js";
 import { createEventHandler, emit } from "./lib/event-handler.js";
 import { runHooks } from "./lib/hook-loader.js";
 import { log } from "./lib/logger.js";
@@ -32,7 +36,7 @@ import type {
   VoluteContentPart,
   VoluteEvent,
 } from "./lib/types.js";
-import type { ContextInfo } from "./lib/volute-server.js";
+import type { ContextInfo, ContextMessages } from "./lib/volute-server.js";
 
 type PiAgentSession = Awaited<ReturnType<typeof createAgentSession>>["session"];
 
@@ -57,7 +61,11 @@ export function createMind(options: {
   compactionMessage?: string;
   maxContextTokens?: number;
   subagents?: Record<string, SubagentConfig>;
-}): { resolve: HandlerResolver; getContextInfo: () => ContextInfo } {
+}): {
+  resolve: HandlerResolver;
+  getContextInfo: () => ContextInfo;
+  getContextMessages: () => ContextMessages;
+} {
   const sessions = new Map<string, PiSession>();
   const prompts = loadPrompts();
   const today = new Date().toLocaleDateString("en-CA");
@@ -77,6 +85,29 @@ export function createMind(options: {
   const authStorage = AuthStorage.create();
   const modelRegistry = ModelRegistry.create(authStorage);
 
+  // The daemon centrally refreshes the system OAuth token and rewrites auth.json
+  // with the fresh token. Watch the file and reload so a running mind adopts the
+  // new token without a restart (mirrors the Claude Agent SDK credential reload).
+  // This is why the mind itself does not refresh the rotating grant.
+  const piAuthPath = process.env.PI_CODING_AGENT_DIR
+    ? resolvePath(process.env.PI_CODING_AGENT_DIR, "auth.json")
+    : null;
+  if (piAuthPath) {
+    try {
+      watchFile(piAuthPath, { interval: 2000 }, (curr, prev) => {
+        if (curr.mtimeMs === prev.mtimeMs) return;
+        try {
+          authStorage.reload();
+          log("mind", "reloaded auth.json after credential refresh");
+        } catch (err) {
+          log("mind", "failed to reload auth.json:", err);
+        }
+      });
+    } catch (err) {
+      log("mind", "failed to watch auth.json for credential refresh:", err);
+    }
+  }
+
   // --- Subagents (config-driven) ---
 
   function loadSubagents(
@@ -296,6 +327,7 @@ export function createMind(options: {
 
     const resourceLoader = new DefaultResourceLoader({
       cwd: options.cwd,
+      agentDir: getAgentDir(),
       settingsManager,
       systemPrompt: options.systemPrompt,
       extensionFactories: [
@@ -457,8 +489,14 @@ export function createMind(options: {
           } else {
             session.agentSession.prompt(text, opts);
           }
-        })().catch((err) => {
+        })().catch(async (err) => {
           log("mind", `session "${sessionName}": prompt failed:`, err);
+          // Tell the daemon the turn failed (so it records a notice for the mind's next
+          // successful turn) before done, then complete the turn locally and on the daemon.
+          await daemonEmit({ type: "error", session: sessionName, content: String(err) }).catch(
+            () => {},
+          );
+          await daemonEmit({ type: "done", session: sessionName }).catch(() => {});
           broadcast(session, { type: "done" });
         });
 
@@ -489,20 +527,23 @@ export function createMind(options: {
   const claudeMdTokens = countSdkInstructionTokens(options.cwd);
   const skillDescTokens = countSkillDescriptionTokens([resolvePath(options.cwd, ".pi/skills")]);
 
+  function processSession(sessionName: string) {
+    const jsonlPath = findPiSessionFile(piSessionsDir, sessionName);
+    return jsonlPath
+      ? processPiSession(jsonlPath, systemPromptTokens, claudeMdTokens, skillDescTokens)
+      : null;
+  }
+
   function getContextInfo(): ContextInfo {
     return {
       sessions: Array.from(sessions.values()).map((s) => {
         try {
-          const jsonlPath = findPiSessionFile(piSessionsDir, s.name);
-          const parsed = jsonlPath
-            ? parsePiSessionJSONL(jsonlPath, systemPromptTokens, claudeMdTokens, skillDescTokens)
-            : null;
-
+          const result = processSession(s.name);
           return {
             name: s.name,
-            contextTokens: parsed?.contextTokens ?? s.contextTokens,
+            contextTokens: result?.parsed?.contextTokens ?? s.contextTokens,
             contextWindow: maxContextTokens,
-            breakdown: parsed?.breakdown,
+            breakdown: result?.parsed?.breakdown,
           };
         } catch (err) {
           log("mind", `failed to get context breakdown for session "${s.name}":`, err);
@@ -513,5 +554,25 @@ export function createMind(options: {
     };
   }
 
-  return { resolve, getContextInfo };
+  function getContextMessages(): ContextMessages {
+    const skillsDir = resolvePath(options.cwd, ".pi/skills");
+    return {
+      preamble: {
+        systemPrompt: options.systemPrompt,
+        sdkInstructions: readSdkInstructions(options.cwd),
+        skillDescriptions: readSkillDescriptions([skillsDir]),
+      },
+      sessions: Array.from(sessions.values()).map((s) => {
+        try {
+          const result = processSession(s.name);
+          return { name: s.name, messages: result?.messages ?? [] };
+        } catch (err) {
+          log("mind", `failed to extract messages for session "${s.name}":`, err);
+          return { name: s.name, messages: [] };
+        }
+      }),
+    };
+  }
+
+  return { resolve, getContextInfo, getContextMessages };
 }

package/templates/pi/src/lib/subagents.ts

@@ -1,17 +1,13 @@
 import type { Model } from "@mariozechner/pi-ai";
 import {
   type AuthStorage,
-  bashTool,
-  codingTools,
   createAgentSession,
   DefaultResourceLoader,
   type ExtensionFactory,
-  editTool,
+  getAgentDir,
   type ModelRegistry,
-  readTool,
   SessionManager,
   SettingsManager,
-  writeTool,
 } from "@mariozechner/pi-coding-agent";
 import { Type } from "@sinclair/typebox";
 import { log } from "./logger.js";
@@ -47,6 +43,7 @@ export function createSubagentExtension(
 
             const loader = new DefaultResourceLoader({
               cwd: context.cwd,
+              agentDir: getAgentDir(),
               systemPromptOverride: () => def.prompt,
               settingsManager: SettingsManager.inMemory({}),
             });
@@ -125,29 +122,34 @@ export function createSubagentExtension(
   };
 }
 
-const TOOL_MAP: Record<string, (typeof codingTools)[number]> = {
-  Read: readTool,
-  Write: writeTool,
-  Bash: bashTool,
-  Edit: editTool,
+// Maps subagent tool labels to pi's built-in coding tool names.
+const TOOL_NAME_MAP: Record<string, string> = {
+  Read: "read",
+  Write: "write",
+  Bash: "bash",
+  Edit: "edit",
 };
 
-function resolveTools(names: string[] | undefined) {
-  if (!names) return codingTools;
+// Resolves subagent tool labels to pi tool names for createAgentSession's
+// `tools` filter. Returns undefined to enable all built-in coding tools.
+function resolveTools(names: string[] | undefined): string[] | undefined {
+  if (!names) return undefined;
   const resolved = names
     .map((n) => {
-      if (!TOOL_MAP[n]) {
+      const toolName = TOOL_NAME_MAP[n];
+      if (!toolName) {
         log(
           "mind",
-          `unknown subagent tool "${n}" — available: ${Object.keys(TOOL_MAP).join(", ")}`,
+          `unknown subagent tool "${n}" — available: ${Object.keys(TOOL_NAME_MAP).join(", ")}`,
         );
+        return undefined;
       }
-      return TOOL_MAP[n];
+      return toolName;
     })
-    .filter(Boolean);
+    .filter((t) => t !== undefined);
   if (resolved.length === 0) {
     log("mind", "no valid tools resolved for subagent, falling back to all coding tools");
-    return codingTools;
+    return undefined;
   }
   return resolved;
 }

package/templates/pi/src/server.ts

@@ -45,6 +45,7 @@ const server = createVoluteServer({
   name: pkg.name,
   version: pkg.version,
   getContextInfo: mind.getContextInfo,
+  getContextMessages: mind.getContextMessages,
 });
 
 server.listen(port, () => {

package/dist/chunk-K3NQKI34.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-export {
-  __export
-};

package/dist/db-32YFKMFL.js

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-import {
-  getDb
-} from "./chunk-QDWP435B.js";
-import "./chunk-CJ26DXZL.js";
-import "./chunk-K3NQKI34.js";
-export {
-  getDb
-};

package/dist/delivery-manager-N34XKUGL.js

@@ -1,30 +0,0 @@
-#!/usr/bin/env node
-import {
-  DeliveryManager,
-  getDeliveryManager,
-  initDeliveryManager
-} from "./chunk-CHCISTH7.js";
-import "./chunk-WUH54G5S.js";
-import "./chunk-Y4W3OS7Q.js";
-import "./chunk-46DYYHN6.js";
-import "./chunk-IBOU6Q3Y.js";
-import "./chunk-QDWPM73D.js";
-import "./chunk-CU6OFXMM.js";
-import "./chunk-EVKGKQ2P.js";
-import "./chunk-DZ4LYU6J.js";
-import "./chunk-OS5MRIEP.js";
-import "./chunk-OEXOFBW5.js";
-import "./chunk-6FSSMAXU.js";
-import "./chunk-7W3UWCQD.js";
-import "./chunk-7GZB3ZJP.js";
-import "./chunk-B7MWXFAH.js";
-import "./chunk-TCNCRDB5.js";
-import "./chunk-T2TP6ZC6.js";
-import "./chunk-QDWP435B.js";
-import "./chunk-CJ26DXZL.js";
-import "./chunk-K3NQKI34.js";
-export {
-  DeliveryManager,
-  getDeliveryManager,
-  initDeliveryManager
-};

package/dist/down-TCEBGTMY.js

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-import {
-  run,
-  stopDaemon
-} from "./chunk-QJ4GU5XT.js";
-import "./chunk-TXSA4Q3V.js";
-import "./chunk-O7IGP7ZW.js";
-import "./chunk-6V2U3GFQ.js";
-import "./chunk-OEXOFBW5.js";
-import "./chunk-6FSSMAXU.js";
-import "./chunk-QDWP435B.js";
-import "./chunk-CJ26DXZL.js";
-import "./chunk-K3NQKI34.js";
-export {
-  run,
-  stopDaemon
-};