oc-tweaks 0.4.1 → 0.5.0

package/README.md

@@ -9,7 +9,7 @@ A collection of runtime enhancement plugins for [OpenCode](https://opencode.ai/)
 `oc-tweaks` provides a set of plugins to enhance your OpenCode experience. These plugins are activated at runtime and can modify OpenCode's behavior, such as sending notifications, improving multi-language support, and enforcing best practices for sub-agent usage.
 
 The currently available plugins are:
-- **`notify`**: Sends desktop notifications when a task is completed or an error occurs.
+- **`notify`**: Sends desktop notifications when a task is completed or an error occurs, and can show WPF tool call transparency toasts (stack + queue).
 - **`compaction`**: Injects a language preference prompt during session compaction to ensure summaries are in your preferred language.
 - **`autoMemory`**: Smart memory assistant that injects memory context, detects memory trigger phrases, and supports active memory writes via `remember` tool and `/remember` command.
 - **`backgroundSubagent`**: Adds a system prompt to encourage using background sub-agents for better responsiveness.
@@ -50,6 +50,8 @@ All configurations are optional. By default, most plugins are enabled after runn
 
 This plugin sends desktop notifications upon task completion (session idle) or error.
 
+It can also show **tool call transparency notifications** (WPF only) for each model tool invocation, including tool name and arguments, with vertical stacking and queueing (no drop).
+
 - **Windows**: Uses a custom, non-intrusive WPF window that works across virtual desktops.
 - **macOS**: Uses `osascript`.
 - **Linux**: Uses `notify-send`.
@@ -64,6 +66,7 @@ This plugin sends desktop notifications upon task completion (session idle) or e
 | `notifyOnError` | boolean | `true` | Notify on session errors. |
 | `command` | string | `null` | A custom command to run for notifications. `$TITLE` and `$MESSAGE` are available as placeholders. |
 | `style` | object | `{...}` | Custom styles for the Windows WPF notification window. See below. |
+| `toolCall` | object | `{...}` | Tool call transparency notification settings. See below. |
 
 #### `notify.style` (Windows WPF)
 
@@ -80,13 +83,26 @@ Customize the appearance of the WPF notification window.
 | `height` | `105` | Window height in pixels. |
 | `titleFontSize` | `14` | Font size for the title in points. |
 | `contentFontSize` | `11` | Font size for the content in points. |
-| `iconFontSize` | `13` | Font size for the icon (✅/❌) in points. |
+| `iconFontSize` | `30` | Font size for the icon (✅/❌) in points. |
 | `duration` | `10000` | Time in milliseconds before the notification auto-closes. |
 | `position` | `"center"` | Window position: `"center"`, `"top-right"`, or `"bottom-right"`. |
 | `shadow` | `true` | Enable or disable the drop shadow effect. |
 | `idleColor` | `"#4ADE80"` | Accent color for idle (success) notifications. |
 | `errorColor` | `"#EF4444"` | Accent color for error notifications. |
 
+#### `notify.toolCall` (Windows WPF)
+
+Configure tool call transparency notifications. This feature is designed for visibility: every queued event is eventually shown.
+
+| Property | Type | Default | Description |
+|---|---|---|---|
+| `enabled` | boolean | `false` | Enable tool call notifications. |
+| `duration` | number | `3000` | Auto-close delay for each tool call toast (ms). |
+| `position` | string | `"top-right"` | Window position: `"top-right"`, `"bottom-right"`, or `"center"`. |
+| `maxVisible` | number | `3` | Maximum number of visible tool call toasts at the same time. |
+| `maxArgLength` | number | `300` | Max characters for formatted argument JSON before truncation. |
+| `filter.exclude` | string[] | `[]` | Tool names to skip (exact match). |
+
 ### `compaction`
 
 This plugin ensures that when OpenCode compacts a session's context, the resulting summary is generated in your preferred language and writing style.
@@ -162,6 +178,16 @@ Here is an example of a `~/.config/opencode/oc-tweaks.json` file with all option
     "style": {
       "backgroundColor": "#101018",
       "duration": 8000
+    },
+    "toolCall": {
+      "enabled": true,
+      "duration": 3000,
+      "position": "top-right",
+      "maxVisible": 3,
+      "maxArgLength": 300,
+      "filter": {
+        "exclude": ["think_sequentialthinking"]
+      }
     }
   },
   "compaction": {
@@ -199,7 +225,7 @@ Here is an example of a `~/.config/opencode/oc-tweaks.json` file with all option
 `oc-tweaks` 提供了一系列插件来增强你的 OpenCode 使用体验。这些插件在运行时激活，可以调整 OpenCode 的行为，例如发送桌面通知、改善多语言支持以及强制执行子代理使用的最佳实践。
 
 目前可用的插件包括：
-- **`notify`**: 在任务完成或发生错误时发送桌面通知。
+- **`notify`**: 在任务完成或发生错误时发送桌面通知，并支持 WPF 工具调用透明度弹窗（堆叠 + 排队）。
 - **`compaction`**: 在会话上下文压缩期间注入语言偏好提示，以确保摘要使用你的首选语言。
 - **`autoMemory`**: 智能记忆助手——自动注入 memory 上下文、识别触发词，并支持 `remember` tool 与 `/remember` 命令主动写入。
 - **`backgroundSubagent`**: 添加系统提示，鼓励使用后台子代理以获得更好的响应性。
@@ -240,6 +266,8 @@ bunx oc-tweaks init
 
 此插件在任务完成（会话空闲）或出错时发送桌面通知。
 
+它也支持**工具调用透明度通知**（仅 WPF）：每次模型调用工具都会显示工具名与参数，并支持垂直堆叠和排队（不丢通知）。
+
 - **Windows**: 使用一个自定义的、无侵入性的 WPF 窗口，该窗口可跨虚拟桌面工作。
 - **macOS**: 使用 `osascript`。
 - **Linux**: 使用 `notify-send`。
@@ -254,6 +282,7 @@ bunx oc-tweaks init
 | `notifyOnError` | boolean | `true` | 在会话出错时通知。 |
 | `command` | string | `null` | 用于发送通知的自定义命令。`$TITLE` 和 `$MESSAGE` 可作为占位符。 |
 | `style` | object | `{...}` | 用于 Windows WPF 通知窗口的自定义样式。详见下文。 |
+| `toolCall` | object | `{...}` | 工具调用透明度通知配置。详见下文。 |
 
 #### `notify.style` (Windows WPF)
 
@@ -270,13 +299,26 @@ bunx oc-tweaks init
 | `height` | `105` | 窗口高度 (像素)。 |
 | `titleFontSize` | `14` | 标题的字体大小 (pt)。 |
 | `contentFontSize` | `11` | 内容的字体大小 (pt)。 |
-| `iconFontSize` | `13` | 图标 (✅/❌) 的字体大小 (pt)。 |
+| `iconFontSize` | `30` | 图标 (✅/❌) 的字体大小 (pt)。 |
 | `duration` | `10000` | 通知自动关闭前的延迟时间 (毫秒)。 |
 | `position` | `"center"` | 窗口位置: `"center"`, `"top-right"`, 或 `"bottom-right"`。 |
 | `shadow` | `true` | 启用或禁用下拉阴影效果。 |
 | `idleColor` | `"#4ADE80"` | 空闲 (成功) 通知的强调色。 |
 | `errorColor` | `"#EF4444"` | 错误通知的强调色。 |
 
+#### `notify.toolCall` (Windows WPF)
+
+配置工具调用透明度通知。该能力以“可见性优先”为目标：进入队列的事件最终都会显示。
+
+| 属性 | 类型 | 默认值 | 描述 |
+|---|---|---|---|
+| `enabled` | boolean | `false` | 启用工具调用通知。 |
+| `duration` | number | `3000` | 每条工具调用弹窗自动关闭延迟（毫秒）。 |
+| `position` | string | `"top-right"` | 窗口位置：`"top-right"`、`"bottom-right"` 或 `"center"`。 |
+| `maxVisible` | number | `3` | 同时可见的工具调用弹窗最大数量。 |
+| `maxArgLength` | number | `300` | 参数 JSON 格式化后截断前的最大字符数。 |
+| `filter.exclude` | string[] | `[]` | 要跳过的工具名（精确匹配）。 |
+
 ### `compaction`
 
 此插件确保当 OpenCode 压缩会话上下文时，生成的摘要使用你的首选语言和写作风格。
@@ -352,6 +394,16 @@ bunx oc-tweaks init
     "style": {
       "backgroundColor": "#101018",
       "duration": 8000
+    },
+    "toolCall": {
+      "enabled": true,
+      "duration": 3000,
+      "position": "top-right",
+      "maxVisible": 3,
+      "maxArgLength": 300,
+      "filter": {
+        "exclude": ["think_sequentialthinking"]
+      }
     }
   },
   "compaction": {

package/dist/index.js

@@ -65,7 +65,9 @@ var DEFAULT_CONFIG = {
   autoMemory: {},
   backgroundSubagent: {},
   leaderboard: {},
-  notify: {}
+  notify: {
+    toolCall: {}
+  }
 };
 async function loadOcTweaksConfig() {
   const home = Bun.env?.HOME ?? (globalThis?.process?.env?.HOME ?? "") ?? "";
@@ -323,10 +325,18 @@ ${VIOLATION_WARNING}`;
 // src/plugins/compaction.ts
 function buildCompactionPrompt(language, style) {
   const lang = language || "the language the user used most in this session";
-  const writingStyle = style || "concise and well-organized";
-  return `## Language & Style Preference
-
-Write the compaction summary in ${lang}, using a ${writingStyle} writing style. Keep technical terms (filenames, commands, code) in their original form.`;
+  const lines = [
+    "## MANDATORY: Language & Writing Style",
+    "",
+    `**Language**: Write the ENTIRE compaction summary in ${lang}. Keep technical terms (filenames, commands, code) in their original form.`
+  ];
+  if (style) {
+    lines.push("", `**Writing Style**: ${style}`, "", "This is a NON-NEGOTIABLE requirement. Every section, every bullet point, every description in the summary MUST be written in this style. The structural format (numbered sections, bullet points) should be preserved, but the TONE, VOICE, and WORD CHOICE must unmistakably reflect the specified writing style throughout the entire output. Do NOT fall back to a neutral or generic tone.");
+  } else {
+    lines.push("", "**Writing Style**: concise and well-organized");
+  }
+  return lines.join(`
+`);
 }
 var compactionPlugin = async () => {
   return {
@@ -467,74 +477,104 @@ var leaderboardPlugin = async () => {
     })
   };
 };
-// src/plugins/notify.ts
-var notifyPlugin = async ({ $, directory, client }) => {
-  let cachedSender = null;
-  return {
-    event: safeHook("notify:event", async ({ event }) => {
-      const config = await loadOcTweaksConfig();
-      if (!config || config.notify?.enabled !== true)
-        return;
-      const logConfig = config.logging;
-      const notifyOnIdle = config.notify?.notifyOnIdle !== false;
-      const notifyOnError = config.notify?.notifyOnError !== false;
-      const configuredCommand = typeof config.notify?.command === "string" && config.notify.command.trim().length > 0 ? config.notify.command.trim() : null;
-      const style = config.notify?.style;
-      const sender = configuredCommand ? { kind: "custom", commandTemplate: configuredCommand } : cachedSender ??= await detectNotifySender($, client, logConfig);
-      const sendToast = async (projectName, message, tag) => {
-        const title = `oc: ${projectName}`;
-        await notifyWithSender($, sender, title, message, tag, style, logConfig);
+// src/utils/wpf-position.ts
+class WpfPositionManager {
+  maxVisible;
+  slots = new Map;
+  queue = [];
+  constructor(maxVisible) {
+    this.maxVisible = maxVisible;
+  }
+  allocateSlot(duration) {
+    this.cleanupExpiredSlots();
+    for (let slotIndex = 0;slotIndex < this.maxVisible; slotIndex += 1) {
+      if (this.slots.has(slotIndex))
+        continue;
+      const ttl = Math.max(0, duration) + 500;
+      const timer = setTimeout(() => {
+        this.releaseSlot(slotIndex);
+      }, ttl);
+      const expiresAt = Date.now() + ttl;
+      this.slots.set(slotIndex, { expiresAt, timer });
+      let released = false;
+      return {
+        slotIndex,
+        release: () => {
+          if (released)
+            return;
+          released = true;
+          this.releaseSlot(slotIndex);
+        }
       };
-      if (event?.type === "session.idle") {
-        if (!notifyOnIdle)
-          return;
-        const projectName = getProjectName(directory);
-        const sessionId = event.properties?.sessionID ?? event.properties?.sessionId;
-        const message = await extractIdleMessage(client, sessionId);
-        await sendToast(projectName, message, "Stop");
+    }
+    return null;
+  }
+  enqueue(callback) {
+    this.queue.push(callback);
+  }
+  processQueue() {
+    this.cleanupExpiredSlots();
+    while (this.queue.length > 0 && this.hasAvailableSlot()) {
+      const callback = this.queue.shift();
+      if (!callback)
         return;
-      }
-      if (event?.type === "session.error") {
-        if (!notifyOnError)
-          return;
-        const projectName = getProjectName(directory);
-        await sendToast(projectName, "❌ Session error", "Error");
-      }
-    })
-  };
-};
-function getProjectName(directory) {
-  const normalized = directory.replace(/\\/g, "/");
-  const segments = normalized.split("/").filter(Boolean);
-  return segments[segments.length - 1] || "opencode";
-}
-async function extractIdleMessage(client, sessionId) {
-  let message = "✓ Task completed";
-  if (!sessionId || !client?.session?.messages)
-    return message;
-  try {
-    const result = await client.session.messages({ path: { id: sessionId } });
-    const messages = result?.data;
-    if (!Array.isArray(messages))
-      return message;
-    for (let i = messages.length - 1;i >= 0; i -= 1) {
-      const msg = messages[i];
-      if (msg?.info?.role !== "assistant" || !Array.isArray(msg?.parts))
+      callback();
+    }
+  }
+  hasAvailableSlot() {
+    this.cleanupExpiredSlots();
+    return this.slots.size < this.maxVisible;
+  }
+  cleanupExpiredSlots() {
+    const now = Date.now();
+    for (const [slotIndex, state] of this.slots.entries()) {
+      if (state.expiresAt > now)
         continue;
-      for (const part of msg.parts) {
-        if (part?.type === "text" && typeof part.text === "string") {
-          message = `✓ ${truncateText(cleanMarkdown(part.text), 400)}`;
-          return message;
-        }
-      }
+      clearTimeout(state.timer);
+      this.slots.delete(slotIndex);
     }
-    return message;
-  } catch {
-    return message;
   }
+  releaseSlot(slotIndex) {
+    const state = this.slots.get(slotIndex);
+    if (!state)
+      return;
+    clearTimeout(state.timer);
+    this.slots.delete(slotIndex);
+    this.processQueue();
+  }
+}
+function calculatePosition(slotIndex, config) {
+  const position = config.position ?? "center";
+  if (position === "center") {
+    return { startupLocation: "CenterScreen" };
+  }
+  const width = config.width;
+  const height = config.height;
+  const gap = config.gap ?? 12;
+  const margin = config.screenMargin ?? 20;
+  const screenWidthExpr = typeof config.screenWidth === "number" ? `${config.screenWidth}` : "[System.Windows.SystemParameters]::PrimaryScreenWidth";
+  const screenHeightExpr = typeof config.screenHeight === "number" ? `${config.screenHeight}` : "[System.Windows.SystemParameters]::PrimaryScreenHeight";
+  const leftExpr = `(${screenWidthExpr} - ${width} - ${margin})`;
+  if (position === "bottom-right") {
+    const topExpr2 = `(${screenHeightExpr} - ${margin} - ((${slotIndex} + 1) * (${height} + ${gap})))`;
+    return {
+      startupLocation: "Manual",
+      leftExpr,
+      topExpr: topExpr2
+    };
+  }
+  const topExpr = `(${margin} + (${slotIndex} * (${height} + ${gap})))`;
+  return {
+    startupLocation: "Manual",
+    leftExpr,
+    topExpr
+  };
 }
+
+// src/utils/wpf-notify.ts
 async function detectNotifySender($, client, logConfig) {
-  if (await commandExists($, "pwsh")) {
+  const isWindows = globalThis?.process?.platform === "win32";
+  if (isWindows && await commandExists($, "pwsh")) {
     return { kind: "wpf", command: "pwsh" };
   }
   if (await commandExists($, "powershell.exe")) {
@@ -552,10 +592,7 @@ async function detectNotifySender($, client, logConfig) {
   await log(logConfig, "WARN", "[oc-tweaks] notify: no available notifier, set notify.command to override");
   return { kind: "none" };
 }
-async function commandExists(_$, command) {
-  return Bun.which(command) !== null;
-}
-async function notifyWithSender($, sender, title, message, tag, style, logConfig) {
+async function notifyWithSender($, sender, title, message, tag, style, _logConfig, position, renderOptions) {
   try {
     if (sender.kind === "custom") {
       const command = sender.commandTemplate.replace(/\$TITLE/g, title).replace(/\$MESSAGE/g, message);
@@ -563,7 +600,7 @@ async function notifyWithSender($, sender, title, message, tag, style, logConfig
       return;
     }
     if (sender.kind === "wpf") {
-      await runWpfNotification($, sender.command, title, message, tag, style);
+      await runWpfNotification($, sender.command, title, message, tag, style, position, renderOptions);
       return;
     }
     if (sender.kind === "osascript") {
@@ -580,11 +617,34 @@ async function notifyWithSender($, sender, title, message, tag, style, logConfig
     }
   } catch {}
 }
+async function sendWpfToast(options) {
+  await notifyWithSender(options.$, options.sender, options.title, options.message, options.tag, options.style, options.logConfig, options.position, {
+    icon: options.icon,
+    accentColor: options.accentColor,
+    showDismissHint: options.showDismissHint,
+    maxMessageLength: options.maxMessageLength,
+    preserveMessageFormatting: options.preserveMessageFormatting
+  });
+}
+function escapeForPowerShell(text) {
+  return Buffer.from(text, "utf8").toString("base64");
+}
+function truncateText(text, maxChars) {
+  if (text.length <= maxChars)
+    return text;
+  return `${text.slice(0, maxChars)}...`;
+}
+function cleanMarkdown(text) {
+  return text.replace(/[`*#]/g, "").replace(/\n+/g, " ").replace(/\s+/g, " ").trim();
+}
+async function commandExists(_$, command) {
+  return Bun.which(command) !== null;
+}
 async function runCustomCommand($, command) {
   const escaped = command.replace(/"/g, "\\\"");
   await $`bun -e ${`const { exec } = require("node:child_process"); exec("${escaped}")`}`;
 }
-async function runWpfNotification($, shellCommand, title, message, tag, style) {
+async function runWpfNotification($, shellCommand, title, message, tag, style, position, renderOptions) {
   const backgroundColor = style?.backgroundColor ?? "#101018";
   const backgroundOpacity = style?.backgroundOpacity ?? 0.95;
   const textColor = style?.textColor ?? "#AAAAAA";
@@ -596,16 +656,26 @@ async function runWpfNotification($, shellCommand, title, message, tag, style) {
   const contentFontSize = style?.contentFontSize ?? 11;
   const iconFontSize = style?.iconFontSize ?? 30;
   const duration = style?.duration ?? 1e4;
-  const position = style?.position ?? "center";
+  const stylePosition = style?.position ?? "center";
   const shadow = style?.shadow !== false;
   const idleColor = style?.idleColor ?? "#4ADE80";
   const errorColor = style?.errorColor ?? "#EF4444";
-  const accentColor = tag === "Error" ? errorColor : idleColor;
-  const icon = tag === "Error" ? "❌" : "✅";
-  const startupLocation = position === "center" ? "CenterScreen" : position;
-  const psTitle = title.replace(/'/g, "''");
-  const psText = truncateText(cleanMarkdown(message), 400).replace(/'/g, "''");
+  const accentColor = renderOptions?.accentColor ?? (tag === "Error" ? errorColor : idleColor);
+  const icon = renderOptions?.icon ?? (tag === "Error" ? "❌" : "✅");
+  const showDismissHint = renderOptions?.showDismissHint !== false;
+  const normalizedStylePosition = stylePosition === "top-right" || stylePosition === "bottom-right" || stylePosition === "center" ? stylePosition : "center";
+  const resolvedPosition = position ?? (normalizedStylePosition === "center" ? { startupLocation: "CenterScreen" } : calculatePosition(0, {
+    position: normalizedStylePosition,
+    width,
+    height
+  }));
+  const startupLocation = resolvedPosition.startupLocation;
+  const titleB64 = escapeForPowerShell(title);
+  const messageLimit = typeof renderOptions?.maxMessageLength === "number" && renderOptions.maxMessageLength > 0 ? renderOptions.maxMessageLength : 400;
+  const normalizedMessage = renderOptions?.preserveMessageFormatting ? message : cleanMarkdown(message);
+  const textB64 = escapeForPowerShell(truncateText(normalizedMessage, messageLimit));
   const shadowXaml = shadow ? '<Border.Effect><DropShadowEffect BlurRadius="20" ShadowDepth="2" Opacity="0.7" Color="Black"/></Border.Effect>' : "";
+  const dismissHintXaml = showDismissHint ? `                    <TextBlock Text="Click to dismiss" Foreground="#555555" FontSize="9" Margin="0,4,0,0"/>` : "";
   const xaml = [
     `<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"`,
     `        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"`,
@@ -625,7 +695,7 @@ async function runWpfNotification($, shellCommand, title, message, tag, style) {
     `                <StackPanel VerticalAlignment="Center" MaxWidth="320">`,
     `                    <TextBlock Name="TitleText" FontSize="${titleFontSize}" FontWeight="SemiBold"/>`,
     `                    <TextBlock Name="ContentText" Foreground="${textColor}" FontSize="${contentFontSize}" Margin="0,4,0,0" TextWrapping="Wrap"/>`,
-    `                    <TextBlock Text="Click to dismiss" Foreground="#555555" FontSize="9" Margin="0,4,0,0"/>`,
+    dismissHintXaml,
     `                </StackPanel>`,
     `            </StackPanel>`,
     `        </Grid>`,
@@ -633,6 +703,11 @@ async function runWpfNotification($, shellCommand, title, message, tag, style) {
     `</Window>`
   ].join(`
 `);
+  const manualPositionLines = resolvedPosition.startupLocation === "Manual" && resolvedPosition.leftExpr && resolvedPosition.topExpr ? [
+    "$window.WindowStartupLocation = 'Manual'",
+    `$window.Left = ${resolvedPosition.leftExpr}`,
+    `$window.Top = ${resolvedPosition.topExpr}`
+  ] : [];
   const psScript = [
     "Add-Type -AssemblyName PresentationFramework",
     "Add-Type -AssemblyName PresentationCore",
@@ -663,8 +738,8 @@ async function runWpfNotification($, shellCommand, title, message, tag, style) {
     "}",
     "'@ -ErrorAction SilentlyContinue",
     "",
-    `$title = '${psTitle}'`,
-    `$text = '${psText}'`,
+    `$title = [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String('${titleB64}'))`,
+    `$text = [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String('${textB64}'))`,
     `$accentColor = '${accentColor}'`,
     `$icon = '${icon}'`,
     `$duration = ${duration}`,
@@ -675,6 +750,7 @@ async function runWpfNotification($, shellCommand, title, message, tag, style) {
     "",
     "$reader = New-Object System.Xml.XmlNodeReader $xaml",
     "$window = [Windows.Markup.XamlReader]::Load($reader)",
+    ...manualPositionLines,
     "",
     "$colorBar = $window.FindName('ColorBar')",
     "$iconText = $window.FindName('IconText')",
@@ -733,18 +809,160 @@ async function showToastWithFallback(showToast, title, message) {
   } catch {}
   await Promise.resolve(showToast(title, message));
 }
-function truncateText(text, maxChars) {
-  if (text.length <= maxChars)
-    return text;
-  return `${text.slice(0, maxChars)}...`;
-}
-function cleanMarkdown(text) {
-  return text.replace(/[`*#]/g, "").replace(/\n+/g, " ").replace(/\s+/g, " ").trim();
-}
 function escapeAppleScript(text) {
   return text.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
 }
+
+// src/plugins/notify.ts
+var notifyPlugin = async ({ $, directory, client }) => {
+  let cachedSender = null;
+  return {
+    event: safeHook("notify:event", async ({ event }) => {
+      const config = await loadOcTweaksConfig();
+      if (!config || config.notify?.enabled !== true)
+        return;
+      const logConfig = config.logging;
+      const notifyOnIdle = config.notify?.notifyOnIdle !== false;
+      const notifyOnError = config.notify?.notifyOnError !== false;
+      const configuredCommand = typeof config.notify?.command === "string" && config.notify.command.trim().length > 0 ? config.notify.command.trim() : null;
+      const style = config.notify?.style;
+      const sender = configuredCommand ? { kind: "custom", commandTemplate: configuredCommand } : cachedSender ??= await detectNotifySender($, client, logConfig);
+      const sendToast = async (projectName, message, tag) => {
+        const title = `oc: ${projectName}`;
+        await notifyWithSender($, sender, title, message, tag, style, logConfig);
+      };
+      if (event?.type === "session.idle") {
+        if (!notifyOnIdle)
+          return;
+        const projectName = getProjectName(directory);
+        const sessionId = event.properties?.sessionID ?? event.properties?.sessionId;
+        const message = await extractIdleMessage(client, sessionId);
+        await sendToast(projectName, message, "Stop");
+        return;
+      }
+      if (event?.type === "session.error") {
+        if (!notifyOnError)
+          return;
+        const projectName = getProjectName(directory);
+        await sendToast(projectName, "❌ Session error", "Error");
+      }
+    })
+  };
+};
+function getProjectName(directory) {
+  const normalized = directory.replace(/\\/g, "/");
+  const segments = normalized.split("/").filter(Boolean);
+  return segments[segments.length - 1] || "opencode";
+}
+async function extractIdleMessage(client, sessionId) {
+  let message = "✓ Task completed";
+  if (!sessionId || !client?.session?.messages)
+    return message;
+  try {
+    const result = await client.session.messages({ path: { id: sessionId } });
+    const messages = result?.data;
+    if (!Array.isArray(messages))
+      return message;
+    for (let i = messages.length - 1;i >= 0; i -= 1) {
+      const msg = messages[i];
+      if (msg?.info?.role !== "assistant" || !Array.isArray(msg?.parts))
+        continue;
+      for (const part of msg.parts) {
+        if (part?.type === "text" && typeof part.text === "string") {
+          message = `✓ ${truncateText(cleanMarkdown(part.text), 400)}`;
+          return message;
+        }
+      }
+    }
+    return message;
+  } catch {
+    return message;
+  }
+}
+// src/plugins/tool-call-notify.ts
+var DEFAULT_DURATION = 3000;
+var DEFAULT_MAX_VISIBLE = 3;
+var DEFAULT_MAX_ARG_LENGTH = 300;
+var DEFAULT_POSITION = "top-right";
+var DEFAULT_ACCENT_COLOR = "#60A5FA";
+var toolCallNotifyPlugin = async ({ $, client }) => {
+  let cachedSender = null;
+  let managerMaxVisible = 0;
+  let manager = null;
+  const getManager = (maxVisible) => {
+    if (!manager || managerMaxVisible !== maxVisible) {
+      manager = new WpfPositionManager(maxVisible);
+      managerMaxVisible = maxVisible;
+    }
+    return manager;
+  };
+  return {
+    "tool.execute.before": safeHook("tool-call-notify:tool.execute.before", async (input, output) => {
+      const config = await loadOcTweaksConfig();
+      if (!config || config.notify?.enabled !== true)
+        return;
+      const toolCallConfig = config.notify?.toolCall;
+      if (!toolCallConfig || toolCallConfig.enabled !== true)
+        return;
+      const excludeTools = toolCallConfig.filter?.exclude ?? [];
+      if (Array.isArray(excludeTools) && excludeTools.includes(input.tool))
+        return;
+      const sender = cachedSender ??= await detectNotifySender($, client, config.logging);
+      if (sender.kind !== "wpf")
+        return;
+      const duration = typeof toolCallConfig.duration === "number" && toolCallConfig.duration > 0 ? toolCallConfig.duration : DEFAULT_DURATION;
+      const maxVisible = typeof toolCallConfig.maxVisible === "number" && toolCallConfig.maxVisible > 0 ? toolCallConfig.maxVisible : DEFAULT_MAX_VISIBLE;
+      const maxArgLength = typeof toolCallConfig.maxArgLength === "number" && toolCallConfig.maxArgLength > 0 ? toolCallConfig.maxArgLength : DEFAULT_MAX_ARG_LENGTH;
+      const position = typeof toolCallConfig.position === "string" && toolCallConfig.position.trim().length > 0 ? toolCallConfig.position.trim() : DEFAULT_POSITION;
+      let serializedArgs = "{}";
+      try {
+        serializedArgs = JSON.stringify(output.args ?? {}, null, 2) ?? "{}";
+      } catch {
+        serializedArgs = "[unserializable args]";
+      }
+      const argsText = truncateText(serializedArgs, maxArgLength);
+      const positionManager = getManager(maxVisible);
+      const enqueueDisplay = () => {
+        const slot = positionManager.allocateSlot(duration);
+        if (!slot) {
+          positionManager.enqueue(enqueueDisplay);
+          return;
+        }
+        const baseStyle = config.notify?.style ?? {};
+        const width = baseStyle.width ?? 420;
+        const height = baseStyle.height ?? 105;
+        const calculatedPosition = calculatePosition(slot.slotIndex, {
+          position,
+          width,
+          height
+        });
+        sendWpfToast({
+          $,
+          sender,
+          title: `\uD83D\uDD27 ${input.tool}`,
+          message: argsText,
+          tag: "ToolCall",
+          style: {
+            ...baseStyle,
+            duration
+          },
+          position: calculatedPosition,
+          icon: "\uD83D\uDD27",
+          accentColor: DEFAULT_ACCENT_COLOR,
+          showDismissHint: false,
+          maxMessageLength: maxArgLength,
+          preserveMessageFormatting: true
+        }).catch(() => {
+          slot.release();
+        });
+      };
+      positionManager.enqueue(enqueueDisplay);
+      positionManager.processQueue();
+    })
+  };
+};
 export {
+  toolCallNotifyPlugin,
   notifyPlugin,
   leaderboardPlugin,
   compactionPlugin,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oc-tweaks",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "type": "module",
   "exports": {
     ".": "./dist/index.js"