oc-tweaks 0.4.2 → 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 ?? "") ?? "";
@@ -475,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")) {
@@ -560,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);
@@ -571,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") {
@@ -588,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";
@@ -604,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"`,
@@ -633,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>`,
@@ -641,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",
@@ -671,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}`,
@@ -683,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')",
@@ -741,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.2",
+  "version": "0.5.0",
   "type": "module",
   "exports": {
     ".": "./dist/index.js"