fix: lazy create schema + cache

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

.changeset/giant-monkeys-end.md

@@ -0,0 +1,5 @@
+---
+'@sveltejs/mcp': patch
+---
+
+feat: allow stdio mcp to read the content of the file directly

.changeset/small-actors-notice.md

@@ -0,0 +1,5 @@
+---
+'@sveltejs/mcp': patch
+---
+
+chore: remove db requirement

.github/workflows/check.yml

@@ -16,7 +16,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@v5
         with:
           version: 10.28.2
 
@@ -32,6 +32,4 @@ jobs:
       - name: Run type check
         run: pnpm run check
         env:
-          DATABASE_URL: file:test.db
-          DATABASE_TOKEN: dummy-key
           VOYAGE_API_KEY: dummy-key

.github/workflows/lint.yml

@@ -16,7 +16,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@v5
         with:
           version: 10.28.2
 
@@ -32,6 +32,4 @@ jobs:
       - name: Run linting
         run: pnpm run lint
         env:
-          DATABASE_URL: file:test.db
           VOYAGE_API_KEY: dummy-key
-          DATABASE_TOKEN: dummy-key

.github/workflows/publish-any-commit.yml

@@ -19,5 +19,8 @@ jobs:
 
       - name: Install dependencies
         run: pnpm install
+      # Opencode doesn't have a build step
+      - name: Build Stdio
+        run: pnpm --filter @sveltejs/mcp run build
 
       - run: pnpm dlx pkg-pr-new publish --compact './packages/mcp-stdio' './packages/opencode' --pnpm

.github/workflows/release.yml

@@ -64,7 +64,7 @@ jobs:
 
   publish-mcp:
     needs: release
-    if: contains(needs.release.outputs.publishedPackages, '"@sveltejs/ai-tools"')
+    if: contains(needs.release.outputs.publishedPackages, '"@sveltejs/mcp"')
     uses: ./.github/workflows/publish-mcp.yml
     secrets:
       MCP_KEY: ${{ secrets.MCP_KEY }}

.github/workflows/sync-plugins.yml

@@ -46,21 +46,12 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile --prefer-offline --ignore-scripts
 
-      - name: Sync Claude plugin
-        run: pnpm sync-claude-plugin
-
-      - name: Sync Cursor plugin
-        run: pnpm sync-cursor-plugin
-
-      - name: Sync OpenCode plugin
-        run: pnpm sync-opencode-plugin && pnpm generate-opencode-jsonschema
+      - name: Sync plugins
+        run: pnpm sync-plugins
 
       - name: Generate skills documentation
         run: pnpm generate-skill-docs
 
-      - name: Bump plugin versions for changed plugins
-        run: pnpm bump-plugin-versions
-
       - name: Check for changes
         id: git-check
         run: |

.github/workflows/test.yml

@@ -16,7 +16,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@v5
         with:
           version: 10.28.2
 
@@ -32,13 +32,9 @@ jobs:
       - name: Build project
         run: pnpm run build
         env:
-          DATABASE_URL: file:test.db
           VOYAGE_API_KEY: dummy-key
-          DATABASE_TOKEN: dummy-key
 
       - name: Run tests
         run: pnpm run test
         env:
-          DATABASE_URL: file:test.db
           VOYAGE_API_KEY: dummy-key
-          DATABASE_TOKEN: dummy-key

.prettierrc

@@ -10,6 +10,12 @@
 			"options": {
 				"parser": "svelte"
 			}
+		},
+		{
+			"files": "**/references/*.md",
+			"options": {
+				"embeddedLanguageFormatting": "off"
+			}
 		}
 	]
 }

CLAUDE.md

@@ -83,7 +83,6 @@ Located in `src/lib/server/analyze/`:
 
 Required environment variables:
 
-- `DATABASE_URL`: SQLite database path (default: `file:test.db`)
 - `VOYAGE_API_KEY`: API key for embeddings support (optional)
 
 When connected to the svelte-llm MCP server, you have access to comprehensive Svelte 5 and SvelteKit documentation. Here's how to use the available tools effectively:

apps/mcp-remote/.env.example

@@ -1,3 +1 @@
-DATABASE_URL=file:test.db
-DATABASE_TOKEN=needs_to_be_set_but_it_can_be_anything
 VOYAGE_API_KEY=your_actual_api_key_here

apps/mcp-remote/drizzle.config.ts

@@ -1,12 +0,0 @@
-import { defineConfig } from 'drizzle-kit';
-
-if (!process.env.DATABASE_URL) throw new Error('DATABASE_URL is not set');
-if (!process.env.DATABASE_TOKEN) throw new Error('DATABASE_TOKEN is not set');
-
-export default defineConfig({
-	schema: './src/lib/server/db/schema.ts',
-	dialect: 'turso',
-	dbCredentials: { url: process.env.DATABASE_URL, authToken: process.env.DATABASE_TOKEN },
-	verbose: true,
-	strict: true,
-});

apps/mcp-remote/package.json

@@ -23,10 +23,6 @@
 		"test:unit": "vitest",
 		"test": "npm run test:unit -- --run",
 		"test:watch": "npm run test:unit -- --watch",
