opencodekit 0.9.2 → 0.11.0

package/dist/template/.opencode/plugin/notification.ts

@@ -1,130 +1,64 @@
 /**
  * OpenCode Notification Plugin
  * Sends native notifications when sessions complete
- *
- * Cross-platform support:
- * - macOS: Built-in (osascript)
- * - Linux: notify-send (install: sudo apt install libnotify-bin)
- * - WSL: notify-send + dunst (requires setup)
  */
 
 import type { Plugin } from "@opencode-ai/plugin";
-import { exec } from "child_process";
-import { readFileSync } from "fs";
-
-// Notification helpers
-function isWSL(): boolean {
-  try {
-    const release = readFileSync("/proc/version", "utf8").toLowerCase();
-    return release.includes("microsoft") || release.includes("wsl");
-  } catch {
-    return false;
-  }
-}
-
-function escapeShell(str: string): string {
-  return str.replace(/"/g, '\\"').replace(/\$/g, "\\$").replace(/`/g, "\\`");
-}
-
-function notify(title: string, message: string): void {
-  const platform = process.platform;
-  const safeTitle = title ? String(title) : "Notification";
-  const safeMessage = message ? String(message) : "";
-  const escapedTitle = escapeShell(safeTitle);
-  const escapedMessage = escapeShell(safeMessage);
-
-  let command: string;
-
-  if (platform === "darwin") {
-    command = `osascript -e 'display notification "${escapedMessage}" with title "${escapedTitle}"'`;
-  } else if (platform === "linux") {
-    command = `notify-send "${escapedTitle}" "${escapedMessage}"`;
-    if (isWSL()) {
-      command = `(${command}) 2>&1 || echo "WSL notification failed. Ensure dunst is running: dunst >/dev/null 2>&1 &"`;
-    }
-  } else if (platform === "win32") {
-    command = `powershell -Command "Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show('${escapedMessage}', '${escapedTitle}')"`;
-  } else {
-    return;
-  }
-
-  exec(command, () => {});
-}
-
-export const NotificationPlugin: Plugin = async ({ client }) => {
-  const notifiedSessions = new Set<string>();
-
-  client.app
-    .log({
-      body: {
-        service: "notification-plugin",
-        level: "info",
-        message: "🔔 Notification Plugin loaded",
-      },
-    })
-    .catch(() => {});
-
-  return {
-    event: async ({ event }) => {
-      if (event.type === "session.idle") {
-        const sessionId = event.properties?.sessionID;
-
-        if (!sessionId || notifiedSessions.has(sessionId)) {
-          return;
-        }
-        notifiedSessions.add(sessionId);
-
-        setTimeout(async () => {
-          try {
-            let summary = "Session completed";
-
-            const messagesResponse = await client.session.messages({
-              path: { id: sessionId },
-            });
-
-            if (messagesResponse.data && Array.isArray(messagesResponse.data)) {
-              const lastUserMessage = messagesResponse.data
-                .filter((m) => m.info.role === "user")
-                .pop();
-
-              const messageSummary = lastUserMessage?.info?.summary;
-              if (
-                messageSummary &&
-                typeof messageSummary === "object" &&
-                messageSummary !== null
-              ) {
-                if ("body" in messageSummary && messageSummary.body) {
-                  summary = String(messageSummary.body).trim().slice(0, 100);
-                } else if ("title" in messageSummary && messageSummary.title) {
-                  summary = String(messageSummary.title).trim();
-                }
-              }
-            }
-
-            notify("OpenCode", summary);
-
-            client.app
-              .log({
-                body: {
-                  service: "notification-plugin",
-                  level: "info",
-                  message: `✅ Notification sent: ${summary}`,
-                },
-              })
-              .catch(() => {});
-          } catch (error) {
-            client.app
-              .log({
-                body: {
-                  service: "notification-plugin",
-                  level: "warn",
-                  message: `⚠️ Notification failed: ${(error as Error).message}`,
-                },
-              })
-              .catch(() => {});
-          }
-        }, 2000);
-      }
-    },
-  };
+import { notify } from "./lib/notify";
+
+export const NotificationPlugin: Plugin = async ({ client, $ }) => {
+	const notifiedSessions = new Set<string>();
+
+	return {
+		event: async ({ event }) => {
+			if (event.type === "session.idle") {
+				const props = event.properties as Record<string, unknown>;
+				const sessionId = props?.sessionID as string | undefined;
+
+				if (!sessionId || notifiedSessions.has(sessionId)) return;
+				notifiedSessions.add(sessionId);
+
+				setTimeout(async () => {
+					try {
+						let summary = "Session completed";
+
+						const messagesResponse = await client.session.messages({
+							path: { id: sessionId },
+						});
+
+						if (messagesResponse.data && Array.isArray(messagesResponse.data)) {
+							const lastUserMessage = messagesResponse.data
+								.filter((m) => m.info.role === "user")
+								.pop();
+
+							const messageSummary = lastUserMessage?.info?.summary;
+							if (
+								messageSummary &&
+								typeof messageSummary === "object" &&
+								messageSummary !== null
+							) {
+								if ("body" in messageSummary && messageSummary.body) {
+									summary = String(messageSummary.body).trim().slice(0, 100);
+								} else if ("title" in messageSummary && messageSummary.title) {
+									summary = String(messageSummary.title).trim();
+								}
+							}
+						}
+
+						await notify($, "OpenCode", summary);
+					} catch (error) {
+						client.app
+							.log({
+								body: {
+									service: "notification",
+									level: "warn",
+									message: `Notification failed: ${(error as Error).message}`,
+								},
+							})
+							.catch(() => {});
+					}
+				}, 2000);
+			}
+		},
+	};
 };

package/dist/template/.opencode/plugin/truncator.ts

@@ -1,190 +1,84 @@
 /**
  * OpenCode Truncator Plugin
- * Dynamic output truncation utilities - smarter than fixed limits
+ * Monitors tool output sizes and warns about large outputs
  *
- * Inspired by oh-my-opencode's grep-output-truncator and tool-output-truncator
- *
- * NOTE: OpenCode doesn't currently expose tool.execute.before/after events for
- * output modification. This plugin provides utility functions that can be used
- * by other plugins or integrated when the API supports it.
+ * NOTE: tool.execute.after hook is observation-only (returns void).
+ * Actual truncation would require OpenCode core changes.
+ * This plugin logs warnings when outputs are large under context pressure.
  */
 
 import type { Plugin } from "@opencode-ai/plugin";
-
-// Configuration
-const CONFIG = {
-	// Base limits (chars) - adjusted dynamically based on context usage
-	BASE_LIMITS: {
-		grep: 15000,
-		glob: 10000,
-		read: 30000,
-		bash: 20000,
-		default: 25000,
-	} as Record<string, number>,
-	// Context percentage thresholds for scaling
-	SCALE_FACTORS: [
-		{ threshold: 95, factor: 0.3 },
-		{ threshold: 85, factor: 0.5 },
-		{ threshold: 70, factor: 0.7 },
-		{ threshold: 50, factor: 1.0 },
-	],
-	// Minimum output to preserve (chars)
-	MIN_OUTPUT: 2000,
-};
-
-/**
- * Get scale factor based on context usage percentage
- */
-function getScaleFactor(contextPct: number): number {
-	for (const { threshold, factor } of CONFIG.SCALE_FACTORS) {
-		if (contextPct >= threshold) {
-			return factor;
-		}
-	}
-	return 1.0;
-}
-
-/**
- * Get dynamic limit for a tool based on context usage
- */
-export function getLimit(tool: string, contextPct: number): number {
-	const baseLimit = CONFIG.BASE_LIMITS[tool] || CONFIG.BASE_LIMITS.default;
-	const scaleFactor = getScaleFactor(contextPct);
-	return Math.max(CONFIG.MIN_OUTPUT, Math.floor(baseLimit * scaleFactor));
-}
-
-/**
- * Ensure output is a string - handles objects, arrays, null, undefined
- */
-function ensureString(output: unknown): string {
-	if (typeof output === "string") {
-		return output;
-	}
-	if (output === null || output === undefined) {
-		return "";
-	}
-	if (typeof output === "object") {
-		try {
-			return JSON.stringify(output, null, 2);
-		} catch {
-			return String(output);
-		}
-	}
-	return String(output);
-}
-
-/**
- * Smart truncation with context preservation
- */
-export function smartTruncate(
-	output: unknown,
-	limit: number,
-	tool: string,
-): string {
-	// Ensure we're working with a string
-	const str = ensureString(output);
-
-	// Return as-is if within limit or empty
-	if (!str || str.length <= limit) return str;
-
-	const truncatedChars = str.length - limit;
-	const truncationMsg = `\n\n[... truncated ${truncatedChars} chars to save context ...]`;
-
-	// Smart truncation strategies based on tool type
-	if (tool === "grep" || tool === "glob") {
-		// For search results: keep first and last results
-		const lines = str.split("\n");
-		const targetLines = Math.floor(limit / 80); // Assume ~80 chars per line
-
-		if (lines.length > targetLines && targetLines > 0) {
-			const keepStart = Math.max(1, Math.floor(targetLines * 0.7));
-			const keepEnd = Math.max(1, targetLines - keepStart);
-			return [
-				...lines.slice(0, keepStart),
-				`\n... [${lines.length - keepStart - keepEnd} lines truncated] ...\n`,
-				...lines.slice(-keepEnd),
-			].join("\n");
-		}
-	}
-
-	if (tool === "read") {
-		// For file reads: keep beginning and end
-		const keepStart = Math.floor(limit * 0.7);
-		const keepEnd = limit - keepStart;
-		if (keepStart > 0 && keepEnd > 0) {
-			return str.slice(0, keepStart) + truncationMsg + str.slice(-keepEnd);
-		}
-	}
-
-	if (tool === "bash") {
-		// For bash: prefer keeping the end (usually most relevant)
-		const keepStart = Math.floor(limit * 0.3);
-		const keepEnd = limit - keepStart;
-		if (keepStart > 0 && keepEnd > 0) {
-			return str.slice(0, keepStart) + truncationMsg + str.slice(-keepEnd);
-		}
-	}
-
-	// Default: balanced truncation
-	const keepStart = Math.floor(limit * 0.6);
-	const keepEnd = limit - keepStart;
-	if (keepStart > 0 && keepEnd > 0) {
-		return str.slice(0, keepStart) + truncationMsg + str.slice(-keepEnd);
-	}
-
-	// Fallback: just take first `limit` chars
-	return str.slice(0, limit) + truncationMsg;
+import {
+	THRESHOLDS,
+	type TokenStats,
+	getContextPercentage,
+} from "./lib/notify";
+
+// Warning thresholds for output size (chars)
+const OUTPUT_WARN = {
+	MODERATE: 20000, // Warn if output > 20k at 70%+ context
+	URGENT: 10000, // Warn if output > 10k at 85%+ context
+	CRITICAL: 5000, // Warn if output > 5k at 95%+ context
+} as const;
+
+function getOutputThreshold(percentage: number): number | null {
+	if (percentage >= THRESHOLDS.CRITICAL) return OUTPUT_WARN.CRITICAL;
+	if (percentage >= THRESHOLDS.URGENT) return OUTPUT_WARN.URGENT;
+	if (percentage >= THRESHOLDS.MODERATE) return OUTPUT_WARN.MODERATE;
+	return null; // No warning under 70%
 }
 
 export const TruncatorPlugin: Plugin = async ({ client }) => {
-	// Track current context usage for external access
-	let currentContextPct = 0;
-
-	client.app
-		.log({
-			body: {
-				service: "truncator-plugin",
-				level: "info",
-				message:
-					"✂️ Truncator Plugin loaded - dynamic truncation utilities available",
-			},
-		})
-		.catch(() => {});
+	// Track context percentage per session
+	const sessionContext = new Map<string, number>();
 
 	return {
 		event: async ({ event }) => {
 			const props = event.properties as Record<string, unknown>;
 
-			// Track context usage from session updates
+			// Update context tracking from session updates
 			if (event.type === "session.updated") {
 				const info = props?.info as Record<string, unknown> | undefined;
 				const tokenStats = (info?.tokens || props?.tokens) as
-					| { percentage?: number }
+					| TokenStats
 					| undefined;
+				const sessionId = (info?.id || props?.sessionID) as string | undefined;
 
-				if (tokenStats?.percentage) {
-					const prevPct = currentContextPct;
-					currentContextPct = tokenStats.percentage;
-
-					// Log when crossing thresholds
-					const thresholds = [50, 70, 85, 95];
-					for (const t of thresholds) {
-						if (prevPct < t && currentContextPct >= t) {
-							const limit = getLimit("default", currentContextPct);
-							client.app
-								.log({
-									body: {
-										service: "truncator-plugin",
-										level: "debug",
-										message: `✂️ Context at ${currentContextPct}% - dynamic limit now ${limit} chars`,
-									},
-								})
-								.catch(() => {});
-							break;
-						}
-					}
+				if (sessionId && tokenStats?.used && tokenStats?.limit) {
+					sessionContext.set(sessionId, getContextPercentage(tokenStats));
 				}
 			}
+
+			if (event.type === "session.deleted") {
+				const sessionId = props?.sessionID as string | undefined;
+				if (sessionId) sessionContext.delete(sessionId);
+			}
+		},
+
+		"tool.execute.after": async (input, output) => {
+			const toolName = input.tool;
+			const sessionId = input.sessionID;
+
+			// Get current context pressure
+			const percentage = sessionContext.get(sessionId) || 0;
+			const threshold = getOutputThreshold(percentage);
+
+			// Only check when under pressure
+			if (!threshold) return;
+
+			// Check output size
+			const outputStr = output.output || "";
+			if (outputStr.length > threshold) {
+				client.app
+					.log({
+						body: {
+							service: "truncator",
+							level: percentage >= THRESHOLDS.CRITICAL ? "warn" : "info",
+							message: `Large output from ${toolName}: ${outputStr.length} chars (threshold: ${threshold}, context: ${percentage}%)`,
+						},
+					})
+					.catch(() => {});
+			}
 		},
 	};
 };

package/dist/template/.opencode/skill/mqdh/SKILL.md

@@ -0,0 +1,161 @@
+---
+name: mqdh
+description: Meta Quest Developer Hub MCP for VR/AR development. Access Meta Horizon OS docs, ADB tools, device management. Use when building Quest apps or need Meta XR documentation.
+mcp:
+  mqdh:
+    command: "${MQDH_MCP_PATH}"
+    args: []
+---
+
+# Meta Quest Developer Hub MCP
+
+Access Meta Horizon OS development tools via the MQDH MCP server. This MCP is **bundled with the Meta Quest Developer Hub application** (v6.2.1+).
+
+## Prerequisites
+
+### 1. Install MQDH
+
+Download and install Meta Quest Developer Hub v6.2.1 or later:
+
+- **macOS**: [Download MQDH for Mac](https://developers.meta.com/horizon/documentation/android-apps/meta-quest-developer-hub)
+- **Windows**: [Download MQDH for Windows](https://developers.meta.com/horizon/documentation/android-apps/meta-quest-developer-hub)
+
+### 2. Set MCP Path Environment Variable
+
+The MCP server is bundled with MQDH. Set the path to the MCP executable:
+
+**macOS:**
+
+```bash
+export MQDH_MCP_PATH="/Applications/Meta Quest Developer Hub.app/Contents/Resources/mcp-server"
+```
+
+**Windows:**
+
+```powershell
+$env:MQDH_MCP_PATH = "C:\Program Files\Meta Quest Developer Hub\resources\mcp-server.exe"
+```
+
+> **Note**: Paths may vary based on your installation. Check MQDH's AI Tools settings tab for the exact path.
+
+### 3. Alternative: Use MQDH's Built-in Setup
+
+MQDH v6.2.1+ includes an **AI Tools settings tab** with:
+
+- One-click install for **Cursor** and **VS Code**
+- Guided setup for Claude Desktop, Gemini CLI, Android Studio
+- Manual configuration export for other tools
+
+## Quick Start
+
+After setting up the environment variable and loading this skill:
+
+```
+skill_mcp(skill_name="mqdh", list_tools=true)
+```
+
+Then invoke tools:
+
+```
+skill_mcp(skill_name="mqdh", tool_name="fetch_meta_quest_doc", arguments='{"query": "hand tracking setup"}')
+```
+
+## Available Tools
+
+### fetch_meta_quest_doc
+
+Search and retrieve Meta Horizon OS documentation.
+
+| Parameter | Type   | Required | Description                |
+| --------- | ------ | -------- | -------------------------- |
+| `query`   | string | Yes      | Documentation search query |
+
+**Example:**
+
+```
+skill_mcp(skill_name="mqdh", tool_name="fetch_meta_quest_doc", arguments='{"query": "passthrough API Unity"}')
+```
+
+### get_adb_path
+
+Get the path to the bundled ADB executable.
+
+**Example:**
+
+```
+skill_mcp(skill_name="mqdh", tool_name="get_adb_path", arguments='{}')
+```
+
+### device_list
+
+List connected Quest devices.
+
+**Example:**
+
+```
+skill_mcp(skill_name="mqdh", tool_name="device_list", arguments='{}')
+```
+
+### install_apk
+
+Install an APK to a connected Quest device.
+
+| Parameter   | Type   | Required | Description      |
+| ----------- | ------ | -------- | ---------------- |
+| `apk_path`  | string | Yes      | Path to APK file |
+| `device_id` | string | No       | Target device ID |
+
+**Example:**
+
+```
+skill_mcp(skill_name="mqdh", tool_name="install_apk", arguments='{"apk_path": "/path/to/app.apk"}')
+```
+
+## Use Cases
+
+- **Documentation Lookup**: Quickly search Meta Horizon OS docs for APIs, best practices
+- **Device Management**: List devices, install APKs, manage Quest headsets
+- **Development Workflow**: Integrate ADB operations into AI-assisted development
+- **Troubleshooting**: Find solutions in Meta's documentation
+
+## Workflow Examples
+
+### 1. Look Up API Documentation
+
+```
+# Search for hand tracking documentation
+skill_mcp(skill_name="mqdh", tool_name="fetch_meta_quest_doc", arguments='{"query": "hand tracking gesture detection"}')
+
+# Search for passthrough setup
+skill_mcp(skill_name="mqdh", tool_name="fetch_meta_quest_doc", arguments='{"query": "mixed reality passthrough Unity"}')
+```
+
+### 2. Device Operations
+
+```
+# List connected devices
+skill_mcp(skill_name="mqdh", tool_name="device_list", arguments='{}')
+
+# Install a build
+skill_mcp(skill_name="mqdh", tool_name="install_apk", arguments='{"apk_path": "/builds/myapp.apk", "device_id": "1234567890"}')
+```
+
+## Transport
+
+This MCP uses **STDIO** transport to communicate with the LLM agent.
+
+## Troubleshooting
+
+**"Command not found"**: Verify `MQDH_MCP_PATH` points to the correct executable. Check MQDH's AI Tools settings for the exact path.
+
+**"MQDH not installed"**: Download MQDH v6.2.1+ from [Meta Developer Portal](https://developers.meta.com/horizon/documentation/android-apps/meta-quest-developer-hub).
+
+**"Device not found"**: Ensure your Quest is connected via USB and developer mode is enabled.
+
+**One-click setup preferred**: Use MQDH's built-in AI Tools settings tab for automatic configuration with Cursor or VS Code.
+
+## References
+
+- [MQDH MCP Documentation](https://developers.meta.com/horizon/documentation/unity/ts-mqdh-mcp/)
+- [Install MQDH](https://developers.meta.com/horizon/documentation/android-apps/meta-quest-developer-hub)
+- [Meta Horizon OS Developer Docs](https://developers.meta.com/horizon/documentation/)