@sveltejs/opencode 0.0.1

package/config.ts

@@ -0,0 +1,143 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import * as v from 'valibot';
+
+const default_config = {
+	mcp: {
+		type: 'remote' as 'remote' | 'local',
+		enabled: true,
+	},
+	subagent: {
+		enabled: true,
+	},
+	instructions: {
+		enabled: true,
+	},
+};
+
+export const config_schema = v.object({
+	mcp: v.optional(
+		v.object({
+			type: v.optional(v.picklist(['remote', 'local'])),
+			enabled: v.optional(v.boolean()),
+		}),
+	),
+	subagent: v.optional(
+		v.object({
+			enabled: v.optional(v.boolean()),
+		}),
+	),
+	instructions: v.optional(
+		v.object({
+			enabled: v.optional(v.boolean()),
+		}),
+	),
+});
+
+export type McpConfig = v.InferInput<typeof config_schema>;
+
+const GLOBAL_CONFIG_DIR = join(homedir(), '.config', 'opencode');
+const GLOBAL_CONFIG_PATH = join(GLOBAL_CONFIG_DIR, 'svelte.json');
+
+interface ConfigLoadResult {
+	data: Record<string, unknown> | null;
+	parse_error?: string;
+}
+
+function get_config_paths() {
+	// Global: ~/.config/opencode/svelte.json
+	let global_path: string | null = null;
+	if (existsSync(GLOBAL_CONFIG_PATH)) {
+		global_path = GLOBAL_CONFIG_PATH;
+	}
+
+	// Custom config directory: $OPENCODE_CONFIG_DIR/svelte.json
+	let config_dir_path: string | null = null;
+	const opencode_config_dir = process.env.OPENCODE_CONFIG_DIR;
+	if (opencode_config_dir) {
+		const config_json = join(opencode_config_dir, 'svelte.json');
+		if (existsSync(config_json)) {
+			config_dir_path = config_json;
+		}
+	}
+
+	// returning config_dir first so it has higher priority
+	return [config_dir_path, global_path];
+}
+
+function load_config_file(config_path: string): ConfigLoadResult {
+	let file_content: string;
+	try {
+		file_content = readFileSync(config_path, 'utf-8');
+	} catch {
+		// File doesn't exist or can't be read
+		return { data: null };
+	}
+
+	try {
+		const parsed = JSON.parse(file_content);
+		if (parsed === undefined || parsed === null) {
+			return { data: null, parse_error: 'Config file is empty or invalid' };
+		}
+		return { data: parsed };
+	} catch (error: unknown) {
+		return {
+			data: null,
+			parse_error: error instanceof Error ? error.message : 'Failed to parse config',
+		};
+	}
+}
+
+function merge_with_defaults(user_config: Partial<McpConfig>): McpConfig {
+	return {
+		mcp: {
+			...default_config.mcp,
+			...user_config.mcp,
+		},
+		subagent: {
+			...default_config.subagent,
+			...user_config.subagent,
+		},
+		instructions: {
+			...default_config.instructions,
+			...user_config.instructions,
+		},
+	};
+}
+
+export function get_mcp_config(ctx: PluginInput) {
+	const config_paths = get_config_paths();
+	for (const path of config_paths) {
+		if (path && existsSync(path)) {
+			const result = load_config_file(path);
+			if (result.parse_error) {
+				ctx.client.tui.showToast({
+					body: {
+						title: 'Svelte: Invalid opencode plugin config',
+						message: `${result.parse_error}\nUsing default values`,
+						variant: 'warning',
+						duration: 7000,
+					},
+				});
+				return default_config;
+			}
+			const parsed = v.safeParse(config_schema, result.data);
+			if (parsed.success) {
+				return merge_with_defaults(parsed.output);
+			} else {
+				ctx.client.tui.showToast({
+					body: {
+						title: 'Svelte: Invalid opencode plugin config',
+						message: `${result.parse_error}\nUsing default values`,
+						variant: 'warning',
+						duration: 7000,
+					},
+				});
+			}
+		}
+	}
+
+	return default_config;
+}

package/index.ts