-		"db:push": "drizzle-kit push",
-		"db:generate": "drizzle-kit generate",
-		"db:migrate": "drizzle-kit migrate",
-		"db:studio": "drizzle-kit studio",
 		"inspect": "pnpm mcp-inspector"
 	},
 	"keywords": [
@@ -39,15 +35,12 @@
 	"devDependencies": {
 		"@eslint/compat": "catalog:lint",
 		"@eslint/js": "catalog:lint",
-		"@libsql/client": "catalog:orm",
 		"@modelcontextprotocol/inspector": "catalog:ai",
 		"@sveltejs/adapter-vercel": "catalog:svelte",
 		"@sveltejs/kit": "catalog:svelte",
 		"@sveltejs/vite-plugin-svelte": "catalog:svelte",
 		"@types/node": "catalog:tooling",
 		"@typescript-eslint/parser": "catalog:lint",
-		"drizzle-kit": "catalog:orm",
-		"drizzle-orm": "catalog:orm",
 		"eslint-config-prettier": "catalog:lint",
 		"eslint-plugin-svelte": "catalog:lint",
 		"globals": "catalog:lint",
@@ -62,7 +55,6 @@
 		"vitest": "catalog:tooling"
 	},
 	"dependencies": {
-		"@sveltejs/mcp-schema": "workspace:^",
 		"@sveltejs/mcp-server": "workspace:^",
 		"@tmcp/transport-http": "catalog:tmcp",
 		"@vercel/analytics": "catalog:tooling",

apps/mcp-remote/src/hooks.server.ts

@@ -1,6 +1,5 @@
 import { dev } from '$app/environment';
 import { http_transport } from '$lib/mcp/index.js';
-import { db } from '$lib/server/db/index.js';
 import { redirect } from '@sveltejs/kit';
 import { track } from '@vercel/analytics/server';
 
@@ -17,7 +16,6 @@ export async function handle({ event, resolve }) {
 		}
 	}
 	const mcp_response = await http_transport.respond(event.request, {
-		db,
 		// only add analytics in production
 		track: dev
 			? undefined

apps/mcp-remote/src/lib/server/db/index.ts

@@ -1,13 +0,0 @@
-import { createClient } from '@libsql/client';
-import { drizzle } from 'drizzle-orm/libsql';
-import * as schema from './schema.js';
-import { DATABASE_TOKEN, DATABASE_URL } from '$env/static/private';
-if (!DATABASE_URL) throw new Error('DATABASE_URL is not set');
-if (!DATABASE_TOKEN) throw new Error('DATABASE_TOKEN is not set');
-
-const client = createClient({
-	url: DATABASE_URL,
-	authToken: DATABASE_TOKEN,
-});
-
-export const db = drizzle(client, { schema, logger: true });

apps/mcp-remote/src/lib/server/db/schema.ts

@@ -1,2 +0,0 @@
-// we need to re-export from here to allow for the drizzle config to pick them up for migrations
-export * from '@sveltejs/mcp-schema/schema';

documentation/docs/10-introduction/10-overview.md

@@ -17,6 +17,10 @@ To get the most out of the MCP server we recommend including the following promp
 
 > [!NOTE] This is already setup for you when using `npx sv add mcp`
 
+<!-- prettier-ignore-start -->
+````markdown
 @include .generated/agents.md
+````
+<!-- prettier-ignore-end -->
 
 If your MCP client supports it, we also recommend using the [svelte-task](prompts#svelte-task) prompt to instruct the LLM on the best way to use the MCP server.

documentation/docs/30-capabilities/.generated/prompts.md

@@ -5,10 +5,22 @@ This prompt should be used whenever you are asking the model to work on a Svelte
 <details>
 	<summary>Copy the prompt</summary>
 
-```md
+<!-- prettier-ignore-start -->
+````markdown
 You are a Svelte expert tasked to build components and utilities for Svelte developers. If you need documentation for anything related to Svelte you can invoke the tool `get-documentation` with one of the following paths. However: before invoking the `get-documentation` tool, try to answer the users query using your own knowledge and the `svelte-autofixer` tool. Be mindful of how many section you request, since it is token-intensive!
 <available-docs>
 
+- title: Overview, use_cases: use title and path to estimate use case, path: ai/overview
+- title: Local setup, use_cases: use title and path to estimate use case, path: ai/local-setup
+- title: Remote setup, use_cases: use title and path to estimate use case, path: ai/remote-setup
+- title: Tools, use_cases: use title and path to estimate use case, path: ai/tools
+- title: Resources, use_cases: use title and path to estimate use case, path: ai/resources
+- title: Prompts, use_cases: use title and path to estimate use case, path: ai/prompts
+- title: Overview, use_cases: use title and path to estimate use case, path: ai/plugin
+- title: Subagent, use_cases: use title and path to estimate use case, path: ai/subagent
+- title: Overview, use_cases: use title and path to estimate use case, path: ai/opencode-plugin
+- title: Subagent, use_cases: use title and path to estimate use case, path: ai/opencode-subagent
+- title: Overview, use_cases: use title and path to estimate use case, path: ai/skills
 - title: Overview, use_cases: project setup, creating new svelte apps, scaffolding, cli tools, initializing projects, path: cli/overview
 - title: Frequently asked questions, use_cases: project setup, initializing new svelte projects, troubleshooting cli installation, package manager configuration, path: cli/faq
 - title: sv create, use_cases: project setup, starting new sveltekit app, initializing project, creating from playground, choosing project template, path: cli/sv-create
@@ -18,7 +30,7 @@ You are a Svelte expert tasked to build components and utilities for Svelte deve
 - title: devtools-json, use_cases: development setup, chrome devtools integration, browser-based editing, local development workflow, debugging setup, path: cli/devtools-json
 - title: drizzle, use_cases: database setup, sql queries, orm integration, data modeling, postgresql, mysql, sqlite, server-side data access, database migrations, type-safe queries, path: cli/drizzle
 - title: eslint, use_cases: code quality, linting, error detection, project setup, code standards, team collaboration, typescript projects, path: cli/eslint
-- title: lucia, use_cases: authentication, login systems, user management, registration pages, session handling, auth setup, path: cli/lucia
+- title: better-auth, use_cases: use title and path to estimate use case, path: cli/better-auth
 - title: mcp, use_cases: use title and path to estimate use case, path: cli/mcp
 - title: mdsvex, use_cases: blog, content sites, markdown rendering, documentation sites, technical writing, cms integration, article pages, path: cli/mdsvex
 - title: paraglide, use_cases: internationalization, multi-language sites, i18n, translation, localization, language switching, global apps, multilingual content, path: cli/paraglide
@@ -29,6 +41,7 @@ You are a Svelte expert tasked to build components and utilities for Svelte deve
 - title: tailwindcss, use_cases: project setup, styling, css framework, rapid prototyping, utility-first css, design systems, responsive design, adding tailwind to svelte, path: cli/tailwind
 - title: vitest, use_cases: testing, unit tests, component testing, test setup, quality assurance, ci/cd pipelines, test-driven development, path: cli/vitest
 - title: add-on, use_cases: use title and path to estimate use case, path: cli/add-on
+- title: sv-utils, use_cases: use title and path to estimate use case, path: cli/sv-utils
 - title: Introduction, use_cases: learning sveltekit, project setup, understanding framework basics, choosing between svelte and sveltekit, getting started with full-stack apps, path: kit/introduction
 - title: Creating a project, use_cases: project setup, starting new sveltekit app, initial development environment, first-time sveltekit users, scaffolding projects, path: kit/creating-a-project
 - title: Project types, use_cases: deployment, project setup, choosing adapters, ssg, spa, ssr, serverless, mobile apps, desktop apps, pwa, offline apps, browser extensions, separate backend, docker containers, path: kit/project-types
@@ -96,17 +109,6 @@ You are a Svelte expert tasked to build components and utilities for Svelte deve
 - title: Configuration, use_cases: project setup, configuration, adapters, deployment, build settings, environment variables, routing customization, prerendering, csp security, csrf protection, path configuration, typescript setup, path: kit/configuration
 - title: Command Line Interface, use_cases: project setup, typescript configuration, generated types, ./$types imports, initial project configuration, path: kit/cli
 - title: Types, use_cases: typescript, type safety, route parameters, api endpoints, load functions, form actions, generated types, jsconfig setup, path: kit/types
-- title: Overview, use_cases: use title and path to estimate use case, path: mcp/overview
-- title: Local setup, use_cases: use title and path to estimate use case, path: mcp/local-setup
-- title: Remote setup, use_cases: use title and path to estimate use case, path: mcp/remote-setup
-- title: Tools, use_cases: use title and path to estimate use case, path: mcp/tools
-- title: Resources, use_cases: use title and path to estimate use case, path: mcp/resources
-- title: Prompts, use_cases: use title and path to estimate use case, path: mcp/prompts
-- title: Overview, use_cases: use title and path to estimate use case, path: mcp/plugin
-- title: Skill, use_cases: use title and path to estimate use case, path: mcp/skill
-- title: Subagent, use_cases: use title and path to estimate use case, path: mcp/subagent
-- title: Overview, use_cases: use title and path to estimate use case, path: mcp/opencode-plugin
-- title: Subagent, use_cases: use title and path to estimate use case, path: mcp/opencode-subagent
 - title: Overview, use_cases: always, any svelte project, getting started, learning svelte, introduction, project setup, understanding framework basics, path: svelte/overview
 - title: Getting started, use_cases: project setup, starting new svelte project, initial installation, choosing between sveltekit and vite, editor configuration, path: svelte/getting-started
 - title: .svelte files, use_cases: always, any svelte project, component creation, project setup, learning svelte basics, path: svelte/svelte-files
@@ -154,6 +156,7 @@ You are a Svelte expert tasked to build components and utilities for Svelte deve
 - title: Lifecycle hooks, use_cases: component initialization, cleanup tasks, timers, subscriptions, dom measurements, chat windows, autoscroll features, migration from svelte 4, path: svelte/lifecycle-hooks
 - title: Imperative component API, use_cases: project setup, client-side rendering, server-side rendering, ssr, hydration, testing, programmatic component creation, tooltips, dynamic mounting, path: svelte/imperative-component-api
 - title: Hydratable data, use_cases: use title and path to estimate use case, path: svelte/hydratable
+- title: Best practices, use_cases: use title and path to estimate use case, path: svelte/best-practices
 - title: Testing, use_cases: testing, quality assurance, unit tests, integration tests, component tests, e2e tests, vitest setup, playwright setup, test automation, path: svelte/testing
 - title: TypeScript, use_cases: typescript setup, type safety, component props typing, generic components, wrapper components, dom type augmentation, project configuration, path: svelte/typescript
 - title: Custom elements, use_cases: web components, custom elements, component library, design system, framework-agnostic components, embedding svelte in non-svelte apps, shadow dom, path: svelte/custom-elements
@@ -204,6 +207,7 @@ This is the task you will work on:
 </task>
 
 If you are not writing the code into a file, once you have the final version of the code ask the user if it wants to generate a playground link to quickly check the code in it and if it answer yes call the `playground-link` tool and return the url to the user nicely formatted. The playground link MUST be generated only once you have the final version of the code and you are ready to share it, it MUST include an entry point file called `App.svelte` where the main component should live. If you have multiple files to include in the playground link you can include them all at the root.
-```
+````
+<!-- prettier-ignore-end -->
 
 </details>

documentation/docs/50-opencode-plugin/opencode-plugin.md

@@ -6,7 +6,7 @@ OpenCode has a [plugin system](https://opencode.ai/docs/plugins/) that allows de
 
 ## Installation
 
-To install the plugin in OpenCode you can edit your [OpenCode config]() (either the global or the local one), adding `@sveltejs/opencode` to the list of plugins.
+To install the plugin in OpenCode you can edit your [OpenCode config](https://opencode.ai/docs/config/) (either the global or the local one), adding `@sveltejs/opencode` to the list of plugins.
 
 ```json
 {
@@ -23,7 +23,7 @@ The default configuration for the Svelte OpenCode plugin looks like this...
 
 ```json
 {
-	"$schema": "https://raw.githubusercontent.com/sveltejs/ai-tools/refs/heads/main/packages/opencode/schema.json",
+	"$schema": "https://svelte.dev/opencode/schema.json",
 	"mcp": {
 		"type": "remote",
 		"enabled": true

documentation/docs/60-skills/.generated/skills.md

@@ -217,7 +217,7 @@ The CSS in a component's `<style>` is scoped to that component. If a parent comp
 </style>
 ```
 
-If this impossible (for example, the child component comes from a library) you can use `:global` to override styles:
+If this is impossible (for example, the child component comes from a library) you can use `:global` to override styles:
 
 ```svelte
 <div>

package.json

@@ -25,10 +25,12 @@
 		"debug:generate-summaries": "pnpm --filter @sveltejs/mcp-server run debug:generate-summaries",
 		"release": "pnpm --filter @sveltejs/mcp run build && changeset publish",
 		"changeset:version": "changeset version && pnpm --filter @sveltejs/mcp run update:version && git add --all",
+		"sync-plugins": "pnpm sync-claude-plugin && pnpm sync-cursor-plugin && pnpm sync-opencode-plugin && pnpm bump-plugin-versions",
 		"sync-claude-plugin": "node scripts/sync-claude-plugin.ts",
 		"sync-cursor-plugin": "node scripts/sync-cursor-plugin.ts",
-		"sync-opencode-plugin": "node scripts/sync-opencode-plugin.ts",
+		"sync-opencode-plugin": "node scripts/sync-opencode-plugin.ts && pnpm generate-opencode-jsonschema",
 		"bump-plugin-versions": "node scripts/bump-plugin-versions.ts",
+		"postbump-plugin-versions": "pnpm format",
 		"resolve-references": "node scripts/resolve-references.ts",
 		"postresolve-references": "pnpm format"
 	},

packages/mcp-schema/package.json

@@ -1,19 +0,0 @@
-{
-	"name": "@sveltejs/mcp-schema",
-	"version": "0.0.1",
-	"private": true,
-	"description": "",
-	"main": "index.js",
-	"exports": {
-		".": "./src/index.js",
-		"./utils": "./src/utils.js",
-		"./schema": "./src/schema.js"
-	},
-	"keywords": [],
-	"author": "",
-	"license": "ISC",
-	"type": "module",
-	"dependencies": {
-		"drizzle-orm": "catalog:orm"
-	}
-}

packages/mcp-schema/src/index.js

@@ -1,8 +0,0 @@
-/**
- * @import * as schema from './schema.js'
- */
-export * from './schema.js';
-
-/**
- * @typedef {typeof schema} Schema
- */

packages/mcp-schema/src/schema.js

@@ -1,82 +0,0 @@
-import { integer, sqliteTable, text } from 'drizzle-orm/sqlite-core';
-import { float_32_array } from './utils.js';
-
-/**
- * NOTE: if you modify a schema adding a vector column you need to manually add this
- *
- * CREATE INDEX IF NOT EXISTS name_of_the_index
- * ON `name_of_the_table` (
- * 	libsql_vector_idx(name_of_the_column, 'metric=cosine')
- * )
- *
- * to the generated migration file
- */
-
-export const distillations = sqliteTable('distillations', {
-	id: integer('id').primaryKey(),
-	preset_name: text('preset_name').notNull(),
-	version: text('version').notNull(),
-	content: text('content').notNull(),
-	size_kb: integer('size_kb').notNull(),
-	document_count: integer('document_count').notNull(),
-	distillation_job_id: integer('distillation_job_id').references(() => distillation_jobs.id),
-	created_at: integer('created_at', { mode: 'timestamp' })
-		.notNull()
-		.$defaultFn(() => new Date()),
-});
-
-export const distillation_jobs = sqliteTable('distillation_jobs', {
-	id: integer('id').primaryKey(),
-	preset_name: text('preset_name').notNull(),
-	batch_id: text('batch_id'),
-	status: text('status', { enum: ['pending', 'processing', 'completed', 'failed'] }).notNull(),
-	model_used: text('model_used').notNull(),
-	total_files: integer('total_files').notNull(),
-	processed_files: integer('processed_files').notNull().default(0),
-	successful_files: integer('successful_files').notNull().default(0),
-	minimize_applied: integer('minimize_applied', { mode: 'boolean' }).notNull().default(false),
-	total_input_tokens: integer('total_input_tokens').notNull().default(0),
-	total_output_tokens: integer('total_output_tokens').notNull().default(0),
-	started_at: integer('started_at', { mode: 'timestamp' }),
-	completed_at: integer('completed_at', { mode: 'timestamp' }),
-	error_message: text('error_message'),
-	metadata: text('metadata', { mode: 'json' }).notNull().default({}),
-	created_at: integer('created_at', { mode: 'timestamp' })
-		.notNull()
-		.$defaultFn(() => new Date()),
-	updated_at: integer('updated_at', { mode: 'timestamp' })
-		.notNull()
-		.$defaultFn(() => new Date()),
-});
-
-export const content = sqliteTable('content', {
-	id: integer('id').primaryKey(),
-	path: text('path').notNull(),
-	filename: text('filename').notNull(),
-	content: text('content').notNull(),
-	size_bytes: integer('size_bytes').notNull(),
-	embeddings: float_32_array('embeddings', { dimensions: 1024 }),
-	metadata: text('metadata', { mode: 'json' }).notNull().default({}),
-	created_at: integer('created_at', { mode: 'timestamp' })
-		.notNull()
-		.$defaultFn(() => new Date()),
-	updated_at: integer('updated_at', { mode: 'timestamp' })
-		.notNull()
-		.$defaultFn(() => new Date()),
-});
-
-export const content_distilled = sqliteTable('content_distilled', {
-	id: integer('id').primaryKey(),
-	path: text('path').notNull(),
-	filename: text('filename').notNull(),
-	content: text('content').notNull(),
-	size_bytes: integer('size_bytes').notNull(),
-	embeddings: float_32_array('embeddings', { dimensions: 1024 }),
-	metadata: text('metadata', { mode: 'json' }).notNull().default({}),
-	created_at: integer('created_at', { mode: 'timestamp' })
-		.notNull()
-		.$defaultFn(() => new Date()),
-	updated_at: integer('updated_at', { mode: 'timestamp' })
-		.notNull()
-		.$defaultFn(() => new Date()),
-});

packages/mcp-schema/src/utils.js

@@ -1,65 +0,0 @@
-/**
- * @import { Column } from 'drizzle-orm';
- */
-import { sql } from 'drizzle-orm';
-import { customType } from 'drizzle-orm/sqlite-core';
-
-/**
- * Helper function to convert an array of embeddings into a format that can be inserted into a LibSQL vector column.
- * @param {number[]} arr The embeddings array.
- */
-export function vector(arr) {
-	return sql`vector32(${JSON.stringify(arr)})`;
-}
-
-/**
- * Helper function to calculate the distance between a vector column and an array of embeddings and return it as a columns.
- * @param {Column} column The drizzle column representing the vector.
- * @param {number} arr The embeddings array.
- * @param {string} as The name of the returned column. Default is 'distance'.
- *
- * @example
- * await db.select({
- *   id: vector_table.id,
- *   text: vector_table.text,
- *   distance: distance(vector_table.vector, await get_embeddings(sentence)),
- * })
- * .from(vector_table)
- * .orderBy(sql`distance`)
- * .execute();
- */
-export function distance(column, arr, as = 'distance') {
-	return /** @type {typeof sql<number>} */ (
-		sql
-	)`CASE ${column} ISNULL WHEN 1 THEN 1 ELSE vector_distance_cos(${column}, vector32(${JSON.stringify(arr)})) END`.as(
-		as,
-	);
-}
-
-/**
- * Custom drizzle type to use the LibSQL vector column type.
- */
-export const float_32_array = /** @type {typeof customType<{
-	data: number[];
-	config: { dimensions: number };
-	configRequired: true;
-	driverData: Buffer;
-}>} */ (customType)({
-	dataType(config) {
-		return `F32_BLOB(${config.dimensions})`;
-	},
-	/**
-	 * @param {Buffer} value
-	 */
-	fromDriver(value) {
-		return Array.from(new Float32Array(value.buffer));
-	},
-	/**
-	 *
-	 * @param {number[]} value
-	 * @returns
-	 */
-	toDriver(value) {
-		return vector(value);
-	},
-});

packages/mcp-server/package.json

@@ -17,12 +17,8 @@
 		".": "./src/index.ts",
 		"./handlers": "./src/mcp/handlers/tools/handlers.ts"
 	},
-	"peerDependencies": {
-		"drizzle-orm": "^0.45.0"
-	},
 	"dependencies": {
 		"@mcp-ui/server": "catalog:ai",
-		"@sveltejs/mcp-schema": "workspace:^",
 		"@tmcp/adapter-valibot": "catalog:tmcp",
 		"@tmcp/transport-in-memory": "catalog:tmcp",
 		"@typescript-eslint/parser": "catalog:lint",

packages/mcp-server/src/mcp/autofixers/add-autofixers-issues.test.ts

@@ -344,87 +344,111 @@ describe('add_autofixers_issues', () => {
 	});
 
 	describe('imported_runes', () => {
-		describe.each([{ source: 'svelte' }, { source: 'svelte/runes' }])(
-			'from "$source"',
-			({ source }) => {
-				describe.each(dollarless_runes)('single import ($rune)', ({ rune }) => {
-					it(`should add suggestions when importing '${rune}' from '${source}'`, () => {
-						const content = run_autofixers_on_code(`
+		describe.each([
+			{ source: 'svelte' },
+			{ source: 'svelte/runes' },
+			{ source: '@sveltejs/runes' },
+			{ source: '@sveltejs/vite-plugin-svelte' },
+		])('from "$source"', ({ source }) => {
+			describe.each(dollarless_runes)('single import ($rune)', ({ rune }) => {
+				it(`should add suggestions when importing '${rune}' from '${source}'`, () => {
+					const content = run_autofixers_on_code(`
 					<script>
 						import { ${rune} } from '${source}';
 					</script>`);
 
-						expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
-						expect(content.suggestions).toContain(
-							`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
-						);
-					});
+					expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
+					expect(content.suggestions).toContain(
+						`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
+					);
+				});
 
-					it(`should add suggestions when importing "${rune}" as the default export from '${source}'`, () => {
-						const content = run_autofixers_on_code(`
+				it(`should add suggestions when importing "${rune}" as the default export from '${source}'`, () => {
+					const content = run_autofixers_on_code(`
 					<script>
 						import ${rune} from '${source}';
 					</script>`);
 
-						expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
-						expect(content.suggestions).toContain(
-							`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
-						);
-					});
+					expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
+					expect(content.suggestions).toContain(
+						`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
+					);
+				});
 
-					it(`should add suggestions when importing '${rune}' as the namespace export from '${source}'`, () => {
-						const content = run_autofixers_on_code(`
+				it(`should add suggestions when importing '${rune}' as the namespace export from '${source}'`, () => {
+					const content = run_autofixers_on_code(`
 					<script>
 						import * as ${rune} from '${source}';
 					</script>`);
 
-						expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
-						expect(content.suggestions).toContain(
-							`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
-						);
-					});
+					expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
+					expect(content.suggestions).toContain(
+						`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
+					);
 				});
+			});
 
-				it(`should add suggestions when importing multiple runes from '${source}'`, () => {
-					const content = run_autofixers_on_code(`
+			it(`should add suggestions when importing multiple runes from '${source}'`, () => {
+				const content = run_autofixers_on_code(`
 					<script>
 						import { onMount, state, effect } from '${source}';
 					</script>`);
 
-					expect(content.suggestions.length).toBeGreaterThanOrEqual(2);
-					expect(content.suggestions).toContain(
-						`You are importing "state" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$state" directly.`,
-					);
-					expect(content.suggestions).toContain(
-						`You are importing "effect" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$effect" directly.`,
-					);
-				});
+				expect(content.suggestions.length).toBeGreaterThanOrEqual(2);
+				expect(content.suggestions).toContain(
+					`You are importing "state" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$state" directly.`,
+				);
+				expect(content.suggestions).toContain(
+					`You are importing "effect" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$effect" directly.`,
+				);
+			});
 
-				it(`should not add suggestions when importing other identifiers from '${source}'`, () => {
-					const content = run_autofixers_on_code(`
+			it(`should not add suggestions when importing other identifiers from '${source}'`, () => {
+				const content = run_autofixers_on_code(`
 					<script>
 						import { onMount } from '${source}';
 					</script>`);
 
-					expect(content.suggestions).not.toContain(
-						`You are importing "onMount" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$onMount" directly.`,
-					);
-				});
-			},
-		);
+				expect(content.suggestions).not.toContain(
+					`You are importing "onMount" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$onMount" directly.`,
+				);
+			});
+		});
 
 		describe.each(dollarless_runes)('importing $rune from external lib', ({ rune }) => {
-			it(`should not add suggestions when importing from packages that are not svelte`, () => {
+			it(`should not add suggestions when importing from packages whose name doesn't contain svelte`, () => {
+				const content = run_autofixers_on_code(`
+				<script>
+					import { ${rune} } from 'something-something';
+				</script>`);
+
+				expect(content.suggestions).not.toContain(
+					`You are importing "${rune}" from "something-something". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
+				);
+			});
+
+			it(`should add suggestions with a different hint when importing from packages whose name contains svelte but it's not official`, () => {
 				const content = run_autofixers_on_code(`
 				<script>
 					import { ${rune} } from 'svelte-something-something';
 				</script>`);
 
-				expect(content.suggestions).not.toContain(
-					`You are importing "${rune}" from "svelte-something-something". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
+				expect(content.suggestions).toContain(
+					`You are importing "${rune}" from "svelte-something-something". If you are trying to import runes to use them this is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly. If you are importing the function from a separate library ignore this suggestion.`,
 				);
 			});
 		});
+
+		it('should not add the imported_runes suggestion when importing derived from svelte/store', () => {
+			const content = run_autofixers_on_code(`
+			<script>
+				import { derived } from 'svelte/store';
+			</script>`);
+
+			expect(content.suggestions).not.toContain(
+				'You are importing "derived" from "svelte/store". This is not necessary, all runes are globally available. Please remove this import and use "$derived" directly.',
+			);
+		});
 	});
 
 	describe('derived_with_function', () => {

packages/mcp-server/src/mcp/autofixers/visitors/imported-runes.ts

@@ -3,10 +3,20 @@ import type { Autofixer } from './index.js';
 
 const dollarless_runes = base_runes.map((r) => r.replace('$', ''));
 
+function should_suggest_for_source(source: string, rune: string) {
+	if (!source.includes('svelte')) {
+		return false;
+	}
+	if (source === 'svelte/store' && rune === 'derived') {
+		return false;
+	}
+	return true;
+}
+
 export const imported_runes: Autofixer = {
 	ImportDeclaration(node, { state, next }) {
 		const source = (node.source.value || node.source.raw?.slice(1, -1))?.toString();
-		if (source && (source === 'svelte' || source.startsWith('svelte/'))) {
+		if (source) {
 			for (const specifier of node.specifiers) {
 				const id =
 					specifier.type === 'ImportDefaultSpecifier'
@@ -16,10 +26,25 @@ export const imported_runes: Autofixer = {
 							: specifier.type === 'ImportSpecifier'
 								? specifier.imported
 								: null;
-				if (id && id.type === 'Identifier' && dollarless_runes.includes(id.name)) {
-					state.output.suggestions.push(
-						`You are importing "${id.name}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${id.name}" directly.`,
-					);
+				if (
+					id &&
+					id.type === 'Identifier' &&
+					dollarless_runes.includes(id.name) &&
+					should_suggest_for_source(source, id.name)
+				) {
+					if (
+						source === 'svelte' ||
+						source.startsWith('svelte/') ||
+						source.startsWith('@sveltejs')
+					) {
+						state.output.suggestions.push(
+							`You are importing "${id.name}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${id.name}" directly.`,
+						);
+					} else {
+						state.output.suggestions.push(
+							`You are importing "${id.name}" from "${source}". If you are trying to import runes to use them this is not necessary, all runes are globally available. Please remove this import and use "$${id.name}" directly. If you are importing the function from a separate library ignore this suggestion.`,
+						);
+					}
 				}
 			}
 		}

packages/mcp-server/src/mcp/handlers/tools/svelte-autofixer.test.ts

@@ -1,4 +1,7 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
+import { writeFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
 import { InMemoryTransport } from '@tmcp/transport-in-memory';
 import { beforeEach, describe, expect, it } from 'vitest';
 import { server } from '../../index.js';
@@ -12,13 +15,18 @@ async function autofixer_tool_call(
 	is_error = false,
 	desired_svelte_version = 5,
 	async = false,
+	ctx?: { stdio?: boolean },
 ) {
-	const result = await session.callTool('svelte-autofixer', {
-		code,
-		desired_svelte_version,
-		filename: 'App.svelte',
-		async,
-	});
+	const result = await session.callTool(
+		'svelte-autofixer',
+		{
+			code,
+			desired_svelte_version,
+			filename: 'App.svelte',
+			async,
+		},
+		ctx,
+	);
 
 	expect(result).toBeDefined();
 	if (is_error) {
@@ -146,4 +154,40 @@ describe('svelte-autofixer tool', () => {
 			'The desired_svelte_version MUST be either 4 or 5 but received "3"',
 		);
 	});
+
+	it('should read file content from path when stdio context is true', async () => {
+		const tmp_file = join(tmpdir(), `svelte-autofixer-test-${Date.now()}.svelte`);
+		const file_content = `<script>
+			$state count = 0;
+		</script>`;
+
+		writeFileSync(tmp_file, file_content, 'utf-8');
+
+		try {
+			// with stdio: true, the file is read from disk and parsed, producing issues
+			const content = await autofixer_tool_call(tmp_file, false, 5, false, { stdio: true });
+			expect(content.issues.length).toBeGreaterThan(0);
+			expect(content.suggestions.length).toBeGreaterThan(0);
+		} finally {
+			unlinkSync(tmp_file);
+		}
+	});
+
+	it('should treat file path as code when stdio context is not set', async () => {
+		const tmp_file = join(tmpdir(), `svelte-autofixer-test-${Date.now()}.svelte`);
+		const file_content = `<script>
+			$state count = 0;
+		</script>`;
+
+		writeFileSync(tmp_file, file_content, 'utf-8');
+
+		try {
+			// without stdio context, the path string is treated as raw code (plain text), no issues
+			const content = await autofixer_tool_call(tmp_file, false, 5, false);
+			expect(content.issues).toHaveLength(0);
+			expect(content.suggestions).toHaveLength(0);
+		} finally {
+			unlinkSync(tmp_file);
+		}
+	});
 });

packages/mcp-server/src/mcp/handlers/tools/svelte-autofixer.ts

@@ -1,33 +1,47 @@
 import { basename } from 'node:path';
-import type { SvelteMcp } from '../../index.js';
+import { tool } from 'tmcp/utils';
 import * as v from 'valibot';
+import { add_autofixers_issues } from '../../autofixers/add-autofixers-issues.js';
 import { add_compile_issues } from '../../autofixers/add-compile-issues.js';
 import { add_eslint_issues } from '../../autofixers/add-eslint-issues.js';
-import { add_autofixers_issues } from '../../autofixers/add-autofixers-issues.js';
 import { icons } from '../../icons/index.js';
-import { tool } from 'tmcp/utils';
+import { type SvelteMcp } from '../../index.js';
 
-const autofixer_schema = v.object({
-	code: v.string(),
-	desired_svelte_version: v.pipe(
-		v.union([v.string(), v.number()]),
-		v.description(
-			'The desired svelte version...if possible read this from the package.json of the user project, otherwise use some hint from the wording (if the user asks for runes it wants version 5). Default to 5 in case of doubt.',
+let cached_schema: ReturnType<typeof get_autofixer_schema> | null = null;
+
+function get_autofixer_schema(stdio: boolean) {
+	let code = v.string();
+	if (stdio) {
+		// we only add the description if we are running in stdio, this saves a few tokens for the remote server
+		code = v.pipe(
+			v.string(),
+			v.description(
+				"The code to be processed by the autofixer. It can also be a path to a file containing the code. If the file doesn't exists the string will be treated as the code",
+			),
+		);
+	}
+	return v.object({
+		code,
+		desired_svelte_version: v.pipe(
+			v.union([v.string(), v.number()]),
+			v.description(
+				'The desired svelte version...if possible read this from the package.json of the user project, otherwise use some hint from the wording (if the user asks for runes it wants version 5). Default to 5 in case of doubt.',
+			),
 		),
-	),
-	async: v.pipe(
-		v.optional(v.boolean()),
-		v.description(
-			'If true the code is an async component/module and might use await in the markup or top-level awaits in the script tag. If possible check the svelte.config.js/svelte.config.ts to check if the option is enabled otherwise asks the user if they prefer using it or not. You can only use this option if the version is 5.',
+		async: v.pipe(
+			v.optional(v.boolean()),
+			v.description(
+				'If true the code is an async component/module and might use await in the markup or top-level awaits in the script tag. If possible check the svelte.config.js/svelte.config.ts to check if the option is enabled otherwise asks the user if they prefer using it or not. You can only use this option if the version is 5.',
+			),
 		),
-	),
-	filename: v.pipe(
-		v.optional(v.string()),
-		v.description(
-			'The filename of the component if available, it MUST be only the Component name with .svelte or .svelte.ts extension and not the entire path.',
+		filename: v.pipe(
+			v.optional(v.string()),
+			v.description(
+				'The filename of the component if available, it MUST be only the Component name with .svelte or .svelte.ts extension and not the entire path.',
+			),
 		),
-	),
-});
+	});
+}
 
 const autofixer_output_schema = v.object({
 	issues: v.array(v.string()),
@@ -40,7 +54,7 @@ export async function svelte_autofixer_handler({
 	desired_svelte_version: desired_svelte_version_unchecked,
 	async,
 	filename: filename_or_path,
-}: v.InferInput<typeof autofixer_schema>) {
+}: v.InferInput<ReturnType<typeof get_autofixer_schema>>) {
 	// we validate manually because some clients don't support union in the input schema (looking at you cursor)
 	const parsed_version = v.safeParse(
 		v.union([v.literal(4), v.literal(5), v.literal('4'), v.literal('5')]),
@@ -110,7 +124,11 @@ export function svelte_autofixer(server: SvelteMcp) {
 			title: 'Svelte Autofixer',
 			description:
 				'Given a svelte component or module returns a list of suggestions to fix any issues it has. This tool MUST be used whenever the user is asking to write svelte code before sending the code back to the user',
-			schema: autofixer_schema,
+			get schema() {
+				return (
+					cached_schema ?? (cached_schema = get_autofixer_schema(server.ctx.custom?.stdio ?? false))
+				);
+			},
 			outputSchema: autofixer_output_schema,
 			annotations: {
 				title: 'Svelte Autofixer',
@@ -129,6 +147,18 @@ export function svelte_autofixer(server: SvelteMcp) {
 			if (server.ctx.sessionId && server.ctx.custom?.track) {
 				await server.ctx.custom?.track?.(server.ctx.sessionId, 'svelte-autofixer');
 			}
+
+			// we only do this if we know we are running in stdio mode (only stdio pass the context as true)
+			if (server.ctx.custom?.stdio) {
+				const [exists_sync, read_file] = await Promise.all([
+					import('node:fs').then((mod) => mod.existsSync),
+					import('node:fs/promises').then((mod) => mod.readFile),
+				]);
+				if (exists_sync(code)) {
+					code = await read_file(code, 'utf-8');
+				}
+			}
+
 			try {
 				const content = await svelte_autofixer_handler({
 					code,

packages/mcp-server/src/mcp/index.ts

@@ -1,8 +1,6 @@
 import { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot';
 import { McpServer } from 'tmcp';
 import { setup_prompts, setup_resources, setup_tools } from './handlers/index.js';
-import type { LibSQLDatabase } from 'drizzle-orm/libsql';
-import type { Schema } from '@sveltejs/mcp-schema';
 import { icons } from './icons/index.js';
 
 export const server = new McpServer(
@@ -25,8 +23,8 @@ export const server = new McpServer(
 			'This is the official Svelte MCP server. It MUST be used whenever svelte development is involved. It can provide official documentation, code examples and correct your code. After you correct the component call this tool again to confirm all the issues are fixed.',
 	},
 ).withContext<{
-	db: LibSQLDatabase<Schema>;
 	track?: (sessionId: string, event: string, extra?: string) => Promise<void>;
+	stdio?: boolean;
 }>();
 
 export type SvelteMcp = typeof server;

packages/mcp-stdio/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @sveltejs/mcp
 
+## 0.1.22
+
+### Patch Changes
+
+- fix: broaden checks for imported runes because LLMs are unhinged ([#185](https://github.com/sveltejs/ai-tools/pull/185))
+
 ## 0.1.21
 
 ### Patch Changes

packages/mcp-stdio/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sveltejs/mcp",
-	"version": "0.1.21",
+	"version": "0.1.22",
 	"type": "module",
 	"license": "MIT",
 	"mcpName": "dev.svelte/mcp",

packages/mcp-stdio/server.json

@@ -9,7 +9,7 @@
 		"subfolder": "packages/mcp-stdio",
 		"source": "github"
 	},
-	"version": "0.1.21",
+	"version": "0.1.22",
 	"websiteUrl": "https://svelte.dev/docs/mcp/overview",
 	"icons": [
 		{
@@ -25,7 +25,7 @@
 		{
 			"registryType": "npm",
 			"identifier": "@sveltejs/mcp",
-			"version": "0.1.21",
+			"version": "0.1.22",
 			"runtimeHint": "npx",
 			"transport": {
 				"type": "stdio"

packages/mcp-stdio/src/index.ts

@@ -14,7 +14,9 @@ const cli = sade('svelte-mcp');
 
 cli.command('__mcp', '', { default: true }).action(() => {
 	const transport = new StdioTransport(server);
-	transport.listen();
+	transport.listen({
+		stdio: true,
+	});
 });
 
 cli

packages/opencode/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @sveltejs/opencode
 
+## 0.1.8
+
+### Patch Changes
+
+- fix: add `server` export to opencode plugin ([`96c50ac`](https://github.com/sveltejs/ai-tools/commit/96c50acae2b4131a6c72d3579a73c44ab9158b18))
+
+## 0.1.7
+
+### Patch Changes
+
+- fix: import `ts` files directly ([#190](https://github.com/sveltejs/ai-tools/pull/190))
+
+## 0.1.6
+
+### Patch Changes
+
+- chore: sync skills from svelte.dev ([#178](https://github.com/sveltejs/ai-tools/pull/178))
+
+- fix: update svelte-file-editor agent to use proper name ([#183](https://github.com/sveltejs/ai-tools/pull/183))
+
 ## 0.1.5
 
 ### Patch Changes

packages/opencode/README.md

@@ -36,39 +36,76 @@ The plugin injects instructions that teach the agent how to effectively use the
 
 ## Configuration
 
-The default configuration:
+Create `svelte.json` to customize how the plugin configures MCP, the Svelte subagent, instructions, and skills.
 
 ```json
 {
-	"$schema": "https://raw.githubusercontent.com/sveltejs/ai-tools/refs/heads/main/packages/opencode/schema.json",
+	"$schema": "https://svelte.dev/opencode/schema.json",
 	"mcp": {
 		"type": "remote",
 		"enabled": true
 	},
 	"subagent": {
-		"enabled": true
+		"enabled": true,
+		"agents": {
+			"svelte-file-editor": {
+				"model": "anthropic/claude-sonnet-4-20250514",
+				"temperature": 0.7,
+				"top_p": 0.9,
+				"maxSteps": 20
+			}
+		}
 	},
 	"instructions": {
 		"enabled": true
+	},
+	"skills": {
+		"enabled": ["svelte-code-writer", "svelte-core-bestpractices"]
 	}
 }
 ```
 
+### Defaults
+
+If omitted, the plugin uses these defaults:
+
+- `mcp.type`: `"remote"`
+- `mcp.enabled`: `true`
+- `subagent.enabled`: `true`
+- `subagent.agents`: `{}`
+- `instructions.enabled`: `true`
+- `skills.enabled`: `true`
+
 ### Configuration Options
 
-| Option                 | Type                    | Default    | Description                                                                      |
-| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------- |
-| `mcp.type`             | `"remote"` \| `"local"` | `"remote"` | Use the remote server at `mcp.svelte.dev` or run locally via `npx @sveltejs/mcp` |
-| `mcp.enabled`          | `boolean`               | `true`     | Enable/disable the MCP server                                                    |
-| `subagent.enabled`     | `boolean`               | `true`     | Enable/disable the Svelte file editor subagent                                   |
-| `instructions.enabled` | `boolean`               | `true`     | Enable/disable agent instructions injection                                      |
+| Option                                           | Type                  | Default    | Description                                                                                    |
+| ------------------------------------------------ | --------------------- | ---------- | ---------------------------------------------------------------------------------------------- |
+| `mcp.type`                                       | `"remote" \| "local"` | `"remote"` | Use `https://mcp.svelte.dev/mcp` (`remote`) or run `@sveltejs/mcp` via `npx` (`local`).        |
+| `mcp.enabled`                                    | `boolean`             | `true`     | Enable or disable the Svelte MCP server entry.                                                 |
+| `subagent.enabled`                               | `boolean`             | `true`     | Enable or disable registration of the `svelte-file-editor` subagent.                           |
+| `subagent.agents.svelte-file-editor.model`       | `string`              | main agent | Override the model used by the Svelte file editor subagent.                                    |
+| `subagent.agents.svelte-file-editor.temperature` | `number`              | unset      | Set temperature for the subagent.                                                              |
+| `subagent.agents.svelte-file-editor.top_p`       | `number`              | unset      | Set top-p sampling for the subagent.                                                           |
+| `subagent.agents.svelte-file-editor.maxSteps`    | `number`              | unlimited  | Limit the number of steps the subagent can execute.                                            |
+| `instructions.enabled`                           | `boolean`             | `true`     | Enable or disable automatic instruction-file injection.                                        |
+| `skills.enabled`                                 | `boolean \| string[]` | `true`     | Enable all skills (`true`), disable all skills (`false`), or enable only specific skill names. |
 
-### Config File Location
+### Supported Skill Names
 
-Place your configuration at one of these locations:
+When using `skills.enabled` as an array, these built-in names are currently available:
 
-- `~/.config/opencode/svelte.json` (global)
-- `$OPENCODE_CONFIG_DIR/svelte.json` (if `OPENCODE_CONFIG_DIR` is set, takes priority)
+- `svelte-code-writer`
+- `svelte-core-bestpractices`
+
+### Config File Locations and Precedence
+
+The plugin reads from these files (lowest priority first, highest priority last):
+
+- `~/.config/opencode/svelte.json`
+- `$OPENCODE_CONFIG_DIR/svelte.json` (when `OPENCODE_CONFIG_DIR` is set)
+- `.opencode/svelte.json` in the current project
+
+If the same key is defined in multiple files, the later location overrides earlier ones.
 
 ## License
 

packages/opencode/agents.ts

@@ -0,0 +1,11 @@
+// This file is auto-generated by scripts/sync-opencode-plugin.ts
+// Do not edit manually — edit the markdown files in tools/agents/ instead.
+
+export const agents = {
+	'svelte-file-editor': {
+		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 or the `svelte-file-editor` skill if they are available. Fetches relevant documentation and validates code using the Svelte MCP server tools.',
+		prompt:
+			"You are a Svelte 5 expert responsible for writing, editing, and validating Svelte components and modules. You have access to the Svelte MCP server which provides documentation and code analysis tools. 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 try to solve them.\n\nIf the MCP tools are not available you can use the `svelte-code-writer` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.\n\nIf the skill is not available you can run `npx @sveltejs/mcp@latest -y --help` to learn how to use it.\n\n## Available MCP Tools\n\n### 1. list-sections\n\nLists all available Svelte 5 and SvelteKit documentation sections with titles and paths. Use this first to discover what documentation is available.\n\n### 2. get-documentation\n\nRetrieves full documentation for specified sections. Accepts a single section name or an array of section names. Use after `list-sections` to fetch relevant docs for the task at hand.\n\n**Example sections:** `$state`, `$derived`, `$effect`, `$props`, `$bindable`, `snippets`, `routing`, `load functions`\n\n### 3. svelte-autofixer\n\nAnalyzes Svelte code and returns suggestions to fix issues. Pass the component code directly to this tool. It will detect common mistakes like:\n\n- Using `$effect` instead of `$derived` for computations\n- Missing cleanup in effects\n- Svelte 4 syntax (`on:click`, `export let`, `<slot>`)\n- Missing keys in `{#each}` blocks\n- And more\n\n## Workflow\n\nWhen invoked to work on a Svelte file:\n\n### 1. Gather Context (if needed)\n\nIf you're uncertain about Svelte 5 syntax or patterns, use the MCP tools:\n\n1. Call `list-sections` to see available documentation\n2. Call `get-documentation` with relevant section names\n\n### 2. Read the Target File\n\nRead the file to understand the current implementation.\n\n### 3. Make Changes\n\nApply edits following Svelte 5 best practices:\n\n### 4. Validate Changes\n\nAfter editing, ALWAYS call `svelte-autofixer` with the updated code to check for issues.\n\n### 5. Fix Any Issues\n\nIf the autofixer reports problems, fix them and re-validate until no issues remain.\n\n## Output Format\n\nAfter completing your work, provide:\n\n1. Summary of changes made\n2. Any issues found and fixed by the autofixer\n3. Recommendations for further improvements (if any)",
+	},
+} as const;

packages/opencode/index.ts

@@ -2,7 +2,8 @@ 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';
+import { agents } from './agents.ts';
+import { get_mcp_config } from './config.ts';
 
 const current_dir = dirname(fileURLToPath(import.meta.url));
 
@@ -72,105 +73,44 @@ export const svelte_plugin: Plugin = async (ctx) => {
 				}
 			}
 			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
-				const default_config: (typeof input.agent)[string] = {
-					color: '#ff3e00',
-					mode: 'subagent',
-					prompt: `You are a Svelte 5 expert responsible for writing, editing, and validating Svelte components and modules. You have access to the Svelte MCP server which provides documentation and code analysis tools. 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 try to solve them.
+				for (const [agent_name, agent_data] of Object.entries(agents)) {
+					// we add the editor subagent that will be used when editing Svelte files to prevent wasting context on the main agent
+					const default_config: (typeof input.agent)[string] = {
+						color: '#ff3e00',
+						mode: 'subagent',
+						prompt: agent_data.prompt,
+						description: agent_data.description,
+						permission: {
+							bash: 'ask',
+							edit: 'allow',
+							webfetch: 'ask',
+						},
+						tools: {
+							[`${svelte_mcp_name}_*`]: true,
+						},
+					};
 
-If the MCP tools are not available you can use the \`svelte-code-editor\` skill to learn how to use the \`@sveltejs/mcp\` cli to access the same tools.
+					// Get per-agent config from svelte.json (if any)
+					const agent_config = mcp_config.subagent?.agents?.[agent_name];
 
-If the skill is not available you can run \`npx @sveltejs/mcp@latest -y --help\` to learn how to use it.
-
-## Available MCP Tools
-
-### 1. list-sections
-
-Lists all available Svelte 5 and SvelteKit documentation sections with titles and paths. Use this first to discover what documentation is available.
-
-### 2. get-documentation
-
-Retrieves full documentation for specified sections. Accepts a single section name or an array of section names. Use after \`list-sections\` to fetch relevant docs for the task at hand.
-
-**Example sections:** \`$state\`, \`$derived\`, \`$effect\`, \`$props\`, \`$bindable\`, \`snippets\`, \`routing\`, \`load functions\`
-
-### 3. svelte-autofixer
-
-Analyzes Svelte code and returns suggestions to fix issues. Pass the component code directly to this tool. It will detect common mistakes like:
-
-- Using \`$effect\` instead of \`$derived\` for computations
-- Missing cleanup in effects
-- Svelte 4 syntax (\`on:click\`, \`export let\`, \`<slot>\`)
-- Missing keys in \`{#each}\` blocks
-- And more
-
-## Workflow
-
-When invoked to work on a Svelte file:
-
-### 1. Gather Context (if needed)
-
-If you're uncertain about Svelte 5 syntax or patterns, use the MCP tools:
-
-1. Call \`list-sections\` to see available documentation
-2. Call \`get-documentation\` with relevant section names
-
-### 2. Read the Target File
-
-Read the file to understand the current implementation.
-
-### 3. Make Changes
-
-Apply edits following Svelte 5 best practices:
-
-### 4. Validate Changes
-
-After editing, ALWAYS call \`svelte-autofixer\` with the updated code to check for issues.
-
-### 5. Fix Any Issues
-
-If the autofixer reports problems, fix them and re-validate until no issues remain.
-
-## Output Format
-
-After completing your work, provide:
-
-1. Summary of changes made
-2. Any issues found and fixed by the autofixer
-3. Recommendations for further improvements (if any)
-`,
-					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 or the `svelte-code-writer` skill if they are available. Fetches relevant documentation and validates code using the Svelte MCP server tools.',
-					permission: {
-						bash: 'ask',
-						edit: 'allow',
-						webfetch: 'ask',
-					},
-					tools: {
-						[`${svelte_mcp_name}_*`]: true,
-					},
-				};
-
-				// Get per-agent config from svelte.json (if any)
-				const svelte_file_editor_config = mcp_config.subagent?.agents?.['svelte-file-editor'];
-
-				// Configure agent from svelte.json only
-				// Priority: svelte.json agent config > defaults
-				input.agent['svelte-file-editor'] = {
-					...default_config,
-					...(svelte_file_editor_config?.model !== undefined && {
-						model: svelte_file_editor_config.model,
-					}),
-					...(svelte_file_editor_config?.temperature !== undefined && {
-						temperature: svelte_file_editor_config.temperature,
-					}),
-					...(svelte_file_editor_config?.maxSteps !== undefined && {
-						maxSteps: svelte_file_editor_config.maxSteps,
-					}),
-					...(svelte_file_editor_config?.top_p !== undefined && {
-						top_p: svelte_file_editor_config.top_p,
-					}),
-				};
+					// Configure agent from svelte.json only
+					// Priority: svelte.json agent config > defaults
+					input.agent[agent_name] = {
+						...default_config,
+						...(agent_config?.model !== undefined && {
+							model: agent_config.model,
+						}),
+						...(agent_config?.temperature !== undefined && {
+							temperature: agent_config.temperature,
+						}),
+						...(agent_config?.maxSteps !== undefined && {
+							maxSteps: agent_config.maxSteps,
+						}),
+						...(agent_config?.top_p !== undefined && {
+							top_p: agent_config.top_p,
+						}),
+					};
+				}
 			}
 		},
 	};

packages/opencode/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sveltejs/opencode",
-	"version": "0.1.5",
+	"version": "0.1.8",
 	"type": "module",
 	"license": "MIT",
 	"homepage": "https://github.com/sveltejs/ai-tools#readme",
@@ -14,9 +14,16 @@
 	"files": [
 		"index.ts",
 		"config.ts",
+		"agents.ts",
 		"instructions",
 		"skills"
 	],
+	"exports": {
+		"./server": {
+			"types": "./index.ts",
+			"import": "./index.ts"
+		}
+	},
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/sveltejs/ai-tools.git",

packages/opencode/skills/svelte-core-bestpractices/SKILL.md

@@ -134,7 +134,7 @@ The CSS in a component's `<style>` is scoped to that component. If a parent comp
 </style>
 ```
 
-If this impossible (for example, the child component comes from a library) you can use `:global` to override styles:
+If this is impossible (for example, the child component comes from a library) you can use `:global` to override styles:
 
 ```svelte
 <div>

packages/opencode/tsconfig.json

@@ -1,5 +1,9 @@
 {
 	"extends": "../../tsconfig.json",
-	"include": ["index.ts", "config.ts", "scripts/*"],
+	"compilerOptions": {
+		"allowImportingTsExtensions": true,
+		"types": ["@types/node"]
+	},
+	"include": ["index.ts", "config.ts", "agents.ts", "scripts/*"],
 	"exclude": ["node_modules"]
 }

plugins/claude/svelte/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
 	"name": "svelte",
 	"description": "A plugin for all things related to Svelte development, MCP, skills, and more.",
-	"version": "1.0.2",
+	"version": "1.0.4",
 	"author": {
 		"name": "Svelte"
 	},

plugins/claude/svelte/agents/svelte-file-editor.md

@@ -6,7 +6,7 @@ permissionMode: acceptEdits
 
 You are a Svelte 5 expert responsible for writing, editing, and validating Svelte components and modules. You have access to the Svelte MCP server which provides documentation and code analysis tools. 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 try to solve them.
 
-If the MCP tools are not available you can use the `svelte-code-editor` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
+If the MCP tools are not available you can use the `svelte-code-writer` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
 
 If the skill is not available you can run `npx @sveltejs/mcp@latest -y --help` to learn how to use it.
 

plugins/claude/svelte/skills/svelte-core-bestpractices/SKILL.md

@@ -134,7 +134,7 @@ The CSS in a component's `<style>` is scoped to that component. If a parent comp
 </style>
 ```
 
-If this impossible (for example, the child component comes from a library) you can use `:global` to override styles:
+If this is impossible (for example, the child component comes from a library) you can use `:global` to override styles:
 
 ```svelte
 <div>

plugins/cursor/svelte/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
 	"name": "svelte",
 	"description": "A plugin for all things related to Svelte development, MCP, skills, and more.",
-	"version": "1.0.2",
+	"version": "1.0.4",
 	"author": {
 		"name": "Svelte"
 	},

plugins/cursor/svelte/agents/svelte-file-editor.md

@@ -5,7 +5,7 @@ description: Specialized Svelte 5 code editor. MUST BE USED PROACTIVELY when cre
 
 You are a Svelte 5 expert responsible for writing, editing, and validating Svelte components and modules. You have access to the Svelte MCP server which provides documentation and code analysis tools. 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 try to solve them.
 
-If the MCP tools are not available you can use the `svelte-code-editor` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
+If the MCP tools are not available you can use the `svelte-code-writer` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
 
 If the skill is not available you can run `npx @sveltejs/mcp@latest -y --help` to learn how to use it.
 

plugins/cursor/svelte/skills/svelte-core-bestpractices/SKILL.md

@@ -134,7 +134,7 @@ The CSS in a component's `<style>` is scoped to that component. If a parent comp
 </style>
 ```
 
-If this impossible (for example, the child component comes from a library) you can use `:global` to override styles:
+If this is impossible (for example, the child component comes from a library) you can use `:global` to override styles:
 
 ```svelte
 <div>

pnpm-workspace.yaml

@@ -24,10 +24,6 @@ catalogs:
     prettier-plugin-svelte: ^3.3.3
     svelte-eslint-parser: ^1.4.0
     typescript-eslint: ^8.44.0
-  orm:
-    '@libsql/client': ^0.17.0
-    drizzle-kit: ^0.31.0
-    drizzle-orm: ^0.45.0
   svelte:
     '@sveltejs/adapter-vercel': ^6.0.0
     '@sveltejs/kit': ^2.42.2
@@ -35,18 +31,18 @@ catalogs:
     svelte: ^5.47.0
     svelte-check: ^4.0.0
   tmcp:
-    '@tmcp/adapter-valibot': ^0.1.4
-    '@tmcp/transport-http': ^0.8.4
-    '@tmcp/transport-in-memory': ^0.0.5
-    '@tmcp/transport-stdio': ^0.4.0
-    tmcp: ^1.19.0
+    '@tmcp/adapter-valibot': ^0.1.5
+    '@tmcp/transport-http': ^0.8.5
+    '@tmcp/transport-in-memory': ^0.0.6
+    '@tmcp/transport-stdio': ^0.4.2
+    tmcp: ^1.19.3
   tooling:
     '@changesets/cli': ^2.29.7
     '@svitejs/changesets-changelog-github-compact': ^1.2.0
     '@types/estree': ^1.0.8
     '@types/node': ^24.3.1
     '@valibot/to-json-schema': ^1.5.0
-    '@vercel/analytics': ^1.5.0
+    '@vercel/analytics': ^2.0.0
     dotenv: ^17.2.3
     node-resolve-ts: ^1.0.2
     publint: ^0.3.13

scripts/sync-opencode-plugin.ts

@@ -37,7 +37,77 @@ async function sync_agents_md() {
 	console.log('Synced AGENTS.md to opencode package and documentation');
 }
 
+interface AgentData {
+	name: string;
+	description: string;
+	prompt: string;
+}
+
+/**
+ * Parse a markdown agent file with frontmatter (name, description) and body (prompt)
+ */
+function parse_agent_md(content: string, file_path: string): AgentData | null {
+	const frontmatter_match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+	if (!frontmatter_match) {
+		console.warn(`Skipping ${file_path}: no frontmatter found`);
+		return null;
+	}
+
+	const frontmatter = frontmatter_match[1] ?? '';
+	const body = (frontmatter_match[2] ?? '').trim();
+
+	const name = frontmatter.match(/^name:\s*(.+)$/m)?.[1]?.trim();
+	const description = frontmatter.match(/^description:\s*(.+)$/m)?.[1]?.trim();
+
+	if (!name || !description) {
+		console.warn(`Skipping ${file_path}: missing name or description in frontmatter`);
+		return null;
+	}
+
+	return { name, description, prompt: body };
+}
+
+/**
+ * Generate agents.ts module from tools/agents/*.md files
+ */
+async function sync_agents() {
+	const agents_dir = path.join(TOOLS_DIR, 'agents');
+	const entries = await fs.readdir(agents_dir, { withFileTypes: true });
+	const md_files = entries.filter((e) => e.isFile() && e.name.endsWith('.md'));
+
+	const agents: AgentData[] = [];
+
+	for (const file of md_files) {
+		const file_path = path.join(agents_dir, file.name);
+		const content = await fs.readFile(file_path, 'utf-8');
+		const agent = parse_agent_md(content, file_path);
+		if (agent) {
+			agents.push(agent);
+		}
+	}
+
+	const output = [
+		'// This file is auto-generated by scripts/sync-opencode-plugin.ts',
+		'// Do not edit manually — edit the markdown files in tools/agents/ instead.',
+		'',
+		`export const agents = ${JSON.stringify(
+			Object.fromEntries(
+				agents.map((a) => [a.name, { description: a.description, prompt: a.prompt }]),
+			),
+			null,
+			'\t',
+		)} as const;`,
+		'',
+	].join('\n');
+
+	const dest = path.join(OPENCODE_PKG_DIR, 'agents.ts');
+	await fs.writeFile(dest, output);
+
+	console.log(`Generated agents.ts with ${agents.length} agent(s)`);
+}
+
 await sync_skills();
 await sync_agents_md();
+await sync_agents();
 
 console.log('OpenCode plugin sync complete');

scripts/update-docs-prompts.ts

@@ -18,9 +18,11 @@ ${module.docs_description}
 <details>
 	<summary>Copy the prompt</summary>
 
-\`\`\`md
+<!-- prettier-ignore-start -->
+\`\`\`\`markdown
 ${await module.generate_for_docs()}
-\`\`\`
+\`\`\`\`
+<!-- prettier-ignore-end -->
 
 </details>
 

tools/agents/svelte-file-editor.md

@@ -5,7 +5,7 @@ description: Specialized Svelte 5 code editor. MUST BE USED PROACTIVELY when cre
 
 You are a Svelte 5 expert responsible for writing, editing, and validating Svelte components and modules. You have access to the Svelte MCP server which provides documentation and code analysis tools. 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 try to solve them.
 
-If the MCP tools are not available you can use the `svelte-code-editor` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
+If the MCP tools are not available you can use the `svelte-code-writer` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
 
 If the skill is not available you can run `npx @sveltejs/mcp@latest -y --help` to learn how to use it.
 

tools/skills/svelte-core-bestpractices/SKILL.md

@@ -134,7 +134,7 @@ The CSS in a component's `<style>` is scoped to that component. If a parent comp
 </style>
 ```
 
-If this impossible (for example, the child component comes from a library) you can use `:global` to override styles:
+If this is impossible (for example, the child component comes from a library) you can use `:global` to override styles:
 
 ```svelte
 <div>