@cursor/bdk 0.2.9 → 0.2.11

package/dist/internal/discovery/schedules.js

@@ -1,15 +1,6 @@
 /**
  * `agent/schedules/*.ts`: cron-driven runs.
  */
-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, extname, relative } from "node:path";
 import { getDefinitionKind } from "../brand.js";
@@ -18,61 +9,15 @@ import { parseFrontmatter } from "../frontmatter.js";
 import { displayPath } from "./context.js";
 import { isDirectory, isModuleFile, toPosix, walkFiles } from "./fs.js";
 import { importDefault } from "./modules.js";
-export function loadSchedules(ctx, schedulesDir, onDisable) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (!(yield isDirectory(schedulesDir))) {
-            return [];
-        }
-        const schedules = [];
-        for (const filePath of yield walkFiles(schedulesDir)) {
-            const rel = toPosix(relative(schedulesDir, filePath));
-            if (rel.endsWith(".md")) {
-                const name = rel.slice(0, -".md".length);
-                if (name.includes("__")) {
-                    ctx.diagnostics.push({
-                        severity: "error",
-                        path: displayPath(ctx, filePath),
-                        message: `Schedule name "${name}" may not contain "__"; it is reserved for extension contributions (\`<ns>__<name>\`).`,
-                    });
-                    continue;
-                }
-                const { data, body } = parseFrontmatter(yield readFile(filePath, "utf8"));
-                const cron = data.cron;
-                if (cron === undefined || !isValidCron(cron)) {
-                    ctx.diagnostics.push({
-                        severity: "error",
-                        path: displayPath(ctx, filePath),
-                        message: cron === undefined
-                            ? "Markdown schedules require `cron` frontmatter."
-                            : `Invalid cron expression: "${cron}".`,
-                    });
-                    continue;
-                }
-                const markdown = body.trim();
-                if (markdown === "") {
-                    ctx.diagnostics.push({
-                        severity: "error",
-                        path: displayPath(ctx, filePath),
-                        message: "Markdown schedules require a non-empty prompt body.",
-                    });
-                    continue;
-                }
-                schedules.push({
-                    name,
-                    cron,
-                    kind: "markdown",
-                    definition: {
-                        __agentServe: "schedule",
-                        cron,
-                        markdown,
-                    },
-                });
-                continue;
-            }
-            if (!isModuleFile(basename(filePath))) {
-                continue;
-            }
-            const name = rel.slice(0, -extname(rel).length);
+export async function loadSchedules(ctx, schedulesDir, onDisable) {
+    if (!(await isDirectory(schedulesDir))) {
+        return [];
+    }
+    const schedules = [];
+    for (const filePath of await walkFiles(schedulesDir)) {
+        const rel = toPosix(relative(schedulesDir, filePath));
+        if (rel.endsWith(".md")) {
+            const name = rel.slice(0, -".md".length);
             if (name.includes("__")) {
                 ctx.diagnostics.push({
                     severity: "error",
@@ -81,38 +26,82 @@ export function loadSchedules(ctx, schedulesDir, onDisable) {
                 });
                 continue;
             }
-            const definition = yield importDefault(ctx, filePath, onDisable === undefined ? "schedule" : ["schedule", "disabled"]);
-            if (definition === undefined) {
-                continue;
-            }
-            if (getDefinitionKind(definition) === "disabled") {
-                onDisable === null || onDisable === void 0 ? void 0 : onDisable(name, filePath);
-                continue;
-            }
-            const schedule = definition;
-            if ((schedule.markdown === undefined) === (schedule.run === undefined)) {
+            const { data, body } = parseFrontmatter(await readFile(filePath, "utf8"));
+            const cron = data.cron;
+            if (cron === undefined || !isValidCron(cron)) {
                 ctx.diagnostics.push({
                     severity: "error",
                     path: displayPath(ctx, filePath),
-                    message: "Schedules require exactly one of `markdown` or `run`.",
+                    message: cron === undefined
+                        ? "Markdown schedules require `cron` frontmatter."
+                        : `Invalid cron expression: "${cron}".`,
                 });
                 continue;
             }
-            if (!isValidCron(schedule.cron)) {
+            const markdown = body.trim();
+            if (markdown === "") {
                 ctx.diagnostics.push({
                     severity: "error",
                     path: displayPath(ctx, filePath),
-                    message: `Invalid cron expression: "${schedule.cron}".`,
+                    message: "Markdown schedules require a non-empty prompt body.",
                 });
                 continue;
             }
             schedules.push({
                 name,
-                cron: schedule.cron,
-                kind: schedule.run === undefined ? "markdown" : "run",
-                definition: schedule,
+                cron,
+                kind: "markdown",
+                definition: {
+                    __agentServe: "schedule",
+                    cron,
+                    markdown,
+                },
+            });
+            continue;
+        }
+        if (!isModuleFile(basename(filePath))) {
+            continue;
+        }
+        const name = rel.slice(0, -extname(rel).length);
+        if (name.includes("__")) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, filePath),
+                message: `Schedule name "${name}" may not contain "__"; it is reserved for extension contributions (\`<ns>__<name>\`).`,
+            });
+            continue;
+        }
+        const definition = await importDefault(ctx, filePath, onDisable === undefined ? "schedule" : ["schedule", "disabled"]);
+        if (definition === undefined) {
+            continue;
+        }
+        if (getDefinitionKind(definition) === "disabled") {
+            onDisable?.(name, filePath);
+            continue;
+        }
+        const schedule = definition;
+        if ((schedule.markdown === undefined) === (schedule.run === undefined)) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, filePath),
+                message: "Schedules require exactly one of `markdown` or `run`.",
+            });
+            continue;
+        }
+        if (!isValidCron(schedule.cron)) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, filePath),
+                message: `Invalid cron expression: "${schedule.cron}".`,
             });