@@ -0,0 +1,72 @@
+import type { Plugin } from '@opencode-ai/plugin';
+import { readdir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { get_mcp_config } from './config.js';
+
+const current_dir = dirname(fileURLToPath(import.meta.url));
+
+export const svelte_plugin: Plugin = async (ctx) => {
+	return {
+		async config(input) {
+			input.agent ??= {};
+			input.mcp ??= {};
+			input.instructions ??= [];
+			// by default we use svelte as the name for the svelte MCP server
+			let svelte_mcp_name = 'svelte';
+			// we loop over every mcp server to see if any of them is already the svelte MCP server
+			for (const name in input.mcp) {
+				const mcp = input.mcp[name];
+				if (
+					(mcp?.type === 'remote' && mcp.url.includes('https://mcp.svelte.dev/mcp')) ||
+					(mcp?.type === 'local' &&
+						mcp.command.some((cmd: string) => cmd.includes('@sveltejs/mcp')))
+				) {
+					// if we found the svelte MCP server, we store its name and break
+					svelte_mcp_name = name;
+					break;
+				}
+			}
+			const mcp_config = get_mcp_config(ctx);
+
+			if (mcp_config.instructions?.enabled !== false) {
+				const instructions_dir = join(current_dir, 'instructions');
+				const instructions_paths = await readdir(instructions_dir);
+				input.instructions.push(...instructions_paths.map((file) => join(instructions_dir, file)));
+			}
+
+			// if the user doesn't have the MCP server already we add one based on config
+			if (!input.mcp[svelte_mcp_name] && mcp_config.mcp?.enabled !== false) {
+				if (mcp_config.mcp?.type === 'remote') {
+					input.mcp[svelte_mcp_name] = {
+						type: 'remote',
+						url: 'https://mcp.svelte.dev/mcp',
+					};
+				} else {
+					input.mcp[svelte_mcp_name] = {
+						type: 'local',
+						command: ['npx', '-y', '@sveltejs/mcp'],
+					};
+				}
+			}
+			if (mcp_config.subagent?.enabled !== false) {
+				// we add the editor subagent that will be used when editing Svelte files to prevent wasting context on the main agent
+				input.agent['svelte-file-editor'] = {
+					color: '#ff3e00',
+					mode: 'subagent',
+					prompt: `You are a specialized Svelte coder. Always use the tools from the svelte MCP server to fetch documentation with \`get_documentation\` and validating the code with \`svelte_autofixer\`. If the autofixer returns any issue or suggestions solve them before summarizing the changes for the main agent.`,
+					description:
+						'Specialized Svelte 5 code editor. MUST BE USED PROACTIVELY when creating, editing, or reviewing any .svelte file or .svelte.ts/.svelte.js module and MUST use the tools from the MCP server. Fetches relevant documentation and validates code using the Svelte MCP server tools.',
+					permission: {
+						bash: 'ask',
+						edit: 'allow',
+						webfetch: 'ask',
+					},
+					tools: {
+						[`${svelte_mcp_name}_*`]: true,
+					},
+				};
+			}
+		},
+	};
+};

package/instructions/opencode-agents.md

@@ -0,0 +1,23 @@
+You are able to use the Svelte MCP server, where you have access to comprehensive Svelte 5 and SvelteKit documentation. Here's how to use the available tools effectively:
+
+## Available MCP Tools:
+
+### 1. list-sections
+
+Use this FIRST to discover all available documentation sections. Returns a structured list with titles, use_cases, and paths.
+When asked about Svelte or SvelteKit topics, ALWAYS use this tool at the start of the chat to find relevant sections.
+
+### 2. get-documentation
+
+Retrieves full documentation content for specific sections. Accepts single or multiple sections.
+After calling the list-sections tool, you MUST analyze the returned documentation sections (especially the use_cases field) and then use the get-documentation tool to fetch ALL documentation sections that are relevant for the user's task.
+
+### 3. svelte-autofixer
+
+Analyzes Svelte code and returns issues and suggestions.
+You MUST use this tool whenever writing Svelte code before sending it to the user. Keep calling it until no issues or suggestions are returned.
+
+### 4. playground-link
+
+Generates a Svelte Playground link with the provided code.
+After completing the code, ask the user if they want a playground link. Only call this tool after user confirmation and NEVER if code was written to files in their project.

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@sveltejs/opencode",
+  "version": "0.0.1",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://github.com/sveltejs/mcp#readme",
+  "bugs": {
+    "url": "https://github.com/sveltejs/mcp/issues"
+  },
+  "files": [
+    "index.ts",
+    "config.ts",
+    "instructions"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sveltejs/mcp.git",
+    "path": "packages/opencode"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "valibot": "^1.2.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.1.21",
+    "@valibot/to-json-schema": "^1.5.0",
+    "@types/node": "^24.3.1"
+  },
+  "scripts": {
+    "check": "tsc --noEmit",
+    "generate-schema": "node --import node-resolve-ts/register scripts/generate-schema.ts"
+  }
+}