maskweaver 0.8.5 → 0.8.7

package/dist/plugin/index.js

@@ -12,16 +12,13 @@
 * Based on oh-my-opencode plugin development patterns.
 */
 import { z } from 'zod';
-// Inline shim: tool() is just an identity function in @opencode-ai/plugin
-// We inline it to avoid bundler resolution bugs with the upstream package
-const tool = (input) => input;
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
+import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
-import { parse as parseYaml } from 'yaml';
 import { VERSION } from '../version.js';
-import { loadPluginConfig, isMaskEnabled, isToolEnabled, getDefaultMask, isAutoActivateEnabled, getAgentOverride, isVerboseLoggingEnabled, validateConfig, } from './config/index.js';
+import { loadPluginConfig, isMaskEnabled, isToolEnabled, getDefaultMask, isAutoActivateEnabled, isVerboseLoggingEnabled, isCompletionSoundEnabled, validateConfig, } from './config/index.js';
 // New tool imports
 import { createMemorySearchTool } from './tools/memorySearch.js';
 import { createMemoryWriteTool } from './tools/memoryWrite.js';
@@ -424,8 +421,17 @@ function buildRichPrompt(mask) {
     }
     return parts.join('\n');
 }
+function pluginLog(client, level, message) {
+    client.app.log({
+        body: {
+            service: 'maskweaver',
+            level,
+            message,
+        },
+    });
+}
 // ============================================================================
-// Tool Factory Functions (oh-my-opencode pattern)
+// Helper functions for tool factories
 // ============================================================================
 function createListMasksTool(maskLoader, activeMask) {
     return {
@@ -553,82 +559,56 @@ Active mask: ${active ? `${active.profile.name} (${active.metadata.id})` : 'none
         },
     };
 }
