opencodekit 0.15.20 → 0.16.0

package/dist/template/.opencode/skills/tool-priority/SKILL.md

@@ -1,190 +0,0 @@
----
-description: Use when choosing between search tools (LSP, grep, glob) or need tool reference - covers when to use each tool and detailed syntax
----
-
-# Tool Priority Skill
-
-## Priority Order
-
-**LSP tools → grep → glob**
-
-1. **LSP tools** - Semantic code intelligence (10 tools)
-2. `grep` - Text search (logs, config, code patterns, strings)
-3. `glob` - File discovery by name pattern
-4. `read`, `edit`, `write` - File operations
-
-**Rule**: Always `read` before `edit` to verify content.
-
-## Choosing the Right Tool
-
-Ask: **"Am I looking for semantic understanding or just text?"**
-
-### Code Understanding (Use LSP)
-
-| Need             | Tool                        | Example                              |
-| ---------------- | --------------------------- | ------------------------------------ |
-| Symbol type info | `lsp_lsp_hover`             | Type signature at cursor             |
-| Definition jump  | `lsp_lsp_goto_definition`   | Source location                      |
-| All usages       | `lsp_lsp_find_references`   | Before refactoring                   |
-| File structure   | `lsp_lsp_document_symbols`  | What functions/classes in this file? |
-| Safe rename      | `lsp_lsp_rename`            | Update symbol across codebase        |
-| Workspace search | `lsp_lsp_workspace_symbols` | Where is UserService defined?        |
-
-### Text Search (Use grep)
-
-| Need              | Tool   | Example pattern        |
-| ----------------- | ------ | ---------------------- |
-| Function calls    | `grep` | `functionName\(`       |
-| Import statements | `grep` | `import.*from.*module` |
-| Error messages    | `grep` | `FATAL\|ERROR`         |
-| Config values     | `grep` | `API_KEY`              |
-| TODO comments     | `grep` | `TODO\|FIXME`          |
-| Hook usage        | `grep` | `useState(`            |
-| Debug logs        | `grep` | `console\.log\(`       |
-
-### Workflow Pattern
-
-```
-# Step 1: Find it
-grep "functionName" src/
-
-# Step 2: Understand it
-read src/file.ts
-lsp_lsp_document_symbols(filePath="src/file.ts", line=1, character=1)
-
-# Step 3: Trace it
-lsp_lsp_goto_definition(filePath="src/file.ts", line=42, character=10)
-lsp_lsp_find_references(filePath="src/file.ts", line=42, character=10)
-
-# Step 4: Modify it (if needed)
-lsp_lsp_hover(filePath="src/file.ts", line=42, character=10)
-```
-
-## LSP Tools Reference
-
-Semantic code intelligence via Language Server Protocol. **Uses `lsp_lsp_*` prefix** (built-in experimental).
-
-### Navigation & Understanding
-
-| Tool                                                 | Purpose                               | When to Use                       |
-| ---------------------------------------------------- | ------------------------------------- | --------------------------------- |
-| `lsp_lsp_hover(filePath, line, character)`           | Type info and docs at cursor          | "What type is this variable?"     |
-| `lsp_lsp_goto_definition(filePath, line, character)` | Jump to where symbol is defined       | "Where is this function defined?" |
-| `lsp_lsp_find_references(filePath, line, character)` | Find all usages of a symbol           | "What uses this function?"        |
-| `lsp_lsp_document_symbols(filePath)`                 | File outline (classes, functions)     | "What's in this file?"            |
-| `lsp_lsp_workspace_symbols(query, filePath)`         | Fuzzy search symbols across workspace | "Where is UserService defined?"   |
-
-### Diagnostics
-
-| Tool                                       | Purpose                              | When to Use              |
-| ------------------------------------------ | ------------------------------------ | ------------------------ |
-| `lsp_lsp_diagnostics(filePath, severity?)` | Errors/warnings from language server | "Are there type errors?" |
-
-### Refactoring
-
-| Tool                                                                     | Purpose                       | When to Use                        |
-| ------------------------------------------------------------------------ | ----------------------------- | ---------------------------------- |
-| `lsp_lsp_rename(filePath, line, character, newName)`                     | Rename symbol across codebase | "Rename this function safely"      |
-| `lsp_lsp_code_actions(filePath, startLine, startChar, endLine, endChar)` | Get available refactorings    | "What refactorings are available?" |
-| `lsp_lsp_code_action_apply(...)`                                         | Apply a specific code action  | Execute chosen refactoring         |
-| `lsp_lsp_organize_imports(filePath)`                                     | Clean up and sort imports     | "Fix imports"                      |
-
-**Caveat**: LSP tools modify files directly. Re-read files before further edits.
-
-## grep Reference
-
-Fast, text-based search using ripgrep.
-
-### Basic Patterns
-
-```bash
-# Find function definitions
-grep "function\|const.*=.*(" src/
-
-# Find imports
-grep "import.*from" src/
-
-# Find React hooks
-grep "useState\|useEffect" src/
-
-# Find console logs
-grep "console\.log" src/
-
-# Search for errors
-grep "Error\|Exception\|Throw" src/
-
-# Multiple patterns
-grep -e "TODO" -e "FIXME" src/
-
-# Case insensitive
-grep -i "test" src/
-
-# Specific file types
-grep -r "API_KEY" --include="*.ts" --include="*.js"
-```
-
-### grep vs LSP
-
-| Scenario           | Use                       | Why                                             |
-| ------------------ | ------------------------- | ----------------------------------------------- |
-| "Find all X"       | `grep`                    | Fast text search, everything including comments |
-| "Where is X used?" | `lsp_lsp_find_references` | Semantic, only code usage, tracks dependencies  |
-| "What type is X?"  | `lsp_lsp_hover`           | Type system intelligence                        |
-| "Find TODOs"       | `grep`                    | Text search across all files                    |
-| "Rename X"         | `lsp_lsp_rename`          | Safe semantic refactoring                       |
-
-### Common Gotchas
-
-**grep finds everything:**
-
-```bash
-grep "fetchUser"  # Matches: function fetchUser(), "fetchUser" string, // fetchUser comment
-```
-
-**LSP finds only code:**
-
-```bash
-lsp_lsp_find_references  # Only actual usages in code, not strings/comments
-```
-
-**When to use grep first:**
-
-- Quick exploration ("are there any X?")
-- Finding error patterns, logs, configs
-- Searching across file types (JSON, YAML, etc.)
-
-**When to use LSP first:**
-
-- Understanding code structure
-- Before refactoring
-- Tracing dependencies
-- Getting type information
-
-## glob Reference
-
-Find files by pattern.
-
-```bash
-# All TypeScript files
-glob "**/*.ts"
-
-# All test files
-glob "**/*.test.ts"
-
-# Specific directory
-glob "src/**/*.ts"
-
-# Multiple patterns
-glob ["src/**/*.ts", "tests/**/*.ts"]
-```
-
-## Research Tools
-
-| Tool                            | Use When                                                |
-| ------------------------------- | ------------------------------------------------------- |
-| **context7_resolve-library-id** | Resolve library names to IDs (try first).               |
-| **context7_query-docs**         | Query official library documentation. Fast.             |
-| **websearch**                   | Docs not in Context7, recent releases, troubleshooting. |
-| **codesearch**                  | Real implementation patterns from GitHub.               |
-| **grepsearch**                 | Cross-repo code patterns via grep.app.                  |
-| **webfetch**                    | Specific URL user provided.                             |

