volute 0.5.0 → 0.7.0

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

@@ -5,6 +5,7 @@ import { query } from "@anthropic-ai/claude-agent-sdk";
 import { createAutoCommitHook } from "./lib/hooks/auto-commit.js";
 import { createIdentityReloadHook } from "./lib/hooks/identity-reload.js";
 import { createPreCompactHook } from "./lib/hooks/pre-compact.js";
+import { createSessionContextHook } from "./lib/hooks/session-context.js";
 import { log, logText, logThinking, logToolUse } from "./lib/logger.js";
 import { createMessageChannel } from "./lib/message-channel.js";
 import type {
@@ -136,6 +137,12 @@ export function createAgent(options: {
       });
     });
 
+    const sessionContext = createSessionContextHook({
+      currentSession: session.name,
+      sessionsDir: options.sessionsDir,
+      cwd: options.cwd,
+    });
+
     return query({
       prompt: session.channel.iterable,
       options: {
@@ -150,6 +157,7 @@ export function createAgent(options: {
         hooks: {
           PostToolUse: postToolUseHooks,
           PreCompact: [{ hooks: [preCompact.hook] }],
+          UserPromptSubmit: [{ hooks: [sessionContext.hook] }],
         },
       },
     });
@@ -182,6 +190,14 @@ export function createAgent(options: {
       }
       if (msg.type === "result") {
         log("agent", `session "${session.name}": turn done`);
+        const result = msg as { usage?: { input_tokens?: number; output_tokens?: number } };
+        if (result.usage) {
+          broadcastToSession(session, {
+            type: "usage",
+            input_tokens: result.usage.input_tokens ?? 0,
+            output_tokens: result.usage.output_tokens ?? 0,
+          });
+        }
         broadcastToSession(session, { type: "done" });
         session.currentMessageId = undefined;
         if (identityReload.needsReload()) {

package/templates/agent-sdk/src/lib/hooks/session-context.ts

@@ -0,0 +1,32 @@
+import { resolve } from "node:path";
+import type { HookCallback } from "@anthropic-ai/claude-agent-sdk";
+import { getSessionUpdates, resolveAgentSdkJsonl } from "../session-monitor.js";
+
+export function createSessionContextHook(options: {
+  currentSession: string;
+  sessionsDir: string;
+  cwd: string;
+}) {
+  const hook: HookCallback = async () => {
+    try {
+      const summary = getSessionUpdates({
+        currentSession: options.currentSession,
+        sessionsDir: options.sessionsDir,
+        cursorFile: resolve(options.sessionsDir, "../session-cursors.json"),
+        jsonlResolver: (name) => resolveAgentSdkJsonl(options.sessionsDir, name, options.cwd),
+        format: "agent-sdk",
+      });
+      if (!summary) return {};
+      return {
+        hookSpecificOutput: {
+          hookEventName: "UserPromptSubmit" as const,
+          additionalContext: summary,
+        },
+      };
+    } catch {
+      return {};
+    }
+  };
+
+  return { hook };
+}

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,
@@ -137,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/dist/channel-MK5OK2SI.js

@@ -1,113 +0,0 @@
-#!/usr/bin/env node
-import {
-  readStdin
-} from "./chunk-ZYGKG6VC.js";
-import {
-  resolveAgentName
-} from "./chunk-AZEL2IEK.js";
-import {
-  getChannelDriver
-} from "./chunk-SMISE4SV.js";
-import {
-  loadMergedEnv
-} from "./chunk-HE67X4T6.js";
-import {
-  parseArgs
-} from "./chunk-D424ZQGI.js";
-import {
-  resolveAgent
-} from "./chunk-UX25Z2ND.js";
-import "./chunk-K3NQKI34.js";
-
-// src/commands/channel.ts
-async function run(args) {
-  const subcommand = args[0];
-  switch (subcommand) {
-    case "read":
-      await readChannel(args.slice(1));
-      break;
-    case "send":
-      await sendChannel(args.slice(1));
-      break;
-    case "--help":
-    case "-h":
-    case void 0:
-      printUsage();
-      break;
-    default:
-      printUsage();
-      process.exit(1);
-  }
-}
-function printUsage() {
-  console.log(`Usage:
-  volute channel read <channel-uri> [--limit N] [--agent <name>]
-  volute channel send <channel-uri> "<message>" [--agent <name>]
-  echo "message" | volute channel send <channel-uri> [--agent <name>]`);
-}
-async function readChannel(args) {
-  const { positional, flags } = parseArgs(args, {
-    agent: { type: "string" },
-    limit: { type: "number" }
-  });
-  const uri = positional[0];
-  if (!uri) {
-    console.error("Usage: volute channel read <channel-uri> [--limit N] [--agent <name>]");
-    process.exit(1);
-  }
-  const agentName = resolveAgentName(flags);
-  const { platform, channelId } = parseUri(uri);
-  const driver = requireDriver(platform);
-  const { dir } = resolveAgent(agentName);
-  const env = { ...loadMergedEnv(dir), VOLUTE_AGENT: agentName };
-  try {
-    const limit = flags.limit ?? 20;
-    const output = await driver.read(env, channelId, limit);
-    console.log(output);
-  } catch (err) {
-    console.error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
-  }
-}
-async function sendChannel(args) {
-  const { positional, flags } = parseArgs(args, {
-    agent: { type: "string" }
-  });
-  const uri = positional[0];
-  const message = positional[1] ?? await readStdin();
-  if (!uri || !message) {
-    console.error('Usage: volute channel send <channel-uri> "<message>" [--agent <name>]');
-    console.error('       echo "message" | volute channel send <channel-uri> [--agent <name>]');
-    process.exit(1);
-  }
-  const agentName = resolveAgentName(flags);
-  const { platform, channelId } = parseUri(uri);
-  const driver = requireDriver(platform);
-  const { dir } = resolveAgent(agentName);
-  const env = { ...loadMergedEnv(dir), VOLUTE_AGENT: agentName };
-  try {
-    await driver.send(env, channelId, message);
-  } catch (err) {
-    console.error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
-  }
-}
-function parseUri(uri) {
-  const colonIdx = uri.indexOf(":");
-  if (colonIdx === -1) {
-    console.error(`Invalid channel URI: ${uri} (expected format: platform:id)`);
-    process.exit(1);
-  }
-  return { platform: uri.slice(0, colonIdx), channelId: uri.slice(colonIdx + 1) };
-}
-function requireDriver(platform) {
-  const driver = getChannelDriver(platform);
-  if (!driver) {
-    console.error(`No channel driver for platform: ${platform}`);
-    process.exit(1);
-  }
-  return driver;
-}
-export {
-  run
-};

package/dist/chunk-SMISE4SV.js

@@ -1,226 +0,0 @@
-#!/usr/bin/env node
-import {
-  voluteHome
-} from "./chunk-UX25Z2ND.js";
-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/volute.ts
-var volute_exports = {};
-__export(volute_exports, {
-  read: () => read4,
-  send: () => send4
-});
-import { existsSync, readFileSync } from "fs";
-import { resolve } from "path";
-function getDaemonConfig() {
-  const configPath = resolve(voluteHome(), "daemon.json");
-  if (!existsSync(configPath)) {
-    throw new Error("Volute daemon is not running");
-  }
-  let config;
-  try {
-    config = JSON.parse(readFileSync(configPath, "utf-8"));
-  } catch (err) {
-    throw new Error(`Failed to parse ${configPath}: ${err}`);
-  }
-  if (typeof config.port !== "number") {
-    throw new Error(`Invalid or missing port in ${configPath}`);
-  }
-  const url = new URL("http://localhost");
-  url.hostname = config.hostname || "localhost";
-  url.port = String(config.port);
-  return { url: url.origin, token: config.token };
-}
-async function read4(env, conversationId, limit) {
-  const agentName = env.VOLUTE_AGENT;
-  if (!agentName) throw new Error("VOLUTE_AGENT not set");
-  const { url, token } = getDaemonConfig();
-  const headers = { Origin: url };
-  if (token) headers.Authorization = `Bearer ${token}`;
-  const res = await fetch(
-    `${url}/api/agents/${encodeURIComponent(agentName)}/conversations/${encodeURIComponent(conversationId)}/messages`,
-    { headers }
-  );
-  if (!res.ok) {
-    throw new Error(`Failed to read conversation: ${res.status} ${res.statusText}`);
-  }
-  const messages = await res.json();
-  return messages.slice(-limit).map((m) => {
-    const text = Array.isArray(m.content) ? m.content.filter((b) => b.type === "text").map((b) => b.text).join("") : m.content;
-    return `${m.sender_name ?? m.role}: ${text}`;
-  }).join("\n");
-}
-async function send4(env, conversationId, message) {
-  const agentName = env.VOLUTE_AGENT;
-  if (!agentName) throw new Error("VOLUTE_AGENT not set");
-  const { url, token } = getDaemonConfig();
-  const headers = {
-    "Content-Type": "application/json",
-    Origin: url
-  };
-  if (token) headers.Authorization = `Bearer ${token}`;
-  const res = await fetch(`${url}/api/agents/${encodeURIComponent(agentName)}/chat`, {
-    method: "POST",
-    headers,
-    body: JSON.stringify({ message, conversationId, sender: agentName })
-  });
-  if (!res.ok) {
-    const data = await res.json().catch(() => ({}));
-    throw new Error(data.error ?? `Failed to send: ${res.status}`);
-  }
-  if (res.body) {
-    const reader = res.body.getReader();
-    while (true) {
-      const { done } = await reader.read();
-      if (done) break;
-    }
-  }
-}
-
-// src/lib/channels.ts
-var CHANNELS = {
-  volute: { name: "volute", displayName: "Volute", showToolCalls: true, driver: volute_exports },
-  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
-  },
-  system: { name: "system", displayName: "System", showToolCalls: false }
-};
-function getChannelDriver(platform) {
-  return CHANNELS[platform]?.driver ?? null;
-}
-
-export {
-  CHANNELS,
-  getChannelDriver
-};

package/dist/conversation-ERXEQZTY.js

@@ -1,163 +0,0 @@
-#!/usr/bin/env node
-import {
-  readStdin
-} from "./chunk-ZYGKG6VC.js";
-import {
-  resolveAgentName
-} from "./chunk-AZEL2IEK.js";
-import {
-  summarizeTool
-} from "./chunk-B3R6L2GW.js";
-import {
-  parseArgs
-} from "./chunk-D424ZQGI.js";
-import {
-  daemonFetch
-} from "./chunk-7L4AN5D4.js";
-import "./chunk-UX25Z2ND.js";
-import "./chunk-K3NQKI34.js";
-
-// src/commands/conversation.ts
-import { userInfo } from "os";
-async function run(args) {
-  const subcommand = args[0];
-  switch (subcommand) {
-    case "create":
-      await createConversation(args.slice(1));
-      break;
-    case "list":
-      await listConversations(args.slice(1));
-      break;
-    case "send":
-      await sendToConversation(args.slice(1));
-      break;
-    case "--help":
-    case "-h":
-    case void 0:
-      printUsage();
-      break;
-    default:
-      printUsage();
-      process.exit(1);
-  }
-}
-function printUsage() {
-  console.log(`Usage:
-  volute conversation create --participants user1,agent1 [--title "..."] [--agent <name>]
-  volute conversation list [--agent <name>]
-  volute conversation send <id> "<message>" [--agent <name>]
-  echo "message" | volute conversation send <id> [--agent <name>]`);
-}
-async function createConversation(args) {
-  const { flags } = parseArgs(args, {
-    agent: { type: "string" },
-    participants: { type: "string" },
-    title: { type: "string" }
-  });
-  const agentName = resolveAgentName(flags);
-  if (!flags.participants) {
-    console.error("--participants is required (comma-separated usernames)");
-    process.exit(1);
-  }
-  const participantNames = flags.participants.split(",").map((s) => s.trim());
-  const res = await daemonFetch(`/api/agents/${encodeURIComponent(agentName)}/conversations`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ participantNames, title: flags.title })
-  });
-  if (!res.ok) {
-    const data = await res.json();
-    console.error(data.error ?? `Failed to create conversation: ${res.status}`);
-    process.exit(1);
-  }
-  const conv = await res.json();
-  console.log(`Created conversation: ${conv.id}`);
-  if (conv.title) console.log(`Title: ${conv.title}`);
-}
-async function listConversations(args) {
-  const { flags } = parseArgs(args, {
-    agent: { type: "string" }
-  });
-  const agentName = resolveAgentName(flags);
-  const res = await daemonFetch(`/api/agents/${encodeURIComponent(agentName)}/conversations`);
-  if (!res.ok) {
-    const data = await res.json();
-    console.error(data.error ?? `Failed to list conversations: ${res.status}`);
-    process.exit(1);
-  }
-  const convs = await res.json();
-  if (convs.length === 0) {
-    console.log("No conversations.");
-    return;
-  }
-  for (const conv of convs) {
-    const title = conv.title || "(untitled)";
-    console.log(`${conv.id}  ${title}  ${conv.updated_at}`);
-  }
-}
-async function sendToConversation(args) {
-  const { positional, flags } = parseArgs(args, {
-    agent: { type: "string" }
-  });
-  const conversationId = positional[0];
-  const message = positional[1] ?? await readStdin();
-  if (!conversationId || !message) {
-    console.error('Usage: volute conversation send <id> "<message>" [--agent <name>]');
-    console.error('       echo "message" | volute conversation send <id> [--agent <name>]');
-    process.exit(1);
-  }
-  const agentName = resolveAgentName(flags);
-  const res = await daemonFetch(`/api/agents/${encodeURIComponent(agentName)}/chat`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      message,
-      conversationId,
-      sender: process.env.VOLUTE_AGENT || userInfo().username
-    })
-  });
-  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);
-  }
-  const reader = res.body.getReader();
-  const decoder = new TextDecoder();
-  let buffer = "";
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    buffer += decoder.decode(value, { stream: true });
-    const lines = buffer.split("\n");
-    buffer = lines.pop() ?? "";
-    for (const line of lines) {
-      if (!line.startsWith("data:")) continue;
-      const data = line.slice(5).trim();
-      if (!data) continue;
-      let event;
-      try {
-        event = JSON.parse(data);
-      } catch {
-        continue;
-      }
-      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") {
-        process.stdout.write("\n");
-        return;
-      }
-    }
-  }
-  process.stdout.write("\n");
-}
-export {
-  run
-};