@cursor/bdk 0.2.6 → 0.2.8

package/dist/internal/discovery/agent.js

@@ -37,6 +37,7 @@ export function loadAgent(ctx, agentDir, options) {
                     hooks: [],
                     channels: [],
                     schedules: [],
+                    reminders: [],
                     artifacts: undefined,
                 },
             };
@@ -53,6 +54,7 @@ export function loadAgent(ctx, agentDir, options) {
         const hooks = [];
         const channels = [];
         const schedules = [];
+        const reminders = [];
         const instructionParts = [];
         const contributions = {
             tools,
@@ -63,6 +65,7 @@ export function loadAgent(ctx, agentDir, options) {
             hooks,
             channels,
             schedules,
+            reminders,
             instructionParts,
             seedFiles,
             artifacts: undefined,
@@ -274,6 +277,7 @@ export function loadAgent(ctx, agentDir, options) {
                 hooks,
                 channels,
                 schedules,
+                reminders,
                 artifacts: contributions.artifacts,
             },
         };

package/dist/internal/discovery/extensions.d.ts

@@ -2,7 +2,7 @@
  * `agent/extensions/<ns>.ts` | `agent/extensions/<ns>/extension.ts`:
  * agent-shaped trees and Cursor plugins mounted under a namespace.
  */
-import type { ArtifactsDefinition, DiscoveredChannel, DiscoveredConnection, DiscoveredExtension, DiscoveredHook, DiscoveredSchedule, DiscoveredSkill, DiscoveredTool, ResolvedAgent, SeedFile } from "../../types.js";
+import type { ArtifactsDefinition, DiscoveredChannel, DiscoveredConnection, DiscoveredExtension, DiscoveredHook, DiscoveredReminder, DiscoveredSchedule, DiscoveredSkill, DiscoveredTool, ResolvedAgent, SeedFile } from "../../types.js";
 import { type DiscoveryContext } from "./context.js";
 /** The agent's authored slot lists that mounted extensions append to. */
 export interface ExtensionContributions {
@@ -14,6 +14,7 @@ export interface ExtensionContributions {
     hooks: DiscoveredHook[];
     channels: DiscoveredChannel[];
     schedules: DiscoveredSchedule[];
+    reminders: DiscoveredReminder[];
     instructionParts: string[];
     seedFiles: SeedFile[];
     artifacts: ArtifactsDefinition | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/extensions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EAGd,aAAa,EACb,QAAQ,EAET,MAAM,gBAAgB,CAAC;AAUxB,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AA+BlE,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA0BhC"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/extensions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,cAAc,EAGd,aAAa,EACb,QAAQ,EAET,MAAM,gBAAgB,CAAC;AAUxB,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAgClE,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA0BhC"}

package/dist/internal/discovery/extensions.js

@@ -24,6 +24,7 @@ import { loadHooks } from "./hooks.js";
 import { loadInstructions } from "./instructions.js";
 import { importDefault, moduleEntries } from "./modules.js";
 import { validateName } from "./names.js";
+import { loadReminders } from "./reminders.js";
 import { loadSchedules } from "./schedules.js";
 import { loadSeedFiles } from "./seed-files.js";
 import { loadArtifacts, mergeArtifacts } from "./services.js";
@@ -100,6 +101,7 @@ function emptyDiscovered(ns, description) {
         hooks: [],
         channels: [],
         schedules: [],
+        reminders: [],
         instructions: false,
         seedFiles: [],
         artifactKinds: [],
@@ -232,6 +234,13 @@ function mountExtension(ctx, site, mount, into) {
             into.schedules.push(Object.assign(Object.assign({}, schedule), { name: composed }));
             mounted.schedules.push(composed);
         }
+        // Not overlaid: the tree's own tools arm these by definition object, which
+        // an overlay's replacement would no longer resolve to.
+        for (const reminder of tree.reminders) {
+            const composed = `${site.ns}__${reminder.name}`;
+            into.reminders.push(Object.assign(Object.assign({}, reminder), { name: composed }));
+            mounted.reminders.push(composed);
+        }
         if (instructions !== undefined && instructions !== "") {
             into.instructionParts.push(instructions);
             mounted.instructions = true;
@@ -281,7 +290,7 @@ function readExtensionTree(ctx, site, mount, root) {
             if (plugin === undefined) {
                 return undefined;
             }
-            return Object.assign(Object.assign({}, plugin), { tools: [], hostConnections: [], subagents: [], hooks: [], channels: [], schedules: [], seedFiles: [] });
+            return Object.assign(Object.assign({}, plugin), { tools: [], hostConnections: [], subagents: [], hooks: [], channels: [], schedules: [], reminders: [], seedFiles: [] });
         }
         return readNativeTree(ctx, root, mount.contributions);
     });
@@ -301,6 +310,7 @@ function readNativeTree(ctx, root, contributions) {
             hooks: yield loadHooks(ctx, join(root, "hooks")),
             channels: (yield loadChannels(ctx, join(root, "channels"), "extension")).channels,
             schedules: yield loadSchedules(ctx, join(root, "schedules")),
+            reminders: yield loadReminders(ctx, join(root, "reminders")),
             instructions: yield loadInstructions(ctx, root, undefined, false),
             seedFiles: yield loadSeedFiles(ctx, root),
             artifacts: yield loadArtifacts(ctx, root),

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,CA8FvB;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;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"}

package/dist/internal/discovery/project.js

@@ -211,6 +211,7 @@ export function loadAgentProject(dir_1) {
         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);

package/dist/internal/distribution.d.ts

@@ -13,9 +13,9 @@ export declare const PACKAGE_NAME = "@cursor/bdk";
 export declare const FORMER_PACKAGE_NAME = "@cursor/july";
 /**
  * Bracketed product tag for stderr / ServeOptions.logger lines
- * (`[agent-sdk] …`, `[agent-sdk/slack] …`).
+ * (`[bdk] …`, `[bdk/slack] …`).
  */
-export declare const LOG_PRODUCT = "agent-sdk";
+export declare const LOG_PRODUCT = "bdk";
 export declare const LOG_PREFIX: string;
 export declare const SLACK_LOG_PREFIX: string;
 /** The bin name, for help text and copy-pasteable hints. */

package/dist/internal/distribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/internal/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,kCAAkC;AAClC,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAC1C,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAIlD;;;GAGG;AACH,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,UAAU,EAAE,MAA2B,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAE,MAAiC,CAAC;AAEjE,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAYD,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CASlD;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,cAAc,IAAI,cAAc,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUzD"}
+{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/internal/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,kCAAkC;AAClC,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAC1C,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAIlD;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAQ,CAAC;AACjC,eAAO,MAAM,UAAU,EAAE,MAA2B,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAE,MAAiC,CAAC;AAEjE,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAYD,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CASlD;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,cAAc,IAAI,cAAc,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUzD"}

package/dist/internal/distribution.js

@@ -18,9 +18,9 @@ const HOSTED_WORKTREE_SHA_FILENAME = ".cursor-hosted-worktree-sha";
 const GIT_COMMIT_SHA_RE = /^[0-9a-f]{40,64}$/;
 /**
  * Bracketed product tag for stderr / ServeOptions.logger lines
- * (`[agent-sdk] …`, `[agent-sdk/slack] …`).
+ * (`[bdk] …`, `[bdk/slack] …`).
  */
-export const LOG_PRODUCT = "agent-sdk";
+export const LOG_PRODUCT = "bdk";
 export const LOG_PREFIX = `[${LOG_PRODUCT}]`;
 export const SLACK_LOG_PREFIX = `[${LOG_PRODUCT}/slack]`;
 /** The bin name, for help text and copy-pasteable hints. */

package/dist/internal/docs-site.js

@@ -162,10 +162,10 @@ export function ensureDocsSiteBundle() {
         }
         const toolchain = resolveDocsToolchain();
         if (toolchain === undefined) {
-            logger("[agent-sdk] docs site missing and vitepress toolchain unavailable; /docs will show a build hint");
+            logger("[bdk] docs site missing and vitepress toolchain unavailable; /docs will show a build hint");
             return;
         }
-        logger("[agent-sdk] building docs site (vitepress)...");
+        logger("[bdk] building docs site (vitepress)...");
         const code = yield new Promise((resolve, reject) => {
             const child = spawn(process.execPath, [toolchain.vitepressCli, "build", "docs"], {
                 cwd: toolchain.packageRoot,
@@ -181,7 +181,7 @@ export function ensureDocsSiteBundle() {
         if (!docsSiteExists(DOCS_DIST_DIR)) {
             throw new Error("docs vitepress build finished but dist/docs/index.html is missing");
         }
-        logger("[agent-sdk] docs site build complete");
+        logger("[bdk] docs site build complete");
     });
 }
 /** True when docs sources + a resolvable `vitepress` CLI are present. */

package/dist/internal/eval-run-store.js

@@ -118,7 +118,7 @@ export class EvalRunStore {
             this.abortByRunId.set(runId, abort);
             this.pruneOldRuns(config);
             this.persist(snapshot);
-            this.logger(`[agent-sdk] eval run ${runId}: starting ${cases.length} case(s)`);
+            this.logger(`[bdk] eval run ${runId}: starting ${cases.length} case(s)`);
             void this.execute(runId, Object.assign(Object.assign(Object.assign({ baseUrl: loopbackUrl, evals: selected, config, signal: abort.signal }, (input.bearerToken === undefined ? {} : { bearerToken: input.bearerToken })), (input.verbose === undefined ? {} : { verbose: input.verbose })), (input.timeoutMs === undefined ? {} : { timeoutMs: input.timeoutMs })));
             return snapshot;
         });
@@ -147,7 +147,7 @@ export class EvalRunStore {
             if (this.activeRunId === runId) {
                 this.activeRunId = undefined;
             }
-            this.logger(`[agent-sdk] eval run ${runId}: cancelled`);
+            this.logger(`[bdk] eval run ${runId}: cancelled`);
             return run;
         });
     }
@@ -201,14 +201,14 @@ export class EvalRunStore {
                     config = (yield discoverEvals(this.projectRoot)).config;
                 }
                 catch (error) {
-                    this.logger(`[agent-sdk] eval discovery failed during hydrate (pruning with defaults): ${error instanceof Error ? error.message : String(error)}`);
+                    this.logger(`[bdk] eval discovery failed during hydrate (pruning with defaults): ${error instanceof Error ? error.message : String(error)}`);
                 }
                 this.pruneOldRuns(config);
-                this.logger(`[agent-sdk] hydrated ${this.runs.size} playground eval run(s) from storage`);
+                this.logger(`[bdk] hydrated ${this.runs.size} playground eval run(s) from storage`);
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
-                this.logger(`[agent-sdk] failed to hydrate playground eval runs: ${message}`);
+                this.logger(`[bdk] failed to hydrate playground eval runs: ${message}`);
             }
             finally {
                 this.hydrated = true;
@@ -319,7 +319,7 @@ export class EvalRunStore {
                 run.status = "completed";
                 run.finishedAt = new Date().toISOString();
                 this.persist(run);
-                this.logger(`[agent-sdk] eval run ${runId}: done — ${run.summary.passed} passed, ${run.summary.failed} failed`);
+                this.logger(`[bdk] eval run ${runId}: done — ${run.summary.passed} passed, ${run.summary.failed} failed`);
             }
             catch (error) {
                 const run = this.runs.get(runId);
@@ -330,14 +330,14 @@ export class EvalRunStore {
                 if (opts.signal.aborted || message === "cancelled") {
                     markCancelledRun(run);
                     this.persist(run);
-                    this.logger(`[agent-sdk] eval run ${runId}: cancelled`);
+                    this.logger(`[bdk] eval run ${runId}: cancelled`);
                     return;
                 }
                 run.status = "failed";
                 run.finishedAt = new Date().toISOString();
                 run.error = message;
                 this.persist(run);
-                this.logger(`[agent-sdk] eval run ${runId}: failed — ${run.error}`);
+                this.logger(`[bdk] eval run ${runId}: failed — ${run.error}`);
             }
             finally {
                 this.abortByRunId.delete(runId);

package/dist/internal/framework-file-storage.d.ts

@@ -1,32 +1,10 @@
 /**
- * Framework-level file storage for v2 hosted engines.
+ * Framework-owned storage for managed architecture-v2 agents.
  *
- * Hosted deployments carry two file stores with different audiences:
- *
- * - the **user-level** store (`AGENT_SERVE_STORE_SOURCE_ID`) holds
- *   author-facing bytes — `ctx.host.files`, skills, memory, artifacts — and
- *   is browsable from the dashboard and mountable on cloud-runtime VMs;
- * - the **framework-level** store (`AGENT_SERVE_FRAMEWORK_STORE_SOURCE_ID`)
- *   holds engine-owned session state — session records, event transcripts,
- *   hosted-execution run logs, the continuation index, and the SDK
- *   conversation mirror — and is never mounted into author code or models.
- *   The authenticated dashboard may read diagnostic families, but never the
- *   continuation index.
- *
- * This module puts framework session state on the framework store. The
- * {@link storageKeys} scheme was designed for exactly this: keys are a
- * stable versioned contract that sinks may route on, so
- * {@link composeFrameworkStorage} splits one {@link StorageConfig} by key
- * kind — `session` / `session-events` / `session-runs` / `logs` /
- * `continuation` go to the framework file store (file-shaped; the store
- * accepts values up to 64 MiB per
- * object without chunking, versus the KV proxy's 1 MiB row cap), while
- * author `kv`, eval runs, and conditional writes stay on the control-plane
- * KV proxy (the dashboard reads them there, and CAS needs a database).
- *
- * v2 only, by construction: the composite is selected in
- * framework-storage-selection.ts, which v1 never reaches with a
- * platform-selected definition.
+ * Session records, event transcripts, run logs, continuation state, and SDK
+ * conversation checkpoints use a framework-only namespace. Authors cannot
+ * access that namespace through `host.kv` or `host.files`. Author KV, evals,
+ * and conditional writes remain on the author-facing side of the split.
  */
 import type { FileSink } from "../files.js";
 import type { StorageConfig } from "../storage.js";
@@ -38,8 +16,8 @@ import type { StorageConfig } from "../storage.js";
 export declare function isFrameworkFileKey(key: string): boolean;
 /**
  * The KV core over a {@link FileSink}: one JSON document per key.
- * `putMany` stays optional — the KV-proxy core has no batch write, and the
- * composite falls back to sequential puts on a side without one.
+ * `putMany` stays optional, and the composite falls back to sequential puts
+ * when a side has no batch write.
  */
 export type FileSinkStorageCore = Required<Pick<StorageConfig, "put" | "get" | "delete" | "list">> & Pick<StorageConfig, "putMany">;
 /**
@@ -65,11 +43,9 @@ export declare function composeFrameworkStorage(input: {
 /**
  * The KV backend's conditional writes, refusing framework-file keys.
  *
- * CAS runs on the KV proxy (a database row version); the plain core routes
- * framework session state to the file store. A future coordination path
- * that CASes a `session/` or `continuation/` key would otherwise read and
- * write a different store than the plain path — silent split-brain. Fail
- * loudly instead; nothing in the package CASes those kinds today.
+ * Conditional writes remain on the author-facing KV side. Accepting a
+ * framework key here would read and write different stores for the same key,
+ * so fail instead of creating split-brain state.
  */
 export declare function frameworkGuardedCas(cas: NonNullable<StorageConfig["cas"]>): NonNullable<StorageConfig["cas"]>;
 //# sourceMappingURL=framework-file-storage.d.ts.map

package/dist/internal/framework-file-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-file-storage.d.ts","sourceRoot":"","sources":["../../src/internal/framework-file-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,eAAe,CAAC;AAiBjE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAavD;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,GAChG,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AAgBjC;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,mBAAmB,CA8GvE;AA6CD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,EAAE,EAAE,mBAAmB,CAAC;IACxB,KAAK,EAAE,mBAAmB,CAAC;CAC5B,GAAG,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAqD1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,GACrC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CA0BnC"}
+{"version":3,"file":"framework-file-storage.d.ts","sourceRoot":"","sources":["../../src/internal/framework-file-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,eAAe,CAAC;AAiBjE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAavD;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,GAChG,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AAgBjC;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,mBAAmB,CA2GvE;AA6CD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,EAAE,EAAE,mBAAmB,CAAC;IACxB,KAAK,EAAE,mBAAmB,CAAC;CAC5B,GAAG,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAqD1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,GACrC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CA0BnC"}

package/dist/internal/framework-file-storage.js

@@ -1,32 +1,10 @@
 /**
- * Framework-level file storage for v2 hosted engines.
+ * Framework-owned storage for managed architecture-v2 agents.
  *
- * Hosted deployments carry two file stores with different audiences:
- *
- * - the **user-level** store (`AGENT_SERVE_STORE_SOURCE_ID`) holds
- *   author-facing bytes — `ctx.host.files`, skills, memory, artifacts — and
- *   is browsable from the dashboard and mountable on cloud-runtime VMs;
- * - the **framework-level** store (`AGENT_SERVE_FRAMEWORK_STORE_SOURCE_ID`)
- *   holds engine-owned session state — session records, event transcripts,
- *   hosted-execution run logs, the continuation index, and the SDK
- *   conversation mirror — and is never mounted into author code or models.
- *   The authenticated dashboard may read diagnostic families, but never the
- *   continuation index.
- *
- * This module puts framework session state on the framework store. The
- * {@link storageKeys} scheme was designed for exactly this: keys are a
- * stable versioned contract that sinks may route on, so
- * {@link composeFrameworkStorage} splits one {@link StorageConfig} by key
- * kind — `session` / `session-events` / `session-runs` / `logs` /
- * `continuation` go to the framework file store (file-shaped; the store
- * accepts values up to 64 MiB per
- * object without chunking, versus the KV proxy's 1 MiB row cap), while
- * author `kv`, eval runs, and conditional writes stay on the control-plane
- * KV proxy (the dashboard reads them there, and CAS needs a database).
- *
- * v2 only, by construction: the composite is selected in
- * framework-storage-selection.ts, which v1 never reaches with a
- * platform-selected definition.
+ * Session records, event transcripts, run logs, continuation state, and SDK
+ * conversation checkpoints use a framework-only namespace. Authors cannot
+ * access that namespace through `host.kv` or `host.files`. Author KV, evals,
+ * and conditional writes remain on the author-facing side of the split.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -69,7 +47,7 @@ export function isFrameworkFileKey(key) {
     const kind = kindEnd === -1 ? afterAgent : afterAgent.slice(0, kindEnd);
     return FRAMEWORK_FILE_KINDS.has(kind);
 }
-/** Parallel per-key reads backing `list` (each is presign + object GET). */
+/** Parallel per-key reads backing `list`. */
 const LIST_READ_CONCURRENCY = 8;
 /**
  * A storage key whose path the file store cannot represent (an empty, `.`,
@@ -130,7 +108,7 @@ export function fileSinkStorageCore(sink) {
                     return results;
                 }
                 if (sink.putMany !== undefined) {
-                    // The point of the batch: one backend round trip for the flush.
+                    // Preserve the sink's batch behavior when it provides one.
                     const settled = yield sink.putMany(writable.map(({ key, body }) => ({ key, body })));
                     for (let i = 0; i < writable.length; i += 1) {
                         const target = writable[i];
@@ -180,11 +158,8 @@ export function fileSinkStorageCore(sink) {
         list(prefix) {
             return __awaiter(this, void 0, void 0, function* () {
                 const entries = yield sink.list(prefix);
-                // FileSink.list returns metadata only, so the values are their own
-                // reads. Prefer the sink's batched read — on the hosted sink that is
-                // one control-plane call per 100 keys instead of one per key, which is
-                // what keeps a big restore under the store's per-deployment rate
-                // budget — and fall back to bounded per-key gets elsewhere.
+                // FileSink.list returns metadata only, so values require separate reads.
+                // Prefer the sink's batch API and otherwise use bounded parallel reads.
                 const bodies = sink.getMany !== undefined
                     ? yield sink.getMany(entries.map(entry => entry.key))
                     : yield mapBounded(entries, LIST_READ_CONCURRENCY, entry => sink.get(entry.key));
@@ -305,11 +280,9 @@ export function composeFrameworkStorage(input) {
 /**
  * The KV backend's conditional writes, refusing framework-file keys.
  *
- * CAS runs on the KV proxy (a database row version); the plain core routes
- * framework session state to the file store. A future coordination path
- * that CASes a `session/` or `continuation/` key would otherwise read and
- * write a different store than the plain path — silent split-brain. Fail
- * loudly instead; nothing in the package CASes those kinds today.
+ * Conditional writes remain on the author-facing KV side. Accepting a
+ * framework key here would read and write different stores for the same key,
+ * so fail instead of creating split-brain state.
  */
 export function frameworkGuardedCas(cas) {
     const refuse = (key) => {

package/dist/internal/framework-storage-selection.d.ts

@@ -1,50 +1,14 @@
 /**
- * Which backend framework session state is mirrored to.
+ * Selects where framework session state is durably mirrored.
  *
- * Framework state — session records, event chunks, the continuation index —
- * is how a session outlives the process that served it. On architecture v1
- * that mirror exists only when the agent author wrote `agent/storage.ts`,
- * which makes platform durability an agent-level decision: of the
- * first-party agents, some choose `cursorHostedStorage()` and some choose
- * `fileKv()` (pod-local disk, lost on pod replacement), and one selects
- * between them at runtime by reading the deployment-id environment variable
- * itself.
+ * Architecture v1 honors authored storage. Without it, Cursor-managed
+ * hosting selects managed storage, while self-hosted agents use
+ * `--state-root`. Architecture v2 rejects authored storage and selects the
+ * managed backend only on Cursor-managed hosting.
  *
- * That selection is a hosting-mode question, not an authoring question.
- * Architecture v2 moves it here: `agent/storage.ts` is rejected at
- * discovery (error diagnostic, so serve and deploy fail early), and the
- * platform picks the default. Architecture v1 with no authored file now
- * uses the same hosted-vs-self-hosted split, so deleting `agent/storage.ts`
- * (required to deploy the same tree onto v2) does not drop the Cursor-hosted
- * session mirror on a still-v1 pod.
- *
- * - **Cursor-managed hosting** (the deployment-generation environment
- *   variable is set, same signal that registers `GET /v1/manifest`):
- *   the deployment's **framework-level file store**
- *   (`AGENT_SERVE_FRAMEWORK_STORE_SOURCE_ID`, bound at task time) holds
- *   session records, event transcripts, and the continuation index —
- *   file-shaped state on file storage, apart from the author-facing user
- *   store. Author `host.kv`, eval runs, and conditional writes ride the
- *   AgentSDK v2 KV proxy (cursor-hosted-v2.ts), which resolves the
- *   pod service account to the factorydb deployment row (the v1 Bugbot
- *   proxy cannot resolve v2 pods at all). Framework session state never
- *   routes to the KV proxy — the composite splits by key kind — so
- *   transcripts stay off the author-reachable KV namespace. The API key
- *   resolves through the full credential chain on every call because hosted
- *   freeze snapshots listen unsigned and the binder drops the key file
- *   after restore.
- * - **Self-hosted**: no mirror. `--state-root` is the durable copy, which
- *   is correct when the operator owns the disk.
- *
- * v1 still honors an authored `agent/storage.ts` when present. Hosted v1
- * pods with no authored file get the Cursor-hosted lazy mirror (gated on
- * `AGENT_SERVE_DEPLOYMENT_ID`, the same signal the previous authored sinks
- * used). Self-hosted v1 with no authored file stays disk-only.
- *
- * Local disk is not part of this decision. `<stateRoot>/sessions/<id>/`
- * already holds `session.json` and `events.ndjson` unconditionally, through
- * the session store; what this selects is the durable mirror *beyond* the
- * pod's filesystem.
+ * When managed storage is selected, framework-owned session records, event
+ * transcripts, and continuation state stay separate from author-facing files
+ * and KV.
  */
 import { type StorageDefinition } from "../storage.js";
 import type { AgentArchitecture } from "../types.js";
@@ -59,8 +23,8 @@ export interface FrameworkStorageSelectionInput {
 /**
  * Pick the backend for framework session state.
  *
- * Returns `undefined` when there is no mirror, in which case the pod's local
- * disk is the only copy.
+ * Returns `undefined` when there is no mirror, in which case the local state
+ * directory is the only copy.
  */
 export declare function selectFrameworkStorageDefinition(input: FrameworkStorageSelectionInput): StorageDefinition | undefined;
 //# sourceMappingURL=framework-storage-selection.d.ts.map

package/dist/internal/framework-storage-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-storage-selection.d.ts","sourceRoot":"","sources":["../../src/internal/framework-storage-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAGH,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAMtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASrD,MAAM,WAAW,8BAA8B;IAC7C,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACjD,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtD,iEAAiE;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,8BAA8B,GACpC,iBAAiB,GAAG,SAAS,CAyE/B"}
+{"version":3,"file":"framework-storage-selection.d.ts","sourceRoot":"","sources":["../../src/internal/framework-storage-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAMtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASrD,MAAM,WAAW,8BAA8B;IAC7C,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACjD,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtD,iEAAiE;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,8BAA8B,GACpC,iBAAiB,GAAG,SAAS,CA4D/B"}

package/dist/internal/framework-storage-selection.js

@@ -1,50 +1,14 @@
 /**
- * Which backend framework session state is mirrored to.
+ * Selects where framework session state is durably mirrored.
  *
- * Framework state — session records, event chunks, the continuation index —
- * is how a session outlives the process that served it. On architecture v1
- * that mirror exists only when the agent author wrote `agent/storage.ts`,
- * which makes platform durability an agent-level decision: of the
- * first-party agents, some choose `cursorHostedStorage()` and some choose
- * `fileKv()` (pod-local disk, lost on pod replacement), and one selects
- * between them at runtime by reading the deployment-id environment variable
- * itself.
+ * Architecture v1 honors authored storage. Without it, Cursor-managed
+ * hosting selects managed storage, while self-hosted agents use
+ * `--state-root`. Architecture v2 rejects authored storage and selects the
+ * managed backend only on Cursor-managed hosting.
  *
- * That selection is a hosting-mode question, not an authoring question.
- * Architecture v2 moves it here: `agent/storage.ts` is rejected at
- * discovery (error diagnostic, so serve and deploy fail early), and the
- * platform picks the default. Architecture v1 with no authored file now
- * uses the same hosted-vs-self-hosted split, so deleting `agent/storage.ts`
- * (required to deploy the same tree onto v2) does not drop the Cursor-hosted
- * session mirror on a still-v1 pod.
- *
- * - **Cursor-managed hosting** (the deployment-generation environment
- *   variable is set, same signal that registers `GET /v1/manifest`):
- *   the deployment's **framework-level file store**
- *   (`AGENT_SERVE_FRAMEWORK_STORE_SOURCE_ID`, bound at task time) holds
- *   session records, event transcripts, and the continuation index —
- *   file-shaped state on file storage, apart from the author-facing user
- *   store. Author `host.kv`, eval runs, and conditional writes ride the
- *   AgentSDK v2 KV proxy (cursor-hosted-v2.ts), which resolves the
- *   pod service account to the factorydb deployment row (the v1 Bugbot
- *   proxy cannot resolve v2 pods at all). Framework session state never
- *   routes to the KV proxy — the composite splits by key kind — so
- *   transcripts stay off the author-reachable KV namespace. The API key
- *   resolves through the full credential chain on every call because hosted
- *   freeze snapshots listen unsigned and the binder drops the key file
- *   after restore.
- * - **Self-hosted**: no mirror. `--state-root` is the durable copy, which
- *   is correct when the operator owns the disk.
- *
- * v1 still honors an authored `agent/storage.ts` when present. Hosted v1
- * pods with no authored file get the Cursor-hosted lazy mirror (gated on
- * `AGENT_SERVE_DEPLOYMENT_ID`, the same signal the previous authored sinks
- * used). Self-hosted v1 with no authored file stays disk-only.
- *
- * Local disk is not part of this decision. `<stateRoot>/sessions/<id>/`
- * already holds `session.json` and `events.ndjson` unconditionally, through
- * the session store; what this selects is the durable mirror *beyond* the
- * pod's filesystem.
+ * When managed storage is selected, framework-owned session records, event
+ * transcripts, and continuation state stay separate from author-facing files
+ * and KV.
  */
 import { cursorHostedFiles } from "../files-backends/cursor-hosted.js";
 import { defineStorage } from "../storage.js";
@@ -56,8 +20,8 @@ import { resolveAgentV2Hosting } from "./v2-hosting.js";
 /**
  * Pick the backend for framework session state.
  *
- * Returns `undefined` when there is no mirror, in which case the pod's local
- * disk is the only copy.
+ * Returns `undefined` when there is no mirror, in which case the local state
+ * directory is the only copy.
  */
 export function selectFrameworkStorageDefinition(input) {
     var _a, _b;
@@ -67,7 +31,7 @@ export function selectFrameworkStorageDefinition(input) {
         }
         const env = (_a = input.env) !== null && _a !== void 0 ? _a : process.env;
         if (((_b = env[AGENT_SERVE_DEPLOYMENT_ID_ENV_VAR]) !== null && _b !== void 0 ? _b : "").trim() !== "") {
-            // Hosted v1 pod with no authored sink: keep the Cursor-hosted
+            // Managed v1 deployment with no authored sink: keep the Cursor-hosted
             // mirror (lazy restore) so agents can delete `agent/storage.ts`
             // without losing durability while they still run architecture v1.
             return defineStorage(Object.assign({ name: "cursor-hosted (lazy restore)", policy: { restore: "off" } }, cursorHostedStorage()));
@@ -88,27 +52,14 @@ export function selectFrameworkStorageDefinition(input) {
         // Self-hosted v2: the state root is the durable copy.
         return undefined;
     }
-    // Hosted v2 pods wake per delivery: bulk-restoring up to the default
-    // 1000 sessions on every boot is waste (and against the file-store
-    // backend it is per-key HTTP round trips before the listener even
-    // comes up). Follow-ups restore lazily by continuation or session id;
-    // GET /v1/sessions lists from the sink either way.
-    //
-    // Events flush at turn end. drainSessionDurability still forces the
-    // record onto the sink before the execution reply.
+    // Managed v2 hosts restore sessions lazily by continuation or session id.
+    // Turn completion still waits for the session record to reach storage.
     const policy = {
         restore: "off",
     };
-    // Full chain (env → bind file → stored login): frozen engines listen
-    // unsigned and bind store ids + CURSOR_API_KEY at task time, after this
-    // definition is constructed.
     const resolveApiKey = () => { var _a; return (_a = resolveApiKeySync()) === null || _a === void 0 ? void 0 : _a.apiKey; };
-    // v2 pods carry a factorydb-bound service account, which the v1 Bugbot
-    // storage proxy cannot resolve; author KV, CAS coordination, and the
-    // eval/A-B tables speak the AgentSDK v2 KV proxy instead. It also carries
-    // the cursor-hosted marker, so GET /v1/sessions prefers the durable list
-    // (session records are on the framework store, which the composed core
-    // lists).
+    // Author KV, CAS coordination, and evals stay separate from framework-owned
+    // session state. Session listing reads the framework side of that split.
     const kv = cursorHostedStorageV2({ resolveApiKey });
     return defineStorage(Object.assign(Object.assign(Object.assign({ name: "cursor-hosted (framework files)", policy }, kv), composeFrameworkStorage({
         kv,

package/dist/internal/github-fanout.js

@@ -103,13 +103,13 @@ export function fanoutDelivery(body_1, headers_1, targets_1) {
                     body: payload,
                 });
                 if (!response.ok) {
-                    log(`[agent-sdk] delivery to ${label} failed: HTTP ${response.status}\n`);
+                    log(`[bdk] delivery to ${label} failed: HTTP ${response.status}\n`);
                     return;
                 }
                 delivered.push(label);
             }
             catch (error) {
-                log(`[agent-sdk] delivery to ${label} failed: ${error instanceof Error ? error.message : String(error)}\n`);
+                log(`[bdk] delivery to ${label} failed: ${error instanceof Error ? error.message : String(error)}\n`);
             }
         })));
         if (recipients.length > 0 && delivered.length === 0) {

package/dist/internal/handleAgentServeTrigger.d.ts

@@ -1,14 +1,11 @@
 /**
- * Unified entry for dispatching agent-serve triggers from an external ingress
- * (e.g. the Cursor backend GitHub webhook or Origin cursor-internal tap).
- * Mirrors Automations' `handleAutomationTrigger`.
+ * Dispatches authenticated GitHub and Origin events to matching agents.
  *
- * Callers must authenticate the delivery before invoking this (the backend
- * verifies GitHub HMAC at `/github_webhook` and Origin v1ed at the
- * cursor-internal app). This fan-out does not re-check signatures — same
- * trust model as Bugbot after `verifyGithubRequest`.
+ * Callers must authenticate the delivery before invoking this fan-out. It
+ * does not re-check provider signatures.
  *
- * Each agent's `onPullRequest` / `onComment` / … hooks decide whether to run.
+ * Each agent's `onPullRequest`, `onComment`, and related hooks decide whether
+ * to run.
  */
 import type { GitHubChannelOptions } from "../channels/github/types.js";
 import type { OriginChannelOptions } from "../channels/origin/types.js";