@cursor/bdk 0.2.8 → 0.2.10

package/dist/internal/discovery/project.js

@@ -1,28 +1,9 @@
 /**
  * Project roots and mounts: find agents under a directory and load them into {@link AgentProject} manifests.
  */
-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());
-    });
-};
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
 import { basename, join, resolve } from "node:path";
 import { registerAuthoredModuleLoaders } from "../authored-loaders.js";
+import { channelArchitectureError, channelArchitectureMigrationWarning, } from "../channel-architecture.js";
 import { applyAgentContinuationDefaults, warnOmittedContinuationDowngrades, } from "../continuation-channel.js";
 import { httpChannel } from "../http-channel-define.js";
 import { loadAgent, warnUnknownSlots } from "./agent.js";
@@ -39,62 +20,56 @@ import { appendArtifactTool, loadArtifacts, loadOtel, loadStorage, mergeArtifact
  * directory, a compatible `agent/` directory, or flat-layout markers
  * (`agent.ts` / `instructions.md`) directly inside it.
  */
-export function isAgentProjectDir(dir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const resolved = resolve(dir);
-        if (!(yield isDirectory(resolved))) {
-            return false;
-        }
-        if ((yield nestedProjectDir(resolved)) !== undefined) {
-            return true;
-        }
-        return hasFlatLayoutMarkers(resolved);
-    });
+export async function isAgentProjectDir(dir) {
+    const resolved = resolve(dir);
+    if (!(await isDirectory(resolved))) {
+        return false;
+    }
+    if ((await nestedProjectDir(resolved)) !== undefined) {
+        return true;
+    }
+    return hasFlatLayoutMarkers(resolved);
 }
-function nestedProjectDir(rootDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        for (const name of ["bot", "agent"]) {
-            const candidate = join(rootDir, name);
-            if (yield isDirectory(candidate)) {
-                return candidate;
-            }
+async function nestedProjectDir(rootDir) {
+    for (const name of ["bot", "agent"]) {
+        const candidate = join(rootDir, name);
+        if (await isDirectory(candidate)) {
+            return candidate;
         }
-        return undefined;
-    });
+    }
+    return undefined;
 }
 /**
  * List agent projects directly under `rootDir` (one level deep) without
  * loading them. Empty when the path is missing or has no child agents.
  * Slug rules match {@link loadAgentProjects} / multi-agent serve.
  */
