@cursor/bdk 0.2.9 → 0.2.11

package/dist/internal/discovery/fs.js

@@ -1,28 +1,17 @@
 /**
  * Filesystem primitives discovery walks with: module-file detection, directory listing, and project-root markers.
  */
-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 { readdir, readFile, stat } from "node:fs/promises";
 import { extname, join } from "node:path";
 const MODULE_EXTENSIONS = new Set([".ts", ".mts", ".js", ".mjs"]);
-export function findModuleFile(dir, stem) {
-    return __awaiter(this, void 0, void 0, function* () {
-        for (const extension of [".ts", ".mts", ".js", ".mjs"]) {
-            const candidate = join(dir, `${stem}${extension}`);
-            if (yield isFile(candidate)) {
-                return candidate;
-            }
+export async function findModuleFile(dir, stem) {
+    for (const extension of [".ts", ".mts", ".js", ".mjs"]) {
+        const candidate = join(dir, `${stem}${extension}`);
+        if (await isFile(candidate)) {
+            return candidate;
         }
-        return undefined;
-    });
+    }
+    return undefined;
 }
 export function isModuleFile(fileName) {
     if (fileName.endsWith(".d.ts") || fileName.startsWith(".")) {
@@ -40,76 +29,64 @@ export function isModuleFile(fileName) {
 export function moduleStem(fileName) {
     return fileName.slice(0, -extname(fileName).length);
 }
-export function sortedEntries(dir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const entries = yield readdir(dir, { withFileTypes: true });
-        return entries.sort((a, b) => a.name.localeCompare(b.name));
-    });
+export async function sortedEntries(dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    return entries.sort((a, b) => a.name.localeCompare(b.name));
 }
-export function walkFiles(dir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const files = [];
-        for (const entry of yield sortedEntries(dir)) {
-            if (entry.name.startsWith(".")) {
-                continue;
-            }
-            const entryPath = join(dir, entry.name);
-            if (entry.isDirectory()) {
-                files.push(...(yield walkFiles(entryPath)));
-            }
-            else if (entry.isFile()) {
-                files.push(entryPath);
-            }
+export async function walkFiles(dir) {
+    const files = [];
+    for (const entry of await sortedEntries(dir)) {
+        if (entry.name.startsWith(".")) {
+            continue;
         }
-        return files;
-    });
-}
-export function isDirectory(path) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            return (yield stat(path)).isDirectory();
+        const entryPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await walkFiles(entryPath)));
         }
-        catch (_a) {
-            return false;
+        else if (entry.isFile()) {
+            files.push(entryPath);
         }
-    });
+    }
+    return files;
 }
-export function isFile(path) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            return (yield stat(path)).isFile();
-        }
-        catch (_a) {
-            return false;
-        }
-    });
+export async function isDirectory(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export async function isFile(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
 }
 export function toPosix(path) {
     return path.split("\\").join("/");
 }
-export function hasFlatLayoutMarkers(rootDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (yield isFile(join(rootDir, "instructions.md"))) {
-            return true;
-        }
-        return (yield findModuleFile(rootDir, "agent")) !== undefined;
-    });
+export async function hasFlatLayoutMarkers(rootDir) {
+    if (await isFile(join(rootDir, "instructions.md"))) {
+        return true;
+    }
+    return (await findModuleFile(rootDir, "agent")) !== undefined;
 }
-export function readPackageName(rootDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const packageJsonPath = join(rootDir, "package.json");
-        if (!(yield isFile(packageJsonPath))) {
-            return undefined;
-        }
-        try {
-            const parsed = JSON.parse(yield readFile(packageJsonPath, "utf8"));
-            if (typeof parsed.name === "string" && parsed.name !== "") {
-                return parsed.name;
-            }
-        }
-        catch (_a) {
-            // Malformed package.json falls back to the directory name.
-        }
+export async function readPackageName(rootDir) {
+    const packageJsonPath = join(rootDir, "package.json");
+    if (!(await isFile(packageJsonPath))) {
         return undefined;
-    });
+    }
+    try {
+        const parsed = JSON.parse(await readFile(packageJsonPath, "utf8"));
+        if (typeof parsed.name === "string" && parsed.name !== "") {
+            return parsed.name;
+        }
+    }
+    catch {
+        // Malformed package.json falls back to the directory name.
+    }
+    return undefined;
 }

