opencodekit 0.21.0 → 0.21.2

package/dist/template/.opencode/plugin/prompt-leverage.ts.bak

@@ -1,228 +0,0 @@
-/**
- * Prompt Leverage Plugin
- *
- * Automatically upgrades every user prompt with the seven-block framework before the AI processes it.
- * This enforces prompt-leverage on ALL user input without relying on the AI to remember the rule.
- *
- * Hooks used:
- * - chat.message: Upgrades user message as it arrives
- */
-
-import type { Plugin } from "@opencode-ai/plugin";
-
-interface PromptFramework {
-	objective: string;
-	context: string;
-	workStyle: string;
-	toolRules: string;
-	outputContract: string;
-	verification: string;
-	doneCriteria: string;
-}
-
-const TASK_KEYWORDS: Record<string, string[]> = {
-	coding: [
-		"code",
-		"bug",
-		"repo",
-		"refactor",
-		"test",
-		"implement",
-		"fix",
-		"function",
-		"api",
-		"add",
-		"update",
-		"remove",
-	],
-	research: [
-		"research",
-		"compare",
-		"find",
-		"latest",
-		"sources",
-		"analyze",
-		"look up",
-	],
-	writing: [
-		"write",
-		"rewrite",
-		"draft",
-		"email",
-		"memo",
-		"blog",
-		"copy",
-		"tone",
-	],
-	review: ["review", "audit", "critique", "inspect", "evaluate", "assess"],
-	planning: ["plan", "roadmap", "strategy", "framework", "outline"],
-	analysis: ["analyze", "explain", "break down", "diagnose", "root cause"],
-};
-
-function detectTask(prompt: string): string {
-	const lowered = prompt.toLowerCase();
-	const scores: Record<string, number> = {};
-
-	for (const [task, keywords] of Object.entries(TASK_KEYWORDS)) {
-		scores[task] = keywords.filter((k) => lowered.includes(k)).length;
-	}
-
-	const best = Object.entries(scores).sort((a, b) => b[1] - a[1]);
-	return best[0]?.[1] ? best[0][0] : "analysis";
-}
-
-function inferIntensity(prompt: string, task: string): string {
-	const lowered = prompt.toLowerCase();
-	if (
-		lowered.includes("careful") ||
-		lowered.includes("deep") ||
-		lowered.includes("thorough") ||
-		lowered.includes("critical") ||
-		lowered.includes("production")
-	) {
-		return "Deep";
-	}
-	if (task === "coding" || task === "research" || task === "review") {
-		return "Standard";
-	}
-	return "Light";
-}
-
-function buildToolRules(task: string): string {
-	const rules: Record<string, string> = {
-		coding:
-			"Inspect the relevant files and dependencies first. Validate the final change with the narrowest useful checks before broadening scope.",
-		research:
-			"Retrieve evidence from reliable sources before concluding. Do not guess facts that can be checked.",
-		review:
-			"Read enough surrounding context to understand intent before critiquing. Distinguish confirmed issues from plausible risks.",
-	};
-	return (
-		rules[task] ||
-		"Use tools or extra context only when they materially improve correctness or completeness."
-	);
-}
-
-function buildOutputContract(task: string): string {
-	const contracts: Record<string, string> = {
-		coding:
-			"Return the result in a practical execution format: concise summary, concrete changes or code, validation notes, and any remaining risks.",
-		research:
-			"Return a structured synthesis with key findings, supporting evidence, uncertainty where relevant, and a concise bottom line.",
-		writing:
-			"Return polished final copy in the requested tone and format. If useful, include a short rationale for major editorial choices.",
-		review:
-			"Return findings grouped by severity or importance, explain why each matters, and suggest the smallest credible next step.",
-	};
-	return (
-		contracts[task] ||
-		"Return a clear, well-structured response matched to the task, with no unnecessary verbosity."
-	);
-}
-
-function upgradePrompt(userPrompt: string): string {
-	const normalized = userPrompt.trim().replace(/\s+/g, " ");
-	const task = detectTask(normalized);
-	const intensity = inferIntensity(normalized, task);
-	const toolRules = buildToolRules(task);
-	const outputContract = buildOutputContract(task);
-
-	// If prompt is already upgraded (contains framework blocks), skip
-	if (normalized.includes("Objective:") && normalized.includes("Context:")) {
-		return userPrompt;
-	}
-
-	// Simple prompts don't need full framework
-	if (normalized.length < 15 || normalized.split(" ").length < 3) {
-		return userPrompt;
-	}
-
-	return `Objective:
-- Complete this task: ${normalized}
-- Optimize for a correct, useful result rather than a merely plausible one.
-
-Context:
-- Preserve the user's original intent and constraints.
-- Surface any key assumptions if required information is missing.
-
-Work Style:
-- Task type: ${task}
-- Effort level: ${intensity}
-- Understand the problem broadly enough to avoid narrow mistakes, then go deep where the risk or complexity is highest.
-- Use first-principles reasoning before proposing changes.
-- For non-trivial work, review the result once with fresh eyes before finalizing.
-
-Tool Rules:
-- ${toolRules}
-
-Output Contract:
-- ${outputContract}
-
-Verification:
-- Check correctness, completeness, and edge cases.
-- Improve obvious weaknesses if a better approach is available within scope.
-
-Done Criteria:
-- Stop only when the response satisfies the task, matches the requested format, and passes the verification step.`;
-}
-
-export const PromptLeverage: Plugin = async ({ client }) => {
-	console.log("PromptLeverage: Initializing...");
-
-	const showToast = async (message: string) => {
-		try {
-			await client.tui.showToast({
-				body: {
-					title: "PromptLeverage",
-					message,
-					variant: "info",
-					duration: 3000,
-				},
-			});
-		} catch {
-			/* Toast API unavailable */
-		}
-	};
-
-	return {
-		"chat.message": async (input, output) => {
-			// Upgrade user message - check different structures
-			showToast(
-				`Hook fired, msg: ${JSON.stringify(input.message).slice(0, 100)}`,
-			);
-
-			// Try parts array
-			if (input.message?.parts) {
-				for (const part of input.message.parts) {
-					if (part.type === "text" && part.text) {
-						const upgraded = upgradePrompt(part.text);
-						if (upgraded !== part.text) {
-							part.text = upgraded;
-							showToast("Upgraded user prompt");
-						}
-					}
-				}
-			}
-			// Try direct text field
-			else if (input.message?.text) {
-				const upgraded = upgradePrompt(input.message.text);
-				if (upgraded !== input.message.text) {
-					input.message.text = upgraded;
-					showToast("Upgraded user prompt");
-				}
-			}
-			// Try content array
-			else if (input.message?.content) {
-				for (const part of input.message.content) {
-					if (part.type === "text" && part.text) {
-						const upgraded = upgradePrompt(part.text);
-						if (upgraded !== part.text) {
-							part.text = upgraded;
-							showToast("Upgraded user prompt");
-						}
-					}
-				}
-			}
-		},
-	};
-};

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

