@icaruk/zai-peak-hours 0.1.0 → 0.3.1

package/README.md

@@ -1,6 +1,13 @@
 # @icaruk/zai-peak-hours
 
-OpenCode plugin that displays z.ai peak hours information with automatic timezone detection via toast notifications.
+OpenCode plugin that displays z.ai peak hours information with automatic timezone detection (UTC+8 / Asia/Shanghai).
+
+## Features
+
+- 🌍 Automatic timezone detection (UTC+8 / Asia/Shanghai)
+- ⏰ Real-time peak hours status (14:00-18:00 UTC+8)
+- 📊 Time remaining until next peak/off-peak transition
+- 💬 Zero-token slash commands (`/peak_hours`, `/peak_hours_status`) - no LLM invocation
 
 ## Installation
 
@@ -12,32 +19,25 @@ Add to your `~/.config/opencode/opencode.json`:
 }
 ```
 
-## Features
-
-- 🌍 Automatic timezone detection (UTC+8 / Asia/Shanghai)
-- ⏰ Real-time peak hours status (14:00-18:00 UTC+8)
-- 📊 Time remaining until next peak/off-peak transition
-- 🔔 Toast notifications on session start and periodic updates
-- ⚙️ Configurable update interval
-- 🛠️ Manual commands for on-demand status checks
+Restart OpenCode to load the plugin.
 
 ## Commands
 
+Commands are automatically available after plugin installation:
+
 - `/peak_hours` - Display current peak hours status
-- `/peak_hours_status` - Display plugin diagnostics and configuration
+- `/peak_hours_status` - Display plugin diagnostics and configuration status
 
-## Messages
+These commands execute locally without invoking LLM (zero token usage) via `command.execute.before` hook.
 
-The plugin displays toast notifications:
+## Configuration
 
-**Peak Hours:**
-```
-Currently in peak hours. X hours Y minutes remaining
-```
+Optional configuration file at `~/.config/opencode/peak-hours.json`:
 
-**Off-Peak Hours:**
-```
-Currently in off-peak hours. X hours Y minutes remaining
+```json
+{
+  "enabled": true
+}
 ```
 
 ## Development
@@ -57,7 +57,7 @@ npm run build
 npm run dev
 ```
 
-Add local config in `opencode.json`
+Add local config in `opencode.json`:
 
 ```json
 {

package/dist/index.js

@@ -1,7 +1,12 @@
-import { getPeakHoursStatus, formatPeakHoursMessage } from './peak-hours';
-import { DEFAULT_CONFIG } from './config';
+import { getPeakHoursStatus, formatPeakHoursMessage } from './utils.js';
+import { DEFAULT_CONFIG } from './config.js';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+// Command-handled sentinel
+const COMMAND_HANDLED_SENTINEL = '__PEAK_HOURS_COMMAND_HANDLED__';
+function handled() {
+    throw new Error(COMMAND_HANDLED_SENTINEL);
+}
 function getConfigPath() {
     const configDir = process.env.XDG_CONFIG_HOME
         ? path.join(process.env.XDG_CONFIG_HOME, 'opencode')
@@ -15,7 +20,7 @@ function loadConfig() {
             const configContent = fs.readFileSync(configPath, 'utf-8');
             const userConfig = JSON.parse(configContent);
             return {
-                enabled: userConfig.enabled !== undefined ? userConfig.enabled : DEFAULT_CONFIG.enabled
+                enabled: userConfig.enabled !== undefined ? userConfig.enabled : DEFAULT_CONFIG.enabled,
             };
         }
         catch (error) {
@@ -43,7 +48,7 @@ function renderStatusReport(status, config) {
         '',
         'Peak Hours (UTC+8):',
         `- start: 14:00`,
-        `- end: 18:00`
+        `- end: 18:00`,
     ];
     return lines.join('\n');
 }
@@ -56,70 +61,66 @@ export const PeakHours = async ({ client }) => {
                 path: { id: sessionID },
                 body: {
                     noReply: true,
-                    parts: [{ type: 'text', text: output, ignored: true }]
-                }
+                    parts: [{ type: 'text', text: output, ignored: true }],
+                },
             });
         }
         catch (err) {
             console.error('Failed to inject output:', err);
         }
     }
