@cursor/bdk 0.2.9 → 0.2.11

package/dist/internal/discovery/context.js

@@ -1,22 +1,11 @@
 /**
  * Shared discovery state: the loader options, the per-project context every loader receives, and the diagnostic helpers.
  */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 import { relative } from "node:path";
 import { pathToFileURL } from "node:url";
 import { toPosix } from "./fs.js";
-export function defaultImportModule(absolutePath) {
-    return __awaiter(this, void 0, void 0, function* () {
-        return (yield import(pathToFileURL(absolutePath).href));
-    });
+export async function defaultImportModule(absolutePath) {
+    return (await import(pathToFileURL(absolutePath).href));
 }
 export function displayPath(ctx, absolutePath) {
     const rel = relative(ctx.rootDir, absolutePath);

package/dist/internal/discovery/cursor-plugin.js

@@ -1,15 +1,6 @@
 /**
  * A Cursor plugin directory read as an extension tree: skills, commands, agents, and MCP servers under the plugin's own names.
  */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 import { readFile } from "node:fs/promises";
 import { basename, dirname, extname, isAbsolute, join } from "node:path";
 import { z } from "zod";
@@ -51,7 +42,7 @@ const manifestSchema = z.object({
     ])
         .optional()
         .transform(value => {
-        const items = value === undefined || Array.isArray(value) ? (value !== null && value !== void 0 ? value : []) : [value];
+        const items = value === undefined || Array.isArray(value) ? (value ?? []) : [value];
         return {
             paths: items.filter(item => typeof item === "string"),
             inline: items.filter(item => typeof item !== "string"),
@@ -80,248 +71,230 @@ const mcpServerSchema = z.object({
     /** Cursor disables unlisted tools; an empty list would disable them all. */
     enabledTools: z.array(z.string()).nonempty().optional(),
 });
-export function readCursorPlugin(ctx, root, mountPath, variables, overlaid) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const manifest = yield readManifest(ctx, root, mountPath);
-        if (manifest === undefined) {
-            return undefined;
-        }
-        const plugin = {
-            ctx,
-            root,
-            manifestPath: manifest.path,
-            variables,
-        };
-        const skills = yield loadPluginSkills(plugin, manifest.data.skills);
-        for (const command of yield loadPluginCommands(plugin, manifest.data.commands)) {
-            if (skills.some(skill => skill.name === command.name)) {
-                ctx.diagnostics.push({
-                    severity: "warning",
-                    path: displayPath(ctx, root),
-                    message: `Plugin command "${command.name}" has the same name as a skill; the skill wins. Ignoring the command.`,
-                });
-                continue;
-            }
-            skills.push(command);
-        }
-        yield warnUnmountedSlots(plugin, manifest.data);
-        return Object.assign(Object.assign({ description: manifest.data.description, skills }, (yield loadPluginConnections(plugin, manifest.data.mcpServers, overlaid))), { agents: yield loadPluginAgents(plugin, manifest.data.agents) });
-    });
-}
-function readManifest(ctx, root, mountPath) {
-    return __awaiter(this, void 0, void 0, function* () {
-        for (const rel of MANIFEST_PATHS) {
-            const path = join(root, rel);
-            if (!(yield isFile(path))) {
-                continue;
-            }
-            const data = yield readJson(ctx, path);
-            if (data === undefined) {
-                return undefined;
-            }
-            const parsed = manifestSchema.safeParse(data);
-            if (parsed.success) {
-                return { data: parsed.data, path };
-            }
+export async function readCursorPlugin(ctx, root, mountPath, variables, overlaid) {
+    const manifest = await readManifest(ctx, root, mountPath);
+    if (manifest === undefined) {
+        return undefined;
+    }
+    const plugin = {
+        ctx,
+        root,
+        manifestPath: manifest.path,
+        variables,
+    };
+    const skills = await loadPluginSkills(plugin, manifest.data.skills);
+    for (const command of await loadPluginCommands(plugin, manifest.data.commands)) {
+        if (skills.some(skill => skill.name === command.name)) {
             ctx.diagnostics.push({
-                severity: "error",
-                path: displayPath(ctx, path),
-                message: `The plugin manifest is malformed: ${firstIssue(parsed.error)}.`,
+                severity: "warning",
+                path: displayPath(ctx, root),
+                message: `Plugin command "${command.name}" has the same name as a skill; the skill wins. Ignoring the command.`,
             });
+            continue;
+        }
+        skills.push(command);
+    }
+    await warnUnmountedSlots(plugin, manifest.data);
+    return {
+        description: manifest.data.description,
+        skills,
+        ...(await loadPluginConnections(plugin, manifest.data.mcpServers, overlaid)),
+        agents: await loadPluginAgents(plugin, manifest.data.agents),
+    };
+}
+async function readManifest(ctx, root, mountPath) {
+    for (const rel of MANIFEST_PATHS) {
+        const path = join(root, rel);
+        if (!(await isFile(path))) {
+            continue;
+        }
+        const data = await readJson(ctx, path);
+        if (data === undefined) {
             return undefined;
         }
+        const parsed = manifestSchema.safeParse(data);
+        if (parsed.success) {
+            return { data: parsed.data, path };
+        }
         ctx.diagnostics.push({
             severity: "error",
-            path: displayPath(ctx, mountPath),
-            message: `${displayPath(ctx, root)} is not a Cursor plugin: it has no ${MANIFEST_PATHS.join(", ")}.`,
+            path: displayPath(ctx, path),
+            message: `The plugin manifest is malformed: ${firstIssue(parsed.error)}.`,
         });
         return undefined;
+    }
+    ctx.diagnostics.push({
+        severity: "error",
+        path: displayPath(ctx, mountPath),
+        message: `${displayPath(ctx, root)} is not a Cursor plugin: it has no ${MANIFEST_PATHS.join(", ")}.`,
     });
+    return undefined;
 }
 /** Slots Cursor applies through the IDE that have no agent-sdk mapping yet. */
-function warnUnmountedSlots(plugin, manifest) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const unmounted = [];
-        if (manifest.rules !== undefined || (yield isDirectory(join(plugin.root, "rules")))) {
-            unmounted.push("rules");
-        }
-        if (manifest.hooks !== undefined || (yield isFile(join(plugin.root, "hooks", "hooks.json")))) {
-            unmounted.push("hooks");
-        }
-        if (unmounted.length === 0) {
-            return;
-        }
-        plugin.ctx.diagnostics.push({
-            severity: "warning",
-            path: displayPath(plugin.ctx, plugin.root),
-            message: `Cursor plugin ${unmounted.join(" and ")} are not mounted yet; skills, commands, agents, and MCP servers are. Ignoring.`,
-        });
+async function warnUnmountedSlots(plugin, manifest) {
+    const unmounted = [];
+    if (manifest.rules !== undefined || (await isDirectory(join(plugin.root, "rules")))) {
+        unmounted.push("rules");
+    }
+    if (manifest.hooks !== undefined || (await isFile(join(plugin.root, "hooks", "hooks.json")))) {
+        unmounted.push("hooks");
+    }
+    if (unmounted.length === 0) {
+        return;
+    }
+    plugin.ctx.diagnostics.push({
+        severity: "warning",
+        path: displayPath(plugin.ctx, plugin.root),
+        message: `Cursor plugin ${unmounted.join(" and ")} are not mounted yet; skills, commands, agents, and MCP servers are. Ignoring.`,
     });
 }
-function loadPluginSkills(plugin, declared) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const dirs = [];
-        if (declared === undefined) {
-            if (yield isFile(join(plugin.root, "SKILL.md"))) {
-                dirs.push(plugin.root);
-            }
-            dirs.push(...(yield skillDirsIn(join(plugin.root, "skills"))));
+async function loadPluginSkills(plugin, declared) {
+    const dirs = [];
+    if (declared === undefined) {
+        if (await isFile(join(plugin.root, "SKILL.md"))) {
+            dirs.push(plugin.root);
         }
-        for (const path of declaredPaths(plugin, declared !== null && declared !== void 0 ? declared : [])) {
-            if (basename(path) === "SKILL.md" && (yield isFile(path))) {
-                dirs.push(dirname(path));
-            }
-            else if (yield isFile(join(path, "SKILL.md"))) {
-                dirs.push(path);
-            }
-            else {
-                dirs.push(...(yield skillDirsIn(path)));
-            }
+        dirs.push(...(await skillDirsIn(join(plugin.root, "skills"))));
+    }
+    for (const path of declaredPaths(plugin, declared ?? [])) {
+        if (basename(path) === "SKILL.md" && (await isFile(path))) {
+            dirs.push(dirname(path));
         }
-        const skills = [];
-        for (const dir of dirs) {
-            const skill = yield readSkillDir(plugin, dir);
-            if (skill !== undefined && !skills.some(s => s.name === skill.name)) {
-                skills.push(skill);
-            }
+        else if (await isFile(join(path, "SKILL.md"))) {
+            dirs.push(path);
         }
-        return skills;
-    });
+        else {
+            dirs.push(...(await skillDirsIn(path)));
+        }
+    }
+    const skills = [];
+    for (const dir of dirs) {
+        const skill = await readSkillDir(plugin, dir);
+        if (skill !== undefined && !skills.some(s => s.name === skill.name)) {
+            skills.push(skill);
+        }
+    }
+    return skills;
 }
 /** Immediate subdirectories holding a SKILL.md. */
-function skillDirsIn(dir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (!(yield isDirectory(dir))) {
-            return [];
-        }
-        const dirs = [];
-        for (const entry of yield sortedEntries(dir)) {
-            const path = join(dir, entry.name);
-            if (entry.isDirectory() && (yield isFile(join(path, "SKILL.md")))) {
-                dirs.push(path);
-            }
+async function skillDirsIn(dir) {
+    if (!(await isDirectory(dir))) {
+        return [];
+    }
+    const dirs = [];
+    for (const entry of await sortedEntries(dir)) {
+        const path = join(dir, entry.name);
+        if (entry.isDirectory() && (await isFile(join(path, "SKILL.md")))) {
+            dirs.push(path);
         }
-        return dirs;
-    });
+    }
+    return dirs;
+}
+async function readSkillDir(plugin, dir) {
+    const skillMdPath = join(dir, "SKILL.md");
+    const { data, body } = await readMarkdown(plugin, skillMdPath);
+    const name = componentName(plugin, data.name ?? basename(dir), skillMdPath);
+    if (name === undefined) {
+        return undefined;
+    }
+    return {
+        name,
+        description: skillDescription(name, data.description, body),
+        markdown: body.trim(),
+        files: await skillFiles(dir),
+    };
 }
-function readSkillDir(plugin, dir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        const skillMdPath = join(dir, "SKILL.md");
-        const { data, body } = yield readMarkdown(plugin, skillMdPath);
-        const name = componentName(plugin, (_a = data.name) !== null && _a !== void 0 ? _a : basename(dir), skillMdPath);
+async function loadPluginCommands(plugin, declared) {
+    const skills = [];
+    for (const path of await componentFiles(plugin, declared, "commands", COMMAND_EXTENSIONS)) {
+        const { data, body } = await readMarkdown(plugin, path);
+        const name = componentName(plugin, data.name ?? fileStem(path), path);
         if (name === undefined) {
-            return undefined;
+            continue;
         }
-        return {
+        skills.push({
             name,
             description: skillDescription(name, data.description, body),
             markdown: body.trim(),
-            files: yield skillFiles(dir),
-        };
-    });
+            files: {},
+        });
+    }
+    return skills;
 }
-function loadPluginCommands(plugin, declared) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        const skills = [];
-        for (const path of yield componentFiles(plugin, declared, "commands", COMMAND_EXTENSIONS)) {
-            const { data, body } = yield readMarkdown(plugin, path);
-            const name = componentName(plugin, (_a = data.name) !== null && _a !== void 0 ? _a : fileStem(path), path);
-            if (name === undefined) {
-                continue;
-            }
-            skills.push({
-                name,
-                description: skillDescription(name, data.description, body),
-                markdown: body.trim(),
-                files: {},
-            });
+async function loadPluginAgents(plugin, declared) {
+    const agents = [];
+    for (const path of await componentFiles(plugin, declared, "agents", MARKDOWN_EXTENSIONS)) {
+        const { data, body } = await readMarkdown(plugin, path);
+        const name = componentName(plugin, data.name ?? fileStem(path), path);
+        if (name === undefined || agents.some(agent => agent.name === name)) {
+            continue;
         }
-        return skills;
-    });
-}
-function loadPluginAgents(plugin, declared) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        const agents = [];
-        for (const path of yield componentFiles(plugin, declared, "agents", MARKDOWN_EXTENSIONS)) {
-            const { data, body } = yield readMarkdown(plugin, path);
-            const name = componentName(plugin, (_a = data.name) !== null && _a !== void 0 ? _a : fileStem(path), path);
-            if (name === undefined || agents.some(agent => agent.name === name)) {
-                continue;
-            }
-            if (isBlank(body)) {
-                plugin.ctx.diagnostics.push({
-                    severity: "warning",
-                    path: displayPath(plugin.ctx, path),
-                    message: "Plugin agent has no prompt body; ignoring.",
-                });
-                continue;
-            }
-            agents.push({
-                name,
-                description: data.description,
-                model: data.model === "inherit" ? undefined : data.model,
-                prompt: body.trim(),
+        if (isBlank(body)) {
+            plugin.ctx.diagnostics.push({
+                severity: "warning",
+                path: displayPath(plugin.ctx, path),
+                message: "Plugin agent has no prompt body; ignoring.",
             });
+            continue;
         }
-        return agents;
-    });
+        agents.push({
+            name,
+            description: data.description,
+            model: data.model === "inherit" ? undefined : data.model,
+            prompt: body.trim(),
+        });
+    }
+    return agents;
 }
 /**
  * The plugin's MCP servers as connections. A server the mount overlays is
  * reported by name and never compiled, so its placeholders need no values.
  */
-function loadPluginConnections(plugin, declared, overlaid) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const servers = new Map();
-        for (const file of MCP_CONFIG_FILES) {
-            const path = join(plugin.root, file);
-            if (!(yield isFile(path))) {
-                continue;
-            }
-            for (const [name, raw] of Object.entries(yield readMcpFile(plugin, path))) {
-                if (!servers.has(name)) {
-                    servers.set(name, { raw, path });
-                }
-            }
+async function loadPluginConnections(plugin, declared, overlaid) {
+    const servers = new Map();
+    for (const file of MCP_CONFIG_FILES) {
+        const path = join(plugin.root, file);
+        if (!(await isFile(path))) {
+            continue;
         }
-        // The manifest's own `mcpServers` wins on a name both declare.
-        for (const path of declaredPaths(plugin, declared.paths)) {
-            for (const [name, raw] of Object.entries(yield readMcpFile(plugin, path))) {
+        for (const [name, raw] of Object.entries(await readMcpFile(plugin, path))) {
+            if (!servers.has(name)) {
                 servers.set(name, { raw, path });
             }
         }
-        for (const inline of declared.inline) {
-            for (const [name, raw] of Object.entries(mcpServersOf(inline))) {
-                servers.set(name, { raw, path: plugin.manifestPath });
-            }
+    }
+    // The manifest's own `mcpServers` wins on a name both declare.
+    for (const path of declaredPaths(plugin, declared.paths)) {
+        for (const [name, raw] of Object.entries(await readMcpFile(plugin, path))) {
+            servers.set(name, { raw, path });
         }
-        const connections = [];
-        const overlaidServers = [];
-        for (const [rawName, { raw, path }] of servers) {
-            const name = componentName(plugin, rawName, path);
-            if (name === undefined) {
-                continue;
-            }
-            if (overlaid.has(name)) {
-                overlaidServers.push(name);
-                continue;
-            }
-            const connection = serverConnection(plugin, name, raw, path);
-            if (connection !== undefined) {
-                connections.push(connection);
-            }
+    }
+    for (const inline of declared.inline) {
+        for (const [name, raw] of Object.entries(mcpServersOf(inline))) {
+            servers.set(name, { raw, path: plugin.manifestPath });
         }
-        return { connections, overlaidServers };
-    });
+    }
+    const connections = [];
+    const overlaidServers = [];
+    for (const [rawName, { raw, path }] of servers) {
+        const name = componentName(plugin, rawName, path);
+        if (name === undefined) {
+            continue;
+        }
+        if (overlaid.has(name)) {
+            overlaidServers.push(name);
+            continue;
+        }
+        const connection = serverConnection(plugin, name, raw, path);
+        if (connection !== undefined) {
+            connections.push(connection);
+        }
+    }
+    return { connections, overlaidServers };
 }
-function readMcpFile(plugin, path) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const data = yield readJson(plugin.ctx, path);
-        return isRecord(data) ? mcpServersOf(data) : {};
-    });
+async function readMcpFile(plugin, path) {
+    const data = await readJson(plugin.ctx, path);
+    return isRecord(data) ? mcpServersOf(data) : {};
 }
 /** `{ mcpServers: { ... } }`, or a bare map of server-like entries. */
 function mcpServersOf(data) {
@@ -339,11 +312,10 @@ function mcpServersOf(data) {
 function serverConnection(plugin, name, raw, path) {
     const unresolved = new Set();
     const expanded = expandPlaceholders(raw, key => {
-        var _a;
         if (PLUGIN_ROOT_VARIABLES.has(key)) {
             return plugin.root;
         }
-        return (_a = lookupVariable(plugin.variables, key)) !== null && _a !== void 0 ? _a : process.env[key];
+        return lookupVariable(plugin.variables, key) ?? process.env[key];
     }, unresolved);
     if (unresolved.size > 0) {
         plugin.ctx.diagnostics.push({
@@ -413,9 +385,8 @@ function serverTransport(plugin, name, server, path) {
 function expandPlaceholders(value, lookup, unresolved) {
     if (typeof value === "string") {
         return value.replace(PLACEHOLDER, (match, envKey, key, fallback) => {
-            var _a, _b;
-            const name = (_a = envKey !== null && envKey !== void 0 ? envKey : key) !== null && _a !== void 0 ? _a : "";
-            const resolved = (_b = lookup(name)) !== null && _b !== void 0 ? _b : fallback;
+            const name = envKey ?? key ?? "";
+            const resolved = lookup(name) ?? fallback;
             if (resolved === undefined) {
                 unresolved.add(name);
                 return match;
@@ -441,31 +412,28 @@ function expandPlaceholders(value, lookup, unresolved) {
  * declared variable is `DD_SITE`.
  */
 function lookupVariable(variables, key) {
-    var _a;
     if (variables[key] !== undefined) {
         return variables[key];
     }
     const lower = key.toLowerCase();
-    return (_a = Object.entries(variables).find(([name]) => name.toLowerCase() === lower)) === null || _a === void 0 ? void 0 : _a[1];
+    return Object.entries(variables).find(([name]) => name.toLowerCase() === lower)?.[1];
 }
 /**
  * Files a component slot resolves to: the manifest's declaration (files and
  * directories, walked) or the conventional folder.
  */
-function componentFiles(plugin, declared, folder, extensions) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const roots = declared === undefined ? [join(plugin.root, folder)] : declaredPaths(plugin, declared);
-        const files = [];
-        for (const path of roots) {
-            if (yield isDirectory(path)) {
-                files.push(...(yield walkFiles(path)));
-            }
-            else if (yield isFile(path)) {
-                files.push(path);
-            }
+async function componentFiles(plugin, declared, folder, extensions) {
+    const roots = declared === undefined ? [join(plugin.root, folder)] : declaredPaths(plugin, declared);
+    const files = [];
+    for (const path of roots) {
+        if (await isDirectory(path)) {
+            files.push(...(await walkFiles(path)));
         }
-        return files.filter(file => extensions.has(extname(file)));
-    });
+        else if (await isFile(path)) {
+            files.push(path);
+        }
+    }
+    return files.filter(file => extensions.has(extname(file)));
 }
 /** Manifest paths resolve against the plugin root; escaping ones are refused, as in Cursor. */
 function declaredPaths(plugin, declared) {
@@ -484,36 +452,32 @@ function declaredPaths(plugin, declared) {
     }
     return paths;
 }
-function readJson(ctx, path) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            return JSON.parse(yield readFile(path, "utf8"));
-        }
-        catch (error) {
-            ctx.diagnostics.push({
-                severity: "error",
-                path: displayPath(ctx, path),
-                message: `Failed to parse ${basename(path)}: ${errorMessage(error)}`,
-            });
-            return undefined;
-        }
-    });
+async function readJson(ctx, path) {
+    try {
+        return JSON.parse(await readFile(path, "utf8"));
+    }
+    catch (error) {
+        ctx.diagnostics.push({
+            severity: "error",
+            path: displayPath(ctx, path),
+            message: `Failed to parse ${basename(path)}: ${errorMessage(error)}`,
+        });
+        return undefined;
+    }
 }
 /** Frontmatter the reader understands; a malformed block warns and reads as empty. */
-function readMarkdown(plugin, path) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const { data, body, error } = parseYamlFrontmatter(yield readFile(path, "utf8"));
-        const parsed = frontmatterSchema.safeParse(data);
-        const problem = error !== null && error !== void 0 ? error : (parsed.success ? undefined : firstIssue(parsed.error));
-        if (problem !== undefined) {
-            plugin.ctx.diagnostics.push({
-                severity: "warning",
-                path: displayPath(plugin.ctx, path),
-                message: `Frontmatter is malformed (${problem}); using the file name and body.`,
-            });
-        }
-        return { data: parsed.success ? parsed.data : {}, body };
-    });
+async function readMarkdown(plugin, path) {
+    const { data, body, error } = parseYamlFrontmatter(await readFile(path, "utf8"));
+    const parsed = frontmatterSchema.safeParse(data);
+    const problem = error ?? (parsed.success ? undefined : firstIssue(parsed.error));
+    if (problem !== undefined) {
+        plugin.ctx.diagnostics.push({
+            severity: "warning",
+            path: displayPath(plugin.ctx, path),
+            message: `Frontmatter is malformed (${problem}); using the file name and body.`,
+        });
+    }
+    return { data: parsed.success ? parsed.data : {}, body };
 }
 /**
  * Cursor lowercases and hyphenates component names; `_` and `.` fold to `-`