package/dist/internal/discovery/hooks.js

@@ -1,61 +1,50 @@
 /**
  * `agent/hooks/*.ts`: observe-only event subscribers.
  */
-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 { basename, extname, relative } from "node:path";
 import { getDefinitionKind } from "../brand.js";
 import { displayPath } from "./context.js";
 import { isDirectory, isModuleFile, toPosix, walkFiles } from "./fs.js";
 import { importDefault } from "./modules.js";
-export function loadHooks(ctx, hooksDir, onDisable) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (!(yield isDirectory(hooksDir))) {
-            return [];
+export async function loadHooks(ctx, hooksDir, onDisable) {
+    if (!(await isDirectory(hooksDir))) {
+        return [];
+    }
+    const hooks = [];
+    for (const filePath of await walkFiles(hooksDir)) {
+        if (!isModuleFile(basename(filePath))) {
+            continue;
         }
-        const hooks = [];
-        for (const filePath of yield walkFiles(hooksDir)) {
-            if (!isModuleFile(basename(filePath))) {
-                continue;
-            }
-            const rel = toPosix(relative(hooksDir, filePath));
-            const name = rel.slice(0, -extname(rel).length);
-            if (name.includes("__")) {
-                ctx.diagnostics.push({
-                    severity: "error",
-                    path: displayPath(ctx, filePath),
-                    message: `Hook name "${name}" may not contain "__"; it is reserved for extension contributions (\`<ns>__<name>\`).`,
-                });
-                continue;
-            }
-            const definition = yield importDefault(ctx, filePath, onDisable === undefined ? "hook" : ["hook", "disabled"]);
-            if (definition === undefined) {
-                continue;
-            }
-            if (getDefinitionKind(definition) === "disabled") {
-                onDisable === null || onDisable === void 0 ? void 0 : onDisable(name, filePath);
-                continue;
-            }
-            const hook = definition;
-            if (typeof hook.events !== "object" ||
-                hook.events === null ||
-                Object.keys(hook.events).length === 0) {
-                ctx.diagnostics.push({
-                    severity: "warning",
-                    path: displayPath(ctx, filePath),
-                    message: "Hook declares no event handlers.",
-                });
-                continue;
-            }
-            hooks.push({ name, definition: hook });
+        const rel = toPosix(relative(hooksDir, filePath));
+        const name = rel.slice(0, -extname(rel).length);
+        if (name.includes("__")) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, filePath),
+                message: `Hook name "${name}" may not contain "__"; it is reserved for extension contributions (\`<ns>__<name>\`).`,
+            });
+            continue;
         }
-        return hooks;
-    });
+        const definition = await importDefault(ctx, filePath, onDisable === undefined ? "hook" : ["hook", "disabled"]);
+        if (definition === undefined) {
+            continue;
+        }
+        if (getDefinitionKind(definition) === "disabled") {
+            onDisable?.(name, filePath);
+            continue;
+        }
+        const hook = definition;
+        if (typeof hook.events !== "object" ||
+            hook.events === null ||
+            Object.keys(hook.events).length === 0) {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: displayPath(ctx, filePath),
+                message: "Hook declares no event handlers.",
+            });
+            continue;
+        }
+        hooks.push({ name, definition: hook });
+    }
+    return hooks;
 }

package/dist/internal/discovery/info.js