-export function listChildAgentDirs(rootDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const resolved = resolve(rootDir);
-        if (!(yield isDirectory(resolved))) {
-            return [];
+export async function listChildAgentDirs(rootDir) {
+    const resolved = resolve(rootDir);
+    if (!(await isDirectory(resolved))) {
+        return [];
+    }
+    const results = [];
+    const seenSlugs = new Set();
+    for (const entry of await sortedEntries(resolved)) {
+        if (!entry.isDirectory() || entry.name.startsWith(".")) {
+            continue;
         }
-        const results = [];
-        const seenSlugs = new Set();
-        for (const entry of yield sortedEntries(resolved)) {
-            if (!entry.isDirectory() || entry.name.startsWith(".")) {
-                continue;
-            }
-            if (entry.name === "node_modules") {
-                continue;
-            }
-            const childDir = join(resolved, entry.name);
-            if (!(yield isAgentProjectDir(childDir))) {
-                continue;
-            }
-            const slug = assertSlug(entry.name, resolved);
-            if (seenSlugs.has(slug)) {
-                throw new Error(`Duplicate agent slug "${slug}" under ${resolved}.`);
-            }
-            seenSlugs.add(slug);
-            results.push({ slug, dir: childDir });
+        if (entry.name === "node_modules") {
+            continue;
         }
-        return results;
-    });
+        const childDir = join(resolved, entry.name);
+        if (!(await isAgentProjectDir(childDir))) {
+            continue;
+        }
+        const slug = assertSlug(entry.name, resolved);
+        if (seenSlugs.has(slug)) {
+            throw new Error(`Duplicate agent slug "${slug}" under ${resolved}.`);
+        }
+        seenSlugs.add(slug);
+        results.push({ slug, dir: childDir });
+    }
+    return results;
 }
 /**
  * Discover the agent projects directly under `rootDir` (one level deep):
@@ -103,32 +78,30 @@ export function listChildAgentDirs(rootDir) {
  * multi-agent serving, where one server hosts many agents under
  * `/<slug>/...`. Throws when no child projects are found.
  */
-export function loadAgentProjects(rootDir_1) {
-    return __awaiter(this, arguments, void 0, function* (rootDir, options = {}) {
-        const resolved = resolve(rootDir);
-        if (!(yield isDirectory(resolved))) {
-            throw new Error(`Agent projects directory does not exist: ${resolved}`);
-        }
-        const children = yield listChildAgentDirs(resolved);
-        if (children.length === 0) {
-            throw new Error(`No agent projects found directly under ${resolved}. Each agent should be a subdirectory with its own bot/ directory (or flat-layout markers).`);
-        }
-        const results = [];
-        // Storage namespaces (session mirror, host kv) key on the project
-        // NAME, not the mount slug — two co-hosted agents sharing a name would
-        // silently share sessions and KV state.
-        const slugByName = new Map();
-        for (const child of children) {
-            const project = yield loadAgentProject(child.dir, options);
-            const priorSlug = slugByName.get(project.name);
-            if (priorSlug !== undefined) {
-                throw new Error(`Duplicate agent name "${project.name}" under ${resolved}: agents "${priorSlug}" and "${child.slug}" both resolve to it (package.json "name", or the directory name when unset). Co-hosted agents must have distinct names — their storage and session namespaces key on the name.`);
-            }
-            slugByName.set(project.name, child.slug);
-            results.push({ slug: child.slug, project });
+export async function loadAgentProjects(rootDir, options = {}) {
+    const resolved = resolve(rootDir);
+    if (!(await isDirectory(resolved))) {
+        throw new Error(`Agent projects directory does not exist: ${resolved}`);
+    }
+    const children = await listChildAgentDirs(resolved);
+    if (children.length === 0) {
+        throw new Error(`No agent projects found directly under ${resolved}. Each agent should be a subdirectory with its own bot/ directory (or flat-layout markers).`);
+    }
+    const results = [];
+    // Storage namespaces (session mirror, host kv) key on the project
+    // NAME, not the mount slug — two co-hosted agents sharing a name would
+    // silently share sessions and KV state.
+    const slugByName = new Map();
+    for (const child of children) {
+        const project = await loadAgentProject(child.dir, options);
+        const priorSlug = slugByName.get(project.name);
+        if (priorSlug !== undefined) {
+            throw new Error(`Duplicate agent name "${project.name}" under ${resolved}: agents "${priorSlug}" and "${child.slug}" both resolve to it (package.json "name", or the directory name when unset). Co-hosted agents must have distinct names — their storage and session namespaces key on the name.`);
         }
-        return results;
-    });
+        slugByName.set(project.name, child.slug);
+        results.push({ slug: child.slug, project });
+    }
+    return results;
 }
 /**
  * Resolve mounts for `serve` / CLI. Defaults to multi-agent layout:
@@ -137,24 +110,22 @@ export function loadAgentProjects(rootDir_1) {
  *   `/<dirname>/...`.
  * - otherwise, every immediate child agent project under `/<slug>/...`.
  */
-export function resolveAgentMounts(rootDir_1) {
-    return __awaiter(this, arguments, void 0, function* (rootDir, options = {}) {
-        const { mode = "multi" } = options, discovery = __rest(options, ["mode"]);
-        if (mode === "single") {
-            return [{ slug: "", project: yield loadAgentProject(rootDir, discovery) }];
-        }
-        if (yield isAgentProjectDir(rootDir)) {
-            const resolved = resolve(rootDir);
-            const slug = assertSlug(basename(resolved), resolved);
-            return [
-                {
-                    slug,
-                    project: yield loadAgentProject(rootDir, discovery),
-                },
-            ];
-        }
-        return loadAgentProjects(rootDir, discovery);
-    });
+export async function resolveAgentMounts(rootDir, options = {}) {
+    const { mode = "multi", ...discovery } = options;
+    if (mode === "single") {
+        return [{ slug: "", project: await loadAgentProject(rootDir, discovery) }];
+    }
+    if (await isAgentProjectDir(rootDir)) {
+        const resolved = resolve(rootDir);
+        const slug = assertSlug(basename(resolved), resolved);
+        return [
+            {
+                slug,
+                project: await loadAgentProject(rootDir, discovery),
+            },
+        ];
+    }
+    return loadAgentProjects(rootDir, discovery);
 }
 function assertSlug(name, parentDir) {
     if (!NAME_PATTERN.test(name) || RESERVED_SLUGS.has(name)) {
@@ -164,118 +135,124 @@ function assertSlug(name, parentDir) {
 }
 /** URL path segments reserved by the server; agents cannot use them as slugs. */
 const RESERVED_SLUGS = new Set(["v1", "playground", "docs"]);
-export function loadAgentProject(dir_1) {
-    return __awaiter(this, arguments, void 0, function* (dir, options = {}) {
-        var _a, _b;
-        // Public API: embedders can call discovery directly (without `serve()` or
-        // the CLI), and it dynamically imports authored TypeScript.
-        yield registerAuthoredModuleLoaders();
-        const rootDir = resolve(dir);
-        if (!(yield isDirectory(rootDir))) {
-            throw new Error(`Agent project directory does not exist: ${rootDir}`);
-        }
-        const nestedAgentDir = yield nestedProjectDir(rootDir);
-        let agentDir;
-        if (nestedAgentDir !== undefined) {
-            agentDir = nestedAgentDir;
-        }
-        else if (yield hasFlatLayoutMarkers(rootDir)) {
-            agentDir = rootDir;
-        }
-        else {
-            throw new Error(`No agent found under ${rootDir}: expected a bot/ directory (or a flat layout with agent.ts / instructions.md at the root)`);
+export async function loadAgentProject(dir, options = {}) {
+    // Public API: embedders can call discovery directly (without `serve()` or
+    // the CLI), and it dynamically imports authored TypeScript.
+    await registerAuthoredModuleLoaders();
+    const rootDir = resolve(dir);
+    if (!(await isDirectory(rootDir))) {
+        throw new Error(`Agent project directory does not exist: ${rootDir}`);
+    }
+    const nestedAgentDir = await nestedProjectDir(rootDir);
+    let agentDir;
+    if (nestedAgentDir !== undefined) {
+        agentDir = nestedAgentDir;
+    }
+    else if (await hasFlatLayoutMarkers(rootDir)) {
+        agentDir = rootDir;
+    }
+    else {
+        throw new Error(`No agent found under ${rootDir}: expected a bot/ directory (or a flat layout with agent.ts / instructions.md at the root)`);
+    }
+    const diagnostics = [];
+    const ctx = {
+        rootDir,
+        diagnostics,
+        importModule: options.importModule ?? defaultImportModule,
+    };
+    const name = (await readPackageName(rootDir)) ?? basename(rootDir);
+    const { agent, projectSlots } = await loadAgent(ctx, agentDir, {
+        name,
+        isRoot: true,
+    });
+    const { channels, httpChannelDefinition } = await loadChannels(ctx, join(agentDir, "channels"));
+    for (const channel of projectSlots.channels) {
+        if (channel.id === "http" || channels.some(c => c.id === channel.id)) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, join(agentDir, "extensions")),
+                message: `Extension channel "${channel.id}" collides with an agent channel.`,
+            });
+            continue;
         }
-        const diagnostics = [];
-        const ctx = {
-            rootDir,
-            diagnostics,
-            importModule: (_a = options.importModule) !== null && _a !== void 0 ? _a : defaultImportModule,
-        };
-        const name = (_b = (yield readPackageName(rootDir))) !== null && _b !== void 0 ? _b : basename(rootDir);
-        const { agent, projectSlots } = yield loadAgent(ctx, agentDir, {
-            name,
-            isRoot: true,
-        });
-        const { channels, httpChannelDefinition } = yield loadChannels(ctx, join(agentDir, "channels"));
-        for (const channel of projectSlots.channels) {
-            if (channel.id === "http" || channels.some(c => c.id === channel.id)) {
-                ctx.diagnostics.push({
-                    severity: "error",
-                    path: displayPath(ctx, join(agentDir, "extensions")),
-                    message: `Extension channel "${channel.id}" collides with an agent channel.`,
-                });
-                continue;
-            }
-            channels.push(channel);
+        channels.push(channel);
+    }
+    const schedules = await loadSchedules(ctx, join(agentDir, "schedules"));
+    schedules.push(...projectSlots.schedules);
+    const reminders = await loadReminders(ctx, join(agentDir, "reminders"));
+    reminders.push(...projectSlots.reminders);
+    const hooks = await loadHooks(ctx, join(agentDir, "hooks"));
+    hooks.push(...projectSlots.hooks);
+    const storage = await loadStorage(ctx, agentDir, agent.architecture);
+    const artifacts = await mergeProjectArtifacts(ctx, agentDir, projectSlots.artifacts);
+    const otel = await loadOtel(ctx, agentDir);
+    await rejectLegacyResult(ctx, agentDir);
+    await appendArtifactTool(ctx, agentDir, agent, artifacts);
+    if (agentDir !== rootDir) {
+        await warnUnknownSlots(ctx, agentDir);
+    }
+    const resolvedHttpChannel = httpChannelDefinition ?? httpChannel();
+    for (const channel of channels) {
+        const channelPath = displayPath(ctx, join(agentDir, "channels", `${channel.id}.ts`));
+        const architectureError = channelArchitectureError(agent.architecture, channel.definition);
+        if (architectureError !== undefined) {
+            ctx.diagnostics.push({ severity: "error", path: channelPath, message: architectureError });
         }
-        const schedules = yield loadSchedules(ctx, join(agentDir, "schedules"));
-        schedules.push(...projectSlots.schedules);
-        const reminders = yield loadReminders(ctx, join(agentDir, "reminders"));
-        reminders.push(...projectSlots.reminders);
-        const hooks = yield loadHooks(ctx, join(agentDir, "hooks"));
-        hooks.push(...projectSlots.hooks);
-        const storage = yield loadStorage(ctx, agentDir, agent.architecture);
-        const artifacts = yield mergeProjectArtifacts(ctx, agentDir, projectSlots.artifacts);
-        const otel = yield loadOtel(ctx, agentDir);
-        yield rejectLegacyResult(ctx, agentDir);
-        yield appendArtifactTool(ctx, agentDir, agent, artifacts);
-        if (agentDir !== rootDir) {
-            yield warnUnknownSlots(ctx, agentDir);
+        const migrationWarning = channelArchitectureMigrationWarning(agent.architecture, channel.definition);
+        if (migrationWarning !== undefined) {
+            ctx.diagnostics.push({ severity: "warning", path: channelPath, message: migrationWarning });
         }
-        const resolvedHttpChannel = httpChannelDefinition !== null && httpChannelDefinition !== void 0 ? httpChannelDefinition : httpChannel();
-        warnOmittedContinuationDowngrades({
-            architecture: agent.architecture,
-            channels,
-            warn: (id, message) => {
-                ctx.diagnostics.push({
-                    severity: "warning",
-                    path: displayPath(ctx, join(agentDir, "channels", `${id}.ts`)),
-                    message,
-                });
-            },
-        });
-        applyAgentContinuationDefaults({
-            agent,
-            channels,
-            httpChannel: resolvedHttpChannel,
-        });
-        return {
-            rootDir,
-            agentDir,
-            name: agent.name,
-            agent,
-            httpChannel: resolvedHttpChannel,
-            channels,
-            schedules,
-            reminders,
-            hooks,
-            storage,
-            artifacts,
-            otel,
-            diagnostics,
-        };
+    }
+    warnOmittedContinuationDowngrades({
+        architecture: agent.architecture,
+        channels,
+        warn: (id, message) => {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: displayPath(ctx, join(agentDir, "channels", `${id}.ts`)),
+                message,
+            });
+        },
     });
+    applyAgentContinuationDefaults({
+        agent,
+        channels,
+        httpChannel: resolvedHttpChannel,
+    });
+    return {
+        rootDir,
+        agentDir,
+        name: agent.name,
+        agent,
+        httpChannel: resolvedHttpChannel,
+        channels,
+        schedules,
+        reminders,
+        hooks,
+        storage,
+        artifacts,
+        otel,
+        diagnostics,
+    };
 }
-function mergeProjectArtifacts(ctx, agentDir, extra) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const agent = yield loadArtifacts(ctx, agentDir);
-        if (extra === undefined) {
-            return agent;
-        }
-        const kinds = Object.assign({}, extra.kinds);
-        const agentKinds = agent === null || agent === void 0 ? void 0 : agent.kinds;
-        for (const kind of Object.keys(kinds)) {
-            if (agentKinds !== undefined && kind in agentKinds) {
-                ctx.diagnostics.push({
-                    severity: "error",
-                    path: displayPath(ctx, join(agentDir, "extensions")),
-                    message: `Extension artifact kind "${kind}" collides with an agent kind.`,
-                });
-                delete kinds[kind];
-            }
+async function mergeProjectArtifacts(ctx, agentDir, extra) {
+    const agent = await loadArtifacts(ctx, agentDir);
+    if (extra === undefined) {
+        return agent;
+    }
+    const kinds = { ...extra.kinds };
+    const agentKinds = agent?.kinds;
+    for (const kind of Object.keys(kinds)) {
+        if (agentKinds !== undefined && kind in agentKinds) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, join(agentDir, "extensions")),
+                message: `Extension artifact kind "${kind}" collides with an agent kind.`,
+            });
+            delete kinds[kind];
         }
-        return mergeArtifacts(agent, Object.assign(Object.assign({}, extra), { kinds }));
-    });
+    }
+    return mergeArtifacts(agent, { ...extra, kinds });
 }
 /** True when the project has diagnostics that must block serving. */
 export function hasErrorDiagnostics(project) {

package/dist/internal/discovery/reminders.js

@@ -1,65 +1,54 @@
 /**
  * `agent/reminders/*.ts`: named durable reminder fire handlers.
  */
-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";
 import { NAME_PATTERN } from "./names.js";
-export function loadReminders(ctx, remindersDir, onDisable) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (!(yield isDirectory(remindersDir))) {
-            return [];
+export async function loadReminders(ctx, remindersDir, onDisable) {
+    if (!(await isDirectory(remindersDir))) {
+        return [];
+    }
+    const reminders = [];
+    for (const filePath of await walkFiles(remindersDir)) {
+        const rel = toPosix(relative(remindersDir, filePath));
+        if (!isModuleFile(basename(filePath))) {
+            continue;
         }
-        const reminders = [];
-        for (const filePath of yield walkFiles(remindersDir)) {
-            const rel = toPosix(relative(remindersDir, filePath));
-            if (!isModuleFile(basename(filePath))) {
-                continue;
-            }
-            const name = rel.slice(0, -extname(rel).length);
-            if (!NAME_PATTERN.test(name) || name.includes("__")) {
-                ctx.diagnostics.push({
-                    severity: "error",
-                    path: displayPath(ctx, filePath),
-                    message: name.includes("__")
-                        ? `Reminder name "${name}" may not contain "__"; it is reserved for extension contributions (\`<ns>__<name>\`).`
-                        : `Reminder name "${name}" must match ${NAME_PATTERN}.`,
-                });
-                continue;
-            }
-            const definition = yield importDefault(ctx, filePath, onDisable === undefined ? "reminder" : ["reminder", "disabled"]);
-            if (definition === undefined) {
-                continue;
-            }
-            if (getDefinitionKind(definition) === "disabled") {
-                onDisable === null || onDisable === void 0 ? void 0 : onDisable(name, filePath);
-                continue;
-            }
-            const reminder = definition;
-            if (typeof reminder.run !== "function") {
-                ctx.diagnostics.push({
-                    severity: "error",
-                    path: displayPath(ctx, filePath),
-                    message: "Reminder handlers require a `run` function.",
-                });
-                continue;
-            }
-            reminders.push({
-                name,
-                definition: reminder,
+        const name = rel.slice(0, -extname(rel).length);
+        if (!NAME_PATTERN.test(name) || name.includes("__")) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, filePath),
+                message: name.includes("__")
+                    ? `Reminder name "${name}" may not contain "__"; it is reserved for extension contributions (\`<ns>__<name>\`).`
+                    : `Reminder name "${name}" must match ${NAME_PATTERN}.`,
             });
+            continue;
         }
-        return reminders;
-    });
+        const definition = await importDefault(ctx, filePath, onDisable === undefined ? "reminder" : ["reminder", "disabled"]);
+        if (definition === undefined) {
+            continue;
+        }
+        if (getDefinitionKind(definition) === "disabled") {
+            onDisable?.(name, filePath);
+            continue;
+        }
+        const reminder = definition;
+        if (typeof reminder.run !== "function") {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, filePath),
+                message: "Reminder handlers require a `run` function.",
+            });
+            continue;
+        }
+        reminders.push({
+            name,
+            definition: reminder,
+        });
+    }
+    return reminders;
 }

package/dist/internal/discovery/runtime.js

@@ -13,7 +13,7 @@ export function resolveRuntime(ctx, agentDir, runtime) {
         runtime === "local" ||
         runtime === "cloud" ||
         runtime === "grokbot") {
-        return runtime !== null && runtime !== void 0 ? runtime : "local";
+        return runtime ?? "local";
     }
     ctx.diagnostics.push({
         severity: "error",