-let state = null;
-function parseAgentMarkdown(content) {
-    const parts = content.split('---');
-    if (parts.length < 3) {
-        return { prompt: content.trim() };
-    }
+function getSessionId(event) {
+    if (typeof event.sessionID === 'string')
+        return event.sessionID;
+    if (typeof event.sessionId === 'string')
+        return event.sessionId;
+    return null;
+}
+function runSoundCommand(command, args) {
     try {
-        const frontmatter = parseYaml(parts[1]);
-        const prompt = parts.slice(2).join('---').trim();
-        return { ...frontmatter, prompt };
+        const result = spawnSync(command, args, {
+            stdio: 'ignore',
+            windowsHide: true,
+            timeout: 2500,
+        });
+        return !result.error && result.status === 0;
     }
-    catch (e) {
-        return { prompt: content.trim() };
+    catch {
+        return false;
     }
 }
-// ============================================================================
-// Default Embedded Agents (ensures first-run works without restart)
-// ============================================================================
-const DEFAULT_AGENTS = {
-    'dummy-human': {
-        description: 'Dummy-Human - Pure execution agent that performs tasks with masks assigned by Mask Weaver',
-        mode: 'subagent',
-        temperature: 0.2,
-        permission: {
-            edit: 'allow',
-            bash: 'allow',
-            webfetch: 'allow',
-        },
-        prompt: `# Dummy-Human
-
-You are a **Dummy-Human**.
-
-## Identity
-
-You are a pure execution agent. You accurately perform work instructions received from the Mask Weaver.
-
-## Behavior Principles
-
-1. If the Mask Weaver provides a **mask (persona)**, become that expert and work accordingly
-2. If no mask is provided, work as a competent software engineer
-3. Complete assigned tasks accurately
-4. Report results clearly
-
-## Result Reporting
-
-When work is complete:
-- Summary of work performed
-- Generated outputs
-- Additional considerations (if any)`,
-    },
-};
-function loadAgentAssets(...assetsDirs) {
-    // Start with default embedded agents (always available)
-    const agents = { ...DEFAULT_AGENTS };
-    // Load from each directory in order (later directories override earlier ones)
-    for (const assetsDir of assetsDirs) {
-        const agentsDir = path.join(assetsDir, 'agents');
-        if (!fs.existsSync(agentsDir))
-            continue;
+function playCompletionSound(config) {
+    if (!isCompletionSoundEnabled(config))
+        return;
+    let played = false;
+    if (process.platform === 'win32') {
+        played = runSoundCommand('powershell', [
+            '-NoProfile',
+            '-NonInteractive',
+            '-Command',
+            '[console]::beep(880,220)',
+        ]);
+    }
+    else if (process.platform === 'darwin') {
+        played = runSoundCommand('afplay', ['/System/Library/Sounds/Glass.aiff']);
+    }
+    else if (process.platform === 'linux') {
+        played = runSoundCommand('canberra-gtk-play', ['-i', 'complete', '-d', 'maskweaver']);
+    }
+    if (!played) {
         try {
-            const files = fs.readdirSync(agentsDir);
-            for (const file of files) {
-                if (file.endsWith('.md') && file !== 'dummy-template.md') {
-                    const agentId = path.basename(file, '.md');
-                    const content = fs.readFileSync(path.join(agentsDir, file), 'utf-8');
-                    agents[agentId] = parseAgentMarkdown(content);
-                }
-            }
+            process.stdout.write('\u0007');
         }
-        catch (e) {
-            // Ignore errors - default agents still available
+        catch {
+            // Ignore failures - notification sound is best-effort only.
         }
     }
-    return agents;
 }
-export const MaskweaverPlugin = async ({ client, directory }) => {
+let state = null;
+// ============================================================================
+export const MaskweaverPlugin = async ({ client, directory, project, worktree, $, serverUrl }) => {
     // ==========================================================================
     // 1. Load Configuration (oh-my-opencode pattern)
     // ==========================================================================
@@ -636,11 +616,7 @@ export const MaskweaverPlugin = async ({ client, directory }) => {
     // Validate configuration
     const configErrors = validateConfig(pluginConfig);
     if (configErrors.length > 0) {
-        client.app.log({
-            service: 'maskweaver',
-            level: 'warn',
-            message: `Configuration validation errors: ${configErrors.join(', ')}`,
-        });
+        pluginLog(client, 'warn', `Configuration validation errors: ${configErrors.join(', ')}`);
     }
     const verbose = isVerboseLoggingEnabled(pluginConfig);
     // ==========================================================================
@@ -650,24 +626,12 @@ export const MaskweaverPlugin = async ({ client, directory }) => {
     // Track if this is a first-time installation
     const isFirstInstall = installResult.installed.length > 0;
     if (isFirstInstall) {
-        client.app.log({
-            service: 'maskweaver',
-            level: 'info',
-            message: `Installed ${installResult.installed.length} files to .opencode/ (agents, masks)`,
-        });
+        pluginLog(client, 'info', `Installed ${installResult.installed.length} files to .opencode/ (agents, masks)`);
         // Show prominent restart message for first-time installation
-        client.app.log({
-            service: 'maskweaver',
-            level: 'warn',
-            message: `⚠️ RESTART REQUIRED: Please restart OpenCode to activate all Maskweaver features (agents, masks, commands).`,
-        });
+        pluginLog(client, 'warn', `⚠️ RESTART REQUIRED: Please restart OpenCode to activate all Maskweaver features (agents, masks, commands).`);
     }
     if (installResult.errors.length > 0) {
-        client.app.log({
-            service: 'maskweaver',
-            level: 'warn',
-            message: `Asset errors: ${installResult.errors.join(', ')}`,
-        });
+        pluginLog(client, 'warn', `Asset errors: ${installResult.errors.join(', ')}`);
     }
     // ==========================================================================
     // 3. Initialize masks
@@ -677,37 +641,27 @@ export const MaskweaverPlugin = async ({ client, directory }) => {
     const projectMasksDir = path.join(directory, '.opencode', 'masks');
     // Priority: project masks > global masks
     const masksDir = fs.existsSync(projectMasksDir) ? projectMasksDir : globalMasksDir;
-    state = {
+    const pluginState = {
         maskLoader: null,
         activeMask: null,
         masksDir,
         config: pluginConfig,
+        currentSessionID: null,
     };
+    state = pluginState;
     // Log plugin loaded
-    client.app.log({
-        service: 'maskweaver',
-        level: 'info',
-        message: `Maskweaver plugin loaded v${VERSION}`,
-    });
+    pluginLog(client, 'info', `Maskweaver plugin loaded v${VERSION}`);
     if (fs.existsSync(masksDir)) {
-        state.maskLoader = new MaskLoader(masksDir, pluginConfig);
+        pluginState.maskLoader = new MaskLoader(masksDir, pluginConfig);
         try {
-            await state.maskLoader.loadCatalog();
+            await pluginState.maskLoader.loadCatalog();
             if (verbose) {
-                client.app.log({
-                    service: 'maskweaver',
-                    level: 'info',
-                    message: `Masks found at: ${masksDir}`,
-                });
+                pluginLog(client, 'info', `Masks found at: ${masksDir}`);
             }
         }
         catch (e) {
-            client.app.log({
-                service: 'maskweaver',
-                level: 'warn',
-                message: `Failed to load masks: ${e}`,
-            });
-            state.maskLoader = null;
+            pluginLog(client, 'warn', `Failed to load masks: ${e}`);
+            pluginState.maskLoader = null;
         }
     }
     // ==========================================================================
@@ -715,40 +669,27 @@ export const MaskweaverPlugin = async ({ client, directory }) => {
     // ==========================================================================
     const defaultMaskId = getDefaultMask(pluginConfig);
     const autoActivate = isAutoActivateEnabled(pluginConfig);
-    if (defaultMaskId && autoActivate && state.maskLoader) {
+    if (defaultMaskId && autoActivate && pluginState.maskLoader) {
         try {
-            const defaultMask = await state.maskLoader.load(defaultMaskId);
+            const defaultMask = await pluginState.maskLoader.load(defaultMaskId);
             if (defaultMask) {
-                state.activeMask = defaultMask;
-                client.app.log({
-                    service: 'maskweaver',
-                    level: 'info',
-                    message: `Auto-activated default mask: ${defaultMaskId} (${defaultMask.profile.name})`,
-                });
+                pluginState.activeMask = defaultMask;
+                pluginLog(client, 'info', `Auto-activated default mask: ${defaultMaskId} (${defaultMask.profile.name})`);
             }
             else {
-                client.app.log({
-                    service: 'maskweaver',
-                    level: 'warn',
-                    message: `Default mask "${defaultMaskId}" not found or disabled`,
-                });
+                pluginLog(client, 'warn', `Default mask "${defaultMaskId}" not found or disabled`);
             }
         }
         catch (e) {
-            client.app.log({
-                service: 'maskweaver',
-                level: 'warn',
-                message: `Failed to auto-activate default mask: ${e}`,
-            });
+            pluginLog(client, 'warn', `Failed to auto-activate default mask: ${e}`);
         }
     }
     // ==========================================================================
     // 5. Helper functions for tool factories
     // ==========================================================================
-    const getActiveMask = () => state?.activeMask || null;
+    const getActiveMask = () => pluginState.activeMask;
     const setActiveMask = (mask) => {
-        if (state)
-            state.activeMask = mask;
+        pluginState.activeMask = mask;
     };
     // ==========================================================================
     // 6. Conditional tool registration (oh-my-opencode pattern)
@@ -756,28 +697,29 @@ export const MaskweaverPlugin = async ({ client, directory }) => {
     const isToolActive = (toolName) => isToolEnabled(pluginConfig, toolName);
     // Helper to ensure tool arguments are compatible with opencode's expected format.
     // opencode expects a ZodRawShape (raw object), NOT a ZodObject instance.
+    // Zod 4: schema.def.shape, Zod 3: schema._def.shape()
     const wrapSchema = (schema) => {
         if (!schema || typeof schema !== 'object')
             return schema;
-        // If it's a ZodObject (Zod 4), extract its shape
-        if (schema.def && typeof schema.def === 'object' && schema.type === 'object') {
+        // Zod 4 — def.shape is a plain object
+        if (schema.def && typeof schema.def === 'object' && schema.type === 'object' && schema.def.shape && typeof schema.def.shape === 'object') {
             return schema.def.shape;
         }
-        // If it's a ZodObject (Zod 3), extract its shape
+        // Zod 3 — _def.shape() returns a plain object
         if (schema._def && typeof schema._def.shape === 'function') {
             return schema._def.shape();
         }
         return schema;
     };
     const tools = {};
-    if (state.maskLoader) {
+    if (pluginState.maskLoader) {
         if (isToolActive('list_masks')) {
-            const tool = createListMasksTool(state.maskLoader, getActiveMask);
+            const tool = createListMasksTool(pluginState.maskLoader, getActiveMask);
             tool.args = wrapSchema(tool.args);
             tools.list_masks = tool;
         }
         if (isToolActive('select_mask')) {
-            const tool = createSelectMaskTool(state.maskLoader, getActiveMask, setActiveMask);
+            const tool = createSelectMaskTool(pluginState.maskLoader, getActiveMask, setActiveMask);
             tool.args = wrapSchema(tool.args);
             tools.select_mask = tool;
         }
@@ -787,13 +729,13 @@ export const MaskweaverPlugin = async ({ client, directory }) => {
             tools.deselect_mask = tool;
         }
         if (isToolActive('get_mask_prompt')) {
-            const tool = createGetMaskPromptTool(state.maskLoader, getActiveMask);
+            const tool = createGetMaskPromptTool(pluginState.maskLoader, getActiveMask);
             tool.args = wrapSchema(tool.args);
             tools.get_mask_prompt = tool;
         }
     }
     if (isToolActive('maskweaver_status')) {
-        const tool = createMaskweaverStatusTool(state.maskLoader, masksDir, getActiveMask);
+        const tool = createMaskweaverStatusTool(pluginState.maskLoader, masksDir, getActiveMask);
         tool.args = wrapSchema(tool.args);
         tools.maskweaver_status = tool;
     }
@@ -885,104 +827,20 @@ export const MaskweaverPlugin = async ({ client, directory }) => {
         };
     }
     // ==========================================================================
-    // 8. Load and register agents
+    // 8. Agents are loaded from .opencode/agents/*.md files by OpenCode's
+    //    filesystem-based agent loader (see config/agent.ts:110-140).
+    //    installAssets() in step 2 copies agent .md files so they are picked up.
+    //    The 'agent' property in Hooks is NOT consumed by OpenCode — confirmed
+    //    by source analysis (packages/opencode/src/plugin/index.ts:92-103).
     // ==========================================================================
-    const assetsDir = getAssetsDir();
-    const projectOpencodeDir = path.join(directory, '.opencode');
-    // Load from package assets first, then project .opencode (project overrides package)
-    const loadedAgents = loadAgentAssets(assetsDir, projectOpencodeDir);
     // ==========================================================================
-    // 8b. Generate agents from model pool (or legacy fallback)
-    // ==========================================================================
-    {
-        const { loadRuntimeConfig, normalizeDummyHumansConfig } = await import('../shared/config.js');
-        const { createModelRegistry } = await import('../shared/model-registry.js');
-        const runtimeConfig = loadRuntimeConfig(directory);
-        if (runtimeConfig.dummyHumans) {
-            const pool = normalizeDummyHumansConfig(runtimeConfig.dummyHumans);
-            // Initialize the global model registry
-            createModelRegistry(pool);
-            if (loadedAgents['dummy-human']) {
-                // Generate agent variants from pool entries
-                for (const entry of pool) {
-                    const agentName = `dummy-${entry.id}`;
-                    if (!loadedAgents[agentName]) {
-                        const tierLabel = entry.tier === 'flash' ? 'Flash' : entry.tier === 'premium' ? 'Premium' : 'Standard';
-                        const capStr = entry.capabilities.slice(0, 3).join(', ');
-                        loadedAgents[agentName] = {
-                            ...loadedAgents['dummy-human'],
-                            description: `Dummy-Human (${entry.id}) - ${tierLabel}. ${entry.description || capStr}. [max ${entry.maxConcurrent} concurrent]`,
-                            model: entry.model,
-                        };
-                    }
-                }
-                // Also ensure legacy dummy-flash / dummy-premium aliases exist (for backward compat)
-                const flashEntry = pool.find(e => e.tier === 'flash');
-                const humanEntry = pool.find(e => e.tier === 'human');
-                const premiumEntry = pool.find(e => e.tier === 'premium');
-                if (flashEntry && !loadedAgents['dummy-flash']) {
-                    loadedAgents['dummy-flash'] = loadedAgents[`dummy-${flashEntry.id}`];
-                }
-                if (humanEntry) {
-                    // dummy-human already exists as the base agent; just update its model from pool
-                    loadedAgents['dummy-human'].model = humanEntry.model;
-                }
-                if (premiumEntry && !loadedAgents['dummy-premium']) {
-                    loadedAgents['dummy-premium'] = loadedAgents[`dummy-${premiumEntry.id}`];
-                }
-                // Fallback: if no tier mapping found, use defaults
-                if (!loadedAgents['dummy-flash']) {
-                    loadedAgents['dummy-flash'] = {
-                        ...loadedAgents['dummy-human'],
-                        description: 'Dummy-Human (Flash) - Fast and cheap',
-                        model: 'google/gemini-2.0-flash',
-                    };
-                }
-                if (!loadedAgents['dummy-premium']) {
-                    loadedAgents['dummy-premium'] = {
-                        ...loadedAgents['dummy-human'],
-                        description: 'Dummy-Human (Premium) - Powerful and reasoning',
-                        model: 'google/gemini-2.0-pro-exp-02-05',
-                    };
-                }
-            }
-        }
-        else {
-            // No pool config → legacy hardcoded defaults
-            if (loadedAgents['dummy-human']) {
-                if (!loadedAgents['dummy-flash']) {
-                    loadedAgents['dummy-flash'] = {
-                        ...loadedAgents['dummy-human'],
-                        description: 'Dummy-Human (Flash) - Fast and cheap',
-                        model: 'google/gemini-2.0-flash',
-                    };
-                }
-                if (!loadedAgents['dummy-premium']) {
-                    loadedAgents['dummy-premium'] = {
-                        ...loadedAgents['dummy-human'],
-                        description: 'Dummy-Human (Premium) - Powerful and reasoning',
-                        model: 'google/gemini-2.0-pro-exp-02-05',
-                    };
-                }
-            }
-        }
-    }
-    // Apply config overrides to agents
-    for (const agentId of Object.keys(loadedAgents)) {
-        const override = getAgentOverride(pluginConfig, agentId);
-        if (override) {
-            if (override.model)
-                loadedAgents[agentId].model = override.model;
-            if (override.systemPrompt)
-                loadedAgents[agentId].prompt = override.systemPrompt;
-        }
-    }
-    // ==========================================================================
-    // 9. Return plugin hooks
+    // 9. Return plugin hooks (official OpenCode Hooks interface only)
+    //    Note: Agents are registered via .opencode/agents/*.md files (installed by
+    //    installAssets()), NOT via the plugin return. The Hooks type does not
+    //    include 'agent' — OpenCode loads agents from the filesystem exclusively.
     // ==========================================================================
     return {
-        // Agent registration
-        agent: loadedAgents,
+        // Agent registration handled via .opencode/agents/*.md files (see installAssets)
         // System prompt transform - inject active mask
         'experimental.chat.system.transform': async (_input, output) => {
             if (state?.activeMask) {
@@ -1000,40 +858,46 @@ ${buildRichPrompt(state.activeMask)}
         event: async ({ event }) => {
             // Session created - log available masks
             if (event.type === 'session.created') {
-                if (state?.maskLoader && verbose) {
+                pluginState.currentSessionID = getSessionId(event);
+                if (pluginState.maskLoader && verbose) {
                     try {
-                        const masks = await state.maskLoader.listAll();
-                        const categories = await state.maskLoader.listCategories();
-                        client.app.log({
-                            service: 'maskweaver',
-                            level: 'info',
-                            message: `Session started - ${masks.length} masks available across ${categories.length} categories`,
-                        });
+                        const masks = await pluginState.maskLoader.listAll();
+                        const categories = await pluginState.maskLoader.listCategories();
+                        pluginLog(client, 'info', `Session started - ${masks.length} masks available across ${categories.length} categories`);
                     }
                     catch (_e) {
                         // Ignore errors
                     }
                 }
             }
+            // Session idle - generation completed
+            if (event.type === 'session.idle') {
+                const idleSessionID = getSessionId(event);
+                const isCurrentSession = !idleSessionID ||
+                    !pluginState.currentSessionID ||
+                    idleSessionID === pluginState.currentSessionID;
+                if (isCurrentSession) {
+                    playCompletionSound(pluginState.config);
+                }
+            }
             // Session deleted - cleanup
             if (event.type === 'session.deleted') {
-                if (state && verbose) {
-                    const wasActive = state.activeMask !== null;
-                    state.activeMask = null;
+                const deletedSessionID = getSessionId(event);
+                if (!deletedSessionID || deletedSessionID === pluginState.currentSessionID) {
+                    pluginState.currentSessionID = null;
+                }
+                if (verbose) {
+                    const wasActive = pluginState.activeMask !== null;
+                    pluginState.activeMask = null;
                     if (wasActive) {
-                        client.app.log({
-                            service: 'maskweaver',
-                            level: 'info',
-                            message: 'Session ended - active mask cleared',
-                        });
+                        pluginLog(client, 'info', 'Session ended - active mask cleared');
                     }
                 }
             }
         },
-        // Config hook - (oh-my-opencode pattern)
+        // Config hook - allows plugins to modify opencode configuration
         config: async (config) => {
-            // NOTE: Current opencode version expects config to be a function, not an object.
-            // Agent overrides are currently not supported via this hook in opencode core.
+            // Reserved for future configuration injection (model, provider, etc.)
             return;
         },
     };