package/dist/template/.opencode/tools/notebooklm.ts

@@ -1,488 +0,0 @@
-/**
- * NotebookLM Tool for OpenCodeKit
- *
- * Wraps the Python NotebookLM skill for querying Google NotebookLM notebooks.
- * Auto-clones the skill repository and manages the Python virtual environment.
- *
- * @module notebooklm
- */
-
-import { homedir } from "os";
-import { join } from "path";
-import { $ } from "bun";
-
-/**
- * Logger interface for OpenCode client app logging
- * Falls back to console if client logger not available
- */
-interface Logger {
-	debug: (message: string, extra?: Record<string, unknown>) => void;
-	info: (message: string, extra?: Record<string, unknown>) => void;
-	warn: (message: string, extra?: Record<string, unknown>) => void;
-	error: (message: string, extra?: Record<string, unknown>) => void;
-}
-
-/**
- * Create a logger that uses OpenCode client.app.log() when available,
- * otherwise falls back to console
- */
-function createLogger(client?: {
-	app: {
-		log: (log: {
-			service: string;
-			level: "debug" | "info" | "warn" | "error";
-			message: string;
-			extra?: Record<string, unknown>;
-		}) => Promise<void>;
-	};
-}): Logger {
-	const service = "notebooklm";
-
-	if (client?.app?.log) {
-		// Use OpenCode client logging
-		return {
-			debug: (message: string, extra?: Record<string, unknown>) => {
-				client.app
-					.log({ service, level: "debug", message, extra })
-					.catch(() => {});
-			},
-			info: (message: string, extra?: Record<string, unknown>) => {
-				client.app
-					.log({ service, level: "info", message, extra })
-					.catch(() => {});
-			},
-			warn: (message: string, extra?: Record<string, unknown>) => {
-				client.app
-					.log({ service, level: "warn", message, extra })
-					.catch(() => {});
-			},
-			error: (message: string, extra?: Record<string, unknown>) => {
-				client.app
-					.log({ service, level: "error", message, extra })
-					.catch(() => {});
-			},
-		};
-	}
-
-	// Fallback to console
-	return {
-		debug: (message: string, extra?: Record<string, unknown>) => {
-			console.log(`[DEBUG] ${message}`, extra ? JSON.stringify(extra) : "");
-		},
-		info: (message: string, extra?: Record<string, unknown>) => {
-			console.log(`[INFO] ${message}`, extra ? JSON.stringify(extra) : "");
-		},
-		warn: (message: string, extra?: Record<string, unknown>) => {
-			console.warn(`[WARN] ${message}`, extra ? JSON.stringify(extra) : "");
-		},
-		error: (message: string, extra?: Record<string, unknown>) => {
-			console.error(`[ERROR] ${message}`, extra ? JSON.stringify(extra) : "");
-		},
-	};
-}
-
-// Global logger instance (will be initialized with client if available)
-let globalLogger: Logger = createLogger();
-
-/**
- * Set the logger instance (called by plugin initialization)
- */
-export function setNotebookLMLogger(client?: {
-	app: {
-		log: (log: {
-			service: string;
-			level: "debug" | "info" | "warn" | "error";
-			message: string;
-			extra?: Record<string, unknown>;
-		}) => Promise<void>;
-	};
-}): void {
-	globalLogger = createLogger(client);
-}
-
-// Detect Python command (python or python3)
-async function getPythonCommand(): Promise<string> {
-	try {
-		await $`python --version`.quiet();
-		return "python";
-	} catch {
-		try {
-			await $`python3 --version`.quiet();
-			return "python3";
-		} catch {
-			throw new Error("Python not found. Please install Python 3.10+");
-		}
-	}
-}
-
-// Skill repository URL
-const SKILL_REPO = "https://github.com/PleasePrompto/notebooklm-skill";
-
-// Skill installation directory
-const SKILL_DIR = join(homedir(), ".opencode", "skills", "notebooklm");
-
-// Scripts directory
-const SCRIPTS_DIR = join(SKILL_DIR, "scripts");
-
-/**
- * Input parameters for notebooklm tool
- */
-export interface NotebookLMInput {
-	/** Operation to perform */
-	operation: "auth" | "query" | "library" | "setup";
-
-	/** Sub-operation for auth and library operations */
-	subOperation?:
-		| "setup"
-		| "status"
-		| "reauth"
-		| "clear"
-		| "validate"
-		| "add"
-		| "list"
-		| "search"
-		| "activate"
-		| "remove"
-		| "stats";
-
-	/** Question to ask (for query operation) */
-	question?: string;
-
-	/** Notebook URL (for add or query operations) */
-	notebookUrl?: string;
-
-	/** Notebook ID from library (for query or activate operations) */
-	notebookId?: string;
-
-	/** Notebook name (for add operation) */
-	name?: string;
-
-	/** Notebook description (for add operation) */
-	description?: string;
-
-	/** Topics/tags (for add operation) - array or comma-separated string */
-	topics?: string[] | string;
-
-	/** Search query (for library search) */
-	query?: string;
-
-	/** Show browser window (for auth setup or debugging) */
-	showBrowser?: boolean;
-
-	/** Timeout in minutes for authentication */
-	timeout?: number;
-}
-
-/**
- * Result from notebooklm operation
- */
-export interface NotebookLMResult {
-	/** Whether the operation succeeded */
-	success: boolean;
-
-	/** Output from the operation */
-	output: string;
-
-	/** Error message if failed */
-	error?: string;
-
-	/** Parsed data (for library operations) */
-	data?: unknown;
-}
-
-/**
- * Ensure Python virtual environment is set up with dependencies
- */
-async function ensureVirtualEnv(): Promise<void> {
-	const venvPath = join(SKILL_DIR, ".venv");
-	const venvPython = join(venvPath, "bin", "python");
-	const venvPip = join(venvPath, "bin", "pip");
-
-	// Check if venv exists with pip
-	const venvExists = await Bun.file(venvPython).exists();
-	const pipExists = await Bun.file(venvPip).exists();
-
-	if (venvExists && pipExists) {
-		// Check if patchright is installed
-		const checkResult =
-			await $`cd ${SKILL_DIR} && .venv/bin/python -c "import patchright" 2>&1`.nothrow();
-		if (checkResult.exitCode === 0) {
-			return;
-		}
-	}
-
-	globalLogger.info("Setting up Python virtual environment...");
-
-	const pythonCmd = await getPythonCommand();
-
-	// Remove broken venv if exists
-	if (venvExists && !pipExists) {
-		globalLogger.warn("Removing incomplete virtual environment...");
-		await $`cd ${SKILL_DIR} && rm -rf .venv`;
-	}
-
-	// Create virtual environment with pip
-	globalLogger.info("Creating virtual environment...");
-	const venvResult =
-		await $`cd ${SKILL_DIR} && ${pythonCmd} -m venv .venv --without-pip`.nothrow();
-	if (venvResult.exitCode !== 0) {
-		throw new Error(
-			`Failed to create virtual environment: ${venvResult.stderr}`,
-		);
-	}
-
-	// Install pip manually
-	globalLogger.info("Installing pip...");
-	const pipInstallResult =
-		await $`cd ${SKILL_DIR} && .venv/bin/python -m ensurepip --upgrade`.nothrow();
-	if (pipInstallResult.exitCode !== 0) {
-		// Try alternative method
-		await $`cd ${SKILL_DIR} && curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py && .venv/bin/python get-pip.py && rm get-pip.py`.nothrow();
-	}
-
-	// Install dependencies
-	globalLogger.info("Installing dependencies (this may take a minute)...");
-	const pipResult =
-		await $`cd ${SKILL_DIR} && .venv/bin/python -m pip install -r requirements.txt`.nothrow();
-	if (pipResult.exitCode !== 0) {
-		throw new Error(`Failed to install dependencies: ${pipResult.stderr}`);
-	}
-
-	// Install patchright browser
-	globalLogger.info("Installing browser automation...");
-	const browserResult =
-		await $`cd ${SKILL_DIR} && .venv/bin/python -m patchright install chromium`.nothrow();
-	if (browserResult.exitCode !== 0) {
-		globalLogger.warn("Browser install may have issues, but continuing...");
-	}
-
-	globalLogger.info("Virtual environment ready");
-}
-
-/**
- * Ensure the NotebookLM skill is installed
- */
-async function ensureSkillInstalled(): Promise<void> {
-	const runPyPath = join(SCRIPTS_DIR, "run.py");
-
-	// Check if skill is already installed
-	const exists = await Bun.file(runPyPath).exists();
-	if (exists) {
-		return;
-	}
-
-	globalLogger.info("NotebookLM skill not found. Installing...");
-
-	// Create parent directory
-	const parentDir = join(homedir(), ".opencode", "skills");
-	await $`mkdir -p ${parentDir}`;
-
-	// Clone the repository
-	globalLogger.info(`Cloning from ${SKILL_REPO}...`);
-	const result =
-		await $`cd ${parentDir} && git clone ${SKILL_REPO} notebooklm`.quiet();
-
-	if (result.exitCode !== 0) {
-		throw new Error(`Failed to clone NotebookLM skill: ${result.stderr}`);
-	}
-
-	globalLogger.info("Skill installed successfully", { location: SKILL_DIR });
-
-	// Set up virtual environment
-	await ensureVirtualEnv();
-}
-
-/**
- * Build command arguments for run.py wrapper
- */
-function buildCommandArgs(input: NotebookLMInput): string[] {
-	const args: string[] = [];
-
-	switch (input.operation) {
-		case "auth":
-			args.push(input.subOperation || "status");
-
-			if (input.subOperation === "setup" || input.subOperation === "reauth") {
-				if (!input.showBrowser) {
-					args.push("--headless");
-				}
-				if (input.timeout) {
-					args.push("--timeout", String(input.timeout));
-				}
-			}
-			break;
-
-		case "library":
-			args.push(input.subOperation || "list");
-
-			if (input.subOperation === "add") {
-				if (input.notebookUrl) args.push("--url", input.notebookUrl);
-				if (input.name) args.push("--name", input.name);
-				if (input.description) args.push("--description", input.description);
-				if (input.topics) {
-					const topicsStr = Array.isArray(input.topics)
-						? input.topics.join(",")
-						: input.topics;
-					args.push("--topics", topicsStr);
-				}
-			} else if (input.subOperation === "search") {
-				if (input.query) args.push("--query", input.query);
-			} else if (
-				input.subOperation === "activate" ||
-				input.subOperation === "remove"
-			) {
-				if (input.notebookId) args.push("--id", input.notebookId);
-			}
-			break;
-
-		case "query":
-			// ask_question.py is passed as script parameter
-
-			if (input.question) {
-				args.push("--question", input.question);
-			}
-
-			if (input.notebookUrl) {
-				args.push("--notebook-url", input.notebookUrl);
-			} else if (input.notebookId) {
-				args.push("--notebook-id", input.notebookId);
-			}
-
-			if (input.showBrowser) {
-				args.push("--show-browser");
-			}
-			break;
-
-		case "setup":
-			// Setup is handled by ensureSkillInstalled
-			return [];
-	}
-
-	return args;
-}
-
-/**
- * Execute a NotebookLM operation
- */
-async function executeOperation(
-	script: string,
-	args: string[],
-): Promise<{ stdout: string; stderr: string; exitCode: number }> {
-	const runPyPath = join(SCRIPTS_DIR, "run.py");
-	const venvPython = join(SKILL_DIR, ".venv", "bin", "python");
-
-	// Use venv python if available, otherwise fall back to system
-	const pythonCmd = (await Bun.file(venvPython).exists())
-		? venvPython
-		: await getPythonCommand();
-
-	// Build full command
-	const cmd = [pythonCmd, runPyPath, script, ...args];
-
-	globalLogger.debug(`Executing: ${cmd.join(" ")}`);
-
-	// Execute with Bun
-	const result = await $`cd ${SKILL_DIR} && ${cmd}`.nothrow();
-
-	return {
-		stdout: result.stdout.toString(),
-		stderr: result.stderr.toString(),
-		exitCode: result.exitCode,
-	};
-}
-
-/**
- * Main notebooklm tool function
- *
- * @param input - Operation parameters
- * @returns Result of the operation
- *
- * @example
- * // Check authentication status
- * const status = await notebooklm({ operation: "auth", subOperation: "status" });
- *
- * @example
- * // Query a notebook
- * const answer = await notebooklm({
- *   operation: "query",
- *   question: "What are the key findings?",
- *   notebookId: "my-notebook"
- * });
- */
-export default async function notebooklm(
-	input: NotebookLMInput,
-): Promise<NotebookLMResult> {
-	try {
-		// Ensure skill is installed
-		await ensureSkillInstalled();
-
-		// Ensure virtual environment is set up (for non-setup operations)
-		if (input.operation !== "setup") {
-			await ensureVirtualEnv();
-		}
-
-		// Handle setup operation (just verify installation)
-		if (input.operation === "setup") {
-			return {
-				success: true,
-				output: `NotebookLM skill installed at: ${SKILL_DIR}\n\nPrerequisites:\n- Python 3.10+ must be installed\n- Google Chrome must be installed\n- Run auth setup before querying`,
-				data: { skillDir: SKILL_DIR },
-			};
-		}
-
-		// Build command arguments
-		const args = buildCommandArgs(input);
-
-		// Determine which script to run
-		let script: string;
-		switch (input.operation) {
-			case "auth":
-				script = "auth_manager.py";
-				break;
-			case "library":
-				script = "notebook_manager.py";
-				break;
-			case "query":
-				script = "ask_question.py";
-				break;
-			default:
-				throw new Error(`Unknown operation: ${input.operation}`);
-		}
-
-		// Execute the operation
-		globalLogger.info(
-			`NotebookLM: ${input.operation}${input.subOperation ? `/${input.subOperation}` : ""}`,
-		);
-		const result = await executeOperation(script, args);
-
-		// Parse result
-		const success = result.exitCode === 0;
-
-		// Try to parse JSON data from output (for library operations)
-		let data: unknown = undefined;
-		try {
-			// Look for JSON in the output
-			const jsonMatch = result.stdout.match(/\{[\s\S]*\}/);
-			if (jsonMatch) {
-				data = JSON.parse(jsonMatch[0]);
-			}
-		} catch {
-			// Not JSON, that's fine
-		}
-
-		return {
-			success,
-			output: result.stdout || result.stderr,
-			error: success ? undefined : result.stderr,
-			data,
-		};
-	} catch (error) {
-		const errorMessage = error instanceof Error ? error.message : String(error);
-
-		return {
-			success: false,
-			output: "",
-			error: errorMessage,
-		};
-	}
-}