@icaruk/zai-peak-hours 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,14 @@
 # @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
+- 🔔 Toast notification on session start
+- 💬 Zero-token commands (`/peak_hours`, `/peak_hours_status`) - no LLM invocation
 
 ## Installation
 
@@ -12,23 +20,20 @@ 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
+
+These commands execute locally without invoking LLM (zero token usage) via `command.execute.before` hook.
 
 ## Messages
 
-The plugin displays toast notifications:
+The plugin displays a toast notification when a new session is created:
 
 **Peak Hours:**
 ```
@@ -40,6 +45,16 @@ Currently in peak hours. X hours Y minutes remaining
 Currently in off-peak hours. X hours Y minutes remaining
 ```
 
+## Configuration
+
+Optional configuration file at `~/.config/opencode/peak-hours.json`:
+
+```json
+{
+  "enabled": true
+}
+```
+
 ## Development
 
 ```bash
@@ -57,7 +72,7 @@ npm run build
 npm run dev
 ```
 
-Add local config in `opencode.json`
+Add local config in `opencode.json`:
 
 ```json
 {

package/dist/command-handled.d.ts

@@ -0,0 +1,2 @@
+export declare const COMMAND_HANDLED_SENTINEL: "__PEAK_HOURS_COMMAND_HANDLED__";
+export declare function handled(): never;

package/dist/command-handled.js

@@ -0,0 +1,4 @@
+export const COMMAND_HANDLED_SENTINEL = "__PEAK_HOURS_COMMAND_HANDLED__";
+export function handled() {
+    throw new Error(COMMAND_HANDLED_SENTINEL);
+}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import type { Plugin } from '@opencode-ai/plugin';
-export declare const PeakHours: Plugin;
+export { PeakHoursPlugin } from "./plugin.js";
+export type { PeakHoursStatus, } from "./peak-hours.js";

package/dist/index.js

@@ -1,125 +1 @@
-import { getPeakHoursStatus, formatPeakHoursMessage } from './peak-hours';
-import { DEFAULT_CONFIG } from './config';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-function getConfigPath() {
-    const configDir = process.env.XDG_CONFIG_HOME
-        ? path.join(process.env.XDG_CONFIG_HOME, 'opencode')
-        : path.join(process.env.HOME || process.env.USERPROFILE || '', '.config', 'opencode');
-    return path.join(configDir, 'peak-hours.json');
-}
-function loadConfig() {
-    const configPath = getConfigPath();
-    if (fs.existsSync(configPath)) {
-        try {
-            const configContent = fs.readFileSync(configPath, 'utf-8');
-            const userConfig = JSON.parse(configContent);
-            return {
-                enabled: userConfig.enabled !== undefined ? userConfig.enabled : DEFAULT_CONFIG.enabled
-            };
-        }
-        catch (error) {
-            console.error('Error loading peak-hours config:', error);
-        }
-    }
-    return DEFAULT_CONFIG;
-}
-function renderCommandHeading(title) {
-    return `${title}\n${'='.repeat(title.length)}`;
-}
-function renderStatusReport(status, config) {
-    const currentTime = new Date().toISOString();
-    const lines = [
-        renderCommandHeading('Peak Hours Status'),
-        '',
-        'Configuration:',
-        `- enabled: ${config.enabled}`,
-        '',
-        'Current Status:',
-        `- current_time: ${currentTime}`,
-        `- in_peak_hours: ${status.inPeakHours}`,
-        `- transition: ${status.transitionType}`,
-        `- time_until_${status.transitionType}: ${status.timeUntilTransition}`,
-        '',
-        'Peak Hours (UTC+8):',
-        `- start: 14:00`,
-        `- end: 18:00`
-    ];
-    return lines.join('\n');
-}
-export const PeakHours = async ({ client }) => {
-    const config = loadConfig();
-    const typedClient = client;
-    async function injectRawOutput(sessionID, output) {
-        try {
-            await typedClient.session.prompt({
-                path: { id: sessionID },
-                body: {
-                    noReply: true,
-                    parts: [{ type: 'text', text: output, ignored: true }]
-                }
-            });
-        }
-        catch (err) {
-            console.error('Failed to inject output:', err);
-        }
-    }
-    async function handlePeakHoursCommand(sessionID) {
-        const status = getPeakHoursStatus();
-        const output = formatPeakHoursMessage(status);
-        await injectRawOutput(sessionID, output);
-        handled();
-    }
-    async function handlePeakHoursStatusCommand(sessionID) {
-        const status = getPeakHoursStatus();
-        const output = renderStatusReport(status, config);
-        await injectRawOutput(sessionID, output);
-        handled();
-    }
-    return {
-        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'
-                }
-            };
-        },
-        '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);
-            try {
-                await typedClient.tui.showToast({
-                    body: {
-                        message,
-                        variant: status.inPeakHours ? 'warning' : 'info'
-                    }
-                });
-            }
-            catch (err) {
-                console.error('Failed to show toast:', err);
-            }
-        }
-    };
-};
+export { PeakHoursPlugin } from "./plugin.js";

package/dist/plugin.d.ts

@@ -0,0 +1,2 @@
+import type { Plugin } from '@opencode-ai/plugin';
+export declare const PeakHoursPlugin: Plugin;

package/dist/plugin.js

@@ -0,0 +1,90 @@
+import { getPeakHoursStatus, formatPeakHoursMessage } from './peak-hours';
+import { DEFAULT_CONFIG } from './config';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+function getConfigPath() {
+    const configDir = process.env.XDG_CONFIG_HOME
+        ? path.join(process.env.XDG_CONFIG_HOME, 'opencode')
+        : path.join(process.env.HOME || process.env.USERPROFILE || '', '.config', 'opencode');
+    return path.join(configDir, 'peak-hours.json');
+}
+function loadConfig() {
+    const configPath = getConfigPath();
+    if (fs.existsSync(configPath)) {
+        try {
+            const configContent = fs.readFileSync(configPath, 'utf-8');
+            const userConfig = JSON.parse(configContent);
+            return {
+                enabled: userConfig.enabled !== undefined ? userConfig.enabled : DEFAULT_CONFIG.enabled
+            };
+        }
+        catch (error) {
+            console.error('Error loading peak-hours config:', error);
+        }
+    }
+    return DEFAULT_CONFIG;
+}
+function renderCommandHeading(title) {
+    return `${title}\n${'='.repeat(title.length)}`;
+}
+function renderStatusReport(status, config) {
+    const currentTime = new Date().toISOString();
+    const lines = [
+        renderCommandHeading('Peak Hours Status'),
+        '',
+        'Configuration:',
+        `- enabled: ${config.enabled}`,
+        '',
+        'Current Status:',
+        `- current_time: ${currentTime}`,
+        `- in_peak_hours: ${status.inPeakHours}`,
+        `- transition: ${status.transitionType}`,
+        `- time_until_${status.transitionType}: ${status.timeUntilTransition}`,
+        '',
+        'Peak Hours (UTC+8):',
+        `- start: 14:00`,
+        `- end: 18:00`
+    ];
+    return lines.join('\n');
+}
+export const PeakHoursPlugin = async ({ client }) => {
+    const config = loadConfig();
+    const typedClient = client;
+    return {
+        'command.execute.before': async (input, output) => {
+            const command = input.command;
+            if (!config.enabled) {
+                output.parts = [{ type: 'text', text: 'Peak Hours plugin is disabled', ignored: true }];
+                return;
+            }
+            if (command === 'peak_hours') {
+                const status = getPeakHoursStatus();
+                const message = formatPeakHoursMessage(status);
+                output.parts = [{ type: 'text', text: message, ignored: true }];
+            }
+            else if (command === 'peak_hours_status') {
+                const status = getPeakHoursStatus();
+                const report = renderStatusReport(status, config);
+                output.parts = [{ type: 'text', text: report, ignored: true }];
+            }
+        },
+        'session.created': async (_input) => {
+            if (!config.enabled) {
+                return;
+            }
+            const status = getPeakHoursStatus();
+            const message = formatPeakHoursMessage(status);
+            try {
+                await typedClient.tui.showToast({
+                    body: {
+                        message,
+                        variant: status.inPeakHours ? 'warning' : 'info'
+                    }
+                });
+            }
+            catch (err) {
+                console.error('Failed to show toast:', err);
+            }
+        }
+    };
+};

package/package.json

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