@@ -1,307 +0,0 @@
-/**
- * Stitch Plugin — Google Stitch UI generation as native OpenCode tools.
- *
- * Replaces the MCP subprocess (`npx @_davideast/stitch-mcp proxy`) with
- * direct HTTP via `@google/stitch-sdk`'s `StitchToolClient`.
- *
- * Tools: stitch_create_project, stitch_get_project, stitch_list_projects,
- *        stitch_list_screens, stitch_get_screen, stitch_generate_screen,
- *        stitch_edit_screens, stitch_generate_variants
- *
- * Auth: Set STITCH_API_KEY env var (API key) or STITCH_ACCESS_TOKEN (OAuth).
- */
-
-import { StitchError, StitchToolClient } from "@google/stitch-sdk";
-import type { Plugin } from "@opencode-ai/plugin";
-import { tool } from "@opencode-ai/plugin/tool";
-
-// ---------------------------------------------------------------------------
-// Shared
-// ---------------------------------------------------------------------------
-
-let client: StitchToolClient | null = null;
-
-const getClient = (): StitchToolClient => {
-	if (!client) {
-		client = new StitchToolClient();
-	}
-	return client;
-};
-
-/** Call a Stitch MCP tool and return the result as a JSON string. */
-const callTool = async (
-	name: string,
-	args: Record<string, unknown>,
-): Promise<string> => {
-	try {
-		const result = await getClient().callTool(name, args);
-		return JSON.stringify(result, null, 2);
-	} catch (err: unknown) {
-		if (err instanceof StitchError) {
-			return JSON.stringify({
-				error: err.code,
-				message: err.message,
-				...(err.suggestion ? { suggestion: err.suggestion } : {}),
-				recoverable: err.recoverable,
-				tool: name,
-			});
-		}
-		return JSON.stringify({
-			error: "UNKNOWN_ERROR",
-			message: err instanceof Error ? err.message : String(err),
-			tool: name,
-		});
-	}
-};
-
-// ---------------------------------------------------------------------------
-// Enums (for agent guidance — not strict validation)
-// ---------------------------------------------------------------------------
-
-const DEVICE_TYPES = [
-	"DEVICE_TYPE_UNSPECIFIED",
-	"MOBILE",
-	"DESKTOP",
-	"TABLET",
-	"AGNOSTIC",
-] as const;
-
-const MODEL_IDS = [
-	"MODEL_ID_UNSPECIFIED",
-	"GEMINI_3_PRO",
-	"GEMINI_3_FLASH",
-] as const;
-
-// ---------------------------------------------------------------------------
-// Plugin
-// ---------------------------------------------------------------------------
-
-export const StitchPlugin: Plugin = async () => {
-	return {
-		tool: {
-			// ---------------------------------------------------------------
-			// Projects
-			// ---------------------------------------------------------------
-
-			stitch_create_project: tool({
-				description:
-					"Create a new Google Stitch project.\n\nOptionally provide a title.",
-				args: {
-					title: tool.schema
-						.string()
-						.optional()
-						.describe("Project title (optional)"),
-				},
-				async execute(args: { title?: string }) {
-					return callTool("create_project", args);
-				},
-			}),
-
-			stitch_get_project: tool({
-				description:
-					"Get details of a Stitch project by resource name.\n\nFormat: projects/{projectId}",
-				args: {
-					name: tool.schema
-						.string()
-						.describe(
-							"Project resource name (e.g. projects/abc123). Required.",
-						),
-				},
-				async execute(args: { name: string }) {
-					return callTool("get_project", args);
-				},
-			}),
-
-			stitch_list_projects: tool({
-				description: "List all Stitch projects. Optionally filter by keyword.",
-				args: {
-					filter: tool.schema
-						.string()
-						.optional()
-						.describe("Filter string (optional)"),
-				},
-				async execute(args: { filter?: string }) {
-					return callTool("list_projects", args);
-				},
-			}),
-
-			// ---------------------------------------------------------------
-			// Screens
-			// ---------------------------------------------------------------
-
-			stitch_list_screens: tool({
-				description:
-					"List all screens in a Stitch project.\n\nRequires projectId.",
-				args: {
-					projectId: tool.schema.string().describe("Project ID. Required."),
-				},
-				async execute(args: { projectId: string }) {
-					return callTool("list_screens", args);
-				},
-			}),
-
-			stitch_get_screen: tool({
-				description:
-					"Get screen details including HTML code.\n\nProvide the screen resource name (format: projects/{projectId}/screens/{screenId}).",
-				args: {
-					name: tool.schema
-						.string()
-						.describe(
-							"Screen resource name (e.g. projects/abc/screens/xyz). Required.",
-						),
-				},
-				async execute(args: { name: string }) {
-					return callTool("get_screen", args);
-				},
-			}),
-
-			// ---------------------------------------------------------------
-			// Generation
-			// ---------------------------------------------------------------
-
-			stitch_generate_screen: tool({
-				description: `Generate a UI screen from a text prompt.
-
-Device types: ${DEVICE_TYPES.join(", ")}
-Model IDs: ${MODEL_IDS.join(", ")}`,
-				args: {
-					projectId: tool.schema.string().describe("Project ID. Required."),
-					prompt: tool.schema
-						.string()
-						.describe("Text description of the UI to generate. Required."),
-					deviceType: tool.schema
-						.string()
-						.optional()
-						.describe(
-							`Device type: ${DEVICE_TYPES.join(" | ")} (default: MOBILE)`,
-						),
-					modelId: tool.schema
-						.string()
-						.optional()
-						.describe(
-							`Model: ${MODEL_IDS.join(" | ")} (default: GEMINI_3_FLASH)`,
-						),
-				},
-				async execute(args: {
-					projectId: string;
-					prompt: string;
-					deviceType?: string;
-					modelId?: string;
-				}) {
-					return callTool("generate_screen_from_text", args);
-				},
-			}),
-
-			stitch_edit_screens: tool({
-				description: `Edit existing screens with a text prompt.
-
-Device types: ${DEVICE_TYPES.join(", ")}
-Model IDs: ${MODEL_IDS.join(", ")}`,
-				args: {
-					projectId: tool.schema.string().describe("Project ID. Required."),
-					selectedScreenIds: tool.schema
-						.array(tool.schema.string())
-						.describe("Screen IDs to edit. Required."),
-					prompt: tool.schema.string().describe("Edit instructions. Required."),
-					deviceType: tool.schema
-						.string()
-						.optional()
-						.describe(
-							`Device type: ${DEVICE_TYPES.join(" | ")} (default: MOBILE)`,
-						),
-					modelId: tool.schema
-						.string()
-						.optional()
-						.describe(
-							`Model: ${MODEL_IDS.join(" | ")} (default: GEMINI_3_FLASH)`,
-						),
-				},
-				async execute(args: {
-					projectId: string;
-					selectedScreenIds: string[];
-					prompt: string;
-					deviceType?: string;
-					modelId?: string;
-				}) {
-					return callTool("edit_screens", args);
-				},
-			}),
-
-			stitch_generate_variants: tool({
-				description: `Generate design variants of existing screens.
-
-variantOptions:
-  - variantCount: number of variants (1-10)
-  - creativeRange: LOW, MEDIUM, HIGH (how different from original)
-  - aspects: optional comma-separated aspects to vary (e.g. "color,layout")
-
-Device types: ${DEVICE_TYPES.join(", ")}
-Model IDs: ${MODEL_IDS.join(", ")}`,
-				args: {
-					projectId: tool.schema.string().describe("Project ID. Required."),
-					selectedScreenIds: tool.schema
-						.array(tool.schema.string())
-						.describe("Screen IDs to create variants of. Required."),
-					prompt: tool.schema
-						.string()
-						.describe("Prompt describing desired variations. Required."),
-					variantCount: tool.schema
-						.number()
-						.optional()
-						.describe("Number of variants to generate (1-10, default: 3)"),
-					creativeRange: tool.schema
-						.string()
-						.optional()
-						.describe("Creative range: LOW | MEDIUM | HIGH (default: MEDIUM)"),
-					aspects: tool.schema
-						.string()
-						.optional()
-						.describe(
-							"Comma-separated aspects to vary (e.g. 'color,layout'). Optional.",
-						),
-					deviceType: tool.schema
-						.string()
-						.optional()
-						.describe(
-							`Device type: ${DEVICE_TYPES.join(" | ")} (default: MOBILE)`,
-						),
-					modelId: tool.schema
-						.string()
-						.optional()
-						.describe(
-							`Model: ${MODEL_IDS.join(" | ")} (default: GEMINI_3_FLASH)`,
-						),
-				},
-				async execute(args: {
-					projectId: string;
-					selectedScreenIds: string[];
-					prompt: string;
-					variantCount?: number;
-					creativeRange?: string;
-					aspects?: string;
-					deviceType?: string;
-					modelId?: string;
-				}) {
-					// Build variantOptions object from flat args
-					const variantOptions: Record<string, unknown> = {};
-					if (args.variantCount != null)
-						variantOptions.variantCount = args.variantCount;
-					if (args.creativeRange)
-						variantOptions.creativeRange = args.creativeRange;
-					if (args.aspects) variantOptions.aspects = args.aspects;
-
-					return callTool("generate_variants", {
-						projectId: args.projectId,
-						selectedScreenIds: args.selectedScreenIds,
-						prompt: args.prompt,
-						variantOptions,
-						...(args.deviceType ? { deviceType: args.deviceType } : {}),
-						...(args.modelId ? { modelId: args.modelId } : {}),
-					});
-				},
-			}),
-		},
-	};
-};
-
-export default StitchPlugin;

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