+            continue;
         }
-        return schedules;
-    });
+        schedules.push({
+            name,
+            cron: schedule.cron,
+            kind: schedule.run === undefined ? "markdown" : "run",
+            definition: schedule,
+        });
+    }
+    return schedules;
 }

package/dist/internal/discovery/seed-files.js

@@ -1,41 +1,30 @@
 /**
  * `agent/sandbox/workspace/**`: files seeded into each local session workspace.
  */
-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, relative } from "node:path";
 import { displayPath } from "./context.js";
 import { isDirectory, isFile, toPosix, walkFiles } from "./fs.js";
-export function loadSeedFiles(ctx, agentDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const sandboxDir = join(agentDir, "sandbox");
-        for (const candidate of ["sandbox.ts", join("sandbox", "sandbox.ts")]) {
-            if (yield isFile(join(agentDir, candidate))) {
-                ctx.diagnostics.push({
-                    severity: "warning",
-                    path: displayPath(ctx, join(agentDir, candidate)),
-                    message: "Custom sandbox backends are not supported; the agent runs in the session workspace directory. Ignoring.",
-                });
-            }
-        }
-        const workspaceDir = join(sandboxDir, "workspace");
-        if (!(yield isDirectory(workspaceDir))) {
-            return [];
-        }
-        const seedFiles = [];
-        for (const filePath of yield walkFiles(workspaceDir)) {
-            seedFiles.push({
-                relativePath: toPosix(relative(workspaceDir, filePath)),
-                sourcePath: filePath,
+export async function loadSeedFiles(ctx, agentDir) {
+    const sandboxDir = join(agentDir, "sandbox");
+    for (const candidate of ["sandbox.ts", join("sandbox", "sandbox.ts")]) {
+        if (await isFile(join(agentDir, candidate))) {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: displayPath(ctx, join(agentDir, candidate)),
+                message: "Custom sandbox backends are not supported; the agent runs in the session workspace directory. Ignoring.",
             });
         }
-        return seedFiles;
-    });
+    }
+    const workspaceDir = join(sandboxDir, "workspace");
+    if (!(await isDirectory(workspaceDir))) {
+        return [];
+    }
+    const seedFiles = [];
+    for (const filePath of await walkFiles(workspaceDir)) {
+        seedFiles.push({
+            relativePath: toPosix(relative(workspaceDir, filePath)),
+            sourcePath: filePath,
+        });
+    }
+    return seedFiles;
 }

package/dist/internal/discovery/services.js

@@ -2,104 +2,85 @@
  * `agent/storage.ts`, `agent/otel.ts`, `agent/artifacts.ts`:
  * host services the agent configures.
  */