@@ -7,7 +7,6 @@ import { toolInputJsonSchema } from "../json-schema.js";
 import { MCP_ENDPOINT_PATH, mcpEndpointToolNames } from "../mcp-endpoint.js";
 import { connectionTransportLabel } from "./connections.js";
 export function projectInfo(project) {
-    var _a, _b, _c, _d;
     const agent = project.agent;
     const httpRoutes = [
         { method: "POST", path: "/v1/session", url: "/v1/session" },
@@ -67,8 +66,8 @@ export function projectInfo(project) {
             name: skill.name,
             description: skill.description,
         })),
-        extensions: (_a = agent.extensions) !== null && _a !== void 0 ? _a : [],
-        connections: agent.connections.map(connection => { var _a; return ({
+        extensions: agent.extensions ?? [],
+        connections: agent.connections.map(connection => ({
             name: connection.name,
             transport: connectionTransportLabel(connection.transport),
             advertiseTools: connection.advertiseTools,
@@ -76,8 +75,8 @@ export function projectInfo(project) {
             effects: connection.effects,
             tools: connection.tools,
             disallowedTools: connection.disallowedTools,
-            cursorAccountServers: "cursorAccount" in connection.transport ? ((_a = connection.transport.servers) !== null && _a !== void 0 ? _a : "*") : undefined,
-        }); }),
+            cursorAccountServers: "cursorAccount" in connection.transport ? (connection.transport.servers ?? "*") : undefined,
+        })),
         subagents: agent.subagents.map(subagent => ({
             name: subagent.name,
             description: subagent.description,
@@ -86,10 +85,9 @@ export function projectInfo(project) {
         channels: [
             { id: "http", routes: httpRoutes },
             ...project.channels.map(channel => {
-                var _a;
                 const info = {
                     id: channel.id,
-                    routes: ((_a = channel.definition.routes) !== null && _a !== void 0 ? _a : []).map(r => {
+                    routes: (channel.definition.routes ?? []).map(r => {
                         const routeInfo = {
                             method: r.method,
                             path: r.path,
@@ -108,31 +106,31 @@ export function projectInfo(project) {
                     }),
                 };
                 const meta = channel.definition.meta;
-                if ((meta === null || meta === void 0 ? void 0 : meta.kind) !== undefined) {
+                if (meta?.kind !== undefined) {
                     info.kind = meta.kind;
                 }
-                if ((meta === null || meta === void 0 ? void 0 : meta.githubWebhookEvents) !== undefined) {
+                if (meta?.githubWebhookEvents !== undefined) {
                     info.githubWebhookEvents = meta.githubWebhookEvents;
                 }
-                if ((meta === null || meta === void 0 ? void 0 : meta.originWebhookEvents) !== undefined) {
+                if (meta?.originWebhookEvents !== undefined) {
                     info.originWebhookEvents = meta.originWebhookEvents;
                 }
-                if ((meta === null || meta === void 0 ? void 0 : meta.gitlabWebhookEvents) !== undefined) {
+                if (meta?.gitlabWebhookEvents !== undefined) {
                     info.gitlabWebhookEvents = meta.gitlabWebhookEvents;
                 }
-                if ((meta === null || meta === void 0 ? void 0 : meta.bitbucketWebhookEvents) !== undefined) {
+                if (meta?.bitbucketWebhookEvents !== undefined) {
                     info.bitbucketWebhookEvents = meta.bitbucketWebhookEvents;
                 }
-                if ((meta === null || meta === void 0 ? void 0 : meta.deploymentEventTypes) !== undefined) {
+                if (meta?.deploymentEventTypes !== undefined) {
                     info.deploymentEventTypes = meta.deploymentEventTypes;
                 }
-                if ((meta === null || meta === void 0 ? void 0 : meta.factoryEventTypes) !== undefined) {
+                if (meta?.factoryEventTypes !== undefined) {
                     info.factoryEventTypes = meta.factoryEventTypes;
                 }
-                if ((meta === null || meta === void 0 ? void 0 : meta.slackEventTypes) !== undefined) {
+                if (meta?.slackEventTypes !== undefined) {
                     info.slackEventTypes = meta.slackEventTypes;
                 }
-                if ((meta === null || meta === void 0 ? void 0 : meta.slackChannelPosts) !== undefined) {
+                if (meta?.slackChannelPosts !== undefined) {
                     info.slackChannelPosts = meta.slackChannelPosts;
                 }
                 return info;
@@ -143,9 +141,9 @@ export function projectInfo(project) {
             cron: schedule.cron,
             kind: schedule.kind,
         })),
-        reminders: ((_b = project.reminders) !== null && _b !== void 0 ? _b : []).length === 0
+        reminders: (project.reminders ?? []).length === 0
             ? undefined
-            : ((_c = project.reminders) !== null && _c !== void 0 ? _c : []).map(reminder => ({
+            : (project.reminders ?? []).map(reminder => ({
                 name: reminder.name,
             })),
         hooks: project.hooks.map(hook => hook.name),
@@ -153,7 +151,7 @@ export function projectInfo(project) {
         artifacts: project.artifacts === undefined
             ? undefined
             : {
-                kinds: Object.keys((_d = project.artifacts.kinds) !== null && _d !== void 0 ? _d : {}),
+                kinds: Object.keys(project.artifacts.kinds ?? {}),
                 agentTool: project.artifacts.agentTool === true,
                 max: resolveArtifactsMax(project.artifacts),
             },

package/dist/internal/discovery/instructions.js

@@ -1,95 +1,82 @@
 /**
  * `agent/instructions.md` (or `.ts`, or a directory): the always-on system prompt.
  */
-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 { join } from "node:path";
 import { getDefinitionKind } from "../brand.js";
 import { displayPath, errorMessage, isBlank } from "./context.js";
 import { findModuleFile, isDirectory, isFile, isModuleFile, sortedEntries } from "./fs.js";
-export function loadInstructions(ctx, agentDir, config, isRoot) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const parts = [];
-        const markdownPath = join(agentDir, "instructions.md");
-        if (yield isFile(markdownPath)) {
-            parts.push((yield readFile(markdownPath, "utf8")).trim());
+export async function loadInstructions(ctx, agentDir, config, isRoot) {
+    const parts = [];
+    const markdownPath = join(agentDir, "instructions.md");
+    if (await isFile(markdownPath)) {
+        parts.push((await readFile(markdownPath, "utf8")).trim());
+    }
+    const modulePath = await findModuleFile(agentDir, "instructions");
+    if (modulePath !== undefined) {
+        const loaded = await loadInstructionsModule(ctx, modulePath);
+        if (loaded !== undefined) {
+            parts.push(loaded);
         }
-        const modulePath = yield findModuleFile(agentDir, "instructions");
-        if (modulePath !== undefined) {
-            const loaded = yield loadInstructionsModule(ctx, modulePath);
-            if (loaded !== undefined) {
-                parts.push(loaded);
+    }
+    const instructionsDir = join(agentDir, "instructions");
+    if (await isDirectory(instructionsDir)) {
+        for (const entry of await sortedEntries(instructionsDir)) {
+            if (!entry.isFile()) {
+                continue;
             }
-        }
-        const instructionsDir = join(agentDir, "instructions");
-        if (yield isDirectory(instructionsDir)) {
-            for (const entry of yield sortedEntries(instructionsDir)) {
-                if (!entry.isFile()) {
-                    continue;
-                }
-                const entryPath = join(instructionsDir, entry.name);
-                if (entry.name.endsWith(".md")) {
-                    parts.push((yield readFile(entryPath, "utf8")).trim());
-                }
-                else if (isModuleFile(entry.name)) {
-                    const loaded = yield loadInstructionsModule(ctx, entryPath);
-                    if (loaded !== undefined) {
-                        parts.push(loaded);
-                    }
-                }
+            const entryPath = join(instructionsDir, entry.name);
+            if (entry.name.endsWith(".md")) {
+                parts.push((await readFile(entryPath, "utf8")).trim());
             }
-        }
-        if ((config === null || config === void 0 ? void 0 : config.instructions) !== undefined && !isBlank(config.instructions)) {
-            parts.push(config.instructions.trim());
-        }
-        const combined = parts.filter(part => part !== "").join("\n\n");
-        if (combined === "") {
-            if (isRoot) {
-                ctx.diagnostics.push({
-                    severity: "error",
-                    path: displayPath(ctx, markdownPath),
-                    message: "instructions.md is required on the root agent (the always-on system prompt).",
-                });
+            else if (isModuleFile(entry.name)) {
+                const loaded = await loadInstructionsModule(ctx, entryPath);
+                if (loaded !== undefined) {
+                    parts.push(loaded);
+                }
             }
-            return undefined;
         }
-        return combined;
-    });
-}
-function loadInstructionsModule(ctx, modulePath) {
-    return __awaiter(this, void 0, void 0, function* () {
-        let mod;
-        try {
-            mod = yield ctx.importModule(modulePath);
-        }
-        catch (error) {
+    }
+    if (config?.instructions !== undefined && !isBlank(config.instructions)) {
+        parts.push(config.instructions.trim());
+    }
+    const combined = parts.filter(part => part !== "").join("\n\n");
+    if (combined === "") {
+        if (isRoot) {
             ctx.diagnostics.push({
                 severity: "error",
-                path: displayPath(ctx, modulePath),
-                message: `Failed to load module: ${errorMessage(error)}`,
+                path: displayPath(ctx, markdownPath),
+                message: "instructions.md is required on the root agent (the always-on system prompt).",
             });
-            return undefined;
-        }
-        const value = mod.default;
-        if (typeof value === "string") {
-            return value.trim();
-        }
-        if (getDefinitionKind(value) === "instructions") {
-            return value.markdown.trim();
         }
+        return undefined;
+    }
+    return combined;
+}
+async function loadInstructionsModule(ctx, modulePath) {
+    let mod;
+    try {
+        mod = await ctx.importModule(modulePath);
+    }
+    catch (error) {
         ctx.diagnostics.push({
             severity: "error",
             path: displayPath(ctx, modulePath),
-            message: "Instructions modules must default-export a string or defineInstructions({ markdown }).",
+            message: `Failed to load module: ${errorMessage(error)}`,
         });
         return undefined;
+    }
+    const value = mod.default;
+    if (typeof value === "string") {
+        return value.trim();
+    }
+    if (getDefinitionKind(value) === "instructions") {
+        return value.markdown.trim();
+    }
+    ctx.diagnostics.push({
+        severity: "error",
+        path: displayPath(ctx, modulePath),
+        message: "Instructions modules must default-export a string or defineInstructions({ markdown }).",
     });
+    return undefined;
 }

package/dist/internal/discovery/modules.js

@@ -1,83 +1,70 @@
 /**
  * Walk a slot's module files, import one, and check that its default export carries an expected definition brand.
  */
-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 { join } from "node:path";
 import { getDefinitionKind } from "../brand.js";
 import { displayPath, errorMessage } from "./context.js";
 import { isDirectory, isModuleFile, moduleStem, sortedEntries } from "./fs.js";
 import { validateName } from "./names.js";
 /** The module files of a slot directory whose filenames are valid names. */
-export function moduleEntries(ctx, dir, kind) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (!(yield isDirectory(dir))) {
-            return [];
+export async function moduleEntries(ctx, dir, kind) {
+    if (!(await isDirectory(dir))) {
+        return [];
+    }
+    const entries = [];
+    for (const entry of await sortedEntries(dir)) {
+        const path = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: displayPath(ctx, path),
+                message: `Nested ${kind} directories are not supported; ignoring.`,
+            });
+            continue;
         }
-        const entries = [];
-        for (const entry of yield sortedEntries(dir)) {
-            const path = join(dir, entry.name);
-            if (entry.isDirectory()) {
-                ctx.diagnostics.push({
-                    severity: "warning",
-                    path: displayPath(ctx, path),
-                    message: `Nested ${kind} directories are not supported; ignoring.`,
-                });
-                continue;
-            }
-            if (!entry.isFile() || !isModuleFile(entry.name)) {
-                continue;
-            }
-            const name = moduleStem(entry.name);
-            if (validateName(ctx, kind, name, path)) {
-                entries.push({ name, path });
-            }
+        if (!entry.isFile() || !isModuleFile(entry.name)) {
+            continue;
         }
-        return entries;
-    });
+        const name = moduleStem(entry.name);
+        if (validateName(ctx, kind, name, path)) {
+            entries.push({ name, path });
+        }
+    }
+    return entries;
 }
 /**
  * The module's default export when it carries one of the expected brands;
  * a diagnostic and `undefined` otherwise.
  */
-export function importDefault(ctx, modulePath, expected) {
-    return __awaiter(this, void 0, void 0, function* () {
-        let mod;
-        try {
-            mod = yield ctx.importModule(modulePath);
-        }
-        catch (error) {
-            ctx.diagnostics.push({
-                severity: "error",
-                path: displayPath(ctx, modulePath),
-                message: `Failed to load module: ${errorMessage(error)}`,
-            });
-            return undefined;
-        }
-        const kinds = typeof expected === "string" ? [expected] : expected;
-        const kind = getDefinitionKind(mod.default);
-        if (kind !== undefined && kinds.includes(kind)) {
-            return mod.default;
-        }
-        const helpers = kinds.map(helperCall).join(" or ");
-        const expectedKinds = kinds.join(" or ");
-        const article = /^[aeiou]/.test(expectedKinds) ? "an" : "a";
+export async function importDefault(ctx, modulePath, expected) {
+    let mod;
+    try {
+        mod = await ctx.importModule(modulePath);
+    }
+    catch (error) {
         ctx.diagnostics.push({
             severity: "error",
             path: displayPath(ctx, modulePath),
-            message: kind === undefined
-                ? `Module must default-export ${helpers}.`
-                : `Expected ${article} ${expectedKinds} definition but found "${kind}" (wrong authored slot?).`,
+            message: `Failed to load module: ${errorMessage(error)}`,
         });
         return undefined;
+    }
+    const kinds = typeof expected === "string" ? [expected] : expected;
+    const kind = getDefinitionKind(mod.default);
+    if (kind !== undefined && kinds.includes(kind)) {
+        return mod.default;
+    }
+    const helpers = kinds.map(helperCall).join(" or ");
+    const expectedKinds = kinds.join(" or ");
+    const article = /^[aeiou]/.test(expectedKinds) ? "an" : "a";
+    ctx.diagnostics.push({
+        severity: "error",
+        path: displayPath(ctx, modulePath),
+        message: kind === undefined
+            ? `Module must default-export ${helpers}.`
+            : `Expected ${article} ${expectedKinds} definition but found "${kind}" (wrong authored slot?).`,
     });
+    return undefined;
 }
 /** How a definition of `kind` is authored: `defineTool({ ... })`, `disableTool()`. */
 export function helperCall(kind) {

package/dist/internal/discovery/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAuB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AASpF,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAetB;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASrE;AAYD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA2BlF;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CA6BzD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAAuB,GAAG;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACtB,GACL,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAgBzD;AAcD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CA+FvB;AA0BD,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAElE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAOnE"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAuB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAapF,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAetB;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASrE;AAYD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA2BlF;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CA6BzD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAAuB,GAAG;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACtB,GACL,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAgBzD;AAcD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CA6GvB;AA0BD,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAElE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAOnE"}