@@ -1,164 +0,0 @@
----
-name: stitch
-description: Use when generating, editing, or creating variants of UI screens in Google Stitch. MUST load before any stitch_generate_screen or stitch_edit_screens tool calls.
-version: 2.0.0
-tags: [design, ui, stitch]
-dependencies: []
----
-
-# Google Stitch Plugin
-
-## When to Use
-
-- When you need to generate or inspect Google Stitch UI designs.
-
-## When NOT to Use
-
-- When you don't have Stitch access or don't need Stitch-generated UI.
-
-## Overview
-
-Stitch tools are registered as native OpenCode tools via the Stitch plugin (`.opencode/plugin/stitch.ts`), using `@google/stitch-sdk` for direct HTTP to `stitch.googleapis.com/mcp`. No MCP subprocess needed.
-
-## Prerequisites
-
-1. **Google Cloud Project** with Stitch API enabled
-2. **Google Cloud CLI** (`gcloud`) installed and initialized
-3. **Required IAM Roles**:
-   - `roles/serviceusage.serviceUsageAdmin` (to enable the service)
-   - `roles/mcp.toolUser` (to call MCP tools)
-
-## Setup Steps
-
-### 1. Enable Stitch API in Google Cloud
-
-```bash
-gcloud config set project PROJECT_ID
-gcloud beta services mcp enable stitch.googleapis.com --project=PROJECT_ID
-```
-
-### 2. Set Environment Variables
-
-**API Key auth** (recommended):
-
-```bash
-export STITCH_API_KEY="your-api-key"
-```
-
-**Or OAuth auth**:
-
-```bash
-export STITCH_ACCESS_TOKEN=$(gcloud auth print-access-token)
-export GOOGLE_CLOUD_PROJECT="your-project-id"
-```
-
-### 3. Restart OpenCode
-
-Tools are available immediately after env vars are set and OpenCode restarts.
-
-## Available Tools
-
-| Tool                       | Description                          |
-| -------------------------- | ------------------------------------ |
-| `stitch_create_project`    | Create a new Stitch project          |
-| `stitch_get_project`       | Get project details by resource name |
-| `stitch_list_projects`     | List all projects (optional filter)  |
-| `stitch_list_screens`      | List screens in a project            |
-| `stitch_get_screen`        | Get screen details with HTML code    |
-| `stitch_generate_screen`   | Generate UI from text prompt         |
-| `stitch_edit_screens`      | Edit existing screens with a prompt  |
-| `stitch_generate_variants` | Generate design variants of screens  |
-
-## Usage Examples
-
-### List Projects
-
-```typescript
-stitch_list_projects({});
-```
-
-### Create a Project
-
-```typescript
-stitch_create_project({ title: "My E-commerce App" });
-```
-
-### Generate Screen from Text
-
-```typescript
-stitch_generate_screen({
-  projectId: "my-project-123",
-  prompt:
-    "Create a modern login page with email and password fields, social login buttons, and a forgot password link",
-  deviceType: "MOBILE",
-});
-```
-
-### Edit Existing Screens
-
-```typescript
-stitch_edit_screens({
-  projectId: "my-project-123",
-  selectedScreenIds: ["screen-abc"],
-  prompt: "Make the login button larger and change the color scheme to dark mode",
-});
-```
-
-### Generate Design Variants
-
-```typescript
-stitch_generate_variants({
-  projectId: "my-project-123",
-  selectedScreenIds: ["screen-abc"],
-  prompt: "Create variants with different color schemes",
-  variantCount: 3,
-  creativeRange: "MEDIUM",
-});
-```
-
-## Parameters
-
-### Device Types
-
-`DEVICE_TYPE_UNSPECIFIED` | `MOBILE` | `DESKTOP` | `TABLET` | `AGNOSTIC`
-
-### Model IDs
-
-`MODEL_ID_UNSPECIFIED` | `GEMINI_3_PRO` | `GEMINI_3_FLASH`
-
-### Variant Options
-
-- `variantCount`: Number of variants (1-10)
-- `creativeRange`: `LOW` | `MEDIUM` | `HIGH`
-- `aspects`: Comma-separated aspects to vary (e.g. "color,layout")
-
-## Troubleshooting
-
-### "AUTH_FAILED"
-
-```bash
-# API key auth
-export STITCH_API_KEY="your-key"
-
-# Or OAuth (token expires after ~1 hour)
-export STITCH_ACCESS_TOKEN=$(gcloud auth print-access-token)
-```
-
-### "Stitch API not enabled"
-
-```bash
-gcloud beta services mcp enable stitch.googleapis.com --project=YOUR_PROJECT_ID
-```
-
-## Documentation
-
-- [Google Stitch](https://stitch.withgoogle.com)
-- [Stitch SDK](https://github.com/google-labs-code/stitch-sdk)
-- [Stitch MCP Setup](https://stitch.withgoogle.com/docs/mcp/setup)
-
-## Tips
-
-- API key auth is simpler than OAuth (no token refresh)
-- Use descriptive prompts for better UI generation
-- `GEMINI_3_PRO` produces higher quality; `GEMINI_3_FLASH` is faster
-- Test generated code in your target framework before production use