-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 { defineArtifacts } from "../../artifacts.js";
 import { artifactBuiltinTool, TAG_ARTIFACT_TOOL_NAME } from "../builtin-tools/index.js";
 import { displayPath } from "./context.js";
 import { findModuleFile } from "./fs.js";
 import { importDefault } from "./modules.js";
-export function loadStorage(ctx, agentDir, architecture) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const path = yield findModuleFile(agentDir, "storage");
-        if (path === undefined) {
-            return undefined;
-        }
-        if (architecture === "v2") {
-            // Storage is a hosting-mode decision on v2, made by
-            // framework-storage-selection.ts: the state root when self-hosted,
-            // Cursor-managed storage on Cursor hosting. Fail early (error
-            // diagnostics refuse serve and deploy) rather than silently running
-            // with storage the author believes they configured. Not imported.
-            ctx.diagnostics.push({
-                severity: "error",
-                path: displayPath(ctx, path),
-                message: 'defineStorage is not supported on architecture "v2": the platform selects storage (the local state root when self-hosted; Cursor-managed storage on Cursor hosting). Delete the file.',
-            });
-            return undefined;
-        }
-        // v1 keeps loading the authored sink, with notice: defineStorage is going
-        // away with the v1 control plane.
+export async function loadStorage(ctx, agentDir, architecture) {
+    const path = await findModuleFile(agentDir, "storage");
+    if (path === undefined) {
+        return undefined;
+    }
+    if (architecture === "v2") {
+        // Storage is a hosting-mode decision on v2, made by
+        // framework-storage-selection.ts: the state root when self-hosted,
+        // Cursor-managed storage on Cursor hosting. Fail early (error
+        // diagnostics refuse serve and deploy) rather than silently running
+        // with storage the author believes they configured. Not imported.
         ctx.diagnostics.push({
-            severity: "warning",
+            severity: "error",
             path: displayPath(ctx, path),
-            message: 'defineStorage is deprecated and going away: architecture "v2" selects storage automatically (the local state root when self-hosted; Cursor-managed storage on Cursor hosting). Still honored on v1.',
+            message: 'defineStorage is not supported on architecture "v2": the platform selects storage (the local state root when self-hosted; Cursor-managed storage on Cursor hosting). Delete the file.',
         });
-        const definition = yield importDefault(ctx, path, "storage");
-        return definition;
+        return undefined;
+    }
+    // v1 keeps loading the authored sink, with notice: defineStorage is going
+    // away with the v1 control plane.
+    ctx.diagnostics.push({
+        severity: "warning",
+        path: displayPath(ctx, path),
+        message: 'defineStorage is deprecated and going away: architecture "v2" selects storage automatically (the local state root when self-hosted; Cursor-managed storage on Cursor hosting). Still honored on v1.',
     });
+    const definition = await importDefault(ctx, path, "storage");
+    return definition;
 }
-export function loadOtel(ctx, agentDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const path = yield findModuleFile(agentDir, "otel");
-        if (path === undefined) {
-            return undefined;
-        }
-        const definition = yield importDefault(ctx, path, "otel");
-        return definition;
-    });
+export async function loadOtel(ctx, agentDir) {
+    const path = await findModuleFile(agentDir, "otel");
+    if (path === undefined) {
+        return undefined;
+    }
+    const definition = await importDefault(ctx, path, "otel");
+    return definition;
 }