-    async function handlePeakHoursCommand(sessionID) {
+    async function injectCommandOutputAndHandle(sessionID, output) {
+        if (output !== undefined && output !== null) {
+            await injectRawOutput(sessionID, output);
+        }
+        handled();
+    }
+    async function handlePeakHoursSlashCommand(input) {
+        if (!config.enabled) {
+            return await injectCommandOutputAndHandle(input.sessionID, 'Peak Hours plugin is disabled');
+        }
         const status = getPeakHoursStatus();
         const output = formatPeakHoursMessage(status);
-        await injectRawOutput(sessionID, output);
-        handled();
+        return await injectCommandOutputAndHandle(input.sessionID, output);
     }
-    async function handlePeakHoursStatusCommand(sessionID) {
+    async function handlePeakHoursStatusSlashCommand(input) {
+        if (!config.enabled) {
+            return await injectCommandOutputAndHandle(input.sessionID, 'Peak Hours plugin is disabled');
+        }
         const status = getPeakHoursStatus();
         const output = renderStatusReport(status, config);
-        await injectRawOutput(sessionID, output);
-        handled();
+        return await injectCommandOutputAndHandle(input.sessionID, output);
     }
     return {
+        // Register built-in slash commands
         config: async (input) => {
-            input.output.command = {
-                peak_hours: {
-                    template: '',
-                    description: 'Display current z.ai peak hours status and time until next transition'
-                },
-                peak_hours_status: {
-                    template: '',
-                    description: 'Display peak hours plugin diagnostics and configuration status'
-                }
+            const cfg = input;
+            cfg.command ??= {};
+            cfg.command['peak_hours'] = {
+                template: '/peak_hours',
+                description: 'Display current z.ai peak hours status and time until next transition',
+            };
+            cfg.command['peak_hours_status'] = {
+                template: '/peak_hours_status',
+                description: 'Display peak hours plugin diagnostics and configuration status',
             };
         },
-        'tui.command.execute': async (input) => {
-            const command = input.command;
-            const sessionID = input.sessionID;
-            if (!config.enabled) {
-                await injectRawOutput(sessionID, 'Peak Hours plugin is disabled');
-                return;
-            }
-            if (command === 'peak_hours') {
-                await handlePeakHoursCommand(sessionID);
-            }
-            else if (command === 'peak_hours_status') {
-                await handlePeakHoursStatusCommand(sessionID);
-            }
-        },
-        'session.created': async (input) => {
-            if (!config.enabled) {
-                return;
-            }
-            const status = getPeakHoursStatus();
-            const message = formatPeakHoursMessage(status);
+        // Intercept slash commands and handle them without LLM invocation
+        'command.execute.before': async (input) => {
             try {
-                await typedClient.tui.showToast({
-                    body: {
-                        message,
-                        variant: status.inPeakHours ? 'warning' : 'info'
-                    }
-                });
+                const cmd = input.command;
+                if (cmd === 'peak_hours') {
+                    return await handlePeakHoursSlashCommand(input);
+                }
+                if (cmd === 'peak_hours_status') {
+                    return await handlePeakHoursStatusSlashCommand(input);
+                }
             }
             catch (err) {
-                console.error('Failed to show toast:', err);
+                // IMPORTANT: do not swallow command-handled sentinel errors.
+                // If this hook resolves, the command proceeds to the LLM.
+                throw err;
             }
-        }
+        },
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@icaruk/zai-peak-hours",
-	"version": "0.1.0",
+	"version": "0.3.1",
 	"type": "module",
 	"description": "OpenCode plugin to display z.ai peak hours information with automatic timezone detection",
 	"main": "dist/index.js",