-export function loadArtifacts(ctx, agentDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        const path = yield findModuleFile(agentDir, "artifacts");
-        if (path === undefined) {
-            return undefined;
-        }
-        const imported = yield importDefault(ctx, path, "artifacts");
-        if (imported === undefined) {
-            return undefined;
-        }
-        const definition = imported;
-        if (definition.agentTool === true && Object.keys((_a = definition.kinds) !== null && _a !== void 0 ? _a : {}).length === 0) {
-            ctx.diagnostics.push({
-                severity: "error",
-                path: displayPath(ctx, path),
-                message: "artifacts.agentTool requires kinds: the tag_artifact tool needs at least one declared kind; its descriptions are the tool prompt.",
-            });
-        }
-        return definition;
-    });
+export async function loadArtifacts(ctx, agentDir) {
+    const path = await findModuleFile(agentDir, "artifacts");
+    if (path === undefined) {
+        return undefined;
+    }
+    const imported = await importDefault(ctx, path, "artifacts");
+    if (imported === undefined) {
+        return undefined;
+    }
+    const definition = imported;
+    if (definition.agentTool === true && Object.keys(definition.kinds ?? {}).length === 0) {
+        ctx.diagnostics.push({
+            severity: "error",
+            path: displayPath(ctx, path),
+            message: "artifacts.agentTool requires kinds: the tag_artifact tool needs at least one declared kind; its descriptions are the tool prompt.",
+        });
+    }
+    return definition;
 }
 /**
  * `defineResult` / `agent/result.ts` is gone. A leftover file is an
  * authoring error so discovery fails closed instead of silently ignoring
  * host actuation that no longer runs.
  */
-export function rejectLegacyResult(ctx, agentDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const path = yield findModuleFile(agentDir, "result");
-        if (path === undefined) {
-            return;
-        }
-        ctx.diagnostics.push({
-            severity: "error",
-            path: displayPath(ctx, path),
-            message: "agent/result.ts is no longer supported; defineResult has been removed. Record structured output with an authored tool and actuate from a turn.completed hook.",
-        });
+export async function rejectLegacyResult(ctx, agentDir) {
+    const path = await findModuleFile(agentDir, "result");
+    if (path === undefined) {
+        return;
+    }
+    ctx.diagnostics.push({
+        severity: "error",
+        path: displayPath(ctx, path),
+        message: "agent/result.ts is no longer supported; defineResult has been removed. Record structured output with an authored tool and actuate from a turn.completed hook.",
     });
 }
 /** Merge namespaced extension kinds onto the agent's artifacts registry. */
 export function mergeArtifacts(agent, extra) {
-    var _a;
     if (extra === undefined) {
         return agent;
     }
@@ -107,9 +88,9 @@ export function mergeArtifacts(agent, extra) {
         return extra;
     }
     return defineArtifacts({
-        kinds: Object.assign(Object.assign({}, agent.kinds), extra.kinds),
+        kinds: { ...agent.kinds, ...extra.kinds },
         agentTool: agent.agentTool === true || extra.agentTool === true,
-        max: (_a = agent.max) !== null && _a !== void 0 ? _a : extra.max,
+        max: agent.max ?? extra.max,
     });
 }
 /**
@@ -117,22 +98,19 @@ export function mergeArtifacts(agent, extra) {
  * `agentTool: true`. Appended after `loadAgent` because the tool is
  * generated from the artifacts kinds registry, not `AgentConfig.builtinTools`.
  */
-export function appendArtifactTool(ctx, agentDir, agent, artifacts) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        const tool = artifactBuiltinTool(artifacts);
-        if (tool === undefined) {
-            return;
-        }
-        const artifactsPath = displayPath(ctx, (_a = (yield findModuleFile(agentDir, "artifacts"))) !== null && _a !== void 0 ? _a : join(agentDir, "artifacts.ts"));
-        if (agent.tools.some(t => t.name === TAG_ARTIFACT_TOOL_NAME)) {
-            ctx.diagnostics.push({
-                severity: "warning",
-                path: artifactsPath,
-                message: `Authored tool "${TAG_ARTIFACT_TOOL_NAME}" shadows the built-in tool of the same name; the authored tool wins.`,
-            });
-            return;
-        }
-        agent.tools.push(tool);
-    });
+export async function appendArtifactTool(ctx, agentDir, agent, artifacts) {
+    const tool = artifactBuiltinTool(artifacts);
+    if (tool === undefined) {
+        return;
+    }
+    const artifactsPath = displayPath(ctx, (await findModuleFile(agentDir, "artifacts")) ?? join(agentDir, "artifacts.ts"));
+    if (agent.tools.some(t => t.name === TAG_ARTIFACT_TOOL_NAME)) {
+        ctx.diagnostics.push({
+            severity: "warning",
+            path: artifactsPath,
+            message: `Authored tool "${TAG_ARTIFACT_TOOL_NAME}" shadows the built-in tool of the same name; the authored tool wins.`,
+        });
+        return;
+    }
+    agent.tools.push(tool);
 }